docs: draft-release.sh header refresh + integration.md dry-run section accuracy (#383 + #385) #389

Merged

quartermaster merged 1 commit from i/383-385-docs-stragglers into main

2026-07-04 20:56:49 +02:00

quartermaster commented

2026-07-04 20:53:27 +02:00

Owner

Fixes #383 + Fixes #385 — bundled per Bosun 5b6a ('docs: self-merge fine'). Both small docs corrections on adjacent files; single self-merge cycle.

#383 draft-release.sh:1-8 header refresh

Pre-fix header referenced 'default immediate per ADR-0003 amendment 2026-06-26' — that was v0.10.0-v0.25.x behavior; #332 flipped the default back to 'draft' at v1.0.0. Also referenced 'merges to main' hardcoded; #370 layered default-branch resolution means the merge target is the consumer's resolved default, not necessarily main.

Refreshed to describe current v1.0.0 behavior: draft default preserves ADR-0003 Gate-3; immediate is the opt-in for frictionless CI cadence; merge target is the consumer's default branch per #370.

#385 integration.md § Dry-run preview accuracy

Pre-fix section had two problems:

Vague about which script does what in the 3-script dry-run flow (release-decide.sh / release-prep.sh / draft-release.sh)
False claim 'dry-run still needs an origin remote' — release-decide.sh reads last_released_sha from the LOCAL manifest + walks LOCAL history; origin is only used for OWNER/REPO derivation + Forgejo API calls, and release-prep.sh has a scratch-repo allowance (OWNER/REPO placeholder when origin missing). Remote-less clones actually work for dry-run.

Rewritten to be script-specific + accurate:

release-decide.sh: computes mode from local history; Layer-2/3 cut-safeguards return skip
release-prep.sh: MUTATES local checkout (CHANGELOG transition + version_files bump); missing origin tolerated with OWNER/REPO placeholder
draft-release.sh: emits Forgejo API METHOD POST / URL / BODY summary; publish_mode respected but nothing publishes
No git-remote writes anywhere

Origin note corrected to reflect actual behavior.

Verification

No behavior change (docs-only)
bats sweep unaffected
shellcheck N/A

Refs

release-toolkit#383, #385
Bosun autonomous-sprint round 4 dispatch 5b6a
External outside-model cold-read round 4

Fixes #383 + Fixes #385 — bundled per Bosun 5b6a ('docs: self-merge fine'). Both small docs corrections on adjacent files; single self-merge cycle. ## #383 draft-release.sh:1-8 header refresh Pre-fix header referenced `'default immediate per ADR-0003 amendment 2026-06-26'` — that was v0.10.0-v0.25.x behavior; #332 flipped the default back to `'draft'` at v1.0.0. Also referenced `'merges to main'` hardcoded; #370 layered default-branch resolution means the merge target is the consumer's resolved default, not necessarily `main`. Refreshed to describe current v1.0.0 behavior: `draft` default preserves ADR-0003 Gate-3; `immediate` is the opt-in for frictionless CI cadence; merge target is the consumer's default branch per #370. ## #385 integration.md § Dry-run preview accuracy Pre-fix section had two problems: 1. **Vague about which script does what** in the 3-script dry-run flow (`release-decide.sh` / `release-prep.sh` / `draft-release.sh`) 2. **False claim** 'dry-run still needs an origin remote' — release-decide.sh reads `last_released_sha` from the LOCAL manifest + walks LOCAL history; origin is only used for OWNER/REPO derivation + Forgejo API calls, and release-prep.sh has a scratch-repo allowance (OWNER/REPO placeholder when origin missing). Remote-less clones actually work for dry-run. Rewritten to be script-specific + accurate: - **release-decide.sh**: computes mode from local history; Layer-2/3 cut-safeguards return `skip` - **release-prep.sh**: MUTATES local checkout (CHANGELOG transition + version_files bump); missing origin tolerated with `OWNER/REPO` placeholder - **draft-release.sh**: emits Forgejo API `METHOD POST / URL / BODY` summary; `publish_mode` respected but nothing publishes - **No git-remote writes anywhere** Origin note corrected to reflect actual behavior. ## Verification - No behavior change (docs-only) - bats sweep unaffected - shellcheck N/A ## Refs - release-toolkit#383, #385 - Bosun autonomous-sprint round 4 dispatch 5b6a - External outside-model cold-read round 4

quartermaster added 1 commit

2026-07-04 20:53:27 +02:00

docs: draft-release.sh header refresh + integration.md dry-run section accuracy (#383 + #385 )

check-self-bootstrap / check (pull_request) Failing after 4s

Details

fragment-check / changelog fragment-kind (pull_request) Successful in 4s

Details

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

Details

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

Details

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

Details

tests / bats (pull_request) Successful in 1m35s

Details

tests / shellcheck (pull_request) Successful in 8s

Details

83cf6dc5c9

Bundled per Bosun 5b6a ('docs: self-merge fine'). Both fixes are small
docs corrections on adjacent files; single review cycle.

**#383 draft-release.sh:1-8 header**

Pre-fix header referenced 'default immediate per ADR-0003 amendment
2026-06-26' — that was v0.10.0-v0.25.x behavior; #332 flipped the
default back to 'draft' at v1.0.0. Also referenced "merges to main"
hardcoded; #370 layered default-branch resolution means the merge
target is the consumer's resolved default, not necessarily 'main'.

Refreshed to describe current v1.0.0 behavior:
- publish_mode default is 'draft' (preserves ADR-0003 Gate-3)
- 'immediate' is the opt-in for frictionless CI cadence
- Merge target is the consumer's default branch per #370

**#385 docs/integration.md § Dry-run preview**

Pre-fix section:
- Vague about which of the 3 scripts (decide/prep/draft-release) does
  what in dry-run
- Claim "dry-run still needs an origin remote" is FALSE for the
  git-log walk — release-decide.sh reads last_released_sha from the
  local manifest + walks local history (no origin fetch). Only
  OWNER/REPO derivation + Forgejo API calls touch origin, and
  release-prep.sh has a scratch-repo allowance (OWNER/REPO
  placeholder when origin is missing).

Rewritten to be script-specific + accurate:
- release-decide.sh: computes mode from local history; Layer-2/3
  cut-safeguards return skip in dry-run
- release-prep.sh: MUTATES local checkout (CHANGELOG transition +
  version_files bump); missing origin tolerated with placeholder
- draft-release.sh: emits Forgejo API METHOD/URL/BODY summary;
  publish_mode respected in summary but nothing publishes
- No git-remote writes anywhere

Origin note corrected: remote-less clones work for dry-run; production
still requires origin.

Verification: no behavior change, docs-only; bats sweep unaffected.

Refs: release-toolkit#383, release-toolkit#385, Bosun autonomous-sprint
round 4 dispatch 5b6a, external outside-model cold-read round 4.

quartermaster merged commit e9463795bd into main

2026-07-04 20:56:49 +02:00

quartermaster deleted branch i/383-385-docs-stragglers

2026-07-04 20:56:49 +02:00

quartermaster referenced this pull request

2026-07-04 20:56:51 +02:00

docs(draft-release): stale file-header comment at scripts/draft-release.sh:1-8 — behavior drift #383

quartermaster referenced this pull request

2026-07-04 20:56:51 +02:00

docs(dry-run): dry-run docs drift from implementation — reconcile behavior claims #385