@openclaw/plugin-inspector 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## Unreleased
+
+## 0.3.1 - 2026-04-28
+
+### Added
+
+- Add grouped root facades: `pluginRoot`, `fixtureSuites`, `staticInspection`, `reports`, `contracts`, `ci`, `runtime`, and `synthetic`.
+- Expose contract capture, contract coverage, CI rollup, runtime profile, ref/profile diff, import-loop, and synthetic probe helpers from the root package API.
+- Add a release follow-through guard that fails when Crabpot scripts regress to the legacy `advanced.js` bundle.
+- Add a package-contents release guard for npm tarball entrypoints, examples, and README assets.
+
+### Changed
+
+- Move Crabpot integration scripts to the root public API while keeping Crabpot as the fixture corpus and report consumer.
+- Keep generic artifact writing out of the root API; Crabpot-owned runner scripts write their own JSON outputs.
+- Ship the README banner asset in the npm package so the published README does not reference a missing local image.
+- Document the grouped root import path for embedding harnesses without turning the README into a full API dump.
+
+## 0.3.0 - 2026-04-27
+
+### Added
+
+- Add `--allow-execute` as a cross-platform runtime capture opt-in flag.
+- Add `plugin-inspector init --dry-run` for setup previews.
+- Add `plugin-inspector init --json` for machine-readable setup summaries.
+- Add `plugin-inspector init --scripts` for `plugin:check` and `plugin:ci` package scripts.
+- Add public fixture-set report helpers and synthetic probe suite helpers for Crabpot and downstream compatibility suites.
+- Add a Crabpot follow-through release checklist for source refs, package pins, and smoke commands.
+
+### Changed
+
+- Make generated runtime CI commands use `--allow-execute` instead of shell-specific inline environment syntax.
+- Make `plugin-inspector init --ci` detect `packageManager` and common lockfiles before generating CI install/run commands.
+- Make `plugin-inspector init` output repo-relative file paths and preflight generated files before writing.
+- Make `plugin-inspector init` infer `sourceRoot: "src"` from package export maps like `"./src/index.js"`.
+- Improve CLI failure summaries with report artifact paths and top blocking findings.
+- Harden mock SDK capture by keeping generated loader fixtures available until subprocess exit.
+
 ## 0.2.0 - 2026-04-27
 
 ### Added

package/README.md

@@ -18,12 +18,25 @@ npx @openclaw/plugin-inspector
 That runs `check`, writes report artifacts to `reports/`, and exits non-zero
 when compatibility breakages are found.
 
+Package-manager equivalents:
+
+```bash
+pnpm dlx @openclaw/plugin-inspector
+yarn dlx @openclaw/plugin-inspector
+bunx @openclaw/plugin-inspector
+```
+
 Add a local config and GitHub Actions workflow:
 
 ```bash
 npx @openclaw/plugin-inspector init --ci
 ```
 
+`init --ci` detects `packageManager` and common lockfiles. Pass
+`--package-manager pnpm`, `npm`, `yarn`, or `bun` when you want to override it.
+Add `--scripts` to write `plugin:check` and `plugin:ci` package scripts.
+Use `--dry-run` to preview the files first.
+
 Or install it as a dev dependency:
 
 ```bash
@@ -31,6 +44,18 @@ npm install --save-dev @openclaw/plugin-inspector
 npx plugin-inspector check
 ```
 
+With a local dev dependency, prefer package scripts so CI and local checks use
+the same command:
+
+```json
+{
+  "scripts": {
+    "plugin:check": "plugin-inspector inspect --no-openclaw",
+    "plugin:ci": "plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute"
+  }
+}
+```
+
 ## Commands
 
 ```bash
@@ -40,6 +65,8 @@ npx @openclaw/plugin-inspector ci --no-openclaw
 npx @openclaw/plugin-inspector config
 npx @openclaw/plugin-inspector check --plugin-root ./plugins/weather
 npx @openclaw/plugin-inspector init --ci --package-manager pnpm
+npx @openclaw/plugin-inspector init --ci --scripts --dry-run
+npx @openclaw/plugin-inspector init --ci --scripts --dry-run --json
 ```
 
 `check` and `inspect` read the current directory as one plugin unless
@@ -132,7 +159,8 @@ For a single plugin package, the same config can live in `package.json`:
 `.github/workflows/plugin-inspector.yml`. Copy-ready examples also live in
 `examples/plugin-inspector.config.json` and
 `examples/package-json-plugin-inspector.json` and
-`examples/github-actions-plugin-inspector.yml`.
+`examples/github-actions-plugin-inspector.yml`. SARIF/JUnit CI consumption
+examples live alongside them.
 
 ## Runtime Capture
 
@@ -141,9 +169,13 @@ the registrations made during `register(api)`. It is opt-in because it executes
 plugin code:
 
 ```bash
-PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 npx @openclaw/plugin-inspector check --runtime --mock-sdk
+npx @openclaw/plugin-inspector check --runtime --mock-sdk --allow-execute
 ```
 
+`--allow-execute` is the explicit guard for modes that import plugin code. The
+older `PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1` environment guard still works for
+custom harnesses.
+
 By default, runtime capture uses a generated mock for `openclaw/plugin-sdk` and
 common external packages so plugin code can load in clean CI without OpenClaw
 installed. Use `--real-sdk` only when the plugin workspace already has real SDK
@@ -157,7 +189,7 @@ Runtime capture writes:
 You can also capture one entrypoint directly:
 
 ```bash
-PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 plugin-inspector capture ./dist/index.js --mock-sdk
+plugin-inspector capture ./dist/index.js --mock-sdk --allow-execute
 ```
 
 ## CI
@@ -168,7 +200,7 @@ Minimal package scripts:
 {
   "scripts": {
     "plugin:check": "plugin-inspector inspect --no-openclaw",
-    "plugin:ci": "PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 plugin-inspector ci --no-openclaw --runtime --mock-sdk"
+    "plugin:ci": "plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute"
   }
 }
 ```
@@ -193,7 +225,7 @@ jobs:
           node-version: 24
           cache: npm
       - run: npm ci
-      - run: PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 npx @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk
+      - run: npx @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute
       - uses: actions/upload-artifact@v5
         if: always()
         with:
@@ -204,6 +236,15 @@ jobs:
 `ci` writes the normal report, CI summary, SARIF, and JUnit files by default.
 Pass `--no-sarif` or `--no-junit` only if your CI surface cannot consume them.
 
+For GitHub code scanning, use
+`examples/github-actions-code-scanning.yml`; it uploads
+`reports/plugin-inspector.sarif` through CodeQL's SARIF upload action.
+
+For CI test-summary UIs, point JUnit ingestion at
+`reports/plugin-inspector.junit.xml`. Copy-ready GitLab and CircleCI examples
+live in `examples/gitlab-ci-plugin-inspector.yml` and
+`examples/circleci-plugin-inspector.yml`.
+
 ## Fixture Suites
 
 Fixture-set configs are still supported for crabpot-style compatibility suites:
@@ -215,6 +256,26 @@ plugin-inspector report --config crabpot.config.json --out reports
 Use fixture suites when one repo wants to inspect many plugins. Use plugin-root
 `check` for normal plugin CI.
 
+## Library Use
+
+Most plugin repos should use the CLI. Harnesses can import grouped root helpers
+when they need to embed the inspector:
+
+```js
+import { pluginRoot, fixtureSuites, contracts, ci } from "@openclaw/plugin-inspector";
+
+const { report } = await pluginRoot.runCheck({
+  pluginRoot: process.cwd(),
+  openclawPath: false,
+});
+const capture = contracts.buildCapture({ report });
+const summary = await ci.buildSummary({ reports: { compatibility: report } });
+```
+
+The root package groups stable workflows as `pluginRoot`, `fixtureSuites`,
+`staticInspection`, `reports`, `contracts`, `ci`, `runtime`, and `synthetic`.
+Named exports remain available for existing automation.
+
 ## Mocking Model
 
 Default inspection is static, offline, and credential-free. Runtime capture is

package/examples/circleci-plugin-inspector.yml

@@ -0,0 +1,19 @@
+version: 2.1
+
+jobs:
+  plugin-inspector:
+    docker:
+      - image: cimg/node:24.0
+    steps:
+      - checkout
+      - run: npm ci
+      - run: npx @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute
+      - store_test_results:
+          path: reports
+      - store_artifacts:
+          path: reports
+
+workflows:
+  plugin-inspector:
+    jobs:
+      - plugin-inspector

package/examples/github-actions-code-scanning.yml

@@ -0,0 +1,31 @@
+name: plugin-inspector
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+  security-events: write
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 24
+          cache: npm
+      - run: npm ci
+      - run: npx @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute
+      - uses: github/codeql-action/upload-sarif@v3
+        if: always()
+        with:
+          sarif_file: reports/plugin-inspector.sarif
+      - uses: actions/upload-artifact@v5
+        if: always()
+        with:
+          name: plugin-inspector-reports
+          path: reports/plugin-inspector-*

package/examples/github-actions-plugin-inspector.yml

@@ -15,7 +15,7 @@ jobs:
           node-version: 24
           cache: npm
       - run: npm ci
-      - run: PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 npx @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk
+      - run: npx @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute
       - uses: actions/upload-artifact@v5
         if: always()
         with:

package/examples/gitlab-ci-plugin-inspector.yml

@@ -0,0 +1,11 @@
+plugin_inspector:
+  image: node:24
+  script:
+    - npm ci
+    - npx @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute
+  artifacts:
+    when: always
+    paths:
+      - reports/plugin-inspector-*
+    reports:
+      junit: reports/plugin-inspector.junit.xml

package/examples/package-json-plugin-inspector.json

@@ -1,7 +1,7 @@
 {
   "scripts": {
     "plugin:check": "plugin-inspector inspect --no-openclaw",
-    "plugin:ci": "PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 plugin-inspector ci --no-openclaw --runtime --mock-sdk"
+    "plugin:ci": "plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute"
   },
   "pluginInspector": {
     "version": 1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/plugin-inspector",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "private": false,
   "description": "Offline compatibility inspector for OpenClaw plugins.",
   "type": "module",
@@ -36,18 +36,26 @@
     "./ref-diff": "./src/ref-diff.js",
     "./runtime-capture-report": "./src/runtime-capture-report.js",
     "./runtime-profile": "./src/runtime-profile.js",
+    "./synthetic-probe-suite": "./src/synthetic-probe-suite.js",
+    "./synthetic-probes": "./src/synthetic-probes.js",
     "./workspace-plan": "./src/workspace-plan.js"
   },
   "files": [
     "src",
     "examples",
+    "docs/plugin-inspector-banner.jpg",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {
-    "check": "npm test && npm pack --dry-run",
+    "check": "npm test && npm run release:contents",
+    "release:crabpot": "node scripts/check-crabpot-followthrough.mjs",
+    "release:contents": "node scripts/check-package-contents.mjs",
+    "release:plan": "node scripts/release-plan.mjs",
+    "release:readiness": "npm run release:local && npm run release:crabpot",
     "release:local": "npm run check",
+    "release:notes": "node scripts/release-notes.mjs --unreleased",
     "test": "node --test test/*.test.js"
   },
   "keywords": [

package/src/advanced.js

@@ -136,8 +136,10 @@ export {
 } from "./config.js";
 export {
   buildPluginInspectorConfig,
+  defaultInitPackageScripts,
   defaultInitConfigPath,
   defaultInitWorkflowPath,
+  detectPackageManager,
   renderGithubActionsWorkflow,
   writePluginInspectorInit,
 } from "./init.js";
@@ -196,6 +198,7 @@ export {
   validateSyntheticProbePlan,
   writeSyntheticProbePlan,
 } from "./synthetic-probes.js";
+export { buildSyntheticProbePlanFromReport } from "./synthetic-probe-suite.js";
 export {
   buildWorkspacePlan,
   defaultWorkspacePlanOptions,
@@ -203,3 +206,10 @@ export {
   validateWorkspacePlan,
   writeWorkspacePlan,
 } from "./workspace-plan.js";
+export {
+  inspectCompatibilityFixtureSetConfig,
+  renderFixtureSetIssuesReport,
+  renderFixtureSetMarkdownReport,
+  runFixtureSetReport,
+  writeFixtureSetReports,
+} from "./api.js";

package/src/api.js

@@ -1,12 +1,31 @@
 import path from "node:path";
 import { createCaptureApi } from "./capture-api.js";
 import { loadInspectorConfig, loadPluginRootConfig } from "./config.js";
+import { renderCompatibilityIssuesReport, renderCompatibilityMarkdownReport } from "./compatibility-report.js";
 import { writePluginInspectorInit } from "./init.js";
 import { captureEntrypoint } from "./inspector.js";
 import { renderTextSummary, writeCompatibilityReport } from "./report.js";
 import { writeCiOutputArtifacts } from "./ci-outputs.js";
 import { buildRuntimeCaptureReport, writeRuntimeCaptureReport } from "./runtime-capture-report.js";
 import { inspectCompatibilityFixtureSet, inspectFixtureSet } from "./inspector.js";
+import {
+  buildColdImportReadiness,
+  renderColdImportReadinessMarkdown,
+  validateColdImportReadiness,
+  writeColdImportReadiness,
+} from "./cold-import-readiness.js";
+import {
+  buildWorkspacePlan,
+  renderWorkspacePlanMarkdown,
+  validateWorkspacePlan,
+  writeWorkspacePlan,
+} from "./workspace-plan.js";
+import {
+  buildPlatformProbes,
+  renderPlatformProbesMarkdown,
+  validatePlatformProbes,
+  writePlatformProbes,
+} from "./platform-probes.js";
 
 export async function loadPluginConfig(options = {}) {
   if (options.config) {
@@ -35,6 +54,15 @@ export async function inspectFixtureSetConfig(options = {}) {
   return inspectFixtureSet(config, { generatedAt: options.generatedAt });
 }
 
+export async function inspectCompatibilityFixtureSetConfig(options = {}) {
+  const config = await loadFixtureSetConfig(options);
+  return inspectCompatibilityFixtureSet(config, {
+    generatedAt: options.generatedAt,
+    openclawPath: options.openclawPath,
+    targetOpenClaw: options.targetOpenClaw,
+  });
+}
+
 export async function writePluginReports(report, options = {}) {
   return writeCompatibilityReport(report, {
     basename: options.basename,
@@ -45,6 +73,130 @@ export async function writePluginReports(report, options = {}) {
   });
 }
 
+export async function writeFixtureSetReports(report, options = {}) {
+  return writeCompatibilityReport(report, {
+    basename: options.basename,
+    check: options.check,
+    cwd: options.cwd,
+    formatEvidence: options.formatEvidence,
+    issuesBasename: options.issuesBasename,
+    issuesPath: options.issuesPath,
+    issuesTitle: options.issuesTitle,
+    jsonPath: options.jsonPath,
+    markdownPath: options.markdownPath,
+    markdownTitle: options.markdownTitle,
+    outDir: options.outDir,
+    severityLabels: options.severityLabels,
+    title: options.title,
+  });
+}
+
+export function renderFixtureSetMarkdownReport(report, options = {}) {
+  return renderCompatibilityMarkdownReport(report, options);
+}
+
+export function renderFixtureSetIssuesReport(report, options = {}) {
+  return renderCompatibilityIssuesReport(report, options);
+}
+
+export async function runFixtureSetReport(options = {}) {
+  const report = await inspectCompatibilityFixtureSetConfig(options);
+  const paths = options.write === false ? null : await writeFixtureSetReports(report, options);
+  return { report, paths };
+}
+
+export async function buildFixtureSetColdImportReadiness(options = {}) {
+  const config = options.report ? null : await loadFixtureSetConfig(options);
+  const report =
+    options.report ??
+    (await inspectCompatibilityFixtureSet(config, {
+      generatedAt: options.generatedAt,
+      openclawPath: options.openclawPath,
+      targetOpenClaw: options.targetOpenClaw,
+    }));
+
+  return buildColdImportReadiness({
+    ...options,
+    report,
+    rootDir: options.rootDir ?? config?.rootDir ?? options.cwd,
+  });
+}
+
+export function renderFixtureSetColdImportReadinessMarkdown(readiness, options = {}) {
+  return renderColdImportReadinessMarkdown(readiness, options);
+}
+
+export async function writeFixtureSetColdImportReadiness(readiness, options = {}) {
+  return writeColdImportReadiness(readiness, options);
+}
+
+export async function runFixtureSetColdImportReadiness(options = {}) {
+  const readiness = await buildFixtureSetColdImportReadiness(options);
+  const paths = options.write === false ? null : await writeFixtureSetColdImportReadiness(readiness, options);
+  return { readiness, paths };
+}
+
+export async function buildFixtureSetWorkspacePlan(options = {}) {
+  const config = options.report ? null : await loadFixtureSetConfig(options);
+  const report =
+    options.report ??
+    (await inspectCompatibilityFixtureSet(config, {
+      generatedAt: options.generatedAt,
+      openclawPath: options.openclawPath,
+      targetOpenClaw: options.targetOpenClaw,
+    }));
+  const rootDir = options.rootDir ?? config?.rootDir ?? options.cwd;
+  const readiness = options.readiness ?? buildColdImportReadiness({ ...options, report, rootDir });
+
+  return buildWorkspacePlan({
+    ...options,
+    report,
+    readiness,
+    rootDir,
+  });
+}
+
+export function renderFixtureSetWorkspacePlanMarkdown(plan, options = {}) {
+  return renderWorkspacePlanMarkdown(plan, options);
+}
+
+export function validateFixtureSetWorkspacePlan(plan, options = {}) {
+  return validateWorkspacePlan(plan, options);
+}
+
+export async function writeFixtureSetWorkspacePlan(plan, options = {}) {
+  return writeWorkspacePlan(plan, options);
+}
+
+export async function runFixtureSetWorkspacePlan(options = {}) {
+  const plan = await buildFixtureSetWorkspacePlan(options);
+  const paths = options.write === false ? null : await writeFixtureSetWorkspacePlan(plan, options);
+  return { plan, paths };
+}
+
+export async function buildFixtureSetPlatformProbes(options = {}) {
+  const plan = options.plan ?? (await buildFixtureSetWorkspacePlan(options));
+  return buildPlatformProbes({ ...options, plan });
+}
+
+export function renderFixtureSetPlatformProbesMarkdown(report, options = {}) {
+  return renderPlatformProbesMarkdown(report, options);
+}
+
+export function validateFixtureSetPlatformProbes(report, options = {}) {
+  return validatePlatformProbes(report, options);
+}
+
+export async function writeFixtureSetPlatformProbes(report, options = {}) {
+  return writePlatformProbes(report, options);
+}
+
+export async function runFixtureSetPlatformProbes(options = {}) {
+  const report = await buildFixtureSetPlatformProbes(options);
+  const paths = options.write === false ? null : await writeFixtureSetPlatformProbes(report, options);
+  return { report, paths };
+}
+
 export async function runPluginCheck(options = {}) {
   const outDir = options.outDir ?? "reports";
   const config = await loadPluginConfig(options);
@@ -55,8 +207,8 @@ export async function runPluginCheck(options = {}) {
   const mockSdk = options.mockSdk ?? config.capture?.mockSdk ?? true;
 
   if (capture === true) {
-    if (process.env.PLUGIN_INSPECTOR_EXECUTE_ISOLATED !== "1") {
-      throw new Error("runtime capture imports plugin code; rerun with PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 in an isolated workspace");
+    if (!executionAllowed(options)) {
+      throw new Error("runtime capture imports plugin code; rerun with PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 or --allow-execute in an isolated workspace");
     }
     const runtimeCapture = await buildRuntimeCaptureReport({
       mockSdk,
@@ -89,4 +241,18 @@ export async function setupPluginInspector(options = {}) {
   return writePluginInspectorInit(options);
 }
 
-export { createCaptureApi, renderTextSummary, writeCiOutputArtifacts };
+export { createCaptureApi, renderTextSummary, validateColdImportReadiness, writeCiOutputArtifacts };
+
+function executionAllowed(options) {
+  return options.allowExecution === true || process.env.PLUGIN_INSPECTOR_EXECUTE_ISOLATED === "1";
+}
+
+async function loadFixtureSetConfig(options) {
+  if (options.config) {
+    return {
+      ...options.config,
+      rootDir: options.config.rootDir ?? options.rootDir ?? options.cwd ?? process.cwd(),
+    };
+  }
+  return loadInspectorConfig(options.configPath, { cwd: options.cwd ?? options.rootDir });
+}

package/src/capture-api.js

@@ -1,6 +1,6 @@
 export const defaultCaptureApiRegistrarProfiles = {
   registerChannel: {
-    returnValue: ({ args }) => registrationObject(args, { id: "channel" }),
+    returnValue: ({ args }) => channelRegistrationObject(args),
   },
   registerCli: {
     returnValue: ({ args }) => registrationObject(args, { name: "cli" }),
@@ -12,7 +12,7 @@ export const defaultCaptureApiRegistrarProfiles = {
     returnValue: ({ args }) => registrationObject(args, { id: "context-engine" }),
   },
   registerGatewayMethod: {
-    returnValue: ({ args }) => registrationObject(args, { name: "gateway.method" }),
+    returnValue: ({ args }) => gatewayMethodRegistrationObject(args),
   },
   registerHook: {
     returnValue: ({ api }) => api,
@@ -37,9 +37,10 @@ export const defaultCaptureApiRegistrarProfiles = {
   },
   registerService: {
     returnValue: ({ args }) => ({
-      ...registrationObject(args, { name: "service" }),
+      ...registrationObject(args, { id: "service", name: "service" }),
       start: async () => undefined,
       stop: async () => undefined,
+      dispose: async () => undefined,
     }),
   },
   registerSpeechProvider: {
@@ -125,6 +126,7 @@ export function createCaptureApi(options = {}) {
 
 export function createCaptureContext(options = {}) {
   return {
+    registrationMode: options.registrationMode ?? "full",
     config: options.config ?? {},
     logger: options.logger ?? console,
     pluginConfig: options.pluginConfig ?? {},
@@ -142,6 +144,12 @@ export function createCaptureContext(options = {}) {
     },
     gateway: options.gateway ?? {
       baseUrl: "http://127.0.0.1:0",
+      async call(method, params) {
+        return { ok: true, method, params };
+      },
+      respond(ok, result, error) {
+        return { ok, result, ...(error ? { error } : {}) };
+      },
       registerRoute(route) {
         return {
           ...route,
@@ -242,6 +250,36 @@ function registrationObject(args, defaults) {
   return withCallableDefaults({ ...defaults }, callable);
 }
 
+function channelRegistrationObject(args) {
+  const first = args[0];
+  const registration = registrationObject(args, { id: "channel" });
+  if (first?.plugin && typeof first.plugin === "object") {
+    return {
+      ...registration,
+      id: objectId(first.plugin) ?? registration.id,
+      plugin: first.plugin,
+    };
+  }
+  return registration;
+}
+
+function gatewayMethodRegistrationObject(args) {
+  const [method, handler, options] = args;
+  const registration = registrationObject(args, { name: "gateway.method" });
+  if (typeof method !== "string") {
+    return registration;
+  }
+  return {
+    ...registration,
+    name: method,
+    method,
+    handler: typeof handler === "function" ? handler : registration.handler,
+    run: typeof handler === "function" ? handler : registration.run,
+    execute: typeof handler === "function" ? handler : registration.execute,
+    scope: options?.scope ?? registration.scope,
+  };
+}
+
 function firstCallable(args) {
   return args.find((arg) => typeof arg === "function");
 }