feat: snapshot Linux-first RMM MVP and pause handover
Rust development slice / linux (push) Failing after 1m10s

This commit is contained in:
BuTzZ
2026-11-12 22:06:25 +01:00
commit 6c3203d725
194 changed files with 49234 additions and 0 deletions
+163
View File
@@ -0,0 +1,163 @@
# Übergabe / Entwicklungspause — 2026-11-12
**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.