Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <public-repo-root>/opendevbrowser-0.0.33.tgz
npm install <public-repo-root>/opendevbrowser-0.0.34.tgz
npx --no-install opendevbrowser --help
npx --no-install opendevbrowser help
```
Expand Down
2 changes: 1 addition & 1 deletion docs/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
4 changes: 2 additions & 2 deletions docs/CLI.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <public-repo-root>/opendevbrowser-0.0.33.tgz
npm install <public-repo-root>/opendevbrowser-0.0.34.tgz
npx --no-install opendevbrowser --help
npx --no-install opendevbrowser help
```
Expand Down Expand Up @@ -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`.

---
Expand Down
4 changes: 2 additions & 2 deletions docs/EXTENSION_RELEASE_RUNBOOK.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/FIRST_RUN_ONBOARDING.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ This guide is the shipping checklist for validating OpenDevBrowser as a new user
```bash
cd <public-repo-root>
npm pack
# -> opendevbrowser-0.0.33.tgz
# -> opendevbrowser-0.0.34.tgz
```

## 2) Simulate a brand-new isolated user workspace
Expand All @@ -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 <public-repo-root>/opendevbrowser-0.0.33.tgz
npm install <public-repo-root>/opendevbrowser-0.0.34.tgz
npx --no-install opendevbrowser version --output-format json
```

Expand Down
105 changes: 105 additions & 0 deletions docs/RELEASE_0.0.34_EVIDENCE.md
Original file line number Diff line number Diff line change
@@ -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.
4 changes: 2 additions & 2 deletions docs/RELEASE_RUNBOOK.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -197,7 +197,7 @@ npm deprecate opendevbrowser@X.Y.Z "deprecated: use <fixed-version>"

## 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`
Expand Down
2 changes: 1 addition & 1 deletion extension/manifest.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
2 changes: 1 addition & 1 deletion extension/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "opendevbrowser-extension",
"version": "0.0.33",
"version": "0.0.34",
"private": true,
"type": "module",
"scripts": {
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
Loading