stageflow

Stageflow — это open-source рантайм для настраиваемых многоэтапных агентных рабочих процессов. Пайплайны описываются как YAML-файлы, принадлежащие проекту (`*.pipeline.yaml`, `*.task.yaml`, опциональный манифест `stageflow.yaml`), и каждый этап выполняется в новой сессии агента, передавая контекст вперед через типизированные конверты и артефакты. Pi — текущий бэкенд выполнения агента. Пакет устанавливает бинарники `sf` и `stageflow` и требует Node.js версии 20 или новее. Проект позиционирует этапы, а не агентов, как единицу композиции. Планировщик владеет семантикой оркестрации: готовность DAG, ограниченный параллелизм, разветвление и объединение, условная маршрутизация, повторные попытки, пропущенные ветви и возобновляемые человеческие проверки. Выполнение агента находится за абстракцией `AgentPort`, в то время как Stageflow владеет состоянием пайплайна, рабочими пространствами этапов, проверкой передачи и интерфейсами, используемыми CLI, консолью, MCP и CI. Состояние выполнения сохраняется в SQLite в `<git-root>/.stageflow/`, с рабочими пространствами для каждого запуска в `.stageflow/runs/`; глобальная конфигурация и учетные данные хранятся в `~/.stageflow/`. Примечательные возможности, описанные в README, включают типизированные передачи конвертов через `write_stage_artifact` и `emit_stage_envelope`, проверенное выполнение этапов с проверками `verify` после фазы и восстановлением `on_verify_fail` или ручным восстановлением, а также человеческие проверки, где CI завершается с кодом 2, пока запуск ожидает. Локальная консоль оператора на `http://127.0.0.1:3847` поддерживает разбор запусков, подключение провайдеров, ответы на проверки и просмотр транскриптов. Конечная точка MCP доступна через Streamable HTTP на `/mcp`, когда запущены `sf ui` или `sf mcp`, с инструментами, учитывающими HITL, такими как `wait_run`, `answer_gate`, `list_waiting` и `decide_feedback_loop`. Использование без головы и в CI поддерживается через `sf validate --strict --json` и `sf run --json`, с документированными кодами выхода: 0 для успеха, 1 для ошибки или занятости и 2 для ожидания. Аутентификация провайдера может быть настроена через консоль или команды `sf providers`, с учетными данными, хранящимися либо в общем файле аутентификации Pi (`pi_home`), либо в собственном хранилище Stageflow (`sf_owned`). README явно отмечает, что Stageflow не является инструментом SDLC; доставка программного обеспечения — это распространенный пример паттерна, но этапы создаются пользователем и не зависят от домена. Репозиторий включает сравнение с Microsoft Conductor, представляя Stageflow как привязанные к этапам запуски Pi с проверяемыми конвертами и консолью оператора для рабочих процессов, которые автор создает сам, в отличие от детерминированной YAML-маршрутизации Conductor по множеству агентов. Примеры пайплайнов охватывают hello-world, план-ревью с проверкой оператора, условную маршрутизацию с разветвлением, MCP этапа, Playwright MCP, Context7 MCP, черновик релиза GitHub, MCP-первый тур HITL и проверку CI. Документация охватывает архитектуру, быстрый старт, схему YAML, справочник CLI, конверты, HITL, CI, MCP, провайдеров и консоль оператора. Проект лицензирован под MIT.