Wire preserved update control, health evidence and record publication
Rust development slice / linux (push) Failing after 7s
Rust development slice / linux (push) Failing after 7s
This commit is contained in:
@@ -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).
|
||||
Reference in New Issue
Block a user