release(v0.2.0): bump versions, finalize changelog, implement the release-check gate#16
Merged
Merged
Conversation
…ease-check gate Prepares the tree for the v0.2.0 tag (items 2, 3, 5 of the readiness review): - Bump every version location to 0.2.0: package.json, KIT_VERSION in lib/util.mjs, CITATION.cff (version + date-released), README BibTeX. ai/install-manifest.json is left as the historical install record; the checklist now documents the optional dogfooding re-install that refreshes it. - CHANGELOG: move [Unreleased] into a dated [0.2.0] section with its link reference, keep an empty [Unreleased] section, and add the release-check entry shipping in this release. - Implement ai/lab/specs/SPEC_release-check.md (approved 2026-07-02): test/release-check.mjs (version-sync, changelog-gate, informational coverage report, cli-docs-sync; pre-tag and tag modes; --full), npm run release-check, .github/workflows/release-check.yml on v* tags, fixture scenarios in test/run-tests.mjs (196/196 green), and step 0 of the generalized docs/RELEASE-CHECKLIST.md. - Knowledge layer updated as [inferred]: MODULE_MAP test/ row, FEATURE_MAP release-check entry, FEATURE_CATALOG F13; spec marked implemented. - release.yml step renamed (the last 'both installers' artifact); CHECKSUMS regenerated; VERIFICATION_REPORT refreshed (156 claims confirmed). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZrQa7Mtd3Jy5W6Fa4nxPT
The section covered only five headline features in long paragraphs while omitting several things implemented since v0.1.2. Rewritten against git log v0.1.2..HEAD: one bold-lead line per change, now also covering the Windows CI / lockfile fixes, the drift-baseline repairs, the new docs set (CLI reference, methodology, multi-tool setup, rebuilt hub), the README overhaul, the generalized release checklist, the lessons-learnt series, the upcoming-features spec sheet, and the knowledge-layer reports and diagrams. release-check's coverage report now confirms every changed source area is mentioned in the section. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZrQa7Mtd3Jy5W6Fa4nxPT
There was a problem hiding this comment.
Pull request overview
Prepares the repository for the v0.2.0 release by synchronizing version strings across published metadata, finalizing the changelog for the release, and introducing a deterministic “release-check” gate (local script + CI workflow) to prevent release-time drift.
Changes:
- Bump and synchronize version references to
0.2.0acrosspackage.json,lib/util.mjs,CITATION.cff, and README citation metadata. - Promote CHANGELOG
[Unreleased]content into a dated[0.2.0]section and add/refresh link references. - Add a deterministic
release-checkscript with smoke-test fixtures, npm script wiring, and a tag-triggered GitHub Actions workflow; update docs and knowledge maps accordingly.
Reviewed changes
Copilot reviewed 16 out of 16 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
test/run-tests.mjs |
Adds fixture scenarios covering release-check failure modes and a self-gate run against the kit repo. |
test/release-check.mjs |
Introduces the deterministic release gate script (version-sync, changelog gate, coverage report, CLI-docs sync, optional full gates). |
README.md |
Updates BibTeX citation version to 0.2.0. |
package.json |
Bumps version to 0.2.0 and adds npm run release-check. |
lib/util.mjs |
Updates KIT_VERSION to 0.2.0. |
docs/RELEASE-CHECKLIST.md |
Generalizes the checklist and adds “Step 0” for running the release gate. |
CITATION.cff |
Updates version and release date for 0.2.0. |
CHECKSUMS.txt |
Refreshes checksum(s) impacted by the version bump. |
CHANGELOG.md |
Finalizes the 0.2.0 release section and updates link references. |
ai/lab/specs/SPEC_release-check.md |
Marks the release-check spec as implemented and checks off knowledge updates. |
ai/guide/MODULE_MAP.md |
Updates the test/ row to include the release gate. |
ai/guide/FEATURE_MAP.md |
Adds a release-check feature entry and verification command. |
ai/analysis/FEATURE_CATALOG.md |
Adds F13 entry documenting the release-check gate. |
ai/analysis/audit-reports/VERIFICATION_REPORT.md |
Updates confirmed-claims counts in the verification report. |
.github/workflows/release.yml |
Renames the smoke-test step label. |
.github/workflows/release-check.yml |
Adds a new workflow running the release gate on v* tags and via workflow_dispatch. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+147
to
+155
| const git = (...args) => spawnSync("git", ["-C", root, ...args], { encoding: "utf8" }); | ||
| const lastTag = git("describe", "--tags", "--abbrev=0").stdout.trim(); | ||
| if (!lastTag) { | ||
| note("skipped — no git history or no previous tag reachable from HEAD"); | ||
| } else if (!releaseSectionText) { | ||
| note(`skipped — no changelog section to match against`); | ||
| } else { | ||
| const files = git("diff", "--name-only", `${lastTag}..HEAD`).stdout | ||
| .split("\n").map((f) => f.trim()).filter(Boolean); |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Prepares the tree for the v0.2.0 tag (items 2, 3, 5 of the readiness review):
lib/util.mjs, CITATION.cff (version + date-released), README BibTeX.
ai/install-manifest.json is left as the historical install record; the
checklist now documents the optional dogfooding re-install that refreshes it.
reference, keep an empty [Unreleased] section, and add the release-check
entry shipping in this release.
test/release-check.mjs (version-sync, changelog-gate, informational
coverage report, cli-docs-sync; pre-tag and tag modes; --full),
npm run release-check, .github/workflows/release-check.yml on v* tags,
fixture scenarios in test/run-tests.mjs (196/196 green), and step 0 of
the generalized docs/RELEASE-CHECKLIST.md.
release-check entry, FEATURE_CATALOG F13; spec marked implemented.
regenerated; VERIFICATION_REPORT refreshed (156 claims confirmed).
Co-Authored-By: Claude Fable 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01YZrQa7Mtd3Jy5W6Fa4nxPT