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

20 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

Geräteübersicht und Kundenzugriff · abgeschlossen

  1. Bestand und Historie über dieselbe Geräteidentität in WebUI und MCP abfragen. Zwei authentisierte Testgeräte, drei belegte Altinstallationen archiviert, zwei frühere Widerrufe in der Historie.
  2. Die sieben Inventarspalten mit den Linux- und Windows-Gästen abgleichen. CPU-Modell, logische Prozessoren, RAM und Laufwerksgröße stimmen mit den nativen Werten überein. Freien Platz mit dem Inventarzeitpunkt anzeigen.
  3. Kundenverwaltung und Aufnahme je Kunde prüfen. Anlegen und Umbenennen sind in PostgreSQL und im lokalen Browser getestet. Der öffentliche Installer-Endpunkt liefert für Development B signierte Linux- und Windows-Pakete samt passenden Updatern.
  4. Einzel-, Mehrkunden- und globale Tokens auf dem öffentlichen MCP prüfen. Der direkte Fremdzugriff wurde abgewiesen. Alle Abnahmetokens sind widerrufen. Später angelegte Kunden, eingeschränkte Tokenverwaltung und Rechteentzug wurden auf isoliertem PostgreSQL getestet.
  5. API und Gateway mit Schema 31 bereitstellen. Die öffentliche WebUI in Desktop- und Mobilgröße prüfen. Messwerte, Revisionen und Abnahme

Produkt und Betriebsstand

Funktion Im Entwicklungssystem nachgewiesen Nächster Schritt oder Beleg
Server, WebUI und MCP Dedizierter ARM64-Server mit TLS, getrenntem Gerätegateway und öffentlicher Verwaltung mit Passwort/TOTP und scoped MCP-Tokens. 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. KB890830 v5.147 über den festen SYSTEM-Bibliotheksauftrag installiert. Installationsbeleg Zwölf lesende Standardvorlagen und typisierte Neustartplanung für beide Plattformen. PostgreSQL prüfte Anlage, Mandantengrenze, feste Revisionen und die verweigerte SYSTEM-Planung ohne passende Rechte. Je fünf Diagnosen liefen nativ erfolgreich. Linux meldete fehlenden Journalzugriff, Windows verweigerte die Updatesuche als LocalService. Die Vorlage verlangt deshalb SYSTEM und die passende Wartungsrichtlinie. Beide Neustartentwürfe im lokalen Browser geprüft. Auf der öffentlichen WebUI blockiert die Vorprüfung den nächsten Schritt bei beiden Testgästen, weil die passende Neustartfähigkeit fehlt. Katalogmigration
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

WebUI für Skriptaufträge · umgesetzt und abgenommen

  1. Skript veröffentlichen. Die Bibliothek zeigt je Skript Name, Plattform und aktuelle Version. Im Detail lassen sich ältere Versionen lesen und neue veröffentlichen.
  2. Auftrag einreichen. Unter „Aufträge“ Kunde und Geräte wählen oder eine Auswahl aus „Geräte“ übernehmen. Eine feste Bibliotheksversion oder ein einmaliges Skript angeben und die Zusammenfassung einreichen. Inkompatible Geräte sind gekennzeichnet. Der Antrag bleibt nach einer unterbrochenen Übermittlung wiederauffindbar.
  3. Entscheidung treffen. „Genehmigungen“ bündelt offene WebUI- und MCP-Anträge für die Kunden, für die der angemeldete Benutzer entscheiden darf. Den festen Plan mit Zielgeräten, Skript, Ausführungsrechten und Zeitfenster prüfen und genehmigen oder ablehnen. Frühere Entscheidungen stehen im Verlauf.
  4. Ergebnis und Skript nachlesen. „Aufträge“ zeigt die neuesten Anträge zuerst. Das Auftragsdetail zeigt den beim Einreichen gebundenen Skripttext und kennzeichnet unterschiedliche Varianten nach Gerät. Bei einem einzelnen Gerät ist die Ausgabe direkt im Auftrag sichtbar. Bei mehreren Geräten öffnet „Ergebnis anzeigen“ die Ausgabe an der jeweiligen Gerätezeile. Technische Kennungen und Prüfsummen stehen in den Details. Geräteaufnahme und Agent-Releases haben eigene Verwaltungsansichten.
  5. Abnahme. Die Linux-Test-VM lieferte für Version 1 des Bibliotheksskripts trotz bereits verfügbarer Version 2 die Kernelversion, Exitcode 0. Zwei abgelehnte Anträge aus WebUI und MCP erzeugten je null Jobs. Alle drei Entscheidungen liefen über den gekennzeichneten Testprincipal im Entwicklungsprofil. Die öffentlichen Ansichten wurden nach Passwort-/TOTP-Anmeldung in Desktop- und Mobilbreite geprüft. Abnahmeprotokoll

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 für diese WebUI-Lieferung liegt auf codex/webui-review. Aktiv sind API und Gateway 5b6e9c9, WebUI 97ef578 und Datenbankschema 34. Linux betreibt Release 0.1.0-mvp.2, Windows GNU 0.1.6. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum.

WebUI-Review · Ausführungsstopp und Wartung

  1. Den Mandantenstatus unter „Rechte & Ausführungsstopp“ direkt vom Server lesen und nach einer Änderung neu laden. Die Seite zeigt die passende Aktion für den gelesenen Zustand.

  2. Neustarts unter „Neuer Auftrag“ vorbereiten. Der Assistent prüft auf genau ein Ziel, passende Berechtigung und die Gerätefähigkeiten. Der gespeicherte Plan durchläuft die reguläre Einreichung und Genehmigung. Den alten JSON-Planer unter „Verwaltung → Erweitert“ für die übrigen Wartungsfunktionen erreichbar halten.

  3. Entwicklungsabnahmen im Gerätedetail nur im simulierten Testprofil zeigen. Geräteinformationen, Historie und gespeicherte Ergebnisse gehören zur öffentlichen WebUI.

  4. Geräteaufnahme, Agent-Releaseübersicht und MCP-Tokens vereinfachen. Der Paketkatalog zeigt verständliche Leerzustände unter „Erweitert“.

  5. Abnahme. Öffentlich in beiden Kunden den Ausführungsstatus gelesen. Die Neustartprüfung, das historische Gerät und die neuen Verwaltungsansichten wurden im Browser geöffnet. Der gestoppte Zustand und der Übergang vom fehlenden zum gemeldeten Neustartfähigkeit sind mit Testdaten geprüft. Nachweis

  6. Abgenommen am 18. November. Der Server filtert Aufträge vor der Seiteneinteilung. Name oder Anlass, Gerät, Status und Erstellungszeitraum sind kombinierbar. Geräteansichten verlinken auf den festen Job. Genehmigungsverlauf und Detail zeigen die belegte Person und Entscheidungszeit. In der öffentlichen WebUI wurden ein Treffer von einer späteren Seite und vier kombinierte Treffer, ein direkter Ergebnislink und die übereinstimmende Entscheidung nachgelesen. Nachweis

  7. Abgenommen am 18. November. Skriptnamensuche und Plattformfilter arbeiten zusammen über die aktuellen Versionen der Bibliothek. Die Kopfzeile zeigt den aktiven Kunden. Beim Wechsel zwischen Geräten, Aufträgen, Skripten und Genehmigungen blieb Development B sichtbar. Ein Geräte-Detail aus Development A übernahm seinen Kunden in die folgende Auftragsansicht. Nachweis

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