Workspace observer
Workspace observer
Section titled “Workspace observer”The workspace observer is BMO’s process-local, advisory read model of
environmental signals: embedding/checkpoint hints, bounded path_probe
aggregates, optional heat map and stigmergy slices, and session-scoped read
telemetry. It does not walk the full filesystem on every turn and does
not replace human judgment about code changes.
Surfaces
Section titled “Surfaces”| Surface | Entry |
|---|---|
| Agent tool | workspace_snapshot |
| HTTP | GET /v1/workspace-environment (Bearer auth) |
| MCP | bmo_get_workspace_snapshot (opt-in) |
| CLI | bmo config show-workspace-snapshot, bmo workspace preflight |
| TUI | Status bar Observer: hint · /workspace-snapshot, /cartography, /workspace-markers |
| Telemetry ring | list_recent_workspace_observer_events (metadata only; hashed session correlation) |
Tracing
Section titled “Tracing”Use workspace_observer.fired and workspace_observer.action in logs. See
maintainer tracing
for jq recipes.
Maintainer detail
Section titled “Maintainer detail”Workspace observer topic — refresh vs read contract, containment, and non-goals.