phase2d: gemeinsames Ziel-Modell, KI-Box als erster Adapter, strukturierter Update-Verlauf

- kern/ziele.py: Ziel -> Bausteine mit Stand (neu/aktuell/unbekannt/festgehalten/wird-geprueft),
  Versionen und dem Knopf, der das Update anstoesst; gleiches Modell fuer Box und Homelab
- services/box_updates.py: Update-Zwischenspeicher aus dem Router geholt, ki_box_ziel() als
  Box-Adapter; GET /api/ziele
- Update-Verlauf strukturiert: autoupdate.sh und die Update-Knoepfe schreiben je Baustein eine
  JSON-Zeile (mc2-update-verlauf.jsonl); die Meldungstexte bleiben gleich, aeltere Laeufe kommen
  weiter aus dem Meldeprotokoll. Updates per Knopf erscheinen jetzt auch im Verlauf.
- jobengine: Abschluss-Haken fuer jedes Ende (neben der Nacharbeit fuer den Erfolg)
- Sonntags-Lauf setzt seinen Anlass; Hermes-Job aus dem Lauf schreibt nicht doppelt
- Vertragstest Bash-Schreiber gegen Python-Leser (laeuft auf der Box mit jq)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

backend/routers/boxwart.py

@@ -8,12 +8,12 @@ Box-Wart-Schnittstellen (Umbau 09/2026): alles, was der Cockpit-Startbildschirm
   GET  /api/updates/verlauf                Was die letzten Update-Läufe wirklich gebracht haben
   POST /api/updates/festgehalten/{b}/freigeben   Festgehaltenen Baustein wieder freigeben
   GET  /api/modelle/aufraeumen             Was auf der Modell-Platte ungenutzt Platz belegt
+  GET  /api/ziele                          Die KI-Box als Ziel mit Bausteinen (gemeinsames Modell, Phase 2)
   POST /api/modelle/aufraeumen/loeschen    Einen Kandidaten löschen (nur auf Knopfdruck)
 
 Dünn: die Logik liegt in services/waechter.py, modell_nutzung.py, zeitplan.py, update_verlauf.py.
 """
 
-import threading
 import time
 from datetime import datetime
 
@@ -25,8 +25,8 @@ from pydantic import BaseModel
 from services import (
     aufraeumen,
     backup,
+    box_updates,
     llamaswap,
-    maintenance,
     modell_nutzung,
     system,
     update_verlauf,
@@ -36,64 +36,6 @@ from services import (
 
 router = APIRouter(prefix="/api", tags=["boxwart"])
 
-_updates_lock = threading.Lock()
-_updates_cache: dict = {"ts": 0.0, "daten": None, "laeuft": False, "stand": -1}
-UPDATES_CACHE_S = 600
-
-
-def _updates_holen() -> None:
-    stand = maintenance.update_stand
-    try:
-        daten = maintenance.updates()
-    except Exception:
-        daten = None
-    with _updates_lock:
-        if daten is not None or _updates_cache["daten"] is None:
-            _updates_cache["daten"] = daten or {}
-        _updates_cache["ts"] = time.time()
-        _updates_cache["stand"] = stand
-        _updates_cache["laeuft"] = False
-
-
-def _updates_gecacht() -> dict:
-    """maintenance.updates() fragt GitHub, apt und Hugging Face und braucht nach einem Neustart
-    gern zehn Sekunden und mehr. Der Start wartet darauf nie: Er bekommt den letzten Stand (oder
-    zunächst nichts), frisch geholt wird im Hintergrund."""
-    with _updates_lock:
-        # Nach jedem abgeschlossenen Update zählt maintenance.update_stand hoch — dann sofort neu holen,
-        # statt bis zu 10 Minuten „Aktualisieren“ für schon eingespielte Updates zu zeigen (24.09.2026).
-        veraltet = (_updates_cache["daten"] is None or time.time() - _updates_cache["ts"] > UPDATES_CACHE_S
-                    or _updates_cache["stand"] != maintenance.update_stand)
-        if veraltet and not _updates_cache["laeuft"]:
-            _updates_cache["laeuft"] = True
-            threading.Thread(target=_updates_holen, name="updates-holen", daemon=True).start()
-        return _updates_cache["daten"] or {}
-
-
-def _bausteine(u: dict) -> list[dict]:
-    """Welche Bausteine haben Neues? In der Reihenfolge, in der auch das Update läuft."""
-    liste = []
-    if u.get("os"):
-        liste.append({"id": "os", "name": "Betriebssystem", "neu": f"{u['os']} Pakete"})
-    if u.get("engine"):
-        liste.append({"id": "engine", "name": "Motor", "neu": "neuer Build"})
-    if u.get("swap"):
-        liste.append({"id": "swap", "name": "llama-swap", "neu": "neue Version"})
-    for c in u.get("components") or []:
-        if c.get("key") == "hermes_agent" and c.get("update"):
-            liste.append({"id": "hermes", "name": "Hermes", "neu": f"{c.get('behind', '?')} Änderungen"})
-    return liste
-
-
-NAMEN_UNKLAR = {"os": "Betriebssystem", "engine": "Motor", "swap": "llama-swap", "hermes": "Hermes"}
-
-
-def _unklar(u: dict) -> list[dict]:
-    """Bausteine, deren Update-Prüfung scheiterte — ehrlich „unbekannt“ statt „aktuell“."""
-    return [{"id": k, "name": NAMEN_UNKLAR.get(k, k), "grund": grund}
-            for k, grund in (u.get("pruef_fehler") or {}).items() if grund]
-
-
 def _zeit_kurz(ts: float | None) -> str:
     if not ts:
         return "–"
@@ -152,12 +94,12 @@ def _lampen(stand: dict, u: dict) -> list[dict]:
         "warn" if platte < waechter.DISK_ROT_PCT else "fehler")
     lampen.append(lampe("platte", "Platte", zustand, f"{platte:.0f} %" if platte is not None else "–"))
 
-    n = len(_bausteine(u))
+    n = len(box_updates.bausteine(u))
     fest = len(update_verlauf.festgehalten())
-    unklar = len(_unklar(u))
+    unklar = len(box_updates.unklar(u))
     if fest:
         lampen.append(lampe("updates", "Updates", "warn", f"{fest} festgehalten"))
-    elif _updates_cache["daten"] is None:
+    elif not box_updates.gelesen():
         lampen.append(lampe("updates", "Updates", "aus", "wird geprüft"))
     elif n:
         lampen.append(lampe("updates", "Updates", "info", f"{n} bereit"))
@@ -183,7 +125,7 @@ def _box() -> dict:
 @router.get("/start")
 def start() -> dict:
     stand = waechter.lese_stand()
-    u = _updates_gecacht()
+    u = box_updates.gecacht()
     rot = sum(1 for h in stand["hinweise"] if h.get("stufe") == "rot")
     anzahl = len(stand["hinweise"])
     wach = bool(stand["stand"]) and time.time() - float(stand["stand"] or 0) < 5 * 60
@@ -199,9 +141,9 @@ def start() -> dict:
         "verlauf": stand["verlauf"][:20],
         "lampen": _lampen(stand, u),
         "box": _box(),
-        "updates": {"bausteine": _bausteine(u), "unklar": _unklar(u),
+        "updates": {"bausteine": box_updates.bausteine(u), "unklar": box_updates.unklar(u),
                     "festgehalten": update_verlauf.festgehalten(),
-                    "gelesen": _updates_cache["daten"] is not None},
+                    "gelesen": box_updates.gelesen()},
         "flugplan": zeitplan.flugplan(),
     }
 
@@ -253,3 +195,10 @@ def aufraeumen_loeschen(auftrag: LoeschAuftrag) -> dict:
     if not ergebnis.get("ok"):
         raise HTTPException(status_code=409, detail=ergebnis.get("detail") or "Löschen ging nicht.")
     return ergebnis
+
+
+@router.get("/ziele")
+def ziele() -> dict:
+    """Die KI-Box im gemeinsamen Ziel-Modell (kern/ziele.py). Der Homelab-Teil liefert seine Ziele ab
+    Phase 3 unter /api/homelab/ziele; die Oberfläche legt beide zu einer Update-Liste zusammen."""
+    return {"ziele": [box_updates.ki_box_ziel().als_dict()]}