workflow-ai 1.0.0 → 1.0.2

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "workflow-ai",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "AI Agent Workflow Coordinator — kanban-based pipeline for AI coding agents",
   "type": "module",
-  "bin": { "workflow": "./bin/workflow.mjs" },
+  "bin": {
+    "workflow": "./bin/workflow.mjs"
+  },
   "files": [
     "bin/",
     "src/cli.mjs",
     "src/init.mjs",
     "src/runner.mjs",
+    "src/wf-loader.mjs",
     "src/lib/",
     "src/scripts/",
     "src/skills/",
@@ -16,9 +19,13 @@
     "configs/",
     "agent-templates/"
   ],
-  "engines": { "node": ">=18.0.0" },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "scripts": {
     "test": "node --test src/tests/*.test.mjs"
   },
-  "dependencies": { "js-yaml": "^4.1.0" }
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  }
 }

package/src/scripts/check-conditions.js

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+
+/**
+ * check-conditions.js — Проверяет условия тикетов в backlog/ и выводит список готовых
+ *
+ * Использование:
+ *   node check-conditions.js
+ *
+ * Выводит результат в формате:
+ *   ---RESULT---
+ *   status: has_ready
+ *   ready_tickets: IMPL-002, DOCS-001
+ *   ---RESULT---
+ *
+ * или если готовых нет, но есть тикеты в ready/:
+ *   ---RESULT---
+ *   status: default
+ *   ready_tickets:
+ *   ---RESULT---
+ *
+ * или если backlog пуст и нет тикетов в ready/:
+ *   ---RESULT---
+ *   status: empty
+ *   ready_tickets:
+ *   ---RESULT---
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { findProjectRoot } from '../lib/find-root.mjs';
+import { parseFrontmatter, printResult } from '../lib/utils.mjs';
+
+const PROJECT_DIR = findProjectRoot();
+const WORKFLOW_DIR = path.join(PROJECT_DIR, '.workflow');
+const TICKETS_DIR = path.join(WORKFLOW_DIR, 'tickets');
+const BACKLOG_DIR = path.join(TICKETS_DIR, 'backlog');
+const READY_DIR = path.join(TICKETS_DIR, 'ready');
+const DONE_DIR = path.join(TICKETS_DIR, 'done');
+
+/**
+ * Проверяет одно условие тикета
+ */
+function checkCondition(condition) {
+  const { type, value } = condition;
+
+  switch (type) {
+    case 'file_exists':
+      return fs.existsSync(path.join(PROJECT_DIR, value));
+
+    case 'file_not_exists':
+      return !fs.existsSync(path.join(PROJECT_DIR, value));
+
+    case 'tasks_completed': {
+      const ids = Array.isArray(value) ? value : [value];
+      return ids.every(taskId => fs.existsSync(path.join(DONE_DIR, `${taskId}.md`)));
+    }
+
+    case 'date_after':
+      return new Date() > new Date(value);
+
+    case 'date_before':
+      return new Date() < new Date(value);
+
+    case 'manual_approval':
+      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 => fs.existsSync(path.join(DONE_DIR, `${depId}.md`)));
+}
+
+/**
+ * Считывает все тикеты из директории
+ */
+function readTickets(dir) {
+  if (!fs.existsSync(dir)) return [];
+
+  const tickets = [];
+  const files = fs.readdirSync(dir).filter(f => f.endsWith('.md') && f !== '.gitkeep.md');
+
+  for (const file of files) {
+    const filePath = path.join(dir, file);
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      const { frontmatter } = parseFrontmatter(content);
+      tickets.push({ id: frontmatter.id || file.replace('.md', ''), frontmatter });
+    } catch (e) {
+      console.error(`[WARN] Failed to read ticket ${file}: ${e.message}`);
+    }
+  }
+
+  return tickets;
+}
+
+/**
+ * Нормализует входное значение в формат PLAN-NNN.
+ * Принимает: "PLAN-007", "7", "007", "plan-7", "plans/PLAN-007.md", "/abs/path/PLAN-007.md"
+ */
+function normalizePlanId(raw) {
+  if (!raw) return null;
+
+  // Извлекаем имя файла если передан путь
+  const basename = path.basename(raw, '.md');
+
+  // Уже в формате PLAN-NNN (регистронезависимо)
+  const full = basename.match(/^plan-(\d+)$/i);
+  if (full) return `PLAN-${String(parseInt(full[1], 10)).padStart(3, '0')}`;
+
+  // Просто цифра или число: "7", "007"
+  const num = raw.trim().match(/^(\d+)$/);
+  if (num) return `PLAN-${String(parseInt(num[1], 10)).padStart(3, '0')}`;
+
+  return null;
+}
+
+/**
+ * Извлекает plan_id из аргументов командной строки (контекст пайплайна)
+ */
+function extractPlanId() {
+  const prompt = process.argv.slice(2)[0] || '';
+  const match = prompt.match(/plan_id:\s*(\S+)/i);
+  return match ? normalizePlanId(match[1]) : null;
+}
+
+/**
+ * Проверяет все тикеты в backlog/ и возвращает список готовых
+ */
+function checkBacklog(planId) {
+  const allTickets = readTickets(BACKLOG_DIR);
+  const tickets = planId
+    ? allTickets.filter(t => t.frontmatter.parent_plan === planId)
+    : allTickets;
+
+  const ready = [];
+  const waiting = [];
+
+  for (const ticket of tickets) {
+    const { frontmatter, id } = ticket;
+    const conditions = frontmatter.conditions || [];
+    const dependencies = frontmatter.dependencies || [];
+
+    const depsMet = checkDependencies(dependencies);
+    const conditionsMet = conditions.every(checkCondition);
+
+    if (depsMet && conditionsMet) {
+      ready.push(id);
+    } else {
+      const reasons = [];
+      if (!depsMet) reasons.push(`ждёт зависимости: ${dependencies.join(', ')}`);
+      conditions.forEach(c => {
+        if (!checkCondition(c)) reasons.push(`условие не выполнено: ${c.type}`);
+      });
+      waiting.push({ id, reasons });
+    }
+  }
+
+  return { ready, waiting, total: tickets.length };
+}
+
+async function main() {
+  const planId = extractPlanId();
+
+  if (planId) {
+    console.log(`[INFO] Filtering by plan_id: ${planId}`);
+  }
+
+  console.log(`[INFO] Scanning backlog/: ${BACKLOG_DIR}`);
+
+  const { ready, waiting, total } = checkBacklog(planId);
+
+  console.log(`[INFO] Total in backlog${planId ? ` (plan ${planId})` : ''}: ${total}`);
+  console.log(`[INFO] Ready: ${ready.length}, Waiting: ${waiting.length}`);
+
+  if (ready.length > 0) {
+    console.log(`[INFO] Ready tickets: ${ready.join(', ')}`);
+  }
+
+  for (const { id, reasons } of waiting) {
+    console.log(`[INFO] ${id}: ${reasons.join('; ')}`);
+  }
+
+  if (ready.length > 0) {
+    printResult({ status: 'has_ready', ready_tickets: ready.join(', ') });
+    return;
+  }
+
+  // Нет готовых — проверяем есть ли что-то в ready/
+  const readyDirTickets = readTickets(READY_DIR);
+  if (readyDirTickets.length > 0) {
+    console.log(`[INFO] No new ready tickets, but ready/ has ${readyDirTickets.length} ticket(s)`);
+    printResult({ status: 'default', ready_tickets: '' });
+  } else {
+    console.log('[INFO] No ready tickets and ready/ is empty');
+    printResult({ status: 'empty', ready_tickets: '' });
+  }
+}
+
+main().catch(e => {
+  console.error(`[ERROR] ${e.message}`);
+  printResult({ status: 'error', error: e.message });
+  process.exit(1);
+});

package/src/scripts/move-ticket.js

@@ -140,7 +140,6 @@ async function moveTicket(ticketId, target) {
 
   // Обновление frontmatter
   const now = new Date().toISOString();
-  frontmatter.status = target;
   frontmatter.updated_at = now;
 
   // Если переход в done, добавляем completed_at

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

@@ -51,7 +51,6 @@ function moveToReady(ticketId) {
   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;

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

@@ -45,7 +45,6 @@ function moveToReview(ticketId) {
   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;

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

@@ -20,7 +20,6 @@
 
 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';
 
@@ -42,22 +41,20 @@ function checkCondition(condition) {
 
   switch (type) {
     case 'file_exists':
-      const filePath = path.join(WORKFLOW_DIR, value);
+      const filePath = path.join(PROJECT_DIR, value);
       return fs.existsSync(filePath);
 
     case 'file_not_exists':
-      const filePath2 = path.join(WORKFLOW_DIR, value);
+      const filePath2 = path.join(PROJECT_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;
+      const ids = Array.isArray(value) ? value : [value];
+      return ids.every(taskId => {
+        const donePath = path.join(DONE_DIR, `${taskId}.md`);
+        return fs.existsSync(donePath);
+      });
 
     case 'date_after':
       return new Date() > new Date(value);

package/src/wf-loader.mjs

@@ -0,0 +1,30 @@
+/**
+ * ESM loader that adds wf's node_modules as a fallback for module resolution.
+ * Used via NODE_OPTIONS=--import to allow target project scripts to use
+ * wf's dependencies without installing them locally.
+ */
+import { register } from 'node:module';
+import { pathToFileURL, fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const wfNodeModules = join(__dirname, '..', 'node_modules');
+
+register(
+  'data:text/javascript,' + encodeURIComponent(`
+    import { pathToFileURL } from 'node:url';
+    const base = ${JSON.stringify('file:///' + wfNodeModules.replace(/\\/g, '/') + '/')};
+
+    export async function resolve(specifier, context, nextResolve) {
+      try {
+        return await nextResolve(specifier, context);
+      } catch (err) {
+        if (err.code === 'ERR_MODULE_NOT_FOUND' && !specifier.startsWith('.') && !specifier.startsWith('/')) {
+          return nextResolve(specifier, { ...context, parentURL: base });
+        }
+        throw err;
+      }
+    }
+  `),
+  pathToFileURL('./')
+);

package/templates/ticket-template.md

@@ -4,7 +4,6 @@
 
 id: "{TYPE}-{NNN}"              # IMPL-001, FIX-015, PLAN-003
 title: "Название задачи"
-status: backlog                  # backlog | ready | in-progress | blocked | review | done
 priority: 3                      # 1-критический, 2-высокий, 3-средний, 4-низкий, 5-когда-нибудь
 
 # Тип задачи

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

@@ -1,140 +0,0 @@
----
-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)