cc-devflow 4.3.0 → 4.5.0

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

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

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

@@ -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