Skip to content

docs(changelog): backfill in-repo release history across all 3 packages - #114

Merged
kurone-kito merged 10 commits into
mainfrom
issue/107-backfill-repo-release-history-across-all
Aug 10, 2026
Merged

docs(changelog): backfill in-repo release history across all 3 packages#114
kurone-kito merged 10 commits into
mainfrom
issue/107-backfill-repo-release-history-across-all

Conversation

@kurone-kito

@kurone-kito kurone-kito commented Aug 10, 2026

Copy link
Copy Markdown
Owner

Summary

Backfill sea-builder, typescript-config, and vite-lib-config's
CHANGELOG.md (scaffolded empty in #106) with every merged PR through
#113, classified deterministically:

  1. Conventional Commits scope naming a target package.
  2. Otherwise, the PR's changed-file paths under
    packages/<target-package>/.
  3. A PR touching only example-cli/example-lib/no packages/ path
    gets no entry (listed below).
  4. A PR touching more than one target package's directory gets an
    entry in each.

The target range grew from the issue's original #2#104 to include
#112/#113, both merged after this issue was authored — re-verified
per the issue's own instruction before starting.

typescript-config's ## [0.20.0] section only records the
lints-config migration note, per #106's policy; its detailed
pre-migration history is issue #108's concern.

Excluded

Acceptance criteria

  • Every PR in the range is accounted for (entry or exclusion above)
  • Each package's CHANGELOG.md has version headings only where it
    has entries for that release
  • typescript-config's ## [0.20.0] includes the migration note
  • pnpm run lint passes

Closes #107

Summary by CodeRabbit

  • Documentation
    • Added unreleased changelog entries across project packages.
    • Documented updated Node.js and pnpm requirements, dependency upgrades, and configuration changes.
    • Recorded CI, coverage, archive verification, safer package execution, and published documentation improvements.
    • Clarified TypeScript and Vite updates, including documentation and build-target changes.
    • Added historical release notes for versions 0.20.0 and 0.21.0.
    • Preserved existing release history while improving visibility into recent fixes and enhancements.

sea-builder, typescript-config, and vite-lib-config all shipped
CHANGELOG.md scaffolding with an empty Unreleased heading in #106,
but none of their release history was populated yet. Classify every
merged PR through #113 by Conventional Commits scope, falling back
to changed-file paths under each package's directory, and add Keep
a Changelog entries to whichever of the three packages each PR
actually touched, under Unreleased / 0.21.0 / 0.20.0 as applicable.
typescript-config's 0.20.0 section only records the lints-config
migration note per #106's policy, since its own pre-migration
history is issue #108's concern.

Refs #107
Copilot AI lite review requested due to automatic review settings August 10, 2026 09:03
@coderabbitai

This comment has been minimized.

@kurone-kito

This comment has been minimized.

This comment was marked as resolved.

chatgpt-codex-connector[bot]

This comment was marked as resolved.

Copilot and Chatgpt-codex flagged three findings on PR #114: (1)
typescript-config's migration note referenced content further down
the file that does not exist yet, until #108 backfills it -- point
at that tracking issue instead; (2) sea-builder was missing a 0.21.0
section even though PR #19 bumped its listr2 dependency and version,
verified against the actual file diff; (3) #45's changelog entry
duplicated #44's undici bump -- #45's merge commit has an empty diff
against its first parent, confirmed with git diff, since the same
change had already landed by the time it merged.

Refs #107
@kurone-kito
kurone-kito requested a lite review from Copilot August 10, 2026 09:35
@kurone-kito

This comment has been minimized.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Suppressed comments (1)

packages/typescript-config/CHANGELOG.md:34

  • The PR references at the end of this entry are a bit hard to parse as (#108) (#2). Consider consolidating into a single parenthetical so it’s clear which PR is the initial migration vs the follow-up backfill.
- Migrated from `kurone-kito/lints-config`; its pre-migration history
  will be backfilled in a follow-up (#108) (#2).

Copilot flagged the 0.20.0 migration note on PR #114: two adjacent
parenthetical PR references, "(#108) (#2)", read ambiguously. Move
#2 next to the migration it documents and keep #108 with the
follow-up clause it belongs to.

Refs #107
@kurone-kito

Copy link
Copy Markdown
Owner Author

Accepted — Copilot's suppressed comment on packages/typescript-config/CHANGELOG.md:34 (v6b62dd1) was correct: (#108) (#2) read ambiguously as two adjacent references. Fixed in 72e5ac5.

@kurone-kito
kurone-kito requested a lite review from Copilot August 10, 2026 10:05
@kurone-kito

This comment has been minimized.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

chatgpt-codex-connector[bot]

This comment was marked as resolved.

Chatgpt-codex flagged the 0.21.0 entry on PR #114: "Improved the
TypeScript configuration" hid that #19 added erasableSyntaxOnly:
true, verified against the actual tsconfig.json diff, a breaking
change for any 0.20 consumer using syntax that needs emit-time
transformation. Name the option and mark it breaking.

Refs #107
@kurone-kito
kurone-kito requested a lite review from Copilot August 10, 2026 10:37
@kurone-kito

This comment has been minimized.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

chatgpt-codex-connector[bot]

This comment was marked as resolved.

Chatgpt-codex flagged the shared Breaking entry on PR #114: it only
described dropping Node.js 20, hiding that #88 also raised the floor
within Node.js 22/24 and dropped Node.js 25 entirely, verified
against the actual engines.node diff in all three package.json
files. State the exact before/after ranges in each of the three
CHANGELOGs.

Refs #107
@kurone-kito
kurone-kito requested a lite review from Copilot August 10, 2026 11:07
@kurone-kito

This comment has been minimized.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

chatgpt-codex-connector[bot]

This comment was marked as resolved.

Chatgpt-codex flagged that the 0.21.0 section on PR #114 only
recorded the TypeDoc pipeline, omitting that #19 also bumped the
runtime type-fest and vite dependencies, verified against the
actual package.json diff. type-fest jumped a major version and is
used by the exported ViteConfigOptions type.

Refs #107
Proactively audited every entry-bearing PR (#19, #41, #42, #44, #66,
#70-#76, #88) against actual package.json diffs, applying the same
"runtime dep / breaking config / vague wording" lens Codex used across
five prior review rounds, instead of waiting for another round-trip.

Found: #19 also bumped cpy-cli and typescript devDependencies in all
three target packages (plus type-fest and undici for sea-builder),
none previously recorded under 0.21.0. Also replaced the vague
"grouped Dependabot update (#44)" wording in sea-builder and
vite-lib-config with the actual packages/versions it bumped, matching
this backfill's established granularity for every other dependency
bump entry.

Refs #107
chatgpt-codex-connector[bot]

This comment was marked as resolved.

@kurone-kito

Copy link
Copy Markdown
Owner Author

Self-initiated audit — After five rounds of Codex findings all sharing one shape (runtime dep bumps / breaking config changes / vague wording missed by title-derived entries), I re-applied that same lens myself across every entry-bearing PR in this backfill's range (#19, #41, #42, #44, #66, #70-#76, #88) instead of waiting for another round-trip.

Verified against gh api .../pulls/<n>/files --paginate and found two more gaps of the same shape:

No other gaps found (#41/#42/#66/#75/#76 already correctly documented; #88's target-package changes are fully covered by the existing engines.node and Vite build-target entries).

Fixed in 493b7ce (round-6 finding) and a7603b6 (this audit).

@kurone-kito
kurone-kito requested a lite review from Copilot August 10, 2026 12:14
@kurone-kito

This comment has been minimized.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Chatgpt-codex flagged three more gaps in the reviewed release notes,
each verified against the actual PR diff before accepting:

- typescript-config's peerDependencies still advertises `>=5.7.x`,
  but erasableSyntaxOnly (enabled in #19) requires TypeScript 5.8+;
  noted the effective floor so consumers on 5.7 know to upgrade.
- #88 also fixed vite-lib-config's TypeDoc build (resolving
  typedoc-plugin-markdown under pnpm's virtual store) and added
  working external link mappings for Vite symbols in the generated
  docs, previously undocumented.
- #70's JSDoc fix entry only mentioned the shebang/library-mode
  branch inversion; broadened it to cover the filtered-entries and
  mixed-entries behavior it also documented, and vitestConfig's
  wholesale rewrite from a copy-pasted, incorrect description to its
  actual test.environment merge behavior.

Refs #107
@kurone-kito
kurone-kito requested a lite review from Copilot August 10, 2026 12:44
@kurone-kito

This comment has been minimized.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Suppressed comments (2)

packages/sea-builder/CHANGELOG.md:14

  • The changelog correctly attributes the initial CHANGELOG.md scaffolding to PR #112, but this PR’s description says the files were "scaffolded empty in #106" (which appears to be the issue number closed by #112). Please align the PR description wording so it references PR #112 (or clarify that #106 is an issue, not a PR) to avoid confusion when tracing history.
- `CHANGELOG.md` (#112).

packages/sea-builder/CHANGELOG.md:22

  • Version formatting is inconsistent in this section: other entries wrap exact versions in backticks (e.g. 7.24.0), but this line uses a literal "v7.28.0" without backticks. For consistency (and to keep Markdownlint-friendly formatting), format it like the other version literals.
- Bumped the `undici` devDependency to v7.28.0 (#66).

chatgpt-codex-connector[bot]

This comment was marked as resolved.

Chatgpt-codex flagged that the 0.21.0 entry enumerating #19's other
build-time dependency bumps for sea-builder omitted vite ^7.0.0 to
^7.1.9, verified against the actual package.json diff.

Refs #107
@kurone-kito
kurone-kito requested a lite review from Copilot August 10, 2026 13:12
@kurone-kito

This comment has been minimized.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

@kurone-kito

This comment has been minimized.

@kurone-kito

Copy link
Copy Markdown
Owner Author

Rejected — coderabbitai[bot] did not review HEAD 8be2cd2 (review limit reached / rate limited); this is not a completed review (source: #issuecomment-5238092912)

@kurone-kito

This comment has been minimized.

@kurone-kito
kurone-kito merged commit 726f6bf into main Aug 10, 2026
27 of 29 checks passed
@kurone-kito
kurone-kito deleted the issue/107-backfill-repo-release-history-across-all branch August 10, 2026 13:29
@github-actions

Copy link
Copy Markdown

F4 Cleanup Evidence (server-side fallback via post-merge-cleanup.yml)

Field Value
Status applied
Applied 31
Failed 0
Skipped 8
Permission-blocked 0
Posted by post-merge-cleanup workflow

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.

Backfill in-repo release history across all 3 packages

2 participants