cc-devflow 4.2.0 → 4.4.1

package/.claude/tests/test_analyze_upgrade_impact.py

@@ -1,34 +0,0 @@
-from __future__ import annotations
-
-import subprocess
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[1]
-SCRIPT = ROOT / "scripts/analyze-upgrade-impact.sh"
-
-
-def run_script(req_dir: Path, args: str = "") -> subprocess.CompletedProcess[str]:
-    command = [str(SCRIPT), "--req", str(req_dir)]
-    if args:
-        command.extend(args.split())
-    return subprocess.run(
-        command,
-        text=True,
-        capture_output=True,
-        check=False,
-        cwd=ROOT,
-    )
-
-
-def test_analyze_upgrade_creates_reports(tmp_path: Path) -> None:
-    req_dir = tmp_path / "REQ-999"
-    req_dir.mkdir(parents=True, exist_ok=True)
-    (req_dir / "PRD.md").write_text("# PRD\n\n## User Story\n- Do something\n", encoding="utf-8")
-
-    result = run_script(req_dir)
-    assert result.returncode == 0, result.stderr
-
-    analysis_dir = req_dir / "analysis"
-    reports = list(analysis_dir.glob("*.md"))
-    assert reports, "Expected analysis reports to be generated"

package/.claude/tests/test_consolidate_research.py

@@ -1,48 +0,0 @@
-from __future__ import annotations
-
-import json
-import subprocess
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[1]
-SCRIPT = ROOT / "scripts/consolidate-research.sh"
-
-
-def run_script(req_dir: Path) -> subprocess.CompletedProcess[str]:
-    return subprocess.run(
-        [str(SCRIPT), str(req_dir)],
-        text=True,
-        capture_output=True,
-        check=False,
-        cwd=ROOT,
-    )
-
-
-def test_consolidate_research(tmp_path: Path) -> None:
-    req_dir = tmp_path / "devflow" / "requirements" / "REQ-789"
-    req_dir.mkdir(parents=True)
-    research_dir = req_dir / "research"
-    research_dir.mkdir()
-
-    tasks = {
-        "tasks": [
-            {
-                "id": "R001",
-                "prompt": "Research caching options for service X",
-                "decision": "Use Redis",
-                "rationale": "Low latency, fits workload",
-                "alternatives": "Memcached, In-memory",
-            }
-        ]
-    }
-    (research_dir / "tasks.json").write_text(json.dumps(tasks), encoding="utf-8")
-    (research_dir / "sample.md").write_text("External findings", encoding="utf-8")
-
-    result = run_script(req_dir)
-    assert result.returncode == 0, result.stderr
-
-    summary = (research_dir / "research.md").read_text(encoding="utf-8")
-    assert "Research Summary" in summary
-    assert "Use Redis" in summary
-    assert "sample.md" in summary

package/.claude/tests/test_export_contracts.py

@@ -1,43 +0,0 @@
-from __future__ import annotations
-
-import subprocess
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[1]
-SCRIPT = ROOT / "scripts/export-contracts.sh"
-
-
-def run_script(req_dir: Path) -> subprocess.CompletedProcess[str]:
-    return subprocess.run(
-        [str(SCRIPT), str(req_dir)],
-        text=True,
-        capture_output=True,
-        check=False,
-        cwd=ROOT,
-    )
-
-
-def test_export_contracts_from_code_block(tmp_path: Path) -> None:
-    req_dir = tmp_path / "devflow" / "requirements" / "REQ-654"
-    req_dir.mkdir(parents=True)
-    (req_dir / "TECH_DESIGN.md").write_text(
-        "# Technical Design\n\n## 4. API Design\n\n```yaml\nopenapi: 3.0.3\ninfo: {title: API, version: 1.0.0}\n```\n",
-        encoding="utf-8",
-    )
-
-    result = run_script(req_dir)
-    assert result.returncode == 0, result.stderr
-    openapi = (req_dir / "contracts" / "openapi.yaml").read_text(encoding="utf-8")
-    assert "openapi: 3.0.3" in openapi
-
-
-def test_export_contracts_placeholder(tmp_path: Path) -> None:
-    req_dir = tmp_path / "devflow" / "requirements" / "REQ-655"
-    req_dir.mkdir(parents=True)
-    (req_dir / "TECH_DESIGN.md").write_text("# Technical Design\n", encoding="utf-8")
-
-    result = run_script(req_dir)
-    assert result.returncode == 0, result.stderr
-    openapi = (req_dir / "contracts" / "openapi.yaml").read_text(encoding="utf-8")
-    assert "openapi: 3.0.3" in openapi

package/.claude/tests/test_extract_data_model.py

@@ -1,33 +0,0 @@
-from __future__ import annotations
-
-import subprocess
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[1]
-SCRIPT = ROOT / "scripts/extract-data-model.sh"
-
-
-def run_script(req_dir: Path) -> subprocess.CompletedProcess[str]:
-    return subprocess.run(
-        [str(SCRIPT), str(req_dir)],
-        text=True,
-        capture_output=True,
-        check=False,
-        cwd=ROOT,
-    )
-
-
-def test_extract_data_model(tmp_path: Path) -> None:
-    req_dir = tmp_path / "devflow" / "requirements" / "REQ-321"
-    req_dir.mkdir(parents=True)
-    (req_dir / "TECH_DESIGN.md").write_text(
-        "# Technical Design\n\n## 3. Data Model\n\n- User(id, email)\n\n## 4. API Design\n",
-        encoding="utf-8",
-    )
-
-    result = run_script(req_dir)
-    assert result.returncode == 0, result.stderr
-
-    data_model = (req_dir / "data-model.md").read_text(encoding="utf-8")
-    assert "User(id, email)" in data_model

package/.claude/tests/test_generate_quickstart.py

@@ -1,50 +0,0 @@
-from __future__ import annotations
-
-import json
-import subprocess
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[1]
-SCRIPT = ROOT / "scripts/generate-quickstart.sh"
-
-
-def run_script(req_dir: Path) -> subprocess.CompletedProcess[str]:
-    return subprocess.run(
-        ["bash", "-lc", f"{SCRIPT} '{req_dir}'"],
-        text=True,
-        capture_output=True,
-        check=False,
-        cwd=Path.cwd(),
-    )
-
-
-def test_generate_quickstart(tmp_path: Path) -> None:
-    req_dir = tmp_path / "devflow" / "requirements" / "REQ-777"
-    req_dir.mkdir(parents=True)
-
-    (req_dir / "TECH_DESIGN.md").write_text(
-        "# Technical Design\n\n## 2. Technology Stack\n- Backend: FastAPI\n\n## 5. Security Design\n- JWT tokens\n\n## 6. Performance Design\n- Cache miss < 100ms\n",
-        encoding="utf-8",
-    )
-
-    package_json = {
-        "scripts": {
-            "dev": "pytest --maxfail=1",
-            "test": "pytest",
-        }
-    }
-    (req_dir / "package.json").write_text(json.dumps(package_json), encoding="utf-8")
-
-    result = subprocess.run(
-        [str(SCRIPT), str(req_dir)],
-        cwd=tmp_path,
-        text=True,
-        capture_output=True,
-        check=False,
-    )
-    assert result.returncode == 0, result.stderr
-
-    quickstart = (req_dir / "quickstart.md").read_text(encoding="utf-8")
-    assert "npm run test" in quickstart
-    assert "JWT tokens" in quickstart

package/.claude/tests/test_generate_research_tasks.py

@@ -1,52 +0,0 @@
-from __future__ import annotations
-
-import json
-import subprocess
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[1]
-SCRIPT = ROOT / "scripts/generate-research-tasks.sh"
-
-
-def run_script(req_dir: Path) -> subprocess.CompletedProcess[str]:
-    return subprocess.run(
-        [str(SCRIPT), str(req_dir)],
-        text=True,
-        capture_output=True,
-        check=False,
-        cwd=ROOT,
-    )
-
-
-def test_generate_research_tasks(tmp_path: Path) -> None:
-    req_dir = tmp_path / "REQ-123"
-    req_dir.mkdir()
-    (req_dir / "README.md").write_text("# REQ-123 Sample Feature\n", encoding="utf-8")
-    (req_dir / "plan.md").write_text(
-        "- **Backend**: FastAPI 0.110\n- **Database**: PostgreSQL 15.4\n",
-        encoding="utf-8",
-    )
-    (req_dir / "notes.md").write_text(
-        "Authentication flow NEEDS CLARIFICATION about refresh tokens.\n", encoding="utf-8"
-    )
-
-    result = run_script(req_dir)
-    assert result.returncode == 0, result.stderr
-
-    tasks_file = req_dir / "research" / "tasks.json"
-    assert tasks_file.exists()
-    data = json.loads(tasks_file.read_text(encoding="utf-8"))
-    prompts = [task["prompt"] for task in data["tasks"]]
-    assert any("Authentication flow" in prompt for prompt in prompts)
-    assert any("FastAPI" in prompt for prompt in prompts)
-
-
-def test_generate_research_tasks_handles_no_matches(tmp_path: Path) -> None:
-    req_dir = tmp_path / "REQ-456"
-    req_dir.mkdir()
-
-    result = run_script(req_dir)
-    assert result.returncode == 0, result.stderr
-    data = json.loads((req_dir / "research" / "tasks.json").read_text(encoding="utf-8"))
-    assert data["tasks"] == []

package/bin/harness.js

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * [INPUT]: 依赖 lib/harness/cli 的 runCli 函数与 shell argv。
- * [OUTPUT]: 将 harness 子命令分发到内核，并用 exit code 返回执行结果。
- * [POS]: Harness 命令行入口，被 npm scripts(harness:*) 调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const { runCli } = require('../lib/harness/cli');
-
-async function main() {
-  try {
-    const code = await runCli(process.argv.slice(2));
-    process.exit(code);
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-}
-
-main();

package/docs/commands/core-roadmap.md

@@ -1,106 +0,0 @@
-# `/core-roadmap` - Generate Product Roadmap
-
-[中文文档](./core-roadmap.zh-CN.md) | [English](./core-roadmap.md)
-
----
-
-## 📋 Overview
-
-Generate comprehensive product roadmap and requirement priority planning through 6-stage interactive dialogue.
-
-## 🎯 Syntax
-
-```bash
-/core-roadmap
-```
-
-## 🎬 Use Cases
-
-### ✅ Recommended Scenarios
-- Early project product direction planning
-- Reorganize requirement priorities
-- Present product plan to team
-
-### ❌ Not Recommended Scenarios
-- Single requirement development → Use `/flow:init` (then `/flow:spec` → `/flow:dev` → `/flow:verify` → `/flow:release`)
-
-## 🔄 Execution Flow (6-Stage Interactive Dialogue)
-
-```text
-Stage 1: Product Vision & Goals
-  ├─ Product positioning
-  ├─ Core value proposition
-  └─ Long-term objectives
-
-Stage 2: Target Users & Pain Points
-  ├─ User personas
-  ├─ Core pain points
-  └─ Use scenarios
-
-Stage 3: Core Feature Planning
-  ├─ Feature list
-  ├─ Priority ranking
-  └─ Feature dependencies
-
-Stage 4: Technical Architecture Design
-  ├─ Tech stack selection
-  ├─ System architecture
-  └─ Technical risk assessment
-
-Stage 5: Milestones & Timeline
-  ├─ Quarterly planning (Q1-Q4)
-  ├─ Milestone definitions (M1, M2, M3...)
-  └─ Requirement allocation to quarters
-
-Stage 6: Success Metrics Definition
-  ├─ KPI definition
-  ├─ Acceptance criteria
-  └─ Monitoring metrics
-```
-
-## 📂 Output Files
-
-- `devflow/ROADMAP.md` - Product Roadmap
-  - Product vision and goals
-  - Quarterly planning (Q1-Q4)
-  - Milestone definitions (M1-M8)
-  - Feature Roadmap table
-  - Implementation Tracking table
-
-- `devflow/BACKLOG.md` - Requirement Backlog
-  - Priority-sorted requirement list
-  - Detailed requirement descriptions
-  - Estimates and dependencies
-
-## 💡 Example Dialogue Snippet
-
-```
-Agent: 📋 Stage 1: Product Vision & Goals
-Please describe your product vision and core value proposition:
-
-User: Build an intelligent code review platform to help teams improve code quality
-      and reduce manual code review time costs.
-
-Agent: 🎯 Stage 2: Target Users & Pain Points
-Who are your target users? What are their core pain points?
-
-User: Target users are Tech Leads and senior engineers in development teams.
-      Pain points:
-      1. Low manual code review efficiency
-      2. Inconsistent code quality standards
-      3. High cost of training new developers
-
-... (Continue Stage 3-6)
-```
-
-## 🔗 Related Commands
-
-- [`/core-architecture`](./core-architecture.md) - Generate architecture based on roadmap
-- [`/flow:init`](./flow-init.md) - Initialize requirement based on roadmap
-- `.claude/scripts/sync-roadmap-progress.sh` - Sync progress to roadmap
-
-## 📚 Deep Reading
-
-- [Roadmap System Guide](../guides/roadmap-guide.md)
-- [Priority Management](../guides/priority-management.md)
-- [ROADMAP_TEMPLATE](../../.claude/docs/templates/ROADMAP_TEMPLATE.md)

package/docs/commands/core-roadmap.zh-CN.md

@@ -1,102 +0,0 @@
-# `/core-roadmap` - 生成产品路线图
-
-## 📋 概述
-
-通过 6 阶段交互式对话生成完整的产品路线图和需求优先级规划。
-
-## 🎯 语法
-
-```bash
-/core-roadmap
-```
-
-## 🎬 使用场景
-
-### ✅ 推荐场景
-- 项目初期规划产品方向
-- 重新梳理需求优先级
-- 向团队展示产品规划
-
-### ❌ 不推荐场景
-- 单个需求开发 → 使用 `/flow:init`（随后 `/flow:spec` → `/flow:dev` → `/flow:verify` → `/flow:release`）
-
-## 🔄 执行流程（6阶段交互式对话）
-
-```text
-Stage 1: 产品愿景与目标
-  ├─ 产品定位
-  ├─ 核心价值主张
-  └─ 长期目标
-
-Stage 2: 目标用户与痛点
-  ├─ 用户画像
-  ├─ 核心痛点
-  └─ 使用场景
-
-Stage 3: 核心功能规划
-  ├─ 功能列表
-  ├─ 优先级排序
-  └─ 功能依赖关系
-
-Stage 4: 技术架构设计
-  ├─ 技术栈选择
-  ├─ 系统架构
-  └─ 技术风险评估
-
-Stage 5: 里程碑与时间线
-  ├─ 季度规划 (Q1-Q4)
-  ├─ 里程碑定义 (M1, M2, M3...)
-  └─ 需求分配到季度
-
-Stage 6: 成功指标定义
-  ├─ KPI 定义
-  ├─ 验收标准
-  └─ 监控指标
-```
-
-## 📂 输出文件
-
-- `devflow/ROADMAP.md` - 产品路线图
-  - 产品愿景和目标
-  - 季度规划 (Q1-Q4)
-  - 里程碑定义 (M1-M8)
-  - Feature Roadmap 表格
-  - Implementation Tracking 表格
-
-- `devflow/BACKLOG.md` - 需求待办列表
-  - 按优先级排序的需求列表
-  - 需求详细描述
-  - 估算和依赖关系
-
-## 💡 示例对话片段
-
-```
-Agent: 📋 Stage 1: 产品愿景与目标
-请描述您的产品愿景和核心价值主张：
-
-User: 构建一个智能代码审查平台，帮助团队提升代码质量，
-      减少人工 Code Review 的时间成本。
-
-Agent: 🎯 Stage 2: 目标用户与痛点
-谁是您的目标用户？他们的核心痛点是什么？
-
-User: 目标用户是开发团队的 Tech Lead 和高级工程师。
-      痛点：
-      1. 人工 Code Review 效率低
-      2. 代码质量标准不统一
-      3. 新人培养成本高
-
-... (继续 Stage 3-6)
-```
-
-## 🔗 相关命令
-
-- [`/core-architecture`](./core-architecture.md) - 基于路线图生成架构
-- [`/flow:init`](./flow-init.md) - 基于路线图初始化需求
-- `.claude/scripts/sync-roadmap-progress.sh` - 同步进度到路线图
-
-## 📚 深度阅读
-
-- [路线图系统详解](../guides/roadmap-guide.md)
-- [需求优先级管理](../guides/priority-management.md)
-- [ROADMAP_TEMPLATE](../../docs/templates/ROADMAP_TEMPLATE.md)

package/docs/commands/core-style.md

@@ -1,53 +0,0 @@
-# `/core-style` - Generate Project Design Style Guide
-
-[中文文档](./core-style.zh-CN.md) | [English](./core-style.md)
-
-Generate or update `devflow/STYLE.md` as project-level design SSOT.
-
-## Syntax
-
-```bash
-/core-style
-/core-style --update
-```
-
-## Positioning
-
-`/core-style` is a project command (same level as `/core-roadmap`) and feeds the delivery mainline:
-
-- `/flow:spec`: reads STYLE guidance for UI/UX acceptance criteria.
-- `/flow:dev`: enforces STYLE tokens and component conventions in implementation.
-- `/flow:verify`: checks style consistency as part of quality gates.
-
-## Execution Flow
-
-1. Detect mode (`create` or `update`).
-2. Collect style inputs:
-- new project: use reference design URL/screenshot/HTML+CSS.
-- existing project: mine tokens/components from current code.
-3. Produce `devflow/research/style_analysis.md`.
-4. Generate `devflow/STYLE.md` from `STYLE_TEMPLATE.md`.
-5. Validate structure + constitution constraints.
-
-## Outputs
-
-```text
-devflow/STYLE.md
-devflow/research/style_analysis.md
-devflow/project_status.json (updated)
-EXECUTION_LOG.md (updated)
-```
-
-## Minimal Post-Style Workflow
-
-```bash
-/flow:init "REQ-123|Feature"
-/flow:spec "REQ-123"
-/flow:dev "REQ-123"
-/flow:verify "REQ-123" --strict
-```
-
-## Notes
-
-- STYLE is a living SSOT; prefer `--update` instead of ad-hoc per-task overrides.
-- Keep style decisions semantic (tokens/components), not page-specific patches.

package/docs/commands/core-style.zh-CN.md

@@ -1,53 +0,0 @@
-# `/core-style` - 生成项目设计风格指南
-
-[English](./core-style.md) | [中文文档](./core-style.zh-CN.md)
-
-生成或更新 `devflow/STYLE.md`，作为项目级设计 SSOT（单一真理源）。
-
-## 语法
-
-```bash
-/core-style
-/core-style --update
-```
-
-## 定位
-
-`/core-style` 是项目级命令（与 `/core-roadmap` 同级），并服务于主链交付：
-
-- `/flow:spec`：读取 STYLE 约束，形成可执行的 UI/UX 验收标准。
-- `/flow:dev`：实现阶段强制遵循 STYLE 的 token 与组件规范。
-- `/flow:verify`：在质量闸中检查样式一致性。
-
-## 执行流程
-
-1. 识别模式（新建或更新）。
-2. 收集风格输入：
-- 新项目：参考 URL / 截图 / HTML+CSS。
-- 现有项目：从代码中提取设计 token 与组件模式。
-3. 生成 `devflow/research/style_analysis.md`。
-4. 基于 `STYLE_TEMPLATE.md` 生成 `devflow/STYLE.md`。
-5. 执行结构与宪法约束校验。
-
-## 输出
-
-```text
-devflow/STYLE.md
-devflow/research/style_analysis.md
-devflow/project_status.json（更新）
-EXECUTION_LOG.md（更新）
-```
-
-## STYLE 后的最小交付链
-
-```bash
-/flow:init "REQ-123|功能"
-/flow:spec "REQ-123"
-/flow:dev "REQ-123"
-/flow:verify "REQ-123" --strict
-```
-
-## 说明
-
-- STYLE 是持续演进的 SSOT，优先使用 `--update`，避免临时散点改样式。
-- 风格约束应保持语义化（token/组件级），不要退化成页面级补丁。