cc-devflow 4.3.0 → 4.4.1

package/.claude/scripts/run-problem-analysis.sh

@@ -1,68 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-
-usage() {
-  cat <<'USAGE'
-Usage: scripts/bash/run-problem-analysis.sh --input "<symptom>"
-
-Generates a placeholder problem analysis report in analysis/problem-<timestamp>.md.
-USAGE
-}
-
-INPUT=""
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --input)
-      shift
-      INPUT="${1:-}"
-      ;;
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    *)
-      echo "Unknown argument: $1" >&2
-      usage
-      exit 1
-      ;;
-  esac
-  shift
-done
-
-if [[ -z "$INPUT" ]]; then
-  echo "Error: --input payload required." >&2
-  usage
-  exit 1
-fi
-
-ANALYSIS_DIR="analysis"
-mkdir -p "$ANALYSIS_DIR"
-timestamp="$(date -u +"%Y%m%d-%H%M%S")"
-report="$ANALYSIS_DIR/problem-${timestamp}.md"
-
-cat > "$report" <<EOF
-# Problem Analysis (Placeholder)
-
-Input:
-\`\`\`
-$INPUT
-\`\`\`
-
-- Affected files:
-  - TODO
-- Root cause:
-  - TBD
-- Proposed fix:
-  - Steps:
-  - Tests:
-- Documentation gaps:
-  - TODO
-- Open questions:
-  - TODO
-
-Please refine this template with the actual diagnostic results.
-EOF
-
-echo "Problem analysis report generated at $report"

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

@@ -1,242 +0,0 @@
-#!/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-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/setup-epic.sh

@@ -1,173 +0,0 @@
-#!/usr/bin/env bash
-
-# Setup EPIC and TASKS structure for cc-devflow
-#
-# This script prepares the requirement directory for Epic and Tasks generation.
-# Based on spec-kit's setup-plan.sh design.
-#
-# Usage: ./setup-epic.sh [OPTIONS]
-#
-# OPTIONS:
-#   --json              Output in JSON format
-#   --help, -h          Show help message
-#
-# OUTPUTS:
-#   JSON mode: {"REQ_ID":"...", "PRD_FILE":"...", "EPIC_FILE":"...", "TASKS_FILE":"..."}
-#   Text mode: REQ_ID: ... \n PRD_FILE: ... \n EPIC_FILE: ... \n TASKS_FILE: ...
-
-set -e
-
-# Parse command line arguments
-JSON_MODE=false
-
-for arg in "$@"; do
-    case "$arg" in
-        --json)
-            JSON_MODE=true
-            ;;
-        --help|-h)
-            cat << 'EOF'
-Usage: setup-epic.sh [OPTIONS]
-
-Setup EPIC and TASKS structure for cc-devflow requirement.
-
-OPTIONS:
-  --json              Output results in JSON format
-  --help, -h          Show this help message
-
-EXAMPLES:
-  # Setup Epic structure (text output)
-  ./setup-epic.sh
-
-  # Setup Epic structure (JSON output)
-  ./setup-epic.sh --json
-
-PREREQUISITES:
-  - Must be on a feature branch (feature/REQ-XXX-xxx) or
-  - Must have DEVFLOW_REQ_ID environment variable set
-  - PRD.md must already exist in requirement directory
-
-EOF
-            exit 0
-            ;;
-        *)
-            echo "ERROR: Unknown option '$arg'. Use --help for usage information." >&2
-            exit 1
-            ;;
-    esac
-done
-
-# Source common functions
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/common.sh"
-
-# Get all paths and variables from common functions
-eval $(get_requirement_paths)
-
-# Validate requirement ID exists
-if [[ -z "$REQ_ID" ]]; then
-    echo "ERROR: No requirement ID found" >&2
-    echo "Please ensure you are on a feature branch (feature/REQ-XXX-title)" >&2
-    echo "Or set DEVFLOW_REQ_ID environment variable" >&2
-    exit 1
-fi
-
-# Validate requirement ID format
-validate_req_id "$REQ_ID" || exit 1
-
-# Ensure the requirement directory exists
-if [[ ! -d "$REQ_DIR" ]]; then
-    echo "ERROR: Requirement directory not found: $REQ_DIR" >&2
-    echo "Run /flow:init first to create the requirement structure." >&2
-    exit 1
-fi
-
-# Check if PRD exists (prerequisite)
-if [[ ! -f "$PRD_FILE" ]]; then
-    echo "ERROR: PRD.md not found at $PRD_FILE" >&2
-    echo "Run prd-writer agent first to create the PRD." >&2
-    exit 1
-fi
-
-# Copy EPIC template if it doesn't exist
-EPIC_TEMPLATE="$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
-if [[ ! -f "$EPIC_FILE" ]]; then
-    if [[ -f "$EPIC_TEMPLATE" ]]; then
-        cp "$EPIC_TEMPLATE" "$EPIC_FILE"
-        if ! $JSON_MODE; then
-            echo "Copied EPIC template to $EPIC_FILE" >&2
-        fi
-    else
-        # Create basic EPIC file if template doesn't exist
-        cat > "$EPIC_FILE" <<EOF
-# Epic: $REQ_ID
-
-**Status**: Draft
-**Created**: $(get_beijing_time_full)
-
-## Overview
-
-[Epic overview to be filled by planner]
-
-## Success Criteria
-
-[Success criteria to be filled by planner]
-
-## Technical Approach
-
-[Technical approach to be filled by planner]
-EOF
-        if ! $JSON_MODE; then
-            echo "Created basic EPIC file at $EPIC_FILE" >&2
-        fi
-    fi
-fi
-
-# Copy TASKS template if it doesn't exist
-TASKS_TEMPLATE="$REPO_ROOT/.claude/docs/templates/TASKS_TEMPLATE.md"
-TASKS_FILE="$REQ_DIR/TASKS.md"
-
-if [[ ! -f "$TASKS_FILE" ]]; then
-    if [[ -f "$TASKS_TEMPLATE" ]]; then
-        cp "$TASKS_TEMPLATE" "$TASKS_FILE"
-        if ! $JSON_MODE; then
-            echo "Copied TASKS template to $TASKS_FILE" >&2
-        fi
-    else
-        # Create basic TASKS file if template doesn't exist
-        cat > "$TASKS_FILE" <<EOF
-# Tasks: $REQ_ID
-
-**Status**: Draft
-**Created**: $(get_beijing_time_full)
-
-## Tasks
-
-[Tasks to be generated by planner]
-EOF
-        if ! $JSON_MODE; then
-            echo "Created basic TASKS file at $TASKS_FILE" >&2
-        fi
-    fi
-fi
-
-# Log the setup event
-log_event "$REQ_ID" "Epic and Tasks structure initialized"
-
-# Output results
-if $JSON_MODE; then
-    printf '{"%s":"%s","%s":"%s","%s":"%s","%s":"%s","%s":"%s","%s":"%s"}\n' \
-        "REQ_ID" "$REQ_ID" \
-        "REQ_TYPE" "$REQ_TYPE" \
-        "REQ_DIR" "$REQ_DIR" \
-        "PRD_FILE" "$PRD_FILE" \
-        "EPIC_FILE" "$EPIC_FILE" \
-        "TASKS_FILE" "$TASKS_FILE"
-else
-    echo "REQ_ID: $REQ_ID"
-    echo "REQ_TYPE: $REQ_TYPE"
-    echo "REQ_DIR: $REQ_DIR"
-    echo "PRD_FILE: $PRD_FILE"
-    echo "EPIC_FILE: $EPIC_FILE"
-    echo "TASKS_FILE: $TASKS_FILE"
-fi

package/.claude/scripts/setup-ralph-loop.sh

@@ -1,155 +0,0 @@
-#!/bin/bash
-
-# CC-DevFlow Ralph Loop Setup Script
-# Adapted from ralph-wiggum for cc-devflow integration
-# Creates state file for Ralph autonomous loop
-
-set -euo pipefail
-
-# ========== Arguments ==========
-
-REQ_ID=""
-MAX_ITERATIONS=10
-COMPLETION_PROMISE="RALPH_COMPLETE"
-
-# Parse options
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    -h|--help)
-      cat << 'HELP_EOF'
-CC-DevFlow Ralph Loop Setup
-
-USAGE:
-  setup-ralph-loop.sh REQ_ID [OPTIONS]
-
-ARGUMENTS:
-  REQ_ID       Requirement ID (e.g., REQ-123)
-
-OPTIONS:
-  --max-iterations <n>           Maximum iterations (default: 10)
-  --completion-promise '<text>'  Promise phrase (default: "RALPH_COMPLETE")
-  -h, --help                     Show this help
-
-DESCRIPTION:
-  Sets up Ralph loop state for CC-DevFlow autonomous development.
-  Used by /flow-ralph command.
-
-EXAMPLES:
-  setup-ralph-loop.sh REQ-123
-  setup-ralph-loop.sh REQ-123 --max-iterations 20
-  setup-ralph-loop.sh REQ-123 --completion-promise "ALL_TASKS_DONE"
-
-OUTPUT:
-  Creates .claude/ralph-loop.local.md with loop state
-HELP_EOF
-      exit 0
-      ;;
-    --max-iterations)
-      if [[ -z "${2:-}" ]] || ! [[ "$2" =~ ^[0-9]+$ ]]; then
-        echo "❌ Error: --max-iterations requires a positive integer" >&2
-        exit 1
-      fi
-      MAX_ITERATIONS="$2"
-      shift 2
-      ;;
-    --completion-promise)
-      if [[ -z "${2:-}" ]]; then
-        echo "❌ Error: --completion-promise requires a text argument" >&2
-        exit 1
-      fi
-      COMPLETION_PROMISE="$2"
-      shift 2
-      ;;
-    *)
-      if [[ -z "$REQ_ID" ]]; then
-        REQ_ID="$1"
-        shift
-      else
-        echo "❌ Error: Unknown argument: $1" >&2
-        exit 1
-      fi
-      ;;
-  esac
-done
-
-# Validate REQ_ID
-if [[ -z "$REQ_ID" ]]; then
-  echo "❌ Error: REQ_ID is required" >&2
-  echo "" >&2
-  echo "   Usage: setup-ralph-loop.sh REQ-123 [OPTIONS]" >&2
-  echo "   For help: setup-ralph-loop.sh --help" >&2
-  exit 1
-fi
-
-if ! [[ "$REQ_ID" =~ ^(REQ|BUG)-[0-9]+$ ]]; then
-  echo "❌ Error: Invalid REQ_ID format: $REQ_ID" >&2
-  echo "   Expected format: REQ-123 or BUG-456" >&2
-  exit 1
-fi
-
-# Check if requirement directory exists
-REQ_DIR="devflow/requirements/${REQ_ID}"
-if [[ ! -d "$REQ_DIR" ]]; then
-  echo "❌ Error: Requirement directory not found: $REQ_DIR" >&2
-  echo "   Run /flow:init first to create the requirement structure" >&2
-  exit 1
-fi
-
-# Check if TASKS.md exists
-if [[ ! -f "${REQ_DIR}/TASKS.md" ]]; then
-  echo "❌ Error: TASKS.md not found in $REQ_DIR" >&2
-  echo "   Run /flow:spec first to generate tasks" >&2
-  exit 1
-fi
-
-# Create state file for stop hook
-mkdir -p .claude
-
-# Quote completion promise for YAML if needed
-if [[ -n "$COMPLETION_PROMISE" ]] && [[ "$COMPLETION_PROMISE" != "null" ]]; then
-  COMPLETION_PROMISE_YAML="\"$COMPLETION_PROMISE\""
-else
-  COMPLETION_PROMISE_YAML="null"
-fi
-
-# Initial prompt for Ralph loop
-INITIAL_PROMPT="Continue working on ${REQ_ID}. Use {SKILL:attention} Protocol 3 to refresh attention, then execute the next task in TASKS.md using TDD approach ({SKILL:tdd}). Record errors in ERROR_LOG.md. Output <promise>$COMPLETION_PROMISE</promise> when all tasks are complete."
-
-cat > .claude/ralph-loop.local.md <<EOF
----
-active: true
-iteration: 1
-max_iterations: $MAX_ITERATIONS
-completion_promise: $COMPLETION_PROMISE_YAML
-req_id: "$REQ_ID"
-started_at: "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
----
-
-$INITIAL_PROMPT
-EOF
-
-# Output setup message
-cat <<EOF
-🔄 Ralph loop activated for $REQ_ID!
-
-Iteration: 1
-Max iterations: $(if [[ $MAX_ITERATIONS -gt 0 ]]; then echo $MAX_ITERATIONS; else echo "unlimited"; fi)
-Completion promise: $COMPLETION_PROMISE
-
-The stop hook is now active. When you try to exit, the loop will:
-1. Check if all tasks in TASKS.md are complete
-2. Check if completion promise is detected
-3. If not complete, continue to next iteration
-
-To monitor: head -10 .claude/ralph-loop.local.md
-To cancel: /cancel-ralph
-
-⚠️  WARNING: Loop runs until max iterations or all tasks complete.
-
-🔄 Starting autonomous development...
-EOF
-
-# Set environment variable for scripts
-export RALPH_REQ_ID="$REQ_ID"
-
-exit 0