From 5c3f5b6a118e49cc1145415aa018e1854204e899 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Tue, 17 Nov 2026 16:33:53 +0100 Subject: [PATCH] Align MVP contributor guidance, native evidence and repeatable development deployment --- AGENTS.md | 70 +-- README.md | 137 +----- Rust_RMM_Implementierungsspezifikation.md | 105 ++--- docs/development.md | 384 ++-------------- docs/evidence/dev-cleanup-pull-20261117.json | 63 +++ ...inux-public-installer-update-20261117.json | 77 ++++ docs/evidence/product-audit-20261117.json | 190 ++++++++ .../script-library-acceptance-20261117.json | 78 ++++ .../windows-https-release-20261117.json | 167 +++++++ docs/handover.md | 193 +-------- docs/implementation-status.md | 13 +- docs/mvp-completion-plan.md | 409 ++---------------- docs/operations-access.md | 14 +- docs/post-mvp.md | 2 + docs/project-decisions.md | 16 +- docs/server-deployment.md | 13 +- tools/dev_deploy_server.py | 13 +- 17 files changed, 781 insertions(+), 1163 deletions(-) create mode 100644 docs/evidence/dev-cleanup-pull-20261117.json create mode 100644 docs/evidence/linux-public-installer-update-20261117.json create mode 100644 docs/evidence/product-audit-20261117.json create mode 100644 docs/evidence/script-library-acceptance-20261117.json create mode 100644 docs/evidence/windows-https-release-20261117.json diff --git a/AGENTS.md b/AGENTS.md index a54ac8f..e7443fc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,58 +1,28 @@ -# Verbindliche Regeln für alle Coding-KIs +# Arbeiten an Rust Discovery -**Aktuelle Übergabe 17. November 2026:** Einstieg [docs/handover.md](docs/handover.md), -konkrete geprüfte Verbindungswege [docs/operations-access.md](docs/operations-access.md). -Codecheckpoint, tatsächlich installierte Artefakte, fremder WIP und alte Chronik -sind dort getrennt. Der neue SYSTEM-Unknown ist keine Erweiterung der alten 221- -Freigabe. Der Dokumentationsauftrag erteilt keine neue Risikoentscheidung. +## Einstieg für jeden Auftrag -**Fokus für den MVP-Abschluss, 2026-11-16:** Aktuelle Bestandsaufnahme und -Agentaufträge stehen in [docs/mvp-completion-plan.md](docs/mvp-completion-plan.md). -Vor Fortsetzung dort das nächste offene Gate und seine Originalbelege prüfen. -Ein Integrator koordiniert Zieländerungen, WebUI-Bedienung und Gitindex; -Unteragents bearbeiten abgegrenzte Aufgaben. Bereits belegte Abnahmen nicht -pauschal wiederholen. Neue Tests nur für notwendige Änderungen, konkrete Fehler -oder betroffene Sicherheitsinvarianten. Dieser Ablauf ändert keine normativen -Produktentscheidungen oder Genehmigungsgrenzen. +1. Lies das [Produktziel, den geprüften Stand und den nächsten Schritt](docs/mvp-completion-plan.md). **Nur dort** steht die aktive Arbeitsreihenfolge. Die [Übergabe](docs/handover.md) nennt den passenden Betriebszugang. Eine datierte Abnahme oder ein alter Reparaturplan ist ein Beleg für seinen damaligen Stand. +2. Benenne das Nutzerergebnis des gewählten Schritts, den schon vorhandenen Beleg und die fehlende Beobachtung. Lies vor Änderungen den betroffenen Code und Vertrag. Bei Produktentscheidungen gilt [Kapitel 0 der Spezifikation](Rust_RMM_Implementierungsspezifikation.md) mit dem jüngsten einschlägigen Nutzerentscheid. [Entscheidungsbuch](docs/project-decisions.md) und [Entwicklungsweg](docs/development.md) liefern den Hintergrund. +3. Ein Integrator koordiniert Zielgeräte, gemeinsam genutzte Dateien, WebUI und Gitindex. Teilaufträge bekommen einen Dateibereich und ein prüfbares Ergebnis. Vorhandenen WIP mit `git status --short` abgrenzen, funktionierende Teilstrecken wiederverwenden und nur aufgabenbezogene Änderungen aufnehmen. +4. Wenn eine frühere Grenze das Ziel behindert, kläre ihren Zweck und wähle die kleinste begründete Änderung. Technische Vereinfachungen dürfen direkt umgesetzt werden. Eine geänderte Produktentscheidung in Kapitel 0 und im Entscheidungsbuch festhalten. Eine unbekannte Wirkung eines früheren Jobs bleibt dabei unbekannt. +5. Nach einem Schritt den Status **in derselben Planzeile** aktualisieren. Quelle, Artefakt, echter Zielkontakt und fachliche Abnahme getrennt belegen. Bei einem Hindernis die konkrete fehlende Beobachtung festhalten und am nächsten unabhängigen Liefergegenstand weiterarbeiten. -**Wiederaufnahme auf Userwunsch 2026-11-13.** Aktuelle Übergabe: -[docs/handover.md](docs/handover.md). Neuer verbindlicher Topologieoverride: -[docs/server-deployment.md](docs/server-deployment.md). Der Entwickler-PC ist -kein RMM-Server mehr; der dedizierte Internetserver übernimmt diese Rolle. -**Korrektur 2026-11-13:** Dieses Notebook ist ausschließlich Entwicklungsrechner. -Hier keinen RMM-Client installieren, enrollen oder als Dienst starten. Aktueller -Client ist die Cloud-Test-VM; der festgelegte Cloudserver bleibt endgültiger Server. +## Was wir liefern -Diese Regeln gelten für alle AIs im gesamten Repository. Vor technischen Entscheidungen die **vollständige** `Rust_RMM_Implementierungsspezifikation.md`, `docs/project-decisions.md` und `docs/development.md` lesen. Normative Produktentscheidungen aus Kapitel 0 der Spezifikation haben Vorrang; Widersprüche offen dokumentieren, nicht stillschweigend abschwächen. +Ein Server mit WebUI und MCP verwaltet Linux- und Windows-Clients. Die Clients melden Heartbeats und Inventar, holen optionale Skriptaufträge ab und geben Ergebnisse zurück. Eine benannte, versionierte Skriptbibliothek bedient beide Oberflächen. Windows-Updates sind ein PowerShell-Katalogeintrag. Ein frischer Client lässt sich über ein HTTPS-Installationsskript aufnehmen und aktualisiert seinen eigenen Agenten periodisch aus dem signierten Releasebestand des Servers. Die Abnahmekriterien stehen im Plan. -## Reihenfolge und reale Nachweise +## Betrieb und Freigabe -- **Linux-first für ALLE Features:** Zuerst auf der tatsächlichen Linux-Test-VM implementieren, ausführen und nachweisen. Lokale Tests, Simulatoren und Cross-Builds ergänzen den VM-Nachweis, ersetzen ihn nicht. -- Erstes Phasenziel ist das **Linux-MVP (M0–M5, x86-64)** mit WebUI, MCP und menschlich autorisierten dauerhaften Jobs. **Useroverride 2026-11-13:** Windows-11-Client darf bereits parallel entwickelt und nativ auf der neuen Windows-Test-VM geprüft werden. Dies ersetzt keine Linux-Abnahme und macht Windows nicht zum Linux-MVP-Blocker. Notebook-Host bleibt ausschließlich Entwicklungsrechner; die Windows-VM ist ein eigener Gast. Proxmox/PBS, Cluster und Backups folgen noch später; kein Hypervisorzugang ist Voraussetzung eines Gastagenten. -- **Useroverride 2026-11-12: RustDesk aus dieser Umsetzung auslassen.** Keine RustDesk-Installation, Profile/Provisionierung oder externe Desktopabnahme; RustDesk ist keine MVP-Pflicht und kein Abnahmeblocker. Bestehende Architekturverträge bleiben ausschließlich für eine spätere optionale Integration erhalten, ohne Ersatz durch eine eigene Desktop-Engine. -- Kein Erfolg ohne realen Nachweis: geplant, implementiert, gebaut, lokal getestet, auf VM getestet und abgenommen getrennt ausweisen. Fehlende Zugänge/Tools/Capabilities und nicht ausgeführte Tests offen nennen. Keine erfundenen Messwerte oder Testergebnisse. +- Der dedizierte Server ist `discovery.ease-technologies.de`. Testclients sind die Cloud-Linux-VM und der Windows-11-Gast. Das Notebook dient ausschließlich der Entwicklung. Plattformspezifische Arbeit auf beiden Gästen darf parallel laufen. Plattformfunktionen jeweils nativ nachweisen. +- Der produktive Geräteverkehr geht vom Client aus. SSH/SFTP ist im Entwicklungsbetrieb ausdrücklich für die direkte Bereitstellung vorhandener Artefakte zulässig. Der [Entwicklungsweg](docs/development.md) beschreibt Build, Transfer und Aktivierung. Zur Produktabnahme von Installer und Selbstupdate den jeweiligen Produktweg benutzen. +- Jeder **Skript- oder Wartungsjob** aus UI, MCP oder Automatik wird zunächst als `pending_approval` gespeichert. Erst eine berechtigte Person genehmigt den unveränderlichen Plan mit Ziel, Skriptbytes, Rechten, Grenzen und festen Versuchen in der WebUI. Vorher bleiben ausführbare Jobs, Outbox, Angebote und Startgrants leer. Policies begrenzen. Direkte API-/DB-Freigaben durch KI oder Automatik sind ausgeschlossen. +- Ausschließlich im expliziten dev/test-Profil darf ein sichtbar **simulierter Testprincipal** die tatsächliche WebUI per Browser bedienen. Audit bindet `approval_origin`, `testsimulation`, Principal und Plan. In Produktion gilt die menschliche Freigabe. Redelivery darf keine zweite Ausführung auslösen. Neue Versuche und Folgejobs brauchen eine eigene feste Freigabe. +- Passive Standardtelemetrie und gespeicherte Lesezugriffe laufen ohne Job. Version 1.33 spezifiziert zusätzlich die automatische Installation **veröffentlichter signierter Agent-Releases**. Der Releasepfad akzeptiert ausschließlich die festgelegten Agentkomponenten. Eine Live-Diagnose oder ein OS-Update ist ein Wartungsjob. +- WebUI und MCP bleiben im Entwicklungsaufbau über den SSH-Tunnel erreichbar. Dockerports an Loopback binden, PostgreSQL intern betreiben. Für die öffentlichen Geräte- und Bootstrapwege TLS-Kette und SAN/SNI prüfen, für registrierte Geräte mTLS und Mandantenbindung durchsetzen. Der öffentliche Installer braucht einen auf dem frischen Gerät bereits vertrauenswürdigen TLS-Anker. +- `credentials/` bleibt ignoriert und privat (0700, Dateien 0600). Die [Zugangsanleitung](docs/operations-access.md) nennt Parser und bestätigte Hostpins. Profile ausschließlich als Daten verarbeiten, kein `source` oder `eval`. Schlüssel, Token und private Diagnoseausgaben gehören weder ins Repository noch in Agentkontexte. +- Bei einem normalen Binärwechsel Identität, PKI, Konfiguration, Journale und Dateirechte erhalten. Im aktuellen Entwicklungssystem dürfen ausdrücklich freigegebene Altanträge und blockierende Testprojektionen gezielt entfernt werden. Nach einer Bereinigung das Fehlen des Auftrags und den frischen Geräteabgleich prüfen. Zielreboots, OS-Updates und destruktive Tests brauchen einen konkreten Auftrag. Vom Status `unknown` führt nur der belegte Abgleich oder der dokumentierte WebUI-Abschluss weiter. Niemals blind wiederholen. -## Unumgehbare Genehmigungsgrenze +## Nachweise und Umfang -- **Jeder Job** aus UI, MCP oder Automatik beginnt als persistenter Antrag `pending_approval`. Ein berechtigter Mensch muss den unveränderlichen Plan mit festen Jobs/Versuchen **in der WebUI** genehmigen. Auch Linux-Dev, Hello World, Live-Diagnose, Retry und Reboot-Folgejobs haben keine Abkürzung. -- **Einzige Bedienungsausnahme für diese Entwicklungsabnahme (Userentscheidung 2026-11-12):** Browserautomatisierung darf ausschließlich im expliziten dev/test-Profil tatsächliche UI-Interaktionen einschließlich Plangenehmigung mit einem deutlich sichtbar als simuliert gekennzeichneten Testprincipal durchführen. Keine Code-Abkürzung: `pending_approval`, Planbindung, interaktive UI-Grenze und Sicherheitsprüfungen bleiben erhalten. Audit muss `approval_origin` und `testsimulation` samt Testprincipal/Planbezug nachvollziehbar kennzeichnen; keine tatsächliche menschliche Identität vortäuschen, kein Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Produktionsverhalten bleibt unverändert. Details: `docs/project-decisions.md` und Spezifikation Kapitel 0.1. -- Vor Genehmigung keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Policies begrenzen/verweigern nur. KI, MCP und Automatik genehmigen niemals; auch kein direkter API-/DB-Aufruf als Ersatz für den Menschen. -- Passive Standardinventarisierung/Heartbeats und Lesen gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Angeforderte Live-Erhebung nicht als passives Inventar tarnen. -- Redelivery ist kein neuer Versuch und darf keine zweite Wirkung auslösen. Neue Versuche und veränderte Pläne brauchen neue menschliche Genehmigung. Unklare Wirkung bleibt `unknown`, nicht blind wiederholen. - -## Entwicklungsweg und Sicherheit - -- **Useroverride 2026-11-13:** Server auf dem dedizierten Internetserver, sämtliche Clients verbinden sich direkt ausgehend dorthin. Keine lokale Serverpflicht und kein PC→VM-Reversetunnel mehr. Details und tatsächlicher Deploymentstand in `docs/server-deployment.md`. -- Dockerports auch auf dem Internetserver ausschließlich an Loopback binden; PostgreSQL ohne veröffentlichten Port. Öffentlichen TLS-Ingress separat und eng begrenzt konfigurieren. Keine öffentlich erreichbare Dev-Anmeldung oder Datenbank; Verwaltungszugang bis zur sicheren öffentlichen Anmeldung ausschließlich über SSH-Tunnel. -- TLS Ende-zu-Ende zum Server, gültige Kette und zum Endpunkt passender SAN/SNI. Ein geprüfter Connect-Override verändert ausschließlich TCP-Ziel/Port. Vertrauenswürdige CA gezielt konfigurieren; niemals ungültige Zertifikate/Namen akzeptieren, kein `curl -k` oder Abschalten der Verifikation. -- SSH ausschließlich Dev-/Bootstraptransport, kein RMM-Sicherheitsersatz: Enrollment, Geräteidentität/mTLS, Tenant-Grenzen, Planbindung und menschliche Genehmigung bleiben erforderlich. -- VM-Zugangsdaten ausschließlich lokal in `credentials/linux-vm.conf`; `credentials/` über `.gitignore` ausschließen, Verzeichnismodus **700**, Dateimodus **600**. Keine Secrets aus Neugier lesen, loggen, committen oder in Jobausgaben/MCP-/LLM-Kontexte kopieren. Daten strikt parsen; **kein `source`, `eval` oder Ausführen von Konfigurationsinhalten**. -- Server-SSH-Daten entsprechend in `credentials/server.conf`; Root ist ausschließlich Bootstrapzugang. Anwendungsdienst unprivilegiert betreiben. Neue SSH-Hostschlüssel vor Anmeldung unabhängig bestätigen. -- Entwicklungs-/Testtools dürfen installiert werden. Daraus folgen **keine impliziten Reboots, Updates oder destruktiven Tests am Ziel**, auch nicht an der Linux-Test-VM. Bootstrap eng begrenzen und abstimmen; RMM-Testjobs bleiben WebUI-genehmigungspflichtig. Sicherheitsprüfungen nicht für eine Demo umgehen. -- Lokale Serverneustarts sind für diese Entwicklungsabnahme ausdrücklich erlaubt; daraus folgen keine impliziten VM-Reboots, Updates oder destruktiven Zieltests und keine Ersetzung der WebUI-Plangenehmigung. - -## Arbeitsweise - -- Bestehende Projektmuster und bekannte Infrastruktur erhalten: Repository `https://gitea.incoso.eu/kevin_janssen/rust-discovery`, RustDesk-Server `rust.ease-technologies.de`. Fehlende RustDesk-Profilwerte als `not_configured` behandeln, keine eigene Desktop-Engine bauen. -- Kleine lauffähige Strecken liefern, Mandantentrennung auf jedem Pfad beachten, betroffene Tests/Fehlerpfade prüfen. Keine Typefehler oder Sicherheitsprüfungen unterdrücken. -- Geplante Start-/Testbefehle ausdrücklich als **geplant, nicht ausgeführt** kennzeichnen. Tatsächlich ausgeführte Prüfungen mit Ergebnis und Grenzen dokumentieren. Dokumentation und Spezifikationsversion bei geänderten Entscheidungen konsistent halten. +Teste die betroffene Funktion und den konkreten Fehlerpfad. Verwende vorhandene native Belege weiter. Kennzeichne geplante, noch nicht ausgeführte Befehle sowie fehlende Zugänge oder Werkzeuge. Historische APT-/MSI-/Rebootabnahmen, Terminal, RustDesk, PVE/PBS, Cluster und Backups sind keine Voraussetzungen für den aktuellen Lieferplan. diff --git a/README.md b/README.md index 17171c7..d4f4141 100644 --- a/README.md +++ b/README.md @@ -1,129 +1,22 @@ -# Rust Discovery / RMM +# Rust Discovery -**Stand: 17. November 2026, Spezifikation 1.30: Der erweiterte MVP ist offen.** -Aktueller Einstieg für eine andere AI auf diesem PC: -[Übergabe](docs/handover.md) und [geprüfte Zugänge](docs/operations-access.md). -S0 und der historienerhaltende Fall 221 sind abgeschlossen. Der neue über MCP -geplante und tatsächlich in der WebUI genehmigte SYSTEM-Auftrag ist in beiden -Originalledgern dauerhaft unknown; S2 bleibt unabgenommen. Quellencheckpoint 0733 -enthält einen compilegeprüften Diagnose-/Kontextpatch, noch keine neue VM-Abnahme. -Server und Cloud-Linux sind per SSH erreichbar; beim laufenden Windows-KVM-Gast -fehlt derzeit der SSH-Reversetunnel. Die neue Risikoausnahme ist nicht genehmigt. +Rust Discovery verwaltet Linux- und Windows-Geräte über einen dedizierten Server mit WebUI und MCP. Die Clients melden sich ausgehend per HTTPS, liefern Inventar und Heartbeats, holen genehmigte Skripte ab und melden ihre Ergebnisse zurück. Wiederkehrende Aufgaben lassen sich als versionierte Skripte hinterlegen. Neue Geräte werden über einen HTTPS-Installer aufgenommen und beziehen signierte Agentupdates vom Server. -Notebookhost ausschließlich Entwicklung. Endgültiger Server: -discovery.ease-technologies.de; WebUI/MCP nur Loopback über SSH. -Linux-M0–M5 ist historisch abgenommen, aktuelle Journalblockade und weitere -Windows-/Updaterabnahmen bleiben getrennte offene Themen. -[Schrittfolge und Agentaufträge](docs/mvp-completion-plan.md). +**[Aktueller Stand und Schritt-für-Schritt-Plan](docs/mvp-completion-plan.md)** · [Entwicklungsbefehle](docs/development.md) · [Übergabe und Zugänge](docs/handover.md) -## Historisch nachgewiesenes Linux-MVP +## Stand am 17. November 2026 -| Bereich | Historischer Nachweis | +Die beiden über den öffentlichen Installer aufgenommenen Geräte haben ein Bibliotheksskript mit Exitcode 0 zurückgemeldet. WebUI und MCP zeigen das Ergebnis desselben Versuchs. Der Linux-Timer und der Windows-Updaterdienst haben auf den Testgästen selbstständig veröffentlichte Versionen übernommen. Die integrierte Windows-Update-Vorlage erfordert gesondert eingerichtete Wartungsrechte. [Aktueller Prüfstand](docs/mvp-completion-plan.md) + +## Einstieg in den Code + +| Aufgabe | Einstieg | | --- | --- | -| M0 | Gepinnter Rust-Workspace, Migrationen/RLS, native ARM64-Serverbuilds und erhaltende Deployments; getrennte API-/Gatewayrollen, PostgreSQL intern und Verwaltungszugang über SSH-Tunnel. | -| M1 | Nativer unprivilegierter Linux-Dienst, Enrollment/mTLS, WSS und HTTPS, passives Inventar/Heartbeats; tatsächlicher Auto-Fallback nach zwei WSS-Abweisungen. TLS-Negativfälle, Rotation und Widerruf nachgewiesen. Generalhelper nach kontrollierter Startverweigerung automatisch wieder angelaufen. | -| M2 | Feste persistente Anträge, tatsächliche WebUI-Genehmigung, Journale/Startgrants; Hello, Live-Inventur und Rootdienstjobs; Doppelzustellung und verlorenes Ergebnis-ACK ohne zweite Wirkung. Aktiver Offline-Wiederkontakt, Ablauf und UI-Genehmigungsentzug bestanden. Agentprozessabbruch mit dauerhaftem lokalem/zentralem Unknown, Abschluss desselben Verbrauchs und unabhängigem Zähler 1 bestanden. | -| M3 | Gespeicherte Geräte-/Jobergebnisse über WebUI, HTTP und MCP; Mandantentrennung; separat genehmigte begrenzte Rootlogs mit Quelle, Zeit und ehrlicher Teilabdeckung. | -| M4, begrenzter Katalog | Echtes Fixture-Update 1.0→1.1 mit unabhängiger Paket-/Nutzdateinachprüfung und nativer Acceptance; danach eigene erfolgreiche `ensure_package`- und `apply_updates`-Noops auf 1.1. | -| M5 | MCP-Endbericht mit sieben bestehenden erfolgreichen Referenzoperationen einschließlich Reboot, festem Linuxziel und tatsächlicher Submit-Idempotenz bestanden. Der einmal genehmigte Reboot ist mit rechtzeitigem Originalbeleg, frischer Verifikation und normalem signiertem Sync desselben Grants abgeschlossen; Rebootrechte wieder geschlossen. | +| Verwaltungs-API, UI und MCP | [Server-Routen](crates/server/src/main.rs), [MCP-Werkzeuge](crates/server/src/mcp.rs), [WebUI](web/src/main.tsx) | +| Gerätekommunikation und Jobs | [HTTPS-Poll](crates/server/src/agent_http.rs), [Jobzustellung](crates/server/src/job_gateway.rs), [gemeinsamer Agentkern](crates/agent-core/src/lib.rs) | +| Linux- und Windows-Dienst | [Linux-Agent](crates/agent/src/main.rs), [Windows-Laufzeit](crates/agent-windows/src/runtime.rs) | +| Releases und Selbstupdate | [Releasekatalog und Downloads](crates/server/src/agent_updates.rs), [Manifestprüfung](crates/updater/src/manifest.rs) | -Die Paketabnahme gilt ausschließlich für die gepinnten Rezepte von -`rmm-mvp-test` auf Ubuntu 24.04 x86-64. Beide Noops belegen -`changed=false`, `already_desired=true` und `transaction_executed=false`; -`apply_updates` ist dabei keine zweite Updateausführung. Der tatsächliche -Host-Neustartbedarf war bei diesen Paketjobs sichtbar `true`; sie stießen -keinen Reboot an. Beliebige Pakete, Repositories sowie OS-/Kernelupdates sind nicht -abgenommen. +Der Server läuft auf `discovery.ease-technologies.de`. Im Entwicklungsaufbau sind Verwaltung und MCP über den [privaten SSH-Tunnel](docs/operations-access.md) erreichbar. Die Cloud-Linux-VM und der Windows-11-Gast dienen als Testgeräte. Das Notebook ist der Entwicklungsrechner. -Frühere APT-Teilwirkungen und der Configureversuch wurden originalgebunden und -über normalen signierten Sync ehrlich als fehlgeschlagene Abnahmen geschlossen. -Eine fehlende historische Host-Vorhermessung wurde nicht erfunden. Auch der erste -Noop mit veralteter Baseline bleibt als wirkungsloser `STATUS_FINGERPRINT`-Fehler -erhalten; der spätere erfolgreiche Noop hatte einen eigenen festen UI-Plan. - -Am ursprünglichen Reboot blockierte zuerst die beim Boot unvertraute Uhr den -Helperstart, später das volle 256-MiB-Journal den Sync. Eine eigene DBkopie -belegte `SQLITE_FULL`; derselbe Insert gelang bei der endlichen 1-GiB-Grenze, -jeweils mit vollständigem Rollback und unverändertem Original. Neue Agent-/ -Helperartefakte sind mit 126 lokalen Tests qualifiziert. Die aktuelle -APT-Laufzeit wurde danach separat an einer Kopie nativ nachqualifiziert; -dies wiederholt keine Paketwirkung oder historische Acceptance. - -Der signierte Rebootabschluss ist nun erfolgreich: 18 geschlossene -Rootverbräuche, alte Ledgerzeilen und Datenbank-Inodes erhalten. Es gab keinen -zweiten Reboot; die ursprüngliche Generalpolicy ist wiederhergestellt. - -Die begrenzte Helper-Startwiederholung (`on-failure`, 5 Sekunden) ist ebenfalls -nativ geprüft: Startfehler bleibt verweigert, nach behobener Ursache erfolgt -der automatische Wiederanlauf unter Erhalt des Zustands, ohne weiteren Reboot. - -APT-Dienst und Agentendpunkt bleiben geschlossen. Der finale MCP-Bericht liest -nur sieben bestehende erfolgreiche Operationen, keine neuen Jobs. - -Der native Endabgleich ist bestanden: **30 Jobs / 30 Outbox / 26 Grants / -0 ungeklärte Wirkungen**, alle **18 Rootverbräuche geschlossen und faultfrei**, -Agent und Helper mit derselben angewandten signierten Entscheidung bereit. -Artefaktpins, erhaltene Historien, Dienstrechte und geschlossene Testgrenzen -sind im geschützten Abschlussbeleg gebunden. Dies gilt für die eine reale -Linux-Cloud-VM und das explizite dev/test-Profil. -[Abschlussaudit](docs/mvp-final-audit.md) und [Abnahmegates](docs/mvp-gates.md) -führen die Nachweise und Grenzen; weitere Arbeiten stehen unter -[Aufgaben nach dem MVP](docs/post-mvp.md). - -## Genehmigung und Entwicklungsgrenzen - -Jeder Ausführungsjob beginnt als persistenter Antrag `pending_approval`. -Vor dem WebUI-Klick existieren keine ausführbaren Jobs, Outboxeinträge oder -Startgrants. Die bisherigen positiven Abnahmen verwenden die ausdrücklich -erlaubte, sichtbar simulierte dev/test-Identität; das ist keine menschliche -Produktionsfreigabe. MCP und Automatik können nicht genehmigen. Passive -Standardinventur und Lesen gespeicherter Ergebnisse benötigen keinen Job. - -Die Windows-11-VM wird auf eigenen Auftrag weiterentwickelt. Der passive -LocalService-Client ist mit Enrollment, mTLS, WSS und explizitem HTTPS, -gespeichertem Inventar, konkreten ACKs und Mandantentrennung nativ geprüft; -sieben native Tests bestanden. Automatischer HTTPS-Fallback nach zwei -gezielten authentisierten WSS-Abweisungen ist ebenfalls nachgewiesen; -Testhooks sind wieder geschlossen und die ursprüngliche WSS-Konfiguration -wurde unverändert wiederhergestellt. Danach wurde die bestehende VM separat -zustandserhaltend auf dauerhaft `transport=auto` umgestellt und nativ geprüft: -WSS bevorzugt, zwei frische Heartbeats und konkretes ACK, gleiche LocalService- -Identität und weiterhin keine Jobs. Dies ist keine neue Installationsabnahme. - -Separate native TLS-Proben als Bootstrapadministrator belegen falsche CA, -falschen Servernamen und ein abgelaufenes Clientzertifikat, mit gültiger -Kontrolle vor und nach den Ablehnungen. Das sind keine LocalService- -TLS-Negativnachweise. Der permanente Dienst und seine Geräteidentität blieben -erhalten; private Schlüssel verließen die VM nicht. - -Allgemeine Windows-PowerShell-Aufträge unter LocalService wurden nativ -abgenommen. Die eigene SYSTEM-Abnahme ist getrennt offen; der neueste Versuch -meldet unknown, kein Erfolg. Letzter installierter Entwicklungsstand 052456f -und neuer compilegeprüfter Quellenstand 0733 sind auseinanderzuhalten. -Keine Wiederholung oder neue Recovery aus alten Anleitungen ableiten. -[Windows-Abnahmen](docs/windows-gates.md), [aktueller Blocker](docs/handover.md) -und [Agent-Selbstupdate](docs/agent-updater-runtime-source.md). - -Weitere Agentplattformen, PVE/PBS/Cluster/Backups und Betriebsreife -folgen außerhalb des Linux-MVP. RustDesk ist ausdrücklich ausgelassen. - -## Projektunterlagen - -- [Verbindliche Spezifikation](Rust_RMM_Implementierungsspezifikation.md), - [AGENTS.md](AGENTS.md), [Projektentscheidungen](docs/project-decisions.md). -- [Tatsächlicher Implementierungsstand](docs/implementation-status.md), - [Plattformmatrix](docs/platform-support.md), [Abschlussaudit](docs/mvp-final-audit.md). -- [Server und aktuelle Topologie](docs/server-deployment.md), - [Entwicklungsregeln](docs/development.md), [Übergabe](docs/handover.md). -- [APT-Nachweise und Hostflagvertrag](docs/apt-ambient-reboot.md), - [Zustellungsabnahme](docs/delivery-acceptance.md), - [Auto-Fallback](docs/transport-acceptance.md), - [Offlinefälle](docs/cloud-offline-acceptance.md), - [Agentabbruch](docs/agent-crash-acceptance.md), - [Reboot](docs/reboot-acceptance.md), [Journalbudget](docs/journal-capacity.md), - [Windows-Client](deploy/windows/CLIENT.md), [Aufgaben nach dem MVP](docs/post-mvp.md). - -Rust und Lockdatei sind auf die vorhandene Toolchain **1.99.1** festgelegt. -Lokale Builds und isolierte Tests ergänzen die nativen Cloudnachweise. -Historische lokale Server-, Notebook-Agent- und Reverse-Tunnelanleitungen sind -keine aktuellen Startanweisungen; maßgeblich bleibt die dokumentierte Cloudtopologie. +[Agenthinweise](AGENTS.md) · [Spezifikation](Rust_RMM_Implementierungsspezifikation.md) · [Entscheidungen](docs/project-decisions.md) · [Historische Linux-Abnahme](docs/mvp-final-audit.md) · [Windows-Nachweise](docs/windows-gates.md) diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index 1e7435f..99f8f35 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -1,6 +1,6 @@ # Rust RMM: Architektur und Implementierungsspezifikation -Version 1.32 · 2026-11-17 · Sprache: Deutsch +Version 1.34 · 2026-11-17 · Sprache: Deutsch **Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam. @@ -79,6 +79,8 @@ Zeitfenster auflockern … nimm das harte Zeitfenster gerne großzügiger an und dokumentiere diese Entscheidung“: signierte Zeitbelege bleiben bis zu fünf Minuten nach Empfang nutzbar (bisher 100 ms). Details Kapitel 0.3. +1.32 → 1.33 (2026-11-17): Aktuelles Lieferziel sind clientseitiger Skriptabruf, benannte Skriptbibliothek, veröffentlichte Agentbinaries, automatischer Versionswechsel und Erstinstallation per HTTPS. Kapitel 0 legt die Abweichung vom früheren manuellen Updatejob und die aktuelle Arbeitsreihenfolge fest. + ## Inhaltsverzeichnis - [0 Auftrag und verbindliche Produktanforderungen](#0-auftrag-und-verbindliche-produktanforderungen) @@ -112,6 +114,26 @@ Minuten nach Empfang nutzbar (bisher 100 ms). Details Kapitel 0.3. ## 0 Auftrag und verbindliche Produktanforderungen +### 0.5 Entwicklungssystem für den MVP (Version 1.34) + +Der Betreiber hat die Löschung des als `closed_unknown` abgeschlossenen Entwicklungsantrags und das Entfernen blockierender Entwicklungsdaten ausdrücklich beauftragt. Für die MVP-Abnahme darf ein Testgerät mit neuer Identität über den Installer aufgenommen werden. Ein bereinigter Testauftrag erzeugt keine Ausführung und keinen neuen Versuch. Bei einem regulären Selbstupdate behält das Gerät seine Identität. Der verbindliche Nachweis steht im [Lieferplan](docs/mvp-completion-plan.md). + +Der dedizierte Produktgateway liefert Jobs ausschließlich in Antworten auf HTTPS-Anfragen des Geräts. Der Windows-GNU-Entwicklungsrelease trägt sein tatsächliches Buildziel `x86_64-pc-windows-gnu` und einen eigenen Signaturschlüssel. Der Windows-MSVC-Kanal ist separat adressiert. + +Für die mitgelieferte PowerShell-Vorlage „Windows-Updates installieren“ darf der feste Plan ein längeres Ausführungsfenster bis 3600 Sekunden auswählen. Es gilt nur für die geprüften Originalbytes und die ausgewählte Bibliotheksrevision. Server- und Gerätescope müssen das längere Fenster ausdrücklich erlauben, und der Agent muss es unterstützen. Der engste der gesetzten Grenzwerte gilt. Das Ergebnis meldet den von Windows festgestellten Neustartbedarf. Ein Neustart ist ein eigener Wartungsauftrag. + +### 0.4 Aktuelles Lieferziel für Server und Geräte (Version 1.33) + +Der Auftrag vom 17. November setzt für die nächste Lieferung folgende Prioritäten. Diese Fassung hat für ihren Umfang Vorrang vor den älteren Phasenplänen und dem manuellen Updatevertrag aus 1.21. [Stand, Reihenfolge und Abnahme](docs/mvp-completion-plan.md) + +1. Ein Server stellt WebUI und MCP bereit. Windows- und Linux-Clients melden auch bei leerer Warteschlange ausgehend Heartbeats und Inventar. Die Clients fragen nach Arbeit und senden Annahme, Status und Ergebnis über denselben logischen Gerätekanal zurück. Das Produktprofil nutzt den vorhandenen HTTPS-Poll. Ein Auftrag darf ausschließlich als Antwort auf eine Clientanfrage zugestellt werden. Der bestehende timergetriebene WSS-Angebotspfad gehört zur bisherigen Betriebsart. Für bestehende Geräte den Wechsel erhaltend vornehmen. +2. Der Server verwaltet benannte, versionierte Shell- und PowerShell-Skripte pro Mandant. Die WebUI und MCP verwenden dieselben Vorlagen und Planungsregeln. Eine Bibliotheksrevision kann zahlreichen Aufträgen zugrunde liegen. Jeder Wartungsauftrag bindet Ziel, Skriptrevision und genaue Bytes vor der WebUI-Genehmigung. „Windows-Updates installieren“ ist ein PowerShell-Skript mit ausgewiesenen Rechten, Ergebnissen und Neustartbedarf. +3. Für Linux und Windows bietet der Server stets den aktuellen **vollständigen veröffentlichten** Agent-Release für Plattform und Architektur an. Der Client prüft beim Start und regelmäßig die Version. Eine neuere passende signierte Version aktiviert er selbstständig, auch wenn kein Auftrag vorliegt. Der veröffentlichende Berechtigte legt die unveränderliche Version und ihre Artefakte fest. **Das Veröffentlichen autorisiert die automatische Aktualisierung der vorgesehenen Agentkomponenten ohne eigenen Job oder WebUI-Klick je Gerät.** Wiederverwendbar sind Releaseprüfung, Versionsuntergrenze, Gerätebindung, lokale Übergabe, Healthbeleg und begrenzter Fehlerrückweg. Den Zugriff auf Releaseartefakte für diesen Ablauf eigenständig autorisieren. Skripte, OS-Updates und Reboots gehören zur genehmigten Jobstrecke. Bereits ausgestellte manuelle Updatepläne behalten ihre ursprüngliche Bindung. +4. Für jede Plattform gibt es ein dauerhaft per verifiziertem HTTPS abrufbares Installationsskript. Ein berechtigter Installationsaufruf mit mandantengebundenem Einmalnachweis richtet Agent und Updater ein. Der neue Client erzeugt seinen Geräteschlüssel lokal und meldet sich selbst an. Der anfängliche Bezug von Installer, Vertrauensmaterial und signiertem Startrelease muss schon vor Ausstellung des Gerätezertifikats funktionieren. Öffentliche Skripte und URLs enthalten keine wiederverwendbaren Zugangsdaten. +5. Entwicklung verwendet wiederholbare Zielbuilds und darf vorhandene Dateien per geprüftem SSH direkt bereitstellen. Der Entwicklungsrechner betreibt keinen RMM-Dienst. Ein Entwicklungsdeploy und ein automatischer Versionswechsel besitzen getrennte Nachweise. Für den aktuellen Auftrag zählen die plattformspezifischen Nutzerabläufe und ihre nötigen Voraussetzungen. Alte Einzelreparaturen, zusätzliche Provider und spätere Integrationen ergeben keine Reihenfolge für diese Lieferung. + +Diese Festlegungen beschreiben den Sollzustand. Alle übrigen Wartungsjobs benötigen weiterhin den unveränderlichen Antrag und die interaktive Freigabe. Für Prüfungen im dev/test-Profil gilt die in 0.1 dokumentierte sichtbare Simulation. + **Userentscheidung Version 1.26, Windows-MVP vollständig fortsetzen.** Der Betreiber beauftragt nach dem ersten festen PowerShell-Test ausdrücklich auch die verbleibenden Windows-MVP-Arbeiten, möglichst parallel. Die @@ -418,15 +440,15 @@ werden. MCP, KI, Automatik, API-Token und direkte DB-Aufrufe können das nicht. ### 0.1 Auftrag an die implementierende KI -**Userentscheidung Version1.21 — signiertes Agent-Selbstupdate parallel:** +**Bisheriger manueller Vertrag (Version 1.21).** Der folgende Abschnitt beschreibt die jobgebundene Aktivierung. Für den zusätzlich geforderten automatischen Betrieb gelten Kapitel 0.4 und dessen eigene Abruf- und Aktivierungsregeln. + APT-/MSI-Paketfixtures sind kein Agent-Autoupdater. Der User zieht diesen engen Teil ausM7 parallel vor; Restore, HA, Relay und weitere Betriebsreife werden -hierdurch nicht zusätzlich beauftragt. Jeder Aktivierungsversuch ist die neue +hierdurch nicht zusätzlich beauftragt. Im manuellen Pfad erfolgt die Aktivierung als typisierte Aktion `update_agent` mit `fixed_code_pair_v1`, persistentem `pending_approval` und tatsächlicher WebUI-Genehmigung gemäß0.1. Ersteller und Freigeber brauchen aktuell `updates:apply` sowie getrennt `root:execute` oder -`system:execute`. Es gibt keine automatische Freigabe, zukünftiges `latest`, -Wildcardziele oder periodische Selbstaktivierung. Der Plan bindet exakten +`system:execute`. Eine manuelle Jobgenehmigung bindet ausschließlich die konkrete Version. Der Plan bindet exakten release-signierten Manifestenvelope, Plattform, Vorgängerrecord/Codepaar, Updater-/Policy-/Keyringhashes und Generation, getrennten Healthpublickey samt Originalhash seines geschützten lokalen öffentlichen Pins, beide Artefakte, Pintransition, @@ -867,17 +889,17 @@ Gast mit ausgehender Verbindung zum endgültigen Cloudserver. Bootstrapzugang über abgesicherten Reverse-SSH-Tunnel ist erlaubt; TLS/mTLS, Mandantengrenzen und die WebUI-Genehmigung jedes RMM-Jobs bleiben unverändert verbindlich. -Implementiere das in dieser Datei beschriebene System schrittweise. Beginne mit dem ersten vertikalen Abschnitt in Kapitel 25 und liefere lauffähige, überprüfbare Ergebnisse. Erzeuge nicht lediglich ein breites Gerüst mit leeren Methoden. Nutze die Startentscheidungen aus Kapitel 18, wenn konkrete Betriebsdaten noch fehlen. Halte tatsächlichen Implementierungsstand, offene Punkte und durchgeführte Prüfungen im Repository fest. +Implementiere das in dieser Datei beschriebene System schrittweise. Wähle den nächsten offenen Schritt aus dem aktuellen Lieferplan in Kapitel 0.4 und liefere ein lauffähiges, überprüfbares Ergebnis. Erzeuge nicht lediglich ein breites Gerüst mit leeren Methoden. Nutze die Startentscheidungen aus Kapitel 18, wenn konkrete Betriebsdaten noch fehlen. Halte tatsächlichen Implementierungsstand, offene Punkte und durchgeführte Prüfungen im Repository fest. -Die Begriffe **MUSS**, **DARF NICHT** und **Abnahme** bezeichnen verbindliche Anforderungen. **Default** bezeichnet einen konfigurierbaren Startwert. **Optional** gehört nicht zum ersten Produktumfang. Die ausdrücklichen Entscheidungen der Version 1.5 in diesem Abschnitt haben bei Widersprüchen Vorrang vor früheren Architekturannahmen und Beispielen; sonst konkretisieren Kapitel 18 bis 26 die Architektur. Verbleibende Widersprüche werden dokumentiert und fachlich geklärt. +Die Begriffe **MUSS**, **DARF NICHT** und **Abnahme** bezeichnen verbindliche Anforderungen. **Default** bezeichnet einen konfigurierbaren Startwert. **Optional** gehört nicht zum ersten Produktumfang. Der jeweils jüngste einschlägige Nutzerentscheid in Kapitel 0 hat Vorrang vor früheren Architekturannahmen und Beispielen; sonst konkretisieren Kapitel 18 bis 26 die Architektur. Verbleibende Widersprüche werden dokumentiert und fachlich geklärt. **Neuer verbindlicher Useroverride 2026-11-12 – Umfang ohne RustDesk:** „rustdesk musst du nicht machen ... das lasse aus“. Keine RustDesk-Installation, Profile/Provisionierung, RustDesk-spezifischen Schnittstellen oder externe Desktopabnahme in dieser Umsetzung. M4 bleibt allgemeine Linux-Paketverwaltung; M5 umfasst nur Referenzabläufe 0.3 Nr. 1–3. REQ-11, Referenzablauf Nr. 4, `ensure_rustdesk`, `rustdesk_profiles`, Kapitel 24.2 und AT-17/AT-18 sind ausschließlich spätere optionale Integrationsverträge, keine MVP-Pflicht oder Abnahmeblocker. Sämtliche verbliebenen RustDesk-Architekturtexte einschließlich Windows-Beispielen und Startauftrag sind in diesem Sinne historisch/optional zu lesen, nicht als Implementierungsauftrag. Keine eigene Desktop-Engine als Ersatz; Linux-first und die übrigen Sicherheits-/Abnahmegates bleiben bestehen. **Einzige Bedienungsausnahme für diese Entwicklungsabnahme:** Der User hat ausdrücklich angeordnet: „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“. Ausschließlich im **expliziten dev/test-Profil** darf Browserautomatisierung tatsächliche WebUI-Interaktionen einschließlich Genehmigung des unveränderlichen Plans mit einem deutlich sichtbar als **simulierter Testprincipal** gekennzeichneten Principal durchführen. Diese Ausnahme präzisiert alle nachfolgenden Aussagen zu tatsächlicher menschlicher Bedienung bei Entwicklungstests (insbesondere REQ-10, Kapitel 22/23/25/26 und AT-30); sie schafft keine Code-Abkürzung und keine Produktionsausnahme. `pending_approval`, Planbindung, Rechte-, Tenant-/Policyprüfungen und interaktive UI-Grenze bleiben unverändert; vor UI-Genehmigung keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Audit MUSS `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr samt Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar kennzeichnen. Keine tatsächliche menschliche Identität vortäuschen, Simulation getrennt nachweisen, kein Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft; normale UI-Browserrequests bleiben an deren interaktiven Kontext gebunden. Simulation außerhalb dev/test verweigern; Produktionsverhalten bleibt unverändert. Lokale Serverneustarts sind erlaubt, keine impliziten VM-Reboots, Updates oder destruktiven Zieltests; Zieltestumfang weiterhin gesondert ausdrücklich abstimmen. Diese Regeln dokumentieren Erlaubnis und Anforderungen, keine bereits implementierte oder ausgeführte Simulation. Details/Nachweisvorlage: `docs/project-decisions.md`, `docs/development.md`. -**Normative Entscheidungen vom 2026-11-12:** Linux-first gilt für ALLE Features: zuerst auf der tatsächlichen Linux-Test-VM implementieren, ausführen und nachweisen. Erstes Phasenziel ist das Linux-MVP x86-64 mit WebUI, MCP und autorisierten dauerhaften Jobs (M0–M5). Windows-x86-64-Implementierung und native Abnahmen beginnen erst nach dokumentierter Linux-MVP-Abnahme; PVE-Modul/-Client, Cluster und Backups folgen noch später nach der Windows-Phase. ARM64 und Betriebsreife bleiben nachgelagerte Ausbaustufen. Windows-/Linux-Agenten sind als Produktziel auf physischen Geräten und beliebigen VMs eigenständig verwaltbar, ohne PVE-Agent, Hypervisorzugang oder bekannten Host. Proxmox verwendet später denselben Linux-Agenten mit Zusatzmodul. Keine vorgezogene PVE-Implementierung oder PVE-Testpflicht im Linux-MVP. Build, Simulator oder lokaler PC-/Containerlauf ersetzen keinen realen VM-Nachweis. +**Historische Phasenentscheidung vom 2026-11-12, in 1.33 abgelöst:** Linux-first galt für alle Features: zuerst auf der tatsächlichen Linux-Test-VM implementieren, ausführen und nachweisen. Erstes Phasenziel ist das Linux-MVP x86-64 mit WebUI, MCP und autorisierten dauerhaften Jobs (M0–M5). Windows-x86-64-Implementierung und native Abnahmen beginnen erst nach dokumentierter Linux-MVP-Abnahme; PVE-Modul/-Client, Cluster und Backups folgen noch später nach der Windows-Phase. ARM64 und Betriebsreife bleiben nachgelagerte Ausbaustufen. Windows-/Linux-Agenten sind als Produktziel auf physischen Geräten und beliebigen VMs eigenständig verwaltbar, ohne PVE-Agent, Hypervisorzugang oder bekannten Host. Proxmox verwendet später denselben Linux-Agenten mit Zusatzmodul. Keine vorgezogene PVE-Implementierung oder PVE-Testpflicht im Linux-MVP. Build, Simulator oder lokaler PC-/Containerlauf ersetzen keinen realen VM-Nachweis. -**Verbindlicher Entwicklungsweg:** Server lokal in Docker auf dem PC, sämtliche veröffentlichten Dockerports ausschließlich Loopback. PC initiiert SSH zur VM mit `-N -T`, `ExitOnForwardFailure=yes`, Keepalive und `-R 127.0.0.1:18443:127.0.0.1:18443`. VM-Agent verbindet sich ausgehend über dortigen Loopback. TLS bleibt Ende-zu-Ende mit DNS SAN `rmm-dev.internal`, explizitem VM-Hosts-Eintrag oder geprüftem Client-Connect-Override unter Erhalt der Namensprüfung; niemals ungültige Zertifikate akzeptieren. SSH nur Dev/bootstrap, kein RMM-Sicherheitsersatz. VM-Daten in `credentials/linux-vm.conf`, `.gitignore`-Ausschluss, Modi 700/600; keine Secrets loggen/committen, kein `source`/`eval`. Toolinstallation ist erlaubt, aber keine impliziten Reboots, Updates oder destruktiven Zieltests. Details und ausschließlich geplante, nicht als getestet behauptete Befehle: `docs/development.md`. Verbindliche AI-Regeln: `AGENTS.md`. Kein Erfolg ohne tatsächlichen Nachweis. +**Historischer Entwicklungsweg vor dem Serverumzug, abgelöst durch Kapitel 0.4 und die Cloudtopologie:** Server lokal in Docker auf dem PC, sämtliche veröffentlichten Dockerports ausschließlich Loopback. PC initiiert SSH zur VM mit `-N -T`, `ExitOnForwardFailure=yes`, Keepalive und `-R 127.0.0.1:18443:127.0.0.1:18443`. VM-Agent verbindet sich ausgehend über dortigen Loopback. TLS bleibt Ende-zu-Ende mit DNS SAN `rmm-dev.internal`, explizitem VM-Hosts-Eintrag oder geprüftem Client-Connect-Override unter Erhalt der Namensprüfung; niemals ungültige Zertifikate akzeptieren. SSH nur Dev/bootstrap, kein RMM-Sicherheitsersatz. VM-Daten in `credentials/linux-vm.conf`, `.gitignore`-Ausschluss, Modi 700/600; keine Secrets loggen/committen, kein `source`/`eval`. Toolinstallation ist erlaubt, aber keine impliziten Reboots, Updates oder destruktiven Zieltests. Details und ausschließlich geplante, nicht als getestet behauptete Befehle: `docs/development.md`. Verbindliche AI-Regeln: `AGENTS.md`. Kein Erfolg ohne tatsächlichen Nachweis. **Unbedingte Freigabegrenze:** JEDER zur Ausführung eingestellte Job aus UI, MCP oder Automatik benötigt vorher die explizite Genehmigung eines berechtigten Menschen in der WebUI. Dies gilt auch für Diagnosejobs, Hello World, Reboot-Folgejobs und neue Versuche. Eine Genehmigung bindet einen unveränderlichen Plan und feste Einzeljobs/Versuche; ein transparent angezeigtes Sammelpaket ist zulässig, Dauer- und Wildcardfreigaben nicht. Policies dürfen nur begrenzen oder verweigern, niemals Genehmigungen ersetzen. MCP darf planen und einen persistenten Antrag mit `pending_approval` einstellen, aber weder genehmigen noch vor Genehmigung Ausführungsjobs einreihen, `JobOffer` zustellen oder Startgrants erhalten. Passive Telemetrie/Heartbeats und das Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Diese Ausnahme darf keine angeforderten Diagnose- oder Ausführungsjobs als Telemetrie tarnen. @@ -887,17 +909,17 @@ Die Begriffe **MUSS**, **DARF NICHT** und **Abnahme** bezeichnen verbindliche An | --- | --- | | REQ-01 | Ein zentrales Backend in Rust verwaltet mehrere voneinander getrennte Kunden. | | REQ-02 | Ein gemeinsamer Rust-Agentkern unterstützt Windows und Linux eigenständig auf physischen Geräten und beliebigen VMs; Host/Hypervisor darf unbekannt sein. Kein PVE-Agent oder Hypervisorzugang ist nötig. Proxmox verwendet nach dem MVP denselben Linux-Agenten mit zusätzlichem Modul. | -| REQ-03 | Erstes Phasenziel Linux-MVP x86-64/AMD64; Windows x86-64 erst nach dessen Abnahme, ARM64 später. Alle Features zuerst auf tatsächlicher Linux-Test-VM nachweisen. Support gilt je getesteter Betriebssystem-/Architekturkombination; 32-Bit-Ziele sind zusätzliche, noch nicht zugesagte Erweiterungen. | +| REQ-03 | Historische erste Phase Linux-MVP x86-64/AMD64; aktuelle Lieferung gemäß 0.4 für Windows und Linux x86-64, ARM64-Clients später. Gemeinsame Funktionen und plattformspezifische Wirkung auf den betreffenden Gästen nachweisen. Support gilt je getesteter Betriebssystem-/Architekturkombination; 32-Bit-Ziele sind zusätzliche, noch nicht zugesagte Erweiterungen. | | REQ-04 | Alle RMM-Netzwerkverbindungen zu Kundengeräten werden vom Agenten ausgehend aufgebaut. Die Zentrale öffnet keine eingehenden Verbindungen zu den Geräten. | | REQ-05 | Inventar, Erreichbarkeit, Messwerte, erwartete Dienste, Software, Updates und begrenzte Logs sind je Kunde abrufbar; Proxmox-/Backupinformationen folgen nach dem MVP. | | REQ-06 | Jeder Status zeigt Datenquelle und Erhebungszeit. Nicht erreichbare Geräte zeigen den letzten bekannten Stand; die Plattform behauptet keinen aktuellen Messwert ohne neue Erhebung. | | REQ-07 | Eine Weboberfläche stellt Kunden, Geräte, Probleme und Aufträge dar. Diese Verwaltungsoberfläche bleibt Bestandteil; sie ist von grafischer Desktopfernsteuerung zu unterscheiden. | | REQ-08 | Ein MCP-fähiger LLM-Client kann gespeicherte Gerätedaten abfragen, Skripte und Installationen vorbereiten und Sammelaufträge zur menschlichen WebUI-Genehmigung beantragen, etwa ausgewählte Server eines Kunden neu starten. | -| REQ-09 | Alle Änderungen durch Menschen, KI oder automatische Regeln verwenden dieselben Pläne, Berechtigungsprüfungen, Jobs und Ergebnisnachweise. | +| REQ-09 | Wartungsjobs durch Menschen, KI oder automatische Regeln verwenden dieselben Pläne, Berechtigungsprüfungen, Jobs und Ergebnisnachweise. Für den Lebenszyklus des Agenten gelten die Veröffentlichungs- und Aktivierungsregeln in 0.4. | | REQ-10 | Jeder Ausführungsjob benötigt explizite menschliche WebUI-Genehmigung für seinen unveränderlichen Plan und festen Versuch, einzeln oder als transparentes Sammelpaket. Policies begrenzen/verweigern nur; KI und Automatik dürfen niemals genehmigen. | | REQ-11 | Spätere optionale Integration, ausdrücklich nicht Teil dieser Umsetzung/MVP-Abnahme: RustDesk auf ausgewählten Geräten mit versionierter Konfiguration installieren und prüfen; separater RustDesk-Bildschirmzugriff. | | REQ-12 | Eine eigene Desktop-Engine, Bildschirmübertragung oder Maussteuerung wird nicht entwickelt. RustDesk hat einen separaten, passend konfigurierten Verbindungsweg. | -| REQ-13 | Administrative Shell-/PowerShell-Sitzungen bleiben vorgesehen und verwenden vom Agenten eröffnete Kanäle. | +| REQ-13 | Der Lieferumfang 1.33 führt Shell-/PowerShell-Skripte als abholbare Batchaufträge aus. Interaktive Sitzungen sind eine spätere Option. | | REQ-14 | Offlinegeräte erhalten gültige Aufträge nach Wiederverbindung. Ein ausgeschaltetes Gerät kann über seinen Agenten keine Aktion ausführen. | | REQ-15 | Die Zuordnung verkaufter Geschäftsleistungen ist eine optionale spätere Erweiterung. Sie blockiert Inventar, Monitoring und Verwaltung nicht. | @@ -912,7 +934,7 @@ Die Begriffe **MUSS**, **DARF NICHT** und **Abnahme** bezeichnen verbindliche An Empfohlen wird eine mandantenfähige Plattform mit einem zentralen Rust-Backend und einem gemeinsamen Rust-Agenten, der je nach Betriebssystem und Rolle unterschiedliche Module aktiviert. Windows und Linux verwenden denselben Protokoll-, Sicherheits- und Auftragskern. Jede verwaltete VM verwendet einen eigenen, vollständig eigenständigen Windows- oder Linux-Agenten; sie muss nicht auf Proxmox laufen. Ein bekannter oder verwalteter Host ist keine Voraussetzung. Physische Maschinen verwenden dieselben Pakete. Erst nach dem MVP kann derselbe Linux-Agent auf Proxmox VE eine zusätzliche Proxmox-Funktion aktivieren. -Alle Verbindungen zwischen verwalteten Geräten und der Zentrale werden vom Gerät ausgehend aufgebaut. Aufträge, Ergebnisse und interaktive Sitzungen nutzen diese Verbindungen oder zusätzliche, ebenfalls vom Agenten initiierte Kanäle. Ein eingehender SSH-, WinRM- oder RMM-Port am Kundengerät ist dafür nicht erforderlich. +Alle Verbindungen zwischen verwalteten Geräten und der Zentrale werden vom Gerät ausgehend aufgebaut. Für die Lieferung 1.33 laufen Aufträge und Ergebnisse über den ausgehenden Gerätekanal gemäß 0.4. Zusätzliche Kanäle für interaktive Sitzungen gehören zu einer späteren Ausbaustufe. Ein eingehender SSH-, WinRM- oder RMM-Port am Kundengerät ist dafür nicht erforderlich. Rust ist für Backend und Agenten eine sinnvolle Wahl, wenn im Entwicklungsteam Rust-Erfahrung vorhanden ist oder aufgebaut werden soll. Der Entwurf verbindet einen gemeinsamen technischen Kern mit den notwendigen plattformspezifischen Implementierungen. Die Weboberfläche wird in TypeScript umgesetzt. MCP bietet kontrollierte Lese- und Planungsfunktionen, aber keine Genehmigung. Die Plattform erzwingt Rechte, begrenzende Regeln und menschliche WebUI-Genehmigung vor jeder Jobausführung. @@ -1806,6 +1828,8 @@ Für die erste Abnahme genügt eine ausdrücklich konfigurierte maximale Backupa ## 25 Implementierungsreihenfolge und Abnahmekriterien +Die M0–M8-Tabelle beschreibt die ursprüngliche Roadmap. Für den Lieferumfang 1.33 gilt die [aktuelle Schrittfolge](docs/mvp-completion-plan.md). Die nachstehenden Abnahmen dienen als Referenz für tatsächlich betroffene Verträge. + ### 25.1 Arbeitspakete Jedes Arbeitspaket wird als vollständige, lauffähige Erweiterung abgeschlossen. Sicherheits- und Autorisierungsgrundlagen werden vor dem ersten schreibenden Pfad umgesetzt. Ein späteres UI oder MCP darf keine neue Ausführungsabkürzung schaffen. @@ -1890,60 +1914,7 @@ Die Coding-KI implementiert und testet in dafür vorgesehenen Entwicklungsumgebu ## 26 Direkt verwendbarer Startauftrag für eine Coding-KI -Der folgende Text kann zusammen mit dieser Markdown-Datei an eine implementierende KI gegeben werden: - -```text -Implementiere die in Rust_RMM_Implementierungsspezifikation.md beschriebene -Plattform. Lies die gesamte Spezifikation, bevor du technische Entscheidungen -triffst. Behandle die Anforderungen REQ-01 bis REQ-15 und die normativen -Verträge als verbindlich. - -Prüfe zuerst das vorhandene Repository und seine lokalen Anweisungen. Falls -noch kein Projekt existiert, lege den Cargo-Workspace und die lokale -Entwicklungsumgebung gemäß Kapitel 19 an. Verwende die Startentscheidungen -aus Kapitel 18 und dokumentiere verbleibende Betriebsparameter als -Konfiguration. Erfinde keine Kundenzugangsdaten oder erfolgreichen Tests. - -Beginne mit M0, M1 und M2 als erster vertikaler Strecke: zwei Testmandanten, -ein Linux-Agent auf tatsächlicher Linux-Test-VM, ausgehende TLS-Verbindung, Inventar und -ein erst nach expliziter menschlicher WebUI-Genehmigung ausgeführter -Hello-World-Job mit lokalem Journal und überprüftem Ergebnis. operations.submit -speichert nur pending_approval; keine Ausführungsqueue vor Genehmigung. -Policies begrenzen/verweigern nur; MCP darf niemals genehmigen. Diagnosejobs, -Reboot-Folgejobs und neue Versuche benötigen ebenfalls menschliche Genehmigung. -Gastagenten funktionieren ohne bekannten Host und ohne Hypervisorzugang. -Alle Features zuerst real auf Linux-Test-VM nachweisen. Erstes Phasenziel: -Linux-MVP M0–M5 x86-64. Windows beginnt erst nach dessen dokumentierter Abnahme; -ARM64, PVE/Cluster/Backups und Betriebsreife folgen noch später. Kein vorgezogenes PVE. -Lies AGENTS.md und docs/development.md: Server lokal in Docker auf dem PC, -Ports nur Loopback, PC initiiert SSH-Reverse-Forward zur VM, TLS E2E mit -DNS SAN rmm-dev.internal und expliziter VM-Auflösung, keine ungültigen Certs. -SSH nur Dev/bootstrap, kein RMM-Sicherheitsersatz. Auch Linux-Dev-Jobs bleiben -pending_approval bis tatsächlicher menschlicher WebUI-Genehmigung. -VM-Daten credentials/linux-vm.conf, gitignore, Modi 700/600, keine Secrets -loggen/committen, kein source/eval. Keine impliziten Ziel-Reboots, Updates -oder destruktiven Tests. Geplante Commands als geplant markieren, -keinen Erfolg ohne realen Nachweis behaupten. -Installiere erforderliche Entwicklungstools; dies genehmigt keine Änderungen -auf Kundensystemen. Implementiere die weiteren Arbeitspakete in -der Reihenfolge von Kapitel 25. Nutze gemeinsame Fachservices für HTTP, MCP -und automatische Regeln. - -Erzeuge konkrete Änderungen, führe sie soweit die vorhandene Umgebung es -ermöglicht aus und prüfe die relevanten Abnahmekriterien. Dokumentiere -fehlende native Testmöglichkeiten und fahre mit unabhängigen Aufgaben fort. -Berichte pro abgeschlossener Strecke: implementierte Funktionen, genaue -Start-/Testbefehle, tatsächliche Testergebnisse und nächste Arbeitspakete. -Halte docs/implementation-status.md aktuell, damit die Arbeit fortgesetzt -werden kann. - -Baue keine eigene grafische Fernsteuerung. Lasse RustDesk in dieser Umsetzung -aus: keine Installation, Profile/Provisionierung oder externe Desktopabnahme. -Die verbliebenen RustDesk-Verträge sind ausschließlich später optional. -Erhalte die Vorgabe ausschließlich vom Agenten initiierter Verbindungen. -Gib unklare Ausführungsergebnisse als unknown aus und führe sie nicht blind -erneut aus. Behalte die Mandantentrennung auf jedem Zugriffspfad bei. -``` +Beginne mit [AGENTS.md](AGENTS.md) und dem [aktuellen Lieferplan](docs/mvp-completion-plan.md). Übernimm den nächsten offenen Schritt samt Abnahmekriterium. Prüfe den letzten Originalbeleg und den betreffenden Code. Bei einem Geräteproblem unterscheiden sich Git-Stand, gebautes Artefakt, installierter Prozess und zuletzt gemeldete Serversicht. Der [Entwicklungsweg](docs/development.md) nennt die Standardbefehle für zielbezogene Builds und den direkten SSH-Transfer. Halte das Ergebnis im vorhandenen Plan fest. ## Quellen und Referenzen diff --git a/docs/development.md b/docs/development.md index 1f446f9..84845bd 100644 --- a/docs/development.md +++ b/docs/development.md @@ -1,370 +1,78 @@ -# Linux-first-Entwicklung und reale VM-Abnahme +# Bauen und Bereitstellen in der Entwicklungsumgebung -**Übernahme 17. November 2026:** Zuerst [aktueller Stand](handover.md) und -[konkrete Zugänge auf diesem PC](operations-access.md). Historische Warte-/Stop- -und lokale Serverbeschreibungen unten sind keine heutigen Betriebsanweisungen. -Die neue Risikoanfrage ist nicht genehmigt; keine weitere Testausführung daraus. +Der [Lieferplan](mvp-completion-plan.md) nennt den nächsten Schritt. Für eine Entwicklungskorrektur reicht der direkte Weg zum betroffenen Dienst. Der Agent-Updater ist selbst ein Produktfeature und wird über den Releasekanal geprüft, wenn genau diese Funktion zur Abnahme steht. -Stand: 2026-11-16 · Spezifikation 1.30. Das begrenzte Linux-MVP ist inzwischen -dokumentiert abgenommen; aktuelle Nachweise stehen in [handover.md](handover.md). -Die getrennte Windows-SYSTEM-Grenze ist in Spezifikation0.1 und -[windows-system-policy.md](windows-system-policy.md) präzisiert; Quellen-/Build- -oder Linux-Unitnachweise aktivieren keine Windowswirkung. -**Windows-Override:** Entwicklung und native -Tests auf der neuen Windows-11-VM sind ausdrücklich parallel erlaubt, unabhängig -von der noch offenen Linux-MVP-Abnahme. Die nachstehenden älteren Wartevorgaben -sind hierfür überstimmt; keine Windows-Pflicht zur Linux-Abnahme. -**Topologieoverride:** Dieses Notebook -ist ausschließlich Entwicklungsrechner, weder RMM-Server noch RMM-Client. -Aktueller Client ist die Cloud-Test-VM, endgültiger Server der festgelegte -Cloudserver. Clients verbinden sich ausgehend direkt dorthin. Aktueller Vertrag und -Deploymentnachweise: [server-deployment.md](server-deployment.md). -Die folgenden PC-Server-/Reverse-Tunnel-Abläufe und Nachweise sind historisch. -TLS/mTLS, Credentialschutz, Linux-first und WebUI-Plangenehmigung gelten weiter. +## Buildziel wählen -## Fortsetzung Windows-MVP (Version 1.26) +Die Befehle werden im Repository ausgeführt. Der [Buildrunner](../tools/build.py) verwendet den gewählten Git-Commit, die gepinnte Rust-Toolchain und die vorhandenen Docker-Builder. `--plan` zeigt Revision, Zielbinaries und Kommando an. `--ref` akzeptiert einen Commit oder Branch und verwendet standardmäßig `HEAD`. Bei absichtlich geänderten Quellen einen eigenen abgegrenzten Git-Stand wählen, damit fremder WIP im Arbeitsbaum bleiben kann. Der Cargo-Cache wird je Ziel wiederverwendet. -Die weitere Windows-Abnahme ist ausdrücklich beauftragt, möglichst parallel. -Root koordiniert die eine Test-VM, Dienstwechsel und Browsergenehmigungen; -unabhängige Quellarbeiten laufen getrennt. Die bisherige zusätzliche -Echo-Einschränkung wird ausschließlich durch einen gesonderten interaktiven -Abschluss mit Originalnachweisen beendet. Keine Bereitschaft oder Jobfreigabe -entsteht daraus. Quellen-/Build-/native VM-Ergebnisse bleiben getrennt; -[aktuelles Protokoll](windows-mvp-completion.md). +| Ziel | Befehl | Ergebnis | +| --- | --- | --- | +| Linux-Client x86-64 | `python3 tools/build.py linux-x64` | Agent, privilegierter Helper und stabiler Updater | +| Windows-Client x86-64, Entwicklung | `python3 tools/build.py windows-gnu-x64` | Windows-GNU-Agent, SYSTEM-Helper und stabiler Windows-Updater. | +| Server ARM64 vom Notebook | `python3 tools/build.py server-arm64 --ssh` | Überträgt den Runner und ausgewählte Quellen des Git-Commits per geprüftem SSH. Baut Server und Zeitbroker im separaten Bereich `~/rmm-dev-build/server-arm64/` auf dem nativen ARM64-Host. Ausgabe enthält Remote-Pfad und Hashes. | +| Server ARM64 direkt auf einem passenden Linux-Buildhost | `python3 tools/build.py server-arm64` | Serverbinary für API/Gateway und Zeitbroker. Der lokale Modus erwartet Git-Checkout, gepinnten ARM64-Builder, Docker, Python 3, git, tar und rsync. | +| WebUI | `npm --prefix web run build` | TypeScript-Prüfung und Vite-Bundle in `web/dist/`. Im frischen Checkout zuerst `npm --prefix web ci` ausführen. | +| Windows-Binaries nativ mit MSVC | Vorhandenen [MSVC-Runner und Voraussetzungen](../deploy/windows/msvc/README.md) verwenden. | Geplant, nicht ausgeführt. Eigener Preflight und Build auf passendem Windows-Builder. Der GNU-Weg ist für schnelle Iteration auf dem Gast vorgesehen. | -## Aktuelle MVP-Anmeldung über SSH-Tunnel (Version 1.25) +Der lokale Runner gibt den **konkreten Artefaktordner** aus. Unter `devstate/build//artifacts///` liegen die Binaries und `manifest.json` mit Quellrevision, Zielarchitektur, Builder und SHA-256. Ausgelieferte Binärdateien immer am Hash identifizieren: Zwei Builds aus demselben Commit können unterschiedliche Bytes haben. Ein Build erstellt noch keinen signierten Produktrelease. -WebUI und MCP bleiben an Server-Loopback gebunden. Für den aktuellen MVP -ist kein OIDC-Anbieter erforderlich. Der Betreiber erlaubt den bestehenden -Entwicklungslogin und die sichtbar simulierte Browsergenehmigung des festen -PowerShell-Testplans. Die OIDC-Bedingung des begonnenen administrativen -Recoverywegs ist keine Voraussetzung dieser begrenzten Testabnahme. -Die festen Scriptbytes, Ziele, Grenzen, Auditdaten und der normale signierte -Jobpfad bleiben erforderlich. Nachweise siehe [server-deployment.md](server-deployment.md) -und [windows-profile-acceptance.md](windows-profile-acceptance.md). +## Server und WebUI aus einem geprüften Git-Stand aktivieren -## Historienerhaltende Windows-Wiederherstellung (Version 1.24) +`python3 tools/build.py server-arm64 --ssh --ref REVISION` erzeugt die Binärdatei auf dem Server. Anschließend baut `python3 tools/dev_deploy_server.py --ref REVISION` die passende WebUI, übernimmt die vorhandene Compose-Konfiguration und aktiviert API und Gateway. Der Runner vergleicht die tatsächlich angewendeten SQLx-Prüfsummen mit Git und liest die laufenden Binärhashes und die über TLS ausgelieferte Startseite zurück. Mit `--overlay server.releases.compose.yaml` überträgt und aktiviert der Runner die entsprechende Datei aus derselben Git-Revision. [Deploymentrunner](../tools/dev_deploy_server.py) -Für den dokumentierten Fall `HELPER_CHECKPOINT_REQUIRED` ist die -Wiederherstellung mit Erhalt der Geräteidentität und aller Journale beauftragt. -Die erhaltenen signierten Antworten und der abweichende gültige Serverhead -werden vor jeder Korrektur unabhängig geprüft. Das neue Verfahren braucht -einen eigenen nachvollziehbaren Administrationsnachweis. Anschließend gelten -die normalen unabhängigen Zeit- und Syncprüfungen für beide Dienstrollen. -Die Testjobabnahme verwendet danach weiterhin den fest gebundenen MCP-Antrag -und die WebUI-Genehmigung. Der historische V1.10-Reparaturweg betrifft einen -anderen Fehlerfall. Native Wiederherstellung und Jobabnahme sind noch offen. +Bei einer reinen WebUI-Änderung genügt `python3 tools/dev_deploy_server.py --web-only --ref REVISION`. Für ein schon gebautes Bundle aus dem Arbeitsbaum genügt `python3 tools/dev_deploy_server.py --web-only --web-dist web/dist`. Beide Wege stellen zuerst die Assets und zuletzt die Startseite per SSH bereit. Der Runner vergleicht die per TLS ausgelieferte Startseite mit den übergebenen Bytes. Die Ausgabe enthält den SHA-256 der Startseite und die ID des laufenden API-Containers. -## Begrenztes Windows-KVM-Zeitprofil (Version1.23) +## Vorhandene Dateien direkt bereitstellen -Der User hat `trusted_os_active_guest` ausdrücklich zur Umsetzung erlaubt. -[Profilvertrag und Betriebsgrenzen](windows-kvm-clock-contract-proposal.md) -und SpezifikationKapitel0 gelten: vertrauensbasierte nominelle OS-/KVM-Zeit, -keine behauptete unabhängige physikalische Kalibrierung. Eigener versionierter -Opt-in mit geschützten Rollen-/Image-/Plattformbelegen; kein geratener Basiswert. -Vor VM-Pause, Save/Restore, Snapshot-Rückkehr, Migration und Host-Suspend beide -Agent-/Helperprozesse beenden und anschließend frisch starten. Keine solche -Betriebsaktion oder Gatefreischaltung folgt automatisch aus der Entscheidung. -Linux-first und native Windowsabnahme bleiben erforderlich; der signierte -Serververgleich und jede WebUI-Genehmigung bleiben Pflicht. +[dev_stage.py](../tools/dev_stage.py) verwendet die vorhandenen gepinnten SSH-Zugänge für `server`, `linux` und `windows`. Der Befehl nimmt beliebig viele benannte Entwicklungsartefakte entgegen, darunter fertige Binaries oder bereits gebaute Webassets. Unter `rmm-dev-stage//` im Profil des SSH-Benutzers verifiziert er die Datei und verwendet vorhandene identische Bytes wieder. Für das Prüfen der Zielpfade genügt `--plan`. [Zugangsprofile und Hostpins](operations-access.md) -## Unabhängiger signierter Windows-Zeitvergleich (Version1.22) - -Der User erlaubt ausdrücklich den signierten Onlinevergleich mit dem festen -Server. [Angenommener Vertrag](windows-clock-attestation-proposal.md) und -SpezifikationKapitel0 ersetzen den früheren Ausschluss dieser Trustsource. -Agent und SYSTEM-Helper halten eigene Challenges, Beobachtungen und geschützte -Zeitpins. W32Time-Rohstatus bleibt separat; kein Clocksetter oder impliziter -manueller Resync. Fehlende native Server-/Windowsqualität sperrt weiter Jobs. -Ein signierter Zeitbeleg ersetzt weder SignedSync noch Startgrant oder WebUI. - -Zuerst reale Cloud-Linux-Prüfungen des gemeinsamen Vertrags und der Serverquelle, -danach Windows getrennt je tatsächlicher Identität. Isolierte Codecunits belegen -keine reale Zeitqualität. Caller dürfen die gesamte frische UTCspanne nicht auf -einen ungesicherten Mittelpunkt reduzieren; Start- und Syncablauffristen müssen -konservativ eingehalten werden. Notebook bleibt nur Entwicklung. - -## Enger paralleler Agentupdater (Version1.21) - -Der User hat signiertes Agent-Selbstupdate parallel vorgezogen. Es bleibt ein -festes Release-/Vorgänger-/Versuchs-/Planhashpaket mit tatsächlicher WebUI- -Genehmigung; passive Metadaten/Updatezustände sind keine Jobs. Neuer -`agent.update`-Scope liefert eigene tatsächliche Beobachtungszeiten und darf -kein altes Linux-/Windows-Baseinventar frischstempeln. Beide Binaries werden -vollständig vor Handoff gestaged; anschließender read-only Inflight-/Health- -Kontrollpfad eröffnet keine Admission oder neue Startlease. - -Vor Zielarbeit: kompatible erhaltende Bootstrap-/Baselineprovisionierung, -unabhängiger Source-Review, Linux-first-Units/OSports und danach ein konkreter -WebUI-genehmigter Apply mit State-/PKI-/Historyerhaltung und erlaubtem Code- -Rollback. Root koordiniert alle Zielaktionen. Notebook bleibt nur Entwicklung. -Aktuelle Teilnachweise und fehlende Runtimegates: -[Handoff](agent-updater-handoff.md), [Linuxport](agent-updater-linux-port.md), -[Server/UI](agent-updater-server-console.md). Keine Applycapability aus einem -Build oder Katalogeintrag ableiten; fehlende Qualifikation bleibt deny. - -## Vorrang: genehmigte Batch-Skriptkonsole (Version1.20) - -Der User priorisiert vollständige Shell-/PowerShell-Skripte über MCP/UI mit -expliziten Root-/SYSTEM-Rechten. Kapitel0.1 bindet das neue optionale -`privileged_script_profile="full_maintenance_v1"` vor Genehmigung in Payload, -Policy und WebUI. Alte Pläne/Profile bleiben unverändert; SCM/APT/MSI dürfen -keine Vollwartung durch eine stille Lockerung erhalten. Bisherige M7-Aussagen -zu Terminal/Sitzungen verschieben diese Batchkonsole nicht. Agent-Selbstupdates -werden separat behandelt; Paketfixture-Abnahmen ersetzen sie nicht. - -Geplanter, noch nicht ausgeführter Ablauf: additive bytekompatible Verträge und -Policygrenzen implementieren; lokale betroffene Kompatibilitäts-/Fehlerprüfungen; -reviewbare explizite Helper-/Policymigration unter Erhalt aller Identitäten, -Journaldateien und Verbräuche; qualifizierte Linux-Cloud-Artefakte; neuer fester -WebUI-genehmigter harmloser Vollwartungsplan auf der Linux-Cloud-VM; erst danach -getrennte native Windows-SYSTEM-Abnahme auf dem Windowsgast. Kein RMM-Agent oder -Server auf dem Notebook. Vor Zieländerungen konkrete Startbedingungen/Umfang -festhalten, keine Ledgerresets oder impliziten Reboots/Updates. - -Abnahme muss gespeicherte vollständige Skriptbytes samt Profil/Identität/Limits -vor tatsächlicher WebUI-Genehmigung zeigen, vor Genehmigung Job-/Outbox-/Grant- -Abwesenheit belegen und danach ehrliche Zustände/finale begrenzte stdout-/stderr- -Rohbytes mit Trunkierung erfassen. Keine laufende Ausgabe vortäuschen: bestehende -Jobstrecke liefert vorerst Abschlussausgabe. LinuxUID0 und WindowsSID18 sowie -Clock/Sync/Peer-/Originalsignatur-/Einmalverbrauchsgrenzen getrennt nachweisen. -Abbruch/Fence/Timeout prüfen nur im abgestimmten harmlosen Scope; unklare Wirkung -bleibt unknown, kein blindes Wiederholen. Root/SYSTEM kann auch eigene Schutz- -mechanismen ändern; keine Sandbox-/No-Reboot- oder vollständige Kindprozess- -Eindämmungszusage. Ein Skript-Reboot ersetzt keine typisierte Rebootabnahme. - -Die Norm ist beschlossen; lokale Quellen-/Buildnachweise und deren Grenzen -stehen in [deploy/linux/full-maintenance-README.md](../deploy/linux/full-maintenance-README.md). -Ein unabhängiger Review fand im ersten eingefrorenen Pack die fehlende tatsächliche -Linux-Helperbinarybindung; dieser Pack bleibt nur früherer Beleg. Der enge -Full-only-Corefix wurde unabhängig geprüft und im neuen Pack29461892 mit158 -unveränderten Inputs,285 lokalen Tests und45 tatsächlichen isolierten DB-Verträgen -neu qualifiziert. Der separate Native-Runner ist vorbereitet, noch nicht -Zielaktivierung oder VM-Abnahme; diese bleiben offen. Die bestehende begrenzte -Linux-MVP-Abnahme wird nicht nachträglich zur Vollwartungsabnahme umgedeutet. -Details/technischer Entwurf: [script-console-contract-proposal.md](script-console-contract-proposal.md). - -## Begrenzte Windowsfreigaben (2026-11-14) - -Der User erlaubt `RemoteSigned` ausschließlich je zuvor WebUI-genehmigtem -Windows-PowerShell5.1-Jobprozess. Die feste Option muss vor der Genehmigung im -unveränderlichen Plan sichtbar und in den Originaljobbytes gebunden sein. -Keine Maschinen-/CurrentUser-/GPO-Policyänderung durch den Executor, kein -Bypass-/Unrestricted-Fallback und kein nachträgliches Ändern alter Pläne. -Quellenstand und nötige Linux-first-/Windowsnachweise: -[windows-powershell-policy.md](windows-powershell-policy.md). Die laufende -gemeinsame Quellen-/Upgradequalifikation wird für diesen Entwurf nicht verändert. - -Der vorhandene `W32Time` darf gezielt gestartet werden; Startart, NTPserver/Peers -und ACLs bleiben unverändert. Anschließend sind tatsächliche lokale Uhrqualität, -Unsicherheit und Bootbindung zu prüfen. Running allein öffnet kein Clockgate. -Ein manueller VM-Konsolenneustart ist erst später nach ausdrücklicher zeitlicher -Abstimmung mit dem User vorgesehen. Kein Remote-Reboot oder RMM-Reboottest; -ein solcher manueller Neustart ist kein genehmigter RMM-Reboot-Erfolgsnachweis. -Notebookhost weiterhin ausschließlich Entwicklung. Dieser Abschnitt dokumentiert -Erlaubnis und offene Nachweise, keine hier ausgeführten Zielaktionen. - -## Ergänzende Userfreigabe und lokale Browserprüfung (2026-11-12) - -Der User hat temporären Testdienst, harmloses Testpaket, systemd-Agent, einen VM-Reboot -und ausgewählte kleine Updates ausdrücklich erlaubt; kein Kernel-/Distributionsupdate -und kein ungeplanter Reboot. Jeder entsprechende RMM-Job benötigt weiterhin seinen -festen Plan und explizite WebUI-Genehmigung, bei dev/test sichtbar als Simulation. -Diese Freigabe ist kein Ausführungsnachweis. Im lokalen Browser-Integrationslauf wurden -keine VM-Änderungen, Tunnel, Paket-/Update-/Rebootjobs oder Genehmigungen ausgeführt: -nur echtes TLS, Login, Zielpreview, Antrag `pending_approval`, Reload und CSRF-Prüfung -mit authentisiertem synthetischem lokalem mTLS-Testgerät. Details und reproduzierbarer -isolierter Browser-Truststore: `deploy/browser/README.md`; keine globale Truständerung. - -## Phasen und Gates - -1. **Linux-MVP:** M0–M5 auf Linux x86-64 mit zwei Testmandanten, WebUI, MCP und dauerhaftem, menschlich autorisiertem Jobpfad. **Jedes Feature zuerst auf der tatsächlichen Linux-Test-VM ausführen und nachweisen.** Der PC-/Containerlauf, ein Simulator oder erfolgreicher Build allein genügt nicht. Nicht auf der VM geprüfte Features bleiben unbestätigt. -2. **Windows nach Linux-MVP:** Erst nach dokumentierter Linux-MVP-Abnahme Windows-x86-64-Adapter, Dienste, Installer und dieselben Fähigkeiten nativ auf Windows abnehmen. Gemeinsame Schnittstellen berücksichtigen Windows, ohne vorgezogene Windows-Featureimplementierung. -3. **Spätere Erweiterungen:** Monitoringausbau/ARM64, danach gesondert PVE/PBS, Cluster und Backupabnahmen gemäß Spezifikation; Terminal/Betriebsreife folgen ebenfalls nach MVP. PVE ist weder Testinfrastrukturpflicht noch Voraussetzung für eigenständige Gastagenten. - -Linux-MVP-Gate: Enrollment, verifiziertes TLS/mTLS, ausgehender Kanal, passives Inventar mit Quelle/Zeit, UI/MCP-Tenant-Grenzen, Antrag `pending_approval`, WebUI-Klick (tatsächlich menschlich oder ausschließlich die unten beschriebene dev/test-Browsersimulation, getrennt nachzuweisen), dauerhafte Jobs/Journal/Startgrants und nachgewiesene Ergebnisse auf der VM. Die M0–M5-Abnahmen gelten zunächst für Linux; Windows-/Mischplattformfälle folgen erst in der Windows-Phase. Long Polling, Reconnect, fehlende Genehmigung und Redelivery ohne Doppelwirkung ebenfalls nachweisen. **Useroverride 2026-11-12: RustDesk auslassen.** Keine RustDesk-Installation, Profile/Provisionierung oder externe Desktopabnahme in dieser Umsetzung. M4 bleibt allgemeine Linux-Paketverwaltung; M5 prüft nur die drei übrigen Referenzabläufe. RustDesk ist weder MVP-Pflicht noch offenes MVP-Gate; bestehende Architekturtexte gelten ausschließlich für eine spätere optionale Integration. Keine eigene Desktop-Engine als Ersatz. - -## Geplante Topologie - -```text -Entwickler-PC Linux-Test-VM -Docker: TLS-Endpunkt 127.0.0.1:18443 Agent - ^ | - | SSH-Weiterleitung (TCP, keine TLS-Terminierung) | ausgehend TLS - +--------------------------------------- 127.0.0.1:18443 -PC -- initiiert SSH zur VM --> sshd DNS: rmm-dev.internal -``` - -Der Server läuft **lokal in Docker auf dem PC**, nicht auf der Ziel-VM. Nur benötigte Ports veröffentlichen und alle Veröffentlichungen explizit an Loopback binden; der geplante TLS-Port lautet `127.0.0.1:18443`. Interne Datenbanken möglichst gar nicht veröffentlichen; andernfalls ebenfalls nur Loopback. Keine Bindings an alle Interfaces, kein `GatewayPorts yes`. Die VM benötigt keinen eingehenden RMM-Port. SSH zum Bootstrap ist eine davon getrennte Entwicklungsverbindung, keine Änderung des ausgehenden RMM-Vertrags. - -### Geplanter SSH-Reverse-Tunnel (nicht ausgeführt) - -Zuerst den SSH-Hostschlüssel über einen vertrauenswürdigen Weg prüfen und in `known_hosts` hinterlegen. `VM_USER`/`VM_HOST` im folgenden Beispiel sind bewusst **nicht geheime Platzhalter**, keine automatisch geladenen Konfigurationsvariablen. Reale Zugangswerte nicht in geteilte Logs oder Shell-Traces ausgeben. +Beispiel für ein bereits gebautes Linux-Paar, **geplant, nicht ausgeführt**. `ARTIFACT_DIR` auf den vom Build ausgegebenen Ordner setzen: ```sh -# GEPLANT, NICHT GETESTET: auf dem Entwickler-PC, Zielwerte lokal einsetzen. -ssh -N -T \ - -o ExitOnForwardFailure=yes \ - -o ServerAliveInterval=30 \ - -o ServerAliveCountMax=3 \ - -o StrictHostKeyChecking=yes \ - -R 127.0.0.1:18443:127.0.0.1:18443 \ - VM_USER@VM_HOST +python3 tools/dev_stage.py --plan linux "$ARTIFACT_DIR/rmm-agent" "$ARTIFACT_DIR/rmm-privileged-helper" +python3 tools/dev_stage.py linux "$ARTIFACT_DIR/rmm-agent" "$ARTIFACT_DIR/rmm-privileged-helper" ``` -Der linke Loopback ist der Listener **auf der VM**, das rechte Ziel wird **auf dem PC** erreicht. Der Agent baut seine Verbindung zu diesem VM-Loopback auf; SSH transportiert nur die TCP-Bytes zum lokalen TLS-Endpunkt. `ExitOnForwardFailure` prüft die Einrichtung der Weiterleitung, **nicht** Erreichbarkeit/Gesundheit des lokalen Servers oder erfolgreiche Agentauthentisierung. Keepalive erkennt Verbindungsverlust; ein Tunnelneustart erteilt keine Jobgenehmigung. Bei Portkonflikt oder verweigertem Forwarding sicher abbrechen, nicht auf einen öffentlichen Listener ausweichen. +## Aktivierung der bereitgestellten Entwicklungsversion -## TLS bleibt Ende-zu-Ende +Nach dem Transfer die laufende Version und ihre Rückmeldung prüfen. Für den Server übernimmt das der Deploymentrunner. Die beiden Entwicklungsgeräte haben eigene Verfahren für den Wechsel einer laufenden Binärdatei. -- Serverzertifikat mit **DNS SAN `rmm-dev.internal`**, korrekter Gültigkeit und passender Serververwendung bereitstellen; private CA-/Serverschlüssel geschützt lokal halten, nicht committen. Dev-CA gezielt im Agenten-Truststore hinterlegen. -- **Auf der VM** in `/etc/hosts` explizit die folgende Zuordnung pflegen (geplante Bootstrapänderung, nicht hier ausgeführt): +- **Server.** Den oben angegebenen Deploymentrunner verwenden. Er übernimmt die aktive Compose-Dateikette aus den Containerlabels, bestehende Volumes und Policy-Mounts. [Deploymentaufbau](server-deployment.md) +- **Linux.** Beim Austausch der betroffenen Dienste ihre tatsächlich installierten Artefakte und Rechte feststellen, Ersatz vollständig bereitstellen und Konfiguration, Identität und Journal erhalten. Den Prozesshash, einen neuen Heartbeat und bei geänderter Jobruntime einen regulären Sync zurücklesen. Die früheren [Linux-Wechsel](../deploy/cloud_shared_core_upgrade_v2.py) enthalten wiederverwendbare Prüfungen und setzen konkrete Altfälle voraus. +- **Windows.** Agent und Helper bei einem Paarwechsel koordiniert stoppen, Binärdateien und die an sie gebundenen Metadaten aus derselben Version einsetzen, ACLs und Geräteidentität erhalten und geordnet starten. Prozesshashes und Gerätepräsenz getrennt abfragen. [Vorhandener Paarwechsel](../deploy/windows/Install-DevelopmentPairSuccessor.ps1) · [Zugang und lesende Diensteprüfung](operations-access.md) - ```text - 127.0.0.1 rmm-dev.internal - ``` +Der alte `deploy/dev.py up` richtet eine lokale Compose-Umgebung ein. Der Produktserver liegt auf dem dedizierten Internetserver. Fallbezogene Builder wie `server_build_221.py` sind über ihre damaligen Belege auffindbar. -- Geplanter Agent-Endpunkt: `https://rmm-dev.internal:18443`, WSS entsprechend `wss://rmm-dev.internal:18443/agent/v1/connect`, sofern die Implementierung diesen Protokollstand tatsächlich bereitstellt. Enrollment verwendet serverauthentifiziertes HTTPS; danach mTLS mit eigener Geräteidentität. -- Alternativ ausschließlich einen ausdrücklich unterstützten und getesteten Client-Connect-Override verwenden: TCP-Ziel `127.0.0.1:18443`, **TLS-SNI und Zertifikatsnamensprüfung weiter `rmm-dev.internal`**. Kein erfundenes CLI-Flag als vorhandenes Feature dokumentieren. -- Ein Aufruf über `https://127.0.0.1:18443` passt nicht zum DNS-SAN. Nicht mit `accept_invalid_certs`, `danger_accept_invalid_certs`, deaktivierter Hostnamenprüfung oder `curl -k` umgehen. SSH ersetzt weder TLS noch Enrollment, mTLS oder Anwendungsautorisierung. +## Tatsächlich geprüft am 17. November 2026 -## Lokale Zugangsdaten und Bootstrapgrenzen +- `linux-x64` und `windows-gnu-x64` auf dem Entwicklungs-PC aus `a576c10` gebaut, fünf Binaries und beide Manifeste per SHA-256 geprüft. Wiederholte Cargo-Builds aus dem Cache lagen jeweils unter einer Sekunde. Auf dem Windows-Gast liefen bei der Inventur die Hashes seines früheren Installationsbuilds aus demselben Commit. +- `python3 tools/build.py server-arm64 --ssh` auf dem konfigurierten ARM64-Server tatsächlich ausgeführt. Server und Zeitbroker als ELF64/AArch64 nachgelesen, Manifest und Hashes bestätigt. Cargo benötigte beim ersten Lauf 7 min 6 s, beim zweiten 0,52 s. Beide Läufe lieferten identische Bytes. API, Gateway und Datenbank liefen währenddessen weiter. +- WebUI mit den lokal vorhandenen Abhängigkeiten typgeprüft und in ein isoliertes Ausgabeverzeichnis gebaut. Ergebnis: `index.html`, CSS- und JavaScript-Bundle. +- Auf Server, Cloud-Linux und Windows jeweils `python3 tools/dev_stage.py ZIEL rust-toolchain.toml` zweimal ausgeführt. Der erste Aufruf übertrug die Datei und prüfte den Zielhash, der zweite bestätigte die vorhandenen Bytes. Der Test veränderte nur den Stagingbereich. Es wurde kein Dienst aktiviert, Gerät neu aufgenommen oder Produktrelease veröffentlicht. [Build- und Betriebsbelege](evidence/product-audit-20261117.json) -- VM-Daten liegen ausschließlich in **`credentials/linux-vm.conf`**. Das Verzeichnis muss in `.gitignore` ausgeschlossen sein; vor Nutzung prüfen. `credentials/` erhält Modus **700**, die Datei **600**; nur der vorgesehene lokale Benutzer hat Zugriff. Auch private Schlüssel/Secretdateien restriktiv schützen. Diese Dokumentationsänderung liest oder verändert keine Zugangsdaten. -- Die Datei ist **Daten, kein Shellskript**. Nur bekannte Felder mit striktem Parser/Validierung einlesen; unbekannte/ungültige Werte zurückweisen. Niemals `source`, `. credentials/linux-vm.conf`, `eval` oder Shell-Expansion des Inhalts verwenden. Kein bestimmtes vorhandenes Dateischema behaupten oder Secrets für Beispiele öffnen. -- Keine Secrets in Commits, Logs, Screenshots, stdout/stderr, Shell-Traces (`set -x`), MCP-/LLM-Kontexten oder Jobausgaben. Keine Passwörter in dokumentierten Kommandozeilen. Zugangsdaten weder zur Dokumentationsprüfung noch zum bloßen Auffinden der VM auslesen. -- Entwicklungs-/Testtools dürfen installiert werden. Zieländerungen auf den vereinbarten Bootstrap (z. B. Agent, Truststore, Hosts-Eintrag) begrenzen. **Keine impliziten Ziel-Reboots, Betriebssystemupdates oder destruktiven Tests**; sie benötigen einen gesonderten ausdrücklichen Auftrag und bei RMM-Ausführung zusätzlich den festen menschlich in der WebUI genehmigten Jobplan. Toolinstallation ist keine allgemeine Zieladministrationsfreigabe. +Die früheren Entwicklungsprotokolle einschließlich der alten Notebook-/Reverse-Tunnel-Topologie sind im Git-Stand `a576c10:docs/development.md` erhalten. -## WebUI-Genehmigung auch in Linux-Dev +## Signierte Agentversion im Entwicklungsmandanten veröffentlichen -Jeder Ausführungsjob wird zuerst als Antrag **`pending_approval`** gespeichert. Ein berechtigter Mensch sieht in der WebUI feste Ziele, Einzeljobs/Versuche, Inhalte/Hashes, Fristen und Wirkung und genehmigt genau diesen Plan. Vorher **keine** ausführbaren Jobs/Outbox/JobOffers/Startgrants. Keine Dev-Autofreigabe, Testpolicy, direkte API-/DB-Freigabe oder SSH-Ausführung als vermeintlicher RMM-Erfolgsnachweis. Einzige Ausnahme zur tatsächlichen menschlichen Bedienung ist die folgende ausdrücklich erlaubte dev/test-Browsersimulation, keine Code-Abkürzung. +Der Buildordner enthält das in der Buildquittung gebundene Agent-/Helperpaar und den stabilen Bootstrap-Updater. Ein Linux-Build benötigt `rmm-agent`, `rmm-privileged-helper` und `rmm-agent-updater`. Auf Windows heißen die Dateien `rmm-agent-windows.exe`, `rmm-helper-windows.exe` und `rmm-updater-windows.exe`. Beim GNU-Entwicklungsbuild den Updater mitbauen. Der Katalog führt Linux GNU, Windows MSVC und Windows GNU als getrennte Ziele. Windows GNU ist auf dem Entwicklungsserver freigeschaltet. -**Userentscheidung 2026-11-12:** „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“. Ausschließlich für diese Entwicklungsabnahme darf Browserautomatisierung im **expliziten dev/test-Profil** tatsächliche UI-Interaktionen einschließlich Plangenehmigung durchführen. Ein deutlich sichtbar als **simulierter Testprincipal** gekennzeichneter Principal bedient dabei dieselbe UI-Grenze; kein Vortäuschen einer tatsächlichen menschlichen Identität. Planbindung, Rechte-, Tenant- und Policyprüfungen bleiben erhalten. Audit muss `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr samt Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar kennzeichnen. Das sind Anforderungen, kein Nachweis bereits implementierter Auditfelder. Simulation getrennt von tatsächlicher menschlicher Genehmigung ausweisen, niemals als Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Normale UI-Browserrequests bleiben an deren interaktiven Kontext gebunden. Produktionsverhalten bleibt unverändert; dort keine Simulation. Details und Useroverride zum ausgelassenen RustDesk: `docs/project-decisions.md`, normativer Vorrang: Spezifikation 1.5 Kapitel 0.1. - -Lokale Serverneustarts sind ausdrücklich erlaubt. Dies erlaubt keine impliziten VM-Reboots, Updates oder destruktiven Zieltests und ersetzt keine WebUI-Plangenehmigung; der Zieltestumfang bleibt gesondert ausdrücklich abzustimmen. Diese Dokumentationsänderung führt weder Neustarts noch Simulationen oder Tests aus. - -Dies gilt für Hello World, Diagnose, `refresh_inventory` als angeforderten Job, Updates, Reboots, Folgejobs und neue Versuche. Passive Standardinventarisierung/Heartbeats und Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Diese Ausnahme nicht zur Tarnung angeforderter Live-Diagnose nutzen. Solange die UI-Freigabe durch einen berechtigten Menschen oder die eng begrenzte dev/test-Browsersimulation fehlt, bleibt die aktive Teststrecke blockiert; nur unabhängige passive Prüfungen fortführen. - -## Nachweisprotokoll (Vorlage, kein Testergebnis) - -Pro Feature festhalten: Spezifikations-/Codeversion, reale VM-OS-/Architektur, tatsächlich ausgeführte Befehle (redigiert), Zeit, Erwartung, beobachtetes Ergebnis, relevante Fehler und verbleibende Gates. Für Jobs zusätzlich Antrag/Planhash, WebUI-Genehmigung mit `approval_origin`/`testsimulation` und tatsächlichem oder simuliertem Principal, Versuch, Journal-/Startnachweis und fachliche Nachbedingungen referenzieren, ohne Secrets zu veröffentlichen. Simulationsnachweise sind keine Produktionsfreigaben. - -Getrennte Prüfpunkte: Docker-Bindings nur Loopback; SSH-Forward auf VM nur Loopback; DNS-Auflösung auf VM; TLS-Kette und SAN gültig; ungültiges Zertifikat wird verweigert; Enrollment/mTLS; passives Inventar; `pending_approval` ohne ausführbare Artefakte; Ausführung erst nach WebUI-Klick mit eindeutigem tatsächlichem oder simuliertem Ursprung; korrekte Ergebnisse/Redelivery/Tenant-Isolation; Simulation außerhalb dev/test verweigert. **Diese Prüfungen sind hier geplant, nicht ausgeführt.** Destruktive Fehler-/Reboottests nur nach gesonderter Abstimmung durchführen. Fehlender Realnachweis bleibt offen statt grün. - -Bekannt bleiben Repository `https://gitea.incoso.eu/kevin_janssen/rust-discovery` (SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`) und RustDesk-Server `rust.ease-technologies.de`. Edition, Ports, öffentlicher RustDesk-Serverschlüssel und Version sind noch unbekannt; fehlende Werte führen zu `not_configured`, nicht zu geratenen Defaults. - -## Tatsächlich ausgeführt: minimaler VM-Zugangscheck (2026-11-12) - -```sh -python3 -m py_compile deploy/vm_access_check.py -python3 deploy/vm_access_check.py -python3 tests/vm_access_check.py -python3 -m py_compile deploy/vm_access_check.py tests/vm_access_check.py +```bash +python3 tools/dev_agent_release.py \ + --artifacts "$buildordner" --build-receipt "$buildordner/manifest.json" \ + --sequence 1 --version 0.1.0-mvp.1 ``` -- Lokale Credential-Modi 0700/0600 und `.gitignore`-Ausschluss geprüft. Inhalte wurden - ausschließlich im ausführenden Python-Prozess als Daten geparst, nicht ausgegeben. -- Tatsächlicher SSH-Zugang zur VM mit vorhandenem Benutzer-`known_hosts`-Eintrag und - `StrictHostKeyChecking=yes` erfolgreich. Keine Hostkeys hinzugefügt oder verändert. - Das Hilfsskript ignoriert SSH-Konfiguration und nutzt keinen Agent-Forward. - Passwort-Fallback verwendet bei Bedarf eine temporäre private Datei und Askpass, - nicht Passwortargumente; private SSH-Fehlerausgaben werden nicht veröffentlicht. -- Read-only auf der tatsächlichen VM beobachtet: Linux, Ubuntu 24.04, x86-64, - glibc 2.39; Hostname lesbar und Benutzerhome vorhanden, ohne diese Werte offenzulegen. - Port 18443 war laut `ss` zum Prüfzeitpunkt frei. Das ist keine spätere Portreservierung. -- Fünf lokale Parser-Tests bestanden: literale Passwortdaten, unbekannte/doppelte Felder, - unsichere Dateirechte, ungültiger Port und fehlende Ignore-Regel. Syntaxprüfung bestanden. -- **In diesem ersten Zugangscheck nicht ausgeführt:** Binärkompatibilitätsprüfung gegen das konkrete Agentartefakt, - SSH-Reverse-Tunnel, VM-Deployment, Enrollment, VM-Agent/Heartbeat/Inventar und systemd. - Keine Pakete, Hosts-/Firewall-/sshd-Konfiguration, Updates oder Reboots verändert; - keine RMM-Jobs oder Genehmigungsumgehungen. -- Vorbereitung zunächst an Kontextgrenze angehalten: gebündelte Pflichtdokumentausgabe wurde - abgeschnitten. Vor weiterem Agentbootstrap vollständige Spezifikation und die konkreten - Deployment-/Agent-Schnittstellen mit zusätzlichem Lesebudget prüfen. Der erfolgreiche - Zugangscheck ist ausdrücklich kein Linux-M1-/Feature-Abnahmenachweis. +Der Befehl prüft die Buildquittung und überträgt die drei Binärdateien über den gepinnten SSH-Zugang. Auf dem Server signiert ein separater Ed25519-Schlüssel je Plattform das exakte Agent-/Helperpaar. Der Aufruf lädt die Dateien über die authentisierte Management-API und veröffentlicht zuletzt den Envelope. Ein erneuter Aufruf mit derselben Sequenz und denselben Bytes verwendet die gespeicherte Signatur. Für eine geänderte Version die Sequenz erhöhen. Native MSVC-Builds verwenden ihre `result.json` als `--build-receipt`. -## Tatsächlich ausgeführt: passiver VM-Agent über Reverse-Tunnel (2026-11-12) +Beim ersten Serveraufbau den Befehl zunächst mit `--prepare-only` ausführen. Damit entstehen die Schlüssel, die öffentliche Konfiguration und der Objektspeicher unter `/opt/rust-discovery/devstate/mvp-releases`. Das Compose-Overlay `deploy/server.releases.compose.yaml` bindet nur Konfiguration und Objekte an die Rollen. Der private Schlüssel bleibt auf dem Server. Anschließend API und Gateway mit diesem Overlay aktivieren und den Veröffentlichungsbefehl ohne `--prepare-only` erneut ausführen. Der bei der Einrichtung gespeicherte SHA-256 ist der Ausgangswert für die unten beschriebene kontrollierte Rotation. -Nach ergänzter vollständiger Pflichtlektüre wurde folgende Strecke tatsächlich ausgeführt: +## Neue Geräte und Selbstupdate -```sh -python3 -m py_compile deploy/vm_passive_test.py -python3 deploy/vm_passive_test.py -python3 tests/vm_access_check.py -python3 tests/vm_passive_test.py -python3 -m py_compile deploy/vm_access_check.py deploy/vm_passive_test.py tests/vm_access_check.py tests/vm_passive_test.py -python3 deploy/vm_access_check.py -``` +Im Releasekatalog der WebUI unter **Neues Gerät aufnehmen** einen Einmalcode erzeugen. Die WebUI zeigt die Installationsaufrufe für die veröffentlichten Plattformen. Den Code auf dem neuen Gerät im Prompt eingeben. Nach 15 Minuten oder beim erfolgreichen Enrollment verliert er seine Gültigkeit. Der öffentliche Bootstrap-Origin wird mit `RMM_BOOTSTRAP_ORIGIN` festgelegt. Die Geräteadresse stammt aus der geschützten plattformspezifischen Bootstrapkonfiguration. -`deploy/vm_passive_test.py` ist ein bewusst ausführender, begrenzter VM-Test und kein -reiner Zugangscheck. Er liest Credentials nur intern, prüft vorhandene Langläufer und -Portbelegung, erzeugt genau ein Enrollment-Token für Dev-Mandant A und hinterlässt -eine neue Geräteidentität samt Historie. Kein DB-/PKI-Reset und kein Token-/Key-Echo. +Im aktuellen Windows-Entwicklungsmandanten den angebotenen Aufruf mit `-Platform x86_64-pc-windows-gnu` aus der WebUI übernehmen. Windows verwendet den LocalService-Agenten und den separaten Dienst `RmmDiscoveryReleasePull` für die periodische Prüfung. -**Beobachtete Ergebnisse:** +Auf Linux startet `rmm-discovery-agent.service` als Systemkonto `rmm-discovery` mit eigenem Zustand in `/var/lib/rmm-discovery`. `rmm-discovery-update.timer` prüft nach dem Booten und anschließend alle fünf Minuten den Releasebestand. Die aktive Generation und ein bei fehlgeschlagener Aktivierung gespeicherter Fehler liegen unter `/opt/rust-discovery-client`. Der Lauf berücksichtigt belegte Jobs, verifiziert den signierten Inhalt, schaltet die Generation um und prüft die neue Geräteverbindung. Das Systemjournal von `rmm-discovery-update.service` enthält die Fehlermeldung. Der Linux-Produktinstaller startet den unprivilegierten Agenten. Die Freigabe und gerätespezifische Provisionierung des privilegierten Wartungshelpers bleibt eine eigene Verwaltungshandlung. -- Kein vorhandener PC-Reverse-Tunnel, kein VM-Agentprozess, kein VM-Listener auf 18443 - und kein früheres benutzerlokales Testverzeichnis vorgefunden. Nichts Fremdes gestoppt. -- Tatsächlich laufender Docker-Server ausschließlich `127.0.0.1:18443`; PostgreSQL - ohne veröffentlichten Port. Lokaler Healthcheck mit vertrauenswürdiger CA bestanden. -- Agentartefakt aus dem bereits laufenden Docker-Server kopiert, kein neuer Imagebuild: - Linux-x86-64-ELF, höchste referenzierte glibc-Version 2.34; VM hat glibc 2.39. - Alle ELF-`NEEDED`-Bibliotheken im VM-Laufzeitcache gefunden. Vor nativem Agentstart - VM-Loader `/lib64/ld-linux-x86-64.so.2 --list` gegen das konkrete Artefakt erfolgreich. - SHA-256: `667065dded71cc499b171bc799ad09f3ac7f049a72a9d54f4c943331a565eefe`. -- PC initiierte SSH mit `-N -T`, `StrictHostKeyChecking=yes`, - `ExitOnForwardFailure=yes`, Keepalive 30/3 und - `-R 127.0.0.1:18443:127.0.0.1:18443`. VM-seitig per `ss` genau dieser - IPv4-Loopbacklistener bestätigt. Keine Hostkey-/sshd-/Firewalländerung. -- Nur Binary, öffentliche CA und einmaliges Token per SSH-stdin in ein neues privates - Benutzer-Testverzeichnis übertragen. Geräteschlüssel auf der VM erzeugt; kein CA-/Server- - Privatschlüssel oder Viewer-Bearer übertragen. Kein Root-/systemd-/Paketbootstrap. -- Native VM-Agentstrecke mit `RMM_CONNECT_ADDR=127.0.0.1:18443`, eigenem privaten Zustand - und CA gestartet. Der vorhandene Override verändert nur TCP; Enrollment und WSS - prüfen weiterhin TLS-SNI/DNS-Namen `rmm-dev.internal`. Kein Hosts-Eintrag nötig, - keine Zertifikatsprüfung deaktiviert; keine Rust-/Protokolländerung erforderlich. -- Über echte tenantgebundene Lese-API exakt diese neue Agent-ID zugeordnet: - Inventar-Erhebungszeit **16:40:12.632 UTC**, Empfang **16:40:12.796518 UTC**; - Hostname intern mit SSH-Baseline verglichen, ohne ihn zu veröffentlichen. - OS Ubuntu 24.04, x86-64, tatsächlich verfügbare Root-Bytes und Inodes positiv, - Scope `linux.base`, Vollständigkeit `partial`, fachliche Gesundheit `unknown`. -- Zwei verschiedene frische Heartbeats serverseitig beobachtet: - **16:40:44.849118 UTC** und **16:41:12.779675 UTC**; Präsenz `online`. - Der Gateway-Code aktualisiert `last_contact_at` ausschließlich im Heartbeat-Zweig. - Leser von Dev-Mandant B sah diese Agent-ID nicht. -- Enrollment-Tokenkopie auf der VM entfernt. Test-Agent-PID **4141792** per SIGTERM - gestoppt, vorher exakten `/proc/PID/exe`-Pfad geprüft; anschließend Prozessende geprüft. - Nur den eigenen SSH-Tunnel-PID **1869118** beendet und auf Prozessende gewartet. - Geschütztes lokales Nachweisprotokoll mit PIDs, Zeitpunkten und privatem Remotepfad: - `devstate/vm-passive/result.json`. Kein aktiver verwalteter Testrecord zurückgeblieben. - Privates VM-Testverzeichnis mit Geräteidentität und Log bleibt für kontrollierte - Fortsetzung erhalten, keine laufende Installation. Secrets/Logs daraus nicht veröffentlichen. -- Fünf Parser-Tests erneut bestanden; drei lokale Orchestrierungs-Guardtests bestanden - (Fail-closed, private Fehlerausgaben unterdrücken, Remote-Code nur über stdin). - Python-Syntaxprüfung bestanden. Abschließender tatsächlicher lesender VM-SSH-Check - nach dem Test erfolgreich; VM-Port 18443 wieder frei. - Keine Rust-Änderungen, daher Rust-Build/Clippy und übrige Integrationstests hier nicht erneut ausgeführt. - -**Verbleibend:** Kein systemd-/Dienst-/Installer-Nachweis, keine Rotation, Ablauf-Recovery, -Long Polling, Reconnect-/Widerrufsabnahme auf VM, Proxy-/Klon-/Restore-/Lastabnahme. -Keine Jobs, WebUI-Freigaben, Updates oder Reboots ausgeführt. Der passive VM-Erstnachweis -ist erfolgreich, **M1 insgesamt und Linux-MVP bleiben unabgenommen**. - - -## Betreiberentscheidung: dauerhafter Windows-Entwicklungstransport - -Für die reine Windows-Test-VM hat der Betreiber ausdrücklich einen dauerhaft -gültigen bestehenden SSH-Rückkanal beauftragt. Die bisherige Befristung wird -ausschließlich für diesen Entwicklungstransport ersetzt. Keine RMM- oder -WebUI-Genehmigungsregel ändert sich. Notebook weiterhin nur Entwicklung. -[Tatsächliche Konfiguration und noch ausstehende Übergabeprüfung](windows-development-access.md). - - -## Aktueller fokussierter Schritt: SYSTEM-Testfall221 - -Der Betreiber hat den gesonderten historienerhaltenden Abschluss des ersten -SYSTEM-Fehlversuchs und danach einen neuen MCP-/WebUI-Auftrag ausdrücklich -freigegeben. Maßgeblich sind Spezifikation1.29 und -[der konkrete Ablauf](windows-system-script-nonstart-221-proposal.md). -Originaljournale/Unknown-Outcomes bleiben erhalten; keine direkte API-/DB- -Genehmigung, kein alter Grantretry und keine alte Lease. Andere MVP-Arbeit, -MSVC, Updater und Neustarts gehören aktuell nicht zum aktiven Schritt. +Ein geänderter stabiler Bootstrap-Updater wird ausdrücklich je Mandant rotiert. Dazu beim Veröffentlichen des geprüften neuen Builds `--rotate-bootstrap-from ` ergänzen. Für den Windows-GNU-Worker mit Skript-/Updatesperre verlangt der signierte Release zusätzlich `--minimum-updater-version 2`. Der Befehl lädt den neuen Worker zunächst über die Katalog-API hoch, vergleicht das gespeicherte Objekt und den bisherigen Mandantenpin und schaltet anschließend auf den neuen Hash um. Bereits ausgestellte Installer können den vorher erhaltenen Hash noch 15 Minuten lang abrufen. Weitere Releases desselben Workerstands verwenden nur `--minimum-updater-version 2`. Bestehende Geräte mit älterer stabiler Prüferdatei verwerfen ein Release, dessen signierte Mindestversion ihre eigene Prüferfähigkeit übersteigt. diff --git a/docs/evidence/dev-cleanup-pull-20261117.json b/docs/evidence/dev-cleanup-pull-20261117.json new file mode 100644 index 0000000..ef40b35 --- /dev/null +++ b/docs/evidence/dev-cleanup-pull-20261117.json @@ -0,0 +1,63 @@ +{ + "observed_at_utc": "2026-11-17T14:59:23.616565+00:00", + "development_job": "7d756c34-3506-4545-8ecd-0e94b9fe7569", + "remaining_operational_rows": { + "jobs": 0, + "outbox": 0, + "job_unknown_closures": 0, + "execution_permits": 0, + "operations": 0, + "approval_requests": 0, + "operation_submissions": 0, + "operation_plans": 0 + }, + "later_separate_attempt": { + "job_id": "5007cbd9-eae3-42ac-9de0-9f439eee96a2", + "state": "expired", + "grants": 0 + }, + "windows_guest_cleanup": { + "old_attempt_projection_rows_removed": 11, + "expired_attempt_rows_removed": 1, + "grantless_outbox_rows_removed": 1 + }, + "device_checkins": [ + { + "agent_id": "63ea15b2-0643-403d-b5b4-cba1288dbea3", + "transport": "https", + "sync_ready": true, + "helper_sync_ready": true, + "last_contact_at": "2026-11-17T14:59:08.459594+00:00" + }, + { + "agent_id": "e9d85af1-067f-4cbe-a547-3a63b70a8d2e", + "transport": "https", + "sync_ready": true, + "helper_sync_ready": true, + "last_contact_at": "2026-11-17T14:58:52.416681+00:00" + } + ], + "linux_capture_conversion": { + "obsolete_unapplied_captures_removed": 81, + "roundtrip_verified_rows": 3961, + "before_free_pages": 51, + "after_free_pages": 113176, + "quick_check": "ok", + "live_readback": { + "checkpoint": 4072, + "fault": false, + "free_pages": 111878, + "page_size": 4096, + "distinct_snapshot_tails": 23 + } + }, + "deployed_script_server": { + "revision": "689f326460c02c5c589340c7573499ed84a725d1", + "server_sha256": "f9109fef590359acb230ee0d327804ee0a460f38e4c7ef6347f9b059937f2cfa", + "web_index_sha256": "6bce41bfe66532e7c43dd20e023dea70a11939f0fbba71da0577df559b0481f5", + "image": "sha256:da294995da2d597442a637997fd6cdd0aa4836c90494bb7d97662d5bf2a1ca2b", + "api_health": "ok", + "gateway_health": "ok" + }, + "server_migration": 23 +} diff --git a/docs/evidence/linux-public-installer-update-20261117.json b/docs/evidence/linux-public-installer-update-20261117.json new file mode 100644 index 0000000..31dfbf0 --- /dev/null +++ b/docs/evidence/linux-public-installer-update-20261117.json @@ -0,0 +1,77 @@ +{ + "observed_at": "2026-11-17T15:07:26.238979+00:00", + "installation": "Fresh product identity on existing native cloud Linux VM; regular public HTTPS install script; private WebUI one-time token", + "source_server": "7fd17272d564569cb86dc73c8f2c388314550a9c", + "initial": { + "version": "0.1.0-mvp.1", + "release": "7bc185cc-b7a8-41de-85e8-771270c7aafb", + "agent_id": "dda2c891-40ca-4546-a928-c6dd85fe5cdb", + "asset_id": "7e79b1e8-a797-4480-b04d-5179bcc14218", + "observed_first_contact": "2026-11-17T15:01:31.882108+00:00" + }, + "script": { + "name": "Linux-Kernelversion", + "revision": "35d25133-c184-4d6b-8e32-58d71ee898e8", + "plan": "0428d05d-26f3-4cae-8ae7-2a7b30a8ab50", + "plan_hash": "395f5744e6d175eea4f31edd5d3388212e286ea1563c6d56f12289d0bd811d64", + "job": "9422e0c5-30ad-4393-adf7-1529eef249a9", + "attempt": "7d0ce155-75f2-420c-a5aa-7fb446bec7a0", + "job_payload_hash": "b9f917efb83621812971b06dfb7ace74e72a191a4350df1e3b7db558eda4478e", + "agent": "dda2c891-40ca-4546-a928-c6dd85fe5cdb", + "asset": "7e79b1e8-a797-4480-b04d-5179bcc14218", + "operation": "68bd3d2d-1441-4d30-9993-e15dc99a5483", + "preapproval_job_count": 0, + "approval": "dev_test_browser_simulation", + "approved_at": "2026-11-17T15:02:36.854Z", + "ui_result": true, + "stdout": "Linux 6.8.0-149-generic\n", + "observed_at": "2026-11-17T15:02:53.676Z", + "final": { + "state": "succeeded", + "revision": 2, + "exit_code": "0" + }, + "mcp": { + "state": "succeeded", + "operation": "68bd3d2d-1441-4d30-9993-e15dc99a5483", + "job": "9422e0c5-30ad-4393-adf7-1529eef249a9", + "attempt": "7d0ce155-75f2-420c-a5aa-7fb446bec7a0", + "job_count": 1, + "exit_code": 0, + "stdout": "Linux 6.8.0-149-generic", + "output_truncated": false + } + }, + "automatic_update": { + "version": "0.1.0-mvp.2", + "release": "1a28f955-6ca4-45fb-a624-92e7dd82c6b7", + "agent_id": "dda2c891-40ca-4546-a928-c6dd85fe5cdb", + "asset_id": "7e79b1e8-a797-4480-b04d-5179bcc14218", + "sha256": { + "agent": "1a6275fe38af039b2e185beed220c58e457bec3c995f0a6fc77a900620c7dceb", + "helper": "6298474ed1ba4684587d74a3aee1b1300c6c67dbd99459dd7874f592c1cfd6fe" + }, + "agent_exe": "/opt/rust-discovery-client/releases/1a28f955-6ca4-45fb-a624-92e7dd82c6b7/agent", + "timer": "active", + "update_result": "success", + "update_time": "Tue 2026-11-17 15:06:53 UTC" + }, + "server_after": { + "agent_id": "dda2c891-40ca-4546-a928-c6dd85fe5cdb", + "asset_id": "7e79b1e8-a797-4480-b04d-5179bcc14218", + "enrollment_generation": 1, + "transport": "https", + "reported_agent_version": "0.1.0-mvp.2", + "sync_ready": true, + "last_contact_at": "2026-11-17T15:06:51.791299+00:00" + }, + "https_installer_repeat": { + "previous_lifecycle": "4d8e20ffba79787a01924cc81df2c9f21daab8c3b6d4b2bb494e354871c687bd", + "new_lifecycle": "4d8e20ffba79787a01924cc81df2c9f21daab8c3b6d4b2bb494e354871c687bd", + "identity_unchanged": true, + "stable_updater_and_config_unchanged": true, + "timer": "active", + "agent": "active", + "gateway_source": "95aa70766b21d121c7d782a70b07bba559185d53" + } +} diff --git a/docs/evidence/product-audit-20261117.json b/docs/evidence/product-audit-20261117.json new file mode 100644 index 0000000..960583c --- /dev/null +++ b/docs/evidence/product-audit-20261117.json @@ -0,0 +1,190 @@ +{ + "date_utc": "2026-11-17", + "scope": "Current dev/test topology. Operational observations are read-only. Separate developer tool checks record actual build/staging writes.", + "source_commit": "a576c10e8afde796d2b1e14eb9d01f89df7fea67", + "baseline_worktree": { + "tracked_paths_modified": 22, + "untracked_nonignored_paths": 39 + }, + "server": { + "sample_utc": "14:01–14:04", + "roles": { + "api": "running", + "gateway": "running", + "postgres": "running" + }, + "api_and_gateway_image": "sha256:6d60364a6d3e9c06d86ca61a2694fc1692f84bcbbebd564f5353e8c7093acaa7", + "published_ports": { + "api": "127.0.0.1:18443", + "gateway": "127.0.0.1:18444", + "postgres": [] + }, + "latest_successful_sqlx_migration": 22, + "https_localhost_verified": { + "/": 200, + "/healthz": 200 + }, + "mcp_releases": { + "tool": "updates.list_releases", + "tenant": "development A", + "as_of": "2026-11-17T14:02:38.260077983Z", + "completeness": "complete", + "count": 0 + } + }, + "inventory": { + "tool": "inventory.list_devices", + "as_of": "2026-11-17T14:03:47.782704512Z", + "scope": "current two test clients; two revoked historical devices excluded", + "items": [ + { + "source_id": "linux.base", + "quality": "valid", + "presence": "online", + "observed_at": "2026-11-17T14:03:01.347Z", + "last_contact_at": "2026-11-17T14:03:35.542645Z" + }, + { + "source_id": "windows.base", + "quality": "valid", + "presence": "unreachable", + "observed_at": "2026-11-17T13:33:52.784Z", + "last_contact_at": "2026-11-17T13:38:59.474085Z" + } + ] + }, + "linux": { + "systemctl_show": { + "rmm-agent-remote.service": "active", + "rmm-helper-cloud.service": "active", + "rmm-full-maintenance-helper.service": "active", + "rmm-agent-updater.service": "inactive", + "rmm-apt-helper.service": "inactive" + }, + "earlier_copy_probe": { + "source": "docs/evidence/linux-journal-capacity-native-20261117.json", + "source_sha256": "bab4229227b7f8f830c0e36a22110d2717ca88dbe76a33ee69cb46d479c1c9ab", + "sample_utc": "2026-11-17T09:42:47.566967+00:00", + "baseline_pages": 262138, + "runtime_contract_pages": 262144, + "additional_pages": 35, + "shortfall_pages": 29, + "page_size": 4096, + "copy_rollback_byte_identical": true, + "valid_new_sync": false, + "failure": { + "sqlite_code": 13, + "stage": "insert_capture" + } + } + }, + "windows": { + "ssh_and_process_query_utc": "2026-11-17T14:01:41.9745393Z", + "installed_build": "Windows GNU development pair; matched against artifacts.sha256 of the a576c10 install build", + "services": { + "RmmDiscoveryWindows": { + "state": "Running", + "process_image_sha256": "11a386600d449196899f2245881aa82c5a8d4288a0172e16d536b977212ea2eb" + }, + "RmmDiscoverySystemHelper": { + "state": "Running", + "process_image_sha256": "3d5140740c7008888630a5339d4d59cf27e384f5377de8a006310e3b2a88cb35" + } + }, + "earlier_job": { + "job_id": "7d756c34-3506-4545-8ecd-0e94b9fe7569", + "state": "closed_unknown", + "revision": 3, + "effect": "unknown", + "start_reserved": true, + "permits": 1 + }, + "later_job": { + "job_id": "5007cbd9-eae3-42ac-9de0-9f439eee96a2", + "attempt_id": "71cac8a6-e500-4b8a-93b4-cb805683ada3", + "state": "expired", + "revision": 0, + "has_result": false, + "start_reserved": false, + "permits": 0, + "preceding_observations": [ + { + "state": "accepted", + "at_utc": "2026-11-17T13:39:13Z" + }, + { + "state": "expired", + "at_utc": "2026-11-17T13:48:15Z" + } + ], + "result_source_path": "devstate/windows-closure-pair/system-test/actual-job-result.json", + "sha256_of_source": "add18146490687d6d56c87fd4fe50d4be6d53a2ed05cfdde5bebb109adfd3af0" + }, + "installed_build_receipt": "devstate/windows-closure-pair/20261117T132858Z-a576c10/artifacts.sha256" + }, + "methods": [ + "Pinned development SSH. Docker inspect of role/status/image/ports; systemctl show of deployed units; selected Windows services and on-guest hash of their process image files.", + "Loopback HTTPS with CA and hostname verification. Authenticated MCP jobs.get, inventory.list_devices, updates.list_releases. Read-only SELECT of max successful SQLx migration and reservation/permit counts for the two scoped job attempts.", + "Older copy probe and job timeline are identified by their original reports. There was no browser approval, device enrollment, RMM job execution or deployment of product services in this audit." + ], + "dev_tools": { + "local_release_builds": { + "linux-x64": { + "target": "x86_64-unknown-linux-gnu", + "builder": "sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6", + "manifest_sha256": "07e70e87dd26fb25d48774ce01a080fa4c755ff418dbd8c1e57a27e166305c61", + "binaries": { + "rmm-agent": "b4b7b285b8c71e4c33a92d7abe335fad176a8de04f24a13f10d1373d1d577b27", + "rmm-privileged-helper": "a4e4fba29b0e3b0bec0bda5f8d35f8664412d8ab296373513b063d823d8f8a95", + "rmm-agent-updater": "6468a676e7621397c9d9b1b25a26e30b86788ed31a56aa2331d730d39968020d" + } + }, + "windows-gnu-x64": { + "target": "x86_64-pc-windows-gnu", + "builder": "sha256:1b2fd985d2c1fcc3545ace602405dc68fa899201bd8a73fa319ff96377203fa9", + "manifest_sha256": "144c54179ff4383e4ac276c28e24a6e929f71f46e2dd2aa2516fe0732c457ea2", + "binaries": { + "rmm-agent-windows.exe": "b4de2bddc579279e597b167b8487dea2075ec1b67131771653e25fd92dc09ce8", + "rmm-helper-windows.exe": "ea8095a74e20476d0a8a5fa57353b97a9e660018ecfe8603b546129a3d149af2" + } + } + }, + "ssh_staging_smoke": { + "file": "rust-toolchain.toml", + "sha256": "b9c8d2d59f6f46474c0cfa0b8b77bea21d94fc73a30ad93d5bf6385c422197d2", + "targets": [ + "server", + "linux", + "windows" + ], + "first_transfer": "remote file hash verified", + "second_transfer": "each target reported existing file verified", + "destination": "rmm-dev-stage// in developer SSH user's profile" + }, + "web_build": { + "command": "npm --prefix web run build -- --outDir ", + "typescript": "passed", + "vite": "7.3.8", + "index_html_bytes": 369, + "asset_files": 2, + "deployed": false + }, + "native_server_build_via_ssh": { + "target": "aarch64-unknown-linux-gnu", + "source_commit": "a576c10e8afde796d2b1e14eb9d01f89df7fea67", + "builder": "sha256:30ae3d90753bc39b0a98a897784c662aff9598ffab7a98a6298e8aa79145c2ec", + "manifest_sha256": "408acb5a25ea296993323372eac66e5422474cad95b71a9cb7904d41b1de6cf5", + "binaries": { + "rmm-server": "f087545e4f8d203e44ee55749a7f6d1515d6333193b791513d564a43ce6e3bf2", + "rmm-time-broker-linux": "cde87cc9700ff79bd17f3c47cf6c4062be1e413223e42bf263b44655ae8d7c5f" + }, + "verified_binary_format": "ELF64/AArch64", + "cargo_cold_seconds": 426, + "cargo_cached_seconds": 0.52, + "cache_run_artifacts_identical": true, + "isolated_build_directory": "~/rmm-dev-build/server-arm64", + "api_gateway_postgres_started_before_build": true, + "deployed": false + } + } +} diff --git a/docs/evidence/script-library-acceptance-20261117.json b/docs/evidence/script-library-acceptance-20261117.json new file mode 100644 index 0000000..6295bac --- /dev/null +++ b/docs/evidence/script-library-acceptance-20261117.json @@ -0,0 +1,78 @@ +{ + "server_revision": "689f326", + "date": "2026-11-17", + "tenant": "11111111-1111-4111-8111-111111111111", + "environment": "development", + "channel": "client pull", + "approval_origin": "dev_test_browser_simulation", + "testsimulation": true, + "principal": "simulated-testprincipal-a", + "foreign_tenant_read": "MCP scripts.list: NOT_FOUND", + "windows_update_installed": false, + "platforms": { + "linux": { + "name": "Linux-Kernelversion", + "revision": "35d25133-c184-4d6b-8e32-58d71ee898e8", + "v2_revision": "8158f3a1-8950-4076-a20f-d5259cf34973", + "plan": "b7aaa2b2-6e35-447f-9bdb-73209117e18e", + "plan_hash": "b45b107b093f2ac1ceeaa9d10bf14a977496e2450519601e0eef82d6fbb449a6", + "operation": "fecc2258-c2d3-4e3f-832b-316c13c1018a", + "job": "e0d033ae-7c5b-4489-af27-cef8bbd639d7", + "attempt": "1b160909-3d58-43c1-bb1e-094647ecda5b", + "job_payload_hash": "480e63176d2d2b4eef251c5e95569ee97c1f1837bf89fb915443b762e28710d0", + "script_sha256": "1a3f1937011f3a0040587f42b61097843aa54c616ed1e02b7f1856446c70ac94", + "agent": "e9d85af1-067f-4cbe-a547-3a63b70a8d2e", + "asset": "30aad079-86b3-41f2-a1e9-34275e7c08fc", + "preapproval_job_count": 0, + "approved_at": "2026-11-17T14:56:52.629Z", + "observed_at": "2026-11-17T14:57:28.885Z", + "selected_version": 1, + "later_saved_version": 2, + "execution_identity": "agent_service", + "webui_exit_code": 0, + "webui_stdout": "Linux 6.8.0-149-generic\n", + "mcp_result": { + "state": "succeeded", + "operation": "fecc2258-c2d3-4e3f-832b-316c13c1018a", + "job": "e0d033ae-7c5b-4489-af27-cef8bbd639d7", + "attempt": "1b160909-3d58-43c1-bb1e-094647ecda5b", + "job_count": 1, + "exit_code": 0, + "stdout": "Linux 6.8.0-149-generic", + "output_truncated": false + } + }, + "windows": { + "name": "Windows-PowerShell-Version", + "revision": "2210624c-35d1-41c8-88ee-1860713bbce4", + "v2_revision": "df09a5e4-0a98-4703-a8c3-115d0af1a168", + "plan": "fcdfe359-d03d-4091-b61b-a3737caaf700", + "plan_hash": "3912c974959da33bd48db759e58efd0b6769ce62598089fe29d6dbbcb18f794c", + "operation": "240f2a4b-b5a7-4fdc-ae16-be192835f9ce", + "job": "5b3c6eea-2284-41c4-8ec0-f0b75fda4a98", + "attempt": "066e14a6-b2f5-4807-af04-d10aab1e764e", + "job_payload_hash": "7ab839b73465421e38f297dd49858481715be89593be516da548cea756ea1495", + "script_sha256": "ffdd3092924274b8150fe059537f62b3bac4fa5b75344c978193b9fd1d029abc", + "agent": "63ea15b2-0643-403d-b5b4-cba1288dbea3", + "asset": "a176520e-8a91-4e93-a78b-8e7620f430e0", + "preapproval_job_count": 0, + "approved_at": "2026-11-17T14:56:52.620Z", + "observed_at": "2026-11-17T14:57:08.730Z", + "selected_version": 1, + "later_saved_version": 2, + "execution_identity": "agent_service", + "webui_exit_code": 0, + "webui_stdout": "PowerShell 5.1.26100.9818\\u000d\n", + "mcp_result": { + "state": "succeeded", + "operation": "240f2a4b-b5a7-4fdc-ae16-be192835f9ce", + "job": "5b3c6eea-2284-41c4-8ec0-f0b75fda4a98", + "attempt": "066e14a6-b2f5-4807-af04-d10aab1e764e", + "job_count": 1, + "exit_code": 0, + "stdout": "PowerShell 5.1.26100.9818", + "output_truncated": false + } + } + } +} diff --git a/docs/evidence/windows-https-release-20261117.json b/docs/evidence/windows-https-release-20261117.json new file mode 100644 index 0000000..b279e50 --- /dev/null +++ b/docs/evidence/windows-https-release-20261117.json @@ -0,0 +1,167 @@ +{ + "utc_date": "2026-11-17", + "windows_guest": "win11-test", + "architecture": "x86_64-pc-windows-gnu", + "bootstrap_origin": "https://discovery.ease-technologies.de:8443", + "gateway_origin": "https://discovery.ease-technologies.de", + "baseline": { + "bootstrap_script_sha256": "d8a4fb1afa01a388a98a752be50e3c5241a7ee085eb9620e7633ec127b204d9e", + "fresh_agent_directories_and_service_absent": true, + "device_identity_generated_on_guest": true, + "https_enrollment_token_consumed": true, + "release_updater_sha256": "ed21b27da69147db8f25ceb6ceb915c8f807ab55bffccddcd0b472e222930f51", + "service_account": "LocalService", + "update_poll_interval_seconds": 300, + "installer_platform_parameter": "x86_64-pc-windows-gnu", + "host_preparation": "Windows 11 test guest, prior RMM services and device state parked. No OS reinstall." + }, + "native_and_mcp": [ + { + "native": { + "utc": "2026-11-17T15:05:38.6968939Z", + "release": "ee24857f-eb37-49ad-b647-4eafcd1ec78a", + "sequence": 1, + "version": "0.1.0", + "hash": "35b068b3d0ad579e480ac6897b0f514f94fa57f5631bd3c0188bede2a03e95b1", + "agent": "Running", + "updater": "Running", + "updater_outcome": "ok", + "updater_detail": null, + "updater_checked": "2026-11-17T15:04:51.671507300Z", + "intent": false + }, + "mcp": { + "asset_id": "8387cba0-3bf9-4fea-a8ab-98da3fcf6de2", + "agent_id": "1626b5a3-6178-4410-bf6c-d902f9a126f9", + "presence": "online", + "source_id": "windows.base", + "observed_at": "2026-11-17T15:04:51.383Z", + "last_contact_at": "2026-11-17T15:05:19.408313Z", + "quality": "valid", + "agent_version": "0.1.0", + "gnu_capability": true + } + }, + { + "native": { + "utc": "2026-11-17T15:10:41.6367066Z", + "release": "66035bf8-5a8c-4316-b857-4b1fac15f053", + "sequence": 2, + "version": "0.1.1", + "hash": "8d1f5970c26fd5fff4ea8289b0e18ca37e2a0ba7facc92d6d4d862a4429abd4f", + "agent": "Running", + "updater": "Running", + "updater_outcome": "ok", + "updater_detail": null, + "updater_checked": "2026-11-17T15:10:11.354503300Z", + "intent": false + }, + "mcp": { + "asset_id": "8387cba0-3bf9-4fea-a8ab-98da3fcf6de2", + "agent_id": "1626b5a3-6178-4410-bf6c-d902f9a126f9", + "presence": "online", + "source_id": "windows.base", + "observed_at": "2026-11-17T15:10:07.967Z", + "last_contact_at": "2026-11-17T15:10:38.156442Z", + "quality": "valid", + "agent_version": "0.1.1", + "gnu_capability": true + } + } + ], + "verifier_negative_control": { + "verified_unmodified_exit": 0, + "modified_one_byte_of_helper_copy_exit": 1, + "active_sequence_after_check": 2, + "active_service_after_check": "Running" + }, + "job_capable_fresh_install": { + "installer_sha256": "11883aa9558d06fde0b3d48e6f8db03990c2425ba0ecc0513bad0ee1322f6944", + "released_minimum_updater_version": 2, + "stable_sha256": "333cf84c1594ac0d44951aa4141635afdd9b3f1bdb5f2d8b701d384c0abc93e3", + "release_sequence": 3, + "prerequisite_check_on_windows": { + "previous_stable_v1_exit": 1, + "current_stable_v2_exit": 0 + }, + "fresh_service_and_roots_confirmed": true, + "enrollment": { + "result": "Enrolled Rust Discovery agent 0.1.2 over HTTPS.", + "asset_id": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "tenant": "11111111-1111-4111-8111-111111111111", + "release_id": "6b695fec-69c6-4f87-b5ab-e405b93a1a7f", + "release_sequence": 3, + "manifest_sha256": "243ba0a9301e0c7ec79f24ba23291fe2dc4531990c117ef6958325c74eac49f8", + "agent": "Running", + "updater": "Running", + "token_consumed": true + }, + "client_samples": [ + { + "native": { + "utc": "2026-11-17T15:23:22.7327727Z", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "asset_id": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8", + "sequence": 3, + "running_version": "0.1.2", + "hash": "ec10702700e79ee875d6485c5324fa5091cd79d84c689a0263c7ce2059a686f6", + "service": "Running", + "account": "NT AUTHORITY\\LocalService", + "job_mode": true, + "trusted_clock": true, + "utc_clock": true, + "clock_failure": "", + "ready": true, + "helper_ready": false, + "generation": 1, + "needs_sync": false, + "counts": { + "accepted": 0, + "requesting": 0, + "running": 0, + "verifying": 0, + "unknown": 0, + "awaiting_reboot": 0, + "events": 0, + "legacy_events": 0 + }, + "diagnostics": [], + "updater": "Running", + "updater_result": "error", + "updater_detail": "Query returned no rows", + "updater_checked": "2026-11-17T15:23:12.670034600Z", + "intent": false + }, + "mcp": { + "asset_id": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "presence": "online", + "source_id": "windows.base", + "observed_at": "2026-11-17T15:23:15.155Z", + "last_contact_at": "2026-11-17T15:23:15.282196Z", + "quality": "valid", + "agent_version": "0.1.2", + "powershell": true, + "sync": true, + "gnu": true + } + } + ], + "initial_updater_read": "Before the agent had initialized its TLS selector the first scan returned no rows. The release service stayed running and retained its periodic timer.", + "installer_wait_revision": { + "script_sha256": "fc8ee7e94e8f4e2a7617f2c8bfbc4304661f34d1148bcb6225c056ba77a5d570", + "purpose": "Start the release service after this agent's authenticated ClientHello.", + "powershell_parse_errors": 0, + "native_existing_contact_checked": true, + "installer_rerun_preserved_identity_and_updater_pid": true + }, + "local_job_journal": { + "job_id": "99ff0463-87f1-4a3f-9b35-ca2615b09320", + "consumed_grants": 1, + "completed_execution_outcomes": 1, + "terminal_state": "succeeded", + "outcome_revision": 2 + } + } +} diff --git a/docs/handover.md b/docs/handover.md index 75d5a13..4d7a09f 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -1,192 +1,9 @@ -# Übergabe an die nächste AI +# Übergabe am 17. November 2026 -Stand: 17. November 2026, 09:38 Uhr MEZ. Diese Datei ist der aktuelle Einstieg. -Die vorherige 1289-Zeilen-Chronik ist vollständig im -[historischen Archiv](handover-history-through-20261116.md) erhalten. -Zeiten hier MEZ; Originalbelege behalten ihre UTC-Zeitstempel. +**Der nächste Auftrag steht im [Umsetzungsplan](mvp-completion-plan.md).** Er enthält den letzten Betriebsbefund je Nutzeranforderung und die Reihenfolge für die nächste Lieferung. [Entwicklungsbefehle](development.md) und [Zugänge](operations-access.md) beschreiben den Arbeitsweg. -## Auftrag und verbindlicher Rahmen +Die ausdrücklich zur Löschung benannte Entwicklungsanfrage ist entfernt. Beide registrierten Testgeräte laufen über HTTPS-Polling. Den Bereinigungs- und Journalnachweis sowie die aktiven Buildrevisionen im [Lieferplan](mvp-completion-plan.md) verwenden. Die [frühere Bestandsaufnahme](evidence/product-audit-20261117.json) zeigt den Zustand vor der Bereinigung. -Der letzte Auftrag ist **Dokumentation und Prüfung der Zugangswege** für eine -andere AI auf **demselben PC**. Dabei wurden keine Builds, Code-/Abnahmetests, Deployments, -RMM-Jobs, Genehmigungen, Neustarts oder Zugangserneuerungen gestartet. -Eine frühere Frage zur neuen Risikoausnahme ist **nicht beantwortet/freigegeben**. -Aus dieser Übergabe folgt keine Zustimmung dazu. +Bei der Bestandsaufnahme auf `main` bei `a576c10` waren **22 versionierte Dateien geändert und 39 unversioniert**. Darunter sind Windows-Updater, MSVC, Reboot und Linux-Journaldiagnose. Vor jedem Bau den vorgesehenen Quellstand auswählen. Der Arbeitsbaum enthält Implementierungen und Belege, die ein Checkout dieses Commits allein nicht enthält. -Bei Übernahme zuerst diese Datei und die [Zugangsanleitung](operations-access.md) -lesen. Vor technischen Entscheidungen anschließend vollständig lesen: -[AGENTS.md](../AGENTS.md), [Spezifikation1.30](../Rust_RMM_Implementierungsspezifikation.md), -[Projektentscheidungen](project-decisions.md) und [Entwicklung](development.md). -Der [MVP-Abschlussplan](mvp-completion-plan.md) enthält die restlichen Schritte; -seine datierte Auditmatrix und ältere Meldungen sind historische Stände. - -- Notebookhost ausschließlich Entwicklung; dort keinen RMM-Server/Client starten. -- Endgültiger Server discovery.ease-technologies.de /88.99.80.202. -- Linuxclient ausschließlich bestehende Cloud-VM 116.203.20.85. -- Windowsclient bestehender KVM-Gast win11-test auf diesem Notebook. -- WebUI/MCP nur Serverloopback über SSH; kein OIDC für diesen MVP nötig. -- Alle Jobs beginnen pending_approval. Keine direkte API-/DB-Genehmigung. - Tatsächliche sichtbar simulierte dev/test-WebUI-Interaktionen sind ausdrücklich - erlaubt; Audit muss die Simulation korrekt ausweisen. -- Unknown nicht löschen, umdeuten oder blind wiederholen. Keine neue Identität - und kein Reenrollment als Reparatur. Alte Signaturen und Originaljournale erhalten. -- Keine neuen Features oder breite Testserien. Zuerst den offenen S2-Schritt; - nach jedem tatsächlichen Abnahmeschritt eng committen und nach Gitea pushen. - -## Was tatsächlich abgeschlossen ist - -**S0:** Reproduzierbarer enger Quellenstand ist in Gitea. Codecheckpoint -0733be2736eeb24ff4c3425d8a5433dedd1b8fc8 enthält zusätzlich den notwendigen -Vorwärtspatch für tatsächlichen Ausführungskontext und begrenzte Fehlerdaten. -HEAD kann danach zusätzliche reine Dokumentationscommits enthalten. -Strenges Windows-GNU-All-target-Clippy bestanden; dieser neue Code wurde -**nicht als Release gelinkt, auf der VM installiert oder per Job abgenommen**. - -**S1 / alter Fall 221:** Historienerhaltend nativ angewandt und unabhängig -verifiziert; danach regulärer frischer Abgleich. Originalunknown bleibt erhalten, -abgeleiteter Abschluss failed/Revision 3. Heute auf dem Server erneut als -failed3 gelesen. Alter Job94047873-5088-433b-bc1b-490d3eafe0da / -Grant97e705b8-fb2b-4158-84d9-d90595d1ce6e. -[Abschlussbeleg](evidence/windows-system-nonstart-221-closed.json). - -**S2-Teile:** Korrigiertes Paar und Profil 9 installiert, eigene Zeitbelege, -authentisierter Helperpeer und regulärer SignedSync beider Rollen nativ belegt. -Neuer fester MCP-Antrag und tatsächliche WebUI-Genehmigung bestanden, -vor Genehmigung 0 Jobs / Outbox / Grants. Dies ist **keine erfolgreiche SYSTEM-Abnahme**. - -## Der aktuelle Blocker: neuer Auftrag, dauerhaft Unknown - -| Bindung | Wert | -| --- | --- | -| Antrag | 8c3373c6-90e8-4f5b-b3d6-719ace8e657b | -| Plan | 7c5c2fb1-63d4-413c-ad89-6d033f2bf057 | -| Planhash | 0f03ec4a4ed46c845bd211b735558f9bee9649ada8ad8f1d3eebb8d83b4c9e08 | -| Neuer Job | 7d756c34-3506-4545-8ecd-0e94b9fe7569 | -| Versuch | 4dd91fa7-f04d-4a9d-8143-b7f69d9e0680 | -| Grant, niemals wiederholen | 89226940-dcf5-4647-8707-9fea48940027 | -| Windows-Agent | 63ea15b2-0643-403d-b5b4-cba1288dbea3 | -| Asset | a176520e-8a91-4e93-a78b-8e7620f430e0 | -| Tenant | 11111111-1111-4111-8111-111111111111 | - -Heute zentral weiterhin unknown / Revision 2. Die letzte native Nachlese vom -16. November, 23:45MEZ beweist in **beiden Originalledgern** denselben Unknown (199 Bytes) -SYSTEM_SCRIPT_EFFECT_UNRESOLVED und consumed.result=NULL. -Hash 1f284b66578d61c4364cc0060a67ce9b467e1d661ed8885804391b51a6f18b1a. -Der Intent may_have_dispatched spiegelt genau diesen Unknown. -Es fehlt kein bloß später hochzuladender Erfolg. Die Kontrollköpfe waren dabei -gemeinsam auf Entscheidung 558407ec…/ Generation 357, ohne Fault/pending_request. -Das ist der letzte native Befund, **keine heutige Gast-DB-Abfrage**. - -Die Runtime verwarf den eigentlichen Fehler mittels result.unwrap_or_else. -Weder konkrete Ursache, erfolgreicher Prozess noch Nichtstart sind retrospektiv -belegt. Gleicher Sammelcode/Hash wie221 beweist keine gleiche Ursache. -Die alte 221-Quittung ist ausdrücklich auf einen anderen Grant gebunden. -[Originalbefund](evidence/windows-system-script-original-unknown.json) · -[Gesamte S0–S2-Ergebnisse](windows-system-s0-s2-results.md). - -[Neuer Risikoausnahmevorschlag](windows-system-unknown-357-decision.md): -**nur Vorschlag, keine Userentscheidung und nicht implementiert**. -Eine andere AI darf ihn nicht allein aufgrund seines Vorhandenseins anwenden. -Der Vorwärtspatch 0733 ändert oder heilt diesen alten Unknown ebenfalls nicht. - -## Quellenstand, installierter Stand und WIP auseinanderhalten - -Zuletzt nativ installierter Stand: Git052456f1339d23c7f705619151938801576e90b3, -GNU-Entwicklungsbuild, kein MSVC-Release: - -| Bestandteil | Letzter nachgewiesener SHA256 | -| --- | --- | -| Agent | 437a2aa044ef2670674527b70da6f402871f1c931218557f8713a0ff0f4cc751 | -| SYSTEM-Helper | 744dd4e6fd6027cde3f9b7c1f0bbccee9ebbd13a3dd378335e53f1e7af68817e | -| Profil 9 | 587623c31d13300fbe792784a4e61eec14638cb6800937a8f06f47d9ee330f54 | -| Aktive Agentconfig | 5cd4cb9802d0dd20b961de7e3cd4e5874a1e9a72fc57b577e075e2d2918baac6 | -| Lokale Skriptpolicy | a65ca9de25d2a3269802a4877874947c76ee8b257adc5ff93a2f545b2797cf3e | - -Beide Dienste zuletzt am16. November, 23:06MEZ Running/Auto nachgewiesen: -RmmDiscoveryWindows als LocalService, RmmDiscoverySystemHelper als SYSTEM. -Heute wegen fehlendem SSH-Tunnel **nicht erneut im Gast verifiziert**. -Zentrale begrenzte Testpolicy seit16. November, 23:23:25MEZ abgelaufen; -nicht still erneuern. Bisherige Genehmigungen erlauben keinen neuen Testversuch. - -Vor den heutigen Dokumentänderungen: **53 fremde/offene WIP-Pfade** -(20 verändert, 33 unversioniert), vor allem Updater/Lifecycle/Reboot/MSVC. -[Exaktes Inventar](evidence/ai-handover-worktree-20261117.json). -Kein git add -A, Reset, Clean oder Build aus der gesamten Arbeitskopie. -Die drei Quellen process.rs/system_script.rs/helper_system.rs des0733-Commits -sind reproduzierbar; helper_system.rs hat zusätzlich weiter getrennten WIP. -Für einen später beauftragten Build einen Git-Archivstand isolieren. - -## Heute tatsächlich geprüfte Erreichbarkeit - -[Zugangsbeleg17. November](evidence/ai-handover-access-20261117.json). - -- Server: neue strikt gepinnte SSH-Verbindung erfolgreich. API/Gateway/Postgres - Running; Migration 21, global36 Jobs / 36 Outbox / 31 Grants. API/Gateway weiter - Image f0f3b791… und nur127.0.0.1:18443/18444; Datenbank ohne publizierten Port. - Temporärer eigener SSH-Forward: TLS-Kette/Name gültig, healthz200, - unauthentisiertes MCP-GET401. Zusätzlich authentisierter MCP-Leseaufruf - jobs.get: neuer SYSTEM-Job weiterhin unknown/Revision2. Kein Browserlogin, - neuer Plan, Submit oder Approval. -- Cloud-Linux: neue Schlüssel-SSH-Verbindung erfolgreich. Agent, Generalhelper - und Fullmaintenancehelper Running; Updater/APT inaktiv. Fullhelper geladen, - aber disabled. Keine Dienständerung. Historische Linux M0–M5-Abnahme bleibt - getrennt von der zuletzt gemeldeten aktuellen Journal-Kapazitätsblockade; - diese wurde heute nicht neu diagnostiziert. -- Windows: Gast Running, DHCP-Lease 192.168.122.170, libvirt-Konsole erreichbar. - Serverloopback 22240 hat **keinen Listener**; frische Windows-SSH-Verbindung - scheitert vor der Windows-Anmeldung mit Connection refused. Ursache im Gast - nicht ermittelt. Konsolenbild schwarz, kein Adminprompt bestätigt. - Keine Taste, Task-, Dienst-, Konto- oder Hostkeyänderung vorgenommen. - -## Zeit-/Betriebsannahmen nicht aus alten Dateien ableiten - -Das genehmigte Zeitprofil trusted_os_active_guest setzt aktiven KVM-Betrieb -voraus. Vor Pause, Save/Restore, Snapshot-Rückkehr, Migration oder Host-Suspend -müssen Agent und Helper beendet und danach frisch gestartet werden; dies ist -keine jetzige Genehmigung für diese Zielaktionen. Fehlende Nachweise sperren. -Alte passive agent-time-sample/helper-time-sample-Dateien sind keine aktuellen -Zeitbelege aktiver Jobprozesse. Auch job-readiness.json kann während Reconnect -veraltet sein; Datum, tatsächliche Prozesse und getrennte Peer-/Syncbelege prüfen. -Die heutige SSH-/TLS-Prüfung ist keine neue Zeit-/Jobabnahme. - -## Nächste AI: feste Reihenfolge - -1. Richtigen lokalen Checkout und geschützte Profile verwenden; die - [Zugangsanleitung](operations-access.md) enthält konkrete Befehle und Grenzen. - Fehlende Dateien in einem anderen Worktree sind kein Grund zur Neuerzeugung. -2. Vor Zielaktionen neue ausdrückliche Userentscheidungen prüfen. Die offene - Risikoanfrage ist durch den heutigen Dokumentationsauftrag nicht genehmigt. -3. Bei beauftragter Fortsetzung zuerst den **bestehenden** Windows- - Entwicklungstransport über die lokale Gastkonsole prüfen. Keine erneute - Erstinstallation, alten Wartungsfenster oder neuen Schlüssel erzeugen. - Server/Linuxzugang funktioniert; Windowszugang derzeit nicht. -4. Den Originalfall7d75 nicht erneut ausführen oder als Nichtstart interpretieren. - Nur zulässige Analyse/Vorbereitung fortsetzen, bis die zusätzliche - Entscheidungsgrenze geklärt ist. Neue Risiken nicht als alte 221-Freigabe auslegen. -5. Erst nach rechtmäßigem Abschluss des Blockers, überprüftem neuem Quellstand - und frischem Rollen-/Zeit-/SignedSync: neuer MCP-Plan, pending0/0/0, - tatsächliche dev/test-WebUI-Genehmigung und unabhängiger nativer SYSTEM-Erfolg. - Keine direkten API-/DB-Freigaben und keine Wiederverwendung alter Grants. -6. Weiterhin nur S2. MSI, MSVC-Werkzeuge, Reboot, Updater oder Linux-Journalumbau - nicht nebenbei beginnen. Bereits bestandene Nachweise nicht pauschal wiederholen. - -## Lokale Originale: auf diesem PC vorhanden, absichtlich nicht in Git - -Alle Pfade relativ zum Checkout /home/kevin/Schreibtisch/Coding/rust-discovery: - -- devstate/windows-closed-control-successor/29264503-e47b-4d0c-8dbc-a7f353446ba7/ - enthält Build-/Install-/Profil-/Policybelege, Unterordner system-policy/ die - exakten MCP-/UI-/Originalledger-/Unknownnachweise und privaten Diagnoseausgaben. -- devstate/windows-normal-control-continuation/ enthält ursprüngliche - Kontrollfixture, Linux-/Windows-Verträge und Quellbezug. -- devstate/windows-system-script-error-context/ enthält den in0733 übernommenen - Vorwärtspatch, isolierten Quellenstand und echten Clippy-/Reviewbeleg. -- devstate/windows-client/system-nonstart-221-20261116/ enthält die alten - 221-Originale, signierten Belege und SDK-Nachlese. -- devstate/windows-client/mvp-closeout-20261116/ enthält Konsolen-/Staginghelfer - und permanente SSH-Zugangsbelege; erst lesen, keine Installphase wiederholen. -- devstate/ai-handover-20261117/ enthält heutige private SSH-/TLS-/Konsolenbelege. - -Private Diagnoseausgaben können Pfade, Befehle oder Tokens enthalten: -nicht pauschal catten, loggen, committen oder in LLM-Kontexte übernehmen. -Das Archiv enthält zusätzliche historische Pfade; aktuelle Belege haben Vorrang. +Für die ursprüngliche Chronik siehe [Archiv bis 16. November](handover-history-through-20261116.md). Die Übergabe vom Morgen und der frühere S0–S7-Plan sind im Git-Stand `a576c10` unter `docs/handover.md` und `docs/mvp-completion-plan.md` abrufbar. Die datierten [Windows-Fallnachweise](windows-system-s0-s2-results.md) dokumentieren die damaligen Eingriffe. diff --git a/docs/implementation-status.md b/docs/implementation-status.md index 4be87c7..5b8a59f 100644 --- a/docs/implementation-status.md +++ b/docs/implementation-status.md @@ -1,7 +1,16 @@ # Tatsächlicher Implementierungsstand -**Aktueller Gesamtstand vom 16. November 2026:** -[MVP-Abschlussplan mit tatsächlicher Pflichtmatrix](mvp-completion-plan.md). +Der [Lieferplan](mvp-completion-plan.md) nennt den aktuellen Produktstand. Die [Bestandsaufnahme](evidence/product-audit-20261117.json) und die folgenden Einträge sind zeitgebundene Entwicklungsprotokolle. + +**Frühe Linux-S3-Diagnosesitzung, 17. November 2026:** Lesende Tabellenmessung plus explizite, +create-only Kopienprüfung implementiert; acht lokale Guards bestanden. Echter +`SQLITE_FULL` und gemessener Seitenbedarf ausschließlich an einer kleinen +synthetischen Kopie, vollständiger Byte-Rollback und unveränderte Quelle belegt. +SSH und Docker dieser Sitzung lokal mit `Operation not permitted` blockiert; +keine neue Cloudmessung, Runtimeänderung oder S3-Abnahme. +[Genauer Stand und Fortsetzung](linux-journal-capacity-diagnosis.md). + +**Historischer Gesamtstand vom 16. November 2026:** Allgemeine Windows-PowerShell bestanden; SYSTEM unbekannt/gestoppt, Linux aktuell journalblockiert, echte Agent-Selbstupdates offen. Die folgenden datierten Einträge beschreiben einzelne historische Quellstände; diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index 8cea0d9..04d44a9 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -1,400 +1,55 @@ -**Übernahme 17. November 2026:** [Kompakter aktueller Stand](handover.md), -[geprüfte Zugänge](operations-access.md). S0/S1 abgeschlossen, S2 mit -dauerhaftem neuem Unknown nicht abgenommen; Risikoausnahme nicht genehmigt. -Der Plan enthält nachfolgend auch die datierte Auditmatrix und frühere -Fortschrittsnotizen. Keine abgeschlossenen Recovery-/Installphasen erneut starten. +# Lieferplan für Skriptverwaltung, Installation und Agentupdates -**Aktueller Stand16.November22:45UTC:** S0 abgeschlossen, Fall 221 -historienerhaltend nativ abgeschlossen. Neuer S2-Job tatsächlich über MCP -beantragt und in der dev/test-WebUI genehmigt, aber beide Originalledger -enthalten einen dauerhaften Unknown. **SYSTEM-Erfolg und S2-Abnahme fehlen.** -Kein blindes Wiederholen, kein weiterer Abgleichspalt, keine neue Ausnahme -angewandt. [Maßgebliche Ergebnisse](windows-system-s0-s2-results.md). +**Stand 17. November 2026. Der frisch aufgenommene Windows-Client hat seinen Skriptauftrag abgeschlossen. Beim anschließenden Versionswechsel wird eine native Dateisperre behoben.** 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](../Rust_RMM_Implementierungsspezifikation.md) -**Aktueller Fortschritt 16.November21:51UTC:** S0 und S1 abgeschlossen. -Korrigiertes Paar437a/744d und Profil9 nativ installiert; regulärer frischer -SignedSync einschließlich Helper-ACK erfolgreich. S2 bleibt offen bis zum -neuen MCP-/WebUI-genehmigten SYSTEM-Skript mit unabhängigem Erfolgsbeleg. -[Maßgebliche aktuelle Ergebnisse](windows-system-s0-s2-results.md). -Nachfolgende Statusmeldungen und Auditmatrix bleiben datierte Historie. +## Produkt und Betriebsstand -# MVP abschließen: Status, Reihenfolge und Agentaufträge - -**S2-Folgebefund20:40UTC:** Fall 221 bleibt abgeschlossen; ein neuer reiner -Kontrollspalt nach flüchtigem Zeitfehler verhindert derzeit die nächste -Jobabnahme. [Gezielter normaler Abgleichfix](windows-closed-control-online-continuation.md) -wird umgesetzt, keine weitere administrative308-Sonderrecovery. - -**Umsetzungsfortschritt 16. November, 20:27 UTC:** S0 bestanden; S1 nativ -angewandt und separat verifiziert. S2: neues Paar passiv installiert, -Profil8 publiziert; frischer regulärer Betrieb und neuer SYSTEM-Auftrag noch -offen. [Tatsächliche Schritte](windows-system-s0-s2-results.md). -Operative Präzisierung für S2: Originale aktive Agentconfig erhaltend -wiederherstellen, Helper dabei weiter passiv; anschließend aktuelle aktive -Zeit-/Kontrollbelege prüfen. Passive Rohproben gehören nur zu ihrem eigenen -Modus und Prozess. Keine alten Prozessbelege übernehmen. -Die folgende Auditmatrix beschreibt den ursprünglichen Stand18:11MEZ. - -Stand: **16. November 2026, 18:11 Uhr MEZ**. Audit auf Quellenstand -`fe483a1570b3d5a4cbef93a004e97810a678a108` mit vorhandenem lokalem WIP. -Der aktuelle Auftrag war Bestandsaufnahme und Abschlussplanung. Dabei wurden -keine Builds, Tests, Jobs, WebUI-Genehmigungen oder Zieländerungen ausgeführt. -[Tatsächliche Leseergebnisse](evidence/mvp-status-audit-20261116.json). - -**Der erweiterte MVP ist nicht fertig.** Der begrenzte Linux-MVP M0–M5 wurde -historisch abgenommen. Windows und der zusätzlich beauftragte Agent-Selbstupdater -sind offen. Auch die heutige Linux-Betriebsbereitschaft ist blockiert. -Dieser Plan ist der aktuelle Einstieg für fortsetzende Agents. Ältere -Statusdokumente und Artefakte bleiben historische Belege, keine aktuelle Freigabe. -Normative Grundlage ist Spezifikation **1.30**, insbesondere Kapitel 0 und 25; -dieser Ablauf ändert keine Produkt- oder Sicherheitsverträge. - -## 1. Festes Ziel und ausgeschlossener Umfang - -Fertig bedeutet: Eine AI kann über MCP feste Shell-/PowerShell-Skripte und die -vereinbarten typisierten Wartungsaufträge beantragen. Erst die tatsächliche -WebUI-Genehmigung erlaubt den gebundenen Versuch, auch unter Root/SYSTEM. -Linux- und Windowsagent melden sich ausgehend mit ihrer bestehenden Identität, -Inventar und Heartbeats; Ergebnisse, Datenalter und Fehler sind nachvollziehbar. -Der ausdrücklich vorgezogene signierte Agent-Selbstupdater funktioniert auf -beiden Plattformen einschließlich des vereinbarten begrenzten Fehlerrückwegs. - -- Server: `discovery.ease-technologies.de`; Linux: bestehende Cloud-Test-VM; - Windows: bestehende Windows-11-KVM-Test-VM. Notebookhost nur Entwicklung. -- WebUI und MCP bleiben an Server-Loopback, Zugang über geprüften SSH-Tunnel. - OIDC/MFA/öffentliche Verwaltung sind keine MVP-Voraussetzung. -- Keine interaktive PTY-/ConPTY-Sitzung, kein RustDesk/Desktopsystem, - Proxmox/PBS/Cluster/Backups, HA/Restoreausbau, ARM64-Agent oder weiterer - Paket-/Distributionsprovider. Entdeckungen dafür nach `docs/post-mvp.md`. -- APT/MSI-Testpakete sind Paketverwaltung. Sie belegen **keinen Agent-Selbstupdate**. - Beliebige OS-/Kernelupdates sind keine zusätzliche Abschlussaufgabe. -- Produktionsfreigabe ist nicht behauptet: Browserfreigaben dieses MVP erfolgen - ausschließlich im erlaubten, sichtbar simulierten dev/test-Profil mit Audit. - -## 2. Historische Auditmatrix vom16.November2026, 18:11MEZ - -| Bereich | Was belegt ist | Was noch fehlt | +| Funktion | Im Entwicklungssystem nachgewiesen | Nächster Schritt oder Beleg | | --- | --- | --- | -| Server, MCP und WebUI | Reale MCP-Anträge und interaktive UI-Genehmigungen, Planbindung, Tenantgrenzen, gespeicherte Ergebnisse; API/Gateway laufen mit Image `f0f3b791…`, Migration 21. Verwaltung nur Loopback, PostgreSQL ohne veröffentlichten Port. | Konsistenter Endstand und abschließender gemeinsamer Gerätenachweis. Kein neuer Authentisierungsumbau. | -| Linux M0–M5 | Historische native Abnahmen für Enrollment/Transport/TLS, Inventar, Rootskripte, Logs, begrenztes APT-Paket, Offline-/ACK-/Crashfälle und Reboot. [Historische Matrix](mvp-gates.md). | Diese Tests nicht pauschal wiederholen. Aktuelle Betriebsblockade beheben. | -| Linux heute | Agent, General- und Fullhelper laufen. Helperledger: 262138 von maximal 262144 Seiten, je 4096 Byte, Freelist 0. Updater und APT-Helper inaktiv. | `JOURNAL_STORAGE_CAPACITY_BLOCKED`: kein frischer regulärer Abgleich; kompatible Updaterbaseline nicht qualifiziert/provisioniert. | -| Windows passiv | Enrollment, mTLS/WSS/HTTPS, Fallback, Inventar und Heartbeats nativ belegt. Dauerhafter eingeschränkter Entwicklungs-SSH funktioniert. | Agent und Helper sind aktuell **gestoppt**, ursprüngliche Images `d6302aa0…`/`0502d6c8…` weiterhin installiert. Neue Runtime und frische reguläre Rollenbereitschaft fehlen. | -| Windows allgemeine Skripte | Job `5f1ffef4-2bb6-4c7e-a3a0-fb619144b4f8`: MCP → tatsächliche WebUI → PowerShell 5.1, Exit 0, exakte Ausgabe/Unicode, LocalService-SID `S-1-5-19`, unabhängiger Einmalverbrauch. [Beleg](windows-general-script-acceptance.md). | Kein weiteres Hello World erforderlich. SYSTEM ist eine eigene offene Abnahme. | -| Windows SYSTEM | Erster genehmigter Job `94047873-5088-433b-bc1b-490d3eafe0da` ist **unknown**, Revision 2. Verzeichnissharingfehler vor dem Skriptstartpfad belegt; enger Fix gebaut. | Historienerhaltenden Fall 221 tatsächlich abschließen, korrigiertes Paar installieren, danach neuer MCP-/WebUI-Auftrag mit SYSTEM-Erfolg. Zwei administrative Anwendungen scheiterten vor Commit und wurden vollständig zurückgerollt. | -| Windows Dienste/MSI/Logs | Adapter, Verträge und einzelne native Prüfungen vorhanden; begrenzte MSI-Fixtures vorbereitet. | Echte genehmigte Dienstwirkung, MSI-Installation/Noop/Upgrade/Noop, begrenzter Eventlogauftrag und unabhängige Nachbedingungen. | -| Windows Zertifikate und dauerhafte Jobs | Quellen und native Teilprüfungen; einmalige Ausführung des allgemeinen Skripts belegt. | Tatsächliche Renewal-/Reconnect-/Widerrufsabnahme und fehlende native Redelivery-/ACK-/Offline-/Unterbrechungsfälle. Bestehende erfolgreiche Teilnachweise wiederverwenden. | -| Windows Release und Reboot | GNU-Entwicklungsbuilds laufen nativ. Zwei konkrete Gastneustarts sind genehmigt, noch nicht ausgeführt. | Wartungsneustart vor MSVC-Werkzeugen, echter MSVC-Release/Installer, anschließend eigener MCP-/WebUI-Reboottest mit Autostartnachweis. GNU nicht als MSVC ausgeben. | -| Agent-Selbstupdate | Signatur-/Katalog-/Staging-/Handoff-/Health-/Rückwegquellen und ausgewählte native Verträge vorhanden. | Noch kein vollständiger genehmigter Agentwechsel auf Linux oder Windows; Ausgangsbasis/Trust/Registry und echter Wechsel samt begrenztem Fehlerrückweg fehlen. | -| Mischplattform | Beide Geräte separat inventarisiert; Linux- und Windows-Skripte separat erfolgreich. | Ein gemeinsamer fester Plan mit richtigen Interpretern, Einzelresultaten und begrenztem Offlinefall gemäß AT-15. | +| 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](evidence/script-library-acceptance-20261117.json) | +| 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](evidence/dev-cleanup-pull-20261117.json) | +| Skriptbibliothek | Versionierte, mandantengebundene Skripte, feste Revision im Plan, WebUI und MCP. Die Windows-Update-Vorlage ist enthalten. | SYSTEM-Provisionierung auf einem neuen Windows-Client, siehe Schritt 3. | +| 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`, Windows GNU auf `0.1.1`. Prozesshash und Geräteidentität wurden nativ geprüft. | [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows](evidence/windows-https-release-20261117.json) | +| 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](development.md). | -### Weshalb die bisherige Arbeit schleifte +## Schritt für Schritt -1. Eigene Bootstrap-/Wiederherstellungsfehler erzeugten zusätzliche Runden: - PowerShell-Alias, falsche Hashannahmen, ACL-/Sharingdetails, anschließend - Materialisierung und Ereignisprojektion beim Fall 221. Diese Fehler sind - keine fehlenden Nutzerangaben und kein Grund, den Umfang zu erweitern. -2. Zwischenpaare wurden gebaut, bevor alle tatsächlich betroffenen Lesepfade - und die ursprüngliche Ereignisform gemeinsam feststanden. Mehrere gebaute - Artefakte sind deshalb bereits überholt, ohne installiert worden zu sein. -3. Quellen-/Unitfortschritt wurde zu breit berichtet. Er ersetzt weder einen - aktuellen laufenden Agenten noch eine erfolgreiche vollständige Jobstrecke. -4. Parallele Arbeit führte zu **65 lokalen WIP-Pfaden** bei Auditbeginn - (26 verändert, 39 unversioniert). Der neueste ausführbare Stand lässt sich - deshalb nicht allein aus einem frischen Gitea-Checkout reproduzieren. -5. Mehrere Statusdateien wurden als Chronik fortgeschrieben und widersprechen - als vermeintlich aktuelle Übersichten einander. Maßgeblich ist diese Matrix; - alte Nachweise bleiben mit Datum/Artefaktbindung erhalten. +### 1 · Geräte im Leerlauf und unter Pull betriebsbereit machen — auf den Testgästen nachgewiesen -## 3. Arbeitsregeln für die Abschlussstrecke +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](script-console-linux-full-results.md) und [Windows](windows-general-script-acceptance.md). -**Ein Integrator besitzt Zieländerungen, Browserbedienung und Gitindex.** -Unteragents erhalten einen der untenstehenden Aufträge und einen exklusiven -Dateibereich. Auf demselben Windowsgast keine parallelen Installationen, -Dienstwechsel, Zertifikatsänderungen oder Jobabnahmen. Lesende Prüfung und -Vorbereitung auf anderen Geräten dürfen parallel laufen. +### 2 · Ein Bibliotheksskript von der Anlage bis zum Ergebnis liefern — auf beiden Entwicklungsgeräten abgenommen -Jeder Auftrag beginnt mit: aktuelles Gate, vorhandene Belege, **genau die noch -fehlende Eigenschaft**, betroffene Dateien, nächste reale Prüfung. Er endet mit: -Implementiert / gebaut / nativ ausgeführt / abgenommen getrennt, Artefakthashes, -Ergebnis, Grenze, nächste Aufgabe. Ein Agent meldet keine geplante Übertragung -als bereits erfolgtes Staging. +„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](evidence/script-library-acceptance-20261117.json) -- Ein einziger Stand der benötigten Quellen wird vor dem Deployment festgelegt. - Keine alten privaten Snapshots ungeprüft als gesamtes Projekt übernehmen. -- Erst Voraussetzungen prüfen, dann genau benötigte Artefakte bauen. Ein - Operator-SDK-Fix allein erfordert keinen neuen Produktpaarbuild. Nach einer - echten Runtimeänderung genau ein neues qualifiziertes Paar erstellen. -- Bei Fehler zunächst Originalzustand und tatsächliche Wirkung nachlesen. - Kein automatischer Retry bei `unknown`, verlorener Antwort oder Teilcommit. - Der Integrator entscheidet anhand des Nachweises über den nächsten Schritt. -- Jeder wirkende RMM-Job muss einzeln fest in einem persistenten Antrag/Plan - stehen: `pending_approval`, null ausführbare Artefakte, tatsächliche - UI-Genehmigung, dann Ausführung. Mehrere vorab feste Jobs dürfen gemeinsam - genehmigt werden; neue Versuche und Änderungen brauchen einen neuen Antrag. - Keine direkte API-/DB-Freigabe. Ein administrativer Abschlussbeleg ersetzt - keine spätere Jobgenehmigung. -- Bestehende Userfreigaben gelten weiter. Nur eine tatsächlich neue, außerhalb - des freigegebenen Umfangs liegende Produktentscheidung wird vorgelegt; - kein erneutes Einholen bereits erteilter Zustimmung. -- Nach jedem realen Abnahmeschritt: Ergebnis und etwaigen Fehler dokumentieren, - nur zugehörige Quellen/Belege committen und **nach Gitea pushen**. Auch ein - gescheiterter Schritt bleibt ehrlich erhalten. Kein pauschales `git add -A` - auf den vorhandenen fremden WIP und keine privaten `devstate`-/Credentialdaten. +### 3 · Windows-Updates als Bibliotheksfunktion abbilden — Vorlage vorhanden, administrative Ausführung gesondert prüfen -**Testbudget:** Existierende passende Belege verwenden. Neue Tests nur für eine -geänderte notwendige Funktion, einen reproduzierten Fehler oder eine berührte -Sicherheitsinvariante. Ein gezielter Regressionstest pro Fehlerfamilie genügt, -wenn er den betroffenen Pfad tatsächlich prüft. Erforderliche Format-/Clippy-/ -Buildprüfungen auf betroffene Crates begrenzen. Kein vollständiger Testsuitenlauf -nach reinen Dokumentänderungen; keine beliebigen zusätzlichen Chaosfälle oder -Testframeworks. Tatsächliche VM-Nachweise bleiben Pflicht, können aber mehrere -zusammengehörige Kriterien in **einem** begrenzten Ablauf belegen. +„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](../crates/domain/src/windows_update.ps1) · [Laufzeitprüfung](../crates/domain/src/jobs.rs) -## 4. Schrittfolge und fertige Agentaufträge +Der Windows-Installer richtet den Agenten als LocalService ein. Zur administrativen Verwendung den SYSTEM-Helper und die Richtlinie für das konkrete Gerät provisionieren. Vor einem Einsatz die Einrichtung mit einer separat genehmigten, lesenden Identitätsabfrage prüfen. Eine tatsächliche Betriebssystemaktualisierung oder ein Neustart wurde für diese Entwicklungslieferung nicht beauftragt. -Alle nachfolgenden Handlungen sind **geplant, in diesem Audit nicht ausgeführt**. -Der aktuelle nächste Implementierungsschritt bleibt ausschließlich SYSTEM. +### 4 · Signierte Binaries zentral veröffentlichen — im Entwicklungsmandanten nachgewiesen -### S0 — Übergabefähigen Quellenstand herstellen +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](development.md) -**Status 17. November: abgeschlossen. Codecheckpoint 0733; neuer Diagnosepatch compilegeprüft, nicht installiert.** +### 5 · Über öffentliches HTTPS aufnehmen — beide Plattformen nativ aufgenommen -**Owner: Integrator, unterstützt durch Agent A (Windowskern) und Reviewer.** +Die [Linux-](https://discovery.ease-technologies.de:8443/install/linux.sh) und [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1) 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. -1. `git status` und die vorhandenen Originalbelege lesen. WIP nach notwendiger - SYSTEM-Abschlussstrecke und späterem Updater-/Lifecycle-WIP trennen. - Keine Datei löschen, zurücksetzen oder unqualifiziert mitcommitten. -2. Engen konsistenten SYSTEM-Quellenstand nachvollziehbar committen, einschließlich - notwendiger neuer Coredatei/Cargoeinträge/Operatorquellen; Agent B prüft die - tatsächlichen Abhängigkeiten. Verschobene Updaterfunktionen nicht nebenbei - in diesen Runtimewechsel integrieren. Nicht kopierbare private Belege als - notwendige Operatorinputs benennen, keine Secrets versionieren. -3. Einen Produkt-/Operatorquellenmanifest und eindeutige Artefaktrollen - festlegen. Bestehende Zwischenbuilds ausdrücklich als überholt markieren. +### 6 · Automatischen Versionswechsel auf dem Gerät prüfen — beide Plattformen nativ nachgewiesen -**Fertig:** Andere Agents können die Abschlussquelle von Gitea holen und die -benötigten Builds reproduzieren; lokale Belege bleiben separat geschützt. -Kein Zielzustand wird allein für diesen Gitabschluss verändert. +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](evidence/linux-public-installer-update-20261117.json) -### S1 — Genehmigten Nichtstartfall 221 historienerhaltend schließen +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 im gemeinsam benutzten Verzeichnis verhinderte das atomare Umschalten. Der Agent blieb unter `0.1.2` online. [Nativer Windows-Beleg](evidence/windows-https-release-20261117.json) -**Status 17. November: abgeschlossen und nativ verifiziert. Alte221-SDKs/Quittungen nicht erneut anwenden.** +### 7 · Lieferung von einem frischen Checkout nachvollziehen — geprüft -**Owner: Agent A bereitet den engen Core-/Operatorpfad vor; Integrator führt aus.** +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](development.md) -Inputs: [freigegebener Vorschlag](windows-system-script-nonstart-221-proposal.md), -[tatsächliche Fortschritte](windows-system-nonstart-221-progress.md), ursprünglicher -Job/Grant, gestoppter Originalzeuge `b92a51bb…`, beide gescheiterten Anwendungen. +**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. -- Letzter Operator-SDK `66c156ce…` ist **lokal gebaut, noch nicht auf Windows - übertragen**. Letzter tatsächlicher Windows-Vertrag stammt vom älteren SDK - `3b4ef6f5…`; dessen Anwendung scheiterte. Der neue Placeholdervertrag ist - ausschließlich auf Cloud-Linux bestanden. Das muss vor Apply geklärt werden. -- Nur die exakt gebundene ursprüngliche Platzhalterzeile wird aus der aktiven - Queueprojektion genommen: Message `6844ae6d-1f0f-4177-9fdd-9d9ed14b9ff5`, - Envelope-SHA `6907fdbbcd1c287c2545fde2f9ebae54fd3b6629b10b61dc5d3884584d8c74c9`, - 337 Byte, Revision 1. Originalevent bleibt physisch erhalten. Nicht den - anderen ursprünglichen Unknown-Outcome der Revision 2 damit verwechseln. -- Zuerst alles für Vertrag, Apply und unabhängige Nachlese bereitstellen. - Erst danach neuen tatsächlichen WebUI-Beleg holen; alte Belege sind abgelaufen. - Signatur-/Originalbindung, Cacheaktualisierung, Queueprojektion und normale - Unlock-Lesepfade zusammen gezielt qualifizieren. Kein weiterer Serverumbau, - solange dafür kein konkreter Defekt belegt ist. -- Genau eine native Anwendung, danach separate lesende Verifikation. Bei - Fehler/Antwortverlust vor jeder weiteren Handlung tatsächlichen Commitstand - und Originalinventare nachlesen; kein reflexartiger zweiter Apply. - -**Fertig:** Signierter zusätzlicher Nichtstartabschluss in allen betroffenen -Rollen; ursprüngliche Unknown-/Start-/Request-/Signaturbytes unverändert; -physisches Originalevent **1**, aktiv auszuliefernde Ereignisse **0**; -Kontrollhistorie vorwärts geschlossen, keine neue Wirkung oder Genehmigung. -Anschließend dokumentieren und pushen. Noch kein SYSTEM-Erfolg behaupten. - -### S2 — Korrigiertes Windows-Paar und erster erfolgreicher SYSTEM-Auftrag - -**Status 17. November: nicht abgenommen. Neues MCP/UI bestanden, originaler Job 7d75 bleibt Unknown; keine genehmigte neue Ausnahme. Details in handover.md.** - -**Owner: Agent A für das Paar; Integrator für Installation, UI und Jobnachweis.** - -Quellenhinweis für den vorhandenen Arbeitsplatz: Basis -`devstate/windows-system-script-sharing-install/5c091437-12e0-4b23-8ee0-5f274ba92c4a/unlock-pair-source`; -aktuelle Coredatei `windows_system_nonstart.rs` aus -`devstate/windows-system-nonstart-placeholder-fix/source`, SHA -`baef90ff254700cbfd1ed798064ae5b07445f361fb705251916157706b923cc9`. -Den vollständigen Operator-Snapshot **nicht** über die Produktquellen kopieren: -andere Helper-/IPC-/Readiness-/Skriptdateien darin sind älter. Diese Hinweise -ersetzen nicht das in S0 auf Gitea zu erzeugende konsistente Quellenmanifest. -Das Paar `fcbc719b…`/`ca5fbbd4…` enthält den letzten Corefix noch nicht. - -1. Ein korrigiertes Paar inklusive Sharingfix und aller benötigten normalen - Lesepfade bauen; gezielte Prüfungen, Hashmanifest, native passive Settings/Pin. - Vorhandene Installationsprimitive wiederverwenden, Controller an tatsächliche - SDK-Ausgaben binden; keine weiteren Wrapper auf bloße Annahmen bauen. -2. Dienste bleiben bei Dateiwechsel gestoppt. Identität/PKI/Journale erhalten, - überholte Qualifikationsdateien samt Bytes/IDs/ACL archivieren, neue erst nach - echter Qualifikation. Zeitprofil unverändert im genehmigten Vertrauensmodell. -3. Neue Rollen starten; eigene aktuelle Zeitnachweise, regulären signierten - Abgleich, `ready/helper_ready`, terminalen alten Fall und null offene Jobs - unabhängig bestätigen. Keine Fristen oder Vertrauensgrenzen für Grün lockern. -4. Bestehenden abgelaufenen SYSTEM-Scope eng mit den tatsächlichen neuen Pins - erneuern (`deploy/windows_system_scope_renew.py`); keine pauschale Dauerfreigabe. -5. **Neuer** MCP-Plan, vor Genehmigung 0/0/0, tatsächliche sichtbare Test-WebUI, - dann genau ein PowerShell-Skript unter SYSTEM. Erwartete Identität - `S-1-5-18`, Exit 0 und festgelegte Ausgabe, ein Verbrauch/Start/Outcome; - Ergebnis über MCP/UI und unabhängigen nativen Zeugen vergleichen. - -**Fertig:** Erster allgemeiner SYSTEM-Skriptauftrag tatsächlich erfolgreich, -normale Rollen wieder betriebsbereit, Originalfall erhalten und abgeschlossen. -Beleg/Quellen pushen. **Erst dann andere Windowswirkungen beginnen.** - -### S3 — Aktuelle Linux-Betriebsblockade gezielt beseitigen - -**Owner: Agent B (Linux/Storage); Zieländerungen beim Integrator.** - -Vorbereitung darf während S1/S2 rein lesend erfolgen. Inputs: -[Linux-Nachweis](evidence/linux-updater-helper-followup-final.json), -[aktueller Controllerstand](linux-updater-compatible-controllers.md), -Spezifikation Kapitel 0 zur endlichen 1-GiB-Grenze und Historienerhaltung. - -1. An einer geschützten Kopie die konkreten größten Tabellen/Captures und die - fehlgeschlagene Sync-Schreiboperation ermitteln. Einen reproduzierbaren - Kapazitätsfehler samt genau benötigtem Platz nachweisen; keinen neuen - allgemeinen Speicherdienst oder unbegrenzten Journalmechanismus bauen. -2. Eine einzige kleinste historienerhaltende Lösung für diese Blockade benennen - und gegen bestehende Verträge prüfen. **Noch keine vertragskonforme Lösung - ist abgenommen.** Limit anheben, Historie löschen oder neu enrollen sind - nicht durch bestehende Freigaben gedeckt. Falls die Lösung eine normative - Änderung braucht: ein konkreter überprüfbarer Entscheidungsvorschlag mit - Wirkung/Erhaltungsnachweis statt mehrerer Implementierungsrunden. -3. Nur den abgestimmten engen Fix qualifizieren/anwenden. Danach tatsächlicher - regulärer SignedSync, frisches Inventar/Heartbeat und passende Helperreadiness; - alte 27 Agent-/19 Rootverbräuche und Originalidentität weiter nachweisen. - -**Fertig:** Frischer normaler Betrieb ohne Storageblockade, endliches belegtes -Budget und erhaltene Historie; Updaterbaseline erst danach qualifizieren. -Alte Linux-APT-/Rebootabnahmen nicht ungefragt erneut ausführen. Push. - -### S4 — Windows-Auslieferung und fehlende W-Abnahmen bündeln - -**Owner: Agent B (Lifecycle); Agent A nur für konkret nötige Executorfixes.** - -Ab S2 darf Agent C die Build-/Updaterinputs parallel rein vorbereiten. -Echte Windowswirkungen führt weiterhin nur der Integrator seriell aus. - -1. Ersten bereits genehmigten normalen Gastneustart ankündigen und erst nach - SYSTEM-Erfolg/ohne offene Jobs oder Installer ausführen. Kein Force, kein - neuer Windows-Updatelauf. Anschließend MSVC-Werkzeuge und Releaseartefakte - nach vorhandenem [Wartungsplan](windows-msvc-reboot-maintenance-plan.md). - Erst dann verlässlichen nativen Installations-/Autostartstand abnehmen. -2. Eigenen begrenzten Testdienst per festem MCP-/WebUI-Auftrag ändern und seinen - tatsächlichen Zustand unabhängig nachprüfen. Den Entwicklungstransport nicht - als Dienstfixture verwenden. -3. Bestehende MSI-Fixtures: Installation 1.0, Noop 1.0, Upgrade 1.1, Noop 1.1 - mit jeweils unabhängiger Produkt-/Versions-/Nutzdateiprüfung. Feste Pläne - vorab anzeigen; kein beliebiger Installerdownload aus LLM-Text. -4. Einen begrenzten genehmigten Eventlogauftrag mit Quelle/Zeit/Teilabdeckung - und übereinstimmendem UI-/MCP-Ergebnis ausführen. -5. Reale Zertifikatserneuerung/LocalService-Dateirechte/Wiederverbindung prüfen; - Requestbindung bei Antwortverlust und Widerruf an **separater** Testidentität. - Permanente Geräteidentität und alte Journale erhalten. -6. Fehlende Windows-Nachweise bündeln: Redelivery plus Ergebnis-ACK-Verlust ohne - zweiten Start, gültiger Offlinewiederkontakt sowie Ablauf/Entzug ohne Wirkung, - kontrollierte Unterbrechung mit dauerhaftem Unknown und belegtem Abschluss. - Nur wirklich fehlende OS-Eigenschaften prüfen; gemeinsame Coretests und den - bereits bestandenen allgemeinen Skriptversuch nicht erneut komplett schreiben. -7. Zweiten genehmigten Gastneustart als **eigenen MCP-/WebUI-Rebootjob** nutzen. - Genau ein Grant, neue Boot-ID, authentisierte fristgerechte Wiederanmeldung, - Autostart beider Rollen und frische Nachprüfung. Keine dritten Neustarts aus - den vorhandenen zwei Freigaben ableiten. - -**Fertig:** Für jede Tabellenzeile der offenen Windows-W-Funktionen liegt ein -realer begrenzter Nachweis vor. Einzelne fehlgeschlagene alte Jobs bleiben als -solche erhalten. Nach jedem Abnahmeschritt einzeln dokumentieren und pushen. - -### S5 — Agent-Selbstupdate zuerst auf Cloud-Linux tatsächlich abnehmen - -**Owner: Agent C (Updater), Integrator für Ziel-/Serveränderungen. Gate: S3.** - -Vorhandene Signatur-/Katalog-/Handoff-/Healthquellen verwenden. Keine neue -Updatearchitektur. Serverseitiger Plattform-Keyringselector ist gebaut, noch -nicht bereitgestellt; nur erforderliche überprüfte Änderung integrieren. - -- Frische kompatible Baseline und separat provisionierten stabilen Updater, - Registry/Trust/Healthsigner mit tatsächlichen Rollen/Pins qualifizieren. -- Bestehende Linux-native Vertragsbelege anerkennen. Nur geänderte relevante - Sicherheitsfälle ergänzen: manipulierte/alte Releases verweigern, keine Wirkung. -- Echter UI-genehmigter Wechsel auf ein anderes signiertes Agent-/Helperpaar; - danach echte Images, Version, frische Health/Sync und Identitäts-/Journalerhalt. -- Vereinbarten begrenzten ersten-Helper-Nichtstart-Rückweg real prüfen; - kein künstliches Erfolgsresultat bei Teilstart, Timeout oder ungeklärtem Effekt. - -**Fertig:** Ein wirklicher Updateauftrag samt engem sicheren Rückweg ist nativ -nachgewiesen und gepusht. Ein APT-Fixturelauf erfüllt dieses Gate nicht. - -### S6 — Denselben Selbstupdateumfang auf Windows abschließen - -**Owner: Agent C. Gates: S2, MSVC-/Baselinevoraussetzungen aus S4, S5.** - -- Zwei tatsächlich verschiedene MSVC-Paare und stabilen Updater aus aktuellem - Quellenstand bauen/qualifizieren. Vorhandene GNU-Packs sind Entwicklungsbelege. -- Qualifikations-/Katalogbelege für beide Paare tatsächlich auf derselben VM - erzeugen, dann erst die kompatible erste Baseline/Updater provisionieren. -- Fester MCP-/WebUI-Updateplan, echter Paarwechsel, frische unabhängige Health, - geschützte Besitzerübergabe und erhaltene Identität/Journale. -- Derselbe begrenzte erste-Helper-Nichtstart-Rückweg; keine zusätzlichen - Crashmatrizen oder Updater-Selbstupdatefunktion entwickeln. - -**Fertig:** Echter Windows-Agentupdate und enger Rückweg mit Originalnachweisen, -kein GNU/MSVC-Umetikettieren, kein weiterer User-Konsolenbootstrap nötig. Push. - -### S7 — Ein gemeinsamer Abschlussdurchlauf und Übergabe - -**Owner: Integrator; unabhängiger Reviewer prüft nur die Nachweismatrix.** - -1. AT-15: ein fester Linux-/Windows-Sammelplan mit passenden Interpretern, - einzeln sichtbaren Ergebnissen und begrenztem Offlinefall. Vorhandene - Einzelgerätebelege ergänzen, keine neue Rolloutengine bauen. -2. Frischer Gerätebestand und Datenalter über WebUI/HTTP/MCP vergleichen. - Beide Clients mit normalem SignedSync/Inventar; kein offener unaufgeklärter - Verbrauch und keine ausstehende administrative Reparatur. Alte ehrliche - Fehler bleiben Historie und werden nicht nachträglich zu Erfolgen. -3. Nur Fähigkeiten anzeigen, die jetzt tatsächlich verfügbar/qualifiziert sind. - Testscopes schließen, Loopback/TLS/Tenantgrenzen erhalten, dauerhaften eng - begrenzten Entwicklungstransport getrennt vom Agentbetrieb dokumentieren. -4. Frischen Checkout-/Startweg, benötigte geschützte Operatorinputs, installierte - Artefaktversionen und verbleibende Grenzen dokumentieren. Relevanten WIP - vollständig integrieren oder eindeutig zurückstellen; nichts verwerfen. -5. Diese Matrix, README, handover und Implementierungsstatus konsistent setzen, - abschließenden Quellen-/Belegstand pushen. **Dann Entwicklung beenden.** - -**MVP vollständig**, sobald S0–S7 erfüllt und tatsächlich belegt sind. Keine -weiteren Features aus `post-mvp.md` automatisch beginnen. Ein Restblocker wird -mit genau fehlender Voraussetzung benannt, nicht als „fast fertig“ verdeckt. - -## 5. Kopierauftrag für jeden neuen Agent - -> Lies AGENTS.md, handover, die vollständige Spezifikation, project-decisions, -> development und diesen Abschlussplan. Dein Auftrag ist ausschließlich Gate -> **[Sx]**. Liefere zuerst die vorhandenen echten Belege und die genau noch -> fehlende Eigenschaft. Bearbeite nur **[Dateibereich]**; VM-/Serveränderungen, -> UI-Bedienung und Gitindex gehören dem Integrator. Schreibe keine neuen Tests, -> außer für eine notwendige Änderung oder einen konkret reproduzierten Fehler. -> Verwende bestehende Quellen/Controller; baue kein weiteres Framework. Melde -> Quelle, Build, native Ausführung und Abnahme getrennt. Bei unbekannter Wirkung -> ausschließlich nachlesen und melden, niemals blind wiederholen. Abschluss: -> konkrete Artefakte/Belege, Grenzen und nächster kleinster Schritt. Beginne -> danach kein anderes Gate selbstständig. - -Mit vier Slots: Integrator + Agent A (aktuelles Windowsgate) + Agent B -(Linuxblockade/Lifecycle jeweils exklusiv) + Agent C (Updaterinputs oder -unabhängige Prüfung). Aufgaben dürfen vorbereitet werden, ihre tatsächlichen -Wirkungen bleiben an die obenstehenden Gates gebunden. - -Konkrete Startpunkte und Dateigrenzen für die Zuteilung: - -| Rolle | Zu prüfende vorhandene Quellen | Grenze | -| --- | --- | --- | -| Agent A, S0–S2 | `crates/agent-core/src/windows_system_nonstart.rs`, `jobs.rs`, `ledger.rs`, `reconcile.rs`, `helper_reconcile.rs`; `crates/agent-windows/src/system_script.rs`; `examples/windows_system_nonstart_closed.rs`; vorhandener `deploy/windows/Install-DevelopmentPairSuccessor.ps1` | Nur benötigte 221-/Sharing-/normale Lesepfade. Gemeinsame Coredateien in dieser Phase exklusiv bei A. Keine Updateränderungen. | -| Agent B, S3 dann S4 | Zunächst Linuxkapazität nur lesend/an geschützter Kopie; danach `crates/agent-windows/src/certificate_rotation.rs`, `package.rs`, `event_log_job.rs`, `reboot.rs` und vorhandene Acceptancecontroller | Keine parallelen Coreänderungen zu A. S4-Codegebiete erst nach konkreter fehlender Eigenschaft bearbeiten; Zielausführung beim Integrator. | -| Agent C, S5–S6 | `crates/agent-windows/src/update_*.rs`, `update_native/`, `src/bin/rmm-updater-windows.rs`; vorhandene Linux-Updaterquellen/-controller und `deploy/windows/Build-NativeMsvc.ps1` | Bis Voraussetzungen erfüllt sind nur Bestandsaufnahme/eng abgegrenzte Vorbereitung; keine ungefragte Runtimeprovisionierung oder neuen GNU-Ersatzreleases. | -| Integrator | Gemeinsame `lib.rs`/`main.rs`/Cargoeinträge, Server/Domain/Migrationen/UI, Gitindex, Deploymentmanifeste und öffentliche Ergebnisdokumente | Integration erst nach Review der benötigten Diffteile. Einziger Ausführer von Zieländerungen/Browserfreigaben; vorhandenen funktionierenden Server nicht ohne nachgewiesenen Bedarf ersetzen. | +**Arbeitsverteilung.** Der Integrator bündelt die noch fehlenden Zielbelege. Je ein Verantwortlicher bearbeitet Windows-Provisionierung, Releaseverwaltung und Skriptbibliothek. 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. diff --git a/docs/operations-access.md b/docs/operations-access.md index 361a932..e7eea4c 100644 --- a/docs/operations-access.md +++ b/docs/operations-access.md @@ -1,7 +1,6 @@ # Zugänge für eine andere AI auf diesem Entwicklungs-PC -Stand: 17. November 2026, Prüfung 09:14–09:38 Uhr MEZ. -Aktueller Produktzustand und Arbeitsgrenze: [Übergabe](handover.md). +Die nachstehenden Zugangsproben stammen vom 17. November 2026, 09:14–09:38 Uhr MEZ. Am Nachmittag waren alle drei SSH-Ziele erreichbar. Den aktuellen Produktzustand mit Zeitstempeln und Zielbelegen nennt der [Lieferplan](mvp-completion-plan.md). Die [Bestandsaufnahme](evidence/product-audit-20261117.json) dokumentiert den Zustand vor der Reparatur. Für die direkte Entwicklungsbereitstellung siehe [Entwicklungsweg](development.md). Diese Anleitung beschreibt vorhandene Zugänge, keine Erlaubnis für neue Jobs, Deployments, Konten, Schlüssel, Reboots oder Wiederherstellungen. @@ -83,7 +82,7 @@ Niemals komplette Config.Env, .env, private PKI oder Tokenfiles ausgeben. **Bei einer später ausdrücklich beauftragten Bereitstellung:** Die tatsächlich laufende Compose-Dateikette erst aus dem Label com.docker.compose.project.config_files der API/Gatewaycontainer lesen. -Sie enthält neun Basis-/Broker-/Release-/Policydateien. Nur die Basisdatei +Beim morgendlichen Abruf enthielt sie neun Basis-/Broker-/Release-/Policydateien. Nur die Basisdatei mit compose up/recreate zu verwenden würde den falschen Stand erzeugen. Die genaue heutige Reihenfolge steht im [öffentlichen Zugangsbeleg](evidence/ai-handover-access-20261117.json). @@ -141,7 +140,7 @@ Vorhandene Anwendungshelfer, erst lesen und nur passend verwenden: - Entwicklungslogin und sichtbar simulierte Freigaben sind für diesen MVP beauftragt; kein OIDC nötig. Das ersetzt keine neue Risikoentscheidung. -Heute zusätzlich tatsächlich bestanden: authentisierter MCP-Aufruf jobs.get, +Beim morgendlichen Abruf bestanden: authentisierter MCP-Aufruf jobs.get, nur gespeicherter Job7d756c34… gelesen, Ergebnis unknown/Revision2. Die vorhandenen Zugangsdaten bleiben auf dem Server; kein Submit, Plan oder Approval. Der reproduzierbare lesende Einstieg ist: @@ -201,11 +200,10 @@ print(json.dumps(result)) PYCODE ~~~ -Dieser konkrete Gaststatusbefehl ist heute **nicht erfolgreich ausgeführt**: -Windows-SSH scheitert bereits am fehlenden Serverlistener 22240. Eine frische +Beim morgendlichen Versuch scheiterte der Gaststatusbefehl: +Dem Windows-SSH-Zugang fehlte damals der Serverlistener 22240. Eine frische Verbindung mit deaktiviertem äußerem Multiplexing bestätigte Connection refused. -Der Serverzugang selbst funktioniert. Keine neue Windows-Hostkeyprüfung oder -Anmeldung war dadurch möglich. +Am Nachmittag bestätigte der Zugriff über den vorhandenen Prefix die laufenden Agent- und Helperprozesse. [Betriebsnachlese](evidence/product-audit-20261117.json) Der User hat am 16. November permanenten Entwicklungs-SSH ausdrücklich erlaubt. Konto rmm-dev ohne Ablaufdatum und SYSTEM-Task RmmDevReverseTunnel sind diff --git a/docs/post-mvp.md b/docs/post-mvp.md index 40dfd24..1990a7b 100644 --- a/docs/post-mvp.md +++ b/docs/post-mvp.md @@ -27,6 +27,8 @@ Pfad bleiben dort sofort relevant. | Langzeitjournale und Kompaktierung | Reale Sync-Historien erreichten64MiB nach zehn Rootverbräuchen. Isoliert reproduziert; auch die folgende256MiB-Grenze wurde im Rebootabschluss erreicht; Spec 1.15 setzt weiterhin endliche 1 GiB pro Datei. Native Kopier- und Artefakterhaltungsqualifikation bestanden, alle Historien erhalten. Volle/inkonsistente Journale sperren weiterhin neue Wirkungen. | Dokumentierte beidseitige Kompaktierung und Kapazitätsplanung; niemals stille Löschung von Unknown oder unbestätigten Ergebnissen. | | Automatische Rückkehr von HTTPS zu WSS | Tatsächlicher Auto-Fallback nach zwei authentisierten WSS503 bestanden. Auch der passive Windows-LocalService-Fallback ist nativ geprüft. Ein bestehender HTTPS-Aktor bleibt gegebenenfalls bestehen; operativer Agentneustart mit erhaltener Konfiguration stellte WSS wieder her. | Nur bei produktivem Bedarf einen begrenzten, zustandserhaltenden Transportwechsel untersuchen; derzeit kein automatischer Switchback versprochen und kein zusätzliches MVP-Feature. | | Dauerhaft ungültiges passives Inventar vor Reconnect-Sync | Der neue Recovery-Scope wurde zunächst vom zentralen Zeichenvalidator abgewiesen. Das unverändert persistierte Inventar wurde vor dem Sync erneut gesendet und blockierte so den Kanal; der unmittelbare MVP-Fix erlaubt ausschließlich diesen bekannten Linux-Scope. | Einen expliziten Umgang mit dauerhaft abgewiesener passiver Telemetrie untersuchen, der Originalbytes, Nachrichten-ID, Herkunft und Ablehnungsbeleg erhält und keine Bestätigung erfindet. Job-/Ergebnisjournale und unbekannte Wirkungen dürfen dabei niemals übersprungen werden. | +| Windows-Updatequalifikation für mehrere Geräte | Der neue Quellpfad wählt eine geschützte native SYSTEM-Qualifikation über exakte Agent-/Helper-/Policyhashes und prüft tatsächlichen signierten Startzeugen, WebUI-Audit, SYSTEM-Outcome und Source-/Nativebelege. Ein Katalogeintrag ist keine Readiness oder Jobfreigabe. Aktuelle MVP-Provisionierung/VM-Abnahme stehen noch getrennt aus. | Nach dem MVP Geräte-/OS-/Signierkeywechsel und Releaseprovisionierung skalieren. Keine Qualifikation von einer anderen VM ableiten; keine generische Hersteller-CI oder zusätzliche öffentliche API für den jetzigen MVP bauen. | +| Weitere Windows-Updatefehler | Der enge MVP-Quellrückweg behandelt den unabhängig belegten Fehler des ersten Helperstarts ohne gestarteten Kandidatenreader. Die reale Abnahme dieses Falls bleibt MVP-Pflicht. Agent-Teilstart, verlorene Antworten, abgelaufene Fristen und unbelegte Healthfehler werden konservativ als unsicher behandelt. | Erst später zusätzliche Rückwegfälle mit eigenen tatsächlichen Fehlerzeugen qualifizieren. Weder HTTP-Timeout noch ein gemeldeter Fehlerstring dürfen als Nichtstart gelten; Unknown und ursprüngliche 180-/600-Sekunden-Grenzen bleiben erhalten. | | Weitere Plattformen / Skalierung | Ubuntu 24.04 x86-64 als Linux-Testclient; ARM64-Serverbuild ist kein ARM64-Agentnachweis. Nur eine tatsächliche Linux-Zielmaschine im aktuellen Aufbau. | Native Agentmatrix und realistische Last-/Mehrgeräteabnahmen erst zur vereinbarten Ausbaustufe erweitern; keine erfundenen Parallelitätszahlen. | | Proxmox/PBS/Cluster/Backups (M6b) | Kein Hypervisorzugang für eigenständige Gastagenten nötig; bewusst nicht Teil des Linux-MVP. | Separater späterer Integrationsauftrag mit eigenen ACL-/Discovery-/Backup-/Clusterabnahmen. | | Terminal/Relay/Business Services | Spätere Architekturverträge; kein Auftrag für eine Desktop-Engine. | Erst M7/M8 und eigener Umfang. RustDesk bleibt aus dieser Umsetzung ausgeschlossen und wird auch danach nicht automatisch begonnen. | diff --git a/docs/project-decisions.md b/docs/project-decisions.md index 1e8ab80..9423423 100644 --- a/docs/project-decisions.md +++ b/docs/project-decisions.md @@ -1,6 +1,16 @@ # Verbindliche Projektentscheidungen -Stand: **2026-11-17**, Spezifikation **1.32** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. +Stand: **2026-11-17**, Spezifikation **1.34** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. + +## Entwicklungsdaten und MVP-Abnahme (Version 1.34) + +Der Betreiber hat für das Entwicklungssystem die Löschung der benannten Anfrage und der blockierenden Testdaten freigegeben. Eine frische Geräteidentität ist für die Installationsabnahme zulässig. Der reguläre Updatepfad erhält die Identität. Der Windows-GNU-Entwicklungsbuild ist als eigener signierter Release adressierbar. Für die mitgelieferte unveränderte Windows-Update-Vorlage dürfen feste Freigabe, Server- und Helperpolicy bei passender Capability bis 3600 Sekunden erlauben. Der dedizierte Gateway stellt den Geräteauftrag über HTTPS-Polling zu. [Bereinigungsnachweis](evidence/dev-cleanup-pull-20261117.json) + +## Skriptverwaltung, HTTPS-Installation und automatischer Releasewechsel (Version 1.33) + +Auftrag vom 17. November 2026. Der Betreiber will einen Server mit WebUI und MCP und zwei eigenständige Plattformclients. Wartungsfunktionen wie Windows-Updates werden als versionierte Skripte hinterlegt. Die Clients melden auch im Leerlauf Inventar und Heartbeats, holen optional Arbeit ab und liefern Ergebnisse. Das neue Produktprofil verwendet den vorhandenen HTTPS-Abruf. SSH ist für schnelle Entwicklungsbereitstellungen ausdrücklich zulässig. + +Eine Einzelgenehmigung jedes `update_agent`-Versuchs aus 1.21 würde dem automatischen Versionswechsel widersprechen. Künftig autorisiert der berechtigte Herausgeber durch Veröffentlichung einen festen, signierten, plattformgebundenen Agent-Release. Der Client prüft und installiert diesen regelmäßig ohne Geräteeinzelklick. Skript- und OS-Wartungsjobs behalten ihre feste WebUI-Freigabe. Öffentliche HTTPS-Installer nehmen neue Geräte mit Einmalnachweis auf. Die frühere Linux-/Windows- oder S2-Reihenfolge ist durch die Nutzerabläufe des aktuellen Lieferplans ersetzt. [Normativer Umfang](../Rust_RMM_Implementierungsspezifikation.md) · [Abgleich und Plan](mvp-completion-plan.md) ## Gelockertes Zeitfenster für Zeitbelege (Version 1.32) @@ -140,7 +150,7 @@ committen vor Lockabgabe; keine Zeile erlaubt späteren Workerresume. Details und offene Runtimegrenzen stehen in Spezifikation0.1 und [agent-updater-handoff.md](agent-updater-handoff.md). -## Agent-Selbstupdate parallel, eng gebunden (Version1.21) +## Historischer manueller Updatejob (Version 1.21) Auf ausdrücklichen Userwunsch wird ausschließlich der signierte Agentupdater parallel ausM7 vorgezogen. `update_agent` bleibt fester, tatsächlich WebUI- @@ -513,5 +523,5 @@ sichtbar simulierter WebUI-Bestätigung. Keine neue Ausführung durch diesen Bel keine alte Lease, kein Erfolg aus dem Fehlversuch und kein Grantretry. Der einzeilige Sharingfix, unabhängige normale Zeit-/Syncbereitschaft beider Rollen und ein eigener neuer Jobplan bleiben Voraussetzung der neuen Abnahme. -Andere MVP-Arbeiten bleiben angehalten. Die frühere205-Ausnahme wird nicht +Die damalige Arbeitspause endete mit der neuen Priorisierung in Version 1.33. Die frühere205-Ausnahme wird nicht zu einem allgemeinen Reparatur- oder Unknown-Resetmodus erweitert. diff --git a/docs/server-deployment.md b/docs/server-deployment.md index f1dcbd8..0120ab5 100644 --- a/docs/server-deployment.md +++ b/docs/server-deployment.md @@ -1,10 +1,13 @@ # Dedizierter RMM-Server: aktuelle Verweise und historische Bereitstellung -**Aktueller Stand: 17. November 2026:** [Übergabe](handover.md), -[Zugänge](operations-access.md), [frische reine Leseprüfung](evidence/ai-handover-access-20261117.json). -API/Gateway laufen mit Image f0f3b791…/ Migration 21; Verwaltung nur Loopback. -Die tatsächlich verwendete Compose-Dateikette aus den laufenden Labels lesen; -nicht mit alleiniger Basisdatei neu erzeugen. +## Öffentlicher Zugang zur Erstaufnahme, 17. November 2026 + +Die Geräte verwenden `discovery.ease-technologies.de:443` mit der Geräte-PKI. Auf Port 8443 liefert `rmm-install-ingress.service` den [Linux-Installer](https://discovery.ease-technologies.de:8443/install/linux.sh) und den [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1) über die öffentliche Zertifikatskette. Im Test antworteten beide Skripte mit HTTP 200, der Releaseabruf ohne Einmalcode mit 401 und die privaten Routen `/mcp` und `/auth/dev/login` mit 404. Die Konfiguration prüft das Gateway-Zertifikat auch intern. [Ingress-Konfiguration](../deploy/server-bootstrap-ingress.conf) + +Das gegenwärtige öffentliche Zertifikat läuft bis 11. Februar 2027. Der täglich aktivierte Timer `rmm-install-tls-renew.timer` prüft den Ablauf und beantragt unter 30 Tagen Restlaufzeit eine neue Kette über den vorhandenen ACME-Zugang. Der erste Lauf bestätigte die Restlaufzeit. Eine tatsächliche Neuausstellung mit diesem Runner steht aus. [Erneuerung](../deploy/renew_bootstrap_tls.py) + + +Die aktuelle Topologie besteht aus dem dedizierten ARM64-Server, seiner getrennten API- und Gatewayrolle und internem PostgreSQL. Verwaltung über den SSH-Tunnel, Geräte verbinden sich direkt ausgehend. Den geprüften Betriebsstand und die aktuelle Migration enthält die [Live-Nachlese vom 17. November](evidence/product-audit-20261117.json). Die laufenden Containerlabels bestimmen bei einer Entwicklungsausrollung die vollständige Compose-Dateikette. [Entwicklungsweg](development.md) · [Zugänge](operations-access.md) Nachfolgend **historische Bereitstellungschronik ab 13. November 2026** (damals Spezifikation 1.13, Linux-MVP noch nicht abgenommen). Alte Zähler, diff --git a/tools/dev_deploy_server.py b/tools/dev_deploy_server.py index 1b8e42e..e6fa81c 100644 --- a/tools/dev_deploy_server.py +++ b/tools/dev_deploy_server.py @@ -125,9 +125,16 @@ def activate(payload): tag='rmm-dev-server:'+revision context=role_dir/'image' context.mkdir(exist_ok=True) - base_tag='rmm-dev-base:'+active['Image'].split(':')[1] - run('docker','tag',active['Image'],base_tag) - write_atomic(context/'Dockerfile',f'FROM {base_tag}\nCOPY rmm-server /usr/local/bin/rmm-server\n'.encode()) + # Reuse the deployment's runtime base across edits. Building on each + # previous dev image would retain a full obsolete server in every layer. + base_label = 'eu.incoso.rust-discovery.dev-runtime-base' + base_id = labels.get(base_label, active['Image']) + if not re.fullmatch(r'sha256:[0-9a-f]{64}', base_id): + raise ValueError('Invalid development runtime image identifier') + base_tag = 'rmm-dev-base:' + base_id.split(':')[1] + run('docker','tag',base_id,base_tag) + dockerfile = f'FROM {base_tag}\nLABEL {base_label}={base_id}\nCOPY rmm-server /usr/local/bin/rmm-server\n' + write_atomic(context/'Dockerfile', dockerfile.encode()) write_atomic(context/'rmm-server',binary,0o555) if subprocess.run(['docker','image','inspect',tag],stdout=subprocess.DEVNULL,stderr=subprocess.DEVNULL).returncode: run('docker','build','--network=none','--pull=false','-t',tag,str(context))