kenaz 0.3.21 → 0.3.23

package/core/dev/scripts/init_project.ps1

@@ -1,851 +0,0 @@
-# ============================================================
-# Kenaz AI - 新專案初始化腳本
-# ============================================================
-# 用途：快速重置 Pipeline 並準備開始新專案開發
-# ============================================================
-
-param(
-    [switch]$SkipRAG,           # 跳過 RAG 設置
-    [switch]$SkipCleanup,       # 跳過清理舊任務
-    [switch]$SkipCopy,          # 跳過複製 .claude/、.agents/、CLAUDE.md
-    [switch]$AutoStart,         # 自動啟動 /產品 流程
-    [switch]$Quiet,             # 靜默模式（無互動確認）
-    [string]$WorkingDirectory,  # 工作目錄
-    [switch]$nopause            # 從 Tauri 調用時使用（跳過暫停）
-)
-
-# Helper function to normalize Windows extended path format (\\?\)
-function Get-NormalizedPath {
-    param([string]$Path)
-    if ($Path -and $Path.StartsWith("\\?\")) {
-        return $Path.Substring(4)
-    }
-    return $Path
-}
-
-# Use KENAZ_PROJECT_PATH env var if WorkingDirectory not specified
-if (-not $WorkingDirectory) {
-    if ($env:KENAZ_PROJECT_PATH) {
-        $WorkingDirectory = $env:KENAZ_PROJECT_PATH
-    } else {
-        $WorkingDirectory = (Get-Location).Path
-    }
-}
-
-# Normalize WorkingDirectory to handle \\?\ prefix from Tauri
-$WorkingDirectory = Get-NormalizedPath $WorkingDirectory
-
-# If nopause is set (from Tauri), also enable Quiet mode
-if ($nopause) {
-    $Quiet = $true
-}
-
-# 顏色輸出函數
-function Write-Color {
-    param([string]$Text, [string]$Color = "White")
-    Write-Host $Text -ForegroundColor $Color
-}
-
-function Write-Step {
-    param([int]$Num, [string]$Text)
-    Write-Host ""
-    Write-Color "[$Num] $Text" "Cyan"
-    Write-Host "------------------------------------------------------------"
-}
-
-function Write-Success {
-    param([string]$Text)
-    Write-Color "  OK $Text" "Green"
-}
-
-function Write-Skip {
-    param([string]$Text)
-    Write-Color "  -- $Text (skipped)" "Yellow"
-}
-
-function Write-Fail {
-    param([string]$Text)
-    Write-Color "  XX $Text" "Red"
-}
-
-# ============================================================
-# 主程式
-# ============================================================
-
-Clear-Host
-Write-Host ""
-Write-Color "============================================================" "Magenta"
-Write-Color "       Kenaz AI - New Project Initialization" "Magenta"
-Write-Color "============================================================" "Magenta"
-Write-Host ""
-Write-Host "Working Directory: $WorkingDirectory"
-Write-Host ""
-
-# ============================================================
-# Step 1: 清理舊的 Pipeline 狀態
-# ============================================================
-Write-Step 1 "Cleaning up old pipeline state"
-
-if (-not $SkipCleanup) {
-    $tasksDir = Join-Path $WorkingDirectory "dev\pipeline\tasks"
-    $completedDir = Join-Path $WorkingDirectory "dev\pipeline\completed"
-    $logsDir = Join-Path $WorkingDirectory "dev\pipeline\logs"
-    $statusFile = Join-Path $WorkingDirectory "dev\pipeline\SELF_ENHANCEMENT_STATUS.json"
-    $progressFile = Join-Path $WorkingDirectory "dev\pipeline\PROGRESS.md"
-
-    # 清空 tasks 目錄
-    if (Test-Path $tasksDir) {
-        $taskFiles = Get-ChildItem -Path $tasksDir -Filter "*.md" -ErrorAction SilentlyContinue
-        if ($taskFiles.Count -gt 0) {
-            Remove-Item "$tasksDir\*.md" -Force -ErrorAction SilentlyContinue
-            Write-Success "Cleared $($taskFiles.Count) task files from tasks/"
-        } else {
-            Write-Success "tasks/ already empty"
-        }
-    }
-
-    # 備份並清空 completed 目錄
-    if (Test-Path $completedDir) {
-        $completedFiles = Get-ChildItem -Path $completedDir -Filter "*.md" -ErrorAction SilentlyContinue
-        if ($completedFiles.Count -gt 0) {
-            $backupDir = Join-Path $WorkingDirectory "dev\pipeline\archive\$(Get-Date -Format 'yyyy-MM-dd_HHmmss')"
-            New-Item -ItemType Directory -Path $backupDir -Force | Out-Null
-            Move-Item "$completedDir\*.md" $backupDir -Force
-            Write-Success "Archived $($completedFiles.Count) completed tasks to archive/"
-        } else {
-            Write-Success "completed/ already empty"
-        }
-    }
-
-    # 刪除狀態文件
-    if (Test-Path $statusFile) {
-        Remove-Item $statusFile -Force
-        Write-Success "Removed SELF_ENHANCEMENT_STATUS.json"
-    }
-
-    # 確保 dev 目錄及 pipeline 子目錄存在
-    $devDir = Join-Path $WorkingDirectory "dev"
-    $pipelineDir = Join-Path $devDir "pipeline"
-    $tasksDir = Join-Path $pipelineDir "tasks"
-    $completedDir = Join-Path $pipelineDir "completed"
-    $logsDir = Join-Path $pipelineDir "logs"
-    $archiveDir = Join-Path $pipelineDir "archive"
-
-    # 建立 dev 目錄
-    if (-not (Test-Path $devDir)) {
-        New-Item -ItemType Directory -Path $devDir -Force | Out-Null
-        Write-Success "Created dev directory"
-    }
-
-    # 建立 pipeline 主目錄
-    if (-not (Test-Path $pipelineDir)) {
-        New-Item -ItemType Directory -Path $pipelineDir -Force | Out-Null
-        Write-Success "Created dev\pipeline directory"
-    }
-
-    # 建立子目錄
-    if (-not (Test-Path $tasksDir)) {
-        New-Item -ItemType Directory -Path $tasksDir -Force | Out-Null
-        Write-Success "Created dev\pipeline\tasks directory"
-    }
-
-    if (-not (Test-Path $completedDir)) {
-        New-Item -ItemType Directory -Path $completedDir -Force | Out-Null
-        Write-Success "Created dev\pipeline\completed directory"
-    }
-
-    if (-not (Test-Path $logsDir)) {
-        New-Item -ItemType Directory -Path $logsDir -Force | Out-Null
-        Write-Success "Created dev\pipeline\logs directory"
-    }
-
-    if (-not (Test-Path $archiveDir)) {
-        New-Item -ItemType Directory -Path $archiveDir -Force | Out-Null
-        Write-Success "Created dev\pipeline\archive directory"
-    }
-
-    # 初始化 TASK_QUEUE.json
-    $taskQueueFile = Join-Path $pipelineDir "TASK_QUEUE.json"
-    if (-not (Test-Path $taskQueueFile)) {
-        $taskQueueContent = @"
-{
-  "version": "1.0",
-  "last_updated": "$(Get-Date -Format "yyyy-MM-ddTHH:mm:ss")",
-  "tasks": []
-}
-"@
-        Set-Content -Path $taskQueueFile -Value $taskQueueContent -Encoding UTF8
-        Write-Success "Created TASK_QUEUE.json"
-    }
-
-    # 初始化/重置 AGENT_STATE.json（總是重置以清除 stale scheduler 狀態）
-    $agentStateFile = Join-Path $pipelineDir "AGENT_STATE.json"
-    $agentStateContent = @"
-{
-  "version": "1.0",
-  "agents": [],
-  "scheduler": {
-    "status": "stopped"
-  },
-  "last_updated": "$(Get-Date -Format "yyyy-MM-ddTHH:mm:ss")Z"
-}
-"@
-    Set-Content -Path $agentStateFile -Value $agentStateContent -Encoding UTF8
-    if (Test-Path $agentStateFile) {
-        Write-Success "Reset AGENT_STATE.json (scheduler status: stopped)"
-    } else {
-        Write-Success "Created AGENT_STATE.json"
-    }
-
-    # 初始化 LOCK_STATE.json
-    $lockStateFile = Join-Path $pipelineDir "LOCK_STATE.json"
-    if (-not (Test-Path $lockStateFile)) {
-        $lockStateContent = @"
-{
-  "version": "1.0",
-  "locks": {}
-}
-"@
-        Set-Content -Path $lockStateFile -Value $lockStateContent -Encoding UTF8
-        Write-Success "Created LOCK_STATE.json"
-    }
-
-    # 初始化 PIPELINE_CONFIG.json
-    $pipelineConfigFile = Join-Path $pipelineDir "PIPELINE_CONFIG.json"
-    if (-not (Test-Path $pipelineConfigFile)) {
-        $pipelineConfigContent = @"
-{
-  "version": "1.0",
-  "max_parallel_agents": 3,
-  "task_timeout_minutes": 60,
-  "poll_interval_seconds": 30,
-  "auto_enhancement": {
-    "enabled": false,
-    "max_cycles": 3
-  }
-}
-"@
-        Set-Content -Path $pipelineConfigFile -Value $pipelineConfigContent -Encoding UTF8
-        Write-Success "Created PIPELINE_CONFIG.json"
-    }
-
-    # 重置 PROGRESS.md
-    $progressTemplate = @"
-# Pipeline Progress Tracking
-
-## Last Update
-- **Time**: $(Get-Date -Format "yyyy-MM-dd HH:mm")
-- **Agent**: System
-- **Session**: Project Initialized
-
----
-
-## Current Status
-
-### Running Tasks
-| Task ID | Name | Progress | Next Step |
-|--------|------|-----|-------|
-| - | None | - | Run /product to start |
-
-### Pending Task Queue
-| Priority | Task ID | Name | Status | Est. Hours |
-|-------|--------|------|-----|---------|
-| - | - | None | - | - |
-
-### Completed Tasks
-| Task ID | Name | Completion Date |
-|--------|------|---------|
-| - | - | - |
-
----
-
-## Statistics
-
-### Overall Progress
-``````
-Total Tasks: 0
-Completed: 0 (0%)
-In Progress: 0 (0%)
-Pending: 0 (0%)
-Blocked: 0 (0%)
-``````
-
-### Project Status
-``````
-Waiting for product requirements...
-Run /product to start requirement analysis
-``````
-
----
-
-## Change History
-
-| Date | Action | Description |
-|-----|------|-----|
-| $(Get-Date -Format "yyyy-MM-dd") | Initialize | New project initialized |
-"@
-    Set-Content -Path $progressFile -Value $progressTemplate -Encoding UTF8
-    Write-Success "Reset PROGRESS.md"
-
-} else {
-    Write-Skip "Cleanup"
-}
-
-# ============================================================
-# Step 2: 檢查 Python 環境
-# ============================================================
-Write-Step 2 "Checking Python environment"
-
-$pythonCmd = $null
-if (Get-Command python -ErrorAction SilentlyContinue) {
-    $pythonCmd = "python"
-    $pythonVersion = & python --version 2>&1
-    Write-Success "Found $pythonVersion"
-} elseif (Get-Command python3 -ErrorAction SilentlyContinue) {
-    $pythonCmd = "python3"
-    $pythonVersion = & python3 --version 2>&1
-    Write-Success "Found $pythonVersion"
-} else {
-    Write-Fail "Python not found (RAG features will be disabled)"
-}
-
-# ============================================================
-# Step 3: 設置 RAG 環境（可選）
-# ============================================================
-Write-Step 3 "Setting up RAG environment"
-
-if (-not $SkipRAG -and $pythonCmd) {
-    $cortexDir = Join-Path $WorkingDirectory "kenaz-cortex"
-
-    if (Test-Path $cortexDir) {
-        # 檢查是否已安裝
-        $cortexInstalled = $false
-        try {
-            & $pythonCmd -c "import cortex" 2>$null
-            $cortexInstalled = $true
-        } catch {}
-
-        if (-not $cortexInstalled) {
-            if (-not $Quiet) {
-                Write-Host ""
-                $install = Read-Host "  Install kenaz-cortex RAG engine? (y/N)"
-            } else {
-                $install = "y"
-            }
-
-            if ($install -eq "y" -or $install -eq "Y") {
-                Write-Host "  Installing kenaz-cortex..."
-                Push-Location $cortexDir
-                & $pythonCmd -m pip install -e . --quiet 2>$null
-                Pop-Location
-
-                # 驗證安裝
-                try {
-                    & $pythonCmd -c "import cortex" 2>$null
-                    Write-Success "kenaz-cortex installed"
-                } catch {
-                    Write-Fail "Failed to install kenaz-cortex"
-                }
-            } else {
-                Write-Skip "kenaz-cortex installation"
-            }
-        } else {
-            Write-Success "kenaz-cortex already installed"
-        }
-
-        # 設置 Git Hooks
-        $gitDir = Join-Path $WorkingDirectory ".git"
-        $hooksPath = Join-Path $WorkingDirectory ".githooks"
-
-        if ((Test-Path $gitDir) -and (Test-Path $hooksPath)) {
-            $currentHooksPath = git config --get core.hooksPath 2>$null
-            if ($currentHooksPath -ne ".githooks") {
-                git config core.hooksPath .githooks
-                Write-Success "Git hooks configured (.githooks)"
-            } else {
-                Write-Success "Git hooks already configured"
-            }
-        }
-    } else {
-        Write-Skip "kenaz-cortex directory not found"
-    }
-} else {
-    Write-Skip "RAG setup"
-}
-
-# ============================================================
-# Step 4: 複製 Claude Code 配置文件
-# ============================================================
-Write-Step 4 "Copying Claude Code configuration files"
-
-# Helper function to normalize Windows extended path format (\\?\)
-function Get-NormalizedPath {
-    param([string]$Path)
-    if ($Path -and $Path.StartsWith("\\?\")) {
-        return $Path.Substring(4)
-    }
-    return $Path
-}
-
-# Helper function to check if a directory contains KenazAI templates
-function Test-KenazSourceDir {
-    param([string]$Path)
-    $Path = Get-NormalizedPath $Path
-    if (-not $Path -or -not (Test-Path $Path)) { return $false }
-
-    # Check multiple indicators - any one is sufficient
-    $hasClaudeCommands = Test-Path (Join-Path $Path ".claude\commands")
-    $hasClaudeSkills = Test-Path (Join-Path $Path ".claude\skills")
-    $hasClaudeMd = Test-Path (Join-Path $Path "CLAUDE.md")
-    $hasAgents = Test-Path (Join-Path $Path ".agents")
-    $hasGithooks = Test-Path (Join-Path $Path ".githooks")
-
-    return ($hasClaudeCommands -or $hasClaudeSkills -or $hasClaudeMd -or $hasAgents -or $hasGithooks)
-}
-
-# 確定 KenazAI 模板目錄位置
-$kenazSourceDir = $null
-
-# 優先順序：1. 環境變數 2. 環境變數的父目錄 3. 腳本所在目錄 4. 遍歷上層目錄
-# Normalize the KENAZ_SOURCE_DIR to remove \\?\ prefix if present
-$normalizedSourceDir = Get-NormalizedPath $env:KENAZ_SOURCE_DIR
-
-if ($normalizedSourceDir) {
-    # 先檢查環境變數本身
-    if (Test-KenazSourceDir $normalizedSourceDir) {
-        $kenazSourceDir = $normalizedSourceDir
-        Write-Host "  Found source via KENAZ_SOURCE_DIR env var" -ForegroundColor Gray
-    } else {
-        # 環境變數可能指向 dashboard/，嘗試檢查父目錄（KenazAI 根目錄）
-        $envParent = Split-Path -Parent $normalizedSourceDir
-        if ($envParent -and (Test-KenazSourceDir $envParent)) {
-            $kenazSourceDir = $envParent
-            Write-Host "  Found source via KENAZ_SOURCE_DIR parent: $envParent" -ForegroundColor Gray
-        } else {
-            # 再往上一層（可能是 KenazAI/dashboard/src-tauri -> KenazAI）
-            $envGrandparent = Split-Path -Parent $envParent
-            if ($envGrandparent -and (Test-KenazSourceDir $envGrandparent)) {
-                $kenazSourceDir = $envGrandparent
-                Write-Host "  Found source via KENAZ_SOURCE_DIR grandparent: $envGrandparent" -ForegroundColor Gray
-            }
-        }
-    }
-}
-
-if (-not $kenazSourceDir) {
-    # 嘗試從腳本路徑推導（dev/scripts/init_project.ps1 -> KenazAI root）
-    # Normalize the script path first
-    $normalizedScriptPath = Get-NormalizedPath $MyInvocation.MyCommand.Path
-    $scriptDir = Split-Path -Parent $normalizedScriptPath
-
-    if ($scriptDir) {
-        # Walk up from script directory to find KenazAI root (up to 10 levels for dev mode)
-        # In dev mode: target/debug/dev/scripts -> ... -> KenazAI (7 levels up)
-        $current = $scriptDir
-        for ($i = 0; $i -lt 10; $i++) {
-            $current = Split-Path -Parent $current
-            if (-not $current) { break }
-
-            if (Test-KenazSourceDir $current) {
-                $kenazSourceDir = $current
-                Write-Host "  Found source at level $($i + 1): $current" -ForegroundColor Gray
-                break
-            }
-        }
-    }
-
-    # 最後檢查工作目錄本身（用戶可能在 KenazAI 倉庫中工作）
-    if (-not $kenazSourceDir -and (Test-KenazSourceDir $WorkingDirectory)) {
-        $kenazSourceDir = $WorkingDirectory
-        Write-Host "  Working directory is KenazAI source" -ForegroundColor Gray
-    }
-}
-
-if ($kenazSourceDir -and ($kenazSourceDir -ne $WorkingDirectory)) {
-    Write-Host "  Source: $kenazSourceDir"
-
-    # 複製 .claude 目錄（排除 settings.local.json）
-    $claudeSource = Join-Path $kenazSourceDir ".claude"
-    $claudeDest = Join-Path $WorkingDirectory ".claude"
-
-    if (Test-Path $claudeSource) {
-        if (-not (Test-Path $claudeDest)) {
-            # 首次複製整個目錄
-            Copy-Item -Path $claudeSource -Destination $claudeDest -Recurse -Force
-            # 刪除 settings.local.json（這是用戶特定的權限設定）
-            $localSettings = Join-Path $claudeDest "settings.local.json"
-            if (Test-Path $localSettings) {
-                Remove-Item $localSettings -Force
-            }
-            Write-Success "Copied .claude/ directory (commands, skills, hooks)"
-        } else {
-            # 目錄已存在，只更新 commands 和 skills
-            $commandsSource = Join-Path $claudeSource "commands"
-            $commandsDest = Join-Path $claudeDest "commands"
-            if (Test-Path $commandsSource) {
-                if (-not (Test-Path $commandsDest)) {
-                    New-Item -ItemType Directory -Path $commandsDest -Force | Out-Null
-                }
-                Copy-Item -Path "$commandsSource\*" -Destination $commandsDest -Recurse -Force
-                Write-Success "Updated .claude/commands/"
-            }
-
-            $skillsSource = Join-Path $claudeSource "skills"
-            $skillsDest = Join-Path $claudeDest "skills"
-            if (Test-Path $skillsSource) {
-                if (-not (Test-Path $skillsDest)) {
-                    New-Item -ItemType Directory -Path $skillsDest -Force | Out-Null
-                }
-                Copy-Item -Path "$skillsSource\*" -Destination $skillsDest -Recurse -Force
-                Write-Success "Updated .claude/skills/"
-            }
-
-            $hooksSource = Join-Path $claudeSource "hooks"
-            $hooksDest = Join-Path $claudeDest "hooks"
-            if (Test-Path $hooksSource) {
-                if (-not (Test-Path $hooksDest)) {
-                    New-Item -ItemType Directory -Path $hooksDest -Force | Out-Null
-                }
-                Copy-Item -Path "$hooksSource\*" -Destination $hooksDest -Recurse -Force
-                Write-Success "Updated .claude/hooks/"
-            }
-
-            # 複製 settings.json（但不覆蓋 settings.local.json）
-            $settingsSource = Join-Path $claudeSource "settings.json"
-            $settingsDest = Join-Path $claudeDest "settings.json"
-            if ((Test-Path $settingsSource) -and (-not (Test-Path $settingsDest))) {
-                Copy-Item -Path $settingsSource -Destination $settingsDest -Force
-                Write-Success "Copied .claude/settings.json"
-            }
-        }
-    } else {
-        Write-Fail ".claude/ not found in source"
-    }
-
-    # 複製 .agents 目錄（外部 skills）
-    $agentsSource = Join-Path $kenazSourceDir ".agents"
-    $agentsDest = Join-Path $WorkingDirectory ".agents"
-
-    if (Test-Path $agentsSource) {
-        if (-not (Test-Path $agentsDest)) {
-            Copy-Item -Path $agentsSource -Destination $agentsDest -Recurse -Force
-            Write-Success "Copied .agents/ directory (external skills)"
-        } else {
-            Write-Success ".agents/ already exists"
-        }
-    }
-
-    # 複製 .githooks 目錄（Git hooks for RAG indexing）
-    $githooksSource = Join-Path $kenazSourceDir ".githooks"
-    $githooksDest = Join-Path $WorkingDirectory ".githooks"
-
-    if (Test-Path $githooksSource) {
-        if (-not (Test-Path $githooksDest)) {
-            Copy-Item -Path $githooksSource -Destination $githooksDest -Recurse -Force
-            Write-Success "Copied .githooks/ directory (Git hooks)"
-        } else {
-            Write-Success ".githooks/ already exists"
-        }
-    }
-
-    # 複製 CLAUDE.md
-    $claudeMdSource = Join-Path $kenazSourceDir "CLAUDE.md"
-    $claudeMdDest = Join-Path $WorkingDirectory "CLAUDE.md"
-
-    if (Test-Path $claudeMdSource) {
-        if (-not (Test-Path $claudeMdDest)) {
-            Copy-Item -Path $claudeMdSource -Destination $claudeMdDest -Force
-            Write-Success "Copied CLAUDE.md"
-        } else {
-            if (-not $Quiet) {
-                Write-Host ""
-                $overwrite = Read-Host "  CLAUDE.md exists. Overwrite? (y/N)"
-                if ($overwrite -eq "y" -or $overwrite -eq "Y") {
-                    Copy-Item -Path $claudeMdSource -Destination $claudeMdDest -Force
-                    Write-Success "Updated CLAUDE.md"
-                } else {
-                    Write-Success "Kept existing CLAUDE.md"
-                }
-            } else {
-                Write-Success "CLAUDE.md already exists (kept)"
-            }
-        }
-    }
-
-    # NOTE: 不複製 dev/scripts/ 到用戶項目
-    # 腳本應該從 Tauri bundled resources 或 KenazAI 源目錄運行
-    # 如果複製到用戶項目，會導致腳本無法找到模板文件
-
-} elseif ($kenazSourceDir -eq $WorkingDirectory) {
-    Write-Success "Working in KenazAI source directory (no copy needed)"
-} else {
-    Write-Host ""
-    Write-Color "  ============================================================" "Yellow"
-    Write-Color "  WARNING: KenazAI template files not found!" "Yellow"
-    Write-Color "  ============================================================" "Yellow"
-    Write-Host ""
-    Write-Color "  The following AI configuration files are required:" "Yellow"
-    Write-Host "    - .claude/       (commands, skills, hooks)"
-    Write-Host "    - .agents/       (external skills)"
-    Write-Host "    - .githooks/     (Git hooks for RAG)"
-    Write-Host "    - CLAUDE.md      (project instructions)"
-    Write-Host ""
-    Write-Color "  To fix this, choose one of the following:" "White"
-    Write-Host ""
-    Write-Host "  Option 1: Set environment variable"
-    Write-Color "    `$env:KENAZ_SOURCE_DIR = 'C:\path\to\KenazAI'" "Cyan"
-    Write-Host ""
-    Write-Host "  Option 2: Clone KenazAI repository"
-    Write-Color "    git clone https://github.com/anthropics/kenaz-ai.git" "Cyan"
-    Write-Host "    Then run init_project.ps1 from that directory"
-    Write-Host ""
-    Write-Host "  Option 3: Manual copy"
-    Write-Host "    Copy .claude/, .agents/, and CLAUDE.md from KenazAI to:"
-    Write-Color "    $WorkingDirectory" "Cyan"
-    Write-Host ""
-    Write-Color "  ============================================================" "Yellow"
-
-    # Check what actually exists in working directory for debugging
-    Write-Host ""
-    Write-Host "  Current directory status:"
-    if (Test-Path (Join-Path $WorkingDirectory ".claude")) {
-        Write-Color "    .claude/    : EXISTS" "Green"
-    } else {
-        Write-Color "    .claude/    : MISSING" "Red"
-    }
-    if (Test-Path (Join-Path $WorkingDirectory ".agents")) {
-        Write-Color "    .agents/    : EXISTS" "Green"
-    } else {
-        Write-Color "    .agents/    : MISSING" "Red"
-    }
-    if (Test-Path (Join-Path $WorkingDirectory ".githooks")) {
-        Write-Color "    .githooks/  : EXISTS" "Green"
-    } else {
-        Write-Color "    .githooks/  : MISSING" "Red"
-    }
-    if (Test-Path (Join-Path $WorkingDirectory "CLAUDE.md")) {
-        Write-Color "    CLAUDE.md   : EXISTS" "Green"
-    } else {
-        Write-Color "    CLAUDE.md   : MISSING" "Red"
-    }
-}
-
-# ============================================================
-# Step 5: 檢查 PRODUCT_SPEC
-# ============================================================
-Write-Step 5 "Checking PRODUCT_SPEC"
-
-$specFile = Join-Path $WorkingDirectory "dev\PRODUCT_SPEC.md"
-$templateFile = Join-Path $WorkingDirectory "dev\PRODUCT_SPEC_FOR_AI_template.md"
-
-if (Test-Path $specFile) {
-    $specContent = Get-Content $specFile -Raw -Encoding UTF8
-    $lineCount = ($specContent -split "`n").Count
-
-    if ($lineCount -gt 50) {
-        Write-Color "  Found existing PRODUCT_SPEC.md ($lineCount lines)" "Yellow"
-        if (-not $Quiet) {
-            Write-Host ""
-            $keepSpec = Read-Host "  Keep existing spec? (Y/n)"
-            if ($keepSpec -eq "n" -or $keepSpec -eq "N") {
-                $backupSpec = "${specFile}.bak.$(Get-Date -Format 'yyyyMMdd_HHmmss')"
-                Move-Item $specFile $backupSpec -Force
-                Write-Success "Backed up to $backupSpec"
-
-                if (Test-Path $templateFile) {
-                    Copy-Item $templateFile $specFile
-                    Write-Success "Created new PRODUCT_SPEC.md from template"
-                }
-            } else {
-                Write-Success "Keeping existing PRODUCT_SPEC.md"
-            }
-        }
-    } else {
-        Write-Success "PRODUCT_SPEC.md exists (ready for editing)"
-    }
-} elseif (Test-Path $templateFile) {
-    Copy-Item $templateFile $specFile
-    Write-Success "Created PRODUCT_SPEC.md from template"
-} else {
-    # 沒有模板時建立基本的 PRODUCT_SPEC.md
-    $basicSpec = @"
-# Product Specification
-
-## Overview
-<!-- Describe your product here -->
-
-## Features
-<!-- List the main features -->
-
-## Technical Requirements
-<!-- List technical requirements -->
-
-## Target Users
-<!-- Describe target users -->
-
----
-*Created by Kenaz AI on $(Get-Date -Format "yyyy-MM-dd")*
-"@
-    Set-Content -Path $specFile -Value $basicSpec -Encoding UTF8
-    Write-Success "Created basic PRODUCT_SPEC.md (no template found)"
-}
-
-# ============================================================
-# Step 6: Initialize .kenaz/ structure (multi-project support)
-# ============================================================
-Write-Step 6 "Initializing .kenaz/ structure (multi-project)"
-
-# Only init .kenaz/ for sub-projects (not KenazAI core itself)
-$isSubProject = ($kenazSourceDir -and ($kenazSourceDir -ne $WorkingDirectory))
-
-if ($isSubProject) {
-    $kenazStructDir = Join-Path $WorkingDirectory ".kenaz"
-    $projectInitScript = $null
-
-    # Find project-init.js from KenazAI source
-    if ($kenazSourceDir) {
-        $candidatePath = Join-Path $kenazSourceDir ".projects\project-init.js"
-        if (Test-Path $candidatePath) {
-            $projectInitScript = $candidatePath
-        }
-    }
-
-    if ($projectInitScript) {
-        $projectName = Split-Path -Leaf $WorkingDirectory
-        $initArgs = "init --path `"$WorkingDirectory`" --name `"$projectName`" --core-path `"$kenazSourceDir`""
-
-        try {
-            $initResult = & node $projectInitScript $initArgs.Split(" ") 2>&1
-            $initResult | ForEach-Object { Write-Host "  $_" }
-            Write-Success "Initialized .kenaz/ structure"
-        } catch {
-            Write-Fail "Failed to initialize .kenaz/ structure: $_"
-        }
-    } else {
-        # Fallback: create .kenaz/ structure manually
-        $kenazTaskDirs = @("backlog", "active", "done", "blocked", "cancel")
-        $kenazLogDirs = @("unit", "solo", "squad", "legion", "misc")
-
-        # Create tasks directories
-        foreach ($dir in $kenazTaskDirs) {
-            $dirPath = Join-Path $kenazStructDir "tasks\$dir"
-            if (-not (Test-Path $dirPath)) {
-                New-Item -ItemType Directory -Path $dirPath -Force | Out-Null
-                New-Item -ItemType File -Path (Join-Path $dirPath ".gitkeep") -Force | Out-Null
-            }
-        }
-
-        # Create logs directories
-        foreach ($dir in $kenazLogDirs) {
-            $dirPath = Join-Path $kenazStructDir "logs\$dir"
-            if (-not (Test-Path $dirPath)) {
-                New-Item -ItemType Directory -Path $dirPath -Force | Out-Null
-                New-Item -ItemType File -Path (Join-Path $dirPath ".gitkeep") -Force | Out-Null
-            }
-        }
-
-        # Create project.yaml if not exists
-        $projectYamlPath = Join-Path $kenazStructDir "project.yaml"
-        if (-not (Test-Path $projectYamlPath)) {
-            $projectName = Split-Path -Leaf $WorkingDirectory
-            $projId = "proj_$([DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds())_$(Get-Random -Maximum 9999999)"
-            $corePath = if ($kenazSourceDir) { '__kenaz_core__' } else { '' }
-            $yamlContent = @"
-schema_version: 1
-project_id: $projId
-project_name: $projectName
-core_path: $corePath
-created_at: '$(Get-Date -Format "yyyy-MM-ddTHH:mm:ss.fffZ")'
-"@
-            Set-Content -Path $projectYamlPath -Value $yamlContent -Encoding UTF8
-        }
-
-        Write-Success "Created .kenaz/ structure (manual fallback)"
-    }
-} else {
-    Write-Success "Core project - .kenaz/ not needed (uses .collaboration/)"
-}
-
-# ============================================================
-# Step 7: Initialize Git (sub-project only)
-# ============================================================
-if ($isSubProject) {
-    $gitDir = Join-Path $WorkingDirectory ".git"
-    if (-not (Test-Path $gitDir)) {
-        Write-Step 7 "Initializing Git repository"
-        try {
-            Push-Location $WorkingDirectory
-            & git init --initial-branch=main 2>$null
-            if ($LASTEXITCODE -ne 0) {
-                & git init
-                & git checkout -b main 2>$null
-            }
-
-            # .gitignore
-            $gitignorePath = Join-Path $WorkingDirectory ".gitignore"
-            if (-not (Test-Path $gitignorePath)) {
-                @(
-                    "node_modules/", "__pycache__/", "*.pyc", "venv/",
-                    ".env", ".env.local", "*.db", ".chroma/"
-                ) | Set-Content -Path $gitignorePath -Encoding UTF8
-            }
-
-            & git add -A
-            & git commit -m "Initial commit: Kenaz AI project setup" --allow-empty 2>$null
-            Write-Success "Git initialized with initial commit"
-        } catch {
-            Write-Fail "Git initialization failed: $_"
-        } finally {
-            Pop-Location
-        }
-    } else {
-        # .git exists — check for initial commit
-        try {
-            Push-Location $WorkingDirectory
-            & git rev-parse HEAD 2>$null | Out-Null
-            if ($LASTEXITCODE -ne 0) {
-                Write-Step 7 "Creating initial commit (empty repo detected)"
-                & git add -A
-                & git commit -m "Initial commit: Kenaz AI project setup" --allow-empty 2>$null
-                Write-Success "Initial commit created"
-            } else {
-                Write-Success "Git already initialized"
-            }
-        } catch {
-            Write-Fail "Git check failed: $_"
-        } finally {
-            Pop-Location
-        }
-    }
-} else {
-    Write-Success "Core project - Git managed separately"
-}
-
-# ============================================================
-# Step 8: 顯示摘要和下一步
-# ============================================================
-Write-Host ""
-Write-Color "============================================================" "Green"
-Write-Color "       Initialization Complete!" "Green"
-Write-Color "============================================================" "Green"
-Write-Host ""
-Write-Host "Next Steps:"
-Write-Host ""
-Write-Color "  1. Describe your product idea to Claude" "White"
-Write-Color "     or use: /product" "Cyan"
-Write-Host ""
-Write-Color "  2. After PRD is ready, start development:" "White"
-Write-Color "     Manual:    /dev" "Cyan"
-Write-Color "     Automated: .\dev\scripts\START_DEV_AGENT.bat" "Cyan"
-Write-Host ""
-Write-Color "  3. Check progress anytime:" "White"
-Write-Color "     /progress" "Cyan"
-Write-Host ""
-Write-Color "============================================================" "Green"
-Write-Host ""
-
-# 自動啟動
-if ($AutoStart) {
-    Write-Host "Starting Claude with /product..."
-    Start-Process -FilePath "claude" -ArgumentList "/product" -NoNewWindow
-}