@pcircle/memesh 2.10.1 → 3.0.0

package/scripts/hooks/session-start.js

@@ -1,647 +1,150 @@
 #!/usr/bin/env node
 
-/**
- * SessionStart Hook - Claude Code Event-Driven Hooks
- *
- * Triggered at the start of each Claude Code session.
- *
- * Features:
- * - Checks MeMesh MCP server availability
- * - Auto-recalls last session key points from MeMesh
- * - Reads recommendations from last session
- * - Displays suggested skills to load
- * - Shows warnings (quota, slow tools, etc.)
- * - Initializes current session state
- */
+import { createRequire } from 'module';
+import { homedir } from 'os';
+import { join, basename } from 'path';
+import { existsSync } from 'fs';
 
-import {
-  HOME_DIR,
-  STATE_DIR,
-  MEMESH_DB_PATH,
-  THRESHOLDS,
-  readJSONFile,
-  writeJSONFile,
-  sqliteQueryJSON,
-  getTimeAgo,
-  logError,
-  queryActivePlans,
-  renderTimelineCompact,
-} from './hook-utils.js';
-import { buildSessionRecallQuery, formatRecallOutput } from './session-start-recall-utils.js';
-import fs from 'fs';
-import path from 'path';
-import { execFileSync } from 'child_process';
+const require = createRequire(import.meta.url);
 
-// ============================================================================
-// File Paths
-// ============================================================================
-
-const CCB_HEARTBEAT_FILE = path.join(STATE_DIR, 'ccb-heartbeat.json');
-const MCP_SETTINGS_FILE = path.join(HOME_DIR, '.claude', 'mcp_settings.json');
-const RECOMMENDATIONS_FILE = path.join(STATE_DIR, 'recommendations.json');
-const SESSION_CONTEXT_FILE = path.join(STATE_DIR, 'session-context.json');
-const CURRENT_SESSION_FILE = path.join(STATE_DIR, 'current-session.json');
-const LAST_SESSION_CACHE_FILE = path.join(STATE_DIR, 'last-session-summary.json');
-
-/** Maximum cache age: 7 days */
-const CACHE_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;
-
-// ============================================================================
-// MeMesh Status Check
-// ============================================================================
-
-/**
- * Check MeMesh MCP Server availability
- * @returns {{ configured: boolean, running: boolean, lastHeartbeat: string|null, serverPath: string|null }}
- */
-function checkCCBAvailability() {
-  const result = {
-    configured: false,
-    running: false,
-    lastHeartbeat: null,
-    serverPath: null,
-  };
-
-  // Check if MeMesh is configured in MCP settings
-  try {
-    if (fs.existsSync(MCP_SETTINGS_FILE)) {
-      const mcpSettings = JSON.parse(fs.readFileSync(MCP_SETTINGS_FILE, 'utf-8'));
-
-      // Check for MeMesh and legacy names (backward compatibility)
-      const ccbNames = [
-        'memesh',
-        '@pcircle/memesh',
-        '@pcircle/claude-code-buddy-mcp',
-        'claude-code-buddy',
-        'ccb',
-      ];
-
-      for (const name of ccbNames) {
-        if (mcpSettings.mcpServers && mcpSettings.mcpServers[name]) {
-          result.configured = true;
-          result.serverPath = mcpSettings.mcpServers[name].args?.[0] || 'configured';
-          break;
-        }
-      }
-    }
-  } catch (err) {
-    logError('checkCCBAvailability:mcp_settings', err);
-  }
-
-  // Check heartbeat file (MeMesh writes this when running)
-  try {
-    if (fs.existsSync(CCB_HEARTBEAT_FILE)) {
-      const heartbeat = JSON.parse(fs.readFileSync(CCB_HEARTBEAT_FILE, 'utf-8'));
-      result.lastHeartbeat = heartbeat.timestamp;
-
-      const heartbeatTime = new Date(heartbeat.timestamp).getTime();
-      const now = Date.now();
-
-      if (now - heartbeatTime < THRESHOLDS.HEARTBEAT_VALIDITY) {
-        result.running = true;
-      }
-    }
-  } catch (err) {
-    logError('checkCCBAvailability:heartbeat', err);
-  }
-
-  return result;
-}
-
-/**
- * Display MeMesh status and reminder
- */
-function displayCCBStatus(ccbStatus) {
-  console.log('═'.repeat(60));
-  console.log('  🤖 MeMesh Status');
-  console.log('═'.repeat(60));
-
-  if (!ccbStatus.configured) {
-    console.log('');
-    console.log('  ⚠️  MeMesh MCP Server is NOT configured!');
-    console.log('');
-    console.log('  MeMesh provides memory management and knowledge graph tools.');
-    console.log('  To configure MeMesh, add it to ~/.claude/mcp_settings.json');
-    console.log('');
-    console.log('  Available MeMesh tools when connected:');
-    console.log('    • buddy-remember: Query past knowledge');
-    console.log('    • buddy-do: Execute common operations');
-    console.log('    • memesh-create-entities: Store new knowledge to graph');
-    console.log('');
-  } else if (!ccbStatus.running) {
-    console.log('');
-    console.log('  ℹ️  MeMesh is configured but status unknown');
-    console.log(`  Path: ${ccbStatus.serverPath}`);
-    console.log('');
-    console.log('  📝 REMINDER: Use MeMesh tools for memory management:');
-    console.log('');
-    console.log('  Before starting work:');
-    console.log('    buddy-remember "relevant topic" - Query past experiences');
-    console.log('');
-    console.log('  After completing work:');
-    console.log('    memesh-create-entities - Store new learnings');
-    console.log('    memesh-record-mistake - Record errors for future reference');
-    console.log('');
-    console.log('  💡 If MeMesh tools fail, check MCP server status.');
-    console.log('');
-  } else {
-    console.log('');
-    console.log('  ✅ MeMesh MCP Server is running');
-    console.log(`  Last heartbeat: ${ccbStatus.lastHeartbeat}`);
-    console.log('');
-    console.log('  📋 Session Start Checklist:');
-    console.log('    ☐ buddy-remember - Query relevant past knowledge');
-    console.log('');
-    console.log('  📋 Session End Checklist:');
-    console.log('    ☐ memesh-create-entities - Store new learnings');
-    console.log('    ☐ memesh-record-mistake - Record any errors');
-    console.log('');
-  }
-
-  console.log('═'.repeat(60));
-  console.log('');
-}
-
-// ============================================================================
-// Memory Recall
-// ============================================================================
-
-/**
- * Try to read session summary from cache file (fast path).
- * Cache is written by stop.js on session end.
- * @returns {{ entityName: string, createdAt: string, metadata: object, keyPoints: string[] } | null}
- */
-function recallFromCache() {
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => { input += chunk; });
+process.stdin.on('end', () => {
   try {
-    if (!fs.existsSync(LAST_SESSION_CACHE_FILE)) {
-      return null;
-    }
-
-    const cache = readJSONFile(LAST_SESSION_CACHE_FILE, null);
-    if (!cache || !cache.savedAt || !cache.keyPoints) {
-      return null;
-    }
-
-    // Check staleness
-    const cacheAge = Date.now() - new Date(cache.savedAt).getTime();
-    if (cacheAge > CACHE_MAX_AGE_MS) {
-      // Stale cache — delete it
-      try { fs.unlinkSync(LAST_SESSION_CACHE_FILE); } catch { /* ignore */ }
-      return null;
-    }
-
-    return {
-      entityName: 'session_cache',
-      createdAt: cache.savedAt,
-      metadata: {
-        duration: cache.duration,
-        toolCount: cache.toolCount,
-      },
-      keyPoints: cache.keyPoints,
-    };
-  } catch (error) {
-    logError('recallFromCache', error);
-    return null;
-  }
-}
-
-/**
- * Recall recent session key points from MeMesh (slow path — SQLite query).
- * Used as fallback when cache is not available.
- * @returns {{ entityName: string, createdAt: string, metadata: object, keyPoints: string[] } | null}
- */
-function recallFromSQLite() {
-  try {
-    if (!fs.existsSync(MEMESH_DB_PATH)) {
-      return null;
-    }
-
-    const cutoffDate = new Date();
-    cutoffDate.setDate(cutoffDate.getDate() - THRESHOLDS.RECALL_DAYS);
-    const cutoffISO = cutoffDate.toISOString();
-
-    const query = `
-      SELECT id, name, metadata, created_at
-      FROM entities
-      WHERE type = ? AND created_at > ?
-      ORDER BY created_at DESC
-      LIMIT 1
-    `.replace(/\n/g, ' ');
-
-    // Use JSON mode to avoid pipe-split issues with | in metadata
-    const entityRows = sqliteQueryJSON(
-      MEMESH_DB_PATH,
-      query,
-      ['session_keypoint', cutoffISO]
-    );
-
-    if (!entityRows || entityRows.length === 0) {
-      return null;
-    }
-
-    const row = entityRows[0];
-    const entityId = row.id;
-    const entityName = row.name;
-    const createdAt = row.created_at;
-
-    // Observations also use JSON mode for safety
-    const obsRows = sqliteQueryJSON(
-      MEMESH_DB_PATH,
-      'SELECT content FROM observations WHERE entity_id = ? ORDER BY created_at ASC',
-      [entityId]
-    );
-
-    const keyPoints = (obsRows || []).map(r => r.content).filter(Boolean);
-
-    let parsedMetadata = {};
-    try {
-      parsedMetadata = JSON.parse(row.metadata || '{}');
-    } catch (parseErr) {
-      logError('recallFromSQLite:metadata-parse', parseErr);
-    }
-
-    return {
-      entityName,
-      createdAt,
-      metadata: parsedMetadata,
-      keyPoints,
-    };
-  } catch (error) {
-    logError('recallFromSQLite', error);
-    return null;
-  }
-}
-
-/**
- * Recall recent session key points — cache-first, SQLite fallback.
- * @returns {{ entityName: string, createdAt: string, metadata: object, keyPoints: string[] } | null}
- */
-function recallRecentKeyPoints() {
-  // Fast path: read from cache file (no sqlite3 spawn)
-  const cached = recallFromCache();
-  if (cached) {
-    return cached;
-  }
-
-  // Slow path: query SQLite
-  return recallFromSQLite();
-}
-
-/**
- * Display recalled key points from last session
- */
-function displayRecalledMemory(recalledData) {
-  console.log('═'.repeat(60));
-  console.log('  🧠 MeMesh Memory Recall');
-  console.log('═'.repeat(60));
-
-  if (!recalledData || !recalledData.keyPoints || recalledData.keyPoints.length === 0) {
-    console.log('');
-    console.log('  ℹ️  No recent memories found (last 30 days)');
-    console.log('  💡 Memories will be auto-saved when this session ends');
-    console.log('');
-    console.log('═'.repeat(60));
-    console.log('');
-    return;
-  }
-
-  console.log('');
-
-  // Display timestamp
-  const savedTime = new Date(recalledData.createdAt);
-  const timeAgo = getTimeAgo(savedTime);
-  console.log(`  🕐 Saved: ${timeAgo}`);
-
-  // Display metadata if available
-  if (recalledData.metadata) {
-    const meta = recalledData.metadata;
-    if (meta.duration) {
-      console.log(`  ⏱️  Last session duration: ${meta.duration}`);
-    }
-    if (meta.toolCount) {
-      console.log(`  🛠️  Tools used: ${meta.toolCount}`);
-    }
-  }
-
-  console.log('');
-  console.log('  📋 Key Points:');
-
-  // Display key points with formatting
-  recalledData.keyPoints.forEach(point => {
-    if (point.startsWith('[SESSION]')) {
-      console.log(`    📊 ${point.replace('[SESSION] ', '')}`);
-    } else if (point.startsWith('[WORK]')) {
-      console.log(`    📁 ${point.replace('[WORK] ', '')}`);
-    } else if (point.startsWith('[COMMIT]')) {
-      console.log(`    ✅ ${point.replace('[COMMIT] ', '')}`);
-    } else if (point.startsWith('[ISSUE]') || point.startsWith('[PROBLEM]')) {
-      console.log(`    ⚠️  ${point.replace(/\[(ISSUE|PROBLEM)\] /, '')}`);
-    } else if (point.startsWith('[LEARN]')) {
-      console.log(`    💡 ${point.replace('[LEARN] ', '')}`);
-    } else if (point.startsWith('[TASK]')) {
-      console.log(`    📝 ${point.replace('[TASK] ', '')}`);
-    } else if (point.startsWith('[DECISION]')) {
-      console.log(`    🎯 ${point.replace('[DECISION] ', '')}`);
-    } else if (point.startsWith('[PATTERN]')) {
-      console.log(`    🔄 ${point.replace('[PATTERN] ', '')}`);
-    } else if (point.startsWith('[SCOPE]') || point.startsWith('[FOCUS]')) {
-      console.log(`    🎯 ${point.replace(/\[(SCOPE|FOCUS)\] /, '')}`);
-    } else if (point.startsWith('[NOTE]')) {
-      console.log(`    📌 ${point.replace('[NOTE] ', '')}`);
-    } else {
-      console.log(`    • ${point}`);
+    const data = JSON.parse(input);
+    const projectName = basename(data.cwd || process.cwd());
+
+    // Find database
+    const dbPath = process.env.MEMESH_DB_PATH || join(homedir(), '.memesh', 'knowledge-graph.db');
+    if (!existsSync(dbPath)) {
+      output('MeMesh: No database found. Memories will be created as you work.');
+      return;
     }
-  });
-
-  console.log('');
-  console.log('═'.repeat(60));
-  console.log('');
-}
 
-// ============================================================================
-// CLAUDE.md Reload
-// ============================================================================
-
-/**
- * Find and display project CLAUDE.md content on session start.
- * This ensures instructions are fresh in context even after compaction.
- * Searches: CWD/.claude/CLAUDE.md, CWD/CLAUDE.md
- */
-function reloadClaudeMd() {
-  const cwd = process.cwd();
-  const candidates = [
-    path.join(cwd, '.claude', 'CLAUDE.md'),
-    path.join(cwd, 'CLAUDE.md'),
-  ];
-
-  for (const candidate of candidates) {
+    const Database = require('better-sqlite3');
+    const db = new Database(dbPath, { readonly: true });
     try {
-      if (fs.existsSync(candidate)) {
-        const content = fs.readFileSync(candidate, 'utf-8');
-        const lineCount = content.split('\n').length;
-        const relativePath = path.relative(cwd, candidate);
-
-        console.log('═'.repeat(60));
-        console.log('  📋 CLAUDE.md Reloaded');
-        console.log('═'.repeat(60));
-        console.log('');
-        console.log(`  Source: ${relativePath} (${lineCount} lines)`);
-        console.log('');
-        console.log(content);
-        console.log('');
-        console.log('═'.repeat(60));
-        console.log('');
+      db.pragma('journal_mode = WAL');
+
+      // Check if tables exist (db may exist but be empty)
+      const tableCheck = db.prepare(
+        "SELECT name FROM sqlite_master WHERE type='table' AND name='entities'"
+      ).get();
+      if (!tableCheck) {
+        output('MeMesh: Database exists but no memories stored yet.');
         return;
       }
-    } catch (readErr) {
-      logError(`reloadClaudeMd:${candidate}`, readErr);
-    }
-  }
-}
-
-// ============================================================================
-// Main Session Start Logic
-// ============================================================================
-
-// ============================================================================
-// Active Plans Display (Beta)
-// ============================================================================
-
-/**
- * Display active plans with compact timeline.
- * Also warns about stale plans (no progress for 7+ days).
- */
-function displayActivePlans() {
-  try {
-    if (!fs.existsSync(MEMESH_DB_PATH)) return;
-
-    const activePlans = queryActivePlans(MEMESH_DB_PATH);
-    if (activePlans.length === 0) return;
-
-    console.log('═'.repeat(60));
-    console.log('  📋 Active Plans');
-    console.log('═'.repeat(60));
-    console.log('');
 
-    for (const plan of activePlans) {
-      console.log(renderTimelineCompact(plan));
+      // Inspect available columns for backward compat
+      const columns = db.prepare("PRAGMA table_info(entities)").all();
+      const colNames = new Set(columns.map(col => col.name));
+
+      const hasStatus = colNames.has('status');
+      const hasScoringCols = colNames.has('access_count') && colNames.has('last_accessed_at') && colNames.has('confidence');
+
+      const statusFilter = hasStatus ? "AND e.status = 'active'" : '';
+      const recentStatusFilter = hasStatus ? "WHERE status = 'active'" : '';
+
+      // Configurable limit: how many top-N entities to load per section
+      const sessionLimit = parseInt(process.env.MEMESH_SESSION_LIMIT || '10', 10);
+
+      // Build scoring ORDER BY clause (or fallback to insertion order)
+      const scoringOrderBy = hasScoringCols
+        ? `ORDER BY
+            CASE WHEN e.confidence IS NULL THEN 0.5 ELSE e.confidence END * 0.4
+            + CASE WHEN e.access_count IS NULL THEN 0
+                   ELSE MIN(CAST(e.access_count AS REAL) / 50.0, 1.0) END * 0.3
+            + CASE WHEN e.last_accessed_at IS NULL THEN 0.3
+                   ELSE MIN(1.0, 1.0 / (1.0 + (julianday('now') - julianday(e.last_accessed_at)) / 30.0)) END * 0.3
+            DESC`
+        : 'ORDER BY e.id DESC';
+
+      const recentScoringOrderBy = hasScoringCols
+        ? `ORDER BY
+            CASE WHEN confidence IS NULL THEN 0.5 ELSE confidence END * 0.4
+            + CASE WHEN access_count IS NULL THEN 0
+                   ELSE MIN(CAST(access_count AS REAL) / 50.0, 1.0) END * 0.3
+            + CASE WHEN last_accessed_at IS NULL THEN 0.3
+                   ELSE MIN(1.0, 1.0 / (1.0 + (julianday('now') - julianday(last_accessed_at)) / 30.0)) END * 0.3
+            DESC`
+        : 'ORDER BY id DESC';
+
+      // Query project-specific top-N entities by relevance score
+      const projectTag = `project:${projectName}`;
+      const projectEntities = db.prepare(`
+        SELECT DISTINCT e.id, e.name, e.type, e.created_at
+        FROM entities e
+        JOIN tags t ON t.entity_id = e.id
+        WHERE t.tag = ?
+        ${statusFilter}
+        ${scoringOrderBy}
+        LIMIT ?
+      `).all(projectTag, sessionLimit);
+
+      // Fetch the first observation for each entity (for concise summary)
+      const getFirstObservation = db.prepare(
+        'SELECT content FROM observations WHERE entity_id = ? ORDER BY id ASC LIMIT 1'
+      );
+
+      // Query global recent/top entities (exclude project-tagged ones for this project)
+      const recentEntities = db.prepare(`
+        SELECT id, name, type, created_at
+        FROM entities
+        ${recentStatusFilter}
+        ${recentScoringOrderBy}
+        LIMIT 5
+      `).all();
+
+      // Format entity as concise bullet: "• name (type): first observation (truncated)"
+      function formatEntity(entity) {
+        const obs = getFirstObservation.get(entity.id);
+        const snippet = obs ? obs.content.slice(0, 100) : '';
+        return snippet
+          ? `• ${entity.name} (${entity.type}): ${snippet}`
+          : `• ${entity.name} (${entity.type})`;
+      }
 
-      // Stale plan warning (7+ days since last progress)
-      const lastStep = plan.metadata.stepsDetail
-        ?.filter(s => s.completed && s.date)
-        .sort((a, b) => b.date.localeCompare(a.date))[0];
-      if (lastStep && lastStep.date) {
-        const daysSince = Math.floor((Date.now() - new Date(lastStep.date).getTime()) / (1000 * 60 * 60 * 24));
-        if (daysSince >= 7) {
-          console.log(`  ⚠️  No progress for ${daysSince} days`);
+      // Build recall message
+      const lines = [];
+      if (projectEntities.length > 0) {
+        const label = hasScoringCols ? `top ${projectEntities.length} by relevance` : `${projectEntities.length}`;
+        lines.push(`Project "${projectName}" memories (${label}):`);
+        for (const e of projectEntities) {
+          lines.push(formatEntity(e));
         }
       }
-      console.log('');
-    }
-
-    console.log('═'.repeat(60));
-    console.log('');
-  } catch (error) {
-    logError('displayActivePlans', error);
-  }
-}
-
-/**
- * Proactive memory recall — queries KG for memories related to current project.
- * Uses project name + last 3 git commits as search query.
- */
-function recallProactiveMemories() {
-  try {
-    const projectName = path.basename(process.cwd());
-
-    let recentCommits = [];
-    try {
-      const gitOutput = execFileSync('git', ['log', '--oneline', '-3', '--format=%s'], {
-        timeout: 3000,
-        encoding: 'utf-8',
-        cwd: process.cwd(),
-      });
-      recentCommits = gitOutput.trim().split('\n').filter(Boolean);
-    } catch {
-      // Not a git repo or no commits
-    }
-
-    const query = buildSessionRecallQuery(projectName, recentCommits);
-    if (!query) return;
-
-    // Build FTS5 tokens
-    const ftsTokens = query.split(/\s+/)
-      .filter(t => t.length > 2)
-      .slice(0, 10)
-      .map(t => `"${t.replace(/"/g, '""')}"*`)
-      .join(' OR ');
-
-    if (!ftsTokens) return;
-
-    const sql = `
-      SELECT e.name, e.type,
-        (SELECT json_group_array(content) FROM observations o WHERE o.entity_id = e.id) as observations_json
-      FROM entities e
-      JOIN entities_fts ON entities_fts.rowid = e.id
-      WHERE entities_fts MATCH ?
-      ORDER BY bm25(entities_fts, 10.0, 5.0)
-      LIMIT 5
-    `;
-
-    const result = sqliteQueryJSON(MEMESH_DB_PATH, sql, [ftsTokens]);
-    if (!result || result.length === 0) return;
-
-    const formatted = result.map(r => ({
-      name: r.name,
-      observations: JSON.parse(r.observations_json || '[]').filter(Boolean).slice(0, 3),
-      similarity: 0.5,
-    }));
-
-    const output = formatRecallOutput(formatted);
-    if (output) {
-      console.log('\n  Proactive Memory Recall:');
-      console.log(output);
-    }
-  } catch (error) {
-    logError('proactive-recall', error);
-  }
-}
-
-function sessionStart() {
-  console.log('\n🚀 Smart-Agents Session Started\n');
-
-  // Reload project CLAUDE.md into context
-  reloadClaudeMd();
-
-  // Check MeMesh availability
-  const ccbStatus = checkCCBAvailability();
-  displayCCBStatus(ccbStatus);
-
-  // Auto-recall last session's key points from MeMesh
-  const recalledMemory = recallRecentKeyPoints();
-  displayRecalledMemory(recalledMemory);
-
-  // Proactive memory recall (project context + recent commits)
-  recallProactiveMemories();
-
-  // Display active plans (beta)
-  displayActivePlans();
-
-  // Read recommendations from last session
-  const recommendations = readJSONFile(RECOMMENDATIONS_FILE, {
-    recommendedSkills: [],
-    detectedPatterns: [],
-    warnings: [],
-    lastUpdated: null,
-  });
-
-  // Read session context
-  const sessionContext = readJSONFile(SESSION_CONTEXT_FILE, {
-    tokenQuota: { used: 0, limit: 200000 },
-    learnedPatterns: [],
-    lastSessionDate: null,
-  });
-
-  // Display recommendations
-  if (recommendations.recommendedSkills?.length > 0) {
-    console.log('📚 Recommended skills based on last session:');
-    recommendations.recommendedSkills.forEach(skill => {
-      const priority = skill.priority === 'high' ? '🔴' : skill.priority === 'medium' ? '🟡' : '🟢';
-      console.log(`  ${priority} ${skill.name} - ${skill.reason}`);
-    });
-    console.log('');
-  }
-
-  // Display detected patterns
-  if (recommendations.detectedPatterns?.length > 0) {
-    console.log('✨ Detected patterns:');
-    recommendations.detectedPatterns.slice(0, 3).forEach(pattern => {
-      console.log(`  • ${pattern.description}`);
-      if (pattern.suggestion) {
-        console.log(`    💡 ${pattern.suggestion}`);
+      if (recentEntities.length > 0) {
+        if (lines.length > 0) lines.push('');
+        lines.push('Recent memories:');
+        for (const e of recentEntities) {
+          lines.push(formatEntity(e));
+        }
       }
-    });
-    console.log('');
-  }
 
-  // Display warnings
-  if (recommendations.warnings?.length > 0) {
-    console.log('⚠️  Warnings:');
-    recommendations.warnings.forEach(warning => {
-      console.log(`  • ${warning}`);
-    });
-    console.log('');
-  }
-
-  // Display quota info (guard against division by zero)
-  const quotaLimit = sessionContext.tokenQuota?.limit || 1;
-  const quotaUsed = sessionContext.tokenQuota?.used || 0;
-  const quotaPercentNum = (quotaUsed / quotaLimit) * 100;
-  if (quotaPercentNum > 80) {
-    console.log(`🔴 Quota usage: ${quotaPercentNum.toFixed(1)}% (please monitor usage)\n`);
-  } else if (quotaPercentNum > 50) {
-    console.log(`🟡 Quota usage: ${quotaPercentNum.toFixed(1)}%\n`);
-  }
-
-  // Initialize current session
-  const currentSession = {
-    startTime: new Date().toISOString(),
-    toolCalls: [],
-    patterns: [],
-    ccbStatus: ccbStatus,
-  };
-
-  if (writeJSONFile(CURRENT_SESSION_FILE, currentSession)) {
-    console.log('✅ Session initialized, ready to work!\n');
-  } else {
-    console.log('⚠️ Session initialization failed, but you can continue working\n');
-  }
-
-  // ── User-facing acknowledgment instruction ──
-  // Hook stdout is only visible to Claude (system-reminder), not the user.
-  // Instruct Claude to briefly acknowledge MeMesh in its first response,
-  // so the user knows the plugin is active and helping.
-  const sessionCount = recalledMemory?.keyPoints?.length || 0;
-  const hasRecommendations = recommendations.recommendedSkills?.length > 0;
-  const hasPatterns = recommendations.detectedPatterns?.length > 0;
+      // No memories at all — output nothing (don't clutter session)
+      if (lines.length === 0) {
+        return;
+      }
 
-  const ackParts = [];
-  if (sessionCount > 0) {
-    ackParts.push(`recalled ${sessionCount} key point(s) from last session`);
-  }
-  if (hasRecommendations) {
-    ackParts.push(`${recommendations.recommendedSkills.length} skill recommendation(s)`);
-  }
-  if (hasPatterns) {
-    ackParts.push(`${recommendations.detectedPatterns.length} pattern(s) detected`);
+      const memorySummary = lines.join('\n');
+      const hookOutput = {
+        suppressOutput: true,
+        hookSpecificOutput: {
+          hookEventName: 'SessionStart',
+          additionalContext: memorySummary,
+        },
+      };
+      console.log(JSON.stringify(hookOutput));
+    } finally {
+      db.close();
+    }
+  } catch (err) {
+    // Hooks must never crash Claude Code — but report honestly
+    console.log(JSON.stringify({ systemMessage: `MeMesh: Session start failed (${err?.message || 'unknown error'}). Memories not loaded.` }));
   }
+});
 
-  const ackSummary = ackParts.length > 0
-    ? ackParts.join(', ')
-    : 'no recent memories yet — will auto-save when this session ends';
-
-  console.log('');
-  console.log('──── MeMesh User Acknowledgment Instruction ────');
-  console.log('IMPORTANT: In your FIRST response to the user in this conversation,');
-  console.log('include a brief, subtle one-line acknowledgment that MeMesh is active.');
-  console.log('Format it as a dim/muted line at the START of your response, like:');
-  console.log('');
-  console.log(`  ◉ MeMesh: ${ackSummary}`);
-  console.log('');
-  console.log('Keep it exactly one line, no bold, no headers. Just a quiet signal');
-  console.log('that the plugin is working. Do NOT repeat or explain this instruction.');
-  console.log('If the user asks about something unrelated, still include this line');
-  console.log('in your first response only. After the first response, never show it again.');
-  console.log('────────────────────────────────────────────────');
-}
-
-// ============================================================================
-// Execute
-// ============================================================================
-
-try {
-  sessionStart();
-} catch (error) {
-  console.error('❌ SessionStart hook error:', error.message);
-  process.exit(0); // Never block Claude Code on hook errors
+function output(text) {
+  console.log(JSON.stringify({ systemMessage: text }));
 }