kenaz 0.0.0-stage → 0.3.2

package/core/dev/pipeline/archived/TASK_026_spec_versioning.yaml

@@ -0,0 +1,56 @@
+# TASK_026: 規格版本化
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_026"
+title: "規格版本化機制"
+description: |
+  為 PRODUCT_SPEC.md 建立版本控制機制，讓任務能綁定到特定版本的規格。
+
+  目前規格與任務之間沒有版本對應關係，無法回答：
+  - 這個任務是基於哪個版本的規格？
+  - 規格更新後，哪些任務需要重新審視？
+
+  透過版本化機制，規格變更時可追蹤影響範圍。
+
+priority: "P1"
+status: "completed"
+agent_type: "architect"
+source: "SDD 改進 - 規格版本控制"
+
+dependencies:
+  - "TASK_024"
+
+scope_paths:
+  - "dev/PRODUCT_SPEC.md"
+  - "dev/schemas/"
+  - "dev/pipeline/orchestrator/"
+
+requirements:
+  - "在 PRODUCT_SPEC.md 頂部加入 spec_version 和 last_modified 欄位"
+  - "擴展 TASK.schema.json 加入 spec_version 欄位"
+  - "PM Agent 建立任務時自動填入當前規格版本"
+  - "規格更新時自動遞增版本號（semver 或日期格式）"
+  - "實作 SpecVersionChecker 檢測任務與規格版本是否匹配"
+
+acceptance_criteria:
+  - "PRODUCT_SPEC.md 頂部包含 spec_version: 'x.y.z' 和 last_modified: 'YYYY-MM-DD'"
+  - "新建立的任務自動包含 spec_version 欄位"
+  - "規格更新後，版本號自動遞增"
+  - "可查詢「哪些任務基於舊版規格」"
+
+technical_notes:
+  - "版本格式建議：major.minor.patch（semver）"
+  - "Feature 新增 = minor++，Feature 修改 = patch++，架構變更 = major++"
+  - "考慮 Git hook 自動更新 last_modified"
+  - "舊任務的 spec_version 可標記為 'legacy' 或 '0.0.0'"
+
+estimated_hours: 4
+complexity: "medium"
+
+related_tasks:
+  - "TASK_024"
+  - "TASK_027"
+
+metadata:
+  created_at: "2026-02-01T12:00:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_027_drift_detection.yaml

@@ -0,0 +1,60 @@
+# TASK_027: 漂移檢測 Agent
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_027"
+title: "規格漂移檢測機制"
+description: |
+  建立自動化機制檢測程式碼與規格之間的「漂移」（Drift）。
+
+  漂移的定義：
+  1. 程式碼中存在規格未定義的功能（Code > Spec）
+  2. 規格定義了但程式碼未實現的功能（Spec > Code）
+  3. 程式碼行為與規格描述不一致（Mismatch）
+
+  這是實現「規格即 Source of Truth」的關鍵機制。
+
+priority: "P2"
+status: "completed"
+agent_type: "architect"
+source: "SDD 改進 - 漂移檢測"
+
+dependencies:
+  - "TASK_024"
+  - "TASK_026"
+
+scope_paths:
+  - "dev/pipeline/orchestrator/"
+  - "dev/scripts/"
+  - ".claude/skills/"
+
+requirements:
+  - "實作 DriftDetector 模組掃描程式碼與規格"
+  - "檢測 Feature 實現狀態：implemented / partial / missing"
+  - "檢測未定義功能：程式碼中存在但規格未涵蓋的模組"
+  - "產生漂移報告（drift_report.json）"
+  - "整合到 /product-review 指令，自動執行漂移檢測"
+
+acceptance_criteria:
+  - "DriftDetector 能解析 PRODUCT_SPEC.md 的所有 Feature"
+  - "能掃描 dashboard/ 目錄識別已實現的功能"
+  - "產生的 drift_report.json 包含 implemented / partial / missing 分類"
+  - "未定義功能警告：「Component X 不在規格中，請確認是否需要補充規格」"
+  - "/product-review 執行時自動產生漂移報告"
+
+technical_notes:
+  - "Feature 實現檢測策略：關鍵檔案存在 + 關鍵函數存在"
+  - "可用 AST 解析或簡單的 grep 搜尋"
+  - "考慮 Feature 與程式碼的映射表（feature_mapping.json）"
+  - "漂移報告格式需 PM 可讀，包含修復建議"
+
+estimated_hours: 8
+complexity: "complex"
+
+related_tasks:
+  - "TASK_024"
+  - "TASK_025"
+  - "TASK_026"
+
+metadata:
+  created_at: "2026-02-01T12:00:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_028_tauri_pty_manager.yaml

@@ -0,0 +1,60 @@
+# TASK_028: PTY Manager 模組集成到 Tauri
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_028"
+title: "PTY Manager 模組集成到 Tauri"
+description: |
+  將現有 pty-server 的 PTY Manager 邏輯直接集成到 Tauri Rust 後端。
+  目前 pty-server 是獨立的 HTTP 服務，導致 Tauri 桌面版無法使用 CLI Sessions。
+  需要將 pty_manager.rs 的核心邏輯移植到 src-tauri 中。
+
+priority: "P1"
+status: "completed"
+agent_type: "backend"
+source: "F-006.2"
+feature_ids:
+  - "F-006"
+
+dependencies: []
+
+scope_paths:
+  - "dashboard/src-tauri/src/"
+  - "dashboard/src-tauri/Cargo.toml"
+
+requirements:
+  - "在 src-tauri/Cargo.toml 添加 portable-pty、parking_lot、uuid 依賴"
+  - "建立 src-tauri/src/pty_manager.rs 模組"
+  - "從 pty-server/src/pty_manager.rs 移植 PtySession 結構"
+  - "從 pty-server/src/pty_manager.rs 移植 PtyManager 結構"
+  - "實作 spawn_session 方法（建立 PTY session）"
+  - "實作 write_to_session 方法（寫入數據到 PTY）"
+  - "實作 resize_session 方法（調整終端大小）"
+  - "實作 close_session 方法（關閉 session）"
+  - "實作 list_sessions 方法（列出所有 sessions）"
+  - "實作 get_session 方法（取得單一 session）"
+  - "在 lib.rs 中註冊 pty_manager 模組"
+
+acceptance_criteria:
+  - "Cargo build 成功，無編譯錯誤"
+  - "PtyManager::new() 能正常建立實例"
+  - "spawn_session 能成功啟動 shell（Windows: powershell.exe）"
+  - "write_to_session 能正確寫入數據"
+  - "resize_session 能正確調整終端大小"
+
+technical_notes:
+  - "portable-pty 版本與 pty-server 保持一致"
+  - "使用 Tauri 的 State 管理 PtyManager 實例"
+  - "注意 Windows 平台的 shell 預設值（powershell.exe）"
+  - "輸出使用 tokio::sync::broadcast channel"
+
+estimated_hours: 4
+complexity: "medium"
+
+related_tasks:
+  - "TASK_017"
+  - "TASK_022"
+  - "TASK_029"
+
+metadata:
+  created_at: "2026-02-02T16:30:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_029_tauri_pty_commands.yaml

@@ -0,0 +1,62 @@
+# TASK_029: Tauri PTY Commands 實作
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_029"
+title: "Tauri PTY Commands 實作"
+description: |
+  為 Tauri 實作 PTY 相關的 Commands，讓前端能透過 IPC 調用 PTY 功能。
+  包括建立、寫入、調整大小、關閉 session 等操作。
+  同時實作 Tauri Events 將 PTY 輸出推送到前端。
+
+priority: "P1"
+status: "completed"
+agent_type: "backend"
+source: "F-006.2"
+feature_ids:
+  - "F-006"
+
+dependencies:
+  - "TASK_028"
+
+scope_paths:
+  - "dashboard/src-tauri/src/commands.rs"
+  - "dashboard/src-tauri/src/lib.rs"
+
+requirements:
+  - "實作 pty_spawn command（建立新 PTY session）"
+  - "實作 pty_write command（寫入數據到 PTY）"
+  - "實作 pty_resize command（調整終端大小）"
+  - "實作 pty_close command（關閉 PTY session）"
+  - "實作 pty_list command（列出所有 sessions）"
+  - "實作 pty-data event（PTY 輸出推送到前端）"
+  - "實作 pty-exit event（session 結束通知）"
+  - "在 lib.rs 註冊所有 PTY commands"
+  - "管理 PtyManager 為 Tauri State"
+
+acceptance_criteria:
+  - "invoke('pty_spawn') 能成功建立 session 並返回 session ID"
+  - "invoke('pty_write') 能正確寫入數據"
+  - "invoke('pty_resize') 能正確調整大小"
+  - "invoke('pty_close') 能正確關閉 session"
+  - "invoke('pty_list') 能返回所有 active sessions"
+  - "前端能收到 pty-data 事件並顯示輸出"
+  - "session 結束時前端收到 pty-exit 事件"
+
+technical_notes:
+  - "使用 #[tauri::command] 標註所有 commands"
+  - "使用 tauri::State<PtyManager> 存取 PTY manager"
+  - "使用 app.emit() 發送事件到前端"
+  - "輸出 thread 需要持有 AppHandle 發送事件"
+  - "Command 參數結構需要 Deserialize"
+  - "返回值需要 Serialize"
+
+estimated_hours: 4
+complexity: "medium"
+
+related_tasks:
+  - "TASK_028"
+  - "TASK_030"
+
+metadata:
+  created_at: "2026-02-02T16:30:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_030_frontend_session_adapter.yaml

@@ -0,0 +1,54 @@
+# TASK_030: 前端 SessionManager 適配 Tauri 模式
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_030"
+title: "前端 SessionManager 適配 Tauri 模式"
+description: |
+  修改前端 SessionManager 和 API adapter，讓 Tauri 桌面版能正常使用 CLI Sessions。
+  目前 SessionManager 在 Tauri 模式下被禁用，需要移除這個限制並接入 Tauri PTY commands。
+
+priority: "P1"
+status: "completed"
+agent_type: "frontend"
+source: "F-006.2"
+feature_ids:
+  - "F-006"
+
+dependencies:
+  - "TASK_029"
+
+scope_paths:
+  - "dashboard/src/lib/tauri-commands.ts"
+  - "dashboard/src/lib/api-adapter.ts"
+  - "dashboard/src/components/session-manager/SessionManager.tsx"
+
+requirements:
+  - "在 tauri-commands.ts 添加 PTY 相關類型定義"
+  - "在 tauri-commands.ts 添加 pty_spawn、pty_write、pty_resize、pty_close、pty_list 封裝"
+  - "在 api-adapter.ts 添加 PTY API（spawnPtySession、writePtySession、...）"
+  - "修改 SessionManager 移除 isTauriMode 禁用邏輯"
+  - "修改 SessionManager 在 Tauri 模式使用 Tauri commands"
+  - "修改 SessionManager 的 polling 邏輯為 Tauri events"
+
+acceptance_criteria:
+  - "Tauri 桌面版中 '+NEW' 按鈕可點擊"
+  - "點擊 '+NEW' 能成功建立新 session"
+  - "Session 列表正確顯示 active sessions"
+  - "能正確關閉 session"
+
+technical_notes:
+  - "使用 @tauri-apps/api/core 的 invoke"
+  - "SessionManager 需要區分 web/tauri 模式調用不同 API"
+  - "保持 web 模式的 HTTP API 不變"
+  - "Tauri 模式不需要 polling，使用 events"
+
+estimated_hours: 3
+complexity: "medium"
+
+related_tasks:
+  - "TASK_029"
+  - "TASK_031"
+
+metadata:
+  created_at: "2026-02-02T16:30:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_031_terminal_tauri_events.yaml

@@ -0,0 +1,56 @@
+# TASK_031: Terminal 組件 Tauri 事件適配
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_031"
+title: "Terminal 組件 Tauri 事件適配"
+description: |
+  修改 Terminal 組件，讓它在 Tauri 模式下使用 Tauri events 接收 PTY 輸出，
+  而不是 WebSocket。同時處理輸入寫入和終端大小調整。
+
+priority: "P2"
+status: "completed"
+agent_type: "frontend"
+source: "F-006.2"
+feature_ids:
+  - "F-006"
+
+dependencies:
+  - "TASK_030"
+
+scope_paths:
+  - "dashboard/src/components/terminal/TerminalPanel.tsx"
+  - "dashboard/src/components/terminal/Terminal.tsx"
+  - "dashboard/src/hooks/"
+
+requirements:
+  - "建立 useTauriPtyEvents hook 監聽 pty-data 和 pty-exit 事件"
+  - "修改 Terminal 組件在 Tauri 模式使用 Tauri events"
+  - "修改 Terminal 輸入處理使用 pty_write command"
+  - "修改 Terminal resize 處理使用 pty_resize command"
+  - "處理 session 結束（pty-exit）的 UI 更新"
+  - "保持 web 模式的 WebSocket 邏輯不變"
+
+acceptance_criteria:
+  - "Tauri 桌面版中 Terminal 能正常顯示 PTY 輸出"
+  - "能正常輸入命令並執行"
+  - "調整視窗大小時終端正確 resize"
+  - "Session 結束時正確顯示狀態"
+  - "多 tab 切換正常運作"
+
+technical_notes:
+  - "使用 @tauri-apps/api/event 的 listen"
+  - "事件 payload 包含 session_id 用於區分多 session"
+  - "xterm.js 的 onData 需要調用 pty_write"
+  - "xterm.js 的 onResize 需要調用 pty_resize"
+  - "注意 cleanup：組件 unmount 時取消事件監聽"
+
+estimated_hours: 4
+complexity: "medium"
+
+related_tasks:
+  - "TASK_030"
+  - "TASK_017"
+
+metadata:
+  created_at: "2026-02-02T16:30:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_041_scheduler_data_models.yaml

@@ -0,0 +1,54 @@
+# TASK_041: Scheduler Core Data Models
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_041"
+title: "Scheduler 核心數據模型定義"
+description: |
+  為 Multi-Agent Scheduler 定義 Rust 核心數據結構，取代 PowerShell 的動態 JSON 處理。
+
+  需要擴展現有的 cmd_modules/agent.rs 和 cmd_modules/task.rs，新增：
+  - PathLock 結構（路徑鎖定）
+  - LockState 結構（全局鎖狀態）
+  - ProcessInfo 結構（進程追蹤）
+  - SchedulerConfig 結構（調度器配置）
+
+  所有結構使用 Serde 進行序列化/反序列化。
+
+priority: "P0"
+status: "pending"
+agent_type: "backend"
+source: "Multi-Agent Scheduler 重構"
+feature_ids:
+  - "F-SCHEDULER"
+
+dependencies: []
+
+scope_paths:
+  - "dashboard/src-tauri/src/cmd_modules/"
+
+requirements:
+  - "定義 PathLock 結構：path, agent_id, task_id, lock_type, acquired_at"
+  - "定義 LockState 結構：locks Vec<PathLock>, last_updated"
+  - "定義 ProcessInfo 結構：pid, status, started_at, timeout_at"
+  - "定義 SchedulerConfig 結構：max_agents, poll_interval, task_timeout"
+  - "擴展現有 Agent 結構：加入 process_info 欄位"
+  - "所有結構實作 Serialize, Deserialize, Clone, Debug"
+  - "定義 TaskStatus 和 LockType 為 Rust enum"
+
+acceptance_criteria:
+  - "所有新數據結構可正確序列化為 JSON"
+  - "所有新數據結構可從 JSON 反序列化"
+  - "單元測試覆蓋序列化/反序列化場景"
+  - "與現有 LOCK_STATE.json 格式兼容"
+
+technical_notes:
+  - "參考現有 cmd_modules/agent.rs 和 cmd_modules/task.rs 的模式"
+  - "使用 chrono 處理時間戳"
+  - "考慮與 PowerShell 版本的向後兼容性"
+
+estimated_hours: 3
+complexity: "medium"
+
+metadata:
+  created_at: "2026-02-03T16:00:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_042_path_lock_manager.yaml

@@ -0,0 +1,53 @@
+# TASK_042: Path Lock Manager
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_042"
+title: "路徑鎖定管理模組"
+description: |
+  實作路徑鎖定機制，防止多個 Agent 同時修改相同文件/目錄。
+
+  核心功能：
+  1. 鎖定/解鎖路徑
+  2. 衝突檢測（路徑重疊判斷）
+  3. 鎖狀態持久化到 LOCK_STATE.json
+  4. 過時鎖清理
+
+priority: "P0"
+status: "pending"
+agent_type: "backend"
+source: "Multi-Agent Scheduler 重構"
+feature_ids:
+  - "F-SCHEDULER"
+
+dependencies:
+  - "TASK_041"
+
+scope_paths:
+  - "dashboard/src-tauri/src/cmd_modules/"
+
+requirements:
+  - "實作 acquire_locks(agent_id, task_id, paths) -> Result<(), LockError>"
+  - "實作 release_locks(agent_id) -> Result<(), LockError>"
+  - "實作 check_conflict(paths) -> Option<ConflictInfo>"
+  - "路徑衝突檢測：A/B 和 A/B/C 視為衝突"
+  - "支援目錄鎖和文件鎖"
+  - "原子性：鎖操作要麼全部成功，要麼全部失敗"
+  - "持久化到 dev/pipeline/LOCK_STATE.json"
+
+acceptance_criteria:
+  - "鎖定路徑後，其他 Agent 無法取得重疊路徑的鎖"
+  - "釋放鎖後，路徑可被其他 Agent 鎖定"
+  - "鎖狀態在 Scheduler 重啟後可恢復"
+  - "單元測試覆蓋衝突檢測邏輯"
+
+technical_notes:
+  - "使用 tokio::sync::RwLock 保護內存狀態"
+  - "文件寫入使用重試機制（參考 Write-FileWithRetry）"
+  - "路徑標準化：統一使用 / 分隔符"
+
+estimated_hours: 4
+complexity: "medium"
+
+metadata:
+  created_at: "2026-02-03T16:00:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_043_process_manager.yaml

@@ -0,0 +1,57 @@
+# TASK_043: Process Manager
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_043"
+title: "進程管理模組"
+description: |
+  使用 tokio::process 實作非同步進程管理，包括：
+  1. 啟動 Claude CLI 進程
+  2. 進程輸出收集（stdout/stderr）
+  3. 超時控制
+  4. 優雅關閉與進程樹終止
+
+priority: "P0"
+status: "completed"
+agent_type: "backend"
+source: "Multi-Agent Scheduler 重構"
+feature_ids:
+  - "F-SCHEDULER"
+
+dependencies:
+  - "TASK_041"
+
+scope_paths:
+  - "dashboard/src-tauri/src/cmd_modules/"
+  - "dashboard/src-tauri/Cargo.toml"
+
+requirements:
+  - "使用 tokio::process::Command 非同步啟動進程"
+  - "實作 spawn_agent(config) -> Result<ProcessHandle, Error>"
+  - "實作進程輸出的逐行讀取（BufReader）"
+  - "實作 tokio::time::timeout 超時控制"
+  - "實作 kill_process_tree(pid) 終止進程樹"
+  - "Windows 平台使用 taskkill /T /F"
+  - "進程狀態追蹤：Running, Completed, Failed, Timeout"
+
+acceptance_criteria:
+  - "可成功啟動 Claude CLI 進程"
+  - "可收集進程的 stdout 和 stderr"
+  - "超時後自動終止進程"
+  - "主進程退出時，所有子進程被正確終止"
+  - "單元測試覆蓋進程生命週期"
+
+technical_notes:
+  - "Windows: 使用 cmd.exe /c claude 啟動（npm 全局安裝生成 .cmd）"
+  - "Linux/macOS: 直接調用 claude"
+  - "使用 tokio::io::BufReader 實現逐行讀取"
+  - "進程終止需處理 SIGTERM/SIGKILL"
+
+estimated_hours: 6
+complexity: "complex"
+
+related_tasks:
+  - "TASK_044"
+
+metadata:
+  created_at: "2026-02-03T16:00:00+08:00"
+  created_by: "Product Manager Agent"

package/core/dev/pipeline/archived/TASK_044_git_integration.yaml

@@ -0,0 +1,85 @@
+# TASK_044: Git Integration
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_044"
+title: "Git 自動化整合模組"
+description: |
+  實作 Git 操作自動化，確保每個 Agent 在獨立分支工作。
+
+  核心功能：
+  1. 自動創建任務分支
+  2. 任務完成後自動 commit 和 merge
+  3. 失敗時的分支清理
+  4. 分支恢復機制（resume 功能）
+
+priority: "P0"
+status: "completed"
+agent_type: "backend"
+source: "Multi-Agent Scheduler 重構"
+feature_ids:
+  - "F-SCHEDULER"
+
+dependencies:
+  - "TASK_041"
+
+scope_paths:
+  - "dashboard/src-tauri/src/cmd_modules/"
+
+requirements:
+  - "實作 create_task_branch(task_id, agent_id) -> Result<String, Error>"
+  - "實作 checkout_branch(branch_name) -> Result<(), Error>"
+  - "實作 merge_to_main(branch_name, message) -> Result<(), Error>"
+  - "實作 delete_branch(branch_name) -> Result<(), Error>"
+  - "實作 get_commits_ahead(branch) -> Result<u32, Error>"
+  - "實作 has_uncommitted_changes() -> Result<bool, Error>"
+  - "支援 resume：檢測現有分支的進度"
+
+acceptance_criteria:
+  - "可自動創建 task-TASK_XXX-agent_XXX 格式的分支"
+  - "任務完成後成功合併到 main"
+  - "衝突時返回錯誤而非 panic"
+  - "分支清理不影響其他分支"
+  - "單元測試覆蓋基本 Git 操作"
+
+technical_notes:
+  - "使用 git2 crate 或直接調用 git 命令"
+  - "直接調用 git 命令更簡單，建議優先使用"
+  - "需處理 main vs master 分支名稱差異"
+  - "Merge commit message 格式：Merge TASK_XXX: Completed by agent_XXX"
+
+estimated_hours: 5
+complexity: "medium"
+
+metadata:
+  created_at: "2026-02-03T16:00:00+08:00"
+  created_by: "Product Manager Agent"
+  completed_at: "2026-02-03T19:30:00+08:00"
+  completed_by: "Dev Agent (Backend Engineer Mode)"
+
+completion_notes: |
+  ## 實作摘要
+
+  建立了 `dashboard/src-tauri/src/cmd_modules/git.rs` 模組，完整實作所有需求功能：
+
+  ### 核心功能
+  - `GitManager::create_task_branch()` - 創建 task-{TASK_ID}-{AGENT_ID} 格式分支
+  - `GitManager::checkout_branch()` - 切換分支（含未提交變更檢查）
+  - `GitManager::merge_to_main()` - 合併到主分支（含衝突檢測和中止）
+  - `GitManager::delete_branch()` - 刪除分支（防止刪除主分支）
+  - `GitManager::get_commits_ahead()` / `get_commits_behind()` - 提交數量統計
+  - `GitManager::has_uncommitted_changes()` - 未提交變更檢查
+
+  ### Resume 支援
+  - `GitManager::find_task_branch()` - 查找現有任務分支
+  - `GitManager::resume_task_branch()` - 恢復任務分支工作狀態
+
+  ### 其他功能
+  - `GitManager::commit_all()` - 暫存並提交所有變更
+  - `GitManager::list_branches()` / `list_task_branches()` - 列出分支
+  - `GitManager::cleanup_merged_branches()` - 清理已合併分支
+  - 自動偵測 main vs master 分支
+  - 完整錯誤類型定義 (GitError, GitErrorCode)
+
+  ### 測試覆蓋
+  - 29 個單元測試全部通過
+  - 覆蓋所有核心功能和邊界情況

package/core/dev/pipeline/archived/TASK_045_task_queue_manager.yaml

@@ -0,0 +1,54 @@
+# TASK_045: Task Queue Manager
+# Schema: dev/schemas/TASK.schema.json
+
+id: "TASK_045"
+title: "任務佇列管理模組"
+description: |
+  擴展現有的 cmd_modules/task.rs，實作完整的任務佇列管理功能。
+
+  核心功能：
+  1. 任務狀態更新
+  2. 依賴解析（找出可執行任務）
+  3. 優先級排序
+  4. 任務文件移動（tasks/ -> completed/）
+
+priority: "P0"
+status: "pending"
+agent_type: "backend"
+source: "Multi-Agent Scheduler 重構"
+feature_ids:
+  - "F-SCHEDULER"
+
+dependencies:
+  - "TASK_041"
+
+scope_paths:
+  - "dashboard/src-tauri/src/cmd_modules/task.rs"
+
+requirements:
+  - "實作 update_task_status(task_id, status, metadata) -> Result<(), Error>"
+  - "實作 get_ready_tasks() -> Vec<Task> 返回可執行任務"
+  - "實作依賴解析：只返回依賴已完成的任務"
+  - "實作優先級排序：P0 > P1 > P2 > P3"
+  - "實作 move_to_completed(task_id) -> Result<(), Error>"
+  - "任務狀態變更時自動更新 last_updated"
+  - "支援設定 assigned_agent 和 branch 欄位"
+
+acceptance_criteria:
+  - "只有依賴全部完成的任務才會被返回"
+  - "任務按優先級正確排序"
+  - "狀態更新正確持久化到 TASK_QUEUE.json"
+  - "已完成任務正確移動到 completed/ 目錄"
+  - "單元測試覆蓋依賴解析和排序邏輯"
+
+technical_notes:
+  - "擴展現有 task.rs，不要建立新文件"
+  - "使用 tokio::fs 進行非同步文件操作"
+  - "文件寫入使用重試機制避免競爭條件"
+
+estimated_hours: 4
+complexity: "medium"
+
+metadata:
+  created_at: "2026-02-03T16:00:00+08:00"
+  created_by: "Product Manager Agent"