Golden Flow Engine

Motor independiente del agente para construir, validar y ejecutar un Golden Pack específico del proyecto. Proporciona a Codex, OpenClaw y otros agentes de escritorio una base determinista para comprender un repositorio, diseñar sus propios flujos golden, recopilar evidencia, reanudar ejecuciones largas y mantener esos flujos junto con el producto.

El Engine no es un ejecutor de pruebas HTTP codificado de forma fija ni llama a ningún LLM. El agente anfitrión lee el proyecto y escribe .golden-flow/; el Engine proporciona hechos, herramientas seguras, validación y ejecución.

Inicio rápido

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

El modo en segundo plano utiliza una cola SQLite local del proyecto:

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

Ejecuta golden-flow-mcp para exponer herramientas de inspección, gestión de Pack, planificación y ejecución asíncrona mediante MCP sobre STDIO. Consulta AGENT_GUIDE.md para conocer el flujo de trabajo fijo del agente.

Related MCP server: agent-orchestrator

Adaptadores integrados

• file: lecturas limitadas a la raíz del proyecto, listados, hashes y comprobaciones de existencia.

• shell: comandos argv registrados explícitamente en policies/safety.yaml.

• http: solicitudes y evidencia de respuestas mediante la biblioteca estándar de Python.

• playwright: navegación opcional del navegador, entrada, capturas de pantalla y errores de consola.

• sql-observer: observación de SQLite de solo lectura; las escrituras, pragmas y sentencias múltiples se rechazan.

• minium: capacidad opcional para mini programas de WeChat con modo Mock de protocolo para CI.

• command-bridge: puente de una entrada JSON/una salida JSON para TypeScript, Java, Go y herramientas personalizadas.

El protocolo de adaptadores mantiene las capacidades, la verificación previa, la ejecución, la evidencia, los controles de seguridad, las clases de error y el cierre de recursos independientes del núcleo del Engine.

Descripción en chino

golden-flow-engine es el motor de construcción y ejecución de flujos golden de proyectos, pensado para Codex, OpenClaw/langosta y otros agentes de escritorio. Primero realiza un escaneo determinista de solo lectura del repositorio; después, el agente anfitrión escribe .golden-flow/ para ese proyecto basándose en la documentación, el código, las páginas, el modelo de estado y las fuentes de verdad de los datos. El Engine se encarga del formato de directorios, la topología de dependencias, la seguridad de las herramientas, la integridad de la evidencia, la ejecución en primer y segundo plano, los resultados de puntos de interrupción y la clasificación de errores; no preconfigura ninguna lógica de negocio real ni incorpora una API de modelos.

Por defecto se incluyen el perfil del proyecto, el listado de tronco/ramas, el Python Journey, las declaraciones de herramientas, las políticas y las reglas de Fixture; por defecto se ignoran cuentas, tokens, el estado de ejecución de SQLite, capturas de pantalla, registros, informes, cachés y material de negocio real.

Estado

v0.1.0 es una versión alfa. Los nombres de protocolo y esquema están versionados, pero las API pueden evolucionar antes de v1. La aceptación real de Minium sigue siendo una prueba de humo manual documentada en Windows con WeChat DevTools; el CI normal utiliza el protocolo Mock.

Con licencia MIT. Consulta SECURITY.md y CONTRIBUTING.md.