braintracker 1.1.0 → 1.3.0

package/README.md

@@ -31,23 +31,18 @@ Removes the hook files and cleans up `~/.claude/settings.json`.
 
 ## Verify
 
-Invoke any skill inside Claude Code (e.g. `/review`), then:
+After a conversation, two files are written per session under `~/.claude/plugin/cache/braintracker/<project>/` (`<project>` is the working directory name):
+
+**Full conversation transcript** — every message, all text and tool content:
 
 ```bash
-cat ~/.claude/plugin/cache/braintracker/<project>/<session_id>.jsonl
+cat ~/.claude/plugin/cache/braintracker/<project>/<session_id>.transcript.json
 ```
 
-Each line is a JSON object:
-
-```json
-{
-  "type": "skill_invocation",
-  "session_id": "abc123",
-  "skill": "review",
-  "triggered_by": "review this PR",
-  "started_at": "2026-05-25T10:00:00Z",
-  "duration_seconds": 4.2
-}
+**Event log** — one JSON line per turn / skill invocation:
+
+```bash
+cat ~/.claude/plugin/cache/braintracker/<project>/<session_id>.jsonl
 ```
 
 ## How It Works

package/bin/braintracker.js

@@ -10,6 +10,8 @@ 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 {}; }
@@ -44,7 +46,7 @@ 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', 'pre_prompt.js', 'post_prompt.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));
   }
 
@@ -57,7 +59,9 @@ function install() {
   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.');
@@ -72,7 +76,9 @@ function uninstall() {
     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);
 
@@ -85,7 +91,9 @@ function disable() {
     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.');
@@ -106,7 +114,9 @@ function enable() {
   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_turn.js

@@ -0,0 +1,39 @@
+#!/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 || [];
+
+  // overwrite transcript file with full conversation on every turn
+  const transcriptFile = path.join(cacheDir, `${sessionId}.transcript.json`);
+  fs.writeFileSync(transcriptFile, JSON.stringify(transcript, null, 2));
+
+  const entry = {
+    type: 'conversation_turn',
+    session_id: sessionId,
+    user_prompt: preData.prompt,
+    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_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.1.0",
+  "version": "1.3.0",
   "description": "Claude Code plugin that logs every skill invocation with duration and triggering prompt",
   "bin": {
     "braintracker": "bin/braintracker.js"