ctxr-cli 0.7.0 → 0.9.0

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,55 @@ 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.
+ * - `harness.procedures_path` and `harness.conventions_path` are pre-rename
+ *   spellings, read only as fallbacks by `HarnessSchema`'s transform.
+ */
+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,
+};
 //# 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/render.d.ts

@@ -4,6 +4,17 @@ 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;
+/**
+ * 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":"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;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"}

package/dist/config/render.js

@@ -1,15 +1,97 @@
+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` 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.
+ *
+ * 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;
 }
+/**
+ * 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":"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":"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"}

package/dist/config/schema.d.ts

@@ -35,7 +35,24 @@ import { z } from 'zod';
  * keys until `ctxr migrate` drops them, exactly as `identity` did when
  * remove-agent-identity retired it.
  */
-export declare const SUPPORTED_SCHEMA_VERSION = 8;
+/**
+ * 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.
+ */
+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;
@@ -72,11 +89,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,32 +103,33 @@ 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;
+    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>;
@@ -125,24 +145,24 @@ export declare const StoreConfigSchema: z.ZodObject<{
         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<{
+        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>;
@@ -161,7 +181,7 @@ export declare const StoreConfigSchema: z.ZodObject<{
         }>;
         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;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;;;;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"}