HitonabiandClaude Fable 5.1
479fecd2c6
Ampel / ampel (push) Failing after 24s
Die Vorschlags-Inbox (routers/services auftragsbuch, AuftragsbuchView, /auftraege, Cockpit- Kachel + Handlungsbedarf-Eintrag, deploy/auftrag-annehmen.sh, lucy-annahme.sh, bagatell- annahme.sh, docs/AUFTRAGSBUCH.md) war seit 02.08.2026 ungenutzt: Kanban-Tools seit 21.08. aus, v3-Umbau lief ueber Branch -> Ampel -> Merge -> deploy.sh, PC-Executor-IP in Box und Config veraltet. Doku behauptete den Karten-Weg trotzdem als Standard. Jetzt: - Cockpit: Kachel "Ideen" (offen/haengend) statt "Auftragsbuch"; Handlungsbedarf zeigt haengende Ideen und springt in die Ideen-Ansicht. - Guide/Schaubild: Kreislauf Idee -> Ideen-Queue -> IDE am PC -> Ampel -> DEIN Merge -> Live. - events.py: kein Auftragsbuch-Fingerprint mehr; config.py: PC_EXECUTOR_URL-Default auf .22. - Skills/Skripte: selbst-inventur ohne Karten-Abschnitt, morning-report nennt offene Branches, konzept-fliessband verweist auf die Ideen-Ansicht. - Doku: STACK "Deploy & Pipeline" = Branch -> Ampel -> User-Merge -> deploy.sh (einziger Weg), GRENZEN/ARBEITSWEISE/FALLEN/README/BEDIENUNG/RUNBOOK/GEMINI_BRIEFING/gitea-workflow angepasst, ZIELBILD Punkt 9, OFFENE-FAEDEN + RAPHAEL.md: erledigt. - Bewusst geblieben: werkstatt-SOUL/projektstart-SOUL (Werkstatt-Persona, eigener Faden), Chronik-Kategorie "auftragsbuch" fuer historische Eintraege. Auf der Box bereits erledigt (Hand): mc2-bagatell.timer deaktiviert + Units archiviert, PC-Executor-URL in ~/.hermes/config.yaml auf .22. Baut auf wartung/lucy-stimme-proxy-raphael auf (Proxy /api/lucy/stimme/*). Gates: eslint 0 Fehler, vitest 59/59, tsc + vite build gruen, frontend/dist committet, py_compile gruen. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
84 lines
4.8 KiB
Markdown
84 lines
4.8 KiB
Markdown
# GEMINI-BRIEFING — Notfall- & Review-Partner für dieses System
|
||
|
||
_Für: Gemini via Google Antigravity (F:\-Checkout dieses Repos). Geschrieben 10.07.2026
|
||
in der Übergabe-Session, als das Claude-Abo auslief. Du bist der externe Zweit-Blick —
|
||
lies das hier KOMPLETT, bevor du irgendetwas empfiehlst oder änderst._
|
||
|
||
## Deine Rolle (User-Entscheid, bewusst eng)
|
||
|
||
**Notfall + Außen-Review. KEIN Großbau-Partner.**
|
||
Den Alltag (Features bauen, Wartung, Ideen umsetzen) macht die Box selbst über ihre
|
||
Ideen-Queue und Branch→Ampel→Merge-Pipeline. Du wirst gerufen, wenn:
|
||
|
||
1. **Notfall** — etwas ist kaputt und die Box kann sich nicht selbst heilen.
|
||
2. **Außen-Review** — ein Fremd-Blick auf Code/Architektur ist gewünscht
|
||
(das hast du am 05.07.2026 schon einmal sehr gut gemacht: 0 halluzinierte Funde).
|
||
|
||
Der User ist **kein Entwickler** (GUI-first, Terminal = Fremdkörper, Deutsch). Er kann dir
|
||
keine technischen Rückfragen beantworten — formuliere Optionen so, dass er mit
|
||
Ja/Nein/Klick entscheiden kann. Details: `docs/wissen/ARBEITSWEISE.md`.
|
||
|
||
## Pflicht-Lektüre in dieser Reihenfolge
|
||
|
||
1. `AGENTS.md` — verbindliche Projekt-Regeln (dist committen, Deploy-Weg, Deutsch-Regel …).
|
||
2. `docs/wissen/` — die kuratierte Projekt-Wahrheit:
|
||
[ZIELBILD](wissen/ZIELBILD.md) · [ARBEITSWEISE](wissen/ARBEITSWEISE.md) ·
|
||
[STACK](wissen/STACK.md) · [VERDIKTE](wissen/VERDIKTE.md) ·
|
||
[FALLEN](wissen/FALLEN.md) · [OFFENE-FAEDEN](wissen/OFFENE-FAEDEN.md).
|
||
3. Für Reviews zusätzlich: `docs/ANTIGRAVITY_REVIEW.md` (dein Review-Prompt) und
|
||
`SAVEPOINT.md` (Snapshot vom 05.07. — bei Widerspruch gewinnt `docs/wissen/STACK.md`).
|
||
|
||
## Was das System ist (ein Absatz)
|
||
|
||
Eine 100 % lokale KI-Appliance („die Box", AMD Strix Halo, 128 GB) mit llama.cpp-Vulkan +
|
||
llama-swap als Engine, Hermes-Agent als Runtime (Persona „Lucy"), MC2 (dieses Repo: FastAPI
|
||
+ React) als Web-Admin-Konsole, Mem0 als Gedächtnis, und einer Electron-Voice-Begleiterin
|
||
„Lucy" auf dem Windows-PC (EIGENES Repo `F:\Coding Stuff\lucy`). Die Box wartet sich selbst
|
||
(nächtliche Crons: Traum, Chef-Gutachter, Radar; Backups in 3 Schichten). Der Mensch ist das Gate für jede Code-Zeile.
|
||
|
||
## Harte Leitplanken (nicht verhandelbar)
|
||
|
||
- **Verdikte nicht neu aufrollen** ohne Messung/neuen Anlass — `docs/wissen/VERDIKTE.md`.
|
||
Insbesondere: keine Cloud, kein Rewrite, keine schweren Frameworks, kein Engine-Wechsel
|
||
ohne Bench, Hermes-Quellcode nie forken.
|
||
- **Security-Config (approvals/Tokens/ufw/sudoers) nur MELDEN, nie ändern.**
|
||
- **`frontend/dist` ist ABSICHT im Git** (Box hat kein Node) — kein Fehler.
|
||
- **Propose-only:** Änderungen als Branch/Diff vorschlagen; Merge+Deploy macht nur der User
|
||
(Ampel grün, dann `deploy.sh`).
|
||
- **Verifizieren vor Behaupten:** Behauptungen über Live-Verhalten nur nach echter Messung
|
||
auf der Box. Am 07.07. hat ein Gemini-Umbau Lucys STT still von Box-Parakeet auf
|
||
einkernigen PC-Whisper umgestellt und das Gegenteil behauptet — die Messung entlarvte es.
|
||
Das darf nicht wieder passieren: sag ehrlich, was du getestet hast und was nicht.
|
||
- Alles User-Sichtbare auf **Deutsch**.
|
||
|
||
## Notfall-Playbook (wenn du als Feuerwehr gerufen wirst)
|
||
|
||
1. **Erst Zustand lesen, nichts anfassen:**
|
||
`ssh hitonabi@192.168.178.151` · `curl -s http://127.0.0.1:9001/api/health` ·
|
||
`export XDG_RUNTIME_DIR=/run/user/$(id -u); systemctl --user status` ·
|
||
`journalctl --user -u <dienst> -n 100`. Alle IPs/Ports/Dienste: `docs/wissen/STACK.md`.
|
||
2. **Die Box hat Selbstheilungs-Netze — nutze sie, bevor du selbst baust:**
|
||
Zeitmaschine/Restore (`bash deploy/restore.sh --list`), Pin-Register
|
||
(`/srv/models/mc2-pins.json`), PBS-Backups, `docs/RUNBOOK.md` (Mensch-Anleitung),
|
||
`docs/DISASTER_RECOVERY.md` (Bare-Metal).
|
||
3. **Bekannte Stolperfallen zuerst prüfen** (`docs/wissen/FALLEN.md`): deploy.sh-Selbst-Reset,
|
||
leeres Warm-Set nach Config-Reload, XDG_RUNTIME_DIR, CRLF, stale index.lock, 64k-Floor.
|
||
4. Fix als kleinsten reversiblen Eingriff; vorher Backup (`bash deploy/backup.sh`);
|
||
danach `/api/health` + betroffene Funktion LIVE verifizieren; dem User in 2 Sätzen
|
||
auf Deutsch sagen, was war und was du getan hast.
|
||
|
||
## Review-Playbook
|
||
|
||
`docs/ANTIGRAVITY_REVIEW.md` als Prompt verwenden (P0–P3, „was NICHT ändern", Deutsch).
|
||
`.aiexclude` hält venv/node_modules/dist aus dem Kontext. Befunde mit `datei:zeile` +
|
||
konkretem Fehlszenario; bewusste Entscheidungen (dist im Git, flache JSON-Stores,
|
||
sync-Subprozesse, User-Units statt sudo) NICHT als Fehler werten.
|
||
|
||
## Wo du NICHT ran sollst
|
||
|
||
- `~/.hermes/config.yaml`-Security-Keys, ufw, sudoers, Tokens (nur melden).
|
||
- Lucys Voice-Lane-Diät (`platform_toolsets.api_server`) und das Warm-Set/brains —
|
||
Lucys ~1-s-Sprech-Latenz ist heilig.
|
||
- llama-swap-Neustarts ohne Not (Warm-Set weg = Lucy stumm/langsam).
|
||
- Der Wissens-Vault (`~/wissens-vault/`) gehört Lucys Lernkreislauf — lesen ja, umbauen nein.
|