Golden Flow Engine

Agent-neutrale Engine zum Erstellen, Validieren und Ausführen eines projektspezifischen Golden Pack. Sie bietet Codex, OpenClaw und anderen Desktop-Agents eine deterministische Grundlage, um ein Repository zu verstehen, eigene Golden Flows zu entwerfen, Belege zu sammeln, lange Läufe wiederaufzunehmen und diese Flows zusammen mit dem Produkt zu pflegen.

Die Engine ist kein hartkodierter HTTP-Test-Runner und ruft keinerlei LLM auf. Der Host-Agent liest das Projekt und schreibt .golden-flow/; die Engine liefert Fakten, sichere Tools, Validierung und Ausführung.

Schnellstart

python -m pip install -e ".[mcp]"
golden-flow inspect /path/to/project
golden-flow init /path/to/project
golden-flow validate /path/to/project
golden-flow plan /path/to/project
golden-flow run /path/to/project --mode strict

Der Hintergrundmodus verwendet eine projektlokale SQLite-Warteschlange:

golden-flow job-start /path/to/project
golden-flow worker /path/to/project --once
golden-flow job-status /path/to/project JOB_ID

Führen Sie golden-flow-mcp aus, um Tools für Inspektion, Pack-Verwaltung, Planung und asynchrone Ausführung über STDIO MCP bereitzustellen. Siehe AGENT_GUIDE.md für den festgelegten Agent-Workflow.

Related MCP server: agent-orchestrator

Integrierte Adapter

• file: auf das Projektstammverzeichnis begrenzte Lesezugriffe, Auflistung, Hashes und Existenzprüfungen.

• shell: argv-Befehle, die explizit in policies/safety.yaml registriert sind.

• http: Anfragen und Antwortbelege unter Verwendung der Python-Standardbibliothek.

• playwright: optionale Browser-Navigation, Eingabe, Screenshots und Konsolenfehler.

• sql-observer: schreibgeschützte SQLite-Beobachtung; Schreibvorgänge, Pragmas und Mehrfachanweisungen werden abgelehnt.

• minium: optionale WeChat-Miniprogramm-Fähigkeit mit Protokoll-Mock-Modus für CI.

• command-bridge: Brücke für TypeScript, Java, Go und benutzerdefinierte Tools mit einem JSON als Eingabe und einem JSON als Ausgabe.

Das Adapterprotokoll sorgt dafür, dass Fähigkeiten, Preflight, Ausführung, Belege, Sicherheitsprüfungen, Fehlerklassen und Ressourcenfreigabe unabhängig vom Engine-Kern bleiben.

Chinesische Erläuterung

golden-flow-engine ist die „Engine zum Erstellen und Ausführen von Golden Flows für Projekte“, die Codex, OpenClaw/龙虾 und anderen Desktop-Agents zur Verfügung steht. Sie führt zunächst einen deterministischen Nur-Lese-Scan des Repositorys durch; anschließend schreibt der Host-Agent auf der Grundlage von Dokumentation, Code, Seiten, Zustandsmodellen und maßgeblichen Datenquellen das .golden-flow/ für dieses Projekt. Die Engine ist zuständig für das Verzeichnisformat, die Abhängigkeitstopologie, die Tool-Sicherheit, die Integrität der Belege, die Vordergrund-/Hintergrundausführung, die Checkpoint-Ergebnisse und die Fehlerklassifizierung; sie legt keinerlei echte fachliche Produktlogik vorab fest und enthält auch keine Modell-API.

Standardmäßig werden Projektprofil, Trunk-/Branch-Liste, Python Journey, Tool-Deklarationen, Richtlinien und Fixture-Regeln committet; standardmäßig ignoriert werden Konten, Tokens, SQLite-Laufzeitstatus, Screenshots, Logs, Berichte, Caches und echte Geschäftsdaten.

Status

v0.1.0 ist eine Alpha-Version. Die Protokoll- und Schemanamen sind versioniert, aber die APIs können sich vor v1 noch ändern. Die echte Minium-Abnahme bleibt ein dokumentierter manueller Smoke-Test unter Windows mit WeChat DevTools; die reguläre CI verwendet den Protokoll-Mock.

MIT-lizenziert. Siehe SECURITY.md und CONTRIBUTING.md.