Metadata-Version: 2.4
Name: monkeybrain-introspection
Version: 1.0.0
Summary: MonkeyBrain Introspection — Lemon observability layer for the Cognitive Operating System
Author: Prashun Javeri
License: Proprietary
Keywords: observability,tracing,metrics,logging,health,alerting
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# MonkeyBrain Introspection

Lemon observability layer for the MonkeyBrain Cognitive Operating System.

## Features

- **Lemon** — unified observability facade
- **Tracer** — distributed tracing with traces and spans
- **MetricsCollector** — counters, gauges, and histograms
- **StructuredLogger** — JSON structured logging with trace enrichment
- **HealthMonitor** — health checks (healthy, degraded, unhealthy)
- **AlertManager** — alert rules, firing, and resolution

## Installation

```bash
pip install monkeybrain-introspection
```

## Quick Start

```python
from introspection import Lemon

lemon = Lemon()
lemon.start_trace("my-operation")
# ... do work ...
lemon.finish_trace()
```

## License

Proprietary
