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

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

1 Commits

Author SHA1 Message Date
HAL9000 58e8959c2f docs(spec): document ReconciliationBlockedError and invariant reconciliation failure behavior
CI / benchmark-publish (pull_request) Has been skipped
CI / lint (pull_request) Successful in 20s
CI / quality (pull_request) Successful in 31s
CI / helm (pull_request) Successful in 26s
CI / push-validation (pull_request) Successful in 17s
CI / security (pull_request) Successful in 1m23s
CI / build (pull_request) Successful in 3m17s
CI / typecheck (pull_request) Successful in 4m43s
CI / integration_tests (pull_request) Successful in 6m52s
CI / e2e_tests (pull_request) Successful in 7m18s
CI / unit_tests (pull_request) Successful in 11m29s
CI / docker (pull_request) Successful in 1m55s
CI / coverage (pull_request) Successful in 16m27s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-regression (pull_request) Successful in 57m2s
Add a new 'Reconciliation Failure Behavior' subsection to the Invariants
section documenting:
- ReconciliationBlockedError blocks phase transitions (Strategize/Execute/Apply)
- INVARIANT_VIOLATED event emitted on failure
- Table showing which phase transitions trigger reconciliation
- Post-correction automatic re-reconciliation via CORRECTION_APPLIED event
- Built-in actor name: builtin/invariant-reconciliation

Also fix the code example at line ~19802 to show the correct 4-tier
precedence chain (plan > action > project > global) instead of 3-tier.

Refs: #5942
2026-04-12 04:21:53 +00:00