stageflow

Stageflow es un runtime de código abierto para flujos de trabajo de agentes multi-etapa configurables. Los pipelines se crean como YAML propiedad del proyecto (`*.pipeline.yaml`, `*.task.yaml`, manifiesto opcional `stageflow.yaml`), y cada etapa se ejecuta en una sesión de agente nueva, pasando contexto hacia adelante mediante sobres y artefactos tipados. Pi es el backend de ejecución de agentes actual. El paquete instala los binarios `sf` y `stageflow` y requiere Node.js 20 o superior. El proyecto posiciona las etapas, no los agentes, como la unidad de composición. Un programador posee la semántica de orquestación: preparación DAG, paralelismo acotado, fan-out y join, enrutamiento condicional, reintentos, ramas omitidas y compuertas humanas reanudables. La ejecución del agente se encuentra detrás de una abstracción `AgentPort`, mientras que Stageflow posee el estado del pipeline, los espacios de trabajo de las etapas, la validación de transferencias y las interfaces utilizadas por la CLI, consola, MCP y CI. El estado de ejecución se persiste en SQLite bajo `<git-root>/.stageflow/`, con espacios de trabajo por ejecución bajo `.stageflow/runs/`; la configuración global y las credenciales viven en `~/.stageflow/`. Las capacidades notables descritas en el README incluyen transferencias de sobres tipados mediante `write_stage_artifact` y `emit_stage_envelope`, ejecución de etapas verificada con comprobaciones `verify` después de la fase y reparación o recuperación manual con `on_verify_fail`, y compuertas humanas en el bucle donde CI sale con código 2 mientras una ejecución está en espera. Una consola de operador local en `http://127.0.0.1:3847` admite triaje de ejecuciones, conexión de proveedores, respuestas de compuertas e inspección de transcripciones. Un endpoint MCP se expone sobre HTTP Streamable en `/mcp` cuando `sf ui` o `sf mcp` está en ejecución, con herramientas conscientes de HITL como `wait_run`, `answer_gate`, `list_waiting` y `decide_feedback_loop`. El uso sin cabeza y CI es compatible mediante `sf validate --strict --json` y `sf run --json`, con códigos de salida documentados: 0 para éxito, 1 para fallo u ocupado, y 2 para espera. La autenticación del proveedor se puede configurar a través de la consola o los comandos `sf providers`, con credenciales almacenadas en el archivo de autenticación compartido de Pi (`pi_home`) o en el almacén propio de Stageflow (`sf_owned`). El README señala explícitamente que Stageflow no es una herramienta SDLC; la entrega de software es un patrón de ejemplo común, pero las etapas son creadas por el usuario y agnósticas al dominio. El repositorio incluye una comparación con Microsoft Conductor, enmarcando a Stageflow como ejecuciones de Pi vinculadas a etapas con sobres revisables y una consola de operador para flujos de trabajo que el usuario crea, versus el enrutamiento YAML determinista de Conductor a través de muchos agentes. Los pipelines de ejemplo cubren hello-world, plan-revisión con compuerta de operador, enrutamiento condicional de bifurcación, MCP de etapa, MCP de Playwright, MCP de Context7, borrador de lanzamiento de GitHub, un recorrido HITL primero con MCP y validación CI. La documentación cubre arquitectura, inicio rápido, esquema YAML, referencia CLI, sobres, HITL, CI, MCP, proveedores y la consola de operador. El proyecto tiene licencia MIT.