Files
rust-discovery/docs/mvp-final-audit.md
T
2026-11-13 19:47:22 +01:00

184 lines
14 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.
# Abschließendes Linux-MVP-Audit: weiterhin offen
Lesestand 2026-11-13, Quellbasis `c512bd6`, Spezifikation1.12, insbesondere
0.1/0.3 und25.1–25.4. Dieses Audit liest Quellen, Dokumentation und bereits
gespeicherte Belege. Es hat keine Builds, Tests, Browseraktionen, Netzproben,
Jobs oder VM-/Serveränderungen ausgeführt. Später während der Fortsetzung
entstandene Ergebnisse sind hier nicht vorweggenommen.
Abnahmeumfang: **eine tatsächlich vorhandene Ubuntu24.04-x86-64-Cloud-VM** als
Linux-Client gegen `discovery.ease-technologies.de`; Notebook ausschließlich
Entwicklung. Getrennte passive Lifecycleidentitäten auf derselben VM ersetzen
weder diese Geräteidentität noch deren Jobs oder Wirkungsnachweise. Windows
ist parallel erlaubt, aber kein zusätzlicher Linux-MVP-Abnahmezwang.
Alle positiven Jobfreigaben sind echte WebUI-Klicks der ausdrücklich erlaubten,
sichtbar simulierten dev/test-Identität; kein menschlicher Produktionsnachweis.
## Bereits vorhandene tragfähige Nachweise
| Bereich | Tatsächlich vorhandener Beleg | Grenze |
| --- | --- | --- |
| M0 | Gepinnte Toolchain/Lockdatei, ARM64-Serverbuilds und erhaltende Deployments; frischer isolierter PostgreSQL-Bestand mit Migrationen1–13 dokumentiert | ARM64-Server ist kein ARM64-Agent. CI-Workflow vorhanden; dessen bloße Existenz ist kein CI-Runnererfolg. |
| M1 | Unprivilegierter nativer Agent, Enrollment/mTLS, WSS und ausdrücklich gewähltes HTTPS, Inventar/Heartbeats, tatsächlicher WSS-Reconnect und später bestandener Automatikfallback | Fall697b19ba nach zwei authentisierten503 mit HTTPS-Heartbeat/Sync belegt; keine automatische Rückkehr zu WSS behauptet. |
| M1/AT03 | Auf derselben VM falsche CA/Name verweigert; Rotation mit erhaltenen IDs und tatsächlich neuem TLS-Peer; WebUI-Widerruf mit Kanalfencing; korrekt signiertes abgelaufenes Leaf nativ auf TLS verweigert | Passive Lifecycleprüfung ist keine Job-Genehmigungsentzugsprobe. |
| M2/AT29 | Native Hello-Welt über WSS und HTTPS, separat genehmigte Live-Inventur; bei jedem festen Antrag vor dem UI-Klick 0Jobs/0Outbox/0Grants, danach1/1/1 | Jede weitere Wirkung benötigt ihren eigenen festen Plan. |
| M2/AT07/33 | Native doppelte Offerzustellung und tatsächlicher Verlust eines Ergebnis-ACK; ursprüngliche IDs/Hashes, ein Versuch/Grant/Verbrauch/Wirkung; jeweils gesondert genehmigter Lesejob mit Zähler1 | Nicht als HTTPS-Fault- oder Agentabbruchnachweis ausgeben. |
| M2/Root | Testdienst setup/start/stop jeweils genehmigt und nativ nachgeprüft; genehmigter künftiger Agentjob per MCP vor Start abgebrochen,0Grants | Kein Nachweis eines laufenden Installerabbruchs oder aktiven Offlineagenten. |
| M3 | Begrenzte Root-Logsammlung: feste Unit/300Sekunden/50Zeilen/65536Bytes; vier tatsächliche Zeilen, Quelle/Zeit und bewusst partielle Abdeckung; gespeicherter Job-/Ergebnis-DTO über natürliche UI-HTTP-Antwort und MCP exakt gleich; MandantB verweigert | Kein vollständiger Journalzugriff oder persistenter Cursor behauptet. |
| M4-Vorbedingung | Originaler APT-Versuch durch signierten gebundenen Readonly-Abgleich und normalen RootSync ehrlich als `failed/APT_PARTIAL_UNCONFIGURED_VERIFIED` geschlossen; unveränderlicher Partial-Proof und ursprüngliche Historie erhalten | Fixture1.0 ist lediglich entpackt. Dies ist keine nachträgliche frische Installationsabnahme. |
| Betriebsfähige MVP-Basis | SQLite-Full nativ auf eigener Kopie reproduziert; endliche256MiB-Grenze, neue Agent-/Helperruntime und kopierte Sandboxprobe nativ qualifiziert, keine ursprünglichen DB-/Identitäts-/Providerverluste | Kein Kompaktierungs-/Resetnachweis oder Last-/Langzeitversprechen. |
Gespeicherte Einzelbelege wurden im Audit tatsächlich gelesen:
- `devstate/cloud-acceptance/{00cceed29ed24140860431ebe47d938e,91b7dd32f1e34bd1b358db3251a2c4c6,69cce076b3ef491f87aa17ecc5b13821,58c76f32569442b6a4cc86c58c6f4c4b}/checkpoint.json`
sowie `reconnect.json`: erfolgreiche Basisfälle, exakte Null-/Ausführungszählungen und simulierte Genehmigungsaudits.
- `devstate/cloud-root/cases/{service_setup,service_start,service_stop,query_logs}/checkpoint.json`:
jeweils tatsächlicher Erfolg,1/1/1 und ursprünglicher Planbezug.
- `devstate/cloud-delivery/{4be60da7-fffe-4a49-b42e-ed0c70bdf8b7,66ffd3ef-d4a9-4d98-a786-2c570b9d5d30}/checkpoint.json`:
beide nativen Faultfälle einschließlich separater Postchecks als verifiziert gespeichert.
- `devstate/cloud-lifecycle/118d964c-e7e0-483e-8370-827182d1d645/` und
`expiry-33ddd365-fece-4be4-a3f4-67a9517da69d/`: native Identitäts-/TLS-Lebenszyklen.
- `devstate/cloud-logs/{mcp-read,read-evidence}.json`,
`devstate/cloud-apt-recovery/{readonly-result-first,readonly-central-result,journal-capacity-runtime,journal-capacity-native-ready}.json`.
Öffentlich lesbare Zusammenfassungen und Einschränkungen:
[Implementierungsstand](implementation-status.md), [Deployment](server-deployment.md),
[Zustellungsabnahme](delivery-acceptance.md), [TLS-Ablauf](tls-expiry-acceptance.md)
und [Journalbudget](journal-capacity.md). Private Belege bleiben gitignored;
dieses Audit kopiert keine Rohlogs, Tokens oder Schlüssel.
Der zuletzt vom ausführenden Hauptagenten gemeldete abgeschlossene Snapshot
lautet Rootledger10Verbräuche/0offen/0Faults, zentral19Jobs/19Outbox/17Grants/0offen
nach erhaltender Installation von Agent`2ce885cf…`/Helper`332eae00…` bei
unverändertem Provider`5ff260f7…`. Dies ist ein zeitgebundener Snapshot, keine
Liveabfrage oder Aussage über nachfolgend neu beantragte Pläne.
## Verbleibender nativer Abschlussumfang
1. Neuer eigener Configure-only-Plan auf der qualifizierten Runtime: exaktes
Paket1.0 konfigurieren und vollständig unabhängig nachprüfen; separate
Recoverybelege, alte Marker/History unverändert. Danach eigener Upgradeplan
1.0→1.1 samt runtimegebundener Acceptance sowie getrennte, ehrliche
`ensure_package`-/`apply_updates`-Noops auf1.1. Abgelaufene frühere Pläne
bleiben historische Misserfolge ohne Grant und werden nicht reaktiviert.
2. Die drei vorbereiteten aktiven Offlinefälle: kein Start über`not_before`
ohne Verbindung; Wiederkontakt innerhalb Frist mit genau einem Grant;
Ablauf und tatsächlicher WebUI-Planwiderruf jeweils ohne Grant/Wirkung.
Ein Agentstopp allein ist kein Offlinebeweis.
3. Kontrollierter Agentprozessabbruch nach möglicher Wirkung: dauerhafter
Unknown, unveränderter Verbrauch, unabhängiger Helperabschluss und signierter
Abgleich ohne erneute Wirkung. Die lokale Startupkorrektur ist installiert,
der native Crashfall bleibt gesondert offen.
4. **Inzwischen bestanden:** tatsächlicher automatischer WSS-Ausfall mit
erlaubtem HTTPS und normaler Wiederherstellung, ohne TLS-Abkürzung.
Tatsächliche Details und offengelegte Auswertungskorrektur desselben Falls
in[transport-acceptance.md](transport-acceptance.md).
5. Reboot zuletzt: eigener fester WebUI-Plan, alte/neue Boot-ID,
authentisierter Wiederkontakt, neue Inventur, signierter Sync und gebundenes
endgültiges Ergebnis. Kein SSH-Reboot als Ersatz.
Späterer tatsächlicher Configure-Versuch: Der eigene WebUI-genehmigte Plan
erhielt Grant `33775478-15b0-46ec-b059-44f500dbb0b6` (Rootverbrauch11).
Der gespeicherte Checkpoint steht ehrlich auf `unknown`, mit1Job/1Outbox/1Grant
und einer ungeklärten Wirkung. Die gebundenen Hook-/Sandboxbelege zeigen
Handoff und APT-Exit0, privates Sandbox-`reboot_required=false`. Der Provider
verwarf danach die Abnahme mit `FIXTURE_UNEXPECTED_REBOOT_REQUIRED`, weil er
das aktuelle Hostflag pauschal als Fehler behandelte. Seine damaligen
PrechecksSchema1 enthalten keine Host-Vorherbeobachtung. Deshalb wird dieser
Versuch **nicht rückwirkend als erfolgreiche Native-Acceptance ausgewiesen**.
Eine neue rein lesende, signiert abgeglichene Klassifizierung muss die
historischen Bytes und tatsächlich installierten Nachbedingungen zuerst
prüfen; weder Wiederholung noch Flag-/Markerreset sind zulässig. Für neue
Runtimejobs muss das Hostflag vor/nach der Wirkung getrennt vom privaten
Sandboxflag erfasst werden. Kapitel0/Ergebnisvertrag erlaubt ein vollständig
verifiziertes Paket mit `reboot_required=true`; ein ungeplanter Reboot bleibt
verboten. Dieser Fehler ist ein offener MVP-Abnahmepunkt, kein Post-MVP-Feature.
Adapterdateien oder `prepared`-Zustände schließen diese Gates nicht ab. Beim
ursprünglichen Lesestand fehlten Offline-/Transport-/Crashbelege. Inzwischen
liegt für den Transportfall697b19ba ein verifiziertes`completion.json` vor;
Offline und Crash bleiben offen.
## M5 auf der tatsächlich endlichen Zielmenge
Die vorhandenen MCP→Plan→Submit→UI→Hello-/Inventur-/Rootdienstabläufe belegen
reale feste Einzelzielpläne einschließlich Skriptbytes, Ziel-/Versuchsbindung,
`max_parallel=1`, Nullgate und eigener Ergebnisse. Derselbe Submit mit denselben
Plänen/Idempotenzschlüsseln wurde laut Deploymentprotokoll tatsächlich erneut
gelesen und erzeugte dieselbe Operation, keine neuen Jobs. Lokale Backendtests
decken zusätzlich geänderten Inhalt mit demselben Schlüssel ab.
**Noch als finalen, rein lesenden Referenzbericht zusammenführen:** berechtigter
MCP-Kunde und gespeicherte Geräteliste mit Kontakt/Speicher/Datenalter; daraus
die ausdrücklich ausgewählte, verfügbare Linux-Testzielmenge genau`{asset_id}`;
ursprünglicher Hello-/Inventurplan und späterer Rebootplan mit genau dieser
Zielmenge; `jobs.get(operation_id)` mit`planned_job_count`, tatsächlicher
Jobanzahl, Zustandszählern und zutreffender Aggregation. Vorhandene Submit-
Idempotenzbelege daran anbinden. Dafür ist kein weiterer Wirkungsjob nötig.
Dafür ist `deploy/cloud_mcp_reference_report.py` vorbereitet: ausschließlich
gespeicherte MCP-Lesewerkzeuge, paginierte berechtigte Geräteliste, ausdrücklich
festes Cloudziel, ursprüngliche verifizierte Checkpoints und deren aktuelle
Operationsaggregate. `--checkpoint` nimmt vorhandene Hello-/Inventur-/Dienst-
und später Rebootbelege an; `--output` verlangt eine neue private Datei unter
`devstate/`. Tatsächlich bisher nur Python-Syntaxprüfung und `--help`, **kein
MCP-Lauf**. Die optionale Idempotenzreceipt muss einen gesondert tatsächlich
beobachteten Submit desselben `offline_wait`-Plans mit exakt ursprünglichem
Nonce innerhalb der ursprünglichen Frist, dieselbe Operation und unveränderte
1Job/1Outbox/1Grant belegen. Der Report führt selbst keinen Submit aus; ohne
Receipt steht dieser Teil ausdrücklich auf `not_attached`.
Ein Sammelplan über genau ein freigegebenes reales Ziel ist für diesen
verfügbaren Aufbau zulässig. Er beweist **keine** Mehrgeräteparallelität,
Mischplattformausführung oder gemischte Mehrziel-Teilergebnisse. Zusätzliche VMs
oder Windows-Executor allein für eine größere Demo sind kein MVP-Gate.
Unknown muss bereits bei einem Ziel`needs_attention` bleiben; abgelaufen oder
abgebrochen bedeutet niemals Erfolg. Die vorhandene Aggregationslogik in
`crates/server/src/jobs.rs` trennt Antrag und Ausführung entsprechend.
## Negativnachweise und DoD-Grenze
Keine zusätzliche breite Testsuite erforderlich: die bereits qualifizierten
lokalen/isolierten Prüfungen für RLS ohne Kontext, Pool-/Transaktionswechsel,
fremde Objektpfade, Signatur-/Plan-/Attempt-/Generationsmanipulation, alte
Telemetrie, begrenzten Output/Batchgrößen und Backpressure sind passende
Nachweise dieser Sicherheitsverträge. Native A/B-Verweigerungen für reale
Geräte, Jobs und Logs ergänzen sie. Quellen: `tests/local_integration.py`,
`backend_contract.py`, `backend_sync.py`, `backend_transport.py`,
`backend_root_logs.rs`, Agent-/Helper-Reconciletests und Web-Safetytests.
Sie sind keine nativen Clone-/Destruktiv-/Last-/Mehrgeräteabnahmen.
Der direkte Freigabeendpunkt ist auch ohne MCP-Genehmigungswerkzeug geschützt:
Backendtests verweigern Bearer und Bearer+Browsercookie; der dokumentierte
lokale OIDC-Lauf (`tests/oidc/README.md`,35Assertions) prüfte dies sogar mit
`plans:approve` in Scope und Mitgliedschaft. Das schließt die technische
AT30-Grenze; es ist keine echte OIDC-Betreiber-/Produktionsfreigabe.
**AT12, nachträglich lokal geprüft:** Der tatsächliche `JsonView` rendert
feindliche Logzeichenfolgen mit HTML, Script, simuliertem POST und einer
Freigabeanweisung als React-Text. Der einzelne Test in
`web/src/json-view.test.tsx` prüft die vollständige Elementliste
(`details`/`summary`/`pre`), fehlende ausführbare Elemente/Freigabecontrols und
null Fetch-Aufrufe. Tatsächlich ausgeführt: genau dieser Test (1 bestanden),
Typecheck und Webbuild; der erzeugte Bundle-/Indexinhalt blieb unverändert.
Der Entrypoint ist dabei gemockt, der echte Renderer wird verwendet. Das ist
kein VM-Log-Injektionsversuch oder allgemeiner MCP-/KI-Autoritätsnachweis.
Die getrennten Plancheckbox-, Bearer-/Cookie-Deny- und Backendtests tragen
weiterhin die Genehmigungsgrenze.
Für25.4 bleibt nach den obigen nativen Schritten ein kurzer Endabgleich nötig:
passende Quellen-/Artefaktpins und betroffene Checks, aktuelle Capabilitymatrix,
keine ungeklärten Wirkungen, README/Status/Gates konsistent, letzte tatsächliche
Ergebnisse dokumentiert und gepusht. README-Kurzstatus und
`platform-support.md` stehen noch auf1.9/„APT unknown“; die Übersicht am Anfang
von`mvp-gates.md` nennt bereits bestandene Teilgates weiterhin offen. Das sind
konkrete Dokumentationslücken, kein Grund, erfolgreiche native Wirkungen zu
wiederholen. Im gelesenen Gitindex sind`credentials/` und`devstate/` nicht
getrackt; eine vollständige Secret-/Historienprüfung wird dadurch nicht behauptet.
Nachgelagert bleiben Windows-Jobausbau, weitere Agentplattformen/Paketrezepte,
PVE/PBS/Cluster/Backups, allgemeines Monitoring/Alarmierung, interaktives Terminal,
produktiver IdP-/HA-/Update-/Restore-/Lastbetrieb und sichere Kompaktierung.
RustDesk bleibt ausdrücklich ausgelassen. Diese Punkte sind weder bestanden
noch zusätzliche Linux-MVP-Blocker; Details in[post-mvp.md](post-mvp.md).