@farmslot/recipe-harness 0.3.3 → 0.4.0

package/CHANGELOG.md

@@ -6,6 +6,10 @@ All notable changes to `@farmslot/recipe-harness` are tracked here.
 
 - Active-development baseline; add user-facing changes here before release or package publication.
 
+## 0.4.0 - 2026-07-07
+
+- Add a standard outer `app.lifecycle` adapter for Android and iOS simulator launch/foreground/terminate/restart lifecycle control, with Android background support for performance recipes. Exported as `@farmslot/recipe-harness/adapters/app-lifecycle`.
+
 ## 0.3.3 - 2026-07-03
 
 - `resolved-flows.json` is emitted whenever a run had any library resolution activity (used, overridden, or shadowed flows) — previously a run that overrode every library flow with recipe-local declarations produced no artifact even though `summary.json` recorded the overrides

package/dist/adapters/app-lifecycle.d.ts

@@ -0,0 +1,41 @@
+import type { ActionAdapter, ActionExecutionContext } from '../core/types.js';
+export type AppLifecyclePlatform = 'android' | 'ios-simulator';
+export type AppLifecycleCommand = 'launch' | 'foreground' | 'background' | 'terminate' | 'restart';
+export interface AppLifecycleTarget {
+    platform: AppLifecyclePlatform;
+    /** Android adb serial or iOS simulator UDID/name. */
+    deviceId?: string;
+    /** Android package name or iOS bundle id. */
+    appId: string;
+    /** Optional deep link used for Expo/dev-client launch and foreground. */
+    launchUrl?: string;
+    /** Optional Metro port to reverse on Android before opening Expo/dev-client. */
+    metroPort?: string | number;
+    /** Optional host-side calls to run immediately before launch/foreground. */
+    prelaunchCalls?: AppLifecycleCall[];
+}
+export interface AppLifecycleExecResult {
+    stdout?: string;
+    stderr?: string;
+}
+export interface AppLifecycleCommandRunner {
+    execFile(file: string, args: string[], options?: {
+        timeoutMs?: number;
+    }): Promise<AppLifecycleExecResult>;
+}
+export interface AppLifecycleCall {
+    file: string;
+    args: string[];
+    ignoreFailureWhenOutputIncludes?: string[];
+}
+export interface AppLifecycleTargetProvider {
+    resolveTarget(node: Record<string, unknown>, context: ActionExecutionContext): Promise<AppLifecycleTarget> | AppLifecycleTarget;
+}
+export interface CreateAppLifecycleAdapterOptions {
+    actions?: Iterable<string>;
+    targetProvider: AppLifecycleTargetProvider;
+    commandRunner?: AppLifecycleCommandRunner;
+}
+export declare function createAppLifecycleAdapters(options: CreateAppLifecycleAdapterOptions): ActionAdapter[];
+export declare function createAppLifecycleAdapter(options: CreateAppLifecycleAdapterOptions): ActionAdapter;
+//# sourceMappingURL=app-lifecycle.d.ts.map

package/dist/adapters/app-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-lifecycle.d.ts","sourceRoot":"","sources":["../../src/adapters/app-lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAI9E,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,eAAe,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAEnG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+BAA+B,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,CACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;CACrD;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,EAAE,0BAA0B,CAAC;IAC3C,aAAa,CAAC,EAAE,yBAAyB,CAAC;CAC3C;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gCAAgC,GACxC,aAAa,EAAE,CAGjB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,aAAa,CA4Cf"}

package/dist/adapters/app-lifecycle.js

@@ -0,0 +1,203 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { asNumber, asOptionalString } from '../core/json.js';
+const execFileAsync = promisify(execFile);
+export function createAppLifecycleAdapters(options) {
+    if (options.actions && !new Set(options.actions).has('app.lifecycle'))
+        return [];
+    return [createAppLifecycleAdapter(options)];
+}
+export function createAppLifecycleAdapter(options) {
+    const commandRunner = options.commandRunner ?? defaultCommandRunner();
+    return {
+        action: 'app.lifecycle',
+        async execute(node, context) {
+            // Validate every node input before resolving the target or running any
+            // command, so a bad knob can never fail the action after side effects.
+            const command = parseLifecycleCommand(node);
+            const timeoutMs = optionalIntegerInRange(node.timeout_ms, 'app.lifecycle.timeout_ms', 0, Number.MAX_SAFE_INTEGER);
+            const settleMs = optionalIntegerInRange(node.settle_ms, 'app.lifecycle.settle_ms', 0, 60_000);
+            const target = await options.targetProvider.resolveTarget(node, context);
+            const calls = lifecycleCalls(command, target);
+            const results = [];
+            for (const call of calls) {
+                const result = await execLifecycleCall(commandRunner, call, timeoutMs);
+                results.push({
+                    file: call.file,
+                    args: call.args,
+                    stdout: result.stdout ?? '',
+                    stderr: result.stderr ?? '',
+                    ignoredFailure: result.ignoredFailure ?? false,
+                });
+            }
+            if (settleMs !== undefined) {
+                await new Promise((resolve) => setTimeout(resolve, settleMs));
+            }
+            return {
+                output: {
+                    command,
+                    platform: target.platform,
+                    deviceId: target.deviceId ?? null,
+                    appId: target.appId,
+                    launchUrl: target.launchUrl ?? null,
+                    calls: results,
+                    settleMs: settleMs ?? 0,
+                },
+            };
+        },
+    };
+}
+function parseLifecycleCommand(node) {
+    // `event` and `state` are accepted as aliases for `command` so recipes can use
+    // the field name that reads best for their flow (e.g. state: background).
+    const raw = asOptionalString(node.command, 'app.lifecycle.command') ??
+        asOptionalString(node.event, 'app.lifecycle.event') ??
+        asOptionalString(node.state, 'app.lifecycle.state');
+    if (!raw) {
+        throw new Error('app.lifecycle.command must be explicit (aliases: event, state). Supported commands: launch, foreground, background, terminate, restart.');
+    }
+    const command = raw;
+    if (command === 'launch' ||
+        command === 'foreground' ||
+        command === 'background' ||
+        command === 'terminate' ||
+        command === 'restart') {
+        return command;
+    }
+    throw new Error(`Unsupported app.lifecycle command: ${command}. Supported commands: launch, foreground, background, terminate, restart.`);
+}
+function lifecycleCalls(command, target) {
+    if (!target.appId || !target.appId.trim()) {
+        throw new Error('app.lifecycle target requires appId.');
+    }
+    if (command === 'restart') {
+        return [
+            ...lifecycleCalls('terminate', target),
+            ...(target.prelaunchCalls ?? []),
+            ...lifecycleCalls('launch', target),
+        ];
+    }
+    if (command === 'launch' || command === 'foreground') {
+        return [...(target.prelaunchCalls ?? []), ...lifecyclePlatformCalls(command, target)];
+    }
+    return lifecyclePlatformCalls(command, target);
+}
+function lifecyclePlatformCalls(command, target) {
+    if (target.platform === 'android')
+        return androidLifecycleCalls(command, target);
+    if (target.platform === 'ios-simulator')
+        return iosSimulatorLifecycleCalls(command, target);
+    throw new Error(`Unsupported app.lifecycle platform: ${String(target.platform)}`);
+}
+function androidLifecycleCalls(command, target) {
+    const adb = 'adb';
+    const serialArgs = target.deviceId ? ['-s', target.deviceId] : [];
+    if (command === 'background') {
+        return [{ file: adb, args: [...serialArgs, 'shell', 'input', 'keyevent', 'HOME'] }];
+    }
+    if (command === 'terminate') {
+        return [{ file: adb, args: [...serialArgs, 'shell', 'am', 'force-stop', target.appId] }];
+    }
+    if (target.launchUrl) {
+        const calls = [];
+        if (target.metroPort !== undefined && target.metroPort !== '') {
+            const port = String(target.metroPort);
+            calls.push({
+                file: adb,
+                args: [...serialArgs, 'reverse', `tcp:${port}`, `tcp:${port}`],
+            });
+        }
+        calls.push({
+            file: adb,
+            args: [
+                ...serialArgs,
+                'shell',
+                'am',
+                'start',
+                '-a',
+                'android.intent.action.VIEW',
+                '-d',
+                target.launchUrl,
+            ],
+        });
+        return calls;
+    }
+    return [
+        {
+            file: adb,
+            args: [
+                ...serialArgs,
+                'shell',
+                'monkey',
+                '-p',
+                target.appId,
+                '-c',
+                'android.intent.category.LAUNCHER',
+                '1',
+            ],
+        },
+    ];
+}
+function iosSimulatorLifecycleCalls(command, target) {
+    const device = target.deviceId ?? 'booted';
+    if (command === 'background') {
+        // iOS Simulator has no direct HOME equivalent; foreground Settings to background the app under test.
+        return [{ file: 'xcrun', args: ['simctl', 'launch', device, 'com.apple.Preferences'] }];
+    }
+    if (command === 'terminate') {
+        return [
+            {
+                file: 'xcrun',
+                args: ['simctl', 'terminate', device, target.appId],
+                // simctl terminate exits non-zero when the app is already stopped; restart should remain idempotent.
+                ignoreFailureWhenOutputIncludes: ['not running'],
+            },
+        ];
+    }
+    if (target.launchUrl) {
+        return [{ file: 'xcrun', args: ['simctl', 'openurl', device, target.launchUrl] }];
+    }
+    return [{ file: 'xcrun', args: ['simctl', 'launch', device, target.appId] }];
+}
+async function execLifecycleCall(commandRunner, call, timeoutMs) {
+    try {
+        return await commandRunner.execFile(call.file, call.args, { timeoutMs });
+    }
+    catch (error) {
+        const text = error instanceof Error ? error.message : String(error);
+        if (call.ignoreFailureWhenOutputIncludes?.some((needle) => text.includes(needle))) {
+            return { stderr: text, ignoredFailure: true };
+        }
+        throw error;
+    }
+}
+function optionalIntegerInRange(value, label, min, max) {
+    if (value == null)
+        return undefined;
+    const number = asNumber(value, label);
+    if (!Number.isInteger(number) || number < min || number > max) {
+        throw new Error(`${label} must be an integer from ${min} through ${max}.`);
+    }
+    return number;
+}
+function defaultCommandRunner() {
+    return {
+        async execFile(file, args, options) {
+            try {
+                return await execFileAsync(file, args, {
+                    timeout: options?.timeoutMs,
+                    encoding: 'utf8',
+                });
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    const output = error;
+                    const details = [output.message, output.stderr, output.stdout].filter(Boolean).join('\n');
+                    throw new Error(`${file} ${args.join(' ')} failed: ${details}`);
+                }
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=app-lifecycle.js.map

package/dist/adapters/app-lifecycle.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export type { AppLifecycleCommand, AppLifecycleCommandRunner, AppLifecyclePlatform, AppLifecycleTarget, AppLifecycleTargetProvider, CreateAppLifecycleAdapterOptions, } from './adapters/app-lifecycle.js';
+export { createAppLifecycleAdapter, createAppLifecycleAdapters } from './adapters/app-lifecycle.js';
 export { createStandardCoreAdapters } from './adapters/core.js';
 export type { StandardUiAction, UiActionTransport, UiTransportControl, UiTransportResult, } from './adapters/ui.js';
 export { createStandardUiAdapters, normalizeUiTransportResult, STANDARD_UI_ACTIONS, } from './adapters/ui.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,mBAAmB,iBAAiB,CAAC;AACrC,YAAY,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EACL,gCAAgC,EAChC,YAAY,EACZ,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,mBAAmB,iBAAiB,CAAC;AACrC,YAAY,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EACL,gCAAgC,EAChC,YAAY,EACZ,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export { createAppLifecycleAdapter, createAppLifecycleAdapters } from './adapters/app-lifecycle.js';
 export { createStandardCoreAdapters } from './adapters/core.js';
 export { createStandardUiAdapters, normalizeUiTransportResult, STANDARD_UI_ACTIONS, } from './adapters/ui.js';
 export { defaultRecipeLibrarySources, loadRecipeLibraries, parseRecipeLibraryPath, personalRecipeLibraryRoot, resolveRecipeLibrarySources, } from './core/library.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAOhE,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EACL,gCAAgC,EAChC,YAAY,EACZ,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAOhE,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EACL,gCAAgC,EAChC,YAAY,EACZ,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/recipe-harness",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,6 +43,11 @@
       "import": "./dist/adapters/core.js",
       "default": "./dist/adapters/core.js"
     },
+    "./adapters/app-lifecycle": {
+      "types": "./dist/adapters/app-lifecycle.d.ts",
+      "import": "./dist/adapters/app-lifecycle.js",
+      "default": "./dist/adapters/app-lifecycle.js"
+    },
     "./adapters/ui": {
       "types": "./dist/adapters/ui.d.ts",
       "import": "./dist/adapters/ui.js",