Wire preserved update control, health evidence and record publication
Rust development slice / linux (push) Failing after 7s

This commit is contained in:
2026-11-14 23:51:59 +01:00
parent 328e440f73
commit 8e93c9ead5
34 changed files with 7071 additions and 97 deletions
+89
View File
@@ -0,0 +1,89 @@
# 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).