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
+188
View File
@@ -0,0 +1,188 @@
# Linux-first-Entwicklung und reale VM-Abnahme
Stand: 2026-11-12 · Spezifikation 1.5. Dieses Dokument beschreibt verbindliche Entwicklungsregeln und einen grundsätzlich **geplanten** Ablauf. Tatsächlich ausgeführte Prüfungen stehen ausdrücklich im Nachweisabschnitt am Ende; die übrigen Beispiele sind keine Testergebnisse. Tatsächlicher Implementierungsstand wird separat geführt.
## Ergänzende Userfreigabe und lokale Browserprüfung (2026-11-12)
Der User hat temporären Testdienst, harmloses Testpaket, systemd-Agent, einen VM-Reboot
und ausgewählte kleine Updates ausdrücklich erlaubt; kein Kernel-/Distributionsupdate
und kein ungeplanter Reboot. Jeder entsprechende RMM-Job benötigt weiterhin seinen
festen Plan und explizite WebUI-Genehmigung, bei dev/test sichtbar als Simulation.
Diese Freigabe ist kein Ausführungsnachweis. Im lokalen Browser-Integrationslauf wurden
keine VM-Änderungen, Tunnel, Paket-/Update-/Rebootjobs oder Genehmigungen ausgeführt:
nur echtes TLS, Login, Zielpreview, Antrag `pending_approval`, Reload und CSRF-Prüfung
mit authentisiertem synthetischem lokalem mTLS-Testgerät. Details und reproduzierbarer
isolierter Browser-Truststore: `deploy/browser/README.md`; keine globale Truständerung.
## Phasen und Gates
1. **Linux-MVP:** M0–M5 auf Linux x86-64 mit zwei Testmandanten, WebUI, MCP und dauerhaftem, menschlich autorisiertem Jobpfad. **Jedes Feature zuerst auf der tatsächlichen Linux-Test-VM ausführen und nachweisen.** Der PC-/Containerlauf, ein Simulator oder erfolgreicher Build allein genügt nicht. Nicht auf der VM geprüfte Features bleiben unbestätigt.
2. **Windows nach Linux-MVP:** Erst nach dokumentierter Linux-MVP-Abnahme Windows-x86-64-Adapter, Dienste, Installer und dieselben Fähigkeiten nativ auf Windows abnehmen. Gemeinsame Schnittstellen berücksichtigen Windows, ohne vorgezogene Windows-Featureimplementierung.
3. **Spätere Erweiterungen:** Monitoringausbau/ARM64, danach gesondert PVE/PBS, Cluster und Backupabnahmen gemäß Spezifikation; Terminal/Betriebsreife folgen ebenfalls nach MVP. PVE ist weder Testinfrastrukturpflicht noch Voraussetzung für eigenständige Gastagenten.
Linux-MVP-Gate: Enrollment, verifiziertes TLS/mTLS, ausgehender Kanal, passives Inventar mit Quelle/Zeit, UI/MCP-Tenant-Grenzen, Antrag `pending_approval`, WebUI-Klick (tatsächlich menschlich oder ausschließlich die unten beschriebene dev/test-Browsersimulation, getrennt nachzuweisen), dauerhafte Jobs/Journal/Startgrants und nachgewiesene Ergebnisse auf der VM. Die M0–M5-Abnahmen gelten zunächst für Linux; Windows-/Mischplattformfälle folgen erst in der Windows-Phase. Long Polling, Reconnect, fehlende Genehmigung und Redelivery ohne Doppelwirkung ebenfalls nachweisen. **Useroverride 2026-11-12: RustDesk auslassen.** Keine RustDesk-Installation, Profile/Provisionierung oder externe Desktopabnahme in dieser Umsetzung. M4 bleibt allgemeine Linux-Paketverwaltung; M5 prüft nur die drei übrigen Referenzabläufe. RustDesk ist weder MVP-Pflicht noch offenes MVP-Gate; bestehende Architekturtexte gelten ausschließlich für eine spätere optionale Integration. Keine eigene Desktop-Engine als Ersatz.
## Geplante Topologie
```text
Entwickler-PC Linux-Test-VM
Docker: TLS-Endpunkt 127.0.0.1:18443 Agent
^ |
| SSH-Weiterleitung (TCP, keine TLS-Terminierung) | ausgehend TLS
+--------------------------------------- 127.0.0.1:18443
PC -- initiiert SSH zur VM --> sshd DNS: rmm-dev.internal
```
Der Server läuft **lokal in Docker auf dem PC**, nicht auf der Ziel-VM. Nur benötigte Ports veröffentlichen und alle Veröffentlichungen explizit an Loopback binden; der geplante TLS-Port lautet `127.0.0.1:18443`. Interne Datenbanken möglichst gar nicht veröffentlichen; andernfalls ebenfalls nur Loopback. Keine Bindings an alle Interfaces, kein `GatewayPorts yes`. Die VM benötigt keinen eingehenden RMM-Port. SSH zum Bootstrap ist eine davon getrennte Entwicklungsverbindung, keine Änderung des ausgehenden RMM-Vertrags.
### Geplanter SSH-Reverse-Tunnel (nicht ausgeführt)
Zuerst den SSH-Hostschlüssel über einen vertrauenswürdigen Weg prüfen und in `known_hosts` hinterlegen. `VM_USER`/`VM_HOST` im folgenden Beispiel sind bewusst **nicht geheime Platzhalter**, keine automatisch geladenen Konfigurationsvariablen. Reale Zugangswerte nicht in geteilte Logs oder Shell-Traces ausgeben.
```sh
# GEPLANT, NICHT GETESTET: auf dem Entwickler-PC, Zielwerte lokal einsetzen.
ssh -N -T \
-o ExitOnForwardFailure=yes \
-o ServerAliveInterval=30 \
-o ServerAliveCountMax=3 \
-o StrictHostKeyChecking=yes \
-R 127.0.0.1:18443:127.0.0.1:18443 \
VM_USER@VM_HOST
```
Der linke Loopback ist der Listener **auf der VM**, das rechte Ziel wird **auf dem PC** erreicht. Der Agent baut seine Verbindung zu diesem VM-Loopback auf; SSH transportiert nur die TCP-Bytes zum lokalen TLS-Endpunkt. `ExitOnForwardFailure` prüft die Einrichtung der Weiterleitung, **nicht** Erreichbarkeit/Gesundheit des lokalen Servers oder erfolgreiche Agentauthentisierung. Keepalive erkennt Verbindungsverlust; ein Tunnelneustart erteilt keine Jobgenehmigung. Bei Portkonflikt oder verweigertem Forwarding sicher abbrechen, nicht auf einen öffentlichen Listener ausweichen.
## TLS bleibt Ende-zu-Ende
- Serverzertifikat mit **DNS SAN `rmm-dev.internal`**, korrekter Gültigkeit und passender Serververwendung bereitstellen; private CA-/Serverschlüssel geschützt lokal halten, nicht committen. Dev-CA gezielt im Agenten-Truststore hinterlegen.
- **Auf der VM** in `/etc/hosts` explizit die folgende Zuordnung pflegen (geplante Bootstrapänderung, nicht hier ausgeführt):
```text
127.0.0.1 rmm-dev.internal
```
- Geplanter Agent-Endpunkt: `https://rmm-dev.internal:18443`, WSS entsprechend `wss://rmm-dev.internal:18443/agent/v1/connect`, sofern die Implementierung diesen Protokollstand tatsächlich bereitstellt. Enrollment verwendet serverauthentifiziertes HTTPS; danach mTLS mit eigener Geräteidentität.
- Alternativ ausschließlich einen ausdrücklich unterstützten und getesteten Client-Connect-Override verwenden: TCP-Ziel `127.0.0.1:18443`, **TLS-SNI und Zertifikatsnamensprüfung weiter `rmm-dev.internal`**. Kein erfundenes CLI-Flag als vorhandenes Feature dokumentieren.
- Ein Aufruf über `https://127.0.0.1:18443` passt nicht zum DNS-SAN. Nicht mit `accept_invalid_certs`, `danger_accept_invalid_certs`, deaktivierter Hostnamenprüfung oder `curl -k` umgehen. SSH ersetzt weder TLS noch Enrollment, mTLS oder Anwendungsautorisierung.
## Lokale Zugangsdaten und Bootstrapgrenzen
- VM-Daten liegen ausschließlich in **`credentials/linux-vm.conf`**. Das Verzeichnis muss in `.gitignore` ausgeschlossen sein; vor Nutzung prüfen. `credentials/` erhält Modus **700**, die Datei **600**; nur der vorgesehene lokale Benutzer hat Zugriff. Auch private Schlüssel/Secretdateien restriktiv schützen. Diese Dokumentationsänderung liest oder verändert keine Zugangsdaten.
- Die Datei ist **Daten, kein Shellskript**. Nur bekannte Felder mit striktem Parser/Validierung einlesen; unbekannte/ungültige Werte zurückweisen. Niemals `source`, `. credentials/linux-vm.conf`, `eval` oder Shell-Expansion des Inhalts verwenden. Kein bestimmtes vorhandenes Dateischema behaupten oder Secrets für Beispiele öffnen.
- Keine Secrets in Commits, Logs, Screenshots, stdout/stderr, Shell-Traces (`set -x`), MCP-/LLM-Kontexten oder Jobausgaben. Keine Passwörter in dokumentierten Kommandozeilen. Zugangsdaten weder zur Dokumentationsprüfung noch zum bloßen Auffinden der VM auslesen.
- Entwicklungs-/Testtools dürfen installiert werden. Zieländerungen auf den vereinbarten Bootstrap (z. B. Agent, Truststore, Hosts-Eintrag) begrenzen. **Keine impliziten Ziel-Reboots, Betriebssystemupdates oder destruktiven Tests**; sie benötigen einen gesonderten ausdrücklichen Auftrag und bei RMM-Ausführung zusätzlich den festen menschlich in der WebUI genehmigten Jobplan. Toolinstallation ist keine allgemeine Zieladministrationsfreigabe.
## WebUI-Genehmigung auch in Linux-Dev
Jeder Ausführungsjob wird zuerst als Antrag **`pending_approval`** gespeichert. Ein berechtigter Mensch sieht in der WebUI feste Ziele, Einzeljobs/Versuche, Inhalte/Hashes, Fristen und Wirkung und genehmigt genau diesen Plan. Vorher **keine** ausführbaren Jobs/Outbox/JobOffers/Startgrants. Keine Dev-Autofreigabe, Testpolicy, direkte API-/DB-Freigabe oder SSH-Ausführung als vermeintlicher RMM-Erfolgsnachweis. Einzige Ausnahme zur tatsächlichen menschlichen Bedienung ist die folgende ausdrücklich erlaubte dev/test-Browsersimulation, keine Code-Abkürzung.
**Userentscheidung 2026-11-12:** „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“. Ausschließlich für diese Entwicklungsabnahme darf Browserautomatisierung im **expliziten dev/test-Profil** tatsächliche UI-Interaktionen einschließlich Plangenehmigung durchführen. Ein deutlich sichtbar als **simulierter Testprincipal** gekennzeichneter Principal bedient dabei dieselbe UI-Grenze; kein Vortäuschen einer tatsächlichen menschlichen Identität. Planbindung, Rechte-, Tenant- und Policyprüfungen bleiben erhalten. Audit muss `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr samt Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar kennzeichnen. Das sind Anforderungen, kein Nachweis bereits implementierter Auditfelder. Simulation getrennt von tatsächlicher menschlicher Genehmigung ausweisen, niemals als Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Normale UI-Browserrequests bleiben an deren interaktiven Kontext gebunden. Produktionsverhalten bleibt unverändert; dort keine Simulation. Details und Useroverride zum ausgelassenen RustDesk: `docs/project-decisions.md`, normativer Vorrang: Spezifikation 1.5 Kapitel 0.1.
Lokale Serverneustarts sind ausdrücklich erlaubt. Dies erlaubt keine impliziten VM-Reboots, Updates oder destruktiven Zieltests und ersetzt keine WebUI-Plangenehmigung; der Zieltestumfang bleibt gesondert ausdrücklich abzustimmen. Diese Dokumentationsänderung führt weder Neustarts noch Simulationen oder Tests aus.
Dies gilt für Hello World, Diagnose, `refresh_inventory` als angeforderten Job, Updates, Reboots, Folgejobs und neue Versuche. Passive Standardinventarisierung/Heartbeats und Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Diese Ausnahme nicht zur Tarnung angeforderter Live-Diagnose nutzen. Solange die UI-Freigabe durch einen berechtigten Menschen oder die eng begrenzte dev/test-Browsersimulation fehlt, bleibt die aktive Teststrecke blockiert; nur unabhängige passive Prüfungen fortführen.
## Nachweisprotokoll (Vorlage, kein Testergebnis)
Pro Feature festhalten: Spezifikations-/Codeversion, reale VM-OS-/Architektur, tatsächlich ausgeführte Befehle (redigiert), Zeit, Erwartung, beobachtetes Ergebnis, relevante Fehler und verbleibende Gates. Für Jobs zusätzlich Antrag/Planhash, WebUI-Genehmigung mit `approval_origin`/`testsimulation` und tatsächlichem oder simuliertem Principal, Versuch, Journal-/Startnachweis und fachliche Nachbedingungen referenzieren, ohne Secrets zu veröffentlichen. Simulationsnachweise sind keine Produktionsfreigaben.
Getrennte Prüfpunkte: Docker-Bindings nur Loopback; SSH-Forward auf VM nur Loopback; DNS-Auflösung auf VM; TLS-Kette und SAN gültig; ungültiges Zertifikat wird verweigert; Enrollment/mTLS; passives Inventar; `pending_approval` ohne ausführbare Artefakte; Ausführung erst nach WebUI-Klick mit eindeutigem tatsächlichem oder simuliertem Ursprung; korrekte Ergebnisse/Redelivery/Tenant-Isolation; Simulation außerhalb dev/test verweigert. **Diese Prüfungen sind hier geplant, nicht ausgeführt.** Destruktive Fehler-/Reboottests nur nach gesonderter Abstimmung durchführen. Fehlender Realnachweis bleibt offen statt grün.
Bekannt bleiben Repository `https://gitea.incoso.eu/kevin_janssen/rust-discovery` (SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`) und RustDesk-Server `rust.ease-technologies.de`. Edition, Ports, öffentlicher RustDesk-Serverschlüssel und Version sind noch unbekannt; fehlende Werte führen zu `not_configured`, nicht zu geratenen Defaults.
## Tatsächlich ausgeführt: minimaler VM-Zugangscheck (2026-11-12)
```sh
python3 -m py_compile deploy/vm_access_check.py
python3 deploy/vm_access_check.py
python3 tests/vm_access_check.py
python3 -m py_compile deploy/vm_access_check.py tests/vm_access_check.py
```
- Lokale Credential-Modi 0700/0600 und `.gitignore`-Ausschluss geprüft. Inhalte wurden
ausschließlich im ausführenden Python-Prozess als Daten geparst, nicht ausgegeben.
- Tatsächlicher SSH-Zugang zur VM mit vorhandenem Benutzer-`known_hosts`-Eintrag und
`StrictHostKeyChecking=yes` erfolgreich. Keine Hostkeys hinzugefügt oder verändert.
Das Hilfsskript ignoriert SSH-Konfiguration und nutzt keinen Agent-Forward.
Passwort-Fallback verwendet bei Bedarf eine temporäre private Datei und Askpass,
nicht Passwortargumente; private SSH-Fehlerausgaben werden nicht veröffentlicht.
- Read-only auf der tatsächlichen VM beobachtet: Linux, Ubuntu 24.04, x86-64,
glibc 2.39; Hostname lesbar und Benutzerhome vorhanden, ohne diese Werte offenzulegen.
Port 18443 war laut `ss` zum Prüfzeitpunkt frei. Das ist keine spätere Portreservierung.
- Fünf lokale Parser-Tests bestanden: literale Passwortdaten, unbekannte/doppelte Felder,
unsichere Dateirechte, ungültiger Port und fehlende Ignore-Regel. Syntaxprüfung bestanden.
- **In diesem ersten Zugangscheck nicht ausgeführt:** Binärkompatibilitätsprüfung gegen das konkrete Agentartefakt,
SSH-Reverse-Tunnel, VM-Deployment, Enrollment, VM-Agent/Heartbeat/Inventar und systemd.
Keine Pakete, Hosts-/Firewall-/sshd-Konfiguration, Updates oder Reboots verändert;
keine RMM-Jobs oder Genehmigungsumgehungen.
- Vorbereitung zunächst an Kontextgrenze angehalten: gebündelte Pflichtdokumentausgabe wurde
abgeschnitten. Vor weiterem Agentbootstrap vollständige Spezifikation und die konkreten
Deployment-/Agent-Schnittstellen mit zusätzlichem Lesebudget prüfen. Der erfolgreiche
Zugangscheck ist ausdrücklich kein Linux-M1-/Feature-Abnahmenachweis.
## Tatsächlich ausgeführt: passiver VM-Agent über Reverse-Tunnel (2026-11-12)
Nach ergänzter vollständiger Pflichtlektüre wurde folgende Strecke tatsächlich ausgeführt:
```sh
python3 -m py_compile deploy/vm_passive_test.py
python3 deploy/vm_passive_test.py
python3 tests/vm_access_check.py
python3 tests/vm_passive_test.py
python3 -m py_compile deploy/vm_access_check.py deploy/vm_passive_test.py tests/vm_access_check.py tests/vm_passive_test.py
python3 deploy/vm_access_check.py
```
`deploy/vm_passive_test.py` ist ein bewusst ausführender, begrenzter VM-Test und kein
reiner Zugangscheck. Er liest Credentials nur intern, prüft vorhandene Langläufer und
Portbelegung, erzeugt genau ein Enrollment-Token für Dev-Mandant A und hinterlässt
eine neue Geräteidentität samt Historie. Kein DB-/PKI-Reset und kein Token-/Key-Echo.
**Beobachtete Ergebnisse:**
- Kein vorhandener PC-Reverse-Tunnel, kein VM-Agentprozess, kein VM-Listener auf 18443
und kein früheres benutzerlokales Testverzeichnis vorgefunden. Nichts Fremdes gestoppt.
- Tatsächlich laufender Docker-Server ausschließlich `127.0.0.1:18443`; PostgreSQL
ohne veröffentlichten Port. Lokaler Healthcheck mit vertrauenswürdiger CA bestanden.
- Agentartefakt aus dem bereits laufenden Docker-Server kopiert, kein neuer Imagebuild:
Linux-x86-64-ELF, höchste referenzierte glibc-Version 2.34; VM hat glibc 2.39.
Alle ELF-`NEEDED`-Bibliotheken im VM-Laufzeitcache gefunden. Vor nativem Agentstart
VM-Loader `/lib64/ld-linux-x86-64.so.2 --list` gegen das konkrete Artefakt erfolgreich.
SHA-256: `667065dded71cc499b171bc799ad09f3ac7f049a72a9d54f4c943331a565eefe`.
- PC initiierte SSH mit `-N -T`, `StrictHostKeyChecking=yes`,
`ExitOnForwardFailure=yes`, Keepalive 30/3 und
`-R 127.0.0.1:18443:127.0.0.1:18443`. VM-seitig per `ss` genau dieser
IPv4-Loopbacklistener bestätigt. Keine Hostkey-/sshd-/Firewalländerung.
- Nur Binary, öffentliche CA und einmaliges Token per SSH-stdin in ein neues privates
Benutzer-Testverzeichnis übertragen. Geräteschlüssel auf der VM erzeugt; kein CA-/Server-
Privatschlüssel oder Viewer-Bearer übertragen. Kein Root-/systemd-/Paketbootstrap.
- Native VM-Agentstrecke mit `RMM_CONNECT_ADDR=127.0.0.1:18443`, eigenem privaten Zustand
und CA gestartet. Der vorhandene Override verändert nur TCP; Enrollment und WSS
prüfen weiterhin TLS-SNI/DNS-Namen `rmm-dev.internal`. Kein Hosts-Eintrag nötig,
keine Zertifikatsprüfung deaktiviert; keine Rust-/Protokolländerung erforderlich.
- Über echte tenantgebundene Lese-API exakt diese neue Agent-ID zugeordnet:
Inventar-Erhebungszeit **16:40:12.632 UTC**, Empfang **16:40:12.796518 UTC**;
Hostname intern mit SSH-Baseline verglichen, ohne ihn zu veröffentlichen.
OS Ubuntu 24.04, x86-64, tatsächlich verfügbare Root-Bytes und Inodes positiv,
Scope `linux.base`, Vollständigkeit `partial`, fachliche Gesundheit `unknown`.
- Zwei verschiedene frische Heartbeats serverseitig beobachtet:
**16:40:44.849118 UTC** und **16:41:12.779675 UTC**; Präsenz `online`.
Der Gateway-Code aktualisiert `last_contact_at` ausschließlich im Heartbeat-Zweig.
Leser von Dev-Mandant B sah diese Agent-ID nicht.
- Enrollment-Tokenkopie auf der VM entfernt. Test-Agent-PID **4141792** per SIGTERM
gestoppt, vorher exakten `/proc/PID/exe`-Pfad geprüft; anschließend Prozessende geprüft.
Nur den eigenen SSH-Tunnel-PID **1869118** beendet und auf Prozessende gewartet.
Geschütztes lokales Nachweisprotokoll mit PIDs, Zeitpunkten und privatem Remotepfad:
`devstate/vm-passive/result.json`. Kein aktiver verwalteter Testrecord zurückgeblieben.
Privates VM-Testverzeichnis mit Geräteidentität und Log bleibt für kontrollierte
Fortsetzung erhalten, keine laufende Installation. Secrets/Logs daraus nicht veröffentlichen.
- Fünf Parser-Tests erneut bestanden; drei lokale Orchestrierungs-Guardtests bestanden
(Fail-closed, private Fehlerausgaben unterdrücken, Remote-Code nur über stdin).
Python-Syntaxprüfung bestanden. Abschließender tatsächlicher lesender VM-SSH-Check
nach dem Test erfolgreich; VM-Port 18443 wieder frei.
Keine Rust-Änderungen, daher Rust-Build/Clippy und übrige Integrationstests hier nicht erneut ausgeführt.
**Verbleibend:** Kein systemd-/Dienst-/Installer-Nachweis, keine Rotation, Ablauf-Recovery,
Long Polling, Reconnect-/Widerrufsabnahme auf VM, Proxy-/Klon-/Restore-/Lastabnahme.
Keine Jobs, WebUI-Freigaben, Updates oder Reboots ausgeführt. Der passive VM-Erstnachweis
ist erfolgreich, **M1 insgesamt und Linux-MVP bleiben unabgenommen**.
+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.
+931
View File
@@ -0,0 +1,931 @@
# Tatsächlicher Implementierungsstand
## ENTWICKLUNG PAUSIERT auf Useranweisung — Übergabe 2026-11-12
Kompakter Einstieg, bekannte ungeprüfte Snapshotfehler und Fortsetzungsgates:
[handover.md](handover.md). Die nachfolgenden Worker-Nachweise bleiben erhalten.
User hat aktuelle Entwicklung unterbrochen und Push/Übergabe angefordert.
**Keine weiteren Implementierungen, Builds, Tests, Deployments, Anträge oder
Folgejobs starten.** Git-Commit/Push übernimmt der zuständige Orchestratorworker;
dieser VM-Worker hat weder Commit noch Push ausgeführt.
### Unmittelbar vor Pause tatsächlich abgeschlossen
- Neuer `deploy/vm_runtime_upgrade.py`: versionierter Bookworm-Agent-/Helperbuild,
strikter Vergleich mit eigenen alten Deploymenthashes, Root-private atomare
Backups, Loaderprüfung vor Binärwechsel, erhaltene Identitäten/SQLite-Journale,
neue getrennte Helperkonfigurationen/Public-Pins und dedizierter APT-Probeaufruf.
- Tatsächlicher neuer Docker-Releasebuild beider Binaries erfolgreich. Build-ID
**68741ab0b1c84e15bf3fc442bd812558**, Kontext 1.433 MB; beide ELF x86-64,
maximal glibc **2.34**, OpenSSL **3**, konkrete VM-Loaderauflösung bestanden.
Agent SHA256 `46821cc7544019830507ffaa0c5385f88f7b645a5a1d1c8a54aa56ebbd8e8f20`;
Helper `f867ac51e82fc7d0f0050cb7629e1ff92d8af9b493d6cb8ae4839accb5694e30`.
Source-/Artefaktmanifest und getrennte, nur vom Sourceowner berichtete
115/56/2-Testreferenz unter `devstate/vm-final/<Build-ID>/build.json`.
Diese 115 Rust-/56 APT-/2 Installertests wurden hier **nicht erneut ausgeführt**.
- Tatsächlicher kontrollierter VM-Upgrade erfolgreich, Stage
`installed_not_started`. Vor/nach Installation Agent- und Helperstate inklusive
Dateibytes/SQLite-Schema/Rows identisch, keine Reenrollment-/Journal-/PKI-Resets.
Vorhandene alte Binärdateien/Units und nachweislich unbenutzte alte Provider-
Code-/Storedirectories bleiben Root-privat erhalten unter
`/var/lib/rmm-bootstrap-history/<Build-ID>/report.json` samt zugehörigen Backups.
- Neue Rootkonfigurationen `/etc/rmm/helper-general-v2.json`, `apt-helper.json`,
Public-Pins `general-helper-proof-v2.json`, `apt-helper-proof-v2.json` (Root,
Gruppe984 lesbar 0640), Agent-Drop-ins `20-runtime-v2.conf` und
`21-log-units-v2.conf`, private Logunit-Allowlist. Schlüssel/Journale nicht ersetzt.
Generalhelper bleibt ohne SYS_ADMIN/MKNOD, Rootscripts/Reboot bleiben false.
Nur genau ein vorerzeugter leerer Root-0600-Inode
`/etc/systemd/system/rmm-mvp-test.service` ist als späteres UI-Schreibziel
freigegeben, **keine gültige Business-Testunit eingerichtet/gestartet**.
Kein pauschales ReadWritePaths=/etc. Ausschließlich adjtimex-Read-Ausnahme
zusätzlich zum weiter beschränkten Generalprofil, keine SYS_TIME-Capability.
- Tatsächliche administrative Fixturevorbereitung über festes
`provision-fixture-store` erfolgreich: bekannte versiegelte Fixturearchive und
Root-private Baseline-/Prefetchmetadaten, **keine Paketinstallation**.
### Konkreter offener Native-Probe-Fehler / sicherer Endzustand
Dedizierte tatsächliche `rmm-apt-helper.service`-Probe wurde gestartet und scheiterte
**vor** Native-Readiness-Publikation mit statischem Sourcefehler
**APT_CONTROLLER_PROFILE_REQUIRED**. Systemctl-Start Exit **1**,
Result=exit-code; im Fehlerzeitpunkt SubState=auto-restart. Root-private Diagnose
enthält Exceptionklasse RuntimeError und generierte Zeilen 183/6; keine privaten
Exceptioninhalte/Logs veröffentlicht. Keine Probedateien, keine
native-readiness.json und keine Native-Acceptance-/Job-/Grantbelege erzeugt.
RootGate/SDK-/Providercode wurde **nicht** zur Umgehung gepatcht. Fehlerursache
innerhalb des tatsächlichen Controllerprofils ist noch nicht weiter eingegrenzt;
kein erneuter Probeversuch nach Userpause.
Unmittelbare, ausschließlich lesende Pauseprüfung bestätigt:
- `rmm-agent.service`: **inactive**
- `rmm-helper-dev-test.service`: **inactive**
- `rmm-apt-helper.service`: **inactive**, kontrolliert nach nachgewiesen leerem
Rootverbrauch gestoppt; kein aktiver automatischer Neustart mehr
- **kein VM-18443-Reverselistener**, kein von diesem Lauf gestarteter PC-Tunnel
- Rootledger **0 Verbräuche / 0 ungeklärte Verbräuche**
- Serverseitig für die erhaltene VM ausschließlich **1 succeeded** (historischer
früherer Hello-World-Job), **keine neuen RMM-Jobs/Genehmigungen/Anträge**
- Lokaler Projekt-Docker **server running**, ausschließlich
**127.0.0.1:18443**, **postgres running** ohne publizierten Datenbankport;
für User bewusst unverändert laufengelassen
- Kein laufender Installer-/Paket-/Rebootauftrag dieses Workers. Letzter Build-
Hintergrundprozess war bereits erfolgreich beendet, kein Build zu stoppen.
Geschützte Übergabeevidenz: `devstate/vm-final/<Build-ID>/{build,install,probe-diagnostic}.json`,
auf VM `/etc/rmm/runtime-v2-probe-report.json` und oben genannter Root-Backupreport.
Da die Probe fehlschlug, wurde lokal **kein erfolgreicher probe.json** erzeugt.
Keine Backup-/Journal-/Identitydateien entfernen oder die create-only Phasen
blind erneut aufrufen. Installierte neue Laufzeit bleibt absichtlich gestoppt.
### Quelländerungen und noch ungeprüfte Arbeit
- Neues Upgradehelper-Skript wie oben; Änderungen an
`deploy/vm_mvp_adapters.py`, `deploy/vm_mvp_acceptance.py`,
`deploy/vm_mvp_runtime.py`, `tests/browser/mvp-actions.spec.ts` und
`tests/vm_mvp_guards.py` für gewünschte **1.1** im normalen Ensure-Job,
UPDATE-Rezept/fresh-baseline/Noopflags und begrenztes vorerzeugtes Unit-Inodeziel.
Keine Änderungen an gemeinsamen Client-/Helper-/Backend-/Domain-/APTtool-Sources.
- **28 MVP-Guardtests und Syntaxprüfung waren vor der letzten Änderung der
SERVICE_SETUP-Bytes erfolgreich.** Danach wurde das Setupskript an den leeren
vorerzeugten Inode angepasst; dabei sind die hart gepinnten bisherigen
Script-SHA-Konstanten in Browser/Guardtests **noch nicht nachgezogen/geprüft**.
Dieser bewusst offene Arbeitsstand muss bei Wiederaufnahme zuerst konsistent
gemacht werden. Nicht als aktuell vollständig grüne Testsuite ausgeben.
- Keine weiteren Tests oder Format-/Buildprüfungen nach Pause ausgeführt.
Kein neues UI-/MCP-Ausführungsergebnis, kein Paket-/Diensttest-/Update-/Reboot-
Nachweis. Rootscope auf Server wurde von diesem Worker nicht aktiviert,
kein lokaler Serverrestart und keine Rollen-/Freigabe-DB-Manipulation.
- Zuerst tatsächliches dediziertes Controllerprofil gegen
`verify_controller_profile()` diagnostizieren; Härtung nicht blind lockern.
Danach neue Peer-/Sync-/Passive-planning-Nachweise und erst dann einzeln
WebUI-genehmigte Jobs. Aktueller Stand ist **keine Linux-MVP-Abnahme**.
## Neuester Adapterstand: 15 Fälle nach aktuellem Backend-/APT-/Sync-Vertrag
Die vorher unten als `pending_protocol` bezeichneten neun Fälle sind **nicht mehr
pauschal wegen unbekannter Routen gesperrt**. Aktuelle Verträge aus
`proto/BACKEND_CONTRACT.md`, `deploy/linux/apt-helper-README.md`,
`tools/apt-transaction/HELPER-CONTRACT.md`, `tests/agent_sync/README.md` und
`tests/agent_transport/README.md` wurden herangezogen. **Kein VM-Nativlauf wurde
in diesem Adapterincrement gestartet; das aktuelle Client-Wire-up-Verdikt fehlt.**
### Executorabdeckung (Code vorhanden, nicht nativ abgenommen)
| Case | Executorstatus / konkretes Laufzeitgate |
| --- | --- |
| `hello` | ready_adapter; echter frischer nichtprivilegierter Agent, aktueller Sync |
| `refresh_inventory` | ready_adapter; linux.base und neue gebundene Erhebungszeit |
| `query_logs` | ready_adapter; exakte Testunit-Allowlist, fünf Minuten/50 Zeilen/64 KiB |
| `service_setup` | ready_adapter; festes UI-Rootskript, echte Rootpolicy und geprüfte Schreibpfade erforderlich |
| `service_start` | ready_adapter; ausschließlich rmm-mvp-test.service, tatsächlicher Helperpolicy-/Syncnachweis |
| `service_stop` | ready_adapter; dieselbe Unit, feste Reihenfolge setup/start/stop |
| `apt_native_install` | ready_adapter; schema-2-Manifest, passiver/genehmigter Planungsdatensatz, Rootprobe, versiegeltes Archiv 1.0 |
| `apt_native_update` | ready_adapter; entsprechendes 1.0→1.1-Manifest und echte aktuelle 1.0-Baseline |
| `ensure_package` | ready_adapter; vollständiges apt-execute-Manifest und echter install-Rezept-Acceptancebeleg |
| `apply_updates` | ready_adapter; festes Testpaket, reboot_policy=never, echtes Upgrade-Rezept und Acceptance |
| `duplicate_offer` | unsupported_native_fault_injection; separater ausführbarer Originalresult-Replay-Regressionsdriver vorhanden |
| `lost_result_ack` | unsupported_native_fault_injection; derselbe Driver, kein behaupteter ACK-Verlusttest |
| `cancel_queued` | ready_adapter; eigener Agent vorher inaktiv, feste future-start Hello-Bytes, UI-Antrag, MCP-Cancel, null Grants |
| `expired_offline` | ready_adapter; eigener Agent offline, feste 60-s-Frist, Wiederanmeldung erst danach, expired und null Grants |
| `reboot_last` | ready_adapter; eigener Lifecycle, tatsächliche Root-Rebootpolicy, Checkpoint vor UI-Klick, neue Boot-ID/Inventar/Sync/Result |
Neue Module `deploy/vm_mvp_adapters.py` und `deploy/vm_mvp_runtime.py` enthalten
die tatsächlichen Executorpfade, nicht nur einen Statuskatalog. Core, separater
Browserrunner/-test und Guards sind angepasst. Keine Änderungen an gemeinsamen
Agent-/Helper-/Backend-/Domain-/APTtool-/WebUI-Quelldateien.
### Plan-/Freigabe- und Lifecyclegrenzen
- Nonroot-Fälle planen/beantragen über echten MCP 2025-11-25. Rootfälle verwenden
**echte UI-Planerstellung und UI-Submit durch den simulierten Testhuman**, weil
der Default-Automatisierungstoken bewusst kein root:execute besitzt. Keine
Membership-/Scope-DB-Änderung, kein geborgter Cookie und kein direkter
Freigabe-API-Aufruf. Erste Browserphase verlässt den Antrag pending_approval
ohne Genehmigungsrequest; MCP liest denselben gespeicherten Antrag nach.
- Danach werden null Jobs/Outbox/Grants verifiziert und IDs/Versuch/Planhash privat
gespeichert. Beim Reboot zusätzlich native alte Boot-ID; ein Bootwechsel noch
vor Genehmigung sperrt den Klick. Erst die zweite Browserphase prüft sämtliche
exakten angezeigten Plan-/Skript-/Manifestbytes und klickt Checkbox/Button.
Audit bleibt explizit dev_test_browser_simulation/Testprincipal, kein Mensch-
oder Produktionsnachweis. Browser-Zeitzone ist für die UI-Minutenfelder UTC;
die tatsächlich erzeugten gespeicherten Bytes werden erneut vollständig geprüft.
- Rootpolicy kommt aus frischem UID993-IPC mit Root-SO_PEERCRED, Root-eigenem
unabhängig provisioniertem Public-Pin, Nonce, Identität/Generationen, aktuellem
authentisiertem Signingkey und exaktem Policydigest. APT verwendet ausschließlich
den dedizierten Socket/Stackpin. Beide Profile müssen dieselben Ledger-/Lock-
Geräte und Inodes melden. Ein Capabilitystring oder Benutzerartefakt genügt nie.
- Technischer Runtimeadapter übernimmt nur inaktiven Agent/Tunnel oder bricht ab;
verifiziert installierte aktuelle Buildhashes, erhaltene Identität, UID, tatsächliche
Prozess-UID, NoNewPrivileges und keine effektiven/ambienten Agentcapabilities.
Er erzeugt nur eigenen versionierten Transport-Drop-in und eigenen Loopback-
Tunnel mit StrictHostKeyChecking/Keepalive. Roothelperstarts nur für zwei feste
eigene Unitnamen mit unabhängig gelieferten tatsächlichen Unithashes. Bereits
aktive fremde Helper werden nicht als eigene Cleanupziele übernommen.
- Neuer Hello/Transport muss eine höhere Verbindungsgeneration und realen
serverseitigen Sync-/Restorezustand plus frischen Kontakt ergeben. Eigene
Prozesse werden nur bei terminalen Serverjobs und ohne unklare Helperverbräuche
gestoppt; private Journale/Identitäten werden nie gelöscht oder umgeschrieben.
Reboot aktiviert bei Bedarf nur die eigene bestehende Agentunit als technischen
Startbootstrap und stellt den früheren Enablezustand nach terminalem Ergebnis
wieder her. Kein SSH-Reboot, Paketresolver oder Service-Geschäftseffekt.
- Rebootdriver wartet begrenzt auf strikt authentisierten SSH-Wiederkontakt und
echte neue /proc-Boot-ID, setzt nur seinen eigenen PC-Tunnel neu auf und verlangt
autogestarteten nichtprivilegierten Agenten, neues Inventar, Server-/Helper-Sync
und den gebundenen endgültigen Job. Exitcode 0 ist kein Rebootnachweis.
- Zusätzliche ausgearbeitete Lifecycleoptionen: `--transport wss|https`, optional
`--exercise-server-restart` (bestehendes Compose-Profil unverändert, kein OIDC-
oder Datenreset) und `--exercise-native-renewal`. Letzterer beobachtet nur echte
native Rotation, exportiert keine privaten Schlüssel und erzwingt keine neue
CSR über einen Ersatz-PC-Client. Fehlt ein nativer Fälligkeits-/Triggerpfad,
endet er not_configured statt Rotation zu behaupten. Für den verlangten API-
Fingerprintnachweis fehlt aktuell außerdem `certificate_sha256` im Geräte-DTO;
das ist ein präzises Metadatengate, keine unbekannte Renewroute.
### Replay ist nicht erfundene Fault-Injection
Der Driver liest auf der VM ausschließlich das tatsächlich archivierte originale
`reconcile_results.envelope` des **gleichen** abgeschlossenen Hello-Jobs/Versuchs.
Agent/Job/Versuch/terminales Result werden aus Protobuf geprüft. Er verwendet den
nativen aktuellen Zertifikatselector und Geräteschlüssel ausschließlich auf VM,
normale CA-/DNS-Verifikation und zweimal denselben originalen MessageBatch an
`POST /agent/v1/messages`. Message-ID/Boot/Sequenz/Zeit/Output bleiben unverändert.
Danach müssen lokaler Verbrauch, serverseitiger Job/Grant, Ergebnis und genau
ein konkreter Receipt unverändert sein. Kein neues Offer, neuer Job/Versuch,
neuer Grant, umverpacktes Ergebnis oder Journal-/Safetyreset.
Gezieltes Offerduplizieren und echtes ACK-Unterdrücken haben keinen öffentlichen
Native-Testhook. Deshalb bleiben die zwei Fault-Resultfelder ausdrücklich
`unsupported_native_fault_injection` und `native_fault_test_passed=false`, auch
wenn der separate Replay-Regressionsdriver später erfolgreich läuft. Dieser
Driver wurde hier **nicht gegen die VM ausgeführt** und nicht als Nativepass markiert.
### Konkrete APT-Collectorübergabe – derzeit wirklich fehlend
Die echte read-only MCP-Antwort enthält weiterhin **keine** gespeicherte
`linux.apt.planning`-Observation. Der Planbuilder fällt nicht auf SSH-Live-
Paketinventur/Resolver, manuelles Baseline-/Acceptance-Schreiben oder Capability-
Overrides zurück. Die bestehende additive Inventory-JSON-Route genügt; benötigt
wird eine reale erlaubte passive Standarderhebung oder ein eigener UI-genehmigter
Read-Diagnoseauftrag mit folgendem Mapping:
```text
scope/source_id: linux.apt.planning
quality: valid; completeness: complete; truncated: false
observed_at: tatsächlicher RFC3339-Zeitpunkt (für Ausführung <90 s)
data:
fixture_package: tatsächliche Projektion baseline["rmm-mvp-test:all"] oder null
baseline_sha256, sealed_baseline_sha256
status_fingerprint, dpkg_updates_empty, pending_triggers_empty
runtime, runtime_sha256
provider_sha256, hook_sha256, apt_config_sha256
prefetch: {<echter Archivhash>: {schema_version:1,sha256,size,sealed_at_ms}}
```
Ableitung exakt nach Toolvertrag, keine erfundenen Zeitpunkte/Hashes:
1. `installed_snapshot()` liest dpkg-query Package/Architecture/Version/Status,
prüft Eindeutigkeit und konsistente Statuswerte. Baselinehash = SHA256 der
kanonischen ASCII-JSONbytes (`sort_keys`, kompakt, **ohne LF**). Die gesamte
Baseline muss nicht in die 32-KiB-Observation: Fixtureprojektion plus Hash reichen;
ein optional mitgeliefertes Vollobjekt wird zusätzlich gehasht/geprüft.
2. `sealed_baseline_sha256` bestätigt eine tatsächlich bereits erzeugte,
Root-private unveränderliche Baseline mit genau diesem Inhalt. Nicht durch
Kopieren des behaupteten Hashs als Proof erzeugen; Helper prüft Datei/Hash vor Effekt.
3. `status_fingerprint()` hasht kanonische Pfad→SHA256/null-Records für
/var/lib/dpkg/status, arch, /var/lib/apt/extended_states und sortierte Trigger
außer Lock. Dpkg-updates muss leer und triggers/Unincorp leer sein. Optional
Records können mitgeliefert und erneut gehasht werden.
4. Runtimehash = SHA256 des echten kanonischen `inspect-runtime`-Objekts ohne LF;
Code-/Hookhash über tatsächliche installierte Bytes, Confighash über exaktes
print-config. Root-readiness-IPC/Rootprovisionierung und beide Ledgerinodes
werden unabhängig geprüft; Runtime-/Codepins stimmen mit administrativ
gelesener bestehender Rootkonfiguration überein, nicht nur mit Agentbehauptungen.
5. Prefetchfelder stammen aus echten Root-sealed Receipts vor der finalen Grant-
not_before-Zeit. Archive sind ausschließlich die zwei gepinnten bekannten
Fixturebytes. Kein Native-Acceptance-Record vor dem tatsächlichen UI-genehmigten
Paketjob. Der Suitecode ruft `prepare-baseline`/`provision-fixture-store` niemals
über SSH auf: letzteres kombiniert im aktuellen Tool Vorbereiten und aktive
Baselineerhebung und wäre kein verdeckter lesender Planungsersatz.
**Zusätzlicher tatsächlicher Fixture-Sequenzkonflikt:** Nach Nativeacceptance 1.0
ist 1.0 bereits installiert, das bestehende install-Rezept erlaubt jedoch nur
old_version=null. Nach Nativeacceptance des Upgrades ist bereits 1.1 installiert,
während apply_updates exakt old_version=1.0 verlangt. Die normalen Adapter
verweigern solche falschen Baselines ausdrücklich. Ohne zusätzlich genehmigten
Reset-/Removalpfad oder überprüften neuen Idempotenzvertrag kann nicht ehrlich
alle vier Hosttransaktionen nacheinander als neu ausgeführt abgenommen werden.
Keine heimliche Entfernung/Downgrade und keine gefälschte Abwesenheitsbaseline.
### Benutzerfreigabe getrennt von Readiness
Tatsächlich lokal erzeugt, aus der bereits gegebenen Chatfreigabe (2026-11-12):
`devstate/mvp-acceptance-optins/chat-user-20261112.json`, Verzeichnis 0700, Datei
0600, gitignored. Enthält feste Ziel-IDs, gewählte Cases, simulationskennzeichnung,
Chat-Herkunft/Datum und kurze Gültigkeit. **Kein** wiring_verified/ready/capability-
Flag und keine neue Autorisierung im Produkt. Erneute manuelle Abschrift der
gleichen Userentscheidung ist nicht nötig; tatsächliche WebUI-Plangenehmigung
bleibt für jeden Job erforderlich.
Ein getrenntes tatsächliches Wireworker-Verdikt ist vor Nativebootstrap Pflicht:
feste agent_id, tatsächliche aktuelle `agent_sha256`, `helper_sha256`, optional
`helper_units:{fester Unitname: tatsächlicher Unithash}`, `general_pin_file` und
`apt_pin_file` für unabhängig Root-provisionierte Public-Pins. Die Suite hat
**kein solches Verdikt gefälscht oder automatisch erzeugt**. Die Hashangaben
werden vor Ort nochmals gegen echte Installation, Peer, Pin, Unit und Sync geprüft.
### Tatsächlich ausgeführte Verifikation dieses Adapterincrements
- Python-Syntaxprüfung der fünf betroffenen Pythondateien bestanden.
- Abschließend **27 neue/erweiterte MVP-Guardtests** und **15 bestehende VM-Guardtests**
bestanden, einschließlich echter generierter Replay-/Inspect-Syntax, Root-UI-
Prepare-vor-Approval-Reihenfolge und getrennte-Ledger-Inode-Verweigerung.
- TypeScript-Typecheck bestanden; neun lokale API/UI-Tests bestanden.
- Browserdiscovery der getrennten Root-Prepare-/Approvaltests erfolgreich;
**kein Browserlauf**. Kein neuer Rustbuild/-test oder fremder Worker-Testpass behauptet.
- Echte read-only MCP-/Backendstrecke erfolgreich; erhaltene VM sichtbar,
nichttrunkierte Liste, **unreachable**, weiterhin nur alte Basis-/Hello-/Inventory-
Capabilities. Kein frischer Root-/APT-/Sync-/Transport-/Rotationsnachweis.
Tatsächlich bestätigt: linux.apt.planning fehlt und das Geräte-API liefert
noch kein certificate_sha256. Benutzerartefakt abschließend auf 0700/0600,
15 Cases und Abwesenheit sämtlicher Readiness-/Acceptanceflags geprüft.
- **0 neue RMM-Anträge/Pläne/Genehmigungen/Jobs, 0 SSH-/VM-/Rootänderungen,
0 Dienst-/Tunnelstarts, 0 Serverrestarts, 0 Pakete/Updates/Reboots** in diesem Lauf.
Tatsächlich ausgeführtes Defaultkommando: `python3 deploy/vm_mvp_acceptance.py`.
Geplante, **nicht ausgeführte** Fortsetzung erst nach aktuellem realem Wireverdict:
```sh
python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \
--user-artifact devstate/mvp-acceptance-optins/chat-user-20261112.json \
--wire-verdict devstate/vm-wire/current.json --transport https \
--case hello --case duplicate_offer --case lost_result_ack
```
Die Freigabedatei muss noch gültig sein (bei Bedarf create-only neu aus derselben
Chatfreigabe mit `--create-chat-user-artifact` erzeugen). Reboot nur letzter Case,
eigene Lifecyclekontrolle und tatsächlich aktivierte eng begrenzte Rootpolicy;
die aktuell falsche allow_reboot/allow_root_scripts-Policy wird nicht von der
Suite geändert. Root-Testunit braucht echten erlaubten ReadWritePaths-Pfad,
sonst not_configured; niemals stille SSH-Geschäftsmutation. **Kein Linux-MVP-Abschluss.**
## Neueste Vorbereitung: modulare VM-MVP-Abnahmesuite, noch keine neue Ausführung
Diese Ergänzung ist **Testvorbereitung während des parallelen Agent-/Helper-/Sync-
Wire-ups**, kein weiterer VM-Feature- oder MVP-Erfolgsnachweis. Bestehende positive
Hello-World-/Root-Readiness-Nachweise unten bleiben getrennte frühere Läufe.
### Geliefert und Sicherheitsgrenzen
- Neu: `deploy/vm_mvp_acceptance.py`, `tests/vm_mvp_guards.py`,
`deploy/browser/run_mvp_actions.py`, `tests/browser/mvp-actions.spec.ts`.
Keine Änderungen an WebUI-/Agent-/Helper-/Domain-/Server-/APTtool-Quellen,
keine Rootkonfigurations-/Policyerweiterung und kein Build/Serverrestart.
- Defaultkommando ist ausschließlich lesend. Echter rmcp-Streamable-HTTP-Client,
Protokoll 2025-11-25 mit initialize/initialized/Session-ID; liest
`tenants.list`, `inventory.list_devices`, `inventory.get_device`,
`monitoring.get_health`, tatsächlichen Dev-Loginmodus und gespeicherte Jobzustände.
Die erhaltene konkrete Linux-VM ist fest gebunden, nicht durch Konfiguration
auf beliebige andere Geräte erweiterbar. Trunkierte Gerätelisten ersetzen
niemals den authentisierten Einzelgeräteabgleich.
- Ausführung verlangt ausdrücklich `--run-realtime-dev-ui-acceptance`, ausgewählte
feste Cases und ein vorhandenes Benutzerartefakt (Eigentümer aktuell, regulär,
kein Symlink, 0600, höchstens 1 MiB, keine doppelten JSONfelder). Artefakt enthält
exakt `profile`, `tenant_id`, `asset_id`, `agent_id`, `approved_cases`,
`expires_at`, `wiring_verified`, `expected_principal`. Profil dev/test, gleiche
erhaltene Gerätebindung, explizite Cases, Ablauf höchstens eine Stunde und
`simulated-testprincipal-a` sind zwingend. Dieses lokale Opt-in ist **keine
Jobgenehmigung und kein Sync-/Capabilitybeweis**. Es wird nicht automatisch
erzeugt oder auf wahr gesetzt; echte Worker-Wiringnachweise müssen zuerst vorliegen.
- Unveränderliche TLS-Origin `https://rmm-dev.internal:18443`, TCP nur
`127.0.0.1:18443`, vorhandene öffentliche Dev-CA; kein alternativer Hostname,
Credential-in-URL, Proxy-/Redirect-/Invalid-Cert-Bypass. UID0 als Netzwerkagent
wird abgewiesen. Für Jobs werden frischer tatsächlicher Kontakt unter 90 s,
ausgehandelte Aktion plus `rmm.sync.v1` und bei Root zusätzlich `helper.root.v1`,
`root:<action>` und exakter Helperpolicydigest verlangt. Serverseitiger Sync-/
Policy-/Grantgate bleibt unabhängig bestehen; kein Capability-DB-Override.
- Vor jedem Case blockieren queued/accepted/running/verifying/unknown/
awaiting_reboot im bestehenden VM-Ledger. Nichts wird zurückgesetzt, gelöscht,
über SSH repariert oder als neuer Versuch automatisch wiederholt. Ein fehlender
Ergebnisnachweis/Timeout bleibt Fehler mit erhaltenem privaten Checkpoint;
Suite stoppt, statt Folgecases/Retry auszulösen. Sie übernimmt keine fremden
Tunnel-/Dienst-PIDs und startet/stoppt keinen technischen VM-Prozess.
### Vorbereitete Caseabdeckung und ausdrücklich offene Adapter
**Sechs ausführbar implementierte, hier nicht ausgeführte Caseadapter:**
1. `hello`: unveränderte exakte POSIX-Shellbytes, stdout mit LF und Exitcode 0.
2. `refresh_inventory`: linux.base, echter Ergebnis-Erhebungszeitpunkt mindestens
so neu wie der im genehmigten Job gebundene Startzeitpunkt.
3. `query_logs`: ausschließlich `rmm-mvp-test.service`, feste fünf Minuten,
höchstens 50 Zeilen/65536 Outputbytes; gültige Qualität statt erfundenem Erfolg.
4. `service_setup`: nur ein fest eingebautes, vollständig UI-genehmigtes
Rootskript für create-only Testunit, `/usr/bin/sleep infinity` unter
`rmm-agent`, keine Paketinstallation, kein Enable/Start. Geladene Unit wird
im gebundenen Skript nachgeprüft, erwartete stdout exakt festgelegt.
Browser bindet die Skriptbytes zusätzlich an SHA256
`159ff240504b8a350b46a56fdf9cd50e5768816de7e6683829f05144978449f0`.
Aktuelle Rootscriptpolicy/Writesandbox wird dadurch nicht eingeschaltet.
5./6. `service_start`/`service_stop`: typisierte Rootaktion ausschließlich für
diese Unit, 180 s; nur als ausdrücklich genehmigte Reihenfolge
setup → start → stop auswählbar. Kein beliebiger Dienstname/Restart.
Für jeden Case: eigener MCP-Plan/Submit, gespeicherte Planbytes/SHA256 und genau
ein festes Ziel, vor UI-Genehmigung je reserviertem Job **0 Jobs/Outbox/Grants**,
Antrag pending_approval und keine Executionaggregation. Danach ausschließlich
geschütztes Casefile an Browserrunner; echtes normales TLS-Login, sichtbare
Simulation und tatsächliche Sessionfelder/Principal geprüft, vollständiger
angezeigter Plan/Job/Hash/Bytes/Fristen/Identität geprüft, Checkbox und sichtbarer
Genehmigungsbutton geklickt. Keine direkte API-/SQL-Genehmigung. Anschließend
bestätigtes Ergebnis plus Nachbedingungen, genau 1/1/1 und tatsächliches Audit
mit Principal, Planhash, approval_origin und testsimulation. Keine Log-/Script-
Outputinhalte in öffentlichen Testergebnissen; keine Screenshots/HAR/Traces.
**Neun ausdrücklich `pending_protocol` und nicht ausführbare Cases:**
`apt_native_install`, `apt_native_update`, `ensure_package`, `apply_updates`,
`duplicate_offer`, `lost_result_ack`, `cancel_queued`, `expired_offline`,
`reboot_last`. Ihre Auswahl wird vor Plan/Submit verweigert, auch bei einem
lokalen Opt-in-Artefakt. Sie sind weder übersprungene bestandene Tests noch
pauschal durch neue Jobs ersetzte Replaynachweise.
- APT: reiner strikter Formatvalidator für vollständiges Helper-schema-2-Manifest,
Originaltransactionbytes/Hash/typed object, alle Runtime-/Provider-/Hook-/Config-
und Baselinepins, exakt ein rmm-mvp-test-Archiv 1.0/1.1, Herkunft/Größe/Pfad und
no_reboot. Das sind nur Fixture-/Parsertests, **keine aktuelle Baseline oder
Native-Acceptance**. Ausführungsadapter wartet auf echten UI-genehmigten
Planungs-/Preseal-Diagnosebeleg oder genehmigte passive Planungsdaten; kein
SSH-Live-Resolve, kein manuelles Schreiben von Baselines/Acceptance-Markern.
- Replay/ACK: kontrollierter same-job/same-attempt Zustell-/ACK-Fault-Adapter fehlt.
Keinen zweiten Job als vermeintlich erfolgreiche Redelivery ausführen.
- Cancel/offline/Fristen: kontrollierter nachgewiesener Nichtstart-/Offline-Sync-
Fence fehlt; reine Zeit-/Parserchecks werden nicht als VM-Abnahme ausgegeben.
- Reboot zuletzt: reiner Checkpoint-/Ergebnisvalidator vorhanden, aber echter
eigener Tunnelrecovery-/SSH-Wiederkontakt-/authentisierter Syncadapter fehlt.
Vor tatsächlichem Reboot müssen alte Boot-ID, Tenant/Agent/Asset, Operation,
Job/Versuch und Planhash privat persistiert sein. Gleiche Boot-ID und Exitcode 0
sind nie Erfolg. Kein Reboot wurde geplant, genehmigt oder ausgeführt.
### Tatsächlich in diesem Vorbereitungslauf geprüft
```sh
python3 tests/vm_mvp_guards.py
python3 tests/vm_job_guards.py
python3 -m py_compile deploy/vm_mvp_acceptance.py deploy/browser/run_mvp_actions.py tests/vm_mvp_guards.py
python3 deploy/vm_mvp_acceptance.py
# jeweils in web/:
npm run typecheck
npm run test:browser -- mvp-actions.spec.ts --list
npm test -- src/api.test.ts
```
- **12 neue Guardtests**, **15 vorhandene VM-Guardtests**, Syntaxprüfung und
TypeScript-Typecheck bestanden; **9 lokale API/UI-Tests** bestanden.
Browserkommando war ausschließlich Discovery: **kein Browserlauf**.
- Echte read-only MCP-/Backendstrecke erfolgreich; erhaltene VM eindeutig
aufgelöst, Liste nicht trunkiert, Dev-Loginprofil bestätigt. Gespeicherte
Präsenz tatsächlich **unreachable**, alte Capabilities nur linux.base/1,
heartbeat/1, run_script, refresh_inventory. Deshalb kein aktueller Live-/Sync-/
Root-/APT-Readinessbeweis und keine Ausführung begonnen. Kein Credentialinhalt,
Hostname oder Inventar-/Logpayload veröffentlicht.
- **Neue Flowzählung dieses Laufs: 0 Pläne/Submit, 0 UI-Genehmigungen, 0 Jobs,
0 VM-Änderungen, 0 Tunnel-/Dienststarts.** Keine SSH-Geschäftsaktion,
Rootconfig-/Policyänderung, Paketinstallation, Update oder VM-Reboot.
### Ausführbare Kommandos / noch nicht ausgeführte Fortsetzung
Lesendes Defaultkommando, tatsächlich wie oben geprüft:
`python3 deploy/vm_mvp_acceptance.py`.
**Geplant, nicht ausgeführt**, erst nach tatsächlichem Worker-Wire-up, frischer
VM-Verbindung und gesondertem geschütztem Benutzerartefakt:
```sh
python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \
--user-artifact devstate/mvp-user-opt-in.json --case hello --case refresh_inventory
# Separat und nur mit tatsächlich freigegebenem Rootscript-/Serviceprofil:
python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \
--user-artifact devstate/mvp-root-opt-in.json \
--case service_setup --case service_start --case service_stop
```
Suite erzeugt private neue Nachweisverzeichnisse und Checkpoints, aber keine
Autofreigaben oder VM-Prozess-/Journalreparatur. Bei Fehler zuerst festen Versuch,
Helper-/Agentledger und eigenen technischen Lifecycle abgleichen, keine Identität
oder Journale löschen. Technischer Rollback betrifft ausschließlich nachweislich
eigene inaktive Prozesse/Units; Root-Geschäftseffekte/Retry benötigen weiterhin
neuen festen UI-genehmigten Plan. **Vorbereitete Suite ist kein Linux-MVP-Abschluss.**
Diese Datei beschreibt Entwicklungsnachweise; kein M1-/MVP-Abschluss.
Die älteren Abschnitte unten protokollieren den passiven Erstslice und sind keine
aktuelle Aussage, dass Job-/UI-Code weiterhin fehlt. Für aktuelle additive
Schnittstellen gelten außerdem `proto/BACKEND_CONTRACT.md` und
`deploy/linux/README.md`. Deren Implementierung ist keine positive VM-Abnahme.
## Aktueller VM-Jobversuch: vor Deployment sicher blockiert (2026-11-12)
### Neuester Bootstrapnachweis: separater RootHelper vorbereitet, APT bewusst gesperrt
- `deploy/vm_root_bootstrap.py`, explizite
`deploy/linux/rmm-helper-dev-test.service` und
`deploy/linux/ROOT-READINESS.md` ergänzt. Keine Rust-/Domain-/Backend-/APTtool-
Quelldateien verändert. Vorgaben aus `tools/apt-transaction/HELPER-CONTRACT.md`
und konkreter Helperkonfiguration gelesen; bestehende gehärtete Standardunit
nicht abgeschwächt. Root-/APT-Jobs wurden nicht ausgeführt oder genehmigt.
- Tatsächlich vor Installation lesend auf VM geprüft: alle neun neuen Helper-/
Provider-/Drop-in-Pfade fehlten, kein Agent/Helper aktiv, kein Listener auf 18443;
erhaltenes Agentkonto UID 993/GID 984 und privater Agentstate unverändert sicher.
Ein unresolved-Job-Guard liest den bestehenden Serverledger; keine DB-Schreiboperation.
- `python3 deploy/vm_root_bootstrap.py build`: separater Docker-OpenSSL-3-
Helperbuild erfolgreich. Kein Serverimage deployt oder Server neugestartet.
Der erste Buildcontext war unnötig groß (2.575 GB); der Copyfilter schließt
künftig ausdrücklich `target`, `node_modules`, `devstate`, Credentials und
Secrets auch innerhalb kopierter Bäume aus. Dieser Filter wurde nicht durch
einen zweiten vollständigen Imagebuild als Größenmessung ausgegeben.
- `python3 deploy/vm_root_bootstrap.py install` nach einem korrigierten
generierten-Code-Importfehler erfolgreich. Fehler transportierte ausschließlich
`NameError` und numerische Zeilennummern, keine Meldung/Payload/Locals.
Ein neuer Test führt echte generierte Hash-/Manifestfunktionen aus und deckt
deren Imports ab; der gescheiterte erste Versuch hatte laut erneutem echten
Preflight noch keine RootHelperressourcen angelegt.
- Aktuelles Helperartefakt benötigt maximal glibc **2.34**; konkrete Auflösung
mit VM-Loader vor Start bestanden. SHA256:
`e8faa5a54c9d693618d497149bf448cf8b52456e9d225038950d5f04c2a6bc8a`.
Installation create-only unter `/usr/local/libexec/rmm-privileged-helper`.
- Authentisierter öffentlicher Signingkey-GET mit normaler CA-/DNS-Verifikation;
exakter Abgleich von Tenant/Agent/Asset/Enrollmentgeneration/Assignmentversion
und bereits gepinntem Agentkey vor Rootprovisionierung. Separate Rootdateien
`/etc/rmm/helper-dev-test-v1.json` und `helper-signing-key-v1.json` sind Root:Root
**0600**. Keine privaten Serverkeys kopiert oder Agentidentitäten verändert.
- Kompilierter Helper installierte ausschließlich feste eingebettete APTtool-/
Hookbytes mit `--install-apt-provider`, leere `archives`, `baselines`, `history`
und Root-0600-Installmetadata. Exakte Hashes/Metadata geprüft; keine Archive,
Baseline, active-Kontexte, Grants oder Acceptancebelege erzeugt.
Durch geerbte UMask entstanden zunächst 0600/0700-Payloadmodi; v2 korrigiert
ausschließlich nach geprüftem Rootowner, Single-Link und exaktem Buildhash auf
die vertraglichen Code-/Hookmodi 0644/0755, Codedirectory 0755. Folgeinstallationen
setzen nur für den separaten Codeinstaller UMask 0022, Trust/State bleiben privat.
- Native readonly Messungen: Ubuntu-24.04-amd64, Python 3.12.3, APT 2.8.4,
dpkg 1.22.6, mount/unshare util-linux 2.39.3. Gemessene Pins:
Runtime `223016938765625ac7e71ebd5f021c6911c9e2013fafdba1c4497c7e4dc69acc`,
APT-Config `045f1bb45f4532112b7a5503e368ed3e1aae03fcc5b6275cbaa3caf7e8a48941`,
Provider `3591bf16a1c0f78d2f53fb366ac93d723f3d82e63ed2b5085eb1649e5ba5dec6`,
Hook `5b4caa7fc1fd6acf1f2b1b9a03e56074ee5595c86592b183fa6da76fe9e8f609`.
Vollständiges gemessenes Runtimeobjekt liegt ausschließlich im privaten Report.
- Direkter rootseitiger `inspect-sandbox` endete tatsächlich mit **100/Veto**,
**nicht bestanden**. Der Parent ist nicht der fertige signierte APT-Worker;
es wurden keine Hostnamespace-/Sandbox-ready-/Acceptance-Dateien gefälscht,
keine Paketmutation und kein Reboot-/Host-PID1-Systemcontrolprobe durchgeführt.
- `systemd-analyze verify` der neuen Unit bestanden. Helper ist unter ausdrücklich
benannter dev/test-Unit **enabled, jetzt gestoppt**. Bei echtem Start Socket
Root:GID984, **0660**, Runtimeparent Root:GID984 **0750** geprüft. UID993 konnte
ausschließlich connecten und schließen, ohne Request/Grant. Das ist ACL-Readiness,
keine signierte IPC-/Rootaktionsabnahme. Helperledger **0 Verbrauchseinträge**.
- Post-exec-Kernelprüfung separat bestätigt: Helper-PID **4146110**, UID0/GID984,
**NoNewPrivs=1**, **Seccomp=2**, CapBnd `00000000800001db`, CapEff
`000000008000015b` (strengere Teilmenge). Erste Statusmessung direkt nach
systemd-Type=simple-Start traf noch Pre-exec-Zustand und ist ausdrücklich kein
Confinementbeleg. v2 verlangte irrtümlich alle acht Capabilities auch effektiv;
nach lesender Diagnose wurde nur der Guard auf erlaubte effektive Teilmenge
korrigiert, **keine Unit-/Kernelrechte gelockert**. Der schon laufende Probehelper
wurde ohne Neustart weiter geprüft und nach bestätigtem leerem Ledger gestoppt.
v3 ist der maßgebliche Sandboxbeleg, ältere Reports bleiben nachvollziehbar.
- Netzwerkaccount kann weder Helperconfig/-Pin/State noch Provider/Installmetadata
schreiben; Helperpin und State sind für UID993 nicht lesbar. Rootstate **0700**;
Agentidentitäts-/Journal-Dateihashes und SQLite-Schema/Rows vor/nach unverändert.
Agentunit bekommt nur einen neuen Root-eigenen versionierten Drop-in:
`RMM_HELPER_SOCKET=/run/rmm-helper/control.sock`; kein Agentrestart, keine
Enrollment-/Binding-/Journalmigration in diesem Schritt.
- Abschließend VM bestätigt: Agent **gestoppt**, Helper **gestoppt**, Runtime-
Socketverzeichnis entfernt, kein 18443-Listener. Kein Tunnel angelegt. Testpaket
`rmm-mvp-test` nicht installiert und Testservice-Datei nicht vorhanden. Keine
Paket-/Diensttest-/Update-/Rebootwirkung. Helper bleibt enabled für einen späteren
ausdrücklich freigegebenen Systemstart; daraus folgt keine RMM-Jobgenehmigung.
- Private Evidenz: `devstate/vm-root/{build,result,readiness-v3}.json` sowie
`/etc/rmm/root-bootstrap-v1-report.json`, `root-readiness-v2-report.json` und
maßgeblich `root-readiness-v3-report.json`. Teil-/Fehlerreports nicht löschen.
- Tatsächliche Prüfungen: **15 Python-Guardtests bestanden**, Python-Syntaxprüfung
bestanden. Tests prüfen generiertes Remoteprogramm/Hashabhängigkeiten und
Secretcanary, Rootconfig ohne Paket-/Reboot-/Rootscript-Autorisierung, konservativen
Cleanup und Verweigerung von Pre-exec-/überprivilegierten Kernelzuständen.
Keine erneute Behauptung der früheren 18 Rusttests; hier Helper-Releasebuild,
native Readiness und gezielte Pythonprüfungen, keine volle Workspace-Suite.
**Konkrete verbleibende APT-/Root-Ausführungsgates:** `apt_provider=null`,
`allow_reboot=false`, `allow_root_scripts=false`; ausschließlich zukünftige
`rmm-mvp-test.service` als erlaubte Dienstkennung. Keine Paketcapability aus
Installation ableiten. Die Readinessunit hat kein CAP_SYS_ADMIN/CAP_MKNOD und
verweigert Mount-/Rebootsyscalls; ProtectSystem=strict verhindert notwendige
Paketdatenbank-/Payloadschreibzugriffe. Ein separat überprüfter APT-Setup-Runner
braucht private Mount/PID/Netznamespace- und Devicenode-Erstellung, muss danach
den Packagechild auf exakt die acht vorgesehenen Capabilities/NNP/seccomp
reduzieren und Hostkontrollsocket-/Readonlypfade sicher ausblenden. Dies wurde
nicht blind durch Entfernen der Unit-Härtung ermöglicht. Backend muss vollständige
signierte Root-/APT-Manifeste erhalten; Agent muss Helperfähigkeiten ausdrücklich
aushandeln und vorhandenen Sync-/Reconnectzustand abgleichen. Erst dann neue feste
UI-genehmigte Jobs. **Kein Paket-/Rootaktions- oder Linux-MVP-Abschluss.**
### Neuester Nachweis: erster tatsächlicher nichtprivilegierter VM-Job erfolgreich
Der frühere Blocker in der Abschnittsüberschrift ist für **diesen ersten**
Hello-World-Lauf behoben. Historische Fehlversuche darunter bleiben Nachweisprotokoll,
keine Aussage über den jetzt bestätigten Endzustand.
- Tatsächlich ausgeführt: `python3 deploy/vm_job_test.py --run-service-hello`.
PC-eigener strikter Reverse-Tunnel, VM-Listener ausschließlich
`127.0.0.1:18443`, vertrauenswürdige CA/DNS-Prüfung `rmm-dev.internal`;
keine Hostkey-/Firewall-/sshd-/Hostsänderung. Native systemd-Agent-PID
**4144575**, tatsächliche UID **993**, kein Root-Netzwerkagent.
- Zwei verschiedene frische Heartbeats derselben erhaltenen Geräteidentität:
**18:04:45.200243 UTC** und **18:05:20.200437 UTC** am 2026-11-12.
Zum Prüfzeitpunkt jeweils unter 90 s alt; `run_script` tatsächlich gemeldet.
Tenant-B-Leser erhält für dieses Tenant-A-Gerät HTTP 404.
- Echter rmcp-Streamable-HTTP-Client mit `initialize`/`notifications/initialized`,
Protokoll **2025-11-25**; `operations.plan` und `operations.submit` beantragen
exakt einen festen Job auf genau diesem VM-Asset. Exakte Bytes:
`printf '%s\n' 'Hello World'` mit abschließendem LF, `/bin/sh`/`posix_sh`,
`agent_service`, erwartete stdout `Hello World` mit LF, Laufzeitlimit 60 s,
Outputlimit 65536 Bytes, Planstartfrist 15 Minuten, Parallelität 1.
- Vor Genehmigung realer persistenter Antrag `pending_approval`, null Jobs,
keine Executionaggregation; gerätebezogene DB-Leseprüfung ergab
**Jobs/Outbox/Startgrants = 0/0/0**. Keine direkten Freigabe-API-/DB-Aufrufe.
- **Tatsächlicher Playwrightlauf bestanden**, nicht nur Discovery: normales
TLS-Login mit geschützter Loginfile, sichtbar simulierter Testprincipal,
bestehenden Antrag öffnen, vollständigen unveränderlichen Einziel-Preview,
Bytes/Nachbedingung/Identität/Limits und SHA256 der gespeicherten Planbytes prüfen,
Checkbox und sichtbaren Genehmigungsbutton klicken, Ergebnis anzeigen, Logout.
NSS-Trust isoliert, keine Screenshots, HAR, Traces oder Geheimnisausgaben.
- Danach **Jobs/Outbox/Startgrants = 1/1/1**, genau ein serverseitiger
`start_reserved`-Audit und ein `plan_authorization`-Audit. Serverjob `succeeded`,
Revision 2, nichtleerer Journalannahmenachweis, exakte Agent-/Asset-/Jobbindung
und `execution_identity=agent_service`. Ergebnis: Exitcode 0, stdout exakt
`Hello World\n`, `postconditions_passed=true`. Kein separat beobachtetes
`verifying`-Zwischenereignis behauptet; bestätigtes Endergebnis liegt vor.
- Genehmigungsaudit: `approval_origin=dev_test_browser_simulation`,
`testsimulation=true`, Principal `simulated-testprincipal-a`, exakt gebundener
Planhash `b58910cdbdb1047355ddc36d03c0dd3c7d3a58eb39a91b965242b3c2c8c2fda9`.
Ausschließlich Entwicklungs-Browsersimulation, **kein menschlicher
Produktionsfreigabenachweis**.
- Nachträgliche echte lesende VM-Prüfung: `journal.sqlite` enthält genau einen
passenden Job/Versuch mit `succeeded` und derselben Grant-ID wie der Server;
`job_events` leer (kein unbestätigtes Jobevidence mehr). `consumption.sqlite`
enthält genau einen Verbrauch mit demselben Job und Grant sowie genau einen
zugehörigen Executionevidence-Eintrag. Keine neue Wirkung oder Redelivery
zum Beweis provoziert. Serverjob hat keine persistierte Bootspalte; deshalb
kein zusätzlicher unabhängiger Boot-Bindungs-/Replaynachweis behauptet.
- Erst nach terminalem Jobende eigenen Dienst gestoppt und eigenen Tunnel-PID
**2110999** beendet. Nachträglich VM bestätigt: Dienst nicht aktiv, kein Listener
auf 18443. Installation bleibt erhalten, nicht enabled; Identität/Journal nicht
gelöscht, State 0700 und sämtliche State-Dateien 0600. Kein aktiver lokaler
Testrecord. Geschützte Evidenz/PIDs/IDs: `devstate/vm-jobs/result.json`.
- Abschließende **10 Python-Guardtests bestanden**, Syntaxprüfung bestanden,
TypeScript-Typecheck und **9 lokale API/UI-Tests bestanden**. Regressionen prüfen
tatsächliches generiertes Bootstrapprogramm, Secretcanary-Fehlertransport und
dass aktive/unknown Zustände keinen automatischen Dienst-/Tunnelstop erlauben.
- **Wiederaufnahme (geplant, nicht erneut ausgeführt):** zuerst PC-initiierten
strikten Tunnel gemäß `docs/development.md` mit `-N -T`,
`ExitOnForwardFailure=yes`, Keepalive 30/3 und
`-R 127.0.0.1:18443:127.0.0.1:18443` über vorhandene vertrauenswürdige SSH-Daten
aufbauen; anschließend über denselben verifizierten Bootstrapzugang
`systemctl start rmm-agent.service`. Dienst benötigt diesen Dev-Tunnel.
Kein neuer Job vor bestätigtem Backend-/Agent-Reconnectabgleich: der vorhandene
Safetyzustand wird niemals gelöscht/umgeschrieben. Der Erstlauf-Testbefehl
verweigert absichtlich vorhandene VM-Jobhistory und ist kein Wiederholungsbefehl.
- **Offen:** Sync-/Reconnect- und Redelivery/ACK-Verlustabnahme, unabhängiger
Bootnachweis, weitere UI-genehmigte Inventory-/Logjobs, Long Polling,
Roothelper-/Dienst-/Paket-/Update-/Rebootstrecken. Keine dieser Zielwirkungen
wurde ausgeführt. Rotation/Recovery/weitere Sicherheitsabnahmen weiterhin offen.
Dieser positive Hello-World-Nachweis ist **kein M1-/Linux-MVP-Abschluss**.
### Fortsetzungsversuch mit ausdrücklich genehmigtem Dienstkonto-Bootstrap
**Nachtrag: kontrollierte Reparatur und Migration inzwischen erfolgreich.**
- Vor erneutem Installationsversuch tatsächlichen VM-Teilzustand ausschließlich
lesend geprüft: Originalstate vorhanden, Zielstate fehlte; dediziertes nologin-
Konto UID 993/GID 984 und eigene Binary/geschützter Bootstrapreport vorhanden,
noch keine Unit. Keine supplementary Gruppenmitgliedschaft des Kontos.
- Tatsächlicher ursprünglicher Loaderfehler zusätzlich konkretisiert: Hostbuild
benötigt `libssl.so.1.1`/`libcrypto.so.1.1`; Ubuntu-VM-Loader meldete Exit 127 und
fehlendes `libssl.so.1.1`. Der reine glibc-Vergleich genügte ausdrücklich nicht.
- Reportinitialisierung vor Seiteneffekte gezogen, geschützten Report über
`try/finally` persistiert, Fehlertransport auf Exceptionklasse und numerische
Tracebackzeilen begrenzt. Keine Fehlermeldungen, Locals oder Payloads übertragen.
Provenienzgeprüfte Fortsetzung verweigert fremde Dateien, veränderten Originalstate
und unbekannte Configeinträge. Eigene alte Binary nur nach exaktem lokalem
SHA256-Abgleich durch vorher VM-loadergeprüftes neues Artefakt ersetzt.
- Aktuelles Artefakt separat in Docker gebaut:
`docker build --target build -f deploy/Dockerfile -t rmm-vm-agent-build:dev .`.
Build erfolgreich, **kein Serverdeploy/-restart**. Dockercontext schließt Secrets
aus. Extrahiertes Agentartefakt benötigt glibc 2.34 und OpenSSL 3; dessen konkrete
Bibliotheksauflösung auf der tatsächlichen Ubuntu-VM erfolgreich.
- `python3 deploy/vm_job_bootstrap.py` danach **erfolgreich**: gleiche erhaltene
Geräteidentität/Privatekey/SQLite-Dateibytes per atomarem Rename nach
`/var/lib/rmm-agent` migriert, Source-Statepfad nicht als zweite aktive Identität
erhalten. Vorher/nachher sämtliche Datei-SHA256 und SQLite-Schema-/Rowdigests
identisch; ursprüngliches Journal hatte `counter` (1 Row), `pending` (0 Rows),
noch keine Job-/Safetyhistory. Keine Tabellen-/Safetyflagänderung zur Migration.
Geräteidentität nicht neu enrollt; keine DB-/PKI-Resets.
- Stateverzeichnis 0700 und Dateien 0600, Konto UID 993; Root-eigene Binary/Unit,
Root-eigene Configdirectory 0755, service-eigene Bindingdatei 0600 (vom Agentreader
verlangt), öffentliche CA 0644. Eigene zuvor durch UMask 0077 versehentlich 0700
angelegte Installationsdirectories nach Provenienzprüfung auf 0755 korrigiert.
Unit hat `User/Group=rmm-agent`, keine Capabilities, NoNewPrivileges und strikte
systemd-Sandbox. Nur daemon-reload, kein enable/start durch den Bootstraphelper.
- Geschützte Evidenz: lokal `devstate/vm-jobs/bootstrap.json`, auf VM
`/etc/rmm/vm-bootstrap-report.json`. Root-Helper nicht installiert/provisioniert.
Keine Root-Jobs, Zielpakete, Updates oder Reboots ausgeführt.
- **Rollbackplan:** Nur bei nachweislich inaktiven Jobs Dienst stoppen; nach
internem Manifestabgleich gesamten State atomar zurück zum im privaten Report
gespeicherten alten Pfad verlagern und ursprüngliche Rootownership wiederherstellen.
Nie beide Identitätspfade gleichzeitig starten; keine automatische pauschale
Ressourcen-/Accountlöschung. Erfolg dieses Plans wurde nicht praktisch getestet.
- Zwei neue Regressionen führen das **wirklich generierte Remoteprogramm** isoliert
mit gemockten OS-/Account-/Loaderaktionen aus: fehlender Binaryparent plus
erfolgreiche Report-/Migrationsstrecke; Loaderexception mit Secretcanary im
argv/stderr, nur Klasse/Zeilennummern im Transport und persistenter Teilreport.
Erster Regressionslauf blockierte korrekt wegen eines vom Test offengehaltenen
SQLitehandles; Test schließt dieses jetzt explizit. Danach **9 Guardtests bestanden**.
Python-Syntaxprüfung bestanden; TypeScript-Typecheck und **9 lokale API/UI-
Unit-Tests bestanden**. Kein neuer Rustquellcode geändert.
- `deploy/vm_job_live.py` und `deploy/vm_job_test.py --run-service-hello` ergänzen
begrenzte eigene Tunnel-/systemd-/MCP-/Browserorchestrierung. Sie lassen aktive
oder unbekannte Jobs samt eigenem Tunnel konservativ bestehen und führen keine
Freigabe über API/DB aus. Positive Laufzeitergebnisse sind separat nachzuweisen;
dieser Bootstrapnachtrag allein ist **kein positiver Job- oder MVP-Nachweis**.
- Neue Bootstrapfreigabe erlaubt ausschließlich dediziertes nichtprivilegiertes
Systemdienstkonto samt Agentinstallation und verlustfreier Zustandsmigration;
keine Root-RMM-Jobs, Pakete, Updates oder Reboots wurden daraus abgeleitet.
- `deploy/vm_job_bootstrap.py` implementiert einen create-only Installationsversuch,
authentisierten öffentlichen Signingkey-Bezug, atomare State-Verlagerung auf
derselben Partition und Vergleich von Datei-SHA256 sowie SQLite-Schema-/Rowdigests.
Der Code ist **nicht erfolgreich auf der VM abgenommen**. Nach Fehlern nicht
unverändert erneut ausführen: zuerst VM-Zustand und etwaigen Teilbootstrap prüfen.
- Tatsächlich erfolgreicher aktueller Releasebuild:
`~/.cargo/bin/cargo build --locked --release -p rmm-agent --target-dir devstate/vm-jobs/build`.
Zuvor fehlte das lokal erwartete Docker-Rustimage, und `cargo` war nicht im PATH;
der vorhandene explizite Cargo-Proxy funktionierte. Keine Serverneubauten/-neustarts.
- Tatsächliche CA-verifizierte Operator-GETs erfolgreich: Gerätebestand HTTP 200
mit erhaltenem Agentrecord einschließlich Enrollment-/Assignmentgenerationen;
öffentlicher Job-Signierschlüssel HTTP 200. Keine privaten Serverkeys übertragen.
- `python3 tests/vm_job_guards.py`: **7 bestanden** (zusätzlich Dateibytes und
SQLite-Schema/Rows, Symlink-/Hardlink-Verweigerung). Syntaxprüfung des Bootstraphelpers
bestanden. Kein erneuter positiver Browser- oder nativer Agentdienstnachweis.
- Zwei konkrete Bootstrapaufrufe scheiterten im privaten Remote-Kommandopfad:
`command failed; private diagnostics withheld`. Nach dem zweiten Fehlschlag
angehalten. **Remote-Teiländerungen nicht ausgeschlossen**, Migration/Dienstkonto/
Installation nicht als abgeschlossen behaupten. Kein erfolgreiches lokales
`bootstrap.json`-Ergebnis. Vor Fortsetzung remote etwaiges
`/etc/rmm/vm-bootstrap-report.json` und create-only Ressourcen kontrolliert prüfen;
keine pauschale Löschung, kein Journalreset oder Reenrollment zur Reparatur.
- Der Helper ruft keinen Agentstart auf; kein eigener Tunnel wurde erstellt.
Hello-World-Plan, UI-Genehmigung, Audit- und Jobnachweise weiterhin nicht ausgeführt.
Erforderliche nächste Arbeit ist die Fehlerdiagnose/Teilzustandsprüfung, nicht
eine Behauptung erfolgreicher Migration oder ein blind wiederholter Installationslauf.
- Vollständige Spezifikation 1.5, Projektentscheidungen, Entwicklungsweg sowie
Agent-/Backend-/Browserverträge vor dem Versuch gelesen. Kein RustDesk-Auftrag.
- Tatsächlich erneut über SSH mit vorhandenen Hostkeys und
`StrictHostKeyChecking=yes` geprüft: SSH-Benutzer hat UID 0, das erhaltene private
Testverzeichnis gehört UID 0, vorhandene Geräteidentitätsdatei ist vorhanden.
Kein bestehender dedizierter unprivilegierter Account namens `rmm-agent` oder
`rmm-test` gefunden. Andere Konten wurden weder als Testaccount interpretiert
noch übernommen. Keine Accountnamen-/Adress-/Identitätsinhalte ausgegeben.
- `deploy/vm_job_test.py` ergänzt und tatsächlich ausgeführt. Es ist derzeit
ausschließlich ein lesendes Readiness-Gate, **kein fertiger Deploy-/Jobrunner**.
Exit 2 mit drei konkreten Blockern: Root-SSH braucht kontrolliertes Deployment
unter bestehendem unprivilegiertem Account; kein solcher dedizierter Testaccount
vorhanden; Root-eigener alter Zustand braucht kontrollierte Accountmigration.
Kein Agentprozess und kein Listener auf 18443 vorgefunden. Geschütztes Ergebnis:
`devstate/vm-jobs/preflight.json` (0600, Verzeichnis 0700).
- Keinen Root-Netzwerkagenten als `agent_service` gestartet. Keine Accounts erstellt,
keine Ownership-/Journal-/Identitätsänderung, kein Reenrollment, kein Journalreset,
kein Tunnel, Deployment oder Serverrestart. Deshalb keine eigenen neuen Agent-/
Tunnel-PIDs und kein Cleanup laufender Jobs erforderlich.
- `tests/browser/vm-jobs.spec.ts` und `deploy/browser/run_vm_jobs.py` als **noch nicht
positiv ausgeführte** Fortsetzung ergänzt. Der Browser öffnet einen ausdrücklich
bezeichneten bestehenden Antrag, prüft null Jobs vor Genehmigung, vollständigen
festen Einziel-Hello-World-Preview mit `agent_service`, exakte Skriptbytes,
erwartete Ausgabe, Limits und gespeicherten Planhash, dann ausschließlich Checkbox
und sichtbaren Genehmigungsbutton. Keine direkte API-/DB-Freigabe. Isolierter
NSS-Truststore und bestehender geheimnisunterdrückender Reporter bleiben erhalten.
- Tatsächlich ausgeführt: `python3 tests/vm_job_guards.py` (**5 bestanden**),
Python-Syntaxprüfung der drei neuen Pythondateien, `npm run typecheck`
(**bestanden**), `npm test -- src/api.test.ts` (**9 bestanden**).
`npm run test:browser -- vm-jobs.spec.ts --list` war nur Testdiscovery;
ausdrücklich **kein Browserlauf und kein VM-Jobnachweis**.
- Nicht ausgeführt: aktueller kompatibler Agentbuild/-transfer, Signingkey-bootstrap,
Bindingsabgleich, native nichtprivilegierte Agentstrecke, MCP-Plan/Submit für die VM,
positive UI-Genehmigung, Audit-/Grant-/Journal-/Outputprüfung, Inventory-/Logjobs,
Redelivery/ACK-Replay, systemd-, Paket-, Update- oder Rebootwirkungen. Das alte
Artefakt aus dem passiven Nachweis wurde nicht als aktueller Build ausgegeben.
- Nächster konkreter Schritt: dedizierten unprivilegierten Testaccount und eng
begrenzte Migration der **erhaltenen** VM-Geräteidentität abstimmen. Danach
Agentbuild und Deployment implementieren; vorhandenen Sync-/Reconnect-Schutz
respektieren, niemals Safetyflag/Journal löschen. Frische Telemetrie unter 90 s,
Auditursprung/Testprincipal und authentisierte Job-/Bootbindung bleiben offene
Nachweise. Bei unklarer Wirkung kein weiterer Versuch. **Kein Linux-MVP-Abschluss.**
## Implementiert
- Sechs tatsächlich verwendete Rust-Crates: Domain, Protobuf-Protokoll, SQLx-Persistenz,
Server (interne API-/Gateway-/TLS-Module), Linux-Collector und Agent (Transport/SQLite).
Weitere Spec-Crategrenzen werden erst bei benötigten Anwendungsfällen extrahiert;
keine leeren Worker-, MCP-, UI- oder Executor-Platzhalter.
- Gepinnte stabile Toolchain 1.99.1. Beim Bootstrap live über den offiziellen Stable-
Manifestkanal ermittelt: Manifestdatum 2026-10-15, rustc Commit `58cf8f9c3`.
Cargo.lock hält die tatsächlich aufgelösten Bibliotheksversionen fest.
- Docker-Compose-Projekt `rust-discovery-dev`, PostgreSQL intern, separater Migrator,
API/Gateway nur über PC-Loopback 18443. Migrationen und Keys werden nicht im Image erzeugt.
Serverrollen `api|gateway|all` getrennt auswählbar; API-only lädt keinen CA-Privatschlüssel.
GitHub-Actions-Prüfworkflow angelegt, aber noch nicht auf einem CI-Runner ausgeführt.
- Zwei Dev-Mandanten, zufällige getrennte Leser-Bearer. Expliziter Dev-Modus; Produktion
wird grundsätzlich verweigert, bis echte Produktionsauthentisierung implementiert ist.
- RLS auf Tenant-/Asset-/Agent-/Beobachtungsdaten. App ist weder Eigentümer, Superuser
noch BYPASSRLS. Kontext über `set_config(..., true)` je Transaktion. Eng begrenzte,
nicht öffentlich ausführbare SECURITY-DEFINER-Funktionen nur für Tokenverbrauch und
Zertifikatfingerprint → Gerätebindung. Keine tenant_id im Telemetriepayload.
- Atomarer Verbrauch eines gehashten einmaligen 15-Minuten-Enrollment-Tokens und
Geräteanlage. Lokal erzeugter EC-Geräteschlüssel; CSR-Signaturprüfung; 30-Tage-Clientzertifikat.
- rustls-TLS direkt im Rust-Server. Optionale Clientidentität ausschließlich für Enrollment/
Dev-Lese-API; WSS verlangt gültiges Clientzertifikat plus registrierte, nicht widerrufene
Leaf-Fingerprintbindung. Identität kommt aus der TLS-Verbindung, nie HTTP-Headern.
- Binäre Protobuf-Envelope 1.0, begrenzte Frames, Hello, DB-Verbindungsgeneration/Fencing,
flüchtiger frischer Heartbeat, einteiliger SHA-256-geprüfter `linux.base`-Snapshot,
dauerhafter ACK nach Commit. Unbekannte Typen/Versionen werden nicht ausgeführt.
- SQLite mit synchronem Sequenzzähler, einem begrenzten unbestätigten Snapshot,
Replay/Deduplizierung und exklusivem Prozesslock. Kein Jobjournal, weil keine Jobs existieren.
- Read-only nativer Linux-Collector für OS, Hostname, Architektur, verfügbare Root-Bytes/Inodes.
Quelle/Erhebungs-/Empfangszeit, Teilinventar und unbekannter Gesundheitszustand sind sichtbar.
- Begrenzte Fehlerantworten mit Code/Korrelation ohne Request-/Secret-Echo. 128 Verbindungen,
TLS-/Hello-/Send-/Idle-Timeouts, Body-/Frame-Limits und einfache Kanalrate. Keine Lastfreigabe.
## Prüfprotokoll
Letzter tatsächlich ausgeführter Stand:
- Native Toolchaininstallation 1.99.1 erfolgreich.
- `cargo build --locked -p rmm-server -p rmm-agent`: erfolgreich.
- Vier betroffene Unit-Tests: erfolgreich (Dev-/Prod-Grenze, Golden-Wire,
native lokale Linux-Inventur, SQLite-Persistenz/Lock).
- Clippy aller sechs verwendeten Crates/Targets mit `-D warnings`: erfolgreich.
- Abschließender nativer Build, `cargo fmt --all --check`, dieselben vier Unit-Tests
und Clippy inklusive Fehlermiddleware/Serverrollen: erfolgreich.
- Python-Syntaxprüfung für `deploy/dev.py`/`tests/local_integration.py`: erfolgreich.
- Docker-Releasebuild von Server und Agent erfolgreich. PostgreSQL auf frischem eigenen
Volume gestartet; SQLx-Migration erfolgreich (Migrationscontainer mit Exit 0).
- **Dev-PKI repariert und lokal geprüft (2026-11-12).** Frühere Fehler: doppelte
BasicConstraints aus Host-Konfiguration/`-addext`, danach fehlgeschlagener
`/dev/null`-Konfigurationsversuch. Jetzt vollständige isolierte `deploy/openssl.cnf`
mit CA-/Server-/Clientrollen, expliziten Extensions und DNS-SAN `rmm-dev.internal`.
- `python3 tests/bootstrap.py`: zweimal erfolgreich auf Host-OpenSSL **1.1.1w**.
Prüft frische PKI trotz absichtlich defekter Host-Konfiguration, eindeutige CA-/Server-
BasicConstraints/KeyUsage, Servername/-zweck, Clientzweck, TLS-Parser, Dateirechte
und Verweigerung des Überschreibens.
- Bestehende projektlokale Dev-Zertifikate kontrolliert neu ausgestellt: zuvor **0**
registrierte Agentidentitäten geprüft; CA-/Serverschlüssel unverändert, alte öffentliche
Zertifikate privat unter gitignored `devstate/` gesichert. Kein DB-/Volume-Reset.
- Erster Integrationslauf nach PKI-Reparatur: `ConnectionRefusedError`, obwohl der
Server erfolgreich startete. Docker zeigte konfigurierte PortBindings, aber leere
NetworkSettings.Ports auf internem Backend-Bridge-Netz. Separates Ingress-Netz nur
für den Server ergänzt; danach `127.0.0.1:18443` tatsächlich veröffentlicht,
PostgreSQL weiterhin ohne veröffentlichten Port (beides per Docker inspect geprüft).
- Folgender Lauf erreichte TLS/RLS/Enrollment, scheiterte aber an `BrokenPipeError`
beim Senden eines absichtlich übergroßen Frames: Server darf bereits den Header
ablehnen. Test berücksichtigt nun Transportabbruch auch während `sendall`.
- `python3 tests/local_integration.py`: anschließend **vollständig erfolgreich**.
Echte lokale Enrollment-/mTLS-/WSS-/Heartbeat-/Inventarstrecke, TLS-Trust-/Namensfehler,
anonyme/gefälschte Identität, Protokollmajor/fremde Agent-ID, alte Heartbeats, Größenlimit,
RLS ohne Kontext/Transaktionsreset/Cross-Tenant-Insert, Leser-Tenantgrenzen,
Rollenrechte, Enrollment-Rennen/CSR-Rollback, Agentneustart/Fencing und Widerruf geprüft.
Keine Job-/Outbox-/Startgranttabellen vorhanden. Kein VM-Erfolgsnachweis.
- Wiederholter Migrationscontainer: Exit **0**. Python-Syntaxprüfung für `deploy/dev.py`,
`tests/bootstrap.py`, `tests/local_integration.py`: erfolgreich. Rust-Code unverändert;
Rust-Build/Unit-Tests/Clippy in diesem PKI-Fix nicht erneut ausgeführt.
- CI und VM-/systemd-Abnahme weiterhin **nicht ausgeführt**. Keine SSH-/Tunnel-/VM-
Verbindung und keine Jobs, Updates oder Reboots in diesem Reparaturlauf.
## VM-Zugang und echter passiver VM-Nachweis
### VM-Zugangsvorbereitung, 2026-11-12
- `deploy/vm_access_check.py` ergänzt: striktes Datenparsing ohne Credentialausgabe,
Prüfung von Eigentümer/0700-/0600-Modi und Ignore-Regel, vorhandene Benutzer-Hostkeys,
strikte SSH-Namens-/Hostkeyprüfung. Fehlende/geänderte Hostkeys werden nicht akzeptiert;
ein gegebenenfalls ausgegebener Scan-Fingerprint ist ausdrücklich unbestätigt.
- Auf der tatsächlichen VM erfolgreich ausgeführt: minimaler lesender SSH-Check.
Beobachtet: Ubuntu 24.04, Linux x86-64, glibc 2.39, Benutzerhome vorhanden;
Port 18443 zum Prüfzeitpunkt frei. Keine privaten VM-Ziel-/Hostnamewerte dokumentiert.
- `python3 tests/vm_access_check.py`: fünf Tests bestanden. Python-Syntaxprüfung bestanden.
Keine Rust-Änderungen; Rust-/Docker-/Integrationstests in diesem Schritt nicht wiederholt.
- Beim ersten Zugangscheck noch kein Reverse-Tunnel/Agentdeployment; nach ergänzter
Pflichtlektüre wurde die folgende reale passive Strecke ausgeführt.
### Tatsächliche VM-Passivstrecke, 2026-11-12
- `deploy/vm_passive_test.py` ergänzt und erfolgreich ausgeführt: vorhandene Prozesse/
Portbelegung prüfen, konkretes Docker-Agentartefakt auf ELF/glibc/Libraries prüfen,
strikten PC-initiierten Loopback-Reversetunnel mit Keepalive herstellen und VM-Listener
prüfen, ausschließlich benutzerlokal in neuem privaten Testverzeichnis deployen.
- VM Ubuntu 24.04 x86-64/glibc 2.39; Artefakt benötigt maximal glibc 2.34. Konkrete
Bibliotheksauflösung mit VM-Loader vor nativem Agentstart erfolgreich.
- Enrollment mit einmaligem Dev-A-Token, lokal auf VM erzeugter Geräteidentität,
vertrauter öffentlicher CA und bestehendem TCP-Override erfolgreich. TLS-SNI und
Namensprüfung bleiben `rmm-dev.internal`; keine Zertifikatsprüfung ausgeschaltet.
- Echtes VM-Inventar serverseitig über tenantgebundene Lese-API bestätigt: OS/Architektur,
intern verglichener Hostname und positive verfügbare Root-Bytes/Inodes;
`linux.base`, `partial`, Erhebung 16:40:12.632 UTC, Empfang 16:40:12.796518 UTC.
Zwei frische Heartbeats um 16:40:44.849118 und 16:41:12.779675 UTC; Präsenz `online`.
Leser von Dev-Mandant B sieht diese Geräteidentität nicht.
- Eigene Agent-PID 4141792 nach exakter Executable-Prüfung per SIGTERM beendet und
Prozessende bestätigt; eigene Tunnel-PID 1869118 beendet und darauf gewartet.
Kein aktiver Testrecord; privates Benutzer-Testverzeichnis bleibt mit Zustand/Log,
Tokenkopie entfernt. Geschützte Evidenz/PIDs/privater Pfad unter
`devstate/vm-passive/result.json`; Details und ausgeführte Befehle in `docs/development.md`.
- Fünf Parser-Tests und drei lokale Orchestrierungs-Guardtests bestanden,
Python-Syntaxprüfung bestanden. Abschließender lesender VM-SSH-Check bestätigt
Port 18443 nach Testende wieder frei. Keine Ruständerung;
Build/Clippy/andere Integrationstests in diesem Schritt nicht wiederholt.
- Kein systemd-/Rootbootstrap, keine Pakete/Hosts-/Firewall-/sshd-Änderungen, keine Jobs,
Updates oder Reboots. Kein DB-/PKI-Reset. Passiver VM-Erstnachweis, **kein M1-Abschluss**.
## Bewusste Grenzen / keine Abnahmen behaupten
- Linux-M1 ist **teilimplementiert**, nicht abgenommen: passiver realer VM-Erstnachweis liegt vor,
keine systemd-Installation, Zertifikatsrotation, Recovery nach Zertifikatsablauf,
Long Polling, Proxyabnahme oder belastbare Klon-/Restoreerkennung.
- Windows beginnt erst nach Linux-MVP-Abnahme; kein Windows- oder ARM-Supportnachweis.
- CA-Signierung befindet sich nur im expliziten lokalen Dev-Gateway. Keine produktive
Rollentrennung/Signer-Isolation, OIDC, UI/MCP, Audit-WORM, HA oder Betriebsreife.
- Keine Jobs, Pläne, Genehmigungsendpunkte oder Executor. M2 darf erst mit echter
interaktiver WebUI-Freigabe implementiert/ausgeführt werden; keine Testausnahme.
- Snapshot-Scope beschränkt auf ein Root-Dateisystem, Qualität `valid` nur bei erfolgreicher
vollständiger lokaler Erhebung dieses Teilscopes. Fehler schließen den Kanal statt Werte
zu erfinden. Weitere Volumes/Software/Updates/Dienste sind nicht implementiert.
- Journal auf einen Snapshot begrenzt. Alter über 72 Stunden sperrt Übertragung und braucht
noch einen ausdrücklich entworfenen Gap-/Recoverypfad. Kein stilles Verwerfen/Erfolgs-ACK.
- Antwortverlust nach Enrollment-Commit benötigt in diesem Entwicklungsslice ein neues
Token/Enrollment; keine automatische Recovery mit unbewiesener Identität. Teilgeschriebene
lokale Identitätsdateien benötigen kontrollierte manuelle Recovery.
- Widerruf wird bei Reconnect und jeder Nachricht geprüft. Keine CRL/OCSP-Infrastruktur;
bestehende stille Kanäle enden spätestens durch 65-Sekunden-Idle-Timeout bzw. nächste
Nachricht. Keine Jobzustellung, die dieses Intervall ausnutzen könnte.
- Geräteliste max. 100 mit sichtbarer Trunkierung, keine Cursor/Einzelgeräteansicht. Alte
Beobachtungen aktualisieren keine Präsenz; aktuelle Inventaransicht wählt neueste Erhebungszeit.
- Image-Tags/Lockfile sind gepinnt, Images noch nicht über Digest/SBOM/Supply-Chain-Verfahren
freigegeben. Keine Produktionspasswörter/Private Keys oder VM-Credentials im Quellcode.
## Nächster Slice
1. Lokaler PKI-/TLS-/RLS-E2E-Nachweis liegt vor; vor weiterer Nutzung Gerätestatus und
Testhistorie prüfen. Fehlgeschlagene frühere Integrationsläufe können Testidentitäten
hinterlassen; keine vorhandenen Agentidentitäten oder Schlüssel pauschal ersetzen.
2. SSH-Zugang, konkretes Artefakt und passive VM-Strecke über Loopback-Reversetunnel
sind geprüft; private Testidentität/Verzeichnis für kontrollierte Fortsetzung erhalten.
3. Reconnect, Widerruf und systemd-Lebenszyklus auf VM nachweisen; eine dauerhafte
Dienstinstallation erst nach klarer Bootstrapfreigabe durchführen.
PID/Logs ohne Secrets dokumentieren; keine Updates/Reboots/fremden Paketinstallationen.
4. Linux-M1 um Rotation/Recovery/Long Polling und gezielte Fehlerabnahmen vervollständigen.
5. Erst danach M2 mit persistenter Antragsstrecke und minimaler menschlicher WebUI-Genehmigung.
+68
View File
@@ -0,0 +1,68 @@
# Verbindliche Projektentscheidungen
Stand: **2026-11-12**, Spezifikation **1.5** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.4 führte Linux-first ein; 1.5 dokumentiert die neuen Userentscheidungen zur dev/test-Browsersimulation und zum MVP ohne RustDesk. Dieses Dokument fasst Entscheidungen zusammen und behauptet keinen Implementierungsstand.
## Produkt und Ausbaustufen
- **Linux-first für ALLE Features:** Zuerst tatsächliche Ausführung und Nachweis auf der Linux-Test-VM, nicht nur PC-/Containerlauf, Simulator oder Cross-Build.
- **Erstes Phasenziel Linux-MVP (M0–M5):** Eigenständiger Linux-Agent x86-64, WebUI, MCP und autorisierte dauerhafte Jobs. Windows-x86-64-Implementierung und native Abnahmen folgen erst nach dokumentierter Linux-MVP-Abnahme. Physische Geräte und beliebige VMs sind gleichberechtigt; ein Gast mit unbekanntem Host/Hypervisor ist vollständig verwaltbar. Kein PVE-Agent, Proxmox-Host oder Hypervisorzugang erforderlich.
- **Noch später:** M6a: Monitoringausbau und ARM64 mit nativen Tests. M6b: Proxmox-Modul/-Client auf demselben Linux-Agenten, Cluster und Backupbeobachtung samt Abnahmen; PBS optional. Keine vorgezogene PVE-Implementierung/-Abnahme als Teil des Linux-MVP oder vor der Windows-Phase.
- **Weitere Betriebsreife (M7):** Terminal, signierte Agentupdates, Restoreverfahren, Lasttests und belastbarer Betrieb. M8 bewahrt optionale Geschäftsleistungen und zusätzliche Provider.
- Keine eigene grafische Fernsteuerung; RustDesk bleibt eine getrennte Anwendung mit eigener Infrastruktur.
- **Neuer Useroverride 2026-11-12:** „rustdesk musst du nicht machen ... das lasse aus“. RustDesk entfällt vollständig aus dieser Umsetzung: keine Installation, Profile/Provisionierung oder externe Desktopabnahme. M4 bleibt allgemeine Linux-Paketverwaltung; M5 prüft die drei übrigen Referenzabläufe ohne RustDesk. Bestehende RustDesk-Architekturtexte sind nur spätere optionale Integrationsverträge, keine MVP-Pflicht oder Abnahmeblocker. Keine eigene Desktop-Engine als Ersatz.
## WebUI-Genehmigung für alle Jobs
Die folgenden Produktregeln bleiben unverändert. Ausschließlich für diese Entwicklungsabnahme gilt die danach dokumentierte Bedienungsausnahme; kein Job darf die UI-Genehmigung überspringen.
- Jeder zur Ausführung eingestellte Job aus Menschen/UI, MCP oder Automatik benötigt vorher explizite Genehmigung eines berechtigten Menschen in der WebUI. Das gilt bereits für Hello World und ebenso für Live-Diagnosen, Reboot-Folgejobs und Retry/neue Versuche.
- `operations.plan` speichert einen unveränderlichen Plan. `operations.submit` speichert ausschließlich einen dauerhaften Antrag `pending_approval` mit `operation_id`, noch keine ausführbaren Jobs oder Outbox. `jobs.get(operation_id)` zeigt diesen Antrag auch ohne Jobs.
- Die WebUI zeigt alle festen Einzeljobs/Versuche, Zielanzahl und Zielgeräte, Inhalte und Skript-/Paketbyteshash, Fristen und Auswirkungen. Explizite Sammelgenehmigung dieses festen Pakets ist möglich; Dauer-/Wildcardfreigaben nicht. Erst Genehmigung erzeugt atomar Nachweis, Ausführung, Jobs und Outbox. JobOffer und Startgrant sind vorher verboten.
- Policies dürfen nur begrenzen oder verweigern. MCP darf vorbereiten und beantragen, niemals genehmigen. MCP-/Automatisierungstokens sind selbst mit Approver-Rolle nicht freigabefähig; Freigabe verlangt authentisierten interaktiven WebUI-Kontext.
- Geänderte Ziele, Bytes, Parameter, Fristen oder neue Versuche erfordern einen neuen menschlich genehmigten Plan. Redelivery desselben Versuchs erfordert keine neue Genehmigung, erlaubt aber keine zweite Wirkung. Technischer Grant-Ersatz nur bei nachgewiesenem Nichtstart und gültiger ursprünglicher Genehmigung.
- Passive Standardtelemetrie/Heartbeat und Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Neue Live-Erhebung darf nicht als passive Telemetrie umgangen werden. Gebundene Nachprüfungen gehören zum genehmigten Job.
### Explizite Userentscheidung zur Entwicklungsabnahme (2026-11-12)
Der User hat neu ausdrücklich angeordnet: „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“.
- Ausschließlich im **expliziten dev/test-Profil** darf Browserautomatisierung tatsächliche WebUI-Interaktionen einschließlich Genehmigung des angezeigten unveränderlichen Plans durchführen. Der Testprincipal muss deutlich sichtbar als **simulierter Testprincipal** gekennzeichnet sein; keine tatsächliche menschliche Identität vortäuschen.
- Dies ist die einzige erlaubte simulierte Freigabe/Testausnahme, keine Dev-Autofreigabe, Testpolicy oder Code-Abkürzung. Jeder Job bleibt bis zur interaktiven UI-Genehmigung `pending_approval`; vorher keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Planbindung, Rechte-, Tenant- und Policyprüfungen bleiben erhalten.
- Audit muss `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr kennzeichnen und Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar zuordnen. Das sind Umsetzungsanforderungen, keine Behauptung bereits vorhandener Auditfelder oder bestandener Tests. Simulation und tatsächliche menschliche Genehmigung getrennt nachweisen; **kein Produktions-Freigabenachweis**.
- KI/MCP dürfen weiterhin **keine direkten API-/DB-Freigaben** vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Normale, über die WebUI ausgelöste Browserrequests bleiben an deren interaktiven Kontext gebunden. Produktionsverhalten und tatsächliche menschliche WebUI-Genehmigung in Produktion bleiben unverändert; die Simulation darf dort nicht verfügbar sein.
- Lokale Serverneustarts sind ausdrücklich erlaubt. Keine impliziten VM-Reboots, Updates oder destruktiven Zieltests; Zieltestumfang weiterhin gesondert ausdrücklich abstimmen. RMM-Jobs behalten ihren festen WebUI-genehmigten Plan.
Die frühere absolute Aussage „keine simulierte Freigabe und keine Testausnahme“ wird ausschließlich für diese browsergesteuerte dev/test-Bedienung präzisiert. Spezifikation 1.5 Kapitel 0.1 ordnet diese Ausnahme den fortbestehenden Produktregeln zu. Linux-first, reale VM-Nachweise, TLS und Credentialregeln bleiben unverändert. Dokumentierte Erlaubnis ist keine ausgeführte Simulation oder Linux-MVP-Abnahme.
## Verständliche Startdefaults
| Bereich | Startwert / Bedeutung |
| --- | --- |
| Architektur | Modularer Rust-Monolith, getrennt startbare API/Gateway/Worker; React/TypeScript-WebUI, PostgreSQL, kein obligatorischer Broker |
| Verbindung | Nur vom Agenten ausgehend: WSS über TLS 443, HTTPS Long Polling als Alternative; mTLS nach Enrollment |
| Kontakt | Heartbeat alle 30 s mit Jitter; nach 90 s `stale`, nach 180 s `unreachable` – kein Beweis, dass das Gerät ausgeschaltet ist |
| Daten | Systemmetriken alle 60 s; Vollinventar bei Start und täglich; Quelle und Datenalter immer sichtbar |
| Genehmigung | Immer erforderlich für Ausführungsjobs, nicht abschaltbar; keine erlaubende Defaultpolicy |
| Fristen | Planfrist ausdrücklich je Plan, UI-Vorschlag 24 h; Startgrant 60 s, nur für festen Versuch, kein neuer Offline-Start |
| Enrollment | Nachweis einmalig, 15 min; Gerätezertifikat 30 Tage, Rotation spätestens nach 20 Tagen beginnen |
| Rollout | Ein Rebootziel gleichzeitig je Abhängigkeitsgruppe; mehr Parallelität nur im menschlich genehmigten Plan innerhalb begrenzender Policies |
| Fehlende Konfiguration | `not_configured`; nur betroffene Integration sperren, keine Werte oder Erfolge erfinden |
Die vollständigen Limits und Plattformabnahmen stehen in der Spezifikation. ARM64 ist bis zur nativen Abnahme geplant, kein MVP-Supportversprechen. Lokale Testidentitäten sind ausschließlich im expliziten Entwicklungsprofil erlaubt, niemals im Produktionsprofil.
## Repository, Infrastruktur und Zugänge
- Repository: <https://gitea.incoso.eu/kevin_janssen/rust-discovery>
- SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`
- Bekannte RustDesk-Serveradresse: `rust.ease-technologies.de`. **Edition, Ports, öffentlicher Serverschlüssel und Version sind noch unbekannt.** Kein angenommenes Standardport-/443-/WSS-Profil und keine erfundene Version; vor Bereitstellung konkrete Konfiguration prüfen.
- Lokaler Zugangspfad: `credentials/` im Projekt, durch `.gitignore` ausgeschlossen und niemals committen. Hier wird nur der Pfad dokumentiert; Secrets werden dafür nicht gelesen. Dateien nur als Daten behandeln, niemals mit `source` oder `eval` ausführen. Keine Secrets in normalen Logs, Jobausgaben oder MCP-/LLM-Kontexte übernehmen.
- Benötigte Entwicklungs-/Testtools dürfen ausdrücklich installiert werden. Daraus folgt keine Genehmigung von Änderungen oder Neustarts auf Kundensystemen. Plattformjobs in Entwicklungsumgebungen behalten die WebUI-Genehmigungspflicht; nur die oben dokumentierte dev/test-Browsersimulation darf die tatsächliche menschliche Bedienung ersetzen. Lokale Serverneustarts sind für diese Entwicklungsabnahme ausdrücklich erlaubt.
## Verbindlicher lokaler Entwicklungsweg
- Regeln für alle AIs: `AGENTS.md`; geplanter, nicht getesteter Ablauf und Nachweisgates: `docs/development.md`.
- Server lokal in Docker auf dem Entwickler-PC; veröffentlichte Ports ausschließlich Loopback, insbesondere `127.0.0.1:18443`. PC initiiert SSH zur VM mit `-N -T -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -R 127.0.0.1:18443:127.0.0.1:18443`. SSH-Hostschlüssel vorher verifizieren, keine öffentliche Forward-Bindung.
- VM-Agent verbindet sich ausgehend über VM-Loopback. TLS bleibt Ende-zu-Ende mit DNS SAN `rmm-dev.internal`; auf der VM `/etc/hosts`: `127.0.0.1 rmm-dev.internal`, alternativ getesteter Connect-Override unter Erhalt von SNI/Namensprüfung. Dev-CA vertrauen, niemals ungültige Zertifikate akzeptieren. SSH nur Dev/bootstrap, kein Ersatz für Enrollment/mTLS, RMM-Autorisierung oder Genehmigung.
- VM-Daten: `credentials/linux-vm.conf`, Verzeichnis durch `.gitignore` ausgeschlossen, Modus 700 für `credentials/`, 600 für die Datei. Strikt als Daten parsen, kein `source`/`eval`; keine Secrets lesen/loggen/committen oder in LLM-Kontexte übernehmen.
- Auch Linux-Dev hat keine Jobfreigabeabkürzung: erst `pending_approval`, dann WebUI-Genehmigung durch einen berechtigten Menschen oder ausschließlich die oben dokumentierte dev/test-Browsersimulation. Passives Standardinventar ist kein Job. Keine impliziten Reboots, Updates oder destruktiven Tests auf dem Ziel; ausdrücklich gesondert abstimmen, RMM-Jobs zusätzlich über ihren festen Plan in der WebUI genehmigen.
- Kein Erfolg ohne realen Nachweis. Geplante Befehle und nicht ausgeführte Tests ausdrücklich so kennzeichnen; fehlende VM-Abnahme bleibt offen.