workflow-ai 1.0.0

package/src/scripts/pick-next-task.js

@@ -0,0 +1,345 @@
+#!/usr/bin/env node
+
+/**
+ * pick-next-task.js - Скрипт для выбора следующего тикета из директории ready/
+ *
+ * Использование:
+ *   node pick-next-task.js
+ *
+ * Выводит результат в формате:
+ *   ---RESULT---
+ *   status: found
+ *   ticket_id: IMPL-001
+ *   ---RESULT---
+ *
+ * или если задач нет:
+ *   ---RESULT---
+ *   status: empty
+ *   ---RESULT---
+ */
+
+import fs from 'fs';
+import path from 'path';
+import YAML from 'js-yaml';
+import { findProjectRoot } from '../lib/find-root.mjs';
+import { parseFrontmatter, printResult } from '../lib/utils.mjs';
+
+// Корень проекта
+const PROJECT_DIR = findProjectRoot();
+// Базовая директория workflow
+const WORKFLOW_DIR = path.join(PROJECT_DIR, '.workflow');
+const TICKETS_DIR = path.join(WORKFLOW_DIR, 'tickets');
+const READY_DIR = path.join(TICKETS_DIR, 'ready');
+const DONE_DIR = path.join(TICKETS_DIR, 'done');
+const IN_PROGRESS_DIR = path.join(TICKETS_DIR, 'in-progress');
+
+
+/**
+ * Проверяет условие (condition) тикета
+ */
+function checkCondition(condition) {
+  const { type, value } = condition;
+
+  switch (type) {
+    case 'file_exists':
+      const filePath = path.join(WORKFLOW_DIR, value);
+      return fs.existsSync(filePath);
+
+    case 'file_not_exists':
+      const filePath2 = path.join(WORKFLOW_DIR, value);
+      return !fs.existsSync(filePath2);
+
+    case 'tasks_completed':
+      // Проверяет, что указанные задачи выполнены (находятся в done/)
+      if (Array.isArray(value)) {
+        return value.every(taskId => {
+          const donePath = path.join(DONE_DIR, `${taskId}.md`);
+          return fs.existsSync(donePath);
+        });
+      }
+      return false;
+
+    case 'date_after':
+      return new Date() > new Date(value);
+
+    case 'date_before':
+      return new Date() < new Date(value);
+
+    case 'manual_approval':
+      // Для ручного подтверждения всегда возвращаем false
+      // Требуется явное одобрение
+      return false;
+
+    default:
+      // Неизвестный тип условия - считаем выполненным
+      console.error(`[WARN] Unknown condition type: ${type}`);
+      return true;
+  }
+}
+
+/**
+ * Проверяет зависимости тикета
+ */
+function checkDependencies(dependencies) {
+  if (!dependencies || dependencies.length === 0) {
+    return true;
+  }
+
+  return dependencies.every(depId => {
+    const donePath = path.join(DONE_DIR, `${depId}.md`);
+    return fs.existsSync(donePath);
+  });
+}
+
+/**
+ * Считывает все тикеты из директории ready/
+ */
+function readReadyTickets() {
+  if (!fs.existsSync(READY_DIR)) {
+    return [];
+  }
+
+  const files = fs.readdirSync(READY_DIR)
+    .filter(f => f.endsWith('.md') && f !== '.gitkeep.md');
+
+  const tickets = [];
+
+  for (const file of files) {
+    const filePath = path.join(READY_DIR, file);
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      const { frontmatter } = parseFrontmatter(content);
+
+      tickets.push({
+        id: frontmatter.id || file.replace('.md', ''),
+        frontmatter,
+        filePath
+      });
+    } catch (e) {
+      console.error(`[WARN] Failed to read ticket ${file}: ${e.message}`);
+    }
+  }
+
+  return tickets;
+}
+
+/**
+ * Считывает все тикеты из директории review/
+ */
+function readReviewTickets() {
+  if (!fs.existsSync(path.join(TICKETS_DIR, 'review'))) {
+    return [];
+  }
+
+  const files = fs.readdirSync(path.join(TICKETS_DIR, 'review'))
+    .filter(f => f.endsWith('.md') && f !== '.gitkeep.md');
+
+  const tickets = [];
+
+  for (const file of files) {
+    const filePath = path.join(TICKETS_DIR, 'review', file);
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      const { frontmatter } = parseFrontmatter(content);
+
+      tickets.push({
+        id: frontmatter.id || file.replace('.md', ''),
+        frontmatter,
+        filePath
+      });
+    } catch (e) {
+      console.error(`[WARN] Failed to read ticket ${file}: ${e.message}`);
+    }
+  }
+
+  return tickets;
+}
+
+/**
+ * Проверяет, заполнен ли раздел результатов (Summary) в тикете
+ */
+function hasFilledResult(body) {
+  const resultSectionRegex = /^##\s*(Результат выполнения|Result)\s*$/m;
+  const sectionStart = body.search(resultSectionRegex);
+
+  if (sectionStart === -1) {
+    return false;
+  }
+
+  const nextSectionRegex = /^##\s+/gm;
+  nextSectionRegex.lastIndex = sectionStart + 1;
+  const nextSectionMatch = nextSectionRegex.exec(body);
+  const sectionEnd = nextSectionMatch ? nextSectionMatch.index : body.length;
+
+  const sectionContent = body.substring(sectionStart, sectionEnd);
+
+  const summaryRegex = /^###\s*(Summary|Что сделано)\s*$/m;
+  const summaryStart = sectionContent.search(summaryRegex);
+
+  if (summaryStart === -1) {
+    return false;
+  }
+
+  const nextSubsectionRegex = /^###\s+/gm;
+  nextSubsectionRegex.lastIndex = summaryStart + 1;
+  const nextSubsectionMatch = nextSubsectionRegex.exec(sectionContent);
+  const summaryEnd = nextSubsectionMatch ? nextSubsectionMatch.index : sectionContent.length;
+
+  const summaryContent = sectionContent.substring(summaryStart, summaryEnd);
+  const withoutComments = summaryContent.replace(/<!--[\s\S]*?-->/g, '').trim();
+
+  return withoutComments.length > 0;
+}
+
+/**
+ * Находит завершённые тикеты в in-progress/ (с заполненным Summary)
+ * Возвращает массив id тикетов
+ */
+function findCompletedInProgress() {
+  if (!fs.existsSync(IN_PROGRESS_DIR)) {
+    return [];
+  }
+
+  const files = fs.readdirSync(IN_PROGRESS_DIR)
+    .filter(f => f.endsWith('.md') && f !== '.gitkeep.md');
+
+  const completed = [];
+
+  for (const file of files) {
+    const filePath = path.join(IN_PROGRESS_DIR, file);
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      const { frontmatter, body } = parseFrontmatter(content);
+
+      if (!hasFilledResult(body)) {
+        continue;
+      }
+
+      completed.push({
+        id: frontmatter.id || file.replace('.md', ''),
+        frontmatter,
+        filePath
+      });
+    } catch (e) {
+      console.error(`[WARN] Failed to read in-progress ticket ${file}: ${e.message}`);
+    }
+  }
+
+  return completed;
+}
+
+/**
+ * Выбирает следующий тикет для выполнения
+ */
+function pickNextTicket() {
+  const tickets = readReadyTickets();
+
+  if (tickets.length === 0) {
+    // Если ready/ пуст, проверяем review/ — нужно завершить ревью
+    let reviewTickets = readReviewTickets();
+
+    if (reviewTickets.length === 0) {
+      // Нет тикетов ни в ready/, ни в review/ — проверяем in-progress/
+      // на завершённые тикеты (с заполненным Summary)
+      const completedInProgress = findCompletedInProgress();
+      if (completedInProgress.length > 0) {
+        const first = completedInProgress[0];
+        console.log(`[INFO] Found completed ticket in in-progress/: ${first.id}`);
+        return {
+          status: 'completed_in_progress',
+          ticket_id: first.id
+        };
+      }
+    }
+
+    if (reviewTickets.length > 0) {
+      return {
+        status: 'in_review',
+        ticket_id: reviewTickets[0].id,
+        priority: reviewTickets[0].frontmatter.priority,
+        title: reviewTickets[0].frontmatter.title,
+        type: reviewTickets[0].frontmatter.type
+      };
+    }
+    return { status: 'empty', reason: 'No tickets in ready/' };
+  }
+
+  // Фильтрация по условиям и зависимостям
+  const eligibleTickets = tickets.filter(ticket => {
+    const { frontmatter } = ticket;
+
+    // Проверка условий
+    const conditions = frontmatter.conditions || [];
+    const conditionsMet = conditions.every(checkCondition);
+    if (!conditionsMet) {
+      return false;
+    }
+
+    // Проверка зависимостей
+    const dependencies = frontmatter.dependencies || [];
+    const depsMet = checkDependencies(dependencies);
+    if (!depsMet) {
+      return false;
+    }
+
+    return true;
+  });
+
+  if (eligibleTickets.length === 0) {
+    return {
+      status: 'empty',
+      reason: 'No eligible tickets (conditions/dependencies not met)'
+    };
+  }
+
+  // Сортировка по приоритету (меньше = важнее), затем по created_at
+  eligibleTickets.sort((a, b) => {
+    const priorityA = a.frontmatter.priority || 999;
+    const priorityB = b.frontmatter.priority || 999;
+
+    if (priorityA !== priorityB) {
+      return priorityA - priorityB;
+    }
+
+    // При равном приоритете - по дате создания (старые первые)
+    const dateA = new Date(a.frontmatter.created_at || '9999-12-31');
+    const dateB = new Date(b.frontmatter.created_at || '9999-12-31');
+    return dateA - dateB;
+  });
+
+  const selected = eligibleTickets[0];
+
+  return {
+    status: 'found',
+    ticket_id: selected.id,
+    priority: selected.frontmatter.priority,
+    title: selected.frontmatter.title,
+    type: selected.frontmatter.type
+  };
+}
+
+// Main entry point
+async function main() {
+  console.log(`[INFO] Scanning ready/ directory: ${READY_DIR}`);
+
+  const result = pickNextTicket();
+
+  if (result.status === 'found') {
+    console.log(`[INFO] Selected ticket: ${result.ticket_id} (${result.title})`);
+    console.log(`[INFO] Priority: ${result.priority}, Type: ${result.type}`);
+  } else {
+    console.log(`[INFO] ${result.reason}`);
+  }
+
+  printResult(result);
+
+  if (result.status === 'empty') {
+    process.exit(0);
+  }
+}
+
+main().catch(e => {
+  console.error(`[ERROR] ${e.message}`);
+  printResult({ status: 'error', error: e.message });
+  process.exit(1);
+});

package/src/skills/analyze-report/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: analyze-report
+description: Проанализировать отчёт о выполненных задачах и выработать рекомендации. Используй после завершения итерации работ для принятия решений о дальнейших действиях. Читает отчёты из .workflow/reports/ и формирует выводы.
+---
+
+# Анализ отчёта
+
+Этот skill анализирует отчёты о выполненных задачах и помогает принять решения о дальнейших действиях.
+
+## Когда использовать
+
+- Завершилась итерация работ
+- Накопились выполненные задачи
+- Нужно принять решение о следующих шагах
+- Требуется ретроспектива
+
+## Шаги выполнения
+
+### 1. Прочитать отчёт
+
+```
+Путь: .workflow/reports/REPORT-{NNN}.md
+```
+
+Извлечь:
+- Период отчёта
+- Выполненные задачи
+- Проблемы
+- Статистику
+
+### 2. Проанализировать достижения
+
+Для каждой выполненной задачи:
+- Что было сделано?
+- Соответствует ли результат ожиданиям?
+- Были ли отклонения от плана?
+
+### 3. Проанализировать проблемы
+
+Для каждой проблемы:
+- В чём причина?
+- Как была решена (или не решена)?
+- Можно ли предотвратить в будущем?
+
+### 4. Оценить прогресс по плану
+
+Если есть связанный план:
+- Какой процент выполнен?
+- Соблюдаются ли сроки?
+- Нужна ли корректировка плана?
+
+### 5. Сформулировать выводы
+
+**Положительные моменты:**
+- Что работает хорошо
+- Какие практики стоит продолжать
+
+**Области для улучшения:**
+- Что можно улучшить
+- Какие процессы неэффективны
+
+**Рекомендации:**
+- Конкретные действия
+- Приоритеты
+
+### 6. Принять решение
+
+Возможные решения:
+- **Продолжить** — следующие задачи по плану
+- **Скорректировать** — изменить приоритеты или подход
+- **Новый план** — текущий план исчерпан или нерелевантен
+- **Эскалировать** — требуется вмешательство человека
+
+### 7. Вывести структурированный результат
+
+После анализа **обязательно** выведи блок результата.
+
+Если план выполнен полностью:
+```
+---RESULT---
+status: completed
+---RESULT---
+```
+
+Если есть пробелы/недочёты:
+```
+---RESULT---
+status: has_gaps
+gaps: Краткое описание что не сделано или не соответствует плану
+---RESULT---
+```
+
+## Пример использования
+
+```
+Проанализируй отчёт .workflow/reports/REPORT-001.md и дай рекомендации.
+```
+
+## Результат
+
+Структурированный анализ с:
+- Оценкой прогресса
+- Выявленными проблемами
+- Рекомендациями
+- Решением о дальнейших действиях
+
+## Связанные skills
+
+- `create-plan` — создание нового плана на основе анализа
+- `create-report` — создание отчёта для анализа

package/src/skills/check-conditions/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: check-conditions
+description: Проверить готовность задач к выполнению. Проверяет условия тикетов в backlog и выводит список готовых к перемещению в ready. НЕ перемещает файлы — перемещение выполняется отдельным stage.
+---
+
+# Проверка условий готовности задач
+
+Этот skill проверяет условия выполнения для задач в backlog и **выводит список готовых**.
+
+**Важно:** Этот skill НЕ перемещает тикеты. Перемещение backlog → ready выполняется отдельным stage пайплайна (скриптом).
+
+## Когда использовать
+
+- Перед выбором следующей задачи
+- После завершения задачи (для разблокировки зависимых)
+- Периодически для актуализации доски
+
+## Шаги выполнения
+
+### 1. Получить список задач
+
+Прочитать все тикеты из `.workflow/tickets/backlog/` — **обязательно выполни реальное чтение директории**, не полагайся на память или предыдущий контекст.
+
+### 2. Для каждой задачи проверить условия
+
+Извлечь из frontmatter:
+- `dependencies` — зависимости
+- `conditions` — дополнительные условия
+
+### 3. Проверить каждое условие
+
+#### tasks_completed
+
+```yaml
+conditions:
+  - type: tasks_completed
+    value: ["IMPL-001", "IMPL-002"]
+```
+
+Проверка:
+- Найти тикет IMPL-001.md в `.workflow/tickets/done/`
+- Если найден — условие выполнено
+- Если не найден — условие НЕ выполнено
+
+#### date_after
+
+```yaml
+conditions:
+  - type: date_after
+    value: "2024-01-15"
+```
+
+Проверка:
+- Сравнить текущую дату с указанной
+- Если текущая >= указанной — условие выполнено
+
+#### file_exists
+
+```yaml
+conditions:
+  - type: file_exists
+    value: "src/config.py"
+```
+
+Проверка:
+- Проверить существование файла
+- Если существует — условие выполнено
+
+#### manual_approval
+
+```yaml
+conditions:
+  - type: manual_approval
+    value: true
+```
+
+Проверка:
+- Требуется подтверждение человека
+- Задача НЕ может быть автоматически перемещена в ready
+
+### 4. Определить статус
+
+| Все условия | Результат |
+|-------------|-----------|
+| Выполнены | Включить в `ready_tickets` |
+| Частично | Оставить в `backlog/` |
+| manual_approval | Оставить в `backlog/`, уведомить |
+
+### 5. Сформировать отчёт
+
+```
+=== Проверка условий ===
+
+Готовы к выполнению:
+- IMPL-002 (все зависимости выполнены)
+- DOCS-001 (дата наступила)
+
+Ожидают:
+- IMPL-003: ждёт IMPL-002
+- REVIEW-001: требует manual_approval
+
+Заблокированы:
+- FIX-001: файл src/broken.py не существует
+```
+
+### 6. Вывести структурированный результат
+
+**Важно:** НЕ перемещай тикеты. Только выведи список готовых.
+
+Если есть готовые тикеты:
+```
+---RESULT---
+status: has_ready
+ready_tickets: IMPL-002, DOCS-001
+---RESULT---
+```
+
+Если готовых нет:
+```
+---RESULT---
+status: default
+ready_tickets:
+---RESULT---
+```
+
+## Запрещено
+
+- Перемещать файлы тикетов
+- Редактировать frontmatter (status, updated_at)
+- Вызывать move-ticket.js или другие скрипты перемещения
+
+## Результат
+
+- Отчёт о статусе всех задач в backlog
+- Список готовых тикетов в поле `ready_tickets` блока RESULT
+
+## Связанные skills
+
+- `pick-next-task` — выбор задачи из ready
+- `move-ticket` — перемещение тикетов (выполняется отдельным stage)

package/src/skills/create-plan/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: create-plan
+description: Создать стратегический план для проекта. Используй когда нужно спланировать новую функциональность, проект или задачу. Создаёт файл плана в .workflow/plans/current/ по шаблону со SMART-целями, scope, рисками и критериями успеха.
+---
+
+# Создание плана
+
+Этот skill создаёт стратегический план для достижения цели.
+
+## Когда использовать
+
+- Начинается новый проект или крупная задача
+- Нужно переосмыслить направление после отчёта
+- Требуется структурированный план с декомпозицией
+
+## Шаги выполнения
+
+### 1. Изучить контекст
+
+Если есть предыдущие отчёты в `.workflow/reports/`:
+- Прочитай последний отчёт
+- Выдели ключевые проблемы и достижения
+- Учти рекомендации
+
+Если есть активные планы в `.workflow/plans/current/`:
+- Определи связь с новым планом
+
+### 2. Сформулировать SMART-цель
+
+Цель должна быть:
+- **S**pecific — конкретной (что именно)
+- **M**easurable — измеримой (как проверим)
+- **A**chievable — достижимой (реалистичной)
+- **R**elevant — релевантной (зачем нужна)
+- **T**ime-bound — ограниченной во времени
+
+### 3. Определить scope
+
+**Включено:**
+- Что будет сделано
+- Какие результаты ожидаем
+
+**Исключено:**
+- Что НЕ будем делать
+- Ограничения
+
+### 4. Разбить на высокоуровневые задачи
+
+Для каждой задачи укажи:
+- Краткое название
+- Приоритет (1-5, где 1 — критический)
+- Зависимости от других задач
+- Описание
+
+Задачи должны быть декомпозируемыми. Порядок должен учитывать зависимости.
+
+### 5. Определить риски
+
+Для каждого риска:
+- Описание
+- Вероятность (высокая/средняя/низкая)
+- Влияние (высокое/среднее/низкое)
+- Митигация (как предотвратить/решить)
+
+### 6. Записать критерии успеха
+
+Как поймём что план выполнен:
+- Конкретные результаты
+- Метрики
+- Проверяемые условия
+
+### 7. Сохранить план
+
+1. Прочитай шаблон: `.workflow/templates/plan-template.md`
+2. Определи следующий ID: найди все файлы `PLAN-*.md` в `.workflow/plans/` (рекурсивно), возьми максимальный номер и прибавь 1. Если файлов нет — начни с `PLAN-001`.
+3. Сохрани в: `.workflow/plans/current/PLAN-{NNN}.md`
+
+## Пример использования
+
+```
+Создай план для системы авторизации.
+Контекст: Python, FastAPI, PostgreSQL. Срок: 2 недели.
+Требования: JWT токены, refresh токены, роли пользователей.
+```
+
+## Результат
+
+Файл `.workflow/plans/current/PLAN-001.md` с:
+- Целью и контекстом
+- Scope (включено/исключено)
+- Высокоуровневыми задачами
+- Рисками и митигацией
+- Критериями успеха
+
+## Связанные skills
+
+- `analyze-report` — анализ отчётов перед планированием
+- `decompose-plan` — декомпозиция плана на тикеты