labre-mcp 0.1.0

package/README.md

@@ -0,0 +1,97 @@
+# labre-mcp
+
+An [MCP](https://modelcontextprotocol.io) server for applying strategy **practice frameworks** — Wardley Maps first (value chain, evolution, climates, doctrines, the full study cycle). It exposes a small set of MCP tools backed by a pluggable **strategy registry** orchestrated by a **recipe runner**.
+
+It runs as a local server that an MCP client — Claude Code / the Claude Agent SDK, or any MCP-capable client — launches over **stdio**. An HTTP daemon transport is also available (SaaS-ready by design).
+
+## Requirements
+
+- **Node.js ≥ 20**
+- An **LLM provider** configured via `llm.config.json` (see [LLM configuration](#llm-configuration)). Most tools call an LLM; without a provider they degrade rather than crash, but produce no analysis.
+
+## Install & use with Claude Code (stdio)
+
+Add the server to your project's `.mcp.json` (or `~/.claude.json`). Claude Code spawns the process itself — there is no daemon to keep running:
+
+```json
+{
+  "mcpServers": {
+    "labre-mcp": {
+      "command": "npx",
+      "args": ["-y", "labre-mcp"],
+      "env": {
+        "WARDLEY_LLM_CONFIG": "C:\\path\\to\\your\\llm.config.json"
+      }
+    }
+  }
+}
+```
+
+> **Windows note:** if `npx` fails to start the server, wrap it as `"command": "cmd"`, `"args": ["/c", "npx", "-y", "labre-mcp"]`.
+
+The `WARDLEY_LLM_CONFIG` env var is optional — if omitted, the server looks for `llm.config.json` in the client's working directory (your workspace root).
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `estimateEvolution` | Estimate the Wardley evolution position of a component (runs the `estimate-component-evolution` recipe). |
+| `runCommand` | Invoke a single strategy directly by its 5-segment methodId → `CommandResult` + JSON-labre envelope. |
+| `runRecipe` | Run a multi-step recipe by `<domain>:<tool>:<name>` reference → JSON-labre envelope + final AST + artifact path. |
+| `__ping__` | Smoke tool — echoes its input. Validates the transport. |
+
+The full methodId catalogue lives in [docs/architecture/ast-schema.md](docs/architecture/ast-schema.md); recipes in [docs/architecture/recipes.md](docs/architecture/recipes.md).
+
+## LLM configuration
+
+Copy [`llm.config.example.json`](llm.config.example.json) to `llm.config.json` and point `WARDLEY_LLM_CONFIG` at it (or place it in your workspace root). Three provider kinds are supported:
+
+- `agent-sdk` — the Claude Agent SDK (`claude`).
+- `http-api` — an OpenAI-compatible gateway (e.g. OpenCode/Kimi with logprobs).
+- `copilot-sdk` — GitHub Copilot.
+
+Per-strategy provider/model/effort overrides are declared under `strategies` in the same file.
+
+### Optional capabilities
+
+Some strategies use external services and degrade gracefully when their config is absent:
+
+- **BigQuery patent analysis** (CPC evolution): `BIGQUERY_PROJECT_ID`, `GOOGLE_APPLICATION_CREDENTIALS`.
+- **Web search** (Agent SDK): `ANTHROPIC_API_KEY`.
+
+## Artifacts
+
+Each recipe run writes a verbose, analysis-ready JSON artifact to `~/.labre-mcp/runs/<projectId>/<runId>.json`.
+
+## HTTP daemon (alternative transport)
+
+For local development or a SaaS-style deployment, the server can run as an HTTP daemon instead of stdio:
+
+```bash
+npm run build
+npm run mcp:prod          # node dist/core/transport/labre-daemon.mjs
+```
+
+It listens on `127.0.0.1:6767` (override with `LABRE_HTTP_PORT`). Point the client at it with:
+
+```json
+{ "mcpServers": { "labre-mcp": { "type": "http", "url": "http://127.0.0.1:6767/mcp" } } }
+```
+
+See [docs/architecture/transport.md](docs/architecture/transport.md) for the transport model.
+
+## Development
+
+```bash
+npm install
+npm run mcp:stdio         # stdio server via tsx (dev)
+npm run mcp               # HTTP daemon via tsx (dev)
+npm run typecheck
+npm run test              # unit tests (some integration tests call real LLMs — see AGENT.md)
+```
+
+Architecture and decision records are under [docs/architecture/](docs/architecture/) — start with [ast-schema.md](docs/architecture/ast-schema.md) and [decisions.md](docs/architecture/decisions.md).
+
+## License
+
+ISC

package/dist/core/ast/analysis-ref.d.mts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export declare const AnalysisRefSchema: z.ZodNullable<z.ZodObject<{
+    artifactPath: z.ZodString;
+    jsonPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export type AnalysisRef = z.infer<typeof AnalysisRefSchema>;
+//# sourceMappingURL=analysis-ref.d.mts.map

package/dist/core/ast/analysis-ref.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-ref.d.mts","sourceRoot":"","sources":["../../../src/core/ast/analysis-ref.mts"],"names":[],"mappings":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;kBAKjB,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/core/ast/analysis-ref.mjs

@@ -0,0 +1,19 @@
+// AnalysisRef — typed pointer from a chain `EvolutionAnnotation` to the
+// richer `WardleyEvolutionAST` artefact it was derived from (ARCH-24).
+//
+// `artifactPath` is the artefact filename written by the artifact-writer
+// listener (relative to the run's artifact dir, or absolute). `jsonPath` is
+// an optional JSONPath into that artefact pointing to the specific node the
+// annotation summarises (`$.result` by default when omitted).
+//
+// Null means "no detailed analysis was produced" — the annotation stands on
+// its own (e.g. when only a deterministic strategy ran and the trace would
+// be redundant with the annotation itself).
+import { z } from "zod";
+export const AnalysisRefSchema = z
+    .object({
+    artifactPath: z.string().min(1),
+    jsonPath: z.string().optional(),
+})
+    .nullable();
+//# sourceMappingURL=analysis-ref.mjs.map

package/dist/core/ast/analysis-ref.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-ref.mjs","sourceRoot":"","sources":["../../../src/core/ast/analysis-ref.mts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,uEAAuE;AACvE,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,4CAA4C;AAE5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC;KACD,QAAQ,EAAE,CAAC"}

package/dist/core/ast/base-ast.d.mts

@@ -0,0 +1,4 @@
+export interface BaseAST {
+    readonly schemaVersion: string;
+}
+//# sourceMappingURL=base-ast.d.mts.map

package/dist/core/ast/base-ast.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-ast.d.mts","sourceRoot":"","sources":["../../../src/core/ast/base-ast.mts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC"}

package/dist/core/ast/base-ast.mjs

@@ -0,0 +1,5 @@
+// Common contract shared by every per-tool AST in labre-mcp.
+// A tool AST is the typed JSON state representation of an artefact
+// (chain map, evolution analysis, etc.) that flows between strategies.
+export {};
+//# sourceMappingURL=base-ast.mjs.map

package/dist/core/ast/base-ast.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-ast.mjs","sourceRoot":"","sources":["../../../src/core/ast/base-ast.mts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,mEAAmE;AACnE,uEAAuE"}

package/dist/core/ast/base-strategy.d.mts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { RequestContext } from "../context/request-context.mjs";
+export declare const METHOD_ID_5_SEGMENT_REGEX: RegExp;
+export declare const methodIdSchema: z.ZodString;
+export interface StrategyResult<TResult = unknown> {
+    signals: Array<{
+        name: string;
+        value: unknown;
+        source: "user-input" | "web-search" | "cpc-database" | "llm-internal" | "computed";
+        capturedAt: string;
+    }>;
+    reasoning: Array<{
+        by: string;
+        text: string;
+        promptTokens?: number;
+        completionTokens?: number;
+    }>;
+    insights: Array<{
+        text: string;
+        by: string;
+        type: "historical-context" | "comparable" | "trajectory" | "cluster" | "other";
+        confidence?: number;
+    }>;
+    result: TResult;
+}
+export declare abstract class BaseStrategy<TInput = unknown, TResult = unknown> {
+    static get method(): string;
+    abstract evaluate(input: TInput, context: RequestContext): Promise<StrategyResult<TResult>>;
+}
+//# sourceMappingURL=base-strategy.d.mts.map

package/dist/core/ast/base-strategy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-strategy.d.mts","sourceRoot":"","sources":["../../../src/core/ast/base-strategy.mts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAQrE,eAAO,MAAM,yBAAyB,QACyB,CAAC;AAIhE,eAAO,MAAM,cAAc,aAKxB,CAAC;AAEJ,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO;IAC/C,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QAEb,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EACF,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,cAAc,GACd,UAAU,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EACA,oBAAoB,GACpB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,OAAO,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,8BAAsB,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAEpE,MAAM,KAAK,MAAM,IAAI,MAAM,CAI1B;IAED,QAAQ,CAAC,QAAQ,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;CACpC"}

package/dist/core/ast/base-strategy.mjs

@@ -0,0 +1,25 @@
+// Generic base for every strategy in labre-mcp.
+// Concrete strategies live under src/frameworks/<domain>/<tool>/<sous-domaine>/<command>/<name>.mts
+// and declare their identity via the static `method` getter following the
+// 5-segment pattern {domain}:{tool}:{sous-domaine}:{command}:{strategie}
+// (ast-schema.md v0.1.0, supersedes ARCH-03 which had segments 3 and 4 swapped).
+import { z } from "zod";
+// Canonical 5-segment methodId pattern (ast-schema.md v0.1.0, ARCH-25):
+//   {domain}:{tool}:{sous-domaine}:{command}:{strategie}[@x.y.z]
+// Each segment starts with a lowercase letter and may contain lowercase
+// alphanumerics or dashes. The `@x.y.z` SemVer triplet suffix is optional —
+// when omitted, the registry resolves to the latest stable version.
+// Anchored end-to-end.
+export const METHOD_ID_5_SEGMENT_REGEX = /^[a-z][a-z0-9-]*(?::[a-z][a-z0-9-]*){4}(?:@\d+\.\d+\.\d+)?$/;
+// Zod schema fragment that enforces the 5-segment shape on any methodId
+// field stored inside an AST or a recipe definition.
+export const methodIdSchema = z
+    .string()
+    .regex(METHOD_ID_5_SEGMENT_REGEX, 'methodId must be 5 colon-separated segments {domain}:{tool}:{sous-domaine}:{command}:{strategie} with optional @x.y.z SemVer suffix');
+export class BaseStrategy {
+    // Each concrete subclass overrides this to return its 5-segment methodId.
+    static get method() {
+        throw new Error("BaseStrategy.method must be overridden by the subclass with a 5-segment methodId");
+    }
+}
+//# sourceMappingURL=base-strategy.mjs.map

package/dist/core/ast/base-strategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-strategy.mjs","sourceRoot":"","sources":["../../../src/core/ast/base-strategy.mts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,oGAAoG;AACpG,0EAA0E;AAC1E,yEAAyE;AACzE,iFAAiF;AAEjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,wEAAwE;AACxE,iEAAiE;AACjE,wEAAwE;AACxE,4EAA4E;AAC5E,oEAAoE;AACpE,uBAAuB;AACvB,MAAM,CAAC,MAAM,yBAAyB,GACpC,6DAA6D,CAAC;AAEhE,wEAAwE;AACxE,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,KAAK,CACJ,yBAAyB,EACzB,qIAAqI,CACtI,CAAC;AAmCJ,MAAM,OAAgB,YAAY;IAChC,0EAA0E;IAC1E,MAAM,KAAK,MAAM;QACf,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,CAAC;CAMF"}

package/dist/core/bus/event-bus.d.mts

@@ -0,0 +1,11 @@
+import type { Observable } from "rxjs";
+import type { PipelineEvent } from "./event.schema.mjs";
+export type EventFilter = (event: PipelineEvent) => boolean;
+export interface EventBus {
+    emit(event: PipelineEvent): void;
+    observe(filter?: EventFilter): Observable<PipelineEvent>;
+    subscribe(filter?: EventFilter): AsyncIterable<PipelineEvent>;
+}
+export declare function createEventBus(): EventBus;
+export declare function waitForEvent(bus: EventBus, predicate: EventFilter): Promise<PipelineEvent>;
+//# sourceMappingURL=event-bus.d.mts.map

package/dist/core/bus/event-bus.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.mts","sourceRoot":"","sources":["../../../src/core/bus/event-bus.mts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;AAE5D,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACzD,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;CAC/D;AAED,wBAAgB,cAAc,IAAI,QAAQ,CAezC;AAkDD,wBAAsB,YAAY,CAChC,GAAG,EAAE,QAAQ,EACb,SAAS,EAAE,WAAW,GACrB,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/core/bus/event-bus.mjs

@@ -0,0 +1,70 @@
+// In-process event bus backed by RxJS Subject (ARCH-10).
+// Stateless from the caller perspective: emit fires-and-forgets;
+// subscribe returns an AsyncIterable filtered to the caller's interest.
+// One bus instance per recipe execution (scoped, not global) — V2 may add
+// session-level scope without breaking the interface.
+import { Subject, filter as rxFilter, firstValueFrom } from "rxjs";
+export function createEventBus() {
+    const subject = new Subject();
+    const observe = (predicate) => predicate ? subject.asObservable().pipe(rxFilter(predicate)) : subject.asObservable();
+    return {
+        emit(event) {
+            subject.next(event);
+        },
+        observe,
+        subscribe(predicate) {
+            return iterableFromObservable(observe(predicate));
+        },
+    };
+}
+// Bridge an Observable to AsyncIterable so consumers can use for-await.
+async function* iterableFromObservable(source) {
+    // any: deferred queue without bounded backpressure — fits in-process scale
+    const queue = [];
+    let resolveNext = null;
+    let completed = false;
+    const subscription = source.subscribe({
+        next: (value) => {
+            if (resolveNext) {
+                const r = resolveNext;
+                resolveNext = null;
+                r({ value, done: false });
+            }
+            else {
+                queue.push(value);
+            }
+        },
+        complete: () => {
+            completed = true;
+            if (resolveNext) {
+                const r = resolveNext;
+                resolveNext = null;
+                r({ value: undefined, done: true });
+            }
+        },
+    });
+    try {
+        while (true) {
+            if (queue.length > 0) {
+                yield queue.shift();
+                continue;
+            }
+            if (completed)
+                return;
+            const next = await new Promise((resolve) => {
+                resolveNext = resolve;
+            });
+            if (next.done)
+                return;
+            yield next.value;
+        }
+    }
+    finally {
+        subscription.unsubscribe();
+    }
+}
+// Helper: await the first event matching a predicate (handy for tests).
+export async function waitForEvent(bus, predicate) {
+    return firstValueFrom(bus.observe(predicate));
+}
+//# sourceMappingURL=event-bus.mjs.map

package/dist/core/bus/event-bus.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.mjs","sourceRoot":"","sources":["../../../src/core/bus/event-bus.mts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,iEAAiE;AACjE,wEAAwE;AACxE,0EAA0E;AAC1E,sDAAsD;AAEtD,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAYnE,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAiB,CAAC;IAE7C,MAAM,OAAO,GAAG,CAAC,SAAuB,EAA6B,EAAE,CACrE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IAExF,OAAO;QACL,IAAI,CAAC,KAAK;YACR,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO;QACP,SAAS,CAAC,SAAS;YACjB,OAAO,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,KAAK,SAAS,CAAC,CAAC,sBAAsB,CACpC,MAAiC;IAEjC,2EAA2E;IAC3E,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,WAAW,GAAwD,IAAI,CAAC;IAC5E,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC;QACpC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACd,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,CAAC,GAAG,WAAW,CAAC;gBACtB,WAAW,GAAG,IAAI,CAAC;gBACnB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE;YACb,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,CAAC,GAAG,WAAW,CAAC;gBACtB,WAAW,GAAG,IAAI,CAAC;gBACnB,CAAC,CAAC,EAAE,KAAK,EAAE,SAAqC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,KAAK,CAAC,KAAK,EAAmB,CAAC;gBACrC,SAAS;YACX,CAAC;YACD,IAAI,SAAS;gBAAE,OAAO;YACtB,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAgC,CAAC,OAAO,EAAE,EAAE;gBACxE,WAAW,GAAG,OAAO,CAAC;YACxB,CAAC,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO;YACtB,MAAM,IAAI,CAAC,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAa,EACb,SAAsB;IAEtB,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/core/bus/event.schema.d.mts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const PipelineEventSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    recipeRunId: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    stepId: z.ZodString;
+    methodId: z.ZodString;
+    phase: z.ZodEnum<{
+        "step-start": "step-start";
+        "step-end": "step-end";
+        "listener-insight": "listener-insight";
+        "run-end": "run-end";
+    }>;
+    timestamp: z.ZodString;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    degraded: z.ZodOptional<z.ZodBoolean>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type PipelineEvent = z.infer<typeof PipelineEventSchema>;
+//# sourceMappingURL=event.schema.d.mts.map

package/dist/core/bus/event.schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.schema.d.mts","sourceRoot":"","sources":["../../../src/core/bus/event.schema.mts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAY9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/core/bus/event.schema.mjs

@@ -0,0 +1,19 @@
+// PipelineEvent is the canonical shape of any event emitted on the kernel bus.
+// V1: emitted in-memory only. V2 may persist these (DuckDB) — schema is
+// versioned to allow forward-compatible evolution.
+// See ARCH-10 (bus design) and ARCH-22 (strategy result format).
+import { z } from "zod";
+export const PipelineEventSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    recipeRunId: z.string(),
+    sessionId: z.string().optional(),
+    stepId: z.string(),
+    methodId: z.string(),
+    phase: z.enum(["step-start", "step-end", "listener-insight", "run-end"]),
+    timestamp: z.string(), // ISO 8601
+    durationMs: z.number().optional(),
+    degraded: z.boolean().optional(),
+    // any: per-event payload is open — strategies and listeners attach what they need
+    payload: z.unknown().optional(),
+});
+//# sourceMappingURL=event.schema.mjs.map

package/dist/core/bus/event.schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.schema.mjs","sourceRoot":"","sources":["../../../src/core/bus/event.schema.mts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,mDAAmD;AACnD,iEAAiE;AAEjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,SAAS,CAAC,CAAC;IACxE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,kFAAkF;IAClF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC"}

package/dist/core/context/request-context.d.mts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const RequestContextSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    projectRoot: z.ZodString;
+    sessionId: z.ZodString;
+    domain: z.ZodString;
+    artifactDir: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RequestContext = z.infer<typeof RequestContextSchema>;
+//# sourceMappingURL=request-context.d.mts.map

package/dist/core/context/request-context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.mts","sourceRoot":"","sources":["../../../src/core/context/request-context.mts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/core/context/request-context.mjs

@@ -0,0 +1,13 @@
+// RequestContext travels with every tool call. It replaces process.cwd() and
+// implicit env reads at runtime (ARCH-15). The daemon extracts it from the
+// JSON-RPC request body; in-process callers (tests, internal handlers)
+// construct it explicitly.
+import { z } from "zod";
+export const RequestContextSchema = z.object({
+    projectId: z.string().min(1),
+    projectRoot: z.string().min(1),
+    sessionId: z.string().min(1),
+    domain: z.string().min(1),
+    artifactDir: z.string().min(1).optional(),
+});
+//# sourceMappingURL=request-context.mjs.map

package/dist/core/context/request-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.mjs","sourceRoot":"","sources":["../../../src/core/context/request-context.mts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,uEAAuE;AACvE,2BAA2B;AAE3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}

package/dist/core/index.d.mts

@@ -0,0 +1,13 @@
+export { BaseStrategy, METHOD_ID_5_SEGMENT_REGEX, methodIdSchema, type StrategyResult, } from "./ast/base-strategy.mjs";
+export { AnalysisRefSchema, type AnalysisRef } from "./ast/analysis-ref.mjs";
+export type { BaseAST } from "./ast/base-ast.mjs";
+export { StrategyRegistry, validateMethodId } from "./registry/strategy-registry.mjs";
+export { type Recipe, type RecipeStep, RecipeSchema, RecipeStepSchema, } from "./recipe/recipe.schema.mjs";
+export { runRecipe } from "./recipe/recipe-runner.mjs";
+export { loadRecipe, resetRecipeCache } from "./recipe/recipe-loader.mjs";
+export { createEventBus, waitForEvent, type EventBus, type EventFilter, } from "./bus/event-bus.mjs";
+export { type PipelineEvent, PipelineEventSchema } from "./bus/event.schema.mjs";
+export { type RequestContext, RequestContextSchema, } from "./context/request-context.mjs";
+export { attachArtifactWriter, ARTIFACT_WRITE_TIMEOUT_MS, type ArtifactWriterHandle, type WriteArtifactFn, } from "./listeners/artifact-writer-listener.mjs";
+export { writeArtifact, defaultArtifactDir, type ArtifactBody, type WriteArtifactOptions, } from "./persistence/artifact-writer.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/core/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/core/index.mts"],"names":[],"mappings":"AAMA,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC7E,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEtF,OAAO,EACL,KAAK,MAAM,EACX,KAAK,UAAU,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,0CAA0C,CAAC;AAElD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,mCAAmC,CAAC"}

package/dist/core/index.mjs

@@ -0,0 +1,17 @@
+// Public surface of the labre-mcp kernel.
+//
+// Framework code (`src/frameworks/*`) and external integrations import from
+// `#core/...` directly today. This barrel exists as a stable re-export point
+// so future package extraction of the kernel does not break call sites.
+export { BaseStrategy, METHOD_ID_5_SEGMENT_REGEX, methodIdSchema, } from "./ast/base-strategy.mjs";
+export { AnalysisRefSchema } from "./ast/analysis-ref.mjs";
+export { StrategyRegistry, validateMethodId } from "./registry/strategy-registry.mjs";
+export { RecipeSchema, RecipeStepSchema, } from "./recipe/recipe.schema.mjs";
+export { runRecipe } from "./recipe/recipe-runner.mjs";
+export { loadRecipe, resetRecipeCache } from "./recipe/recipe-loader.mjs";
+export { createEventBus, waitForEvent, } from "./bus/event-bus.mjs";
+export { PipelineEventSchema } from "./bus/event.schema.mjs";
+export { RequestContextSchema, } from "./context/request-context.mjs";
+export { attachArtifactWriter, ARTIFACT_WRITE_TIMEOUT_MS, } from "./listeners/artifact-writer-listener.mjs";
+export { writeArtifact, defaultArtifactDir, } from "./persistence/artifact-writer.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/core/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/core/index.mts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AAExE,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,cAAc,GAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAoB,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEtF,OAAO,EAGL,YAAY,EACZ,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EACL,cAAc,EACd,YAAY,GAGb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAsB,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAEL,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAG1B,MAAM,0CAA0C,CAAC;AAElD,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,mCAAmC,CAAC"}

package/dist/core/listeners/artifact-writer-listener.d.mts

@@ -0,0 +1,20 @@
+import type { EventBus } from "../bus/event-bus.mjs";
+import type { RequestContext } from "../context/request-context.mjs";
+import { type WriteArtifactOptions } from "../persistence/artifact-writer.mjs";
+export declare const ARTIFACT_WRITE_TIMEOUT_MS = 30000;
+export type WriteArtifactFn = (args: WriteArtifactOptions) => Promise<string>;
+export interface AttachArtifactWriterOptions {
+    bus: EventBus;
+    context: RequestContext;
+    getAst: () => unknown;
+    writeArtifact?: WriteArtifactFn;
+    timeoutMs?: number;
+}
+export interface ArtifactWriterHandle {
+    /** Force-detach and flush any pending writes (idempotent). */
+    detach(): Promise<void>;
+    /** Path of the written artefact (resolved after run-end event fires, or `null` on failure / timeout). */
+    artifactPath: Promise<string | null>;
+}
+export declare function attachArtifactWriter(options: AttachArtifactWriterOptions): ArtifactWriterHandle;
+//# sourceMappingURL=artifact-writer-listener.d.mts.map

package/dist/core/listeners/artifact-writer-listener.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-writer-listener.d.mts","sourceRoot":"","sources":["../../../src/core/listeners/artifact-writer-listener.mts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,oCAAoC,CAAC;AAE5C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IAExB,MAAM,EAAE,MAAM,OAAO,CAAC;IAEtB,aAAa,CAAC,EAAE,eAAe,CAAC;IAEhC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,yGAAyG;IACzG,YAAY,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACtC;AAyBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,oBAAoB,CAyC/F"}

package/dist/core/listeners/artifact-writer-listener.mjs

@@ -0,0 +1,64 @@
+// Core listener (ARCH-10, non-disablable) that persists each recipe run's
+// trace + final AST as a JSON artefact. Subscribed to the event bus at
+// recipe-runner start; writes on the `run-end` event.
+//
+// V1 cannot be disabled by user config (ARCH-08 / ARCH-10). It can be
+// silenced for in-process tests by not attaching it — production paths
+// always attach via attachArtifactWriter().
+//
+// Timeout: writeArtifact is bounded by ARTIFACT_WRITE_TIMEOUT_MS (default
+// 30 s). On timeout, the promise resolves to `null` so callers awaiting
+// `artifactPath` cannot hang on a stalled disk (NFS, slow filesystem).
+import { writeArtifact as defaultWriteArtifact, } from "../persistence/artifact-writer.mjs";
+export const ARTIFACT_WRITE_TIMEOUT_MS = 30_000;
+function withTimeout(promise, timeoutMs, onTimeout) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            onTimeout();
+            resolve(null);
+        }, timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, () => {
+            clearTimeout(timer);
+            resolve(null);
+        });
+    });
+}
+export function attachArtifactWriter(options) {
+    const events = [];
+    const startedAt = new Date().toISOString();
+    const writeFn = options.writeArtifact ?? defaultWriteArtifact;
+    const timeoutMs = options.timeoutMs ?? ARTIFACT_WRITE_TIMEOUT_MS;
+    let resolveArtifactPath;
+    const artifactPath = new Promise((r) => {
+        resolveArtifactPath = r;
+    });
+    const subscription = options.bus.observe().subscribe(async (event) => {
+        events.push(event);
+        if (event.phase === "run-end") {
+            const result = await withTimeout(writeFn({
+                context: options.context,
+                events: [...events],
+                ast: options.getAst(),
+                startedAt,
+                completedAt: event.timestamp,
+                recipeRunId: event.recipeRunId,
+            }), timeoutMs, () => {
+                // Persistence stall must never abort a recipe — fail open. The
+                // null resolution below signals "no artefact path available" to
+                // the caller.
+            });
+            resolveArtifactPath(result);
+        }
+    });
+    return {
+        async detach() {
+            subscription.unsubscribe();
+            resolveArtifactPath(null);
+        },
+        artifactPath,
+    };
+}
+//# sourceMappingURL=artifact-writer-listener.mjs.map

package/dist/core/listeners/artifact-writer-listener.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-writer-listener.mjs","sourceRoot":"","sources":["../../../src/core/listeners/artifact-writer-listener.mts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,uEAAuE;AACvE,sDAAsD;AACtD,EAAE;AACF,sEAAsE;AACtE,uEAAuE;AACvE,4CAA4C;AAC5C,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,uEAAuE;AAKvE,OAAO,EACL,aAAa,IAAI,oBAAoB,GAEtC,MAAM,oCAAoC,CAAC;AAE5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAsBhD,SAAS,WAAW,CAClB,OAAmB,EACnB,SAAiB,EACjB,SAAqB;IAErB,OAAO,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE;YACR,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EACD,GAAG,EAAE;YACH,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAoC;IACvE,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAoB,OAAO,CAAC,aAAa,IAAI,oBAAoB,CAAC;IAC/E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,yBAAyB,CAAC;IAEjE,IAAI,mBAA+C,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,OAAO,CAAgB,CAAC,CAAC,EAAE,EAAE;QACpD,mBAAmB,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACnE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,OAAO,CAAC;gBACN,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;gBACnB,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE;gBACrB,SAAS;gBACT,WAAW,EAAE,KAAK,CAAC,SAAS;gBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,EACF,SAAS,EACT,GAAG,EAAE;gBACH,+DAA+D;gBAC/D,gEAAgE;gBAChE,cAAc;YAChB,CAAC,CACF,CAAC;YACF,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,MAAM;YACV,YAAY,CAAC,WAAW,EAAE,CAAC;YAC3B,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/core/persistence/artifact-writer.d.mts

@@ -0,0 +1,25 @@
+import type { PipelineEvent } from "../bus/event.schema.mjs";
+import type { RequestContext } from "../context/request-context.mjs";
+export interface ArtifactBody {
+    schemaVersion: "1.0";
+    recipeRunId: string;
+    sessionId: string;
+    domain: string;
+    projectId: string;
+    projectRoot: string;
+    startedAt: string;
+    completedAt: string;
+    events: PipelineEvent[];
+    ast: unknown;
+}
+export declare function defaultArtifactDir(projectId: string): string;
+export interface WriteArtifactOptions {
+    context: RequestContext;
+    events: PipelineEvent[];
+    ast: unknown;
+    startedAt: string;
+    completedAt: string;
+    recipeRunId: string;
+}
+export declare function writeArtifact(options: WriteArtifactOptions): Promise<string>;
+//# sourceMappingURL=artifact-writer.d.mts.map

package/dist/core/persistence/artifact-writer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-writer.d.mts","sourceRoot":"","sources":["../../../src/core/persistence/artifact-writer.mts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,KAAK,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlF"}

package/dist/core/persistence/artifact-writer.mjs

@@ -0,0 +1,36 @@
+// Artifact writer: persists a recipe execution trace to a JSON file
+// (ARCH-12). The format is verbose and LLM-readable: descriptive keys, no
+// compression, no abbreviation. Future analytical layers (V2 DuckDB) read
+// these files directly.
+//
+// Default location: ~/.labre-mcp/runs/<projectId>/<runId>.json
+// Override via RequestContext.artifactDir for project-local benchmarks.
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+export function defaultArtifactDir(projectId) {
+    return join(homedir(), ".labre-mcp", "runs", projectId);
+}
+export async function writeArtifact(options) {
+    const { context, events, ast, startedAt, completedAt, recipeRunId } = options;
+    const targetDir = context.artifactDir
+        ? resolve(context.artifactDir)
+        : defaultArtifactDir(context.projectId);
+    await mkdir(targetDir, { recursive: true });
+    const body = {
+        schemaVersion: "1.0",
+        recipeRunId,
+        sessionId: context.sessionId,
+        domain: context.domain,
+        projectId: context.projectId,
+        projectRoot: context.projectRoot,
+        startedAt,
+        completedAt,
+        events,
+        ast,
+    };
+    const targetPath = join(targetDir, `${recipeRunId}.json`);
+    await writeFile(targetPath, JSON.stringify(body, null, 2), "utf8");
+    return targetPath;
+}
+//# sourceMappingURL=artifact-writer.mjs.map

package/dist/core/persistence/artifact-writer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-writer.mjs","sourceRoot":"","sources":["../../../src/core/persistence/artifact-writer.mts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,0EAA0E;AAC1E,0EAA0E;AAC1E,wBAAwB;AACxB,EAAE;AACF,+DAA+D;AAC/D,wEAAwE;AAExE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAkBlC,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAWD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA6B;IAC/D,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE9E,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW;QACnC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;QAC9B,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE1C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,IAAI,GAAiB;QACzB,aAAa,EAAE,KAAK;QACpB,WAAW;QACX,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS;QACT,WAAW;QACX,MAAM;QACN,GAAG;KACJ,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,WAAW,OAAO,CAAC,CAAC;IAC1D,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACnE,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/persistence/project-id-resolver.d.mts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const ProjectMarkerSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, z.core.$strip>;
+export type ProjectMarker = z.infer<typeof ProjectMarkerSchema>;
+export declare function resolveProjectId(projectRoot: string): Promise<string>;
+/** Write a new .labre/project.json with a freshly generated UUID. */
+export declare function initProjectMarker(projectRoot: string, projectId: string): Promise<void>;
+/** Test-only: clear the projectId cache. */
+export declare function resetProjectIdCache(): void;
+//# sourceMappingURL=project-id-resolver.d.mts.map

package/dist/core/persistence/project-id-resolver.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id-resolver.d.mts","sourceRoot":"","sources":["../../../src/core/persistence/project-id-resolver.mts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB3E;AAED,qEAAqE;AACrE,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7F;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}