@farmslot/recipe-harness 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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/*`:

package/README.md

@@ -64,6 +64,7 @@ listed here.
 | `@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.           |
@@ -84,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/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.3.0",
+  "version": "0.3.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -82,6 +82,11 @@
       "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": {