What problem does it solve?
It ensures that completed task actions are durably committed—either by recording local artifacts as receipts or by executing commit-time entity merge operations with correct tombstoning, stage migration, and operator-safe failure handling.
Core Features & Use Cases
- Pre-commit entity bootstrap enforcement (when applicable): Runs the required bootstrap procedure for any
context_refs entries marked as proposed_entity, guaranteeing that related entities exist before commit writes proceed.
- Two commit modes via dispatch: Supports generic task committing and the
entity-merge variant that migrates loser stages, extends winner aliases, and writes merge trails plus receipts.
- Crash-safe idempotency and reconciliation: Re-derives counters from on-disk truth, short-circuits when merges were already applied, and prevents duplicate merge trail or receipt entries across retries.
- Operator-gated failure escalations: Detects validation failures, unsafe merge collisions, missing artifacts, and missing credentials, and escalates with actionable
awaiting_operator states instead of writing inconsistent state.
Quick Start
Ask the system to commit a playbook: task action with task_variant: entity-merge for the approved entity merge, so it can tombstone the loser, migrate stages, extend winner aliases, and write the final receipts.
