matrx-runtime 0.0.1

The durable-execution substrate: one global_execution spine, one lifecycle state machine, one cost ledger, that every matrx-* executor (agent loop, workflow superstep, utilities) plugs into.

matrx-runtime

The durable-execution substrate for the Matrx platform.

Every unit of work — a utility call, a workflow run, an agent session — is one row on a single global_execution spine that can nest inside any other. The substrate owns the concerns all three flavors share, so they compose freely and share one lifecycle, one nesting tree, one cost ledger, and one enforced state machine:

• run identity + lineage (parent_execution_id, denormalized root_execution_id)
• the lifecycle state machine (transition() — the only legal way to change status)
• the cost ledger + tree-wide budget (forthcoming)
• cancellation signal + down-tree propagation (forthcoming)
• generalized checkpoint + lifecycle-event primitives (forthcoming)
• the hardened write coordinator (moving in from matrx-ai)
• the typed runtime context (forthcoming)

Executors plug in as strategies and are NOT owned here: the agent loop (matrx-ai), the superstep DAG (matrx-graph), utility implementations (matrx-scraper).

Status: pre-alpha. The pure decision core (lifecycle + spine models) is in place; the persistence/coordinator/context drops follow. Built behind a /v2 route; the legacy cx_* / wf_* paths are untouched until cutover.

Design + phased plan: docs/runtime/EXECUTION_SPINE.md.