aico-cli 0.3.10 → 0.3.13

package/templates/hooks/hooks-config.json

@@ -0,0 +1,47 @@
+{
+  "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/notify.sh

@@ -0,0 +1,103 @@
+#!/bin/bash
+# Claude Code notification hook script
+# Plays pleasant sounds when Claude needs input or completes tasks
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SOUNDS_DIR="$SCRIPT_DIR/sounds"
+
+# Function to play a sound file with cross-platform support
+play_sound_file() {
+    local sound_file="$1"
+    
+    # Check if file exists
+    if [[ ! -f "$sound_file" ]]; then
+        echo "Warning: Sound file not found: $sound_file" >&2
+        return 1
+    fi
+    
+    # Detect OS and use appropriate command-line audio player
+    local os_type="$(uname -s)"
+    
+    case "$os_type" in
+        Darwin*)  # macOS
+            if command -v afplay &> /dev/null; then
+                afplay "$sound_file" 2>/dev/null &
+                return 0  # Exit immediately after starting playback
+            fi
+            ;;
+            
+        Linux*)   # Linux
+            # Try PulseAudio first (most common on modern desktop Linux)
+            if command -v paplay &> /dev/null; then
+                paplay "$sound_file" 2>/dev/null &
+                return 0  # Exit immediately after starting playback
+            fi
+            
+            # Try ALSA
+            if command -v aplay &> /dev/null; then
+                aplay -q "$sound_file" 2>/dev/null &
+                return 0  # Exit immediately after starting playback
+            fi
+            
+            # Try PipeWire (newer systems)
+            if command -v pw-play &> /dev/null; then
+                pw-play "$sound_file" 2>/dev/null &
+                return 0  # Exit immediately after starting playback
+            fi
+            
+            # Try sox play command
+            if command -v play &> /dev/null; then
+                play -q "$sound_file" 2>/dev/null &
+                return 0  # Exit immediately after starting playback
+            fi
+            ;;
+            
+        MINGW*|CYGWIN*|MSYS*)  # Windows (Git Bash, WSL, etc.)
+            # Try PowerShell
+            if command -v powershell.exe &> /dev/null; then
+                # Use Windows Media Player COM object for better compatibility
+                # Run in background and exit immediately
+                powershell.exe -NoProfile -Command "
+                    Start-Job -ScriptBlock {
+                        \$player = New-Object -ComObject WMPlayer.OCX
+                        \$player.URL = '$sound_file'
+                        \$player.controls.play()
+                        Start-Sleep -Milliseconds 1000
+                        \$player.close()
+                    }
+                " 2>/dev/null
+                return 0  # Exit immediately after starting playback
+            fi
+            ;;
+    esac
+    
+    # If we have ffplay (cross-platform)
+    if command -v ffplay &> /dev/null; then
+        ffplay -nodisp -autoexit -loglevel quiet "$sound_file" 2>/dev/null &
+        return 0  # Exit immediately after starting playback
+    fi
+    
+    # No audio player found - fail silently
+    return 1
+}
+
+# Main script logic
+case "$1" in
+    "input")
+        play_sound_file "$SOUNDS_DIR/input-needed.wav"
+        ;;
+        
+    "complete")
+        play_sound_file "$SOUNDS_DIR/complete.wav"
+        ;;
+        
+    *)
+        echo "Usage: $0 {input|complete}" >&2
+        echo "  input    - Play sound when Claude needs user input" >&2
+        echo "  complete - Play sound when Claude completes tasks" >&2
+        exit 1
+        ;;
+esac
+
+exit 0

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

@@ -0,0 +1,186 @@
+#!/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
+}

package/templates/hooks/requirement/post-requirement-aligner.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# 需求对齐阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local consensus_doc_path="$1"
+    local technical_doc_path="$2"
+
+    hook_log "INFO" "开始执行需求对齐后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查技术方案文档是否存在
+    if [ ! -f "$technical_doc_path" ]; then
+        hook_log "ERROR" "技术方案文档不存在: $technical_doc_path"
+        return 1
+    fi
+
+    # 更新需求状态
+    local doc_dir=$(dirname "$consensus_doc_path")
+    local req_name=$(basename "$doc_dir")
+
+    echo "待确认" > "$doc_dir/对齐状态"
+    hook_log "INFO" "技术对齐状态已设置为: 待确认"
+
+    # 记录处理完成时间
+    local completion_time=$(get_timestamp)
+    echo "$completion_time" > "$doc_dir/对齐完成时间"
+
+    # 生成技术对齐摘要
+    cat > "$doc_dir/对齐摘要.txt" << EOF
+技术对齐完成摘要
+================
+需求名称: $req_name
+对齐时间: $completion_time
+技术方案: $technical_doc_path
+状态: 待确认
+
+涉及技术栈:
+$(cat "$AICO_HOOKS_TEMP_DIR/tech-context.txt" 2>/dev/null || echo "未记录")
+
+处理步骤:
+1. ✅ 技术分析完成
+2. ✅ 实施方案制定
+3. ⏳ 等待用户确认
+EOF
+
+    hook_log "INFO" "需求对齐后置处理完成"
+
+    # 更新 hook 状态
+    update_hook_status "requirement-aligner" "success"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/post-requirement-identifier.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+# 需求识别阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local requirement_desc="$1"
+    local consensus_doc_path="$2"
+
+    hook_log "INFO" "开始执行需求识别后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查共识文档是否存在
+    if [ ! -f "$consensus_doc_path" ]; then
+        hook_log "ERROR" "共识文档不存在: $consensus_doc_path"
+        return 1
+    fi
+
+    # 更新需求状态
+    local req_name=$(echo "$requirement_desc" | head -c 20 | tr ' ' '_' | tr -cd '[:alnum:]_-')
+    local doc_dir=".aico/docs/$req_name"
+
+    echo "待确认" > "$doc_dir/状态"
+    hook_log "INFO" "需求状态已设置为: 待确认"
+
+    # 记录处理完成时间
+    local completion_time=$(get_timestamp)
+    echo "$completion_time" > "$doc_dir/识别完成时间"
+
+    # 生成处理摘要
+    cat > "$doc_dir/识别摘要.txt" << EOF
+需求识别完成摘要
+================
+需求描述: $requirement_desc
+识别时间: $completion_time
+共识文档: $consensus_doc_path
+状态: 待确认
+
+处理步骤:
+1. ✅ 需求分析完成
+2. ✅ 共识文档生成
+3. ⏳ 等待用户确认
+EOF
+
+    hook_log "INFO" "需求识别后置处理完成"
+
+    # 更新 hook 状态
+    update_hook_status "requirement-identifier" "success"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/post-task-executor-validator.sh

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+# 质量验证阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local completion_report_path="$1"
+    local validation_report_path="$2"
+
+    hook_log "INFO" "开始执行质量验证后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查验证报告文档是否存在
+    if [ ! -f "$validation_report_path" ]; then
+        hook_log "ERROR" "验证报告文档不存在: $validation_report_path"
+        return 1
+    fi
+
+    # 分析验证结果
+    local doc_dir=$(dirname "$completion_report_path")
+    local req_name=$(basename "$doc_dir")
+
+    # 统计验证结果
+    local passed_count=$(grep -c "✅\|通过" "$validation_report_path" 2>/dev/null || echo "0")
+    local failed_count=$(grep -c "❌\|失败" "$validation_report_path" 2>/dev/null || echo "0")
+    local total_count=$((passed_count + failed_count))
+
+    # 更新验证状态
+    if [ "$failed_count" -eq 0 ]; then
+        echo "验证通过" > "$doc_dir/验证状态"
+        hook_log "INFO" "所有验证项通过"
+    else
+        echo "验证未通过" > "$doc_dir/验证状态"
+        hook_log "WARN" "有 $failed_count 个验证项未通过"
+    fi
+
+    # 记录验证完成时间
+    local completion_time=$(get_timestamp)
+    echo "$completion_time" > "$doc_dir/验证完成时间"
+
+    # 生成验证摘要
+    cat > "$doc_dir/验证摘要.txt" << EOF
+质量验证完成摘要
+================
+需求名称: $req_name
+验证时间: $completion_time
+验证报告: $validation_report_path
+总验证项: $total_count
+通过项: $passed_count
+未通过项: $failed_count
+验证状态: $(if [ "$failed_count" -eq 0 ]; then echo "验证通过"; else echo "验证未通过"; fi)
+
+验证统计:
+- ✅ 通过: $passed_count
+- ❌ 未通过: $failed_count
+- 📊 总计: $total_count
+
+质量评级: $(if [ "$failed_count" -eq 0 ]; then echo "优秀"; elif [ "$passed_count" -gt "$failed_count" ]; then echo "良好"; else echo "需改进"; fi)
+
+处理步骤:
+1. ✅ 质量验证完成
+2. ✅ 验证报告生成
+3. ✅ 质量评级确定
+4. 🎯 需求生命周期完成
+EOF
+
+    # 更新整体需求状态
+    if [ "$failed_count" -eq 0 ]; then
+        echo "已完成" > "$doc_dir/需求状态"
+        hook_log "INFO" "需求生命周期完成，质量评级: 优秀"
+    else
+        echo "部分完成" > "$doc_dir/需求状态"
+        hook_log "INFO" "需求生命周期完成，质量评级: $(if [ "$passed_count" -gt "$failed_count" ]; then echo "良好"; else echo "需改进"; fi)"
+    fi
+
+    hook_log "INFO" "质量验证后置处理完成，通过: $passed_count, 未通过: $failed_count"
+
+    # 更新 hook 状态
+    update_hook_status "task-executor-validator" "success"
+
+    # 清理临时状态文件
+    cleanup_hook_status "requirement-identifier"
+    cleanup_hook_status "requirement-aligner"
+    cleanup_hook_status "task-splitter-validator"
+    cleanup_hook_status "task-executor"
+    cleanup_hook_status "task-executor-validator"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/post-task-executor.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# 任务执行阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local task_list_path="$1"
+    local completion_report_path="$2"
+
+    hook_log "INFO" "开始执行任务执行后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查完成报告文档是否存在
+    if [ ! -f "$completion_report_path" ]; then
+        hook_log "ERROR" "完成报告文档不存在: $completion_report_path"
+        return 1
+    fi
+
+    # 分析执行结果
+    local doc_dir=$(dirname "$task_list_path")
+    local req_name=$(basename "$doc_dir")
+
+    # 统计成功/失败任务数
+    local success_count=$(grep -c "✅\|成功" "$completion_report_path" 2>/dev/null || echo "0")
+    local failed_count=$(grep -c "❌\|失败" "$completion_report_path" 2>/dev/null || echo "0")
+    local total_count=$((success_count + failed_count))
+
+    # 更新执行状态
+    if [ "$failed_count" -eq 0 ]; then
+        echo "全部完成" > "$doc_dir/执行状态"
+        hook_log "INFO" "所有任务执行成功"
+    else
+        echo "部分完成" > "$doc_dir/执行状态"
+        hook_log "WARN" "有 $failed_count 个任务执行失败"
+    fi
+
+    # 记录处理完成时间
+    local completion_time=$(get_timestamp)
+    echo "$completion_time" > "$doc_dir/执行完成时间"
+
+    # 生成执行摘要
+    cat > "$doc_dir/执行摘要.txt" << EOF
+任务执行完成摘要
+================
+需求名称: $req_name
+完成时间: $completion_time
+完成报告: $completion_report_path
+总任务数: $total_count
+成功任务: $success_count
+失败任务: $failed_count
+执行状态: $(if [ "$failed_count" -eq 0 ]; then echo "全部完成"; else echo "部分完成"; fi)
+
+执行统计:
+- ✅ 成功: $success_count
+- ❌ 失败: $failed_count
+- ⏳ 总计: $total_count
+
+处理步骤:
+1. ✅ 任务执行完成
+2. ✅ 结果统计汇总
+3. ✅ 执行报告生成
+4. 🔄 等待质量验证
+EOF
+
+    hook_log "INFO" "任务执行后置处理完成，成功: $success_count, 失败: $failed_count"
+
+    # 更新 hook 状态
+    update_hook_status "task-executor" "success"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"