Development Preview · PR #2551 · 58d61b2 · built
Skip to content

Knowledge

Knowledge and provenance substrate: ingested external sources, chunking, and retrieval.

Enums

enums

Knowledge substrate enumerations.

SourceType

Bases: StrEnum

Origin of an ingested knowledge source.

Drives SourceLoader selection in the knowledge substrate. A REPO source is a code tree, PDF / WEB / DESIGN_DOC are documents, and TICKET is an issue thread fetched through the governed external-API access tool.

ContentKind

Bases: StrEnum

Structural kind of a loaded unit; drives chunker selection.

CODE uses the AST-aware chunker, DOCUMENT the section-aware chunker, PDF_PAGE the page/region chunker, and TICKET_THREAD the document chunker over comment text.

SourceStatus

Bases: StrEnum

Ingestion lifecycle state of a knowledge source.

KnowledgeClaimType

Bases: StrEnum

Nature of a synthesised knowledge-answer claim.

Classifies each assertion in a grounded answer so the deliverable can distinguish sourced facts from interpretive analysis, recommendations, and cross-source comparisons. Knowledge-local (not shared with the research subsystem) so the substrate carries no upward import.

FACT class-attribute instance-attribute

FACT = 'fact'

A sourced statement asserted directly by one or more chunks.

ANALYSIS class-attribute instance-attribute

ANALYSIS = 'analysis'

An inference or interpretation drawn from a single source.

RECOMMENDATION class-attribute instance-attribute

RECOMMENDATION = 'recommendation'

A suggested action or course derived from the sources.

COMPARISON class-attribute instance-attribute

COMPARISON = 'comparison'

A contrast drawn across two or more distinct sources.