Files
rust-discovery/docs/mvp-completion-plan.md
T

14 KiB

Lieferplan für Skriptverwaltung, Installation und Agentupdates

Abschlussstand 17. November 2026. Echte Windows-Updates und der Wiederanlauf nach frühem Abbruch sind nativ abgenommen. Ziel ist ein Gerät, das sich per HTTPS-Installer anmeldet, im Leerlauf Inventar meldet, einen Bibliotheksauftrag abholt, sein Ergebnis liefert und den nächsten signierten Release selbst übernimmt. Produktvertrag

Ergänzte Lieferungen am 17. November 2026

  • Umlautdarstellung für native PowerShell-Ausgabe korrigiert und am gespeicherten Updateergebnis in der WebUI geprüft. Darstellung
  • Öffentliche WebUI mit Passwort/TOTP sowie MCP mit eigenen widerrufbaren Bearer-Tokens bereitgestellt. 25 öffentliche Prüfungen bestanden, die Testtokens sind widerrufen. Betrieb · Nachweis

Produkt und Betriebsstand

Funktion Im Entwicklungssystem nachgewiesen Nächster Schritt oder Beleg
Server, WebUI und MCP Dedizierter ARM64-Server mit TLS, getrenntem Gateway und privater Verwaltung. Die WebUI genehmigte je eine feste Skriptrevision auf Linux und Windows. MCP und WebUI lieferten dieselbe Ausgabe und dieselbe Versuch-ID. Ergebnisse beider Geräte
Linux- und Windows-Client Auf beiden Gästen HTTPS-Polling mit mehreren echten Kontakten. Ein Leerlaufkontakt übermittelt Inventar und Heartbeats auch bei leerer Auftragsliste. Bereinigung und Geräteabgleich
Skriptbibliothek Versionierte, mandantengebundene Skripte, feste Revision im Plan, WebUI und MCP. Die Windows-Update-Vorlage ist enthalten. KB890830 v5.147 über den festen SYSTEM-Bibliotheksauftrag installiert. Installationsbeleg
Veröffentlichung und Erstaufnahme Auf dem dedizierten Server liegen signierte Linux- und Windows-GNU-Releases. Beide öffentlichen Installer wurden mit einem per WebUI erzeugten Einmalcode auf den Testgästen erfolgreich ausgeführt. Regulärer PowerShell-Auftrag auf dem frisch aufgenommenen Windows-Gerät mit Exitcode 0.
Selbstupdate Linux wechselte auf 0.1.0-mvp.2, der frische Windows-GNU-Client nach seinem Skriptauftrag auf 0.1.3 und anschließend 0.1.4. Prozesshash und Geräteidentität wurden nativ geprüft. Linux · Windows
Entwicklungsbereitstellung Linux-, Windows- und ARM64-Builder nutzen feste Git-Revisionen. SSH-Staging prüft den übertragenen Hash. Der Serverrunner prüft laufende Binärdatei, Migrationen, beide TLS-Healthchecks und die ausgelieferte WebUI. Siehe Entwicklungsbefehle.

Schritt für Schritt

1 · Geräte im Leerlauf und unter Pull betriebsbereit machen — auf den Testgästen nachgewiesen

  1. Der ausdrücklich benannte Windows-Entwicklungsantrag zu Job 7d756c34… wurde mit Plan, Operation, Grant und Outbox gelöscht. Ein zweiter Versuch 5007cbd9… ist zentral korrekt abgelaufen. Der Server hatte dafür keinen Grant ausgegeben. Die veraltete lokale Ergebnisnachricht blockierte das Replay. Beide Projektionen wurden auf dem Gast bereinigt, beide Dienste wieder gestartet.
  2. Gerätesperre, Parallelquoten und Rollout zählen closed_unknown als abgeschlossen. Ein offenes unknown mit Reservierung hält die Sperre. Bei abgelehntem Start behandelt die neue Agentversion nur eine explizit an genau den unreservierten Versuch gebundene Antwort als erneut planbar. Vor einem neuen Abruf durchläuft der Agent den signierten Abgleich. Die Regression einschließlich vertauschter Versuchs-ID und mehrdeutiger Ablehnung wurde im gemeinsamen Agentkern getestet.
  3. Auf Linux wurden 81 veraltete Kontroll-Captures ohne zugehörige Entscheidung entfernt. Danach wurden die 3.961 vorhandenen Snapshots bytegenau in eine Darstellung mit geteilten identischen Versuchsdaten überführt. Die Transaktionen prüften jeweils den vollständigen Rücklesewert. Die Freiliste stieg von 51 auf 113.176 Seiten bei 4 KiB pro Seite, SQLite quick_check ergab ok. Entscheidungsdaten wachsen weiterhin mit der Zahl der Abgleiche.
  4. Nach der Bereinigung meldeten beide Gäste am 17.11. gegen 14:51 UTC wiederholt https, sync_ready=true und helper_sync_ready=true. Die Windows-Uhr war beim nativen Nachtest qualifiziert. Bereits vorhandene Abnahmen für einzelne Skripte stehen unter Linux und Windows.

2 · Ein Bibliotheksskript von der Anlage bis zum Ergebnis liefern — auf beiden Entwicklungsgeräten abgenommen

„Linux-Kernelversion“ und „Windows-PowerShell-Version“ wurden je als v1 geplant, anschließend als v2 geändert und als v1 in der sichtbaren dev/test-WebUI genehmigt. Vor dem Klick gab es je null ausführbare Jobs, danach je einen. Die Testgeräte lieferten Linux 6.8.0-149-generic und PowerShell 5.1.26100.9818 mit Exitcode 0. Die Ausgaben und Versuch-IDs stimmen in WebUI und MCP überein. Fremdmandant über MCP abgewiesen. Die Updatevorlage wurde hierbei nicht ausgeführt. Nativer Beleg

3 · Windows-Updates als Bibliotheksfunktion abbilden — Vorlage und administrative Skriptstrecke geprüft

„Windows-Updates installieren“ ist eine versionierte PowerShell-Vorlage im serverseitigen Katalog. Sie verwendet die Windows Update Agent API, protokolliert die Ergebnisse je Update und meldet den Neustartbedarf. Der feste Plan bindet Skriptinhalt, Ziel, SYSTEM-Rechte und Zeitlimit. Nur für die freigegebene Vorlagenrevision kann die gesonderte Wartungsrichtlinie bis zu 3.600 Sekunden zulassen. Vorlagentext · Laufzeitprüfung

Der Windows-Installer richtet den Agenten als LocalService ein. Der Dev-Operator richtet für die konkrete Geräteidentität und das signierte Agentpaar ein befristetes Wartungsfenster ein. Auf Windows 0.1.4 wurde die feste lesende Identitätsabfrage über die sichtbare dev/test-WebUI genehmigt und als regulärer Pullauftrag genau einmal mit Exitcode 0 und S-1-5-18 ausgeführt. WebUI und MCP zeigen denselben Versuch. Anschließend wurden der zentrale Scope entzogen, der lokale Helper entfernt und die exakt gebundenen abgeschlossenen Arbeitsprojektionen archiviert. Ein neuer Geräteabgleich bestätigte um 16:08 UTC sync_ready=true ohne SYSTEM-Capability, bei laufendem Agent und Updatedienst. Am 17. November installierte der separat genehmigte Auftrag KB890830 v5.147 mit Exitcode 0, WUA-Resultcode 2 und HRESULT 0. Das Windows-Systemprotokoll bestätigt Ereignis 19. Ein bereits vorher erforderlicher Neustart wurde administrativ ausgeführt und anhand der neuen Bootzeit bestätigt. Danach waren WUA- und CBS-Neustartmarker gelöscht. Echte Installation Nachweis für Einrichtung, Ausführung und Rückbau

4 · Signierte Binaries zentral veröffentlichen — im Entwicklungsmandanten nachgewiesen

Jeder Plattformkanal besitzt einen eigenen Ed25519-Schlüssel. Agent und Helper werden mit ihren exakten Hashes vor Veröffentlichung geprüft. Der anfangs erforderliche stabile Updater ist separat an den plattformspezifischen Bootstrap-Hash gebunden. Für Linux und Windows GNU wurden je zwei Versionen über die reguläre Verwaltungs-API veröffentlicht. Veröffentlichungsbefehl

5 · Über öffentliches HTTPS aufnehmen — beide Plattformen nativ aufgenommen

Die Linux- und Windows-Installer sind über die öffentliche Zertifikatskette erreichbar. In der privaten WebUI erzeugte Einmalcodes wurden jeweils beim Enrollment verbraucht. Auf den vorhandenen Testbetriebssystemen entstanden neue Produktidentitäten. Linux läuft als rmm-discovery, Windows als LocalService. Der Notebook-Host ist weiterhin ausschließlich Entwicklungsrechner.

6 · Automatischen Versionswechsel auf dem Gerät prüfen — beide Plattformen nativ nachgewiesen

Das über den Installer neu aufgenommene Linux-Gerät dda2c891… führte die freigegebene Bibliotheksrevision mit Exitcode 0 aus. Der systemd-Timer aktivierte am 17.11. um 15:06 UTC den Release 0.1.0-mvp.2. Der SHA-256 des über /proc geprüften laufenden Agenten und der Helperdatei stimmen mit dem signierten Manifest überein. Enrollmentgeneration und Geräteidentität blieben gleich. Vollständiger Beleg

Windows-A meldete sich mit neuer Identität 1626b5a3…, Version 0.1.0 und gültigem windows.base. Der reguläre Updaterdienst aktivierte um 15:10 UTC Version 0.1.1 mit derselben Identität. Die Manipulationskontrolle wies eine um ein Byte veränderte Helperkopie ab. Das neu aufgenommene Windows-GNU-Gerät 858a27db… mit Prüfer v2 führte unter 0.1.2 die PowerShell-Bibliotheksrevision erfolgreich aus. WebUI und MCP bestätigen denselben Versuch und Exitcode 0. Beim ersten nachfolgenden Abruf lagen die geprüften Dateien bereits auf dem Gast. Eine Windows-Dateisperre verhinderte zunächst das atomare Umschalten. Der stabile Updater wurde über den direkten Entwicklungsweg korrigiert und mit dem wiederverwendbaren Repo-Befehl übernommen. Anschließend aktivierte er um 15:45:22 UTC selbstständig 0.1.3. Der Prozesshash stimmt mit dem signierten D-Paket überein, beide Dienste laufen und die Geräteidentität ist gleich. Der nächste reguläre Abruf aktivierte um 15:50 UTC auch 0.1.4, wiederum mit Hash- und Gerätekontrolle. Nativer Windows-Beleg

7 · Lieferung von einem frischen Checkout nachvollziehen — geprüft und im Lieferbranch gesichert

Aus einem sauberen Klon von 95aa707 wurden drei Buildpläne geprüft und der Rustserver offline mit dem Lockfile gebaut. Releasewerkzeug, SSH-Staging und Deploymentrunner sind im Checkout vorhanden. Fünf Linux-Installerregressionen sowie die Release-, Mandanten-, Token- und Rotationstests gegen einen isolierten TLS-Server und echtes PostgreSQL 17 bestanden. Der Migrationsbenutzer ohne Superuserrechte wendete alle 25 Migrationen an. Der Direktweg für ein bereits gebautes WebUI-Bundle wurde zusätzlich auf dem Entwicklungsserver ausgeführt. Befehle

Abnahme. Ein zweiter Entwickler kann Build, Bereitstellung, Release, Erstaufnahme und Ergebnisabruf den dokumentierten Einstiegspunkten zuordnen. Für beide Geräte gibt es die Kette Installer → Leerlauf → Bibliotheksskript/Ergebnis → automatischer Versionswechsel. Bereits ausreichend belegte Schritte werden referenziert.

Arbeitsverteilung. Der Integrator bündelt die noch fehlenden Zielbelege. Künftige Teilaufträge bekommen jeweils einen konkreten Fehler oder ein gesondert beauftragtes Nutzerergebnis. Sie ändern getrennte Dateien oder stimmen gemeinsame Routen vorher ab. Bei einem Blocker die nächste fehlende Beobachtung hier im betroffenen Schritt eintragen. Abnahmeprotokolle liefern den Beleg, keine weitere Aufgabenliste. Zusätzliche native Provider, Relay/Terminal, RustDesk und Hypervisor-/Backupfunktionen liegen außerhalb dieser Lieferung.

Fortsetzung nach dieser Lieferung

Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbefehlen benutzen. Die Windows-Updatevorlage ist mit einer tatsächlichen Installation und dokumentiertem Neustartbedarf abgenommen. Dafür das dokumentierte Fenster öffnen, die gespeicherte Updatevorlage wählen und den festen Plan in der WebUI genehmigen. Den automatischen Agentversionswechsel und bereits erfolgreiche Bibliotheksaufträge nur bei einem betroffenen Fehler erneut abnehmen.

Der integrierte Quellstand liegt auf codex/mvp-development-release. Die auf dem dedizierten Server aktivierte Revision für API, Gateway und öffentliche API ist 9fa0fb8, Datenbankschema 27. Linux betreibt Release 0.1.0-mvp.2, Windows GNU 0.1.5. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum.

Wiederanlauf nach frühem Abbruch — nativ abgenommen

Der Controller wurde nach registriertem Helperkontakt vor der zentralen Freigabe mit Exitcode 85 beendet. Ein unabhängiger erneuter Aufruf stellte den normalen Geräteabgleich wieder her. Geräteidentität, Archivnachweise und Release blieben gebunden, die Probe erzeugte keine Aufträge. Abnahme vom 17. November

Tatsächliche Updateinstallation — abgenommen

Der ursprüngliche Installationsversuch 6d5f9437… wurde nach kurzzeitigem unknown durch den signierten Abgleich als succeeded, Revision 2 bestätigt. Es gab genau einen nativen Grantverbrauch und Start je Ledger, keinen weiteren Versuch. Das Wartungsfenster wurde anschließend geschlossen. Um 17:05 UTC liefen Agent und ReleasePull mit bereitem Sync, ohne SYSTEM-Fähigkeit und ohne offene Jobs. Die Windows-Zeitsynchronisation wurde aktiviert und ihre zuvor gemessene Abweichung korrigiert. Die WebUI erlaubt nun das feste 3.600-Sekunden-Budget der Originalvorlage auch in der gemeinsamen Planprüfung. Drei Python-Zeitstempelregressionen und 68 WebUI-Tests bestanden. Gesamtbeleg

Windows-Zeitfreigabe nach Gatewaywechsel — nativ abgenommen

Version 0.1.5 verwendet die beim Systemstart protokollierte UTC-Zeit aus Kernel-General-Ereignis 12. Die protokollierte Zeit und der später korrigierte CIM-Wert auf der VM erklären die zwei unterschiedlichen Boot-IDs des ursprünglichen Vorfalls. Der Agent benötigt beim Lesen der Boot-ID einen zugänglichen Startdatensatz im Systemprotokoll. Fehlt er, schlägt die Abfrage fehl.

Der Windows-Updater aktivierte den signierten Release mit Sequenz 6. Beim anschließenden Gatewaywechsel und kontrollierten Zeitsprung meldete derselbe Prozess (PID 4768) die Uhr in Verbindungsgeneration 51 zunächst als unqualifiziert. Nach Rückstellung der Gastzeit und erfolgreicher W32Time-Synchronisation meldete er sich mit neuer signierter Entscheidung und angewendetem Checkpoint 1926 bereit. Die temporäre Netzregel wurde entfernt. Es gab null offene Jobs. Abnahme auf der Windows-Test-VM