@winspan/claude-forge 8.53.2 → 8.54.3

package/src/daemon/hook-sync.ts

@@ -1,91 +0,0 @@
-import { existsSync, readFileSync, copyFileSync, chmodSync } from 'node:fs';
-import { createHash } from 'node:crypto';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { FORGE_PATHS } from '../core/constants.js';
-import { logger } from '../core/utils/logger.js';
-
-// All hook files to sync (5 hooks + shared lib)
-const HOOK_FILES = [
-  'pre-tool-use.sh',
-  'post-tool-use.sh',
-  'user-prompt-submit.sh',
-  'notification.sh',
-  'stop.sh',
-  'hook-lib.sh',
-];
-
-function sha256(content: Buffer): string {
-  return createHash('sha256').update(content).digest('hex');
-}
-
-function getSourceHooksDir(): string {
-  // Compiled: dist/daemon/hook-sync.js → dist/hooks
-  // Dev (vitest): src/daemon/hook-sync.ts → src/hooks
-  return join(dirname(fileURLToPath(import.meta.url)), '..', 'hooks');
-}
-
-export interface SyncResult {
-  copied: number;
-  checked: number;
-  skipped: number;
-}
-
-/**
- * Sync hooks from the package source (dist/hooks) to ~/.claude-forge/hooks/.
- * Uses SHA-256 comparison to skip identical files.
- *
- * Accepts optional overrides for source/target dirs — used in unit tests.
- * Any failure logs a warning and continues; never throws.
- */
-export function syncHooks(opts?: { sourceDir?: string; targetDir?: string }): SyncResult {
-  const result: SyncResult = { copied: 0, checked: 0, skipped: 0 };
-  const sourceDir = opts?.sourceDir ?? getSourceHooksDir();
-  const targetDir = opts?.targetDir ?? FORGE_PATHS.hooks();
-
-  if (!existsSync(sourceDir)) {
-    logger.warn(`[HookSync] source hooks dir not found at ${sourceDir}, skipping`);
-    return result;
-  }
-
-  if (!existsSync(targetDir)) {
-    // User has not run `claude-forge init` yet — skip silently
-    logger.debug(`[HookSync] target dir not found: ${targetDir} (user may not have run \`claude-forge init\`)`);
-    return result;
-  }
-
-  for (const file of HOOK_FILES) {
-    const src = join(sourceDir, file);
-    const dest = join(targetDir, file);
-
-    if (!existsSync(src)) {
-      result.skipped++;
-      continue;
-    }
-
-    result.checked++;
-
-    try {
-      const srcContent = readFileSync(src);
-      if (existsSync(dest)) {
-        const destContent = readFileSync(dest);
-        if (sha256(srcContent) === sha256(destContent)) {
-          continue; // identical — no copy needed
-        }
-      }
-
-      copyFileSync(src, dest);
-      chmodSync(dest, 0o755);
-      result.copied++;
-      logger.info(`[HookSync] updated ${file}`);
-    } catch (err) {
-      logger.warn(`[HookSync] failed to sync ${file}: ${err instanceof Error ? err.message : String(err)}`);
-    }
-  }
-
-  if (result.copied > 0) {
-    logger.info(`[HookSync] synced ${result.copied}/${result.checked} hook files`);
-  }
-
-  return result;
-}

package/src/daemon/index.ts

@@ -1,312 +0,0 @@
-/**
- * Daemon entry point — starts the Forge daemon process
- *
- * Responsibilities:
- * 1. Load config and initialize logging
- * 2. Manage lifecycle (PID, socket, auth token)
- * 3. Initialize storage, AI provider, and core services
- * 4. Create event handlers and start socket server
- * 5. Handle graceful shutdown
- */
-
-import { SocketServer } from './server.js';
-import {
-  writePidFile,
-  removePidFile,
-  cleanSocket,
-  getSocketPath,
-  writeAuthToken,
-  syncMcpToken,
-  removeAuthToken,
-} from './lifecycle.js';
-import { routeEvent, type Handlers } from './router.js';
-import { logger } from '../core/utils/logger.js';
-import { ConfigManager } from '../core/config.js';
-import { SQLiteStorage } from '../core/storage/sqlite.js';
-import { expandPath } from '../core/utils/path.js';
-import { ClaudeProvider } from '../core/ai/provider.js';
-import { TaskSegmenter } from './services/task-segmenter.js';
-import { SkillRegistry } from '../skills/registry.js';
-import { InvocationGuard } from '../skills/invocation-guard.js';
-import { HistoryExporter } from './handlers/history-exporter.js';
-import { ResumeManager } from '../claudemd/resume-manager.js';
-import { ConventionExtractor } from '../claudemd/convention-extractor.js';
-import { UserPromptHandler } from './handlers/user-prompt.js';
-import { PostToolUseHandler } from './handlers/post-tool-use.js';
-import { StopHandler } from './handlers/stop.js';
-import { syncHooks } from './hook-sync.js';
-import { syncSkills } from './skill-sync.js';
-import { replayQueue } from '../core/queue/index.js';
-import { DEFAULTS } from '../core/constants.js';
-import type { ForgeEvent } from '../core/types.js';
-import { getUserPrompt } from '../core/event-fields.js';
-import type { HookResponse } from './server.js';
-
-export interface DaemonOptions {
-  /** Whether to enable the web server (default: use config value) */
-  web?: boolean;
-}
-
-export async function startDaemon(foreground: boolean = false, options: DaemonOptions = {}): Promise<void> {
-  // ── 0. Global Exception Handlers ───────────────────────────────────────────
-  process.on('uncaughtException', (err) => {
-    logger.error(`[Daemon] Uncaught exception: ${err.message}`);
-    logger.error(err.stack || '');
-    // Don't exit — let daemon continue running
-  });
-
-  process.on('unhandledRejection', (reason, promise) => {
-    logger.error(`[Daemon] Unhandled rejection at ${promise}: ${reason}`);
-  });
-
-  // ── 1. Config & Logging ────────────────────────────────────────────────────
-  // Log level is auto-parsed from LOG_LEVEL env var at logger module load time.
-  const config = new ConfigManager().get();
-  logger.info('Claude Forge daemon starting...');
-
-  // ── 2. Lifecycle (PID, socket, auth token) ─────────────────────────────────
-  cleanSocket();
-  writePidFile();
-  const authToken = writeAuthToken();
-  logger.info('[Security] Auth token generated');
-  syncMcpToken(authToken, config.web?.port ?? DEFAULTS.WEB_PORT);
-
-  // ── 3. Storage ─────────────────────────────────────────────────────────────
-  const dbPath = expandPath(config.storage.path);
-  const storage = new SQLiteStorage(dbPath);
-  logger.info(`Storage initialized: ${dbPath}`);
-
-  // ── 3.5. Auto-sync hooks ────────────────────────────────────────────────
-  // npm upgrade 不会自动更新 ~/.claude-forge/hooks/，每次 daemon 启动
-  // 用 SHA-256 比对源 dist/hooks 与本地副本，不一致则覆盖。
-  try {
-    syncHooks();
-  } catch (err) {
-    logger.warn(`[HookSync] unexpected error: ${err}`);
-  }
-
-  // ── 3.6. Auto-sync official skills ─────────────────────────────────────
-  // npm upgrade 不会自动更新 ~/.claude/skills/，每次 daemon 启动
-  // 用 SHA-256 比对 dist/skills/official 与本地副本，不一致则覆盖。
-  try {
-    syncSkills();
-  } catch (err) {
-    logger.warn(`[SkillSync] unexpected error: ${err}`);
-  }
-
-  // ── 4. AI Provider ─────────────────────────────────────────────────────────
-  const apiKey = config.ai.api_key || process.env.ANTHROPIC_API_KEY || '';
-  if (!apiKey) {
-    logger.warn('No API key configured — AI features disabled');
-  }
-
-  const ai = apiKey
-    ? new ClaudeProvider(apiKey, config.ai.model, config.ai.base_url)
-    : null;
-
-  // ── 5. Initialize services ─────────────────────────────────────────────────
-  const skillApiKey = config.skill_matching?.api_key || apiKey;
-  const skillRegistry = new SkillRegistry(skillApiKey, config.ai.model, config.ai.base_url);
-  const invocationGuard = new InvocationGuard();
-  if (skillApiKey) {
-    logger.info('[Skills] Registry loaded with semantic matching support');
-  } else {
-    logger.info('[Skills] Registry loaded (keyword matching)');
-  }
-  logger.info('[Skills] InvocationGuard ready (idempotent + depth/total limits)');
-
-  const exporter = new HistoryExporter(storage);
-  const resume = new ResumeManager(storage);
-  const conventionExtractor = new ConventionExtractor();
-  const taskSegmenter = new TaskSegmenter(storage);
-
-  logger.info('[Services] Initialized: ResumeManager, TaskSegmenter, SkillRegistry');
-
-  // ── 5.5. Schedule daily maintenance ────────────────────────────────────────
-  // Clean old events every 24 hours
-  const MAINTENANCE_INTERVAL = 24 * 60 * 60 * 1000; // 24 hours
-  const maintenanceInterval = setInterval(() => {
-    logger.info('[Daemon] Running daily maintenance: cleaning old events');
-    try {
-      storage.cleanOldEvents(30);
-    } catch (err) {
-      logger.error(`[Daemon] Maintenance failed: ${err}`);
-    }
-  }, MAINTENANCE_INTERVAL);
-  logger.info('[Daemon] Scheduled daily maintenance (clean events older than 30 days)');
-
-  // ── 5.6. Stale task GC (every 5 minutes) ──────────────────────────────────
-  const STALE_TASK_GC_INTERVAL = 5 * 60 * 1000; // 5 分钟
-  const STALE_TASK_IDLE_MINUTES = 10;            // idle 超 10 分钟视为滞留
-
-  const staleTaskGcInterval = setInterval(() => {
-    try {
-      const closed = storage.completeStaleActiveTasks(STALE_TASK_IDLE_MINUTES);
-      if (closed > 0) {
-        logger.info(`[Maintenance] Auto-completed ${closed} stale active task(s)`);
-      }
-    } catch (err) {
-      logger.error(`[Maintenance] Stale task GC failed: ${err}`);
-    }
-  }, STALE_TASK_GC_INTERVAL);
-
-  // ── 6. Create handlers ─────────────────────────────────────────────────────
-  const userPromptHandler = new UserPromptHandler(
-    resume,
-    conventionExtractor,
-    storage,
-    skillRegistry,
-  );
-
-  const handlers: Handlers = {
-    UserPromptSubmit: userPromptHandler,
-    PostToolUse: new PostToolUseHandler(storage),
-    Stop: new StopHandler(
-      exporter,
-      resume,
-      taskSegmenter,
-      storage,
-      invocationGuard,
-      userPromptHandler,
-    ),
-  };
-
-  // ── 7. Event handler ───────────────────────────────────────────────────────
-  const handleEvent = async (event: ForgeEvent): Promise<HookResponse | void> => {
-    try {
-      try {
-        storage.writeEvent(event);
-      } catch (writeErr) {
-        const writeMsg = writeErr instanceof Error ? writeErr.message : String(writeErr);
-        if (writeMsg.includes('UNIQUE constraint failed')) {
-          // Duplicate event_id — already in DB (e.g. replayed from queue then re-sent).
-          // Log at debug level and continue processing the event normally.
-          logger.debug(`[Event] Duplicate event_id ignored: ${event.event_id}`);
-        } else {
-          throw writeErr;
-        }
-      }
-      logger.debug(`[Event] ${event.hook_type} | tool=${event.tool_name ?? 'N/A'}`);
-
-      // Task segmentation: UserPromptSubmit starts/continues tasks
-      const prompt = getUserPrompt(event);
-      if (event.hook_type === 'UserPromptSubmit' && prompt) {
-        taskSegmenter.processPrompt(event.session_id, prompt, event.timestamp, event.event_id);
-      } else if (event.event_id) {
-        taskSegmenter.linkEvent(event.session_id, event.event_id);
-      }
-
-      // PreToolUse: always allow (governance removed)
-      if (event.hook_type === 'PreToolUse') {
-        return { allow: true };
-      }
-
-      const result = await routeEvent(event, handlers);
-
-      if (result) {
-        const handlerName = event.hook_type + 'Handler';
-        if (result.systemMessage) {
-          storage.writeInjection({
-            event_id: event.event_id,
-            session_id: event.session_id,
-            timestamp: event.timestamp,
-            source_handler: handlerName,
-            injection_type: 'systemMessage',
-            content: result.systemMessage,
-          });
-          const preview = result.systemMessage.slice(0, 200).replace(/\n/g, ' ');
-          console.error(`\x1b[36m[${handlerName}] systemMessage (${result.systemMessage.length} chars): ${preview}\x1b[0m`);
-        }
-        if (result.additionalContext) {
-          storage.writeInjection({
-            event_id: event.event_id,
-            session_id: event.session_id,
-            timestamp: event.timestamp,
-            source_handler: handlerName,
-            injection_type: 'additionalContext',
-            content: result.additionalContext,
-          });
-          const preview = result.additionalContext.slice(0, 200).replace(/\n/g, ' ');
-          console.error(`\x1b[36m[${handlerName}] additionalContext: ${preview}\x1b[0m`);
-        }
-      }
-
-      return result;
-    } catch (err) {
-      logger.error(`Event handling failed: ${err}`);
-      throw err;
-    }
-  };
-
-  // ── 8. Start socket server ─────────────────────────────────────────────────
-  const socketPath = getSocketPath();
-  const server = new SocketServer(socketPath, handleEvent, authToken);
-
-  // ── 8.1. Replay queued events (hook failures during daemon downtime) ────────
-  // Run after the socket is created so the daemon is ready to receive events.
-  // setImmediate ensures the event loop has had a chance to process the listen
-  // callback before we touch storage (not strictly required, but defensive).
-  setImmediate(() => {
-    replayQueue(storage).then(({ replayed, skipped, dead }) => {
-      if (replayed > 0 || skipped > 0 || dead > 0) {
-        logger.info(`[Queue] Replay: ${replayed} replayed, ${skipped} skipped (dup), ${dead} dead-lettered`);
-      }
-    }).catch((err) => {
-      logger.error(`[Queue] replayQueue failed: ${err}`);
-    });
-  });
-
-  // ── 8.5. Start web server (optional) ───────────────────────────────────────
-  // Priority: CLI option > env var > config file
-  const webEnabled = options.web ?? (process.env.FORGE_DAEMON_NO_WEB === '1' ? false : config.web.enabled);
-  let webServer: any = null;
-  if (webEnabled) {
-    const { WebServer } = await import('../web/server.js');
-    webServer = new WebServer({
-      port: config.web.port,
-      storage,
-      skillRegistry,
-      invocationGuard,
-    });
-    await webServer.start();
-  } else {
-    logger.info('[Web] Server disabled (--no-web or config.web.enabled=false)');
-  }
-
-  // ── 9. Graceful shutdown ───────────────────────────────────────────────────
-  let shuttingDown = false;
-  const shutdown = async () => {
-    if (shuttingDown) return;
-    shuttingDown = true;
-    logger.info('Shutting down...');
-
-    if (ai) logger.info(`[AI Stats] ${ai.formatStats()}`);
-
-    clearInterval(maintenanceInterval);
-    clearInterval(staleTaskGcInterval);
-    if (webServer) await webServer.stop();
-    await server.close();
-    storage.close();
-    removePidFile();
-    cleanSocket();
-    removeAuthToken();
-    process.exit(0);
-  };
-
-  process.on('SIGTERM', shutdown);
-  process.on('SIGINT', shutdown);
-
-  logger.info(`Daemon started (PID: ${process.pid})`);
-  if (foreground) {
-    process.stdout.write(`Claude Forge daemon running (PID: ${process.pid})\n`);
-    process.stdout.write('Press Ctrl+C to stop\n');
-  }
-}
-
-// Allow running as standalone script (spawned by `cf daemon start`)
-if (process.env.FORGE_DAEMON_FOREGROUND === '1') {
-  startDaemon(true).catch((err) => {
-    console.error('Daemon failed to start:', err);
-    process.exit(1);
-  });
-}

package/src/daemon/launchd/com.claude-forge.daemon.plist.template

@@ -1,47 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-    <key>Label</key>
-    <string>com.claude-forge.daemon</string>
-
-    <key>ProgramArguments</key>
-    <array>
-        <string>{{NODE_PATH}}</string>
-        <string>{{DAEMON_PATH}}</string>
-    </array>
-
-    <key>WorkingDirectory</key>
-    <string>{{HOME}}</string>
-
-    <key>EnvironmentVariables</key>
-    <dict>
-        <key>PATH</key>
-        <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
-        <key>NODE_ENV</key>
-        <string>production</string>
-        <key>FORGE_DAEMON_FOREGROUND</key>
-        <string>1</string>
-    </dict>
-
-    <key>RunAtLoad</key>
-    <true/>
-
-    <key>KeepAlive</key>
-    <dict>
-        <key>SuccessfulExit</key>
-        <false/>
-        <key>Crashed</key>
-        <true/>
-    </dict>
-
-    <key>ThrottleInterval</key>
-    <integer>10</integer>
-
-    <key>StandardOutPath</key>
-    <string>{{HOME}}/.claude-forge/daemon-stdout.log</string>
-
-    <key>StandardErrorPath</key>
-    <string>{{HOME}}/.claude-forge/daemon-stderr.log</string>
-</dict>
-</plist>