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

16 KiB

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. Der tatsächliche Linux8-Kernel- und Linux5-OSnachweis ist separat in agent-updater-handoff-linux-results.md und 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. 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.

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