cc-devflow 4.2.0 → 4.4.1

package/.claude/commands/flow/archive.md

@@ -1,280 +0,0 @@
----
-name: flow-archive
-description: 'Archive completed/deprecated requirements with Delta Specs support. Usage: /flow:archive "REQ-123" or /flow:archive --list'
-version: 4.5.0
-scripts:
-  archive: .claude/scripts/archive-requirement.sh
----
-
-# /flow:archive - 需求归档命令 (v4.5)
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID?" | "--list" | "--restore REQ_ID"
-```
-未提供 REQ_ID 时，根据当前分支或 `DEVFLOW_REQ_ID` 自动解析。
-
-## 命令格式
-```text
-/flow:archive "REQ-123"                      # 归档已完成需求
-/flow:archive "REQ-123" --reason deprecated  # 标记为废弃归档
-/flow:archive --list                         # 列出所有归档
-/flow:archive "REQ-123" --restore            # 恢复归档需求
-```
-
-### 参数说明
-- **REQ_ID**: 需求编号，格式 REQ-XXX 或 BUG-XXX
-- **--reason**: 归档原因
-  - `completed` (默认) - 需求已完成并发布
-  - `deprecated` - 需求已废弃，不再需要
-  - `obsolete` - 需求已过时，被新需求取代
-  - `superseded` - 被其他需求合并或替代
-- **--list**: 列出所有归档的需求
-- **--restore**: 将归档的需求恢复到活跃目录
-
-## 执行流程
-
-### 阶段 1: Entry Gate (参数验证)
-```
-1. 解析命令参数
-   → 检测模式: archive | list | restore
-
-2. 验证 REQ_ID 格式
-   → 必须匹配: ^(REQ|BUG)-[0-9]+(-[0-9]+)?$
-
-3. 检查需求状态
-   → 归档模式: 需求必须存在于 devflow/requirements/ 或 devflow/bugs/
-   → 恢复模式: 需求必须存在于 devflow/archive/{YYYY-MM}/
-
-4. 验证归档原因
-   → 必须是: completed, deprecated, obsolete, superseded 之一
-
-*GATE CHECK: 参数验证通过*
-```
-
-### 阶段 2: 归档执行
-```
-1. 确定归档目标目录
-   → 格式: devflow/archive/{YYYY-MM}/{REQ_ID}/
-   → 年月使用北京时间
-
-2. 备份当前状态
-   → 读取 orchestration_status.json 的 status 字段
-   → 保存为 statusBeforeArchive
-
-3. 移动目录
-   → mv devflow/requirements/{REQ_ID}/ → devflow/archive/{YYYY-MM}/{REQ_ID}/
-   → 或 mv devflow/bugs/{BUG_ID}/ → devflow/archive/{YYYY-MM}/{BUG_ID}/
-
-4. 更新状态文件
-   → orchestration_status.json:
-     {
-       "status": "archived",
-       "archivedReason": "{reason}",
-       "archivedAt": "{ISO8601+08:00}",
-       "archiveLocation": "{target_path}",
-       "statusBeforeArchive": "{previous_status}"
-     }
-
-5. 追加 EXECUTION_LOG.md
-   → 记录归档时间、原因、位置
-```
-
-### 阶段 3: 列表模式 (--list)
-```
-1. 扫描 devflow/archive/ 目录
-   → 按月份组织: devflow/archive/{YYYY-MM}/
-
-2. 收集归档信息
-   → 读取每个归档需求的 orchestration_status.json
-   → 提取: reqId, title, archivedReason, archivedAt
-
-3. 格式化输出
-   → 表格形式展示: 月份 | 需求ID | 归档原因 | 标题
-```
-
-### 阶段 4: 恢复模式 (--restore)
-```
-1. 定位归档需求
-   → 在 devflow/archive/*/ 中搜索 {REQ_ID}
-
-2. 验证目标位置
-   → 确认 devflow/requirements/{REQ_ID}/ 不存在
-   → 避免覆盖现有需求
-
-3. 移动回活跃目录
-   → mv devflow/archive/{YYYY-MM}/{REQ_ID}/ → devflow/requirements/{REQ_ID}/
-
-4. 恢复状态
-   → 读取 statusBeforeArchive，恢复为 status
-   → 删除归档相关字段 (archivedAt, archivedReason, archiveLocation)
-
-5. 记录恢复事件
-   → EXECUTION_LOG.md 追加恢复记录
-```
-
-## 输出产物
-
-### 归档后目录结构
-```text
-devflow/
-├── requirements/          # 活跃需求
-│   └── REQ-004/          # 进行中的需求
-├── archive/               # 归档区
-│   ├── 2025-12/          # 按月份组织
-│   │   ├── REQ-003/      # 已归档需求
-│   │   │   ├── README.md
-│   │   │   ├── PRD.md
-│   │   │   ├── EPIC.md
-│   │   │   ├── EXECUTION_LOG.md
-│   │   │   ├── orchestration_status.json  # status: "archived"
-│   │   │   └── research/
-│   │   └── REQ-001/
-│   └── 2025-11/
-│       └── REQ-002/
-└── bugs/                  # 活跃Bug
-```
-
-### 归档后状态文件
-```json
-{
-  "reqId": "REQ-003",
-  "title": "分支命名优化",
-  "status": "archived",
-  "archivedReason": "completed",
-  "archivedAt": "2025-12-16T16:30:00+08:00",
-  "archiveLocation": "devflow/archive/2025-12/REQ-003",
-  "statusBeforeArchive": "release_complete",
-  "completedSteps": ["init", "prd", "epic", "dev", "qa", "release"],
-  "prUrl": "https://github.com/xxx/xxx/pull/6"
-}
-```
-
-## 成功输出
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-✅ 需求 REQ-003 已归档
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   原位置: devflow/requirements/REQ-003
-   新位置: devflow/archive/2025-12/REQ-003
-   归档原因: completed
-   归档前状态: release_complete
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
-## 列表输出
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📦 归档需求列表
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-月份       | 需求ID       | 归档原因     | 标题
-───────────────────────────────────────────────────────────────
-2025-12    | REQ-003      | completed    | 分支命名优化
-2025-12    | REQ-001      | deprecated   | 旧版登录功能
-2025-11    | REQ-002      | superseded   | 用户管理V1
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
-## 错误处理
-
-### 常见错误
-
-**1. 需求不存在**
-```
-ERROR: 需求目录不存在: devflow/requirements/REQ-999
-```
-
-**2. 需求已归档**
-```
-ERROR: REQ-003 已经在归档中: devflow/archive/2025-12/REQ-003
-如需重新归档，请先使用 --restore 恢复
-```
-
-**3. 恢复时目标已存在**
-```
-ERROR: 目标目录已存在: devflow/requirements/REQ-003
-请先删除或重命名现有目录
-```
-
-**4. 无效的归档原因**
-```
-ERROR: 无效的归档原因: cancelled
-有效选项: completed deprecated obsolete superseded
-```
-
-## 最佳实践
-
-### 何时归档
-- ✅ 需求已完成并成功发布 (`/flow:release` 后)
-- ✅ 需求被明确取消或废弃
-- ✅ 需求被新需求完全取代
-
-### 何时恢复
-- 🔄 需要参考历史实现
-- 🔄 需要基于旧需求进行迭代
-- 🔄 错误归档需要撤销
-
-### 不要归档
-- ❌ 仍在进行中的需求
-- ❌ 暂停但计划继续的需求
-- ❌ 需要长期维护的需求
-
-## 与其他命令的关系
-
-```text
-/flow:init → /flow:spec → /flow:dev → /flow:verify → /flow:release
-                                                            ↓
-                                                    /flow:archive ← 工作流终点
-                                                            ↓
-                                                    devflow/archive/{YYYY-MM}/
-```
-
-## Delta Specs 集成 (v4.5)
-
-归档时自动处理 Delta Specs:
-
-### 归档前检查
-- 检测 `deltas/` 目录中的 Delta Specs
-- 警告未应用的 Delta Specs (status != "applied")
-- 建议先运行 `/flow:delta apply REQ-XXX --all`
-
-### 归档内容
-```
-devflow/archive/{YYYY-MM}/{REQ_ID}/
-├── PRD.md                    # 主规格文档
-├── deltas/                   # Delta Specs (完整保留)
-│   ├── 2026-02-01-add-2fa/
-│   │   ├── delta.md
-│   │   └── tasks.md
-│   └── ...
-├── orchestration_status.json # 包含 deltaCount 字段
-└── ...
-```
-
-### 状态文件增强
-```json
-{
-  "status": "archived",
-  "archivedReason": "completed",
-  "deltaCount": 3,
-  "archivedAt": "2026-02-07T10:00:00+08:00"
-}
-```
-
-## 脚本集成
-
-```bash
-# 归档需求
-.claude/scripts/archive-requirement.sh "REQ-003" --reason completed
-
-# 列出归档 (JSON格式)
-.claude/scripts/archive-requirement.sh --list --json
-
-# 恢复需求
-.claude/scripts/archive-requirement.sh "REQ-003" --restore
-
-# 预览操作
-.claude/scripts/archive-requirement.sh "REQ-003" --dry-run
-```

package/.claude/commands/flow/checklist.md

@@ -1,18 +0,0 @@
----
-name: flow-checklist
-description: 'Deprecated. Checklist stage merged into /flow:verify gates.'
----
-
-# /flow:checklist (Deprecated)
-
-`/flow:checklist` 已废弃。
-
-## Migration
-
-- 使用：`/flow:verify "REQ-123"`
-- 严格模式：`/flow:verify "REQ-123" --strict`
-
-## Reason
-
-- Checklist 功能已并入 report-card 门禁模型。
-- 统一 gate 输出为 `devflow/requirements/<REQ_ID>/report-card.json`。

package/.claude/commands/flow/clarify.md

@@ -1,18 +0,0 @@
----
-name: flow-clarify
-description: 'Deprecated. Clarification step removed from default workflow. Use /flow:spec directly.'
----
-
-# /flow:clarify (Deprecated)
-
-`/flow:clarify` 已从默认主链移除。
-
-## Migration
-
-- 直接执行：`/flow:spec "REQ-123"`
-- 如需补充澄清，请将澄清结果写入：`devflow/requirements/<REQ_ID>/context-package.md`
-
-## Reason
-
-- 独立澄清阶段导致链路变长且可恢复点分散。
-- 主链改为 `init -> spec -> dev -> verify -> release`。

package/.claude/commands/flow/constitution.md

@@ -1,82 +0,0 @@
----
-name: flow-constitution
-description: 'Manage CC-DevFlow Constitution. Usage: /flow-constitution [--article I] [--amend --proposal file] [--apply --version TYPE]'
-scripts:
-  manage: .claude/scripts/manage-constitution.sh
----
-
-# Flow-Constitution - 宪法管理命令
-
-## User Input
-```text
-$ARGUMENTS = "[--article I] [--verify] [--impact-report] [--amend --proposal path] [--apply --version TYPE] [--history]"
-```
-
-## 执行原则
-- 所有功能均由 `{SCRIPT:manage}` 执行；此文档仅说明入口与参数。
-- Article 编号遵循罗马数字 I-X。
-- 版本类型：MAJOR / MINOR / PATCH（SemVer 语义）。
-
-## 常用命令
-```text
-/flow-constitution                      → show 当前版本
-/flow-constitution --article IV         → show 指定 Article
-/flow-constitution --verify             → verify 全局一致性
-/flow-constitution --impact-report      → impact 分析
-/flow-constitution --history            → 历史
-/flow-constitution --amend --proposal amendments/2025-01-10-observability.md
-/flow-constitution --apply --version MINOR
-/flow-constitution --apply --version PATCH --force
-```
-
-## 执行流程（由脚本实现）
-
-### 1. Show / Article
-```
-→ {SCRIPT:manage} show [ARTICLE]
-→ 输出当前版本、修订日期、指定 Article 内容
-```
-
-### 2. Verify
-```
-→ {SCRIPT:manage} verify
-→ 检查所有模板/代理/脚本的 Constitution 版本号一致
-→ 调用 validate-constitution hooks，如有违规列出文件
-```
-
-### 3. Impact Report
-```
-→ {SCRIPT:manage} impact
-→ 汇总即将应用的修正案对模板/代理/脚本的影响
-→ 生成报告 (amendments/impact_*.md)
-```
-
-### 4. Amend
-```
-→ {SCRIPT:manage} amend <proposal>
-→ 校验提案格式（版本建议、动机、影响、迁移策略）
-→ 输出预览并提示下一步（apply 之前需人工 review）
-```
-
-### 5. Apply
-```
-→ {SCRIPT:manage} apply <TYPE>
-→ 更新 .claude/rules/project-constitution.md 版本号
-→ 触发模板/代理/脚本同步
-→ 生成 Sync Report
-```
-
-### 6. History
-```
-→ {SCRIPT:manage} history
-→ 列出版本历史与修订摘要
-```
-
-## 错误处理
-- 未提供必要参数（如 --proposal）→ 脚本返回错误提示。
-- Invalid version bump → 阻断，要求遵循 MAJOR/MINOR/PATCH。
-- 验证失败（如模板未同步）→ 返回违规清单，用户需手动修复。
-
-## 下一步
-- 需要向项目传播修订时，先运行 `--impact-report`，与团队确认后再 `--apply`。
-- 应用后建议运行 `/flow:verify --strict` 确认所有需求遵循最新宪法。

package/.claude/commands/flow/context.md

@@ -1,150 +0,0 @@
----
-name: flow-context
-description: Manage staged context injection for agents (RM-015)
-version: 3.0.0
----
-
-# /flow-context
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
-## Purpose
-
-Manage context injection configuration for CC-DevFlow agents.
-Each agent type has a JSONL file defining what context to load.
-
-## Usage
-
-```bash
-# Initialize context directory for a requirement
-/flow-context init [REQ-ID] [--type backend|frontend|fullstack]
-
-# Add entry to context file
-/flow-context add [agent] [path] [purpose] [--optional]
-
-# List current context configuration
-/flow-context list [agent]
-
-# Validate context paths exist
-/flow-context validate [REQ-ID]
-```
-
-## Subcommands
-
-### init
-
-Initialize context directory with templates.
-
-```bash
-/flow-context init REQ-007 --type backend
-```
-
-Creates:
-- `devflow/requirements/REQ-007/context/`
-- Copies templates from `.claude/docs/templates/context/*.jsonl.template`
-- Customizes based on `--type` (backend removes frontend specs, etc.)
-
-### add
-
-Add an entry to a context JSONL file.
-
-```bash
-/flow-context add dev "src/utils/auth.ts" "Authentication utilities" --optional
-```
-
-Appends to `context/dev.jsonl`:
-```json
-{"type": "file", "path": "src/utils/auth.ts", "purpose": "Authentication utilities", "optional": true}
-```
-
-### list
-
-Show current context configuration.
-
-```bash
-/flow-context list dev
-```
-
-Output:
-```
-Context for 'dev' agent (REQ-007):
-
-  1. [file] TASKS.md - Current task list and progress
-  2. [file] EPIC.md - Epic overview and phases
-  3. [file] TECH_DESIGN.md - Technical implementation guide
-  4. [file] ERROR_LOG.md - Previous errors to avoid (optional)
-  5. [spec] devflow/spec/frontend/style.md - Frontend style guide (optional)
-
-Total: 5 entries (3 required, 2 optional)
-```
-
-### validate
-
-Validate all context paths exist.
-
-```bash
-/flow-context validate REQ-007
-```
-
-Output:
-```
-Validating context for REQ-007...
-
-  ✓ dev.jsonl: 5/5 paths valid
-  ✓ epic.jsonl: 4/4 paths valid
-  ✗ review.jsonl: 3/4 paths valid
-    - Missing: contracts/api.yaml
-
-Overall: 12/13 paths valid (92%)
-```
-
-## Integration
-
-### With flow-init
-
-When `/flow:init` creates a new requirement, it automatically runs:
-```bash
-/flow-context init {REQ-ID} --type {detected-type}
-```
-
-### With Agent Invocation
-
-The `inject-agent-context.ts` hook automatically:
-1. Detects current REQ-ID from environment or git branch
-2. Reads `context/{agent}.jsonl`
-3. Injects resolved content into agent prompt
-
-## Context Entry Format
-
-```jsonl
-{"type": "file", "path": "PRD.md", "purpose": "Product requirements"}
-{"type": "directory", "path": "contracts/", "purpose": "API contracts", "depth": 2}
-{"type": "spec", "path": "devflow/spec/backend/api.md", "purpose": "API conventions"}
-```
-
-### Entry Types
-
-| Type | Path Resolution | Use Case |
-|------|-----------------|----------|
-| `file` | Relative to requirement dir | Requirement-specific files |
-| `directory` | Relative to requirement dir | Load all files in directory |
-| `spec` | Relative to project root | Project-level specifications |
-
-### Optional Entries
-
-Add `"optional": true` for files that may not exist:
-```json
-{"type": "file", "path": "ERROR_LOG.md", "purpose": "Previous errors", "optional": true}
-```
-
-## Scripts
-
-- `.claude/scripts/flow-context-init.sh` - Initialize context directory
-- `.claude/scripts/flow-context-add.sh` - Add entry to JSONL
-- `.claude/scripts/flow-context-validate.sh` - Validate paths
-
-## Related
-
-- **Hook**: `.claude/hooks/inject-agent-context.ts`
-- **Types**: `.claude/hooks/types/context-injection.d.ts`
-- **Templates**: `.claude/docs/templates/context/*.jsonl.template`