Metadata-Version: 2.4
Name: dbl-core
Version: 0.3.0
Summary: Deterministic Boundary Layer on KL Kernel Logic
Author-email: Lukas Pfister <228201683+lukaspfisterch@users.noreply.github.com>
License: MIT
Project-URL: Repository, https://github.com/lukaspfisterch/dbl-core
Project-URL: Issues, https://github.com/lukaspfisterch/dbl-core/issues
Keywords: dbl,governance,policy,llm,orchestration,deterministic
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: kl-kernel-logic>=0.5.0
Dynamic: license-file

# DBL Core

DBL Core is a deterministic event substrate for the Deterministic Boundary Layer (DBL). It records intent, decisions, and executions as a single ordered stream.

## Scope
- Single-stream event model with deterministic t_index.
- Canonical serialization and digest for events and behavior logs.
- Gate decision events (ALLOW or DENY) as explicit Deltas.
- Embeds kernel ExecutionTrace as immutable facts.

## Non-Goals
- No policy engine or templates.
- No execution of user tasks.
- No orchestration, UX flows, or intelligence.
- No time, randomness, or I/O side effects.

## Contract
- docs/dbl_contract.md

## Install

```bash
pip install dbl-core
```
Requires kl-kernel-logic>=0.5.0 and Python 3.11+.

## Public API
- DblEvent, DblEventKind
- BehaviorV
- GateDecision
- normalize_trace

## Ordering
Ordering is derived from t_index (position in V). Timestamps and runtime fields are observational only.

## License
MIT License. See LICENSE.
