workflow-ai 1.0.0

package/src/scripts/check-anomalies.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+
+/**
+ * check-anomalies.js - Скрипт для проверки аномалий в тикетах
+ *
+ * Проверяет in-progress тикеты на наличие заполненных результатов.
+ * Если тикет в in-progress, но имеет заполненный раздел "Результат выполнения" —
+ * это аномалия (тикет, вероятно, выполнен, но не перемещён в done/review).
+ *
+ * Использование:
+ *   node check-anomalies.js
+ *
+ * Выводит результат в формате:
+ *   ---RESULT---
+ *   status: ok|anomalies_found|error
+ *   anomalies_count: N
+ *   anomalies: [{"id": "IMPL-001", "title": "...", "recommendation": "..."}]
+ *   ---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();
+const TICKETS_DIR = path.join(PROJECT_DIR, '.workflow', 'tickets');
+const IN_PROGRESS_DIR = path.join(TICKETS_DIR, 'in-progress');
+
+/**
+ * Проверяет, заполнен ли раздел результатов
+ * Возвращает true, если раздел содержит реальный контент (не только комментарии)
+ */
+function hasFilledResult(body) {
+  // Ищем раздел "Результат выполнения" или "Result"
+  // Используем более гибкий паттерн
+  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);
+
+  // Ищем подраздел Summary или "Что сделано"
+  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);
+
+  // Проверяем, что контент не пустой и не состоит только из комментариев
+  // Удаляем HTML комментарии и проверяем остаток
+  const withoutComments = summaryContent.replace(/<!--[\s\S]*?-->/g, '').trim();
+
+  // Если после удаления комментариев остался текст — раздел заполнен
+  return withoutComments.length > 0;
+}
+
+/**
+ * Основная функция проверки аномалий
+ */
+async function checkAnomalies() {
+  const anomalies = [];
+
+  // Проверяем существование директории in-progress
+  if (!fs.existsSync(IN_PROGRESS_DIR)) {
+    return {
+      status: 'ok',
+      anomalies_count: 0,
+      anomalies: [],
+      message: 'in-progress directory does not exist'
+    };
+  }
+
+  // Читаем все файлы в in-progress
+  let files;
+  try {
+    files = fs.readdirSync(IN_PROGRESS_DIR);
+  } catch (e) {
+    return {
+      status: 'error',
+      error: `Failed to read in-progress directory: ${e.message}`
+    };
+  }
+
+  // Фильтруем .md файлы (исключаем .gitkeep)
+  const ticketFiles = files.filter(f => f.endsWith('.md') && f !== '.gitkeep.md');
+
+  for (const file of ticketFiles) {
+    const filePath = path.join(IN_PROGRESS_DIR, file);
+    let content;
+
+    try {
+      content = fs.readFileSync(filePath, 'utf8');
+    } catch (e) {
+      anomalies.push({
+        id: file.replace('.md', ''),
+        title: 'Unknown (read error)',
+        recommendation: `Не удалось прочитать файл: ${e.message}`
+      });
+      continue;
+    }
+
+    // Парсим frontmatter для получения id и title
+    const { frontmatter, body } = parseFrontmatter(content);
+    const ticketId = frontmatter.id || file.replace('.md', '');
+    const ticketTitle = frontmatter.title || 'Unknown';
+
+    // Проверяем наличие заполненного результата
+    if (hasFilledResult(body)) {
+      anomalies.push({
+        id: ticketId,
+        title: ticketTitle,
+        recommendation: 'Проверьте тикет и переместите в done/ или review/ если выполнен'
+      });
+    }
+  }
+
+  return {
+    status: anomalies.length > 0 ? 'anomalies_found' : 'ok',
+    anomalies_count: anomalies.length,
+    anomalies: anomalies
+  };
+}
+
+// Main entry point
+checkAnomalies().then(result => {
+  printResult(result);
+
+  // Если найдены аномалии, выводим их в читаемом виде
+  if (result.anomalies && result.anomalies.length > 0) {
+    console.log('\n[ANOMALIES DETECTED]');
+    for (const anomaly of result.anomalies) {
+      console.log(`  - ${anomaly.id}: ${anomaly.title}`);
+      console.log(`    Recommendation: ${anomaly.recommendation}`);
+    }
+  }
+
+  if (result.status === 'error') {
+    process.exit(1);
+  }
+});

package/src/scripts/move-ticket.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+
+/**
+ * move-ticket.js - Скрипт для перемещения тикетов между директориями канбан-доски
+ *
+ * Использование:
+ *   node move-ticket.js <ticket_id> <target>
+ *
+ * Пример:
+ *   node move-ticket.js IMPL-001 in-progress
+ */
+
+import fs from 'fs';
+import path from 'path';
+import YAML from 'js-yaml';
+import { findProjectRoot } from '../lib/find-root.mjs';
+import { parseFrontmatter, printResult, serializeFrontmatter } 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 VALID_STATUSES = ['backlog', 'ready', 'in-progress', 'blocked', 'review', 'done'];
+
+// Таблица допустимых переходов
+const VALID_TRANSITIONS = {
+  'backlog': ['ready'],
+  'ready': ['in-progress', 'review'],
+  'in-progress': ['done', 'blocked', 'review'],
+  'blocked': ['ready'],
+  'review': ['done', 'ready', 'in-progress', 'blocked'],
+  'done': []
+};
+
+/**
+ * Определяет текущий статус тикета по расположению файла
+ */
+function getStatusFromPath(filePath) {
+  const fileName = path.basename(filePath);
+  for (const status of VALID_STATUSES) {
+    const statusDir = path.join(TICKETS_DIR, status);
+    const expectedPath = path.join(statusDir, fileName);
+    if (filePath === expectedPath) {
+      return status;
+    }
+  }
+  return null;
+}
+
+/**
+ * Проверяет допустимость перехода
+ */
+function isValidTransition(from, to) {
+  if (!VALID_STATUSES.includes(from)) {
+    return { valid: false, error: `Неверный исходный статус: ${from}` };
+  }
+  if (!VALID_STATUSES.includes(to)) {
+    return { valid: false, error: `Неверный целевой статус: ${to}. Доступные: ${VALID_STATUSES.join(', ')}` };
+  }
+
+  const allowedTransitions = VALID_TRANSITIONS[from] || [];
+  if (!allowedTransitions.includes(to)) {
+    return {
+      valid: false,
+      error: `Переход из ${from} в ${to} недопустим. Доступные переходы: ${allowedTransitions.join(', ') || 'нет'}`
+    };
+  }
+
+  return { valid: true };
+}
+
+/**
+ * Основная функция перемещения тикета
+ */
+async function moveTicket(ticketId, target) {
+  // Поиск файла тикета во всех директориях
+  let sourceDir = null;
+  let currentStatus = null;
+
+  for (const status of VALID_STATUSES) {
+    const statusDir = path.join(TICKETS_DIR, status);
+    const ticketPath = path.join(statusDir, `${ticketId}.md`);
+    if (fs.existsSync(ticketPath)) {
+      sourceDir = statusDir;
+      currentStatus = status;
+      break;
+    }
+  }
+
+  if (!sourceDir) {
+    return {
+      status: 'error',
+      ticket_id: ticketId,
+      error: `Тикет ${ticketId} не найден ни в одной из директорий`
+    };
+  }
+
+  // Проверка допустимости перехода
+  const transitionCheck = isValidTransition(currentStatus, target);
+  if (!transitionCheck.valid) {
+    return {
+      status: 'error',
+      ticket_id: ticketId,
+      from: currentStatus,
+      to: target,
+      error: transitionCheck.error
+    };
+  }
+
+  const sourcePath = path.join(sourceDir, `${ticketId}.md`);
+  const targetDir = path.join(TICKETS_DIR, target);
+  const targetPath = path.join(targetDir, `${ticketId}.md`);
+
+  // Чтение файла тикета
+  let content;
+  try {
+    content = fs.readFileSync(sourcePath, 'utf8');
+  } catch (e) {
+    return {
+      status: 'error',
+      ticket_id: ticketId,
+      error: `Не удалось прочитать файл: ${e.message}`
+    };
+  }
+
+  // Парсинг frontmatter
+  let frontmatter, body;
+  try {
+    ({ frontmatter, body } = parseFrontmatter(content));
+  } catch (e) {
+    return {
+      status: 'error',
+      ticket_id: ticketId,
+      error: e.message
+    };
+  }
+
+  // Обновление frontmatter
+  const now = new Date().toISOString();
+  frontmatter.status = target;
+  frontmatter.updated_at = now;
+
+  // Если переход в done, добавляем completed_at
+  if (target === 'done' && currentStatus !== 'done') {
+    frontmatter.completed_at = now;
+  }
+
+  // Если переход из blocked, удаляем blocked_reason
+  if (currentStatus === 'blocked' && frontmatter.blocked_reason) {
+    delete frontmatter.blocked_reason;
+  }
+
+  // Сериализация нового контента
+  const newContent = serializeFrontmatter(frontmatter) + body;
+
+  // Создание целевой директории если не существует
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
+
+  // Перемещение файла
+  try {
+    fs.renameSync(sourcePath, targetPath);
+  } catch (e) {
+    return {
+      status: 'error',
+      ticket_id: ticketId,
+      error: `Не удалось переместить файл: ${e.message}`
+    };
+  }
+
+  // Запись обновлённого контента
+  try {
+    fs.writeFileSync(targetPath, newContent, 'utf8');
+  } catch (e) {
+    return {
+      status: 'error',
+      ticket_id: ticketId,
+      error: `Не удалось записать файл: ${e.message}`
+    };
+  }
+
+  return {
+    status: 'moved',
+    ticket_id: ticketId,
+    from: currentStatus,
+    to: target
+  };
+}
+
+// Main entry point
+const rawArgs = process.argv.slice(2);
+let ticketId, target;
+
+if (rawArgs.length >= 2) {
+  // Прямой вызов: node move-ticket.js IMPL-001 in-progress
+  ticketId = rawArgs[0];
+  target = rawArgs[1];
+} else if (rawArgs.length === 1) {
+  // Вызов через pipeline runner: один аргумент — промпт с контекстом
+  // Формат: "skill-name\n\nContext:\n  ticket_id: X\n  target: Y\n..."
+  const prompt = rawArgs[0];
+  const ticketMatch = prompt.match(/ticket_id:\s*(\S+)/);
+  const targetMatch = prompt.match(/target:\s*(\S+)/);
+  ticketId = ticketMatch?.[1];
+  target = targetMatch?.[1];
+  if (!ticketId || !target) {
+    console.error('[ERROR] Cannot parse ticket_id or target from pipeline context');
+    printResult({ status: 'error', error: 'Missing ticket_id or target in pipeline context' });
+    process.exit(1);
+  }
+} else {
+  console.error('Usage: node move-ticket.js <ticket_id> <target>');
+  console.error('Example: node move-ticket.js IMPL-001 in-progress');
+  console.error('Available targets:', VALID_STATUSES.join(', '));
+  printResult({ status: 'error', error: 'Missing arguments' });
+  process.exit(1);
+}
+
+moveTicket(ticketId, target).then(result => {
+  printResult(result);
+  if (result.status === 'error') {
+    process.exit(1);
+  }
+});

package/src/scripts/move-to-ready.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+/**
+ * move-to-ready.js — Перемещает тикеты из backlog/ в ready/
+ *
+ * Читает список ticket IDs из контекста (поле ready_tickets),
+ * переданного pipeline runner'ом, и перемещает каждый тикет.
+ *
+ * Формат ready_tickets: "IMPL-002, DOCS-001" (через запятую)
+ *
+ * Выводит результат:
+ *   ---RESULT---
+ *   status: moved | default
+ *   moved: 2
+ *   ---RESULT---
+ */
+
+import fs from 'fs';
+import path from 'path';
+import YAML from 'js-yaml';
+import { findProjectRoot } from '../lib/find-root.mjs';
+import { parseFrontmatter, serializeFrontmatter } from '../lib/utils.mjs';
+
+// Корень проекта
+const PROJECT_DIR = findProjectRoot();
+const TICKETS_DIR = path.join(PROJECT_DIR, '.workflow', 'tickets');
+const BACKLOG_DIR = path.join(TICKETS_DIR, 'backlog');
+const READY_DIR = path.join(TICKETS_DIR, 'ready');
+
+/**
+ * Парсит список ticket IDs из промпта (контекста pipeline runner)
+ */
+function parseReadyTickets(prompt) {
+  const match = prompt.match(/ready_tickets:\s*(.+)/);
+  if (!match || !match[1].trim()) return [];
+  return match[1].split(',').map(id => id.trim()).filter(Boolean);
+}
+
+/**
+ * Перемещает один тикет из backlog/ в ready/
+ */
+function moveToReady(ticketId) {
+  const sourcePath = path.join(BACKLOG_DIR, `${ticketId}.md`);
+  const targetPath = path.join(READY_DIR, `${ticketId}.md`);
+
+  if (!fs.existsSync(sourcePath)) {
+    console.error(`[WARN] ${ticketId}: not found in backlog/, skipping`);
+    return false;
+  }
+
+  const content = fs.readFileSync(sourcePath, 'utf8');
+  const { frontmatter, body } = parseFrontmatter(content);
+
+  frontmatter.status = 'ready';
+  frontmatter.updated_at = new Date().toISOString();
+
+  const newContent = serializeFrontmatter(frontmatter) + body;
+
+  if (!fs.existsSync(READY_DIR)) {
+    fs.mkdirSync(READY_DIR, { recursive: true });
+  }
+
+  fs.renameSync(sourcePath, targetPath);
+  fs.writeFileSync(targetPath, newContent, 'utf8');
+  return true;
+}
+
+function printResult(result) {
+  console.log('---RESULT---');
+  for (const [key, value] of Object.entries(result)) {
+    console.log(`${key}: ${value}`);
+  }
+  console.log('---RESULT---');
+}
+
+async function main() {
+  const rawArgs = process.argv.slice(2);
+  const prompt = rawArgs[0] || '';
+
+  const ticketIds = parseReadyTickets(prompt);
+
+  if (ticketIds.length === 0) {
+    console.log('[INFO] No tickets to move');
+    printResult({ status: 'default', moved: 0 });
+    return;
+  }
+
+  console.log(`[INFO] Moving ${ticketIds.length} ticket(s) to ready/`);
+
+  let moved = 0;
+  for (const id of ticketIds) {
+    try {
+      if (moveToReady(id)) {
+        console.log(`[INFO] ${id}: backlog/ → ready/`);
+        moved++;
+      }
+    } catch (e) {
+      console.error(`[ERROR] ${id}: ${e.message}`);
+    }
+  }
+
+  console.log(`[INFO] Moved: ${moved}/${ticketIds.length}`);
+  printResult({ status: moved > 0 ? 'moved' : 'default', moved });
+}
+
+main().catch(e => {
+  console.error(`[ERROR] ${e.message}`);
+  printResult({ status: 'error', error: e.message });
+  process.exit(1);
+});

package/src/scripts/move-to-review.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+/**
+ * move-to-review.js — Перемещает тикет из in-progress/ в review/
+ *
+ * Читает ticket_id из контекста pipeline runner'а.
+ *
+ * Выводит результат:
+ *   ---RESULT---
+ *   status: moved | error
+ *   ticket_id: IMPL-001
+ *   ---RESULT---
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { findProjectRoot } from '../lib/find-root.mjs';
+import { parseFrontmatter, serializeFrontmatter, printResult } from '../lib/utils.mjs';
+
+// Корень проекта
+const PROJECT_DIR = findProjectRoot();
+const TICKETS_DIR = path.join(PROJECT_DIR, '.workflow', 'tickets');
+const IN_PROGRESS_DIR = path.join(TICKETS_DIR, 'in-progress');
+const REVIEW_DIR = path.join(TICKETS_DIR, 'review');
+
+/**
+ * Парсит ticket_id из промпта (контекста pipeline runner)
+ */
+function parseTicketId(prompt) {
+  const match = prompt.match(/ticket_id:\s*(\S+)/);
+  return match ? match[1].trim() : null;
+}
+
+/**
+ * Перемещает тикет из in-progress/ в review/
+ */
+function moveToReview(ticketId) {
+  const sourcePath = path.join(IN_PROGRESS_DIR, `${ticketId}.md`);
+  const targetPath = path.join(REVIEW_DIR, `${ticketId}.md`);
+
+  if (!fs.existsSync(sourcePath)) {
+    return { status: 'error', ticket_id: ticketId, error: `${ticketId} not found in in-progress/` };
+  }
+
+  const content = fs.readFileSync(sourcePath, 'utf8');
+  const { frontmatter, body } = parseFrontmatter(content);
+
+  frontmatter.status = 'review';
+  frontmatter.updated_at = new Date().toISOString();
+
+  const newContent = serializeFrontmatter(frontmatter) + body;
+
+  if (!fs.existsSync(REVIEW_DIR)) {
+    fs.mkdirSync(REVIEW_DIR, { recursive: true });
+  }
+
+  fs.renameSync(sourcePath, targetPath);
+  fs.writeFileSync(targetPath, newContent, 'utf8');
+
+  return { status: 'moved', ticket_id: ticketId, from: 'in-progress', to: 'review' };
+}
+
+async function main() {
+  const rawArgs = process.argv.slice(2);
+  const prompt = rawArgs[0] || '';
+
+  const ticketId = parseTicketId(prompt);
+
+  if (!ticketId) {
+    console.error('[ERROR] No ticket_id in context');
+    printResult({ status: 'error', error: 'Missing ticket_id' });
+    process.exit(1);
+  }
+
+  console.log(`[INFO] Moving ${ticketId}: in-progress/ → review/`);
+  const result = moveToReview(ticketId);
+  printResult(result);
+
+  if (result.status === 'error') {
+    process.exit(1);
+  }
+}
+
+main().catch(e => {
+  console.error(`[ERROR] ${e.message}`);
+  printResult({ status: 'error', error: e.message });
+  process.exit(1);
+});