@farmslot/adapter-node 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to `@farmslot/adapter-node` are tracked here.
+
+## Unreleased
+
+- Active-development baseline; add user-facing changes here before release or package publication.
+
+## 0.1.0 - 2026-10-06
+
+- Add the headless Node platform adapter, moved from the metamask-harness `core` adapter. `createNodeAdapter(config)` builds a `PlatformAdapter` with no ports, dev server, logs or launch; the host supplies the id, detection, hints, wording, action set and overlay leaves. `nodeDependencyBlock` checks a Yarn PnP or node_modules install, the bins the actions run (found through the host's `resolveBin`, so readiness asks what execution asks; no bin is required by default) and runtime dependencies, and `runtimeStatus` applies the same check, so doctor reports a checkout whose actions cannot run; `workspaceTsconfigEnv` points tsx at each workspace package's `src`, built or not, so a stale `dist` never runs, and `checkoutWorkspacePackages` takes the package list from the checkout's `workspaces`; `scripts/cleanup.sh --adapter <id>` removes the adapter's overlay.
+- Publish with adapter-sdk 0.5.0 and recipe-runner 0.25.0.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arthur Breton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# @farmslot/adapter-node
+
+A headless Node platform adapter for recipe harnesses, built on `@farmslot/adapter-sdk`. It has
+no app, ports, dev server, logs or launch: installed dependencies are its only runtime signal.
+The host supplies the adapter id, detection, hints and wording, its action set and overlay
+leaves; product checks stay in the host.
+
+```ts
+import { checkoutWorkspacePackages, createNodeAdapter } from '@farmslot/adapter-node';
+
+export const core = createNodeAdapter({
+  id: 'core',
+  detect: { files: (target) => hasFile(target, 'packages/my-controller') },
+  hints: {
+    launch: 'my-harness run <recipe>',
+    relaunch: 'my-harness verify',
+    runtimeProbeRecovery: (target) => `my-harness verify --target ${target}`,
+  },
+  wording: { ready: 'Core is headless; dependencies are installed.' },
+  dependencies: { runtimeDeps: ['immer'], requiredFor: (_target, use) => usesController(use) },
+  workspacePackages: checkoutWorkspacePackages, // or a fixed map: { '@acme/messenger': 'packages/messenger' }
+  actions,
+  harness,
+});
+```
+
+A host adds its own members by spreading the result: `{ ...createNodeAdapter(config), readiness }`.
+
+`runtimeStatus` reads the install through recipe-runner's `depsCheck`, which tracks Yarn's install
+state, so it reports `deps-missing` for an npm or pnpm checkout even after `installCommand` ran.
+Such a host overrides `runtimeStatus` with its own check: `{ ...createNodeAdapter(config), runtimeStatus }`.
+
+Docs: https://farmslot.io/docs/reference/adapter-node
+
+## Source layout
+
+| path                        | owns                                                                                                                 |
+| --------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `src/node-adapter.ts`       | `createNodeAdapter`, its config and wording types, `HEADLESS_FORBIDDEN_FIELDS`                                       |
+| `src/dependencies.ts`       | `nodeDependencyBlock` (Yarn PnP, node_modules, bins via `resolveBin`, runtime deps), `pnpNodeOptions`                |
+| `src/workspace-tsconfig.ts` | `checkoutWorkspacePackages`, `workspaceTsconfig`/`workspaceTsconfigEnv`: tsx paths to each workspace package's `src` |
+| `scripts/cleanup.sh`        | `cleanup.sh --adapter <id> [--target <dir>]`: removes the adapter's overlay directory                                |
+
+`scripts/cleanup.sh` is exported by path (`@farmslot/adapter-node/scripts/cleanup.sh`, also
+`NODE_CLEANUP_SCRIPT`). It honours `RECIPE_HARNESS_ROOT` (default `temp/recipe/harness`) and
+refuses an absolute value or one with `.`/`..` components.
+
+## Maintenance rules
+
+- No product names. Every line the adapter prints can be replaced through `wording` or `hints`.
+- Dependency codes and messages derive from the adapter id (`<ID>_DEPS_MISSING`), so a host keeps
+  its codes by keeping its id.
+- Recipe actions, readiness checks and install scripts stay in the host.
+
+## Local quality
+
+```sh
+yarn workspace @farmslot/adapter-node quality
+```

package/dist/dependencies.d.ts

@@ -0,0 +1,35 @@
+import type { AdapterDependencyBlock } from '@farmslot/adapter-sdk';
+/** Options for {@link nodeDependencyBlock}. */
+export interface NodeDependencyOptions {
+    /** Packages the checkout must resolve at runtime. Default: none. */
+    runtimeDeps?: readonly string[];
+    /** Executables the actions run (e.g. `tsx`). Default: none. */
+    bins?: readonly string[];
+    /**
+     * Finds `bin` for the checkout, or returns null. Pass the resolver execution
+     * uses, so the check and the run agree. Default: `<target>/node_modules/.bin/<bin>`.
+     */
+    resolveBin?(target: string, bin: string): string | null;
+    /** Names the checkout in messages ("<label> dependencies are …"). Default: `node`. */
+    label?: string;
+    /** Code prefix: `<prefix>_DEPS_MISSING`, `<prefix>_DEPS_INCOMPLETE`. Default: the label, upper-cased. */
+    codePrefix?: string;
+    /** The block's next step. Default: {@link yarnInstallCommand}. */
+    installCommand?(target: string): string;
+    /**
+     * The next step when `bin` cannot be found. Default: the install command. A host
+     * whose `resolveBin` looks outside the checkout says how to provide the bin.
+     */
+    missingBinAction?(target: string, bin: string): string;
+}
+/**
+ * Why the checkout at `target` cannot run yet, or null when it can. Under Yarn PnP
+ * the install marker `.pnp.cjs` is the whole check; otherwise node_modules, each
+ * bin, then each runtime dependency.
+ */
+export declare function nodeDependencyBlock(target: string, options?: NodeDependencyOptions): AdapterDependencyBlock | null;
+/** `current` plus `--require <target>/.pnp.cjs` when the checkout is a Yarn PnP install. */
+export declare function pnpNodeOptions(target: string, current: string | undefined): string | undefined;
+/** `cd '<target>' && yarn install --immutable`. */
+export declare function yarnInstallCommand(target: string): string;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../src/dependencies.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAIpE,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxD,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC;;;OAGG;IACH,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,sBAAsB,GAAG,IAAI,CAmD/B;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAM9F;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/dependencies.js

@@ -0,0 +1,104 @@
+// The headless dependency check: a Node checkout can run recipes once Yarn
+// installed it (PnP or node_modules), the tools its actions run are found, and the
+// packages its live scripts import resolve from the checkout.
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+const requireFromPackage = createRequire(import.meta.url);
+/**
+ * Why the checkout at `target` cannot run yet, or null when it can. Under Yarn PnP
+ * the install marker `.pnp.cjs` is the whole check; otherwise node_modules, each
+ * bin, then each runtime dependency.
+ */
+export function nodeDependencyBlock(target, options = {}) {
+    const resolved = path.resolve(target);
+    const label = options.label ?? 'node';
+    const prefix = options.codePrefix ?? label.toUpperCase().replace(/[^A-Z0-9]+/gu, '_');
+    const missing = `${prefix}_DEPS_MISSING`;
+    const incomplete = `${prefix}_DEPS_INCOMPLETE`;
+    const userAction = (options.installCommand ?? yarnInstallCommand)(resolved);
+    const nodeLinker = readYarnNodeLinker(resolved);
+    if (nodeLinker === 'pnp') {
+        if (fs.existsSync(path.join(resolved, '.pnp.cjs')))
+            return null;
+        return {
+            code: missing,
+            message: `${label} dependencies are not installed for Yarn PnP (.pnp.cjs is missing).`,
+            userAction,
+        };
+    }
+    if (!fs.existsSync(path.join(resolved, 'node_modules'))) {
+        return {
+            code: missing,
+            message: nodeLinker === 'node-modules'
+                ? `${label} dependencies are not installed (nodeLinker requires node_modules, but node_modules is missing).`
+                : `${label} dependencies are not installed (node_modules is missing).`,
+            userAction,
+        };
+    }
+    for (const bin of options.bins ?? []) {
+        if (options.resolveBin ? options.resolveBin(resolved, bin) : localBin(resolved, bin))
+            continue;
+        return {
+            code: incomplete,
+            message: options.resolveBin
+                ? `${label} dependencies are incomplete (no ${bin} runtime found for the checkout).`
+                : `${label} dependencies are incomplete (node_modules/.bin/${bin} is missing).`,
+            userAction: options.missingBinAction ? options.missingBinAction(resolved, bin) : userAction,
+        };
+    }
+    for (const dependency of options.runtimeDeps ?? []) {
+        if (!canResolveFromTarget(dependency, resolved)) {
+            return {
+                code: incomplete,
+                message: `${label} dependencies are incomplete (cannot resolve ${dependency} from the target checkout).`,
+                userAction,
+            };
+        }
+    }
+    return null;
+}
+/** `current` plus `--require <target>/.pnp.cjs` when the checkout is a Yarn PnP install. */
+export function pnpNodeOptions(target, current) {
+    if (readYarnNodeLinker(target) !== 'pnp')
+        return current;
+    const pnp = path.join(path.resolve(target), '.pnp.cjs');
+    if (!fs.existsSync(pnp))
+        return current;
+    const pnpOption = `--require ${pnp}`;
+    return current ? `${current} ${pnpOption}` : pnpOption;
+}
+/** `cd '<target>' && yarn install --immutable`. */
+export function yarnInstallCommand(target) {
+    return `cd ${shellQuote(path.resolve(target))} && yarn install --immutable`;
+}
+function canResolveFromTarget(specifier, target) {
+    try {
+        requireFromPackage.resolve(specifier, { paths: [target] });
+        return true;
+    }
+    catch (error) {
+        const code = error.code;
+        // Not found from the checkout is the answer this check asks for.
+        if (code === 'MODULE_NOT_FOUND')
+            return false;
+        // Installed, but its exports offer no require() entry (ESM-only): present.
+        if (code === 'ERR_PACKAGE_PATH_NOT_EXPORTED')
+            return true;
+        throw error;
+    }
+}
+function localBin(target, bin) {
+    const file = path.join(target, 'node_modules/.bin', bin);
+    return fs.existsSync(file) ? file : null;
+}
+function readYarnNodeLinker(target) {
+    const yarnrc = path.join(target, '.yarnrc.yml');
+    if (!fs.existsSync(yarnrc))
+        return undefined;
+    return /^nodeLinker:\s*["']?([^"'\s#]+)["']?/mu.exec(fs.readFileSync(yarnrc, 'utf8'))?.[1];
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/gu, `'\\''`)}'`;
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/dependencies.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { nodeDependencyBlock, type NodeDependencyOptions, pnpNodeOptions, yarnInstallCommand, } from './dependencies.js';
+export { createNodeAdapter, HEADLESS_FORBIDDEN_FIELDS, NODE_CLEANUP_SCRIPT, type NodeAdapterConfig, type NodeAdapterDependencies, type NodeAdapterNotice, type NodeAdapterWording, type NodeDependencyUse, } from './node-adapter.js';
+export { checkoutWorkspacePackages, type WorkspacePackageMap, type WorkspacePackages, type WorkspaceTsconfig, workspaceTsconfig, workspaceTsconfigEnv, type WorkspaceTsconfigEnvOptions, } from './workspace-tsconfig.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,cAAc,EACd,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { nodeDependencyBlock, pnpNodeOptions, yarnInstallCommand, } from './dependencies.js';
+export { createNodeAdapter, HEADLESS_FORBIDDEN_FIELDS, NODE_CLEANUP_SCRIPT, } from './node-adapter.js';
+export { checkoutWorkspacePackages, workspaceTsconfig, workspaceTsconfigEnv, } from './workspace-tsconfig.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAEnB,cAAc,EACd,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,GAMpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EAIzB,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,yBAAyB,CAAC"}

package/dist/node-adapter.d.ts

@@ -0,0 +1,63 @@
+import { type AdapterActions, type AdapterDetect, type AdapterHarness, type AdapterHints, type AdapterRun, type AdapterRuntimeContextSpec, type PlatformAdapter } from '@farmslot/adapter-sdk';
+import { type WorkspacePackages } from './workspace-tsconfig.js';
+/** Absolute path of the shipped overlay cleanup leaf (`cleanup.sh --adapter <id>`). */
+export declare const NODE_CLEANUP_SCRIPT: string;
+/** Runtime-context fields a headless checkout never records: it has no ports or device. */
+export declare const HEADLESS_FORBIDDEN_FIELDS: readonly string[];
+/** A refusal a headless platform prints instead of acting. */
+export interface NodeAdapterNotice {
+    message: string;
+    userAction: string;
+}
+/** Every line the adapter prints. Defaults name the adapter id and its `hints`. */
+export interface NodeAdapterWording {
+    /** `runtimeStatus` reason when dependencies are installed. */
+    ready: string;
+    /** `runtimeStatus` reason otherwise. */
+    notReady: string;
+    /** `devServer.stop`: there is no dev server. */
+    devServerStop: NodeAdapterNotice;
+    /** `launch`: there is nothing to launch. */
+    launch: NodeAdapterNotice;
+}
+/** What a run or one action is about to use, as `run.dependencyBlock` receives it. */
+export type NodeDependencyUse = Parameters<NonNullable<AdapterRun['dependencyBlock']>>[1];
+/** The dependency check `run` and `call` apply before they start. */
+export interface NodeAdapterDependencies {
+    /** Packages the checkout must resolve at runtime. Default: none. */
+    runtimeDeps?: readonly string[];
+    /** Executables the actions run (e.g. `tsx`). Default: none. */
+    bins?: readonly string[];
+    /** Finds a bin for the checkout; pass the resolver execution uses. Default: `<target>/node_modules/.bin`. */
+    resolveBin?(target: string, bin: string): string | null;
+    /** Next step when a bin cannot be found. Default: the install command. */
+    missingBinAction?(target: string, bin: string): string;
+    /** Whether this run or action needs the checkout's dependencies. Default: always. */
+    requiredFor?(target: string, use: NodeDependencyUse): boolean | Promise<boolean>;
+}
+export interface NodeAdapterConfig {
+    /** Registry key and the value of `--adapter`. */
+    id: string;
+    hints: AdapterHints;
+    actions: AdapterActions;
+    harness: AdapterHarness;
+    detect?: AdapterDetect;
+    /** Host run members. A host `dependencyBlock` replaces the built-in check. */
+    run?: AdapterRun;
+    wording?: Partial<NodeAdapterWording>;
+    dependencies?: NodeAdapterDependencies;
+    /**
+     * Workspace packages live adapter scripts import from src: a map, or
+     * `checkoutWorkspacePackages` to take every package the checkout declares.
+     * When set and `actions.tsxLiveScripts` is absent, scripts run under tsx with
+     * `workspaceTsconfigEnv` (`<id>-adapter.tsconfig.json`).
+     */
+    workspacePackages?: WorkspacePackages;
+    /** Next step when dependencies are missing. Default: `yarnInstallCommand`. */
+    installCommand?(target: string): string;
+    /** Default: `HEADLESS_FORBIDDEN_FIELDS`. */
+    runtimeContext?: AdapterRuntimeContextSpec;
+}
+/** A headless `PlatformAdapter`; spread it to add host members. */
+export declare function createNodeAdapter(config: NodeAdapterConfig): PlatformAdapter;
+//# sourceMappingURL=node-adapter.d.ts.map

package/dist/node-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-adapter.d.ts","sourceRoot":"","sources":["../src/node-adapter.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,yBAAyB,EAE9B,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,yBAAyB,CAAC;AAEvF,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,QAAmE,CAAC;AAEpG,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAStD,CAAC;AAEF,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,aAAa,EAAE,iBAAiB,CAAC;IACjC,4CAA4C;IAC5C,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,sFAAsF;AACtF,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1F,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,6GAA6G;IAC7G,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxD,0EAA0E;IAC1E,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACvD,qFAAqF;IACrF,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,8EAA8E;IAC9E,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,yBAAyB,CAAC;CAC5C;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CA+G5E"}

package/dist/node-adapter.js

@@ -0,0 +1,125 @@
+// A headless Node platform: no app, ports, dev server, logs or launch. Installed
+// dependencies are the only runtime signal, and lifecycle commands teach the
+// headless path. The host supplies identity, detection, wording and its action
+// set; product checks stay in the host.
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { defineAdapter, } from '@farmslot/adapter-sdk';
+import { depsCheck } from '@farmslot/recipe-runner/runtime/deps-readiness';
+import { nodeDependencyBlock, yarnInstallCommand } from './dependencies.js';
+import { workspaceTsconfigEnv } from './workspace-tsconfig.js';
+/** Absolute path of the shipped overlay cleanup leaf (`cleanup.sh --adapter <id>`). */
+export const NODE_CLEANUP_SCRIPT = fileURLToPath(new URL('../scripts/cleanup.sh', import.meta.url));
+/** Runtime-context fields a headless checkout never records: it has no ports or device. */
+export const HEADLESS_FORBIDDEN_FIELDS = [
+    'cdpPort',
+    'watcherPort',
+    'metroPort',
+    'devServerPort',
+    'simulator',
+    'simulatorUdid',
+    'adbSerial',
+    'extensionId',
+];
+/** A headless `PlatformAdapter`; spread it to add host members. */
+export function createNodeAdapter(config) {
+    const { id, hints } = config;
+    const installCommand = config.installCommand ?? yarnInstallCommand;
+    const wording = {
+        ready: `${id} is headless; dependencies are installed.`,
+        notReady: `${id} is headless; dependencies are not fully installed.`,
+        devServerStop: {
+            message: `${id} is headless; no dev server runs for a ${id} checkout`,
+            userAction: hints.relaunch,
+        },
+        launch: {
+            message: `${id} is headless; there is nothing to launch.`,
+            userAction: hints.relaunch,
+        },
+        ...config.wording,
+    };
+    const dependencies = config.dependencies ?? {};
+    const dependencyBlockFor = (target) => nodeDependencyBlock(target, {
+        runtimeDeps: dependencies.runtimeDeps,
+        bins: dependencies.bins,
+        resolveBin: dependencies.resolveBin,
+        missingBinAction: dependencies.missingBinAction,
+        label: id,
+        installCommand,
+    });
+    const workspacePackages = config.workspacePackages;
+    return defineAdapter({
+        id,
+        sdkVersion: 1,
+        headless: true,
+        resolveSlotPorts() {
+            // Headless: no ports or device to resolve.
+        },
+        async runtimeStatus(target) {
+            const deps = depsCheck(path.resolve(target));
+            if (deps.status !== 'current') {
+                return {
+                    decision: 'install',
+                    reasonCode: `deps-${deps.status}`,
+                    reasons: [wording.notReady],
+                    nextAction: installCommand(target),
+                    deps: deps.status,
+                };
+            }
+            // Installed is not enough: the actions must find their runtime too, so
+            // doctor and verify report what run and call would refuse.
+            const block = dependencyBlockFor(target);
+            if (block) {
+                return {
+                    decision: 'install',
+                    reasonCode: 'deps-incomplete',
+                    reasons: [wording.notReady, block.message],
+                    nextAction: block.userAction,
+                    deps: deps.status,
+                };
+            }
+            return {
+                decision: 'ready',
+                reasonCode: 'deps-present',
+                reasons: [wording.ready],
+                nextAction: undefined,
+                deps: deps.status,
+            };
+        },
+        devServer: {
+            label: 'dev-server',
+            describe: () => 'no dev server (headless)',
+            stop: () => ({ kind: 'headless', ...wording.devServerStop }),
+        },
+        logSources: () => [],
+        appLogSource: () => null,
+        hints,
+        detect: config.detect,
+        launch: async ({ usage }) => usage(wording.launch.message, wording.launch.userAction),
+        actions: workspacePackages && !config.actions.tsxLiveScripts
+            ? {
+                ...config.actions,
+                tsxLiveScripts: {
+                    env: (projectRoot, tempDir) => workspaceTsconfigEnv(projectRoot, tempDir, {
+                        packages: workspacePackages,
+                        fileName: `${id}-adapter.tsconfig.json`,
+                    }),
+                },
+            }
+            : config.actions,
+        harness: config.harness,
+        runtimeContext: config.runtimeContext ?? { forbiddenFields: HEADLESS_FORBIDDEN_FIELDS },
+        run: {
+            async dependencyBlock(target, use) {
+                const required = dependencies.requiredFor
+                    ? await dependencies.requiredFor(target, use)
+                    : true;
+                if (!required)
+                    return null;
+                return dependencyBlockFor(target);
+            },
+            ...config.run,
+        },
+    });
+}
+//# sourceMappingURL=node-adapter.js.map

package/dist/node-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-adapter.js","sourceRoot":"","sources":["../src/node-adapter.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,6EAA6E;AAC7E,+EAA+E;AAC/E,wCAAwC;AAExC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAOL,aAAa,GAEd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAA0B,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEpG,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAAsB;IAC1D,SAAS;IACT,aAAa;IACb,WAAW;IACX,eAAe;IACf,WAAW;IACX,eAAe;IACf,WAAW;IACX,aAAa;CACd,CAAC;AA6DF,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAC7B,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,kBAAkB,CAAC;IACnE,MAAM,OAAO,GAAuB;QAClC,KAAK,EAAE,GAAG,EAAE,2CAA2C;QACvD,QAAQ,EAAE,GAAG,EAAE,qDAAqD;QACpE,aAAa,EAAE;YACb,OAAO,EAAE,GAAG,EAAE,0CAA0C,EAAE,WAAW;YACrE,UAAU,EAAE,KAAK,CAAC,QAAQ;SAC3B;QACD,MAAM,EAAE;YACN,OAAO,EAAE,GAAG,EAAE,2CAA2C;YACzD,UAAU,EAAE,KAAK,CAAC,QAAQ;SAC3B;QACD,GAAG,MAAM,CAAC,OAAO;KAClB,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;IAC/C,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,EAAE,CAC5C,mBAAmB,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,gBAAgB,EAAE,YAAY,CAAC,gBAAgB;QAC/C,KAAK,EAAE,EAAE;QACT,cAAc;KACf,CAAC,CAAC;IACL,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAEnD,OAAO,aAAa,CAAkB;QACpC,EAAE;QACF,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,IAAI;QAEd,gBAAgB;YACd,2CAA2C;QAC7C,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,MAAM;YACxB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,OAAO;oBACL,QAAQ,EAAE,SAAS;oBACnB,UAAU,EAAE,QAAQ,IAAI,CAAC,MAAM,EAAE;oBACjC,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAC3B,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC;oBAClC,IAAI,EAAE,IAAI,CAAC,MAAM;iBAClB,CAAC;YACJ,CAAC;YACD,uEAAuE;YACvE,2DAA2D;YAC3D,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO;oBACL,QAAQ,EAAE,SAAS;oBACnB,UAAU,EAAE,iBAAiB;oBAC7B,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;oBAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,IAAI,EAAE,IAAI,CAAC,MAAM;iBAClB,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,UAAU,EAAE,cAAc;gBAC1B,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;gBACxB,UAAU,EAAE,SAAS;gBACrB,IAAI,EAAE,IAAI,CAAC,MAAM;aAClB,CAAC;QACJ,CAAC;QAED,SAAS,EAAE;YACT,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,GAAG,EAAE,CAAC,0BAA0B;YAC1C,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;SAC7D;QAED,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE;QACpB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;QAExB,KAAK;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QAErB,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;QAErF,OAAO,EACL,iBAAiB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc;YACjD,CAAC,CAAC;gBACE,GAAG,MAAM,CAAC,OAAO;gBACjB,cAAc,EAAE;oBACd,GAAG,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAC5B,oBAAoB,CAAC,WAAW,EAAE,OAAO,EAAE;wBACzC,QAAQ,EAAE,iBAAiB;wBAC3B,QAAQ,EAAE,GAAG,EAAE,wBAAwB;qBACxC,CAAC;iBACL;aACF;YACH,CAAC,CAAC,MAAM,CAAC,OAAO;QAEpB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,EAAE,eAAe,EAAE,yBAAyB,EAAE;QAEvF,GAAG,EAAE;YACH,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG;gBAC/B,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW;oBACvC,CAAC,CAAC,MAAM,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC;oBAC7C,CAAC,CAAC,IAAI,CAAC;gBACT,IAAI,CAAC,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBAC3B,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YACD,GAAG,MAAM,CAAC,GAAG;SACd;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/workspace-tsconfig.d.ts

@@ -0,0 +1,36 @@
+/** Package name → its directory, relative to the checkout root. */
+export type WorkspacePackageMap = Readonly<Record<string, string>>;
+/** A fixed map, or one read from the checkout (see {@link checkoutWorkspacePackages}). */
+export type WorkspacePackages = WorkspacePackageMap | ((projectRoot: string) => WorkspacePackageMap);
+/** The tsconfig tsx loads through `TSX_TSCONFIG_PATH`. */
+export interface WorkspaceTsconfig {
+    compilerOptions: {
+        baseUrl: string;
+        paths: Record<string, string[]>;
+    };
+}
+/** Options for {@link workspaceTsconfigEnv}. */
+export interface WorkspaceTsconfigEnvOptions {
+    packages: WorkspacePackages;
+    /** File name written under the temp dir. Default: `node-adapter.tsconfig.json`. */
+    fileName?: string;
+}
+/**
+ * Every package the checkout's root `package.json` declares in `workspaces` (an
+ * array or `{ packages }`), by name. A monorepo that moves a dependency into its
+ * workspace (core's `@metamask/utils`) needs no host change. Patterns are literal
+ * directories or `<dir>/*`; any other pattern throws.
+ */
+export declare function checkoutWorkspacePackages(projectRoot: string): WorkspacePackageMap;
+/**
+ * Paths for every package that has `src/index.ts`, built or not; null when no
+ * package has one.
+ */
+export declare function workspaceTsconfig(projectRoot: string, packages: WorkspacePackages): WorkspaceTsconfig | null;
+/**
+ * Write {@link workspaceTsconfig} under `tempDir` and return the environment tsx
+ * runs with: `TSX_TSCONFIG_PATH`, and `NODE_OPTIONS` with the checkout's PnP
+ * loader when it has one. Empty when no package needs mapping.
+ */
+export declare function workspaceTsconfigEnv(projectRoot: string, tempDir: string, options: WorkspaceTsconfigEnvOptions): Promise<NodeJS.ProcessEnv>;
+//# sourceMappingURL=workspace-tsconfig.d.ts.map

package/dist/workspace-tsconfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-tsconfig.d.ts","sourceRoot":"","sources":["../src/workspace-tsconfig.ts"],"names":[],"mappings":"AAYA,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEnE,0FAA0F;AAC1F,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,CAAC,CAAC,WAAW,EAAE,MAAM,KAAK,mBAAmB,CAAC,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC;CACvE;AAED,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CA6BlF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,GAAG,IAAI,CAW1B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAS5B"}

package/dist/workspace-tsconfig.js

@@ -0,0 +1,80 @@
+// Live adapter scripts import a checkout's workspace packages as runtime values.
+// Their package "exports" point at dist/, which an unbuilt checkout lacks and a
+// built one may hold from an older source or build layout. A generated tsconfig
+// paths map points tsx at each package's src instead, so a script always runs the
+// checkout's current code, without building or modifying the checkout.
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { pnpNodeOptions } from './dependencies.js';
+/**
+ * Every package the checkout's root `package.json` declares in `workspaces` (an
+ * array or `{ packages }`), by name. A monorepo that moves a dependency into its
+ * workspace (core's `@metamask/utils`) needs no host change. Patterns are literal
+ * directories or `<dir>/*`; any other pattern throws.
+ */
+export function checkoutWorkspacePackages(projectRoot) {
+    const manifest = JSON.parse(readFileSync(path.join(projectRoot, 'package.json'), 'utf8'));
+    const patterns = Array.isArray(manifest.workspaces)
+        ? manifest.workspaces
+        : (manifest.workspaces?.packages ?? []);
+    const dirs = patterns.flatMap((pattern) => {
+        const parent = pattern.endsWith('/*') ? pattern.slice(0, -2) : undefined;
+        if (/[*!?{[]/u.test(parent ?? pattern)) {
+            throw new Error(`workspace pattern "${pattern}" is not supported; pass workspacePackages as a map.`);
+        }
+        if (parent === undefined)
+            return [pattern];
+        const parentDir = path.join(projectRoot, parent);
+        if (!existsSync(parentDir))
+            return [];
+        return readdirSync(parentDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => path.posix.join(parent, entry.name));
+    });
+    const packages = {};
+    for (const dir of dirs) {
+        const packageJson = path.join(projectRoot, dir, 'package.json');
+        if (!existsSync(packageJson))
+            continue;
+        const { name } = JSON.parse(readFileSync(packageJson, 'utf8'));
+        if (name)
+            packages[name] = dir;
+    }
+    return packages;
+}
+/**
+ * Paths for every package that has `src/index.ts`, built or not; null when no
+ * package has one.
+ */
+export function workspaceTsconfig(projectRoot, packages) {
+    const map = typeof packages === 'function' ? packages(projectRoot) : packages;
+    const paths = {};
+    for (const [name, dir] of Object.entries(map)) {
+        const srcDir = path.join(projectRoot, dir, 'src');
+        if (!existsSync(path.join(srcDir, 'index.ts')))
+            continue;
+        paths[name] = [path.join(srcDir, 'index.ts')];
+        paths[`${name}/*`] = [path.join(srcDir, '*')];
+    }
+    if (Object.keys(paths).length === 0)
+        return null;
+    return { compilerOptions: { baseUrl: projectRoot, paths } };
+}
+/**
+ * Write {@link workspaceTsconfig} under `tempDir` and return the environment tsx
+ * runs with: `TSX_TSCONFIG_PATH`, and `NODE_OPTIONS` with the checkout's PnP
+ * loader when it has one. Empty when no package needs mapping.
+ */
+export async function workspaceTsconfigEnv(projectRoot, tempDir, options) {
+    const tsconfig = workspaceTsconfig(projectRoot, options.packages);
+    if (!tsconfig)
+        return {};
+    const tsconfigPath = path.join(tempDir, options.fileName ?? 'node-adapter.tsconfig.json');
+    await writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`);
+    return {
+        TSX_TSCONFIG_PATH: tsconfigPath,
+        NODE_OPTIONS: pnpNodeOptions(projectRoot, process.env.NODE_OPTIONS),
+    };
+}
+//# sourceMappingURL=workspace-tsconfig.js.map

package/dist/workspace-tsconfig.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@farmslot/adapter-node",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./scripts/cleanup.sh": "./scripts/cleanup.sh",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit --project tsconfig.json",
+    "test": "node ../../scripts/quality/run-tsx-tests.mjs --cwd . --tsconfig tsconfig.json test",
+    "format": "prettier --write --ignore-path ../../.prettierignore .",
+    "format:check": "prettier --check --ignore-path ../../.prettierignore .",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" \"test/**/*.ts\" --fix",
+    "quality": "prettier --check --ignore-path ../../.prettierignore . && eslint \"src/**/*.ts\" \"test/**/*.ts\" && tsc --noEmit --project tsconfig.json && yarn build && yarn test",
+    "build": "yarn workspace @farmslot/adapter-sdk build && rm -rf dist && tsc --project tsconfig.build.json",
+    "prepack": "cd ../.. && node scripts/quality/check-farmslot-package-readiness.mjs --require-changelog --packages @farmslot/adapter-node && yarn workspace @farmslot/adapter-node build",
+    "prepublishOnly": "node ../../scripts/quality/check-farmslot-package-readiness.mjs --publish --packages @farmslot/adapter-node"
+  },
+  "dependencies": {
+    "@farmslot/adapter-sdk": "0.5.0",
+    "@farmslot/recipe-runner": "0.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^10.3.0",
+    "prettier": "^3.8.3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deeeed/farmslot.git",
+    "directory": "packages/adapter-node"
+  },
+  "bugs": {
+    "url": "https://github.com/deeeed/farmslot/issues"
+  },
+  "license": "MIT",
+  "homepage": "https://farmslot.io/docs/reference/adapter-node",
+  "keywords": [
+    "farmslot",
+    "recipe",
+    "adapter",
+    "node",
+    "headless",
+    "agentic-engineering"
+  ],
+  "files": [
+    "README.md",
+    "LICENSE",
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "dist/**/*.js.map",
+    "scripts/*.sh"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/cleanup.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# cleanup.sh: remove a headless adapter's recipe-harness overlay.
+#
+# Inputs: --adapter <id> (required); --target <checkout> (default $PWD);
+#         env RECIPE_HARNESS_ROOT (checkout-relative, default temp/recipe/harness).
+# Outputs: removes <target>/<harness root>/<id>.
+# Exit: 0 cleaned (idempotent); 1 invalid RECIPE_HARNESS_ROOT; 2 bad args.
+# Never touches: product files. A headless install patches nothing in the
+# checkout, so there are no backups to restore; a missing overlay is a success.
+set -euo pipefail
+
+ADAPTER=""
+TARGET="$PWD"
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --adapter|--target)
+      [ "$#" -ge 2 ] || { echo "cleanup.sh: $1 needs a value" >&2; exit 2; }
+      if [ "$1" = --adapter ]; then ADAPTER="$2"; else TARGET="$2"; fi
+      shift 2 ;;
+    -h|--help) echo "Usage: cleanup.sh --adapter <id> [--target <checkout>]"; exit 0 ;;
+    *) echo "Unknown arg: $1" >&2; exit 2 ;;
+  esac
+done
+
+case "$ADAPTER" in
+  "") echo "cleanup.sh: --adapter <id> is required" >&2; exit 2 ;;
+  .|..|*[!A-Za-z0-9._-]*) echo "cleanup.sh: invalid adapter id: '$ADAPTER'" >&2; exit 2 ;;
+esac
+
+# The checkout-relative overlay root. An empty value falls back to the default;
+# a set value must be relative, use a safe charset and have no '.'/'..'
+# components, so a hostile or mistyped value can't make rm -rf leave the target.
+harness_root() {
+  local root="${RECIPE_HARNESS_ROOT:-temp/recipe/harness}"
+  case "$root" in
+    /*) echo "RECIPE_HARNESS_ROOT must be a non-empty relative path: '$root'" >&2; return 1 ;;
+    *[!A-Za-z0-9._/-]*) echo "RECIPE_HARNESS_ROOT may only contain A-Za-z0-9 and . _ / - : '$root'" >&2; return 1 ;;
+  esac
+  local IFS=/ part
+  for part in $root; do
+    case "$part" in
+      .|..) echo "RECIPE_HARNESS_ROOT must not contain '.' or '..' path components: '$root'" >&2; return 1 ;;
+    esac
+  done
+  printf '%s' "$root"
+}
+
+TARGET="$(cd "$TARGET" && pwd)"
+HARNESS_ROOT="$(harness_root)"
+HARNESS_DIR="$TARGET/$HARNESS_ROOT/$ADAPTER"
+
+rm -rf "$HARNESS_DIR"
+echo "Cleaned $ADAPTER recipe harness from $TARGET"