forgecraft-mcp 1.3.2 → 1.6.1

package/dist/tools/gate-violations.js

@@ -0,0 +1,152 @@
+/**
+ * gate-violations tool.
+ *
+ * Reads .forgecraft/gate-violations.jsonl and surfaces active violations
+ * (those newer than the last git commit). Stale violations (from before
+ * the last commit) are shown separately so history is preserved.
+ */
+import { z } from "zod";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { execSync } from "node:child_process";
+// ── Schema ──────────────────────────────────────────────────────────────
+export const readGateViolationsSchema = z.object({
+    project_dir: z.string().describe("Absolute path to the project root."),
+});
+// ── Handler ─────────────────────────────────────────────────────────────
+/**
+ * Read gate violations from the project's .forgecraft directory.
+ *
+ * @param args - Validated input containing project directory
+ * @returns MCP tool result with formatted violation report
+ */
+export async function readGateViolationsHandler(args) {
+    const projectDir = resolve(args.project_dir);
+    const report = buildGateViolationReport(projectDir);
+    return {
+        content: [{ type: "text", text: formatGateViolationReport(report) }],
+    };
+}
+// ── Core builder ────────────────────────────────────────────────────────
+/**
+ * Build a GateViolationReport from the project directory.
+ * Violations newer than the last commit are "active"; older ones are "stale".
+ *
+ * @param projectDir - Absolute path to project root
+ * @returns Violation report partitioned into active and stale
+ */
+export function buildGateViolationReport(projectDir) {
+    const lastCommitAt = readLastCommitTimestamp(projectDir);
+    const allViolations = readViolationsFile(projectDir);
+    if (lastCommitAt === null) {
+        return { active: allViolations, stale: [], lastCommitAt: null };
+    }
+    const lastCommitMs = new Date(lastCommitAt).getTime();
+    const active = [];
+    const stale = [];
+    for (const v of allViolations) {
+        const violationMs = new Date(v.timestamp).getTime();
+        if (isNaN(violationMs) || violationMs > lastCommitMs) {
+            active.push(v);
+        }
+        else {
+            stale.push(v);
+        }
+    }
+    return { active, stale, lastCommitAt };
+}
+// ── File readers ────────────────────────────────────────────────────────
+/**
+ * Read and parse the gate-violations.jsonl file.
+ * Returns an empty array when the file is absent or unreadable.
+ *
+ * @param projectDir - Absolute path to project root
+ * @returns Array of parsed gate violations
+ */
+export function readViolationsFile(projectDir) {
+    const filePath = join(projectDir, ".forgecraft", "gate-violations.jsonl");
+    if (!existsSync(filePath))
+        return [];
+    try {
+        const lines = readFileSync(filePath, "utf-8")
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0);
+        return lines
+            .map((line) => {
+            try {
+                const parsed = JSON.parse(line);
+                return {
+                    hook: String(parsed["hook"] ?? "unknown"),
+                    severity: String(parsed["severity"] ?? "error"),
+                    message: String(parsed["message"] ?? ""),
+                    timestamp: String(parsed["timestamp"] ?? ""),
+                };
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((v) => v !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the ISO timestamp of the last git commit in the project.
+ * Returns null when .git is absent or git is unavailable.
+ *
+ * @param projectDir - Absolute path to project root
+ * @returns ISO 8601 timestamp string or null
+ */
+function readLastCommitTimestamp(projectDir) {
+    if (!existsSync(join(projectDir, ".git")))
+        return null;
+    try {
+        const raw = execSync("git log -1 --format=%cI", {
+            cwd: projectDir,
+            stdio: ["pipe", "pipe", "pipe"],
+        })
+            .toString()
+            .trim();
+        return raw.length > 0 ? raw : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Formatter ───────────────────────────────────────────────────────────
+/**
+ * Format a GateViolationReport as a human-readable markdown block.
+ *
+ * @param report - The violation report to format
+ * @returns Formatted markdown text
+ */
+export function formatGateViolationReport(report) {
+    if (report.active.length === 0 && report.stale.length === 0) {
+        return "## Gate Violations\n\nNo violations recorded. Last commit gate was clean.";
+    }
+    const lines = ["## Gate Violations"];
+    if (report.lastCommitAt) {
+        lines.push(`_Last commit: ${report.lastCommitAt}_`);
+    }
+    lines.push("");
+    if (report.active.length > 0) {
+        lines.push(`### ❌ Active (${report.active.length}) — from after last commit`);
+        for (const v of report.active) {
+            lines.push(`- **${v.hook}** [${v.severity}]: ${v.message}`);
+            lines.push(`  _${v.timestamp}_`);
+        }
+        lines.push("");
+    }
+    if (report.stale.length > 0) {
+        lines.push(`### ⚪ Stale (${report.stale.length}) — cleared by last commit`);
+        for (const v of report.stale) {
+            lines.push(`- ~~${v.hook}~~: ${v.message}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=gate-violations.js.map

package/dist/tools/gate-violations.js.map

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

package/dist/tools/generate-adr.js

@@ -100,7 +100,7 @@ export async function generateAdrHandler(args) {
         content,
         "```",
         ``,
-        `> **Next step:** If any sections contain placeholders (\`[TODO]\`), complete them before committing.`,
+        `> **Next step:** If any sections contain \`[NEEDS CLARIFICATION]\` markers, resolve them before committing.`,
         `> ADR files are immutable once accepted — use a new ADR to supersede this one.`,
     ];
     return { content: [{ type: "text", text: lines.join("\n") }] };
@@ -140,7 +140,7 @@ function renderAdr(fields) {
     const date = new Date().toISOString().slice(0, 10);
     const alternativeBlock = alternatives && alternatives.length > 0
         ? alternatives.map((a) => `- ${a}`).join("\n")
-        : "- [TODO: list alternatives considered and why each was rejected]";
+        : "- [NEEDS CLARIFICATION: list alternatives considered and why each was rejected]";
     return [
         `# ${id}: ${title}`,
         ``,
@@ -154,12 +154,12 @@ function renderAdr(fields) {
         `## Context`,
         ``,
         context ??
-            "[TODO: describe the situation that forced this decision — constraints, requirements, and forces at play]",
+            "[NEEDS CLARIFICATION: describe the situation that forced this decision — what constraints, requirements, and forces are at play]",
         ``,
         `## Decision`,
         ``,
         decision ??
-            "[TODO: state what was decided and why this option was chosen over the alternatives]",
+            "[NEEDS CLARIFICATION: state what was decided and why this option was chosen over the alternatives]",
         ``,
         `## Alternatives Considered`,
         ``,
@@ -168,11 +168,11 @@ function renderAdr(fields) {
         `## Consequences`,
         ``,
         consequences ??
-            "[TODO: describe what becomes easier, harder, or newly constrained as a result of this decision]",
+            "[NEEDS CLARIFICATION: describe what becomes easier, harder, or newly constrained as a result of this decision]",
         ``,
         `---`,
         ``,
-        `_This ADR was generated by ForgeCraft. Complete any [TODO] sections before accepting._`,
+        `_This ADR was generated by ForgeCraft. Resolve any [NEEDS CLARIFICATION] sections before accepting — the AI cannot act on ambiguity it cannot see._`,
     ].join("\n");
 }
 //# sourceMappingURL=generate-adr.js.map

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

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

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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"}