cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

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

Closed
HAL9000 wants to merge 1 commits from spec/add-reconciliation-failure-behavior-5942 into master
pull from: spec/add-reconciliation-failure-behavior-5942
merge into: cleveragents:master
Conversation 3 Commits 1 Files Changed 1
+13 -1

1 Commits

Author SHA1 Message Date
HAL9000 cd3e9b2806 docs(spec): document ReconciliationBlockedError and invariant reconciliation failure behavior
CI / build (pull_request) Successful in 27s
Details
CI / push-validation (pull_request) Successful in 31s
Details
CI / lint (pull_request) Successful in 39s
Details
CI / helm (pull_request) Successful in 55s
Details
CI / typecheck (pull_request) Successful in 1m19s
Details
CI / e2e_tests (pull_request) Successful in 3m34s
Details
CI / quality (pull_request) Successful in 3m42s
Details
CI / security (pull_request) Successful in 4m6s
Details
CI / integration_tests (pull_request) Successful in 4m13s
Details
CI / unit_tests (pull_request) Successful in 5m28s
Details
CI / docker (pull_request) Successful in 16s
Details
CI / coverage (pull_request) Successful in 13m33s
Details
CI / status-check (pull_request) Successful in 1s
Details
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Successful in 57m20s
Details 
Closes #5942

The spec previously described reconciliation as happening only 'during Strategize'.
The implementation runs reconciliation at all three phase transitions (Strategize,
Execute, Apply) and raises ReconciliationBlockedError on failure.

Added:
1. New 'Reconciliation failure behavior' paragraph in §Invariants:
   - ReconciliationBlockedError blocks phase transitions
   - INVARIANT_VIOLATED event emitted on failure
   - Reconciliation runs at Strategize, Execute, and Apply starts
   - Post-correction auto-reconciliation via CORRECTION_APPLIED event
   - Built-in actor: builtin/invariant-reconciliation

2. Updated Invariant glossary entry to mention:
   - Reconciliation runs at Strategize, Execute, and Apply (not just Strategize)
   - ReconciliationBlockedError on failure
 2026-04-09 13:31:31 +00:00