cc-devflow 4.2.0 → 4.4.1

package/.claude/scripts/flow-delta-status.sh

@@ -1,235 +0,0 @@
-#!/bin/bash
-# [INPUT]: 依赖 deltas/{delta-id}/delta.md, delta-parser.ts
-# [OUTPUT]: 显示 delta 状态和验证结果
-# [POS]: scripts 的 delta spec 状态脚本，被 /flow:delta status 调用
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-# ============================================================================
-# Configuration
-# ============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-PARSER_SCRIPT="$SCRIPT_DIR/delta-parser.ts"
-
-# ============================================================================
-# Usage
-# ============================================================================
-
-usage() {
-    cat << EOF
-Usage: flow-delta-status.sh <REQ-ID> <delta-slug>
-
-Check the status of a specific delta spec.
-
-Arguments:
-    REQ-ID          Requirement ID (e.g., REQ-123)
-    delta-slug      Delta identifier (e.g., add-2fa or 2026-02-01-add-2fa)
-
-Examples:
-    flow-delta-status.sh REQ-123 add-2fa
-EOF
-    exit 1
-}
-
-# ============================================================================
-# Parse Arguments
-# ============================================================================
-
-REQ_ID="$1"
-DELTA_SLUG="$2"
-
-if [[ -z "$REQ_ID" || -z "$DELTA_SLUG" ]]; then
-    echo "Error: REQ-ID and delta-slug are required"
-    usage
-fi
-
-# Validate REQ-ID format
-if [[ ! "$REQ_ID" =~ ^REQ-[0-9]+$ ]]; then
-    echo "Error: Invalid REQ-ID format. Expected: REQ-XXX"
-    exit 1
-fi
-
-# ============================================================================
-# Helper Functions
-# ============================================================================
-
-find_delta_dir() {
-    local req_dir="$1"
-    local slug="$2"
-    local deltas_dir="$req_dir/deltas"
-
-    # Try exact match first
-    if [[ -d "$deltas_dir/$slug" ]]; then
-        echo "$deltas_dir/$slug"
-        return 0
-    fi
-
-    # Try to find by suffix (slug without date prefix)
-    for dir in "$deltas_dir"/*-"$slug"; do
-        if [[ -d "$dir" ]]; then
-            echo "$dir"
-            return 0
-        fi
-    done
-
-    return 1
-}
-
-extract_frontmatter_value() {
-    local file="$1"
-    local key="$2"
-    grep -E "^$key:" "$file" | head -1 | sed "s/$key:[[:space:]]*\"\?\([^\"]*\)\"\?/\1/"
-}
-
-count_section_items() {
-    local file="$1"
-    local section="$2"
-
-    # Count ### Requirement: headers in the section
-    awk -v section="$section" '
-        /^## / { in_section = ($0 ~ section) }
-        in_section && /^### Requirement:/ { count++ }
-        END { print count+0 }
-    ' "$file"
-}
-
-count_renamed_pairs() {
-    local file="$1"
-
-    # Count FROM:/TO: pairs in RENAMED section
-    awk '
-        /^## RENAMED/ { in_section = 1 }
-        /^## / && !/^## RENAMED/ { in_section = 0 }
-        in_section && /^- FROM:/ { count++ }
-        END { print count+0 }
-    ' "$file"
-}
-
-# ============================================================================
-# Main Logic
-# ============================================================================
-
-REQ_DIR="$PROJECT_ROOT/devflow/requirements/$REQ_ID"
-DELTAS_DIR="$REQ_DIR/deltas"
-
-if [[ ! -d "$REQ_DIR" ]]; then
-    echo "Error: Requirement directory not found: $REQ_DIR"
-    exit 1
-fi
-
-# Find the delta directory
-DELTA_DIR=$(find_delta_dir "$REQ_DIR" "$DELTA_SLUG")
-
-if [[ -z "$DELTA_DIR" || ! -d "$DELTA_DIR" ]]; then
-    echo "Error: Delta not found: $DELTA_SLUG"
-    echo "Available deltas:"
-    ls -1 "$DELTAS_DIR" 2>/dev/null || echo "  (none)"
-    exit 1
-fi
-
-DELTA_ID=$(basename "$DELTA_DIR")
-DELTA_FILE="$DELTA_DIR/delta.md"
-PRD_FILE="$REQ_DIR/PRD.md"
-
-if [[ ! -f "$DELTA_FILE" ]]; then
-    echo "Error: Delta file not found: $DELTA_FILE"
-    exit 1
-fi
-
-# Extract metadata
-STATUS=$(extract_frontmatter_value "$DELTA_FILE" "status")
-TITLE=$(extract_frontmatter_value "$DELTA_FILE" "title")
-CREATED_AT=$(extract_frontmatter_value "$DELTA_FILE" "created_at")
-
-echo "Delta: $DELTA_ID"
-echo "Title: $TITLE"
-echo "Status: $STATUS"
-echo "Created: $CREATED_AT"
-echo ""
-
-# Count changes
-ADDED_COUNT=$(count_section_items "$DELTA_FILE" "ADDED Requirements")
-MODIFIED_COUNT=$(count_section_items "$DELTA_FILE" "MODIFIED Requirements")
-REMOVED_COUNT=$(count_section_items "$DELTA_FILE" "REMOVED Requirements")
-RENAMED_COUNT=$(count_renamed_pairs "$DELTA_FILE")
-
-echo "Changes:"
-printf "  ADDED:     %d requirement(s)\n" "$ADDED_COUNT"
-printf "  MODIFIED:  %d requirement(s)\n" "$MODIFIED_COUNT"
-printf "  REMOVED:   %d requirement(s)\n" "$REMOVED_COUNT"
-printf "  RENAMED:   %d requirement(s)\n" "$RENAMED_COUNT"
-echo ""
-
-# Validation
-echo "Validation:"
-
-VALIDATION_PASSED=true
-
-# Check if PRD.md exists
-if [[ ! -f "$PRD_FILE" ]]; then
-    echo "  ✗ PRD.md not found"
-    VALIDATION_PASSED=false
-else
-    echo "  ✓ PRD.md exists"
-fi
-
-# Check for empty delta
-TOTAL_CHANGES=$((ADDED_COUNT + MODIFIED_COUNT + REMOVED_COUNT + RENAMED_COUNT))
-if [[ $TOTAL_CHANGES -eq 0 ]]; then
-    echo "  ✗ No changes defined in delta"
-    VALIDATION_PASSED=false
-else
-    echo "  ✓ Delta contains $TOTAL_CHANGES change(s)"
-fi
-
-# Try to use TypeScript parser for detailed validation
-if [[ -f "$PARSER_SCRIPT" ]]; then
-    # Parse delta and check for errors
-    PARSE_OUTPUT=$(npx ts-node "$PARSER_SCRIPT" parse "$DELTA_FILE" 2>&1) || {
-        echo "  ✗ Delta parsing failed"
-        VALIDATION_PASSED=false
-    }
-
-    if [[ -n "$PARSE_OUTPUT" && "$PARSE_OUTPUT" != *"Error"* ]]; then
-        echo "  ✓ Delta syntax is valid"
-    fi
-fi
-
-# Check status for apply readiness
-case "$STATUS" in
-    draft)
-        echo "  ⚠ Status is 'draft' - needs review before apply"
-        ;;
-    review)
-        echo "  ⚠ Status is 'review' - needs approval before apply"
-        ;;
-    approved)
-        echo "  ✓ Status is 'approved' - ready to apply"
-        ;;
-    applied)
-        echo "  ✓ Status is 'applied' - already applied"
-        ;;
-    *)
-        echo "  ✗ Unknown status: $STATUS"
-        VALIDATION_PASSED=false
-        ;;
-esac
-
-echo ""
-
-if $VALIDATION_PASSED; then
-    if [[ "$STATUS" == "approved" ]]; then
-        echo "✓ Ready to apply"
-        echo ""
-        echo "Run: /flow:delta apply $REQ_ID $DELTA_SLUG"
-    elif [[ "$STATUS" == "applied" ]]; then
-        echo "✓ Already applied"
-    else
-        echo "⚠ Validation passed, but status needs to be 'approved' before apply"
-    fi
-else
-    echo "✗ Validation failed - please fix issues before applying"
-fi

package/.claude/scripts/flow-quality-full.sh

@@ -1,215 +0,0 @@
-#!/bin/bash
-# [INPUT]: 依赖 run-quality-gates.sh, spec-reviewer, code-quality-reviewer, security-reviewer
-# [OUTPUT]: 完整质量验证结果和报告
-# [POS]: scripts 的完整质量验证脚本，被 /flow:verify --strict 调用
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-# ============================================================================
-# Configuration
-# ============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-
-# ============================================================================
-# Detect REQ-ID
-# ============================================================================
-
-REQ_ID="${1:-}"
-
-if [[ -z "$REQ_ID" ]]; then
-    REQ_ID="${DEVFLOW_REQ_ID:-}"
-fi
-
-if [[ -z "$REQ_ID" ]]; then
-    BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
-    REQ_ID=$(echo "$BRANCH" | grep -oE 'REQ-[0-9]+' | head -1 || echo "")
-fi
-
-if [[ -z "$REQ_ID" ]]; then
-    echo "Error: Could not detect REQ-ID"
-    echo "Usage: flow-quality-full.sh [REQ-ID]"
-    exit 1
-fi
-
-REQ_DIR="$PROJECT_ROOT/devflow/requirements/$REQ_ID"
-
-if [[ ! -d "$REQ_DIR" ]]; then
-    echo "Error: Requirement directory not found: $REQ_DIR"
-    exit 1
-fi
-
-# ============================================================================
-# Main Execution
-# ============================================================================
-
-echo "🔍 Quality Gate - Full Mode"
-echo "=============================="
-echo "REQ: $REQ_ID"
-echo ""
-
-START_TIME=$(date +%s)
-
-# Phase 1: Programmatic Checks
-echo "Phase 1: Programmatic Checks"
-echo "----------------------------"
-"$SCRIPT_DIR/run-quality-gates.sh" flow-quality --full || {
-    echo ""
-    echo "❌ Programmatic checks failed. Fix issues before continuing."
-    exit 1
-}
-
-echo ""
-echo "Phase 2: Spec Compliance Review"
-echo "-------------------------------"
-echo "ℹ️  Invoking spec-reviewer agent..."
-echo "   (This would normally invoke the spec-reviewer subagent)"
-echo "   Output: $REQ_DIR/SPEC_REVIEW.md"
-
-# Create placeholder report
-cat > "$REQ_DIR/SPEC_REVIEW.md" << EOF
-# Spec Compliance Review
-
-> Generated by /flow:verify --strict
-
-## Summary
-
-**Status**: PASS
-**Reviewed**: $(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-## Checklist
-
-- [x] Implementation matches PRD user stories
-- [x] Technical design followed
-- [x] API contracts implemented correctly
-- [x] Data models match specification
-
-## Notes
-
-Full review performed by spec-reviewer agent.
-EOF
-
-echo "   ✓ SPEC_REVIEW.md generated"
-
-echo ""
-echo "Phase 3: Code Quality Review"
-echo "----------------------------"
-echo "ℹ️  Invoking code-quality-reviewer agent..."
-echo "   Output: $REQ_DIR/CODE_QUALITY_REVIEW.md"
-
-# Create placeholder report
-cat > "$REQ_DIR/CODE_QUALITY_REVIEW.md" << EOF
-# Code Quality Review
-
-> Generated by /flow:verify --strict
-
-## Summary
-
-**Status**: PASS
-**Reviewed**: $(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-## Checklist
-
-- [x] No code duplication (Article II)
-- [x] No hardcoded secrets (Article III)
-- [x] Resources properly managed (Article IV)
-- [x] No dead code (Article V)
-- [x] TDD followed (Article VI)
-
-## Notes
-
-Full review performed by code-quality-reviewer agent.
-EOF
-
-echo "   ✓ CODE_QUALITY_REVIEW.md generated"
-
-echo ""
-echo "Phase 4: Security Review"
-echo "------------------------"
-echo "ℹ️  Running security checks..."
-
-# Run npm audit if available
-if command -v npm &> /dev/null && [[ -f "$PROJECT_ROOT/package.json" ]]; then
-    npm audit --audit-level=high 2>/dev/null || true
-fi
-
-# Create security report
-cat > "$REQ_DIR/SECURITY_REPORT.md" << EOF
-# Security Report
-
-> Generated by /flow:verify --strict
-
-## Summary
-
-**Status**: PASS
-**Scanned**: $(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-## Checks Performed
-
-- [x] npm audit (no high-severity vulnerabilities)
-- [x] Secret detection (no hardcoded secrets)
-- [x] Input validation review
-
-## Notes
-
-Full security review performed.
-EOF
-
-echo "   ✓ SECURITY_REPORT.md generated"
-
-echo ""
-echo "Phase 5: Test Report"
-echo "--------------------"
-
-# Create test report
-cat > "$REQ_DIR/TEST_REPORT.md" << EOF
-# Test Report
-
-> Generated by /flow:verify --strict
-
-## Summary
-
-**Status**: PASS
-**Executed**: $(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-## Programmatic Checks
-
-- [x] Lint Check: PASS
-- [x] Type Check: PASS
-- [x] Unit Tests: PASS
-- [x] Integration Tests: PASS (or skipped when command unavailable)
-
-## Quality Gate
-
-**Gate**: PASS
-EOF
-
-echo "   ✓ TEST_REPORT.md generated"
-
-END_TIME=$(date +%s)
-DURATION=$((END_TIME - START_TIME))
-
-echo ""
-echo "=============================="
-echo "✅ Quality Gate PASSED (Full Mode)"
-echo ""
-echo "Reports Generated:"
-echo "  - $REQ_DIR/SPEC_REVIEW.md"
-echo "  - $REQ_DIR/CODE_QUALITY_REVIEW.md"
-echo "  - $REQ_DIR/SECURITY_REPORT.md"
-echo "  - $REQ_DIR/TEST_REPORT.md"
-echo ""
-echo "Duration: ${DURATION}s"
-
-# Update orchestration status
-STATUS_FILE="$REQ_DIR/orchestration_status.json"
-if [[ -f "$STATUS_FILE" ]]; then
-    TMP_FILE="${STATUS_FILE}.tmp"
-    # Backward compatibility: keep qa_complete flag for old release gates.
-    jq '.status = "quality_complete" | .phase = "quality" | .quality_complete = true | .qa_complete = true | .quality_mode = "full" | .quality_timestamp = now' "$STATUS_FILE" > "$TMP_FILE"
-    mv "$TMP_FILE" "$STATUS_FILE"
-    echo ""
-    echo "✅ Updated orchestration_status.json"
-fi

package/.claude/scripts/flow-quality-quick.sh

@@ -1,119 +0,0 @@
-#!/bin/bash
-# [INPUT]: 依赖 run-quality-gates.sh
-# [OUTPUT]: 快速质量验证结果
-# [POS]: scripts 的快速质量验证脚本，被 /flow:verify 调用
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-# ============================================================================
-# Configuration
-# ============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-
-# ============================================================================
-# Detect REQ-ID
-# ============================================================================
-
-REQ_ID="${1:-}"
-
-if [[ -z "$REQ_ID" ]]; then
-    REQ_ID="${DEVFLOW_REQ_ID:-}"
-fi
-
-if [[ -z "$REQ_ID" ]]; then
-    BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
-    REQ_ID=$(echo "$BRANCH" | grep -oE 'REQ-[0-9]+' | head -1 || echo "")
-fi
-
-REQ_DIR=""
-if [[ -n "$REQ_ID" ]]; then
-    REQ_DIR="$PROJECT_ROOT/devflow/requirements/$REQ_ID"
-fi
-
-# ============================================================================
-# Main Execution
-# ============================================================================
-
-echo "🔍 Quality Gate - Quick Mode"
-echo "=============================="
-if [[ -n "$REQ_ID" ]]; then
-    echo "REQ: $REQ_ID"
-fi
-echo ""
-
-START_TIME=$(date +%s)
-
-# Run quality gates
-"$SCRIPT_DIR/run-quality-gates.sh" flow-quality --quick
-
-# Generate minimal reports in quick mode so flow-release gates can proceed.
-if [[ -n "$REQ_DIR" && -d "$REQ_DIR" ]]; then
-    cat > "$REQ_DIR/TEST_REPORT.md" << EOF
-# Test Report
-
-> Generated by /flow:verify (quick mode)
-
-## Summary
-
-**Status**: PASS
-**Executed**: $(date -u +"%Y-%m-%dT%H:%M:%SZ")
-**Mode**: quick
-
-## Programmatic Checks
-
-- [x] Lint Check: PASS
-- [x] Type Check: PASS
-- [x] Unit Tests: PASS
-
-## Quality Gate
-
-**Gate**: PASS
-EOF
-
-    cat > "$REQ_DIR/SECURITY_REPORT.md" << EOF
-# Security Report
-
-> Generated by /flow:verify (quick mode)
-
-## Summary
-
-**Status**: PASS
-**Scanned**: $(date -u +"%Y-%m-%dT%H:%M:%SZ")
-**Mode**: quick
-
-## Checks Performed
-
-- [x] Baseline quality gate security checks
-- [ ] Deep security audit (use /flow:verify --strict when needed)
-
-## Quality Gate
-
-**Gate**: PASS
-EOF
-
-    echo "Generated reports:"
-    echo "  - $REQ_DIR/TEST_REPORT.md"
-    echo "  - $REQ_DIR/SECURITY_REPORT.md"
-fi
-
-END_TIME=$(date +%s)
-DURATION=$((END_TIME - START_TIME))
-
-echo ""
-echo "Duration: ${DURATION}s"
-
-# Update orchestration status if REQ_ID is set
-if [[ -n "$REQ_ID" ]]; then
-    STATUS_FILE="$PROJECT_ROOT/devflow/requirements/$REQ_ID/orchestration_status.json"
-    if [[ -f "$STATUS_FILE" ]]; then
-        # Backward compatibility: keep qa_complete flag for old release gates.
-        TMP_FILE="${STATUS_FILE}.tmp"
-        jq '.status = "quality_complete" | .phase = "quality" | .quality_complete = true | .qa_complete = true | .quality_mode = "quick" | .quality_timestamp = now' "$STATUS_FILE" > "$TMP_FILE"
-        mv "$TMP_FILE" "$STATUS_FILE"
-        echo ""
-        echo "✅ Updated orchestration_status.json"
-    fi
-fi

package/.claude/scripts/flow-workspace-init.sh

@@ -1,117 +0,0 @@
-#!/bin/bash
-# [INPUT]: 依赖 JOURNAL_TEMPLATE.md
-# [OUTPUT]: 创建 devflow/workspace/{developer}/ 目录
-# [POS]: scripts 的 workspace 初始化脚本，被 /flow-workspace init 调用
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-# ============================================================================
-# Configuration
-# ============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-WORKSPACE_DIR="$PROJECT_ROOT/devflow/workspace"
-TEMPLATE_FILE="$PROJECT_ROOT/.claude/docs/templates/JOURNAL_TEMPLATE.md"
-
-# ============================================================================
-# Usage
-# ============================================================================
-
-usage() {
-    cat << EOF
-Usage: flow-workspace-init.sh [developer]
-
-Initialize a workspace for a developer.
-
-Arguments:
-    developer       Developer name (default: current user)
-
-Examples:
-    flow-workspace-init.sh dimon
-    flow-workspace-init.sh
-EOF
-    exit 1
-}
-
-# ============================================================================
-# Parse Arguments
-# ============================================================================
-
-DEVELOPER="${1:-$(whoami)}"
-
-# ============================================================================
-# Main Logic
-# ============================================================================
-
-DEV_WORKSPACE="$WORKSPACE_DIR/$DEVELOPER"
-
-# Check if workspace already exists
-if [[ -d "$DEV_WORKSPACE" ]]; then
-    echo "Workspace already exists: $DEV_WORKSPACE"
-    echo ""
-    echo "Current state:"
-    if [[ -f "$DEV_WORKSPACE/.current-req" ]]; then
-        echo "  Current REQ: $(cat "$DEV_WORKSPACE/.current-req")"
-    else
-        echo "  Current REQ: None"
-    fi
-    JOURNAL_COUNT=$(ls -1 "$DEV_WORKSPACE"/journal-*.md 2>/dev/null | wc -l || echo "0")
-    echo "  Journals: $JOURNAL_COUNT"
-    exit 0
-fi
-
-# Create workspace directory
-mkdir -p "$DEV_WORKSPACE"
-
-# Create initial journal
-TIMESTAMP=$(date +"%Y-%m-%d %H:%M")
-DATE=$(date +"%Y-%m-%d")
-
-cat > "$DEV_WORKSPACE/journal-1.md" << EOF
----
-developer: "$DEVELOPER"
-journal_number: 1
-created_at: "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
----
-
-# Developer Journal: $DEVELOPER
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
----
-
-## [$TIMESTAMP] Workspace Initialized
-
-Workspace created for $DEVELOPER.
-
-### Next Steps
-
-1. Start a requirement with \`/flow:init "REQ-XXX|Title"\`
-2. Use \`/flow-workspace record "message"\` to track progress
-3. Use \`/flow-workspace start\` to recover context in new sessions
-
----
-EOF
-
-# Update workspace index
-INDEX_FILE="$WORKSPACE_DIR/index.md"
-if [[ -f "$INDEX_FILE" ]]; then
-    # Add developer to index if not already present
-    if ! grep -q "| $DEVELOPER |" "$INDEX_FILE"; then
-        # Insert before the last line (which should be empty or a separator)
-        sed -i.bak "/^| _template_ |/a\\
-| $DEVELOPER | - | - | $DATE |" "$INDEX_FILE"
-        rm -f "$INDEX_FILE.bak"
-    fi
-fi
-
-echo "✅ Workspace initialized: $DEV_WORKSPACE"
-echo ""
-echo "Files created:"
-ls -la "$DEV_WORKSPACE"
-echo ""
-echo "Next steps:"
-echo "  1. Start a requirement: /flow:init \"REQ-XXX|Title\""
-echo "  2. Record progress: /flow-workspace record \"message\""