Files
rust-discovery/docs/handover.md
T
2026-11-13 13:49:11 +01:00

180 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Übergabe / Entwicklungspause — 2026-11-12
**Historische Übergabe. Wiederaufnahme am 2026-11-13 ausdrücklich beauftragt.**
Die lokale Servertopologie wurde inzwischen durch den dedizierten Internetserver
ersetzt; aktueller Zustand und Zugänge: [server-deployment.md](server-deployment.md).
Der unten genannte Skript-/SHA-Konflikt ist korrigiert. Alte Nachweise bleiben
historisch; neue getrennte Testidentitäten sind keine Wiederherstellung der alten
Serverhistorie. Aktueller Prüfstand: [implementation-status.md](implementation-status.md).
**Neuester Cloud-Stand 2026-11-13:** Root-Testdienst eingerichtet/gestartet/gestoppt,
jeweils tatsächlich separat WebUI-genehmigt und auf VM bestanden. Erste APT-
Acceptance `failed / HOOK_NOT_HANDED_OFF`, APT 100 vor Hookübergabe, Paketbestand
unverändert. Kein Wiederholungsversuch; Create-once-Marker und Ledger erhalten.
Root-Testpolicy geschlossen, APT-Helper gestoppt/deaktiviert; Cloud-Agent aktiv,
Notebook ohne Client. Cloud-Controlpfad-Maskierungsfix nur im Quellcode/lokal
geprüft, neue VM-Readiness und sichere Weiterführung des gespeicherten Fehlversuchs
offen. Details und Belege in [server-deployment.md](server-deployment.md#root--apt-abnahmelauf-2026-11-13).
**Auf Userwunsch pausiert. Linux-MVP M0–M5 ausdrücklich NICHT vollständig
abgenommen; keine Produktionsfreigabe.** Dieser Durchgang sichert Dokumentation
und prüft veröffentlichbare Quellen. Keine Entwicklung, Builds, Tests,
Deployments oder RMM-Jobs fortsetzen. Commit/Push ist ein separater Schritt des
Orchestrators nach Sicherheitsprüfung; hier weder Staging noch Commit/Push.
## Einstieg und verbindliche Grenzen
- Repository: <https://gitea.incoso.eu/kevin_janssen/rust-discovery>;
SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`.
Remote vor Veröffentlichung erneut prüfen; keine erfolgreiche CI behaupten.
- Zuerst vollständige Spezifikation 1.5, `AGENTS.md`,
`docs/project-decisions.md` und `docs/development.md` lesen. Windows erst nach
Linux-MVP-Abnahme; PVE/PBS/Cluster/Backups nachgelagert. **RustDesk AUS**,
keine Installation/Provisionierung/Desktopabnahme oder eigene Desktop-Engine.
- Jeder Job beginnt als persistenter Antrag `pending_approval`. Vor Genehmigung
**0 Jobs/Outbox/Startgrants**, keine JobOffers/Wirkung. Nur interaktive WebUI
genehmigt den unveränderlichen Plan; MCP/KI dürfen nicht selbst genehmigen,
keine direkte API-/DB-Freigabe. Policies begrenzen/verweigern nur.
- Dev/test-Browserbedienung ausschließlich sichtbar **SIMULIERT**, Audit mit
`approval_origin=dev_test_browser_simulation`, `testsimulation=true`,
Testprincipal und Planbezug. Kein menschlicher Produktionsfreigabenachweis.
Neue Versuche/neue Wirkung brauchen neuen genehmigten Plan; unklare Wirkung
bleibt `unknown`, nicht blind wiederholen.
## Plattform und sicherer finaler Pausenzustand
Server lokal in Docker auf dem PC, TLS nur `127.0.0.1:18443`, PostgreSQL intern
ohne publizierten Port. PC-initiiertes SSH im Devmodus: `-N -T`, strikte
Hostkeyprüfung, `ExitOnForwardFailure=yes`, Keepalive 30/3 und
`-R 127.0.0.1:18443:127.0.0.1:18443`. VM-Agent ausgehend über Loopback;
TLS Ende-zu-Ende mit vertrauenswürdiger Dev-CA und SAN/SNI `rmm-dev.internal`.
Connect-Override darf nur TCP ändern, niemals Namens-/Zertifikatsprüfung.
Netzwerkagent unprivilegiert als `rmm-agent` (UID 993, Gruppe 984), Roothelper
separat; kein Root-Netzwerkagent.
**Finales VM-Worker-Verdikt, in `docs/implementation-status.md` protokolliert:**
- Agent und beide Helper (`rmm-agent.service`, `rmm-helper-dev-test.service`,
`rmm-apt-helper.service`) **inactive**; kein Reversetunnel/VM-18443-Listener.
- Rootledger **0 consumed / 0 unknown**, kein laufender Installer-/Paket-/Rebootjob.
Einziger VM-Joberfolg bleibt der frühere Hello-World-Lauf; keine neuen Jobs,
Anträge oder Genehmigungen im letzten Upgrade-/Pauselauf.
- Lokaler Docker-Server und PostgreSQL laufen bewusst weiter, Portbindung wie
oben. Kein pauschales „alles gestoppt“. Letzter zuvor gemeldeter Serverstart
20:49:18 UTC ist kein hier erneut erhobener Startzeitnachweis.
- Aktuelle Bookworm-Releaseartefakte für Agent/Helper gebaut und konkrete
VM-Loaderprüfung bestanden (glibc 2.34/OpenSSL 3). Runtimeupgrade bewahrte
Identität und Journal-Dateibytes/SQLite-Schema/Rows. Alte Artefakte/Backups bleiben.
- Bekannte Fixturearchive administrativ versiegelt, **keine Paketinstallation**.
Tatsächliche dedizierte APT-Probe **FEHLGESCHLAGEN**:
`APT_CONTROLLER_PROFILE_REQUIRED`, Start-Exit 1. Keine Native-Readiness,
Native-Acceptance oder Paketwirkung; Helper danach kontrolliert gestoppt.
Unit-Härtung wurde nicht zur Umgehung gelockert.
## Funktionen und Nachweise — Ebenen nicht vermischen
| Bereich | Lokal / Entwickler-PC | Tatsächliche Linux-VM |
|---|---|---|
| TLS/Enrollment/Inventar | Lokale Integrationsnachweise vorhanden | Passives Inventar und Heartbeats früher belegt |
| MCP → UI → Grant → Agent | Gemeinsame Plan-/Antragsstrecke implementiert | Früherer Hello World unter unprivilegiertem systemd-Agent: genau 1 Grant, 1 Wirkung; Journal/Ergebnis belegt |
| Roothelper | Neue Root-/APT-/Sync-Schnittstellen implementiert | Readiness des **alten** Profils belegt; neues Runtime installiert, APT-Probe fehlgeschlagen, keine vollständige Rootaktionsabnahme |
| Paket/Update/Dienst/Reboot | Adapter und Sicherheitsprüfungen vorhanden | Aktuelle UI-genehmigte native Wirkungskette weiterhin offen |
| OIDC/WebUI | OIDC-Adapter implementiert, externe IdP-Konfiguration `not_configured`; Dev-UI-Testactor simuliert | Kein produktiver IdP-/MVP-Abnahmenachweis |
| Replay/ACK-Verlust | Lokale Regressionspfade vorhanden | Native Fault-Injection für duplicate_offer/lost_result_ack **unsupported**, nicht grün |
Letzte getrennte, von den jeweiligen Sourceownern dokumentierte Prüfstände,
**in dieser Übergabe nicht erneut ausgeführt und nicht zu einer Summe addieren**:
- Client: **115 Rust-Alltargets-, 56 Python-APT-, 2 Installer-Guardtests**;
Clippy/Format, Debug/Release grün (`deploy/linux/runtime-README.md`). Dies ist
der letzte vollständig validierte Client-Quellstand, nicht „alles aktuell grün“.
PC-Artefakte sind nicht mit dem separaten Bookworm-/VM-Loaderbeleg gleichzusetzen.
- UI: zuletzt **23 Unit- und 5 TLS-Browsertests** gemeldet; OIDC **13 + 1 PG**
sowie **35 integrierte Assertions**. Backend **150 Assertions**, Transport
**38**, Rootlog **15** als bestehende getrennte Snapshotnachweise. Verträge und
Prüfkontext: `web/README.md`, `crates/server/OIDC.md`, `tests/oidc/README.md`,
`proto/BACKEND_CONTRACT.md`. Keine neue Ausführung/CI-Verifikation in der Pause.
- Backend zuletzt mit Rootlogs-Image/Migrationen 1–12 gemeldet; Runtime-/VM-Probe
ist ein separater Nachweis und macht offene Funktionstests nicht erfolgreich.
## Bekannter ungeprüfter Snapshotfehler — NICHT jetzt korrigieren
Die letzte Änderung der `SERVICE_SETUP`-Skriptbytes in
`deploy/vm_mvp_adapters.py` für den vorerzeugten leeren Unit-Inode wurde **nicht
erneut getestet**. Alte SHA-Pins stehen noch in
`tests/browser/mvp-actions.spec.ts` (service_setup-Prüfung) und
`tests/vm_mvp_guards.py` (Setup-Hashassertion). Bei Wiederaufnahme zuerst Bytes,
Browser-Pin und Guard-Pin konsistent anpassen und gezielt prüfen. Frühere
**28 Guards** sind **kein finaler Nachweis** dieser Änderung. Absichtlich keine
Reparatur im angeforderten Pause-/Snapshotdurchgang.
## Wiederaufnahme — erst nach neuem Auftrag, nichts davon hier ausgeführt
1. Erhaltenen Zustand und feste Geräte-/Job-/Versuchsbindung kontrollieren.
Den tatsächlichen Controllerprofilfehler gegen `verify_controller_profile()`
**zuerst diagnostizieren**, vor weiteren Mutationen/Proben. Keine Härtung,
Capability-, Peer-, Pin-, Sync- oder Genehmigungsgrenze blind abschwächen.
Den oben dokumentierten Skript-/SHA-Konflikt vor Suiteausführung beheben.
2. Bookworm-Artefakt/Deploymentmanifest, tatsächliche Unit-/Public-Pins,
getrennte Helperledger und dedizierte RPC-/APT-Readiness prüfen. Build und
Loadercheck liegen vor, Native-APT-Probe dagegen nicht bestanden.
3. Frischen Peer-/Sync-/passiven Planungsnachweis und aktuelle Baseline erheben;
anschließend einzeln UI-genehmigte Rootdienst-/Paket-/Updatefälle. Fixture
nach Upgrade auf **1.1**, fresh baseline und gewünschte Noop-Nachbedingungen
konsistent halten; keine heimliche Entfernung/Downgrade/Reset von Paketstate.
4. HTTPS-Transport, Rotation, Reconnect, Ablauf/Cancel, Reboot zuletzt mit eigener
Recovery und neuer Boot-ID sowie tatsächliche Wirkung/Nachprüfung abnehmen.
Duplicate-/lost-ACK-Nativefaultadapter fehlen weiterhin; nicht durch zweiten
Job als vermeintliche Redelivery ersetzen. Vor jedem Job erneut 0/0/0-Gate.
5. Linux-MVP erst nach vollständigen realen Feature-/Fehlernachweisen abnehmen.
Bestehende Identität/Journale/Backups niemals löschen oder neu enrollen, um
Tests grün zu machen. Create-only Bootstrapphasen nicht blind wiederholen.
## Quellnavigation, Befehle und geschützte Evidenz
- Agentbetrieb/Config: `deploy/linux/runtime-README.md`, `deploy/linux/README.md`;
APT: `deploy/linux/apt-helper-README.md`,
`tools/apt-transaction/HELPER-CONTRACT.md`; Backend/Rootlogpolicy:
`proto/BACKEND_CONTRACT.md` (`RMM_ROOT_LOG_UNITS` und zugehörige Grenzen,
Rootlogs standardmäßig verweigert); Login: `crates/server/OIDC.md`.
- Bestehende Kernbefehle in `README.md`: `python3 deploy/dev.py init|up|status`,
CA-verifizierter `/healthz`-Check und `python3 deploy/dev.py down` ohne
Datenlöschung. **Hier nur nachgelesen, nicht ausgeführt.** `init` überschreibt
keinen vorhandenen Zustand; `up` baut/startet und ist keine Pauseaktion.
Die älteren Funktionsaussagen in README/unteren Statusabschnitten sind
historische Slices; aktueller finaler Pauseabschnitt hat für diesen Snapshot Vorrang.
- Geschützt/gitignored: `devstate/vm-jobs/result.json` (Hello World),
`devstate/vm-root/` (historische Rootreadiness),
`devstate/vm-final/68741ab0b1c84e15bf3fc442bd812558/`
(`build.json`, `install.json`, `probe-diagnostic.json`; kein erfolgreicher probe.json).
VM-seitig: `/var/lib/rmm-bootstrap-history/68741ab0b1c84e15bf3fc442bd812558/`
und `/etc/rmm/runtime-v2-probe-report.json`. Nur Pfade, keine privaten Inhalte.
- Zugangsdaten/Rohlogs/Schlüssel bleiben unter `credentials/`, `.env`,
`secrets/`, `devstate/` bzw. geschütztem VM-State. Nie in Git/Chat/Jobausgaben;
0700-Verzeichnisse/0600-Secretdateien, Daten strikt parsen, kein source/eval.
Keine VM-Adressen, Passwörter, privaten Agentkeys oder Tokens veröffentlichen.
- Vor Staging ausschließlich nichtignorierte Quellpfade aus
`git ls-files --cached --others --exclude-standard` prüfen; echte PEM-Blöcke,
Credentialliterale, private Laufzeitdateien/Adressen und Browsertraces melden
**nur als Anzahl, Pfad, Regel**, niemals Matchzeilen. Build-/Browsercaches nicht
veröffentlichen. `.env.example` mit Platzhaltern und generierte Testfixtures
sind nicht automatisch echte Zugangsdaten. Keine Userdateien verschieben/löschen.
### Sicherheitsprüfung dieses Übergabedurchgangs
Nichtignorierte Sourcepfade: **194**, alle 194 auf echte vollständige private
PEM-Blöcke, auffällige Credentialliterale/Providertokens, nichtbeispielhafte
IPv4-Adressen und private Laufzeit-/Binärdateinamen geprüft. **Keine bestätigten
Leakfindings.** Ein Literal-Kandidat in `crates/oidc-auth/src/tests.rs` wurde als
ungenutzter synthetischer Access-Token der lokalen Mock-Providerantwort geprüft
und verworfen; Schlüssel der Tests werden zur Laufzeit generiert. Keine
Credentialdateien für diese Prüfung gelesen, kein Secretvergleich erforderlich.
Das ist eine heuristische Sourceprüfung, keine Garantie über unbekannte Secrets.
Ignore-Ausschluss ausdrücklich bestätigt für `crates/oidc-auth/target/`,
`devstate/`, `credentials/linux-vm.conf`, `web/node_modules/`, lokale
Testresults/Playwrightreports. Root-Ignore ergänzt um verschachtelte `target/`
und präzise private Browsertrace-/Reportpfade. Keine Source-/Testverzeichnisse
pauschal ausgeschlossen. Vor tatsächlichem Staging erneut prüfen, da parallele
Änderungen diesen Snapshot verändern können.