aico-cli 0.3.17 → 0.4.0

package/templates/windows-bootstrap.ps1

@@ -0,0 +1,390 @@
+# AICO CLI Windows PowerShell 启动引导脚本
+# 提供 .sh 脚本的完整 PowerShell 兼容实现
+
+param(
+    [Parameter(Mandatory=$true, Position=0)]
+    [string]$Command,
+
+    [Parameter(Position=1, ValueFromRemainingArguments=$true)]
+    [string[]]$Arguments = @()
+)
+
+# 全局路径配置
+$AICO_ROOT = Split-Path -Parent $PSScriptRoot
+$AICO_TEMPLATES = Join-Path $AICO_ROOT "templates"
+$AICO_UTILS = Join-Path $AICO_TEMPLATES "utils"
+$AICO_HOOKS = Join-Path $AICO_TEMPLATES "hooks"
+$AICO_AGENTS = Join-Path $AICO_TEMPLATES "agents"
+
+# 版本信息
+$SCRIPT_VERSION = "1.0.0"
+$SCRIPT_BUILD = "2025-01-16"
+
+# 控制台输出美化
+function Write-AicoBanner {
+    Write-Host @"
+╔═══════════════════════════════════════════════════════════════════════════════════════╗
+║                                                                                       ║
+║    🚀 AICO CLI - PowerShell 跨平台兼容层                                  ║
+║    版本: $SCRIPT_VERSION | 构建: $SCRIPT_BUILD                         ║
+║    Windows PowerShell 环境专用                                                    ║
+║                                                                                       ║
+╚═══════════════════════════════════════════════════════════════════════════════════════╝
+"@ -ForegroundColor Cyan
+}
+
+# 日志函数
+function Write-AicoLog {
+    param(
+        [string]$Message,
+        [ValidateSet("INFO", "WARN", "ERROR", "DEBUG")]
+        [string]$Level = "INFO",
+        [string]$Source = "windows-bootstrap"
+    )
+
+    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    $entry = "[$Level] [$Source] $timestamp - $Message"
+
+    switch ($Level) {
+        "WARN" { Write-Host $entry -ForegroundColor Yellow }
+        "ERROR" { Write-Host $entry -ForegroundColor Red }
+        "DEBUG" { Write-Host $entry -ForegroundColor Gray }
+        default { Write-Host $entry -ForegroundColor White }
+    }
+
+    # 文件日志
+    $logFile = Join-Path $env:USERPROFILE ".claude\aico-windows.log"
+    $logDir = Split-Path -Parent $logFile
+    if (!(Test-Path $logDir)) {
+        New-Item -ItemType Directory -Path $logDir -Force | Out-Null
+    }
+    Add-Content -Path $logFile -Value $entry -Force
+}
+
+# 平台检测与兼容性检查
+function Test-PlatformCompatibility {
+    $os = [System.Environment]::OSVersion
+    $isWindows = $os.Platform -eq "Win32NT"
+    $hasWSL = Test-Path "C:\Windows\System32\wsl.exe"
+    $hasGitBash = Test-Path "C:\Program Files\Git\bin\bash.exe"
+
+    $compat = @{
+        IsWindows = $isWindows
+        HasWSL = $hasWSL
+        HasGitBash = $hasGitBash
+        PowerShellVersion = $PSVersionTable.PSVersion.ToString()
+        IsAdmin = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
+    }
+
+    return $compat
+}
+
+# 路径转换工具
+function Convert-ToWindowsPath {
+    param([string]$UnixPath)
+
+    # Git Bash/Cygwin 路径转换
+    if ($UnixPath -match '^/([a-zA-Z])/(.*)') {
+        $drive = $Matches[1].ToUpper()
+        $path = $Matches[2] -replace '/', '\'
+        return "${drive}:\${path}"
+    }
+
+    # 已经是 Windows 路径
+    if ($UnixPath -match '^[a-zA-Z]:\') {
+        return $UnixPath
+    }
+
+    # 相对路径
+    return $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($UnixPath)
+}
+
+# .sh 脚本 PowerShell 适配器
+function Invoke-BashScriptAdapter {
+    param(
+        [string]$ScriptPath,
+        [string[]]$ScriptArgs = @()
+    )
+
+    if (!(Test-Path $ScriptPath)) {
+        Write-AicoLog -Level "ERROR" -Message "脚本文件不存在: $ScriptPath"
+        return $false
+    }
+
+    # 查找对应的 PowerShell 版本
+    $psScript = $ScriptPath -replace '\.sh$', '.ps1'
+    if (Test-Path $psScript) {
+        Write-AicoLog -Level "INFO" -Message "发现 PowerShell 版本: $psScript"
+        try {
+            & $psScript @ScriptArgs
+            return $LASTEXITCODE -eq 0
+        }
+        catch {
+            Write-AicoLog -Level "ERROR" -Message "PowerShell 脚本执行失败: $($_.Exception.Message)"
+            return $false
+        }
+    }
+
+    # 如果没有 PS 版本，使用通用适配器
+    Write-AicoLog -Level "WARN" -Message "未找到 PowerShell 版本，使用通用适配器"
+    return Invoke-GenericBashAdapter -ScriptPath $ScriptPath -Args $ScriptArgs
+}
+
+# 通用 Bash 适配器
+function Invoke-GenericBashAdapter {
+    param([string]$ScriptPath, [string[]]$Args)
+
+    try {
+        # 读取脚本内容分析
+        $content = Get-Content $ScriptPath -Raw
+
+        # 基本模式识别
+        if ($content -match 'notify\.sh') {
+
+            return Invoke-NotifyAdapter -Content $content -Args $Args
+        }
+        elseif ($content -match 'task-manager') {
+            return Invoke-TaskManagerAdapter -Content $content -Args $Args
+        }
+        elseif ($content -match 'requirement') {
+            return Invoke-RequirementAdapter -Content $content -Args $Args
+        }
+        else {
+            Write-AicoLog -Level "WARN" -Message "未知脚本类型，尝试调用 PowerShell 通用启动器"
+            $launcher = Join-Path $AICO_UTILS "platform-launcher.ps1"
+            if (Test-Path $launcher) {
+                & $launcher -ScriptType "generic" -Arguments @($ScriptPath) + $Args
+                return $LASTEXITCODE -eq 0
+            }
+            return $false
+        }
+    }
+    catch {
+        Write-AicoLog -Level "ERROR" -Message "通用适配失败: $($_.Exception.Message)"
+        return $false
+    }
+}
+
+# 通知系统适配器
+function Invoke-NotifyAdapter {
+    param([string]$Content, [string[]]$Args)
+
+    Write-AicoLog -Level "INFO" -Message "调用通知系统适配器"
+
+    if ($Args.Count -gt 0) {
+        $eventType = $Args[0]
+        $notifyScript = Join-Path $AICO_HOOKS "notify.ps1"
+
+        if (Test-Path $notifyScript) {
+            & $notifyScript -EventType $eventType
+            return $LASTEXITCODE -eq 0
+        } else {
+            # 备用方案：使用系统提示
+            switch ($eventType) {
+                "input" {
+                    [System.Console]::Beep(1000, 200)
+                    Write-Host "🎯 Claude Code: 需要您的输入" -ForegroundColor Yellow
+                }
+                "complete" {
+                    [System.Console]::Beep(2000, 100)
+                    Write-Host "✅ Claude Code: 任务完成" -ForegroundColor Green
+                }
+            }
+            return $true
+        }
+    }
+
+    return $false
+}
+
+# 任务管理适配器
+function Invoke-TaskManagerAdapter {
+    param([string]$Content, [string[]]$Args)
+
+    Write-AicoLog -Level "INFO" -Message "调用任务管理适配器"
+
+    if ($Args.Count -ge 2) {
+        $command = $Args[0]
+        $taskListPath = Convert-ToWindowsPath $Args[1]
+        $taskId = if ($Args.Count -ge 3) { $Args[2] } else { "" }
+
+        $taskManager = Join-Path $AICO_UTILS "task-manager.ps1"
+        if (Test-Path $taskManager) {
+            & $taskManager $command $taskListPath $taskId
+            return $LASTEXITCODE -eq 0
+        } else {
+            Write-AicoLog -Level "ERROR" -Message "任务管理器 PowerShell 版本未找到"
+            return $false
+        }
+    }
+
+    return $false
+}
+
+# 需求管理适配器
+function Invoke-RequirementAdapter {
+    param([string]$Content, [string[]]$Args)
+
+    Write-AicoLog -Level "INFO" -Message "调用需求管理适配器"
+
+    # 需求管理相关脚本的统一处理
+    if ($Content -match 'requirement.*processor') {
+        # 需求处理器
+        if ($Args.Count -gt 0) {
+            $userInput = $Args -join " "
+            Write-AicoLog -Level "INFO" -Message "处理需求: $userInput"
+            Write-Host "🎯 需求识别完成，等待技术方案生成..." -ForegroundColor Green
+            return $true
+        }
+    }
+
+    return $true  # 大多数需求管理脚本是信息收集，返回成功
+}
+
+# 命令分发
+function Invoke-AicoCommand {
+    param([string]$Cmd, [string[]]$Args)
+
+    Write-AicoLog -Level "DEBUG" -Message "执行命令: $Cmd 参数: $($Args -join ' ')"
+
+    switch ($Cmd.ToLower()) {
+        "notify" {
+            return Invoke-NotifyAdapter -Content "" -Args $Args
+        }
+
+        "task-manager" {
+            return Invoke-TaskManagerAdapter -Content "" -Args $Args
+        }
+
+        { $_ -in @("requirement", "hooks", "pre-requirement", "post-requirement") } {
+            return Invoke-RequirementAdapter -Content $Cmd -Args $Args
+        }
+
+        "platform-info" {
+            $compat = Test-PlatformCompatibility
+            Write-Host "平台兼容性信息:"
+            $compat | ConvertTo-Json -Depth 3 | Write-Host
+            return $true
+        }
+
+        "test-connection" {
+            Write-AicoLog -Level "INFO" -Message "测试与 PowerShell 环境的连接..."
+
+            # 测试音频
+            try {
+                [Console]::Beep(1000, 100)
+                Write-Host "🔊 音频测试通过" -ForegroundColor Green
+            } catch {
+                Write-Host "⚠️ 音频测试失败" -ForegroundColor Yellow
+            }
+
+            # 测试路径访问
+            try {
+                Test-Path $AICO_HOOKS
+                Test-Path $AICO_UTILS
+                Write-Host "📁 路径访问测试通过" -ForegroundColor Green
+            } catch {
+                Write-Host "❌ 路径访问测试失败" -ForegroundColor Red
+            }
+
+            return $true
+        }
+
+        "help" {
+            Show-Usage
+            return $true
+        }
+
+        default {
+            # 尝试作为脚本文件执行
+            $scriptPath = Join-Path $AICO_HOOKS "$Cmd.ps1"
+            if (Test-Path $scriptPath) {
+                try {
+                    & $scriptPath @Args
+                    return $LASTEXITCODE -eq 0
+                }
+                catch {
+                    Write-AicoLog -Level "ERROR" -Message "直接脚本执行失败: $($_.Exception.Message)"
+                    return $false
+                }
+            }
+
+            # 最后尝试 Bash 适配器
+            $bashScript = Join-Path $AICO_HOOKS "$Cmd.sh"
+            if (Test-Path $bashScript) {
+                return Invoke-BashScriptAdapter -ScriptPath $bashScript -ScriptArgs $Args
+            }
+
+            Write-AicoLog -Level "ERROR" -Message "未知命令或脚本: $Cmd"
+            return $false
+        }
+    }
+}
+
+function Show-Usage {
+    Write-Host @"
+🚀 AICO CLI Windows PowerShell 启动器
+
+📋 可用命令:
+  notify [input|complete]     - 触发通知系统
+  task-manager <command>      - 任务管理操作
+  requirement <user-input>    - 处理用户需求
+  platform-info               - 显示平台兼容性信息
+  test-connection             - 连接性测试
+  <script-name> [args...]     - 执行特定脚本
+
+🔧 PowerShell 脚本兼容性:
+  ✓ 原生 PowerShell 脚本
+  ✓ 增强的Bash脚本适配器
+  ✓ 跨平台路径转换
+  ✓ Windows音频系统集成
+
+💡 使用示例:
+  .\windows-bootstrap.ps1 notify input
+  .\windows-bootstrap.ps1 requirement "开发用户登录功能"
+  .\windows-bootstrap.ps1 platform-info
+  .\windows-bootstrap.ps1 notify complete
+
+🎯 文件位置:
+  日志文件: $env:USERPROFILE\.claude\aico-windows.log
+  临时数据: $env:TEMP\aico-hooks\
+"@ -ForegroundColor Cyan
+}
+
+# 主函数
+function Main {
+    Write-AicoBanner
+    Write-AicoLog -Level "INFO" -Message "AICO Windows Bootstrap 启动"
+
+    # 平台兼容性检查
+    $compat = Test-PlatformCompatibility
+    Write-AicoLog -Level "DEBUG" -Message "平台信息: $($compat | ConvertTo-Json -Compress)"
+
+    if (!$compat.IsWindows) {
+        Write-AicoLog -Level "ERROR" -Message "非 Windows 环境，此脚本专用于 Windows"
+        return 1
+    }
+
+    Write-AicoLog -Level "INFO" -Message "执行命令: $Command 参数: $($Arguments -join ' ')"
+
+    # 执行命令
+    $result = Invoke-AicoCommand -Cmd $Command -Args $Arguments
+
+    if ($result) {
+        Write-AicoLog -Level "SUCCESS" -Message "命令执行成功: $Command"
+        return 0
+    } else {
+        Write-AicoLog -Level "ERROR" -Message "命令执行失败: $Command"
+        return 1
+    }
+}
+
+# 入口点
+try {
+    exit (Main)
+}
+catch {
+    Write-AicoLog -Level "ERROR" -Message "引导程序异常: $($_.Exception.Message)"
+    Write-Host "❌ 引导程序异常，查看日志获取详情: $env:USERPROFILE\.claude\aico-windows.log" -ForegroundColor Red
+    exit 1
+}

package/templates/agents/aico/requirement/PLATFORM_COMPATIBILITY.md

@@ -1,219 +0,0 @@
-# 🌐 跨平台兼容性指南
-
-## 支持的操作系统
-
-### ✅ 完全支持
-- **Windows 10/11** (通过以下环境)
-  - Git Bash (推荐)
-  - Cygwin
-  - WSL (Windows Subsystem for Linux)
-  - MSYS2
-
-- **macOS** (10.15+)
-  - 原生终端
-  - iTerm2
-  - 任何兼容的终端环境
-
-- **Linux** (主流发行版)
-  - Ubuntu/Debian
-  - CentOS/RHEL
-  - Fedora
-  - Arch Linux
-  - 其他基于 GNU/Linux 的系统
-
-## 🛠️ 环境要求
-
-### 基本依赖
-所有平台都需要以下基本工具：
-- `bash` (版本 4.0+)
-- `coreutils` (包含基本 Unix 命令)
-- `grep`
-- `sed`
-- `head`/`tail`
-- `mkdir`/`cat`/`echo`
-
-### Windows 特定设置
-
-#### 选项1: Git for Windows (推荐)
-```bash
-# 1. 下载安装 Git for Windows
-#    https://git-scm.com/download/win
-
-# 2. 启动 Git Bash
-# 3. 导航到脚本目录
-cd /c/path/to/your/project
-
-# 4. 运行脚本
-./requirement-launcher.sh "您的需求"
-```
-
-#### 选项2: WSL (Windows Subsystem for Linux)
-```bash
-# 1. 启用 WSL
-wsl --install
-
-# 2. 安装 Ubuntu
-wsl --install -d Ubuntu
-
-# 3. 启动 WSL
-wsl
-
-# 4. 安装必要工具
-sudo apt update && sudo apt install git bash
-
-# 5. 运行脚本
-./requirement-launcher.sh "您的需求"
-```
-
-#### 选项3: Cygwin
-```bash
-# 1. 安装 Cygwin
-#    https://www.cygwin.com/
-
-# 2. 确保安装以下包：
-#    - bash
-#    - coreutils
-#    - grep
-#    - sed
-
-# 3. 运行脚本
-./requirement-launcher.sh "您的需求"
-```
-
-### macOS 设置
-```bash
-# 确保已安装 Xcode Command Line Tools
-xcode-select --install
-
-# 或者使用 Homebrew 安装最新工具
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-brew install coreutils
-
-# 运行脚本
-./requirement-launcher.sh "您的需求"
-```
-
-### Linux 设置
-```bash
-# Ubuntu/Debian
-sudo apt update && sudo apt install bash coreutils
-
-# CentOS/RHEL
-sudo yum install bash coreutils
-
-# Fedora
-sudo dnf install bash coreutils
-
-# 运行脚本
-./requirement-launcher.sh "您的需求"
-```
-
-## 📁 文件结构
-
-```
-agents/aico/requirement/
-├── requirement-functions-crossplatform.sh  # 跨平台主函数库
-├── requirement-launcher.sh                 # 跨平台启动器
-├── requirement-functions.sh                # 原版函数库 (Unix only)
-├── PLATFORM_COMPATIBILITY.md              # 本文件
-└── *.md                                   # 其他文档文件
-```
-
-## 🔧 技术实现细节
-
-### 平台检测
-脚本会自动检测运行环境：
-- `Darwin` → macOS
-- `Linux` → Linux
-- `CYGWIN*|MINGW*|MSYS*` → Windows
-
-### 路径处理
-- **Windows**: 自动处理路径分隔符 (`/` → `\\`)
-- **临时目录**: 使用平台适当的临时目录
-- **家目录**: 自动识别 Windows (`%USERPROFILE%`) 和 Unix (`$HOME`)
-
-### 命令兼容性
-- 使用 `command -v` 代替 `which`
-- 提供命令回退机制
-- 统一的错误处理
-
-## 🚀 快速开始
-
-### 所有平台通用命令
-```bash
-# 1. 确保脚本有执行权限
-chmod +x requirement-launcher.sh
-chmod +x requirement-functions-crossplatform.sh
-
-# 2. 运行需求识别
-./requirement-launcher.sh "需要开发用户登录功能"
-
-# 3. 或者直接使用函数库
-source requirement-functions-crossplatform.sh
-main_workflow "需要修复页面加载性能问题"
-```
-
-### Windows 特定示例
-```bash
-# 在 Git Bash 中:
-cd /c/Users/YourName/project
-./requirement-launcher.sh "创建新的API接口"
-
-# 在 PowerShell 中启动 Git Bash:
-Start-Process "C:\\Program Files\\Git\\git-bash.exe" -ArgumentList "-c", "cd /c/path/to/project && ./requirement-launcher.sh '您的需求'"
-```
-
-## 🧪 测试验证
-
-### 基本功能测试
-```bash
-# 测试平台检测
-./requirement-launcher.sh "测试平台兼容性"
-
-# 测试需求分析
-./requirement-launcher.sh "需要添加数据导出功能"
-
-# 测试文档生成
-./requirement-launcher.sh "创建用户管理模块"
-```
-
-### 跨平台一致性验证
-确保在所有平台上产生相同的结果：
-- 相同的需求识别结果
-- 相同的文档输出格式
-- 相同的状态管理行为
-
-## ⚠️ 已知限制
-
-1. **Windows 原生 CMD/PowerShell**: 不支持，必须使用兼容环境
-2. **非常旧的系统**: 可能需要手动安装更新版本的 bash
-3. **特殊字符处理**: 某些特殊字符在不同 shell 中可能有不同行为
-4. **文件权限**: Windows 和 Unix 文件权限模型不同
-
-## 🔄 更新和维护
-
-### 添加新平台支持
-1. 在 `detect_platform()` 中添加新的平台检测
-2. 在相应的平台分支中添加特殊处理逻辑
-3. 更新测试用例
-4. 更新本文档
-
-### 维护跨平台兼容性
-- 避免使用平台特定的命令
-- 使用 POSIX 兼容的语法
-- 提供适当的回退机制
-- 定期在不同平台上测试
-
-## 📞 技术支持
-
-如果遇到平台兼容性问题：
-
-1. 检查 `detect_platform` 函数的输出
-2. 验证基本依赖是否安装
-3. 查看具体的错误信息
-4. 参考对应平台的设置指南
-
----
-
-**最后更新**: $(date '+%Y-%m-%d')
-**兼容性状态**: ✅ 生产环境就绪