kenaz 0.3.18 → 0.3.20

package/core/.system/collaboration/README.md

@@ -7,8 +7,7 @@
 **設計理念**：
 - **目錄即狀態**：任務狀態由檔案所在目錄決定，無需在檔案中維護狀態欄位
 - **YAML 格式**：人類可讀，支援多行文字和結構化資料
-- **雙層 API**：task-api.js（完整功能）+ task-api-json.js（JSON 輸出供 Dashboard 使用）
-- **向後相容**：與舊 TASK_QUEUE.json 格式相容，支援平滑遷移
+- **單一 API**：task-api.js（完整功能 + CLI，`--format json` 輸出機器可讀 JSON）
 
 ---
 
@@ -18,8 +17,7 @@
 .collaboration/
 ├── core/                    # 核心 API
 │   ├── task-api.js          # 主 API（完整功能 + CLI）
-│   ├── task-api-json.js     # JSON 輸出包裝（供 Dashboard 使用）
-│   └── migrate-legacy.js    # 遷移工具（dev/pipeline → .collaboration）
+│   └── migrate-legacy.js    # 一次性遷移工具（dev/pipeline → tasks）
 ├── tasks/                   # 任務檔案（目錄即狀態）
 │   ├── backlog/             # 待處理任務 (status: pending)
 │   ├── active/              # 進行中任務 (status: in_progress)
@@ -191,69 +189,9 @@ node <core>/k-cli/dist/index.js task get TASK_XXX --project-path . --json
 
 ---
 
-### 2. task-api-json.js（JSON 輸出包裝）
+### 2. JSON 輸出
 
-**用途**：包裝 `task-api.js`，輸出純 JSON 格式（與舊版 TASK_QUEUE.json 相容），供 Tauri Dashboard 使用。
-
-**使用方式**：
-
-```bash
-# 輸出所有任務（JSON 格式）
-node .collaboration/core/task-api-json.js
-
-# 輸出單個任務
-node .collaboration/core/task-api-json.js --task TASK_194
-```
-
-**輸出格式**：
-
-```json
-{
-  "version": "3.3.0",
-  "tasks": [
-    {
-      "id": "TASK_194",
-      "hash": "357cd130-e843-4718-b858-7cc56bdae4e5",
-      "title": "系統文檔：.collaboration 新任務系統",
-      "status": "in_progress",
-      "priority": "P1",
-      "role": "developer",
-      "rigor": "medium",
-      "tags": ["docs"],
-      "complexity": "simple",
-      "estimated_hours": 0.3,
-      "dependencies": [],
-      "scope_paths": [".system/collaboration/"],
-      "requirements": ["閱讀核心 JS 檔案", "建立 README.md"],
-      "acceptance_criteria": ["README.md 涵蓋 API 使用方式"],
-      "created_by": {
-        "name": "{os_user}",
-        "git_user": "{git_user}",
-        "timestamp": "2026-02-18T15:07:00.995Z"
-      },
-      "_file_path": ".collaboration/tasks/active/TASK_194_{git_user}.yaml",
-      "_source": "collaboration"
-    }
-  ],
-  "statistics": {
-    "total": 124,
-    "pending": 2,
-    "in_progress": 1,
-    "completed": 108,
-    "blocked": 0,
-    "cancelled": 13
-  },
-  "metadata": {
-    "last_updated": "2026-02-18T15:30:00.000Z",
-    "directories": ["backlog", "active", "done", "cancel", "blocked", "archived"]
-  }
-}
-```
-
-**關鍵轉換**：
-- `role` 向後相容為 `agent_type`
-- 人員欄位 (`created_by`, `executed_by`) 轉為 `TaskPerson` 格式（匹配 Rust struct）
-- 陣列欄位確保為字串陣列（避免物件混入）
+需要機器可讀輸出時用 `node .collaboration/core/task-api.js list --format json`。
 
 ---
 
@@ -306,118 +244,19 @@ keywords: []
 
 ## 與舊系統的關係
 
-### 雙軌制說明
-
-專案同時維護兩套任務系統，處於**漸進式遷移**階段：
-
-| 系統 | 路徑 | ID 範圍 | 格式 | 狀態 | 適用場景 |
-|------|------|---------|------|------|---------|
-| **新系統（Collaboration）** | `.collaboration/tasks/{status}/` | TASK_151~196+ | 目錄 + YAML | ✅ 主力系統（推薦） | 手動協作、簡單流程 |
-| **舊系統（Pipeline）** | `dev/pipeline/TASK_QUEUE.json` + `completed/` | TASK_134~187 | JSON + YAML | ⚠️ 相容支援（逐步淘汰） | 排程器、Multi-Agent 並行開發 |
-
-**查詢任務時必須兩邊都查**：
-- 新系統：`node .collaboration/core/task-api.js get TASK_XXX`
-- 舊系統：`dev/pipeline/completed/TASK_XXX_*.yaml` 或 `dev/pipeline/TASK_QUEUE.json`
-
----
-
-### 詳細差異對照
-
-| 特性 | Pipeline System（舊） | Collaboration System（新） | 說明 |
-|------|---------------------|--------------------------|------|
-| **狀態管理** | JSON 索引集中式 | 目錄分散式 | 新系統移動檔案即改變狀態，簡化流程 |
-| **任務格式** | JSON 索引 + YAML 檔案 | 純 YAML（目錄即狀態） | 新系統無需在 YAML 中維護狀態欄位 |
-| **查詢介面** | Python API + JSON | Node.js CLI + JSON 輸出 | 新系統支援 `--help` 和過濾查詢 |
-| **路徑鎖定** | ✅ `lock_manager.py` | ❌ 無 | 舊系統支援並行開發衝突檢測 |
-| **依賴解析** | ✅ `dependency_resolver.py` | ⚠️ 基礎支援 | 舊系統有拓撲排序、循環檢測、關鍵路徑 |
-| **統計查詢** | ✅ 豐富（含關鍵路徑、依賴圖） | ⚠️ 基礎（僅數量統計） | 舊系統功能更完善 |
-| **排程器整合** | ✅ Single-Agent、Multi-Agent | ⚠️ Formation 有限支援 | 舊系統為排程器設計 |
-| **Dashboard 支援** | ✅ Tauri API 呼叫 | ✅ Tauri API 呼叫 | 兩者皆支援 JSON 輸出 |
-| **衝突避免** | ✅ `scope_paths` + 路徑鎖定 | ⚠️ `scope_paths` 欄位（無自動檢測） | 舊系統自動防衝突 |
-| **孤兒鎖定清理** | ✅ 自動清理 | ❌ 不適用 | 舊系統處理 Agent crash |
-| **驗證腳本** | ✅ `validate_pipeline.ps1` | ❌ 無 | 舊系統有一致性檢查 |
-| **複雜度** | ⚠️ 較高（需理解鎖定機制） | ✅ 較低（目錄即狀態） | 新系統更易上手 |
-| **適用場景** | 排程器、並行開發 | 手動協作、簡單流程 | 根據場景選擇系統 |
-
-**選擇建議**：
-- ✅ **使用新系統（Collaboration）**：手動協作、簡單任務流程、不需要並行開發
-- ✅ **使用舊系統（Pipeline）**：需要自動化排程器、Multi-Agent 並行開發、路徑衝突檢測
-
----
-
-### 遷移方向
-
-**目標**：逐步將 Pipeline 系統的功能整合到 Collaboration 系統，最終淘汰舊系統。
-
-**階段 1：雙軌制運行**（當前階段）
-- ✅ 兩套系統並存，保持相容
-- ✅ 新任務優先建立在 Collaboration 系統
-- ✅ Formation 系統已支援三層 fallback（新系統 → 舊 YAML → 舊 JSON）
-
-**階段 2：功能補齊**（計劃中）
-- [ ] 實現路徑鎖定機制（移植 `lock_manager.py` 到 Node.js）
-- [ ] 增強依賴解析（拓撲排序、循環檢測、關鍵路徑）
-- [ ] 建立驗證工具（`validate_collaboration.js`）
-- [ ] 統計查詢增強（依賴圖、執行時間預估）
-
-**階段 3：排程器遷移**（計劃中）
-- [ ] 更新 Single-Agent 排程器使用新系統
-- [ ] 更新 Multi-Agent 排程器使用新系統
-- [ ] 保留舊系統的 Python orchestrator 模組作為參考實現
-
-**階段 4：全面遷移**（計劃中）
-- [ ] 將 `dev/pipeline/TASK_QUEUE.json` 中的任務匯入新系統
-- [ ] 封存舊系統文件至 `.legacy/`
-- [ ] 更新 CLAUDE.md、規則文檔移除舊系統引用
-
-**遷移工具**：
-```bash
-# 匯出新系統任務為舊格式（供排程器使用）
-node .collaboration/core/migrate-legacy.js export
+`dev/pipeline/TASK_QUEUE.json` 的舊任務佇列已凍結，不再新增或更新。所有任務在 `.kenaz/tasks/{status}/`（YAML，目錄即狀態）；`.collaboration/tasks/` 只在 `.kenaz/tasks/` 不存在時作為 legacy fallback。查舊任務可參考 `dev/pipeline/` 的歷史檔案，新任務一律用 task-api。
 
-# 匯入舊系統任務到新系統（未來遷移用）
-node .collaboration/core/migrate-legacy.js import
-
-# 雙向同步（開發中）
-node .collaboration/core/migrate-legacy.js sync
-```
-
-**相關文檔**：
-- 舊系統文檔：`.system/pipeline/README.md`
-- 遷移腳本：`.collaboration/core/migrate-legacy.js`
-- Formation 整合：`.formation/tools/loader.js:180-220`
+`migrate-legacy.js` 為一次性遷移工具，僅供查閱歷史資料格式。
 
 ---
 
-## 整合與使用場景
-
-### 1. Formation 系統整合
-
-`.formation/tools/loader.js` 已更新為三層 fallback：
-1. 優先讀取新系統（`.collaboration/tasks/`）
-2. 降級讀取舊 YAML（`dev/pipeline/completed/`）
-3. 最終降級讀取舊 JSON（`dev/pipeline/TASK_QUEUE.json`）
-
-### 2. Dashboard 整合
-
-Tauri Dashboard 透過 Rust API 呼叫 `task-api-json.js`：
-```rust
-// dashboard/src-tauri/src/features/task/manager.rs
-pub async fn get_tasks() -> Result<TaskQueue, TaskError> {
-    let output = Command::new("node")
-        .args(&[".collaboration/core/task-api-json.js"])
-        .output()?;
-    let json = String::from_utf8(output.stdout)?;
-    serde_json::from_str(&json)
-}
-```
+## 使用場景
 
-### 3. Dev Agent 整合
+Ansuz 派工前先開卡（`create`），subagent 完成後 `complete`；任務卡的 scope_paths 供並行任務避免路徑衝突（無自動檢測，由派工者檢查）。
 
-Dev Agent 使用新系統查詢任務：
 ```bash
 # 列出待辦任務
-node .collaboration/core/task-api.js list --status pending --role developer
+node .collaboration/core/task-api.js list --status backlog --role developer
 
 # 認領任務
 node .collaboration/core/task-api.js claim TASK_194
@@ -554,16 +393,13 @@ async moveTask(taskId, newStatus) {
 - **Claim 保號**：共享模式下從 Pool 認領任務保留原編號；只有真正的本地檔案碰撞才重編號（碰撞時先比對 `hash` 欄位 — 相同代表同一張卡返家，原地更新不重編）。重編號從 lease 消耗（counter 在共享模式下只記錄最後消耗的 lease 編號，不是配號權威）。
 - **Relay 端**：`id_counters` 表以 `(team_id, project)` 隔離，單一 transaction 內原子配號。
 
-**相關實作**：`task-api.js generateTaskID()/_allocateFromRelay()`、`dashboard/src/app/api/tasks/move/route.ts`（claim 路徑）、`yggdrasil-relay/src/routes/tasks.rs allocate_ids`（端點文檔見 `yggdrasil-relay/DESIGN.md`）。
+**相關實作**：`task-api.js generateTaskID()/_allocateFromRelay()`、`yggdrasil-relay/src/routes/tasks.rs allocate_ids`（端點文檔見 `yggdrasil-relay/DESIGN.md`）。
 
 ---
 
 ## 參考連結
 
 - YAML 範例：`.collaboration/tasks/TASK_Example_{git_user}.yaml`
-- 舊系統文檔：`.system/pipeline/README.md`（待建立）
-- Formation 整合：`.formation/tools/loader.js:180-220`
-- Dashboard 整合：`dashboard/src-tauri/src/features/task/manager.rs`
 
 ---
 

package/core/CLAUDE.md

@@ -38,7 +38,7 @@ session 開始時先鎖定語言（對照用戶第一條訊息 + cwd/CLAUDE.md
   - 「這個檔案有哪些 symbol？」→ `kenaz_lsp_symbols`
 - **文字 / 概念搜尋** → `Grep` / `Glob`（精確字串、正則、枚舉；需用 `|` 猜多個關鍵字時，就多組關鍵字一起 Grep）。
 - Session 初始化時用 `ToolSearch "kenaz_lsp"` 偵測 LSP 工具。ToolSearch 未找到 → 該 session 全程降級用 Grep/Glob。
-- 修改非 trivial symbol 前：用 `kenaz_lsp_references` / `kenaz_lsp_callers` 看影響範圍（FAIL-009）。trivial 改動可跳過。
+- 修改非 trivial symbol 前：用 `kenaz_lsp_references` / `kenaz_lsp_callers` 看影響範圍。trivial 改動可跳過。
 - 所有 `kenaz_lsp_*` 呼叫必須明確帶 `projectPath`。
 
 **記憶系統已移除（2026-10-11，TASK_2411）**：Synapse / Hippocampus / Cortex recall / embeddings 與 Alaya seeds/bijas 已移除，`synapse_*`、`hippocampus_*`、`cortex_*`、`alaya_recall` 不再存在；教訓用 `kenaz learn add` 與 Claude 原生記憶檔；`~/.kenaz/cortex/*.db` 與 `.synapse/` 資料留在磁碟上、不再開啟。
@@ -97,12 +97,7 @@ KenazAI 是一個 Claude Code 多 Agent 協作系統，包含：
 | `/產品` | 需求分析、PRD |
 | `/設計` | UI/UX 設計 |
 | `/評估` | 深度評估 |
-| `/sre` | Supabase 管理、部署、SLO/Error Budget |
-| `/init` | 初始化新專案 |
-| `/進度` | 查看開發進度 |
 | `/spec` | 規格優化與文件整理 |
-| `/strategy` | 策略智庫 |
-| `/sunny` | 內部系統開發模式 |
 
 完整指令列表見 `.claude/commands/`。
 

package/core/KENAZ_CORE_VERSION

@@ -1 +1 @@
-0.3.18
+0.3.20

package/core/dev/scripts/js-yaml-resolution.test.js

@@ -17,7 +17,7 @@ const path = require('path');
 const { spawnSync } = require('child_process');
 
 const ROOT = path.resolve(__dirname, '..', '..');
-const TARGETS = ['dev/scripts/check-file-size.js', '.memory/tools/memory-agent.js'];
+const TARGETS = ['dev/scripts/check-file-size.js'];
 // Shipped modules (not CLIs): static check only. cognitive.js swallowed the missing
 // module in a try/catch and silently returned fallback rules in kenaz-core.
 const MODULES = ['.formation/tools/post-complete/cognitive.js'];