cc-devflow 1.0.1

package/.claude/tests/scripts/test_mark_task_complete.sh.backup

@@ -0,0 +1,410 @@
+#!/usr/bin/env bash
+# test_mark_task_complete.sh - 测试 mark-task-complete.sh
+
+# 加载测试框架
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../test-framework.sh"
+
+# 脚本路径
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+MARK_TASK_SCRIPT="$REPO_ROOT/scripts/mark-task-complete.sh"
+
+# ============================================================================
+# 辅助函数
+# ============================================================================
+
+# 创建测试专用的 common.sh
+create_test_common() {
+    local test_common="$TEST_TMP_DIR/scripts/common.sh"
+    mkdir -p "$(dirname "$test_common")"
+
+    # Use awk instead of sed for proper variable substitution
+    awk -v tmpdir="$TEST_TMP_DIR" '
+    /^get_repo_root\(\)/ {
+        print "get_repo_root() {"
+        print "    echo \"" tmpdir "\""
+        print "}"
+        in_function = 1
+        next
+    }
+    in_function && /^}/ {
+        in_function = 0
+        next
+    }
+    !in_function {
+        print
+    }
+    ' "$REPO_ROOT/scripts/common.sh" > "$test_common.tmp"
+
+    mv "$test_common.tmp" "$test_common"
+}
+
+# 创建带有任务的需求环境
+setup_requirement_with_tasks() {
+    local req_id="$1"
+    local req_dir="$TEST_TMP_DIR/.claude/docs/requirements/$req_id"
+
+    mkdir -p "$req_dir"
+
+    # 创建 TASKS.md
+    cat > "$req_dir/TASKS.md" << 'EOF'
+# Tasks for REQ-001
+
+## Task List
+
+- [ ] **T001**: Implement user authentication
+- [ ] **T002**: Add password validation
+- [x] **T003**: Setup database schema
+- [ ] **T004**: Create API endpoints
+EOF
+
+    # 创建 EXECUTION_LOG.md
+    echo "# Execution Log" > "$req_dir/EXECUTION_LOG.md"
+
+    echo "$req_dir"
+}
+
+# 运行 mark-task-complete.sh
+run_mark_task() {
+    local task_id="$1"
+    shift
+    local args=("$@")
+
+    # 设置环境
+    export DEVFLOW_REQ_ID="REQ-001"
+
+    # 创建测试专用的脚本副本
+    local test_scripts_dir="$TEST_TMP_DIR/scripts"
+    mkdir -p "$test_scripts_dir"
+
+    # 创建测试专用的 common.sh
+    create_test_common
+
+    # 复制 mark-task-complete.sh 到测试目录
+    cp "$MARK_TASK_SCRIPT" "$test_scripts_dir/"
+
+    # 在测试目录中运行脚本
+    (
+        cd "$TEST_TMP_DIR"
+        bash "$test_scripts_dir/mark-task-complete.sh" "$task_id" "${args[@]}" 2>&1
+    )
+}
+
+# ============================================================================
+# 测试帮助信息
+# ============================================================================
+
+test_help_flag() {
+    describe "Should show help with --help"
+
+    # Arrange
+    local test_scripts_dir="$TEST_TMP_DIR/scripts"
+    mkdir -p "$test_scripts_dir"
+    create_test_common
+    cp "$MARK_TASK_SCRIPT" "$test_scripts_dir/"
+
+    # Act
+    local output=$(
+        cd "$TEST_TMP_DIR"
+        bash "$test_scripts_dir/mark-task-complete.sh" --help 2>&1
+    )
+
+    # Assert
+    assert_contains "$output" "Usage:" "Should show usage"
+    assert_contains "$output" "mark-task-complete.sh" "Should mention script name"
+    assert_contains "$output" "TASK_ID" "Should document TASK_ID argument"
+}
+
+# ============================================================================
+# 测试参数验证
+# ============================================================================
+
+test_no_task_id() {
+    describe "Should fail when TASK_ID not provided"
+
+    # Arrange
+    local test_scripts_dir="$TEST_TMP_DIR/scripts"
+    mkdir -p "$test_scripts_dir"
+    create_test_common
+    cp "$MARK_TASK_SCRIPT" "$test_scripts_dir/"
+
+    # Act - Use temp file pattern to capture exit code
+    local output_file="$TEST_TMP_DIR/output.txt"
+    local exit_code_file="$TEST_TMP_DIR/exitcode.txt"
+
+    (
+        cd "$TEST_TMP_DIR"
+        export DEVFLOW_REQ_ID="REQ-001"
+        bash "$test_scripts_dir/mark-task-complete.sh" > "$output_file" 2>&1
+        echo $? > "$exit_code_file"
+    )
+
+    local output=$(cat "$output_file")
+    local exit_code=$(cat "$exit_code_file")
+
+    # Assert
+    assert_not_equals "$exit_code" "0" "Should fail without TASK_ID"
+    assert_contains "$output" "Task ID is required" "Should mention missing TASK_ID"
+}
+
+test_invalid_task_id_format() {
+    describe "Should fail on invalid TASK_ID format"
+
+    # Arrange
+    setup_requirement_with_tasks "REQ-001"
+
+    # Act
+    local exit_code=0
+    local output=$(run_mark_task "INVALID" 2>&1) || exit_code=$?
+
+    # Assert
+    assert_not_equals "$exit_code" "0" "Should fail on invalid format"
+    if [[ $exit_code -ne 0 ]]; then
+        assert_contains "$output" "Invalid task ID format" "Should mention format error"
+    fi
+}
+
+test_normalize_task_id_case() {
+    describe "Should normalize task ID to uppercase"
+
+    # Arrange
+    local req_dir=$(setup_requirement_with_tasks "REQ-001")
+
+    # Act - use lowercase task id
+    local output=$(run_mark_task "t001" --json 2>&1)
+    local exit_code=$?
+
+    # Assert
+    assert_equals "$exit_code" "0" "Should succeed with lowercase"
+    assert_contains "$output" "T001" "Should normalize to T001"
+
+    # Verify checkbox was marked
+    local tasks_content=$(cat "$req_dir/TASKS.md")
+    assert_contains "$tasks_content" "[x] **T001**" "Should mark T001 as complete"
+}
+
+# ============================================================================
+# 测试任务标记
+# ============================================================================
+
+test_mark_task_complete() {
+    describe "Should mark task as complete"
+
+    # Arrange
+    local req_dir=$(setup_requirement_with_tasks "REQ-001")
+
+    # Act
+    local output=$(run_mark_task "T001" 2>&1)
+    local exit_code=$?
+
+    # Assert
+    assert_equals "$exit_code" "0" "Should succeed"
+    assert_contains "$output" "✅" "Should show success message"
+
+    # Verify TASKS.md was updated
+    local tasks_content=$(cat "$req_dir/TASKS.md")
+    assert_contains "$tasks_content" "[x] **T001**" "Task should be marked complete"
+    assert_not_contains "$tasks_content" "[ ] **T001**" "Incomplete checkbox should be removed"
+}
+
+test_already_complete_task() {
+    describe "Should handle already complete task gracefully"
+
+    # Arrange
+    setup_requirement_with_tasks "REQ-001"
+
+    # Act - T003 is already marked as complete
+    local output=$(run_mark_task "T003" 2>&1)
+    local exit_code=$?
+
+    # Assert
+    assert_equals "$exit_code" "0" "Should succeed"
+    assert_contains "$output" "already" "Should mention already complete"
+}
+
+test_task_not_found() {
+    describe "Should fail when task doesn't exist"
+
+    # Arrange
+    setup_requirement_with_tasks "REQ-001"
+
+    # Act
+    local exit_code=0
+    local output=$(run_mark_task "T999" 2>&1) || exit_code=$?
+
+    # Assert
+    assert_not_equals "$exit_code" "0" "Should fail"
+    if [[ $exit_code -ne 0 ]]; then
+        assert_contains "$output" "not found" "Should mention task not found"
+    fi
+}
+
+# ============================================================================
+# 测试日志功能
+# ============================================================================
+
+test_log_to_execution_log() {
+    describe "Should log to EXECUTION_LOG.md by default"
+
+    # Arrange
+    local req_dir=$(setup_requirement_with_tasks "REQ-001")
+
+    # Act
+    run_mark_task "T002" 2>&1
+
+    # Assert
+    local log_content=$(cat "$req_dir/EXECUTION_LOG.md")
+    assert_contains "$log_content" "T002" "Should log task ID"
+    assert_contains "$log_content" "complete" "Should log completion"
+}
+
+test_no_log_option() {
+    describe "Should skip logging with --no-log"
+
+    # Arrange
+    local req_dir=$(setup_requirement_with_tasks "REQ-001")
+    local initial_log=$(cat "$req_dir/EXECUTION_LOG.md")
+
+    # Act
+    run_mark_task "T004" --no-log 2>&1
+
+    # Assert
+    local final_log=$(cat "$req_dir/EXECUTION_LOG.md")
+    assert_equals "$initial_log" "$final_log" "Log should not change"
+}
+
+# ============================================================================
+# 测试 JSON 输出
+# ============================================================================
+
+test_json_output() {
+    describe "Should output valid JSON with --json"
+
+    # Arrange
+    setup_requirement_with_tasks "REQ-001"
+
+    # Act
+    local output=$(run_mark_task "T001" --json 2>&1)
+
+    # Assert
+    assert_json_valid "$output" "Should be valid JSON"
+}
+
+test_json_output_fields() {
+    describe "JSON should include required fields"
+
+    # Arrange
+    setup_requirement_with_tasks "REQ-001"
+
+    # Act
+    local output=$(run_mark_task "T002" --json 2>&1)
+
+    # Assert
+    assert_contains "$output" "\"status\"" "Should have status field"
+    assert_contains "$output" "\"task_id\"" "Should have task_id field"
+    assert_contains "$output" "\"T002\"" "Should have correct task ID"
+}
+
+test_json_already_complete() {
+    describe "JSON should indicate already complete status"
+
+    # Arrange
+    setup_requirement_with_tasks "REQ-001"
+
+    # Act
+    local output=$(run_mark_task "T003" --json 2>&1)
+
+    # Assert
+    assert_json_valid "$output" "Should be valid JSON"
+    assert_contains "$output" "already_complete" "Should have already_complete status"
+}
+
+# ============================================================================
+# 测试进度统计
+# ============================================================================
+
+test_show_progress() {
+    describe "Should show task progress in text mode"
+
+    # Arrange
+    setup_requirement_with_tasks "REQ-001"
+
+    # Act
+    local output=$(run_mark_task "T001" 2>&1)
+
+    # Assert
+    assert_contains "$output" "Progress:" "Should show progress"
+    assert_contains "$output" "completed" "Should show completed count"
+    assert_contains "$output" "remaining" "Should show remaining count"
+}
+
+# ============================================================================
+# 测试缺失文件错误
+# ============================================================================
+
+test_missing_tasks_file() {
+    describe "Should fail when TASKS.md doesn't exist"
+
+    # Arrange - 创建需求目录但不创建 TASKS.md
+    local req_id="REQ-001"
+    local req_dir="$TEST_TMP_DIR/.claude/docs/requirements/$req_id"
+    mkdir -p "$req_dir"
+
+    # Act
+    local exit_code=0
+    local output=$(run_mark_task "T001" 2>&1) || exit_code=$?
+
+    # Assert
+    assert_not_equals "$exit_code" "0" "Should fail when TASKS.md missing"
+    if [[ $exit_code -ne 0 ]]; then
+        assert_contains "$output" "TASKS.md not found" "Should mention missing TASKS.md"
+    fi
+}
+
+# ============================================================================
+# 测试错误处理
+# ============================================================================
+
+test_invalid_option() {
+    describe "Should reject invalid options"
+
+    # Arrange
+    local test_scripts_dir="$TEST_TMP_DIR/scripts"
+    mkdir -p "$test_scripts_dir"
+    create_test_common
+    cp "$MARK_TASK_SCRIPT" "$test_scripts_dir/"
+
+    # Act
+    local exit_code=0
+    local output=$(
+        cd "$TEST_TMP_DIR"
+        bash "$test_scripts_dir/mark-task-complete.sh" T001 --invalid-option 2>&1
+    ) || exit_code=$?
+
+    # Assert
+    assert_not_equals "$exit_code" "0" "Should fail on invalid option"
+    if [[ $exit_code -ne 0 ]]; then
+        assert_contains "$output" "Unknown option" "Should mention unknown option"
+    fi
+}
+
+# ============================================================================
+# 运行所有测试
+# ============================================================================
+
+run_tests \
+    test_help_flag \
+    test_no_task_id \
+    test_invalid_task_id_format \
+    test_normalize_task_id_case \
+    test_mark_task_complete \
+    test_already_complete_task \
+    test_task_not_found \
+    test_log_to_execution_log \
+    test_no_log_option \
+    test_json_output \
+    test_json_output_fields \
+    test_json_already_complete \
+    test_show_progress \
+    test_missing_tasks_file \
+    test_invalid_option

package/.claude/tests/scripts/test_recover_workflow.sh

@@ -0,0 +1,304 @@
+#!/usr/bin/env bash
+# test_recover_workflow.sh - 测试 recover-workflow.sh (基础测试)
+
+# 加载测试框架
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../test-framework.sh"
+
+# 脚本路径
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+RECOVER_SCRIPT="$REPO_ROOT/scripts/recover-workflow.sh"
+
+# 注意: recover-workflow.sh 依赖真实的仓库环境
+# 这里只测试基本功能和帮助信息
+
+# ============================================================================
+# 辅助函数
+# ============================================================================
+
+# 创建测试专用的 common.sh
+create_test_common() {
+    local test_common="$TEST_TMP_DIR/scripts/common.sh"
+    mkdir -p "$(dirname "$test_common")"
+
+    sed '/^get_repo_root()/,/^}/c\
+get_repo_root() {\
+    echo "'"$TEST_TMP_DIR"'"\
+}' "$REPO_ROOT/scripts/common.sh" > "$test_common"
+}
+
+# 创建需求环境（带状态）
+setup_requirement_with_status() {
+    local req_id="$1"
+    local status="$2"
+    local phase="$3"
+
+    local req_dir="$TEST_TMP_DIR/devflow/requirements/$req_id"
+    mkdir -p "$req_dir"/{research,tasks}
+
+    # 创建状态文件
+    cat > "$req_dir/orchestration_status.json" << EOF
+{
+  "reqId": "$req_id",
+  "title": "Test Requirement",
+  "status": "$status",
+  "phase": "$phase",
+  "createdAt": "2025-10-01T00:00:00Z",
+  "updatedAt": "2025-10-01T00:00:00Z"
+}
+EOF
+
+    # 创建基础文档
+    echo "# PRD" > "$req_dir/PRD.md"
+    echo "# Execution Log" > "$req_dir/EXECUTION_LOG.md"
+
+    echo "$req_dir"
+}
+
+# 运行 recover-workflow.sh
+run_recover() {
+    local req_id="$1"
+    shift
+    local args=("$@")
+
+    export DEVFLOW_REQ_ID="$req_id"
+
+    local test_scripts_dir="$TEST_TMP_DIR/scripts"
+    mkdir -p "$test_scripts_dir"
+
+    create_test_common
+    cp "$RECOVER_SCRIPT" "$test_scripts_dir/"
+
+    (
+        cd "$TEST_TMP_DIR"
+        bash "$test_scripts_dir/recover-workflow.sh" "${args[@]}" 2>&1
+    )
+}
+
+# ============================================================================
+# 测试帮助信息
+# ============================================================================
+
+test_help_flag() {
+    describe "Should show help with --help"
+
+    # Act - 直接运行脚本
+    local output=$(bash "$RECOVER_SCRIPT" --help 2>&1)
+
+    # Assert
+    assert_contains "$output" "用法:" "Should show usage"
+    assert_contains "$output" "恢复" "Should mention recovery"
+}
+
+test_script_executes() {
+    describe "Should execute without critical errors"
+
+    # Act
+    local exit_code=0
+    bash "$RECOVER_SCRIPT" --help >/dev/null 2>&1 || exit_code=$?
+
+    # Assert
+    assert_equals "$exit_code" "0" "Script should be executable"
+}
+
+test_has_required_options() {
+    describe "Help should document required options"
+
+    # Act
+    local output=$(bash "$RECOVER_SCRIPT" --help 2>&1)
+
+    # Assert
+    assert_contains "$output" "--from" "Should have --from option"
+    assert_contains "$output" "--dry-run" "Should have --dry-run option"
+    assert_contains "$output" "--force" "Should have --force option"
+}
+
+# ============================================================================
+# 测试状态检测
+# ============================================================================
+
+test_detect_workflow_status() {
+    describe "Should detect workflow status correctly"
+
+    # Arrange
+    setup_requirement_with_status "REQ-001" "prd_complete" "epic_planning"
+
+    # Act
+    local output=$(run_recover "REQ-001" --dry-run 2>&1)
+
+    # Assert
+    assert_contains "$output" "REQ-001" "Should show requirement ID"
+    assert_contains "$output" "prd_complete\|epic" "Should show status or phase"
+}
+
+# ============================================================================
+# 测试恢复策略
+# ============================================================================
+
+test_recovery_from_prd_complete() {
+    describe "Should suggest Epic stage from prd_complete"
+
+    # Arrange
+    setup_requirement_with_status "REQ-002" "prd_complete" "epic_planning"
+
+    # Act
+    local output=$(run_recover "REQ-002" --dry-run 2>&1)
+
+    # Assert
+    assert_contains "$output" "epic\|Epic\|EPIC" "Should mention Epic stage"
+}
+
+test_recovery_from_initialized() {
+    describe "Should suggest PRD stage from initialized"
+
+    # Arrange
+    setup_requirement_with_status "REQ-003" "initialized" "planning"
+
+    # Act
+    local output=$(run_recover "REQ-003" --dry-run 2>&1)
+
+    # Assert
+    assert_contains "$output" "prd\|PRD" "Should mention PRD stage"
+}
+
+test_recovery_from_epic_complete() {
+    describe "Should suggest dev stage from epic_complete"
+
+    # Arrange
+    setup_requirement_with_status "REQ-004" "epic_complete" "epic_complete"
+
+    # Act
+    local output=$(run_recover "REQ-004" --dry-run 2>&1)
+
+    # Assert
+    assert_contains "$output" "dev\|开发" "Should mention dev stage"
+}
+
+# ============================================================================
+# 测试 --from 选项
+# ============================================================================
+
+test_from_option_override() {
+    describe "Should respect --from option to override detection"
+
+    # Arrange
+    setup_requirement_with_status "REQ-005" "prd_complete" "epic_planning"
+
+    # Act
+    local output=$(run_recover "REQ-005" --from dev --dry-run 2>&1)
+
+    # Assert
+    assert_contains "$output" "dev\|开发" "Should start from dev as specified"
+}
+
+# ============================================================================
+# 测试 dry-run 模式
+# ============================================================================
+
+test_dry_run_mode() {
+    describe "Should show recovery plan in dry-run mode"
+
+    # Arrange
+    setup_requirement_with_status "REQ-006" "prd_complete" "epic_planning"
+
+    # Act
+    local output=$(run_recover "REQ-006" --dry-run 2>&1)
+
+    # Assert
+    assert_contains "$output" "恢复计划\|Recovery Plan\|执行步骤" "Should show recovery plan"
+    assert_contains "$output" "flow-\|/flow" "Should show flow commands"
+}
+
+# ============================================================================
+# 测试文档完整性检查
+# ============================================================================
+
+test_check_prd_exists() {
+    describe "Should check for PRD.md existence"
+
+    # Arrange
+    local req_dir=$(setup_requirement_with_status "REQ-007" "prd_complete" "epic_planning")
+
+    # Act
+    local output=$(run_recover "REQ-007" --dry-run 2>&1)
+
+    # Assert
+    assert_contains "$output" "PRD\|文档" "Should mention PRD or documents"
+}
+
+test_check_epic_if_exists() {
+    describe "Should check for EPIC.md if it exists"
+
+    # Arrange
+    local req_dir=$(setup_requirement_with_status "REQ-008" "epic_complete" "epic_complete")
+    echo "# EPIC" > "$req_dir/EPIC.md"
+
+    # Act
+    local output=$(run_recover "REQ-008" --dry-run 2>&1)
+
+    # Assert
+    assert_contains "$output" "EPIC\|Epic\|文档" "Should detect EPIC presence"
+}
+
+# ============================================================================
+# 测试错误处理
+# ============================================================================
+
+test_missing_requirement_dir() {
+    describe "Should fail when requirement directory doesn't exist"
+
+    # Arrange - 不创建需求目录
+
+    # Act
+    local exit_code=0
+    local output=$(run_recover "REQ-NOTEXIST" --dry-run 2>&1) || exit_code=$?
+
+    # Assert
+    assert_not_equals "$exit_code" "0" "Should fail when dir missing"
+}
+
+test_missing_status_file() {
+    describe "Should handle missing status file gracefully"
+
+    # Arrange - 创建目录但不创建状态文件
+    local req_id="REQ-009"
+    local req_dir="$TEST_TMP_DIR/devflow/requirements/$req_id"
+    mkdir -p "$req_dir"
+    echo "# PRD" > "$req_dir/PRD.md"
+
+    # Act
+    local exit_code=0
+    local output=$(run_recover "REQ-009" --dry-run 2>&1) || exit_code=$?
+
+    # Assert
+    assert_not_equals "$exit_code" "0" "Should fail without status file"
+}
+
+# ============================================================================
+# 测试已完成需求
+# ============================================================================
+
+test_completed_requirement() {
+    describe "Should indicate no recovery needed for completed requirement"
+
+    # Arrange
+    setup_requirement_with_status "REQ-010" "completed" "completed"
+
+    # Act
+    local exit_code=0
+    local output=$(run_recover "REQ-010" --dry-run 2>&1) || exit_code=$?
+
+    # Assert - 已完成应该退出成功但提示无需恢复
+    if [[ $exit_code -eq 0 ]]; then
+        assert_contains "$output" "完成\|complete" "Should mention completion"
+    fi
+}
+
+# ============================================================================
+# 运行所有测试 (仅基础测试，完整测试需要真实Git环境)
+# ============================================================================
+
+run_tests \
+    test_help_flag \
+    test_script_executes \
+    test_has_required_options