# os_observatory

Independent, no-dependency observability toolkit for operating-system development. Provides:
- Structured logging macros targeting pluggable sinks
- Lock-free ring buffer sink for text output
- Fixed-capacity event tracing buffer for low-overhead instrumentation
- Panic reporting helpers
- Small memory utilities
- Build metadata capture

Highlights:
- `no_std` first, `std` optional for host tests
- Zero external dependencies
- Heavily documented APIs for docs.rs
- MIT licensed — created by an AI Assistant (GPT-5-medium) from an idea by alisio85

Quickstart:
```rust
use os_observatory::sink::RingBufferSink;
use os_observatory::logging::{Logger, Level};
use os_observatory::{os_log, os_error};

static SINK: RingBufferSink<1024> = RingBufferSink::new();
let logger = Logger::new(&SINK).with_level(Level::Info);
os_log!(&logger, "Boot OK");
os_error!(&logger, "oops code={}", 7);
```

See docs/ for detailed manuals and integration guides.

