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

feat: v1.3 Unraid Update Status Sync

Browse Source 
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>
This commit is contained in:
Lucas Berger
2026-02-09 07:47:31 -05:00
parent ff0773b84b
commit 903e73d616
14 changed files with 1018 additions and 205 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.planning/STATE.md
+21 -28
View File
@@ -2,18 +2,17 @@
## Current Position
- **Milestone:** v1.3 Unraid Update Status Sync
- **Phase:** 14 (Unraid API Access)
- **Status:** Ready to plan
- **Last activity:** 2026-02-08 -- v1.3 roadmap created
- **Milestone:** v1.3 Unraid Update Status Sync — SHIPPED
- **Status:** Milestone complete, planning next milestone
- **Last activity:** 2026-02-09 -- Shipped v1.3 (descoped to Phase 14)
## Project Reference
See: .planning/PROJECT.md (updated 2026-02-08)
See: .planning/PROJECT.md (updated 2026-02-09)
**Core value:** When you get a container update notification or notice a service is down, you can immediately investigate and act from your phone.
**Current focus:** v1.3 — Sync update status back to Unraid after bot-initiated updates
**Current focus:** Planning v1.4 — Unraid API Native (replace Docker socket proxy with Unraid GraphQL API)
## Progress
@@ -21,17 +20,17 @@ See: .planning/PROJECT.md (updated 2026-02-08)
v1.0: [**********] 100% SHIPPED (Phases 1-5, 12 plans)
v1.1: [**********] 100% SHIPPED (Phases 6-9, 11 plans)
v1.2: [**********] 100% SHIPPED (Phases 10-13 + 10.1-10.2, 25 plans)
v1.3: [░░░░░░░░░░] 0% IN PROGRESS (Phases 14-16, 0/TBD plans complete)
v1.3: [**********] 100% SHIPPED (Phase 14, 2 plans — descoped)
Overall: [████████████████████░░░░░] 78% (48/61 estimated plans)
Overall: 4 milestones shipped (14 phases, 50 plans)
```
## Performance Metrics
**Velocity:**
- Total plans completed: 48
- Total execution time: 11 days (v1.0: 5 days, v1.1: 2 days, v1.2: 4 days)
- Average per milestone: 3.7 days
- Total plans completed: 50
- Total execution time: 12 days (v1.0: 5 days, v1.1: 2 days, v1.2: 4 days, v1.3: 1 day)
- Average per milestone: 3 days
**By Milestone:**
@@ -40,36 +39,30 @@ Overall: [████████████████████░░░
| v1.0 | 12 | 5 days | ~10 hours |
| v1.1 | 11 | 2 days | ~4 hours |
| v1.2 | 25 | 4 days | ~4 hours |
| v1.3 | 0 | 0 days | TBD |
**Recent Trend:**
- Last milestone (v1.2): 25 plans in 4 days
- Trend: Stable (consistent 4-hour average since v1.1)
*Updated: 2026-02-08 after v1.3 roadmap creation*
| v1.3 | 2 | 1 day | ~2 minutes |
## Accumulated Context
### Decisions
Decisions are logged in PROJECT.md Key Decisions table.
Recent decisions affecting v1.3:
Key decisions from v1.3:
- [v1.2] Infrastructure container exclusion — "Update all" excludes n8n and socket-proxy to prevent self-destruction
- [v1.2] Document Unraid badge as limitation → Now actively addressing in v1.3 via Unraid GraphQL API integration
- [v1.2] 7 domain sub-workflows — Clean boundaries: Update, Actions, Logs, Batch UI, Status, Confirmation, Matching
- [v1.3] myunraid.net cloud relay for Unraid API (direct LAN IP fails due to nginx redirect)
- [v1.3] Environment variables for Unraid API auth (more reliable than n8n Header Auth)
- [v1.3] Descope to Phase 14 only — Phases 15-16 superseded by v1.4 Unraid API Native
### Pending Todos
None yet.
None.
### Blockers/Concerns
None yet.
None.
## Key Artifacts
- `n8n-workflow.json` -- Main workflow (166 nodes)
- `n8n-workflow.json` -- Main workflow (169 nodes)
- `n8n-batch-ui.json` -- Batch UI sub-workflow (17 nodes) -- ID: `ZJhnGzJT26UUmW45`
- `n8n-status.json` -- Container Status sub-workflow (11 nodes) -- ID: `lqpg2CqesnKE2RJQ`
- `n8n-confirmation.json` -- Confirmation Dialogs sub-workflow (16 nodes) -- ID: `fZ1hu8eiovkCk08G`
@@ -81,9 +74,9 @@ None yet.
## Session Continuity
Last session: 2026-02-08
Stopped at: v1.3 roadmap created, ready for Phase 14 planning
Resume file: None
Last session: 2026-02-09
Stopped at: Shipped v1.3 milestone
Next step: /gsd:new-milestone for v1.4 Unraid API Native
---
*Auto-maintained by GSD workflow*