SIGN IN SIGN UP

docs: run it and read the output, and what that caveat costs

The handoff recorded two greps — comment markers and `unwrap_or` fallbacks —
as the way defects get found. Neither found anything today. Every serious
finding since the tag came from running the thing and reading what it said,
then checking each claim against the machine with a second tool.

That method is now written down with the evidence: a report asserting "No
SSD detected" at 0.85 on a host with three NVMe drives, a desktop tower
classified as a GamingLaptop, a Ryzen 9 9900X dated to 2018, a 24GB card
read as 4GB. None of those are visible in a diff, and none would be caught
by a test asserting that a report is produced. They are only visible when
someone reads the sentences and asks whether each is true here.

Three rules alongside it. Check ground truth in a second tool before
believing a fix — the one plausible reading that went unchecked this session
was the 0.61-second boot duration, which was two timestamps of the same
instant subtracted from each other. A fallback is how a module fails
completely and still looks like it works — `unwrap_or(0)` hid a parse that
returned `None` for every disk on every Windows machine since the module was
written. And watch for a guess placed in front of a reading, which happened
three times in one day: chassis inferred from a battery while Linux read
DMI, a battery weighted above a read chassis in the classifier, and Secure
Boot bound to a reader needing Administrator while the value sat in the
registry.

Open work now opens with what the `hardware_ai` audit does not cover. Every
conclusion corrected was verifiably wrong on this desktop and each fix was
checked against a second source, which is not the same as being right in
general. The classifier weights were rebalanced against a single data point:
the direction is defensible, the numbers are not established. The entry says
what would settle it — run `full_analysis()` on a real laptop and read the
report; if it does not say Laptop, the weights are now wrong in the other
direction. `adapter_vram_bytes` has likewise only met NVIDIA and AMD
adapters in one box.

Commit table for the six since the tag, and 7.0.0 item 6 for the historical
metrics removed in 4dd5cce.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
A
Adam Erickson committed
00ffef8a94e704e3590865af6c833742917b9231
Parent: 7607401