brainos_observe/lib.rs
1//! # Brain Observability Bus
2//!
3//! Single source of truth for everything the user might want to see Brain do.
4//!
5//! - [`BrainEvent`] formalises every consequential moment in the signal lifecycle
6//! (received, classified, routed, executed, audited, budget-crossed, etc.).
7//! - [`Observer`] is the trait every consequential code path publishes through.
8//! - [`BroadcastObserver`] is the default in-process fanout implementation.
9//! - [`Redactor`] scrubs vault-marked secrets from any event payload before publication.
10//!
11//! The crate is intentionally self-contained — it owns no I/O or persistence;
12//! wiring into `crates/signal` and `crates/audit` happens at the processor seam.
13
14pub mod event;
15pub mod observer;
16pub mod redact;
17pub mod sampling;
18
19pub use event::{
20 BrainEvent, IntentSummary, OutcomeSummary, PrincipalSummary, SignalSummary, ToolRouteSummary,
21};
22pub use observer::{BroadcastObserver, ObserveError, Observer, DEFAULT_BROADCAST_CAPACITY};
23pub use redact::{Redactor, SENTINEL_PREFIX, SENTINEL_SUFFIX};
24pub use sampling::LogSampler;