fix(gastown): stop reconciler log spam from orphaned bead_cancelled events

[jrf0110]

Summary

Production logs were flooded every alarm tick with:

["reconciler: applyEvent failed",{"eventType":"bead_cancelled","error":"Bead <id> not found"}]

Two independent bugs composed to produce this: deleteBead did not clean up the town_events queue, and applyEvent threw on the missing bead while the drain loop never marked the failing event processed — so the error repeated forever.

• Fix 1 — deleteBead / deleteBeads now purge town_events rows that reference the deleted bead by either bead_id or agent_id (agents are themselves beads, so the single cleanup covers both).
• Fix 2a — reconciler.applyEvent('bead_cancelled') pre-checks that the target bead exists and returns with a warn if it doesn't, instead of throwing.
• Fix 2b — the Town.do.ts drain loop now recognises Bead/Agent <uuid> not found as a terminal error, logs at warn, and marks the event processed so it stops retrying. Acts as a safety net for any future handler that forgets to pre-check existence, and also drains any pre-existing stuck events in production town DBs on the next alarm tick — no migration required.

Added debugTownEvents, debugInsertTownEvent, and debugRecordContainerStatus test-only RPCs so integration tests can observe the event queue and inject orphan events.

Verification

• cd services/gastown && pnpm test -- event-cleanup — new integration tests cover all three fixes (delete-then-drain, direct applyEvent on missing bead, drain loop classifying a terminal error).

Full pnpm typecheck was skipped per repo guidance (too heavy); the gastown-local checks above exercise the changed code paths.

Visual Changes

N/A — backend only.

Reviewer Notes

• The town_events sweep uses bead_id OR agent_id because deleteBead is used for both bead and agent rows in this system.
• The terminal-error detection is deliberately narrow (\b(Bead|Agent) [0-9a-f-]{36} not found\b) so other transient errors continue to be retried.
• The debug RPCs are namespaced under debug* and only used by tests; they are not part of the public surface.

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (4 files)

• services/gastown/src/dos/Town.do.ts
• services/gastown/src/dos/town/beads.ts
• services/gastown/src/dos/town/reconciler.ts
• services/gastown/test/integration/event-cleanup.test.ts

---

_{Reviewed by gpt-5.5-20260423 · 674,327 tokens}