frankenbit/release-toolkit

Fork 0

chore(release): v0.17.0 #227

Merged

quartermaster merged 1 commit from release-prep/rolling into main

2026-06-28 15:06:03 +02:00

release-bot commented

2026-06-28 13:22:06 +02:00

Member

Added

Added examples/go-project and examples/node-project — complete drop-in consumer bootstraps (config + the two wrapper workflows + a CHANGELOG skeleton + version file) you can cp -r into a new repo to adopt the toolkit, plus an examples/README.md index. Post-Phase-2 shape (no toolkit_ref: input; @v0.16.0 pin).

api_call structured event: forgejo_api_call now emits one JSON event per real API call (endpoint, method, status, ms) to stderr, giving Loki-ingestable observability over the toolkit's Forgejo interactions including latency and non-2xx failures. Emitted at the wrapper on every real call (not in dry-run); ms is the curl wall-clock in integer milliseconds. The emit is guarded so forgejo-api.sh keeps no hard dependency on the events substrate -- callers that sourced events.sh get the event, others degrade cleanly to no-emit. (Part 1 of #204; the workflow-level cut_complete.ms_total remains deferred to the next compose-script cut.)

The toolkit now dogfoods its own post_bump_hooks on its own docs: a new hook (scripts/hooks/update-doc-version-refs.sh), wired in release-toolkit.yml, re-pins the adopter-facing example refs in README.md + docs/integration.md to the freshly-cut tag on every cut -- eliminating the manual doc-ref-pin drift class (#196 was the recurring manual fix; Shipwright #157 found the dogfooding gap). The hook preserves historical "feature-since" references (e.g. v0.12.0+) and pins only the @vX.Y.Z / Latest: / Replace example shapes. A new RELEASE_TOOLKIT_RELEASE_DATE env var is exported to all post_bump_hooks (the cut date, matching the CHANGELOG heading) so hooks can refresh dated examples. The post_bump_hooks docs now also document the staging convention (hooks must git add their own changes; release-prep commits only staged files).

hooks: dogfood post_bump_hooks for own doc ref-pins (#209)
forgejo-api: emit api_call structured event (#204 part 1)

Changed

docs: sweep adopter-facing ref pins (README + integration.md) to @v0.16.0 (#196).

Fixed

Corrected adopter-facing integration.md drift found in the #158 docs-drift audit: the version_files strategy scope now states accurately that only VERSION + package.json are handled (replacing the invented, mutually-contradictory "v0.3 scope"/"v0.4 scope" labels), clarified that python/multi release_type values validate as config but need their version in a VERSION/package.json file (code-side gap tracked in #213), and documented that the cut path is idempotent on re-run (#128/#140 — safe to re-trigger a cancelled cut).

release-prep.sh --dry-run no longer requires a configured origin remote when none is present. Dry-run skips every remote write, and the sole use of origin is owner/repo inference that (in dry-run) feeds only dry-run-noop API calls plus the echoed owner=/repo= outputs -- so a fresh scratch repo with no remote can now preview a cut. The real git-history read (LAST_TAG via git describe) uses local tags, not the remote. A present-but-unparseable remote stays fatal even in dry-run (a genuine misconfiguration dry-run should surface), and production cuts still hard-require origin. Also fixes a latent silent-abort in the same path: an unparseable remote previously tripped set -e at the owner/repo assignment before the "could not derive owner/repo" diagnostic could print.

release-prep: relax origin requirement in dry-run (#216)
cut path: add [skip ci] to bake-reset commit to suppress CI noise (#202)

### Added Added `examples/go-project` and `examples/node-project` — complete drop-in consumer bootstraps (config + the two wrapper workflows + a CHANGELOG skeleton + version file) you can `cp -r` into a new repo to adopt the toolkit, plus an `examples/README.md` index. Post-Phase-2 shape (no `toolkit_ref:` input; `@v0.16.0` pin). `api_call` structured event: `forgejo_api_call` now emits one JSON event per real API call (`endpoint`, `method`, `status`, `ms`) to stderr, giving Loki-ingestable observability over the toolkit's Forgejo interactions including latency and non-2xx failures. Emitted at the wrapper on every real call (not in dry-run); `ms` is the curl wall-clock in integer milliseconds. The emit is guarded so `forgejo-api.sh` keeps no hard dependency on the events substrate -- callers that sourced `events.sh` get the event, others degrade cleanly to no-emit. (Part 1 of #204; the workflow-level `cut_complete.ms_total` remains deferred to the next compose-script cut.) The toolkit now dogfoods its own `post_bump_hooks` on its own docs: a new hook (`scripts/hooks/update-doc-version-refs.sh`), wired in `release-toolkit.yml`, re-pins the adopter-facing example refs in `README.md` + `docs/integration.md` to the freshly-cut tag on every cut -- eliminating the manual doc-ref-pin drift class (#196 was the recurring manual fix; Shipwright #157 found the dogfooding gap). The hook preserves historical "feature-since" references (e.g. `v0.12.0+`) and pins only the `@vX.Y.Z` / `Latest:` / `Replace` example shapes. A new `RELEASE_TOOLKIT_RELEASE_DATE` env var is exported to all post_bump_hooks (the cut date, matching the CHANGELOG heading) so hooks can refresh dated examples. The post_bump_hooks docs now also document the staging convention (hooks must `git add` their own changes; release-prep commits only staged files). - **hooks**: dogfood post_bump_hooks for own doc ref-pins (#209) - **forgejo-api**: emit api_call structured event (#204 part 1) ### Changed docs: sweep adopter-facing ref pins (README + integration.md) to `@v0.16.0` (#196). ### Fixed Corrected adopter-facing `integration.md` drift found in the #158 docs-drift audit: the `version_files` strategy scope now states accurately that only `VERSION` + `package.json` are handled (replacing the invented, mutually-contradictory "v0.3 scope"/"v0.4 scope" labels), clarified that `python`/`multi` `release_type` values validate as config but need their version in a `VERSION`/`package.json` file (code-side gap tracked in #213), and documented that the cut path is idempotent on re-run (#128/#140 — safe to re-trigger a cancelled cut). `release-prep.sh --dry-run` no longer requires a configured `origin` remote when none is present. Dry-run skips every remote write, and the sole use of `origin` is owner/repo inference that (in dry-run) feeds only dry-run-noop API calls plus the echoed `owner=`/`repo=` outputs -- so a fresh scratch repo with no remote can now preview a cut. The real git-history read (`LAST_TAG` via `git describe`) uses local tags, not the remote. A *present-but-unparseable* remote stays fatal even in dry-run (a genuine misconfiguration dry-run should surface), and production cuts still hard-require `origin`. Also fixes a latent silent-abort in the same path: an unparseable remote previously tripped `set -e` at the owner/repo assignment before the "could not derive owner/repo" diagnostic could print. - **release-prep**: relax origin requirement in dry-run (#216) - **cut path**: add [skip ci] to bake-reset commit to suppress CI noise (#202)

forgejo-actions force-pushed release-prep/rolling from 302be541ba

check-self-bootstrap / check (pull_request) Successful in 3s

Details

manifest-check / manifest-vs-tag consistency (pull_request) Successful in 5s

Details

manifest-check / check (pull_request) Successful in 0s

Details

to 068735925f

2026-06-28 13:25:45 +02:00

Compare

forgejo-actions force-pushed release-prep/rolling from 068735925f to 8e38d98d87

2026-06-28 13:31:48 +02:00

Compare

forgejo-actions force-pushed release-prep/rolling from 8e38d98d87 to 4069f7fa87

2026-06-28 14:04:22 +02:00

Compare

forgejo-actions force-pushed release-prep/rolling from 4069f7fa87 to ef69dcea0f

2026-06-28 14:10:51 +02:00

Compare

forgejo-actions force-pushed release-prep/rolling from ef69dcea0f to eec0870789

2026-06-28 14:30:26 +02:00

Compare

forgejo-actions force-pushed release-prep/rolling from eec0870789 to 75473c2a75

2026-06-28 14:47:45 +02:00

Compare

forgejo-actions force-pushed release-prep/rolling from 75473c2a75 to 66aac94ff4

2026-06-28 14:52:28 +02:00

Compare

forgejo-actions force-pushed release-prep/rolling from 66aac94ff4 to a9f492668f

check-self-bootstrap / check (push) Successful in 3s

Details

release / decide + act (push) Successful in 22s

Details

release / release (push) Successful in 0s

Details

2026-06-28 15:05:24 +02:00

Compare

quartermaster approved these changes

2026-06-28 15:05:59 +02:00

quartermaster left a comment

Pre-1.0 audit suite complete this cycle (#156 + #157 + #158 all closed). Workflow chain validated: 13780 main check-self-bootstrap GREEN post-#238 re-pin merge.

Standing-approval covers per the cut-as-ceremonial-conclusion pattern.

Substance is the auto-generated release-prep commit for v0.17.0. Carries today's substrate work post-#172 Phase-2: #234 (dry-run origin relax + dead-diagnostic unmask), #235 (api_call event substrate), #237 (post_bump_hooks dogfood — the eliminate-the-class for #196), plus #226 ref-pin sweep + #228 int-1/2/3 doc-drift + #229 tmux-tell scrub + #230 examples/ populate + #231 cut-cancel-noise fix. Pre-1.0 audit suite complete this cycle (#156 + #157 + #158 all closed). Workflow chain validated: 13780 main check-self-bootstrap GREEN post-#238 re-pin merge. Standing-approval covers per the cut-as-ceremonial-conclusion pattern.

quartermaster merged commit a9f492668f into main

2026-06-28 15:06:03 +02:00

quartermaster referenced this pull request

2026-06-28 18:33:59 +02:00

fix(release-decide): Layer 2 cut-safeguard uses list-and-filter with narrow window — switch to explicit PR lookup #240