forgecraft-mcp 1.3.2 → 1.6.1

package/dist/tools/executable-gates.js

@@ -0,0 +1,332 @@
+/**
+ * Tag-driven executable gate matrix for the Executable Sprint phase.
+ *
+ * Each project tag maps to one or more verification tools. When `generate_roadmap`
+ * runs, it reads the project's tags from forgecraft.yaml and selects the appropriate
+ * gates. Gate files (hurl specs, Playwright tests, SQL scripts, WebSocket clients)
+ * are written alongside the session prompt stubs so the AI has a runnable starting
+ * point rather than prose instructions alone.
+ */
+// ── Gate implementations ─────────────────────────────────────────────
+const hurlGate = {
+    tool: "hurl",
+    label: "HTTP contract verification (hurl)",
+    gatePathTemplate: "tests/hurl/{ucId}.hurl",
+    docsUrl: "https://hurl.dev",
+    runCommand: "hurl --test tests/hurl/*.hurl",
+    buildStub: (ucId, ucTitle) => [
+        `# Hurl gate — ${ucId}: ${ucTitle}`,
+        `# Run: hurl --test tests/hurl/${ucId.toLowerCase()}.hurl`,
+        `# Docs: https://hurl.dev`,
+        ``,
+        `# TODO: replace placeholders with actual endpoint, headers, and assertions`,
+        ``,
+        `POST http://localhost:3000/api/v1/TODO`,
+        `Content-Type: application/json`,
+        `{`,
+        `  "TODO": "replace with request body"`,
+        `}`,
+        ``,
+        `HTTP 201`,
+        `[Asserts]`,
+        `jsonpath "$.id" exists`,
+        `jsonpath "$.TODO" isString`,
+        ``,
+    ].join("\n"),
+};
+const playwrightGate = {
+    tool: "playwright",
+    label: "UI end-to-end verification (Playwright)",
+    gatePathTemplate: "tests/e2e/{ucId}.spec.ts",
+    docsUrl: "https://playwright.dev",
+    runCommand: "npx playwright test tests/e2e/",
+    buildStub: (ucId, ucTitle) => [
+        `import { test, expect } from '@playwright/test';`,
+        ``,
+        `// Playwright gate — ${ucId}: ${ucTitle}`,
+        `// Run: npx playwright test tests/e2e/${ucId.toLowerCase()}.spec.ts`,
+        `// Docs: https://playwright.dev`,
+        ``,
+        `test('${ucId}: ${ucTitle}', async ({ page }) => {`,
+        `  // 1. Navigate to the relevant page`,
+        `  await page.goto('http://localhost:3000/TODO');`,
+        ``,
+        `  // 2. Interact: fill inputs, click buttons`,
+        `  await page.fill('[data-testid="TODO"]', 'test value');`,
+        `  await page.click('[data-testid="submit-TODO"]');`,
+        ``,
+        `  // 3. Assert UI response`,
+        `  await expect(page.locator('[data-testid="success-TODO"]')).toBeVisible();`,
+        ``,
+        `  // 4. Confirm DB persistence (via API read-back or direct query)`,
+        `  // TODO: add DB assertion or API read-back call here`,
+        `});`,
+        ``,
+    ].join("\n"),
+};
+const sqlGate = {
+    tool: "sql-client",
+    label: "Database persistence verification (SQL)",
+    gatePathTemplate: "tests/sql/{ucId}.sql",
+    docsUrl: "https://www.postgresql.org/docs/current/app-psql.html",
+    runCommand: "psql $DATABASE_URL -f tests/sql/*.sql",
+    buildStub: (ucId, ucTitle) => [
+        `-- SQL gate — ${ucId}: ${ucTitle}`,
+        `-- Run: psql $DATABASE_URL -f tests/sql/${ucId.toLowerCase()}.sql`,
+        `-- Purpose: confirm expected state change persisted after the use-case operation`,
+        ``,
+        `-- TODO: replace with the actual table and conditions for this use case`,
+        ``,
+        `SELECT COUNT(*) AS row_count`,
+        `FROM TODO_table`,
+        `WHERE TODO_condition = 'expected_value';`,
+        ``,
+        `-- Expected: row_count >= 1`,
+        `-- If 0, the operation did not persist correctly`,
+        ``,
+    ].join("\n"),
+};
+const websocketGate = {
+    tool: "ws-client",
+    label: "Real-time event delivery verification (WebSocket)",
+    gatePathTemplate: "tests/realtime/{ucId}.ts",
+    docsUrl: "https://github.com/websockets/ws",
+    runCommand: "npx tsx tests/realtime/*.ts",
+    buildStub: (ucId, ucTitle) => [
+        `import WebSocket from 'ws';`,
+        ``,
+        `// WebSocket gate — ${ucId}: ${ucTitle}`,
+        `// Run: npx tsx tests/realtime/${ucId.toLowerCase()}.ts`,
+        `// Docs: https://github.com/websockets/ws`,
+        ``,
+        `const ws = new WebSocket('ws://localhost:3000/TODO');`,
+        ``,
+        `ws.on('open', () => {`,
+        `  // Trigger the event that should produce a real-time message`,
+        `  ws.send(JSON.stringify({ type: 'TODO', payload: {} }));`,
+        `});`,
+        ``,
+        `ws.on('message', (data) => {`,
+        `  const msg = JSON.parse(data.toString());`,
+        `  // TODO: assert expected message shape`,
+        `  console.assert(msg.type === 'TODO', 'Expected event type TODO');`,
+        `  ws.close();`,
+        `  process.exit(0);`,
+        `});`,
+        ``,
+        `setTimeout(() => { console.error('TIMEOUT: no message received'); process.exit(1); }, 5000);`,
+        ``,
+    ].join("\n"),
+};
+// ── Tag → gate matrix ─────────────────────────────────────────────────
+// Game gates — three complementary verification types
+const gameSimulationGate = {
+    tool: "game-simulation",
+    label: "Headless balance simulation (win rate, reachability, termination)",
+    gatePathTemplate: "tests/simulation/{ucId}.sim.ts",
+    docsUrl: "https://en.wikipedia.org/wiki/Monte_Carlo_method",
+    runCommand: "npx tsx tests/simulation/*.sim.ts",
+    buildStub: (ucId, ucTitle) => [
+        `// Headless simulation gate — ${ucId}: ${ucTitle}`,
+        `// Run: npx tsx tests/simulation/${ucId.toLowerCase()}.sim.ts`,
+        `//`,
+        `// ARCHITECTURAL PREREQUISITE: this gate only works if game logic is`,
+        `// separated from the rendering layer. If your engine cannot be imported`,
+        `// and run without a renderer, the architecture is not yet correct.`,
+        `// ForgeCraft's GAME template enforces this separation — your GameEngine`,
+        `// must be a pure logic class with zero rendering dependencies.`,
+        `// The ability to run this file IS the architecture proof.`,
+        `//`,
+        `// Three invariants every game must satisfy:`,
+        `//   1. Termination  — a game always ends in bounded steps`,
+        `//   2. Reachability — win state is reachable (win rate > floor)`,
+        `//   3. Balance      — game is not trivially easy (win rate < ceiling)`,
+        ``,
+        `// TODO: import your engine and a headless player strategy`,
+        `// import { GameEngine } from '../../src/engine/GameEngine';`,
+        `// import { RandomPlayer } from '../../src/simulation/RandomPlayer';`,
+        ``,
+        `const RUNS = 1000;`,
+        `const MAX_STEPS = 10_000;   // game must terminate within this many steps`,
+        `const WIN_RATE_MIN = 0.05;  // at least 5% of games should be winnable`,
+        `const WIN_RATE_MAX = 0.95;  // shouldn't be trivially easy`,
+        ``,
+        `let wins = 0;`,
+        `let completions = 0;`,
+        ``,
+        `for (let i = 0; i < RUNS; i++) {`,
+        `  // TODO: replace with your actual engine + player`,
+        `  // const game = GameEngine.create();`,
+        `  // const player = new RandomPlayer();`,
+        `  // let steps = 0;`,
+        `  //`,
+        `  // while (!game.isOver() && steps < MAX_STEPS) {`,
+        `  //   game.applyAction(player.chooseAction(game.getState()));`,
+        `  //   steps++;`,
+        `  // }`,
+        `  // if (game.isOver()) completions++;`,
+        `  // if (game.isWon()) wins++;`,
+        `}`,
+        ``,
+        `const winRate = wins / RUNS;`,
+        `const completionRate = completions / RUNS;`,
+        ``,
+        `console.assert(completionRate >= 0.99,`,
+        `  \`FAIL: game did not terminate in \${MAX_STEPS} steps for \${((1 - completionRate) * 100).toFixed(1)}% of runs\`);`,
+        `console.assert(winRate >= WIN_RATE_MIN,`,
+        `  \`FAIL: win rate too low (\${(winRate * 100).toFixed(1)}%) — game may be unwinnable\`);`,
+        `console.assert(winRate <= WIN_RATE_MAX,`,
+        `  \`FAIL: win rate too high (\${(winRate * 100).toFixed(1)}%) — game is trivially easy\`);`,
+        ``,
+        `console.log(\`PASS: \${RUNS} runs — win rate \${(winRate * 100).toFixed(1)}%, completion \${(completionRate * 100).toFixed(1)}%\`);`,
+        ``,
+    ].join("\n"),
+};
+const gameStateIntegrityGate = {
+    tool: "game-state",
+    label: "Game state integrity (serialize / deserialize / invariants)",
+    gatePathTemplate: "tests/state/{ucId}.state.ts",
+    docsUrl: "https://en.wikipedia.org/wiki/State_(computer_science)",
+    runCommand: "npx tsx tests/state/*.state.ts",
+    buildStub: (ucId, ucTitle) => [
+        `// State integrity gate — ${ucId}: ${ucTitle}`,
+        `// Run: npx tsx tests/state/${ucId.toLowerCase()}.state.ts`,
+        `//`,
+        `// Verifies:`,
+        `//   1. Save/load round-trip produces identical state`,
+        `//   2. State invariants hold after every transition`,
+        `//   3. No illegal state is reachable from a valid initial state`,
+        ``,
+        `// TODO: import your state types and engine`,
+        `// import { GameEngine, GameState } from '../../src/engine/GameEngine';`,
+        ``,
+        `// 1. Round-trip: serialize then deserialize = same state`,
+        `// const initial = GameEngine.create().getState();`,
+        `// const serialized = JSON.stringify(initial);`,
+        `// const restored = GameEngine.fromState(JSON.parse(serialized)).getState();`,
+        `// console.assert(JSON.stringify(restored) === serialized, 'FAIL: save/load round-trip mismatch');`,
+        ``,
+        `// 2. Invariant check: define what must always be true`,
+        `// function assertInvariants(state: GameState): void {`,
+        `//   // TODO: replace with actual invariants for ${ucId}`,
+        `//   console.assert(state.score >= 0, 'score must be non-negative');`,
+        `//   console.assert(state.lives >= 0, 'lives must be non-negative');`,
+        `//   console.assert(Array.isArray(state.entities), 'entities must be an array');`,
+        `// }`,
+        ``,
+        `// 3. Apply N random transitions, assert invariants hold throughout`,
+        `// const engine = GameEngine.create();`,
+        `// for (let step = 0; step < 1000 && !engine.isOver(); step++) {`,
+        `//   engine.applyAction(engine.getValidActions()[0]);`,
+        `//   assertInvariants(engine.getState());`,
+        `// }`,
+        ``,
+        `console.log('PASS: ${ucId} state integrity verified');`,
+        ``,
+    ].join("\n"),
+};
+const gameInterfaceGate = {
+    tool: "game-interface",
+    label: "Game interface contracts (input handling, scoring, events)",
+    gatePathTemplate: "tests/interfaces/{ucId}.iface.ts",
+    docsUrl: "https://en.wikipedia.org/wiki/Software_interface",
+    runCommand: "npx tsx tests/interfaces/*.iface.ts",
+    buildStub: (ucId, ucTitle) => [
+        `// Interface contract gate — ${ucId}: ${ucTitle}`,
+        `// Run: npx tsx tests/interfaces/${ucId.toLowerCase()}.iface.ts`,
+        `//`,
+        `// Verifies the interface contracts for this use case without rendering:`,
+        `//   - Input handler accepts valid actions and rejects invalid ones`,
+        `//   - Scoring function produces correct output for known inputs`,
+        `//   - Event system fires the expected events for known transitions`,
+        ``,
+        `// TODO: import your interfaces`,
+        `// import { InputHandler } from '../../src/input/InputHandler';`,
+        `// import { ScoreEngine } from '../../src/scoring/ScoreEngine';`,
+        `// import { EventBus } from '../../src/events/EventBus';`,
+        ``,
+        `// 1. Input contract: valid action accepted, invalid action rejected`,
+        `// const handler = new InputHandler();`,
+        `// console.assert(handler.isValid({ type: 'TODO_VALID_ACTION' }), 'FAIL: valid action rejected');`,
+        `// console.assert(!handler.isValid({ type: 'INVALID' }), 'FAIL: invalid action accepted');`,
+        ``,
+        `// 2. Scoring contract: known input → known output`,
+        `// const scorer = new ScoreEngine();`,
+        `// console.assert(scorer.calculate({ TODO: 'known_input' }) === 0, 'FAIL: unexpected score');`,
+        ``,
+        `// 3. Event contract: transition fires expected event`,
+        `// const bus = new EventBus();`,
+        `// const fired: string[] = [];`,
+        `// bus.on('TODO_EVENT', () => fired.push('TODO_EVENT'));`,
+        `// // trigger the transition for ${ucId}`,
+        `// console.assert(fired.includes('TODO_EVENT'), 'FAIL: expected event not fired');`,
+        ``,
+        `console.log('PASS: ${ucId} interface contracts verified');`,
+        ``,
+    ].join("\n"),
+};
+const TAG_GATE_MAP = {
+    API: [hurlGate],
+    "WEB-REACT": [playwrightGate],
+    "WEB-STATIC": [playwrightGate],
+    DATABASE: [sqlGate],
+    REALTIME: [websocketGate],
+    GAME: [gameSimulationGate, gameStateIntegrityGate, gameInterfaceGate],
+    SOCIAL: [hurlGate],
+    ANALYTICS: [hurlGate, sqlGate],
+    AUTH: [hurlGate],
+    FINTECH: [hurlGate, sqlGate],
+    HEALTHCARE: [hurlGate, sqlGate],
+};
+/** Tags that always get the hurl gate as a fallback if no specific gate matched */
+const HURL_FALLBACK_TAGS = new Set(["CLI", "LIBRARY", "INFRA", "MOBILE"]);
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Resolve the applicable executable gates for a project's tags.
+ * Deduplicates by tool so a project tagged API+AUTH doesn't get two hurl gates.
+ *
+ * @param tags - Project classification tags from forgecraft.yaml
+ * @returns Ordered, deduplicated list of applicable gates
+ */
+export function resolveExecutableGates(tags) {
+    const seen = new Set();
+    const gates = [];
+    for (const tag of tags) {
+        for (const gate of TAG_GATE_MAP[tag] ?? []) {
+            if (!seen.has(gate.tool)) {
+                seen.add(gate.tool);
+                gates.push(gate);
+            }
+        }
+    }
+    // Fallback: if no gates resolved but tag is in fallback set, use hurl
+    if (gates.length === 0 && tags.some((t) => HURL_FALLBACK_TAGS.has(t))) {
+        gates.push(hurlGate);
+    }
+    // Universal fallback: always include hurl if nothing else matched
+    if (gates.length === 0) {
+        gates.push(hurlGate);
+    }
+    return gates;
+}
+/**
+ * Format the gate file path for a specific use case.
+ *
+ * @param gate - The gate definition
+ * @param ucId - Use-case ID (e.g. UC-001)
+ * @returns Relative file path
+ */
+export function gateFilePath(gate, ucId) {
+    return gate.gatePathTemplate.replace("{ucId}", ucId.toLowerCase());
+}
+/**
+ * Build a one-line summary of all active gates for inclusion in the roadmap
+ * phase description header.
+ *
+ * @param gates - Resolved gates
+ * @returns Comma-separated tool list string
+ */
+export function gateToolSummary(gates) {
+    return gates.map((g) => g.tool).join(", ");
+}
+//# sourceMappingURL=executable-gates.js.map

package/dist/tools/executable-gates.js.map

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

package/dist/tools/forgecraft-dispatch-extended.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forgecraft-dispatch-extended.d.ts","sourceRoot":"","sources":["../../src/tools/forgecraft-dispatch-extended.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAS7D,OAAO,EAEL,WAAW,EAEZ,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CA4GrB;AAED,YAAY,EAAE,GAAG,EAAE,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"forgecraft-dispatch-extended.d.ts","sourceRoot":"","sources":["../../src/tools/forgecraft-dispatch-extended.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAiB7D,OAAO,EAEL,WAAW,EAEZ,MAAM,kCAAkC,CAAC;AAI1C;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CAkOrB;AAED,YAAY,EAAE,GAAG,EAAE,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/tools/forgecraft-dispatch-extended.js

@@ -12,6 +12,8 @@ import { generateRoadmapHandler } from "./generate-roadmap.js";
 import { cntAddNodeHandler } from "./cnt-add-node.js";
 import { startHardeningHandler } from "./start-hardening.js";
 import { requireParam, errorResult, unknownActionResult, } from "./forgecraft-dispatch-helpers.js";
+import { generateHarnessHandler } from "./generate-harness.js";
+import { runHarnessHandler } from "./run-harness.js";
 /**
  * Dispatch governance, generation, and hardening actions.
  * Returns an error result for unrecognized actions.
@@ -77,6 +79,79 @@ export async function dispatchExtendedAction(action, args) {
             });
         case "start_hardening":
             return startHardeningHandler(args);
+        case "generate_harness":
+            return generateHarnessHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "generate_harness"),
+                uc_ids: args.harness_uc_ids,
+                force: args.force,
+            });
+        case "run_harness":
+            return runHarnessHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "run_harness"),
+                uc_ids: args.harness_uc_ids,
+                timeout_ms: args.harness_timeout_ms,
+            });
+        case "generate_env_probe": {
+            const { generateEnvProbeHandler } = await import("./generate-env-probe.js");
+            return generateEnvProbeHandler(args);
+        }
+        case "run_env_probe": {
+            const { runEnvProbeHandler } = await import("./run-env-probe.js");
+            return runEnvProbeHandler(args);
+        }
+        case "generate_slo_probe": {
+            const { generateSloProbeHandler } = await import("./generate-slo-probe.js");
+            return generateSloProbeHandler(args);
+        }
+        case "run_slo_probe": {
+            const { runSloProbeHandler } = await import("./run-slo-probe.js");
+            return runSloProbeHandler(args);
+        }
+        case "propose_session": {
+            const { proposeSessionHandler } = await import("./propose-session.js");
+            return proposeSessionHandler(args);
+        }
+        case "check_spec_consistency": {
+            const { checkSpecConsistencyHandler } = await import("./check-spec-consistency.js");
+            return checkSpecConsistencyHandler(args);
+        }
+        case "change_request": {
+            const { changeRequestHandler } = await import("./change-request.js");
+            return changeRequestHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "change_request"),
+                title: requireParam(args.change_title, "change_title", "change_request"),
+                description: requireParam(args.change_description, "change_description", "change_request"),
+                type: requireParam(args.change_type, "change_type", "change_request"),
+                breaking: args.change_breaking,
+                breaking_details: args.change_breaking_details,
+                supersedes_adr: args.change_supersedes_adr,
+                affected_artifacts: args.change_affected_artifacts,
+            });
+        }
+        case "list_changes": {
+            const { listChangesHandler } = await import("./change-request.js");
+            return listChangesHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "list_changes"),
+                status: args.changes_status_filter,
+            });
+        }
+        case "setup_monitoring": {
+            const { setupMonitoringHandler } = await import("./setup-monitoring.js");
+            return setupMonitoringHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "setup_monitoring"),
+                project_name: args.project_name,
+                force: args.monitoring_force,
+            });
+        }
+        case "check_t4": {
+            const { checkT4Handler } = await import("./check-t4.js");
+            return checkT4Handler({
+                project_dir: requireParam(args.project_dir, "project_dir", "check_t4"),
+                acknowledge: args.t4_acknowledge,
+                resolve: args.t4_resolve,
+                show_resolved: args.t4_show_resolved,
+            });
+        }
         default:
             return unknownActionResult(action);
     }

package/dist/tools/forgecraft-dispatch-extended.js.map

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

package/dist/tools/forgecraft-dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forgecraft-dispatch.d.ts","sourceRoot":"","sources":["../../src/tools/forgecraft-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAO,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAwB1D,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,wBAAwB,CAAC;AAQrE,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CA0OrB"}
+{"version":3,"file":"forgecraft-dispatch.d.ts","sourceRoot":"","sources":["../../src/tools/forgecraft-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAO,UAAU,EAAE,MAAM,oBAAoB,CAAC;AA4B1D,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,wBAAwB,CAAC;AAQrE,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CAgRrB"}

package/dist/tools/forgecraft-dispatch.js

@@ -20,10 +20,14 @@ import { verifyHandler } from "./verify.js";
 import { adviceHandler } from "./advice.js";
 import { metricsHandler } from "./metrics.js";
 import { checkCascadeHandler } from "./check-cascade.js";
+import { consolidateStatusHandler } from "./consolidate-status.js";
+import { readGateViolationsHandler } from "./gate-violations.js";
 import { generateSessionPromptHandler } from "./generate-session-prompt.js";
 import { getVerificationStrategyHandler } from "./get-verification-strategy.js";
 import { recordVerificationHandler, getVerificationStatusHandler, } from "./verification-state.js";
 import { setupProjectHandler } from "./setup-project.js";
+import { layerStatusHandler } from "./layer-status.js";
+import { adviseSessionHandler } from "./advise-session.js";
 import { requireParam, dispatchList, dispatchGetReference, } from "./forgecraft-dispatch-helpers.js";
 import { dispatchExtendedAction } from "./forgecraft-dispatch-extended.js";
 export async function dispatchForgecraft(args) {
@@ -151,6 +155,14 @@ export async function dispatchForgecraft(args) {
             return checkCascadeHandler({
                 project_dir: requireParam(args.project_dir, "project_dir", "check_cascade"),
             });
+        case "consolidate_status":
+            return consolidateStatusHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "consolidate_status"),
+            });
+        case "read_gate_violations":
+            return readGateViolationsHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "read_gate_violations"),
+            });
         case "generate_session_prompt":
             return generateSessionPromptHandler({
                 project_dir: requireParam(args.project_dir, "project_dir", "generate_session_prompt"),
@@ -184,6 +196,15 @@ export async function dispatchForgecraft(args) {
                 tags: args.tags,
                 show_pending_only: args.show_pending_only ?? false,
             });
+        case "layer_status":
+            return layerStatusHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "layer_status"),
+            });
+        case "advise_session":
+            return adviseSessionHandler({
+                project_dir: requireParam(args.project_dir, "project_dir", "advise_session"),
+                max_items: typeof args.max_items === "number" ? args.max_items : undefined,
+            });
         default:
             return dispatchExtendedAction(action, args);
     }

package/dist/tools/forgecraft-dispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"forgecraft-dispatch.js","sourceRoot":"","sources":["../../src/tools/forgecraft-dispatch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"forgecraft-dispatch.js","sourceRoot":"","sources":["../../src/tools/forgecraft-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAoB;IAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;IAErC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,eAAe;YAClB,OAAO,mBAAmB,CAAC;gBACzB,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,eAAe,CAChB;gBACD,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;gBACjD,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QAEL,KAAK,MAAM;YACT,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAE5B,KAAK,eAAe;YAClB,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEpC,KAAK,UAAU;YACb,OAAO,sBAAsB,CAAC;gBAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QAEL,KAAK,SAAS;YACZ,OAAO,qBAAqB,CAAC;gBAC3B,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC;gBACrE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;gBAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;aAChC,CAAC,CAAC;QAEL,KAAK,UAAU;YACb,OAAO,sBAAsB,CAAC;gBAC5B,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC;gBACjD,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,UAAU,CAAC;gBACtE,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,YAAY;gBAC/C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,YAAY;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;gBAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;gBAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;gBAC/B,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,CAAC;aAClD,CAAC,CAAC;QAEL,KAAK,UAAU;YACb,OAAO,2BAA2B,CAAC;gBACjC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC;gBACjD,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,YAAY;gBAC/C,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,CAAC;gBACjD,mBAAmB,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;gBAC9B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,aAAa;aACnD,CAAC,CAAC;QAEL,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,YAAY,GAChB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,IAAI,CAAC,WAAW;oBAChB,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,IAAI,SAAS,CAAC;oBAC1D,CAAC,CAAC,SAAS,CAAC;YAClB,OAAO,mBAAmB,CAAC;gBACzB,IAAI,EAAE,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC;gBACjD,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC;gBACnE,qBAAqB,EAAE,IAAI,CAAC,qBAAqB,IAAI,IAAI;aAC1D,CAAC,CAAC;QACL,CAAC;QAED,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC;gBAC1B,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;gBAC/C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,eAAe;aACrC,CAAC,CAAC;QAEL,KAAK,UAAU;YACb,OAAO,cAAc,CAAC;gBACpB,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC;gBACjD,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,UAAU,CAAC;gBACtE,GAAG,EAAE,IAAI,CAAC,GAAG;aACd,CAAC,CAAC;QAEL,KAAK,YAAY;YACf,OAAO,gBAAgB,CAAC;gBACtB,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC;gBAC1D,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,YAAY,CACb;gBACD,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC;gBAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,YAAY;aACxC,CAAC,CAAC;QAEL,KAAK,eAAe;YAClB,OAAO,mBAAmB,CAAC;gBACzB,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC;gBACtD,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,eAAe,CAChB;gBACD,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,IAAI;gBACnD,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,KAAK;gBAC5C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;gBAC7C,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QAEL,KAAK,SAAS;YACZ,OAAO,sBAAsB,CAAC;gBAC5B,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC;gBAChD,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC;gBACrE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,OAAO;aACvC,CAAC,CAAC;QAEL,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC;gBACnB,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,QAAQ,CAAC;gBACpE,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,OAAO;gBACtC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,EAAE;aAC1C,CAAC,CAAC;QAEL,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC;gBACnB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,IAAI,EAAE,IAAI,CAAC,IAA4B;aACxC,CAAC,CAAC;QAEL,KAAK,SAAS;YACZ,OAAO,cAAc,CAAC;gBACpB,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC;gBACrE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,KAAK;gBAChD,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,CAAC,CAAC;QAEL,KAAK,eAAe;YAClB,OAAO,mBAAmB,CAAC;gBACzB,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,eAAe,CAChB;aACF,CAAC,CAAC;QAEL,KAAK,oBAAoB;YACvB,OAAO,wBAAwB,CAAC;gBAC9B,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,oBAAoB,CACrB;aACF,CAAC,CAAC;QAEL,KAAK,sBAAsB;YACzB,OAAO,yBAAyB,CAAC;gBAC/B,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,sBAAsB,CACvB;aACF,CAAC,CAAC;QAEL,KAAK,yBAAyB;YAC5B,OAAO,4BAA4B,CAAC;gBAClC,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,yBAAyB,CAC1B;gBACD,gBAAgB,EAAE,YAAY,CAC5B,IAAI,CAAC,gBAAgB,EACrB,kBAAkB,EAClB,yBAAyB,CAC1B;gBACD,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;gBAC7C,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,SAAS;aAC7C,CAAC,CAAC;QAEL,KAAK,2BAA2B;YAC9B,OAAO,8BAA8B,CAAC;gBACpC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,2BAA2B,CAAC;gBAClE,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,iBAAiB,EAAE,IAAI,CAAC,iBAMX;gBACb,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QAEL,KAAK,qBAAqB;YACxB,OAAO,yBAAyB,CAAC;gBAC/B,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,qBAAqB,CACtB;gBACD,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,qBAAqB,CAAU;gBACrE,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,YAAY,EAAE,YAAY,CACxB,IAAI,CAAC,YAAY,EACjB,cAAc,EACd,qBAAqB,CACf;gBACR,QAAQ,EAAE,YAAY,CACpB,IAAI,CAAC,QAAQ,EACb,UAAU,EACV,qBAAqB,CACtB;gBACD,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,qBAAqB,CAAC;gBACrE,MAAM,EAAE,YAAY,CAClB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,qBAAqB,CACS;gBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QAEL,KAAK,qBAAqB;YACxB,OAAO,4BAA4B,CAAC;gBAClC,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,qBAAqB,CACtB;gBACD,IAAI,EAAE,IAAI,CAAC,IAAyB;gBACpC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,KAAK;aACnD,CAAC,CAAC;QAEL,KAAK,cAAc;YACjB,OAAO,kBAAkB,CAAC;gBACxB,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,cAAc,CACf;aACF,CAAC,CAAC;QAEL,KAAK,gBAAgB;YACnB,OAAO,oBAAoB,CAAC;gBAC1B,WAAW,EAAE,YAAY,CACvB,IAAI,CAAC,WAAW,EAChB,aAAa,EACb,gBAAgB,CACjB;gBACD,SAAS,EACP,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;aAClE,CAAC,CAAC;QAEL;YACE,OAAO,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/tools/forgecraft-router.d.ts

@@ -27,6 +27,14 @@ export declare function forgecraftHandler(args: ForgecraftArgs): Promise<ToolRes
  * @returns Formatted multi-line string
  */
 export declare function formatAmbiguity(ambiguity: ToolAmbiguity): string;
+/**
+ * Apply size annotation and truncation to the first text content item.
+ * Leaves short results and non-text content unchanged.
+ *
+ * @param result - Tool result after ambiguity formatting
+ * @returns Result with size annotation applied to text content
+ */
+export declare function applyResultAnnotation(result: ToolResult): ToolResult;
 /**
  * Prepend formatted ambiguity blocks to the result's text content.
  * Returns the result unchanged if there are no ambiguities.

package/dist/tools/forgecraft-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forgecraft-router.d.ts","sourceRoot":"","sources":["../../src/tools/forgecraft-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CAGrB;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAWhE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAUvE"}
+{"version":3,"file":"forgecraft-router.d.ts","sourceRoot":"","sources":["../../src/tools/forgecraft-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CAGrB;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAWhE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAWpE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAUvE"}

package/dist/tools/forgecraft-router.js

@@ -9,6 +9,7 @@
  * Dispatch logic lives in forgecraft-dispatch.ts.
  */
 import { dispatchForgecraft } from "./forgecraft-dispatch.js";
+import { annotateResult } from "../shared/result-utils.js";
 export { forgecraftSchema } from "./forgecraft-schema.js";
 // ── Public handler ───────────────────────────────────────────────────
 /**
@@ -20,7 +21,7 @@ export { forgecraftSchema } from "./forgecraft-schema.js";
  */
 export async function forgecraftHandler(args) {
     const result = await dispatchForgecraft(args);
-    return applyAmbiguityFormatting(result);
+    return applyResultAnnotation(applyAmbiguityFormatting(result));
 }
 // ── Ambiguity formatting ─────────────────────────────────────────────
 /**
@@ -41,6 +42,25 @@ export function formatAmbiguity(ambiguity) {
     lines.push(`   To resolve: ${ambiguity.resolution_hint}`);
     return lines.join("\n");
 }
+/**
+ * Apply size annotation and truncation to the first text content item.
+ * Leaves short results and non-text content unchanged.
+ *
+ * @param result - Tool result after ambiguity formatting
+ * @returns Result with size annotation applied to text content
+ */
+export function applyResultAnnotation(result) {
+    const first = result.content[0];
+    if (!first || first.type !== "text")
+        return result;
+    const annotated = annotateResult(first.text);
+    if (annotated === first.text)
+        return result;
+    return {
+        ...result,
+        content: [{ type: "text", text: annotated }, ...result.content.slice(1)],
+    };
+}
 /**
  * Prepend formatted ambiguity blocks to the result's text content.
  * Returns the result unchanged if there are no ambiguities.

package/dist/tools/forgecraft-router.js.map

@@ -1 +1 @@
-{"version":3,"file":"forgecraft-router.js","sourceRoot":"","sources":["../../src/tools/forgecraft-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,wEAAwE;AAExE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAwB;IACtD,MAAM,KAAK,GAAa;QACtB,iBAAiB,SAAS,CAAC,KAAK,EAAE;QAClC,4BAA4B,SAAS,CAAC,aAAa,EAAE;QACrD,iBAAiB,SAAS,CAAC,kBAAkB,EAAE;KAChD,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,kBAAkB,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAkB;IACzD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM;QAAE,OAAO,MAAM,CAAC;IAE/C,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,GAAG,gBAAgB,cAAc,YAAY,EAAE,CAAC;IAEnE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC1E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"forgecraft-router.js","sourceRoot":"","sources":["../../src/tools/forgecraft-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,wEAAwE;AAExE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,qBAAqB,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAwB;IACtD,MAAM,KAAK,GAAa;QACtB,iBAAiB,SAAS,CAAC,KAAK,EAAE;QAClC,4BAA4B,SAAS,CAAC,aAAa,EAAE;QACrD,iBAAiB,SAAS,CAAC,kBAAkB,EAAE;KAChD,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,kBAAkB,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAkB;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAEnD,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,SAAS,KAAK,KAAK,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAE5C,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACzE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAkB;IACzD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM;QAAE,OAAO,MAAM,CAAC;IAE/C,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,GAAG,gBAAgB,cAAc,YAAY,EAAE,CAAC;IAEnE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC1E,CAAC;AACJ,CAAC"}