@winspan/claude-forge 8.51.1 → 8.54.3

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

@@ -1,108 +0,0 @@
--- 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

@@ -1,116 +0,0 @@
-#!/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

@@ -1,193 +0,0 @@
-#!/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

@@ -1,71 +0,0 @@
-#!/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

@@ -1,62 +0,0 @@
-#!/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 ===');