Metadata-Version: 2.4
Name: katalyst-engine
Version: 2.2.0
Summary: A distributed declaration framework — primitives for schema-aware, multi-source, evolvable artifact graphs
Project-URL: Repository, https://github.com/esimplicityinc/katalyst-taxonomy
Author: eSimplicity
License: Proprietary
Keywords: declaration,engine,evolvable,graph,primitives,registry,schema
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# katalyst-engine

A distributed declaration framework — primitives for schema-aware, multi-source, evolvable artifact graphs.

## Status

**Alpha** — Engine Phase 1 (`core/` primitives) is implemented.

## Install

```bash
pip install katalyst-engine
```

## Core Primitives

- **Evolvable** — identity + version + lifecycle + compatibility contract
- **Definitive** — describes the structure/constraints of other Evolvables
- **Compositional** — groups/contains other Evolvables
- **Relation** — typed, directed, versioned edge between two Evolvables

```python
from katalyst_engine.core import Identity, Version, Evolvable, Lifecycle

node = Evolvable(
    identity=Identity(kind="system", name="backend", namespace="org"),
    version=Version(major=1),
    lifecycle=Lifecycle.STABLE,
)
print(node.fqn)  # "org.backend"
```
