cc-devflow 4.3.0 → 4.5.0

package/.claude/hooks/ralph-stop-hook.sh

@@ -1,190 +0,0 @@
-#!/bin/bash
-
-# Ralph Wiggum Stop Hook
-# Prevents session exit when a ralph-loop is active
-# Feeds Claude's output back as input to continue the loop
-
-set -euo pipefail
-
-# Read hook input from stdin (advanced stop hook API)
-HOOK_INPUT=$(cat)
-
-# Check if ralph-loop is active
-RALPH_STATE_FILE=".claude/ralph-loop.local.md"
-
-if [[ ! -f "$RALPH_STATE_FILE" ]]; then
-  # No active loop - allow exit
-  exit 0
-fi
-
-# Parse markdown frontmatter (YAML between ---) and extract values
-FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$RALPH_STATE_FILE")
-ITERATION=$(echo "$FRONTMATTER" | grep '^iteration:' | sed 's/iteration: *//')
-MAX_ITERATIONS=$(echo "$FRONTMATTER" | grep '^max_iterations:' | sed 's/max_iterations: *//')
-# Extract completion_promise and strip surrounding quotes if present
-COMPLETION_PROMISE=$(echo "$FRONTMATTER" | grep '^completion_promise:' | sed 's/completion_promise: *//' | sed 's/^"\(.*\)"$/\1/')
-# Extract REQ_ID for CC-DevFlow task status checking
-REQ_ID=$(echo "$FRONTMATTER" | grep '^req_id:' | sed 's/req_id: *//' | sed 's/^"\(.*\)"$/\1/' || echo "")
-
-# Validate numeric fields before arithmetic operations
-if [[ ! "$ITERATION" =~ ^[0-9]+$ ]]; then
-  echo "⚠️  Ralph loop: State file corrupted" >&2
-  echo "   File: $RALPH_STATE_FILE" >&2
-  echo "   Problem: 'iteration' field is not a valid number (got: '$ITERATION')" >&2
-  echo "" >&2
-  echo "   This usually means the state file was manually edited or corrupted." >&2
-  echo "   Ralph loop is stopping. Run /ralph-loop again to start fresh." >&2
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-if [[ ! "$MAX_ITERATIONS" =~ ^[0-9]+$ ]]; then
-  echo "⚠️  Ralph loop: State file corrupted" >&2
-  echo "   File: $RALPH_STATE_FILE" >&2
-  echo "   Problem: 'max_iterations' field is not a valid number (got: '$MAX_ITERATIONS')" >&2
-  echo "" >&2
-  echo "   This usually means the state file was manually edited or corrupted." >&2
-  echo "   Ralph loop is stopping. Run /ralph-loop again to start fresh." >&2
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-# Check if max iterations reached
-if [[ $MAX_ITERATIONS -gt 0 ]] && [[ $ITERATION -ge $MAX_ITERATIONS ]]; then
-  echo "🛑 Ralph loop: Max iterations ($MAX_ITERATIONS) reached."
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-# Get transcript path from hook input
-TRANSCRIPT_PATH=$(echo "$HOOK_INPUT" | jq -r '.transcript_path')
-
-if [[ ! -f "$TRANSCRIPT_PATH" ]]; then
-  echo "⚠️  Ralph loop: Transcript file not found" >&2
-  echo "   Expected: $TRANSCRIPT_PATH" >&2
-  echo "   This is unusual and may indicate a Claude Code internal issue." >&2
-  echo "   Ralph loop is stopping." >&2
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-# Read last assistant message from transcript (JSONL format - one JSON per line)
-# First check if there are any assistant messages
-if ! grep -q '"role":"assistant"' "$TRANSCRIPT_PATH"; then
-  echo "⚠️  Ralph loop: No assistant messages found in transcript" >&2
-  echo "   Transcript: $TRANSCRIPT_PATH" >&2
-  echo "   This is unusual and may indicate a transcript format issue" >&2
-  echo "   Ralph loop is stopping." >&2
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-# Extract last assistant message with explicit error handling
-LAST_LINE=$(grep '"role":"assistant"' "$TRANSCRIPT_PATH" | tail -1)
-if [[ -z "$LAST_LINE" ]]; then
-  echo "⚠️  Ralph loop: Failed to extract last assistant message" >&2
-  echo "   Ralph loop is stopping." >&2
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-# Parse JSON with error handling
-LAST_OUTPUT=$(echo "$LAST_LINE" | jq -r '
-  .message.content |
-  map(select(.type == "text")) |
-  map(.text) |
-  join("\n")
-' 2>&1)
-
-# Check if jq succeeded
-if [[ $? -ne 0 ]]; then
-  echo "⚠️  Ralph loop: Failed to parse assistant message JSON" >&2
-  echo "   Error: $LAST_OUTPUT" >&2
-  echo "   This may indicate a transcript format issue" >&2
-  echo "   Ralph loop is stopping." >&2
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-if [[ -z "$LAST_OUTPUT" ]]; then
-  echo "⚠️  Ralph loop: Assistant message contained no text content" >&2
-  echo "   Ralph loop is stopping." >&2
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-# Check for completion promise (only if set)
-if [[ "$COMPLETION_PROMISE" != "null" ]] && [[ -n "$COMPLETION_PROMISE" ]]; then
-  # Extract text from <promise> tags using Perl for multiline support
-  # -0777 slurps entire input, s flag makes . match newlines
-  # .*? is non-greedy (takes FIRST tag), whitespace normalized
-  PROMISE_TEXT=$(echo "$LAST_OUTPUT" | perl -0777 -pe 's/.*?<promise>(.*?)<\/promise>.*/$1/s; s/^\s+|\s+$//g; s/\s+/ /g' 2>/dev/null || echo "")
-
-  # Use = for literal string comparison (not pattern matching)
-  # == in [[ ]] does glob pattern matching which breaks with *, ?, [ characters
-  if [[ -n "$PROMISE_TEXT" ]] && [[ "$PROMISE_TEXT" = "$COMPLETION_PROMISE" ]]; then
-    echo "✅ Ralph loop: Detected <promise>$COMPLETION_PROMISE</promise>"
-    rm "$RALPH_STATE_FILE"
-    exit 0
-  fi
-fi
-
-# CC-DevFlow specific: Check if all tasks completed
-if [[ -n "$REQ_ID" ]] && [[ -f ".claude/scripts/check-task-status.sh" ]]; then
-  remaining_count=$(bash .claude/scripts/check-task-status.sh --json 2>/dev/null | jq -r '.remaining' 2>/dev/null || echo "999")
-
-  if [[ "$remaining_count" == "0" ]]; then
-    echo "✅ Ralph loop: All tasks in TASKS.md completed!"
-    rm "$RALPH_STATE_FILE"
-    exit 0
-  fi
-fi
-
-# Not complete - continue loop with SAME PROMPT
-NEXT_ITERATION=$((ITERATION + 1))
-
-# Extract prompt (everything after the closing ---)
-# Skip first --- line, skip until second --- line, then print everything after
-# Use i>=2 instead of i==2 to handle --- in prompt content
-PROMPT_TEXT=$(awk '/^---$/{i++; next} i>=2' "$RALPH_STATE_FILE")
-
-if [[ -z "$PROMPT_TEXT" ]]; then
-  echo "⚠️  Ralph loop: State file corrupted or incomplete" >&2
-  echo "   File: $RALPH_STATE_FILE" >&2
-  echo "   Problem: No prompt text found" >&2
-  echo "" >&2
-  echo "   This usually means:" >&2
-  echo "     • State file was manually edited" >&2
-  echo "     • File was corrupted during writing" >&2
-  echo "" >&2
-  echo "   Ralph loop is stopping. Run /ralph-loop again to start fresh." >&2
-  rm "$RALPH_STATE_FILE"
-  exit 0
-fi
-
-# Update iteration in frontmatter (portable across macOS and Linux)
-# Create temp file, then atomically replace
-TEMP_FILE="${RALPH_STATE_FILE}.tmp.$$"
-sed "s/^iteration: .*/iteration: $NEXT_ITERATION/" "$RALPH_STATE_FILE" > "$TEMP_FILE"
-mv "$TEMP_FILE" "$RALPH_STATE_FILE"
-
-# Build system message with iteration count and completion promise info
-if [[ "$COMPLETION_PROMISE" != "null" ]] && [[ -n "$COMPLETION_PROMISE" ]]; then
-  SYSTEM_MSG="🔄 Ralph iteration $NEXT_ITERATION | To stop: output <promise>$COMPLETION_PROMISE</promise> (ONLY when statement is TRUE - do not lie to exit!)"
-else
-  SYSTEM_MSG="🔄 Ralph iteration $NEXT_ITERATION | No completion promise set - loop runs infinitely"
-fi
-
-# Output JSON to block the stop and feed prompt back
-# The "reason" field contains the prompt that will be sent back to Claude
-jq -n \
-  --arg prompt "$PROMPT_TEXT" \
-  --arg msg "$SYSTEM_MSG" \
-  '{
-    "decision": "block",
-    "reason": $prompt,
-    "systemMessage": $msg
-  }'
-
-# Exit 0 for successful hook execution
-exit 0

package/.claude/hooks/skill-activation-prompt.sh

@@ -1,36 +0,0 @@
-#!/bin/bash
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# 技能自动激活 Hook - Bash 包装器
-# ═══════════════════════════════════════════════════════════════════════════════
-#
-# 【核心功能】
-# Bash 脚本包装器，调用 TypeScript 实现的技能激活逻辑
-#
-# 【工作原理】
-# 1. 切换到 hooks 目录
-# 2. 通过管道传递 stdin 到 TypeScript 脚本
-# 3. 使用 npx tsx 运行 TypeScript（无需编译）
-#
-# 【为什么需要这个包装器？】
-# - Claude Code hooks 必须是可执行的 shell 脚本
-# - 此脚本负责设置环境并调用实际的 TypeScript 实现
-#
-# 【设计原则】
-# KISS - Keep It Simple, Stupid
-# 包装器只做一件事：调用 TypeScript 实现
-#
-# ═══════════════════════════════════════════════════════════════════════════════
-
-# 错误时立即退出
-set -e
-
-# 切换到 hooks 目录（确保能找到 TypeScript 文件）
-cd "$CLAUDE_PROJECT_DIR/.claude/hooks"
-
-# 通过管道传递 stdin 到 TypeScript 脚本
-# - cat: 读取 stdin
-# - |: 管道传递
-# - npx tsx: 直接运行 TypeScript（无需 tsc 编译）
-# - skill-activation-prompt.ts: TypeScript 实现
-cat | npx tsx skill-activation-prompt.ts

package/.claude/hooks/skill-activation-prompt.ts

@@ -1,214 +0,0 @@
-#!/usr/bin/env node
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// 技能自动激活 Hook - TypeScript 实现
-// ═══════════════════════════════════════════════════════════════════════════════
-//
-// 【核心功能】
-// 在用户每次提交 prompt 时自动分析并建议相关技能
-//
-// 【工作原理】
-// 1. 读取用户输入的 prompt
-// 2. 加载 skill-rules.json 配置文件
-// 3. 根据关键词和意图模式匹配技能
-// 4. 按优先级分组并输出建议
-//
-// 【设计哲学】
-// "工具应该适应人的思维，而不是让人适应工具"
-// 技能在你需要时激活，而不是在你记得时激活
-//
-// ═══════════════════════════════════════════════════════════════════════════════
-
-import { readFileSync } from 'fs';
-import { join } from 'path';
-
-// ───────────────────────────────────────────────────────────────────────────────
-// 类型定义
-// ───────────────────────────────────────────────────────────────────────────────
-
-/**
- * Hook 输入接口
- * Claude Code 传递给 UserPromptSubmit hook 的数据结构
- */
-interface HookInput {
-    session_id: string;        // 会话 ID
-    transcript_path: string;   // 对话记录路径
-    cwd: string;               // 当前工作目录
-    permission_mode: string;   // 权限模式
-    prompt: string;            // 用户输入的提示词
-}
-
-/**
- * 提示触发器配置
- * 定义如何通过用户输入触发技能
- */
-interface PromptTriggers {
-    keywords?: string[];        // 关键词列表（精确匹配）
-    intentPatterns?: string[];  // 意图模式列表（正则表达式）
-}
-
-/**
- * 技能规则配置
- * 定义单个技能的激活条件和优先级
- */
-interface SkillRule {
-    type: 'guardrail' | 'domain';                    // 技能类型：护栏 | 领域
-    enforcement: 'block' | 'suggest' | 'warn';       // 强制级别：阻塞 | 建议 | 警告
-    priority: 'critical' | 'high' | 'medium' | 'low'; // 优先级
-    promptTriggers?: PromptTriggers;                  // 提示触发器
-}
-
-/**
- * 技能规则集合
- * skill-rules.json 的根数据结构
- */
-interface SkillRules {
-    version: string;                    // 规则版本
-    skills: Record<string, SkillRule>;  // 技能名称 -> 规则配置
-}
-
-/**
- * 匹配到的技能
- * 内部使用，记录匹配结果
- */
-interface MatchedSkill {
-    name: string;                          // 技能名称
-    matchType: 'keyword' | 'intent';       // 匹配类型：关键词 | 意图
-    config: SkillRule;                     // 技能配置
-}
-
-// ───────────────────────────────────────────────────────────────────────────────
-// 主函数
-// ───────────────────────────────────────────────────────────────────────────────
-
-async function main() {
-    try {
-        // ┌─────────────────────────────────────────────────────────────────────┐
-        // │ 步骤 1: 读取输入                                                      │
-        // └─────────────────────────────────────────────────────────────────────┘
-        // 从 stdin 读取 Claude Code 传递的 JSON 数据
-        const input = readFileSync(0, 'utf-8');
-        const data: HookInput = JSON.parse(input);
-        const prompt = data.prompt.toLowerCase(); // 转小写便于匹配
-
-        // ┌─────────────────────────────────────────────────────────────────────┐
-        // │ 步骤 2: 加载技能规则配置                                              │
-        // └─────────────────────────────────────────────────────────────────────┘
-        const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-        const rulesPath = join(projectDir, '.claude', 'skills', 'skill-rules.json');
-        const rules: SkillRules = JSON.parse(readFileSync(rulesPath, 'utf-8'));
-
-        // 存储匹配到的技能
-        const matchedSkills: MatchedSkill[] = [];
-
-        // ┌─────────────────────────────────────────────────────────────────────┐
-        // │ 步骤 3: 遍历所有技能，检查是否匹配                                     │
-        // └─────────────────────────────────────────────────────────────────────┘
-        for (const [skillName, config] of Object.entries(rules.skills)) {
-            const triggers = config.promptTriggers;
-
-            // 如果没有配置触发器，跳过此技能
-            if (!triggers) {
-                continue;
-            }
-
-            // ┌───────────────────────────────────────────────────────────────┐
-            // │ 3.1 关键词匹配                                                 │
-            // └───────────────────────────────────────────────────────────────┘
-            // 检查 prompt 中是否包含配置的关键词
-            if (triggers.keywords) {
-                const keywordMatch = triggers.keywords.some(kw =>
-                    prompt.includes(kw.toLowerCase())
-                );
-                if (keywordMatch) {
-                    matchedSkills.push({ name: skillName, matchType: 'keyword', config });
-                    continue; // 匹配到就继续下一个技能
-                }
-            }
-
-            // ┌───────────────────────────────────────────────────────────────┐
-            // │ 3.2 意图模式匹配                                               │
-            // └───────────────────────────────────────────────────────────────┘
-            // 使用正则表达式匹配更复杂的意图模式
-            if (triggers.intentPatterns) {
-                const intentMatch = triggers.intentPatterns.some(pattern => {
-                    const regex = new RegExp(pattern, 'i'); // 'i' = 忽略大小写
-                    return regex.test(prompt);
-                });
-                if (intentMatch) {
-                    matchedSkills.push({ name: skillName, matchType: 'intent', config });
-                }
-            }
-        }
-
-        // ┌─────────────────────────────────────────────────────────────────────┐
-        // │ 步骤 4: 生成输出（如果有匹配）                                         │
-        // └─────────────────────────────────────────────────────────────────────┘
-        if (matchedSkills.length > 0) {
-            let output = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
-            output += '🎯 SKILL ACTIVATION CHECK\n';
-            output += '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n';
-
-            // ┌───────────────────────────────────────────────────────────────┐
-            // │ 4.1 按优先级分组                                               │
-            // └───────────────────────────────────────────────────────────────┘
-            const critical = matchedSkills.filter(s => s.config.priority === 'critical');
-            const high = matchedSkills.filter(s => s.config.priority === 'high');
-            const medium = matchedSkills.filter(s => s.config.priority === 'medium');
-            const low = matchedSkills.filter(s => s.config.priority === 'low');
-
-            // ┌───────────────────────────────────────────────────────────────┐
-            // │ 4.2 输出各优先级的技能                                         │
-            // └───────────────────────────────────────────────────────────────┘
-
-            // 关键技能（必需）
-            if (critical.length > 0) {
-                output += '⚠️ CRITICAL SKILLS (REQUIRED):\n';
-                critical.forEach(s => output += `  → ${s.name}\n`);
-                output += '\n';
-            }
-
-            // 推荐技能
-            if (high.length > 0) {
-                output += '📚 RECOMMENDED SKILLS:\n';
-                high.forEach(s => output += `  → ${s.name}\n`);
-                output += '\n';
-            }
-
-            // 建议技能
-            if (medium.length > 0) {
-                output += '💡 SUGGESTED SKILLS:\n';
-                medium.forEach(s => output += `  → ${s.name}\n`);
-                output += '\n';
-            }
-
-            // 可选技能
-            if (low.length > 0) {
-                output += '📌 OPTIONAL SKILLS:\n';
-                low.forEach(s => output += `  → ${s.name}\n`);
-                output += '\n';
-            }
-
-            // 操作提示
-            output += 'ACTION: Use Skill tool BEFORE responding\n';
-            output += '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
-
-            // 输出到 stdout（Claude Code 会捕获并显示给用户）
-            console.log(output);
-        }
-
-        process.exit(0); // 成功退出
-    } catch (err) {
-        // 错误处理：输出错误信息到 stderr
-        console.error('Error in skill-activation-prompt hook:', err);
-        process.exit(1); // 错误退出
-    }
-}
-
-// ───────────────────────────────────────────────────────────────────────────────
-// 程序入口
-// ───────────────────────────────────────────────────────────────────────────────
-main().catch(err => {
-    console.error('Uncaught error:', err);
-    process.exit(1);
-});

package/.claude/hooks/state/skills-used-test-guard.json

@@ -1,3 +0,0 @@
-[
-  "devflow-tdd-enforcer"
-]