cc-devflow 4.3.0 → 4.4.1

package/.claude/scripts/import-openspec.js

@@ -1,272 +0,0 @@
-#!/usr/bin/env node
-/**
- * [INPUT]: 依赖 OpenSpec spec.md 文件路径，依赖 REQ-ID
- * [OUTPUT]: 生成 CC-DevFlow 格式的 spec.md，自动补充 TDD 任务
- * [POS]: OpenSpec 互操作层，被 /flow:import-openspec 命令调用
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * 解析 OpenSpec spec.md 格式
- *
- * OpenSpec 格式:
- * # Module Name
- * ## Purpose
- * ## Requirements
- * ### Requirement: Name
- * #### Scenario: Case
- * - GIVEN ...
- * - WHEN ...
- * - THEN ...
- */
-function parseOpenSpecMarkdown(content) {
-  const lines = content.split('\n');
-  const result = {
-    moduleName: '',
-    purpose: '',
-    requirements: []
-  };
-
-  let currentSection = null;
-  let currentRequirement = null;
-  let currentScenario = null;
-  let buffer = [];
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-
-    // # Module Name
-    if (line.startsWith('# ') && !result.moduleName) {
-      result.moduleName = line.substring(2).trim();
-      continue;
-    }
-
-    // ## Purpose
-    if (line.startsWith('## Purpose')) {
-      currentSection = 'purpose';
-      buffer = [];
-      continue;
-    }
-
-    // ## Requirements
-    if (line.startsWith('## Requirements')) {
-      if (currentSection === 'purpose') {
-        result.purpose = buffer.join('\n').trim();
-      }
-      currentSection = 'requirements';
-      buffer = [];
-      continue;
-    }
-
-    // ### Requirement: Name
-    if (line.startsWith('### Requirement:')) {
-      if (currentRequirement) {
-        result.requirements.push(currentRequirement);
-      }
-      currentRequirement = {
-        name: line.substring(16).trim(),
-        description: '',
-        scenarios: []
-      };
-      currentScenario = null;
-      buffer = [];
-      continue;
-    }
-
-    // #### Scenario: Case
-    if (line.startsWith('#### Scenario:')) {
-      if (currentRequirement && buffer.length > 0) {
-        currentRequirement.description = buffer.join('\n').trim();
-        buffer = [];
-      }
-      currentScenario = {
-        name: line.substring(14).trim(),
-        steps: []
-      };
-      continue;
-    }
-
-    // BDD steps (GIVEN/WHEN/THEN)
-    if (currentScenario && (line.startsWith('- GIVEN') || line.startsWith('- WHEN') || line.startsWith('- THEN') || line.startsWith('- AND'))) {
-      currentScenario.steps.push(line.substring(2).trim());
-      continue;
-    }
-
-    // 收集内容
-    if (currentSection === 'purpose' && line.trim()) {
-      buffer.push(line);
-    } else if (currentRequirement && !currentScenario && line.trim()) {
-      buffer.push(line);
-    }
-
-    // 场景结束
-    if (currentScenario && line.trim() === '' && currentScenario.steps.length > 0) {
-      currentRequirement.scenarios.push(currentScenario);
-      currentScenario = null;
-    }
-  }
-
-  // 处理最后的 requirement
-  if (currentRequirement) {
-    if (currentScenario && currentScenario.steps.length > 0) {
-      currentRequirement.scenarios.push(currentScenario);
-    }
-    result.requirements.push(currentRequirement);
-  }
-
-  return result;
-}
-
-/**
- * 转换为 CC-DevFlow spec.md 格式
- */
-function convertToDevFlowSpec(openspecData, reqId, title) {
-  const now = new Date().toISOString();
-
-  let output = `---
-req_id: "${reqId}"
-title: "${title}"
-created_at: "${now}"
-updated_at: "${now}"
-version: "1.0.0"
-status: "draft"
-source: "openspec"
----
-
-# ${openspecData.moduleName}
-
-## Purpose
-
-${openspecData.purpose}
-
-## Requirements
-
-`;
-
-  // 转换 Requirements
-  for (const req of openspecData.requirements) {
-    output += `### Requirement: ${req.name}\n\n`;
-
-    if (req.description) {
-      output += `${req.description}\n\n`;
-    }
-
-    // 转换 Scenarios (BDD 格式)
-    for (const scenario of req.scenarios) {
-      output += `#### Scenario: ${scenario.name}\n\n`;
-      for (const step of scenario.steps) {
-        output += `- ${step}\n`;
-      }
-      output += '\n';
-    }
-  }
-
-  // 添加 Design 部分 (空白，待填充)
-  output += `## Design
-
-[NEEDS CLARIFICATION: 技术实现方案]
-
-### Architecture
-
-[NEEDS CLARIFICATION: 架构设计]
-
-### Data Model
-
-[NEEDS CLARIFICATION: 数据模型]
-
-### API Design
-
-[NEEDS CLARIFICATION: API 设计]
-
-## Tasks
-
-`;
-
-  // 自动生成 TDD 任务
-  let taskId = 1;
-  for (const req of openspecData.requirements) {
-    const featureName = req.name;
-
-    // TEST 任务
-    output += `- [ ] T${String(taskId).padStart(3, '0')} [TEST] ${featureName} - 测试\n`;
-    const testTaskId = taskId;
-    taskId++;
-
-    // IMPL 任务
-    output += `- [ ] T${String(taskId).padStart(3, '0')} [IMPL] ${featureName} - 实现 (dependsOn:T${String(testTaskId).padStart(3, '0')})\n`;
-    taskId++;
-  }
-
-  output += `
-## Verification
-
-`;
-
-  // 生成验收标准
-  for (const req of openspecData.requirements) {
-    output += `- [ ] ${req.name}\n`;
-    for (const scenario of req.scenarios) {
-      output += `  - [ ] ${scenario.name}\n`;
-    }
-  }
-
-  return output;
-}
-
-/**
- * 主函数
- */
-function importOpenSpec(openspecPath, reqId, title, outputPath) {
-  // 读取 OpenSpec 文件
-  if (!fs.existsSync(openspecPath)) {
-    throw new Error(`OpenSpec file not found: ${openspecPath}`);
-  }
-
-  const content = fs.readFileSync(openspecPath, 'utf-8');
-
-  // 解析 OpenSpec
-  const openspecData = parseOpenSpecMarkdown(content);
-
-  // 转换为 CC-DevFlow 格式
-  const devflowSpec = convertToDevFlowSpec(openspecData, reqId, title);
-
-  // 写入输出文件
-  const outputDir = path.dirname(outputPath);
-  if (!fs.existsSync(outputDir)) {
-    fs.mkdirSync(outputDir, { recursive: true });
-  }
-
-  fs.writeFileSync(outputPath, devflowSpec, 'utf-8');
-
-  return {
-    success: true,
-    outputPath,
-    requirementsCount: openspecData.requirements.length,
-    tasksCount: openspecData.requirements.length * 2 // TEST + IMPL
-  };
-}
-
-// CLI 接口
-if (require.main === module) {
-  const args = process.argv.slice(2);
-
-  if (args.length < 4) {
-    console.error('Usage: import-openspec.js <openspec-path> <req-id> <title> <output-path>');
-    process.exit(1);
-  }
-
-  const [openspecPath, reqId, title, outputPath] = args;
-
-  try {
-    const result = importOpenSpec(openspecPath, reqId, title, outputPath);
-    console.log(JSON.stringify(result, null, 2));
-  } catch (error) {
-    console.error('Error:', error.message);
-    process.exit(1);
-  }
-}
-
-module.exports = { importOpenSpec, parseOpenSpecMarkdown, convertToDevFlowSpec };

package/.claude/scripts/locate-requirement-in-roadmap.sh

@@ -1,233 +0,0 @@
-#!/usr/bin/env bash
-# Locate a requirement's position in the roadmap
-# Given a REQ-ID, finds its corresponding RM-ID, milestone, quarter, and cluster
-# Usage: ./locate-requirement-in-roadmap.sh [REQ-ID]
-#   If REQ-ID not provided, uses current requirement from branch/environment
-
-set -euo pipefail
-
-# =============================================================================
-# 获取当前脚本所在目录
-# =============================================================================
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# Source common functions
-if [[ -f "$SCRIPT_DIR/common.sh" ]]; then
-    source "$SCRIPT_DIR/common.sh"
-fi
-
-# =============================================================================
-# Roadmap Parsing Functions (路线图解析函数)
-# =============================================================================
-
-# Find RM-ID for a given REQ-ID in ROADMAP.md
-# Args: $1 = ROADMAP.md path, $2 = REQ-ID
-# Returns: RM-ID or empty string
-find_rm_id() {
-    local roadmap_file="$1"
-    local req_id="$2"
-
-    if [[ ! -f "$roadmap_file" ]]; then
-        return 1
-    fi
-
-    # Search Implementation Tracking table for REQ-ID
-    # Format: | RM-XXX | Feature | Derived From | Status | REQ-XXX | Progress |
-    local rm_id=$(grep -E "\\| (RM-[0-9]+) \\|.*\\| $req_id \\|" "$roadmap_file" | \
-                  grep -o "RM-[0-9]*" | head -1)
-
-    echo "$rm_id"
-}
-
-# Find feature name for RM-ID
-# Args: $1 = ROADMAP.md path, $2 = RM-ID
-# Returns: Feature name
-find_feature_name() {
-    local roadmap_file="$1"
-    local rm_id="$2"
-
-    if [[ ! -f "$roadmap_file" ]]; then
-        return 1
-    fi
-
-    # Search Implementation Tracking table
-    # Format: | RM-XXX | Feature | ... |
-    local feature=$(grep -E "\\| $rm_id \\|" "$roadmap_file" | \
-                    sed -E 's/.*\| [^|]+ \| ([^|]+) \|.*/\1/' | \
-                    sed 's/^[[:space:]]*//;s/[[:space:]]*$//' | \
-                    head -1)
-
-    echo "$feature"
-}
-
-# Find milestone and quarter for RM-ID
-# Args: $1 = ROADMAP.md path, $2 = RM-ID
-# Returns: Milestone|Quarter|Cluster format
-find_milestone_info() {
-    local roadmap_file="$1"
-    local rm_id="$2"
-
-    if [[ ! -f "$roadmap_file" ]]; then
-        return 1
-    fi
-
-    # Search for RM-ID in quarterly sections
-    # Pattern: **RM-XXX**: Title (Source)
-    # First find which section it's in by looking backwards for headers
-
-    local line_number=$(grep -n "\\*\\*$rm_id\\*\\*:" "$roadmap_file" | cut -d: -f1 | head -1)
-
-    if [[ -z "$line_number" ]]; then
-        echo "Unknown|Unknown|Unknown"
-        return
-    fi
-
-    # Get all lines from start to this line
-    local context=$(head -n "$line_number" "$roadmap_file")
-
-    # Find last Quarter section header (e.g., "## Q4 2025 Milestones")
-    local quarter=$(echo "$context" | grep -E "^## Q[0-9]+ [0-9]+ Milestones" | tail -1 | \
-                   sed -E 's/^## (Q[0-9]+ [0-9]+) Milestones/\1/')
-
-    # Find last Milestone header (e.g., "### M1-Q4-2025: Milestone Name")
-    local milestone=$(echo "$context" | grep -E "^### (M[0-9]+-Q[0-9]+-[0-9]+):" | tail -1 | \
-                     sed -E 's/^### ([^:]+):.*/\1/')
-
-    # Find last Feature Cluster header (e.g., "**Feature Cluster 1: Cluster Name**")
-    local cluster=$(echo "$context" | grep -E "^\*\*Feature Cluster [0-9]+: " | tail -1 | \
-                   sed -E 's/^\*\*Feature Cluster [0-9]+: ([^*]+)\*\*/\1/')
-
-    echo "${milestone:-Unknown}|${quarter:-Unknown}|${cluster:-Unknown}"
-}
-
-# Get derived_from for RM-ID
-# Args: $1 = ROADMAP.md path, $2 = RM-ID
-# Returns: Derived From value
-find_derived_from() {
-    local roadmap_file="$1"
-    local rm_id="$2"
-
-    if [[ ! -f "$roadmap_file" ]]; then
-        return 1
-    fi
-
-    # Search Implementation Tracking table
-    # Format: | RM-XXX | Feature | Derived From | ... |
-    local derived=$(grep -E "\\| $rm_id \\|" "$roadmap_file" | \
-                   awk -F'|' '{print $4}' | \
-                   sed 's/^[[:space:]]*//;s/[[:space:]]*$//' | \
-                   head -1)
-
-    echo "$derived"
-}
-
-# =============================================================================
-# Display Functions (显示函数)
-# =============================================================================
-
-# Display requirement location information
-# Args: $1 = REQ-ID, $2 = RM-ID, $3 = Feature, $4 = Milestone, $5 = Quarter, $6 = Cluster, $7 = Derived
-display_location() {
-    local req_id="$1"
-    local rm_id="$2"
-    local feature="$3"
-    local milestone="$4"
-    local quarter="$5"
-    local cluster="$6"
-    local derived="$7"
-
-    echo "==================================================================="
-    echo "Requirement Location in Roadmap"
-    echo "==================================================================="
-    echo ""
-    echo "📋 Requirement:    $req_id"
-    echo "🎯 Roadmap Item:   $rm_id"
-    echo "📝 Feature:        $feature"
-    echo "📌 Derived From:   $derived"
-    echo ""
-    echo "📅 Timeline:"
-    echo "   Quarter:        $quarter"
-    echo "   Milestone:      $milestone"
-    echo "   Cluster:        $cluster"
-    echo ""
-    echo "==================================================================="
-}
-
-# =============================================================================
-# Main Function (主函数)
-# =============================================================================
-
-main() {
-    local req_id="${1:-}"
-
-    # If no REQ-ID provided, try to get from current context
-    if [[ -z "$req_id" ]]; then
-        req_id=$(get_current_req_id)
-        if [[ -z "$req_id" ]]; then
-            echo "ERROR: No REQ-ID provided and cannot determine current requirement" >&2
-            echo "Usage: $0 [REQ-ID]" >&2
-            exit 1
-        fi
-        echo "Using current requirement: $req_id"
-        echo ""
-    fi
-
-    # Validate REQ-ID format
-    if ! validate_req_id "$req_id"; then
-        exit 1
-    fi
-
-    # Get repo root and roadmap path
-    local repo_root=$(get_repo_root)
-    local roadmap_file="$repo_root/devflow/ROADMAP.md"
-
-    # Check if ROADMAP.md exists
-    if [[ ! -f "$roadmap_file" ]]; then
-        echo "⚠️  ROADMAP.md not found at: $roadmap_file" >&2
-        echo "" >&2
-        echo "Please run /core-roadmap to create a roadmap first." >&2
-        exit 1
-    fi
-
-    # Find RM-ID for this REQ-ID
-    local rm_id=$(find_rm_id "$roadmap_file" "$req_id")
-
-    if [[ -z "$rm_id" ]]; then
-        echo "⚠️  Requirement $req_id not found in roadmap" >&2
-        echo "" >&2
-        echo "This requirement may be:" >&2
-        echo "  - Not yet added to the roadmap" >&2
-        echo "  - An ad-hoc requirement outside the roadmap" >&2
-        echo "  - Created before the roadmap was established" >&2
-        echo "" >&2
-        echo "You can:" >&2
-        echo "  1. Run /core-roadmap to regenerate the roadmap" >&2
-        echo "  2. Manually add this requirement to ROADMAP.md" >&2
-        exit 1
-    fi
-
-    # Get feature name
-    local feature=$(find_feature_name "$roadmap_file" "$rm_id")
-
-    # Get milestone info
-    local milestone_info=$(find_milestone_info "$roadmap_file" "$rm_id")
-    local milestone=$(echo "$milestone_info" | cut -d'|' -f1)
-    local quarter=$(echo "$milestone_info" | cut -d'|' -f2)
-    local cluster=$(echo "$milestone_info" | cut -d'|' -f3)
-
-    # Get derived_from
-    local derived=$(find_derived_from "$roadmap_file" "$rm_id")
-
-    # Display results
-    display_location "$req_id" "$rm_id" "$feature" "$milestone" "$quarter" "$cluster" "$derived"
-
-    # Return success
-    exit 0
-}
-
-# =============================================================================
-# Script Entry Point (脚本入口)
-# =============================================================================
-
-# Run main function
-main "$@"