@isaacriehm/cairn-core 0.1.0

package/dist/context/spec-delta.js

@@ -0,0 +1,237 @@
+/**
+ * Spec-delta computation — answers "what changed in ground state since the
+ * affected code was last touched?" for a task scope.
+ *
+ * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §10.
+ *
+ * Mechanical: resolve scope → find oldest last-touch SHA across paths →
+ * diff `decisions.ledger.yaml` and `invariants.ledger.yaml` between that
+ * cutoff and HEAD → stat brand/product files for newer mtimes. No LLM.
+ *
+ * Returns null when the input scope is empty, when no path has any commits,
+ * or when the resulting delta is empty (nothing to inject).
+ */
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { simpleGit } from "simple-git";
+import { parse as parseYaml } from "yaml";
+import { buildDecisionsLedger, buildInvariantsLedger, matchAnyGlob, } from "../ground/index.js";
+const TASK_PATH_CAP = 100;
+/** Brand/product paths the daemon should stat for mtime newer than cutoff. */
+const BRAND_FILES = [
+    ".cairn/ground/brand/overview.md",
+    ".cairn/ground/brand/voice.md",
+    ".cairn/ground/product/positioning.md",
+    ".cairn/ground/product/personas.yaml",
+];
+export async function buildSpecDelta(repoRoot, taskScopePaths) {
+    if (taskScopePaths.length === 0)
+        return null;
+    const paths = taskScopePaths.slice(0, TASK_PATH_CAP);
+    const git = simpleGit({ baseDir: repoRoot });
+    // Step 2: per-path last-touch hash + date. Skip paths with no history.
+    const lastTouches = [];
+    for (const p of paths) {
+        try {
+            const r = await git.log({ file: p, maxCount: 1 });
+            const first = r.all[0];
+            if (first === undefined)
+                continue;
+            lastTouches.push({ hash: first.hash, date: first.date });
+        }
+        catch {
+            continue;
+        }
+    }
+    if (lastTouches.length === 0)
+        return null;
+    // Step 3: cutoff = oldest by date.
+    let oldest = lastTouches[0];
+    if (oldest === undefined)
+        return null;
+    for (let i = 1; i < lastTouches.length; i++) {
+        const candidate = lastTouches[i];
+        if (candidate === undefined)
+            continue;
+        if (new Date(candidate.date).getTime() < new Date(oldest.date).getTime()) {
+            oldest = candidate;
+        }
+    }
+    const cutoffFullSha = oldest.hash;
+    const cutoffDate = new Date(oldest.date);
+    // Step 4: read ledgers at HEAD.
+    let headDecisions;
+    let headInvariants;
+    try {
+        headDecisions = buildDecisionsLedger({ repoRoot });
+    }
+    catch {
+        headDecisions = [];
+    }
+    try {
+        headInvariants = buildInvariantsLedger({ repoRoot });
+    }
+    catch {
+        headInvariants = [];
+    }
+    // Step 5: read ledgers at cutoff via `git show`.
+    const cutoffDecisions = await readLedgerAtSha(git, cutoffFullSha, ".cairn/ground/decisions/decisions.ledger.yaml");
+    const cutoffInvariants = await readLedgerAtSha(git, cutoffFullSha, ".cairn/ground/invariants/invariants.ledger.yaml");
+    // Build lookup map of HEAD decisions for invariant scope resolution.
+    const headDecisionById = new Map();
+    for (const d of headDecisions)
+        headDecisionById.set(d.id, d);
+    // Step 6: compute diffs.
+    const cutoffDecisionIds = new Set(cutoffDecisions.map((d) => d.id));
+    const cutoffInvariantIds = new Set(cutoffInvariants.map((i) => i.id));
+    const headDecisionIds = new Set(headDecisions.map((d) => d.id));
+    const headInvariantIds = new Set(headInvariants.map((i) => i.id));
+    // decisions.added: in HEAD but not in cutoff, scope-overlap.
+    const decisionsAdded = [];
+    for (const d of headDecisions) {
+        if (cutoffDecisionIds.has(d.id))
+            continue;
+        const scope = d.scope_globs ?? [];
+        if (scope.length === 0)
+            continue;
+        const overlaps = paths.some((p) => matchAnyGlob(p, scope));
+        if (!overlaps)
+            continue;
+        decisionsAdded.push({ id: d.id, title: d.title, scopeGlobs: scope });
+    }
+    // decisions.superseded: in cutoff (accepted+active) but missing from HEAD
+    // (HEAD ledger only contains accepted-active, so dropouts = superseded).
+    // Scope-overlap via cutoff entry's scope_globs.
+    const decisionsSuperseded = [];
+    for (const d of cutoffDecisions) {
+        if (headDecisionIds.has(d.id))
+            continue;
+        const scope = d.scope_globs ?? [];
+        if (scope.length === 0)
+            continue;
+        const overlaps = paths.some((p) => matchAnyGlob(p, scope));
+        if (!overlaps)
+            continue;
+        decisionsSuperseded.push({
+            id: d.id,
+            supersededBy: d.superseded_by ?? "",
+            title: d.title,
+        });
+    }
+    // invariants.added: in HEAD but not in cutoff. Scope via source_decision lookup.
+    const invariantsAdded = [];
+    for (const inv of headInvariants) {
+        if (cutoffInvariantIds.has(inv.id))
+            continue;
+        const sourceDecision = inv.source_decision ?? null;
+        if (sourceDecision === null)
+            continue;
+        const decision = headDecisionById.get(sourceDecision);
+        const scope = decision?.scope_globs ?? [];
+        if (scope.length === 0)
+            continue;
+        const overlaps = paths.some((p) => matchAnyGlob(p, scope));
+        if (!overlaps)
+            continue;
+        invariantsAdded.push({
+            id: inv.id,
+            title: inv.title,
+            sourceDecision,
+        });
+    }
+    // invariants.superseded: in cutoff but not in HEAD (or with superseded_by in HEAD).
+    // Scope via the cutoff inv's source_decision → look up in HEAD decisions.
+    const invariantsSuperseded = [];
+    for (const inv of cutoffInvariants) {
+        const droppedFromHead = !headInvariantIds.has(inv.id);
+        const supersededInHead = headInvariants.find((h) => h.id === inv.id)?.superseded_by !== undefined &&
+            headInvariants.find((h) => h.id === inv.id)?.superseded_by !== null;
+        if (!droppedFromHead && !supersededInHead)
+            continue;
+        const sourceDecision = inv.source_decision ?? null;
+        if (sourceDecision === null)
+            continue;
+        const decision = headDecisionById.get(sourceDecision);
+        const scope = decision?.scope_globs ?? [];
+        if (scope.length === 0)
+            continue;
+        const overlaps = paths.some((p) => matchAnyGlob(p, scope));
+        if (!overlaps)
+            continue;
+        const headEntry = headInvariants.find((h) => h.id === inv.id);
+        invariantsSuperseded.push({
+            id: inv.id,
+            supersededBy: headEntry?.superseded_by ?? "",
+            title: inv.title,
+        });
+    }
+    // Step 8: brand/product files.
+    const brand = [];
+    const cutoffMs = cutoffDate.getTime();
+    for (const rel of BRAND_FILES) {
+        const abs = join(repoRoot, rel);
+        if (!existsSync(abs))
+            continue;
+        let stat;
+        try {
+            stat = statSync(abs);
+        }
+        catch {
+            continue;
+        }
+        if (stat.mtimeMs > cutoffMs) {
+            brand.push({ path: rel, mtimeIso: stat.mtime.toISOString() });
+        }
+    }
+    // Step 9: empty delta → null.
+    const empty = decisionsAdded.length === 0 &&
+        decisionsSuperseded.length === 0 &&
+        invariantsAdded.length === 0 &&
+        invariantsSuperseded.length === 0 &&
+        brand.length === 0;
+    if (empty)
+        return null;
+    return {
+        cutoffSha: cutoffFullSha.slice(0, 7),
+        cutoffAgeDays: Math.floor((Date.now() - cutoffMs) / 86_400_000),
+        scopeSummary: summarizeScope(paths),
+        decisions: {
+            added: decisionsAdded,
+            superseded: decisionsSuperseded,
+        },
+        invariants: {
+            added: invariantsAdded,
+            superseded: invariantsSuperseded,
+        },
+        brand,
+    };
+}
+async function readLedgerAtSha(git, sha, relPath) {
+    let raw;
+    try {
+        raw = await git.show([`${sha}:${relPath}`]);
+    }
+    catch {
+        return [];
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed;
+}
+function summarizeScope(paths) {
+    if (paths.length === 1) {
+        const p = paths[0];
+        return p ?? "1 path";
+    }
+    if (paths.length <= 3)
+        return paths.join(", ");
+    return `${paths.length} paths`;
+}
+//# sourceMappingURL=spec-delta.js.map

package/dist/context/spec-delta.js.map

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

package/dist/decision-capture/capture.d.ts

@@ -0,0 +1,57 @@
+/**
+ * runDecisionCapture — orchestrates the full flow:
+ *
+ *   raw_text → extract → write draft → adapter dialog 🟢/🟡/🔴
+ *                                  ├── 🟢 commit  → acceptDraft → ledger
+ *                                  ├── 🟡 edit    → leave draft + return correction text
+ *                                  └── 🔴 reject  → rejectDraft → no record
+ *
+ * The dialog is supplied by the caller (typically a FrontendAdapter's
+ * requestDialog) so this entry point works equally well in tests with the
+ * stub adapter, in CLI with a TTY prompt, and in Discord with the real
+ * adapter.
+ */
+import type { FrontendAdapter } from "../frontend-types.js";
+import type { ClaudeTier } from "../claude/index.js";
+import { runDecisionExtractor } from "./extractor.js";
+import { proposeStrictAssertions } from "./refinement.js";
+import type { DecisionCaptureResult } from "./types.js";
+export interface RunDecisionCaptureArgs {
+    /** Repo root for the mirror checkout. */
+    repoRoot: string;
+    /** Raw operator text. */
+    rawText: string;
+    /** Operator id. */
+    authorId: string;
+    /** Source — `discord:slash:/direction` or `discord:free_text` etc. */
+    source: string;
+    /** ISO timestamp the message was received. Default = now. */
+    receivedAt?: string;
+    /** Tier for the extractor. Default = haiku. */
+    tier?: ClaudeTier;
+    /** Channel id to thread the confirm dialog through. */
+    channelId?: string;
+    /** Adapter that owns the confirm dialog. */
+    adapter: FrontendAdapter;
+    /** Confirm-dialog timeout. Default 60_000 ms. */
+    confirmTimeoutMs?: number;
+    /**
+     * Optional: override the extractor entry point. Smokes inject a stub so
+     * the smoke runs without burning claude quota when only the
+     * draft/confirm/ledger flow needs verifying.
+     */
+    extractorOverride?: typeof runDecisionExtractor;
+    /**
+     * Skip the post-commit refinement step. Defaults to false. The
+     * orchestrator's `bypassRefinement` mirrors this for production runs;
+     * smokes that don't care about refinement can flip it on.
+     */
+    bypassRefinement?: boolean;
+    /** Tier for the refinement proposer. Default = haiku. */
+    refinementTier?: ClaudeTier;
+    /** Refinement dialog timeout. Default 60_000 ms. */
+    refinementDialogTimeoutMs?: number;
+    /** Smokes inject a stub proposer to avoid burning claude quota. */
+    refinementProposerOverride?: typeof proposeStrictAssertions;
+}
+export declare function runDecisionCapture(args: RunDecisionCaptureArgs): Promise<DecisionCaptureResult>;

package/dist/decision-capture/capture.js

@@ -0,0 +1,186 @@
+/**
+ * runDecisionCapture — orchestrates the full flow:
+ *
+ *   raw_text → extract → write draft → adapter dialog 🟢/🟡/🔴
+ *                                  ├── 🟢 commit  → acceptDraft → ledger
+ *                                  ├── 🟡 edit    → leave draft + return correction text
+ *                                  └── 🔴 reject  → rejectDraft → no record
+ *
+ * The dialog is supplied by the caller (typically a FrontendAdapter's
+ * requestDialog) so this entry point works equally well in tests with the
+ * stub adapter, in CLI with a TTY prompt, and in Discord with the real
+ * adapter.
+ */
+import { logger } from "../logger.js";
+import { runDecisionExtractor } from "./extractor.js";
+import { allocateDecisionId } from "./id.js";
+import { acceptDraft, rejectDraft, writeDecisionDraft, } from "./writer.js";
+import { runDecisionRefinement, } from "./refinement.js";
+const log = logger("decision-capture");
+const CHOICE_COMMIT = "a";
+const CHOICE_EDIT = "b";
+const CHOICE_REJECT = "c";
+export async function runDecisionCapture(args) {
+    const startedAt = Date.now();
+    const tier = args.tier ?? "haiku";
+    const receivedAt = args.receivedAt ?? new Date().toISOString();
+    const extract = args.extractorOverride ?? runDecisionExtractor;
+    const extractorResult = await extract({
+        raw_text: args.rawText,
+        author_id: args.authorId,
+        received_at: receivedAt,
+        source: args.source,
+        tier,
+    });
+    if (extractorResult.output.not_a_decision) {
+        log.info({ source: args.source, author: args.authorId }, "decision-extractor flagged not_a_decision — short-circuiting");
+        return {
+            short_circuited: true,
+            duration_ms: Date.now() - startedAt,
+        };
+    }
+    const id = allocateDecisionId(args.repoRoot);
+    const draft = writeDecisionDraft({
+        repoRoot: args.repoRoot,
+        id,
+        output: extractorResult.output,
+        rawText: args.rawText,
+        authorId: args.authorId,
+        receivedAt,
+        source: args.source,
+    });
+    log.info({ id, draft_path: draft.draft_path, confidence: extractorResult.output.confidence_signal }, "draft written; awaiting confirm");
+    const decision = await promptConfirm({
+        adapter: args.adapter,
+        draft,
+        ...(args.channelId !== undefined ? { channelId: args.channelId } : {}),
+        timeoutMs: args.confirmTimeoutMs ?? 60_000,
+    });
+    if (decision.decision === "commit") {
+        const accepted = acceptDraft({ repoRoot: args.repoRoot, draft });
+        log.info({ id, accepted_path: accepted.acceptedPath, ledger_size: accepted.ledgerSize }, "draft accepted; ledger regenerated");
+        let refinement;
+        const hasCandidates = extractorResult.output.candidate_assertions.length > 0;
+        if (!args.bypassRefinement && hasCandidates) {
+            try {
+                refinement = await runDecisionRefinement({
+                    repoRoot: args.repoRoot,
+                    decisionId: id,
+                    adapter: args.adapter,
+                    ...(args.channelId !== undefined ? { channelId: args.channelId } : {}),
+                    tier: args.refinementTier ?? tier,
+                    ...(args.refinementDialogTimeoutMs !== undefined
+                        ? { dialogTimeoutMs: args.refinementDialogTimeoutMs }
+                        : {}),
+                    ...(args.refinementProposerOverride !== undefined
+                        ? { proposerOverride: args.refinementProposerOverride }
+                        : {}),
+                });
+                log.info({
+                    id,
+                    operator_choice: refinement.operator_choice,
+                    lifted: refinement.lifted_count,
+                    demoted: refinement.demoted_count,
+                    kept_candidate: refinement.skipped_count,
+                }, "refinement complete");
+            }
+            catch (err) {
+                // Refinement failure must NEVER roll back the accept. Log and move
+                // on; candidates stay loose under candidate_assertions: for the
+                // operator's next refine pass.
+                log.error({ err: String(err), id }, "refinement threw — accept stands; candidates remain loose");
+            }
+        }
+        return {
+            short_circuited: false,
+            draft,
+            confirm: {
+                decision: "commit",
+                accepted_path: accepted.acceptedPath,
+                ledger_size: accepted.ledgerSize,
+                draft,
+                confidence: extractorResult.output.confidence_signal,
+            },
+            ...(refinement !== undefined ? { refinement } : {}),
+            duration_ms: Date.now() - startedAt,
+        };
+    }
+    if (decision.decision === "edit") {
+        log.info({ id, correction: decision.correction?.slice(0, 120) }, "draft edit requested");
+        return {
+            short_circuited: false,
+            draft,
+            confirm: {
+                decision: "edit",
+                draft,
+                ...(decision.correction !== undefined ? { correction: decision.correction } : {}),
+                confidence: extractorResult.output.confidence_signal,
+            },
+            duration_ms: Date.now() - startedAt,
+        };
+    }
+    // reject
+    rejectDraft({ repoRoot: args.repoRoot, draft });
+    log.info({ id }, "draft rejected; file removed");
+    return {
+        short_circuited: false,
+        draft,
+        confirm: {
+            decision: "reject",
+            draft,
+            confidence: extractorResult.output.confidence_signal,
+        },
+        duration_ms: Date.now() - startedAt,
+    };
+}
+async function promptConfirm(args) {
+    const summary = args.draft.output.summary.split(/\r?\n/).slice(0, 3).join(" ").trim();
+    const scope = args.draft.output.scope_globs.length > 0
+        ? args.draft.output.scope_globs.join(", ")
+        : "(no scope captured)";
+    const supersedes = args.draft.output.supersedes
+        ? `Supersedes ${args.draft.output.supersedes}. `
+        : "";
+    const assertions = args.draft.output.candidate_assertions.length;
+    const prompt = [
+        `Confirm ${args.draft.id}? "${args.draft.output.subject}"`,
+        summary,
+        `Scope: ${scope}`,
+        `${supersedes}Candidate assertions: ${assertions}`,
+    ].join("\n");
+    const dialogSpec = {
+        bundleId: args.draft.id,
+        prompt,
+        choices: [
+            { id: CHOICE_COMMIT, label: "🟢 commit" },
+            { id: CHOICE_EDIT, label: "🟡 edit" },
+            { id: CHOICE_REJECT, label: "🔴 not a decision" },
+            { id: "e_other", label: "E) Other" },
+        ],
+        timeoutMs: args.timeoutMs,
+    };
+    if (args.channelId !== undefined)
+        dialogSpec.channelId = args.channelId;
+    const response = await args.adapter.requestDialog(dialogSpec);
+    if (response.timedOut) {
+        // Timeout = treat as edit-with-no-correction so the draft survives in
+        // _inbox/ and the operator can come back to it. This avoids losing the
+        // capture on a transient inattentiveness.
+        return { decision: "edit" };
+    }
+    if (response.choiceId === CHOICE_COMMIT) {
+        return { decision: "commit" };
+    }
+    if (response.choiceId === CHOICE_REJECT) {
+        return { decision: "reject" };
+    }
+    if (response.choiceId === CHOICE_EDIT || response.choiceId === "e_other") {
+        return {
+            decision: "edit",
+            ...(response.freeText !== undefined ? { correction: response.freeText } : {}),
+        };
+    }
+    // Unknown id — fall back to edit (preserve the draft).
+    return { decision: "edit" };
+}
+//# sourceMappingURL=capture.js.map

package/dist/decision-capture/capture.js.map

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

package/dist/decision-capture/extractor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Decision-extractor runner.
+ *
+ * Single Tier-1 (Haiku) call by default per workflow.md
+ * `decision_extractor: 1`. Output is gated by `--json-schema`. The wrapper
+ * validates shape via a runtime guard and returns the typed payload.
+ *
+ * The runner does NOT touch the filesystem. It returns the extractor's
+ * structured output; the writer + confirm flow handle persistence.
+ */
+import type { DecisionExtractorInput, DecisionExtractorOutput } from "./types.js";
+export interface ExtractorResult {
+    output: DecisionExtractorOutput;
+    duration_ms: number;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+}
+export declare function runDecisionExtractor(input: DecisionExtractorInput): Promise<ExtractorResult>;

package/dist/decision-capture/extractor.js

@@ -0,0 +1,103 @@
+/**
+ * Decision-extractor runner.
+ *
+ * Single Tier-1 (Haiku) call by default per workflow.md
+ * `decision_extractor: 1`. Output is gated by `--json-schema`. The wrapper
+ * validates shape via a runtime guard and returns the typed payload.
+ *
+ * The runner does NOT touch the filesystem. It returns the extractor's
+ * structured output; the writer + confirm flow handle persistence.
+ */
+import { runClaude } from "../claude/index.js";
+import { logger } from "../logger.js";
+import { DECISION_EXTRACTOR_SYSTEM_PROMPT, buildDecisionExtractorUserPrompt, } from "./prompt.js";
+import { DECISION_EXTRACTOR_OUTPUT_SCHEMA } from "./schema.js";
+const log = logger("decision-capture.extractor");
+export async function runDecisionExtractor(input) {
+    const userPrompt = buildDecisionExtractorUserPrompt(input);
+    log.info({
+        tier: input.tier,
+        raw_text_len: input.raw_text.length,
+        accepted_decisions: input.accepted_decisions?.length ?? 0,
+    }, "decision-extractor dispatch");
+    const result = await runClaude({
+        tier: input.tier,
+        prompt: userPrompt,
+        system: DECISION_EXTRACTOR_SYSTEM_PROMPT,
+        jsonSchema: DECISION_EXTRACTOR_OUTPUT_SCHEMA,
+        timeoutMs: input.timeout_ms ?? 120_000,
+    });
+    if (!isOutput(result.parsed)) {
+        throw new Error(`decision-extractor returned malformed output. preview: ${result.text.slice(0, 200)}`);
+    }
+    const output = result.parsed;
+    log.info({
+        not_a_decision: output.not_a_decision,
+        subject_preview: output.subject.slice(0, 80),
+        assertions: output.candidate_assertions.length,
+        confidence: output.confidence_signal,
+        duration_ms: result.durationMs,
+    }, "decision-extractor complete");
+    return {
+        output,
+        duration_ms: result.durationMs,
+        ...(result.usage !== undefined
+            ? {
+                usage: {
+                    ...(result.usage["input_tokens"] !== undefined
+                        ? { input_tokens: result.usage["input_tokens"] }
+                        : {}),
+                    ...(result.usage["output_tokens"] !== undefined
+                        ? { output_tokens: result.usage["output_tokens"] }
+                        : {}),
+                },
+            }
+            : {}),
+    };
+}
+function isOutput(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (typeof v["subject"] !== "string")
+        return false;
+    if (typeof v["summary"] !== "string")
+        return false;
+    if (!Array.isArray(v["scope_globs"]))
+        return false;
+    for (const g of v["scope_globs"]) {
+        if (typeof g !== "string")
+            return false;
+    }
+    const supersedes = v["supersedes"];
+    if (supersedes !== undefined &&
+        supersedes !== null &&
+        typeof supersedes !== "string") {
+        return false;
+    }
+    if (!Array.isArray(v["candidate_assertions"]))
+        return false;
+    for (const a of v["candidate_assertions"]) {
+        if (!isCandidateAssertion(a))
+            return false;
+    }
+    if (v["confidence_signal"] !== "high" &&
+        v["confidence_signal"] !== "medium" &&
+        v["confidence_signal"] !== "low") {
+        return false;
+    }
+    if (typeof v["not_a_decision"] !== "boolean")
+        return false;
+    return true;
+}
+function isCandidateAssertion(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (typeof v["kind"] !== "string")
+        return false;
+    if (typeof v["description"] !== "string")
+        return false;
+    return true;
+}
+//# sourceMappingURL=extractor.js.map

package/dist/decision-capture/extractor.js.map

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

package/dist/decision-capture/id.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Decision id allocator. DEC-NNNN, monotonic, never reused.
+ *
+ * Scans `.cairn/ground/decisions/` for accepted decisions AND
+ * `.cairn/ground/decisions/_inbox/` for outstanding drafts. Either counts
+ * toward the high-water mark — a draft that's pending operator confirmation
+ * still owns its id; rejecting a draft does NOT recycle the id.
+ *
+ * Single source of truth for DEC-id allocation. The MCP `record_decision`
+ * tool calls these helpers; do NOT re-implement the scan elsewhere.
+ */
+/**
+ * Scan both the canonical decisions dir and the `_inbox/` for
+ * DEC-NNNN-prefixed files; return the set of ids found.
+ */
+export declare function scanExistingDecisionIds(repoRoot: string): Set<string>;
+/**
+ * Return the next free `DEC-<NNNN>` id, optionally factoring in a
+ * caller-supplied set (e.g. ids the MCP tool just validated against).
+ */
+export declare function allocateDecisionId(repoRoot: string, existing?: Set<string>): string;