kenaz 0.3.18 → 0.3.20

package/core/.system/sunny/teammates/README.md

@@ -1,107 +0,0 @@
-# Sunny Team Launcher
-
-使用 Claude Code Agent Teams 功能啟動多 Agent 協作（實驗性）。
-
-## 環境需求
-
-```bash
-# 自動設定，無需手動配置
-CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
-```
-
-## 快速開始
-
-### Window Mode（互動式）
-
-```bash
-# 啟動 debug 團隊（競爭假設）
-node .system/sunny/teammates/tools/powershell/launcher.js --preset debug --task "找出記憶體洩漏原因"
-
-# 啟動 developer 團隊
-node .system/sunny/teammates/tools/powershell/launcher.js --preset developer --task "實作登入功能"
-
-# 啟動 strategy 團隊
-node .system/sunny/teammates/tools/powershell/launcher.js --preset strategy --task "設計快取架構"
-
-# 啟動 review 團隊
-node .system/sunny/teammates/tools/powershell/launcher.js --preset review --task "審查 src/api/"
-```
-
-### Headless Mode（無頭模式）
-
-```bash
-# 不開視窗，輸出存到 log
-node .system/sunny/teammates/tools/headless/launcher.js --preset debug --task "調查 crash"
-
-# 自訂輸出路徑
-node .system/sunny/teammates/tools/headless/launcher.js --preset developer --task "實作功能" --output ./output.log
-```
-
-## 預設團隊
-
-| Preset | 成員 | 用途 |
-|--------|------|------|
-| `debug` | Investigator-A, B, C | 問題調查（競爭假設） |
-| `developer` | Frontend + Backend + Reviewer | 功能開發 |
-| `strategy` | Architect + Researcher + Critic | 架構分析 |
-| `review` | Security + Performance + Testing | Code Review |
-
-## 命令選項
-
-### Window Mode
-
-| 選項 | 說明 |
-|------|------|
-| `--preset <name>` | 使用預設團隊 (debug\|developer\|strategy\|review) |
-| `--task <prompt>` | 任務描述 |
-| `--mode <mode>` | 隊友顯示模式 (in-process\|tmux) |
-| `--cwd <path>` | 工作目錄 |
-| `--run` | 直接執行（不開新視窗） |
-| `--list-presets` | 列出可用預設 |
-
-### Headless Mode
-
-| 選項 | 說明 |
-|------|------|
-| `--preset <name>` | 使用預設團隊 |
-| `--task <prompt>` | 任務描述 |
-| `--output <path>` | 輸出檔路徑（預設: `log/session/{session_id}.log`） |
-| `--cwd <path>` | 工作目錄 |
-
-## 操作快捷鍵
-
-| 按鍵 | 功能 |
-|------|------|
-| `Shift+Up/Down` | 切換隊友 |
-| `Ctrl+T` | 顯示/隱藏任務清單 |
-| `Enter` | 查看隊友工作階段 |
-| `Escape` | 中斷當前回合 |
-
-## 目錄結構
-
-```
-.system/sunny/teammates/
-├── tools/
-│   ├── powershell/
-│   │   ├── launcher.js    # Window Mode 啟動器
-│   │   └── start.bat      # 批次啟動腳本
-│   ├── headless/
-│   │   └── launcher.js    # Headless Mode 啟動器
-│   └── utils/
-│       ├── env.js         # 環境變數設定
-│       └── format-output.js  # 輸出格式化
-├── log/
-│   └── session/           # Headless 執行日誌
-├── how_to_use.yaml        # 使用指南（YAML 格式）
-└── README.md              # 本文件
-```
-
-## 注意事項
-
-- 所有 teammates 預設使用 `sonnet` model 降低成本
-- Team Lead 負責協調所有 teammates，需等待全部回報才結束
-- 這是獨立系統，使用 Claude Code 官方 Agent Teams 功能
-
-## 官方文檔
-
-https://docs.anthropic.com/en/docs/claude-code/agent-teams

package/core/.system/sunny/teammates/how_to_use.yaml

@@ -1,101 +0,0 @@
-# Sunny Team Launcher
-# 使用 Claude Code Agent Teams 功能啟動多 Agent 協作
-# 版本: 1.1.0
-
-overview:
-  description: "Claude Code Agent Teams 啟動器（實驗性）"
-  requirement: "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1"
-  when_to_use:
-    - 需要多角度調查問題
-    - 平行開發多個功能
-    - 程式碼審查與安全檢測
-    - 技術決策與架構設計
-
-modes:
-  window:
-    name: "Window Mode"
-    path: ".system/sunny/teammates/tools/powershell/launcher.js"
-    status: stable
-    description: "開啟新 CMD 視窗執行，支援互動式對話"
-    command: |
-      node .system/sunny/teammates/tools/powershell/launcher.js --preset <preset> --task "<task>"
-    options:
-      - "--preset <name>   | 使用預設團隊"
-      - "--task <prompt>   | 任務描述"
-      - "--mode <mode>     | 隊友顯示模式 (in-process|tmux)"
-      - "--cwd <path>      | 工作目錄"
-      - "--run             | 直接執行（不開新視窗）"
-      - "--list-presets    | 列出可用預設"
-
-  headless:
-    name: "Headless Mode"
-    path: ".system/sunny/teammates/tools/headless/launcher.js"
-    status: stable
-    description: "無頭模式，不開視窗，輸出存到 log 檔"
-    command: |
-      node .system/sunny/teammates/tools/headless/launcher.js --preset <preset> --task "<task>"
-    options:
-      - "--preset <name>   | 使用預設團隊"
-      - "--task <prompt>   | 任務描述"
-      - "--output <path>   | 輸出檔路徑（預設: log/session/{session_id}.log）"
-      - "--cwd <path>      | 工作目錄"
-    log_format: "YYYYMMDD-HHMMSS-XXXX.log"
-
-presets:
-  debug:
-    description: "問題調查（競爭假設）"
-    members:
-      - "Investigator-A → 調查假設 A"
-      - "Investigator-B → 調查假設 B"
-      - "Investigator-C → 調查假設 C"
-    behavior: "各自調查不同角度，互相辯駁直到達成共識"
-    use_case: ["Bug 調查", "根因分析", "多角度驗證"]
-    example: |
-      node .../powershell/launcher.js --preset debug --task "為什麼 auth.js 會 crash"
-
-  developer:
-    description: "功能開發"
-    members:
-      - "Frontend → React/TypeScript UI 實作"
-      - "Backend → API 和資料庫"
-      - "Reviewer → 審查變更"
-    behavior: "前後端分工開發，Reviewer 審查品質"
-    use_case: ["新功能開發", "Bug 修復", "程式碼實現"]
-    example: |
-      node .../powershell/launcher.js --preset developer --task "實作用戶登入功能"
-
-  strategy:
-    description: "技術決策"
-    members:
-      - "Architect → 系統設計與技術決策"
-      - "Researcher → 調查選項、蒐集資訊"
-      - "Critic → 挑戰假設、找出漏洞"
-    behavior: "架構師設計，研究員調查，批評者挑戰"
-    use_case: ["架構設計", "技術選型", "方案評估"]
-    example: |
-      node .../powershell/launcher.js --preset strategy --task "評估是否應該用 GraphQL"
-
-  review:
-    description: "程式碼審查"
-    members:
-      - "Security → 漏洞檢測"
-      - "Performance → 效能瓶頸"
-      - "Testing → 測試覆蓋率"
-    behavior: "三個專家各自審查不同面向"
-    use_case: ["安全審計", "效能分析", "測試檢查"]
-    example: |
-      node .../powershell/launcher.js --preset review --task "審查 src/api/ 目錄"
-
-shortcuts:
-  keyboard:
-    - "Shift+Up/Down | 切換隊友"
-    - "Ctrl+T        | 顯示/隱藏任務清單"
-    - "Enter         | 查看隊友工作階段"
-    - "Escape        | 中斷當前回合"
-
-tips:
-  - "複雜問題 → debug preset（多假設競爭）"
-  - "開發任務 → developer preset（分工高效）"
-  - "重大決策 → strategy preset（避免盲點）"
-  - "上線前 → review preset（全面檢查）"
-  - "所有 teammates 使用 sonnet model 降低成本"

package/core/.system/sunny/teammates/tools/headless/launcher.js

@@ -1,318 +0,0 @@
-#!/usr/bin/env node
-/**
- * Sunny Team Launcher - Headless Mode
- * 無頭模式：不開視窗，直接在終端執行，完成後自動退出
- */
-
-const { spawn } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-const crypto = require('crypto');
-const { getClaudeEnv } = require('../utils/env');
-const { formatEntry } = require('../utils/format-output');
-
-/**
- * 生成 Session ID
- * 格式: YYYYMMDD-HHMMSS-XXXX (時間戳 + 4字元隨機碼)
- */
-function generateSessionId() {
-  const now = new Date();
-  const timestamp = now.toISOString()
-    .replace(/[-:T]/g, '')
-    .slice(0, 14); // YYYYMMDDHHMMSS
-  const random = crypto.randomBytes(2).toString('hex'); // 4 chars
-  return `${timestamp.slice(0, 8)}-${timestamp.slice(8, 14)}-${random}`;
-}
-
-/**
- * 取得預設 log 路徑
- */
-function getDefaultLogPath(sessionId) {
-  // 從 tools/headless/ 往上回到 teammates/log/session/
-  const logDir = path.join(__dirname, '..', '..', 'log', 'session');
-  if (!fs.existsSync(logDir)) {
-    fs.mkdirSync(logDir, { recursive: true });
-  }
-  return path.join(logDir, `${sessionId}.log`);
-}
-
-const CONFIG = {
-  cwd: process.cwd(),
-  teammateMode: 'in-process'
-};
-
-// 系統前置指示
-const SYSTEM_PREFIX = `You are the TEAM LEAD using Claude Code's OFFICIAL "agent teams" feature.
-
-YOUR ROLE: Team Lead
-- You are RESPONSIBLE for this task's success or failure.
-- You MUST coordinate teammates and ensure they complete their work.
-- You CANNOT end the session until ALL teammates have reported back.
-- If you end early, the task FAILS and it's YOUR fault.
-
-This is NOT the project's .formation/ directory system. Do NOT read .formation/ files.
-To create teammates, use natural language like: "Create a teammate named X who handles Y"
-Each teammate is a separate Claude instance running in parallel.
-
-`;
-
-// 共用後置指示
-const AUTO_EXECUTE = `
-
-BEFORE YOU START - OUTPUT YOUR PLAN:
-First, explain exactly what you will do step by step:
-1. What teammates will you create?
-2. How will you wait for their results?
-3. What tools will you use to poll for messages?
-4. When will you know all teammates are done?
-
-RULES:
-1. Do NOT ask questions. Execute immediately after stating your plan.
-2. Do NOT read CLAUDE.md - this is a separate system.
-3. Create teammates using natural language descriptions.
-4. IMPORTANT: Use "sonnet" model for ALL teammates to reduce cost.
-
-WAITING FOR TEAMMATES - CRITICAL:
-5. After spawning ALL teammates, you MUST enter a polling loop.
-6. In the loop: call "sleep 5" with Bash, then check if teammates sent messages.
-7. Teammates send results via SendMessage - you will see them as incoming user messages.
-8. Keep looping (sleep + check) until you have received messages from ALL teammates.
-9. Do NOT end until you have ACTUAL CONTENT from every single teammate.
-10. If a teammate is slow, keep waiting - do NOT give up or timeout early.
-11. Only after ALL teammates report back, synthesize their findings into final answer.`;
-
-const TEAM_PRESETS = {
-  developer: {
-    prompt: `${SYSTEM_PREFIX}Create an agent team with 3 teammates for development:
-1. "Frontend" - handles React/TypeScript UI implementation
-2. "Backend" - handles API and database work
-3. "Reviewer" - reviews changes and checks for issues
-
-Start working on the task immediately.${AUTO_EXECUTE}`
-  },
-  strategy: {
-    prompt: `${SYSTEM_PREFIX}Create an agent team with 3 teammates for strategic analysis:
-1. "Architect" - handles system design and technical decisions
-2. "Researcher" - investigates options and gathers information
-3. "Critic" - challenges assumptions and finds flaws
-
-Analyze and discuss the task, then provide recommendations.${AUTO_EXECUTE}`
-  },
-  review: {
-    prompt: `${SYSTEM_PREFIX}Create an agent team with 3 teammates for code review:
-1. "Security" - checks for vulnerabilities
-2. "Performance" - checks for bottlenecks
-3. "Testing" - validates test coverage
-
-Review the codebase and report findings.${AUTO_EXECUTE}`
-  },
-  debug: {
-    prompt: `${SYSTEM_PREFIX}Create an agent team with 3 teammates for debugging:
-1. "Investigator-A" - investigates hypothesis A
-2. "Investigator-B" - investigates hypothesis B
-3. "Investigator-C" - investigates hypothesis C
-
-Each investigates a different angle. Debate and disprove each other's theories until consensus.${AUTO_EXECUTE}`
-  }
-};
-
-/**
- * 無頭模式執行 Claude + Agent Teams
- * 輸出人類可讀的日誌格式
- */
-function launchHeadless(options = {}) {
-  const sessionId = generateSessionId();
-  const {
-    task = null,
-    preset = 'developer',
-    cwd = CONFIG.cwd,
-    output = null  // null 表示使用預設路徑
-  } = options;
-
-  const outputFile = output || getDefaultLogPath(sessionId);
-
-  const env = getClaudeEnv();
-
-  // 組裝 prompt
-  const presetConfig = TEAM_PRESETS[preset];
-  let prompt = presetConfig ? presetConfig.prompt : '';
-  if (task) {
-    prompt += ` Task: ${task}`;
-  }
-
-  // 處理換行符
-  const cleanPrompt = prompt
-    .replace(/\r?\n/g, ' ')
-    .replace(/\s+/g, ' ')
-    .trim();
-
-  console.log(`☀️ Launching Claude Agent Team (Headless)...`);
-  console.log(`   Session: ${sessionId}`);
-  console.log(`   Preset: ${preset}`);
-  console.log(`   Task: ${task || '(none)'}`);
-  console.log(`   Output: ${outputFile}`);
-  console.log(`----------------------------------------`);
-
-  // 即時寫入 log - 先寫 header
-  const logStream = fs.createWriteStream(outputFile, { flags: 'w' });
-  logStream.write('================================================================================\n');
-  logStream.write('SUNNY TEAM EXECUTION LOG\n');
-  logStream.write(`Session: ${sessionId}\n`);
-  logStream.write(`Started: ${new Date().toISOString()}\n`);
-  logStream.write('================================================================================\n\n');
-
-  // 顯示 debug 資訊
-  console.log(`   [DEBUG] Prompt length: ${cleanPrompt.length} chars`);
-  console.log(`   [DEBUG] CWD: ${cwd}`);
-
-  // 寫 prompt 到臨時檔案，避免 shell 引號解析問題
-  const promptFile = path.join(__dirname, '..', '..', '.prompt.tmp');
-  fs.writeFileSync(promptFile, cleanPrompt, 'utf8');
-  console.log(`   [DEBUG] Prompt written to temp file`);
-
-  // 用 stdin 傳遞 prompt，不經過 shell 參數解析
-  const args = [
-    '-p', '-',  // 從 stdin 讀取 prompt
-    '--dangerously-skip-permissions',
-    '--teammate-mode', 'in-process',
-    '--output-format', 'stream-json',
-    '--verbose',
-    '--allowedTools', 'Bash,Read,Edit,Write,Glob,Grep,Task'
-  ];
-
-  console.log(`   [DEBUG] Spawning claude with stdin...`);
-
-  // Windows 需要用 claude.cmd + shell
-  const claudeCmd = process.platform === 'win32' ? 'claude.cmd' : 'claude';
-
-  const child = spawn(claudeCmd, args, {
-    cwd,
-    env,
-    stdio: ['pipe', 'pipe', 'pipe'],  // stdin 改成 pipe
-    windowsHide: true,
-    shell: true
-  });
-
-  // 透過 stdin 傳送 prompt
-  child.stdin.write(cleanPrompt);
-  child.stdin.end();
-
-  console.log(`   [DEBUG] Process spawned, PID: ${child.pid}`);
-
-  // 收集輸出
-  let buffer = '';
-
-  child.stdout.on('data', (data) => {
-    const str = data.toString();
-    process.stdout.write(data);
-    buffer += str;
-
-    // 按行解析 JSON 並即時寫入 log
-    const lines = buffer.split('\n');
-    buffer = lines.pop(); // 保留不完整的最後一行
-    for (const line of lines) {
-      if (line.trim()) {
-        try {
-          const entry = JSON.parse(line);
-          const formatted = formatEntry(entry);
-          if (formatted) {
-            logStream.write(formatted + '\n');
-          }
-        } catch (e) {
-          // 非 JSON 行，忽略
-        }
-      }
-    }
-  });
-
-  child.stderr.on('data', (data) => {
-    process.stderr.write(data);
-  });
-
-  child.on('error', (err) => {
-    console.error(`   [ERROR] Process error: ${err.message}`);
-  });
-
-  let closed = false;
-  const cleanup = (code) => {
-    if (closed) return;
-    closed = true;
-
-    // 處理剩餘的 buffer
-    if (buffer.trim()) {
-      try {
-        const entry = JSON.parse(buffer);
-        const formatted = formatEntry(entry);
-        if (formatted) {
-          logStream.write(formatted + '\n');
-        }
-      } catch (e) {
-        // 非 JSON 行，忽略
-      }
-    }
-
-    // 寫入 footer 並關閉 stream
-    logStream.write('\n================================================================================\n');
-    logStream.write(`Finished: ${new Date().toISOString()}\n`);
-    logStream.write(`Exit Code: ${code}\n`);
-    logStream.write('================================================================================\n');
-    logStream.end();
-
-    console.log(`----------------------------------------`);
-    console.log(`☀️ Claude exited with code ${code}`);
-    console.log(`   Session: ${sessionId}`);
-    console.log(`   Output saved to: ${outputFile}`);
-  };
-
-  child.on('close', cleanup);
-  child.on('exit', cleanup);
-
-  return child;
-}
-
-// CLI 入口
-if (require.main === module) {
-  const args = process.argv.slice(2);
-
-  if (args.includes('--help') || args.includes('-h')) {
-    console.log(`
-☀️ Sunny Team Launcher - Headless Mode
-
-Usage:
-  node launcher_headless.js [options]
-
-Options:
-  --preset <name>     Use preset team (developer|strategy|review|debug)
-  --task <prompt>     Custom task description
-  --output <path>     Output log file (default: team/log/session/{session_id}.log)
-  --cwd <path>        Working directory
-
-Session ID Format: YYYYMMDD-HHMMSS-XXXX (timestamp + 4-char random)
-
-Examples:
-  node launcher_headless.js --preset debug --task "List files"
-  node launcher_headless.js --preset debug --task "List files" --output custom.log
-`);
-    process.exit(0);
-  }
-
-  const getArg = (flag) => {
-    const idx = args.indexOf(flag);
-    return idx !== -1 && args[idx + 1] ? args[idx + 1] : null;
-  };
-
-  const preset = getArg('--preset') || 'developer';
-  const task = getArg('--task');
-  const output = getArg('--output') || null;  // null = 使用預設 session 路徑
-  const cwd = getArg('--cwd') || CONFIG.cwd;
-
-  if (!TEAM_PRESETS[preset]) {
-    console.log(`❌ Unknown preset: ${preset}`);
-    console.log('   Available: developer, strategy, review, debug');
-    process.exit(1);
-  }
-
-  launchHeadless({ preset, task, output, cwd });
-}
-
-module.exports = { launchHeadless, TEAM_PRESETS, generateSessionId };