0610f05dc8
docs(16-02): complete Container Actions GraphQL Migration plan
...
- Container lifecycle operations (start/stop/restart) migrated to Unraid GraphQL
- Restart implemented as sequential stop+start chain
- ALREADY_IN_STATE errors map to HTTP 304
- Format Result nodes unchanged (zero-change migration)
- Duration: 3 minutes (2 tasks, 1 file, 2 commits)
2026-02-09 10:26:16 -05:00
50326b9ed7
docs(16-03): complete Container Update GraphQL migration
...
- SUMMARY.md documents single updateContainer mutation replacing 5-step Docker flow
- Workflow reduced from 34 to 29 nodes (15% reduction)
- 60-second timeout accommodates large image pulls
- ImageId comparison determines update success
- Zero Docker socket proxy references remaining
- STATE.md updated: Phase 16 now 3/5 plans complete (60%)
2026-02-09 10:25:59 -05:00
bb3200f246
docs(16-01): complete Container Status migration plan
...
- SUMMARY: Container status queries migrated to Unraid GraphQL API
- STATE: Phase 16 progress updated (2/5 plans complete)
- Metrics: 2 minutes, 1 task, 1 file modified (n8n-status.json)
- Decisions: Inline Code nodes for normalizers, same query for all paths, registry update on every query
- Next: Plans 16-02, 16-03, 16-05 remaining
2026-02-09 10:24:59 -05:00
8e8a5f9dc3
docs(16-04): complete Batch UI GraphQL migration plan
...
- Created 16-04-SUMMARY.md with full execution details
- Updated STATE.md: Phase 16 in progress (1/5 plans)
- Recorded decisions: 5 normalizer nodes, 15s timeout
- Updated progress: v1.4 now 30% complete (3/10 plans)
2026-02-09 10:24:47 -05:00
6d5b407a8e
docs(phase-15): complete phase execution
2026-02-09 09:00:37 -05:00
4e29bdeb56
docs(15-01): complete Container ID Registry and Callback Token Encoding plan
...
- Added 15-01-SUMMARY.md documenting implementation and deviations
- Updated STATE.md: Phase 15 complete (2/2 plans), 52 total plans, v1.4 at 20%
- Task 1 (Container ID Registry) was pre-existing in baseline
- Task 2 (Token Encoder/Decoder) implemented and pushed to n8n
- All utility nodes standalone, ready for Phase 16 wiring
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-09 08:56:03 -05:00
d25fc1b13f
docs(15-02): complete GraphQL utility nodes plan
2026-02-09 08:55:01 -05:00
16034bbdb8
docs: create milestone v1.4 roadmap (4 phases)
...
Phases 15-18: Infrastructure Foundation, API Migration, Cleanup, Documentation
23 requirements mapped across 4 phases with 0 gaps.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-09 08:29:16 -05:00
bb47664188
docs: start milestone v1.4 Unraid API Native
2026-02-09 07:52:53 -05:00
903e73d616
feat: v1.3 Unraid Update Status Sync
...
Unraid GraphQL API foundation — connectivity, authentication, and
container ID format verified for native Unraid API integration.
Phase 14: Unraid API Access (2 plans, 4 tasks)
- Established Unraid GraphQL API connectivity via myunraid.net cloud relay
- Dual credential storage (.env.unraid-api + n8n env vars)
- Container ID format: {server_hash}:{container_hash} (128-char SHA256 pair)
- Complete API contract documented in ARCHITECTURE.md
- "unraid" test command added to Telegram bot
Phases 15-16 dropped (superseded by v1.4 Unraid API Native).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-09 07:47:31 -05:00
96c293f8f4
docs: create milestone v1.3 roadmap (3 phases)
2026-02-08 20:01:15 -05:00
c071b890ef
docs: start milestone v1.3 Unraid Update Status Sync
2026-02-08 19:35:46 -05:00
328442554c
docs: rename DEPLOY-SUBWORKFLOWS.md to ARCHITECTURE.md and rewrite
...
Restructured as a proper technical architecture document:
- Added Observability section (correlation IDs, structured errors, debugging)
- Reorganized into logical flow: overview, request flow, contracts, internals
- Removed stale rollback/backup references
- Updated all references in README, CLAUDE.md, PROJECT.md, STATE.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-08 19:15:56 -05:00
e7eadd088c
chore: complete v1.2 milestone — archive and tag
...
Archive v1.2 Modularization & Polish milestone:
- Archive ROADMAP.md, REQUIREMENTS.md, and audit to milestones/
- Evolve PROJECT.md with v1.2 validated requirements and decisions
- Reorganize ROADMAP.md with collapsed milestone groupings
- Delete REQUIREMENTS.md (fresh for next milestone)
- Update STATE.md and MILESTONES.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-08 18:56:44 -05:00
4228cca9a3
docs(13-01): complete documentation overhaul plan
...
- README expanded from 139 to 264 lines (+90%)
- Added Architecture, Configuration, and Troubleshooting sections
- Documented all v1.2 features (batch selection, Update All button, inline keyboard)
- Removed outdated DEPLOYMENT_GUIDE.md (Phase 10-05, 3 sub-workflows)
- Consolidated to single technical reference: DEPLOY-SUBWORKFLOWS.md
- Updated STATE.md: Phase 13 complete, v1.2 milestone 100% COMPLETE
- Created 13-01-SUMMARY.md with full execution record
Phase 13-01 duration: 113 seconds
Tasks: 2/2 complete
Commits: 54437aa, a483bfb
2026-02-08 18:56:44 -05:00
afddb6130a
docs(12-02): complete Phase 12 — all v1.2 requirements closed
...
BATCH-04 and BATCH-05 UAT passed. 9 bugs fixed during testing.
All 12 v1.2 requirements now complete. Phase 13 (docs overhaul) next.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-08 18:56:44 -05:00
b3909f00e5
docs(12-01): complete documentation audit plan
...
- Create 12-01-SUMMARY.md with execution metrics and decisions
- Update STATE.md: Phase 12 complete (1/1 plan)
- Record decision: Document Unraid limitation vs programmatic fix
- Closed 4 requirements: ENV-01, ENV-02, DEBT-01, DEBT-02
- Resolved UNR-01 as documented limitation
- Duration: 140 seconds, 2 tasks completed, 3 files modified
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-08 18:56:44 -05:00
16ae0b8bc0
docs(quick-1-1): complete orphan node removal task
2026-02-08 18:56:44 -05:00
642d1ec73d
docs(11-02): complete plan — Update All button, deployment, UAT
...
UAT results: tests 1-3,6 pass (bitmap, long names, batch exec, regression).
Tests 4-5 (Update All UAT) deferred to after Phase 12.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-08 18:56:44 -05:00
339b366bcc
docs(11-01): complete bitmap encoding plan -- unlimited container selection
...
- Created 11-01-SUMMARY.md with technical details and verification results
- Updated STATE.md: Phase 11 plan 1/2 complete, 50% progress
- Key metrics: 5m 16s duration, 2 tasks, 4 nodes added (1 batch-ui + 3 main workflow)
- Node counts: n8n-batch-ui.json 17 nodes, n8n-workflow.json 171 nodes
- Decisions: base36 BigInt encoding, graceful migration via dual parsers
2026-02-08 18:56:44 -05:00
642162e0d3
docs(10.2-04): complete gap closure plan
...
- Created 10.2-04-SUMMARY.md with execution details
- Updated STATE.md: 4/4 plans complete, correlation IDs wired
- Documented UAT gaps 1-3 closed (gap 4 accepted as minor)
- Final state: 168 nodes, correlation IDs functional
2026-02-08 18:56:44 -05:00
f620229cec
docs(10.2-03): complete plan — scope reduction due to n8n static data limitation
...
- Created 10.2-03-SUMMARY.md documenting scope reduction and platform limitation
- Updated STATE.md: Phase 10.2 complete (3/3 plans)
- Documented critical finding: n8n static data does not persist between executions
- Final state: 170 nodes (168 baseline + 2 correlation ID generators)
- Correlation ID infrastructure and structured error returns retained
2026-02-08 18:56:44 -05:00
2ac0ba78bd
docs(10.2-02): complete plan -- error propagation and correlation IDs
...
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
2026-02-08 18:56:44 -05:00
6833641ad1
docs(10.2-01): complete error ring buffer foundation plan
...
- Create 10.2-01-SUMMARY.md with full plan execution details
- Update STATE.md: Phase 10.2 plan 1 of 3 complete (33% progress)
- Document all technical decisions and architecture patterns
- Self-check verification passed: all files and commits present
- Duration: 156 seconds (2.6 minutes)
- Node count: 168 -> 172 (+4 nodes: 2 command, 2 utility)
- Ring buffer infrastructure ready for Plan 02 wiring
2026-02-08 18:56:44 -05:00
0b6b12ee7e
docs(10.1-09): complete UAT gap closure plan
2026-02-08 18:56:44 -05:00
f4fd5d5256
docs(10.1-08): complete container action status code handling plan
2026-02-08 18:56:44 -05:00
2a4505d2d4
docs(10.1-07): complete Code classification and contract documentation plan
...
- 10.1-07-SUMMARY.md: Plan execution results with self-check passed
- STATE.md: Phase 10.1 marked COMPLETE (7/7 plans), decisions updated
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-02-08 18:56:44 -05:00
4eeed1d9e1
docs(10.1-06): complete matching extraction plan
2026-02-08 18:56:44 -05:00
36a6ff2e8e
docs(10.1-05): complete integration verification plan
...
- Created 10.1-05-SUMMARY.md documenting verification and UAT
- Updated STATE.md to reflect phase completion (5/5 plans)
- Updated ROADMAP.md to mark phase 10.1 complete
- Updated DEPLOY-SUBWORKFLOWS.md with deployed workflow IDs
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 22:31:04 -05:00
4649ed5a5f
docs(10.1-04): complete confirmation sub-workflow plan
...
Tasks completed: 3/3
- Create n8n-confirmation.json sub-workflow
- Update main workflow with confirmation integration
- Create backup
SUMMARY: .planning/phases/10.1-aggressive-workflow-modularization/10.1-04-SUMMARY.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 21:34:47 -05:00
3d138688e5
docs(10.1-03): complete container status sub-workflow plan
...
Tasks completed: 3/3
- Task 1: Create n8n-status.json sub-workflow
- Task 2: Update main workflow with sub-workflow calls
- Task 3: Create backup for rollback
SUMMARY: .planning/phases/10.1-aggressive-workflow-modularization/10.1-03-SUMMARY.md
2026-02-04 21:28:25 -05:00
884fefaab5
docs(10.1-02): complete batch UI extraction plan
...
Tasks completed: 3/3
- Task 1: Create n8n-batch-ui.json sub-workflow (16 nodes)
- Task 2: Update main workflow (192 -> 179 nodes, -13)
- Task 3: Create backup for rollback
SUMMARY: .planning/phases/10.1-aggressive-workflow-modularization/10.1-02-SUMMARY.md
2026-02-04 21:21:32 -05:00
cd7c177553
docs(10.1-01): complete foundation and domain analysis plan
...
Tasks completed: 3/3
- Rename sub-workflows to shorter pattern
- Analyze main workflow domain boundaries
- User approval on extraction boundaries
SUMMARY: .planning/phases/10.1-aggressive-workflow-modularization/10.1-01-SUMMARY.md
2026-02-04 21:10:07 -05:00
b156fe48cf
docs(10-07): complete UAT gap closure plan
...
Tasks completed: 5/5
- Fix text update race condition (remove parallel message)
- Fix batch update data chain (Build Progress Message reference)
- Fix batch action data chain (Build Progress Message reference)
- Add fuzzy matching to logs and fix chatId reference
- Add timestamp to logs refresh for message not modified error
SUMMARY: .planning/phases/10-workflow-modularization/10-07-SUMMARY.md
2026-02-04 16:01:49 -05:00
1d55988aff
docs(phase-10): complete workflow modularization phase
...
Phase 10 achievements:
- 3 sub-workflows: Update, Actions, Logs (all deployed)
- Main workflow: 209 → 192 nodes (-8%)
- Consolidated all container operations
- Removed old batch inline path
- Modernized callback formats
Deferred to Phase 10.1: Aggressive modularization (50-80 node target)
Added Phase 10.2: Better Logging & Log Management
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 15:10:19 -05:00
e160b3e1cd
docs(10-06): complete remediation plan
...
Tasks completed: 4/5 (1 skipped - path still needed)
- Fix batch actions routing to use sub-workflow
- Wire logs sub-workflow (deployment documented)
- Remove Python helper scripts (6 files, 1468 lines)
- Task 3 skipped: old inline path handles legacy callbacks
SUMMARY: .planning/phases/10-workflow-modularization/10-06-SUMMARY.md
2026-02-04 14:55:46 -05:00
ed0e0e7ba2
docs(10-05): complete modularization plan
...
Tasks completed: 4/4
- Wire batch update to Container Update sub-workflow
- Wire batch actions to Container Actions sub-workflow
- Extract logs flow to Container Logs sub-workflow
- Clean up and verify workflow
Results:
- Main workflow: 209 → 199 nodes (-10, -4.8%)
- Created n8n-container-logs.json sub-workflow (9 nodes)
- All batch operations use sub-workflows (eliminated duplicate logic)
- 9 sub-workflow calls total (3 for Update, 4 for Actions, 2 for Logs)
Phase 10 now COMPLETE.
SUMMARY: .planning/phases/10-workflow-modularization/10-05-SUMMARY.md
2026-02-04 14:00:33 -05:00
186f11362e
chore(10-05): verify and document workflow refactoring
...
- Run cleanup and verification script
- No orphaned nodes found
- Workflow structure validated
- Final node count: 199 (reduced from 209, -4.8%)
- Add comprehensive deployment guide
Node composition:
- 79 code nodes
- 50 httpRequest nodes
- 27 telegram nodes
- 14 if nodes
- 10 switch nodes
- 9 executeCommand nodes
- 9 executeWorkflow nodes (sub-workflow calls)
- 1 telegramTrigger node
Note: Node count (199) is above target range (120-150) but achieves
primary goals of eliminating duplicate logic. Further optimization
possible (~40-45 nodes) by consolidating batch UI and confirmation flows.
Deployment requires importing n8n-container-logs.json and updating
the workflow ID in main workflow Execute Text/Inline Logs nodes.
2026-02-04 13:58:48 -05:00
c7c23b77c3
docs(10): checkpoint - waves 1-3 complete, wave 4 pending
...
Completed:
- 10-01: Orphan cleanup (2 nodes removed)
- 10-02: Container Update sub-workflow (31 nodes)
- 10-03: Container Actions sub-workflow (8 nodes)
- 10-04: Integration verified with user
Pending:
- 10-05: Wire batch ops to sub-workflows, extract logs
Key fixes applied:
- n8n typeVersion 1.2 requires __rl resource locator format
- Docker 204 success detection via empty response check
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 13:46:48 -05:00
d3c1525f53
docs(10-03): complete container actions sub-workflow plan
...
Tasks completed: 3/3
- Task 1: Create container-actions sub-workflow
- Task 2: Wire main workflow to use sub-workflow
- Task 3: Deploy verification (local checks passed)
SUMMARY: .planning/phases/10-workflow-modularization/10-03-SUMMARY.md
Note: Full deployment verification requires n8n access
User setup: Set CONTAINER_ACTIONS_WORKFLOW_ID env var in n8n
2026-02-04 13:12:36 -05:00
99cdb95482
docs(10-01): complete orphan node cleanup plan
...
Tasks completed: 2/2
- Identified 2 orphan nodes via BFS from Telegram Trigger
- Removed orphan nodes, deployed, verified working
SUMMARY: .planning/phases/10-workflow-modularization/10-01-SUMMARY.md
2026-02-04 13:03:50 -05:00
a8e947ec95
docs: split Phase 10 into modularization and update all
...
Phase 10: Workflow Modularization (MOD-01, MOD-02, DEBT-03)
Phase 11: Update All & Callback Limits (BATCH-04-07)
Phase 12: Polish & Audit (UNR-01, ENV-01, ENV-02, DEBT-02)
Phase 13: Documentation Overhaul (DEBT-01)
12 requirements across 4 phases.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 11:23:19 -05:00
63df54e8e3
docs: formalize v1.2 requirements and roadmap
...
12 requirements across 3 phases:
- Phase 10: Modularization, update all, callback limits (7 reqs)
- Phase 11: Unraid sync, env audit, tech debt (4 reqs)
- Phase 12: Documentation overhaul (1 req)
Removed WEB-01 (webhook fix) - already resolved.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 11:21:31 -05:00
6a0551e0d6
chore: archive v1.1 audit and add tech debt to Phase 11
...
Archived:
- milestones/v1.1/v1.1-MILESTONE-AUDIT.md
- milestones/v1.1/INTEGRATION-CHECK.md
Updated:
- ROADMAP.md: Added v1.1 tech debt to Phase 11
- STATE.md: Updated with tech debt tracking
Tech debt items added to Phase 11:
- README.md documentation (still shows direct socket)
- Duplicate --max-time flags in image pull
- Update flow duplication between single/batch paths
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 11:16:03 -05:00
b89f78db21
chore: complete v1.1 milestone
...
Archived:
- milestones/v1.1-ROADMAP.md
- milestones/v1.1-REQUIREMENTS.md
Deleted (fresh for next milestone):
- REQUIREMENTS.md
Updated:
- MILESTONES.md (new v1.1 entry)
- PROJECT.md (requirements → Validated, updated current state)
- ROADMAP.md (v1.1 collapsed, v1.2 phases added)
- STATE.md (reset for v1.2)
v1.1 shipped: Inline keyboard UX and Docker security hardening
- Phases 6-9 complete (11 plans)
- 4 requirements deferred to v1.2 (UNR-01, ENV-01, ENV-02, WEB-01)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 10:55:26 -05:00
fa7c60394e
docs(09): complete batch operations phase verification
...
- Created 09-04-SUMMARY.md with verification results
- Documented 5 bugs fixed during verification
- All batch operations tested and working
- Update all testing deferred (Unraid UI issue)
- Updated STATE.md to reflect phase completion
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 10:49:35 -05:00
8b231bbbb5
docs(09-04): note 64-byte callback_data limitations
...
- Long container names hit limit
- Batch select limited to ~2 containers with current format
- Consider short IDs or server-side state in Phase 9.1
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 10:25:24 -05:00
893a37e9c9
chore(09-04): defer batch Update to Phase 9.1
...
- Remove Update button from batch select (not implemented)
- Document in STATE.md: batch update needs sub-workflow modularization
- Batch Start and Stop work; Update requires complex 5-step sequence
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com >
2026-02-04 10:24:08 -05:00
93be20d9c4
docs(09-03): complete update all and multi-select plan
...
Tasks completed: 2/2
- Task 1: Update all command with availability check
- Task 2: Inline keyboard multi-select for batch operations
SUMMARY: .planning/phases/09-batch-operations/09-03-SUMMARY.md
Phase 9 complete: 3/3 plans done
2026-02-04 08:19:00 -05:00
3e5fa5d8bd
docs(09-02): complete batch execution and progress plan
...
Tasks completed: 3/3
- Add Loop Over Items for sequential batch execution
- Add per-container progress updates and action execution
- Add batch summary with failure emphasis
SUMMARY: .planning/phases/09-batch-operations/09-02-SUMMARY.md
2026-02-03 21:35:08 -05:00
Lucas Berger