Phase 3 tells every row in four beats, and the ledger runs once per row

[sandeep-agami]

Spec: ACE-122 (feature reconcile-evidence, brief F10)

Stacked on #300 (above #299, #298, #291, #290, #289, #288). Base is ACE-121-reconcile-plain-language. Merge the seven below it first, then retarget this to main. Do not merge without manual review.

Summary

Phase 3 presented in machinery order: summary, mismatches, your statements, errors, matches, the offer. The reader's order is four beats: how we read and checked your input; what agami did with the question and what it answered; how it got there; what to change on whichever side the evidence points, or what to keep when it already matches. Everything the beats need was already computed; this changes what is read first.

What changed

• Phase 3 opens by naming the four beats and where each comes from: Phase 1 and the ledger and the fit reading for beat 1; Phase 2b for beat 2; the receipt, the differing claim and the semantic model's own words for beat 3; save-correction, the person's query, the question, or 3e's offer for beat 4.
• 3a.5, every row in four beats, sits between the summary and the tables: four short paragraphs per row in the words of shared/plain-language.md, with a worked block. Beat 4 names the side and never asks anything per row; keep is 3e's one offer for the batch.
• 3b to 3f keep their headings, first fences and pinned text; 3e opens with one sentence saying it is beat 4's keep half. tests/test_ah111_reconcile_promotion_skill.py passes untouched.
• The ledger runs once per row, in 2e after the comparison, with --with-claims when both statements exist and without when agami's run failed. 1.5e, statement-check.md and part-ledger.md say so; no sentence asks for a second run.

Verification

Prose only. Pins in tests/test_reconcile_learning_loop_skill.py cover the opener's beats, 3a.5's position and its four lines, the 3e sentence, and the one-run wording in the skill and both references. Prose pins and the pinned suites: 102 passed.

Review round 4

One correction from a panel pass: the 3a.5 example wrote a dropped-rows count with a thousands separator the code does not emit; it now quotes the note as written, including the sentence naming the side the probe did not count.

Rebase note (2026-09-13). Replayed onto main at 99e44a8 with every branch below it; content unchanged, force-pushed with lease.

🤖 Generated with Claude Code