docs: document behavior when the storage is unavailable (outage, failover) #633

Activity

1. oluciano

   added

   documentationImprovements or additions to documentationImprovements or additions to documentation

   backlogNice to have; not planned for any versionNice to have; not planned for any version

   in-progressWork currently in progressWork currently in progress

   on Oct 19, 2026
2. oluciano commented on Oct 19, 2026

   

   oluciano

   on Oct 19, 2026

   OwnerAuthor

   More actions

   Work Started (WIP)

   • Branch: docs/633-storage-unavailable
   • Scope (owner decision): document only what the code already proves, with file references; everything unproven is listed as 'not tested'.
   • Split out as separate issues: fix(dispatcher): a storage exception outside the fetch call ends the polling loop #640 (dispatcher loop ends if the runtime settings read throws), fix(executor): a failed commit of a job failure is not retried and skips the dead-letter dispatch #641 (failure commit has no retry and skips dead-letter), test(reliability): prove the storage-outage risks found while grooming #633 #642 (candidate risks to reproduce: node registration, recurring ordering, late commit, startup).
   • DoD & 3N: documentation-only, so the 3N matrix lives in fix(dispatcher): a storage exception outside the fetch call ends the polling loop #640-test(reliability): prove the storage-outage risks found while grooming #633 #642. Gate: DocsTruth strict 0 drift, mkdocs strict build.
3. oluciano

   added a commit that references this issue on Oct 19, 2026

   Merge pull request #643 from oluciano/docs/633-storage-unavailable

   ...

   d4a7596
4. oluciano

   closed this as completedin #643on Oct 19, 2026
5. oluciano

   added

   completedDelivered and verified in codebaseDelivered and verified in codebase

   and removed

   in-progressWork currently in progressWork currently in progress

   on Oct 19, 2026
6. oluciano commented on Oct 19, 2026

   

   oluciano

   on Oct 19, 2026

   OwnerAuthor

   More actions

   Acceptance & Resolution Statement

   • Delivered in: PR docs(wiki): document behavior when storage is unavailable (#633) #643
   • Verification: DocsTruth strict 0 drift, mkdocs strict build passing. Documentation only; no src/ or tests changed.
   • Not covered: no test cuts a real database connection (stated in how-we-test). Open points tracked in fix(dispatcher): a storage exception outside the fetch call ends the polling loop #640, fix(executor): a failed commit of a job failure is not retried and skips the dead-letter dispatch #641, test(reliability): prove the storage-outage risks found while grooming #633 #642.
   • Status: Verified and accepted into develop.
7. oluciano

   added a commit that references this issue on Oct 19, 2026

   Merge pull request #649 from oluciano/test/642-storage-outage-risks

   ...

   64919f0