@farmslot/recipe-cli 0.2.0 → 0.4.0

package/dist/harness/commands/launch.js

@@ -0,0 +1,105 @@
+// launch — start the app (dev server/build + surface), auto-ensure the runtime
+// overlay, and heal transport within bounds. Owns the launch grammar shared by
+// every platform (--heal, adapter resolution, the checkout lock) and the
+// --json-stream envelope; each platform's `launch` owns the rest.
+import fs from 'node:fs';
+import { adapterDetectNext, adapterFlags, adapterForPlatform, harnessAdapter, isPlatformTarget, undetectedAdapterMessage, } from '../adapters.js';
+import { acquireCheckoutLock } from '../checkout-lock.js';
+import { parseHeal } from '../heal-bounds.js';
+import { harnessHost } from '../host.js';
+import { JsonStreamWriter } from '../json-stream.js';
+import { checkoutBusyOut, EXIT, flag, parseFlags, resolveFlagsAdapter, str, targetOf, usageOut, } from '../shared.js';
+function launchBooleans() {
+    return new Set(['json', 'jsonStream', ...adapterFlags('launch')]);
+}
+export async function handleLaunch(argv) {
+    const { options } = parseFlags(argv, launchBooleans());
+    const json = flag(options, 'json');
+    const stream = new JsonStreamWriter('launch', flag(options, 'jsonStream'));
+    const jsonOutput = json && !stream.enabled;
+    const restoreStdout = stream.isolateStdout();
+    const target = targetOf(options);
+    try {
+        let exitCode;
+        if (!fs.existsSync(target)) {
+            exitCode = await handleLaunchLocked(argv, stream);
+        }
+        else {
+            const lock = acquireCheckoutLock(target, 'launch');
+            if ('message' in lock) {
+                const userAction = `wait for the current owner, or inspect ${lock.path} if its process has exited`;
+                stream.error({ code: 'SANDBOX_BUSY', message: lock.message, userAction });
+                exitCode = checkoutBusyOut(jsonOutput, 'launch', lock.message, lock.path);
+            }
+            else {
+                try {
+                    exitCode = await handleLaunchLocked(argv, stream);
+                }
+                finally {
+                    lock.release();
+                }
+            }
+        }
+        stream.complete(exitCode === EXIT.ok ? 'pass' : 'fail', exitCode);
+        return exitCode;
+    }
+    catch (error) {
+        const exitCode = error !== null &&
+            typeof error === 'object' &&
+            'exitCode' in error &&
+            typeof error.exitCode === 'number'
+            ? error.exitCode
+            : EXIT.runtime;
+        stream.error({
+            code: exitCode === EXIT.usage ? 'CLI_USAGE_ERROR' : 'LAUNCH_FAILED',
+            message: error instanceof Error ? error.message : String(error),
+            userAction: `${harnessHost().name} doctor --target ${quoteWord(target)} --json`,
+        });
+        stream.complete('fail', exitCode);
+        throw error;
+    }
+    finally {
+        restoreStdout();
+    }
+}
+async function handleLaunchLocked(argv, stream) {
+    const { positional, options } = parseFlags(argv, launchBooleans());
+    const json = flag(options, 'json');
+    const jsonOutput = json && !stream.enabled;
+    const machine = json || stream.enabled;
+    const target = targetOf(options);
+    const heal = parseHeal(options, 'auto');
+    if (typeof heal !== 'string')
+        return launchUsage(jsonOutput, stream, heal.error, 'use --heal off|infra-only|auto');
+    // A platform target (`launch ios`, or --platform ios) also selects its adapter.
+    const positionalTarget = isPlatformTarget(positional[0]) ? positional[0] : undefined;
+    const platformFlag = str(options, 'platform');
+    const platformTarget = positionalTarget ?? (isPlatformTarget(platformFlag) ? platformFlag : undefined);
+    const adapter = resolveFlagsAdapter(options, target, adapterForPlatform(platformTarget));
+    if (!adapter) {
+        return launchUsage(jsonOutput, stream, undetectedAdapterMessage(target), adapterDetectNext());
+    }
+    stream.phase('resolve', { target, adapter, platform: platformTarget ?? null });
+    return harnessAdapter(adapter).launch({
+        adapter,
+        target,
+        options,
+        platformTarget,
+        heal,
+        jsonOutput,
+        machine,
+        stream,
+        usage: (message, userAction) => launchUsage(jsonOutput, stream, message, userAction),
+    });
+}
+function launchUsage(json, stream, message, userAction) {
+    stream.error({ code: 'USAGE', message, userAction });
+    return usageOut(json, 'launch', message, userAction);
+}
+// Shell-quote one word for a launch `userAction`, leaving plain paths bare.
+function quoteWord(value) {
+    if (/^[A-Za-z0-9_./:@%+=,-]+$/u.test(value))
+        return value;
+    return `'${value.replace(/'/gu, "'\"'\"'")}'`;
+}
+//# sourceMappingURL=launch.js.map

package/dist/harness/commands/launch.js.map

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

package/dist/harness/commands/reload.d.ts

@@ -0,0 +1,2 @@
+export declare function handleReload(argv: string[]): Promise<number>;
+//# sourceMappingURL=reload.d.ts.map

package/dist/harness/commands/reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.d.ts","sourceRoot":"","sources":["../../../src/harness/commands/reload.ts"],"names":[],"mappings":"AAQA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlE"}

package/dist/harness/commands/reload.js

@@ -0,0 +1,24 @@
+// reload — reload the connected app runtime through the platform's `reload`.
+import { adapterDetectNext, harnessAdapter, undetectedAdapterMessage } from '../adapters.js';
+import { harnessHost } from '../host.js';
+import { flag, parseFlags, resolveFlagsAdapter, targetOf, usageOut } from '../shared.js';
+const RELOAD_BOOLEANS = new Set(['json']);
+export async function handleReload(argv) {
+    const { options } = parseFlags(argv, RELOAD_BOOLEANS);
+    const json = flag(options, 'json');
+    const target = targetOf(options);
+    const adapter = resolveFlagsAdapter(options, target);
+    if (!adapter) {
+        return usageOut(json, 'reload', undetectedAdapterMessage(target), adapterDetectNext());
+    }
+    const surface = harnessAdapter(adapter);
+    if (surface.headless) {
+        return usageOut(json, 'reload', `${adapter} is headless; there is no app runtime to reload.`, `${harnessHost().name} run <${adapter}-recipe>`);
+    }
+    if (!surface.reload) {
+        return usageOut(json, 'reload', `reload does not support the ${adapter} adapter.`, surface.hints.launch);
+    }
+    surface.resolveSlotPorts(target);
+    return surface.reload(target, json);
+}
+//# sourceMappingURL=reload.js.map

package/dist/harness/commands/reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../../src/harness/commands/reload.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEzF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,wBAAwB,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,QAAQ,CACb,IAAI,EACJ,QAAQ,EACR,GAAG,OAAO,kDAAkD,EAC5D,GAAG,WAAW,EAAE,CAAC,IAAI,SAAS,OAAO,UAAU,CAChD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,QAAQ,CACb,IAAI,EACJ,QAAQ,EACR,+BAA+B,OAAO,WAAW,EACjD,OAAO,CAAC,KAAK,CAAC,MAAM,CACrB,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/harness/commands/stop.d.ts

@@ -0,0 +1,9 @@
+export interface StoppedCompanion {
+    label: string;
+    pid: number;
+}
+export interface StopCommandOptions {
+    companions?(target: string): Promise<StoppedCompanion[]>;
+}
+export declare function handleStop(argv: string[], commandOptions?: StopCommandOptions): Promise<number>;
+//# sourceMappingURL=stop.d.ts.map

package/dist/harness/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/harness/commands/stop.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,gBAAgB;IAE/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IAGjC,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CAC1D;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,EACd,cAAc,GAAE,kBAAuB,GACtC,OAAO,CAAC,MAAM,CAAC,CAwDjB"}

package/dist/harness/commands/stop.js

@@ -0,0 +1,60 @@
+// stop — stop the dev server this checkout owns, through the platform's
+// `devServer`, plus any companion processes the host started for it.
+import { adapterPortEnv, harnessAdapter } from '../adapters.js';
+import { color } from '../cli-color.js';
+import { harnessHost } from '../host.js';
+import { optionFlag, optionString, parseArgs, resolveAdapter, shellQuote } from '../parse-args.js';
+import { usageOut } from '../shared.js';
+export async function handleStop(argv, commandOptions = {}) {
+    const { options } = parseArgs(argv);
+    const json = optionFlag(options, 'json');
+    const { adapter, target } = resolveAdapter(options);
+    const surface = harnessAdapter(adapter);
+    surface.resolveSlotPorts(target);
+    const explicitPort = optionString(options, 'port') ?? optionString(options, 'watcherPort');
+    if (explicitPort) {
+        process.env.WATCHER_PORT = explicitPort;
+        for (const name of adapterPortEnv())
+            process.env[name] = explicitPort;
+    }
+    const stop = surface.devServer.stop(target);
+    if (stop.kind === 'headless') {
+        return usageOut(json, 'stop', stop.message, stop.userAction);
+    }
+    const companions = (await commandOptions.companions?.(target)) ?? [];
+    const signalled = (stop.signalled ?? 0) + companions.length;
+    const summary = [
+        stop.summary,
+        ...companions.map((companion) => `stopped ${companion.label} ${companion.pid}`),
+    ].join('; ');
+    // A platform whose dev server serves several targets has no one truthful
+    // relaunch, so the hint is optional.
+    const next = surface.devServer.afterStop?.(target);
+    const userAction = `${harnessHost().name} status --target ${shellQuote(target)} --json`;
+    if (json) {
+        console.log(JSON.stringify({
+            schemaVersion: 1,
+            command: 'stop',
+            adapter,
+            target,
+            status: stop.status === 0 ? 'pass' : 'fail',
+            ...(stop.signalled !== undefined || companions.length > 0 ? { signalled } : {}),
+            exitCode: stop.status,
+            ...(stop.output ? { output: stop.output } : {}),
+            ...(stop.status === 0
+                ? next
+                    ? { next }
+                    : {}
+                : { error: { code: 'DEV_SERVER_STOP_FAILED', message: summary, userAction } }),
+        }, null, 2));
+    }
+    else {
+        if (stop.output)
+            process.stderr.write(`${stop.output}\n`);
+        console.error(`${color(stop.status === 0 ? 'ok' : 'err', stop.status === 0 ? '✓' : '✗')} ${summary}`);
+        if (stop.status !== 0 || next)
+            console.error(`  Next: ${stop.status === 0 ? next : userAction}`);
+    }
+    return stop.status;
+}
+//# sourceMappingURL=stop.js.map

package/dist/harness/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../src/harness/commands/stop.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,qEAAqE;AAErE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAcxC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAc,EACd,iBAAqC,EAAE;IAEvC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC3F,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;IACxE,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,MAAM,cAAc,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IAC5D,MAAM,OAAO,GAAG;QACd,IAAI,CAAC,OAAO;QACZ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC;KAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,yEAAyE;IACzE,qCAAqC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,GAAG,WAAW,EAAE,CAAC,IAAI,oBAAoB,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC;IACxF,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;YACE,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,MAAM;YACf,OAAO;YACP,MAAM;YACN,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC3C,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBACnB,CAAC,CAAC,IAAI;oBACJ,CAAC,CAAC,EAAE,IAAI,EAAE;oBACV,CAAC,CAAC,EAAE;gBACN,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC;SACjF,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CACX,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CACvF,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI;YAC3B,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC"}

package/dist/harness/execution-provenance.d.ts

@@ -0,0 +1,56 @@
+import type { RecipeLibrarySource } from '@farmslot/recipe-runner';
+export type ExecutionProvenancePhase = 'start' | 'pre-execute' | 'end';
+export interface SourceProvenanceSnapshot {
+    head: string | null;
+    status: string;
+    sourceFingerprint: string;
+}
+export interface ExecutionProvenanceSnapshot {
+    phase: ExecutionProvenancePhase;
+    capturedAt: string;
+    recipeDigest: string;
+    product: SourceProvenanceSnapshot;
+    runner: SourceProvenanceSnapshot;
+    libraries: Array<SourceProvenanceSnapshot & {
+        name: string;
+    }>;
+    helpers: Array<{
+        path: string;
+        sourceFingerprint: string;
+    }>;
+}
+export interface ExecutionProvenanceDrift {
+    phase: Exclude<ExecutionProvenancePhase, 'start'>;
+    field: string;
+    start: string | null;
+    current: string | null;
+}
+export interface ExecutionProvenanceRecord {
+    schemaVersion: 1;
+    valid: boolean;
+    snapshots: ExecutionProvenanceSnapshot[];
+    drift: ExecutionProvenanceDrift[];
+}
+export interface ExecutionProvenanceInput {
+    adapter: string;
+    projectRoot: string;
+    recipeDocument: unknown;
+    recipePath?: string;
+    librarySources?: RecipeLibrarySource[];
+    excludedProductRoots?: string[];
+    helperPaths?: string[];
+    runnerRoot?: string;
+    runnerIncludes: readonly string[];
+}
+export declare class ProvenanceDriftError extends Error {
+    readonly code = "PROVENANCE_DRIFT";
+    readonly exitCode = 5;
+    readonly userAction: string;
+    readonly provenancePath: string;
+    readonly drift: ExecutionProvenanceDrift[];
+    constructor(provenancePath: string, drift: ExecutionProvenanceDrift[], cause?: unknown);
+}
+export declare function captureExecutionProvenance(input: ExecutionProvenanceInput, phase: ExecutionProvenancePhase): Promise<ExecutionProvenanceSnapshot>;
+export declare function executionProvenanceDrift(start: ExecutionProvenanceSnapshot, current: ExecutionProvenanceSnapshot): ExecutionProvenanceDrift[];
+export declare function writeExecutionProvenance(artifactsDir: string, snapshots: ExecutionProvenanceSnapshot[], drift: ExecutionProvenanceDrift[], artifactManifestPath?: string): Promise<string>;
+//# sourceMappingURL=execution-provenance.d.ts.map

package/dist/harness/execution-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-provenance.d.ts","sourceRoot":"","sources":["../../src/harness/execution-provenance.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAQnE,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,aAAa,GAAG,KAAK,CAAC;AAEvE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,wBAAwB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,wBAAwB,CAAC;IAClC,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE,KAAK,CAAC,wBAAwB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,QAAQ,KAAK;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,EAAE,CAAC;gBAE/B,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO;CAWvF;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,wBAAwB,EAC/B,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,2BAA2B,CAAC,CAqBtC;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,2BAA2B,EAClC,OAAO,EAAE,2BAA2B,GACnC,wBAAwB,EAAE,CAmD5B;AAED,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,2BAA2B,EAAE,EACxC,KAAK,EAAE,wBAAwB,EAAE,EACjC,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,MAAM,CAAC,CA2BjB"}

package/dist/harness/execution-provenance.js

@@ -0,0 +1,308 @@
+// What a run executed, bound at its start and compared before and after it
+// runs: the recipe, the product checkout, the runner (the host package), the
+// recipe libraries and any command helper scripts. Drift invalidates the run.
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import fs, { constants as fsConstants } from 'node:fs';
+import path from 'node:path';
+import { digestRecipeDocument } from '@farmslot/protocol';
+import { harnessAdapter } from './adapters.js';
+import { indexArtifactManifest } from './artifact-files.js';
+import { harnessHost } from './host.js';
+const gitContexts = new Map();
+export class ProvenanceDriftError extends Error {
+    constructor(provenancePath, drift, cause) {
+        const fields = [...new Set(drift.map((entry) => entry.field))].join(', ');
+        super(`Execution inputs changed after preparation (${fields}); evidence is invalid.`, cause === undefined ? undefined : { cause });
+        this.code = 'PROVENANCE_DRIFT';
+        this.exitCode = 5;
+        this.name = 'ProvenanceDriftError';
+        this.provenancePath = provenancePath;
+        this.drift = drift;
+        this.userAction = `restore the prepared recipe, library, and product source, then rerun; inspect ${provenancePath}`;
+    }
+}
+export async function captureExecutionProvenance(input, phase) {
+    const recipeDigest = input.recipePath
+        ? recipeFileDigest(input.recipePath)
+        : digestRecipeDocument(input.recipeDocument);
+    const libraries = (input.librarySources ?? []).map((source, index) => ({
+        name: source.name ?? `library-${index + 1}`,
+        ...sourceSnapshot(source.root),
+    }));
+    const runnerRoot = input.runnerRoot ?? harnessHost().packageRoot;
+    return {
+        phase,
+        capturedAt: new Date().toISOString(),
+        recipeDigest,
+        product: sourceSnapshot(input.projectRoot, input.adapter, input.excludedProductRoots),
+        runner: sourceSnapshot(runnerRoot, undefined, [], [...input.runnerIncludes]),
+        libraries,
+        helpers: (input.helperPaths ?? []).map((helperPath) => ({
+            path: displayPath(input.projectRoot, helperPath),
+            sourceFingerprint: fileFingerprint(helperPath),
+        })),
+    };
+}
+export function executionProvenanceDrift(start, current) {
+    const drift = [];
+    if (current.phase === 'start')
+        return drift;
+    const phase = current.phase;
+    compare(drift, phase, 'recipeDigest', start.recipeDigest, current.recipeDigest);
+    compareSource(drift, phase, 'product', start.product, current.product);
+    compareSource(drift, phase, 'runner', start.runner, current.runner);
+    if (start.libraries.length !== current.libraries.length) {
+        compare(drift, phase, 'libraries.length', String(start.libraries.length), String(current.libraries.length));
+    }
+    const count = Math.min(start.libraries.length, current.libraries.length);
+    for (let index = 0; index < count; index += 1) {
+        const expected = start.libraries[index];
+        const actual = current.libraries[index];
+        const prefix = `libraries[${index}]`;
+        compare(drift, phase, `${prefix}.name`, expected.name, actual.name);
+        compareSource(drift, phase, prefix, expected, actual);
+    }
+    if (start.helpers.length !== current.helpers.length) {
+        compare(drift, phase, 'helpers.length', String(start.helpers.length), String(current.helpers.length));
+    }
+    const helperCount = Math.min(start.helpers.length, current.helpers.length);
+    for (let index = 0; index < helperCount; index += 1) {
+        compare(drift, phase, `helpers[${index}].path`, start.helpers[index].path, current.helpers[index].path);
+        compare(drift, phase, `helpers[${index}].sourceFingerprint`, start.helpers[index].sourceFingerprint, current.helpers[index].sourceFingerprint);
+    }
+    return drift;
+}
+export async function writeExecutionProvenance(artifactsDir, snapshots, drift, artifactManifestPath) {
+    const provenancePath = path.join(path.resolve(artifactsDir), 'execution-provenance.json');
+    const record = {
+        schemaVersion: 1,
+        valid: drift.length === 0,
+        snapshots,
+        drift,
+    };
+    fs.mkdirSync(path.dirname(provenancePath), { recursive: true });
+    fs.writeFileSync(provenancePath, `${JSON.stringify(record, null, 2)}\n`);
+    if (artifactManifestPath) {
+        // The one manifest upsert the harness has; a missing or unreadable
+        // manifest is the caller's error, not something to skip past.
+        await indexArtifactManifest(artifactManifestPath, [
+            {
+                path: 'execution-provenance.json',
+                type: 'json',
+                label: 'Execution provenance',
+                category: 'system',
+                metadata: {
+                    valid: record.valid,
+                    errorCode: record.valid ? null : 'PROVENANCE_DRIFT',
+                },
+            },
+        ]);
+    }
+    return provenancePath;
+}
+function recipeFileDigest(recipePath) {
+    const source = readRegularFileNoFollow(recipePath);
+    try {
+        return digestRecipeDocument(JSON.parse(source.toString('utf8')));
+    }
+    catch {
+        return `invalid:sha256:${createHash('sha256').update(source).digest('hex')}`;
+    }
+}
+function sourceSnapshot(root, adapter, excludedRoots = [], includedRoots = []) {
+    const git = gitContext(root);
+    if (!git) {
+        return {
+            head: null,
+            status: 'not-a-git-checkout',
+            sourceFingerprint: directoryFingerprint(root, excludedRoots, includedRoots),
+        };
+    }
+    const pathspecs = sourcePathspecs(git, excludedRoots, includedRoots);
+    const status = gitText(git.topLevel, [
+        'status',
+        '--porcelain=v1',
+        '--untracked-files=normal',
+        '--',
+        ...pathspecs,
+    ]);
+    const head = gitBuffer(git.topLevel, ['rev-parse', 'HEAD']);
+    const platformFingerprint = adapter ? harnessAdapter(adapter).sourceFingerprint : undefined;
+    return {
+        head: head.toString('utf8').trim() || null,
+        status,
+        sourceFingerprint: platformFingerprint && path.resolve(root) === git.topLevel
+            ? platformFingerprint(root)
+            : nestedGitSourceFingerprint(root, git, pathspecs, excludedRoots, includedRoots, head),
+    };
+}
+function nestedGitSourceFingerprint(root, git, pathspecs, excludedRoots, includedRoots, head) {
+    const gitFingerprint = gitSourceFingerprint(git.topLevel, pathspecs, head);
+    if (git.pathspec === '.' && includedRoots.length === 0)
+        return gitFingerprint;
+    return createHash('sha256')
+        .update(gitFingerprint)
+        .update('\0nested-source\0')
+        .update(directoryFingerprint(root, excludedRoots, includedRoots))
+        .digest('hex');
+}
+function gitContext(root) {
+    const cacheKey = path.resolve(root);
+    if (gitContexts.has(cacheKey))
+        return gitContexts.get(cacheKey) ?? null;
+    try {
+        const resolved = cacheKey;
+        const topLevel = fs.realpathSync(gitText(resolved, ['rev-parse', '--show-toplevel']).trim());
+        const relative = path.relative(topLevel, fs.realpathSync(resolved));
+        const context = relative === '..' || relative.startsWith(`..${path.sep}`)
+            ? null
+            : { topLevel, pathspec: relative || '.' };
+        gitContexts.set(cacheKey, context);
+        return context;
+    }
+    catch {
+        gitContexts.set(cacheKey, null);
+        return null;
+    }
+}
+function gitSourceFingerprint(topLevel, pathspecs, head) {
+    const hash = createHash('sha256');
+    hash.update(head);
+    hash.update('\0diff\0');
+    hash.update(gitBuffer(topLevel, [
+        'diff',
+        '--no-ext-diff',
+        '--binary',
+        head.toString('utf8').trim(),
+        '--',
+        ...pathspecs,
+    ]));
+    const untracked = gitText(topLevel, [
+        'ls-files',
+        '--others',
+        '--exclude-standard',
+        '-z',
+        '--',
+        ...pathspecs,
+    ])
+        .split('\0')
+        .filter(Boolean)
+        .sort();
+    for (const relative of untracked) {
+        hash.update(`\0untracked\0${relative}\0`);
+        const absolute = path.join(topLevel, relative);
+        hash.update(readPathIdentity(absolute));
+    }
+    return hash.digest('hex');
+}
+function sourcePathspecs(git, excludedRoots, includedRoots) {
+    const exclusions = excludedRoots.flatMap((root) => {
+        const relative = path.relative(git.topLevel, fs.existsSync(root) ? fs.realpathSync(root) : path.resolve(root));
+        return relative !== '..' && !relative.startsWith(`..${path.sep}`)
+            ? [`:(exclude)${relative}`]
+            : [];
+    });
+    const inclusions = includedRoots.length > 0
+        ? includedRoots.map((root) => path.join(git.pathspec === '.' ? '' : git.pathspec, root))
+        : [git.pathspec];
+    return [...inclusions, ...exclusions];
+}
+function directoryFingerprint(root, excludedRoots, includedRoots) {
+    const hash = createHash('sha256');
+    const resolvedRoot = path.resolve(root);
+    const roots = includedRoots.length > 0 ? includedRoots : [''];
+    for (const included of roots) {
+        hashDirectory(hash, resolvedRoot, included, new Set(excludedRoots.map((entry) => path.resolve(entry))));
+    }
+    return hash.digest('hex');
+}
+function hashDirectory(hash, root, relative, excludedRoots) {
+    const absolute = path.join(root, relative);
+    if ([...excludedRoots].some((excluded) => absolute === excluded || absolute.startsWith(`${excluded}${path.sep}`)))
+        return;
+    let stat;
+    try {
+        stat = fs.lstatSync(absolute);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            hash.update(`absent\0${relative}\0`);
+            return;
+        }
+        throw error;
+    }
+    if (stat.isDirectory()) {
+        hash.update(`directory\0${relative}\0`);
+        for (const name of fs.readdirSync(absolute).sort()) {
+            if (relative === '' && (name === '.git' || name === 'node_modules' || name === 'temp'))
+                continue;
+            hashDirectory(hash, root, path.join(relative, name), excludedRoots);
+        }
+        return;
+    }
+    if (stat.isSymbolicLink()) {
+        throw new Error(`Execution provenance source must not be a symbolic link: ${absolute}`);
+    }
+    hash.update(`file\0${relative}\0`);
+    hash.update(readRegularFileNoFollow(absolute));
+    hash.update('\0');
+}
+function fileFingerprint(filePath) {
+    return createHash('sha256').update(readRegularFileNoFollow(filePath)).digest('hex');
+}
+function readPathIdentity(filePath) {
+    const stat = fs.lstatSync(filePath);
+    if (stat.isSymbolicLink()) {
+        throw new Error(`Execution provenance source must not be a symbolic link: ${filePath}`);
+    }
+    return readRegularFileNoFollow(filePath);
+}
+function readRegularFileNoFollow(filePath) {
+    let fd;
+    try {
+        fd = fs.openSync(filePath, fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW);
+    }
+    catch (error) {
+        if (error.code === 'ELOOP') {
+            throw new Error(`Execution provenance source must not be a symbolic link: ${filePath}`);
+        }
+        throw error;
+    }
+    try {
+        if (!fs.fstatSync(fd).isFile()) {
+            throw new Error(`Execution provenance source is not a regular file: ${filePath}`);
+        }
+        return fs.readFileSync(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+function displayPath(projectRoot, filePath) {
+    const relative = path.relative(path.resolve(projectRoot), path.resolve(filePath));
+    return relative !== '..' && !relative.startsWith(`..${path.sep}`)
+        ? relative || '.'
+        : path.resolve(filePath);
+}
+function gitText(cwd, args) {
+    return gitBuffer(cwd, args).toString('utf8');
+}
+function gitBuffer(cwd, args) {
+    return execFileSync('git', args, {
+        cwd,
+        encoding: 'buffer',
+        maxBuffer: 128 * 1024 * 1024,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+}
+function compareSource(drift, phase, prefix, start, current) {
+    compare(drift, phase, `${prefix}.head`, start.head, current.head);
+    compare(drift, phase, `${prefix}.status`, start.status, current.status);
+    compare(drift, phase, `${prefix}.sourceFingerprint`, start.sourceFingerprint, current.sourceFingerprint);
+}
+function compare(drift, phase, field, start, current) {
+    if (start !== current)
+        drift.push({ phase, field, start, current });
+}
+//# sourceMappingURL=execution-provenance.js.map

package/dist/harness/execution-provenance.js.map

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

package/dist/harness/heal-bounds.d.ts

@@ -0,0 +1,15 @@
+import type { HealBoundViolation, HealPolicy, HealState } from '@farmslot/adapter-sdk';
+export declare function newHealState(): HealState;
+export declare function conciseFailureForHuman(output: string): string;
+export declare function parseHeal(options: Record<string, string | boolean>, fallback: HealPolicy): HealPolicy | {
+    error: string;
+};
+export declare function ensureOverlay(adapter: string, target: string, heal: HealPolicy, state: HealState, json: boolean): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export type FailureClass = 'capture-protected' | 'wallet' | 'infra' | 'app';
+export declare function classifyFailure(output: string): FailureClass;
+export declare function recipeRunning(target: string): boolean;
+export declare function checkHealBounds(target: string, output: string, state: HealState): HealBoundViolation | null;
+//# sourceMappingURL=heal-bounds.d.ts.map