ctxr-cli 0.1.0

package/dist/core/conventions.js

@@ -0,0 +1,73 @@
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { parseNoteText } from './notes/parse.js';
+const HEADING_RE = /^#\s+(.+)$/m;
+/** The skill-layout filename: `<slug>/SKILL.md` — what harnesses with skill auto-discovery read. */
+export const SKILL_FILE_NAME = 'SKILL.md';
+export function extractDocMetadata(raw, relativePath) {
+    let frontmatter;
+    let body = raw;
+    try {
+        const parsed = parseNoteText(raw, relativePath);
+        frontmatter = parsed.frontmatter;
+        body = parsed.body;
+    }
+    catch {
+        // Malformed frontmatter in a doc file falls back to heading/filename — these
+        // are instructions, not notes; indexing must not fail loud on them.
+    }
+    const fmTitle = frontmatter?.title ?? frontmatter?.name; // SKILL.md files declare `name`
+    const fmDescription = frontmatter?.description;
+    const heading = HEADING_RE.exec(body)?.[1]?.trim();
+    // A `<slug>/SKILL.md` file's natural fallback name is its directory, not "SKILL".
+    const fallback = path.basename(relativePath) === SKILL_FILE_NAME ? path.basename(path.dirname(relativePath)) : path.basename(relativePath, '.md');
+    return {
+        path: relativePath,
+        title: (typeof fmTitle === 'string' && fmTitle.length > 0 ? fmTitle : undefined) ??
+            (heading && heading.length > 0 ? heading : undefined) ??
+            fallback,
+        description: typeof fmDescription === 'string' && fmDescription.length > 0 ? fmDescription : null,
+    };
+}
+export async function scanDocsDir(root, dirRelativePath) {
+    const dir = path.join(root, dirRelativePath);
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+    // Two layouts, both indexed: flat `<name>.md` files, and the skill layout
+    // `<slug>/SKILL.md` (the format harnesses with skill auto-discovery read).
+    const docs = [];
+    for (const entry of [...entries].sort((a, b) => a.name.localeCompare(b.name))) {
+        let fileRelativePath;
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+            fileRelativePath = path.join(dirRelativePath, entry.name);
+        }
+        else if (entry.isDirectory()) {
+            const candidate = path.join(dir, entry.name, SKILL_FILE_NAME);
+            try {
+                await readFile(candidate, 'utf8');
+                fileRelativePath = path.join(dirRelativePath, entry.name, SKILL_FILE_NAME);
+            }
+            catch {
+                continue;
+            }
+        }
+        if (!fileRelativePath)
+            continue;
+        const relativePath = fileRelativePath.split(path.sep).join('/');
+        const raw = await readFile(path.join(root, relativePath), 'utf8');
+        docs.push(extractDocMetadata(raw, relativePath));
+    }
+    return docs;
+}
+/** Every operator convention doc currently at the configured path. */
+export function scanConventions(root, config) {
+    return scanDocsDir(root, config.harness.conventions_path);
+}
+//# sourceMappingURL=conventions.js.map

package/dist/core/conventions.js.map

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

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

@@ -0,0 +1,18 @@
+import type { StoreConfig } from '../../config/schema.js';
+import type { Note } from '../notes/list.js';
+export type DisclosureVerdict = 'allow' | 'deny' | 'ask';
+export type DisclosureRung = 'hard_wall' | 'explicit_tag' | 'internal_visibility' | 'external_default';
+export interface DisclosureResult {
+    verdict: DisclosureVerdict;
+    rung: DisclosureRung;
+}
+/**
+ * disclosure-policy spec: ordered walls-before-allows evaluation, stopping
+ * at the first rung that produces a verdict. Rung 3 (internal-audience-
+ * from-visibility) only applies when the requested audience is one the
+ * operator has declared internal — for any other (external) audience, rung
+ * 3 is skipped entirely and evaluation falls straight to rung 4's ASK, so an
+ * external verdict is never derived from visibility alone.
+ */
+export declare function evaluateDisclosure(config: StoreConfig, note: Note, audience: string): DisclosureResult;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/core/disclosure/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;AAEvG,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,cAAc,CAAC;CACtB;AAoBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAkBtG"}

package/dist/core/disclosure/model.js

@@ -0,0 +1,45 @@
+import { canSee, resolveVisibility } from '../notes/visibility.js';
+/**
+ * The frontmatter key a note uses to explicitly declare which audiences may
+ * see it disclosed (rung 2). Unlike the visibility field (context-store
+ * spec), nothing asks this key to be configurable, so it lives here as the
+ * one literal — same discipline as every other single-purpose constant in
+ * this codebase, just without a dedicated defaults.ts entry since no other
+ * module needs to reference it.
+ */
+const AUDIENCE_FIELD_KEY = 'audience';
+function matchesWall(wall, note, audience) {
+    if (wall.audience !== '*' && wall.audience !== audience)
+        return false;
+    if (wall.except?.includes(audience))
+        return false;
+    if (!wall.note_path_prefix)
+        return true;
+    const prefix = wall.note_path_prefix.endsWith('/') ? wall.note_path_prefix : `${wall.note_path_prefix}/`;
+    return note.path === wall.note_path_prefix || note.path.startsWith(prefix);
+}
+/**
+ * disclosure-policy spec: ordered walls-before-allows evaluation, stopping
+ * at the first rung that produces a verdict. Rung 3 (internal-audience-
+ * from-visibility) only applies when the requested audience is one the
+ * operator has declared internal — for any other (external) audience, rung
+ * 3 is skipped entirely and evaluation falls straight to rung 4's ASK, so an
+ * external verdict is never derived from visibility alone.
+ */
+export function evaluateDisclosure(config, note, audience) {
+    for (const wall of config.disclosure.hard_walls) {
+        if (matchesWall(wall, note, audience)) {
+            return { verdict: wall.verdict, rung: 'hard_wall' };
+        }
+    }
+    const tags = note.frontmatter?.[AUDIENCE_FIELD_KEY];
+    if (Array.isArray(tags) && tags.includes(audience)) {
+        return { verdict: 'allow', rung: 'explicit_tag' };
+    }
+    if (config.disclosure.internal_audiences.includes(audience)) {
+        const resolved = resolveVisibility(config, note);
+        return { verdict: canSee(config, audience, resolved.value) ? 'allow' : 'deny', rung: 'internal_visibility' };
+    }
+    return { verdict: 'ask', rung: 'external_default' };
+}
+//# sourceMappingURL=model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/core/disclosure/model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAWnE;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAEtC,SAAS,WAAW,CAAC,IAAoB,EAAE,IAAU,EAAE,QAAgB;IACrE,IAAI,IAAI,CAAC,QAAQ,KAAK,GAAG,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC;IACzG,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB,EAAE,IAAU,EAAE,QAAgB;IAClF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAChD,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,kBAAkB,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC/G,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AACtD,CAAC"}

package/dist/core/env.d.ts

@@ -0,0 +1,40 @@
+import type { Prompter } from '../prompt/prompter.js';
+import type { GitRunner } from './git/exec.js';
+/**
+ * The injected environment every command runs against. `run(argv, env)` is
+ * the one testable seam in the whole CLI: tests build a fake RunEnv (piped
+ * streams, a spy Prompter, a fake GitRunner) and get real command behavior
+ * with no process-global mutation and no real subprocess needed for unit
+ * tests. Only src/bin.ts constructs `realEnv()`.
+ */
+export interface Io {
+    stdin: NodeJS.ReadableStream & {
+        isTTY?: boolean;
+    };
+    stdout: NodeJS.WritableStream & {
+        isTTY?: boolean;
+    };
+    stderr: NodeJS.WritableStream & {
+        isTTY?: boolean;
+    };
+}
+export interface RunEnv {
+    cwd: string;
+    env: Readonly<Record<string, string | undefined>>;
+    io: Io;
+    /** Set by program.ts before a command runs: the --no-input flag, or implied by --json. */
+    noInput: boolean;
+    prompter: Prompter;
+    git: GitRunner;
+    now(): Date;
+}
+/**
+ * interactive ⇔ stdin.isTTY && stdout.isTTY && !noInput.
+ *
+ * Deliberately no `CI` env-var sniffing: inferring intent from an env var is
+ * exactly the guessed fallback the fail-loud contract forbids. `--json`
+ * setting `noInput` is enforced by program.ts, not here.
+ */
+export declare function isInteractive(env: RunEnv): boolean;
+export declare function realEnv(): RunEnv;
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;;;;GAMG;AACH,MAAM,WAAW,EAAE;IACjB,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACrD;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAClD,EAAE,EAAE,EAAE,CAAC;IACP,0FAA0F;IAC1F,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,SAAS,CAAC;IACf,GAAG,IAAI,IAAI,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,OAAO,IAAI,MAAM,CAUhC"}

package/dist/core/env.js

@@ -0,0 +1,24 @@
+import { createExecFileGitRunner } from './git/exec.js';
+import { createInquirerPrompter } from '../prompt/inquirer-prompter.js';
+/**
+ * interactive ⇔ stdin.isTTY && stdout.isTTY && !noInput.
+ *
+ * Deliberately no `CI` env-var sniffing: inferring intent from an env var is
+ * exactly the guessed fallback the fail-loud contract forbids. `--json`
+ * setting `noInput` is enforced by program.ts, not here.
+ */
+export function isInteractive(env) {
+    return Boolean(env.io.stdin.isTTY) && Boolean(env.io.stdout.isTTY) && !env.noInput;
+}
+export function realEnv() {
+    return {
+        cwd: process.cwd(),
+        env: process.env,
+        io: { stdin: process.stdin, stdout: process.stdout, stderr: process.stderr },
+        noInput: false,
+        prompter: createInquirerPrompter(),
+        git: createExecFileGitRunner(),
+        now: () => new Date(),
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/core/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AA0BxE;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;QAC5E,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,sBAAsB,EAAE;QAClC,GAAG,EAAE,uBAAuB,EAAE;QAC9B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/core/envelope.d.ts

@@ -0,0 +1,46 @@
+import { ExitCode } from './exit-codes.js';
+/**
+ * The `--json` output envelope every contexture command shares (cli-contract
+ * spec). Snake_case throughout, matching contexture.yaml's own `schema_version`
+ * — an agent parsing --json output shouldn't have to remember that config is
+ * snake_case but output is camelCase.
+ *
+ * `envelope_version` is the stability lever: additive-only within version 1;
+ * a breaking reshape bumps it, and both shapes ship for one minor release.
+ */
+export type Status = 'ok' | 'failed' | 'error';
+export interface Finding {
+    /** Stable, machine-readable id, e.g. "root.not_found", "config.schema_version.newer". */
+    code: string;
+    severity: 'error' | 'warning' | 'info';
+    /** One human sentence. */
+    message: string;
+    /** The thing the finding is about: a path, a config key, a check id. */
+    subject?: string;
+    details?: Record<string, unknown>;
+}
+export interface Envelope<TData = unknown> {
+    envelope_version: 1;
+    cli_version: string;
+    /** Dot-joined command path, e.g. "init", "doctor", later "note.resolve". */
+    command: string;
+    status: Status;
+    exit_code: number;
+    store: {
+        root: string | null;
+        schema_version: number | null;
+    };
+    findings: Finding[];
+    data: TData | null;
+}
+export interface BuildEnvelopeInput<TData> {
+    cliVersion: string;
+    command: string;
+    storeRoot: string | null;
+    schemaVersion: number | null;
+    findings: Finding[];
+    data: TData | null;
+    exitCode: ExitCode;
+}
+export declare function buildEnvelope<TData>(input: BuildEnvelopeInput<TData>): Envelope<TData>;
+//# sourceMappingURL=envelope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/core/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,OAAO;IACtB,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,QAAQ,CAAC,KAAK,GAAG,OAAO;IACvC,gBAAgB,EAAE,CAAC,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAQD,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAWtF"}

package/dist/core/envelope.js

@@ -0,0 +1,21 @@
+import { ExitCode } from './exit-codes.js';
+function statusForExitCode(exitCode) {
+    if (exitCode === ExitCode.Ok)
+        return 'ok';
+    if (exitCode === ExitCode.Internal || exitCode === ExitCode.Usage)
+        return 'error';
+    return 'failed';
+}
+export function buildEnvelope(input) {
+    return {
+        envelope_version: 1,
+        cli_version: input.cliVersion,
+        command: input.command,
+        status: statusForExitCode(input.exitCode),
+        exit_code: input.exitCode,
+        store: { root: input.storeRoot, schema_version: input.schemaVersion },
+        findings: input.findings,
+        data: input.data,
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/core/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/core/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AA8C3C,SAAS,iBAAiB,CAAC,QAAkB;IAC3C,IAAI,QAAQ,KAAK,QAAQ,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,QAAQ,KAAK,QAAQ,CAAC,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAClF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAAQ,KAAgC;IACnE,OAAO;QACL,gBAAgB,EAAE,CAAC;QACnB,WAAW,EAAE,KAAK,CAAC,UAAU;QAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC;QACzC,SAAS,EAAE,KAAK,CAAC,QAAQ;QACzB,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,CAAC,aAAa,EAAE;QACrE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,96 @@
+import { ExitCode } from './exit-codes.js';
+import type { Finding } from './envelope.js';
+/**
+ * Base for every error contexture raises deliberately (as opposed to a bug,
+ * which throws something else and is mapped to ExitCode.Internal). Each
+ * carries the finding that explains, in the fail-loud contract's terms,
+ * exactly what could not be determined — never a guessed fallback.
+ */
+export declare class ContextureError extends Error {
+    readonly exitCode: ExitCode;
+    readonly finding: Finding;
+    constructor(exitCode: ExitCode, finding: Finding);
+}
+export declare class NoStoreRootError extends ContextureError {
+    constructor(checked: {
+        flag: boolean;
+        env: boolean;
+        cwd: string;
+    });
+}
+export declare class NotAGitRepositoryError extends ContextureError {
+    constructor(root: string);
+}
+export declare class SchemaVersionNewerError extends ContextureError {
+    constructor(storeVersion: number, supportedVersion: number);
+}
+export declare class SchemaVersionMissingError extends ContextureError {
+    constructor(configPath: string);
+}
+export declare class InvalidConfigError extends ContextureError {
+    constructor(configPath: string, issues: readonly {
+        path: string;
+        message: string;
+    }[]);
+}
+export declare class InvalidNoteFrontmatterError extends ContextureError {
+    constructor(notePath: string, detail: string);
+}
+export declare class SessionNotFoundError extends ContextureError {
+    constructor(branch: string);
+}
+export declare class SessionValidationFailedError extends ContextureError {
+    constructor(findings: Finding[]);
+}
+export declare class NoRemoteConfiguredError extends ContextureError {
+    constructor();
+}
+export declare class CatalogSectionNotFoundError extends ContextureError {
+    constructor(sectionId: string);
+}
+export declare class GraphIdentityCollisionError extends ContextureError {
+    constructor(ids: readonly string[]);
+}
+export declare class NoteNotFoundError extends ContextureError {
+    constructor(notePath: string);
+}
+export declare class AlreadyIngestedError extends ContextureError {
+    constructor(notePath: string);
+}
+export declare class NoteNotTrackedError extends ContextureError {
+    constructor(notePath: string);
+}
+export declare class ArchiveDestinationExistsError extends ContextureError {
+    constructor(destinationPath: string);
+}
+export declare class AdapterNotFoundError extends ContextureError {
+    constructor(kind: string, id: string);
+}
+export declare class AdapterVersionMismatchError extends ContextureError {
+    constructor(kind: string, id: string, declaredVersion: number, supportedVersion: number);
+}
+export declare class GraphNotBuiltError extends ContextureError {
+    constructor();
+}
+export declare class GraphNodeNotFoundError extends ContextureError {
+    constructor(nodeId: string);
+}
+export declare class MarkerMismatchError extends ContextureError {
+    constructor(filePath: string, detail: string);
+}
+export declare class GitIdentityMissingError extends ContextureError {
+    constructor();
+}
+export declare class TaxonomySelectionConflictError extends ContextureError {
+    constructor();
+}
+export declare class InvalidTaxonomyFileError extends ContextureError {
+    constructor(filePath: string, issues: readonly {
+        path: string;
+        message: string;
+    }[]);
+}
+export declare class UnknownTaxonomyProfileError extends ContextureError {
+    constructor(given: string, knownIds: readonly string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

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

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