# Agent-Selbstupdate: kleinster zusätzlicher Schnitt Stand 2026-11-14, **Integrationsvorschlag mit implementiertem reinem Prüfkern**, keine neue Produktnorm und kein Installations-/Applynachweis. Die reinen Linux-/Windows-Kernnachweise sind unten getrennt verlinkt. Basis: Spezifikation1.19, Kapitel0,4,13,16,19,22,25. Der User möchte den Agent-Autoupdater jetzt parallel zur Skriptkonsole. Damit wird ausschließlich dieser Teil aus M7 vorgezogen; Restore, HA, Relay und Lasttest werden dadurch keine zusätzlichen MVP-Aufgaben. APT-/MSI-Fixturerezepte verwalten andere Software und implementieren **keinen Agent-Selbstupdater**. ## Verhalten und Genehmigung Der installierte Agent prüft regelmäßig, ob ein passendes, freigegebenes Release vorliegt. Der erste Vorschlag ist ein täglicher passiver Metadatencheck mit Jitter, zusätzlich beim Prozessstart, über den bereits konfigurierten Server. Dies sammelt ausschließlich feste Release-Metadaten und startet keinen Job, Installer, Download beliebiger URLs oder Codewechsel. Fehlende Konfiguration meldet `not_configured`, abgelaufene Metadaten `unknown` samt Zeitpunkt/Fehler. Ein Update erhält eine eigene typisierte Aktion `update_agent`. UI/MCP dürfen einen festen Plan vorbereiten und als `pending_approval` beantragen. Der Plan bindet pro Gerät Release-Manifesthash, Artefakte, exakten Vorgänger, Plattform, Versuch, Frist, Parallelitätsgrenze und erlaubte einmalige Wiederherstellung. WebUI-Genehmigung, aktuelle Startprüfung und dauerhafter Einmalverbrauch bleiben erforderlich. Ein Mensch kann einen festen Rollout gemeinsam genehmigen; `latest`, zukünftige Versionen, Wildcardziele und periodische Selbstfreigabe sind keine zulässigen ausführbaren Parameter. `updates:apply` wird zusätzlich zu den jeweiligen Root-/SYSTEM-Rechten geprüft; eine Policy begrenzt nur. Der UI-Text muss Agent-/Helper-Dienstunterbrechung und mögliche Management- Unterbrechung anzeigen. Dieser Schnitt fordert keinen Hostreboot an und darf keinen Installer wählen, der ungeplant neu startet. Notwendiger Hostreboot verlangt einen eigenen festen genehmigten Job. Automatischer Versionscheck, freigegebener Rollout und bestätigter Updateerfolg bleiben getrennte Zustände. ## Festes Releaseformat1 Ein Release besteht zunächst aus genau zwei Rohdateien: Agent und privilegierter Helper. Kein Archiv, Postinstall-Skript, freier Pfad oder beliebiges Kommando. Linux verwendet `x86_64-unknown-linux-gnu`, Windows `x86_64-pc-windows-msvc`. Die Plattformkennung ist eine geschlossene Auswahl. Ein neuer Updater selbst ist **nicht** Teil dieses ersten Selbstupdatepfads. APT-/MSI-Pakete können später denselben signierten Vertrag umschließen; der erste Rohbinaryschnitt darf nicht als APT-/MSI-Upgrade beworben werden. Das Envelope enthält `schema_version=1`, `key_id`, `payload_bytes` und `signature` (feste Ed25519-Signatur,64Bytes). Für JSON-Transport werden `payload_bytes` und `signature` als kanonisches Base64url ohne Padding übertragen, keine unbeschränkten Zahlenarrays. Der erste Bibliothekskern nimmt bereits dekodierte begrenzte Bytes entgegen; die spätere Transportintegration muss das Envelope vor Decodierung begrenzen. Der Payload ist streng typisiertes JSON mit festen Feld-/Listenreihenfolgen, ohne unbekannte Felder, doppelte Keys, Floats oder alternative Encodingform. Nach Parsen muss exakt dieselbe kanonische Serialisierung entstehen. Signaturbytes sind die Domäne `rmm.agent-release.v1\0` gefolgt von den unveränderten Payloadbytes. Der Manifesthash ist SHA256 derselben Payloadbytes. Verifikation begrenzt das Payload vor Parsen auf16KiB und verwendet `verify_strict` aus dem schon gepinnten `ed25519-dalek=2.2.0`; keine Algorithmusverhandlung. | Payloadfeld | Festgelegte Bedeutung | |---|---| | `schema_version` | Genau1 | | `release_id` | UUID; unveränderlicher veröffentlichter Datensatz | | `release_sequence` | Positive monotone Veröffentlichungsnummer je Plattform; Versionsvergleich nutzt diese Nummer | | `version` | Sichtbare nichtleere ASCII-Versionskennung; kein lexikografischer Semververgleich | | `platform` | Eine der beiden festen x64-Plattformkennungen | | `published_at`, `expires_at` | UTC-Epochsekunden, gültig nur mit vertrauenswürdigem Clockkontext | | `protocol_major` | Exakte unterstützte Hauptversion; die erste Stufe erlaubt nur dieselbe aktuelle Version | | `state_schema` | Exakte kompatible Zustandsversion; erste Stufe erlaubt **keine** Zustandsmigration | | `minimum_updater_version` | Positive numerische Implementierungsversion des unabhängigen Updaters | | `artifacts` | Genau Agent, danach Helper; je `role`, unveränderliche `artifact_id`, SHA256 und Länge | Artefakthashes sind64kleine Hexzeichen; Längen positiv und höchstens256MiB pro Datei. Artefakt-UUIDs dürfen nicht doppelt sein. Rollen sind `agent` und `helper`, keine eigenen Dateinamen aus dem Netzwerk. Die Veröffentlichung ist erst verfügbar, wenn beide vollständigen Dateien existieren und deren Hash/Länge mit dem signierten Manifest übereinstimmen. Serverkatalog und Tenantberechtigung bestimmen Sichtbarkeit; das Manifest selbst verleiht keinerlei Ausführungsrecht. ## Vertrauen, Ablauf und Versionsschutz Update-, Job-/Grant- und Geräte-/TLS-Schlüssel sind getrennt. Lokaler Bootstrap provisioniert einen root-/SYSTEM-geschützten Update-Keyring mit SHA256-Key-ID, rohem32Byte-Publickey, Plattformbindung und zulässigem Sequenzbereich. Kein Schlüssel aus einem Job, Manifest oder Download wird automatisch vertrauenswürdig. Veraltete/gesperrte Keys verweigern auch eine ansonsten passende Signatur. Erste kleine Stufe unterstützt Rotation/Widerruf durch kontrollierte, separat provisionierte Keyringgeneration; neue Generation muss größer sein, alte Schlüssel werden nicht implizit übernommen. Dynamisches Online-Rootrotation- Protokoll ist noch offen und wird nicht als TUF-Implementierung ausgegeben. Dies hat eine konkrete Grenze: Ein lange isolierter Client kennt einen späteren Widerruf erst bei frischer authentisierter Trustprovisionierung. Daher beginnt ohne frischen Kontakt und aktuellen Trustkontext kein Apply. Lokal gibt es getrennt (a) die aktuell aktive Manifest-ID/Sequenz, (b) die höchste erfolgreich aktivierte Sequenz als Antirollbackgrenze, (c) den höchsten gesehenen Katalogstand für Replaydiagnose und (d) einen offenen Übergabeintent. Bloßes Ansehen eines neuen Releases autorisiert keine Wirkung. Ein älteres Release unter der bestätigten Antirollbackgrenze ist niemals ein neues Updateziel. Gleiche Sequenz mit anderen Manifestbytes ist ein Konflikt; dieselben Bytes sind ein Metadatenduplikat, keine neue Wirkung. Versionslabels allein reichen nicht. `verify_release` prüft ausschließlich **zukünftige Updatekandidaten**. Nach einem Code-Rollback (`active=3`, bestätigter Floor=5) verweigert diese Funktion auch das aktive Manifest3 als erneutes Updateziel. Das bedeutet keine Korruption oder Ungesundheit der aktuell laufenden Version. Passive Anzeige und Health verwenden den gesonderten geschützten `InstalledReleaseRecord` mit explizitem Rollbackstatus; sie dürfen diese Kandidatenprüfung nicht als Current-Healthcheck verwenden. `SameActiveManifest` ist nur oberhalb/auf dem unveränderten Floor erreichbar und bleibt ausschließlich ein Metadatenvergleich. Die einzige Rückkehr zu einer niedrigeren aktiven Sequenz ist die im selben genehmigten Versuch vorab gebundene letzte bekannte Codeversion, deren Dateien noch unverändert lokal vorhanden sind. Die Antirollbackgrenze wird dabei nicht gesenkt. Widerrufene/ausdrücklich verbotene Vorgänger werden auch als Rollback verweigert. Ein späteres Downgrade verlangt einen getrennten Recoveryvertrag. ## Servertransport und UI/MCP-Vertrag Vorgeschlagener zusätzlicher lesender Endpunkt: `GET /agent/v1/releases/current?platform=`, über vorhandenes Geräte-mTLS, ohne Redirects, höchstens32KiB Envelope, Serverzeit und Katalog- beobachtungszeit getrennt. Antwort enthält einen signierten festen Manifestenvelope oder explizites `not_configured`/keine angebotene Version. Kein neuer öffentlicher Login oder allgemein adressierbarer Installerdownload. Ein veraltetes aber noch gültiges Manifest ist durch reine TLS-/Hashprüfung allein nicht als aktuellste Version beweisbar; der Check meldet nur die tatsächlich beobachtete Version. Der vorhandene geräte-/Job-/Versuch-gebundene `/agent/v1/artifacts/{artifact_id}`-Pfad kann derzeit nur Artefakte bis256KiB beziehen: `LocalArtifacts::put/get` **und** das SQL-`CHECK` in `migrations/0006_catalog.sql` begrenzen sie entsprechend. Sein512KiB- Chunklimit erweitert weder Store noch SQL und lädt heute das ganze Objekt in einen `Vec`. **Damit kann er Agentbinaries nicht transportieren.** Die bis256MiB großen Deskriptoren des neuen reinen Prüfkerns sind für eine noch offene, ausdrücklich Update-spezifische begrenzte Streaming-Erweiterung vorgesehen. Weder Import, Downloadroute noch Serverlimit werden in diesem Schnitt verändert. Spätere Integration muss dieselben Geräte-/Job-/Versuchs- und exakten Manifestbindungen auch für große Streams durchgehend erhalten. Kein vom LLM gelieferter Downloadhost, TCP-Override, Dateipfad oder TLS-Ausnahmeschalter. Der zukünftige Download wird gestreamt und vor Verwendung gegen Länge/SHA256 geprüft; Zusatzbytes und vorzeitiges EOF verweigern. Nach Reconnect stammt neue Startautorität immer aus dem normalen Plan-/Grantpfad. `operations.plan(action=update_agent)` erhält nur die gespeicherte Release-ID und feste Ziele; Server löst unveränderliche Bytes aus dem berechtigten Katalog auf und bindet tatsächlichen gespeicherten Vorgänger sowie beide Artefakte. `operations.submit` bleibt Antrag; `jobs.get` zeigt Staging, Übergabe, Dienstprüfung, erhaltene Identität, Rollback und tatsächlichen Ausgang. Vor Genehmigung zeigt WebUI alle Hashes, Versionen, Rechte und Ausfall-/Rollbackgrenzen. Neue Datenverträge sind mit dem Skriptkonsolen-Eigentümer abzustimmen; dieser Vorschlag ändert noch keine Domain-/Protokoll-/Server-/Webdatei. ## Unabhängiger Worker und erhaltende Übergabe Der Netzwerkagent bleibt unprivilegiert. Ein kleiner separat installierter Updater wird unter Root/SYSTEM mit restriktiver IPC/Peerprüfung angesteuert. Er prüft selbst Releasekey, Manifest, exakten Originaljob/-grant, aktuelle Identitäts-/Zuordnungs-/Boot-/Clock-/Syncbindung und lokalen Policykontext. Die schon vorhandenen Helperprüfungen dürfen nicht durch bloßes `approved=true` oder einen Dateimarker ersetzt werden. Sein eigener Journal-/Verbrauchsbezug muss vor Start serverseitig bekannt und unabhängig synchronisiert sein. Der Updater startet nicht aus der gerade zu ersetzenden Agent-/Helperdatei und überlebt deren Stop. Geräteweite Locks serialisieren Paketmanager, Updates, Root-/SYSTEM-Skriptwartung und Reboots. Offene oder unbekannte Versuche sperren die erste Updateversion; keine Aktualisierung mitten in einer Wirkung. 1. Exakten Vorgänger, Trust-/Policy-/Serviceidentitäten, freie Kapazität und Zustandskompatibilität prüfen. Geschützte Stagingdateien create-only auf demselben Dateisystem; Files und Verzeichniseinträge dauerhaft flushen. 2. Manifest und beide Dateien unabhängig prüfen; keine Wirkung vor Genehmigung. Ein Downloadfehler vor Übergabe bleibt belegter Nichtstart der Aktivierung. 3. Vor Stop/Swap dauerhaften Intent mit Originaljob/Versuch/Grant und allen Vorherzeugen schreiben, Grant/Versuch einmalig verbrauchen. Nach unklarem Ausgang ausschließlich Zustand desselben Intents lesen, nie Execute wiederholen. 4. Dienste geordnet einmal stoppen; aktive handles/Locks und SQLiteintegrität prüfen. Identitäten, Geräteschlüssel, Zertifikats-/Rotationstore, Konfiguration, ACLs, DBinodes/FileIDs, Originaltabellen/-zeilen, Journale/Signaturen und offene Outbox bleiben erhalten. Private Schlüsselbytes werden nicht exportiert. 5. Für den ersten Aktivierungsschnitt empfehle ich **bestehende feste Service-Imagepfade erhalten**. Der unabhängige Updater stoppt und bestätigt beide Dienste, tauscht alle gebundenen Code-/Pin-Dateien unter den Locks, prüft vollständig die neue Kombination und startet erst dann einen Dienst. So läuft kein altes/neues Paar gleichzeitig, obwohl die Dateiersetzungen **kein atomarer Dateisystem-Bundleswap** sind. Der dauerhafte Intent benennt jede bereits erfolgte Ersetzung; ein Absturz lässt beide Dienste bis zum eindeutig belegten Abschluss oder Code-Rollback gesperrt. Vorhandene Runner zeigen dieses Wartungsfenster bereits, sind aber noch kein Selfupdater. Ein neuer Launcher würde Service-PID-/Image-/Peerprüfungen verändern und ist für diesen ersten Schnitt unnötig. Ein einzelner atomarer Versionsselector bleibt eine spätere Alternative mit eigener vollständiger Qualifikation. 6. Neue Dienste einmal starten; actual Imagehash/Identität, passive Heartbeats, bestätigtes Inventar und erfolgreiches signiertes Sync mit geschlossenen Effectgates bis zum vollständigen Abgleich nachweisen. `Running` allein reicht nicht. Erst dann aktives Release/Antirollbackgrenze dauerhaft bestätigen. 7. Bekannter Fehlstart darf genau die vorab gebundene Codeversion einmal zurückselektieren und starten; derselbe aktuelle Datenzustand bleibt liegen. Keine DB-/Ledger-/Generation-/Clock-/ACLrücksetzung. Fehlender/unklarer Rückkehrnachweis bleibt `unknown`, keine Schleife automatischer Startversuche. Vorhandene SSH-Bootstraprunner (`vm_runtime_upgrade.py`, `cloud_shared_core_upgrade_v2.py`, `windows/runtime_feature_upgrade.py`) zeigen nützliche erhaltene DB-/Inode-/FileID-/Schlüsselmetadatenprüfungen und dauerhafte einmalige Intents. Sie sind administrative Einzeltools, keine ausgelieferten Selfupdater und keine Ersatzgenehmigung dieses Produktpfads. Frühere fehlerhafte Verifierberichte bleiben historisch; neue Abnahme muss konkrete aktuelle Daten binden, einschließlich vorhandener zulässiger Hardlinkpublikationen. ## Kleinster prüfbarer Quellschnitt und danach offene Arbeit Nach Entwurfsreview implementiert: neue kleine `crates/updater`-Bibliothek, keine Daemonhülle. Dateien `Cargo.toml`, `src/lib.rs`, `src/manifest.rs` und neun gezielte Vertragsprüfungen mit vollständiger kanonischer Goldenfixture. Root-`Cargo.toml`/`Cargo.lock` nur für Workspacebindung; keine neuen fremden Paketversionen. Alle benutzten Abhängigkeiten waren bereits im Lockfile. Implementierte Funktion: bounded canonical manifest decode, strikte Ed25519-Verifikation gegen getrennten übergebenen Keyring, Plattform-/Clock-/Kompatibilitäts-/Versionsprüfung und begrenzte Streaming-Hash-/Längenprüfung von Artefakten. Keine Aktivierung, kein Netzwerk, keine generische OS-Dateischreib-API. Ein validiertes Objekt beweist nur gültige Releasebytes; dessen API darf weder Approval noch Startgrant behaupten oder aus dessen Besitz ein Applyrecht ableiten. Der Kern wurde mit echten lokalen Signaturen und manipulierten/alten/falschen Releasebytes geprüft, ohne einen Agenten auf dem Notebook zu starten. Danach bleiben explizit offen: Serverkatalog/Veröffentlichung und echter Releasekeybetrieb, täglicher Agentcheck und gespeicherte Updatebeobachtung, typisierte Plan-/Grant-/UI-/MCP-Bindung, getrennte Updater-Verbrauchssynchronisation, geschütztes OS-Staging, unabhängiger Updaterbootstrap, mehrstufiger Dateiaustausch, Health-/Rollbackpfad, echte Linux-VM-Abnahme zuerst und Windows-VM-Abnahme danach. Ein Bibliotheksbuild ist weder Autoupdaterinstallation noch AT-26-/MVP-Erfolg. Tatsächlich ausgeführt: vollständige Pflichtnormen gelesen und vorhandene Upgrade-/Kryptoverträge untersucht; eigener isolierter Worktree ab287a784. Der vorhandene Dockerbuilder mit Rust1.99.1 wurde offline, ohne Netzwerk und mit nur lesbarem Quellmount verwendet, eigener Targetausgabe. Image-ID: `sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`. Alle folgenden Prüfungen bestanden für `x86_64-unknown-linux-gnu`: ```text cargo fmt --manifest-path /src/Cargo.toml -p rmm-updater -- --check cargo clippy --manifest-path /src/Cargo.toml --locked --offline --target x86_64-unknown-linux-gnu -p rmm-updater --all-targets -- -D warnings cargo test --manifest-path /src/Cargo.toml --locked --offline --target x86_64-unknown-linux-gnu -p rmm-updater --all-targets --release ``` Neun ausgeführte Vertragsprüfungen bestanden ohne Skip. Sie prüfen feste kanonische Bytes, echte domänengetrennte Ed25519-Signaturen, falschen/gesperrten Key und dessen Sequenzbereich, unbekannte/doppelte Felder,16KiB-Grenze, Plattform/Clock/Trustgeneration/Protokoll/Zustand/Updaterkompatibilität, Versionsfloor und gleichen Sequenzkonflikt, exakt zwei Artefaktrollen, Hash-/EOF-/IOfehler sowie512KiB+7Bytes mit tatsächlichem32KiB-Readlimit. Der verwendete private Testsignierschlüssel ist ausschließlich eine feste öffentliche Testfixture und wird nie als Vertrauensanker ausgeliefert. Lokaler Beleg (gitignored): `devstate/agent-updater/local-qualification.json` bindet Quellen, Image-ID, tatsächliche Befehle/Loghashes und alle neun Testnamen. Die Linux-Release-Testexe ist1544584Bytes groß, SHA256 `e3a1a3140da09de2f86055faa45faf7ba05ddddc2d92d23fef3df03a63bf2999`. Das ist ein lokaler Container-/Vertragsnachweis, **kein Cloud-VM-Nachweis**. Der danach durch Root ausgeführte eigene Native-Linux-Schritt bestand9/9 auf der Cloud-Test-VM, Fall `420d53da-6e34-4e04-b871-0b571d8d3fc4`, Proof-SHA256 `bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`. Details und klare Grenzen: [Native Kernqualifikation](agent-updater-native-contracts.md). Danach bestand derselbe Prüfkern als Windows-GNU-Unitbinary9/9 auf dem Windowsgast, Fall `1a6dba2a-0db3-4aa8-8e21-dafcaabf85e3`, Proof-SHA256 `fc6ef028f0d71639b940914d2cf66e809ed96f9803b4b0b10ea63c6e08978493`; [separater Nachweis](agent-updater-windows-contracts.md), kein MSVC-/Dienstbeleg. 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 ersetzt keine Sourcefreigabe, Bootstrapabstimmung oder native Abnahme. Mit dem Skriptkonsolen-Eigentümer abgestimmt: `update_agent`, `agent.update.apply/1` und `updates:apply` kollidieren nicht mit `full_maintenance_v1`. Dessen separater Helperpfad und das allgemeine/APT-Profil bleiben getrennt; alle benutzen dieselbe geräteweite Wirkungssperre und erhaltene Verbrauchshistorie. ### 1. Unveränderliche Action und Planbindung Vorgeschlagene additive `Action::UpdateAgent { update: ResolvedAgentUpdate }`, eigener Modulvertrag `crates/domain/src/agent_update.rs`. Kein Aufruf von `run_script`, APT oder MSI. Alte Action-/Job-/Plan-/Grantbytes bleiben exakt erhalten. `JobPayload` behält seine bestehenden IDs, Identitätsgenerationen, Zeitgrenzen und Limits; `ExecutionPermit.action` lautet `update_agent` und bindet wie bisher den gesamten `job_payload_hash`. Vor Genehmigung erzeugt der Server die vollständigen Bytes je festem Ziel/Versuch. `ResolvedAgentUpdate` hat in dieser festen kanonischen Feldreihenfolge: | Feld | Typ und Bindung | |---|---| | `schema_version` | Genau1 | | `profile` | Genau `fixed_code_pair_v1` | | `release_envelope` | Schema1, Update-Key-ID, Payload/Signatur als Base64url ohne Padding; keine freien URLs | | `release_envelope_sha256` | SHA256 des kanonischen vollständigen Envelopes, einschließlich Signatur/Key-ID | | `manifest_sha256` | SHA256 der dekodierten exakten Release-Payloadbytes | | `predecessor` | Feste Release-ID, Sequenz, Manifesthash, `installed_record_sha256`, Agent-/Helperhash | | `updater` | Exakter installierter Updaterbinaryhash, lokale Policyhash, Keyringgeneration und Keyringhash | | `peer_pin_transition` | Typisierte Plattformvariante, feste Vorher-/Nachher-Settings-/Pinhashes; siehe unten | | `recovery` | Genau `restore_exact_predecessor_once` | | `health_profile` | Genau `mtls_inventory_sync_v1` | | `health_timeout_seconds` | Genau180 im ersten Schnitt; gesamter Job maximal600Sekunden | | `no_reboot` | Genau `true` | Die beiden Artefakte und ihre Reihenfolge kommen ausschließlich aus dem signierten Manifest. `artifact_ids` als zusätzliche Requestparameter sind für diese Action verboten. Der Plan enthält je Job/Versuch genau die beiden daraus abgeleiteten `JobArtifactReference`s; generisches Nachladen weiterer Dateien ist verweigert. Weil die bisherigen Resolver kleine `artifacts` voraussetzen, erhält ausschließlich `update_agent` einen eigenen Resolver gegen den Updatekatalog. Alte Resolver und ihre Grenzen bleiben bestehen. Fehlende/doppelte/fremde Referenzen, geänderter Vorgänger oder ein von der Plattform abweichendes Release sperren bereits Planung und nochmals Submit, WebUI-Genehmigung, Revalidation, Startgrant und Download. Der vollständige Job muss weiter in die vorhandene64KiB-Helpergrenze passen. Erste Einrichtung importiert die tatsächlich installierte bekannte Codepaar- Baseline als separat release-signierten Datensatz mit eigener Sequenz, prüft ihre Dateien und provisioniert daraus `InstalledReleaseRecord` und Floor. Dadurch besitzt auch das erste Update einen exakten bekannten Vorgänger; kein `unknown`, frei vom Agenten behaupteter Hash oder ungeprüftes Legacy-Downgrade. Dies ist Teil des gesonderten erhaltenden Updaterbootstraps, kein Codeupdate. Windows benötigt einen festen Pure-Renderer: ausschließlich `Settings.agent.binary_sha256` und `Settings.helper.binary_sha256` werden aus den Zielartefakten ersetzt; alle Rechte, Dienste, Identitäten, Pfade, Runtime- und Clockflags bleiben gleich. Der daraus kanonisch abgeleitete Settingshash und öffentliche `Pin`-Hash stehen **vor Genehmigung** fest. Grundlage ist ein typisierter aktueller öffentlicher Deploymentbeleg des bestehenden Helpers, keine Secretdatei. Der lokale Updater prüft vor/nach unabhängig, dass exakt diese beiden Felder geändert werden. Der Server darf nur die exakt genehmigte neue Code-/Policybindung aktivieren; dadurch entstehen keine neuen Aktionsrechte. Linux verwendet bei unverändert codeunabhängigen Generalpins die Variante `unchanged_general_pin_v1`. APT-Akzeptanzbelege werden nicht neu signiert oder als für neue Codebytes gültig ausgegeben; gegebenenfalls bleibt APT geschlossen. Nicht unterstützte weitere Pinprofile sperren dieses erste Update, statt sie automatisch mitzunehmen oder neue Akzeptanznachweise zu erfinden. ### 2. Rechte, Beobachtung und Capability Planurheber und Freigeber benötigen jeweils die üblichen Operationsrechte plus `updates:apply` und Linux `root:execute` beziehungsweise Windows `system:execute`. `scripts:execute` wird nicht daraus abgeleitet. Eine zusätzliche versionierte zentrale/local-Updaterpolicy begrenzt exakte Geräte-/Generations-/Principal-, Updater-/Keyring-/Manifest-/Vorgänger- und Pinbindungen. Standard bleibt deny. Die WebUI zeigt Ziel und Vorgänger, beide Binärhashes, Rechte, Unterbrechung, Rollback, Pinänderung und Fristen; MCP verwendet nur Plan/Submit/Status. `agent.update.check/1` wird nach tatsächlich funktionierendem reinem Metadaten- Check gemeldet. `agent.update.apply/1` erst nach nativer aktueller Qualifikation des installierten unabhängigen Updaters, IPC-/Peer-/Lock-/Ledgerprüfung und bestätigtem signiertem Sync. Ein Librarybuild erzeugt keine Capability. Check speichert Quelle, tatsächlich beobachteten Manifesthash, Zeit, Qualität und `available`/`same`/`not_configured`/`error`; er lädt keine großen Dateien und legt weder Jobs noch Outbox für Wirkungen an. `rolled_back` beim installierten Record ist von der angebotenen Kandidatenversion getrennt sichtbar. ### 3. Begrenzter Releasekatalog und eigener großer Artefaktpfad Neue immutable Tenanttabellen `agent_releases` und `agent_release_artifacts` mit zusammengesetzten Tenant-FKs, RLS/FORCE-RLS und ohne UPDATE/DELETE für die Anwendungsrolle. Release-ID/Sequenz/Plattform sind eindeutig; Publizieren verifiziert Signatur, kanonische Bytes, Rolle, Länge und Hash beider Dateien. Keine Änderung am262144Byte-`CHECK` der bestehenden `artifacts`-Tabelle. Ein tenantgebundener `AgentReleaseStore` arbeitet mit bereits geprüften content-addressierten, unveränderlichen Objekten und begrenzten Readhandles; kein `get()->Vec` für bis256MiB. Publikation ist ein Plattformbetriebsrecht, kein vom Modell befüllbarer allgemeiner Upload-/Signierdienst. Neuer `GET /agent/v1/update-artifacts/{artifact_id}` mit `job_id`, `attempt_id`, `offset`, `length`: Geräte-mTLS, genau genehmigter aktueller `update_agent`-Job, aktuelle Tenant-/Geräte-/Generations-/Rechte-/Planbindung und exakt eine der beiden Referenzen. Jeder Chunk prüft diese Bindung erneut; höchstens512KiB, Gesamtobjekt höchstens256MiB, begrenzte Parallelität/IOzeit und kein Redirect. `Content-Range`, Gesamtgröße und SHA256 sind an den Deskriptor gebunden. Server verifiziert Objektidentität/-länge vor Read und streamt begrenzt; Agent/Updater prüft unabhängig den vollständigen Gesamt-SHA256 und exaktes EOF. Nach Antwortverlust dürfen nur fehlende Downloadbytes desselben geschützten Stagingobjekts weiterbezogen werden, niemals ein neuer Installer-/Aktivierungs- versuch. Eine fortgesetzte Datei wird vor Verwendung vollständig neu gehasht. ### 4. Stabiler Updater, einmalige Übergabe und Absturzverhalten Separat bootstrapped stabiles Updaterbinary; dieser erste Updatejob verändert es nicht. Feste Linux-UID-/Windows-Dienst-SID-/PID-/Image-/ACLprüfungen, keine vom Agenten gewählten Programme/Pfade. Bestehende Agent-/Helper-Servicepfade bleiben erhalten. Alle tatsächlich installierten Profile, die dieselbe Helperbinary verwenden, müssen im fest provisionierten Dienstset stehen und vor Austausch bestätigt gestoppt sein; unbekanntes Profil verweigert. Der Updater gehört selbst nicht zu diesem Stopset. Die erste Empfehlung ist **denselben bestehenden Helperverbrauchsledger und `executor.lock`** zu verwenden, wie heute schon mehrere Helperprofile, statt einen ungebundenen neuen Ready-/SQLitepfad zu eröffnen. Bootstrap fügt nur eigene append-only Updateintents hinzu, ohne alte Zeilen/Schemaobjekte zu ersetzen. Updater prüft seinen aktuellen Prozess-/Boot-/Clock-/Signatur-/Syncbezug selbst; ein anderer Prozess vererbt keine Bereitschaft. Ob der vorhandene gemeinsame Helpersnapshot dies ohne Wireerweiterung vollständig bindet, ist vor Runtime- Code anhand `HelperSync`/`ExecutorLedgerGuard` zu prüfen. Falls nicht, bleibt Apply geschlossen bis zu einer separat versionierten Participantbindung; kein weiterer Journal-ID-Slot wird stillschweigend in alten Tags versteckt. Der Updater darf seinen eigenen Updateversuch nach Verbrauch als einzigen offenen Versuch führen; jeder **andere** offene/unknown-/unsettled-Versuch sperrt. Root-/SYSTEM-Wartungsskripte und Paket-/Rebootwirkungen verwenden dieselbe Sperre. Nach Übergabe überlebt der Updater Agent-/Helperstop und journalisiert im eigenen erhaltenen Intent die folgenden Phasen: | Phase | Dauerhafter Beleg und zulässige Folgerung nach Absturz | |---|---| | `staged_verified` | Nur geprüfte Dateien vorhanden, noch kein Stop/Swap; Nichtstart nur mit unabhängig belegtem Nichtdispatch | | `handoff_consumed` | Originaljob/Grant/Versuch und vollständige Vorherzeugen fest, kein zweites Execute | | `stop_intent` / `all_stopped` | Einmaliger Stop angekündigt/bestätigt; unklare Dienste erst lesen, nicht blind erneut stoppen/starten | | `replace_intent(role)` / `replaced(role)` | Jede einzelne Code-/Pinersetzung bindet Original-/Zielhash, ACL und retained Backup; tatsächliche Datei entscheidet über Teilzustand | | `pair_verified` | Gesamtes neues Code-/Pinset vollständig geprüft, vor jedem neuen Dienststart | | `start_intent(service)` / `started(service)` | Jeder Start nur einmal, tatsächliche SCM-/systemd-/PID-/Imagebelege, kein Retry bei verlorenem Reply | | `health_verified` | Neues mTLS, tatsächlicher Codepaarbeleg, Inventar-ACK und signierter Sync für selben Originalversuch innerhalb180Sekunden | | `rollback_intent` / `rollback_verified` | Ausschließlich gebundene Originalcode-/Pinbytes einmal zurück, gleicher aktueller Datenzustand und unveränderter Floor | | `outcome_persisted` | Originalerfolg oder bekannter Fehlstart samt Rollbackresultat dauernd gespeichert; unverändert bis ACK erneut übermitteln | Anwendungsweite Effectgates bleiben während Wechsel und Health geschlossen; der eigene bereits verbrauchte Updateversuch darf gezielt abgeglichen werden, ohne dadurch neue allgemeine Starts zu erlauben. Sonst würde die eigene offene Updatezeile Health-Sync dauerhaft blockieren. Nach frischem Prozessstart ist kein alter Gate-/Leasezustand gültig. Ein unbekannter Teiltausch/Start bleibt `unknown`; Recovery liest vorhandene Dateien/Intents und darf daraus keine neue Wirkungserlaubnis konstruieren. Allgemeines Resume bei ungeklärtem Dispatch und Endlosschleifen automatischer Rollbacks gehören nicht dazu. ### 5. Konkrete Datei-/Abnahmefolge nach erneutem Review | Lieferung | Geplanter enger Dateiscope und überprüfbares Ergebnis | |---|---| | Gemeinsamer Vertrag | Additives `domain/src/agent_update.rs`, zugehörige `Action`-Matches und Golden-/Legacyfixtures; `updater` bleibt eigenständiger Verifier, keine OSwirkung | | Katalog und feste Planung | Neue Migration, `server/src/agent_releases.rs`, eigener Store/Streaminghandler, begrenzte Ergänzungen in `jobs`, `job_gateway`, Policy und MCPschema; alte Paketlimits bleiben bestehen | | Passive Agentbeobachtung | Bestehende Transport-/Inventarworker ergänzen festen Releasecheck und gespeicherte Beobachtung; keine angeforderte Liveaktion als Telemetrie tarnen | | Geschlossener Updaterworker | Neues unabhängiges Binary/OSadapter und versionierte Bootstrapdefinition, feste IPC/Locks/Ledger/Intents/Pinrenderer; keine offenen neuen Capabilities vor Qualifikation | | Linux-Abnahme zuerst | Reine Kernunits nativ auf Cloud-Linux; danach ein fixes WebUI-genehmigtes Update samt getrennten belegten Fehler-/Redelivery-/Stateerhaltungsfällen | | Windows danach | Native Kern-/IPC-/SCM-/Pin-/Codepaar-/Rollbackabnahme auf Windowsgast, dieselbe WebUI-/Tenantgrenze; keine Notebookdienste | Vor Runtimefreigabe sind vor allem gemeinsamer Syncteilnehmer, exakt erlaubte Pinprofile und erfolgreiche Health bei ausschließlich eigenem offenen Updateversuch zu entscheiden. Diese Liste enthält keine neue Terminalengine, generischen Paketprovider, Keyrotationplattform, Restorefunktion oder weiteren Produktumfang. Alle genannten Dateien/Befehle/Abnahmen dieses Abschnitts sind **geplant, nicht ausgeführt**. ## Geprüftes Runtimegate: eigener offener Versuch und Health Sourcebefund, **Entwurf ohne Produktänderung**: `HelperSync::apply` in `crates/agent-core/src/helper_reconcile.rs:482` darf einen gültigen negativen signierten Abgleich dauerhaft übernehmen. Die Startlease bleibt geschlossen: `apply_inner` verlangt definitive Outcomes für sämtliche Zeilen und `can_start` zusätzlich null offene `consumed.result IS NULL`-Zeilen (`:575`, `:666`, `:696`). Deshalb darf Update-Health niemals allgemeines `ready=true` voraussetzen oder trotz eigener offener Zeile erzeugen. Der normale Wiederabgleich macht gestartete unvollständige Versuche bewusst unknown (`agent-core/src/reconcile.rs:233`, `server/src/synchronization.rs:717`) und `ClientSync::confirm_helper` verweigert offene Helperwirkungen (`:127`). Dies zu ignorieren wäre keine Healthimplementierung. Benötigt wird ein neuer, ausdrücklicher **dauerhafter `pending/inflight`-Handoffvertrag** des genau genehmigten Updateversuchs. Er muss kontrollierte Eigentümer-/Prozessübergaben von einer tatsächlich unklaren Wirkung unterscheiden, ohne frühere Unknown- Events, definitive Unknown-Outcomes, Startzeugen oder Deadlines umzuschreiben. Fehlender Owner-/Handoff-/Zeitnachweis bleibt unknown und geschlossen; ein späterer Healthbeleg heilt ihn nicht und berechtigt keinen erneuten Start. Windows hält `LedgerGuard` während der gesamten Helper-Dienstlebensdauer (`agent-windows/src/helper_system.rs:222`, `:822`). Der separate Updater kann denselben echten Lock daher nicht gleichzeitig erwerben und über den neuen Helperstart halten. Empfohlener enger Pfad: alter Helper prüft Originalgrant und verbraucht genau einmal, speichert immutable Delegations-/Ownerintent; stabiler Updater übernimmt denselben Ledger ausschließlich während bestätigtem Helperstop, prüft/tauscht Code+Pins und gibt die Ownership vor dem neuen Helperstart ausdrücklich zurück. Der neue Helper hält danach wieder seinen bestehenden Guard. Kein globaler Umbau zu schwächeren Locks pro Einzelrequest. Vorhandene IPC vertraut ausschließlich dem Netzwerkagenten: Linux verweigert Root-Peers ausdrücklich (`privileged-helper/src/main.rs:92`), Windows bindet Agent-Service-SID/SCM-PID/Peerimage (`agent-windows/src/helper_ipc.rs:227`). Ein Updater darf sich nicht als dieser Agent ausgeben. Er benötigt eine neue eng typisierte **lokale Participantbindung** mit festem eigenem Dienst, UID/SID, tatsächlichem PID-/Image-/Prozessgeburts-/Policybeleg und ausschließlich Original-Handoff, Healthbezug und Finalisierung dieses einen Versuchs. Root oder SYSTEM allein sind kein ausreichender Peerbeleg. Bestehende ACL-/FileID- Prüfungen dürfen dabei nicht stillschweigend gelockert werden. Gemeinsames erhaltenes Helperledger und aktueller Sync-Wirevertrag reichen für die Historie grundsätzlich; eine zweite ungebundene Server-Journal-ID ist für diesen Pfad nicht erforderlich. Ein negativer aktueller SignedSync ist nur Kontrollkettennachweis. Zusätzlich vorgeschlagen: ein **evidenz-only** signierter `UpdateHealthReceipt` mit eigener Domäne, Originalplan/Job/Versuch/ Grant, Manifest/Codepaar/Pins, Ownernonce, Boot/Verbindung, tatsächlich angewandtem SignedSync und frisch serverseitig gespeicherten Inventarbelegen. Er ist weder ExecutionPermit noch Startlease, reaktiviert keine Genehmigung und verlängert weder Originalstart- noch Health-/Gesamtdeadline. Erst nach unabhängigem lokalem Code-/Peer-/Intenterhaltungsnachweis und gültigem Receipt dürfte der neue Helper das **noch ausstehende ursprüngliche** definitive Outcome create-once speichern. Originale Signaturen/Events bleiben erhalten; generisches Ersetzen eines vorhandenen Unknown-Outcomes ist ausdrücklich ausgeschlossen (`ledger::persist_outcome`/Completion-CAS). Anschließend sollen vorhandene Helper→Agent-Spiegelung und normaler signierter Abgleich die gleiche Outcome-Bytefolge übernehmen und gezielt entsperren (`agent-core/src/reconcile.rs:898`, `helper_reconcile.rs:616`). Die vorhandenen Reboot-Sonderregeln für geänderte Outcomebytes werden nicht auf Updates verallgemeinert (`helper_reconcile.rs:1312`, `reconcile.rs:1237`). Vor Applycode sind Pending-/Inflight-Lebenszyklus, Ownershipwechsel, neue lokale IPC-/ACLbindung und die rein beweisende Receiptsemantik normativ zu prüfen. Dieser Befund ist **keine Freigabe oder Implementierung** dieser Erweiterungen.