@jhihjian/claude-daemon 1.1.0

package/hooks/SessionRecorder.hook.ts

@@ -0,0 +1,202 @@
+#!/usr/bin/env bun
+/**
+ * SessionRecorder.hook.ts
+ * 在会话开始时记录上下文信息
+ *
+ * Hook 类型: SessionStart
+ * 触发时机: Claude Code 会话开始时
+ * 职责: 捕获启动目录、Git 信息、初始化会话文件
+ */
+
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { hostname } from 'os';
+import { createHookLogger } from '../lib/logger.ts';
+import {
+  hookErrorHandler,
+  withTimeout,
+  safeExecute,
+  validateRequired,
+  FileSystemError
+} from '../lib/errors.ts';
+import { config } from '../lib/config.ts';
+
+// ============================================================================
+// 初始化
+// ============================================================================
+
+const logger = createHookLogger('SessionRecorder');
+const cfg = config.get();
+
+// ============================================================================
+// 1. 读取 Hook 输入
+// ============================================================================
+
+const input = await Bun.stdin.text();
+const event = JSON.parse(input);
+
+// ============================================================================
+// 2. 核心逻辑
+// ============================================================================
+
+try {
+  const startTime = Date.now();
+
+  // 2.1 验证必需字段
+  const sessionId = validateRequired(event.session_id, 'session_id');
+  const timestamp = new Date().toISOString();
+
+  // 2.2 获取启动目录
+  const workingDir = process.cwd();
+  logger.info('Session started', { sessionId, workingDir });
+
+  // 2.3 获取 Git 信息（带超时）
+  const gitInfo = await safeExecute(
+    () => getGitInfo(workingDir, cfg.gitTimeout),
+    { repo: null, branch: null, commit: null, remote: null },
+    'getGitInfo'
+  );
+
+  // 2.4 创建存储目录
+  const yearMonth = config.getYearMonth();
+  const rawDir = join(cfg.rawDir, yearMonth);
+
+  try {
+    mkdirSync(rawDir, { recursive: true });
+  } catch (error) {
+    throw new FileSystemError(
+      `Failed to create directory: ${rawDir}`,
+      rawDir,
+      'mkdir'
+    );
+  }
+
+  // 2.5 构建会话元数据
+  const sessionMeta = {
+    event_type: 'session_start',
+    session_id: sessionId,
+    timestamp: timestamp,
+
+    // 工作上下文
+    working_directory: workingDir,
+    git_repo: gitInfo.repo,
+    git_branch: gitInfo.branch,
+    git_commit: gitInfo.commit,
+    git_remote: gitInfo.remote,
+
+    // 环境信息
+    platform: process.platform,
+    cwd_at_start: workingDir,
+    user: process.env.USER || process.env.USERNAME || 'unknown',
+    hostname: hostname(),
+
+    // 运行时信息
+    bun_version: Bun.version,
+    node_version: process.version,
+    shell: process.env.SHELL || 'unknown',
+    terminal: process.env.TERM || 'unknown',
+
+    // 元数据
+    claude_version: event.claude_version || 'unknown',
+  };
+
+  // 2.6 写入会话文件（JSONL 格式）
+  const sessionFile = config.getSessionFilePath(sessionId, yearMonth);
+
+  try {
+    writeFileSync(sessionFile, JSON.stringify(sessionMeta) + '\n', { mode: 0o600 });
+    logger.debug('Session file created', { sessionFile });
+  } catch (error) {
+    throw new FileSystemError(
+      `Failed to write session file: ${sessionFile}`,
+      sessionFile,
+      'write'
+    );
+  }
+
+  // 2.7 记录性能
+  logger.perf('SessionRecorder', startTime);
+  logger.info('Session recorded successfully', {
+    sessionId,
+    hostname: hostname(),
+    user: sessionMeta.user,
+    gitRepo: gitInfo.repo || 'none',
+  });
+
+} catch (error) {
+  // 错误处理：永远不阻塞 Claude Code
+  hookErrorHandler('SessionRecorder')(error);
+}
+
+// ============================================================================
+// 3. 输出决策（必须）
+// ============================================================================
+
+console.log(JSON.stringify({ continue: true }));
+process.exit(0);
+
+// ============================================================================
+// 辅助函数
+// ============================================================================
+
+interface GitInfo {
+  repo: string | null;
+  branch: string | null;
+  commit: string | null;
+  remote: string | null;
+}
+
+/**
+ * 获取所有 Git 信息（带超时）
+ */
+async function getGitInfo(dir: string, timeout: number): Promise<GitInfo> {
+  const commands = {
+    repo: ['git', 'rev-parse', '--show-toplevel'],
+    branch: ['git', 'rev-parse', '--abbrev-ref', 'HEAD'],
+    commit: ['git', 'rev-parse', '--short', 'HEAD'],
+    remote: ['git', 'remote', 'get-url', 'origin'],
+  };
+
+  const results = await Promise.all(
+    Object.entries(commands).map(async ([key, cmd]) => {
+      try {
+        const result = await withTimeout(
+          execGitCommand(cmd, dir),
+          timeout,
+          `git ${cmd[1]}`
+        );
+        return [key, result];
+      } catch (error) {
+        logger.debug(`Git command failed: ${cmd.join(' ')}`, {
+          error: error instanceof Error ? error.message : String(error),
+        });
+        return [key, null];
+      }
+    })
+  );
+
+  return Object.fromEntries(results) as GitInfo;
+}
+
+/**
+ * 执行 Git 命令
+ */
+async function execGitCommand(cmd: string[], dir: string): Promise<string | null> {
+  try {
+    const proc = Bun.spawn(cmd, {
+      cwd: dir,
+      stdout: 'pipe',
+      stderr: 'pipe',
+    });
+
+    const output = await new Response(proc.stdout).text();
+    await proc.exited;
+
+    if (proc.exitCode === 0) {
+      return output.trim();
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}

package/hooks/SessionToolCapture-v2.hook.ts

@@ -0,0 +1,231 @@
+#!/usr/bin/env bun
+/**
+ * SessionToolCapture-v2.hook.ts
+ * 从 transcript 读取完整的工具输出
+ *
+ * Hook 类型: PostToolUse
+ * 触发时机: 工具调用完成后
+ * 职责: 记录工具调用的输入、输出和状态
+ */
+
+import { appendFileSync, existsSync, readFileSync } from 'fs';
+import { createHookLogger } from '../lib/logger.ts';
+import {
+  hookErrorHandler,
+  withTimeout,
+  safeJSONParse,
+  validateRequired,
+  FileSystemError
+} from '../lib/errors.ts';
+import { config } from '../lib/config.ts';
+
+// ============================================================================
+// 初始化
+// ============================================================================
+
+const logger = createHookLogger('SessionToolCapture');
+const cfg = config.get();
+
+// ============================================================================
+// 1. 读取 Hook 输入
+// ============================================================================
+
+const input = await Bun.stdin.text();
+const event = JSON.parse(input);
+
+// ============================================================================
+// 2. 核心逻辑
+// ============================================================================
+
+try {
+  const startTime = Date.now();
+
+  // 2.1 验证必需字段
+  const sessionId = validateRequired(event.session_id, 'session_id');
+  const toolName = validateRequired(event.tool_name, 'tool_name');
+  const timestamp = new Date().toISOString();
+  const yearMonth = config.getYearMonth();
+
+  // 2.2 定位会话文件
+  const sessionFile = config.getSessionFilePath(sessionId, yearMonth);
+
+  if (!existsSync(sessionFile)) {
+    logger.warn('Session file not found', { sessionFile, sessionId });
+    console.log(JSON.stringify({ continue: true }));
+    process.exit(0);
+  }
+
+  // 2.3 提取工具输出和成功状态
+  let toolOutput = '';
+  let toolSuccess = false;
+
+  // 优先从 tool_response 字段获取（直接可用）
+  if (event.tool_response) {
+    const response = event.tool_response;
+
+    // 合并 stdout 和 stderr
+    const stdout = response.stdout || '';
+    const stderr = response.stderr || '';
+    toolOutput = stdout + (stderr ? '\n[stderr]\n' + stderr : '');
+
+    // 判断成功：没有中断且没有错误
+    toolSuccess = !response.interrupted && !response.is_error;
+
+    logger.debug('Tool output from tool_response', {
+      toolName,
+      outputLength: toolOutput.length,
+      success: toolSuccess,
+    });
+  }
+  // 备用方案：从 transcript 读取
+  else if (event.transcript_path && existsSync(event.transcript_path)) {
+    try {
+      const result = await withTimeout(
+        readToolResultFromTranscript(event.transcript_path, event.tool_use_id),
+        cfg.hookTimeout,
+        'readToolResultFromTranscript'
+      );
+      toolOutput = result.output;
+      toolSuccess = result.success;
+
+      logger.debug('Tool output from transcript', {
+        toolName,
+        outputLength: toolOutput.length,
+        success: toolSuccess,
+      });
+    } catch (error) {
+      logger.warn('Failed to read from transcript', {
+        error: error instanceof Error ? error.message : String(error),
+        transcriptPath: event.transcript_path,
+      });
+    }
+  }
+
+  // 2.4 构建工具事件
+  const toolEvent = {
+    event_type: 'tool_use',
+    session_id: sessionId,
+    timestamp: timestamp,
+    tool_name: toolName,
+    tool_use_id: event.tool_use_id,
+
+    // 工具输入
+    tool_input: event.tool_input || {},
+
+    // 工具输出（截断到配置的最大长度）
+    tool_output: truncateOutput(toolOutput, cfg.maxOutputLength),
+
+    // 状态
+    success: toolSuccess,
+
+    // 额外信息
+    duration_ms: event.duration_ms || null,
+  };
+
+  // 2.5 追加到 JSONL 文件
+  try {
+    appendFileSync(sessionFile, JSON.stringify(toolEvent) + '\n');
+  } catch (error) {
+    throw new FileSystemError(
+      `Failed to append to session file: ${sessionFile}`,
+      sessionFile,
+      'append'
+    );
+  }
+
+  // 2.6 提取文件修改信息
+  if (toolName === 'Edit' || toolName === 'Write') {
+    const filePath = event.tool_input?.file_path;
+    if (filePath) {
+      logger.info('File modified', { filePath, toolName });
+    }
+  }
+
+  // 2.7 记录性能
+  logger.perf('SessionToolCapture', startTime);
+
+} catch (error) {
+  hookErrorHandler('SessionToolCapture')(error);
+}
+
+// ============================================================================
+// 3. 输出决策
+// ============================================================================
+
+console.log(JSON.stringify({ continue: true }));
+process.exit(0);
+
+// ============================================================================
+// 辅助函数
+// ============================================================================
+
+/**
+ * 从 transcript 读取工具结果
+ */
+async function readToolResultFromTranscript(
+  transcriptPath: string,
+  toolUseId: string
+): Promise<{ output: string; success: boolean }> {
+  try {
+    const content = readFileSync(transcriptPath, 'utf-8');
+    const lines = content.trim().split('\n');
+
+    for (const line of lines) {
+      const entry = safeJSONParse<any>(line, null, 'transcript line');
+      if (!entry) continue;
+
+      // 查找 tool_result 消息
+      if (entry.type === 'message' && entry.role === 'user') {
+        for (const block of entry.content || []) {
+          if (block.type === 'tool_result' && block.tool_use_id === toolUseId) {
+            // 提取输出
+            let output = '';
+            if (typeof block.content === 'string') {
+              output = block.content;
+            } else if (Array.isArray(block.content)) {
+              output = block.content
+                .filter(c => c.type === 'text')
+                .map(c => c.text)
+                .join('\n');
+            }
+
+            return {
+              output,
+              success: !block.is_error,
+            };
+          }
+        }
+      }
+    }
+
+    return { output: '', success: false };
+  } catch (error) {
+    logger.error('Error reading transcript', {
+      error: error instanceof Error ? error.message : String(error),
+      transcriptPath,
+    });
+    return { output: '', success: false };
+  }
+}
+
+/**
+ * 截断输出到指定长度
+ */
+function truncateOutput(output: any, maxLength: number): any {
+  if (typeof output === 'string') {
+    if (output.length > maxLength) {
+      return output.slice(0, maxLength) + '\n... (truncated)';
+    }
+    return output;
+  }
+
+  if (typeof output === 'object' && output !== null) {
+    const json = JSON.stringify(output);
+    if (json.length > maxLength) {
+      return json.slice(0, maxLength) + '... (truncated)';
+    }
+    return output;
+  }
+
+  return output;
+}

package/hooks/SessionToolCapture.hook.ts

@@ -0,0 +1,119 @@
+#!/usr/bin/env bun
+/**
+ * SessionToolCapture.hook.ts
+ * 在每次工具调用后记录操作
+ *
+ * Hook 类型: PostToolUse
+ * 触发时机: 每次工具调用后
+ * 职责: 捕获工具名称、输入、输出、成功状态
+ */
+
+import { appendFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// ============================================================================
+// 1. 读取 Hook 输入
+// ============================================================================
+
+const input = await Bun.stdin.text();
+const event = JSON.parse(input);
+
+// 调试：记录实际接收到的事件结构
+console.error('[SessionToolCapture] Received event:', JSON.stringify(event, null, 2));
+
+// ============================================================================
+// 2. 核心逻辑
+// ============================================================================
+
+try {
+  const paiDir = process.env.PAI_DIR || join(homedir(), '.claude');
+  const sessionId = event.session_id;
+  const timestamp = new Date().toISOString();
+  const yearMonth = timestamp.slice(0, 7);
+
+  // 2.1 定位会话文件
+  const sessionFile = join(paiDir, 'SESSIONS/raw', yearMonth, `session-${sessionId}.jsonl`);
+
+  // 2.2 检查文件是否存在
+  if (!existsSync(sessionFile)) {
+    console.error(`[SessionToolCapture] Session file not found: ${sessionFile}`);
+    console.log(JSON.stringify({ continue: true }));
+    process.exit(0);
+  }
+
+  // 2.3 构建工具事件
+  const toolEvent = {
+    event_type: 'tool_use',
+    session_id: sessionId,
+    timestamp: timestamp,
+    tool_name: event.tool_name,
+
+    // 工具输入（完整保留）
+    tool_input: event.tool_input || {},
+
+    // 工具输出（截断到 5000 字符）
+    // PostToolUse hook 可能不包含 tool_output，使用 result 或其他字段
+    tool_output: truncateOutput(event.tool_output || event.result || event.output || '', 5000),
+
+    // 状态
+    // PostToolUse hook 可能不包含 tool_use_status，尝试其他可能的字段
+    success: event.tool_use_status === 'success' || event.success === true || event.status === 'success',
+    status: event.tool_use_status || event.status || 'unknown',
+
+    // 额外信息
+    duration_ms: event.duration_ms || null,
+
+    // 调试：保留原始事件的所有字段（可选）
+    _raw_event_keys: Object.keys(event),
+  };
+
+  // 2.4 追加到 JSONL 文件
+  // 使用 appendFileSync 保证原子性
+  appendFileSync(sessionFile, JSON.stringify(toolEvent) + '\n');
+
+  // 2.5 可选：提取文件修改信息
+  if (event.tool_name === 'Edit' || event.tool_name === 'Write') {
+    const filePath = event.tool_input?.file_path;
+    if (filePath) {
+      console.error(`[SessionToolCapture] File modified: ${filePath}`);
+    }
+  }
+
+} catch (error) {
+  console.error('[SessionToolCapture] Error:', error);
+}
+
+// ============================================================================
+// 3. 输出决策
+// ============================================================================
+
+console.log(JSON.stringify({ continue: true }));
+process.exit(0);
+
+// ============================================================================
+// 辅助函数
+// ============================================================================
+
+/**
+ * 截断输出到指定长度
+ */
+function truncateOutput(output: any, maxLength: number): any {
+  if (typeof output === 'string') {
+    if (output.length > maxLength) {
+      return output.slice(0, maxLength) + '\n... (truncated)';
+    }
+    return output;
+  }
+
+  // 如果是对象，转为 JSON 后截断
+  if (typeof output === 'object' && output !== null) {
+    const json = JSON.stringify(output);
+    if (json.length > maxLength) {
+      return json.slice(0, maxLength) + '... (truncated)';
+    }
+    return output;
+  }
+
+  return output;
+}