@scotthuang/agent-knock-knock 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.3.2 - 2026-07-28
+
+### Changed
+
+- Build against the verified OpenClaw `2026.6.5` installation floor so ClawHub reports the package without a minimum-host-version drift warning.
+
+## 0.3.1 - 2026-07-28
+
+### Changed
+
+- Lower the OpenClaw plugin API, Gateway, and npm peer floor to the first verified stable API release, `2026.5.12`, and the normal installation host floor to `2026.6.5`, while continuing to build against `2026.7.1-2`.
+- Add isolated compatibility coverage for the minimum and build-time OpenClaw hosts, plus an explicit failing boundary at `2026.5.10-beta.2`.
+
 ## 0.3.0 - 2026-07-28
 
 ### Added

package/README.md

@@ -45,10 +45,18 @@ The two modes intentionally use different permission models:
 
 Core requirements:
 
-- A Node.js version supported by OpenClaw (Node.js 24.15+ on the 24.x line is recommended for the compatibility floor below)
-- [OpenClaw](https://docs.openclaw.ai/) Gateway and plugin API `2026.7.1-2` or newer
+- A Node.js version supported by your OpenClaw release (Node.js 24 LTS is recommended)
+- [OpenClaw](https://docs.openclaw.ai/) `2026.6.5` or newer
 - At least one authenticated coding agent: Codex, Claude Code, or Cursor
 
+| Compatibility layer | Version | Evidence |
+| --- | --- | --- |
+| Normal OpenClaw installation | `2026.6.5`+ | The packed plugin installs, loads, registers its full runtime, and passes isolated Gateway workflows. Earlier hosts block AKK's expected local process control in their legacy install-time scanner unless an unsafe override is used. |
+| Plugin API and Gateway | `2026.5.12`+ | This is the first stable release with `api.session.workflow.enqueueNextTurnInjection`. The adjacent tested boundary, `2026.5.10-beta.2`, lacks that API. |
+| Build SDK | `2026.6.5` | The plugin is built against the oldest host supported for normal installation. |
+
+The compatibility suite tests the normal installation floor and the Plugin API boundary with isolated state and the real packed artifact.
+
 ### Install from ClawHub (recommended)
 
 ```bash

package/docs/quickstart-managed-acpx.md

@@ -1,6 +1,6 @@
 # Managed ACPX in 5 Minutes
 
-Use this path for managed background Codex, Claude Code, or Cursor tasks with durable AKK state and callbacks. You need Node.js 24.15+ on the 24.x line, OpenClaw `2026.7.1-2`+, and an authenticated coding-agent CLI.
+Use this path for managed background Codex, Claude Code, or Cursor tasks with durable AKK state and callbacks. You need a Node.js version supported by your OpenClaw release (Node.js 24 LTS recommended), OpenClaw `2026.6.5`+, and an authenticated coding-agent CLI.
 
 ## 1. Install and configure
 

package/docs/quickstart-tmux.md

@@ -1,6 +1,6 @@
 # tmux Bridge in 5 Minutes
 
-Use this path when you want OpenClaw and a human to share the same live Codex or Claude Code terminal. You need Node.js 24.15+ on the 24.x line, OpenClaw `2026.7.1-2`+, tmux, and an authenticated `codex` or `claude` CLI, all running as the same OS user.
+Use this path when you want OpenClaw and a human to share the same live Codex or Claude Code terminal. You need a Node.js version supported by your OpenClaw release (Node.js 24 LTS recommended), OpenClaw `2026.6.5`+, tmux, and an authenticated `codex` or `claude` CLI, all running as the same OS user.
 
 ## 1. Install and configure
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scotthuang/agent-knock-knock",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Control local Codex and Claude Code from OpenClaw, take over the same live tmux session, and run managed ACP tasks through ACPX with Cursor support.",
   "license": "MIT",
   "type": "module",
@@ -36,15 +36,15 @@
       "clawhubSpec": "clawhub:@scotthuang/agent-knock-knock",
       "npmSpec": "@scotthuang/agent-knock-knock",
       "defaultChoice": "clawhub",
-      "minHostVersion": ">=2026.7.1-2"
+      "minHostVersion": ">=2026.6.5"
     },
     "compat": {
-      "pluginApi": ">=2026.7.1-2",
-      "minGatewayVersion": "2026.7.1-2"
+      "pluginApi": ">=2026.5.12",
+      "minGatewayVersion": "2026.5.12"
     },
     "build": {
-      "openclawVersion": "2026.7.1-2",
-      "pluginSdkVersion": "2026.7.1-2"
+      "openclawVersion": "2026.6.5",
+      "pluginSdkVersion": "2026.6.5"
     },
     "release": {
       "publishToClawHub": true,
@@ -77,8 +77,9 @@
     "prepack": "npm run build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "npm run build && node --test dist/test/*.test.js",
-    "clawhub:validate": "npm run build && clawhub package validate . --out .clawhub-validation --openclaw node_modules/openclaw --runtime --allow-execute --no-mock-sdk",
+    "clawhub:validate": "npm run build && clawhub --workdir . package validate . --out .clawhub-validation --openclaw node_modules/openclaw --runtime --allow-execute --no-mock-sdk",
     "clawhub:dry-run": "npm run build && clawhub package publish . --family code-plugin --owner scotthuang --tags latest --dry-run",
+    "compat:openclaw": "npm run build && node scripts/verify-openclaw-compatibility.js",
     "smoke:acpx": "npm run build && node scripts/smoke-acpx.js",
     "smoke:tmux": "npm run build && node scripts/smoke-tmux.js",
     "simulate:architecture": "node scripts/two-claude-weather-test.js --scenario architecture-questions",
@@ -89,7 +90,7 @@
     "node": ">=22.14.0"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.1-2"
+    "openclaw": ">=2026.5.12"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -99,7 +100,7 @@
   "devDependencies": {
     "@types/node": "^22.20.1",
     "clawhub": "0.23.1",
-    "openclaw": "2026.7.1-2",
+    "openclaw": "2026.6.5",
     "typescript": "^7.0.2"
   }
 }