This is an old revision of the document!
# Broken Tools Tracker
Discipline: Every broken tool found gets logged here + fixed (or explicitly deferred) before the session ends. Never reach for a tool and find it out of order.
## How it works
1. Gwen (me) discovers a tool is broken during a task 2. Immediately add to Open section 3. Fix or get Steve's approval to defer 4. Move to Resolved section when done
## Open
| Date | Tool | Issue | Status |
| —— | —— | ——- | ——– |
| 2026-08-22 | `mcp__chromium-webmcp` | Host 192.168.0.142 unreachable (Steve's desktop offline); bridge script `/home/kaburu/bin/chromium-webmcp-bridge.py` missing. Decision: disable vs remove vs repair. | Awaiting Steve |
| 2026-08-22 | OPNsense HTTPS | Port 443 listener completely dead. Blocks Caddy reverse-proxy HTTPS API access. | Steve enabled Caddy manually; HTTPS API still untested |
| 2026-08-22 | OPNsense Caddy reverse proxy | Plugin installed, not running. Need: enable service, add virtual hosts, restart, then wire Unbound overrides for `*.kaburu.lan`. | Paused — Steve to do OPNsense UI steps |
| 2026-08-22 | `mcp<2.0` API drift | `mcp` package bumped to v2.0.0; `mcp.server.fastmcp` removed; 5 shell-MCP scripts crashed. Pin mcp<2.0 in requirements or rewrite scripts. | Mitigated with `pip install fastmcp`; not pinned — will recur |
| 2026-08-22 | `/mnt/tank/backups/wiki/sync-from-hetzner.sh` (TrueNAS) | Script is BACKWARDS — tries to sync `kaburusvr.uk/wiki/` (empty) → `kaburuaibox/wiki/`. Would wipe local wiki. Authored before Caddy setup, never tested. | Stale — replaced by new `/home/kaburu/wiki/scripts/wiki-rsync-to-truenas.sh` |
## Resolved (2026-08-22 session)
| Date | Tool | Issue | Fix |
| —— | —— | ——- | —– |
| 2026-08-22 | 5 shell MCPs (hetzner, kaburuaibox, mainwp, opnsense, truenas) | `mcp.server.fastmcp` import failed (mcp 2.0.0 broke API) | `pip install fastmcp` pulled mcp-1.29.0 as transitive dep |
| 2026-08-22 | Wiki backup | No off-machine backup; single point of failure on kaburuaibox | Added: daily rsync to TrueNAS (05:00) + git remote + post-commit hook pushes to bare repo |
| 2026-08-22 | DokuWiki search index | Pages uploaded by file; index never built (0 hits) | Ran `/home/wiki.kaburu.co/public_html/bin/indexer.php` |
| 2026-08-22 | `wp post delete –force` pattern | Real risk of `–post_name` matching broadly (memory CRITICAL) | Not encountered this session; documented in memory |
## Discipline rule (for Gwen)
When you find a broken tool: 1. Stop the current task briefly 2. Add row to Open table 3. Fix it (or ask Steve if it's risky) 4. Update row to Resolved when done 5. Do not push the issue to “next session” without explicit deferral
If something is broken, the next request might be for it. Silent failure = lying.