- Update semver to 7.8.6 and tar to 7.5.23 while preserving the supported Node.js runtime and TypeScript compiler line.
Highlights: Reduce packed-host inspection memory and preserve requested runtime capture and SDK compatibility checks.
-
Share one exit cleanup listener across repeated in-process synthetic probe runs, avoiding listener warnings while retaining mock SDK workspaces until exit.
-
Resolve inherited SDK member types with the exact checker so overrides cannot prescribe absent replacements, and stop cyclic named re-exports without failing target inspection.
-
Run the requested runtime capture when
ci --configpoints at a plugin-root config, such as the oneinitwrites, instead of silently skipping it and passing. Thanks @KrasimirKralev. -
Avoid retaining TypeScript documentation trees during SDK usage analysis while preserving JavaScript JSDoc types, host declarations, and inventory evidence.
-
Halve publish-time memory for packed OpenClaw targets, for any OpenClaw release and without per-release data, while producing byte-identical target surfaces and findings. SDK-retirement qualification decides each replacement name from the packed declarations without a type checker: certified available names are exact and certified unavailable names are sound (verified against the full type check for every name spelled in 18 OpenClaw releases and in synthetic future releases with new SDK surface); replacement names computed from template literals over finite unions are enumerated exactly, and names that need TypeScript's assignability still go to the exact reduced type check. Read the few scope facts runtime-import classification needs from eslint-scope's own Referencer with a scope manager that tracks only those names (the full ScopeManager still handles
evalandwith), free each file's import analysis as soon as it is finished so its syntax tree is not promoted by later collections, skip Node's type stripper (whose WebAssembly memory never shrinks) for JavaScript that provably strips to itself, decided from the parse the analysis already needs, stop retaining whole declaration files through names matched out of them, decode large files in one piece instead of as concatenated chunks that V8 later copies, load TypeScript on first use, read SDK-usage files excluded from analysis only when imported, and parse each file once for both runtime-import passes. A CI gate measures the ClawHub publish path, plain and esbuild-bundled, on the large official channel plugins and a synthetic future release against 0.4.5. -
Keep enum-containing TypeScript import classification compatible with Node 26 while preserving source offsets and conservative malformed-source handling.
Highlights: Prevent heap exhaustion when inspecting source hosts and keep hook validation compatible with OpenClaw’s metadata registry.
-
Keep inferred host exports while excluding imports used only by explicitly typed function bodies from SDK analysis, reducing source-target memory use without increasing the heap limit.
-
Read source-host hook names from the exhaustive metadata registry used by current OpenClaw, preserving generated-surface validation after the host removes its separate name array.
Highlights: Give plugin authors usable retirement advice for their selected host and retain underlying errors in failed profile diagnostics.
-
Only prescribe packed-target SDK retirement migrations when the selected host publicly exposes every replacement; resolve declaration exports and runtime type members without treating comments or strings as APIs. Thanks @SebTardif.
-
Preserve bounded process output and truncation metadata for failed runtime and import-loop profile samples so Node version footers cannot hide the underlying exception. Keep existing previews, execution limits, and successful-sample output unchanged.
- Normalize paths at SDK entrypoint and host-declaration reference boundaries on Windows. Preserve runtime ownership, referenced host types, and inventory completeness for published and source plugins, with real Windows report checks in CI.
- Reduce SDK inventory memory use for OpenClaw source targets by using diagnostic-checked host declarations. Keep source intact when exported types require inference and preserve separate plugin inventories.
- Inspect configured nested plugin packages and compiled npm payloads instead of their repository or fixture wrappers. Recognize declared runtime entrypoints in published packages while retaining unresolved metadata as partial coverage.
- Bind each physical copy of bundled dependencies independently so duplicate package identities cannot crash inventory analysis or hide references.
- Follow local callable implementations without expanding unrelated generic signatures. Bound complex provenance analysis per plugin, mark unresolved analysis as partial, and retain direct SDK references and existing deprecation findings after the limit.
- Add a versioned static SDK usage inventory to serialized plugin reports, including supported and deprecated references, runtime/type classifications, evidence, unresolved references and coverage. Associate target registry retirement notices with inventory entries while preserving existing compatibility findings and author-facing filtering. Validate extraction against independently audited core-plugin source fixtures.
-
Report deprecated SDK members from OpenClaw's delegated compatibility records, including shared metadata, with structured
deprecatedApi,replacement, andremoveAfterfields for calm, non-blocking retirement notices. Include the announced December 31, 2026 retirement inventory for packed npm targets used by ClawHub. The removal date is the final compatibility day; existing finding codes and fields are preserved. -
Assert explicit method-scoped Gateway response contracts without skipping handlers or exposing mismatched payloads; preserve default rejection, wire validation, and settlement failures.
-
Let registration and retained callbacks read the supplied capture config through
runtime.config.current()without loading host configuration. -
Avoid type erasure and scope analysis for unrelated literal calls, and process runtime-import markers in linear passes so large plugin sources do not amplify inspection cost.
-
Discover literal SDK imports through stable handles from named Node.js
createRequireimports so deferred registration and retained handlers receive their generated mock modules. Namespace/default factory handles are outside the supported static contract; shadowedrequirecalls now need proven factory provenance. -
Capture plugins that bind asynchronous state stores or inspect optional instance lifecycle capabilities during registration; preserve capture-local singleton factory state and runtime slots across SDK barrels. State operations and singleton lifecycle drains remain explicitly unsupported by capture mocks.
-
Capture namespace SDK imports and published doctor-contract bundles without missing exports; mock doctor descriptors remain inspectable while actual migration execution fails explicitly.
-
Capture synchronous bundled module namespaces with scoped SDK mocks on Node.js 22.15+; preserve named callable capture on Node.js 22.13 and report unsupported namespace capture before loading any module.
-
Clarify that
inspectreports hard breakages without failing unless--checkis passed; usecheckfor CI failure enforcement. Thanks @KrasimirKralev. -
Read OpenClaw manifest contract fields from its canonical key tuple when the manifest type derives its keys through
Partial<Record<...>>, preserving inline object-type parsing for older targets. -
Apply the same canonical key tuple to packed npm targets (
--openclaw-version), where the tuple ships as a declaredreadonlyconst in bundleddist/*.d.ts;manifest-unknown-contractsno longer flags valid keys such astoolson OpenClaw 2026.10.1-beta.1. Fixes #101. Thanks @Bergschloss.
-
Update Acorn to 8.19.0 for current JavaScript parser fixes and Unicode 18 support.
-
Update
eslint-scopeto 9.1.2 and align supported Node.js versions with its Node 22.13 and Node 24 requirements.
-
Reject plugin-controlled entrypoint, source-root, and target-checkout path escapes before filesystem access; preserve explicit operator paths and fixture-suite configuration, and explain how to migrate rejected sibling checkout settings. Thanks @SebTardif.
-
Initialize pnpm/Yarn workflows without querying a package manager before Corepack setup, and install Bun without requiring an npm lockfile in Bun workflows.
-
Capture in-process CPU, memory, event-loop, and active-resource snapshots at workload phase boundaries, preserving signed deltas and process/thread attribution separately from sampled child-process estimates.
-
Preserve mocked Zod enum options so plugins can compose schemas during capture and retained-handler probes.
-
Discover SDK imports in published
.setupruntime modules so ESM and CommonJS entrypoints can capture and execute retained handlers without missing generated SDK files.
- Recognize OpenClaw's declared private-local Plugin SDK subpaths and reserved bundled-plugin imports when inspecting bundled
extensions/*fixtures, while continuing to report those imports for external plugins and genuinely missing SDK aliases. - Treat active OpenClaw conversation-access compat records with present contract tests as target-owned proof instead of repeatedly emitting a P1 Inspector probe backlog advisory.
- Record explicit method-scoped Gateway probe prerequisites before calling handlers that require unavailable host state or live credentials; preserve actual response failures for admitted probes.
- Preserve absent optional strings in SDK mocks and supply a stable runtime config snapshot to Gateway probes instead of inventing configured values or missing host accessors.
- Generate SDK mocks for literal dynamic imports in retained handlers, including their named exports, while excluding TypeScript import types and keeping source inspection aligned with runtime capture.
- Honor the OpenClaw lazy-runtime SDK contract in generated mocks, preserving deferred module loading, shared promise caches, explicit cache clearing, and rejected imports instead of returning callable placeholders.
- Reject invalid batch concurrency instead of reporting success without inspecting any plugins, and preserve relative plugin paths in retained reports so similar directory names cannot overwrite each other's results.
- Preserve error messages from the OpenClaw
error-runtimeSDK subpath in synthetic probes, including lazy CommonJS imports, so Gateway rejections report their actual cause and remain failures. - Keep tool-hook and conversation-privacy contract gaps open when runtime artifacts only capture hook registration. Preserve registration coverage and semantic contract probes.
- Read OpenClaw compatibility records from the explicitly imported
registry-records.tsdata module, avoiding false missing-record findings after the registry split. Preserve inline registries and report missing delegated data as an error.
- Invoke each synthetic Gateway method once, including registrations with options, and validate its first emitted response's JSON wire representation instead of treating any nonthrowing callback as successful. Preserve explicit response authority, returned-payload fallback, deferred replies within the existing deadline, and accepted-only initial responses.
- Bound synthetic callback waits and cancellation, stop dependent probes after a timeout, and supervise CLI capture plus retained callbacks in one child. Validate report shape and counts before delivery while preserving complete failed-row reports, bounded plugin output, and in-process callback identity. Thanks @SebTardif.
- Run
registerServicestart, stop, and dispose probes serially so teardown cannot overlap startup. - Bound real-SDK CLI capture in an owned child, including stalled imports, busy registration, and retained timers. Give in-process capture a finite 30-second default deadline while preserving caller runtime and handler identity; arbitrary in-process JavaScript cannot be forcibly canceled. Thanks @SebTardif.
- Capture and synthetically probe compiled CommonJS plugins with generated SDK mocks, including lazy
require()calls, and discover their SDK source references. CommonJS mocking requires Node.js 22.15+ synchronous module hooks; the package engine and existing ESM/TypeScript capture remain unchanged. - Bound mock-SDK capture and profile child lifetimes, output, and process sampling; clean owned POSIX descendants through stdio close and keep timeout/cancellation outcomes unsuccessful. Flush complete capture JSON before exiting despite retained plugin timers. Thanks @SebTardif.
- Profile the default import-loop capture runner directly so its timeout also owns plugin execution. Validate fresh, bounded capture artifacts; RSS/CPU and wall-time measurements now exclude the intermediate CLI wrapper and are not directly comparable with historical profiles.
- Bound OpenClaw npm metadata and tarball downloads with a deadline through response-body reads, reject oversized responses, and release failed downloads. Resolve
latestandbetathrough the small npm dist-tags endpoint before fetching exact-version metadata, keeping the 16 MiB metadata limit usable. - Capture plugins that bind
api.runtime.modelAuthduring registration with credential-free defaults; auth acquisition remains an explicit synthetic failure. - Report absent build output and missing entrypoints before SDK alias blockers in cold-import readiness, preserving build-required totals and all remediation evidence.
- Recognize board widget content kinds, memory prompt preparation, transcript source providers, worker providers, and MCP server connection resolvers as metadata-only synthetic probes without invoking runtime callbacks.
- Recognize compiled CommonJS plugin factory calls when checking expected channel registrations, preserving source references and excluding factory values passed to wrappers.
- Classify widget presenters as metadata-only synthetic probes without invoking presentation callbacks.
- Mask source comments in spans so inspecting large bundled JavaScript stays within serverless memory limits while preserving source offsets and findings.
- Finish OpenClaw target archive extraction before cleanup so strict extraction errors cannot race unfinished filesystem writes.
- Refresh Crabbox hydration tooling to pnpm 11.24.0 and pnpm/action-setup 6.0.10.
- Update the code-scanning example to CodeQL's Node 24-based SARIF upload action.
- Preserve record predicate and coercion contracts in generated SDK mocks so schema-aware plugin imports cannot recurse through primitive values.
- Read raw plugin manifest fields from packed OpenClaw declarations instead of runtime registry fields, avoiding false unknown-field warnings for supported metadata such as
uiHints.
- Resolve
latest,beta, or exact OpenClaw npm versions for compatibility inspection, reuse prepared targets from cache, and report exact target/source metadata.
- Treat version-derived API removals inside a plugin's declared OpenClaw range as author-facing errors while keeping out-of-range targets informational, including beta eligibility against the upcoming stable version.
- Accept tested minimum OpenClaw host versions below a plugin's build version without reporting package metadata drift.
- Ignore type-only OpenClaw SDK imports when classifying runtime compatibility against a target release.
- Accept
openclaw.runtimeSetupEntryand other paired compiled runtime entrypoints as valid replacements for absent source entrypoints.
- Restore silently-lost manifest contract findings after OpenClaw moved its public manifest types into
manifest-types.ts.
- Refresh generated and repository GitHub Actions workflows to the current checkout, setup-node, upload-artifact, and pnpm/action-setup releases.
- Keep compatibility capture current with OpenClaw's evolving hook, gateway, workspace-linking, blob-store, and Zod runtime surfaces.
- Mock the current plugin blob-store runtime so Diffs and other trusted plugins can be captured without persistent state.
- Parse OpenClaw hook names after their source declaration became private and added a TypeScript
satisfiesconstraint. - Run synthetic gateway lifecycle hooks around ordinary probes while preserving capture indexes and report order, so
gateway_stopteardown cannot invalidate later compatibility checks. - Link isolated plugin workspaces to the OpenClaw checkout without npm normalizing duplicated dependency and peer declarations back to registry ranges.
- Keep mocked Zod schemas chainable through unsupported methods such as
pipe()andcatch().
- Detect deprecated session SDK read/write, file-path, and transcript helpers across source files, packaged
dist/buildartifacts, runtime session APIs, and dynamic SDK imports.
- Write
package.jsonupdates atomically forinit --scriptsandprune-workspace-dev-deps, including symlink-preserving target rewrites and temp-file cleanup on staging failures. Thanks @KrasimirKralev. - Mock the Lark SDK HTTP interceptor surface during runtime capture so Feishu plugin bundles load successfully.
- Detect deprecated
loadSessionStore(...)usage when plugin code calls it through a runtime session API alias.
- Flag deprecated
loadSessionStore(...)whole-store session helper usage as an author-facing deprecation warning while keeping speculative transcript-identity migration rules out of default inspection. Thanks @jalehman.
- Add
authorRemediation.summaryandauthorRemediation.docsUrlguidance to author-facing compatibility issues and Markdown reports. - Add
--author-facingforcheck,ci, andbatchreports while keeping default output complete for internal coverage findings. - Replace the recent
--include-inspector-gapsoption with a clear error pointing to--author-facing.
- Hide maintainer-facing
inspector-gapfindings from author-facingcheck,ci, andbatchoutput by default, with--include-inspector-gapsfor internal coverage reports.
- Classify the latest generated kitchen-sink registrars for meeting notes, node CLI features, hosted media, model catalogs, embedding providers, and session actions.
- Stop classifying package source entrypoints as missing when the published package provides built runtime entrypoints, and collapse SDK alias findings into a single compat-gap row.
- Treat compat-gap issues as reconciled contract coverage for their own compatibility record.
- Count passed synthetic hook probes as runtime coverage so conversation-access and
before_tool_callinspector gaps close when probe artifacts prove them. - Keep mock-SDK synthetic probes in-process so retained hook and registration handlers remain callable, and harden dynamic root SDK mock exports.
- Synthesize nested manifest config samples for optional object settings with required inner shape.
- Populate message and agent lifecycle synthetic hook payloads with the fields telemetry plugins commonly read.
- Resolve plugin manifests from parent directories when runtime capture starts from built
distentrypoints. - Capture CLIs no longer treat
--output,--plugin-root, or--sdkflag values as the positional entrypoint. Thanks @KrasimirKralev. - Mock-SDK TypeScript capture now falls back to Node's strip-only parser on Node 26.
- Accept valid mocked capture output when plugin code leaves
process.exitCodedirty.
- Follow bundled channel
loadBundledEntryExportSyncregistration exports during mocked runtime capture.
- Synthesize manifest config for isolated runtime capture so configured hooks can be observed without credentials.
- Downgrade
registration-capture-gapto advisory severity so missing capture evidence no longer reports as a P1 plugin contract risk.
- Report import-loop RSS and CPU as baseline-adjusted plugin deltas alongside raw subprocess metrics so Crabpot dashboards do not treat harness import cost as plugin runtime cost.
- Include optional OpenClaw loader lifecycle timings for import and full activation when a capture runner provides them.
- Accept plugin install minimum-host floors as supported package metadata.
- Flag unsupported legacy OpenClaw bundle metadata and advertised npm pack blockers.
- Reconcile runtime capture evidence and harden mocked capture paths for downstream fixture reports.
- Add immediate/faster subprocess RSS and CPU sampling plus explicit sample counts so short import-loop reports do not silently publish fake zero-memory metrics.
- Classify
createChatChannelPluginas channel factory metadata in synthetic probe plans so channel-core plugins do not fail as unknown registrars. - Treat
createChatChannelPluginanddefineChannelPluginEntryas channel registration equivalents when validating fixture expectations. - Label runtime profile wall-time summaries as command-median p95 and render missing sampled metrics as
n/a.
- Separate executor-covered platform portability findings from residual findings so downstream structured runners can keep reports blocking only on unhandled risks.
- Sanitize absolute target OpenClaw paths from generated report artifacts and JSON CLI output.
- Normalize the dependency-install inspector finding title to use isolated-workspace wording.
- Treat
openclawpackage dependencies as host-linked workspace inputs instead of isolated dependency-install blockers.
- Classify generated kitchen-sink public registrar coverage in synthetic probe plans so new API-surface fixtures do not fail as unknown execution profiles.
- Preserve runtime capture bindings for callback-based registrations so captured hooks and registrations can resolve their bound callback metadata.
- Add grouped root facades:
pluginRoot,fixtureSuites,staticInspection,reports,contracts,ci,runtime, andsynthetic. - 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.jsbundle. - Add a package-contents release guard for npm tarball entrypoints, examples, and README assets.
- 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.
- Add
--allow-executeas a cross-platform runtime capture opt-in flag. - Add
plugin-inspector init --dry-runfor setup previews. - Add
plugin-inspector init --jsonfor machine-readable setup summaries. - Add
plugin-inspector init --scriptsforplugin:checkandplugin:cipackage 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.
- Make generated runtime CI commands use
--allow-executeinstead of shell-specific inline environment syntax. - Make
plugin-inspector init --cidetectpackageManagerand common lockfiles before generating CI install/run commands. - Make
plugin-inspector initoutput repo-relative file paths and preflight generated files before writing. - Make
plugin-inspector initinfersourceRoot: "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.
- Add package.json
pluginInspectorconfig discovery for plugin-root checks. - Add
plugin-inspector configfor resolved plugin-root config summaries. - Add author-facing
plugin-inspector inspectplugin-root flow. - Add CI-native SARIF and JUnit outputs;
plugin-inspector ciwrites them by default.
- Make generated CI workflows use one
plugin-inspector ci --no-openclaw --runtime --mock-sdkcommand. - Harden runtime capture for string handler registrations, parse-capable config schema helpers, and provider auth/catalog SDK mocks.
- Add reserved bundled-plugin SDK import detection so external plugins get explicit compatibility findings for private OpenClaw SDK shims.
- Add packaged workspace capture and synthetic-probe helper CLIs for generated isolated workspace plans.
- Make
plugin-inspector ciwrite compatibility-backed CI summary artifacts instead of the legacy inventory report. - Default packaged helper captures to the mocked OpenClaw SDK while preserving
--real-sdkopt-in behavior. - Detect the default runtime capture artifact at
reports/plugin-inspector-runtime-capture.json. - Report the actual log count in CLI text summaries.
- Add public SDK subpath mocks, registrar return profiles, richer lifecycle capture probes, and plugin-root
init/--plugin-rootCLI flows.
- Harden runtime capture for TypeScript entrypoints, extensionless local imports, mocked external packages, namespace imports, async output capture, and explicit mock/real SDK lanes.
- Refresh README and CI examples around
npx @openclaw/plugin-inspector check --no-openclawand opt-in runtime capture.
- Refresh npm package docs with the simplified CLI-first README and public API surface cleanup.
Initial public package release for @openclaw/plugin-inspector.
- Plugin-root
plugin-inspector checkcommand with optionalplugin-inspector.config.json. - Static OpenClaw plugin compatibility reports, issue reports, and CI policy summaries.
- Crabpot-compatible fixture-set inspection and report assembly APIs.
- Target OpenClaw surface parsing for compat registry records, hook names, registrar names, SDK exports, and manifest type fields.
- Package metadata, manifest, SDK import, hook, registration, runtime-capture, cold-import, synthetic-probe, runtime-profile, ref-diff, and profile-diff report helpers.
- Optional
PLUGIN_INSPECTOR_EXECUTE_ISOLATED=1 plugin-inspector check --captureruntime registration capture using a temporary mockedopenclaw/plugin-sdk. - Copy-ready config and GitHub Actions examples under
examples/.