Skip to content

docs: roll over per-crate changelogs for 1.0.0-rc.3 - #307

Merged
StefanSteiner merged 1 commit into
tableau:mainfrom
StefanSteiner:docs/rollover-changelogs-rc3
Sep 7, 2026
Merged

docs: roll over per-crate changelogs for 1.0.0-rc.3#307
StefanSteiner merged 1 commit into
tableau:mainfrom
StefanSteiner:docs/rollover-changelogs-rc3

Conversation

@StefanSteiner

Copy link
Copy Markdown
Contributor

What

Post-tag bookkeeping for the v1.0.0-rc.3 release (main tip 82b45cb, the
chore: release main (#282) merge). This is the documented follow-up in
docs/GITHUB_OPERATIONS.md → "Rolling over the per-crate
changelogs"
:
nothing automates it, so entries for shipped work keep piling up under
## [Unreleased] until someone rolls them over by hand.

For each of the nine hand-maintained per-crate changelogs, ## [Unreleased]
was renamed to ## [1.0.0-rc.3] - 2026-09-07 and a fresh, empty
## [Unreleased] inserted above it. Pure heading rollover — no bullet was
reordered, reworded, or moved (git diff is +2 / -0 on every file: the dated
heading plus one blank line).

The date 2026-09-07 matches the root CHANGELOG.md's
## [1.0.0-rc.3] heading (release-please, UTC).

Crates rolled over (all nine were non-empty)

Crate Top-level bullets Subsections (as-is)
hyperdb-mcp 62 Added, Changed, Fixed, Security
hyperdb-api 31 Removed, Fixed, Changed, Added
hyperdb-bootstrap 12 Changed, Removed, Fixed
hyperdb-api-core 11 Added, Changed, Fixed
hyperdb-api-node 4 Changed, Fixed
hyperdb-compile-check 3 Fixed, Changed
hyperdb-api-derive 3 Changed, Fixed
hyperdb-api-salesforce 3 Changed
sea-query-hyperdb 1 Changed

None were left empty. In particular hyperdb-api-node (4 bullets) was
rolled over.

Not touched

  • Root CHANGELOG.md — release-please-owned.
  • npm sub-package changelogs under hyperdb-api-node/npm/* and
    hyperdb-mcp/npm/* — no ## [Unreleased] section.
  • No crate versions, Cargo.toml, version.txt, workflows, release-please
    config, or the v1.0.0-rc.3 tag/Release.

Verification

  • npx markdownlint-cli2 (no args): 0 issues in 68 files — identical to the
    upstream/main baseline. MD024 is siblings_only: true, so the new dated
    section's ### Fixed/### Added do not collide with the adjacent older
    dated section (different ## parents).
  • git diff --numstat: 2 0 on all nine files — pure heading insertion.

Notes for the reviewer

  • Preserved subsection order verbatim. Two sections are not in Keep a
    Changelog order — hyperdb-api (Removed, Fixed, Changed, Added) and
    hyperdb-compile-check (Fixed, Changed). They were left exactly as they sat
    under ## [Unreleased], per the "pure rollover, do not reorder" rule; happy
    to sort them into KaC order if preferred.
  • hyperdb-api-node has a pre-existing layout quirk: a release-please-style
    ## [0.1.3] … (2026-05-18) heading sits above ## [Unreleased], so the
    fresh ## [Unreleased] and the new ## [1.0.0-rc.3] now sit below it. Left
    as-is (out of scope for a pure rollover), but flagging it.
  • The dated sections aggregate more than rc.3. These per-crate changelogs
    had not been rolled over in a long time (hyperdb-api since 0.1.1,
    hyperdb-mcp since 0.5.0), so the accumulated ## [Unreleased] bullets
    describe work shipped across the whole 0.xrc range, now all stamped
    1.0.0-rc.3 as the procedure directs. hyperdb-mcp carries an explicit
    in-file HTML comment about two entries that landed retroactively in 0.7.3.
    Nothing here describes unshipped/future work.

Its own PR, not bundled with feature work.

Post-tag bookkeeping per docs/GITHUB_OPERATIONS.md ('Rolling over the
per-crate changelogs'). For each of the nine hand-maintained per-crate
changelogs, rename '## [Unreleased]' to '## [1.0.0-rc.3] - 2026-09-07'
(matching the root changelog's rc.3 date) and insert a fresh empty
'## [Unreleased]' above it.

Pure heading rollover: +2/-0 on every file, no bullet reordered or
reworded. All nine sections were non-empty. markdownlint-cli2 clean
(0 issues in 68 files). Root CHANGELOG.md, npm sub-package changelogs,
versions, and the tag are untouched.
@StefanSteiner
StefanSteiner merged commit b5fb14c into tableau:main Sep 7, 2026
3 checks passed
StefanSteiner added a commit that referenced this pull request Sep 7, 2026
… budget (#309)

* test: make changelog contract robust to rollover; bump restart budget

Fix A: smoke_demo_and_changelog_contract asserted KV/export/routing claims
only against the `## [Unreleased]` slice of the embedded mcp CHANGELOG.
PR #307 (the rc.3 changelog rollover) moved every bullet into
`## [1.0.0-rc.3]`, emptying Unreleased and failing the test. Because #307
was docs-only, CI's `paths-ignore: **/*.md` skipped the Rust suite, so the
break surfaced only on a later code PR. Assert instead against the current
release window (`## [Unreleased]` + the most-recent dated section) via a new
`current_release_window` helper, so a future rollover can't silently
rebreak it. The window is bounded to the newest dated section so a stale
token in an ancient entry can't satisfy a deleted-claim check.

Fix B: engine_recovers_after_hyperd_killed and
hyperd_monitor_detects_killed_hyperd_and_restarts time out on
ubuntu-latest under CI load — a 5s monitor tick plus cold hyperd spawn
against a 12s readiness budget. Replace the three magic `12`s with a named
RESTART_READINESS_BUDGET_SECS = 45 and document the derivation. Budget bump
only; the macOS-only ignore is unchanged, so Linux/Windows crash-recovery
coverage from #279/#286 stays. See #305.

* test: gate RESTART_READINESS_BUDGET_SECS to cfg(unix)

The constant's only use sites are the three `#[cfg(unix)]` restart tests
and their Unix-only helpers, so on Windows it compiled but was never
referenced and `clippy -D warnings` (windows-latest) rejected it as dead
code. Gate the definition with `#[cfg(unix)]` so it exists exactly where
it's used — the honest fix, not `#[allow(dead_code)]`.
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