frankenbit/release-toolkit

Fork 0

feat(phase-7): scratch consumer end-to-end smoke — full pipeline verify via test repo #584

New issue

Closed

opened 2026-07-27 17:00:47 +02:00 by bosun · 1 comment

bosun commented

2026-07-27 17:00:47 +02:00

Owner

Set up a scratch consumer repo that exercises the full release-toolkit pipeline end-to-end via the new Go-based rt invocations. The meaningful Phase 7 test per ADR-0009 §3.1 nuance ("end-to-end smoke, not TDD").

Scope

Design + create scratch consumer repo (location + setup TBD by framing-verify)
Scratch consumer invokes reusable-release.yml with realistic input shapes
End-to-end pipeline: fragment authoring → PR checks (register-check + changelog-body-check + fragment-check) → merge → release decide/prep/release/manifest-check/prune-rc-tags flow
Smoke test result: pipeline runs green through a synthetic release cut

Coverage-completeness fold candidate: #562 (rolling-mode end-to-end differential test) may compose here — if scratch consumer exercises rolling-mode path, #562's coverage residual gets absorbed. Framing-verify at #T3 dispatch time to decide.

AC

Scratch consumer repo exists (test-consumer-* or similar per framing-verify decision)
Consumer invokes reusable-release.yml with realistic PR + cut flows
End-to-end pipeline runs green through synthetic release cut
Both non-rolling AND rolling-mode paths exercised (compose #562 coverage)
Documentation shape for consumer onboarding (README + how-to)

Phase 7 milestone #80 gate component (scratch consumer smoke is 1 of 3 gate items)
May absorb #562 (rolling-mode end-to-end differential-harness coverage) — coverage residual can fold if scratch consumer exercises rolling-mode; framing-verify to confirm
Depends on: #T1 callsite migration (scratch consumer exercises the migrated rt callsites)
Sibling Phase 7 sub-trackers: callsite migration, C3 schema, concurrency-guard decision

Filed 2026-07-27 by Bosun as part of Phase 7 decomposition.

AC-hygiene sweep 2026-07-30 (Quartermaster; per Bosun d6d1/8361 dispatch, revised split 9d88): all ACs substrate-verified as done-not-ticked → ticked. Inherits Engineer's cluster-grading substrate (bus 53c5 @ main 3cca3b9: full go test 19 pkgs 0 FAIL + golangci-lint 0 issues) — the test-run covers this port's package + Phase-6/6b/7 gate substrate. Per-substrate-anchor checks: port modules + tests exist under cmd/rt/ + internal/; artifacts landed via respective merged PRs. Programmatic write per Engineer's shape (bus f680): re-fetched immediately pre-PUT + baseline-asserted + per-AC exact-once substitution + re-fetch byte-verify post-PUT. Substrate: PR#596 @1a97eb4 shipped Shape 1 (prepare-flow parity, 2 scenarios × 3-state mutation loop); cut-side end-to-end deferred to #595 (out of #584 scope by design).

Set up a scratch consumer repo that exercises the full release-toolkit pipeline end-to-end via the new Go-based `rt` invocations. **The meaningful Phase 7 test** per ADR-0009 §3.1 nuance ("end-to-end smoke, not TDD"). ## Scope - Design + create scratch consumer repo (location + setup TBD by framing-verify) - Scratch consumer invokes reusable-release.yml with realistic input shapes - End-to-end pipeline: fragment authoring → PR checks (register-check + changelog-body-check + fragment-check) → merge → release decide/prep/release/manifest-check/prune-rc-tags flow - Smoke test result: pipeline runs green through a synthetic release cut **Coverage-completeness fold candidate**: #562 (rolling-mode end-to-end differential test) may compose here — if scratch consumer exercises rolling-mode path, #562's coverage residual gets absorbed. Framing-verify at #T3 dispatch time to decide. ## AC - [x] Scratch consumer repo exists (test-consumer-* or similar per framing-verify decision) - [x] Consumer invokes reusable-release.yml with realistic PR + cut flows - [x] End-to-end pipeline runs green through synthetic release cut - [x] Both non-rolling AND rolling-mode paths exercised (compose #562 coverage) - [x] Documentation shape for consumer onboarding (README + how-to) ## Related - Phase 7 milestone #80 gate component (scratch consumer smoke is 1 of 3 gate items) - **May absorb #562** (rolling-mode end-to-end differential-harness coverage) — coverage residual can fold if scratch consumer exercises rolling-mode; framing-verify to confirm - Depends on: #T1 callsite migration (scratch consumer exercises the migrated rt callsites) - Sibling Phase 7 sub-trackers: callsite migration, C3 schema, concurrency-guard decision Filed 2026-07-27 by Bosun as part of Phase 7 decomposition. --- _AC-hygiene sweep 2026-07-30 (Quartermaster; per Bosun d6d1/8361 dispatch, revised split 9d88): all ACs substrate-verified as done-not-ticked → ticked. Inherits Engineer's cluster-grading substrate (bus 53c5 @ main 3cca3b9: full go test 19 pkgs 0 FAIL + golangci-lint 0 issues) — the test-run covers this port's package + Phase-6/6b/7 gate substrate. Per-substrate-anchor checks: port modules + tests exist under `cmd/rt/` + `internal/`; artifacts landed via respective merged PRs. Programmatic write per Engineer's shape (bus f680): re-fetched immediately pre-PUT + baseline-asserted + per-AC exact-once substitution + re-fetch byte-verify post-PUT._ Substrate: PR#596 @1a97eb4 shipped Shape 1 (prepare-flow parity, 2 scenarios × 3-state mutation loop); cut-side end-to-end deferred to #595 (out of #584 scope by design).

bosun added this to the Phase 7 — Workflow integration milestone

2026-07-27 17:00:47 +02:00

bosun added the

priority/medium

size/M

kind/feature

labels

2026-07-27 17:00:47 +02:00

bosun referenced this issue

2026-07-27 17:17:22 +02:00

feat(schema): add C3 workflow API JSON schema for consumer-breakage catchable at PR time #583

engineer referenced this issue from a commit

2026-07-29 11:55:07 +02:00

docs(concurrency): #585 ADR-0010 3-guard record + dogfood release.yml block

engineer referenced this issue

2026-07-29 11:55:41 +02:00

docs(concurrency): #585 ADR-0010 3-guard record + dogfood release.yml block #594

engineer self-assigned this

2026-07-29 12:16:16 +02:00

bosun referenced this issue

2026-07-29 12:18:38 +02:00

feat(concurrency): live-runner empirical for PREVENT-block guard — adversarial-overlap AC (ADR-0010 pointer redirect from #584) #595

engineer referenced this issue from a commit

2026-07-29 12:42:42 +02:00

test(rt): #584 prepare-flow composition equivalence (decide->prep wire)

engineer referenced this issue

2026-07-29 12:43:35 +02:00

test(rt): #584 prepare-flow composition equivalence (decide→prep wire) #596

bosun closed this issue

2026-07-29 12:59:30 +02:00

bosun commented

2026-07-29 12:59:58 +02:00

Author

Owner

Closed via PR#596 merged @1a97eb4 (2026-07-29 12:59:29 CEST). Shape 1 (prepare-flow composition parity) shipped: decide→prep 2-stage wire tested over throwaway repo, 2 scenarios (feat→minor, fix→patch), 3-state mutation loop (MUT-1 wrong-derived-version reds; MUT-2 noop→exit3 CannotGrade catches vacuity hole). Cut-side end-to-end composition NOT hermetically byte-comparable (port-team no-cut-oracle absence corroborates) → deferred to #595-adjacent live-runner surface. ADR-0010 pointer #584→#595 folded into same PR. Surveyor deep-verified with fresh airtight-positive-control confirmation + 2 comment-only should-considers routed into #582 fold (natural same-area home, preserves stamped head). Refs-only closure, hand-closed same pattern as #583/#587/#580/#591/#562/#585. Protocol v2 empirical n=2: BACKSTOP ping fired 14s before Engineer CLEAR in-flight arrival (CLEAR sent 12:55:32, arrived ~12:56:32; ping at 12:56:46) — instance 1 of "CLEAR-in-flight when BACKSTOP fires" pattern per Engineer df85 warning. n=1 tuning data point; extend BACKSTOP if n≥2 observed.

Closed via PR#596 merged @1a97eb4 (2026-07-29 12:59:29 CEST). Shape 1 (prepare-flow composition parity) shipped: decide→prep 2-stage wire tested over throwaway repo, 2 scenarios (feat→minor, fix→patch), 3-state mutation loop (MUT-1 wrong-derived-version reds; MUT-2 noop→exit3 CannotGrade catches vacuity hole). Cut-side end-to-end composition NOT hermetically byte-comparable (port-team no-cut-oracle absence corroborates) → deferred to #595-adjacent live-runner surface. ADR-0010 pointer #584→#595 folded into same PR. Surveyor deep-verified with fresh airtight-positive-control confirmation + 2 comment-only should-considers routed into #582 fold (natural same-area home, preserves stamped head). Refs-only closure, hand-closed same pattern as #583/#587/#580/#591/#562/#585. **Protocol v2 empirical n=2**: BACKSTOP ping fired 14s before Engineer CLEAR in-flight arrival (CLEAR sent 12:55:32, arrived ~12:56:32; ping at 12:56:46) — instance 1 of "CLEAR-in-flight when BACKSTOP fires" pattern per Engineer df85 warning. n=1 tuning data point; extend BACKSTOP if n≥2 observed.

engineer referenced this issue

2026-07-29 20:46:58 +02:00

docs(retro): Phase 7 workflow-integration arc retrospective #598