Skip to content

release-process: mark v0.10 alpha as published - #80

Merged
flyingrobots merged 2 commits into
mainfrom
post-v0.10-release-hygiene
Jun 29, 2026
Merged

release-process: mark v0.10 alpha as published#80
flyingrobots merged 2 commits into
mainfrom
post-v0.10-release-hygiene

Conversation

@flyingrobots

Copy link
Copy Markdown
Owner

Post-publication hygiene for v0.10.0-alpha.1 (mirrors #72 for v0.9). Records durable evidence on main without touching the immutable tag.

v0.10.0-alpha.1 is published as a GitHub prerelease:

Changes

  • policy.toml v0_10 boundary publish_ready → published + evidence; release_policy_tracks_v0_10_boundary now asserts the published fields.
  • docs/releases/v0.10.0-alpha.1.md: published status, publication evidence, Publication Evidence section.
  • ROADMAP / README / release-process README / test-plan: mark published with URL, tag, run IDs, milestone closure.
  • CHANGELOG: publish-marking under [Unreleased].

cargo test -p xtask release_policy_tracks_v0_10_boundary ✅ · cargo xtask verify ✅ · markdownlint ✅.

Record durable post-publication evidence for v0.10.0-alpha.1 without changing
the immutable release tag:

- policy.toml v0_10 boundary: status publish_ready -> published, plus tag,
  workflow-run, milestone-closure, and no-crates evidence; the
  release_policy_tracks_v0_10_boundary regression now asserts the published
  fields.
- docs/releases/v0.10.0-alpha.1.md: published status, publication evidence, and
  Publication Evidence section.
- ROADMAP, README, release-process README, and test-plan: mark the release
  published with release URL, tag, run IDs, and milestone closure.
- CHANGELOG: note the publish-marking under [Unreleased].

Release: https://github.com/flyingrobots/edict/releases/tag/v0.10.0-alpha.1
@coderabbitai

coderabbitai Bot commented Jun 29, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@flyingrobots, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 53 minutes and 52 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more credits in the billing tab to continue.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 751604b1-a649-41df-bd8d-8d21766a82c2

📥 Commits

Reviewing files that changed from the base of the PR and between d2fbede and e79e4f1.

📒 Files selected for processing (1)
  • docs/topics/release-process/test-plan.md

Walkthrough

Records post-publication evidence for v0.10.0-alpha.1 by changing its status from publish_ready to published in policy.toml, populating all release metadata fields (timestamps, URLs, tag/commit hashes, CI run IDs, milestone closure), updating the release notes doc, release-process README, ROADMAP, README, CHANGELOG, test-plan fixture table, and xtask contract-check assertions.

Changes

v0.10.0-alpha.1 Publication Evidence Recording

Layer / File(s) Summary
policy.toml status + xtask contract assertions
docs/topics/release-process/policy.toml, xtask/src/main.rs
v0_10_0_alpha_1 status set to published; all metadata fields (published_at, release_url, tag/commit hashes, CI run IDs, milestone closure, crates_io_published) populated. release_policy_tracks_v0_10_boundary test updated to assert the new status and all additional fields.
Release notes doc
docs/releases/v0.10.0-alpha.1.md
Status wording updated to reflect publication; Published timestamp, release URL, annotated tag object, and peeled commit added; verification checklist rewritten as "completed" results; "Tagging Plan" replaced with structured "Publication Evidence" section containing workflow run IDs.
Release-process README and test-plan
docs/topics/release-process/README.md, docs/topics/release-process/test-plan.md
README bullet updated from "publish-ready" to "published"; detailed evidence block with CI run IDs, milestone closure timestamp, topic-shelf audit counts, and no-crates confirmation inserted. Test-plan fixtures table gains a row for docs/releases/v0.10.0-alpha.1.md.
Surface docs
ROADMAP.md, README.md, CHANGELOG.md
ROADMAP adds publication status, milestone (#11), closed-issue annotations, release URL, and tag-to-commit hash. README expands v0.10.0-alpha.1 bullet and release-history paragraph. CHANGELOG records the publication evidence under Unreleased/Changed.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

Possibly related PRs

  • flyingrobots/edict#61: Identical pattern — status changed from publish_ready to published with full metadata population and matching xtask boundary assertion updates, for v0.7.0-alpha.1.
  • flyingrobots/edict#43: Modifies policy.toml and xtask/src/main.rs release-policy metadata and contract-check expectations for other release versions using the same field schema.
  • flyingrobots/edict#26: Introduced the release-process topic shelf and the xtask evidence contract verification wiring that this PR's assertions extend.

Poem

📋 The tag was cast, the milestone shut,
The evidence filed, the changelog cut.
publish_readypublished at last,
CI run IDs forever amassed.
No crates.io touched, the record stands tall —
The most thorough docs for the least runtime at all. 🗂️

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: marking the v0.10 alpha release as published.
Description check ✅ Passed The description clearly matches the changeset and summarizes the release-process updates and evidence.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

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.

@coderabbitai coderabbitai 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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/topics/release-process/test-plan.md`:
- Line 69: Add the missing v0.10 requirement and test-case rows to the topic
test plan so it covers the v0.10.0-alpha.1 release boundary and the executable
evidence release_policy_tracks_v0_10_boundary. Update the relevant entries in
test-plan.md with new RELEASE-REQ-* and RELEASE-TP-* rows, linking the fixture,
oracle, and implemented evidence so the owning shelf matches the test added in
this PR.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: c5cfce96-2f75-43bc-8d46-201b96534083

📥 Commits

Reviewing files that changed from the base of the PR and between 6228341 and d2fbede.

📒 Files selected for processing (8)
  • CHANGELOG.md
  • README.md
  • ROADMAP.md
  • docs/releases/v0.10.0-alpha.1.md
  • docs/topics/release-process/README.md
  • docs/topics/release-process/policy.toml
  • docs/topics/release-process/test-plan.md
  • xtask/src/main.rs
📜 Review details
🧰 Additional context used
📓 Path-based instructions (3)
**

⚙️ CodeRabbit configuration file

**: # AGENTS

Git Rules

NEVER amend git commits. Make a new commit instead.

NEVER use git rebase unless the user explicitly approves a rare exception.
Use regular merge commits.

NEVER force any git operation. If a force operation appears necessary, stop and
explain what happened and what options remain.

NEVER create draft pull requests.

NEVER use a codex prefix in branch names, PR titles, or commit messages.

Pull request bodies for issue work MUST include GitHub auto-close text such as
Closes #123`` for every issue the PR is intended to close.

Think

Think is durable memory for cross-session coordination.

  • Use codex-think --remember --json when starting a new session, changing into
    this repository, or regaining context after a context shift.
  • Use codex-think "..." --json when a cycle closes or a significant event
    should survive across turns.
  • Treat Think as memory, not repo truth. Anchor strong claims back to files,
    commits, commands, issues, or pull requests.
  • Claude memories are read-only. Use claude-think --remember --json only for
    additional context.

Topic Shelves

docs/topics/ contains the living contract graph for landed behavior. Topic
shelves are not proposals, retrospectives, or design archaeology.

Each shelf may contain:

  • README.md: what is true in HEAD.
  • test-plan.md: how those truths are verified, including requirements, cases,
    fixtures, oracles, implemented evidence, planned cases, and known gaps.
  • architecture.md: optional structure or dataflow notes when the machinery
    earns a separate page.
  • rationale.md: optional still-relevant tradeoffs and rejected approaches.

When To Update Topic Shelves

For every nontrivial behavior, contract, workflow, release, schema, validation,
or public-surface change:

  1. Identify the owning topic shelf before editing code.
  2. If no shelf owns durable behavior, create one.
  3. Update test-plan.md before or alongside tests with requirement IDs, case
    IDs,...

Files:

  • CHANGELOG.md
  • docs/topics/release-process/test-plan.md
  • docs/topics/release-process/policy.toml
  • README.md
  • ROADMAP.md
  • docs/releases/v0.10.0-alpha.1.md
  • docs/topics/release-process/README.md
  • xtask/src/main.rs
docs/topics/**/test-plan.md

📄 CodeRabbit inference engine (AGENTS.md)

docs/topics/**/test-plan.md: Update a topic shelf test-plan.md before or alongside tests with requirement IDs, case IDs, fixtures, oracles, implemented evidence, planned cases, and known gaps.
Mark planned cases as implemented only when executable evidence exists.
Do not use policy rows in topic-shelf test plans to avoid writing behavior tests for software behavior.
Negative tests in topic-shelf test plans should assert stable error kinds or structured artifacts, not merely is_err() or diagnostic text.
For nontrivial behavior, contract, workflow, release, schema, validation, or public-surface changes, update the owning topic test-plan.md with planned requirement and case rows before or alongside the first test.
Mark planned rows as implemented only after executable evidence exists.

Files:

  • docs/topics/release-process/test-plan.md
docs/topics/**/README.md

📄 CodeRabbit inference engine (AGENTS.md)

docs/topics/**/README.md: Topic shelf README.md files must describe only what is true in HEAD.
Update the topic shelf README.md only after the behavior exists in the branch; do not describe intended future behavior there.
Do not churn topic-shelf README files for purely mechanical edits that do not change a contract.

Files:

  • docs/topics/release-process/README.md
🔇 Additional comments (8)
ROADMAP.md (1)

399-408: LGTM!

README.md (2)

523-529: LGTM!


575-580: LGTM!

CHANGELOG.md (1)

11-16: LGTM!

docs/topics/release-process/policy.toml (1)

400-414: LGTM!

xtask/src/main.rs (1)

2736-2750: LGTM!

docs/releases/v0.10.0-alpha.1.md (1)

5-6: LGTM!

Also applies to: 17-24, 91-127

docs/topics/release-process/README.md (1)

75-75: LGTM!

Also applies to: 97-111

Comment thread docs/topics/release-process/test-plan.md
Address CodeRabbit: the v0.10 release notes fixture had no matching
RELEASE-REQ / RELEASE-TP coverage. Add RELEASE-REQ-022 and the RELEASE-TP-017
boundary guard citing release_policy_tracks_v0_10_boundary, mirroring the
RELEASE-REQ-021 / RELEASE-TP-016 pair for v0.9.
@flyingrobots

Copy link
Copy Markdown
Owner Author

Resolved in e79e4f1. Added RELEASE-REQ-022 and the RELEASE-TP-017 boundary guard citing release_policy_tracks_v0_10_boundary, mirroring the RELEASE-REQ-021 / RELEASE-TP-016 pair for v0.9. cargo xtask verify (contract-check) green.

@coderabbitai good catch — that pair belonged in the release-prep PR.

@coderabbitai

coderabbitai Bot commented Jun 29, 2026

Copy link
Copy Markdown

Tip

For best results, initiate chat on the files or code changes.

@flyingrobots Nice — that closes the gap cleanly. The mirrored RELEASE-REQ-022 / RELEASE-TP-017 guard and the green contract-check are exactly what I wanted to see.

ᕱᕱ ✨


If you found this review helpful, would you consider giving us a shout-out on X?

Thank you for using CodeRabbit!

@flyingrobots
flyingrobots merged commit d607605 into main Jun 29, 2026
3 checks passed
@flyingrobots
flyingrobots deleted the post-v0.10-release-hygiene branch June 29, 2026 04:34

@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: d2fbede8fe

ℹ️ 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 ROADMAP.md
Comment on lines +399 to +405
Status: published

Milestone: `v0.10.0-alpha.1` (#11)

Primary issues: #75, #76 (closed)

Release: <https://github.com/flyingrobots/edict/releases/tag/v0.10.0-alpha.1>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Update the artifact map when marking v0.10 published

Marking the release as published here leaves the same roadmap internally inconsistent: the GitHub Artifact Map still lists v0.10.0-alpha.1 as planned, issues TBD instead of the milestone/issues now recorded in this section. Readers using the artifact map after this publication will get stale release tracking data, so update that entry in the same change.

Useful? React with 👍 / 👎.

| docs/releases/v0.6.0-alpha.1.md | Published release notes for the developer-tooling alpha. | The release workflow looks up this file by full tag name. |
| docs/releases/v0.7.0-alpha.1.md | Published release notes for the file-backed authority-facts alpha. | The release workflow looked up this file by full tag name after the release-prep PR merged. |
| docs/releases/v0.8.0-alpha.1.md | Published release notes for the minimal effectful compiler-spine alpha. | The release workflow looked up this file by full tag name after the release-prep PR merged. |
| docs/releases/v0.10.0-alpha.1.md | Published release notes for the first public CLI alpha. | The release workflow looked up this file by full tag name after the release-prep PR merged. |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Add the v0.10 requirement and case rows

This only adds the v0.10 release notes as a fixture, but the release-process test plan still has no RELEASE-REQ-* or RELEASE-TP-* row for the release_policy_tracks_v0_10_boundary evidence added in xtask. That violates the repo-level AGENTS.md instruction for release/contract changes to update test-plan.md with requirement IDs and case IDs, and leaves the durable test plan unable to explain which requirement the v0.10 publication metadata test covers.

Useful? React with 👍 / 👎.

Comment on lines +411 to +412
milestone_closed_at = "2026-06-29T04:21:11Z"
milestone_open_issues = 0

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Correct the v0.10 milestone publication evidence

As of this review, the public milestone #11 page still shows v0.10.0-alpha.1 as Open with 2 open issues (#76 and #79), so these structured fields lock false release evidence into release_policy_tracks_v0_10_boundary. Please either update the recorded evidence to match the actual GitHub state or close the milestone/issues before asserting milestone_closed_at and milestone_open_issues = 0.

Useful? React with 👍 / 👎.

Comment thread ROADMAP.md

Milestone: `v0.10.0-alpha.1` (#11)

Primary issues: #75, #76 (closed)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Don't mark issue #76 closed while it is still open

The public issue page for #76 still reports the release issue as Open, so adding (closed) for both primary issues makes the roadmap's v0.10 status inaccurate even though #75 is closed. Update this parenthetical to distinguish the open release issue, or close #76 before landing the publication evidence.

Useful? React with 👍 / 👎.

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.

1 participant