Files

Allegro bcf8c31270 feat(state): Implement State Schema for SEED Architecture (Issue #3 )

- Add JSON schema at schemas/state.json with full validation rules
- Implement State, StateType, StateMetadata dataclasses in models/state.py
- Support immutable state objects with versioning and TTL
- Include serialization/deserialization (JSON and dict)
- Add next_version() for state history chaining
- Comprehensive test suite with 19 tests (100% pass)
- Full documentation at docs/state-schema.md

Features:
- UUID validation for all ID fields
- Optimistic locking via version numbers
- Flexible payload structure
- Metadata support (source, provenance, tags)
- Expiration checking via TTL
- Complete type hints

Closes Issue #3

2026-04-02 19:59:35 +00:00

1.6 KiB

Raw Blame History

Electra Archon

SEED Architecture Implementation for the Electra Archon wizard.

SEED Architecture

SEED stands for State-Event-Entity-Domain - a modular architecture for building resilient, auditable systems.

Components

State - Immutable snapshots of entity state with versioning
Event - Pub/sub system for inter-component communication
Entity - Core domain objects with identity
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

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

pytest tests/ -v

Backlog

See 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

1.6 KiB Raw Blame History