Lucas Berger
21e888c1ce
- Remove Claude API integration and intent parsing (04-02-PLAN) - REQ-08 (conversational queries) moved to out of scope - Phase 4 renamed from "Logs & Intelligence" to "Logs" (complete) - v1.0 now focuses on keyword-based container control Simple substring matching works well for container management. NLU adds complexity without proportional value for v1. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
3.8 KiB
3.8 KiB
Project State — Unraid Docker Manager
Project Reference
Building: Telegram bot for Docker container management on Unraid Core Value: Control containers from your phone via simple keyword commands
Current Position
- Milestone: v1.0 — Docker Control via Telegram
- Phase: 4 of 5 — Logs (COMPLETE)
- Plan: 1 of 1 executed
- Status: Phase 4 complete - ready for Phase 5
- Last activity: 2026-01-31 - Removed NLU from scope, Phase 4 complete
Progress
Phase 1: Foundation [██████████] Complete (2/2 plans)
Phase 2: Docker Integration [██████████] Complete (2/2 plans)
Phase 3: Container Actions [██████████] Complete (4/4 plans)
Phase 4: Logs [██████████] Complete (1/1 plans)
Phase 5: Polish & Deploy [░░░░░░░░░░] Not started
Overall: [████████░░] 80%
Recent Decisions
| Decision | Rationale | Date |
|---|---|---|
| Use n8n for orchestration | Already running on Unraid, handles Telegram webhooks | 2026-01-28 |
| Claude API for NLU | N100 can't run local LLMs fast enough | 2026-01-28 |
| Single-user auth | Simple security, only owner needs access | 2026-01-28 |
| Hardcoded user ID in workflow | n8n CE blocks env var access in expressions | 2026-01-28 |
| Silent ignore unauthorized | No false branch nodes, prevents information leak | 2026-01-28 |
| HTML parse mode | Future formatting flexibility for responses | 2026-01-28 |
| Static curl binary mount | Hardened n8n image lacks package manager | 2026-01-29 |
| --group-add 281 for socket | Node user needs docker group for socket access | 2026-01-29 |
| curl -s flag for silent mode | Prevents stderr progress output causing false errors | 2026-01-29 |
| Substring matching for containers | Simple approach works well, no external library needed | 2026-01-29 |
| HTTP 304 as success | Already-in-state is success from user perspective | 2026-01-30 |
| 10-second graceful timeout | Allows containers to shutdown cleanly before SIGKILL | 2026-01-30 |
| HTTP Request for inline keyboards | Native Telegram node has expression bug with dynamic keyboards | 2026-01-30 |
| Single-char action codes in callback | s/t/r/x encoding fits in 64-byte callback_data limit | 2026-01-30 |
| Stateless 2-min timeout | Timestamp in callback_data avoids server-side state | 2026-01-30 |
| Batch limit of 4 containers | callback_data array with 4 short IDs fits in 64 bytes | 2026-01-30 |
| Sequential batch execution | Single shell command with && chain, no n8n loops needed | 2026-01-30 |
| RESULT_N:statusCode markers | Parseable output format for aggregating batch results | 2026-01-30 |
| Silent when no update | Only notify on actual image change, not when already up-to-date | 2026-01-30 |
| Single match only for update | Update requires exact container name, no batch updates | 2026-01-30 |
| Version from OCI labels | Check org.opencontainers.image.version, then version, then ID | 2026-01-30 |
| Docker logs API with tail parameter | More efficient than fetching all logs and filtering in code | 2026-01-30 |
| Binary stream header via charCodeAt | Docker multiplexed stream uses byte 0 values 1/2, strip 8 bytes | 2026-01-30 |
| Default 50 lines, cap at 1000 | Balance between useful context and Telegram limits | 2026-01-30 |
| Truncate at 3800 chars | Telegram limit is 4096, leave room for header and formatting | 2026-01-30 |
| Remove NLU from v1.0 | Simple keyword matching sufficient, Claude API adds complexity | 2026-01-31 |
Pending Todos
(None yet)
Blockers & Concerns
(None yet)
Session Continuity
- Last session: 2026-01-31
- Stopped at: Scope change - removed NLU from v1.0
- Next step: Start Phase 5 (Polish & Deploy)
- Resume command:
/gsd:plan-phase 5
Auto-maintained by GSD workflow