[Dreamcoder08]

Description

Rebuild missing or stale Bat compiled caches after every active, variant and repository theme-source write. Preserve optional-tool behavior, custom theme/cache paths and actionable build errors.

Type of Change

• fix: bug fix

Checklist

• Focused18 Bat/Pi cases pass, including cache state, failures and public sync integration.
• Full exact-candidate pytest, Ruff, mypy, links, health and preview pass through normal hooks.
• Tests, isolation fixture and smallest guide section accompany behavior; no attribution trailers.

Independent final snapshot:1119 Python tests,86.47% coverage. Shared sync ordering verified after all writes. Isolated full Bats138/140 initially exposed hidden user-site jsonschema in verification HOME; existing-venv PATH focusedroute12/12 PASS, no source correction. This exact head must pass hosted CI. No live activation. RDD disabled/unmanaged.

Related Issues

Refs #32

Chain Context

Stacked-to-main. Prior #41 merged. Start: managed agent colors. End: Bat cache refresh. Follow-up: README screenshot and recovery closure. Provider configuration out of scope.

main -> #33 -> #34 -> #36 -> #37 -> #38 -> #39 -> #40 -> #41 -> [08 Bat 📍] -> 09 README

Budget:236 changed lines. Rollback only this slice. Risk: item3 (shared sync pipeline), independent final-state verification complete.