@farmslot/recipe-cli 0.4.1 → 0.6.0

package/dist/harness/adapter-plugins.js

@@ -0,0 +1,388 @@
+// Platform adapters a recipe library declares in recipe-library.json `adapters`
+// (ADR L4). A declared adapter loads only when a command selects it: its module
+// resolves inside the library root, is imported, checked against the SDK and
+// composed on the adapter it `extends`, then registered with the host's
+// built-ins. The library digest the run records covers the module.
+//
+// Trust: plugins load only from the operator's libraries (--library, the
+// operator's RECIPE_LIBRARY_PATH or else the personal library, and what the host
+// configures), never from a task-local library beside a recipe or a library the
+// host discovered on its own, so loading one is trusted like installing it. Each
+// plugin's digest binds what the run approves (see `adapterPlugin`), the plugin
+// may import from disk only the files that digest covers (plugin-imports.ts),
+// and `adapterPluginChecks` names it in the doctor report.
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { ADAPTER_SDK_VERSION, } from '@farmslot/adapter-sdk';
+import { digestLibraryAdapter, libraryAdapterFiles, parseRecipeLibraryPath, personalRecipeLibraryRoot, readRecipeLibraryManifest, RECIPE_LIBRARY_MANIFEST_FILE, RecipeTrustError, resolveRecipeLibrarySources, } from '@farmslot/recipe-runner';
+import { adapterForPlatform, harnessAdapters } from './adapters.js';
+import { harnessHost } from './host.js';
+import { CliError, isRecord } from './parse-args.js';
+import { canFencePluginImports, fencePluginImports } from './plugin-imports.js';
+import { EXIT } from './shared.js';
+/** A declared adapter that cannot be selected. */
+export class AdapterPluginError extends CliError {
+    constructor(code, message, userAction) {
+        super(message, EXIT.usage);
+        this.name = 'AdapterPluginError';
+        this.code = code;
+        this.userAction = userAction;
+    }
+}
+/**
+ * Every adapter id `--adapter` accepts: the registered adapters, then the ids
+ * the libraries declare (`declaredAdapterIds`). Reads recipe-library.json only;
+ * imports nothing. The libraries are resolved as recipes resolve them: `libraries`
+ * (--library), then RECIPE_LIBRARY_PATH entries they don't rename, else the
+ * personal library; then `configured`.
+ */
+export function adapterChoices(libraries = [], options = {}) {
+    const sources = withConfigured(librarySourcesSync(libraries, options.env), options.configured);
+    return [...new Set([...harnessAdapters().list(), ...declaredAdapterIds(sources)])];
+}
+/**
+ * The adapter ids these libraries declare in recipe-library.json `adapters`,
+ * read without importing anything. A library without a readable manifest
+ * declares nothing here; selecting one of its adapters reports the error.
+ */
+export function declaredAdapterIds(sources) {
+    return [...new Set(sources.flatMap((source) => declaredIdsIn(source.root)))];
+}
+/**
+ * The adapter a command's tokens select, the way commands resolve it: the last
+ * `--adapter`, else the adapter of the last `--platform`. Tokens after `--` are
+ * passthrough and select nothing.
+ */
+export function selectedAdapterId(tokens) {
+    return (lastOptionValue(tokens, '--adapter') ??
+        adapterForPlatform(lastOptionValue(tokens, '--platform')));
+}
+/** The plugin the loader registered under `id` in the host's registry, if any. */
+export function adapterPlugin(id) {
+    return loadedInto(harnessAdapters()).get(id);
+}
+/** Every plugin the loader registered in the host's registry, in load order. */
+export function loadedAdapterPlugins() {
+    return [...loadedInto(harnessAdapters()).values()];
+}
+/**
+ * One passing, non-required doctor check per loaded plugin, naming its library,
+ * module and digest, so the report shows which plugin code this process runs.
+ */
+export function adapterPluginChecks() {
+    return loadedAdapterPlugins().map((plugin) => ({
+        id: `adapter-plugin:${plugin.id}`,
+        status: 'pass',
+        required: false,
+        message: `adapter ${plugin.id} is loaded from library ${plugin.library} (${plugin.module}), ${plugin.digest}`,
+        detail: plugin.root,
+    }));
+}
+/**
+ * Make `id` resolvable: a no-op for an absent id or a registered one, else load
+ * the one declaration for it (and what it extends) and register it. A built-in
+ * id that a library also declares is a conflict.
+ */
+export async function ensureAdapterLoaded(id, options = {}) {
+    if (id === undefined)
+        return;
+    const registry = harnessAdapters();
+    if (loadedInto(registry).has(id))
+        return;
+    if (registry.has(id)) {
+        // A built-in: refuse a library that claims its id; never block it on a library error.
+        const claims = (await declarations(options, { lenient: true })).filter((d) => d.id === id);
+        if (claims.length > 0)
+            throw builtinConflict(id, claims);
+        return;
+    }
+    const declared = await declarations(options, { lenient: false });
+    // An id nobody declares is left to the command's own adapter validation.
+    if (!declared.some((declaration) => declaration.id === id))
+        return;
+    await load(id, declared, options, []);
+}
+/** The plugins the loader registered, per host registry. */
+const loaded = new WeakMap();
+function loadedInto(registry) {
+    let plugins = loaded.get(registry);
+    if (!plugins)
+        loaded.set(registry, (plugins = new Map()));
+    return plugins;
+}
+async function load(id, declared, options, chain) {
+    const registry = harnessAdapters();
+    if (registry.has(id)) {
+        const claims = declared.filter((d) => d.id === id);
+        if (!loadedInto(registry).has(id) && claims.length > 0)
+            throw builtinConflict(id, claims);
+        return registry.get(id);
+    }
+    const claims = declared.filter((d) => d.id === id);
+    if (claims.length === 0) {
+        // Only an `extends` reaches here: ensureAdapterLoaded loads declared ids.
+        throw new AdapterPluginError('ADAPTER_EXTENDS_UNKNOWN', `adapter '${chain.at(-1)}' extends '${id}', which no registered adapter or library declares.`, `register '${id}' or put the library that declares it on RECIPE_LIBRARY_PATH`);
+    }
+    if (claims.length > 1)
+        throw new AdapterPluginError('ADAPTER_ID_CONFLICT', `adapter '${id}' is declared by more than one library: ${claims.map((d) => d.library).join(', ')}.`, `keep '${id}' in one library on RECIPE_LIBRARY_PATH`);
+    if (chain.includes(id))
+        throw new AdapterPluginError('ADAPTER_EXTENDS_UNKNOWN', `adapter '${id}' extends itself through ${[...chain, id].join(' → ')}.`, 'break the extends cycle in recipe-library.json');
+    const declaration = claims[0];
+    const parent = declaration.extends
+        ? await load(declaration.extends, declared, options, [...chain, id])
+        : undefined;
+    // The digest is taken before the import, so it covers the code that loads.
+    const digest = await pluginDigest(declaration, loadedInto(registry).get(declaration.extends ?? ''));
+    const plugin = await importDeclared(declaration);
+    const composed = parent ? composeAdapter(parent, plugin) : plugin;
+    assertAdapterMembers(composed, declaration);
+    const adopted = options.adopt ? options.adopt(composed) : composed;
+    registry.register(adopted);
+    loadedInto(registry).set(id, {
+        id,
+        library: declaration.library,
+        root: declaration.root,
+        module: declaration.module,
+        ...(declaration.extends ? { extends: declaration.extends } : {}),
+        digest,
+    });
+    return adopted;
+}
+async function pluginDigest(declaration, parent) {
+    const files = await digestLibraryAdapter(declaration.root, declaration);
+    const identity = [
+        declaration.library,
+        fs.realpathSync(declaration.root),
+        declaration.id,
+        files,
+        parent?.digest ?? '',
+    ].join('\0');
+    return `sha256:${createHash('sha256').update(identity).digest('hex')}`;
+}
+async function importDeclared(declaration) {
+    // recipe-library.json validation already proved the module resolves inside the root.
+    const file = fs.realpathSync(path.resolve(declaration.root, declaration.module));
+    if (!canFencePluginImports())
+        throw new AdapterPluginError('ADAPTER_PLUGIN_LOAD_FAILED', `adapter '${declaration.id}' from library ${declaration.library} needs Node.js 22.15 or later (module.registerHooks fences a plugin's imports); this is ${process.version}.`, 'upgrade Node.js to 22.15 or later');
+    // The plugin may import from disk only the files its digest covers.
+    const covered = await libraryAdapterFiles(declaration.root, declaration);
+    const moduleDir = path.posix.dirname(path
+        .relative(declaration.root, path.resolve(declaration.root, declaration.module))
+        .split(path.sep)
+        .join('/'));
+    const inModuleDir = (relative) => moduleDir === '.' ? !relative.startsWith('actions/') : relative.startsWith(`${moduleDir}/`);
+    const real = (relative) => fs.realpathSync(path.join(declaration.root, relative));
+    fencePluginImports({
+        id: declaration.id,
+        library: declaration.library,
+        root: fs.realpathSync(declaration.root),
+        moduleFiles: new Set(covered.filter(inModuleDir).map(real)),
+        files: new Set(covered.map(real)),
+        hostURL: pathToFileURL(path.join(harnessHost().packageRoot, 'package.json')).href,
+        hostRoot: fs.realpathSync(harnessHost().packageRoot),
+    });
+    let module;
+    try {
+        module = (await import(pathToFileURL(file).href));
+    }
+    catch (error) {
+        // The fence's refusal keeps its code: the plugin imports code its digest misses.
+        if (error instanceof RecipeTrustError)
+            throw error;
+        throw new AdapterPluginError('ADAPTER_PLUGIN_LOAD_FAILED', `adapter '${declaration.id}' from library ${declaration.library} failed to load: ${error instanceof Error ? error.message : String(error)}`, `fix ${declaration.module} in ${declaration.root}`);
+    }
+    const exportName = declaration.export ?? 'default';
+    const value = module[exportName];
+    const where = `${declaration.module} (library ${declaration.library})`;
+    if (!isRecord(value))
+        throw new AdapterPluginError('ADAPTER_PLUGIN_INVALID', `adapter '${declaration.id}': ${where} has no ${exportName === 'default' ? 'default export' : `export '${exportName}'`} holding an adapter.`, `export the adapter from ${declaration.module}, or fix "export" in ${RECIPE_LIBRARY_MANIFEST_FILE}`);
+    if (value.id !== declaration.id)
+        throw new AdapterPluginError('ADAPTER_PLUGIN_INVALID', `adapter '${declaration.id}': ${where} exports an adapter with id '${String(value.id)}'.`, `make the adapter's id '${declaration.id}', or declare it under its own id`);
+    if (value.sdkVersion !== ADAPTER_SDK_VERSION)
+        throw new AdapterPluginError('ADAPTER_SDK_UNSUPPORTED', `adapter '${declaration.id}' targets adapter SDK ${String(value.sdkVersion)}; ${harnessHost().name} implements ${ADAPTER_SDK_VERSION}.`, `use a version of library ${declaration.library} built for adapter SDK ${ADAPTER_SDK_VERSION}`);
+    if (value.extends !== undefined && value.extends !== declaration.extends)
+        throw new AdapterPluginError('ADAPTER_PLUGIN_INVALID', `adapter '${declaration.id}' extends '${String(value.extends)}' in code but '${declaration.extends ?? 'nothing'}' in ${RECIPE_LIBRARY_MANIFEST_FILE}.`, `make "extends" in ${RECIPE_LIBRARY_MANIFEST_FILE} match the adapter`);
+    return value;
+}
+/**
+ * `child` on top of `parent`: the child's members replace the parent's, except
+ * three that append, parent first: the action manifests (`actions.manifestPaths`),
+ * the action implementations (`actions.adapters`) and the doctor checks (`doctor`).
+ */
+export function composeAdapter(parent, child) {
+    const parentActions = parent.actions;
+    const childActions = child.actions ?? {};
+    const manifestPaths = (actions) => actions.manifestPaths?.() ?? (actions.manifestPath ? [actions.manifestPath()] : []);
+    return {
+        ...parent,
+        ...child,
+        extends: parent.id,
+        actions: {
+            ...parentActions,
+            ...childActions,
+            manifestPaths: () => [
+                ...new Set([...manifestPaths(parentActions), ...manifestPaths(childActions)]),
+            ],
+            async adapters() {
+                return [
+                    ...((await parentActions.adapters?.()) ?? []),
+                    ...((await childActions.adapters?.()) ?? []),
+                ];
+            },
+        },
+        async doctor(target) {
+            return [
+                ...((await parent.doctor?.(target)) ?? []),
+                ...((await child.doctor?.(target)) ?? []),
+            ];
+        },
+    };
+}
+// What the commands call on every adapter; the SDK types mark the rest optional.
+const REQUIRED_FUNCTIONS = [
+    'resolveSlotPorts',
+    'runtimeStatus',
+    'logSources',
+    'appLogSource',
+    'launch',
+];
+const REQUIRED_OBJECTS = ['devServer', 'hints', 'actions', 'harness', 'runtimeContext'];
+function assertAdapterMembers(adapter, declaration) {
+    const record = adapter;
+    const actions = isRecord(record.actions) ? record.actions : {};
+    const missing = [
+        ...REQUIRED_FUNCTIONS.filter((member) => typeof record[member] !== 'function'),
+        ...REQUIRED_OBJECTS.filter((member) => !isRecord(record[member])),
+        ...(typeof actions.manifestPath === 'function' ? [] : ['actions.manifestPath']),
+        ...(Array.isArray(actions.semantic) ? [] : ['actions.semantic']),
+        ...(isRecord(actions.cdpTarget) ? [] : ['actions.cdpTarget']),
+        ...(typeof record.headless === 'boolean' ? [] : ['headless']),
+    ];
+    if (missing.length > 0)
+        throw new AdapterPluginError('ADAPTER_PLUGIN_INVALID', `adapter '${declaration.id}' from library ${declaration.library} lacks ${missing.join(', ')}.`, declaration.extends
+            ? `add the members to ${declaration.module}`
+            : `add the members to ${declaration.module}, or extend an adapter that has them`);
+}
+function builtinConflict(id, claims) {
+    return new AdapterPluginError('ADAPTER_ID_CONFLICT', `adapter '${id}' is built into ${harnessHost().name}; library ${claims.map((d) => d.library).join(', ')} may not declare it.`, `rename the adapter in ${claims[0].root}/${RECIPE_LIBRARY_MANIFEST_FILE}`);
+}
+async function declarations(options, mode) {
+    // No recipePath: a task-local library beside a recipe never declares adapters.
+    const sources = withConfigured(await resolveRecipeLibrarySources({
+        cliEntries: [...(options.libraries ?? [])],
+        ...(options.env ? { env: options.env } : {}),
+    }), options.configured);
+    const declared = [];
+    for (const source of sources) {
+        let manifest;
+        try {
+            manifest = await readRecipeLibraryManifest(source.root);
+        }
+        catch (error) {
+            // Selecting a built-in only looks for libraries that claim its id, so a
+            // broken library never blocks it; selecting a plugin reports the error.
+            if (mode.lenient)
+                continue;
+            throw error;
+        }
+        for (const [id, declaration] of Object.entries(manifest?.adapters ?? {})) {
+            declared.push({ ...declaration, id, library: libraryName(source), root: source.root });
+        }
+    }
+    return declared;
+}
+function libraryName(source) {
+    return source.name ?? path.basename(source.root);
+}
+/**
+ * `resolveRecipeLibrarySources` without the file system, for the grammar: the
+ * `--library` entries, then the RECIPE_LIBRARY_PATH entries they don't rename,
+ * else the personal library.
+ */
+function librarySourcesSync(libraries, env = process.env) {
+    const flagged = libraries.flatMap((entry) => safeParse(entry));
+    const renamed = new Set(flagged.map(libraryName));
+    const environment = safeParse(env.RECIPE_LIBRARY_PATH ?? '').filter((source) => !renamed.has(libraryName(source)));
+    const explicit = [...flagged, ...environment];
+    if (explicit.length > 0)
+        return explicit;
+    const personal = personalRecipeLibraryRoot(env);
+    return fs.existsSync(personal) ? [{ name: 'personal', root: personal }] : [];
+}
+function withConfigured(sources, configured = []) {
+    const result = [...sources];
+    for (const source of configured) {
+        const present = result.some((existing) => libraryName(existing) === libraryName(source) ||
+            path.resolve(existing.root) === path.resolve(source.root));
+        if (!present)
+            result.push(source);
+    }
+    return result;
+}
+function safeParse(value) {
+    try {
+        return parseRecipeLibraryPath(value);
+    }
+    catch {
+        // A malformed entry adds no adapter ids to the grammar; the command that
+        // resolves its libraries reports RECIPE_LIBRARY_PATH_INVALID itself.
+        return [];
+    }
+}
+function declaredIdsIn(root) {
+    let text;
+    try {
+        text = fs.readFileSync(path.join(root, RECIPE_LIBRARY_MANIFEST_FILE), 'utf8');
+    }
+    catch (error) {
+        // A library without recipe-library.json declares no adapters.
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    try {
+        const value = JSON.parse(text);
+        return isRecord(value) && isRecord(value.adapters) ? Object.keys(value.adapters) : [];
+    }
+    catch {
+        // Invalid JSON declares nothing for the grammar, so `--adapter core` still
+        // validates; selecting a plugin reads the manifest strictly and reports it.
+        return [];
+    }
+}
+function lastOptionValue(tokens, name) {
+    let value;
+    for (let index = 0; index < tokens.length; index += 1) {
+        const token = tokens[index];
+        if (token === '--')
+            break;
+        if (token === name && tokens[index + 1] !== undefined)
+            value = tokens[(index += 1)];
+        else if (token.startsWith(`${name}=`))
+            value = token.slice(name.length + 1);
+    }
+    return value;
+}
+/**
+ * Print a refused adapter selection: the `--json` envelope or the human line.
+ * Takes any error with a `code` and `userAction` (the loader's, and the library
+ * reader's RECIPE_SOURCE_INVALID); returns the exit code.
+ */
+export function adapterSelectionFailureOut(json, command, error) {
+    if (json) {
+        console.log(JSON.stringify({
+            schemaVersion: 1,
+            command,
+            status: 'fail',
+            exitCode: EXIT.usage,
+            error: { code: error.code, message: error.message, userAction: error.userAction },
+        }, null, 2));
+    }
+    else {
+        console.error(`✗ ${harnessHost().name} ${command}: ${error.message}\n  Next: ${error.userAction}`);
+    }
+    return EXIT.usage;
+}
+//# sourceMappingURL=adapter-plugins.js.map

package/dist/harness/adapter-plugins.js.map

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

package/dist/harness/catalog.d.ts

@@ -0,0 +1,71 @@
+import { type RecipeActionManifestDocument, type RecipeExecutionCapability, type RecipeSourceProvenance } from '@farmslot/protocol';
+import type { RecipeLibrarySource } from '@farmslot/recipe-runner';
+import { type ActionMatrixRow } from '../action-catalog.js';
+/** Where one resolved action came from. */
+export interface ActionCapabilitySource {
+    name: string;
+    tier: 'official' | 'personal' | 'team' | 'canonical' | 'task';
+    manifestPath: string;
+    shadows?: string[];
+    trust?: RecipeSourceProvenance['trust'];
+    implementationRoot?: string;
+    digest?: string;
+    resolveDigest?: () => Promise<string>;
+}
+export interface ResolvedActionManifest {
+    manifest: RecipeActionManifestDocument;
+    actionSources: Map<string, ActionCapabilitySource>;
+}
+export interface RecipeCatalog {
+    /** The library the host ships: its source name, root, and the namespace of its action names. */
+    bundledLibrary: {
+        name: string;
+        root: string;
+        actionNamespace: string;
+    };
+    /**
+     * The adapter's action manifest merged across the library sources (the
+     * bundled one last), or the override manifest with its task action root.
+     */
+    resolveActionManifest(adapter: string, overridePath?: string, sources?: readonly RecipeLibrarySource[], taskActionRoot?: string): Promise<ResolvedActionManifest>;
+    /** Throws when the manifest document is invalid. */
+    validateManifest(manifest: RecipeActionManifestDocument): Promise<unknown>;
+    /** The execution capabilities the host enforces for a bundled action. */
+    actionCapabilities(action: string): readonly RecipeExecutionCapability[];
+}
+export interface DescribedAction {
+    name: string;
+    kind: 'official' | 'custom';
+    category: string;
+    description: string;
+    fields: string[];
+    schema?: unknown;
+    examples?: unknown;
+    result_cases?: string[];
+    source: string;
+    sourceTier: ActionCapabilitySource['tier'];
+    sourceManifest: string;
+    shadows: string[];
+    capabilities: RecipeExecutionCapability[];
+}
+/** `--library` arguments that reproduce the non-bundled sources of a lookup. */
+export declare function actionLibraryContextArgs(catalog: RecipeCatalog, librarySources?: readonly RecipeLibrarySource[]): string;
+/** Every action across the registered adapters, with the adapters that declare it. */
+export declare function resolveActionCapabilityMatrix(catalog: RecipeCatalog, librarySources?: readonly RecipeLibrarySource[]): Promise<ActionMatrixRow[]>;
+export declare function describeManifestActions(catalog: RecipeCatalog, manifest: unknown, actionSources?: ReadonlyMap<string, ActionCapabilitySource>): DescribedAction[];
+/**
+ * One action in full, as `actions --action <name>` and `call <action> --help`
+ * print it: the call form, description, source and adapter, risk, result
+ * cases, fields with their types, up to two authored examples, and the first
+ * one as a runnable call with its recipe node. `actionNames` is the adapter's
+ * vocabulary, which decides whether the short name is unambiguous.
+ */
+export declare function renderActionDetail(entry: DescribedAction, adapter: string, target: string, executable: string, actionNames: readonly string[]): string;
+/** The authored example as a human block: the call that runs it and its recipe node. */
+export declare function renderHumanActionExample(entry: DescribedAction, adapter: string, target: string, executable: string): string | undefined;
+/**
+ * A runnable `call` for the action's authored example; `preferredValues` pick
+ * the closest example and override its values.
+ */
+export declare function actionExampleCommand(entry: DescribedAction, adapter: string, target: string, executable: string, preferredValues?: Record<string, unknown>): string | undefined;
+//# sourceMappingURL=catalog.d.ts.map

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

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