forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/probe-runners.js

@@ -0,0 +1,246 @@
+/**
+ * Probe execution runners for run_harness.
+ * Each function executes a probe file of a given type.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+// ── Helpers ───────────────────────────────────────────────────────────
+export function combineOutput(stdout, stderr) {
+    const parts = [];
+    if (stdout?.trim())
+        parts.push(stdout.trim());
+    if (stderr?.trim())
+        parts.push(stderr.trim());
+    return parts.join("\n");
+}
+const NOT_IMPLEMENTED_PATTERNS = [
+    "not yet implemented",
+    "not implemented",
+    "TODO: implement",
+    "ProbeNotImplemented",
+];
+export function isNotImplementedOutput(output) {
+    const lower = output.toLowerCase();
+    return NOT_IMPLEMENTED_PATTERNS.some((p) => lower.includes(p.toLowerCase()));
+}
+export function isToolAvailable(tool) {
+    try {
+        const result = spawnSync(tool, ["--version"], {
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 5000,
+        });
+        return result.status !== null && result.error === undefined;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Probe dispatch ────────────────────────────────────────────────────
+export function runProbe(probePath, fileName, timeoutMs) {
+    const start = Date.now();
+    if (fileName.endsWith(".a11y.spec.ts") || fileName.endsWith(".spec.ts")) {
+        return runPlaywrightProbe(probePath, timeoutMs, start);
+    }
+    if (fileName.endsWith(".graphql.hurl") || fileName.endsWith(".hurl")) {
+        return runHurlProbe(probePath, timeoutMs, start);
+    }
+    if (fileName.endsWith(".sim.ts")) {
+        return runVitestProbe(probePath, timeoutMs, start);
+    }
+    if (fileName.endsWith(".consumer.test.ts") ||
+        fileName.endsWith(".provider.test.ts")) {
+        return runVitestProbe(probePath, timeoutMs, start);
+    }
+    if (fileName.endsWith(".k6.js")) {
+        return runK6Probe(probePath, timeoutMs, start);
+    }
+    if (fileName.endsWith(".db.sh") ||
+        fileName.endsWith(".mq.sh") ||
+        fileName.endsWith(".ws.sh") ||
+        fileName.endsWith(".log.sh") ||
+        fileName.endsWith(".grpc.sh") ||
+        fileName.endsWith(".zap.sh") ||
+        fileName.endsWith(".sh")) {
+        return runShProbe(probePath, timeoutMs, start);
+    }
+    return {
+        status: "error",
+        durationMs: Date.now() - start,
+        output: `Unknown probe type: ${fileName}`,
+    };
+}
+// ── Individual runners ────────────────────────────────────────────────
+export function runPlaywrightProbe(probePath, timeoutMs, start) {
+    try {
+        const result = spawnSync("npx", ["playwright", "test", probePath, "--reporter=line"], {
+            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: "playwright 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: "tool_missing",
+            durationMs: Date.now() - start,
+            output: `playwright not available: ${String(err)}`,
+        };
+    }
+}
+export function runHurlProbe(probePath, timeoutMs, start) {
+    try {
+        // Look for hurl.env in the probe's directory for variable injection ({{host}}, etc.)
+        const probeDir = dirname(probePath);
+        const hurlEnvPath = join(probeDir, "hurl.env");
+        // Inject a per-run unique uid so each harness run uses fresh test users.
+        // This avoids 422 failures caused by duplicate username/email from prior runs.
+        const runUid = `r${Date.now().toString(36)}`;
+        const hurlArgs = existsSync(hurlEnvPath)
+            ? [
+                "--variables-file",
+                hurlEnvPath,
+                "--variable",
+                `uid=${runUid}`,
+                probePath,
+            ]
+            : ["--variable", `uid=${runUid}`, probePath];
+        const result = spawnSync("hurl", hurlArgs, {
+            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: "hurl 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: "tool_missing",
+            durationMs: Date.now() - start,
+            output: `hurl not available: ${String(err)}`,
+        };
+    }
+}
+export function runVitestProbe(probePath, timeoutMs, start) {
+    try {
+        const result = spawnSync("npx", ["vitest", "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: "vitest 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: "tool_missing",
+            durationMs: Date.now() - start,
+            output: `vitest not available: ${String(err)}`,
+        };
+    }
+}
+export function runK6Probe(probePath, timeoutMs, start) {
+    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: "tool_missing",
+            durationMs: Date.now() - start,
+            output: `k6 not available: ${String(err)}`,
+        };
+    }
+}
+export function runShProbe(probePath, timeoutMs, start) {
+    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: "tool_missing",
+            durationMs: Date.now() - start,
+            output: `bash not available: ${String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=probe-runners.js.map

package/dist/tools/probe-runners.js.map

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

package/dist/tools/probe-templates.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Probe content template generators for generate_harness.
+ * Each function returns the file content for a given probe type.
+ */
+import type { ProbeType } from "./generate-harness.js";
+export interface UcDetails {
+    precondition: string;
+    postcondition: string;
+    steps: string[];
+}
+export declare function generatePlaywrightProbe(ucId: string, title: string, precondition: string, postcondition: string, steps: string[], scenario?: string): string;
+export declare function generateHurlProbe(ucId: string, title: string, precondition: string, postcondition: string, steps: string[], scenario?: string): string;
+export declare function generateGraphqlHurlProbe(ucId: string, title: string, postcondition: string, scenario?: string): string;
+export declare function generateShProbe(ucId: string, title: string, postcondition: string, probeType: ProbeType, scenario?: string): string;
+export declare function generateDbShProbe(ucId: string, title: string, postcondition: string, scenario?: string): string;
+export declare function generateMqShProbe(ucId: string, title: string, postcondition: string, scenario?: string): string;
+export declare function generateK6Probe(ucId: string, title: string, postcondition: string, scenario?: string): string;
+export declare function generateWsShProbe(ucId: string, title: string, postcondition: string, scenario?: string): string;
+export declare function generateLogShProbe(ucId: string, title: string, _postcondition: string, scenario?: string): string;
+export declare function generateA11yProbe(ucId: string, title: string): string;
+export declare function generateConsumerContractProbe(ucId: string, title: string): string;
+export declare function generateProviderContractProbe(ucId: string, title: string): string;
+export declare function generateGrpcShProbe(ucId: string, title: string, postcondition: string, scenario?: string): string;
+export declare function generateZapShProbe(ucId: string, title: string): string;
+export declare function generateSimProbe(ucId: string, title: string): string;
+export declare function generateProbeContent(ucId: string, title: string, probeType: ProbeType, details: UcDetails, scenario?: string): string;
+//# sourceMappingURL=probe-templates.d.ts.map

package/dist/tools/probe-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-templates.d.ts","sourceRoot":"","sources":["../../src/tools/probe-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,SAAU,GACjB,MAAM,CAmBR;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,SAAU,GACjB,MAAM,CAcR;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,QAAQ,SAAU,GACjB,MAAM,CAUR;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,SAAS,EACpB,QAAQ,SAAU,GACjB,MAAM,CAgBR;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,QAAQ,SAAU,GACjB,MAAM,CAaR;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,QAAQ,SAAU,GACjB,MAAM,CAkBR;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,QAAQ,SAAU,GACjB,MAAM,CAmBR;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,QAAQ,SAAU,GACjB,MAAM,CAcR;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,QAAQ,SAAU,GACjB,MAAM,CAUR;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBrE;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAkBR;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAiBR;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,QAAQ,SAAU,GACjB,MAAM,CAaR;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBtE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,SAAS,EAClB,QAAQ,SAAU,GACjB,MAAM,CAoER"}

package/dist/tools/probe-templates.js

@@ -0,0 +1,279 @@
+/**
+ * Probe content template generators for generate_harness.
+ * Each function returns the file content for a given probe type.
+ */
+// ── Template generators ───────────────────────────────────────────────
+export function generatePlaywrightProbe(ucId, title, precondition, postcondition, steps, scenario = "happy") {
+    const stepComments = steps.length > 0
+        ? steps.map((s, i) => `    // Step ${i + 1}: ${s}`).join("\n")
+        : `    // TODO: implement ${ucId} main flow steps`;
+    return `import { test, expect } from '@playwright/test';
+
+/**
+ * L2 Harness: ${ucId} — ${title} [${scenario}]
+ * Precondition: ${precondition}
+ * Postcondition: ${postcondition}
+ */
+test.describe('${ucId}: ${title}', () => {
+  test('postcondition: ${postcondition}', async ({ page }) => {
+${stepComments}
+    throw new Error('Probe not yet implemented — fill in the ${ucId} flow');
+  });
+});
+`;
+}
+export function generateHurlProbe(ucId, title, precondition, postcondition, steps, scenario = "happy") {
+    const stepComments = steps.length > 0
+        ? steps.map((s, i) => `# Step ${i + 1}: ${s}`).join("\n")
+        : `# TODO: implement ${ucId} main flow steps`;
+    return `# L2 Harness: ${ucId} — ${title} [${scenario}]
+# Precondition: ${precondition}
+# Postcondition: ${postcondition}
+${stepComments}
+POST http://{{host}}/api/endpoint
+Content-Type: application/json
+{ "field": "value" }
+HTTP 200
+`;
+}
+export function generateGraphqlHurlProbe(ucId, title, postcondition, scenario = "happy") {
+    return `# L2 Harness: ${ucId} — ${title} [${scenario}]
+# GraphQL postcondition: ${postcondition}
+POST http://{{host}}/graphql
+Content-Type: application/json
+{ "query": "query { __typename }", "variables": {} }
+HTTP 200
+[Asserts]
+jsonpath "$.data" exists
+`;
+}
+export function generateShProbe(ucId, title, postcondition, probeType, scenario = "happy") {
+    if (probeType === "mcp_call") {
+        return `#!/usr/bin/env bash
+# L2 Harness: ${ucId} — ${title} [${scenario}]
+# Verifies MCP action postconditions
+set -euo pipefail
+echo "TODO: implement ${ucId} MCP probe"
+exit 1
+`;
+    }
+    return `#!/usr/bin/env bash
+# L2 Harness: ${ucId} — ${title} [${scenario}]
+# Postcondition: ${postcondition}
+set -euo pipefail
+echo "PASS: ${ucId} postcondition verified"
+`;
+}
+export function generateDbShProbe(ucId, title, postcondition, scenario = "happy") {
+    return `#!/usr/bin/env bash
+# L2 Harness: ${ucId} — ${title} [${scenario}]
+# DB postcondition: ${postcondition}
+set -euo pipefail
+DB_URL="\${DATABASE_URL:-}"
+if [ -z "$DB_URL" ]; then
+  echo "SKIP: DATABASE_URL not set — cannot verify DB postcondition"
+  exit 0
+fi
+echo "TODO: implement DB postcondition check for ${ucId} [${scenario}]"
+exit 1
+`;
+}
+export function generateMqShProbe(ucId, title, postcondition, scenario = "happy") {
+    return `#!/usr/bin/env bash
+# L2 Harness: ${ucId} — ${title} [${scenario}]
+# Queue postcondition: ${postcondition}
+set -euo pipefail
+BROKER="\${KAFKA_BROKER:?KAFKA_BROKER is required}"
+TOPIC="\${QUEUE_TOPIC:-}"
+if command -v kcat &>/dev/null; then
+  echo "TODO: assert event published to $TOPIC via kcat"
+  exit 1
+elif command -v rabbitmqadmin &>/dev/null; then
+  echo "TODO: rabbitmqadmin get queue={{queue_name}}"
+  exit 1
+else
+  echo "SKIP: no queue inspection tool found (kcat, rabbitmqadmin)"
+  exit 0
+fi
+`;
+}
+export function generateK6Probe(ucId, title, postcondition, scenario = "happy") {
+    return `// L2 Harness: ${ucId} — ${title} [${scenario}]
+// NFR contract: ${postcondition}
+import http from 'k6/http';
+import { check, sleep } from 'k6';
+export const options = {
+  vus: 10,
+  duration: '30s',
+  thresholds: {
+    http_req_duration: ['p(99)<500'],
+    http_req_failed: ['rate<0.01'],
+  },
+};
+export default function () {
+  const res = http.get(__ENV.API_URL + '/api/health');
+  check(res, { 'status is 200': (r) => r.status === 200 });
+  sleep(1);
+}
+`;
+}
+export function generateWsShProbe(ucId, title, postcondition, scenario = "happy") {
+    return `#!/usr/bin/env bash
+# L2 Harness: ${ucId} — ${title} [${scenario}]
+# WebSocket postcondition: ${postcondition}
+set -euo pipefail
+WS_URL="\${WS_URL:?WS_URL is required}"
+if command -v wscat &>/dev/null; then
+  echo "TODO: assert WebSocket message for ${ucId} [${scenario}]"
+  exit 1
+else
+  echo "SKIP: wscat not found (npm install -g wscat)"
+  exit 0
+fi
+`;
+}
+export function generateLogShProbe(ucId, title, _postcondition, scenario = "happy") {
+    return `#!/usr/bin/env bash
+# L2 Harness: ${ucId} — ${title} [${scenario}]
+# Log postcondition: structured log entry must appear after use case execution
+set -euo pipefail
+LOG_FILE="\${LOG_FILE:-/tmp/app.log}"
+EXPECTED_PATTERN="\${LOG_PATTERN:-${ucId}}"
+echo "TODO: implement log assertion for ${ucId} [${scenario}]"
+exit 1
+`;
+}
+export function generateA11yProbe(ucId, title) {
+    return `import { test, expect } from '@playwright/test';
+import AxeBuilder from '@axe-core/playwright';
+
+/**
+ * L2 Harness: ${ucId} — ${title} [Accessibility]
+ * Contract: Zero WCAG 2.1 AA violations on the primary use case page.
+ */
+test.describe('${ucId} Accessibility: ${title}', () => {
+  test('WCAG 2.1 AA — zero violations', async ({ page }) => {
+    await page.goto(process.env['BASE_URL'] ?? '');
+    const results = await new AxeBuilder({ page })
+      .withTags(['wcag2a', 'wcag2aa', 'wcag21aa'])
+      .analyze();
+    expect(results.violations).toEqual([]);
+  });
+});
+`;
+}
+export function generateConsumerContractProbe(ucId, title) {
+    return `import { PactV3 } from '@pact-foundation/pact';
+import { join } from 'path';
+
+/**
+ * L2 Harness: ${ucId} — ${title} [Consumer Contract]
+ */
+const provider = new PactV3({
+  consumer: '{{consumer_name}}',
+  provider: '{{provider_name}}',
+  dir: join(__dirname, '../../pacts'),
+});
+describe('${ucId} Consumer Contract', () => {
+  it('has a valid interaction for ${title}', async () => {
+    throw new Error('Not implemented: define the Pact interaction for ${ucId}');
+  });
+});
+`;
+}
+export function generateProviderContractProbe(ucId, title) {
+    return `import { Verifier } from '@pact-foundation/pact';
+import { join } from 'path';
+
+/**
+ * L2 Harness: ${ucId} — ${title} [Provider Verification]
+ */
+describe('${ucId} Provider Verification', () => {
+  it('satisfies all consumer contracts', async () => {
+    return new Verifier({
+      provider: '{{provider_name}}',
+      providerBaseUrl: process.env.PROVIDER_URL ?? 'http://localhost:3000',
+      pactUrls: [join(__dirname, '../../pacts')],
+    }).verifyProvider();
+  });
+});
+`;
+}
+export function generateGrpcShProbe(ucId, title, postcondition, scenario = "happy") {
+    return `#!/usr/bin/env bash
+# L2 Harness: ${ucId} — ${title} [${scenario}]
+# gRPC postcondition: ${postcondition}
+set -euo pipefail
+GRPC_HOST="\${GRPC_HOST:?GRPC_HOST is required}"
+if ! command -v grpcurl &>/dev/null; then
+  echo "SKIP: grpcurl not found (brew install grpcurl)"
+  exit 0
+fi
+echo "TODO: implement gRPC probe for ${ucId} [${scenario}]"
+exit 1
+`;
+}
+export function generateZapShProbe(ucId, title) {
+    return `#!/usr/bin/env bash
+# L2 Harness: ${ucId} — ${title} [Security Scan]
+# Contract: zero HIGH/CRITICAL vulnerabilities on the use case endpoint.
+set -euo pipefail
+TARGET_URL="\${TARGET_URL:?TARGET_URL is required}"
+if ! command -v docker &>/dev/null; then
+  echo "SKIP: docker not found — cannot run OWASP ZAP scan"
+  exit 0
+fi
+docker run --rm -t owasp/zap2docker-stable \\
+  zap-baseline.py -t "$TARGET_URL" -l WARN --exit-code true 2>&1 || {
+    echo "FAIL: ZAP found vulnerabilities on $TARGET_URL"
+    exit 1
+  }
+`;
+}
+export function generateSimProbe(ucId, title) {
+    return `/**
+ * L2 Harness: ${ucId} — ${title}
+ * Headless simulation probe — verifies behavioral invariants without rendering.
+ */
+throw new Error('Probe not yet implemented — implement the ${ucId} simulation scenario');
+`;
+}
+export function generateProbeContent(ucId, title, probeType, details, scenario = "happy") {
+    switch (probeType) {
+        case "playwright":
+            return generatePlaywrightProbe(ucId, title, details.precondition, details.postcondition, details.steps, scenario);
+        case "api_call":
+        case "hurl":
+            return generateHurlProbe(ucId, title, details.precondition, details.postcondition, details.steps, scenario);
+        case "graphql":
+            return generateGraphqlHurlProbe(ucId, title, details.postcondition, scenario);
+        case "headless_sim":
+            return generateSimProbe(ucId, title);
+        case "db_query":
+            return generateDbShProbe(ucId, title, details.postcondition, scenario);
+        case "message_queue":
+            return generateMqShProbe(ucId, title, details.postcondition, scenario);
+        case "performance":
+            return generateK6Probe(ucId, title, details.postcondition, scenario);
+        case "websocket":
+            return generateWsShProbe(ucId, title, details.postcondition, scenario);
+        case "log_assertion":
+            return generateLogShProbe(ucId, title, details.postcondition, scenario);
+        case "a11y":
+            return generateA11yProbe(ucId, title);
+        case "contract_consumer":
+            return generateConsumerContractProbe(ucId, title);
+        case "contract_provider":
+            return generateProviderContractProbe(ucId, title);
+        case "grpc":
+            return generateGrpcShProbe(ucId, title, details.postcondition, scenario);
+        case "security_scan":
+            return generateZapShProbe(ucId, title);
+        case "mcp_call":
+            return generateShProbe(ucId, title, details.postcondition, "mcp_call", scenario);
+        case "file_system":
+        default:
+            return generateShProbe(ucId, title, details.postcondition, "file_system", scenario);
+    }
+}
+//# sourceMappingURL=probe-templates.js.map

package/dist/tools/probe-templates.js.map

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

package/dist/tools/propose-session.d.ts

@@ -0,0 +1,28 @@
+/**
+ * propose_session tool handler.
+ *
+ * Produces a pre-implementation impact assessment before generate_session_prompt runs.
+ * Adapted from OpenSpec's Propose phase, extended with forgecraft's layer-awareness.
+ *
+ * Output: which specs will change (ADDED/MODIFIED), which layers are affected,
+ * which gates must pass before close_cycle, and an implementation checklist.
+ * Writes .forgecraft/proposal.md as a persistent artifact.
+ */
+import { z } from "zod";
+import type { ToolResult } from "../shared/types.js";
+export declare const proposeSessionSchema: z.ZodObject<{
+    project_dir: z.ZodString;
+    item_description: z.ZodOptional<z.ZodString>;
+    roadmap_item_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project_dir: string;
+    item_description?: string | undefined;
+    roadmap_item_id?: string | undefined;
+}, {
+    project_dir: string;
+    item_description?: string | undefined;
+    roadmap_item_id?: string | undefined;
+}>;
+export type ProposeSessionInput = z.infer<typeof proposeSessionSchema>;
+export declare function proposeSessionHandler(args: ProposeSessionInput): Promise<ToolResult>;
+//# sourceMappingURL=propose-session.d.ts.map

package/dist/tools/propose-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose-session.d.ts","sourceRoot":"","sources":["../../src/tools/propose-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMrD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAe/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAqBvE,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,UAAU,CAAC,CAqDrB"}