kenaz 0.3.22 → 0.3.24

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

@@ -1,403 +0,0 @@
-id: TASK_101
-title: .team 協調系統核心模組實作
-description: |
-  完成 .team 協調系統的完整實作，包含權限管理、檔案鎖定、衝突解決、訊息通訊、工作流引擎等核心模組。
-  該系統將支援多 Agent 並行開發，確保任務分配、檔案存取、權限驗證、通訊協調的完整功能。
-
-priority: P0
-status: pending
-agent_type: backend_engineer
-source: Product Manager Team
-created_at: "2026-02-06"
-updated_at: "2026-02-06"
-
-requirements:
-  - id: REQ_101_001
-    title: 權限管理器實作
-    description: |
-      實作 permission_manager.py，根據 .team/scope_matrix.yaml 進行權限驗證。
-      - 支援角色級別權限檢查（reader, editor, admin）
-      - 支援路徑級別的細粒度權限（repository, file, directory）
-      - 支援臨時權限授予與撤銷
-      - 支援權限快取與失效機制
-    acceptance:
-      - 能夠根據角色驗證權限
-      - 能夠根據路徑進行細粒度控制
-      - 能夠支援權限繼承
-      - 性能: <50ms 單次驗證
-
-  - id: REQ_101_002
-    title: 檔案鎖定機制實作
-    description: |
-      實作 lock_manager.py，提供檔案級別的鎖定機制。
-      - 支援 read lock（多個 Agent 同時讀取）
-      - 支援 write lock（排他性寫入）
-      - 支援 lock escalation（讀鎖升級為寫鎖）
-      - 支援 deadlock detection 與 timeout 機制
-      - 支援 first-come-first-served 優先級
-    acceptance:
-      - 能夠建立和釋放讀寫鎖
-      - 能夠檢測死鎖並自動超時
-      - 能夠記錄鎖定履歷
-      - 性能: <100ms 鎖定/解鎖操作
-
-  - id: REQ_101_003
-    title: 衝突解決器實作
-    description: |
-      實作 conflict_resolver.py，支援多種衝突解決策略。
-      - 支援 merge conflict 自動解決（3-way merge）
-      - 支援 version conflict 檢測與解決
-      - 支援 dependency conflict 分析
-      - 支援衝突報告與人工干預
-      - 支援回滾與版本恢復
-    acceptance:
-      - 能夠檢測並報告衝突
-      - 能夠自動合併無衝突的變更
-      - 能夠記錄衝突解決過程
-      - 能夠支援人工審查模式
-
-  - id: REQ_101_004
-    title: 訊息佇列實作
-    description: |
-      實作 message_queue.py，支援 Agent 之間的非同步通訊。
-      - 支援 pub/sub 消息模式
-      - 支援優先級佇列（P0-P3）
-      - 支援消息確認機制（ACK/NACK）
-      - 支援消息持久化（SQLite）
-      - 支援消息重試機制
-    acceptance:
-      - 能夠發送和接收消息
-      - 能夠按優先級處理消息
-      - 能夠持久化未處理消息
-      - 吞吐量: >100 消息/秒
-
-  - id: REQ_101_005
-    title: 工作流引擎實作
-    description: |
-      實作 workflow_engine.py，支援複雜工作流定義與執行。
-      - 支援 YAML 工作流定義（DAG 格式）
-      - 支援任務依賴關係解析
-      - 支援並行、順序、條件執行
-      - 支援任務狀態追蹤
-      - 支援工作流暫停、恢復、取消
-      - 支援失敗回復與重試
-    acceptance:
-      - 能夠解析 YAML 工作流定義
-      - 能夠執行 DAG 任務圖
-      - 能夠支援並行執行
-      - 能夠追蹤任務狀態
-
-acceptance_criteria:
-  - id: AC_101_001
-    criterion: |
-      權限管理器能夠在 <50ms 內完成單次權限驗證，支援 3 種權限級別和路徑級別細粒度控制
-    validation: |
-      運行性能測試：
-      ```bash
-      python -m pytest .team/tests/test_permission_manager.py::test_performance -v
-      ```
-      結果要求: 平均延遲 <50ms，無超時
-
-  - id: AC_101_002
-    criterion: |
-      檔案鎖定機制能夠正確處理讀寫鎖、死鎖偵測、超時機制，並支援 first-come-first-served 優先級
-    validation: |
-      運行並發測試：
-      ```bash
-      python -m pytest .team/tests/test_lock_manager.py -v
-      ```
-      所有併發測試必須通過，包括死鎖偵測和超時恢復
-
-  - id: AC_101_003
-    criterion: |
-      衝突解決器能夠檢測多種衝突類型，自動解決無衝突變更，並支援人工審查
-    validation: |
-      運行衝突解決測試：
-      ```bash
-      python -m pytest .team/tests/test_conflict_resolver.py -v
-      ```
-      所有衝突類型測試必須通過
-
-  - id: AC_101_004
-    criterion: |
-      訊息佇列能夠支援 >100 消息/秒吞吐量，正確實現優先級和消息持久化
-    validation: |
-      運行性能和功能測試：
-      ```bash
-      python -m pytest .team/tests/test_message_queue.py -v
-      pytest .team/tests/test_message_queue.py::test_throughput -v
-      ```
-      吞吐量測試結果必須 >100 消息/秒
-
-  - id: AC_101_005
-    criterion: |
-      工作流引擎能夠正確解析 YAML 工作流定義，執行 DAG 任務圖，支援並行和條件執行
-    validation: |
-      運行工作流測試：
-      ```bash
-      python -m pytest .team/tests/test_workflow_engine.py -v
-      ```
-      所有工作流測試必須通過，包括並行執行和條件分支
-
-  - id: AC_101_006
-    criterion: |
-      整個協調系統必須包含完整的文檔、類型提示、錯誤處理和日誌記錄
-    validation: |
-      - 所有模組必須有 docstring 和類型提示
-      - 運行類型檢查：`mypy .team/orchestrator/ --strict`
-      - 代碼覆蓋率 >=85%：`pytest --cov=.team/orchestrator`
-
-technical_notes: |
-  ## Python 實作架構
-
-  ### 1. 權限管理器 (permission_manager.py)
-  ```python
-  class PermissionManager:
-      def __init__(self, scope_matrix_path: str):
-          self.scope_matrix = self._load_scope_matrix(scope_matrix_path)
-          self.cache = TTLCache(maxsize=1000, ttl=300)
-
-      def check_permission(self, agent_id: str, action: str, resource: str) -> bool:
-          # 1. 檢查緩存
-          # 2. 查詢 scope_matrix
-          # 3. 評估角色和路徑權限
-          # 4. 更新緩存
-          pass
-
-      def grant_temp_permission(self, agent_id: str, resource: str, duration: int):
-          # 授予臨時權限（用於特定任務）
-          pass
-  ```
-
-  ### 2. 檔案鎖定管理器 (lock_manager.py)
-  ```python
-  class LockManager:
-      def __init__(self, db_path: str = ".team/locks.db"):
-          self.db = sqlite3.connect(db_path)
-          self.locks = {}  # {resource: LockInfo}
-
-      def acquire_lock(self, resource: str, agent_id: str, lock_type: str, timeout: int = 300) -> LockToken:
-          # 1. 檢查 first-come-first-served 佇列
-          # 2. 驗證權限
-          # 3. 建立鎖定
-          # 4. 設置超時機制
-          pass
-
-      def detect_deadlock(self) -> List[str]:
-          # 使用 DFS 或 Tarjan 算法檢測循環依賴
-          pass
-  ```
-
-  ### 3. 衝突解決器 (conflict_resolver.py)
-  ```python
-  class ConflictResolver:
-      def resolve_merge_conflict(self, base: str, ours: str, theirs: str) -> Tuple[str, ConflictReport]:
-          # 執行 3-way merge
-          # 1. 標記衝突區塊
-          # 2. 嘗試自動合併
-          # 3. 回報無法自動解決的衝突
-          pass
-
-      def resolve_version_conflict(self, versions: List[Version]) -> Version:
-          # 版本衝突解決策略
-          # 1. 比較版本号
-          # 2. 檢查依賴關係
-          # 3. 選擇最新相容版本
-          pass
-  ```
-
-  ### 4. 訊息佇列 (message_queue.py)
-  ```python
-  class MessageQueue:
-      def __init__(self, db_path: str = ".team/messages.db"):
-          self.db = sqlite3.connect(db_path)
-          self.subscribers = defaultdict(list)
-
-      def publish(self, topic: str, message: Dict, priority: int = 1) -> str:
-          # 發布消息到佇列
-          # 1. 序列化消息
-          # 2. 存入資料庫
-          # 3. 通知訂閱者
-          pass
-
-      def subscribe(self, topic: str, handler: Callable) -> Subscription:
-          # 訂閱特定主題
-          pass
-  ```
-
-  ### 5. 工作流引擎 (workflow_engine.py)
-  ```python
-  class WorkflowEngine:
-      def __init__(self, workflow_dir: str = ".team/workflows"):
-          self.workflow_dir = workflow_dir
-          self.executor = ThreadPoolExecutor()
-
-      def load_workflow(self, workflow_file: str) -> WorkflowDAG:
-          # 解析 YAML 工作流定義
-          pass
-
-      def execute(self, workflow: WorkflowDAG, context: Dict) -> ExecutionResult:
-          # 執行工作流
-          # 1. 解析依賴關係
-          # 2. 排定執行順序
-          # 3. 並行執行無依賴任務
-          # 4. 追蹤狀態
-          pass
-  ```
-
-  ## 數據模型
-
-  ### Lock 數據結構
-  ```yaml
-  lock:
-    resource: string         # 被鎖定的資源路徑
-    agent_id: string         # 擁有鎖的 Agent ID
-    lock_type: enum          # read | write | exclusive
-    acquired_at: timestamp
-    expires_at: timestamp
-    token: uuid              # 鎖定憑證
-  ```
-
-  ### Message 數據結構
-  ```yaml
-  message:
-    id: uuid
-    topic: string
-    sender: string
-    payload: object
-    priority: int            # 0-3 (P0 最高)
-    status: enum             # pending | sent | acknowledged | failed
-    created_at: timestamp
-    retry_count: int
-  ```
-
-  ### Workflow 數據結構
-  ```yaml
-  workflow:
-    name: string
-    tasks:
-      - id: string
-        type: enum           # task | branch | parallel
-        depends_on: list     # 依賴的任務 ID
-        execute: string      # 命令或 Python 函數
-        timeout: int
-        retry: int
-    triggers:                # 觸發條件
-      - type: enum           # scheduled | event | manual
-        condition: string
-  ```
-
-  ## 依賴關係
-  - `permission_manager.py` - 被其他模組調用以驗證權限
-  - `lock_manager.py` - 被 workflow_engine.py 和外部 API 調用
-  - `message_queue.py` - 支援 Agent 間通訊
-  - `conflict_resolver.py` - 被 workflow_engine.py 在合併變更時調用
-  - `workflow_engine.py` - 最高層級，調用其他模組
-
-  ## 測試策略
-  1. 單元測試 - 各模組獨立測試
-  2. 整合測試 - 模組間協作測試
-  3. 性能測試 - 並發、吞吐量、延遲
-  4. 壓力測試 - 極限情況、死鎖、超時
-  5. 回歸測試 - 確保修改不破壞現有功能
-
-  ## 部署考慮
-  - 使用 SQLite 作為本地持久化存儲（支援多進程訪問）
-  - 使用 threading/asyncio 實現並發
-  - 使用 Python logging 進行詳細日誌記錄
-  - 使用 pydantic 進行數據驗證
-  - 考慮使用 APScheduler 實現定時任務和超時機制
-
-dependencies:
-  - .team/scope_matrix.yaml
-  - .team/orchestrator/
-  - .team/tests/
-
-estimated_hours: 40
-complexity: high
-tags:
-  - orchestrator
-  - coordination
-  - multi-agent
-  - backend
-  - python
-  - core-system
-
-subtasks:
-  - id: SUBTASK_101_001
-    title: 設計系統架構和數據模型
-    status: pending
-    estimated_hours: 3
-
-  - id: SUBTASK_101_002
-    title: 實作權限管理器
-    status: pending
-    estimated_hours: 8
-    depends_on: [SUBTASK_101_001]
-
-  - id: SUBTASK_101_003
-    title: 實作檔案鎖定管理器
-    status: pending
-    estimated_hours: 10
-    depends_on: [SUBTASK_101_001]
-
-  - id: SUBTASK_101_004
-    title: 實作衝突解決器
-    status: pending
-    estimated_hours: 8
-    depends_on: [SUBTASK_101_001]
-
-  - id: SUBTASK_101_005
-    title: 實作訊息佇列系統
-    status: pending
-    estimated_hours: 8
-    depends_on: [SUBTASK_101_001]
-
-  - id: SUBTASK_101_006
-    title: 實作工作流引擎
-    status: pending
-    estimated_hours: 12
-    depends_on: [SUBTASK_101_001, SUBTASK_101_002, SUBTASK_101_003, SUBTASK_101_004]
-
-  - id: SUBTASK_101_007
-    title: 編寫完整測試套件
-    status: pending
-    estimated_hours: 12
-    depends_on: [SUBTASK_101_002, SUBTASK_101_003, SUBTASK_101_004, SUBTASK_101_005, SUBTASK_101_006]
-
-  - id: SUBTASK_101_008
-    title: 文檔與類型檢查
-    status: pending
-    estimated_hours: 4
-    depends_on: [SUBTASK_101_007]
-
-deliverables:
-  - .team/orchestrator/permission_manager.py
-  - .team/orchestrator/lock_manager.py
-  - .team/orchestrator/conflict_resolver.py
-  - .team/orchestrator/message_queue.py
-  - .team/orchestrator/workflow_engine.py
-  - .team/orchestrator/__init__.py
-  - .team/orchestrator/models.py (數據模型)
-  - .team/orchestrator/exceptions.py (自定義異常)
-  - .team/tests/test_permission_manager.py
-  - .team/tests/test_lock_manager.py
-  - .team/tests/test_conflict_resolver.py
-  - .team/tests/test_message_queue.py
-  - .team/tests/test_workflow_engine.py
-  - .team/docs/ORCHESTRATOR_GUIDE.md
-  - .team/docs/API_REFERENCE.md
-
-notes: |
-  此任務是 .team 協調系統的核心實作，完成後將支援多 Agent 並行開發的完整協調功能。
-
-  關鍵里程碑：
-  1. 第 1 週 - 架構設計 + 權限/鎖定管理器
-  2. 第 2 週 - 衝突解決器 + 訊息佇列
-  3. 第 3 週 - 工作流引擎 + 完整測試
-  4. 第 4 週 - 優化 + 文檔完善 + 部署準備
-
-  風險項目：
-  - 死鎖檢測的複雜性 - 需要仔細的圖論算法實作
-  - 並發性能 - 需要大量性能測試和優化
-  - 數據一致性 - SQLite 多進程訪問需要正確的鎖定策略

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

@@ -1,90 +0,0 @@
-# TASK_102: Designer Team & SRE Team 建立
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_102"
-title: "Designer Team & SRE Team 建立"
-description: |
-  建立完整的 Designer Team 和 SRE Team 兩個團隊結構，包含團隊定義、10 個成員（各 5 人）、權限矩陣與工作流程。
-
-  **背景**：
-  .team 系統已完成 Product Manager Team（MVP）、Backend Team 和 Frontend Team。現在需要建立設計與基礎設施團隊，補全跨職能協作結構。
-
-  **目標**：
-  - Designer Team：展示設計流程、協作規範與交付物管理
-  - SRE Team：展示基礎設施管理、監控、安全與部署流程
-
-priority: "P1"
-status: "pending"
-agent_type: "developer"
-source: "F-009"
-feature_ids:
-  - "F-009"
-
-dependencies:
-  - "TASK_098"  # Product Manager Team 結構參考
-  - "TASK_099"  # Backend Team 結構參考
-  - "TASK_100"  # Frontend Team 結構參考
-
-scope_paths:
-  - ".team/designer/"
-  - ".team/sre/"
-
-requirements:
-  - "建立 .team/designer/TEAM.yaml（Designer Team 團隊定義）"
-  - "建立 Designer Team 5 個成員定義文件（design_lead, ui_designer, ux_researcher, design_system_specialist, doc_specialist）"
-  - "建立 .team/sre/TEAM.yaml（SRE Team 團隊定義）"
-  - "建立 SRE Team 5 個成員定義文件（sre_lead, devops_engineer, monitoring_specialist, security_specialist, doc_specialist）"
-  - "建立 .team/designer/permissions/scope_matrix.yaml（設計團隊權限矩陣）"
-  - "建立 .team/designer/permissions/lock_policy.yaml（設計團隊鎖定政策）"
-  - "建立 .team/designer/workflows/design_system_development.yaml（設計系統開發流程）"
-  - "建立 .team/designer/workflows/ui_design_review.yaml（UI 設計審查流程）"
-  - "建立 .team/designer/communication/ 目錄結構"
-  - "建立 .team/sre/permissions/scope_matrix.yaml（SRE 團隊權限矩陣）"
-  - "建立 .team/sre/permissions/lock_policy.yaml（SRE 團隊鎖定政策）"
-  - "建立 .team/sre/workflows/deployment.yaml（部署流程）"
-  - "建立 .team/sre/workflows/incident_response.yaml（應急響應流程）"
-  - "建立 .team/sre/communication/ 目錄結構"
-
-acceptance_criteria:
-  - ".team/designer/TEAM.yaml 定義了 5 個成員、協作規則與交付物標準"
-  - "所有 5 個 Designer 成員定義文件存在於 .team/designer/members/ 目錄"
-  - ".team/designer/permissions/scope_matrix.yaml 定義每個成員的權限範圍（如 UI Designer 只能寫 dashboard/src/components/design/）"
-  - ".team/designer/workflows/design_system_development.yaml 包含至少 5 個階段（需求收集 → 組件設計 → 代碼生成 → 測試 → 發布）"
-  - ".team/designer/workflows/ui_design_review.yaml 定義了設計審查流程（自檢 → 設計評審 → 開發反饋 → 迭代 → 交付）"
-  - ".team/sre/TEAM.yaml 定義了 5 個成員、協作規則與 SLA 標準"
-  - "所有 5 個 SRE 成員定義文件存在於 .team/sre/members/ 目錄"
-  - ".team/sre/permissions/scope_matrix.yaml 定義每個成員的權限範圍（如 DevOps Engineer 能寫 .infrastructure/，Security Specialist 能寫 .security/）"
-  - ".team/sre/workflows/deployment.yaml 包含完整部署流程（代碼提交 → CI/CD → 測試 → 預發布 → 生產部署 → 驗證）"
-  - ".team/sre/workflows/incident_response.yaml 定義應急響應流程（告警 → 告知 → 診斷 → 恢復 → 事後分析）"
-  - "Designer Team 和 SRE Team 的權限不會與 Frontend/Backend Team 衝突"
-  - "兩個團隊都配置了溝通頻道（slack_channel, email_list, standups）"
-
-technical_notes:
-  - "參考 .team/product_manager/、.team/backend/、.team/frontend/ 的結構設計"
-  - "Designer Team 成員權限範圍應限制在 dashboard/src/components/design/、.design/、dashboard/docs/design/ 等路徑"
-  - "SRE Team 成員權限範圍應限制在 .infrastructure/、.security/、.monitoring/、supabase/、dev/pipeline/ 等路徑"
-  - "設計系統開發流程應包含：需求收集 → 設計規範 → 組件設計 → 代碼生成 → 測試驗證"
-  - "UI 設計審查流程應包含：設計師自檢 → 團隊評審 → 前端開發反饋 → 設計迭代 → 最終交付"
-  - "部署流程應包含完整的 GitOps 實踐、藍綠部署或金絲雀部署策略"
-  - "應急響應流程應定義 MTTR（平均恢復時間）、MTTD（平均檢測時間）等 SLA 目標"
-
-estimated_hours: 8
-complexity: "high"
-
-related_tasks:
-  - "TASK_098"  # Product Manager Team 完善
-  - "TASK_099"  # Backend Team 建立
-  - "TASK_100"  # Frontend Team 建立
-  - "TASK_101"  # 可能的 QA Team（未來）
-
-metadata:
-  created_at: "2026-02-06T18:00:00+08:00"
-  created_by: "Product Manager Agent (Lead)"
-  feature: "F-009 多角色團隊協作系統"
-  tags:
-    - "team-system"
-    - "designer-team"
-    - "sre-team"
-    - "cross-functional"
-    - "workflow-design"
-

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

@@ -1,86 +0,0 @@
-# TASK_103: 整合測試與文件 - Claude Code Integration
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_103"
-title: "整合測試與文件 - Claude Code Integration"
-description: |
-  整合所有團隊系統（Product Manager、Backend、Frontend Teams），實作與 Claude Code Task tool 的整合，
-  建立端到端測試腳本與更新完整文檔。
-
-  **背景**：
-  .team 系統的各個團隊已建立完成（TASK_098-TASK_102），現在需要：
-  1. 實作與 Claude Code Task tool 的深度整合
-  2. 建立完整的端到端測試套件
-  3. 驗證多團隊並行開發場景
-  4. 測試權限衝突與解決機制
-  5. 更新專案文檔與集成指南
-
-  **目標**：
-  讓 .team 系統成為完全可用的生產級協作框架，支援 Claude Code 直接調用。
-
-priority: "P1"
-status: "pending"
-agent_type: "developer"
-source: "F-009"
-feature_ids:
-  - "F-009"
-
-dependencies:
-  - "TASK_098"
-  - "TASK_099"
-  - "TASK_100"
-  - "TASK_101"
-  - "TASK_102"
-
-scope_paths:
-  - ".team/"
-  - "dev/pipeline/"
-  - ".claude/commands/"
-  - "CLAUDE.md"
-  - ".team/README.md"
-
-requirements:
-  - "實作 Claude Code Task tool 整合層 (.team/integration/claude_task_adapter.py)"
-  - "建立完整的 E2E 測試套件 (dev/scripts/test_team_workflow.py)"
-  - "實作多團隊並行開發測試場景 (test_multi_team_parallel.py)"
-  - "實作權限衝突測試與解決機制 (test_permission_conflicts.py)"
-  - "建立 .team/README.md - 團隊系統完整指南"
-  - "更新 CLAUDE.md - 加入團隊系統呼叫說明與範例"
-  - "建立集成檢查清單 (.team/INTEGRATION_CHECKLIST.md)"
-  - "實作團隊狀態監控 (.team/orchestrator/team_monitor.py)"
-  - "建立故障排查指南 (.team/TROUBLESHOOTING.md)"
-  - "建立 MCP Server 工具定義 (.claude/mcp/team_tools.md)"
-
-acceptance_criteria:
-  - "Claude Code Task tool 能成功調用 .team 系統（通過 claude_task_adapter.py）"
-  - "E2E 測試套件涵蓋 Product Manager、Backend、Frontend Teams 的完整工作流程"
-  - "測試成功執行多團隊並行開發場景，驗證無衝突且任務順序正確"
-  - "權限衝突測試驗證系統能正確檢測並報告權限違規"
-  - ".team/README.md 包含系統架構、使用指南、API 文檔、最佳實踐"
-  - "CLAUDE.md 更新包含 /team 命令說明與各個團隊的調用示例"
-  - "集成檢查清單覆蓋所有團隊、工作流程、權限、通信模式"
-  - "所有測試通過並產生報告 (test_results_<date>.json)"
-
-technical_notes:
-  - "Claude Task tool 整合應支援異步任務回調與進度追蹤"
-  - "測試應使用臨時 .team 結構避免污染生產環境"
-  - "並行測試應驗證 LOCK_STATE.json 的正確性"
-  - "權限測試應包含邊界情況（如部分路徑匹配、萬用字符等）"
-  - "監控工具應每 10 秒檢查一次 AGENT_STATE.json 並記錄狀態轉換"
-  - "所有測試應產生可機器讀取的 JSON 報告"
-  - "故障排查指南應包含常見 10+ 個問題與解決方案"
-
-estimated_hours: 8
-complexity: "very_complex"
-
-related_tasks:
-  - "TASK_098"  # Product Manager Team
-  - "TASK_099"  # Backend Team
-  - "TASK_100"  # Frontend Team
-  - "TASK_101"  # QA/SRE Teams (假設存在)
-  - "TASK_102"  # Designer Team (假設存在)
-
-metadata:
-  created_at: "2026-02-06T18:00:00+08:00"
-  created_by: "Product Manager Agent"
-  feature: "F-009 多角色團隊協作系統"

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

@@ -1,83 +0,0 @@
-id: TASK_128
-title: 整合測試與文件 - E2E 測試與部署指南
-description: |
-  建立 Agent Coordination 系統的整合測試套件、E2E 測試、部署文件與故障排查指南。
-
-  **背景**：
-  複雜分散式系統需要完整測試與文件確保可靠性。
-
-  **目標**：
-  1. 建立整合測試（API 測試）
-  2. 建立 E2E 測試（多 Agent 協調場景）
-  3. 建立部署文件（安裝步驟、配置說明）
-  4. 建立故障排查指南（常見問題與解決方案）
-
-priority: P1
-status: pending
-agent_type: qa
-source: "User Request - Agent Coordination 系統整合"
-spec_version: "1.0.0"
-feature_ids: []
-
-dependencies:
-  - "TASK_121"
-  - "TASK_122"
-  - "TASK_123"
-  - "TASK_124"
-  - "TASK_125"
-  - "TASK_126"
-  - "TASK_127"
-
-scope_paths:
-  - "dashboard/src/app/agent-coordination/__tests__/"
-  - "dashboard/docs/agent-coordination/"
-  - "dashboard/scripts/test_agent_coordination.ps1"
-
-requirements:
-  - "建立 API 整合測試（測試所有 API Routes）"
-  - "建立 Lock 機制測試（測試鎖定、衝突、死鎖檢測）"
-  - "建立 Messaging 測試（測試訊息發送、接收、過濾）"
-  - "建立 WebSocket 測試（測試連線、推送、重連）"
-  - "建立 E2E 測試（測試多 Agent 協調場景）"
-  - "建立 SETUP.md 文件（安裝步驟）"
-  - "建立 API.md 文件（API 參考）"
-  - "建立 ARCHITECTURE.md 文件（架構說明）"
-  - "建立 TROUBLESHOOTING.md 文件（故障排查）"
-  - "建立測試執行腳本（test_agent_coordination.ps1）"
-
-acceptance_criteria:
-  - id: AC-128-1
-    type: command
-    description: "所有 API 整合測試通過"
-    command: "npm test -- agent-coordination"
-    timeout_seconds: 60
-  - id: AC-128-2
-    type: file_exists
-    description: "SETUP.md 文件已建立"
-    target: "dashboard/docs/agent-coordination/SETUP.md"
-  - id: AC-128-3
-    type: file_exists
-    description: "TROUBLESHOOTING.md 文件已建立"
-    target: "dashboard/docs/agent-coordination/TROUBLESHOOTING.md"
-  - id: AC-128-4
-    type: manual
-    description: "E2E 測試通過（3 個 Agent 並行協調場景）"
-
-technical_notes:
-  - "使用 Jest + Supertest 進行 API 測試"
-  - "使用 Socket.IO Client 進行 WebSocket 測試"
-  - "E2E 測試使用獨立測試環境（test.env）"
-  - "測試覆蓋率目標：80%+"
-  - "文件使用 Markdown 格式"
-  - "API 文件使用 OpenAPI 格式（可選）"
-
-estimated_hours: 24
-complexity: medium
-
-related_tasks:
-  - "TASK_126"
-  - "TASK_127"
-
-metadata:
-  created_at: "2026-02-07T13:00:00+08:00"
-  created_by: "Product Manager Team"