Levandor

Wiring pivot — netlist extraction RETIRED, consolidated scan gallery + zoom

3 min read

The AI netlist extraction built in 2026-07-29-kb-wiring-extraction-v1-complete was retired — the user deemed it too inaccurate for agents to rely on — and replaced with the accurate thing: a consolidated scan gallery of curated genuine wiring-diagram images at /wiring-gallery/, with click-to-zoom. The scans (accurate by construction) are now the authoritative wiring source; the extracted netlists are gone.

For Agents

  • Do NOT query /api/search for wiring connectivity. The extracted netlists are retired; the manuals collection returns zero netlist text (marker count 0).
  • Go to the scan. The authoritative wiring source is /wiring-gallery/ — 480 curated genuine wiring-diagram images, grouped vehicle → manual, each thumbnail links to its full source scan.
  • Distinction that matters: retirement kills the AI-extracted netlists, NOT the OCR’d scanned diagram pages. The scans remain good and are cluzter’s tracing-underlay source. See kb-agent-api.

What was retired (reversibly — nothing deleted)

  • hooks._append_wiring no longer called → on-page netlist tables + Cytoscape graphs are gone.
  • 65 .wires.txt sidecars moved to /home/levander/wiring-retired/ (moved, not deleted).
  • wiring-charts.md + write_charts_index disabled.
  • The 2 wiring manuals reindexed so Qdrant / /api/search no longer returns any extracted netlist text — marker count 0.

Everything reversible: nothing deleted, backups kept.

What replaced it — consolidated scan gallery

A curated scan library of genuine wiring diagrams at /wiring-gallery/:

  • 480 curated genuine wiring-diagram images. Auto-included the 5 dedicated wiring manuals; vision-verified the ambiguous ones, dropping 147 photos / icons / exploded-views that were not actual wiring diagrams.
  • 320px thumbnails, grouped vehicle → manual; each thumbnail links to the full source scan in its page.
  • Home-page nav link added; referenced in kb-agent-api as cluzter’s tracing-underlay source.
  • Artifacts (selection.json + thumbs) at /home/levander/wiring-collection/.

glightbox fixed the "diagrams look cut off" problem

Enabled mkdocs-glightbox (image click-to-zoom, full-screen pan/zoom). Wide diagrams were being shrunk into the ~60em content column and looked cut off; click-to-zoom makes them readable at full resolution.

Why the pivot

The v1 netlist pipeline hit the ceiling documented in 2026-07-29-kb-wiring-extraction-v1-complete — scan resolution (1632×808, stripe letters B/R vs B/Bl failing ~40%) capped connection accuracy well below what an agent could trust. Rather than chase DPI rescans, the decision was to serve the accurate ground truth (the scans themselves) and let a human-in-the-loop tool (cluzter) trace over calibrated underlays instead of importing an inaccurate extracted netlist.

Status

  • Netlist extraction retired (reversible): hook off, sidecars moved, charts disabled, 2 manuals reindexed → marker count 0.
  • Scan gallery live at /wiring-gallery/: 480 curated images, 320px thumbs, glightbox zoom.
  • Scans remain the authoritative wiring source and cluzter’s underlay source.
  • kb-agent-api updated: agents go to the gallery/scan, never /api/search, for wiring connectivity.

Graph View

Backlinks