kenaz 0.3.21 → 0.3.23

package/core/.kenaz/main-memory/README.md

@@ -1,230 +0,0 @@
-# Kenaz AI 主記憶系統
-
-**版本**: 1.0.0
-**建立時間**: 2026-02-11
-**狀態**: ✅ Production Ready
-
----
-
-## 📋 概述
-
-主記憶系統（Main Memory System）是 Kenaz AI 的跨專案共享知識庫，提供：
-
-- **跨專案知識共享** - 所有 Kenaz AI 專案可存取相同的核心知識
-- **優先級繼承** - 專案記憶 > 主記憶 > 系統預設
-- **唯讀設計** - 僅開發者手動更新，避免知識污染
-- **結構化索引** - registry.json 提供完整元數據
-
----
-
-## 🗂️ 目錄結構
-
-```
-.kenaz/main-memory/
-├── README.md                 # 本文件
-├── registry.json             # 主記憶索引（25 條記憶）
-├── version.yaml              # 版本與變更日誌
-│
-├── knowledge/                # 通用軟體開發知識
-│   ├── patterns/             # 設計模式、架構模式、最佳實踐
-│   │   ├── 001_json_bom_issue.md
-│   │   ├── 001_leader_worker_pattern.md
-│   │   ├── 002_scope_path_conflict.md
-│   │   └── 002_task_dependency_resolution.md
-│   │
-│   ├── solutions/            # 常見問題解決方案
-│   │   ├── 001_json_bom_issue.md
-│   │   ├── 001_team_invocation.md
-│   │   └── 002_passive_monitoring.md
-│   │
-│   └── references/           # 技術參考、API 文檔鏈接
-│       └── 001_ppl_rules.md
-│
-└── kenaz/                    # Kenaz AI 系統專屬知識
-    ├── system/               # 系統架構與設計
-    │   └── 001_dual_track_task_system.md
-    │
-    ├── team-system/          # 團隊協作系統知識（.team）
-    │   ├── 001_team_mode_overview.md
-    │   ├── 001_team_mode_concept.md
-    │   ├── 002_leader_worker_pattern.md
-    │   ├── 002_leader_passive_monitoring.md
-    │   ├── 003_five_teams.md
-    │   ├── 003_team_communication.md
-    │   └── 004_team_communication.md
-    │
-    ├── pipeline/             # 開發流程與任務管理知識
-    │   ├── 001_task_execution_flow.md
-    │   ├── 001_task_granularity.md
-    │   ├── 002_team_priority.md
-    │   └── 003_feature_id_system.md
-    │
-    ├── rules/                # 規則系統設計與最佳實踐
-    │   ├── 001_rule_priority_system.md
-    │   ├── 001_gen_007_self_containment.md
-    │   ├── 002_agt_006_pre_check.md
-    │   └── 003_ppl_002_task_archival.md
-    │
-    ├── cortex/               # RAG 引擎與知識檢索
-    │   ├── 001_rag_engine_overview.md
-    │   └── 001_cortex_overview.md
-    │
-    └── memory-system/        # 記憶系統架構
-        └── 001_three_tier_architecture.md
-```
-
----
-
-## 🔍 記憶索引
-
-主記憶包含 **26 條記憶**，分為兩大類別：
-
-### 1. Knowledge（通用知識） - 8 條
-
-| 類別 | 數量 | 說明 |
-|------|------|------|
-| patterns | 4 | 設計模式、協作模式 |
-| solutions | 3 | 問題解決方案 |
-| references | 1 | 技術參考文檔 |
-
-**核心記憶**：
-- `K-PAT-001`: JSON BOM 編碼問題模式
-- `K-PAT-002`: Leader-Worker 協作模式
-- `K-PAT-003`: Scope Path 衝突檢測模式
-- `K-SOL-001`: JSON BOM 問題解決方案
-- `K-SOL-002`: 團隊調用標準流程
-
-### 2. Kenaz（系統專屬知識） - 18 條
-
-| 類別 | 數量 | 說明 |
-|------|------|------|
-| system | 1 | 系統架構與設計 |
-| team-system | 7 | 團隊協作系統核心知識 |
-| pipeline | 4 | 開發流程與任務管理 |
-| rules | 4 | 規則系統設計 |
-| cortex | 2 | RAG 引擎與知識檢索 |
-
-**核心記憶**：
-- `KZ-SYS-001`: 雙軌制任務系統 ⭐ 新增
-- `KZ-TEAM-001`: 團隊模式系統概覽
-- `KZ-TEAM-004`: Leader 被動監控機制
-- `KZ-PPL-001`: 任務執行完整流程
-- `KZ-RULE-001`: 規則優先級系統設計
-- `KZ-RULE-002`: GEN-007 專案自包含原則
-
-詳細索引請參考 `registry.json`。
-
----
-
-## 🔗 與 Cortex RAG 整合
-
-主記憶系統透過 `.kenaz/cortex.yaml` 整合到 Kenaz Cortex RAG 引擎。
-
-### 優先級繼承機制
-
-查詢記憶時遵循以下優先級：
-
-```
-1. 專案記憶 (.memory/)          - 當前專案專屬
-   ↓
-2. 主記憶 (.kenaz/main-memory/) - 跨專案共享
-   ↓
-3. 系統預設 (Claude Code 內建) - 全局
-```
-
-**規則**：優先級高的記憶會覆蓋優先級低的記憶。
-
-### 查詢接口
-
-```yaml
-# 搜尋所有層級
-cortex_search(query, scope=["project", "main", "system"])
-
-# 僅搜尋主記憶（Kenaz 系統知識）
-cortex_search(query, scope=["main"])
-
-# 僅搜尋專案記憶
-cortex_search(query, scope=["project"])
-```
-
----
-
-## 🔒 存取控制
-
-### 讀取權限
-- ✅ 所有 Agent 可讀取
-- ✅ 所有開發者可讀取
-
-### 寫入權限
-- ✅ 僅開發者手動更新
-- ❌ Agent 不可自動修改
-
-**理由**：主記憶為穩定的核心知識，避免自動修改導致知識污染。
-
----
-
-## 📊 統計數據
-
-| 項目 | 數量 |
-|------|------|
-| 總記憶數 | 26 |
-| Knowledge 記憶 | 8 |
-| Kenaz 記憶 | 18 |
-| 目錄數 | 9 |
-| 索引條目 | 26 |
-
----
-
-## 🚀 使用指南
-
-### 開發者更新記憶
-
-1. 在對應類別目錄建立 Markdown 文件：
-   ```bash
-   # 範例：新增通用模式
-   touch .kenaz/main-memory/knowledge/patterns/003_new_pattern.md
-   ```
-
-2. 撰寫記憶內容（包含標題、標籤、描述、範例）
-
-3. 更新 `registry.json` 新增索引條目
-
-4. 更新 `version.yaml` 記錄變更
-
-5. 建立 Git commit
-
-### Agent 讀取記憶
-
-Agent 透過 Kenaz Cortex RAG 引擎自動存取主記憶，無需手動操作。
-
-查詢會自動遵循優先級繼承規則。
-
----
-
-## 📚 相關文檔
-
-- `.kenaz/cortex.yaml` - RAG 引擎配置
-- `.kenaz/docs/tools/RAG_INTEGRATION_GUIDE.md` - RAG 整合指南
-- `dev/pipeline/tasks/TASK_158_*.yaml` - 記憶系統架構任務
-- `dev/pipeline/tasks/TASK_161_*.yaml` - 主記憶系統建立任務
-
----
-
-## 📝 變更日誌
-
-詳細變更日誌請參考 `version.yaml`。
-
-### v1.0.0 (2026-02-11)
-- ✨ 建立主記憶系統基礎架構
-- ✨ 建立 knowledge/ 和 kenaz/ 子系統
-- ✨ 實現優先級繼承機制
-- ✨ 建立 registry.json 索引系統
-- ✨ 整合 Kenaz Cortex RAG 引擎
-- ✨ 初始 25 條核心記憶
-
----
-
-**維護者**: Kenaz AI Development Team
-**更新頻率**: 按需更新
-**編碼**: UTF-8
-**格式**: Markdown

package/core/.kenaz/main-memory/kenaz/cortex/001_cortex_overview.md

@@ -1,168 +0,0 @@
-# Kenaz Cortex RAG 引擎概述
-
-**ID**: KNZ-CORTEX-001
-**分類**: cortex
-**標籤**: #rag #retrieval #code-search #semantic-search
-
-## 核心概念
-
-Kenaz Cortex 是專為程式碼專案設計的 RAG（Retrieval-Augmented Generation）引擎，提供語義檢索和智能上下文生成。
-
-## 主要功能
-
-### 1. 語義代碼搜索
-```bash
-# 搜索相關代碼
-kenaz-cortex search "用戶認證邏輯"
-
-# 返回最相關的代碼片段
-# 基於語義相似度，不僅是關鍵字匹配
-```
-
-### 2. 智能 Context 生成
-```bash
-# 生成專案 Context
-kenaz-cortex context
-
-# 自動選擇策略：
-# - 小型專案（<40k tokens）→ 全量 Context
-# - 大型專案（>40k tokens）→ RAG 模式
-```
-
-### 3. AST 切片器
-**特點**：
-- 基於 AST（抽象語法樹）切片代碼
-- 保留語義完整性
-- 支援多種語言（Python, JavaScript, TypeScript）
-
-**切片策略**：
-```
-文件 → AST 解析 → 函數/類切片 → 向量化 → 存儲
-```
-
-### 4. 增量同步
-**Git 整合**：
-```bash
-# 只索引變更的文件
-git diff --name-only | kenaz-cortex index --incremental
-```
-
-**優勢**：
-- 快速更新索引
-- 節省計算資源
-- 保持索引最新
-
-## 架構組件
-
-```
-kenaz-cortex/
-├── src/cortex/
-│   ├── chunker/      # AST 切片器
-│   ├── vectordb/     # ChromaDB 整合
-│   ├── sync/         # Git 增量同步
-│   ├── api/          # 語義檢索 API
-│   └── context/      # 混合 Context 策略
-```
-
-## 使用場景
-
-### 場景 1：代碼搜索
-```bash
-# 問題：「認證 API 在哪裡？」
-kenaz-cortex search "authentication API implementation"
-
-# 返回：
-# 1. src/api/auth.ts (95% 相關)
-# 2. src/middleware/auth.ts (88% 相關)
-# 3. tests/auth.test.ts (75% 相關)
-```
-
-### 場景 2：智能上下文
-```bash
-# 任務：修改用戶登入流程
-kenaz-cortex context --focus "user login flow"
-
-# 返回相關文件的上下文：
-# - src/api/auth.ts
-# - src/components/LoginForm.tsx
-# - src/services/auth.service.ts
-# - docs/auth-flow.md
-```
-
-### 場景 3：文檔查詢
-```bash
-# 問題：「如何使用 Formation System？」
-kenaz-cortex search --type=docs "formation system usage guide"
-
-# 返回：
-# 1. .formation/tools/README.md
-# 2. .formation/solo/strategy.yaml
-# 3. .formation/squad/strategy.yaml
-```
-
-## MCP Server 整合
-
-### Claude Code 自動使用
-
-當設置 MCP Server 後，Claude Code 會自動使用以下工具：
-
-| 工具 | 用途 |
-|------|------|
-| `cortex_search` | 語義代碼搜索 |
-| `cortex_context` | 專案結構 Context |
-| `cortex_file_chunks` | 文件切片查詢 |
-| `cortex_status` | RAG 引擎狀態 |
-
-### 自動切換策略
-
-```javascript
-// 小型專案
-if (totalTokens < 40000 && fileCount < 20) {
-  return fullContext();  // 全量 Context
-}
-
-// 大型專案
-else {
-  return ragContext();   // RAG 模式
-}
-```
-
-## 設置步驟
-
-### 1. 安裝 Cortex
-```bash
-.\dev\scripts\SETUP_RAG.bat
-```
-
-### 2. 配置 MCP Server
-```bash
-.\dev\scripts\setup_mcp.ps1
-```
-
-### 3. 索引專案
-```bash
-kenaz-cortex index
-```
-
-### 4. 測試搜索
-```bash
-kenaz-cortex search "test query"
-```
-
-## 效能優化
-
-### 索引優化
-- **增量索引**：只處理變更文件
-- **並行處理**：多執行緒向量化
-- **快取策略**：常用查詢結果快取
-
-### 查詢優化
-- **向量快取**：快取常用向量
-- **Top-K 限制**：只返回最相關的 K 個結果
-- **混合檢索**：結合關鍵字和語義搜索
-
-## 參考資料
-
-- `kenaz-cortex/README.md` - 完整文檔
-- `dev/scripts/SETUP_RAG.bat` - 設置腳本
-- `dev/scripts/setup_mcp.ps1` - MCP 配置

package/core/.kenaz/main-memory/kenaz/cortex/001_rag_engine_overview.md

@@ -1,30 +0,0 @@
-# RAG Engine Overview - Kenaz Cortex RAG 引擎概述
-
-**記憶 ID**: kenaz/cortex/001
-**類型**: System Overview
-**標籤**: #cortex #rag #kenaz-ai
-**建立時間**: 2026-02-10
-
----
-
-## 核心概念
-
-Kenaz Cortex 是一個專為代碼庫設計的 RAG（Retrieval-Augmented Generation）引擎。
-
-## 主要功能
-
-1. **AST 切片器** - 智能代碼切片
-2. **向量資料庫** - ChromaDB 整合
-3. **增量同步** - Git 增量同步
-4. **語義檢索** - 語義代碼搜索
-5. **混合策略** - 小專案全量、大專案 RAG
-
-## 自動切換策略
-
-- **小型專案**（<40k tokens, <20 files）→ 全量 Context
-- **大型專案**（>40k tokens 或 >20 files）→ RAG 模式
-
-## 參考
-
-- `dev/scripts/SETUP_RAG.bat` - 設置腳本
-- `.kenaz/docs/tools/RAG_INTEGRATION_GUIDE.md`