kenaz 0.3.3 → 0.3.6

package/core/k-cli/README.md

@@ -33,7 +33,7 @@ cat k-cli.md
 ## 核心價值
 
 - **零依賴**：不需要 Dashboard 運行，直接呼叫底層工具
-- **spawnClaude 架構**：寫入操作透過 `spawnClaude` 直接啟動 Claude CLI，無需 headless.js 中間層
+- **spawnClaude 架構**：寫入操作透過 `spawnClaude` 直接啟動 Claude CLI
 - **dry-run 支援**：所有寫入命令支援 `--dry-run`，驗證但不執行
 - **可腳本化**：所有輸出支援 `--json` 格式，方便 pipe 和自動化
 - **明確偵測**：不猜測、不 fallback、不向上找目錄，偵測失敗就是失敗
@@ -50,8 +50,6 @@ cat k-cli.md
 | 讀取 | specialist list, task list, task get, project status... | 直接呼叫 |
 | 寫入（任務） | task create | → spawnClaude + Ansuz（分析需求 → Amelia 審查 role → 建立） |
 | 刪除 | task delete | → 直接 rm 檔案 |
-| 調度 | dispatch run TASK_XXX | → spawnClaude + Ansuz（讀 role → 判斷陣型 → headless.js） |
-| 調度 | dispatch run --auto | → spawnClaude + Ansuz（掃描 backlog → 逐個 dispatch） |
 | 執行 | specialist run | → spawnClaude + 指定 Specialist |
 
 ## 命令一覽
@@ -149,65 +147,13 @@ k-cli task create "描述"
 
 | 命令 | 說明 | 執行方式 |
 |------|------|---------|
-| `k-cli dispatch run <taskId>` | Dispatch 指定任務 | → spawnClaude + Ansuz + headless.js |
-| `k-cli dispatch run --auto` | 自動掃描 backlog 並 dispatch | → spawnClaude + Ansuz + headless.js |
 | `k-cli dispatch status <taskId>` | 查看 dispatch 狀態 | 直接讀取 |
 
 ```bash
-# 指定任務 dispatch（Ansuz 讀 role → 判斷陣型 → headless.js 執行）
-k-cli dispatch run TASK_340
-k-cli dispatch run TASK_340 --dry-run
-
-# 自動掃描（Ansuz 掃 backlog → 按優先級逐個 dispatch）
-k-cli dispatch run --auto
-k-cli dispatch run --auto --project-path /path/to/project
-
 # 查看狀態（自動搜尋 .kenaz/logs/ 或 .formation/logs/）
 k-cli dispatch status TASK_340 --tail 50
 ```
 
-#### dispatch run 流程
-
-```
-k-cli dispatch run TASK_XXX
-  │
-  └→ spawnClaude(Ansuz)
-       ├─ Step 1: task-api get → 讀取任務 role
-       ├─ Step 2: role → --skill, 判斷陣型（unit > solo > squad > legion）
-       └─ Step 3: node headless.js --skill={role} --task=TASK_XXX
-                    │
-                    headless.js 自動處理：
-                    ├─ auto-claim（backlog → active）
-                    ├─ 依賴預檢
-                    ├─ spawnClaude(agent) 執行任務
-                    ├─ ensureTaskComplete
-                    └─ postComplete（archive + git branch + merge）
-```
-
-#### Formation Role → Skill 對應
-
-| role | --skill | 說明 |
-|------|---------|------|
-| frontend | frontend | React/TypeScript UI、client-side |
-| backend | backend | API、DB、server-side |
-| designer | designer | 設計規範產出 |
-| qa | qa | 測試、Bug 驗證 |
-| sre | sre | 基礎設施、部署 |
-| developer | developer | 通才兜底 |
-
-Skill 定義檔：`.formation/legacy/{role}.yaml`
-
-#### 陣型判斷
-
-原則：能 unit 不 solo，能 solo 不 squad，能 squad 不 legion。
-
-| 陣型 | 條件 | headless.js 參數 |
-|------|------|-----------------|
-| unit（預設） | 目標明確、單一 scope | `--skill={role} --task=TASK_XXX` |
-| solo | 需多角度分析 | `--formation=solo --skill=strategy --task=TASK_XXX` |
-| squad | 多個獨立子任務可並行 | `--formation=squad --skill=blitz --task=TASK_XXX` |
-| legion | 有順序依賴或即時協調 | `--formation=legion --skill=forge --task=TASK_XXX` |
-
 ### Project 命令
 
 | 命令 | 說明 | 執行方式 |
@@ -274,7 +220,6 @@ k-cli project install k-cli --dry-run
 | `--dry-run` | 驗證但不執行（適用所有寫入 / 調度命令） |
 | `--json` | 輸出 JSON 格式 |
 | `--project-path <path>` | 指定子專案路徑（使用 `.kenaz/project.yaml` 中的 `project_path` 值） |
-| `--auto` | 自動掃描模式（僅 `dispatch run`） |
 | `--force` | 跳過品質檢查（僅 `task create`） |
 | `--no-git` | 初始化時跳過 Git（僅 `project initialize`） |
 | `--core-path <path>` | 覆蓋自動偵測的 core 路徑（僅 `project initialize`） |
@@ -306,7 +251,6 @@ k-cli/
 │   │   ├── update.ts      # task update（直接 task-api.js）
 │   │   └── delete.ts      # task delete（直接 task-api.js）
 │   ├── dispatch/          # Formation 調度功能
-│   │   ├── run.ts         # dispatch run（spawnClaude + Ansuz + headless.js）
 │   │   └── status.ts      # dispatch status（直接讀 log）
 │   └── project/           # 專案管理功能
 │       ├── status.ts      # project status（含 project.yaml 詳情）
@@ -333,10 +277,6 @@ k-cli
   │   ├─ task/create       → Ansuz 分析需求
   │   │                       → Agent tool subagent（Amelia 審查 + role）
   │   │                       → task-api.js create（最終建立）
-  │   ├─ dispatch/run      → Ansuz 讀 role + 判斷陣型
-  │   │   TASK_XXX            → headless.js --skill={role} --task=TASK_XXX
-  │   └─ dispatch/run      → Ansuz 掃 backlog + 逐個 dispatch
-  │       --auto              → headless.js × N
   │
   └─ spawnClaude（Specialist 直接執行）
       └─ specialist/run    → session.js（組裝 prompt）+ spawnClaude
@@ -354,38 +294,6 @@ spawnClaude(opts)
   └─ spawn(claude, args)    → stdin pipe prompt, stream-json 輸出
 ```
 
-### Git 流程（自動觸發鏈）
-
-```
-k-cli dispatch run TASK_XXX
-  └→ Ansuz → headless.js
-       ├─ auto-claim（backlog → active）
-       ├─ 依賴預檢
-       ├─ 保存當前分支 → .formation/.dispatch-branch
-       ├─ spawnClaude(agent) 執行任務
-       └─ agent exit 0 → 自動觸發：
-            ├─ ensureTaskComplete → task-api complete
-            └─ postComplete()
-                 ├─ archive（done/ 超過 10 個 → archived/）
-                 └─ gitBranchAndMerge()
-                      ├─ stash 未提交變更
-                      ├─ checkout -b task/task_xxx
-                      ├─ unstash + git add + commit
-                      ├─ checkout {userBranch}
-                      ├─ merge task/task_xxx --no-ff
-                      └─ 提示: merge to main when ready
-```
-
-| 階段 | 誰處理 | 自動/手動 |
-|------|--------|----------|
-| claim | headless.js | 自動 |
-| agent 執行 | headless.js → spawnClaude | 自動 |
-| task complete | headless.js ensureTaskComplete() | 自動 |
-| archive | post-complete.js | 自動 |
-| task branch + commit | post-complete.js gitBranchAndMerge() | 自動 |
-| merge 到 user branch | post-complete.js | 自動 |
-| merge 到 main | **用戶** | **手動** |
-
 ## Dry-Run 行為
 
 `--dry-run` 適用於所有有副作用的命令：
@@ -393,7 +301,6 @@ k-cli dispatch run TASK_XXX
 | 命令 | dry-run 行為 |
 |------|-------------|
 | `specialist run` | 組裝 prompt → 顯示 agent + prompt 長度 → **不 spawn Claude** |
-| `dispatch run` | 組裝 Ansuz prompt → 顯示模式 + 資訊 → **不 spawn Ansuz** |
 | `task create` | 組裝 Ansuz prompt → 顯示將建立的任務資訊 → **不啟動 Ansuz** |
 | `task update` | 組裝 task-api args → 顯示將更新的內容 → **不呼叫 task-api** |
 | `task delete` | 組裝 task-api args → 顯示將刪除的任務 → **不呼叫 task-api** |

package/core/k-cli/test/TEST_SPEC.md

@@ -14,7 +14,7 @@ npm run build && npm test
 
 ## 前置條件
 
-- Claude CLI 可用（`task create` 和 `dispatch run` 會 spawnClaude）
+- Claude CLI 可用（`task create` 會 spawnClaude）
 - `npm run build` 必須先執行
 
 ## 測試環境
@@ -64,20 +64,8 @@ npm run build && npm test
 - `k-cli task get TASK_A --project-path test/sandbox/`
 - 驗證：輸出含 TASK_A 詳細資訊
 
-### Test 6: dispatch run（指定任務）
-- 使用 Test 5 的 TASK_A
-- `k-cli dispatch run TASK_A --project-path test/sandbox/`
-- 驗證：Ansuz 讀 role → 判斷陣型 → headless.js 執行，輸出含 TASK_A
-
-### Test 7: dispatch status（等待任務完成）
-- `k-cli dispatch status TASK_A --project-path test/sandbox/`
-- 輪詢直到任務完成（或 timeout）
-- 驗證：輸出含 TASK_A 相關資訊，最終狀態為 done
-
-### Test 8: dispatch run --auto（自動掃描）
-- `k-cli dispatch run --auto --project-path test/sandbox/`
-- 驗證：自動掃描 backlog，dispatch TASK_B 和 TASK_C（或剩餘待處理任務）
-- 驗證：輸出含掃描結果
+### Test 6-8: 已移除
+- `dispatch run` 已刪除（Formation headless 調度已退役），`dispatch status` 失去可驗證的前置動作，一併移出測試
 
 ### Test 9: task delete → verify
 - 使用 Test 5 的 TASK_A
@@ -99,11 +87,9 @@ npm run build && npm test
    - 驗證：輸出含 `dry-run`，不呼叫 spawnClaude
 3. `k-cli task delete TASK_B --project-path test/sandbox/ --dry-run`
    - 驗證：輸出含 `dry-run`，任務仍存在
-4. `k-cli dispatch run TASK_B --project-path test/sandbox/ --dry-run`
-   - 驗證：輸出含 `dry-run`，不呼叫 spawnClaude
-5. `k-cli specialist run --agent Amelia 測試 --project-path test/sandbox/ --dry-run`
+4. `k-cli specialist run --agent Amelia 測試 --project-path test/sandbox/ --dry-run`
    - 驗證：輸出含 `dry-run`，不呼叫 spawnClaude
-6. `k-cli project install k-cli --project-path test/sandbox/ --dry-run`
+5. `k-cli project install k-cli --project-path test/sandbox/ --dry-run`
    - 驗證：輸出含 `dry-run`
 
 ## 結果格式
@@ -116,9 +102,6 @@ k-cli Test Suite
 [ 3/11] project status        ✅ PASS
 [ 4/11] specialist list       ✅ PASS
 [ 5/11] task create × 3       ✅ PASS
-[ 6/11] dispatch run           ✅ PASS
-[ 7/11] dispatch status        ✅ PASS
-[ 8/11] dispatch run --auto    ✅ PASS
 [ 9/11] task delete             ✅ PASS
 [10/11] specialist run Amelia  ✅ PASS
 [11/11] --dry-run              ✅ PASS

package/core/k-cli/test/run.sh

@@ -280,62 +280,6 @@ test_5_task_create() {
   return 0
 }
 
-# =========================================
-# Test 6: dispatch run (specific task)
-# =========================================
-test_6_dispatch_run() {
-  local task_id
-  task_id=$(cat "$SANDBOX/.test_task_a" 2>/dev/null) || { echo "  No TASK_A from test 5"; return 1; }
-  log "  Dispatching: $task_id"
-
-  run_cmd $KCLI dispatch run "$task_id" --project-path "$SANDBOX"
-  local output="$LOG_CMD_OUTPUT"
-  assert_contains "dispatch run" "$output" "$task_id" || return 1
-  return 0
-}
-
-# =========================================
-# Test 7: dispatch status (wait for done)
-# =========================================
-test_7_dispatch_status() {
-  local task_id
-  task_id=$(cat "$SANDBOX/.test_task_a" 2>/dev/null) || { echo "  No TASK_A from test 5"; return 1; }
-
-  # Poll up to 10 times (10 sec intervals)
-  local i output
-  for i in $(seq 1 10); do
-    log "  --- Poll $i/10 ---"
-    run_cmd $KCLI dispatch status "$task_id" --project-path "$SANDBOX"
-    output="$LOG_CMD_OUTPUT"
-    if echo "$output" | grep -qi "done\|complete\|finished"; then
-      log "  ✓ Task completed"
-      return 0
-    fi
-    sleep 10
-  done
-
-  # After polling, still check if task is in done dir
-  if [ -d "$SANDBOX/.kenaz/tasks/done/$task_id" ]; then
-    log "  ✓ Task found in done dir"
-    return 0
-  fi
-
-  # Accept any output containing the task ID as partial pass
-  assert_contains "dispatch status" "$output" "$task_id" || return 1
-  return 0
-}
-
-# =========================================
-# Test 8: dispatch run --auto
-# =========================================
-test_8_dispatch_auto() {
-  run_cmd $KCLI dispatch run --auto --project-path "$SANDBOX"
-  local output="$LOG_CMD_OUTPUT"
-  # Should scan backlog and attempt to dispatch remaining tasks
-  assert_contains "dispatch auto" "$output" "backlog\|scan\|dispatch\|TASK_\|no.*task\|0 " || return 1
-  return 0
-}
-
 # =========================================
 # Test 9: task delete -> verify
 # =========================================
@@ -412,19 +356,12 @@ test_11_dry_run() {
   output="$LOG_CMD_OUTPUT"
   assert_contains "delete dry-run" "$output" "dry-run\|dry.run\|dryRun" || return 1
 
-  # 4. dispatch run --dry-run
-  log "  --- dry-run: dispatch run ---"
-  run_cmd $KCLI dispatch run "$tb" --project-path "$SANDBOX" --dry-run
-  output="$LOG_CMD_OUTPUT"
-  assert_contains "dispatch dry-run" "$output" "dry-run\|dry.run\|dryRun" || return 1
-
-  # 5. specialist run --dry-run
   log "  --- dry-run: specialist run ---"
   run_cmd $KCLI specialist run --agent Amelia "test" --project-path "$SANDBOX" --dry-run
   output="$LOG_CMD_OUTPUT"
   assert_contains "specialist dry-run" "$output" "dry-run\|dry.run\|dryRun" || return 1
 
-  # 6. project install --dry-run
+  # 4. project install --dry-run
   log "  --- dry-run: project install ---"
   run_cmd $KCLI project install k-cli --project-path "$SANDBOX" --dry-run
   output="$LOG_CMD_OUTPUT"
@@ -441,9 +378,6 @@ run_test 2  "ping"                   test_2_ping
 run_test 3  "project status"         test_3_project_status
 run_test 4  "specialist list"        test_4_specialist_list
 run_test 5  "task create x3"         test_5_task_create
-run_test 6  "dispatch run"           test_6_dispatch_run
-run_test 7  "dispatch status"        test_7_dispatch_status
-run_test 8  "dispatch run --auto"    test_8_dispatch_auto
 run_test 9  "task delete"            test_9_task_delete
 run_test 10 "specialist run Amelia"  test_10_specialist_run
 run_test 11 "--dry-run"              test_11_dry_run

package/core/plugins/kenaz/commands/Amelia.md

@@ -2,4 +2,4 @@ Execute `node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .specialist/tools/se
 
 IMPORTANT: Run this command **foreground** (not background) with timeout=120000. Do NOT use background mode + sleep polling — session.js completes in <5s under normal conditions.
 
-Fallback (if session.js fails): Read `.specialist/Amelia/rule.yaml`, load files listed in `files:` by `override_priority` order.
+Fallback (if session.js fails): Read `${CLAUDE_PLUGIN_ROOT}/../../.specialist/Amelia/rule.yaml`, load files listed in `files:` by `override_priority` order.

package/core/plugins/kenaz/commands/Ansuz.md

@@ -12,16 +12,29 @@ ARGUMENTS 含 `[專案: X]` 或 `--project-path X` → PROJECT_PATH = X，下方
 
 ## 每件工作的做法
 - **自己做**：小而明確的修正（約 30 行內、單一檔案或少數檔案）→ 直接改，跑最近的測試，提交。
-- **開卡派工**：中型、可平行、或高風險路徑的工作 → `task-api.js create` 寫清楚驗收條件，再派 subagent（細節讀 `.specialist/Ansuz/RULES.md` 的 Dispatch）。
+- **開卡派工**：中型、可平行、或高風險路徑的工作：
+  1. 用 `kenaz_task_create` 開卡（`projectPath` = 目前專案；寫清楚 requirements、acceptance criteria、scope paths）。查卡、改狀態用 `kenaz_task_list` / `kenaz_task_get` / `kenaz_task_update`。
+  2. 產生派工內容：`node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .formation/tools/dispatch.js --skill=do --task=TASK_XXX --dispatch-mode=subagent`（加 `--project-path`；Codex 加 `--harness=codex`）。把輸出 JSON 的 `promptText` 交給 subagent，`agentParams` 照用（模型不要自己換）。
+  3. subagent 在 worktree 裡改完並 commit；你驗證後合併。
 - 開卡前先確認 scope 與驗收條件對準真正的問題，不要照著錯的假設派工。
 
 ## 驗證（合併前一定做，強度跟風險相稱）
 - 走**真實路徑**：實際執行會被使用者用到的那條路（真的安裝、真的啟動、真的收發訊息），不只看單元測試。
 - 有**對照組**：證明測試在舊程式上會失敗，或修改前後結果不同。
 - subagent 回報「未驗證」的項目，由你補驗或明講仍未驗證。
-- 合併用 `.specialist/Ansuz/tools/verify-and-land.js` 或 `git merge` 後跑相關測試；Rust 測試只走 `npm run test:rust` / `dev/scripts/rust-verify-worktree.js`。
+- 合併：`git merge` 後跑相關測試（或 `node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .specialist/Ansuz/tools/verify-and-land.js`），用這個專案自己的測試指令。
+- 檔案長度：verify-and-land 合併前會跑 `check-file-size`（警告 1000 / 上限 2000 行，既有超長檔只擋「未配套拆分的增長」）；被擋就按職責拆成 module / component / hook。
+- 只在 Kenaz 核心 repo 本身：Rust 測試走 `npm run test:rust` / `dev/scripts/rust-verify-worktree.js`。
 
 ## 回報
 用用戶的語言。說清楚：做了什麼、怎麼驗證的、還有什麼沒驗證或需要用戶決定。不說「應該可以」。
 
-需要更多規則時（用戶授權自主、派工前、合併前）讀 `.specialist/Ansuz/RULES.md`。
+## Kenaz 本身出問題時：先回報再繞過（wish / field report）
+Kenaz 的工具、hook、安裝、peer 訊息、派工擋住或拖慢工作時（指令失敗、回傳錯的資料、少了能力、行為不如預期），**繞過之前**先呼叫 `kenaz_wish_create`。scope=kenaz 的 wish 會自動送到 Kenaz 團隊成為 field report。
+- `projectPath`：目前專案路徑；`scope`：`kenaz`（Kenaz 本身的問題）或 `project`（只跟這個專案有關）
+- `wish_type`：`bug`（壞了）／`feature`（缺能力，內容寫：需求、現在哪裡不夠、建議做法、還有誰受益）／`question`
+- `content`：一行重現步驟 + 預期 vs 實際 + 版本（`npx kenaz doctor` 那幾行）；附上 session id。不要貼金鑰或 token。
+- 一個問題只報一次；報完照常用替代做法把工作完成，並在回報裡告訴用戶已送出 wish。
+- 用戶直接說「回報這個問題」時也用同一個工具（`source`=`user`）。
+
+需要更多規則時（用戶授權自主、派工前、合併前）讀 `${CLAUDE_PLUGIN_ROOT}/../../.specialist/Ansuz/RULES.md`。

package/core/plugins/kenaz/scripts/kenaz-mode.js

@@ -26,7 +26,17 @@ if (MODES.includes(arg)) {
   // TASK_2367: first-run guide. Optional steps are offered, never forced; the user (or the
   // assistant relaying this output) runs them. Backend probe tells whether they can work now.
   const port = process.env.KENAZ_HTTP_PORT || process.env.KENAZ_BACKEND_PORT || '18080';
-  fetch('http://127.0.0.1:' + port + '/api/health', { signal: AbortSignal.timeout(2000) })
+  // TASK_2395: register the project in ~/.kenaz/projects.json (idempotent, written by the server's
+  // single registry writer) so peer routing by to_project finds it. Server down = skipped; the
+  // first turn of a session retries.
+  const registered = fetch('http://127.0.0.1:' + port + '/api/projects/register', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ projectPath: dir }),
+    signal: AbortSignal.timeout(2000),
+  }).then((r) => r.json(), () => null).then((j) => !!(j && j.success), () => false);
+  registered
+    .then(() => fetch('http://127.0.0.1:' + port + '/api/health', { signal: AbortSignal.timeout(2000) }))
     .then((r) => r.ok, () => false)
     .then((up) => {
       // Codex runs shell commands in a sandbox without network (it sets CODEX_SANDBOX_NETWORK_DISABLED=1),

package/core/plugins/kenaz/scripts/sync.js

@@ -19,11 +19,15 @@ const SKILLS = [
 const COMMANDS = ['Amelia', 'Ansuz', 'architect', 'incident', 'review', 'security', 'spec', 'strategy', '產品', '設計', '評估'];
 
 // Core-relative references become plugin-relative / core-resolved.
+// In a user's project (npm install) the core lives in ~/.kenaz/core, not the project folder, so a
+// command's `node .specialist/...` / `.formation/...` / `.collaboration/...` runs through core-resolve,
+// and a core doc it tells the model to read gets a path under the plugin's core (plugin root/../..).
 function rewrite(text) {
   return text
     .replace(/\.claude\/skills\//g, '${CLAUDE_PLUGIN_ROOT}/skills/')
-    .replace(/node \.specialist\/tools\/(session|ansuz-boot-fast)\.js/g,
-      'node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .specialist/tools/$1.js');
+    .replace(/node \.(specialist|formation|collaboration)\/([\w./-]+\.js)/g,
+      'node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .$1/$2')
+    .replace(/`\.specialist\/([\w./-]+\.(?:md|yaml))`/g, '`${CLAUDE_PLUGIN_ROOT}/../../.specialist/$1`');
 }
 
 function copyDir(src, dst) {

package/core/plugins/kenaz/scripts/ygg.js

@@ -77,6 +77,7 @@ function renderStatus(s) {
   const L = [
     'Yggdrasil room:   ' + s.room,
     'Node name:        ' + s.node_name,
+    ...(s.registered ? ['Registered:       ' + s.registered] : []),
     'Key:              ' + s.key + ' (source: ' + s.key_source + ')',
     'Collaboration:    ' + (s.enabled && s.active_in_project ? 'active in this project'
       : 'not active in this project - run "ygg join <key>" (adds room "' + s.room + '" to collaboration_projects; presence is only sent for activated rooms)'),
@@ -92,13 +93,24 @@ function renderStatus(s) {
   return L.join('\n');
 }
 
+// The poller and presence only know projects in ~/.kenaz/projects.json. A server-only machine has
+// no Dashboard to register them, so before 0.3.4 a joined project never showed up in its room, with
+// no error anywhere (field report). Registering is idempotent; status says when it had to.
+async function ensureRegistered(dir) {
+  try {
+    const r = await call('POST', '/api/projects/register', { projectPath: dir });
+    return r && r.success ? (r.created ? 'registered now (it was missing: this machine could not be seen in the room or get mail for it)' : 'yes') : 'NO: ' + ((r && r.error) || 'unknown');
+  } catch (e) { return 'NO: ' + e.message + ' (kenaz-server too old? run npx kenaz@latest install)'; }
+}
+
 async function status(dir) {
+  const registered = await ensureRegistered(dir);
   const cfg = await getConfig(dir);
   if (cfg.error) throw new Error(cfg.error);
   const relay = await relayNodes(cfg);
   let peer = null;
   try { peer = await call('GET', '/api/peer/status?projectPath=' + encodeURIComponent(dir)); } catch (e) { /* unknown */ }
-  return buildStatus(cfg, relay, peer);
+  return Object.assign(buildStatus(cfg, relay, peer), { registered });
 }
 
 function withCollab(cfg, on) {

package/core/plugins/kenaz/skills/product_manager/SKILL.md

@@ -381,7 +381,7 @@ Scope 路徑: ✓ 合理
 
 ```bash
 # 使用 Task API 建立任務
-node .collaboration/core/task-api.js create --title "任務名稱" --priority P1
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js create --title "任務名稱" --priority P1
 
 # 或直接建立 YAML 文件到 .collaboration/tasks/backlog/
 ```
@@ -390,7 +390,7 @@ node .collaboration/core/task-api.js create --title "任務名稱" --priority P1
 
 ```bash
 # 驗證任務文件格式
-node .collaboration/core/task-api.js list
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js list
 
 # 檢查必填欄位
 # id, title, description, priority, status, role, tags, source, acceptance_criteria
@@ -415,7 +415,7 @@ node .collaboration/core/task-api.js list
 ls .collaboration/tasks/backlog/TASK_113_*.yaml
 
 # 使用 Task API 驗證
-node .collaboration/core/task-api.js list
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js list
 
 # 檢查必填欄位
 # id, title, description, priority, status, role, tags, source, acceptance_criteria
@@ -457,7 +457,7 @@ node .collaboration/core/task-api.js list
 **驗證任務**（必須執行）:
 ```bash
 # 使用 Task API 驗證（新系統）
-node .collaboration/core/task-api.js list
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js list
 ```
 
 #### 8.4 批量更新 PROGRESS.md
@@ -688,7 +688,7 @@ metadata:
 
 ```bash
 # 使用 Task API 建立任務（新系統）
-node .collaboration/core/task-api.js create --title "任務名稱" --priority P1
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js create --title "任務名稱" --priority P1
 
 # 或直接建立 YAML 文件到 .collaboration/tasks/backlog/
 ```
@@ -766,9 +766,9 @@ node .collaboration/core/task-api.js create --title "任務名稱" --priority P1
 
 ```bash
 # 使用 Task API 建立任務
-node .collaboration/core/task-api.js create --title "實作撤銷機制" --priority P1
-node .collaboration/core/task-api.js create --title "新增 Undo/Redo UI" --priority P2
-node .collaboration/core/task-api.js create --title "整合快捷鍵" --priority P2
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js create --title "實作撤銷機制" --priority P1
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js create --title "新增 Undo/Redo UI" --priority P2
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js create --title "整合快捷鍵" --priority P2
 ```
 
 **Stage 8: Pipeline Integration**
@@ -1055,16 +1055,16 @@ Dev Agent 會按照優先級執行這些任務。
 
 ```bash
 # 列出所有任務
-node .collaboration/core/task-api.js list
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js list
 
 # 建立新任務
-node .collaboration/core/task-api.js create --title "新功能" --priority P1
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js create --title "新功能" --priority P1
 
 # 認領任務
-node .collaboration/core/task-api.js claim TASK_XXX
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js claim TASK_XXX
 
 # 完成任務
-node .collaboration/core/task-api.js complete TASK_XXX
+node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .collaboration/core/task-api.js complete TASK_XXX
 ```
 
 **詳細文檔**：`.collaboration/README.md`

package/core/plugins/kenaz/skills/ui-ux-pro-max/data/charts.csv

@@ -1,26 +1,26 @@
-No,Data Type,Keywords,Best Chart Type,Secondary Options,Color Guidance,Performance Impact,Accessibility Notes,Library Recommendation,Interactive Level
-1,Trend Over Time,"trend, time-series, line, growth, timeline, progress",Line Chart,"Area Chart, Smooth Area",Primary: #0080FF. Multiple series: use distinct colors. Fill: 20% opacity,⚡ Excellent (optimized),✓ Clear line patterns for colorblind users. Add pattern overlays.,"Chart.js, Recharts, ApexCharts",Hover + Zoom
-2,Compare Categories,"compare, categories, bar, comparison, ranking",Bar Chart (Horizontal or Vertical),"Column Chart, Grouped Bar",Each bar: distinct color. Category: grouped same color. Sorted: descending order,⚡ Excellent,✓ Easy to compare. Add value labels on bars for clarity.,"Chart.js, Recharts, D3.js",Hover + Sort
-3,Part-to-Whole,"part-to-whole, pie, donut, percentage, proportion, share",Pie Chart or Donut,"Stacked Bar, Treemap",Colors: 5-6 max. Contrasting palette. Large slices first. Use labels.,⚡ Good (limit 6 slices),⚠ Hard for accessibility. Better: Stacked bar with legend. Avoid pie if >5 items.,"Chart.js, Recharts, D3.js",Hover + Drill
-4,Correlation/Distribution,"correlation, distribution, scatter, relationship, pattern",Scatter Plot or Bubble Chart,"Heat Map, Matrix",Color axis: gradient (blue-red). Size: relative. Opacity: 0.6-0.8 to show density,⚠ Moderate (many points),⚠ Provide data table alternative. Use pattern + color distinction.,"D3.js, Plotly, Recharts",Hover + Brush
-5,Heatmap/Intensity,"heatmap, heat-map, intensity, density, matrix",Heat Map or Choropleth,"Grid Heat Map, Bubble Heat",Gradient: Cool (blue) to Hot (red). Scale: clear legend. Divergent for ±data,⚡ Excellent (color CSS),⚠ Colorblind: Use pattern overlay. Provide numerical legend.,"D3.js, Plotly, ApexCharts",Hover + Zoom
-6,Geographic Data,"geographic, map, location, region, geo, spatial","Choropleth Map, Bubble Map",Geographic Heat Map,Regional: single color gradient or categorized colors. Legend: clear scale,⚠ Moderate (rendering),⚠ Include text labels for regions. Provide data table alternative.,"D3.js, Mapbox, Leaflet",Pan + Zoom + Drill
-7,Funnel/Flow,funnel/flow,"Funnel Chart, Sankey",Waterfall (for flows),Stages: gradient (starting color → ending color). Show conversion %,⚡ Good,✓ Clear stage labels + percentages. Good for accessibility if labeled.,"D3.js, Recharts, Custom SVG",Hover + Drill
-8,Performance vs Target,performance-vs-target,Gauge Chart or Bullet Chart,"Dial, Thermometer",Performance: Red→Yellow→Green gradient. Target: marker line. Threshold colors,⚡ Good,✓ Add numerical value + percentage label beside gauge.,"D3.js, ApexCharts, Custom SVG",Hover
-9,Time-Series Forecast,time-series-forecast,Line with Confidence Band,Ribbon Chart,Actual: solid line #0080FF. Forecast: dashed #FF9500. Band: light shading,⚡ Good,✓ Clearly distinguish actual vs forecast. Add legend.,"Chart.js, ApexCharts, Plotly",Hover + Toggle
-10,Anomaly Detection,anomaly-detection,Line Chart with Highlights,Scatter with Alert,Normal: blue #0080FF. Anomaly: red #FF0000 circle/square marker + alert,⚡ Good,✓ Circle/marker for anomalies. Add text alert annotation.,"D3.js, Plotly, ApexCharts",Hover + Alert
-11,Hierarchical/Nested Data,hierarchical/nested-data,Treemap,"Sunburst, Nested Donut, Icicle",Parent: distinct hues. Children: lighter shades. White borders 2-3px.,⚠ Moderate,⚠ Poor - provide table alternative. Label large areas.,"D3.js, Recharts, ApexCharts",Hover + Drilldown
-12,Flow/Process Data,flow/process-data,Sankey Diagram,"Alluvial, Chord Diagram",Gradient from source to target. Opacity 0.4-0.6 for flows.,⚠ Moderate,⚠ Poor - provide flow table alternative.,"D3.js (d3-sankey), Plotly",Hover + Drilldown
-13,Cumulative Changes,cumulative-changes,Waterfall Chart,"Stacked Bar, Cascade",Increases: #4CAF50. Decreases: #F44336. Start: #2196F3. End: #0D47A1.,⚡ Good,✓ Good - clear directional colors with labels.,"ApexCharts, Highcharts, Plotly",Hover
-14,Multi-Variable Comparison,multi-variable-comparison,Radar/Spider Chart,"Parallel Coordinates, Grouped Bar",Single: #0080FF 20% fill. Multiple: distinct colors per dataset.,⚡ Good,⚠ Moderate - limit 5-8 axes. Add data table.,"Chart.js, Recharts, ApexCharts",Hover + Toggle
-15,Stock/Trading OHLC,stock/trading-ohlc,Candlestick Chart,"OHLC Bar, Heikin-Ashi",Bullish: #26A69A. Bearish: #EF5350. Volume: 40% opacity below.,⚡ Good,⚠ Moderate - provide OHLC data table.,"Lightweight Charts (TradingView), ApexCharts",Real-time + Hover + Zoom
-16,Relationship/Connection Data,relationship/connection-data,Network Graph,"Hierarchical Tree, Adjacency Matrix",Node types: categorical colors. Edges: #90A4AE 60% opacity.,❌ Poor (500+ nodes struggles),❌ Very Poor - provide adjacency list alternative.,"D3.js (d3-force), Vis.js, Cytoscape.js",Drilldown + Hover + Drag
-17,Distribution/Statistical,distribution/statistical,Box Plot,"Violin Plot, Beeswarm",Box: #BBDEFB. Border: #1976D2. Median: #D32F2F. Outliers: #F44336.,⚡ Excellent,"✓ Good - include stats table (min, Q1, median, Q3, max).","Plotly, D3.js, Chart.js (plugin)",Hover
-18,Performance vs Target (Compact),performance-vs-target-(compact),Bullet Chart,"Gauge, Progress Bar","Ranges: #FFCDD2, #FFF9C4, #C8E6C9. Performance: #1976D2. Target: black 3px.",⚡ Excellent,✓ Excellent - compact with clear values.,"D3.js, Plotly, Custom SVG",Hover
-19,Proportional/Percentage,proportional/percentage,Waffle Chart,"Pictogram, Stacked Bar 100%",10x10 grid. 3-5 categories max. 2-3px spacing between squares.,⚡ Good,✓ Good - better than pie for accessibility.,"D3.js, React-Waffle, Custom CSS Grid",Hover
-20,Hierarchical Proportional,hierarchical-proportional,Sunburst Chart,"Treemap, Icicle, Circle Packing",Center to outer: darker to lighter. 15-20% lighter per level.,⚠ Moderate,⚠ Poor - provide hierarchy table alternative.,"D3.js (d3-hierarchy), Recharts, ApexCharts",Drilldown + Hover
-21,Root Cause Analysis,"root cause, decomposition, tree, hierarchy, drill-down, ai-split",Decomposition Tree,"Decision Tree, Flow Chart",Nodes: #2563EB (Primary) vs #EF4444 (Negative impact). Connectors: Neutral grey.,⚠ Moderate (calculation heavy),✓ clear hierarchy. Allow keyboard navigation for nodes.,"Power BI (native), React-Flow, Custom D3.js",Drill + Expand
-22,3D Spatial Data,"3d, spatial, immersive, terrain, molecular, volumetric",3D Scatter/Surface Plot,"Volumetric Rendering, Point Cloud",Depth cues: lighting/shading. Z-axis: color gradient (cool to warm).,❌ Heavy (WebGL required),❌ Poor - requires alternative 2D view or data table.,"Three.js, Deck.gl, Plotly 3D",Rotate + Zoom + VR
-23,Real-Time Streaming,"streaming, real-time, ticker, live, velocity, pulse",Streaming Area Chart,"Ticker Tape, Moving Gauge",Current: Bright Pulse (#00FF00). History: Fading opacity. Grid: Dark.,⚡ Optimized (canvas/webgl),⚠ Flashing elements - provide pause button. High contrast.,Smoothed D3.js, CanvasJS
-24,Sentiment/Emotion,"sentiment, emotion, nlp, opinion, feeling",Word Cloud with Sentiment,"Sentiment Arc, Radar Chart",Positive: #22C55E. Negative: #EF4444. Neutral: #94A3B8. Size = Frequency.,⚡ Good,⚠ Word clouds poor for screen readers. Use list view.,"D3-cloud, Highcharts, Nivo",Hover + Filter
-25,Process Mining,"process, mining, variants, path, bottleneck, log",Process Map / Graph,"Directed Acyclic Graph (DAG), Petri Net",Happy path: #10B981 (Thick). Deviations: #F59E0B (Thin). Bottlenecks: #EF4444.,⚠ Moderate to Heavy,⚠ Complex graphs hard to navigate. Provide path summary.,"React-Flow, Cytoscape.js, Recharts",Drag + Node-Click
+No,Data Type,Keywords,Best Chart Type,Secondary Options,Color Guidance,Performance Impact,Accessibility Notes,Library Recommendation,Interactive Level
+1,Trend Over Time,"trend, time-series, line, growth, timeline, progress",Line Chart,"Area Chart, Smooth Area",Primary: #0080FF. Multiple series: use distinct colors. Fill: 20% opacity,⚡ Excellent (optimized),✓ Clear line patterns for colorblind users. Add pattern overlays.,"Chart.js, Recharts, ApexCharts",Hover + Zoom
+2,Compare Categories,"compare, categories, bar, comparison, ranking",Bar Chart (Horizontal or Vertical),"Column Chart, Grouped Bar",Each bar: distinct color. Category: grouped same color. Sorted: descending order,⚡ Excellent,✓ Easy to compare. Add value labels on bars for clarity.,"Chart.js, Recharts, D3.js",Hover + Sort
+3,Part-to-Whole,"part-to-whole, pie, donut, percentage, proportion, share",Pie Chart or Donut,"Stacked Bar, Treemap",Colors: 5-6 max. Contrasting palette. Large slices first. Use labels.,⚡ Good (limit 6 slices),⚠ Hard for accessibility. Better: Stacked bar with legend. Avoid pie if >5 items.,"Chart.js, Recharts, D3.js",Hover + Drill
+4,Correlation/Distribution,"correlation, distribution, scatter, relationship, pattern",Scatter Plot or Bubble Chart,"Heat Map, Matrix",Color axis: gradient (blue-red). Size: relative. Opacity: 0.6-0.8 to show density,⚠ Moderate (many points),⚠ Provide data table alternative. Use pattern + color distinction.,"D3.js, Plotly, Recharts",Hover + Brush
+5,Heatmap/Intensity,"heatmap, heat-map, intensity, density, matrix",Heat Map or Choropleth,"Grid Heat Map, Bubble Heat",Gradient: Cool (blue) to Hot (red). Scale: clear legend. Divergent for ±data,⚡ Excellent (color CSS),⚠ Colorblind: Use pattern overlay. Provide numerical legend.,"D3.js, Plotly, ApexCharts",Hover + Zoom
+6,Geographic Data,"geographic, map, location, region, geo, spatial","Choropleth Map, Bubble Map",Geographic Heat Map,Regional: single color gradient or categorized colors. Legend: clear scale,⚠ Moderate (rendering),⚠ Include text labels for regions. Provide data table alternative.,"D3.js, Mapbox, Leaflet",Pan + Zoom + Drill
+7,Funnel/Flow,funnel/flow,"Funnel Chart, Sankey",Waterfall (for flows),Stages: gradient (starting color → ending color). Show conversion %,⚡ Good,✓ Clear stage labels + percentages. Good for accessibility if labeled.,"D3.js, Recharts, Custom SVG",Hover + Drill
+8,Performance vs Target,performance-vs-target,Gauge Chart or Bullet Chart,"Dial, Thermometer",Performance: Red→Yellow→Green gradient. Target: marker line. Threshold colors,⚡ Good,✓ Add numerical value + percentage label beside gauge.,"D3.js, ApexCharts, Custom SVG",Hover
+9,Time-Series Forecast,time-series-forecast,Line with Confidence Band,Ribbon Chart,Actual: solid line #0080FF. Forecast: dashed #FF9500. Band: light shading,⚡ Good,✓ Clearly distinguish actual vs forecast. Add legend.,"Chart.js, ApexCharts, Plotly",Hover + Toggle
+10,Anomaly Detection,anomaly-detection,Line Chart with Highlights,Scatter with Alert,Normal: blue #0080FF. Anomaly: red #FF0000 circle/square marker + alert,⚡ Good,✓ Circle/marker for anomalies. Add text alert annotation.,"D3.js, Plotly, ApexCharts",Hover + Alert
+11,Hierarchical/Nested Data,hierarchical/nested-data,Treemap,"Sunburst, Nested Donut, Icicle",Parent: distinct hues. Children: lighter shades. White borders 2-3px.,⚠ Moderate,⚠ Poor - provide table alternative. Label large areas.,"D3.js, Recharts, ApexCharts",Hover + Drilldown
+12,Flow/Process Data,flow/process-data,Sankey Diagram,"Alluvial, Chord Diagram",Gradient from source to target. Opacity 0.4-0.6 for flows.,⚠ Moderate,⚠ Poor - provide flow table alternative.,"D3.js (d3-sankey), Plotly",Hover + Drilldown
+13,Cumulative Changes,cumulative-changes,Waterfall Chart,"Stacked Bar, Cascade",Increases: #4CAF50. Decreases: #F44336. Start: #2196F3. End: #0D47A1.,⚡ Good,✓ Good - clear directional colors with labels.,"ApexCharts, Highcharts, Plotly",Hover
+14,Multi-Variable Comparison,multi-variable-comparison,Radar/Spider Chart,"Parallel Coordinates, Grouped Bar",Single: #0080FF 20% fill. Multiple: distinct colors per dataset.,⚡ Good,⚠ Moderate - limit 5-8 axes. Add data table.,"Chart.js, Recharts, ApexCharts",Hover + Toggle
+15,Stock/Trading OHLC,stock/trading-ohlc,Candlestick Chart,"OHLC Bar, Heikin-Ashi",Bullish: #26A69A. Bearish: #EF5350. Volume: 40% opacity below.,⚡ Good,⚠ Moderate - provide OHLC data table.,"Lightweight Charts (TradingView), ApexCharts",Real-time + Hover + Zoom
+16,Relationship/Connection Data,relationship/connection-data,Network Graph,"Hierarchical Tree, Adjacency Matrix",Node types: categorical colors. Edges: #90A4AE 60% opacity.,❌ Poor (500+ nodes struggles),❌ Very Poor - provide adjacency list alternative.,"D3.js (d3-force), Vis.js, Cytoscape.js",Drilldown + Hover + Drag
+17,Distribution/Statistical,distribution/statistical,Box Plot,"Violin Plot, Beeswarm",Box: #BBDEFB. Border: #1976D2. Median: #D32F2F. Outliers: #F44336.,⚡ Excellent,"✓ Good - include stats table (min, Q1, median, Q3, max).","Plotly, D3.js, Chart.js (plugin)",Hover
+18,Performance vs Target (Compact),performance-vs-target-(compact),Bullet Chart,"Gauge, Progress Bar","Ranges: #FFCDD2, #FFF9C4, #C8E6C9. Performance: #1976D2. Target: black 3px.",⚡ Excellent,✓ Excellent - compact with clear values.,"D3.js, Plotly, Custom SVG",Hover
+19,Proportional/Percentage,proportional/percentage,Waffle Chart,"Pictogram, Stacked Bar 100%",10x10 grid. 3-5 categories max. 2-3px spacing between squares.,⚡ Good,✓ Good - better than pie for accessibility.,"D3.js, React-Waffle, Custom CSS Grid",Hover
+20,Hierarchical Proportional,hierarchical-proportional,Sunburst Chart,"Treemap, Icicle, Circle Packing",Center to outer: darker to lighter. 15-20% lighter per level.,⚠ Moderate,⚠ Poor - provide hierarchy table alternative.,"D3.js (d3-hierarchy), Recharts, ApexCharts",Drilldown + Hover
+21,Root Cause Analysis,"root cause, decomposition, tree, hierarchy, drill-down, ai-split",Decomposition Tree,"Decision Tree, Flow Chart",Nodes: #2563EB (Primary) vs #EF4444 (Negative impact). Connectors: Neutral grey.,⚠ Moderate (calculation heavy),✓ clear hierarchy. Allow keyboard navigation for nodes.,"Power BI (native), React-Flow, Custom D3.js",Drill + Expand
+22,3D Spatial Data,"3d, spatial, immersive, terrain, molecular, volumetric",3D Scatter/Surface Plot,"Volumetric Rendering, Point Cloud",Depth cues: lighting/shading. Z-axis: color gradient (cool to warm).,❌ Heavy (WebGL required),❌ Poor - requires alternative 2D view or data table.,"Three.js, Deck.gl, Plotly 3D",Rotate + Zoom + VR
+23,Real-Time Streaming,"streaming, real-time, ticker, live, velocity, pulse",Streaming Area Chart,"Ticker Tape, Moving Gauge",Current: Bright Pulse (#00FF00). History: Fading opacity. Grid: Dark.,⚡ Optimized (canvas/webgl),⚠ Flashing elements - provide pause button. High contrast.,Smoothed D3.js, CanvasJS
+24,Sentiment/Emotion,"sentiment, emotion, nlp, opinion, feeling",Word Cloud with Sentiment,"Sentiment Arc, Radar Chart",Positive: #22C55E. Negative: #EF4444. Neutral: #94A3B8. Size = Frequency.,⚡ Good,⚠ Word clouds poor for screen readers. Use list view.,"D3-cloud, Highcharts, Nivo",Hover + Filter
+25,Process Mining,"process, mining, variants, path, bottleneck, log",Process Map / Graph,"Directed Acyclic Graph (DAG), Petri Net",Happy path: #10B981 (Thick). Deviations: #F59E0B (Thin). Bottlenecks: #EF4444.,⚠ Moderate to Heavy,⚠ Complex graphs hard to navigate. Provide path summary.,"React-Flow, Cytoscape.js, Recharts",Drag + Node-Click