118 lines
7.5 KiB
Markdown
118 lines
7.5 KiB
Markdown
# 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](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.
|