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.