forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/propose-session.js

@@ -0,0 +1,333 @@
+/**
+ * propose_session tool handler.
+ *
+ * Produces a pre-implementation impact assessment before generate_session_prompt runs.
+ * Adapted from OpenSpec's Propose phase, extended with forgecraft's layer-awareness.
+ *
+ * Output: which specs will change (ADDED/MODIFIED), which layers are affected,
+ * which gates must pass before close_cycle, and an implementation checklist.
+ * Writes .forgecraft/proposal.md as a persistent artifact.
+ */
+import { z } from "zod";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, } from "node:fs";
+import { join, resolve } from "node:path";
+import { parseUseCases } from "./layer-status.js";
+import { detectClarificationMarkers } from "./session-prompt-builders.js";
+// ── Schema ────────────────────────────────────────────────────────────
+export const proposeSessionSchema = z.object({
+    project_dir: z.string().describe("Absolute path to the project root."),
+    item_description: z
+        .string()
+        .min(10)
+        .optional()
+        .describe("What this session should build or fix. One sentence with actor, behavior, and postcondition."),
+    roadmap_item_id: z
+        .string()
+        .optional()
+        .describe("Roadmap item ID to propose for (e.g. 'RM-001'). Reads title from docs/roadmap.md."),
+});
+// ── Handler ──────────────────────────────────────────────────────────
+export async function proposeSessionHandler(args) {
+    const projectDir = resolve(args.project_dir);
+    let itemDescription = args.item_description;
+    if (!itemDescription && args.roadmap_item_id) {
+        itemDescription =
+            resolveRoadmapTitle(projectDir, args.roadmap_item_id) ?? undefined;
+    }
+    if (!itemDescription) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "## Proposal Blocked\n\nProvide `item_description` or a valid `roadmap_item_id`.",
+                },
+            ],
+        };
+    }
+    const useCases = loadUseCases(projectDir);
+    const relatedUcIds = matchRelatedUcs(itemDescription, useCases);
+    const specDelta = buildSpecDelta(projectDir, itemDescription, relatedUcIds, useCases);
+    const gateRequirements = loadRequiredGates(projectDir);
+    const clarifications = detectClarificationMarkers(projectDir);
+    const layerSummary = buildLayerSummary(projectDir, relatedUcIds, useCases);
+    const checklist = buildChecklist(projectDir, itemDescription, specDelta, relatedUcIds);
+    const proposal = renderProposal({
+        projectDir,
+        itemDescription,
+        specDelta,
+        layerSummary,
+        gateRequirements,
+        clarifications,
+        checklist,
+    });
+    const forgecraftDir = join(projectDir, ".forgecraft");
+    mkdirSync(forgecraftDir, { recursive: true });
+    writeFileSync(join(forgecraftDir, "proposal.md"), proposal, "utf-8");
+    return { content: [{ type: "text", text: proposal }] };
+}
+// ── Use Case Matching ─────────────────────────────────────────────────
+function loadUseCases(projectDir) {
+    const path = join(projectDir, "docs", "use-cases.md");
+    if (!existsSync(path))
+        return [];
+    try {
+        return parseUseCases(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+function matchRelatedUcs(description, ucs) {
+    if (ucs.length === 0)
+        return [];
+    const lower = description.toLowerCase();
+    const words = lower.split(/\s+/).filter((w) => w.length > 3);
+    return ucs
+        .filter((uc) => {
+        const title = uc.title.toLowerCase();
+        return words.some((w) => title.includes(w));
+    })
+        .map((uc) => uc.id);
+}
+// ── Spec Delta ────────────────────────────────────────────────────────
+function buildSpecDelta(projectDir, description, relatedUcIds, ucs) {
+    const deltas = [];
+    // Use cases
+    if (existsSync(join(projectDir, "docs", "use-cases.md"))) {
+        if (relatedUcIds.length > 0) {
+            deltas.push({
+                artifact: "docs/use-cases.md",
+                change: "MODIFIED",
+                reason: `Affects use case(s): ${relatedUcIds.join(", ")}`,
+            });
+        }
+        else if (ucs.length > 0) {
+            deltas.push({
+                artifact: "docs/use-cases.md",
+                change: "MODIFIED",
+                reason: "May require a new use case entry for this session",
+            });
+        }
+    }
+    else {
+        deltas.push({
+            artifact: "docs/use-cases.md",
+            change: "ADDED",
+            reason: "Use cases file does not exist — create before implementing",
+        });
+    }
+    // PRD
+    if (!existsSync(join(projectDir, "docs", "PRD.md"))) {
+        deltas.push({
+            artifact: "docs/PRD.md",
+            change: "ADDED",
+            reason: "Product requirements not found — run setup_project",
+        });
+    }
+    else {
+        deltas.push({
+            artifact: "docs/PRD.md",
+            change: "MODIFIED",
+            reason: "Requirement coverage may need updating after session",
+        });
+    }
+    // ADR — check if a related ADR likely exists
+    const adrHint = needsAdr(description);
+    if (adrHint) {
+        deltas.push({
+            artifact: "docs/adrs/NNNN-<decision-slug>.md",
+            change: "ADDED",
+            reason: adrHint,
+        });
+    }
+    // Session prompt
+    deltas.push({
+        artifact: ".forgecraft/proposal.md",
+        change: "ADDED",
+        reason: "This proposal (written now)",
+    });
+    return deltas;
+}
+function needsAdr(description) {
+    const triggers = [
+        ["database", "DB", "storage", "schema", "migration"],
+        ["auth", "authentication", "authorization", "JWT", "token"],
+        ["api", "endpoint", "REST", "GraphQL", "gRPC"],
+        ["cache", "Redis", "CDN"],
+        ["queue", "event", "message", "Kafka", "SQS"],
+        ["deploy", "infrastructure", "IaC", "container", "Docker", "Kubernetes"],
+    ];
+    const lower = description.toLowerCase();
+    for (const group of triggers) {
+        if (group.some((kw) => lower.includes(kw.toLowerCase()))) {
+            return `Decision involves ${group[0]} — likely needs an ADR before committing`;
+        }
+    }
+    return null;
+}
+// ── Gate Loading ──────────────────────────────────────────────────────
+function loadRequiredGates(projectDir) {
+    const dirs = [
+        join(projectDir, ".forgecraft", "gates", "active"),
+        join(projectDir, ".forgecraft", "gates", "project", "active"),
+    ];
+    const gates = [];
+    for (const dir of dirs) {
+        if (!existsSync(dir))
+            continue;
+        try {
+            for (const f of readdirSync(dir).filter((n) => n.endsWith(".yaml"))) {
+                const gate = parseGateYaml(join(dir, f));
+                if (gate)
+                    gates.push(gate);
+            }
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return gates;
+}
+function parseGateYaml(filePath) {
+    try {
+        const text = readFileSync(filePath, "utf-8");
+        const id = /^id:\s*(.+)$/m.exec(text)?.[1]?.trim() ?? "";
+        const description = /^description:\s*(.+)$/m.exec(text)?.[1]?.trim() ?? "";
+        const priority = /^priority:\s*(.+)$/m.exec(text)?.[1]?.trim() ?? "P2";
+        const layer = /^layer:\s*(.+)$/m.exec(text)?.[1]?.trim() ?? "L1";
+        if (!id)
+            return null;
+        return { gateId: id, description, priority, layer };
+    }
+    catch {
+        return null;
+    }
+}
+function buildLayerSummary(projectDir, relatedUcIds, ucs) {
+    const harnessDir = join(projectDir, "tests", "harness");
+    const envDir = join(projectDir, "tests", "env");
+    const sloDir = join(projectDir, "tests", "slo");
+    const candidates = relatedUcIds.length > 0
+        ? ucs.filter((uc) => relatedUcIds.includes(uc.id))
+        : ucs.slice(0, 5); // show first 5 if no match
+    return candidates.map((uc) => {
+        const lower = uc.id.toLowerCase().replace(/_/g, "-");
+        const l2 = existsSync(harnessDir) &&
+            readdirSync(harnessDir).some((f) => f.toLowerCase().startsWith(lower))
+            ? "✅ probes found"
+            : "❌ no probes";
+        const l3 = existsSync(envDir) &&
+            readdirSync(envDir).some((f) => f.toLowerCase().startsWith(lower))
+            ? "✅ env probes"
+            : "—";
+        const l4 = existsSync(sloDir) &&
+            readdirSync(sloDir).some((f) => f.toLowerCase().startsWith(lower))
+            ? "✅ slo probes"
+            : "—";
+        const l1 = existsSync(join(projectDir, "docs", "use-cases.md"))
+            ? "✅ use case"
+            : "❌ missing";
+        return { ucId: uc.id, title: uc.title, l1, l2, l3, l4 };
+    });
+}
+// ── Checklist ─────────────────────────────────────────────────────────
+function buildChecklist(projectDir, _description, specDelta, relatedUcIds) {
+    const items = [];
+    // Cascade check
+    items.push("Run `check_cascade` — all 5 steps must be complete before starting");
+    // Clarifications
+    items.push("Resolve all `[NEEDS CLARIFICATION]` markers in spec artifacts");
+    // Spec updates
+    const added = specDelta.filter((d) => d.change === "ADDED");
+    if (added.length > 0) {
+        for (const d of added) {
+            items.push(`Create missing artifact: \`${d.artifact}\` — ${d.reason}`);
+        }
+    }
+    // Harness
+    if (relatedUcIds.length > 0) {
+        items.push(`Run \`generate_harness\` for affected use cases: ${relatedUcIds.join(", ")}`);
+        items.push("Implement harness probe TODO sections before closing");
+    }
+    // TDD loop
+    items.push("Write failing probes first, then implement until green");
+    items.push("Run `run_harness` — all L2 probes must pass before `close_cycle`");
+    // Env / infra check
+    if (existsSync(join(projectDir, "tests", "env"))) {
+        items.push("Run `run_env_probe` — L3 env contracts must hold after changes");
+    }
+    // Close
+    items.push("Run `close_cycle` — evaluates all gates and writes `.claude/state.md`");
+    items.push("Update `Status.md` with completed changes and next steps");
+    return items;
+}
+// ── Roadmap Resolution ────────────────────────────────────────────────
+function resolveRoadmapTitle(projectDir, itemId) {
+    const path = join(projectDir, "docs", "roadmap.md");
+    if (!existsSync(path))
+        return null;
+    const text = readFileSync(path, "utf-8");
+    const re = new RegExp(`\\|\\s*${itemId}\\s*\\|[^|]+\\|([^|]+)\\|`);
+    const m = re.exec(text);
+    return m ? (m[1]?.trim() ?? null) : null;
+}
+function renderProposal(input) {
+    const { itemDescription, specDelta, layerSummary, gateRequirements, clarifications, checklist, } = input;
+    const date = new Date().toISOString().slice(0, 10);
+    const lines = [];
+    lines.push(`# Session Proposal`, ``, `**Date:** ${date}`, `**Scope:** ${itemDescription}`, ``);
+    lines.push(`> This proposal is a pre-implementation impact assessment.`);
+    lines.push(`> Resolve all blockers, then run \`generate_session_prompt\` to commit to implementation.`, ``);
+    // Spec delta
+    lines.push(`## Spec Delta`, ``);
+    lines.push(`| Artifact | Change | Reason |`, `|---|---|---|`);
+    for (const d of specDelta) {
+        const badge = d.change === "ADDED"
+            ? "🆕 ADDED"
+            : d.change === "MODIFIED"
+                ? "✏️ MODIFIED"
+                : "🗑 REMOVED";
+        lines.push(`| \`${d.artifact}\` | ${badge} | ${d.reason} |`);
+    }
+    lines.push(``);
+    // Layer readiness
+    if (layerSummary.length > 0) {
+        lines.push(`## Layer Readiness — Affected Use Cases`, ``);
+        lines.push(`| UC | Title | L1 Spec | L2 Probes | L3 Env | L4 SLO |`, `|---|---|---|---|---|---|`);
+        for (const r of layerSummary) {
+            lines.push(`| ${r.ucId} | ${r.title} | ${r.l1} | ${r.l2} | ${r.l3} | ${r.l4} |`);
+        }
+        lines.push(``);
+    }
+    else {
+        lines.push(`## Layer Readiness`, ``, `_No use cases found. Run \`setup_project\` to create the spec foundation._`, ``);
+    }
+    // Clarifications
+    if (clarifications.length > 0) {
+        lines.push(`## ⚠️ Unresolved Clarifications — Must Resolve Before Session`, ``);
+        lines.push(`| File | Marker |`, `|---|---|`);
+        for (const c of clarifications) {
+            lines.push(`| \`${c.file}\` | ${c.marker} |`);
+        }
+        lines.push(``, `Resolve these before running \`generate_session_prompt\`.`, ``);
+    }
+    // Gates
+    if (gateRequirements.length > 0) {
+        lines.push(`## Gates That Must Pass Before \`close_cycle\``, ``);
+        lines.push(`| Gate ID | Layer | Priority | Description |`, `|---|---|---|---|`);
+        for (const g of gateRequirements) {
+            lines.push(`| ${g.gateId} | ${g.layer} | ${g.priority} | ${g.description} |`);
+        }
+        lines.push(``);
+    }
+    // Checklist
+    lines.push(`## Pre-Implementation Checklist`, ``);
+    for (const item of checklist) {
+        lines.push(`- [ ] ${item}`);
+    }
+    lines.push(``);
+    lines.push(`---`);
+    lines.push(`_Proposal written to \`.forgecraft/proposal.md\`. Run \`generate_session_prompt\` when ready to commit._`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=propose-session.js.map

package/dist/tools/propose-session.js.map

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

package/dist/tools/refresh-output.js

@@ -8,20 +8,20 @@ import { writeFileSync, readFileSync, existsSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
 import yaml from "js-yaml";
 // ── Constants ────────────────────────────────────────────────────────
-export const PROJECT_SPECIFIC_PLACEHOLDER = `# Project-Specific Rules
-<!-- This file is owned by YOU. ForgeCraft will never overwrite it. -->
-<!-- Add project-specific rules, framework choices, conventions, and custom corrections here. -->
-<!-- The sentinel CLAUDE.md links here for any AI reading your project. -->
-
-## Framework & Stack Choices
-<!-- e.g. We use Prisma for ORM. Deploy target is Railway. -->
-
-## Custom Corrections
-<!-- Log corrections here so the AI learns from them. -->
-<!-- Format: - YYYY-MM-DD: [description of correction] -->
-
-## Project-Specific Gates
-<!-- Add any quality rules specific to this project that don't belong in universal standards. -->
+export const PROJECT_SPECIFIC_PLACEHOLDER = `# Project-Specific Rules
+<!-- This file is owned by YOU. ForgeCraft will never overwrite it. -->
+<!-- Add project-specific rules, framework choices, conventions, and custom corrections here. -->
+<!-- The sentinel CLAUDE.md links here for any AI reading your project. -->
+
+## Framework & Stack Choices
+<!-- e.g. We use Prisma for ORM. Deploy target is Railway. -->
+
+## Custom Corrections
+<!-- Log corrections here so the AI learns from them. -->
+<!-- Format: - YYYY-MM-DD: [description of correction] -->
+
+## Project-Specific Gates
+<!-- Add any quality rules specific to this project that don't belong in universal standards. -->
 `;
 // ── Project Specific File ────────────────────────────────────────────
 /**

package/dist/tools/review-stubs.d.ts

@@ -0,0 +1,29 @@
+/**
+ * review_stubs tool handler.
+ *
+ * Scans docs/adrs/active/, docs/decisions/, and .claude/standards/ for files
+ * containing unresolved [NEEDS CLARIFICATION] markers. Triages them by priority
+ * so practitioners know what to fill in first.
+ *
+ * Priority:
+ *   high   — ADRs (Retroactive status, most recently dated)
+ *   medium — Decision records with unresolved markers
+ *   low    — CNT leaf nodes with placeholder content
+ *
+ * Idempotent — read-only, no files written.
+ */
+import type { ToolResult } from "../shared/types.js";
+export interface StubFile {
+    readonly relPath: string;
+    readonly type: "adr" | "decision" | "cnt-leaf";
+    readonly status: string | null;
+    readonly date: string | null;
+    readonly markerCount: number;
+    readonly priority: "high" | "medium" | "low";
+    readonly firstLine: string;
+}
+export interface ReviewStubsInput {
+    readonly project_dir: string;
+}
+export declare function reviewStubsHandler(args: ReviewStubsInput): Promise<ToolResult>;
+//# sourceMappingURL=review-stubs.d.ts.map

package/dist/tools/review-stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-stubs.d.ts","sourceRoot":"","sources":["../../src/tools/review-stubs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAwID,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CA+DrB"}

package/dist/tools/review-stubs.js

@@ -0,0 +1,173 @@
+/**
+ * review_stubs tool handler.
+ *
+ * Scans docs/adrs/active/, docs/decisions/, and .claude/standards/ for files
+ * containing unresolved [NEEDS CLARIFICATION] markers. Triages them by priority
+ * so practitioners know what to fill in first.
+ *
+ * Priority:
+ *   high   — ADRs (Retroactive status, most recently dated)
+ *   medium — Decision records with unresolved markers
+ *   low    — CNT leaf nodes with placeholder content
+ *
+ * Idempotent — read-only, no files written.
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const MARKER = "[NEEDS CLARIFICATION]";
+const SCAFFOLD_SENTINEL = "<!-- ForgeCraft sentinel:";
+// ── Scanners ──────────────────────────────────────────────────────────
+function extractStatusLine(content) {
+    const match = /\*\*Status:\*\*\s*(.+)/i.exec(content);
+    return match ? (match[1]?.trim() ?? null) : null;
+}
+function extractDateLine(content) {
+    const match = /\*\*Date:\*\*\s*(\d{4}-\d{2}-\d{2})/i.exec(content);
+    return match ? (match[1] ?? null) : null;
+}
+function countMarkers(content) {
+    let count = 0;
+    let pos = 0;
+    while ((pos = content.indexOf(MARKER, pos)) !== -1) {
+        count++;
+        pos += MARKER.length;
+    }
+    return count;
+}
+function firstHeadingLine(content) {
+    const line = content.split("\n").find((l) => l.startsWith("#"));
+    return line ? line.replace(/^#+\s*/, "").trim() : "(no title)";
+}
+function scanDir(projectDir, relDir, type) {
+    const absDir = join(projectDir, ...relDir.split("/"));
+    if (!existsSync(absDir))
+        return [];
+    const stubs = [];
+    try {
+        for (const filename of readdirSync(absDir)) {
+            if (!filename.endsWith(".md"))
+                continue;
+            const fullPath = join(absDir, filename);
+            let content = "";
+            try {
+                content = readFileSync(fullPath, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            // Skip scaffold-generated files — they're intentionally long
+            if (type === "cnt-leaf" && content.startsWith(SCAFFOLD_SENTINEL))
+                continue;
+            const markerCount = countMarkers(content);
+            const status = extractStatusLine(content);
+            const date = extractDateLine(content);
+            const firstLine = firstHeadingLine(content);
+            // Only include files that have markers OR retroactive ADRs without them
+            const isRetroactive = type === "adr" &&
+                (status?.toLowerCase().includes("retroactive") ?? false);
+            if (markerCount === 0 && !isRetroactive)
+                continue;
+            const priority = derivePriority(type, status, date);
+            stubs.push({
+                relPath: `${relDir}/${filename}`,
+                type,
+                status,
+                date,
+                markerCount,
+                priority,
+                firstLine,
+            });
+        }
+    }
+    catch {
+        // non-throwing
+    }
+    return stubs;
+}
+function derivePriority(type, status, date) {
+    if (type === "adr") {
+        // Recent retroactive ADRs are high priority
+        if (date) {
+            const age = Date.now() - new Date(date).getTime();
+            const ninetyDays = 90 * 24 * 60 * 60 * 1000;
+            return age < ninetyDays ? "high" : "medium";
+        }
+        return status?.toLowerCase().includes("retroactive") ? "medium" : "high";
+    }
+    if (type === "decision")
+        return "medium";
+    return "low";
+}
+// ── Formatter ─────────────────────────────────────────────────────────
+function renderGroup(label, stubs, lines) {
+    if (stubs.length === 0)
+        return;
+    lines.push(`### ${label}`, "");
+    for (const s of stubs) {
+        const markerNote = s.markerCount > 0 ? `${s.markerCount} marker(s)` : "no markers";
+        const statusNote = s.status ? ` [${s.status}]` : "";
+        lines.push(`- \`${s.relPath}\`${statusNote} — ${markerNote}`);
+        lines.push(`  > ${s.firstLine}`);
+        if (s.type === "adr") {
+            if (s.markerCount > 0) {
+                lines.push("  > Fill Context / Decision / Alternatives / Consequences, then change Status to `Accepted`.");
+            }
+            else {
+                lines.push("  > Retroactive ADR with no markers — verify the decision is still in force and set Status to `Accepted` or `Superseded`.");
+            }
+        }
+        else if (s.type === "decision") {
+            lines.push("  > Fill Trigger / Root Cause / Fix / Regression Test.");
+        }
+        else {
+            lines.push("  > Expand this leaf node or remove the placeholder if the domain is not yet relevant.");
+        }
+    }
+    lines.push("");
+}
+// ── Handler ───────────────────────────────────────────────────────────
+export async function reviewStubsHandler(args) {
+    const projectDir = args.project_dir;
+    const adrStubs = scanDir(projectDir, "docs/adrs/active", "adr");
+    const legacyAdrStubs = existsSync(join(projectDir, "docs", "adrs", "active"))
+        ? []
+        : scanDir(projectDir, "docs/adrs", "adr");
+    const allAdrStubs = [...adrStubs, ...legacyAdrStubs];
+    const decisionStubs = scanDir(projectDir, "docs/decisions", "decision");
+    const cntStubs = scanDir(projectDir, "docs/decisions", "cnt-leaf").concat(scanDir(projectDir, ".claude/standards", "cnt-leaf"));
+    const allStubs = [...allAdrStubs, ...decisionStubs, ...cntStubs];
+    if (allStubs.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        "## Stub Triage",
+                        "",
+                        "No unresolved stubs found. All ADRs, decisions, and CNT leaves are either filled in or absent.",
+                        "",
+                        "If you recently ran `extract_adrs_from_history`, stubs may have been placed in `docs/adrs/` — check there if this seems wrong.",
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    const high = allStubs.filter((s) => s.priority === "high");
+    const medium = allStubs.filter((s) => s.priority === "medium");
+    const low = allStubs.filter((s) => s.priority === "low");
+    const totalMarkers = allStubs.reduce((sum, s) => sum + s.markerCount, 0);
+    const lines = [
+        "## Stub Triage",
+        "",
+        `Found **${allStubs.length}** stub file(s) with **${totalMarkers}** unresolved marker(s).`,
+        "",
+        "Work through these in order. Each resolved stub improves your **Auditable** GS property score.",
+        "",
+    ];
+    renderGroup("High Priority — fill these first", high, lines);
+    renderGroup("Medium Priority", medium, lines);
+    renderGroup("Low Priority (CNT leaf nodes)", low, lines);
+    lines.push("### How to prioritize", "", "1. **Still in force** — fill Context/Decision/Alternatives, change Status → `Accepted`", "2. **Since superseded** — record briefly, mark `Superseded by ADR-XXXX`", "3. **Not a real decision** — delete the stub", "", "Once all stubs are resolved, re-run `audit` — the Auditable property score will improve.");
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+}
+//# sourceMappingURL=review-stubs.js.map

package/dist/tools/review-stubs.js.map

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