cc-devflow 2.4.6 → 4.1.0

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

@@ -0,0 +1,71 @@
+#!/bin/bash
+# [INPUT]: 依赖 delta-specs/ 目录
+# [OUTPUT]: 归档到 devflow/archive/
+# [POS]: scripts 的 delta spec 归档脚本，被 /flow-delta archive 调用
+# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+
+set -e
+
+# ============================================================================
+# Configuration
+# ============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+ARCHIVE_DIR="$PROJECT_ROOT/devflow/archive"
+
+# ============================================================================
+# Parse Arguments
+# ============================================================================
+
+REQ_ID="${1:-}"
+
+# Auto-detect REQ-ID
+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-delta-archive.sh [REQ-ID]"
+    exit 1
+fi
+
+# ============================================================================
+# Main Logic
+# ============================================================================
+
+REQ_DIR="$PROJECT_ROOT/devflow/requirements/$REQ_ID"
+DELTA_DIR="$REQ_DIR/delta-specs"
+
+if [[ ! -d "$DELTA_DIR" ]]; then
+    echo "No delta-specs found for $REQ_ID"
+    exit 0
+fi
+
+# Create archive directory with date prefix
+DATE_PREFIX=$(date +"%Y-%m")
+ARCHIVE_TARGET="$ARCHIVE_DIR/$DATE_PREFIX/$REQ_ID/delta-specs"
+
+echo "Archiving delta-specs for $REQ_ID..."
+echo "  From: $DELTA_DIR"
+echo "  To: $ARCHIVE_TARGET"
+
+# Create archive directory
+mkdir -p "$ARCHIVE_TARGET"
+
+# Copy delta-specs to archive
+cp -r "$DELTA_DIR"/* "$ARCHIVE_TARGET/"
+
+# Remove original delta-specs
+rm -rf "$DELTA_DIR"
+
+echo ""
+echo "✅ Delta specs archived successfully"
+echo ""
+echo "Archive location: $ARCHIVE_TARGET"

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

@@ -0,0 +1,202 @@
+#!/bin/bash
+# [INPUT]: 依赖 DELTA_SPEC_TEMPLATE.md
+# [OUTPUT]: 创建 deltas/{date}-{slug}/delta.md
+# [POS]: scripts 的 delta spec 创建脚本，被 /flow:delta create 调用
+# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+
+set -e
+
+# ============================================================================
+# Configuration
+# ============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+TEMPLATE_FILE="$PROJECT_ROOT/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md"
+
+# ============================================================================
+# Usage
+# ============================================================================
+
+usage() {
+    cat << EOF
+Usage: flow-delta-create.sh <REQ-ID> <slug> [title]
+
+Create a new delta spec for a requirement.
+
+Arguments:
+    REQ-ID          Requirement ID (e.g., REQ-123)
+    slug            Short identifier for the delta (e.g., add-2fa)
+    title           Optional title (defaults to slug with spaces)
+
+Examples:
+    flow-delta-create.sh REQ-123 add-2fa
+    flow-delta-create.sh REQ-123 add-2fa "Add Two-Factor Authentication"
+EOF
+    exit 1
+}
+
+# ============================================================================
+# Parse Arguments
+# ============================================================================
+
+REQ_ID="$1"
+SLUG="$2"
+TITLE="${3:-}"
+
+if [[ -z "$REQ_ID" || -z "$SLUG" ]]; then
+    echo "Error: REQ-ID and 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
+
+# Generate title from slug if not provided
+if [[ -z "$TITLE" ]]; then
+    TITLE=$(echo "$SLUG" | sed 's/-/ /g' | sed 's/\b\(.\)/\u\1/g')
+fi
+
+# ============================================================================
+# Main Logic
+# ============================================================================
+
+REQ_DIR="$PROJECT_ROOT/devflow/requirements/$REQ_ID"
+
+if [[ ! -d "$REQ_DIR" ]]; then
+    echo "Error: Requirement directory not found: $REQ_DIR"
+    exit 1
+fi
+
+# Generate delta_id with date prefix
+DATE_PREFIX=$(date +"%Y-%m-%d")
+DELTA_ID="${DATE_PREFIX}-${SLUG}"
+DELTA_DIR="$REQ_DIR/deltas/$DELTA_ID"
+DELTA_FILE="$DELTA_DIR/delta.md"
+TASKS_FILE="$DELTA_DIR/tasks.md"
+
+# Check if delta already exists
+if [[ -d "$DELTA_DIR" ]]; then
+    echo "Error: Delta already exists: $DELTA_DIR"
+    exit 1
+fi
+
+# Create delta directory
+mkdir -p "$DELTA_DIR"
+
+# Generate timestamp
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Create delta.md from template
+if [[ -f "$TEMPLATE_FILE" ]]; then
+    sed -e "s/{DELTA_ID}/$DELTA_ID/g" \
+        -e "s/{REQ_ID}/$REQ_ID/g" \
+        -e "s/{TITLE}/$TITLE/g" \
+        -e "s/{TIMESTAMP}/$TIMESTAMP/g" \
+        -e "s/{AUTHOR}/Claude/g" \
+        "$TEMPLATE_FILE" > "$DELTA_FILE"
+else
+    # Create minimal delta spec
+    cat > "$DELTA_FILE" << EOF
+---
+delta_id: "$DELTA_ID"
+req_id: "$REQ_ID"
+title: "$TITLE"
+created_at: "$TIMESTAMP"
+status: "draft"
+---
+
+# Delta: $TITLE
+
+> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
+
+## Summary
+
+{简要描述变更内容}
+
+---
+
+## ADDED Requirements
+
+### Requirement: {Name}
+
+{Description}
+
+#### Scenario: {Scenario Name}
+
+- GIVEN {precondition}
+- WHEN {action}
+- THEN {expected result}
+
+---
+
+## MODIFIED Requirements
+
+### Requirement: {Name}
+
+{New description}
+
+(Previously: {old description})
+
+---
+
+## REMOVED Requirements
+
+### Requirement: {Name}
+
+**Reason**: {why removed}
+
+**Migration**: {how to migrate}
+
+---
+
+## RENAMED Requirements
+
+- FROM: {Old Name}
+- TO: {New Name}
+
+---
+
+**Author**: Claude
+**Reviewed By**: Pending
+EOF
+fi
+
+# Create tasks.md for delta-specific tasks
+cat > "$TASKS_FILE" << EOF
+---
+delta_id: "$DELTA_ID"
+req_id: "$REQ_ID"
+created_at: "$TIMESTAMP"
+---
+
+# Tasks for Delta: $TITLE
+
+> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
+
+## Tasks
+
+- [ ] T001: Review delta specification
+- [ ] T002: Implement changes
+- [ ] T003: Update tests
+- [ ] T004: Update documentation
+
+## Notes
+
+Add implementation notes here.
+EOF
+
+echo "✅ Created delta: $DELTA_ID"
+echo ""
+echo "Files created:"
+echo "  - $DELTA_FILE"
+echo "  - $TASKS_FILE"
+echo ""
+echo "Next steps:"
+echo "  1. Edit delta.md to add ADDED/MODIFIED/REMOVED/RENAMED sections"
+echo "  2. Run '/flow:delta status $REQ_ID $SLUG' to validate"
+echo "  3. Change status to 'approved' when ready"
+echo "  4. Run '/flow:delta apply $REQ_ID $SLUG' to apply changes"

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

@@ -0,0 +1,142 @@
+#!/bin/bash
+# [INPUT]: 依赖 deltas/ 目录
+# [OUTPUT]: 列出所有 delta specs
+# [POS]: scripts 的 delta spec 列表脚本，被 /flow:delta list 调用
+# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+
+set -e
+
+# ============================================================================
+# Configuration
+# ============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# ============================================================================
+# Usage
+# ============================================================================
+
+usage() {
+    cat << EOF
+Usage: flow-delta-list.sh <REQ-ID>
+
+List all delta specs for a requirement.
+
+Arguments:
+    REQ-ID          Requirement ID (e.g., REQ-123)
+
+Examples:
+    flow-delta-list.sh REQ-123
+EOF
+    exit 1
+}
+
+# ============================================================================
+# Parse Arguments
+# ============================================================================
+
+REQ_ID="$1"
+
+if [[ -z "$REQ_ID" ]]; then
+    # Try to auto-detect from environment or branch
+    REQ_ID="${DEVFLOW_REQ_ID:-}"
+    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
+fi
+
+if [[ -z "$REQ_ID" ]]; then
+    echo "Error: REQ-ID is 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
+
+# ============================================================================
+# 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
+
+if [[ ! -d "$DELTAS_DIR" ]]; then
+    echo "No deltas found for $REQ_ID"
+    exit 0
+fi
+
+echo "Deltas for $REQ_ID:"
+echo ""
+
+COUNT=0
+DRAFT_COUNT=0
+REVIEW_COUNT=0
+APPROVED_COUNT=0
+APPLIED_COUNT=0
+
+# List all delta directories
+for delta_dir in "$DELTAS_DIR"/*/; do
+    if [[ ! -d "$delta_dir" ]]; then
+        continue
+    fi
+
+    DELTA_ID=$(basename "$delta_dir")
+    DELTA_FILE="$delta_dir/delta.md"
+
+    if [[ ! -f "$DELTA_FILE" ]]; then
+        continue
+    fi
+
+    ((COUNT++))
+
+    # Extract status and title from frontmatter
+    STATUS="unknown"
+    TITLE=""
+
+    while IFS= read -r line; do
+        if [[ "$line" =~ ^status:[[:space:]]*\"?([^\"]+)\"? ]]; then
+            STATUS="${BASH_REMATCH[1]}"
+        elif [[ "$line" =~ ^title:[[:space:]]*\"?([^\"]+)\"? ]]; then
+            TITLE="${BASH_REMATCH[1]}"
+        fi
+    done < <(head -20 "$DELTA_FILE")
+
+    # Count by status
+    case "$STATUS" in
+        draft) ((DRAFT_COUNT++)) ;;
+        review) ((REVIEW_COUNT++)) ;;
+        approved) ((APPROVED_COUNT++)) ;;
+        applied) ((APPLIED_COUNT++)) ;;
+    esac
+
+    # Format status with padding
+    STATUS_PADDED=$(printf "%-10s" "[$STATUS]")
+
+    printf "  %2d. %-25s %s  %s\n" "$COUNT" "$DELTA_ID" "$STATUS_PADDED" "$TITLE"
+done
+
+echo ""
+echo "Total: $COUNT deltas"
+
+# Show breakdown if there are deltas
+if [[ $COUNT -gt 0 ]]; then
+    BREAKDOWN=""
+    [[ $DRAFT_COUNT -gt 0 ]] && BREAKDOWN="$DRAFT_COUNT draft"
+    [[ $REVIEW_COUNT -gt 0 ]] && BREAKDOWN="${BREAKDOWN:+$BREAKDOWN, }$REVIEW_COUNT review"
+    [[ $APPROVED_COUNT -gt 0 ]] && BREAKDOWN="${BREAKDOWN:+$BREAKDOWN, }$APPROVED_COUNT approved"
+    [[ $APPLIED_COUNT -gt 0 ]] && BREAKDOWN="${BREAKDOWN:+$BREAKDOWN, }$APPLIED_COUNT applied"
+
+    if [[ -n "$BREAKDOWN" ]]; then
+        echo "  ($BREAKDOWN)"
+    fi
+fi

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

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