forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/generate-decision.js

@@ -0,0 +1,162 @@
+/**
+ * generate_decision tool handler.
+ *
+ * Emits a structured Decision/Post-mortem record into docs/decisions/ —
+ * the GS taxonomy slot for non-architectural one-pagers: bug-fix interpretations,
+ * operational tweaks, "we chose X over Y because Z" notes that don't warrant a
+ * full ADR.
+ *
+ * Encouraged on `fix:` commits (per cascade) and required when a bug-postmortem
+ * change_request reaches `verified` status.
+ *
+ * Output file: docs/decisions/YYYY-MM-DD-slug.md
+ * Format: Trigger / Root cause / Fix / Regression test / Chronicle link.
+ */
+import { z } from "zod";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createLogger } from "../shared/logger/index.js";
+const logger = createLogger("tools/generate-decision");
+const DECISION_DIR = join("docs", "decisions");
+// ── Schema ───────────────────────────────────────────────────────────
+export const generateDecisionSchema = z.object({
+    project_dir: z
+        .string()
+        .describe("Absolute path to the project root. Decision is written to {project_dir}/docs/decisions/."),
+    title: z
+        .string()
+        .describe("Short imperative title of the decision/post-mortem (e.g. 'Drop duplicate task_id rows on import'). " +
+        "Becomes the slug in the filename and the H1 heading."),
+    trigger: z
+        .string()
+        .optional()
+        .describe("What surfaced this decision — bug symptom, incident, support ticket, observed behavior. " +
+        "If omitted, a placeholder is written."),
+    root_cause: z
+        .string()
+        .optional()
+        .describe("Why it happened — the underlying defect, missing guard, or design oversight. " +
+        "If omitted, a placeholder is written."),
+    fix: z
+        .string()
+        .optional()
+        .describe("What was changed (code, config, or behavior) and why this fix was chosen over alternatives. " +
+        "If omitted, a placeholder is written."),
+    regression_test: z
+        .string()
+        .optional()
+        .describe("Test or gate that locks this fix in (test name, gate id, monitor). " +
+        "If omitted, a placeholder is written — required for fix: commits per cascade."),
+    chronicle_session_id: z
+        .string()
+        .optional()
+        .describe("Optional chronicle session id where the investigation was recorded. " +
+        "Links the post-mortem back to its individual-memory provenance."),
+    related_adr: z
+        .string()
+        .optional()
+        .describe("Optional ADR id this decision touches or refines (e.g. 'ADR-0007'). " +
+        "Use when the bug exposed an architectural assumption — promotes traceability."),
+});
+// ── Handler ──────────────────────────────────────────────────────────
+/**
+ * Generate and write a structured decision/post-mortem file.
+ *
+ * @param args - Validated tool input
+ * @returns MCP tool response with the written file path and content
+ */
+export async function generateDecisionHandler(args) {
+    const { project_dir, title } = args;
+    const decisionDir = join(project_dir, DECISION_DIR);
+    if (!existsSync(decisionDir)) {
+        mkdirSync(decisionDir, { recursive: true });
+        logger.info("Created docs/decisions/ directory", { decisionDir });
+    }
+    const date = new Date().toISOString().slice(0, 10);
+    const slug = titleToSlug(title);
+    const filename = `${date}-${slug}.md`;
+    const filePath = join(decisionDir, filename);
+    const relativePath = join(DECISION_DIR, filename).replace(/\\/g, "/");
+    if (existsSync(filePath)) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Decision file already exists: ${relativePath}\nChoose a different title or edit the existing file directly.`,
+                },
+            ],
+        };
+    }
+    const content = renderDecision({
+        date,
+        title,
+        trigger: args.trigger,
+        root_cause: args.root_cause,
+        fix: args.fix,
+        regression_test: args.regression_test,
+        chronicle_session_id: args.chronicle_session_id,
+        related_adr: args.related_adr,
+    });
+    writeFileSync(filePath, content, "utf-8");
+    logger.info("Decision written", { filePath, date, slug });
+    const lines = [
+        `# Decision Written`,
+        ``,
+        `**File:** \`${relativePath}\``,
+        `**Date:** ${date}`,
+        `**Title:** ${title}`,
+        ``,
+        `## Content`,
+        ``,
+        "```markdown",
+        content,
+        "```",
+        ``,
+        `> **Next step:** Resolve any \`[NEEDS CLARIFICATION]\` markers — especially the regression test, which is required by the \`fix:\` cascade.`,
+        args.chronicle_session_id
+            ? `> Chronicle session \`${args.chronicle_session_id}\` is linked — keep that record alive while this decision is current.`
+            : `> If this decision came out of a chronicle session, re-run with \`chronicle_session_id\` to link the investigation.`,
+    ];
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+/**
+ * Convert a title string to a URL-safe kebab-case slug.
+ * Strips punctuation, lowercases, replaces spaces/underscores with hyphens.
+ */
+export function titleToSlug(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9\s_-]/g, "")
+        .trim()
+        .replace(/[\s_]+/g, "-")
+        .replace(/-{2,}/g, "-")
+        .slice(0, 60);
+}
+/**
+ * Render a complete decision/post-mortem document from the provided fields.
+ */
+export function renderDecision(fields) {
+    const { date, title, trigger, root_cause, fix, regression_test, chronicle_session_id, related_adr, } = fields;
+    const lines = [
+        `# ${title}`,
+        ``,
+        `**Date:** ${date}`,
+        `**Type:** Decision / Post-mortem`,
+    ];
+    if (related_adr) {
+        lines.push(`**Related ADR:** ${related_adr}`);
+    }
+    if (chronicle_session_id) {
+        lines.push(`**Chronicle session:** \`${chronicle_session_id}\``);
+    }
+    lines.push(``, `## Trigger`, ``, trigger ??
+        "[NEEDS CLARIFICATION: what surfaced this — bug symptom, incident, support ticket, observed behavior]", ``, `## Root Cause`, ``, root_cause ??
+        "[NEEDS CLARIFICATION: why it happened — the underlying defect, missing guard, or design oversight]", ``, `## Fix`, ``, fix ??
+        "[NEEDS CLARIFICATION: what was changed (code, config, behavior) and why this fix was chosen]", ``, `## Regression Test`, ``, regression_test ??
+        "[NEEDS CLARIFICATION: test name, gate id, or monitor that locks this fix in — REQUIRED by fix: cascade]", ``, `## Chronicle Link`, ``, chronicle_session_id
+        ? `Investigation recorded in chronicle session \`${chronicle_session_id}\`. Pull notes/prompts from there before editing this file.`
+        : "[OPTIONAL: chronicle session id if the investigation was recorded — leave empty if this was a one-shot fix]", ``, `---`, ``, `_This decision record was generated by ForgeCraft. Resolve any [NEEDS CLARIFICATION] sections before merging — the cascade gate will block a \`fix:\` PR whose regression test is unresolved._`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=generate-decision.js.map

package/dist/tools/generate-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-decision.js","sourceRoot":"","sources":["../../src/tools/generate-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,MAAM,GAAG,YAAY,CAAC,yBAAyB,CAAC,CAAC;AAEvD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE/C,wEAAwE;AAExE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,CACP,0FAA0F,CAC3F;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CACP,qGAAqG;QACnG,sDAAsD,CACzD;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0FAA0F;QACxF,uCAAuC,CAC1C;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+EAA+E;QAC7E,uCAAuC,CAC1C;IACH,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,8FAA8F;QAC5F,uCAAuC,CAC1C;IACH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE;QACnE,+EAA+E,CAClF;IACH,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE;QACpE,iEAAiE,CACpE;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE;QACpE,+EAA+E,CAClF;CACJ,CAAC,CAAC;AAIH,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAA2B;IAE3B,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAEpC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,IAAI,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEtE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iCAAiC,YAAY,gEAAgE;iBACpH;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC;QAC7B,IAAI;QACJ,KAAK;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;QAC/C,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC;IAEH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,MAAM,KAAK,GAAG;QACZ,oBAAoB;QACpB,EAAE;QACF,eAAe,YAAY,IAAI;QAC/B,aAAa,IAAI,EAAE;QACnB,cAAc,KAAK,EAAE;QACrB,EAAE;QACF,YAAY;QACZ,EAAE;QACF,aAAa;QACb,OAAO;QACP,KAAK;QACL,EAAE;QACF,6IAA6I;QAC7I,IAAI,CAAC,oBAAoB;YACvB,CAAC,CAAC,yBAAyB,IAAI,CAAC,oBAAoB,uEAAuE;YAC3H,CAAC,CAAC,qHAAqH;KAC1H,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,wEAAwE;AAExE;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,IAAI,EAAE;SACN,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAaD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,OAAO,EACP,UAAU,EACV,GAAG,EACH,eAAe,EACf,oBAAoB,EACpB,WAAW,GACZ,GAAG,MAAM,CAAC;IAEX,MAAM,KAAK,GAAa;QACtB,KAAK,KAAK,EAAE;QACZ,EAAE;QACF,aAAa,IAAI,EAAE;QACnB,kCAAkC;KACnC,CAAC;IAEF,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,oBAAoB,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,4BAA4B,oBAAoB,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,YAAY,EACZ,EAAE,EACF,OAAO;QACL,sGAAsG,EACxG,EAAE,EACF,eAAe,EACf,EAAE,EACF,UAAU;QACR,oGAAoG,EACtG,EAAE,EACF,QAAQ,EACR,EAAE,EACF,GAAG;QACD,8FAA8F,EAChG,EAAE,EACF,oBAAoB,EACpB,EAAE,EACF,eAAe;QACb,yGAAyG,EAC3G,EAAE,EACF,mBAAmB,EACnB,EAAE,EACF,oBAAoB;QAClB,CAAC,CAAC,iDAAiD,oBAAoB,6DAA6D;QACpI,CAAC,CAAC,6GAA6G,EACjH,EAAE,EACF,KAAK,EACL,EAAE,EACF,gMAAgM,CACjM,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/generate-env-probe.d.ts

@@ -0,0 +1,49 @@
+/**
+ * generate_env_probe tool handler.
+ *
+ * Reads environment probe specs from .forgecraft/env/*.yaml and scaffolds
+ * executable probe files in tests/env/. Idempotent — skips existing unless force=true.
+ */
+import { z } from "zod";
+import type { ToolResult } from "../shared/types.js";
+export declare const generateEnvProbeSchema: z.ZodObject<{
+    project_dir: z.ZodString;
+    force: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    project_dir: string;
+    force?: boolean | undefined;
+}, {
+    project_dir: string;
+    force?: boolean | undefined;
+}>;
+export type GenerateEnvProbeInput = z.infer<typeof generateEnvProbeSchema>;
+export interface EnvProbeSpec {
+    service: string;
+    title?: string;
+    probes?: Array<{
+        id: string;
+        type: string;
+        description?: string;
+        url?: string;
+        vars?: string[];
+        host?: string;
+        port?: number;
+    }>;
+}
+export interface EnvGenerateResult {
+    service: string;
+    probeId: string;
+    probeType: string;
+    probeFile: string;
+    status: "generated" | "skipped" | "error";
+    reason?: string;
+}
+export declare function envExtensionForType(probeType: string): string;
+export declare function generateEnvProbeContent(service: string, probeId: string, probeType: string, description: string, extra?: {
+    url?: string;
+    vars?: string[];
+    host?: string;
+    port?: number;
+}): string;
+export declare function generateEnvProbeHandler(args: GenerateEnvProbeInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-env-probe.d.ts.map

package/dist/tools/generate-env-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-env-probe.d.ts","sourceRoot":"","sources":["../../src/tools/generate-env-probe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,eAAO,MAAM,sBAAsB;;;;;;;;;EAMjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAI3E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAiB7D;AA2ND,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,MAAM,CAsCR;AAID,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,UAAU,CAAC,CA+GrB"}

package/dist/tools/generate-env-probe.js

@@ -0,0 +1,365 @@
+/**
+ * generate_env_probe tool handler.
+ *
+ * Reads environment probe specs from .forgecraft/env/*.yaml and scaffolds
+ * executable probe files in tests/env/. Idempotent — skips existing unless force=true.
+ */
+import { z } from "zod";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { join, resolve } from "node:path";
+import yaml from "js-yaml";
+// ── Schema ───────────────────────────────────────────────────────────
+export const generateEnvProbeSchema = z.object({
+    project_dir: z.string().describe("Absolute path to the project root."),
+    force: z
+        .boolean()
+        .optional()
+        .describe("Overwrite existing probe files. Default: false."),
+});
+// ── Probe type → file extension ───────────────────────────────────────
+export function envExtensionForType(probeType) {
+    switch (probeType) {
+        case "health_check":
+            return ".health.sh";
+        case "env_var":
+            return ".env.sh";
+        case "port_check":
+            return ".port.sh";
+        case "schema_validate":
+            return ".schema.sh";
+        case "docker_check":
+            return ".docker.sh";
+        case "migration_check":
+            return ".migration.sh";
+        default:
+            return ".sh";
+    }
+}
+// ── Probe content generators ──────────────────────────────────────────
+function generateHealthCheckContent(service, probeId, description, url) {
+    const targetUrl = url ?? "http://{{host}}:{{port}}/health";
+    return `#!/usr/bin/env bash
+# Service: ${service}
+# Probe: ${probeId}
+# Type: health_check
+# Description: ${description}
+set -euo pipefail
+
+# TODO: set actual health endpoint URL
+URL="${targetUrl}"
+
+if ! command -v curl &>/dev/null; then
+  echo "FAIL: curl not found — cannot run health check"
+  exit 1
+fi
+
+HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" --max-time 10 "$URL" || echo "000")
+
+if [ "$HTTP_STATUS" = "200" ]; then
+  echo "PASS: ${probeId} — health endpoint returned 200"
+else
+  echo "FAIL: ${probeId} — health endpoint returned $HTTP_STATUS (expected 200)"
+  exit 1
+fi
+`;
+}
+function generateEnvVarContent(service, probeId, description, vars) {
+    const varList = vars && vars.length > 0 ? vars : ["# TODO: add required env var names"];
+    const checkLines = vars && vars.length > 0
+        ? vars
+            .map((v) => `if [ -z "\${${v}:-}" ]; then\n  echo "FAIL: ${probeId} — required env var ${v} is not set or empty"\n  exit 1\nfi`)
+            .join("\n")
+        : `# TODO: check required env vars\necho "TODO: implement env var checks for ${probeId}"\nexit 1`;
+    return `#!/usr/bin/env bash
+# Service: ${service}
+# Probe: ${probeId}
+# Type: env_var
+# Description: ${description}
+# Required vars: ${varList.join(", ")}
+set -euo pipefail
+
+${checkLines}
+
+echo "PASS: ${probeId} — all required env vars are set"
+`;
+}
+function generatePortCheckContent(service, probeId, description, host, port) {
+    const targetHost = host ?? "{{db_host}}";
+    const targetPort = port ?? 5432;
+    return `#!/usr/bin/env bash
+# Service: ${service}
+# Probe: ${probeId}
+# Type: port_check
+# Description: ${description}
+set -euo pipefail
+
+# TODO: set actual host and port
+HOST="${targetHost}"
+PORT="${targetPort}"
+
+if command -v nc &>/dev/null; then
+  if nc -z -w 5 "$HOST" "$PORT" 2>/dev/null; then
+    echo "PASS: ${probeId} — port $HOST:$PORT is reachable"
+  else
+    echo "FAIL: ${probeId} — port $HOST:$PORT is not reachable"
+    exit 1
+  fi
+elif command -v curl &>/dev/null; then
+  if curl -s --max-time 5 "telnet://$HOST:$PORT" &>/dev/null || curl -s --connect-timeout 5 "$HOST:$PORT" &>/dev/null; then
+    echo "PASS: ${probeId} — port $HOST:$PORT is reachable"
+  else
+    echo "FAIL: ${probeId} — port $HOST:$PORT is not reachable"
+    exit 1
+  fi
+else
+  echo "FAIL: ${probeId} — neither nc nor curl found"
+  exit 1
+fi
+`;
+}
+function generateSchemaValidateContent(service, probeId, description) {
+    return `#!/usr/bin/env bash
+# Service: ${service}
+# Probe: ${probeId}
+# Type: schema_validate
+# Description: ${description}
+set -euo pipefail
+
+# TODO: set path to .env.example and actual env file
+ENV_EXAMPLE=".env.example"
+ENV_FILE=".env"
+
+if [ ! -f "$ENV_EXAMPLE" ]; then
+  echo "FAIL: ${probeId} — .env.example not found at $ENV_EXAMPLE"
+  exit 1
+fi
+
+MISSING=()
+while IFS= read -r line; do
+  # Extract var name (skip comments and empty lines)
+  [[ "$line" =~ ^#.*$ || -z "$line" ]] && continue
+  VAR_NAME=$(echo "$line" | cut -d= -f1)
+  if [ -z "\${!VAR_NAME:-}" ]; then
+    MISSING+=("$VAR_NAME")
+  fi
+done < "$ENV_EXAMPLE"
+
+if [ \${#MISSING[@]} -gt 0 ]; then
+  echo "FAIL: ${probeId} — missing env vars: \${MISSING[*]}"
+  exit 1
+fi
+
+echo "PASS: ${probeId} — env schema validated against .env.example"
+`;
+}
+function generateDockerCheckContent(service, probeId, description) {
+    return `#!/usr/bin/env bash
+# Service: ${service}
+# Probe: ${probeId}
+# Type: docker_check
+# Description: ${description}
+set -euo pipefail
+
+# TODO: set actual container name
+CONTAINER_NAME="${service}"
+
+if ! command -v docker &>/dev/null; then
+  echo "FAIL: ${probeId} — docker not found"
+  exit 1
+fi
+
+if docker compose ps --format json 2>/dev/null | grep -q "$CONTAINER_NAME"; then
+  STATUS=$(docker compose ps --format json 2>/dev/null | grep "$CONTAINER_NAME" | grep -o '"State":"[^"]*"' | head -1)
+  if echo "$STATUS" | grep -q '"running"'; then
+    echo "PASS: ${probeId} — container $CONTAINER_NAME is running"
+  else
+    echo "FAIL: ${probeId} — container $CONTAINER_NAME is not running: $STATUS"
+    exit 1
+  fi
+elif docker ps --filter "name=$CONTAINER_NAME" --format "{{.Status}}" 2>/dev/null | grep -q "Up"; then
+  echo "PASS: ${probeId} — container $CONTAINER_NAME is running"
+else
+  echo "FAIL: ${probeId} — container $CONTAINER_NAME is not running"
+  exit 1
+fi
+`;
+}
+function generateMigrationCheckContent(service, probeId, description) {
+    return `#!/usr/bin/env bash
+# Service: ${service}
+# Probe: ${probeId}
+# Type: migration_check
+# Description: ${description}
+set -euo pipefail
+
+DB_URL="\${DATABASE_URL:-}"
+if [ -z "$DB_URL" ]; then
+  echo "FAIL: ${probeId} — DATABASE_URL not set"
+  exit 1
+fi
+
+# TODO: adapt to your migration tool (prisma, flyway, liquibase, etc.)
+if command -v prisma &>/dev/null; then
+  PENDING=$(npx prisma migrate status 2>&1 | grep -c "pending" || true)
+  if [ "$PENDING" -gt 0 ]; then
+    echo "FAIL: ${probeId} — $PENDING pending migration(s)"
+    exit 1
+  fi
+  echo "PASS: ${probeId} — no pending migrations"
+else
+  echo "TODO: implement migration check for ${probeId} — set up migration tool"
+  exit 1
+fi
+`;
+}
+export function generateEnvProbeContent(service, probeId, probeType, description, extra) {
+    switch (probeType) {
+        case "health_check":
+            return generateHealthCheckContent(service, probeId, description, extra?.url);
+        case "env_var":
+            return generateEnvVarContent(service, probeId, description, extra?.vars);
+        case "port_check":
+            return generatePortCheckContent(service, probeId, description, extra?.host, extra?.port);
+        case "schema_validate":
+            return generateSchemaValidateContent(service, probeId, description);
+        case "docker_check":
+            return generateDockerCheckContent(service, probeId, description);
+        case "migration_check":
+            return generateMigrationCheckContent(service, probeId, description);
+        default:
+            return `#!/usr/bin/env bash
+# Service: ${service}
+# Probe: ${probeId}
+# Type: ${probeType}
+# Description: ${description}
+set -euo pipefail
+
+# TODO: implement probe check for ${probeId}
+echo "TODO: implement ${probeId}"
+exit 1
+`;
+    }
+}
+// ── Handler ───────────────────────────────────────────────────────────
+export async function generateEnvProbeHandler(args) {
+    const projectDir = resolve(args.project_dir);
+    const force = args.force ?? false;
+    const envSpecDir = join(projectDir, ".forgecraft", "env");
+    if (!existsSync(envSpecDir)) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No env probe specs found. Create .forgecraft/env/service.yaml to define environment contracts.",
+                },
+            ],
+        };
+    }
+    // Read all spec files
+    let specFiles = [];
+    try {
+        specFiles = readdirSync(envSpecDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"));
+    }
+    catch {
+        specFiles = [];
+    }
+    if (specFiles.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No env probe specs found. Create .forgecraft/env/service.yaml to define environment contracts.",
+                },
+            ],
+        };
+    }
+    const envDir = join(projectDir, "tests", "env");
+    try {
+        mkdirSync(envDir, { recursive: true });
+    }
+    catch {
+        /* ignore */
+    }
+    const results = [];
+    for (const specFile of specFiles) {
+        let spec;
+        try {
+            const raw = readFileSync(join(envSpecDir, specFile), "utf-8");
+            spec = yaml.load(raw);
+        }
+        catch {
+            continue;
+        }
+        if (!spec?.service || !spec.probes)
+            continue;
+        for (const probe of spec.probes) {
+            const ext = envExtensionForType(probe.type);
+            const fileName = `${spec.service}-${probe.id}${ext}`;
+            const filePath = join(envDir, fileName);
+            const relPath = `tests/env/${fileName}`;
+            if (existsSync(filePath) && !force) {
+                results.push({
+                    service: spec.service,
+                    probeId: probe.id,
+                    probeType: probe.type,
+                    probeFile: relPath,
+                    status: "skipped",
+                    reason: "already exists",
+                });
+                continue;
+            }
+            const content = generateEnvProbeContent(spec.service, probe.id, probe.type, probe.description ?? probe.id, {
+                url: probe.url,
+                vars: probe.vars,
+                host: probe.host,
+                port: probe.port,
+            });
+            try {
+                writeFileSync(filePath, content, "utf-8");
+                results.push({
+                    service: spec.service,
+                    probeId: probe.id,
+                    probeType: probe.type,
+                    probeFile: relPath,
+                    status: "generated",
+                });
+            }
+            catch (err) {
+                results.push({
+                    service: spec.service,
+                    probeId: probe.id,
+                    probeType: probe.type,
+                    probeFile: relPath,
+                    status: "error",
+                    reason: `write failed: ${String(err)}`,
+                });
+            }
+        }
+    }
+    return { content: [{ type: "text", text: formatEnvReport(results) }] };
+}
+// ── Report formatter ──────────────────────────────────────────────────
+function formatEnvReport(results) {
+    const generated = results.filter((r) => r.status === "generated");
+    const skipped = results.filter((r) => r.status === "skipped");
+    const noSpec = results.filter((r) => r.status === "error");
+    const lines = [
+        "## Env Probe Generation Report",
+        "",
+        `Generated: ${generated.length}  Skipped: ${skipped.length}  No spec: ${noSpec.length}`,
+        "",
+        "| Service | Probe | Type | File | Status |",
+        "|---|---|---|---|---|",
+    ];
+    for (const r of results) {
+        const statusLabel = r.status === "generated"
+            ? "✅ generated"
+            : r.status === "skipped"
+                ? "⏭ skipped"
+                : `❌ error: ${r.reason ?? ""}`;
+        lines.push(`| ${r.service} | ${r.probeId} | ${r.probeType} | ${r.probeFile} | ${statusLabel} |`);
+    }
+    lines.push("", "To run: call run_env_probe");
+    return lines.join("\n");
+}
+//# sourceMappingURL=generate-env-probe.js.map

package/dist/tools/generate-env-probe.js.map

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

package/dist/tools/generate-harness.d.ts

@@ -0,0 +1,53 @@
+/**
+ * generate_harness tool handler.
+ *
+ * Reads UC specs from docs/use-cases.md and probe blueprints from
+ * .forgecraft/harness/uc-NNN.yaml, then scaffolds executable probe files
+ * in tests/harness/. Idempotent: skips existing files unless force=true.
+ */
+import { z } from "zod";
+import type { ToolResult } from "../shared/types.js";
+export declare const generateHarnessSchema: z.ZodObject<{
+    project_dir: z.ZodString;
+    uc_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    force: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    project_dir: string;
+    force?: boolean | undefined;
+    uc_ids?: string[] | undefined;
+}, {
+    project_dir: string;
+    force?: boolean | undefined;
+    uc_ids?: string[] | undefined;
+}>;
+export type GenerateHarnessInput = z.infer<typeof generateHarnessSchema>;
+export interface ProbeSpec {
+    uc: string;
+    title: string;
+    action?: string;
+    probes?: Array<{
+        id: string;
+        type: string;
+        scenario?: string;
+        description?: string;
+    }>;
+}
+export type ProbeType = "playwright" | "api_call" | "hurl" | "graphql" | "file_system" | "mcp_call" | "headless_sim" | "db_query" | "message_queue" | "performance" | "websocket" | "log_assertion" | "a11y" | "contract_consumer" | "contract_provider" | "grpc" | "security_scan";
+export interface GenerateResult {
+    ucId: string;
+    title: string;
+    status: "generated" | "skipped" | "no_spec";
+    probeFile?: string;
+    probeType?: string;
+    reason?: string;
+    autoSpec?: boolean;
+}
+export interface ErrorCase {
+    name: string;
+    slug: string;
+    description: string;
+}
+export declare function extensionForType(probeType: ProbeType): string;
+export declare function parseErrorCases(ucSection: string): ErrorCase[];
+export declare function generateHarnessHandler(args: GenerateHarnessInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-harness.d.ts.map

package/dist/tools/generate-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-harness.d.ts","sourceRoot":"","sources":["../../src/tools/generate-harness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAehC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIzE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,UAAU,GACV,MAAM,GACN,SAAS,GACT,aAAa,GACb,UAAU,GACV,cAAc,GACd,UAAU,GACV,eAAe,GACf,aAAa,GACb,WAAW,GACX,eAAe,GACf,MAAM,GACN,mBAAmB,GACnB,mBAAmB,GACnB,MAAM,GACN,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AA8BD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAoC7D;AAID,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,CAyB9D;AA0ND,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CAqIrB"}