Files
rust-discovery/AGENTS.md
T
BuTzZ 6c3203d725
Rust development slice / linux (push) Failing after 1m10s
feat: snapshot Linux-first RMM MVP and pause handover
2026-11-12 22:06:25 +01:00

6.0 KiB
Raw Blame History

Verbindliche Regeln für alle Coding-KIs

Entwicklungspause auf Userwunsch seit 2026-11-12: Vor Wiederaufnahme docs/handover.md lesen. Bis zu neuem Auftrag keine Entwicklung, Builds, Tests, Deployments oder Jobs starten.

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.

Reihenfolge und reale Nachweise

  • 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. Windows beginnt erst nach dessen Abnahme. 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.

Unumgehbare Genehmigungsgrenze

  • 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

  • Server lokal in Docker auf dem Entwickler-PC; veröffentlichte Dockerports ausschließlich an Loopback binden, auch Datenbank/Verwaltungsports niemals an 0.0.0.0 oder [::].
  • PC baut SSH zur VM auf: Reverse-Forward -R 127.0.0.1:18443:127.0.0.1:18443, -N -T, ExitOnForwardFailure und Keepalive gemäß docs/development.md. VM-Agent verbindet sich ausgehend über dortigen Loopback.
  • TLS Ende-zu-Ende zwischen VM-Agent und lokalem Server, DNS SAN rmm-dev.internal, expliziter VM-Hosts-Eintrag oder geprüfter Client-Connect-Override. Vertrauenswürdige Dev-CA installieren/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.
  • 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.