ctxr-cli 0.8.0 → 0.10.0

package/dist/config/defaults.d.ts

@@ -56,8 +56,24 @@ export declare const DEFAULT_MISSION_FILE_NAME = "mission.md";
 export declare const DEFAULT_MISSION_PATH = ".contexture/guidance/mission.md";
 /** store-integrity spec: AGENTS.md's inlined "Store conventions" section's size ceiling when `harness.convention_max_bytes` is unset. */
 export declare const DEFAULT_CONVENTION_MAX_BYTES: number;
-/** Paths excluded from every retrieval leg by default. */
-export declare const DEFAULT_EXCLUDE_PATHS: readonly ['.contexture/'];
+/**
+ * context-ingest spec: the capture tier's root. Everything beneath it is
+ * material that arrived rather than knowledge someone wrote, so it is
+ * excluded from retrieval and never becomes a note — but it IS tracked in
+ * git, because a retained capture is provenance, not regenerable output.
+ */
+export declare const DEFAULT_CAPTURE_ROOT = "raw/";
+/** Paths excluded from every retrieval leg by default — contexture's own directory, and the capture tier. */
+export declare const DEFAULT_EXCLUDE_PATHS: readonly ['.contexture/', "raw/"];
+/**
+ * compose-the-retrieval-pass spec (D10/D11): path prefixes that stay fully
+ * retrievable but sort after everything else. Empty here because the shipped
+ * value is not a literal — `init` seeds it from the taxonomy's own resolved
+ * archive destination, so a custom taxonomy demotes its archive, not PARA's.
+ */
+export declare const DEFAULT_DEMOTE_PATHS: readonly string[];
+/** compose-the-retrieval-pass spec: how many notes `ctxr context gather` returns before it reports truncation. */
+export declare const DEFAULT_GATHER_MAX_NOTES = 50;
 /** graph-context-document spec: no relation vocabulary by default — no typed edges until a store declares names. */
 export declare const DEFAULT_RELATIONS: readonly string[];
 /** graph-context-document spec: positional clusters two directory segments deep; document sections capped for readability. */
@@ -79,8 +95,13 @@ export declare const DEFAULT_CATALOG_PATH = ".contexture/catalog/";
 export declare const DEFAULT_CATALOG_SECTION_MAX_BYTES: number;
 /** publish spec: where published pages live — tracked, authored-but-tool-owned, excluded from retrieval like the catalog and skill pack. */
 export declare const DEFAULT_PUBLISH_PATH = ".contexture/publish/";
-/** context-ingest spec: capture's landing zone — a normal, retrievable directory, not an exclusion. */
-export declare const DEFAULT_INBOX_PATH = "inbox/";
+/**
+ * context-ingest spec: capture's landing zone — the not-yet-ingested state
+ * inside the capture tier. Nesting it under the capture root is what lets a
+ * single prefix serve both the retrieval exclusion and the write-path gate;
+ * the schema enforces the nesting.
+ */
+export declare const DEFAULT_INBOX_PATH = "raw/inbox/";
 /** store-primitives-from-migration-audit spec (D2): the shipped tracking-parameter list source check strips before comparing URL identities. */
 export declare const DEFAULT_TRACKING_PARAMS: string[];
 /**
@@ -100,4 +121,92 @@ export declare const DEFAULT_ROLLUP_STALE_DAYS = 7;
  * it was addable.
  */
 export declare const DEFAULT_ADAPTERS: readonly AdapterDeclaration[];
+/**
+ * Every configuration value contexture ships an opinion about, in one place,
+ * shaped like the config itself. `StoreConfigSchema` takes its `.default(...)`
+ * values from here and `renderStoreConfig` reads it to decide what a written
+ * config may omit — the two have to agree, and the only way to guarantee that
+ * is for them to read the same object.
+ *
+ * What is deliberately ABSENT from this object is as load-bearing as what is
+ * in it. A key appears here only when its correct value depends on nothing:
+ *
+ * - `schema_version`, `taxonomy` and `git.default_branch` are facts about the
+ *   individual store. `git.default_branch` records whatever branch `git init`
+ *   actually created and is never hardcoded (see `GitSchema`).
+ * - `organize.archive_destination` is derived: a shipped profile supplies it
+ *   from the taxonomy at init, so a constant here would give every PARA store
+ *   `archive/` while its own taxonomy declares `archives/` — the defect
+ *   `archive-destination-from-taxonomy` was written to fix.
+ * - `organize.mission_path` is an opt-in whose absence is meaningful: call
+ *   sites branch on the key's presence to decide whether the store has a
+ *   mission mechanism at all. `DEFAULT_MISSION_PATH` is what `init` seeds,
+ *   not what an omission resolves to.
+ */
+/**
+ * cli-contract (keep-the-installed-cli-current): the release advisory is on by
+ * default — an operator who never learns a newer release exists is exactly the
+ * problem it solves — and off with one key. The interval is a day because the
+ * thing being watched is a hand-cut release, not a stream of commits.
+ */
+export declare const DEFAULT_UPDATE_CHECK_ENABLED = true;
+export declare const DEFAULT_UPDATE_CHECK_TTL_HOURS = 24;
+export declare const SHIPPED_DEFAULTS: {
+    readonly derived: {
+        readonly paths: readonly [".contexture/cache/"];
+    };
+    readonly retrieval: {
+        readonly exclude_paths: readonly [".contexture/", "raw/"];
+        readonly demote_paths: readonly string[];
+        readonly gather_max_notes: 50;
+        readonly relations: readonly string[];
+        readonly graph: {
+            cluster_depth: number;
+            hub_top: number;
+            bridge_top: number;
+            orphan_exempt_clusters: string[];
+        };
+    };
+    readonly session: {
+        readonly branch_prefix: "session/";
+        readonly worktrees_path: ".worktrees/";
+    };
+    readonly write_lifecycle: {
+        readonly diff_size_ceiling_lines: 2000;
+        readonly writable_paths: string[];
+    };
+    readonly catalog: {
+        readonly path: ".contexture/catalog/";
+        readonly section_max_bytes: number;
+    };
+    readonly publish: {
+        readonly path: ".contexture/publish/";
+    };
+    readonly skills: {
+        readonly vendored: readonly ["frontend-design", "eli5"];
+    };
+    readonly ingest: {
+        readonly inbox_path: "raw/inbox/";
+        readonly capture_root: "raw/";
+        readonly tracking_params: string[];
+    };
+    readonly organize: {
+        readonly rollup_stale_days: 7;
+    };
+    readonly harness: {
+        readonly skills_path: ".agents/skills/";
+        readonly guidance_path: ".contexture/guidance/";
+        readonly convention_max_bytes: number;
+    };
+    readonly adapters: readonly {
+        id: string;
+        kind: "harness-generation";
+        module?: string | undefined;
+        skills_dir?: string | undefined;
+    }[];
+    readonly update_check: {
+        readonly enabled: true;
+        readonly ttl_hours: 24;
+    };
+};
 //# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,YAAI,oBAAoB,CAAU,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,YAAI,iBAAiB,EAAE,MAAM,CAAU,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,4HAA4H;AAC5H,eAAO,MAAM,sCAAsC,4BAA4B,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,2BAA2B,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,yBAAyB,CAAC;AAE1E,mHAAmH;AACnH,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAEtD,+IAA+I;AAC/I,eAAO,MAAM,oBAAoB,oCAAyD,CAAC;AAE3F,yIAAyI;AACzI,eAAO,MAAM,4BAA4B,QAAY,CAAC;AAEtD,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,YAAI,cAAc,CAAU,CAAC;AAE/D,oHAAoH;AACpH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAO,CAAC;AAEvD,8HAA8H;AAC9H,eAAO,MAAM,sBAAsB;IACjC,aAAa;IACb,OAAO;IACP,UAAU;IACV,sBAAsB,EAAQ,MAAM,EAAE;CACvC,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,aAAa,CAAC;AAGxD,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,2HAA2H;AAC3H,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,6GAA6G;AAC7G,eAAO,MAAM,iCAAiC,QAAY,CAAC;AAE3D,4IAA4I;AAC5I,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,gJAAgJ;AAChJ,eAAO,MAAM,uBAAuB,UAA6F,CAAC;AAElI;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD,iHAAiH;AACjH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAAwD,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,YAAI,oBAAoB,CAAU,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,YAAI,iBAAiB,EAAE,MAAM,CAAU,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,4HAA4H;AAC5H,eAAO,MAAM,sCAAsC,4BAA4B,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,2BAA2B,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,yBAAyB,CAAC;AAE1E,mHAAmH;AACnH,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAEtD,+IAA+I;AAC/I,eAAO,MAAM,oBAAoB,oCAAyD,CAAC;AAE3F,yIAAyI;AACzI,eAAO,MAAM,4BAA4B,QAAY,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAE3C,6GAA6G;AAC7G,eAAO,MAAM,qBAAqB,YAAI,cAAc,SAAgC,CAAC;AAErF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAO,CAAC;AAE1D,kHAAkH;AAClH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,oHAAoH;AACpH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAO,CAAC;AAEvD,8HAA8H;AAC9H,eAAO,MAAM,sBAAsB;IACjC,aAAa;IACb,OAAO;IACP,UAAU;IACV,sBAAsB,EAAQ,MAAM,EAAE;CACvC,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,aAAa,CAAC;AAGxD,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,2HAA2H;AAC3H,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,6GAA6G;AAC7G,eAAO,MAAM,iCAAiC,QAAY,CAAC;AAE3D,4IAA4I;AAC5I,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C,gJAAgJ;AAChJ,eAAO,MAAM,uBAAuB,UAA6F,CAAC;AAElI;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD,iHAAiH;AACjH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAAwD,CAAC;AAEnH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,eAAO,MAAM,gBAAgB;aAC3B,OAAO;iBAAI,KAAK;;aAChB,SAAS;iBACP,aAAa;iBACb,YAAY;iBACZ,gBAAgB;iBAChB,SAAS;iBACT,KAAK;;;;oCA3FuB,MAAM,EAAE;;;aA6FtC,OAAO;iBAAI,aAAa;iBAAiC,cAAc;;aACvE,eAAe;iBAAI,uBAAuB;iBAAmC,cAAc,EAAQ,MAAM,EAAE;;aAC3G,OAAO;iBAAI,IAAI;iBAAwB,iBAAiB;;aACxD,OAAO;iBAAI,IAAI;;aACf,MAAM;iBAAI,QAAQ;;aAClB,MAAM;iBACJ,UAAU;iBACV,YAAY;iBACZ,eAAe;;aAEjB,QAAQ;iBAAI,iBAAiB;;aAC7B,OAAO;iBACL,WAAW;iBACX,aAAa;iBACb,oBAAoB;;aAEtB,QAAQ;;;;;;aACR,YAAY;iBAAI,OAAO;iBAAgC,SAAS;;CACxD,CAAC"}

package/dist/config/defaults.js

@@ -55,8 +55,24 @@ export const DEFAULT_MISSION_FILE_NAME = 'mission.md';
 export const DEFAULT_MISSION_PATH = `${DEFAULT_GUIDANCE_PATH}${DEFAULT_MISSION_FILE_NAME}`;
 /** store-integrity spec: AGENTS.md's inlined "Store conventions" section's size ceiling when `harness.convention_max_bytes` is unset. */
 export const DEFAULT_CONVENTION_MAX_BYTES = 32 * 1024;
-/** Paths excluded from every retrieval leg by default. */
-export const DEFAULT_EXCLUDE_PATHS = ['.contexture/'];
+/**
+ * context-ingest spec: the capture tier's root. Everything beneath it is
+ * material that arrived rather than knowledge someone wrote, so it is
+ * excluded from retrieval and never becomes a note — but it IS tracked in
+ * git, because a retained capture is provenance, not regenerable output.
+ */
+export const DEFAULT_CAPTURE_ROOT = 'raw/';
+/** Paths excluded from every retrieval leg by default — contexture's own directory, and the capture tier. */
+export const DEFAULT_EXCLUDE_PATHS = ['.contexture/', DEFAULT_CAPTURE_ROOT];
+/**
+ * compose-the-retrieval-pass spec (D10/D11): path prefixes that stay fully
+ * retrievable but sort after everything else. Empty here because the shipped
+ * value is not a literal — `init` seeds it from the taxonomy's own resolved
+ * archive destination, so a custom taxonomy demotes its archive, not PARA's.
+ */
+export const DEFAULT_DEMOTE_PATHS = [];
+/** compose-the-retrieval-pass spec: how many notes `ctxr context gather` returns before it reports truncation. */
+export const DEFAULT_GATHER_MAX_NOTES = 50;
 /** graph-context-document spec: no relation vocabulary by default — no typed edges until a store declares names. */
 export const DEFAULT_RELATIONS = [];
 /** graph-context-document spec: positional clusters two directory segments deep; document sections capped for readability. */
@@ -78,8 +94,13 @@ export const DEFAULT_CATALOG_PATH = '.contexture/catalog/';
 export const DEFAULT_CATALOG_SECTION_MAX_BYTES = 32 * 1024;
 /** publish spec: where published pages live — tracked, authored-but-tool-owned, excluded from retrieval like the catalog and skill pack. */
 export const DEFAULT_PUBLISH_PATH = '.contexture/publish/';
-/** context-ingest spec: capture's landing zone — a normal, retrievable directory, not an exclusion. */
-export const DEFAULT_INBOX_PATH = 'inbox/';
+/**
+ * context-ingest spec: capture's landing zone — the not-yet-ingested state
+ * inside the capture tier. Nesting it under the capture root is what lets a
+ * single prefix serve both the retrieval exclusion and the write-path gate;
+ * the schema enforces the nesting.
+ */
+export const DEFAULT_INBOX_PATH = 'raw/inbox/';
 /** store-primitives-from-migration-audit spec (D2): the shipped tracking-parameter list source check strips before comparing URL identities. */
 export const DEFAULT_TRACKING_PARAMS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid'];
 /**
@@ -99,4 +120,62 @@ export const DEFAULT_ROLLUP_STALE_DAYS = 7;
  * it was addable.
  */
 export const DEFAULT_ADAPTERS = [{ id: 'claude-code', kind: 'harness-generation' }];
+/**
+ * Every configuration value contexture ships an opinion about, in one place,
+ * shaped like the config itself. `StoreConfigSchema` takes its `.default(...)`
+ * values from here and `renderStoreConfig` reads it to decide what a written
+ * config may omit — the two have to agree, and the only way to guarantee that
+ * is for them to read the same object.
+ *
+ * What is deliberately ABSENT from this object is as load-bearing as what is
+ * in it. A key appears here only when its correct value depends on nothing:
+ *
+ * - `schema_version`, `taxonomy` and `git.default_branch` are facts about the
+ *   individual store. `git.default_branch` records whatever branch `git init`
+ *   actually created and is never hardcoded (see `GitSchema`).
+ * - `organize.archive_destination` is derived: a shipped profile supplies it
+ *   from the taxonomy at init, so a constant here would give every PARA store
+ *   `archive/` while its own taxonomy declares `archives/` — the defect
+ *   `archive-destination-from-taxonomy` was written to fix.
+ * - `organize.mission_path` is an opt-in whose absence is meaningful: call
+ *   sites branch on the key's presence to decide whether the store has a
+ *   mission mechanism at all. `DEFAULT_MISSION_PATH` is what `init` seeds,
+ *   not what an omission resolves to.
+ */
+/**
+ * cli-contract (keep-the-installed-cli-current): the release advisory is on by
+ * default — an operator who never learns a newer release exists is exactly the
+ * problem it solves — and off with one key. The interval is a day because the
+ * thing being watched is a hand-cut release, not a stream of commits.
+ */
+export const DEFAULT_UPDATE_CHECK_ENABLED = true;
+export const DEFAULT_UPDATE_CHECK_TTL_HOURS = 24;
+export const SHIPPED_DEFAULTS = {
+    derived: { paths: DEFAULT_DERIVED_PATHS },
+    retrieval: {
+        exclude_paths: DEFAULT_EXCLUDE_PATHS,
+        demote_paths: DEFAULT_DEMOTE_PATHS,
+        gather_max_notes: DEFAULT_GATHER_MAX_NOTES,
+        relations: DEFAULT_RELATIONS,
+        graph: DEFAULT_GRAPH_SETTINGS,
+    },
+    session: { branch_prefix: DEFAULT_SESSION_BRANCH_PREFIX, worktrees_path: DEFAULT_WORKTREES_PATH },
+    write_lifecycle: { diff_size_ceiling_lines: DEFAULT_DIFF_SIZE_CEILING_LINES, writable_paths: [] },
+    catalog: { path: DEFAULT_CATALOG_PATH, section_max_bytes: DEFAULT_CATALOG_SECTION_MAX_BYTES },
+    publish: { path: DEFAULT_PUBLISH_PATH },
+    skills: { vendored: DEFAULT_VENDORED_SKILLS },
+    ingest: {
+        inbox_path: DEFAULT_INBOX_PATH,
+        capture_root: DEFAULT_CAPTURE_ROOT,
+        tracking_params: DEFAULT_TRACKING_PARAMS,
+    },
+    organize: { rollup_stale_days: DEFAULT_ROLLUP_STALE_DAYS },
+    harness: {
+        skills_path: DEFAULT_SKILLS_PATH,
+        guidance_path: DEFAULT_GUIDANCE_PATH,
+        convention_max_bytes: DEFAULT_CONVENTION_MAX_BYTES,
+    },
+    adapters: DEFAULT_ADAPTERS,
+    update_check: { enabled: DEFAULT_UPDATE_CHECK_ENABLED, ttl_hours: DEFAULT_UPDATE_CHECK_TTL_HOURS },
+};
 //# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,oBAAoB,CAAU,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAU,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D,4HAA4H;AAC5H,MAAM,CAAC,MAAM,sCAAsC,GAAG,yBAAyB,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,wBAAwB,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,sBAAsB,CAAC;AAE1E,mHAAmH;AACnH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAEtD,+IAA+I;AAC/I,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,qBAAqB,GAAG,yBAAyB,EAAE,CAAC;AAE3F,yIAAyI;AACzI,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,cAAc,CAAU,CAAC;AAE/D,oHAAoH;AACpH,MAAM,CAAC,MAAM,iBAAiB,GAAsB,EAAE,CAAC;AAEvD,8HAA8H;AAC9H,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,EAAE;IACd,sBAAsB,EAAE,EAAc;CACvC,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEpD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC;AAGxD,oFAAoF;AACpF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,2HAA2H;AAC3H,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,6GAA6G;AAC7G,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3D,4IAA4I;AAC5I,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,uGAAuG;AACvG,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,gJAAgJ;AAChJ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAElI;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;AAEtD,iHAAiH;AACjH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkC,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"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"}

package/dist/config/load.d.ts

@@ -3,8 +3,8 @@ export declare function configPathFor(root: string): string;
 /**
  * store-lifecycle spec: "Schema version is recorded and gated" — every
  * command reads schema_version before operating. This peeks at it loosely,
- * BEFORE full validation, so a store with a genuinely newer/incompatible
- * shape reports "your version is newer" rather than a confusing generic
+ * BEFORE full validation, so a store whose recorded version differs in either
+ * direction reports the version rather than the confusing generic
  * shape-validation error the full schema would otherwise produce.
  */
 export declare function readConfig(root: string): Promise<StoreConfig>;

package/dist/config/load.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AASA,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAiCnE"}
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAUA,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2CnE"}

package/dist/config/load.js

@@ -2,7 +2,7 @@ import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { parse as parseYaml } from 'yaml';
 import { CONFIG_FILE_NAME } from '../core/root.js';
-import { InvalidConfigError, SchemaVersionMissingError, SchemaVersionNewerError, } from '../core/errors.js';
+import { InvalidConfigError, SchemaVersionBehindError, SchemaVersionMissingError, SchemaVersionNewerError, } from '../core/errors.js';
 import { StoreConfigSchema, SUPPORTED_SCHEMA_VERSION } from './schema.js';
 export function configPathFor(root) {
     return path.join(root, CONFIG_FILE_NAME);
@@ -10,8 +10,8 @@ export function configPathFor(root) {
 /**
  * store-lifecycle spec: "Schema version is recorded and gated" — every
  * command reads schema_version before operating. This peeks at it loosely,
- * BEFORE full validation, so a store with a genuinely newer/incompatible
- * shape reports "your version is newer" rather than a confusing generic
+ * BEFORE full validation, so a store whose recorded version differs in either
+ * direction reports the version rather than the confusing generic
  * shape-validation error the full schema would otherwise produce.
  */
 export async function readConfig(root) {
@@ -36,6 +36,16 @@ export async function readConfig(root) {
     if (rawVersion > SUPPORTED_SCHEMA_VERSION) {
         throw new SchemaVersionNewerError(rawVersion, SUPPORTED_SCHEMA_VERSION);
     }
+    /**
+     * retire-store-migrations: the older direction is refused here too, and for
+     * the same reason the newer one is — this release cannot read that shape.
+     * It has to happen before `safeParse`, or an older config fails on the keys
+     * whose superseded spellings the schema no longer accepts, reporting a shape
+     * error against keys the operator never wrote instead of the version.
+     */
+    if (rawVersion < SUPPORTED_SCHEMA_VERSION) {
+        throw new SchemaVersionBehindError(rawVersion, SUPPORTED_SCHEMA_VERSION);
+    }
     const result = StoreConfigSchema.safeParse(raw);
     if (!result.success) {
         const issues = result.error.issues.map((issue) => ({

package/dist/config/load.js.map

@@ -1 +1 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAoB,MAAM,aAAa,CAAC;AAE5F,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE;YACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAI,GAA2C,EAAE,cAAc,CAAC;IAChF,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,IAAI,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC1C,MAAM,IAAI,uBAAuB,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ;YACtC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAoB,MAAM,aAAa,CAAC;AAE5F,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE;YACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAI,GAA2C,EAAE,cAAc,CAAC;IAChF,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,IAAI,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC1C,MAAM,IAAI,uBAAuB,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;IAC1E,CAAC;IACD;;;;;;OAMG;IACH,IAAI,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC1C,MAAM,IAAI,wBAAwB,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ;YACtC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/config/render.d.ts

@@ -4,6 +4,11 @@ import { type StoreConfig } from './schema.js';
  * schema before returning — a render that doesn't round-trip is a bug caught
  * here, before any byte reaches disk, rather than discovered later as a
  * corrupted store.
+ *
+ * The round-trip also proves the omission was lossless: what the pruned text
+ * parses back to must equal what was passed in, so a default that drifted out
+ * of step with the schema fails here rather than silently changing a store's
+ * behavior.
  */
 export declare function renderStoreConfig(config: StoreConfig): string;
 //# sourceMappingURL=render.d.ts.map

package/dist/config/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/config/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAIlE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAI7D"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/config/render.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAmDlE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAW7D"}

package/dist/config/render.js

@@ -1,15 +1,74 @@
+import { isDeepStrictEqual } from 'node:util';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { SHIPPED_DEFAULTS } from './defaults.js';
 import { StoreConfigSchema } from './schema.js';
-const HEADER = '# contexture store configuration\n\n';
+const HEADER = [
+    '# contexture store configuration',
+    '#',
+    '# Only what this store chose. Any key not here takes contexture\'s shipped',
+    '# default, and follows it when a later release improves it.',
+    '',
+    '',
+].join('\n');
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * config-defaults-as-the-convention (D3, D4): drops every value equal to its
+ * shipped default, so what reaches disk is the set of decisions the store has
+ * made. Applied here rather than at `init` so the pruning belongs to the act
+ * of writing rather than to one caller — `init` is the only writer since
+ * retire-store-migrations, and a second one that skipped this would
+ * re-materialize the full resolved shape and undo the omission.
+ *
+ * Equality is deep and order-sensitive: a list holding the same entries in a
+ * different order is written as the store wrote it. Treating that as equal
+ * would silently reorder an operator's file to save one line.
+ *
+ * A key absent from `SHIPPED_DEFAULTS` is always kept — contexture has no
+ * opinion about it, or (as with `organize.mission_path`) its absence is
+ * itself the meaningful state.
+ */
+function withoutShippedDefaults(value, defaults) {
+    const kept = {};
+    for (const [key, declared] of Object.entries(value)) {
+        const shipped = defaults[key];
+        if (shipped === undefined) {
+            kept[key] = declared;
+            continue;
+        }
+        if (isPlainObject(declared) && isPlainObject(shipped)) {
+            const nested = withoutShippedDefaults(declared, shipped);
+            // A block whose every key matched is dropped whole, not left as `{}`.
+            if (Object.keys(nested).length > 0)
+                kept[key] = nested;
+            continue;
+        }
+        if (isDeepStrictEqual(declared, shipped))
+            continue;
+        kept[key] = declared;
+    }
+    return kept;
+}
 /**
  * Renders a StoreConfig to YAML text and round-trips it back through the
  * schema before returning — a render that doesn't round-trip is a bug caught
  * here, before any byte reaches disk, rather than discovered later as a
  * corrupted store.
+ *
+ * The round-trip also proves the omission was lossless: what the pruned text
+ * parses back to must equal what was passed in, so a default that drifted out
+ * of step with the schema fails here rather than silently changing a store's
+ * behavior.
  */
 export function renderStoreConfig(config) {
-    const text = HEADER + stringifyYaml(config, { indent: 2 });
-    StoreConfigSchema.parse(parseYaml(text)); // throws on mismatch; that IS the check
+    const declared = withoutShippedDefaults(config, SHIPPED_DEFAULTS);
+    const text = HEADER + stringifyYaml(declared, { indent: 2 });
+    const reparsed = StoreConfigSchema.parse(parseYaml(text)); // throws on mismatch; that IS the check
+    if (!isDeepStrictEqual(reparsed, config)) {
+        throw new Error('contexture.yaml render dropped a key whose shipped default does not match what the schema resolves. ' +
+            'SHIPPED_DEFAULTS and StoreConfigSchema disagree.');
+    }
     return text;
 }
 //# sourceMappingURL=render.js.map

package/dist/config/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/config/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,GAAG,sCAAsC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,MAAM,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3D,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,wCAAwC;IAClF,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/config/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,GAAG;IACb,kCAAkC;IAClC,GAAG;IACH,4EAA4E;IAC5E,6DAA6D;IAC7D,EAAE;IACF,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,sBAAsB,CAAC,KAA8B,EAAE,QAAiC;IAC/F,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzD,sEAAsE;YACtE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACvD,SAAS;QACX,CAAC;QACD,IAAI,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC;YAAE,SAAS;QACnD,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAA4C,EAAE,gBAAsD,CAAC,CAAC;IAC9I,MAAM,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,wCAAwC;IACnG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,sGAAsG;YACpG,kDAAkD,CACrD,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config/schema.d.ts

@@ -3,39 +3,21 @@ import { z } from 'zod';
  * store-lifecycle spec: schema_version versions STORE STATE (config shape +
  * note frontmatter conventions) — a monotonic integer independent of the npm
  * package version — not "what this CLI release happens to be."
- */
-/**
- * Bumped to 2 by the visibility-field key rename migration (store-lifecycle
- * spec task 9.2). Both that field and the config key naming it were removed
- * at schema 7 (see below); the migration survives only to keep the 1 -> 2
- * step in the chain intact.
- *
- * Bumped to 3 by the procedures-to-skills key rename migration
- * (rename-procedures-to-skills, 0003-rename-procedures-path-to-skills):
- * `harness.procedures_path` -> `harness.skills_path`. HarnessSchema's
- * transform accepts the old key through this version so an unmigrated
- * store still loads (see schema.ts's HarnessSchema comment).
  *
- * Bumped to 4 by the conventions-to-guidance key rename migration
- * (rename-conventions-path-to-guidance-path, 0004-rename-conventions-path-to-guidance-path):
- * `harness.conventions_path` -> `harness.guidance_path`. HarnessSchema's
- * transform accepts the old key through this version too, the same way.
- */
-/**
- * Bumped to 7 on main by the explanation-craft-skill migration
- * (vendor-explanation-craft-skill, 0007-add-explanation-craft-skill), which
- * pins its own local SCHEMA_VERSION and is unaffected by later bumps here.
+ * retire-store-migrations: contexture ships no migration mechanism, so this
+ * number is a gate rather than a starting point. `readConfig` refuses any
+ * store whose recorded version is not exactly this one, in either direction:
+ * a newer store because this release cannot know its shape, an older one
+ * because this release no longer reads that shape and offers nothing that
+ * would bring it forward. A release that changes the store's shape bumps this
+ * and documents the one-time fixup in its release notes.
  *
- * Bumped to 8 by the access-axis removal (retire-the-access-axes,
- * drop-access-axes): the `visibility:` and `disclosure:` blocks and the
- * `fields:` block that named the visibility frontmatter key are all gone.
- * Unlike the rename migrations above, nothing here is accepted loosely for
- * an older store — `noUnrecognizedConfigKeysCheck` derives from this
- * schema's shape, so an unmigrated store fails `doctor` on the three stale
- * keys until `ctxr migrate` drops them, exactly as `identity` did when
- * remove-agent-identity retired it.
+ * It stayed at 10 through that retirement on purpose: nothing about a
+ * conforming store's shape changed. What was dropped were superseded INPUT
+ * spellings that no store at 10 has ever written, since `renderStoreConfig`
+ * only ever emitted the current names.
  */
-export declare const SUPPORTED_SCHEMA_VERSION = 8;
+export declare const SUPPORTED_SCHEMA_VERSION = 10;
 export declare const TaxonomyLayerSchema: z.ZodObject<{
     name: z.ZodString;
     path: z.ZodString;
@@ -72,11 +54,13 @@ export declare const StoreConfigSchema: z.ZodObject<{
             description: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    derived: z.ZodObject<{
-        paths: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>;
-    retrieval: z.ZodObject<{
-        exclude_paths: z.ZodArray<z.ZodString>;
+    derived: z.ZodPrefault<z.ZodObject<{
+        paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    retrieval: z.ZodPrefault<z.ZodObject<{
+        exclude_paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        demote_paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        gather_max_notes: z.ZodDefault<z.ZodNumber>;
         relations: z.ZodDefault<z.ZodArray<z.ZodString>>;
         graph: z.ZodDefault<z.ZodObject<{
             cluster_depth: z.ZodDefault<z.ZodNumber>;
@@ -84,35 +68,39 @@ export declare const StoreConfigSchema: z.ZodObject<{
             bridge_top: z.ZodDefault<z.ZodNumber>;
             orphan_exempt_clusters: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
     git: z.ZodObject<{
         default_branch: z.ZodString;
     }, z.core.$strip>;
-    session: z.ZodObject<{
-        branch_prefix: z.ZodString;
-        worktrees_path: z.ZodString;
-    }, z.core.$strip>;
-    write_lifecycle: z.ZodObject<{
-        diff_size_ceiling_lines: z.ZodNumber;
+    session: z.ZodPrefault<z.ZodObject<{
+        branch_prefix: z.ZodDefault<z.ZodString>;
+        worktrees_path: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    write_lifecycle: z.ZodPrefault<z.ZodObject<{
+        diff_size_ceiling_lines: z.ZodDefault<z.ZodNumber>;
         writable_paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>;
-    catalog: z.ZodObject<{
-        path: z.ZodString;
-        section_max_bytes: z.ZodNumber;
-    }, z.core.$strip>;
-    publish: z.ZodDefault<z.ZodObject<{
+    }, z.core.$strip>>;
+    catalog: z.ZodPrefault<z.ZodObject<{
         path: z.ZodDefault<z.ZodString>;
+        section_max_bytes: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
-    skills: z.ZodDefault<z.ZodObject<{
+    publish: z.ZodPrefault<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    skills: z.ZodPrefault<z.ZodObject<{
         vendored: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
-    ingest: z.ZodObject<{
-        inbox_path: z.ZodString;
+    update_check: z.ZodPrefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        ttl_hours: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    ingest: z.ZodPrefault<z.ZodObject<{
+        inbox_path: z.ZodDefault<z.ZodString>;
+        capture_root: z.ZodDefault<z.ZodString>;
         tracking_params: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
     organize: z.ZodPipe<z.ZodObject<{
         archive_destination: z.ZodOptional<z.ZodString>;
-        archive_path: z.ZodOptional<z.ZodString>;
         rollup_stale_days: z.ZodDefault<z.ZodNumber>;
         mission_path: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodTransform<{
@@ -121,40 +109,23 @@ export declare const StoreConfigSchema: z.ZodObject<{
         mission_path?: string | undefined;
     }, {
         archive_destination?: string | undefined;
-        archive_path?: string | undefined;
         rollup_stale_days: number;
         mission_path?: string | undefined;
     }>>;
-    harness: z.ZodPipe<z.ZodObject<{
+    harness: z.ZodPrefault<z.ZodPipe<z.ZodObject<{
         skills_path: z.ZodOptional<z.ZodString>;
-        procedures_path: z.ZodOptional<z.ZodString>;
         guidance_path: z.ZodOptional<z.ZodString>;
-        conventions_path: z.ZodOptional<z.ZodString>;
-        convention_max_bytes: z.ZodOptional<z.ZodNumber>;
+        convention_max_bytes: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>, z.ZodTransform<{
         skills_path: string;
         guidance_path: string;
-        convention_max_bytes?: number | undefined;
+        convention_max_bytes: number;
     }, {
         skills_path?: string | undefined;
-        procedures_path?: string | undefined;
         guidance_path?: string | undefined;
-        conventions_path?: string | undefined;
-        convention_max_bytes?: number | undefined;
-    }>>;
-    adapters: z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodString;
-        module: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>, z.ZodTransform<{
-        id: string;
-        kind: string;
-        module?: string | undefined;
-    }[], {
-        id: string;
-        kind: string;
-        module?: string | undefined;
-    }[]>>, z.ZodArray<z.ZodObject<{
+        convention_max_bytes: number;
+    }>>>;
+    adapters: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
             "harness-generation": "harness-generation";

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAYH;;;;;;GAMG;AACH,QAAA,MAAM,mBAAmB;;;;;iBAKvB,CAAC;AAkLH,QAAA,MAAM,wBAAwB;;;;;;;iBAM5B,CAAC;AAiBH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBd,CAAC;AAEjB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAYH;;;;;;GAMG;AACH,QAAA,MAAM,mBAAmB;;;;;iBAKvB,CAAC;AAoNH,QAAA,MAAM,wBAAwB;;;;;;;iBAM5B,CAAC;AAiBH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuC1B,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}