Prepare v0.21.2 release readiness#48
Conversation
|
Caution Review failedThe pull request is closed. ℹ️ Recent review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (48)
📝 WalkthroughWalkthroughBumps the package version from Changesv0.21.2-alpha.0 Release-Readiness Bump
Estimated code review effort🎯 2 (Simple) | ⏱️ ~12 minutes Possibly related PRs
Poem
✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
There was a problem hiding this comment.
Code Review
This pull request prepares the codebase for the v0.21.2-alpha.0 release by bumping version numbers across packages, plugins, and manifests, updating documentation to align with the current implementation, and deferring Windows/Scoop support to a future milestone. It also enhances the fresh-clone-smoke.sh script with a --help option and a more robust awk-based test summary parser, backed by a new test suite. The reviewer suggested further hardening the awk parser in fresh-clone-smoke.sh by ensuring the first field is strictly numeric to prevent false positives from test names or other log outputs.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| TEST_PASS_COUNT=$(awk '$2 == "pass" { pass=$1 } END { print pass + 0 }' "$WORKDIR/test.out") | ||
| TEST_FAIL_COUNT=$(awk '$2 == "fail" { fail=$1 } END { print fail + 0 }' "$WORKDIR/test.out") |
There was a problem hiding this comment.
To make the test summary parser even more robust, consider ensuring that the first field ($1) is strictly numeric. This prevents potential false positives if a test name or other log output happens to have pass or fail as the second word (e.g., ✓ pass or ✗ fail).
| TEST_PASS_COUNT=$(awk '$2 == "pass" { pass=$1 } END { print pass + 0 }' "$WORKDIR/test.out") | |
| TEST_FAIL_COUNT=$(awk '$2 == "fail" { fail=$1 } END { print fail + 0 }' "$WORKDIR/test.out") | |
| TEST_PASS_COUNT=$(awk '$1 ~ /^[0-9]+$/ && $2 == "pass" { pass=$1 } END { print pass + 0 }' "$WORKDIR/test.out")\n TEST_FAIL_COUNT=$(awk '$1 ~ /^[0-9]+$/ && $2 == "fail" { fail=$1 } END { print fail + 0 }' "$WORKDIR/test.out") |
There was a problem hiding this comment.
Pull request overview
Prepares the repository for the v0.21.2-alpha.0 release line by bumping versioned surfaces, aligning user-facing docs/receipts with current behavior, and adding release-readiness validation coverage (including a fresh-clone smoke flow hardening + tests).
Changes:
- Bumped CLI/config/package/plugin marketplace versions to
0.21.2-alpha.0and refreshed version-sensitive tests. - Hardened
scripts/release/fresh-clone-smoke.sh(argument handling + Bun summary parsing) and added targeted tests. - Truth-synced release/readme/provider/security/contributing/docs and refreshed deterministic demo receipts.
Reviewed changes
Copilot reviewed 47 out of 48 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| tests/smoke-test.test.ts | Update expected version string to 0.21.2-alpha.0. |
| tests/release-fresh-clone-smoke.test.ts | Add tests for fresh-clone-smoke.sh arg handling + summary parsing. |
| tests/plugins/bootstrap-resolver.test.ts | Update Windows messaging assertion to avoid stale version promise. |
| tests/m5-fix-first.test.ts | Bump “current version” expectation to 0.21.2-alpha.0. |
| tests/cli-init.test.ts | Update generated config version expectation. |
| tests/build-binaries.test.ts | Update Windows deferral wording in test description. |
| src/runtime/provider-file-refs.ts | Adjust comment wording about future repo-context work. |
| src/config/schema.ts | Bump DEFAULT_CONFIG.version. |
| src/cli.ts | Bump PKG_VERSION + clarify SHIP help text. |
| SECURITY.md | Update supported alpha line + replace hardcoded test counts reference. |
| scripts/smoke-test.ts | Update Windows deferral wording in stderr message. |
| scripts/release/fresh-clone-smoke.sh | Add --help/unknown-arg handling + change Bun summary parsing. |
| scripts/install.sh | Update version examples + Windows deferral wording. |
| scripts/build-binaries.ts | Update distribution-status text (Windows/Scoop wording). |
| README.md | Update install examples, provider setup guidance, and release-readiness pointers. |
| plugins/code-oz/scripts/resolve-code-oz.sh | Update Windows rejection message and header comment wording. |
| plugins/code-oz/.claude-plugin/plugin.json | Bump plugin version to 0.21.2-alpha.0. |
| plugins/code-oz-discipline/skills/source-check/SKILL.md | Update example run command to deterministic fake-provider invocation. |
| plugins/code-oz-discipline/skills/red-first/SKILL.md | Update example run command to deterministic fake-provider invocation. |
| plugins/code-oz-discipline/skills/brainstorming/SKILL.md | Update example run command to deterministic fake-provider invocation. |
| plugins/code-oz-discipline/skill-src/_upsell.md | Update upsell snippet to deterministic fake-provider invocation. |
| plugins/code-oz-discipline/.claude-plugin/plugin.json | Bump plugin version to 0.21.2-alpha.0. |
| package.json | Bump npm package version to 0.21.2-alpha.0. |
| npm-wrapper/index.cjs | Update Windows/Scoop deferral wording. |
| docs/RELEASE_READINESS.md | Add release-readiness status page and checklists for CLI/npm/plugins/gui. |
| docs/RECEIPTS.md | Refresh receipts and validation counts; update skip rationale text. |
| docs/PROVIDER_SETUP.md | Update first-run guidance to explicit --provider fake --request .... |
| docs/homebrew/README.md | Refresh Homebrew release flow docs and example commands. |
| docs/handoffs/2026-06-14-release-readiness-audit.md | Add audit/handoff note for the release-readiness sync. |
| docs/demo/02-failure-gates/output/02-scope-escape/events-sketch.jsonl | Refresh deterministic demo receipt paths. |
| docs/demo/02-failure-gates/output/02-scope-escape/actual.txt | Refresh deterministic demo receipt paths. |
| docs/demo/01-todo-cli/output/balanced/gates/GATE_VERIFY_PASSED.json | Refresh deterministic demo gate receipt IDs/timestamps/hashes. |
| docs/demo/01-todo-cli/output/balanced/gates/GATE_REVIEW_PASSED.json | Refresh deterministic demo gate receipt IDs/timestamps/hashes. |
| docs/demo/01-todo-cli/output/balanced/gates/GATE_PLAN_PASSED.json | Refresh deterministic demo gate receipt IDs/timestamps/hashes. |
| docs/demo/01-todo-cli/output/balanced/gates/GATE_DEFINE_PASSED.json | Refresh deterministic demo gate receipt IDs/timestamps/hashes. |
| docs/demo/01-todo-cli/output/balanced/gates/GATE_BUILD_PASSED.json | Refresh deterministic demo gate receipt IDs/timestamps/hashes. |
| docs/demo/01-todo-cli/output/balanced/events.jsonl | Refresh deterministic demo events receipt. |
| docs/demo/01-todo-cli/output/balanced/artifacts/VERIFY.md | Refresh deterministic demo artifact hashes/paths. |
| docs/demo/01-todo-cli/output/balanced/artifacts/REVIEW.md | Refresh deterministic demo artifact hashes/paths. |
| docs/demo/01-todo-cli/output/balanced/artifacts/BUILD_REPORT.md | Refresh deterministic demo artifact hashes/paths. |
| docs/comparisons/agentic-canvas/COMPARISON.md | Add current-status note + update distribution wording. |
| docs/comparisons/agentic-canvas/B3_SKILL_WRAPPERS.md | Update install guidance and distribution wording. |
| docs/ABOUT.md | Update “what ships” section to v0.21.x reality and clarify SHIP boundary. |
| CONTRIBUTING.md | Update recommended commands and clarify CI vs local test scope. |
| code-oz-gui/README.md | Align GUI README with current provider/runtime/release posture. |
| CLAUDE.md | Update status and distribution wording for v0.21.x line. |
| CHANGELOG.md | Add v0.21.2-alpha.0 section and compare/tag links. |
| .claude-plugin/marketplace.json | Update marketplace description + bump plugin versions. |
Files not reviewed (1)
- docs/demo/01-todo-cli/output/balanced/events.jsonl: Generated file
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - `bun run typecheck`: pass. | ||
| - `bun run build:binary`: pass. | ||
|
|
||
| The two skipped tests are deterministic tool-unavailable coverage for the repo-context path (`rg not installed`), not hidden live-provider calls. At the v0.21.0-alpha.0 release the suite measured 3762 pass; later milestones and GUI tests added the remainder. |
Summary
v0.21.2-alpha.0as a release-readiness truth-sync patch.fresh-clone-smoke.shargument handling and Bun summary parsing.Why
mainhad post-v0.21.1-alpha.0plugin fixes and docs drift, but the install/publish/plugin/GUI surfaces did not clearly separate shipped, experimental, and future work.0.21.1-alpha.0is already published on npm and GitHub, so this release-prep branch bumps package/plugin/CLI/config surfaces to0.21.2-alpha.0.Changes
0.21.2-alpha.0.docs/RELEASE_READINESS.mdanddocs/handoffs/2026-06-14-release-readiness-audit.md.tests/release-fresh-clone-smoke.test.tsand hardensscripts/release/fresh-clone-smoke.sh.Validation
scripts/release/fresh-clone-smoke.sh-> pass from committed branch, including3818 pass,2 skip,0 fail, both demos, and drift checks.bun run typecheck-> pass.bun run build:binary-> pass.npm pack --dry-run --json-> pass, produces@tuel/code-oz@0.21.2-alpha.0launcher tarball with 4 files.npm view @tuel/code-oz@0.21.2-alpha.0 version-> confirms version is not currently published.bun test tests/cli-init.test.ts tests/m5-fix-first.test.ts tests/smoke-test.test.ts tests/plugins/manifest-shape.test.ts tests/plugins/discipline-manifest.test.ts tests/plugins/bootstrap-resolver.test.ts tests/install-script.test.ts-> pass.claude plugin validate --strict .claude-plugin/marketplace.json && claude plugin validate --strict plugins/code-oz && claude plugin validate --strict plugins/code-oz-discipline-> pass.HOME-> both plugins install and report expected component inventory at0.21.2-alpha.0.code-oz-gui:bun install --frozen-lockfile,bun run typecheck,bun run lint,bun test tests/unit,bun run build-> pass.Risks / follow-ups
npm whoamireturnsE401 Unauthorized.v0.21.2-alpha.0tag workflow to run after merge.checksums.txtafter assets exist.Summary by CodeRabbit
Chores
Documentation