ctxr-cli 0.1.0

package/dist/core/graph/visibility-filter.d.ts

@@ -0,0 +1,13 @@
+import type { Store } from '../store.js';
+import type { GraphBuildResult } from './model.js';
+/**
+ * context-visibility spec: "excluded... before that operation ranks,
+ * traverses, or otherwise processes results" — filtering the persisted
+ * graph down to only visible nodes BEFORE calling neighbors/shortestPath/
+ * hubs/orphans means an excluded note contributes no edges to any of them,
+ * not merely a post-hoc omission from the final list. A node with no
+ * corresponding current note (a stale graph entry) is excluded rather than
+ * included — visibility can't be resolved for it, so it fails closed.
+ */
+export declare function filterGraphByAudience(store: Store, graph: GraphBuildResult, audience: string): Promise<GraphBuildResult>;
+//# sourceMappingURL=visibility-filter.d.ts.map

package/dist/core/graph/visibility-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-filter.d.ts","sourceRoot":"","sources":["../../../src/core/graph/visibility-filter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAa3B"}

package/dist/core/graph/visibility-filter.js

@@ -0,0 +1,26 @@
+import { listNotes } from '../notes/list.js';
+import { canSee, resolveVisibility } from '../notes/visibility.js';
+import { subgraph } from './query.js';
+/**
+ * context-visibility spec: "excluded... before that operation ranks,
+ * traverses, or otherwise processes results" — filtering the persisted
+ * graph down to only visible nodes BEFORE calling neighbors/shortestPath/
+ * hubs/orphans means an excluded note contributes no edges to any of them,
+ * not merely a post-hoc omission from the final list. A node with no
+ * corresponding current note (a stale graph entry) is excluded rather than
+ * included — visibility can't be resolved for it, so it fails closed.
+ */
+export async function filterGraphByAudience(store, graph, audience) {
+    const notes = await listNotes(store.root, store.config);
+    const byPath = new Map(notes.map((note) => [note.path, note]));
+    const visibleIds = graph.nodes
+        .filter((node) => {
+        const note = byPath.get(node.path);
+        if (!note)
+            return false;
+        return canSee(store.config, audience, resolveVisibility(store.config, note).value);
+    })
+        .map((node) => node.id);
+    return subgraph(graph, visibleIds);
+}
+//# sourceMappingURL=visibility-filter.js.map

package/dist/core/graph/visibility-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-filter.js","sourceRoot":"","sources":["../../../src/core/graph/visibility-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAY,EACZ,KAAuB,EACvB,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK;SAC3B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;IACrF,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE1B,OAAO,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC"}

package/dist/core/hooks.d.ts

@@ -0,0 +1,34 @@
+import type { GitRunner } from './git/exec.js';
+/**
+ * Absolute path to THIS installation's built CLI entrypoint, baked into the
+ * generated hooks so they invoke the exact contexture that installed them —
+ * sidestepping the global/local/npx distribution question entirely. If this
+ * install is later replaced, `doctor`'s self-heal (below) regenerates the
+ * hook with the new path.
+ */
+export declare function resolveOwnBinPath(): string;
+export interface HookSpec {
+    fileName: 'pre-commit' | 'pre-push';
+    templateFileName: 'pre-commit.sh' | 'pre-push.sh';
+}
+export interface HookInstallResult {
+    /** Relative paths (from the store root) of hooks that were written or rewritten. */
+    changed: string[];
+    hooksDir: string;
+}
+/**
+ * Idempotent: a hook whose rendered content already matches what's on disk
+ * is left untouched (no rewrite, no mtime churn), matching every other
+ * generated-region writer in the system.
+ */
+export declare function installHooks(root: string, defaultBranch: string): Promise<HookInstallResult>;
+export declare function configureHooksPath(git: GitRunner, cwd: string): Promise<void>;
+export declare function getConfiguredHooksPath(git: GitRunner, cwd: string): Promise<string | undefined>;
+/**
+ * doctor's hook-health check: are both hooks present with up-to-date
+ * content? (Whether core.hooksPath actually points at them is a separate,
+ * git-config-dependent question — see getConfiguredHooksPath.) Detection
+ * only; the check definition (checks/hooks.ts) decides whether to self-heal.
+ */
+export declare function detectStaleHooks(root: string, defaultBranch: string): Promise<string[]>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/core/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAQD,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAC;IACpC,gBAAgB,EAAE,eAAe,GAAG,aAAa,CAAC;CACnD;AAcD,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsBlG;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKrG;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc7F"}

package/dist/core/hooks.js

@@ -0,0 +1,89 @@
+import { chmod, mkdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { writeFileAtomic } from './fs/atomic.js';
+/**
+ * Absolute path to THIS installation's built CLI entrypoint, baked into the
+ * generated hooks so they invoke the exact contexture that installed them —
+ * sidestepping the global/local/npx distribution question entirely. If this
+ * install is later replaced, `doctor`'s self-heal (below) regenerates the
+ * hook with the new path.
+ */
+export function resolveOwnBinPath() {
+    return fileURLToPath(new URL('../bin.js', import.meta.url));
+}
+function templatesDir() {
+    return fileURLToPath(new URL('../../templates/hooks', import.meta.url));
+}
+const HOOKS_DIR_NAME = '.githooks';
+const HOOK_SPECS = [
+    { fileName: 'pre-commit', templateFileName: 'pre-commit.sh' },
+    { fileName: 'pre-push', templateFileName: 'pre-push.sh' },
+];
+async function renderHook(spec, defaultBranch) {
+    const templateText = await readFile(path.join(templatesDir(), spec.templateFileName), 'utf8');
+    return templateText
+        .replaceAll('__CONTEXTURE_BIN__', resolveOwnBinPath())
+        .replaceAll('__DEFAULT_BRANCH__', defaultBranch);
+}
+/**
+ * Idempotent: a hook whose rendered content already matches what's on disk
+ * is left untouched (no rewrite, no mtime churn), matching every other
+ * generated-region writer in the system.
+ */
+export async function installHooks(root, defaultBranch) {
+    const hooksDir = path.join(root, HOOKS_DIR_NAME);
+    await mkdir(hooksDir, { recursive: true });
+    const changed = [];
+    for (const spec of HOOK_SPECS) {
+        const rendered = await renderHook(spec, defaultBranch);
+        const targetPath = path.join(hooksDir, spec.fileName);
+        let existing;
+        try {
+            existing = await readFile(targetPath, 'utf8');
+        }
+        catch {
+            existing = undefined;
+        }
+        if (existing !== rendered) {
+            await writeFileAtomic(targetPath, rendered);
+            await chmod(targetPath, 0o755);
+            changed.push(`${HOOKS_DIR_NAME}/${spec.fileName}`);
+        }
+    }
+    return { changed, hooksDir };
+}
+export async function configureHooksPath(git, cwd) {
+    await git.run(['config', 'core.hooksPath', HOOKS_DIR_NAME], { cwd });
+}
+export async function getConfiguredHooksPath(git, cwd) {
+    const result = await git.run(['config', 'core.hooksPath'], { cwd, allowFailure: true });
+    if (result.exitCode !== 0)
+        return undefined;
+    const value = result.stdout.trim();
+    return value.length > 0 ? value : undefined;
+}
+/**
+ * doctor's hook-health check: are both hooks present with up-to-date
+ * content? (Whether core.hooksPath actually points at them is a separate,
+ * git-config-dependent question — see getConfiguredHooksPath.) Detection
+ * only; the check definition (checks/hooks.ts) decides whether to self-heal.
+ */
+export async function detectStaleHooks(root, defaultBranch) {
+    const stale = [];
+    for (const spec of HOOK_SPECS) {
+        const rendered = await renderHook(spec, defaultBranch);
+        const targetPath = path.join(root, HOOKS_DIR_NAME, spec.fileName);
+        let existing;
+        try {
+            existing = await readFile(targetPath, 'utf8');
+        }
+        catch {
+            existing = undefined;
+        }
+        if (existing !== rendered)
+            stale.push(`${HOOKS_DIR_NAME}/${spec.fileName}`);
+    }
+    return stale;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/core/hooks.js.map

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

package/dist/core/identity.d.ts

@@ -0,0 +1,14 @@
+import type { StoreConfig } from '../config/schema.js';
+/**
+ * agent-identity spec: three canonical, harness-neutral files — posture,
+ * durable world facts, durable user facts — kept distinct from retrievable
+ * knowledge (excluded from every retrieval leg via config.identity.path
+ * being a member of config.retrieval.exclude_paths). A harness's own
+ * identity-injection adapter decides how these reach a running agent; core
+ * never reads their content itself.
+ */
+export declare const IDENTITY_FILES: readonly ['posture.md', 'world-facts.md', 'user-facts.md'];
+export declare function identityFilePaths(config: StoreConfig): string[];
+/** Creates any of the three canonical identity files that don't exist yet — never overwrites an existing one. */
+export declare function ensureIdentityFiles(root: string, config: StoreConfig): Promise<string[]>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/core/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/core/identity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,YAAI,YAAY,EAAE,gBAAgB,EAAE,eAAe,CAAU,CAAC;AAQzF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAE/D;AAED,iHAAiH;AACjH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY9F"}

package/dist/core/identity.js

@@ -0,0 +1,36 @@
+import { existsSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { writeFileAtomic } from './fs/atomic.js';
+/**
+ * agent-identity spec: three canonical, harness-neutral files — posture,
+ * durable world facts, durable user facts — kept distinct from retrievable
+ * knowledge (excluded from every retrieval leg via config.identity.path
+ * being a member of config.retrieval.exclude_paths). A harness's own
+ * identity-injection adapter decides how these reach a running agent; core
+ * never reads their content itself.
+ */
+export const IDENTITY_FILES = ['posture.md', 'world-facts.md', 'user-facts.md'];
+const TEMPLATES = {
+    'posture.md': '# Agent posture\n\nHow an agent should approach work in this store: tone, defaults, things to always or never do.\n',
+    'world-facts.md': '# Durable world facts\n\nFacts about the world (not the user) worth carrying into every session.\n',
+    'user-facts.md': '# Durable user facts\n\nFacts about the user worth carrying into every session.\n',
+};
+export function identityFilePaths(config) {
+    return IDENTITY_FILES.map((name) => path.join(config.identity.path, name).split(path.sep).join('/'));
+}
+/** Creates any of the three canonical identity files that don't exist yet — never overwrites an existing one. */
+export async function ensureIdentityFiles(root, config) {
+    const created = [];
+    for (const name of IDENTITY_FILES) {
+        const relativePath = path.join(config.identity.path, name).split(path.sep).join('/');
+        const absolutePath = path.join(root, relativePath);
+        if (!existsSync(absolutePath)) {
+            await mkdir(path.dirname(absolutePath), { recursive: true });
+            await writeFileAtomic(absolutePath, TEMPLATES[name]);
+            created.push(relativePath);
+        }
+    }
+    return created;
+}
+//# sourceMappingURL=identity.js.map

package/dist/core/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/core/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,gBAAgB,EAAE,eAAe,CAAU,CAAC;AAEzF,MAAM,SAAS,GAAoD;IACjE,YAAY,EAAE,qHAAqH;IACnI,gBAAgB,EAAE,oGAAoG;IACtH,eAAe,EAAE,mFAAmF;CACrG,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACvG,CAAC;AAED,iHAAiH;AACjH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,MAAmB;IACzE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,eAAe,CAAC,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/ingest/identity.d.ts

@@ -0,0 +1,15 @@
+import type { Note } from '../notes/list.js';
+/**
+ * context-ingest spec: "source type, source id, source hash, ingested
+ * date" — assigned once, at ingest, never before. Like disclosure's
+ * `audience` field, nothing asks these keys to be configurable, so they
+ * live here as the one set of literals every ingest-related module reads
+ * from, rather than each spelling out its own string.
+ */
+export declare const SOURCE_TYPE_FIELD = "source_type";
+export declare const SOURCE_ID_FIELD = "source_id";
+export declare const SOURCE_HASH_FIELD = "source_hash";
+export declare const INGESTED_FIELD = "ingested";
+/** Whether a note already carries any source-identity field — a re-ingest guard, and capture's own invariant. */
+export declare function hasSourceIdentity(note: Pick<Note, 'frontmatter'>): boolean;
+//# sourceMappingURL=identity.d.ts.map

package/dist/core/ingest/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/core/ingest/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,eAAO,MAAM,eAAe,cAAc,CAAC;AAC3C,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,eAAO,MAAM,cAAc,aAAa,CAAC;AAIzC,iHAAiH;AACjH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,OAAO,CAE1E"}

package/dist/core/ingest/identity.js

@@ -0,0 +1,17 @@
+/**
+ * context-ingest spec: "source type, source id, source hash, ingested
+ * date" — assigned once, at ingest, never before. Like disclosure's
+ * `audience` field, nothing asks these keys to be configurable, so they
+ * live here as the one set of literals every ingest-related module reads
+ * from, rather than each spelling out its own string.
+ */
+export const SOURCE_TYPE_FIELD = 'source_type';
+export const SOURCE_ID_FIELD = 'source_id';
+export const SOURCE_HASH_FIELD = 'source_hash';
+export const INGESTED_FIELD = 'ingested';
+const IDENTITY_FIELDS = [SOURCE_TYPE_FIELD, SOURCE_ID_FIELD, SOURCE_HASH_FIELD, INGESTED_FIELD];
+/** Whether a note already carries any source-identity field — a re-ingest guard, and capture's own invariant. */
+export function hasSourceIdentity(note) {
+    return IDENTITY_FIELDS.some((field) => note.frontmatter?.[field] !== undefined);
+}
+//# sourceMappingURL=identity.js.map

package/dist/core/ingest/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/core/ingest/identity.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,MAAM,eAAe,GAAG,CAAC,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,CAAU,CAAC;AAEzG,iHAAiH;AACjH,MAAM,UAAU,iBAAiB,CAAC,IAA+B;IAC/D,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;AAClF,CAAC"}

package/dist/core/ingest/model.d.ts

@@ -0,0 +1,17 @@
+import type { Note } from '../notes/list.js';
+export type SourceCheckVerdict = 'new' | 'already_ingested' | 'alternate_source_match' | 'multiple_matches';
+export interface SourceCheckResult {
+    verdict: SourceCheckVerdict;
+    /** The stage that produced the verdict, when a match stage was reached at all. */
+    stage?: 'source_id' | 'content_hash';
+    /** Paths of every matching note, in the stage that decided the verdict. */
+    matches: string[];
+    hash: string;
+}
+/**
+ * context-ingest spec: two-stage content-addressed dedupe, evaluated in
+ * order, stopping (and reporting `multiple_matches` rather than guessing)
+ * the moment either stage finds more than one match.
+ */
+export declare function evaluateSourceCheck(notes: readonly Note[], candidateHash: string, sourceId: string): SourceCheckResult;
+//# sourceMappingURL=model.d.ts.map

package/dist/core/ingest/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/core/ingest/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,kBAAkB,GAAG,wBAAwB,GAAG,kBAAkB,CAAC;AAE5G,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,kFAAkF;IAClF,KAAK,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;IACrC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAkBtH"}

package/dist/core/ingest/model.js

@@ -0,0 +1,24 @@
+import { SOURCE_HASH_FIELD, SOURCE_ID_FIELD } from './identity.js';
+/**
+ * context-ingest spec: two-stage content-addressed dedupe, evaluated in
+ * order, stopping (and reporting `multiple_matches` rather than guessing)
+ * the moment either stage finds more than one match.
+ */
+export function evaluateSourceCheck(notes, candidateHash, sourceId) {
+    const idMatches = notes.filter((n) => n.frontmatter?.[SOURCE_ID_FIELD] === sourceId).map((n) => n.path);
+    if (idMatches.length > 1) {
+        return { verdict: 'multiple_matches', stage: 'source_id', matches: idMatches, hash: candidateHash };
+    }
+    if (idMatches.length === 1) {
+        return { verdict: 'already_ingested', stage: 'source_id', matches: idMatches, hash: candidateHash };
+    }
+    const hashMatches = notes.filter((n) => n.frontmatter?.[SOURCE_HASH_FIELD] === candidateHash).map((n) => n.path);
+    if (hashMatches.length > 1) {
+        return { verdict: 'multiple_matches', stage: 'content_hash', matches: hashMatches, hash: candidateHash };
+    }
+    if (hashMatches.length === 1) {
+        return { verdict: 'alternate_source_match', stage: 'content_hash', matches: hashMatches, hash: candidateHash };
+    }
+    return { verdict: 'new', matches: [], hash: candidateHash };
+}
+//# sourceMappingURL=model.js.map

package/dist/core/ingest/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/core/ingest/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAanE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAsB,EAAE,aAAqB,EAAE,QAAgB;IACjG,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxG,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACtG,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACtG,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC,KAAK,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjH,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC3G,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACjH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAC9D,CAAC"}

package/dist/core/json-config-merge.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A structured-JSON counterpart to the marker-fenced text writer (context-
+ * store spec's generated-region convention): JSON has no comment syntax to
+ * carry a fence marker in, so a harness permission config (task 8.4) is
+ * merged by array union instead — contexture's own rules are appended only
+ * if not already present, so a hand-added rule survives untouched and a
+ * second run with the same rule set is a true no-op (byte-identical file,
+ * no write at all).
+ */
+export declare function mergeJsonArrayLists(filePath: string, patch: Readonly<Record<string, Readonly<Record<string, readonly string[]>>>>): Promise<{
+    changed: boolean;
+}>;
+//# sourceMappingURL=json-config-merge.d.ts.map

package/dist/core/json-config-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-config-merge.d.ts","sourceRoot":"","sources":["../../src/core/json-config-merge.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,GAC3E,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA8B/B"}

package/dist/core/json-config-merge.js

@@ -0,0 +1,43 @@
+import { readFile } from 'node:fs/promises';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { writeFileAtomic } from './fs/atomic.js';
+/**
+ * A structured-JSON counterpart to the marker-fenced text writer (context-
+ * store spec's generated-region convention): JSON has no comment syntax to
+ * carry a fence marker in, so a harness permission config (task 8.4) is
+ * merged by array union instead — contexture's own rules are appended only
+ * if not already present, so a hand-added rule survives untouched and a
+ * second run with the same rule set is a true no-op (byte-identical file,
+ * no write at all).
+ */
+export async function mergeJsonArrayLists(filePath, patch) {
+    let existing = {};
+    try {
+        existing = JSON.parse(await readFile(filePath, 'utf8'));
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+    const before = JSON.stringify(existing);
+    const merged = { ...existing };
+    for (const [topKey, sections] of Object.entries(patch)) {
+        const existingTop = merged[topKey] ?? {};
+        const mergedTop = { ...existingTop };
+        for (const [listKey, newValues] of Object.entries(sections)) {
+            const existingList = Array.isArray(existingTop[listKey]) ? existingTop[listKey] : [];
+            const additions = newValues.filter((v) => !existingList.includes(v));
+            mergedTop[listKey] = [...existingList, ...additions];
+        }
+        merged[topKey] = mergedTop;
+    }
+    const after = JSON.stringify(merged);
+    if (after === before) {
+        return { changed: false };
+    }
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFileAtomic(filePath, `${JSON.stringify(merged, null, 2)}\n`);
+    return { changed: true };
+}
+//# sourceMappingURL=json-config-merge.js.map

package/dist/core/json-config-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-config-merge.js","sourceRoot":"","sources":["../../src/core/json-config-merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,KAA4E;IAE5E,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA4B,CAAC;IACrF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IAExD,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,WAAW,GAAI,MAAM,CAAC,MAAM,CAAyC,IAAI,EAAE,CAAC;QAClF,MAAM,SAAS,GAA4B,EAAE,GAAG,WAAW,EAAE,CAAC;QAC9D,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5D,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAE,WAAW,CAAC,OAAO,CAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YACnG,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACrE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,SAAS,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,eAAe,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/core/markers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Marker strings for contexture's generated-region convention (context-store
+ * spec: "Marker-fenced generated regions"). Once shipped, marker text is a
+ * FOREVER compatibility surface — changing it orphans every existing store's
+ * fenced blocks — so it lives in exactly this one file, parameterized by
+ * region name, and is never inlined at a call site.
+ */
+export interface Fence {
+    start: string;
+    end: string;
+}
+/** `#`-comment-style fence, used by `.gitignore` in Phase 0. */
+export declare function commentFence(regionName: string): Fence;
+export declare const DERIVED_GITIGNORE_FENCE: Fence;
+/** HTML-comment-style fence, used by markdown files (catalog sections, notes) so the markers render sensibly. */
+export declare function htmlCommentFence(regionName: string): Fence;
+//# sourceMappingURL=markers.d.ts.map

package/dist/core/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../src/core/markers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAKtD;AAED,eAAO,MAAM,uBAAuB,EAAE,KAA+B,CAAC;AAEtE,iHAAiH;AACjH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAK1D"}

package/dist/core/markers.js

@@ -0,0 +1,16 @@
+/** `#`-comment-style fence, used by `.gitignore` in Phase 0. */
+export function commentFence(regionName) {
+    return {
+        start: `# >>> contexture:${regionName} (managed — do not edit) >>>`,
+        end: `# <<< contexture:${regionName} <<<`,
+    };
+}
+export const DERIVED_GITIGNORE_FENCE = commentFence('derived');
+/** HTML-comment-style fence, used by markdown files (catalog sections, notes) so the markers render sensibly. */
+export function htmlCommentFence(regionName) {
+    return {
+        start: `<!-- >>> contexture:${regionName} (managed — do not edit) >>> -->`,
+        end: `<!-- <<< contexture:${regionName} <<< -->`,
+    };
+}
+//# sourceMappingURL=markers.js.map

package/dist/core/markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.js","sourceRoot":"","sources":["../../src/core/markers.ts"],"names":[],"mappings":"AAYA,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,OAAO;QACL,KAAK,EAAE,oBAAoB,UAAU,8BAA8B;QACnE,GAAG,EAAE,oBAAoB,UAAU,MAAM;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAU,YAAY,CAAC,SAAS,CAAC,CAAC;AAEtE,iHAAiH;AACjH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO;QACL,KAAK,EAAE,uBAAuB,UAAU,kCAAkC;QAC1E,GAAG,EAAE,uBAAuB,UAAU,UAAU;KACjD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { Migration } from './types.js';
+/** Every migration contexture ships, in ascending fromVersion order. Later phases append here, nothing else. */
+export declare const MIGRATIONS: readonly Migration[];
+/** Every migration a store currently at `fromVersion` still needs to reach the CLI's supported version, in order. */
+export declare function pendingMigrations(fromVersion: number): Migration[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,gHAAgH;AAChH,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAAqC,CAAC;AAEjF,qHAAqH;AACrH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAElE"}

package/dist/core/migrations/registry.js

@@ -0,0 +1,8 @@
+import { renameVisibilityFieldMigration } from './rename-visibility-field.js';
+/** Every migration contexture ships, in ascending fromVersion order. Later phases append here, nothing else. */
+export const MIGRATIONS = [renameVisibilityFieldMigration];
+/** 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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/migrations/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAG9E,gHAAgH;AAChH,MAAM,CAAC,MAAM,UAAU,GAAyB,CAAC,8BAA8B,CAAC,CAAC;AAEjF,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-visibility-field.d.ts

@@ -0,0 +1,3 @@
+import type { Migration } from './types.js';
+export declare const renameVisibilityFieldMigration: Migration;
+//# sourceMappingURL=rename-visibility-field.d.ts.map

package/dist/core/migrations/rename-visibility-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-visibility-field.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/rename-visibility-field.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAsB5D,eAAO,MAAM,8BAA8B,EAAE,SAuC5C,CAAC"}

package/dist/core/migrations/rename-visibility-field.js

@@ -0,0 +1,62 @@
+import path from 'node:path';
+import { DEFAULT_VISIBILITY_FIELD_KEY, SCHEMA_V1_VISIBILITY_FIELD_KEY } from '../../config/defaults.js';
+import { readConfig } from '../../config/load.js';
+import { renderStoreConfig } from '../../config/render.js';
+import { writeFileAtomic } from '../fs/atomic.js';
+import { listNotes } from '../notes/list.js';
+import { parseNote } from '../notes/parse.js';
+import { renderNoteText } from '../notes/render.js';
+const OLD_KEY = SCHEMA_V1_VISIBILITY_FIELD_KEY;
+const NEW_KEY = DEFAULT_VISIBILITY_FIELD_KEY;
+/**
+ * store-lifecycle spec (task 9.2): the concrete migration proving the
+ * naming-inoculation design holds. The key to search for is the FIXED
+ * historical literal (OLD_KEY), never `store.config.fields.visibility` —
+ * that field is exactly what apply()'s own last step changes, so deriving
+ * "what to look for" from it would make a resumed run, on a store whose
+ * config was already bumped but whose notes weren't all done yet,
+ * incorrectly treat the (already-correct) new key as something to rename
+ * away from. A per-note check is "done" precisely when OLD_KEY is gone
+ * from its frontmatter — true whether it was never present or already
+ * renamed, which is what makes a re-run naturally skip completed work.
+ */
+async function pendingNoteRenames(store) {
+    const notes = await listNotes(store.root, store.config);
+    return notes.filter((note) => note.frontmatter?.[OLD_KEY] !== undefined).map((note) => note.path);
+}
+export const renameVisibilityFieldMigration = {
+    id: '0002-rename-visibility-field-to-lens',
+    fromVersion: 1,
+    toVersion: 2,
+    description: `Rename the visibility frontmatter field from "${OLD_KEY}" to "${NEW_KEY}", on every note and in contexture.yaml.`,
+    async plan(store) {
+        const deltas = (await pendingNoteRenames(store)).map((notePath) => ({
+            path: notePath,
+            description: `rename frontmatter field "${OLD_KEY}" to "${NEW_KEY}"`,
+        }));
+        if (store.config.fields.visibility !== NEW_KEY || store.config.schema_version < 2) {
+            deltas.push({ path: 'contexture.yaml', description: `set fields.visibility to "${NEW_KEY}" and schema_version to 2` });
+        }
+        return deltas;
+    },
+    async apply(store) {
+        const applied = [];
+        for (const notePath of await pendingNoteRenames(store)) {
+            const absolutePath = path.join(store.root, notePath);
+            const note = await parseNote(absolutePath, notePath);
+            const { [OLD_KEY]: value, ...rest } = note.frontmatter ?? {};
+            const frontmatter = { ...rest, [NEW_KEY]: value };
+            await writeFileAtomic(absolutePath, renderNoteText(frontmatter, note.body));
+            applied.push({ path: notePath, description: `renamed frontmatter field "${OLD_KEY}" to "${NEW_KEY}"` });
+        }
+        const configPath = path.join(store.root, 'contexture.yaml');
+        const currentConfig = await readConfig(store.root);
+        if (currentConfig.fields.visibility !== NEW_KEY || currentConfig.schema_version < 2) {
+            const nextConfig = { ...currentConfig, fields: { ...currentConfig.fields, visibility: NEW_KEY }, schema_version: 2 };
+            await writeFileAtomic(configPath, renderStoreConfig(nextConfig));
+            applied.push({ path: 'contexture.yaml', description: `set fields.visibility to "${NEW_KEY}" and schema_version to 2` });
+        }
+        return applied;
+    },
+};
+//# sourceMappingURL=rename-visibility-field.js.map

package/dist/core/migrations/rename-visibility-field.js.map

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

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

@@ -0,0 +1,27 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

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