kenaz 0.3.18 → 0.3.20

package/core/.failure/tools/log_failure.ps1

@@ -1,474 +0,0 @@
-# log_failure.ps1
-# 自動化建立失敗記錄文件的 PowerShell 腳本
-
-<#
-.SYNOPSIS
-    建立新的失敗記錄到 .failure/ 系統
-
-.DESCRIPTION
-    此腳本幫助快速記錄失敗經驗，包括：
-    - 自動生成 FAIL-XXX ID
-    - 根據分類選擇正確的目錄
-    - 使用標準模板建立 YAML 文件
-    - 自動更新 INDEX.yaml 的統計數據和 load_order
-
-.PARAMETER Category
-    失敗分類：agent_execution, code_quality, architecture, pipeline, data_integrity
-
-.PARAMETER Title
-    失敗標題（簡短描述）
-
-.PARAMETER Severity
-    嚴重程度：critical, high, medium, low
-
-.PARAMETER TaskID
-    相關任務 ID（如 TASK_078）
-
-.PARAMETER Interactive
-    互動式模式（預設）
-
-.PARAMETER Help
-    顯示幫助訊息
-
-.EXAMPLE
-    .\log_failure.ps1
-    互動式建立失敗記錄
-
-.EXAMPLE
-    .\log_failure.ps1 -Category "pipeline" -Title "任務佇列損壞" -Severity "high" -TaskID "TASK_088"
-    使用參數建立失敗記錄
-#>
-
-param(
-    [Parameter(Mandatory=$false)]
-    [ValidateSet("agent_execution", "code_quality", "architecture", "pipeline", "data_integrity")]
-    [string]$Category,
-
-    [Parameter(Mandatory=$false)]
-    [string]$Title,
-
-    [Parameter(Mandatory=$false)]
-    [ValidateSet("critical", "high", "medium", "low")]
-    [string]$Severity,
-
-    [Parameter(Mandatory=$false)]
-    [string]$TaskID,
-
-    [Parameter(Mandatory=$false)]
-    [switch]$Interactive = $true,
-
-    [Parameter(Mandatory=$false)]
-    [switch]$Help
-)
-
-# ============================================================
-# 常量定義
-# ============================================================
-$FAILURE_ROOT = Join-Path (Split-Path $PSScriptRoot -Parent) ""
-$INDEX_FILE = Join-Path $FAILURE_ROOT "INDEX.yaml"
-
-$CATEGORY_PATHS = @{
-    "agent_execution" = "agent-execution"
-    "code_quality" = "code-quality"
-    "architecture" = "architecture"
-    "pipeline" = "pipeline"
-    "data_integrity" = "data-integrity"
-}
-
-$SEVERITY_ICONS = @{
-    "critical" = "🔴"
-    "high" = "🟠"
-    "medium" = "🟡"
-    "low" = "🟢"
-}
-
-# ============================================================
-# 函數定義
-# ============================================================
-
-function Show-Help {
-    Write-Host @"
-🔧 Failure Logging Tool
-
-使用方式:
-  .\log_failure.ps1                                    # 互動式模式
-  .\log_failure.ps1 -Category <cat> -Title <title> -Severity <sev>
-
-參數:
-  -Category     失敗分類: agent_execution, code_quality, architecture, pipeline, data_integrity
-  -Title        失敗標題（簡短描述）
-  -Severity     嚴重程度: critical, high, medium, low
-  -TaskID       相關任務 ID（可選）
-  -Interactive  互動式模式（預設）
-  -Help         顯示此幫助訊息
-
-範例:
-  .\log_failure.ps1 -Category "pipeline" -Title "任務佇列損壞" -Severity "high"
-  .\log_failure.ps1 -Interactive
-
-相關資源:
-  - 失敗記錄索引: .failure/INDEX.yaml
-  - 失敗記錄模板: .failure/INDEX.yaml (failure_template)
-"@
-    exit 0
-}
-
-function Get-NextFailureID {
-    # 讀取 INDEX.yaml 獲取當前最大的 FAIL-XXX ID
-    if (-not (Test-Path $INDEX_FILE)) {
-        Write-Error "❌ INDEX.yaml not found at: $INDEX_FILE"
-        exit 1
-    }
-
-    $content = Get-Content $INDEX_FILE -Raw
-    $maxID = 0
-
-    # 匹配 FAIL-XXX 格式
-    $matches = [regex]::Matches($content, 'FAIL-(\d{3})')
-    foreach ($match in $matches) {
-        $id = [int]$match.Groups[1].Value
-        if ($id -gt $maxID) {
-            $maxID = $id
-        }
-    }
-
-    $nextID = $maxID + 1
-    return "FAIL-{0:D3}" -f $nextID
-}
-
-function Get-CategoryPath {
-    param([string]$Category)
-
-    if (-not $CATEGORY_PATHS.ContainsKey($Category)) {
-        Write-Error "❌ Invalid category: $Category"
-        exit 1
-    }
-
-    $path = Join-Path $FAILURE_ROOT $CATEGORY_PATHS[$Category]
-    if (-not (Test-Path $path)) {
-        Write-Warning "⚠️  Category directory not found, creating: $path"
-        New-Item -ItemType Directory -Path $path -Force | Out-Null
-    }
-
-    return $path
-}
-
-function New-FailureRecord {
-    param(
-        [string]$FailureID,
-        [string]$Category,
-        [string]$Title,
-        [string]$Severity,
-        [string]$TaskID
-    )
-
-    $date = Get-Date -Format "yyyy-MM-dd"
-    $categoryPath = Get-CategoryPath -Category $Category
-
-    # 生成文件名（使用小寫和連字符）
-    $titleSlug = $Title -replace '\s+', '-' -replace '[^\w\-]', '' -replace '-+', '-'
-    $titleSlug = $titleSlug.ToLower()
-    $fileName = "$FailureID-$titleSlug.yaml"
-    $filePath = Join-Path $categoryPath $fileName
-
-    # 生成失敗記錄內容
-    $relatedTasksValue = if ($TaskID) { "`"$TaskID`"" } else { "" }
-
-    $content = @"
-# [$FailureID] $Title
-
-_meta:
-  id: "$FailureID"
-  category: "$Category"
-  severity: "$Severity"
-  date: "$date"
-  related_tasks: [$relatedTasksValue]
-  related_commits: []
-  status: "open"
-
-## 失敗描述
-
-**現象**：（清晰描述發生了什麼）
-
-**預期行為**：
-- （預期的正常行為）
-
-**實際結果**：
-- （實際觀察到的錯誤結果）
-
-## 根本原因
-
-深入分析導致失敗的根本原因，不只是表面現象。
-
-### 可能的原因
-1. 原因 1
-2. 原因 2
-
-## 影響範圍
-
-### 受影響的模組/文件
-- 文件 1
-- 文件 2
-
-### 受影響的功能
-- 功能 1
-- 功能 2
-
-### 潛在的連鎖反應
-- 連鎖反應 1
-
-## 重現步驟
-
-1. 步驟 1
-2. 步驟 2
-3. 觀察到的錯誤
-
-## 解決方案
-
-具體的、可執行的修復步驟。
-
-``````
-# 修復代碼範例
-``````
-
-## 預防措施
-
-### 檢查清單
-- [ ] 檢查項目 1
-- [ ] 檢查項目 2
-
-### 規則建議
-如果此失敗模式重複出現，建議建立 .rule/ 規則：
-- 規則 ID: XXX-YYY
-- 規則描述: ...
-
-## 教訓與啟示
-
-### 關鍵教訓
-1. 教訓 1
-2. 教訓 2
-
-### 如何避免類似問題
-1. 方法 1
-2. 方法 2
-
----
-
-**最後更新**: $date
-**貢獻者**: (Agent Name)
-**狀態**: Open
-"@
-
-    # 寫入文件
-    $content | Out-File -FilePath $filePath -Encoding UTF8 -NoNewline
-    Write-Host "✅ Failure record created: $filePath" -ForegroundColor Green
-
-    return $filePath
-}
-
-function Update-IndexYaml {
-    param(
-        [string]$FailureID,
-        [string]$Category,
-        [string]$Title,
-        [string]$Severity,
-        [string]$FilePath
-    )
-
-    if (-not (Test-Path $INDEX_FILE)) {
-        Write-Error "❌ INDEX.yaml not found"
-        exit 1
-    }
-
-    # 讀取 INDEX.yaml
-    $content = Get-Content $INDEX_FILE -Raw
-
-    # 1. 更新 load_order (在 statistics 之前插入)
-    $relativePath = $FilePath.Replace($FAILURE_ROOT, "").TrimStart("\").Replace("\", "/")
-    $newLoadEntry = @"
-
-  - path: "$relativePath"
-    title: "$Title"
-    severity: "$Severity"
-"@
-
-    # 找到 statistics 前插入
-    $statisticsIndex = $content.IndexOf("# ============================================================`n# 統計數據")
-    if ($statisticsIndex -gt 0) {
-        $content = $content.Insert($statisticsIndex, $newLoadEntry + "`n")
-    }
-
-    # 2. 更新統計數據
-    # 更新 total_failures
-    if ($content -match 'total_failures:\s*(\d+)') {
-        $newTotal = [int]$matches[1] + 1
-        $content = $content -replace 'total_failures:\s*\d+', "total_failures: $newTotal"
-    }
-
-    # 更新分類統計
-    if ($content -match "$Category`:\s*(\d+)") {
-        $newCount = [int]$matches[1] + 1
-        $content = $content -replace "$Category`:\s*\d+", "$Category`: $newCount"
-    }
-
-    # 更新嚴重程度統計
-    if ($content -match "$Severity`:\s*(\d+)") {
-        $newCount = [int]$matches[1] + 1
-        $content = $content -replace "$Severity`:\s*\d+", "$Severity`: $newCount"
-    }
-
-    # 3. 更新 last_updated
-    $now = Get-Date -Format "yyyy-MM-ddTHH:mm:sszzz"
-    $content = $content -replace 'last_updated:\s*"[^"]+"', "last_updated: `"$now`""
-
-    # 寫回文件
-    $content | Out-File -FilePath $INDEX_FILE -Encoding UTF8 -NoNewline
-    Write-Host "✅ INDEX.yaml updated" -ForegroundColor Green
-}
-
-# ============================================================
-# 主程序
-# ============================================================
-
-if ($Help) {
-    Show-Help
-}
-
-Write-Host "🔧 Failure Logging Tool" -ForegroundColor Cyan
-Write-Host "========================`n" -ForegroundColor Cyan
-
-# 如果參數不完整，進入互動模式
-if (-not $Category -or -not $Title -or -not $Severity) {
-    $Interactive = $true
-}
-
-if ($Interactive) {
-    Write-Host "📝 互動式建立失敗記錄`n" -ForegroundColor Yellow
-
-    # 選擇分類
-    Write-Host "1. 選擇失敗分類:"
-    Write-Host "  1) agent_execution - Agent 執行失敗"
-    Write-Host "  2) code_quality - 代碼品質問題"
-    Write-Host "  3) architecture - 架構決策失敗"
-    Write-Host "  4) pipeline - Pipeline 系統失敗"
-    Write-Host "  5) data_integrity - 數據完整性問題"
-    $categoryChoice = Read-Host "請選擇 (1-5)"
-
-    $Category = switch ($categoryChoice) {
-        "1" { "agent_execution" }
-        "2" { "code_quality" }
-        "3" { "architecture" }
-        "4" { "pipeline" }
-        "5" { "data_integrity" }
-        default { Write-Error "❌ Invalid choice"; exit 1 }
-    }
-
-    # 輸入標題
-    $Title = Read-Host "`n2. 失敗標題（簡短描述）"
-    if (-not $Title) {
-        Write-Error "❌ Title is required"
-        exit 1
-    }
-
-    # 選擇嚴重程度
-    Write-Host "`n3. 選擇嚴重程度:"
-    Write-Host "  1) critical - 導致系統無法運作或數據損壞"
-    Write-Host "  2) high - 嚴重影響功能或效率"
-    Write-Host "  3) medium - 影響體驗但不阻礙功能"
-    Write-Host "  4) low - 輕微問題或不便"
-    $severityChoice = Read-Host "請選擇 (1-4)"
-
-    $Severity = switch ($severityChoice) {
-        "1" { "critical" }
-        "2" { "high" }
-        "3" { "medium" }
-        "4" { "low" }
-        default { Write-Error "❌ Invalid choice"; exit 1 }
-    }
-
-    # 輸入相關任務 ID（可選）
-    $TaskID = Read-Host "`n4. 相關任務 ID（可選，如 TASK_078）"
-}
-
-# 驗證必填欄位
-if (-not $Category -or -not $Title -or -not $Severity) {
-    Write-Error "❌ Missing required parameters: Category, Title, Severity"
-    Show-Help
-    exit 1
-}
-
-# 生成 Failure ID
-$FailureID = Get-NextFailureID
-Write-Host "`n📋 生成失敗記錄 ID: $FailureID" -ForegroundColor Cyan
-
-# 顯示摘要
-Write-Host "`n📊 失敗記錄摘要:" -ForegroundColor Yellow
-Write-Host "  ID:          $FailureID"
-Write-Host "  分類:        $Category"
-Write-Host "  標題:        $Title"
-Write-Host "  嚴重程度:    $Severity $($SEVERITY_ICONS[$Severity])"
-if ($TaskID) {
-    Write-Host "  相關任務:    $TaskID"
-}
-
-# 確認建立
-$confirm = Read-Host "`n確認建立此失敗記錄? (Y/n)"
-if ($confirm -eq "n" -or $confirm -eq "N") {
-    Write-Host "❌ 已取消" -ForegroundColor Red
-    exit 0
-}
-
-# 建立失敗記錄
-Write-Host "`n🚀 建立失敗記錄..." -ForegroundColor Cyan
-$filePath = New-FailureRecord -FailureID $FailureID -Category $Category -Title $Title -Severity $Severity -TaskID $TaskID
-
-# 更新 INDEX.yaml
-Write-Host "📝 更新 INDEX.yaml..." -ForegroundColor Cyan
-Update-IndexYaml -FailureID $FailureID -Category $Category -Title $Title -Severity $Severity -FilePath $filePath
-
-# 🆕 同時寫入記憶系統 (.memory/failures/)
-Write-Host "💾 同時寫入記憶系統..." -ForegroundColor Cyan
-try {
-    # 轉換嚴重程度到重要性分數
-    $importanceMap = @{
-        "critical" = 5
-        "high" = 4
-        "medium" = 3
-        "low" = 2
-    }
-    $importance = $importanceMap[$Severity]
-
-    # 生成標籤
-    $tags = "failure,$Severity"
-    if ($Category) {
-        $tags += ",$Category"
-    }
-
-    # 構建 memory-tools.js 命令
-    $memoryToolsPath = Join-Path $PSScriptRoot "..\..\memory\tools\memory-tools.js"
-    $summary = "失敗記錄：$Title（$Severity 嚴重程度）"
-
-    # 調用 memory-tools.js
-    $cmd = "node `"$memoryToolsPath`" add --type failure --title `"$Title`" --summary `"$summary`" --importance $importance --tags `"$tags`" --sourceFile `"$FailureID`""
-
-    $result = Invoke-Expression $cmd 2>&1
-    if ($LASTEXITCODE -eq 0) {
-        Write-Host "  ✅ 已同步到記憶系統" -ForegroundColor Green
-    } else {
-        Write-Warning "⚠️  記憶系統同步失敗（不影響失敗記錄建立）"
-        Write-Warning "    錯誤: $result"
-    }
-} catch {
-    Write-Warning "⚠️  記憶系統同步失敗（不影響失敗記錄建立）"
-    Write-Warning "    錯誤: $_"
-}
-
-Write-Host "`n✅ 完成！失敗記錄已建立並更新到索引。" -ForegroundColor Green
-Write-Host "📁 .failure/ 路徑: $filePath" -ForegroundColor Cyan
-Write-Host "📁 .memory/ 路徑: 自動生成（查看上方輸出）" -ForegroundColor Cyan
-Write-Host "`n下一步:"
-Write-Host "  1. 編輯失敗記錄，補充詳細資訊"
-Write-Host "  2. 執行 .\check_failures.ps1 檢查相關失敗模式"
-Write-Host "  3. 如需轉化為規則，執行 .\failure-to-rule.ps1"
-
-exit 0

package/core/.formation/.episode-input.json

@@ -1,10 +0,0 @@
-{
-  "tool": "hippocampus_episode_start",
-  "params": {
-    "scope": "M3 handoff migration: write-endpoint completion after TASK_1828 read-path fix",
-    "task_id": "TASK_1829",
-    "agent_role": "ansuz",
-    "agent_skill": "session-observer",
-    "projectPath": "."
-  }
-}

package/core/.formation/.merge-lock

@@ -1 +0,0 @@
-{"pid":32452,"taskId":"TASK_2356","acquiredAt":"2026-10-09T10:19:19.033Z"}

package/core/.formation/lead.yaml

@@ -1,118 +0,0 @@
-skill: lead
-formation: "*"
-version: "2.0"
-
-name: Formation Lead
-description: |
-  Formation PM — 使用 Formation 系統的全權 PM。
-  完整任務生命週期：理解需求 → 建立任務 → 判斷陣型 → 調度執行 → 追蹤結果 → 回報用戶。
-
-role:
-  identity: |
-    你是 Formation Lead，全權 PM。
-    你不親自寫程式碼。你理解需求、做決策、派人、追結果。
-  priority: 先理解再行動，需求不清就問。最輕量原則。
-
-input:
-  required:
-    - task: 任務 ID 或用戶描述（支援多個，逗號分隔或陣列）
-  optional:
-    - formation: 強制指定陣型（跳過自動判斷）
-    - skill: 強制指定技能
-    - concurrency: 並行執行數（預設 3，上限 5）
-
-# ─────────────────────────────────────────
-# 陣型選擇邏輯
-# ─────────────────────────────────────────
-
-selection:
-  rules:
-    - condition: 單一明確任務，影響 ≤3 個檔案
-      formation: unit
-      skill: do
-
-    - condition: 需要調查或分析，不需要改程式碼
-      formation: unit
-      skill: think
-
-    - condition: 需要拆解目標、制定方案
-      formation: unit
-      skill: plan
-
-    - condition: 需要多角度動態分析，一個 agent 裝備多視角自主切換
-      formation: solo
-      skill: 根據分析類型選擇（strategy | diagnosis）
-
-    - condition: 一個任務可拆成多個互不依賴的子任務並行完成
-      formation: squad
-      skill: blitz
-
-    - condition: 同一變更邏輯需套用到多個獨立區域（跨模組重構、批量遷移）
-      formation: squad
-      skill: sweep
-
-    - condition: 有順序依賴（設計→實作→驗收）或回饋循環
-      formation: legion
-      skill: forge
-
-    - condition: 工作高度耦合，所有人的變更互相影響，需即時協調
-      formation: legion
-      skill: hive
-
-  fallback: unit/do
-
-# ─────────────────────────────────────────
-# 工作流程
-# ─────────────────────────────────────────
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - phase: 理解需求
-      actions:
-        - 如果是 TASK_ID → 讀取任務詳情
-        - 如果是描述 → 確認需求是否足夠明確
-        - 需求不清就問用戶，不要猜
-
-    - phase: 建立任務
-      run: node .collaboration/core/task-api.js create --title "{title}" --priority {priority}
-      then: node .collaboration/core/task-api.js claim TASK_XXX
-      skip_if: 已有 TASK_ID
-
-    - phase: 判斷陣型
-      actions:
-        - 檢查是否有用戶強制指定的 formation/skill
-        - 若無，Lead 自行評估需求特性，參考 selection.rules 作為指引（非硬性）
-        - 告知用戶選擇和理由（一句話）
-
-    - phase: 調度執行
-      actions:
-        - "單任務: unit/solo → dispatch.js → runSingle"
-        - "多任務並行: 按 concurrency 參數（預設 3）同時啟動多個 dispatch"
-        - "squad: dispatch.js → runParallel（隊內並行）"
-        - "legion: dispatch.js → TeamCreate 配置"
-      parallel:
-        description: |
-          當有多個任務時，Lead 按 concurrency 數量同時調度：
-          1. 從 pending 佇列按優先級取 N 個任務（N = concurrency）
-          2. 每個任務獨立判斷陣型，獨立 dispatch
-          3. 滑動窗口：有 slot 完成就補入下一個任務
-          4. 衝突檢查：相同檔案路徑的任務不並行
-        default_concurrency: 3
-        max_concurrency: 5
-
-    - phase: 追蹤結果
-      actions:
-        - 追蹤所有並行 slot 的執行狀態
-        - 任一 slot 完成時立即處理結果
-        - "成功: task-api.js complete TASK_XXX"
-        - "失敗: task-api.js move TASK_XXX blocked"
-        - 空出的 slot 自動補入下一個 pending 任務
-
-    - phase: 回報用戶
-      format: |
-        ✅ 批次完成（{completed}/{total}）
-        並行度：{concurrency}
-        結果：
-        {逐任務摘要列表}

package/core/.formation/legacy.bak/designer.yaml

@@ -1,57 +0,0 @@
-skill: designer
-formation: legacy
-version: "1.0"
-
-name: Designer
-description: UI/UX 設計。設計規範、視覺稿、互動設計、設計系統維護。
-
-role:
-  identity: |
-    你是 UI/UX 設計師。產出設計規範、組件規格、視覺風格定義。
-    以用戶體驗為核心，確保設計的一致性和可實現性。
-  priority: 產出可執行的設計規範，而非抽象概念。
-
-input:
-  required:
-    - task: 任務 ID 或設計需求描述
-  optional:
-    - context: 現有設計系統或品牌指南
-    - target: 目標頁面或組件
-
-output:
-  primary: 設計規範文件（DESIGN_SPEC.md）或組件規格
-  secondary: 設計決策記錄、參考資料
-
-behavior:
-  - 先完成指派的任務（## Task），完成後可用 task-api.js claim 認領下一個任務繼續工作
-  - 嚴禁直接讀取 .collaboration/tasks/ 目錄。所有任務操作必須透過 task-api.js（list/claim/complete）
-  - 只能 complete 你自己認領的任務，不要標記其他 agent 的任務為完成
-  - 先了解現有設計系統和視覺風格
-  - 只修改當前任務 scope_paths 指定的檔案
-  - 設計規範要具體到可以直接實作（顏色值、間距、字體大小）
-  - 考慮 RWD 和無障礙
-  - 與現有元件庫一致
-  - 產出 Markdown 格式的規範文件
-  - 禁止執行任何 git 操作（commit、branch、merge）— Git 由 Formation Lead 統一管理
-
-collaboration:
-  task_api: node .collaboration/core/task-api.js
-
-  workflow:
-    - step: 讀取任務
-      run: node .collaboration/core/task-api.js get {task_id}
-
-    - step: 認領任務
-      run: node .collaboration/core/task-api.js claim {task_id}
-
-    - step: 設計分析
-      actions:
-        - 檢查現有設計系統
-        - 分析需求與用戶場景
-        - 產出設計規範或視覺稿
-
-    - step: 完成任務
-      run: node .collaboration/core/task-api.js complete {task_id}
-
-  on_blocked:
-    run: node .collaboration/core/task-api.js move {task_id} blocked