Skip to content
โ—‡ AirawatOS Developer
๐Ÿšง Under development โ€” this portal is being built track by track. Content will keep growing, and some sections are still placeholders.

Reference

โ† Schema catalogue

knowledge.chunk

domain: knowledge

A CONTENT-ADDRESSED fragment of a document: its id derives from `chunk_hash` = sha2-256(text), so identical text stored once and SHARED across document versions (git-tree). The version-relative order/index is NOT here โ€” it lives in the knowledge.version manifest โ€” because a chunk record is immutable + shareable. `locator` is structural (derived from content: a Stage, Section, or paragraph) so it travels with the chunk. This is the leaf the citation contract pins + re-hashes to prove no tamper.

FieldTypeRequiredDescription
schemaโ€”โœ“
idstringโœ“ds:<t>:knowledge/chunk/<hash-prefix> โ€” derived from chunk_hash (content-addressed)
chunk_hashstringโœ“sha2-256:<hex> of the chunk text โ€” the integrity + dedup key
doc_idstringthe document this chunk was extracted from
textstringโœ“
locatorobjectstructural position: {kind: stage|section|paragraph|window, label}
word_countinteger
tenantstring