Skip to content

Prepare v0.21.2 release readiness#48

Merged
omerakben merged 1 commit into
mainfrom
codex/release-readiness-confidence
Jun 14, 2026
Merged

Prepare v0.21.2 release readiness#48
omerakben merged 1 commit into
mainfrom
codex/release-readiness-confidence

Conversation

@omerakben

@omerakben omerakben commented Jun 14, 2026

Copy link
Copy Markdown
Owner

Summary

  • Prepare v0.21.2-alpha.0 as a release-readiness truth-sync patch.
  • Align README, CLAUDE.md, provider setup, Homebrew docs, GUI README, receipts, changelog, and release-readiness notes with the current implementation.
  • Add a release-readiness page, audit handoff, and tests for fresh-clone-smoke.sh argument handling and Bun summary parsing.

Why

  • main had post-v0.21.1-alpha.0 plugin fixes and docs drift, but the install/publish/plugin/GUI surfaces did not clearly separate shipped, experimental, and future work.
  • 0.21.1-alpha.0 is already published on npm and GitHub, so this release-prep branch bumps package/plugin/CLI/config surfaces to 0.21.2-alpha.0.

Changes

  • Updates package/plugin marketplace metadata and version-sensitive tests to 0.21.2-alpha.0.
  • Documents release readiness in docs/RELEASE_READINESS.md and docs/handoffs/2026-06-14-release-readiness-audit.md.
  • Clarifies SHIP as a human-owned boundary, not push/merge/publish automation.
  • Removes stale Windows/Scoop timing claims and stale install/version examples from active docs.
  • Refreshes deterministic demo receipts so cited hashes and event lines match current generated artifacts.
  • Adds tests/release-fresh-clone-smoke.test.ts and hardens scripts/release/fresh-clone-smoke.sh.

Validation

  • scripts/release/fresh-clone-smoke.sh -> pass from committed branch, including 3818 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.0 launcher 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.
  • Isolated Claude Code marketplace add/install with temporary HOME -> both plugins install and report expected component inventory at 0.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.
  • Built binary first-run fake-provider smoke -> pass.

Risks / follow-ups

  • npm publish cannot be completed from the current shell yet: npm whoami returns E401 Unauthorized.
  • GitHub release assets still need the v0.21.2-alpha.0 tag workflow to run after merge.
  • Homebrew formula must be rendered from the final GitHub release checksums.txt after assets exist.
  • GUI standalone packaging is still future work.
  • Live brownfield AUDIT with real providers was not rerun because this patch does not change brownfield runtime behavior.

Summary by CodeRabbit

  • Chores

    • Bumped version to v0.21.2-alpha.0 across package manifests and CLI.
  • Documentation

    • Updated installation and provider setup guidance with explicit fake-provider examples.
    • Clarified Windows/Scoop support is deferred to a future milestone.
    • Added release readiness documentation and validation receipts.
    • Refreshed contribution guidelines with standardized test workflows.
    • Updated plugin marketplace metadata and examples.

Copilot AI review requested due to automatic review settings June 14, 2026 16:05
@coderabbitai

coderabbitai Bot commented Jun 14, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4f6f432a-5130-4626-8572-f5db2cf41501

📥 Commits

Reviewing files that changed from the base of the PR and between 9679c63 and 6c07753.

📒 Files selected for processing (48)
  • .claude-plugin/marketplace.json
  • CHANGELOG.md
  • CLAUDE.md
  • CONTRIBUTING.md
  • README.md
  • SECURITY.md
  • code-oz-gui/README.md
  • docs/ABOUT.md
  • docs/PROVIDER_SETUP.md
  • docs/RECEIPTS.md
  • docs/RELEASE_READINESS.md
  • docs/comparisons/agentic-canvas/B3_SKILL_WRAPPERS.md
  • docs/comparisons/agentic-canvas/COMPARISON.md
  • docs/demo/01-todo-cli/output/balanced/artifacts/BUILD_REPORT.md
  • docs/demo/01-todo-cli/output/balanced/artifacts/REVIEW.md
  • docs/demo/01-todo-cli/output/balanced/artifacts/VERIFY.md
  • docs/demo/01-todo-cli/output/balanced/events.jsonl
  • docs/demo/01-todo-cli/output/balanced/gates/GATE_BUILD_PASSED.json
  • docs/demo/01-todo-cli/output/balanced/gates/GATE_DEFINE_PASSED.json
  • docs/demo/01-todo-cli/output/balanced/gates/GATE_PLAN_PASSED.json
  • docs/demo/01-todo-cli/output/balanced/gates/GATE_REVIEW_PASSED.json
  • docs/demo/01-todo-cli/output/balanced/gates/GATE_VERIFY_PASSED.json
  • docs/demo/02-failure-gates/output/02-scope-escape/actual.txt
  • docs/demo/02-failure-gates/output/02-scope-escape/events-sketch.jsonl
  • docs/handoffs/2026-06-14-release-readiness-audit.md
  • docs/homebrew/README.md
  • npm-wrapper/index.cjs
  • package.json
  • plugins/code-oz-discipline/.claude-plugin/plugin.json
  • plugins/code-oz-discipline/skill-src/_upsell.md
  • plugins/code-oz-discipline/skills/brainstorming/SKILL.md
  • plugins/code-oz-discipline/skills/red-first/SKILL.md
  • plugins/code-oz-discipline/skills/source-check/SKILL.md
  • plugins/code-oz/.claude-plugin/plugin.json
  • plugins/code-oz/scripts/resolve-code-oz.sh
  • scripts/build-binaries.ts
  • scripts/install.sh
  • scripts/release/fresh-clone-smoke.sh
  • scripts/smoke-test.ts
  • src/cli.ts
  • src/config/schema.ts
  • src/runtime/provider-file-refs.ts
  • tests/build-binaries.test.ts
  • tests/cli-init.test.ts
  • tests/m5-fix-first.test.ts
  • tests/plugins/bootstrap-resolver.test.ts
  • tests/release-fresh-clone-smoke.test.ts
  • tests/smoke-test.test.ts

📝 Walkthrough

Walkthrough

Bumps the package version from 0.21.1-alpha.0 to 0.21.2-alpha.0 across all source constants, manifests, and tests. Replaces version-specific Windows/Scoop deferral wording with a generic "future distribution milestone" phrase. Hardens fresh-clone-smoke.sh with awk-based test-result parsing and unknown-arg handling, covered by a new test suite. Adds docs/RELEASE_READINESS.md and a handoff audit document, refreshes all project documentation to reflect current release state, and re-runs the balanced demo fixture.

Changes

v0.21.2-alpha.0 Release-Readiness Bump

Layer / File(s) Summary
Version constants, manifests, and aligned tests
package.json, src/cli.ts, src/config/schema.ts, .claude-plugin/marketplace.json, plugins/code-oz/.claude-plugin/plugin.json, plugins/code-oz-discipline/.claude-plugin/plugin.json, tests/m5-fix-first.test.ts, tests/cli-init.test.ts, tests/smoke-test.test.ts
PKG_VERSION, DEFAULT_CONFIG.version, package.json, both plugin manifests, and marketplace registry are all bumped to 0.21.2-alpha.0; marketplace description changes to "Claude Code marketplace"; version-assertion tests are updated to match.
Windows/Scoop deferral message despecification
npm-wrapper/index.cjs, scripts/install.sh, scripts/smoke-test.ts, scripts/build-binaries.ts, plugins/code-oz/scripts/resolve-code-oz.sh, src/runtime/provider-file-refs.ts, tests/build-binaries.test.ts, tests/plugins/bootstrap-resolver.test.ts
All "(v0.21+)" version-specific Windows rejection strings are replaced with "future distribution milestone" across installer, npm-wrapper, smoke scripts, plugin resolver, and their tests.
fresh-clone-smoke.sh hardening and new test suite
scripts/release/fresh-clone-smoke.sh, tests/release-fresh-clone-smoke.test.ts
usage() is expanded, unknown arguments now exit with code 2, pass/fail count extraction is switched from grep to awk; a new Bun test suite exercises --help, unknown-arg failure, and verifies the awk summary-parser logic.
CLI help and install script example versions
src/cli.ts, scripts/install.sh
printHelp() SHIP boundary wording is adjusted; install script --version help text and "no local bundle found" error are updated to reference v0.21.2-alpha.0.
Plugin skill example commands updated to --provider fake
plugins/code-oz-discipline/skill-src/_upsell.md, plugins/code-oz-discipline/skills/*/SKILL.md
Generic code-oz run placeholders in all four discipline skill files are replaced with the explicit code-oz run --provider fake --request "Create a tiny hello-world CLI" form.
New release-readiness docs and refreshed project documentation
docs/RELEASE_READINESS.md, docs/handoffs/2026-06-14-release-readiness-audit.md, CHANGELOG.md, README.md, CONTRIBUTING.md, CLAUDE.md, SECURITY.md, docs/ABOUT.md, docs/PROVIDER_SETUP.md, docs/RECEIPTS.md, docs/homebrew/README.md, code-oz-gui/README.md, docs/comparisons/agentic-canvas/*
docs/RELEASE_READINESS.md is created with publishable-surface lists, checklists, and a validation receipt. A handoff audit note is added. All project docs are updated with v0.21.2-alpha.0 references, curl/npm/Homebrew distribution, and fake-provider first-run commands.
Demo output fixtures refreshed for new run
docs/demo/01-todo-cli/output/balanced/..., docs/demo/02-failure-gates/output/02-scope-escape/...
All balanced demo artifacts (events.jsonl, gate JSONs, BUILD_REPORT.md, REVIEW.md, VERIFY.md) and the scope-escape fixture are refreshed with new runId, timestamps, SHA256 hashes, worktree paths, and a pricing key update from claude-opus-4-7 to claude-opus-4-8.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • omerakben/code-oz#45: Modifies the same .claude-plugin/marketplace.json plugin entries (code-oz and code-oz-discipline), where #45 changes source paths and this PR bumps version and description.
  • omerakben/code-oz#38: Introduces the plugins/code-oz/scripts/resolve-code-oz.sh plugin resolver and its tests/plugins/bootstrap-resolver.test.ts coverage, both of which are updated here for the Windows deferral message change.
  • omerakben/code-oz#30: Touches the same Windows/Scoop deferred-support wording in scripts/install.sh and related installer messaging that this PR despecifies by removing the version qualifier.

Poem

🐇 Hop, hop, a version takes flight,
0.21.2 shines in the night.
Windows can wait — "future milestone," we say,
Awk counts the tests in a much cleaner way.
Release-readiness docs, fresh fixtures, all true —
The rabbit has shipped! 🎉 (fake provider too)

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/release-readiness-confidence

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment on lines +129 to +130
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")

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

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).

Suggested change
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")

@omerakben omerakben merged commit f2cc271 into main Jun 14, 2026
3 of 4 checks passed
@omerakben omerakben deleted the codex/release-readiness-confidence branch June 14, 2026 16:08

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.0 and 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.

Comment thread docs/RECEIPTS.md
- `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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants