labre-mcp 0.1.0

package/dist/core/persistence/project-id-resolver.mjs

@@ -0,0 +1,52 @@
+// Resolve a stable projectId from a projectRoot path.
+//
+// Resolution order:
+//   1. Read <projectRoot>/.labre/project.json — if present, return its `projectId` field
+//   2. Otherwise, derive a deterministic ID from the absolute projectRoot (SHA-1, 16 hex chars)
+//
+// The .labre/project.json approach lets users assign a stable cross-machine
+// project identity (e.g. when the same repo is cloned to different paths or
+// machines). The hash fallback ensures we always have an ID even without
+// explicit project setup.
+import { createHash } from "node:crypto";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { z } from "zod";
+export const ProjectMarkerSchema = z.object({
+    projectId: z.string().min(1),
+});
+const cache = new Map();
+export async function resolveProjectId(projectRoot) {
+    const absolute = resolve(projectRoot);
+    const hit = cache.get(absolute);
+    if (hit)
+        return hit;
+    const markerPath = join(absolute, ".labre", "project.json");
+    try {
+        const raw = await readFile(markerPath, "utf8");
+        const parsed = ProjectMarkerSchema.safeParse(JSON.parse(raw));
+        if (parsed.success) {
+            cache.set(absolute, parsed.data.projectId);
+            return parsed.data.projectId;
+        }
+    }
+    catch {
+        // Fall through to hash fallback
+    }
+    const derived = createHash("sha1").update(absolute).digest("hex").slice(0, 16);
+    cache.set(absolute, derived);
+    return derived;
+}
+/** Write a new .labre/project.json with a freshly generated UUID. */
+export async function initProjectMarker(projectRoot, projectId) {
+    const dir = join(resolve(projectRoot), ".labre");
+    await mkdir(dir, { recursive: true });
+    const body = { projectId };
+    await writeFile(join(dir, "project.json"), JSON.stringify(body, null, 2), "utf8");
+    cache.set(resolve(projectRoot), projectId);
+}
+/** Test-only: clear the projectId cache. */
+export function resetProjectIdCache() {
+    cache.clear();
+}
+//# sourceMappingURL=project-id-resolver.mjs.map

package/dist/core/persistence/project-id-resolver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id-resolver.mjs","sourceRoot":"","sources":["../../../src/core/persistence/project-id-resolver.mts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,oBAAoB;AACpB,yFAAyF;AACzF,gGAAgG;AAChG,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,0BAA0B;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAGH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAEpB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/E,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB,EAAE,SAAiB;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAkB,EAAE,SAAS,EAAE,CAAC;IAC1C,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAClF,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,mBAAmB;IACjC,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/core/recipe/jsonpath-fanout.d.mts

@@ -0,0 +1,3 @@
+export declare function readPath(ast: unknown, path: string): unknown;
+export declare function writePath(ast: unknown, path: string, value: unknown): void;
+//# sourceMappingURL=jsonpath-fanout.d.mts.map

package/dist/core/recipe/jsonpath-fanout.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath-fanout.d.mts","sourceRoot":"","sources":["../../../src/core/recipe/jsonpath-fanout.mts"],"names":[],"mappings":"AAMA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI5D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAyB1E"}

package/dist/core/recipe/jsonpath-fanout.mjs

@@ -0,0 +1,44 @@
+// Thin wrapper around jsonpath-plus to read and write into an AST using
+// JSONPath expressions. Used by the recipe runner for `in`, `out`, `over`.
+// Default paths in the runner use $ (root) and $.lastResult (scratch slot).
+import { JSONPath } from "jsonpath-plus";
+export function readPath(ast, path) {
+    // any: JSONPath returns mixed array/scalar shapes — we normalise to first match
+    const matches = JSONPath({ path, json: ast, wrap: false });
+    return matches;
+}
+export function writePath(ast, path, value) {
+    if (path === "$" || path === "$.") {
+        throw new Error("Cannot write to root path '$'");
+    }
+    if (ast === null || typeof ast !== "object") {
+        throw new Error(`writePath: root must be a non-null object, got ${ast === null ? "null" : typeof ast}`);
+    }
+    const segments = parsePath(path);
+    let cursor = ast;
+    for (let i = 0; i < segments.length - 1; i += 1) {
+        const seg = segments[i];
+        if (cursor[seg] === undefined || cursor[seg] === null) {
+            cursor[seg] = {};
+        }
+        const next = cursor[seg];
+        if (next === null || typeof next !== "object" || Array.isArray(next)) {
+            throw new Error(`writePath: cannot descend through "${seg}" — value is ${Array.isArray(next) ? "array" : typeof next} (path "${path}")`);
+        }
+        cursor = next;
+    }
+    cursor[segments[segments.length - 1]] = value;
+}
+// Parse a simple dot-path like $.a.b.c into ["a", "b", "c"]. Bracket and
+// filter syntax are not supported for writes (read still uses full JSONPath).
+function parsePath(path) {
+    if (!path.startsWith("$")) {
+        throw new Error(`Path must start with '$': "${path}"`);
+    }
+    const trimmed = path.slice(1);
+    const cleaned = trimmed.startsWith(".") ? trimmed.slice(1) : trimmed;
+    if (cleaned.length === 0)
+        return [];
+    return cleaned.split(".").map((s) => s.trim()).filter((s) => s.length > 0);
+}
+//# sourceMappingURL=jsonpath-fanout.mjs.map

package/dist/core/recipe/jsonpath-fanout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath-fanout.mjs","sourceRoot":"","sources":["../../../src/core/recipe/jsonpath-fanout.mts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,2EAA2E;AAC3E,4EAA4E;AAE5E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,QAAQ,CAAC,GAAY,EAAE,IAAY;IACjD,gFAAgF;IAChF,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAa,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAY,EAAE,IAAY,EAAE,KAAc;IAClE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,kDAAkD,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,MAAM,GAA4B,GAA8B,CAAC;IACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CACb,sCAAsC,GAAG,gBACvC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,IACzC,WAAW,IAAI,IAAI,CACpB,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,IAA+B,CAAC;IAC3C,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAChD,CAAC;AAED,yEAAyE;AACzE,8EAA8E;AAC9E,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/core/recipe/recipe-loader.d.mts

@@ -0,0 +1,12 @@
+import { type Recipe } from "./recipe.schema.mjs";
+export interface RecipeLookupOptions {
+    framework: string;
+    tool: string;
+    name: string;
+    projectRoot?: string;
+    shippedRoot: string;
+}
+export declare function loadRecipe(options: RecipeLookupOptions): Promise<Recipe>;
+/** Test-only: clear the memoized cache so the next call re-reads. */
+export declare function resetRecipeCache(): void;
+//# sourceMappingURL=recipe-loader.d.mts.map

package/dist/core/recipe/recipe-loader.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-loader.d.mts","sourceRoot":"","sources":["../../../src/core/recipe/recipe-loader.mts"],"names":[],"mappings":"AAYA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AA4BD,wBAAsB,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B9E;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/core/recipe/recipe-loader.mjs

@@ -0,0 +1,69 @@
+// Recipe loader implementing the shipped + user-override pattern (ARCH-08).
+//
+// Lookup order for recipe name "evaluate-map" in framework "wardley", tool "evolution":
+//   1. <projectRoot>/recipes/wardley/evolution/evaluate-map.recipe.json (user)
+//   2. <shippedRoot>/recipes/wardley/evolution/evaluate-map.recipe.json (built-in)
+//
+// User recipe takes precedence by name (no field-level merge — recipes are
+// integral declarations). Loader caches per (framework, tool, name).
+import { readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { validateOrThrow } from "#lib/zod/validate-or-throw.mjs";
+import { RecipeSchema } from "./recipe.schema.mjs";
+const cache = new Map();
+function cacheKey(o) {
+    return `${o.projectRoot ?? "_"}::${o.shippedRoot}::${o.framework}:${o.tool}:${o.name}`;
+}
+function recipePath(root, framework, tool, name) {
+    return join(resolve(root), "recipes", framework, tool, `${name}.recipe.json`);
+}
+async function tryReadRecipe(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Invalid JSON in recipe ${path}: ${err.message}`);
+    }
+    return validateOrThrow(RecipeSchema, parsed, `Recipe ${path}`);
+}
+export async function loadRecipe(options) {
+    // Tests routinely write override recipes into temp dirs and re-load them;
+    // a memoized cache between tests would mask drift. Auto-clear under NODE_ENV=test.
+    if (process.env.NODE_ENV === "test") {
+        cache.clear();
+    }
+    const key = cacheKey(options);
+    const hit = cache.get(key);
+    if (hit)
+        return hit;
+    // 1. User override at projectRoot if provided
+    if (options.projectRoot) {
+        const userPath = recipePath(options.projectRoot, options.framework, options.tool, options.name);
+        const userRecipe = await tryReadRecipe(userPath);
+        if (userRecipe) {
+            cache.set(key, userRecipe);
+            return userRecipe;
+        }
+    }
+    // 2. Shipped recipe
+    const shippedPath = recipePath(options.shippedRoot, options.framework, options.tool, options.name);
+    const shipped = await tryReadRecipe(shippedPath);
+    if (!shipped) {
+        throw new Error(`Recipe not found: ${options.framework}:${options.tool}:${options.name} (looked in ${shippedPath}${options.projectRoot ? ` and ${recipePath(options.projectRoot, options.framework, options.tool, options.name)}` : ""})`);
+    }
+    cache.set(key, shipped);
+    return shipped;
+}
+/** Test-only: clear the memoized cache so the next call re-reads. */
+export function resetRecipeCache() {
+    cache.clear();
+}
+//# sourceMappingURL=recipe-loader.mjs.map

package/dist/core/recipe/recipe-loader.mjs.map

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

package/dist/core/recipe/recipe-runner.d.mts

@@ -0,0 +1,48 @@
+import type { Recipe } from "./recipe.schema.mjs";
+import type { StrategyRegistry } from "../registry/strategy-registry.mjs";
+import type { StrategyResult } from "../ast/base-strategy.mjs";
+import type { RequestContext } from "../context/request-context.mjs";
+import { type EventBus } from "../bus/event-bus.mjs";
+import type { PipelineEvent } from "../bus/event.schema.mjs";
+export interface RunOptions {
+    recipe: Recipe;
+    ast: Record<string, unknown>;
+    context: RequestContext;
+    registry: StrategyRegistry;
+    bus?: EventBus;
+}
+export interface JsonLabreEnvelope {
+    context: Record<string, unknown>;
+    signals: StrategyResult["signals"];
+    reasoning: StrategyResult["reasoning"];
+    insights: StrategyResult["insights"];
+    trace: Array<{
+        command: string;
+        stepId: string;
+        durationMs?: number;
+        startedAt: string;
+        completedAt: string;
+    }>;
+    references: Array<{
+        artifactPath: string;
+        jsonPath?: string;
+    }>;
+}
+export interface RunOutcome {
+    recipeRunId: string;
+    ast: Record<string, unknown>;
+    events: PipelineEvent[];
+    bus: EventBus;
+    envelope: JsonLabreEnvelope;
+}
+export declare function runRecipe(options: RunOptions): Promise<RunOutcome>;
+export interface RunCommandOptions {
+    command: string;
+    input: unknown;
+    context: RequestContext;
+    registry: StrategyRegistry;
+    bus?: EventBus;
+    ast?: Record<string, unknown>;
+}
+export declare function runCommand(options: RunCommandOptions): Promise<RunOutcome>;
+//# sourceMappingURL=recipe-runner.d.mts.map

package/dist/core/recipe/recipe-runner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-runner.d.mts","sourceRoot":"","sources":["../../../src/core/recipe/recipe-runner.mts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAE3B,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAOD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,KAAK,EAAE,KAAK,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,UAAU,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,GAAG,EAAE,QAAQ,CAAC;IACd,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAmExE;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAEhB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,CAAC,EAAE,QAAQ,CAAC;IAIf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAcD,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBhF"}

package/dist/core/recipe/recipe-runner.mjs

@@ -0,0 +1,247 @@
+// Recipe runner: executes a Recipe against an initial AST, producing a final
+// AST and an event trace. Steps run sequentially; an individual step with
+// `over` fans out across the matching array elements with Promise.allSettled
+// (per memory feedback_parallelize_independent.md).
+//
+// Each step emits step-start and step-end events on the bus. Listeners (per
+// recipe.listeners) attach at run start and detach at run end. The runner
+// returns the modified AST and a reference to the (drained) event bus.
+import { randomUUID } from "node:crypto";
+import { readPath, writePath } from "./jsonpath-fanout.mjs";
+import { createEventBus } from "../bus/event-bus.mjs";
+export async function runRecipe(options) {
+    const recipeRunId = randomUUID();
+    const bus = options.bus ?? createEventBus();
+    // Capture every event into a flat trace so the caller (and the artefact
+    // writer listener) can serialise them in run order.
+    const events = [];
+    const subscription = bus.observe().subscribe((e) => {
+        events.push(e);
+    });
+    // Runner-level envelope accumulator (ast-schema.md v0.1.0 § 2.0).
+    const envelope = {
+        context: {},
+        signals: [],
+        reasoning: [],
+        insights: [],
+        trace: [],
+        references: [],
+    };
+    try {
+        for (const step of options.recipe.steps) {
+            await executeStep({
+                step,
+                ast: options.ast,
+                context: options.context,
+                registry: options.registry,
+                bus,
+                recipeRunId,
+                sessionId: options.context.sessionId,
+                envelope,
+            });
+        }
+        // Listeners (ARCH-10, opt-in): run AFTER the whole main path completes,
+        // all in parallel. Each listener observes its parent step by reading that
+        // step's business result from the AST. They only contribute to the
+        // envelope; a listener failure is isolated and never affects the main path
+        // or the returned AST. Placed before the run-end event so the envelope is
+        // complete when the artefact writer serialises the run.
+        await runListeners({
+            recipe: options.recipe,
+            ast: options.ast,
+            context: options.context,
+            registry: options.registry,
+            envelope,
+        });
+        bus.emit({
+            schemaVersion: "1.0",
+            recipeRunId,
+            sessionId: options.context.sessionId,
+            stepId: "__run__",
+            // The run-end event needs a methodId that respects the 5-segment
+            // grammar (ast-schema.md v0.1.0). The recipe name itself is already
+            // carried by recipeRunId; this synthetic id only identifies the event
+            // origin as "the recipe runner of this domain".
+            methodId: `${options.recipe.domain}:recipe:orchestration:run:default`,
+            phase: "run-end",
+            timestamp: new Date().toISOString(),
+        });
+    }
+    finally {
+        subscription.unsubscribe();
+    }
+    return { recipeRunId, ast: options.ast, events, bus, envelope };
+}
+// Run a single command (methodId) directly and get a JSON-labre envelope back.
+//
+// A command is modelled as a degenerate 1-step recipe so the exact same
+// machinery applies — envelope assembly, step/run events, and (via the
+// caller-attached listener) artefact persistence. This is what makes a
+// stand-alone command call equivalent to a recipe step: its result carries an
+// envelope just like a recipe run does.
+//
+// The strategy receives `input` (seeded at `$.input`); its StrategyResult is
+// written to `$.result` on the returned `outcome.ast`. `domain`/`tool` for the
+// synthetic recipe derive from the command's first two segments so the
+// run-end event keeps a valid 5-segment methodId.
+export async function runCommand(options) {
+    const [domain = 'common', tool = 'command'] = options.command.split('@')[0].split(':');
+    const recipe = {
+        schemaVersion: '1.0',
+        name: options.command,
+        domain,
+        tool,
+        steps: [{ stepId: 'command', tool: options.command, in: '$.input', out: '$.result' }],
+        listeners: {},
+    };
+    const ast = options.ast ?? {};
+    ast.input = options.input;
+    return runRecipe({
+        recipe,
+        ast,
+        context: options.context,
+        registry: options.registry,
+        bus: options.bus,
+    });
+}
+async function executeStep(ctx) {
+    const { step, ast, context, registry, bus, recipeRunId, sessionId, envelope } = ctx;
+    const strategyClass = registry.get(step.tool);
+    // any: strategy constructor signature is open by design; framework code is responsible for arg shape
+    const strategy = new strategyClass();
+    const inputPath = step.in ?? "$";
+    const outputPath = step.out ?? "$.lastResult";
+    const startedAt = Date.now();
+    bus.emit({
+        schemaVersion: "1.0",
+        recipeRunId,
+        sessionId,
+        stepId: step.stepId,
+        methodId: step.tool,
+        phase: "step-start",
+        timestamp: new Date(startedAt).toISOString(),
+    });
+    let result;
+    if (step.over) {
+        // Auto-fanout: run the strategy once per element in the array at `over`.
+        const items = readPath(ast, step.over);
+        if (!Array.isArray(items)) {
+            throw new Error(`Step "${step.stepId}" has 'over: ${step.over}' but the path did not resolve to an array (got ${typeof items})`);
+        }
+        const settled = await Promise.allSettled(items.map((item) => strategy.evaluate(item, context)));
+        result = settled.map((s) => s.status === "fulfilled" ? s.value : { error: String(s.reason) });
+    }
+    else {
+        const input = readPath(ast, inputPath);
+        result = await strategy.evaluate(input, context);
+    }
+    writePath(ast, outputPath, result);
+    const completedAt = Date.now();
+    bus.emit({
+        schemaVersion: "1.0",
+        recipeRunId,
+        sessionId,
+        stepId: step.stepId,
+        methodId: step.tool,
+        phase: "step-end",
+        timestamp: new Date(completedAt).toISOString(),
+        durationMs: completedAt - startedAt,
+        payload: summariseResult(result),
+    });
+    // Aggregate this step's StrategyResult into the run-level envelope.
+    // For fanout steps (step.over), each item is its own StrategyResult; for
+    // non-fanout steps the single result is collected.
+    if (Array.isArray(result)) {
+        for (const item of result)
+            collectEnvelope(envelope, item);
+    }
+    else {
+        collectEnvelope(envelope, result);
+    }
+    envelope.trace.push({
+        command: step.tool,
+        stepId: step.stepId,
+        durationMs: completedAt - startedAt,
+        startedAt: new Date(startedAt).toISOString(),
+        completedAt: new Date(completedAt).toISOString(),
+    });
+}
+// Fold a StrategyResult's analytical channels (signals/reasoning/insights)
+// into the run-level envelope (ARCH-22). Shared by main-path steps and
+// opt-in listeners. Non-StrategyResult values are ignored.
+function collectEnvelope(envelope, sr) {
+    if (!sr || typeof sr !== "object")
+        return;
+    const r = sr;
+    if (Array.isArray(r.signals))
+        envelope.signals.push(...r.signals);
+    if (Array.isArray(r.reasoning))
+        envelope.reasoning.push(...r.reasoning);
+    if (Array.isArray(r.insights))
+        envelope.insights.push(...r.insights);
+}
+// Execute every opt-in listener declared on the recipe, AFTER the main path,
+// all in parallel (hard rule #15). A listener observes its parent step by
+// reading that step's business result from the AST (`<step.out>.result`,
+// symmetric with how downstream steps consume `$.x.result`). Listeners only
+// contribute to the envelope (signals/reasoning/insights + a trace entry);
+// a listener failure is isolated (Promise.allSettled) and never affects the
+// main path or the returned AST (ARCH-10).
+async function runListeners(opts) {
+    const { recipe, ast, context, registry, envelope } = opts;
+    const outByStep = new Map(recipe.steps.map((s) => [s.stepId, s.out ?? "$.lastResult"]));
+    const invocations = [];
+    for (const [parentStepId, methodIds] of Object.entries(recipe.listeners)) {
+        const parentOut = outByStep.get(parentStepId);
+        if (!parentOut)
+            continue; // schema guarantees the stepId exists; defensive
+        for (const methodId of methodIds) {
+            invocations.push({ parentStepId, methodId, parentOut });
+        }
+    }
+    if (invocations.length === 0)
+        return;
+    const settled = await Promise.allSettled(invocations.map(async (inv) => {
+        const startedAt = Date.now();
+        const strategyClass = registry.get(inv.methodId);
+        // any: strategy constructor signature is open by design (mirrors executeStep)
+        const strategy = new strategyClass();
+        const parentResult = readPath(ast, `${inv.parentOut}.result`);
+        const result = await strategy.evaluate(parentResult, context);
+        return { inv, result, startedAt, completedAt: Date.now() };
+    }));
+    for (const s of settled) {
+        if (s.status !== "fulfilled")
+            continue; // isolation: failure never affects the run
+        const { inv, result, startedAt, completedAt } = s.value;
+        collectEnvelope(envelope, result);
+        envelope.trace.push({
+            command: inv.methodId,
+            stepId: inv.parentStepId,
+            durationMs: completedAt - startedAt,
+            startedAt: new Date(startedAt).toISOString(),
+            completedAt: new Date(completedAt).toISOString(),
+        });
+    }
+}
+// Keep the bus payload light — full results live on the AST. The summary
+// captures shape so cross-step listeners can reason without the full body.
+function summariseResult(result) {
+    if (Array.isArray(result)) {
+        return { kind: "array", length: result.length };
+    }
+    if (result && typeof result === "object") {
+        const r = result;
+        if ("result" in r) {
+            return {
+                kind: "strategy-result",
+                signalsCount: r.signals?.length ?? 0,
+                reasoningCount: r.reasoning?.length ?? 0,
+                insightsCount: r.insights?.length ?? 0,
+            };
+        }
+        return { kind: "object", keys: Object.keys(result).length };
+    }
+    return { kind: typeof result };
+}
+//# sourceMappingURL=recipe-runner.mjs.map

package/dist/core/recipe/recipe-runner.mjs.map

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

package/dist/core/recipe/recipe.schema.d.mts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const RecipeStepSchema: z.ZodObject<{
+    stepId: z.ZodString;
+    tool: z.ZodString;
+    in: z.ZodOptional<z.ZodString>;
+    out: z.ZodOptional<z.ZodString>;
+    over: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RecipeStep = z.infer<typeof RecipeStepSchema>;
+export declare const RecipeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    name: z.ZodString;
+    domain: z.ZodString;
+    tool: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        stepId: z.ZodString;
+        tool: z.ZodString;
+        in: z.ZodOptional<z.ZodString>;
+        out: z.ZodOptional<z.ZodString>;
+        over: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    listeners: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+export type Recipe = z.infer<typeof RecipeSchema>;
+//# sourceMappingURL=recipe.schema.d.mts.map

package/dist/core/recipe/recipe.schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.schema.d.mts","sourceRoot":"","sources":["../../../src/core/recipe/recipe.schema.mts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,gBAAgB;;;;;;iBAM3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;iBA0BrB,CAAC;AACL,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/core/recipe/recipe.schema.mjs

@@ -0,0 +1,46 @@
+// A recipe is a declarative quasi-linear DAG of strategy invocations operating
+// on a single tool's AST (ARCH-06). Recipes are not parameterisable (ARCH-07);
+// behavioural variation comes from listener strategies attached to the same
+// recipe (ARCH-10). A recipe never invokes another recipe.
+import { z } from "zod";
+import { methodIdSchema } from "../ast/base-strategy.mjs";
+// Each step references a strategy by its 5-segment methodId. Optional `over`
+// path triggers auto-fanout: when the strategy expects T and the AST node at
+// `over` is T[], the runner runs the strategy once per element in parallel.
+// `in` and `out` paths bind step input/output to specific AST locations
+// (explicit linking — ARCH-3B-1).
+export const RecipeStepSchema = z.object({
+    stepId: z.string().min(1),
+    tool: methodIdSchema, // 5-segment methodId, also resolved against the registry at run time
+    in: z.string().optional(), // JSONPath into the current AST (default: whole AST)
+    out: z.string().optional(), // JSONPath where to write the result (default: $.lastResult)
+    over: z.string().optional(), // JSONPath; if present, fan out across the array
+});
+export const RecipeSchema = z
+    .object({
+    schemaVersion: z.literal("1.0"),
+    name: z.string().min(1), // canonical name e.g. "evaluate-map"
+    domain: z.string().min(1), // e.g. "wardley"
+    tool: z.string().min(1), // e.g. "evolution"
+    description: z.string().optional(),
+    steps: z.array(RecipeStepSchema).min(1),
+    // Listeners are step-attached: each key is a stepId of `steps`, mapped to
+    // the 5-segment methodIds of the listener strategies observing that step.
+    // They run after the main path completes, in parallel, and only contribute
+    // insights to the envelope (ARCH-10) — see recipe-runner.
+    listeners: z.record(z.string(), z.array(methodIdSchema)).default({}),
+})
+    .superRefine((recipe, ctx) => {
+    // A listener can only attach to a step that exists in this recipe.
+    const stepIds = new Set(recipe.steps.map((s) => s.stepId));
+    for (const stepId of Object.keys(recipe.listeners)) {
+        if (!stepIds.has(stepId)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["listeners", stepId],
+                message: `listeners key "${stepId}" does not match any step.stepId (${[...stepIds].join(", ")})`,
+            });
+        }
+    }
+});
+//# sourceMappingURL=recipe.schema.mjs.map

package/dist/core/recipe/recipe.schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.schema.mjs","sourceRoot":"","sources":["../../../src/core/recipe/recipe.schema.mts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,2DAA2D;AAE3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,wEAAwE;AACxE,kCAAkC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,cAAc,EAAE,qEAAqE;IAC3F,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qDAAqD;IAChF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,6DAA6D;IACzF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,iDAAiD;CAC/E,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,qCAAqC;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,iBAAiB;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,mBAAmB;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,0DAA0D;IAC1D,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACrE,CAAC;KACD,WAAW,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IAC3B,mEAAmE;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;gBAC3B,OAAO,EAAE,kBAAkB,MAAM,qCAAqC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACjG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/core/registry/short-name-map.d.mts

@@ -0,0 +1,10 @@
+export declare const SHORT_NAME_TO_METHOD_ID: Record<string, string>;
+export declare const METHOD_ID_TO_SHORT_NAME: Record<string, string>;
+/** Resolve a short config name or canonical methodId to a canonical 5-segment methodId.
+ *  Unknown inputs pass through unchanged — callers that already hold a methodId
+ *  don't need to know whether their input is a short name or a full id. */
+export declare function resolveStrategy(shortNameOrMethodId: string): string;
+/** Resolve a methodId to its short config name, or undefined if no mapping
+ *  is registered. */
+export declare function getShortName(methodId: string): string | undefined;
+//# sourceMappingURL=short-name-map.d.mts.map

package/dist/core/registry/short-name-map.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"short-name-map.d.mts","sourceRoot":"","sources":["../../../src/core/registry/short-name-map.mts"],"names":[],"mappings":"AAUA,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgB1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE1D,CAAC;AAEF;;2EAE2E;AAC3E,wBAAgB,eAAe,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;qBACqB;AACrB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE"}