# docker-mcp Roadmap
## Phase 0: Foundation ✓
- [x] README.md with spec
- [x] ROADMAP.md
- [ ] LICENSE, package.json, tsconfig
- [ ] Example configs
## Phase 1: Read-Only Core
- [ ] Docker API client (dockerode)
- [ ] `docker_ps`
- [ ] `docker_inspect`
- [ ] `docker_stats`
- [ ] NEVERHANG timeouts
## Phase 2: Logs
- [ ] `docker_logs`
- [ ] Tail/since/until filtering
- [ ] Grep support
- [ ] Streaming (non-follow first)
## Phase 3: Permission System
- [ ] Permission levels (read, lifecycle, exec, create, etc.)
- [ ] Container whitelist/blacklist
- [ ] Image filtering
- [ ] `--bypass-permissions` flag
## Phase 4: Lifecycle
- [ ] `docker_start`
- [ ] `docker_stop`
- [ ] `docker_restart`
- [ ] `docker_pause` / `docker_unpause`
## Phase 5: Exec
- [ ] `docker_exec`
- [ ] Command safety filtering
- [ ] Output limits
- [ ] Timeout enforcement
## Phase 6: Images
- [ ] `docker_images`
- [ ] `docker_pull`
- [ ] Image inspection
## Phase 7: Compose
- [ ] `docker_compose_ps`
- [ ] `docker_compose_up`
- [ ] `docker_compose_down`
- [ ] `docker_compose_logs`
## Phase 8: AI Analysis
- [ ] `docker_diagnose`
- [ ] Haiku integration
- [ ] Crash analysis
- [ ] Resource anomalies
## Phase 9: Polish
- [ ] Error messages
- [ ] Test suite
- [ ] npm publish
---
| Version | Phase | Description |
|---------|-------|-------------|
| 0.1.0 | 1 | Read-only containers |
| 0.2.0 | 2 | Log access |
| 0.3.0 | 3 | Permission system |
| 0.4.0 | 4 | Start/stop/restart |
| 0.5.0 | 5 | Exec commands |
| 0.6.0 | 6 | Image management |
| 0.7.0 | 7 | Compose support |
| 0.8.0 | 8 | AI diagnosis |
| 1.0.0 | 9 | Production release |
