cc-devflow 1.0.1

package/.claude/tests/constitution/test_version_consistency.sh

@@ -0,0 +1,120 @@
+#!/usr/bin/env bash
+
+# test_version_consistency.sh - 测试 Constitution 版本一致性
+#
+# 验证所有文件引用的 Constitution 版本是否一致
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# 加载测试框架
+if [[ -f "$REPO_ROOT/.claude/tests/test-framework.sh" ]]; then
+    source "$REPO_ROOT/.claude/tests/test-framework.sh"
+else
+    echo "❌ Test framework not found"
+    exit 1
+fi
+
+# ============================================================================
+# 测试用例
+# ============================================================================
+
+test_constitution_version_readable() {
+    local constitution_file="$REPO_ROOT/.claude/constitution/project-constitution.md"
+
+    assert_file_exists "$constitution_file" "Constitution file should exist"
+
+    # 提取版本号
+    local version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$constitution_file" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
+
+    assert_not_empty "$version" "Constitution should have a version number"
+    assert_matches "$version" '^[0-9]+\.[0-9]+\.[0-9]+$' "Version should be in format X.Y.Z"
+
+    log_success "Constitution version: v$version"
+}
+
+test_all_templates_reference_same_version() {
+    local constitution_version=$(bash "$REPO_ROOT/.claude/scripts/manage-constitution.sh" verify 2>&1 | grep "Constitution Version:" | sed 's/.*v\([0-9.]*\).*/\1/' || echo "")
+
+    if [[ -z "$constitution_version" ]]; then
+        log_error "Could not extract Constitution version"
+        return 1
+    fi
+
+    local templates_dir="$REPO_ROOT/.claude/docs/templates"
+    local inconsistent_count=0
+
+    for template in "$templates_dir"/*.md; do
+        if [[ -f "$template" ]] && grep -q "Constitution" "$template"; then
+            local template_version=$(grep -o "Constitution.*v[0-9.]*" "$template" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/' || echo "")
+
+            if [[ -n "$template_version" ]] && [[ "$template_version" != "$constitution_version" ]]; then
+                log_error "Template $(basename "$template") has version v$template_version, expected v$constitution_version"
+                ((inconsistent_count++))
+            fi
+        fi
+    done
+
+    assert_equals "$inconsistent_count" "0" "All templates should reference Constitution v$constitution_version"
+}
+
+test_all_agents_reference_same_version() {
+    local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/constitution/project-constitution.md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
+
+    local agents_dir="$REPO_ROOT/.claude/agents"
+    local inconsistent_count=0
+
+    for agent in "$agents_dir"/*.md; do
+        if [[ -f "$agent" ]] && grep -q "Constitution" "$agent"; then
+            local agent_version=$(grep -o "Constitution.*v[0-9.]*" "$agent" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/' || echo "")
+
+            if [[ -n "$agent_version" ]] && [[ "$agent_version" != "$constitution_version" ]]; then
+                log_error "Agent $(basename "$agent") has version v$agent_version, expected v$constitution_version"
+                ((inconsistent_count++))
+            fi
+        fi
+    done
+
+    assert_equals "$inconsistent_count" "0" "All agents should reference Constitution v$constitution_version"
+}
+
+test_claude_md_references_current_version() {
+    local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/constitution/project-constitution.md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
+
+    local claude_md="$REPO_ROOT/CLAUDE.md"
+
+    assert_file_exists "$claude_md" "CLAUDE.md should exist"
+
+    if grep -q "Constitution.*v" "$claude_md"; then
+        local claude_version=$(grep -o "Constitution.*v[0-9.]*" "$claude_md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
+
+        assert_equals "$claude_version" "$constitution_version" "CLAUDE.md should reference Constitution v$constitution_version"
+    else
+        log_warning "CLAUDE.md does not reference Constitution version"
+    fi
+}
+
+test_manage_constitution_script_consistency() {
+    local script="$REPO_ROOT/.claude/scripts/manage-constitution.sh"
+
+    assert_file_exists "$script" "manage-constitution.sh should exist"
+    assert_file_executable "$script" "manage-constitution.sh should be executable"
+
+    # 运行脚本的 verify 命令（可能会失败，但应该返回有意义的输出）
+    local output=$(bash "$script" verify 2>&1 || true)
+
+    assert_contains "$output" "Constitution Version:" "verify command should output Constitution version"
+}
+
+# ============================================================================
+# 运行测试
+# ============================================================================
+
+run_tests \
+    test_constitution_version_readable \
+    test_all_templates_reference_same_version \
+    test_all_agents_reference_same_version \
+    test_claude_md_references_current_version \
+    test_manage_constitution_script_consistency

package/.claude/tests/fixtures/spec_delta_full.md

@@ -0,0 +1,16 @@
+## ADDED Requirements
+
+### Requirement: Login Flow
+- handle new login
+
+## MODIFIED Requirements
+
+### Requirement: Session Guard
+- tighten validation
+
+## REMOVED Requirements
+- Legacy Password Flow
+
+## RENAMED Requirements
+- FROM: Beta Feature
+  TO: Stable Feature

package/.claude/tests/fixtures/tasks_progress_sample.md

@@ -0,0 +1,5 @@
+# Tasks
+
+- [ ] Draft proposal
+- [x] Review delta
+- [X] Update constitution

package/.claude/tests/run-all-tests.sh

@@ -0,0 +1,229 @@
+#!/usr/bin/env bash
+# run-all-tests.sh - 运行所有测试套件
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+NC='\033[0m' # No Color
+
+# 使用说明
+usage() {
+    cat << EOF
+用法: $0 [选项]
+
+运行 CC-DevFlow 测试套件
+
+选项:
+  -h, --help              显示此帮助信息
+  --scripts               只运行脚本测试
+  --commands              只运行命令测试
+  --e2e                   只运行端到端测试
+  --verbose               详细输出
+  --quiet                 安静模式，只显示摘要
+  --coverage              生成覆盖率报告
+  --fail-fast             第一个失败测试后停止
+
+示例:
+  $0                      # 运行所有测试
+  $0 --scripts            # 只运行脚本测试
+  $0 --verbose            # 详细模式
+  $0 --fail-fast          # 快速失败模式
+
+EOF
+    exit 0
+}
+
+# 解析参数
+RUN_SCRIPTS=false
+RUN_COMMANDS=false
+RUN_E2E=false
+VERBOSE=false
+QUIET=false
+COVERAGE=false
+FAIL_FAST=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            ;;
+        --scripts)
+            RUN_SCRIPTS=true
+            shift
+            ;;
+        --commands)
+            RUN_COMMANDS=true
+            shift
+            ;;
+        --e2e)
+            RUN_E2E=true
+            shift
+            ;;
+        --verbose)
+            VERBOSE=true
+            export VERBOSE=true
+            shift
+            ;;
+        --quiet)
+            QUIET=true
+            export QUIET=true
+            shift
+            ;;
+        --coverage)
+            COVERAGE=true
+            shift
+            ;;
+        --fail-fast)
+            FAIL_FAST=true
+            shift
+            ;;
+        *)
+            echo "错误: 未知参数 $1" >&2
+            usage
+            ;;
+    esac
+done
+
+# 如果没有指定类别，运行所有测试
+if [[ "$RUN_SCRIPTS" == "false" && "$RUN_COMMANDS" == "false" && "$RUN_E2E" == "false" ]]; then
+    RUN_SCRIPTS=true
+    RUN_COMMANDS=true
+    RUN_E2E=true
+fi
+
+# 统计
+TOTAL_SUITES=0
+PASSED_SUITES=0
+FAILED_SUITES=0
+
+# 运行测试套件
+run_test_suite() {
+    local test_file="$1"
+    local suite_name=$(basename "$test_file" .sh)
+
+    ((TOTAL_SUITES++))
+
+    if [[ "$QUIET" != "true" ]]; then
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo -e "${BOLD}Running: $suite_name${NC}"
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    fi
+
+    if bash "$test_file"; then
+        ((PASSED_SUITES++))
+        if [[ "$QUIET" != "true" ]]; then
+            echo -e "${GREEN}✓ Suite passed: $suite_name${NC}"
+        fi
+        return 0
+    else
+        ((FAILED_SUITES++))
+        echo -e "${RED}✗ Suite failed: $suite_name${NC}"
+
+        if [[ "$FAIL_FAST" == "true" ]]; then
+            echo -e "${YELLOW}Fail-fast mode enabled, stopping...${NC}"
+            print_final_summary
+            exit 1
+        fi
+        return 1
+    fi
+}
+
+# 打印最终摘要
+print_final_summary() {
+    echo ""
+    echo -e "${BOLD}${BLUE}═══════════════════════════════════════════════${NC}"
+    echo -e "${BOLD}${BLUE}  Final Test Summary${NC}"
+    echo -e "${BOLD}${BLUE}═══════════════════════════════════════════════${NC}"
+    echo ""
+    echo -e "Total Suites:  ${BOLD}$TOTAL_SUITES${NC}"
+    echo -e "Passed Suites: ${GREEN}${BOLD}$PASSED_SUITES${NC}"
+    echo -e "Failed Suites: ${RED}${BOLD}$FAILED_SUITES${NC}"
+    echo ""
+
+    if [[ $FAILED_SUITES -eq 0 ]]; then
+        echo -e "${GREEN}${BOLD}✓ ALL TEST SUITES PASSED${NC}"
+        echo ""
+        return 0
+    else
+        echo -e "${RED}${BOLD}✗ SOME TEST SUITES FAILED${NC}"
+        echo ""
+        return 1
+    fi
+}
+
+# 主逻辑
+main() {
+    echo -e "${BOLD}${BLUE}═══════════════════════════════════════════════${NC}"
+    echo -e "${BOLD}${BLUE}  CC-DevFlow Test Runner${NC}"
+    echo -e "${BOLD}${BLUE}═══════════════════════════════════════════════${NC}"
+    echo ""
+
+    # 运行脚本测试
+    if [[ "$RUN_SCRIPTS" == "true" ]]; then
+        echo -e "${YELLOW}Running Script Tests...${NC}"
+        echo ""
+
+        for test_file in "$SCRIPT_DIR"/scripts/test_*.sh; do
+            if [[ -f "$test_file" ]]; then
+                run_test_suite "$test_file"
+            fi
+        done
+    fi
+
+    # 运行命令测试
+    if [[ "$RUN_COMMANDS" == "true" ]]; then
+        echo -e "${YELLOW}Running Command Tests...${NC}"
+        echo ""
+
+        for test_file in "$SCRIPT_DIR"/commands/test_*.sh; do
+            if [[ -f "$test_file" ]]; then
+                run_test_suite "$test_file"
+            else
+                if [[ "$QUIET" != "true" ]]; then
+                    echo -e "${YELLOW}No command tests found yet${NC}"
+                fi
+                break
+            fi
+        done
+    fi
+
+    # 运行端到端测试
+    if [[ "$RUN_E2E" == "true" ]]; then
+        echo -e "${YELLOW}Running End-to-End Tests...${NC}"
+        echo ""
+
+        for test_file in "$SCRIPT_DIR"/e2e/test_*.sh; do
+            if [[ -f "$test_file" ]]; then
+                run_test_suite "$test_file"
+            else
+                if [[ "$QUIET" != "true" ]]; then
+                    echo -e "${YELLOW}No e2e tests found yet${NC}"
+                fi
+                break
+            fi
+        done
+    fi
+
+    # 生成覆盖率报告
+    if [[ "$COVERAGE" == "true" ]]; then
+        echo ""
+        echo -e "${YELLOW}Generating coverage report...${NC}"
+        echo -e "${YELLOW}(Coverage reporting not yet implemented)${NC}"
+    fi
+
+    # 打印最终摘要
+    print_final_summary
+}
+
+# 运行主逻辑并捕获退出码
+main
+exit_code=$?
+
+exit $exit_code

package/.claude/tests/scripts/run.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+exit_code=0
+
+tests=(
+    test_common.sh
+    test_check_prerequisites.sh
+    test_check_task_status.sh
+    test_mark_task_complete.sh
+    test_generate_status_report.sh
+    test_recover_workflow.sh
+    test_setup_epic.sh
+    test_validate_constitution.sh
+)
+
+for test_name in "${tests[@]}"; do
+    test_file="$SCRIPT_DIR/$test_name"
+    if [[ -f "$test_file" ]]; then
+        if ! bash "$test_file"; then
+            exit_code=1
+        fi
+        echo ""
+    fi
+done
+
+exit "$exit_code"

package/.claude/tests/scripts/test-framework.sh

@@ -0,0 +1,128 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+TEST_ARTIFACT_ROOT="$REPO_ROOT/.tmp/script-tests"
+
+mkdir -p "$TEST_ARTIFACT_ROOT"
+
+TEST_TOTAL=0
+TEST_FAILED=0
+declare -a TEST_CLEANUP_PATHS=()
+
+register_cleanup() {
+    local path="$1"
+    TEST_CLEANUP_PATHS+=("$path")
+}
+
+cleanup_all() {
+    local path
+    for path in "${TEST_CLEANUP_PATHS[@]}"; do
+        if [[ -e "$path" || -L "$path" ]]; then
+            rm -rf "$path"
+        fi
+    done
+}
+
+trap cleanup_all EXIT
+
+# ===== 终端色彩工具 =====
+_color_green() { printf "\033[32m%s\033[0m" "$1"; }
+_color_red() { printf "\033[31m%s\033[0m" "$1"; }
+
+# ===== 断言工具族 =====
+assert_equals() {
+    local expected="$1"
+    local actual="$2"
+    local message="${3:-Values differ}"
+    if [[ "$expected" != "$actual" ]]; then
+        echo "  $( _color_red "ASSERT FAIL" ): $message"
+        echo "    expected: $expected"
+        echo "    actual:   $actual"
+        return 1
+    fi
+    return 0
+}
+
+assert_contains() {
+    local needle="$1"
+    local haystack="$2"
+    local message="${3:-Substring not found}"
+    if [[ "$haystack" != *"$needle"* ]]; then
+        echo "  $( _color_red "ASSERT FAIL" ): $message"
+        echo "    missing substring: $needle"
+        return 1
+    fi
+    return 0
+}
+
+assert_file_exists() {
+    local path="$1"
+    local message="${2:-File not found}"
+    if [[ ! -e "$path" ]]; then
+        echo "  $( _color_red "ASSERT FAIL" ): $message"
+        echo "    missing path: $path"
+        return 1
+    fi
+    return 0
+}
+
+assert_json_valid() {
+    local path="$1"
+    local message="${2:-Invalid JSON}"
+    if ! python3 - "$path" <<'PY' >/dev/null 2>&1
+import json
+import pathlib
+import sys
+text = pathlib.Path(sys.argv[1]).read_text(encoding="utf-8")
+json.loads(text)
+PY
+    then
+        echo "  $( _color_red "ASSERT FAIL" ): $message"
+        echo "    file: $path"
+        return 1
+    fi
+    return 0
+}
+
+assert_grep_match() {
+    local pattern="$1"
+    local file="$2"
+    local message="${3:-Pattern not found}"
+    if ! LC_ALL=C grep -Eq "$pattern" "$file"; then
+        echo "  $( _color_red "ASSERT FAIL" ): $message"
+        echo "    pattern: $pattern"
+        echo "    file: $file"
+        return 1
+    fi
+    return 0
+}
+
+# ===== 核心运行流程 =====
+run_test() {
+    local name="$1"
+    shift
+    local fn="$1"
+    shift || true
+
+    TEST_TOTAL=$((TEST_TOTAL + 1))
+    printf "→ %s ... " "$name"
+    if "$fn" "$@"; then
+        printf "%s\n" "$(_color_green OK)"
+    else
+        printf "%s\n" "$(_color_red FAIL)"
+        TEST_FAILED=$((TEST_FAILED + 1))
+    fi
+}
+
+finish_tests() {
+    if [[ "$TEST_FAILED" -eq 0 ]]; then
+        printf "\n%s (%d tests)\n" "$(_color_green "All tests passed")" "$TEST_TOTAL"
+        exit 0
+    else
+        printf "\n%s (%d/%d failed)\n" "$(_color_red "Tests failed")" "$TEST_FAILED" "$TEST_TOTAL"
+        exit 1
+    fi
+}