Files
rust-discovery/docs/agent-updater-health-client.md
2026-11-15 01:07:19 +01:00

7.5 KiB

Erhaltener Inventarbeleg und Agent-Healthclient

2026-11-14, Spezifikation1.21. Dieser enge Quellenschnitt ergänzt den bestehenden Agentjournal- und SignedSyncvertrag. Er installiert oder startet keinen Dienst, erhebt selbst kein Inventar und erzeugt weder Job, Grant, Bereitschaft noch Helperwirkung. Registrierung und Aufruf im bestehenden Agent-/Corepfad werden vom Laufzeitowner getrennt integriert; ein fertiger nativer Healthlauf ist damit nicht behauptet.

update_health_inventory erhält im selben gesperrten, begrenzten Agentjournal höchstens zwei ursprüngliche Baseinventar-Envelopes je Originalgrant. Die Retention prüft den vollständigen Inflightpräfix gegen den aus dem unabhängig verifizierten ursprünglichen Updatejob stammenden Healthkey. Ein beliebiger Aufrufer-/Netzwerkkey ist keine Provisionierung. Erforderlich sind ServicesStarted, das letzte echte Dienststartereignis, passende Geräte-/Boot-/ Journalbindung und eine neue Verbindungsgeneration. Plattformscope und echte Erhebungszeit bleiben erhalten; ein agent.update-Paket oder ein vor Dienststart erhobenes Baseinventar ersetzt diesen Nachweis nicht. Kein pauschaler60s-CIMscan und kein Frischstempeln bereits gespeicherter Basewerte werden eingeführt.

Gewöhnliche Transport-ACKs löschen weiterhin ihren normalen Queueeintrag, aber keine Retentionbytes. Die ursprüngliche UUID bleibt zusätzlich für den echten SignedSync ausstehend. Nur dessen interner Applyhook kann sie als signiert bestätigt markieren: nach normaler unabhängiger Signatur-/Bindungsprüfung und unter Vergleich der bereits gespeicherten Originalresponse und des normalen konkreten reconcile_receipts-Datensatzes. Selbst danach bleibt das rohe Envelope erhalten. Keine Caller-ACKliste, applied=true-Behauptung, neue Applyzeit oder Tombstonelöschung ersetzt diese Zeugen. Das vorhandene Journalbudget bleibt verbindlich; ein dritter Retentionssample oder geänderte ursprüngliche Bytes werden verweigert.

Der HTTPclient konstruiert seinen nicht öffentlich befüllbaren Kontext nur aus dem lokalen laufenden Originaljob und zwei bereits gespeicherten tatsächlich signierten Kontrollrunden. Er prüft beide mit dem normalen Coreverifier. Die aktuelle bestätigende Runde muss in Agent- und Helper-Vorgängerlink genau die erste Entscheidung nennen; beide müssen denselben vollständigen ServicesStarted-Präfix bei ready=false bestätigen. Ein gerade offener nächster Request, Fault, fehlender ACK, anderes Boot/Grant/Journal oder veraltete Kontrollrunde erzeugt keinen Healthrequest. Ein fehlender Zeuge bleibt fehlend.

Das tatsächlich in der ersten Entscheidung bestätigte, separat erhaltene rohe Baseinventar wird mit den beiden ursprünglichen Requestbytes an die feste Route /agent/v1/update-health geschickt. Der Aufruf benutzt ausschließlich den bereits normal verifizierenden mTLS-Client aus https_channel, dessen geprüften DNSnamen und TCP-Override; keine freie URL, Bearerweitergabe, Zertifikatsausnahme oder Redirectfreigabe. Request maximal5MiB, Response maximal16KiB, Healthpayload maximal4096Bytes und feste64-Byte-Signatur. Timeout und monotone Nachprüfung begrenzen den Aufruf auf die verbleibende ursprüngliche180s-/600s-Frist und beide noch gültigen normalen Syncentscheidungen. Es gibt keinen automatischen Retry.

Vor Rückgabe prüft der Client konkrete Inventar-/Sync-IDs und Originalhashes und lässt den unveränderten Handoffkernel die separate Healthsignatur, Dienstprozesse, Owner-/Boot-/Journal-/Codebindung und Fristen prüfen. Journal::prepare ist dabei ausschließlich eine Prüfung; es appendet nichts und schließt keinen Versuch ab. Tatsächliche lokale Helper-Applyzeit, Dateipaar, Prozesse, Finalisierung und InstalledRecord/Floor bleiben bei den unabhängigen lokalen Guards. Der Serverbeleg behauptet keine entfernte OS-Attestierung.

Tatsächlich lokal ausgeführt: registrierter Agent-/Corecheck mit --locked --offline, Core-Clippy für alle Targets mit -D warnings und zwei gezielte Core-Retentiontests bestanden. Der erste benutzt den tatsächlichen normalen jobs::ack: Queueeintrag verschwindet, Originalraw und SignedSync-Pending-ID bleiben. Der interne SignedSync-Hook verweigert fehlende gespeicherte Response und fehlenden Receipt; nach beiden bleibt der Rawbeleg erhalten. Diese internen Hookfixturebytes haben ausdrücklich synthetische Signaturen und qualifizieren keinen Kryptografiepfad. Der zweite Fall prüft Create-once, zwei Samples, Fremdgrant und veränderte Rawbytes.

Der erste --locked-Versuch lief vor der koordinierten Lockfortschreibung noch nicht bis zum Compile. Der erste erreichte Agentcompile fand ein falsches Option<Payload>-Pattern; nach Korrektur bestand der Check. Der Client ist registriert, sein tatsächlicher Mainaufruf wird noch separat integriert; entsprechende unbenutzte Funktionen bleiben offen ausgewiesene Compilerwarnungen und werden nicht unterdrückt. Unabhängiger Quellenreview und vollständiger Agent-Clippy nach tatsächlicher Verdrahtung bleiben offen. Keine native VM-/ Netzwerk-/Applyprüfung oder Zieländerung für diesen Teil erfolgt.

Spätere Ownerintegration

Der nachfolgende Runtimeowner hat Registrierung und echte Agent-/Corehooks inzwischen ergänzt. Der Ablauf läuft asynchron neben Heartbeats, behält echte Basebytes/UUIDs und nimmt zusätzliche IDs nur für den verifizierten Original- Inflight in normale SignedSync auf. Nach erfolgreichem HTTP wird ausschließlich der erhaltene SignedHealth an den tatsächlich gebundenen neuen Fullhelper gegeben; dieser prüft eigene Control-/Inventar-/Prozesszeugen unabhängig. Der zuerst qualifizierte Deliveryschnitt oben bleibt historisch. Änderungen und tatsächliche lokale Folgeprüfungen sowie offene native Gates stehen in agent-updater-runtime-source.md.

Exakte lokale Applyspanne statt Sekundenquantisierung

Nachtrag2026-11-15: Der unveränderte eingefrorene Healthreceipt enthält signed_sync_applied_at weiterhin als u64 und unverändert als floor(confirming.issued_at). Dieser Scalar erteilt keine Zeitfreigabe. Der neue lesende Coregetter update_health_sync::read_round prüft bounded die vorhandenen Originalrequest-Protobufs, SignedResponsebytes und tatsächlich im selben HelperSync-Commit gespeicherten Appliedwitnesses. Die bestehende Signatur-/Kontextprüfung läuft unabhängig erneut; es wird weder ein ACKboolean noch eine Callerzeit akzeptiert und kein Journal/Ready/Lease neu geschrieben.

verified_span findet genau ein tatsächlich angewandtes bestätigendes D2 mit beiden vorherigen Decision-IDs gleich D1, derselben Originalgeräte-/Boot-/ Verbindungsbindung und identischem ServicesStarted-Präfix. Dieser Präfix muss auch unverändert im aktuellen Originalhandoff enthalten sein. Der Fullguard prüft jetzt D1.issued_at <= actual_local_applied_at <= D2.issued_at mit den exakten ursprünglichen DateTimes. Erst danach folgt die bestehende lokale Inventar-/Dienst-/Originalhealthprüfung. Der u64-Wert wird ausschließlich auf Gleichheit mit dem ursprünglichen D2-Sekundenfloor geprüft.

Der enge tatsächliche Grenzfall akzeptiert beide exakten Endpunkte und verweigert eine um1ns zu frühe oder zu späte Anwendung trotz identischem Sekundenfloor. Der vorhandene vollständige negative HelperSyncfall prüft zusätzlich den echten Original-Roundgetter nach Signatur-/Applypersistierung. Lokaler Quell-/Testbeleg: devstate/updater-health-exact-span-6879f7cc-f284-4f50-b3e6-de321f3af6a2/. Kein nativer Health-/Applynachweis und keine Änderung an Frozenreceipt-/ Kernelbytes oder an der WebUI-Grenze.