Files
rust-discovery/docs/agent-updater-runtime-source.md
T
2026-11-16 15:25:46 +01:00

253 lines
16 KiB
Markdown

# 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.
## Fortschreibung: zweiter lokaler Quellencheckpoint
Die nächste Teilstrecke verbindet jetzt erhaltene Stage-/Statezeugen, den
gebundenen Full-Controlkanal, echte Dienst-/Prozessprüfungen, lokale
SignedSync-Applyzeugen, Inventarretention und den asynchronen Agent-Healthclient.
Full ist der einzige ursprüngliche Updateautorizer; General kann einen
Originalhandoff nicht aufgrund fehlender Zuständigkeit zu Unknown herabstufen.
Lesender historischer Replay bleibt von aktueller Wirkungsautorität getrennt:
auch nach verlorener Frist/Owner soll Unsicherheit unter demselben erhaltenen
Guard adjudiziert werden können. Sämtliche Forwardeffekte prüfen zusätzlich
aktuelle ursprüngliche Clock-/Boot-/Release-/Revocationbedingungen.
Die feste Fullbridge prüft die tatsächlichen PID-/Birth-/Image-/Unitzeugen.
Dienststartergebnisse müssen exakt den weiterhin gehaltenen einmaligen
Workerresultaten entsprechen. Nach ServicesStarted müssen gerade diese neuen
Agent-/General-/Fullgenerationen weiterleben; Ersatz-PIDs sind kein Erfolg.
Health vergleicht die separat signierten Originalserverbytes mit den lokal in
derselben echten Helper-Sync-Transaktion gespeicherten Request-/Responsehashes
und Applyzeit sowie dem behaltenen Originalbaseinventar und dessen echtem
SignedSync-ACK. Der vorhandene normale Transport-ACK löscht diese Belege nicht.
Der Agent lässt ausschließlich den signatur-/consumed-/start-verifizierten
ursprünglichen Updatekandidaten ohne vorhandenes Outcome beim eigenen Startup
auf tatsächliche unabhängige Helperkontrolle warten. Dies ist kein laufender
Handoffbeweis, keine Ausführung und keine Bereitschaft. Ein bereits vorhandenes
Unknown wird nicht geheilt. Der Kandidat kann nur neue negative Kontrollrunden
planen, damit die normale busy-Sperre seinen ersten Wiederkontakt nicht blockiert.
Ein erwarteter letzter Entscheid der vorherigen Verbindungsgeneration ist beim
Reconnect kein aktueller Healthbeleg. Während eines begrenzten Health-HTTPs
pausieren weitere Kontrollrunden; Heartbeats laufen weiter. Ein tatsächlich neuer
normaler Basesample gehört zur genehmigten Update-Healthstrecke, alte Daten
werden nicht frischgestempelt. Zertifikatsrotation wartet auf das Ende dieses
konkret bekannten Inflightfalls.
Der konkrete Full-Finalizepfad baut Recordbytes deterministisch aus dem
Originalrelease, altem Record und ursprünglicher SignedHealth. Zwei getrennte
native Intents/Nachlese-CAS sichern Save und Publish. Ein temporärer lokaler
Namespaceguard vergleicht exakt die alte gehaltene Datei/Rootdiridentität mit
dem nicht öffentlich konstruierbaren Recordportbeleg; alle übrigen geschützten
Namen bleiben Pflicht. Floor und aktive Recordmetadaten werden zusammen als
ein neuer Record publiziert, alte/neue Rawrecords zusätzlich create-only
aufbewahrt. Erst danach folgt das ursprüngliche Outcome-CAS; kein Resultunlock
oder allgemeiner Ready-/Startfence entsteht daraus.
Tatsächlich lokal im isolierten Offlinecontainer ausgeführt:
- Agent60, Core67, privilegierter Helper68 und Worker5: insgesamt200bestanden,
0Fehler,0ignoriert,0gefiltert im vollständigen betroffenen Release-Testlauf.
- Gemeinsame all-targets Clippyprüfung mit -D warnings und Formatcheck: PASS.
- Die zwei Record-FS-Fälle verwenden ausschließlich neue eigene Rootdateien
unter privatem Container-/run; keine tatsächlichen Projekt- oder Zieldienste.
Belege: `devstate/updater-runtime-checkpoint2-69dc0bb5-2e9f-4639-9212-e878b32eadc6/`.
Ein vorheriger breiter Lauf hing in der HTTPS-Reconnectprobe und wurde als eigener
Container beendet (Exit137, kein PASS). Nach Eingrenzung des Altgenerationsfalls
bestand die gezielte tatsächliche mTLS-HTTPSprobe1/1; anschließend bestand der
vollständige200er-Lauf. Zwei reine Clippy-Strukturfehler (Testmodulposition und
verschachteltes if) wurden ohne Prüfungsunterdrückung korrigiert. Das erste
Clippyfehlerlog bleibt im Belegverzeichnis; Hänger/Abbruch, gezielte1er-Probe und
späterer Stilhinweis sind im ursprünglichen Werkzeugprotokoll erhalten.
Diese lokalen Ergebnisse qualifizieren keinen tatsächlichen Full-/Updater-
Dienstkontext. Der öffentliche Recordbuilder hat hier noch keinen eigenständigen
echt signierten Positivnachweis; die FS-Fälle umgehen seinen authentisierten
Eingang ausdrücklich. Die vollständige Engine/Daemon-/StopFence-/Stagingproducer-
und ursprüngliche Admissionstrecke, qualifizierte passive Kandidatenbeobachtung,
geschlossene Readercensus, unklare Record-I/O-Namespace-Adjudikation und der vor
der ersten Baseline notwendige V2-Rückweg bleiben offen. Applyfähigkeit bleibt
unveröffentlicht; kein Cloud-VM-Apply, kein Produktfertig- oder Produktionsnachweis.
## Nachtrag2026-11-15: gesperrte Worker-Drivefolge
Nach dem gepushten gemeinsamen Checkpoint8e93c9e und dem erhaltenden Mainmerge
07d6118 ist die bisher offene Enginefolge als konkrete Workerquelle verbunden.
Dieser historische Stand sperrte den Eintritt explizit mit
`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Die folgende lokale Fortschreibung hat
Registry und Readercensus im Quellpfad verbunden; weiterhin wird weder ein
Daemonentrypoint noch eine Job-/Applycapability aktiviert. Die genaue
Queue-/Reply-/Stop-/Lock-/Swap-/Start-/Healthfolge und vorhandene separate
Agent-Singletonsperre stehen in [worker](agent-updater-worker.md). Der neu
geprüfte öffentliche Recordbuilder löst die zuvor dort genannte fehlende
positive authentisierte Eingangsprobe. Keine reale Applyabnahme folgt daraus.
## Fortschreibung2026-11-15: Readerregistry und vollständige Task-FD-Prüfung
Der gemeinsame Quellsatz verbindet Registryprüfung, ursprüngliche Agent- und
Root-Executorsperre sowie TGID-/TID-FD-/maps-Prüfung mit der bestehenden Engine.
Vor SQLiteöffnung verlangt der Ledgerport den nicht frei konstruierbaren
`ClosedReaders`-Beleg und den tatsächlich gehaltenen ursprünglichen Rootguard.
Das ist ein lokaler Quellen-/Vertragspunkt, kein gestarteter Dispatcher und
keine Zusage über zukünftige privilegierte Fremdprozesse.
Der eingefrorene71-Input-Quellsatz besteht lokal alle10 vorhandenen Workerguards,
locked all-targets Check, Release-Link, Clippy mit `-D warnings` und Formatcheck.
Ein eigener Runner ist ausschließlich für zwei eigene native Prozessfixtures
vorbereitet; er ist noch nicht ausgeführt. Details, frühere fehlgeschlagene
Fixtureprüfung und verbleibende MVP-Gates stehen im
[Readercensusnachweis](agent-updater-reader-census-results.md).
## Quellenfortschreibung 2026-11-16: Full-Admission und stabiler Linux-Daemon
Die zuvor fehlende Quellverbindung enthält jetzt einen getrennten festen
`rmm-agent-updater --serve`-Einstieg und eine Systemd-Vorlage. Der Dienst erhält
keine Jobfreigabe-API. Die vorhandene Full-Helperstrecke prüft die vollständig
vorab geladenen Agent-/Helperdateien unabhängig vom Netzwerkagenten und legt
vier exakt gebundene Root-Stages an. Erst danach speichert die bestehende
HelperSync-Transaktion unter derselben Original-Executorsperre Consumption,
Startzeuge, Handoff, Delegation und StopIntent atomar. Die Antwort
`agent_update_handoff_accepted_v1` ist ausdrücklich kein Outcome und enthält
`ready=false` und `terminal=false`. Der Helper antwortet zuerst dem Agenten;
erst anschließend aktiviert er einmal den tatsächlich gebundenen Updater.
Die Cloud-VM wurde dadurch noch nicht aktualisiert.
Die Quellstrecke erhält auch den aktuellen TLS-Selektor und die tatsächlich
aktive Zertifikatsversion anhand von Dateimetadaten. Sie liest dabei keine
privaten Schlüsselbytes. Ein fester, descriptor-relativ geöffneter
Agent-Cachepfad bleibt auf UID 993 und den bestehenden privaten Agent-Statebaum
beschränkt; die Root-Installationsverzeichnisse behalten ihre eigene strenge
Root-Pfadauflösung.
Der zusätzliche Full-Aufruf `update_observe_v1` ist ausschließlich lesend.
Er prüft die tatsächliche HelperSync-Lease, Baseline/Release-Trust, Historie,
Floor, feste Dienstgenerationen, Readerregistry und den laufenden Updater.
Ein optionaler Kandidat wird als ursprünglicher ReleaseEnvelope mit eigener
Keyringgeneration entgegengenommen und unabhängig geprüft. Erst danach rendert
Full die genaue Kandidaten-Konfiguration und den Pin für die spätere
WebUI-Anzeige. Katalogmetadaten allein liefern keinen CandidatePreview. Der
Aufruf lädt keine Binärdateien, legt keine Stage an und schreibt keine
Start-/Handoff-/Ready-Zeile.
Der V2-Rückweg ist im Linux-Worker für den konkret unterscheidbaren Fall eines
nach einmal bestätigt dispatchtem Start gescheiterten neuen Full-Helfers
verbunden. Ein vorher im ersten LedgerReturnIntent reservierter bedingter Stop
beendet ausschließlich die tatsächlich gehaltene neue General-Generation.
Agent/Full ohne erfolgreichen Start erhalten getrennte negative Belege und
keine erfundenen erfolgreichen Stops. Erst nach beendetem Reader, beiden
ursprünglichen Sperren und erneutem vollständigen FD-/maps-Census öffnet der
Updater wieder das Originalledger. Die vier Dateien werden in Gegenrichtung
über getrennte create-once Intents zurückgeführt; Kandidat und Vorgänger bleiben
erhalten. Ein tatsächlich neu gestarteter Vorgänger-Full muss die ursprüngliche
signierte Healthstrecke erneut bestehen. Sein abschließendes Updateergebnis ist
`failed / AGENT_UPDATE_RETURNED_TO_PREDECESSOR`; der ursprüngliche aktive Record
und Floor werden nicht neu publiziert. Verlorene Antworten, unklare Renames,
automatischer Restart und nicht nachgewiesene Dienstzustände bleiben gesperrt.
Andere Startup-/Healthfehlerpfade sind durch diese Quellenfortschreibung noch
nicht als real ausgeführte Wiederherstellung qualifiziert.
Bei der Verbindung wurde ein konkreter Dienstbeobachtungsfehler korrigiert:
der Systemd-Aufruf fragt sieben Eigenschaften ab, der bisherige Parser verlangte
acht. Der Parser verlangt jetzt genau die tatsächlich angefragten sieben Namen
und verweigert fehlende, zusätzliche und doppelte Eigenschaften.
Lokal tatsächlich ausgeführt: Helperbibliothek 42/42 bestanden, einschließlich
des neuen typisierten Handoff-Acknowledgement-Gegenfalls. Der erste breite Lauf
hatte sechs APT-Fixturefehler wegen des fehlenden privaten Verzeichnisses
`/tmp/opencode`; mit diesem Fixtureverzeichnis bestanden alle 42. Ein erster
Updater-Linux-Lauf bestand 5/7 und scheiterte bei zwei Dateifixtures am absichtlich
schreibgeschützten Container-`/run`. Diese Fehlversuche sind kein nativer
Zielnachweis. Der weitere Quellencheck und die getrennte reale Linux-first-
Abnahme werden separat ergänzt. Keine Applycapability und kein erfolgreicher
Cloud-Apply werden aus diesen lokalen Ergebnissen abgeleitet.
Mit privaten Container-Tmpfs für `/tmp`, `/run` und `/var/lib` bestand anschließend
der vollständige betroffene Lauf: Helper 42, Updater-Linux 7, Worker 12, insgesamt
61 bestanden, 0 Fehler, 0 ignoriert. Zuvor scheiterte zusätzlich ein Workerfixture am
schreibgeschützten Container-`/var/lib`; auch diese Ursache wurde durch die
korrekte eigene Fixtureumgebung beseitigt. Der abschließende all-targets-Clippy-
Lauf für Helper und Worker mit `-D warnings` und `git diff --check` bestand.
Diese Tests enthalten ausdrücklich Containerfixtures mit festen privaten
Statepfaden; die vollständigen Testbinaries dürfen deshalb nicht gegen die
bestehenden installierten Statepfade der Cloud-VM gestartet werden. Der reine
Sieben-Eigenschaften-Parsertest benötigt keine Systemd-/Dateieffekte.
Die zusätzliche ursprüngliche Updater-Zeitgeneration und der tatsächlich
angewandte Pre-Stop-Syncbeleg sind separat in
[Originalzeitgeneration](updater-original-time-generation.md) beschrieben.
Auch diese Quellverbindung ist noch keine reale Applyabnahme.
Am 16. November wurde die öffentliche deterministische Recordzusammensetzung
in `rmm-domain::agent_update_provisioning::assemble_updated_record` gemeinsam
genutzt. Sie liefert ausschließlich bereits öffentliche Recordmetadaten;
die privaten nativen BuiltRecord-Konstruktoren behalten ihre unabhängigen
Original-/Healthsignatur- und Guardprüfungen. Der Linux-Namespacevertrag
bleibt unverändert. Tatsächliche isolierte Nachprüfung: Agent und Worker
mit allen Targets/Clippy `-D warnings` bestanden; beide bestehenden
Record-Namespaceprüfungen (Originalinode/Archive sowie Ablehnung fremder
Dateiidentitäten) bestanden, 2/2, keine ignoriert. Dafür wurde ausschließlich
der private Container-`/run`-Scratch verwendet, keine VM-Datei verändert.