@farmslot/recipe-cli 0.10.0 → 0.11.0

package/dist/harness/commands/task-init.js.map

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

package/dist/harness/context-state.d.ts

@@ -0,0 +1,106 @@
+import { CliError } from './cli-error.js';
+/** Where a context value came from, strongest first. */
+export type ContextSource = 'flag' | 'binding' | 'slot' | 'detect' | 'default';
+/** The detect predicate that matched a checkout. */
+export type DetectMatch = 'remote' | 'files';
+export interface HarnessContext {
+    adapter?: {
+        value: string;
+        source: ContextSource;
+        /**
+         * The human label: '--adapter', '--platform' or 'positional' (flag),
+         * 'runtime-context' (binding), 'slot-config' (slot), the matched predicates
+         * joined by '+' (detect), 'default'.
+         */
+        detail: string;
+        /** The predicates that matched, for source 'detect'. */
+        matched?: DetectMatch[];
+        /** The library that declares the adapter, when it is a plugin. */
+        library?: string;
+    };
+    target: {
+        value: string;
+        source: 'flag' | 'default';
+        detail: '--target' | 'cwd';
+    };
+    /**
+     * The checkout's slot. `source: 'none'` (value null) when the runtime context
+     * names no slot either: detail 'no-pool-dir' when no pool directory is known,
+     * 'not-in-pool' (with `poolDir`) when the pool maps no slot to the checkout.
+     */
+    slot?: {
+        value: string;
+        source: 'slot' | 'binding';
+        detail: 'slot-config' | 'slot-config (~/farmslot-node/pool)' | 'runtime-context';
+        session?: string;
+        poolFile?: string;
+        ports: Record<string, number>;
+    } | {
+        value: null;
+        source: 'none';
+        detail: 'no-pool-dir';
+    } | {
+        value: null;
+        source: 'none';
+        detail: 'not-in-pool';
+        poolDir: string;
+    };
+    /**
+     * A runtime context the checkout would have read (an inherited
+     * RECIPE_RUNTIME_CONTEXT) whose repoRoot is another checkout: it binds no
+     * adapter or slot here.
+     */
+    ignoredBinding?: {
+        path: string;
+        repoRoot: string | null;
+    };
+    /**
+     * The generic ports the command takes. 'flag': a spelling of the option was
+     * typed (`value` when the spellings agree). 'env': the user's environment
+     * holds it (`filled: false`, left to the adapter). 'slot': the slot's port,
+     * set in the environment the adapters read (`filled: true`, `via: 'env'`,
+     * `names` the variables set; `invalidEnv` names a non-port value it replaced). The command's argv is
+     * never changed. Adapter-specific ports stay in `slot.ports`.
+     */
+    ports?: Partial<Record<ContextPortName, {
+        value?: number;
+        source: 'flag' | 'env' | 'slot';
+        filled?: boolean;
+        via?: 'env';
+        /** The environment names a fill set. */
+        names?: readonly string[];
+        invalidEnv?: {
+            name: string;
+            value: string;
+        };
+    }>>;
+}
+/** A generic port option a command may take: `--cdp-port`, `--watcher-port`. */
+export type ContextPortName = 'cdp' | 'watcher';
+/** One adapter whose detect predicates matched a checkout. */
+export interface AdapterCandidate {
+    adapter: string;
+    matched: DetectMatch[];
+    library?: string;
+}
+/** More than one adapter matched a checkout, with nothing to choose between them. Exit 2. */
+export declare class AdapterAmbiguousError extends CliError {
+    readonly code = "ADAPTER_AMBIGUOUS";
+    readonly userAction: string;
+    readonly candidates: AdapterCandidate[];
+    constructor(target: string, candidates: AdapterCandidate[]);
+}
+/** Record the invocation's context; undefined clears it. */
+export declare function setHarnessContext(context: HarnessContext | undefined): void;
+/** The context createHarnessCli resolved for this invocation, if any. */
+export declare function harnessContext(): HarnessContext | undefined;
+/**
+ * The adapter the resolved context names for `target`, or undefined when no
+ * context was resolved for it. Commands take it after their own flags.
+ */
+export declare function contextAdapter(target: string): string | undefined;
+/** `{ context }` for a command's --json envelope, or nothing outside a resolved invocation. */
+export declare function harnessContextField(): {
+    context?: HarnessContext;
+};
+//# sourceMappingURL=context-state.d.ts.map

package/dist/harness/context-state.d.ts.map

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

package/dist/harness/context-state.js

@@ -0,0 +1,41 @@
+// The context one invocation resolved (context.ts): which adapter, target and
+// slot a command acts on, and where each came from. Kept apart from the
+// resolver so the commands and output modules read it without importing the
+// plugin loader.
+import path from 'node:path';
+import { CliError } from './cli-error.js';
+/** More than one adapter matched a checkout, with nothing to choose between them. Exit 2. */
+export class AdapterAmbiguousError extends CliError {
+    constructor(target, candidates) {
+        const listed = candidates
+            .map((candidate) => `${candidate.adapter} (${candidate.matched.join(', ')})`)
+            .join(', ');
+        // EXIT.usage; shared.ts imports this module, so the value is spelled here.
+        super(`${target} matches more than one adapter: ${listed}`, 2);
+        this.code = 'ADAPTER_AMBIGUOUS';
+        this.name = 'AdapterAmbiguousError';
+        this.candidates = candidates;
+        this.userAction = `pass --adapter <${candidates.map((candidate) => candidate.adapter).join('|')}>`;
+    }
+}
+let current;
+/** Record the invocation's context; undefined clears it. */
+export function setHarnessContext(context) {
+    current = context;
+}
+/** The context createHarnessCli resolved for this invocation, if any. */
+export function harnessContext() {
+    return current;
+}
+/**
+ * The adapter the resolved context names for `target`, or undefined when no
+ * context was resolved for it. Commands take it after their own flags.
+ */
+export function contextAdapter(target) {
+    return current?.target.value === path.resolve(target) ? current.adapter?.value : undefined;
+}
+/** `{ context }` for a command's --json envelope, or nothing outside a resolved invocation. */
+export function harnessContextField() {
+    return current ? { context: current } : {};
+}
+//# sourceMappingURL=context-state.js.map

package/dist/harness/context-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-state.js","sourceRoot":"","sources":["../../src/harness/context-state.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wEAAwE;AACxE,4EAA4E;AAC5E,iBAAiB;AACjB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgF1C,6FAA6F;AAC7F,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IAIjD,YAAY,MAAc,EAAE,UAA8B;QACxD,MAAM,MAAM,GAAG,UAAU;aACtB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;aAC5E,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,2EAA2E;QAC3E,KAAK,CAAC,GAAG,MAAM,mCAAmC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QARxD,SAAI,GAAG,mBAAmB,CAAC;QASlC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,mBAAmB,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrG,CAAC;CACF;AAED,IAAI,OAAmC,CAAC;AAExC,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAAC,OAAmC;IACnE,OAAO,GAAG,OAAO,CAAC;AACpB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,OAAO,EAAE,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7F,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,mBAAmB;IACjC,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/dist/harness/context.d.ts

@@ -0,0 +1,57 @@
+import { type AdapterLibraryOptions } from './adapter-plugins.js';
+import type { HarnessContext } from './context-state.js';
+export interface ResolveHarnessContextOptions {
+    /** The command's tokens, after the command name. */
+    tokens: readonly string[];
+    /**
+     * The command's positionals as its grammar reads them (`contractPositionals`);
+     * the first may be a platform target (`launch --json ios`). Default: the
+     * first token, when it is not an option.
+     */
+    positionals?: readonly string[];
+    /** false: resolve the target and slot only, never an adapter. Default true. */
+    adapter?: boolean;
+    /** Default: process.cwd(). */
+    cwd?: string;
+    /** The libraries whose declarations are candidates: the loader's trust set. */
+    load?: AdapterLibraryOptions;
+    /** The adapter a runtime context's or slot's `platform` names, when it is not an adapter id. */
+    slotAdapter?(platform: string): string | undefined;
+    /**
+     * The pool directory slot-config reads. Default (`resolveSlotPoolDir`):
+     * FARMSLOT_POOL_DIR, else $FARMSLOT_ROOT/pool, else ~/farmslot-node/pool when
+     * it exists. Without one, a checkout whose runtime context names no slot
+     * reports `slot: { value: null, source: 'none', detail: 'no-pool-dir' }`.
+     */
+    slotPoolDir?: string;
+    /** The adapter when nothing else decides. */
+    defaultAdapter?: string;
+}
+/**
+ * Resolve the invocation's context. Throws AdapterAmbiguousError when detection
+ * is reached and more than one adapter matches the target.
+ */
+export declare function resolveHarnessContext(options: ResolveHarnessContextOptions): Promise<HarnessContext>;
+/**
+ * The generic ports `options` (a command's grammar) takes, and the
+ * environment that fills the ones the user left open. The command's argv is
+ * never touched: a slot port reaches the adapter through the environment it
+ * already reads, which every adapter ranks below a typed flag, an alias and a
+ * passthrough port. A port is filled only when no spelling of it was typed and
+ * none of its environment names holds a port; a registered adapter's own port
+ * names (`devServer.portEnv`) are read and set with the watcher port's.
+ */
+export declare function contextPorts(context: HarnessContext, tokens: readonly string[], options: Readonly<Record<string, unknown>>, env?: NodeJS.ProcessEnv): {
+    ports?: NonNullable<HarnessContext['ports']>;
+    env: Record<string, string>;
+};
+/** The one human line: `context: adapter <id> (<source>), target <path> (<source>), slot <id> (<source>)`. */
+export declare function formatHarnessContext(context: HarnessContext): string;
+/**
+ * Whether the runtime context read from `file` belongs to the checkout `root`:
+ * its `repoRoot` is `root`'s Git top level (real paths), or, without
+ * `repoRoot`, the file sits inside `root`. Anything else is another
+ * checkout's (an inherited RECIPE_RUNTIME_CONTEXT) and describes nothing here.
+ */
+export declare function runtimeContextOwned(root: string, file: string, context: Readonly<Record<string, unknown>>): boolean;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/harness/context.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,qBAAqB,EAAmC,MAAM,sBAAsB,CAAC;AAUnG,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAI1E,MAAM,WAAW,4BAA4B;IAC3C,oDAAoD;IACpD,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,gGAAgG;IAChG,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,cAAc,CAAC,CA8EzB;AAoCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAoD/E;AAmBD,8GAA8G;AAC9G,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA4BpE;AAoGD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC,OAAO,CAMT"}

package/dist/harness/context.js

@@ -0,0 +1,409 @@
+// One context per invocation: the adapter, target and slot a command acts on,
+// and where each came from. The adapter resolves in this order: an explicit
+// flag, the checkout's binding (the runtime context a run's prepare wrote), the
+// slot whose checkout this is (slot-config), a unique detect match among the
+// built-ins and the plugins the operator's libraries declare, then the host's
+// default. Plugins are matched by their declaration's `detect`, never imported
+// to detect; the host loads only the winner. Approvals (--approve-plan, mainnet
+// and funding flags) are never part of the context: they stay explicit.
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { findSlotByRepo, resolveSlotPoolDir } from '@farmslot/protocol/node/slot-by-repo';
+import { adapterPlugin, declaredAdapters } from './adapter-plugins.js';
+import { adapterForPlatform, adapterPortEnv, detectAdapterMatch, harnessAdapters, isPlatformTarget, } from './adapters.js';
+import { optionValues } from './command-contract.js';
+import { validateRelativeRecipePath } from './host.js';
+import { DEFAULT_RECIPE_RUNTIME_DIR, recipeRuntimeDir } from './paths.js';
+/**
+ * Resolve the invocation's context. Throws AdapterAmbiguousError when detection
+ * is reached and more than one adapter matches the target.
+ */
+export async function resolveHarnessContext(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const targetFlag = optionValues(options.tokens, '--target').at(-1);
+    const target = targetFlag
+        ? { value: path.resolve(cwd, targetFlag), source: 'flag', detail: '--target' }
+        : { value: path.resolve(cwd), source: 'default', detail: 'cwd' };
+    const registry = harnessAdapters();
+    const declared = await declaredAdapters(options.load);
+    const known = (id) => id !== undefined && (registry.has(id) || declared.some((entry) => entry.id === id))
+        ? id
+        : undefined;
+    const platformAdapter = (platform) => typeof platform === 'string' && platform
+        ? known(options.slotAdapter?.(platform) ?? adapterForPlatform(platform))
+        : undefined;
+    // Without --target, a subdirectory answers for its checkout: the binding, the
+    // slot and detection read the Git top level.
+    const root = targetFlag ? target.value : (gitTopLevel(target.value) ?? target.value);
+    const runtimeDir = optionValues(options.tokens, '--runtime-dir').at(-1);
+    const binding = readBinding(root, runtimeDir);
+    const runtime = binding.runtime;
+    const pool = options.slotPoolDir
+        ? { dir: options.slotPoolDir, source: 'option' }
+        : resolveSlotPoolDir();
+    const pooled = pool
+        ? await poolSlot(root, pool.dir, pool.source === 'farmslot-node' ? 'slot-config (~/farmslot-node/pool)' : 'slot-config')
+        : 'no-pool-dir';
+    const pooledSlot = typeof pooled === 'object' ? pooled : undefined;
+    // The pool's slot keeps the owned runtime context's ports beside its own
+    // (camelCase runtime keys, snake_case pool keys), so they can win the fill.
+    const owned = runtimeSlot(runtime);
+    const slot = (pooledSlot
+        ? owned &&
+            owned.value !== pooledSlot.slot.value &&
+            runtimeDir !== undefined &&
+            path.normalize(runtimeDir) !== DEFAULT_RECIPE_RUNTIME_DIR
+            ? // An explicit --runtime-dir scratch runtime names its own slot:
+                // identity and ports describe that runtime, the pool's ports filling
+                // only what it lacks. The default context keeps the pool's identity.
+                { ...owned, ports: { ...pooledSlot.slot.ports, ...owned.ports } }
+            : {
+                ...pooledSlot.slot,
+                ports: { ...pooledSlot.slot.ports, ...runtimePorts(runtime) },
+            }
+        : undefined) ??
+        owned ??
+        (pool === undefined || pooled === 'no-pool-dir'
+            ? { value: null, source: 'none', detail: 'no-pool-dir' }
+            : { value: null, source: 'none', detail: 'not-in-pool', poolDir: pool.dir });
+    const adapter = options.adapter === false
+        ? undefined
+        : (flagAdapter(options.tokens, options.positionals) ??
+            sourced(platformAdapter(runtime?.platform), 'binding', 'runtime-context') ??
+            sourced(platformAdapter(pooledSlot?.platform), 'slot', 'slot-config') ??
+            detectedAdapter(root, 
+            // A declaration that claims a built-in id is no candidate; selecting
+            // it reports the conflict.
+            declared.filter((entry) => !registry.has(entry.id) || adapterPlugin(entry.id))) ??
+            sourced(options.defaultAdapter, 'default', 'default'));
+    return {
+        ...(adapter ? { adapter } : {}),
+        target,
+        ...(slot ? { slot } : {}),
+        ...(binding.ignored ? { ignoredBinding: binding.ignored } : {}),
+    };
+}
+// Each generic port option, and the slot ports that fill it, in order.
+// Per port: the option and its aliases (a typed one is the adapter's to read),
+// the environment names the adapters read (`read`: any one set means the user
+// chose; the fill never replaces it), and the names the fill sets, which are
+// the ones recipe-cli itself sets for a typed flag. The slot's ports: the owned
+// runtime context's first (a --runtime-dir scratch runtime names its own),
+// then the pool's.
+const PORT_OPTIONS = [
+    {
+        name: 'cdp',
+        option: '--cdp-port',
+        aliases: [],
+        read: ['RECIPE_CDP_PORT', 'CDP_PORT'],
+        set: ['RECIPE_CDP_PORT', 'CDP_PORT'],
+        slot: ['cdpPort', 'cdp_port'],
+    },
+    {
+        name: 'watcher',
+        option: '--watcher-port',
+        // `doctor`/`stop --port` and the retired `--metro-port` name the same port.
+        aliases: ['--port', '--metro-port'],
+        read: ['TERMINAL_APP_PORT', 'RECIPE_WATCHER_PORT', 'WATCHER_PORT', 'METRO_PORT'],
+        set: ['RECIPE_WATCHER_PORT', 'WATCHER_PORT', 'METRO_PORT'],
+        slot: ['devServerPort', 'watcherPort', 'metroPort', 'port'],
+    },
+];
+/**
+ * The generic ports `options` (a command's grammar) takes, and the
+ * environment that fills the ones the user left open. The command's argv is
+ * never touched: a slot port reaches the adapter through the environment it
+ * already reads, which every adapter ranks below a typed flag, an alias and a
+ * passthrough port. A port is filled only when no spelling of it was typed and
+ * none of its environment names holds a port; a registered adapter's own port
+ * names (`devServer.portEnv`) are read and set with the watcher port's.
+ */
+export function contextPorts(context, tokens, options, env = process.env) {
+    const ports = {};
+    const fill = {};
+    const slotPorts = context.slot?.value ? context.slot.ports : {};
+    for (const { name, option, aliases, read, set, slot } of PORT_OPTIONS) {
+        if (!(option in options))
+            continue;
+        const extra = name === 'watcher' ? adapterPortEnv() : [];
+        const typed = [
+            ...[option, ...aliases]
+                .filter((spelling) => spelling in options)
+                .flatMap((spelling) => optionValues(tokens, spelling)),
+            // A leaf's own port after `--` holds too: no fill competes with it.
+            ...passthroughValues(tokens, [option, ...aliases]),
+        ];
+        if (typed.length > 0) {
+            // The handler picks among the spellings; report the value only when they agree.
+            const values = new Set(typed.map(Number));
+            const [value] = [...values];
+            ports[name] =
+                values.size === 1 && Number.isInteger(value) && value > 0
+                    ? { value: value, source: 'flag' }
+                    : { source: 'flag' };
+            continue;
+        }
+        let invalidEnv;
+        const held = [...read, ...extra].find((key) => {
+            const raw = env[key];
+            if (raw === undefined || raw === '')
+                return false;
+            const port = Number(raw);
+            if (Number.isInteger(port) && port > 0)
+                return true;
+            // Not a port: it holds nothing, and the report shows what was there.
+            invalidEnv ??= { name: key, value: raw };
+            return false;
+        });
+        if (held !== undefined) {
+            ports[name] = { value: Number(env[held]), source: 'env', filled: false };
+            continue;
+        }
+        const fromSlot = slot.map((key) => slotPorts[key]).find((port) => port !== undefined);
+        if (fromSlot === undefined)
+            continue;
+        const names = [...new Set([...set, ...extra])];
+        for (const key of names)
+            fill[key] = String(fromSlot);
+        ports[name] = {
+            value: fromSlot,
+            source: 'slot',
+            filled: true,
+            via: 'env',
+            names,
+            ...(invalidEnv ? { invalidEnv } : {}),
+        };
+    }
+    return { ...(Object.keys(ports).length > 0 ? { ports } : {}), env: fill };
+}
+// The values `spellings` take after `--` (separate or `=value`), where the
+// command's grammar does not apply and a leaf reads its own arguments.
+function passthroughValues(tokens, spellings) {
+    const divider = tokens.indexOf('--');
+    if (divider === -1)
+        return [];
+    const values = [];
+    const rest = tokens.slice(divider + 1);
+    for (let index = 0; index < rest.length; index += 1) {
+        const token = rest[index] ?? '';
+        for (const spelling of spellings) {
+            if (token === spelling)
+                values.push(rest[index + 1] ?? '');
+            else if (token.startsWith(`${spelling}=`))
+                values.push(token.slice(spelling.length + 1));
+        }
+    }
+    return values;
+}
+/** The one human line: `context: adapter <id> (<source>), target <path> (<source>), slot <id> (<source>)`. */
+export function formatHarnessContext(context) {
+    const adapter = context.adapter
+        ? `adapter ${context.adapter.value} (${context.adapter.source === 'detect'
+            ? `detected: ${context.adapter.detail}`
+            : context.adapter.detail})`
+        : 'adapter none';
+    const parts = [adapter, `target ${context.target.value} (${context.target.detail})`];
+    if (context.slot?.value === null)
+        parts.push(context.slot.detail === 'not-in-pool'
+            ? `slot unknown (not in ${homeRelative(context.slot.poolDir)})`
+            : 'slot unknown (no pool dir)');
+    else if (context.slot)
+        parts.push(`slot ${context.slot.value} (${context.slot.detail})`);
+    const ports = Object.entries(context.ports ?? {}).map(([name, port]) => `${name}${port.value === undefined ? '' : ` ${port.value}`} (${port.source === 'env' ? 'env, not filled' : port.source})`);
+    if (ports.length > 0)
+        parts.push(`ports ${ports.join(', ')}`);
+    if (context.ignoredBinding)
+        parts.push(`binding ignored (belongs to ${context.ignoredBinding.repoRoot ?? 'an unnamed checkout'})`);
+    return `context: ${parts.join(', ')}`;
+}
+function sourced(value, source, detail) {
+    return value === undefined ? undefined : { value, source, detail };
+}
+// The last --adapter, else the adapter of the last --platform, else a first
+// positional that is a platform target (`launch ios`, `launch --json ios`).
+function flagAdapter(tokens, positionals) {
+    const adapter = optionValues(tokens, '--adapter').at(-1);
+    if (adapter !== undefined)
+        return { value: adapter, source: 'flag', detail: '--adapter' };
+    const platform = optionValues(tokens, '--platform').at(-1);
+    if (platform !== undefined)
+        return {
+            value: adapterForPlatform(platform) ?? platform,
+            source: 'flag',
+            detail: '--platform',
+        };
+    const first = positionals ? positionals[0] : tokens[0];
+    if (first !== undefined && !first.startsWith('-') && isPlatformTarget(first))
+        return { value: adapterForPlatform(first) ?? first, source: 'flag', detail: 'positional' };
+    return undefined;
+}
+// Built-ins by their `detect`, plugins by their declaration's: a plugin is
+// never imported to detect it.
+function detectedAdapter(target, declared) {
+    const winner = detectAdapterMatch(target, declared);
+    return winner
+        ? {
+            value: winner.adapter,
+            source: 'detect',
+            detail: winner.matched.join('+'),
+            matched: winner.matched,
+            ...(winner.library ? { library: winner.library } : {}),
+        }
+        : undefined;
+}
+// The Git work tree `dir` is in, or undefined outside one.
+function gitTopLevel(dir) {
+    try {
+        const top = execFileSync('git', ['-C', dir, 'rev-parse', '--show-toplevel'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return top ? fs.realpathSync(top) : undefined;
+    }
+    catch {
+        // Not inside a Git work tree, or no git: the directory answers for itself.
+        return undefined;
+    }
+}
+// The runtime context a run's prepare wrote for this checkout, read where the
+// commands read it: RECIPE_RUNTIME_CONTEXT, else <root>/<runtime dir>, where an
+// explicit --runtime-dir counts before RECIPE_RUNTIME_DIR. A context whose
+// repoRoot is another checkout (an inherited RECIPE_RUNTIME_CONTEXT) binds
+// nothing and is reported; one without repoRoot binds only from inside `root`.
+function readBinding(root, runtimeDir) {
+    let file;
+    let value;
+    try {
+        file =
+            process.env.RECIPE_RUNTIME_CONTEXT ??
+                path.join(root, runtimeDir === undefined
+                    ? recipeRuntimeDir()
+                    : validateRelativeRecipePath('--runtime-dir', runtimeDir), 'agentic-runtime.json');
+        value = JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        // No context, one mid-write, an unreadable one, or a runtime dir the
+        // command will refuse itself: the checkout is unbound.
+        return {};
+    }
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    const runtime = value;
+    const repoRoot = typeof runtime.repoRoot === 'string' ? runtime.repoRoot : undefined;
+    return runtimeContextOwned(root, file, runtime)
+        ? { runtime }
+        : { ignored: { path: file, repoRoot: repoRoot ?? null } };
+}
+/**
+ * Whether the runtime context read from `file` belongs to the checkout `root`:
+ * its `repoRoot` is `root`'s Git top level (real paths), or, without
+ * `repoRoot`, the file sits inside `root`. Anything else is another
+ * checkout's (an inherited RECIPE_RUNTIME_CONTEXT) and describes nothing here.
+ */
+export function runtimeContextOwned(root, file, context) {
+    // The checkout itself, not one nested in it: a clone under <checkout>/temp
+    // has its own top level and inherits nothing.
+    return typeof context.repoRoot === 'string'
+        ? samePath(context.repoRoot, gitTopLevel(root) ?? root)
+        : within(root, file);
+}
+function samePath(left, right) {
+    try {
+        return fs.realpathSync(left) === fs.realpathSync(right);
+    }
+    catch {
+        // A path that does not exist is nobody's checkout.
+        return false;
+    }
+}
+// `dir` with the home directory spelled `~`, for the human line.
+function homeRelative(dir) {
+    const home = os.homedir();
+    return dir === home || dir.startsWith(`${home}${path.sep}`) ? `~${dir.slice(home.length)}` : dir;
+}
+// Whether `inner` is `outer` or inside it, comparing real paths.
+function within(outer, inner) {
+    try {
+        const relative = path.relative(fs.realpathSync(outer), fs.realpathSync(inner));
+        return !(relative === '..' ||
+            relative.startsWith(`..${path.sep}`) ||
+            path.isAbsolute(relative));
+    }
+    catch {
+        // A path that does not exist owns nothing.
+        return false;
+    }
+}
+const RUNTIME_PORTS = ['watcherPort', 'devServerPort', 'metroPort', 'cdpPort'];
+function runtimeSlot(runtime) {
+    if (typeof runtime?.slotId !== 'string' || !runtime.slotId)
+        return undefined;
+    return {
+        value: runtime.slotId,
+        source: 'binding',
+        detail: 'runtime-context',
+        ports: runtimePorts(runtime),
+    };
+}
+function runtimePorts(runtime) {
+    const ports = {};
+    for (const field of RUNTIME_PORTS) {
+        const port = Number(runtime?.[field]);
+        if (runtime?.[field] !== undefined && Number.isInteger(port) && port > 0)
+            ports[field] = port;
+    }
+    return ports;
+}
+// The slot slot-config maps this checkout to, with its own platform (never the
+// pool's) for the adapter step; 'no-pool-dir' when the directory does not read.
+async function poolSlot(target, poolDir, detail) {
+    let real;
+    try {
+        real = fs.realpathSync(target);
+    }
+    catch (error) {
+        // A missing checkout has no slot; any other IO failure is real.
+        if (missing(error))
+            return undefined;
+        throw error;
+    }
+    let match;
+    try {
+        match = await findSlotByRepo(poolDir, real);
+    }
+    catch (error) {
+        // A pool directory that does not exist is none; one that does not read
+        // (EACCES and the like) is a real failure.
+        if (missing(error))
+            return 'no-pool-dir';
+        throw error;
+    }
+    if (!match)
+        return undefined;
+    const ports = {};
+    for (const resource of Object.values(match.slot.resources ?? {})) {
+        for (const [field, value] of Object.entries(resource)) {
+            const port = Number(value);
+            if (/port$/u.test(field) && Number.isInteger(port) && port > 0)
+                ports[field] = port;
+        }
+    }
+    return {
+        slot: {
+            value: match.slot.id,
+            source: 'slot',
+            detail,
+            ...(match.slot.session ? { session: match.slot.session } : {}),
+            poolFile: match.poolFile,
+            ports,
+        },
+        ...(match.slot.platform ? { platform: match.slot.platform } : {}),
+    };
+}
+function missing(error) {
+    const code = error?.code;
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+//# sourceMappingURL=context.js.map