@farmslot/recipe-cli 0.2.0 → 0.3.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":"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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

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

@@ -0,0 +1 @@
+{"version":3,"file":"heal-bounds.d.ts","sourceRoot":"","sources":["../../src/harness/heal-bounds.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,kBAAkB,EAClB,UAAU,EACV,SAAS,EACV,MAAM,uBAAuB,CAAC;AAQ/B,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACzC,QAAQ,EAAE,UAAU,GACnB,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAKhC;AAoCD,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6B1C;AAUD,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAM5D;AAwBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGrD;AAKD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,GACf,kBAAkB,GAAG,IAAI,CAyD3B"}

package/dist/harness/heal-bounds.js

@@ -0,0 +1,194 @@
+// Healing policy + recovery bounds — shared by launch, run, and call (policy, not
+// per-command). Owns: overlay auto-ensure, failure classification, the recovery
+// bounds that stop blind retry loops, and the --heal parser.
+//
+// Overlay auto-ensure seam (overridable for CI/agents and contract tests):
+//   <envPrefix>_INSTALL_BIN — overlay installer (default: handleHarness install)
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { assertAdaptersRegistered, harnessAdapter, harnessAdapters } from './adapters.js';
+import { harnessHost, hostEnvName } from './host.js';
+import { handleHarness } from './overlay.js';
+import { recipeHarnessPath, recipeRuntimePath } from './paths.js';
+import { EXIT } from './shared.js';
+export function newHealState() {
+    return { recovered: [], mutations: [], attemptedRecoveries: [] };
+}
+export function conciseFailureForHuman(output) {
+    const errors = output
+        .split(/\r?\n/u)
+        .map((line) => /^(?:[A-Za-z]*Error):\s*(.+)$/u.exec(line.trim())?.[1])
+        .filter((line) => Boolean(line));
+    return errors.at(-1) ?? output.trim();
+}
+export function parseHeal(options, fallback) {
+    const value = options.heal;
+    if (value === undefined)
+        return fallback;
+    if (value === 'off' || value === 'infra-only' || value === 'auto')
+        return value;
+    return { error: `--heal must be off, infra-only, or auto (got "${String(value)}").` };
+}
+function overlayDir(target, adapter) {
+    return recipeHarnessPath(target, adapter);
+}
+function overlayPresent(target, adapter) {
+    try {
+        return fs.statSync(overlayDir(target, adapter)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+// Validates that the installed overlay's runner-source stamp points to an existing
+// runner directory whose binary is still present. Two failure modes are detected:
+//   1. Stale stamp — runner dir moved or renamed since install (dir absent).
+//   2. Stale exec target — runner dir exists but the host bin was removed
+//      (e.g. the package was unlinked/purged inside an otherwise-live dir).
+// Either way the delegate binary will fail to exec; treat the overlay as absent
+// so auto-ensure re-installs it from the current runner.
+function overlayDelegateValid(target, adapter) {
+    if (harnessAdapter(adapter).headless)
+        return true;
+    const pointer = path.join(recipeHarnessPath(target, adapter), 'runner', '.runner-source');
+    if (!fs.existsSync(pointer))
+        return true; // no stamp = running from local runner, valid
+    const runnerPath = fs.readFileSync(pointer, 'utf8').trim();
+    if (!runnerPath || !fs.existsSync(runnerPath))
+        return false;
+    // Runner dir is present; verify the binary inside still exists — the directory
+    // can survive a package removal while the binary inside is deleted.
+    return fs.existsSync(path.join(runnerPath, harnessHost().bin));
+}
+// Auto-ensure the runtime overlay (install phase). Missing + heal != off →
+// install inline, emit a first-install notice to stderr, and record the mutation.
+// heal === off disables auto-install (repro-preserving); we proceed and let the
+// porcelain surface any missing-overlay failure itself.
+export async function ensureOverlay(adapter, target, heal, state, json) {
+    // A headless platform (core) needs no launch overlay for run/call.
+    if (harnessAdapter(adapter).headless)
+        return { ok: true };
+    if (overlayPresent(target, adapter) && overlayDelegateValid(target, adapter))
+        return { ok: true };
+    if (heal === 'off')
+        return { ok: true };
+    const installBin = process.env[hostEnvName('INSTALL_BIN')];
+    let code;
+    if (installBin) {
+        const result = spawnSync(installBin, ['install', '--platform', adapter, '--target', target], {
+            cwd: target,
+            stdio: ['ignore', 2, 'inherit'],
+            env: process.env,
+        });
+        code = result.status ?? 1;
+    }
+    else {
+        // Auto-install is an internal phase of the parent command. Keep the nested
+        // installer silent so human output has one progress owner and machine
+        // output remains one JSON document; the parent records the mutation below.
+        code = await handleHarness(['install', '--platform', adapter, '--target', target, '--quiet']);
+    }
+    if (code !== 0 || !overlayPresent(target, adapter)) {
+        return { ok: false, error: `runtime overlay install failed (exit ${code})` };
+    }
+    const dir = overlayDir(target, adapter);
+    state.mutations.push({ type: 'file', action: 'created', path: dir });
+    // First-install notice → stderr (human) / mutations[] only (json; stdout clean).
+    if (!json)
+        process.stderr.write(`installed ${harnessHost().name} overlay → ${dir}\n`);
+    return { ok: true };
+}
+export function classifyFailure(output) {
+    if (captureProtection(output))
+        return 'capture-protected';
+    if (matchesAny('transportFirst', output))
+        return 'infra';
+    if (matchesAny('walletState', output))
+        return 'wallet';
+    if (matchesAny('transport', output))
+        return 'infra';
+    return 'app';
+}
+function adapterPatterns() {
+    // With no adapters every failure would read as app logic and never heal.
+    assertAdaptersRegistered();
+    const registry = harnessAdapters();
+    return registry.list().flatMap((id) => {
+        const patterns = registry.get(id).failurePatterns;
+        return patterns ? [patterns] : [];
+    });
+}
+function matchesAny(kind, output) {
+    return adapterPatterns().some((patterns) => patterns[kind]?.test(output) ?? false);
+}
+function captureProtection(output) {
+    return adapterPatterns()
+        .map((patterns) => patterns.captureProtected)
+        .find((entry) => entry?.pattern.test(output));
+}
+// Refuse ALL recovery while a recipe is executing (mid-run recovery would corrupt
+// state). Signalled by a lock file or <envPrefix>_RECIPE_RUNNING=1.
+export function recipeRunning(target) {
+    if (process.env[hostEnvName('RECIPE_RUNNING')] === '1')
+        return true;
+    return fs.existsSync(recipeRuntimePath(target, 'recipe.lock'));
+}
+// Returns null (ok to proceed) or a violation descriptor when a bound is hit.
+// Using null instead of { ok: true } keeps the return typeof-narrowable without
+// relying on discriminated-union narrowing (avoids strict-mode tsconfig issues).
+export function checkHealBounds(target, output, state) {
+    // Carry the original failure output verbatim on every violation so the caller
+    // can surface it (--json + human) alongside the classification note.
+    const originalError = output.trim() || undefined;
+    if (recipeRunning(target)) {
+        return {
+            code: 'RECIPE_RUNNING',
+            exitCode: EXIT.bounded,
+            message: 'a recipe is currently running — refusing recovery to avoid corrupting mid-run state.',
+            originalError,
+        };
+    }
+    const concise = conciseFailureForHuman(output);
+    const failureClass = classifyFailure(concise);
+    const protectedCapture = failureClass === 'capture-protected' ? captureProtection(concise) : undefined;
+    if (protectedCapture) {
+        return {
+            code: 'SCREENSHOT_PROTECTED',
+            exitCode: EXIT.runtime,
+            message: protectedCapture.message,
+            userAction: protectedCapture.userAction,
+            originalError,
+        };
+    }
+    if (failureClass === 'wallet') {
+        return {
+            code: 'WALLET_STATE_REQUIRED',
+            exitCode: EXIT.bounded,
+            message: 'wallet prerequisites need attention; healing never changes wallet state.',
+            userAction: /(?:^|\n)\s*Next:\s*([^\r\n]+)/u.exec(output)?.[1] ??
+                `run ${harnessHost().name} doctor --json`,
+            originalError,
+        };
+    }
+    if (failureClass === 'app') {
+        return {
+            code: 'APP_LOGIC_FAILURE',
+            exitCode: EXIT.runtime,
+            message: 'failure looks like app-logic — healing cannot help; surface verbatim.',
+            originalError,
+        };
+    }
+    if (state.attemptedRecoveries.length > 0) {
+        return {
+            code: 'SAME_RECOVERY_TWICE',
+            exitCode: EXIT.bounded,
+            message: state.recovered.length > 0
+                ? 'one recovery already succeeded this invocation — bounded policy refuses a second recovery.'
+                : 'one recovery was already attempted this invocation — refusing to loop.',
+            originalError,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=heal-bounds.js.map

package/dist/harness/heal-bounds.js.map

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

package/dist/harness/host.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Who is running the generic harness commands. A product harness (`mm-harness`)
+ * configures this once at startup, so every message and environment variable
+ * keeps that product's spelling; `farmslot-recipe` uses the defaults. Runtime
+ * paths are not per host: every host shares the checkout layout in paths.ts.
+ */
+export interface HarnessHost {
+    /** The bin name used in messages and `Next:` lines. */
+    name: string;
+    /** What a checkout belongs to, in "could not detect the <product> repo type". */
+    product: string;
+    /** Prefix of the host's own environment variables: `<envPrefix>_OPERATION_ID`. */
+    envPrefix: string;
+    /** The npm package that ships the bin. */
+    packageName: string;
+    /** The installed package root. */
+    packageRoot: string;
+    /** The host executable, relative to `packageRoot`. */
+    bin: string;
+    /** Commands the resumability journal records. */
+    journaledCommands: readonly string[];
+}
+/** A host's identity; it journals nothing unless it lists commands. */
+export type HarnessHostConfig = Omit<HarnessHost, 'journaledCommands'> & {
+    journaledCommands?: readonly string[];
+};
+/**
+ * Set the host identity. Call once, before any command runs. Every identity
+ * field is required, so a host can't silently inherit farmslot-recipe's names.
+ */
+export declare function configureHarnessHost(host: HarnessHostConfig): HarnessHost;
+export declare function harnessHost(): HarnessHost;
+/** The host-owned environment variable `<envPrefix>_<suffix>`. */
+export declare function hostEnvName(suffix: string): string;
+/** Throws unless `value` is a non-empty, safe, checkout-relative path. */
+export declare function validateRelativeRecipePath(name: string, value: string): string;
+//# sourceMappingURL=host.d.ts.map

package/dist/harness/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/harness/host.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAeD,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,GAAG;IACvE,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,WAAW,CAOzE;AAED,wBAAgB,WAAW,IAAI,WAAW,CAEzC;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAa9E"}

package/dist/harness/host.js

@@ -0,0 +1,48 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const defaultHost = {
+    name: 'farmslot-recipe',
+    product: 'project',
+    envPrefix: 'FARMSLOT_RECIPE',
+    packageName: '@farmslot/recipe-cli',
+    packageRoot: fileURLToPath(new URL('../..', import.meta.url)),
+    bin: 'bin/farmslot-recipe.mjs',
+    // farmslot-recipe journals nothing yet; a host lists the commands it journals.
+    journaledCommands: [],
+};
+let current = defaultHost;
+/**
+ * Set the host identity. Call once, before any command runs. Every identity
+ * field is required, so a host can't silently inherit farmslot-recipe's names.
+ */
+export function configureHarnessHost(host) {
+    const next = { ...host, journaledCommands: host.journaledCommands ?? [] };
+    if (!/^[A-Z][A-Z0-9_]*$/u.test(next.envPrefix)) {
+        throw new Error(`envPrefix must be an upper-case identifier: ${next.envPrefix}`);
+    }
+    current = next;
+    return current;
+}
+export function harnessHost() {
+    return current;
+}
+/** The host-owned environment variable `<envPrefix>_<suffix>`. */
+export function hostEnvName(suffix) {
+    return `${current.envPrefix}_${suffix}`;
+}
+/** Throws unless `value` is a non-empty, safe, checkout-relative path. */
+export function validateRelativeRecipePath(name, value) {
+    if (!value || path.isAbsolute(value)) {
+        throw new Error(`${name} must be a non-empty relative path: ${value}`);
+    }
+    if (!/^[A-Za-z0-9._/-]+$/u.test(value)) {
+        throw new Error(`${name} contains unsupported characters: ${value}`);
+    }
+    for (const part of value.split('/')) {
+        if (!part || part === '.' || part === '..') {
+            throw new Error(`${name} contains unsafe path component: ${value}`);
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=host.js.map

package/dist/harness/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/harness/host.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAyBzC,MAAM,WAAW,GAAgB;IAC/B,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,iBAAiB;IAC5B,WAAW,EAAE,sBAAsB;IACnC,WAAW,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,GAAG,EAAE,yBAAyB;IAC9B,+EAA+E;IAC/E,iBAAiB,EAAE,EAAE;CACtB,CAAC;AAEF,IAAI,OAAO,GAAgB,WAAW,CAAC;AAOvC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,MAAM,IAAI,GAAgB,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;IACvF,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,GAAG,IAAI,CAAC;IACf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,KAAa;IACpE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uCAAuC,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qCAAqC,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oCAAoC,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/harness/index.d.ts

@@ -0,0 +1,19 @@
+export { adapterDetectNext, adapterFlags, adapterForPlatform, assertAdapter, configureHarnessAdapters, detectAdapter, harnessAdapter, harnessAdapters, isPlatformTarget, undetectedAdapterMessage, } from './adapters.js';
+export { type ArtifactManifestEntry, indexArtifactManifest, readContainedJsonArtifact, writeContainedArtifact, } from './artifact-files.js';
+export { acquireCheckoutLock, type CheckoutLock, type CheckoutLockFailure, trackCheckoutChild, } from './checkout-lock.js';
+export { classifyLogEvent, color, colorEnabled, colorHumanMessage, colorKv, colorLogEvent, colorStatusWord, stripAnsi, } from './cli-color.js';
+export { COMMAND_JOURNAL_FILE, commandJournalPath, type CommandJournalRecord, isSensitiveKey, readCommandJournal, recordCommandEvidence, recordCommandOutput, recordCommandStage, redactCommandArgs, redactStructuredValue, withCommandJournal, } from './command-journal.js';
+export { handleLast } from './commands/last.js';
+export { handleLaunch } from './commands/launch.js';
+export { handleReload } from './commands/reload.js';
+export { handleStop, type StopCommandOptions, type StoppedCompanion } from './commands/stop.js';
+export { checkHealBounds, classifyFailure, conciseFailureForHuman, ensureOverlay, type FailureClass, newHealState, parseHeal, recipeRunning, } from './heal-bounds.js';
+export { configureHarnessHost, type HarnessHost, harnessHost, type HarnessHostConfig, hostEnvName, validateRelativeRecipePath, } from './host.js';
+export { JsonStreamWriter } from './json-stream.js';
+export { leafStartFailureMessage, missingShellLeafMessage, resolveLeafInvoke, shellLeafMissing, } from './leaf-invoke.js';
+export { gitLibraryProvenance } from './library-provenance.js';
+export { argValue, handleHarness, type HarnessAction, hasArg, type OverlayCommandOptions, type OverlayInstallContext, readRuntimeContextField, resolveRuntimeContextPath, } from './overlay.js';
+export { actionManifestPathOption, adapterOption, applyRuntimeDirOption, applyWatcherPortOption, CliError, type CliOptions, type CliOptionValue, isRecord, optionFlag, optionString, optionStrings, parseArgs, type ParseArgsOptions, type ParsedArgs, parsePort, parseRecipeParamAssignments, requiredOption, resolveAdapter, shellQuote, shellQuoteArg, targetPath, usageError, } from './parse-args.js';
+export { DEFAULT_RECIPE_HARNESS_ROOT, DEFAULT_RECIPE_RUNTIME_DIR, harnessExecutable, recipeHarnessPath, recipeHarnessRoot, recipeRuntimeDir, recipeRuntimePath, } from './paths.js';
+export { checkoutBusyOut, EXIT, flag, type ParsedFlags, parseFlags, resolveFlagsAdapter, scriptOverride, type ScriptResult, spawnInherit, spawnScript, spawnScriptStreaming, str, type StreamingSpawnOptions, targetOf, usageOut, writeInteractiveProgress, } from './shared.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/index.d.ts.map

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

package/dist/harness/index.js

@@ -0,0 +1,22 @@
+// Generic harness support shared by every host CLI (`farmslot-recipe`, product
+// presets such as `mm-harness`): host identity, runtime paths, the resumability
+// journal, the checkout lock, JSON streaming and colour output.
+export { adapterDetectNext, adapterFlags, adapterForPlatform, assertAdapter, configureHarnessAdapters, detectAdapter, harnessAdapter, harnessAdapters, isPlatformTarget, undetectedAdapterMessage, } from './adapters.js';
+export { indexArtifactManifest, readContainedJsonArtifact, writeContainedArtifact, } from './artifact-files.js';
+export { acquireCheckoutLock, trackCheckoutChild, } from './checkout-lock.js';
+export { classifyLogEvent, color, colorEnabled, colorHumanMessage, colorKv, colorLogEvent, colorStatusWord, stripAnsi, } from './cli-color.js';
+export { COMMAND_JOURNAL_FILE, commandJournalPath, isSensitiveKey, readCommandJournal, recordCommandEvidence, recordCommandOutput, recordCommandStage, redactCommandArgs, redactStructuredValue, withCommandJournal, } from './command-journal.js';
+export { handleLast } from './commands/last.js';
+export { handleLaunch } from './commands/launch.js';
+export { handleReload } from './commands/reload.js';
+export { handleStop } from './commands/stop.js';
+export { checkHealBounds, classifyFailure, conciseFailureForHuman, ensureOverlay, newHealState, parseHeal, recipeRunning, } from './heal-bounds.js';
+export { configureHarnessHost, harnessHost, hostEnvName, validateRelativeRecipePath, } from './host.js';
+export { JsonStreamWriter } from './json-stream.js';
+export { leafStartFailureMessage, missingShellLeafMessage, resolveLeafInvoke, shellLeafMissing, } from './leaf-invoke.js';
+export { gitLibraryProvenance } from './library-provenance.js';
+export { argValue, handleHarness, hasArg, readRuntimeContextField, resolveRuntimeContextPath, } from './overlay.js';
+export { actionManifestPathOption, adapterOption, applyRuntimeDirOption, applyWatcherPortOption, CliError, isRecord, optionFlag, optionString, optionStrings, parseArgs, parsePort, parseRecipeParamAssignments, requiredOption, resolveAdapter, shellQuote, shellQuoteArg, targetPath, usageError, } from './parse-args.js';
+export { DEFAULT_RECIPE_HARNESS_ROOT, DEFAULT_RECIPE_RUNTIME_DIR, harnessExecutable, recipeHarnessPath, recipeHarnessRoot, recipeRuntimeDir, recipeRuntimePath, } from './paths.js';
+export { checkoutBusyOut, EXIT, flag, parseFlags, resolveFlagsAdapter, scriptOverride, spawnInherit, spawnScript, spawnScriptStreaming, str, targetOf, usageOut, writeInteractiveProgress, } from './shared.js';
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,gEAAgE;AAChE,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EAGnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,iBAAiB,EACjB,OAAO,EACP,aAAa,EACb,eAAe,EACf,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAElB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkD,MAAM,oBAAoB,CAAC;AAChG,OAAO,EACL,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,aAAa,EAEb,YAAY,EACZ,SAAS,EACT,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EAEpB,WAAW,EAEX,WAAW,EACX,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,QAAQ,EACR,aAAa,EAEb,MAAM,EAGN,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,QAAQ,EAGR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EAGT,SAAS,EACT,2BAA2B,EAC3B,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,IAAI,EACJ,IAAI,EAEJ,UAAU,EACV,mBAAmB,EACnB,cAAc,EAEd,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,GAAG,EAEH,QAAQ,EACR,QAAQ,EACR,wBAAwB,GACzB,MAAM,aAAa,CAAC"}