kenaz 0.3.18 → 0.3.19

package/core/.collaboration/cli/commands/lock.js

@@ -1,45 +0,0 @@
-/**
- * lock 命令 - 鎖定任務
- */
-
-const { getPositional } = require('../utils/arg-parser');
-const { getGitUser } = require('../utils/git-user');
-const { success, error, warn } = require('../utils/output');
-
-// 可選載入 LockManager
-let LockManager = null;
-try {
-  LockManager = require('../../core/lock-manager.js').LockManager;
-} catch { /* 模組不存在 */ }
-
-module.exports = {
-  name: 'lock',
-  description: '鎖定任務',
-  options: [],
-
-  async execute(args) {
-    if (!LockManager) {
-      warn('鎖定功能未啟用（lock-manager 模組不存在）');
-      return 0;
-    }
-
-    const taskId = getPositional(args, 0);
-    if (!taskId) {
-      error('缺少任務 ID');
-      return 1;
-    }
-
-    try {
-      const gitUser = getGitUser();
-      const lockMgr = new LockManager();
-      const lock = await lockMgr.acquireLock(taskId, gitUser);
-      success(`任務已鎖定: ${lock.task_id}`);
-      console.log(`鎖定者: ${lock.locked_by}`);
-      console.log(`過期時間: ${lock.expires_at}`);
-      return 0;
-    } catch (err) {
-      error(`鎖定失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/rebuild.js

@@ -1,39 +0,0 @@
-/**
- * rebuild 命令 - 重建索引
- */
-
-const { success, error, warn } = require('../utils/output');
-
-// 可選載入 IndexManager
-let IndexManager = null;
-try {
-  IndexManager = require('../../core/index-manager.js').IndexManager;
-} catch { /* 模組不存在 */ }
-
-module.exports = {
-  name: 'rebuild',
-  description: '重建索引',
-  options: [],
-
-  async execute() {
-    if (!IndexManager) {
-      warn('索引功能未啟用（index-manager 模組不存在）');
-      return 0;
-    }
-
-    try {
-      console.log('重建索引中...');
-      const indexMgr = new IndexManager();
-      const stats = await indexMgr.rebuildAll();
-      success('索引重建完成');
-      console.log(`總任務數: ${stats.totalTasks}`);
-      console.log(`狀態分類: ${stats.byStatus}`);
-      console.log(`用戶分類: ${stats.byUser}`);
-      console.log(`優先級分類: ${stats.byPriority}`);
-      return 0;
-    } catch (err) {
-      error(`重建失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/search.js

@@ -1,61 +0,0 @@
-/**
- * search 命令 - 搜尋任務
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { getPositional, parseArgs } = require('../utils/arg-parser');
-const { error } = require('../utils/output');
-
-module.exports = {
-  name: 'search',
-  description: '搜尋任務',
-  options: ['--status', '--priority', '--role', '--tags'],
-
-  async execute(args) {
-    const keyword = getPositional(args, 0);
-    const filters = parseArgs(args, ['status', 'priority', 'role', 'tags']);
-
-    if (!keyword && Object.keys(filters).length === 0) {
-      error('缺少搜尋關鍵字或過濾條件');
-      console.log('用法: search <關鍵字> [--status STATUS] [--priority P] [--role ROLE] [--tags TAG1,TAG2]');
-      return 1;
-    }
-
-    try {
-      const api = new TaskAPI();
-
-      const query = {};
-      if (keyword) query.search = keyword;
-      if (filters.status) query.status = filters.status;
-      if (filters.priority) query.priority = filters.priority;
-      if (filters.role) query.role = filters.role;
-      if (filters.tags) query.tags = filters.tags.split(',').map(t => t.trim());
-
-      const tasks = await api.queryTasks(query);
-
-      if (tasks.length === 0) {
-        console.log('沒有符合條件的任務');
-        return 0;
-      }
-
-      const searchDesc = keyword ? `"${keyword}"` : '條件';
-      console.log(`找到 ${tasks.length} 個符合 ${searchDesc} 的任務:\n`);
-
-      tasks.forEach(task => {
-        const role = task.role || task.agent_type || '-';
-        const tags = (task.tags || []).join(',') || '-';
-        console.log(`[${task.id}] ${task.title}`);
-        console.log(`   狀態: ${task.status} | 優先級: ${task.priority} | 角色: ${role} | 標籤: ${tags}`);
-        if (task.description) {
-          console.log(`   描述: ${task.description.substring(0, 60)}${task.description.length > 60 ? '...' : ''}`);
-        }
-        console.log('');
-      });
-
-      return 0;
-    } catch (err) {
-      error(`搜尋失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/stats.js

@@ -1,61 +0,0 @@
-/**
- * stats 命令 - 顯示任務統計
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { error } = require('../utils/output');
-
-module.exports = {
-  name: 'stats',
-  description: '顯示任務統計',
-  options: [],
-
-  async execute() {
-    try {
-      const api = new TaskAPI();
-      const stats = await api.getStatistics();
-
-      console.log('任務統計\n');
-      console.log('========================================');
-
-      console.log('\n📊 按狀態:');
-      for (const [status, count] of Object.entries(stats.byStatus)) {
-        const bar = '█'.repeat(Math.min(count, 20));
-        console.log(`  ${status.padEnd(12)} ${bar} ${count}`);
-      }
-
-      console.log('\n🎯 按優先級:');
-      const priorityOrder = ['P0', 'P1', 'P2', 'P3'];
-      for (const priority of priorityOrder) {
-        const count = stats.byPriority[priority] || 0;
-        if (count > 0) {
-          const bar = '█'.repeat(Math.min(count, 20));
-          console.log(`  ${priority.padEnd(12)} ${bar} ${count}`);
-        }
-      }
-
-      console.log('\n👤 按角色:');
-      for (const [role, count] of Object.entries(stats.byRole)) {
-        const bar = '█'.repeat(Math.min(count, 20));
-        console.log(`  ${role.padEnd(16)} ${bar} ${count}`);
-      }
-
-      if (Object.keys(stats.byTags).length > 0) {
-        console.log('\n🏷️ 按標籤:');
-        for (const [tag, count] of Object.entries(stats.byTags)) {
-          const bar = '█'.repeat(Math.min(count, 20));
-          console.log(`  ${tag.padEnd(12)} ${bar} ${count}`);
-        }
-      }
-
-      console.log('\n========================================');
-      console.log(`總計: ${stats.total} 個任務`);
-      console.log(`更新時間: ${stats.timestamp}`);
-
-      return 0;
-    } catch (err) {
-      error(`統計失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/transfer.js

@@ -1,41 +0,0 @@
-/**
- * transfer 命令 - 轉移任務
- */
-
-const { TaskAPI } = require('../../core/task-api.js');
-const { getPositional, parseArgs } = require('../utils/arg-parser');
-const { success, error } = require('../utils/output');
-
-module.exports = {
-  name: 'transfer',
-  description: '轉移任務',
-  options: ['--from', '--to'],
-
-  async execute(args) {
-    const taskId = getPositional(args, 0);
-    const { from, to } = parseArgs(args, ['from', 'to']);
-
-    if (!taskId) {
-      error('缺少任務 ID');
-      return 1;
-    }
-
-    if (!from || !to) {
-      error('缺少 --from 或 --to 參數');
-      return 1;
-    }
-
-    try {
-      const api = new TaskAPI();
-      // 使用 claimTask 來轉移（重新分配）
-      const task = await api.claimTask(taskId, to);
-      success(`任務已轉移: ${task.id}`);
-      console.log(`從: ${from}`);
-      console.log(`轉移給: ${to}`);
-      return 0;
-    } catch (err) {
-      error(`轉移失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/commands/unlock.js

@@ -1,48 +0,0 @@
-/**
- * unlock 命令 - 解鎖任務
- */
-
-const { getPositional } = require('../utils/arg-parser');
-const { getGitUser } = require('../utils/git-user');
-const { success, warn, error } = require('../utils/output');
-
-// 可選載入 LockManager
-let LockManager = null;
-try {
-  LockManager = require('../../core/lock-manager.js').LockManager;
-} catch { /* 模組不存在 */ }
-
-module.exports = {
-  name: 'unlock',
-  description: '解鎖任務',
-  options: [],
-
-  async execute(args) {
-    if (!LockManager) {
-      warn('鎖定功能未啟用（lock-manager 模組不存在）');
-      return 0;
-    }
-
-    const taskId = getPositional(args, 0);
-    if (!taskId) {
-      error('缺少任務 ID');
-      return 1;
-    }
-
-    try {
-      const gitUser = getGitUser();
-      const lockMgr = new LockManager();
-      const released = await lockMgr.releaseLock(taskId, gitUser);
-
-      if (released) {
-        success(`任務已解鎖: ${taskId}`);
-      } else {
-        warn('任務未被鎖定');
-      }
-      return 0;
-    } catch (err) {
-      error(`解鎖失敗: ${err.message}`);
-      return 1;
-    }
-  }
-};

package/core/.collaboration/cli/formatters/help-formatter.js

@@ -1,70 +0,0 @@
-/**
- * 幫助文字格式化
- */
-
-const { CommandRegistry } = require('../commands');
-
-/**
- * 顯示幫助資訊
- */
-function showHelp() {
-  const commands = CommandRegistry.getAll();
-
-  console.log(`
-任務管理 CLI
-
-用法:
-  task-cli.js <command> [options]
-
-命令:`);
-
-  // 動態生成命令列表
-  Object.values(commands).forEach(cmd => {
-    const name = cmd.name.padEnd(12);
-    console.log(`  ${name}${cmd.description}`);
-  });
-
-  console.log(`
-選項:
-  --help, -h  顯示幫助資訊
-
-範例:
-  # 建立任務
-  task-cli.js create --title "實作登入功能" --priority P1 --description "建立登入頁面和 API"
-
-  # 列出所有 pending 任務
-  task-cli.js list --status pending
-
-  # 列出指定用戶的任務
-  task-cli.js list --assigned-to zhangsan
-
-  # 列出 P0 任務
-  task-cli.js list --priority P0
-
-  # 取得任務詳情
-  task-cli.js get TASK_01HQFX9K2G
-
-  # 認領任務
-  task-cli.js claim TASK_01HQFX9K2G
-
-  # 分配任務
-  task-cli.js assign TASK_01HQFX9K2G --to lisi
-
-  # 轉移任務
-  task-cli.js transfer TASK_01HQFX9K2G --from zhangsan --to lisi
-
-  # 完成任務
-  task-cli.js complete TASK_01HQFX9K2G
-
-  # 鎖定任務
-  task-cli.js lock TASK_01HQFX9K2G
-
-  # 解鎖任務
-  task-cli.js unlock TASK_01HQFX9K2G
-
-  # 重建索引
-  task-cli.js rebuild
-  `);
-}
-
-module.exports = { showHelp };

package/core/.collaboration/cli/formatters/index.js

@@ -1,7 +0,0 @@
-/**
- * Formatters barrel export
- */
-
-module.exports = {
-  ...require('./help-formatter'),
-};

package/core/.collaboration/cli/task-cli.js

@@ -1,46 +0,0 @@
-#!/usr/bin/env node
-/**
- * task-cli.js
- * 任務管理命令列工具
- *
- * 使用方式:
- *   node .collaboration/cli/task-cli.js create --title "實作登入功能" --priority P1
- *   node .collaboration/cli/task-cli.js list --status pending
- *   node .collaboration/cli/task-cli.js claim TASK_01HQFX9K2G
- */
-
-const { CommandRegistry } = require('./commands');
-const { showHelp } = require('./formatters/help-formatter');
-const { hasFlag } = require('./utils/arg-parser');
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  // 顯示幫助
-  if (args.length === 0 || hasFlag(args, 'help') || args.includes('-h')) {
-    showHelp();
-    return 0;
-  }
-
-  const [command, ...commandArgs] = args;
-
-  try {
-    return await CommandRegistry.execute(command, commandArgs);
-  } catch (error) {
-    console.error(`❌ ${error.message}`);
-    showHelp();
-    return 1;
-  }
-}
-
-// CLI 入口
-if (require.main === module) {
-  main()
-    .then(process.exit)
-    .catch(err => {
-      console.error(`❌ 執行錯誤: ${err.message}`);
-      process.exit(1);
-    });
-}
-
-module.exports = { main };

package/core/.collaboration/cli/utils/arg-parser.js

@@ -1,74 +0,0 @@
-/**
- * 參數解析工具
- */
-
-/**
- * 解析命名參數
- * @param {string[]} args - 參數陣列
- * @param {string[]} keys - 要解析的 key 列表
- * @returns {Object} 解析結果
- */
-function parseArgs(args, keys) {
-  const result = {};
-  keys.forEach(key => {
-    const index = args.indexOf(`--${key}`);
-    if (index >= 0 && args[index + 1] && !args[index + 1].startsWith('--')) {
-      result[key] = args[index + 1];
-    }
-  });
-  return result;
-}
-
-/**
- * 取得位置參數
- * @param {string[]} args - 參數陣列
- * @param {number} index - 位置索引
- * @returns {string|undefined}
- */
-function getPositional(args, index = 0) {
-  const positionals = args.filter(a => !a.startsWith('--'));
-  return positionals[index];
-}
-
-/**
- * 解析逗號分隔的參數值為陣列
- * @param {string[]} args - 參數陣列
- * @param {string} key - 參數名稱
- * @returns {string[]} 解析結果
- */
-function parseCsv(args, key) {
-  const index = args.indexOf(`--${key}`);
-  if (index >= 0 && args[index + 1] && !args[index + 1].startsWith('--')) {
-    return args[index + 1].split(',').map(s => s.trim()).filter(Boolean);
-  }
-  return [];
-}
-
-/**
- * 收集同一 flag 多次出現的值（支援 --req "A" --req "B"）
- * @param {string[]} args - 參數陣列
- * @param {string} key - 參數名稱
- * @returns {string[]} 所有匹配的值
- */
-function parseMulti(args, key) {
-  const flag = `--${key}`;
-  const results = [];
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === flag && args[i + 1] && !args[i + 1].startsWith('--')) {
-      results.push(args[i + 1]);
-    }
-  }
-  return results;
-}
-
-/**
- * 檢查是否有指定旗標
- * @param {string[]} args - 參數陣列
- * @param {string} flag - 旗標名稱
- * @returns {boolean}
- */
-function hasFlag(args, flag) {
-  return args.includes(`--${flag}`) || args.includes(`-${flag.charAt(0)}`);
-}
-
-module.exports = { parseArgs, getPositional, hasFlag, parseCsv, parseMulti };

package/core/.collaboration/cli/utils/git-user.js

@@ -1,25 +0,0 @@
-/**
- * Git 用戶工具
- */
-
-const { execSync } = require('child_process');
-const path = require('path');
-
-const PROJECT_ROOT = path.resolve(__dirname, '../../..');
-
-/**
- * 取得當前 Git 用戶名
- * @param {string} [cwd] - 指定 git 工作目錄，預設為專案根目錄
- * @returns {string}
- */
-function getGitUser(cwd = PROJECT_ROOT) {
-  try {
-    return execSync('git config user.email', { encoding: 'utf8', cwd })
-      .trim()
-      .split('@')[0];
-  } catch {
-    return 'unknown';
-  }
-}
-
-module.exports = { getGitUser };

package/core/.collaboration/cli/utils/index.js

@@ -1,9 +0,0 @@
-/**
- * Utils barrel export
- */
-
-module.exports = {
-  ...require('./arg-parser'),
-  ...require('./git-user'),
-  ...require('./output'),
-};

package/core/.collaboration/cli/utils/output.js

@@ -1,10 +0,0 @@
-/**
- * 輸出工具
- */
-
-module.exports = {
-  success: (msg) => console.log(`✅ ${msg}`),
-  error: (msg) => console.error(`❌ ${msg}`),
-  warn: (msg) => console.log(`⚠️  ${msg}`),
-  info: (msg) => console.log(msg),
-};