kenaz 0.3.22 → 0.3.24

package/core/dev/pipeline/plans/PLAN_task_cli_refactor.md

@@ -1,281 +0,0 @@
-# Refactoring Plan: task-cli.js
-
-**Target File**: `.collaboration/cli/task-cli.js`
-**Lines**: 447
-**Objective**: Split into read-friendly modules with clean directory structure
-
----
-
-## 1. Current State Analysis
-
-### File Structure
-```
-task-cli.js (447 lines)
-├── Imports (3 lines)
-├── TaskCLI Class (419 lines)
-│   ├── constructor()
-│   ├── showHelp()          - 60 lines
-│   ├── createTask()        - 35 lines
-│   ├── listTasks()         - 37 lines
-│   ├── getTask()           - 58 lines
-│   ├── claimTask()         - 18 lines
-│   ├── assignTask()        - 26 lines
-│   ├── completeTask()      - 18 lines
-│   ├── lockTask()          - 21 lines
-│   ├── unlockTask()        - 23 lines
-│   ├── rebuildIndex()      - 15 lines
-│   └── run()               - 25 lines (command router)
-└── CLI Entry Point (20 lines)
-```
-
-### Issues
-1. **Monolithic design** - All 10 commands in single file
-2. **Mixed concerns** - Argument parsing + business logic + output formatting interleaved
-3. **Hard to test** - Cannot unit test individual commands
-4. **Hard to extend** - Adding new command requires modifying main file
-5. **Duplicate patterns** - Error handling and git user lookup repeated
-
----
-
-## 2. Proposed Directory Structure
-
-```
-.collaboration/cli/
-├── task-cli.js              # Entry point (~30 lines)
-├── commands/                # Command handlers
-│   ├── index.js            # Command registry
-│   ├── create.js           # create command
-│   ├── list.js             # list command
-│   ├── get.js              # get command
-│   ├── claim.js            # claim command
-│   ├── assign.js           # assign command
-│   ├── complete.js         # complete command
-│   ├── lock.js             # lock command
-│   ├── unlock.js           # unlock command
-│   └── rebuild.js          # rebuild command
-├── utils/                   # Shared utilities
-│   ├── arg-parser.js       # Argument parsing helpers
-│   ├── git-user.js         # Git user detection
-│   └── output.js           # Console output helpers (success, error, info)
-├── formatters/              # Output formatters
-│   ├── task-formatter.js   # Format task for display
-│   └── help-formatter.js   # Help text generation
-└── config/
-    └── commands.js          # Command metadata (name, description, options)
-```
-
----
-
-## 3. Module Breakdown
-
-### Entry Point: `task-cli.js` (~30 lines)
-```javascript
-#!/usr/bin/env node
-const { CommandRegistry } = require('./commands');
-const { showHelp } = require('./formatters/help-formatter');
-
-async function main() {
-  const args = process.argv.slice(2);
-  if (args.length === 0 || args.includes('--help')) {
-    showHelp();
-    return 0;
-  }
-  const [command, ...commandArgs] = args;
-  return CommandRegistry.execute(command, commandArgs);
-}
-
-main().then(process.exit).catch(err => {
-  console.error(`Error: ${err.message}`);
-  process.exit(1);
-});
-```
-
-### Command Registry: `commands/index.js` (~40 lines)
-```javascript
-const commands = {
-  create: require('./create'),
-  list: require('./list'),
-  get: require('./get'),
-  claim: require('./claim'),
-  assign: require('./assign'),
-  complete: require('./complete'),
-  lock: require('./lock'),
-  unlock: require('./unlock'),
-  rebuild: require('./rebuild'),
-};
-
-module.exports = {
-  CommandRegistry: {
-    execute: async (name, args) => {
-      const cmd = commands[name];
-      if (!cmd) throw new Error(`Unknown command: ${name}`);
-      return cmd.execute(args);
-    },
-    list: () => Object.keys(commands),
-  }
-};
-```
-
-### Example Command: `commands/create.js` (~40 lines)
-```javascript
-const { TaskAPI } = require('../../core/task-api.js');
-const { parseArgs } = require('../utils/arg-parser');
-const { success, error } = require('../utils/output');
-
-module.exports = {
-  name: 'create',
-  description: 'Create a new task',
-  options: ['--title', '--description', '--priority'],
-
-  async execute(args) {
-    const { title, description, priority = 'P2' } = parseArgs(args, ['title', 'description', 'priority']);
-
-    if (!title) {
-      error('Missing --title parameter');
-      return 1;
-    }
-
-    const api = new TaskAPI();
-    const task = await api.createTask({ title, description, priority });
-
-    success(`Task created: ${task.id}`);
-    console.log(`Title: ${task.title}`);
-    console.log(`Priority: ${task.priority}`);
-    return 0;
-  }
-};
-```
-
-### Utils: `utils/arg-parser.js` (~25 lines)
-```javascript
-function parseArgs(args, keys) {
-  const result = {};
-  keys.forEach(key => {
-    const index = args.indexOf(`--${key}`);
-    if (index >= 0 && args[index + 1]) {
-      result[key] = args[index + 1];
-    }
-  });
-  return result;
-}
-
-function getPositional(args, index = 0) {
-  return args.filter(a => !a.startsWith('--'))[index];
-}
-
-module.exports = { parseArgs, getPositional };
-```
-
-### Utils: `utils/git-user.js` (~15 lines)
-```javascript
-const { execSync } = require('child_process');
-
-function getGitUser() {
-  try {
-    return execSync('git config user.email', { encoding: 'utf8' })
-      .trim()
-      .split('@')[0];
-  } catch {
-    return 'unknown';
-  }
-}
-
-module.exports = { getGitUser };
-```
-
-### Utils: `utils/output.js` (~20 lines)
-```javascript
-module.exports = {
-  success: (msg) => console.log(`\u2705 ${msg}`),
-  error: (msg) => console.error(`\u274c ${msg}`),
-  warn: (msg) => console.log(`\u26a0\ufe0f  ${msg}`),
-  info: (msg) => console.log(msg),
-};
-```
-
----
-
-## 4. Migration Steps
-
-### Phase 1: Create Infrastructure
-1. Create directory structure (`commands/`, `utils/`, `formatters/`, `config/`)
-2. Create `utils/arg-parser.js`
-3. Create `utils/git-user.js`
-4. Create `utils/output.js`
-
-### Phase 2: Extract Commands
-5. Create `commands/create.js`
-6. Create `commands/list.js`
-7. Create `commands/get.js`
-8. Create `commands/claim.js`
-9. Create `commands/assign.js`
-10. Create `commands/complete.js`
-11. Create `commands/lock.js`
-12. Create `commands/unlock.js`
-13. Create `commands/rebuild.js`
-14. Create `commands/index.js` (registry)
-
-### Phase 3: Create Formatters
-15. Create `formatters/task-formatter.js`
-16. Create `formatters/help-formatter.js`
-
-### Phase 4: Refactor Entry Point
-17. Simplify `task-cli.js` to use new modules
-18. Remove old monolithic code
-
-### Phase 5: Testing
-19. Manual test all commands
-20. Verify backward compatibility
-
----
-
-## 5. Testing Strategy
-
-### Manual Test Checklist
-```bash
-# Test all commands work after refactoring
-node .collaboration/cli/task-cli.js --help
-node .collaboration/cli/task-cli.js create --title "Test" --priority P1
-node .collaboration/cli/task-cli.js list
-node .collaboration/cli/task-cli.js list --status pending
-node .collaboration/cli/task-cli.js get TASK_XXX
-node .collaboration/cli/task-cli.js claim TASK_XXX
-node .collaboration/cli/task-cli.js assign TASK_XXX --to testuser
-node .collaboration/cli/task-cli.js complete TASK_XXX
-node .collaboration/cli/task-cli.js lock TASK_XXX
-node .collaboration/cli/task-cli.js unlock TASK_XXX
-node .collaboration/cli/task-cli.js rebuild
-```
-
-### Backward Compatibility
-- All existing command syntax must work unchanged
-- Exit codes must remain consistent (0 = success, 1 = error)
-- Output format should remain similar
-
----
-
-## 6. Expected Outcome
-
-| Metric | Before | After |
-|--------|--------|-------|
-| Main file lines | 447 | ~30 |
-| Max file size | 447 | ~60 |
-| Number of files | 1 | 14 |
-| Testability | Low | High |
-| Adding new command | Modify main | Add new file |
-
----
-
-## 7. Risks and Mitigations
-
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-| Require paths break | CLI fails | Test require paths carefully |
-| Missing export | Command not found | Registry validates on load |
-| Behavior change | User confusion | Follow test checklist |
-
----
-
-**Status**: Awaiting Approval
-
-*Plan created by Architect Agent | 2026-02-14*

package/core/dev/pipeline/test_results/TASK_TEST_PARALLEL_002_result.txt

@@ -1,27 +0,0 @@
-TASK_TEST_PARALLEL_002 執行結果
-================================
-
-執行時間: 2026-02-11 18:35:00
-Team: developer
-Worker Session: developer_TASK_TEST_PARALLEL_002_2026-02-11_18-34-57-463
-
-測試目的:
-驗證並行處理檔案鎖機制
-
-執行結果:
-✅ 任務成功執行 - Team Worker 正常啟動
-✅ 日誌記錄完整 - 記錄到執行日誌目錄
-✅ 無錯誤發生 - 執行流程順暢
-
-驗收標準:
-- AC-002-1: ✅ 任務成功執行
-- AC-002-2: ✅ 日誌記錄完整
-- AC-002-3: ✅ 無錯誤發生
-
-測試結論:
-並行處理檔案鎖機制運作正常。developer team 可以透過 run-team.js
-成功啟動 Team Worker，並正確記錄執行日誌到專案內。符合 GEN-007
-專案自包含原則。
-
-執行時間: 約 2 分鐘
-實際複雜度: trivial（符合預期）

package/core/dev/plans/ANSUZ_SLIM_PLAN.md

@@ -1,68 +0,0 @@
-# Ansuz 精簡計畫（2026-10-10，草稿，待用戶確認）
-
-## 定位
-Ansuz 是 Kenaz 的 **orchestrator**：理解需求後，依情境決定自己動手，或拆成任務卡派給 subagent；合併前在真實路徑上驗證；最後回報。不是「只做規劃、不寫代碼」的 PM。
-
-要保留的核心是一套紀律，不是一套機制：
-1. 任務卡寫清楚驗收條件（中型以上的工作才開卡；小修正直接做）
-2. 合併前獨立驗證：走真實路徑、要有對照組、驗證強度跟風險相稱
-3. 沒驗證到的要明講，不說「應該可以」
-
-## 依據：近 14 天實際呼叫次數（從 transcript 統計真正的工具呼叫，不含 prompt 裡的提及）
-
-| 元件 | 呼叫 | 判斷 |
-|---|---|---|
-| task-api.js（任務卡） | 895 | 保留，放寬品質門檻 |
-| dispatch.js（派工） | 311 | 保留派工本身，砍掉大部分 prompt 組裝 |
-| verify-and-land.js（合併閘門） | 180 | 保留：這就是「驗證後才合併」的紀律 |
-| ansuz-boot-fast.js（開機） | 129 | 精簡成短 banner |
-| ansuz_handoff_snapshot（交接） | 54 | 凍結 |
-| phase-gate.js（3754 行） | 45 | 凍結 |
-| session.js prompt（身分 prompt） | 42 | 凍結（2026-10-07 已證明不改變行為） |
-| stream-lease.js（多 Ansuz 租約） | 12 | 凍結 |
-
-另外，本 session 實際抓到的 bug 全部來自「合併前在真實路徑驗證」，沒有一個來自 boot、phase-gate、handoff 或身分 prompt。
-
-## 保留（必要，協作也依賴）
-- 任務卡與 task-api；品質門檻（technical_notes ≥ 2、acceptance_criteria ≥ 3）改成警告，不再擋
-- verify-and-land.js
-- turn-context.js、ansuz-session-pin.js、kenaz-peer mod 的 Ansuz 標記：peer 訊息路由和推送依賴它們
-- dispatch.js 的 scope 檢查、worktree 建立、跨專案、`--harness=codex`
-
-## 精簡
-- **/Ansuz skill**：改寫成一份短 skill（約 40 行）：orchestrator 定位、何時自己做／何時派工、派工範本、驗證規則、回報格式
-- **派工 prompt**：從約 6,600 字縮成短範本，只留：任務卡內容、scope、worktree 與 commit 規則、驗收方式、回報格式。拿掉 Code Minimalism、File Budget、Known Failures（目前注入的內容多半不相關，例如 Rust 卡被塞 Python 3.14 的失敗模式）
-- **ansuz-boot-fast**：banner 只留 session id、待辦卡片、wishes、待收的 peer 訊息；拿掉 handoff 歸檔、Multi-Ansuz stream 清單、ANOMALY 區塊
-
-## 凍結（先停用，檔案保留兩週，約 2026-10-24 再決定刪除）
-- phase-gate.js、session.js 的身分 prompt 組裝
-- handoff：ansuz_handoff_snapshot 與 handoff-snapshot-on-commit / decision / question、handoff-staleness 四個 hook
-- 多 Ansuz 租約：stream-lease.js、lease-touch / lease-release / stream-delta hook
-- fatigue-check、context-check（提醒類 hook，先確認沒有其他依賴再停）
-- .specialist/Ansuz 下的身分檔：elixir.yaml、cognitive_principles.yaml、self_model_seed*、identity_contract.yaml 等；對應的 IDENT-001~007 規則移出索引
-
-## 順序（每步可獨立驗證、可回退）
-1. 改寫 /Ansuz skill，任務卡品質門檻改成警告（低風險）
-2. 派工 prompt 改成短範本；驗證：實際派一張卡，subagent 照常完成並經 verify-and-land 合併
-3. 停用 handoff / lease / phase-gate 相關 hook 與 boot 區塊；驗證：peer 推送與 pull 照常、boot banner 正常、hook 沒有報錯
-4. 兩週後依使用紀錄決定刪檔
-
-## 不在這次範圍
-- 任務池（Yggdrasil task pool）、peer 協作：維持不動
-- 記憶系統：已另案凍結（project_memory_system_frozen）
-
-## 步驟 3 實施紀錄（TASK_2392，2026-10-10）
-檔案全部保留在磁碟，只拿掉註冊／呼叫點；約 2026-10-24 再決定刪檔。
-
-**已取消註冊的 hook**
-- `.claude/settings.json`：Stop 的 `lease-release`；PostToolUse 的 `handoff-snapshot-on-commit`（Bash）、`handoff-snapshot-on-question`（AskUserQuestion）、`handoff-snapshot-on-decision`（synapse_inscribe）。
-- `plugins/kenaz/hooks/hooks.json` + `kenaz-hook.js` 對照表：`lease-release`、`snapshot-commit`、`snapshot-question`、`snapshot-decision`。
-- `.claude/hooks/_run-user-prompt.js` 的 DEFAULT_HOOKS：`handoff-staleness`、`fatigue-check`、`lease-touch`、`stream-delta`（保留 `daemon-outbox-hook`、`turn-context`、`task-bridge`）。
-- `.kenaz/claude-hooks-manifest.json`：三個 handoff-snapshot 移到 `retired`（否則 installer 會重新裝回去）。
-- `context-check` 本來就沒有註冊在任何地方，無需動作。
-
-**保留不動**：`turn-context.js`（`[session]` 行與 peer pull）、`ansuz-session-pin.js`、memory-guard、task-bridge、kenaz-peer。lease-touch 只是 pin 檔的讀取者，不是 peer 路由的提供者，停用後 peer 路由不受影響。
-
-**ansuz-boot-fast.js**：banner 只剩 `[session]` 行、pin 綁定行（有綁定時）、Wishes、Open cards、待收 peer 郵件（唯讀 `GET /api/peer/status`，只計數不讀內文）。移除呼叫點：handoff 歸檔與輸出、lease 註冊與 Multi-Ansuz 清單、HIGH_CANCEL_RATE／Cortex ANOMALY、任務計數行、field-report／heimdall／Huginn／knowledge 行（函式與匯出都還在）。
-
-**測試**：`task-1863-boot-lease-reuse`、`task-1977-banner-cap` 驗證的是已凍結的 boot 行為，已刪除；`task-2254` 的 boot 歸檔測試改成驗證「不再歸檔」；`ansuz-boot-fast.test.js` 新增 peer 郵件與 slim banner 子行程測試。

package/core/dev/plans/CLI_FIRST_INSTALL_FLOW.md

@@ -1,120 +0,0 @@
-# CLI-first 安裝與首次使用流程（TASK_2367 / TASK_2376）
-
-狀態：**待用戶審閱**（2026-10-11 改寫為中文並更新到現況）。
-目標流程：`npx kenaz install` 一次 → 在專案資料夾開 `claude` → `/kenaz init` → `/kenaz:Ansuz`。
-Yggdrasil 用 `kenaz ygg create` / `kenaz ygg join <key>`；Alaya 用 `kenaz alaya register`（機碼註冊，不需登入）。Dashboard 已退役。
-
-## 1. 組成與位置
-
-| 元件 | 是什麼 | 位置 |
-|---|---|---|
-| npm `kenaz` | CLI（install / uninstall / status / doctor / init / ygg / alaya / subagent / launch / stats / learn）＋打包好的 kenaz-core | `npx kenaz ...` |
-| `@kenazai/server-<os>-<cpu>` | kenaz-server 執行檔（無視窗後端：MCP + HTTP，只聽本機，port 18080，被占用時往後找） | 安裝後在 `~/.kenaz/bin/` |
-| kenaz-core | plugin、hooks、腳本、規則（plugin 與 server 都讀它） | 安裝後在 `~/.kenaz/core/` |
-| kenaz plugin | `/kenaz` 指令、`/kenaz:Ansuz` 與 hooks | `~/.kenaz/core/plugins/kenaz` |
-| 使用者層資料 | 服務啟動器、log、專案清單、憑證、教訓（`~/.kenaz/knowledge`） | `~/.kenaz/` |
-| 專案資料 | 任務、日誌、專案設定 | 每個專案的 `.kenaz/`，**解除安裝永遠不動** |
-
-## 2. 以服務方式執行的東西
-
-只有 `kenaz-server`：每個使用者一份（不需系統管理員、不是系統服務），登入時啟動，只聽本機。
-
-| 作業系統 | 方式 | 檔案 |
-|---|---|---|
-| Windows | 使用者層排程工作 `KenazServer`（登入時觸發，執行隱藏視窗的 `wscript.exe ~\.kenaz\kenaz-server.vbs`）。若 `schtasks /Create` 被拒（登入觸發可能需要管理員權限），改放「啟動」資料夾的 `KenazServer.vbs` 並立即啟動 | `~\.kenaz\kenaz-server.vbs` |
-| macOS | launchd 使用者代理 `ai.kenaz.server`（RunAtLoad + KeepAlive） | `~/Library/LaunchAgents/ai.kenaz.server.plist` |
-| Linux（有 systemd） | `systemd --user` 的 `kenaz-server.service`；無人登入的主機需 `loginctl enable-linger $USER` | `~/.config/systemd/user/kenaz-server.service` |
-| Linux（無 systemd：容器、WSL1、精簡主機）（TASK_2413） | crontab 加一行標記過的 `@reboot`（只取代自己那行，其他保留）並立即在背景啟動；連 crontab 都沒有時，立即啟動並印出要加進開機腳本的指令 | `~/.kenaz/kenaz-server.log` |
-
-`kenaz doctor` 會顯示目前的服務模式（systemd / launchd / windows task / startup launcher / cron / manual）。
-
-## 3. Plugin 登錄（Claude Code）
-
-在 `~/.claude/settings.json` 的 `env.CLAUDE_CODE_PLUGIN_DIRS` 加入 `~/.kenaz/core/plugins/kenaz`：
-- 只合併、不覆蓋；重複執行結果相同；路徑比對不分斜線方向與大小寫
-- 第一次修改前備份一份 `settings.json.bak-kenaz-peer`，寫入用暫存檔＋改名（不會寫一半）
-- JSON 格式壞掉時只回報、不動它
-- 前提：`claude --version` >= 2.1.287（太舊會跳過並提示 `claude update`）
-
-Codex：`setup-codex.js` 寫入 `~/.codex/config.toml` 的 MCP 設定、原生 hooks 與 `/prompts:kenaz`。升級時會把舊路徑、舊參數的 kenaz hooks 換成新的（TASK_2418），不動使用者自己的 hooks。
-
-## 4. 首次使用
-
-1. 在任何資料夾執行 `claude`（plugin 自動載入，不需 `--plugin-dir`）。
-2. `/kenaz init`：建立 `.kenaz/project.yaml`、確認後端有回應，並列出可選步驟（不強制）：
-   - 團隊協作：`kenaz ygg create`（自建房間金鑰並加入，把金鑰給隊友）或 `kenaz ygg join <key>`
-   - Alaya：`kenaz alaya register`（機碼註冊，立即可用）
-   - 下一步：`/kenaz:Ansuz`
-3. 後端沒回應時，init 會說明並指向 `npx kenaz install`。
-
-## 5. 升級與解除安裝
-
-- **自動更新**：kenaz-server 會從簽章過的 feed 自行更新（執行檔＋kenaz-core＋plugin），重新啟動後生效。
-- **手動升級**：`npx kenaz@latest install`。會先停掉「這個路徑」的舊 server（不會依名稱砍其他程序）、換新檔、**明確重啟服務**，再用 `/api/health` 確認跑的是新版本；版本不符會警告並印出重啟指令（TASK_2418）。
-- **解除安裝**：`npx kenaz uninstall` 只移除我們加的 plugin 項目、服務啟動器與 `~/.kenaz/core`、`~/.kenaz/bin`。**專案的 `.kenaz/` 與 `~/.kenaz` 的使用者資料保留**，settings 備份也保留。
-- `status` 顯示 plugin 登錄與服務狀態；任何指令加 `--dry-run` 只印計畫、不改東西。
-
-## 6. 驗收
-
-自動化（已完成）：installer、CLI、Codex hooks 的 node 測試只用暫存 home，不碰真實環境。
-
-**乾淨 Windows 環境實測（待用戶執行，等下一次發版後）**：
-1. 準備乾淨環境：Windows Sandbox（控制台 → 開啟或關閉 Windows 功能 → 勾「Windows 沙箱」→ 重開機），或新建一個本機 Windows 帳號。
-2. 在裡面安裝 Node.js（LTS）與 Claude Code，登入 Claude。
-3. `npx kenaz install`。預期：plugin 已登錄、排程工作或啟動資料夾啟動器、`http://127.0.0.1:18080/api/health` 有回應、最後的版本確認為 ok。
-4. 新建空資料夾 → `claude` → `/kenaz init` → `/kenaz:Ansuz`。預期：Ansuz 正常開機，不需 `--plugin-dir`。
-5. `npx kenaz doctor`：每列應為 ok 或 skip。
-6. `npx kenaz uninstall`。預期：plugin 已移除、服務啟動器已刪、測試資料夾的 `.kenaz` 仍在。
-7. 記下每一步卡住、看不懂、或需要額外動作的地方，回報給 Ansuz。
-
-## 7. 未決事項
-
-- macOS 與 Linux 的服務步驟目前只有單元測試，真機只有 Windows 實際跑過（field report 顯示 macOS 用戶已在使用，升級重啟問題已修，待下一版驗證）。
-- Windows 在沒有管理員權限時會走「啟動資料夾」路線；乾淨環境實測要確認實際走哪一條。
-- Codex 桌面版（managed daemon）目前無法即時推送 peer 訊息，改為下一次提問時拉取（TASK_2419，調查記錄見 `dev/specs/peer/CODEX_MANAGED_DAEMON.md`）。
-
-## 8. 已定案的決策（用戶，2026-10-09 起）
-
-- **發佈：npm**。`npx kenaz install`；各平台執行檔是選用的平台套件（`@kenazai/server-win32-x64`、`-darwin-arm64`、`-darwin-x64`、`-linux-x64`、`-linux-arm64`）。
-- **兩種 harness 都支援**：偵測到 Claude Code 就登錄 plugin，偵測到 Codex 就設定 MCP 與 hooks。
-- **平台**：Windows、macOS、Linux 首版就支援。
-- **Node.js 是前提**（兩種 harness 本來就需要）；installer 會檢查版本並說明怎麼裝。
-- **更新**：kenaz-server 自行更新，有簽章驗證。
-- **Codex 與 Claude Code 對等**：MCP 工具、Yggdrasil 指令、Ansuz 流程、Codex 原生 subagent 派工。
-- **發版**：等用戶說「發版」才發（緊急修正除外）。Windows 與 Linux 在本機建置，只有 macOS 在 GitHub Actions 建置以節省費用（流程見記憶 `reference_npm_cli_release`）。
-
-## 9. npm 套件結構（TASK_2377）
-
-- `packages/kenaz`：CLI＋打包的 kenaz-core（`prepack` 跑 `scripts/stage.js`，只收 git 追蹤的白名單檔案）。
-- `packages/server-*`：各平台執行檔；版本與 `dashboard/src-tauri/Cargo.toml` 同步。
-- install：檢查 Node 版本 → 複製 kenaz-core 到 `~/.kenaz/core`、執行檔到 `~/.kenaz/bin` → 記錄 `~/.kenaz/install.json` → Claude Code 與 Codex 各自設定 → 啟動並確認服務。
-- doctor：Node 版本、core 版本、server 執行檔、`/api/health`、服務模式、Claude plugin、Codex MCP 與 hooks；任何 FAIL 以代碼 1 結束。
-- 本機檢查：`npm pack` 後裝到暫存前綴，用 `--home <暫存目錄>` 執行（絕不用真實 home）。
-
-## 10. 從 Dashboard 遷移（TASK_2389 / TASK_2396）
-
-Dashboard（Tauri 桌面 app）已於 2026-10-11 從 repo 移除，kenaz-server 是唯一後端。已安裝的 Dashboard 可繼續用但不再更新。兩者都綁 port 18080，不能同時執行；CLI 只偵測並提示，不會替你結束 Dashboard。
-
-### 給使用者的步驟（可直接貼進公告）
-
-1. 在系統匣（右下角）對 Kenaz Dashboard 按右鍵，選「結束 / Quit」，確認程式完全關閉。
-2. 開啟 Dashboard 設定，關閉「開機時啟動」，避免登入後它又占回 port 18080。
-3. 在終端機執行：`npx kenaz install`
-4. 到專案資料夾執行 `claude`，再輸入 `/kenaz init`。
-5. 驗證：`npx kenaz doctor`，每一列應為 ok 或 skip。
-
-Dashboard 還在執行時，`npx kenaz install` 會印出上面的步驟並結束，不會啟動服務；只想先裝 plugin 與 core：加 `--keep-dashboard`。
-
-### 資料共用，不需搬移
-
-| 資料 | 位置 |
-|---|---|
-| 專案清單 | `~/.kenaz/projects.json` |
-| 憑證 / relay key / 各專案 Yggdrasil key | `~/.kenaz/credentials.yaml` |
-| 偏好設定 | `~/.kenaz/config.json` |
-| 任務、日誌 | `<專案>/.kenaz/` |
-| Peer 收件匣 | `peer_dir(project_root)/inbox.sqlite` |
-
-記憶系統（Synapse 等）已於 2026-10-11 移除（TASK_2411），舊的 `.synapse/` 與 `~/.kenaz/cortex/*.db` 留在磁碟上、不再使用；教訓改用 `kenaz learn`。
-
-Dashboard 各項行為的去向（哪些已搬進 kenaz-server、哪些刻意移除）記錄在 git 歷史中此檔 2026-10-11 之前的版本。