cc-devflow 4.3.0 → 4.5.0

package/.claude/scripts/CLAUDE.md

@@ -1,76 +0,0 @@
-# scripts/
-> L2 | 父级: .claude/CLAUDE.md
->
-> [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-## 目录定位
-
-`.claude/scripts/` 是命令层与 Skill 层共享的执行脚本库，负责状态检测、质量门禁、需求目录操作与会话恢复。
-
-## 成员清单
-
-analyze-upgrade-impact.sh: 升级影响分析脚本。
-archive-requirement.sh: 需求归档与清理脚本。
-calculate-checklist-completion.sh: Checklist 完成度统计脚本。
-calculate-quarter.sh: 时间季度计算脚本。
-check-dependencies.sh: 依赖关系检查脚本。
-check-prerequisites.sh: 流程前置条件统一校验脚本。
-check-task-status.sh: TASKS 完成状态统计脚本。
-checklist-errors.sh: Checklist 错误码与诊断脚本。
-common.sh: 脚本公共函数库（REQ 识别、日志工具等）。
-consolidate-research.sh: research 结果汇总脚本。
-create-requirement.sh: 创建需求目录与初始状态；同步 workspace 的 `.current-req`。
-delta-parser.ts: Delta 解析器。
-detect-file-conflicts.sh: 并行开发文件冲突检测脚本。
-export-contracts.sh: 合同文档导出脚本。
-extract-data-model.sh: 数据模型抽取脚本。
-flow-context-add.sh: context JSONL 条目追加脚本。
-flow-context-init.sh: context 目录初始化脚本。
-flow-context-validate.sh: context 路径验证脚本。
-flow-delta-apply.sh: Delta 应用脚本。
-flow-delta-archive.sh: Delta 归档脚本。
-flow-delta-create.sh: Delta 创建脚本。
-flow-delta-list.sh: Delta 列表脚本。
-flow-delta-status.sh: Delta 状态脚本。
-flow-quality-full.sh: 全量质量检查脚本。
-flow-quality-quick.sh: 快速质量检查脚本。
-flow-workspace-init.sh: 开发者 workspace 初始化脚本。
-flow-workspace-record.sh: workspace journal 追加记录脚本。
-generate-clarification-questions.sh: Clarify 问题生成脚本。
-generate-clarification-report.sh: Clarify 报告生成脚本。
-generate-quickstart.sh: quickstart 文档生成脚本。
-generate-research-tasks.sh: research 任务生成脚本。
-generate-status-report.sh: 状态报告聚合脚本。
-generate-tech-analysis.sh: 技术分析生成脚本。
-get-workflow-status.sh: 工作流状态读取脚本。
-locate-requirement-in-roadmap.sh: roadmap 需求定位脚本。
-manage-constitution.sh: Constitution 管理脚本。
-mark-task-complete.sh: 任务完成标记脚本。
-parse-task-dependencies.js: 任务依赖解析器。
-populate-research-tasks.sh: research 任务填充脚本。
-record-quality-error.sh: 质量错误记录脚本。
-recover-workflow.sh: 中断恢复脚本。
-run-clarify-scan.sh: Clarify 扫描执行脚本。
-run-high-review.sh: 高强度 review 执行脚本。
-run-problem-analysis.sh: 问题分析执行脚本。
-run-quality-gates.sh: 质量门禁执行脚本。
-setup-epic.sh: Epic 初始化脚本。
-setup-ralph-loop.sh: Ralph Loop 初始化脚本。
-sync-roadmap-progress.sh: roadmap 进度同步脚本。
-sync-task-marks.sh: TASKS 勾选同步脚本。
-team-dev-init.sh: Team 开发并行初始化脚本。
-team-state-recovery.sh: Team 状态恢复脚本。
-test-clarify-scan.sh: Clarify 扫描测试脚本。
-update-agent-context.sh: Agent 上下文更新脚本。
-validate-constitution.sh: Constitution 校验脚本。
-validate-hooks.sh: Hooks 校验脚本。
-validate-research.sh: research 质量校验脚本。
-validate-scope-boundary.sh: scope 边界校验脚本。
-verify-gate.sh: Gate 校验脚本。
-verify-setup.sh: 环境/安装验证脚本。
-workflow-status.ts: 工作流状态类型化读取器。
-
-## 设计约束
-
-- 需求识别统一复用 `common.sh`，避免多处正则分叉。
-- 新增脚本优先保持幂等与可重入，便于中断恢复。

package/.claude/scripts/__tests__/openspec.test.js

@@ -1,212 +0,0 @@
-/**
- * OpenSpec 互操作测试
- */
-
-const { parseOpenSpecMarkdown, convertToDevFlowSpec } = require('../import-openspec');
-const { parseDevFlowSpec, convertToOpenSpec } = require('../export-openspec');
-
-describe('OpenSpec Import', () => {
-  test('should parse OpenSpec format correctly', () => {
-    const openspecContent = `# Authentication Module
-
-## Purpose
-Provides secure authentication and session management.
-
-## Requirements
-
-### Requirement: User Login
-The system SHALL allow users to log in with email and password.
-
-#### Scenario: Valid credentials
-- GIVEN a registered user
-- WHEN the user submits valid email and password
-- THEN a JWT token is issued
-- AND the user is redirected to dashboard
-
-#### Scenario: Invalid credentials
-- GIVEN a registered user
-- WHEN the user submits invalid password
-- THEN an error message is displayed
-- AND no token is issued
-
-### Requirement: Session Management
-The system MUST expire sessions after 30 minutes of inactivity.
-
-#### Scenario: Idle timeout
-- GIVEN an authenticated session
-- WHEN 30 minutes pass without activity
-- THEN the session is invalidated
-- AND the user must re-authenticate
-`;
-
-    const result = parseOpenSpecMarkdown(openspecContent);
-
-    expect(result.moduleName).toBe('Authentication Module');
-    expect(result.purpose).toContain('secure authentication');
-    expect(result.requirements).toHaveLength(2);
-    expect(result.requirements[0].name).toBe('User Login');
-    expect(result.requirements[0].scenarios).toHaveLength(2);
-    expect(result.requirements[0].scenarios[0].name).toBe('Valid credentials');
-    expect(result.requirements[0].scenarios[0].steps).toHaveLength(4);
-  });
-
-  test('should convert to DevFlow spec with TDD tasks', () => {
-    const openspecData = {
-      moduleName: 'Auth Module',
-      purpose: 'Authentication',
-      requirements: [
-        {
-          name: 'User Login',
-          description: 'Login functionality',
-          scenarios: [
-            {
-              name: 'Valid credentials',
-              steps: ['GIVEN a user', 'WHEN login', 'THEN success']
-            }
-          ]
-        },
-        {
-          name: 'Session Management',
-          description: 'Session handling',
-          scenarios: [
-            {
-              name: 'Timeout',
-              steps: ['GIVEN session', 'WHEN timeout', 'THEN invalidate']
-            }
-          ]
-        }
-      ]
-    };
-
-    const devflowSpec = convertToDevFlowSpec(openspecData, 'REQ-123', 'Auth System');
-
-    expect(devflowSpec).toContain('req_id: "REQ-123"');
-    expect(devflowSpec).toContain('title: "Auth System"');
-    expect(devflowSpec).toContain('## Purpose');
-    expect(devflowSpec).toContain('## Requirements');
-    expect(devflowSpec).toContain('## Design');
-    expect(devflowSpec).toContain('## Tasks');
-    expect(devflowSpec).toContain('[TEST] User Login - 测试');
-    expect(devflowSpec).toContain('[IMPL] User Login - 实现 (dependsOn:T001)');
-    expect(devflowSpec).toContain('[TEST] Session Management - 测试');
-    expect(devflowSpec).toContain('[IMPL] Session Management - 实现 (dependsOn:T003)');
-  });
-});
-
-describe('OpenSpec Export', () => {
-  test('should parse DevFlow spec correctly', () => {
-    const devflowContent = `---
-req_id: "REQ-123"
-title: "Auth System"
----
-
-# Authentication Module
-
-## Purpose
-
-Provides secure authentication.
-
-## Requirements
-
-### Requirement: User Login
-
-The system SHALL allow login.
-
-#### Scenario: Valid credentials
-- GIVEN a registered user
-- WHEN the user submits credentials
-- THEN a JWT token is issued
-
-### Requirement: Session Management
-
-The system MUST expire sessions.
-
-## Design
-
-[NEEDS CLARIFICATION: Implementation details]
-
-## Tasks
-
-- [ ] T001 [TEST] User Login - 测试
-- [ ] T002 [IMPL] User Login - 实现 (dependsOn:T001)
-`;
-
-    const result = parseDevFlowSpec(devflowContent);
-
-    expect(result.moduleName).toBe('Authentication Module');
-    expect(result.purpose).toContain('secure authentication');
-    expect(result.requirements).toHaveLength(2);
-    expect(result.requirements[0].name).toBe('User Login');
-    expect(result.requirements[0].scenarios).toHaveLength(1);
-  });
-
-  test('should convert to OpenSpec format without metadata', () => {
-    const devflowData = {
-      moduleName: 'Auth Module',
-      purpose: 'Authentication',
-      requirements: [
-        {
-          name: 'User Login',
-          description: 'Login functionality',
-          scenarios: [
-            {
-              name: 'Valid credentials',
-              steps: ['GIVEN a user', 'WHEN login', 'THEN success']
-            }
-          ]
-        }
-      ]
-    };
-
-    const openspecContent = convertToOpenSpec(devflowData);
-
-    expect(openspecContent).toContain('# Auth Module');
-    expect(openspecContent).toContain('## Purpose');
-    expect(openspecContent).toContain('## Requirements');
-    expect(openspecContent).toContain('### Requirement: User Login');
-    expect(openspecContent).toContain('#### Scenario: Valid credentials');
-    expect(openspecContent).not.toContain('req_id');
-    expect(openspecContent).not.toContain('---');
-    expect(openspecContent).not.toContain('[NEEDS CLARIFICATION');
-    expect(openspecContent).not.toContain('## Design');
-    expect(openspecContent).not.toContain('## Tasks');
-  });
-});
-
-describe('Round-trip conversion', () => {
-  test('should preserve requirements through import-export cycle', () => {
-    const originalOpenSpec = `# Test Module
-
-## Purpose
-Test purpose
-
-## Requirements
-
-### Requirement: Feature A
-Description A
-
-#### Scenario: Case 1
-- GIVEN condition
-- WHEN action
-- THEN result
-`;
-
-    // Import to DevFlow
-    const openspecData = parseOpenSpecMarkdown(originalOpenSpec);
-    const devflowSpec = convertToDevFlowSpec(openspecData, 'REQ-001', 'Test');
-
-    // Export back to OpenSpec
-    const devflowData = parseDevFlowSpec(devflowSpec);
-    const exportedOpenSpec = convertToOpenSpec(devflowData);
-
-    // Verify requirements preserved
-    expect(exportedOpenSpec).toContain('# Test Module');
-    expect(exportedOpenSpec).toContain('## Purpose');
-    expect(exportedOpenSpec).toContain('Test purpose');
-    expect(exportedOpenSpec).toContain('### Requirement: Feature A');
-    expect(exportedOpenSpec).toContain('#### Scenario: Case 1');
-    expect(exportedOpenSpec).toContain('- GIVEN condition');
-    expect(exportedOpenSpec).toContain('- WHEN action');
-    expect(exportedOpenSpec).toContain('- THEN result');
-  });
-});

package/.claude/scripts/analyze-upgrade-impact.sh

@@ -1,200 +0,0 @@
-#!/usr/bin/env bash
-# shellcheck disable=SC2312
-
-set -euo pipefail
-
-usage() {
-  cat <<'USAGE'
-Usage: scripts/bash/analyze-upgrade-impact.sh --req <requirement-dir|REQ-ID> [--compare version] [--format {text,json}]
-
-Produces PRD change detection and impact assessment reports under
-devflow/requirements/<REQ>/analysis/.
-USAGE
-}
-
-REQ=""
-COMPARE=""
-FORMAT="text"
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --req)
-      shift
-      REQ="${1:-}"
-      ;;
-    --compare)
-      shift
-      COMPARE="${1:-}"
-      ;;
-    --format)
-      shift
-      FORMAT="${1:-text}"
-      ;;
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    *)
-      echo "Unknown argument: $1" >&2
-      usage
-      exit 1
-      ;;
-  esac
-  shift
-done
-
-if [[ -z "$REQ" ]]; then
-  echo "Error: --req is required." >&2
-  usage
-  exit 1
-fi
-
-if [[ -d "$REQ" ]]; then
-  REQ_DIR="$(cd "$REQ" && pwd)"
-else
-  REQ_DIR="devflow/requirements/$REQ"
-fi
-
-if [[ ! -d "$REQ_DIR" ]]; then
-  echo "Error: requirement directory '$REQ_DIR' not found." >&2
-  exit 1
-fi
-
-python3 - "$REQ_DIR" "$COMPARE" "$FORMAT" <<'PY'
-from __future__ import annotations
-
-import json
-import re
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-from typing import Dict, Any
-
-req_dir = Path(sys.argv[1]).resolve()
-compare_version = sys.argv[2] or ""
-fmt = sys.argv[3]
-
-prd_current = req_dir / "PRD.md"
-if not prd_current.exists():
-    print(f"Error: {prd_current} not found.", file=sys.stderr)
-    sys.exit(1)
-
-versions_dir = req_dir / "versions"
-compare_path = None
-if compare_version:
-    compare_path = versions_dir / compare_version / "PRD.md"
-    if not compare_path.exists():
-        print(f"Warning: compare version {compare_version} not found; skipping diff.", file=sys.stderr)
-        compare_path = None
-
-current_lines = prd_current.read_text(encoding="utf-8").splitlines()
-previous_lines = compare_path.read_text(encoding="utf-8").splitlines() if compare_path else []
-
-analysis_dir = req_dir / "analysis"
-analysis_dir.mkdir(exist_ok=True, parents=True)
-timestamp = datetime.now(timezone.utc).strftime("%Y%m%d-%H%M%S")
-
-def diff_stats() -> Dict[str, Any]:
-    additions = sum(1 for line in current_lines if line.startswith("+") and "User Story" in line)
-    removals = sum(1 for line in previous_lines if line.startswith("+") and "User Story" in line)
-    breaking = 0
-    additive = 0
-    for line in current_lines:
-        if "[BREAKING]" in line or re.search(r"\bRemoved\b", line, re.IGNORECASE):
-            breaking += 1
-        if "User Story" in line or "API" in line:
-            additive += 1
-    return {
-        "userStoriesAdded": additions,
-        "userStoriesRemoved": removals,
-        "breakingMarkers": breaking,
-        "featureChanges": additive,
-    }
-
-stats = diff_stats()
-
-if stats["breakingMarkers"] > 0 or stats["userStoriesRemoved"] > 0:
-    recommendation = "MAJOR"
-elif stats["featureChanges"] > 1:
-    recommendation = "MINOR"
-else:
-    recommendation = "PATCH"
-
-change_report = analysis_dir / f"change_detection_{timestamp}.md"
-impact_report = analysis_dir / f"impact_assessment_{timestamp}.md"
-recommendation_report = analysis_dir / f"upgrade_recommendation_{timestamp}.md"
-
-change_report.write_text(
-    "\n".join(
-        [
-            f"# Change Detection — {req_dir.name}",
-            f"Generated: {datetime.now(timezone.utc).isoformat()}",
-            "",
-            f"- User stories added: {stats['userStoriesAdded']}",
-            f"- User stories removed: {stats['userStoriesRemoved']}",
-            f"- Breaking markers: {stats['breakingMarkers']}",
-            f"- Feature change mentions: {stats['featureChanges']}",
-        ]
-    )
-    + "\n",
-    encoding="utf-8",
-)
-
-impact_report.write_text(
-    "\n".join(
-        [
-            f"# Impact Assessment — {req_dir.name}",
-            "",
-            "## Code Areas Impacted",
-            "- TODO: map affected services/controllers.",
-            "",
-            "## Test Plan Impact",
-            "- TODO: identify regression suites requiring updates.",
-            "",
-            "## Deployment Considerations",
-            "- TODO: document rollout/rollback implications.",
-        ]
-    )
-    + "\n",
-    encoding="utf-8",
-)
-
-recommendation_report.write_text(
-    "\n".join(
-        [
-            f"# Upgrade Recommendation — {req_dir.name}",
-            "",
-            f"- Suggested version bump: **{recommendation}**",
-            "- Rationale:",
-            f"  * Breaking markers detected: {stats['breakingMarkers']}",
-            f"  * User stories added: {stats['userStoriesAdded']}",
-            f"  * User stories removed: {stats['userStoriesRemoved']}",
-        ]
-    )
-    + "\n",
-    encoding="utf-8",
-)
-
-summary = {
-    "requirement": req_dir.name,
-    "compareVersion": compare_version or None,
-    "recommendedBump": recommendation,
-    "statistics": stats,
-    "reports": {
-        "changeDetection": str(change_report.relative_to(req_dir)),
-        "impactAssessment": str(impact_report.relative_to(req_dir)),
-        "recommendation": str(recommendation_report.relative_to(req_dir)),
-    },
-}
-
-if fmt.lower() == "json":
-    print(json.dumps(summary, indent=2))
-else:
-    print(
-        f"Recommended bump: {recommendation}\n"
-        f"Reports:\n"
-        f"  - {summary['reports']['changeDetection']}\n"
-        f"  - {summary['reports']['impactAssessment']}\n"
-        f"  - {summary['reports']['recommendation']}"
-    )
-PY