Chapter 13 — Troubleshooting

The final chapter. When something breaks, this is your lookup. Unlike the earlier chapters, this one isn't linear — jump to the section that matches your symptom.

What you'll find here

• Common errors — symptom → cause → fix tables for the most frequent failures
• PatchWork import bugs — the catalog of r.trim is not a function causes and their fixes
• Generation failures — what to do when the runner produces wrong / broken / unusable outputs
• Recovery procedures — restoring from backups, force re-rolls, cache wipes

When to come here

• A Generation Runner pass surfaced errors
• A .nbflow won't import into PatchWork
• Outputs look wrong despite a clean sanity check
• A workflow that used to work suddenly doesn't
• The G-Labs tunnel dropped mid-run

Sections

1. Common errors — symptom → cause → fix lookup table
2. PatchWork import bugs — every known r.trim cause with a fix
3. Generation failures — diagnostic flow + fixes for bad outputs
4. Runner crash recovery — restore + cache-aware re-run after a mid-pass failure
5. Cache wipe / force re-roll — explicit cache control when the cache is in your way

Where to go after troubleshooting

• The relevant chapter for the task you were doing (Ch 2-11)
• The Skills index if you need a specific helper skill
• Chapter 12 — Workflow Optimization if the failure was about cost or limits

You've reached the end of the linear path. Going forward, treat the wiki as reference — jump to the relevant chapter when you have a question.