electra-archon/README.md

# Electra Archon

SEED Architecture Implementation for the Electra Archon wizard.

## SEED Architecture

SEED stands for **S**tate-**E**vent-**E**ntity-**D**omain - a modular architecture for building resilient, auditable systems.

### Components

1. **State** - Immutable snapshots of entity state with versioning
2. **Event** - Pub/sub system for inter-component communication
3. **Entity** - Core domain objects with identity
4. **Domain** - Business logic and rules

## Project Structure

```
electra-archon/
├── schemas/         # JSON schemas for data validation
│   └── state.json   # State schema definition
├── models/          # Python data models
│   └── state.py     # State dataclass implementation
├── docs/            # Documentation
│   └── state-schema.md
├── tests/           # Test suite
│   └── test_state.py
└── pytest.ini       # Test configuration
```

## Quick Start

```python
from models.state import State, StateType, StateMetadata
import uuid

# Create a state
state = State.create(
    entity_id=str(uuid.uuid4()),
    state_type=StateType.ACTIVE,
    payload={"status": "running"},
    metadata=StateMetadata(source="electra", tags=["seed"])
)

# Serialize
json_str = state.to_json()
```

## Running Tests

```bash
pytest tests/ -v
```

## Backlog

See [Issues](http://143.198.27.163:3000/allegro/electra-archon/issues) for current backlog:

- Issue #3: Design Electra State Schema for SEED Architecture ✅
- Issue #4: Implement Event Bus for Inter-Archon Communication
- Issue #5: Create Entity Resolution Service

## License

MIT