cc-devflow 4.3.0 → 4.5.0

package/.claude/scripts/detect-file-conflicts.sh

@@ -1,151 +0,0 @@
-#!/usr/bin/env bash
-
-# =============================================================================
-# [INPUT]: 依赖 stdin 的 JSON 任务列表 (来自 parse-task-dependencies.ts)
-# [OUTPUT]: 对外提供文件冲突检测结果 JSON
-# [POS]: scripts/ 的并行任务冲突检测器，被 Team 调度系统消费
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-# =============================================================================
-#
-# Detect file conflicts in parallel task execution
-#
-# This script analyzes task file paths to detect potential conflicts
-# when multiple tasks modify the same file in parallel.
-#
-# Usage:
-#   echo '{"tasks": [...]}' | ./detect-file-conflicts.sh
-#   ./detect-file-conflicts.sh < tasks.json
-#
-# INPUT FORMAT:
-#   {
-#     "tasks": [
-#       {"id": "T001", "filePath": "src/user.ts", "parallel": true},
-#       {"id": "T002", "filePath": "src/user.ts", "parallel": true}
-#     ]
-#   }
-#
-# OUTPUT FORMAT:
-#   {
-#     "hasConflicts": true,
-#     "conflicts": [
-#       {
-#         "file": "src/user.ts",
-#         "tasks": ["T001", "T002"],
-#         "recommendation": "Run sequentially or assign to same agent"
-#       }
-#     ],
-#     "safeGroups": [
-#       {"tasks": ["T003", "T004"], "reason": "Different files"}
-#     ]
-#   }
-#
-# EXIT CODES:
-#   0 - Success (no conflicts or conflicts detected and reported)
-#   1 - Invalid input or processing error
-
-set -e
-
-# =============================================================================
-# Main Logic
-# =============================================================================
-
-main() {
-    local input
-    input=$(cat)
-
-    # Validate input is valid JSON
-    if ! echo "$input" | jq empty 2>/dev/null; then
-        echo '{"error": "Invalid JSON input", "hasConflicts": false, "conflicts": [], "safeGroups": []}' >&2
-        exit 1
-    fi
-
-    # Check if tasks array exists
-    local tasks_count
-    tasks_count=$(echo "$input" | jq '.tasks | length // 0')
-
-    if [[ "$tasks_count" -eq 0 ]]; then
-        echo '{"hasConflicts": false, "conflicts": [], "safeGroups": [], "message": "No tasks provided"}'
-        exit 0
-    fi
-
-    # Extract parallel tasks with file paths
-    # Build a map of file -> [task IDs]
-    local result
-    result=$(echo "$input" | jq '
-        # Filter to parallel tasks with file paths
-        .tasks
-        | map(select(.parallel == true and .filePath != null and .filePath != ""))
-
-        # Group by file path
-        | group_by(.filePath)
-
-        # Analyze each group
-        | map({
-            file: .[0].filePath,
-            tasks: [.[].id],
-            count: length
-        })
-
-        # Separate conflicts (count > 1) from safe groups
-        | {
-            conflicts: map(select(.count > 1) | {
-                file: .file,
-                tasks: .tasks,
-                recommendation: "Run sequentially or assign to same agent"
-            }),
-            safeFiles: map(select(.count == 1) | .tasks[0])
-        }
-
-        # Build final output
-        | {
-            hasConflicts: (.conflicts | length > 0),
-            conflicts: .conflicts,
-            safeGroups: (
-                if (.safeFiles | length > 0) then
-                    [{tasks: .safeFiles, reason: "Different files"}]
-                else
-                    []
-                end
-            )
-        }
-    ')
-
-    # Add additional analysis for directory-level conflicts
-    local dir_conflicts
-    dir_conflicts=$(echo "$input" | jq '
-        # Extract parallel tasks
-        .tasks
-        | map(select(.parallel == true and .filePath != null and .filePath != ""))
-
-        # Extract directory from file path
-        | map(. + {dir: (.filePath | split("/") | .[:-1] | join("/"))})
-
-        # Group by directory
-        | group_by(.dir)
-
-        # Find directories with multiple tasks
-        | map(select(length > 1))
-
-        # Format as warnings
-        | map({
-            directory: .[0].dir,
-            tasks: [.[].id],
-            files: [.[].filePath],
-            warning: "Multiple tasks in same directory - review for potential conflicts"
-        })
-    ')
-
-    # Merge directory warnings into result
-    local final_result
-    final_result=$(echo "$result" | jq --argjson dirWarnings "$dir_conflicts" '
-        . + {directoryWarnings: $dirWarnings}
-    ')
-
-    echo "$final_result"
-}
-
-# =============================================================================
-# Entry Point
-# =============================================================================
-
-main "$@"

package/.claude/scripts/export-contracts.sh

@@ -1,117 +0,0 @@
-#!/usr/bin/env bash
-# shellcheck disable=SC2312
-
-set -euo pipefail
-
-usage() {
-  cat <<'USAGE'
-Usage: scripts/bash/export-contracts.sh <requirement-dir>
-
-Extracts API contract definitions from TECH_DESIGN.md and writes them into
-contracts/openapi.yaml (or schema.graphql if GraphQL). Creates placeholders when
-structured data is unavailable.
-USAGE
-}
-
-if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
-  usage
-  exit 0
-fi
-
-if [[ $# -lt 1 ]]; then
-  echo "Error: requirement directory is required." >&2
-  usage
-  exit 1
-fi
-
-REQ_DIR="$1"
-if [[ ! -d "$REQ_DIR" ]]; then
-  echo "Error: requirement directory '$REQ_DIR' does not exist." >&2
-  exit 1
-fi
-
-python3 - "$REQ_DIR" <<'PY'
-from __future__ import annotations
-
-import re
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-
-req_dir = Path(sys.argv[1]).resolve()
-tech_design = req_dir / "TECH_DESIGN.md"
-contracts_dir = req_dir / "contracts"
-contracts_dir.mkdir(exist_ok=True, parents=True)
-openapi_path = contracts_dir / "openapi.yaml"
-graphql_path = contracts_dir / "schema.graphql"
-
-if not tech_design.exists():
-    print(f"Error: {tech_design} not found.", file=sys.stderr)
-    sys.exit(1)
-
-content = tech_design.read_text(encoding="utf-8")
-
-api_patterns = [
-    r"(^##\s+4\.\s*API.*?)(?=^##\s+\d+\.)",
-    r"(^##\s+API Design.*?)(?=^##\s+)",
-]
-
-api_section = None
-for pattern in api_patterns:
-    match = re.search(pattern, content, re.MULTILINE | re.DOTALL)
-    if match:
-        api_section = match.group(1).strip()
-        break
-
-generated_at = datetime.now(timezone.utc).isoformat()
-
-def extract_code_block(section: str, languages: tuple[str, ...]) -> str | None:
-    fence_regex = re.compile(
-        r"```(?P<lang>[^\n]*)\n(?P<body>.*?)```",
-        re.DOTALL | re.IGNORECASE,
-    )
-    for match in fence_regex.finditer(section):
-        lang = match.group("lang").strip().lower()
-        body = match.group("body")
-        if not languages or lang in languages:
-            return body.strip()
-    return None
-
-if api_section:
-    openapi_block = extract_code_block(api_section, ("yaml", "yml", "openapi", "json"))
-    graphql_block = extract_code_block(api_section, ("graphql",))
-else:
-    openapi_block = graphql_block = None
-
-if graphql_block:
-    graphql_path.write_text(graphql_block + "\n", encoding="utf-8")
-    print(f"Wrote GraphQL schema → {graphql_path}")
-    # If both exist, prefer OpenAPI as well; otherwise create stub below.
-
-if openapi_block:
-    if not openapi_block.lstrip().startswith("openapi:"):
-        openapi_block = f"# Generated {generated_at}\n{openapi_block}"
-    openapi_path.write_text(openapi_block + "\n", encoding="utf-8")
-    print(f"Wrote OpenAPI contract → {openapi_path}")
-else:
-    placeholder = f"""# openapi.yaml generated {generated_at}
-openapi: 3.0.3
-info:
-  title: {req_dir.name} API
-  version: 0.1.0
-paths:
-  /example:
-    get:
-      summary: TODO - replace with real endpoint
-      responses:
-        '200':
-          description: OK
-components:
-  schemas:
-    TODO:
-      type: object
-      description: Replace with actual schema
-"""
-    openapi_path.write_text(placeholder, encoding="utf-8")
-    print(f"Warning: No structured OpenAPI block found; wrote placeholder → {openapi_path}", file=sys.stderr)
-PY

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

@@ -1,222 +0,0 @@
-#!/usr/bin/env node
-/**
- * [INPUT]: 依赖 CC-DevFlow spec.md 文件路径
- * [OUTPUT]: 生成 OpenSpec 格式的 spec.md (纯 Requirements，无 CC-DevFlow 元数据)
- * [POS]: OpenSpec 互操作层，被 /flow:export-openspec 命令调用
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * 解析 CC-DevFlow spec.md 格式
- */
-function parseDevFlowSpec(content) {
-  const lines = content.split('\n');
-  const result = {
-    moduleName: '',
-    purpose: '',
-    requirements: []
-  };
-
-  let inFrontmatter = false;
-  let currentSection = null;
-  let currentRequirement = null;
-  let currentScenario = null;
-  let buffer = [];
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-
-    // 跳过 YAML frontmatter
-    if (line === '---') {
-      inFrontmatter = !inFrontmatter;
-      continue;
-    }
-    if (inFrontmatter) {
-      continue;
-    }
-
-    // # 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;
-    }
-
-    // ## Design (停止解析，OpenSpec 不需要)
-    if (line.startsWith('## Design') || line.startsWith('## Tasks') || line.startsWith('## Verification')) {
-      if (currentRequirement) {
-        result.requirements.push(currentRequirement);
-        currentRequirement = null;
-      }
-      break;
-    }
-
-    // ### 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
-    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() && !line.startsWith('[NEEDS CLARIFICATION')) {
-      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);
-    }
-    if (buffer.length > 0) {
-      currentRequirement.description = buffer.join('\n').trim();
-    }
-    result.requirements.push(currentRequirement);
-  }
-
-  return result;
-}
-
-/**
- * 转换为 OpenSpec 格式
- */
-function convertToOpenSpec(devflowData) {
-  let output = `# ${devflowData.moduleName}
-
-## Purpose
-
-${devflowData.purpose}
-
-## Requirements
-
-`;
-
-  // 转换 Requirements
-  for (const req of devflowData.requirements) {
-    output += `### Requirement: ${req.name}\n`;
-
-    if (req.description) {
-      output += `${req.description}\n\n`;
-    }
-
-    // 转换 Scenarios
-    for (const scenario of req.scenarios) {
-      output += `#### Scenario: ${scenario.name}\n`;
-      for (const step of scenario.steps) {
-        output += `- ${step}\n`;
-      }
-      output += '\n';
-    }
-  }
-
-  return output;
-}
-
-/**
- * 主函数
- */
-function exportOpenSpec(devflowSpecPath, outputPath) {
-  // 读取 CC-DevFlow spec.md
-  if (!fs.existsSync(devflowSpecPath)) {
-    throw new Error(`DevFlow spec.md not found: ${devflowSpecPath}`);
-  }
-
-  const content = fs.readFileSync(devflowSpecPath, 'utf-8');
-
-  // 解析 CC-DevFlow spec
-  const devflowData = parseDevFlowSpec(content);
-
-  // 转换为 OpenSpec 格式
-  const openspecContent = convertToOpenSpec(devflowData);
-
-  // 写入输出文件
-  const outputDir = path.dirname(outputPath);
-  if (!fs.existsSync(outputDir)) {
-    fs.mkdirSync(outputDir, { recursive: true });
-  }
-
-  fs.writeFileSync(outputPath, openspecContent, 'utf-8');
-
-  return {
-    success: true,
-    outputPath,
-    requirementsCount: devflowData.requirements.length
-  };
-}
-
-// CLI 接口
-if (require.main === module) {
-  const args = process.argv.slice(2);
-
-  if (args.length < 2) {
-    console.error('Usage: export-openspec.js <devflow-spec-path> <output-path>');
-    process.exit(1);
-  }
-
-  const [devflowSpecPath, outputPath] = args;
-
-  try {
-    const result = exportOpenSpec(devflowSpecPath, outputPath);
-    console.log(JSON.stringify(result, null, 2));
-  } catch (error) {
-    console.error('Error:', error.message);
-    process.exit(1);
-  }
-}
-
-module.exports = { exportOpenSpec, parseDevFlowSpec, convertToOpenSpec };

package/.claude/scripts/extract-data-model.sh

@@ -1,78 +0,0 @@
-#!/usr/bin/env bash
-# shellcheck disable=SC2312
-
-set -euo pipefail
-
-usage() {
-  cat <<'USAGE'
-Usage: scripts/bash/extract-data-model.sh <requirement-dir>
-
-Extracts the "Data Model" section from TECH_DESIGN.md into data-model.md.
-USAGE
-}
-
-if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
-  usage
-  exit 0
-fi
-
-if [[ $# -lt 1 ]]; then
-  echo "Error: requirement directory is required." >&2
-  usage
-  exit 1
-fi
-
-REQ_DIR="$1"
-if [[ ! -d "$REQ_DIR" ]]; then
-  echo "Error: requirement directory '$REQ_DIR' does not exist." >&2
-  exit 1
-fi
-
-python3 - "$REQ_DIR" <<'PY'
-from __future__ import annotations
-
-import re
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-
-req_dir = Path(sys.argv[1]).resolve()
-tech_design = req_dir / "TECH_DESIGN.md"
-output_path = req_dir / "data-model.md"
-
-if not tech_design.exists():
-    print(f"Error: {tech_design} not found.", file=sys.stderr)
-    sys.exit(1)
-
-content = tech_design.read_text(encoding="utf-8")
-
-section_regexes = [
-    r"(^##\s+3\.\s*Data Model.*?)(?=^##\s+\d+\.)",
-    r"(^##\s+Data Model.*?)(?=^##\s+)",
-]
-
-section = None
-for pattern in section_regexes:
-    match = re.search(pattern, content, re.MULTILINE | re.DOTALL)
-    if match:
-        section = match.group(1).strip()
-        break
-
-if section is None:
-    print("Warning: Data Model section not found; creating placeholder.", file=sys.stderr)
-    section = "## Data Model\n\n_TODO: populate data model details in TECH_DESIGN.md_"
-
-generated_at = datetime.now(timezone.utc).isoformat()
-
-lines = [
-    f"# Data Model — {req_dir.name}",
-    "",
-    f"_Generated from TECH_DESIGN.md on {generated_at}_",
-    "",
-    section,
-    "",
-]
-
-output_path.write_text("\n".join(lines), encoding="utf-8")
-print(f"Wrote data model extract → {output_path}")
-PY

package/.claude/scripts/flow-context-add.sh

@@ -1,134 +0,0 @@
-#!/bin/bash
-# [INPUT]: 依赖 context/*.jsonl 文件
-# [OUTPUT]: 追加条目到指定的 jsonl 文件
-# [POS]: scripts 的 context 添加脚本，被 /flow-context add 调用
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-# ============================================================================
-# Usage
-# ============================================================================
-
-usage() {
-    cat << EOF
-Usage: flow-context-add.sh <agent> <path> <purpose> [--optional] [--type <file|directory|spec>]
-
-Add an entry to a context JSONL file.
-
-Arguments:
-    agent       Agent type (research, prd, tech, epic, dev, review)
-    path        File or directory path
-    purpose     Human-readable purpose
-
-Options:
-    --optional  Mark entry as optional
-    --type      Entry type (default: file)
-    --depth     Directory depth (only for directory type, default: 1)
-
-Examples:
-    flow-context-add.sh dev "src/utils/auth.ts" "Authentication utilities"
-    flow-context-add.sh dev "contracts/" "API contracts" --type directory --depth 2
-    flow-context-add.sh dev "ERROR_LOG.md" "Previous errors" --optional
-EOF
-    exit 1
-}
-
-# ============================================================================
-# Parse Arguments
-# ============================================================================
-
-AGENT=""
-PATH_ARG=""
-PURPOSE=""
-OPTIONAL="false"
-ENTRY_TYPE="file"
-DEPTH=1
-
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --optional)
-            OPTIONAL="true"
-            shift
-            ;;
-        --type)
-            ENTRY_TYPE="$2"
-            shift 2
-            ;;
-        --depth)
-            DEPTH="$2"
-            shift 2
-            ;;
-        --help|-h)
-            usage
-            ;;
-        *)
-            if [[ -z "$AGENT" ]]; then
-                AGENT="$1"
-            elif [[ -z "$PATH_ARG" ]]; then
-                PATH_ARG="$1"
-            elif [[ -z "$PURPOSE" ]]; then
-                PURPOSE="$1"
-            fi
-            shift
-            ;;
-    esac
-done
-
-if [[ -z "$AGENT" || -z "$PATH_ARG" || -z "$PURPOSE" ]]; then
-    echo "Error: agent, path, and purpose are required"
-    usage
-fi
-
-# ============================================================================
-# Detect REQ-ID
-# ============================================================================
-
-# Try environment variable first
-REQ_ID="${DEVFLOW_REQ_ID:-}"
-
-# Try git branch
-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. Set DEVFLOW_REQ_ID or use a feature branch."
-    exit 1
-fi
-
-# ============================================================================
-# Main Logic
-# ============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-CONTEXT_FILE="$PROJECT_ROOT/devflow/requirements/$REQ_ID/context/${AGENT}.jsonl"
-
-if [[ ! -f "$CONTEXT_FILE" ]]; then
-    echo "Error: Context file not found: $CONTEXT_FILE"
-    echo "Run '/flow-context init $REQ_ID' first."
-    exit 1
-fi
-
-# Build JSON entry
-if [[ "$ENTRY_TYPE" == "directory" ]]; then
-    if [[ "$OPTIONAL" == "true" ]]; then
-        ENTRY="{\"type\": \"$ENTRY_TYPE\", \"path\": \"$PATH_ARG\", \"purpose\": \"$PURPOSE\", \"depth\": $DEPTH, \"optional\": true}"
-    else
-        ENTRY="{\"type\": \"$ENTRY_TYPE\", \"path\": \"$PATH_ARG\", \"purpose\": \"$PURPOSE\", \"depth\": $DEPTH}"
-    fi
-else
-    if [[ "$OPTIONAL" == "true" ]]; then
-        ENTRY="{\"type\": \"$ENTRY_TYPE\", \"path\": \"$PATH_ARG\", \"purpose\": \"$PURPOSE\", \"optional\": true}"
-    else
-        ENTRY="{\"type\": \"$ENTRY_TYPE\", \"path\": \"$PATH_ARG\", \"purpose\": \"$PURPOSE\"}"
-    fi
-fi
-
-# Append to file
-echo "$ENTRY" >> "$CONTEXT_FILE"
-
-echo "✅ Added entry to $CONTEXT_FILE:"
-echo "   $ENTRY"