pi-agent-browser-native 0.9.3 → 0.9.5

package/docs/platform-smoke.md

@@ -32,17 +32,17 @@ npm run verify -- platform-smoke run --target ubuntu --suite platform-build
 
 ## Targets
 
-| Target | Crabbox provider | Shell contract | Release status |
-| --- | --- | --- | --- |
-| `macos` | `ssh` static localhost | POSIX shell on macOS | Required |
-| `ubuntu` | `local-container` | POSIX shell in a Docker-compatible local container | Required |
-| `windows-native` | `parallels` | native Windows PowerShell over OpenSSH | Nonblocking for the owner-waived 0.6.16 rollout; otherwise required |
+| Target           | Crabbox provider       | Shell contract                                     | Release status                                                      |
+| ---------------- | ---------------------- | -------------------------------------------------- | ------------------------------------------------------------------- |
+| `macos`          | `ssh` static localhost | POSIX shell on macOS                               | Required                                                            |
+| `ubuntu`         | `local-container`      | POSIX shell in a Docker-compatible local container | Required                                                            |
+| `windows-native` | `parallels`            | native Windows PowerShell over OpenSSH             | Nonblocking for the owner-waived 0.6.16 rollout; otherwise required |
 
 ## Alternate native transports
 
 With maintainer approval, local macOS execution can replace localhost SSH. Routine GitHub Actions has no Windows job; the separate Crabbox/Parallels release target remains as documented above. Record alternate native checks separately from Crabbox SSH or Parallels results. The default `release` and `prepublishOnly` commands still select the Crabbox matrix; record alternate suite evidence separately rather than reporting those commands as passed.
 
-On macOS, run the unchanged commands returned by `buildPlatformBuildCommand('macos', 'pi-agent-browser-native', '24.21.0')` and `buildBrowserDogfoodCommand('macos', '0.38.1', true)` in [`scripts/platform-smoke/targets.mjs`](../scripts/platform-smoke/targets.mjs), serially in a clean private source copy. Use private HOME, npm and Pi settings, and headless browser profiles. No Remote Login or host security change is required.
+On macOS, run the unchanged commands returned by `buildPlatformBuildCommand('macos', 'pi-agent-browser-native', '24.21.0')` and `buildBrowserDogfoodCommand('macos', '0.38.1', true)` in [`scripts/platform-smoke/targets.mjs`](../scripts/platform-smoke/targets.mjs), serially in a clean private source copy. Use private HOME, npm and Pi settings, and headless browser profiles, and clear inherited `PI_*` variables first: a shell started from Pi exports `PI_PACKAGE_DIR` and `PI_MANAGED_CLI`, which make the archived Pi CLI report the host package instead of the locked suite version. No Remote Login or host security change is required.
 
 Retain the exact source head/tree, package and tool versions, native OS/architecture, generated commands, stdout/stderr, every `PLATFORM_*` exit marker, actual Pi registration output, dogfood JSON and verified screenshot. Check the suite assertions below and clean up only the run's processes and temporary files. These alternatives do not waive Ubuntu or any non-platform release check.
 
@@ -80,7 +80,7 @@ PLATFORM_SMOKE_WINDOWS_WORK_ROOT="C:\\crabbox\\pi-agent-browser-native"
 PLATFORM_SMOKE_AUTH_ENV=""
 ```
 
-The Ubuntu target image is derived from `node:24-bookworm`, installs the `agent-browser` version from [`scripts/agent-browser-capability-baseline.mjs`](../scripts/agent-browser-capability-baseline.mjs), installs Debian Chromium plus the upstream Linux WebGPU/Xvfb runtime packages (`libvulkan1`, `mesa-vulkan-drivers`, and `xvfb`) through apt, creates a non-root `circleci` user, and sets `AGENT_BROWSER_EXECUTABLE_PATH=/usr/bin/chromium`. Rebuild it after upstream rebaselining, or override `PLATFORM_SMOKE_UBUNTU_IMAGE` with an equivalent prepared local image. Do not install `agent-browser` ad hoc inside the Ubuntu smoke command; a missing tool is image/template drift.
+The Ubuntu target image is derived from `node:24-bookworm`, installs the `agent-browser` version from [`scripts/agent-browser-capability-baseline.mjs`](../scripts/agent-browser-capability-baseline.mjs), installs Debian Chromium plus the upstream Linux WebGPU/Xvfb runtime packages (`libvulkan1`, `mesa-vulkan-drivers`, and `xvfb`) through apt, copies the official Go 1.27.1 toolchain onto `PATH` so `platform-target` can build the [corrected quality checker](CODE_QUALITY.md), creates a non-root `circleci` user, and sets `AGENT_BROWSER_EXECUTABLE_PATH=/usr/bin/chromium`. Rebuild it after upstream rebaselining, or override `PLATFORM_SMOKE_UBUNTU_IMAGE` with an equivalent prepared local image. Do not install `agent-browser` ad hoc inside the Ubuntu smoke command; a missing tool is image/template drift.
 
 The configured upstream `agent-browser` baseline is imported from [`scripts/agent-browser-capability-baseline.mjs`](../scripts/agent-browser-capability-baseline.mjs). Target-local browser suites verify that exact `agent-browser` version before running. Bake the exact upstream CLI and browser runtime into the Windows template/snapshot for speed and reproducibility; missing or stale Windows `agent-browser` / browser readiness is a blocked setup, not something the smoke command repairs. The Windows browser suite checks the preinstalled browser cache and prewarms one short loopback HTTP URL before the extension harness runs.
 
@@ -89,7 +89,7 @@ The configured upstream `agent-browser` baseline is imported from [`scripts/agen
 Crabbox does not install project runtime tools. The macOS host, Ubuntu image, and Windows template must already provide:
 
 - Node/npm at or above the full Node version declared by `package.json` `engines.node` and used by [`platform-smoke.config.mjs`](../platform-smoke.config.mjs).
-- Git and `tar`.
+- Git, `tar`, and Go (the version `scripts/prepare-quality-checker.mjs` selects) for the `platform-target` corrected-checker build.
 - Upstream `agent-browser` matching this wrapper’s capability baseline. The Ubuntu target gets it from [`scripts/platform-smoke/linux-image/Dockerfile`](../scripts/platform-smoke/linux-image/Dockerfile); the Windows template gets it from the shared `pi-extension-windows-template` snapshot named in [`platform-smoke.config.mjs`](../platform-smoke.config.mjs) (currently `crabbox-ready-ab-0.33.0`, a child of the shared `crabbox-ready` base used by other projects' linked clones).
 - Browser/runtime dependencies needed by upstream `agent-browser`.
 - Native PowerShell and OpenSSH Server on Windows.

package/package.json

@@ -1,122 +1,146 @@
 {
-  "name": "pi-agent-browser-native",
-  "version": "0.9.3",
-  "description": "pi extension that exposes agent-browser as a native tool for browser automation",
-  "type": "module",
-  "author": "Mitch Fultz (https://github.com/fitchmultz)",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "extension",
-    "agent-browser",
-    "browser-automation",
-    "typescript",
-    "npm-package"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/fitchmultz/pi-agent-browser-native.git"
-  },
-  "homepage": "https://github.com/fitchmultz/pi-agent-browser-native#readme",
-  "bugs": {
-    "url": "https://github.com/fitchmultz/pi-agent-browser-native/issues"
-  },
-  "engines": {
-    "node": ">=24.21.0"
-  },
-  "bin": {
-    "pi-agent-browser-config": "scripts/config.mjs",
-    "pi-agent-browser-convert": "scripts/convert-browser-session.mjs",
-    "pi-agent-browser-doctor": "scripts/doctor.mjs"
-  },
-  "files": [
-    "dist",
-    "platform-smoke.config.mjs",
-    "scripts/config.mjs",
-    "scripts/convert-browser-session.mjs",
-    "scripts/doctor.mjs",
-    "scripts/prepare.mjs",
-    "scripts/build.mjs",
-    "scripts/agent-browser-capability-baseline.mjs",
-    "scripts/agent-browser-target.mjs",
-    "scripts/platform-smoke.mjs",
-    "scripts/platform-smoke",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE",
-    "docs/ARCHITECTURE.md",
-    "docs/COMMAND_REFERENCE.md",
-    "docs/ELECTRON.md",
-    "docs/RELEASE.md",
-    "docs/SESSION_STORAGE.md",
-    "docs/platform-smoke.md",
-    "docs/REQUIREMENTS.md",
-    "docs/SUPPORT_MATRIX.md",
-    "docs/TOOL_CONTRACT.md"
-  ],
-  "pi": {
-    "extensions": [
-      "./dist/extensions/agent-browser/index.js"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*",
-    "typebox": "*"
-  },
-  "devDependencies": {
-    "@earendil-works/pi-ai": "1.0.2",
-    "@earendil-works/pi-coding-agent": "1.0.2",
-    "@earendil-works/pi-tui": "1.0.2",
-    "@types/cross-spawn": "6.0.6",
-    "@types/node": "24.19.1",
-    "@types/which": "2.0.2",
-    "tsx": "4.23.15",
-    "typebox": "1.3.27",
-    "typescript": "7.0.2"
-  },
-  "scripts": {
-    "docs": "node ./scripts/project.mjs docs",
-    "doctor": "node ./scripts/doctor.mjs",
-    "check:platform-smoke": "node --check platform-smoke.config.mjs && node --check scripts/platform-smoke.mjs && node --check scripts/platform-smoke/doctor.mjs && node --check scripts/platform-smoke/crabbox-runner.mjs && node --check scripts/platform-smoke/targets.mjs && node --check scripts/platform-smoke/artifacts.mjs && tsx --test test/platform-smoke.test.ts",
-    "smoke:platform": "node scripts/platform-smoke.mjs",
-    "smoke:platform:doctor": "node scripts/platform-smoke.mjs doctor",
-    "smoke:platform:ubuntu-image": "node scripts/platform-smoke/build-ubuntu-image.mjs",
-    "smoke:platform:macos": "node scripts/platform-smoke.mjs run --target macos",
-    "smoke:platform:ubuntu": "node scripts/platform-smoke.mjs run --target ubuntu",
-    "smoke:platform:windows-native": "node scripts/platform-smoke.mjs run --target windows-native",
-    "smoke:platform:all": "npm run smoke:platform:doctor && node scripts/platform-smoke.mjs run --target macos,ubuntu,windows-native",
-    "check:compat": "node scripts/compat-host.mjs && npm run typecheck && npm test && node scripts/verify-package.mjs --smoke-pi",
-    "typecheck": "node ./scripts/project.mjs verify typecheck",
-    "test": "node ./scripts/build.mjs && tsx --test --test-reporter=tap --test-concurrency=1 test/**/*.test.ts",
-    "verify": "node ./scripts/project.mjs verify",
-    "prepublishOnly": "npm run verify -- release && npm pack --dry-run",
-    "build": "node ./scripts/build.mjs",
-    "startup-profile": "node ./scripts/profile-startup.mjs",
-    "prepare": "node ./scripts/prepare.mjs"
-  },
-  "packageManager": "npm@12.2.0",
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
-    "@earendil-works/pi-tui": {
-      "optional": true
-    },
-    "typebox": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "cross-spawn": "7.0.6",
-    "path-key": "3.1.1",
-    "stream-json": "3.7.0",
-    "which": "2.0.2"
-  }
+	"name": "pi-agent-browser-native",
+	"version": "0.9.5",
+	"description": "pi extension that exposes agent-browser as a native tool for browser automation",
+	"type": "module",
+	"author": "Mitch Fultz (https://github.com/fitchmultz)",
+	"keywords": [
+		"pi-package",
+		"pi",
+		"pi-extension",
+		"extension",
+		"agent-browser",
+		"browser-automation",
+		"typescript",
+		"npm-package"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/fitchmultz/pi-agent-browser-native.git"
+	},
+	"homepage": "https://github.com/fitchmultz/pi-agent-browser-native#readme",
+	"bugs": {
+		"url": "https://github.com/fitchmultz/pi-agent-browser-native/issues"
+	},
+	"engines": {
+		"node": ">=24.21.0"
+	},
+	"bin": {
+		"pi-agent-browser-config": "scripts/config.mjs",
+		"pi-agent-browser-convert": "scripts/convert-browser-session.mjs",
+		"pi-agent-browser-doctor": "scripts/doctor.mjs"
+	},
+	"files": [
+		"dist",
+		"platform-smoke.config.mjs",
+		"scripts/config.mjs",
+		"scripts/convert-browser-session.mjs",
+		"scripts/doctor.mjs",
+		"scripts/doctor-sources.mjs",
+		"scripts/prepare.mjs",
+		"scripts/build.mjs",
+		"scripts/agent-browser-capability-baseline.mjs",
+		"scripts/capability-core-commands.mjs",
+		"scripts/capability-options.mjs",
+		"scripts/capability-samples.mjs",
+		"scripts/capability-section.mjs",
+		"scripts/agent-browser-target.mjs",
+		"scripts/platform-smoke.mjs",
+		"scripts/platform-smoke",
+		"README.md",
+		"CHANGELOG.md",
+		"LICENSE",
+		"docs/ARCHITECTURE.md",
+		"docs/CODE_QUALITY.md",
+		"docs/COMMAND_REFERENCE.md",
+		"docs/ELECTRON.md",
+		"docs/RELEASE.md",
+		"docs/REFERENCE.md",
+		"docs/SESSION_STORAGE.md",
+		"docs/platform-smoke.md",
+		"docs/REQUIREMENTS.md",
+		"docs/SUPPORT_MATRIX.md",
+		"docs/TOOL_CONTRACT.md"
+	],
+	"pi": {
+		"extensions": [
+			"./dist/extensions/agent-browser/index.js"
+		]
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-ai": "*",
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*",
+		"typebox": "*"
+	},
+	"devDependencies": {
+		"@earendil-works/pi-ai": "1.0.2",
+		"@earendil-works/pi-coding-agent": "1.0.2",
+		"@earendil-works/pi-tui": "1.0.2",
+		"@types/cross-spawn": "6.0.6",
+		"@types/node": "24.19.1",
+		"@types/which": "2.0.2",
+		"esbuild": "0.28.2",
+		"eslint-node-test": "1.0.1",
+		"oxc-parser": "0.153.0",
+		"oxfmt": "0.72.0",
+		"oxlint": "1.87.0",
+		"oxlint-tsgolint": "7.0.2003",
+		"tsx": "4.23.15",
+		"typebox": "1.3.27",
+		"typescript": "7.0.2"
+	},
+	"scripts": {
+		"lint": "node ./scripts/code-quality.mjs lint",
+		"lint:agent": "node ./scripts/code-quality.mjs lint --format=agent",
+		"lint:fix": "node ./scripts/code-quality.mjs lint --fix",
+		"format": "oxfmt --write .",
+		"format:check": "oxfmt --check .",
+		"quality:scope": "node ./scripts/code-quality.mjs scope",
+		"quality:policy": "node ./scripts/code-quality.mjs check",
+		"quality:probes": "tsx --test --test-concurrency=1 test/code-quality*.test.ts",
+		"quality:mutations": "node ./scripts/verify-quality-mutations.mjs",
+		"quality": "node ./scripts/project.mjs verify quality",
+		"docs": "node ./scripts/project.mjs docs",
+		"doctor": "node ./scripts/doctor.mjs",
+		"check:platform-smoke": "node --check platform-smoke.config.mjs && node --check scripts/platform-smoke.mjs && node --check scripts/platform-smoke/doctor.mjs && node --check scripts/platform-smoke/crabbox-runner.mjs && node --check scripts/platform-smoke/targets.mjs && node --check scripts/platform-smoke/artifacts.mjs && tsx --test test/platform-smoke.test.ts",
+		"smoke:platform": "node scripts/platform-smoke.mjs",
+		"smoke:platform:doctor": "node scripts/platform-smoke.mjs doctor",
+		"smoke:platform:ubuntu-image": "node scripts/platform-smoke/build-ubuntu-image.mjs",
+		"smoke:platform:macos": "node scripts/platform-smoke.mjs run --target macos",
+		"smoke:platform:ubuntu": "node scripts/platform-smoke.mjs run --target ubuntu",
+		"smoke:platform:windows-native": "node scripts/platform-smoke.mjs run --target windows-native",
+		"smoke:platform:all": "npm run smoke:platform:doctor && node scripts/platform-smoke.mjs run --target macos,ubuntu,windows-native",
+		"check:compat": "node scripts/compat-host.mjs && npm run typecheck && npm test && node scripts/verify-package.mjs --smoke-pi",
+		"typecheck": "node ./scripts/project.mjs verify typecheck",
+		"test": "node ./scripts/build.mjs && node ./scripts/prepare-quality-checker.mjs && tsx --test --test-reporter=tap \"test/**/!(*.serial).test.ts\" && tsx --test --test-reporter=tap --test-concurrency=1 \"test/**/*.serial.test.ts\"",
+		"verify": "node ./scripts/project.mjs verify",
+		"prepublishOnly": "npm run verify -- release && npm pack --dry-run",
+		"build": "node ./scripts/build.mjs",
+		"startup-profile": "node ./scripts/profile-startup.mjs",
+		"prepare": "node ./scripts/prepare.mjs"
+	},
+	"packageManager": "npm@12.2.0",
+	"peerDependenciesMeta": {
+		"@earendil-works/pi-ai": {
+			"optional": true
+		},
+		"@earendil-works/pi-coding-agent": {
+			"optional": true
+		},
+		"@earendil-works/pi-tui": {
+			"optional": true
+		},
+		"typebox": {
+			"optional": true
+		}
+	},
+	"dependencies": {
+		"cross-spawn": "7.0.6",
+		"path-key": "3.1.1",
+		"stream-json": "3.7.0",
+		"strip-json-comments": "5.0.3",
+		"which": "2.0.2"
+	}
 }