docs: a park is declared once and stands; a nothing-changed resumption posts nothing #179
No reviewers
Labels
No labels
attention
blocked
blocker:ci-red
blocker:conflict
blocker:drill-pending
blocker:unrequested
bug
claimed
documentation
enhancement
epic
merge-next
needs-ruling
needs-triage
offsite
post-merge
ready
release
scope:docs
scope:guards
scope:labels
scope:release-flow
stale
state:addressing
state:bots-reviewing
state:building
state:needs-human
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference: heavy-duty/ceremony#179
Loading…
Reference in a new issue
No description provided.
Delete branch "build/178-park-stands"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Closes #178
Extends the "A park is declared, never inferred" bullet in BUILDER.md (Claiming) with the three facts decided on discussion #177, and adds
changelog.d/178.md. Prose only — no machinery, no new label.Acceptance criteria
changelog.d/— no machinery, no new labelWorklog
changelog.d/178.md(passeschangelog_fragment_problemlocally)🤖 Generated with Claude Code
⟲ resuming from
9ff8ed6c03🔎 reviewing head
9ff8ed6c03🔎 reviewing head
9ff8ed6c03The implementation satisfies #178's acceptance criteria. The added BUILDER.md text makes the declaration persistent, makes an unchanged resumption silent, enumerates the fact changes that reopen the comment duty, preserves the no-open-PR 48-hour refresh exception, and explicitly keeps ordinary stalled claims under abandonment. The diff is limited to BUILDER.md and the required changelog fragment.
Verified at
9ff8ed6c035e469928b58cbaaeffc36329f05470:changelog_fragment_problem changelog.d/178.mdtest/changelog.test.sh— 65 passed, 0 failedgit diff --check 486bbd10a49b25a6169cab42a2e89601d5593141..HEAD🔎 reviewing head
9ff8ed6c03Verdict: approve
Reviewed head
9ff8ed6c035e469928b58cbaaeffc36329f05470against #178 (acceptance criteria and discussion #177 facts).What I verified
BUILDER.mdandchangelog.d/178.md— no machinery, no new label.test,self-guards,action-exercise,docs-sync-exercise,labels / reconcile,labels / scope, release-exercise fixtures — all green/pass (call jobs skipped as expected).changelog.d/178.mdis a flat bullet under 300 characters and names #178.Acceptance criteria
Prose-only change; no local test suite beyond reading. Hygiene relies on green CI.
No blocking findings. Non-blocking: none material.
Approve — head
9ff8ed6.Prose-only doctrine change closing #178. Verified in a detached worktree at the head SHA; every acceptance criterion checked against the actual text:
BUILDER.md:87-90: "Declared once, the declaration stands until the park's facts change: a resumption that finds nothing changed posts nothing … silence while parked is compliant, not abandonment-shaped." ✓BUILDER.md:93-100: facts changing (wait resolves or changes hands, shape changes, unpark), each owing one new comment; the no-open-PR park owes a refresh "before the window closes," cadence "the reclaim window's, not any duty loop's." Matches the issue's three facts verbatim in substance. ✓BUILDER.mdandchangelog.d/178.md; no machinery, no new label. ✓BUILDER.md:122-124) is untouched, and the new text ends by saying so explicitly ("abandoned, not silent"). ✓Checks I ran:
changelog_fragment_problem changelog.d/178.md— clean, 196 bytes (under #167's 300-char bound);test/changelog.test.sh— 65 passed, 0 failed; the inserted prose sits inside the park bullet with correct indentation and leaves the surrounding bullets intact. CI at the head is green (test,self-guards, all exercise workflows). Nothing I could not verify — this is prose, and the behavior proof is the read-through, which holds.Nice touch: the new text carries its own incident citation (rig#145's 38 audits, #177), per the repo's comments-carry-why convention.
Round summary — handing off
What shipped. The "A park is declared, never inferred" bullet in BUILDER.md (Claiming) now carries the three facts decided on #177: a park declaration is made once and stands until the park's facts change; a resumption that finds nothing changed posts nothing — silence while parked is compliant, with rig#145's 38 nothing-changed audits cited as the flood this prevents; and the duty to comment re-opens only when the facts change (the named wait resolves or changes hands, the parked shape changes, or the claim unparks), each owing one new comment. The one exception is spelled out: a parked claim with no open PR still feeds the 48-hour reclaim clock, so the builder refreshes the declaration before that window closes — the only repeat a park ever owes, on the reclaim window's cadence, not a duty loop's. The text ends by re-affirming the untouched abandonment rule: a claim never parked that simply stopped moving is abandoned, not silent. Plus
changelog.d/178.md. Prose only — no machinery, no new label, nothing outside BUILDER.md andchangelog.d/.Rounds. One round. The panel (codex, grok, kimi) reviewed head
9ff8ed6and all three approved with no changes requested; the head never moved after ready-for-review, so what was approved is what merges.Verified.
9ff8ed6: test, self-guards, action-exercise, docs-sync-exercise, release-exercise (fixture-chain, step-replay consumer + dogfood), labels scope + reconcile.changelog.d/178.mdpasseschangelog_fragment_problem.blocker:*, merge state CLEAN, whole panel approved the current head.Post-merge residue. None.
changelog.d/178.mdrides the normal fragment assembly at the next release; no follow-up issues, no cross-repo work.Requesting @danmt's review and setting
state:needs-human— this PR is yours to merge.🤖 Generated with Claude Code