cc-devflow 1.0.1

package/.claude/scripts/recover-workflow.sh

@@ -0,0 +1,460 @@
+#!/usr/bin/env bash
+# recover-workflow.sh - 从中断恢复工作流
+# 智能检测中断点，选择最佳恢复策略
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m' # No Color
+
+# 使用说明
+usage() {
+    cat << EOF
+用法: $0 [选项] REQ_ID
+
+从中断点恢复需求开发工作流
+
+参数:
+  REQ_ID                  需求编号 (例如: REQ-123)
+
+选项:
+  -h, --help              显示此帮助信息
+  --from STAGE            从指定阶段重新开始 (init/prd/epic/dev/qa/release)
+  --force                 强制恢复，跳过安全检查
+  --dry-run               显示恢复计划但不执行
+  --verbose               显示详细信息
+
+阶段说明:
+  init      - 初始化阶段
+  prd       - PRD生成阶段
+  epic      - Epic规划阶段
+  dev       - 开发执行阶段
+  qa        - 质量保证阶段
+  release   - 发布管理阶段
+
+示例:
+  $0 REQ-123                          # 自动检测并恢复
+  $0 REQ-123 --from dev               # 从开发阶段重新开始
+  $0 REQ-123 --dry-run                # 预览恢复计划
+  $0 REQ-123 --from prd --force       # 强制从PRD阶段重新开始
+
+EOF
+    exit 0
+}
+
+# 解析命令行参数
+REQ_ID=""
+FROM_STAGE=""
+FORCE=false
+DRY_RUN=false
+VERBOSE=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            ;;
+        --from)
+            FROM_STAGE="$2"
+            shift 2
+            ;;
+        --force)
+            FORCE=true
+            shift
+            ;;
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --verbose)
+            VERBOSE=true
+            shift
+            ;;
+        -*)
+            echo "错误: 未知选项 $1" >&2
+            usage
+            ;;
+        *)
+            if [[ -z "$REQ_ID" ]]; then
+                REQ_ID="$1"
+            else
+                echo "错误: 多余的参数 $1" >&2
+                usage
+            fi
+            shift
+            ;;
+    esac
+done
+
+# 验证参数
+if [[ -z "$REQ_ID" ]]; then
+    # 尝试从当前分支获取
+    REQ_ID=$(get_current_req_id)
+    if [[ -z "$REQ_ID" ]]; then
+        echo "错误: 未提供 REQ_ID 且无法从当前分支检测" >&2
+        usage
+    fi
+fi
+
+# 验证 REQ_ID 格式
+if ! validate_req_id "$REQ_ID"; then
+    exit 1
+fi
+
+# 获取仓库根目录和需求目录
+REPO_ROOT=$(get_repo_root)
+REQ_DIR=$(get_req_dir "$REPO_ROOT" "$REQ_ID")
+STATUS_FILE="$REQ_DIR/orchestration_status.json"
+
+# ============================================================================
+# 工作流状态检测
+# ============================================================================
+
+# 检测当前工作流状态
+detect_workflow_status() {
+    echo -e "${BLUE}检测工作流状态...${NC}"
+    echo ""
+
+    # 检查需求目录是否存在
+    if [[ ! -d "$REQ_DIR" ]]; then
+        echo -e "${RED}错误: 需求目录不存在: $REQ_DIR${NC}"
+        echo -e "${YELLOW}建议: 使用 /flow-init 初始化需求${NC}"
+        exit 1
+    fi
+
+    # 检查状态文件
+    if [[ ! -f "$STATUS_FILE" ]]; then
+        echo -e "${YELLOW}警告: 状态文件不存在，需求可能未正确初始化${NC}"
+        echo -e "${YELLOW}建议: 使用 /flow-init --force 重新初始化${NC}"
+        exit 1
+    fi
+
+    # 读取状态文件
+    local status=$(jq -r '.status // "unknown"' "$STATUS_FILE" 2>/dev/null || echo "unknown")
+    local phase=$(jq -r '.phase // "unknown"' "$STATUS_FILE" 2>/dev/null || echo "unknown")
+    local title=$(jq -r '.title // ""' "$STATUS_FILE" 2>/dev/null || echo "")
+    local updated_at=$(jq -r '.updatedAt // ""' "$STATUS_FILE" 2>/dev/null || echo "")
+
+    echo -e "${BOLD}需求信息:${NC}"
+    echo -e "  ID:       $REQ_ID"
+    echo -e "  标题:     $title"
+    echo -e "  状态:     $status"
+    echo -e "  阶段:     $phase"
+    echo -e "  更新时间: $updated_at"
+    echo ""
+
+    # 检查文档完整性
+    echo -e "${BOLD}文档状态:${NC}"
+    check_document_status "PRD.md"
+    check_document_status "EPIC.md"
+    check_document_status "TASKS.md"
+    check_document_status "TEST_REPORT.md"
+    check_document_status "SECURITY_REPORT.md"
+    check_document_status "RELEASE_PLAN.md"
+    echo ""
+
+    # 检查任务进度
+    if [[ -f "$REQ_DIR/TASKS.md" ]]; then
+        local tasks_total=$(grep -c "^## TASK" "$REQ_DIR/TASKS.md" 2>/dev/null || echo "0")
+        local tasks_completed=0
+        if [[ -d "$REQ_DIR/tasks" ]]; then
+            tasks_completed=$(find "$REQ_DIR/tasks" -name "*.completed" -type f 2>/dev/null | wc -l | tr -d ' ')
+        fi
+
+        echo -e "${BOLD}任务进度:${NC}"
+        echo -e "  总任务数:     $tasks_total"
+        echo -e "  已完成:       $tasks_completed"
+        echo -e "  未完成:       $((tasks_total - tasks_completed))"
+        echo ""
+    fi
+
+    # 返回状态和阶段
+    echo "$status|$phase"
+}
+
+# 检查文档状态
+check_document_status() {
+    local doc_name="$1"
+    local doc_path="$REQ_DIR/$doc_name"
+
+    if [[ -f "$doc_path" ]]; then
+        local size=$(wc -l < "$doc_path" | tr -d ' ')
+        echo -e "  ✅ $doc_name ($size 行)"
+    else
+        echo -e "  ❌ $doc_name (不存在)"
+    fi
+}
+
+# ============================================================================
+# 恢复策略分析
+# ============================================================================
+
+# 分析并建议恢复策略
+analyze_recovery_strategy() {
+    local current_status="$1"
+    local current_phase="$2"
+
+    echo -e "${BLUE}分析恢复策略...${NC}"
+    echo ""
+
+    # 如果指定了 --from，使用指定的阶段
+    if [[ -n "$FROM_STAGE" ]]; then
+        echo -e "${YELLOW}用户指定从阶段恢复: $FROM_STAGE${NC}"
+        validate_stage "$FROM_STAGE"
+        echo "$FROM_STAGE"
+        return 0
+    fi
+
+    # 根据当前阶段智能判断恢复点
+    case "$current_phase" in
+        initialized|planning)
+            echo -e "${CYAN}建议: 从 PRD 阶段开始${NC}"
+            echo "prd"
+            ;;
+        prd_generation_in_progress)
+            echo -e "${CYAN}建议: 重新生成 PRD${NC}"
+            echo "prd"
+            ;;
+        prd_complete|epic_planning)
+            echo -e "${CYAN}建议: 从 Epic 阶段开始${NC}"
+            echo "epic"
+            ;;
+        epic_complete)
+            echo -e "${CYAN}建议: 从开发阶段开始${NC}"
+            echo "dev"
+            ;;
+        development|dev_complete)
+            # 检查是否有未完成的任务
+            if [[ -f "$REQ_DIR/TASKS.md" ]]; then
+                local tasks_total=$(grep -c "^## TASK" "$REQ_DIR/TASKS.md" 2>/dev/null || echo "0")
+                local tasks_completed=0
+                if [[ -d "$REQ_DIR/tasks" ]]; then
+                    tasks_completed=$(find "$REQ_DIR/tasks" -name "*.completed" -type f 2>/dev/null | wc -l | tr -d ' ')
+                fi
+
+                if [[ $tasks_completed -lt $tasks_total ]]; then
+                    echo -e "${CYAN}建议: 继续开发 (恢复未完成任务)${NC}"
+                    echo "dev"
+                else
+                    echo -e "${CYAN}建议: 进入 QA 阶段${NC}"
+                    echo "qa"
+                fi
+            else
+                echo -e "${CYAN}建议: 从开发阶段开始${NC}"
+                echo "dev"
+            fi
+            ;;
+        qa|qa_complete)
+            echo -e "${CYAN}建议: 从 QA 阶段开始${NC}"
+            echo "qa"
+            ;;
+        release|release_complete)
+            echo -e "${CYAN}建议: 从发布阶段开始${NC}"
+            echo "release"
+            ;;
+        completed)
+            echo -e "${GREEN}需求已完成，无需恢复${NC}"
+            echo ""
+            exit 0
+            ;;
+        *)
+            echo -e "${YELLOW}警告: 未知阶段 '$current_phase'，从 PRD 开始${NC}"
+            echo "prd"
+            ;;
+    esac
+}
+
+# 验证阶段名称
+validate_stage() {
+    local stage="$1"
+
+    case "$stage" in
+        init|prd|epic|dev|qa|release)
+            return 0
+            ;;
+        *)
+            echo -e "${RED}错误: 无效的阶段 '$stage'${NC}"
+            echo -e "${YELLOW}有效阶段: init, prd, epic, dev, qa, release${NC}"
+            exit 1
+            ;;
+    esac
+}
+
+# ============================================================================
+# 恢复执行
+# ============================================================================
+
+# 生成恢复计划
+generate_recovery_plan() {
+    local start_stage="$1"
+
+    echo -e "${BOLD}${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BOLD}${BLUE}  恢复计划${NC}"
+    echo -e "${BOLD}${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+
+    echo -e "${BOLD}起始阶段: $start_stage${NC}"
+    echo ""
+
+    # 根据起始阶段生成后续步骤
+    local stages=()
+    case "$start_stage" in
+        init)
+            stages=("init" "prd" "epic" "dev" "qa" "release")
+            ;;
+        prd)
+            stages=("prd" "epic" "dev" "qa" "release")
+            ;;
+        epic)
+            stages=("epic" "dev" "qa" "release")
+            ;;
+        dev)
+            stages=("dev" "qa" "release")
+            ;;
+        qa)
+            stages=("qa" "release")
+            ;;
+        release)
+            stages=("release")
+            ;;
+    esac
+
+    echo -e "${BOLD}执行步骤:${NC}"
+    local step_num=1
+    for stage in "${stages[@]}"; do
+        local command=""
+        case "$stage" in
+            init)
+                command="/flow-init \"$REQ_ID\""
+                ;;
+            prd)
+                command="/flow-prd \"$REQ_ID\""
+                ;;
+            epic)
+                command="/flow-epic \"$REQ_ID\""
+                ;;
+            dev)
+                command="/flow-dev \"$REQ_ID\" --resume"
+                ;;
+            qa)
+                command="/flow-qa \"$REQ_ID\" --full"
+                ;;
+            release)
+                command="/flow-release \"$REQ_ID\""
+                ;;
+        esac
+
+        echo -e "  ${step_num}. $command"
+        ((step_num++))
+    done
+
+    echo ""
+    echo -e "${BOLD}${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
+# 执行恢复
+execute_recovery() {
+    local start_stage="$1"
+
+    echo -e "${GREEN}开始执行恢复...${NC}"
+    echo ""
+
+    # 安全检查 (除非使用 --force)
+    if [[ "$FORCE" != "true" ]]; then
+        echo -e "${YELLOW}警告: 恢复操作可能覆盖现有文档${NC}"
+        read -p "确认继续? (y/N): " -n 1 -r
+        echo ""
+        if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+            echo -e "${YELLOW}已取消恢复${NC}"
+            exit 0
+        fi
+    fi
+
+    # 根据起始阶段执行命令
+    # 注意: 这里只是展示命令，实际执行由用户手动调用或使用 /flow-restart
+    echo -e "${CYAN}请手动执行以下命令以恢复工作流:${NC}"
+    echo ""
+
+    case "$start_stage" in
+        init)
+            echo "/flow-init \"$REQ_ID\""
+            echo "/flow-prd \"$REQ_ID\""
+            echo "/flow-epic \"$REQ_ID\""
+            echo "/flow-dev \"$REQ_ID\""
+            echo "/flow-qa \"$REQ_ID\" --full"
+            echo "/flow-release \"$REQ_ID\""
+            ;;
+        prd)
+            echo "/flow-prd \"$REQ_ID\""
+            echo "/flow-epic \"$REQ_ID\""
+            echo "/flow-dev \"$REQ_ID\""
+            echo "/flow-qa \"$REQ_ID\" --full"
+            echo "/flow-release \"$REQ_ID\""
+            ;;
+        epic)
+            echo "/flow-epic \"$REQ_ID\""
+            echo "/flow-dev \"$REQ_ID\""
+            echo "/flow-qa \"$REQ_ID\" --full"
+            echo "/flow-release \"$REQ_ID\""
+            ;;
+        dev)
+            echo "/flow-dev \"$REQ_ID\" --resume"
+            echo "/flow-qa \"$REQ_ID\" --full"
+            echo "/flow-release \"$REQ_ID\""
+            ;;
+        qa)
+            echo "/flow-qa \"$REQ_ID\" --full"
+            echo "/flow-release \"$REQ_ID\""
+            ;;
+        release)
+            echo "/flow-release \"$REQ_ID\""
+            ;;
+    esac
+
+    echo ""
+    echo -e "${GREEN}恢复计划已生成${NC}"
+}
+
+# ============================================================================
+# 主逻辑
+# ============================================================================
+
+main() {
+    echo -e "${BOLD}${CYAN}═══════════════════════════════════════════════${NC}"
+    echo -e "${BOLD}${CYAN}  CC-DevFlow 工作流恢复工具${NC}"
+    echo -e "${BOLD}${CYAN}═══════════════════════════════════════════════${NC}"
+    echo ""
+
+    # 检测工作流状态
+    local status_info=$(detect_workflow_status)
+    local current_status=$(echo "$status_info" | cut -d'|' -f1)
+    local current_phase=$(echo "$status_info" | cut -d'|' -f2)
+
+    # 分析恢复策略
+    local recovery_stage=$(analyze_recovery_strategy "$current_status" "$current_phase")
+
+    # 生成恢复计划
+    generate_recovery_plan "$recovery_stage"
+
+    # 如果是 dry-run，只显示计划不执行
+    if [[ "$DRY_RUN" == "true" ]]; then
+        echo -e "${YELLOW}Dry-run 模式: 仅显示计划，未执行任何操作${NC}"
+        exit 0
+    fi
+
+    # 执行恢复
+    execute_recovery "$recovery_stage"
+}
+
+# 运行主逻辑
+main