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

287 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Übergabe / Entwicklungspause — 2026-11-12
**Aktuellster nativer Stand:** Agent702bd7b5 korrigiert wiederholten Nichtstart-
Sync nach abgelaufenem grantlosen Auftrag. Erhaltend installiert; normaler
Generation93-Sync ready/restore_blockedfalse, gleicher Ablaufjob korrekt
expired/DEFINITIVE_NONSTART, kein Grant/Unlock. Zentrale26/26/23/0, Root15closed.
Keine Server-/Helper-/Provideränderung, M4Runtime3bac bleibt gültig. Aktiver
Offline-Warte- und Ablauffall sowie MCP-Vorbericht bestanden; Generalautostart
nachgewiesen aktiviert, öffentlicher Pinbootstrapfinalisiert. Noch UI-Entzug,
Crash und letzter einzelner Reboot plus Endaudit. Ältere Sperrstände historisch.
**Neuester abgeschlossener Stand:** M4-APT im begrenzten Fixtureumfang bestanden:
echtes1.0→1.1-Upgrade plus eigene ensure_package-/apply_updates-Noops, feste
WebUI-Grenze jeweils0/0/0→1/1/1/0. Tatsächliche Paketnachbedingungen, true→true
Hostflag/kein neuer Rebootbedarf, keine zusätzliche Noop-Pakettransaktion.
AltefailedVersuche unverändert. Runtimef40c/bbd2/1dc/3bac bleibt qualifiziert.
APT-Policygeschlossen/Endpunktentfernt/Helperinactive; Agent/Generalaktiv.
Server73aab983 enthält konservative Rebootfrist, nativdeployt/Historieerhalten.
Nächste Arbeit: Offline3, Crash, MCP-Endbericht, einzelner Reboot zuletzt,
danach Endaudit. Nicht vollständig MVP-abgenommen.
**Neuester tatsächlicher Stand2026-11-13:** Configure337 jetzt durch gebundenen
Readonly-Nachweis und normalen signierten RootSync geschlossen: failed
`APT_RECOVERY_CONFIGURED_ACCEPTANCE_REBOOT_FLAG_VERIFIED`, vollständige Wirkung,
keine nachträgliche erfolgreiche Acceptance. Hostflagtrue/historischvorhernull.
Root11/0offen/0Faults, zentral20/20/18/0. Native erhaltende Runtimef40c/bbd2/1dc
und copied-Sandboxprobe bestanden; APTinactive/Endpunktentfernt/Policygeschlossen.
SSH40s-Timeout verlor nur Antwort, unabhängiger erhaltener Endbericht und
Dateihashes bestätigten abgeschlossene Installation; keine Wiederholung.
Nächster Schritt eigener UI-Upgradeplan1.0→1.1, danach Noops und übrige Gates.
Details oben in implementation-status.md; ältere Unknownzustände unten historisch.
**Aktuelle Fortsetzung2026-11-13:** Automatischer WSS→HTTPS-Fallback auf der
permanenten Cloud-VM bestanden; Hook wieder deaktiviert, WSS operativ
wiederhergestellt, keine neuen Jobs. Danach eigener Configureplan tatsächlich
einmal ausgeführt, APT0/dpkg installed1.0, aber Abnahme wegen globalem
Neustartmarker verweigert: Grant33775478-15b0-46ec-b059-44f500dbb0b6 unknown,
Rootverbrauch11. Fehlender Host-Vorherwert bleibt fehlend; keine rückwirkende
Acceptance. Rootpolicy deny-only geschlossen, kein Retry/Markerreset/Reboot.
Gebundener Readonly-Abgleich wird implementiert. Spec1.13 präzisiert getrennte
Host-/Sandboxbeobachtung und konservative zentrale Rebootfrist. Tatsächlicher
MCP-Lesebericht eines bestehenden Dienstplans bestanden, Idempotenz noch nicht
angehängt. Offline/Crash/APT1.1/Noops/finaler Reboot und Endaudit weiter offen.
Ältere Zustände unten bleiben historische Snapshots.
**Neuester aktiver Stand2026-11-13:** Scope-Replayfix und TLS-Lifecycle einschließlich
nativ abgelaufener Clientcerts bestanden. UI-Schema4 geprüft/publiziert;
Configure-only-Plan tatsächlich genehmigt, aber ohneOffer/Grant expired an
64MiB-Helperjournalgrenze. Isoliert SQLFull reproduziert, bounded256MiB-Default
auf Cloud-VM mit allen Historien/Identitäten/DBinodes erhalten installiert.
Agent2ce885cf/Helper332eae00/Provider5ff260f7, normaler signierterSync bereit,
Root10/0offen/0faults, Zentrale19/19/17/0, Rootpolicygeschlossen/APTinactive.
Neuer eigener UI-Configureplan im Namensraum `capacity-recovery` erforderlich;
Paketwirkung noch NICHT ausgeführt. Details oben in implementation-status.md;
MVP weiterhin offen, kein Produktionsfreigabenachweis. Ältere Zwischenstände
bleiben historisch und werden nicht als aktuelle Runtimepins verwendet.
**Neuester Stand 2026-11-13, Arbeit ausdrücklich fortgesetzt:** Signierte
Kontrollkettenreparatur auf tatsächlicher Cloud-VM bestanden. Anschließender
Readonly-APT-Nachweis plus normaler RootSync schloss ursprüngliche Teilwirkung
als `failed / APT_PARTIAL_UNCONFIGURED_VERIFIED`; Fixture1.0 nur unpacked,
Nachbedingungen false, keine Paket-Acceptance. Ledger9/0offen/faultfrei,
Zentrale13/13/12/0. Agent988c62fd/Generalhelper5ad30cdf/Provideredd1950d aktiv;
APT-Helper inactive/Endpunkt entfernt, Rootpolicy geschlossen. Identität,
Journale, Ledger und alte Marker erhalten. Neue Configure-only-UI-Wiederherstellung,
Upgrade/Noops und weitereMVP-Gates offen. Ältere Unknown-/Pauseabschnitte unten
sind historische Snapshots. Tatsächliche Details: `implementation-status.md`,
aktuelle Prioritäten: `mvp-gates.md`.
**Aktueller Arbeitsstand 2026-11-13:** Windows-Passivstrecke auf tatsächlichem
Gast bestanden: LocalService, Enrollment/mTLS/WSS, gespeichertes Inventar,
zwei Heartbeats, Tenant-B-Verweigerung und sieben native Tests. Native SQLite-
Probe Integrität ok, gleiche Identität, 0 ausstehende Inventarereignisse. Migration
0013 nativ auf endgültigem Server angewendet, RLS/FKs/alte Beobachtungen erhalten.
Windows ohne Jobexecutor, unsignierter Entwicklungsbuild, übrige Grenzen in
`deploy/windows/CLIENT.md` und `docs/platform-support.md`.
APT bleibt **unknown**: gespeicherter Lauf Hook armed/APT 0, Fixture1.0 nur
unpacked, kein Configure/Acceptance. Ledger 9 / 1 unresolved, Zentrale 13/13/12/1,
Originalmarker/History + eigener Retrymarker erhalten. Rootpolicy geschlossen,
keine weiteren Paketjobs/Reparaturen/Resets. Configure-Korrektur ausschließlich
lokal nachgewiesen (67 Python-Tests, echtes APT2.6.2 mit simulierendem dpkg),
**nicht auf Cloud installiert**. Cloudprovider weiterhin 465ac5ed…, neue Source
3977c2c0…; Pins nicht vermischen. Signierter prüfender Abgleich und begrenzter
neuer UI-Wiederherstellungsplan erforderlich. Servermigration bewahrte die
exakten Unknown-Nachweise/Zähler vor/nach Neustart. Details oben in
`implementation-status.md`. Nachweise/Quellen nach jedem Schritt gepusht;
private Daten gitignoriert. Ältere Abschnitte sind historische Snapshots.
**Aktueller Folgestand 2026-11-13:** APT-100-Ursache durch separat WebUI-genehmigte
Cloud-Diagnosen belegt: `--no-download` lieferte im echten v3-Hook `**ERROR**`
statt Archivpfad. Lokale Dateiacquisition korrigiert; wirkliche IPv4-/IPv6-Sperre
zusätzlich geprüft. Neuer Provider/Helper auf Cloud-VM installiert, echter
Readiness-Probe bestanden. Acht bekannte Rootversuche, keine offene Wirkung,
ursprünglicher Fehlversuchsmarker/`active/` erhalten, kein Paketretry. Root-
Diagnosepolicy geschlossen, APT-Helper gestoppt, Linux-Agent online/sync-ready.
Paketabnahme benötigt weiterhin sichere Behandlung des gespeicherten Fehlversuchs.
Windows auf Userwunsch jetzt parallel erlaubt (Spezifikation 1.8). SSH-Zugang
zur Windows-11-Pro-VM (Build 26300, x64) mit echtem Administratortoken nativ
bestätigt. SYSTEM-Tunnel-Task/sshd Running, Windows-SSH nur Loopback; Cloud-
Reverse-Port nicht extern erreichbar. Kein RMM-Windows-Client/Notebook-Agent.
Bootstrap/Repair öffentlich gültiges HTTPS8443, befristet bis 2026-11-14
12:55:31 UTC, automatisches Schließen des Downloadports vorbereitet/geprüft.
Nach jedem Abnahmeschritt Quellen/Dokumentation nach Gitea gepusht; private
Daten weiterhin ignoriert. Details: [implementation-status.md](implementation-status.md)
und [Windowszugang](../deploy/windows/README.md). Die folgenden Pausentexte und
älteren Zwischenstände sind historisch, keine aktuelle Entwicklungsstopanweisung.
**Historische Übergabe. Wiederaufnahme am 2026-11-13 ausdrücklich beauftragt.**
Die lokale Servertopologie wurde inzwischen durch den dedizierten Internetserver
ersetzt; aktueller Zustand und Zugänge: [server-deployment.md](server-deployment.md).
Der unten genannte Skript-/SHA-Konflikt ist korrigiert. Alte Nachweise bleiben
historisch; neue getrennte Testidentitäten sind keine Wiederherstellung der alten
Serverhistorie. Aktueller Prüfstand: [implementation-status.md](implementation-status.md).
**Neuester Cloud-Stand 2026-11-13:** Root-Testdienst eingerichtet/gestartet/gestoppt,
jeweils tatsächlich separat WebUI-genehmigt und auf VM bestanden. Erste APT-
Acceptance `failed / HOOK_NOT_HANDED_OFF`, APT 100 vor Hookübergabe, Paketbestand
unverändert. Kein Wiederholungsversuch; Create-once-Marker und Ledger erhalten.
Root-Testpolicy geschlossen, APT-Helper gestoppt/deaktiviert; Cloud-Agent aktiv,
Notebook ohne Client. Cloud-Controlpfad-Maskierungsfix nur im Quellcode/lokal
geprüft, neue VM-Readiness und sichere Weiterführung des gespeicherten Fehlversuchs
offen. Details und Belege in [server-deployment.md](server-deployment.md#root--apt-abnahmelauf-2026-11-13).
**Auf Userwunsch pausiert. Linux-MVP M0–M5 ausdrücklich NICHT vollständig
abgenommen; keine Produktionsfreigabe.** Dieser Durchgang sichert Dokumentation
und prüft veröffentlichbare Quellen. Keine Entwicklung, Builds, Tests,
Deployments oder RMM-Jobs fortsetzen. Commit/Push ist ein separater Schritt des
Orchestrators nach Sicherheitsprüfung; hier weder Staging noch Commit/Push.
## Einstieg und verbindliche Grenzen
- Repository: <https://gitea.incoso.eu/kevin_janssen/rust-discovery>;
SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`.
Remote vor Veröffentlichung erneut prüfen; keine erfolgreiche CI behaupten.
- Zuerst vollständige Spezifikation 1.5, `AGENTS.md`,
`docs/project-decisions.md` und `docs/development.md` lesen. Windows erst nach
Linux-MVP-Abnahme; PVE/PBS/Cluster/Backups nachgelagert. **RustDesk AUS**,
keine Installation/Provisionierung/Desktopabnahme oder eigene Desktop-Engine.
- Jeder Job beginnt als persistenter Antrag `pending_approval`. Vor Genehmigung
**0 Jobs/Outbox/Startgrants**, keine JobOffers/Wirkung. Nur interaktive WebUI
genehmigt den unveränderlichen Plan; MCP/KI dürfen nicht selbst genehmigen,
keine direkte API-/DB-Freigabe. Policies begrenzen/verweigern nur.
- Dev/test-Browserbedienung ausschließlich sichtbar **SIMULIERT**, Audit mit
`approval_origin=dev_test_browser_simulation`, `testsimulation=true`,
Testprincipal und Planbezug. Kein menschlicher Produktionsfreigabenachweis.
Neue Versuche/neue Wirkung brauchen neuen genehmigten Plan; unklare Wirkung
bleibt `unknown`, nicht blind wiederholen.
## Plattform und sicherer finaler Pausenzustand
Server lokal in Docker auf dem PC, TLS nur `127.0.0.1:18443`, PostgreSQL intern
ohne publizierten Port. PC-initiiertes SSH im Devmodus: `-N -T`, strikte
Hostkeyprüfung, `ExitOnForwardFailure=yes`, Keepalive 30/3 und
`-R 127.0.0.1:18443:127.0.0.1:18443`. VM-Agent ausgehend über Loopback;
TLS Ende-zu-Ende mit vertrauenswürdiger Dev-CA und SAN/SNI `rmm-dev.internal`.
Connect-Override darf nur TCP ändern, niemals Namens-/Zertifikatsprüfung.
Netzwerkagent unprivilegiert als `rmm-agent` (UID 993, Gruppe 984), Roothelper
separat; kein Root-Netzwerkagent.
**Finales VM-Worker-Verdikt, in `docs/implementation-status.md` protokolliert:**
- Agent und beide Helper (`rmm-agent.service`, `rmm-helper-dev-test.service`,
`rmm-apt-helper.service`) **inactive**; kein Reversetunnel/VM-18443-Listener.
- Rootledger **0 consumed / 0 unknown**, kein laufender Installer-/Paket-/Rebootjob.
Einziger VM-Joberfolg bleibt der frühere Hello-World-Lauf; keine neuen Jobs,
Anträge oder Genehmigungen im letzten Upgrade-/Pauselauf.
- Lokaler Docker-Server und PostgreSQL laufen bewusst weiter, Portbindung wie
oben. Kein pauschales „alles gestoppt“. Letzter zuvor gemeldeter Serverstart
20:49:18 UTC ist kein hier erneut erhobener Startzeitnachweis.
- Aktuelle Bookworm-Releaseartefakte für Agent/Helper gebaut und konkrete
VM-Loaderprüfung bestanden (glibc 2.34/OpenSSL 3). Runtimeupgrade bewahrte
Identität und Journal-Dateibytes/SQLite-Schema/Rows. Alte Artefakte/Backups bleiben.
- Bekannte Fixturearchive administrativ versiegelt, **keine Paketinstallation**.
Tatsächliche dedizierte APT-Probe **FEHLGESCHLAGEN**:
`APT_CONTROLLER_PROFILE_REQUIRED`, Start-Exit 1. Keine Native-Readiness,
Native-Acceptance oder Paketwirkung; Helper danach kontrolliert gestoppt.
Unit-Härtung wurde nicht zur Umgehung gelockert.
## Funktionen und Nachweise — Ebenen nicht vermischen
| Bereich | Lokal / Entwickler-PC | Tatsächliche Linux-VM |
|---|---|---|
| TLS/Enrollment/Inventar | Lokale Integrationsnachweise vorhanden | Passives Inventar und Heartbeats früher belegt |
| MCP → UI → Grant → Agent | Gemeinsame Plan-/Antragsstrecke implementiert | Früherer Hello World unter unprivilegiertem systemd-Agent: genau 1 Grant, 1 Wirkung; Journal/Ergebnis belegt |
| Roothelper | Neue Root-/APT-/Sync-Schnittstellen implementiert | Readiness des **alten** Profils belegt; neues Runtime installiert, APT-Probe fehlgeschlagen, keine vollständige Rootaktionsabnahme |
| Paket/Update/Dienst/Reboot | Adapter und Sicherheitsprüfungen vorhanden | Aktuelle UI-genehmigte native Wirkungskette weiterhin offen |
| OIDC/WebUI | OIDC-Adapter implementiert, externe IdP-Konfiguration `not_configured`; Dev-UI-Testactor simuliert | Kein produktiver IdP-/MVP-Abnahmenachweis |
| Replay/ACK-Verlust | Lokale Regressionspfade vorhanden | Native Fault-Injection für duplicate_offer/lost_result_ack **unsupported**, nicht grün |
Letzte getrennte, von den jeweiligen Sourceownern dokumentierte Prüfstände,
**in dieser Übergabe nicht erneut ausgeführt und nicht zu einer Summe addieren**:
- Client: **115 Rust-Alltargets-, 56 Python-APT-, 2 Installer-Guardtests**;
Clippy/Format, Debug/Release grün (`deploy/linux/runtime-README.md`). Dies ist
der letzte vollständig validierte Client-Quellstand, nicht „alles aktuell grün“.
PC-Artefakte sind nicht mit dem separaten Bookworm-/VM-Loaderbeleg gleichzusetzen.
- UI: zuletzt **23 Unit- und 5 TLS-Browsertests** gemeldet; OIDC **13 + 1 PG**
sowie **35 integrierte Assertions**. Backend **150 Assertions**, Transport
**38**, Rootlog **15** als bestehende getrennte Snapshotnachweise. Verträge und
Prüfkontext: `web/README.md`, `crates/server/OIDC.md`, `tests/oidc/README.md`,
`proto/BACKEND_CONTRACT.md`. Keine neue Ausführung/CI-Verifikation in der Pause.
- Backend zuletzt mit Rootlogs-Image/Migrationen 1–12 gemeldet; Runtime-/VM-Probe
ist ein separater Nachweis und macht offene Funktionstests nicht erfolgreich.
## Bekannter ungeprüfter Snapshotfehler — NICHT jetzt korrigieren
Die letzte Änderung der `SERVICE_SETUP`-Skriptbytes in
`deploy/vm_mvp_adapters.py` für den vorerzeugten leeren Unit-Inode wurde **nicht
erneut getestet**. Alte SHA-Pins stehen noch in
`tests/browser/mvp-actions.spec.ts` (service_setup-Prüfung) und
`tests/vm_mvp_guards.py` (Setup-Hashassertion). Bei Wiederaufnahme zuerst Bytes,
Browser-Pin und Guard-Pin konsistent anpassen und gezielt prüfen. Frühere
**28 Guards** sind **kein finaler Nachweis** dieser Änderung. Absichtlich keine
Reparatur im angeforderten Pause-/Snapshotdurchgang.
## Wiederaufnahme — erst nach neuem Auftrag, nichts davon hier ausgeführt
1. Erhaltenen Zustand und feste Geräte-/Job-/Versuchsbindung kontrollieren.
Den tatsächlichen Controllerprofilfehler gegen `verify_controller_profile()`
**zuerst diagnostizieren**, vor weiteren Mutationen/Proben. Keine Härtung,
Capability-, Peer-, Pin-, Sync- oder Genehmigungsgrenze blind abschwächen.
Den oben dokumentierten Skript-/SHA-Konflikt vor Suiteausführung beheben.
2. Bookworm-Artefakt/Deploymentmanifest, tatsächliche Unit-/Public-Pins,
getrennte Helperledger und dedizierte RPC-/APT-Readiness prüfen. Build und
Loadercheck liegen vor, Native-APT-Probe dagegen nicht bestanden.
3. Frischen Peer-/Sync-/passiven Planungsnachweis und aktuelle Baseline erheben;
anschließend einzeln UI-genehmigte Rootdienst-/Paket-/Updatefälle. Fixture
nach Upgrade auf **1.1**, fresh baseline und gewünschte Noop-Nachbedingungen
konsistent halten; keine heimliche Entfernung/Downgrade/Reset von Paketstate.
4. HTTPS-Transport, Rotation, Reconnect, Ablauf/Cancel, Reboot zuletzt mit eigener
Recovery und neuer Boot-ID sowie tatsächliche Wirkung/Nachprüfung abnehmen.
Duplicate-/lost-ACK-Nativefaultadapter fehlen weiterhin; nicht durch zweiten
Job als vermeintliche Redelivery ersetzen. Vor jedem Job erneut 0/0/0-Gate.
5. Linux-MVP erst nach vollständigen realen Feature-/Fehlernachweisen abnehmen.
Bestehende Identität/Journale/Backups niemals löschen oder neu enrollen, um
Tests grün zu machen. Create-only Bootstrapphasen nicht blind wiederholen.
## Quellnavigation, Befehle und geschützte Evidenz
- Agentbetrieb/Config: `deploy/linux/runtime-README.md`, `deploy/linux/README.md`;
APT: `deploy/linux/apt-helper-README.md`,
`tools/apt-transaction/HELPER-CONTRACT.md`; Backend/Rootlogpolicy:
`proto/BACKEND_CONTRACT.md` (`RMM_ROOT_LOG_UNITS` und zugehörige Grenzen,
Rootlogs standardmäßig verweigert); Login: `crates/server/OIDC.md`.
- Bestehende Kernbefehle in `README.md`: `python3 deploy/dev.py init|up|status`,
CA-verifizierter `/healthz`-Check und `python3 deploy/dev.py down` ohne
Datenlöschung. **Hier nur nachgelesen, nicht ausgeführt.** `init` überschreibt
keinen vorhandenen Zustand; `up` baut/startet und ist keine Pauseaktion.
Die älteren Funktionsaussagen in README/unteren Statusabschnitten sind
historische Slices; aktueller finaler Pauseabschnitt hat für diesen Snapshot Vorrang.
- Geschützt/gitignored: `devstate/vm-jobs/result.json` (Hello World),
`devstate/vm-root/` (historische Rootreadiness),
`devstate/vm-final/68741ab0b1c84e15bf3fc442bd812558/`
(`build.json`, `install.json`, `probe-diagnostic.json`; kein erfolgreicher probe.json).
VM-seitig: `/var/lib/rmm-bootstrap-history/68741ab0b1c84e15bf3fc442bd812558/`
und `/etc/rmm/runtime-v2-probe-report.json`. Nur Pfade, keine privaten Inhalte.
- Zugangsdaten/Rohlogs/Schlüssel bleiben unter `credentials/`, `.env`,
`secrets/`, `devstate/` bzw. geschütztem VM-State. Nie in Git/Chat/Jobausgaben;
0700-Verzeichnisse/0600-Secretdateien, Daten strikt parsen, kein source/eval.
Keine VM-Adressen, Passwörter, privaten Agentkeys oder Tokens veröffentlichen.
- Vor Staging ausschließlich nichtignorierte Quellpfade aus
`git ls-files --cached --others --exclude-standard` prüfen; echte PEM-Blöcke,
Credentialliterale, private Laufzeitdateien/Adressen und Browsertraces melden
**nur als Anzahl, Pfad, Regel**, niemals Matchzeilen. Build-/Browsercaches nicht
veröffentlichen. `.env.example` mit Platzhaltern und generierte Testfixtures
sind nicht automatisch echte Zugangsdaten. Keine Userdateien verschieben/löschen.
### Sicherheitsprüfung dieses Übergabedurchgangs
Nichtignorierte Sourcepfade: **194**, alle 194 auf echte vollständige private
PEM-Blöcke, auffällige Credentialliterale/Providertokens, nichtbeispielhafte
IPv4-Adressen und private Laufzeit-/Binärdateinamen geprüft. **Keine bestätigten
Leakfindings.** Ein Literal-Kandidat in `crates/oidc-auth/src/tests.rs` wurde als
ungenutzter synthetischer Access-Token der lokalen Mock-Providerantwort geprüft
und verworfen; Schlüssel der Tests werden zur Laufzeit generiert. Keine
Credentialdateien für diese Prüfung gelesen, kein Secretvergleich erforderlich.
Das ist eine heuristische Sourceprüfung, keine Garantie über unbekannte Secrets.
Ignore-Ausschluss ausdrücklich bestätigt für `crates/oidc-auth/target/`,
`devstate/`, `credentials/linux-vm.conf`, `web/node_modules/`, lokale
Testresults/Playwrightreports. Root-Ignore ergänzt um verschachtelte `target/`
und präzise private Browsertrace-/Reportpfade. Keine Source-/Testverzeichnisse
pauschal ausgeschlossen. Vor tatsächlichem Staging erneut prüfen, da parallele
Änderungen diesen Snapshot verändern können.