@raindrop-ai/claude-code 0.0.6 → 0.0.7

package/README.md

@@ -16,6 +16,8 @@ raindrop-claude-code setup
 
 This saves your write key and configures Claude Code hooks. Every session will now send telemetry to your [Raindrop dashboard](https://app.raindrop.ai).
 
+Hooks are **synchronous by default** for headless/one-shot compatibility (`claude -p`). Use `--async` if you prefer non-blocking hooks in interactive mode.
+
 ## What gets tracked
 
 - Every prompt turn as a separate event, grouped by session
@@ -24,27 +26,50 @@ This saves your write key and configures Claude Code hooks. Every session will n
 - Model name, service tier, and stop reason
 - CLAUDE.md and rules file contents
 - `--append-system-prompt` / `--append-system-prompt-file` content (best-effort)
-- Self-diagnostics — agent-reported issues via MCP tool, with customizable signal categories
 - Subagent spawns and completions
 - Permission denials and context compaction
+- Self-diagnostics — agent-reported issues via MCP tool, with customizable signal categories
 - Nested trace view (tools under root, subagent tools under subagent)
 - Claude's responses and errors
 
+## Custom Properties
+
+Tag events with product names or custom metadata via `.claude/settings.json`:
+
+```json
+{
+  "env": {
+    "RAINDROP_EVENT_NAME": "design-agent",
+    "RAINDROP_PROPERTIES": "{\"product\":\"design\",\"team\":\"ai\"}"
+  }
+}
+```
+
 ## Custom Self-Diagnostics Signals
 
-Replace built-in signal categories with your own via config or env var:
+Replace the built-in signal categories with your own via `~/.config/raindrop/config.json`:
 
 ```json
 {
   "self_diagnostics": {
     "signals": {
-      "billing_complaint": { "description": "User billing issue.", "sentiment": "NEGATIVE" }
+      "billing_complaint": { "description": "User billing issue.", "sentiment": "NEGATIVE" },
+      "feature_request": { "description": "User wants a feature.", "sentiment": "POSITIVE" }
     },
     "guidance": "Only report billing if explicitly mentioned."
   }
 }
 ```
 
+Or via env var: `RAINDROP_SELF_DIAGNOSTICS='{"signals":{...}}'`
+
+## Debugging
+
+```bash
+raindrop-claude-code debug-on    # logs hook output to /tmp/raindrop-hooks.log
+raindrop-claude-code debug-off   # disables logging
+```
+
 ## Docs
 
 Full documentation: [docs.raindrop.ai/sdk/claude-code](https://docs.raindrop.ai/sdk/claude-code)

package/dist/cli.js

@@ -654,7 +654,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
 
 // src/package-info.ts
 var PACKAGE_NAME = "@raindrop-ai/claude-code";
-var PACKAGE_VERSION = "0.0.6";
+var PACKAGE_VERSION = "0.0.7";
 
 // src/shipper.ts
 var EventShipper2 = class extends EventShipper {
@@ -1745,7 +1745,7 @@ function getHookEventsForVersion(version) {
   }
   return events;
 }
-function makeHookConfig(hookEvents) {
+function makeHookConfig(hookEvents, useAsync) {
   const hooks = {};
   for (const event of hookEvents) {
     hooks[event] = [
@@ -1754,7 +1754,7 @@ function makeHookConfig(hookEvents) {
           {
             type: "command",
             command: "raindrop-claude-code hook",
-            async: true,
+            async: useAsync,
             timeout: 10
           }
         ]
@@ -1773,7 +1773,7 @@ function prompt(question) {
   });
 }
 async function runSetup(args2) {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f, _g;
   const scope = (_a = args2.scope) != null ? _a : "user";
   const scopeLabel = scope === "project" ? "project" : "global";
   console.log("\n  Raindrop \xD7 Claude Code \u2014 Setup\n");
@@ -1832,8 +1832,9 @@ async function runSetup(args2) {
       settings = {};
     }
   }
-  const existingHooks = (_e = settings["hooks"]) != null ? _e : {};
-  const newHooks = makeHookConfig(hookEvents);
+  const useAsync = (_e = args2.useAsync) != null ? _e : false;
+  const existingHooks = (_f = settings["hooks"]) != null ? _f : {};
+  const newHooks = makeHookConfig(hookEvents, useAsync);
   for (const [event, hookGroups] of Object.entries(newHooks)) {
     const existing = existingHooks[event];
     if (!existing || !Array.isArray(existing)) {
@@ -1841,13 +1842,16 @@ async function runSetup(args2) {
       continue;
     }
     const typedExisting = existing;
-    const alreadyHasRaindrop = typedExisting.some(
-      (group) => {
-        var _a2;
-        return (_a2 = group.hooks) == null ? void 0 : _a2.some((h) => typeof h["command"] === "string" && h["command"].includes("raindrop-claude-code"));
+    let found = false;
+    for (const group of typedExisting) {
+      for (const h of (_g = group.hooks) != null ? _g : []) {
+        if (typeof h["command"] === "string" && h["command"].includes("raindrop-claude-code")) {
+          h["async"] = useAsync;
+          found = true;
+        }
       }
-    );
-    if (!alreadyHasRaindrop) {
+    }
+    if (!found) {
       typedExisting.push(...hookGroups);
     }
   }
@@ -1893,6 +1897,71 @@ async function runSetup(args2) {
 `);
   }
 }
+var DEBUG_LOG_PATH = "/tmp/raindrop-hooks.log";
+var DEBUG_PREFIX = "RAINDROP_DEBUG=true ";
+var TEE_SUFFIX = ` 2>&1 | tee -a ${DEBUG_LOG_PATH} || true`;
+function toggleDebug(enable, scope = "user") {
+  var _a;
+  const settingsPath = getClaudeSettingsPath(scope, process.cwd());
+  if (!existsSync6(settingsPath)) {
+    console.error(`  Settings file not found: ${settingsPath}`);
+    console.error(`  Run 'raindrop-claude-code setup' first.`);
+    process.exit(1);
+  }
+  let settings;
+  try {
+    settings = JSON.parse(readFileSync6(settingsPath, "utf-8"));
+  } catch (e) {
+    console.error(`  Could not parse ${settingsPath}`);
+    process.exit(1);
+  }
+  const hooks = settings["hooks"];
+  if (!hooks) {
+    console.error(`  No hooks found in ${settingsPath}`);
+    process.exit(1);
+  }
+  let modified = 0;
+  for (const groups of Object.values(hooks)) {
+    if (!Array.isArray(groups)) continue;
+    for (const group of groups) {
+      for (const h of (_a = group.hooks) != null ? _a : []) {
+        const cmd = h["command"];
+        if (typeof cmd !== "string" || !cmd.includes("raindrop-claude-code")) continue;
+        if (enable) {
+          let updated = cmd;
+          if (!updated.startsWith(DEBUG_PREFIX)) {
+            updated = DEBUG_PREFIX + updated;
+          }
+          if (!updated.includes("tee")) {
+            updated = updated + TEE_SUFFIX;
+          }
+          if (updated !== cmd) {
+            h["command"] = updated;
+            modified++;
+          }
+        } else {
+          let updated = cmd;
+          if (updated.startsWith(DEBUG_PREFIX)) {
+            updated = updated.slice(DEBUG_PREFIX.length);
+          }
+          updated = updated.replace(TEE_SUFFIX, "").replace(/ 2>&1 \| tee -a .*$/, "");
+          if (updated !== cmd) {
+            h["command"] = updated;
+            modified++;
+          }
+        }
+      }
+    }
+  }
+  writeFileSync4(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+  if (enable) {
+    console.log(`  Debug logging enabled (${modified} hooks updated).`);
+    console.log(`  Log file: ${DEBUG_LOG_PATH}`);
+    console.log(`  Run 'raindrop-claude-code debug-off' to disable.`);
+  } else {
+    console.log(`  Debug logging disabled (${modified} hooks updated).`);
+  }
+}
 
 // src/mcp-serve.ts
 import { createInterface as createInterface2 } from "readline";
@@ -2194,7 +2263,8 @@ async function main() {
         writeKey: parseFlag("write-key"),
         userId: parseFlag("user-id"),
         scope,
-        localOnly: args.includes("--local-only")
+        localOnly: args.includes("--local-only"),
+        useAsync: args.includes("--async")
       });
       break;
     }
@@ -2232,6 +2302,16 @@ async function main() {
       console.log("  Raindrop hooks disabled.");
       break;
     }
+    case "debug-on": {
+      const debugScope = parseFlag("scope") === "project" ? "project" : "user";
+      toggleDebug(true, debugScope);
+      break;
+    }
+    case "debug-off": {
+      const debugScope = parseFlag("scope") === "project" ? "project" : "user";
+      toggleDebug(false, debugScope);
+      break;
+    }
     case "version":
     case "--version":
     case "-v": {
@@ -2253,12 +2333,15 @@ async function main() {
       --user-id=ID      User identifier (defaults to system username)
       --scope=SCOPE     "user" (global, default) or "project" (.claude/ in cwd)
       --local-only      Install hooks without a write key (local debugger only)
+      --async           Use async hooks (default: sync for headless compatibility)
 
     hook                Handle a Claude Code hook event (reads JSON from stdin)
     mcp-serve           Start the self-diagnostics MCP server (stdio)
     status              Check local debugger connectivity
     enable              Enable Raindrop hooks
     disable             Disable Raindrop hooks
+    debug-on            Enable debug logging to /tmp/raindrop-hooks.log
+    debug-off           Disable debug logging
     version             Print version
     help                Show this help message
 

package/dist/index.cjs

@@ -690,7 +690,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = import_async_hooks.AsyncLocalStorage;
 
 // src/package-info.ts
 var PACKAGE_NAME = "@raindrop-ai/claude-code";
-var PACKAGE_VERSION = "0.0.6";
+var PACKAGE_VERSION = "0.0.7";
 
 // src/shipper.ts
 var EventShipper2 = class extends EventShipper {

package/dist/index.d.cts

@@ -308,7 +308,7 @@ declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, e
 declare function extractAppendSystemPrompt(args: string[]): string | undefined;
 
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
-declare const PACKAGE_VERSION = "0.0.6";
+declare const PACKAGE_VERSION = "0.0.7";
 
 interface TranscriptSummary {
     /** Aggregated token usage across all turns */

package/dist/index.d.ts

@@ -308,7 +308,7 @@ declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, e
 declare function extractAppendSystemPrompt(args: string[]): string | undefined;
 
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
-declare const PACKAGE_VERSION = "0.0.6";
+declare const PACKAGE_VERSION = "0.0.7";
 
 interface TranscriptSummary {
     /** Aggregated token usage across all turns */

package/dist/index.js

@@ -645,7 +645,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
 
 // src/package-info.ts
 var PACKAGE_NAME = "@raindrop-ai/claude-code";
-var PACKAGE_VERSION = "0.0.6";
+var PACKAGE_VERSION = "0.0.7";
 
 // src/shipper.ts
 var EventShipper2 = class extends EventShipper {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@raindrop-ai/claude-code",
-  "version": "0.0.6",
-  "description": "Raindrop observability for Claude Code CLI — automatic session, tool call, and prompt tracing via hooks",
+  "version": "0.0.7",
+  "description": "Raindrop observability for Claude Code CLI \u2014 automatic session, tool call, and prompt tracing via hooks",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.cjs",