# Windows Helper: begrenzte Transportbestätigung Dieser Schnitt ist im isolierten Zweig `codex/windows-pipe-drain` implementiert. Eine native Ausführung des neuen Framings und ein Komponentenupgrade sind noch nicht nachgewiesen. Die bestehenden Nachweise des Agenten `89004ad3…` und Helpers `e6aacbdd…` bleiben historische Belege ihres ursprünglichen Framings. ## Anlass und Beleggrenze Beim tatsächlichen Agenten wurde `client_read_reply / HELPER_PIPE_IO / 233` beobachtet; die Helperdiagnose war nicht vorhanden. Der bisherige Dienst rief auch nach erfolgreichem Schreiben der Antwort sofort `DisconnectNamedPipe` auf. Microsoft dokumentiert, dass dabei ungelesene Pipebytes verworfen werden. Das ist ein konkreter möglicher Fehlerpfad, aber kein Nachweis, dass genau dieser Pfad die beobachtete Störung verursacht hat. [DisconnectNamedPipe](https://learn.microsoft.com/en-us/windows/win32/api/namedpipeapi/nf-namedpipeapi-disconnectnamedpipe) Eine fehlende Diagnose beweist weder einen erfolgreichen Peercheck noch eine bestimmte Ablehnung: strukturierte `Denied`-Antworten erzeugen keinen privaten Pipefehlerbeleg, Connect-Leerlauf kann ohne Beleg enden, und das begrenzte Diagnoseschreiben selbst kann fehlschlagen. Diese Pfade werden hier nicht umgedeutet oder gelockert. ## Framing v2 und Reihenfolge Agent und Helper verwenden ausschließlich `\\.\pipe\RustDiscovery-System-v2`. Jeder JSON-Frame beginnt mit acht ASCIIbytes `RDPIPC02`, gefolgt von vier Bytes Länge in Big Endian und den bisherigen, maximal 1 MiB großen JSONbytes. V1 und V2 haben unterschiedliche Endpunkte; zusätzlich verweigert der V2-Parser alte oder fremde Framingtags. Es gibt keinen stillen Fallback. Beide EXEs müssen als gemeinsam qualifiziertes, gegenseitig gepinntes Paar bereitgestellt werden. Die JSONschemas von Call/Reply, `helper.system.v1`, Systempolicy-Schema 1 und RMM-Jobbytes ändern sich nicht. Nach dem vollständigen Lesen der Antwort prüft der Agent weiterhin den tatsächlichen Helperprozess, Schema, Challenge, Enrollmentbindung, Policyhash, Helperbinaryhash und die Operation/Antwort-Zuordnung. Erst danach schreibt er genau 56 Bytes: `RDPACK02` (8), ursprüngliche UUID-Challenge in UUID-Bytefolge (16), SHA-256 der **exakt empfangenen JSON-Antwortbytes** (32). Es findet keine Re-Serialisierung für diese Prüfsumme statt. Auch eine vollständig geprüfte `Denied`-Antwort wird so transportseitig bestätigt, ohne sie in einen Erfolg umzuwandeln. Der Helper prüft denselben bereits authentifizierten Peer vor dem Schreiben und nach dem Lesen der Bestätigung. Schreiben, Empfang und Prüfung der Bestätigung teilen dieselbe bisherige Antwortdeadline von fünf Sekunden; der Client behält seine bisherige Gesamtdeadline. Erst danach trennt die Dienstschleife die Pipe. Fehlende, falsche oder verspätete Bestätigung schließt den bestehenden Syncgate und trennt die Verbindung über den bisherigen Fehlerpfad; statische Diagnosen unterscheiden `server_drain_receipt` und `client_drain_receipt`. Es gibt keinen weiteren Aufruf, Retry oder erneute Ausführung. Diese Bestätigung bestätigt nur den Empfang der Antwortbytes. Sie ist kein JobResult-, Journal-, SignedSync-, Grant-, Freigabe- oder Wirkungsbeleg und löscht keinen dauerhaften Zustand. Ein bereits ausgeführter Auftrag wird durch einen fehlenden Transport-ACK nicht zurückgenommen oder wiederholt. `FlushFileBuffers` wird nicht verwendet: dieser synchrone Pipeaufruf wartet laut Microsoft bis zum Lesen aller gepufferten Daten und bietet hier keine passende begrenzte Warteoperation. [FlushFileBuffers](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-flushfilebuffers) ## Prüfung und verbleibender nativer Nachweis Die bestehenden IPC-Codecfälle prüfen zusätzlich fremde/alte Frameversionen, begrenzte Längen sowie manipulierte ACK-Tags, Challenge und Prüfsumme. Eine andere JSON-Bytefolge mit gleichem JSON-Inhalt darf den ursprünglichen Frame nicht bestätigen. Die bestehenden Unitfallzahlen bleiben dadurch unverändert. Lokale Qualifikation wird separat in einem geschützten `devstate/`-Beleg mit Quellen- und Artefakthashes erfasst. Cross-Clippy und Linken sind kein nativer Pipebeleg. Vor einem Zielupgrade sind unabhängiger Quellreview, die nativen Windows-Units des gleichen Manifests und ein eigener erhaltender Paarupgrade mit explizitem Backup sowie anschließendem tatsächlichen Agent/Helper-Austausch notwendig. Alle Produktgates bleiben geschlossen. Lokale Ausführung: Default- und `system-helper`-Clippy für alle Windows-GNU-Targets mit `-D warnings`, Release-Build beider EXEs und Linken beider Unitprogramme waren erfolgreich. 61 gebundene Quelldateien blieben vor/nach dem Lauf gleich. Die bestehenden 23 Library- und 7 Binary-Unitfälle sind weiterhin die **erwartete** native Liste; hier wurde kein Windows-Testprogramm ausgeführt. Geschützter Beleg: `devstate/windows-pipe-drain/qualification-1e0f2b22-1e74-41af-b8ed-0a356be054ba/qualification.json`. ## Separater Build-/Unitrunner `deploy/windows/system_pipe_acceptance.py` erstellt einen neuen Pack unter `devstate/windows-pipe-drain-build/`. Er prüft den unveränderten lokalen Qualifikationsbeleg samt ursprünglichen Links und verwendet die bereits bestandenen Clippy-/Release-/Unitlinkschritte wieder. Nur die fehlenden beiden Release-Stateprobes werden ergänzt. Alle sechs Auslieferungsdateien erhalten eine unveränderte `.linked`-Kopie; ausschließlich die Unit-Auslieferungskopien werden von Debuginformationen befreit. Neue Quellen einschließlich Runner, Compilerimage, Cargo-/Protoinputs und tatsächlich verwendeter Bootstrapmodule sind vor/nach dem Build gebunden. `--access-root` muss der ursprüngliche Hauptcheckout sein. Nur dort werden die vorhandenen geschützten Zugangskonfigurationen für den bereits gepinnten Bootstraptransport und die tatsächlichen Linux-80-/Windows-58-Corebelege gelesen. Es werden keine Zugangsdaten oder Main-`devstate`-Bäume kopiert oder verlinkt. Neue Build-, Upload- und Unitfallbelege gehören zum isolierten Pipeworktree. Der Native-Unitfall verwendet den neuen Namespace `native-pipe-v2`. **Beide** vollständigen nativen Listen müssen exakt den erwarteten 23 Library- und 7 Binary-Namen entsprechen, bevor irgendein Unitfall ausgeführt wird. Intent, Listen, Start und einzelne Testergebnisse werden create-only gespeichert. Nach einem Antwortverlust darf ausschließlich derselbe Fall gelesen werden; auch ein fehlender oder unvollständiger Fall löst keinen erneuten Start aus. Die Units laufen als Bootstrapadministrator, nicht als Produkt-LocalService, und beweisen keinen tatsächlichen Pipeaustausch. Zentral gespeicherte Gerätezähler und geschlossene Fault-/Policyflags werden vor/nach verglichen. Der bestehende rohe `helper_peer_controls::raw`-Probe schreibt weiterhin einen V1-Header. Sein Ablehnungsresultat ist deshalb **kein** V2-Peernegativnachweis; Runner und Manifest behaupten ausdrücklich keine solche Qualifikation.