[cabibbz]

Sol has no file access — files reach it only as the attachments the client pasted into the packet. So "files inspected" is exactly what ## Attached Paths produced, and that is now counted, stored, and shown per run.

Two numbers, because one of them isn't the interesting one

Shown	Means
Files read: 3 of 7	Seven were readable; three are referenced in the review
Files read: 7 attached	Seven were readable; none are referenced
Nothing	The packet carried no attachments, so every claim about the code is a description

The gap is the useful part: an attachment nothing refers to did no work. A run reading 3 of 7 tells you the evidence you sent was larger than the evidence the decision turned on.

The result view lists the referenced paths separately from the attached-but-never-mentioned ones.

Where it appears

• History rows — … · 2 files, visible before opening a review
• Run fact table — Files read, beside Protocol and Research
• Result view — a Files card with both path lists

Counted once, at commit

commitJob already reads the packet for its integrity checks, so the count is taken there and stored on the job. History and the answered review then report it without decrypting a packet again — which matters because the packet leaves retention before the record does.

Matching rule

A path counts as referenced when the released text names it, or names its file name where the full path would be unwieldy (overlay.cpp for DmaKit/overlay.cpp). A base name shorter than four characters is not matched, so an incidental word can't fake a citation.

Verification

• Unit: cited/uncited split, base-name matching, the short-name guard, a count with no paths (packet aged out), and zero attachments staying zero
• analyzePacketQuality names the paths in order and returns an empty list when there are none
• e2e: a packet with two attachments stores attachedFiles: 2 at commit, the paths reach the phone, and the count survives onto the answered job; a packet with none records zero
• Browser at 390×844: FILES | 2 attached, 48 B with both paths listed, FILES READ | 2 attached in the fact table, scroll stable

119 unit tests (118 pass / 1 Windows-only skip), mocked e2e, lint, build clean.

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
sol-review-gate	Building	Preview, Comment	Jul 27, 2026 10:56pm