aico-cli 0.3.20 → 0.4.0

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')
-**兼容性状态**: ✅ 生产环境就绪

package/templates/hooks/claude-code-hook-config.json

@@ -1,35 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/claude-code-settings.json",
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/hooks/notify.sh input"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/hooks/notify.sh complete"
-          }
-        ]
-      }
-    ],
-    "Notification": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "~/.claude/hooks/notify.sh complete"
-          }
-        ]
-      }
-    ]
-  }
-}

package/templates/hooks/hooks-config.json

@@ -1,47 +0,0 @@
-{
-  "version": "1.0.0",
-  "description": "需求管理生命周期 Hook 配置",
-  "hooks": {
-    "requirement-identifier": {
-      "pre": "requirement/pre-requirement-identifier.sh",
-      "post": "requirement/post-requirement-identifier.sh",
-      "dependencies": [],
-      "timeout": 30000,
-      "enabled": true
-    },
-    "requirement-aligner": {
-      "pre": "requirement/pre-requirement-aligner.sh",
-      "post": "requirement/post-requirement-aligner.sh",
-      "dependencies": ["requirement-identifier"],
-      "timeout": 30000,
-      "enabled": true
-    },
-    "task-splitter-validator": {
-      "pre": "requirement/pre-task-splitter-validator.sh",
-      "post": "requirement/post-task-splitter-validator.sh",
-      "dependencies": ["requirement-aligner"],
-      "timeout": 30000,
-      "enabled": true
-    },
-    "task-executor": {
-      "pre": "requirement/pre-task-executor.sh",
-      "post": "requirement/post-task-executor.sh",
-      "dependencies": ["task-splitter-validator"],
-      "timeout": 60000,
-      "enabled": true
-    },
-    "task-executor-validator": {
-      "pre": "requirement/pre-task-executor-validator.sh",
-      "post": "requirement/post-task-executor-validator.sh",
-      "dependencies": ["task-executor"],
-      "timeout": 30000,
-      "enabled": true
-    }
-  },
-  "global": {
-    "maxRetries": 3,
-    "retryDelay": 1000,
-    "logLevel": "info",
-    "tempDir": "/tmp/aico-hooks"
-  }
-}

package/templates/hooks/requirement/common-utils.sh

@@ -1,186 +0,0 @@
-#!/usr/bin/env bash
-# 需求管理 Hook 通用工具库
-
-# 加载跨平台基础工具
-# 计算相对路径
-HOOKS_DIR="$(dirname "$(dirname "${BASH_SOURCE[0]}")")"
-CROSSPLATFORM_UTILS="$HOOKS_DIR/../agents/aico/requirement/crossplatform-utils.sh"
-
-if [ -f "$CROSSPLATFORM_UTILS" ]; then
-    source "$CROSSPLATFORM_UTILS"
-else
-    echo "⚠️  跨平台工具库未找到: $CROSSPLATFORM_UTILS"
-    # 提供基本的兼容函数
-    get_timestamp() { date '+%Y-%m-%d %H:%M:%S'; }
-    safe_mkdir() { mkdir -p "$1"; }
-    safe_rmdir() { rm -rf "$1" 2>/dev/null || true; }
-    get_temp_dir() { echo "/tmp"; }
-fi
-
-# Hook 日志函数
-hook_log() {
-    local level="$1"
-    local message="$2"
-    local timestamp=$(get_timestamp)
-
-    case "$level" in
-        "INFO") echo "[INFO] $timestamp - $message" ;;
-        "WARN") echo "[WARN] $timestamp - $message" >&2 ;;
-        "ERROR") echo "[ERROR] $timestamp - $message" >&2 ;;
-        "DEBUG") echo "[DEBUG] $timestamp - $message" ;;
-        *) echo "[$level] $timestamp - $message" ;;
-    esac
-}
-
-# 检查 Hook 前置条件
-check_hook_prerequisites() {
-    local hook_name="$1"
-    local config_file="$HOOKS_DIR/hooks-config.json"
-
-    if [ ! -f "$config_file" ]; then
-        hook_log "WARN" "Hook 配置文件不存在: $config_file，跳过配置检查"
-        return 0
-    fi
-
-    # 检查 Hook 是否启用
-    if command -v jq >/dev/null 2>&1; then
-        local enabled=$(jq -r ".hooks.\"$hook_name\".enabled" "$config_file" 2>/dev/null)
-        if [ "$enabled" != "true" ]; then
-            hook_log "WARN" "Hook $hook_name 未启用，跳过执行"
-            return 2
-        fi
-    else
-        hook_log "DEBUG" "jq 命令不可用，跳过配置检查"
-    fi
-
-    return 0
-}
-
-# 执行 Hook 脚本
-execute_hook() {
-    local hook_type="$1"  # pre 或 post
-    local hook_name="$2"  # hook 名称
-    local hook_args="${@:3}"  # 额外参数
-
-    local config_file="$HOOKS_DIR/hooks-config.json"
-    local hook_script=""
-
-    if [ -f "$config_file" ] && command -v jq >/dev/null 2>&1; then
-        hook_script=$(jq -r ".hooks.\"$hook_name\".\"$hook_type\"" "$config_file" 2>/dev/null)
-    fi
-
-    # 如果没有配置文件或 jq 不可用，使用默认路径
-    if [ -z "$hook_script" ] || [ "$hook_script" = "null" ]; then
-        hook_script="requirement/$hook_type-$hook_name.sh"
-        hook_log "DEBUG" "使用默认 Hook 路径: $hook_script"
-    fi
-
-    local full_script_path="$HOOKS_DIR/$hook_script"
-
-    if [ ! -f "$full_script_path" ]; then
-        hook_log "ERROR" "Hook 脚本不存在: $full_script_path"
-        return 1
-    fi
-
-    if [ ! -x "$full_script_path" ]; then
-        set_executable "$full_script_path"
-    fi
-
-    hook_log "INFO" "执行 $hook_type hook: $hook_name"
-
-    # 执行 hook 脚本
-    if "$full_script_path" $hook_args; then
-        hook_log "INFO" "Hook $hook_name $hook_type 执行成功"
-        return 0
-    else
-        hook_log "ERROR" "Hook $hook_name $hook_type 执行失败"
-        return 1
-    fi
-}
-
-# 检查依赖关系
-check_dependencies() {
-    local hook_name="$1"
-    local config_file="$(dirname "${BASH_SOURCE[0]}")/../../hooks-config.json"
-
-    local dependencies=$(jq -r ".hooks.\"$hook_name\".dependencies[]" "$config_file" 2>/dev/null)
-
-    for dep in $dependencies; do
-        if [ -n "$dep" ] && [ "$dep" != "null" ]; then
-            # 检查依赖的 hook 是否已成功执行
-            local dep_status_file="$(get_temp_dir)/aico-hooks/$dep.status"
-            if [ ! -f "$dep_status_file" ] || [ "$(cat "$dep_status_file")" != "success" ]; then
-                hook_log "ERROR" "依赖的 hook $dep 未成功执行"
-                return 1
-            fi
-        fi
-    done
-
-    return 0
-}
-
-# 更新 Hook 状态
-update_hook_status() {
-    local hook_name="$1"
-    local status="$2"  # success 或 failed
-
-    local status_dir="$(get_temp_dir)/aico-hooks"
-    safe_mkdir "$status_dir"
-
-    echo "$status" > "$status_dir/$hook_name.status"
-}
-
-# 获取 Hook 状态
-get_hook_status() {
-    local hook_name="$1"
-    local status_file="$(get_temp_dir)/aico-hooks/$hook_name.status"
-
-    if [ -f "$status_file" ]; then
-        cat "$status_file"
-    else
-        echo "unknown"
-    fi
-}
-
-# 清理临时状态
-cleanup_hook_status() {
-    local hook_name="$1"
-    local status_dir="$(get_temp_dir)/aico-hooks"
-
-    safe_rm "$status_dir/$hook_name.status"
-}
-
-# 验证需求文档状态
-validate_requirement_status() {
-    local requirement_name="$1"
-    local expected_status="$2"  # 如 "已确认"
-
-    local doc_dir=".aico/docs/$requirement_name"
-    local status_file="$doc_dir/状态"
-
-    if [ ! -f "$status_file" ]; then
-        hook_log "ERROR" "需求状态文件不存在: $status_file"
-        return 1
-    fi
-
-    local current_status=$(cat "$status_file")
-    if [ "$current_status" != "$expected_status" ]; then
-        hook_log "ERROR" "需求状态不匹配。期望: $expected_status, 实际: $current_status"
-        return 1
-    fi
-
-    return 0
-}
-
-# 初始化 Hook 环境
-init_hook_environment() {
-    export AICO_HOOKS_DIR="$(dirname "${BASH_SOURCE[0]}")/../.."
-    export AICO_HOOKS_TEMP_DIR="$(get_temp_dir)/aico-hooks"
-
-    safe_mkdir "$AICO_HOOKS_TEMP_DIR"
-
-    # 设置日志级别
-    if [ -z "$AICO_HOOKS_LOG_LEVEL" ]; then
-        export AICO_HOOKS_LOG_LEVEL="info"
-    fi
-}