# Optionale IPC-Clientfunktion identitätserhaltend ausrollen Stand 2026-11-14: Der neue Runner `deploy/windows/runtime_feature_upgrade.py` ist **implementiert, neu nativ qualifiziert und auf der bestehenden Windows-VM erhaltend ausgeführt**. `runtime_upgrade.py` und seine abgeschlossenen historischen Fälle bleiben unverändert. Die frühere native Default-/Helperunit-Abnahme ersetzt nicht die neue Featureabnahme. Der Runner erlaubt ausschließlich den belegten Übergang vom bisherigen passiven Agentbinary `f64e81155a4d86089a9dd7e6ec42ffba50b939442386c3187a28769a4de1aa0b` zu einem neuen Build mit `system-helper`. Er liest den maßgeblichen `current-runtime.json` samt unveränderlichem tatsächlichem Upgradebeleg und vergleicht vor der ersten Wirkung Image, öffentliche Identität, Konfiguration, ACLs und Metadaten des unexportierten Geräteschlüssels. Die ursprüngliche Sechsfeldkonfiguration und automatische WSS-/HTTPS-Auswahl bleiben erhalten. Helper, Pin, Jobs, Uhr- oder Serverpolicy werden dabei nicht installiert/aktiviert. Der neue Quell-/Artefaktmanifest bindet auch `helper_runtime`, `helper_ipc`, `helper_system`, die Helperbinaryquelle und den unabhängigen Shared-Core-Helper. `build-local` verlangt die weiterhin geschlossene Produktionsuhr, baut offline und führt Clippy mit `-D warnings` aus. Der Eltern-Orchestrator führt anschließend `qualify-native` aus: Alle genau 21 neu gebauten Bibliotheks- und sechs Binarytests müssen auf der Windows-VM bestehen. Die tatsächlichen Artefakthashes und die Windows-/Linux-Jobzähler sowie Policy-/Faultflags werden davor und danach verglichen. Das sind Administrator-Bootstrap-Units, kein laufender SYSTEM-Dienst und kein positiver Pipebeleg. Die native Upgradephase benutzt einen eigenen create-only Namensraum `runtime-feature-{UUID}` mit `runtime-feature-active-intent.json`. Sie überschreibt den alten V1-Intent nicht. Das feste PowerShellverfahren wird mit engen, eindeutigen Ersetzungen aus der erhaltenen V1-Quelle abgeleitet. Es erhält Datenbankidentität, ursprüngliche Tabellen, unbestätigte Telemetriebytes, Sequenzkontinuität, Geräte-/Zertifikats-/CAidentität und ACLs. Vor Stop, Austausch und Start stehen dauerhafte Intents. Nach einem unklaren SSH-Ausgang wird `enter` nicht wiederholt; `finish` liest den tatsächlichen Zustand, ein Rollback ist eine gesonderte ausdrückliche Aktion mit eigenem einmaligem Startversuch. Erst nach zwei tatsächlichen WSS-Heartbeats, bestätigter Inventarübertragung, Mandantengegenprobe und unveränderten Job-/Servergrenzen schreibt der Runner `system_helper_client_feature=true` in Ergebnis und aktuellen Runtimeindex. Der Indexwechsel prüft den erwarteten vorherigen Hash oder denselben bestehenden Fall; ein fremder Übergang wird nicht überschrieben. Nach Rollback darf ein historisches Feature-Ergebnis nicht als aktueller Zustand veröffentlicht werden. Alle Finish-Aufrufe lesen das tatsächliche ausgewählte Image erneut. Phasenfolge; tatsächliche Ergebnisse dieses Durchlaufs unten: 1. `runtime_feature_upgrade.py build-local` 2. `runtime_feature_upgrade.py qualify-native --manifest ` 3. `runtime_feature_upgrade.py upgrade-passive --manifest --qualification ` 4. Bei verlorenem Reply nur `finish --id `; eine ausdrücklich gewünschte Wiederherstellung verwendet `rollback --id `. 5. Erst danach [den passiven SYSTEM-Helper installieren und die echte LocalService-Pipeverbindung nachweisen](windows-system-helper-bootstrap.md). Tatsächlich lokal ausgeführt: Python-Syntaxprüfung, PowerShell-Parser aller drei abgeleiteten Quellstrings und vier gezielte Guards bestanden. Diese prüfen exakte/eindeutige Ableitung, getrennten Namensraum, Ablehnung des alten Defaultprofils als Featurequalifikation, aktuelle Zustandsprüfung nach Rollback und CAS-Ablehnung eines fremden Runtimeindex. Keine VM-/Serveraktion und kein RMM-Job wurde durch diese lokalen Prüfungen ausgelöst. ## Tatsächlich auf der Windows-VM ausgeführt Neuer Buildmanifest `923aa4e8-d1e7-43fb-bffb-6450b2fe233f` bindet57 Quellen. Lokaler Offline-Releasebuild und Clippy bestanden. Neuer eigener nativer Fall `23b0e0aa-d5c5-433b-a025-53293d86c1a0`: alle21 Library- und6 Binarytests bestanden, ohne Skip, als Bootstrapadministrator. Unverdrahtete MSI-/Eventlog- Quellen sind dadurch nicht als native Provider qualifiziert. Anschließend Fall `cea4d30f-06a1-4f80-b483-f8b1bb6b0899`: neues Agentimage `2beed7fa…`, tatsächlicher LocalService-PID5140, Auto/WSS, ursprüngliche Konfiguration/ACLs/Identität/Schlüsselmetadaten/Telemetrie-DB erhalten. Zwei frische Heartbeats, konkretes Inventar-ACK und Fremdtenant-Verweigerung bestanden; Windows0/0/0/0 und Linux30/30/26/0 erhalten. Der erste nachgelagerte Nur-Lese- SSH-Aufruf lief in ein Timeout; ausschließlich `finish` desselben Falls wurde wiederholt, kein zweiter Dienststart oder Binärtausch. Der aktuelle Index bindet den tatsächlichen verifizierten Abschluss. `system_helper_client_feature=true` bezeichnet den kompilierten optionalen Client, keine SYSTEM-Aktionsfreigabe. Uhr und Jobs bleiben geschlossen; noch kein Signingbinding/Verbrauchsledger/Jobsverzeichnis beim Netzwerkagenten. Die tatsächliche Dienst-Pipeverbindung ist ein getrennter nächster Nachweis.