diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md index 0b83564..26d696b 100644 --- a/.planning/REQUIREMENTS.md +++ b/.planning/REQUIREMENTS.md @@ -97,16 +97,16 @@ |-------------|-------|--------| | MOD-01 | Phase 10 | Pending | | MOD-02 | Phase 10 | Pending | -| BATCH-04 | Phase 10 | Pending | -| BATCH-05 | Phase 10 | Pending | -| BATCH-06 | Phase 10 | Pending | -| BATCH-07 | Phase 10 | Pending | -| UNR-01 | Phase 11 | Pending | -| ENV-01 | Phase 11 | Pending | -| ENV-02 | Phase 11 | Pending | -| DEBT-01 | Phase 12 | Pending | -| DEBT-02 | Phase 11 | Pending | | DEBT-03 | Phase 10 | Pending | +| BATCH-04 | Phase 11 | Pending | +| BATCH-05 | Phase 11 | Pending | +| BATCH-06 | Phase 11 | Pending | +| BATCH-07 | Phase 11 | Pending | +| UNR-01 | Phase 12 | Pending | +| ENV-01 | Phase 12 | Pending | +| ENV-02 | Phase 12 | Pending | +| DEBT-02 | Phase 12 | Pending | +| DEBT-01 | Phase 13 | Pending | **Coverage:** - v1.2 requirements: 12 total diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index f1eaa0a..a998351 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -4,7 +4,7 @@ - **v1.0 Docker Control via Telegram** — Phases 1-5 (shipped 2026-02-02) -> [Archive](milestones/v1.0-ROADMAP.md) - **v1.1 n8n Integration & Polish** — Phases 6-9 (shipped 2026-02-04) -> [Archive](milestones/v1.1-ROADMAP.md) -- **v1.2 Modularization & Polish** — Phases 10-12 (planned) +- **v1.2 Modularization & Polish** — Phases 10-13 (planned) --- @@ -12,13 +12,13 @@ Modularize the workflow for maintainability, add "update all" functionality, fix callback data limits, and polish remaining issues. -### Phase 10: Workflow Modularization & Update All +### Phase 10: Workflow Modularization -**Goal:** Break main workflow into modular sub-workflows and add "update all" functionality with improved callback data handling +**Goal:** Break main workflow into modular sub-workflows for maintainability **Dependencies:** None -**Requirements:** MOD-01, MOD-02, BATCH-04, BATCH-05, BATCH-06, BATCH-07, DEBT-03 +**Requirements:** MOD-01, MOD-02, DEBT-03 **Plans:** 0 plans @@ -28,26 +28,44 @@ Plans: **Success Criteria:** 1. Workflow split into logical sub-workflows (command routing, container operations, keyboard generation, etc.) 2. Sub-workflows callable from main without code duplication -3. User can type "update all" to update all :latest containers with confirmation -4. User can tap "Update All" in inline keyboard to update all :latest containers -5. Batch selection keyboard allows selecting 5+ containers without hitting callback limit -6. Containers with long names (20+ chars) can be selected in batch keyboard -7. Update flow consolidated between single and batch paths +3. Update flow consolidated between single and batch paths +4. All existing functionality still works after modularization --- -### Phase 11: Polish & Audit +### Phase 11: Update All & Callback Limits -**Goal:** Clear Unraid update badges, fix webhook issues, verify environment configuration, and fix remaining tech debt +**Goal:** Add "update all" functionality and fix callback data limits for batch selection -**Dependencies:** Phase 10 (modularization complete before polish) +**Dependencies:** Phase 10 (modularization provides cleaner base for new features) + +**Requirements:** BATCH-04, BATCH-05, BATCH-06, BATCH-07 + +**Plans:** 0 plans + +Plans: +- [ ] TBD (run /gsd:plan-phase 11 to break down) + +**Success Criteria:** +1. User can type "update all" to update all :latest containers with confirmation +2. User can tap "Update All" in inline keyboard to update all :latest containers +3. Batch selection keyboard allows selecting 5+ containers without hitting callback limit +4. Containers with long names (20+ chars) can be selected in batch keyboard + +--- + +### Phase 12: Polish & Audit + +**Goal:** Clear Unraid update badges, verify environment configuration, and fix remaining tech debt + +**Dependencies:** Phase 11 (features complete before polish) **Requirements:** UNR-01, ENV-01, ENV-02, DEBT-02 **Plans:** 0 plans Plans: -- [ ] TBD (run /gsd:plan-phase 11 to break down) +- [ ] TBD (run /gsd:plan-phase 12 to break down) **Success Criteria:** 1. After bot successfully updates a container, Unraid UI no longer shows "update available" for that container @@ -57,18 +75,18 @@ Plans: --- -### Phase 12: Documentation Overhaul +### Phase 13: Documentation Overhaul **Goal:** Update README and documentation to reflect current architecture and features -**Dependencies:** Phase 11 (core features complete before documentation) +**Dependencies:** Phase 12 (core features complete before documentation) **Requirements:** DEBT-01 **Plans:** 0 plans Plans: -- [ ] TBD (run /gsd:plan-phase 12 to break down) +- [ ] TBD (run /gsd:plan-phase 13 to break down) **Success Criteria:** 1. README documents docker-socket-proxy architecture (not direct socket mount) @@ -86,11 +104,12 @@ Plans: | 7 | Socket Security | v1.1 | Complete | | 8 | Inline Keyboard Infrastructure | v1.1 | Complete | | 9 | Batch Operations | v1.1 | Complete | -| 10 | Workflow Modularization & Update All | v1.2 | Pending | -| 11 | Polish & Audit | v1.2 | Pending | -| 12 | Documentation Overhaul | v1.2 | Pending | +| 10 | Workflow Modularization | v1.2 | Pending | +| 11 | Update All & Callback Limits | v1.2 | Pending | +| 12 | Polish & Audit | v1.2 | Pending | +| 13 | Documentation Overhaul | v1.2 | Pending | -**v1.2 Coverage:** 12 requirements mapped across 3 phases +**v1.2 Coverage:** 12 requirements mapped across 4 phases --- *Updated: 2026-02-04 after v1.1 milestone* diff --git a/.planning/STATE.md b/.planning/STATE.md index 4b064bb..d29e0ef 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -10,10 +10,10 @@ See: .planning/PROJECT.md (updated 2026-02-04) ## Current Position - **Milestone:** v1.2 — Modularization & Polish -- **Phase:** 10 of 12 (Workflow Modularization & Update All) +- **Phase:** 10 of 13 (Workflow Modularization) - **Plan:** Not started - **Status:** Ready to plan -- **Last activity:** 2026-02-04 — v1.2 requirements formalized (12 requirements across 3 phases) +- **Last activity:** 2026-02-04 — v1.2 requirements formalized (12 requirements across 4 phases) ## Progress @@ -23,9 +23,10 @@ v1.1: [██████████] 100% SHIPPED v1.2: [ ] 0% -Phase 10: Workflow Modularization [ ] Pending -Phase 11: Polish & Audit [ ] Pending -Phase 12: Documentation Overhaul [ ] Pending +Phase 10: Workflow Modularization [ ] Pending +Phase 11: Update All & Callback Limits [ ] Pending +Phase 12: Polish & Audit [ ] Pending +Phase 13: Documentation Overhaul [ ] Pending ``` ## Accumulated Context @@ -51,8 +52,8 @@ Recent v1.1 decisions: ### Known Limitations - **64-byte callback_data limit** — Affects batch selection and long container names -- **Batch update via inline keyboard** — BATCH-05 in Phase 10 -- **Batch selection limited to 2 containers** — BATCH-06/07 in Phase 10 (callback data limit) +- **Batch update via inline keyboard** — BATCH-05 in Phase 11 +- **Batch selection limited to 2 containers** — BATCH-06/07 in Phase 11 (callback data limit) ### Technical Debt