cc-devflow 4.2.0 → 4.3.0

package/.claude/skills/utility/npm-release/references/version-decision-guide.md

@@ -0,0 +1,134 @@
+# Version Decision Reference
+
+## Semantic Versioning Rules
+
+**Format**: `MAJOR.MINOR.PATCH` (e.g., 4.2.0)
+
+### When to Bump Each Number
+
+| Version | Increment When | Examples |
+|---------|---------------|----------|
+| **MAJOR** | Breaking changes that require user action | API redesign, removed features, incompatible changes |
+| **MINOR** | New features, backward compatible | New commands, new options, enhanced functionality |
+| **PATCH** | Bug fixes, minor improvements | Fix crashes, improve error messages, documentation |
+
+### Decision Tree
+
+```
+Is this a breaking change?
+├─ YES → MAJOR bump (X.0.0)
+└─ NO → Is this a new feature?
+    ├─ YES → MINOR bump (X.Y.0)
+    └─ NO → PATCH bump (X.Y.Z)
+```
+
+## Common Scenarios
+
+### Scenario 1: Bug Fix
+**Current**: 4.2.0
+**Change**: Fix login crash
+**Decision**: PATCH → **4.2.1**
+
+### Scenario 2: New Feature (Compatible)
+**Current**: 4.2.1
+**Change**: Add `/flow:export` command
+**Decision**: MINOR → **4.3.0**
+
+### Scenario 3: Breaking Change
+**Current**: 4.3.0
+**Change**: Remove deprecated `/flow-new` command
+**Decision**: MAJOR → **5.0.0**
+
+### Scenario 4: Multiple Changes
+**Current**: 4.3.0
+**Changes**:
+- Fix 3 bugs (PATCH)
+- Add 2 new features (MINOR)
+- No breaking changes
+
+**Decision**: Take highest level → MINOR → **4.4.0**
+
+## Anti-Patterns (FORBIDDEN)
+
+### ❌ Arbitrary Jumps
+```
+3.0.1 → 7.0.0  # WRONG: No justification for jumping 4 major versions
+```
+
+**Correct**:
+```
+3.0.1 → 4.0.0  # If breaking change
+3.0.1 → 3.1.0  # If new feature
+3.0.1 → 3.0.2  # If bug fix
+```
+
+### ❌ Skipping Versions
+```
+4.2.0 → 4.4.0  # WRONG: Skipped 4.3.0
+```
+
+**Correct**:
+```
+4.2.0 → 4.3.0 → 4.4.0  # Sequential
+```
+
+### ❌ Inconsistent Formats
+```
+v1.0          # WRONG: Missing patch
+1.0.0         # WRONG: Missing 'v' prefix in git tag
+release-1.0   # WRONG: Non-standard format
+```
+
+**Correct**:
+```
+Git tag:      v4.2.0
+package.json: "version": "4.2.0"
+CHANGELOG:    ## [4.2.0] - 2026-03-12
+```
+
+## Version Validation Checklist
+
+Before bumping version, verify:
+
+- [ ] Change type is clear (patch/minor/major)
+- [ ] Version increment follows SemVer rules
+- [ ] No arbitrary jumps (e.g., 3.x → 7.x)
+- [ ] All version markers will be updated atomically
+- [ ] CHANGELOG.md entry prepared
+- [ ] Git tag format will be `vX.Y.Z`
+
+## Breaking Change Examples
+
+**Breaking changes require MAJOR bump**:
+
+- Removing commands or options
+- Changing command syntax
+- Changing output format (breaking scripts)
+- Removing configuration options
+- Changing default behavior significantly
+- Requiring new dependencies
+- Dropping support for Node versions
+
+**NOT breaking changes** (MINOR or PATCH):
+
+- Adding new commands (MINOR)
+- Adding new options with defaults (MINOR)
+- Deprecation warnings (MINOR)
+- Bug fixes (PATCH)
+- Performance improvements (PATCH)
+- Documentation updates (PATCH)
+
+## Version History Analysis
+
+Use this to understand past version decisions:
+
+```bash
+# View version history
+git tag --sort=v:refname
+
+# View changes between versions
+git log v4.1.0..v4.2.0 --oneline
+
+# Check CHANGELOG for version rationale
+grep -A 10 "## \[4.2.0\]" CHANGELOG.md
+```

package/.claude/skills/utility/npm-release/scripts/atomic-version-bump.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# Atomic Version Bump - Updates all version markers in one transaction
+# Ensures package.json, CHANGELOG.md stay in sync
+
+set -euo pipefail
+
+CHANGE_TYPE="${1:-}"
+CHANGE_DESCRIPTION="${2:-}"
+
+if [[ -z "$CHANGE_TYPE" ]]; then
+    echo "Usage: $0 <patch|minor|major> [description]"
+    echo ""
+    echo "Examples:"
+    echo "  $0 patch 'Fix login bug'"
+    echo "  $0 minor 'Add user dashboard'"
+    echo "  $0 major 'Redesign API'"
+    exit 1
+fi
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# 1. Get current version
+CURRENT_VERSION=$(grep -o '"version": *"[^"]*"' package.json | grep -o '[0-9]\+\.[0-9]\+\.[0-9]\+')
+echo "📦 Current version: $CURRENT_VERSION"
+
+# 2. Calculate next version using decision tree
+NEXT_VERSION=$("$SCRIPT_DIR/version-decision-tree.sh" "$CURRENT_VERSION" "$CHANGE_TYPE")
+echo "🎯 Next version: $NEXT_VERSION"
+
+# 3. Validate version sync before proceeding
+echo ""
+echo "🔍 Pre-flight validation..."
+if ! "$SCRIPT_DIR/validate-version-sync.sh"; then
+    echo ""
+    echo "❌ Version sync validation failed. Fix inconsistencies before bumping."
+    exit 1
+fi
+
+# 4. Update package.json
+echo ""
+echo "📝 Updating package.json..."
+sed -i.bak "s/\"version\": \"$CURRENT_VERSION\"/\"version\": \"$NEXT_VERSION\"/" package.json
+rm package.json.bak
+
+# 5. Prepare CHANGELOG.md entry
+CURRENT_DATE=$(date +%Y-%m-%d)
+CHANGELOG_ENTRY="## [$NEXT_VERSION] - $CURRENT_DATE
+
+### 🎯 ${CHANGE_DESCRIPTION:-Version $NEXT_VERSION}
+
+#### Changed
+- TODO: Add change details
+
+---
+
+"
+
+# Insert after the first "---" line in CHANGELOG.md
+if [[ -f "CHANGELOG.md" ]]; then
+    echo "📝 Updating CHANGELOG.md..."
+    # Create temp file with new entry
+    awk -v entry="$CHANGELOG_ENTRY" '
+        /^---$/ && !inserted {
+            print
+            print entry
+            inserted=1
+            next
+        }
+        {print}
+    ' CHANGELOG.md > CHANGELOG.md.tmp
+    mv CHANGELOG.md.tmp CHANGELOG.md
+else
+    echo "⚠️  CHANGELOG.md not found, skipping"
+fi
+
+# 6. Validate post-update
+echo ""
+echo "🔍 Post-update validation..."
+UPDATED_VERSION=$(grep -o '"version": *"[^"]*"' package.json | grep -o '[0-9]\+\.[0-9]\+\.[0-9]\+')
+
+if [[ "$UPDATED_VERSION" != "$NEXT_VERSION" ]]; then
+    echo "❌ Version update failed: expected $NEXT_VERSION, got $UPDATED_VERSION"
+    exit 1
+fi
+
+echo ""
+echo "✅ Version bumped successfully: $CURRENT_VERSION → $NEXT_VERSION"
+echo ""
+echo "📋 Next steps:"
+echo "   1. Edit CHANGELOG.md to add detailed changes"
+echo "   2. Review changes: git diff"
+echo "   3. Commit: git add package.json CHANGELOG.md && git commit -m 'chore(release): bump version to $NEXT_VERSION'"
+echo "   4. Tag: git tag -a v$NEXT_VERSION -m 'Release v$NEXT_VERSION'"
+echo "   5. Push: git push origin main && git push origin v$NEXT_VERSION"

package/.claude/skills/utility/npm-release/scripts/validate-version-sync.sh

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# Version Sync Validator - Ensures all version markers are consistent
+# Checks: package.json, git tags, CHANGELOG.md
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+ERRORS=0
+
+echo "🔍 Validating version synchronization..."
+echo ""
+
+# 1. Extract version from package.json
+if [[ ! -f "package.json" ]]; then
+    echo -e "${RED}❌ package.json not found${NC}"
+    exit 1
+fi
+
+PKG_VERSION=$(grep -o '"version": *"[^"]*"' package.json | grep -o '[0-9]\+\.[0-9]\+\.[0-9]\+')
+echo "📦 package.json version: $PKG_VERSION"
+
+# 2. Check latest git tag
+LATEST_TAG=$(git tag --sort=-v:refname | head -1 || echo "")
+if [[ -z "$LATEST_TAG" ]]; then
+    echo -e "${YELLOW}⚠️  No git tags found${NC}"
+else
+    TAG_VERSION="${LATEST_TAG#v}"  # Remove 'v' prefix
+    echo "🏷️  Latest git tag: $LATEST_TAG ($TAG_VERSION)"
+
+    if [[ "$PKG_VERSION" != "$TAG_VERSION" ]]; then
+        echo -e "${RED}❌ Version mismatch: package.json ($PKG_VERSION) != git tag ($TAG_VERSION)${NC}"
+        ((ERRORS++))
+    else
+        echo -e "${GREEN}✅ package.json and git tag match${NC}"
+    fi
+fi
+
+# 3. Check CHANGELOG.md
+if [[ ! -f "CHANGELOG.md" ]]; then
+    echo -e "${YELLOW}⚠️  CHANGELOG.md not found${NC}"
+else
+    # Extract first version from CHANGELOG (after the header)
+    # macOS grep doesn't support -P, use sed instead
+    CHANGELOG_VERSION=$(sed -n 's/^## \[\([0-9]\+\.[0-9]\+\.[0-9]\+\)\].*/\1/p' CHANGELOG.md | head -1)
+
+    if [[ -z "$CHANGELOG_VERSION" ]]; then
+        echo -e "${YELLOW}⚠️  No version found in CHANGELOG.md${NC}"
+    else
+        echo "📝 CHANGELOG.md latest: $CHANGELOG_VERSION"
+
+        if [[ "$PKG_VERSION" != "$CHANGELOG_VERSION" ]]; then
+            echo -e "${RED}❌ Version mismatch: package.json ($PKG_VERSION) != CHANGELOG.md ($CHANGELOG_VERSION)${NC}"
+            ((ERRORS++))
+        else
+            echo -e "${GREEN}✅ package.json and CHANGELOG.md match${NC}"
+        fi
+    fi
+fi
+
+# 4. Check for version format consistency in git tags
+echo ""
+echo "🔍 Checking git tag format consistency..."
+INCONSISTENT_TAGS=$(git tag | grep -v '^v[0-9]\+\.[0-9]\+\.[0-9]\+$' || true)
+if [[ -n "$INCONSISTENT_TAGS" ]]; then
+    echo -e "${YELLOW}⚠️  Found tags with inconsistent format:${NC}"
+    echo "$INCONSISTENT_TAGS" | sed 's/^/   /'
+    echo -e "${YELLOW}   Expected format: vX.Y.Z (e.g., v4.2.0)${NC}"
+fi
+
+echo ""
+if [[ $ERRORS -eq 0 ]]; then
+    echo -e "${GREEN}✅ All version markers are synchronized${NC}"
+    exit 0
+else
+    echo -e "${RED}❌ Found $ERRORS version synchronization error(s)${NC}"
+    exit 1
+fi

package/.claude/skills/utility/npm-release/scripts/version-decision-tree.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# Version Decision Tree - Semantic Versioning Enforcer
+# Prevents arbitrary version jumps by enforcing SemVer rules
+
+set -euo pipefail
+
+CURRENT_VERSION="${1:-}"
+CHANGE_TYPE="${2:-}"
+
+if [[ -z "$CURRENT_VERSION" || -z "$CHANGE_TYPE" ]]; then
+    echo "Usage: $0 <current-version> <patch|minor|major>"
+    exit 1
+fi
+
+# Parse current version
+if [[ ! "$CURRENT_VERSION" =~ ^([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
+    echo "❌ Invalid version format: $CURRENT_VERSION"
+    echo "   Expected: X.Y.Z (e.g., 4.2.0)"
+    exit 1
+fi
+
+MAJOR="${BASH_REMATCH[1]}"
+MINOR="${BASH_REMATCH[2]}"
+PATCH="${BASH_REMATCH[3]}"
+
+# Calculate next version based on change type
+case "$CHANGE_TYPE" in
+    patch)
+        NEXT_VERSION="$MAJOR.$MINOR.$((PATCH + 1))"
+        ;;
+    minor)
+        NEXT_VERSION="$MAJOR.$((MINOR + 1)).0"
+        ;;
+    major)
+        NEXT_VERSION="$((MAJOR + 1)).0.0"
+        ;;
+    *)
+        echo "❌ Invalid change type: $CHANGE_TYPE"
+        echo "   Expected: patch, minor, or major"
+        exit 1
+        ;;
+esac
+
+echo "$NEXT_VERSION"

package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/affected-repos.txt

@@ -0,0 +1 @@
+root

package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/edited-files.log

@@ -0,0 +1,2 @@
+1773366329	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json	root
+1773366437	Edit	/Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json	root

package/CHANGELOG.md

@@ -7,6 +7,46 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [4.3.0] - 2026-03-13
+
+### ✨ TDD Enforcement + OpenSpec Interop
+
+v4.3.0 adds automatic TDD order validation and bidirectional OpenSpec conversion to solve requirement drift problems.
+
+#### Added
+
+- **TDD Order Validation**
+  - Added `validateTDDOrder()` in `lib/harness/planner.js` to enforce Constitution Article VI
+  - Validates that [IMPL] tasks depend on corresponding [TEST] tasks
+  - Validates that [TEST] tasks don't depend on [IMPL] tasks
+  - Intelligent feature name matching with fuzzy algorithm (removes suffixes like "测试", "实现", "功能")
+  - Extended `TaskSchema` in `lib/harness/schemas.js` with `type` field (TEST/IMPL/OTHER)
+  - Comprehensive test coverage in `lib/harness/__tests__/planner.tdd.test.js` (10 tests, all passing)
+
+- **OpenSpec Interoperability**
+  - Added `.claude/scripts/import-openspec.js` for OpenSpec → CC-DevFlow conversion
+    - Parses OpenSpec format (Purpose + Requirements + BDD scenarios)
+    - Auto-generates TDD tasks (TEST + IMPL pairs with correct dependencies)
+    - Adds Design section with [NEEDS CLARIFICATION] markers
+    - Generates Verification checklist
+  - Added `.claude/scripts/export-openspec.js` for CC-DevFlow → OpenSpec conversion
+    - Strips YAML frontmatter and metadata
+    - Removes Design, Tasks, Verification sections
+    - Removes [NEEDS CLARIFICATION] markers
+    - Outputs pure Requirements in OpenSpec format
+  - Added `.claude/commands/flow/import-openspec.md` command documentation
+  - Added `.claude/commands/flow/export-openspec.md` command documentation
+  - Comprehensive test coverage in `.claude/scripts/__tests__/openspec.test.js` (5 tests, all passing)
+  - Round-trip conversion preserves requirements integrity
+
+#### Benefits
+
+- ✅ Automatic enforcement of TDD order (Constitution Article VI)
+- ✅ Prevents implementation before tests at parse time
+- ✅ Bidirectional OpenSpec compatibility
+- ✅ Automatic TDD task generation during import
+- ✅ Clean requirement export without implementation details
+
 ## [4.2.0] - 2026-02-19
 
 ### 🧠 Long-Running Harness Protocol Alignment

package/README.md

@@ -27,8 +27,9 @@ Harness-first five-stage workflow from requirement setup to release: `/flow:init
 - 🔗 **GitHub Integration** - Automated PR creation, branch management, and conventional commits
 - 📊 **Progress Tracking** - Real-time status monitoring and intelligent restart points
 - 🔍 **Consistency Verification** - Enterprise-grade consistency checking with intelligent conflict detection
-- 🧪 **TDD Enforced** - Strict Test-Driven Development with TEST VERIFICATION CHECKPOINT
+- 🧪 **TDD Enforced** - Strict Test-Driven Development with automatic TDD order validation in harness planner
 - 📜 **Constitution** - 10 Articles governing quality, security, and architecture
+- 🔄 **OpenSpec Interop** - Bidirectional conversion between OpenSpec and CC-DevFlow formats with automatic TDD task generation
 - 🔄 **Autonomous Development** - Ralph × Manus Integration for memory-enhanced continuous iteration
 - 🔌 **Multi-Platform Support** - Compile workflows for Codex, Cursor, Qwen, Antigravity via `npm run adapt`
 - 🔄 **Multi-Module Compiler** - Full module compilation: skills, commands, agents, rules, hooks

package/README.zh-CN.md

@@ -27,8 +27,9 @@
 - 🔗 **GitHub 集成** - 自动化 PR 创建、分支管理和规范化提交
 - 📊 **进度跟踪** - 实时状态监控和智能重启点
 - 🔍 **一致性验证** - 企业级一致性检查，智能冲突检测
-- 🧪 **TDD 强制执行** - 严格的测试驱动开发，TEST VERIFICATION CHECKPOINT
+- 🧪 **TDD 强制执行** - 严格的测试驱动开发，harness planner 自动 TDD 顺序验证
 - 📜 **Constitution** - 10条宪法条款管控质量、安全和架构
+- 🔄 **OpenSpec 互操作** - OpenSpec 与 CC-DevFlow 格式双向转换，自动生成 TDD 任务
 - 🔄 **自主开发** - Ralph × Manus 集成实现有记忆的持续迭代
 - 🔌 **多平台支持** - 通过 `npm run adapt` 编译工作流到 Codex、Cursor、Qwen、Antigravity
 - 🔄 **多模块编译器** - 完整模块编译：skills、commands、agents、rules、hooks