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
+69
View File
@@ -0,0 +1,69 @@
# Reine EXE-Fixture-Vertragsguards
Der getrennte Runner `deploy/windows_exe_guard_acceptance.py` liefert ausschließlich
`linux-precondition-guard` und `windows-precondition-guard.exe` aus der unveränderten
Fixture-Qualifikation `f74c207e8fa6a9254759b103e8d81c962ec2becca9ee2feb9b1156fd395e1061`.
Diese C-Programme prüfen mit `assert` nur Zustandsmatrix und feste Argumente. Sie
enthalten keine Installer-, Registry-, Datei-, Netzwerk- oder Dienstoperationen.
Die beiden eigentlichen Installer und ihre Originaldateien sind keine Deliveryrollen.
Das neue private Manifest liegt unter
`devstate/windows-exe-contract-guards/build-aa4e2eea-4063-433c-83b1-75105e7fcdb6/manifest.json`
mit SHA-256 `982096ec11d19d7a23901d2e2330152aa6ae8938ddb7aaac0d64a3633d1a4ac6`.
Es bindet beide Guardbytes, ursprüngliche Qualifikation, neun Fixture-/Normquellen,
Runner und vorhandene Zugangsparser. Die fünf Compilerquellen, ursprünglichen
Links und bisherigen Qualifikationsberichte bleiben erhalten.
Lokal tatsächlich bestanden: Python-Syntax, PowerShell-AST einschließlich Prüfung
auf Funktionsnamen mit vorhandenen Aliasen, Guardrollen-/Manifestprüfung,
begrenzte Nachwartezeiten und simulierter Antwortverlust mit ausschließlich
anschließendem Readback. Der private lokale Guardbericht hat SHA-256
`a9c3b0e2dfc5225b7ce4af7787cb8c138a878ac2d5b2fa3a6199d7820c69d997`.
Keine native VM-Ausführung, kein SSH-Zugriff und keine Installation wurden dafür
durchgeführt. Dies ist weder ein Produkt- noch ein LocalService-Nachweis.
Die folgenden Befehle sind **geplant, nicht ausgeführt**. Zuerst auf der echten
Cloud-Linux-VM, danach mit dessen vollständigem Exit-0-Bericht auf Windows:
```sh
python3 deploy/windows_exe_guard_acceptance.py linux \
--manifest /home/kevin/Schreibtisch/Coding/rust-discovery-windows-exe-fixture/devstate/windows-exe-contract-guards/build-aa4e2eea-4063-433c-83b1-75105e7fcdb6/manifest.json \
--access-root /home/kevin/Schreibtisch/Coding/rust-discovery \
--execute-native-guard
python3 deploy/windows_exe_guard_acceptance.py windows \
--manifest /home/kevin/Schreibtisch/Coding/rust-discovery-windows-exe-fixture/devstate/windows-exe-contract-guards/build-aa4e2eea-4063-433c-83b1-75105e7fcdb6/manifest.json \
--access-root /home/kevin/Schreibtisch/Coding/rust-discovery \
--execute-native-guard
```
Jeder Aufruf erzeugt einen neuen privaten Fall. Der entfernte Startintent wird vor
Ausführung dauerhaft und exklusiv erstellt. Linux verwendet einen eigenen
Netzwerk-Namespace, geleerte Umgebung und begrenzte Laufzeit/Dateiausgaben.
Windows verwendet einen eigenen Scratchpfad, geleerte Umgebung und begrenzte
Prozess- und Ausgabewartezeiten. Erfolg verlangt Exit 0 ohne Timeout und ohne
Ausgabe. Es gibt keine Rust-Testliste und keine zusätzlichen Vertragsfälle.
Nach verlorener Antwort ausschließlich `readback-linux` bzw. `readback-windows`
mit denselben Manifest-/Accessargumenten und `--case ORIGINAL-UUID` verwenden,
**ohne** `--execute-native-guard`. Fehlende oder teilweise Berichte erlauben weder
erneuten Upload noch erneuten Start. Der Mainpfad dient allein dem Lesen bereits
vorhandener streng geparster und hostschlüsselgebundener Bootstrapzugänge;
Quellen, Artefakte und Berichte bleiben im EXE-Worktree.
## Tatsächlicher Cloud-Linux-Guard
Root führte nach eigenem Quellenreview den festen reinen C-Guard auf der
permanenten Cloud-Linux-VM aus: Exit0, kein stdout/stderr, kein Timeout.
Fall `17f3b424-09ac-4501-90a0-a044d5fd733a`, ManifestSHA256
`982096ec11d19d7a23901d2e2330152aa6ae8938ddb7aaac0d64a3633d1a4ac6`,
LinuxproofSHA256
`ce46d28a52ec6d144cd284586a2a3ef7fdf9a809389ab8281ce8ebaf79545320`.
Neue eigene Bootstrap-Scratchdaten, leere Umgebung und neuer Netzwerknamespace;
kein Installer geliefert oder gestartet, keine Produktdaten oder Dienste geändert.
Dies ist ein ausgeführter C-Assertionguard, keine erfundene Rust-Testzahl oder
Installationsabnahme. Windows-Guard und beide tatsächlichen EXE-Installations-/
Upgrade-/Noop-/Fehlerabnahmen bleiben offen. Jede RMM-Paketwirkung benötigt
weiterhin den eigenen unveränderlichen Plan und tatsächliche WebUI-Genehmigung.
+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.
+60
View File
@@ -0,0 +1,60 @@
# Windows EXE-Fixture: Quelle und lokale Artefakte
Stand 2026-11-14, eigener Zweig `codex/windows-exe-fixture` ab `287a784`.
Nur die fünf neuen Dateien unter `tools/windows-exe-fixture/` und diese Notiz.
Kein Domain-/Core-/MSI-/Runtime-/Helper-/Backend-/UI- oder Normvertrag geändert;
kein EXE-Provider exportiert. Der feste MSI-Schnitt aus Version1.19 bleibt
unverändert. Die zusätzliche Fixture deckt noch keine EXE-Abnahme ab.
Die Quelle ist ein kleines, eigenständiges SYSTEM-/AMD64-Programm ohne freien
Pfad, URL oder Command. Genau `--quiet --norestart`; eigene HKLM64-Kennung und
33Byte-Nutzdatei getrennt vom MSI. Ausgangsbestand, Zielversion, Bytehash und
Noop-/Upgradegrenzen stehen im [README](../tools/windows-exe-fixture/README.md).
Nach dem ersten möglichen Schreibzugriff bleibt ein Fehler unbestimmt, ohne
Retry, Repair oder Rollback. Produktregistry und Nutzdatei müssen durch den
späteren Provider unabhängig gelesen werden. Geschützter Fixtureordner ist
Voraussetzung; keine stillschweigende ACL-Reparatur.
## Tatsächlich lokal ausgeführt
`python3 tools/windows-exe-fixture/build.py`, privater finaler Fall
`devstate/windows-exe-fixture/build-e85496e8-b6dd-4834-8c17-843ee5c5b3da/`.
Qualification-SHA256
`f74c207e8fa6a9254759b103e8d81c962ec2becca9ee2feb9b1156fd395e1061`.
Neun Quellen-/Norminputs vor und nach dem Build identisch; festes vorhandenes
Dockerimage, Netzwerk aus, Build unter Host-UID/GID, kein Zugriff auf Zugänge.
- Linux: reiner Zustands-/Argumentguard im Container kompiliert und tatsächlich
mit Exit0 ausgeführt, `-std=c11 -O2 -Wall -Wextra -Werror`.
- Windows: derselbe reine Guard und beide Installer mit GNU/Werror kompiliert,
nur gelinkt, **nicht ausgeführt**. AMD64-PE-Strukturen geprüft.
- Installer1.0:23040Bytes,
SHA256`9a972430614625b99985cd3db69f7f8f47e561c954697d57ba21e79fd5b787dc`.
- Installer1.1:23552Bytes,
SHA256`196d22893eaea74d332782c597d4cbce631522006786a4aae074ad0a2bea8c89`.
- Windowsguard:15360Bytes,
SHA256`1929a20c041c96337a8e2665b7aad4ea8a46604ccddebcaab68242c7387b84cf`.
- Linuxguard:16128Bytes,
SHA256`5af37aa734e47dac480a2fe4d6039d4bf6708bb392f4b00320d1c7ab79fac439`,
nur`libc.so.6`, höchste referenzierte glibc2.34.
- Installerimports ausschließlich ADVAPI32/bcrypt/KERNEL32/msvcrt. Originale
Linkdateien und getrennte Stripdateien erhalten. Fixtureartefakte ausdrücklich
unsigniert; kein produktiver Installer-/Signiernachweis.
Ein ursprünglicher Build kompilierte erfolgreich, konnte seine root-owned
600-Artefakte aber nicht im Hostprozess lesen. Dieser unvollständige Fall samt
Fehlerbeleg bleibt erhalten; der Builder verwendet danach explizit Host-UID/GID.
Der nächste erfolgreiche Zwischenbuild vor der ergänzten nativen AMD64-Prüfung
bleibt ebenfalls historisch erhalten. Nur der obige finale Fall ist der aktuelle
lokale Quellen-/Artefaktbeleg.
## Geplant, nicht ausgeführt
Zuerst denselben wirkungslosen Guard auf der Cloud-Linux-VM, danach auf Windows
nachweisen. Danach benötigen EXE-Rezept, Katalog-/Artefaktbindung, eigene
SYSTEM-Policy, Helpercache, Provider-Outcome-/Cancel-/Unknown-Grenzen und WebUI
jeweils ihre explizite Vertragserweiterung und Qualifikation. Es gibt keinen
Installationsbootstrap oder freigabefähigen RMM-EXE-Job in dieser Lieferung.
Native Erstinstallation,1.0→1.1, Noops, Registry64-/ACL-/Handle-/Teilwirkungs-
und Absturznachweise sind offen. Jede Zielwirkung braucht den festen realen
WebUI-Plan; Linux-/Windows-Guard oder Crossbuild ersetzt dies nicht.