forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/generate-harness.js

@@ -0,0 +1,395 @@
+/**
+ * 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 { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import yaml from "js-yaml";
+import { parseUseCases } from "./layer-status.js";
+import { generateProbeContent } from "./probe-templates.js";
+// ── Schema ───────────────────────────────────────────────────────────
+export const generateHarnessSchema = z.object({
+    project_dir: z.string().describe("Absolute path to the project root."),
+    uc_ids: z
+        .array(z.string())
+        .optional()
+        .describe("Specific UC ids to generate probes for (e.g. ['UC-001', 'UC-003']). " +
+        "If omitted, generates for all UCs with harness specs."),
+    force: z
+        .boolean()
+        .optional()
+        .describe("Overwrite existing probe files. Default: false — skip UCs that already have probe files."),
+});
+// ── Tag → probe type mapping ──────────────────────────────────────────
+const TAG_PROBE_MAP = {
+    "WEB-REACT": "playwright",
+    "WEB-NEXT": "playwright",
+    "WEB-STATIC": "playwright",
+    API: "api_call",
+    GAME: "headless_sim",
+    CLI: "file_system",
+    DATABASE: "db_query",
+    "DATA-PIPELINE": "db_query",
+    REALTIME: "websocket",
+    SOCIAL: "websocket",
+    FINTECH: "performance",
+    HEALTHCARE: "a11y",
+    HIPAA: "a11y",
+};
+function defaultProbeTypeForTags(tags) {
+    for (const tag of tags) {
+        const mapped = TAG_PROBE_MAP[tag];
+        if (mapped)
+            return mapped;
+    }
+    return "file_system";
+}
+// ── Probe file extension mapping ──────────────────────────────────────
+export function extensionForType(probeType) {
+    switch (probeType) {
+        case "playwright":
+            return ".spec.ts";
+        case "api_call":
+        case "hurl":
+            return ".hurl";
+        case "graphql":
+            return ".graphql.hurl";
+        case "headless_sim":
+            return ".sim.ts";
+        case "db_query":
+            return ".db.sh";
+        case "message_queue":
+            return ".mq.sh";
+        case "performance":
+            return ".k6.js";
+        case "websocket":
+            return ".ws.sh";
+        case "log_assertion":
+            return ".log.sh";
+        case "a11y":
+            return ".a11y.spec.ts";
+        case "contract_consumer":
+            return ".consumer.test.ts";
+        case "contract_provider":
+            return ".provider.test.ts";
+        case "grpc":
+            return ".grpc.sh";
+        case "security_scan":
+            return ".zap.sh";
+        case "mcp_call":
+        case "file_system":
+        default:
+            return ".sh";
+    }
+}
+// ── Error case parsing ────────────────────────────────────────────────
+export function parseErrorCases(ucSection) {
+    const errorCasesMatch = /\*\*Error Cases\*\*:([\s\S]*?)(?=\n\*\*|\n##|$)/i.exec(ucSection);
+    if (!errorCasesMatch)
+        return [];
+    const errorBlock = errorCasesMatch[1];
+    const cases = [];
+    const linePattern = /^\s+-\s+(.+?):\s*(.+)$/gm;
+    let m;
+    while ((m = linePattern.exec(errorBlock)) !== null) {
+        const name = m[1].trim();
+        const description = m[2].trim();
+        const slug = name
+            .toLowerCase()
+            .replace(/`/g, "")
+            .replace(/_/g, "-")
+            .replace(/[^a-z0-9\s-]/g, "")
+            .trim()
+            .replace(/\s+/g, "-")
+            .replace(/-+/g, "-");
+        cases.push({ name, slug, description });
+    }
+    return cases;
+}
+function readUcDetails(projectDir, ucId) {
+    const useCasesPath = join(projectDir, "docs", "use-cases.md");
+    const fallback = {
+        precondition: "(see use case)",
+        postcondition: "(see use case)",
+        steps: [],
+        errorCases: [],
+    };
+    if (!existsSync(useCasesPath))
+        return fallback;
+    try {
+        const content = readFileSync(useCasesPath, "utf-8");
+        const ucPattern = new RegExp(`##\\s+${ucId}:[\\s\\S]*?(?=\\n##\\s+UC-|$)`, "i");
+        const match = ucPattern.exec(content);
+        if (!match)
+            return fallback;
+        const section = match[0];
+        const preMatch = /\*\*Precondition\*\*:\s*(.+)/i.exec(section);
+        const postMatch = /\*\*Postcondition\*\*:\s*(.+)/i.exec(section);
+        const steps = [];
+        const stepPattern = /^\s+\d+\.\s+(.+)$/gm;
+        let m;
+        while ((m = stepPattern.exec(section)) !== null) {
+            steps.push(m[1].trim());
+        }
+        return {
+            precondition: preMatch ? preMatch[1].trim() : "(see use case)",
+            postcondition: postMatch ? postMatch[1].trim() : "(see use case)",
+            steps,
+            errorCases: parseErrorCases(section),
+        };
+    }
+    catch {
+        return fallback;
+    }
+}
+// ── Auto-spec generation ──────────────────────────────────────────────
+/**
+ * Build a minimal ProbeSpec from UC details when no YAML spec exists.
+ * The auto-spec is persisted so users can refine it for future runs.
+ */
+function autoGenerateHarnessSpec(ucId, title, probeType, details) {
+    const mainProbe = {
+        id: "happy",
+        type: probeType,
+        scenario: `${ucId} happy path — ${title}`,
+        description: `Auto-generated. Precondition: ${details.precondition}. Expected: ${details.postcondition}`,
+    };
+    const errorProbes = details.errorCases.map((ec) => ({
+        id: `error-${ec.slug}`,
+        type: probeType,
+        scenario: `${ucId} error — ${ec.name}`,
+        description: ec.description,
+    }));
+    return {
+        uc: ucId,
+        title,
+        action: details.steps[0] ?? "perform primary action",
+        probes: [mainProbe, ...errorProbes],
+    };
+}
+/**
+ * Write a YAML probe spec to .forgecraft/harness/<ucId>.yaml.
+ * Skips if the file already exists (never overwrites user-provided specs).
+ */
+function writeAutoHarnessSpec(projectDir, ucId, spec) {
+    const harnessSpecDir = join(projectDir, ".forgecraft", "harness");
+    const specPath = join(harnessSpecDir, `${ucId.toLowerCase()}.yaml`);
+    if (existsSync(specPath))
+        return false;
+    try {
+        mkdirSync(harnessSpecDir, { recursive: true });
+        const header = `# Auto-generated probe spec for ${ucId}.\n` +
+            `# Edit probe type, scenario, and description as needed.\n`;
+        writeFileSync(specPath, header + yaml.dump(spec, { lineWidth: 120, noRefs: true }), "utf-8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Probe spec reader ─────────────────────────────────────────────────
+function readProbeSpec(projectDir, ucId) {
+    const specPath = join(projectDir, ".forgecraft", "harness", `${ucId.toLowerCase()}.yaml`);
+    if (!existsSync(specPath))
+        return null;
+    try {
+        const raw = readFileSync(specPath, "utf-8");
+        return yaml.load(raw);
+    }
+    catch {
+        return null;
+    }
+}
+const PROBE_TYPE_PRIORITY = [
+    "playwright",
+    "a11y",
+    "api_call",
+    "hurl",
+    "graphql",
+    "headless_sim",
+    "db_query",
+    "message_queue",
+    "performance",
+    "websocket",
+    "log_assertion",
+    "contract_consumer",
+    "contract_provider",
+    "grpc",
+    "security_scan",
+    "mcp_call",
+    "file_system",
+];
+function detectProbeType(spec, tags) {
+    const types = (spec.probes ?? []).map((p) => p.type);
+    if (types.length > 0) {
+        for (const pt of PROBE_TYPE_PRIORITY) {
+            if (types.includes(pt))
+                return pt;
+        }
+        return types[0];
+    }
+    return defaultProbeTypeForTags(tags);
+}
+// ── Tags reader ───────────────────────────────────────────────────────
+function readProjectTags(projectDir) {
+    const yamlPath = join(projectDir, "forgecraft.yaml");
+    if (!existsSync(yamlPath))
+        return [];
+    try {
+        const raw = readFileSync(yamlPath, "utf-8");
+        const parsed = yaml.load(raw);
+        return parsed?.tags ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+// ── Probe file writer ─────────────────────────────────────────────────
+function writeProbeFile(harnessDir, fileName, content, force, ucId, title, probeType, results, autoSpec) {
+    const filePath = join(harnessDir, fileName);
+    if (existsSync(filePath) && !force) {
+        results.push({
+            ucId,
+            title,
+            status: "skipped",
+            probeFile: `tests/harness/${fileName}`,
+            probeType,
+            reason: "already exists",
+        });
+        return;
+    }
+    try {
+        writeFileSync(filePath, content, "utf-8");
+        results.push({
+            ucId,
+            title,
+            status: "generated",
+            probeFile: `tests/harness/${fileName}`,
+            probeType,
+            autoSpec,
+        });
+    }
+    catch (err) {
+        results.push({
+            ucId,
+            title,
+            status: "no_spec",
+            reason: `write failed: ${String(err)}`,
+        });
+    }
+}
+// ── Handler ───────────────────────────────────────────────────────────
+export async function generateHarnessHandler(args) {
+    const projectDir = resolve(args.project_dir);
+    const force = args.force ?? false;
+    const useCasesPath = join(projectDir, "docs", "use-cases.md");
+    let ucs = [];
+    if (existsSync(useCasesPath)) {
+        try {
+            ucs = parseUseCases(readFileSync(useCasesPath, "utf-8"));
+        }
+        catch {
+            /* leave empty */
+        }
+    }
+    const targetUcIds = args.uc_ids
+        ? new Set(args.uc_ids.map((id) => id.toUpperCase()))
+        : null;
+    const filteredUcs = targetUcIds
+        ? ucs.filter((uc) => targetUcIds.has(uc.id.toUpperCase()))
+        : ucs;
+    const tags = readProjectTags(projectDir);
+    const harnessDir = join(projectDir, "tests", "harness");
+    try {
+        mkdirSync(harnessDir, { recursive: true });
+    }
+    catch {
+        /* ignore */
+    }
+    const results = [];
+    for (const uc of filteredUcs) {
+        let spec = readProbeSpec(projectDir, uc.id);
+        let autoSpec = false;
+        if (!spec) {
+            const defaultProbeType = defaultProbeTypeForTags(tags);
+            const details = readUcDetails(projectDir, uc.id);
+            const generated = autoGenerateHarnessSpec(uc.id, uc.title, defaultProbeType, details);
+            if (writeAutoHarnessSpec(projectDir, uc.id, generated)) {
+                spec = generated;
+                autoSpec = true;
+            }
+        }
+        if (!spec) {
+            results.push({ ucId: uc.id, title: uc.title, status: "no_spec" });
+            continue;
+        }
+        const probeType = detectProbeType(spec, tags);
+        const ext = extensionForType(probeType);
+        const legacyFileName = `${uc.id.toLowerCase()}${ext}`;
+        const happyFileName = `${uc.id.toLowerCase()}-happy${ext}`;
+        const targetHappyFile = existsSync(join(harnessDir, legacyFileName))
+            ? legacyFileName
+            : happyFileName;
+        const details = readUcDetails(projectDir, uc.id);
+        const happyContent = generateProbeContent(uc.id, uc.title, probeType, details, "happy");
+        writeProbeFile(harnessDir, targetHappyFile, happyContent, force, uc.id, uc.title, probeType, results, autoSpec);
+        // Generate error probes from UC error cases
+        for (const errorCase of details.errorCases) {
+            const errorFileName = `${uc.id.toLowerCase()}-error-${errorCase.slug}${ext}`;
+            const errorDetails = { ...details, postcondition: errorCase.description };
+            const errorContent = generateProbeContent(uc.id, uc.title, probeType, errorDetails, "error");
+            writeProbeFile(harnessDir, errorFileName, errorContent, force, uc.id, uc.title, probeType, results, autoSpec);
+        }
+    }
+    const ucsWithoutSpec = ucs.filter((uc) => !existsSync(join(projectDir, ".forgecraft", "harness", `${uc.id.toLowerCase()}.yaml`)));
+    const generated = results.filter((r) => r.status === "generated");
+    const skipped = results.filter((r) => r.status === "skipped");
+    const noSpec = results.filter((r) => r.status === "no_spec");
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatReport(generated, skipped, noSpec, ucsWithoutSpec.length),
+            },
+        ],
+    };
+}
+function formatReport(generated, skipped, noSpec, totalNoSpec) {
+    const autoCount = generated.filter((r) => r.autoSpec).length;
+    const autoNote = autoCount > 0
+        ? ` (${autoCount} from auto-generated spec — edit .forgecraft/harness/uc-NNN.yaml to customise)`
+        : "";
+    const lines = [
+        "## Harness Generation Report",
+        "",
+        `Generated: ${generated.length} probe files${autoNote}`,
+        `Skipped:   ${skipped.length} (already exist, use force=true to overwrite)`,
+        `No spec:   ${totalNoSpec} (no .forgecraft/harness/uc-NNN.yaml — run layer_status to see gaps)`,
+    ];
+    if (generated.length > 0) {
+        lines.push("", "### Generated");
+        for (const r of generated) {
+            const tag = r.autoSpec ? " [auto-spec]" : "";
+            lines.push(`- ✅ ${r.probeFile}  (${r.probeType}, ${r.ucId}: ${r.title})${tag}`);
+        }
+    }
+    if (skipped.length > 0) {
+        lines.push("", "### Skipped (exist)");
+        for (const r of skipped) {
+            lines.push(`- ⏭ ${r.probeFile}  (${r.ucId}: ${r.title})`);
+        }
+    }
+    if (noSpec.length > 0) {
+        lines.push("", "### No Harness Spec");
+        for (const r of noSpec) {
+            lines.push(`- ❌ ${r.ucId}: ${r.title} — create .forgecraft/harness/${r.ucId.toLowerCase()}.yaml first`);
+        }
+    }
+    lines.push("", "Next: implement the TODO sections in each generated file.", "Run: npx forgecraft run_harness --project_dir .");
+    return lines.join("\n");
+}
+//# sourceMappingURL=generate-harness.js.map

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

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

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

@@ -7,7 +7,7 @@
  * generate_session_prompt). Idempotent — refuses to overwrite an existing roadmap.
  */
 import { z } from "zod";
-export { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, formatRmId, } from "./roadmap-builder.js";
+export { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, buildExecutableBringUpStub, buildExecutableVerifyStub, formatRmId, formatExId, EXECUTABLE_SPRINT_HEADER, } from "./roadmap-builder.js";
 export declare const generateRoadmapSchema: z.ZodObject<{
     project_dir: z.ZodString;
 }, "strip", z.ZodTypeAny, {

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

@@ -1 +1 @@
-{"version":3,"file":"generate-roadmap.d.ts","sourceRoot":"","sources":["../../src/tools/generate-roadmap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAI9B,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAIrE;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CAsFrB"}
+{"version":3,"file":"generate-roadmap.d.ts","sourceRoot":"","sources":["../../src/tools/generate-roadmap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,UAAU,EACV,UAAU,EACV,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAI9B,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAIrE;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CAkIrB"}

package/dist/tools/generate-roadmap.js

@@ -10,8 +10,10 @@ import { z } from "zod";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { runCascadeChecks, isCascadeComplete, buildGuidedRemediation, loadCascadeDecisions, } from "./check-cascade.js";
-import { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, formatRmId, } from "./roadmap-builder.js";
-export { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, formatRmId, } from "./roadmap-builder.js";
+import { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, buildExecutableBringUpStub, buildExecutableVerifyStub, formatRmId, formatExId, EXECUTABLE_SPRINT_HEADER, } from "./roadmap-builder.js";
+import { readProjectTags } from "./hardening-config.js";
+import { resolveExecutableGates, gateFilePath } from "./executable-gates.js";
+export { parseUseCaseTitles, readProjectName, buildRoadmapContent, buildSessionPromptStub, buildExecutableBringUpStub, buildExecutableVerifyStub, formatRmId, formatExId, EXECUTABLE_SPRINT_HEADER, } from "./roadmap-builder.js";
 // ── Schema ───────────────────────────────────────────────────────────
 export const generateRoadmapSchema = z.object({
     project_dir: z.string().describe("Absolute path to the project root."),
@@ -60,8 +62,10 @@ export async function generateRoadmapHandler(args) {
         : "docs/use-cases.md";
     const projectName = readProjectName(projectDir);
     const ucItems = parseUseCaseTitles(projectDir);
+    const tags = readProjectTags(projectDir);
+    const gates = resolveExecutableGates(tags);
     mkdirSync(join(projectDir, "docs"), { recursive: true });
-    writeFileSync(roadmapPath, buildRoadmapContent(projectName, ucItems, specFilePath), "utf-8");
+    writeFileSync(roadmapPath, buildRoadmapContent(projectName, ucItems, specFilePath, tags, projectDir), "utf-8");
     const stubsDir = join(projectDir, "docs", "session-prompts");
     mkdirSync(stubsDir, { recursive: true });
     const writtenStubs = [];
@@ -72,16 +76,46 @@ export async function generateRoadmapHandler(args) {
         writeFileSync(join(stubsDir, `${rmId}.md`), buildSessionPromptStub(rmId, title, uc.id), "utf-8");
         writtenStubs.push(`docs/session-prompts/${rmId}.md`);
     }
+    // Executable Sprint stubs + gate files
+    writeFileSync(join(stubsDir, `${EXECUTABLE_SPRINT_HEADER.id}.md`), buildExecutableBringUpStub(projectName, tags), "utf-8");
+    writtenStubs.push(`docs/session-prompts/${EXECUTABLE_SPRINT_HEADER.id}.md`);
+    for (let i = 0; i < ucItems.length; i++) {
+        const uc = ucItems[i];
+        const exId = formatExId(i + 1);
+        writeFileSync(join(stubsDir, `${exId}.md`), buildExecutableVerifyStub(exId, uc.id, uc.title, tags), "utf-8");
+        writtenStubs.push(`docs/session-prompts/${exId}.md`);
+        // Write runnable gate file stubs for each applicable tool
+        for (const gate of gates) {
+            const relPath = gateFilePath(gate, uc.id);
+            const absPath = join(projectDir, relPath);
+            mkdirSync(join(absPath, ".."), { recursive: true });
+            if (!existsSync(absPath)) {
+                writeFileSync(absPath, gate.buildStub(uc.id, uc.title), "utf-8");
+                writtenStubs.push(relPath);
+            }
+        }
+    }
     const phase1List = ucItems
         .map((uc, i) => `- **${formatRmId(i + 1)}**: Implement ${uc.id}: ${uc.title}`)
         .join("\n");
+    const exList = [
+        EXECUTABLE_SPRINT_HEADER,
+        ...ucItems.map((uc, i) => ({
+            id: formatExId(i + 1),
+            title: `Verify live: ${uc.id} — ${uc.title}`,
+        })),
+    ]
+        .map((item) => `- **${item.id}**: ${item.title}`)
+        .join("\n");
     return {
         content: [
             {
                 type: "text",
                 text: `## Roadmap Generated\n\n` +
-                    `Written to \`docs/roadmap.md\` with ${ucItems.length} Phase 1 items.\n\n` +
+                    `Written to \`docs/roadmap.md\` with ${ucItems.length} Phase 1 items + ${ucItems.length + 1} Executable Sprint items.\n\n` +
                     `### Phase 1 Items\n${phase1List}\n\n` +
+                    `### Executable Sprint Items\n${exList}\n\n` +
+                    `> Complete the Executable Sprint before Phase 2. Each EX item proves a use case works end-to-end.\n\n` +
                     `### Session Prompt Stubs Written\n` +
                     writtenStubs.map((p) => `- \`${p}\``).join("\n") +
                     `\n\nRun \`generate_session_prompt\` with an item's description to get the full bound prompt.`,

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

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

package/dist/tools/generate-session-prompt.d.ts

@@ -9,7 +9,7 @@
 import { z } from "zod";
 import type { ToolResult, ToolAmbiguity } from "../shared/types.js";
 export type { ArtifactContext, PromptBuildInput, McpServerYamlEntry, McpServersYaml, } from "./session-prompt-builders.js";
-export { buildPrompt, loadMcpServerDescriptions, buildMcpToolsSection, FORGECRAFT_PRIMARY_USE, discoverArtifacts, readStatusSummary, buildDefaultCriteria, } from "./session-prompt-builders.js";
+export { buildPrompt, loadMcpServerDescriptions, buildMcpToolsSection, FORGECRAFT_PRIMARY_USE, discoverArtifacts, readStatusSummary, buildDefaultCriteria, detectClarificationMarkers, buildClarificationWarning, } from "./session-prompt-builders.js";
 export { isPlaceholderTestScript, deriveTestCommand, isServerConfigured, buildContextLoadBlock, buildTddGateSection, buildContextRetrievalSection, buildExecutionLoopSection, } from "./session-prompt-sections.js";
 export declare const generateSessionPromptSchema: z.ZodObject<{
     project_dir: z.ZodString;
@@ -20,7 +20,7 @@ export declare const generateSessionPromptSchema: z.ZodObject<{
     session_type: z.ZodDefault<z.ZodEnum<["feature", "fix", "refactor", "test", "docs", "chore"]>>;
 }, "strip", z.ZodTypeAny, {
     project_dir: string;
-    session_type: "docs" | "test" | "fix" | "refactor" | "chore" | "feature";
+    session_type: "test" | "docs" | "feature" | "fix" | "refactor" | "chore";
     item_description?: string | undefined;
     acceptance_criteria?: string[] | undefined;
     scope_note?: string | undefined;
@@ -30,7 +30,7 @@ export declare const generateSessionPromptSchema: z.ZodObject<{
     item_description?: string | undefined;
     acceptance_criteria?: string[] | undefined;
     scope_note?: string | undefined;
-    session_type?: "docs" | "test" | "fix" | "refactor" | "chore" | "feature" | undefined;
+    session_type?: "test" | "docs" | "feature" | "fix" | "refactor" | "chore" | undefined;
     roadmap_item_id?: string | undefined;
 }>;
 export type GenerateSessionPromptInput = z.infer<typeof generateSessionPromptSchema>;

package/dist/tools/generate-session-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-session-prompt.d.ts","sourceRoot":"","sources":["../../src/tools/generate-session-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAapE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AAGtC,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAuCtC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,2BAA2B,CACnC,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,UAAU,CAAC,CAyGrB;AAmFD,YAAY,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"generate-session-prompt.d.ts","sourceRoot":"","sources":["../../src/tools/generate-session-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAcpE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AAGtC,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAuCtC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,2BAA2B,CACnC,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,UAAU,CAAC,CAkHrB;AAmFD,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/tools/generate-session-prompt.js

@@ -12,9 +12,10 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { runCascadeChecks, isCascadeComplete, buildGuidedRemediation, loadCascadeDecisions, } from "./check-cascade.js";
 import { findNextRoadmapItem, parseRoadmapItems } from "./close-cycle.js";
 import { detectSpecRoadmapDrift } from "../shared/drift-detector.js";
+import { readPractitionerLevel } from "../shared/config.js";
 import { buildPrompt, discoverArtifacts, buildDefaultCriteria, buildRoadmapItemAmbiguity, } from "./session-prompt-builders.js";
 import { buildConsolidatedStatus, formatConsolidatedStatus, } from "./consolidate-status.js";
-export { buildPrompt, loadMcpServerDescriptions, buildMcpToolsSection, FORGECRAFT_PRIMARY_USE, discoverArtifacts, readStatusSummary, buildDefaultCriteria, } from "./session-prompt-builders.js";
+export { buildPrompt, loadMcpServerDescriptions, buildMcpToolsSection, FORGECRAFT_PRIMARY_USE, discoverArtifacts, readStatusSummary, buildDefaultCriteria, detectClarificationMarkers, buildClarificationWarning, } from "./session-prompt-builders.js";
 export { isPlaceholderTestScript, deriveTestCommand, isServerConfigured, buildContextLoadBlock, buildTddGateSection, buildContextRetrievalSection, buildExecutionLoopSection, } from "./session-prompt-sections.js";
 // ── Schema ───────────────────────────────────────────────────────────
 export const generateSessionPromptSchema = z.object({
@@ -125,6 +126,11 @@ export async function generateSessionPromptHandler(args) {
     const artifacts = discoverArtifacts(projectDir);
     const statusSummary = formatConsolidatedStatus(buildConsolidatedStatus(projectDir));
     const criteria = args.acceptance_criteria ?? buildDefaultCriteria(resolvedDescription);
+    const stateLeafPath = join(projectDir, ".claude", "state.md");
+    const stateLeaf = existsSync(stateLeafPath)
+        ? readFileSync(stateLeafPath, "utf-8")
+        : undefined;
+    const practitionerLevel = readPractitionerLevel(projectDir);
     const prompt = buildPrompt({
         projectDir,
         itemDescription: resolvedDescription,
@@ -133,6 +139,8 @@ export async function generateSessionPromptHandler(args) {
         acceptanceCriteria: criteria,
         artifacts,
         statusSummary,
+        stateLeaf,
+        practitionerLevel,
     });
     if (resolvedItemId)
         writeSessionPromptFile(projectDir, resolvedItemId, prompt);

package/dist/tools/generate-session-prompt.js.map

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