diff --git a/README.md b/README.md index 8667914..16c53e5 100644 --- a/README.md +++ b/README.md @@ -108,7 +108,7 @@ export CLAUDECODE_HOME="$ISOLATED_ROOT/claudecode-home" export AMP_CLI_HOME="$ISOLATED_ROOT/ampcli-home" cd "$WORKDIR" npm init -y -npm install /opendevbrowser-0.0.33.tgz +npm install /opendevbrowser-0.0.34.tgz npx --no-install opendevbrowser --help npx --no-install opendevbrowser help ``` diff --git a/docs/AGENTS.md b/docs/AGENTS.md index ff8e35a..e784f85 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -64,7 +64,7 @@ When release-gate automation changes: - `docs/RELEASE_RUNBOOK.md` - `docs/EXTENSION_RELEASE_RUNBOOK.md` - `docs/DISTRIBUTION_PLAN.md` -- the current version-scoped release evidence doc (for this release: `docs/RELEASE_0.0.32_EVIDENCE.md`) +- the current version-scoped release evidence doc (for this release: `docs/RELEASE_0.0.34_EVIDENCE.md`) - older ledgers stay historical-only and should receive explicit status clarifications only - automation scripts: - `scripts/audit-zombie-files.mjs` diff --git a/docs/CLI.md b/docs/CLI.md index 92d5185..331434e 100644 --- a/docs/CLI.md +++ b/docs/CLI.md @@ -62,7 +62,7 @@ export CLAUDECODE_HOME="$ISOLATED_ROOT/claudecode-home" export AMP_CLI_HOME="$ISOLATED_ROOT/ampcli-home" cd "$WORKDIR" npm init -y -npm install /opendevbrowser-0.0.33.tgz +npm install /opendevbrowser-0.0.34.tgz npx --no-install opendevbrowser --help npx --no-install opendevbrowser help ``` @@ -1809,7 +1809,7 @@ npm run test -- tests/providers-performance-gate.test.ts These commands are release guards, not the live release-proof lane. Use the direct-run harness commands above for release evidence. -Release gate source of truth: `docs/RELEASE_RUNBOOK.md` and `docs/RELEASE_0.0.33_EVIDENCE.md`. +Release gate source of truth: `docs/RELEASE_RUNBOOK.md` and `docs/RELEASE_0.0.34_EVIDENCE.md`. Benchmark fixture manifest: `docs/benchmarks/provider-fixtures.md`. --- diff --git a/docs/EXTENSION_RELEASE_RUNBOOK.md b/docs/EXTENSION_RELEASE_RUNBOOK.md index 8e85083..e825340 100644 --- a/docs/EXTENSION_RELEASE_RUNBOOK.md +++ b/docs/EXTENSION_RELEASE_RUNBOOK.md @@ -6,7 +6,7 @@ Operational runbook for publishing extension artifacts from the public repo. ## Current source-backed extension reference -As of the 2026-05-21 package metadata audit, `package.json`, `package-lock.json`, `package-lock.json#packages[""]`, `extension/manifest.json`, and `extension/package.json` are all aligned at `0.0.33`. `extension/manifest.json` is MV3, names the extension `OpenDevBrowser Relay`, and packages the background service worker at `dist/background.js`. +As of the 2026-05-22 release prep, `package.json`, `package-lock.json`, `package-lock.json#packages[""]`, `extension/manifest.json`, and `extension/package.json` are all aligned at `0.0.34`. `extension/manifest.json` is MV3, names the extension `OpenDevBrowser Relay`, and packages the background service worker at `dist/background.js`. Use `npm run extension:sync` before release prep to write extension version metadata from the root package version. Use `npm run version:check` after sync to verify the root package, lockfile, manifest, and extension package agree. @@ -55,7 +55,7 @@ Configure in public GitHub repo secrets: 1. Run tag-driven public release flow (`docs/RELEASE_RUNBOOK.md`). 2. Confirm the release workflow completed the registry-consumer smoke lane for the published npm package before treating the extension artifact as fully released. 3. Confirm GitHub release includes extension zip + checksum. -4. Confirm the active release evidence ledger, currently `docs/RELEASE_0.0.33_EVIDENCE.md` for package version `0.0.33`, records whether external release workflow evidence is complete or deferred. +4. Confirm the active release evidence ledger, currently `docs/RELEASE_0.0.34_EVIDENCE.md` for package version `0.0.34`, records whether external release workflow evidence is complete or deferred. 5. Verify checksum locally if required: ```bash diff --git a/docs/FIRST_RUN_ONBOARDING.md b/docs/FIRST_RUN_ONBOARDING.md index 14f5873..fd94932 100644 --- a/docs/FIRST_RUN_ONBOARDING.md +++ b/docs/FIRST_RUN_ONBOARDING.md @@ -27,7 +27,7 @@ This guide is the shipping checklist for validating OpenDevBrowser as a new user ```bash cd npm pack -# -> opendevbrowser-0.0.33.tgz +# -> opendevbrowser-0.0.34.tgz ``` ## 2) Simulate a brand-new isolated user workspace @@ -44,7 +44,7 @@ export AMP_CLI_HOME="$WORKROOT/amp-home" mkdir -p "$WORKDIR" "$HOME" "$OPENCODE_CONFIG_DIR" "$OPENCODE_CACHE_DIR" "$CODEX_HOME" "$CLAUDECODE_HOME" "$AMP_CLI_HOME" cd "$WORKDIR" npm init -y -npm install /opendevbrowser-0.0.33.tgz +npm install /opendevbrowser-0.0.34.tgz npx --no-install opendevbrowser version --output-format json ``` diff --git a/docs/RELEASE_0.0.34_EVIDENCE.md b/docs/RELEASE_0.0.34_EVIDENCE.md new file mode 100644 index 0000000..8568899 --- /dev/null +++ b/docs/RELEASE_0.0.34_EVIDENCE.md @@ -0,0 +1,105 @@ +# v0.0.34 Release Evidence + +Status: prepared +Target release date: 2026-05-22 +Target tag: `v0.0.34` + +## Scope + +Tracks the `0.0.34` release cycle for the Inspired Design harvest recovery follow-up, browser output artifact hardening, and release metadata alignment. + +Current status note: +- Source version metadata is aligned from `0.0.33` to `0.0.34`. +- npm and GitHub release publication are planned through the public release workflow. +- Chrome Web Store publication is planned as a manual browser-gated lane for this release. + +## Reference State + +- Previous npm `latest`: `0.0.33` +- Previous GitHub release: `v0.0.33` +- Release branch: `codex/release-v0.0.34` +- Target tag: `v0.0.34` +- GitHub release workflow: `.github/workflows/release-public.yml` + +## Release Delta + +- Shipped PR #71 Inspired Design harvest recovery and browser output artifact behavior. +- Shipped PR #72 Pinterest harvest recovery validation hardening. +- Preserved diagnostic-only gating for non-ready Pinterest evidence and Canvas continuation. +- Kept release-facing source metadata aligned with the `0.0.34` package version. + +## Version Alignment + +- `package.json`: `0.0.34` +- `package-lock.json`: `0.0.34` +- `extension/package.json`: `0.0.34` +- `extension/manifest.json`: `0.0.34` + +## Mandatory Local Release Gates + +- [x] `npm run extension:sync` +- [x] `npm run version:check` +- [x] `npm run test:release-gate` +- [x] `node scripts/audit-zombie-files.mjs` +- [x] `node scripts/docs-drift-check.mjs` +- [x] `node scripts/chrome-store-compliance-check.mjs` +- [x] `./skills/opendevbrowser-best-practices/scripts/validate-skill-assets.sh` +- [x] `./skills/opendevbrowser-motion-design/scripts/validate-skill-assets.sh` +- [x] `npx opendevbrowser --help` +- [x] `npx opendevbrowser help` +- [x] `npm run lint` +- [x] `npm run typecheck` +- [x] `npm run test` +- [x] `npm run build` +- [x] `npm run extension:build` +- [x] `npm run extension:pack` +- [x] `npm pack --pack-destination /tmp` +- [x] `git diff --check` + +## Optional Strict Live Gates + +- [ ] Deferred unless explicitly required for this release: + - `node scripts/provider-direct-runs.mjs --release-gate --out artifacts/release/v0.0.34/provider-direct-runs.json` + - `node scripts/live-regression-direct.mjs --release-gate --out artifacts/release/v0.0.34/live-regression-direct.json` + +## Implementation Proof + +- [x] Harvest/browser artifact PR #71 merged: `https://github.com/freshtechbro/opendevbrowser/pull/71` +- [x] Pinterest recovery follow-up PR #72 merged: `https://github.com/freshtechbro/opendevbrowser/pull/72` +- [x] PR #72 passed required checks before merge: audit-zombie-files, build, chrome-store-compliance-check, cli-help-parity, docs-drift-check, focused-regression-tests, lint, skill-assets, and typecheck. + +## Local Release Gate Results + +- `npm run extension:sync`: passed; synced `extension/manifest.json` and `extension/package.json` to `0.0.34`. +- `npm run version:check`: passed; version check reported `0.0.34`. +- `npm run test:release-gate`: passed; groups completed with `99`, `40`, `15`, `5`, and `1` tests. +- `node scripts/audit-zombie-files.mjs`: passed; scanned `1077` files and flagged `[]`. +- `node scripts/docs-drift-check.mjs`: passed with `ok: true` for version `0.0.34`. +- `node scripts/chrome-store-compliance-check.mjs`: passed; manifest version was `0.0.34`. +- `./skills/opendevbrowser-best-practices/scripts/validate-skill-assets.sh`: passed; `22` referenced files present and `10` JSON templates parsed. +- `./skills/opendevbrowser-motion-design/scripts/validate-skill-assets.sh`: passed. +- `npx opendevbrowser --help`: passed with `823` help lines. +- `npx opendevbrowser help`: passed with `823` help lines. +- `npm run lint`: passed. +- `npm run typecheck`: passed. +- `npm run build`: passed. +- `npm run extension:build`: passed. +- `npm run test`: passed with `280` test files passed, `1` skipped; `4677` tests passed, `1` skipped; coverage summary was statements `98.27`, branches `97`, functions `97.94`, and lines `98.37`. +- `npm run extension:pack`: passed; produced `opendevbrowser-extension.zip`. +- Extension zip SHA-256: `42b50b663ae0e627a931518b30408aea5a218d36ce5e0b826b7a183c069518a9`. +- `npm pack --pack-destination /tmp`: passed; produced `/tmp/opendevbrowser-0.0.34.tgz`. +- npm tarball details: package size `2.4 MB`, unpacked size `12.3 MB`, total files `1272`, npm shasum `4c817987915bc2285a2a40b6c595c21e1aabffc2`. +- npm tarball SHA-256: `9bfe1bcf4d29367007c1b97c232c7cc9345e663330f9b99ceb859f3bc3c82211`. +- `git diff --check`: passed. + +## External Release Workflow Evidence + +- Pending tag-driven release workflow. +- Pending npm publish verification. +- Pending registry consumer smoke. +- Pending GitHub release verification. +- Pending Chrome Web Store manual publish evidence. + +## Notes + +- Strict live gates are separate from release quality gates and are deferred unless specifically run. diff --git a/docs/RELEASE_RUNBOOK.md b/docs/RELEASE_RUNBOOK.md index 2c7a563..f3b16c3 100644 --- a/docs/RELEASE_RUNBOOK.md +++ b/docs/RELEASE_RUNBOOK.md @@ -6,7 +6,7 @@ Canonical runbook for shipping OpenDevBrowser public releases (npm package + Git ## Current source-backed release reference -As of the 2026-05-21 package metadata audit, the checked-in release version is `0.0.33` across `package.json`, root `package-lock.json`, `package-lock.json#packages[""]`, `extension/manifest.json`, and `extension/package.json`. The current version-scoped release ledger is `docs/RELEASE_0.0.33_EVIDENCE.md`; `docs/RELEASE_0.0.32_EVIDENCE.md` and older ledgers are historical. +As of the 2026-05-22 release prep, the checked-in release version is `0.0.34` across `package.json`, root `package-lock.json`, `package-lock.json#packages[""]`, `extension/manifest.json`, and `extension/package.json`. The current version-scoped release ledger is `docs/RELEASE_0.0.34_EVIDENCE.md`; `docs/RELEASE_0.0.33_EVIDENCE.md` and older ledgers are historical. Use `npm run version:check` as the authoritative local parity check for those five version fields before tagging or publishing. @@ -197,7 +197,7 @@ npm deprecate opendevbrowser@X.Y.Z "deprecated: use " ## Evidence to retain -- Active version-scoped release evidence ledger path, currently `docs/RELEASE_0.0.33_EVIDENCE.md` for package version `0.0.33` +- Active version-scoped release evidence ledger path, currently `docs/RELEASE_0.0.34_EVIDENCE.md` for package version `0.0.34` - Release workflow run URL - npm published version output (or explicit publish deferral for manual dry runs) - `artifacts/release/vX.Y.Z/registry-consumer-smoke.json` diff --git a/extension/manifest.json b/extension/manifest.json index 05ac665..e39e609 100644 --- a/extension/manifest.json +++ b/extension/manifest.json @@ -1,7 +1,7 @@ { "manifest_version": 3, "name": "OpenDevBrowser Relay", - "version": "0.0.33", + "version": "0.0.34", "description": "Optional bridge to reuse existing Chrome tabs with OpenDevBrowser.", "permissions": [ "debugger", diff --git a/extension/package.json b/extension/package.json index 5a5b587..bc3996d 100644 --- a/extension/package.json +++ b/extension/package.json @@ -1,6 +1,6 @@ { "name": "opendevbrowser-extension", - "version": "0.0.33", + "version": "0.0.34", "private": true, "type": "module", "scripts": { diff --git a/package-lock.json b/package-lock.json index c04a9db..9834957 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "opendevbrowser", - "version": "0.0.33", + "version": "0.0.34", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "opendevbrowser", - "version": "0.0.33", + "version": "0.0.34", "license": "MIT", "dependencies": { "@opencode-ai/plugin": "^1.2.25", diff --git a/package.json b/package.json index 5968aa5..668c331 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "opendevbrowser", - "version": "0.0.33", + "version": "0.0.34", "description": "Browser automation runtime with snapshot-refs-actions, browser replay screencasts, public read-only desktop observation, and browser-scoped computer-use orchestration", "type": "module", "main": "dist/index.js",