Skip to content

chore(release): prepare v0.2.0#655

Merged
flyingrobots merged 2 commits into
mainfrom
release/v0.2.0
Jun 26, 2026
Merged

chore(release): prepare v0.2.0#655
flyingrobots merged 2 commits into
mainfrom
release/v0.2.0

Conversation

@flyingrobots

@flyingrobots flyingrobots commented Jun 26, 2026

Copy link
Copy Markdown
Owner

Linked Issue

Tracks #625. Do not auto-close on merge; close #625 only after the signed v0.2.0 tag is cut from synced main and the release publication checks pass.

Branch / Issue-Title Check

  • Branch name exception: release/v0.2.0 is a release-prep branch, not an issue-title slug.

Summary

  • Prepare Wesley v0.2.0 release truth before tagging from main.
  • Bump the Rust release set, lockfile, and root private metadata to 0.2.0.
  • Add the shaped v0.2.0 release packet, verification packet, and user-facing release notes.
  • Refresh README, GUIDE, ENTRYPOINTS, docs site, technical teardown, release indexes, and legacy backlog signpost examples for the v0.2.0 release boundary.
  • Keep the release domain-free: project manifests select GraphQL structure, schema sets, bundles, comments, dashboards, and generic target metadata; extensions own semantics.
  • Fix the docs CLI checker so documented command families such as wesley config are valid when concrete subcommands exist.

Why

Wesley releases must come from tagged main, with README, changelog, release notes, runbooks, version metadata, and release evidence already merged before the tag is cut. This PR makes main truthful for v0.2.0 without adding domain semantics to Wesley core.

Changes

  • Version metadata: Rust release crates, internal wesley-holmes, root private package metadata, and Cargo.lock are aligned to 0.2.0.
  • Release docs: add docs/method/releases/v0.2.0/release.md, docs/method/releases/v0.2.0/verification.md, and docs/releases/v0.2.0.md.
  • Signposts: update README.md, docs/GUIDE.md, docs/ENTRYPOINTS.md, docs/TECHNICAL_TEARDOWN.md, docs site pages, and release indexes.
  • Backlog signposts: replace misleading concrete v0.2.0 examples with vX.Y.Z placeholders where the docs describe generic future release mechanics.
  • Docs validation: allow documented CLI command-family headings when concrete native subcommands exist.

Method Evidence

  • Design doc linked or not required: not required; release-prep/documentation/version alignment only.
  • Tests or validation evidence included below.
  • Playback/witness included or not required: release verification packet included.
  • Retro or closeout evidence included or not required: not required before release publication.

Tracker Hygiene

Docs Topics Audit

  • Audited every tracked file under docs/topics/ for release-relevant accuracy and coverage.
  • Accuracy: 100% for the release-relevant topic claims audited during prep.
  • Coverage: 100% for the release-relevant contributor/operator workflows changed by this release.
  • No docs/topics/ page required content correction after audit; related stale signposts and command-checker behavior were corrected outside docs/topics/.

Risk

  • Release metadata risk: mitigated by release-prep-guard, package crate dry-run, lockfile checks, version smoke, and release verification docs.
  • Documentation accuracy risk: mitigated by docs/topics audit, docs-check, CLI docs checker, Prettier, and targeted Bats guards.
  • Domain-boundary risk: mitigated by keeping all semantics generic; project manifests and extensions describe structure selection, not Wesley-owned domain behavior.

Backout

Use a merge revert of this PR before tagging. Do not tag v0.2.0 until the revert lands and main is synced. If the tag has already been pushed, treat that as a release incident: stop publication if possible, document the exact state, and cut a corrective follow-up release rather than rewriting public history.

Testing

  • cargo xtask release-prep-guard --version 0.2.0
  • cargo xtask preflight
  • cargo xtask release-check
  • cargo xtask package-crates --version 0.2.0
  • RUSTDOCFLAGS='-D warnings' cargo doc --workspace --no-deps
  • BATS_LIB_PATH=test/vendor bats -t test/release-governance.bats test/docs-planning-boundary.bats
  • node scripts/check-doc-cli-commands.mjs
  • cargo xtask docs-check
  • pnpm exec prettier --check ... on changed docs/scripts/metadata
  • cargo run --bin wesley -- --version prints 0.2.0
  • cargo test --workspace -- --list lists 323 Rust tests
  • Pre-push selected suite passed: Rust product preflight, legacy preflight, repo Bats smoke suite

EvidenceMap / SourceMap (if applicable)

Not applicable. This PR does not change SQL-to-SDL mapping, EvidenceMap, or SourceMap behavior.

Screenshots / Logs (optional)

Not applicable.

Merge Strategy

  • Merge commit only; no rebase.
  • Delete branch after merge.
  • After merge, sync local main, create a signed v0.2.0 tag from main, run cargo xtask release-guard --tag v0.2.0, push the exact tag, and monitor release publication.

Checklist

  • One-topic PR with tight diff
  • Rust-native preflight passes (cargo xtask preflight)
  • Release preflight passes (cargo xtask release-check and cargo xtask release-prep-guard --version 0.2.0)
  • Legacy package preflight passed where relevant through selected pre-push suite
  • No widened permissions/secrets in workflows
  • Docs updated for release-facing behavior and version metadata

Pre-Tag Sign-Off for v0.2.0

Reviewer: @
Date: 2026-06-26

Human-Review Items

  • CHANGELOG reflects actual diff
    I ran git log v0.1.1..HEAD --oneline and confirmed that the CHANGELOG.md entry for this release accounts for all user-visible changes. No significant change is silently absent from the entry.

  • docs/ARCHITECTURE.md is current
    I read docs/ARCHITECTURE.md and confirmed it accurately describes the current repository structure, crate relationships, and ownership boundaries. No crate, package, or boundary described has been removed, renamed, or fundamentally changed without the doc being updated.

  • Guide claims are accurate
    I spot-checked the guides in docs/guides/ that are relevant to changes in this release. Commands, flags, file paths, and behavioral claims match the current codebase. I did not rely solely on the automated path/SHA checks.

  • docs/topics/ accuracy and coverage gate is met
    I audited every tracked file under docs/topics/ for release-relevant accuracy and coverage. At least 90% accuracy of audited topic claims and at least 90% coverage of release-relevant contributor/operator topic workflows are met. Any stale topic claim, obsolete instruction, missing topic, or missing authoritative link was corrected before tagging.

  • No known issues being silently shipped
    I reviewed the open GitHub Issues for known defects or outstanding decisions that affect this release's correctness or safety, whether or not they are already marked as release issues. Anything knowingly deferred is acknowledged in the CHANGELOG or a documented follow-on issue.

  • Tagged main is the release boundary
    I confirmed every repo-resident release fact that must ship with this version is already on synced main before tagging. The release does not depend on a manual post-publish merge to make README, changelog, release notes, runbooks, or verification docs accurate.

Summary by CodeRabbit

  • New Features

    • Added release 0.2.0 with expanded project-manifest and CLI guidance, including updated install commands and a fuller topic map.
  • Bug Fixes

    • Improved documentation command validation so command families and subcommands are recognized more reliably.
    • Refreshed multiple guides and quick-start examples to match the latest CLI usage.
  • Documentation

    • Added new release and verification notes, plus updated changelog, README, and site docs to reflect the current release.

@coderabbitai

coderabbitai Bot commented Jun 26, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 76396ac3-ec3b-419d-a8dc-34ff4a79713e

📥 Commits

Reviewing files that changed from the base of the PR and between 054a5e6 and d497fa0.

📒 Files selected for processing (3)
  • scripts/check-doc-cli-commands.mjs
  • scripts/check-doc-cli-commands.test.mjs
  • scripts/preflight.mjs
🚧 Files skipped from review as they are similar to previous changes (1)
  • scripts/check-doc-cli-commands.mjs

📝 Walkthrough

Walkthrough

The PR bumps workspace and package versions to 0.2.0, updates release and install documentation, adds v0.2.0 release and verification packets, and expands CLI-doc validation to accept command-family prefixes and run script tests in preflight.

Changes

Release metadata and documentation

Layer / File(s) Summary
Version bumps and public docs
crates/*/Cargo.toml, CHANGELOG.md, README.md, package.json, docs/ENTRYPOINTS.md, docs/GUIDE.md, docs/site/index.md, docs/site/quick-start.md
Workspace package versions and user-facing install, quick-start, and release-summary docs move to 0.2.0.
Technical teardown refresh
docs/TECHNICAL_TEARDOWN.md
The technical teardown narrative is rewritten around the v0.2.0 release snapshot, command references, and current-state checkpoints.
Release packet and verification
docs/method/releases/v0.2.0/*
The release packet and verification packet add scope, acceptance, discovery, and evidence sections for v0.2.0.
Release notes and publication indexes
docs/method/releases/README.md, docs/releases/README.md, docs/releases/v0.2.0.md, docs/method/backlog/README.md, docs/method/backlog/*/README.md
The release notes are added, release indexes link to v0.2.0, and backlog guidance switches fixed version labels to a placeholder.
CLI docs validation
scripts/check-doc-cli-commands.mjs, scripts/check-doc-cli-commands.test.mjs, scripts/preflight.mjs
The docs checker accepts command-family prefixes, its tests cover the new matching behavior, and preflight runs script tests.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

  • flyingrobots/wesley#46: Also updates the repository preflight script to run additional validation steps.
  • flyingrobots/wesley#508: Also coordinates crate version bumps with matching install/version documentation updates.
  • flyingrobots/wesley#640: Also refreshes release-prep files, package versions, and release documentation for a tagged release.

Suggested labels

v0.2.0

Poem

A rabbit hopped by, ears held high,
with 0.2.0 stitched in the sky.
The changelog chimed, the docs went bright,
and CLI paths ran snug and right.
Thump! says the bunny, release-day cheer.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title is concise and accurately describes the release-prep work for v0.2.0.
Description check ✅ Passed The description follows the template closely and fills the required release, risk, testing, and evidence sections.
Linked Issues check ✅ Passed The changes align with #625 by preparing the release on main, updating release docs, auditing docs/topics, and adding validation evidence.
Out of Scope Changes check ✅ Passed The diff stays focused on release preparation, docs/signposts, version bumps, and the docs CLI checker fix with no obvious unrelated changes.
✨ 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 release/v0.2.0

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.

@github-actions

github-actions Bot commented Jun 26, 2026

Copy link
Copy Markdown

🔍 The Case of Pull Request #655

Schema Sets

  • ecommerce
  • reference

Schema Set ecommerce

Plain-English Readout

  • Holmes (evidence investigation): The Holmes report is unavailable because the workflow finished without a readable holmes-report.json artifact.
  • Watson (independent verification): The Watson report is unavailable because the workflow finished without a readable watson-report.json artifact.
  • Moriarty (trend forecast): The Moriarty forecast is unavailable because the workflow finished without a readable moriarty-report.json artifact.

Suggested next actions

  1. Regenerate the HOLMES artifacts and make sure holmes-report.json is uploaded before trusting this PR summary.
  2. Regenerate the WATSON artifacts and make sure watson-report.json is uploaded before trusting this PR summary.
  3. Regenerate the MORIARTY artifacts and make sure moriarty-report.json is uploaded before trusting this PR summary.
🕵️ SHA-lock HOLMES full report for ecommerce (click to expand)

Report unavailable for holmes: readable holmes-report.md artifact not found.

🩺 Dr. WATSON full report for ecommerce (click to expand)

Report unavailable for watson: readable watson-report.md artifact not found.

🔮 Professor MORIARTY full report for ecommerce (click to expand)

Report unavailable for moriarty: readable moriarty-report.md artifact not found.


Schema Set reference

Plain-English Readout

  • Holmes (evidence investigation): The Holmes report is unavailable because the workflow finished without a readable holmes-report.json artifact.
  • Watson (independent verification): The Watson report is unavailable because the workflow finished without a readable watson-report.json artifact.
  • Moriarty (trend forecast): The Moriarty forecast is unavailable because the workflow finished without a readable moriarty-report.json artifact.

Suggested next actions

  1. Regenerate the HOLMES artifacts and make sure holmes-report.json is uploaded before trusting this PR summary.
  2. Regenerate the WATSON artifacts and make sure watson-report.json is uploaded before trusting this PR summary.
  3. Regenerate the MORIARTY artifacts and make sure moriarty-report.json is uploaded before trusting this PR summary.
🕵️ SHA-lock HOLMES full report for reference (click to expand)

Report unavailable for holmes: readable holmes-report.md artifact not found.

🩺 Dr. WATSON full report for reference (click to expand)

Report unavailable for watson: readable watson-report.md artifact not found.

🔮 Professor MORIARTY full report for reference (click to expand)

Report unavailable for moriarty: readable moriarty-report.md artifact not found.


📚 Glossary (what the Holmes terms mean)
  • HOLMES: Wesley’s main evidence investigation. It decides whether the cited proof is strong enough to justify shipping this commit.
  • WATSON: An independent verification pass. It checks Holmes’s citations and score math instead of trusting them blindly.
  • MORIARTY: A readiness forecast over time. It is advisory trend analysis, not the release gate itself.
  • Schema coverage score (SCS): How much of the schema has direct supporting evidence across generated artifacts and cited proof.
  • Test confidence index (TCI): How much test evidence exists for constraints, policies, relationships, and operations.
  • Migration risk index (MRI): How risky the schema change is to roll out. Lower is better.
  • Evidence trust: Whether the report is backed by exact citations, whole-file citations, or coarse references. Weak trust means the claim may be directionally right but not specific enough to trust blindly.
  • Citation quality: A count of exact line-span citations versus whole-file or coarse references.
  • ELEMENTARY: Ready to ship based on the current evidence.
  • REQUIRES INVESTIGATION: More work or review is needed before shipping.
  • YOU SHALL NOT PASS: Do not ship this change in its current state.

Machine-readable reports are grouped by schema set in workflow artifacts.


Filed at 221B Repository Street

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 054a5e6a74

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/check-doc-cli-commands.mjs
@flyingrobots

Copy link
Copy Markdown
Owner Author

Code Lawyer Activity Summary

# Severity Source File Issue Commit Outcome
1 P2 PR review scripts/check-doc-cli-commands.mjs Docs CLI checker collapsed unknown nested command-family subcommands such as wesley config bogus to the family command, allowing stale docs examples to pass. d497fa0 Fixed. Unknown nested subcommands under known command families are preserved and rejected unless the exact nested command exists; regression test added and wired into legacy preflight.

Verification

  • RED: node --test scripts/check-doc-cli-commands.test.mjs failed before the fix on config vs config bogus.
  • GREEN: node --test scripts/*.test.mjs
  • GREEN: node scripts/check-doc-cli-commands.mjs
  • GREEN: node scripts/preflight.mjs
  • GREEN: cargo xtask release-prep-guard --version 0.2.0
  • GREEN: pnpm exec prettier --check scripts/check-doc-cli-commands.mjs scripts/check-doc-cli-commands.test.mjs scripts/preflight.mjs
  • GREEN: git diff --check
  • GREEN: cargo xtask preflight
  • GREEN: cargo xtask release-check
  • GREEN: pre-push selected suite: Rust product preflight, JavaScript package preflight, repo Bats smoke suite

Resolved review thread: PRRT_kwDOPoavfs6MgwTK.

@flyingrobots flyingrobots merged commit 8bc51a7 into main Jun 26, 2026
20 checks passed
@flyingrobots flyingrobots deleted the release/v0.2.0 branch June 26, 2026 19:29
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.

Release gate: current minor release

1 participant