ctxr-cli 0.9.0 → 0.11.0

package/dist/config/defaults.js

@@ -73,8 +73,45 @@ export const DEFAULT_EXCLUDE_PATHS = ['.contexture/', DEFAULT_CAPTURE_ROOT];
 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 = [];
+/**
+ * context-retrieval spec ("Relation sections yield typed edges"): the fixed
+ * relation vocabulary, and the one place either a name or its definition is
+ * written. Not configurable — a store that wants a different edge type writes
+ * an ordinary heading and gets an untyped link, the same as any other heading.
+ *
+ * The definition is not decoration. The only question the vocabulary actually
+ * raises is which of two adjacent relations a link belongs under, so each one
+ * says when to use it and how it differs from its nearest neighbour. Every
+ * artifact that names a relation — the graph, the entry document, the
+ * connection-proposal skill, the note template — reads this pair, so a
+ * definition cannot drift from the name it explains.
+ */
+export const RELATION_VOCABULARY = [
+    {
+        name: 'Upstream',
+        definition: 'The thinking this note is built on: prior ideas, sources, and decisions that had to exist first. If removing the linked note would leave this one unfounded, it is upstream.',
+    },
+    {
+        name: 'Downstream',
+        definition: 'What follows from this note: what it enables, informs, or raises. The inverse of Upstream.',
+    },
+    {
+        name: 'Similar',
+        definition: 'A note this one resembles in structure, pattern, or topic, where neither depends on the other. Use it when the observation is that the two rhyme, not that one caused the other.',
+    },
+    {
+        name: 'Opposing',
+        definition: 'A note that contradicts this one, or that holds under conditions where this one fails. The tension is the content; record it rather than resolving it by dropping a side.',
+    },
+];
+/** Just the names, for the vocabulary match the graph performs on a heading. */
+export const RELATION_NAMES = RELATION_VOCABULARY.map((r) => r.name);
+/**
+ * Stated wherever the vocabulary is explained: an edge is recorded only on the
+ * note carrying the link. An agent that assumes the reciprocal is written for
+ * it will leave half the graph unwritten, and nothing in the output would say so.
+ */
+export const RELATION_DIRECTEDNESS_NOTE = 'An edge is recorded only on the note carrying the link — naming a note Upstream does not write the reciprocal Downstream edge on it.';
 /** graph-context-document spec: positional clusters two directory segments deep; document sections capped for readability. */
 export const DEFAULT_GRAPH_SETTINGS = {
     cluster_depth: 2,
@@ -92,6 +129,27 @@ export const DEFAULT_DIFF_SIZE_CEILING_LINES = 2000;
 export const DEFAULT_CATALOG_PATH = '.contexture/catalog/';
 /** context-catalog spec: a section exceeding this triggers a failing doctor check, not a silent slowdown. */
 export const DEFAULT_CATALOG_SECTION_MAX_BYTES = 32 * 1024;
+/**
+ * context-store spec (a note template is a starting shape, never a note): the
+ * note templates a note is started from — authored-but-tool-owned, like the
+ * catalog and the published pages, and excluded from retrieval for the same
+ * reason. A template is not a note; it is the shape one starts from.
+ */
+export const DEFAULT_TEMPLATES_PATH = '.contexture/templates/';
+/**
+ * harness-portability spec (a store declares which note templates it installs):
+ * the packaged library, installed by default and refreshed by update. The list
+ * is contexture's offer, not its assertion about what a store is about — a
+ * store drops what it does not need, and adds its own kinds as files this list
+ * never names. An empty list installs none.
+ *
+ * Appended, never sorted in: the order here is the order init stages and a
+ * rendered configuration lists, so growing the library is a pure insertion.
+ *
+ * `Note` is the base every other one builds on and the file a store copies to
+ * cut its own kind; it is deliberately first.
+ */
+export const DEFAULT_INSTALLED_TEMPLATES = ['Note', 'Concept', 'Project', 'People', 'Company', 'Deal'];
 /** 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/';
 /**
@@ -141,22 +199,28 @@ export const DEFAULT_ADAPTERS = [{ id: 'claude-code', kind: 'harness-generation'
  *   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.
- * - `harness.procedures_path` and `harness.conventions_path` are pre-rename
- *   spellings, read only as fallbacks by `HarnessSchema`'s transform.
  */
+/**
+ * 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 },
+    templates: { path: DEFAULT_TEMPLATES_PATH, installed: DEFAULT_INSTALLED_TEMPLATES },
     skills: { vendored: DEFAULT_VENDORED_SKILLS },
     ingest: {
         inbox_path: DEFAULT_INBOX_PATH,
@@ -170,5 +234,6 @@ export const SHIPPED_DEFAULTS = {
         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":"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"}
+{"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

@@ -11,10 +11,4 @@ import { type StoreConfig } from './schema.js';
  * behavior.
  */
 export declare function renderStoreConfig(config: StoreConfig): string;
-/**
- * The dotted paths `renderStoreConfig` would drop from this config — what a
- * migration reports it is about to remove, derived from the same walk that
- * does the removing so the report and the write cannot disagree.
- */
-export declare function redundantKeyPaths(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":"AAGA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAkDlE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAW7D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAgB/D"}
+{"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

@@ -16,9 +16,10 @@ function isPlainObject(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` because this is the single writer —
- * every migration's write-back passes through it too, and one that did not
- * would re-materialize the full resolved shape and undo the omission.
+ * 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
@@ -70,28 +71,4 @@ export function renderStoreConfig(config) {
     }
     return text;
 }
-/**
- * The dotted paths `renderStoreConfig` would drop from this config — what a
- * migration reports it is about to remove, derived from the same walk that
- * does the removing so the report and the write cannot disagree.
- */
-export function redundantKeyPaths(config) {
-    const found = [];
-    const walk = (value, defaults, prefix) => {
-        for (const [key, declared] of Object.entries(value)) {
-            const shipped = defaults[key];
-            if (shipped === undefined)
-                continue;
-            const dotted = prefix === '' ? key : `${prefix}.${key}`;
-            if (isPlainObject(declared) && isPlainObject(shipped)) {
-                walk(declared, shipped, dotted);
-                continue;
-            }
-            if (isDeepStrictEqual(declared, shipped))
-                found.push(dotted);
-        }
-    };
-    walk(config, SHIPPED_DEFAULTS, '');
-    return found;
-}
 //# 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":"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"}
+{"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,56 +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).
+ * 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 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.
- *
- * 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.
- */
-/**
- * Bumped to 9 by the capture-tier change (retain-captures-as-provenance,
- * retain-captures-as-provenance): `ingest.capture_root` is added and
- * `ingest.inbox_path`'s shipped default moves inside it. IngestSchema accepts
- * a config with no `capture_root` so an unmigrated store still loads —
- * `ctxr migrate` has to be able to read the file it is about to rewrite —
- * and skips the nesting rule for exactly that case.
+ * 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 = 10;
-/** The version at which the capture tier became part of the store's shape, and its nesting rule enforceable. */
-export declare const CAPTURE_TIER_SCHEMA_VERSION = 9;
-/**
- * Bumped to 10 by config-defaults-as-the-convention: every convention key now
- * carries its shipped default here, and a written config omits what it agrees
- * with. Nothing about the shape got stricter — the bump exists so the pruning
- * migration has a `schema_version <` predicate to decide it still has work,
- * the same way every migration in this repo does.
- */
 export declare const TaxonomyLayerSchema: z.ZodObject<{
     name: z.ZodString;
     path: z.ZodString;
@@ -96,7 +61,6 @@ export declare const StoreConfigSchema: 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>;
             hub_top: z.ZodDefault<z.ZodNumber>;
@@ -122,9 +86,17 @@ export declare const StoreConfigSchema: z.ZodObject<{
     publish: z.ZodPrefault<z.ZodObject<{
         path: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
+    templates: z.ZodPrefault<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        installed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
     skills: z.ZodPrefault<z.ZodObject<{
         vendored: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    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>;
@@ -132,7 +104,6 @@ export declare const StoreConfigSchema: z.ZodObject<{
     }, 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<{
@@ -141,15 +112,12 @@ 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.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.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>, z.ZodTransform<{
         skills_path: string;
@@ -157,31 +125,17 @@ export declare const StoreConfigSchema: z.ZodObject<{
         convention_max_bytes: number;
     }, {
         skills_path?: string | undefined;
-        procedures_path?: string | undefined;
         guidance_path?: string | undefined;
-        conventions_path?: string | undefined;
         convention_max_bytes: number;
     }>>>;
-    adapters: z.ZodDefault<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<{
+    adapters: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
             "harness-generation": "harness-generation";
         }>;
         module: z.ZodOptional<z.ZodString>;
         skills_dir: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>>;
+    }, z.core.$strip>>>;
 }, z.core.$loose>;
 export type StoreConfig = z.infer<typeof StoreConfigSchema>;
 export type TaxonomyLayerConfig = z.infer<typeof TaxonomyLayerSchema>;

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;AAIxB;;;;GAIG;AACH;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;GAaG;AACH;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,gHAAgH;AAChH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;GAMG;AAEH,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAYH;;;;;;GAMG;AACH,QAAA,MAAM,mBAAmB;;;;;iBAKvB,CAAC;AAmOH,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"}
+{"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;AAiOH,QAAA,MAAM,wBAAwB;;;;;;;iBAM5B,CAAC;AAiBH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwC1B,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"}