Add gated agent update planning, preserved handoff and Linux worker ports
Rust development slice / linux (push) Failing after 6s

This commit is contained in:
2026-11-14 21:48:21 +01:00
parent dc9cb1b096
commit 1e89c4577f
82 changed files with 25052 additions and 69 deletions
+136 -1
View File
@@ -1,6 +1,6 @@
# Rust RMM: Architektur und Implementierungsspezifikation
Version 1.20 · 2026-11-14 · Sprache: Deutsch
Version 1.21 · 2026-11-14 · Sprache: Deutsch
**Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam.
@@ -41,6 +41,12 @@ Dienst-/Paketprofile erhalten dadurch keine zusätzliche Erlaubnis. Batchstatus
und abschließende begrenzte Rohbyteausgabe verwenden die bestehende Jobstrecke;
interaktive PTY-/ConPTY-Sitzungen bleiben späterer eigener Umfang.
1.20 → 1.21 (2026-11-14): Auf ausdrücklichen Userwunsch wird ausschließlich
Agent-Selbstupdate ausM7 parallel vorgezogen. Signiertes festes Agent-/Helper-
Codepaar, eigener großer Artefaktpfad, WebUI-gebundener Updatejob und erhaltende
Helper-/Updater-Übergabe mit geschlossenem Inflight-/Healthkontrollpfad werden
präzisiert. Das ist keine native Applyabnahme oder Freigabe weitererM7-Themen.
## Inhaltsverzeichnis
- [0 Auftrag und verbindliche Produktanforderungen](#0-auftrag-und-verbindliche-produktanforderungen)
@@ -130,6 +136,135 @@ Deploymentdaten, offene Konfiguration und reale Nachweise:
### 0.1 Auftrag an die implementierende KI
**Userentscheidung Version1.21 — signiertes Agent-Selbstupdate parallel:**
APT-/MSI-Paketfixtures sind kein Agent-Autoupdater. Der User zieht diesen engen
Teil ausM7 parallel vor; Restore, HA, Relay und weitere Betriebsreife werden
hierdurch nicht zusätzlich beauftragt. Jeder Aktivierungsversuch ist die neue
typisierte Aktion `update_agent` mit `fixed_code_pair_v1`, persistentem
`pending_approval` und tatsächlicher WebUI-Genehmigung gemäß0.1. Ersteller und
Freigeber brauchen aktuell `updates:apply` sowie getrennt `root:execute` oder
`system:execute`. Es gibt keine automatische Freigabe, zukünftiges `latest`,
Wildcardziele oder periodische Selbstaktivierung. Der Plan bindet exakten
release-signierten Manifestenvelope, Plattform, Vorgängerrecord/Codepaar,
Updater-/Policy-/Keyringhashes und Generation, getrennten Healthpublickey samt
Originalhash seines geschützten lokalen öffentlichen Pins, beide Artefakte, Pintransition,
festen Versuch, Fristen und einmalige erlaubte Vorgängercode-Rückkehr.
Erstes Format: genau zwei Rohbinaries Agent und gemeinsamer Helper, getrennte
Update-/Job-/TLS-Schlüssel, kanonische domänengetrennte Ed25519-Releases.
Der stabile separat provisionierte Updater ist nicht selbst Updateartefakt.
Kein Archiv, Postinstall-Skript, freier Ziel-/Downloadpfad oder Hostreboot.
Bestehender256KiB-Paketartefaktstore bleibt unverändert; nur eigener
Updatekatalog/-stream erlaubt bis256MiB je gebundener Datei und512KiB je Chunk.
Geräte-mTLS, Tenant, genau genehmigter Job/Versuch, beide Manifestreferenzen und
aktuelle begrenzende Admission gelten auch beim Download. Beide Dateien müssen
vollständig gestreamt, auf exaktes EOF/Länge/Hash geprüft und geschützt gestaged
sein **vor** Aktivierungsverbrauch/Handoff; danach ist der Admissiondownload
kein Resume-, Health- oder neuer Startpfad.
Reiner Metadatencheck beim Start und täglich ist passiv. Ein eigener
`InventorySnapshot`-Scope `agent.update`/Capability `agent.update/1` meldet
höchstens alle60s tatsächlichen Updatezustand; er stempelt kein Baseinventar
frisch und löst keinen CIM-/Vollinventarzwang aus. Qualifizierte
`agent.update.check/1` und `agent.update.apply/1` sind zusätzliche tatsächliche
Fähigkeiten, keine Folge des Schemas oder eines Builds. Fehlende Provisionierung
meldet `not_configured`, ohne scheinbaren Vorgänger/Preview. Planung benutzt
nur frische gespeicherte typisierte, Boot-/Generations-/SignedSync-gebundene
Beobachtung und genau eine lokal unabhängig gerenderte Kandidatenpreview.
Kein vom Modell gelieferter Vorgänger oder Pin. Zentrale/lokale Updatepolicy
bleiben getrennt und standardmäßig deny; Full-/SCM-/APT-Rechte werden nicht
übertragen. Linux berücksichtigt General, Full und Agent; vorhandener APT-
Reader gehört ins geschlossene Stopset und bleibt inaktiv/unqualifiziert.
Der Fullrenderer ändert ausschließlich benannte Helperhash-Wertspans und den
abgeleiteten Policyhash; alle übrigen rohen Config-/Pinbytes bleiben erhalten.
Bei filebasiertem Signierkey wird der bereits provisionierte öffentliche Key
extern authentisiert übergeben, ohne den leeren Raw-Inlinekey zu ersetzen.
Vor dem ersten Apply ist ein gesonderter erhaltender Bootstrap auf ein bereits
Update-/Handoff-/Inflight-decoderkompatibles Agent-/General-/Fullpaar samt
stabilem Updater und qualifizierter Provisionierung erforderlich. **Das alte
1.20-Paar ist nach neuen Updatezeilen kein zulässiges Rollbackziel.** Erst die
kompatible tatsächlich qualifizierte Baseline erhält einen separat
release-signierten InstalledRecord/Floor. Manifest-/Protokoll-/Zustandsvertrag
und historische Journaldecoder müssen erhalten bleiben; keine Rückkehr zu
alten Decoderbytes durch einen Daten-/Ledger-/Generationreset. Aktive Version,
bestätigter Antirollbackfloor und angebotener Kandidat bleiben getrennt.
Ein zulässiger Code-Rollback verändert weder Datenzustand noch Floor; widerrufene
oder verbotene Vorgänger werden auch hierfür verweigert.
Auf Linux ist ausschließlich der ausdrücklich provisionierte Fullhelper der
ursprüngliche Updateautorizer sowie Owner-/Healthguard. Der Generalhelper bleibt
während dieses Inflightfalls geschlossen; fehlende eigene Zuständigkeit darf den
Originalversuch nicht zu Unknown herabstufen. Gegenseitige Imageprüfung muss unter
den tatsächlichen Dienst-Capabilities funktionieren. Kein CAP_SYS_PTRACE-Zusatz
oder aufgeweichter Generaldienst als Umgehung einer nicht erlaubten /proc-Prüfung.
Der alte unabhängig prüfende Helper schreibt Verbrauch, exakten bestehenden
Startzeugen, immutable Handoff, konkreten Delegationszeugen (stabiler
Updaterdienst/PID/Prozessgeburt/Image und ursprünglicher Helper) sowie Stopintent
in **einer Transaktion desselben erhaltenen Helperledgers**. Vorher kein Stop
oder Austausch. `ExecutionPermitPayload.agent_update_plan_id` wird ausschließlich
für diese Aktion zusätzlich signiert; bei allen anderen Aktionen fehlt das
Feld vollständig und erhält alte Grantbytes. Plan-ID/Hash, Job/Versuch/Grant,
Ownernonce, Boot, vorhandene Journal-/Kontrollketten und Dateiidentitäten bleiben
fest gebunden. Jeder andere offene/Unknown-Versuch verweigert Admission.
Der Updater übernimmt den echten bestehenden Executorlock und denselben Ledger
nur während alle installierten Reader bestätigt gestoppt sind. Austausch ist
kein atomarer Bundleswap: jeder Code-/Pin-Schritt bekommt dauerhaften Intent und
belegte Nachlese. Vor neuem Helperstart wird der dauerhafte Rückgabeintent
committet und der Guard tatsächlich abgegeben. Danach schreibt der neue Helper
unter seinem Guard. Geschlossene native Unterintents und Nachbeobachtungen
liegen append-only mit FK am selben Originalhandoff, nicht in einem neuen
Verbrauchs-/Serverjournal. Rückgabeintent und genau einmal reservierte Startfolge
General→Full→Agent committen gemeinsam vor Lockabgabe; diese Zeilen erlauben
keinen späteren Dispatch oder Resume durch einen neu gestarteten Worker.
Bis `ServicesStarted` bleibt der konkrete lebende stabile
Updater logischer Owner, auch im Rückgabe-/Startupgap; danach sind die neuen
konkreten Helperprozesse nachzuweisen. Fehlende/lost Owner-, Boot-, Zeit- oder
Effektzeugen bleiben `unknown`. Read-only-Reconciliation ist weder Execute-
Resume noch allgemeines Unknown-Healing; ursprüngliche Signaturen, Zeilen,
Outcomes, PKI und DB-/Lock-Dateiidentitäten werden nicht ersetzt.
Ein ausschließlich an diesen Originalversuch gebundener Inflightbeleg wird
additiv in `SyncAttempt.update_handoff_bytes` (Tag14) übertragen. Ein optionaler
signierter `AttemptDecision.update_inflight` bestätigt nur den exakten erhaltenen
Präfix bei `ready=false`, `helper_ready=false`, `unlock=false` und ohne Outcome.
Fachlicher Jobzustand bleibt `running`; sämtliche neuen Starts bleiben gesperrt.
Die gezielte read-only Helperquittung darf keine Startlease eröffnen. Bereits
persistiertes Unknown, fehlende Originale oder zurückgesetzte Präfixe dürfen
hierdurch nicht nachträglich zu Inflight werden. Kein weiterer ungebundener
Server-Journalslot wird eingeführt.
Health benötigt lokal belegtes vollständiges Code-/Pinpaar, erhaltene Zustände,
konkrete neue Serviceprozesse und neu authentisierten Agentkontakt samt frisch
serverseitig gespeichertem Inventar/ACK und tatsächlich angewandtem SignedSync.
Der gesonderte signierte `rmm.agent-update-health.v1`-Beleg verwendet einen
separat provisionierten Healthsignierschlüssel; Jobsigner-/TLS-/Releasekeys sind
kein Fallback. Der vor Genehmigung gebundene öffentliche Healthpin wird lokal
unabhängig authentisiert und im ursprünglichen Handoffkontext erhalten. Der
Beleg ist evidence-only,
bindet Originalhandoff/Owner/Boot/Codepaar/Prozesse/Kontroll- und Inventarzeugen
und bleibt Ready=false. Er verlängert weder180sHealth- noch600sGesamtfrist und
reaktiviert keine Genehmigung. Der tatsächlich inventarbestätigende originale
SignedSyncResponse wird als Inventar-ACK gehasht; eine gespeicherte nächste
SignedSyncRequest-Runde muss beide lokal angewandten Vorentscheidungen belegen.
Die bestätigende Serverzeit ist nur obere Applyzeitgrenze; der Helper gleicht
seine eigenen erhaltenen Rawbytes und Applyzeit unabhängig ab. Nach Health
werden InstalledRecord und Floor gemeinsam als ein neuer geschützter Record
mit erhaltenem Vorgänger und einmaligen nativen Intents publiziert. Erst danach
darf der neue Helper das noch fehlende
Originaloutcome create-once per bestehendem CAS speichern; vorhandenes Unknown
wird nicht überschrieben. Vorhandene Spiegelung und normaler signierter Sync
übernehmen exakt diese Bytes und lösen die gleiche ursprüngliche Sperre.
Dieser Abschnitt normiert den beauftragten engen Vertrag. Teilquellen/Units,
OS-Port, tatsächliche Kernel-/VMnachweise und noch fehlender ausgelieferter
Worker/Bootstrap/Apply sind getrennt in `docs/agent-updater-proposal.md`,
`docs/agent-updater-handoff.md` und `docs/agent-updater-linux-port.md` dokumentiert.
Keine Capability oder Native-/Produktionsfreigabe allein aus dieser Norm ableiten.
**Userentscheidung Version1.20 — vollständige genehmigte Skriptkonsole zuerst:**
Die KI darf über MCP gespeicherte Geräte-/Telemetriedaten im erlaubten Mandanten
lesen, vollständige Shell-/PowerShell-Skripte schreiben und feste Aufträge als