[jserv]

Interactive review returns a reference note after the contributor submits, and it was plain text: a call path or a design tradeoff had to be read out of prose, and nothing asked who would know the reasons later. The note can now carry a flow diagram, a comparison table and quoted code, and the review gains a step that looks at the change as three kinds of debt.

Every citation in a drawn note must be a line of the pinned diff, and quoted code is taken from the diff, never typed. A solid arrow needs a citation; a link the diff cannot support is drawn dashed and labeled as an inference. When a drawn note cites something the diff does not hold, the reviewer is sent back once with the problem named; if it still does not read, the note is stored as written and shown as plain text.

The debt step gives observations and questions, never a score, and writes nothing for the contributor. A removed check opens at its old line, and the contributor can write a short intent record in their own words and copy it into the PR body. The record is kept for one snapshot, is not part of the answers or the signed record, and is never given to the reviewing agent.

The feedback schema, digest, head binding and completion record are unchanged. The runtime is still the Python standard library and Git, and the new Python modules parse on Python 3.8.

Verified with the review unit suites, the browser suites for the workbench and the flow layout (including a randomized layout property test), and scripts/test-interactive-review.sh.

Demo video:

codetrial-interactive-review-50s.mp4

---

Summary by cubic

The reference note shown after a contributor submits was plain prose, so a call path or design tradeoff had to be read out of text. This adds drawn reference notes — flow diagrams, comparison tables, and quoted code — plus a debt lens step that reads the change as technical, cognitive, and intent debt.

Draw the reference note

• Every citation must be a line of the pinned diff; quoted code is taken from the diff, never typed.
• Solid arrows need a citation; inferred arrows are dashed and labeled.
• Clicking a citation opens its line in the diff.
• The managed worker draws a flow by default; a note the diff doesn't hold is sent back once, then stored and shown as text.

Debt lens and intent record

• Reads the change as technical, cognitive, and intent debt and shows observations and questions only, never a score.
• Removed and added assertions are counted on the same basis, so a moved assertion no longer hides a lost one.
• A removed check opens at its old line, and the contributor can write a short intent record to copy into the PR body.
• The record is kept for one snapshot, stays out of the answers and signed record, and is never given to the reviewing agent; finishing refuses unsaved edits to the record.

^{Written for commit 5b19800. Summary will update on new commits.}