luckberg/unraid-docker-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
331 Commits 2 Branches 0 Tags
6d5b407a8e780fc91434bc9eaabc85deb77da578
Commit Graph

133 Commits

Author SHA1 Message Date
Lucas Berger bc26a7bc88 docs(phase-6): research n8n API access 
Phase 6: n8n API Access
- n8n REST API capabilities identified
- Authentication patterns documented (X-N8N-API-KEY header)
- Workflow CRUD operations researched
- Execution history access patterns found
- Common pitfalls catalogued (activation timeout, public vs private endpoints)
- No official SDK exists - raw HTTP client required

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-03 08:04:36 -05:00
Lucas Berger e5c02f9a21 docs: complete v1.0 milestone - Phase 5 Plan 3 approved 
- Add 05-03-SUMMARY.md documenting testing session and bug fixes
- Update STATE.md to 100% complete
- Update ROADMAP.md marking all Phase 5 plans complete
- Remove .continue-here checkpoint

v1.0 Docker Manager Bot is production-ready:
- All 6 commands working (status, start, stop, restart, update, logs)
- Keyword routing (no Claude API dependency)
- Single-user Telegram auth
- Terse error messages
- Complete deployment README

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-02 21:48:22 -05:00
Lucas Berger b0b22c3b39 wip: 05-polish-deploy paused at task 2/2 (testing checkpoint) 
Testing session found and fixed multiple issues:
- Show Menu keyboard/HTML issues
- Container exact match priority
- Update acknowledgment and error handling
- Old image removal after update

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 22:08:43 -05:00
Lucas Berger 09a4c9ba07 docs(05-02): complete error hardening and credential migration plan 
Tasks completed: 2/2
- Standardize error messages to terse format
- Migrate user ID to n8n credentials system

SUMMARY: .planning/phases/05-polish-deploy/05-02-SUMMARY.md
 2026-01-31 21:16:36 -05:00
Lucas Berger 9ae500cdf5 docs(05-01): complete NLU cleanup plan 
Tasks completed: 2/2
- Task 1: Remove NLU/Claude nodes and add Keyword Router
- Task 2: Add persistent Telegram menu

SUMMARY: .planning/phases/05-polish-deploy/05-01-SUMMARY.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 21:11:01 -05:00
Lucas Berger b7cefd931e docs(05): create phase plan 
Phase 05: Polish & Deploy
- 3 plans in 3 waves
- 1 parallel (Wave 1), 2 sequential (Waves 2-3)
- Ready for execution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 21:00:51 -05:00
Lucas Berger 4c09d61943 docs(05): research phase domain 
Phase 5: Polish & Deploy
- Standard stack identified (n8n, Telegram Bot API, Docker)
- Architecture patterns documented (Switch routing, persistent keyboards, error workflows)
- Pitfalls catalogued (credential leaks, testing limitations, configuration issues)
- Code examples for keyword routing, persistent menus, error handling

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 20:55:29 -05:00
Lucas Berger fc1eda2b07 docs(05): capture phase context 
Phase 05: Polish & Deploy
- Implementation decisions documented
- Phase boundary established

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 20:49:04 -05:00
Lucas Berger 21e888c1ce docs: remove NLU from v1.0 scope 
- 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>
 2026-01-31 14:52:37 -05:00
Lucas Berger 9ae67ccd7b wip: phase 4 paused at checkpoint verification 
Multiple workflow bugs fixed during testing. Awaiting user
verification of conversational routing via Telegram.
 2026-01-30 22:38:18 -05:00
Lucas Berger f883908a7b docs(04-01): complete container log retrieval plan 
Tasks completed: 3/3
- Add logs command routing to workflow
- Implement Docker logs API call with formatting
- Handle Docker log stream binary format

SUMMARY: .planning/phases/04-logs-intelligence/04-01-SUMMARY.md
 2026-01-30 21:44:54 -05:00
Lucas Berger 0ee37acfec phase 4 planning 2026-01-30 15:29:24 -05:00
Lucas Berger 0f1ceba947 docs(04): research phase domain 
Phase 04: Logs & Intelligence
- Standard stack identified
- Architecture patterns documented
- Pitfalls catalogued

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-30 13:55:20 -05:00
Lucas Berger fce57d9bd8 docs(03): complete container-actions phase 2026-01-30 13:31:07 -05:00
Lucas Berger e9a76852eb docs(03-04): complete container update plan 
Tasks completed: 3/3
- Update command routing and container matching
- Image pull and change detection
- Container recreation workflow

SUMMARY: .planning/phases/03-container-actions/03-04-SUMMARY.md
Phase 3 complete - all container actions implemented
 2026-01-30 13:27:43 -05:00
Lucas Berger f503d3e68b docs(03-03): complete batch confirmation flow plan 
Tasks completed: 3/3
- Build batch confirmation message with inline keyboard
- Handle batch confirmation callback
- Clean up UI after batch action

SUMMARY: .planning/phases/03-container-actions/03-03-SUMMARY.md
 2026-01-30 08:49:02 -05:00
Lucas Berger c0451f8325 docs(03-02): complete callback query handling plan 
Tasks completed: 3/3
- Task 1: Configure Telegram Trigger for callback queries
- Task 2: Implement suggestion flow for no-match cases
- Task 3: Handle suggestion callback and execute action

SUMMARY: .planning/phases/03-container-actions/03-02-SUMMARY.md
 2026-01-30 08:43:41 -05:00
Lucas Berger 87d34b1a15 docs(03-01): complete basic container actions plan 
Tasks completed: 3/3
- Add action command routing to workflow
- Implement container matching and action execution
- Handle action errors gracefully

SUMMARY: .planning/phases/03-container-actions/03-01-SUMMARY.md
 2026-01-30 08:37:41 -05:00
Lucas Berger 893412f405 docs(03): create phase plan 
Phase 03: Container Actions
- 4 plans in 4 waves (sequential due to shared workflow file)
- Ready for execution
 2026-01-29 21:48:58 -05:00
Lucas Berger f0694f6c8c phase 3 research 2026-01-29 15:02:50 -05:00
Lucas Berger cea1fba8b2 docs(03): capture phase context 
Phase 03: Container Actions
- Implementation decisions documented
- Phase boundary established
 2026-01-29 14:53:34 -05:00
Lucas Berger af5397306d docs(02): complete docker integration phase 
Phase 2 complete with 2 plans:
- 02-01: Docker socket configuration
- 02-02: Docker query workflow

Delivers: REQ-02 (container status queries)
- "status" returns container summary
- "status <name>" returns detailed container info
- Fuzzy matching for container names

Ready for Phase 3: Container Actions
 2026-01-29 14:43:13 -05:00
Lucas Berger 8d0829db50 docs(02-01): complete docker socket configuration plan 
Tasks completed: 3/3
- Configure n8n container for Docker access
- Verify Docker API access
- Confirm Docker access working

Decisions:
- Static curl binary mount (hardened image lacks apk)
- --group-add 281 for docker socket permissions

SUMMARY: .planning/phases/02-docker-integration/02-01-SUMMARY.md
 2026-01-29 14:23:27 -05:00
Lucas Berger 75995b5cd6 docs(02): create Docker integration phase plans 
Phase 02: Docker Integration
- 2 plan(s) in 2 wave(s)
- Plan 01: Infrastructure setup (Docker socket, curl, env vars)
- Plan 02: Container query workflow with fuzzy matching
- Sequential execution (02 depends on 01)
- Ready for execution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-29 08:25:34 -05:00
Lucas Berger aeae1e4377 docs(02): research phase domain with Context7 
Phase 02: Docker Integration
- Docker Engine API endpoints documented (Context7 /docker/docs)
- n8n Execute Command and Code node patterns (Context7 /n8n-io/n8n-docs)
- Custom Dockerfile needed for curl in n8n container
- Fuzzy matching and response formatting patterns
 2026-01-29 08:22:32 -05:00
Lucas Berger 6f36c4a307 docs(02): research phase domain 
Phase 2: Docker Integration
- Docker Engine API v1.53 identified as standard
- Execute Command + curl recommended approach
- Fuzzy matching patterns documented
- Security considerations catalogued
 2026-01-29 08:19:50 -05:00
Lucas Berger 8e620c0935 docs(02): capture phase context 
Phase 02: Docker Integration
- Implementation decisions documented
- Phase boundary established
 2026-01-29 08:12:22 -05:00
Lucas Berger fb01073001 docs(01): complete foundation phase 
- 2/2 plans executed and verified
- REQ-01 (send/receive messages) satisfied
- REQ-09 (user ID auth) satisfied
- All 8 must-haves verified

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-28 20:35:36 -05:00
Lucas Berger 0bf0008569 docs(01-02): complete workflow import and verification plan 
Tasks completed: 3/3
- Import and Activate Workflow in n8n
- Verify Authorized User Echo
- Verify Unauthorized User Blocked

Phase 1 Foundation complete (2/2 plans)
Deviation: Hardcoded user ID (n8n CE env var limitation)

SUMMARY: .planning/phases/01-foundation/01-02-SUMMARY.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-28 20:32:06 -05:00
Lucas Berger 216a73e0d0 docs(01-01): complete telegram echo bot plan 
Tasks completed: 2/2
- Task 1: Create Telegram Bot and Configure n8n (human action)
- Task 2: Create n8n Workflow for Telegram Echo

SUMMARY: .planning/phases/01-foundation/01-01-SUMMARY.md
 2026-01-28 19:48:46 -05:00
Lucas Berger f330097906 docs(01): create phase plan 
Phase 01: Foundation
- 2 plan(s) in 2 wave(s)
- Wave 1: Workflow setup (has human action checkpoint)
- Wave 2: Verification (human verify checkpoints)
- Ready for execution

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-28 18:47:27 -05:00
Lucas Berger 2cb6f3a689 docs(01): research phase domain 
Phase 1: Foundation
- Standard stack identified (n8n Telegram nodes, Bot API)
- Architecture patterns documented (auth, echo, formatting)
- Pitfalls catalogued (webhook SSL, merge deadlock, rate limits)
- Code examples from official sources

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-28 18:28:17 -05:00
Lucas Berger 1f4caa775d docs(01): capture phase context 
Phase 01: Foundation
- Implementation decisions documented
- Phase boundary established
 2026-01-28 17:52:41 -05:00