@rune-kit/rune 2.8.0 → 2.11.0

package/hooks/context-watch/index.cjs

@@ -1,68 +1,95 @@
-// Rune Context Watch Hook
-// Lightweight tool call counter — detects context pressure and suggests rune:context-engine
-// Runs as PreToolUse hook on Edit/Write (high-cost operations)
-//
-// H3 Intelligence: also tracks tool type distribution and session start timestamp
-// for metrics aggregation at session end.
-//
-// Uses a temp file counter (survives across hook invocations within same session).
-// Zero overhead: just reads/increments a number. No token cost.
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Counter file scoped to current working directory (hash of cwd)
-const cwd = process.cwd();
-const hash = Buffer.from(cwd).toString('base64url').slice(0, 16);
-const counterFile = path.join(os.tmpdir(), `rune-context-watch-${hash}.json`);
-
-// Thresholds
-const FIRST_WARNING = 40;
-const REPEAT_INTERVAL = 20;
-const CRITICAL_THRESHOLD = 80;
-
-// Detect tool type from environment
-const toolName = process.env.CLAUDE_TOOL_NAME || 'unknown';
-
-// Read current state
-let state = { count: 0, lastWarning: 0, sessionStart: null, toolCounts: {} };
-try {
-  const raw = fs.readFileSync(counterFile, 'utf-8');
-  state = JSON.parse(raw);
-  // Ensure toolCounts exists (upgrade from old format)
-  if (!state.toolCounts) state.toolCounts = {};
-  if (!state.sessionStart) state.sessionStart = new Date().toISOString();
-} catch {
-  // First run or corrupted — start fresh
-  state.sessionStart = new Date().toISOString();
-}
-
-// Increment total and per-tool counters
-state.count += 1;
-state.toolCounts[toolName] = (state.toolCounts[toolName] || 0) + 1;
-
-// Check thresholds
-const count = state.count;
-const sinceLast = count - state.lastWarning;
-
-if (count >= CRITICAL_THRESHOLD && sinceLast >= REPEAT_INTERVAL) {
-  console.log(`\n🔴 [Rune context-watch] ${count} tool calls — context likely RED (>85%).`);
-  console.log('  RECOMMENDED: Invoke rune:context-engine for state save + /compact.');
-  console.log('  Risk: auto-compaction may lose critical decisions without state save.\n');
-  state.lastWarning = count;
-} else if (count >= FIRST_WARNING && sinceLast >= REPEAT_INTERVAL) {
-  console.log(`\n🟡 [Rune context-watch] ${count} tool calls — context filling up.`);
-  console.log('  Consider invoking rune:context-engine at the next logical boundary.');
-  console.log('  Or run /compact manually if at a good stopping point.\n');
-  state.lastWarning = count;
-}
-
-// Persist
-try {
-  fs.writeFileSync(counterFile, JSON.stringify(state));
-} catch {
-  // Non-critical — counter resets next run
-}
-
-process.exit(0);
+// Rune Context Watch Hook
+// Lightweight tool call counter — detects context pressure and suggests rune:context-engine
+// Runs as PreToolUse hook on Edit/Write (high-cost operations)
+//
+// H3 Intelligence: also tracks tool type distribution and session start timestamp
+// for metrics aggregation at session end.
+//
+// Uses a temp file counter (survives across hook invocations within same session).
+// Zero overhead: just reads/increments a number. No token cost.
+//
+// Data source: stdin JSON from Claude Code (not env vars)
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Counter file scoped to current working directory (hash of cwd)
+const cwd = process.cwd();
+const hash = Buffer.from(cwd).toString('base64url').slice(0, 16);
+const counterFile = path.join(os.tmpdir(), `rune-context-watch-${hash}.json`);
+
+// Thresholds
+const FIRST_WARNING = 40;
+const REPEAT_INTERVAL = 20;
+const CRITICAL_THRESHOLD = 80;
+
+// Read stdin JSON to get tool name (Claude Code passes hook data via stdin)
+let stdinData = '';
+process.stdin.setEncoding('utf-8');
+process.stdin.on('data', chunk => { stdinData += chunk; });
+process.stdin.on('end', () => {
+  let toolName = 'unknown';
+  try {
+    const parsed = JSON.parse(stdinData);
+    toolName = parsed.tool || parsed.tool_name || 'unknown';
+  } catch {
+    // Fallback to env var for backwards compatibility
+    toolName = process.env.CLAUDE_TOOL_NAME || 'unknown';
+  }
+
+  // Read current state
+  let state = { count: 0, lastWarning: 0, sessionStart: null, sessionId: null, toolCounts: {} };
+  try {
+    const raw = fs.readFileSync(counterFile, 'utf-8');
+    state = JSON.parse(raw);
+    // Ensure fields exist (upgrade from old format)
+    if (!state.toolCounts) state.toolCounts = {};
+    if (!state.sessionStart) state.sessionStart = new Date().toISOString();
+    if (!state.sessionId) {
+      const s = state.sessionStart;
+      state.sessionId = `s-${s.slice(0, 10).replace(/-/g, '')}-${s.slice(11, 19).replace(/:/g, '')}`;
+    }
+  } catch {
+    // First run or corrupted — start fresh
+    const now = new Date().toISOString();
+    state.sessionStart = now;
+    state.sessionId = `s-${now.slice(0, 10).replace(/-/g, '')}-${now.slice(11, 19).replace(/:/g, '')}`;
+  }
+
+  // Increment total and per-tool counters
+  state.count += 1;
+  state.toolCounts[toolName] = (state.toolCounts[toolName] || 0) + 1;
+
+  // Check thresholds
+  const count = state.count;
+  const sinceLast = count - state.lastWarning;
+
+  if (count >= CRITICAL_THRESHOLD && sinceLast >= REPEAT_INTERVAL) {
+    console.log(`\n🔴 [Rune context-watch] ${count} tool calls — context likely RED (>85%).`);
+    console.log('  RECOMMENDED: Invoke rune:context-engine for state save + /compact.');
+    console.log('  Risk: auto-compaction may lose critical decisions without state save.\n');
+    state.lastWarning = count;
+  } else if (count >= FIRST_WARNING && sinceLast >= REPEAT_INTERVAL) {
+    console.log(`\n🟡 [Rune context-watch] ${count} tool calls — context filling up.`);
+    console.log('  Consider invoking rune:context-engine at the next logical boundary.');
+    console.log('  Or run /compact manually if at a good stopping point.\n');
+    state.lastWarning = count;
+  }
+
+  // Pass through stdin to stdout (required for PreToolUse hooks)
+  if (stdinData) process.stdout.write(stdinData);
+
+  // Persist
+  try {
+    fs.writeFileSync(counterFile, JSON.stringify(state));
+  } catch {
+    // Non-critical — counter resets next run
+  }
+
+  process.exit(0);
+});
+
+// Handle empty stdin (pipe closed immediately)
+process.stdin.on('error', () => process.exit(0));
+process.stdin.resume();

package/hooks/hooks.json

@@ -1,111 +1,111 @@
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "startup|resume|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" session-start",
-            "async": false
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "matcher": ".*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" intent-router",
-            "async": true
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Read|Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" pre-tool-guard",
-            "async": false
-          }
-        ]
-      },
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" context-watch",
-            "async": true
-          }
-        ]
-      },
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" secrets-scan",
-            "async": false
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" auto-format",
-            "async": true
-          },
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" typecheck",
-            "async": true
-          }
-        ]
-      },
-      {
-        "matcher": "Skill",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" metrics-collector",
-            "async": true
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "matcher": ".*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" pre-compact",
-            "async": false
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "matcher": ".*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" post-session-reflect",
-            "async": false
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" session-start",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" intent-router",
+            "async": true
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Read|Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" pre-tool-guard",
+            "async": false
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" context-watch",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" secrets-scan",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" auto-format",
+            "async": true
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" typecheck",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "Skill",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" metrics-collector",
+            "async": true
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" pre-compact",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cjs\" post-session-reflect",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/metrics-collector/index.cjs

@@ -1,42 +1,86 @@
-// Rune Metrics Collector Hook
-// PostToolUse on Skill — captures skill invocations for H3 mesh analytics
-// Append-only JSONL to tmpdir. Flushed to .rune/metrics/ at session end.
-// Async: true — never blocks skill execution.
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const cwd = process.cwd();
-const hash = Buffer.from(cwd).toString('base64url').slice(0, 16);
-const metricsFile = path.join(os.tmpdir(), `rune-metrics-${hash}.jsonl`);
-
-// Extract skill name from tool input
-const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
-let skillName = 'unknown';
-try {
-  const parsed = JSON.parse(toolInput);
-  // Skill tool input has { skill: "rune:cook" } or { skill: "cook" }
-  const raw = parsed.skill || parsed.name || '';
-  skillName = raw.replace(/^rune:/, '');
-} catch {
-  // If not JSON, try raw string match
-  const match = toolInput.match(/(?:rune:)?([a-z][\w-]*)/i);
-  if (match) skillName = match[1];
-}
-
-if (skillName && skillName !== 'unknown') {
-  const entry = JSON.stringify({
-    ts: new Date().toISOString(),
-    skill: skillName,
-    event: 'invoke'
-  });
-
-  try {
-    fs.appendFileSync(metricsFile, entry + '\n');
-  } catch {
-    // Non-critical — metrics are best-effort
-  }
-}
-
-process.exit(0);
+// Rune Metrics Collector Hook
+// PostToolUse on Skill — captures skill invocations for H3 mesh analytics
+// Append-only JSONL to tmpdir. Flushed to .rune/metrics/ at session end.
+// Async: true — never blocks skill execution.
+//
+// Data source: stdin JSON from Claude Code (not env vars)
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const cwd = process.cwd();
+const hash = Buffer.from(cwd).toString('base64url').slice(0, 16);
+const metricsFile = path.join(os.tmpdir(), `rune-metrics-${hash}.jsonl`);
+const watchFile = path.join(os.tmpdir(), `rune-context-watch-${hash}.json`);
+
+// Read stdin JSON to get tool input (Claude Code passes hook data via stdin)
+let stdinData = '';
+process.stdin.setEncoding('utf-8');
+process.stdin.on('data', chunk => { stdinData += chunk; });
+process.stdin.on('end', () => {
+  let skillName = 'unknown';
+
+  try {
+    const hookData = JSON.parse(stdinData);
+    // PostToolUse stdin: { tool: "Skill", tool_input: { skill: "rune:cook", ... }, tool_result: ... }
+    const toolInput = hookData.tool_input || {};
+    const raw = toolInput.skill || toolInput.name || '';
+    skillName = raw.replace(/^rune:/, '') || 'unknown';
+  } catch {
+    // Fallback: try env var for backwards compatibility
+    const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+    try {
+      const parsed = JSON.parse(toolInput);
+      const raw = parsed.skill || parsed.name || '';
+      skillName = raw.replace(/^rune:/, '');
+    } catch {
+      const match = toolInput.match(/(?:rune:)?([a-z][\w-]*)/i);
+      if (match) skillName = match[1];
+    }
+  }
+
+  if (skillName && skillName !== 'unknown') {
+    const now = Date.now();
+    const ts = new Date(now).toISOString();
+
+    // Read session ID from context-watch state (shared tmpdir file)
+    let sessionId = null;
+    try {
+      const watchState = JSON.parse(fs.readFileSync(watchFile, 'utf-8'));
+      sessionId = watchState.sessionId || null;
+    } catch { /* no watch state yet */ }
+
+    // Compute duration since last skill event (approximate skill execution time)
+    let durationMs = null;
+    try {
+      const lines = fs.readFileSync(metricsFile, 'utf-8').trim().split('\n').filter(Boolean);
+      if (lines.length > 0) {
+        const last = JSON.parse(lines[lines.length - 1]);
+        durationMs = now - new Date(last.ts).getTime();
+        // Cap at 10 minutes — longer gaps are idle time, not skill duration
+        if (durationMs > 600000) durationMs = null;
+      }
+    } catch { /* first event or read error */ }
+
+    const entry = JSON.stringify({
+      ts,
+      skill: skillName,
+      event: 'invoke',
+      session_id: sessionId,
+      duration_ms: durationMs
+    });
+
+    try {
+      fs.appendFileSync(metricsFile, entry + '\n');
+    } catch {
+      // Non-critical — metrics are best-effort
+    }
+  }
+
+  process.exit(0);
+});
+
+// Handle empty stdin (pipe closed immediately)
+process.stdin.on('error', () => process.exit(0));
+process.stdin.resume();