workflow-ai 1.0.37 → 1.0.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workflow-ai",
-  "version": "1.0.37",
+  "version": "1.0.39",
   "description": "AI Agent Workflow Coordinator — kanban-based pipeline for AI coding agents",
   "type": "module",
   "bin": {

package/src/lib/utils.mjs

@@ -198,7 +198,7 @@ export function checkAndClosePlan(workflowDir, planId) {
   }
 
   const ticketsDir = path.join(workflowDir, 'tickets');
-  const allDirNames = ['backlog', 'ready', 'in-progress', 'blocked', 'review', 'done'];
+  const allDirNames = ['backlog', 'ready', 'in-progress', 'blocked', 'review', 'done', 'archive'];
   const allTickets = [];
 
   for (const dirName of allDirNames) {
@@ -218,7 +218,7 @@ export function checkAndClosePlan(workflowDir, planId) {
   }
 
   const total = allTickets.length;
-  const done = allTickets.filter(t => t.dir === 'done').length;
+  const done = allTickets.filter(t => t.dir === 'done' || t.dir === 'archive').length;
 
   if (total === 0) {
     return { closed: false, reason: 'No tickets found for plan', total, done };
@@ -255,5 +255,32 @@ export function checkAndClosePlan(workflowDir, planId) {
 
   fs.writeFileSync(planPath, serializeFrontmatter(frontmatter) + body, 'utf8');
 
-  return { closed: true, reason: 'All tickets done', total, done };
+  // Архивируем все done-тикеты этого плана
+  const archiveDir = path.join(ticketsDir, 'archive');
+  if (!fs.existsSync(archiveDir)) {
+    fs.mkdirSync(archiveDir, { recursive: true });
+  }
+
+  const archived = [];
+  const doneDir = path.join(ticketsDir, 'done');
+  if (fs.existsSync(doneDir)) {
+    const doneTickets = allTickets.filter(t => t.dir === 'done');
+    for (const ticket of doneTickets) {
+      const srcPath = path.join(doneDir, `${ticket.id}.md`);
+      const destPath = path.join(archiveDir, `${ticket.id}.md`);
+      try {
+        if (fs.existsSync(srcPath)) {
+          const content = fs.readFileSync(srcPath, 'utf8');
+          const { frontmatter: fm, body: bd } = parseFrontmatter(content);
+          fm.updated_at = new Date().toISOString();
+          fm.archived_at = new Date().toISOString();
+          fs.writeFileSync(destPath, serializeFrontmatter(fm) + bd, 'utf8');
+          fs.unlinkSync(srcPath);
+          archived.push(ticket.id);
+        }
+      } catch (_) { /* skip errors */ }
+    }
+  }
+
+  return { closed: true, reason: 'All tickets done', total, done, archived };
 }

package/src/runner.mjs

@@ -840,14 +840,11 @@ class StageExecutor {
       // Если args содержит -p с ролью — объединяем роль и промпт в один аргумент
       // Иначе Claude CLI интерпретирует роль как промпт, а реальный промпт игнорирует
       const lastPIdx = args.lastIndexOf('-p');
-      let stdinPrompt = null;
       if (lastPIdx !== -1 && lastPIdx < args.length - 1) {
         const role = args[lastPIdx + 1];
         args[lastPIdx + 1] = `${prompt}\n\nТвоя роль: ${role}`;
       } else {
-        // Передаём промпт через stdin вместо аргумента,
-        // т.к. shell: true на Windows обрезает многострочные аргументы
-        stdinPrompt = prompt;
+        args.push(prompt);
       }
 
       // Логгируем команду перед запуском (вместо промпта — имя skill)
@@ -865,15 +862,10 @@ class StageExecutor {
       const child = spawn(agent.command, args, {
         cwd: path.resolve(this.projectRoot, agent.workdir || '.'),
         stdio: ['pipe', 'pipe', 'pipe'],
-        // npm-бинари (.cmd) на Windows требуют shell: true,
-        // но нативные executables (node) — нет: shell: true обрезает многострочные аргументы
         shell: process.platform === 'win32' && agent.command !== 'node'
       });
 
-      // Передаём промпт через stdin или закрываем если промпт в аргументах
-      if (stdinPrompt) {
-        child.stdin.write(stdinPrompt);
-      }
+      // Закрываем stdin чтобы агент не ждал дополнительного ввода
       child.stdin.end();
 
       let stdout = '';

package/src/scripts/archive-plan-tickets.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+/**
+ * archive-plan-tickets.js - Архивирует все done-тикеты указанного плана
+ *
+ * Использование:
+ *   node archive-plan-tickets.js <plan_id>
+ *
+ * Пример:
+ *   node archive-plan-tickets.js PLAN-002
+ *   node archive-plan-tickets.js 2
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { findProjectRoot } from '../lib/find-root.mjs';
+import { parseFrontmatter, serializeFrontmatter, normalizePlanId, extractPlanId, 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 DONE_DIR = path.join(TICKETS_DIR, 'done');
+const ARCHIVE_DIR = path.join(TICKETS_DIR, 'archive');
+
+/**
+ * Архивирует все done-тикеты указанного плана
+ */
+function archivePlanTickets(planId) {
+  if (!planId) {
+    return { status: 'error', error: 'Missing plan_id' };
+  }
+
+  if (!fs.existsSync(DONE_DIR)) {
+    return { status: 'ok', plan_id: planId, archived: 0, ticket_ids: '' };
+  }
+
+  if (!fs.existsSync(ARCHIVE_DIR)) {
+    fs.mkdirSync(ARCHIVE_DIR, { recursive: true });
+  }
+
+  const files = fs.readdirSync(DONE_DIR).filter(f => f.endsWith('.md') && f !== '.gitkeep.md');
+  const archived = [];
+
+  for (const file of files) {
+    const filePath = path.join(DONE_DIR, file);
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      const { frontmatter, body } = parseFrontmatter(content);
+
+      const ticketPlanId = normalizePlanId(frontmatter.parent_plan);
+      if (ticketPlanId !== planId) continue;
+
+      const ticketId = frontmatter.id || file.replace('.md', '');
+
+      frontmatter.updated_at = new Date().toISOString();
+      frontmatter.archived_at = new Date().toISOString();
+
+      const destPath = path.join(ARCHIVE_DIR, file);
+      fs.writeFileSync(destPath, serializeFrontmatter(frontmatter) + body, 'utf8');
+      fs.unlinkSync(filePath);
+
+      archived.push(ticketId);
+      console.log(`[ARCHIVE] ${ticketId}: done → archive`);
+    } catch (e) {
+      console.error(`[ERROR] Failed to archive ${file}: ${e.message}`);
+    }
+  }
+
+  return {
+    status: 'ok',
+    plan_id: planId,
+    archived: archived.length,
+    ticket_ids: archived.join(',')
+  };
+}
+
+// Main entry point
+const rawArgs = process.argv.slice(2);
+let planId;
+
+if (rawArgs.length >= 1) {
+  // Прямой вызов или pipeline context
+  const arg = rawArgs[0];
+  const planMatch = arg.match(/plan_id:\s*(\S+)/i);
+  planId = planMatch ? normalizePlanId(planMatch[1]) : normalizePlanId(arg);
+} else {
+  planId = extractPlanId();
+}
+
+if (!planId) {
+  console.error('Usage: node archive-plan-tickets.js <plan_id>');
+  console.error('Example: node archive-plan-tickets.js PLAN-002');
+  printResult({ status: 'error', error: 'Missing plan_id argument' });
+  process.exit(1);
+}
+
+const result = archivePlanTickets(planId);
+printResult(result);
+
+if (result.status === 'error') {
+  process.exit(1);
+}

package/src/scripts/move-ticket.js

@@ -23,7 +23,7 @@ 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_STATUSES = ['backlog', 'ready', 'in-progress', 'blocked', 'review', 'done', 'archive'];
 
 // Таблица допустимых переходов
 const VALID_TRANSITIONS = {
@@ -32,7 +32,8 @@ const VALID_TRANSITIONS = {
   'in-progress': ['done', 'blocked', 'review'],
   'blocked': ['ready'],
   'review': ['done', 'ready', 'in-progress', 'blocked'],
-  'done': ['ready', 'blocked']
+  'done': ['ready', 'blocked', 'archive'],
+  'archive': ['backlog']
 };
 
 /**

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

@@ -36,6 +36,7 @@ const DONE_DIR = path.join(TICKETS_DIR, 'done');
 const IN_PROGRESS_DIR = path.join(TICKETS_DIR, 'in-progress');
 const BLOCKED_DIR = path.join(TICKETS_DIR, 'blocked');
 const REVIEW_DIR = path.join(TICKETS_DIR, 'review');
+const ARCHIVE_DIR = path.join(TICKETS_DIR, 'archive');
 const BACKLOG_DIR = path.join(TICKETS_DIR, 'backlog');
 
 
@@ -60,7 +61,8 @@ function checkCondition(condition) {
       const ids = Array.isArray(value) ? value : [value];
       return ids.every(taskId => {
         const donePath = path.join(DONE_DIR, `${taskId}.md`);
-        return fs.existsSync(donePath);
+        const archivePath = path.join(ARCHIVE_DIR, `${taskId}.md`);
+        return fs.existsSync(donePath) || fs.existsSync(archivePath);
       });
 
     case 'date_after':
@@ -146,7 +148,7 @@ function parseReviewSection(content) {
  * @returns {object} Метрики: iterations, avgTimeToFirstPassed, failedVsPassed
  */
 function calculateReviewMetrics() {
-  const allDirs = [BACKLOG_DIR, READY_DIR, IN_PROGRESS_DIR, BLOCKED_DIR, REVIEW_DIR, DONE_DIR];
+  const allDirs = [BACKLOG_DIR, READY_DIR, IN_PROGRESS_DIR, BLOCKED_DIR, REVIEW_DIR, DONE_DIR, ARCHIVE_DIR];
   const ticketMetrics = {};
   let totalFailed = 0;
   let totalPassed = 0;
@@ -212,7 +214,8 @@ function checkDependencies(dependencies) {
 
   return dependencies.every(depId => {
     const donePath = path.join(DONE_DIR, `${depId}.md`);
-    return fs.existsSync(donePath);
+    const archivePath = path.join(ARCHIVE_DIR, `${depId}.md`);
+    return fs.existsSync(donePath) || fs.existsSync(archivePath);
   });
 }
 
@@ -232,7 +235,8 @@ function autoCorrectTickets(config) {
     in_progress: IN_PROGRESS_DIR,
     blocked: BLOCKED_DIR,
     review: REVIEW_DIR,
-    done: DONE_DIR
+    done: DONE_DIR,
+    archive: ARCHIVE_DIR
   };
 
   /**

package/src/skills/coach/SKILL.md

@@ -27,6 +27,17 @@ ticket_prefix: COACH
 | **План** | Файл в `.workflow/plans/` — источник контекста для анализа |
 | **Тикет** | Файл в `.workflow/tickets/` — единица работы для анализа результатов |
 | **Отчёт** | Файл в `.workflow/reports/` — источник метрик и выводов |
+| **Бэклог коуча** | Файл `.workflow/coach-backlog.yaml` — реестр проанализированных тикетов и внесённых правок |
+
+## Обязательный шаг: Бэклог коуча
+
+**ПЕРЕД ЛЮБОЙ работой** выполни:
+
+1. Прочитай `.workflow/coach-backlog.yaml` (если не существует — создай с пустыми секциями)
+2. Загрузи `knowledge/backlog-management.md` — правила ведения бэклога
+3. При анализе тикетов — **пропускай** те, что уже есть в `analyzed_tickets`
+4. При внесении правок — **проверяй** `applied_changes`, не предлагай уже сделанное
+5. **После завершения** — обнови бэклог: добавь проанализированные тикеты и внесённые правки
 
 ## Маршрутизация тикетов COACH-*
 
@@ -52,6 +63,7 @@ ticket_prefix: COACH
 | `knowledge/skill-anatomy.md` | При создании или аудите скила — эталонная структура |
 | `knowledge/common-antipatterns.md` | При аудите и ревью — типичные ошибки в скилах |
 | `knowledge/prompt-engineering.md` | При улучшении формулировок в SKILL.md и воркфлоу |
+| `knowledge/backlog-management.md` | **ВСЕГДА** — правила ведения бэклога проанализированных тикетов и правок |
 
 ## Загрузка алгоритмов
 

package/src/skills/coach/knowledge/backlog-management.md

@@ -0,0 +1,71 @@
+# Управление бэклогом коуча
+
+Коуч ведёт бэклог своей работы в файле `.workflow/coach-backlog.yaml`. Этот файл — единственный источник правды о том, что уже было проанализировано и какие правки внесены.
+
+## Структура бэклога
+
+```yaml
+# .workflow/coach-backlog.yaml
+version: 1
+last_updated: "2026-03-20"
+
+# Проанализированные тикеты
+analyzed_tickets:
+  - ticket_id: "GML-001"
+    ticket_file: "tickets/done/GML-001.md"
+    analyzed_date: "2026-03-20"
+    coach_ticket: "COACH-005"  # тикет коуча, в рамках которого проведён анализ
+    findings_count: 3
+    summary: "Недостаток knowledge по TAM/SAM/SOM, нечёткий воркфлоу"
+
+# Внесённые правки в скилы
+applied_changes:
+  - change_id: "CHG-001"
+    date: "2026-03-20"
+    coach_ticket: "COACH-005"
+    target_skill: "growth-marketing-lead"
+    changed_files:
+      - "src/skills/growth-marketing-lead/knowledge/market-sizing.md"
+      - "src/skills/growth-marketing-lead/workflows/analyze.md"
+    change_type: "improve"  # improve | fix | add | refactor
+    description: "Добавлен knowledge-модуль market-sizing, уточнён воркфлоу анализа"
+    based_on_tickets:
+      - "GML-001"
+      - "GML-003"
+
+# Скилы, прошедшие аудит
+audited_skills:
+  - skill_name: "growth-marketing-lead"
+    last_audit_date: "2026-03-20"
+    coach_ticket: "COACH-004"
+    score: 72
+    status: "NEEDS_WORK"
+```
+
+## Правила работы с бэклогом
+
+### Перед началом анализа (ОБЯЗАТЕЛЬНО)
+
+1. Прочитай `.workflow/coach-backlog.yaml`
+2. Проверь, какие тикеты уже проанализированы (`analyzed_tickets`)
+3. **Пропусти** тикеты, которые уже есть в бэклоге
+4. Проверь, какие правки уже внесены (`applied_changes`) в целевой скил
+5. **Учитывай** уже внесённые правки — не предлагай то, что уже исправлено
+
+### После завершения анализа (ОБЯЗАТЕЛЬНО)
+
+1. Добавь каждый проанализированный тикет в `analyzed_tickets`
+2. Добавь каждую внесённую правку в `applied_changes`
+3. Если был аудит — обнови `audited_skills`
+4. Обнови `last_updated`
+
+### Генерация ID
+
+- `change_id`: `CHG-{порядковый номер, 3 цифры}` — следующий после максимального в бэклоге
+
+## Антипаттерны
+
+- **Повторный анализ** — анализировать тикет, который уже в бэклоге
+- **Дублирование правок** — предлагать изменение, которое уже в `applied_changes`
+- **Забыть записать** — внести правку, но не добавить в бэклог
+- **Пустой бэклог** — если файла нет, создай его с пустыми секциями

package/src/skills/coach/templates/coach-backlog-init.yaml

@@ -0,0 +1,10 @@
+# Шаблон инициализации бэклога коуча
+# Скопировать в .workflow/coach-backlog.yaml при первом запуске
+version: 1
+last_updated: ""
+
+analyzed_tickets: []
+
+applied_changes: []
+
+audited_skills: []

package/src/skills/coach/workflows/analyze.md

@@ -4,9 +4,18 @@
 
 ## Алгоритм выполнения
 
+### 0. Загрузка бэклога (ОБЯЗАТЕЛЬНО)
+
+1. Прочитай `.workflow/coach-backlog.yaml`
+2. Выпиши список уже проанализированных `ticket_id` из `analyzed_tickets`
+3. Выпиши список уже внесённых правок из `applied_changes` для целевого скила
+4. **В шаге 1 пропусти тикеты, которые уже в бэклоге**
+5. **В шаге 5 не предлагай правки, которые уже в `applied_changes`**
+
 ### 1. Сбор данных
 
-Собери все завершённые артефакты, связанные со скилом:
+Собери все завершённые артефакты, связанные со скилом.
+**Исключи тикеты, уже присутствующие в бэклоге (`analyzed_tickets`).**
 
 | Источник | Где искать | Что извлечь |
 |----------|-----------|-------------|
@@ -55,3 +64,10 @@
 - Конкретные рекомендации с указанием файлов для изменения
 
 Результат оформи как часть отчёта → `templates/audit-report.md`
+
+### 6. Обновление бэклога (ОБЯЗАТЕЛЬНО)
+
+1. Добавь каждый проанализированный тикет в `analyzed_tickets` бэклога
+2. Если внесены правки — добавь в `applied_changes`
+3. Обнови `last_updated`
+4. Правила формата → `knowledge/backlog-management.md`

package/src/skills/coach/workflows/audit.md

@@ -4,6 +4,13 @@
 
 ## Алгоритм выполнения
 
+### 0. Загрузка бэклога (ОБЯЗАТЕЛЬНО)
+
+1. Прочитай `.workflow/coach-backlog.yaml`
+2. Проверь `audited_skills` — когда последний раз проводился аудит этого скила
+3. Проверь `applied_changes` — какие правки уже внесены после предыдущего аудита
+4. **Учитывай уже внесённые правки** — не отмечай как проблему то, что уже исправлено
+
 ### 1. Инвентаризация
 
 Прочитай все файлы скила и составь карту:
@@ -52,3 +59,10 @@
 - Список найденных проблем с приоритетами
 - Конкретные рекомендации по каждой проблеме
 - План улучшений с приоритизацией
+
+### 7. Обновление бэклога (ОБЯЗАТЕЛЬНО)
+
+1. Обнови/добавь запись в `audited_skills` бэклога
+2. Если анализировались тикеты — добавь в `analyzed_tickets`
+3. Обнови `last_updated`
+4. Правила формата → `knowledge/backlog-management.md`

package/src/skills/coach/workflows/improve.md

@@ -4,6 +4,13 @@
 
 ## Алгоритм выполнения
 
+### 0. Загрузка бэклога (ОБЯЗАТЕЛЬНО)
+
+1. Прочитай `.workflow/coach-backlog.yaml`
+2. Проверь `applied_changes` для целевого скила — какие правки уже внесены
+3. **Не вноси повторно правки, которые уже есть в бэклоге**
+4. Учитывай контекст предыдущих улучшений при планировании новых
+
 ### 1. Определи scope улучшения
 
 Из тикета извлеки:
@@ -54,3 +61,10 @@
 - Какие файлы затронуты
 - Ожидаемый эффект
 - Как проверить результат
+
+### 8. Обновление бэклога (ОБЯЗАТЕЛЬНО)
+
+1. Добавь каждую внесённую правку в `applied_changes` бэклога
+2. Если анализировались тикеты — добавь в `analyzed_tickets`
+3. Обнови `last_updated`
+4. Правила формата → `knowledge/backlog-management.md`

package/src/skills/coach/workflows/review.md

@@ -4,6 +4,12 @@
 
 ## Алгоритм выполнения
 
+### 0. Загрузка бэклога (ОБЯЗАТЕЛЬНО)
+
+1. Прочитай `.workflow/coach-backlog.yaml`
+2. Проверь `applied_changes` — какие правки уже внесены в целевой скил
+3. **Учитывай контекст предыдущих правок** при формировании замечаний
+
 ### 1. Определи фокус ревью
 
 Из тикета извлеки: какой аспект проверить?

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

@@ -13,18 +13,9 @@ description: Декомпозировать план на исполняемые
 - Нужно разбить крупную задачу на подзадачи
 - Требуется детальная декомпозиция
 
-## ⛔ ЗАПРЕЩЕНО сканировать все планы если указан конкретный план
+## ⛔ Какой план декомпозировать
 
-Ты получаешь промпт с секциями Context и Instructions.
-
-**Если в Context или Instructions есть `plan_id` или `plan_file` или путь к конкретному плану (например `PLAN-005.md`):**
-- Декомпозируй ТОЛЬКО этот план
-- НЕ сканируй `plans/current/` — это ЗАПРЕЩЕНО
-- НЕ проверяй статус плана (`draft`, `active` — неважно) — это ЗАПРЕЩЕНО
-- НЕ читай и не упоминай другие планы — это ЗАПРЕЩЕНО
-- Открой файл плана и сразу переходи к шагу 1
-
-**Только если нигде в промпте нет указания на конкретный план** — тогда сканируй `plans/current/` и декомпозируй только планы со статусом `approved`.
+Декомпозируй план, указанный в секции Instructions твоего промпта. Открой этот файл и сразу переходи к шагу 1. Не сканируй папку plans/current/. Не проверяй статус плана. Не читай другие планы.
 
 ## Шаги выполнения
 
@@ -65,6 +56,9 @@ description: Декомпозировать план на исполняемые
 - DoD-критерий: «Результаты внесены непосредственно в файл тикета»
 - Указание в каком формате ожидается результат
 
+**⛔ НЕ создавать conditional/fallback HUMAN-тикеты заранее.**
+Если HUMAN-тикет нужен только при провале агентского тикета (например, «выполнить вручную, если агент не смог пройти auth») — **не создавай его на этапе декомпозиции**. Такие тикеты создаёт `decompose-gaps` когда проблема реально возникла. Иначе они висят в backlog вечно и засоряют доску.
+
 **Пример разбиения гибридной задачи:**
 
 Задача из плана: «Провести конкурентный анализ и настроить трекинг конкурентов в аналитике»