internal/

Package addr defines hierarchical bubble addresses like "0", "0.1", "0.1.2".

Package bus is an in-memory, synchronous, address-routed message bus.

Package caps holds per-bubble contacts and spawn budgets.

Package costmeter records per-bubble cost and efficiency counters (notices written/suppressed/capped, deliveries, triggered turns, context evictions and rewarms, context token usage).

Package groups holds named, ad-hoc groupings of bubbles — arrangement only, independent of the spawn tree.

Package health holds pure fleet-health policy: functions over snapshots, with every clock reading supplied by the caller.

Package inbox is the message store: every send lands here, recipients read on their own schedule, and senders can check delivery/read/replied status.

Package ipc is a tiny newline-delimited JSON request/reply protocol over a unix socket.

Package kernel wires the bus, capabilities, registry, and a runner into the four fleet operations: Send, Contacts, Introduce, Spawn.

Package logcap bounds the size of a log file on disk.

Package mcpstdio is a minimal stdio JSON-RPC 2.0 MCP server exposing the bubble tools (send, contacts, spawn) to a claude session.

Package notify holds the mute-rule predicate matcher a bubble uses to declare inbound traffic as noise, so the kernel stops waking it for that traffic.

Package paging decides WHICH resident bubbles to page out, and in what order.

Package registry tracks all bubbles and assigns child addresses.

Package runner launches and kills bubble sessions behind an interface, so the kernel never depends on real claude.

Package sched is the fleet's durable wake scheduler: time-triggered messages that the always-alive daemon delivers to a target bubble (waking it if cold), so a bubble can be an event-driven worker without a permanently-awake session.

Package selfupdate keeps the installed bubbles binary current from GitHub, automatically and safely.

Package sessions holds the fleet's live session table: which bubbles currently have a running process, guarded by one mutex.

Package supervisor is a named, panic-safe registry of periodic checks.

Package tasks is the assignment ledger: every assign_task lands here, and the kernel drives each task through its verification route (worker → checks/ verifier → assigner).

Package transcript is a pure reader for Claude Code conversation .jsonl files.

Package tui is the Bubbletea zoomable fleet tree: a live list of bubbles with status, blink pings from workers, and dive-in selection.