workflow-ai 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+## [1.3.0] — 2026-04-30
+
+### Добавлено
+- **Новый тип стейджа: `mark-blocked` и расширение frontmatter** — Добавлены поля `auto_blocked_reason`, `auto_blocked_attempts`, `auto_blocked_at` для автоматического отслеживания причин и попыток блокировки тикетов. Стейдж `mark-blocked` позволяет устанавливать эти поля в зависимости от условий бизнес-логики.
+- **Новый тип стейджа: `manual-gate-human`** — Добавлен статус `human_ready` в `pick-next-task.js`. При достижении этого статуса задача ожидает ручного решения оператора перед продолжением выполнения.
+- **Хук одобрения в `move-ticket.js`** — Добавлен approval-hook, проверяющий наличие ожидающих решения одобрений перед перемещением тикета в терминальные состояния.
+- **Расширение START-лога полем `ticket="X"`** — Добавлено поле с идентификатором тикета в стартовый лог для улучшенной трассировки и связывания логов с конкретными задачами.
+- **Исправление `approval-pending.mjs` (поле `created_at`)** — Исправлено некорректное заполнение поля `created_at` при создании файлов ожидающих решения.
+
+> **Примечание:** версия 1.2.0 не была опубликована в npm. При выполнении `npm publish`
+> сработал prepublishOnly/postversion скрипт, автоматически поднявший версию до 1.2.1.
+> Git-тег `v1.2.0` (коммит 179d52b) соответствует состоянию до publish; `v1.2.1` (коммит 83d1b70) —
+> фактически опубликованной версии.
+
+### New Features
+- **New built-in stage type: `manual-gate`** — Adds support for manual approval steps in pipelines. When a stage with `type: manual-gate` is encountered, the runner creates a pending approval file in `.workflow/approvals/{step_id}.json` and enters a polling loop, waiting for an external decision (`approved`/`rejected`).
+
+  **Key capabilities:**
+  - Deterministic `step_id` generation: `{ticket_id}_{stageId}_{attempt}` (e.g., `QA-12_manual-approve_0`)
+  - Idempotent file creation — pending file is not overwritten on retry/restart
+  - Configurable polling interval (`poll_interval_ms`, default 2000ms) and optional timeout (`timeout_seconds`)
+  - Graceful handling of SIGTERM/runner stop (returns `aborted`)
+  - Immediate return if file already has `approved`/`rejected` status (crash recovery)
+  - JSON approval file format with full audit trail (`created_at`, `updated_at`, `decided_by`, `comment`, `context_snapshot`)
+
+  **Pipeline configuration example:**
+  ```yaml
+  stages:
+    manual-approve-deploy:
+      type: manual-gate
+      poll_interval_ms: 2000
+      timeout_seconds: 86400
+      goto:
+        approved: continue-deploy
+        rejected: rollback
+        timeout: notify-stuck
+        aborted: end
+  ```
+
+  **Two approval methods (both opt-in):**
+  1. **External MCP/client**: tools like `workflow-mcp` can write to approval files programmatically
+  2. **Direct file edit**: users can simply edit `.workflow/approvals/{step_id}.json` and change `status` to `approved` or `rejected`
+
+  **Important:** `manual-gate` is **opt-in** — pipelines without such stages work identically to previous versions. No breaking changes.
+
+### Changed
+- No breaking changes. All existing pipelines without `manual-gate` stages are fully backward compatible.
+
+### Fixes
+- Исправлено сохранение временной метки `created_at` в файлах одобрений (approval-pending.mjs)
+
+### Technical Notes
+- Approval files are stored in `<project_root>/.workflow/approvals/`
+- Runner validates `manual-gate` stages on startup — requires `goto.approved` and `goto.rejected`, validates numeric parameters
+- New methods added to `PipelineRunner`: `computeStepId()`, `writeApprovalPending()`, `readApprovalFile()`, `executeManualGate()`
+
+### References
+- PLAN-009: workflow-ai 1.2 — manual-gate stage and approval files for workflow-mcp Sprint 2 integration
+- IMPL-55, IMPL-56, IMPL-57, IMPL-58: Implementation tickets
+- QA-35, QA-36, QA-37: Test coverage
+- IMPL-51, QA-55 in workflow-mcp: Dependent consumer work

package/README.md

@@ -1,377 +1,37 @@
-# workflow-ai
-
-Координатор воркфлоу для AI-агентов — конвейер на основе канбан-доски для AI-агентов, пишущих код.
-
-Система координации AI-агентов через файловую канбан-доску. Автоматически оркестрирует выполнение задач: берёт тикеты из очереди, запускает нужного агента, проверяет результат и генерирует отчёты.
-
-## Установка
-
-```bash
-npm install -g workflow-ai
-```
-
-## Быстрый старт
-
-```bash
-# 1. Инициализировать воркфлоу в вашем проекте
-workflow init
-```
-
-```text
-# 2. Открыть проект в AI-агенте (Claude Code, Kilo, и т.д.) и попросить создать план через скил:
-Создай план <описание задачи> используя скил .workflow/src/skills/create-plan/SKILL.md
-```
-
-```bash
-# 3. Запустить конвейер — он декомпозирует план на тикеты и начнёт исполнение
-workflow run
-```
-
-## Команды
-
-| Команда | Описание |
-|---------|----------|
-| `workflow init [path] [--force]` | Инициализировать директорию `.workflow/` со структурой канбан-доски |
-| `workflow run [options]` | Запустить AI-конвейер |
-| `workflow update [path]` | Обновить глобальную директорию и пересоздать junctions |
-| `workflow eject <skill> [path]` | Извлечь скил (скопировать из глобальной директории в проект) |
-| `workflow eject-scripts [path]` | Извлечь скрипты (скопировать из глобальной директории в проект) |
-| `workflow eject-configs [path]` | Извлечь конфиги (скопировать из глобальной директории в проект) |
-| `workflow list [path]` | Вывести список скилов со статусом (shared/ejected/project-only) |
-| `workflow help` | Показать справку |
-| `workflow version` | Показать версию |
-
-### Опции команды `run`
-
-| Опция | Описание |
-|-------|----------|
-| `--plan <plan>` | ID плана для выполнения |
-| `--config <path>` | Путь к конфиг-файлу |
-| `--project <path>` | Корень проекта (по умолчанию: автоопределение) |
-
-## Инициализация
-
-Команда `workflow init` создаёт структуру директории `.workflow/`:
-
-```
-.workflow/
-├── config/                       # → junction на ~/.workflow/configs/ (eject для кастомизации)
-├── plans/
-│   ├── current/                  # Текущие планы разработки
-│   ├── templates/                # Шаблоны планов с триггерами (повторяющиеся планы)
-│   └── archive/                  # Архивные планы
-├── tickets/
-│   ├── backlog/                  # Ожидают условий
-│   ├── ready/                    # Готовы к выполнению
-│   ├── in-progress/              # В работе
-│   ├── blocked/                  # Заблокированы зависимостями
-│   ├── review/                   # Ожидают ревью
-│   └── done/                     # Завершены
-├── reports/                      # Сгенерированные отчёты
-├── logs/                         # Логи выполнения конвейера
-├── metrics/                      # Метрики производительности
-├── templates/                    # Шаблоны тикетов/планов/отчётов
-└── src/
-    ├── skills/                   # Инструкции скилов (junctions на глобальные, по каждому скилу)
-    └── scripts/                  # Скрипты автоматизации (junction на глобальные)
-```
-
-## Конвейер
-
-Команда `workflow run` исполняет многоэтапный конвейер:
-
-1. **pick-first-task** — выбрать тикет из очереди ready
-2. **check-plan-templates** — проверить триггеры шаблонов планов, создать планы при срабатывании
-3. **check-plan-decomposition** — проверить состояние декомпозиции/активации планов
-4. **allocate-ticket-ids** — выделить стартовые ID для префиксов до декомпозиции
-5. **decompose-plan** — разбить план на тикеты (при необходимости)
-6. **check-atomicity-limit / verify-atomicity / increment-atomicity-counter** — проверить атомарность тикетов плана
-7. **check-conditions** — проверить условия готовности тикета
-8. **move-to-ready** — переместить тикеты из backlog в ready
-9. **pick-next-task** — выбрать следующий тикет для выполнения
-10. **move-to-in-progress** — начать выполнение
-11. **check-relevance** — проверить, что тикет всё ещё актуален (на скриптах, без LLM)
-12. **check-mcp** — проверить доступность MCP-зависимостей тикета
-13. **execute-task** — выполнить работу через AI-агента
-14. **move-to-review** — отправить на ревью
-15. **verify-artifacts** — детерминированная проверка артефактов тикета
-16. **review-result** — проверить результаты по Definition of Done
-17. **increment-task-attempts** — учесть попытки повторов
-18. **move-ticket** — переместить в done/blocked по результатам ревью
-19. **create-report** — сгенерировать отчёт о выполнении
-20. **analyze-report / decompose-gaps** — проанализировать результаты и итерировать
-21. **complete-plan / increment-plan-iterations** — закрыть план или запустить следующую итерацию
-
-### Поддерживаемые агенты
-
-| Агент | Описание |
-|-------|----------|
-| `claude-code` | Claude Opus — мощная модель для сложных задач |
-| `qwen-code` | Qwen Code — альтернативный агент |
-| `kilo-code` | Kilo Code — мультирежимный агент |
-...
-
-Агенты настраиваются в `configs/pipeline.yaml`.
-
-## Скилы
-
-Встроенные скилы для разных типов задач:
-
-| Скил | Описание |
-|------|----------|
-| `analyze-report` | Анализ отчёта |
-| `coach` | Управление и улучшение скилов |
-| `create-plan` | Создание плана |
-| `create-report` | Генерация отчёта |
-| `decompose-gaps` | Декомпозиция пробелов |
-| `decompose-plan` | Декомпозиция плана на тикеты |
-| `deep-research` | Глубокий ресерч |
-| `execute-task` | Выполнение задачи |
-| `manual-testing` | UI-observability: ручное тестирование сценариев |
-| `review-result` | Ревью результата по DoD |
-
-Скилы хранятся глобально в `~/.workflow/skills/` и подключаются в проекты через junctions.
-
-Используйте `workflow eject <skill>` для копирования скила в проект для кастомизации.
-
-### Как работать с коучем
-
-Коуч — мета-скил для создания и улучшения остальных скилов. Правки в `.workflow/src/skills/` делаются **только** через него.
-
-```text
-# Запрос к AI-агенту:
-Загрузи коуча из .workflow/src/skills/coach/SKILL.md и <действие>
-```
-
-Варианты `<действия>`:
-
-| Тип задачи | Пример запроса |
-|------------|----------------|
-| Создать новый скил | `создай скил <имя> для <назначение>` |
-| Аудит существующего | `сделай аудит скила <имя>` |
-| Анализ эффективности | `проанализируй результаты скила <имя> по завершённым тикетам` |
-| Точечное улучшение | `улучши скил <имя>: <что именно>` |
-| Ресерч практик | `найди лучшие практики для <тема> и обогати скил <имя>` |
-| Ревью скила | `сделай ревью скила <имя>` |
-
-Коуч сам определит тип задачи, загрузит нужный воркфлоу, внесёт правку, прогонит тест скила и запишет результат в `.workflow/coach-backlog.yaml`. Коммит делает пользователь.
-
-## Регрессионные тесты скилов
-
-Трёхуровневая система тестирования скилов для проверки качества AI-агентов.
-
-### Три слоя тестирования
-
-| Уровень | Название | Описание |
-|---------|----------|----------|
-| L0 | Static | Базовая проверка синтаксиса и структуры: YAML-валидация, проверка обязательных полей, линтер |
-| L1 | Deterministic | Детерминированные тесты: эталонные входные данные → ожидаемый результат (strict match) |
-| L2 | Rubric | Гибкая оценка по критериям: scorer выставляет баллы на основе качества результата |
-
-### Структура директорий
-
-```
-src/skills/<name>/tests/
-├── index.yaml      # Метаданные тестов, список test cases
-├── cases/          # Входные данные для тестов
-│   └── <case-id>/
-│       └── input.yaml
-├── fixtures/       # Ожидаемые выходные данные (для L1)
-│   └── <case-id>/
-│       └── expected.yaml
-└── rubrics/        # Критерии оценки (для L2)
-    └── <case-id>/
-        └── rubric.yaml
-```
-
-### Запуск тестов
-
-```bash
-npm run test:skills
-```
-
-### CLI-флаги
-
-| Флаг | Описание |
-|------|----------|
-| `--skill <name>` | Запустить тесты только для указанного скила |
-| `--relevant` | Запустить только тесты, соответствующие изменённым файлам |
-| `--establish-baseline` | Запустить тесты и сохранить результаты как baseline |
-| `--baseline-ref <ref>` | Использовать конкретный baseline (коммит, тег) |
-| `--yes` | Автоматически подтверждать все действия |
-
-### Режимы вердикта
-
-| Режим | Описание |
-|-------|----------|
-| `no-baseline` | Первый запуск — результаты сохраняются как baseline без сравнения |
-| `no-regression` | Сравнение с baseline — тест считается пройденным, если результат не хуже baseline |
-
-### Принцип git write
-
-Runner и коуч **не выполняют git write-операций**. Все изменения в кодовой базе делает исключительно пользователь. Runner только анализирует и рекомендует, но не коммитит.
-
-### Первый запуск на новом проекте
-
-1. Запустить тесты с флагом `--establish-baseline`
-2. Проверить результаты: красные тесты — ожидаемы для нового проекта
-3. Зафиксировать baseline: `git commit current/` как baseline-коммит
-
-## Скрипты
-
-Скрипты хранятся глобально в `~/.workflow/scripts/` и подключаются одним junction в `.workflow/src/scripts/`.
-
-Используйте `workflow eject-scripts` для копирования скриптов в проект для кастомизации.
-
-## Конфиги
-
-Конфиги хранятся глобально в `~/.workflow/configs/` и подключаются одним junction в `.workflow/config/`.
-
-Используйте `workflow eject-configs` для копирования конфигов в проект для кастомизации.
-
-## Шаблоны планов
-
-Шаблоны планов позволяют автоматически создавать повторяющиеся планы. Шаблоны лежат в `.workflow/plans/templates/` и содержат условия триггеров во frontmatter.
-
-### Формат шаблона
-
-```yaml
-id: "TMPL-001"
-title: "Daily manual testing"
-type: template
-trigger:
-  type: daily          # daily | weekly | date_after | interval_days
-  params: {}           # параметры, зависящие от типа
-last_triggered: ""     # обновляется автоматически при срабатывании
-enabled: true
-```
-
-### Типы триггеров
-
-| Тип | Параметры | Описание |
-|-----|-----------|----------|
-| `daily` | — | Раз в день |
-| `weekly` | `days_of_week: [1,3,5]` (0=вс) | В указанные дни недели |
-| `date_after` | `date: "2026-04-01"` | Один раз после указанной даты |
-| `interval_days` | `days: 3` | Каждые N дней |
-
-При срабатывании триггера конвейер создаёт план в `plans/current/` со статусом `approved`, далее идёт обычный поток декомпозиции.
-
-## Типы задач
-
-| Тип | Префикс | Описание |
-|-----|---------|----------|
-| `arch` | ARCH | Архитектура и планирование |
-| `impl` | IMPL | Реализация кода |
-| `fix` | FIX | Исправления ошибок |
-| `review` | REVIEW | Ревью кода/документации |
-| `docs` | DOCS | Документация |
-| `admin` | ADMIN | Административные задачи |
-
-## Fallback агентов и правила здоровья
-
-Система включает механизм in-stage fallback и health-мониторинг агентов.
-
-### Механика fallback
-
-Когда агент падает во время выполнения задачи, система использует **artifact-snapshot** для принятия решения:
-- Если snapshot пустой (нет записанных файлов) → выполняется fallback на следующего агента
-- Если snapshot непустой (есть изменения) → задача переходит в состояние `goto.error`
-
-**Пример сценария:** Qwen превысил quota и упал без записи файлов → Kilo вызван в той же попытке, task_attempts не инкрементирован.
-
-Конфигурация snapshot:
-```yaml
-execution:
-  artifact_snapshot_enabled: false  # по умолчанию выключено
-  snapshot_paths: ["src/", "configs/"]  # что мониторить
-  snapshot_max_file_size: 524288  # файлы >512KB — только mtime+size
-```
-
-**Baseline производительности:** `p50=169ms p95=299ms files=598` (из QA-20 benchmark).
-
-### Классификатор ошибок и health-реестр
-
-Ошибки классифицируются по классам:
-- `unavailable` — агент временно недоступен (quota, rate limit)
-- `transient` — временная ошибка сети (timeout, 5xx)
-- `misconfigured` — ошибка конфигурации (401, 403, отсутствует API key)
-- `unmatched` — ошибка не распознана
-
-**Семантика TTL:**
-- `5m` — 5 минут
-- `1h` — 1 час
-- `until_utc_midnight` — до полуночи UTC (минимум 30 минут)
-- `infinite` — навсегда
-
-Файл конфигурации: `configs/agent-health-rules.yaml`. Файл состояния: `.workflow/state/agent-health.json`.
-
-### Команда сброса
-
-```bash
-# показать текущее состояние
-node .workflow/src/scripts/reset-agent-health.js
-
-# сбросить конкретного агента
-node .workflow/src/scripts/reset-agent-health.js --agent qwen-code
-
-# сбросить всех агентов
-node .workflow/src/scripts/reset-agent-health.js --all
-```
-
-### Пример добавления правила
-
-```yaml
-# В configs/agent-health-rules.yaml:
-agents:
-  my-new-agent:
-    rules:
-      - id: "my-agent-quota"
-        class: "unavailable"
-        ttl: "until_utc_midnight"
-        pattern: "quota exceeded|daily limit reached"
-        exit_codes: "any"
-```
-
-## Конфигурация
-
-### `configs/config.yaml`
-
-Основная конфигурация воркфлоу: информация о проекте, типы задач, приоритеты, статусы, типы условий, пути, настройки отчётности.
-
-### `configs/pipeline.yaml`
-
-Определение конвейера: агенты, стадии, управление потоком, goto-логика, стратегии повторов.
-
-### `configs/ticket-movement-rules.yaml`
-
-Правила автоматического перемещения тикетов на основе статуса ревью.
-
-## Структура проекта
-
-```
-workflow-ai/
-├── bin/                    # Точка входа CLI
-├── src/
-│   ├── cli.mjs             # Парсинг команд
-│   ├── runner.mjs           # Оркестратор конвейера
-│   ├── init.mjs             # Инициализация проекта
-│   ├── global-dir.mjs       # Управление глобальной ~/.workflow/
-│   ├── junction-manager.mjs # Управление junction/symlink
-│   ├── wf-loader.mjs        # Загрузчик конфигов
-│   ├── lib/                 # Библиотеки утилит
-│   └── tests/               # Набор тестов
-├── configs/                # Файлы конфигурации (источник)
-├── templates/              # Шаблоны воркфлоу (источник)
-├── agent-templates/        # Шаблоны инструкций для AI-агентов
-└── package.json
-```
-
-## Требования
-
-- Node.js >= 18.0.0
-- npm
-
-## Лицензия
-
-MIT
+
+- Добавлено упоминание `human-gate` в разделе про runner-стадии (пример конфига в pipeline.yaml: human-review-step типа manual-gate).
+- Добавлено упоминание `mark-blocked` как механизм нотификации autoblocked-тикетов (поля auto_blocked_reason/attempts/at).
+
+## Runner-стадии
+
+В системе поддерживаются различные типы стадий для управления процессами разработки:
+
+### Human Gate
+
+`human-gate` — стадия ручного контроля, которая требует вмешательства человека для продолжения выполнения пайплайна. Используется для критических точек, где необходима ручная проверка или утверждение.
+
+**Условия срабатывания:**
+- Стадия `manual-gate-human` блокирует пайплайн до ручного снятия gate
+- Gate снимается через команду `move-ticket.js <id> unblock`
+- Поддерживает настройку таймаутов и условий повторных попыток
+
+**Пример конфигурации pipeline.yaml:**
+```yaml
+stages:
+  - name: manual-gate-human
+    type: manual-gate-human
+    config:
+      timeout: 3600  # 1 hour
+      max_attempts: 3
+      message: "Requires human approval before deployment"
+```
+
+Пример полного файла `pipeline.yaml` доступен в `docs/samples/pipeline-with-human-gate.yaml`.
+
+### Autoblock notifications
+
+Для автоматического блокировки тикетов при возникновении проблем используется механизм `mark-blocked`. Блокированные тикеты получают дополнительные поля в frontmatter для отслеживания причин и попыток:
+
+- `auto_blocked_reason` — причина автоматической блокировки
+- `auto_blocked_attempts` — количество попыток разблокировки
+- `auto_blocked_at` — время автоматической блокировки

package/configs/pipeline.yaml

@@ -90,6 +90,20 @@ pipeline:
       capabilities: [text]
       description: "Kilo deepseek"
 
+    deepseek-flash:
+      command: "kilo"
+      args: ["-m", "deepseek/deepseek-v4-flash", "--agent", "code", "--print-logs", "--log-level", "ERROR", "run", "--auto"]
+      workdir: "."
+      capabilities: [text]
+      description: "Kilo deepseek"
+
+    deepseek-pro:
+      command: "kilo"
+      args: ["-m", "deepseek/deepseek-v4-pro", "--agent", "code", "--print-logs", "--log-level", "ERROR", "run", "--auto"]
+      workdir: "."
+      capabilities: [text]
+      description: "Kilo deepseek"
+
     kilo-minimax:
       command: "kilo"
       args: ["-m", "kilo/minimax/minimax-m2.7", "--agent", "code", "--print-logs", "--log-level", "ERROR", "run", "--auto"]
@@ -104,6 +118,13 @@ pipeline:
       capabilities: [text]
       description: "Kilo free"
 
+    openrouter-free:
+      command: "kilo"
+      args: ["-m", "kilo/openrouter/free", "--agent", "code", "--print-logs", "--log-level", "ERROR", "run", "--auto"]
+      workdir: "."
+      capabilities: [text]
+      description: "Kilo free"
+
     script-move:
       command: "node"
       args: [".workflow/src/scripts/move-ticket.js"]
@@ -164,6 +185,18 @@ pipeline:
       workdir: "."
       description: "Проверка доступности MCP-серверов"
 
+    script-mark-blocked:
+      command: "node"
+      args: [".workflow/src/scripts/mark-blocked.js"]
+      workdir: "."
+      description: "Обновление frontmatter и запись в alerts.jsonl при автоблокировке"
+
+    script-mark-human-rejected:
+      command: "node"
+      args: [".workflow/src/scripts/mark-blocked.js"]
+      workdir: "."
+      description: "Обновление frontmatter при отклонении human-тикета"
+
     script-verify-artifacts:
       command: "node"
       args: [".workflow/src/skills/review-result/scripts/verify-artifacts.js"]
@@ -253,6 +286,10 @@ pipeline:
             task_type: "$result.type"
             required_capabilities: "$result.required_capabilities"
             target: in-progress
+        human_ready:
+          stage: manual-gate-human
+          params:
+            ticket_id: "$result.ticket_id"
         in_review:
           stage: verify-artifacts
           params:
@@ -466,6 +503,10 @@ pipeline:
             task_type: "$result.type"
             required_capabilities: "$result.required_capabilities"
             target: in-progress
+        human_ready:
+          stage: manual-gate-human
+          params:
+            ticket_id: "$result.ticket_id"
         in_review:
           stage: verify-artifacts
           params:
@@ -576,10 +617,10 @@ pipeline:
       description: "Выполнить выбранную задачу"
       skill: execute-task
       counter: task_attempts
-      agents: [kilo-free, kilo-glm-air, claude-haiku, claude-sonnet, claude-opus, kilo-minimax, kilo-deepseek]
+      agents: [kilo-free, openrouter-free, kilo-glm-air, claude-haiku, claude-sonnet, claude-opus, kilo-minimax, deepseek-flash]
       agents_by_type:
         coach:
-          agents: [kilo-glm, claude-sonnet, kilo-minimax, kilo-deepseek]
+          agents: [kilo-glm, claude-sonnet, deepseek-pro, kilo-minimax]
           instructions: "Твоя роль: coach"
         qa:
           agents: [claude-haiku, kilo-glm, claude-sonnet, claude-opus, kilo-minimax]
@@ -628,6 +669,73 @@ pipeline:
             ticket_id: "$context.ticket_id"
             attempt: "$counter.task_attempts"
 
+    # -------------------------------------------------------------------------
+    # 2d. manual-gate-human
+    # Используется для созревших human-тикетов (pick-first-task возвращает human_ready).
+    # Ждёт решения по approval-файлу (approved/rejected/timeout).
+    # -------------------------------------------------------------------------
+    manual-gate-human:
+      description: "Ожидание ручного выполнения созревшего human-тикета"
+      type: manual-gate
+      poll_interval_ms: 2000
+      timeout_seconds: 86400
+      goto:
+        approved: pick-first-task
+        rejected:
+          stage: mark-human-rejected
+          params:
+            ticket_id: "$context.ticket_id"
+        timeout:
+          stage: mark-human-rejected
+          params:
+            ticket_id: "$context.ticket_id"
+            reason: "human_gate_timeout"
+        aborted: end
+
+    # -------------------------------------------------------------------------
+    # 3b. mark-blocked
+    # Записывает причину автоблокировки в frontmatter тикета и эмитит alert
+    # в alerts.jsonl. Вставлен между increment-task-attempts.max_reached и
+    # move-ticket(blocked).
+    # -------------------------------------------------------------------------
+    mark-blocked:
+      description: "Записать причину автоблокировки в frontmatter и эмитить alert"
+      agent: script-mark-blocked
+      timeout: 30
+      goto:
+        default:
+          stage: move-ticket
+          params:
+            ticket_id: "$context.ticket_id"
+            target: blocked
+        error:
+          stage: move-ticket
+          params:
+            ticket_id: "$context.ticket_id"
+            target: blocked
+
+    # -------------------------------------------------------------------------
+    # 3b'. mark-human-rejected
+    # Записывает причину отклонения human-тикета (reject/timeout) и переходит
+    # в move-ticket(blocked). Используется ветками rejected и timeout стейджа
+    # manual-gate-human.
+    # -------------------------------------------------------------------------
+    mark-human-rejected:
+      description: "Записать причину отклонения human-тикета и переместить в blocked"
+      agent: script-mark-human-rejected
+      timeout: 30
+      goto:
+        default:
+          stage: move-ticket
+          params:
+            ticket_id: "$context.ticket_id"
+            target: blocked
+        error:
+          stage: move-ticket
+          params:
+            ticket_id: "$context.ticket_id"
+            target: blocked
+
     # -------------------------------------------------------------------------
     # 3c. verify-artifacts
     # Механическая предпроверка артефактов тикета перед AI-ревью.
@@ -708,10 +816,11 @@ pipeline:
             ticket_id: "$context.ticket_id"
             target: ready
         max_reached:
-          stage: move-ticket
+          stage: mark-blocked
           params:
             ticket_id: "$context.ticket_id"
-            target: blocked
+            attempts: "$counter.task_attempts"
+            reason: "max_review_attempts"
 
     # -------------------------------------------------------------------------
     # 5. move-ticket