Files

T

Lucas Berger 1cb1592bf4 docs: pause v1.4 — updateContainer requires Unraid 7.3+, v1.3 restored to n8n

UAT revealed Unraid GraphQL API (7.2.x) only has start/stop mutations.
updateContainer, updateContainers, updateAllContainers exist in API source
but ship in Unraid 7.3+ (unreleased). v1.3 workflows pushed to n8n as
stable rollback. v1.4 work preserved on branch for when 7.3 ships.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-09 12:46:48 -05:00

4.5 KiB

Raw Blame History

Project State -- Unraid Docker Manager

Current Position

Milestone: v1.4 Unraid API Native — PAUSED
Phase: 16 of 18 (API Migration) - Paused (UAT revealed API limitation)
Status: PAUSED — Unraid GraphQL updateContainer mutation requires Unraid 7.3+ (not yet released). v1.3 workflows restored to n8n.
Last activity: 2026-02-09 — v1.4 paused, v1.3 workflows pushed to n8n as stable rollback

Project Reference

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: PAUSED — waiting for Unraid 7.3 to ship updateContainer GraphQL mutation

Progress

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: [**********] 100% SHIPPED (Phase 14, 2 plans — descoped)
v1.4: [******....] 60% PAUSED (Phases 15-18 — blocked on Unraid 7.3)

Overall: 4 milestones shipped (14 phases, 50 plans), v1.4 paused
Running in production: v1.3 (Docker socket proxy architecture)

Why Paused

UAT on Phase 16 revealed: The Unraid GraphQL API (v4.25-4.28, Unraid 7.2.x) only exposes start and stop Docker mutations. The updateContainer, updateContainers, and updateAllContainers mutations exist in the API source code (commit 277ac42046, 2025-12-18) but are tagged for Unraid 7.3+ which has not been released.

UAT results (6 passed, 3 blocked):

PASS: Container list, status submenu, start, stop, restart, idempotent start
BLOCKED: Single container update, batch update, text commands (all depend on updateContainer mutation)

What's ready for Unraid 7.3:

All Phase 15 infrastructure (Container ID Registry, GraphQL Normalizer, Error Handler)
Phase 16 workflow code for status queries, start/stop/restart (all working)
Phase 16 workflow code for updates (correct mutation signatures, just needs API availability)
Debug fixes: batch cancel wiring, text command paired item fix, batch confirmation HTTP node

Resume trigger: Unraid 7.3 release → re-run UAT → fix any remaining issues → continue Phase 17-18

Performance Metrics

Velocity:

Total plans completed: 58
Total execution time: 12 days + 29 minutes (v1.0: 5 days, v1.1: 2 days, v1.2: 4 days, v1.3: 1 day, v1.4: 29 min)
Average per milestone: 3 days

By Milestone:

Milestone	Plans	Duration	Avg/Plan
v1.0	12	5 days	~10 hours
v1.1	11	2 days	~4 hours
v1.2	25	4 days	~4 hours
v1.3	2	1 day	~2 minutes
v1.4	8	29 minutes	3.6 minutes

Accumulated Context

Decisions

Decisions are logged in PROJECT.md Key Decisions table.

[v1.4] PAUSE — Unraid 7.2.x lacks updateContainer mutation, resume when 7.3 ships
[v1.4] ROLLBACK — v1.3 workflows restored to n8n for stable production use
[v1.4] Remove container logs feature entirely (not valuable enough to justify hybrid architecture)
[v1.4] Remove docker-socket-proxy completely (clean single-API architecture)
[v1.3] Descope to Phase 14 only — Phases 15-16 superseded by v1.4 Unraid API Native
[v1.3] myunraid.net cloud relay for Unraid API (direct LAN IP fails due to nginx redirect)

Pending Todos

Monitor Unraid 7.3 release for updateContainer mutation availability
When 7.3 ships: re-run /gsd:verify-work 16 to validate update operations

Blockers/Concerns

BLOCKING: Unraid 7.3 not released

updateContainer(id: PrefixedID!) — single container update
updateContainers(ids: [PrefixedID!]!) — batch update
updateAllContainers — update all with available updates
All three mutations exist in API source (commit 277ac42046) but only ship in Unraid 7.3+
Current server runs Unraid 7.2.x with API v4.25-4.28 (only start/stop mutations)

Key Artifacts

Production (v1.3 — running on n8n):

n8n-workflow.json -- Main workflow (v1.3, Docker socket proxy architecture)
All 7 sub-workflows at v1.3 state pushed to n8n

Development (v1.4 — on branch gsd/v1.0-unraid-api-native):

Phase 15-16 work preserved in git (GraphQL migration code ready for Unraid 7.3)
UAT and debug reports in .planning/phases/16-api-migration/

Session Continuity

Last session: 2026-02-09 Stopped at: v1.4 PAUSED — v1.3 restored to n8n, waiting for Unraid 7.3 Next step: When Unraid 7.3 releases → re-run Phase 16 UAT → continue to Phase 17-18

Auto-maintained by GSD workflow

4.5 KiB Raw Blame History