@isaacriehm/cairn-core 0.2.0 → 0.3.0

package/dist/decision-capture/writer.js

@@ -1,267 +0,0 @@
-/**
- * Draft writer + confirm-side persistence.
- *
- * `writeDecisionDraft` materializes the extractor output into
- * `.cairn/ground/decisions/_inbox/<DEC-id>.draft.md`. Frontmatter
- * conforms to `DecisionFrontmatter` (status: "draft").
- *
- * `acceptDraft` moves the draft to its canonical path with status flipped
- * to "accepted" and triggers a ledger regenerate.
- *
- * `rejectDraft` removes the draft file entirely. The id remains burned —
- * `allocateDecisionId` always returns mark+1, so a rejected DEC-NNNN never
- * gets reissued (per monotonic-id principle, single source in decision-capture/id.ts).
- */
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
-import { decisionsDir, decisionsLedgerPath } from "../ground/paths.js";
-import { writeDecisionsLedger } from "../ground/ledgers.js";
-import { parseFrontmatter } from "../ground/frontmatter.js";
-export function writeDecisionDraft(args) {
-    const dir = decisionsDir(args.repoRoot);
-    const inboxDir = join(dir, "_inbox");
-    mkdirSync(inboxDir, { recursive: true });
-    const draftFilename = `${args.id}.draft.md`;
-    const canonicalFilename = `${args.id}.md`;
-    const draftAbs = join(inboxDir, draftFilename);
-    const canonicalAbs = join(dir, canonicalFilename);
-    const draftRel = `.cairn/ground/decisions/_inbox/${draftFilename}`;
-    const canonicalRel = `.cairn/ground/decisions/${canonicalFilename}`;
-    const now = new Date().toISOString();
-    // candidate_assertions are PROPOSALS — schema-loose. They live under
-    // `candidate_assertions:` in the frontmatter (passthrough), NOT under
-    // `assertions:` which DecisionFrontmatter validates strictly. A future
-    // refinement step (Phase 14.x) lifts candidates into the strict
-    // `assertions:` form once parameters are filled in. Until then the
-    // ledger ignores them and Layer-D sensors don't enforce them.
-    const candidateAssertions = args.output.candidate_assertions.map((a, idx) => {
-        const id = a.id ?? `${args.id}-A${(idx + 1).toString().padStart(2, "0")}`;
-        return {
-            id,
-            kind: a.kind,
-            description: a.description,
-            ...(a.parameters !== undefined ? { parameters: a.parameters } : {}),
-        };
-    });
-    const frontmatter = {
-        id: args.id,
-        title: args.output.subject,
-        type: "adr",
-        status: "draft",
-        audience: "dual",
-        generated: now,
-        "verified-at": now,
-        decided_at: args.receivedAt,
-        decided_by: args.authorId,
-        ...(args.output.scope_globs.length > 0 ? { scope_globs: args.output.scope_globs } : {}),
-        ...(args.output.supersedes ? { supersedes: args.output.supersedes } : {}),
-        ...(candidateAssertions.length > 0
-            ? { candidate_assertions: candidateAssertions }
-            : {}),
-        capture_source: args.source,
-        capture_confidence: args.output.confidence_signal,
-    };
-    const yaml = stringifyYaml(frontmatter);
-    const body = composeDraftBody(args);
-    const fileContent = `---\n${yaml}---\n\n${body}\n`;
-    writeFileSync(draftAbs, fileContent, "utf8");
-    return {
-        id: args.id,
-        draft_path: draftRel,
-        canonical_path: canonicalRel,
-        output: args.output,
-        raw_text: args.rawText,
-    };
-}
-function composeDraftBody(args) {
-    const lines = [];
-    lines.push(`# ${args.id} — ${args.output.subject}`);
-    lines.push("");
-    lines.push("## Summary");
-    lines.push(args.output.summary.trim());
-    lines.push("");
-    lines.push("## Original direction");
-    lines.push("```");
-    lines.push(args.rawText.trim());
-    lines.push("```");
-    lines.push("");
-    if (args.output.scope_globs.length > 0) {
-        lines.push("## Scope");
-        for (const g of args.output.scope_globs)
-            lines.push(`- \`${g}\``);
-        lines.push("");
-    }
-    if (args.output.candidate_assertions.length > 0) {
-        lines.push("## Candidate assertions");
-        for (const a of args.output.candidate_assertions) {
-            lines.push(`- **${a.kind}** — ${a.description}`);
-        }
-        lines.push("");
-    }
-    if (args.output.supersedes) {
-        lines.push(`## Supersedes`);
-        lines.push(`- ${args.output.supersedes}`);
-        lines.push("");
-    }
-    lines.push(`_Confidence: ${args.output.confidence_signal}. This is a DRAFT — pending operator confirmation via Discord._`);
-    return lines.join("\n");
-}
-/**
- * Move a draft to the canonical decisions/ dir, flip status:draft → accepted,
- * then regenerate the decisions ledger so accepted assertions become live.
- *
- * If a `supersedes` link exists, this also stamps `superseded_by` on the
- * referenced decision (when the file is present). Best-effort — a missing
- * referent doesn't block acceptance.
- */
-export function acceptDraft(args) {
-    const draftAbs = join(args.repoRoot, args.draft.draft_path);
-    const canonicalAbs = join(args.repoRoot, args.draft.canonical_path);
-    const original = readFileSync(draftAbs, "utf8");
-    const flipped = original.replace(/^status:\s*draft\s*$/m, "status: accepted");
-    mkdirSync(dirname(canonicalAbs), { recursive: true });
-    writeFileSync(canonicalAbs, flipped, "utf8");
-    rmSync(draftAbs, { force: true });
-    if (args.draft.output.supersedes) {
-        stampSupersededBy({
-            repoRoot: args.repoRoot,
-            supersededId: args.draft.output.supersedes,
-            supersedingId: args.draft.id,
-        });
-    }
-    const ledger = writeDecisionsLedger({ repoRoot: args.repoRoot });
-    return {
-        acceptedPath: args.draft.canonical_path,
-        ledgerSize: ledger.entries.length,
-        ledgerPath: decisionsLedgerPath(args.repoRoot).replace(args.repoRoot + "/", ""),
-    };
-}
-/**
- * Discard a draft. The DEC-id is NOT recycled — the allocator advances
- * past every existing DEC-NNNN.* file. Per the monotonic-id rule, even
- * rejected drafts burn their id, so we leave a tombstone at
- * `_inbox/<DEC-id>.rejected.md` rather than deleting outright. The
- * tombstone has `status: rejected` and is excluded from the ledger by
- * the existing `status === "accepted"` filter.
- */
-export function rejectDraft(args) {
-    const draftAbs = join(args.repoRoot, args.draft.draft_path);
-    if (!existsSync(draftAbs))
-        return;
-    const original = readFileSync(draftAbs, "utf8");
-    const tombstone = original.replace(/^status:\s*draft\s*$/m, "status: rejected");
-    const tombstoneRel = args.draft.draft_path.replace(/\.draft\.md$/, ".rejected.md");
-    const tombstoneAbs = join(args.repoRoot, tombstoneRel);
-    writeFileSync(tombstoneAbs, tombstone, "utf8");
-    rmSync(draftAbs, { force: true });
-}
-function stampSupersededBy(args) {
-    const target = join(decisionsDir(args.repoRoot), `${args.supersededId}.md`);
-    if (!existsSync(target))
-        return;
-    const original = readFileSync(target, "utf8");
-    // Inject `superseded_by:` into the frontmatter block if not already present.
-    if (/^superseded_by:/m.test(original))
-        return;
-    const fenceEnd = original.indexOf("\n---", 3);
-    if (fenceEnd === -1)
-        return;
-    const fenceText = original.slice(0, fenceEnd);
-    const restText = original.slice(fenceEnd);
-    const updated = `${fenceText}\nsuperseded_by: ${args.supersedingId}${restText}`;
-    writeFileSync(target, updated, "utf8");
-}
-/**
- * Apply per-candidate verdicts to an accepted decision file.
- *
- * For each verdict:
- *   - status="lift"   → strict_assertion (with id/kind injected) lands in
- *                       frontmatter `assertions:`
- *   - status="demote" → a `{kind: human_review_hint, description}` assertion
- *                       lands in `assertions:` (always soft, always zod-valid)
- *   - status="skip"   → original candidate stays under `candidate_assertions:`
- *
- * Then regenerates the decisions ledger so the new strict assertions are
- * visible to Layer-D sensors on the next run.
- */
-export function liftCandidatesToAssertions(args) {
-    const decisionRel = `.cairn/ground/decisions/${args.decisionId}.md`;
-    const decisionAbs = join(args.repoRoot, decisionRel);
-    if (!existsSync(decisionAbs)) {
-        throw new Error(`liftCandidatesToAssertions: decision file missing at ${decisionRel}`);
-    }
-    const original = readFileSync(decisionAbs, "utf8");
-    const parsed = parseFrontmatter(original);
-    const fmRaw = parsed.raw.length > 0 ? parseYaml(parsed.raw) : {};
-    const existingAssertions = Array.isArray(fmRaw["assertions"])
-        ? fmRaw["assertions"].slice()
-        : [];
-    const existingCandidates = Array.isArray(fmRaw["candidate_assertions"])
-        ? fmRaw["candidate_assertions"].slice()
-        : [];
-    let liftedCount = 0;
-    let demotedCount = 0;
-    let skippedCount = 0;
-    const newAssertions = [...existingAssertions];
-    const liftedIds = new Set();
-    const demotedIds = new Set();
-    const skippedIds = new Set();
-    for (const v of args.verdicts) {
-        if (v.status === "lift" && v.strict_assertion !== undefined) {
-            newAssertions.push({
-                id: v.candidate_id,
-                kind: v.candidate_kind,
-                ...v.strict_assertion,
-            });
-            liftedIds.add(v.candidate_id);
-            liftedCount++;
-            continue;
-        }
-        if (v.status === "demote") {
-            newAssertions.push({
-                id: v.candidate_id,
-                kind: "human_review_hint",
-                description: v.candidate_description,
-            });
-            demotedIds.add(v.candidate_id);
-            demotedCount++;
-            continue;
-        }
-        skippedIds.add(v.candidate_id);
-        skippedCount++;
-    }
-    const remainingCandidates = existingCandidates.filter((c) => {
-        const id = typeof c["id"] === "string" ? c["id"] : "";
-        return !liftedIds.has(id) && !demotedIds.has(id);
-    });
-    // Build the new frontmatter object preserving every existing field, just
-    // updating assertions: + candidate_assertions: + verified-at.
-    const newFm = { ...fmRaw };
-    if (newAssertions.length > 0) {
-        newFm["assertions"] = newAssertions;
-    }
-    else {
-        delete newFm["assertions"];
-    }
-    if (remainingCandidates.length > 0) {
-        newFm["candidate_assertions"] = remainingCandidates;
-    }
-    else {
-        delete newFm["candidate_assertions"];
-    }
-    newFm["verified-at"] = new Date().toISOString();
-    const newYaml = stringifyYaml(newFm);
-    const newContent = `---\n${newYaml}---\n${parsed.body.startsWith("\n") ? "" : "\n"}${parsed.body}`;
-    writeFileSync(decisionAbs, newContent, "utf8");
-    const ledger = writeDecisionsLedger({ repoRoot: args.repoRoot });
-    return {
-        decision_id: args.decisionId,
-        decision_path: decisionRel,
-        lifted_count: liftedCount,
-        demoted_count: demotedCount,
-        skipped_count: skippedCount,
-        ledger_size: ledger.entries.length,
-    };
-}
-//# sourceMappingURL=writer.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/decision-capture/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAc,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAgB5D,MAAM,UAAU,kBAAkB,CAAC,IAA4B;IAC7D,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,aAAa,GAAG,GAAG,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5C,MAAM,iBAAiB,GAAG,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,kCAAkC,aAAa,EAAE,CAAC;IACnE,MAAM,YAAY,GAAG,2BAA2B,iBAAiB,EAAE,CAAC;IAEpE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,qEAAqE;IACrE,sEAAsE;IACtE,uEAAuE;IACvE,gEAAgE;IAChE,mEAAmE;IACnE,8DAA8D;IAC9D,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAC1E,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1E,OAAO;YACL,EAAE;YACF,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAA4B;QAC3C,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;QAC1B,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,GAAG;QACd,aAAa,EAAE,GAAG;QAClB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,QAAQ;QACzB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC;YAChC,CAAC,CAAC,EAAE,oBAAoB,EAAE,mBAAmB,EAAE;YAC/C,CAAC,CAAC,EAAE,CAAC;QACP,cAAc,EAAE,IAAI,CAAC,MAAM;QAC3B,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;KAClD,CAAC;IAEF,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,QAAQ,IAAI,UAAU,IAAI,IAAI,CAAC;IACnD,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAE7C,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,UAAU,EAAE,QAAQ;QACpB,cAAc,EAAE,YAAY;QAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA4B;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,IAAI,CACR,gBAAgB,IAAI,CAAC,MAAM,CAAC,iBAAiB,iEAAiE,CAC/G,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAG3B;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAEpE,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;IAC9E,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAElC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACjC,iBAAiB,CAAC;YAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU;YAC1C,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc;QACvC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QACjC,UAAU,EAAE,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,EAAE,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAG3B;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAClC,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAChD,cAAc,EACd,cAAc,CACf,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvD,aAAa,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,iBAAiB,CAAC,IAI1B;IACC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,YAAY,KAAK,CAAC,CAAC;IAC5E,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO;IAChC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,6EAA6E;IAC7E,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO;IAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO;IAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,SAAS,oBAAoB,IAAI,CAAC,aAAa,GAAG,QAAQ,EAAE,CAAC;IAChF,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAqCD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAI1C;IACC,MAAM,WAAW,GAAG,2BAA2B,IAAI,CAAC,UAAU,KAAK,CAAC;IACpE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,wDAAwD,WAAW,EAAE,CACtE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,KAAK,GACT,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;IAElF,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC3D,CAAC,CAAE,KAAK,CAAC,YAAY,CAAoC,CAAC,KAAK,EAAE;QACjE,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACrE,CAAC,CAAE,KAAK,CAAC,sBAAsB,CAAoC,CAAC,KAAK,EAAE;QAC3E,CAAC,CAAC,EAAE,CAAC;IAEP,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,aAAa,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAC5D,aAAa,CAAC,IAAI,CAAC;gBACjB,EAAE,EAAE,CAAC,CAAC,YAAY;gBAClB,IAAI,EAAE,CAAC,CAAC,cAAc;gBACtB,GAAG,CAAC,CAAC,gBAAgB;aACtB,CAAC,CAAC;YACH,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YAC9B,WAAW,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC;gBACjB,EAAE,EAAE,CAAC,CAAC,YAAY;gBAClB,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,CAAC,CAAC,qBAAqB;aACrC,CAAC,CAAC;YACH,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YAC/B,YAAY,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC/B,YAAY,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1D,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,CAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,8DAA8D;IAC9D,MAAM,KAAK,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IACpD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,YAAY,CAAC,GAAG,aAAa,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,sBAAsB,CAAC,GAAG,mBAAmB,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,OAAO,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEhD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,QAAQ,OAAO,QAAQ,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACnG,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEjE,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,aAAa,EAAE,WAAW;QAC1B,YAAY,EAAE,WAAW;QACzB,aAAa,EAAE,YAAY;QAC3B,aAAa,EAAE,YAAY;QAC3B,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;KACnC,CAAC;AACJ,CAAC"}

package/dist/frontend-types.d.ts

@@ -1,243 +0,0 @@
-/**
- * Frontend adapter contract per `docs/WORKFLOW_GUIDE.md` §0.1.
- *
- * Cairn's MCP server + ground layer are frontend-agnostic. The operator
- * console is a swappable adapter that consumes a uniform task/run/UAT
- * bundle and renders/listens via its native primitive.
- *
- * Adapters live in `cairn/src/frontend/<name>/`. Each implements
- * `FrontendAdapter`. The `cairn run --frontend <name>` CLI loads + starts
- * registered adapters; on operator events, adapters drop normalized JSON rows
- * to `.cairn/inbox/<ts>-<source>-<slug>.json`. The orchestrator (Phase 8)
- * picks them up. Phase 5 lands ingress-only — no orchestrator yet.
- */
-export type NotifyLevel = "info" | "warn" | "error";
-/**
- * A normalized inbox entry kind. Adapters drop one of these to
- * `.cairn/inbox/`. The orchestrator multiplexes on `kind`.
- */
-export type InboxKind = "task" | "slash" | "free_text" | "voice" | "interaction";
-export interface FrontendTask {
-    source: string;
-    intent: string;
-    rawText: string;
-    authorId: string;
-    channelId?: string;
-    guildId?: string;
-    messageId?: string;
-    receivedAt: string;
-}
-export interface VoiceMessage {
-    source: string;
-    attachmentUrl: string;
-    mime?: string;
-    authorId: string;
-    channelId: string;
-    guildId?: string;
-    messageId: string;
-    receivedAt: string;
-}
-export interface SlashEvent {
-    source: string;
-    command: string;
-    options: Record<string, string | number | boolean>;
-    authorId: string;
-    channelId?: string;
-    guildId?: string;
-    messageId?: string;
-    receivedAt: string;
-}
-export interface FreeTextEvent {
-    source: string;
-    intent: string;
-    rawText: string;
-    authorId: string;
-    channelId?: string;
-    guildId?: string;
-    messageId?: string;
-    receivedAt: string;
-}
-export interface InteractionEvent {
-    source: string;
-    bundleId: string;
-    choiceId: string;
-    freeText?: string;
-    authorId: string;
-    channelId?: string;
-    guildId?: string;
-    messageId?: string;
-    receivedAt: string;
-}
-export interface DialogChoice {
-    /** Stable id ("a" | "b" | ... | "e_other"). */
-    id: string;
-    label: string;
-}
-export interface DialogSpec {
-    /** Origin run / task id used to correlate adapter responses. */
-    bundleId: string;
-    prompt: string;
-    /**
-     * 2-5 choices. Last MUST be `E) Other` per WORKFLOW_GUIDE §1.4.
-     * If more than 4 orthogonal questions arise, caller MUST collapse to a
-     * single tightened-spec proposal per §1.0 (cap = 2 questions/turn).
-     */
-    choices: DialogChoice[];
-    channelId?: string;
-    timeoutMs?: number;
-    /**
-     * When true, the adapter notifies authorized operators (push, mention,
-     * etc. — adapter-defined) so they see the run is paused. Used for
-     * agent-initiated `cairn_ask_operator`; routine confirmations leave
-     * this false to avoid noise.
-     */
-    pingOperators?: boolean;
-    /**
-     * §3.4 win 1 — multi-step walks (per-question tightener resolution,
-     * /oops branches) edit one message in place instead of posting N+1
-     * messages. Set this to the previous step's `bundleId`; the adapter
-     * looks it up in its dialog-message map and edits that message
-     * (same channel, new prompt + buttons). When the bundleId is
-     * unknown (gone, never registered) the adapter falls back to a
-     * fresh send.
-     */
-    replaceBundleId?: string;
-    /**
-     * Terminal-dialog flag. When true (default), the adapter compacts
-     * the message on click — strips buttons, appends an "Answered" line
-     * — so the channel scrollback shows what was chosen. Walk steps
-     * that intend to be replaced by a follow-on dialog (per-Q tightener)
-     * MUST pass false: otherwise the compaction race-edits the message
-     * the next step is about to overwrite, and either the answer
-     * annotation or the next prompt loses depending on REST ordering.
-     * Adapter still fires `deferUpdate` so the click acknowledges.
-     */
-    compactOnAnswer?: boolean;
-}
-export interface DialogResponse {
-    bundleId: string;
-    choiceId: string;
-    /** Populated only when `choiceId` is the `E) Other` option. */
-    freeText?: string;
-    timedOut?: boolean;
-}
-export interface ApprovalArtifact {
-    kind: "gif" | "screenshot" | "table" | "diff" | "log" | "url" | "text";
-    label?: string;
-    path?: string;
-    url?: string;
-    content?: string;
-}
-export interface ApprovalBundle {
-    bundleId: string;
-    runId: string;
-    taskId?: string;
-    goal: string;
-    diffSummary?: string;
-    acceptance?: {
-        id: string;
-        status: "pass" | "fail" | "pending";
-        note?: string;
-    }[];
-    artifacts?: ApprovalArtifact[];
-    channelId?: string;
-    timeoutMs?: number;
-}
-export interface Approval {
-    bundleId: string;
-    decision: "approve" | "reject" | "ask";
-    reason?: string;
-    timedOut?: boolean;
-}
-export interface PostUpdate {
-    taskId: string;
-    runId?: string;
-    status: string;
-    /**
-     * Free-form body. ≤1024 chars renders as inline embed `details` field
-     * (§3.3 win 3 — drops the live-status + content-message split). >1024
-     * chars falls back to the chunked secondary-embed path.
-     */
-    body?: string;
-    /**
-     * Original task spec (the operator's verbatim ask). Replaces the
-     * standalone `🆕 Task` drop card — the body lives on the same live
-     * status embed as everything else, so the channel only ever shows
-     * one self-updating message per task. Truncated at 1024 chars.
-     */
-    taskBody?: string;
-    channelId?: string;
-    /**
-     * Tier-0 (Haiku) summary of what the agent is doing right now —
-     * one-line, present-progressive ("Reading core/src/X", "Editing
-     * platform/Y"). Surfaces inside the live status embed so the
-     * operator sees ongoing activity instead of a static "running" badge.
-     * Set on a throttled cadence by the orchestrator during the
-     * implementer phase.
-     */
-    activity?: string;
-    /**
-     * Second-source visibility — extracted from claude stream-json events.
-     * Independent of the Tier-0 summary; renders even when the Tier-0 call
-     * fails. Each list capped + deduped at the source.
-     */
-    tools?: {
-        files?: string[];
-        bash?: string[];
-        searches?: string[];
-    };
-    /**
-     * Curated narrative tail from `.cairn/runs/active/<run_id>/log.jsonl`
-     * (§3.3 win 1) — last N transitions, pre-formatted. Renders inside the
-     * live status embed's description so operator sees actual progress
-     * instead of a static "phase: running" line.
-     */
-    recentEvents?: string[];
-    /**
-     * §3.4 win 3 — when status === "failed", the orchestrator classifies
-     * which gate eject the run so the embed renders class-colored title +
-     * emoji. Operator can route differently per class.
-     */
-    failureClass?: "sensor" | "reviewer" | "uat" | "hard" | "halt";
-    /**
-     * §3.4 win 2 — failure remediation guidance surfaced as a dedicated
-     * embed field. `reason` is a one-liner; `suggestedActions` are the
-     * operator's next moves (`/ship-anyway`, re-submit, open thread).
-     */
-    remediation?: {
-        reason: string;
-        suggestedActions: string[];
-    };
-}
-export type IngestHandler<T> = (item: T) => void | Promise<void>;
-export interface FrontendAdapter {
-    readonly name: string;
-    /** Connects, registers commands, prepares to ingest events. */
-    start(): Promise<void>;
-    /** Disconnects + cleans up. Idempotent. */
-    stop(): Promise<void>;
-    onTask(handler: IngestHandler<FrontendTask>): void;
-    onVoice(handler: IngestHandler<VoiceMessage>): void;
-    onSlash(handler: IngestHandler<SlashEvent>): void;
-    onFreeText(handler: IngestHandler<FreeTextEvent>): void;
-    onInteraction(handler: IngestHandler<InteractionEvent>): void;
-    postTaskUpdate(update: PostUpdate): Promise<void>;
-    requestApproval(bundle: ApprovalBundle): Promise<Approval>;
-    requestDialog(spec: DialogSpec): Promise<DialogResponse>;
-    notify(level: NotifyLevel, message: string): Promise<void>;
-    /**
-     * Show a "typing" / activity indicator on the given channel until the
-     * returned stop fn is called. Adapters without a native typing
-     * indicator should no-op.
-     */
-    startTyping?(channelId: string): () => void;
-    /**
-     * Pre-flight check: is this channel still reachable + writable?
-     * Adapters that maintain channels MUST return false when the channel
-     * has been deleted or the adapter lacks access. The orchestrator uses
-     * this to skip dispatching a queued task whose channel is gone.
-     * Adapters without channels should leave this undefined; the
-     * orchestrator treats undefined as "always alive".
-     */
-    isChannelAlive?(channelId: string): Promise<boolean>;
-}

package/dist/frontend-types.js

@@ -1,15 +0,0 @@
-/**
- * Frontend adapter contract per `docs/WORKFLOW_GUIDE.md` §0.1.
- *
- * Cairn's MCP server + ground layer are frontend-agnostic. The operator
- * console is a swappable adapter that consumes a uniform task/run/UAT
- * bundle and renders/listens via its native primitive.
- *
- * Adapters live in `cairn/src/frontend/<name>/`. Each implements
- * `FrontendAdapter`. The `cairn run --frontend <name>` CLI loads + starts
- * registered adapters; on operator events, adapters drop normalized JSON rows
- * to `.cairn/inbox/<ts>-<source>-<slug>.json`. The orchestrator (Phase 8)
- * picks them up. Phase 5 lands ingress-only — no orchestrator yet.
- */
-export {};
-//# sourceMappingURL=frontend-types.js.map

package/dist/frontend-types.js.map

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

package/dist/hooks/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * Claude Code hooks — runner functions + bin entrypoints.
- *
- * Bin entrypoints live at `dist/hooks/<event>.js` (one per event) so
- * the plugin manifest can invoke them via
- * `node ${CLAUDE_PLUGIN_ROOT}/../cairn-core/dist/hooks/<event>.js`
- * without depending on the `cairn` umbrella CLI being on PATH.
- *
- * The umbrella CLI's `cairn hook <event>` calls the same runners.
- */
-export * from "./runners/index.js";
-export * from "./post-tool-use/index.js";
-export { clearDeferState, deferStatePath, isDeferActive, readDeferState, writeDeferState, } from "./defer.js";
-export type { DeferKind, DeferState } from "./defer.js";

package/dist/hooks/index.js

@@ -1,14 +0,0 @@
-/**
- * Claude Code hooks — runner functions + bin entrypoints.
- *
- * Bin entrypoints live at `dist/hooks/<event>.js` (one per event) so
- * the plugin manifest can invoke them via
- * `node ${CLAUDE_PLUGIN_ROOT}/../cairn-core/dist/hooks/<event>.js`
- * without depending on the `cairn` umbrella CLI being on PATH.
- *
- * The umbrella CLI's `cairn hook <event>` calls the same runners.
- */
-export * from "./runners/index.js";
-export * from "./post-tool-use/index.js";
-export { clearDeferState, deferStatePath, isDeferActive, readDeferState, writeDeferState, } from "./defer.js";
-//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/inbox.d.ts

@@ -1,17 +0,0 @@
-import type { InboxKind } from "./frontend-types.js";
-/**
- * Append a normalized event row to `.cairn/inbox/`.
- *
- * The orchestrator (Phase 8) tails this directory and acts on each row.
- * Phase 5 just lands rows — no orchestrator yet. Inbox is a write-allowed
- * path per `cairn/src/mcp/path-allowlist.ts` (`APPEND_ALLOWLIST`).
- *
- * Filename pattern: `<ts>-<source>-<kind>-<slug>.json`. Sortable, scannable,
- * collision-resistant under concurrent writers.
- */
-export declare function writeInboxRow(args: {
-    repoRoot: string;
-    source: string;
-    kind: InboxKind;
-    payload: object;
-}): Promise<string>;

package/dist/inbox.js

@@ -1,30 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { randomBytes } from "node:crypto";
-import { join } from "node:path";
-/**
- * Append a normalized event row to `.cairn/inbox/`.
- *
- * The orchestrator (Phase 8) tails this directory and acts on each row.
- * Phase 5 just lands rows — no orchestrator yet. Inbox is a write-allowed
- * path per `cairn/src/mcp/path-allowlist.ts` (`APPEND_ALLOWLIST`).
- *
- * Filename pattern: `<ts>-<source>-<kind>-<slug>.json`. Sortable, scannable,
- * collision-resistant under concurrent writers.
- */
-export async function writeInboxRow(args) {
-    const { repoRoot, source, kind, payload } = args;
-    const dir = join(repoRoot, ".cairn", "inbox");
-    await mkdir(dir, { recursive: true });
-    const ts = Date.now();
-    const slug = randomBytes(4).toString("hex");
-    const file = join(dir, `${ts}-${source}-${kind}-${slug}.json`);
-    const row = {
-        kind,
-        source,
-        received_at: new Date().toISOString(),
-        ...payload,
-    };
-    await writeFile(file, `${JSON.stringify(row, null, 2)}\n`, "utf8");
-    return file;
-}
-//# sourceMappingURL=inbox.js.map

package/dist/inbox.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAKnC;IACC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG;QACV,IAAI;QACJ,MAAM;QACN,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,GAAG,OAAO;KACX,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/mcp/tools/append-run-note.d.ts

@@ -1,18 +0,0 @@
-/**
- * `cairn_append_run_note` — append a phase-tagged note to a task's notes.md.
- *
- * The handoff builder (CONTEXT_CONTINUITY_SPEC §2.2) reads notes.md when it
- * resumes an in-flight run, so notes survive context compaction by virtue of
- * being committed to disk. The MCP write surface is append-only and gated
- * by the path allowlist — see `mcp/path-allowlist.ts`.
- *
- * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.3.
- */
-import type { ToolDef } from "./types.js";
-interface Input {
-    run_id: string;
-    phase: string;
-    note: string;
-}
-export declare const appendRunNoteTool: ToolDef<Input>;
-export {};