luckberg/unraid-docker-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(10.2-02): complete plan -- error propagation and correlation IDs

Browse Source 
Summary:
- All 7 sub-workflows now return structured error objects
- Main workflow generates correlation IDs for request tracing
- Error detection active for 2 high-value paths
- 8 workflow JSON files modified (1 main + 7 sub-workflows)
- Main workflow: 172 -> 176 nodes (+4)
- Duration: 5.5 minutes
- Deviations: 2 (error detection scope reduced, logs trigger workaround)

STATE.md updates:
- Plan 2 of 3 complete (67% progress)
- Added achievements for 10.2-02
- Added 3 new decisions
- Updated next step to Plan 03
This commit is contained in:
Lucas Berger
2026-02-08 12:58:41 -05:00
parent f7130f61fc
commit 2ac0ba78bd
2 changed files with 369 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.planning/STATE.md
+18 -7
View File
@@ -4,9 +4,9 @@
- **Milestone:** v1.2 -- Modularization & Polish
- **Phase:** 10.2 of 13 (Better Logging & Log Management)
- **Plan:** 1 of 3 complete
- **Status:** Phase 10.2 IN PROGRESS (error ring buffer foundation complete)
- **Last activity:** 2026-02-08 -- Completed 10.2-01 (Error ring buffer foundation and hidden debug commands)
- **Plan:** 2 of 3 complete
- **Status:** Phase 10.2 IN PROGRESS (error propagation and correlation IDs complete)
- **Last activity:** 2026-02-08 -- Completed 10.2-02 (Wire error logging to main workflow)
## Progress
@@ -18,7 +18,7 @@ v1.2: [*******___] 70%
Phase 10: Workflow Modularization [**********] 100% COMPLETE (+ 10-07 UAT fixes)
Phase 10.1: Aggressive Modularization [**********] 100% COMPLETE (9/9 plans + UAT closure)
Phase 10.2: Better Logging & Log Management [***_______] 33% (1/3 plans complete)
Phase 10.2: Better Logging & Log Management [******____] 67% (2/3 plans complete)
Phase 11: Update All & Callback Limits [ ] Pending
Phase 12: Polish & Audit [ ] Pending
Phase 13: Documentation Overhaul [ ] Pending
@@ -122,6 +122,9 @@ Phase 13: Documentation Overhaul [ ] Pending
- [Phase 10.2-01]: Ring buffer size set to 50 entries for both errors and traces
- [Phase 10.2-01]: Debug mode auto-disables after 100 executions to prevent performance impact
- [Phase 10.2-01]: All 4 debug commands use single unified code node for maintainability
- [Phase 10.2-02]: Correlation ID uses timestamp + random string (no UUID dependency)
- [Phase 10.2-02]: Use $input.item.json.correlationId pattern for Prepare Input nodes
- [Phase 10.2-02]: Added error detection for 2 high-value paths (reduced from 6 to minimize nodes)
## Phase 10.1 Progress
@@ -168,7 +171,7 @@ All 7 sub-workflows deployed and operational:
| Plan | Description | Status |
|------|-------------|--------|
| 10.2-01 | Error Ring Buffer Foundation and Hidden Debug Commands | Complete |
| 10.2-02 | Wire Error Logging to Main Workflow | Pending |
| 10.2-02 | Wire Error Logging to Main Workflow | Complete |
| 10.2-03 | Add Debug Tracing to Sub-workflow Boundaries | Pending |
**Achievements (10.2-01):**
@@ -179,14 +182,22 @@ All 7 sub-workflows deployed and operational:
- Log Trace utility node with debug mode toggle and auto-disable
- Main workflow: 168 -> 172 nodes (+4 nodes)
**Achievements (10.2-02):**
- Structured error returns added to all 7 sub-workflows (success/error fields)
- Correlation ID generation for text and callback paths (timestamp + random)
- 19 Prepare Input nodes modified to pass correlationId to sub-workflows
- 2 error detection IF nodes for Container Action and Inline Action paths
- Error objects include workflow, node, message, httpCode, rawResponse
- Main workflow: 172 -> 176 nodes (+4 nodes)
## Next Step
Phase 10.2 in progress. Plan 01 complete (ring buffer foundation). Next: Plan 02 (wire error logging to main workflow error paths).
Phase 10.2 in progress. Plans 01-02 complete (ring buffer foundation, error propagation). Next: Plan 03 (add debug tracing to sub-workflow boundaries).
## Session Continuity
Last session: 2026-02-08
Stopped at: Completed 10.2-01-PLAN.md (Error ring buffer foundation and hidden debug commands)
Stopped at: Completed 10.2-02-PLAN.md (Wire error logging to main workflow)
Resume file: None
---