Add typed updater handoff and preserving Linux Full renderer
Rust development slice / linux (push) Failing after 6s
Rust development slice / linux (push) Failing after 6s
Keep release verifier and native drivers unchanged. Independently reviewed as an isolated contract after provisioned-file-key correction; eight local release contracts and format/clippy checks pass. Runtime persistence, approvals, service ownership, apply and rollback remain unimplemented.
This commit is contained in:
@@ -0,0 +1,190 @@
|
||||
# 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.
|
||||
@@ -272,6 +272,15 @@ Serverintegration und tatsächlicher genehmigter Codewechsel bleiben
|
||||
offen. Kein Installer, keine Dienständerung, keine Freigabe und kein RMM-Job
|
||||
durch diesen reinen Prüfkern; der Subagent führte keine eigene VM-Aktion aus.
|
||||
|
||||
Zusätzlicher lokaler Reviewstand nach1.20: ein isolierter typisierter
|
||||
Handoff-/Healthkernel und geschlossener Linux-Fullrenderer sind implementiert,
|
||||
ohne den qualifizierten Verifier oder Runtime zu ändern. Die tatsächliche
|
||||
Linuxzieltopologie General+Full+Agent wird ausdrücklich berücksichtigt;
|
||||
Full bleibt kein pauschaler Ausschluss. Konkreter Vertrag, acht lokale
|
||||
Prüfungen, notwendige Reviewentscheidungen und weiterhin fehlende Integration:
|
||||
[Erhaltende Handoffgrenze](agent-updater-handoff.md). Dies ist keine neue
|
||||
Produktnorm, Zielinstallation oder native Applyabnahme.
|
||||
|
||||
## Nächster Integrationsschnitt zur Freigabe: fester Codepaar-Updatejob
|
||||
|
||||
Die folgende Änderungsliste ist **nur Entwurf, nicht implementiert**. Sie
|
||||
|
||||
Reference in New Issue
Block a user