ronds_ai 0.1.21 → 0.1.23

package/lib/hooks_auto_sync.js

@@ -19,7 +19,8 @@ const { spawn } = require('child_process');
 // ---------------------------------------------------------------------------
 
 /** 当前 hooks schema 版本。当用户级 hooks deploy 输出发生变化时 +1。 */
-const HOOKS_SCHEMA_VERSION = 1;
+// v2: 用户级 Claude settings 新增 Stop/SessionEnd analyze hook。
+const HOOKS_SCHEMA_VERSION = 2;
 
 /** sentinel 有效时长：24 小时 */
 const HOOKS_AUTO_SYNC_CHECK_TTL_MS = 24 * 60 * 60 * 1000;

package/lib/hooks_deploy.js

@@ -6,6 +6,8 @@ const yaml = require('js-yaml');
 
 const CURSOR_COMMAND = 'npx ronds_ai@latest record cursor';
 const CLAUDE_COMMAND = 'npx ronds_ai@latest record claude';
+const CLAUDE_ANALYZE_COMMAND = 'npx ronds_ai@latest analyze claude';
+const CLAUDE_ANALYZE_EVENTS = ['Stop', 'SessionEnd'];
 const CODEX_COMMAND = 'npx ronds_ai@latest record codex';
 const CURSOR_OLD_COMMAND = 'node .cursor/hooks/cursor_hook_request.cjs';
 const CURSOR_OLD_JS_COMMAND = 'node .cursor/hooks/cursor_hook_request.js';
@@ -216,6 +218,77 @@ function removeClaudeHookFromConfig(config) {
   return next;
 }
 
+/**
+ * 解析 Node.js 主版本号，解析失败返回 0。
+ * @param {string} version - Node.js 版本字符串
+ * @returns {number}
+ */
+function getNodeMajorVersion(version = process.versions.node) {
+  const major = Number(String(version || '').replace(/^v/i, '').split('.')[0]);
+  return Number.isInteger(major) ? major : 0;
+}
+
+/**
+ * 从单个 Claude hook 事件数组中抽离本工具管理的 analyze 命令。
+ * 保留用户在该事件下的其他 entry；analyze 所在 entry 的其余命令会合并到结果中。
+ *
+ * @param {Array} entries - hooks[event] 数组
+ * @returns {{ keepEntries: Array, desiredHooks: Array }}
+ */
+function splitClaudeAnalyzeEntries(entries) {
+  const keepEntries = [];
+  const desiredHooks = [];
+
+  for (const entry of entries) {
+    if (!isPlainObject(entry)) {
+      keepEntries.push(entry);
+      continue;
+    }
+
+    const existingHooks = Array.isArray(entry.hooks) ? entry.hooks : [];
+    const containsAnalyze = existingHooks.some(
+      (hook) => isPlainObject(hook) && hook.type === 'command' && hook.command === CLAUDE_ANALYZE_COMMAND,
+    );
+
+    if (!containsAnalyze) {
+      keepEntries.push(entry);
+      continue;
+    }
+
+    for (const hook of existingHooks) {
+      if (!(isPlainObject(hook) && hook.type === 'command' && hook.command === CLAUDE_ANALYZE_COMMAND)) {
+        desiredHooks.push(hook);
+      }
+    }
+  }
+
+  return { keepEntries, desiredHooks };
+}
+
+/**
+ * 在 Claude settings 中确保 Stop/SessionEnd 的 analyze hook 条目。
+ * 只管理命令完全等于 CLAUDE_ANALYZE_COMMAND 的 hook，保留用户自定义条目。
+ */
+function ensureClaudeAnalyzeHooks(config) {
+  const next = isPlainObject(config) ? { ...config } : {};
+  const hooks = isPlainObject(next.hooks) ? { ...next.hooks } : {};
+
+  for (const eventName of CLAUDE_ANALYZE_EVENTS) {
+    const entries = Array.isArray(hooks[eventName]) ? hooks[eventName] : [];
+    const { keepEntries, desiredHooks } = splitClaudeAnalyzeEntries(entries);
+
+    desiredHooks.push({
+      type: 'command',
+      command: CLAUDE_ANALYZE_COMMAND,
+    });
+
+    hooks[eventName] = keepEntries.concat([{ hooks: desiredHooks }]);
+  }
+
+  next.hooks = hooks;
+  return next;
+}
+
 function ensureCodexHooksFeatureFlag(toml) {
   const newline = toml.includes('\r\n') ? '\r\n' : '\n';
   const desiredLine = `hooks = true${newline}`;
@@ -511,9 +584,28 @@ function deployCursorHook(cursorPath, result) {
   recordWriteResult(cursorPath, cursorResult.exists, changed, result);
 }
 
-function deployClaudeSettings(claudeSettingsPath, result) {
+/**
+ * 判断本次部署是否写入 Claude analyze hook。
+ * 不满足条件时把原因写入 result.analyze.reason 并返回 false。
+ */
+function shouldDeployClaudeAnalyze(result) {
+  const nodeMajor = getNodeMajorVersion();
+  if (nodeMajor < 20) {
+    result.analyze.reason = `analyze requires Node.js 20 or newer; current is ${process.versions.node || 'unknown'}`;
+    return false;
+  }
+
+  return true;
+}
+
+function deployClaudeSettings(claudeSettingsPath, result, analyzeDeployed) {
   const claudeSettingsResult = readJsonFile(claudeSettingsPath, {});
-  const nextClaudeSettings = ensureClaudeSettings(claudeSettingsResult.data);
+  let nextClaudeSettings = ensureClaudeSettings(claudeSettingsResult.data);
+
+  if (analyzeDeployed) {
+    nextClaudeSettings = ensureClaudeAnalyzeHooks(nextClaudeSettings);
+  }
+
   const changed = writeJsonFile(claudeSettingsPath, nextClaudeSettings);
   recordWriteResult(claudeSettingsPath, claudeSettingsResult.exists, changed, result);
 }
@@ -574,6 +666,12 @@ function deployHooks(targetDir = process.cwd(), options = {}) {
     updatedFiles: [],
     createdFiles: [],
     skipped: [],
+    analyze: {
+      tool: 'claude',
+      installed: false,
+      events: [],
+      command: CLAUDE_ANALYZE_COMMAND,
+    },
   };
 
   cleanupLegacyHookScripts(paths.configRoot, result, options.tool);
@@ -585,9 +683,15 @@ function deployHooks(targetDir = process.cwd(), options = {}) {
   }
 
   if (!options.tool || options.tool === 'claude') {
-    deployClaudeSettings(paths.claudeSettingsPath, result);
+    const analyzeDeployed = shouldDeployClaudeAnalyze(result);
+    deployClaudeSettings(paths.claudeSettingsPath, result, analyzeDeployed);
+    if (analyzeDeployed) {
+      result.analyze.installed = true;
+      result.analyze.events = [...CLAUDE_ANALYZE_EVENTS];
+    }
   } else {
     result.skipped.push({ tool: 'claude', reason: 'Skipped by --tool filter' });
+    result.analyze.reason = 'Skipped by --tool filter';
   }
 
   if (options.tool && options.tool !== 'codex') {
@@ -683,4 +787,6 @@ function deployHermesHook() {
 module.exports = {
   deployHooks,
   deployHermesHook,
+  ensureClaudeAnalyzeHooks,
+  getNodeMajorVersion,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ronds_ai",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "CLI for reporting AI code edit events.",
   "bin": {
     "ronds_ai": "bin/ronds_ai.js"
@@ -12,9 +12,17 @@
   "engines": {
     "node": ">=16"
   },
+  "scripts": {
+    "test": "node --test"
+  },
   "dependencies": {
     "comment-json": "^4.2.5",
-    "js-yaml": "^5.1.0"
+    "js-yaml": "^5.2.2"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "optionalDependencies": {
+    "@langfuse/otel": "^5.9.1",
+    "@langfuse/tracing": "^5.9.1",
+    "@opentelemetry/sdk-node": "^0.221.0"
+  }
 }