claude-smith 3.0.0 → 3.2.0

package/bin/cli.mjs

@@ -10,12 +10,13 @@
  *   claude-smith --help   - Show help
  */
 
-import { readFileSync, writeFileSync, mkdirSync, cpSync, existsSync, readdirSync, unlinkSync } from 'fs';
+import { readFileSync, writeFileSync, mkdirSync, cpSync, existsSync, readdirSync, unlinkSync, appendFileSync } from 'fs';
 import { join, dirname, resolve } from 'path';
 import { tmpdir } from 'os';
 import { fileURLToPath } from 'url';
 import { createInterface } from 'readline';
 import { readStats } from '../lib/stats.mjs';
+import { readEvents } from '../lib/event-log.mjs';
 
 const SUPPORTED_LANGS = {
   en: 'English',
@@ -78,7 +79,7 @@ switch (command) {
 
 async function init() {
   const cwd = process.cwd();
-  console.log(`\n🔨 Smith v${VERSION} - init\n`);
+  console.log(`\n🕵️ Smith v${VERSION} - init\n`);
 
   // 0. Determine language
   const lang = await resolveLanguage();
@@ -133,11 +134,29 @@ async function init() {
     console.log(`✅ Settings created → .claude/settings.json`);
   }
 
-  // 6. Inject rules into CLAUDE.md (language-specific)
+  // 6. Create .smith events directory
+  const smithDir = join(cwd, '.smith', 'events');
+  mkdirSync(smithDir, { recursive: true, mode: 0o700 });
+  console.log('✅ Events directory created → .smith/events/');
+
+  // Add .smith/ to .gitignore if not already there
+  const gitignorePath = join(cwd, '.gitignore');
+  if (existsSync(gitignorePath)) {
+    const content = readFileSync(gitignorePath, 'utf8');
+    if (!content.includes('.smith/')) {
+      appendFileSync(gitignorePath, '\n# claude-smith event logs\n.smith/\n');
+      console.log('✅ Added .smith/ to .gitignore');
+    }
+  } else {
+    writeFileSync(gitignorePath, '# claude-smith event logs\n.smith/\n');
+    console.log('✅ Created .gitignore with .smith/');
+  }
+
+  // 7. Inject rules into CLAUDE.md (language-specific)
   const claudeMd = join(cwd, 'CLAUDE.md');
   injectRules(claudeMd, lang);
 
-  // 7. Generate/update config file with user choices
+  // 8. Generate/update config file with user choices
   const configPath = join(cwd, '.claude-smith.json');
   const configData = existsSync(configPath)
     ? JSON.parse(readFileSync(configPath, 'utf8'))
@@ -246,7 +265,7 @@ async function resolveLanguage() {
 
 function update() {
   const cwd = process.cwd();
-  console.log(`\n🔨 Smith v${VERSION} - update\n`);
+  console.log(`\n🕵️ Smith v${VERSION} - update\n`);
 
   // 1. Overwrite hooks (always latest)
   const hooksDir = join(cwd, '.claude', 'hooks');
@@ -300,7 +319,8 @@ function injectRules(claudeMdPath, lang = 'en') {
   const fallback = join(TEMPLATES_DIR, 'rules.en.md');
   const rulesPath = existsSync(rulesFile) ? rulesFile : fallback;
   const rules = readFileSync(rulesPath, 'utf8')
-    .replace(/claude-smith v\d+\.\d+\.\d+/g, `claude-smith v${VERSION}`);
+    .replace(/claude-smith v\d+\.\d+\.\d+/g, `claude-smith v${VERSION}`)
+    .replace(/\{\{SMITH_VERSION\}\}/g, `v${VERSION}`);
 
   if (existsSync(claudeMdPath)) {
     let content = readFileSync(claudeMdPath, 'utf8');
@@ -366,7 +386,7 @@ function check() {
   const ciMode = process.argv.includes('--ci');
   const results = { version: VERSION, ok: true, hooks: {}, settings: false, rules: false };
 
-  if (!ciMode) console.log(`\n🔨 Smith v${VERSION} - check\n`);
+  if (!ciMode) console.log(`\n🕵️ Smith v${VERSION} - check\n`);
 
   // Check hooks
   const hooksDir = join(cwd, '.claude', 'hooks');
@@ -429,7 +449,7 @@ function check() {
 }
 
 function stats() {
-  console.log(`\n🔨 Smith v${VERSION} - stats\n`);
+  console.log(`\n🕵️ Smith v${VERSION} - stats\n`);
 
   // Try to find stats from any active session
   const baseDir = join(tmpdir(), '.claude-smith');
@@ -481,7 +501,7 @@ function stats() {
 
 async function uninstall() {
   const cwd = process.cwd();
-  console.log(`\n🔨 Smith v${VERSION} - uninstall\n`);
+  console.log(`\n🕵️ Smith v${VERSION} - uninstall\n`);
 
   const SMITH_HOOKS = ['tdd-guard.mjs', 'commit-guard.mjs', 'test-tracker.mjs', 'debug-loop.mjs',
     'batch-checkpoint.mjs', 'subagent-inject.mjs', 'commit-message.mjs', 'build-guard.mjs',
@@ -566,11 +586,17 @@ async function uninstall() {
     }
   }
 
+  // 5. Note about .smith/ directory
+  const smithEventsDir = join(cwd, '.smith');
+  if (existsSync(smithEventsDir)) {
+    console.log('ℹ️  Event logs at .smith/ preserved. Delete manually if needed.');
+  }
+
   console.log(`\n🔨 claude-smith uninstalled. Run "claude-smith init" to reinstall.\n`);
 }
 
 function report() {
-  console.log(`\n🔨 Smith v${VERSION} - session report\n`);
+  console.log(`\n🕵️ Smith v${VERSION} - session report\n`);
 
   const baseDir = join(tmpdir(), '.claude-smith');
   if (!existsSync(baseDir)) {
@@ -759,7 +785,7 @@ ${!isPreTool ? "const toolResponse = input.tool_response || {};\n" : ""}
     writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
   }
 
-  console.log(`\n🔨 Smith v${VERSION} - create-hook\n`);
+  console.log(`\n🕵️ Smith v${VERSION} - create-hook\n`);
   console.log(`✅ Hook created → .claude/hooks/${fileName}`);
   console.log(`✅ Registered in .claude/settings.json (${event})`);
   console.log(`\nNext steps:`);
@@ -778,7 +804,7 @@ function escapeHtml(str) {
 }
 
 function dashboard() {
-  console.log(`\n🔨 Smith v${VERSION} - dashboard\n`);
+  console.log(`\n🕵️ Smith v${VERSION} - dashboard\n`);
 
   const baseDir = join(tmpdir(), '.claude-smith');
   if (!existsSync(baseDir)) {
@@ -802,6 +828,9 @@ function dashboard() {
     }
   }
 
+  // Read project-level events for timeline
+  const projectEvents = readEvents(process.cwd(), { days: 7 });
+
   // Calculate totals
   let totalFire = 0, totalWarn = 0, totalBlock = 0;
   for (const counts of Object.values(allStats)) {
@@ -811,31 +840,239 @@ function dashboard() {
   }
   const complianceRate = totalFire > 0 ? ((1 - totalBlock / totalFire) * 100).toFixed(1) : '100.0';
 
+  // Calculate hero card values (value-proof metrics)
+  const getStat = (hookName, type) => (allStats[hookName]?.[type] || 0);
+  const brokenCommitsPrevented = getStat('commit-guard', 'block') + getStat('commit-guard', 'warn') + getStat('build-guard', 'block');
+  const unplannedChangesStopped = getStat('plan-guard', 'warn') + getStat('plan-guard', 'block');
+  const testFirstReminders = getStat('tdd-guard', 'warn');
+  const subagentsDisciplined = getStat('subagent-inject', 'fire');
+
+  // Calculate counterfactual bullets
+  const commitsWithoutTests = getStat('commit-guard', 'warn') + getStat('commit-guard', 'block');
+  const changesWithoutPlans = getStat('plan-guard', 'warn') + getStat('plan-guard', 'block');
+  const debugLoops = getStat('debug-loop', 'warn') + getStat('debug-loop', 'block');
+  const subagentsIgnoringRules = getStat('subagent-inject', 'fire');
+  const largeFilesUnchecked = getStat('file-size-warn', 'warn');
+
+  // Hook insights mapping
+  const HOOK_INSIGHTS = {
+    'tdd-guard': {
+      label: 'TDD Guard',
+      warnMsg: 'Edited code files without corresponding test files.',
+      rec: 'Write a failing test before implementing code. Create {name}.test.{ext} alongside source files.'
+    },
+    'commit-guard': {
+      label: 'Commit Guard',
+      warnMsg: 'Attempted commits without recent test runs.',
+      blockMsg: 'Blocked commits because tests were failing.',
+      rec: 'Run your test suite before every commit. Keep test cycles under 5 minutes.'
+    },
+    'commit-message': {
+      label: 'Commit Message',
+      warnMsg: 'Commit messages didn\'t follow conventional format.',
+      rec: 'Use format: type(scope): description (e.g., feat(auth): add login)'
+    },
+    'debug-loop': {
+      label: 'Debug Loop',
+      warnMsg: 'Same file edited repeatedly — possible symptom-fixing.',
+      blockMsg: 'Editing blocked after too many attempts on the same file.',
+      rec: 'Stop and investigate root cause before the next edit. Add logging, check git diff.'
+    },
+    'file-size-warn': {
+      label: 'File Size',
+      warnMsg: 'Files exceeded 500 lines.',
+      rec: 'Extract components, hooks, or services into separate files.'
+    },
+    'scope-guard': {
+      label: 'Scope Guard',
+      warnMsg: 'Changes spanned too many directories.',
+      rec: 'Break work into smaller, focused commits touching fewer areas.'
+    },
+    'batch-checkpoint': {
+      label: 'Batch Checkpoint',
+      warnMsg: 'Multiple files edited without progress reports.',
+      rec: 'Report progress to the user every 3 files.'
+    },
+    'plan-guard': {
+      label: 'Plan Guard',
+      warnMsg: 'Many code files edited without a decomposition plan.',
+      blockMsg: 'Editing blocked — too many files changed without a plan.',
+      rec: 'Create a plan file (docs/plans/*.md) before large changes.'
+    },
+    'subagent-inject': {
+      label: 'Rule Injection',
+      desc: 'Rules were injected into subagent contexts.',
+      isGood: true
+    },
+    'test-tracker': {
+      label: 'Test Tracker',
+      desc: 'Test runs were tracked.',
+      warnMsg: 'Test coverage decreased between runs.',
+      isGood: true
+    },
+    'build-tracker': {
+      label: 'Build Tracker',
+      desc: 'Build results were tracked.',
+      isGood: true
+    },
+    'build-guard': {
+      label: 'Build Guard',
+      blockMsg: 'Blocked commits because the build was failing.',
+      rec: 'Fix build errors before committing.'
+    }
+  };
+
   // Generate HTML
   const hookNames = Object.keys(allStats).sort();
   const fireData = hookNames.map(h => allStats[h].fire);
   const warnData = hookNames.map(h => allStats[h].warn);
   const blockData = hookNames.map(h => allStats[h].block);
 
+  // Generate insights cards
+  const insightsHtml = hookNames.map((hookName) => {
+    const counts = allStats[hookName];
+    const insight = HOOK_INSIGHTS[hookName];
+
+    // Skip hooks with no activity
+    if (counts.fire === 0 && counts.warn === 0 && counts.block === 0) return '';
+
+    if (!insight) return ''; // Skip unknown hooks
+
+    const hasBlocks = counts.block > 0;
+    const hasWarns = counts.warn > 0;
+    const isGood = insight.isGood && !hasWarns && !hasBlocks;
+
+    // Determine card class and status
+    let cardClass = 'insight-card';
+    let status = '✅';
+    let message = insight.desc || '';
+    let recommendation = '';
+
+    if (hasBlocks) {
+      cardClass += ' block';
+      status = '🔴';
+      message = insight.blockMsg || insight.warnMsg || '';
+      recommendation = insight.rec || '';
+    } else if (hasWarns) {
+      cardClass += ' warn';
+      status = '⚠️';
+      message = insight.warnMsg || '';
+      recommendation = insight.rec || '';
+    } else if (isGood) {
+      cardClass += ' good';
+      status = '✅';
+    } else {
+      return ''; // No warns/blocks and not marked as good
+    }
+
+    // Build count text
+    let countText = '';
+    if (hasBlocks) countText = `${counts.block} block${counts.block > 1 ? 's' : ''}`;
+    else if (hasWarns) countText = `${counts.warn} warning${counts.warn > 1 ? 's' : ''}`;
+    else if (isGood) countText = `${counts.fire} trigger${counts.fire > 1 ? 's' : ''}`;
+
+    return `    <div class="${cardClass}">
+      <div class="insight-header">
+        <span class="insight-status">${status}</span>
+        <span class="insight-name">${escapeHtml(insight.label)}</span>
+        <span class="insight-count">${escapeHtml(countText)}</span>
+      </div>
+      ${message ? `<p class="insight-desc">${escapeHtml(message)}</p>` : ''}
+      ${recommendation ? `<p class="insight-rec">💡 ${escapeHtml(recommendation)}</p>` : ''}
+    </div>`;
+  }).filter(Boolean).join('\n');
+
+  // Generate health summary
+  let healthSummary = '';
+  const complianceNum = parseFloat(complianceRate);
+  if (complianceNum > 90 && totalBlock === 0) {
+    healthSummary = '🟢 Excellent session discipline. Keep it up!';
+  } else if (complianceNum > 70) {
+    healthSummary = '🟡 Good discipline with room for improvement. Focus on the areas below.';
+  } else {
+    healthSummary = '🔴 Multiple enforcement issues detected. Review the insights below.';
+  }
+
+  // Build counterfactual bullets (only show if count > 0)
+  const counterfactualBullets = [
+    commitsWithoutTests > 0 ? `    <li>📛 <strong>${commitsWithoutTests}</strong> commits without verified tests</li>` : '',
+    changesWithoutPlans > 0 ? `    <li>📂 <strong>${changesWithoutPlans}</strong> large changes without decomposition plans</li>` : '',
+    debugLoops > 0 ? `    <li>🔄 <strong>${debugLoops}</strong> debug loops (same file edited repeatedly)</li>` : '',
+    subagentsIgnoringRules > 0 ? `    <li>🤖 <strong>${subagentsIgnoringRules}</strong> subagents ignoring project rules</li>` : '',
+    largeFilesUnchecked > 0 ? `    <li>📏 <strong>${largeFilesUnchecked}</strong> files growing past 500 lines unchecked</li>` : ''
+  ].filter(Boolean).join('\n');
+
+  // Timeline generation
+  const EVENT_ICONS = {
+    'tdd-guard': { icon: '🧪', color: '#d29922' },
+    'commit-guard': { icon: '✅', color: '#3fb950' },
+    'commit-message': { icon: '📝', color: '#d29922' },
+    'build-guard': { icon: '🏗️', color: '#f85149' },
+    'test-tracker': { icon: '🧪', color: '#58a6ff' },
+    'build-tracker': { icon: '🏗️', color: '#58a6ff' },
+    'debug-loop': { icon: '🔄', color: '#f85149' },
+    'file-size-warn': { icon: '📏', color: '#d29922' },
+    'scope-guard': { icon: '📂', color: '#d29922' },
+    'batch-checkpoint': { icon: '📋', color: '#58a6ff' },
+    'plan-guard': { icon: '📋', color: '#d29922' },
+    'subagent-inject': { icon: '🤖', color: '#3fb950' }
+  };
+
+  const HOOK_LABELS = {
+    'tdd-guard': 'TDD Guard',
+    'commit-guard': 'Commit Guard',
+    'commit-message': 'Commit Msg',
+    'build-guard': 'Build Guard',
+    'test-tracker': 'Test Tracker',
+    'build-tracker': 'Build Tracker',
+    'debug-loop': 'Debug Loop',
+    'file-size-warn': 'File Size',
+    'scope-guard': 'Scope Guard',
+    'batch-checkpoint': 'Checkpoint',
+    'plan-guard': 'Plan Guard',
+    'subagent-inject': 'Agent Inject'
+  };
+
+  const recentEvents = projectEvents.slice(-50).reverse();
+
+  const timelineHtml = recentEvents.length > 0
+    ? recentEvents.map(ev => {
+        const time = new Date(ev.t).toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: false });
+        const iconInfo = EVENT_ICONS[ev.h] || { icon: '📌', color: '#8b949e' };
+        const label = HOOK_LABELS[ev.h] || ev.h;
+        const evClass = ev.e === 'block' ? 'block' : ev.e === 'warn' ? 'warn' : '';
+        const fileDisplay = ev.f ? ev.f.split('/').slice(-2).join('/') : '';
+        return `  <div class="timeline-event ${evClass}">
+    <span class="timeline-time">${escapeHtml(time)}</span>
+    <span class="timeline-icon">${iconInfo.icon}</span>
+    <span class="timeline-hook">${escapeHtml(label)}</span>
+    <span class="timeline-msg">${escapeHtml(ev.m || '')}</span>
+    <span class="timeline-file">${escapeHtml(fileDisplay)}</span>
+  </div>`;
+      }).join('\n')
+    : '';
+
   const html = `<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>claude-smith Compliance Dashboard</title>
+<title>🕵️ Smith Dashboard</title>
 <style>
   * { margin: 0; padding: 0; box-sizing: border-box; }
   body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: #0d1117; color: #c9d1d9; padding: 2rem; }
   h1 { color: #58a6ff; margin-bottom: 0.5rem; }
   .subtitle { color: #8b949e; margin-bottom: 2rem; }
-  .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin-bottom: 2rem; }
-  .card { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 1.5rem; }
-  .card-label { color: #8b949e; font-size: 0.85rem; text-transform: uppercase; }
-  .card-value { font-size: 2rem; font-weight: bold; margin-top: 0.5rem; }
-  .card-value.green { color: #3fb950; }
-  .card-value.yellow { color: #d29922; }
-  .card-value.red { color: #f85149; }
-  .card-value.blue { color: #58a6ff; }
+  .hero-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 1.5rem; margin-bottom: 2.5rem; }
+  .hero-card { background: #161b22; border: 1px solid #30363d; border-radius: 12px; padding: 2rem 1.5rem; text-align: center; }
+  .hero-icon { font-size: 2.5rem; margin-bottom: 0.5rem; }
+  .hero-value { font-size: 3rem; font-weight: 800; color: #58a6ff; line-height: 1; }
+  .hero-label { color: #8b949e; font-size: 0.9rem; margin-top: 0.5rem; line-height: 1.3; }
+  .counterfactual { background: linear-gradient(135deg, #1a1e2e 0%, #161b22 100%); border: 1px solid #30363d; border-left: 4px solid #f85149; border-radius: 8px; padding: 1.5rem 2rem; margin-bottom: 2.5rem; }
+  .counterfactual h2 { color: #f0f6fc; font-size: 1.1rem; margin-bottom: 1rem; }
+  .counterfactual ul { list-style: none; }
+  .counterfactual li { padding: 0.4rem 0; color: #c9d1d9; font-size: 0.95rem; }
+  .counterfactual strong { color: #f85149; font-size: 1.1rem; }
   table { width: 100%; border-collapse: collapse; background: #161b22; border-radius: 8px; overflow: hidden; }
   th, td { padding: 0.75rem 1rem; text-align: left; border-bottom: 1px solid #30363d; }
   th { background: #21262d; color: #8b949e; font-weight: 600; text-transform: uppercase; font-size: 0.8rem; }
@@ -846,32 +1083,81 @@ function dashboard() {
   .legend { display: flex; gap: 1.5rem; margin: 1rem 0; }
   .legend-item { display: flex; align-items: center; gap: 0.4rem; font-size: 0.85rem; }
   .legend-dot { width: 12px; height: 12px; border-radius: 3px; }
+  .section-title { color: #58a6ff; margin: 2rem 0 0.5rem; font-size: 1.3rem; }
+  .health-summary { color: #8b949e; margin-bottom: 1.5rem; font-size: 1rem; }
+  .insights-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(320px, 1fr)); gap: 1rem; margin-bottom: 2rem; }
+  .insight-card { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 1.25rem; }
+  .insight-card.good { border-left: 3px solid #3fb950; }
+  .insight-card.warn { border-left: 3px solid #d29922; }
+  .insight-card.block { border-left: 3px solid #f85149; }
+  .insight-header { display: flex; align-items: center; gap: 0.5rem; margin-bottom: 0.75rem; }
+  .insight-name { font-weight: 600; color: #c9d1d9; }
+  .insight-count { color: #8b949e; font-size: 0.85rem; margin-left: auto; }
+  .insight-desc { color: #8b949e; font-size: 0.9rem; margin-bottom: 0.5rem; }
+  .insight-rec { color: #58a6ff; font-size: 0.85rem; }
+  .timeline { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 1rem; max-height: 500px; overflow-y: auto; margin-bottom: 2rem; }
+  .timeline-subtitle { color: #484f58; font-size: 0.85rem; margin-bottom: 1rem; }
+  .timeline-event { display: grid; grid-template-columns: 55px 30px 120px 1fr auto; align-items: center; gap: 0.5rem; padding: 0.5rem 0.75rem; border-bottom: 1px solid #21262d; font-size: 0.85rem; }
+  .timeline-event:last-child { border-bottom: none; }
+  .timeline-event.warn { background: rgba(210, 153, 34, 0.08); }
+  .timeline-event.block { background: rgba(248, 81, 73, 0.1); }
+  .timeline-time { color: #484f58; font-family: monospace; font-size: 0.8rem; }
+  .timeline-icon { font-size: 1rem; text-align: center; }
+  .timeline-hook { color: #8b949e; font-weight: 500; }
+  .timeline-msg { color: #c9d1d9; }
+  .timeline-file { color: #58a6ff; font-family: monospace; font-size: 0.8rem; max-width: 200px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  .timeline-empty { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 2rem; text-align: center; color: #484f58; margin-bottom: 2rem; }
   footer { margin-top: 2rem; color: #484f58; font-size: 0.8rem; }
+  @media (max-width: 900px) { .hero-grid { grid-template-columns: repeat(2, 1fr); } }
+  @media (max-width: 700px) { .timeline-event { grid-template-columns: 50px 25px 1fr; } .timeline-file, .timeline-hook { display: none; } }
+  @media (max-width: 500px) { .hero-grid { grid-template-columns: 1fr; } }
 </style>
 </head>
 <body>
-  <h1>🔨 claude-smith Dashboard</h1>
-  <p class="subtitle">Compliance Report — generated ${new Date().toISOString().split('T')[0]}</p>
-
-  <div class="grid">
-    <div class="card">
-      <div class="card-label">Compliance Rate</div>
-      <div class="card-value ${parseFloat(complianceRate) >= 90 ? 'green' : parseFloat(complianceRate) >= 70 ? 'yellow' : 'red'}">${escapeHtml(complianceRate)}%</div>
+  <h1>🕵️ Smith</h1>
+  <p class="subtitle">Session Protection Report — ${new Date().toISOString().split('T')[0]}</p>
+
+  <div class="hero-grid">
+    <div class="hero-card">
+      <div class="hero-icon">🚫</div>
+      <div class="hero-value">${brokenCommitsPrevented}</div>
+      <div class="hero-label">Broken Commits<br>Prevented</div>
     </div>
-    <div class="card">
-      <div class="card-label">Total Triggers</div>
-      <div class="card-value blue">${escapeHtml(totalFire)}</div>
+    <div class="hero-card">
+      <div class="hero-icon">📋</div>
+      <div class="hero-value">${unplannedChangesStopped}</div>
+      <div class="hero-label">Unplanned Changes<br>Stopped</div>
     </div>
-    <div class="card">
-      <div class="card-label">Warnings</div>
-      <div class="card-value yellow">${escapeHtml(totalWarn)}</div>
+    <div class="hero-card">
+      <div class="hero-icon">🧪</div>
+      <div class="hero-value">${testFirstReminders}</div>
+      <div class="hero-label">Test-First<br>Reminders</div>
     </div>
-    <div class="card">
-      <div class="card-label">Blocks</div>
-      <div class="card-value red">${escapeHtml(totalBlock)}</div>
+    <div class="hero-card">
+      <div class="hero-icon">🤖</div>
+      <div class="hero-value">${subagentsDisciplined}</div>
+      <div class="hero-label">Subagents<br>Disciplined</div>
     </div>
   </div>
 
+  ${counterfactualBullets ? `<div class="counterfactual">
+    <h2>⚡ Without Smith, this session would have had:</h2>
+    <ul>
+${counterfactualBullets}
+    </ul>
+  </div>` : ''}
+
+  ${recentEvents.length > 0 ? `<h2 class="section-title">📅 Session Timeline</h2>
+  <p class="timeline-subtitle">Last ${recentEvents.length} events</p>
+  <div class="timeline">
+${timelineHtml}
+  </div>` : `<h2 class="section-title">📅 Session Timeline</h2>
+  <div class="timeline-empty">
+    <p>No events recorded yet. Events will appear as Smith hooks activate during your sessions.</p>
+  </div>`}
+
+  <h2 class="section-title">📊 Detailed Activity</h2>
+
   <div class="legend">
     <div class="legend-item"><div class="legend-dot bar-fire"></div> Fired</div>
     <div class="legend-item"><div class="legend-dot bar-warn"></div> Warned</div>
@@ -897,7 +1183,13 @@ ${hookNames.map((name, i) => {
     </tbody>
   </table>
 
-  <footer>Generated by claude-smith v${escapeHtml(VERSION)} | ${escapeHtml(new Date().toISOString())}</footer>
+  <h2 class="section-title">💡 Insights & Recommendations</h2>
+  <p class="health-summary">${escapeHtml(healthSummary)}</p>
+  <div class="insights-grid">
+${insightsHtml}
+  </div>
+
+  <footer>Generated by 🕵️ Smith v${escapeHtml(VERSION)} | ${escapeHtml(new Date().toISOString())}</footer>
 </body>
 </html>`;
 
@@ -909,7 +1201,7 @@ ${hookNames.map((name, i) => {
 
 function help() {
   console.log(`
-🔨 Smith v${VERSION}
+🕵️ Smith v${VERSION}
 Claude Code workflow enforcement CLI - forging coding discipline into every session
 
 Usage:

package/hooks/batch-checkpoint.mjs

@@ -5,33 +5,23 @@
  * Counts distinct files edited, reminds to report progress at threshold (default: 3)
  */
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { writeFileSync, existsSync, mkdirSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { tmpdir } from 'os';
 import { getHookConfig } from '../lib/config.mjs';
 import { recordEvent } from '../lib/stats.mjs';
+import { appendEvent } from '../lib/event-log.mjs';
+import { sanitizeId, parseHookInput, isOmcAutoMode, notifyUser } from '../lib/hook-utils.mjs';
 
 const config = getHookConfig('batch-checkpoint', process.cwd());
 if (!config.enabled) process.exit(0);
 
 // Skip in OMC autonomous execution modes (autopilot, ultrawork, ralph)
 // These modes manage their own progress reporting and checkpoint would interfere
-const omcStateDir = join(process.cwd(), '.omc', 'state');
-const omcAutoModes = ['autopilot-state.json', 'ultrawork-state.json', 'ralph-state.json'];
-const isOmcAutoMode = omcAutoModes.some(f => {
-  try {
-    const state = JSON.parse(readFileSync(join(omcStateDir, f), 'utf8'));
-    return state.active === true || state.status === 'running';
-  } catch { return false; }
-});
-if (isOmcAutoMode) process.exit(0);
+if (isOmcAutoMode(process.cwd())) process.exit(0);
 
-let input;
-try {
-  input = JSON.parse(readFileSync(0, 'utf8'));
-} catch {
-  process.exit(0);
-}
+const input = parseHookInput();
+if (!input) process.exit(0);
 
 const toolName = input.tool_name;
 const filePath = input.tool_input?.file_path || '';
@@ -42,11 +32,6 @@ if (!filePath) process.exit(0);
 // Skip non-source files
 if (!/\.(ts|tsx|js|jsx|py|go|rs|css|json)$/.test(filePath)) process.exit(0);
 
-function sanitizeId(id) {
-  if (!id || typeof id !== 'string') return 'default';
-  return id.replace(/[^a-zA-Z0-9_-]/g, '').slice(0, 128) || 'default';
-}
-
 const sessionId = sanitizeId(input.session_id);
 const stateDir = join(tmpdir(), '.claude-smith', sessionId);
 mkdirSync(stateDir, { recursive: true, mode: 0o700 });
@@ -71,10 +56,12 @@ if (!editedFiles.includes(filePath)) {
 // Every N distinct files, trigger checkpoint reminder
 if (editedFiles.length > 0 && editedFiles.length % config.fileThreshold === 0) {
   recordEvent(sessionId, 'batch-checkpoint', 'warn');
+  appendEvent(process.cwd(), { hook: 'batch-checkpoint', event: 'warn', message: `${editedFiles.length} files edited` });
+  notifyUser(config.notify, 'Batch Checkpoint', 'warn', `${editedFiles.length}개 파일 편집`);
   const output = JSON.stringify({
     hookSpecificOutput: {
       hookEventName: "PostToolUse",
-      additionalContext: `🔨 Smith 📋 Batch Checkpoint (rule 2-9): ${editedFiles.length} files edited. Report progress to user before continuing.`
+      additionalContext: `🕵️ Smith 📋 Batch Checkpoint (rule 2-9): ${editedFiles.length} files edited. Report progress to user before continuing.`
     }
   });
   process.stdout.write(output);

package/hooks/build-guard.mjs

@@ -10,16 +10,14 @@ import { join } from 'path';
 import { tmpdir } from 'os';
 import { getHookConfig } from '../lib/config.mjs';
 import { recordEvent } from '../lib/stats.mjs';
+import { appendEvent } from '../lib/event-log.mjs';
+import { sanitizeId, parseHookInput, notifyUser } from '../lib/hook-utils.mjs';
 
 const config = getHookConfig('build-guard', process.cwd());
 if (!config.enabled) process.exit(0);
 
-let input;
-try {
-  input = JSON.parse(readFileSync(0, 'utf8'));
-} catch {
-  process.exit(0);
-}
+const input = parseHookInput();
+if (!input) process.exit(0);
 
 const command = input.tool_input?.command || '';
 
@@ -27,11 +25,6 @@ if (input.tool_name !== 'Bash') process.exit(0);
 if (!command.includes('git commit')) process.exit(0);
 if (command.includes('--allow-empty')) process.exit(0);
 
-function sanitizeId(id) {
-  if (!id || typeof id !== 'string') return 'default';
-  return id.replace(/[^a-zA-Z0-9_-]/g, '').slice(0, 128) || 'default';
-}
-
 const sessionId = sanitizeId(input.session_id);
 const stateDir = join(tmpdir(), '.claude-smith', sessionId);
 const lastBuildResult = join(stateDir, 'last-build-result');
@@ -42,7 +35,9 @@ if (existsSync(lastBuildResult)) {
   const result = readFileSync(lastBuildResult, 'utf8').trim();
   if (result === 'fail') {
     recordEvent(sessionId, 'build-guard', 'block');
-    process.stderr.write("🔨 Smith ✋ Commit blocked: last build FAILED. Run build and fix errors before committing.");
+    appendEvent(process.cwd(), { hook: 'build-guard', event: 'block', message: 'Build failing' });
+    notifyUser(config.notify, 'Build Guard', 'block', '빌드 실패 — 커밋 차단');
+    process.stderr.write("🕵️ Smith ✋ Commit blocked: last build FAILED. Run build and fix errors before committing.");
     process.exit(2);
   }
 }