workflow-ai 1.0.56 → 1.0.58

package/README.md

@@ -26,8 +26,10 @@ workflow run
 |---------|-------------|
 | `workflow init [path] [--force]` | Initialize `.workflow/` directory with kanban board structure |
 | `workflow run [options]` | Execute the AI pipeline |
-| `workflow update [path]` | Update global dir and recreate junctions/hardlinks |
+| `workflow update [path]` | Update global dir and recreate junctions |
 | `workflow eject <skill> [path]` | Eject a skill (copy from global to project) |
+| `workflow eject-scripts [path]` | Eject scripts (copy from global to project) |
+| `workflow eject-configs [path]` | Eject configs (copy from global to project) |
 | `workflow list [path]` | List skills with status (shared/ejected/project-only) |
 | `workflow help` | Show help |
 | `workflow version` | Show version |
@@ -46,10 +48,7 @@ The `workflow init` command creates the `.workflow/` directory structure:
 
 ```
 .workflow/
-├── config/
-│   ├── config.yaml               # Workflow configuration
-│   ├── pipeline.yaml             # Pipeline stages and agents
-│   └── ticket-movement-rules.yaml
+├── config/                       # → junction to ~/.workflow/configs/ (eject to customize)
 ├── plans/
 │   ├── current/                  # Current development plans
 │   ├── templates/                # Plan templates with triggers (recurring plans)
@@ -66,8 +65,8 @@ The `workflow init` command creates the `.workflow/` directory structure:
 ├── metrics/                      # Performance metrics
 ├── templates/                    # Ticket/plan/report templates
 └── src/
-    ├── skills/                   # Skill instructions (symlinks to global)
-    └── scripts/                  # Automation scripts (hardlinks to global)
+    ├── skills/                   # Skill instructions (junctions to global, per-skill)
+    └── scripts/                  # Automation scripts (junction to global)
 ```
 
 ## Pipeline
@@ -119,10 +118,22 @@ Built-in skills for different task types:
 | `execute-task` | Task execution |
 | `review-result` | Result review against DoD |
 
-Skills are stored globally in `~/.workflow/skills/` and symlinked into projects.
+Skills are stored globally in `~/.workflow/skills/` and linked into projects via junctions.
 
 Use `workflow eject <skill>` to copy a skill into the project for customization.
 
+## Scripts
+
+Scripts are stored globally in `~/.workflow/scripts/` and linked as a single junction into `.workflow/src/scripts/`.
+
+Use `workflow eject-scripts` to copy scripts into the project for customization.
+
+## Configs
+
+Configs are stored globally in `~/.workflow/configs/` and linked as a single junction into `.workflow/config/`.
+
+Use `workflow eject-configs` to copy configs into the project for customization.
+
 ## Plan Templates
 
 Plan templates allow recurring plans to be created automatically. Templates live in `.workflow/plans/templates/` and contain trigger conditions in their frontmatter.
@@ -186,7 +197,7 @@ workflow-ai/
 │   ├── runner.mjs           # Core pipeline orchestrator
 │   ├── init.mjs             # Project initialization
 │   ├── global-dir.mjs       # Global ~/.workflow/ management
-│   ├── junction-manager.mjs # Symlink/hardlink management
+│   ├── junction-manager.mjs # Junction/symlink management
 │   ├── wf-loader.mjs        # Config loader
 │   ├── lib/                 # Utility libraries
 │   └── tests/               # Test suite

package/agent-templates/CLAUDE.md.tpl

@@ -21,6 +21,14 @@
 | Выбор следующей задачи | `node .workflow/src/scripts/pick-next-task.js` |
 | Перемещение готовых в ready | `node .workflow/src/scripts/move-to-ready.js` |
 
+### Кастомизация (eject)
+
+| Действие | Команда |
+|----------|---------|
+| Eject скила | `workflow eject <skill-name>` |
+| Eject скриптов | `workflow eject-scripts` |
+| Eject конфигов | `workflow eject-configs` |
+
 ## Workflow
 
 1. **Планирование**: Создай план в `.workflow/plans/current/`

package/agent-templates/QWEN.md.tpl

@@ -21,6 +21,14 @@
 | Выбор следующей задачи | `node .workflow/src/scripts/pick-next-task.js` |
 | Перемещение готовых в ready | `node .workflow/src/scripts/move-to-ready.js` |
 
+### Кастомизация (eject)
+
+| Действие | Команда |
+|----------|---------|
+| Eject скила | `workflow eject <skill-name>` |
+| Eject скриптов | `workflow eject-scripts` |
+| Eject конфигов | `workflow eject-configs` |
+
 ## Workflow
 
 1. **Планирование**: Создай план в `.workflow/plans/current/`

package/agent-templates/kilocodemodes.tpl

@@ -0,0 +1,13 @@
+customModes:
+  - slug: manual-testing
+    name: manual-testing
+    roleDefinition: QA-инженер (тестировщик). Находит дефекты, проверяет качество реализации через браузер и desktop-инструменты. Составляет тест-планы и тест-кейсы, выполняет smoke/regression/exploratory/acceptance тестирование, фиксирует баги с evidence. НЕ пишет автотесты в коде, НЕ исправляет баги, НЕ нагружает систему.
+    whenToUse: Тикеты QA-* или с тегом тестирования. Запросы на smoke/regression/exploratory/acceptance тестирование. Необходимость проверки через реальный UI (браузер/desktop). Составление тест-планов и тест-кейсов. Баг-репорты.
+    groups:
+      - read
+      - edit
+      - browser
+      - command
+      - mcp
+    source: project
+    customInstructions: Используй скил manual-testing.

package/package.json

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

package/src/cli.mjs

@@ -6,7 +6,7 @@ import { readFileSync } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { getGlobalDir, refreshGlobalDir, ensureGlobalDir } from './global-dir.mjs';
-import { createSkillJunctions, createScriptHardlinks, ejectSkill, listSkillsWithStatus } from './junction-manager.mjs';
+import { createSkillJunctions, createScriptJunction, createConfigJunction, ejectSkill, ejectScripts, ejectConfigs, listSkillsWithStatus } from './junction-manager.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkgPath = join(__dirname, '..', 'package.json');
@@ -14,13 +14,15 @@ const pkgPath = join(__dirname, '..', 'package.json');
 const HELP_TEXT = `workflow-ai v1.0.0
 
 Usage:
-  workflow init [path] [--force]   Initialize .workflow/ in target directory
-  workflow run [options]           Run the AI pipeline
-  workflow update [path]           Update global dir and recreate junctions/hardlinks
-  workflow eject <skill> [path]    Eject a skill (copy from global to project)
-  workflow list [path]             List skills with status (shared/ejected/project-only)
-  workflow help                    Show this help
-  workflow version                 Show version
+  workflow init [path] [--force]     Initialize .workflow/ in target directory
+  workflow run [options]             Run the AI pipeline
+  workflow update [path]               Update global dir and recreate junctions
+  workflow eject <skill> [path]      Eject a skill (copy from global to project)
+  workflow eject-scripts [path]      Eject scripts (copy from global to project)
+  workflow eject-configs [path]      Eject configs (copy from global to project)
+  workflow list [path]               List skills with status (shared/ejected/project-only)
+  workflow help                      Show this help
+  workflow version                   Show version
 
 Run options:
   --plan <plan>      Plan ID to execute
@@ -94,7 +96,6 @@ function runUpdate(args) {
   const workflowRoot = getWorkflowRoot(projectRoot);
   const packageRoot = getPackageRoot();
   const globalDir = getGlobalDir();
-
   refreshGlobalDir(packageRoot);
   console.log('✅ Global dir updated (~/.workflow/)');
 
@@ -103,8 +104,12 @@ function runUpdate(args) {
   console.log('✅ Skill junctions recreated');
 
   const scriptsDir = join(workflowRoot, 'src', 'scripts');
-  createScriptHardlinks(globalDir, scriptsDir);
-  console.log('✅ Script hardlinks recreated');
+  createScriptJunction(globalDir, scriptsDir);
+  console.log('✅ Script junction recreated');
+
+  const configDir = join(workflowRoot, 'config');
+  createConfigJunction(globalDir, configDir);
+  console.log('✅ Config junction recreated');
 }
 
 function runEject(args) {
@@ -122,6 +127,26 @@ function runEject(args) {
   console.log(`✅ Skill "${skillName}" ejected (copied to project)`);
 }
 
+function runEjectScripts(args) {
+  const projectRoot = resolve(args._[0] || process.cwd());
+  const workflowRoot = getWorkflowRoot(projectRoot);
+  const globalDir = getGlobalDir();
+  const scriptsDir = join(workflowRoot, 'src', 'scripts');
+
+  ejectScripts(globalDir, scriptsDir);
+  console.log('✅ Scripts ejected (copied to project)');
+}
+
+function runEjectConfigs(args) {
+  const projectRoot = resolve(args._[0] || process.cwd());
+  const workflowRoot = getWorkflowRoot(projectRoot);
+  const globalDir = getGlobalDir();
+  const configDir = join(workflowRoot, 'config');
+
+  ejectConfigs(globalDir, configDir);
+  console.log('✅ Configs ejected (copied to project)');
+}
+
 function runList(args) {
   const projectRoot = resolve(args._[0] || process.cwd());
   const workflowRoot = getWorkflowRoot(projectRoot);
@@ -184,6 +209,12 @@ export function run(argv) {
     case 'eject':
       runEject(args);
       break;
+    case 'eject-scripts':
+      runEjectScripts(args);
+      break;
+    case 'eject-configs':
+      runEjectConfigs(args);
+      break;
     case 'list':
       runList(args);
       break;

package/src/global-dir.mjs

@@ -35,12 +35,14 @@ function copyDirectory(src, dest) {
   cpSync(src, dest, { recursive: true });
 }
 
-function copySkillsAndScripts(packageRoot) {
+function copySkillsScriptsAndConfigs(packageRoot) {
   const globalDir = getGlobalDir();
   const srcSkills = join(packageRoot, 'src', 'skills');
   const srcScripts = join(packageRoot, 'src', 'scripts');
+  const srcConfigs = join(packageRoot, 'configs');
   const destSkills = join(globalDir, 'skills');
   const destScripts = join(globalDir, 'scripts');
+  const destConfigs = join(globalDir, 'configs');
 
   if (existsSync(srcSkills)) {
     copyDirectory(srcSkills, destSkills);
@@ -48,6 +50,9 @@ function copySkillsAndScripts(packageRoot) {
   if (existsSync(srcScripts)) {
     copyDirectory(srcScripts, destScripts);
   }
+  if (existsSync(srcConfigs)) {
+    copyDirectory(srcConfigs, destConfigs);
+  }
 }
 
 export function isGlobalDirStale(packageRoot) {
@@ -67,7 +72,7 @@ export function ensureGlobalDir(packageRoot) {
   const globalDir = getGlobalDir();
   if (!existsSync(globalDir)) {
     mkdirSync(globalDir, { recursive: true });
-    copySkillsAndScripts(packageRoot);
+    copySkillsScriptsAndConfigs(packageRoot);
     const version = getPackageVersion(packageRoot);
     writeFileSync(join(globalDir, '.version'), version);
     return;
@@ -75,7 +80,7 @@ export function ensureGlobalDir(packageRoot) {
   if (isGlobalDirStale(packageRoot)) {
     const version = getPackageVersion(packageRoot);
     writeFileSync(join(globalDir, '.version'), version);
-    copySkillsAndScripts(packageRoot);
+    copySkillsScriptsAndConfigs(packageRoot);
   }
 }
 
@@ -86,5 +91,5 @@ export function refreshGlobalDir(packageRoot) {
   }
   const version = getPackageVersion(packageRoot);
   writeFileSync(join(globalDir, '.version'), version);
-  copySkillsAndScripts(packageRoot);
+  copySkillsScriptsAndConfigs(packageRoot);
 }

package/src/init.mjs

@@ -3,7 +3,7 @@ import { join, resolve, dirname, basename } from 'node:path';
 import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { getGlobalDir, ensureGlobalDir } from './global-dir.mjs';
-import { createSkillJunctions, createScriptHardlinks } from './junction-manager.mjs';
+import { createSkillJunctions, createScriptJunction, createConfigJunction } from './junction-manager.mjs';
 
 /**
  * Возвращает абсолютный путь к корню npm-пакета через import.meta.url.
@@ -230,6 +230,21 @@ function generateQwenMd(workflowRoot, projectRoot, packageRoot) {
   writeFileSync(destPath, content, 'utf-8');
 }
 
+/**
+ * Генерирует .kilocodemodes из шаблона agent-templates/kilocodemodes.tpl.
+ *
+ * @param {string} projectRoot - Путь к корню проекта
+ * @param {string} packageRoot - Путь к корню пакета
+ */
+function generateKilocodemodes(projectRoot, packageRoot) {
+  const templatePath = join(packageRoot, 'agent-templates', 'kilocodemodes.tpl');
+  const destPath = join(projectRoot, '.kilocodemodes');
+
+  if (existsSync(templatePath)) {
+    copyFileSync(templatePath, destPath);
+  }
+}
+
 /**
  * Обновляет .gitignore, добавляя указанные строки.
  *
@@ -248,6 +263,7 @@ function updateGitignore(projectRoot) {
     'QWEN.md',
     'CLAUDE.md',
     '.kilocode/',
+    '.kilocodemodes',
   ];
   
   let currentContent = '';
@@ -355,7 +371,6 @@ export function initProject(targetPath = process.cwd(), options = {}) {
     'reports',
     'logs',
     'templates',
-    'config',
     'src/skills'
   ];
   
@@ -371,10 +386,10 @@ export function initProject(targetPath = process.cwd(), options = {}) {
   createSkillJunctions(globalDir, srcSkillsDest);
   result.steps.push('Created skill junctions from global dir → .workflow/src/skills/');
 
-  // Step 3: Create script hardlinks
+  // Step 3: Create script junction
   const srcScriptsDest = join(workflowRoot, 'src', 'scripts');
-  createScriptHardlinks(globalDir, srcScriptsDest);
-  result.steps.push('Created script hardlinks from global dir → .workflow/src/scripts/');
+  createScriptJunction(globalDir, srcScriptsDest);
+  result.steps.push('Created script junction from global dir → .workflow/src/scripts/');
 
   // Step 5: Copy templates (3 templates)
   const templatesSrc = join(packageRoot, 'templates');
@@ -391,35 +406,10 @@ export function initProject(targetPath = process.cwd(), options = {}) {
   }
   result.steps.push('Copied 3 templates → .workflow/templates/');
   
-  // Step 6: Generate config files
+  // Step 6: Create config junction
   const configDest = join(workflowRoot, 'config');
-  ensureDir(configDest);
-  
-  // config.yaml — only if not exists (fresh only)
-  const configYamlDest = join(configDest, 'config.yaml');
-  if (!existsSync(configYamlDest) || force) {
-    const configYamlSrc = join(packageRoot, 'configs', 'config.yaml');
-    if (existsSync(configYamlSrc)) {
-      copyFile(configYamlSrc, configYamlDest);
-      result.steps.push('Generated config.yaml (fresh)');
-    }
-  } else {
-    result.warnings.push('config.yaml already exists, skipped (use --force to overwrite)');
-  }
-  
-  // pipeline.yaml — always
-  const pipelineSrc = join(packageRoot, 'configs', 'pipeline.yaml');
-  if (existsSync(pipelineSrc)) {
-    copyFile(pipelineSrc, join(configDest, 'pipeline.yaml'));
-    result.steps.push('Generated pipeline.yaml (overwritten)');
-  }
-
-  // ticket-movement-rules.yaml — always
-  const movementRulesSrc = join(packageRoot, 'configs', 'ticket-movement-rules.yaml');
-  if (existsSync(movementRulesSrc)) {
-    copyFile(movementRulesSrc, join(configDest, 'ticket-movement-rules.yaml'));
-    result.steps.push('Generated ticket-movement-rules.yaml (overwritten)');
-  }
+  createConfigJunction(globalDir, configDest);
+  result.steps.push('Created config junction from global dir → .workflow/config/');
 
   // Step 7: Create .kilocode symlinks
   const symlinkResult = createKilocodeSymlinks(projectRoot, force);
@@ -432,10 +422,11 @@ export function initProject(targetPath = process.cwd(), options = {}) {
     result.errors.push(symlinkResult.warning || 'Failed to create .kilocode symlinks');
   }
   
-  // Step 8: Generate CLAUDE.md and QWEN.md
+  // Step 8: Generate CLAUDE.md, QWEN.md and .kilocodemodes
   generateClaudeMd(workflowRoot, projectRoot, packageRoot);
   generateQwenMd(workflowRoot, projectRoot, packageRoot);
-  result.steps.push('Generated CLAUDE.md and QWEN.md from agent-templates');
+  generateKilocodemodes(projectRoot, packageRoot);
+  result.steps.push('Generated CLAUDE.md, QWEN.md and .kilocodemodes from agent-templates');
   
   // Step 9: Update .gitignore
   updateGitignore(projectRoot);

package/src/junction-manager.mjs

@@ -109,24 +109,59 @@ export function createSkillJunctions(globalDir, projectSkillsDir) {
   }
 }
 
-export function createScriptHardlinks(globalDir, projectScriptsDir) {
+export function createScriptJunction(globalDir, projectScriptsDir) {
   const globalScriptsDir = join(globalDir, 'scripts');
   if (!existsSync(globalScriptsDir)) {
     return;
   }
-  if (!existsSync(projectScriptsDir)) {
-    mkdirSync(projectScriptsDir, { recursive: true });
+
+  // If local (ejected) scripts dir exists, don't overwrite
+  if (existsSync(projectScriptsDir) && !isJunction(projectScriptsDir)) {
+    return;
   }
 
-  const files = readdirSync(globalScriptsDir);
-  for (const file of files) {
-    const targetPath = join(globalScriptsDir, file);
-    const stats = lstatSync(targetPath);
-    if (stats.isFile()) {
-      const linkPath = join(projectScriptsDir, file);
-      createHardlink(targetPath, linkPath);
-    }
+  createJunction(globalScriptsDir, projectScriptsDir);
+}
+
+export function createConfigJunction(globalDir, projectConfigDir) {
+  const globalConfigDir = join(globalDir, 'configs');
+  if (!existsSync(globalConfigDir)) {
+    return;
+  }
+
+  // If local (ejected) config dir exists, don't overwrite
+  if (existsSync(projectConfigDir) && !isJunction(projectConfigDir)) {
+    return;
+  }
+
+  createJunction(globalConfigDir, projectConfigDir);
+}
+
+export function ejectConfigs(globalDir, projectConfigDir) {
+  const globalConfigDir = join(globalDir, 'configs');
+
+  if (!existsSync(globalConfigDir)) {
+    throw new Error('Configs do not exist in global dir');
   }
+
+  removeJunction(projectConfigDir);
+  cpSync(globalConfigDir, projectConfigDir, { recursive: true });
+}
+
+export function ejectScripts(globalDir, projectScriptsDir) {
+  const globalScriptsDir = join(globalDir, 'scripts');
+
+  if (!existsSync(globalScriptsDir)) {
+    throw new Error('Scripts do not exist in global dir');
+  }
+
+  removeJunction(projectScriptsDir);
+  cpSync(globalScriptsDir, projectScriptsDir, { recursive: true });
+}
+
+/** @deprecated Use createScriptJunction instead */
+export function createScriptHardlinks(globalDir, projectScriptsDir) {
+  createScriptJunction(globalDir, projectScriptsDir);
 }
 
 export function ejectSkill(skillName, globalDir, projectSkillsDir) {

package/src/runner.mjs

@@ -1030,6 +1030,15 @@ class StageExecutor {
             }
             this.logger.info(`OUTPUT ↑`, stageId);
           }
+
+          // Логгируем stderr независимо от exit code
+          if (stderr.trim()) {
+            this.logger.warn(`STDERR ↓`, stageId);
+            for (const line of stderr.trim().split('\n')) {
+              this.logger.warn(`  ${line}`, stageId);
+            }
+            this.logger.warn(`STDERR ↑`, stageId);
+          }
         }
 
         // Парсим результат из вывода агента через ResultParser

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 'workflow-ai/lib/find-root.mjs';
+import { parseFrontmatter, serializeFrontmatter, normalizePlanId, extractPlanId, printResult } 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 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);
+}