Skip to content

feat(review): know what has been sent, and correct a walkthrough - #25

Draft
fiddur wants to merge 3 commits into
developfrom
review-bookkeeping
Draft

feat(review): know what has been sent, and correct a walkthrough#25
fiddur wants to merge 3 commits into
developfrom
review-bookkeeping

Conversation

@fiddur

@fiddur fiddur commented Aug 23, 2026

Copy link
Copy Markdown
Collaborator

The two gaps the first real submission exposed, plus a README that had fallen a long way behind.

Knowing what has been sent

Submitting left no trace on the findings that went out. They stayed open, looking identical to the
ones held back, so the only way to learn what was already on the pull request was to try sending
again
and read the "already existed" count.

  • a comment payload now carries the finding it came from, and createReview reports back which ones the forge actually took — not every one offered, since duplicates and unpostable lines are filtered first
  • those are marked with submitted_at. Deliberately its own column rather than a status: sending is not resolving, and a submitted finding is still open until someone deals with it
  • the dialog labels them already on the pull request and leaves them unselected, so resending is a deliberate act

Correcting a walkthrough

A walkthrough could only be added to. An agent that recorded a wrong step had to add a second one and
rely on the newest winning, leaving the bad one in the database — which is exactly what happened
while reviewing #14378, and I had to remove it with SQL.

agent tour-delete [<id>] removes one, or all of them for the session, with DELETE /api/tours/:id
for symmetry with threads. The review skill now says to check what it recorded and rebuild rather
than stack.

README

It documented [must-fix]/[suggestion] severities that are now configurable, said a PR opens
"against its base branch" when it is now pinned to the base commit, and had nothing at all about
the reading order, the attention rules, the review composer, review state, --repo, or the agent
CLI. Five new sections, and the ones that were wrong are corrected.

Tests

  • 9 new: the submitted marker (including that it stays open, and that an empty list marks nothing), and walkthrough deletion (steps go with it, siblings survive, unknown ids are silent, replace-in-one-step)
  • one older assertion updated rather than loosened: threadToPayload legitimately gained threadId, so the test names it

372 pass.

🤖 Generated with Claude Code

https://claude.ai/code/session_018PkYQzbsnMihHesafWvXKs

fiddur and others added 3 commits August 23, 2026 10:05
Submitting a review left no trace on the findings that went. They stayed open, looking
exactly like the ones held back, so the only way to learn what had already gone was to try
sending again. A comment now carries the finding it came from, the result says which ones
the forge took, and those are marked submitted - still open, because sending is not
resolving. The dialog labels them and leaves them unselected, so resending is a deliberate
act rather than an accident.

A walkthrough could only be added to. An agent that recorded a wrong step had to add a
second one and rely on the newest winning, leaving the bad one in the database - which
happened here, and had to be cleaned out by hand. `agent tour-delete` removes one, or all of
them for the session, and the review skill now says to check what it recorded and rebuild
rather than stack.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018PkYQzbsnMihHesafWvXKs
develop is the default branch and takes squash merges through pull requests only, matching
the other repositories here. Nothing is merged into it locally, and the squashed commit
rather than the branch is what gets offered upstream - head branches are deleted on merge.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018PkYQzbsnMihHesafWvXKs
… the url

gh resolves a fork's parent, so an unpinned `gh pr checkout 25` fetched whichever pull
request carried that number upstream - it checked out nilbuild's feat/host branch and the
diff came out as 5 files against an unrelated commit. `gh pr view` was pinned earlier;
these two were missed.

Found by comparing the rendered diff against the forge's own counts, which is the check
that catches this class of thing.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018PkYQzbsnMihHesafWvXKs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant