nilstate/runx

Evolve

Evolviere das aktuelle Repository durch regulierte Phasen mit fester Semantik und eingeschränkter Revision. Ohne Zielsetzung ist das Standardverhalten introspektiv: Analysiere das Repo, empfehle eine begrenzte Verbesserung und höre bei einem planqualitätsfähigen Artefaktsatz auf.

Dies ist keine autonome Codegenerierung. Es reguliert die Form um die Kognition herum – jede Phase erzeugt ein typisiertes Artefakt, jede Mutation benötigt Genehmigung, jeder Schritt erzeugt eine Quittung. Ein einzelner evolve-Durchlauf endet in einem begrenzten Artefakt, nicht in einer offenen Verbesserungsschleife.

Kanonische Semantik

Komplexe runx-Skills teilen eine gemeinsame interne Phasensprache:

• scope
• ingest
• model
• materialize
• evaluate
• revise
• verify
• ratify

Der aktuelle evolve-Runner verwendet eine begrenzte Teilmenge und komprimiert einige Phasen in weniger konkrete Schritte. Das ist erlaubt. Was fest bleibt, ist die Bedeutung der Phasen, nicht die Anzahl der Schritte.

Aktuelle Runner-Zuordnung

Introspektion

Aufrufer-vermittelt (Agentenschritt). Dies ist die Empfehlungsspur ohne Argumente. Sie verwendet scope + ingest + model, um das aktuelle Repo zu analysieren und erzeugt:

• opportunity_report — bewertete Chancen, die auf Repo-Beweisen basieren
• recommended_objective — einen begrenzten nächsten Schritt
• change_plan — einen konkreten Plan für diese Empfehlung
• spec_document — einen Entwurf einer scafld-ähnlichen Spezifikation, wenn Governance angewendet wird

In diesem Runner gibt es keine Genehmigungstür und keine Mutation. Es handelt sich nur um Introspektion.

Preflight

Deterministisch. Dies ist der aktuelle scope + ingest-Schritt. Er inspiziert das Ziel-Repo und erzeugt ein repo_profile: Repo-Root, Git-Status, Basis-Branch, schmutziger Worktree, .ai/-Vorhandensein (scafld initialisiert), erkannte Sprachen, Testbefehle, Risikosignale. Keine Agentenkognition, keine Mutation.

Plan

Aufrufer-vermittelt (Agentenschritt). Dies ist der aktuelle model-Schritt und entwirft auch begrenzte Planarrefakte. Angesichts des Ziels und des Repo-Profils erzeugt er in einem Durchlauf vier Artefakte:

• objective_brief — Wiederholung mit Zielart, Einschränkungen, Erfolgskriterien.
• diagnosis_report — aktueller Repo-Zustand relativ zum Ziel.
• change_plan — geordnete Phasen, Akzeptanzprüfungen, Berührungspunkte, Risiko.
• spec_document — Entwurf einer scafld-Spezifikation, wenn Governance angewendet wird.

Terminierungsbremse

evolve stoppt derzeit bei Plan/Spezifikations-Artefakten. Wenn ein Aufrufer terminate=patch oder terminate=pr anfordert, schlägt der Runner sofort mit einem klaren Fehler fehl, anstatt so zu tun, als könne er mutieren oder veröffentlichen.

Revisionsrichtlinie

evolve führt derzeit keine Revisionsrunden durch. Das ist beabsichtigt. Wenn eine eingeschränkte Revision eingeführt wird, muss sie explizit und richtliniengesteuert sein, z. B. max_rounds: 1 oder 2, mit definierten Stopp- und Eskalationsbedingungen.

Aufrufmodi

• runx evolve — Introspektion des aktuellen Repos und Empfehlung einer begrenzten Verbesserung
• runx evolve "<Ziel>" — Planung einer gerichteten Änderung
• runx evolve "<Ziel>" --terminate patch|pr — derzeit abgelehnt, bis eine echte Ausführungsspur existiert

Evolutionsziele

Die Zielzeichenkette bestimmt das Ziel. Die Preflight-Phase löst das konkrete Ziel aus dem aktuellen Repo-Kontext auf.

• Repo: "WebSocket-Adapter-Unterstützung hinzufügen" — Verbesserung der Codebasis in Richtung eines Ziels.
• Skill: --skill ./skills/sourcey — Verbesserung eines bestimmten Skill-Pakets.
• Quittung: --receipt rx_8f3a — Reparatur basierend auf einem fehlgeschlagenen Durchlauf.
• Selbst: Ausführung gegen das runx-Repo selbst im Testbereich.

Terminierung

• spec (Standard): Stopp nach der Planung. Keine Mutation.
• patch: In diesem ausgelieferten Runner noch nicht unterstützt.
• pr: In diesem ausgelieferten Runner noch nicht unterstützt.

Grenzregeln

• Ein einzelner evolve-Durchlauf endet in einem begrenzten Artefakt, nicht in einer weiteren versteckten Schleife.
• Richtlinien bewerten strukturierte Felder, niemals Prosa.
• Wenn später eine Ausführung hinzugefügt wird, muss sie über echte Tools, scafld oder andere regulierte Spuren verlaufen, anstatt über synthetische interne Schritte.

Eingaben

• objective (optional): Wohin evolviert werden soll. Wenn weggelassen, verwendet evolve den introspektiven Empfehlungs-Runner.
• repo_root (optional): Repository-Root. Standardmäßig das aktuelle Arbeitsverzeichnis.
• terminate (optional): Standardmäßig spec. Andere Werte werden derzeit vom ausgelieferten Runner abgelehnt.