labre-mcp 0.1.0

package/dist/mcp/mcp-server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.mjs","sourceRoot":"","sources":["../../src/mcp/mcp-server.mts"],"names":[],"mappings":"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"}

package/dist/mcp/mcp-tool.d.mts

@@ -0,0 +1,36 @@
+import type { McpToolDefinition } from '../types/mcp.mjs';
+/**
+ * MCP tool definition for estimateEvolution.
+ * Conforms to the Model Context Protocol tool schema specification.
+ */
+export declare const ESTIMATE_EVOLUTION_TOOL: McpToolDefinition;
+/**
+ * Validate and normalize tool input.
+ * Throws descriptive errors for invalid inputs.
+ *
+ * @param {*} input - Raw tool input
+ * @returns {Object} Validated and normalized input
+ */
+/**
+ * Handle an estimateEvolution tool call.
+ *
+ * Uses the mode router for unified mode selection:
+ *   - Explicit mode param → uses that mode
+ *   - Auto-detect: sessionState → guided, space/eval-params → oneshot, else → guided
+ *   - Both modes share the same response formatter for consistent output
+ *
+ * The legacy default pipeline is preserved as a fallback when mode routing
+ * is not applicable (e.g., direct programmatic calls without mode context).
+ *
+ * @param {Object} rawInput - Tool input matching ESTIMATE_EVOLUTION_TOOL.inputSchema
+ * @returns {Promise<Object>} MCP tool response with classification, evaluations, and message
+ */
+export declare function handleEstimateEvolution(rawInput: Record<string, unknown>): Promise<unknown>;
+/**
+ * Register the estimateEvolution tool with an MCP server instance.
+ * Compatible with the @modelcontextprotocol/sdk Server class.
+ *
+ * @param {Object} server - MCP server instance with setRequestHandler or tool()
+ */
+export declare function registerMcpTool(server: any): void;
+//# sourceMappingURL=mcp-tool.d.mts.map

package/dist/mcp/mcp-tool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.d.mts","sourceRoot":"","sources":["../../src/mcp/mcp-tool.mts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,kBAAkB,CAAC;AAWtE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,iBAYrC,CAAC;AAIF;;;;;;GAMG;AAGH;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCjG;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAgEjD"}

package/dist/mcp/mcp-tool.mjs

@@ -0,0 +1,144 @@
+// MCP tool definition for the estimateEvolution API
+//
+// Exposes a single MCP tool "estimateEvolution" that:
+//   1. Classifies the component via the classification gate (social/common/economic)
+//   2. If economic, evaluates evolution using the selected strategy (or all strategies)
+//   3. Returns structured results conforming to the MCP tool response format
+//
+// The tool is designed for integration with Claude Code and other MCP-compatible clients.
+import { z } from 'zod';
+import { EstimateEvolutionInputSchema } from '../schemas/estimate-evolution.schema.mjs';
+import { routeEstimateEvolution } from '../work-on-evolution/write/routing/mode-router.mjs';
+import { toErrorMessage } from '../lib/errors.mjs';
+// ─── MCP Tool Definition Schema ──────────────────────────────────────────────
+/**
+ * MCP tool definition for estimateEvolution.
+ * Conforms to the Model Context Protocol tool schema specification.
+ */
+export const ESTIMATE_EVOLUTION_TOOL = {
+    name: 'estimateEvolution',
+    description: 'Estimate the Wardley Map evolution position of a component. ' +
+        'Transparently handles both named solutions (e.g. "Kubernetes", "Salesforce") and abstract capabilities (e.g. "CRM", "container orchestration"). ' +
+        'Solutions are evaluated against 12 Wardley evolution properties (Market, Knowledge, Perception, etc.); ' +
+        'capabilities use pluggable strategies (s-curve, pub-distribution, etc.). ' +
+        'Routing is automatic: naming convention detection (≥90% confidence) or LLM + web search fallback. ' +
+        'Pre-filters by economic space (social good / common good / economic) via a classification gate. ' +
+        'Social good and common good components trigger re-questioning instead of evaluation. ' +
+        'Returns {evolution, confidence, method} for each strategy, plus routing metadata showing which pipeline was used.',
+    inputSchema: z.toJSONSchema(EstimateEvolutionInputSchema, { io: 'input' }),
+};
+// ─── Input Validation ────────────────────────────────────────────────────────
+/**
+ * Validate and normalize tool input.
+ * Throws descriptive errors for invalid inputs.
+ *
+ * @param {*} input - Raw tool input
+ * @returns {Object} Validated and normalized input
+ */
+// ─── MCP Tool Handler ─────────────────────────────────────────────────────────
+/**
+ * Handle an estimateEvolution tool call.
+ *
+ * Uses the mode router for unified mode selection:
+ *   - Explicit mode param → uses that mode
+ *   - Auto-detect: sessionState → guided, space/eval-params → oneshot, else → guided
+ *   - Both modes share the same response formatter for consistent output
+ *
+ * The legacy default pipeline is preserved as a fallback when mode routing
+ * is not applicable (e.g., direct programmatic calls without mode context).
+ *
+ * @param {Object} rawInput - Tool input matching ESTIMATE_EVOLUTION_TOOL.inputSchema
+ * @returns {Promise<Object>} MCP tool response with classification, evaluations, and message
+ */
+export async function handleEstimateEvolution(rawInput) {
+    // Step 0: Validate and normalize input via Zod (throws ZodError on invalid input)
+    const validated = EstimateEvolutionInputSchema.parse(rawInput);
+    const { name, context, strategy, ...componentData } = validated;
+    // ── Mode Router: unified mode selection and dispatch ───────────────
+    //
+    // The mode router handles explicit mode parameters ('oneshot', 'guided',
+    // 'conversational') and auto-detection ('auto', 'default', or omitted).
+    // It returns a consistently shaped response including formatted output.
+    const routerInput = {
+        name,
+        description: context,
+        context,
+        strategy,
+        ...componentData,
+        // Pass through mode-related params from raw input
+        mode: rawInput?.mode,
+        space: rawInput?.space,
+        sessionState: rawInput?.sessionState,
+        forceEstimate: rawInput?.forceEstimate,
+        compact: rawInput?.compact,
+        pipeline: rawInput?.pipeline,
+    };
+    const routed = await routeEstimateEvolution(routerInput);
+    // Return the routed response — it already contains all fields:
+    // mode, modeReason, classification, reQuestions, evaluations, message,
+    // formatted, sessionState, nextQuestion, phase
+    return routed;
+}
+// ─── MCP Server Registration Helper ──────────────────────────────────────────
+/**
+ * Register the estimateEvolution tool with an MCP server instance.
+ * Compatible with the @modelcontextprotocol/sdk Server class.
+ *
+ * @param {Object} server - MCP server instance with setRequestHandler or tool()
+ */
+export function registerMcpTool(server) {
+    /**
+     * Format a successful result or an error into MCP content response.
+     * @param {Function} handler - async function returning the result
+     * @returns {Promise<Object>} MCP-formatted content response
+     */
+    async function mcpContentResponse(handler) {
+        try {
+            const result = await handler();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: toErrorMessage(err) }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Pattern 1: MCP SDK server.tool() convenience method
+    if (typeof server.tool === 'function') {
+        server.tool(ESTIMATE_EVOLUTION_TOOL.name, ESTIMATE_EVOLUTION_TOOL.description, ESTIMATE_EVOLUTION_TOOL.inputSchema.properties, async (input) => mcpContentResponse(() => handleEstimateEvolution(input)));
+        return;
+    }
+    // Pattern 2: MCP SDK setRequestHandler for tools/list and tools/call
+    if (typeof server.setRequestHandler === 'function') {
+        // Register tool listing
+        server.setRequestHandler('tools/list', async () => ({
+            tools: [ESTIMATE_EVOLUTION_TOOL],
+        }));
+        // Register tool execution
+        server.setRequestHandler('tools/call', async (request) => {
+            if (request.params.name !== ESTIMATE_EVOLUTION_TOOL.name) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: `Unknown tool: ${request.params.name}` }) }],
+                    isError: true,
+                };
+            }
+            return mcpContentResponse(() => handleEstimateEvolution(request.params.arguments));
+        });
+        return;
+    }
+    throw new Error('Unsupported MCP server interface. Expected server.tool() or server.setRequestHandler().');
+}
+//# sourceMappingURL=mcp-tool.mjs.map

package/dist/mcp/mcp-tool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.mjs","sourceRoot":"","sources":["../../src/mcp/mcp-tool.mts"],"names":[],"mappings":"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"}

package/dist/mcp/resolve-context.d.mts

@@ -0,0 +1,3 @@
+import { type RequestContext } from '#core/context/request-context.mjs';
+export declare function resolveContext(rawContext: unknown): Promise<RequestContext>;
+//# sourceMappingURL=resolve-context.d.mts.map

package/dist/mcp/resolve-context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-context.d.mts","sourceRoot":"","sources":["../../src/mcp/resolve-context.mts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,mCAAmC,CAAC;AAE9F,wBAAsB,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAgBjF"}

package/dist/mcp/resolve-context.mjs

@@ -0,0 +1,28 @@
+// Shared RequestContext resolution for MCP tool handlers (ARCH-15).
+//
+// A handler receives the dispatch-provided context (or `_context` envelope).
+// When it parses as a valid RequestContext it is used as-is; otherwise a
+// dev-mode fallback derives a projectId from the current working directory.
+// Production callers should always supply a context.
+import { randomUUID } from 'node:crypto';
+import { resolveProjectId } from '#core/persistence/project-id-resolver.mjs';
+import { RequestContextSchema } from '#core/context/request-context.mjs';
+export async function resolveContext(rawContext) {
+    if (rawContext && typeof rawContext === 'object') {
+        const parsed = RequestContextSchema.safeParse(rawContext);
+        if (parsed.success)
+            return parsed.data;
+    }
+    // Dev-mode fallback: derive projectId from current working dir as a hash.
+    // ARCH-15: process.cwd() is acceptable here only because the daemon
+    // captures it at boot — production callers should always supply a context.
+    const projectRoot = process.cwd();
+    const projectId = await resolveProjectId(projectRoot);
+    return {
+        projectId,
+        projectRoot,
+        sessionId: randomUUID(),
+        domain: 'wardley',
+    };
+}
+//# sourceMappingURL=resolve-context.mjs.map

package/dist/mcp/resolve-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-context.mjs","sourceRoot":"","sources":["../../src/mcp/resolve-context.mts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,qDAAqD;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAuB,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAmB;IACtD,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACzC,CAAC;IACD,0EAA0E;IAC1E,oEAAoE;IACpE,2EAA2E;IAC3E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACtD,OAAO;QACL,SAAS;QACT,WAAW;QACX,SAAS,EAAE,UAAU,EAAE;QACvB,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC"}

package/dist/mcp/run-command.tool.d.mts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '#core/transport/mcp-handler.mjs';
+export declare const RUN_COMMAND_TOOL: ToolDefinition;
+//# sourceMappingURL=run-command.tool.d.mts.map

package/dist/mcp/run-command.tool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.tool.d.mts","sourceRoot":"","sources":["../../src/mcp/run-command.tool.mts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAQtE,eAAO,MAAM,gBAAgB,EAAE,cAuD9B,CAAC"}

package/dist/mcp/run-command.tool.mjs

@@ -0,0 +1,70 @@
+// MCP tool definition for `runCommand` — direct invocation of any strategy by
+// its 5-segment methodId (ast-schema.md § 3.4.1 CommandCall / CommandResult).
+//
+// A single command is run through the kernel as a degenerate 1-step recipe
+// (see `runCommand` in core/recipe), so the result carries the same JSON-labre
+// envelope (signals / reasoning / insights / trace) and persists an artefact
+// under ~/.labre-mcp/runs/ — just like a recipe run. This makes single-step
+// recipes unnecessary: call the command directly instead.
+import { z } from 'zod';
+import { CommandCallSchema } from '#schemas/command.schema.mjs';
+import { runCommand } from '#core/recipe/recipe-runner.mjs';
+import { buildStrategyRegistry } from '#core/transport/strategy-registry-boot.mjs';
+import { attachArtifactWriter } from '#core/listeners/artifact-writer-listener.mjs';
+import { createEventBus } from '#core/bus/event-bus.mjs';
+import { resolveContext } from './resolve-context.mjs';
+export const RUN_COMMAND_TOOL = {
+    name: 'runCommand',
+    description: 'Invoke a single strategy directly by its 5-segment methodId and get a CommandResult ' +
+        '(canonical output + JSON-labre envelope: signals, reasoning, insights, trace). ' +
+        'Input: { command: "<domain:tool:sous-domaine:command:strategie>", input: <command-specific> }. ' +
+        'Use this instead of a single-step recipe. The full methodId catalogue (real vs mock) is in ' +
+        'docs/architecture/ast-schema.md. An unknown methodId returns status "error".',
+    // any: zod-to-json conversion — the schema is well-typed at the Zod layer
+    inputSchema: z.toJSONSchema(CommandCallSchema, { io: 'input' }),
+    // Returns a bare CommandResult; the daemon dispatch wraps every handler in
+    // withMcpDegradation (Degradable<T>) — do NOT self-wrap here (hard rule #18).
+    async handler(args, context) {
+        const call = CommandCallSchema.parse(args);
+        const ctx = await resolveContext(context);
+        const registry = buildStrategyRegistry();
+        const bus = createEventBus();
+        // Caller-owned AST so the artefact-writer listener sees the live object
+        // (mutated in place by the runner, read at run-end).
+        const ast = {};
+        const artifactHandle = attachArtifactWriter({ bus, context: ctx, getAst: () => ast });
+        try {
+            const outcome = await runCommand({
+                command: call.command,
+                input: call.input,
+                context: ctx,
+                registry,
+                bus,
+                ast,
+            });
+            const artifactPath = await artifactHandle.artifactPath;
+            return {
+                command: call.command,
+                status: 'ok',
+                output: outcome.ast.result ?? null,
+                envelope: outcome.envelope,
+                metadata: {
+                    recipeRunId: outcome.recipeRunId,
+                    artifactPath,
+                    strategyUsed: call.command,
+                },
+            };
+        }
+        catch (err) {
+            await artifactHandle.detach();
+            return {
+                command: call.command,
+                status: 'error',
+                output: null,
+                errors: [err?.message ?? String(err)],
+                metadata: { strategyUsed: call.command },
+            };
+        }
+    },
+};
+//# sourceMappingURL=run-command.tool.mjs.map

package/dist/mcp/run-command.tool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.tool.mjs","sourceRoot":"","sources":["../../src/mcp/run-command.tool.mts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,0DAA0D;AAE1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAsB,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,sFAAsF;QACtF,iFAAiF;QACjF,iGAAiG;QACjG,6FAA6F;QAC7F,8EAA8E;IAChF,0EAA0E;IAC1E,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAA4B;IAC1F,2EAA2E;IAC3E,8EAA8E;IAC9E,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO;QACzB,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;QAE7B,wEAAwE;QACxE,qDAAqD;QACrD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,MAAM,cAAc,GAAG,oBAAoB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAEtF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC;gBAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,GAAG;gBACZ,QAAQ;gBACR,GAAG;gBACH,GAAG;aACJ,CAAC,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC;YACvD,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI;gBAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE;oBACR,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,YAAY;oBACZ,YAAY,EAAE,IAAI,CAAC,OAAO;iBAC3B;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAc,CAAC,MAAM,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,CAAE,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChD,QAAQ,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE;aACzC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/mcp/run-recipe.tool.d.mts

@@ -0,0 +1,13 @@
+import type { ToolDefinition } from '#core/transport/mcp-handler.mjs';
+import { type JsonLabreEnvelope } from '#core/recipe/recipe-runner.mjs';
+export interface RunRecipeResult {
+    recipe: string;
+    status: 'ok' | 'error';
+    recipeRunId?: string;
+    ast?: Record<string, unknown>;
+    envelope?: JsonLabreEnvelope;
+    artifactPath?: string | null;
+    errors?: string[];
+}
+export declare const RUN_RECIPE_TOOL: ToolDefinition;
+//# sourceMappingURL=run-recipe.tool.d.mts.map

package/dist/mcp/run-recipe.tool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-recipe.tool.d.mts","sourceRoot":"","sources":["../../src/mcp/run-recipe.tool.mts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAOnF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,eAAe,EAAE,cAgE7B,CAAC"}

package/dist/mcp/run-recipe.tool.mjs

@@ -0,0 +1,79 @@
+// MCP tool definition for `runRecipe` — invoke a multi-step recipe by name.
+//
+// Generalises `estimate-evolution-via-recipe` (which runs one fixed recipe)
+// to any shipped/override recipe addressed by a 3-segment ref
+// `<domain>:<tool>:<name>`. The result carries the same JSON-labre envelope
+// (signals / reasoning / insights / trace) as a runCommand call and persists
+// an artefact under ~/.labre-mcp/runs/. Use `runCommand` for a single methodId.
+import { z } from 'zod';
+import { RunRecipeCallSchema } from '#schemas/run-recipe.schema.mjs';
+import { loadRecipe } from '#core/recipe/recipe-loader.mjs';
+import { runRecipe } from '#core/recipe/recipe-runner.mjs';
+import { buildStrategyRegistry } from '#core/transport/strategy-registry-boot.mjs';
+import { attachArtifactWriter } from '#core/listeners/artifact-writer-listener.mjs';
+import { createEventBus } from '#core/bus/event-bus.mjs';
+import { resolveContext } from './resolve-context.mjs';
+import { SHIPPED_ROOT } from './shipped-root.mjs';
+export const RUN_RECIPE_TOOL = {
+    name: 'runRecipe',
+    description: 'Run a multi-step recipe by name and get its JSON-labre envelope (signals, reasoning, ' +
+        'insights, trace) plus the final AST and the artefact path. ' +
+        'Input: { recipe: "<domain>:<tool>:<name>", input: <recipe-specific> } ' +
+        '(e.g. "wardley:map:draw-value-chain"). Shipped recipes live under recipes/<domain>/<tool>/; ' +
+        'a same-named recipe under the project root overrides the shipped one. ' +
+        'Use runCommand for a single methodId. An unknown recipe returns status "error".',
+    // any: zod-to-json conversion — the schema is well-typed at the Zod layer
+    inputSchema: z.toJSONSchema(RunRecipeCallSchema, { io: 'input' }),
+    // Returns a bare RunRecipeResult; the daemon dispatch wraps every handler in
+    // withMcpDegradation (Degradable<T>) — do NOT self-wrap here (hard rule #18).
+    async handler(args, context) {
+        const call = RunRecipeCallSchema.parse(args);
+        // The regex guarantees exactly 3 colon-separated segments.
+        const [framework, tool, name] = call.recipe.split(':');
+        const ctx = await resolveContext(context);
+        let recipe;
+        try {
+            recipe = await loadRecipe({
+                framework,
+                tool,
+                name,
+                shippedRoot: SHIPPED_ROOT,
+                projectRoot: ctx.projectRoot,
+            });
+        }
+        catch (err) {
+            return {
+                recipe: call.recipe,
+                status: 'error',
+                errors: [err?.message ?? String(err)],
+            };
+        }
+        const registry = buildStrategyRegistry();
+        const bus = createEventBus();
+        // Caller-owned AST so the artefact-writer listener sees the live object
+        // (mutated in place by the runner, read at run-end). $.input seeds the recipe.
+        const ast = { input: call.input };
+        const artifactHandle = attachArtifactWriter({ bus, context: ctx, getAst: () => ast });
+        try {
+            const outcome = await runRecipe({ recipe, ast, context: ctx, registry, bus });
+            const artifactPath = await artifactHandle.artifactPath;
+            return {
+                recipe: call.recipe,
+                status: 'ok',
+                recipeRunId: outcome.recipeRunId,
+                ast: outcome.ast,
+                envelope: outcome.envelope,
+                artifactPath,
+            };
+        }
+        catch (err) {
+            await artifactHandle.detach();
+            return {
+                recipe: call.recipe,
+                status: 'error',
+                errors: [err?.message ?? String(err)],
+            };
+        }
+    },
+};
+//# sourceMappingURL=run-recipe.tool.mjs.map

package/dist/mcp/run-recipe.tool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-recipe.tool.mjs","sourceRoot":"","sources":["../../src/mcp/run-recipe.tool.mts"],"names":[],"mappings":"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"}

package/dist/mcp/shipped-root.d.mts

@@ -0,0 +1,2 @@
+export declare const SHIPPED_ROOT: string;
+//# sourceMappingURL=shipped-root.d.mts.map

package/dist/mcp/shipped-root.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipped-root.d.mts","sourceRoot":"","sources":["../../src/mcp/shipped-root.mts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,YAAY,QACmD,CAAC"}

package/dist/mcp/shipped-root.mjs

@@ -0,0 +1,16 @@
+// labre-mcp's own install root — where shipped recipes live (ARCH-08).
+//
+// Resolution order:
+//   1. `LABRE_SHIPPED_ROOT` env var (required when running from a bundled
+//      single-file build where the source layout is flattened).
+//   2. Auto-detection from `import.meta.url`: src/mcp/<file>.mts → up 2
+//      levels = repo root. Works for `tsx src/...` (dev) and
+//      `node dist/.../...` (prod) where the layout matches.
+//
+// Reading `process.env` here is the allowed top-level config exception to
+// hard rule #20 (forbidden only at request time, not module load).
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+const __filename = fileURLToPath(import.meta.url);
+export const SHIPPED_ROOT = process.env.LABRE_SHIPPED_ROOT ?? resolve(dirname(__filename), '..', '..');
+//# sourceMappingURL=shipped-root.mjs.map

package/dist/mcp/shipped-root.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipped-root.mjs","sourceRoot":"","sources":["../../src/mcp/shipped-root.mts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,oBAAoB;AACpB,0EAA0E;AAC1E,gEAAgE;AAChE,wEAAwE;AACxE,6DAA6D;AAC7D,4DAA4D;AAC5D,EAAE;AACF,0EAA0E;AAC1E,mEAAmE;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GACvB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC"}

package/dist/schemas/command.schema.d.mts

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+export declare const CommandCallSchema: z.ZodObject<{
+    command: z.ZodString;
+    input: z.ZodUnknown;
+    metadata: z.ZodOptional<z.ZodObject<{
+        requestId: z.ZodOptional<z.ZodString>;
+        requestedAt: z.ZodOptional<z.ZodString>;
+        callerAgent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type CommandCall = z.infer<typeof CommandCallSchema>;
+export declare const JsonLabreEnvelopeSchema: z.ZodObject<{
+    context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    signals: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodUnknown;
+        source: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strip>>;
+    reasoning: z.ZodArray<z.ZodObject<{
+        by: z.ZodString;
+        text: z.ZodString;
+        promptTokens: z.ZodOptional<z.ZodNumber>;
+        completionTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    insights: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        by: z.ZodString;
+        type: z.ZodString;
+        confidence: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    trace: z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        stepId: z.ZodString;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        startedAt: z.ZodString;
+        completedAt: z.ZodString;
+    }, z.core.$strip>>;
+    references: z.ZodArray<z.ZodObject<{
+        artifactPath: z.ZodString;
+        jsonPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CommandResultSchema: z.ZodObject<{
+    command: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        ok: "ok";
+        partial: "partial";
+    }>;
+    output: z.ZodUnknown;
+    envelope: z.ZodOptional<z.ZodObject<{
+        context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        signals: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodUnknown;
+            source: z.ZodString;
+            capturedAt: z.ZodString;
+        }, z.core.$strip>>;
+        reasoning: z.ZodArray<z.ZodObject<{
+            by: z.ZodString;
+            text: z.ZodString;
+            promptTokens: z.ZodOptional<z.ZodNumber>;
+            completionTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        insights: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            by: z.ZodString;
+            type: z.ZodString;
+            confidence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        trace: z.ZodArray<z.ZodObject<{
+            command: z.ZodString;
+            stepId: z.ZodString;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            startedAt: z.ZodString;
+            completedAt: z.ZodString;
+        }, z.core.$strip>>;
+        references: z.ZodArray<z.ZodObject<{
+            artifactPath: z.ZodString;
+            jsonPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        strategyUsed: z.ZodOptional<z.ZodString>;
+        versionUsed: z.ZodOptional<z.ZodString>;
+        recipeRunId: z.ZodOptional<z.ZodString>;
+        artifactPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CommandResult = z.infer<typeof CommandResultSchema>;
+//# sourceMappingURL=command.schema.d.mts.map

package/dist/schemas/command.schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.schema.d.mts","sourceRoot":"","sources":["../../src/schemas/command.schema.mts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,iBAAiB;;;;;;;;kBAiBnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAoC5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOlC,CAAC;AAIH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}