# Tool failures and recovery log

| Event | Recovery | Human intervention |
|---|---|---|
| Container initially lacked ngspice; unprivileged apt install failed with package-manager permission error. | Installed ngspice 42 with approved `sudo apt-get` and retained all decks/logs. | Approval to install package; no manual design work. |
| `adom-digikey` returned no usable output, including its health query. | Used current distributor pages and manufacturer datasheets through web lookup; recorded URLs and snapshot dates. | None. |
| Retired `kicad_bridge_call describe` path returned `plugin_retired`. | Queried the live native KiCad bridge command catalog and used supported headless verbs. | None. |
| A legacy `.sch` conversion experiment was rejected because KiCad 10 expected s-expression input. | Generated native KiCad 10 `.kicad_sch` and `.kicad_pcb` files directly and verified them with KiCad itself. | None. |
| Initial PCB DRC exposed real pad overlaps/clearance defects. | Corrected placements, replaced rotated library copies with matching vertical footprints, tightened routing clearance, explicitly routed GND, and reran checks until clean. | None. |
| Structured Gerber export initially omitted NC drill output from its file list. | Ran the same installed KiCad 10 CLI’s `pcb export drill` command to produce Excellon drill, drill map and drill report, then regenerated it after final checks. | Approval for the host CLI command; no manual file editing. |
| Schematic SVG exporter created a nested `.svg` directory and reported zero files although KiCad produced a valid SVG. | Located the generated SVG, copied it to the documented path, converted it to PNG, and visually inspected it. | None. |
| SVG-to-PNG conversion emitted font-cache warnings because the cache directory was not writable. | Output files were still valid; dimensions/content were visually inspected. | None. |
| Manufacturer evidence showed the first 100 nF candidate had 2.5 mm lead spacing, not the PCB’s 5.0 mm pitch. | Replaced it everywhere with active Murata RCER71H104K0K1H03B (formed 5.0 mm pitch), regenerated sources, and repeated ERC/DRC/parity and exports. | None. |

No fabrication was ordered and no physical validation was claimed.