kenaz 0.3.7 → 0.3.8

package/core/KENAZ_CORE_VERSION

@@ -1 +1 @@
-0.3.7
+0.3.8

package/lib/cli.js

@@ -14,7 +14,7 @@ const dash = require('./dashboard');
 const PKG_ROOT = path.resolve(__dirname, '..');
 const PKG = require('../package.json');
 const MIN_NODE = 18;
-const USAGE = 'usage: kenaz <install|uninstall|status|doctor|init|ygg join <key>|ygg status|ygg leave> [--dry-run] [--home <dir>] [--no-service] [--no-claude] [--no-codex] [--keep-dashboard] [--server-bin <path>]';
+const USAGE = 'usage: kenaz <install|uninstall|status|doctor|init|ygg join <key>|ygg status|ygg leave|alaya status|alaya register> [--dry-run] [--home <dir>] [--no-service] [--no-claude] [--no-codex] [--keep-dashboard] [--server-bin <path>]';
 
 function parseArgs(argv) {
   const o = { cmd: argv[0], flags: {} };
@@ -279,7 +279,37 @@ function passthrough(argv, deps) {
   return r.status === null ? 1 : r.status;
 }
 
+// TASK_2406: `kenaz alaya status|register` talks to the local kenaz-server. Register needs no login:
+// the server registers by machine key (empty body).
+function httpJson(method, port, urlPath, body) {
+  return new Promise((resolve) => {
+    const data = body === undefined ? null : JSON.stringify(body);
+    const req = http.request({ host: '127.0.0.1', port, path: urlPath, method, timeout: 30000,
+      headers: data ? { 'content-type': 'application/json', 'content-length': Buffer.byteLength(data) } : {} }, (res) => {
+      let b = ''; res.on('data', (d) => { b += d; });
+      res.on('end', () => { let j = null; try { j = JSON.parse(b); } catch (_) { /* non-JSON */ } resolve({ status: res.statusCode, json: j, text: b }); });
+    });
+    req.on('timeout', () => { req.destroy(); resolve({ status: 0, text: 'timeout' }); });
+    req.on('error', (e) => resolve({ status: 0, text: `${e.code || e.message}` }));
+    if (data) req.write(data);
+    req.end();
+  });
+}
+
+async function alaya(argv, out = console.log) {
+  const sub = argv[1];
+  if (sub !== 'status' && sub !== 'register') { out('usage: kenaz alaya <status|register>'); return 2; }
+  const port = process.env.KENAZ_HTTP_PORT || '18080';
+  const r = sub === 'status' ? await httpJson('GET', port, '/api/rust/alaya/status') : await httpJson('POST', port, '/api/rust/alaya/register', {});
+  if (!r.status) { out(`kenaz-server not reachable on 127.0.0.1:${port} (${r.text}); run \`kenaz doctor\``); return 1; }
+  if (r.status >= 400) { out(`alaya ${sub} failed (HTTP ${r.status}): ${(r.json && r.json.error) || r.text}`); return 1; }
+  const j = r.json || {};
+  out(sub === 'status' ? `alaya: registered=${j.registered} outbox_depth=${j.outbox_depth}` : `alaya: registered (already_registered=${!!j.already_registered}); queued reports will drain`);
+  return 0;
+}
+
 function run(argv, out = console.log, deps = {}) {
+  if (argv[0] === 'alaya') return alaya(argv, out);
   if (argv[0] === 'ygg' || argv[0] === 'init') return passthrough(argv, deps);
   const { cmd, flags } = parseArgs(argv);
   const fn = { install, uninstall, status, doctor }[cmd];

package/lib/cli.test.js

@@ -58,6 +58,32 @@ test('kenaz ygg / init pass through to the core scripts with the remaining args'
   assert.deepStrictEqual(calls[1].slice(1), ['init']);
 });
 
+test('kenaz alaya register posts an empty body (machine-key path); status reads the registered flag', async () => {
+  const http = require('http');
+  const seen = [];
+  const srv = http.createServer((req, res) => {
+    let b = ''; req.on('data', (d) => { b += d; });
+    req.on('end', () => {
+      seen.push([req.method, req.url, b]);
+      res.setHeader('content-type', 'application/json');
+      res.end(req.url.endsWith('status') ? '{"registered":true,"outbox_depth":0}' : '{"registered":true,"already_registered":false}');
+    });
+  });
+  await new Promise((r) => srv.listen(0, '127.0.0.1', r));
+  const old = process.env.KENAZ_HTTP_PORT; process.env.KENAZ_HTTP_PORT = String(srv.address().port);
+  try {
+    const lines = [];
+    assert.strictEqual(await run(['alaya', 'register'], (l) => lines.push(l)), 0);
+    assert.strictEqual(await run(['alaya', 'status'], (l) => lines.push(l)), 0);
+    assert.deepStrictEqual(seen[0], ['POST', '/api/rust/alaya/register', '{}']);
+    assert.match(lines[1], /registered=true outbox_depth=0/);
+    assert.strictEqual(await run(['alaya', 'bogus'], () => {}), 2);
+  } finally {
+    if (old === undefined) delete process.env.KENAZ_HTTP_PORT; else process.env.KENAZ_HTTP_PORT = old;
+    srv.close();
+  }
+});
+
 test('reinstall stops only the kenaz-server running from the managed path (exact exe match, by PID)', () => {
   const { stopOwnServer } = require('./cli');
   const killed = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Install Kenaz (plugin, hooks, kenaz-server) for Claude Code and Codex: npx kenaz install",
   "bin": {
     "kenaz": "bin/kenaz.js"
@@ -20,11 +20,11 @@
     "test": "node --test lib/cli.test.js"
   },
   "optionalDependencies": {
-    "@kenazai/server-darwin-arm64": "0.3.7",
-    "@kenazai/server-darwin-x64": "0.3.7",
-    "@kenazai/server-linux-arm64": "0.3.7",
-    "@kenazai/server-linux-x64": "0.3.7",
-    "@kenazai/server-win32-x64": "0.3.7"
+    "@kenazai/server-darwin-arm64": "0.3.8",
+    "@kenazai/server-darwin-x64": "0.3.8",
+    "@kenazai/server-linux-arm64": "0.3.8",
+    "@kenazai/server-linux-x64": "0.3.8",
+    "@kenazai/server-win32-x64": "0.3.8"
   },
   "license": "UNLICENSED",
   "repository": {

package/core/k-cli/README.md

@@ -1,330 +0,0 @@
-# k-cli
-
-KenazAI 的獨立 CLI 工具 — 無需 Dashboard，直接操作 Specialist、Task、Dispatch、Project 等核心功能。
-
-## 快速開始
-
-```bash
-cd k-cli && npm install && npm run build
-
-# 1. 確認 CLI 可用
-k-cli ping
-
-# 2. 查看專案狀態
-k-cli project status
-
-# 3. 若尚未初始化（status 顯示 mode: unknown）→ 初始化（core-path 自動偵測）
-k-cli project initialize
-
-# 4. 查看使用指南（初始化時自動產生）
-cat k-cli.md
-```
-
-**建議流程**：`ping` → `status` → （未初始化則 `initialize`）→ 正常使用
-
-## 定位
-
-| 比較 | Dashboard MCP (Rust) | mcp-server (Node，已於 TASK_2027 移除) | **k-cli** |
-|------|---------------------|-------------------|-------------|
-| 運行方式 | HTTP server（需 Dashboard） | stdio MCP server | **獨立 CLI** |
-| 依賴 | Tauri app 運行中 | MCP client 呼叫 | **無依賴，直接執行** |
-| 用途 | Claude Code 透過 `.mcp.json` 使用 | 已移除（TASK_2027） | **人類 + 腳本直接操作** |
-
-## 核心價值
-
-- **零依賴**：不需要 Dashboard 運行，直接呼叫底層工具
-- **spawnClaude 架構**：寫入操作透過 `spawnClaude` 直接啟動 Claude CLI
-- **dry-run 支援**：所有寫入命令支援 `--dry-run`，驗證但不執行
-- **可腳本化**：所有輸出支援 `--json` 格式，方便 pipe 和自動化
-- **明確偵測**：不猜測、不 fallback、不向上找目錄，偵測失敗就是失敗
-
-## 設計原則
-
-```
-讀取操作 → 直接呼叫底層工具（快速、無副作用）
-寫入操作 → spawnClaude 啟動 Claude CLI（Specialist 執行 / Ansuz 決策）
-```
-
-| 操作類型 | 命令 | 執行方式 |
-|---------|------|---------|
-| 讀取 | specialist list, task list, task get, project status... | 直接呼叫 |
-| 寫入（任務） | task create | → spawnClaude + Ansuz（分析需求 → Amelia 審查 role → 建立） |
-| 刪除 | task delete | → 直接 rm 檔案 |
-| 執行 | specialist run | → spawnClaude + 指定 Specialist |
-
-## 命令一覽
-
-```
-k-cli <command> [subcommand] [options]
-```
-
-### Specialist 命令
-
-| 命令 | 說明 | 執行方式 |
-|------|------|---------|
-| `k-cli specialist list` | 列出所有 Specialist（名稱 + prompt） | 直接讀取 |
-| `k-cli specialist run` | 啟動 Specialist 執行任務 | spawnClaude |
-
-```bash
-# 列出所有 Specialist 和 prompt
-k-cli specialist list
-
-# 啟動 Ansuz（positional args 作為 user prompt）
-k-cli specialist run --agent Ansuz 幫我檢查 git 狀態
-
-# 啟動 Amelia 協調多 Agent
-k-cli specialist run --agent Amelia 執行 TASK_340
-
-# dry-run：顯示會做什麼，不實際啟動
-k-cli specialist run --agent Ansuz 分析需求 --dry-run
-```
-
-### Task 命令
-
-| 命令 | 說明 | 執行方式 |
-|------|------|---------|
-| `k-cli task list` | 列出任務 | 直接讀取 |
-| `k-cli task get <id>` | 取得任務詳情 | 直接讀取 |
-| `k-cli task create <描述>` | 建立新任務（自然語言，人類用） | → spawnClaude + Ansuz + Amelia |
-| `k-cli task submit --title ... ` | 建立新任務（結構化欄位，process/script 用，TASK_2147） | 直接呼叫 task-api.js，無 Claude 依賴 |
-| `k-cli task delete <id>` | 刪除任務 | → 直接 rm 檔案 |
-
-```bash
-# 讀取（直接）
-k-cli task list --status backlog
-k-cli task get TASK_340
-
-# 建立任務（語意描述 → Ansuz 分析 → Amelia 審查 role → 建立高品質任務）
-k-cli task create 幫我創建 hello_world.js 輸出 Hello World
-k-cli task create 實作登入 API 支援 OAuth2 --dry-run
-
-# 刪除（直接 rm 檔案，不限狀態）
-k-cli task delete TASK_340
-k-cli task delete TASK_340 --dry-run
-```
-
-#### task submit（TASK_2147：子專案 process 用，無 Claude 依賴）
-
-`task create` 的輕量版：不分析自然語言、不呼叫 Ansuz/Amelia，直接把旗標轉成
-`task-api.js create` 呼叫。給已經知道自己要建什麼卡的 process/script 用（例如子專案裡的
-in-app agent 把一個改良提案變成任務）。core 解析沿用 `resolveProject()`（讀
-`.kenaz/project.yaml`），呼叫端不需要設定 `KENAZ_SOURCE_DIR`。
-
-```bash
-k-cli task submit \
-  --title "標題" --description "描述" --priority P3 --role developer \
-  --requirements "r1" --requirements "r2" --requirements "r3" \
-  --acceptance-criteria "a1" --acceptance-criteria "a2" --acceptance-criteria "a3" \
-  --technical-notes "n1" --technical-notes "n2" \
-  --origin "my-sub-project-agent" \
-  --project-path /path/to/subproject --json
-```
-
-- 任務一律落在 `backlog/`（正常 triage），**不會 auto-dispatch**。
-- `--origin`（= `--source`）未指定時，預設為子專案名稱；用來標記任務來源方便追溯。
-- 品質門檻（requirements/acceptance_criteria ≥ 3、technical_notes ≥ 2）與 `task create` 相同，不放寬。
-- `--json` 會在建立後自動 `task get` 回完整任務 JSON（含 `id`/`source`/`status`），方便腳本直接讀回結果。
-- `--dry-run` 顯示會執行的 task-api.js 指令，不實際建立。
-
-#### task create 流程
-
-```
-k-cli task create "描述"
-  │
-  ├─ k-cli 預先組裝 Ansuz + Amelia prompts（並行）
-  │
-  └→ spawnClaude(Ansuz) [allowedTools 含 Agent]
-       ├─ Step 1: 分析需求（理解目標、搜尋相關代碼）
-       ├─ Step 2: 整理任務草稿（結構化所有欄位）
-       ├─ Step 3: Agent tool → Amelia subagent 審查 + 判斷 role
-       ├─ Step 4: 採納建議 → task-api.js create（含正確 role）
-       └─ Step 5: 輸出結果摘要
-```
-
-> Amelia 審查透過 Claude 原生 Agent tool（subagent）執行，避免 nested CLI spawn。
-
-### Dispatch 命令
-
-| 命令 | 說明 | 執行方式 |
-|------|------|---------|
-| `k-cli dispatch status <taskId>` | 查看 dispatch 狀態 | 直接讀取 |
-
-```bash
-# 查看狀態（自動搜尋 .kenaz/logs/ 或 .formation/logs/）
-k-cli dispatch status TASK_340 --tail 50
-```
-
-### Project 命令
-
-| 命令 | 說明 | 執行方式 |
-|------|------|---------|
-| `k-cli project status` | 專案總覽 | 直接讀取 |
-| `k-cli project initialize` | 初始化子專案 `.kenaz/` 結構 | 直接執行 |
-| `k-cli project install <target>` | 安裝/更新模板檔案 | 直接執行 |
-
-```bash
-# 專案總覽
-k-cli project status
-
-# 初始化新子專案（core-path 自動從 CLI 位置推導）
-k-cli project initialize --project-path /path/to/new-project
-
-# 手動指定 core-path（覆蓋自動偵測）
-k-cli project initialize --project-path /path/to/new-project --core-path /other/KenazAI
-
-# 初始化但不 git init
-k-cli project initialize --project-path /path/to/project --no-git
-
-# dry-run：顯示會建立什麼
-k-cli project initialize --project-path /path/to/project --dry-run
-```
-
-`project status` 輸出內容：
-
-| 區塊 | 來源 | 資料 |
-|------|------|------|
-| 專案設定 | `.kenaz/project.yaml` | project_name、schema_version、core_path、tasks dir、logs dir |
-| Git 狀態 | `git` | branch、最後 commit、dirty files 數量 |
-| 任務統計 | `task-api.js stats` | backlog / active / done / blocked 數量、P0/P1 高亮 |
-
-`project initialize` 建立內容：
-
-| 項目 | 說明 |
-|------|------|
-| `.kenaz/project.yaml` | 專案配置（schema_version、project_name、core_path、路徑正規化為 `/`） |
-| `.kenaz/tasks/{backlog,active,done,blocked,cancel}/` | 任務目錄 |
-| `.kenaz/logs/{unit,solo,squad,legion,misc,legacy}/` | Formation log 目錄 |
-| `.gitignore` | 標準 gitignore（預設啟用，`--no-git` 跳過） |
-| `.gitattributes` | 行尾正規化（預設啟用，`--no-git` 跳過） |
-| `k-cli.md` | 使用指南（可用 `project install k-cli` 更新） |
-| `git init --initial-branch=main` | Git 初始化 + aliases + initial commit |
-
-```bash
-# 安裝/更新模板到現有專案
-k-cli project install k-cli
-
-# dry-run
-k-cli project install k-cli --dry-run
-```
-
-### 通用命令
-
-| 命令 | 說明 |
-|------|------|
-| `k-cli ping` | 健康檢查（顯示專案名稱、模式、core_path） |
-
-## 全域選項
-
-| Flag | 說明 |
-|------|------|
-| `--dry-run` | 驗證但不執行（適用所有寫入 / 調度命令） |
-| `--json` | 輸出 JSON 格式 |
-| `--project-path <path>` | 指定子專案路徑（使用 `.kenaz/project.yaml` 中的 `project_path` 值） |
-| `--force` | 跳過品質檢查（僅 `task create`） |
-| `--no-git` | 初始化時跳過 Git（僅 `project initialize`） |
-| `--core-path <path>` | 覆蓋自動偵測的 core 路徑（僅 `project initialize`） |
-| `--help`, `-h` | 顯示幫助 |
-
-## 架構
-
-```
-k-cli/
-├── README.md              # 本文件
-├── package.json           # 依賴管理（deps: yaml）
-├── tsconfig.json          # TypeScript 配置
-├── src/                   # TypeScript 原始碼
-│   ├── index.ts           # 入口 + 命令路由 + flag 解析
-│   ├── core/              # 共用基礎設施
-│   │   ├── types.ts       # ProjectInfo、CliFlags 型別定義
-│   │   ├── project.ts     # 專案偵測（core / sub-project / unknown）
-│   │   ├── process.ts     # nodeProcess — 統一 process spawner
-│   │   ├── spawn.ts       # spawnClaude — Claude CLI 直接啟動器
-│   │   └── output.ts      # 輸出格式化（table / JSON）
-│   ├── specialist/        # Specialist 功能
-│   │   ├── list.ts        # 列出 Specialist + prompt（直接）
-│   │   └── run.ts         # 啟動 Specialist（spawnClaude）
-│   ├── task/              # 任務管理功能
-│   │   ├── list.ts        # task list（直接 task-api.js）
-│   │   ├── get.ts         # task get（直接 task-api.js）
-│   │   ├── create.ts      # task create（spawnClaude + Ansuz + Amelia）
-│   │   ├── submit.ts      # task submit（直接 task-api.js，無 Claude 依賴，TASK_2147）
-│   │   ├── update.ts      # task update（直接 task-api.js）
-│   │   └── delete.ts      # task delete（直接 task-api.js）
-│   ├── dispatch/          # Formation 調度功能
-│   │   └── status.ts      # dispatch status（直接讀 log）
-│   └── project/           # 專案管理功能
-│       ├── status.ts      # project status（含 project.yaml 詳情）
-│       ├── initialize.ts  # project initialize（建立 .kenaz/ + Git）
-│       └── install.ts     # project install（安裝/更新模板）
-├── templates/             # 可安裝的模板檔案
-│   └── k-cli.md           # k-cli 使用指南
-└── dist/                  # 編譯輸出（npm run build）
-```
-
-### 內部呼叫關係
-
-```
-k-cli
-  │
-  ├─ 直接呼叫（讀取）
-  │   ├─ specialist/list   → fs.readdir(.specialist/) + session.js
-  │   ├─ task/list, get    → .collaboration/core/task-api.js
-  │   ├─ task/delete       → 直接 rm YAML 檔案（不限狀態）
-  │   ├─ dispatch/status   → .kenaz/logs/ 或 .formation/logs/ + log-reader.js
-  │   └─ project/status    → .kenaz/project.yaml + task-api.js stats + git commands
-  │
-  ├─ spawnClaude（Ansuz 決策）
-  │   ├─ task/create       → Ansuz 分析需求
-  │   │                       → Agent tool subagent（Amelia 審查 + role）
-  │   │                       → task-api.js create（最終建立）
-  │
-  └─ spawnClaude（Specialist 直接執行）
-      └─ specialist/run    → session.js（組裝 prompt）+ spawnClaude
-```
-
-### spawnClaude 架構
-
-`core/spawn.ts` 是 k-cli 的核心，直接啟動 Claude CLI 子進程：
-
-```
-spawnClaude(opts)
-  ├─ detectClaudeCmd()      → 偵測 claude CLI 路徑（Windows: .cmd / .exe）
-  ├─ getClaudeEnv()         → 清理環境變數（刪除 CLAUDECODE 避免嵌套檢測）
-  │   └─ detectGitBash()    → Windows: 偵測 git-bash 路徑
-  └─ spawn(claude, args)    → stdin pipe prompt, stream-json 輸出
-```
-
-## Dry-Run 行為
-
-`--dry-run` 適用於所有有副作用的命令：
-
-| 命令 | dry-run 行為 |
-|------|-------------|
-| `specialist run` | 組裝 prompt → 顯示 agent + prompt 長度 → **不 spawn Claude** |
-| `task create` | 組裝 Ansuz prompt → 顯示將建立的任務資訊 → **不啟動 Ansuz** |
-| `task update` | 組裝 task-api args → 顯示將更新的內容 → **不呼叫 task-api** |
-| `task delete` | 組裝 task-api args → 顯示將刪除的任務 → **不呼叫 task-api** |
-
-## 專案偵測邏輯
-
-`resolveProject` 使用明確偵測，不猜測、不 fallback、不向上搜尋目錄：
-
-| 偵測條件 | 模式 | core_path |
-|---------|------|-----------|
-| 有 `.collaboration/tasks/` | `core` | 當前目錄 |
-| 有 `.kenaz/project.yaml`（無 `.collaboration/tasks/`） | `sub-project` | yaml 中的 `core_path` 欄位 |
-| 以上都沒有 | `unknown` | 當前目錄 |
-
-## 安裝 & 執行
-
-```bash
-# 編譯
-cd k-cli && npm install && npm run build
-
-# 執行
-node dist/index.js ping
-node dist/index.js project status
-
-# 建議建立 alias
-alias k-cli="node /path/to/KenazAI/k-cli/dist/index.js"
-```

package/core/k-cli/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "k-cli",
-  "version": "0.1.0",
-  "description": "KenazAI CLI tool — Specialist, Task, Dispatch operations",
-  "main": "dist/index.js",
-  "bin": {
-    "k-cli": "dist/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "test": "bash test/run.sh"
-  },
-  "dependencies": {
-    "yaml": "^2.7.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.9.3"
-  }
-}

package/core/k-cli/templates/k-cli.md

@@ -1,91 +0,0 @@
-# k-cli 使用指南
-
-本專案由 KenazAI k-cli 初始化管理。
-
-## 常用命令
-
-```bash
-# 健康檢查
-k-cli ping
-
-# 專案狀態
-k-cli project status
-
-# 任務管理（讀取）
-k-cli task list
-k-cli task list --status backlog
-k-cli task get TASK_XXX
-
-# 建立任務（Ansuz 分析 → Amelia subagent 審查 role → 建立）
-k-cli task create 幫我創建 hello_world.js 輸出 Hello World
-k-cli task create 實作登入 API 支援 OAuth2
-
-# 刪除任務（直接 rm，不限狀態）
-k-cli task delete TASK_XXX
-
-# Specialist（positional args 作為 user prompt）
-k-cli specialist list
-k-cli specialist run --agent Ansuz 幫我檢查 git 狀態
-k-cli specialist run --agent Amelia 執行 TASK_XXX
-
-# Dispatch — 指定任務（讀 role → 判斷陣型 → headless.js 執行）
-k-cli dispatch run TASK_XXX
-
-# Dispatch — 自動掃描（掃 backlog → 按優先級逐個 dispatch）
-k-cli dispatch run --auto
-
-# 查看 dispatch 狀態
-k-cli dispatch status TASK_XXX --tail 50
-
-# 專案初始化（新子專案）
-k-cli project initialize
-k-cli project initialize --project-path /path/to/project --no-git
-
-# 安裝/更新模板
-k-cli project install k-cli
-```
-
-## Dispatch 流程
-
-```
-k-cli dispatch run TASK_XXX
-  └→ Ansuz 讀 role → 判斷陣型 → headless.js
-       headless.js 自動處理：
-       ├─ auto-claim（backlog → active）
-       ├─ 依賴預檢
-       ├─ agent 執行任務
-       ├─ task complete
-       └─ post-complete（archive + git branch + merge to user branch）
-```
-
-Git merge 到 main 需要用戶手動操作。
-
-## Task Create 流程
-
-```
-k-cli task create "描述"
-  ├─ k-cli 預先組裝 Ansuz + Amelia prompts
-  └→ spawnClaude(Ansuz)
-       ├─ 分析需求 + 整理任務草稿
-       ├─ Agent tool → Amelia subagent 審查 + 判斷 role
-       └─ task-api.js create（建立任務）
-```
-
-Amelia 審查透過 Claude 原生 Agent tool（subagent）執行，無需嵌套 CLI。
-
-## 全域選項
-
-| Flag | 說明 |
-|------|------|
-| `--json` | JSON 輸出 |
-| `--dry-run` | 驗證但不執行 |
-| `--auto` | 自動掃描模式（僅 dispatch run） |
-| `--force` | 跳過品質檢查（僅 task create） |
-| `--project-path <path>` | 指定專案路徑（使用 `.kenaz/project.yaml` 中的 `project_path` 值） |
-| `--help` | 顯示幫助 |
-
-## 更新此文件
-
-```bash
-k-cli project install k-cli
-```

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

@@ -1,117 +0,0 @@
-# k-cli Test Specification
-
-## 概述
-
-Build 後在 `test/sandbox/` 建立真實專案環境，跑完所有 k-cli 功能。
-每次 `npm test` 自動：清空 sandbox → 初始化 → 逐項測試 → 報告結果。
-
-## 執行方式
-
-```bash
-cd k-cli
-npm run build && npm test
-```
-
-## 前置條件
-
-- Claude CLI 可用（`task create` 會 spawnClaude）
-- `npm run build` 必須先執行
-
-## 測試環境
-
-- **Sandbox**: `test/sandbox/`（每次測試前清空重建）
-- **Core Path**: KenazAI 本體（`k-cli/../`）
-- **路徑參數**: 使用 `.kenaz/project.yaml` 中的 `project_path`（絕對路徑）
-
-## 11 個測試
-
-### Test 1: project initialize → verify → delete k-cli.md → verify → install
-- `k-cli project initialize --project-path test/sandbox/ --no-git`
-- 驗證：`.kenaz/project.yaml` 存在、`tasks/` 5 個狀態目錄存在、`logs/` 6 個陣型目錄存在、`k-cli.md` 存在
-- 刪除 `test/sandbox/k-cli.md`
-- 驗證：`k-cli.md` 不存在
-- `k-cli project install k-cli --project-path test/sandbox/`
-- 驗證：`k-cli.md` 重新出現、內容含 `k-cli`
-
-### Test 2: ping
-- `k-cli ping --project-path test/sandbox/`
-- 驗證：輸出含 `k-cli` 且含 `sub-project`
-
-### Test 3: project status
-- `k-cli project status --project-path test/sandbox/ --json`
-- 驗證：JSON 解析成功、含 `sub-project`
-
-### Test 4: specialist list
-- `k-cli specialist list --project-path test/sandbox/`
-- 驗證：輸出含 `Ansuz` 且含 `Amelia`
-
-### Test 5: task create × 3 → list → get
-建立 3 個簡單任務，驗證 Ansuz + Amelia subagent 流程：
-
-1. `k-cli task create "寫一個 Node.js 程式，console.log 輸出 Hello World" --project-path test/sandbox/`
-   - 驗證：輸出含 TASK_ID（記為 TASK_A）
-2. `k-cli task create "寫一個 Node.js 程式，計算 10+10 並輸出結果" --project-path test/sandbox/`
-   - 驗證：輸出含 TASK_ID（記為 TASK_B）
-3. `k-cli task create "寫一個 Node.js 程式，讀取當前目錄的檔案列表並印出" --project-path test/sandbox/`
-   - 驗證：輸出含 TASK_ID（記為 TASK_C）
-
-流程驗證（每個 create 都會經過）：
-- spawnClaude(Ansuz) → 分析需求 → Agent tool subagent(Amelia) 審查 + 判斷 role → task-api.js create
-
-建立後驗證：
-- `k-cli task list --project-path test/sandbox/`
-- 驗證：輸出含 TASK_A、TASK_B、TASK_C，總數 ≥ 3
-- `k-cli task get TASK_A --project-path test/sandbox/`
-- 驗證：輸出含 TASK_A 詳細資訊
-
-### Test 6-8: 已移除
-- `dispatch run` 已刪除（Formation headless 調度已退役），`dispatch status` 失去可驗證的前置動作，一併移出測試
-
-### Test 9: task delete → verify
-- 使用 Test 5 的 TASK_A
-- `k-cli task get TASK_A` → 驗證任務存在
-- `k-cli task delete TASK_A --project-path test/sandbox/`（直接 rm，不限狀態）
-- `k-cli task list --project-path test/sandbox/`
-- 驗證：TASK_A 不在列表中
-
-### Test 10: specialist run Amelia（簡單任務）
-- `k-cli specialist run --agent Amelia 列出 sandbox 專案的任務狀態 --project-path test/sandbox/`
-- 驗證：spawnClaude(Amelia) 執行成功，輸出含任務相關資訊
-
-### Test 11: --dry-run（全指令驗證）
-不實際執行，僅驗證 dry-run 輸出正確：
-
-1. `k-cli project initialize --project-path test/sandbox/ --dry-run`
-   - 驗證：輸出含 `dry-run`
-2. `k-cli task create "測試 dry-run" --project-path test/sandbox/ --dry-run`
-   - 驗證：輸出含 `dry-run`，不呼叫 spawnClaude
-3. `k-cli task delete TASK_B --project-path test/sandbox/ --dry-run`
-   - 驗證：輸出含 `dry-run`，任務仍存在
-4. `k-cli specialist run --agent Amelia 測試 --project-path test/sandbox/ --dry-run`
-   - 驗證：輸出含 `dry-run`，不呼叫 spawnClaude
-5. `k-cli project install k-cli --project-path test/sandbox/ --dry-run`
-   - 驗證：輸出含 `dry-run`
-
-## 結果格式
-
-```
-k-cli Test Suite
-════════════════════════════════
-[ 1/11] project init+install   ✅ PASS
-[ 2/11] ping                  ✅ PASS
-[ 3/11] project status        ✅ PASS
-[ 4/11] specialist list       ✅ PASS
-[ 5/11] task create × 3       ✅ PASS
-[ 9/11] task delete             ✅ PASS
-[10/11] specialist run Amelia  ✅ PASS
-[11/11] --dry-run              ✅ PASS
-
-Result: 11/11 passed
-```
-
-失敗時顯示：
-```
-[ 5/11] task create × 3       ❌ FAIL
-  Expected output to contain "TASK_"
-  Got: "Error: ..."
-```

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

@@ -1,403 +0,0 @@
-#!/usr/bin/env bash
-# k-cli Test Runner
-# Usage: cd k-cli && bash test/run.sh
-
-set -uo pipefail
-
-# ─── Paths ───
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-KCLI_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
-CORE_DIR="$(cd "$KCLI_DIR/.." && pwd)"
-SANDBOX="$SCRIPT_DIR/sandbox"
-KCLI="node $KCLI_DIR/dist/index.js"
-
-# ─── Log ───
-LOG_FILE="$SCRIPT_DIR/test-report-$(date +%Y%m%d-%H%M%S).log"
-
-log() {
-  echo "$@" >> "$LOG_FILE"
-}
-
-log_separator() {
-  log ""
-  log "═══════════════════════════════════════════════════════════════"
-}
-
-# Run a k-cli command: log the command + full output, capture in LOG_CMD_OUTPUT
-run_cmd() {
-  local cmd_display="$*"
-  log "  ▶ $cmd_display"
-  LOG_CMD_OUTPUT=$("$@" 2>&1) || true
-  if [ -n "$LOG_CMD_OUTPUT" ]; then
-    echo "$LOG_CMD_OUTPUT" >> "$LOG_FILE"
-  else
-    log "    (no output)"
-  fi
-}
-
-# ─── State ───
-PASS=0
-FAIL=0
-TOTAL=11
-
-# ─── Helpers ───
-cleanup() {
-  rm -rf "$SANDBOX"
-  mkdir -p "$SANDBOX"
-}
-
-assert_contains() {
-  local label="$1" output="$2" expected="$3"
-  if echo "$output" | grep -qi "$expected"; then
-    log "  ✓ assert_contains($label): found \"$expected\""
-    return 0
-  else
-    log "  ✗ assert_contains($label): NOT found \"$expected\""
-    log "    Got: $(echo "$output" | head -3)"
-    echo "  Expected output to contain \"$expected\""
-    echo "  Got: $(echo "$output" | head -3)"
-    return 1
-  fi
-}
-
-assert_file_exists() {
-  local filepath="$1"
-  if [ -f "$filepath" ]; then
-    log "  ✓ file exists: $filepath"
-    return 0
-  else
-    log "  ✗ file NOT found: $filepath"
-    echo "  File not found: $filepath"
-    return 1
-  fi
-}
-
-assert_file_not_exists() {
-  local filepath="$1"
-  if [ ! -f "$filepath" ]; then
-    log "  ✓ file not exists (expected): $filepath"
-    return 0
-  else
-    log "  ✗ file should not exist: $filepath"
-    echo "  File should not exist: $filepath"
-    return 1
-  fi
-}
-
-run_test() {
-  local num="$1" name="$2"
-  shift 2
-  local label
-  label=$(printf "[%2d/%d] %s" "$num" "$TOTAL" "$name")
-  printf "[%2d/%d] %-24s " "$num" "$TOTAL" "$name"
-  log_separator
-  log "TEST $label"
-  log "  Started: $(date '+%Y-%m-%d %H:%M:%S')"
-  log ""
-  if "$@"; then
-    echo "PASS"
-    log ""
-    log "  ▸ Result: PASS"
-    PASS=$((PASS + 1))
-  else
-    echo "FAIL"
-    log ""
-    log "  ▸ Result: FAIL"
-    FAIL=$((FAIL + 1))
-  fi
-}
-
-# ─── Setup ───
-echo ""
-echo "k-cli Test Suite"
-echo "========================================"
-echo "Core:    $CORE_DIR"
-echo "k-cli:   $KCLI_DIR"
-echo "Sandbox: $SANDBOX"
-echo "Log:     $LOG_FILE"
-echo ""
-
-log "k-cli Test Report"
-log "Generated: $(date '+%Y-%m-%d %H:%M:%S')"
-log "Core:    $CORE_DIR"
-log "k-cli:   $KCLI_DIR"
-log "Sandbox: $SANDBOX"
-
-# Build before testing
-echo "Building k-cli..."
-(cd "$KCLI_DIR" && npm run build 2>&1) || {
-  echo "ERROR: Build failed."
-  exit 1
-}
-echo "Build OK"
-echo ""
-
-cleanup
-
-# =========================================
-# Test 1: project initialize + install
-# =========================================
-test_1_init_install() {
-  log "  --- Step: project initialize ---"
-  run_cmd $KCLI project initialize --project-path "$SANDBOX"
-  local output="$LOG_CMD_OUTPUT"
-
-  # Verify .kenaz/project.yaml
-  assert_file_exists "$SANDBOX/.kenaz/project.yaml" || return 1
-
-  # Verify task status dirs
-  for status in backlog active done blocked cancel; do
-    [ -d "$SANDBOX/.kenaz/tasks/$status" ] || { log "  ✗ .kenaz/tasks/$status/ not found"; echo "  .kenaz/tasks/$status/ not found"; return 1; }
-    log "  ✓ dir exists: .kenaz/tasks/$status/"
-  done
-
-  # Verify log formation dirs
-  for formation in unit solo squad legion misc legacy; do
-    [ -d "$SANDBOX/.kenaz/logs/$formation" ] || { log "  ✗ .kenaz/logs/$formation/ not found"; echo "  .kenaz/logs/$formation/ not found"; return 1; }
-    log "  ✓ dir exists: .kenaz/logs/$formation/"
-  done
-
-  # Verify k-cli.md was created
-  assert_file_exists "$SANDBOX/k-cli.md" || return 1
-
-  # Delete k-cli.md
-  log "  --- Step: delete k-cli.md ---"
-  rm -f "$SANDBOX/k-cli.md"
-  assert_file_not_exists "$SANDBOX/k-cli.md" || return 1
-
-  # Reinstall via project install
-  log "  --- Step: project install k-cli ---"
-  run_cmd $KCLI project install k-cli --project-path "$SANDBOX"
-  output="$LOG_CMD_OUTPUT"
-
-  # Verify k-cli.md restored
-  assert_file_exists "$SANDBOX/k-cli.md" || return 1
-
-  # Verify content
-  local content
-  content=$(cat "$SANDBOX/k-cli.md")
-  assert_contains "k-cli.md content" "$content" "k-cli" || return 1
-
-  return 0
-}
-
-# =========================================
-# Test 2: ping
-# =========================================
-test_2_ping() {
-  run_cmd $KCLI ping --project-path "$SANDBOX"
-  local output="$LOG_CMD_OUTPUT"
-  assert_contains "ping" "$output" "k-cli" || return 1
-  assert_contains "ping" "$output" "sub-project" || return 1
-  return 0
-}
-
-# =========================================
-# Test 3: project status
-# =========================================
-test_3_project_status() {
-  run_cmd $KCLI project status --project-path "$SANDBOX" --json
-  local output="$LOG_CMD_OUTPUT"
-
-  # Must be valid JSON
-  echo "$output" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{JSON.parse(d);process.exit(0)}catch(e){process.exit(1)}})" 2>/dev/null || {
-    log "  ✗ Output is not valid JSON"
-    echo "  Output is not valid JSON"
-    echo "  Got: $(echo "$output" | head -3)"
-    return 1
-  }
-  log "  ✓ valid JSON output"
-
-  assert_contains "status" "$output" "sub-project" || return 1
-  return 0
-}
-
-# =========================================
-# Test 4: specialist list
-# =========================================
-test_4_specialist_list() {
-  run_cmd $KCLI specialist list --project-path "$SANDBOX"
-  local output="$LOG_CMD_OUTPUT"
-  assert_contains "specialist" "$output" "Ansuz" || return 1
-  assert_contains "specialist" "$output" "Amelia" || return 1
-  return 0
-}
-
-# =========================================
-# Test 5: task create x3 -> list -> get
-# =========================================
-test_5_task_create() {
-  local task_id
-
-  # Task A: Hello World
-  log "  --- Step: task create A (Hello World) ---"
-  run_cmd $KCLI task create "write a Node.js script that console.log outputs Hello World" \
-    --project-path "$SANDBOX"
-  local output="$LOG_CMD_OUTPUT"
-  task_id=$(echo "$output" | grep -oE "TASK_[0-9]+" | head -1)
-  [ -n "$task_id" ] || { log "  ✗ Could not extract TASK_A ID"; echo "  Could not extract TASK_A ID"; return 1; }
-  echo "$task_id" > "$SANDBOX/.test_task_a"
-  log "  ✓ TASK_A = $task_id"
-
-  # Task B: 10+10
-  log "  --- Step: task create B (10+10) ---"
-  run_cmd $KCLI task create "write a Node.js script that calculates 10+10 and prints the result" \
-    --project-path "$SANDBOX"
-  output="$LOG_CMD_OUTPUT"
-  task_id=$(echo "$output" | grep -oE "TASK_[0-9]+" | head -1)
-  [ -n "$task_id" ] || { log "  ✗ Could not extract TASK_B ID"; echo "  Could not extract TASK_B ID"; return 1; }
-  echo "$task_id" > "$SANDBOX/.test_task_b"
-  log "  ✓ TASK_B = $task_id"
-
-  # Task C: list files
-  log "  --- Step: task create C (list files) ---"
-  run_cmd $KCLI task create "write a Node.js script that reads and prints the file list of current directory" \
-    --project-path "$SANDBOX"
-  output="$LOG_CMD_OUTPUT"
-  task_id=$(echo "$output" | grep -oE "TASK_[0-9]+" | head -1)
-  [ -n "$task_id" ] || { log "  ✗ Could not extract TASK_C ID"; echo "  Could not extract TASK_C ID"; return 1; }
-  echo "$task_id" > "$SANDBOX/.test_task_c"
-  log "  ✓ TASK_C = $task_id"
-
-  # Verify list contains all 3
-  log "  --- Step: task list ---"
-  run_cmd $KCLI task list --project-path "$SANDBOX"
-  local list_output="$LOG_CMD_OUTPUT"
-  local ta tb tc
-  ta=$(cat "$SANDBOX/.test_task_a")
-  tb=$(cat "$SANDBOX/.test_task_b")
-  tc=$(cat "$SANDBOX/.test_task_c")
-  assert_contains "list" "$list_output" "$ta" || return 1
-  assert_contains "list" "$list_output" "$tb" || return 1
-  assert_contains "list" "$list_output" "$tc" || return 1
-
-  # Verify get TASK_A
-  log "  --- Step: task get $ta ---"
-  run_cmd $KCLI task get "$ta" --project-path "$SANDBOX"
-  local get_output="$LOG_CMD_OUTPUT"
-  assert_contains "get" "$get_output" "$ta" || return 1
-
-  return 0
-}
-
-# =========================================
-# Test 9: task delete -> verify
-# =========================================
-test_9_task_delete() {
-  local task_id
-  task_id=$(cat "$SANDBOX/.test_task_a" 2>/dev/null) || { echo "  No TASK_A from test 5"; return 1; }
-  log "  Target: $task_id"
-
-  # Verify via get — task should exist
-  log "  --- Step: task get (before delete) ---"
-  run_cmd $KCLI task get "$task_id" --project-path "$SANDBOX"
-  local output="$LOG_CMD_OUTPUT"
-  assert_contains "get before delete" "$output" "$task_id" || return 1
-
-  # Delete (direct rm, no status restriction)
-  log "  --- Step: task delete ---"
-  run_cmd $KCLI task delete "$task_id" --project-path "$SANDBOX"
-  output="$LOG_CMD_OUTPUT"
-  assert_contains "delete output" "$output" "$task_id\|Deleted\|delet" || return 1
-
-  # Verify deleted: task should not appear in list
-  log "  --- Step: task list (after delete) ---"
-  run_cmd $KCLI task list --project-path "$SANDBOX"
-  local list_output="$LOG_CMD_OUTPUT"
-  if echo "$list_output" | grep -q "$task_id"; then
-    log "  ✗ Task $task_id still in list after delete"
-    echo "  Task $task_id still in list after delete"
-    return 1
-  fi
-  log "  ✓ Task $task_id no longer in list"
-  return 0
-}
-
-# =========================================
-# Test 10: specialist run Amelia
-# =========================================
-test_10_specialist_run() {
-  run_cmd $KCLI specialist run --agent Amelia "list task status in sandbox project" \
-    --project-path "$SANDBOX"
-  local output="$LOG_CMD_OUTPUT"
-
-  # Should produce some output (not empty)
-  [ -n "$output" ] || { log "  ✗ specialist run produced no output"; echo "  specialist run produced no output"; return 1; }
-  log "  ✓ specialist run produced output (${#output} chars)"
-  return 0
-}
-
-# =========================================
-# Test 11: --dry-run (all commands)
-# =========================================
-test_11_dry_run() {
-  local output
-
-  # 1. project initialize --dry-run (use fresh temp dir since sandbox is already initialized)
-  log "  --- dry-run: project initialize ---"
-  local dryrun_tmp="$SANDBOX/_dryrun_tmp"
-  mkdir -p "$dryrun_tmp"
-  run_cmd $KCLI project initialize --project-path "$dryrun_tmp" --dry-run
-  output="$LOG_CMD_OUTPUT"
-  rm -rf "$dryrun_tmp"
-  assert_contains "init dry-run" "$output" "dry-run\|dry.run\|dryRun" || return 1
-
-  # 2. task create --dry-run
-  log "  --- dry-run: task create ---"
-  run_cmd $KCLI task create "dry-run test" --project-path "$SANDBOX" --dry-run
-  output="$LOG_CMD_OUTPUT"
-  assert_contains "create dry-run" "$output" "dry-run\|dry.run\|dryRun" || return 1
-
-  # 3. task delete --dry-run
-  log "  --- dry-run: task delete ---"
-  local tb
-  tb=$(cat "$SANDBOX/.test_task_b" 2>/dev/null) || tb="TASK_999"
-  run_cmd $KCLI task delete "$tb" --project-path "$SANDBOX" --dry-run
-  output="$LOG_CMD_OUTPUT"
-  assert_contains "delete dry-run" "$output" "dry-run\|dry.run\|dryRun" || return 1
-
-  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
-
-  # 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"
-  assert_contains "install dry-run" "$output" "dry-run\|dry.run\|dryRun" || return 1
-
-  return 0
-}
-
-# =========================================
-# Run All Tests
-# =========================================
-run_test 1  "project init+install"   test_1_init_install
-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 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
-
-# =========================================
-# Summary
-# =========================================
-echo ""
-echo "========================================"
-echo "Result: $PASS/$TOTAL passed"
-echo "Log: $LOG_FILE"
-
-log_separator
-log "SUMMARY: $PASS/$TOTAL passed"
-log "Finished: $(date '+%Y-%m-%d %H:%M:%S')"
-
-if [ $FAIL -gt 0 ]; then
-  echo "WARNING: $FAIL test(s) failed"
-  exit 1
-else
-  echo "All tests passed"
-  exit 0
-fi