kenaz 0.3.18 → 0.3.19

package/core/.collaboration/core/conflict-resolver.test.js

@@ -1,389 +0,0 @@
-#!/usr/bin/env node
-/**
- * conflict-resolver.test.js
- * ConflictResolver 單元測試
- *
- * 測試覆蓋:
- * - 版本衝突偵測
- * - 時間戳比較
- * - 自動合併策略
- * - Git 衝突解析
- * - 錯誤處理
- */
-
-const assert = require('assert');
-const { ConflictResolver, ConflictType, ResolutionStrategy } = require('./conflict-resolver.js');
-
-// ============================================================================
-// 測試資料
-// ============================================================================
-
-const createTaskV1 = () => ({
-  id: 'TASK_001',
-  title: '實作登入功能',
-  status: 'in_progress',
-  _version: 1,
-  collaborators: ['alice', 'bob'],
-  keywords: ['auth', 'login'],
-  dependencies: {
-    required: [],
-    optional: ['TASK_002'],
-  },
-  last_modified_by: {
-    name: 'Alice',
-    timestamp: '2026-02-11T10:00:00Z',
-  },
-});
-
-const createTaskV2 = () => ({
-  id: 'TASK_001',
-  title: '實作登入功能（含 OAuth）',
-  status: 'in_progress',
-  _version: 2,
-  collaborators: ['alice', 'charlie'],
-  keywords: ['auth', 'login', 'oauth'],
-  dependencies: {
-    required: [],
-    optional: ['TASK_002', 'TASK_003'],
-  },
-  last_modified_by: {
-    name: 'Charlie',
-    timestamp: '2026-02-11T10:05:00Z',
-  },
-});
-
-const createTaskSimultaneous = () => ({
-  id: 'TASK_001',
-  title: '實作登入功能（含 2FA）',
-  status: 'completed',
-  _version: 1,
-  collaborators: ['alice', 'david'],
-  keywords: ['auth', 'login', '2fa'],
-  dependencies: {
-    required: [],
-    optional: ['TASK_004'],
-  },
-  last_modified_by: {
-    name: 'David',
-    timestamp: '2026-02-11T10:00:00.500Z', // 同時修改（0.5 秒差異）
-  },
-});
-
-// ============================================================================
-// 測試套件
-// ============================================================================
-
-class TestRunner {
-  constructor() {
-    this.tests = [];
-    this.passed = 0;
-    this.failed = 0;
-  }
-
-  test(name, fn) {
-    this.tests.push({ name, fn });
-  }
-
-  async run() {
-    console.log('========================================');
-    console.log('ConflictResolver 單元測試');
-    console.log('========================================\n');
-
-    for (const { name, fn } of this.tests) {
-      try {
-        await fn();
-        console.log(`✅ ${name}`);
-        this.passed++;
-      } catch (error) {
-        console.log(`❌ ${name}`);
-        console.error(`   錯誤: ${error.message}`);
-        this.failed++;
-      }
-    }
-
-    console.log('\n========================================');
-    console.log(`測試結果: ${this.passed} 通過, ${this.failed} 失敗`);
-    console.log(`覆蓋率: ${((this.passed / this.tests.length) * 100).toFixed(2)}%`);
-    console.log('========================================\n');
-
-    process.exit(this.failed > 0 ? 1 : 0);
-  }
-}
-
-const runner = new TestRunner();
-
-// ============================================================================
-// 測試案例: 版本衝突偵測
-// ============================================================================
-
-runner.test('detectConflict: 無衝突（相同版本）', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = { ...createTaskV1() };
-
-  const conflict = resolver.detectConflict(task1, task2);
-
-  assert.strictEqual(conflict.hasConflict, false);
-  assert.strictEqual(conflict.type, ConflictType.NO_CONFLICT);
-});
-
-runner.test('detectConflict: 版本號衝突', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskV2();
-
-  const conflict = resolver.detectConflict(task1, task2);
-
-  assert.strictEqual(conflict.hasConflict, true);
-  assert.strictEqual(conflict.type, ConflictType.VERSION_MISMATCH);
-  assert.strictEqual(conflict.details.versionMismatch.ours, 1);
-  assert.strictEqual(conflict.details.versionMismatch.theirs, 2);
-});
-
-runner.test('detectConflict: 時間戳衝突（同時修改）', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskSimultaneous();
-
-  const conflict = resolver.detectConflict(task1, task2);
-
-  assert.strictEqual(conflict.hasConflict, true);
-  assert.strictEqual(conflict.type, ConflictType.TIMESTAMP_CONFLICT);
-  assert.ok(conflict.details.timestampConflict.diff < 1000);
-});
-
-runner.test('detectConflict: 欄位衝突', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = {
-    ...createTaskV1(),
-    status: 'completed',
-    last_modified_by: {
-      name: 'Alice',
-      timestamp: '2026-02-11T10:10:00Z', // 10 分鐘後，避免被視為同時修改
-    },
-  };
-
-  const conflict = resolver.detectConflict(task1, task2);
-
-  assert.strictEqual(conflict.hasConflict, true);
-  assert.strictEqual(conflict.type, ConflictType.FIELD_CONFLICT);
-  assert.ok(conflict.details.fieldConflicts.length > 0);
-});
-
-runner.test('detectConflict: 缺少參數拋出錯誤', () => {
-  const resolver = new ConflictResolver();
-
-  assert.throws(() => {
-    resolver.detectConflict(null, createTaskV1());
-  }, /必須提供兩個版本/);
-});
-
-runner.test('detectConflict: 任務 ID 不匹配拋出錯誤', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = { ...createTaskV1(), id: 'TASK_002' };
-
-  assert.throws(() => {
-    resolver.detectConflict(task1, task2);
-  }, /任務 ID 不匹配/);
-});
-
-// ============================================================================
-// 測試案例: 自動解決策略
-// ============================================================================
-
-runner.test('autoResolve: KEEP_OURS 策略', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskV2();
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.KEEP_OURS);
-
-  assert.strictEqual(resolved.id, task1.id);
-  assert.strictEqual(resolved.title, task1.title);
-  assert.strictEqual(resolved._version, 2); // 版本遞增
-  assert.strictEqual(resolved.last_modified_by.resolution, 'keep_ours');
-});
-
-runner.test('autoResolve: KEEP_THEIRS 策略', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskV2();
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.KEEP_THEIRS);
-
-  assert.strictEqual(resolved.id, task2.id);
-  assert.strictEqual(resolved.title, task2.title);
-  assert.strictEqual(resolved._version, 3); // 版本遞增
-  assert.strictEqual(resolved.last_modified_by.resolution, 'keep_theirs');
-});
-
-runner.test('autoResolve: AUTO_MERGE 策略（合併 collaborators）', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskV2();
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.AUTO_MERGE);
-
-  assert.strictEqual(resolved._version, 3); // max(1, 2) + 1
-  assert.strictEqual(resolved.last_modified_by.resolution, 'auto_merge');
-
-  // collaborators 應該合併去重
-  const expectedCollaborators = new Set(['alice', 'bob', 'charlie']);
-  assert.deepStrictEqual(new Set(resolved.collaborators), expectedCollaborators);
-});
-
-runner.test('autoResolve: AUTO_MERGE 策略（合併 keywords）', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskV2();
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.AUTO_MERGE);
-
-  // keywords 應該合併去重
-  const expectedKeywords = new Set(['auth', 'login', 'oauth']);
-  assert.deepStrictEqual(new Set(resolved.keywords), expectedKeywords);
-});
-
-runner.test('autoResolve: AUTO_MERGE 策略（合併 dependencies.optional）', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskV2();
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.AUTO_MERGE);
-
-  // dependencies.optional 應該合併去重
-  const expectedOptional = new Set(['TASK_002', 'TASK_003']);
-  assert.deepStrictEqual(new Set(resolved.dependencies.optional), expectedOptional);
-});
-
-runner.test('autoResolve: AUTO_MERGE 使用較新的時間戳', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1(); // 10:00:00
-  const task2 = createTaskV2(); // 10:05:00 (較新)
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.AUTO_MERGE);
-
-  // 應該使用較新的時間戳（但被 auto_merge 覆寫）
-  assert.ok(resolved.last_modified_by.mergedFrom);
-  assert.strictEqual(resolved.last_modified_by.mergedFrom.ours, task1.last_modified_by.timestamp);
-  assert.strictEqual(resolved.last_modified_by.mergedFrom.theirs, task2.last_modified_by.timestamp);
-});
-
-runner.test('autoResolve: 無衝突時保留原版本', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = { ...createTaskV1() };
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.AUTO_MERGE);
-
-  assert.deepStrictEqual(resolved, task1);
-});
-
-runner.test('autoResolve: 未知策略拋出錯誤', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskV2();
-
-  assert.throws(() => {
-    resolver.autoResolve(task1, task2, 'INVALID_STRATEGY');
-  }, /未知的解決策略/);
-});
-
-// ============================================================================
-// 測試案例: Git 衝突解析
-// ============================================================================
-
-runner.test('parseGitConflict: 正確解析 Git 衝突標記', () => {
-  const resolver = new ConflictResolver();
-  const task1 = createTaskV1();
-  const task2 = createTaskV2();
-
-  const gitConflict = `<<<<<<< HEAD
-${JSON.stringify(task1, null, 2)}
-=======
-${JSON.stringify(task2, null, 2)}
->>>>>>> feature-branch
-`;
-
-  const { ours, theirs } = resolver.parseGitConflict(gitConflict);
-
-  assert.deepStrictEqual(ours, task1);
-  assert.deepStrictEqual(theirs, task2);
-});
-
-runner.test('parseGitConflict: 缺少標記拋出錯誤', () => {
-  const resolver = new ConflictResolver();
-  const invalidContent = 'This is not a git conflict';
-
-  assert.throws(() => {
-    resolver.parseGitConflict(invalidContent);
-  }, /未找到 Git 衝突標記/);
-});
-
-runner.test('parseGitConflict: 無效 JSON 拋出錯誤', () => {
-  const resolver = new ConflictResolver();
-  const invalidConflict = `<<<<<<< HEAD
-{invalid json}
-=======
-{also invalid}
->>>>>>> branch
-`;
-
-  assert.throws(() => {
-    resolver.parseGitConflict(invalidConflict);
-  }, /解析 Git 衝突內容失敗/);
-});
-
-// ============================================================================
-// 測試案例: 邊界情況
-// ============================================================================
-
-runner.test('邊界: _version 欄位缺失時預設為 1', () => {
-  const resolver = new ConflictResolver();
-  const task1 = { id: 'TASK_001', title: 'Test' };
-  const task2 = { id: 'TASK_001', title: 'Test', _version: 2 };
-
-  const conflict = resolver.detectConflict(task1, task2);
-
-  assert.strictEqual(conflict.hasConflict, true);
-  assert.strictEqual(conflict.details.versionMismatch.ours, 1);
-  assert.strictEqual(conflict.details.versionMismatch.theirs, 2);
-});
-
-runner.test('邊界: 時間戳缺失時不檢查時間戳衝突', () => {
-  const resolver = new ConflictResolver();
-  const task1 = { id: 'TASK_001', title: 'Test', _version: 1 };
-  const task2 = { id: 'TASK_001', title: 'Test', _version: 1 };
-
-  const conflict = resolver.detectConflict(task1, task2);
-
-  assert.strictEqual(conflict.type, ConflictType.NO_CONFLICT);
-});
-
-runner.test('邊界: collaborators 為空陣列時自動合併正確', () => {
-  const resolver = new ConflictResolver();
-  const task1 = { ...createTaskV1(), collaborators: [] };
-  const task2 = { ...createTaskV2(), collaborators: ['alice'] };
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.AUTO_MERGE);
-
-  assert.deepStrictEqual(resolved.collaborators, ['alice']);
-});
-
-runner.test('邊界: dependencies.optional 缺失時不報錯', () => {
-  const resolver = new ConflictResolver();
-  const task1 = { ...createTaskV1(), dependencies: { required: [] } };
-  const task2 = { ...createTaskV2(), dependencies: { required: [] } };
-
-  const resolved = resolver.autoResolve(task1, task2, ResolutionStrategy.AUTO_MERGE);
-
-  assert.ok(resolved.dependencies);
-});
-
-// ============================================================================
-// 執行測試
-// ============================================================================
-
-runner.run();

package/core/.collaboration/core/migrate-legacy.js

@@ -1,260 +0,0 @@
-#!/usr/bin/env node
-/**
- * migrate-legacy.js
- * 將舊系統 (dev/pipeline/) 的任務遷移到新系統 (.collaboration/tasks/archived/)
- *
- * 來源：
- *   1. dev/pipeline/completed/*.yaml — 舊 YAML 檔
- *   2. dev/pipeline/TASK_QUEUE.json  — JSON 索引（補充 YAML 沒有的）
- *
- * 目標：.collaboration/tasks/archived/TASK_XXX.yaml（新系統格式）
- *
- * Usage:
- *   node .collaboration/core/migrate-legacy.js            # 預覽
- *   node .collaboration/core/migrate-legacy.js --execute   # 執行寫入
- */
-
-const fs = require('fs');
-const path = require('path');
-const yaml = (() => {
-  try { return require('js-yaml'); } catch {
-    const candidates = [
-      path.resolve(__dirname, '../../.vendor/js-yaml.cjs'),
-      path.resolve(__dirname, '.vendor/js-yaml.cjs'),
-    ];
-    if (process.env.KENAZ_SOURCE_DIR) {
-      candidates.unshift(path.join(process.env.KENAZ_SOURCE_DIR, '.vendor', 'js-yaml.cjs'));
-    }
-    for (const c of candidates) {
-      try { return require(c); } catch { /* next */ }
-    }
-    throw new Error('js-yaml not found. Install it or ensure .vendor/js-yaml.cjs exists.');
-  }
-})();
-const { randomUUID } = require('crypto');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const LEGACY_COMPLETED = path.join(ROOT, 'dev', 'pipeline', 'completed');
-const LEGACY_TASKS = path.join(ROOT, 'dev', 'pipeline', 'tasks');
-const LEGACY_QUEUE = path.join(ROOT, 'dev', 'pipeline', 'TASK_QUEUE.json');
-const NEW_ARCHIVED = path.join(ROOT, '.collaboration', 'tasks', 'archived');
-
-// 新系統所有已存在的任務 ID
-function getExistingIds() {
-  const dirs = ['backlog', 'active', 'done', 'cancel', 'blocked', 'archived'];
-  const ids = new Set();
-  for (const d of dirs) {
-    const dir = path.join(ROOT, '.collaboration', 'tasks', d);
-    if (!fs.existsSync(dir)) continue;
-    for (const f of fs.readdirSync(dir)) {
-      const m = f.match(/^(TASK_\d+)/);
-      if (m) ids.add(m[1]);
-    }
-  }
-  return ids;
-}
-
-// 將字串陣列中的物件/非字串轉為字串
-function toStringArray(arr) {
-  if (!Array.isArray(arr)) return [];
-  return arr.map(item => {
-    if (typeof item === 'string') return item;
-    if (item == null) return null;
-    if (typeof item === 'object') {
-      if (item.description) return item.description;
-      if (item.name) return item.name;
-      return JSON.stringify(item);
-    }
-    return String(item);
-  }).filter(Boolean);
-}
-
-// 從舊格式轉換成新系統格式
-function convertToNewFormat(old, source) {
-  const id = old.id || old.ID;
-
-  // description 處理
-  let desc = old.description || '';
-  if (typeof desc !== 'string') desc = String(desc);
-
-  // status 映射
-  const statusMap = {
-    'pending': 'backlog',
-    'in_progress': 'active',
-    'completed': 'completed',
-    'cancelled': 'cancel',
-    'blocked': 'blocked',
-    'done': 'completed',
-    'split': 'backlog'
-  };
-  const rawStatus = (old.status || 'completed').toLowerCase();
-  const status = statusMap[rawStatus] || rawStatus;
-
-  // role 映射
-  const role = old.role || old.agent_type || old.assigned_team || 'developer';
-
-  // created_at / completed_at
-  const createdAt = old.created_at || old.metadata?.created_at || '';
-  const completedAt = old.completed_at || old.metadata?.completed_at || '';
-  const createdBy = old.metadata?.created_by || old.created_by || 'Legacy Migration';
-
-  // estimated_hours
-  const estHours = old.estimated_hours != null ? old.estimated_hours : null;
-  const actHours = old.actual_hours != null ? old.actual_hours : null;
-
-  return {
-    id,
-    hash: randomUUID(),
-    title: old.title || '',
-    description: desc.trim(),
-    priority: old.priority || 'P2',
-    status,
-    role: typeof role === 'string' ? role.replace(/"/g, '') : 'developer',
-    tags: Array.isArray(old.tags) ? old.tags : [],
-    complexity: old.complexity || 'medium',
-    rigor: 'low',
-    estimated_hours: estHours,
-    actual_hours: actHours,
-    branch: old.branch || null,
-    dependencies: old.dependencies || [],
-    scope_paths: old.scope_paths || old.scope || [],
-    requirements: toStringArray(old.requirements),
-    acceptance_criteria: toStringArray(old.acceptance_criteria),
-    technical_notes: toStringArray(old.technical_notes),
-    feature_ids: old.feature_ids || [],
-    created_by: {
-      name: typeof createdBy === 'string' ? createdBy : (createdBy.name || 'Legacy'),
-      git_user: '',
-      timestamp: typeof createdAt === 'string' ? createdAt : ''
-    },
-    executed_by: null,
-    assigned_to: null,
-    metadata: {
-      migrated_from: source,
-      migrated_at: new Date().toISOString()
-    }
-  };
-}
-
-// YAML dump 設定（匹配新系統輸出風格）
-function dumpYaml(obj) {
-  return yaml.dump(obj, {
-    lineWidth: -1,
-    noRefs: true,
-    quotingType: "'",
-    forceQuotes: false
-  });
-}
-
-// 主程式
-function main() {
-  const execute = process.argv.includes('--execute');
-  const existingIds = getExistingIds();
-
-  console.log(`📋 Existing tasks in new system: ${existingIds.size}`);
-
-  // 收集所有舊系統任務
-  const legacyTasks = new Map(); // id -> { data, source }
-
-  // 1. 從 completed/ YAML 載入
-  for (const dir of [LEGACY_COMPLETED, LEGACY_TASKS]) {
-    if (!fs.existsSync(dir)) continue;
-    for (const file of fs.readdirSync(dir)) {
-      if (!file.endsWith('.yaml') && !file.endsWith('.md')) continue;
-      const match = file.match(/^(TASK_\d+)/);
-      if (!match) continue;
-      const taskId = match[1];
-      if (legacyTasks.has(taskId)) continue; // 不覆蓋
-
-      try {
-        const content = fs.readFileSync(path.join(dir, file), 'utf8');
-        // 跳過 .md 文件中沒有 YAML frontmatter 的
-        if (file.endsWith('.md')) {
-          if (!content.startsWith('---')) continue;
-          // 提取 frontmatter
-          const parts = content.split('---');
-          if (parts.length < 3) continue;
-          const data = yaml.load(parts[1]);
-          if (data && data.id) {
-            legacyTasks.set(taskId, { data, source: `dev/pipeline/completed/${file}` });
-          }
-        } else {
-          const data = yaml.load(content);
-          if (data && (data.id || data.ID)) {
-            legacyTasks.set(taskId, { data, source: `dev/pipeline/completed/${file}` });
-          }
-        }
-      } catch (e) {
-        console.warn(`  ⚠️  Parse error: ${file}: ${e.message}`);
-      }
-    }
-  }
-
-  // 2. 從 TASK_QUEUE.json 補充
-  if (fs.existsSync(LEGACY_QUEUE)) {
-    try {
-      const queue = JSON.parse(fs.readFileSync(LEGACY_QUEUE, 'utf8'));
-      for (const task of (queue.tasks || [])) {
-        if (!legacyTasks.has(task.id)) {
-          legacyTasks.set(task.id, { data: task, source: 'dev/pipeline/TASK_QUEUE.json' });
-        }
-      }
-    } catch (e) {
-      console.warn(`  ⚠️  TASK_QUEUE.json parse error: ${e.message}`);
-    }
-  }
-
-  // 找出缺失的
-  const missing = [];
-  for (const [id, info] of legacyTasks) {
-    if (!existingIds.has(id)) {
-      missing.push({ id, ...info });
-    }
-  }
-
-  // 按 ID 排序
-  missing.sort((a, b) => {
-    const na = parseInt(a.id.replace('TASK_', ''));
-    const nb = parseInt(b.id.replace('TASK_', ''));
-    return na - nb;
-  });
-
-  console.log(`🔍 Legacy tasks found: ${legacyTasks.size}`);
-  console.log(`❌ Missing from new system: ${missing.length}`);
-
-  if (missing.length === 0) {
-    console.log('✅ All tasks are synced!');
-    return;
-  }
-
-  console.log('');
-
-  // 確保 archived 目錄存在
-  if (execute && !fs.existsSync(NEW_ARCHIVED)) {
-    fs.mkdirSync(NEW_ARCHIVED, { recursive: true });
-  }
-
-  let created = 0;
-  for (const task of missing) {
-    const newTask = convertToNewFormat(task.data, task.source);
-    const filename = `${task.id}.yaml`;
-    const filepath = path.join(NEW_ARCHIVED, filename);
-
-    if (execute) {
-      fs.writeFileSync(filepath, dumpYaml(newTask), 'utf8');
-      console.log(`  ✅ ${task.id} ← ${task.source}`);
-      created++;
-    } else {
-      console.log(`  📝 ${task.id} ← ${task.source} (dry-run)`);
-    }
-  }
-
-  console.log('');
-  if (execute) {
-    console.log(`✅ Migrated ${created} tasks to .collaboration/tasks/archived/`);
-  } else {
-    console.log(`📋 ${missing.length} tasks would be migrated. Run with --execute to apply.`);
-  }
-}
-
-main();