@rune-kit/rune 2.8.0 → 2.11.0

package/hooks/post-session-reflect/index.cjs

@@ -1,153 +1,189 @@
-// Rune Post-Session Reflect Hook
-// 1. Flushes session metrics from tmpdir to .rune/metrics/ (H3 Intelligence)
-// 2. Displays structured self-review checklist at session end (Stop event)
-
-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);
-
-// === H3: Flush Session Metrics ===
-
-const metricsJsonl = path.join(os.tmpdir(), `rune-metrics-${hash}.jsonl`);
-const counterFile = path.join(os.tmpdir(), `rune-context-watch-${hash}.json`);
-const runeMetricsDir = path.join(cwd, '.rune', 'metrics');
-
-try {
-  flushMetrics();
-} catch (e) {
-  // Metrics flush is best-effort — never block session end
-  // Silently ignore errors
-}
-
-function flushMetrics() {
-  // Read session skill invocations from tmpdir JSONL
-  let skillEvents = [];
-  if (fs.existsSync(metricsJsonl)) {
-    const lines = fs.readFileSync(metricsJsonl, 'utf-8').trim().split('\n').filter(Boolean);
-    for (const line of lines) {
-      try { skillEvents.push(JSON.parse(line)); } catch { /* skip malformed */ }
-    }
-  }
-
-  // Read context-watch state for tool counts and session timing
-  let watchState = { count: 0, sessionStart: null, toolCounts: {} };
-  if (fs.existsSync(counterFile)) {
-    try {
-      watchState = JSON.parse(fs.readFileSync(counterFile, 'utf-8'));
-    } catch { /* use defaults */ }
-  }
-
-  // Nothing to flush if no data
-  if (skillEvents.length === 0 && watchState.count === 0) return;
-
-  // Ensure .rune/metrics/ exists
-  fs.mkdirSync(runeMetricsDir, { recursive: true });
-
-  const now = new Date().toISOString();
-  const sessionStart = watchState.sessionStart || now;
-  const durationMin = Math.round((new Date(now) - new Date(sessionStart)) / 60000);
-
-  // Build skill usage map
-  const skillCounts = {};
-  const skillChain = [];
-  for (const evt of skillEvents) {
-    skillCounts[evt.skill] = (skillCounts[evt.skill] || 0) + 1;
-    skillChain.push(evt.skill);
-  }
-
-  // Determine primary skill (most invoked)
-  const primarySkill = Object.entries(skillCounts)
-    .sort((a, b) => b[1] - a[1])[0]?.[0] || 'none';
-
-  // Generate session ID
-  const sessionId = `s-${now.slice(0, 10).replace(/-/g, '')}-${now.slice(11, 19).replace(/:/g, '')}`;
-
-  // 1. Append to sessions.jsonl
-  const sessionEntry = {
-    id: sessionId,
-    date: now.slice(0, 10),
-    duration_min: durationMin,
-    tool_calls: watchState.count,
-    tool_distribution: watchState.toolCounts,
-    skill_invocations: skillEvents.length,
-    skills_used: Object.keys(skillCounts),
-    primary_skill: primarySkill
-  };
-
-  const sessionsFile = path.join(runeMetricsDir, 'sessions.jsonl');
-  fs.appendFileSync(sessionsFile, JSON.stringify(sessionEntry) + '\n');
-
-  // Cap at 100 sessions (rotate oldest)
-  try {
-    const allLines = fs.readFileSync(sessionsFile, 'utf-8').trim().split('\n').filter(Boolean);
-    if (allLines.length > 100) {
-      fs.writeFileSync(sessionsFile, allLines.slice(-100).join('\n') + '\n');
-    }
-  } catch { /* cap is best-effort */ }
-
-  // 2. Merge into skills.json (running totals)
-  const skillsFile = path.join(runeMetricsDir, 'skills.json');
-  let skillsData = { version: 1, updated: now, skills: {} };
-  if (fs.existsSync(skillsFile)) {
-    try {
-      skillsData = JSON.parse(fs.readFileSync(skillsFile, 'utf-8'));
-    } catch { /* start fresh */ }
-  }
-
-  for (const [skill, count] of Object.entries(skillCounts)) {
-    if (!skillsData.skills[skill]) {
-      skillsData.skills[skill] = { total_invocations: 0, last_used: now.slice(0, 10) };
-    }
-    skillsData.skills[skill].total_invocations += count;
-    skillsData.skills[skill].last_used = now.slice(0, 10);
-  }
-  skillsData.updated = now;
-
-  fs.writeFileSync(skillsFile, JSON.stringify(skillsData, null, 2) + '\n');
-
-  // 3. Append to chains.jsonl
-  if (skillChain.length > 0) {
-    const chainsFile = path.join(runeMetricsDir, 'chains.jsonl');
-    const chainEntry = {
-      session: sessionId,
-      chain: skillChain,
-      depth: skillChain.length
-    };
-    fs.appendFileSync(chainsFile, JSON.stringify(chainEntry) + '\n');
-  }
-
-  // 4. Cleanup tmpdir files
-  try { fs.unlinkSync(metricsJsonl); } catch { /* already gone */ }
-  // Note: counterFile is cleaned by session-start hook on next session
-
-  // Report metrics flush
-  const skillList = Object.entries(skillCounts)
-    .sort((a, b) => b[1] - a[1])
-    .map(([s, c]) => `${s}(${c})`)
-    .join(', ');
-
-  console.log(`\n📊 [Rune metrics] Session ${sessionId} — ${durationMin}min, ${watchState.count} tool calls, ${skillEvents.length} skill invocations`);
-  if (skillList) console.log(`   Skills: ${skillList}`);
-  console.log(`   Saved to .rune/metrics/\n`);
-}
-
-// === Original: Verification Checklist ===
-
-console.log(`
-┌─────────────────────────────────────────────────────┐
-│  Rune Session End — Verification Checklist          │
-├─────────────────────────────────────────────────────┤
-│  Before closing this session, confirm:              │
-│                                                     │
-│  □ All TodoWrite tasks marked complete?             │
-│  □ Tests ran and passing?                           │
-│  □ No hardcoded secrets introduced?                 │
-│  □ If schema changed: migration + rollback exist?   │
-│  □ Verification ran (lint + types + build)?         │
-│                                                     │
-│  If any item is unclear → address it now.           │
-└─────────────────────────────────────────────────────┘
-`);
+// Rune Post-Session Reflect Hook
+// 1. Flushes session metrics from tmpdir to .rune/metrics/ (H3 Intelligence)
+// 2. Displays structured self-review checklist at session end (Stop event)
+
+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);
+
+// === H3: Flush Session Metrics ===
+
+const metricsJsonl = path.join(os.tmpdir(), `rune-metrics-${hash}.jsonl`);
+const counterFile = path.join(os.tmpdir(), `rune-context-watch-${hash}.json`);
+const runeMetricsDir = path.join(cwd, '.rune', 'metrics');
+
+// Resolve skill names → expected model from agent frontmatter
+// Reads agents/*.md at flush time — no runtime model detection needed
+// Map skill names → models, weighted by invocation count
+// skillCounts: { skillName: invocationCount }
+function resolveSkillModels(skillCounts) {
+  const models = {};
+  const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || path.join(__dirname, '..', '..');
+  const agentsDir = path.join(pluginRoot, 'agents');
+
+  if (!fs.existsSync(agentsDir)) return models;
+
+  for (const [skill, count] of Object.entries(skillCounts)) {
+    try {
+      const agentFile = path.join(agentsDir, `${skill}.md`);
+      if (!fs.existsSync(agentFile)) continue;
+      const content = fs.readFileSync(agentFile, 'utf-8');
+      const match = content.match(/^model:\s*(\w+)/m);
+      if (match) {
+        const model = match[1];
+        models[model] = (models[model] || 0) + count;
+      }
+    } catch { /* best-effort */ }
+  }
+  return models;
+}
+
+try {
+  flushMetrics();
+} catch (e) {
+  // Metrics flush is best-effort — never block session end
+  // Silently ignore errors
+}
+
+function flushMetrics() {
+  // Read session skill invocations from tmpdir JSONL
+  let skillEvents = [];
+  if (fs.existsSync(metricsJsonl)) {
+    const lines = fs.readFileSync(metricsJsonl, 'utf-8').trim().split('\n').filter(Boolean);
+    for (const line of lines) {
+      try { skillEvents.push(JSON.parse(line)); } catch { /* skip malformed */ }
+    }
+  }
+
+  // Read context-watch state for tool counts and session timing
+  let watchState = { count: 0, sessionStart: null, sessionId: null, toolCounts: {} };
+  if (fs.existsSync(counterFile)) {
+    try {
+      watchState = JSON.parse(fs.readFileSync(counterFile, 'utf-8'));
+    } catch { /* use defaults */ }
+  }
+
+  // Nothing to flush if no data
+  if (skillEvents.length === 0 && watchState.count === 0) return;
+
+  // Ensure .rune/metrics/ exists
+  fs.mkdirSync(runeMetricsDir, { recursive: true });
+
+  const now = new Date().toISOString();
+  const sessionStart = watchState.sessionStart || now;
+  const durationMin = Math.round((new Date(now) - new Date(sessionStart)) / 60000);
+
+  // Build skill usage map and duration aggregation
+  const skillCounts = {};
+  const skillDurations = {};
+  const skillChain = [];
+  for (const evt of skillEvents) {
+    skillCounts[evt.skill] = (skillCounts[evt.skill] || 0) + 1;
+    skillChain.push(evt.skill);
+    if (evt.duration_ms != null) {
+      skillDurations[evt.skill] = (skillDurations[evt.skill] || 0) + evt.duration_ms;
+    }
+  }
+
+  // Determine primary skill (most invoked)
+  const primarySkill = Object.entries(skillCounts)
+    .sort((a, b) => b[1] - a[1])[0]?.[0] || 'none';
+
+  // Map skills to expected models from agent definitions (weighted by invocation count)
+  const modelsUsed = resolveSkillModels(skillCounts);
+
+  // Use session ID from context-watch (shared) or generate new
+  const sessionId = watchState.sessionId
+    || `s-${now.slice(0, 10).replace(/-/g, '')}-${now.slice(11, 19).replace(/:/g, '')}`;
+
+  // 1. Append to sessions.jsonl
+  const sessionEntry = {
+    id: sessionId,
+    date: now.slice(0, 10),
+    duration_min: durationMin,
+    tool_calls: watchState.count,
+    tool_distribution: watchState.toolCounts,
+    skill_invocations: skillEvents.length,
+    skills_used: Object.keys(skillCounts),
+    primary_skill: primarySkill,
+    models_used: modelsUsed,
+    skill_durations: Object.keys(skillDurations).length > 0 ? skillDurations : undefined
+  };
+
+  const sessionsFile = path.join(runeMetricsDir, 'sessions.jsonl');
+  fs.appendFileSync(sessionsFile, JSON.stringify(sessionEntry) + '\n');
+
+  // Cap at 100 sessions (rotate oldest)
+  try {
+    const allLines = fs.readFileSync(sessionsFile, 'utf-8').trim().split('\n').filter(Boolean);
+    if (allLines.length > 100) {
+      fs.writeFileSync(sessionsFile, allLines.slice(-100).join('\n') + '\n');
+    }
+  } catch { /* cap is best-effort */ }
+
+  // 2. Merge into skills.json (running totals)
+  const skillsFile = path.join(runeMetricsDir, 'skills.json');
+  let skillsData = { version: 1, updated: now, skills: {} };
+  if (fs.existsSync(skillsFile)) {
+    try {
+      skillsData = JSON.parse(fs.readFileSync(skillsFile, 'utf-8'));
+    } catch { /* start fresh */ }
+  }
+
+  for (const [skill, count] of Object.entries(skillCounts)) {
+    if (!skillsData.skills[skill]) {
+      skillsData.skills[skill] = { total_invocations: 0, last_used: now.slice(0, 10) };
+    }
+    skillsData.skills[skill].total_invocations += count;
+    skillsData.skills[skill].last_used = now.slice(0, 10);
+  }
+  skillsData.updated = now;
+
+  fs.writeFileSync(skillsFile, JSON.stringify(skillsData, null, 2) + '\n');
+
+  // 3. Append to chains.jsonl
+  if (skillChain.length > 0) {
+    const chainsFile = path.join(runeMetricsDir, 'chains.jsonl');
+    const chainEntry = {
+      session: sessionId,
+      chain: skillChain,
+      depth: skillChain.length
+    };
+    fs.appendFileSync(chainsFile, JSON.stringify(chainEntry) + '\n');
+  }
+
+  // 4. Cleanup tmpdir files
+  try { fs.unlinkSync(metricsJsonl); } catch { /* already gone */ }
+  // Note: counterFile is cleaned by session-start hook on next session
+
+  // Report metrics flush
+  const skillList = Object.entries(skillCounts)
+    .sort((a, b) => b[1] - a[1])
+    .map(([s, c]) => `${s}(${c})`)
+    .join(', ');
+
+  console.log(`\n📊 [Rune metrics] Session ${sessionId} — ${durationMin}min, ${watchState.count} tool calls, ${skillEvents.length} skill invocations`);
+  if (skillList) console.log(`   Skills: ${skillList}`);
+  console.log(`   Saved to .rune/metrics/\n`);
+}
+
+// === Original: Verification Checklist ===
+
+console.log(`
+┌─────────────────────────────────────────────────────┐
+│  Rune Session End — Verification Checklist          │
+├─────────────────────────────────────────────────────┤
+│  Before closing this session, confirm:              │
+│                                                     │
+│  □ All TodoWrite tasks marked complete?             │
+│  □ Tests ran and passing?                           │
+│  □ No hardcoded secrets introduced?                 │
+│  □ If schema changed: migration + rollback exist?   │
+│  □ Verification ran (lint + types + build)?         │
+│                                                     │
+│  If any item is unclear → address it now.           │
+└─────────────────────────────────────────────────────┘
+`);

package/hooks/pre-compact/index.cjs

@@ -1,95 +1,95 @@
-// Rune Pre-Compact Hook
-// Saves critical state BEFORE Claude auto-compacts context window.
-// Prevents data loss from losing decisions, progress, and metrics mid-session.
-//
-// Captures: context-watch state, active task summary, decisions made this session.
-// Writes snapshot to .rune/pre-compact-snapshot.md for post-compact recovery.
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const cwd = process.cwd();
-const runeDir = path.join(cwd, '.rune');
-
-// Read context-watch state (tool counts, session timing)
-const hash = Buffer.from(cwd).toString('base64url').slice(0, 16);
-const counterFile = path.join(os.tmpdir(), `rune-context-watch-${hash}.json`);
-
-let watchState = null;
-try {
-  const raw = fs.readFileSync(counterFile, 'utf-8');
-  watchState = JSON.parse(raw);
-} catch {
-  // No counter file — session may be fresh
-}
-
-// Collect .rune/ state summaries
-const stateFiles = ['progress.md', 'decisions.md', 'conventions.md'];
-const summaries = [];
-
-if (fs.existsSync(runeDir)) {
-  for (const file of stateFiles) {
-    const filePath = path.join(runeDir, file);
-    if (fs.existsSync(filePath)) {
-      try {
-        const content = fs.readFileSync(filePath, 'utf-8').trim();
-        if (content.length > 0) {
-          // Take first 50 lines to keep snapshot compact
-          const lines = content.split('\n').slice(0, 50);
-          summaries.push({ file, preview: lines.join('\n') });
-        }
-      } catch {
-        // Skip unreadable files
-      }
-    }
-  }
-}
-
-// Build snapshot
-const snapshot = [];
-snapshot.push('# Pre-Compact Snapshot');
-snapshot.push(`Generated: ${new Date().toISOString()}`);
-snapshot.push('');
-
-if (watchState) {
-  snapshot.push('## Session Metrics');
-  snapshot.push(`- Tool calls: ${watchState.count || 0}`);
-  snapshot.push(`- Session start: ${watchState.sessionStart || 'unknown'}`);
-  if (watchState.toolCounts) {
-    const top5 = Object.entries(watchState.toolCounts)
-      .sort((a, b) => b[1] - a[1])
-      .slice(0, 5);
-    snapshot.push(`- Top tools: ${top5.map(([k, v]) => `${k}(${v})`).join(', ')}`);
-  }
-  snapshot.push('');
-}
-
-if (summaries.length > 0) {
-  snapshot.push('## State Files (preview)');
-  for (const { file, preview } of summaries) {
-    snapshot.push(`### .rune/${file}`);
-    snapshot.push(preview);
-    snapshot.push('');
-  }
-}
-
-// Write snapshot if we have anything worth saving
-if (watchState || summaries.length > 0) {
-  try {
-    if (!fs.existsSync(runeDir)) {
-      fs.mkdirSync(runeDir, { recursive: true });
-    }
-    fs.writeFileSync(
-      path.join(runeDir, 'pre-compact-snapshot.md'),
-      snapshot.join('\n')
-    );
-    console.log(`[Rune pre-compact] State snapshot saved (${watchState ? watchState.count : 0} tool calls, ${summaries.length} state files).`);
-  } catch (e) {
-    console.error(`[Rune pre-compact] Failed to save snapshot: ${e.message}`);
-  }
-} else {
-  console.log('[Rune pre-compact] No state to snapshot — fresh session.');
-}
-
-process.exit(0);
+// Rune Pre-Compact Hook
+// Saves critical state BEFORE Claude auto-compacts context window.
+// Prevents data loss from losing decisions, progress, and metrics mid-session.
+//
+// Captures: context-watch state, active task summary, decisions made this session.
+// Writes snapshot to .rune/pre-compact-snapshot.md for post-compact recovery.
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const cwd = process.cwd();
+const runeDir = path.join(cwd, '.rune');
+
+// Read context-watch state (tool counts, session timing)
+const hash = Buffer.from(cwd).toString('base64url').slice(0, 16);
+const counterFile = path.join(os.tmpdir(), `rune-context-watch-${hash}.json`);
+
+let watchState = null;
+try {
+  const raw = fs.readFileSync(counterFile, 'utf-8');
+  watchState = JSON.parse(raw);
+} catch {
+  // No counter file — session may be fresh
+}
+
+// Collect .rune/ state summaries
+const stateFiles = ['progress.md', 'decisions.md', 'conventions.md'];
+const summaries = [];
+
+if (fs.existsSync(runeDir)) {
+  for (const file of stateFiles) {
+    const filePath = path.join(runeDir, file);
+    if (fs.existsSync(filePath)) {
+      try {
+        const content = fs.readFileSync(filePath, 'utf-8').trim();
+        if (content.length > 0) {
+          // Take first 50 lines to keep snapshot compact
+          const lines = content.split('\n').slice(0, 50);
+          summaries.push({ file, preview: lines.join('\n') });
+        }
+      } catch {
+        // Skip unreadable files
+      }
+    }
+  }
+}
+
+// Build snapshot
+const snapshot = [];
+snapshot.push('# Pre-Compact Snapshot');
+snapshot.push(`Generated: ${new Date().toISOString()}`);
+snapshot.push('');
+
+if (watchState) {
+  snapshot.push('## Session Metrics');
+  snapshot.push(`- Tool calls: ${watchState.count || 0}`);
+  snapshot.push(`- Session start: ${watchState.sessionStart || 'unknown'}`);
+  if (watchState.toolCounts) {
+    const top5 = Object.entries(watchState.toolCounts)
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 5);
+    snapshot.push(`- Top tools: ${top5.map(([k, v]) => `${k}(${v})`).join(', ')}`);
+  }
+  snapshot.push('');
+}
+
+if (summaries.length > 0) {
+  snapshot.push('## State Files (preview)');
+  for (const { file, preview } of summaries) {
+    snapshot.push(`### .rune/${file}`);
+    snapshot.push(preview);
+    snapshot.push('');
+  }
+}
+
+// Write snapshot if we have anything worth saving
+if (watchState || summaries.length > 0) {
+  try {
+    if (!fs.existsSync(runeDir)) {
+      fs.mkdirSync(runeDir, { recursive: true });
+    }
+    fs.writeFileSync(
+      path.join(runeDir, 'pre-compact-snapshot.md'),
+      snapshot.join('\n')
+    );
+    console.log(`[Rune pre-compact] State snapshot saved (${watchState ? watchState.count : 0} tool calls, ${summaries.length} state files).`);
+  } catch (e) {
+    console.error(`[Rune pre-compact] Failed to save snapshot: ${e.message}`);
+  }
+} else {
+  console.log('[Rune pre-compact] No state to snapshot — fresh session.');
+}
+
+process.exit(0);

package/hooks/run-hook.cmd

@@ -1 +1 @@
-@node "%~dp0run-hook.js" %*
+@node "%~dp0run-hook.js" %*