Domain-agnostic decision stack for autonomous and AI-driven systems
A contract-first set of independent cores: proposal generation, guards and modulation, operational health, evaluation and calibration, and optional execution orchestration. Navigate the roadmap below to understand what each part does and how to integrate them.
One-sentence summary and design principles
Each core depends only on decision-schema. Click a node to open its detail page.
Each core has a single responsibility; they integrate only via the shared contract (decision-schema).
From context and state to execution and evaluation.
Context + State
↓
[mdm-engine] → Proposal
↓
[decision-modulation-core] → FinalDecision
↓
[ops-health-core] → Safety override (if needed)
↓
[execution-orchestration-core] → Bounded execution (optional)
↓
Execution + Trace (PacketV2)
↓
[evaluation-calibration-core] → Metrics + Reports
Release notes, tags, branches, and contract matrix.
Current priorities and next steps.
| Priority | Item | Description |
|---|---|---|
| P0 | Release alignment (tags) | Match Git tags to pyproject versions for all cores. |
| P1 | Ops latency windowing | Timestamp-based latency pruning in ops-health-core. |
| P2 | explainability-audit-core | Explain why decisions were made (audit/compliance). |
| P2 | decision-ecosystem-cli | Single-command install, test, contract validation. |
Minimal and full-stack integration patterns.
from mdm_engine.mdm.decision_engine import DecisionEngine engine = DecisionEngine() proposal = engine.propose(context) # Proposal from decision-schema
# 1. Generate proposal (mdm-engine) # 2. Evaluate with guards (decision-modulation-core) # 3. Check health / kill-switch (ops-health-core) # 4. Execute (execution-orchestration-core or your code) # 5. Record trace as PacketV2 (evaluation-calibration-core)
Real API entry points (verified).
| Core | Import (Python) |
|---|---|
| mdm-engine | from mdm_engine.mdm.decision_engine import DecisionEngine |
| decision-modulation-core | from dmc_core.dmc.modulator import modulate |
| ops-health-core | from ops_health_core.kill_switch import update_kill_switch |
| evaluation-calibration-core | from eval_calibration_core.report.builder import build_report |
| execution-orchestration-core | from execution_orchestration_core.orchestrator import execute |
| integration-harness | from harness.run_one_step import run_one_step |