34 KiB
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=<feste-plattform>, ü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.
- 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.
- Manifest und beide Dateien unabhängig prüfen; keine Wirkung vor Genehmigung. Ein Downloadfehler vor Übergabe bleibt belegter Nichtstart der Aktivierung.
- 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.
- 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.
- 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.
- 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.
Runningallein reicht nicht. Erst dann aktives Release/Antirollbackgrenze dauerhaft bestätigen. - 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:
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.
Danach bestand derselbe Prüfkern als Windows-GNU-Unitbinary9/9 auf dem
Windowsgast, Fall 1a6dba2a-0db3-4aa8-8e21-dafcaabf85e3, Proof-SHA256
fc6ef028f0d71639b940914d2cf66e809ed96f9803b4b0b10ea63c6e08978493;
separater Nachweis, 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.
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
JobArtifactReferences; 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<u8> 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.