Metadata-Version: 2.5
Name: clm-kernel
Version: 0.0.13
Summary: Card Lifecycle Manager (CLM) Kernel — Sovereign Functional Agentic Operating System
Author: GovTech Digital Identity & Autonomous Systems
License: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Interpreters
Requires-Python: >=3.11
Requires-Dist: base58>=2.1.1
Requires-Dist: blake3>=0.4.0
Requires-Dist: cryptography>=44.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: all
Requires-Dist: duckdb>=1.0.0; extra == 'all'
Requires-Dist: fastapi>=0.100.0; extra == 'all'
Requires-Dist: httpx>=0.25.0; extra == 'all'
Requires-Dist: jsonschema>=4.26.0; extra == 'all'
Requires-Dist: networkx>=3.0; extra == 'all'
Requires-Dist: python-dotenv>=1.1.0; extra == 'all'
Requires-Dist: requests>=2.28.0; extra == 'all'
Requires-Dist: scipy>=1.14.0; extra == 'all'
Requires-Dist: sqlalchemy>=1.4.0; extra == 'all'
Requires-Dist: uvicorn>=0.20.0; extra == 'all'
Requires-Dist: websockets>=12.0; extra == 'all'
Provides-Extra: analytics
Requires-Dist: duckdb>=1.0.0; extra == 'analytics'
Requires-Dist: networkx>=3.0; extra == 'analytics'
Requires-Dist: sqlalchemy>=1.4.0; extra == 'analytics'
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: hatchling>=1.20.0; extra == 'dev'
Requires-Dist: hypothesis>=6.100.0; extra == 'dev'
Requires-Dist: jsonschema>=4.26.0; extra == 'dev'
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Requires-Dist: twine>=5.0.0; extra == 'dev'
Provides-Extra: gateway
Requires-Dist: fastapi>=0.100.0; extra == 'gateway'
Requires-Dist: jsonschema>=4.26.0; extra == 'gateway'
Requires-Dist: python-dotenv>=1.1.0; extra == 'gateway'
Requires-Dist: uvicorn>=0.20.0; extra == 'gateway'
Provides-Extra: native
Provides-Extra: network
Requires-Dist: httpx>=0.25.0; extra == 'network'
Requires-Dist: requests>=2.28.0; extra == 'network'
Requires-Dist: websockets>=12.0; extra == 'network'
Provides-Extra: science
Requires-Dist: scipy>=1.14.0; extra == 'science'
Description-Content-Type: text/markdown

# clm-kernel (`0.0.13`, Python package `clm`)

`clm-kernel` (`0.0.13`, Python `>=3.11`) is the Python reference kernel of the Cubical Logic Model (CLM), implementing the six logical layers (`clm.layer0` through `clm.layer5`) with optional PyO3 acceleration via `clm_rust_core`.

See [`docs/architecture/six_layers_architecture.md`](../../docs/architecture/six_layers_architecture.md) and [`docs/spec/20-architecture/system-architecture.md`](../../docs/spec/20-architecture/system-architecture.md) for the layer boundary specification.

## Architectural layers

- **Layer 0 (`clm/layer0/`)**: `MCard`, `PCard`, `VCard`, `BLAKE3` `g_time` provenance, RFC 8785 canonical JSON, `TypedValue`, and `TypeLattice`.
- **Layer 1 (`clm/layer1/`)**: `TokenMCard`, `PlaceMCard`, `TransitionMCard`, bitset `PlaceTypeLattice`, `ColoredPetriVM`, and formal verification witnesses.
- **Layer 2 (`clm/layer2/`)**: Unified storage backends, `MCardCollection`, `MCardFileSystem`, `DirectoryManifest`, `ChunkManifest`, `PetriProcessPCard`, `SyncContract v1`, Open Petri Pullback, and Cellular Sheaf Cohomology.
- **Layer 3 (`clm/layer3/`)**: Cordis `Fiber` isolation, Satori speech-act envelopes, and Reticulum / mDNS mesh transport.
- **Layer 4 (`clm/layer4/`)**: `clm` and `clmEval` CLIs, presentation membranes, `ViewPlaceMCard`, and Triad Gateway.
- **Layer 5 (`clm/layer5/`)**: `EpistemicPlaceMCard`, `LearningTransitionPCard`, epistemic fitness evaluation, and telemetry guards.

## Installation

Requires Python `3.11+` (`uv` recommended for workspace development).

```bash
pip install clm-kernel
```

## CLI usage

```bash
clm --help
clm evaluate --file assets/clm/manifests/example.yaml
```

## Quick start

```python
from clm.layer0.hash import prefixed_hash
from clm.layer0.mcard import MCardPayload, create_mcard, verify_mcard_integrity

card = create_mcard(
    uri="mcard://example/greeting",
    payload=MCardPayload(kind="Text", value="payload data"),
    author="did:clm:example",
)

print(f"Content hash: {prefixed_hash(b'payload data')}")
print(f"Card hash:    {card.hash}")
assert verify_mcard_integrity(card)
```

## License

MIT License. Source code, formal proofs, and TypeScript and Rust kernels live in the [CLM repository](https://github.com/xlp0/CLM).
