@farmslot/adapter-sdk 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -6,6 +6,16 @@ All notable changes to `@farmslot/adapter-sdk` are tracked here.
 
 - Active-development baseline; add user-facing changes here before release or package publication.
 
+## 0.8.0 - 2026-10-09
+
+- Add `adapterDetectFromSpec(spec)` and `AdapterDetectSpec`: the `AdapterDetect` predicates a recipe library's `detect` declaration describes. `remote` matches when the origin URL contains any entry; `files` matches when every path exists (a trailing `/` requires a directory) and package.json lists every `packageDependencies` entry. A path (package.json included) counts only when its real path stays inside the checkout, so a symlink out of it matches nothing.
+- `PlatformAdapter.detect` documents the host rule recipe-cli now applies: any remote match beats any file match, an adapter beats one it extends, and more than one match left is ambiguous (it was registration order).
+- Publish with protocol 0.35.0 and recipe-runner 0.28.0.
+
+## 0.7.2 - 2026-10-09
+
+- Publish with protocol 0.34.0 and recipe-runner 0.27.1 so consumers share one recipe-runner copy. No code change.
+
 ## 0.7.1 - 2026-10-08
 
 - Publish with protocol 0.34.0 and recipe-runner 0.27.0 so consumers share one recipe-runner copy. No code change.

package/dist/detect.d.ts

@@ -0,0 +1,14 @@
+import type { RecipeLibraryAdapterDetect } from '@farmslot/recipe-runner';
+import type { AdapterDetect } from './types.js';
+/** `detect` in a recipe-library.json `adapters` entry. */
+export type AdapterDetectSpec = Readonly<RecipeLibraryAdapterDetect>;
+/**
+ * The predicates a spec describes. `remote` matches when the origin URL contains
+ * any entry. `files` matches when every path exists (a trailing `/` requires a
+ * directory) and package.json lists every `packageDependencies` entry in
+ * dependencies or devDependencies. A path counts only when its real path stays
+ * inside the checkout, so a symlink out of it matches nothing. A predicate with
+ * no entries is left out.
+ */
+export declare function adapterDetectFromSpec(spec: AdapterDetectSpec): AdapterDetect;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AAErE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAe5E"}

package/dist/detect.js

@@ -0,0 +1,74 @@
+// AdapterDetect from data: the predicates a recipe library declares for its
+// adapter plugin in recipe-library.json, which a host matches before it loads
+// the plugin. A built-in adapter may use it too.
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * The predicates a spec describes. `remote` matches when the origin URL contains
+ * any entry. `files` matches when every path exists (a trailing `/` requires a
+ * directory) and package.json lists every `packageDependencies` entry in
+ * dependencies or devDependencies. A path counts only when its real path stays
+ * inside the checkout, so a symlink out of it matches nothing. A predicate with
+ * no entries is left out.
+ */
+export function adapterDetectFromSpec(spec) {
+    const remotes = spec.remote ?? [];
+    const files = spec.files ?? [];
+    const dependencies = spec.packageDependencies ?? [];
+    const detect = {};
+    if (remotes.length > 0)
+        detect.remote = (url) => remotes.some((entry) => url.includes(entry));
+    if (files.length > 0 || dependencies.length > 0) {
+        detect.files = (target) => {
+            if (!files.every((file) => exists(target, file)))
+                return false;
+            if (dependencies.length === 0)
+                return true;
+            const listed = packageDependencies(target);
+            return dependencies.every((name) => listed.has(name));
+        };
+    }
+    return detect;
+}
+// The real path of `file` in the checkout, or undefined when it is missing or
+// resolves outside the checkout.
+function inCheckout(target, file) {
+    try {
+        const root = fs.realpathSync(target);
+        const real = fs.realpathSync(path.join(target, file));
+        const relative = path.relative(root, real);
+        const outside = relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative);
+        return outside ? undefined : real;
+    }
+    catch {
+        // Missing, or unreadable: the checkout does not have it.
+        return undefined;
+    }
+}
+function exists(target, file) {
+    const real = inCheckout(target, file);
+    if (real === undefined)
+        return false;
+    try {
+        return !file.endsWith('/') || fs.statSync(real).isDirectory();
+    }
+    catch {
+        // Removed since: the checkout does not have it.
+        return false;
+    }
+}
+function packageDependencies(target) {
+    const manifest = inCheckout(target, 'package.json');
+    if (manifest === undefined)
+        return new Set();
+    try {
+        const pkg = JSON.parse(fs.readFileSync(manifest, 'utf8'));
+        const names = (value) => value !== null && typeof value === 'object' ? Object.keys(value) : [];
+        return new Set([...names(pkg.dependencies), ...names(pkg.devDependencies)]);
+    }
+    catch {
+        // No package.json, or one that does not parse: no dependencies.
+        return new Set();
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { adapterDetectFromSpec, type AdapterDetectSpec } from './detect.js';
 export { type AdapterRegistry, createAdapterRegistry, defineAdapter } from './registry.js';
 export { ADAPTER_SDK_VERSION, type AdapterActions, type AdapterBrowser, type AdapterCdpTarget, type AdapterConsoleFiles, type AdapterDependencyBlock, type AdapterDetect, type AdapterDevice, type AdapterDeviceLiveView, type AdapterDevices, type AdapterDeviceView, type AdapterDevServer, type AdapterDevServerStop, type AdapterDiagnostics, type AdapterDoctorCheck, type AdapterFailurePatterns, type AdapterFlags, type AdapterHarness, type AdapterHarnessLeaf, type AdapterHarnessVerify, type AdapterHints, type AdapterLaunchContext, type AdapterLogFinding, type AdapterLogSource, type AdapterObservation, type AdapterPaint, type AdapterPinnedFlags, type AdapterPrepare, type AdapterReadiness, type AdapterRecording, type AdapterRun, type AdapterRunPrepareContext, type AdapterRuntimeContextSpec, type AdapterRuntimeStatus, type AdapterSdkVersion, type AdapterUiHarness, type AdapterUiTransport, type CommandEventStream, type CommandOptions, type HealBoundViolation, type HealMutation, type HealPolicy, type HealState, type NativeUiTransport, type NativeUiTransportOptions, type NetworkCaptureBackend, noopStage, type PlatformAdapter, type RecipeNodeEvent, type RecipeRunOptions, type RunObserver, type StageHandle, type StageProgress, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,KAAK,eAAe,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export { adapterDetectFromSpec } from './detect.js';
 export { createAdapterRegistry, defineAdapter } from './registry.js';
 export { ADAPTER_SDK_VERSION, noopStage, } from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,mBAAmB,EA8CnB,SAAS,GAOV,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA0B,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAwB,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,mBAAmB,EA8CnB,SAAS,GAOV,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/adapter-sdk",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,8 +24,8 @@
     "prepublishOnly": "node ../../scripts/quality/check-farmslot-package-readiness.mjs --publish --packages @farmslot/adapter-sdk"
   },
   "dependencies": {
-    "@farmslot/protocol": "0.34.0",
-    "@farmslot/recipe-runner": "0.27.0"
+    "@farmslot/protocol": "0.35.0",
+    "@farmslot/recipe-runner": "0.28.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",