Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s
Rust development slice / linux (push) Failing after 14s
This commit is contained in:
@@ -1,231 +0,0 @@
|
||||
# Reviewstand: erhaltene Helper-/Updater-Übergabe
|
||||
|
||||
2026-11-14. **Isolierter Quellvertrag, keine Produktnorm oder Applyruntime.**
|
||||
Basis: vollständige Spezifikation1.19, vollständige1.20-/PD-Ergänzung des
|
||||
Skriptconsole-Worktrees und [bisheriger Vorschlag](agent-updater-proposal.md).
|
||||
Root hat den engen Kernel und den Fullrenderer zur Ausarbeitung beauftragt;
|
||||
Runtimeintegration, Zielaktionen und Veröffentlichung erfolgen erst nach
|
||||
dessen Koordination. Linux-first und die tatsächliche WebUI-Grenze gelten.
|
||||
|
||||
Die neue Crate `rmm-updater-handoff` verändert weder den qualifizierten
|
||||
Releaseverifier noch die beiden vorhandenen nativen Verifier-Abnahmerunner.
|
||||
Sie enthält keinen Installer, Dateischreiber, Dienststart, IPC-Server,
|
||||
Netzwerkclient, SQLiteadapter, Approver oder neuen Server-Journalslot.
|
||||
Aus einem gültigen Handoff oder Healthreceipt entsteht keine Startberechtigung.
|
||||
|
||||
## Konkreter Vorwärtsvertrag
|
||||
|
||||
`Handoff` bindet ursprünglichen Tenant/Asset/Agent, beide Generationen,
|
||||
Plan-/Job-/Versuchs-/Grant-/Authorization-IDs, exakte Originalrequest- und
|
||||
Startzeugenhashes, beide vorhandenen Journal-IDs, Helpercheckpoint und letzten
|
||||
signierten Entscheid, Boot, ursprüngliche Verbindungsgeneration, einmalige
|
||||
Ownernonce, stabilen Updater-/Policyhash, Vorgängerrecord, erhaltene Zustands-
|
||||
und Stagingzeugen sowie Vorgänger-/Zielcodepaar. Der Rendererbeleg und alle
|
||||
benannten alten/neuen Dateihashes sind unveränderlicher Bestandteil.
|
||||
|
||||
Die Helperintegration muss Verbrauch, bestehenden exakten Startzeugen und
|
||||
Handoff **in derselben vorhandenen Ledgertransaktion** persistieren. Eine
|
||||
zusätzliche Transaktion nach `ledger::begin_execution` wäre unzureichend:
|
||||
ein Crash könnte einen Verbrauch ohne bestimmbaren Owner hinterlassen.
|
||||
Jeder andere offene/Unknown-Versuch verweigert die Übergabe. Das Handoff
|
||||
ersetzt weder den Originaljob/-grant noch dessen unabhängige Prüfung.
|
||||
|
||||
Die Writergrenze ist ausdrücklich Bestandteil dieses Vertrags: Der alte
|
||||
Helper persistiert auch den Stopintent vor der Übergabeantwort. Solange er
|
||||
seinen lebenslangen Windowsguard hält, schreibt der Updater kein Event in
|
||||
den gemeinsamen Ledger. Nach Stop/Guardübernahme kann der Updater All-stopped
|
||||
und Ownership zusammen transaktional anhängen. Nach dauerhaftem Rückgabeintent
|
||||
und tatsächlicher Guardabgabe stammen die weiteren Start-/Health-/Outcome-
|
||||
Events ausschließlich vom neuen Helper unter dessen Guard. Der Updater
|
||||
erhält nur die eng typisierte lokale Bridge; kein freies Ledger-Schreibrecht
|
||||
parallel zum neuen Helper. Ein einheitlicher Ledger-/Lock-Inode-/FileID-Hash
|
||||
ist vor Übergabe fest gebunden und wird bei Übernahme, neuem Servicepeer und
|
||||
Health erneut verglichen; bloß ein gleichnamiger Dateipfad reicht nicht.
|
||||
|
||||
Der begrenzte Journalcodec prüft kanonische Bytes, Hashvorgänger, monotone
|
||||
Sequenz/Zeit und höchstens16Events. Für Linux Full sind dies genau:
|
||||
|
||||
1. Stopintent, unabhängiger All-stopped-Zeuge, bestätigter Besitz des gleichen
|
||||
Helperledgers durch den konkreten stabilen Updaterprozess.
|
||||
2. Jeweils ein Intent und ein bestätigter Nachhash für Agent, Helper,
|
||||
Fullconfig und Fullpin; keine neue Dienstgeneration vor vollständigem Paar.
|
||||
3. Neues Code-/Pinpaar und erhaltener Zustandszeuge vollständig bestätigt.
|
||||
4. Dauerhafter Ledger-Rückgabeintent unter gehaltenem Guard, danach Guard
|
||||
tatsächlich abgeben; erst anschließend darf der neue Helper denselben
|
||||
Guard erwerben und starten.
|
||||
5. Konkrete neue Serviceprozesse mit Imagehash, PID und Prozessgeburt,
|
||||
anschließend signierter Healthbeleg und ursprüngliches Outcome-CAS.
|
||||
|
||||
Der Codec nimmt nur Beobachtungen entgegen. `prepare` liefert Bytes für ein
|
||||
append-only CAS gegen den bestehenden Head, **keinen Haltbarkeitsnachweis**.
|
||||
Der Plattformadapter muss Flush/Commit vor Wirkung, echte Service-/Peer-
|
||||
und Guardbeobachtungen, Dateihandles/ACLs sowie ursprüngliche SQLrows und
|
||||
Signaturen prüfen. Historischer Replay allein erkennt keinen abgeschnittenen
|
||||
Suffix; er muss gegen den erhaltenen dauerhaften Head, Rowcount und
|
||||
Ledger-/Inode-/FileID-/Kontrollkettenbeleg geprüft werden. Ein unbekannter
|
||||
Stop/Teilwechsel/Start bleibt lesend zu diagnostizieren, kein erneuter Execute.
|
||||
Ein expliziter Unknown ist im neuen Updatekernel terminal und wird durch
|
||||
spätere Health nicht geheilt. Bestehende allgemeine Outcome-CAS-Regeln bleiben.
|
||||
|
||||
## Fullhelper bleibt Teil des ersten Linux-Applyziels
|
||||
|
||||
Die tatsächliche Zieltopologie hat General, Full und Agent aktiv. Daher ist
|
||||
Full kein pauschaler Ausschluss. `linux_general_full_v1` erhält ein geschlossenes
|
||||
Stopset Agent/General/Full; ein bereits installierter APT-Reader kann zusätzlich
|
||||
als vierter Dienst im Stopset stehen, **nie im Startset**. Alle tatsächlich
|
||||
installierten Shared-Ledger-Reader müssen vor Austausch erkannt und gestoppt
|
||||
sein. Unbekannte Profile und ausgelassene Fullservices verweigern den Schnitt.
|
||||
Agent/General/Full erhalten dieselbe neue Codepaargeneration vor Restart.
|
||||
Die alte APT-Unqualifikation/-Deaktivierung bleibt bestehen; kein alter
|
||||
Acceptancebeleg wird umgeschrieben oder auf die neue Helperdatei übertragen.
|
||||
Zukünftiger APT-Start benötigt eine gesonderte passende Qualifikation.
|
||||
|
||||
`render_linux_full` akzeptiert ausschließlich das bekannte Full-Configschema,
|
||||
die daraus in fester Feldreihenfolge abgeleitete `control::Policy` Schema2
|
||||
und den zugehörigen `GeneralPin` Schema2. Alte Binär-/Policy-/Identitybindungen
|
||||
werden vorher geprüft. Die Rendererdefinitionen sind eine explizite
|
||||
Schemamomentaufnahme; Integration muss sie gegen die tatsächlichen Typen aus
|
||||
dem1.20-Quellstand vergleichen, bevor sie Runtime werden.
|
||||
|
||||
Der unabhängige Quellenreview fand einen echten Kompatibilitätsfehler des
|
||||
ersten Entwurfs: Die aktuelle Full-Rawconfig enthält einen leeren Inlinekey
|
||||
und einen `signing_key_file`-Pfad; die Runtime ergänzt den effektiven öffentlichen
|
||||
Key vor der Policyhashbildung. Der reine Renderer erhält deshalb jetzt den
|
||||
bereits provisionierten, **extern authentisierten** öffentlichen Signierkey
|
||||
als expliziten Parameter. Er öffnet keine Datei. Bei vorhandenem absolutem
|
||||
Keypfad darf der Raw-Inlinekey leer oder genau gleich sein; ohne Keypfad ist
|
||||
der gleiche Inlinekey Pflicht. Effektive Policy und Pin werden wie in der
|
||||
Runtime aus diesem Key abgeleitet; Raw-Inlinekey und Pfad bleiben unverändert.
|
||||
Der Transitionbeleg bindet zusätzlich `effective_signing_key_id`. Ein bloß
|
||||
geparstes `VerifyingKey`-Objekt authentisiert keine Provisionierung; der spätere
|
||||
Adapter muss den Input unabhängig gegen die vorhandene geschützte Keydatei
|
||||
und die gebundene öffentliche Identität prüfen. Eine neue lokale Vertragsprobe
|
||||
belegt den Filekeyfall und gleiche Policy-/Pinbytes zum Inlinefall. Dies ist
|
||||
weiterhin kein Lesen der realen Keydatei oder nativer Renderer-Nachweis.
|
||||
|
||||
Der Renderer ändert nur benannte Top-Level-Wertspans:
|
||||
|
||||
- Config: `helper_binary_sha256`.
|
||||
- Pin: `helper_binary_sha256` und daraus exakt neu berechnetes `policy_sha256`.
|
||||
|
||||
Alle anderen **rohen Config-/Pinbytes** bleiben erhalten, einschließlich
|
||||
Formatierung, Identity, öffentlicher Schlüssel, Keypfad, UID/GID, Socket,
|
||||
Statepfad und Rechtefelder. Er nutzt begrenzte typisierte Deserialisierung
|
||||
und geborgte `RawValue`-Spans; keine globale Stringersetzung, kein JSONpatch.
|
||||
Ein gleicher Hash innerhalb eines anderen Feldes bleibt erhalten.
|
||||
Unbekannte/duplizierte Felder, abweichende Policy, zusätzliche Profile/Services,
|
||||
fremde Identität und escaped Hashwerte werden verweigert.
|
||||
|
||||
Der `LinuxFullTransition` bindet alte/neue Rawconfig-, Rawpin-, Policy- und
|
||||
Helperhashes. Exakte Zielbytes samt Beleg müssen vor der WebUI-Genehmigung im
|
||||
festen Plan aufgelöst und später unabhängig erneut geprüft werden. General-
|
||||
und APT-Konfigurationen werden nicht gerendert. Die zentrale Fullscope wird
|
||||
**nicht migriert**; künftige Fulljobs bleiben ohne neue konkrete Scopebindung
|
||||
deny. Ein Codewechsel erteilt keine neuen Rechte.
|
||||
|
||||
## Enger Health- und Syncanschluss
|
||||
|
||||
Die eigene offene Updatezeile darf **keinen allgemeinen Readyzustand** erzeugen.
|
||||
`HealthReceipt` ist separat domänengebunden (`rmm.agent-update-health.v1\0`),
|
||||
mit strengem Ed25519 geprüft und an den gesamten Handoffhash, Ownernonce,
|
||||
Boot, beide erhaltenen Journale, neue Verbindungsgeneration und sämtliche
|
||||
konkreten neuen Agent-/Helperprozesse gebunden. Er enthält exakte Hashes des
|
||||
tatsächlich angewandten SignedSync-Requests/-Responses, Decision-ID und
|
||||
frisches Inventar samt ACK-Hash. `ready=true` wird ausdrücklich verweigert.
|
||||
Sync und Inventarempfang müssen nach den bestätigten neuen Dienststarts
|
||||
liegen. Health ist nur innerhalb180Sekunden gültig, Gesamtfrist höchstens600;
|
||||
kein Receipt verlängert sie. Der öffentliche Verifikationsschlüssel wird
|
||||
extern vertrauenswürdig provisioniert, nie aus dem Receipt übernommen.
|
||||
|
||||
Noch vor Integration normativ zu bestätigen:
|
||||
|
||||
| Anschluss | Erforderliche enge Änderung |
|
||||
|---|---|
|
||||
| `ledger::begin_execution` | Additive atomare Handoffanlage mit Originalverbrauch/-start im selben Ledger; keine Ersatzzeilen und kein Reset |
|
||||
| Helper-/Agent-Startup | Nur exakt vollständiges, lebendes, gleichbootiges, fristgebundenes Updatehandoff als `inflight` erkennen; vorhandenes Unknown niemals umschreiben |
|
||||
| `HelperSync`/Server-Sync | Typed Inflightdatensatz desselben Versuchs bei weiterhin geschlossenem Ready abgleichen; Originalkontrollkette erhalten |
|
||||
| `ClientSync::confirm_helper` | Bestehende allgemeine Unresolved-Sperre erhalten; neuer expliziter read-only Updatekontrollpfad darf keine Startlease setzen |
|
||||
| Lokales IPC | Eigener fest provisionierter Updaterparticipant mit Dienst-/UID/SID-/PID-/Geburts-/Imagebindung; Root/SYSTEM allein reicht nicht |
|
||||
| Healthroute | Tatsächlich gespeicherter neuer Geräte-mTLS-/Inventory-/Syncbeleg; lokale aktuelle Peer-/Code-/Stateprüfung plus exaktes Receipt vergleichen |
|
||||
| Finalisierung | Neuer Helper speichert ausschließlich das noch fehlende Originaloutcome per unverändertem CAS; danach bestehende Spiegelung/normaler Sync |
|
||||
|
||||
Keine dieser Runtimeänderungen ist durch den isolierten Kernel implementiert.
|
||||
Insbesondere ist ein Hash im Receipt kein Ersatz für die unabhängige Prüfung
|
||||
des zugehörigen aktuellen lokalen Kontroll-/Inventarbelegs. Rotation/Revoke-
|
||||
und Trustprovisionierung müssen den aktuellen sowie historischen Prüfkontext
|
||||
beibehalten; der Kernel implementiert keinen neuen Trustdienst.
|
||||
|
||||
Offen bleiben außerdem genehmigte typisierte Action/Plan/Grant-/UI-/MCP-
|
||||
Integration, Updatekatalog und begrenzter eigener Streamingpfad, OSstaging,
|
||||
stabiler Updaterbootstrap, Dienst-/Dateiaustausch, einmaliger zulässiger
|
||||
Vorgängercode-Rollback, tatsächliche Linux-Abnahme und danach Windows.
|
||||
Windows-Codepaar-/Settingsrenderer und Rollbackzustände sind hier **nicht**
|
||||
implementiert. Der ursprüngliche reine Linux9-/Windows9-Verifiernachweis
|
||||
bleibt unverändert; diese neuen Verträge haben noch keinen VM-Nachweis.
|
||||
|
||||
## Tatsächlich ausgeführte lokale Prüfungen
|
||||
|
||||
Offlinecontainer aus vorhandenem Image
|
||||
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
|
||||
Kein Server oder Agent auf dem Notebook gestartet, keine Ziel-/Policyaktion.
|
||||
|
||||
```text
|
||||
cargo check --manifest-path /src/Cargo.toml --offline -p rmm-updater-handoff
|
||||
cargo fmt --manifest-path /src/Cargo.toml -p rmm-updater-handoff
|
||||
cargo test --manifest-path /src/Cargo.toml --locked --offline -p rmm-updater-handoff --all-targets --release
|
||||
cargo clippy --manifest-path /src/Cargo.toml --locked --offline -p rmm-updater-handoff --all-targets -- -D warnings
|
||||
```
|
||||
|
||||
Bestanden: Check, Formatierung, Clippy ohne Warnungen und acht gezielte
|
||||
Vertragsprüfungen ohne Skip. Diese prüfen den vollständigen16-Event-Fullpfad,
|
||||
Originalketten-/Clock-/Limitgrenzen, Stop-/Lock-/Austausch-/Restartreihenfolge,
|
||||
fehlende Fullprozesse/APT-Ausschluss, echte getrennte Healthsignaturen,
|
||||
stale/fremde/ready-Health und terminalen Unknown sowie Rawbyteerhaltung,
|
||||
extern gebundene File-/Inline-Signierkeys und feindliche Fullrenderer-Eingaben.
|
||||
Nur lokale Vertragsnachweise; kein
|
||||
Bootstrapping, dauerhafter SQLite-Commit, nativer Dienst-/Apply-/Rollback-
|
||||
oder Produktionsnachweis. Der erste Formatbefehl scheiterte vor Cargo an
|
||||
einem nicht überschriebenen Image-Entrypoint; mit `--entrypoint cargo`
|
||||
anschließend tatsächlich ausgeführt. Keine Tests als Folge dieses Fehlers
|
||||
erfunden oder Zielaktion wiederholt.
|
||||
|
||||
## Fortschreibung: koordinierter Quellencheckpoint1.21
|
||||
|
||||
Der ursprüngliche a2efb79-Kernel und dessen Belegbytes bleiben unverändert.
|
||||
Sein tatsächlicher enger Linux8-Nachweis steht in
|
||||
[agent-updater-handoff-linux-results.md](agent-updater-handoff-linux-results.md).
|
||||
Die darauf aufbauende Coreintegration speichert Originalverbrauch, bestehenden
|
||||
Startzeugen, Handoff, konkrete Delegation und Stopintent in einer IMMEDIATE-
|
||||
Transaktion des vorhandenen Ledgers. Sie überträgt einen typisierten begrenzten
|
||||
Präfix in Protofeld14 und bestätigt ihn ausschließlich bei beiden Readyflags=false
|
||||
und unlock=false. Persistiertes Unknown bleibt terminal. Leere neue Felder
|
||||
lassen die alten Grant-/Decision-/Startcodecbytes unverändert.
|
||||
|
||||
Der Originalplan bindet separat provisionierten Healthpublickey und Rawpinhash;
|
||||
Admission liest den lokalen Pin unabhängig, historische Prüfung benutzt diesen
|
||||
Originalkontext. Server-Health verlangt originale gespeicherte SignedSync- und
|
||||
Baseinventarbytes samt bestätigender Folgerunde; sie eröffnet keine Admission.
|
||||
Der konkrete Helper muss dieselben lokal tatsächlich angewandten Bytes und
|
||||
Applyzeit innerhalb der belegten Zeitspanne unabhängig nachweisen.
|
||||
|
||||
Linux Full ist vorgesehener ursprünglicher Autorizer/Owner-/Healthguard.
|
||||
General bleibt in diesem Fall geschlossen und darf Nichtzuständigkeit nicht
|
||||
als OwnerLost terminalisieren. Das ist nötig, weil die tatsächlichen General-
|
||||
Capabilities keine Imageprüfung eines breiter berechtigten Fullprozesses erlauben.
|
||||
Kein Generalhärtungs-/Capabilitywechsel ist implementiert oder freigegeben.
|
||||
|
||||
Native Unterintents und Nachlesezeilen hängen im selben Ledger am Originalgrant.
|
||||
Feste Stop-/Dateischritte sind create-once, Rückgabe und genau drei Startclaims
|
||||
committen atomar. Nur ein weiterhin lebender ursprünglicher Worker darf die
|
||||
reservierte Folge nach tatsächlicher Lockabgabe einmal dispatchen. Neue Full-
|
||||
Helper bestätigen echte Start-/Health-/Recordbeobachtungen unter ihrem Guard.
|
||||
InstalledRecord/Floorcodec und separat signierter Bootstrapbaselinecodec sind
|
||||
reine Parsingverträge und ersetzen keine Trust-, Floor- oder OSprüfung.
|
||||
|
||||
Offen bleiben reale enge Fullbridge-/Owner-/Healthadapter, passive gültige
|
||||
Updatezustände/Kandidaten, vollständige erhaltende Baselineprovisionierung,
|
||||
Workerdispatch und End-to-End-Apply. Restore bleibt ausdrücklich verweigert:
|
||||
der eingefrorene Vorwärtskernel hat noch keinen qualifizierten Rollbackpfad.
|
||||
Der Agent meldet bis zur echten Provisionierung nur agent.update/not_configured;
|
||||
keine Applyfähigkeit aus Build/Katalog/Unitnachweis. Kein VM-Apply oder
|
||||
Windows-Applynachweis dieses Checkpoints.
|
||||
Reference in New Issue
Block a user