cc-devflow 2.4.6 → 4.1.0

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

@@ -0,0 +1,184 @@
+#!/bin/bash
+# [INPUT]: 依赖 run-quality-gates.sh, spec-reviewer, code-quality-reviewer, security-reviewer
+# [OUTPUT]: 完整质量验证结果和报告
+# [POS]: scripts 的完整质量验证脚本，被 /flow-quality --full 调用
+# [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-quality --full
+
+## 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-quality --full
+
+## 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-quality --full
+
+## 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"
+
+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 ""
+echo "Duration: ${DURATION}s"
+
+# Update orchestration status
+STATUS_FILE="$REQ_DIR/orchestration_status.json"
+if [[ -f "$STATUS_FILE" ]]; then
+    TMP_FILE="${STATUS_FILE}.tmp"
+    jq '.status = "quality_complete" | .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

@@ -0,0 +1,64 @@
+#!/bin/bash
+# [INPUT]: 依赖 run-quality-gates.sh
+# [OUTPUT]: 快速质量验证结果
+# [POS]: scripts 的快速质量验证脚本，被 /flow-quality 调用
+# [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
+
+# ============================================================================
+# 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
+
+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
+        # Update status using jq
+        TMP_FILE="${STATUS_FILE}.tmp"
+        jq '.status = "quality_complete" | .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

@@ -0,0 +1,117 @@
+#!/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

@@ -0,0 +1,164 @@
+#!/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")"

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

@@ -0,0 +1,88 @@
+#!/bin/bash
+# [INPUT]: 依赖 .current-req 和 journal-*.md
+# [OUTPUT]: 显示上下文恢复信息
+# [POS]: scripts 的 workspace 启动脚本，被 /flow-workspace start 调用
+# [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"
+
+# ============================================================================
+# Detect Developer
+# ============================================================================
+
+DEVELOPER="${1:-$(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
+# ============================================================================
+
+echo "🔄 Session Recovery for $DEVELOPER"
+echo "=================================="
+echo ""
+
+# Read current requirement
+if [[ -f "$DEV_WORKSPACE/.current-req" ]]; then
+    CURRENT_REQ=$(cat "$DEV_WORKSPACE/.current-req")
+    echo "📋 Current Requirement: $CURRENT_REQ"
+
+    # Check if requirement directory exists
+    REQ_DIR="$PROJECT_ROOT/devflow/requirements/$CURRENT_REQ"
+    if [[ -d "$REQ_DIR" ]]; then
+        # Read orchestration status
+        STATUS_FILE="$REQ_DIR/orchestration_status.json"
+        if [[ -f "$STATUS_FILE" ]]; then
+            STATUS=$(jq -r '.status' "$STATUS_FILE" 2>/dev/null || echo "unknown")
+            echo "   Status: $STATUS"
+        fi
+
+        # Check TASKS.md for progress
+        TASKS_FILE="$REQ_DIR/TASKS.md"
+        if [[ -f "$TASKS_FILE" ]]; then
+            TOTAL=$(grep -c '^\- \[' "$TASKS_FILE" 2>/dev/null || echo "0")
+            DONE=$(grep -c '^\- \[x\]' "$TASKS_FILE" 2>/dev/null || echo "0")
+            echo "   Tasks: $DONE/$TOTAL completed"
+        fi
+    else
+        echo "   ⚠️  Requirement directory not found"
+    fi
+else
+    echo "📋 Current Requirement: None"
+fi
+
+echo ""
+
+# Read latest journal entries
+LATEST_JOURNAL=$(ls -1 "$DEV_WORKSPACE"/journal-*.md 2>/dev/null | sort -V | tail -1)
+
+if [[ -n "$LATEST_JOURNAL" && -f "$LATEST_JOURNAL" ]]; then
+    echo "📓 Latest Journal: $(basename "$LATEST_JOURNAL")"
+    echo ""
+    echo "Recent entries:"
+    echo "---------------"
+
+    # Show last 20 lines of journal (excluding frontmatter)
+    tail -30 "$LATEST_JOURNAL" | head -20
+
+    echo ""
+    echo "---------------"
+fi
+
+echo ""
+echo "Ready to continue. Use:"
+echo "  /flow-workspace record \"message\"  - Record progress"
+echo "  /flow-workspace switch REQ-XXX    - Switch requirement"