Repository navigation
π docs(adr): v6 addendum to ADR 0020 β run-rewind semantics for Spek recheck - #10804
Conversation
β¦recheck Signed-off-by: scanner <scanner@hive.kubestellar.io>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
|
hive/awaiting-ci: held for human review. Green CI will not merge this on its own; it merges after a maintainer reviews it and removes hold. π Hive Agent: β hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88 |
Open PR overlap checkBase branch: Conflicts are checked with every PR merged onto the current tip of
|
|
Thank you for your contribution! Your PR has been merged. We'd love to hear how your experience was: share feedback |
Closes #10799
Part of #10734
This adds a v6 addendum to
src/docs/adr/0020-spek-continuous-convergence.mdthat records the run-rewind design before any code changes. It also adds the missing ADR-0020 (Spek) line to the ADR index. This is a docs-only change, so it has no changelog fragment (changelog.d/README.mdexempts docs-only changes).The addendum sets four rules, R1βR4:
Revisionand resets the existing run tospec. It no longer creates a sibling archive or aRevisionOflink. Earlier generations' receipts, proofs and outcomes are kept and never overwritten: the hubgenkeeps increasing across generations. Only the current generation determines status.CampaignRevisionHistorybecomes the generation log, with one entry per rewind recording the reason, actor, timestamp, last gen and a drift snapshot.CampaignLease{Surface: \"revise\"}on the run's archive is live, or whenDrift != niland the campaign has not completed.Driftis cleared when the rewound generation completes. Its snapshot is already in the generation log.<repo>!<runKey>:specwith taskrun-admit-<runKey>. The second lease (<revision.ID>:spec,spek-recheck-*) is removed. A recheck that arrives while one is in flight gets a 409, or is skipped on the cadence tick, and creates no generation.RevisionOfstays on v6 for one release. It is deprecated,omitemptyand always empty; legacy chain dedupe still reads it. It is removed from the API in the next release line, and the UI renders no sibling link.Design owner: the maintainer who approves and merges this PR is the design owner that #10799's acceptance criteria call for. #10800 (recheck core) and #10801 (outward discovery) implement these rules.
β hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88 requested_by=@clubanderson