workflow-ai 1.0.60 → 1.0.62

package/src/scripts/check-plan-templates.js

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+
+/**
+ * check-plan-templates.js — Проверяет шаблоны планов и создаёт планы по триггерам.
+ *
+ * Логика:
+ *   1. Читает все .md из plans/templates/
+ *   2. Для каждого с enabled: true — проверяет триггер
+ *   3. Если триггер сработал — создаёт план в plans/current/ со статусом approved
+ *   4. Обновляет last_triggered в шаблоне
+ *
+ * Типы триггеров:
+ *   - daily          — раз в день
+ *   - weekly         — в указанные дни недели (params.days_of_week: [0-6])
+ *   - date_after     — однократно после указанной даты (params.date)
+ *   - interval_days  — каждые N дней (params.days)
+ *
+ * Результат:
+ *   - plan_created + plan_ids — созданы планы
+ *   - no_triggers — ни один триггер не сработал
+ *   - error — ошибка
+ *
+ * Использование:
+ *   node check-plan-templates.js
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { findProjectRoot } from 'workflow-ai/lib/find-root.mjs';
+import { parseFrontmatter, serializeFrontmatter, printResult } from 'workflow-ai/lib/utils.mjs';
+
+const PROJECT_DIR = findProjectRoot();
+const WORKFLOW_DIR = path.join(PROJECT_DIR, '.workflow');
+const TEMPLATES_DIR = path.join(WORKFLOW_DIR, 'plans', 'templates');
+const PLANS_DIR = path.join(WORKFLOW_DIR, 'plans', 'current');
+const TICKETS_DIR = path.join(WORKFLOW_DIR, 'tickets');
+const DONE_DIR = 'done';
+
+/**
+ * Проверяет, сработал ли триггер шаблона.
+ *
+ * @param {{ type: string, params?: object }} trigger — конфигурация триггера
+ * @param {string} lastTriggered — ISO-дата последнего срабатывания (или пустая строка)
+ * @param {Date} [now] — текущая дата (для тестов)
+ * @returns {boolean}
+ */
+export function evaluateTrigger(trigger, lastTriggered, now = new Date()) {
+  if (!trigger || !trigger.type) return false;
+
+  const todayStr = now.toISOString().slice(0, 10);
+  const lastDate = lastTriggered ? String(lastTriggered).slice(0, 10) : null;
+
+  switch (trigger.type) {
+    case 'daily':
+      return lastDate !== todayStr;
+
+    case 'weekly': {
+      const dayOfWeek = now.getDay();
+      const targetDays = trigger.params?.days_of_week || [1];
+      if (!targetDays.includes(dayOfWeek)) return false;
+      return lastDate !== todayStr;
+    }
+
+    case 'date_after': {
+      const targetDate = trigger.params?.date;
+      if (!targetDate) return false;
+      if (todayStr < targetDate) return false;
+      return !lastDate || lastDate < targetDate;
+    }
+
+    case 'interval_days': {
+      const intervalDays = trigger.params?.days || 1;
+      if (!lastDate) return true;
+      const lastTime = new Date(lastDate).getTime();
+      const elapsed = (now.getTime() - lastTime) / (1000 * 60 * 60 * 24);
+      return elapsed >= intervalDays;
+    }
+
+    default:
+      console.error(`[WARN] Unknown trigger type: ${trigger.type}`);
+      return false;
+  }
+}
+
+/**
+ * Генерирует следующий ID плана (PLAN-NNN), сканируя plans/current/.
+ *
+ * @param {string} plansDir — путь к директории plans/current/
+ * @returns {string}
+ */
+export function generateNextPlanId(plansDir) {
+  const archiveDir = path.join(path.dirname(plansDir), 'archive');
+  let maxNum = 0;
+
+  for (const dir of [plansDir, archiveDir]) {
+    if (!fs.existsSync(dir)) continue;
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const match = file.match(/^PLAN-(\d+)\.md$/i);
+      if (match) {
+        const num = parseInt(match[1], 10);
+        if (num > maxNum) maxNum = num;
+      }
+    }
+  }
+
+  return `PLAN-${String(maxNum + 1).padStart(3, '0')}`;
+}
+
+/**
+ * Создаёт план из шаблона.
+ *
+ * @param {string} templatePath — полный путь к файлу шаблона
+ * @param {object} templateFm — frontmatter шаблона
+ * @param {string} templateBody — тело шаблона
+ * @param {string} planId — ID нового плана
+ * @param {string} todayStr — сегодняшняя дата ISO
+ * @returns {string} путь к созданному плану
+ */
+function createPlanFromTemplate(templatePath, templateFm, templateBody, planId, todayStr) {
+  const planFm = {
+    id: planId,
+    title: `${templateFm.title} (${todayStr})`,
+    status: 'approved',
+    source_template: templateFm.id,
+    author: templateFm.author || 'system',
+    created_at: todayStr,
+    updated_at: todayStr,
+    completed_at: '',
+    previous_plan: '',
+    related_reports: []
+  };
+
+  const planContent = serializeFrontmatter(planFm) + '\n' + templateBody;
+  const planFileName = `${planId}.md`;
+  const planPath = path.join(PLANS_DIR, planFileName);
+
+  if (!fs.existsSync(PLANS_DIR)) {
+    fs.mkdirSync(PLANS_DIR, { recursive: true });
+  }
+
+  fs.writeFileSync(planPath, planContent, 'utf8');
+  console.log(`[INFO] Created plan ${planId} from template ${templateFm.id}`);
+
+  return planPath;
+}
+
+/**
+ * Обновляет last_triggered в шаблоне.
+ *
+ * @param {string} templatePath — полный путь к файлу шаблона
+ * @param {object} frontmatter — frontmatter шаблона
+ * @param {string} body — тело шаблона
+ * @param {string} todayStr — сегодняшняя дата ISO
+ */
+function updateTemplateLastTriggered(templatePath, frontmatter, body, todayStr) {
+  frontmatter.last_triggered = todayStr;
+  const content = serializeFrontmatter(frontmatter) + '\n' + body;
+  fs.writeFileSync(templatePath, content, 'utf8');
+  console.log(`[INFO] Updated last_triggered for ${frontmatter.id} to ${todayStr}`);
+}
+
+/**
+ * Проверяет, есть ли незавершённые тикеты по планам, созданным из данного шаблона.
+ * Тикет считается незавершённым, если он находится не в done/.
+ *
+ * @param {string} templateId — ID шаблона (например, "TMPL-001")
+ * @returns {boolean} true если есть активные тикеты
+ */
+export function hasActiveTicketsForTemplate(templateId) {
+  // 1. Найти все планы с source_template === templateId
+  const planPaths = [];
+  if (fs.existsSync(PLANS_DIR)) {
+    for (const file of fs.readdirSync(PLANS_DIR).filter(f => f.endsWith('.md'))) {
+      const content = fs.readFileSync(path.join(PLANS_DIR, file), 'utf8');
+      const { frontmatter } = parseFrontmatter(content);
+      if (frontmatter.source_template === templateId) {
+        planPaths.push(`plans/current/${file}`);
+      }
+    }
+  }
+
+  if (planPaths.length === 0) return false;
+
+  // 2. Проверить тикеты во всех папках кроме done/
+  if (!fs.existsSync(TICKETS_DIR)) return false;
+
+  const ticketDirs = fs.readdirSync(TICKETS_DIR, { withFileTypes: true })
+    .filter(d => d.isDirectory() && d.name !== DONE_DIR)
+    .map(d => d.name);
+
+  for (const dir of ticketDirs) {
+    const dirPath = path.join(TICKETS_DIR, dir);
+    const files = fs.readdirSync(dirPath).filter(f => f.endsWith('.md'));
+
+    for (const file of files) {
+      const content = fs.readFileSync(path.join(dirPath, file), 'utf8');
+      const { frontmatter } = parseFrontmatter(content);
+      if (frontmatter.parent_plan && planPaths.includes(frontmatter.parent_plan)) {
+        return true;
+      }
+    }
+  }
+
+  return false;
+}
+
+async function main() {
+  if (!fs.existsSync(TEMPLATES_DIR)) {
+    console.log('[INFO] Templates directory does not exist, nothing to check');
+    printResult({ status: 'no_triggers' });
+    return;
+  }
+
+  const templateFiles = fs.readdirSync(TEMPLATES_DIR)
+    .filter(f => f.endsWith('.md'));
+
+  if (templateFiles.length === 0) {
+    console.log('[INFO] No template files found');
+    printResult({ status: 'no_triggers' });
+    return;
+  }
+
+  console.log(`[INFO] Found ${templateFiles.length} template(s) in plans/templates/`);
+
+  const now = new Date();
+  const todayStr = now.toISOString().slice(0, 10);
+  const createdPlanIds = [];
+
+  for (const file of templateFiles) {
+    const templatePath = path.join(TEMPLATES_DIR, file);
+
+    try {
+      const content = fs.readFileSync(templatePath, 'utf8');
+      const { frontmatter, body } = parseFrontmatter(content);
+
+      if (frontmatter.type !== 'template') {
+        console.log(`[INFO] Skipping ${file} — type is not "template"`);
+        continue;
+      }
+
+      if (!frontmatter.enabled) {
+        console.log(`[INFO] Skipping ${file} — disabled`);
+        continue;
+      }
+
+      if (!frontmatter.trigger) {
+        console.log(`[WARN] Skipping ${file} — no trigger defined`);
+        continue;
+      }
+
+      const shouldTrigger = evaluateTrigger(frontmatter.trigger, frontmatter.last_triggered, now);
+
+      if (!shouldTrigger) {
+        console.log(`[INFO] Template ${frontmatter.id}: trigger not fired`);
+        continue;
+      }
+
+      console.log(`[INFO] Template ${frontmatter.id}: trigger fired!`);
+
+      if (hasActiveTicketsForTemplate(frontmatter.id)) {
+        console.log(`[INFO] Template ${frontmatter.id}: skipped — active tickets exist from previous plan`);
+        continue;
+      }
+
+      const planId = generateNextPlanId(PLANS_DIR);
+      createPlanFromTemplate(templatePath, frontmatter, body, planId, todayStr);
+      updateTemplateLastTriggered(templatePath, frontmatter, body, todayStr);
+      createdPlanIds.push(planId);
+
+    } catch (e) {
+      console.error(`[WARN] Failed to process template ${file}: ${e.message}`);
+    }
+  }
+
+  if (createdPlanIds.length > 0) {
+    console.log(`[INFO] Created ${createdPlanIds.length} plan(s): ${createdPlanIds.join(', ')}`);
+    printResult({ status: 'plan_created', plan_ids: createdPlanIds.join(', ') });
+  } else {
+    console.log('[INFO] No triggers fired');
+    printResult({ status: 'no_triggers' });
+  }
+}
+
+// Запуск main() только при прямом вызове (не при импорте)
+const isDirectRun = process.argv[1] && (
+  process.argv[1].endsWith('check-plan-templates.js') ||
+  process.argv[1].endsWith('check-plan-templates')
+);
+
+if (isDirectRun) {
+  main().catch(e => {
+    console.error(`[ERROR] ${e.message}`);
+    printResult({ status: 'error', error: e.message });
+    process.exit(1);
+  });
+}

package/src/scripts/check-relevance.js

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+
+/**
+ * check-relevance.js - Скрипт проверки актуальности тикета
+ *
+ * Использование:
+ *   node check-relevance.js <path-to-ticket>
+ *
+ * Вывод:
+ *   ---RESULT---
+ *   verdict: relevant|irrelevant
+ *   reason: ...
+ *   ---RESULT---
+ */
+
+import fs from "fs";
+import path from "path";
+import YAML from "workflow-ai/lib/js-yaml.mjs";
+import { findProjectRoot } from "workflow-ai/lib/find-root.mjs";
+import {
+  parseFrontmatter,
+  serializeFrontmatter,
+  getLastReviewStatus,
+} from "workflow-ai/lib/utils.mjs";
+
+const PROJECT_DIR = findProjectRoot();
+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",
+  "archive",
+];
+
+function getCurrentStatus(ticketPath) {
+  const fileName = path.basename(ticketPath);
+  for (const status of VALID_STATUSES) {
+    const statusDir = path.join(TICKETS_DIR, status);
+    const expectedPath = path.join(statusDir, fileName);
+    if (ticketPath === expectedPath) {
+      return status;
+    }
+  }
+  return null;
+}
+
+function extractPlanId(parentPlan) {
+  if (!parentPlan) return null;
+  const basename = path.basename(parentPlan, ".md");
+  const match = basename.match(/^PLAN-(\d+)$/i);
+  if (match) {
+    return `PLAN-${String(parseInt(match[1], 10)).padStart(3, "0")}`;
+  }
+  return basename;
+}
+
+function getDodCompletion(content) {
+  const dodSectionMatch = content.match(/## Критерии готовности.*?\n([\s\S]*?)(?=\n## |\n# |\z)/i);
+  if (!dodSectionMatch) return { completed: false, total: 0, checked: 0 };
+
+  const section = dodSectionMatch[1];
+  const checkedMatches = section.match(/\[x\]/gi) || [];
+  const uncheckedMatches = section.match(/\[ \]/gi) || [];
+
+  const total = checkedMatches.length + uncheckedMatches.length;
+  const completed = total > 0 && uncheckedMatches.length === 0;
+
+  return { completed, total, checked: checkedMatches.length };
+}
+
+function hasResultSection(content) {
+  const resultPatterns = [
+    /##\s*Result/gi,
+    /##\s*Результат/gi,
+    /##\s*Результат выполнения/gi,
+  ];
+  return resultPatterns.some((pattern) => pattern.test(content));
+}
+
+function getBlockedSection(content) {
+  const blockedMatch = content.match(/##\s*Блокировки\s*\n([\s\S]*?)(?=\n## |\n# |\z)/i);
+  return blockedMatch ? blockedMatch[1].trim() : "";
+}
+
+function findTicketInColumns(ticketId) {
+  for (const status of VALID_STATUSES) {
+    const statusDir = path.join(TICKETS_DIR, status);
+    const ticketPath = path.join(statusDir, `${ticketId}.md`);
+    if (fs.existsSync(ticketPath)) {
+      return status;
+    }
+  }
+  return null;
+}
+
+async function checkRelevance(ticketPath) {
+  if (!fs.existsSync(ticketPath)) {
+    return {
+      verdict: "relevant",
+      reason: "file_not_found",
+      error: `Ticket file not found: ${ticketPath}`,
+    };
+  }
+
+  let content;
+  try {
+    content = fs.readFileSync(ticketPath, "utf8");
+  } catch (e) {
+    return {
+      verdict: "relevant",
+      reason: "read_error",
+      error: `Failed to read ticket: ${e.message}`,
+    };
+  }
+
+  let frontmatter, body;
+  try {
+    ({ frontmatter, body } = parseFrontmatter(content));
+  } catch (e) {
+    return {
+      verdict: "relevant",
+      reason: "invalid_frontmatter",
+      warning: `Failed to parse frontmatter: ${e.message}. Treating as relevant (fail-safe).`,
+    };
+  }
+
+  const currentStatus = getCurrentStatus(ticketPath);
+  const fullContent = body;
+
+  const lastReview = getLastReviewStatus(fullContent);
+  if (lastReview === "skipped") {
+    return { verdict: "irrelevant", reason: "already_skipped" };
+  }
+  if (lastReview === "failed") {
+    return { verdict: "relevant", reason: "review_failed_needs_rework" };
+  }
+
+  if (frontmatter.blocked === true || frontmatter.blocked === "true") {
+    return { verdict: "relevant", reason: "blocked" };
+  }
+
+  const blockedSection = getBlockedSection(fullContent);
+  const hasActiveBlockers = blockedSection.length > 0 && !blockedSection.includes("нет");
+  if (hasActiveBlockers) {
+    return { verdict: "relevant", reason: "blocked" };
+  }
+
+  const parentPlan = frontmatter.parent_plan;
+  if (parentPlan) {
+    const planId = extractPlanId(parentPlan);
+    if (planId) {
+      const planPath = path.join(WORKFLOW_DIR, "plans", "current", `${planId}.md`);
+      if (fs.existsSync(planPath)) {
+        try {
+          const planContent = fs.readFileSync(planPath, "utf8");
+          const { frontmatter: planFm } = parseFrontmatter(planContent);
+          const planStatus = planFm.status;
+          if (["completed", "archived", "cancelled"].includes(planStatus)) {
+            return { verdict: "irrelevant", reason: "plan_inactive" };
+          }
+        } catch (e) {
+          // fail-safe: treat as relevant
+        }
+      } else {
+        // fail-safe: treat as relevant
+      }
+    }
+  } else {
+    // fail-safe: parent_plan is empty
+  }
+
+  const dod = getDodCompletion(fullContent);
+  const hasResult = hasResultSection(fullContent);
+
+  if (dod.completed && hasResult) {
+    if (lastReview === "passed") {
+      return { verdict: "irrelevant", reason: "dod_completed" };
+    } else if (lastReview === null) {
+      return { verdict: "relevant", reason: "needs_review" };
+    }
+  }
+
+  const dependencies = frontmatter.dependencies || [];
+  if (dependencies.length > 0) {
+    for (const dep of dependencies) {
+      const depStatus = findTicketInColumns(dep);
+      if (depStatus === null) {
+        return { verdict: "irrelevant", reason: "dependencies_inactive" };
+      }
+      if (depStatus === "blocked") {
+        try {
+          const blockedDir = path.join(TICKETS_DIR, "blocked", `${dep}.md`);
+          const blockedContent = fs.readFileSync(blockedDir, "utf8");
+          const { body: blockedBody } = parseFrontmatter(blockedContent);
+          if (blockedBody.toLowerCase().includes("неактуально")) {
+            return { verdict: "irrelevant", reason: "dependencies_inactive" };
+          }
+        } catch (e) {
+          // ignore
+        }
+      }
+    }
+  }
+
+  return { verdict: "relevant", reason: "all_checks_passed" };
+}
+
+function addSkippedReview(ticketPath, reason) {
+  const now = new Date();
+  const date = now.toISOString().slice(0, 10);
+
+  let content;
+  try {
+    content = fs.readFileSync(ticketPath, "utf8");
+  } catch (e) {
+    throw new Error(`Failed to read ticket: ${e.message}`);
+  }
+
+  let { frontmatter, body } = parseFrontmatter(content);
+
+  const reviewSectionMatch = body.match(/##\s*Ревью\s*\n([\s\S]*)/i);
+  let newBody;
+
+  if (reviewSectionMatch) {
+    const reviewContent = reviewSectionMatch[1];
+    const lines = reviewContent.split("\n");
+    let insertIndex = 0;
+    for (let i = 0; i < lines.length; i++) {
+      if (lines[i].trim().startsWith("|") && lines[i].includes("---")) {
+        insertIndex = i + 1;
+        break;
+      }
+    }
+
+    const newRow = `| ${date} | ⏭️ skipped | ${reason} |`;
+    lines.splice(insertIndex, 0, newRow);
+    newBody = body.slice(0, reviewSectionMatch.index) + lines.join("\n");
+  } else {
+    const reviewTable = `\n## Ревью\n\n| Дата | Статус | Самари |\n|------|--------|--------|\n| ${date} | ⏭️ skipped | ${reason} |\n`;
+    newBody = body.trimEnd() + reviewTable;
+  }
+
+  const newContent = serializeFrontmatter(frontmatter) + newBody;
+  fs.writeFileSync(ticketPath, newContent, "utf8");
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  let ticketPath;
+
+  if (args.length === 0) {
+    console.error("Usage: node check-relevance.js <path-to-ticket>");
+    console.error("Example: node check-relevance.js .workflow/tickets/in-progress/IMPL-001.md");
+    process.exit(1);
+  } else if (args.length === 1) {
+    const arg = args[0];
+    const ticketMatch = arg.match(/ticket_id:\s*(\S+)/);
+    if (ticketMatch) {
+      const ticketId = ticketMatch[1];
+      ticketPath = path.join(TICKETS_DIR, "in-progress", `${ticketId}.md`);
+    } else if (/^[A-Z]+-\d+$/i.test(arg)) {
+      // Чистый ticket_id (например, IMPL-001) — резолвим в in-progress
+      ticketPath = path.join(TICKETS_DIR, "in-progress", `${arg}.md`);
+    } else {
+      ticketPath = arg;
+    }
+  } else {
+    ticketPath = args[0];
+  }
+
+  if (!path.isAbsolute(ticketPath)) {
+    ticketPath = path.resolve(process.cwd(), ticketPath);
+  }
+
+  const result = await checkRelevance(ticketPath);
+
+  if (result.warning && !result.error) {
+    console.error(`[WARNING] ${result.warning}`);
+  }
+
+  if (result.error) {
+    console.error(`[ERROR] ${result.error}`);
+  }
+
+  if (result.verdict === "irrelevant") {
+    try {
+      addSkippedReview(ticketPath, result.reason);
+    } catch (e) {
+      console.error(`[ERROR] Failed to add review entry: ${e.message}`);
+    }
+  }
+
+  console.log("---RESULT---");
+  console.log(`verdict: ${result.verdict}`);
+  console.log(`reason: ${result.reason}`);
+  console.log("---RESULT---");
+
+  if (result.error) {
+    process.exit(1);
+  }
+}
+
+main().catch((e) => {
+  console.error("[FATAL]", e.message);
+  process.exit(1);
+});