Merge reviewed default-deny agent updater source checkpoint

# Conflicts:
#	docs/agent-updater-linux-native-results.md
This commit is contained in:
2026-11-14 21:49:38 +01:00
94 changed files with 28759 additions and 69 deletions
+231
View File
@@ -0,0 +1,231 @@
# 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.
+206
View File
@@ -0,0 +1,206 @@
# Linux-OS-Port des unabhängigen Updaters
Stand2026-11-14: neue Bibliothek `rmm-updater-linux`, auf Auftrag des Hauptagenten
isoliert neben Domain/Core und Server/WebUI implementiert. **Noch kein laufender
Updaterdienst und keine Applyabnahme.** Native Linux-first-Abnahme und sämtliche
Zielaktionen bleiben beim Hauptagenten. Der vorhandene Releaseverifier, dessen
Native-Runner sowie der separat qualifizierte achtteilige Handoffkernel bleiben
unverändert.
**Aktueller lokaler Quellenstand nach unabhängigem Review:** Der weiter unten
erhaltene4-Fälle-Beleg ist historisch. Ein echter Same-PID-Exec-Bindungsfehler
wurde korrigiert, mit dem alten Code reproduziert und im neuen lokalen
5-Fälle-Nachweis geschlossen. Dieser lokale Schritt allein ist kein nativer
VM- oder Applynachweis; die danach separat durch Root ausgeführte native
OS-Unitqualifikation ist am Ende ergänzt.
## Implementierte Betriebssystemstrecke
`files` öffnet jede Verzeichniskomponente mit gehaltenem `openat`-Dirfd,
`O_NOFOLLOW` und `O_CLOEXEC`. Rootgeschützte installierte Verzeichnisse dürfen
keine gruppen-/weltbeschreibbaren Vorfahren haben. Dateiprüfungen binden
Device/Inode, UID/GID, Modus, vorhandene Linkzahl, Länge und SHA256; Hashing
benutzt höchstens32KiB Lesepuffer. Historisch gebundene Hardlinks werden nicht
pauschal verboten. Neue Stages haben genau einen Link.
Die vier Produktionsziele sind geschlossen: Agent, gemeinsame Helperbinary,
Fullkonfiguration und Fullpin. Aus einem Request kommt kein Zielpfad.
Staging entsteht exklusiv im **gleichen gehaltenen Installationsverzeichnis**,
mit exaktem EOF/Längen-/Hashnachweis, ursprünglichen Besitz-/Moduswerten und
Datei-/Directory-fsync. Fehlerhafte/partielle Stages bleiben erhalten und
werden nicht automatisch wiederverwendet oder gelöscht. Der eingebettete
Downloadreader muss selbst IOzeit und Kanalabbruch begrenzen; die Bibliothek
prüft das ursprüngliche Boot-/Monotonbudget zwischen IOschritten, kann aber
keinen beliebig blockierenden fremden `Read`-Aufruf unterbrechen.
Ein Austausch verlangt einen tatsächlich gehaltenen `LedgerGuard`. Vor jedem
Namespaceeingriff werden dessen aktuelle Dateiidentität, weiterhin gestoppte
Reader und Budget geprüft. Der Vorgänger wird mit `RENAME_NOREPLACE` unter
seinem erhaltenen Inode auf einen festen Backupnamen verschoben; danach wird
die verifizierte Stage ebenfalls ohne Überschreiben an den Originalpfad
verschoben. Jede Phase benötigt vorher den dauerhaften `DurableEffectFence`.
Ein Crash zwischen den Renames ist ausdrücklich **kein atomarer Bundleswap**:
Vorgänger und Stage bleiben nachlesbar, neuer Execute-/Resumeversuch verboten.
Ein zulässiges einmaliges Rollback benötigt eine eigene vorab gebundene Fence;
es erhält beide Codegenerationen und verändert keine Zustandsdatei oder Floor.
`process` bindet echte `pidfd`s, ein gehaltenes `/proc/PID`-Verzeichnis,
Prozessgeburt, alle UID/GIDwerte und ein gehaltenes Rootimage. Exithinweise
und nachträgliche Abweichung verweigern. Imagehashing verwendet `pread`, damit
parallele Nachlese keinen gemeinsam verschobenen Dateioffset verwendet.
Nicht unterstützte Kernel erhalten keinen PID-/Prozessnamenfallback.
Vor und nach dem Hashen wird das **aktuell ausgewählte** `/proc/PID/exe`
erneut durch das gehaltene Proc-Verzeichnis geöffnet und per Device/Inode
gegen das ursprüngliche Image gebunden; Geburt, Konten und pidfd werden
danach nochmals geprüft. Ein noch lesbarer alter Image-FD allein genügt nicht:
`execve` behält PID, Geburt und Credentials, wechselt aber die Codegeneration.
`services` kennt ausschließlich Agent/General/Full und optional den bereits
inaktiven, deaktivierten APT-Reader. General und Full müssen dieselbe
Helpergeneration haben. Geladene Unit und sämtliche Drop-ins werden als
geschützte Fileproofs gebunden; Running/PID/Invocation-ID, native Prozesszeugen
und tatsächliche Konten werden unabhängig nachgelesen. Ein Rootpeer genügt
nicht: `SO_PEERCRED` muss zur aktuellen konkreten Helper-/Updater-Dienstinstanz
mit gehaltenem Prozess passen. Der stabile Updater ist getrennt, UID/GID0,
und gehört niemals zum Stopset.
Stop und Start benutzen feste argv an `/usr/bin/systemctl`, keine Shell oder
freien Kommandos. Es gibt keine Enable-, Reboot- oder APT-Startoperation.
Stop startet genau eine Systemdanforderung pro gebundenem alten Dienst und
beobachtet danach dessen tatsächliches Ende. Nach vollständigem Code-/Pinpaar
und Ledger-Rückgabe startet der enge Anschluss General, Full und Agent einmal.
Timeout des eigenen Clients beendet nur dessen gehaltenen pidfd-Prozess;
Systemd kann den Auftrag bereits übernommen haben. **Jeder Fehler nach
möglicher Übergabe bleibt unklar; nie still wiederholen oder als Nichtstart
ausgeben.**
`LedgerGuard` öffnet ausschließlich vorhandene `consumption.sqlite` und
`executor.lock` unter `/var/lib/rmm-helper`. Kein Create/Truncate, kein neuer
Journal-ID-Slot. Exklusive `flock`-Übernahme erfolgt erst nach bestätigtem Stop
aller installierten Reader und bindet beide exakten Dateiidentitäten. Die
Lebensdauer leiht `StoppedServices`; ein gleichzeitiger Start derselben
Kontrollinstanz ist so ausgeschlossen. Vor Abgabe muss die eingebettete Fence
den ursprünglichen `LedgerReturnIntent` dauerhaft gespeichert haben.
## Lokaler Kanal und noch fehlende Integration
Der implementierte IPC-Transport bindet ausschließlich den vorher separat
provisionierten privaten Rootpfad `/run/rmm-agent-updater/control.sock`.
Vorhandene Sockets werden weder entfernt noch wiederverwendet. Vor Parsing und
Dispatch wird der tatsächliche aktuelle Helperdienst mit SO_PEERCRED und
gehaltenen Prozess-/Unitzeugen authentisiert. Der Client authentisiert den
fest provisionierten Updater unabhängig vor dem Senden und vergleicht seine
Antwort mit genau diesem Participantbeleg. Ein begrenzter Längenheader erlaubt
höchstens32KiB und eine Anfrage pro Verbindung. Methods sind Describe, Activate,
Read und Health; keine Approval-, Pfad-, Befehls- oder neue Startgranterteilung.
`ready` bleibt zwingend false. Activate-IOfehler erlaubt ausschließlich Read.
Es wird bewusst **keine permissive Engine/Fence und kein unfertiges Daemonbinary**
ausgeliefert. Der Core-Eigentümer integriert Originalsignaturen, aktuelle
TrustedClock/Trustpolicy, immutable Handoff/Delegation im bestehenden Ledger,
alleinigen logischen Owner, feste Staging-/Fullrendererzeugen und den
evidenz-only SignedSync-/Inventarhealthbeleg. Die beiden nativen Rename-Intents
pro Datei sind zusätzliche vorhandene-ledger-gebundene Effectintents, keine
Verdoppelung der begrenzten16 Handoffevents. Ein verlorener Writer oder
definitives Unknown wird niemals durch diese OSbeobachtungen geheilt.
Noch offen: konkrete Core-Fence-/Engineimplementierung, monotone Floor- und
InstalledRecordpublikation, Dienstbootstrap/stabiles Binary, tatsächliche
Systemd-/IPC-/Staging-/Dateitausch-/Rückgabekette und zulässiger Rollback im
WebUI-genehmigten Updateversuch. Der Loopback-/Rootbootstrapweg ist keine
Jobgenehmigung. Notebook bleibt ausschließlich Entwicklungsrechner.
## Tatsächlich lokal geprüft
Isolierter Offline-Buildcontainer aus dem vorhandenen Image
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
Private eingefrorene Quellkopie mit nur Domain/Handoff/Linuxport als
Workspacemembers, unveränderten Dependencyversionen; der private Lock wurde
dort offline aufgelöst, ursprünglicher Workspace/Lock durch diesen Subagenten
nicht verändert. Eigener Targetpfad `devstate/agent-updater-linux/target`.
Bestanden: Releasebuild und **4/4** Prüfungen, keine Skips/Filter, Clippy mit
`-D warnings`, Formatcheck. Die beiden echten OSprüfungen betreffen ausschließlich
neue private `/run`-Unitfixtures und einen eigenen gehaltenen Sleep-Prozess:
Symlink-/Namensersatz-/Modusverweigerung, erhaltene gebundene Hardlinks,
PID-/Geburts-/Image-/Konten-/Exitbindung und ursprüngliche Deadline. Der dritte
Fall verweigert übergroße, doppelte, unbekannte und ungebundene IPCfelder.
Der vierte nutzt ausschließlich ein lokales Unix-Socketpaar und belegt, dass
fragmentierte Nachrichten die feste Gesamtlesefrist nicht durch einzelne
erfolgreiche Bytes verlängern können; es läuft kein lauschender IPCserver.
Die ursprüngliche Jobfrist begrenzt dabei auch jeden einzelnen blockierenden
Socketaufruf; der zweite Teilfall belegt die kürzere Jobfrist gegenüber der
längeren Framefrist.
Dabei fand er einen echten Serde-Fehler: eine leere Unitvariante ignorierte
Zusatzfelder; die strikte leere Structvariante ist korrigiert und nachgeprüft.
Erster Compilerlauf meldete einen mehrdeutigen `File::by_ref`; typisiert
korrigiert. Clippy forderte einen typisierten Stagingdescriptor statt acht
einzelner Argumente; kein Lint wurde unterdrückt.
Keine lokale oder native Dienst-/IPCserversitzung, kein Aufruf von Systemd,
kein Zugriff auf echte RMM-Zieldateien, kein Releaseapply und keine VM-Aktion.
Diese Nachweise sind keine Abnahme der noch fehlenden Runtimeintegration.
Der create-only Nachweis liegt privat unter
`devstate/agent-updater-linux/qualification-19449c78-6919-4e25-8750-cd3c450fb68e/`.
Er bindet die tatsächlich verwendete eingefrorene Quellkopie, Befehle,
Exitcodes und stdout/stderr. Linuxport-Quellsatz:
`699276d3d3e467143d8ccf0fcb3b51949d3c2fffb1f7d0f0a167239ea2b10404`;
Receipt: `ff569473d0ca8179948429f1fc78404e09c1666e4053b6efe672edf079696adc`;
qualifiziertes lokales Unitbinary:
`25e9de040b8a461291efb9566c02b6b3c2cb98d032ae8d071278dbbc0b2642cf`.
Der frühere lokale 3-Fälle-Nachweis bleibt unverändert als historischer Stand
erhalten und qualifiziert diese neuere Quelle nicht.
## Fortschreibung: Same-PID-Exec-Gegenbeleg und Korrektur
Der unabhängige Review fand, dass `HeldProcess::verify` zunächst nur das alte
gehaltene Image erneut hashte. Ein `execve` im gleichen Prozess blieb dadurch
unentdeckt. Die Korrektur bindet das aktuelle Kernel-Exeziel vor und nach dem
Hashen an den ursprünglichen Dateizeugen und prüft die übrige Prozessidentität
erneut. Es gibt keinen Prozessnamen-/PID-Fallback oder gelockerten Proc-Zugriff.
Die neue echte OSprobe startet ausschließlich einen eigenen Bashprozess,
öffnet dessen pidfd/Image/Geburts-/UID-/GIDzeugnisse und lässt ihn über seine
eigene Pipe nach `/usr/bin/sleep` execen. Ein neuer unabhängiger Zeuge bestätigt
dieselbe PID, Geburt und Konten, ein weiter lebendes pidfd sowie den tatsächlich
geänderten Imagehash. Der alte Zeuge muss verweigern. Die Kindumgebung ist
geleert; ein RAII-Wächter beendet und wartet ausschließlich dieses eigene Kind
auch bei einem Testpanic. Keine RMM-Dienste oder fremden PIDs werden berührt.
Tatsächlich lokal ausgeführt, isolierter Offlinecontainer mit eingefrorener
Domain-/Handoff-/Linuxport-Quellkopie: korrigiert **5/5 ohne Skips/Filter**, Clippy
`-D warnings` und Formatcheck bestanden. Danach wurde ausschließlich in dieser
privaten Kopie `process.rs` durch die Originalquelle des erhaltenen4er-Belegs
ersetzt. Die neue Execprobe scheiterte erwartungsgemäß mit Exit101 genau an
`held.verify().is_err()`. Nach Rückkehr zur korrigierten Quelle bestanden erneut
alle5Fälle. Das ursprüngliche4er-Receipt und dessen Binärdatei bleiben erhalten.
Enger unabhängiger Re-Review des Fixes und seiner Belege: **PASS**.
Neuer create-only Beleg:
`devstate/updater-linux-execfix-aa106c58-8c96-4c8a-8490-635b1d143f07/receipt.json`,
SHA256 `f705ba03e5043a411fc3a0642197fc4f16da8627e1e5cbfbac78ed125ecb650c`.
Finale lokale Unitexe:1538320Bytes, SHA256
`b11b57e6399dcfcfb255619a8fba558beea6a57e4f1ee997ee9c63c769a1e882`.
Snapshot und ursprüngliche Logs einschließlich des erwarteten Gegenfehlers
bleiben privat erhalten. Nicht ausgeführt: VM, Systemd, IPCserver, Daemon,
Releaseapply oder Deployment. Gerade der tatsächliche Generalhelperkontext
kann andere Proc-/Capabilitygrenzen besitzen; ein isolierter Rootcontainer
qualifiziert diesen noch nicht. Fehlender Proc-/Imagezugriff muss verweigern,
keine Sandboxlockerung aus diesem lokalen Erfolg ableiten.
## Anschließend tatsächlich auf Cloud-Linux geprüft
Root führte die eingefrorene finale5er-Unitexe anschließend separat auf der
festgelegten Linux-Cloud-VM als UID0 aus: Fall
`ec030323-85df-4b38-9e70-87be330033c2`, genau5bestanden,0Skips/Filter.
Eine getrennte Same-case-Nachlese war identisch. Keine RMM-Jobs, kein Apply,
keine Dienststeuerung oder Änderung der laufenden Agent-/Helpergenerationen.
Der Fullhelper blieb aktiv, seine Unit weiterhin disabled; daraus folgt kein
Autostartnachweis. Der vollständige von Root veröffentlichte Originalbericht
wird bytegleich übernommen: [Native Linux-OS5](agent-updater-linux-native-results.md)
(Maincommit `c35c440`). Historische lokale Belege bleiben unverändert.
Das ist ein nativer OS-Unitnachweis, ausdrücklich **keine Qualifikation des
restriktiven tatsächlichen Generalhelper-Dienstkontexts**, der konkreten
IPC-Peers, Engine/Fence oder Releaseaktivierung. Diese Gates bleiben offen.
+91
View File
@@ -0,0 +1,91 @@
# Reinen Updater-Prüfkern zuerst auf Cloud-Linux qualifizieren
Stand 2026-11-14: Runner implementiert, lokal vorbereitet und anschließend vom
Eltern-Orchestrator **auf der Cloud-Linux-VM ausgeführt:9/9 bestanden**.
Dieser Schritt prüft ausschließlich die neun bereits lokal
bestandenen Verifierverträge. Er installiert weder Updater noch Agent/Helper,
öffnet keine Capability und führt keine Update-/Installer-/Skript-/RMM-Jobs aus.
`deploy/agent_updater_contract_acceptance.py` bindet den unabhängig geprüften
Kerncommit `cc5c93596d0864c526b69a4f7efca805599b6ea1`, bestehende lokale
Qualification, Sourcehashes und unveränderte Testexe. Änderungen an späterer
Dokumentation erzeugen keinen falschen Rebuildbedarf. NativeDriver und die
wiederverwendeten geprüften SSH-/Receipt-Helpers erhalten eigene Sourcehashes.
Ein neuer Driverstand macht alte vorbereitete Manifeste absichtlich ungültig.
Tatsächlich lokal ausgeführt:
```text
python3 deploy/agent_updater_contract_acceptance.py --help
python3 deploy/agent_updater_contract_acceptance.py prepare-local --qualification /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater/local-qualification.json
```
Das bestehende Testimage wurde **nicht neu gebaut oder erneut ausgeführt**.
Originalbytes wurden create-only in den neuen geschützten Vorbereitungsordner
kopiert. Nur `readelf` lief im gepinnten Offline-Dockerimage. ELF-x64, maximale
GLIBC2.34 und benötigte dynamische Bibliotheken wurden ermittelt; native
Lader-/Ausführungsfähigkeit bleibt bis zum VM-Lauf offen.
Lokales Manifest:
`devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json`,
SHA256 `a7f0903cea77c36c4d40df5ad486161c10e55bb9a9135629a555ffafd411d521`.
Testexe unverändert1544584Bytes, SHA256
`e3a1a3140da09de2f86055faa45faf7ba05ddddc2d92d23fef3df03a63bf2999`.
Python-/erzeugte Remotequellsyntax sowie sechs Ergebnis-Verweigerungsfälle,
Readback-ohne-Upload/-Run und fehlendes Native-Opt-in wurden lokal mit
Transport-Mocks geprüft; keine SSH-Verbindung und kein erneuter Unitlauf.
**Anschließend tatsächlich durch den Eltern-Orchestrator ausgeführt:**
```text
python3 deploy/agent_updater_contract_acceptance.py linux --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --execute-native-tests
```
Der Runner liest erst bei diesem expliziten Aufruf die bereits vorhandene streng
geparste Linuxzugangskonfiguration aus dem Maincheckout. Ausschließlich der feste
Cloudclient als root auf der festgelegten Linux-Test-VM, vorhandener SSH-Key und bestätigter Hostkey sind
zulässig. Keine Zugangsdaten im Argument-/Ergebnispayload oder Chat.
Remote wird ein neuer rootprivater Fall unter
`/var/lib/rmm-agent-updater-contracts/<UUID>` einmal angelegt. Die exakt gehashte
Testexe muss vor Start alle neun erwarteten Testnamen melden. Sie läuft mit
geleerter Umgebung, eigener Scratchdirectory, Netzwerknamespace und CPU-/RAM-/
Outputlimits. Vor dem einzigen Lauf steht der dauerhafte Create-once-Startmarker.
Bei verlorenem Reply niemals `linux` erneut ausführen oder neu hochladen.
Die ursprüngliche UUID steht im lokalen
`devstate/agent-updater-native/<UUID>/intent.json`; anschließend ausschließlich:
```text
python3 deploy/agent_updater_contract_acceptance.py readback-linux --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --case <ursprüngliche-UUID>
```
Readback liest Ergebnis oder tatsächlichen Teilstatus desselben Falls. Es darf
weder Upload noch Unitstart fortsetzen. Fehlender/unklarer Abschluss bleibt
`verified=false`, `retry_allowed=false`. Erst vollständig geprüfte Original-
Ergebnisse9/9 ohne Skip schreiben `linux-passed.json`. Dieser Nachweis ist auch
dann **nur native Kernqualifikation**, keine erfolgreiche Agentaktualisierung,
WebUI-Abnahme, Windowsqualifikation oder Produktdienst-/Capabilityfreigabe.
## Tatsächlicher Cloud-Linux-Nachweis
Rootfall `420d53da-6e34-4e04-b871-0b571d8d3fc4` auf dem festgelegten Cloudclient
der Linux-Test-VM: Der Runner prüfte zuerst die vollständige tatsächliche Liste
der neun erwarteten Tests und führte danach exakt diese neun ohne Skip aus.
Exitcode0, kein Timeout und keine Fehlerausgabe. Geleerte Umgebung,
Netzwerknamespace und unveränderte gehashte Originaltestexe sind im Ergebnis
gebunden. Keine Produktzustandsänderung und kein RMM-Job durch diese Units.
Der geschützte lokale Beleg `linux-passed.json` neben dem oben genannten
Manifest wurde zurückgelesen und unabhängig gegen erwarteten Fall,
Manifest-/Artefakthashes und alle neun Testnamen geprüft. Proof-SHA256:
`bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`.
Die tatsächliche VM-Ausführung erfolgte durch Root; der Verifier-Subagent
führte weiterhin keine eigene SSH-/VM-Aktion aus.
Damit ist der **reine Linux-Prüfkern nativ qualifiziert**. Der danach getrennt
ausgeführte Windows-GNU-Schritt bestand ebenfalls9/9; tatsächlicher Beleg und
Grenzen stehen in [Windows-Kernqualifikation](agent-updater-windows-contracts.md).
Selbstupdateinstallation,
Releasekatalog/Streamingtransport, feste Plan-/Grant-/WebUI-Bindung,
Updaterprozess und Code-/Pin-Aktivierung/Health/Rollback bleiben unverändert
offen. Dieser Erfolg bescheinigt keinen vollständigen Agent-Autoupdater.
+526
View File
@@ -0,0 +1,526 @@
# 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.
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<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.
+62
View File
@@ -0,0 +1,62 @@
# Koordinierter Updater-Quellencheckpoint1.21
2026-11-14. Dieser Checkpoint verbindet den unveränderten signierten Verifier,
den eingefrorenen Handoffkernel, Linux-OSports sowie Domain-/Core-/Protokoll-,
Server-/MCP-/WebUI-Quellen. Er enthält keine ausgelieferte Applyruntime und
keinen erfolgreichen Updatejob auf der Cloud-VM.
Implementiert sind der feste Updateplan mit zwei eigenen streambaren Artefakten,
immutable Tenantkatalog, zusätzliche deny-only Rechte-/Policyprüfung für Ersteller
und Freigeber, genaue WebUI-Byte-/Hashanzeige und der eigene passive agent.update-
Scope. Der Agent meldet dafür derzeit ausschließlich not_configured; qualifizierte
Apply-/Checkcapabilities werden daraus nicht abgeleitet. Der vorhandene kleine
Paketartefaktpfad bleibt unverändert.
Im bestehenden Helperledger werden Verbrauch, alter Startzeuge, Handoff,
Delegation und Stopintent atomar gespeichert. Typisierte Inflightkontrolle hält
beide Readyflags und Unlock geschlossen. Native Unterintents sind create-once,
rollen-/Head-/Nonce-gebunden und erhalten Originalhistorie. Getrennter geschützter
Healthkey und Originalplanpin ersetzen jede frühere Jobsignerannahme. Die neue
Serverroute prüft gespeicherte Original-Sync-/Baseinventarbelege; der konkrete
lokale Fullguard muss diese unabhängig gegen eigene tatsächlich angewandte
Rawbytes und Applyzeit prüfen. General ist dafür nicht zuständig und darf ein
Originalupdate aus diesem Grund nicht zu Unknown machen.
Der Worker enthält echte geschützte Dateizeugen, historischen Originalrequest-
Replay, Uhr-/Boot-/Deadlineprüfung, tatsächliche Prozess-/Dienstidentitäten,
Originalledger- und native Dateieffektzäune sowie lokale Trust-/Baselineprüfung.
Diese Bibliotheksbausteine sind kein aktivierter Daemon oder qualifizierter
End-to-End-Dispatcher.
Lokal tatsächlich ausgeführt im vorhandenen Rust-Buildcontainer, Netzwerk aus:
- Gemeinsamer all-targets Check für Agent, Windowsquellen unter Linux-cfg,
privilegierten Helper, Worker und Server: PASS.
- Core64, Domain23 und Server45 Tests: PASS; fünf vorhandene Server-DB-Harnesstests
ausdrücklich ignored. Diese5 sind kein DB-Abnahmenachweis.
- Betroffene gemeinsame all-targets Clippyprüfung mit -D warnings: PASS.
- Formatprüfung der betroffenen Pakete: PASS.
- Echter separat baseline-/release-signierter Worker-Gegenfall:1/1 PASS.
Exakte historische aktive Sequenz/Manifest bestehen; gleiche oder niedrigere
Kandidaten am unveränderten Floor, Ablauf und Keywiderruf verweigern.
Private Rückmutation auf den früheren Fehler active_release=None scheitert
reproduziert mit Exit101. Das ist ein lokaler Trusttest, keine VM-Anwendung.
Lokale Befehls-/Logbelege liegen geschützt im ignorierten Verzeichnis
`devstate/updater-checkpoint-090e6ad9-c88e-4f38-b6e1-f7fc1f189244/`.
Die getrennte Deliveryqualifikation dokumentiert PostgreSQL15-Migrations-/RLS-
und Webprüfungen in [agent-updater-server-console.md](agent-updater-server-console.md).
Der tatsächliche Linux8-Kernel- und Linux5-OSnachweis ist separat in
[agent-updater-handoff-linux-results.md](agent-updater-handoff-linux-results.md)
und [agent-updater-linux-native-results.md](agent-updater-linux-native-results.md)
dokumentiert. Root-OSfixtures ersetzen keinen General-/Full-Dienstkontextnachweis.
Historische Belege bleiben unverändert.
Für eine wirkliche erste Anwendung fehlen weiterhin die enge Fullbridge mit
qualifizierter Owner-/Healthguard-Implementierung, atomar übergebene live
Workerdispatchstrecke, Record-/Floorpublikation, erhaltende1.21-kompatible
Bootstrapbaseline, gültiger passiver Kandidatenzustand, ein neuer konkreter
WebUI-genehmigter Linux-Apply sowie dessen unabhängiger Health-/Erhaltungsnachweis.
Restore/Rollback bleibt deny, weil der unveränderte Vorwärtskernel noch keinen
qualifizierten Rückweg besitzt. Windowsapply ist separat offen. Kein Zielhost
wurde durch diesen lokalen Checkpoint installiert, gestoppt oder aktualisiert.
+219
View File
@@ -0,0 +1,219 @@
# Agent-Selbstupdate: Serverkatalog, Transport und feste WebUI-Pläne
2026-11-14, isolierter Quellenstand im Updaterbranch. Server und WebUI sind
implementiert und lokal geprüft; **kein Deployment, kein nativer Applylauf und
noch kein aktiver Autoupdater**. Der beauftragte Schnitt verwendet ein eigenes
signiertes Agent-/Helper-Codepaar, keine APT-/MSI-Fixture und kein Wartungsskript.
Domain, lokale Helper-/Handoffruntime und signierter Inflightabgleich werden
getrennt integriert. Die Produktentscheidung und Zielabnahme bleiben beim
Hauptagenten; diese Seite ersetzt weder dessen Review noch die Linux-first-Gates.
## Planung und unveränderte Genehmigungsgrenze
HTTP und MCP benutzen dieselbe neue `plan_request`-Auflösung. Für
`action="update_agent"` sind ausschließlich folgende Aktionsparameter erlaubt:
```json
{
"release_id": "11111111-1111-4111-8111-111111111111",
"execution_identity": "root",
"timeout_seconds": 600,
"max_output_bytes": 65536
}
```
Dies ist ein synthetisches Schemafragment, kein ausführbarer Auftrag. Feste
Asset-IDs, Fristen, Rolloutlimits und Grund stehen wie bisher daneben. Keine
freien URLs, Dateipfade, Artefaktlisten, Vorgänger, Updater- oder Peerpins vom
Aufrufer. Auch der alte typisierte `PlanInput` erlaubt keine alternative
Einreichung eines selbst zusammengestellten `ResolvedAgentUpdate`.
Der Server löst den festen Releasekatalog und je Ziel die letzte gespeicherte
`agent_update`-Beobachtung auf. Neben dem bestehenden Baseinventar akzeptiert er
gezielt den eigenen passiven Scope/Source `agent.update` mit Schema1 und exakt
`{"agent_update": AgentUpdateObservation}` als Daten. Der normale authentisierte
Ingest verlangt die angebotene Capability `agent.update/1`; Tenant, Agent, Boot
und Generationen stammen weiterhin ausschließlich aus dem geprüften Envelope.
Die eigene 60s-Quelle behauptet kein neues Windows-Baseinventar und löst keine
angeforderte Liveerhebung aus. Verlangt werden gültige Quelle/Qualität, höchstens fünf
Minuten alte Erhebung/Empfang/Updatebeobachtung, frischer Kontakt, gleicher
aktueller Boot, unveränderte Identitätsgenerationen, bestätigter Agent-/Helpersync
und keine Restore-/Sequence-/Recoverysperre. Die bezeichnete ursprüngliche
signierte Syncentscheidung muss im erhaltenen Servercheckpoint existieren,
bei der Beobachtung gültig gewesen sein und zu Boot, Verbindungsgeneration,
Gerät und beiden aktuellen Journalidentitäten passen. Ein neuerer normaler
Sync macht die historische Entscheidung nicht nachträglich zu einer neuen Lease.
Genau die passende passive Kandidatenpreview bindet Zielrelease und typisierten
Peerpinübergang. Der Release liegt über dem beobachteten Aktivierungsfloor.
Fehlende, alte oder widersprüchliche Beobachtung ergibt keine Planung und wird
nicht durch eine Liveabfrage oder angenommene Baseline ergänzt. Geräte-mTLS
liefert Herkunft, keine unabhängige Hardware-/OS-Attestierung; der privilegierte
Updater muss sämtliche lokalen Bindungen vor Wirkung erneut selbst prüfen.
Der gespeicherte Plan enthält sämtliche festen Updatejobs mit exakten
Release-/Envelopehashes, Vorgänger-/InstalledRecordhash, Agent-/Helperdateien,
Updater-/Policy-/Keyringbindung, Konfigurations-/Peerpinübergang und einmaligem
zulässigem Vorgängercode-Rollback. Je Versuch werden exakt die zwei signierten
Artefaktreferenzen abgeleitet. Fehlende, zusätzliche, doppelte oder fremde
Referenzen verweigern Revalidation, Zustellung, Grant und Download.
Die Updaterbindung enthält zusätzlich den festen separaten Health-Publickey
`health_public_key_hex` und dessen `health_key_pin_sha256`. Beide stehen in den
kanonischen Planbytes direkt nach dem Keyringhash, werden vollständig angezeigt
und von der eigenen deny-only-Policy exakt verglichen. Das ersetzt weder den
Jobsignierschlüssel noch erlaubt es einen Fallback auf ihn. Der signierte
Executionpermit bezeichnet ausschließlich bei Updatejobs zusätzlich die
ursprüngliche Plan-ID; ältere Aktionen behalten ihre ursprünglichen Grantbytes.
Ersteller und Freigeber benötigen aktuell `updates:apply` sowie getrennt
`root:execute` oder `system:execute`. Das erteilt keine Genehmigung.
`operations.submit` bleibt der unveränderte persistente Antrag
`pending_approval`, vor der interaktiven WebUI-Genehmigung ohne Jobs/Outbox/
JobOffer/Grant. Die vorhandene Autorisierungs- und Auditschicht wird nicht
ersetzt; kein neuer Approve-API-/MCP-/DB-Pfad. Aktualisierte Rechte, Capabilities,
Scope, Releasevertrauen und gespeicherte Vorgänger werden weiter geprüft.
## Getrenntes Vertrauen und deny-only-Policy
`RMM_AGENT_UPDATE_KEYRING_FILE` verweist auf eine separat provisionierte,
geschützte Datei mit dem gemeinsamen `UpdateKeyringFile`-Schema1:
Generation und höchstens16 Publickeys, jeweils Plattform, Sequenzbereich und
Widerrufsflag. Der Server prüft Eigentümer wie beim vorhandenen Jobsignierschlüssel,
0600, reguläre einzelne Datei ohne Symlink sowie nicht fremdschreibbaren Elternpfad;
begrenzt eingelesene Originalbytes und gehaltene Dateimetadaten werden verglichen.
Der vollständige Rawhash/Generation muss zur festen Updaterbindung passen.
Keine Schlüssel aus einem Job, Download oder Katalogeintrag werden vertraut.
Verifikation benutzt den unveränderten bereits nativ qualifizierten reinen
`rmm-updater`-Verifier: feste Ed25519-Domäne, kanonische Manifestbytes,
Signatur, Plattform, Gültigkeit und kompatibles Protokoll/Zustandsschema.
Die serverseitige Kandidatenprüfung ersetzt den lokalen Aktivierungsfloor nicht.
Die eigene Datei `RMM_AGENT_UPDATE_POLICY_FILE` ist im ersten Entwicklungsprofil
ein ausdrückliches Schema1-Opt-in mit Ablauf und höchstens64 festen Scopes.
Jeder Scope bindet Tenant/Asset/Agent/Generationen, aktuelle Principals,
qualifizierte Helperpolicy/-binary, Updaterbinary/-policy, Keyringgeneration/-hash,
separaten Health-Publickey/-Pin,
erlaubte konkrete Manifest-/Vorgängerrecordhashes und Abnahmenachweis-ID.
Fehlend, falsch, abgelaufen oder Produktion ohne passenden Adapter bleibt deny.
Bestehende General-, Fullskript-, SCM-, MSI- und APT-Policies erteilen dadurch
keine Updateerlaubnis. Kein Codepfad provisioniert diese Dateien oder Mitgliedschaften.
Zusätzlich sind die abgestimmten tatsächlichen Capabilities erforderlich:
`update_agent`, `agent.update.apply/1`, `rmm.sync.v1`, unabhängiger Root-/SYSTEM-
Helper, `root:update_agent` beziehungsweise `system:update_agent` und konkrete
Helper-/Updatercode-/Updaterpolicyhashes. Quelle oder Build allein öffnet sie nicht.
## Eigene große Artefakte und passive Metadaten
Migration0015 legt nur die getrennten Tabellen `agent_update_artifacts` und
`agent_update_releases` an. Beide haben erzwungene Tenant-RLS, zusammengesetzte
Tenant-/Artefakt-/Hash-/Längen-Fremdschlüssel und unveränderliche Inhalte.
Die Anwendungsrolle besitzt nur SELECT/INSERT, keine Tabellen und kein RLS-Bypass.
Alte APT-/MSI-Artefakttabelle, Route, SQLgrenze und Store bleiben bei256KiB.
| Pfad | Vertrag |
| --- | --- |
| `POST /api/v1/tenants/{tenant}/agent-update-artifacts?artifact_id=…&sha256=…&size_bytes=…` | Interaktive Katalogverwaltung mit CSRF und `catalog:write`; binärer Stream mit exakter Content-Length, höchstens256MiB und180s; kein Job |
| `POST /api/v1/tenants/{tenant}/agent-releases` | Strikter signierter Envelope; Veröffentlichung erst nach vollständiger Prüfung beider bereits importierter Dateien; kein Job |
| `GET /api/v1/tenants/{tenant}/agent-releases` / MCP `updates.list_releases` | Gespeicherte feste Metadaten, berechtigt und paginiert; abgelaufene Metadaten bleiben lesbar und gesondert gekennzeichnet |
| `GET /agent/v1/releases/current?platform=…` | Geräte-mTLS und passende Plattform; tatsächlich beobachtetes höchstes Katalogrelease oder `not_configured`; kein Nachweis weltweiter Aktualität und kein Apply |
| `GET /agent/v1/update-artifacts/{artifact}?job_id=…&attempt_id=…&offset=…&length=…` | Geräte-mTLS, genehmigter fester Job/Versuch, aktuelle Rechte/Policy/Identität und exakte Manifestreferenz; höchstens512KiB je Antwort |
Upload liest kein vollständiges Binary in einen Vec: feste32KiB-Schreibstücke,
bounded Hash/Längenzählung, create-only privates Staging, Flush vor unveränderlicher
Publikation. Frühes EOF, Zusatzbytes und Hashabweichung verweigern Veröffentlichung.
Die feste180s-Frist wird ausdrücklich vor und nach jedem Streampoll, nach der
Frameverarbeitung sowie vor Veröffentlichung geprüft. Damit können auch sofort
verfügbare oder leere Frames den Ablauf nicht umgehen; das eigene unveröffentlichte
Staging wird beim Abbruch über den vorhandenen Drop entfernt.
Während des Streams wird keine SQLtransaktion gehalten; vor Veröffentlichung
werden interaktive Berechtigung und CSRF erneut geprüft. Unterbrochene eigene
Stagingdateien werden entfernt; Prozess-/Hostcrash kann verwaiste eigene
Stagingdateien hinterlassen, ohne daraus ein veröffentlichtes Objekt zu machen.
Download benutzt ein gehaltenes reguläres No-follow-Handle und prüft vollständige
Länge/Hash mit32KiB-Puffer, dann den begrenzten Bereich und Dateimetadaten.
Das lädt kein vollständiges großes Objekt in RAM; der erste einfache Adapter
hashprüft das Objekt allerdings pro Chunk erneut. Der Client muss weiterhin vor
Staging/Verwendung unabhängig vollständige Länge, EOF und Releasehash prüfen,
ohne Redirect oder beliebigen Downloadhost. Produktionsobjektspeicher und
weitergehende Durchsatzoptimierung sind kein behaupteter Nachweis dieses Adapters.
## WebUI und tatsächliche lokale Prüfungen
Die WebUI bietet eine feste Release-ID und zeigt gespeicherte Releases sowie
alle Update-/Rollbackbindungen vor Genehmigung. Sie prüft ursprüngliche
Planhashbytes, rekonstruiert den gesamten kanonischen Updateplan und Jobhash,
dekodiert den kanonischen Envelope und prüft Manifest-/Envelopehashes und
genau zwei Artefakte je Versuch. Byte-/Ansichtsänderung sperrt die Freigabe.
Signaturprüfung gegen provisionierte Schlüssel bleibt Server/Helperaufgabe;
die Anzeige eines Key-ID-Feldes behauptet keine eigene UI-Vertrauenskette.
Ein getrenntes Katalogformular nimmt den signierten Envelope und genau zwei
Dateiauswahlen entgegen. Der Browser übergibt die Filebodies direkt, ohne im
Anwendungscode ein vollständiges Binary-ArrayBuffer anzulegen. Der Server
prüft die vollständigen Hashes und Längen. Erst zwei bestätigte Importbelege
führen zur getrennten Veröffentlichung der signierten Metadaten. Fehlgeschlagene
Schritte erzeugen keine automatischen Retries oder Installationsjobs; tatsächliche
Teilimportbelege bleiben im Fehlerzustand sichtbar. Sitzungs-/CSRFdaten bleiben
im normalen Browserkontext, kein Tokenexport für einen separaten Approver.
Tatsächlich lokal ausgeführt, kein RMM-Server oder -Agent auf dem Notebook:
- Server `cargo check --locked --offline -p rmm-server` bestanden.
- Server `cargo test --locked --offline -p rmm-server --bin rmm-server`:
**43bestanden,0fehlgeschlagen,5bestehende DB-Fälle ausdrücklich ignoriert**.
Einschließlich vollständigem echten Rustcodec-Plan, exakter per-Versuch-
Artefaktmenge, verweigerten freien lokalen Pins und großem Store mit
Trunkierungs-/Korruptions-/Fremdtenant-/Legacygrößengrenzen.
- Server Clippy für alle Targets mit `-D warnings` und gezielte Formatierung
bestanden. Unveränderter Verifier und alte nativen Runner nicht umgeschrieben.
- Web Typecheck, Vitebuild und **54/54Tests** bestanden, davon fünf neue
gezielte Updateprüfungen mit tatsächlichen Rustcodec-Fixtures. Diese enthalten
ausdrücklich synthetische Signaturen und dürfen niemals publiziert/ausgeführt
oder als Kryptografie-/Releasequalifikation ausgegeben werden.
Der zusätzliche Filetransportfall verweigert falsche Länge und widersprüchliche
Importbelege und prüft direkte Filebodyübergabe an die feste gleiche Origin;
dies ist noch kein Browser-/Netzwerk- oder nativer großer Streamnachweis.
- Frischer isolierter PostgreSQL17.6 ohne Netzwerk/Ports: Migrationen1–15 als
Nicht-Superuser-Migrator ausgeführt; Tenant-RLS, fehlender und nach Commit
zurückgesetzter Kontext, Cross-Tenant-FKs, App-UPDATE-/DELETEverweigerung,
unveränderliche Inhalte auch gegenüber dem Migrator und null neue Jobs,
Outbox, Grants/Autorisierungen bestanden. Eigener Testcontainer entfernt.
Fall `postgres-19cdb94c…`, ResultatSHA256
`bbb649a184e59a645f638d39f2e3182df6aef39353bff0bf43712f03297c99ce`.
Dieser SQLnachweis ersetzt die fünf ausgelassenen anderen DB-Fälle nicht.
Anfänglicher Web-Typecheck erreichte wegen fehlendem `tsc` noch keine Prüfung;
nach `npm ci --offline --ignore-scripts` liefen die genannten Prüfungen wirklich.
Ein zwischenzeitlicher `--locked`-Lauf verweigerte vor Compile die noch nicht
abgestimmte Workspace-Lockfortschreibung; erst der koordinierte Lockstand wurde
geprüft. Keine Paketversion wurde für diese Ergänzung gezielt hochgezogen.
Der unabhängige Review des Server-/WebUI-Abschnitts fand keine kritischen Blocker
an Binding, Autorisierung, Genehmigungsgrenze, RLS oder Store. Die dabei benannten
engen Ergänzungen betreffen die ausdrückliche Uploadfrist und die eigene passive
Updaterquelle; Gesamtintegration und Zielabnahme bleiben davon getrennt.
Nach diesen beiden Änderungen wurden Servercheck und Clippy für alle Servertargets
mit unverändertem Lock/offline und `-D warnings` erneut tatsächlich bestanden;
`git diff --check` war sauber. Für diese erste Ergänzung blieb die WebUI
unverändert und wurde nicht erneut gebaut oder getestet. Ein180s-Netzwerklauf
wurde für diese kleine Quellenergänzung nicht
ausgeführt; die vier ausdrücklichen Deadlineprüfungen sind Quellencodebefund,
kein behaupteter nativer Last-/Zeitnachweis.
Beim folgenden separaten Healthkey-Vertragsnachtrag wurden die drei Codec-Fixtures
erneut direkt aus dem erweiterten Rustbeispiel erzeugt. Die WebUI bekam dafür die
strikte kanonische Feldfolge und verlangt beide Healthbindungen. Tatsächlich
erneut bestanden: Web-Typecheck, Vitebuild, die fünf relevanten Update-Webtests
einschließlich Anzeige beider Healthfelder sowie Server-Clippy aller Targets mit
`-D warnings`, unverändertem Lock und offline und die beiden gezielten
`agent_updates::tests` mit den neu erzeugten Rustcodecbytes. Die übrigen49Webtests wurden nach
diesem begrenzten Nachtrag nicht erneut ausgeführt; der frühere54/54-Lauf bleibt
als früherer Nachweis ausgewiesen. Keine native Health-/Applyprüfung daraus abgeleitet.
**Noch offen:** Vollständiger aktueller
Linuxruntime-/Handoff-/Health-/Rollbackanschluss, echte signierte Releaseveröffentlichung,
qualifizierter Updaterbootstrap und Linux-first-VM-/WebUI-Applyabnahme; danach
Windows. Produktionsadapter, Dauerbetrieb und Kapazität sind nicht abgenommen.
Alle Zielaktionen und Genehmigungen bleiben ausschließlich beim Hauptagenten.
+103
View File
@@ -0,0 +1,103 @@
# Windows-GNU-Pack für den reinen Updater-Prüfkern
Stand 2026-11-14: Derselbe unveränderte Prüfkern aus `cc5c935` wurde nach dem
tatsächlichen Cloud-Linux-Ergebnis9/9 für `x86_64-pc-windows-gnu` gebaut.
**Anschließend nativ auf der Windows-Test-VM:9/9 bestanden.** Dies ist weder ein MSVC-Build noch
ein Nachweis für Agentdienst, LocalService/SYSTEM, Zeitvertrauen oder Apply.
Der neue separate Runner `deploy/agent_updater_windows_contracts.py` bindet
den vollständigen tatsächlichen Linuxproof
`bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`,
dessen Originalmanifest und die vollständigen neun Testnamen. Der bestehende
Linux-Runner `22e7e0a8…` bleibt unverändert; sein ursprüngliches Samecase-
Readback wird durch diese neue Windowsquelle nicht geändert.
Tatsächlich lokal ausgeführt:
```text
python3 deploy/agent_updater_windows_contracts.py build-local
```
Gepinntes Offline-Dockerimage mit Rust1.99.1 und GNU-Windows-Toolchain:
`sha256:1b2fd985d2c1fcc3545ace602405dc68fa899201bd8a73fa319ff96377203fa9`.
Quellmount nur lesbar, eigener Targetordner. Windows-Clippy für alle Targets
mit `-D warnings` und Release-Link der einzigen `release_contract`-Testexe
bestanden; kein neuer Fremddep und keine Kernquelländerung. Die ungestrippte
Originaldatei bleibt neben der gesonderten debuggestrippten Auslieferung erhalten.
Erster Packfall `build-f15c6c7d-5ff3-421d-b568-2ef0d3c5b649` blieb nach
erfolgreichem Clippy/Link ohne Manifest stehen: Die enge DLL-Prüfung kannte das
von Rust-std importierte `api-ms-win-core-synch-l1-2-0.dll` noch nicht. Nur dieses
beobachtete Windows-API-Set wurde zusätzlich zugelassen. Ein neuer lokaler
Packfall verwendete dieselben unveränderten Kernquellen und gecachten Linkbytes;
alte Reports bleiben erhalten. Keine Windows-Unit wurde dabei ausgeführt.
Aktueller Packmanifest:
`devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json`,
SHA256 `341e58c254b0848b0553ddf6cd04bb7c322e73752c9a2c87f1d2162991648bf8`.
PE-x64-Auslieferung2537309Bytes, SHA256
`6c1d3d679c8558c50049c51755784863fc38f57c77c80e6ef005d89f09542396`.
Importe: `KERNEL32.dll`, `USERENV.dll`, `WS2_32.dll`,
`api-ms-win-core-synch-l1-2-0.dll`, `bcryptprimitives.dll`, `msvcrt.dll`,
`ntdll.dll`. Das sind beobachtete Imports, kein bestandener Loadernachweis.
Python-Syntax, unveränderter vollständiger Linuxproof, sechs Ergebnis-
Verweigerungsfälle, ausschließlich lesendes Samecase-Readback ohne Upload
und fehlendes Native-Opt-in wurden lokal geprüft. Der geschützte Beleg
`local-driver-guards.json` liegt beim Manifest. Kein SSH, keine Zugangsdaten-
abfrage, kein Notebookagent und keine VM-/Dienst-/Policy-/RMM-Jobaktion.
Der Orchestrator prüfte anschließend die vollständige Remotequelle mit dem
vorhandenen lokalen PowerShell-AST-Parser erfolgreich. Der tatsächlich erzeugte
SSH-Prozessaufruf umfasst17874Zeichen und liegt unter der32767Zeichen-Grenze.
Der Verifier-Subagent führte weiterhin keine eigene SSH-/VM-Aktion aus.
**Nach Sourceprüfung tatsächlich durch den Eltern-Orchestrator auf der
festgelegten Windows-Test-VM ausgeführt:**
```text
python3 deploy/agent_updater_windows_contracts.py windows --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --execute-native-tests
```
Nur dieser explizite Aufruf liest den bestehenden privaten Zugang über
`credentials/server.conf`, `credentials/windows-dev-access.json` und den
bestätigten Windows-Hostkey. Keine Zugangsdaten oder Transportpräfixe in diesem
Beleg. Er erzeugt einen neuen privaten Bootstrap-Scratchfall und überprüft
vor dem einzigen Testlauf tatsächlich alle neun erwarteten Namen. Die Tests
laufen als Bootstrapadministrator mit geleerter Umgebung und begrenzter
Laufzeit/Ausgabe. Ein dauerhaftes Create-once-Intent verhindert Wiederholung.
Nach Antwortverlust niemals neu starten oder neu hochladen; die ursprüngliche
UUID steht im lokalen `devstate/agent-updater-windows/<UUID>/intent.json`.
Ausschließlich desselben Falls lesend abgleichen:
```text
python3 deploy/agent_updater_windows_contracts.py readback-windows --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --case <ursprüngliche-UUID>
```
Erst ein vollständiger tatsächlicher9/9-Beleg ohne Skip erzeugt
`windows-gnu-passed.json`. Auch dieser Erfolg qualifiziert nur den reinen
GNU-Prüfkern auf dem Windowsgast, keine installierte
Selbstupdatefunktion oder MSVC-Agentlaufzeit. Normreview, Releasekatalog,
Streaming-/Plan-/WebUI-Bindung und eigenständiger Updater mit erhaltendem
Code-/Pin-Austausch bleiben ausdrücklich offen.
## Tatsächliche native Windows-GNU-Ergebnisse
Rootfall `1a6dba2a-0db3-4aa8-8e21-dafcaabf85e3`: Tatsächliche Liste aller neun
gebundenen Testnamen zuerst geprüft, anschließend9/9 ohne Skip bestanden,
Exitcode0, kein Timeout und keine Fehlerausgabe. Die Nativeexe entspricht
exakt der oben genannten Auslieferung und ist an den ursprünglichen tatsächlichen
Linuxproof gebunden. Geschützter Beleg `windows-gnu-passed.json` neben dem
Packmanifest, SHA256
`fc6ef028f0d71639b940914d2cf66e809ed96f9803b4b0b10ea63c6e08978493`.
Der Beleg wurde gegen Fall, Manifest, Linuxproof, Artefakt und alle neun Namen
zurückgeprüft.
Das tatsächliche Ergebnis weist ausdrücklich `local_service_proof=false`,
`system_proof=false`, `msvc_runtime_qualified=false`, `rmm_jobs=false` und
`activation_implemented=false` aus. Die Units liefen ausschließlich im eigenen
Bootstrap-Scratchfall; keine Agent-/Helperinstallation oder Policyänderung.
Damit ist derselbe reine Prüfkern **zuerst auf Cloud-Linux, danach auf dem
Windowsgast als GNU-Unitbinary** nativ qualifiziert. Der Autoupdater selbst
bleibt bis zur gesonderten Runtime-/Genehmigungs-/Health-/Rollbackintegration
unimplementiert.
+111
View File
@@ -0,0 +1,111 @@
# Linux-Worker: konkreter Zwischenstand
2026-11-14, Spezifikation1.21. `crates/updater-worker` ergänzt die eingefrorenen
Linux-OS-Primitiven; es ist noch kein ausgelieferter Updaterdienst und keine
Applycapability. Keine Zielaktion oder Genehmigung durch diesen Quellschnitt.
## Implementiert
`NativeClock` verwendet eine tatsächlich lesende `adjtimex`-Abfrage samt
Synchronisations-/Fehlergrenze und vergleicht die laufende Wanduhr mit dem
monotonen ursprünglichen Prozessbezug. IPC-/Serverzeit ist kein Ersatz.
`Original` prüft den erhaltenen Originalrequest einschließlich Originalsignatur
bei dessen unveränderlichem Verbrauchszeitpunkt. Exakte Rekonstruktion des alten
Startzeugen, Plan-/Job-/Versuchs-/Grant-/Authorizationbindung, Generationen,
Codepaar, Fulltransition und ursprünglicher Boot müssen stimmen. Aktuelle Uhr,
Boot und Gesamtfrist bleiben vor späteren Schritten verpflichtend; der alte
Startzeitpunkt ist ausdrücklich kein erneuertes Startfenster.
`RetainedSet` hält Dateideskriptoren und Parent-/Dateiidentitäten. Für Schlüssel
und Konfiguration werden zusätzliche Metadatenstempel verglichen, ohne private
Schlüsselbytes zu lesen oder auszugeben; mutable Datenbanken dürfen bei gleicher
Dateiidentität fortschreiten. Die konkrete vollständig erforderliche Dateiliste
muss aus separat geprüfter lokaler Provisionierung kommen. Eine Teilmenge ist
kein vollständiger History-/PKI-Erhaltungsnachweis.
`FullFiles` liest die konkreten geschützten Rawconfig-/Rawpinbytes sowie die
unabhängig provisionierte öffentliche Jobsignierkeydatei. Der vorhandene reine
Fullrenderer muss exakt den vor WebUI-Genehmigung gebundenen Transitionbeleg
ergeben. Nur dessen exakte Config-/Pinbytes werden create-only gestaged.
`StableParticipant` verlangt den tatsächlichen eigenen MainPID des festen
Updaterdiensts mit Prozessgeburt, aktuellem Image, Konto und Unitkomposition.
Die ursprüngliche konkrete Helperinstanz wird ebenso gegen die atomare
Delegation geprüft. `/proc`-/Capabilityfehler werden verweigert; kein UID0-,
Prozessname- oder installierter-Dateipfad-Fallback. Getrennte tatsächliche
General-/Full-/Updater-Dienstkontexte sind noch nativ zu qualifizieren.
`TrustState` lädt ausschließlich geschützte feste Policy-/Keyring-/Healthpin-
und InstalledRecord-Dateien. Originale rohe Hashes bleiben maßgeblich. Die
initiale Baseline benötigt ihre gesonderte Ed25519-Domänensignatur; aktuelle
Schlüsselwiderrufe/-bereiche und Releaseverifikation werden unabhängig geprüft.
Health-/Release-/Jobkeys werden getrennt geprüft. Die erste Aktivierung bleibt
an den separat signierten Bootstraprecord gebunden. Ein `Updated`-Vorgänger
wird bis zur vollständigen Record-/Health-Historyprüfung ausdrücklich verweigert.
Keine Floorableitung aus einem bloß geparsten Record, kein Releaseprivatkey
auf dem Client. Die getrennte TLS-Keyprovisionierung bleibt ein Bootstrapgate.
`FileWitnesses` bindet die vier tatsächlich vorhandenen Original-/Stageproofs.
Es liest vor jedem einzelnen Schritt unabhängig Original, Stage, erhaltenes
Backup oder neues Ziel nach. Historisch gebundene Hardlinks werden erhalten.
`OwnedLedger` öffnet ausschließlich die vorhandene `consumption.sqlite` ohne
CREATE, nachdem ein echter Linux-OS-Guard alle installierten Reader gestoppt
bestätigt hat. Derselbe Ledger-/Lockinode, Originalstart, vollständiger
Handoffhead und null weitere offene Verbräuche bleiben Pflicht. Der konkrete
Coreguard verifiziert tatsächliche Prozesse, Dateien und Statezeugnisse vor
append-only Handoff-CAS und nativen Effectintents im selben Ledger.
`LedgerFence` verwendet die konkreten Core-APIs `claim_native_effect` und
`observe_native_effect`. Pro Datei bleibt genau ein Kernel-ReplaceIntent;
SavePredecessor und PublishReplacement erhalten getrennte dauerhafte native
Intents und Nachlese. Ein fehlgeschlagener/mehrdeutiger Schritt vergiftet den
laufenden Fence; keine Resume-/Retrykonstruktion aus einem Teilintent.
## Offen und standardmäßig verweigert
Vollständige Engine/Daemonhülle und originale aktivierungsgebundene Stageaufnahme,
Full-Control-Bridge vor Stop, drei Stopbeobachtungen vor AllStopped, atomare
Rückgabe-/Startreservation, tatsächliche Guardabgabe vor einmaligen Starts,
neuer Full-Observer und tatsächlicher Health-/Outcomeanschluss sind noch offen.
Floor-/InstalledRecordpublikation braucht zusätzlich die geschlossenen
originalen nativen Intents nach Health und erhaltende Record-CAS. Folgeupdates
brauchen vollständige geschützte Record-/Health-Historyverifikation.
Der eingefrorene Vorwärtskernel hat noch keinen qualifizierten Rollbackübergang.
`RestorePredecessor` bleibt deshalb auch bei vorab gebundener Recoveryoption
verweigert; Fehler/Unknown erteilen keinen impliziten Rollback oder Neustart.
Das ist eine offene Apply-/Produktanforderung, kein abgeschlossener Updater.
## Tatsächliche lokale Prüfung
Offlinecontainer aus bestehendem Image
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
Der konkrete Ledger-/Native-Fenceanschluss hat
`cargo check --locked --offline -p rmm-updater-worker --all-targets`
tatsächlich bestanden. Der vollständige aktuelle Checkpoint einschließlich
TrustState bestand danach Clippy mit `-D warnings` für alle Crate-Targets.
Ein Box-Typfehler und zwei unnötige `as_ref`-Aufrufe wurden
korrigiert, ohne Typ- oder Lintunterdrückung.
Der unabhängige Rootreview fand danach einen konkreten historischen
Baselineblocker: `active_release=None` bei `floor=baseline_sequence`
verweigert im unveränderten Frozenverifier jede legitime Baseline. Die tatsächliche
historische Prüfung bindet jetzt die exakte aktive Baseline-Sequenz und deren
Manifesthash; der Floor bleibt unverändert und Kandidaten bleiben aktuell.
Der gezielte reale Ed25519-Gegenbeleg benutzt einen kanonischen separat
baseline-signierten InstalledRecord und echte Release-Signaturen. Die private
Rückmutation auf den alten `None`-Kontext scheiterte erwartungsgemäß genau an der
Baselineprüfung (Exit101); derselbe Release-Test mit Korrektur bestand **1/1**.
Neuer aktueller Kandidat oberhalb des Floors besteht, gleiche/niedrigere Sequenz
mit anderen Bytes, abgelaufenes Angebot und widerrufener Baselinekey werden
verweigert. Release-Test, Clippy `-D warnings` und Formatcheck bestanden aus
derselben privaten Quellkopie. Kein Frozenverifier wurde dafür verändert.
Privater Nachweis:
`devstate/agent-updater-worker/baseline-fix-1fcc8bb2-57fe-4425-b166-f416dc1b4703/`.
Keine Engine gestartet, kein systemd-Aufruf, keine echte Zieldatei geändert,
keine VM/SSH-/Job-/WebUI-Aktion und kein nativer Worker-/Applynachweis.
Der native Linux-OS5-Nachweis qualifiziert weiterhin dessen eigene eingefrorene
Primitiven und ersetzt keine Worker-/Dienstkontextabnahme.
+20 -1
View File
@@ -1,6 +1,6 @@
# Linux-first-Entwicklung und reale VM-Abnahme
Stand: 2026-11-14 · Spezifikation 1.20. Das begrenzte Linux-MVP ist inzwischen
Stand: 2026-11-14 · Spezifikation 1.21. Das begrenzte Linux-MVP ist inzwischen
dokumentiert abgenommen; aktuelle Nachweise stehen in [handover.md](handover.md).
Die getrennte Windows-SYSTEM-Grenze ist in Spezifikation0.1 und
[windows-system-policy.md](windows-system-policy.md) präzisiert; Quellen-/Build-
@@ -17,6 +17,25 @@ Deploymentnachweise: [server-deployment.md](server-deployment.md).
Die folgenden PC-Server-/Reverse-Tunnel-Abläufe und Nachweise sind historisch.
TLS/mTLS, Credentialschutz, Linux-first und WebUI-Plangenehmigung gelten weiter.
## Enger paralleler Agentupdater (Version1.21)
Der User hat signiertes Agent-Selbstupdate parallel vorgezogen. Es bleibt ein
festes Release-/Vorgänger-/Versuchs-/Planhashpaket mit tatsächlicher WebUI-
Genehmigung; passive Metadaten/Updatezustände sind keine Jobs. Neuer
`agent.update`-Scope liefert eigene tatsächliche Beobachtungszeiten und darf
kein altes Linux-/Windows-Baseinventar frischstempeln. Beide Binaries werden
vollständig vor Handoff gestaged; anschließender read-only Inflight-/Health-
Kontrollpfad eröffnet keine Admission oder neue Startlease.
Vor Zielarbeit: kompatible erhaltende Bootstrap-/Baselineprovisionierung,
unabhängiger Source-Review, Linux-first-Units/OSports und danach ein konkreter
WebUI-genehmigter Apply mit State-/PKI-/Historyerhaltung und erlaubtem Code-
Rollback. Root koordiniert alle Zielaktionen. Notebook bleibt nur Entwicklung.
Aktuelle Teilnachweise und fehlende Runtimegates:
[Handoff](agent-updater-handoff.md), [Linuxport](agent-updater-linux-port.md),
[Server/UI](agent-updater-server-console.md). Keine Applycapability aus einem
Build oder Katalogeintrag ableiten; fehlende Qualifikation bleibt deny.
## Vorrang: genehmigte Batch-Skriptkonsole (Version1.20)
Der User priorisiert vollständige Shell-/PowerShell-Skripte über MCP/UI mit
+45 -1
View File
@@ -1,6 +1,50 @@
# Verbindliche Projektentscheidungen
Stand: **2026-11-14**, Spezifikation **1.20** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
Stand: **2026-11-14**, Spezifikation **1.21** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
## Präzisierung des engen Updatervertrags (Version1.21)
Healthsignatur und vor Genehmigung gebundener lokaler öffentlicher Healthpin
verwenden einen separat provisionierten Schlüssel; kein Jobsignerfallback.
Auf Linux autorisiert und prüft Full den Updateowner. General bleibt während
des Inflightfalls geschlossen, ohne aus Nichtzuständigkeit Unknown zu erzeugen.
Keine Capabilitylockerung umgeht die tatsächliche Prozessimageprüfung.
Native Dateiteilintents und Stop-/Startbeobachtungen gehören append-only an den
Originalhandoff im selben Ledger. ReturnIntent und feste Startreservation
committen vor Lockabgabe; keine Zeile erlaubt späteren Workerresume.
Details und offene Runtimegrenzen stehen in Spezifikation0.1 und
[agent-updater-handoff.md](agent-updater-handoff.md).
## Agent-Selbstupdate parallel, eng gebunden (Version1.21)
Auf ausdrücklichen Userwunsch wird ausschließlich der signierte Agentupdater
parallel ausM7 vorgezogen. `update_agent` bleibt fester, tatsächlich WebUI-
genehmigter Job mit `updates:apply` plus Root-/SYSTEM-Recht für beide Akteure,
separatem immutable Releasekatalog und zwei gebundenen Rohbinaries. Altes
Paketlimit bleibt bestehen; Update-only-Streaming ist keine allgemeine
Installer-/Dateiupload-/Rootskriptfreigabe. Passive Beobachtung `agent.update`
alle60s ist von Baseinventar und täglichem Releasecheck getrennt; fehlende
Provisionierung/Qualifikation erzeugt `not_configured`, niemals Applybereitschaft.
Der verbindliche Handoff-/Owner-/Inflight-/Healthvertrag steht in Kapitel0.1.
Atomarer Originalverbrauch+Start+Handoff+Delegation+Stopintent im erhaltenen
Helperledger, echter gemeinsamer Lock nur während Helperstop, Rückgabe vor
neuem Helperstart und exakter eigener Inflightabgleich bei Ready=false sind
Pflicht. Kein zusätzlicher ungebundener Server-Journalslot oder Unknown-Healing.
Die nur für diese Aktion signierte `agent_update_plan_id` erhält alte Grantbytes
bei allen anderen Aktionen. Fullpins werden eng aus konkreten geschützten
Rawbytes gerendert; zentrale Fullrechte werden nicht automatisch migriert.
Erste Baseline und erlaubtes Rollback müssen bereits die neue Update-/Handoff-
Historie dekodieren können. Das aktuelle1.20-Codepaar ist daher kein späteres
Rollbackziel. Erhaltender kompatibler Bootstrap, separat release-signierter
InstalledRecord/Floor und tatsächliche Linux-first-Qualifikation sind vor dem
ersten Apply erforderlich. Keine Daten-/PKI-/Generation-/Journalrücksetzung.
Quelle ist kein Applynachweis: isolierter Verifier/Handoffkernel und lokale
OS-/SQL-/UIteile sind getrennt dokumentiert. Unabhängige Reviews und tatsächliche
Messwerte stehen in den verlinkten Updaterberichten; Workerinstallation,
genehmigter realer Codewechsel und Windowsnachweis bleiben eigene Gates.
## Skriptkonsole und vollständige Hostwartung (Version1.20)