Prepare fixed EXE fixtures and qualify pure preconditions on cloud Linux
Rust development slice / linux (push) Failing after 6s

This commit is contained in:
2026-11-14 15:12:01 +01:00
parent 287a784c8f
commit 5dccb2e611
9 changed files with 1040 additions and 0 deletions
+165
View File
@@ -0,0 +1,165 @@
# Vorschlag für den engsten EXE-Vertrag nach Spezifikation1.19
Stand2026-11-14, **Root-Reviewentwurf, nicht beschlossen oder implementiert**.
Spezifikation1.19 erlaubt an dieser Stelle ausschließlich den bestehenden
MSI-Vertrag. Die folgenden Änderungen benötigen eine bewusste Präzisierung1.20
durch Root. Keine neuen Exporte, Capabilities, Policies oder Ausführungsgates
wurden aktiviert. Der Sourcebuild ist kein nativer Installationsnachweis.
## 1. Exakt zwei eigene Artefakte und ein typisierter Plan
Ausgangspunkt ist der geprüfte Fixturebuild
`build-e85496e8-b6dd-4834-8c17-843ee5c5b3da`, Qualification-SHA256
`f74c207e8fa6a9254759b103e8d81c962ec2becca9ee2feb9b1156fd395e1061`.
Die Kandidaten sind bewusst unsignierte Entwicklungsartefakte:
| Ziel | EXE-SHA256 | Bytes |
| --- | --- | --- |
| 1.0.0 | `9a972430614625b99985cd3db69f7f8f47e561c954697d57ba21e79fd5b787dc` | 23040 |
| 1.1.0 | `196d22893eaea74d332782c597d4cbce631522006786a4aae074ad0a2bea8c89` | 23552 |
Nur diese beiden Artefakte gehören zum ersten EXE-Profil; kein beliebiges EXE
mit ähnlich benannten Registrywerten. Ein anderer Build braucht eine neue
explizite Profil-/Rezeptentscheidung und eigene Qualifikation. Die einzige
abgeleitete Argumentliste lautet `--quiet --norestart`; keine Argumentfelder,
URLs, Repair-, Uninstall-, Shell-, Dienst- oder Rebootoptionen.
`Action::EnsurePackage` erhält **am Ende** ein optionales
`windows_exe_manifest: Option<Box<ResolvedWindowsExe>>`. Fehlend wird als None
ausgelassen; vorhandenes null, Enum-Objekte und unbekannte Felder werden
abgewiesen. JsonSchema beschreibt die optionale Eigenschaft ohne null.
Genau eines von APT/MSI/EXE darf vorhanden sein. Alte APT-/MSI- und Linux-
Job-/Planbytes müssen unverändert bleiben; kein JobPayload-/Grant-/IPC-
Versionswechsel. Die Action ist ausschließlich `execution_identity=system`,
`provider=exe`, `package=rmm-windows-exe-fixture`, `architecture=x64`,
`installation_context=machine`, `recipe_version=1`, exakte Version und Recipe-ID.
Vorgeschlagene kanonische Feldordnung:
* `ResolvedWindowsExe`: `recipe`, `recipe_sha256`.
* `WindowsExeRecipe`: `schema_version=1`, `recipe_id`, `recipe_version=1`,
`platform=windows`, `architecture=x64`, `context=machine`,
`command_profile=exe_fixture_quiet_no_reboot_v1`, `artifact`, `postcondition`,
`no_reboot=true`, optionales `predecessor`.
* `artifact`: `artifact_id`, `sha256`, `bytes`, mit exakt einem obigen Paar.
* `postcondition`: `registry_hive=hklm`, `registry_view=64` als strikter String,
`registry_key=SOFTWARE\\RustDiscovery\\ExeFixture`,
`product_id=RustDiscovery.ExeFixture`, `product_version`,
`payload_path=C:\\Program Files\\RustDiscoveryFixtures\\exe-payload.txt`,
`payload_sha256`, `payload_bytes=33`.
Die Recipe-IDs sind `rmm-windows-exe-fixture-install-1.0` und
`rmm-windows-exe-fixture-upgrade-1.1`. `predecessor` ist für1.0 abwesend und
für1.1 zwingend die vollständige feste1.0-Nachbedingung, ebenfalls strict
nonnull/None-omit. Keine frei wählbaren Registrywerte oder Zielpfade.
`recipe_version` ist der String `"1"`, nicht die JSON-Zahl1; `schema_version`
ist die Zahl1. Der Recipehash ist SHA256 der exakten Domain-Serialisierung einschließlich
Artifact-ID; alle folgenden Bindungen verwenden dieselben Bytes.
## 2. Tenantkatalog, Genehmigung und ausdrückliche SYSTEM-Obergrenze
Eine eigene immutable `windows_exe_recipes`-Tabelle folgt dem MSI-Muster:
Tenant-/Rezept-/Versions- und Tenant-/Recipehash-Eindeutigkeit, zusammengesetzter
FK auf Tenant/Artifact-ID/SHA/Bytes, FORCE RLS, nur SELECT/INSERT, Verbot von
UPDATE/DELETE. Import/List sind vom MSI-/APT-Katalog getrennt. Kein zusätzlicher
generischer Downloadpfad: pro Job genau eine automatische Artifactreferenz,
vollständige Recipe- und Artifactmengen des Plans; zunächst homogene EXE-Pläne.
Plan, Submit, WebUI-Genehmigung, Delivery, Permit und mTLS-Artifactdownload
prüfen dieselbe Bindung und die aktuellen Rechte erneut.
Bestehende Rechte `operations:plan`, `operations:submit`, `plans:approve` und
`system:execute` bleiben ihre jeweiligen Voraussetzungen. Policies genehmigen
weiterhin nichts. Eine neue zentrale **und** lokale SYSTEM-Policy/Settings-
Schema3 ergänzt höchstens zwei eindeutige `allowed_exe_recipe_sha256`.
Schema1 bleibt SCM-only, Schema2 SCM/MSI-only; beide verweigern EXE. Schema3
behält die vorhandenen MSI-Hashes und ergänzt EXE nur ausdrücklich. Das neue
optionale Feld fehlt in alten Serialisierungen; null und fremde Hashes werden
abgewiesen. Tenant/Asset/Agent/Generationen/Principals und Helper-Policy-/Binary-
Pins bleiben vollständig gebunden, `allow_reboot=false` bleibt Pflicht;
maximal120Sekunden Originalbudget und65536Ausgabebytes wie beim MSI-Profil.
Zusätzlich nötig sind die vorhandenen Windows-/Sync-/Helper- und
`ensure_package`/`system:ensure_package`-Capabilities sowie die **neue enge**
`package.exe.fixture/1`; keine allgemeine SYSTEM-EXE- oder Skriptautorität.
Alle bleiben bis getrennter nativer Qualifikation deaktiviert. Die WebUI zeigt
SYSTEM, Recipe-/Artifacthash, feste Argumente, Budget, Vorgänger und vollständige
Nachbedingungen ausschließlich aus verifizierten gespeicherten Planbytes.
Jobs/Payload/ResolvedTargets/Preview-Aliases und spätere Mutationen werden wie
bei MSI gegengeprüft; echte Domain-Goldenbytes verhindern None-/Feldordnungsfehler.
## 3. Derselbe Delegationskern, ein enger EXE-Provider
Der vorhandene mTLS-Client lädt nur das genehmigte Job-/Attempt-Artifact mit
exakter Länge/SHA und höchstens256KiB. Ein fest vorprovisionierter Actor-
Stagingbereich `exe-stage` und SYS-Cache `<sha>.exe` erweitern die vorhandenen
Cachehelfer über einen **geschlossenen MSI/EXE-Typ**, nicht über Callerpfade,
URLs oder IPC-Bytearrays. SYSTEM prüft erneut Parent-/Reparse-/ACL-/File-ID-
Bindung sowie Bytes/SHA, kopiert unabhängig in den geschützten Cache und hält
die eigenen Archivhandles. Fehlende Konfiguration führt zu not_configured;
keine implizite Ordner-/ACL-Reparatur.
OriginalRequest-/Grant-/Boot-/Helper-Lineage, Intent-CAS, dauerhafter Cancel-
Deny, Abandon, RawFullTupleMirror und SignedSync werden **nicht dupliziert**.
Historische und aktuelle Auth-/Clock-/Scope-/Policyprüfungen bleiben erhalten.
Atomarer Helper-Start erfolgt vor Cache-/Installerwirkung; Abandon führt keine
Cache-/Providerarbeit aus. Das ursprüngliche monotone Gesamtbudget umfasst
Cache, Metadaten, Noop, Start, Beobachtung und Nachprüfungen. Frische Peer-/
Clock-/Fence-/Cancelprüfung unmittelbar vor Noop oder Start, ohne langlebigen
SQLite-Lesesnapshot. Der letzte Read→Spawn-Abstand ist keine Rollbackgarantie.
Ein neuer enger EXE-Provider startet ausschließlich das gehaltene Cacheartefakt
mit den festen Argumenten, ohne Shell/Netz/weitere Prozesse. Die bisherige
`UnsettledMsi`-Verwaltung wird am vorhandenen Dispatcher zu einem geschlossenen
`OwnedPackageChild::{Msi,Exe}` erweitert: **ein** gemeinsamer gesperrter Slot und
Paketressourcen-Lock, OriginalRequest-/Grantbindung, Child- und Archivhandles.
Nach unklarem Timeout bleiben diese erhalten; keine weiteren MSI-/EXE-Starts,
bis derselbe Prozess nachweislich zur Ruhe gekommen ist. Kein globales Kill,
PID-Adoption, automatischer Retry oder nachträgliches Umschreiben des Unknown.
Helpercrash hebt die ursprüngliche Ledgersperre nicht auf. Cancel nach Start
liefert keine globale Prozessbeendigung oder Zusage zurückgenommener Wirkung;
derselbe Versuch wird weiter beobachtet und sein Ausgang ehrlich festgehalten.
## 4. Unabhängige Zustands- und Ergebnisregeln
Der Provider liest nativ ausschließlich HKLM64 und die feste Nutzdatei:
genau7 korrekt typisierte Fixturewerte, keine Unterkeys/Registrylinks; gehaltene
geschützte Nonreparse-Datei mit File-ID, genau33Bytes und festem SHA. Payload1.0
hat SHA `7b8019c151f3953261b3afbbea1b59ca7112ab09c7a2911d24d17921d6fd6adf`,
Payload1.1 `e1da48d2a8b89d66db822c24dc2ef7a0cfc13bce11875f15157d03081979d3f0`.
Die übrigen Registrywerte/-typen stehen unverändert im Fixture-README.
Kein Erfolg aus stdout oder EXE-Exit allein, kein Win32_Product-Aufruf.
| Beobachtung innerhalb des Originalbudgets | Dauerhaftes Ergebnis |
| --- | --- |
| Unabhängig exakt gewünschter Zustand, frischer Fence | erfolgreicher Provider-Noop, kein Child, Exit=None |
| 1.0: vollständig leer; 1.1: vollständig exakt1.0 | einziger jeweils zulässiger Startbestand |
| Widersprüchlicher/teilweiser Bestand vor Start | verweigert, keine automatische Reparatur |
| Child Exit0 und unabhängige vollständige Zielnachbedingungen | erfolgreich; Prozessstart ist kein Beweis tatsächlich veränderter Bytes |
| Exakter Fixture-Exit10 vor eigener Mutation | failed; ursprünglicher Grant bleibt konsumiert, kein erfundenes NoStart/Unlock |
| Exit20 nach möglicher Teilwirkung | unknown, auch wenn der aktuelle Bestand zufällig vollständig erscheint |
| Unerwarteter Exit, unklare Beobachtung, überschrittenes Budget | unknown bei möglicher Wirkung, kein Retry/Retro-Success |
MSI-Codes3010/1641/1618 bekommen **keine** EXE-Sonderbedeutung. Der feste
Fixturecode enthält keinen Rebootaufruf; Exit0 beweist keine allgemeine
Rebootfreiheit beliebiger EXEs oder Abwesenheit eines ambienten Pendingflags.
Nur der normale signierte Sync darf verbrauchte Ressourcen freigeben.
## 5. Kleinste Dateigrenze und fehlende Nachweise
| Bereich | Geplanter Eingriff nach Root-Entscheidung |
| --- | --- |
| Norm | Root: Spezifikation1.20, project-decisions, development; die beschriebenen engen Ausnahmen ausdrücklich festhalten |
| Domain | neu `windows_exe.rs`; `lib.rs`/`jobs.rs` additive Typen/Validatoren/Codec-Goldens, keine alten Feldänderungen |
| Backend | neuer EXE-Katalog und Migration nach0014; vorhandene Jobs/Policy/Gateway/Artifact-Routen um genau den neuen Typ ergänzen |
| WebUI | bestehende API/Safety/Main und betroffene Tests; verifizierte Projektion und eigener Katalogimport/-list |
| Windows | neuer `exe_package.rs`; vorhandene Cachehelfer, SYSTEM-Dispatcher/Settings, helper_runtime/runtime/lib; Intent-/IPC-Operationsvertrag unverändert |
| Core/Protocol | keine neue Zustandsmaschine, kein Unlock-/Grantcodec; Domain-gesteuerte Scopeprüfung nur falls technisch erforderlich additiv |
Bereits vorhanden: Fixture-Source-Review und lokaler GNU-Build mit ausgeführtem
reinem Linux-Guard; Windows-Guard und Installer nur gebaut. Offen sind echte
Linux→Windows-Guardabnahme, Domain/Schema-/RLS-/Plan-/Policy-/UI-Belege,
nativer sicherer Cache-/PERSIST-/HKLM64-/File-ID-Nachweis sowie separat per
WebUI genehmigte1.0-Installation,1.1-Upgrade und Noops/Fehlerpfade. Source,
Build, native Unitqualifikation und echte Installerwirkung bleiben getrennte
Abnahmeschritte. Vor deren Nachweis keine Ready-/Capability-/Clock-Gateflips;
keine EXE-Ausführung auf dem Notebook.