docs(spec): document ReconciliationBlockedError and invariant reconciliation failure behavior #6007

Closed
HAL9000 wants to merge 1 commits from spec/reconciliation-blocked-error-documentation into master

1 Commits

Author SHA1 Message Date
HAL9000 5ce452b67e docs(spec): document ReconciliationBlockedError and invariant reconciliation failure behavior
CI / lint (pull_request) Successful in 35s
CI / quality (pull_request) Successful in 33s
CI / typecheck (pull_request) Successful in 48s
CI / helm (pull_request) Successful in 23s
CI / push-validation (pull_request) Successful in 19s
CI / security (pull_request) Successful in 1m11s
CI / build (pull_request) Successful in 44s
CI / integration_tests (pull_request) Successful in 4m45s
CI / e2e_tests (pull_request) Successful in 5m5s
CI / unit_tests (pull_request) Successful in 7m19s
CI / docker (pull_request) Successful in 15s
CI / coverage (pull_request) Successful in 15m14s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 58m3s
Adds a new 'Reconciliation failure behavior' subsection to the Invariants
section documenting:

- ReconciliationBlockedError blocks phase transitions when reconciliation fails
- INVARIANT_VIOLATED event emitted on the event bus
- Reconciliation runs at start of Strategize, Execute, and Apply phases
- Post-correction automatic re-reconciliation via CORRECTION_APPLIED event
- builtin/invariant-reconciliation as the fallback actor name

This fills a spec gap identified in proposal #5942 — the implementation
(plan_lifecycle_service.py, actor/reconciliation.py) has this behavior
but it was not documented in the spec.
2026-04-10 20:45:23 +00:00