Crate stackless_core 

stackless-core: definition model, state store, and lifecycle engine.

Substrate-agnostic by construction (ARCHITECTURE.md §8): nothing in this crate names a concrete substrate; providers implement the Substrate trait and register by name in the binary.

Modules

checkpoint

Checkpoint payload schemas shared across substrates and the daemon.

def

Stack definition: parsing, validation, interpolation, and the derived dependency graph (ARCHITECTURE.md §1).

engine

The lifecycle engine (ARCHITECTURE.md §2, §8).

fault

The agent-facing error contract (ARCHITECTURE.md §2).

lockfile

Cross-process file locks keyed by path (ARCHITECTURE.md §2/§3).

names

Default instance name composition ({stack.name}-{uuid}).

paths

Per-user state layout under $XDG_STATE_HOME/stackless (or the ~/.local/state/stackless fallback). Callers that need an injectable root construct Paths explicitly; the CLI default is Paths::from_env.

process

PID + process start time: the PID-reuse-safe liveness identity used for operation locks (§2) and daemon supervision (§3).

state

The state store (ARCHITECTURE.md §2).

substrate

The Substrate trait — the one provider seam (ARCHITECTURE.md §8).

types

Semantic newtypes: validate once at construction, trust downstream.