MasseR/home-assistant-controller
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

Spec: latest scans notes by branch and round

Browse Source
This commit is contained in:
MasseR
2026-10-02 14:29:56 +03:00
parent 63210afc7b
commit e750e0e687
1 changed files with 6 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/superpowers/specs/2026-10-02-review-notes-design.md
+6 -5
View File
@@ -62,9 +62,11 @@ Bash, git plumbing only. Subcommands:
proper re-review targets a new commit, so overwriting is always deliberate. proper re-review targets a new commit, so overwriting is always deliberate.
Validates that `branch`, `round`, and `verdict` are present and that Validates that `branch`, `round`, and `verdict` are present and that
`verdict` uses the vocabulary above. No other validation. `verdict` uses the vocabulary above. No other validation.
- `review-note latest [branch]` — print the newest note for a branch: start at - `review-note latest [branch]` — print the note with the highest `round` for
the branch tip (default: current branch), and walk back through `previous` a branch (default: current branch), scanning the notes ref and matching
until a note is found. Exit 1 if the chain is exhausted without a note. notes on their `branch:` header. Exit 1 if there is no note for the branch.
(A `previous`-chain walk cannot bootstrap from an unreviewed tip, so the
scan uses the `branch:` header as the index instead.)
- `review-note push` — `git push origin refs/notes/review`. Plain `git push` - `review-note push` — `git push origin refs/notes/review`. Plain `git push`
ignores notes, so this is the only way results travel. ignores notes, so this is the only way results travel.
@@ -73,8 +75,7 @@ the user decide.
## Lifecycle ## Lifecycle
1. Reviewer reads `review-note latest <branch>` (nothing printed means first 1. Reviewer reads `review-note latest <branch>` (exit 1 means first review).
review).
2. Reviewer reviews the branch tip per `REVIEW.md`. 2. Reviewer reviews the branch tip per `REVIEW.md`.
3. Reviewer writes the note with `review-note write` and runs 3. Reviewer writes the note with `review-note write` and runs
`review-note push`. `review-note push`.