kenaz 0.3.21 → 0.3.23

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

@@ -1,141 +0,0 @@
-# TASK_146: 建立統一文檔網站（docs.kenaz.ai）
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_146"
-title: "Dashboard 整合統一文檔模組"
-description: |
-  根據 Strategy Team 建議（Phase 1 基礎優化 P0）+ 用戶回饋，
-  將統一文檔整合進 Dashboard，提供互動式學習體驗。
-
-  目標：讓新用戶在 5 分鐘內完成環境設置並執行第一個任務。
-
-  背景：
-  - 當前文檔分散在各子系統（.team/, Pipeline, Cortex, Dashboard）
-  - 新用戶入門門檻高（2-3 小時配置時間）
-  - 缺少統一的文檔入口和搜尋功能
-  - Strategy Team 評估建議優先降低入門門檻（ROI 最高）
-
-  設計變更（2026-02-09）：
-  - ❌ 原方案：VitePress 獨立網站 → 體驗分散
-  - ✅ 新方案：整合進 Dashboard → 統一體驗 + 互動式功能
-
-priority: "P0"
-status: "pending"
-agent_type: "developer"
-source: "Strategy Team 建議（Phase 1 優化）"
-feature_ids: []
-
-dependencies: []
-
-scope_paths:
-  - "dashboard/src/app/docs/"          # Docs 主頁面
-  - "dashboard/src/components/docs/"   # 文檔組件
-  - "dashboard/content/docs/"          # MDX 文檔內容
-  - "dashboard/src/lib/docs/"          # 文檔工具函數
-
-requirements:
-  - "在 Dashboard 新增 /docs 路由和頁面"
-  - "使用 Next.js + MDX 或 Nextra 框架"
-  - "5 分鐘互動式快速開始指南（可執行範例）"
-  - "整合所有子系統文檔（.team, Pipeline, Cortex, Dashboard）"
-  - "API Playground（可測試 Team API、CLI 命令）"
-  - "範例執行器（一鍵運行範例代碼）"
-  - "Team 系統可視化（展示 5 個團隊結構）"
-  - "即時狀態顯示（當前專案的實際狀態）"
-  - "搜尋功能（整合 Dashboard 搜尋）"
-  - "至少 10 個互動式範例"
-
-acceptance_criteria:
-  - "AC-146-1: 新用戶可在 Dashboard 內 5 分鐘完成環境設置並執行第一個任務"
-  - "AC-146-2: 所有主要功能都有互動式文檔（.team, Pipeline, 至少 2 個 Agent）"
-  - "AC-146-3: 整合 Dashboard 搜尋，可搜尋文檔內容"
-  - "AC-146-4: 文檔結構清晰，包含 Quick Start, Guides, API, Examples, Playground"
-  - "AC-146-5: API Playground 可測試至少 3 個 Team API 端點"
-  - "AC-146-6: 範例執行器可一鍵運行至少 5 個範例"
-  - "AC-146-7: Team 可視化展示 5 個團隊的成員與工作流程"
-  - "AC-146-8: Dashboard /docs 路由可正常訪問"
-
-technical_notes: |
-  技術選型：
-  方案 A（推薦）：Next.js + Nextra
-  - 優點：完整的文檔框架，內建搜尋、深色模式、MDX 支援
-  - 整合：與 Dashboard 共用 Next.js 環境
-  - 安裝：npm install nextra nextra-theme-docs
-
-  方案 B：Next.js + MDX + 自定義
-  - 優點：完全控制，可深度整合 Dashboard 功能
-  - 整合：使用 @next/mdx，自建文檔系統
-  - 安裝：npm install @next/mdx @mdx-js/loader @mdx-js/react
-
-  目錄結構（Dashboard 內）：
-  dashboard/
-  ├── src/
-  │   ├── app/
-  │   │   └── docs/                     # Docs 路由
-  │   │       ├── page.tsx              # /docs 首頁
-  │   │       ├── quick-start/          # /docs/quick-start
-  │   │       │   └── page.tsx
-  │   │       ├── api/
-  │   │       │   ├── playground/       # API Playground
-  │   │       │   └── reference/        # API 參考
-  │   │       ├── examples/
-  │   │       │   └── runner/           # 範例執行器
-  │   │       └── team/
-  │   │           └── visualizer/       # Team 可視化
-  │   ├── components/docs/
-  │   │   ├── CodeRunner.tsx            # 代碼執行組件
-  │   │   ├── APIPlayground.tsx         # API 測試組件
-  │   │   ├── TeamVisualizer.tsx        # Team 圖表組件
-  │   │   ├── SearchBar.tsx             # 搜尋組件
-  │   │   └── TableOfContents.tsx       # 目錄組件
-  │   └── lib/docs/
-  │       ├── content-loader.ts         # MDX 內容載入
-  │       └── search-index.ts           # 搜尋索引
-  └── content/docs/                     # MDX 文檔內容
-      ├── getting-started/
-      ├── guides/
-      ├── api/
-      └── examples/
-
-  核心功能：
-  1. API Playground：
-     - 即時測試 Team API（/api/team/execute）
-     - 顯示請求/回應
-     - 支援認證
-
-  2. 範例執行器：
-     - 一鍵運行範例代碼
-     - 即時顯示輸出
-     - 可修改參數
-
-  3. Team 可視化：
-     - 使用 D3.js 或 Recharts 展示團隊結構
-     - 互動式成員關係圖
-     - 工作流程動畫
-
-  4. 即時狀態：
-     - 顯示當前專案的實際任務狀態
-     - 即時更新（WebSocket）
-
-  整合點：
-  - 導航欄新增 "Docs" 連結
-  - 搜尋整合（統一搜尋所有內容）
-  - 主題同步（深色/淺色模式）
-  - 狀態共享（使用 Dashboard 的狀態管理）
-
-estimated_hours: 32
-complexity: "high"
-
-related_to_strategy: "Phase 1 - Month 1-2 基礎優化（P0）"
-
-metadata:
-  created_at: "2026-02-09T17:00:00+08:00"
-  created_by: "Strategy Team 建議"
-  updated_at: "2026-02-09T18:30:00+08:00"
-  design_change: "改為 Dashboard 整合方案（用戶回饋）"
-  strategy_report: ".team/strategy/reports/kenazai_optimization_recommendation.md"
-  related_commits:
-    - "51bd350"  # Strategy Team 評估報告
-    - "2465ff4"  # .matrix 暫停開發存檔點
-    - "00b2c16"  # VitePress 實作（已回退）
-    - "88d659d"  # Revert VitePress，改為 Dashboard 整合

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

@@ -1,76 +0,0 @@
-# TASK_147: 建立 Pipeline 執行規則文檔
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_147"
-title: "建立 Pipeline 執行規則文檔"
-description: |
-  建立 `.rule/pipeline/task-execution.yaml` 規則文檔，定義完整的 Pipeline 任務執行規範。
-
-  背景：
-  - 剛完成與用戶的開發流程討論，確認了 12 個核心流程規則
-  - 需要將這些規則文檔化到 .rule/ 系統
-  - 此規則將成為 Lead Agent 和所有 Agent 執行任務的標準
-
-  目標：
-  - 建立 .rule/pipeline/ 目錄
-  - 建立 task-execution.yaml 規則文檔
-  - 定義 12 條核心規則（任務拆分、依賴、並行、Team 選擇等）
-  - 提供實際範例與最佳實踐
-
-priority: "P0"
-status: "pending"
-agent_type: "developer_team"
-source: "F-016"
-feature_ids:
-  - "F-016"
-
-dependencies: []
-
-scope_paths:
-  - ".rule/pipeline/"
-  - ".rule/INDEX.yaml"
-
-requirements:
-  - "建立 .rule/pipeline/ 目錄"
-  - "建立 task-execution.yaml 規則文檔"
-  - "定義 12 條核心規則"
-  - "更新 .rule/INDEX.yaml（註冊新規則文件）"
-  - "規則必須涵蓋：任務拆分、依賴管理、並行執行、Team 選擇、Feature ID、失敗處理、Git commit"
-
-acceptance_criteria:
-  - ".rule/pipeline/task-execution.yaml 已建立，包含至少 12 條規則"
-  - "每條規則包含：id, title, description, rationale, examples"
-  - "規則涵蓋完整的任務執行流程（從拆分到完成）"
-  - ".rule/INDEX.yaml 已更新，包含 pipeline/task-execution.yaml"
-  - "YAML 語法正確（可被解析）"
-  - "規則符合用戶確認的開發流程"
-
-technical_notes:
-  - "參考現有規則格式：.rule/general/*.yaml"
-  - "12 條核心規則：
-      1. 任務拆分粒度標準（15-20 分鐘）
-      2. 依賴管理規則（dependencies 字段）
-      3. 並行執行策略（自動判斷）
-      4. Team vs 單一 Agent 選擇（優先 Team）
-      5. agent_type 命名規則（xxx_team）
-      6. Feature ID 自動分配
-      7. 工作啟動流程（先展示計劃）
-      8. 任務失敗處理（立即報告）
-      9. Git commit 策略（按階段）
-      10. 任務完成後續動作（自動化）
-      11. scope_paths 衝突檢測
-      12. 驗收標準驗證"
-  - "規則 ID 格式：PPL-001, PPL-002, ..."
-
-estimated_hours: 0.25
-complexity: "simple"
-
-related_tasks:
-  - "TASK_148"
-  - "TASK_149"
-  - "TASK_150"
-
-metadata:
-  created_at: "2026-02-09T20:30:00+08:00"
-  created_by: "Lead Agent"
-  discussion_summary: "用戶確認的統一開發流程，12 個核心規則"

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

@@ -1,77 +0,0 @@
-# TASK_148: 更新 CLAUDE.md 工作流程
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_148"
-title: "更新 CLAUDE.md 工作流程說明"
-description: |
-  更新 CLAUDE.md 中的工作流程章節，新增 Lead Agent 開發流程詳細說明。
-
-  背景：
-  - CLAUDE.md 是專案級指令文檔，所有 Agent 都會讀取
-  - 當前工作流程說明過於簡化，缺少 Lead Agent 的詳細執行流程
-  - 需要整合剛確認的 12 條核心規則
-
-  目標：
-  - 更新「工作流程」章節
-  - 新增「Lead Agent 開發流程詳細說明」章節
-  - 更新 Agent 調用模式說明（Team 優先）
-  - 引用 .rule/pipeline/task-execution.yaml
-
-priority: "P0"
-status: "pending"
-agent_type: "developer_team"
-source: "F-016"
-feature_ids:
-  - "F-016"
-
-dependencies:
-  - "TASK_147"
-
-scope_paths:
-  - "CLAUDE.md"
-
-requirements:
-  - "更新「工作流程」章節，強調 Team 模式優先"
-  - "新增「Lead Agent 開發流程」章節（完整 12 步流程）"
-  - "更新 Agent 調用模式說明（單一 vs Team）"
-  - "新增任務拆分與並行執行說明"
-  - "引用 .rule/pipeline/task-execution.yaml 規則"
-  - "提供實際範例（如搜尋功能改進的流程）"
-
-acceptance_criteria:
-  - "CLAUDE.md 包含完整的 Lead Agent 工作流程（12 步）"
-  - "工作流程章節明確說明 Team 模式優先"
-  - "包含至少 1 個完整範例（從需求到執行）"
-  - "引用 .rule/pipeline/task-execution.yaml 規則"
-  - "Markdown 格式正確，結構清晰"
-  - "與 TASK_147 建立的規則一致"
-
-technical_notes:
-  - "參考 CLAUDE.md 現有格式與結構"
-  - "Lead Agent 12 步流程：
-      1. 接收用戶需求
-      2. 自動分配 Feature ID
-      3. 拆分任務（15-20 分鐘）
-      4. 判斷 agent_type（優先 xxx_team）
-      5. 分析依賴與路徑衝突
-      6. 規劃 commit 策略
-      7. 展示計劃
-      8. 等待確認
-      9. 建立任務卡
-      10. 啟動執行
-      11. 監控與自動化
-      12. 失敗處理"
-  - "新增章節建議位置：「工作流程」之後"
-
-estimated_hours: 0.33
-complexity: "simple"
-
-related_tasks:
-  - "TASK_147"
-  - "TASK_149"
-  - "TASK_150"
-
-metadata:
-  created_at: "2026-02-09T20:30:00+08:00"
-  created_by: "Lead Agent"
-  discussion_summary: "更新 CLAUDE.md 以反映新的開發流程"

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

@@ -1,63 +0,0 @@
-# TASK_149: 修復 Next.js MDX loader 序列化錯誤
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_149"
-title: "修復 Next.js MDX loader 序列化錯誤"
-description: |
-  修復 dashboard/ 專案中 Next.js MDX loader 無法序列化 options 的錯誤。
-
-  錯誤訊息：
-  "Error: loader D:\repo\side\ava\KenazAI\dashboard\node_modules\@next\mdx\mdx-js-loader.js
-  for match "{*,next-mdx-rule}" does not have serializable options."
-
-  問題根因：
-  - Next.js 15+ 對配置要求更嚴格，plugin 函數無法序列化
-  - 當前 next.config.ts 直接傳入 remarkGfm 和 rehypeHighlight 插件
-
-  解決方案：
-  - 將插件配置從 next.config.ts 移除
-  - 改用 next.config.mjs 格式或將插件配置移至運行時處理
-
-priority: "P0"
-status: "pending"
-agent_type: "developer"
-source: "Bug Report - User"
-feature_ids: ["F-006"]
-
-dependencies: []
-
-scope_paths:
-  - "dashboard/next.config.ts"
-  - "dashboard/mdx-components.tsx"
-  - "dashboard/src/app/docs/"
-
-requirements:
-  - "移除 next.config.ts 中的 remarkPlugins 和 rehypePlugins 配置"
-  - "將插件配置移至 mdx-components.tsx 或改用 .mjs 格式"
-  - "確保現有 2 個 MDX 文檔頁面能正常渲染"
-  - "保留 GFM（表格、任務列表）和語法高亮功能"
-  - "驗證 npm run dev 啟動無錯誤"
-
-acceptance_criteria:
-  - "執行 npm run dev 不再出現序列化錯誤"
-  - "MDX 文檔頁面 /docs/quick-start 和 /docs/guides/agent-coordination/setup 正常顯示"
-  - "GFM 功能正常（表格、任務列表等）"
-  - "代碼區塊語法高亮功能正常"
-  - "建立至少 1 個 Git commit（格式：[TASK_148] 簡短描述）"
-
-technical_notes:
-  - "參考 Next.js 15+ MDX 配置最佳實踐"
-  - "可參考方案：改用 next.config.mjs 或動態導入插件"
-  - "測試文件：dashboard/src/app/docs/quick-start/page.mdx"
-  - "確保不影響 Electron/Tauri 靜態導出功能"
-
-estimated_hours: 0.33
-complexity: "simple"
-
-related_tasks: []
-
-metadata:
-  created_at: "2026-02-09T18:00:00+08:00"
-  created_by: "PM Lead Agent"
-  bug_severity: "critical"
-  blocks_development: true

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

@@ -1,77 +0,0 @@
-# TASK_149: 更新 .team 系統文檔
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_149"
-title: "更新 .team 系統文檔"
-description: |
-  更新 .team 系統文檔，說明 agent_type 命名規則與 run-team.js 使用方式。
-
-  背景：
-  - .team 系統支援 Leader + Team 模式
-  - 當前文檔缺少 agent_type 命名規則說明（xxx_team）
-  - run-team.js 需要說明 _team 後綴自動映射機制
-
-  目標：
-  - 更新 .team/COMPLETE_README.md
-  - 更新 .team/tools/README.md
-  - 新增 agent_type 命名規則說明
-  - 新增任務完成後自動化流程說明
-
-priority: "P0"
-status: "pending"
-agent_type: "developer_team"
-source: "F-016"
-feature_ids:
-  - "F-016"
-
-dependencies:
-  - "TASK_147"
-
-scope_paths:
-  - ".team/COMPLETE_README.md"
-  - ".team/tools/README.md"
-
-requirements:
-  - "更新 .team/COMPLETE_README.md 團隊調用流程"
-  - "新增 agent_type 命名規則章節（developer vs developer_team）"
-  - "更新 .team/tools/README.md run-team.js 使用說明"
-  - "說明 _team 後綴自動映射機制（developer_team → developer/）"
-  - "新增任務完成後自動化流程說明"
-  - "提供 agent_type 選擇決策樹"
-
-acceptance_criteria:
-  - ".team/COMPLETE_README.md 包含 agent_type 命名規則說明"
-  - ".team/tools/README.md 包含 _team 後綴映射說明"
-  - "文檔包含至少 1 個完整範例（任務卡 → 調用 → 執行）"
-  - "說明何時使用 Team 模式 vs 單一 Agent"
-  - "文檔與 TASK_147 規則一致"
-  - "Markdown 格式正確"
-
-technical_notes:
-  - "agent_type 命名規則：
-      - developer = 單一 Developer Agent
-      - developer_team = Developer Team（Leader + Workers）
-      - 預設優先使用 xxx_team（根據用戶確認）"
-  - "run-team.js 調用範例：
-      node .team/tools/run-team.js --team=developer_team --task=TASK_147
-      # 內部映射到 .team/developer/"
-  - "任務完成後自動化：
-      1. 驗證驗收標準
-      2. 移動到 completed/
-      3. 更新 PROGRESS.md
-      4. 檢查依賴鏈
-      5. 階段完成時 Git commit
-      6. 啟動下一個任務"
-
-estimated_hours: 0.3
-complexity: "simple"
-
-related_tasks:
-  - "TASK_147"
-  - "TASK_148"
-  - "TASK_150"
-
-metadata:
-  created_at: "2026-02-09T20:30:00+08:00"
-  created_by: "Lead Agent"
-  discussion_summary: "更新 .team 文檔以支援新的命名規則與自動化流程"

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

@@ -1,82 +0,0 @@
-# TASK_150: 建立 Pipeline 完整使用指南
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_150"
-title: "建立 Pipeline 完整使用指南"
-description: |
-  建立完整的 Pipeline 使用指南，整合所有文檔與實際範例。
-
-  背景：
-  - dev/pipeline/ 缺少完整的使用指南
-  - 當前只有 PROGRESS.md 和任務卡
-  - 需要整合 TASK_147、TASK_148、TASK_149 的所有內容
-
-  目標：
-  - 建立 dev/pipeline/WORKFLOW_GUIDE.md
-  - 提供完整的 Pipeline 使用指南
-  - 包含實際範例（如搜尋功能改進的完整流程）
-  - 提供任務卡模板與最佳實踐
-
-priority: "P0"
-status: "pending"
-agent_type: "developer_team"
-source: "F-016"
-feature_ids:
-  - "F-016"
-
-dependencies:
-  - "TASK_147"
-  - "TASK_148"
-  - "TASK_149"
-
-scope_paths:
-  - "dev/pipeline/WORKFLOW_GUIDE.md"
-  - "dev/pipeline/README.md"
-
-requirements:
-  - "建立 dev/pipeline/WORKFLOW_GUIDE.md"
-  - "包含完整的 Pipeline 工作流程說明"
-  - "提供至少 3 個實際範例（完整流程）"
-  - "提供任務卡 YAML 模板"
-  - "包含最佳實踐與常見問題 FAQ"
-  - "更新 dev/pipeline/README.md（引用新指南）"
-  - "整合 TASK_147、TASK_148、TASK_149 的內容"
-
-acceptance_criteria:
-  - "WORKFLOW_GUIDE.md 已建立，包含至少 3 個完整範例"
-  - "文檔包含任務卡 YAML 模板（可直接複製使用）"
-  - "包含 FAQ 章節（至少 5 個常見問題）"
-  - "README.md 已更新，引用 WORKFLOW_GUIDE.md"
-  - "範例涵蓋：簡單任務、複雜任務、並行任務"
-  - "文檔與 TASK_147 規則一致"
-  - "Markdown 格式正確，結構清晰"
-
-technical_notes:
-  - "3 個範例建議：
-      1. 簡單任務：單一文件修改（1 個任務卡）
-      2. 複雜任務：搜尋功能改進（3 個任務卡，依賴鏈）
-      3. 並行任務：多文檔更新（2 個任務卡，並行執行）"
-  - "FAQ 建議主題：
-      1. 如何決定任務拆分粒度？
-      2. 何時使用 Team vs 單一 Agent？
-      3. 如何處理任務失敗？
-      4. 如何管理依賴關係？
-      5. 如何判斷任務可並行？"
-  - "任務卡模板包含所有必需字段（id, title, description, priority, status, agent_type, dependencies, scope_paths, requirements, acceptance_criteria, estimated_hours, complexity）"
-  - "整合參考：
-      - TASK_147: .rule/pipeline/task-execution.yaml
-      - TASK_148: CLAUDE.md Lead Agent 流程
-      - TASK_149: .team 文檔"
-
-estimated_hours: 0.33
-complexity: "simple"
-
-related_tasks:
-  - "TASK_147"
-  - "TASK_148"
-  - "TASK_149"
-
-metadata:
-  created_at: "2026-02-09T20:30:00+08:00"
-  created_by: "Lead Agent"
-  discussion_summary: "建立完整的 Pipeline 使用指南，整合所有文檔"

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

@@ -1,49 +0,0 @@
-# TASK_164: 修復 SmartContextSwitch bug + cortex_context 工具
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_164"
-title: "修復 SmartContextSwitch bug + cortex_context MCP 工具"
-description: |
-  cortex_context MCP 工具目前壞了，報錯：
-  'SmartContextSwitch' object has no attribute 'get_context_mode'
-
-  需要修復此 bug 並確保 V1/V2 Context 模式都能正常運作。
-  這是後續 RAG 優化任務的前置條件。
-
-priority: "P0"
-status: "pending"
-agent_type: "backend"
-source: "F-018"
-feature_ids:
-  - "F-018"
-
-dependencies: []
-
-scope_paths:
-  - "kenaz-cortex/src/cortex/context/smart_switch.py"
-  - "kenaz-cortex/src/cortex/mcp/server.py"
-  - "kenaz-cortex/src/cortex/context/__init__.py"
-
-requirements:
-  - "修復 SmartContextSwitch 類中 get_context_mode 屬性/方法缺失問題"
-  - "確保 cortex_context MCP 工具正常返回結果"
-  - "驗證 V1 模式（全量 Context）和 V2 模式（精簡 + RAG）都能正常切換"
-  - "確保 threshold_tokens 和 threshold_files 的切換邏輯正確"
-
-acceptance_criteria:
-  - "cortex_context MCP 工具不再報 AttributeError"
-  - "小型專案（< 40k tokens, < 20 files）返回全量 Context"
-  - "大型專案（> 40k tokens 或 > 20 files）返回精簡 Context + RAG 提示"
-  - "cortex_status 工具正常返回索引統計"
-
-technical_notes:
-  - "SmartContextSwitch 類定義在 kenaz-cortex/src/cortex/context/smart_switch.py"
-  - "MCP server 定義在 kenaz-cortex/src/cortex/mcp/server.py"
-  - "可能是方法名稱變更但 MCP server 未同步更新"
-
-estimated_hours: 2
-complexity: "simple"
-
-metadata:
-  created_at: "2026-02-12T00:00:00+08:00"
-  created_by: "PM Lead"

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

@@ -1,53 +0,0 @@
-# TASK_165: Universal Ctags 整合 - Symbol Index 建立
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_165"
-title: "Universal Ctags 整合 - Symbol Index 建立"
-description: |
-  整合 Universal Ctags 工具，為專案建立結構化的符號索引。
-  讓 Agent 能不經向量搜索就精確定位函數/類/介面定義。
-
-  參考：Greptile/Continue 的 AST 輔助搜索方式。
-
-priority: "P1"
-status: "pending"
-agent_type: "backend"
-source: "F-018"
-feature_ids:
-  - "F-018"
-
-dependencies:
-  - "TASK_164"
-
-scope_paths:
-  - "kenaz-cortex/src/cortex/symbols/"
-  - "kenaz-cortex/src/cortex/sync/git_sync.py"
-
-requirements:
-  - "建立 kenaz-cortex/src/cortex/symbols/ 模組"
-  - "整合 Universal Ctags 執行引擎（subprocess 調用 ctags）"
-  - "解析 ctags JSON 輸出為結構化 SymbolEntry dataclass"
-  - "建立 SymbolIndex 類：支援 search_by_name(), search_by_kind(), get_file_symbols()"
-  - "支援增量更新（Git diff 觸發，只重新索引變更文件）"
-  - "儲存索引到 .cortex/symbols.json"
-  - "處理 ctags 未安裝的 graceful degradation"
-
-acceptance_criteria:
-  - "能提取 Python/TypeScript/JavaScript 的函數、類、介面、type alias 定義"
-  - "按名稱搜索響應時間 < 10ms"
-  - "Git commit 後自動增量更新符號索引"
-  - ".cortex/symbols.json 格式正確且可被其他模組讀取"
-  - "ctags 未安裝時提供友好錯誤訊息而非崩潰"
-
-technical_notes:
-  - "使用 ctags --output-format=json --fields=+nKS -R"
-  - "SymbolEntry 包含：name, kind, file, line, scope, signature"
-  - "整合到 git_sync.py 的 post-commit hook 觸發增量更新"
-  - "Windows 環境需要考慮 ctags 路徑問題"
-
-estimated_hours: 6
-complexity: "medium"
-
-metadata:
-  created_at: "2026-02-12T00:00:00+08:00"
-  created_by: "PM Lead"

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

@@ -1,48 +0,0 @@
-# TASK_166: Symbol Search MCP 工具
-# Schema: dev/schemas/TASK.schema.json
-
-id: "TASK_166"
-title: "Symbol Search MCP 工具"
-description: |
-  為 MCP server 新增 cortex_symbols 工具，讓 Claude Code 能精確搜索
-  函數、類、介面等符號定義，無需向量搜索即可快速定位。
-
-priority: "P1"
-status: "pending"
-agent_type: "backend"
-source: "F-018"
-feature_ids:
-  - "F-018"
-
-dependencies:
-  - "TASK_165"
-
-scope_paths:
-  - "kenaz-cortex/src/cortex/mcp/server.py"
-  - "kenaz-cortex/src/cortex/symbols/"
-
-requirements:
-  - "新增 cortex_symbols MCP 工具到 server.py"
-  - "支援參數：query（名稱/正則模式）、kind（function/class/interface/type_alias）、file、language"
-  - "返回格式化結果：名稱、類型、檔案:行號、函數簽名"
-  - "整合到 cortex_context 的 Layer 2（Architecture）輸出中"
-  - "支援模糊搜索和精確搜索"
-
-acceptance_criteria:
-  - "cortex_symbols 工具可在 Claude Code MCP 中正常調用"
-  - "搜索 'SmartContextSwitch' 返回正確的類定義位置和行號"
-  - "搜索 kind=interface 返回專案中所有介面定義"
-  - "結果包含行號，格式為 file_path:line_number"
-  - "空結果時返回友好提示"
-
-technical_notes:
-  - "複用 TASK_165 建立的 SymbolIndex 類"
-  - "MCP 工具定義格式參考現有 cortex_search 的實現"
-  - "考慮大型專案的結果分頁或 top_k 限制"
-
-estimated_hours: 4
-complexity: "simple"
-
-metadata:
-  created_at: "2026-02-12T00:00:00+08:00"
-  created_by: "PM Lead"