cc-devflow 4.3.0 → 4.4.1

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\""

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

@@ -1,164 +0,0 @@
-#!/bin/bash
-# [INPUT]: 依赖 journal-*.md
-# [OUTPUT]: 追加记录到 journal
-# [POS]: scripts 的 workspace 记录脚本，被 /flow-workspace record 调用
-# [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"
-MAX_JOURNAL_LINES=2000
-
-# ============================================================================
-# Usage
-# ============================================================================
-
-usage() {
-    cat << EOF
-Usage: flow-workspace-record.sh <message> [--task TASK_ID]
-
-Record progress to the journal.
-
-Arguments:
-    message         Progress message
-
-Options:
-    --task          Associated task ID (e.g., T015)
-    --phase         Current phase (e.g., flow-dev)
-
-Examples:
-    flow-workspace-record.sh "Completed authentication middleware"
-    flow-workspace-record.sh "Fixed rate limiting bug" --task T015
-EOF
-    exit 1
-}
-
-# ============================================================================
-# Parse Arguments
-# ============================================================================
-
-MESSAGE=""
-TASK_ID=""
-PHASE=""
-
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --task)
-            TASK_ID="$2"
-            shift 2
-            ;;
-        --phase)
-            PHASE="$2"
-            shift 2
-            ;;
-        --help|-h)
-            usage
-            ;;
-        *)
-            if [[ -z "$MESSAGE" ]]; then
-                MESSAGE="$1"
-            fi
-            shift
-            ;;
-    esac
-done
-
-if [[ -z "$MESSAGE" ]]; then
-    echo "Error: message is required"
-    usage
-fi
-
-# ============================================================================
-# Detect Developer and Workspace
-# ============================================================================
-
-DEVELOPER="${DEVFLOW_DEVELOPER:-$(whoami)}"
-DEV_WORKSPACE="$WORKSPACE_DIR/$DEVELOPER"
-
-if [[ ! -d "$DEV_WORKSPACE" ]]; then
-    echo "Workspace not found for $DEVELOPER"
-    echo "Run '/flow-workspace init $DEVELOPER' first."
-    exit 1
-fi
-
-# ============================================================================
-# Main Logic
-# ============================================================================
-
-# Find latest journal
-LATEST_JOURNAL=$(ls -1 "$DEV_WORKSPACE"/journal-*.md 2>/dev/null | sort -V | tail -1)
-
-if [[ -z "$LATEST_JOURNAL" ]]; then
-    # Create first journal
-    LATEST_JOURNAL="$DEV_WORKSPACE/journal-1.md"
-    cat > "$LATEST_JOURNAL" << EOF
----
-developer: "$DEVELOPER"
-journal_number: 1
-created_at: "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
----
-
-# Developer Journal: $DEVELOPER
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
----
-EOF
-fi
-
-# Check if journal is too long
-LINE_COUNT=$(wc -l < "$LATEST_JOURNAL")
-if [[ $LINE_COUNT -ge $MAX_JOURNAL_LINES ]]; then
-    # Create new journal
-    JOURNAL_NUM=$(basename "$LATEST_JOURNAL" | grep -oE '[0-9]+' || echo "1")
-    NEW_NUM=$((JOURNAL_NUM + 1))
-    LATEST_JOURNAL="$DEV_WORKSPACE/journal-$NEW_NUM.md"
-
-    cat > "$LATEST_JOURNAL" << EOF
----
-developer: "$DEVELOPER"
-journal_number: $NEW_NUM
-created_at: "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
----
-
-# Developer Journal: $DEVELOPER (continued)
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
----
-EOF
-    echo "Created new journal: $(basename "$LATEST_JOURNAL")"
-fi
-
-# Build entry
-TIMESTAMP=$(date +"%Y-%m-%d %H:%M")
-ENTRY="## [$TIMESTAMP] Progress Update
-
-"
-
-if [[ -n "$TASK_ID" ]]; then
-    ENTRY+="**Task**: $TASK_ID
-"
-fi
-
-if [[ -n "$PHASE" ]]; then
-    ENTRY+="**Phase**: $PHASE
-"
-fi
-
-ENTRY+="
-$MESSAGE
-
----
-"
-
-# Append to journal
-echo "$ENTRY" >> "$LATEST_JOURNAL"
-
-echo "✅ Recorded to $(basename "$LATEST_JOURNAL")"