browser-pilot-cli 0.3.0-rc.6 → 0.4.0

package/docs/releases/v0.4.0.md

@@ -0,0 +1,62 @@
+# Browser Pilot 0.4.0
+
+Browser Pilot 0.4.0 introduces protocol 1.3 while preserving protocol 1.0-1.2
+compatibility and the extension-free browser control model.
+
+## Profile identity
+
+- `browser.profiles.list` remains passive and returns neutral, connection-scoped
+  Profile contexts without opening or attaching to identity pages.
+- New `browser.profiles.identify` explicitly creates temporary visible
+  `chrome://version` targets, verifies the reported Profile path against the
+  connected browser `userDataRoot`, reads bounded Chrome Local State metadata,
+  and proves cleanup before returning.
+- Results distinguish `unidentified`, `verified`, and `unavailable`, with
+  structured Profile/account fields and stable failure codes. Identity is
+  cached only for one browser connection generation.
+- `bp profiles --identify [--refresh]` exposes the same behavior. Profile and
+  tab selectors are one-based and may use a uniquely verified Profile name,
+  account name, or email address.
+
+## Agent isolation and vocabulary
+
+- Direct one-shot CLI Agents can set a stable `BROWSER_PILOT_CLIENT_KEY` or
+  `--client-key`; different keys receive distinct Principal, Connection,
+  Workspace, and Lease state while repeated calls with one key reuse it.
+- `bp disconnect` releases only its CLI namespace and cannot stop a Broker that
+  still has another active Lease or embedded Connection.
+- Protocol 1.3 browser discovery uses `userDataRoot` instead of the ambiguous
+  legacy candidate field `profile`.
+- Protocol 1.3 tab inventory uses `selected` for the Lease-local target instead
+  of `active`, which could be mistaken for Chrome foreground focus.
+
+## Page and target isolation
+
+- Browser Pilot no longer injects a controller overlay or other status UI into
+  page DOM. Embedding Hosts may present returned controller identity in
+  Host-owned UI.
+- Chrome and Edge extension pages are excluded from ordinary tab inventory and
+  Profile context evidence.
+- Existing eligible user tabs remain fully controllable; managed-only cleanup
+  still leaves user tabs open.
+
+## Embedding
+
+- The Tenon/OpenClaw-neutral reference adapter negotiates protocol 1.3 and
+  discovers the identity operation through the canonical runtime manifest.
+- One-shot CLI, embedded stdio, local Artifact export, native image results,
+  and protocol 1.0-1.2 compatibility remain supported without a Native SDK,
+  MCP server, or browser extension.
+
+## CLI and distribution contract
+
+- Every non-TTY one-shot failure now includes stable `code` and `retryable`
+  fields. Commander/parser and local input errors use `invalid_argument`, while
+  Broker errors preserve their protocol code and structured remediation.
+- The versioned Agent plugin/skill records CLI `0.4.0` as its tested/minimum
+  version and accepts backward-compatible updates within the declared range. It
+  includes Codex UI metadata plus a machine-readable compatibility manifest.
+- GitHub releases publish the plugin archive and checksum alongside a release
+  index that verifies the npm version, protocol range, and every native asset.
+- Native targets are Apple Silicon macOS, x64 Linux, and x64 Windows. Intel Mac
+  is not supported and no `darwin-x64` asset is published.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-pilot-cli",
-  "version": "0.3.0-rc.6",
+  "version": "0.4.0",
   "description": "CLI tool to control your browser via Chrome DevTools Protocol",
   "repository": "https://github.com/relixiaobo/browser-pilot",
   "type": "module",
@@ -14,6 +14,11 @@
     "build:standalone:js": "tsup --config tsup.standalone.config.ts",
     "build:standalone": "npm run build:standalone:js && node scripts/build-standalone.mjs",
     "package:standalone": "node scripts/package-standalone.mjs",
+    "package:agent-plugin": "node scripts/package-agent-plugin.mjs",
+    "package:release-index": "node scripts/build-release-index.mjs",
+    "release:sync-version": "node scripts/sync-release-version.mjs",
+    "release:check-version": "node scripts/sync-release-version.mjs --check",
+    "version": "node scripts/sync-release-version.mjs",
     "verify:standalone": "node scripts/verify-standalone.mjs",
     "dev": "tsup --watch",
     "start": "node dist/cli.js",
@@ -44,12 +49,7 @@
     "docs/plans/profile-context-routing.md",
     "docs/plans/v0.3.0-stabilization.md",
     "docs/plans/universal-agent-integration.md",
-    "docs/releases/v0.3.0-rc.1.md",
-    "docs/releases/v0.3.0-rc.2.md",
-    "docs/releases/v0.3.0-rc.3.md",
-    "docs/releases/v0.3.0-rc.4.md",
-    "docs/releases/v0.3.0-rc.5.md",
-    "docs/releases/v0.3.0-rc.6.md",
+    "docs/releases/",
     "README.md",
     "LICENSE"
   ],