Files
rust-discovery/docs/mvp-gates.md
T
2026-11-13 20:12:30 +01:00

147 lines
15 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.
# Linux-MVP: Abnahmegates
Stand 2026-11-13, ursprüngliche Auditbasis `d38d93d`, Spezifikation 1.12. Die
Bestandsaufnahme selbst hat keine Tests, Jobs oder Deployments ausgeführt;
anschließende tatsächliche Nachweise sind unten ausdrücklich ergänzt. Einzelbelege und spätere
Ergebnisse stehen im [Implementierungsstand](implementation-status.md).
Ziel ist M0–M5 auf der tatsächlichen Ubuntu-24.04-x86-64-Cloud-VM gegen
`discovery.ease-technologies.de`. Das Notebook bleibt Entwicklungsrechner.
Windows ist separat passiv abgenommen und kein zusätzlicher Linux-MVP-Blocker.
RustDesk ist ausgeschlossen; M6–M8 werden nicht vorgezogen.
Nach jedem Teilerfolg: Ergebnis samt Grenzen und Beleg speichern, Quellen und
Dokumentation pushen, diese Liste erneut prüfen und das nächste offene Gate
bearbeiten. Ein grüner Build oder ein einzelner erfolgreicher Job schließt das
MVP nicht ab. Neue Entdeckungen außerhalb dieser Gates kommen nach
[post-mvp.md](post-mvp.md).
## Bereits belegte Strecken
| Paket | Implementiert / lokal geprüft | Tatsächliche Cloud-Linux-Nachweise | Gesamtabnahme |
| --- | --- | --- | --- |
| M0 | Workspace, gepinnte Toolchain, Migrationen, RLS, explizite Dev-Identitäten; frischer isolierter PG-Bestand mit Migrationen 1–13 geprüft | ARM64-Serverbuilds, Loopback-Dockerports, interne DB, privater Verwaltungszugang; laufende Gerätehistorie erhalten | Abschließende Dokumentations-/Sourceprüfung mit aktuellem Stand erforderlich |
| M1 | Enrollment, TLS/mTLS, WSS/HTTPS, Zertifikatsstore/Rotation, Inventar und Quelle/Zeit | Unprivilegierter systemd-Agent; Inventar/Heartbeats; Rotation mit echtem Peerwechsel; CA-/Name-/Ablaufverweigerung; UI-Widerruf; tatsächlicher automatischer WSS→HTTPS-Fallback | Begrenzter dev/test-Cloudumfang bestanden; kein Produktionsfreigabenachweis |
| M2 | Dauerhafte Pläne/Anträge, UI-Grenze, Signatur-/Attemptbindung, Journale, Locks, ACK/Sync | Wiederholt `pending_approval` mit 0 Jobs/Outbox/Grants; tatsächlicher simulierter WebUI-Klick; Hello-Ausgabe; Live-Inventur; Abbruch vor künftigem Start ohne Grant; Rootdienst setup/start/stop | Native Fehler-/Redelivery-/ACK-/Offlinefälle noch offen |
| M3 | Gemeinsame HTTP-/MCP-Fachlogik, Geräte-/Jobansichten, begrenzte Logs, Rechte-/Tenantprüfungen; Plattformmatrix vorhanden | Genehmigte begrenzte Rootlogs, Quelle/Zeit und partielle Abdeckung; gespeicherter UI-/HTTP-/MCP-Ergebnis-DTO exakt gleich; Mandant B verweigert | Native Logstrecke bestanden; abschließender Referenz-/Dokumentationsabgleich offen |
| M4 | Gebundene Fixture-Rezepte, unabhängiger Helper, Sandbox, lokale Configure-Korrektur | Native Sandbox-/Lock-/Syscallprüfungen und armed Hook; letzter APT-Lauf Exit 0, Nachprüfung jedoch verweigert | **Offen: unknown/Teilwirkung**, keine Paket-Acceptance |
| M5 | MCP plan/submit, feste Zielmenge, Linux-Skripte, Reboot-/Rollout-/Ergebnisverträge | MCP→Antrag→UI→VM für Hello/Inventur; Idempotenz desselben Submit; feste Zielbindung | Reboot, Offlinefrist und vollständige begrenzte Sammel-/Fehlernachweise offen |
Hier bedeuten „lokal“ und „implementiert“ keine erneute Ausführung oder native
Abnahme. Historische Teilnachweise gelten nur für ihren dokumentierten Stand.
## Priorisierte offene Arbeit
**M4 jetzt im vereinbarten begrenzten Umfang bestanden:** Native1.1-Transaktion
plus beide separat UI-genehmigten1.1-Noops erfolgreich. Alte definitive
Fehlschläge unverändert; keine Wirkung wiederholt/kein Marker gelöscht.
APT-Policy geschlossen/Endpunktentfernt/Dienstinactive. Nächste offene Gates
sind4(aktive Offline/Ablauf/Entzug),3(Prozessabbruch),6(MCP-Endbericht),7(Reboot)
und8(Endaudit). Details/UUIDs in implementation-status.md und
apt-ambient-reboot.md. Folgende ältere APT-Zwischenstände sind historische Belege.
**Weiterer nativer Teilerfolg:** Eigener tatsächlicher UI-Upgradeplan1.0→1.1
bestanden, Grant6b68c65b-8c0c-4cab-964d-e12a2d7f0626/Root12. Unabhängige
Paket-/Nutzdateinachprüfung und native Acceptance auf aktueller Runtime;
Hostflagtrue→true, kein eingeführter Neustartbedarf/kein Reboot. Feste0/0/0-
Grenze und danach1/1/1/0 belegt. Noch beide normalen1.1-Noops erforderlich,
danach aktive Offlinefälle und Prozessabbruch. Kein vollständiges MVP behauptet.
**Neuester abgeschlossener Schritt:**337-Configureversuch rein lesend unter
Originalsignatur vollständig nachgewiesen und durch normalen signierten Sync
geschlossen. Ehrlich **failed** Abnahme trotz`effect_complete=true`; historischer
Host-Vorherwert null, aktueller Neustartbedarf true, keine rückwirkende Acceptance.
Root11/0offen/0Faults, zentral20/20/18/0. Neue Runtimef40c/bbd2/1dc samt kopierter
nativer Probe unter Erhalt aller Historien installiert; APTinactive/Endpunkt
entfernt/Rootpolicygeschlossen. Nächster eigener UI-Plan: Upgrade1.0→1.1,
danach beide echten Noops. Weitere Gates unten bleiben offen.
**Aktueller Folgestand:** Automatischer passiver WSS→HTTPS-Fallback auf derselben
Cloudidentität bestanden, Fall `697b19ba-e7ff-4ebf-8a45-f5a0b0514fea`.
Zwei tatsächliche authentisierte503, HTTPS-Heartbeat/signierter Sync, Hook auf
beiden Rollen wieder aus; operative Wiederherstellung von WSS mit erhaltenem
Agenten. Zähler vorher/nachher19/19/17/0. Details und Auswertungsfehler offen in
[transport-acceptance.md](transport-acceptance.md). Kein automatischer
WSS-Switchback behauptet.
Danach eigener Configure-only-Plan tatsächlich ausgeführt: Rootverbrauch11,
Grant `33775478-15b0-46ec-b059-44f500dbb0b6`, APT0, Paket laut gespeicherten
dpkg-Nachweisen vollständig konfiguriert. Abnahme verweigert mit
`FIXTURE_UNEXPECTED_REBOOT_REQUIRED`, daher weiterhin **unknown**, keine
Native-Acceptance. Fehlender Host-Vorherwert darf nicht nachträglich erfunden
werden. Rootpolicy deny-only geschlossen; gebundener Readonly-Abgleich vor
allen weiteren Wirkungen erforderlich. MVP insgesamt weiterhin offen.
**Teilerfolg danach:** Linux-native Ablehnung falscher CA/falschen Namens,
Rotation mit gleichem Gerät und neuem tatsächlichem Peerzertifikat sowie
UI-Widerruf/Kanalfencing an separater passiver Testidentität auf derselben VM
bestanden. Dauerhafte APT-Unknown-Evidenz unverändert, keine Jobs, Testservice
gestoppt. M1 braucht weiterhin tatsächlichen WSS-Ausfall/Fallback; Gate 0 bleibt
die nächste blockierende Verwaltungsstrecke. MVP insgesamt weiterhin offen.
**Gate0 bestanden:** Native signierte Kontrollkettenreparatur und nachfolgender
an den ursprünglichen APT-Auftrag gebundener Readonly-Teilwirkungsnachweis mit
normalem signiertem RootSync bestanden. Beidefaultfrei; Ledger 9/0 unresolved,
zentral 13/13/12/0. Derselbe Versuch jetzt ehrlich failed
`APT_PARTIAL_UNCONFIGURED_VERIFIED`, Fixture1.0 unpacked, keine Paket-Acceptance.
Agent/Generalhelper aktiv, APT-Endpunkt gestoppt, Rootpolicy geschlossen.
Neue Configure-only-Runtime samt kopierter nativer Sandboxprobe ist inzwischen qualifiziert; Paketwirkung noch nicht ausgeführt. Erster neuer UI-Plan lief ohne Offer/Grant an der alten64MiB-Journalgrenze ab; unverändert erhalten. Neue endliche256MiB-Runtime samt Erhaltungsprobe nativ installiert und Sync wiederbereit. Nächster Paketpfad ist ein separat neu UI-genehmigter Configure-only-Plan.
Die noch offenen Teile der folgenden Gates sind **geplant, nicht ausgeführt**. Native Teilergebnisse stehen ausdrücklich bei den Gates und im Implementierungsstand.
Jeder Ausführungsjob braucht weiterhin seinen eigenen festen WebUI-genehmigten
Plan. Zulässige dev/test-Browserbedienung bleibt sichtbar simuliert und auditiert.
| Priorität / Gate | Minimaler Abschlussnachweis | Vorbedingung / Quelle |
| --- | --- | --- |
| 0. **Bestanden:** APT-Teilwirkung abgeglichen | Ursprünglichen signierten Auftrag und vorhandene Nachweise prüfen; aktuelle vollständige Teilwirkung über einen zulässigen, gebundenen prüfenden Pfad feststellen; ausschließlich signierte gezielte Ergebnisübernahme in Agent, Server und **demselben** Helperledger. Alte Marker/History bleiben erhalten. Kein unsigned Unlock, blindes Retry oder pauschales `--configure --pending`. | Jetzt 9 Helperverbräuche, 0 unresolved; zentral 13 Jobs / 13 Outbox / 12 Grants / 0 unresolved. Rootpolicy geschlossen. `cloud_apt_retry.py finish` liest nur den alten Ausgang und ist **kein** Recoveryverfahren. |
| 1. Begrenzte APT-Wiederherstellung und M4 | Neue Configure-Korrektur unter identitäts-/journalbewahrender Installation nativ prüfen; nötige Wiederherstellungswirkung als neuen festen UI-Plan genehmigen. Fixture 1.0 unabhängig vollständig verifizieren, danach separat genehmigtes Upgrade 1.0→1.1 und passende runtimegebundene Acceptance. Normale `ensure_package`-/`apply_updates`-Pläne auf 1.1 separat als echte Noops mit unverändertem Paketbestand nachweisen. | Erst nach Gate 0 und sicherem Recoveryvertrag. Vorhandene Cloud-APT-Runner/Caseverzeichnisse sind create-only; nicht blind wiederholen. Neue Source-/Runtimepins nicht mit installierten Pins vermischen. |
| 2. **Bestanden:** begrenzte Live-Logs und Lesesicht | Genau erlaubte Testunit, gebundenes Zeitfenster/Zeilen-/Bytelimit, Quelle und tatsächlicher Erhebungszeitpunkt; echte UI-Genehmigung vor Sammlung. Gespeicherte Ergebnisse über UI, HTTP und MCP gleich darstellen. Fremder Tenant/unerlaubte Quelle bleibt verweigert. | Nativ vier Zeilen aus fester Testunit/300Sekunden/max50Zeilen/65536Bytes; valid/partial ehrlich. Eigene Rootlog-Read-Allowlist, danach geschlossen. UI/natürliche HTTP-Antwort/MCP exaktgleich, Fremdtenant verweigert. Keine neue Wirkung beim gespeicherten Lesen. |
| 3. Doppelzustellung/ACK bestanden; Wiederanlauf offen | Tatsächlich denselben genehmigten Offer/Versuch erneut zustellen und einmal gezielt Ergebnis-ACK verlieren: ursprüngliche IDs/Bytes erneut senden, genau ein Verbrauch/eine Wirkung, unveränderte Grantanzahl und dauerhafter Ergebnisempfang. Eigener kontrollierter Agentabbruch nach möglicher Wirkung muss `unknown` und gebundenen Abgleich ergeben. | AT-07/08/33, M2. Eng begrenzter Devadapter implementiert. Native WSS-Doppelzustellung bestanden: zwei tatsächliche Annahme-IDs, ein Grant/Verbrauch/Wirkung, eigener UI-Lesejob bestätigte Zähler1. Nativer WSS-ACK-Verlust ebenfalls bestanden: tatsächlicher ursprünglicher Result-Replay mit gleicher ID/Hash nach durablem Commit, ACK beendet Replay, unabhängiger UI-Lesejob Zähler1. Prozessabbruch weiter offen. Details: `delivery-acceptance.md`. |
| 4. Offline, Ablauf und Entzug | Nach Annahme vor Start Verbindung verlieren: offline keine Starterlaubnis/Wirkung. Nach Wiederkontakt nur innerhalb gültiger Bindung/Frist starten. Separater Ablaufversuch bleibt nach Wiederkontakt `expired` ohne Grant/Wirkung. Rechte-/Genehmigungsentzug sperrt neuen Start. Bereits bestandenen Abbruch-vor-Start nicht als laufenden Installerabbruch ausgeben. | AT-06/09, M2/M5. Aktuelle Unknown-Sperre darf den eigentlich geprüften Offline-/Fristgrund nicht verdecken. Kein fremder Paketmanager wird beendet. |
| 5. **Bestanden:** M1-Identitätslebenszyklus; Auto-Fallback separat offen | Native Rotation mit erhaltenen Agent-/Asset-/Enrollment-IDs und Journal; nicht nur neues Zertifikat ausgestellt, sondern neuer tatsächlicher TLS-Peerfingerprint benutzt. Ungültige CA/Name/abgelaufenes Zertifikat verweigert. Widerruf verhindert neue Starts und beendet/fenced den Kanal. | AT-03, M1. Öffentliche Fingerprint-/Authzeit-DTOs aus Migration 12 existieren bereits. Native Rotation/Peerwechsel, falsche CA/Name und UI-Widerruf bereits bestanden. Zusätzlich korrekt signiertes abgelaufenes Clientleaf nativ auf TLS abgewiesen; gültige Kontrollen401 und keine Registrierung/Jobs. Siehe `tls-expiry-acceptance.md`; kein Produktionsnachweis. |
| 6. MCP-Referenzabläufe / fester Sammelplan | Kunde/Zielmenge aus gespeichertem Inventar eindeutig bestimmen; feste Skriptbytes/Versuche und alle Jobs vor Klick sichtbar; Änderung/zweiter Versuch braucht neuen Plan. MCP kann weder per Rolle noch Token genehmigen. Rollout-/Teilergebnisse ehrlich je tatsächlich vorhandener Zielmenge anzeigen. | M5, AT-29–34. Ein realer Linux-Testclient genügt für die verfügbare feste Zielmenge; daraus keine Mehrgeräteparallelität oder Mischplattformabnahme ableiten. Keine zusätzliche VM und kein Windows-Executor allein für eine größere Demo. |
| 7. Reboot zuletzt | Eigenständiger fester UI-genehmigter Rebootplan; vor Start alte Boot-ID dokumentieren; ausgehende authentisierte Wiederanmeldung mit neuer Boot-ID, neuem Inventar, signiertem Sync und gebundenem endgültigem Ergebnis. Ausbleibender Wiederkontakt ist kein Erfolg. | M5. Erst geschlossene frühere Wirkungen und geprüfte Recovery. Der bereits erlaubte einzelne Test-VM-Reboot ersetzt keine Plangenehmigung. Kein SSH-Reboot, Kernel-/Distributionsupdate oder Hypervisorzugang. |
| 8. Abschließende M0–M5-Prüfung | Aktueller Source-/Buildstand und betroffene Prüfungen, passende Plattform-/Capability-Matrix, Quellen/Zeit/Qualität, Tenantgrenzen und alle obigen nativen Belege vollständig. Keine ungeklärten Wirkungen oder behaupteten Tests; nach Abschluss neue Änderungen stoppen, Ergebnis dokumentieren und pushen. | Spec 25.4. Keine Produktionsfreigabe aus dev/test-Simulation ableiten. |
M4 bleibt auf die dokumentierten, exakt gepinnten Testrezepte begrenzt.
`apt_native_update` ist eine echte Transaktion; ein nachfolgender
`apply_updates`-Noop ist **keine** zweite Updateausführung und kein Nachweis
beliebiger OS-/Kernelupdates oder eines allgemeinen Paketkatalogs.
## Verbindliche Negativfälle passend zum gelieferten Umfang
Zusätzlich zu den oben benannten nativen Abläufen müssen die vorhandenen
gezielten Prüfungen folgende Invarianten erhalten; nur reale Lücken ergänzen,
keine parallele Volltestsuite bauen:
- AT-04/05: fremde Objekt-IDs, fehlender Tenantkontext, Poolwiederverwendung und
Artifact-/Workerpfade verweigern; Kenntnis einer UUID ist keine Berechtigung.
- AT-10/11: Clone-/Journalrollback bzw. alte Telemetrie erzeugen weder historische
Wiederholung noch frische Onlineanzeige. Kein tatsächlicher VM-Snapshot oder
Zurückrollen des erhaltenen dauerhaften Testjournals als Abkürzung erforderlich.
- AT-12–14: manipulierte Logs bleiben Daten; gleicher Idempotenzschlüssel mit
anderem Inhalt und veränderte genehmigte Ziele/Bytes bleiben verweigert.
- AT-24/27: Wiederanlauf und begrenzter Output/Telemetrieverkehr erhalten Journale,
andere Mandanten und Backpressure. Bestehender echter WSS-Reconnect ist belegt;
er ersetzt keinen Ergebnis-ACK-Verlust bei laufender Wirkung.
- AT-29–33: vor Genehmigung immer Null-Jobgate, keine Automation-/Policyfreigabe,
unveränderliche Pläne und keine zweite Wirkung bei Redelivery.
AT-15/16/17–23/25/26 gehören gemäß Spec 25.3 zu Windows, PVE/RustDesk oder M7
und blockieren das Linux-MVP nicht. AT-28 wird mit dem später gelieferten
Sollservice-/Monitoringumfang geprüft; aktuelle Gesundheit darf bis dahin
ehrlich `unknown` bleiben.
## Solange APT unbekannt und gesperrt ist
Unabhängig möglich sind Lesen gespeicherter UI-/HTTP-/MCP-Daten, Tenant- und
Null-Jobgateprüfungen, lokale Implementierung der notwendigen Faultadapter sowie
ein eng begrenzter passiver Identitäts-/TLS-Nachweis. Eine dafür getrennte
Testidentität auf derselben erlaubten Cloud-VM darf die dauerhafte Identität
und deren offene Wirkung nicht ersetzen oder die Sperre umgehen.
Keine neue Paket-/Root-/Rebootwirkung starten, keinen alten Antrag erneut
genehmigen, keine Tombstones/DB-/PKI-/Identitätsdaten zurücksetzen. Insbesondere
eine durch Unknown blockierte Probe nicht als bestandenen Offline-/Fristtest
werten. Erst die dokumentierte sichere Auflösung öffnet den weiteren Ablauf.