cc-devflow 2.4.6 → 4.1.0

package/.claude/scripts/run-quality-gates.sh

@@ -0,0 +1,242 @@
+#!/bin/bash
+# [INPUT]: 依赖 .claude/config/quality-gates.yml
+# [OUTPUT]: 执行验证命令，返回结果
+# [POS]: scripts 的质量闸执行脚本，被 ralph-stop-hook.sh 调用
+# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+
+set -e
+
+# ============================================================================
+# Configuration
+# ============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CONFIG_FILE="$PROJECT_ROOT/.claude/config/quality-gates.yml"
+
+# ============================================================================
+# Usage
+# ============================================================================
+
+usage() {
+    cat << EOF
+Usage: run-quality-gates.sh <phase> [--json] [--verbose]
+
+Execute quality gate verification commands for a phase.
+
+Arguments:
+    phase       Phase name (flow-dev, flow-review, flow-quality, flow-qa, flow-release)
+
+Options:
+    --json      Output results as JSON
+    --verbose   Show command output
+    --quick     Use quick mode for flow-quality (default)
+    --full      Use full mode for flow-quality
+
+Examples:
+    run-quality-gates.sh flow-dev
+    run-quality-gates.sh flow-quality --full
+    run-quality-gates.sh flow-dev --json
+EOF
+    exit 1
+}
+
+# ============================================================================
+# Parse Arguments
+# ============================================================================
+
+PHASE=""
+JSON_OUTPUT=false
+VERBOSE=false
+MODE="quick"
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --json)
+            JSON_OUTPUT=true
+            shift
+            ;;
+        --verbose)
+            VERBOSE=true
+            shift
+            ;;
+        --quick)
+            MODE="quick"
+            shift
+            ;;
+        --full)
+            MODE="full"
+            shift
+            ;;
+        --help|-h)
+            usage
+            ;;
+        *)
+            if [[ -z "$PHASE" ]]; then
+                PHASE="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+if [[ -z "$PHASE" ]]; then
+    echo "Error: phase is required"
+    usage
+fi
+
+# ============================================================================
+# Check Config File
+# ============================================================================
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+    if $JSON_OUTPUT; then
+        echo '{"success": true, "message": "No quality-gates.yml found, skipping verification"}'
+    else
+        echo "ℹ️  No quality-gates.yml found, skipping verification"
+    fi
+    exit 0
+fi
+
+# ============================================================================
+# Parse YAML (Simple Parser)
+# ============================================================================
+
+# Extract verify commands for the phase
+# For flow-quality, use the mode (quick/full)
+if [[ "$PHASE" == "flow-quality" ]]; then
+    YAML_PATH="${PHASE}.${MODE}.verify"
+else
+    YAML_PATH="${PHASE}.verify"
+fi
+
+# Simple YAML extraction using grep and sed
+# This is a basic parser - for complex YAML, consider using yq
+extract_commands() {
+    local in_section=false
+    local in_verify=false
+    local indent_level=0
+
+    while IFS= read -r line; do
+        # Check for phase section
+        if [[ "$line" =~ ^${PHASE}: ]]; then
+            in_section=true
+            continue
+        fi
+
+        # Check for mode section (for flow-quality)
+        if $in_section && [[ "$PHASE" == "flow-quality" ]] && [[ "$line" =~ ^[[:space:]]+${MODE}: ]]; then
+            in_section=true
+            continue
+        fi
+
+        # Check for verify section
+        if $in_section && [[ "$line" =~ ^[[:space:]]+verify: ]]; then
+            in_verify=true
+            continue
+        fi
+
+        # Extract command entries
+        if $in_verify; then
+            # Check if we've left the verify section (less indentation)
+            if [[ "$line" =~ ^[[:space:]]*[a-z_]+: ]] && [[ ! "$line" =~ ^[[:space:]]{4,}- ]]; then
+                in_verify=false
+                in_section=false
+                continue
+            fi
+
+            # Extract command value
+            if [[ "$line" =~ command:[[:space:]]*\"(.+)\" ]]; then
+                echo "${BASH_REMATCH[1]}"
+            elif [[ "$line" =~ command:[[:space:]]*(.+) ]]; then
+                echo "${BASH_REMATCH[1]}"
+            fi
+        fi
+    done < "$CONFIG_FILE"
+}
+
+# ============================================================================
+# Execute Commands
+# ============================================================================
+
+COMMANDS=$(extract_commands)
+
+if [[ -z "$COMMANDS" ]]; then
+    if $JSON_OUTPUT; then
+        echo '{"success": true, "message": "No verify commands configured for phase", "phase": "'"$PHASE"'"}'
+    else
+        echo "ℹ️  No verify commands configured for $PHASE"
+    fi
+    exit 0
+fi
+
+TOTAL=0
+PASSED=0
+FAILED=0
+RESULTS=()
+
+while IFS= read -r cmd; do
+    [[ -z "$cmd" ]] && continue
+
+    ((TOTAL++))
+
+    if $VERBOSE; then
+        echo "Running: $cmd"
+    fi
+
+    # Execute command
+    if eval "$cmd" > /dev/null 2>&1; then
+        ((PASSED++))
+        RESULTS+=("{\"command\": \"$cmd\", \"status\": \"pass\"}")
+        if ! $JSON_OUTPUT; then
+            echo "  ✓ $cmd"
+        fi
+    else
+        ((FAILED++))
+        RESULTS+=("{\"command\": \"$cmd\", \"status\": \"fail\"}")
+        if ! $JSON_OUTPUT; then
+            echo "  ✗ $cmd"
+        fi
+    fi
+done <<< "$COMMANDS"
+
+# ============================================================================
+# Output Results
+# ============================================================================
+
+if $JSON_OUTPUT; then
+    # Build JSON array of results
+    RESULTS_JSON=$(printf '%s\n' "${RESULTS[@]}" | jq -s '.')
+
+    jq -n \
+        --arg phase "$PHASE" \
+        --arg mode "$MODE" \
+        --argjson total "$TOTAL" \
+        --argjson passed "$PASSED" \
+        --argjson failed "$FAILED" \
+        --argjson results "$RESULTS_JSON" \
+        '{
+            "phase": $phase,
+            "mode": $mode,
+            "total": $total,
+            "passed": $passed,
+            "failed": $failed,
+            "success": ($failed == 0),
+            "results": $results
+        }'
+else
+    echo ""
+    echo "Quality Gate Results for $PHASE:"
+    echo "  Total: $TOTAL"
+    echo "  Passed: $PASSED"
+    echo "  Failed: $FAILED"
+
+    if [[ $FAILED -gt 0 ]]; then
+        echo ""
+        echo "❌ Quality gate FAILED"
+        exit 1
+    else
+        echo ""
+        echo "✅ Quality gate PASSED"
+    fi
+fi

package/.claude/scripts/team-dev-init.sh

@@ -0,0 +1,319 @@
+#!/usr/bin/env bash
+# =============================================================================
+# Team Mode Initialization for flow-dev
+# =============================================================================
+# [INPUT]: 依赖 common.sh 的 Team 函数, parse-task-dependencies.js
+# [OUTPUT]: 初始化 dev-team 状态，分析任务并行性
+# [POS]: flow-dev 的 Team 初始化器，被 /flow:dev --team 调用
+# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+# =============================================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# =============================================================================
+# Constants
+# =============================================================================
+
+DEFAULT_AGENTS=3
+MAX_AGENTS=5
+MIN_AGENTS=2
+
+# =============================================================================
+# Team Initialization
+# =============================================================================
+
+# Initialize dev-team for parallel task execution
+# Args: $1 - repo root, $2 - requirement ID, $3 - number of agents
+init_dev_team() {
+    local repo_root="$1"
+    local req_id="$2"
+    local num_agents="${3:-$DEFAULT_AGENTS}"
+
+    # Validate agent count
+    if [[ "$num_agents" -lt "$MIN_AGENTS" ]]; then
+        num_agents=$MIN_AGENTS
+    elif [[ "$num_agents" -gt "$MAX_AGENTS" ]]; then
+        num_agents=$MAX_AGENTS
+    fi
+
+    echo "Initializing dev-team for $req_id with $num_agents agents..."
+
+    # Initialize Team state in orchestration_status.json
+    init_team_state "$repo_root" "$req_id" "parallel" "dev-lead"
+
+    # Add developer teammates
+    for i in $(seq 1 "$num_agents"); do
+        add_teammate "$repo_root" "$req_id" "dev-$i" "developer"
+    done
+
+    echo "Team initialized with $num_agents developer agents"
+}
+
+# =============================================================================
+# Task Analysis
+# =============================================================================
+
+# Analyze TASKS.md and return parallel execution plan
+# Args: $1 - repo root, $2 - requirement ID
+analyze_tasks() {
+    local repo_root="$1"
+    local req_id="$2"
+    local tasks_file="$repo_root/devflow/requirements/$req_id/TASKS.md"
+
+    if [[ ! -f "$tasks_file" ]]; then
+        echo '{"error": "TASKS.md not found", "tasks": [], "parallelGroups": []}' >&2
+        return 1
+    fi
+
+    # Use parse-task-dependencies.js to analyze tasks
+    node "$SCRIPT_DIR/parse-task-dependencies.js" parse "$tasks_file"
+}
+
+# Get next available tasks for parallel execution
+# Args: $1 - repo root, $2 - requirement ID
+get_next_tasks() {
+    local repo_root="$1"
+    local req_id="$2"
+    local tasks_file="$repo_root/devflow/requirements/$req_id/TASKS.md"
+
+    if [[ ! -f "$tasks_file" ]]; then
+        echo '[]'
+        return 0
+    fi
+
+    node "$SCRIPT_DIR/parse-task-dependencies.js" next "$tasks_file"
+}
+
+# Get parallel groups for current phase
+# Args: $1 - repo root, $2 - requirement ID
+get_parallel_groups() {
+    local repo_root="$1"
+    local req_id="$2"
+    local tasks_file="$repo_root/devflow/requirements/$req_id/TASKS.md"
+
+    if [[ ! -f "$tasks_file" ]]; then
+        echo '[]'
+        return 0
+    fi
+
+    node "$SCRIPT_DIR/parse-task-dependencies.js" groups "$tasks_file"
+}
+
+# =============================================================================
+# Conflict Detection
+# =============================================================================
+
+# Check for file conflicts in parallel tasks
+# Args: $1 - repo root, $2 - requirement ID
+check_conflicts() {
+    local repo_root="$1"
+    local req_id="$2"
+
+    local tasks
+    tasks=$(get_next_tasks "$repo_root" "$req_id")
+
+    # Format for conflict detection script
+    echo "{\"tasks\": $tasks}" | "$SCRIPT_DIR/detect-file-conflicts.sh"
+}
+
+# =============================================================================
+# Task Assignment
+# =============================================================================
+
+# Assign tasks to teammates based on parallel groups and conflicts
+# Args: $1 - repo root, $2 - requirement ID, $3 - number of agents
+assign_tasks() {
+    local repo_root="$1"
+    local req_id="$2"
+    local num_agents="${3:-$DEFAULT_AGENTS}"
+
+    local next_tasks
+    next_tasks=$(get_next_tasks "$repo_root" "$req_id")
+
+    local task_count
+    task_count=$(echo "$next_tasks" | jq 'length')
+
+    if [[ "$task_count" -eq 0 ]]; then
+        echo '{"assignments": [], "message": "No pending tasks"}'
+        return 0
+    fi
+
+    # Check for conflicts
+    local conflicts
+    conflicts=$(echo "{\"tasks\": $next_tasks}" | "$SCRIPT_DIR/detect-file-conflicts.sh")
+
+    local has_conflicts
+    has_conflicts=$(echo "$conflicts" | jq '.hasConflicts')
+
+    # Build assignment plan
+    local assignments='[]'
+
+    if [[ "$has_conflicts" == "true" ]]; then
+        # Handle conflicts: assign conflicting tasks to same agent
+        local conflict_groups
+        conflict_groups=$(echo "$conflicts" | jq '.conflicts')
+
+        # Assign conflict groups to agents
+        local agent_idx=1
+        assignments=$(echo "$conflict_groups" | jq --argjson numAgents "$num_agents" '
+            to_entries | map({
+                agent: "dev-\((.key % $numAgents) + 1)",
+                tasks: .value.tasks,
+                reason: "File conflict - must run sequentially"
+            })
+        ')
+
+        # Assign safe tasks to remaining agents
+        local safe_tasks
+        safe_tasks=$(echo "$conflicts" | jq '.safeGroups[0].tasks // []')
+
+        if [[ $(echo "$safe_tasks" | jq 'length') -gt 0 ]]; then
+            local safe_assignments
+            safe_assignments=$(echo "$safe_tasks" | jq --argjson numAgents "$num_agents" '
+                to_entries | map({
+                    agent: "dev-\((.key % $numAgents) + 1)",
+                    tasks: [.value],
+                    reason: "No conflicts"
+                })
+            ')
+            assignments=$(echo "$assignments $safe_assignments" | jq -s 'add')
+        fi
+    else
+        # No conflicts: distribute tasks evenly
+        assignments=$(echo "$next_tasks" | jq --argjson numAgents "$num_agents" '
+            to_entries | map({
+                agent: "dev-\((.key % $numAgents) + 1)",
+                tasks: [.value.id],
+                reason: "Round-robin assignment"
+            })
+        ')
+    fi
+
+    # Group by agent
+    local grouped
+    grouped=$(echo "$assignments" | jq '
+        group_by(.agent) | map({
+            agent: .[0].agent,
+            tasks: [.[].tasks[]] | unique,
+            reasons: [.[].reason] | unique
+        })
+    ')
+
+    echo "{\"assignments\": $grouped, \"hasConflicts\": $has_conflicts}"
+}
+
+# =============================================================================
+# Team Configuration
+# =============================================================================
+
+# Get dev-team configuration as JSON
+get_team_config() {
+    local num_agents="${1:-$DEFAULT_AGENTS}"
+
+    local members='[]'
+    for i in $(seq 1 "$num_agents"); do
+        members=$(echo "$members" | jq --arg id "dev-$i" --arg idx "$i" '
+            . + [{
+                id: $id,
+                role: "developer",
+                agent_type: "dev-implementer",
+                description: "Developer agent \($idx)"
+            }]
+        ')
+    done
+
+    jq -n --argjson members "$members" --argjson numAgents "$num_agents" '{
+        name: "dev-team",
+        version: "1.0.0",
+        description: "并行开发团队 - 多 Agent 并行执行任务",
+        mode: "parallel",
+        lead: "dev-lead",
+        members: $members,
+        workflow: {
+            strategy: "phase_based",
+            conflict_resolution: "same_agent",
+            max_parallel: $numAgents
+        },
+        quality_gates: {
+            entry: {
+                required_files: ["TASKS.md", "TECH_DESIGN.md", "quickstart.md"],
+                status_check: ["epic_complete", "development_in_progress"]
+            },
+            exit: {
+                all_tasks_complete: true,
+                tests_pass: true,
+                status_update: "development_complete"
+            }
+        }
+    }'
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+main() {
+    local action="${1:-help}"
+
+    case "$action" in
+        init)
+            local repo_root="${2:-$(get_repo_root)}"
+            local req_id="${3:-$(get_current_req_id)}"
+            local num_agents="${4:-$DEFAULT_AGENTS}"
+            init_dev_team "$repo_root" "$req_id" "$num_agents"
+            ;;
+        analyze)
+            local repo_root="${2:-$(get_repo_root)}"
+            local req_id="${3:-$(get_current_req_id)}"
+            analyze_tasks "$repo_root" "$req_id"
+            ;;
+        next)
+            local repo_root="${2:-$(get_repo_root)}"
+            local req_id="${3:-$(get_current_req_id)}"
+            get_next_tasks "$repo_root" "$req_id"
+            ;;
+        groups)
+            local repo_root="${2:-$(get_repo_root)}"
+            local req_id="${3:-$(get_current_req_id)}"
+            get_parallel_groups "$repo_root" "$req_id"
+            ;;
+        conflicts)
+            local repo_root="${2:-$(get_repo_root)}"
+            local req_id="${3:-$(get_current_req_id)}"
+            check_conflicts "$repo_root" "$req_id"
+            ;;
+        assign)
+            local repo_root="${2:-$(get_repo_root)}"
+            local req_id="${3:-$(get_current_req_id)}"
+            local num_agents="${4:-$DEFAULT_AGENTS}"
+            assign_tasks "$repo_root" "$req_id" "$num_agents"
+            ;;
+        config)
+            local num_agents="${2:-$DEFAULT_AGENTS}"
+            get_team_config "$num_agents"
+            ;;
+        help|*)
+            echo "Usage: $0 <action> [args...]"
+            echo ""
+            echo "Actions:"
+            echo "  init [repo_root] [req_id] [num_agents]  - Initialize dev-team"
+            echo "  analyze [repo_root] [req_id]            - Analyze TASKS.md"
+            echo "  next [repo_root] [req_id]               - Get next available tasks"
+            echo "  groups [repo_root] [req_id]             - Get parallel groups"
+            echo "  conflicts [repo_root] [req_id]          - Check file conflicts"
+            echo "  assign [repo_root] [req_id] [num_agents] - Assign tasks to agents"
+            echo "  config [num_agents]                      - Output team config JSON"
+            echo ""
+            echo "Defaults:"
+            echo "  num_agents: $DEFAULT_AGENTS (min: $MIN_AGENTS, max: $MAX_AGENTS)"
+            ;;
+    esac
+}
+
+# Run if executed directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi