forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/run-slo-probe.d.ts

@@ -0,0 +1,50 @@
+/**
+ * run_slo_probe tool handler.
+ *
+ * Scans tests/slo/ for probe files, executes each (.sh via bash, .k6.js via k6),
+ * reports PASS/FAIL/TOOL_MISSING/NOT_IMPLEMENTED/NO_PROBE/TIMEOUT/ERROR.
+ * Writes .forgecraft/slo-probe-run.json after execution.
+ */
+import { z } from "zod";
+import type { ToolResult } from "../shared/types.js";
+import type { ProbeStatus } from "./run-harness.js";
+export declare const runSloProbeSchema: z.ZodObject<{
+    project_dir: z.ZodString;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    project_dir: string;
+    timeout_ms?: number | undefined;
+}, {
+    project_dir: string;
+    timeout_ms?: number | undefined;
+}>;
+export type RunSloProbeInput = z.infer<typeof runSloProbeSchema>;
+export interface SloProbeResult {
+    service: string;
+    probeId: string;
+    probeFile: string | null;
+    probeType: string;
+    status: ProbeStatus;
+    durationMs: number;
+    output?: string;
+}
+export interface SloProbeRunJson {
+    timestamp: string;
+    passed: number;
+    failed: number;
+    errors: number;
+    notFound: number;
+    results: Array<{
+        service: string;
+        probeId: string;
+        status: string;
+        durationMs: number;
+    }>;
+}
+export declare function parseSloProbeFileName(fileName: string): {
+    service: string;
+    probeId: string;
+    probeType: string;
+};
+export declare function runSloProbeHandler(args: RunSloProbeInput): Promise<ToolResult>;
+//# sourceMappingURL=run-slo-probe.d.ts.map

package/dist/tools/run-slo-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-slo-probe.d.ts","sourceRoot":"","sources":["../../src/tools/run-slo-probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,eAAO,MAAM,iBAAiB;;;;;;;;;EAM5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAIjE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAID,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAiCA;AAuFD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CA8DrB"}

package/dist/tools/run-slo-probe.js

@@ -0,0 +1,281 @@
+/**
+ * run_slo_probe tool handler.
+ *
+ * Scans tests/slo/ for probe files, executes each (.sh via bash, .k6.js via k6),
+ * reports PASS/FAIL/TOOL_MISSING/NOT_IMPLEMENTED/NO_PROBE/TIMEOUT/ERROR.
+ * Writes .forgecraft/slo-probe-run.json after execution.
+ */
+import { z } from "zod";
+import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { spawnSync } from "node:child_process";
+import { isToolAvailable, isNotImplementedOutput, combineOutput, } from "./probe-runners.js";
+// ── Schema ───────────────────────────────────────────────────────────
+export const runSloProbeSchema = z.object({
+    project_dir: z.string().describe("Absolute path to the project root."),
+    timeout_ms: z
+        .number()
+        .optional()
+        .describe("Timeout per probe in ms. Default: 15000."),
+});
+// ── Probe file parsing ────────────────────────────────────────────────
+export function parseSloProbeFileName(fileName) {
+    const typeMap = {
+        ".alert.sh": "alert_exists",
+        ".metric.sh": "metric_present",
+        ".dashboard.sh": "dashboard_exists",
+        ".slo.sh": "slo_assertion",
+        ".k6.js": "synthetic_load",
+    };
+    let probeType = "unknown";
+    let baseName = fileName;
+    for (const [ext, type] of Object.entries(typeMap)) {
+        if (fileName.endsWith(ext)) {
+            probeType = type;
+            baseName = fileName.slice(0, fileName.length - ext.length);
+            break;
+        }
+    }
+    if (probeType === "unknown" && fileName.endsWith(".sh")) {
+        baseName = fileName.slice(0, -3);
+    }
+    const probeIdx = baseName.indexOf("-probe-");
+    if (probeIdx !== -1) {
+        return {
+            service: baseName.slice(0, probeIdx),
+            probeId: baseName.slice(probeIdx + 1),
+            probeType,
+        };
+    }
+    return { service: baseName, probeId: "unknown", probeType };
+}
+// ── Probe execution ───────────────────────────────────────────────────
+function runSloProbeFile(probePath, fileName, timeoutMs) {
+    const start = Date.now();
+    if (fileName.endsWith(".k6.js")) {
+        if (!isToolAvailable("k6")) {
+            return {
+                status: "tool_missing",
+                durationMs: Date.now() - start,
+                output: "k6 not found (install: https://k6.io)",
+            };
+        }
+        try {
+            const result = spawnSync("k6", ["run", probePath], {
+                timeout: timeoutMs,
+                stdio: ["pipe", "pipe", "pipe"],
+                encoding: "utf-8",
+            });
+            const durationMs = Date.now() - start;
+            const output = combineOutput(result.stdout, result.stderr);
+            if (result.error?.message?.includes("ENOENT")) {
+                return { status: "tool_missing", durationMs, output: "k6 not found" };
+            }
+            if (result.signal === "SIGTERM" ||
+                result.error?.message?.includes("ETIMEDOUT")) {
+                return { status: "timeout", durationMs, output: "timed out" };
+            }
+            return {
+                status: result.status === 0 ? "pass" : "fail",
+                durationMs,
+                output,
+            };
+        }
+        catch (err) {
+            return {
+                status: "error",
+                durationMs: Date.now() - start,
+                output: String(err),
+            };
+        }
+    }
+    // All .sh files run via bash
+    try {
+        const result = spawnSync("bash", [probePath], {
+            timeout: timeoutMs,
+            stdio: ["pipe", "pipe", "pipe"],
+            encoding: "utf-8",
+        });
+        const durationMs = Date.now() - start;
+        const output = combineOutput(result.stdout, result.stderr);
+        if (result.error?.message?.includes("ENOENT")) {
+            return { status: "tool_missing", durationMs, output: "bash not found" };
+        }
+        if (result.signal === "SIGTERM" ||
+            result.error?.message?.includes("ETIMEDOUT")) {
+            return { status: "timeout", durationMs, output: "timed out" };
+        }
+        if (isNotImplementedOutput(output)) {
+            return { status: "not_implemented", durationMs, output };
+        }
+        return {
+            status: result.status === 0 ? "pass" : "fail",
+            durationMs,
+            output,
+        };
+    }
+    catch (err) {
+        return {
+            status: "error",
+            durationMs: Date.now() - start,
+            output: String(err),
+        };
+    }
+}
+// ── Handler ───────────────────────────────────────────────────────────
+export async function runSloProbeHandler(args) {
+    const projectDir = resolve(args.project_dir);
+    const timeoutMs = args.timeout_ms ?? 15000;
+    const sloDir = join(projectDir, "tests", "slo");
+    if (!existsSync(sloDir)) {
+        const timestamp = new Date().toISOString();
+        writeSloProbeRunJson(projectDir, timestamp, []);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatSloRunReport([], timestamp),
+                },
+            ],
+        };
+    }
+    let probeFiles = [];
+    try {
+        probeFiles = readdirSync(sloDir).filter((f) => f.endsWith(".sh") || f.endsWith(".k6.js"));
+    }
+    catch {
+        probeFiles = [];
+    }
+    const results = [];
+    if (probeFiles.length === 0) {
+        const timestamp = new Date().toISOString();
+        writeSloProbeRunJson(projectDir, timestamp, []);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatSloRunReport([], timestamp),
+                },
+            ],
+        };
+    }
+    for (const fileName of probeFiles) {
+        const { service, probeId, probeType } = parseSloProbeFileName(fileName);
+        const probePath = join(sloDir, fileName);
+        const run = runSloProbeFile(probePath, fileName, timeoutMs);
+        results.push({
+            service,
+            probeId,
+            probeFile: fileName,
+            probeType,
+            ...run,
+        });
+    }
+    const timestamp = new Date().toISOString();
+    writeSloProbeRunJson(projectDir, timestamp, results);
+    return {
+        content: [{ type: "text", text: formatSloRunReport(results, timestamp) }],
+    };
+}
+// ── JSON writer ───────────────────────────────────────────────────────
+function writeSloProbeRunJson(projectDir, timestamp, results) {
+    try {
+        const dir = join(projectDir, ".forgecraft");
+        mkdirSync(dir, { recursive: true });
+        const runJson = {
+            timestamp,
+            passed: results.filter((r) => r.status === "pass").length,
+            failed: results.filter((r) => r.status === "fail").length,
+            errors: results.filter((r) => ["error", "tool_missing", "not_implemented", "timeout"].includes(r.status)).length,
+            notFound: results.filter((r) => r.status === "no_probe").length,
+            results: results.map((r) => ({
+                service: r.service,
+                probeId: r.probeId,
+                status: r.status,
+                durationMs: r.durationMs,
+            })),
+        };
+        writeFileSync(join(dir, "slo-probe-run.json"), JSON.stringify(runJson, null, 2), "utf-8");
+    }
+    catch {
+        /* non-throwing */
+    }
+}
+// ── Report formatter ──────────────────────────────────────────────────
+function formatSloRunReport(results, timestamp) {
+    if (results.length === 0) {
+        return [
+            "## SLO Probe Run Report",
+            `_Executed: ${timestamp}_`,
+            "",
+            "No probe files found. Run `generate_slo_probe` first.",
+            "",
+            buildSloLoopInstructions([]).join("\n"),
+        ].join("\n");
+    }
+    const passed = results.filter((r) => r.status === "pass").length;
+    const failed = results.filter((r) => r.status === "fail").length;
+    const errors = results.filter((r) => ["error", "tool_missing", "not_implemented", "timeout"].includes(r.status)).length;
+    const notFound = results.filter((r) => r.status === "no_probe").length;
+    const lines = [
+        "## SLO Probe Run Report",
+        `_Executed: ${timestamp}_`,
+        "",
+        `### Results: ${passed} passed / ${failed} failed / ${errors} errors / ${notFound} not found`,
+        "",
+        "| Service | Probe | Type | File | Status | Duration |",
+        "|---|---|---|---|---|---|",
+    ];
+    for (const r of results) {
+        const dur = r.durationMs > 0 ? `${(r.durationMs / 1000).toFixed(1)}s` : "—";
+        lines.push(`| ${r.service} | ${r.probeId} | ${r.probeType} | ${r.probeFile ?? "—"} | ${formatSloStatus(r.status)} | ${dur} |`);
+    }
+    lines.push(...buildSloLoopInstructions(results));
+    return lines.join("\n");
+}
+function buildSloLoopInstructions(results) {
+    const lines = [
+        "",
+        "### The Loop",
+        "",
+        "**SLO probe failures mean monitoring contracts are not verified — regenerate from NFR contracts, not patch dashboards.**",
+        "",
+    ];
+    const failed = results.filter((r) => r.status === "fail");
+    const notImpl = results.filter((r) => r.status === "not_implemented");
+    const noProbe = results.filter((r) => r.status === "no_probe");
+    const allPassing = results.length > 0 && results.every((r) => r.status === "pass");
+    if (failed.length > 0) {
+        lines.push(`❌ ${failed.length} probe${failed.length === 1 ? "" : "s"} failed — for each failing probe:`, "  1. Read the NFR contract in docs/nfr-contracts.md", "  2. Read the SLO spec in .forgecraft/slo/{service}.yaml", "  3. Update Prometheus rules / Grafana dashboards / alertmanager config to match contracts", "  4. Call run_slo_probe again — repeat until green", "");
+    }
+    if (notImpl.length > 0) {
+        lines.push(`⚠️ ${notImpl.length} probe${notImpl.length === 1 ? "" : "s"} not yet implemented — fill in the TODO sections:`);
+        for (const r of notImpl) {
+            lines.push(`  - tests/slo/${r.probeFile ?? r.probeId}: implement the actual check`);
+        }
+        lines.push("");
+    }
+    if (noProbe.length > 0) {
+        lines.push(`📋 ${noProbe.length} service${noProbe.length === 1 ? "" : "s"} have no probe files — run:`, "  generate_slo_probe (scaffolds probe files from .forgecraft/slo/ specs)", "  Then implement the TODO sections", "");
+    }
+    if (allPassing) {
+        lines.push("✅ All SLO probes passing — L4 monitoring contracts verified.", "  Call close_cycle to evaluate gates and advance the cycle.");
+    }
+    else if (results.length > 0) {
+        lines.push("Run layer_status to see full coverage picture.");
+    }
+    return lines;
+}
+function formatSloStatus(status) {
+    const map = {
+        pass: "✅ PASS",
+        fail: "❌ FAIL",
+        tool_missing: "⚠️ TOOL_MISSING",
+        not_implemented: "⏳ NOT_IMPLEMENTED",
+        timeout: "⏱ TIMEOUT",
+        no_probe: "❌ NO_PROBE",
+        error: "⚠️ ERROR",
+    };
+    return map[status] ?? status;
+}
+//# sourceMappingURL=run-slo-probe.js.map

package/dist/tools/run-slo-probe.js.map

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

package/dist/tools/scaffold-spec-stubs.js

@@ -7,20 +7,20 @@
  */
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { dirname } from "node:path";
-export const USE_CASES_STUB = `<!-- UNFILLED: Use Cases -->
-# Use Cases
-
-## UC-01: [Name]
-**Actor**: <!-- FILL: who? -->
-**Precondition**: <!-- FILL: what must be true before? -->
-**Steps**: <!-- FILL: numbered steps -->
-**Success**: <!-- FILL: what changed? -->
-
-## UC-02: [Name]
-<!-- FILL -->
-
-## UC-03: [Name]
-<!-- FILL -->
+export const USE_CASES_STUB = `<!-- UNFILLED: Use Cases -->
+# Use Cases
+
+## UC-01: [Name]
+**Actor**: <!-- FILL: who? -->
+**Precondition**: <!-- FILL: what must be true before? -->
+**Steps**: <!-- FILL: numbered steps -->
+**Success**: <!-- FILL: what changed? -->
+
+## UC-02: [Name]
+<!-- FILL -->
+
+## UC-03: [Name]
+<!-- FILL -->
 `;
 /**
  * Build the UNFILLED stub content for docs/diagrams/c4-context.md.
@@ -29,16 +29,16 @@ export const USE_CASES_STUB = `<!-- UNFILLED: Use Cases -->
  * @returns Stub content with UNFILLED markers
  */
 export function buildC4ContextStub(projectName) {
-    return `<!-- UNFILLED: C4 Context Diagram -->
-<!-- Run \`forgecraft generate_diagram\` to auto-generate from your spec -->
-# System Context Diagram
-\`\`\`mermaid
-C4Context
-  title System Context: ${projectName}
-  Person(user, "User", "<!-- FILL: Who uses the system? -->")
-  System(system, "${projectName}", "<!-- FILL: What does the system do in one sentence? -->")
-  Rel(user, system, "<!-- FILL: Primary interaction -->")
-\`\`\`
+    return `<!-- UNFILLED: C4 Context Diagram -->
+<!-- Run \`forgecraft generate_diagram\` to auto-generate from your spec -->
+# System Context Diagram
+\`\`\`mermaid
+C4Context
+  title System Context: ${projectName}
+  Person(user, "User", "<!-- FILL: Who uses the system? -->")
+  System(system, "${projectName}", "<!-- FILL: What does the system do in one sentence? -->")
+  Rel(user, system, "<!-- FILL: Primary interaction -->")
+\`\`\`
 `;
 }
 /**
@@ -51,32 +51,32 @@ C4Context
  * @returns Stub content with UNFILLED markers and structural Mermaid syntax
  */
 export function buildSequenceDiagramStub(feature) {
-    return `<!-- UNFILLED: Sequence Diagram — ${feature} -->
-<!-- Replace participant labels and messages with real actors and contracts -->
-# Sequence Diagram: ${feature}
-
-\`\`\`mermaid
-sequenceDiagram
-    participant Client as <!-- FILL: initiating actor, e.g. Browser / CLI / Service -->
-    participant API as <!-- FILL: entry-point service, e.g. API Gateway -->
-    participant Service as <!-- FILL: domain service, e.g. AuthService -->
-    participant Store as <!-- FILL: persistence layer, e.g. Database -->
-
-    Note over Client,Store: <!-- FILL: describe the primary flow in one sentence -->
-
-    Client->>API: <!-- FILL: request, e.g. POST /login {credentials} -->
-    API->>Service: <!-- FILL: delegate, e.g. authenticate(credentials) -->
-    Service->>Store: <!-- FILL: query, e.g. findUserByEmail(email) -->
-    Store-->>Service: <!-- FILL: result, e.g. User | null -->
-
-    alt <!-- FILL: failure case, e.g. User not found or wrong password -->
-        Service-->>API: <!-- FILL: error response, e.g. AuthError -->
-        API-->>Client: <!-- FILL: HTTP error, e.g. 401 Unauthorized -->
-    else <!-- FILL: success case -->
-        Service-->>API: <!-- FILL: success result, e.g. JWT token -->
-        API-->>Client: <!-- FILL: HTTP success, e.g. 200 OK {token} -->
-    end
-\`\`\`
+    return `<!-- UNFILLED: Sequence Diagram — ${feature} -->
+<!-- Replace participant labels and messages with real actors and contracts -->
+# Sequence Diagram: ${feature}
+
+\`\`\`mermaid
+sequenceDiagram
+    participant Client as <!-- FILL: initiating actor, e.g. Browser / CLI / Service -->
+    participant API as <!-- FILL: entry-point service, e.g. API Gateway -->
+    participant Service as <!-- FILL: domain service, e.g. AuthService -->
+    participant Store as <!-- FILL: persistence layer, e.g. Database -->
+
+    Note over Client,Store: <!-- FILL: describe the primary flow in one sentence -->
+
+    Client->>API: <!-- FILL: request, e.g. POST /login {credentials} -->
+    API->>Service: <!-- FILL: delegate, e.g. authenticate(credentials) -->
+    Service->>Store: <!-- FILL: query, e.g. findUserByEmail(email) -->
+    Store-->>Service: <!-- FILL: result, e.g. User | null -->
+
+    alt <!-- FILL: failure case, e.g. User not found or wrong password -->
+        Service-->>API: <!-- FILL: error response, e.g. AuthError -->
+        API-->>Client: <!-- FILL: HTTP error, e.g. 401 Unauthorized -->
+    else <!-- FILL: success case -->
+        Service-->>API: <!-- FILL: success result, e.g. JWT token -->
+        API-->>Client: <!-- FILL: HTTP success, e.g. 200 OK {token} -->
+    end
+\`\`\`
 `;
 }
 /**
@@ -90,30 +90,30 @@ sequenceDiagram
  * @returns Stub content with UNFILLED markers and structural Mermaid syntax
  */
 export function buildStateMachineDiagramStub(entityName) {
-    return `<!-- UNFILLED: State Machine — ${entityName} -->
-<!-- Replace state names (Draft, Pending, Active, etc.) and transition labels -->
-<!-- with the actual lifecycle states of your domain entity.               -->
-# State Machine: ${entityName}
-
-\`\`\`mermaid
-stateDiagram-v2
-    [*] --> Draft
-
-    Draft --> Pending: submit()
-    Pending --> Active: approve()
-    Pending --> Rejected: reject()
-    Active --> Completed: complete()
-    Active --> Cancelled: cancel()
-
-    Completed --> [*]
-    Rejected --> [*]
-    Cancelled --> [*]
-
-    note right of Active
-        FILL: add invariant or constraint
-        e.g. "requires valid payment method"
-    end note
-\`\`\`
+    return `<!-- UNFILLED: State Machine — ${entityName} -->
+<!-- Replace state names (Draft, Pending, Active, etc.) and transition labels -->
+<!-- with the actual lifecycle states of your domain entity.               -->
+# State Machine: ${entityName}
+
+\`\`\`mermaid
+stateDiagram-v2
+    [*] --> Draft
+
+    Draft --> Pending: submit()
+    Pending --> Active: approve()
+    Pending --> Rejected: reject()
+    Active --> Completed: complete()
+    Active --> Cancelled: cancel()
+
+    Completed --> [*]
+    Rejected --> [*]
+    Cancelled --> [*]
+
+    note right of Active
+        FILL: add invariant or constraint
+        e.g. "requires valid payment method"
+    end note
+\`\`\`
 `;
 }
 /**
@@ -126,29 +126,29 @@ stateDiagram-v2
  * @returns Stub content with UNFILLED markers and structural Mermaid syntax
  */
 export function buildFlowDiagramStub(ucName) {
-    return `<!-- UNFILLED: Flow Diagram — ${ucName} -->
-<!-- Replace node labels and edge conditions with real user journey steps -->
-# Flow: ${ucName}
-
-\`\`\`mermaid
-flowchart TD
-    Start([<!-- FILL: trigger, e.g. User opens registration page -->])
-
-    Start --> Input[<!-- FILL: first action, e.g. Fill in name, email, password -->]
-    Input --> Validate{<!-- FILL: validation check, e.g. All fields valid? -->}
-
-    Validate -->|<!-- FILL: failure label, e.g. Invalid -->| Error[<!-- FILL: error action, e.g. Show validation errors -->]
-    Error --> Input
-
-    Validate -->|<!-- FILL: success label, e.g. Valid -->| Process[<!-- FILL: main action, e.g. Create account -->]
-    Process --> Check{<!-- FILL: guard check, e.g. Email already exists? -->}
-
-    Check -->|<!-- FILL: conflict label, e.g. Yes -->| Conflict[<!-- FILL: conflict action, e.g. Show duplicate email error -->]
-    Conflict --> End([<!-- FILL: exit label, e.g. User corrects email -->])
-
-    Check -->|<!-- FILL: proceed label, e.g. No -->| Success[<!-- FILL: success action, e.g. Send confirmation email -->]
-    Success --> End
-\`\`\`
+    return `<!-- UNFILLED: Flow Diagram — ${ucName} -->
+<!-- Replace node labels and edge conditions with real user journey steps -->
+# Flow: ${ucName}
+
+\`\`\`mermaid
+flowchart TD
+    Start([<!-- FILL: trigger, e.g. User opens registration page -->])
+
+    Start --> Input[<!-- FILL: first action, e.g. Fill in name, email, password -->]
+    Input --> Validate{<!-- FILL: validation check, e.g. All fields valid? -->}
+
+    Validate -->|<!-- FILL: failure label, e.g. Invalid -->| Error[<!-- FILL: error action, e.g. Show validation errors -->]
+    Error --> Input
+
+    Validate -->|<!-- FILL: success label, e.g. Valid -->| Process[<!-- FILL: main action, e.g. Create account -->]
+    Process --> Check{<!-- FILL: guard check, e.g. Email already exists? -->}
+
+    Check -->|<!-- FILL: conflict label, e.g. Yes -->| Conflict[<!-- FILL: conflict action, e.g. Show duplicate email error -->]
+    Conflict --> End([<!-- FILL: exit label, e.g. User corrects email -->])
+
+    Check -->|<!-- FILL: proceed label, e.g. No -->| Success[<!-- FILL: success action, e.g. Send confirmation email -->]
+    Success --> End
+\`\`\`
 `;
 }
 /**
@@ -161,24 +161,24 @@ flowchart TD
  * @returns Stub content with UNFILLED markers and structural Mermaid syntax
  */
 export function buildC4ContainerStub(projectName) {
-    return `<!-- UNFILLED: C4 Container Diagram -->
-<!-- Replace container labels, technology fields, and relations with your stack -->
-# Container Diagram — ${projectName}
-
-\`\`\`mermaid
-C4Container
-    title Container Diagram: ${projectName}
-
-    Person(user, "<!-- FILL: actor name -->", "<!-- FILL: actor description -->")
-
-    Container(web, "<!-- FILL: frontend name, e.g. Web Application -->", "<!-- FILL: technology, e.g. React -->", "<!-- FILL: responsibility -->")
-    Container(api, "<!-- FILL: backend name, e.g. API Server -->", "<!-- FILL: technology, e.g. Node.js / Express -->", "<!-- FILL: responsibility -->")
-    Container(db, "<!-- FILL: database name, e.g. Primary Database -->", "<!-- FILL: technology, e.g. PostgreSQL -->", "<!-- FILL: responsibility -->")
-
-    Rel(user, web, "<!-- FILL: interaction, e.g. Uses -->", "<!-- FILL: protocol, e.g. HTTPS -->")
-    Rel(web, api, "<!-- FILL: call, e.g. API calls -->", "<!-- FILL: protocol, e.g. REST / JSON -->")
-    Rel(api, db, "<!-- FILL: query, e.g. Reads and writes -->", "<!-- FILL: protocol, e.g. SQL -->")
-\`\`\`
+    return `<!-- UNFILLED: C4 Container Diagram -->
+<!-- Replace container labels, technology fields, and relations with your stack -->
+# Container Diagram — ${projectName}
+
+\`\`\`mermaid
+C4Container
+    title Container Diagram: ${projectName}
+
+    Person(user, "<!-- FILL: actor name -->", "<!-- FILL: actor description -->")
+
+    Container(web, "<!-- FILL: frontend name, e.g. Web Application -->", "<!-- FILL: technology, e.g. React -->", "<!-- FILL: responsibility -->")
+    Container(api, "<!-- FILL: backend name, e.g. API Server -->", "<!-- FILL: technology, e.g. Node.js / Express -->", "<!-- FILL: responsibility -->")
+    Container(db, "<!-- FILL: database name, e.g. Primary Database -->", "<!-- FILL: technology, e.g. PostgreSQL -->", "<!-- FILL: responsibility -->")
+
+    Rel(user, web, "<!-- FILL: interaction, e.g. Uses -->", "<!-- FILL: protocol, e.g. HTTPS -->")
+    Rel(web, api, "<!-- FILL: call, e.g. API calls -->", "<!-- FILL: protocol, e.g. REST / JSON -->")
+    Rel(api, db, "<!-- FILL: query, e.g. Reads and writes -->", "<!-- FILL: protocol, e.g. SQL -->")
+\`\`\`
 `;
 }
 /**