@farmslot/recipe-harness 0.2.2 → 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to `@farmslot/recipe-harness` are tracked here.
+
+## Unreleased
+
+_No entries yet. Add Added/Changed/Fixed/Removed bullets here with each PR; date and version only at publish._
+
+## 0.3.1 - 2026-06-26
+
+- Add `runtime/orchestrate-up` — generic install → relaunch decision loop (`orchestrateRuntimeUp`) for product runners to wrap with shell/platform actions.
+
+## 0.3.0 - 2026-06-26
+
+- Add shared runtime-readiness helpers under `@farmslot/recipe-harness/runtime/*`:
+  - `deps-readiness` — install fingerprint, baseline recording, product-marker partial checks, decision state persistence
+  - `log-analysis` — Metro/RN bundle log boundaries, unresolved-module scoping, persistent bundle-error detection
+  - `metro-probe` — packager `/status` reachability probe
+  - `decision-types` — portable `RuntimeDecisionReport` / `RuntimeDecisionAction` shapes
+- Product runners (e.g. MetaMask) should import these modules instead of copying readiness logic locally.
+
+## 0.2.2 - 2026-06-10
+
+- Publish with npm-resolvable `@farmslot/protocol` dependency metadata instead of workspace-only protocol references.
+
+## 0.2.1 - 2026-06-10
+
+- Drive CDP text inputs with trusted keyboard insertion instead of direct DOM value assignment so React-controlled inputs receive real input/change handling.
+- Drive CDP clicks with real mouse events and expose `ui.key_press` through the standard UI adapter.
+
+## 0.2.0 - 2026-06-02
+
+- Define the v0 public harness package surface with explicit core, adapter, node, CLI, and runtime entry points.
+- Publish recipe runner runtime helpers under explicit `runtime/*` subpaths for browser extension, CDP, and React Native bridge clients.
+- Keep CLI and writer implementation details behind explicit subpath exports instead of wildcard package exports.
+
+## 0.1.0 - 2026-05-31
+
+- Initial public active-development release.

package/README.md

@@ -39,7 +39,7 @@ npm install @farmslot/recipe-harness @farmslot/protocol
 | `src/index.ts`  | Public package export surface.                                                                            |
 | `src/core/`     | Manifest-aware recipe graph execution, flow calls, predicates, HUD node shaping, and harness-local types. |
 | `src/adapters/` | Standard core and UI adapter factories.                                                                   |
-| `src/runtime/`  | Runtime transports for CDP, browser extensions, and React Native bridge connections.                      |
+| `src/runtime/`  | Runtime transports (CDP, browser extensions, RN bridge) and shared readiness helpers (deps, log analysis, Metro probe). |
 | `src/node/`     | Node-only artifact, trace, and summary writers.                                                           |
 | `src/cli/`      | CLI entrypoint, commands, and shared CLI validation helpers.                                              |
 | `test/`         | Harness package and export-boundary tests mirroring public behavior.                                      |
@@ -60,6 +60,11 @@ listed here.
 | `@farmslot/recipe-harness/runtime/cdp`                 | CDP browser transport helpers.             |
 | `@farmslot/recipe-harness/runtime/react-native-bridge` | React Native bridge transport helpers.     |
 | `@farmslot/recipe-harness/runtime/browser-extension`   | Browser-extension target helpers.          |
+| `@farmslot/recipe-harness/runtime/deps-readiness`      | Install fingerprint, baseline, product-marker partial checks. |
+| `@farmslot/recipe-harness/runtime/log-analysis`        | Bundle-log boundaries, unresolved-module scoping, persistent bundle-error state. |
+| `@farmslot/recipe-harness/runtime/metro-probe`         | Metro packager `/status` reachability probe. |
+| `@farmslot/recipe-harness/runtime/decision-types`      | Portable `RuntimeDecisionReport` / action shapes for product adapters. |
+| `@farmslot/recipe-harness/runtime/orchestrate-up`      | Generic install → relaunch orchestration loop for `recipe up` hosts. |
 | `@farmslot/recipe-harness/cli`                         | Programmatic CLI entrypoint.               |
 | `@farmslot/recipe-harness/cli/support`                 | Shared CLI input validation helpers.       |
 | `@farmslot/recipe-harness/writers`                     | Node-only JSON artifact writers.           |
@@ -68,6 +73,7 @@ listed here.
 
 The harness owns generic execution mechanics:
 
+- runtime-readiness primitives (`runtime/deps-readiness`, `runtime/log-analysis`, `runtime/metro-probe`) — product runners supply adapter-specific markers, log patterns, and shell launch;
 - manifest-aware runner construction;
 - graph execution, `call` flow composition, setup/start-state/proof/teardown ordering;
 - standard core adapters such as `command`, `wait`, `assert_json`, `watch_logs`, and `end`;
@@ -79,6 +85,12 @@ Project-specific behavior stays outside this package. For example,
 `example.trade.place_order`, `checkout.ensure_cart`, or `backend.seed_user`
 belong in the project runner that imports this package.
 
+## Changelog
+
+Update [CHANGELOG.md](./CHANGELOG.md) under `## Unreleased` in the same PR as code changes
+(Added / Changed / Fixed / Removed). Add a dated version section only when publishing
+(`yarn npm publish` — `prepack` checks changelog readiness).
+
 ## Minimal runner
 
 ```ts

package/dist/runtime/decision-types.d.ts

@@ -0,0 +1,23 @@
+import type { DepsCheck } from './deps-readiness.js';
+/** Stable id a host branches on when executing `actions[]`. */
+export interface RuntimeDecisionAction {
+    id: string;
+    argv?: string[];
+    cwd?: string;
+    paths?: string[];
+}
+export type RuntimeReadinessDecision = 'install' | 'build' | 'launch' | 'relaunch' | 'ready' | 'blocked' | 'unknown';
+export interface RuntimeDecisionReport<TChecks extends Record<string, unknown> = Record<string, unknown>> {
+    schemaVersion: 1;
+    adapter: string;
+    target: string;
+    decision: RuntimeReadinessDecision;
+    reasonCode: string;
+    reasons: string[];
+    checks: TChecks;
+    actions: RuntimeDecisionAction[];
+    /** Extension-only: build must clear webpack cache first. */
+    clean?: boolean;
+}
+export type { DepsCheck };
+//# sourceMappingURL=decision-types.d.ts.map

package/dist/runtime/decision-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-types.d.ts","sourceRoot":"","sources":["../../src/runtime/decision-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,OAAO,GACP,QAAQ,GACR,UAAU,GACV,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,qBAAqB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtG,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,wBAAwB,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/runtime/decision-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decision-types.js.map

package/dist/runtime/decision-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-types.js","sourceRoot":"","sources":["../../src/runtime/decision-types.ts"],"names":[],"mappings":""}

package/dist/runtime/deps-readiness.d.ts

@@ -0,0 +1,20 @@
+/** Lock/manifest inputs hashed for the deps baseline. */
+export declare const DEPS_INPUTS: string[];
+/** Yarn install-state markers. */
+export declare const INSTALL_MARKERS: string[];
+export interface DepsCheck {
+    installed: boolean;
+    status: 'current' | 'stale' | 'missing' | 'partial';
+    hasBaseline: boolean;
+    missingProducts?: string[];
+}
+export declare function depsFingerprint(target: string, extraInputs?: string[]): string;
+/** Record the current deps fingerprint as the install baseline (OS temp dir). */
+export declare function recordDepsBaseline(target: string): void;
+export declare function readDecisionState(target: string, name: string): Record<string, unknown> | null;
+export declare function writeDecisionState(target: string, name: string, value: Record<string, unknown>): void;
+export declare function clearDecisionState(target: string, name: string): void;
+export declare function depsCheck(target: string, options?: {
+    productMarkers?: string[];
+}): DepsCheck;
+//# sourceMappingURL=deps-readiness.d.ts.map

package/dist/runtime/deps-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps-readiness.d.ts","sourceRoot":"","sources":["../../src/runtime/deps-readiness.ts"],"names":[],"mappings":"AAKA,yDAAyD;AACzD,eAAO,MAAM,WAAW,UAAiE,CAAC;AAE1F,kCAAkC;AAClC,eAAO,MAAM,eAAe,UAA6D,CAAC;AAE1F,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAgCD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,MAAM,CAWlF;AAMD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE9F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAErG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAMrE;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC1C,SAAS,CAwBX"}

package/dist/runtime/deps-readiness.js

@@ -0,0 +1,93 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+/** Lock/manifest inputs hashed for the deps baseline. */
+export const DEPS_INPUTS = ['package.json', 'yarn.lock', '.yarnrc.yml', '.tool-versions'];
+/** Yarn install-state markers. */
+export const INSTALL_MARKERS = ['node_modules/.yarn-state.yml', '.yarn/install-state.gz'];
+const STATE_NAMESPACE = 'farmslot-recipe-runtime-decision';
+function stateDir(target) {
+    const key = crypto.createHash('sha1').update(path.resolve(target)).digest('hex').slice(0, 16);
+    return path.join(os.tmpdir(), STATE_NAMESPACE, key);
+}
+function readBaseline(target, name) {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(stateDir(target), name), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeBaseline(target, name, value) {
+    const dir = stateDir(target);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, name), `${JSON.stringify(value, null, 2)}\n`);
+}
+function newestMtime(target, rels) {
+    let newest = 0;
+    for (const rel of rels) {
+        const abs = path.join(target, rel);
+        if (fs.existsSync(abs))
+            newest = Math.max(newest, fs.statSync(abs).mtimeMs);
+    }
+    return newest;
+}
+export function depsFingerprint(target, extraInputs = []) {
+    const hash = crypto.createHash('sha256');
+    for (const rel of [...DEPS_INPUTS, ...extraInputs]) {
+        const abs = path.join(target, rel);
+        if (!fs.existsSync(abs))
+            continue;
+        hash.update(rel);
+        hash.update('\0');
+        hash.update(fs.readFileSync(abs));
+        hash.update('\0');
+    }
+    return hash.digest('hex');
+}
+function missingProductMarkers(target, markers) {
+    return markers.filter((rel) => !fs.existsSync(path.join(target, rel)));
+}
+/** Record the current deps fingerprint as the install baseline (OS temp dir). */
+export function recordDepsBaseline(target) {
+    writeBaseline(target, 'deps-state.json', { fingerprint: depsFingerprint(target) });
+}
+export function readDecisionState(target, name) {
+    return readBaseline(target, name);
+}
+export function writeDecisionState(target, name, value) {
+    writeBaseline(target, name, value);
+}
+export function clearDecisionState(target, name) {
+    try {
+        fs.unlinkSync(path.join(stateDir(target), name));
+    }
+    catch {
+        // no prior state
+    }
+}
+export function depsCheck(target, options = {}) {
+    const productMarkers = options.productMarkers ?? [];
+    const inputs = DEPS_INPUTS.filter((rel) => fs.existsSync(path.join(target, rel)));
+    const installed = inputs.length > 0 && INSTALL_MARKERS.some((rel) => fs.existsSync(path.join(target, rel)));
+    if (!installed)
+        return { installed: false, status: 'missing', hasBaseline: false };
+    const missingProducts = missingProductMarkers(target, productMarkers);
+    if (missingProducts.length > 0) {
+        return {
+            installed: true,
+            status: 'partial',
+            hasBaseline: false,
+            missingProducts,
+        };
+    }
+    const baseline = readBaseline(target, 'deps-state.json');
+    if (!baseline) {
+        const drift = newestMtime(target, inputs) > newestMtime(target, INSTALL_MARKERS);
+        return { installed: true, status: drift ? 'stale' : 'current', hasBaseline: false };
+    }
+    const status = baseline.fingerprint === depsFingerprint(target) ? 'current' : 'stale';
+    return { installed: true, status, hasBaseline: true };
+}
+//# sourceMappingURL=deps-readiness.js.map

package/dist/runtime/deps-readiness.js.map

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

package/dist/runtime/log-analysis.d.ts

@@ -0,0 +1,42 @@
+export declare function packageRootsForModule(target: string, moduleName: string): string[];
+/** True when the resolved package root contains package.json (ignores empty dirs). */
+export declare function moduleExistsInNodeModules(target: string, moduleName: string): boolean;
+export declare function unresolvedModulesFromLogSlice(lines: string[], startIndex?: number): string[];
+export declare function bundleErrorExcerptHash(excerpt: string): string;
+export interface LogBoundaryScan {
+    lastErr: number;
+    lastOk: number;
+}
+export declare function scanLogBoundaries(lines: string[], options: {
+    errorPattern: RegExp;
+    okPattern: RegExp;
+}): LogBoundaryScan;
+/**
+ * Return the last capture group from `errorPattern` when the error is not
+ * superseded by a later `okPattern` line (e.g. stale native-module errors).
+ */
+export declare function supersededErrorCapture(logText: string, options: {
+    errorPattern: RegExp;
+    okPattern: RegExp;
+}): string | null;
+export interface BundleLogAnalysis {
+    status: 'ok' | 'errors' | 'bundling' | 'no-log';
+    reason?: 'bundle-error' | 'unresolved-module' | 'stale-bundle-error';
+    excerpt?: string;
+    unresolvedModules?: string[];
+}
+export interface AnalyzeBundleLogOptions {
+    target: string;
+    logText: string;
+    errorPattern: RegExp;
+    okPattern: RegExp;
+    bundlingPattern?: RegExp;
+}
+export declare function analyzeBundleLog(options: AnalyzeBundleLogOptions): BundleLogAnalysis;
+export interface PersistentBundleErrorDecision {
+    blocked: boolean;
+    excerptHash: string;
+}
+/** Block when the same bundle-error excerpt was already recorded for this target. */
+export declare function evaluatePersistentBundleError(target: string, excerpt: string, stateFile?: string): PersistentBundleErrorDecision;
+//# sourceMappingURL=log-analysis.d.ts.map

package/dist/runtime/log-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-analysis.d.ts","sourceRoot":"","sources":["../../src/runtime/log-analysis.ts"],"names":[],"mappings":"AAMA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAOlF;AAED,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAMrF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,SAAI,GAAG,MAAM,EAAE,CAOvF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnD,eAAe,CAQjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,GAAG,IAAI,CASf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAChD,MAAM,CAAC,EAAE,cAAc,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,iBAAiB,CA+BpF;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qFAAqF;AACrF,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,SAA4B,GACpC,6BAA6B,CAQ/B"}

package/dist/runtime/log-analysis.js

@@ -0,0 +1,104 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { readDecisionState, writeDecisionState } from './deps-readiness.js';
+export function packageRootsForModule(target, moduleName) {
+    if (moduleName.startsWith('@')) {
+        const parts = moduleName.split('/');
+        if (parts.length >= 2)
+            return [path.join(target, 'node_modules', parts[0], parts[1])];
+        return [path.join(target, 'node_modules', parts[0])];
+    }
+    return [path.join(target, 'node_modules', moduleName.split('/')[0])];
+}
+/** True when the resolved package root contains package.json (ignores empty dirs). */
+export function moduleExistsInNodeModules(target, moduleName) {
+    for (const pkgRoot of packageRootsForModule(target, moduleName)) {
+        if (!fs.existsSync(pkgRoot))
+            continue;
+        if (fs.existsSync(path.join(pkgRoot, 'package.json')))
+            return true;
+    }
+    return false;
+}
+export function unresolvedModulesFromLogSlice(lines, startIndex = 0) {
+    const found = new Set();
+    for (let i = Math.max(0, startIndex); i < lines.length; i += 1) {
+        const match = /Unable to resolve "([^"]+)"/u.exec(lines[i]);
+        if (match)
+            found.add(match[1]);
+    }
+    return [...found];
+}
+export function bundleErrorExcerptHash(excerpt) {
+    return crypto.createHash('sha256').update(excerpt).digest('hex').slice(0, 16);
+}
+export function scanLogBoundaries(lines, options) {
+    let lastErr = -1;
+    let lastOk = -1;
+    for (let i = 0; i < lines.length; i += 1) {
+        if (options.errorPattern.test(lines[i]))
+            lastErr = i;
+        if (options.okPattern.test(lines[i]))
+            lastOk = i;
+    }
+    return { lastErr, lastOk };
+}
+/**
+ * Return the last capture group from `errorPattern` when the error is not
+ * superseded by a later `okPattern` line (e.g. stale native-module errors).
+ */
+export function supersededErrorCapture(logText, options) {
+    const lines = logText.split('\n');
+    const { lastErr, lastOk } = scanLogBoundaries(lines, options);
+    if (lastOk >= 0 && lastOk > lastErr)
+        return null;
+    for (let i = lines.length - 1; i >= 0; i -= 1) {
+        const match = options.errorPattern.exec(lines[i]);
+        if (match?.[1])
+            return match[1];
+    }
+    return null;
+}
+export function analyzeBundleLog(options) {
+    const lines = options.logText.split('\n');
+    const { lastErr, lastOk } = scanLogBoundaries(lines, {
+        errorPattern: options.errorPattern,
+        okPattern: options.okPattern,
+    });
+    const sliceStart = lastOk >= 0 ? lastOk + 1 : 0;
+    const unresolved = unresolvedModulesFromLogSlice(lines, sliceStart).filter((name) => !moduleExistsInNodeModules(options.target, name));
+    if (unresolved.length > 0 && lastErr > lastOk) {
+        return {
+            status: 'errors',
+            reason: 'unresolved-module',
+            excerpt: `Missing node_modules entries: ${unresolved.slice(0, 3).join(', ')}`,
+            unresolvedModules: unresolved,
+        };
+    }
+    if (lastErr > lastOk) {
+        const excerpt = lines.slice(lastErr, lastErr + 3).join(' | ').slice(0, 400);
+        const cited = unresolvedModulesFromLogSlice(lines, sliceStart);
+        const stillMissing = cited.filter((name) => !moduleExistsInNodeModules(options.target, name));
+        if (cited.length > 0 && stillMissing.length === 0) {
+            return { status: 'errors', reason: 'stale-bundle-error', excerpt, unresolvedModules: cited };
+        }
+        return { status: 'errors', reason: 'bundle-error', excerpt };
+    }
+    if (lastOk >= 0)
+        return { status: 'ok' };
+    const bundlingPattern = options.bundlingPattern ?? /Bundling|index\.(js|tsx?).*%/u;
+    const bundling = lines.some((line) => bundlingPattern.test(line));
+    return bundling ? { status: 'bundling' } : { status: 'no-log' };
+}
+/** Block when the same bundle-error excerpt was already recorded for this target. */
+export function evaluatePersistentBundleError(target, excerpt, stateFile = 'bundle-error-state.json') {
+    const excerptHash = bundleErrorExcerptHash(excerpt);
+    const prev = readDecisionState(target, stateFile);
+    if (prev?.excerptHash === excerptHash) {
+        return { blocked: true, excerptHash };
+    }
+    writeDecisionState(target, stateFile, { excerptHash, recordedAt: Date.now() });
+    return { blocked: false, excerptHash };
+}
+//# sourceMappingURL=log-analysis.js.map

package/dist/runtime/log-analysis.js.map

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

package/dist/runtime/metro-probe.d.ts

@@ -0,0 +1,5 @@
+export interface MetroReachabilityCheck {
+    status: 'up' | 'down' | 'skipped';
+}
+export declare function probeMetroPackager(port: number, timeoutMs?: number): Promise<MetroReachabilityCheck>;
+//# sourceMappingURL=metro-probe.d.ts.map

package/dist/runtime/metro-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metro-probe.d.ts","sourceRoot":"","sources":["../../src/runtime/metro-probe.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAmBlG"}

package/dist/runtime/metro-probe.js

@@ -0,0 +1,22 @@
+import http from 'node:http';
+export function probeMetroPackager(port, timeoutMs = 1500) {
+    return new Promise((resolve) => {
+        const req = http.get(`http://localhost:${port}/status`, { timeout: timeoutMs }, (res) => {
+            let body = '';
+            res.on('data', (chunk) => {
+                body += chunk;
+            });
+            res.on('end', () => {
+                const up = res.statusCode !== undefined && res.statusCode >= 200 && res.statusCode < 300
+                    && /packager-status:running/u.test(body);
+                resolve({ status: up ? 'up' : 'down' });
+            });
+        });
+        req.on('timeout', () => {
+            req.destroy();
+            resolve({ status: 'down' });
+        });
+        req.on('error', () => resolve({ status: 'down' }));
+    });
+}
+//# sourceMappingURL=metro-probe.js.map

package/dist/runtime/metro-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metro-probe.js","sourceRoot":"","sources":["../../src/runtime/metro-probe.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,SAAS,GAAG,IAAI;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;YACtF,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBACvB,IAAI,IAAI,KAAK,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG;uBACnF,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACrB,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime/orchestrate-up.d.ts

@@ -0,0 +1,22 @@
+import type { RuntimeDecisionReport, RuntimeReadinessDecision } from './decision-types.js';
+export interface OrchestrateRuntimeUpOptions<T extends RuntimeDecisionReport = RuntimeDecisionReport> {
+    decide: () => Promise<T>;
+    onInstall: (report: T) => Promise<void>;
+    onLaunch: (report: T) => Promise<void>;
+    onReady: (report: T) => Promise<void>;
+    onBlocked?: (report: T) => Promise<void>;
+    /** Shared flag — set true after first install attempt to prevent loops. */
+    installAttempted?: {
+        value: boolean;
+    };
+}
+export interface OrchestrateRuntimeUpResult<T extends RuntimeDecisionReport = RuntimeDecisionReport> {
+    report: T;
+    exitDecision: RuntimeReadinessDecision;
+}
+/**
+ * Generic install → relaunch decision loop for product runners.
+ * Hosts supply shell/platform actions via onInstall/onLaunch/onReady callbacks.
+ */
+export declare function orchestrateRuntimeUp<T extends RuntimeDecisionReport>(options: OrchestrateRuntimeUpOptions<T>): Promise<OrchestrateRuntimeUpResult<T>>;
+//# sourceMappingURL=orchestrate-up.d.ts.map

package/dist/runtime/orchestrate-up.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate-up.d.ts","sourceRoot":"","sources":["../../src/runtime/orchestrate-up.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE3F,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,qBAAqB,GAAG,qBAAqB;IAClG,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,qBAAqB,GAAG,qBAAqB;IACjG,MAAM,EAAE,CAAC,CAAC;IACV,YAAY,EAAE,wBAAwB,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,SAAS,qBAAqB,EACxE,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CA4BxC"}

package/dist/runtime/orchestrate-up.js

@@ -0,0 +1,35 @@
+/**
+ * Generic install → relaunch decision loop for product runners.
+ * Hosts supply shell/platform actions via onInstall/onLaunch/onReady callbacks.
+ */
+export async function orchestrateRuntimeUp(options) {
+    const installFlag = options.installAttempted ?? { value: false };
+    const report = await options.decide();
+    switch (report.decision) {
+        case 'install': {
+            if (installFlag.value) {
+                throw new Error(`install did not resolve runtime (${report.reasonCode})`);
+            }
+            installFlag.value = true;
+            await options.onInstall(report);
+            return orchestrateRuntimeUp({ ...options, installAttempted: installFlag });
+        }
+        case 'launch':
+        case 'relaunch':
+        case 'build':
+            await options.onLaunch(report);
+            return { report, exitDecision: report.decision };
+        case 'ready':
+            await options.onReady(report);
+            return { report, exitDecision: 'ready' };
+        case 'blocked':
+            if (options.onBlocked)
+                await options.onBlocked(report);
+            return { report, exitDecision: 'blocked' };
+        default:
+            if (options.onBlocked)
+                await options.onBlocked(report);
+            return { report, exitDecision: report.decision };
+    }
+}
+//# sourceMappingURL=orchestrate-up.js.map

package/dist/runtime/orchestrate-up.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate-up.js","sourceRoot":"","sources":["../../src/runtime/orchestrate-up.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAuC;IAEvC,MAAM,WAAW,GAAG,OAAO,CAAC,gBAAgB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;IAEtC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;YAC5E,CAAC;YACD,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;YACzB,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,oBAAoB,CAAC,EAAE,GAAG,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO;YACV,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnD,KAAK,OAAO;YACV,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;QAC3C,KAAK,SAAS;YACZ,IAAI,OAAO,CAAC,SAAS;gBAAE,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACvD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;QAC7C;YACE,IAAI,OAAO,CAAC,SAAS;gBAAE,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACvD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACrD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/recipe-harness",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -62,6 +62,31 @@
       "types": "./dist/runtime/react-native-bridge.d.ts",
       "import": "./dist/runtime/react-native-bridge.js",
       "default": "./dist/runtime/react-native-bridge.js"
+    },
+    "./runtime/deps-readiness": {
+      "types": "./dist/runtime/deps-readiness.d.ts",
+      "import": "./dist/runtime/deps-readiness.js",
+      "default": "./dist/runtime/deps-readiness.js"
+    },
+    "./runtime/log-analysis": {
+      "types": "./dist/runtime/log-analysis.d.ts",
+      "import": "./dist/runtime/log-analysis.js",
+      "default": "./dist/runtime/log-analysis.js"
+    },
+    "./runtime/metro-probe": {
+      "types": "./dist/runtime/metro-probe.d.ts",
+      "import": "./dist/runtime/metro-probe.js",
+      "default": "./dist/runtime/metro-probe.js"
+    },
+    "./runtime/decision-types": {
+      "types": "./dist/runtime/decision-types.d.ts",
+      "import": "./dist/runtime/decision-types.js",
+      "default": "./dist/runtime/decision-types.js"
+    },
+    "./runtime/orchestrate-up": {
+      "types": "./dist/runtime/orchestrate-up.d.ts",
+      "import": "./dist/runtime/orchestrate-up.js",
+      "default": "./dist/runtime/orchestrate-up.js"
     }
   },
   "scripts": {
@@ -118,4 +143,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}