# 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.