forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/check-t4.js

@@ -0,0 +1,305 @@
+/**
+ * check_t4 tool handler.
+ *
+ * Surfaces pending T4 production signals at session start. Reads
+ * .forgecraft/t4-signals.json written by forgecraft-eye, formats each
+ * signal as a spec update candidate, and guides the practitioner through
+ * the diagnosis → spec update → rederivation cycle.
+ *
+ * Run at the start of any development session to check whether production
+ * has produced specification-level diagnoses since the last session.
+ */
+import { z } from "zod";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+// ── Schema ───────────────────────────────────────────────────────────
+export const checkT4Schema = z.object({
+    project_dir: z.string().describe("Absolute path to the project root."),
+    acknowledge: z
+        .string()
+        .optional()
+        .describe("Signal ID to mark as acknowledged (e.g., 'sig-20260424-143022-001')."),
+    resolve: z
+        .string()
+        .optional()
+        .describe("Signal ID to mark as resolved (spec update applied and deployed)."),
+    show_resolved: z
+        .boolean()
+        .optional()
+        .describe("Include resolved signals in output. Default: false."),
+});
+// ── Queue helpers ─────────────────────────────────────────────────────
+function queuePath(projectDir) {
+    return join(projectDir, ".forgecraft", "t4-signals.json");
+}
+function readQueue(projectDir) {
+    const path = queuePath(projectDir);
+    if (!existsSync(path))
+        return { signals: [] };
+    try {
+        const raw = readFileSync(path, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return { signals: [] };
+    }
+}
+function writeQueue(projectDir, queue) {
+    const path = queuePath(projectDir);
+    const updated = {
+        ...queue,
+        last_updated: new Date().toISOString(),
+    };
+    writeFileSync(path, JSON.stringify(updated, null, 2), "utf-8");
+}
+// ── Formatters ────────────────────────────────────────────────────────
+function severityIcon(severity) {
+    switch (severity) {
+        case "critical":
+            return "🔴";
+        case "warning":
+            return "🟡";
+        case "info":
+            return "🔵";
+    }
+}
+function statusIcon(status) {
+    switch (status) {
+        case "pending":
+            return "⏳ pending";
+        case "acknowledged":
+            return "👁 acknowledged";
+        case "resolved":
+            return "✅ resolved";
+    }
+}
+function isGitHubIssueSignal(signal) {
+    return (signal.environment === "github" &&
+        typeof signal.correlation_id === "string" &&
+        signal.correlation_id.startsWith("gh-issue-#"));
+}
+function githubIssueUrl(signal) {
+    if (!isGitHubIssueSignal(signal) ||
+        !signal.service ||
+        !signal.correlation_id) {
+        return undefined;
+    }
+    const num = signal.correlation_id.replace(/^gh-issue-#/, "");
+    return `https://github.com/${signal.service}/issues/${num}`;
+}
+function formatSignal(signal, index) {
+    const isIssue = isGitHubIssueSignal(signal);
+    const heading = isIssue
+        ? `### Issue ${index + 1}: ${severityIcon(signal.severity)} ${signal.exception_class} (${signal.correlation_id})`
+        : `### Signal ${index + 1}: ${severityIcon(signal.severity)} ${signal.exception_class}`;
+    const lines = [
+        heading,
+        "",
+        `**ID:** \`${signal.id}\`  **Status:** ${statusIcon(signal.status)}`,
+        `**Timestamp:** ${signal.timestamp}${signal.service ? `  **Service:** ${signal.service}` : ""}`,
+        "",
+    ];
+    if (isIssue) {
+        const url = githubIssueUrl(signal);
+        if (url)
+            lines.push(`**Issue URL:** ${url}`, "");
+        lines.push("**Source:** Human-filed GitHub issue (treat as authoritative).", "**Protocol:** Follow the BIOISO branch convention in `CLAUDE.md` —", "create `bioiso/gen{N}/{domain}-{description}`, fix, PR, link to issue.", "");
+    }
+    else {
+        lines.push(`**GS Property Violated:** ${signal.gs_property}`, `**Spec Location:** \`${signal.spec_ref}\``, "");
+    }
+    lines.push("**Diagnosis:**", `> ${signal.diagnosis}`, "", "**Suggested Spec Update:**", `> ${signal.suggested_update}`, "");
+    if (!isIssue && signal.correlation_id) {
+        lines.push(`**Correlation ID:** \`${signal.correlation_id}\``, "");
+    }
+    if (signal.status === "pending") {
+        lines.push("**Actions:**", `- To acknowledge: \`forgecraft check_t4 acknowledge="${signal.id}"\``, `- To resolve after ${isIssue ? "PR merged + deployed" : "spec update"}: \`forgecraft check_t4 resolve="${signal.id}"\``, "");
+    }
+    lines.push("---", "");
+    return lines;
+}
+function buildChronicleQuery(projectName) {
+    return [
+        "## Chronicle Query (if configured)",
+        "",
+        "If forgecraft-eye is writing to Chronicle, retrieve signals with:",
+        "```",
+        "chronicle recall",
+        `  query: "t4 signal specification violation"`,
+        `  tags: ["t4-signal", "${projectName}"]`,
+        '  memory_types: ["architectural"]',
+        '  tiers: ["core"]',
+        "```",
+        "",
+    ].join("\n");
+}
+// ── Handler ───────────────────────────────────────────────────────────
+export async function checkT4Handler(args) {
+    const projectDir = resolve(args.project_dir);
+    const showResolved = args.show_resolved ?? false;
+    const queue = readQueue(projectDir);
+    const projectName = projectDir.split(/[\\/]/).pop() ?? "project";
+    // Handle acknowledge action
+    if (args.acknowledge) {
+        const signal = queue.signals.find((s) => s.id === args.acknowledge);
+        if (!signal) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Signal \`${args.acknowledge}\` not found in queue.`,
+                    },
+                ],
+            };
+        }
+        signal.status = "acknowledged";
+        signal.acknowledged_at = new Date().toISOString();
+        writeQueue(projectDir, queue);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `✅ Signal \`${args.acknowledge}\` marked as acknowledged.`,
+                        "",
+                        "The diagnosis is noted. After updating the specification and redeploying:",
+                        `\`forgecraft check_t4 resolve="${args.acknowledge}"\``,
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    // Handle resolve action
+    if (args.resolve) {
+        const signal = queue.signals.find((s) => s.id === args.resolve);
+        if (!signal) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Signal \`${args.resolve}\` not found in queue.`,
+                    },
+                ],
+            };
+        }
+        signal.status = "resolved";
+        signal.resolved_at = new Date().toISOString();
+        writeQueue(projectDir, queue);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `✅ Signal \`${args.resolve}\` marked as resolved.`,
+                        "",
+                        "The T4 loop is complete for this signal:",
+                        "production exception → spec diagnosis → spec update → rederivation → verified deployment.",
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    // No queue file at all
+    if (!existsSync(queuePath(projectDir))) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        "## T4 Signal Check",
+                        "",
+                        "No signal queue found at `.forgecraft/t4-signals.json`.",
+                        "",
+                        "This means either:",
+                        "- forgecraft-eye has not yet been deployed to production",
+                        "- No qualifying exceptions have fired since deployment",
+                        "- The queue was already cleared",
+                        "",
+                        "## Setup forgecraft-eye",
+                        "",
+                        "1. Generate the monitoring contract and eye config:",
+                        "   ```",
+                        "   forgecraft setup_monitoring",
+                        "   ```",
+                        "",
+                        "2. Install the diagnostic agent:",
+                        "   ```bash",
+                        "   npm install forgecraft-eye",
+                        "   ```",
+                        "",
+                        "3. Pipe production logs through it:",
+                        "   ```bash",
+                        "   my-service 2>&1 | npx forgecraft-eye",
+                        "   ```",
+                        "   Or use programmatically:",
+                        "   ```typescript",
+                        "   import { runEyeFromConfig } from 'forgecraft-eye';",
+                        "   await runEyeFromConfig(projectDir);",
+                        "   ```",
+                        "",
+                        "4. Signals are written to `.forgecraft/t4-signals.json`.",
+                        "   Run `forgecraft check_t4` at the next session start.",
+                        "",
+                        "npm: https://www.npmjs.com/package/forgecraft-eye",
+                        "Source: https://github.com/jghiringhelli/forgecraft-eye",
+                        "",
+                        buildChronicleQuery(projectName),
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    const visibleSignals = showResolved
+        ? queue.signals
+        : queue.signals.filter((s) => s.status !== "resolved");
+    const pending = queue.signals.filter((s) => s.status === "pending");
+    const acknowledged = queue.signals.filter((s) => s.status === "acknowledged");
+    const resolved = queue.signals.filter((s) => s.status === "resolved");
+    const critical = pending.filter((s) => s.severity === "critical");
+    const lines = [
+        "## T4 Signal Check",
+        "",
+        `**Queue:** ${pending.length} pending / ${acknowledged.length} acknowledged / ${resolved.length} resolved`,
+    ];
+    if (queue.last_updated) {
+        lines.push(`**Last updated:** ${queue.last_updated}`);
+    }
+    lines.push("");
+    if (critical.length > 0) {
+        lines.push(`> 🔴 **${critical.length} critical signal${critical.length === 1 ? "" : "s"} require immediate spec attention.**`, "");
+    }
+    if (visibleSignals.length === 0) {
+        lines.push("No pending signals. Production is behaving within specification.", "", resolved.length > 0
+            ? `(${resolved.length} resolved signals hidden. Pass \`show_resolved: true\` to display.)`
+            : "");
+    }
+    else {
+        lines.push("The following production signals require specification updates.", "Each signal represents a gap in the specification — not a code bug.", "Update the spec first; the AI derives the fix.", "");
+        for (const [i, signal] of visibleSignals.entries()) {
+            lines.push(...formatSignal(signal, i));
+        }
+    }
+    // Monitoring spec status
+    const monitoringSpecPath = join(projectDir, "docs", "monitoring-spec.md");
+    if (!existsSync(monitoringSpecPath)) {
+        lines.push("---", "", "⚠️  `docs/monitoring-spec.md` not found.", "Run `forgecraft setup_monitoring` to generate the production contract.", "");
+    }
+    lines.push(buildChronicleQuery(projectName));
+    // Cycle guidance if signals present
+    if (pending.length > 0) {
+        const pendingIssues = pending.filter(isGitHubIssueSignal);
+        const pendingRuntime = pending.filter((s) => !isGitHubIssueSignal(s));
+        if (pendingRuntime.length > 0) {
+            lines.push("## The T4 → T1 Cycle (runtime signals)", "", "For each pending runtime signal:", "1. Read the diagnosis and suggested spec update above", "2. Open the referenced spec file (`spec_ref`) and apply the update", "3. Run `forgecraft generate_session_prompt` to derive the fix from the updated spec", "4. Let the AI derive the code change — do not patch directly", "5. Run the harness: `forgecraft run_harness`", '6. Deploy and verify the T4 loop closed: `forgecraft check_t4 resolve="<id>"`', "");
+        }
+        if (pendingIssues.length > 0) {
+            lines.push("## BIOISO Issue Workflow (GitHub issue signals)", "", "Issue signals come from human-filed GitHub issues — treat as authoritative.", "For each pending issue signal:", "1. Read the issue (URL above) for full reproduction context", "2. Open the referenced files in the issue body — verify against current code", "3. Create a branch following the BIOISO convention: `bioiso/gen{N}/{domain}-{description}`", "4. Apply the fix; run the project's test suite + type check", "5. Open a PR linking the issue (`Closes #N`); wait for human review", '6. After merge + deploy: `forgecraft check_t4 resolve="<id>"`', "", "Cross-reference: `CLAUDE.md` *Invellum BIOISO Protocol* section (or your project's equivalent).");
+        }
+    }
+    return {
+        content: [
+            { type: "text", text: lines.filter((l) => l !== undefined).join("\n") },
+        ],
+    };
+}
+//# sourceMappingURL=check-t4.js.map

package/dist/tools/check-t4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-t4.js","sourceRoot":"","sources":["../../src/tools/check-t4.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,wEAAwE;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACtE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE,CACvE;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mEAAmE,CACpE;IACH,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC,CAAC;AA+BH,yEAAyE;AAEzE,SAAS,SAAS,CAAC,UAAkB;IACnC,OAAO,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,SAAS,CAAC,UAAkB;IACnC,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB,EAAE,KAAoB;IAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,OAAO,GAAkB;QAC7B,GAAG,KAAK;QACR,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACvC,CAAC;IACF,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,yEAAyE;AAEzE,SAAS,YAAY,CAAC,QAAwB;IAC5C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,IAAI,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,MAAoB;IACtC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;QACrB,KAAK,cAAc;YACjB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,YAAY,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAgB;IAC3C,OAAO,CACL,MAAM,CAAC,WAAW,KAAK,QAAQ;QAC/B,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;QACzC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,YAAY,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAAgB;IACtC,IACE,CAAC,mBAAmB,CAAC,MAAM,CAAC;QAC5B,CAAC,MAAM,CAAC,OAAO;QACf,CAAC,MAAM,CAAC,cAAc,EACtB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO,sBAAsB,MAAM,CAAC,OAAO,WAAW,GAAG,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,YAAY,CAAC,MAAgB,EAAE,KAAa;IACnD,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO;QACrB,CAAC,CAAC,aAAa,KAAK,GAAG,CAAC,KAAK,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,eAAe,KAAK,MAAM,CAAC,cAAc,GAAG;QACjH,CAAC,CAAC,cAAc,KAAK,GAAG,CAAC,KAAK,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;IAE1F,MAAM,KAAK,GAAa;QACtB,OAAO;QACP,EAAE;QACF,aAAa,MAAM,CAAC,EAAE,mBAAmB,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;QACpE,kBAAkB,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/F,EAAE;KACH,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CACR,gEAAgE,EAChE,oEAAoE,EACpE,wEAAwE,EACxE,EAAE,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,6BAA6B,MAAM,CAAC,WAAW,EAAE,EACjD,wBAAwB,MAAM,CAAC,QAAQ,IAAI,EAC3C,EAAE,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CACR,gBAAgB,EAChB,KAAK,MAAM,CAAC,SAAS,EAAE,EACvB,EAAE,EACF,4BAA4B,EAC5B,KAAK,MAAM,CAAC,gBAAgB,EAAE,EAC9B,EAAE,CACH,CAAC;IAEF,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,yBAAyB,MAAM,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CACR,cAAc,EACd,wDAAwD,MAAM,CAAC,EAAE,KAAK,EACtE,sBAAsB,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,aAAa,oCAAoC,MAAM,CAAC,EAAE,KAAK,EACxH,EAAE,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAmB;IAC9C,OAAO;QACL,oCAAoC;QACpC,EAAE;QACF,mEAAmE;QACnE,KAAK;QACL,kBAAkB;QAClB,8CAA8C;QAC9C,0BAA0B,WAAW,IAAI;QACzC,mCAAmC;QACnC,mBAAmB;QACnB,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,yEAAyE;AAEzE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAkB;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC;IAEjD,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;IAEjE,4BAA4B;IAC5B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY,IAAI,CAAC,WAAW,wBAAwB;qBAC3D;iBACF;aACF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC;QAC/B,MAAM,CAAC,eAAe,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAClD,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,cAAc,IAAI,CAAC,WAAW,4BAA4B;wBAC1D,EAAE;wBACF,2EAA2E;wBAC3E,kCAAkC,IAAI,CAAC,WAAW,KAAK;qBACxD,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY,IAAI,CAAC,OAAO,wBAAwB;qBACvD;iBACF;aACF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC;QAC3B,MAAM,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,cAAc,IAAI,CAAC,OAAO,wBAAwB;wBAClD,EAAE;wBACF,0CAA0C;wBAC1C,2FAA2F;qBAC5F,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,oBAAoB;wBACpB,EAAE;wBACF,yDAAyD;wBACzD,EAAE;wBACF,oBAAoB;wBACpB,0DAA0D;wBAC1D,wDAAwD;wBACxD,iCAAiC;wBACjC,EAAE;wBACF,yBAAyB;wBACzB,EAAE;wBACF,qDAAqD;wBACrD,QAAQ;wBACR,gCAAgC;wBAChC,QAAQ;wBACR,EAAE;wBACF,kCAAkC;wBAClC,YAAY;wBACZ,+BAA+B;wBAC/B,QAAQ;wBACR,EAAE;wBACF,qCAAqC;wBACrC,YAAY;wBACZ,yCAAyC;wBACzC,QAAQ;wBACR,6BAA6B;wBAC7B,kBAAkB;wBAClB,uDAAuD;wBACvD,wCAAwC;wBACxC,QAAQ;wBACR,EAAE;wBACF,0DAA0D;wBAC1D,yDAAyD;wBACzD,EAAE;wBACF,mDAAmD;wBACnD,yDAAyD;wBACzD,EAAE;wBACF,mBAAmB,CAAC,WAAW,CAAC;qBACjC,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,YAAY;QACjC,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;IAElE,MAAM,KAAK,GAAa;QACtB,oBAAoB;QACpB,EAAE;QACF,cAAc,OAAO,CAAC,MAAM,cAAc,YAAY,CAAC,MAAM,mBAAmB,QAAQ,CAAC,MAAM,WAAW;KAC3G,CAAC;IAEF,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,UAAU,QAAQ,CAAC,MAAM,mBAAmB,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,sCAAsC,EAClH,EAAE,CACH,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CACR,kEAAkE,EAClE,EAAE,EACF,QAAQ,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,qEAAqE;YAC1F,CAAC,CAAC,EAAE,CACP,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,iEAAiE,EACjE,qEAAqE,EACrE,gDAAgD,EAChD,EAAE,CACH,CAAC;QAEF,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC1E,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CACR,KAAK,EACL,EAAE,EACF,0CAA0C,EAC1C,wEAAwE,EACxE,EAAE,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAAC;IAE7C,oCAAoC;IACpC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CACR,wCAAwC,EACxC,EAAE,EACF,kCAAkC,EAClC,uDAAuD,EACvD,oEAAoE,EACpE,qFAAqF,EACrF,8DAA8D,EAC9D,8CAA8C,EAC9C,+EAA+E,EAC/E,EAAE,CACH,CAAC;QACJ,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CACR,iDAAiD,EACjD,EAAE,EACF,6EAA6E,EAC7E,gCAAgC,EAChC,6DAA6D,EAC7D,8EAA8E,EAC9E,4FAA4F,EAC5F,6DAA6D,EAC7D,qEAAqE,EACrE,+DAA+D,EAC/D,EAAE,EACF,iGAAiG,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACxE;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/close-cycle.d.ts

@@ -18,6 +18,17 @@ export { suggestVersionBump, appendChangelogEntry, readCommitsSinceLastTag, } fr
  * @returns Structured result with cascade status, gate promotion details, and next steps
  */
 export declare function closeCycle(options: import("./close-cycle-helpers.js").CloseCycleOptions): Promise<import("./close-cycle-helpers.js").CloseCycleResult>;
+/**
+ * Return warning-severity gate IDs that should be promoted to error severity
+ * now that the project has a clean cascade baseline.
+ *
+ * Only returns candidates when forgecraft.yaml has `brownfield: true`.
+ * Called after a successful close_cycle to surface the ramp opportunity.
+ *
+ * @param projectRoot - Absolute path to project root
+ * @returns Gate IDs at severity: warning
+ */
+export declare function detectSeverityRampCandidates(projectRoot: string): string[];
 /**
  * MCP handler for the close_cycle action.
  *

package/dist/tools/close-cycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close-cycle.d.ts","sourceRoot":"","sources":["../../src/tools/close-cycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAIrC;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,GAC5D,OAAO,CAAC,OAAO,0BAA0B,EAAE,gBAAgB,CAAC,CAkK9D;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAwB7D"}
+{"version":3,"file":"close-cycle.d.ts","sourceRoot":"","sources":["../../src/tools/close-cycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoCH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAIrC;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,GAC5D,OAAO,CAAC,OAAO,0BAA0B,EAAE,gBAAgB,CAAC,CA4L9D;AA6ZD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAK1E;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA4D7D"}