@isaacriehm/cairn-core 0.3.6 → 0.3.8

package/dist/attention/bulk-accept.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Bulk-accept obvious DEC drafts + stamp confidence on invariants.
+ *
+ * Mirrors the per-draft accept flow in `mcp/tools/resolve-attention.ts`
+ * (`choice: "a"`) but applies it in one pass over `_inbox/` filtered
+ * by the `scoring.ts` heuristic. Operator runs this once per
+ * adoption to drain the obvious classifications, then triages the
+ * medium / low-confidence remainder interactively via the existing
+ * cairn-attention skill.
+ *
+ * Design:
+ *   - Score each draft from frontmatter + body (prose, raw block) so
+ *     it can run against drafts written before the scoring pipeline
+ *     existed (back-compat for v0.3.6 adoptions).
+ *   - High-confidence DEC drafts: move `_inbox/<id>.draft.md`
+ *     → `<id>.md`, flip `status:` frontmatter to `accepted`, and
+ *     stamp `capture_confidence: high`. Rebuild
+ *     `decisions.ledger.yaml` once at the end.
+ *   - Medium / low-confidence DEC drafts: stay in `_inbox/` but
+ *     get `capture_confidence` stamped so the cairn-attention skill
+ *     can prioritize what to surface first.
+ *   - Invariants are already at `status: active` (phase 7b promotes
+ *     them on write). Just stamp `capture_confidence` so future
+ *     UX can hide low-confidence ones from the active set.
+ *
+ * Side-effect-only: emits decision_accepted events, runs the source
+ * strip-replace pass on accepted source-comment drafts so the §INV /
+ * §DEC citations land in the original source.
+ */
+import type { ProjectGlobs } from "../sensors/types.js";
+import { type DraftConfidence } from "./scoring.js";
+export interface BulkAcceptArgs {
+    repoRoot: string;
+    /** Project globs sourced from `.cairn/config.yaml`. */
+    globs: ProjectGlobs;
+    /** Pilot module path (workflow.md `pilot_module`) for scoring bias. */
+    pilotModule?: string;
+    /**
+     * Minimum confidence to auto-accept DEC drafts. Defaults to "high"
+     * — only obvious accepts move out of the inbox. "medium" widens
+     * acceptance; "low" effectively accepts everything (do not use
+     * unless the operator explicitly opts in).
+     */
+    threshold?: DraftConfidence;
+    /** Don't write — just compute counts. Returns the same shape. */
+    dryRun?: boolean;
+}
+export interface BulkAcceptResult {
+    decsScanned: number;
+    decsAccepted: number;
+    decsByConfidence: Record<DraftConfidence, number>;
+    acceptedIds: string[];
+    invariantsScanned: number;
+    invariantsByConfidence: Record<DraftConfidence, number>;
+    dryRun: boolean;
+}
+/**
+ * Score, stamp, and (for high-confidence DECs) accept inbox drafts in
+ * bulk. Returns the count summary the CLI / skill renders to the
+ * operator.
+ */
+export declare function bulkAcceptObvious(args: BulkAcceptArgs): Promise<BulkAcceptResult>;

package/dist/attention/bulk-accept.js

@@ -0,0 +1,250 @@
+/**
+ * Bulk-accept obvious DEC drafts + stamp confidence on invariants.
+ *
+ * Mirrors the per-draft accept flow in `mcp/tools/resolve-attention.ts`
+ * (`choice: "a"`) but applies it in one pass over `_inbox/` filtered
+ * by the `scoring.ts` heuristic. Operator runs this once per
+ * adoption to drain the obvious classifications, then triages the
+ * medium / low-confidence remainder interactively via the existing
+ * cairn-attention skill.
+ *
+ * Design:
+ *   - Score each draft from frontmatter + body (prose, raw block) so
+ *     it can run against drafts written before the scoring pipeline
+ *     existed (back-compat for v0.3.6 adoptions).
+ *   - High-confidence DEC drafts: move `_inbox/<id>.draft.md`
+ *     → `<id>.md`, flip `status:` frontmatter to `accepted`, and
+ *     stamp `capture_confidence: high`. Rebuild
+ *     `decisions.ledger.yaml` once at the end.
+ *   - Medium / low-confidence DEC drafts: stay in `_inbox/` but
+ *     get `capture_confidence` stamped so the cairn-attention skill
+ *     can prioritize what to surface first.
+ *   - Invariants are already at `status: active` (phase 7b promotes
+ *     them on write). Just stamp `capture_confidence` so future
+ *     UX can hide low-confidence ones from the active set.
+ *
+ * Side-effect-only: emits decision_accepted events, runs the source
+ * strip-replace pass on accepted source-comment drafts so the §INV /
+ * §DEC citations land in the original source.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { decisionsDir, invariantsDir } from "../ground/paths.js";
+import { writeDecisionsLedger } from "../ground/ledgers.js";
+import { withWriteLock } from "../lock.js";
+import { scoreDecDraft, scoreInvariant, } from "./scoring.js";
+/**
+ * Score, stamp, and (for high-confidence DECs) accept inbox drafts in
+ * bulk. Returns the count summary the CLI / skill renders to the
+ * operator.
+ */
+export async function bulkAcceptObvious(args) {
+    const threshold = args.threshold ?? "high";
+    const dry = args.dryRun ?? false;
+    // ── DEC drafts ────────────────────────────────────────────────────
+    const inboxDir = join(decisionsDir(args.repoRoot), "_inbox");
+    const decResult = {
+        decsScanned: 0,
+        decsAccepted: 0,
+        decsByConfidence: { high: 0, medium: 0, low: 0 },
+        acceptedIds: [],
+    };
+    if (existsSync(inboxDir)) {
+        const entries = readdirSync(inboxDir, { withFileTypes: true });
+        const drafts = entries.filter((e) => e.isFile() && e.name.endsWith(".draft.md"));
+        decResult.decsScanned = drafts.length;
+        if (drafts.length > 0) {
+            await withWriteLock(args.repoRoot, () => {
+                for (const e of drafts) {
+                    const abs = join(inboxDir, e.name);
+                    let raw;
+                    try {
+                        raw = readFileSync(abs, "utf8");
+                    }
+                    catch {
+                        continue;
+                    }
+                    const fm = parseFrontmatter(raw);
+                    const body = stripFrontmatter(raw);
+                    const id = stringField(fm, "id") ?? e.name.replace(/\.draft\.md$/, "");
+                    const sourceFile = stringField(fm, "sourceFile") ?? "";
+                    const titleFm = stringField(fm, "proposedTitle") ?? stringField(fm, "title") ?? "";
+                    const rationaleFm = stringField(fm, "proposedRationale") ?? extractSection(body, "Proposed rationale");
+                    const proseFromBody = extractSection(body, "Source comment");
+                    const prose = rationaleFm.length > 0 ? rationaleFm : proseFromBody;
+                    const score = scoreDecDraft({
+                        sourceFile,
+                        prose,
+                        title: titleFm,
+                        rawComment: proseFromBody,
+                        globs: args.globs,
+                        ...(args.pilotModule !== undefined ? { pilotModule: args.pilotModule } : {}),
+                    });
+                    decResult.decsByConfidence[score] += 1;
+                    // Always stamp the confidence so future passes (and the
+                    // skill) can read it without re-scoring.
+                    const stampedFm = { ...fm, capture_confidence: score };
+                    if (atOrAbove(score, threshold)) {
+                        // Promote to accepted.
+                        const acceptedFm = { ...stampedFm, status: "accepted" };
+                        const acceptedBody = renderDoc(acceptedFm, body);
+                        const acceptedPath = join(decisionsDir(args.repoRoot), `${id}.md`);
+                        if (!dry) {
+                            mkdirSync(dirname(acceptedPath), { recursive: true });
+                            writeFileSync(acceptedPath, acceptedBody, "utf8");
+                            try {
+                                rmSync(abs, { force: true });
+                            }
+                            catch {
+                                /* best-effort */
+                            }
+                        }
+                        decResult.decsAccepted += 1;
+                        decResult.acceptedIds.push(id);
+                    }
+                    else {
+                        // Stay in inbox; persist confidence stamp so the skill
+                        // can sort/show it.
+                        const stampedDoc = renderDoc(stampedFm, body);
+                        if (!dry) {
+                            writeFileSync(abs, stampedDoc, "utf8");
+                        }
+                    }
+                }
+                // Rebuild the ledger once at the end so accepted DECs surface
+                // in `cairn_decisions_in_scope` immediately.
+                if (!dry && decResult.decsAccepted > 0) {
+                    try {
+                        writeDecisionsLedger({ repoRoot: args.repoRoot });
+                    }
+                    catch {
+                        /* best-effort */
+                    }
+                }
+            });
+        }
+    }
+    // ── Invariants ────────────────────────────────────────────────────
+    // Already at status: active on disk. Just stamp confidence so the
+    // attention skill can hide / down-weight low-confidence ones.
+    const invDir = invariantsDir(args.repoRoot);
+    const invResult = {
+        invariantsScanned: 0,
+        invariantsByConfidence: { high: 0, medium: 0, low: 0 },
+    };
+    if (existsSync(invDir)) {
+        const invEntries = readdirSync(invDir, { withFileTypes: true });
+        const invFiles = invEntries.filter((e) => e.isFile() && /^INV-\d{4,}\.md$/.test(e.name));
+        invResult.invariantsScanned = invFiles.length;
+        if (invFiles.length > 0 && !dry) {
+            await withWriteLock(args.repoRoot, () => {
+                for (const e of invFiles) {
+                    const abs = join(invDir, e.name);
+                    let raw;
+                    try {
+                        raw = readFileSync(abs, "utf8");
+                    }
+                    catch {
+                        continue;
+                    }
+                    const fm = parseFrontmatter(raw);
+                    const body = stripFrontmatter(raw);
+                    const sourceFile = stringField(fm, "sourceFile") ?? "";
+                    const titleFm = stringField(fm, "title") ?? "";
+                    const rawCommentBody = extractSection(body, "Source comment");
+                    const constraintBody = extractSection(body, "Constraint");
+                    const prose = constraintBody.length > 0 ? constraintBody : titleFm;
+                    const score = scoreInvariant({
+                        sourceFile,
+                        prose,
+                        title: titleFm,
+                        rawComment: rawCommentBody,
+                        globs: args.globs,
+                        ...(args.pilotModule !== undefined ? { pilotModule: args.pilotModule } : {}),
+                    });
+                    invResult.invariantsByConfidence[score] += 1;
+                    const stamped = { ...fm, capture_confidence: score };
+                    const stampedDoc = renderDoc(stamped, body);
+                    writeFileSync(abs, stampedDoc, "utf8");
+                }
+            });
+        }
+        else if (invFiles.length > 0 && dry) {
+            // Dry run still scores so the operator can see the distribution.
+            for (const e of invFiles) {
+                const abs = join(invDir, e.name);
+                let raw;
+                try {
+                    raw = readFileSync(abs, "utf8");
+                }
+                catch {
+                    continue;
+                }
+                const fm = parseFrontmatter(raw);
+                const body = stripFrontmatter(raw);
+                const sourceFile = stringField(fm, "sourceFile") ?? "";
+                const titleFm = stringField(fm, "title") ?? "";
+                const rawCommentBody = extractSection(body, "Source comment");
+                const constraintBody = extractSection(body, "Constraint");
+                const prose = constraintBody.length > 0 ? constraintBody : titleFm;
+                const score = scoreInvariant({
+                    sourceFile,
+                    prose,
+                    title: titleFm,
+                    rawComment: rawCommentBody,
+                    globs: args.globs,
+                    ...(args.pilotModule !== undefined ? { pilotModule: args.pilotModule } : {}),
+                });
+                invResult.invariantsByConfidence[score] += 1;
+            }
+        }
+    }
+    return {
+        ...decResult,
+        ...invResult,
+        dryRun: dry,
+    };
+}
+// ── Helpers ────────────────────────────────────────────────────────
+function parseFrontmatter(doc) {
+    const m = doc.match(/^---\n([\s\S]*?)\n---/);
+    if (m === null || m[1] === undefined)
+        return {};
+    try {
+        const parsed = parseYaml(m[1]);
+        return typeof parsed === "object" && parsed !== null
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function stripFrontmatter(doc) {
+    return doc.replace(/^---\n[\s\S]*?\n---\n?/, "");
+}
+function renderDoc(fm, body) {
+    return `---\n${stringifyYaml(fm).trimEnd()}\n---\n${body.startsWith("\n") ? body : `\n${body}`}`;
+}
+function stringField(fm, key) {
+    const v = fm[key];
+    return typeof v === "string" ? v : null;
+}
+function extractSection(body, header) {
+    // Find `## <header>` and return content until the next `## ` block.
+    const re = new RegExp(`##\\s+${escapeRegex(header)}\\s*\\n([\\s\\S]*?)(?=\\n##\\s|$)`, "i");
+    const m = body.match(re);
+    if (m === null || m[1] === undefined)
+        return "";
+    // Strip surrounding code-fence markers if the section is fenced.
+    return m[1].replace(/^\s*```[a-z0-9]*\n?/i, "").replace(/```\s*$/, "").trim();
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function atOrAbove(score, threshold) {
+    const order = { low: 0, medium: 1, high: 2 };
+    return order[score] >= order[threshold];
+}
+//# sourceMappingURL=bulk-accept.js.map

package/dist/attention/bulk-accept.js.map

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

package/dist/attention/index.d.ts

@@ -0,0 +1,2 @@
+export { scoreDecDraft, scoreInvariant, type DraftConfidence, type DraftScoreInput, } from "./scoring.js";
+export { bulkAcceptObvious, type BulkAcceptArgs, type BulkAcceptResult, } from "./bulk-accept.js";

package/dist/attention/index.js

@@ -0,0 +1,3 @@
+export { scoreDecDraft, scoreInvariant, } from "./scoring.js";
+export { bulkAcceptObvious, } from "./bulk-accept.js";
+//# sourceMappingURL=index.js.map

package/dist/attention/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/attention/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,GAGf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,GAGlB,MAAM,kBAAkB,CAAC"}

package/dist/attention/scoring.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Confidence scoring for source-comment-derived DEC drafts and
+ * invariant proposals.
+ *
+ * Phase 7b emits one DEC draft per "rationale"-class essay comment and
+ * one invariant per "constraint"-class essay comment. On a busy
+ * monorepo the classifier easily produces 400+ drafts — no human will
+ * sort through that interactively, so we score each draft by a small
+ * set of heuristics and bulk-accept the obvious ones during attention
+ * drain. Operator triages only the medium / low-confidence remainder.
+ *
+ * Heuristic stance:
+ *   - **DEC drafts** are attribution-of-existing-prose. Cost of keeping
+ *     a borderline draft is near zero (queryable rationale metadata).
+ *     Bias accepts upward — score ≥7 → high.
+ *   - **Invariants** become enforcement signals; false positives turn
+ *     into noise during sensor sweeps. Bias accepts downward —
+ *     stricter signal required (modal verb + reason + high-stakes
+ *     location) before high-confidence accept.
+ *
+ * Scoring is pure. Inputs are the parsed draft fields; no filesystem.
+ */
+import type { ProjectGlobs } from "../sensors/types.js";
+export type DraftConfidence = "high" | "medium" | "low";
+export interface DraftScoreInput {
+    /** Repo-relative path to the source file the draft was extracted from. */
+    sourceFile: string;
+    /** Comment prose (markers stripped). */
+    prose: string;
+    /** Suggested DEC title or invariant text. */
+    title: string;
+    /** Raw block including markers + JSDoc tags. */
+    rawComment: string;
+    /** Project globs from `.cairn/config.yaml`. */
+    globs: ProjectGlobs;
+    /** Pilot module path (e.g. `core/src`); empty / "." treated as no bias. */
+    pilotModule?: string;
+}
+/**
+ * Score a DEC draft. Max 9 / threshold 7→high / 4→medium.
+ */
+export declare function scoreDecDraft(input: DraftScoreInput): DraftConfidence;
+/**
+ * Score an invariant proposal. Max 9 / threshold 7→high / 4→medium.
+ * Stricter than DEC scoring: requires modal verb + reason + high-stakes
+ * location for high confidence, since false-positive invariants become
+ * sensor-sweep noise downstream.
+ */
+export declare function scoreInvariant(input: DraftScoreInput): DraftConfidence;

package/dist/attention/scoring.js

@@ -0,0 +1,98 @@
+/**
+ * Confidence scoring for source-comment-derived DEC drafts and
+ * invariant proposals.
+ *
+ * Phase 7b emits one DEC draft per "rationale"-class essay comment and
+ * one invariant per "constraint"-class essay comment. On a busy
+ * monorepo the classifier easily produces 400+ drafts — no human will
+ * sort through that interactively, so we score each draft by a small
+ * set of heuristics and bulk-accept the obvious ones during attention
+ * drain. Operator triages only the medium / low-confidence remainder.
+ *
+ * Heuristic stance:
+ *   - **DEC drafts** are attribution-of-existing-prose. Cost of keeping
+ *     a borderline draft is near zero (queryable rationale metadata).
+ *     Bias accepts upward — score ≥7 → high.
+ *   - **Invariants** become enforcement signals; false positives turn
+ *     into noise during sensor sweeps. Bias accepts downward —
+ *     stricter signal required (modal verb + reason + high-stakes
+ *     location) before high-confidence accept.
+ *
+ * Scoring is pure. Inputs are the parsed draft fields; no filesystem.
+ */
+import { matchAnyGlob } from "../ground/glob.js";
+const DECISION_VERBS = /\b(chose|chosen|choose|decided|prefer|preferred|because|locked|enforce|enforced|require|required|adopt|adopted|standardize|standardized|switch|migrated|deprecate|reject|rejected)\b/i;
+const JSDOC_TAGS = /@(domain|scope|orgScope|see|param|returns|throws|deprecated|since|module|namespace|file|fileoverview|public|private|protected|internal|readonly|override|sealed|immutable|invariant)\b/;
+const INVARIANT_MODALS = /\b(MUST|MUSTN'T|MUST NOT|NEVER|ALWAYS|SHALL|SHALL NOT|CANNOT|FORBID|FORBIDDEN|REQUIRED|REQUIRES)\b/i;
+const REASON_MARKERS = /\b(because|to (prevent|ensure|avoid|guarantee|preserve|enforce|stop)|otherwise)\b/i;
+function inHighStakes(file, globs) {
+    return matchAnyGlob(file, globs.high_stakes_globs ?? []);
+}
+function inPilot(file, pilot) {
+    if (pilot === undefined)
+        return false;
+    const p = pilot.trim();
+    if (p.length === 0 || p === "." || p === "ALL")
+        return false;
+    // Pilot module is a directory; treat any file under it as in-pilot.
+    return file === p || file.startsWith(`${p}/`);
+}
+function inRoutesOrDtos(file, globs) {
+    const combined = [
+        ...(globs.route_handler_globs ?? []),
+        ...(globs.dto_globs ?? []),
+    ];
+    return matchAnyGlob(file, combined);
+}
+/**
+ * Score a DEC draft. Max 9 / threshold 7→high / 4→medium.
+ */
+export function scoreDecDraft(input) {
+    let score = 0;
+    if (inHighStakes(input.sourceFile, input.globs))
+        score += 3;
+    if (inPilot(input.sourceFile, input.pilotModule))
+        score += 1;
+    if (inRoutesOrDtos(input.sourceFile, input.globs))
+        score += 1;
+    const proseLen = input.prose.trim().length;
+    if (proseLen >= 80 && proseLen <= 800)
+        score += 2;
+    const titleLen = input.title.trim().length;
+    if (titleLen >= 10 && titleLen <= 80)
+        score += 1;
+    if (DECISION_VERBS.test(input.prose))
+        score += 2;
+    if (JSDOC_TAGS.test(input.rawComment))
+        score += 1;
+    if (score >= 7)
+        return "high";
+    if (score >= 4)
+        return "medium";
+    return "low";
+}
+/**
+ * Score an invariant proposal. Max 9 / threshold 7→high / 4→medium.
+ * Stricter than DEC scoring: requires modal verb + reason + high-stakes
+ * location for high confidence, since false-positive invariants become
+ * sensor-sweep noise downstream.
+ */
+export function scoreInvariant(input) {
+    let score = 0;
+    if (inHighStakes(input.sourceFile, input.globs))
+        score += 3;
+    const modalText = `${input.title}\n${input.prose}`;
+    if (INVARIANT_MODALS.test(modalText))
+        score += 3;
+    if (REASON_MARKERS.test(input.prose))
+        score += 2;
+    const proseLen = input.prose.trim().length;
+    if (proseLen >= 50 && proseLen <= 600)
+        score += 1;
+    if (score >= 7)
+        return "high";
+    if (score >= 4)
+        return "medium";
+    return "low";
+}
+//# sourceMappingURL=scoring.js.map

package/dist/attention/scoring.js.map

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

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export declare const VERSION: string;
 export { logger, setLogFile, setLogNull, setLogStderr } from "./logger.js";
 export { withWriteLock, acquireOperationLock, OperationLockHeldError, } from "./lock.js";
 export type { WithLockOptions } from "./lock.js";
+export * from "./attention/index.js";
 export * from "./claude/index.js";
 export * from "./context/index.js";
 export * from "./decision-capture/index.js";

package/dist/index.js

@@ -22,6 +22,7 @@ function readVersion() {
 export const VERSION = readVersion();
 export { logger, setLogFile, setLogNull, setLogStderr } from "./logger.js";
 export { withWriteLock, acquireOperationLock, OperationLockHeldError, } from "./lock.js";
+export * from "./attention/index.js";
 export * from "./claude/index.js";
 export * from "./context/index.js";
 export * from "./decision-capture/index.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,oDAAoD;AACpD,SAAS,WAAW;IAClB,IAAI,OAAO,iBAAiB,KAAK,QAAQ;QAAE,OAAO,iBAAiB,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACrB,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AACD,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,EAAE,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,GAGd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,oDAAoD;AACpD,SAAS,WAAW;IAClB,IAAI,OAAO,iBAAiB,KAAK,QAAQ;QAAE,OAAO,iBAAiB,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACrB,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AACD,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,EAAE,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,GAGd,MAAM,kBAAkB,CAAC"}

package/dist/mcp/tools/bulk-accept-attention.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `cairn_bulk_accept_attention` MCP tool.
+ *
+ * Wraps `bulkAcceptObvious` so the cairn-attention skill can drain
+ * obvious DEC drafts in one tool call instead of N rounds of
+ * `cairn_resolve_attention(choice="a")` per draft. Loads the project
+ * globs + pilot module from `.cairn/config.yaml` so the scoring
+ * heuristic has the same context the cli subcommand does.
+ *
+ * Returns a slim count-distribution shape — no draft bodies, no file
+ * paths beyond the accepted ID list. Skill renders the summary inline,
+ * then proceeds to interactive triage of the remaining (medium + low)
+ * drafts via the existing per-item flow.
+ */
+import { type DraftConfidence } from "../../attention/index.js";
+import type { ToolDef } from "./types.js";
+interface BulkAcceptInput {
+    threshold?: DraftConfidence;
+    dryRun?: boolean;
+}
+export declare const bulkAcceptAttentionTool: ToolDef<BulkAcceptInput>;
+export {};

package/dist/mcp/tools/bulk-accept-attention.js

@@ -0,0 +1,87 @@
+/**
+ * `cairn_bulk_accept_attention` MCP tool.
+ *
+ * Wraps `bulkAcceptObvious` so the cairn-attention skill can drain
+ * obvious DEC drafts in one tool call instead of N rounds of
+ * `cairn_resolve_attention(choice="a")` per draft. Loads the project
+ * globs + pilot module from `.cairn/config.yaml` so the scoring
+ * heuristic has the same context the cli subcommand does.
+ *
+ * Returns a slim count-distribution shape — no draft bodies, no file
+ * paths beyond the accepted ID list. Skill renders the summary inline,
+ * then proceeds to interactive triage of the remaining (medium + low)
+ * drafts via the existing per-item flow.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+import { bulkAcceptObvious, } from "../../attention/index.js";
+const confidenceSchema = z.enum(["high", "medium", "low"]);
+const inputShape = {
+    threshold: confidenceSchema.optional(),
+    dryRun: z.boolean().optional(),
+};
+function loadProjectGlobs(repoRoot) {
+    const configPath = join(repoRoot, ".cairn", "config.yaml");
+    if (!existsSync(configPath)) {
+        return { globs: {} };
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(readFileSync(configPath, "utf8"));
+    }
+    catch {
+        return { globs: {} };
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return { globs: {} };
+    const cfg = parsed;
+    const globs = {};
+    const pickList = (v) => {
+        if (!Array.isArray(v))
+            return undefined;
+        return v.filter((x) => typeof x === "string");
+    };
+    const high = pickList(cfg["high_stakes_globs"]);
+    if (high !== undefined)
+        globs.high_stakes_globs = high;
+    const off = pickList(cfg["off_limits"]);
+    if (off !== undefined)
+        globs.off_limits = off;
+    const projectGlobs = cfg["project_globs"];
+    if (typeof projectGlobs === "object" && projectGlobs !== null) {
+        const pg = projectGlobs;
+        const route = pickList(pg["route_handler_globs"]);
+        if (route !== undefined)
+            globs.route_handler_globs = route;
+        const dto = pickList(pg["dto_globs"]);
+        if (dto !== undefined)
+            globs.dto_globs = dto;
+        const gen = pickList(pg["generator_source_globs"]);
+        if (gen !== undefined)
+            globs.generator_source_globs = gen;
+        const hi = pickList(pg["high_stakes_globs"]);
+        if (hi !== undefined && globs.high_stakes_globs === undefined) {
+            globs.high_stakes_globs = hi;
+        }
+    }
+    const pilot = typeof cfg["pilot_module"] === "string" ? cfg["pilot_module"] : undefined;
+    return pilot !== undefined ? { globs, pilotModule: pilot } : { globs };
+}
+export const bulkAcceptAttentionTool = {
+    name: "cairn_bulk_accept_attention",
+    description: "Score every DEC draft + invariant in `.cairn/ground/decisions/_inbox/` and `.cairn/ground/invariants/` against a confidence heuristic (file in high_stakes_globs / pilot module / route or dto globs, prose substantiveness, decision verbs, JSDoc tags). Auto-promote DEC drafts at or above `threshold` (default 'high') out of the inbox to accepted state and rebuild the decisions ledger. Stamp `capture_confidence` on every draft + invariant so subsequent attention surfaces can sort. Use this once per adoption to drain the obvious classifications before per-item triage. Returns count distributions and the accepted ID list. `dryRun: true` reports the same distribution without writing.",
+    inputSchema: inputShape,
+    handler: async (ctx, input) => {
+        const { globs, pilotModule } = loadProjectGlobs(ctx.repoRoot);
+        return bulkAcceptObvious({
+            repoRoot: ctx.repoRoot,
+            globs,
+            ...(pilotModule !== undefined ? { pilotModule } : {}),
+            threshold: input.threshold ?? "high",
+            ...(input.dryRun !== undefined ? { dryRun: input.dryRun } : {}),
+        });
+    },
+};
+//# sourceMappingURL=bulk-accept-attention.js.map

package/dist/mcp/tools/bulk-accept-attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-accept-attention.js","sourceRoot":"","sources":["../../../src/mcp/tools/bulk-accept-attention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,GAGlB,MAAM,0BAA0B,CAAC;AAKlC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAE3D,MAAM,UAAU,GAAG;IACjB,SAAS,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC;AAOF,SAAS,gBAAgB,CAAC,QAAgB;IAIxC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACxE,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAwB,EAAE;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC7D,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;IACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC;IAC9C,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC9D,MAAM,EAAE,GAAG,YAAuC,CAAC;QACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC;QAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QACtC,IAAI,GAAG,KAAK,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC;QAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACnD,IAAI,GAAG,KAAK,SAAS;YAAE,KAAK,CAAC,sBAAsB,GAAG,GAAG,CAAC;QAC1D,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC7C,IAAI,EAAE,KAAK,SAAS,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAC9D,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GACT,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,cAAc,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,8qBAA8qB;IAChrB,WAAW,EAAE,UAAU;IACvB,OAAO,EAAE,KAAK,EACZ,GAAe,EACf,KAAsB,EACK,EAAE;QAC7B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,iBAAiB,CAAC;YACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,KAAK;YACL,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,MAAM;YACpC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}