@farmslot/recipe-harness 0.3.2 → 0.3.3

package/dist/core/library.d.ts

@@ -0,0 +1,72 @@
+import { type InlineFlow } from './flows.js';
+import type { LoadedRecipeLibrarySource, RecipeLibrarySource, RecipeLogger } from './types.js';
+/**
+ * Structural stand-in for `NodeJS.ProcessEnv` so the public API typechecks for
+ * consumers without `@types/node`.
+ */
+export type RecipeLibraryEnv = Record<string, string | undefined>;
+export interface ResolvedLibraryFlow {
+    ref: string;
+    flow: InlineFlow;
+    raw: Record<string, unknown>;
+    source: string;
+    /** Catalog file path relative to the library root. */
+    file: string;
+    /** Source names that also declare this ref at lower precedence. */
+    shadows: string[];
+    lastVerified?: string;
+}
+export interface RecipeLibraryResolution {
+    sources: LoadedRecipeLibrarySource[];
+    flows: ReadonlyMap<string, ResolvedLibraryFlow>;
+}
+/**
+ * Parse a `RECIPE_LIBRARY_PATH`-style value: ordered, colon-separated
+ * `name=path` or bare-path entries. Order is precedence (first wins).
+ */
+export declare function parseRecipeLibraryPath(value: string): RecipeLibrarySource[];
+/**
+ * The personal library location: `<farmslot home>/recipe-library`
+ * (FARMSLOT_HOME env, default ~/.farmslot). The directory may not exist yet.
+ */
+export declare function personalRecipeLibraryRoot(env?: RecipeLibraryEnv): string;
+/**
+ * Default sources when nothing is configured: the personal library when it
+ * exists.
+ */
+export declare function defaultRecipeLibrarySources(env?: RecipeLibraryEnv): Promise<RecipeLibrarySource[]>;
+/**
+ * Resolve the ordered library sources for a run: explicit entries (CLI flags
+ * first, then RECIPE_LIBRARY_PATH) replace the defaults entirely so a run's
+ * precedence is always fully spelled out by whoever configured it.
+ */
+export declare function resolveRecipeLibrarySources(options?: {
+    cliEntries?: string[];
+    env?: RecipeLibraryEnv;
+}): Promise<RecipeLibrarySource[]>;
+/**
+ * Load and merge ordered library sources into one flow resolution. Shadowing
+ * across sources is recorded and logged; duplicate refs within one source are
+ * an error, matching recipe-local catalog behavior.
+ */
+export declare function loadRecipeLibraries(sources: readonly RecipeLibrarySource[], logger?: RecipeLogger): Promise<RecipeLibraryResolution>;
+export interface EffectiveFlowCatalog {
+    catalog: ReadonlyMap<string, InlineFlow>;
+    /** Recipe-local declarations that overrode a library-provided ref. */
+    overrides: Array<{
+        ref: string;
+        source: string;
+    }>;
+}
+/**
+ * Merge recipe-local flows over library flows. Recipe-local declarations
+ * (inline `flows` and explicit `uses` catalogs) always win — the recipe author
+ * spelled them out — and any library refs they override are returned (and
+ * logged) so runs can report them even for programmatic consumers without a
+ * logger. Library flow lookups are recorded into `usedLibraryFlows` so runs
+ * can report exactly which library flows produced the proof.
+ */
+export declare function createEffectiveFlowCatalog(recipeFlows: ReadonlyMap<string, InlineFlow>, resolution: RecipeLibraryResolution | undefined, usedLibraryFlows: Map<string, ResolvedLibraryFlow>, logger?: RecipeLogger): EffectiveFlowCatalog;
+/** Catalog file names (relative to `<root>/flows/`) of a library, sorted. */
+export declare function listFlowCatalogFiles(root: string): Promise<string[]>;
+//# sourceMappingURL=library.d.ts.map

package/dist/core/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/core/library.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/F;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAe3E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,gBAA8B,GAAG,MAAM,CAErF;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,GAAE,gBAA8B,GAClC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAQhC;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IAC1D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAQjC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAgDlC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,sEAAsE;IACtE,SAAS,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EAC5C,UAAU,EAAE,uBAAuB,GAAG,SAAS,EAC/C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAClD,MAAM,CAAC,EAAE,YAAY,GACpB,oBAAoB,CAuBtB;AA8DD,6EAA6E;AAC7E,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB1E"}

package/dist/core/library.js

@@ -0,0 +1,240 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { farmslotHome } from '@farmslot/protocol/node/farmslot-home';
+import { readCatalogFlows } from './flows.js';
+import { isRecord, readJsonFile } from './json.js';
+const LIBRARY_MANIFEST_FILE = 'library.json';
+const LIBRARY_FLOWS_DIR = 'flows';
+const LIBRARY_FLOW_CATALOG_SUFFIX = '.flows.json';
+const LAST_VERIFIED_WARN_AFTER_DAYS = 30;
+/**
+ * Parse a `RECIPE_LIBRARY_PATH`-style value: ordered, colon-separated
+ * `name=path` or bare-path entries. Order is precedence (first wins).
+ */
+export function parseRecipeLibraryPath(value) {
+    return value
+        .split(':')
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .map((entry) => {
+        const separator = entry.indexOf('=');
+        if (separator < 0)
+            return { root: expandTilde(entry) };
+        const name = entry.slice(0, separator).trim();
+        const root = entry.slice(separator + 1).trim();
+        if (!name || !root) {
+            throw new Error(`Recipe library entry ${JSON.stringify(entry)} must be name=path or path.`);
+        }
+        return { name, root: expandTilde(root) };
+    });
+}
+/**
+ * The personal library location: `<farmslot home>/recipe-library`
+ * (FARMSLOT_HOME env, default ~/.farmslot). The directory may not exist yet.
+ */
+export function personalRecipeLibraryRoot(env = process.env) {
+    return path.join(farmslotHome(env), 'recipe-library');
+}
+/**
+ * Default sources when nothing is configured: the personal library when it
+ * exists.
+ */
+export async function defaultRecipeLibrarySources(env = process.env) {
+    const personalRoot = personalRecipeLibraryRoot(env);
+    try {
+        await readFile(path.join(personalRoot, LIBRARY_MANIFEST_FILE), 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    return [{ name: 'personal', root: personalRoot }];
+}
+/**
+ * Resolve the ordered library sources for a run: explicit entries (CLI flags
+ * first, then RECIPE_LIBRARY_PATH) replace the defaults entirely so a run's
+ * precedence is always fully spelled out by whoever configured it.
+ */
+export async function resolveRecipeLibrarySources(options) {
+    const env = options?.env ?? process.env;
+    const explicit = [
+        ...(options?.cliEntries ?? []).flatMap((entry) => parseRecipeLibraryPath(entry)),
+        ...(env.RECIPE_LIBRARY_PATH ? parseRecipeLibraryPath(env.RECIPE_LIBRARY_PATH) : []),
+    ];
+    if (explicit.length > 0)
+        return explicit;
+    return defaultRecipeLibrarySources(env);
+}
+/**
+ * Load and merge ordered library sources into one flow resolution. Shadowing
+ * across sources is recorded and logged; duplicate refs within one source are
+ * an error, matching recipe-local catalog behavior.
+ */
+export async function loadRecipeLibraries(sources, logger) {
+    const loadedSources = [];
+    const flows = new Map();
+    const seenNames = new Set();
+    for (const source of sources) {
+        const root = path.resolve(expandTilde(source.root));
+        const manifest = await readLibraryManifest(root);
+        const name = source.name ?? manifest.name ?? path.basename(root);
+        if (seenNames.has(name)) {
+            throw new Error(`Recipe library source ${name} is configured more than once.`);
+        }
+        seenNames.add(name);
+        const sourceFlows = new Map();
+        for (const file of await listFlowCatalogFiles(root)) {
+            const catalogPath = path.join(root, LIBRARY_FLOWS_DIR, file);
+            const catalog = await readJsonFile(catalogPath);
+            assertFlowCatalogKind(catalog, catalogPath);
+            for (const entry of readCatalogFlows(catalog, catalogPath)) {
+                if (sourceFlows.has(entry.ref)) {
+                    throw new Error(`Flow ${entry.ref} is declared more than once in library ${name}.`);
+                }
+                sourceFlows.set(entry.ref, {
+                    ref: entry.ref,
+                    flow: entry.flow,
+                    raw: entry.raw,
+                    source: name,
+                    file: path.join(LIBRARY_FLOWS_DIR, file),
+                    shadows: [],
+                    ...(lastVerifiedDate(entry.raw) ? { lastVerified: lastVerifiedDate(entry.raw) } : {}),
+                });
+            }
+        }
+        loadedSources.push({ name, root, flowCount: sourceFlows.size });
+        for (const [ref, resolved] of sourceFlows) {
+            const winner = flows.get(ref);
+            if (winner) {
+                winner.shadows.push(name);
+            }
+            else {
+                flows.set(ref, resolved);
+            }
+        }
+    }
+    if (logger)
+        logResolution(logger, { sources: loadedSources, flows });
+    return { sources: loadedSources, flows };
+}
+/**
+ * Merge recipe-local flows over library flows. Recipe-local declarations
+ * (inline `flows` and explicit `uses` catalogs) always win — the recipe author
+ * spelled them out — and any library refs they override are returned (and
+ * logged) so runs can report them even for programmatic consumers without a
+ * logger. Library flow lookups are recorded into `usedLibraryFlows` so runs
+ * can report exactly which library flows produced the proof.
+ */
+export function createEffectiveFlowCatalog(recipeFlows, resolution, usedLibraryFlows, logger) {
+    if (!resolution || resolution.flows.size === 0) {
+        return { catalog: recipeFlows, overrides: [] };
+    }
+    const fromLibrary = new Map();
+    const merged = new TrackingFlowCatalog(fromLibrary, usedLibraryFlows);
+    const overrides = [];
+    for (const [ref, resolved] of resolution.flows) {
+        merged.set(ref, resolved.flow);
+        fromLibrary.set(ref, resolved);
+    }
+    for (const [ref, flow] of recipeFlows) {
+        const overridden = fromLibrary.get(ref);
+        if (overridden) {
+            fromLibrary.delete(ref);
+            overrides.push({ ref, source: overridden.source });
+            logger?.warn(`Flow ${ref} is declared by the recipe and overrides the ${overridden.source} library declaration.`);
+        }
+        merged.set(ref, flow);
+    }
+    return { catalog: merged, overrides };
+}
+class TrackingFlowCatalog extends Map {
+    #fromLibrary;
+    #used;
+    constructor(fromLibrary, used) {
+        super();
+        this.#fromLibrary = fromLibrary;
+        this.#used = used;
+    }
+    get(ref) {
+        const flow = super.get(ref);
+        if (flow) {
+            const resolved = this.#fromLibrary.get(ref);
+            if (resolved)
+                this.#used.set(ref, resolved);
+        }
+        return flow;
+    }
+}
+function logResolution(logger, resolution) {
+    const summary = resolution.sources
+        .map((source) => `${source.name}=${source.root} (${source.flowCount} flows)`)
+        .join(', ');
+    logger.info(`Recipe libraries: ${summary || 'none'}`);
+    for (const flow of resolution.flows.values()) {
+        if (flow.shadows.length > 0) {
+            logger.warn(`Flow ${flow.ref} resolves from ${flow.source} and shadows ${flow.shadows.join(', ')}.`);
+        }
+        const staleDays = daysSince(flow.lastVerified);
+        if (staleDays != null && staleDays > LAST_VERIFIED_WARN_AFTER_DAYS) {
+            logger.warn(`Flow ${flow.ref} (${flow.source}) was last verified ${staleDays} days ago; re-verify before trusting it as proof setup.`);
+        }
+    }
+}
+async function readLibraryManifest(root) {
+    const manifestPath = path.join(root, LIBRARY_MANIFEST_FILE);
+    let manifest;
+    try {
+        manifest = await readJsonFile(manifestPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${root} is not a recipe library: ${message}. A library needs a ${LIBRARY_MANIFEST_FILE} with kind "recipe-library".`);
+    }
+    if (!isRecord(manifest) || manifest.kind !== 'recipe-library') {
+        throw new Error(`${manifestPath} must declare kind "recipe-library".`);
+    }
+    return { ...(typeof manifest.name === 'string' && manifest.name ? { name: manifest.name } : {}) };
+}
+/** Catalog file names (relative to `<root>/flows/`) of a library, sorted. */
+export async function listFlowCatalogFiles(root) {
+    let entries;
+    try {
+        entries = await readdir(path.join(root, LIBRARY_FLOWS_DIR), { withFileTypes: true });
+    }
+    catch (error) {
+        if (error?.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    return entries
+        .filter((entry) => (entry.isFile() || entry.isSymbolicLink()) &&
+        entry.name.endsWith(LIBRARY_FLOW_CATALOG_SUFFIX))
+        .map((entry) => entry.name)
+        .sort();
+}
+function assertFlowCatalogKind(catalog, catalogPath) {
+    if (!isRecord(catalog) || catalog.kind !== 'recipe-flow-catalog') {
+        throw new Error(`${catalogPath} must declare kind "recipe-flow-catalog".`);
+    }
+}
+function lastVerifiedDate(raw) {
+    const provenance = raw.provenance;
+    if (!isRecord(provenance))
+        return undefined;
+    const lastVerified = provenance.lastVerified;
+    if (isRecord(lastVerified) && typeof lastVerified.date === 'string')
+        return lastVerified.date;
+    return undefined;
+}
+function daysSince(date) {
+    if (!date)
+        return undefined;
+    const timestamp = Date.parse(date);
+    if (Number.isNaN(timestamp))
+        return undefined;
+    return Math.floor((Date.now() - timestamp) / (24 * 60 * 60 * 1000));
+}
+function expandTilde(p) {
+    return p === '~' || p.startsWith('~/') ? path.join(homedir(), p.slice(1)) : p;
+}
+//# sourceMappingURL=library.js.map

package/dist/core/library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../src/core/library.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAErE,OAAO,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGnD,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAC7C,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC,MAAM,2BAA2B,GAAG,aAAa,CAAC;AAClD,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAyBzC;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,SAAS,GAAG,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAwB,OAAO,CAAC,GAAG;IAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAwB,OAAO,CAAC,GAAG;IAEnC,MAAM,YAAY,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAGjD;IACC,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACxC,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAChF,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACpF,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,OAAO,2BAA2B,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAuC,EACvC,MAAqB;IAErB,MAAM,aAAa,GAAgC,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,gCAAgC,CAAC,CAAC;QACjF,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEpB,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;QAC3D,KAAK,MAAM,IAAI,IAAI,MAAM,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YAChD,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC5C,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC3D,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,GAAG,0CAA0C,IAAI,GAAG,CAAC,CAAC;gBACtF,CAAC;gBACD,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;oBACzB,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,MAAM,EAAE,IAAI;oBACZ,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC;oBACxC,OAAO,EAAE,EAAE;oBACX,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhE,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM;QAAE,aAAa,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,WAA4C,EAC5C,UAA+C,EAC/C,gBAAkD,EAClD,MAAqB;IAErB,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACtE,MAAM,SAAS,GAA2C,EAAE,CAAC;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/B,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,UAAU,EAAE,CAAC;YACf,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACnD,MAAM,EAAE,IAAI,CACV,QAAQ,GAAG,gDAAgD,UAAU,CAAC,MAAM,uBAAuB,CACpG,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,mBAAoB,SAAQ,GAAuB;IAC9C,YAAY,CAA2C;IACvD,KAAK,CAAmC;IAEjD,YACE,WAAqD,EACrD,IAAsC;QAEtC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAEQ,GAAG,CAAC,GAAW;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5C,IAAI,QAAQ;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,aAAa,CAAC,MAAoB,EAAE,UAAmC;IAC9E,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO;SAC/B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,SAAS,SAAS,CAAC;SAC5E,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CACT,QAAQ,IAAI,CAAC,GAAG,kBAAkB,IAAI,CAAC,MAAM,gBAAgB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxF,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,GAAG,6BAA6B,EAAE,CAAC;YACnE,MAAM,CAAC,IAAI,CACT,QAAQ,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,MAAM,uBAAuB,SAAS,yDAAyD,CAC1H,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,IAAY;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAC5D,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,6BAA6B,OAAO,uBAAuB,qBAAqB,8BAA8B,CACtH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,sCAAsC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,GAAG,CAAC,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACpG,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY;IACrD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACnE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,OAAO;SACX,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CACnD;SACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB,EAAE,WAAmB;IAClE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,2CAA2C,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,GAA4B;IACpD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;IAC7C,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC;IAC9F,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,IAAwB;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/core/promote.d.ts

@@ -0,0 +1,41 @@
+import type { RecipeLogger } from './types.js';
+export interface PromoteFlowRequest {
+    /** Per-change recipe declaring the flow inline under `flows`. */
+    recipePath: string;
+    /** Flow ref to promote. */
+    flowRef: string;
+    /** Target library root; a library skeleton is created when missing. */
+    targetRoot: string;
+    /** Target library name, used when creating the skeleton and in messages. */
+    targetName: string;
+    /** Catalog file stem override; defaults to the ref minus its last segment. */
+    domain?: string;
+    /**
+     * Artifacts directory of a passing run that exercised the flow. Stamps
+     * `provenance.lastVerified` from its summary.json; without it the promoted
+     * flow carries no verification claim.
+     */
+    runArtifactsDir?: string;
+    /** Overwrite an existing declaration of the same ref in the target library. */
+    force?: boolean;
+    logger?: RecipeLogger;
+}
+export interface PromoteFlowResult {
+    ref: string;
+    /** Absolute catalog file path the flow was written to. */
+    catalogPath: string;
+    /** True when the library skeleton (library.json + flows/) was created. */
+    createdLibrary: boolean;
+    lastVerified?: string;
+}
+/**
+ * Promote an inline flow from a per-change recipe into a recipe library.
+ * Per ADR-style recipe semantics the recipe itself stays throwaway; promote is
+ * the explicit "keep" step that turns a proven setup flow into a durable,
+ * contract-checked library entry. Promotion enforces the flow-catalog
+ * contract: a description is required, `ensure_*` flows must declare a
+ * postcondition, and provenance (origin recipe, promotion date, optional
+ * last-verified evidence) is stamped onto the stored flow.
+ */
+export declare function promoteRecipeFlow(request: PromoteFlowRequest): Promise<PromoteFlowResult>;
+//# sourceMappingURL=promote.d.ts.map

package/dist/core/promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../src/core/promote.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmF/F"}

package/dist/core/promote.js

@@ -0,0 +1,249 @@
+import { mkdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { readCatalogFlows } from './flows.js';
+import { isRecord, readJsonFile, writeJsonFile } from './json.js';
+import { listFlowCatalogFiles } from './library.js';
+const LIBRARY_MANIFEST_FILE = 'library.json';
+const LIBRARY_FLOWS_DIR = 'flows';
+/**
+ * Promote an inline flow from a per-change recipe into a recipe library.
+ * Per ADR-style recipe semantics the recipe itself stays throwaway; promote is
+ * the explicit "keep" step that turns a proven setup flow into a durable,
+ * contract-checked library entry. Promotion enforces the flow-catalog
+ * contract: a description is required, `ensure_*` flows must declare a
+ * postcondition, and provenance (origin recipe, promotion date, optional
+ * last-verified evidence) is stamped onto the stored flow.
+ */
+export async function promoteRecipeFlow(request) {
+    const recipePath = path.resolve(request.recipePath);
+    const recipe = await readJsonFile(recipePath);
+    if (!isRecord(recipe))
+        throw new Error(`${request.recipePath} is not a recipe document.`);
+    const inlineFlows = isRecord(recipe.flows) ? recipe.flows : {};
+    const flow = inlineFlows[request.flowRef];
+    if (!isRecord(flow)) {
+        const available = Object.keys(inlineFlows);
+        throw new Error(`Flow ${request.flowRef} is not declared inline in ${request.recipePath}. Promote extracts inline flows from per-change recipes${available.length > 0 ? `; available: ${available.join(', ')}` : ''}.`);
+    }
+    assertPromotableFlow(request.flowRef, flow, request.logger);
+    const lastVerified = request.runArtifactsDir
+        ? await readVerifiedRunDate(request.runArtifactsDir, request.flowRef, flow)
+        : undefined;
+    const targetRoot = path.resolve(request.targetRoot);
+    const createdLibrary = await ensureLibrarySkeleton(targetRoot, request.targetName);
+    // The whole library is checked, not just the target catalog file: one
+    // library must never declare the same ref twice, or every later resolution
+    // of it fails. With --force the flow is overwritten in the file that
+    // already declares it, never written to a second one.
+    const declaringCatalogs = await findFlowDeclarations(targetRoot, request.flowRef);
+    if (declaringCatalogs.length > 1) {
+        // Pre-existing corruption: promote cannot pick which declaration is the
+        // stale one, and overwriting only one of them would leave the library
+        // unloadable. Fail loudly with every offending file, --force or not.
+        throw new Error(`Recipe library ${targetRoot} already declares ${request.flowRef} in ${declaringCatalogs.length} catalogs (${declaringCatalogs
+            .map((file) => path.basename(file))
+            .join(', ')}); the library cannot load until exactly one declaration remains. Remove the stale duplicate(s), then re-run promote.`);
+    }
+    const existingCatalogPath = declaringCatalogs[0];
+    if (existingCatalogPath && !request.force) {
+        throw new Error(`Flow ${request.flowRef} already exists in ${existingCatalogPath}. Edit the catalog directly or pass --force to overwrite it in place.`);
+    }
+    const stem = request.domain ?? domainStem(request.flowRef);
+    const catalogPath = existingCatalogPath ?? path.join(targetRoot, LIBRARY_FLOWS_DIR, `${stem}.flows.json`);
+    if (existingCatalogPath &&
+        request.domain &&
+        path.basename(existingCatalogPath) !== `${request.domain}.flows.json`) {
+        request.logger?.warn(`Flow ${request.flowRef} already lives in ${path.basename(existingCatalogPath)}; --domain ${request.domain} is ignored to avoid declaring the ref twice.`);
+    }
+    const catalog = await readCatalog(catalogPath);
+    const promoted = {
+        ...flow,
+        version: typeof flow.version === 'number' ? flow.version : 1,
+        provenance: {
+            promotedFrom: {
+                recipe: typeof recipe.title === 'string' ? recipe.title : path.basename(recipePath),
+            },
+            promotedAt: isoDate(new Date()),
+            ...(lastVerified ? { lastVerified: { date: lastVerified } } : {}),
+        },
+    };
+    catalog.flows = {
+        ...(isRecord(catalog.flows) ? catalog.flows : {}),
+        [request.flowRef]: promoted,
+    };
+    await writeJsonFile(catalogPath, catalog);
+    return {
+        ref: request.flowRef,
+        catalogPath,
+        createdLibrary,
+        ...(lastVerified ? { lastVerified } : {}),
+    };
+}
+function assertPromotableFlow(ref, flow, logger) {
+    // Reuse catalog normalization so promotion fails on the same shapes a
+    // library load would reject.
+    readCatalogFlows({ flows: { [ref]: flow } }, 'promote');
+    if (typeof flow.description !== 'string' || !flow.description.trim()) {
+        throw new Error(`Flow ${ref} needs a description before promotion — library flows are agent-facing contracts.`);
+    }
+    const localName = ref.split('.').at(-1) ?? ref;
+    if (localName.startsWith('ensure_') && flow.postcondition == null) {
+        throw new Error(`Flow ${ref} is an ensure_* flow and must declare a postcondition proving convergence before promotion.`);
+    }
+    if (flow.paramsSchema == null) {
+        logger?.warn(`Flow ${ref} has no paramsSchema; add one so agents can discover valid parameters.`);
+    }
+    if (flow.postcondition == null) {
+        logger?.warn(`Flow ${ref} has no postcondition; stale library flows fail loudly only when they assert their outcome.`);
+    }
+}
+async function readVerifiedRunDate(artifactsDir, flowRef, flow) {
+    const resolvedDir = path.resolve(artifactsDir);
+    const summaryPath = path.join(resolvedDir, 'summary.json');
+    const summary = await readJsonFile(summaryPath);
+    if (!isRecord(summary))
+        throw new Error(`${summaryPath} is not a run summary.`);
+    if (summary.status !== 'pass') {
+        throw new Error(`Run summary ${summaryPath} has status ${String(summary.status)}; only passing runs can stamp lastVerified.`);
+    }
+    const endedAt = typeof summary.endedAt === 'string' ? Date.parse(summary.endedAt) : Number.NaN;
+    if (Number.isNaN(endedAt)) {
+        throw new Error(`Run summary ${summaryPath} has no parseable endedAt; refusing to stamp lastVerified from incomplete evidence.`);
+    }
+    await assertRunExercisedFlow(resolvedDir, summary, flowRef, flow);
+    return isoDate(new Date(endedAt));
+}
+/**
+ * lastVerified is a claim reviewers rely on, so it must be backed by evidence
+ * the run actually executed this flow — a bare passing summary is not enough.
+ * Accepted evidence: the run resolved the ref from a library
+ * (summary.flowResolution.used), or the run's copied recipe declares exactly
+ * this flow inline and its trace shows a successful call to it.
+ * Honor-system limit: the developer owns both the artifacts and the catalog,
+ * so hand-forged artifacts can still pass — detecting that would need signed
+ * run evidence, which is out of scope.
+ */
+async function assertRunExercisedFlow(artifactsDir, summary, flowRef, flow) {
+    const flowResolution = summary.flowResolution;
+    if (isRecord(flowResolution) && Array.isArray(flowResolution.used)) {
+        if (flowResolution.used.some((entry) => isRecord(entry) && entry.ref === flowRef))
+            return;
+    }
+    let runRecipe;
+    try {
+        runRecipe = await readJsonFile(path.join(artifactsDir, 'recipe.json'));
+    }
+    catch {
+        throw evidenceError(flowRef, artifactsDir, 'the run artifacts have no readable recipe.json');
+    }
+    const runFlow = isRecord(runRecipe) && isRecord(runRecipe.flows) ? runRecipe.flows[flowRef] : undefined;
+    if (!isRecord(runFlow)) {
+        throw evidenceError(flowRef, artifactsDir, 'the run neither resolved the flow from a library nor declared it inline in its recipe');
+    }
+    if (!isDeepStrictEqual(runFlow, flow)) {
+        throw evidenceError(flowRef, artifactsDir, 'the run recipe declares a different definition of the flow than the one being promoted');
+    }
+    const callNodeIds = collectCallNodeIds(runRecipe, flowRef);
+    if (callNodeIds.size === 0) {
+        throw evidenceError(flowRef, artifactsDir, 'the run recipe never calls the flow');
+    }
+    const traceEntries = await readTraceEntries(artifactsDir);
+    const executed = traceEntries.some((entry) => isRecord(entry) &&
+        entry.ok === true &&
+        typeof entry.nodeId === 'string' &&
+        callNodeIds.has(entry.nodeId));
+    if (!executed) {
+        throw evidenceError(flowRef, artifactsDir, 'the run trace has no successful call to the flow');
+    }
+}
+function evidenceError(flowRef, artifactsDir, reason) {
+    return new Error(`Cannot stamp lastVerified for ${flowRef} from ${artifactsDir}: ${reason}. Pass artifacts of a run that exercised this flow, or promote without --run.`);
+}
+async function readTraceEntries(artifactsDir) {
+    let trace;
+    try {
+        trace = await readJsonFile(path.join(artifactsDir, 'trace.json'));
+    }
+    catch {
+        return [];
+    }
+    if (Array.isArray(trace))
+        return trace;
+    if (isRecord(trace) && Array.isArray(trace.entries))
+        return trace.entries;
+    return [];
+}
+/** Node ids of every `call` to the ref, anywhere a recipe can declare nodes. */
+function collectCallNodeIds(recipe, flowRef, out = new Set()) {
+    if (!isRecord(recipe))
+        return out;
+    if (isRecord(recipe.startState) &&
+        recipe.startState.action === 'call' &&
+        recipe.startState.ref === flowRef) {
+        out.add('startState');
+    }
+    for (const [key, child] of Object.entries(recipe)) {
+        if (key === 'nodes' && isRecord(child)) {
+            for (const [nodeId, node] of Object.entries(child)) {
+                if (isRecord(node) && node.action === 'call' && node.ref === flowRef)
+                    out.add(nodeId);
+            }
+        }
+        collectCallNodeIds(child, flowRef, out);
+    }
+    return out;
+}
+async function ensureLibrarySkeleton(targetRoot, name) {
+    const manifestPath = path.join(targetRoot, LIBRARY_MANIFEST_FILE);
+    let manifestText;
+    try {
+        manifestText = await readFile(manifestPath, 'utf-8');
+    }
+    catch {
+        manifestText = undefined;
+    }
+    if (manifestText === undefined) {
+        await mkdir(path.join(targetRoot, LIBRARY_FLOWS_DIR), { recursive: true });
+        await writeJsonFile(manifestPath, { kind: 'recipe-library', schema_version: 1, name });
+        return true;
+    }
+    const manifest = JSON.parse(manifestText);
+    if (!isRecord(manifest) || manifest.kind !== 'recipe-library') {
+        throw new Error(`${manifestPath} must declare kind "recipe-library".`);
+    }
+    await mkdir(path.join(targetRoot, LIBRARY_FLOWS_DIR), { recursive: true });
+    return false;
+}
+async function findFlowDeclarations(targetRoot, ref) {
+    const declarations = [];
+    for (const file of await listFlowCatalogFiles(targetRoot)) {
+        const catalogPath = path.join(targetRoot, LIBRARY_FLOWS_DIR, file);
+        const catalog = await readJsonFile(catalogPath);
+        if (isRecord(catalog) && isRecord(catalog.flows) && catalog.flows[ref] != null) {
+            declarations.push(catalogPath);
+        }
+    }
+    return declarations;
+}
+async function readCatalog(catalogPath) {
+    let catalog;
+    try {
+        catalog = await readJsonFile(catalogPath);
+    }
+    catch {
+        return { schema_version: 1, kind: 'recipe-flow-catalog', flows: {} };
+    }
+    if (!isRecord(catalog) || catalog.kind !== 'recipe-flow-catalog') {
+        throw new Error(`${catalogPath} must declare kind "recipe-flow-catalog".`);
+    }
+    return { ...catalog };
+}
+function domainStem(ref) {
+    const segments = ref.split('.').filter(Boolean);
+    return segments.length > 1 ? segments.slice(0, -1).join('.') : 'main';
+}
+function isoDate(date) {
+    return date.toISOString().slice(0, 10);
+}
+//# sourceMappingURL=promote.js.map

package/dist/core/promote.js.map

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

package/dist/core/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EACV,aAAa,EAEb,yBAAyB,EAKzB,YAAY,EAOb,MAAM,YAAY,CAAC;AAapB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAGzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,YAAY,CA+CnF"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EACV,aAAa,EAEb,yBAAyB,EAMzB,YAAY,EAOb,MAAM,YAAY,CAAC;AAapB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAGzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,YAAY,CA+CnF"}