# Session 0024: Toolkit and CLI Rewrite and Dashboard Migration

**Date:** 2026-02-23
**Status:** Completed
**Origin:** MDF Webseiten session 0046

---

## Work Done

### Phase 3: Shared Toolkit

- [x] Completed 5 missing toolkit modules at `/opt/infrastructure/toolkit/`:
  - `cli.py` — main CLI entry point with all commands (status, start, stop, build, rebuild, destroy, backup, restore, sync, promote, logs, health, disk, backups, offsite, gen-timers, init)
  - `output.py` — formatted output (Rich tables, JSON mode, plain text fallback)
  - `restore.py` — restore operations with CLI delegation support
  - `sync.py` — data sync between environments with CLI delegation
  - `promote.py` — code promotion (git, rsync, script) with adjacency enforcement
- [x] 7 modules already existed from prior sessions: `__init__.py`, `descriptor.py`, `docker.py`, `backup.py`, `database.py`, `health.py`, `discovery.py`

### Phase 4: Ops CLI Rewrite

- [x] Replaced 950-line bash ops CLI with 7-line bash shim → `python3 -m toolkit.cli`
- [x] Old CLI backed up as `ops.bak.20260223`
- [x] New commands added: `start`, `stop`, `build`, `destroy`, `logs`, `restart`, `init`
- [x] All commands read from `project.yaml` descriptors — no `registry.yaml` dependency
- [x] Container prefix matching fixed: handles `{env}` placeholder expansion in `container_prefix`

### Phase 5: Dashboard Adaptation

- [x] Rewrote 4 dashboard routers to use project.yaml:
  - `registry.py` — imports `toolkit.discovery.all_projects()` instead of parsing registry.yaml
  - `services.py` — uses `toolkit.descriptor.find()` for container name resolution
  - `rebuild.py` — massive rewrite: 707 → 348 lines, removed ALL Coolify API code, uses direct docker compose
  - `schedule.py` — reads from descriptors for GET, still writes to registry.yaml for PUT (gen-timers compatibility)
- [x] Verified all API endpoints working:
  - `/api/registry/` — returns all 5 projects from descriptors
  - `/api/status/` — shows 25 containers
  - `/api/schedule/` — shows backup schedules for all 5 projects
  - `/api/services/logs/mdf/prod/wordpress` — correctly resolves container name

## Key Decisions / Learnings

- `rebuild.py` now uses `_compose_cmd()` helper that finds compose file (.yaml/.yml), env-file (.env.{env}/.env), and adds `--profile {env}` — removes all Coolify API dependency
- Dashboard container has `/opt/infrastructure` mounted → can import toolkit directly via Python
- pyyaml 6.0.3 confirmed available in dashboard container
- `schedule.py` still writes to `registry.yaml` for PUT/gen-timers — full descriptor migration is a future task
- `container_prefix_for(env)` expands `{env}` in prefix, then matches `{prefix}-*` containers

## Files Changed

- `/opt/infrastructure/toolkit/cli.py` — new (all CLI commands)
- `/opt/infrastructure/toolkit/output.py` — new (Rich/JSON/plain output)
- `/opt/infrastructure/toolkit/restore.py` — new
- `/opt/infrastructure/toolkit/sync.py` — new
- `/opt/infrastructure/toolkit/promote.py` — new
- `/usr/local/bin/ops` — rewritten as 7-line bash shim
- `app/routers/registry.py` — uses toolkit.discovery
- `app/routers/services.py` — uses toolkit.descriptor
- `app/routers/rebuild.py` — 707→348 lines, Coolify removed
- `app/routers/schedule.py` — descriptor-backed GET

---

**Tags:** #Session #OpsToolkit #OpsCLI #OpsDashboard