PLANKA Flow Docs

Основные runtime-компоненты

Основные runtime-компоненты

Компоненты

КомпонентРольКогда использовать
daemonЧитает Project queue, клеймит Todo, ведет active/waiting/review contextОсновной runtime цикла задачи
watchdogСледит за зависанием daemon/executor и делает recoveryКогда нужен самовосстанавливающийся фон без ручного контроля
executorВыполняет инженерную дельту и промежуточные шаги в task-cycleПосле claim задачи демоном
ops/statusОтдает snapshot, summary и web/Telegram surfaceДля диагностики и наблюдаемости
GitHub integrationIssue/PR/Project операции, auth-service, Telegram workflowsДля связи runtime с GitHub и post-merge автоматикой

Канонические команды runtime

ЗадачаКоманда
Один тик демона.flow/shared/scripts/run.sh daemon_tick
Установка демона.flow/shared/scripts/run.sh daemon_install [label] [interval-sec]
Статус демона.flow/shared/scripts/run.sh daemon_status [label]
Один тик watchdog.flow/shared/scripts/run.sh watchdog_tick
Статус watchdog.flow/shared/scripts/run.sh watchdog_status [label]
Snapshot автоматики.flow/shared/scripts/run.sh status_snapshot
Сводка по логам.flow/shared/scripts/run.sh log_summary [--hours N]
Health GitHub auth.flow/shared/scripts/run.sh gh_app_auth_probe
Health ops bot.flow/shared/scripts/run.sh ops_bot_pm2_health

Контракты компонентов

Daemon

  • не берет новую задачу при открытом development -> main PR;
  • уважает Depends-On, dirty-worktree gate и waiting/review контекст;
  • фиксирует operational state в runtime state/logs.

Watchdog

  • не выбирает задачи, а только восстанавливает runtime;
  • работает по escalation-уровням soft -> medium -> hard;
  • не подменяет ручные решения пользователя по blocker/review feedback.

Executor

  • выполняет инженерную работу внутри уже выбранной задачи;
  • при блокере пишет Issue-комментарий через task_ask;
  • не считается завершением задачи до task_finalize и PR-сигнала review.

Ops/status и GitHub integration

  • status_snapshot и log_summary дают каноническую диагностику без ручного grep по логам;
  • ops_bot публикует статус наружу;
  • auth-service и project tokens отделяют Issue/PR-авторство от Project v2 операций.

Repo sources

  • TASKFLOW.md
  • .flow/shared/scripts/README.md
  • .flow/shared/docs/gh-app-daemon-integration-plan.md
  • .flow/shared/docs/ops-bot-dashboard.md