cc-devflow 2.4.3 → 2.4.6

package/.claude/scripts/populate-research-tasks.sh

@@ -72,24 +72,44 @@ def extract_task_sections(markdown_content: str) -> List[Dict[str, str]]:
     从 research-summary.md 中提取任务章节信息。
 
     期望格式:
-    ### RT-001: 输入框架构重构
-    **决策**: 全面重构方案
-    **理由**: 当前实现仅207行...
-    **备选方案**: 1. 渐进式增强...
+    ### R001 — 输入框架构重构
+    - **Decision**: 全面重构方案
+    - **Rationale**:
+      - 当前实现仅207行...
+    - **Alternatives Considered**:
+      - 渐进式增强...
     """
     sections = []
     current_section = None
-
-    # 匹配任务标题: ### RT-001: 任务标题
-    task_header = re.compile(r'^###\s+(RT-\d+):\s+(.+)$')
-    # 匹配决策行: **决策**: xxx 或 **Decision**: xxx
-    decision_line = re.compile(r'^\*\*(?:决策|Decision)\*\*:\s*(.+)$')
-    # 匹配理由行: **理由**: xxx 或 **Rationale**: xxx
-    rationale_line = re.compile(r'^\*\*(?:理由|Rationale)\*\*:\s*(.+)$')
-    # 匹配备选方案行: **备选方案**: xxx 或 **Alternatives**: xxx
-    alternatives_line = re.compile(r'^\*\*(?:备选方案|Alternatives)\*\*:\s*(.+)$')
+    current_field = None
+
+    # 匹配任务标题（兼容历史 RT-001）:
+    # - ### R001 — Title
+    # - ### R001: Title
+    # - ### R001 - Title
+    # - ### RT-001: Title  (legacy)
+    task_header = re.compile(r"^###\s+(?P<id>R\d{3}|RT-\d{3})\s*(?:[:—-])\s*(?P<title>.+)$")
+
+    # 匹配字段头（兼容是否带 bullet）:
+    # - - **Decision**: xxx
+    # - - **Rationale**:
+    # - - **Alternatives Considered**:
+    field_header = re.compile(
+        r"^(?:[-*]\s*)?\*\*(?P<label>决策|Decision|理由|Rationale|备选方案|Alternatives(?:\s+Considered)?|来源|Source)\*\*:\s*(?P<value>.*)$"
+    )
+
+    def normalize_task_id(raw: str) -> str:
+        if raw.startswith("RT-"):
+            return f"R{raw.split('-', 1)[1]}"
+        return raw
+
+    def normalize_list_item(line: str) -> str:
+        line = line.strip()
+        line = re.sub(r"^[-*]\s+", "", line)
+        return line.strip()
 
     for line in markdown_content.splitlines():
+        raw_line = line
         line = line.strip()
 
         # 检测新任务章节
@@ -97,9 +117,10 @@ def extract_task_sections(markdown_content: str) -> List[Dict[str, str]]:
         if task_match:
             if current_section:
                 sections.append(current_section)
+            current_field = None
             current_section = {
-                "id": task_match.group(1),
-                "title": task_match.group(2),
+                "id": normalize_task_id(task_match.group("id")),
+                "title": task_match.group("title"),
                 "decision": "",
                 "rationale": "",
                 "alternatives": "",
@@ -109,31 +130,35 @@ def extract_task_sections(markdown_content: str) -> List[Dict[str, str]]:
         if not current_section:
             continue
 
-        # 提取决策
-        decision_match = decision_line.match(line)
-        if decision_match:
-            current_section["decision"] = decision_match.group(1).strip()
-            continue
-
-        # 提取理由
-        rationale_match = rationale_line.match(line)
-        if rationale_match:
-            current_section["rationale"] = rationale_match.group(1).strip()
+        # 检测字段头
+        field_match = field_header.match(line)
+        if field_match:
+            label = field_match.group("label").strip().lower()
+            value = (field_match.group("value") or "").strip()
+
+            if label in {"来源", "source"}:
+                current_field = None
+                continue
+            if label in {"决策", "decision"}:
+                current_field = "decision"
+            elif label in {"理由", "rationale"}:
+                current_field = "rationale"
+            else:
+                current_field = "alternatives"
+
+            if value:
+                current_section[current_field] = value
             continue
 
-        # 提取备选方案
-        alternatives_match = alternatives_line.match(line)
-        if alternatives_match:
-            current_section["alternatives"] = alternatives_match.group(1).strip()
-            continue
-
-        # 继续累积多行理由（如果上一行是理由）
-        if current_section.get("rationale") and line and not line.startswith("**"):
-            current_section["rationale"] += " " + line.strip()
-
-        # 继续累积多行备选方案
-        if current_section.get("alternatives") and line and not line.startswith("**"):
-            current_section["alternatives"] += " " + line.strip()
+        # 累积字段内容（支持列表项）
+        if current_field and line:
+            item = normalize_list_item(raw_line)
+            if not item:
+                continue
+            if current_section[current_field]:
+                current_section[current_field] += "\n" + item
+            else:
+                current_section[current_field] = item
 
     # 添加最后一个章节
     if current_section:

package/.claude/scripts/recover-workflow.sh

@@ -164,16 +164,19 @@ detect_workflow_status() {
 
     # 检查任务进度
     if [[ -f "$REQ_DIR/TASKS.md" ]]; then
-        local tasks_total=$(grep -c "^## TASK" "$REQ_DIR/TASKS.md" 2>/dev/null || echo "0")
-        local tasks_completed=0
-        if [[ -d "$REQ_DIR/tasks" ]]; then
-            tasks_completed=$(find "$REQ_DIR/tasks" -name "*.completed" -type f 2>/dev/null | wc -l | tr -d ' ')
-        fi
+        # 统计已完成任务 (- [x] 标记)
+        local tasks_completed=$(grep -c "^\- \[x\]" "$REQ_DIR/TASKS.md" 2>/dev/null || echo "0")
+
+        # 统计待完成任务 (- [ ] 标记)
+        local tasks_pending=$(grep -c "^\- \[ \]" "$REQ_DIR/TASKS.md" 2>/dev/null || echo "0")
+
+        # 计算任务总数
+        local tasks_total=$((tasks_completed + tasks_pending))
 
         echo -e "${BOLD}任务进度:${NC}"
         echo -e "  总任务数:     $tasks_total"
         echo -e "  已完成:       $tasks_completed"
-        echo -e "  未完成:       $((tasks_total - tasks_completed))"
+        echo -e "  未完成:       $tasks_pending"
         echo ""
     fi
 
@@ -235,13 +238,16 @@ analyze_recovery_strategy() {
         development|dev_complete)
             # 检查是否有未完成的任务
             if [[ -f "$REQ_DIR/TASKS.md" ]]; then
-                local tasks_total=$(grep -c "^## TASK" "$REQ_DIR/TASKS.md" 2>/dev/null || echo "0")
-                local tasks_completed=0
-                if [[ -d "$REQ_DIR/tasks" ]]; then
-                    tasks_completed=$(find "$REQ_DIR/tasks" -name "*.completed" -type f 2>/dev/null | wc -l | tr -d ' ')
-                fi
+                # 统计已完成任务 (- [x] 标记)
+                local tasks_completed=$(grep -c "^\- \[x\]" "$REQ_DIR/TASKS.md" 2>/dev/null || echo "0")
+
+                # 统计待完成任务 (- [ ] 标记)
+                local tasks_pending=$(grep -c "^\- \[ \]" "$REQ_DIR/TASKS.md" 2>/dev/null || echo "0")
+
+                # 计算任务总数
+                local tasks_total=$((tasks_completed + tasks_pending))
 
-                if [[ $tasks_completed -lt $tasks_total ]]; then
+                if [[ $tasks_pending -gt 0 ]]; then
                     echo -e "${CYAN}建议: 继续开发 (恢复未完成任务)${NC}"
                     echo "dev"
                 else

package/.claude/skills/npm-release/SKILL.md

@@ -0,0 +1,314 @@
+---
+name: npm-release
+description: Use when ready to publish a new version of cc-devflow npm package to npm registry
+---
+
+# NPM Release Workflow
+
+## Overview
+
+Standardized release process for cc-devflow npm package ensuring consistent versioning, changelog maintenance, and safe publishing.
+
+**Core Principle**: Atomic release - all version markers (package.json, CHANGELOG.md, git tag) must stay in sync.
+
+## When to Use
+
+Use this skill when:
+- ✅ Ready to release a new version of cc-devflow
+- ✅ All changes committed and pushed
+- ✅ On main branch with clean working directory
+- ✅ Need to publish to npm registry
+
+Don't use when:
+- ❌ Working directory has uncommitted changes
+- ❌ Not on main branch
+- ❌ Pre-release/beta versions (needs adaptation)
+
+## Release Types
+
+Follow [Semantic Versioning](https://semver.org/):
+
+| Type | Version Change | When |
+|------|---------------|------|
+| **Patch** | 2.4.3 → 2.4.4 | Bug fixes, minor improvements |
+| **Minor** | 2.4.4 → 2.5.0 | New features, backward compatible |
+| **Major** | 2.5.0 → 3.0.0 | Breaking changes |
+
+## Complete Workflow
+
+### Phase 1: Pre-Release Checks
+
+```bash
+# 1. Verify git status
+git status
+# MUST show: "On branch main", "working tree clean"
+
+# 2. Check current version
+cat package.json | grep version
+# e.g., "version": "2.4.3"
+
+# 3. Review recent changes
+git log --oneline -10
+```
+
+**STOP if**:
+- Not on main branch
+- Uncommitted changes exist
+- Unpushed commits exist
+
+### Phase 2: Version Updates
+
+**Step 1: Update CHANGELOG.md**
+
+Add new version section at the top (after `---`):
+
+```markdown
+## [X.Y.Z] - YYYY-MM-DD
+
+### 🎯 Release Title
+
+Brief description of main changes.
+
+#### Changed / Added / Fixed
+- Bullet point 1
+- Bullet point 2
+
+#### Benefits
+- ✅ Benefit 1
+- ✅ Benefit 2
+```
+
+**Step 2: Update package.json**
+
+```bash
+# Manually edit or use npm version
+npm version patch --no-git-tag-version  # For patch release
+npm version minor --no-git-tag-version  # For minor release
+npm version major --no-git-tag-version  # For major release
+```
+
+Or edit directly:
+```json
+{
+  "version": "X.Y.Z"
+}
+```
+
+### Phase 3: Git Operations
+
+**Step 1: Create Release Commit**
+
+```bash
+git add CHANGELOG.md package.json
+
+git commit -m "$(cat <<'EOF'
+chore(release): bump version to X.Y.Z
+
+Release X.Y.Z - [Brief title]
+
+主要变更：
+- 变更点 1
+- 变更点 2
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+EOF
+)"
+```
+
+**Step 2: Create Annotated Tag**
+
+```bash
+git tag -a vX.Y.Z -m "$(cat <<'EOF'
+Release vX.Y.Z - [Brief title]
+
+🎯 Main changes:
+- Change 1
+- Change 2
+
+Benefits:
+✅ Benefit 1
+✅ Benefit 2
+
+Full changelog: https://github.com/Dimon94/cc-devflow/blob/main/CHANGELOG.md
+EOF
+)"
+```
+
+**Step 3: Verify**
+
+```bash
+# Check commit
+git log --oneline -1
+
+# Check tag
+git tag -l "v2.4.*" | tail -3
+
+# Verify tag annotation
+git show vX.Y.Z
+```
+
+### Phase 4: Publish
+
+**Step 1: Push to GitHub**
+
+```bash
+# Push commits
+git push origin main
+
+# Push tags
+git push origin vX.Y.Z
+# Or push all tags: git push origin --tags
+```
+
+**Step 2: Create GitHub Release (Optional)**
+
+Via GitHub CLI:
+```bash
+gh release create vX.Y.Z \
+  --title "vX.Y.Z - [Title]" \
+  --notes-file <(sed -n '/## \[X.Y.Z\]/,/## \[/p' CHANGELOG.md | head -n -1)
+```
+
+Or manually at: https://github.com/Dimon94/cc-devflow/releases/new
+
+**Step 3: Publish to npm**
+
+```bash
+# Test publish first (dry-run)
+npm publish --dry-run
+
+# Actual publish
+npm publish
+
+# Verify publication
+npm view cc-devflow version
+```
+
+## Quick Reference
+
+| Step | Command | Purpose |
+|------|---------|---------|
+| Check status | `git status` | Verify clean state |
+| Check version | `grep version package.json` | Current version |
+| Bump version | Edit package.json | Update version number |
+| Update changelog | Edit CHANGELOG.md | Document changes |
+| Create commit | `git commit -m "chore(release): ..."` | Commit version bump |
+| Create tag | `git tag -a vX.Y.Z -m "..."` | Tag release |
+| Push commits | `git push origin main` | Push to GitHub |
+| Push tags | `git push origin vX.Y.Z` | Push tag to GitHub |
+| Publish npm | `npm publish` | Publish to registry |
+
+## Common Mistakes
+
+### ❌ Mistake 1: Forgetting to Update CHANGELOG.md
+
+**Problem**: Version bumped but no changelog entry
+
+**Fix**: Always update CHANGELOG.md BEFORE committing
+
+### ❌ Mistake 2: Inconsistent Version Numbers
+
+**Problem**: package.json shows 2.4.4 but CHANGELOG.md shows 2.4.3
+
+**Fix**: Double-check all version numbers match before committing
+
+### ❌ Mistake 3: Pushing Tag Before Commit
+
+**Problem**: Tag points to wrong commit
+
+**Fix**: Always commit first, then tag, then push both together
+
+### ❌ Mistake 4: Not Testing npm publish
+
+**Problem**: Published package is broken
+
+**Fix**: Run `npm publish --dry-run` first to catch issues
+
+### ❌ Mistake 5: Network Timeout During Push
+
+**Problem**: `Failed to connect to github.com port 443`
+
+**Fix**:
+```bash
+# Option 1: Retry after network stabilizes
+git push origin main
+git push origin vX.Y.Z
+
+# Option 2: Switch to SSH (if HTTPS blocked)
+git remote set-url origin git@github.com:Dimon94/cc-devflow.git
+git push origin main
+```
+
+## Network Troubleshooting
+
+If `git push` fails with timeout:
+
+1. **Check network connectivity**:
+   ```bash
+   curl -I https://github.com 2>&1 | head -5
+   ```
+
+2. **Try SSH instead of HTTPS**:
+   ```bash
+   git remote -v  # Check current remote URL
+   git remote set-url origin git@github.com:Dimon94/cc-devflow.git
+   ```
+
+3. **If SSH fails (publickey error)**:
+   - Check SSH key: `ssh -T git@github.com`
+   - Add SSH key to GitHub: https://github.com/settings/keys
+   - Or stay with HTTPS and retry later
+
+4. **Commits and tags are safe locally**:
+   - They won't be lost
+   - Push when network is available
+
+## Post-Release Verification
+
+After successful release:
+
+```bash
+# 1. Verify GitHub tag
+open https://github.com/Dimon94/cc-devflow/tags
+
+# 2. Verify npm package
+npm view cc-devflow version
+npm view cc-devflow time
+
+# 3. Test installation
+npm install -g cc-devflow@latest
+cc-devflow --version  # Should show new version
+```
+
+## Rollback (If Needed)
+
+If published version has critical bugs:
+
+```bash
+# 1. Unpublish from npm (within 72 hours)
+npm unpublish cc-devflow@X.Y.Z
+
+# 2. Delete git tag locally and remotely
+git tag -d vX.Y.Z
+git push origin :refs/tags/vX.Y.Z
+
+# 3. Revert commit
+git revert HEAD
+
+# 4. Fix bug and re-release with new patch version
+```
+
+**Note**: npm unpublish is only available within 72 hours of publication. After that, publish a new patch version instead.
+
+## Real-World Impact
+
+Following this workflow ensures:
+- ✅ **Consistency**: All version markers stay in sync
+- ✅ **Traceability**: Clear changelog and git history
+- ✅ **Safety**: Dry-run catches issues before publishing
+- ✅ **Recoverability**: Can rollback if needed
+- ✅ **Automation-ready**: Scriptable workflow for future CI/CD
+
+---
+
+**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md