Ţĥé Ķàþî ƒöŕḿàţ ƒàḿîļý & ţĥé .kpz þàçķàĝé

ĶƂƑ îš ţĥé ñàţîṽé šéŕîàļîžàţîöñ öƒ öñé çöñţéñţ àţöḿ, ţĥé ţŕàñšļàţàƃļé ƃļöçķ. À þŕöĵéçţ öŵñš ḿöŕé ţĥàñ ƃļöçķš, ţĥöüĝĥ: à çöñţéñţ ḿéḿöŕý àñđ à ţéŕḿš šţöŕé, þļüš šţàñđ-öƒƒ àññöţàţîöñš àñđ ḿéđîà. Ţĥé Ķàþî ƒöŕḿàţ ƒàḿîļý ĝîṽéš éàçĥ öƒ ţĥöšé àţöḿš à ñàţîṽé, đéţéŕḿîñîšţîç, ļöššļéšš ƒöŕḿàţ, àñđ ţĥé .kpz þàçķàĝé ƃüñđļéš ţĥéḿ îñţö öñé þöŕţàƃļé àŕţîƒàçţ.

Ţŵö ţîéŕš: ñàţîṽé ṽš îñţéŕçĥàñĝé

Ƒöŕ éṽéŕý àţöḿ ţĥéŕé àŕé ţŵö šéŕîàļîžàţîöñš, þļàýîñĝ ţĥé šàḿé ţŵö ŕöļéš ĶƂƑ àñđ ẊĻÎƑƑ þļàý ƒöŕ ƃļöçķš (šéé ĶƂƑ ṽš ẊĻÎƑƑ):

Àţöḿ	Ñàţîṽé (ļöššļéšš: þàçķ, çàçĥé, ĥàšĥ)	Îñţéŕçĥàñĝé (ļöššý: îñđüšţŕý ĥàñđöƒƒ)
ƃļöçķš + ţàŕĝéţš	ĶƂƑ, Ķàþî Ƃüñđļé Ƒöŕḿàţ, .kbf.json	ẊĻÎƑƑ / ÞÖ
šţàñđ-öƒƒ àññöţàţîöñš	ĶƂƑ àññöţàţîöñš, .overlays.jsonl	(ñöñé)
çöñţéñţ ḿéḿöŕý	çöñţéñţ-ḿéḿöŕý ƃüñđļé, .memory.json	ŢḾẊ
ţéŕḿš šţöŕé	ţéŕḿš ƃüñđļé, .terms.json	ŢƂẊ
ŵĥöļé þŕöĵéçţ	ĶÞŽ, Ķàþî Þŕöĵéçţ Àŕçĥîṽé, .kpz	(ñöñé)

Éṽéŕý ñàţîṽé ƒöŕḿ éẋçéþţ .kpz îš ĴŠÖÑ, àñđ ţĥé šüƒƒîẋ šàýš šö. Ţĥé ḿàŕķéŕ šéĝḿéñţ àĥéàđ öƒ .json ķééþš ţĥé ƒîļé šéļƒ-đéšçŕîƃîñĝ; ţĥé .json ţàîļ ḿéàñš jq, ĜîţĤüƃ, àñđ àñ éđîţöŕ'š šýñţàẋ ĥîĝĥļîĝĥţîñĝ àļļ ŕéçöĝñîšé îţ ŵîţĥöüţ çöñƒîĝüŕàţîöñ. .kpz ķééþš à đéđîçàţéđ éẋţéñšîöñ ƃéçàüšé îţ îš à ƃîñàŕý žîþ.

Ţĥé ñàţîṽé ƒöŕḿš ŕöüñđ-ţŕîþ éṽéŕý ƒîéļđ öƒ ţĥé îñţéŕñàļ ḿöđéļ. Ţĥé îñţéŕçĥàñĝé ƒöŕḿš ḿàþ öñļý ţĥé šţàñđàŕđ, îñđüšţŕý-þöŕţàƃļé šüƃšéţ, šö ţĥéý çàññöţ þàçķ à þŕöĵéçţ ļöššļéššļý:

• ŢḾẊ đŕöþš ţĥé éñţîţý ḿàþþîñĝš (îñçļüđîñĝ ţĥé conceptId çŕöšš-ļîñķ ƒŕöḿ à çöñţéñţ-ḿéḿöŕý éñţîţý ţö à ţéŕḿš çöñçéþţ), þŕöṽéñàñçé öŕîĝîñš àñđ îḿþöŕţ šéššîöñš, þéŕ-éñţŕý þŕöþéŕţîéš, àñđ ñöţéš.
• ŢƂẊ đŕöþš ţĥé ţéŕḿ source (ţéŕḿîñöļöĝý ṽš brand_vocabulary), ţĥé competitorTerm ƒļàĝ, àñđ ţĥé éẋţéñšîƃļé þŕöþéŕţîéš.

Ţĥé ƃüñđļéš þŕéšéŕṽé àļļ öƒ ţĥéšé. Ţĥéý šĥàŕé ţĥé ĶƂƑ đîšçîþļîñé: à kind ḿàĝîç šţŕîñĝ, à MAJOR.MINOR schemaVersion ŵîţĥ ţĥé šàḿé ƒöŕŵàŕđ-çöḿþàţîƃîļîţý çöñţŕàçţ àš ĶƂƑ, àñđ à đéţéŕḿîñîšţîç šéŕîàļîžéŕ (šöŕţéđ ŕéçöŕđš, ñö ĤŢḾĻ éšçàþîñĝ, ţŕàîļîñĝ ñéŵļîñé) šö ţĥé ƃýţéš àŕé šţàƃļé ƒöŕ çöñţéñţ ĥàšĥîñĝ àñđ ĝîţ đîñĝ. Ţĥé çöñţéñţ-ḿéḿöŕý ƃüñđļé ŕéüšéš ţĥé šàḿé Run ḿöđéļ àš ĶƂƑ ƃļöçķš ƒöŕ îţš ṽàŕîàñţ çöñţéñţ, šö îñļîñé çöđéš, þļàçéĥöļđéŕš, àñđ þļüŕàļ/šéļéçţ çöñšţŕüçţš šéŕîàļîžé îđéñţîçàļļý.

Öñé ƃüñđļé þéŕ šţöŕé

Éàçĥ šţöŕé ĥàš à ñàţîṽé ƃüñđļé ƒöŕḿàţ:

kapi memory export -o .kapi/memory/cli-nb.memory.json
kapi terms import seeds/terms.json    # format detected from the extension
kapi terms export --format bundle -o brand.terms.json   # or name it explicitly

Ţĥé éẋþļîçîţ šþéļļîñĝ îš --format bundle ƒöŕ ƃöţĥ šţöŕéš. Ţĥé šþéļļîñĝ json àļŕéàđý ḿéàñš šöḿéţĥîñĝ éļšé: kapi terms --format json îš à šéþàŕàţé, ļöššý ĴŠÖÑ éẋþöŕţ ţĥàţ đöéš ñöţ þŕéšéŕṽé çöñçéþţ îđéñţîţý. Ŕéàçĥ ƒöŕ bundle ŵĥéñ ýöü ŵàñţ ţĥé ļöššļéšš ƒöŕḿ.

À ƃüñđļé đš ļîñé ƃý ļîñé îñ ĝîţ, ŵĥîçĥ îš ŵĥàţ ḿàķéš à ŕéṽîéŵéđ çöñţéñţ ḿéḿöŕý öŕ ţéŕḿš šţöŕé ŕéṽîéŵàƃļé àţ àļļ. Ţĥéŕé îš ñö šéþàŕàţé çöḿþŕéššéđ šþéļļîñĝ: à ŵĥöļé þŕöĵéçţ ţĥàţ ñééđš ţö ţŕàṽéļ îš à .kpz, àñđ à šîñĝļé ƃüñđļé ţĥàţ ñééđš ţö ţŕàṽéļ šḿàļļ îš ŵĥàţ zip àñđ gzip àŕé ƒöŕ.

Ţĥé šüƒƒîẋ îđéñţîƒîéš à ƃüñđļé ŵĥéŕéṽéŕ îţ šîţš: à þŕöĵéçţ þüţš öñé ŵĥéŕéṽéŕ îţ ļîķéš àñđ ḿàý ķééþ šéṽéŕàļ. Àñ îḿþöŕţ ŕéàđš ţĥé ƃüñđļéš îñ ţĥé ļàýöüţ îţ îš ĝîṽéñ (Çöñţéẋţ ƒîļéš), àñđ àñ éẋþļîçîţ -o þàţĥ ñàḿéš öñé öüţŕîĝĥţ.

Ŵĥéŕé à ƃüñđļé šîţš ŵĥéñ ñöţĥîñĝ ƃîñđš îţ

kapi store import ŕéàđš .kapi/terms.json ƃý đéƒàüļţ. À šñàþšĥöţ ŵŕîţéš terms.json üñđéŕ ţĥé ŕéǫüîŕéđ --out đîŕéçţöŕý. Ýöü çàñ çöḿḿîţ ţĥàţ šñàþšĥöţ ƒöŕ ŕéṽîéŵ; ŵĥéñ üšîñĝ .kapi/, àđĵüšţ îţš đéƒàüļţ îĝñöŕé ŕüļéš ƒîŕšţ. Šéé Ţéŕḿš ƒöŕ îḿþöŕţ ļöçàţîöñš.

Çöñţéñţ ḿéḿöŕý ĥàš ñö ḿàţçĥîñĝ šîñĝļé ñàḿé: à þŕöĵéçţ ĥàš öñé ţéŕḿš ƃüñđļé ƃüţ ḿàñý çöñţéñţ-ḿéḿöŕý ƃüñđļéš, ţýþîçàļļý öñé þéŕ çöñţéñţ šüŕƒàçé. Ţĥîš ŕéþöšîţöŕý'š öŵñ đöĝƒööđ ķééþš à ƃüñđļé þéŕ šüŕƒàçé üñđéŕ .kapi/memory/ àĝàîñšţ à šîñĝļé .kapi/terms.json, àñđ àñ îḿþöŕţ ŕéàđš éṽéŕý öñé öƒ ţĥéḿ.

Ţĥé .kpz þàçķàĝé

À .kpz îš à đéţéŕḿîñîšţîç žîþ ƃüñđļîñĝ à þŕöĵéçţ'š àüţĥöŕîţàţîṽé çöñţéñţ, öñé ḿéḿƃéŕ þéŕ çöñţéñţ ţýþé: ţĥé šàḿé çöñţéñţ-ţýþé šéţ ţĥé šýñç þŕöţöçöļ ḿöṽéš öṽéŕ ţĥé ŵîŕé:

project.kpz
├── manifest.json          inventory: per-member sha256 + Merkle rootHash
├── blocks/<id>.kbf.json   KBF              (blocks + targets)
├── annotations/<id>.overlays.jsonl  KBF annotations  (stand-off overlays)
├── memory.json            content memory
├── terms.json             terminology
├── media/<name>           opaque blobs
│
│   ── working-state members (M-06 §5) ──
├── source/<name>          ingested source document(s)
├── overlays.json          in-progress overlays  (targets, annotations, …)
└── history.jsonl          advisory provenance log (opt-in; excluded from rootHash)

Ţĥé ḿéḿöŕý àñđ ţéŕḿš ḿéḿƃéŕš üšé ţĥé çöñṽéñţîöñàļ ƃàŕé ñàḿéš, ñöţ ţĥé çöḿþöüñđ šüƒƒîẋ, šö üñžîþþîñĝ à þàçķàĝé ƃý ĥàñđ ĝîṽéš ýöü ţĥé šþéļļîñĝ ţĥé ŕéšţ öƒ ţĥé ţööļîñĝ ţéàçĥéš. Ḿéḿƃéŕ ñàḿéš àŕé çöšḿéţîç: üñþàçķîñĝ ŕöüţéš éàçĥ ḿéḿƃéŕ ƃý ţĥé ḿàñîƒéšţ'š contentType, ñéṽéŕ ƃý îţš ƒîļéñàḿé.

(À .kpz àļšö çàŕŕîéš ţĥé þŕöĵéçţ ŕéçîþé îñ manifest.json (ƒļöŵš, þļüĝîñš, đéƒàüļţš, çöñţéñţ), ķéþţ öüţ öƒ ţĥé rootHash, šö ţĥé þàçķàĝé îš à ŕüññàƃļé þŕöĵéçţ îñ à ƒîļé. Šîđé-郃éçţîñĝ ŕéçîþé (ţĥé ṽéñüé ƃļöçķ, automations:) ţŕàṽéļš îñéŕţ.)

Ţĥé šàḿé çöñţàîñéŕ šéŕṽéš ţŵö þŕöƒîļéš, šéţ ƃý ţĥé ḿàñîƒéšţ kind:

• kind: kapi-project: ţĥé ŵĥöļé þŕöĵéçţ (àļļ ļöçàļéš, ƒüļļ ŕéçîþé, çöñţéñţ ḿéḿöŕý, ţéŕḿš, öṽéŕļàýš, šöüŕçé îđéñţîţý + šķéļéţöñš). Ţĥé šñàþšĥöţ / ţŕàñšþöŕţ þàŕçéļ, ḿöṽéđ ƃý pack / unpack.
• kind: kapi-interchange: à ţàšķ-šçöþéđ ƃîļîñĝüàļ šļîçé ƒöŕ öñé ļöçàļé þàîŕ (ƃļöçķš, îñļîñé çöđéš, šéĝḿéñţàţîöñ, šķéļéţöñ, ḿéḿöŕý àñđ ţéŕḿ çöñţéẋţ). Ţĥîš îš ñéöķàþî'š îñţéŕçĥàñĝé ƒöŕḿàţ, šéñţ ţö à ţŕàñšļàţöŕ/ŕéṽîéŵéŕ ƃý extract àñđ îñĝéšţéđ ƃý merge (šéé ĶƂƑ ṽš ẊĻÎƑƑ).

Ƃöţĥ àŕé þàŕçéļš; đàý-ţö-đàý ŵöŕķ ĥàþþéñš îñ ţĥé àḿƃîéñţ .kapi þŕöĵéçţ (Ḿ-06 §7).

Ƃéçàüšé éṽéŕý ḿéḿƃéŕ îš à ñàţîṽé ļöššļéšš ƒöŕḿàţ, ţĥé ŵĥöļé þàçķàĝé îš ļöššļéšš: üñþàçķîñĝ çàñ šééđ à ƒŕéšĥ þŕöĵéçţ šţöŕé (çöñţéñţ ḿéḿöŕý, ţéŕḿš àñđ ƃļöçķš àļîķé), àñđ ţĥé ŕéĝéñéŕàƃļé çàçĥéš (þàŕšé çàçĥé, šýñç ĥàšĥéš) ŕéƃüîļđ ƒàîţĥƒüļļý ƒŕöḿ îţ. Ţĥé ḿàñîƒéšţ'š þéŕ-ḿéḿƃéŕ ŠĤÀ-256 àñđ Ḿéŕķļé rootHash ĝîṽé ţĥé þàçķàĝé, àñđ éàçĥ ḿéḿƃéŕ, à šţàƃļé çöñţéñţ îđéñţîţý; üñþàçķîñĝ ṽéŕîƒîéš ƃöţĥ ƃéƒöŕé ţŕüšţîñĝ ţĥé çöñţéñţš.

Ŵĥàţ à þàçķàĝé ļéàṽéš öüţ

À .kpz þàçķš ţĥé šöüŕçé öƒ ţŕüţĥ àñđ ļéàṽéš ţĥé ŕéĝéñéŕàƃļé îñđéẋ ƃéĥîñđ. Îţ éẋçļüđéš .kapi/work/store.db àñđ éṽéŕýţĥîñĝ üñđéŕ .kapi/work/cache/, ŵĥîçĥ ŕéƃüîļđ öñ đéḿàñđ, àñđ îţ éẋçļüđéš šéçŕéţš (ţĥé šýñç çļàîḿ ţöķéñ). À þàŕţ ŵîţĥ ñöţĥîñĝ îñ îţ îš àƃšéñţ. Ţĥé þàçķàĝé îš ţĥéŕéƒöŕé ţĥé àţ-ŕéšţ ţŵîñ öƒ ţĥé šýñç ŵîŕé ƒöŕḿàţ: þàçķîñĝ îš ţĥé šýñç çöñṽéŕţéŕš ŵŕîţîñĝ ƒîļéš îñšţéàđ öƒ þŕöţöƃüƒ, àñđ üñþàçķîñĝ îš ţĥé îñṽéŕšé.

Ŕàŵ šöüŕçé ƃýţéš àŕé àļšö éẋçļüđéđ ƃý đéƒàüļţ: à .kpz çàŕŕîéš éàçĥ šöüŕçé'š îđéñţîţý (þàţĥ, ƒöŕḿàţ, çöñţéñţ ĥàšĥ) + ŕöüñđ-ţŕîþ šķéļéţöñ (éñöüĝĥ ţö ḿéŕĝé) ƃüţ ñöţ ţĥé öŕîĝîñàļš, šö îţ đöéšñ'ţ đüþļîçàţé ĝîţ-ţŕàçķéđ šöüŕçé. Þàšš --with-source ţö kapi extract / kapi pack ţö éḿƃéđ ţĥé ŕàŵ ƃýţéš ţöö (ñééđéđ ţö ŕé-éẋţŕàçţ öƒƒļîñé). Àñđ kapi pack ŕéƒüšéš ţö ŵŕîţé à çöñţéñţ-ļéšš .kpz (à þŕöĵéçţ ŵîţĥ ñöţĥîñĝ éẋţŕàçţéđ/ţŕàñšļàţéđ ýéţ), ļîķé git bundle ŕéƒüšîñĝ àñ éḿþţý ƃüñđļé; šĥàŕé ţĥé kapi.yaml ŕéçîþé ṽîà ĝîţ îñšţéàđ.

Ŕéđàçţéđ þàçķàĝéš

À þàçķàĝé ŵŕîţţéñ üñđéŕ à ŕéđàçţîöñ þöļîçý ĥöļđš à ṽîšîƃļé þļàçéĥöļđéŕ ŵĥéŕéṽéŕ ţĥé þöļîçý ŵîţĥĥöļđš à ṽàļüé, îñ éṽéŕý ḿéḿƃéŕ. Îţš ḿàñîƒéšţ ŕéçöŕđš ţĥàţ, àñđ ţĥé ÎĐ öƒ ţĥé ṽàüļţ ţĥàţ ŕéšţöŕéš îţ:

"redaction": { "vaultId": "3f9c0a6e1d2b4c5a8e7f6d5c4b3a2918" }

Ţĥé ṽàüļţ ƒîļé ŕéçöŕđš ţĥé šàḿé ÎĐ. Îţ ñéṽéŕ ţŕàṽéļš îñšîđé ţĥé þàçķàĝé: îţ šţàýš îñ ţĥé éẋţŕàçţîñĝ þŕöĵéçţ'š .kapi/vault/batches/<vault-id>.json, öŕ ƃéšîđé ţĥé þàçķàĝé àš <name>.kpz.vault ƒöŕ à þàçķàĝé éẋţŕàçţéđ ƒŕöḿ šöüŕçé ƒîļéš. kapi merge ŕéšţöŕéš ţĥé ṽàļüéš öñļý ƒŕöḿ ţĥé ṽàüļţ ŵĥöšé ÎĐ ḿàţçĥéš, àñđ šţöþš ƃéƒöŕé îţ ŵŕîţéš à ƒîļé ŵĥéñ ţĥàţ ṽàüļţ îš àƃšéñţ. Ţĥé ƒîéļđ îš ḿéţàđàţà, ķéþţ öüţ öƒ ţĥé rootHash, àñđ à þàçķàĝé ŵîţĥ ñö ŵîţĥĥéļđ ṽàļüéš ĥàš ñöñé.

Ŵöŕķîñĝ šţàţé: ĥàñđ-öƒƒ àñđ ŕéšüḿé

À .kpz îš àñ àţ-ŕéšţ šñàþšĥöţ öƒ ƒîñîšĥéđ çöñţéñţ, àñđ îţ çàñ àļšö çàŕŕý îñ-þŕöĝŕéšš ŵöŕķîñĝ šţàţé, šö ŵöŕķ çàñ šţöþ, ḿöṽé ƃéţŵééñ ḿàçĥîñéš, àñđ ŕéšüḿé ŵĥéŕé îţ ļéƒţ öƒƒ. Ţĥéŕé àŕé ţŵö ŕöüţéš, àñđ ñéîţĥéŕ ñééđš þéŕ-šţéþ ÇĻÎ ṽéŕƃš:

• .kpz àš àñ àđ-ĥöç ŵöŕķšþàçé (extract / ţŕàñšƒöŕḿ / merge). Ñö þŕöĵéçţ ŕéǫüîŕéđ. Ţĥé .kpz îš à þöŕţàƃļé ƃüñđļé; ţĥé ŕüñţîḿé îš à þéŕšîšţéñţ šĥàđöŵ çàçĥé ķéýéđ ţö ţĥé ƒîļé, šö ţŕàñšƒöŕḿš àŕé ƒàšţ àñđ îñçŕéḿéñţàļ àñđ ţĥé .kpz îš ŕéŵŕîţţéñ öñļý ŵĥéñ ýöü pack (öŕ þàšš --pack). extract îñĝéšţš šöüŕçéš (+ à ŕéçîþé), ŕüññîñĝ à ţööļ/ƒļöŵ öñ ţĥé .kpz ţŕàñšƒöŕḿš îţ îñ þļàçé, àñđ merge éḿîţš ţĥé ƒîñîšĥéđ ƒîļéš. info šĥöŵš ŵĥéţĥéŕ ţĥé çàçĥé îš đîŕţý.

  kapi extract src/*.json -o work.kpz --target-lang fr,qps   # ingest
  kapi translate work.kpz --target-lang fr                # transform (cache)
  kapi info  work.kpz                                         # dirty?
  kapi pack  work.kpz                                         # eject for sharing
  kapi merge work.kpz -o locales/                             # emit → locales/<lang>/<name>

  À šḿàļļ ŕéçîþé (ţàŕĝéţ ļöçàļéš + öüţþüţ ļàýöüţ) ţŕàṽéļš ŵîţĥ ţĥé ƒîļé, šö merge ñééđš ñö ƒļàĝš. Ţŕàñšƒöŕḿîñĝ ŕéüšéš ŵöŕķ àļŕéàđý đöñé îñšţéàđ öƒ ŕéçöḿþüţîñĝ îţ, àñđ éàçĥ đöçüḿéñţ'š ŵöŕķ šţàýš îšöļàţéđ.

• Þŕöĵéçţ šñàþšĥöţ (pack / unpack). Îñšîđé à .kapi þŕöĵéçţ ţĥé ŵöŕķîñĝ šţàţé àļšö îñçļüđéš ţĥé þŕöĵéçţ'š çöñţéñţ ḿéḿöŕý àñđ ţéŕḿš šţöŕé. kapi pack šñàþšĥöţš àļļ öƒ îţ; kapi unpack ŕéĥýđŕàţéš îţ îñţö àñöţĥéŕ ḿàçĥîñé'š .kapi/ đîŕéçţöŕý. Ŵîţĥîñ à þŕöĵéçţ, ŕé-ŕüññîñĝ à ƒļöŵ àļšö ŕéüšéš ţĥé ƃļöçķ ţàƃļéš àļŕéàđý îñ .kapi/work/store.db, šö ŕéšüḿé ţĥéŕé îš ŕüññîñĝ àĝàîñ.

  kapi pack   -o snapshot.kpz   # snapshot the project's working state
  kapi unpack snapshot.kpz      # rehydrate elsewhere, then run to resume

Ţĥé ŵöŕķîñĝ-šţàţé ḿéḿƃéŕš àŕé source/<name> (ţĥé îñĝéšţéđ đöçüḿéñţš) àñđ overlays.json (ţĥé îñ-þŕöĝŕéšš öṽéŕļàýš: targets/<locale>, annotations/<name>, šéĝḿéñţàţîöñ, … ķéýéđ ƃý (kind, blockHash)). Öṽéŕļàýš îñ à ḿüļţî-đöçüḿéñţ þàçķàĝé àŕé šçöþéđ þéŕ šöüŕçé, šîñçé ƃļöçķ îđš àŕé öñļý üñîǫüé ŵîţĥîñ öñé đöçüḿéñţ. À recipe ƃļöçķ îñ ţĥé ḿàñîƒéšţ (ñöţ à çöñţéñţ ḿéḿƃéŕ, šö öüţ öƒ ţĥé rootHash) çàŕŕîéš ţĥé ŵöŕķšþàçé'š ţàŕĝéţ ļöçàļéš àñđ öüţþüţ ļàýöüţ.

Þŕöĝŕéšš îš đéŕîṽéđ ƒŕöḿ çöñţéñţ

Ƃéçàüšé ţĥé ƃļöçķ šţöŕé îš àþþéñđ-öñļý àñđ çöñţéñţ-àđđŕéššéđ, "ĥàš šţéþ Ẋ ŕüñ?" îš à þüŕé ƒüñçţîöñ öƒ ţĥé çöñţéñţ: đöéš Ẋ'š öṽéŕļàý éẋîšţ ƒöŕ ţĥé çüŕŕéñţ ƃļöçķ ĥàšĥéš? Ţĥàţ îš ŵĥàţ ḿàķéš çàçĥéđ ŕéšüḿé çöŕŕéçţ: ŕé-ŕüññîñĝ îš à ñö-öþ ŵĥéŕé ţĥé öṽéŕļàý îš àļŕéàđý þŕéšéñţ, àñđ à šöüŕçé çĥàñĝé ŕé-ĥàšĥéš îţš ƃļöçķ šö öñļý ţĥé àƒƒéçţéđ ŵöŕķ ŕéçöḿþüţéš. Ţĥéŕé îš ñö àüţĥöŕîţàţîṽé þŕöĝŕéšš ĵöüŕñàļ; îţ ŵöüļđ ƃé à šéçöñđ šöüŕçé öƒ ţŕüţĥ ţĥàţ çöüļđ đŕîƒţ ƒŕöḿ ţĥé çöñţéñţ.

Ţĥé öñé öþţîöñàļ ļöĝ îš àđṽîšöŕý þŕöṽéñàñçé: kapi pack --log šţàḿþš à ĥàšĥ-çĥàîñéđ ļîñé îñţö history.jsonl ŕéçöŕđîñĝ ţĥé þàçķ (ţàḿþéŕ-éṽîđéñţ çüšţöđý ƒöŕ ĥàñđ-öƒƒ; unpack ṽéŕîƒîéš ţĥé çĥàîñ àñđ ŵàŕñš îƒ ƃŕöķéñ). Îţ îš šţŕîçţļý šüƃöŕđîñàţé ţö çöñţéñţ: éẋçļüđéđ ƒŕöḿ ţĥé þàçķàĝé rootHash, ñéṽéŕ ŕéàđ ţö đéçîđé àñýţĥîñĝ, àñđ šàƒé ţö đéļéţé ŵîţĥ ñö ļöšš öƒ ŵöŕķ. À đéƒàüļţ pack (ñö --log) îš ƃýţé-đéţéŕḿîñîšţîç.

Ŵĥéñ ţö üšé îţ

Üšé à .kpz ţö ḿöṽé à ŵĥöļé þŕöĵéçţ ļöššļéššļý: ƃàçķüþ àñđ àŕçĥîṽàļ, šééđîñĝ à ƒŕéšĥ šéŕṽéŕ öŕ àñ öƒƒļîñé đéšķţöþ ŵöŕķîñĝ çöþý, ţŕàñšƒéŕŕîñĝ à þŕöĵéçţ ƃéţŵééñ ḿàçĥîñéš ŵîţĥöüţ à šéŕṽéŕ, öŕ ƃüîļđîñĝ à đéţéŕḿîñîšţîç ţéšţ ƒîẋţüŕé. Üšé ţĥé îñţéŕçĥàñĝé ƒöŕḿàţš (ẊĻÎƑƑ/ÞÖ, ŢḾẊ, ŢƂẊ) îñšţéàđ ŵĥéñ çöñţéñţ çŕöššéš îñţö ţĥé ŵîđéŕ ţŕàñšļàţîöñ îñđüšţŕý (à ţŕàñšļàţîöñ ṽéñđöŕ, àñ éẋţéŕñàļ ÇÀŢ ţööļ, öŕ à ŢḾŠ) àñđ ţĥé ļöššý, šţàñđàŕđš-ƃàšéđ šüƃšéţ îš ŵĥàţ ţĥé öţĥéŕ šîđé éẋþéçţš.

Šéé àļšö

• Ḿ-06: ĶƂƑ Ƒàḿîļý àñđ ţĥé .ķþž Þàçķàĝé: ţĥé đéçîšîöñ àñđ ŕàţîöñàļé.
• Šþéçîƒîçàţîöñ: ţĥé ĶƂƑ ƃļöçķ ƒöŕḿàţ ţĥé ƒàḿîļý îš ƃüîļţ àŕöüñđ.
• ĶƂƑ ṽš ẊĻÎƑƑ: ţĥé ñàţîṽé-ṽš-îñţéŕçĥàñĝé šþļîţ ƒöŕ ƃļöçķš.
• Ŕéƒéŕéñçé îḿþļéḿéñţàţîöñš: memory/kmb (ţĥé çöñţéñţ-ḿéḿöŕý ƃüñđļé), terms/ktb (ţĥé ţéŕḿš ƃüñđļé), kpz (ţĥé þàçķàĝé çöñţàîñéŕ).