ctxr-cli 0.9.0 → 0.10.0

package/dist/core/migrations/registry.js

@@ -1,34 +0,0 @@
-import { addExplanationCraftSkillMigration } from './add-explanation-craft-skill.js';
-import { configDefaultsAsTheConventionMigration } from './config-defaults-as-the-convention.js';
-import { archiveDestinationFromTaxonomyMigration } from './archive-destination-from-taxonomy.js';
-import { dropAccessAxesMigration } from './drop-access-axes.js';
-import { dropForgeAndWorkspacesExternalMigration } from './drop-forge-and-workspaces-external.js';
-import { renameConventionsPathMigration } from './rename-conventions-path.js';
-import { renameProceduresPathMigration } from './rename-procedures-path.js';
-import { retainCapturesAsProvenanceMigration } from './retain-captures-as-provenance.js';
-/**
- * Every migration contexture ships, in ascending fromVersion order. Later
- * phases append here, nothing else.
- *
- * The chain is deliberately NOT contiguous: the 1 -> 2 visibility-field
- * rename was retired with the field itself (retire-the-access-axes D7), so a
- * schema-1 store's first pending migration is the 2 -> 3 one, which guards on
- * `schema_version < 3` and carries it straight there. `pendingMigrations`
- * selects on `fromVersion >= current`, never on adjacency, so a gap costs
- * nothing.
- */
-export const MIGRATIONS = [
-    renameProceduresPathMigration,
-    renameConventionsPathMigration,
-    dropForgeAndWorkspacesExternalMigration,
-    archiveDestinationFromTaxonomyMigration,
-    addExplanationCraftSkillMigration,
-    dropAccessAxesMigration,
-    retainCapturesAsProvenanceMigration,
-    configDefaultsAsTheConventionMigration,
-];
-/** Every migration a store currently at `fromVersion` still needs to reach the CLI's supported version, in order. */
-export function pendingMigrations(fromVersion) {
-    return MIGRATIONS.filter((m) => m.fromVersion >= fromVersion).slice().sort((a, b) => a.fromVersion - b.fromVersion);
-}
-//# sourceMappingURL=registry.js.map

package/dist/core/migrations/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/migrations/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,EAAE,sCAAsC,EAAE,MAAM,wCAAwC,CAAC;AAChG,OAAO,EAAE,uCAAuC,EAAE,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,uCAAuC,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,mCAAmC,EAAE,MAAM,oCAAoC,CAAC;AAGzF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,6BAA6B;IAC7B,8BAA8B;IAC9B,uCAAuC;IACvC,uCAAuC;IACvC,iCAAiC;IACjC,uBAAuB;IACvB,mCAAmC;IACnC,sCAAsC;CACvC,CAAC;AAEF,qHAAqH;AACrH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACtH,CAAC"}

package/dist/core/migrations/rename-conventions-path.d.ts

@@ -1,26 +0,0 @@
-import type { Migration } from './types.js';
-/**
- * rename-conventions-path-to-guidance-path (compose-store-guidance-documents
- * design.md D1/D7): unlike 0003's pure key rename, the key's *default value*
- * also changes (`.contexture/conventions/` -> `.contexture/guidance/`), so a
- * store that never customized the path needs its directory moved on disk,
- * not merely its config key renamed. An operator-customized path is left
- * exactly where it is — only the key spelling changes for them.
- *
- * Migrations only see `Store` (`root` + `config`, no `GitRunner` — see
- * core/store.ts), so the directory move is a plain filesystem rename, not
- * `git mv`. History is still preserved: whatever commits this migration's
- * output (the normal session-submit flow) stages a coherent delete-old,
- * add-new diff, which `git log --follow`'s content-similarity rename
- * detection recognizes identically to an explicit `git mv` — git never
- * records "this was a rename" as a distinct fact in its object model
- * either way.
- *
- * Pending-ness is `store.config.schema_version < 4`, the same
- * schema-version-not-key-presence rule 0003 established, for the same
- * reason: `HarnessSchema`'s fallback transform already populates
- * `guidance_path` on an unmigrated store, so its presence can't distinguish
- * migrated from not.
- */
-export declare const renameConventionsPathMigration: Migration;
-//# sourceMappingURL=rename-conventions-path.d.ts.map

package/dist/core/migrations/rename-conventions-path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rename-conventions-path.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/rename-conventions-path.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAiB5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,8BAA8B,EAAE,SA+C5C,CAAC"}

package/dist/core/migrations/rename-conventions-path.js

@@ -1,86 +0,0 @@
-import { existsSync } from 'node:fs';
-import { rename } from 'node:fs/promises';
-import path from 'node:path';
-import { readConfig } from '../../config/load.js';
-import { renderStoreConfig } from '../../config/render.js';
-import { writeFileAtomic } from '../fs/atomic.js';
-const OLD_DEFAULT_GUIDANCE_PATH = '.contexture/conventions/';
-const NEW_DEFAULT_GUIDANCE_PATH = '.contexture/guidance/';
-const CONFIG_DELTA = {
-    path: 'contexture.yaml',
-    description: 'rename harness.conventions_path to harness.guidance_path and set schema_version to 4',
-};
-function directoryDelta() {
-    return {
-        path: NEW_DEFAULT_GUIDANCE_PATH,
-        description: `move the default-valued guidance directory from ${OLD_DEFAULT_GUIDANCE_PATH} to ${NEW_DEFAULT_GUIDANCE_PATH}`,
-    };
-}
-/**
- * rename-conventions-path-to-guidance-path (compose-store-guidance-documents
- * design.md D1/D7): unlike 0003's pure key rename, the key's *default value*
- * also changes (`.contexture/conventions/` -> `.contexture/guidance/`), so a
- * store that never customized the path needs its directory moved on disk,
- * not merely its config key renamed. An operator-customized path is left
- * exactly where it is — only the key spelling changes for them.
- *
- * Migrations only see `Store` (`root` + `config`, no `GitRunner` — see
- * core/store.ts), so the directory move is a plain filesystem rename, not
- * `git mv`. History is still preserved: whatever commits this migration's
- * output (the normal session-submit flow) stages a coherent delete-old,
- * add-new diff, which `git log --follow`'s content-similarity rename
- * detection recognizes identically to an explicit `git mv` — git never
- * records "this was a rename" as a distinct fact in its object model
- * either way.
- *
- * Pending-ness is `store.config.schema_version < 4`, the same
- * schema-version-not-key-presence rule 0003 established, for the same
- * reason: `HarnessSchema`'s fallback transform already populates
- * `guidance_path` on an unmigrated store, so its presence can't distinguish
- * migrated from not.
- */
-export const renameConventionsPathMigration = {
-    id: '0004-rename-conventions-path-to-guidance-path',
-    fromVersion: 3,
-    toVersion: 4,
-    description: 'Rename the harness.conventions_path config key to harness.guidance_path, move the guidance directory when it sat at the old default, and bump schema_version to 4.',
-    async plan(store) {
-        if (store.config.schema_version >= 4)
-            return [];
-        const deltas = [CONFIG_DELTA];
-        if (store.config.harness.guidance_path === OLD_DEFAULT_GUIDANCE_PATH)
-            deltas.push(directoryDelta());
-        return deltas;
-    },
-    async apply(store) {
-        if (store.config.schema_version >= 4)
-            return [];
-        const configPath = path.join(store.root, 'contexture.yaml');
-        // readConfig() already resolves harness.guidance_path via HarnessSchema's
-        // fallback (from conventions_path if that's all the file has), so
-        // currentConfig.harness carries no conventions_path key at all —
-        // rendering it below writes only guidance_path to disk.
-        const currentConfig = await readConfig(store.root);
-        const appliedDeltas = [CONFIG_DELTA];
-        let guidancePath = currentConfig.harness.guidance_path;
-        if (guidancePath === OLD_DEFAULT_GUIDANCE_PATH) {
-            const oldDir = path.join(store.root, OLD_DEFAULT_GUIDANCE_PATH);
-            const newDir = path.join(store.root, NEW_DEFAULT_GUIDANCE_PATH);
-            // Absent when the store never carried any convention files — nothing
-            // to move on disk, only the config value changes.
-            if (existsSync(oldDir)) {
-                await rename(oldDir, newDir);
-            }
-            guidancePath = NEW_DEFAULT_GUIDANCE_PATH;
-            appliedDeltas.push(directoryDelta());
-        }
-        const nextConfig = {
-            ...currentConfig,
-            schema_version: 4,
-            harness: { ...currentConfig.harness, guidance_path: guidancePath },
-        };
-        await writeFileAtomic(configPath, renderStoreConfig(nextConfig));
-        return appliedDeltas;
-    },
-};
-//# sourceMappingURL=rename-conventions-path.js.map

package/dist/core/migrations/rename-conventions-path.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rename-conventions-path.js","sourceRoot":"","sources":["../../../src/core/migrations/rename-conventions-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,MAAM,yBAAyB,GAAG,0BAA0B,CAAC;AAC7D,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAE1D,MAAM,YAAY,GAAmB;IACnC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,sFAAsF;CACpG,CAAC;AAEF,SAAS,cAAc;IACrB,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,mDAAmD,yBAAyB,OAAO,yBAAyB,EAAE;KAC5H,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAc;IACvD,EAAE,EAAE,+CAA+C;IACnD,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EACT,oKAAoK;IAEtK,KAAK,CAAC,IAAI,CAAC,KAAK;QACd,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAChD,MAAM,MAAM,GAAqB,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,yBAAyB;YAAE,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACpG,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAK;QACf,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAC5D,0EAA0E;QAC1E,kEAAkE;QAClE,iEAAiE;QACjE,wDAAwD;QACxD,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,aAAa,GAAqB,CAAC,YAAY,CAAC,CAAC;QAEvD,IAAI,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC;QACvD,IAAI,YAAY,KAAK,yBAAyB,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;YAChE,qEAAqE;YACrE,kDAAkD;YAClD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/B,CAAC;YACD,YAAY,GAAG,yBAAyB,CAAC;YACzC,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,UAAU,GAAG;YACjB,GAAG,aAAa;YAChB,cAAc,EAAE,CAAC;YACjB,OAAO,EAAE,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE;SACnE,CAAC;QACF,MAAM,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;QAEjE,OAAO,aAAa,CAAC;IACvB,CAAC;CACF,CAAC"}

package/dist/core/migrations/rename-procedures-path.d.ts

@@ -1,17 +0,0 @@
-import type { Migration } from './types.js';
-/**
- * rename-procedures-to-skills (design.md D2): a single-delta migration —
- * unlike the visibility-field rename, no note frontmatter is touched, since
- * only the config key's spelling changes, never any store file's location
- * (DEFAULT_SKILLS_PATH is already DEFAULT_PROCEDURES_PATH's old value).
- *
- * Pending-ness is `store.config.schema_version < 3`, NOT the presence or
- * absence of `store.config.harness.skills_path` — that field is populated
- * by HarnessSchema's fallback transform even on an unmigrated v2 store (so
- * every command keeps working before `ctxr migrate` runs), which means its
- * presence can never distinguish "already migrated" from "not yet
- * migrated." `schema_version` is the one signal the fallback doesn't mask,
- * and this migration is the only thing that ever sets it to 3.
- */
-export declare const renameProceduresPathMigration: Migration;
-//# sourceMappingURL=rename-procedures-path.d.ts.map

package/dist/core/migrations/rename-procedures-path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rename-procedures-path.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/rename-procedures-path.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAO5D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAwB3C,CAAC"}

package/dist/core/migrations/rename-procedures-path.js

@@ -1,45 +0,0 @@
-import path from 'node:path';
-import { readConfig } from '../../config/load.js';
-import { renderStoreConfig } from '../../config/render.js';
-import { writeFileAtomic } from '../fs/atomic.js';
-const CONFIG_DELTA = {
-    path: 'contexture.yaml',
-    description: 'rename harness.procedures_path to harness.skills_path and set schema_version to 3',
-};
-/**
- * rename-procedures-to-skills (design.md D2): a single-delta migration —
- * unlike the visibility-field rename, no note frontmatter is touched, since
- * only the config key's spelling changes, never any store file's location
- * (DEFAULT_SKILLS_PATH is already DEFAULT_PROCEDURES_PATH's old value).
- *
- * Pending-ness is `store.config.schema_version < 3`, NOT the presence or
- * absence of `store.config.harness.skills_path` — that field is populated
- * by HarnessSchema's fallback transform even on an unmigrated v2 store (so
- * every command keeps working before `ctxr migrate` runs), which means its
- * presence can never distinguish "already migrated" from "not yet
- * migrated." `schema_version` is the one signal the fallback doesn't mask,
- * and this migration is the only thing that ever sets it to 3.
- */
-export const renameProceduresPathMigration = {
-    id: '0003-rename-procedures-path-to-skills-path',
-    fromVersion: 2,
-    toVersion: 3,
-    description: 'Rename the harness.procedures_path config key to harness.skills_path, and bump schema_version to 3.',
-    async plan(store) {
-        return store.config.schema_version < 3 ? [CONFIG_DELTA] : [];
-    },
-    async apply(store) {
-        if (store.config.schema_version >= 3)
-            return [];
-        const configPath = path.join(store.root, 'contexture.yaml');
-        // readConfig() already resolves harness.skills_path via HarnessSchema's
-        // fallback (from procedures_path if that's all the file has), so
-        // currentConfig.harness carries no procedures_path key at all —
-        // rendering it below writes only skills_path to disk.
-        const currentConfig = await readConfig(store.root);
-        const nextConfig = { ...currentConfig, schema_version: 3 };
-        await writeFileAtomic(configPath, renderStoreConfig(nextConfig));
-        return [CONFIG_DELTA];
-    },
-};
-//# sourceMappingURL=rename-procedures-path.js.map

package/dist/core/migrations/rename-procedures-path.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rename-procedures-path.js","sourceRoot":"","sources":["../../../src/core/migrations/rename-procedures-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,MAAM,YAAY,GAAmB;IACnC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,mFAAmF;CACjG,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAc;IACtD,EAAE,EAAE,4CAA4C;IAChD,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,qGAAqG;IAElH,KAAK,CAAC,IAAI,CAAC,KAAK;QACd,OAAO,KAAK,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAK;QACf,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAC5D,wEAAwE;QACxE,iEAAiE;QACjE,gEAAgE;QAChE,sDAAsD;QACtD,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,EAAE,GAAG,aAAa,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC3D,MAAM,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;QAEjE,OAAO,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;CACF,CAAC"}

package/dist/core/migrations/retain-captures-as-provenance.d.ts

@@ -1,22 +0,0 @@
-import type { Migration } from './types.js';
-/**
- * retain-captures-as-provenance: captures stop being consumed by ingest and
- * start being retained as the store's provenance ledger, which means they
- * stop being notes. That needs three things on an existing store — a
- * declared capture root, an inbox inside it, and the root excluded from
- * retrieval — and this migration supplies all three.
- *
- * Modelled on 0006: adopt the new shipped default only where the value still
- * sat at the old one, preserve an operator-chosen value verbatim, and move
- * the directory when one exists. Pending-ness is `schema_version < 9`, not
- * key presence, for the reason 0002/0004/0005/0006 all record: the schema's
- * transform fills `capture_root` in on an unmigrated store too, so its
- * presence cannot distinguish migrated from not.
- *
- * The directory move runs before the config write, so an interruption
- * between them leaves the next run able to re-derive what is left: the
- * config still reads schema 8 with the old inbox, the old directory is
- * already gone, and the rename is skipped as done.
- */
-export declare const retainCapturesAsProvenanceMigration: Migration;
-//# sourceMappingURL=retain-captures-as-provenance.d.ts.map

package/dist/core/migrations/retain-captures-as-provenance.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"retain-captures-as-provenance.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/retain-captures-as-provenance.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAsD5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mCAAmC,EAAE,SAoEjD,CAAC"}

package/dist/core/migrations/retain-captures-as-provenance.js

@@ -1,133 +0,0 @@
-import { existsSync } from 'node:fs';
-import { mkdir, rename } from 'node:fs/promises';
-import path from 'node:path';
-import { DEFAULT_CAPTURE_ROOT, DEFAULT_INBOX_PATH } from '../../config/defaults.js';
-import { readConfig } from '../../config/load.js';
-import { renderStoreConfig } from '../../config/render.js';
-import { CaptureRootUndeterminedError } from '../errors.js';
-import { writeFileAtomic } from '../fs/atomic.js';
-/**
- * The inbox default as it stood before this migration. Pinned locally, never
- * read from `defaults.ts`: a migration reasons about the value a store was
- * born with, which must not drift when the shipped default moves again.
- */
-const PREVIOUS_DEFAULT_INBOX_PATH = 'inbox/';
-function normalize(prefix) {
-    return prefix.replace(/\/+$/, '');
-}
-/** The directory one level above `inboxPath`, or null when the inbox is already top-level. */
-function parentDirectoryOf(inboxPath) {
-    const segments = normalize(inboxPath).split('/').filter((segment) => segment !== '');
-    if (segments.length < 2)
-        return null;
-    return `${segments.slice(0, -1).join('/')}/`;
-}
-/**
- * Where this store's capture tier lands. Two cases and one refusal:
- *
- * 1. The store never customized its inbox, so it is ours to move: adopt the
- *    shipped `raw/inbox/` under `raw/`.
- * 2. The store chose an inbox nested at least one level (`staging/inbox/`):
- *    the parent it already chose IS the capture root. The inbox is left
- *    exactly as the operator set it.
- * 3. The store chose a top-level inbox of its own (`incoming/`): there is no
- *    parent to promote short of the store root, and excluding the store root
- *    from retrieval would empty the note list. Refuse before writing
- *    anything and let the operator choose, the same way `source check`
- *    refuses to guess among multiple matches.
- */
-function resolveCaptureTier(inboxPath) {
-    if (normalize(inboxPath) === normalize(PREVIOUS_DEFAULT_INBOX_PATH)) {
-        return { inboxPath: DEFAULT_INBOX_PATH, captureRoot: DEFAULT_CAPTURE_ROOT, adoptsShippedDefault: true };
-    }
-    const parent = parentDirectoryOf(inboxPath);
-    if (parent === null)
-        throw new CaptureRootUndeterminedError(inboxPath);
-    return { inboxPath, captureRoot: parent, adoptsShippedDefault: false };
-}
-function alreadyExcluded(excludePaths, captureRoot) {
-    return excludePaths.some((excluded) => normalize(excluded) === normalize(captureRoot));
-}
-/**
- * retain-captures-as-provenance: captures stop being consumed by ingest and
- * start being retained as the store's provenance ledger, which means they
- * stop being notes. That needs three things on an existing store — a
- * declared capture root, an inbox inside it, and the root excluded from
- * retrieval — and this migration supplies all three.
- *
- * Modelled on 0006: adopt the new shipped default only where the value still
- * sat at the old one, preserve an operator-chosen value verbatim, and move
- * the directory when one exists. Pending-ness is `schema_version < 9`, not
- * key presence, for the reason 0002/0004/0005/0006 all record: the schema's
- * transform fills `capture_root` in on an unmigrated store too, so its
- * presence cannot distinguish migrated from not.
- *
- * The directory move runs before the config write, so an interruption
- * between them leaves the next run able to re-derive what is left: the
- * config still reads schema 8 with the old inbox, the old directory is
- * already gone, and the rename is skipped as done.
- */
-export const retainCapturesAsProvenanceMigration = {
-    id: '0009-retain-captures-as-provenance',
-    fromVersion: 8,
-    toVersion: 9,
-    description: 'Declare the capture tier: add ingest.capture_root, move a default-valued inbox inside it, exclude the capture root from retrieval, and bump schema_version to 9.',
-    async plan(store) {
-        if (store.config.schema_version >= 9)
-            return [];
-        const tier = resolveCaptureTier(store.config.ingest.inbox_path);
-        const deltas = [
-            {
-                path: 'contexture.yaml',
-                description: `add ingest.capture_root: ${tier.captureRoot} and set schema_version to 9`,
-            },
-        ];
-        if (tier.adoptsShippedDefault) {
-            deltas.push({
-                path: 'contexture.yaml',
-                description: `adopt the shipped inbox default, moving ingest.inbox_path from ${PREVIOUS_DEFAULT_INBOX_PATH} to ${tier.inboxPath}`,
-            });
-            if (existsSync(path.join(store.root, PREVIOUS_DEFAULT_INBOX_PATH))) {
-                deltas.push({
-                    path: tier.inboxPath,
-                    description: `move the inbox directory from ${PREVIOUS_DEFAULT_INBOX_PATH} to ${tier.inboxPath}`,
-                });
-            }
-        }
-        if (!alreadyExcluded(store.config.retrieval.exclude_paths, tier.captureRoot)) {
-            deltas.push({
-                path: 'contexture.yaml',
-                description: `add ${tier.captureRoot} to retrieval.exclude_paths, so retained captures are never notes`,
-            });
-        }
-        return deltas;
-    },
-    async apply(store) {
-        if (store.config.schema_version >= 9)
-            return [];
-        const currentConfig = await readConfig(store.root);
-        const tier = resolveCaptureTier(currentConfig.ingest.inbox_path);
-        const appliedDeltas = await this.plan({ ...store, config: currentConfig });
-        if (tier.adoptsShippedDefault) {
-            const oldDir = path.join(store.root, PREVIOUS_DEFAULT_INBOX_PATH);
-            const newDir = path.join(store.root, tier.inboxPath);
-            // Absent whenever nothing was ever captured — only the config changes.
-            if (existsSync(oldDir) && !existsSync(newDir)) {
-                await mkdir(path.dirname(newDir), { recursive: true });
-                await rename(oldDir, newDir);
-            }
-        }
-        const excludePaths = alreadyExcluded(currentConfig.retrieval.exclude_paths, tier.captureRoot)
-            ? [...currentConfig.retrieval.exclude_paths]
-            : [...currentConfig.retrieval.exclude_paths, tier.captureRoot];
-        const nextConfig = {
-            ...currentConfig,
-            schema_version: 9,
-            retrieval: { ...currentConfig.retrieval, exclude_paths: excludePaths },
-            ingest: { ...currentConfig.ingest, inbox_path: tier.inboxPath, capture_root: tier.captureRoot },
-        };
-        await writeFileAtomic(path.join(store.root, 'contexture.yaml'), renderStoreConfig(nextConfig));
-        return appliedDeltas;
-    },
-};
-//# sourceMappingURL=retain-captures-as-provenance.js.map

package/dist/core/migrations/retain-captures-as-provenance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"retain-captures-as-provenance.js","sourceRoot":"","sources":["../../../src/core/migrations/retain-captures-as-provenance.ts"],"names":[],"mappings":"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"}

package/dist/core/migrations/types.d.ts

@@ -1,27 +0,0 @@
-import type { Store } from '../store.js';
-/** One concrete, reportable change a migration made (or would make). */
-export interface MigrationDelta {
-    /** The file touched, relative to the store root — 'contexture.yaml' for the config itself. */
-    path: string;
-    description: string;
-}
-/**
- * store-lifecycle spec: "named, dry-runnable, resumable." A migration's
- * `plan()` and `apply()` both re-derive what still needs doing from the
- * store's CURRENT on-disk state, never from separately-tracked progress —
- * so re-running `apply()` after an interruption naturally skips whatever
- * was already done (it no longer matches the "needs migrating" condition)
- * and finishes the rest, with no separate progress file to go stale or
- * corrupt.
- */
-export interface Migration {
-    id: string;
-    fromVersion: number;
-    toVersion: number;
-    description: string;
-    /** Computes exactly what apply() would change, without writing anything. */
-    plan(store: Store): Promise<MigrationDelta[]>;
-    /** Applies only what plan() would still report as pending; returns what it actually changed. */
-    apply(store: Store): Promise<MigrationDelta[]>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/core/migrations/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9C,gGAAgG;IAChG,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAChD"}

package/dist/core/migrations/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/core/migrations/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/migrations/types.ts"],"names":[],"mappings":""}