@bbyx0011/ghostcode 0.1.0

package/scripts/lib/daemon-client.mjs

@@ -0,0 +1,165 @@
+/**
+ * @file scripts/lib/daemon-client.mjs
+ * @description Daemon Unix Socket IPC 客户端
+ *              供所有 Hook 脚本共用的 Daemon 通信工具库。
+ *
+ *              通信协议：
+ *              1. 读取 ~/.ghostcode/daemon/ghostcoded.addr.json 获取 socket 路径
+ *              2. 发送 NDJSON 请求：{"v":1,"op":"<op>","args":{...}}\n
+ *              3. 读取一行 JSON 响应
+ *              4. 超时 2000ms，addr.json 不存在时返回 null
+ *
+ *              参考: ghostcode-types/src/ipc.rs - DaemonRequest/DaemonResponse 协议定义
+ * @author Atlas.oi
+ * @date 2026-03-06
+ */
+
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { createConnection } from "node:net";
+
+// ============================================
+// 常量配置
+// ============================================
+
+// GhostCode 主目录，支持环境变量覆盖（主要用于测试隔离）
+const GHOSTCODE_HOME = process.env.GHOSTCODE_HOME || join(homedir(), ".ghostcode");
+
+// Daemon 地址文件路径（Daemon 启动时写入，包含 socket 路径）
+const ADDR_FILE = join(GHOSTCODE_HOME, "daemon", "ghostcoded.addr.json");
+
+// IPC 请求超时时间（毫秒）
+// 设为 2000ms，与 stdin.mjs 的超时对齐，确保在 Hook 外层超时（5s）前完成
+const IPC_TIMEOUT_MS = 2000;
+
+// ============================================
+// 核心 IPC 函数
+// ============================================
+
+/**
+ * 向 Daemon 发送 IPC 请求并等待响应
+ *
+ * 业务逻辑说明：
+ * 1. 读取 addr.json 获取 Unix Socket 路径
+ * 2. 建立 Socket 连接
+ * 3. 发送 NDJSON 格式请求（一行 JSON + 换行符）
+ * 4. 读取一行 JSON 响应
+ * 5. 解析并返回 DaemonResponse
+ *
+ * addr.json 不存在或 Socket 连接失败时返回 null（Daemon 未运行）
+ * Hook 脚本调用方应检查返回值是否为 null
+ *
+ * @param {string} op - 操作名称（如 "actor_start", "actor_stop", "send", "ping"）
+ * @param {object} args - 操作参数（任意 JSON 对象）
+ * @returns {Promise<object|null>} DaemonResponse 对象（{v, ok, result, error}），或 null（Daemon 不可达）
+ *
+ * @example
+ * const resp = await callDaemon("actor_start", { group_id: "g-xxx", actor_id: "agent-1" });
+ * if (resp?.ok) {
+ *   console.log("Actor 注册成功");
+ * }
+ */
+export async function callDaemon(op, args = {}) {
+  // ============================================
+  // 第一步：读取 Daemon 地址文件
+  // addr.json 由 Daemon 启动时写入，包含 socket 路径
+  // 不存在 = Daemon 未运行，返回 null
+  // ============================================
+  let socketPath;
+  try {
+    if (!existsSync(ADDR_FILE)) {
+      return null;
+    }
+    const addrData = JSON.parse(readFileSync(ADDR_FILE, "utf-8"));
+    socketPath = addrData.path;
+    if (!socketPath) {
+      return null;
+    }
+  } catch {
+    // addr.json 读取/解析失败，视为 Daemon 不可达
+    return null;
+  }
+
+  // ============================================
+  // 第二步：构造 NDJSON 请求
+  // 协议格式：{"v":1,"op":"<op>","args":{...}}\n
+  // 参考: ghostcode-types/src/ipc.rs:21 - DaemonRequest 结构
+  // ============================================
+  const request = JSON.stringify({ v: 1, op, args }) + "\n";
+
+  // ============================================
+  // 第三步：通过 Unix Socket 发送请求并接收响应
+  // 使用 Promise 包裹 net.createConnection，带超时保护
+  // ============================================
+  return new Promise((resolve) => {
+    let settled = false;
+    let responseData = "";
+
+    /**
+     * 安全 resolve：防止多次 resolve（超时 + 正常响应竞争）
+     *
+     * @param {object|null} value - 要 resolve 的值
+     */
+    function safeResolve(value) {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      socket.destroy();
+      resolve(value);
+    }
+
+    // 创建 Unix Socket 连接
+    const socket = createConnection({ path: socketPath }, () => {
+      // 连接建立后发送请求
+      socket.write(request);
+    });
+
+    socket.setEncoding("utf-8");
+
+    // 累积响应数据，遇到换行符表示完整响应到达
+    socket.on("data", (chunk) => {
+      responseData += chunk;
+
+      // NDJSON 协议：一行 = 一个完整响应
+      const newlineIdx = responseData.indexOf("\n");
+      if (newlineIdx !== -1) {
+        const line = responseData.slice(0, newlineIdx).trim();
+        try {
+          const parsed = JSON.parse(line);
+          safeResolve(parsed);
+        } catch {
+          // 响应解析失败，返回 null
+          safeResolve(null);
+        }
+      }
+    });
+
+    // 连接错误（Daemon 已停止、socket 文件残留等）
+    socket.on("error", () => {
+      safeResolve(null);
+    });
+
+    // 连接关闭但未收到完整响应
+    socket.on("end", () => {
+      if (!settled) {
+        // 尝试解析已收到的数据（可能没有换行符结尾）
+        const trimmed = responseData.trim();
+        if (trimmed) {
+          try {
+            safeResolve(JSON.parse(trimmed));
+            return;
+          } catch {
+            // 解析失败，返回 null
+          }
+        }
+        safeResolve(null);
+      }
+    });
+
+    // 超时保护：2000ms 后若仍未收到响应，返回 null
+    const timer = setTimeout(() => {
+      safeResolve(null);
+    }, IPC_TIMEOUT_MS);
+  });
+}

package/scripts/lib/stdin.mjs

@@ -0,0 +1,88 @@
+/**
+ * @file scripts/lib/stdin.mjs
+ * @description stdin 读取共享工具库
+ *              提供带超时防抖的 readStdin 函数，供所有 Hook 脚本共用。
+ *
+ *              设计要点：
+ *              1. settled 标志防止 Promise 被多次 resolve（end 事件 + 超时竞争）
+ *              2. 超时设为 2000ms（小于 hooks.json 的 5s），留出余量
+ *              3. end 触发后立即 clearTimeout，避免超时误触发
+ *              4. 出错时 reject，调用方应 try-catch
+ * @author Atlas.oi
+ * @date 2026-03-05
+ */
+
+/**
+ * 从 process.stdin 读取完整输入，带超时保护和防抖机制
+ *
+ * 业务逻辑说明：
+ * 1. 监听 data 事件，累积所有分块数据
+ * 2. 监听 end 事件，触发 resolve 并清除超时定时器
+ * 3. 监听 error 事件，触发 reject
+ * 4. 2000ms 超时兜底：即使 end 未到达，也返回已收到的数据
+ * 5. settled 标志确保 Promise 只 resolve/reject 一次（防止竞争条件）
+ *
+ * @returns {Promise<string>} stdin 的完整文本内容
+ */
+export function readStdin() {
+  return new Promise((resolve, reject) => {
+    // 已结算标志：防止 end 事件和超时同时 resolve，导致回调执行两次
+    let settled = false;
+
+    // 累积的输入数据缓冲区
+    let data = "";
+
+    /**
+     * 安全 resolve：检查 settled 标志后再 resolve
+     * 同时清除超时定时器，防止后续误触发
+     *
+     * @param {string} value - 要 resolve 的值
+     */
+    function safeResolve(value) {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve(value);
+    }
+
+    /**
+     * 安全 reject：检查 settled 标志后再 reject
+     *
+     * @param {Error} err - 要 reject 的错误
+     */
+    function safeReject(err) {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      reject(err);
+    }
+
+    // ============================================
+    // 设置字符编码为 UTF-8，确保中文等多字节字符正确处理
+    // ============================================
+    process.stdin.setEncoding("utf-8");
+
+    // 监听数据块：累积到 data 缓冲区
+    process.stdin.on("data", (chunk) => {
+      data += chunk;
+    });
+
+    // 监听 end 事件：stdin 关闭，返回完整数据
+    process.stdin.on("end", () => {
+      safeResolve(data);
+    });
+
+    // 监听 error 事件：stdin 读取出错，reject Promise
+    process.stdin.on("error", (err) => {
+      safeReject(err);
+    });
+
+    // ============================================
+    // 超时兜底：2000ms 后若 Promise 仍未结算，返回已收到的数据
+    // 设为 2000ms 而非 hooks.json 的 5s，确保在外层超时前完成
+    // ============================================
+    const timer = setTimeout(() => {
+      safeResolve(data);
+    }, 2000);
+  });
+}

package/scripts/run.mjs

@@ -0,0 +1,98 @@
+/**
+ * @file scripts/run.mjs
+ * @description GhostCode Hook 统一脚本运行器
+ *              接收目标脚本路径参数，统一处理环境变量注入、路径解析、错误处理和超时保护。
+ *              由 hooks.json 中的命令调用，格式：
+ *              node "${CLAUDE_PLUGIN_ROOT}/scripts/run.mjs" "${CLAUDE_PLUGIN_ROOT}/scripts/hook-xxx.mjs"
+ *
+ *              参考: oh-my-claudecode/scripts/run.cjs - 跨平台 Hook 运行器
+ * @author Atlas.oi
+ * @date 2026-03-05
+ */
+
+import { spawnSync } from "node:child_process";
+import { existsSync, realpathSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+
+// 当前脚本所在目录（ESM 中没有 __dirname，需要手动计算）
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 脚本超时时间（毫秒）：防止 Hook 脚本挂起阻塞 Claude Code
+const SCRIPT_TIMEOUT_MS = 30_000;
+
+// ============================================
+// 第一步：获取目标脚本路径
+// ============================================
+const target = process.argv[2];
+if (!target) {
+  // 无参数时静默退出，不阻断 Claude Code hooks
+  process.exit(0);
+}
+
+// ============================================
+// 第二步：解析目标脚本路径
+// 处理 symlink 和路径不存在的边界情况
+// ============================================
+function resolveTarget(targetPath) {
+  // 快速路径：目标直接存在
+  if (existsSync(targetPath)) return targetPath;
+
+  // 尝试 symlink 解析
+  try {
+    const resolved = realpathSync(targetPath);
+    if (existsSync(resolved)) return resolved;
+  } catch {
+    // realpathSync 在路径不存在时抛异常，预期行为
+  }
+
+  return null;
+}
+
+const resolved = resolveTarget(target);
+if (!resolved) {
+  // 目标脚本不存在，静默退出不阻断 hooks
+  process.exit(0);
+}
+
+// ============================================
+// 第三步：注入环境变量
+// ============================================
+const env = { ...process.env };
+
+// CLAUDE_PLUGIN_ROOT：从当前脚本路径推导（scripts/ 的父目录）
+if (!env.CLAUDE_PLUGIN_ROOT) {
+  env.CLAUDE_PLUGIN_ROOT = resolve(__dirname, "..");
+}
+
+// GHOSTCODE_HOME：GhostCode 数据目录，默认 ~/.ghostcode
+if (!env.GHOSTCODE_HOME) {
+  env.GHOSTCODE_HOME = resolve(homedir(), ".ghostcode");
+}
+
+// ============================================
+// 第四步：执行目标脚本
+// 使用 spawnSync 同步执行，继承 stdio 流
+// ============================================
+// stdio 使用数组形式显式指定三个流，确保子进程能读取父进程 stdin
+// - stdin (fd 0): "inherit" — 父进程 stdin 透传给子进程，使 hook 脚本能通过 readStdin 读取事件 JSON
+// - stdout (fd 1): "inherit" — 子进程输出直接写入父进程 stdout，供 Claude Code 读取 Hook 响应
+// - stderr (fd 2): "inherit" — 子进程错误直接写入父进程 stderr，便于调试
+const result = spawnSync(
+  process.execPath,
+  [resolved, ...process.argv.slice(3)],
+  {
+    stdio: ["inherit", "inherit", "inherit"],
+    env,
+    timeout: SCRIPT_TIMEOUT_MS,
+    windowsHide: true,
+  }
+);
+
+// ============================================
+// 第五步：传播退出码
+// null（超时或信号终止）时返回 0，避免阻断 hooks
+// ============================================
+process.exit(result.status ?? 0);