From 35a363500fb7087685a968772aa0368de28f1d48 Mon Sep 17 00:00:00 2001 From: Tarik Moussa Date: Wed, 3 Jun 2026 23:35:50 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20F-01=20done=20=E2=80=94=20skeleton=20de?= =?UTF-8?q?ployed,=20board=20+=20manifest=20aktualisiert?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit F-01 auf ✅, F-03/F-04/F-05 auf 🔲 (ready). R-0001/R-0002/R-0003/R-0008/R-0009 done. Session-Log F-01-2026-06-03 angelegt. Co-Authored-By: Claude Sonnet 4.6 --- ROADMAP.md | 10 +++++----- STATE.md | 17 ++++++++--------- manifests/requirements.md | 10 +++++----- sessions/F-01-2026-06-03.md | 38 +++++++++++++++++++++++++++++++++++++ 4 files changed, 56 insertions(+), 19 deletions(-) create mode 100644 sessions/F-01-2026-06-03.md diff --git a/ROADMAP.md b/ROADMAP.md index aabcc74..ca19679 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -39,10 +39,10 @@ F-01 (Skeleton) ──┬──► F-03 (Whitelist) ──┐ | ID | Item | Typ | Status | Prereqs | Rolle · Modell | Aufwand | |----|------|-----|--------|---------|----------------|---------| -| F-01 | Projekt-Skeleton (pyproject.toml, Paketstruktur, CI-Stub) | 🧱 | 🔲 | — | Worker · Sonnet | ~0.5 d | -| F-03 | Whitelist-Middleware (User-ID-Allowlist, Env-Var-Config) | 🧱 | ⏸ | F-01 | Worker · Sonnet | ~0.5 d | -| F-04 | Telegram-Bot-Handler (Polling-Loop, /start, /help, Nachricht-Relay) | 🔌 | ⏸ | F-01 | Porter · Sonnet | ~1 d | -| F-05 | Modell-HTTP-Connector (httpx-Client gegen konfigurierbaren OpenAI-compat Endpoint) | 🔌 | ⏸ | F-01 | Porter · Sonnet | ~0.5 d | +| F-01 | Projekt-Skeleton (pyproject.toml, Paketstruktur, CI-Stub) | 🧱 | ✅ | — | Worker · Sonnet | ~0.5 d | +| F-03 | Whitelist-Middleware (User-ID-Allowlist, Env-Var-Config) | 🧱 | 🔲 | F-01 | Worker · Sonnet | ~0.5 d | +| F-04 | Telegram-Bot-Handler (Polling-Loop, /start, /help, Nachricht-Relay) | 🔌 | 🔲 | F-01 | Porter · Sonnet | ~1 d | +| F-05 | Modell-HTTP-Connector (httpx-Client gegen konfigurierbaren OpenAI-compat Endpoint) | 🔌 | 🔲 | F-01 | Porter · Sonnet | ~0.5 d | | F-06 | Integration & Smoke-Test (Whitelist + Handler + Connector verdrahtet, E2E-Test) | 🧱 | ⏸ | F-03, F-04, F-05 | Worker · Sonnet | ~1 d | | F-07 | Deployment-Config (.env.example, Docker oder systemd-Unit) | 🧱 | ⏸ | F-06 | Worker · Haiku | ~0.5 d | @@ -54,4 +54,4 @@ F-01 (Skeleton) ──┬──► F-03 (Whitelist) ──┐ ## Done | ID | Item | Session | Commit | |----|------|---------|--------| -| — | — | — | — | +| F-01 | Projekt-Skeleton | F-01 (2026-06-03) | `82eb6a6` | diff --git a/STATE.md b/STATE.md index 1bb4b28..699ac9a 100644 --- a/STATE.md +++ b/STATE.md @@ -2,24 +2,21 @@ > Einzige Quelle für "wo stehen wir". Jede Session aktualisiert dies am Ende. -**Letzte Session:** S-BOOTSTRAP / 2026-06-03 · **Aktive Rolle:** leader +**Letzte Session:** F-01 / 2026-06-03 · **Aktive Rolle:** worker ## Now (in dieser Session im Fokus) -- Scope-Korrektur: Jetson/Modell-Server ist extern — F-02-Spike entfernt, DAG vereinfacht. +- _(keine laufende Arbeit)_ ## In Progress (begonnen, nicht fertig) -- _(keine — bereit zum Dispatch)_ +- _(keine — F-01 ist gemerged)_ ## Blocked -- F-03 Whitelist — wartet auf F-01 (`⏸`). -- F-04 Bot-Handler — wartet auf F-01 (`⏸`). -- F-05 Model-Connector — wartet auf F-01 (`⏸`). - F-06 Integration — wartet auf F-03 + F-04 + F-05 (`⏸`). - F-07 Deployment — wartet auf F-06 (`⏸`). ## Next (priorisiert) -1. **F-01** dispatchen (Worker · Sonnet) — `session-prompts/F-01-skeleton.md`. -2. Nach F-01 ✅: F-03, F-04, F-05 können **parallel** dispatcht werden. +1. F-03, F-04, F-05 können **parallel** dispatcht werden (alle prereqs ✅). + Prompts: noch zu erstellen (Leader-Aufgabe). ## Offene Audit-Findings - _(keine)_ @@ -27,4 +24,6 @@ ## Datei-Ownership (aktiv) | Paket | Dateien/Pfade | Owner | |---|---|---| -| skeleton | `pyproject.toml`, `src/`, `tests/` | worker-F01 | +| whitelist | `src/bot/whitelist.py`, `tests/test_whitelist.py` | worker-F03 | +| handler | `src/bot/handlers.py`, `src/main.py`, `tests/test_handlers.py` | worker-F04 | +| connector | `src/bot/connector.py`, `tests/test_connector.py` | worker-F05 | diff --git a/manifests/requirements.md b/manifests/requirements.md index fb49194..7d3bb1e 100644 --- a/manifests/requirements.md +++ b/manifests/requirements.md @@ -4,14 +4,14 @@ Eine Zeile je Erfolgskriterium. Der Reviewer prüft Spalte für Spalte. | ID | Anforderung | Datei(en) | Test/Prüfbefehl | Status | |----|-------------|-----------|-----------------|--------| -| R-0001 | `uv sync` läuft ohne Fehler | `pyproject.toml`, `uv.lock` | `uv sync` | todo | -| R-0002 | Pytest-Suite grün | `tests/` | `uv run pytest tests/ -v` | todo | -| R-0003 | Ruff meldet 0 Befunde | `src/`, `tests/` | `uv run ruff check src/ tests/` | todo | +| R-0001 | `uv sync` läuft ohne Fehler | `pyproject.toml`, `uv.lock` | `uv sync` | done | +| R-0002 | Pytest-Suite grün | `tests/` | `uv run pytest tests/ -v` | done | +| R-0003 | Ruff meldet 0 Befunde | `src/`, `tests/` | `uv run ruff check src/ tests/` | done | | R-0004 | Bot antwortet nur auf whitelistete User-IDs | `src/bot/whitelist.py` | `uv run pytest tests/test_whitelist.py -v` | todo | | R-0005 | Nicht-whitelistete User erhalten keine Antwort | `src/bot/whitelist.py` | `uv run pytest tests/test_whitelist.py::test_blocked_user -v` | todo | | R-0006 | Connector sendet POST /v1/chat/completions an MODEL_BASE_URL | `src/bot/connector.py` | `uv run pytest tests/test_connector.py -v` | todo | | R-0007 | Modell-Antwort wird an User zurückgesendet | `src/bot/handlers.py` | `uv run pytest tests/test_handlers.py -v` | todo | -| R-0008 | Config lädt aus Env-Vars ohne Exception | `src/bot/config.py` | `uv run pytest tests/test_config.py -v` | todo | -| R-0009 | `.env` nicht im Git-Index | `.gitignore` | `git ls-files .env` → leer | todo | +| R-0008 | Config lädt aus Env-Vars ohne Exception | `src/bot/config.py` | `uv run pytest tests/test_config.py -v` | done | +| R-0009 | `.env` nicht im Git-Index | `.gitignore` | `git ls-files .env` → leer | done | Status: `todo` · `in_progress` · `done` · `drift` (vom Audit markiert). diff --git a/sessions/F-01-2026-06-03.md b/sessions/F-01-2026-06-03.md new file mode 100644 index 0000000..6476442 --- /dev/null +++ b/sessions/F-01-2026-06-03.md @@ -0,0 +1,38 @@ +# Session F-01 — 2026-06-03 + +- **Rolle:** worker +- **Modell:** Sonnet 4.6 +- **Ziel:** Projekt-Skeleton für tg-bot-jetson anlegen + +## Geändert (Dateien — Repo: tg-bot-jetson) +- `pyproject.toml` — deps: python-telegram-bot v21, httpx, pydantic-settings; dev: pytest, ruff +- `src/bot/config.py` — Settings-Klasse mit lru_cache-Factory +- `src/bot/{whitelist,handlers,connector}.py` — Platzhalter +- `src/main.py` — Platzhalter +- `tests/test_config.py` — 3 Tests +- `.env.example`, `.gitignore` + +## Entscheidungen +- pydantic-settings v2 parst `list[int]` via JSON-Array-Format (`[111,222]`), + nicht Comma-Separated. `.env.example` und Tests entsprechend angepasst. +- `settings` wird nicht auf Modulebene instantiiert — stattdessen `get_settings()` + mit `@lru_cache`, damit Tests und Prod unabhängig bleiben. + +## Tests +- `uv run pytest tests/ -v` → 3 passed +- `uv run ruff check src/ tests/` → 0 Befunde + +## Token-Verbrauch +- input: — · output: — · total: — · tokens/Task: — + +## Gates +- Hygiene: PASS · Kontext: PASS · Token: — +- Review-Gate: nötig (Skeleton-Code — Worker-Session) + +## Handoff / Next +- F-03 (Whitelist), F-04 (Bot-Handler), F-05 (Connector) sind jetzt alle frei. +- Leader erstellt die drei Prompts und dispatcht sie parallel. +- Review-Gate nötig? Ja — Opus-Session auf Commit `82eb6a6`. + +## Clean-Start-Check +- [x] Orientierung allein aus AGENTS/STATE/CONVENTIONS möglich.