kenaz 0.3.18 → 0.3.19

package/core/.claude/commands/agent-worker.md

@@ -23,7 +23,7 @@ Parse the arguments from this prompt text using regex or string parsing:
 - Then: TASK_ID=TASK_003, AGENT_ID=agent_123, BRANCH_NAME=task/task_003
 
 ### 2. Load Task Details
-Read `dev/pipeline/TASK_QUEUE.json` and find the task matching `TASK_ID`.
+Run `node .collaboration/core/task-api.js get TASK_ID` to read the task card (`.kenaz/tasks/`).
 
 Extract:
 - `title`: Task name

package/core/.claude/commands/architect.md

@@ -17,8 +17,7 @@
    - 撰寫模組接口規範
 
 4. **產出文件**：
-   - 更新 `dev/pipeline/TASK_QUEUE.json`
-   - 建立任務文件至 `dev/pipeline/tasks/`
+   - 用 `node .collaboration/core/task-api.js create` 建立任務卡（`.kenaz/tasks/backlog/`）
    - 撰寫接口文檔至 `docs/`
 
 請開始執行系統架構設計。

package/core/.claude/commands/spec.md

@@ -4,7 +4,7 @@
 
 ## 使用場景
 
-- 完成重要里程碑後，需要整理記憶點
+- 完成重要里程碑後，需要整理文件與任務狀態
 - 需要更新 PRODUCT_SPEC.md 的 Feature 狀態
 - 需要從 .failure/ 提取失敗經驗
 - 定期維護文件（建議每週）

package/core/.claude/commands//347/224/242/345/223/201.md

@@ -10,6 +10,6 @@
    - 深度理解用戶需求
    - 進行需求分析
    - 將需求拆解為開發任務
-   - 將任務寫入 Pipeline 系統
+   - 用 `node .collaboration/core/task-api.js create` 建立任務卡（`.kenaz/tasks/backlog/`），完成後建議交給 `/Ansuz` 派工
 
 請開始執行產品需求分析。

package/core/.claude/hooks/__tests__/task-1977-dedupe-guard.test.js

@@ -41,11 +41,11 @@ function mkTmp(prefix) {
   return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
 }
 
-// A "foreign copy" dir: _dedupe-guard.js + fatigue-check.js's dependency
+// A "foreign copy" dir: _dedupe-guard.js + synapse-first-investigation.js's dependency
 // closure, copied OUTSIDE the project tree (simulates the installed copy
 // living under %LOCALAPPDATA%/Kenaz Dashboard/kenaz-core/.claude/hooks/).
 const FOREIGN_DIR = mkTmp('kenaz-dedupe-guard-foreign-');
-for (const f of ['_dedupe-guard.js', '_project-guard.js', '_peer-project-root.js', '_signal-fence.js', 'fatigue-check.js']) {
+for (const f of ['_dedupe-guard.js', '_project-guard.js', '_peer-project-root.js', '_signal-fence.js']) {
   fs.copyFileSync(path.join(HOOKS_DIR, f), path.join(FOREIGN_DIR, f));
 }
 // Also stage synapse-first-investigation.js (emits JSON on every run) so case
@@ -67,15 +67,15 @@ function run(scriptRelName, env, stdinPayload) {
 // (a) Project WITH a same-named hook -> foreign copy yields.
 // ---------------------------------------------------------------------------
 console.log('\n--- (a) installed copy yields when a project copy exists ---');
-const PROJECT_WITH_HOOKS = path.resolve(HOOKS_DIR, '..', '..'); // repo root (has .claude/hooks/fatigue-check.js)
+const PROJECT_WITH_HOOKS = path.resolve(HOOKS_DIR, '..', '..'); // repo root (has .claude/hooks/synapse-first-investigation.js)
 {
-  const r = run('fatigue-check.js', { CLAUDE_PROJECT_DIR: PROJECT_WITH_HOOKS }, {
-    session_id: 'x', hook_event_name: 'UserPromptSubmit', prompt: 'hi',
+  const r = run('synapse-first-investigation.js', { CLAUDE_PROJECT_DIR: PROJECT_WITH_HOOKS }, {
+    session_id: 'x', hook_event_name: 'PreToolUse', tool_name: 'Bash', tool_input: { command: 'ls' },
   });
   ok('exit code 0', r.status === 0, `status=${r.status} stderr=${r.stderr}`);
   ok('stdout empty', (r.stdout || '') === '', `stdout=${JSON.stringify(r.stdout)}`);
   ok('one stderr yield line naming the project copy',
-    /\[dedupe-guard\] fatigue-check\.js: yielding to project copy at/.test(r.stderr || ''),
+    /\[dedupe-guard\] synapse-first-investigation\.js: yielding to project copy at/.test(r.stderr || ''),
     `stderr=${JSON.stringify(r.stderr)}`);
 }
 
@@ -103,8 +103,8 @@ fs.writeFileSync(path.join(PROJECT_NO_HOOKS, '.kenaz', 'project.yaml'), 'name: d
 // ---------------------------------------------------------------------------
 console.log('\n--- (c) the project copy itself always runs (never yields to itself) ---');
 {
-  const r = spawnSync(process.execPath, [path.join(HOOKS_DIR, 'fatigue-check.js')], {
-    input: JSON.stringify({ session_id: 'x', hook_event_name: 'UserPromptSubmit', prompt: 'hi' }),
+  const r = spawnSync(process.execPath, [path.join(HOOKS_DIR, 'synapse-first-investigation.js')], {
+    input: JSON.stringify({ session_id: 'x', hook_event_name: 'PreToolUse', tool_name: 'Bash', tool_input: { command: 'ls' } }),
     env: { ...process.env, CLAUDE_PROJECT_DIR: PROJECT_WITH_HOOKS },
     encoding: 'utf8',
     timeout: 15000,

package/core/.claude/skills/architect_agent/SKILL.md

@@ -13,7 +13,7 @@ description: 架構設計、需求拆解、任務分派、接口定義、多Agen
 2. **任務拆解**：將大型需求拆解為可獨立執行的任務單元
 3. **Scope 定義**：為每個任務定義精確的路徑範圍（避免衝突）
 4. **接口設計**：定義模組之間的接口規範，確保整合順利
-5. **任務分派**：將任務寫入 `TASK_QUEUE.json` 並分派給適合的 Agent
+5. **任務分派**：以 task-api 建立任務卡並指定適合的 role
 
 ## 技能
 * **系統分析**：識別系統架構邊界和模組劃分
@@ -24,9 +24,8 @@ description: 架構設計、需求拆解、任務分派、接口定義、多Agen
 
 ## 文件路徑
 * **產品規格**：`dev/PRODUCT_SPEC.md`
-* **任務佇列**：`dev/pipeline/TASK_QUEUE.json`
-* **進度追蹤**：`dev/pipeline/PROGRESS.md`
-* **待處理任務**：`dev/pipeline/tasks/`
+* **任務卡**：`.kenaz/tasks/{backlog,active,done,blocked,cancel}/`（YAML，目錄即狀態）
+* **任務 API**：`node .collaboration/core/task-api.js`
 * **接口文檔**：
   - `docs/api_spec.md`（API 接口）
   - `docs/component_spec.md`（組件接口）
@@ -171,97 +170,17 @@ def assign_agent(task: Task) -> str:
 
 > "接口定義已撰寫至 [文件路徑]"
 
-### 5. 產出任務檔案
-**將任務寫入 Pipeline 系統。**
+### 5. 產出任務卡
+**用 task-api 建立任務卡**（`node .collaboration/core/task-api.js --help` 列出全部欄位）。
 
-1. **建立任務文件**（`dev/pipeline/tasks/TASK_XXX_描述.md`）
-   - 檔案名稱格式：`TASK_XXX_簡短英文描述.md`
-   - 例如：`TASK_022_login_ui.md`
-
-2. **寫入 TASK_QUEUE.json**：
-   ```json
-   {
-       "id": "TASK_XXX",
-       "title": "實作用戶登入 UI",
-       "status": "pending",
-       "priority": "P1",
-       "estimated_hours": 4,
-       "scope": ["src/components/auth/", "src/utils/auth.ts"],
-       "dependencies": ["TASK_AAA"],
-       "blocked_by": ["TASK_AAA"],
-       "blocks": [],
-       "source": "用戶需求 / PRD P1 項目",
-       "source_file": "TASK_XXX_login_ui.md",
-       "created_at": "2026-01-31T10:00:00.000Z"
-   }
-   ```
-
-   **重要**：`source_file` 字段必須與步驟 1 建立的任務文件名稱一致，Dashboard 依賴此字段讀取任務詳細描述。
-
-3. **更新 PROGRESS.md**
-
-> "已建立 [N] 個新任務，已更新 TASK_QUEUE.json"
-
----
-
-## 使用 Orchestrator 模組
-
-Architect Agent 可以使用 `dev/pipeline/orchestrator/` 中的工具：
-
-### 任務佇列管理
-```python
-from dev.pipeline.orchestrator.task_queue import (
-    TaskQueue, Task, TaskStatus, TaskPriority, AgentType, TaskScope
-)
-
-# 載入任務佇列
-queue = TaskQueue("dev/pipeline/TASK_QUEUE.json")
-
-# 建立新任務
-new_task = Task(
-    id="TASK_022",
-    title="實作用戶登入 UI",
-    status=TaskStatus.PENDING,
-    priority=TaskPriority.P1,
-    scope=TaskScope(paths=["src/components/auth/"], files=[]),
-    dependencies=["TASK_021"],
-    assigned_agent=AgentType.FRONTEND
-)
-
-queue.add_task(new_task)
-queue.save()
-```
-
-### 依賴驗證
-```python
-from dev.pipeline.orchestrator.dependency_resolver import DependencyResolver
-
-resolver = DependencyResolver()
-
-# 添加任務和依賴
-resolver.add_task("TASK_022", dependencies=["TASK_021"])
-resolver.add_task("TASK_023", dependencies=["TASK_021", "TASK_022"])
-
-# 驗證無循環依賴
-if not resolver.validate_no_cycles():
-    cycle = resolver.get_cycle()
-    print(f"檢測到循環依賴: {cycle}")
-
-# 查看依賴圖
-print(resolver.visualize())
+```bash
+node .collaboration/core/task-api.js create --title "實作用戶登入 UI" --description "..."   --priority P1 --role frontend --tags code
+node .collaboration/core/task-api.js update TASK_XXX --append --acceptance-criteria "..." --technical-notes "..."
 ```
 
-### 路徑鎖定檢查
-```python
-from dev.pipeline.orchestrator.lock_manager import PathLockManager
-
-lock_manager = PathLockManager("dev/pipeline/LOCK_STATE.json")
+每張卡寫明 scope_paths（精確路徑，避免並行衝突）、dependencies（不得循環）、requirements、acceptance_criteria。
 
-# 檢查路徑是否被鎖定
-if lock_manager.is_locked("src/components/auth/"):
-    holder = lock_manager.get_lock_holder("src/components/auth/")
-    print(f"路徑已被 {holder} 鎖定")
-```
+> "已建立 [N] 張任務卡：TASK_..."
 
 ---
 
@@ -284,7 +203,7 @@ if lock_manager.is_locked("src/components/auth/"):
    - TASK_023 → TASK_022
    - TASK_024 → TASK_022
 5. 撰寫接口規範
-6. 更新 TASK_QUEUE.json
+6. 以 task-api 建立任務卡
 ```
 
 ### 範例 2：處理並行開發

package/core/.claude/skills/assessment_agent/SKILL.md

@@ -285,5 +285,4 @@ Agent 分析：
 ### 相關系統
 - `.rule/` - 規則系統（評估發現的重複問題可提升為規則）
 - `.failure/` - 失敗學習系統（評估時參考失敗經驗）
-- `.memory/` - 記憶系統（評估經驗可沉澱為記憶）
 - `dev/PRODUCT_SPEC.md` - 產品規格（功能評估對應 Feature ID）

package/core/.claude/skills/backend_engineer/SKILL.md

@@ -772,12 +772,9 @@ Backend Team 將遵循以下規範（參考 `.rule/code/` 規則）：
 
 執行任務前，檢查相關失敗模式（遵循 AGT-005 規則）：
 
-```powershell
-# 檢查 Backend 相關失敗模式
-.\.failure\tools\check_failures.ps1 -AgentType "backend"
-
-# 檢查 API 相關失敗模式
-.\.failure\tools\check_failures.ps1 -ScopePath "backend/"
+```bash
+# 讀索引，再 Grep 與任務 scope 相關的失敗記錄
+Grep pattern="backend|關鍵字" path=".failure/"
 ```
 
 ### 中文溝通

package/core/.claude/skills/code_reviewer/SKILL.md

@@ -262,7 +262,7 @@ description: 程式碼審查、三級問題分類（Blocker/Suggestion/Nit）、
 
 ### 驗證先例（grounding）
 
-`.failure/pipeline/FAIL-003-queue-pollution.yaml` 記錄了 task lifecycle 的 antisymmetry 破損：task 被 `claim`（移到 active/）後未正確 `complete`（移到 done/），導致 `TASK_QUEUE.json` 被累積的 orphan state 污染。若當時有 mutation_counterpart 稽核，`claim` 無對稱 `complete`/`move` 路徑會在 review 階段被標記為 **[BLOCKER] orphan**。
+歷史案例（舊 TASK_QUEUE 佇列，已退役）：task 被 `claim`（移到 active/）後未正確 `complete`（移到 done/），導致佇列被累積的 orphan state 污染。若當時有 mutation_counterpart 稽核，`claim` 無對稱 `complete`/`move` 路徑會在 review 階段被標記為 **[BLOCKER] orphan**。
 
 ### Grep 檢查清單
 

package/core/.claude/skills/code_reviewer/patterns.yaml

@@ -24,7 +24,7 @@ mutation_counterpart:
       rationale: 'task stuck in active/ -> scheduler sees it as in-progress forever, queue pollution'
       grep_mutation: 'task-api(.js)?s+claim'
       grep_counterpart: 'task-api(.js)?s+(complete|move)'
-      cited_failure: '.failure/pipeline/FAIL-003-queue-pollution.yaml'
+      cited_failure: 'historical: TASK_QUEUE pollution (FAIL-003, removed with the retired pipeline)'
 
     - pair: dom_event_listener
       mutation: 'addEventListener'

package/core/.claude/skills/designer/SKILL.md

@@ -828,12 +828,9 @@ grep -E "^## (色彩系統|字體規範|佈局系統|交互設計)" dev/DESIGN_S
 
 執行任務前，檢查相關失敗模式（遵循 AGT-005 規則）：
 
-```powershell
-# 檢查 Designer 相關失敗模式
-.\.failure\tools\check_failures.ps1 -AgentType "designer"
-
-# 檢查設計相關失敗模式
-.\.failure\tools\check_failures.ps1 -ScopePath "dev/DESIGN_SPEC.md"
+```bash
+# 讀索引，再 Grep 與任務 scope 相關的失敗記錄
+Grep pattern="dev/DESIGN_SPEC.md|關鍵字" path=".failure/"
 ```
 
 ### 中文溝通