kenaz 0.3.18 → 0.3.20

package/core/.collaboration/docs/examples/basic-usage.js

@@ -1,184 +0,0 @@
-#!/usr/bin/env node
-/**
- * basic-usage.js
- * .collaboration 系統基本使用範例
- *
- * 執行方式:
- *   node .collaboration/docs/examples/basic-usage.js
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { LockManager } = require('../../core/lock-manager.js');
-const { generateTaskID, validateTaskID } = require('../../core/id-generator.js');
-
-async function main() {
-  console.log('='.repeat(60));
-  console.log('📚 .collaboration 基本使用範例');
-  console.log('='.repeat(60));
-
-  const api = new TaskAPI();
-
-  // ============================================================================
-  // 1. 建立任務
-  // ============================================================================
-
-  console.log('\n1️⃣ 建立任務');
-  console.log('-'.repeat(60));
-
-  const task1 = await api.createTask({
-    title: '實作登入功能',
-    description: '建立登入頁面和認證 API',
-    priority: 'P1'
-  });
-
-  console.log(`✅ 任務已建立: ${task1.id}`);
-  console.log(`   標題: ${task1.title}`);
-  console.log(`   優先級: ${task1.priority}`);
-  console.log(`   狀態: ${task1.status}`);
-  console.log(`   建立者: ${task1.created_by.name}`);
-
-  // ============================================================================
-  // 2. 查詢任務
-  // ============================================================================
-
-  console.log('\n2️⃣ 查詢任務');
-  console.log('-'.repeat(60));
-
-  // 取得所有任務
-  const allData = await api.getAllTasks();
-  console.log(`✅ 總任務數: ${allData.statistics.total}`);
-  console.log(`   Pending: ${allData.statistics.pending}`);
-  console.log(`   In Progress: ${allData.statistics.in_progress}`);
-  console.log(`   Completed: ${allData.statistics.completed}`);
-
-  // 查詢特定任務
-  const task = await api.getTask(task1.id);
-  console.log(`\n✅ 任務詳情: ${task.id}`);
-  console.log(`   狀態: ${task.status}`);
-  console.log(`   版本: ${task._version}`);
-
-  // ============================================================================
-  // 3. 認領任務
-  // ============================================================================
-
-  console.log('\n3️⃣ 認領任務');
-  console.log('-'.repeat(60));
-
-  const claimed = await api.claimTask(task1.id);
-  console.log(`✅ 任務已認領: ${claimed.id}`);
-  console.log(`   分配給: ${claimed.assigned_to.name}`);
-  console.log(`   狀態: ${claimed.status}`);
-
-  // ============================================================================
-  // 4. 更新任務
-  // ============================================================================
-
-  console.log('\n4️⃣ 更新任務');
-  console.log('-'.repeat(60));
-
-  const updated = await api.updateTask(task1.id, {
-    description: '登入頁面已完成，正在開發認證 API'
-  });
-
-  console.log(`✅ 任務已更新: ${updated.id}`);
-  console.log(`   新描述: ${updated.description}`);
-  console.log(`   版本: ${updated._version}`);
-
-  // ============================================================================
-  // 5. 鎖定任務
-  // ============================================================================
-
-  console.log('\n5️⃣ 鎖定任務');
-  console.log('-'.repeat(60));
-
-  const lockMgr = new LockManager();
-  const gitUser = 'example_user';
-
-  try {
-    const lock = await lockMgr.acquireLock(task1.id, gitUser, 60);
-    console.log(`✅ 任務已鎖定: ${lock.task_id}`);
-    console.log(`   鎖定者: ${lock.locked_by}`);
-    console.log(`   過期時間: ${lock.expires_at}`);
-  } catch (error) {
-    console.error(`❌ 鎖定失敗: ${error.message}`);
-  }
-
-  // ============================================================================
-  // 6. 完成任務
-  // ============================================================================
-
-  console.log('\n6️⃣ 完成任務');
-  console.log('-'.repeat(60));
-
-  const completed = await api.completeTask(task1.id);
-  console.log(`✅ 任務已完成: ${completed.id}`);
-  console.log(`   執行者: ${completed.executed_by.name}`);
-  console.log(`   完成時間: ${completed.executed_by.timestamp}`);
-  console.log(`   最終版本: ${completed._version}`);
-
-  // ============================================================================
-  // 7. 解鎖任務
-  // ============================================================================
-
-  console.log('\n7️⃣ 解鎖任務');
-  console.log('-'.repeat(60));
-
-  const unlocked = await lockMgr.releaseLock(task1.id, gitUser);
-  if (unlocked) {
-    console.log(`✅ 任務已解鎖: ${task1.id}`);
-  }
-
-  // ============================================================================
-  // 8. 查詢特定條件的任務
-  // ============================================================================
-
-  console.log('\n8️⃣ 查詢特定條件的任務');
-  console.log('-'.repeat(60));
-
-  // 查詢所有 P1 任務
-  const p1Tasks = await api.queryTasks({ priority: 'P1' });
-  console.log(`✅ P1 任務數量: ${p1Tasks.length}`);
-
-  // 查詢所有已完成任務
-  const completedTasks = await api.queryTasks({ status: 'completed' });
-  console.log(`✅ 已完成任務數量: ${completedTasks.length}`);
-
-  // ============================================================================
-  // 9. ID 生成與驗證
-  // ============================================================================
-
-  console.log('\n9️⃣ ID 生成與驗證');
-  console.log('-'.repeat(60));
-
-  const newId = generateTaskID();
-  console.log(`✅ 生成 ID: ${newId}`);
-  console.log(`   格式正確: ${validateTaskID(newId)}`);
-  console.log(`   錯誤格式: ${validateTaskID('TASK_123')}`);
-
-  // ============================================================================
-  // 10. 清理（刪除範例任務）
-  // ============================================================================
-
-  console.log('\n🗑️  清理範例任務');
-  console.log('-'.repeat(60));
-
-  const deleted = await api.deleteTask(task1.id);
-  if (deleted) {
-    console.log(`✅ 任務已刪除: ${task1.id}`);
-  }
-
-  console.log('\n' + '='.repeat(60));
-  console.log('✅ 範例執行完成！');
-  console.log('='.repeat(60));
-}
-
-// 執行範例
-if (require.main === module) {
-  main().catch(error => {
-    console.error('❌ 執行失敗:', error.message);
-    console.error(error.stack);
-    process.exit(1);
-  });
-}
-
-module.exports = { main };

package/core/.collaboration/docs/examples/team-workflow.js

@@ -1,352 +0,0 @@
-#!/usr/bin/env node
-/**
- * team-workflow.js
- * 團隊協作工作流程範例 - 模擬多用戶協作場景
- *
- * 執行方式:
- *   node .collaboration/docs/examples/team-workflow.js
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { LockManager } = require('../../core/lock-manager.js');
-
-async function main() {
-  console.log('='.repeat(60));
-  console.log('👥 團隊協作工作流程範例');
-  console.log('='.repeat(60));
-
-  const api = new TaskAPI();
-  const lockMgr = new LockManager();
-
-  // ============================================================================
-  // 場景：PM 建立 Sprint 任務並分配給團隊成員
-  // ============================================================================
-
-  console.log('\n📋 場景 1: PM 建立 Sprint 任務');
-  console.log('-'.repeat(60));
-
-  // PM 建立多個任務
-  const tasks = [];
-  const taskDefinitions = [
-    { title: '實作登入頁面', priority: 'P1', assignee: 'zhangsan' },
-    { title: '實作註冊頁面', priority: 'P1', assignee: 'lisi' },
-    { title: '實作密碼重設功能', priority: 'P2', assignee: 'wangwu' },
-    { title: '實作用戶個人資料頁', priority: 'P2', assignee: 'zhangsan' },
-    { title: '撰寫 API 文檔', priority: 'P3', assignee: 'lisi' }
-  ];
-
-  console.log('✅ PM 建立任務...');
-  for (const def of taskDefinitions) {
-    const task = await api.createTask({
-      title: def.title,
-      priority: def.priority,
-      created_by: {
-        name: 'Product Manager',
-        git_user: 'pm',
-        timestamp: new Date().toISOString()
-      }
-    });
-
-    // 分配任務
-    await api.updateTask(task.id, {
-      assigned_to: {
-        name: def.assignee,
-        git_user: def.assignee,
-        timestamp: new Date().toISOString()
-      }
-    });
-
-    tasks.push(task);
-    console.log(`   - [${task.id}] ${task.title} → @${def.assignee}`);
-  }
-
-  // ============================================================================
-  // 場景：開發者查看自己的任務
-  // ============================================================================
-
-  console.log('\n👨‍💻 場景 2: 開發者查看自己的任務');
-  console.log('-'.repeat(60));
-
-  // zhangsan 查看自己的任務
-  const zhangsanTasks = await api.queryTasks({
-    assigned_to: 'zhangsan',
-    status: 'pending'
-  });
-
-  console.log(`✅ zhangsan 的待辦任務: ${zhangsanTasks.length} 個`);
-  zhangsanTasks.forEach(task => {
-    console.log(`   - [${task.id}] ${task.title} (${task.priority})`);
-  });
-
-  // ============================================================================
-  // 場景：開發者認領並開始工作
-  // ============================================================================
-
-  console.log('\n🔧 場景 3: 開發者認領並開始工作');
-  console.log('-'.repeat(60));
-
-  const task1 = zhangsanTasks[0];
-
-  // 認領任務
-  await api.claimTask(task1.id, 'zhangsan');
-  console.log(`✅ zhangsan 認領任務: ${task1.id}`);
-
-  // 鎖定任務
-  try {
-    await lockMgr.acquireLock(task1.id, 'zhangsan', 120);
-    console.log(`🔒 任務已鎖定 (120 分鐘)`);
-  } catch (error) {
-    console.error(`❌ 鎖定失敗: ${error.message}`);
-  }
-
-  // 模擬工作進度更新
-  await new Promise(resolve => setTimeout(resolve, 100));
-
-  await api.updateTask(task1.id, {
-    description: '登入頁面 UI 已完成 50%'
-  });
-  console.log(`✅ 更新進度: UI 完成 50%`);
-
-  await new Promise(resolve => setTimeout(resolve, 100));
-
-  await api.updateTask(task1.id, {
-    description: '登入頁面 UI 已完成，正在整合 API'
-  });
-  console.log(`✅ 更新進度: 開始整合 API`);
-
-  // ============================================================================
-  // 場景：任務完成並通知
-  // ============================================================================
-
-  console.log('\n✅ 場景 4: 任務完成並通知');
-  console.log('-'.repeat(60));
-
-  // 完成任務
-  await api.completeTask(task1.id);
-  console.log(`✅ zhangsan 完成任務: ${task1.id}`);
-
-  // 解鎖
-  await lockMgr.releaseLock(task1.id, 'zhangsan');
-  console.log(`🔓 任務已解鎖`);
-
-  // PM 查看完成狀態
-  const completed = await api.getTask(task1.id);
-  console.log(`\n📊 PM 查看完成狀態:`);
-  console.log(`   任務: ${completed.title}`);
-  console.log(`   狀態: ${completed.status}`);
-  console.log(`   執行者: ${completed.executed_by.name}`);
-  console.log(`   完成時間: ${completed.executed_by.timestamp}`);
-
-  // ============================================================================
-  // 場景：並行工作（多個開發者同時工作）
-  // ============================================================================
-
-  console.log('\n⚡ 場景 5: 並行工作（多個開發者同時工作）');
-  console.log('-'.repeat(60));
-
-  // lisi 和 wangwu 同時開始工作
-  const lisiTask = tasks.find(t => t.title === '實作註冊頁面');
-  const wangwuTask = tasks.find(t => t.title === '實作密碼重設功能');
-
-  // 並行認領任務
-  await Promise.all([
-    api.claimTask(lisiTask.id, 'lisi'),
-    api.claimTask(wangwuTask.id, 'wangwu')
-  ]);
-
-  console.log(`✅ lisi 認領: ${lisiTask.title}`);
-  console.log(`✅ wangwu 認領: ${wangwuTask.title}`);
-
-  // 並行鎖定
-  await Promise.all([
-    lockMgr.acquireLock(lisiTask.id, 'lisi', 120),
-    lockMgr.acquireLock(wangwuTask.id, 'wangwu', 120)
-  ]);
-
-  console.log(`🔒 兩個任務已並行鎖定`);
-
-  // ============================================================================
-  // 場景：依賴關係管理
-  // ============================================================================
-
-  console.log('\n🔗 場景 6: 依賴關係管理');
-  console.log('-'.repeat(60));
-
-  // 建立有依賴的任務
-  const loginAPITask = await api.createTask({
-    title: '實作登入 API',
-    priority: 'P1',
-    created_by: {
-      name: 'Backend Lead',
-      git_user: 'backend_lead',
-      timestamp: new Date().toISOString()
-    }
-  });
-
-  const loginUITask = await api.createTask({
-    title: '整合登入 UI 與 API',
-    priority: 'P1',
-    created_by: {
-      name: 'Frontend Lead',
-      git_user: 'frontend_lead',
-      timestamp: new Date().toISOString()
-    }
-  });
-
-  // 設置依賴：UI 整合依賴 API
-  await api.updateTask(loginUITask.id, {
-    dependencies: [loginAPITask.id]
-  });
-
-  console.log(`✅ 建立依賴關係:`);
-  console.log(`   ${loginUITask.title}`);
-  console.log(`   依賴 → ${loginAPITask.title}`);
-
-  // 檢查依賴是否滿足
-  const depTask = await api.getTask(loginAPITask.id);
-  if (depTask.status !== 'completed') {
-    console.log(`\n⚠️  警告: 依賴任務 ${loginAPITask.id} 尚未完成`);
-    console.log(`   ${loginUITask.title} 無法開始`);
-  }
-
-  // ============================================================================
-  // 場景：緊急任務插隊
-  // ============================================================================
-
-  console.log('\n🚨 場景 7: 緊急任務插隊');
-  console.log('-'.repeat(60));
-
-  const urgentTask = await api.createTask({
-    title: '修復線上登入問題',
-    description: '用戶無法登入，緊急修復',
-    priority: 'P0',
-    created_by: {
-      name: 'On-Call Engineer',
-      git_user: 'oncall',
-      timestamp: new Date().toISOString()
-    }
-  });
-
-  console.log(`🚨 緊急任務建立: ${urgentTask.id}`);
-  console.log(`   標題: ${urgentTask.title}`);
-  console.log(`   優先級: ${urgentTask.priority}`);
-
-  // 立即分配給有經驗的開發者
-  await api.updateTask(urgentTask.id, {
-    assigned_to: {
-      name: 'zhangsan',
-      git_user: 'zhangsan',
-      timestamp: new Date().toISOString()
-    }
-  });
-
-  console.log(`✅ 緊急任務分配給: zhangsan`);
-
-  // ============================================================================
-  // 場景：團隊進度報告
-  // ============================================================================
-
-  console.log('\n📊 場景 8: 團隊進度報告');
-  console.log('-'.repeat(60));
-
-  const allData = await api.getAllTasks();
-
-  // 按用戶統計
-  const userStats = {};
-  allData.tasks.forEach(task => {
-    if (task.assigned_to) {
-      const user = task.assigned_to.git_user;
-      if (!userStats[user]) {
-        userStats[user] = { total: 0, pending: 0, in_progress: 0, completed: 0 };
-      }
-      userStats[user].total++;
-      userStats[user][task.status]++;
-    }
-  });
-
-  console.log('✅ 團隊進度統計:\n');
-  Object.entries(userStats).forEach(([user, stats]) => {
-    console.log(`   @${user}:`);
-    console.log(`     總任務: ${stats.total}`);
-    console.log(`     待辦: ${stats.pending || 0}`);
-    console.log(`     進行中: ${stats.in_progress || 0}`);
-    console.log(`     已完成: ${stats.completed || 0}`);
-    console.log('');
-  });
-
-  // 計算完成率
-  const totalAssigned = allData.tasks.filter(t => t.assigned_to).length;
-  const totalCompleted = allData.tasks.filter(t => t.status === 'completed').length;
-  const completionRate = ((totalCompleted / totalAssigned) * 100).toFixed(1);
-
-  console.log(`📈 整體完成率: ${completionRate}% (${totalCompleted}/${totalAssigned})`);
-
-  // ============================================================================
-  // 場景：Sprint 回顧
-  // ============================================================================
-
-  console.log('\n🎯 場景 9: Sprint 回顧');
-  console.log('-'.repeat(60));
-
-  // 統計本次 Sprint 的任務
-  const sprintTasks = allData.tasks;
-
-  const priorityDistribution = {
-    'P0': sprintTasks.filter(t => t.priority === 'P0').length,
-    'P1': sprintTasks.filter(t => t.priority === 'P1').length,
-    'P2': sprintTasks.filter(t => t.priority === 'P2').length,
-    'P3': sprintTasks.filter(t => t.priority === 'P3').length
-  };
-
-  console.log('✅ 任務分布:');
-  Object.entries(priorityDistribution).forEach(([priority, count]) => {
-    if (count > 0) {
-      console.log(`   ${priority}: ${count} 個`);
-    }
-  });
-
-  // 完成時間分析
-  const completedWithTime = sprintTasks.filter(t => t.executed_by);
-  if (completedWithTime.length > 0) {
-    console.log('\n✅ 完成時間分析:');
-    completedWithTime.forEach(task => {
-      const created = new Date(task.created_by.timestamp);
-      const completed = new Date(task.executed_by.timestamp);
-      const durationHours = Math.round((completed - created) / (1000 * 60 * 60));
-
-      console.log(`   [${task.id}] ${task.title}`);
-      console.log(`     耗時: ${durationHours} 小時`);
-    });
-  }
-
-  // ============================================================================
-  // 清理
-  // ============================================================================
-
-  console.log('\n🗑️  清理範例任務');
-  console.log('-'.repeat(60));
-
-  for (const task of tasks) {
-    await api.deleteTask(task.id);
-  }
-  await api.deleteTask(loginAPITask.id);
-  await api.deleteTask(loginUITask.id);
-  await api.deleteTask(urgentTask.id);
-
-  console.log(`✅ 已刪除 ${tasks.length + 3} 個範例任務`);
-
-  console.log('\n' + '='.repeat(60));
-  console.log('✅ 範例執行完成！');
-  console.log('='.repeat(60));
-}
-
-// 執行範例
-if (require.main === module) {
-  main().catch(error => {
-    console.error('❌ 執行失敗:', error.message);
-    console.error(error.stack);
-    process.exit(1);
-  });
-}
-
-module.exports = { main };