kenaz 0.3.3 → 0.3.6

package/core/plugins/kenaz/skills/ui-ux-pro-max/scripts/search.py

@@ -1,106 +1,106 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
-Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
-       python search.py "<query>" --design-system [-p "Project Name"]
-       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
-
-Domains: style, prompt, color, chart, landing, product, ux, typography
-Stacks: html-tailwind, react, nextjs
-
-Persistence (Master + Overrides pattern):
-  --persist    Save design system to design-system/MASTER.md
-  --page       Also create a page-specific override file in design-system/pages/
-"""
-
-import argparse
-from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
-from design_system import generate_design_system, persist_design_system
-
-
-def format_output(result):
-    """Format results for Claude consumption (token-optimized)"""
-    if "error" in result:
-        return f"Error: {result['error']}"
-
-    output = []
-    if result.get("stack"):
-        output.append(f"## UI Pro Max Stack Guidelines")
-        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
-    else:
-        output.append(f"## UI Pro Max Search Results")
-        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
-    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
-
-    for i, row in enumerate(result['results'], 1):
-        output.append(f"### Result {i}")
-        for key, value in row.items():
-            value_str = str(value)
-            if len(value_str) > 300:
-                value_str = value_str[:300] + "..."
-            output.append(f"- **{key}:** {value_str}")
-        output.append("")
-
-    return "\n".join(output)
-
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser(description="UI Pro Max Search")
-    parser.add_argument("query", help="Search query")
-    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
-    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
-    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
-    parser.add_argument("--json", action="store_true", help="Output as JSON")
-    # Design system generation
-    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
-    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
-    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
-    # Persistence (Master + Overrides pattern)
-    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
-    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
-    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
-
-    args = parser.parse_args()
-
-    # Design system takes priority
-    if args.design_system:
-        result = generate_design_system(
-            args.query, 
-            args.project_name, 
-            args.format,
-            persist=args.persist,
-            page=args.page,
-            output_dir=args.output_dir
-        )
-        print(result)
-        
-        # Print persistence confirmation
-        if args.persist:
-            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
-            print("\n" + "=" * 60)
-            print(f"✅ Design system persisted to design-system/{project_slug}/")
-            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
-            if args.page:
-                page_filename = args.page.lower().replace(' ', '-')
-                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
-            print("")
-            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
-            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
-            print("=" * 60)
-    # Stack search
-    elif args.stack:
-        result = search_stack(args.query, args.stack, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))
-    # Domain search
-    else:
-        result = search(args.query, args.domain, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/lib/cli.js

@@ -55,7 +55,10 @@ function platformServer() {
 }
 
 function onPath(cmd) {
-  return spawnSync(cmd, ['--version'], { encoding: 'utf8', shell: process.platform === 'win32', timeout: 15000 }).status === 0;
+  const r = process.platform === 'win32' // one string with shell (.cmd shims); args + shell:true is deprecated (DEP0190)
+    ? spawnSync(cmd + ' --version', { encoding: 'utf8', shell: true, timeout: 15000 })
+    : spawnSync(cmd, ['--version'], { encoding: 'utf8', timeout: 15000 });
+  return r.status === 0;
 }
 
 /** setup-codex.js from the installed core (dry-run and doctor-before-install: from the package). */
@@ -197,9 +200,9 @@ function status(p, flags, out) {
   return 0;
 }
 
-function probe(port) {
+function probe(port, urlPath = '/api/health') {
   return new Promise((resolve) => {
-    const req = http.get({ host: '127.0.0.1', port, path: '/api/health', timeout: 2500 }, (res) => {
+    const req = http.get({ host: '127.0.0.1', port, path: urlPath, timeout: 2500 }, (res) => {
       let body = ''; res.on('data', (d) => { body += d; }); res.on('end', () => resolve({ ok: res.statusCode < 500, detail: `HTTP ${res.statusCode} on :${port}`, body }));
     });
     req.on('timeout', () => { req.destroy(); resolve({ ok: false, detail: `no answer on 127.0.0.1:${port}` }); });
@@ -229,7 +232,11 @@ async function doctor(p, flags, out, deps = {}) {
     const o = d.portOwner;
     add(`port ${d.port} owner`, o && d.ownerIsDashboard ? 'FAIL' : 'ok', o ? `PID ${o.pid} ${o.exe || o.name}${d.ownerIsDashboard ? ' (Dashboard)' : ''}` : 'nobody listening');
   }
-  const upd = readJson(path.join(p.dir, 'update', 'status.json')); // TASK_2378, written by kenaz-server
+  // Ask the running server first: its answer carries its own version. The status file can still
+  // describe the previous binary right after an upgrade (field report: "[running 0.3.1]" on 0.3.3).
+  let upd = null;
+  if (r.ok) { const u = await probe(process.env.KENAZ_HTTP_PORT || '18080', '/api/update/status'); try { upd = JSON.parse(u.body); } catch (_) { /* older server */ } }
+  if (!upd || !upd.state) upd = readJson(path.join(p.dir, 'update', 'status.json')); // TASK_2378, written by kenaz-server
   if (!upd) add('self-update', 'skip', 'no status yet (kenaz-server has not run the updater)');
   else {
     const d = { disabled: `off: ${upd.reason}`, error: `last check failed: ${upd.last_error}`, staged: `${upd.staged_version} staged, applies when idle`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.3",
+  "version": "0.3.6",
   "description": "Install Kenaz (plugin, hooks, kenaz-server) for Claude Code and Codex: npx kenaz install",
   "bin": {
     "kenaz": "bin/kenaz.js"
@@ -20,11 +20,15 @@
     "test": "node --test lib/cli.test.js"
   },
   "optionalDependencies": {
-    "@kenazai/server-win32-x64": "0.3.3",
-    "@kenazai/server-darwin-arm64": "0.3.3",
-    "@kenazai/server-darwin-x64": "0.3.3",
-    "@kenazai/server-linux-x64": "0.3.3",
-    "@kenazai/server-linux-arm64": "0.3.3"
+    "@kenazai/server-darwin-arm64": "0.3.6",
+    "@kenazai/server-darwin-x64": "0.3.6",
+    "@kenazai/server-linux-arm64": "0.3.6",
+    "@kenazai/server-linux-x64": "0.3.6",
+    "@kenazai/server-win32-x64": "0.3.6"
   },
-  "license": "UNLICENSED"
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xyz9516/KenazAI.git"
+  }
 }

package/vendor/install-kenaz-cli.js

@@ -111,7 +111,9 @@ function retireDashboardHooks(file, dry) {
 }
 
 function claudeVersion() {
-  const r = spawnSync('claude', ['--version'], { encoding: 'utf8', shell: process.platform === 'win32', timeout: 15000 });
+  const r = process.platform === 'win32' // one string with shell (.cmd shim): args + shell:true is deprecated (DEP0190)
+    ? spawnSync('claude --version', { encoding: 'utf8', shell: true, timeout: 15000 })
+    : spawnSync('claude', ['--version'], { encoding: 'utf8', timeout: 15000 });
   return r.status === 0 ? parseVersion(r.stdout) : null;
 }
 
@@ -125,14 +127,21 @@ function winVbs(bin, core) { // hidden window, env for task tools; server binds
   return 'Set sh = WScript.CreateObject("WScript.Shell")\r\nsh.Environment("Process")("KENAZ_SOURCE_DIR") = "' + core + '"\r\n' +
     'sh.Run """' + bin + '""", 0, False\r\n';
 }
-function launchdPlist(bin, core, log) {
+// launchd and systemd start the server with a bare PATH (/usr/bin:/bin...), so `node` from Homebrew,
+// nvm or /usr/local was not found and every MCP tool that runs a node script failed with
+// "No such file or directory" (field report, macOS 0.3.1). Put the node running this install first.
+function servicePath(nodeExe = process.execPath) {
+  return [path.dirname(nodeExe), '/opt/homebrew/bin', '/usr/local/bin', '/usr/bin', '/bin', '/usr/sbin', '/sbin']
+    .filter((d, i, a) => a.indexOf(d) === i).join(':');
+}
+function launchdPlist(bin, core, log, nodeExe) {
   return '<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0"><dict>\n' +
     '  <key>Label</key><string>' + LABEL + '</string>\n  <key>ProgramArguments</key><array><string>' + bin + '</string></array>\n' +
-    '  <key>EnvironmentVariables</key><dict><key>KENAZ_SOURCE_DIR</key><string>' + core + '</string></dict>\n' +
+    '  <key>EnvironmentVariables</key><dict><key>KENAZ_SOURCE_DIR</key><string>' + core + '</string><key>PATH</key><string>' + servicePath(nodeExe) + '</string></dict>\n' +
     '  <key>RunAtLoad</key><true/>\n  <key>KeepAlive</key><true/>\n  <key>StandardOutPath</key><string>' + log + '</string>\n  <key>StandardErrorPath</key><string>' + log + '</string>\n</dict></plist>\n';
 }
-function systemdUnit(bin, core) {
-  return '[Unit]\nDescription=Kenaz server (headless backend)\nAfter=network.target\n\n[Service]\nExecStart=' + bin + '\nEnvironment=KENAZ_SOURCE_DIR=' + core + '\nRestart=on-failure\n\n[Install]\nWantedBy=default.target\n';
+function systemdUnit(bin, core, nodeExe) {
+  return '[Unit]\nDescription=Kenaz server (headless backend)\nAfter=network.target\n\n[Service]\nExecStart=' + bin + '\nEnvironment=KENAZ_SOURCE_DIR=' + core + '\nEnvironment=PATH=' + servicePath(nodeExe) + '\nRestart=on-failure\n\n[Install]\nWantedBy=default.target\n';
 }
 
 function servicePlan(home, bin, core, platform = process.platform) {
@@ -163,7 +172,9 @@ function serviceInstall(plan, dry, log) {
       fs.mkdirSync(path.dirname(plan.fallbackFile), { recursive: true });
       fs.copyFileSync(plan.files[0][0], plan.fallbackFile);
       sh('wscript.exe', [plan.files[0][0]]);
-      log('schtasks refused (' + (r.stderr || '').trim() + '); installed Startup-folder launcher instead');
+      // schtasks' stderr is in the console's OEM code page (garbled when echoed); the usual cause is
+      // missing admin rights for /SC ONLOGON. The Startup-folder launcher starts at logon the same way.
+      log('schtasks needs administrator rights here (exit ' + r.status + '); installed the Startup-folder launcher instead (also starts at logon)');
     }
   } else if (plan.kind === 'launchd') {
     log('launchctl load -w ' + plan.unit); if (!dry) sh('launchctl', ['load', '-w', plan.unit]);
@@ -259,7 +270,7 @@ function main(argv, out = console.log, getVersion = claudeVersion) { // getVersi
     else if (!bin) { out('service: skipped, kenaz-server binary not found (pass --server-bin)'); rc = 1; }
     else serviceInstall(plan, dry, log);
   }
-  if (cmd === 'install' && rc === 0) out('Next: cd <your project>; claude; /kenaz init; /Ansuz');
+  if (cmd === 'install' && rc === 0) out('Next: cd <your project>; claude; /kenaz:kenaz init; /kenaz:Ansuz   (Codex: run /hooks once to trust the kenaz hooks, then $kenaz status)');
   if (cmd === 'uninstall') out('Project .kenaz/ data was left untouched.');
   return rc;
 }

package/core/.formation/legion/forge.yaml

@@ -1,299 +0,0 @@
-skill: forge
-formation: legion
-version: "1.0"
-
-name: Forge
-description: |
-  順序流水線：設計 → 打造 → 淬煉。
-  一個人設計藍圖，多個人照藍圖打造，一個人驗收淬煉。
-  每個階段的產出是下一階段的輸入。階段之間有回饋循環 — 打造時發現設計問題可以即時回報修正。
-  這是 Legion 最經典的模式：有序、有回饋、有品質把關。
-
-# ─────────────────────────────────────────
-# 溝通模式（核心設計）
-# ─────────────────────────────────────────
-
-topology: pipeline
-# designer → implementer(s) → reviewer
-#     ↑ 回饋修正 ←─────────────↓
-
-communication:
-  core_pattern: |
-    順序傳遞 + 回饋循環：
-    1. Designer 產出藍圖（介面契約、架構設計、遷移計劃）
-    2. Implementer(s) 按藍圖執行，遇到問題即時回報 Designer
-    3. Reviewer 驗收每個 Implementer 的產出，不通過則打回修正
-    4. 全部通過後，Reviewer 通知 Team Lead
-
-  triggers:
-    - name: 藍圖發布
-      when: Designer 完成或更新設計
-      who: designer → all implementers + reviewer
-      content: 介面契約、架構設計、分工建議
-
-    - name: 問題回報
-      when: Implementer 發現藍圖有問題（設計不可行、漏洞、矛盾）
-      who: implementer → designer
-      content: 問題描述、影響範圍、建議修正
-
-    - name: 跨邊界通知
-      when: Implementer 修改了影響其他 Implementer 的介面
-      who: implementer → implementer
-      content: 修改的介面、舊 → 新、需要對方配合的變更
-
-    - name: 完成通知
-      when: Implementer 完成分配的工作
-      who: implementer → reviewer
-      content: 完成的模組、修改的檔案、風險點
-
-    - name: 審查結果
-      when: Reviewer 完成審查
-      who: reviewer → implementer
-      content: 通過 / 需修正（附具體問題和位置）
-
-    - name: 全部通過
-      when: 所有 Implementer 的產出都通過審查
-      who: reviewer → team-lead
-      content: 審查摘要、整體品質評估
-
-  broadcast_policy: |
-    只在以下情況 broadcast：
-    - 藍圖有破壞性變更（所有人都要更新認知）
-    - Team Lead 調整分工
-    其他一律用 message 直接溝通。
-
-# ─────────────────────────────────────────
-# 成員定義（動態，由 Lead 根據任務決定）
-# ─────────────────────────────────────────
-
-members:
-  roles:
-    - id: designer
-      name: Designer
-      count: 1
-      description: |
-        設計藍圖的人。可以是架構師、API 設計師、遷移規劃者 — 取決於任務。
-        核心產出：藍圖（介面契約、架構圖、遷移步驟、分工建議）。
-      responsibilities:
-        - 分析需求，設計解決方案
-        - 定義介面契約（型別、函數簽名、模組邊界）
-        - 規劃實作順序和分工建議
-        - 回應 Implementer 的問題回報，必要時更新藍圖
-      sends_to: [implementers, reviewer]
-      receives_from: [implementers, reviewer]
-
-    - id: implementer
-      name: Implementer
-      count: "1-3（由 Lead 根據任務規模決定）"
-      description: |
-        按藍圖打造的人。拿到 Designer 的藍圖和分配的範圍，執行實作。
-        發現問題即時回報 Designer，不要自己猜。
-      responsibilities:
-        - 按藍圖和分配的範圍執行實作
-        - 更新所有受影響的引用和依賴
-        - 跨邊界變更時通知其他 Implementer
-        - 完成後通知 Reviewer
-      sends_to: [designer, other_implementers, reviewer]
-      receives_from: [designer, other_implementers, reviewer]
-
-    - id: reviewer
-      name: Reviewer
-      count: 1
-      description: |
-        淬煉品質的人。驗收每個 Implementer 的產出，確保符合藍圖、無遺漏、品質達標。
-        發現問題直接打回對應 Implementer，架構層級問題升級給 Designer。
-      responsibilities:
-        - 審查每個 Implementer 的產出
-        - 驗證介面一致性（新介面在所有消費端正確使用）
-        - 檢查舊名稱/舊路徑殘留
-        - 執行測試，確認不破壞現有功能
-      sends_to: [implementers, designer, team-lead]
-      receives_from: [implementers, designer]
-
-# ─────────────────────────────────────────
-# 生命週期
-# ─────────────────────────────────────────
-
-lifecycle:
-  phases:
-    - phase: design
-      description: Designer 分析需求、產出藍圖
-      lead_actions:
-        - 建立團隊（TeamCreate）
-        - 派出 Designer
-        - 等待藍圖產出
-      exit_criteria:
-        - Designer 產出完整藍圖（介面契約 + 分工建議）
-        - Lead 確認藍圖合理
-
-    - phase: build
-      description: Implementer(s) 按藍圖執行，Reviewer 同步就位
-      lead_actions:
-        - 根據藍圖的分工建議，派出 Implementer(s) 和 Reviewer
-        - Broadcast 藍圖給所有成員
-        - 監控跨邊界溝通，協調衝突
-      member_actions:
-        - Implementer(s) 按分配的範圍執行
-        - 遇到問題 → SendMessage 給 Designer
-        - 完成 → SendMessage 給 Reviewer
-        - Reviewer 逐一審查
-
-    - phase: temper
-      description: 全面驗證、修正、淬煉品質
-      lead_actions:
-        - 確認所有 Implementer 的產出通過 Reviewer 審查
-        - 處理未通過的修正循環（Reviewer → Implementer → Reviewer）
-        - 全量測試
-      exit_criteria:
-        - 所有模組通過審查
-        - 無編譯/型別錯誤
-        - 測試通過
-        - Grep 確認無舊名稱殘留
-
-    - phase: teardown
-      description: 收集成果、關閉團隊
-      lead_actions:
-        - 收集 Designer 的藍圖文件
-        - 收集 Implementer 的變更清單
-        - 收集 Reviewer 的審查結果
-        - 整合為完成報告
-        - shutdown_request 給所有成員
-
-# ─────────────────────────────────────────
-# 輸入輸出
-# ─────────────────────────────────────────
-
-input:
-  required:
-    - task: 任務 ID 或描述
-  optional:
-    - blueprint: 已有的設計藍圖（如有，跳過 design 階段）
-    - scope: 限制範圍
-    - preserve: 不可修改的檔案或介面
-
-output:
-  primary: |
-    完成報告：
-    - 藍圖摘要（Designer 產出）
-    - 修改的檔案列表（按 Implementer 分組）
-    - 審查結果（Reviewer 產出）
-    - 測試結果
-  secondary: |
-    - 發現但未處理的技術債
-    - 建議的後續任務
-
-# ─────────────────────────────────────────
-# 行為準則（Team Lead）
-# ─────────────────────────────────────────
-
-behavior:
-  - 先 design 再 build — 不要跳過藍圖直接開工
-  - Designer 的藍圖是唯一的真相來源（single source of truth）
-  - Implementer 之間的分工要明確，避免改同一個檔案
-  - Reviewer 說「需修正」時，必須修完才能進入 temper
-  - 控制團隊規模：1 Designer + 1~3 Implementers + 1 Reviewer（最多 5 人）
-  - 結束前用 Grep 掃描舊名稱殘留
-
-# ─────────────────────────────────────────
-# 成員 Prompt 模板
-# ─────────────────────────────────────────
-
-member_prompts:
-  designer: |
-    ## Role
-    你是 Forge 的 Designer — 鍛造的第一步，設計藍圖。
-
-    ## 你的職責
-    - 分析需求，設計解決方案
-    - 產出藍圖：介面契約、架構設計、實作步驟、分工建議
-    - 回應 Implementer 的問題回報
-
-    ## 溝通
-    - 藍圖完成 → broadcast 給所有成員
-    - 收到問題回報 → 評估後更新藍圖並通知
-    - 藍圖有破壞性變更 → broadcast
-
-    ## 任務
-    {designer_task_description}
-
-  implementer: |
-    ## Role
-    你是 Forge 的 Implementer — 鍛造的核心，按藍圖打造。
-
-    ## 你的職責
-    - 按 Designer 的藍圖執行你負責的部分
-    - 更新所有受影響的引用和依賴
-    - 發現問題即時回報 Designer，不要自己猜
-
-    ## 溝通
-    - 跨邊界變更 → SendMessage 給其他 Implementer
-    - 發現藍圖問題 → SendMessage 給 Designer
-    - 完成 → SendMessage 給 Reviewer
-    - 收到審查意見 → 修正後回覆 Reviewer
-
-    ## 你負責的範圍
-    {implementer_scope}
-
-    ## 藍圖
-    {blueprint}
-
-  reviewer: |
-    ## Role
-    你是 Forge 的 Reviewer — 鍛造的最後一步，淬煉品質。
-
-    ## 你的職責
-    - 審查每個 Implementer 的產出
-    - 驗證介面一致性
-    - 檢查舊名稱/舊路徑殘留
-    - 執行測試
-
-    ## 溝通
-    - 審查通過 → SendMessage 給對應 Implementer 確認
-    - 需要修正 → SendMessage 給對應 Implementer（附問題詳情）
-    - 架構問題 → SendMessage 給 Designer
-    - 全部通過 → SendMessage 給 team-lead
-
-    ## 藍圖
-    {blueprint}
-
-# ─────────────────────────────────────────
-# 任務系統整合
-# ─────────────────────────────────────────
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: design 階段
-      actions:
-        - 建立團隊（TeamCreate）
-        - 派出 Designer 分析並設計
-        - 等待藍圖產出
-
-    - step: build 階段
-      actions:
-        - 根據藍圖分工，派出 Implementer(s) 和 Reviewer
-        - Broadcast 藍圖
-        - 監控溝通，協調衝突
-
-    - step: temper 階段
-      actions:
-        - 確認所有產出通過審查
-        - 處理修正循環
-        - 全量測試
-
-    - step: teardown
-      actions:
-        - 收集成果，關閉團隊
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked