@farmslot/recipe-cli 0.2.0 → 0.3.0

package/dist/harness/parse-args.d.ts

@@ -0,0 +1,35 @@
+export type CliOptionValue = string | boolean | readonly string[];
+export type CliOptions = Record<string, CliOptionValue>;
+export interface ParsedArgs {
+    positional: string[];
+    options: CliOptions;
+    rawArgv: string[];
+}
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode: number);
+}
+export declare function usageError(message: string): CliError;
+export interface ParseArgsOptions {
+    recordIsFlag?: boolean;
+}
+export declare function parseArgs(argv: string[], parse?: ParseArgsOptions): ParsedArgs;
+export declare function parseRecipeParamAssignments(values: readonly string[]): Record<string, unknown>;
+export declare function optionString(options: CliOptions, key: string): string | undefined;
+export declare function optionStrings(options: CliOptions, key: string): readonly string[] | undefined;
+export declare function optionFlag(options: CliOptions, key: string): boolean;
+export declare function applyRuntimeDirOption(options: CliOptions): void;
+export declare function applyWatcherPortOption(options: CliOptions): void;
+export declare function requiredOption(options: CliOptions, key: string, message: string): string;
+export declare function adapterOption(options: CliOptions): string;
+export declare function targetPath(options: CliOptions): string;
+export declare function actionManifestPathOption(options: CliOptions, adapter: string): string;
+export declare function parsePort(value: string | undefined, errorMessage: string): number;
+export declare function resolveAdapter(options: CliOptions): {
+    adapter: string;
+    target: string;
+};
+export declare function shellQuote(value: string): string;
+export declare function shellQuoteArg(value: string): string;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/harness/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../../src/harness/parse-args.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,MAAM,EAAE,CAAC;AAClE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAOD,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAK9C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEpD;AAED,MAAM,WAAW,gBAAgB;IAE/B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,gBAAqB,GAAG,UAAU,CAoElF;AAqBD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2B9F;AAoBD,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAO7F;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAG/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAMhE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxF;AASD,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAQzD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAIjF;AAKD,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAcvF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/harness/parse-args.js

@@ -0,0 +1,249 @@
+// Shared argv/option parsing for dispatch-backed commands: positionals,
+// camelCased options, repeatable `--library`, and the typed usage error.
+import path from 'node:path';
+import { adapterDetectNext, adapterFlags, adapterForPlatform, adapterPortEnv, assertAdapter, detectAdapter, harnessAdapter, undetectedAdapterMessage, } from './adapters.js';
+import { EXIT } from './shared.js';
+// Typed exit-code error: carries exitCode so both the global catch (the host bin)
+// and the host's delegate() wrapper classify the error correctly rather than always
+// returning 1.  Usage errors (bad args / unsupported flags) carry EXIT.usage (2);
+// validation errors carry EXIT.validation (5).  Never throw a plain new Error() for
+// user-facing bad-args cases — use usageError() so the exit code is preserved.
+export class CliError extends Error {
+    constructor(message, exitCode) {
+        super(message);
+        this.name = 'CliError';
+        this.exitCode = exitCode;
+    }
+}
+export function usageError(message) {
+    return new CliError(message, EXIT.usage);
+}
+export function parseArgs(argv, parse = {}) {
+    const positional = [];
+    const options = {};
+    const booleanOptions = new Set([
+        'json',
+        'jsonStream',
+        'resetProfile',
+        'preserveProfile',
+        'record',
+        'plan',
+        'proof',
+        'list',
+        'describe',
+        'raw',
+        'matrix',
+        'categories',
+        'fix',
+        'force',
+        'expectLive',
+        'printReady',
+        'fast',
+        'allDevices',
+        'watch',
+        'help',
+        'noOpen',
+        ...adapterFlags('commands'),
+    ]);
+    const repeatableOptions = new Set(['library']);
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (!arg.startsWith('--')) {
+            positional.push(arg);
+            continue;
+        }
+        const body = arg.slice(2);
+        const equalsIndex = body.indexOf('=');
+        const rawKey = equalsIndex === -1 ? body : body.slice(0, equalsIndex);
+        const inlineValue = equalsIndex === -1 ? undefined : body.slice(equalsIndex + 1);
+        const key = normalizeOptionKey(rawKey);
+        if (key === 'recordVideo') {
+            options.recordVideo = parseRecordVideoMode(inlineValue);
+            continue;
+        }
+        if (key === 'recordBaseline') {
+            options.record = true;
+            continue;
+        }
+        if (key === 'record') {
+            if (parse.recordIsFlag) {
+                options.record = true;
+                continue;
+            }
+            options.recordVideo = 'full-run';
+            continue;
+        }
+        if (booleanOptions.has(key)) {
+            options[key] = true;
+            continue;
+        }
+        if (inlineValue !== undefined) {
+            assignOption(options, key, inlineValue, repeatableOptions);
+            continue;
+        }
+        if (i + 1 >= argv.length)
+            throw usageError(`Missing value for ${arg}`);
+        assignOption(options, key, argv[i + 1], repeatableOptions);
+        i += 1;
+    }
+    return { positional, options, rawArgv: [...argv] };
+}
+function assignOption(options, key, value, repeatableOptions) {
+    if (!repeatableOptions.has(key)) {
+        options[key] = value;
+        return;
+    }
+    const existing = options[key];
+    if (existing === undefined) {
+        options[key] = [value];
+        return;
+    }
+    if (!Array.isArray(existing))
+        throw usageError(`--${key} has conflicting values.`);
+    options[key] = [...existing, value];
+}
+export function parseRecipeParamAssignments(values) {
+    const params = {};
+    for (const assignment of values) {
+        const separator = assignment.indexOf('=');
+        if (separator <= 0) {
+            throw usageError(`recipe parameter ${JSON.stringify(assignment)} must use key=value.`);
+        }
+        const key = assignment.slice(0, separator).trim();
+        if (!key)
+            throw usageError(`recipe parameter ${JSON.stringify(assignment)} has an empty key.`);
+        if (Object.hasOwn(params, key)) {
+            throw usageError(`recipe parameter ${JSON.stringify(key)} was provided more than once.`);
+        }
+        const raw = assignment.slice(separator + 1);
+        let value;
+        try {
+            value = JSON.parse(raw);
+        }
+        catch {
+            value = raw;
+        }
+        Object.defineProperty(params, key, {
+            value,
+            enumerable: true,
+            configurable: true,
+            writable: true,
+        });
+    }
+    return params;
+}
+function parseRecordVideoMode(value) {
+    if (value === undefined || value === '' || value === 'true')
+        return 'full-run';
+    if (value === 'off' || value === 'false')
+        return false;
+    if (value === 'proof-window' || value === 'proof_window') {
+        throw usageError('--record-video=proof-window is not supported yet; use --record-video=full-run.');
+    }
+    if (value !== 'full-run') {
+        throw usageError('--record-video must be full-run or off.');
+    }
+    return 'full-run';
+}
+function normalizeOptionKey(key) {
+    return key.replace(/-([a-z])/gu, (_, character) => character.toUpperCase());
+}
+export function optionString(options, key) {
+    const value = options[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        throw usageError(`--${key} requires a value.`);
+    return value;
+}
+export function optionStrings(options, key) {
+    const value = options[key];
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== 'string')) {
+        throw usageError(`--${key} requires a value.`);
+    }
+    return value;
+}
+export function optionFlag(options, key) {
+    const value = options[key];
+    return value === true;
+}
+export function applyRuntimeDirOption(options) {
+    const runtimeDir = optionString(options, 'runtimeDir');
+    if (runtimeDir)
+        process.env.RECIPE_RUNTIME_DIR = runtimeDir;
+}
+export function applyWatcherPortOption(options) {
+    const watcherPort = optionString(options, 'watcherPort');
+    if (!watcherPort)
+        return;
+    process.env.WATCHER_PORT = watcherPort;
+    process.env.RECIPE_WATCHER_PORT = watcherPort;
+    for (const name of adapterPortEnv())
+        process.env[name] = watcherPort;
+}
+export function requiredOption(options, key, message) {
+    const value = optionString(options, key);
+    if (!value)
+        throw usageError(message);
+    return value;
+}
+// An unknown adapter is a usage error; an empty registry is an internal one
+// and keeps its own error.
+function adapterUsageError(error) {
+    if (error instanceof Error && error.message.startsWith('internal:'))
+        return error;
+    return usageError(error instanceof Error ? error.message : String(error));
+}
+export function adapterOption(options) {
+    const adapter = optionString(options, 'adapter');
+    try {
+        assertAdapter(adapter);
+    }
+    catch (error) {
+        throw adapterUsageError(error);
+    }
+    return adapter;
+}
+export function targetPath(options) {
+    return path.resolve(optionString(options, 'target') ?? process.cwd());
+}
+export function actionManifestPathOption(options, adapter) {
+    const configured = optionString(options, 'actionManifest');
+    return configured ? path.resolve(configured) : harnessAdapter(adapter).actions.manifestPath();
+}
+export function parsePort(value, errorMessage) {
+    const port = Number(value);
+    if (!Number.isInteger(port) || port <= 0)
+        throw usageError(errorMessage);
+    return port;
+}
+// Shared adapter resolution: explicit --adapter/--platform, else auto-detect from
+// --target/cwd (the exact detect story doctor/verify/install use). Lets `call`,
+// `run --plan`, and `completion-candidates` work in a checkout without a flag.
+export function resolveAdapter(options) {
+    const target = targetPath(options);
+    const explicit = optionString(options, 'adapter') ?? adapterForPlatform(optionString(options, 'platform'));
+    const adapter = explicit ?? detectAdapter(target);
+    if (!adapter) {
+        throw usageError(`${undetectedAdapterMessage(target)}\n  Next: ${adapterDetectNext()}`);
+    }
+    try {
+        assertAdapter(adapter);
+    }
+    catch (error) {
+        throw adapterUsageError(error);
+    }
+    return { adapter, target };
+}
+export function shellQuote(value) {
+    return `'${value.replace(/'/gu, `'\\''`)}'`;
+}
+export function shellQuoteArg(value) {
+    return /^[A-Za-z0-9_./:=@+-]+$/u.test(value) ? value : shellQuote(value);
+}
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/harness/parse-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../../src/harness/parse-args.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,yEAAyE;AAEzE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAWnC,kFAAkF;AAClF,oFAAoF;AACpF,kFAAkF;AAClF,oFAAoF;AACpF,+EAA+E;AAC/E,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEjC,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAOD,MAAM,UAAU,SAAS,CAAC,IAAc,EAAE,QAA0B,EAAE;IACpE,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;QAC7B,MAAM;QACN,YAAY;QACZ,cAAc;QACd,iBAAiB;QACjB,QAAQ;QACR,MAAM;QACN,OAAO;QACP,MAAM;QACN,UAAU;QACV,KAAK;QACL,QAAQ;QACR,YAAY;QACZ,KAAK;QACL,OAAO;QACP,YAAY;QACZ,YAAY;QACZ,MAAM;QACN,YAAY;QACZ,OAAO;QACP,MAAM;QACN,QAAQ;QACR,GAAG,YAAY,CAAC,UAAU,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QACjF,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YAC1B,OAAO,CAAC,WAAW,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,OAAO,CAAC,WAAW,GAAG,UAAU,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;YAC3D,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,UAAU,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;QACvE,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAC3D,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CACnB,OAAmB,EACnB,GAAW,EACX,KAAa,EACb,iBAAsC;IAEtC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,UAAU,CAAC,KAAK,GAAG,0BAA0B,CAAC,CAAC;IACnF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAyB;IACnE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,UAAU,IAAI,MAAM,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,UAAU,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,GAAG;YAAE,MAAM,UAAU,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;QAC/F,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,UAAU,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAC5C,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,GAAG,GAAG,CAAC;QACd,CAAC;QACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;YACjC,KAAK;YACL,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAyB;IACrD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IAC/E,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;QACzD,MAAM,UAAU,CACd,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,MAAM,UAAU,CAAC,yCAAyC,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,SAAiB,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAmB,EAAE,GAAW;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,UAAU,CAAC,KAAK,GAAG,oBAAoB,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAmB,EAAE,GAAW;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC9E,MAAM,UAAU,CAAC,KAAK,GAAG,oBAAoB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAmB,EAAE,GAAW;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAmB;IACvD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACvD,IAAI,UAAU;QAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,UAAU,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAmB;IACxD,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW;QAAE,OAAO;IACzB,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,WAAW,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,WAAW,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAmB,EAAE,GAAW,EAAE,OAAe;IAC9E,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,2BAA2B;AAC3B,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAClF,OAAO,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAmB;IAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,aAAa,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAmB;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAmB,EAAE,OAAe;IAC3E,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAC3D,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAyB,EAAE,YAAoB;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAAE,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,gFAAgF;AAChF,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,OAAmB;IAChD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,GACZ,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,kBAAkB,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,QAAQ,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,UAAU,CAAC,GAAG,wBAAwB,CAAC,MAAM,CAAC,aAAa,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC;QACH,aAAa,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/harness/paths.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_RECIPE_RUNTIME_DIR = "temp/recipe/runtime";
+export declare const DEFAULT_RECIPE_HARNESS_ROOT = "temp/recipe/harness";
+/** The checkout-relative runtime directory: `RECIPE_RUNTIME_DIR`, else the default. */
+export declare function recipeRuntimeDir(): string;
+/** The checkout-relative overlay directory: `RECIPE_HARNESS_ROOT`, else the default. */
+export declare function recipeHarnessRoot(): string;
+export declare function recipeRuntimePath(projectRoot: string, ...segments: string[]): string;
+export declare function recipeHarnessPath(projectRoot: string, ...segments: string[]): string;
+/**
+ * The host executable serving this run. The host bin exports its own resolved
+ * path as `<envPrefix>_EXECUTABLE`, so a command that re-enters the harness
+ * reaches the install a task locked onto rather than whatever PATH resolves to.
+ */
+export declare function harnessExecutable(): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/harness/paths.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAChE,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AAEjE,uFAAuF;AACvF,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpF;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C"}

package/dist/harness/paths.js

@@ -0,0 +1,29 @@
+import path from 'node:path';
+import { harnessHost, hostEnvName, validateRelativeRecipePath } from './host.js';
+// The checkout layout every host and shell leaf shares (`temp/recipe/runtime/<adapter>/`).
+export const DEFAULT_RECIPE_RUNTIME_DIR = 'temp/recipe/runtime';
+export const DEFAULT_RECIPE_HARNESS_ROOT = 'temp/recipe/harness';
+/** The checkout-relative runtime directory: `RECIPE_RUNTIME_DIR`, else the default. */
+export function recipeRuntimeDir() {
+    return validateRelativeRecipePath('RECIPE_RUNTIME_DIR', process.env.RECIPE_RUNTIME_DIR || DEFAULT_RECIPE_RUNTIME_DIR);
+}
+/** The checkout-relative overlay directory: `RECIPE_HARNESS_ROOT`, else the default. */
+export function recipeHarnessRoot() {
+    return validateRelativeRecipePath('RECIPE_HARNESS_ROOT', process.env.RECIPE_HARNESS_ROOT || DEFAULT_RECIPE_HARNESS_ROOT);
+}
+export function recipeRuntimePath(projectRoot, ...segments) {
+    return path.join(projectRoot, recipeRuntimeDir(), ...segments);
+}
+export function recipeHarnessPath(projectRoot, ...segments) {
+    return path.join(projectRoot, recipeHarnessRoot(), ...segments);
+}
+/**
+ * The host executable serving this run. The host bin exports its own resolved
+ * path as `<envPrefix>_EXECUTABLE`, so a command that re-enters the harness
+ * reaches the install a task locked onto rather than whatever PATH resolves to.
+ */
+export function harnessExecutable() {
+    const host = harnessHost();
+    return path.resolve(process.env[hostEnvName('EXECUTABLE')] ?? path.join(host.packageRoot, host.bin));
+}
+//# sourceMappingURL=paths.js.map

package/dist/harness/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/harness/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAEjF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAChE,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AAEjE,uFAAuF;AACvF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,0BAA0B,CAC/B,oBAAoB,EACpB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,0BAA0B,CAC7D,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,0BAA0B,CAC/B,qBAAqB,EACrB,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,2BAA2B,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,GAAG,QAAkB;IAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,GAAG,QAAkB;IAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,OAAO,CACjB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAChF,CAAC;AACJ,CAAC"}

package/dist/harness/shared.d.ts

@@ -0,0 +1,43 @@
+export declare const EXIT: {
+    readonly ok: 0;
+    readonly runtime: 1;
+    readonly usage: 2;
+    readonly infra: 3;
+    readonly bounded: 4;
+    readonly validation: 5;
+};
+export declare function writeInteractiveProgress(json: boolean, message: string, { stdoutIsTTY, stream, }?: {
+    stdoutIsTTY?: boolean;
+    stream?: Pick<NodeJS.WriteStream, 'write'>;
+}): boolean;
+export interface ParsedFlags {
+    positional: string[];
+    options: Record<string, string | boolean>;
+}
+export declare function parseFlags(argv: string[], booleans: Set<string>): ParsedFlags;
+export declare function str(options: Record<string, string | boolean>, key: string): string | undefined;
+export declare function flag(options: Record<string, string | boolean>, key: string): boolean;
+export declare function targetOf(options: Record<string, string | boolean>): string;
+export declare function resolveFlagsAdapter(options: Record<string, string | boolean>, target: string, hint?: string): string | undefined;
+export interface ScriptResult {
+    error?: Error;
+    status: number;
+    output: string;
+    timedOut?: boolean;
+    timeoutMs?: number;
+}
+export interface StreamingSpawnOptions {
+    stage?: string;
+    capture?: boolean;
+    stdin?: 'ignore' | 'inherit';
+    forward?: 'stderr' | 'original' | 'none';
+    env?: Record<string, string>;
+    timeoutMs?: number;
+}
+export declare function scriptOverride(scriptPath: string): string | undefined;
+export declare function spawnScript(script: string, args: string[], cwd: string, json: boolean, env?: Record<string, string>): ScriptResult;
+export declare function spawnInherit(script: string, args: string[], cwd: string): number;
+export declare function spawnScriptStreaming(script: string, args: string[], cwd: string, options?: Record<string, string> | StreamingSpawnOptions): Promise<ScriptResult>;
+export declare function usageOut(json: boolean, command: string, message: string, userAction: string): number;
+export declare function checkoutBusyOut(json: boolean, command: string, message: string, lockPath: string): number;
+//# sourceMappingURL=shared.d.ts.map

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

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