Add gated agent update planning, preserved handoff and Linux worker ports
Rust development slice / linux (push) Failing after 6s
Rust development slice / linux (push) Failing after 6s
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user