@winspan/claude-forge 8.41.0 → 8.50.6

package/scripts/migrate-legacy-to-dynamic.sql

@@ -0,0 +1,108 @@
+-- Legacy Pipeline 到 Dynamic Pipeline 数据迁移脚本
+-- 执行前请备份数据库：cp ~/.claude-forge/data.db ~/.claude-forge/data.db.backup
+
+-- ============================================
+-- 阶段 1：迁移 pipelines → dynamic_pipelines
+-- ============================================
+
+INSERT INTO dynamic_pipelines (
+  id, requirement, project_path, session_id,
+  template_id, convention_id, complexity, reasoning,
+  status, created_at, updated_at
+)
+SELECT
+  id,
+  requirement,
+  project_path,
+  session_id,
+  NULL as template_id,  -- Legacy 无模板概念
+  NULL as convention_id,
+  COALESCE(complexity, 'moderate') as complexity,
+  reasoning,
+  CASE
+    WHEN phase = 'done' THEN 'completed'
+    ELSE 'in_progress'
+  END as status,
+  created_at,
+  updated_at
+FROM pipelines
+WHERE id NOT IN (SELECT id FROM dynamic_pipelines);
+
+-- ============================================
+-- 阶段 2：迁移 pipeline_tasks → dynamic_nodes
+-- ============================================
+
+INSERT INTO dynamic_nodes (
+  id, pipeline_id, node_type_id, status,
+  dependencies, bound_skill_name, output,
+  started_at, completed_at, created_at, updated_at
+)
+SELECT
+  id,
+  pipeline_id,
+  phase as node_type_id,  -- 将 phase 映射为 node_type_id
+  CASE
+    WHEN status = 'completed' THEN 'completed'
+    WHEN status = 'in_progress' THEN 'in_progress'
+    WHEN status = 'failed' THEN 'failed'
+    ELSE 'pending'
+  END as status,
+  COALESCE(dependencies, '[]') as dependencies,
+  NULL as bound_skill_name,  -- Legacy 无 skill 绑定
+  output,
+  NULL as started_at,  -- 需要从事件推导
+  NULL as completed_at,
+  datetime('now') as created_at,  -- pipeline_tasks 无 created_at
+  COALESCE(updated_at, datetime('now')) as updated_at
+FROM pipeline_tasks
+WHERE id NOT IN (SELECT id FROM dynamic_nodes);
+
+-- ============================================
+-- 阶段 3：验证迁移结果（删除 current_node_id 更新）
+-- ============================================
+
+-- ============================================
+-- 阶段 4：转换 pipeline_events 事件类型
+-- ============================================
+
+-- 将 Legacy 事件类型转换为 Dynamic 事件类型
+UPDATE pipeline_events
+SET type = CASE
+  WHEN type = 'pipeline.created' THEN 'dynamic_pipeline.created'
+  WHEN type = 'task.created' THEN 'dynamic_node.created'
+  WHEN type = 'task.started' THEN 'dynamic_node.started'
+  WHEN type = 'task.completed' THEN 'dynamic_node.completed'
+  WHEN type = 'task.failed' THEN 'dynamic_node.failed'
+  WHEN type = 'phase.advanced' THEN 'dynamic_node.advanced'
+  WHEN type = 'pipeline.closed' THEN 'dynamic_pipeline.completed'
+  ELSE type
+END
+WHERE pipeline_id IN (SELECT id FROM pipelines);
+
+-- ============================================
+-- 验证迁移结果
+-- ============================================
+
+-- 检查迁移数量
+SELECT
+  'Migrated Pipelines' as item,
+  COUNT(*) as count
+FROM dynamic_pipelines
+WHERE id IN (SELECT id FROM pipelines)
+
+UNION ALL
+
+SELECT
+  'Migrated Nodes' as item,
+  COUNT(*) as count
+FROM dynamic_nodes
+WHERE pipeline_id IN (SELECT id FROM pipelines)
+
+UNION ALL
+
+SELECT
+  'Converted Events' as item,
+  COUNT(*) as count
+FROM pipeline_events
+WHERE pipeline_id IN (SELECT id FROM pipelines)
+  AND type LIKE 'dynamic_%';

package/scripts/regenerate-execution-docs.ts

@@ -0,0 +1,116 @@
+#!/usr/bin/env tsx
+/**
+ * 一次性脚本：用新的 ExecutionDocBuilder 重新生成所有历史执行文档。
+ *
+ * 用法：
+ *   npx tsx scripts/regenerate-execution-docs.ts
+ *
+ * 行为：
+ *   1. 打开 ~/.claude-forge/data.db
+ *   2. 查询 routing_events 中所有 distinct session_id
+ *   3. 对每个 session 调用 builder.build(sessionId, projectPath)
+ *      → 会自动覆盖 overview/agent/skill 文件并最后调用 updateIndex
+ *   4. updateIndex 扫描 by-route/ 下全部目录，因此即便某些路由在 DB 中已无数据，
+ *      它们的目录仍会被纳入新的 index.md（保留旧文件作为兜底）
+ *
+ * 注意：
+ *   - 数据库只读
+ *   - 仅覆盖 <projectRoot>/.claude-forge/executions/ 下的 markdown
+ *   - 不传 AI provider，统一使用 fallback summary（避免网络抖动）
+ */
+
+import path from 'node:path';
+import fs from 'node:fs';
+import { SQLiteStorage } from '../src/core/storage/sqlite.js';
+import { ExecutionDocBuilder } from '../src/intelligence/execution-doc-builder.js';
+import { FORGE_PATHS } from '../src/core/constants.js';
+
+async function main(): Promise<void> {
+  const projectPath = process.cwd();
+  const dbPath = FORGE_PATHS.database();
+
+  console.log('===========================================');
+  console.log('Regenerate Execution Docs');
+  console.log('===========================================');
+  console.log(`projectPath : ${projectPath}`);
+  console.log(`database    : ${dbPath}`);
+
+  if (!fs.existsSync(dbPath)) {
+    console.error(`数据库不存在: ${dbPath}`);
+    process.exit(1);
+  }
+
+  const byRouteDir = path.join(projectPath, '.claude-forge', 'executions', 'by-route');
+  const allDirs = fs.existsSync(byRouteDir)
+    ? fs.readdirSync(byRouteDir, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .map(d => d.name)
+    : [];
+  console.log(`磁盘目录数  : ${allDirs.length}`);
+
+  const storage = new SQLiteStorage(dbPath);
+  const builder = new ExecutionDocBuilder(storage, null);
+
+  // 查询所有 distinct session_id
+  const db = storage.getDatabase();
+  const sessionRows = db
+    .prepare(
+      `SELECT DISTINCT session_id, COUNT(*) AS n
+       FROM routing_events
+       WHERE session_id IS NOT NULL
+       GROUP BY session_id
+       ORDER BY MIN(ts) ASC`,
+    )
+    .all() as Array<{ session_id: string; n: number }>;
+
+  console.log(`数据库内 session 数 : ${sessionRows.length}`);
+  sessionRows.forEach(s => {
+    console.log(`  - ${s.session_id}  (${s.n} routes)`);
+  });
+  console.log('');
+
+  if (sessionRows.length === 0) {
+    console.log('数据库中没有可重生的路由记录，但仍尝试调用 updateIndex 重写索引...');
+    // 没有 session 时，build() 不会被调用，因此 updateIndex 也不会运行。
+    // 用一个空 sessionId 触发？不行，build 内部会查 0 行就返回。
+    // 直接构造一个临时 builder 不行（updateIndex 是 private）。
+    // 兜底：调用任意一个目录名作为 sessionId 让它跑一次。
+    // 实际场景下 sessionRows 至少有 1 个，此分支多半不会进。
+    storage.close();
+    return;
+  }
+
+  let totalRoutes = 0;
+  let okSessions = 0;
+  let failSessions = 0;
+
+  for (const [i, s] of sessionRows.entries()) {
+    const tag = `[${i + 1}/${sessionRows.length}]`;
+    try {
+      console.log(`${tag} 处理 session ${s.session_id} (${s.n} routes)...`);
+      await builder.build(s.session_id, projectPath);
+      okSessions++;
+      totalRoutes += s.n;
+    } catch (err) {
+      failSessions++;
+      console.warn(`${tag} ✗ session ${s.session_id} 失败: ${err}`);
+    }
+  }
+
+  console.log('');
+  console.log('===========================================');
+  console.log('完成');
+  console.log('===========================================');
+  console.log(`session 成功    : ${okSessions}`);
+  console.log(`session 失败    : ${failSessions}`);
+  console.log(`重生路由记录数  : ${totalRoutes}`);
+  console.log(`磁盘目录总数    : ${allDirs.length}`);
+  console.log(`未覆盖目录数    : ${Math.max(allDirs.length - totalRoutes, 0)}  （保留原文件）`);
+
+  storage.close();
+}
+
+main().catch(err => {
+  console.error('重生失败:', err);
+  process.exit(1);
+});

package/scripts/sync-agent-skills.ts

@@ -0,0 +1,193 @@
+#!/usr/bin/env tsx
+/**
+ * sync-agent-skills.ts
+ *
+ * 从 GitHub 同步 addyosmani/agent-skills 到本地 ~/.claude/skills/agent-skills/
+ *
+ * 功能：
+ * 1. Clone 或 pull agent-skills 仓库
+ * 2. 记录 upstream commit hash 到 .sync-metadata.json
+ * 3. 生成 MIT License NOTICE 文件
+ * 4. 幂等：重复运行不会重复 clone
+ */
+
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { homedir } from 'os';
+
+const UPSTREAM_REPO = 'https://github.com/addyosmani/agent-skills.git';
+const SKILLS_BASE_DIR = path.join(homedir(), '.claude', 'skills');
+const TARGET_DIR = path.join(SKILLS_BASE_DIR, 'agent-skills');
+const METADATA_FILE = path.join(TARGET_DIR, '.sync-metadata.json');
+const NOTICE_FILE = path.join(TARGET_DIR, 'NOTICE');
+
+interface SyncMetadata {
+  upstream_repo: string;
+  commit_hash: string;
+  synced_at: string;
+}
+
+/**
+ * 执行 shell 命令并返回输出
+ */
+function exec(command: string, cwd?: string): string {
+  try {
+    return execSync(command, {
+      cwd,
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+  } catch (error: unknown) {
+    if (error instanceof Error && 'stderr' in error) {
+      throw new Error(`Command failed: ${command}\n${(error as { stderr: Buffer }).stderr.toString()}`);
+    }
+    throw error;
+  }
+}
+
+/**
+ * 检查 git 是否可用
+ */
+function checkGitAvailable(): void {
+  try {
+    exec('git --version');
+  } catch (error) {
+    console.error('❌ Git 未安装或不可用');
+    console.error('请先安装 Git: https://git-scm.com/downloads');
+    process.exit(1);
+  }
+}
+
+/**
+ * 确保目录存在
+ */
+function ensureDir(dir: string): void {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+    console.log(`✓ 创建目录: ${dir}`);
+  }
+}
+
+/**
+ * 获取当前 commit hash
+ */
+function getCommitHash(repoDir: string): string {
+  return exec('git rev-parse HEAD', repoDir);
+}
+
+/**
+ * 生成 MIT License NOTICE 文件
+ */
+function generateNotice(commitHash: string, syncedAt: string): string {
+  return `This directory contains skills from addyosmani/agent-skills
+Repository: https://github.com/addyosmani/agent-skills
+License: MIT
+Upstream commit: ${commitHash}
+Synced at: ${syncedAt}
+
+Original work Copyright (c) Addy Osmani
+Modifications (if any) Copyright (c) claude-forge contributors
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+`;
+}
+
+/**
+ * 同步 agent-skills 仓库
+ */
+async function syncAgentSkills(): Promise<void> {
+  console.log('🔄 开始同步 agent-skills...\n');
+
+  // 1. 检查 git 可用性
+  checkGitAvailable();
+
+  // 2. 确保基础目录存在
+  ensureDir(SKILLS_BASE_DIR);
+
+  let isNewClone = false;
+
+  // 3. Clone 或 Pull
+  if (!fs.existsSync(TARGET_DIR)) {
+    console.log(`📦 克隆仓库: ${UPSTREAM_REPO}`);
+    try {
+      exec(`git clone ${UPSTREAM_REPO} "${TARGET_DIR}"`);
+      isNewClone = true;
+      console.log('✓ 克隆成功\n');
+    } catch (error) {
+      console.error('❌ 克隆失败');
+      console.error('可能原因：网络问题、仓库不存在、权限不足');
+      throw error;
+    }
+  } else {
+    console.log('📂 目录已存在，执行 git pull 更新...');
+    try {
+      const output = exec('git pull', TARGET_DIR);
+      console.log(`✓ ${output}\n`);
+    } catch (error) {
+      console.error('❌ 更新失败');
+      console.error('可能原因：本地有未提交的修改、网络问题');
+      throw error;
+    }
+  }
+
+  // 4. 获取 commit hash
+  const commitHash = getCommitHash(TARGET_DIR);
+  const syncedAt = new Date().toISOString();
+
+  console.log(`📌 Upstream commit: ${commitHash}`);
+  console.log(`🕐 同步时间: ${syncedAt}\n`);
+
+  // 5. 写入 metadata
+  const metadata: SyncMetadata = {
+    upstream_repo: UPSTREAM_REPO,
+    commit_hash: commitHash,
+    synced_at: syncedAt,
+  };
+
+  fs.writeFileSync(METADATA_FILE, JSON.stringify(metadata, null, 2), 'utf-8');
+  console.log(`✓ 元数据已保存: ${METADATA_FILE}`);
+
+  // 6. 生成 NOTICE 文件
+  const noticeContent = generateNotice(commitHash, syncedAt);
+  fs.writeFileSync(NOTICE_FILE, noticeContent, 'utf-8');
+  console.log(`✓ NOTICE 文件已生成: ${NOTICE_FILE}\n`);
+
+  // 7. 统计 skills 数量
+  const skillsDir = path.join(TARGET_DIR, 'skills');
+  if (fs.existsSync(skillsDir)) {
+    const skills = fs.readdirSync(skillsDir).filter((name) => {
+      const fullPath = path.join(skillsDir, name);
+      return fs.statSync(fullPath).isDirectory();
+    });
+    console.log(`📊 共同步 ${skills.length} 个 skills`);
+  }
+
+  console.log('\n✅ 同步完成！');
+  console.log(`\n目标目录: ${TARGET_DIR}`);
+}
+
+// 执行同步
+syncAgentSkills().catch((error) => {
+  console.error('\n❌ 同步失败:', error.message);
+  process.exit(1);
+});
+

package/scripts/test-hook.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# 测试 Hook 脚本是否能正常与守护进程通信
+
+SOCKET_PATH="$HOME/.claude-forge/daemon.sock"
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  测试 Claude Forge Hook 通信"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# 1. 检查守护进程是否运行
+echo "1. 检查守护进程状态..."
+if [ -f "$HOME/.claude-forge/daemon.pid" ]; then
+    PID=$(cat "$HOME/.claude-forge/daemon.pid")
+    if kill -0 "$PID" 2>/dev/null; then
+        echo "   ✓ 守护进程运行中 (PID: $PID)"
+    else
+        echo "   ✗ 守护进程未运行"
+        exit 1
+    fi
+else
+    echo "   ✗ PID 文件不存在"
+    exit 1
+fi
+
+# 2. 检查 Socket 文件
+echo ""
+echo "2. 检查 Socket 文件..."
+if [ -S "$SOCKET_PATH" ]; then
+    echo "   ✓ Socket 文件存在: $SOCKET_PATH"
+else
+    echo "   ✗ Socket 文件不存在"
+    exit 1
+fi
+
+# 3. 发送测试事件
+echo ""
+echo "3. 发送测试事件..."
+
+# PreToolUse 事件
+echo "   发送 PreToolUse 事件..."
+echo '{"hook_type":"PreToolUse","timestamp":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","session_id":"test-session-123","project_path":"'$PWD'","tool_name":"Read","tool_input":"{\"file_path\":\"/test/file.txt\"}"}' | nc -U "$SOCKET_PATH" 2>/dev/null
+sleep 0.5
+
+# PostToolUse 事件
+echo "   发送 PostToolUse 事件..."
+echo '{"hook_type":"PostToolUse","timestamp":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","session_id":"test-session-123","project_path":"'$PWD'","tool_name":"Read","success":true}' | nc -U "$SOCKET_PATH" 2>/dev/null
+sleep 0.5
+
+# Notification 事件
+echo "   发送 Notification 事件..."
+echo '{"hook_type":"Notification","timestamp":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","session_id":"test-session-123","project_path":"'$PWD'","message":"Test notification"}' | nc -U "$SOCKET_PATH" 2>/dev/null
+sleep 0.5
+
+echo "   ✓ 测试事件已发送"
+
+# 4. 查询数据库
+echo ""
+echo "4. 查询数据库中的事件..."
+sleep 1
+cd "$(dirname "$0")/.."
+npx tsx src/cli/index.ts query stats
+
+echo ""
+echo "5. 查看最近的事件..."
+npx tsx src/cli/index.ts query events --limit 5
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  测试完成"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/scripts/verify-skill-loading.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env tsx
+/**
+ * Verification script to test skill loading from both formats
+ */
+
+import { SkillRegistry } from '../src/skills/registry.js';
+
+console.log('=== Verifying Skill Loading ===\n');
+
+const registry = new SkillRegistry();
+const skills = registry.getAll();
+
+console.log(`Total skills loaded: ${skills.length}\n`);
+
+// Check for official skills
+const officialSkills = skills.filter(s => s.isOfficial);
+console.log(`Official skills: ${officialSkills.length}`);
+
+// Check for user skills
+const userSkills = skills.filter(s => !s.isOfficial);
+console.log(`User skills: ${userSkills.length}\n`);
+
+// Check for directory format skills (path contains SKILL.md)
+const dirFormatSkills = userSkills.filter(s => s.path.includes('SKILL.md'));
+console.log(`Directory format skills: ${dirFormatSkills.length}`);
+if (dirFormatSkills.length > 0) {
+  console.log('Examples:');
+  dirFormatSkills.slice(0, 3).forEach(s => {
+    console.log(`  - ${s.id} (${s.path})`);
+    console.log(`    description: ${s.description || 'N/A'}`);
+    console.log(`    keywords: ${s.keywords.join(', ') || 'N/A'}`);
+  });
+}
+
+// Check for flat format skills (path ends with .md but not SKILL.md)
+const flatFormatSkills = userSkills.filter(s => s.path.endsWith('.md') && !s.path.includes('SKILL.md'));
+console.log(`\nFlat format skills: ${flatFormatSkills.length}`);
+if (flatFormatSkills.length > 0) {
+  console.log('Examples:');
+  flatFormatSkills.slice(0, 3).forEach(s => {
+    console.log(`  - ${s.id} (${s.path})`);
+    console.log(`    description: ${s.description || 'N/A'}`);
+    console.log(`    keywords: ${s.keywords.join(', ') || 'N/A'}`);
+  });
+}
+
+// Check for skills with description field
+const skillsWithDesc = skills.filter(s => s.description);
+console.log(`\nSkills with description field: ${skillsWithDesc.length}`);
+
+// Check for skills without keywords (should use description fallback)
+const skillsWithoutKeywords = skills.filter(s => s.keywords.length === 0);
+console.log(`Skills without keywords: ${skillsWithoutKeywords.length}`);
+if (skillsWithoutKeywords.length > 0) {
+  console.log('Examples:');
+  skillsWithoutKeywords.slice(0, 3).forEach(s => {
+    console.log(`  - ${s.id}`);
+    console.log(`    description: ${s.description || 'N/A'}`);
+  });
+}
+
+console.log('\n=== Verification Complete ===');