# 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>`. 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 `.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.