@isaacriehm/cairn-core 0.6.0 → 0.7.0

package/dist/mcp/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,yBAAyB;IACzB,eAAe;IACf,oBAAoB;IACpB,sBAAsB;IACtB,qBAAqB;IACrB,aAAa;IACb,mBAAmB;IACnB,gBAAgB;IAChB,qBAAqB;IACrB,6BAA6B;IAC7B,UAAU;IACV,YAAY;IACZ,WAAW;IACX,4BAA4B;IAC5B,gBAAgB;IAChB,QAAQ;IACR,kBAAkB;IAClB,cAAc;IACd,WAAW;IACX,qBAAqB;IACrB,oBAAoB;IACpB,uBAAuB;IACvB,kBAAkB;IAClB,oBAAoB;IACpB,kBAAkB;IAClB,iBAAiB;IACjB,qCAAqC;IACrC,cAAc;IACd,iDAAiD;IACjD,cAAc;IACd,mBAAmB;IACnB,GAAG,cAAc;CAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,yBAAyB;IACzB,eAAe;IACf,oBAAoB;IACpB,sBAAsB;IACtB,qBAAqB;IACrB,aAAa;IACb,mBAAmB;IACnB,gBAAgB;IAChB,qBAAqB;IACrB,6BAA6B;IAC7B,UAAU;IACV,YAAY;IACZ,WAAW;IACX,4BAA4B;IAC5B,gBAAgB;IAChB,kEAAkE;IAClE,oBAAoB;IACpB,QAAQ;IACR,kBAAkB;IAClB,cAAc;IACd,WAAW;IACX,mEAAmE;IACnE,mBAAmB;IACnB,mBAAmB;IACnB,qBAAqB;IACrB,oBAAoB;IACpB,uBAAuB;IACvB,kBAAkB;IAClB,oBAAoB;IACpB,kBAAkB;IAClB,iBAAiB;IACjB,qCAAqC;IACrC,cAAc;IACd,iDAAiD;IACjD,cAAc;IACd,mBAAmB;IACnB,GAAG,cAAc;CAClB,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * `cairn_propose_decision` — promote a topic-index candidate (slug)
+ * into a DEC draft under `.cairn/ground/decisions/_inbox/`.
+ *
+ * Spec: PHASE_6_REDESIGN §4.6 / §5.4. The AI-curator path. Body is
+ * ALWAYS verbatim from `readSotBody` so the resulting draft's
+ * `sot_content_hash` matches the source paragraph the agent saw — no
+ * paraphrasing, no AI-generated prose. The drift sensor depends on
+ * this hash.
+ *
+ * Refusal modes (returned as `{ ok: false, reason: <kind> }`):
+ *   - `not_found`  — slug not present in the topic-index.
+ *   - `rejected`   — slug appears in `.cairn/ground/_rejected.yaml`.
+ *   - `unreadable` — `readSotBody` returned null (anchor-map missing
+ *                    or the source file disappeared).
+ *   - `drifted`    — body hash no longer matches `entry.content_hash`.
+ *                    The operator (or another agent) edited the source
+ *                    paragraph after phase 5b walked it. Caller should
+ *                    re-run `cairn index` and re-evaluate.
+ *
+ * Idempotent: a slug that already has a `dec_id` returns
+ *   `{ ok: true, dec_id, path, warning: "...already exists" }` rather
+ *   than re-emitting. The locked "DO NOT enforce" wording goes back
+ *   to the agent verbatim so it cannot accidentally cite the draft as
+ *   accepted policy.
+ */
+import type { ToolDef } from "./types.js";
+interface Input {
+    slug: string;
+    title?: string;
+    kind?: "decision" | "rule";
+}
+export declare const proposeDecisionTool: ToolDef<Input>;
+export {};

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

@@ -0,0 +1,200 @@
+/**
+ * `cairn_propose_decision` — promote a topic-index candidate (slug)
+ * into a DEC draft under `.cairn/ground/decisions/_inbox/`.
+ *
+ * Spec: PHASE_6_REDESIGN §4.6 / §5.4. The AI-curator path. Body is
+ * ALWAYS verbatim from `readSotBody` so the resulting draft's
+ * `sot_content_hash` matches the source paragraph the agent saw — no
+ * paraphrasing, no AI-generated prose. The drift sensor depends on
+ * this hash.
+ *
+ * Refusal modes (returned as `{ ok: false, reason: <kind> }`):
+ *   - `not_found`  — slug not present in the topic-index.
+ *   - `rejected`   — slug appears in `.cairn/ground/_rejected.yaml`.
+ *   - `unreadable` — `readSotBody` returned null (anchor-map missing
+ *                    or the source file disappeared).
+ *   - `drifted`    — body hash no longer matches `entry.content_hash`.
+ *                    The operator (or another agent) edited the source
+ *                    paragraph after phase 5b walked it. Caller should
+ *                    re-run `cairn index` and re-evaluate.
+ *
+ * Idempotent: a slug that already has a `dec_id` returns
+ *   `{ ok: true, dec_id, path, warning: "...already exists" }` rather
+ *   than re-emitting. The locked "DO NOT enforce" wording goes back
+ *   to the agent verbatim so it cannot accidentally cite the draft as
+ *   accepted policy.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { bodyContentHash, decisionsDir, deriveDecId, readAnchorMap, readRejectedYaml, readTopicIndex, setTopic, writeFileCandidatesMap, writeTopicIndex, } from "../../ground/index.js";
+import { scanExistingDecisionIds } from "../../decision-capture/index.js";
+import { withWriteLock } from "../../lock.js";
+import { readSotBody } from "../../init/sot-emit.js";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { proposeDecisionInput } from "../schemas.js";
+const CAPTURE_SOURCE = "ai-proposed";
+const DECIDED_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`,
+            };
+        }
+        if (entry.dec_id !== undefined) {
+            return {
+                ok: true,
+                dec_id: entry.dec_id,
+                path: relativeInboxPath(entry.dec_id, ctx.repoRoot),
+                warning: `DEC draft already exists for slug ${input.slug}; returning existing id ${entry.dec_id}.`,
+            };
+        }
+        const rejected = readRejectedYaml(ctx.repoRoot);
+        const reject = rejected.get(input.slug);
+        if (reject !== undefined) {
+            return {
+                ok: false,
+                reason: "rejected",
+                detail: reject.reason,
+            };
+        }
+        const anchorMap = readAnchorMap(ctx.repoRoot);
+        const body = readSotBody(ctx.repoRoot, entry, anchorMap);
+        if (body === null) {
+            return {
+                ok: false,
+                reason: "unreadable",
+                detail: "anchor-map missing or source body unreadable",
+            };
+        }
+        // Drift check — the topic-index records the body hash phase 5b
+        // saw. If the operator (or another agent) has since edited the
+        // paragraph, the AI may be promoting outdated content. Surface it
+        // and bounce the caller; correct path is `cairn index` then retry.
+        if (entry.content_hash !== undefined) {
+            const currentHash = bodyContentHash(body);
+            if (currentHash !== entry.content_hash) {
+                return {
+                    ok: false,
+                    reason: "drifted",
+                    detail: "Source file modified since index build. Run 'cairn index' to refresh, then retry.",
+                };
+            }
+        }
+        const titleSeed = input.title !== undefined && input.title.trim().length > 0
+            ? input.title.trim()
+            : firstLineFallback(body);
+        const sotPath = entryToSotPath(entry);
+        const existingIds = scanExistingDecisionIds(ctx.repoRoot);
+        const decId = allocateUniqueDecId({ sot_path: sotPath, title: titleSeed, capture_source: CAPTURE_SOURCE }, existingIds);
+        writeDraftToInbox({
+            repoRoot: ctx.repoRoot,
+            id: decId,
+            title: titleSeed,
+            body,
+            sot_path: sotPath,
+            source_file: entry.sot_source,
+        });
+        const updatedTopicIndex = setTopic(topicIndex, input.slug, {
+            ...entry,
+            dec_id: decId,
+        });
+        writeTopicIndex(ctx.repoRoot, updatedTopicIndex);
+        // Refresh the per-file candidate count map so the read-enrich
+        // hint reflects the post-promote state next time the agent reads
+        // the file.
+        writeFileCandidatesMap(ctx.repoRoot, updatedTopicIndex);
+        return {
+            ok: true,
+            dec_id: decId,
+            path: relativeInboxPath(decId, ctx.repoRoot),
+            warning: `Created draft from slug ${input.slug}. Status=draft, pending operator review via cairn-attention. ` +
+                `DO NOT enforce this rule yet — proposal only. You MAY cite as "proposed (${decId}, draft)".`,
+        };
+    });
+}
+function writeDraftToInbox(args) {
+    const inboxDir = join(decisionsDir(args.repoRoot), "_inbox");
+    mkdirSync(inboxDir, { recursive: true });
+    const abs = join(inboxDir, `${args.id}.draft.md`);
+    const now = new Date().toISOString();
+    const fm = {
+        id: args.id,
+        title: args.title,
+        type: "adr",
+        status: "draft",
+        audience: "dual",
+        generated: now,
+        "verified-at": now,
+        decided_at: now,
+        decided_by: DECIDED_BY,
+        sot_kind: "path",
+        sot_path: args.sot_path,
+        sot_content_hash: bodyContentHash(args.body),
+        capture_source: CAPTURE_SOURCE,
+        source_file: args.source_file,
+    };
+    const out = [];
+    out.push("---");
+    out.push(stringifyYaml(fm).trimEnd());
+    out.push("---");
+    out.push("");
+    out.push(args.body.trimEnd());
+    out.push("");
+    writeFileSync(abs, out.join("\n"), "utf8");
+    return abs;
+}
+function relativeInboxPath(id, _repoRoot) {
+    // Project-relative path so callers can hand it straight to Read or
+    // `cairn_decision_get` without prefix juggling.
+    return `.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)";
+}
+/**
+ * Mirrors `phase 6`'s id allocator: derive a content-stable id, fall
+ * back to `<title> #N` suffixing on the (vanishingly rare) collision
+ * against an existing on-disk DEC.
+ */
+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 proposeDecisionTool = {
+    name: "cairn_propose_decision",
+    description: "Promote a topic-index candidate (slug) to a DEC draft in `_inbox/`. Body is verbatim via readSotBody; AI may only supply a title. Refuses on rejected, drifted, or unreadable slugs. Returns a locked 'DO NOT enforce — proposal only' warning so the draft is never miscited as accepted policy.",
+    inputSchema: proposeDecisionInput,
+    handler,
+};
+//# sourceMappingURL=propose-decision.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propose-decision.js","sourceRoot":"","sources":["../../../src/mcp/tools/propose-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,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,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,eAAe,GAEhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AASrD,MAAM,cAAc,GAAG,aAAa,CAAC;AACrC,MAAM,UAAU,GAAG,YAAY,CAAC;AAWhC,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,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;gBACnD,OAAO,EAAE,qCAAqC,KAAK,CAAC,IAAI,2BAA2B,KAAK,CAAC,MAAM,GAAG;aACnE,CAAC;QACpC,CAAC;QAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,MAAM,CAAC,MAAM;aACU,CAAC;QACpC,CAAC;QAED,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACzD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,8CAA8C;aACvB,CAAC;QACpC,CAAC;QAED,+DAA+D;QAC/D,+DAA+D;QAC/D,kEAAkE;QAClE,mEAAmE;QACnE,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,WAAW,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvC,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,SAAS;oBACjB,MAAM,EACJ,mFAAmF;iBACtD,CAAC;YACpC,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAC1E,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;YACpB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEtC,MAAM,WAAW,GAAG,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,mBAAmB,CAC/B,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,EACvE,WAAW,CACZ,CAAC;QAEF,iBAAiB,CAAC;YAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,SAAS;YAChB,IAAI;YACJ,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,KAAK,CAAC,UAAU;SAC9B,CAAC,CAAC;QAEH,MAAM,iBAAiB,GAAG,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE;YACzD,GAAG,KAAK;YACR,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACjD,8DAA8D;QAC9D,iEAAiE;QACjE,YAAY;QACZ,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAExD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC;YAC5C,OAAO,EACL,2BAA2B,KAAK,CAAC,IAAI,+DAA+D;gBACpG,4EAA4E,KAAK,YAAY;SAChE,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAWD,SAAS,iBAAiB,CAAC,IAAoB;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7D,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,EAAE,GAA4B;QAClC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,GAAG;QACd,aAAa,EAAE,GAAG;QAClB,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,UAAU;QACtB,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,gBAAgB,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5C,cAAc,EAAE,cAAc;QAC9B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;IACF,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACtC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAU,EAAE,SAAiB;IACtD,mEAAmE;IACnE,gDAAgD;IAChD,OAAO,kCAAkC,EAAE,WAAW,CAAC;AACzD,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;;;;GAIG;AACH,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,mBAAmB,GAAmB;IACjD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,mSAAmS;IACrS,WAAW,EAAE,oBAAoB;IACjC,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.
+ *
+ * Spec: PHASE_6_REDESIGN §4.6. 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.
+ *
+ * Spec: PHASE_6_REDESIGN §4.6. 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 "../../ground/index.js";
+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 / cairn_propose_decision 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,uBAAuB,CAAC;AAC/B,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,qSAAqS;IACvS,WAAW,EAAE,oBAAoB;IACjC,OAAO;CACR,CAAC"}

package/dist/mcp/tools/search-candidates.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `cairn_search_candidates` — query topic-index entries that haven't
+ * been promoted to a DEC yet (`dec_id IS NULL`).
+ *
+ * Spec: PHASE_6_REDESIGN §4.6. Mirrors the response shape of
+ * `cairn_decisions_in_scope` so AI agents can use the two
+ * interchangeably during the daily read-enrich-driven curator flow.
+ *
+ * The slugs returned by this tool are exactly the slugs accepted by
+ * `cairn_propose_decision` and `cairn_reject_candidate`.
+ */
+import type { ToolDef } from "./types.js";
+interface Input {
+    query?: string;
+    scope?: string;
+    kind?: "decision" | "rule";
+    limit?: number;
+}
+export declare const searchCandidatesTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/search-candidates.js

@@ -0,0 +1,93 @@
+/**
+ * `cairn_search_candidates` — query topic-index entries that haven't
+ * been promoted to a DEC yet (`dec_id IS NULL`).
+ *
+ * Spec: PHASE_6_REDESIGN §4.6. Mirrors the response shape of
+ * `cairn_decisions_in_scope` so AI agents can use the two
+ * interchangeably during the daily read-enrich-driven curator flow.
+ *
+ * The slugs returned by this tool are exactly the slugs accepted by
+ * `cairn_propose_decision` and `cairn_reject_candidate`.
+ */
+import { matchGlob, readRejectedYaml, readTopicIndex, } from "../../ground/index.js";
+import { readSotBody } from "../../init/sot-emit.js";
+import { readAnchorMap } from "../../ground/index.js";
+import { searchCandidatesInput } from "../schemas.js";
+/** Matches the body-preview cap used elsewhere when surfacing prose to AI agents. */
+const BODY_PREVIEW_CHARS = 280;
+const DEFAULT_LIMIT = 50;
+async function handler(ctx, input) {
+    const limit = Math.min(input.limit ?? DEFAULT_LIMIT, 200);
+    const topicIndex = readTopicIndex(ctx.repoRoot);
+    const anchorMap = readAnchorMap(ctx.repoRoot);
+    const rejected = readRejectedYaml(ctx.repoRoot);
+    const q = input.query !== undefined ? input.query.toLowerCase() : null;
+    const scope = input.scope ?? null;
+    const out = [];
+    for (const entry of Object.values(topicIndex.topics)) {
+        if (entry.dec_id !== undefined)
+            continue;
+        if (rejected.has(entry.slug))
+            continue;
+        if (input.kind !== undefined && entry.marker_kind !== input.kind)
+            continue;
+        if (scope !== null && !matchGlob(entry.sot_source, scope))
+            continue;
+        const body = readSotBody(ctx.repoRoot, entry, anchorMap) ?? "";
+        const title = deriveTitle(entry, body);
+        if (q !== null) {
+            const titleHit = title.toLowerCase().includes(q);
+            const bodyHit = body.toLowerCase().includes(q);
+            if (!titleHit && !bodyHit)
+                continue;
+        }
+        const sot = entry.candidates.find((c) => c.file === entry.sot_source);
+        const summary = {
+            slug: entry.slug,
+            title,
+            sot_source: entry.sot_source,
+            body_preview: previewBody(body),
+        };
+        if (sot?.line_range !== undefined)
+            summary.line_range = sot.line_range;
+        if (entry.marker_kind !== undefined)
+            summary.marker_kind = entry.marker_kind;
+        out.push(summary);
+    }
+    // Stable ordering: marker-kinded first, then alpha by sot_source so
+    // pagination via `limit` is predictable across runs.
+    out.sort((a, b) => {
+        const am = a.marker_kind !== undefined ? 0 : 1;
+        const bm = b.marker_kind !== undefined ? 0 : 1;
+        if (am !== bm)
+            return am - bm;
+        if (a.sot_source !== b.sot_source)
+            return a.sot_source.localeCompare(b.sot_source);
+        return a.slug.localeCompare(b.slug);
+    });
+    return out.slice(0, limit);
+}
+function deriveTitle(entry, body) {
+    const sot = entry.candidates.find((c) => c.file === entry.sot_source);
+    if (sot?.anchor !== undefined && sot.anchor.length > 0) {
+        return sot.anchor.replace(/[-_]+/g, " ").trim().slice(0, 120) || firstLineFallback(body);
+    }
+    return firstLineFallback(body);
+}
+function firstLineFallback(body) {
+    const first = body.split("\n").find((l) => l.trim().length > 0) ?? "";
+    return first.replace(/^#+\s*/, "").trim().slice(0, 120) || "(untitled)";
+}
+function previewBody(body) {
+    const trimmed = body.trim();
+    if (trimmed.length <= BODY_PREVIEW_CHARS)
+        return trimmed;
+    return `${trimmed.slice(0, BODY_PREVIEW_CHARS)}…`;
+}
+export const searchCandidatesTool = {
+    name: "cairn_search_candidates",
+    description: "List unpromoted topic-index candidates (slugs whose `dec_id` is null). Filter by `query` (substring on title/body), `scope` (glob on sot_source), or `kind` (marker_kind). Returned slugs feed `cairn_propose_decision` and `cairn_reject_candidate`.",
+    inputSchema: searchCandidatesInput,
+    handler,
+};
+//# sourceMappingURL=search-candidates.js.map

package/dist/mcp/tools/search-candidates.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isaacriehm/cairn-core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Cairn core — state + context layer. Curated `.cairn/ground/` (decisions, §INV invariants, canonical-map, brand, quality-grades), MCP server, init wizard, hook runners, sensors, GC drift sweep.",
   "author": "Isaac Riehm",
   "license": "MIT",

package/templates/attention-ui/app.js

@@ -301,15 +301,52 @@ async function mergeCluster() {
 }
 
 async function bulkAcceptHigh() {
-  setStatus("bulk-accepting high-confidence drafts…");
+  // Dry-run first so the operator sees the distribution before any
+  // writes hit disk. Without this the button silently mutated drafts
+  // even when zero met the high threshold.
+  setStatus("scoring drafts (dry run)…");
+  const preview = await api("/api/bulk-accept", {
+    method: "POST",
+    body: { threshold: "high", dryRun: true },
+  });
+  if (!preview.ok) {
+    setStatus("bulk-accept preview failed");
+    return;
+  }
+  const dist = preview.decsByConfidence ?? { high: 0, medium: 0, low: 0 };
+  const invDist = preview.invariantsByConfidence ?? { high: 0, medium: 0, low: 0 };
+  const wouldPromote = preview.decsAccepted ?? 0;
+  const summary =
+    `Score preview\n` +
+    `  drafts: ${dist.high} high · ${dist.medium} medium · ${dist.low} low\n` +
+    `  invariants: ${invDist.high} high · ${invDist.medium} medium · ${invDist.low} low\n\n` +
+    `${wouldPromote} draft${wouldPromote === 1 ? "" : "s"} would be promoted to accepted.\n` +
+    `${dist.medium + dist.low} medium/low draft${dist.medium + dist.low === 1 ? "" : "s"} would stay in inbox (newly stamped only if not already scored).\n\n` +
+    `Continue?`;
+  if (wouldPromote === 0) {
+    setStatus(
+      `0 drafts meet 'high' threshold — nothing to promote (${dist.high}/${dist.medium}/${dist.low} h/m/l). Cancelled.`,
+    );
+    return;
+  }
+  if (!window.confirm(summary)) {
+    setStatus("bulk-accept cancelled");
+    return;
+  }
+  setStatus("bulk-accepting…");
   const r = await api("/api/bulk-accept", {
     method: "POST",
     body: { threshold: "high" },
   });
   if (r.ok) {
-    setStatus(`bulk-accepted ${r.decsAccepted} drafts`);
+    const accepted = r.decsAccepted ?? 0;
+    const finalDist = r.decsByConfidence ?? dist;
+    setStatus(
+      `bulk-accepted ${accepted} draft${accepted === 1 ? "" : "s"}. ` +
+        `${finalDist.medium + finalDist.low} remain in inbox.`,
+    );
   } else {
-    setStatus(`bulk-accept failed`);
+    setStatus("bulk-accept failed");
   }
   await refresh();
 }