braintracker 1.0.1 → 1.2.0

package/README.md

@@ -52,9 +52,20 @@ Each line is a JSON object:
 
 ## How It Works
 
+Two capture paths cover all skill invocations:
+
+**Slash commands** (user types `/skill-name`):
+
+| Hook | Script | Action |
+|------|--------|--------|
+| `UserPromptSubmit` | `pre_prompt.js` | Detects `/skill-name` in the prompt, writes `<session>.prompt.pre.json` |
+| `Stop` | `post_prompt.js` | Reads the snapshot, computes duration, appends a log entry, deletes the snapshot |
+
+**Mid-conversation tool calls** (Claude calls `Skill(...)` explicitly):
+
 | Hook | Script | Action |
 |------|--------|--------|
 | `PreToolUse` (Skill) | `pre_skill.js` | Writes a timing snapshot to `<session>.pre.json` |
-| `PostToolUse` (Skill) | `post_skill.js` | Reads the snapshot, computes duration, appends a log entry to `<session>.jsonl`, deletes the snapshot |
+| `PostToolUse` (Skill) | `post_skill.js` | Reads the snapshot, computes duration, appends a log entry, deletes the snapshot |
 
 Logs live at `~/.claude/plugin/cache/braintracker/<project>/` — one JSONL file per session, grouped by project name.

package/bin/braintracker.js

@@ -6,8 +6,12 @@ const os   = require('os');
 const DEST_HOOKS = path.join(os.homedir(), '.claude', 'plugins', 'braintracker', 'hooks');
 const SETTINGS   = path.join(os.homedir(), '.claude', 'settings.json');
 
-const PRE_CMD  = `node ${path.join(DEST_HOOKS, 'pre_skill.js')}`;
-const POST_CMD = `node ${path.join(DEST_HOOKS, 'post_skill.js')}`;
+const PRE_CMD         = `node ${path.join(DEST_HOOKS, 'pre_skill.js')}`;
+const POST_CMD        = `node ${path.join(DEST_HOOKS, 'post_skill.js')}`;
+const PRE_PROMPT_CMD  = `node ${path.join(DEST_HOOKS, 'pre_prompt.js')}`;
+const POST_PROMPT_CMD = `node ${path.join(DEST_HOOKS, 'post_prompt.js')}`;
+const PRE_TURN_CMD    = `node ${path.join(DEST_HOOKS, 'pre_turn.js')}`;
+const POST_TURN_CMD   = `node ${path.join(DEST_HOOKS, 'post_turn.js')}`;
 
 function readSettings() {
   try { return JSON.parse(fs.readFileSync(SETTINGS, 'utf8')); } catch { return {}; }
@@ -19,8 +23,13 @@ function writeSettings(settings) {
 }
 
 function addHook(arr, matcher, command) {
-  let group = arr.find(h => h.matcher === matcher);
-  if (!group) { group = { matcher, hooks: [] }; arr.push(group); }
+  let group = matcher != null
+    ? arr.find(h => h.matcher === matcher)
+    : arr.find(h => h.matcher == null);
+  if (!group) {
+    group = matcher != null ? { matcher, hooks: [] } : { hooks: [] };
+    arr.push(group);
+  }
   group.hooks = group.hooks || [];
   if (!group.hooks.some(h => h.command === command)) {
     group.hooks.push({ type: 'command', command });
@@ -37,16 +46,22 @@ function removeHook(arr, command) {
 function install() {
   const SRC_HOOKS = path.join(__dirname, '..', 'braintracker', 'hooks');
   fs.mkdirSync(DEST_HOOKS, { recursive: true });
-  for (const file of ['pre_skill.js', 'post_skill.js']) {
+  for (const file of ['pre_skill.js', 'post_skill.js', 'pre_prompt.js', 'post_prompt.js', 'pre_turn.js', 'post_turn.js']) {
     fs.copyFileSync(path.join(SRC_HOOKS, file), path.join(DEST_HOOKS, file));
   }
 
   const settings = readSettings();
-  settings.hooks             = settings.hooks             || {};
-  settings.hooks.PreToolUse  = settings.hooks.PreToolUse  || [];
-  settings.hooks.PostToolUse = settings.hooks.PostToolUse || [];
-  addHook(settings.hooks.PreToolUse,  'Skill', PRE_CMD);
-  addHook(settings.hooks.PostToolUse, 'Skill', POST_CMD);
+  settings.hooks                    = settings.hooks                    || {};
+  settings.hooks.PreToolUse         = settings.hooks.PreToolUse         || [];
+  settings.hooks.PostToolUse        = settings.hooks.PostToolUse        || [];
+  settings.hooks.UserPromptSubmit   = settings.hooks.UserPromptSubmit   || [];
+  settings.hooks.Stop               = settings.hooks.Stop               || [];
+  addHook(settings.hooks.PreToolUse,       'Skill', PRE_CMD);
+  addHook(settings.hooks.PostToolUse,      'Skill', POST_CMD);
+  addHook(settings.hooks.UserPromptSubmit, null,    PRE_PROMPT_CMD);
+  addHook(settings.hooks.UserPromptSubmit, null,    PRE_TURN_CMD);
+  addHook(settings.hooks.Stop,             null,    POST_PROMPT_CMD);
+  addHook(settings.hooks.Stop,             null,    POST_TURN_CMD);
   writeSettings(settings);
 
   console.log('braintracker installed.');
@@ -58,8 +73,12 @@ function uninstall() {
 
   const settings = readSettings();
   if (settings.hooks) {
-    settings.hooks.PreToolUse  = removeHook(settings.hooks.PreToolUse,  PRE_CMD);
-    settings.hooks.PostToolUse = removeHook(settings.hooks.PostToolUse, POST_CMD);
+    settings.hooks.PreToolUse       = removeHook(settings.hooks.PreToolUse,       PRE_CMD);
+    settings.hooks.PostToolUse      = removeHook(settings.hooks.PostToolUse,      POST_CMD);
+    settings.hooks.UserPromptSubmit = removeHook(settings.hooks.UserPromptSubmit, PRE_PROMPT_CMD);
+    settings.hooks.UserPromptSubmit = removeHook(settings.hooks.UserPromptSubmit, PRE_TURN_CMD);
+    settings.hooks.Stop             = removeHook(settings.hooks.Stop,             POST_PROMPT_CMD);
+    settings.hooks.Stop             = removeHook(settings.hooks.Stop,             POST_TURN_CMD);
   }
   writeSettings(settings);
 
@@ -69,8 +88,12 @@ function uninstall() {
 function disable() {
   const settings = readSettings();
   if (settings.hooks) {
-    settings.hooks.PreToolUse  = removeHook(settings.hooks.PreToolUse,  PRE_CMD);
-    settings.hooks.PostToolUse = removeHook(settings.hooks.PostToolUse, POST_CMD);
+    settings.hooks.PreToolUse       = removeHook(settings.hooks.PreToolUse,       PRE_CMD);
+    settings.hooks.PostToolUse      = removeHook(settings.hooks.PostToolUse,      POST_CMD);
+    settings.hooks.UserPromptSubmit = removeHook(settings.hooks.UserPromptSubmit, PRE_PROMPT_CMD);
+    settings.hooks.UserPromptSubmit = removeHook(settings.hooks.UserPromptSubmit, PRE_TURN_CMD);
+    settings.hooks.Stop             = removeHook(settings.hooks.Stop,             POST_PROMPT_CMD);
+    settings.hooks.Stop             = removeHook(settings.hooks.Stop,             POST_TURN_CMD);
   }
   writeSettings(settings);
   console.log('braintracker disabled. Hook files kept. Run "npx braintracker enable" to re-enable.');
@@ -83,11 +106,17 @@ function enable() {
   }
 
   const settings = readSettings();
-  settings.hooks             = settings.hooks             || {};
-  settings.hooks.PreToolUse  = settings.hooks.PreToolUse  || [];
-  settings.hooks.PostToolUse = settings.hooks.PostToolUse || [];
-  addHook(settings.hooks.PreToolUse,  'Skill', PRE_CMD);
-  addHook(settings.hooks.PostToolUse, 'Skill', POST_CMD);
+  settings.hooks                    = settings.hooks                    || {};
+  settings.hooks.PreToolUse         = settings.hooks.PreToolUse         || [];
+  settings.hooks.PostToolUse        = settings.hooks.PostToolUse        || [];
+  settings.hooks.UserPromptSubmit   = settings.hooks.UserPromptSubmit   || [];
+  settings.hooks.Stop               = settings.hooks.Stop               || [];
+  addHook(settings.hooks.PreToolUse,       'Skill', PRE_CMD);
+  addHook(settings.hooks.PostToolUse,      'Skill', POST_CMD);
+  addHook(settings.hooks.UserPromptSubmit, null,    PRE_PROMPT_CMD);
+  addHook(settings.hooks.UserPromptSubmit, null,    PRE_TURN_CMD);
+  addHook(settings.hooks.Stop,             null,    POST_PROMPT_CMD);
+  addHook(settings.hooks.Stop,             null,    POST_TURN_CMD);
   writeSettings(settings);
 
   console.log('braintracker enabled.');

package/braintracker/hooks/post_prompt.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let raw = '';
+process.stdin.on('data', chunk => (raw += chunk));
+process.stdin.on('end', () => {
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    process.exit(0);
+  }
+
+  const sessionId = payload.session_id;
+  const prj = path.basename(process.cwd());
+  const cacheDir = path.join(os.homedir(), '.claude', 'plugin', 'cache', 'braintracker', prj);
+  const preFile = path.join(cacheDir, `${sessionId}.prompt.pre.json`);
+
+  let preData;
+  try {
+    preData = JSON.parse(fs.readFileSync(preFile, 'utf8'));
+  } catch {
+    process.exit(0);
+  }
+
+  const entry = {
+    type: 'skill_invocation',
+    session_id: sessionId,
+    skill: preData.skill,
+    triggered_by: preData.triggered_by,
+    started_at: new Date(preData.start_time).toISOString(),
+    duration_seconds: (Date.now() - preData.start_time) / 1000,
+  };
+
+  const logFile = path.join(cacheDir, `${sessionId}.jsonl`);
+  fs.appendFileSync(logFile, JSON.stringify(entry) + '\n');
+  fs.unlinkSync(preFile);
+
+  process.exit(0);
+});

package/braintracker/hooks/post_turn.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let raw = '';
+process.stdin.on('data', chunk => (raw += chunk));
+process.stdin.on('end', () => {
+  let payload;
+  try { payload = JSON.parse(raw); } catch { process.exit(0); }
+
+  const sessionId = payload.session_id;
+  const prj = path.basename(process.cwd());
+  const cacheDir = path.join(os.homedir(), '.claude', 'plugin', 'cache', 'braintracker', prj);
+  const preFile = path.join(cacheDir, `${sessionId}.turn.pre.json`);
+
+  let preData;
+  try { preData = JSON.parse(fs.readFileSync(preFile, 'utf8')); } catch { process.exit(0); }
+
+  const transcript = payload.transcript || [];
+  const lastAssistant = [...transcript].reverse().find(m => m.role === 'assistant');
+  let assistantResponse = '';
+  if (lastAssistant) {
+    const c = lastAssistant.content;
+    if (typeof c === 'string') {
+      assistantResponse = c;
+    } else if (Array.isArray(c)) {
+      assistantResponse = c.filter(b => b.type === 'text').map(b => b.text).join('');
+    }
+  }
+
+  const entry = {
+    type: 'conversation_turn',
+    session_id: sessionId,
+    user_prompt: preData.prompt,
+    assistant_response: assistantResponse,
+    started_at: new Date(preData.start_time).toISOString(),
+    duration_seconds: (Date.now() - preData.start_time) / 1000,
+  };
+
+  const logFile = path.join(cacheDir, `${sessionId}.jsonl`);
+  fs.appendFileSync(logFile, JSON.stringify(entry) + '\n');
+  fs.unlinkSync(preFile);
+
+  process.exit(0);
+});

package/braintracker/hooks/pre_prompt.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let raw = '';
+process.stdin.on('data', chunk => (raw += chunk));
+process.stdin.on('end', () => {
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    process.exit(0);
+  }
+
+  const prompt = (payload.prompt || '').trim();
+  const match = prompt.match(/^\/(\w[\w-]*)/);
+  if (!match) process.exit(0);
+
+  const sessionId = payload.session_id;
+  const skill = match[1];
+  const triggeredBy = prompt.slice(match[0].length).trim();
+  const prj = path.basename(process.cwd());
+  const cacheDir = path.join(os.homedir(), '.claude', 'plugin', 'cache', 'braintracker', prj);
+
+  fs.mkdirSync(cacheDir, { recursive: true });
+
+  const preFile = path.join(cacheDir, `${sessionId}.prompt.pre.json`);
+  fs.writeFileSync(preFile, JSON.stringify({
+    session_id: sessionId,
+    skill,
+    triggered_by: triggeredBy,
+    start_time: Date.now(),
+  }));
+
+  process.exit(0);
+});

package/braintracker/hooks/pre_turn.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let raw = '';
+process.stdin.on('data', chunk => (raw += chunk));
+process.stdin.on('end', () => {
+  let payload;
+  try { payload = JSON.parse(raw); } catch { process.exit(0); }
+
+  const sessionId = payload.session_id;
+  const prompt = (payload.prompt || '').trim();
+  const prj = path.basename(process.cwd());
+  const cacheDir = path.join(os.homedir(), '.claude', 'plugin', 'cache', 'braintracker', prj);
+
+  fs.mkdirSync(cacheDir, { recursive: true });
+
+  const preFile = path.join(cacheDir, `${sessionId}.turn.pre.json`);
+  fs.writeFileSync(preFile, JSON.stringify({
+    session_id: sessionId,
+    prompt,
+    start_time: Date.now(),
+  }));
+
+  process.exit(0);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "braintracker",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Claude Code plugin that logs every skill invocation with duration and triggering prompt",
   "bin": {
     "braintracker": "bin/braintracker.js"