docs(specs): audit pass-2 — 14 zeros are unparsed blob shapes, fold into per-builder fan-out; capture is prod-gated

dad730038cd0c16d4e19e00e5e77acd9b1d875db · 2026-08-02 20:30:02 -0700 · Steve Abrams

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Files touched

M collectors/SPECS-AUDIT.md

Diff

commit dad730038cd0c16d4e19e00e5e77acd9b1d875db
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Sun Aug 2 20:30:02 2026 -0700

    docs(specs): audit pass-2 — 14 zeros are unparsed blob shapes, fold into per-builder fan-out; capture is prod-gated
    
    Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 collectors/SPECS-AUDIT.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/collectors/SPECS-AUDIT.md b/collectors/SPECS-AUDIT.md
index 6180001c..d65b6cb7 100644
--- a/collectors/SPECS-AUDIT.md
+++ b/collectors/SPECS-AUDIT.md
@@ -63,6 +63,28 @@ taylor-morrison, tri-pointe.
 pattern (not just newest); (2) tighten NOISE denylist for config/i18n blobs;
 (3) for RSC builders (tri-pointe) widen the __next_f home-object matcher.
 
+### Fleet audit pass 2 (largest-snapshot re-run of the 14 zeros) — 2026-08-02
+All 14 stayed at 0 **despite large content pages** (david-weekley 7.8MB,
+kb-home 5.7MB, shea 4.2MB, khovnanian 2.3MB, ryan 1.8MB). The data IS in
+these snapshots — the generic auditor just doesn't parse their blob shapes:
+- taylor-morrison → `data-fed-ref="fedmodel">{…}` (Sitecore) — not handled
+- tri-pointe → nested RSC `__next_f` — inner `[^{}]` matcher fails on nesting
+- kb-home → `var allMIRs=JSON.parse("…")` giant double-encoded string — match broke
+- shea / ryan / beazer / khovnanian / century / drees / dream-finders /
+  ashton-woods / david-weekley / gl-homes / highland → bespoke shapes
+
+**Conclusion:** a generic auditor tops out at ~4 blob shapes. For these 14,
+"audit" == "extend the extractor" (the builder's own extractor already walks
+its structure). So they fold directly into the per-builder fan-out below —
+each worker reads that builder's extractor, enumerates the object it iterates,
+and adds the SPEC fields. No separate audit step for them.
+
+### GATED — capture requires prod changes
+Beyond read-only auditing, actually CAPTURING specs needs: (a) `specs Json?`
+schema migration on the live Kamatera DB, (b) per-builder extractor edits, and
+(c) a prod deploy of the worker + web. All Steve-gated. The 8 capture-ready
+builders can be done first as the proving slice.
+
 ### Remaining 27 — TODO (fan-out, one worker per builder)
 lennar · pultegroup · meritage-homes · century-communities · taylor-morrison ·
 lgi-homes · perry-homes · david-weekley · mattamy · dream-finders · kb-home ·

← d46a0ce9 feat(specs): offline field auditor + fleet pass-1 results (a · back to Homesonspec · feat(specs): InventoryHome.specs Json foundation — schema + 26f91560 →