forgecraft-mcp 1.3.2 → 1.6.1

package/dist/tools/consolidate-status.js

@@ -0,0 +1,356 @@
+/**
+ * consolidate_status tool.
+ *
+ * Produces a compact, structured project state snapshot — cascade score,
+ * roadmap progress, recent git activity, and Status.md summary — in one call.
+ * Closes the session drift gap: every session prompt starts with current state
+ * rather than stale spec state.
+ */
+import { z } from "zod";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { execSync } from "node:child_process";
+import { runCascadeChecks, loadCascadeDecisions } from "./check-cascade.js";
+import { parseRoadmapItems, findNextRoadmapItem, deriveTestCommand, } from "./close-cycle.js";
+import { buildGateViolationReport } from "./gate-violations.js";
+import { buildLayerReport } from "./layer-status.js";
+// ── Schema ───────────────────────────────────────────────────────────
+export const consolidateStatusSchema = z.object({
+    project_dir: z.string().describe("Absolute path to the project root."),
+});
+// ── Handler ───────────────────────────────────────────────────────────
+/**
+ * Produce a live project state snapshot and return it as a text block.
+ *
+ * @param args - Validated input
+ * @returns MCP-style tool result with formatted snapshot text
+ */
+export async function consolidateStatusHandler(args) {
+    const projectDir = resolve(args.project_dir);
+    const snapshot = buildConsolidatedStatus(projectDir);
+    return {
+        content: [{ type: "text", text: formatConsolidatedStatus(snapshot) }],
+    };
+}
+// ── Core builder ──────────────────────────────────────────────────────
+/**
+ * Build a ConsolidatedStatus snapshot from the project directory.
+ * All reads are non-throwing — missing artifacts produce empty/null fields.
+ *
+ * @param projectDir - Absolute path to project root
+ * @returns Structured project state snapshot
+ */
+export function buildConsolidatedStatus(projectDir) {
+    const violationReport = buildGateViolationReport(projectDir);
+    const harnessData = readHarnessData(projectDir);
+    const envProbeData = readProbeRunData(projectDir, "env-probe-run.json");
+    const sloProbeData = readProbeRunData(projectDir, "slo-probe-run.json");
+    return {
+        generatedAt: new Date().toISOString(),
+        ...readCascadeStatus(projectDir),
+        roadmap: readRoadmapProgress(projectDir),
+        recentCommits: readRecentCommits(projectDir, 5),
+        uncommittedFiles: readUncommittedFiles(projectDir, 10),
+        testCommand: deriveTestCommand(projectDir) ?? null,
+        activeViolationCount: violationReport.active.length,
+        activeViolationSummary: violationReport.active.map((v) => `${v.hook}: ${v.message}`),
+        statusSummary: readStatusTail(projectDir),
+        layerSummary: readLayerSummary(projectDir),
+        harnessLastRun: harnessData.lastRun,
+        harnessPassed: harnessData.passed,
+        harnessTotal: harnessData.total,
+        envProbeLastRun: envProbeData.lastRun,
+        envProbePassed: envProbeData.passed,
+        envProbeTotal: envProbeData.total,
+        sloProbeLastRun: sloProbeData.lastRun,
+        sloProbePassed: sloProbeData.passed,
+        sloProbeTotal: sloProbeData.total,
+    };
+}
+// ── Section readers ───────────────────────────────────────────────────
+/**
+ * Read cascade pass/fail status from the project.
+ * Returns unconfigured (required: 0) when no forgecraft.yaml is present.
+ * SKIP steps are treated as optional (not counted in required total).
+ */
+function readCascadeStatus(projectDir) {
+    const yamlPath = join(projectDir, "forgecraft.yaml");
+    if (!existsSync(yamlPath)) {
+        return { cascadeScore: { passing: 0, required: 0 }, cascadeLines: [] };
+    }
+    try {
+        const decisions = loadCascadeDecisions(projectDir);
+        const steps = runCascadeChecks(projectDir, decisions);
+        // SKIP status means the step was explicitly marked non-required via a decision.
+        const requiredSteps = steps.filter((s) => s.status !== "SKIP");
+        const passing = requiredSteps.filter((s) => s.status === "PASS").length;
+        const cascadeLines = steps.map((s) => {
+            const isOptional = s.status === "SKIP";
+            const icon = s.status === "PASS" ? "✅" : isOptional ? "⚠️ " : "❌";
+            const suffix = isOptional ? " (optional)" : "";
+            return `${icon} ${s.name}${suffix}`;
+        });
+        return {
+            cascadeScore: { passing, required: requiredSteps.length },
+            cascadeLines,
+        };
+    }
+    catch {
+        return { cascadeScore: { passing: 0, required: 0 }, cascadeLines: [] };
+    }
+}
+/**
+ * Read roadmap progress: total items, done count, next unblocked item.
+ */
+function readRoadmapProgress(projectDir) {
+    const roadmapPath = join(projectDir, "docs", "roadmap.md");
+    if (!existsSync(roadmapPath))
+        return null;
+    try {
+        const content = readFileSync(roadmapPath, "utf-8");
+        const items = parseRoadmapItems(content);
+        if (items.length === 0)
+            return null;
+        const done = items.filter((i) => i.status === "done").length;
+        const next = findNextRoadmapItem(projectDir);
+        return {
+            total: items.length,
+            done,
+            nextId: next?.id ?? null,
+            nextTitle: next?.title ?? null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the last N git commit subjects from the project directory.
+ * Returns empty array when git is unavailable or directory is not a repo.
+ */
+export function readRecentCommits(projectDir, count) {
+    if (!existsSync(join(projectDir, ".git")))
+        return [];
+    try {
+        const raw = execSync(`git log --oneline -${count}`, {
+            cwd: projectDir,
+            stdio: ["pipe", "pipe", "pipe"],
+        })
+            .toString()
+            .trim();
+        return raw.length === 0
+            ? []
+            : raw
+                .split("\n")
+                .map((l) => l.trim())
+                .filter((l) => l.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read uncommitted changed files (staged + unstaged), up to maxFiles.
+ * Returns empty array when git is unavailable.
+ */
+export function readUncommittedFiles(projectDir, maxFiles) {
+    if (!existsSync(join(projectDir, ".git")))
+        return [];
+    try {
+        const raw = execSync("git status --porcelain", {
+            cwd: projectDir,
+            stdio: ["pipe", "pipe", "pipe"],
+        })
+            .toString()
+            .trim();
+        if (raw.length === 0)
+            return [];
+        return raw
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0)
+            .slice(0, maxFiles);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read the tail of Status.md, truncated to the last 600 characters.
+ */
+function readStatusTail(projectDir) {
+    const statusPath = join(projectDir, "Status.md");
+    if (!existsSync(statusPath))
+        return "(not found)";
+    try {
+        const content = readFileSync(statusPath, "utf-8");
+        return content.length > 600 ? `…\n${content.slice(-600)}` : content;
+    }
+    catch {
+        return "(unreadable)";
+    }
+}
+/**
+ * Read harness-run.json for the last run timestamp, passed count, and total results.
+ * Non-throwing — returns zeroed values when file is absent or unparseable.
+ */
+function readHarnessData(projectDir) {
+    const runJsonPath = join(projectDir, ".forgecraft", "harness-run.json");
+    if (!existsSync(runJsonPath))
+        return { lastRun: null, passed: 0, total: 0 };
+    try {
+        const raw = readFileSync(runJsonPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        const passed = parsed.passed ?? 0;
+        const total = (parsed.passed ?? 0) +
+            (parsed.failed ?? 0) +
+            (parsed.errors ?? 0) +
+            (parsed.notFound ?? 0);
+        return { lastRun: parsed.timestamp ?? null, passed, total };
+    }
+    catch {
+        return { lastRun: null, passed: 0, total: 0 };
+    }
+}
+/**
+ * Read a probe run JSON file (env-probe-run.json or slo-probe-run.json) from .forgecraft/.
+ * Non-throwing — returns zeroed values when file is absent or unparseable.
+ */
+function readProbeRunData(projectDir, fileName) {
+    const runJsonPath = join(projectDir, ".forgecraft", fileName);
+    if (!existsSync(runJsonPath))
+        return { lastRun: null, passed: 0, total: 0 };
+    try {
+        const raw = readFileSync(runJsonPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        const passed = parsed.passed ?? 0;
+        const total = (parsed.passed ?? 0) + (parsed.failed ?? 0);
+        return { lastRun: parsed.timestamp ?? null, passed, total };
+    }
+    catch {
+        return { lastRun: null, passed: 0, total: 0 };
+    }
+}
+/**
+ * Read layer completion summary from the project.
+ * Returns null when docs/use-cases.md is absent.
+ */
+function readLayerSummary(projectDir) {
+    try {
+        const report = buildLayerReport(projectDir);
+        if (report.ucs.length === 0)
+            return null;
+        const l2Passing = report.l2.filter((u) => u.hasProbe).length;
+        return {
+            l1: { passing: report.ucs.length, total: report.ucs.length },
+            l2: { passing: l2Passing, total: report.ucs.length },
+            l3: report.l3,
+            l4: report.l4,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ── Formatter ─────────────────────────────────────────────────────────
+/**
+ * Format a ConsolidatedStatus snapshot as a human-readable markdown block.
+ *
+ * @param snapshot - The structured snapshot to format
+ * @returns Formatted markdown text
+ */
+export function formatConsolidatedStatus(snapshot) {
+    const lines = [
+        "## Project Status Snapshot",
+        `_Generated: ${snapshot.generatedAt}_`,
+        "",
+    ];
+    // Cascade
+    const { passing, required } = snapshot.cascadeScore;
+    const cascadeLabel = required === 0 ? "unconfigured" : `${passing}/${required} required`;
+    lines.push(`### Cascade: ${cascadeLabel}`);
+    for (const line of snapshot.cascadeLines) {
+        lines.push(`- ${line}`);
+    }
+    lines.push("");
+    // Roadmap
+    if (snapshot.roadmap) {
+        const { done, total, nextId, nextTitle } = snapshot.roadmap;
+        lines.push(`### Roadmap: ${done}/${total} done`);
+        if (nextId && nextTitle) {
+            lines.push(`Next: **${nextId}** — ${nextTitle}`);
+        }
+        else if (done === total) {
+            lines.push("All items complete — ready for hardening.");
+        }
+        else {
+            lines.push("No unblocked items — check dependencies.");
+        }
+        lines.push("");
+    }
+    // Recent commits
+    if (snapshot.recentCommits.length > 0) {
+        lines.push("### Recent commits");
+        for (const commit of snapshot.recentCommits) {
+            lines.push(`- ${commit}`);
+        }
+        lines.push("");
+    }
+    // Uncommitted changes
+    if (snapshot.uncommittedFiles.length > 0) {
+        lines.push("### Uncommitted changes");
+        for (const file of snapshot.uncommittedFiles) {
+            lines.push(`- ${file}`);
+        }
+        lines.push("");
+    }
+    // Test command
+    if (snapshot.testCommand) {
+        lines.push(`### Test command: \`${snapshot.testCommand}\``);
+        lines.push("");
+    }
+    // Gate violations
+    if (snapshot.activeViolationCount > 0) {
+        lines.push(`### ⚠️ Gate Violations: ${snapshot.activeViolationCount} active`);
+        for (const summary of snapshot.activeViolationSummary) {
+            lines.push(`- ${summary}`);
+        }
+        lines.push("");
+    }
+    // Layer coverage
+    if (snapshot.layerSummary) {
+        const { l1, l2, l3, l4 } = snapshot.layerSummary;
+        const l2Pct = l2.total > 0 ? Math.round((l2.passing / l2.total) * 100) : 0;
+        lines.push("### Layer Coverage");
+        lines.push(`- L1 Blueprint: ${l1.passing}/${l1.total} documented`);
+        // Build L2 line with harness execution data if available
+        let l2Line = `- L2 Harness: ${l2.passing}/${l2.total} (${l2Pct}%) have probes`;
+        if (snapshot.harnessLastRun) {
+            const lastRunDate = snapshot.harnessLastRun.slice(0, 10);
+            l2Line += ` | harness: ${snapshot.harnessPassed}/${snapshot.harnessTotal} passing, last run: ${lastRunDate}`;
+        }
+        lines.push(l2Line);
+        // Build L3 line with env probe evidence if available
+        let l3Line = `- L3 Environment: ${l3}`;
+        if (snapshot.envProbeLastRun) {
+            const lastRunDate = snapshot.envProbeLastRun.slice(0, 10);
+            l3Line += ` | env probe: ${snapshot.envProbePassed ?? 0}/${snapshot.envProbeTotal ?? 0} passing, last run: ${lastRunDate}`;
+        }
+        lines.push(l3Line);
+        // Build L4 line with slo probe evidence if available
+        let l4Line = `- L4 Monitoring: ${l4}`;
+        if (snapshot.sloProbeLastRun) {
+            const lastRunDate = snapshot.sloProbeLastRun.slice(0, 10);
+            l4Line += ` | slo probe: ${snapshot.sloProbePassed ?? 0}/${snapshot.sloProbeTotal ?? 0} passing, last run: ${lastRunDate}`;
+        }
+        lines.push(l4Line);
+        lines.push("");
+    }
+    // Status.md
+    lines.push("### Status.md");
+    lines.push("```");
+    lines.push(snapshot.statusSummary);
+    lines.push("```");
+    return lines.join("\n");
+}
+//# sourceMappingURL=consolidate-status.js.map

package/dist/tools/consolidate-status.js.map

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

package/dist/tools/executable-gates.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Tag-driven executable gate matrix for the Executable Sprint phase.
+ *
+ * Each project tag maps to one or more verification tools. When `generate_roadmap`
+ * runs, it reads the project's tags from forgecraft.yaml and selects the appropriate
+ * gates. Gate files (hurl specs, Playwright tests, SQL scripts, WebSocket clients)
+ * are written alongside the session prompt stubs so the AI has a runnable starting
+ * point rather than prose instructions alone.
+ */
+/**
+ * A single executable gate: the tool to use, where the gate file lives,
+ * and how to generate the starter content.
+ */
+export interface ExecutableGate {
+    /** Short tool identifier shown in roadmap and prompts */
+    readonly tool: string;
+    /** Human-readable description of what this gate verifies */
+    readonly label: string;
+    /** Relative path for the generated gate file. `{ucId}` is replaced at generation time. */
+    readonly gatePathTemplate: string;
+    /** Inline documentation URL shown in stubs */
+    readonly docsUrl: string;
+    /** Generate runnable stub content for a specific use case */
+    readonly buildStub: (ucId: string, ucTitle: string) => string;
+    /** One-line command to run all gates of this type */
+    readonly runCommand: string;
+}
+/**
+ * Resolve the applicable executable gates for a project's tags.
+ * Deduplicates by tool so a project tagged API+AUTH doesn't get two hurl gates.
+ *
+ * @param tags - Project classification tags from forgecraft.yaml
+ * @returns Ordered, deduplicated list of applicable gates
+ */
+export declare function resolveExecutableGates(tags: ReadonlyArray<string>): ReadonlyArray<ExecutableGate>;
+/**
+ * Format the gate file path for a specific use case.
+ *
+ * @param gate - The gate definition
+ * @param ucId - Use-case ID (e.g. UC-001)
+ * @returns Relative file path
+ */
+export declare function gateFilePath(gate: ExecutableGate, ucId: string): string;
+/**
+ * Build a one-line summary of all active gates for inclusion in the roadmap
+ * phase description header.
+ *
+ * @param gates - Resolved gates
+ * @returns Comma-separated tool list string
+ */
+export declare function gateToolSummary(gates: ReadonlyArray<ExecutableGate>): string;
+//# sourceMappingURL=executable-gates.d.ts.map

package/dist/tools/executable-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executable-gates.d.ts","sourceRoot":"","sources":["../../src/tools/executable-gates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAwSD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,aAAa,CAAC,cAAc,CAAC,CAwB/B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM,CAE5E"}