ctxr-cli 0.1.0

package/dist/core/queue.js

@@ -0,0 +1,75 @@
+import { mkdir, readdir, readFile, rm } from 'node:fs/promises';
+import { randomBytes } from 'node:crypto';
+import path from 'node:path';
+import { writeFileAtomic } from './fs/atomic.js';
+/**
+ * write-lifecycle spec: append-via-queue for shared append-only files. Two
+ * sessions on separate branches genuinely cannot both append to the same
+ * file (e.g. a chronological log) without conflicting when merged — so each
+ * queues a uniquely named, self-contained intent file instead, and a
+ * reconciler applies them in order (oldest first, by the epoch-ms prefix).
+ */
+const QUEUE_DIR_NAME = '.queue';
+const TARGET_HEADER_PREFIX = 'target: ';
+function isValidTarget(relativePath) {
+    return !path.isAbsolute(relativePath) && !relativePath.split('/').includes('..') && relativePath.endsWith('.md');
+}
+export async function queueAppend(storeRoot, targetRelativePath, content) {
+    if (!isValidTarget(targetRelativePath)) {
+        throw new Error(`Invalid queue target path: "${targetRelativePath}" (must be a relative .md path with no "..").`);
+    }
+    const queueDir = path.join(storeRoot, QUEUE_DIR_NAME);
+    await mkdir(queueDir, { recursive: true });
+    const fileName = `${Date.now()}__${randomBytes(4).toString('hex')}.append`;
+    const filePath = path.join(queueDir, fileName);
+    await writeFileAtomic(filePath, `${TARGET_HEADER_PREFIX}${targetRelativePath}\n${content}`);
+    return filePath;
+}
+/**
+ * Applies every pending queue file to its target, oldest first, deleting
+ * each as it's applied. A malformed entry (missing header, path escaping
+ * the store, or a non-.md target) throws rather than being silently
+ * skipped or guessed at.
+ */
+export async function reconcileQueue(storeRoot) {
+    const queueDir = path.join(storeRoot, QUEUE_DIR_NAME);
+    let entries;
+    try {
+        entries = await readdir(queueDir);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return { applied: [] };
+        throw err;
+    }
+    const appendFiles = entries.filter((e) => e.endsWith('.append')).sort();
+    const applied = [];
+    for (const fileName of appendFiles) {
+        const filePath = path.join(queueDir, fileName);
+        const raw = await readFile(filePath, 'utf8');
+        const newlineIndex = raw.indexOf('\n');
+        if (newlineIndex === -1 || !raw.startsWith(TARGET_HEADER_PREFIX)) {
+            throw new Error(`Malformed queue file "${fileName}": missing "target: <path>" header.`);
+        }
+        const targetRelativePath = raw.slice(TARGET_HEADER_PREFIX.length, newlineIndex).trim();
+        if (!isValidTarget(targetRelativePath)) {
+            throw new Error(`Malformed queue file "${fileName}": invalid target "${targetRelativePath}".`);
+        }
+        const body = raw.slice(newlineIndex + 1);
+        const targetPath = path.join(storeRoot, targetRelativePath);
+        let existing = '';
+        try {
+            existing = await readFile(targetPath, 'utf8');
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+        const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n' : '';
+        await writeFileAtomic(targetPath, `${existing}${separator}${body}`);
+        await rm(filePath);
+        applied.push({ file: fileName, target: targetRelativePath });
+    }
+    return { applied };
+}
+//# sourceMappingURL=queue.js.map

package/dist/core/queue.js.map

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

package/dist/core/reconcile.d.ts

@@ -0,0 +1,18 @@
+import type { StoreConfig } from '../config/schema.js';
+import type { RunEnv } from './env.js';
+export declare const WORKTREES_GITIGNORE_FENCE: import("./markers.js").Fence;
+export interface ReconcileResult {
+    /** Store-relative paths written this run (an up-to-date store yields none). */
+    changed: string[];
+}
+/**
+ * Brings every contexture-OWNED file in a store to the installed package's
+ * version: the managed .gitignore blocks, every generated AGENTS.md
+ * section, the contexture-owned skill copies, and the git hooks. Operator
+ * content is never rewritten — identity files are created only when
+ * missing. Shared by `ctxr init` (reconciling an existing store) and
+ * `ctxr update` (after upgrading contexture). Byte-stable: a second run
+ * with nothing changed writes nothing.
+ */
+export declare function reconcileStore(env: RunEnv, root: string, config: StoreConfig): Promise<ReconcileResult>;
+//# sourceMappingURL=reconcile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/core/reconcile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAevC,eAAO,MAAM,yBAAyB,8BAA4B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAoC7G"}

package/dist/core/reconcile.js

@@ -0,0 +1,49 @@
+import path from 'node:path';
+import { buildAgentsCanonicalSection, buildAgentsCaptureSection, buildAgentsConventionsSection, buildAgentsIdentitySection, buildAgentsLegRoutingSection, buildAgentsPlacementSection, } from './agents-doc.js';
+import { upsertFencedRegionInFile } from './fs/fenced-region.js';
+import { configureHooksPath, installHooks } from './hooks.js';
+import { ensureIdentityFiles } from './identity.js';
+import { commentFence, DERIVED_GITIGNORE_FENCE } from './markers.js';
+import { syncShippedSkills } from './procedures.js';
+export const WORKTREES_GITIGNORE_FENCE = commentFence('worktrees');
+/**
+ * Brings every contexture-OWNED file in a store to the installed package's
+ * version: the managed .gitignore blocks, every generated AGENTS.md
+ * section, the contexture-owned skill copies, and the git hooks. Operator
+ * content is never rewritten — identity files are created only when
+ * missing. Shared by `ctxr init` (reconciling an existing store) and
+ * `ctxr update` (after upgrading contexture). Byte-stable: a second run
+ * with nothing changed writes nothing.
+ */
+export async function reconcileStore(env, root, config) {
+    const changed = [];
+    const note = (relativePath, didChange) => {
+        if (didChange)
+            changed.push(relativePath);
+    };
+    const gitignorePath = path.join(root, '.gitignore');
+    note('.gitignore', (await upsertFencedRegionInFile(gitignorePath, DERIVED_GITIGNORE_FENCE, config.derived.paths)).changed);
+    note('.gitignore', (await upsertFencedRegionInFile(gitignorePath, WORKTREES_GITIGNORE_FENCE, [config.session.worktrees_path])).changed);
+    // Files the generated sections index (skills, identity) must be current
+    // BEFORE the sections are rendered — the procedure index is a disk scan.
+    changed.push(...(await ensureIdentityFiles(root, config)));
+    changed.push(...(await syncShippedSkills(root, config)));
+    let agentsChanged = false;
+    for (const build of [
+        buildAgentsLegRoutingSection,
+        buildAgentsCaptureSection,
+        buildAgentsPlacementSection,
+        buildAgentsCanonicalSection,
+        buildAgentsIdentitySection,
+        buildAgentsConventionsSection,
+    ]) {
+        if ((await build(root, config)).changed)
+            agentsChanged = true;
+    }
+    note('AGENTS.md', agentsChanged);
+    const { changed: hookFiles } = await installHooks(root, config.git.default_branch);
+    changed.push(...hookFiles);
+    await configureHooksPath(env.git, root);
+    return { changed: [...new Set(changed)] };
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/core/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../src/core/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AAOnE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,IAAY,EAAE,MAAmB;IACjF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,YAAoB,EAAE,SAAkB,EAAQ,EAAE;QAC9D,IAAI,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpD,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,wBAAwB,CAAC,aAAa,EAAE,uBAAuB,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3H,IAAI,CACF,YAAY,EACZ,CAAC,MAAM,wBAAwB,CAAC,aAAa,EAAE,yBAAyB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CACpH,CAAC;IAEF,wEAAwE;IACxE,yEAAyE;IACzE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAEzD,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI;QAClB,4BAA4B;QAC5B,yBAAyB;QACzB,2BAA2B;QAC3B,2BAA2B;QAC3B,0BAA0B;QAC1B,6BAA6B;KAC9B,EAAE,CAAC;QACF,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO;YAAE,aAAa,GAAG,IAAI,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEjC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnF,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAC3B,MAAM,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAExC,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/core/records.d.ts

@@ -0,0 +1,16 @@
+import type { Store } from './store.js';
+/**
+ * context-retrieval spec: a stable per-note record `{id, path, visibility,
+ * gloss, hash}`, usable as input to a future (v2) search capability without
+ * re-deriving note identity. Shared by `graph build --emit-records` and
+ * `catalog build --emit-records` so both commands agree on the shape.
+ */
+export interface PerNoteRecord {
+    id: string;
+    path: string;
+    visibility: string;
+    gloss: string;
+    hash: string;
+}
+export declare function buildPerNoteRecords(store: Store): Promise<PerNoteRecord[]>;
+//# sourceMappingURL=records.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/core/records.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAWD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoBhF"}

package/dist/core/records.js

@@ -0,0 +1,36 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { catalogSectionsFor, parseCatalogGlosses, sectionFileName } from './catalog/model.js';
+import { contentHashOfBody } from './content/canonicalize.js';
+import { listNotes } from './notes/list.js';
+import { resolveVisibility } from './notes/visibility.js';
+async function readIfExists(filePath) {
+    try {
+        return await readFile(filePath, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return '';
+        throw err;
+    }
+}
+export async function buildPerNoteRecords(store) {
+    const notes = await listNotes(store.root, store.config);
+    const sections = catalogSectionsFor(store.config);
+    const catalogDir = path.join(store.root, store.config.catalog.path);
+    const glosses = new Map();
+    for (const section of sections) {
+        const body = await readIfExists(path.join(catalogDir, sectionFileName(section)));
+        for (const [notePath, entry] of parseCatalogGlosses(body)) {
+            glosses.set(notePath, entry.gloss);
+        }
+    }
+    return notes.map((note) => ({
+        id: note.path,
+        path: note.path,
+        visibility: resolveVisibility(store.config, note).value,
+        gloss: glosses.get(note.path) ?? '',
+        hash: contentHashOfBody(note.body),
+    }));
+}
+//# sourceMappingURL=records.js.map

package/dist/core/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/core/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAiB1D,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAChE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAY;IACpD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjF,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,EAAE,EAAE,IAAI,CAAC,IAAI;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK;QACvD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACnC,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;KACnC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/core/reporter.d.ts

@@ -0,0 +1,20 @@
+import type { Io } from './env.js';
+import type { Envelope } from './envelope.js';
+/**
+ * The only object in the codebase permitted to write to stdout. This is what
+ * makes the "JSON output is parseable in isolation" scenario mechanical
+ * rather than a convention every command has to remember: a command that
+ * imports Reporter has no other way to reach stdout, and a guard test
+ * (single-source-literals.test.ts) fails on any direct `process.stdout` use
+ * under src/commands/**.
+ */
+export interface Reporter {
+    /** Emits the command's result exactly once: JSON in --json mode, a human summary otherwise. */
+    emitResult<T>(envelope: Envelope<T>, humanSummary: string): void;
+    /** Diagnostic narration — always stderr, safe to call in either mode. */
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export declare function createReporter(io: Io, jsonMode: boolean): Reporter;
+//# sourceMappingURL=reporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/core/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,+FAA+F;IAC/F,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,yEAAyE;IACzE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAyBlE"}

package/dist/core/reporter.js

@@ -0,0 +1,25 @@
+export function createReporter(io, jsonMode) {
+    let emitted = false;
+    function assertNotEmitted() {
+        if (emitted) {
+            throw new Error('Reporter.emitResult was called more than once in a single invocation.');
+        }
+        emitted = true;
+    }
+    return {
+        emitResult(envelope, humanSummary) {
+            assertNotEmitted();
+            io.stdout.write(`${jsonMode ? JSON.stringify(envelope) : humanSummary}\n`);
+        },
+        info(message) {
+            io.stderr.write(`${message}\n`);
+        },
+        warn(message) {
+            io.stderr.write(`warning: ${message}\n`);
+        },
+        error(message) {
+            io.stderr.write(`error: ${message}\n`);
+        },
+    };
+}
+//# sourceMappingURL=reporter.js.map

package/dist/core/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/core/reporter.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,cAAc,CAAC,EAAM,EAAE,QAAiB;IACtD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,SAAS,gBAAgB;QACvB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,OAAO;QACL,UAAU,CAAC,QAAQ,EAAE,YAAY;YAC/B,gBAAgB,EAAE,CAAC;YACnB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,OAAO;YACV,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,OAAO;YACV,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,OAAO;YACX,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/root.d.ts

@@ -0,0 +1,24 @@
+import type { RunEnv } from './env.js';
+/** The one config filename every root-resolution function looks for. */
+export declare const CONFIG_FILE_NAME = "contexture.yaml";
+export interface RootFlags {
+    root?: string;
+}
+/**
+ * Root resolution for every command except `init` (harness-portability spec):
+ * an explicit --root argument beats an inherited CONTEXTURE_ROOT env var,
+ * which beats walking up from cwd looking for contexture.yaml. If none
+ * resolves, throws NoStoreRootError rather than guessing a fallback.
+ *
+ * Exactly one env var (CONTEXTURE_ROOT) and one flag (--root) are recognized
+ * — no aliases are checked here, ever, by construction.
+ */
+export declare function resolveExistingRoot(env: RunEnv, flags: RootFlags): string;
+/**
+ * Root resolution for `init` only: --root -> CONTEXTURE_ROOT -> cwd.
+ * Deliberately never walks up — unlike every other command, init CREATES a
+ * store rather than finding one, and walking up would let `ctxr init`
+ * run in a subdirectory silently re-target and reinitialize a parent store.
+ */
+export declare function resolveRootForInit(env: RunEnv, flags: RootFlags): string;
+//# sourceMappingURL=root.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/core/root.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAoBzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CASxE"}

package/dist/core/root.js

@@ -0,0 +1,51 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { NoStoreRootError } from './errors.js';
+/** The one config filename every root-resolution function looks for. */
+export const CONFIG_FILE_NAME = 'contexture.yaml';
+/**
+ * Root resolution for every command except `init` (harness-portability spec):
+ * an explicit --root argument beats an inherited CONTEXTURE_ROOT env var,
+ * which beats walking up from cwd looking for contexture.yaml. If none
+ * resolves, throws NoStoreRootError rather than guessing a fallback.
+ *
+ * Exactly one env var (CONTEXTURE_ROOT) and one flag (--root) are recognized
+ * — no aliases are checked here, ever, by construction.
+ */
+export function resolveExistingRoot(env, flags) {
+    if (flags.root) {
+        return path.resolve(env.cwd, flags.root);
+    }
+    const fromEnv = env.env.CONTEXTURE_ROOT;
+    if (fromEnv) {
+        return path.resolve(env.cwd, fromEnv);
+    }
+    let dir = path.resolve(env.cwd);
+    for (;;) {
+        if (existsSync(path.join(dir, CONFIG_FILE_NAME))) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new NoStoreRootError({ flag: Boolean(flags.root), env: Boolean(fromEnv), cwd: env.cwd });
+}
+/**
+ * Root resolution for `init` only: --root -> CONTEXTURE_ROOT -> cwd.
+ * Deliberately never walks up — unlike every other command, init CREATES a
+ * store rather than finding one, and walking up would let `ctxr init`
+ * run in a subdirectory silently re-target and reinitialize a parent store.
+ */
+export function resolveRootForInit(env, flags) {
+    if (flags.root) {
+        return path.resolve(env.cwd, flags.root);
+    }
+    const fromEnv = env.env.CONTEXTURE_ROOT;
+    if (fromEnv) {
+        return path.resolve(env.cwd, fromEnv);
+    }
+    return path.resolve(env.cwd);
+}
+//# sourceMappingURL=root.js.map

package/dist/core/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/core/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAMlD;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,KAAgB;IAC/D,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC;IACxC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,SAAS,CAAC;QACR,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,MAAM,IAAI,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;AACjG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,KAAgB;IAC9D,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC;IACxC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/core/security/secrets.d.ts

@@ -0,0 +1,17 @@
+/**
+ * write-lifecycle spec: pre-commit runs "a secret-pattern scan." A modest,
+ * documented set of high-confidence patterns — this is a safety net behind
+ * PR review, not a substitute for it (design.md: review is the layer that
+ * doesn't depend on hook cooperation).
+ */
+export interface SecretPattern {
+    id: string;
+    regex: RegExp;
+}
+export declare const SECRET_PATTERNS: readonly SecretPattern[];
+export interface SecretMatch {
+    patternId: string;
+    line: number;
+}
+export declare function scanForSecrets(content: string): SecretMatch[];
+//# sourceMappingURL=secrets.d.ts.map

package/dist/core/security/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../../src/core/security/secrets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAMnD,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAY7D"}

package/dist/core/security/secrets.js

@@ -0,0 +1,21 @@
+export const SECRET_PATTERNS = [
+    { id: 'aws_access_key_id', regex: /AKIA[0-9A-Z]{16}/g },
+    { id: 'private_key_block', regex: /-----BEGIN (RSA |EC |OPENSSH |DSA )?PRIVATE KEY-----/g },
+    { id: 'github_token', regex: /gh[pousr]_[A-Za-z0-9]{36,}/g },
+    { id: 'slack_token', regex: /xox[baprs]-[A-Za-z0-9-]{10,}/g },
+    { id: 'generic_api_key', regex: /sk-[A-Za-z0-9]{20,}/g },
+];
+export function scanForSecrets(content) {
+    const matches = [];
+    const lines = content.split('\n');
+    lines.forEach((line, index) => {
+        for (const pattern of SECRET_PATTERNS) {
+            pattern.regex.lastIndex = 0;
+            if (pattern.regex.test(line)) {
+                matches.push({ patternId: pattern.id, line: index + 1 });
+            }
+        }
+    });
+    return matches;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/core/security/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../../src/core/security/secrets.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACvD,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,uDAAuD,EAAE;IAC3F,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,6BAA6B,EAAE;IAC5D,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,+BAA+B,EAAE;IAC7D,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,sBAAsB,EAAE;CACzD,CAAC;AAOF,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;YAC5B,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/session.d.ts

@@ -0,0 +1,15 @@
+import type { StoreConfig } from '../config/schema.js';
+/**
+ * write-lifecycle spec: session branch names are prefixed (configurable —
+ * default "session/") and unique. Sortable by creation time, since that's
+ * useful for reap/list ordering without needing to consult git history.
+ */
+export declare function generateSessionBranchName(config: StoreConfig, now?: Date): string;
+export declare function isSessionBranch(config: StoreConfig, branch: string): boolean;
+/** A branch name may contain "/"; a directory name may not treat that as a separator. */
+export declare function worktreeDirNameFor(branch: string): string;
+export declare function worktreePathFor(store: {
+    root: string;
+    config: StoreConfig;
+}, branch: string): string;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAQ7F;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpG"}

package/dist/core/session.js

@@ -0,0 +1,27 @@
+import { randomBytes } from 'node:crypto';
+import path from 'node:path';
+/**
+ * write-lifecycle spec: session branch names are prefixed (configurable —
+ * default "session/") and unique. Sortable by creation time, since that's
+ * useful for reap/list ordering without needing to consult git history.
+ */
+export function generateSessionBranchName(config, now = new Date()) {
+    const stamp = now
+        .toISOString()
+        .replace(/[-:]/g, '')
+        .replace(/\.\d+Z$/, '')
+        .replace('T', '-');
+    const suffix = randomBytes(3).toString('hex');
+    return `${config.session.branch_prefix}${stamp}-${suffix}`;
+}
+export function isSessionBranch(config, branch) {
+    return branch.startsWith(config.session.branch_prefix);
+}
+/** A branch name may contain "/"; a directory name may not treat that as a separator. */
+export function worktreeDirNameFor(branch) {
+    return branch.replace(/\//g, '-');
+}
+export function worktreePathFor(store, branch) {
+    return path.join(store.root, store.config.session.worktrees_path, worktreeDirNameFor(branch));
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAmB,EAAE,GAAG,GAAS,IAAI,IAAI,EAAE;IACnF,MAAM,KAAK,GAAG,GAAG;SACd,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,MAAc;IACjE,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AACzD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA4C,EAAE,MAAc;IAC1F,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAChG,CAAC"}

package/dist/core/store.d.ts

@@ -0,0 +1,15 @@
+import type { StoreConfig } from '../config/schema.js';
+import type { RunEnv } from './env.js';
+import { type RootFlags } from './root.js';
+export interface Store {
+    root: string;
+    config: StoreConfig;
+}
+/**
+ * The choke point every non-`init` command goes through: root resolution,
+ * then the git-repository check (context-store spec), then config load
+ * (which itself gates schema_version — store-lifecycle spec). Done once,
+ * structurally, here — so no command can skip either check by omission.
+ */
+export declare function openStore(env: RunEnv, flags: RootFlags): Promise<Store>;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/core/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEhE,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAO7E"}

package/dist/core/store.js

@@ -0,0 +1,19 @@
+import { readConfig } from '../config/load.js';
+import { NotAGitRepositoryError } from './errors.js';
+import { isInsideGitRepo } from './git/repo.js';
+import { resolveExistingRoot } from './root.js';
+/**
+ * The choke point every non-`init` command goes through: root resolution,
+ * then the git-repository check (context-store spec), then config load
+ * (which itself gates schema_version — store-lifecycle spec). Done once,
+ * structurally, here — so no command can skip either check by omission.
+ */
+export async function openStore(env, flags) {
+    const root = resolveExistingRoot(env, flags);
+    if (!(await isInsideGitRepo(env.git, root))) {
+        throw new NotAGitRepositoryError(root);
+    }
+    const config = await readConfig(root);
+    return { root, config };
+}
+//# sourceMappingURL=store.js.map

package/dist/core/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/core/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAkB,MAAM,WAAW,CAAC;AAOhE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,KAAgB;IAC3D,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/** contexture's library public surface. */
+export type { Io, RunEnv } from './core/env.js';
+export { realEnv } from './core/env.js';
+export type { Envelope, Finding, Status } from './core/envelope.js';
+export { ExitCode } from './core/exit-codes.js';
+export type { StoreConfig, TaxonomyLayerConfig } from './config/schema.js';
+export { StoreConfigSchema, SUPPORTED_SCHEMA_VERSION } from './config/schema.js';
+export type { Store } from './core/store.js';
+export { openStore } from './core/store.js';
+export type { TaxonomyLayer, TaxonomyProfile } from './taxonomy/profiles.js';
+export { DEFAULT_PROFILE_ID, SHIPPED_PROFILES, defaultProfile, profileById } from './taxonomy/profiles.js';
+export { run } from './run.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACjF,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { realEnv } from './core/env.js';
+export { ExitCode } from './core/exit-codes.js';
+export { StoreConfigSchema, SUPPORTED_SCHEMA_VERSION } from './config/schema.js';
+export { openStore } from './core/store.js';
+export { DEFAULT_PROFILE_ID, SHIPPED_PROFILES, defaultProfile, profileById } from './taxonomy/profiles.js';
+export { run } from './run.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/prompt/inquirer-prompter.d.ts

@@ -0,0 +1,14 @@
+import type { Prompter } from './prompter.js';
+/**
+ * The real prompter. Renders entirely to stderr via @inquirer/prompts'
+ * `output` context option — never stdout, so no invocation mode can let
+ * prompt text corrupt a --json payload.
+ *
+ * Each choice's name embeds its description directly (rather than relying on
+ * @inquirer's "description of the currently-highlighted item" feature),
+ * because store-lifecycle's spec requires every shipped profile's name AND
+ * description to be presented together, not revealed one at a time as the
+ * operator moves the cursor.
+ */
+export declare function createInquirerPrompter(): Prompter;
+//# sourceMappingURL=inquirer-prompter.d.ts.map

package/dist/prompt/inquirer-prompter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inquirer-prompter.d.ts","sourceRoot":"","sources":["../../src/prompt/inquirer-prompter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,QAAQ,CAgBjD"}

package/dist/prompt/inquirer-prompter.js

@@ -0,0 +1,27 @@
+import { select } from '@inquirer/prompts';
+/**
+ * The real prompter. Renders entirely to stderr via @inquirer/prompts'
+ * `output` context option — never stdout, so no invocation mode can let
+ * prompt text corrupt a --json payload.
+ *
+ * Each choice's name embeds its description directly (rather than relying on
+ * @inquirer's "description of the currently-highlighted item" feature),
+ * because store-lifecycle's spec requires every shipped profile's name AND
+ * description to be presented together, not revealed one at a time as the
+ * operator moves the cursor.
+ */
+export function createInquirerPrompter() {
+    return {
+        async selectProfile(input) {
+            return select({
+                message: input.message,
+                default: input.defaultId,
+                choices: input.choices.map((c) => ({
+                    name: `${c.name} — ${c.description}`,
+                    value: c.id,
+                })),
+            }, { output: process.stderr });
+        },
+    };
+}
+//# sourceMappingURL=inquirer-prompter.js.map

package/dist/prompt/inquirer-prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inquirer-prompter.js","sourceRoot":"","sources":["../../src/prompt/inquirer-prompter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,CAAC,aAAa,CAAC,KAAK;YACvB,OAAO,MAAM,CACX;gBACE,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,SAAS;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE;oBACpC,KAAK,EAAE,CAAC,CAAC,EAAE;iBACZ,CAAC,CAAC;aACJ,EACD,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/prompt/prompter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The interactive-selection seam. No command or core module imports
+ * @inquirer/prompts directly — they depend on this interface, so a fake
+ * prompter can prove deterministic facts (which choices were offered, in
+ * what order, with what descriptions) without a real terminal.
+ */
+export interface ProfileChoice {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface Prompter {
+    /**
+     * Presents `choices` and returns the selected id. Implementations MUST
+     * render entirely to stderr — never stdout, so no invocation mode can let
+     * prompt text corrupt a --json payload.
+     */
+    selectProfile(input: {
+        message: string;
+        choices: readonly ProfileChoice[];
+        defaultId: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=prompter.d.ts.map