# Gemeinsames passives Windows-Komponentenupgrade Stand 2026-11-14: **Passive Wartung nach separat dokumentiertem ersten APIfehler und enger Recovery abgeschlossen. Positive Pipeabnahme weiterhin fehlgeschlagen.** Lokale Guards und PowerShell-Parserprüfung ersetzen weder die neuen nativen Unitnachweise noch den tatsächlichen Erhaltungs-/Pipebeleg. Der Notebookhost bleibt ausschließlich Entwicklungsrechner. `deploy/windows/system_delegation_upgrade.py` ist eine eigene enge Strecke für den vorhandenen Agenten `2beed7fa…` und Helper `921cf182…`, zuletzt PID5140/6240. Die historischen Runtime- und Helperbootstraprunner bleiben unverändert. Sie eignen sich absichtlich nicht zur erneuten Installation oder zum Neustart eines bereits vorhandenen Helperjournals. Der Originalfall `59c2fd6f…` bleibt erhalten. Die neue Strecke benötigt das gemeinsame Artefaktmanifest und den tatsächlichen nativen Unitbeleg aus `system_delegation_acceptance.py`. Sie bindet Agent, Helper, unveränderten `RuntimeStateProbe.exe` und den neuen lesenden `SystemStateProbe.exe`. Die gemeinsame Core-Qualifikation Linux80→Windows58 ist eine Voraussetzung; sie ist keine native Windows-Pipe- oder SCM-Wirkungsabnahme. Der feste Ablauf speichert vor der Mutation lokale und entfernte Create-only- Intents. Er hält die tatsächlichen Prozesshandles samt Startzeit, stoppt zuerst den ursprünglichen Agenten und wartet auf dessen Prozessende; erst danach stoppt er den ursprünglichen Helper. Beide Dienste müssen während sämtlicher Dateitausche gestoppt bleiben. Alle vier Originalbackups werden vor dem ersten `File.Replace` geschrieben und geprüft. Agent-EXE, Helper-EXE, `helper.json` und `agent-pin.json` erhalten jeweils eigene CAS-/Phasenbelege und ihre bisherigen Datei-ACLs. Erst nach Prüfung aller vier neuen Dateien darf der Helper einmal, anschließend der Agent einmal gestartet werden. Die beiden Startbelege binden PID und Prozessstartzeit auch beim späteren Finish. Die beiden öffentlichen Konfigurationen ändern ausschließlich die zwei Binaryhashes und den daraus berechneten Policyhash. Die sechs Agentconfigfelder, Geräteidentität, Zertifikate und Schlüsselmetadaten bleiben erhalten. Private Schlüsselbytes werden nicht gelesen oder übertragen. Dienste behalten Konten, Startmodi, Service-SID-Typ, Kommandozeilen und Service-ACL-Hashes. Telemetrie und Helperledger behalten ihre Dateiidentitäten, Erstellungszeiten, bestehenden Schemas und Zeilenbelege. Zwischen Stopp und Neustart werden zusätzlich ihre Dateibytes verglichen; danach darf die passive Telemetrie nur regulär fortschreiten. Die separat nativ vorbereiteten Intentdateien aus Fall `f322a4d2…` werden über dessen unveränderten Beleg `c4ef6fed…` gebunden: genau zwei reguläre 0-Byte-Blätter mit unveränderten Dateiidentitäten und engen ACLs. Der Runner initialisiert sie nicht und öffnet sie nicht als SQLite. Vorbereitung bedeutet weiterhin keine PERSIST-/Hotjournal-, Agenttoken-Zugriffs- oder Delegationsqualifikation. `enable_jobs=false`, kein Jobbinding, unqualifizierter Produktionsclockadapter, `allowed_services=[]`, `enable_effects=false` und `allow_reboot=false` bleiben unverändert. Der Runner führt keine RMM-Jobs, Paket-/Diensttests, Reboots, Uhränderungen, Freigaben oder Servermutationen aus. Die einzigen Dienstaktionen sind die ausdrücklich beauftragten Stopps/Starts dieser beiden eigenen Komponenten. Staging benutzt den bekannten gepinnten SSH-/SFTP-Pfad und feste hashgeprüfte PowerShell-Dateien mit RemoteSigned, keine freien Befehle oder ExecutionPolicy-Umgehung. Bereits qualifiziert vorhandene Stageartefakte werden anhand ihres exakten Hashpointers ausschließlich lesend verifiziert und nicht erneut übertragen oder überschrieben. Diagnosen sind auf den bestehenden Agentbeleg `state/helper-probe.json` und die zwei festen Helperdateien `state/pipe-last-error.json` sowie deren bekannte Stagingdatei `.pipe-last-error.pending` begrenzt. Helperdiagnosen sind maximal 1024Byte und enthalten ausschließlich Prozess-ID, Beobachtungszeit und feste Fehlerstufen/-codes. Sie liefern keinen positiven Pipebeweis. Dieser benötigt den frischen Beleg des tatsächlichen neuen Agentprozesses mit Challenge, reziproken Pins und erfolgreich authentisiertem Austausch. Bei Antwortverlust ist ausschließlich `readback --id …` zulässig. Dieser liest auch einen Teilstand und wiederholt keinen Stop, Dateitausch oder Start. Es gibt keinen automatischen Rollback, Retry, Journalreset oder Markerabbau. `finish --id …` benötigt beide tatsächlichen neuen Einzelstartinstanzen, Erhaltungsbelege, frische gespeicherte WSS-Heartbeats/Inventar-ACKs und unveränderte Windows-/Linux-Jobzählungen sowie Servergates. Erst danach wird der bisherige Runtimeindex per lokalem CAS um einen neuen Komponentenbeleg ergänzt. Ein noch fehlgeschlagener Pipebeleg bleibt ausdrücklich fehlgeschlagen; ein erfolgreiches passives Komponentenupgrade behauptet keine Jobfähigkeit. Aufrufvorlagen; tatsächlichen Fallstand unten beachten: ```text python3 deploy/windows/system_delegation_upgrade.py upgrade-passive --manifest --qualification python3 deploy/windows/system_delegation_upgrade.py readback --id python3 deploy/windows/system_delegation_upgrade.py finish --id ``` ## Tatsächlicher Fall6d2df065: erster Dateiaufruf fehlgeschlagen Originalfall `6d2df065-0877-41c4-983c-2c9fdb6e5437` scheiterte zunächst vor dem Server-Beforecheckpoint. Nach wiederhergestelltem gepinntem SSH-Zugang wurden fehlender entfernter Fall/Activeintent und unveränderte Originalprozesse separat lesend bestätigt. Ein zusätzlicher dauerhafter Fortsetzungsintent führte ausschließlich die erste zuvor nicht erreichte Phase desselben Falls aus. Originale Fehlermeldung und Quellen blieben erhalten, kein neuer Enrollment- oder RMM-Jobkontext. Native Stopps beider eigenen Dienste bestanden. Frozenbeleg und sämtliche vier privaten Originalbackups wurden gespeichert. Beim ersten Dateitausch meldete `[IO.File]::Replace($candidate,$destination,$null)` eine ArgumentException. Sofortiger gesonderter Readback: Agent/HelperStopped, vier Zielhashesoriginal, keine Replaced-/Swapped-/Startmarker. Eine weitere Nur-Leseprüfung bestätigt Frozen-DBbytes, Zeilen, tatsächliche Dateiidentitäten und PKI-Metadaten erhalten. Nur der erste Agentcandidate (exakter neuer Hash) und sein ursprünglicher Replaceversuchsmarker existieren; andere Candidates/Replaceversuche fehlen. Eigene native Einbyte-API-Fixture `45a21a07-a115-47ec-93e1-694aa519520a`: Nullbackupaufruf reproduziert ArgumentException, Quelle/Destination unverändert; separater Aufruf mit explizitem Backup schreibt erwartete Destination und Originalbackup. Keine Runtime-Datei wurde durch diese Fixture berührt. Die genauere interne PowerShell-/Framework-Konvertierungsursache wird daraus nicht als bewiesen behauptet. Der ursprüngliche Enter wird nicht erneut ausgeführt, Originalmarker und Quellen nicht geändert. Eine separate create-only Recovery muss vor jeder Fortsetzung diesen konkreten Vier-Dateien-/Frozen-/Nichtstartzustand bestätigen, den existierenden ersten Candidate hashgeprüft erhalten und einen ausdrücklich benannten zusätzlichen Nativebackup verwenden. Erst nach allen vier neuen Datei-/ACL-/Frozenbelegen dürfen die bisher noch nicht versuchten eigenen Helper-/Agentstarts folgen. Kein automatischer Retry oder Rücksetzen. ## Tatsächliche enge Recovery und Abschluss Neue Quelle `deploy/windows/system_delegation_recovery.py`, SHA `64ced170…`, Script `65e480f2…`, unabhängig geprüft und lokal Python-/PS-AST geprüft. Originale Quelle `f8dc1c8f…` unverändert. Recoveryfall `595dd1da-0d7f-4364-9040-a75e16c6da83` bestätigte separat den vollständigen Stopped-/Frozen-/Datei-ID-/Candidatekontext und führte einmal vier Tausche mit expliziten zusätzlichen Nativebackups durch. Alle vier neuen Dateien, ACLs und Frozen-Datenbanken wurden vor dem ersten Start geprüft. Anschließend Helper, danach Agent jeweils einmal gestartet; getrenntes Readback bindet dieselben Phasen. Originalmarker und erste ArgumentException bleiben erhalten. Originales `finish` war danach ausschließlich lesend: zwei frische WSS- Heartbeats, konkretes Inventar-ACK/fortgeschrittene Sequenz, gleicher Tenant/ Geräteidentität und fremder Tenant verweigert. Journale/Dateiidentitäten/Zeilen, Konfiguration und PKI-Metadaten erhalten. ZählerWindows0/0/0/0, Linux30/30/26/0 und geschlossene Flags/Rootpolicy unverändert. Runtime-/Komponentenindex erst nach diesen Belegen lokal per CAS veröffentlicht. Kein OS-Reboot, kein Job, kein Binding oder neuer Clock-/Wirkungsgate; Intentdateien weiter0Byte. Tatsächlicher Agent `89004ad3…`, LocalService/Auto, PID8108, Geburtswert `134391259111815072`; Helper `e6aacbdd…`, SYSTEM/Manual, PID2620, Geburtswert `134391259068713651`. Policy `007adf5f…`, reziproker Pin `126670bc…`. Privater Originalabschluss `result.json` SHA256 `ac00411fe1e109b18b28fd9c020245f462c179bb3ac99a37b69c7cff39c38460`; Recoveryabschluss `acceptance.json` SHA256 `5ad5925c8928f49cd0f9d48a64f81018281b5b6e3704c799bae64a42898322bb`. Die positive Pipeprobe bleibt ausdrücklich fehlgeschlagen: tatsächlicher neuer Agent meldet `client_read_reply`/`HELPER_PIPE_IO`, Win32233, kein authentisierter Austausch und kein privater Helperdiagnosebeleg. Dies ist ein erfolgreicher passiver Erhaltungs-/Wartungsnachweis, kein SYSTEM-Sync-/Job-/Clocknachweis. Kein erneutes Enter oder Wiederverwenden der ursprünglichen Startbefehle.