@isaacriehm/cairn-core 0.6.0 → 0.7.1

package/dist/mcp/tools/record-decision.d.ts

@@ -1,9 +1,10 @@
 import type { ToolDef } from "./types.js";
 interface Input {
     id?: string;
-    title: string;
-    summary: string;
-    scope_globs: string[];
+    slug?: string;
+    title?: string;
+    summary?: string;
+    scope_globs?: string[];
     supersedes?: string;
     assertions?: unknown[];
     human_review_hint?: string;

package/dist/mcp/tools/record-decision.js

@@ -3,19 +3,20 @@ import { join } from "node:path";
 import { stringify as stringifyYaml } from "yaml";
 import { computeDecisionId, scanExistingDecisionIds, } from "../../decision-capture/index.js";
 import { writeInvalidationEvent } from "../../events/index.js";
-import { bodyContentHash, decisionsDir } from "../../ground/index.js";
-import { DecisionAssertion } from "../../ground/index.js";
+import { bodyContentHash, decisionsDir, deriveDecId, readAnchorMap, readRejectedYaml, readTopicIndex, setTopic, writeFileCandidatesMap, writeTopicIndex, } from "@isaacriehm/cairn-state";
+import { DecisionAssertion } from "@isaacriehm/cairn-state";
 import { withWriteLock } from "../../lock.js";
 import { requireBootstrap } from "../bootstrap-guard.js";
 import { mcpError } from "../errors.js";
 import { recordDecisionInput } from "../schemas.js";
+import { readSotBody } from "../../init/sot-emit.js";
 async function handler(ctx, input) {
     const block = requireBootstrap(ctx.repoRoot);
     if (block !== null)
         return block;
     const dir = decisionsDir(ctx.repoRoot);
     const inboxDir = join(dir, "_inbox");
-    // Validate assertions, if provided. (Pre-lock — pure schema check.)
+    // Validate assertions, if provided.
     if (input.assertions !== undefined) {
         for (const a of input.assertions) {
             const result = DecisionAssertion.safeParse(a);
@@ -27,86 +28,160 @@ async function handler(ctx, input) {
             }
         }
     }
-    return withWriteLock(ctx.repoRoot, () => {
-        // Re-scan inside the lock so concurrent allocators see each other's writes.
+    return withWriteLock(ctx.repoRoot, async () => {
         const existingIds = scanExistingDecisionIds(ctx.repoRoot);
+        const target = input.target ?? "inbox";
+        const outDir = target === "accepted" ? dir : inboxDir;
         let id;
-        if (input.id !== undefined) {
-            if (existingIds.has(input.id)) {
-                return mcpError("DECISION_ID_TAKEN", `${input.id} already exists`);
+        let body;
+        let title;
+        let scopeGlobs = input.scope_globs ?? [];
+        let decidedBy = ctx.sessionId ? `session:${ctx.sessionId}` : "user";
+        let sotKind = "ledger";
+        let sotPath = "ledger";
+        let sourceFile;
+        if (input.slug) {
+            // AI Candidate Promotion path
+            const topicIndex = readTopicIndex(ctx.repoRoot);
+            const entry = topicIndex.topics[input.slug];
+            if (entry === undefined) {
+                return mcpError("VALIDATION_FAILED", `slug "${input.slug}" not in topic-index`);
+            }
+            if (entry.dec_id !== undefined) {
+                return {
+                    ok: true,
+                    id: entry.dec_id,
+                    target,
+                    path: relativePath(entry.dec_id, target),
+                    warning: `DEC already exists for slug ${input.slug}`,
+                };
+            }
+            const rejected = readRejectedYaml(ctx.repoRoot);
+            if (rejected.has(input.slug)) {
+                return mcpError("VALIDATION_FAILED", `slug "${input.slug}" was previously rejected`);
+            }
+            const anchorMap = readAnchorMap(ctx.repoRoot);
+            const sotBody = readSotBody(ctx.repoRoot, entry, anchorMap);
+            if (sotBody === null) {
+                return mcpError("VALIDATION_FAILED", "source body unreadable");
             }
-            id = input.id;
+            // Drift check
+            if (entry.content_hash !== undefined && bodyContentHash(sotBody) !== entry.content_hash) {
+                return mcpError("VALIDATION_FAILED", "Source file modified since index build");
+            }
+            title = input.title ?? firstLineFallback(sotBody);
+            body = sotBody;
+            sotKind = "path";
+            sotPath = entryToSotPath(entry);
+            sourceFile = entry.sot_source;
+            decidedBy = "ai-curator";
+            id = allocateUniqueDecId({ sot_path: sotPath, title, capture_source: "ai-proposed" }, existingIds);
+            // Update topic index
+            const updatedTopicIndex = setTopic(topicIndex, input.slug, {
+                ...entry,
+                dec_id: id,
+            });
+            writeTopicIndex(ctx.repoRoot, updatedTopicIndex);
+            writeFileCandidatesMap(ctx.repoRoot, updatedTopicIndex);
         }
         else {
-            // Manual user-record path has no source provenance — fold a
-            // millisecond timestamp in so two distinct decisions with
-            // identical title + summary still hash to different ids.
-            id = computeDecisionId({
-                title: input.title,
+            // Manual path
+            if (!input.title || !input.summary) {
+                return mcpError("VALIDATION_FAILED", "title and summary required for manual record");
+            }
+            title = input.title;
+            id = input.id ?? computeDecisionId({
+                title,
                 rationale: input.summary,
                 capture_source: "user-record",
-                scope_globs: input.scope_globs,
-                ...(input.body_markdown !== undefined
-                    ? { body_markdown: input.body_markdown }
-                    : {}),
+                scope_globs: scopeGlobs,
+                ...(input.body_markdown ? { body_markdown: input.body_markdown } : {}),
                 timestamp_ms: Date.now(),
             }, existingIds);
+            body = input.body_markdown ?? `# ${id} — ${title}\n\n## Summary\n\n${input.summary}\n`;
         }
         if (input.supersedes !== undefined && !existingIds.has(input.supersedes)) {
             return mcpError("SUPERSEDES_NOT_FOUND", `supersedes target "${input.supersedes}" not found`);
         }
-        const target = input.target ?? "inbox";
-        const outDir = target === "accepted" ? dir : inboxDir;
         mkdirSync(outDir, { recursive: true });
-        const body = input.body_markdown ?? `# ${id} — ${input.title}\n\n## Summary\n\n${input.summary}\n`;
         const frontmatter = {
             id,
-            title: input.title,
+            title,
             type: "adr",
             status: target === "accepted" ? "accepted" : "draft",
             audience: "dual",
             generated: new Date().toISOString(),
             "verified-at": new Date().toISOString(),
             decided_at: new Date().toISOString().slice(0, 10),
-            scope_globs: input.scope_globs,
-            sot_kind: "ledger",
-            sot_path: "ledger",
+            decided_by: decidedBy,
+            scope_globs: scopeGlobs,
+            sot_kind: sotKind,
+            sot_path: sotPath,
             sot_content_hash: bodyContentHash(body),
+            source_file: sourceFile,
             ...(input.supersedes !== undefined ? { supersedes: input.supersedes } : {}),
             ...(input.assertions !== undefined ? { assertions: input.assertions } : {}),
-            ...(input.human_review_hint !== undefined
-                ? { human_review_hint: input.human_review_hint }
-                : {}),
+            ...(input.human_review_hint !== undefined ? { human_review_hint: input.human_review_hint } : {}),
         };
         const filename = target === "accepted" ? `${id}.md` : `${id}.draft.md`;
         const path = join(outDir, filename);
         const content = `---\n${stringifyYaml(frontmatter)}---\n\n${body}`;
         writeFileSync(path, content, "utf8");
-        const relPath = target === "accepted"
-            ? `.cairn/ground/decisions/${filename}`
-            : `.cairn/ground/decisions/_inbox/${filename}`;
+        const relPath = relativePath(id, target);
         try {
             writeInvalidationEvent(ctx.repoRoot, {
                 kind: target === "accepted" ? "decision_accepted" : "decision_drafted",
                 refs: [
                     { kind: "decision", id },
-                    ...(input.supersedes !== undefined
-                        ? [{ kind: "decision", id: input.supersedes }]
-                        : []),
+                    ...(input.supersedes !== undefined ? [{ kind: "decision", id: input.supersedes }] : []),
                 ],
                 path: relPath,
                 source: { session_id: ctx.sessionId ?? null, tool: "cairn_record_decision" },
             });
         }
         catch {
-            // Event emission must never roll back the underlying write.
+            /* ignore */
         }
         return { ok: true, id, target, path: relPath };
     });
 }
+function relativePath(id, target) {
+    return target === "accepted"
+        ? `.cairn/ground/decisions/${id}.md`
+        : `.cairn/ground/decisions/_inbox/${id}.draft.md`;
+}
+function entryToSotPath(entry) {
+    const sot = entry.candidates.find((c) => c.file === entry.sot_source);
+    if (sot === undefined)
+        return entry.sot_source;
+    if (sot.anchor !== undefined && sot.anchor.length > 0) {
+        return `${entry.sot_source}#${sot.anchor}`;
+    }
+    return entry.sot_source;
+}
+function firstLineFallback(body) {
+    const first = body.split("\n").find((l) => l.trim().length > 0) ?? "";
+    return first.replace(/^#+\s*/, "").trim().slice(0, 120) || "(untitled)";
+}
+function allocateUniqueDecId(input, existingIds) {
+    const id = deriveDecId(input);
+    if (!existingIds.has(id)) {
+        existingIds.add(id);
+        return id;
+    }
+    for (let suffix = 2; suffix < 1_000; suffix += 1) {
+        const tagged = deriveDecId({ ...input, title: `${input.title} #${suffix}` });
+        if (!existingIds.has(tagged)) {
+            existingIds.add(tagged);
+            return tagged;
+        }
+    }
+    existingIds.add(id);
+    return id;
+}
 export const recordDecisionTool = {
     name: "cairn_record_decision",
-    description: "Drop a decision draft to .cairn/ground/decisions/_inbox/ (target=inbox, default) or canonical (target=accepted; operator-only override). Validates assertion schemas. Allocates the next DEC-NNNN if id omitted.",
+    description: "Record a decision in the ledger or inbox. Use `slug` to promote a candidate from the topic index, or provide `title` and `summary` for a manual entry. Use `target=accepted` (operator only) to bypass the inbox.",
     inputSchema: recordDecisionInput,
     handler,
 };

package/dist/mcp/tools/record-decision.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-decision.js","sourceRoot":"","sources":["../../../src/mcp/tools/record-decision.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"record-decision.js","sourceRoot":"","sources":["../../../src/mcp/tools/record-decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,eAAe,GAEhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAgBrD,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAErC,oCAAoC;IACpC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,QAAQ,CAAC,wBAAwB,EAAE,yBAAyB,EAAE;oBACnE,SAAS,EAAE,CAAC;oBACZ,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,WAAW,GAAG,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;QAEtD,IAAI,EAAU,CAAC;QACf,IAAI,IAAY,CAAC;QACjB,IAAI,KAAa,CAAC;QAClB,IAAI,UAAU,GAAa,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QACnD,IAAI,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACpE,IAAI,OAAO,GAAsB,QAAQ,CAAC;QAC1C,IAAI,OAAO,GAAG,QAAQ,CAAC;QACvB,IAAI,UAA8B,CAAC;QAEnC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,8BAA8B;YAC9B,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,QAAQ,CAAC,mBAAmB,EAAE,SAAS,KAAK,CAAC,IAAI,sBAAsB,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,EAAE,EAAE,KAAK,CAAC,MAAM;oBAChB,MAAM;oBACN,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;oBACxC,OAAO,EAAE,+BAA+B,KAAK,CAAC,IAAI,EAAE;iBACrD,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,OAAO,QAAQ,CAAC,mBAAmB,EAAE,SAAS,KAAK,CAAC,IAAI,2BAA2B,CAAC,CAAC;YACvF,CAAC;YAED,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YAC5D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,QAAQ,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAAC;YACjE,CAAC;YAED,cAAc;YACd,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;gBACxF,OAAO,QAAQ,CAAC,mBAAmB,EAAE,wCAAwC,CAAC,CAAC;YACjF,CAAC;YAED,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,GAAG,OAAO,CAAC;YACf,OAAO,GAAG,MAAM,CAAC;YACjB,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAChC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;YAC9B,SAAS,GAAG,YAAY,CAAC;YAEzB,EAAE,GAAG,mBAAmB,CACtB,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,EAC3D,WAAW,CACZ,CAAC;YAEF,qBAAqB;YACrB,MAAM,iBAAiB,GAAG,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE;gBACzD,GAAG,KAAK;gBACR,MAAM,EAAE,EAAE;aACX,CAAC,CAAC;YACH,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;YACjD,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,cAAc;YACd,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,OAAO,QAAQ,CAAC,mBAAmB,EAAE,8CAA8C,CAAC,CAAC;YACvF,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACpB,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,iBAAiB,CAChC;gBACE,KAAK;gBACL,SAAS,EAAE,KAAK,CAAC,OAAO;gBACxB,cAAc,EAAE,aAAa;gBAC7B,WAAW,EAAE,UAAU;gBACvB,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;aACzB,EACD,WAAW,CACZ,CAAC;YACF,IAAI,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,EAAE,MAAM,KAAK,qBAAqB,KAAK,CAAC,OAAO,IAAI,CAAC;QACzF,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YACzE,OAAO,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,KAAK,CAAC,UAAU,aAAa,CAAC,CAAC;QAC/F,CAAC;QAED,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvC,MAAM,WAAW,GAAG;YAClB,EAAE;YACF,KAAK;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;YACpD,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACvC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACjD,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,OAAO;YACjB,gBAAgB,EAAE,eAAe,CAAC,IAAI,CAAC;YACvC,WAAW,EAAE,UAAU;YACvB,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjG,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,QAAQ,aAAa,CAAC,WAAW,CAAC,UAAU,IAAI,EAAE,CAAC;QACnE,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAErC,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACnC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB;gBACtE,IAAI,EAAE;oBACJ,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;oBACxB,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE,CAAW,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnG;gBACD,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,EAAE,IAAI,EAAE,uBAAuB,EAAE;aAC7E,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,EAAU,EAAE,MAA4B;IAC5D,OAAO,MAAM,KAAK,UAAU;QAC1B,CAAC,CAAC,2BAA2B,EAAE,KAAK;QACpC,CAAC,CAAC,kCAAkC,EAAE,WAAW,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,KAAsB;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC;IACtE,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,UAAU,CAAC;IAC/C,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,OAAO,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC,UAAU,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtE,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,YAAY,CAAC;AAC1E,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAkE,EAClE,WAAwB;IAExB,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,mNAAmN;IACrN,WAAW,EAAE,mBAAmB;IAChC,OAAO;CACR,CAAC"}

package/dist/mcp/tools/reject-candidate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `cairn_reject_candidate` — append a topic-index slug to
+ * `.cairn/ground/_rejected.yaml` so phase 6 / `cairn ingest` /
+ * `cairn_propose_decision` skip it on the next pass.
+ *
+ *  Dedup by slug — first writer wins the
+ * `reason` string; subsequent writes only refresh `rejected_at`. The
+ * AI-curator path stamps `rejected_by: "ai-curator"`; operator-driven
+ * rejections (`cairn-attention` skill) reuse the same writer with
+ * `rejected_by: "operator"`.
+ *
+ * Refusal modes:
+ *   - `not_found` — slug not present in the topic-index. We refuse so
+ *                   stale agent calls can't poison the rejection
+ *                   ledger with phantom slugs that the GC pass would
+ *                   immediately drop.
+ */
+import type { ToolDef } from "./types.js";
+interface Input {
+    slug: string;
+    reason: string;
+}
+export declare const rejectCandidateTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/reject-candidate.js

@@ -0,0 +1,71 @@
+/**
+ * `cairn_reject_candidate` — append a topic-index slug to
+ * `.cairn/ground/_rejected.yaml` so phase 6 / `cairn ingest` /
+ * `cairn_propose_decision` skip it on the next pass.
+ *
+ *  Dedup by slug — first writer wins the
+ * `reason` string; subsequent writes only refresh `rejected_at`. The
+ * AI-curator path stamps `rejected_by: "ai-curator"`; operator-driven
+ * rejections (`cairn-attention` skill) reuse the same writer with
+ * `rejected_by: "operator"`.
+ *
+ * Refusal modes:
+ *   - `not_found` — slug not present in the topic-index. We refuse so
+ *                   stale agent calls can't poison the rejection
+ *                   ledger with phantom slugs that the GC pass would
+ *                   immediately drop.
+ */
+import { appendRejected, readRejectedYaml, readTopicIndex, writeRejectedYaml, } from "@isaacriehm/cairn-state";
+import { withWriteLock } from "../../lock.js";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { rejectCandidateInput } from "../schemas.js";
+const REJECTED_BY = "ai-curator";
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    return withWriteLock(ctx.repoRoot, () => {
+        const topicIndex = readTopicIndex(ctx.repoRoot);
+        const entry = topicIndex.topics[input.slug];
+        if (entry === undefined) {
+            return {
+                ok: false,
+                reason: "not_found",
+                detail: `slug "${input.slug}" not in topic-index`,
+            };
+        }
+        const sot = entry.candidates.find((c) => c.file === entry.sot_source);
+        const now = new Date().toISOString();
+        const record = {
+            slug: input.slug,
+            rejected_at: now,
+            rejected_by: REJECTED_BY,
+            reason: input.reason,
+            sot_source: entry.sot_source,
+            ...(sot?.line_range !== undefined ? { line_range: sot.line_range } : {}),
+        };
+        const current = readRejectedYaml(ctx.repoRoot);
+        const existing = current.get(input.slug);
+        const next = appendRejected(current, record);
+        writeRejectedYaml(ctx.repoRoot, next);
+        if (existing !== undefined) {
+            return {
+                ok: true,
+                slug: input.slug,
+                warning: `Slug ${input.slug} was already rejected by ${existing.rejected_by} (${existing.reason}). ` +
+                    `Refreshed rejected_at; original reason preserved.`,
+            };
+        }
+        return {
+            ok: true,
+            slug: input.slug,
+        };
+    });
+}
+export const rejectCandidateTool = {
+    name: "cairn_reject_candidate",
+    description: "Mark a topic-index slug as not-a-decision in `.cairn/ground/_rejected.yaml`. Phase 6 / cairn ingest skip rejected slugs. Dedup by slug; first writer wins the reason string. Use when the candidate is research, narrative, plan, status, or otherwise not a binding rule.",
+    inputSchema: rejectCandidateInput,
+    handler,
+};
+//# sourceMappingURL=reject-candidate.js.map

package/dist/mcp/tools/reject-candidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reject-candidate.js","sourceRoot":"","sources":["../../../src/mcp/tools/reject-candidate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAgBrD,MAAM,WAAW,GAAG,YAAY,CAAC;AAEjC,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEjC,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtC,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,SAAS,KAAK,CAAC,IAAI,sBAAsB;aAClB,CAAC;QACpC,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAkB;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,GAAG;YAChB,WAAW,EAAE,WAAW;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;QAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7C,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EACL,QAAQ,KAAK,CAAC,IAAI,4BAA4B,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,MAAM,KAAK;oBAC3F,mDAAmD;aACtB,CAAC;QACpC,CAAC;QACD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,KAAK,CAAC,IAAI;SACe,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,4QAA4Q;IAC9Q,WAAW,EAAE,oBAAoB;IACjC,OAAO;CACR,CAAC"}

package/dist/mcp/tools/resolve-attention.d.ts

@@ -4,30 +4,17 @@
  * Spec: PLUGIN_ARCHITECTURE §9 (MCP write tools — plugin-era addition).
  *
  * The cairn-attention skill calls this after the operator picks an
- * option. It maps `kind × choice` onto the canonical resolution
- * pathway:
- *
- * | kind                | choice | resolution                                  |
- * |---------------------|--------|---------------------------------------------|
- * | decision_draft      | a      | accept — move `_inbox/<id>.draft.md` → `<id>.md`, status=accepted |
- * | decision_draft      | b      | reject — rename draft to .rejected.md (id reserved forever) |
- * | decision_draft      | c      | edit-pending — return draft body (no write) |
- * | baseline_finding    | a      | triage-now — no-op (skill opens the file)   |
- * | baseline_finding    | b      | suppress — append to baseline/suppressions.yaml |
- * | baseline_finding    | c      | defer — no-op                               |
- * | invalidation_event  | a      | refresh — re-read in-scope DECs/§INVs        |
- * | invalidation_event  | b      | continue-under-old — no-op                  |
- * | invalidation_event  | c      | abort — caller archives task (no-op here)   |
- * | drift               | a/b/c  | acknowledged (drift surface not yet active) |
+ * option. It maps the option (a/b/c/d) to a ground-state write (promote
+ * draft, suppress finding, record resolution event).
  */
 import type { ToolDef } from "./types.js";
 interface Input {
+    kind: "decision_draft" | "baseline_finding" | "invalidation_event" | "drift" | "bypass" | "review" | "conflict" | "alignment_pending";
     item_id: string;
     choice: "a" | "b" | "c" | "d";
-    kind: "decision_draft" | "baseline_finding" | "invalidation_event" | "drift" | "bypass" | "review" | "conflict" | "alignment_pending";
-    flagged_items?: string[];
-    defer_hours?: number;
     rationale?: string;
+    defer_hours?: number;
+    flagged_items?: string[];
 }
 export declare const resolveAttentionTool: ToolDef<Input>;
 export {};