@massu/core 1.10.8 → 1.12.0

package/src/hooks/session-start.ts

@@ -1,436 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-// ============================================================
-// P3-001: Enhanced SessionStart Hook
-// Injects context from previous sessions into new sessions.
-// Output: plain text to stdout (auto-injected by Claude Code)
-// ============================================================
-
-import { getMemoryDb, getSessionSummaries, getRecentObservations, getFailedAttempts, getCrossTaskProgress, autoDetectTaskId, linkSessionToTask, createSession } from '../memory-db.ts';
-import { getConfig, getResolvedPaths } from '../config.ts';
-import { readFileSync, existsSync } from 'fs';
-import { join, resolve } from 'path';
-import { parse as parseYaml } from 'yaml';
-import type Database from 'better-sqlite3';
-import { runDetection } from '../detect/index.ts';
-import { computeFingerprint } from '../detect/drift.ts';
-import { isPidAlive } from '../lib/pidLiveness.ts';
-
-interface HookInput {
-  session_id: string;
-  transcript_path: string;
-  cwd: string;
-  hook_event_name: string;
-  source?: 'startup' | 'resume' | 'clear' | 'compact';
-}
-
-async function main(): Promise<void> {
-  try {
-    // Read stdin
-    const input = await readStdin();
-    const hookInput = JSON.parse(input) as HookInput;
-    const { session_id, source } = hookInput;
-
-    const db = getMemoryDb();
-
-    try {
-      // Create session if not exists
-      const gitBranch = await getGitBranch();
-      createSession(db, session_id, { branch: gitBranch });
-
-      // Check if session has a plan_file and link task
-      const session = db.prepare('SELECT plan_file, task_id FROM sessions WHERE session_id = ?').get(session_id) as { plan_file: string | null; task_id: string | null } | undefined;
-      if (session?.plan_file && !session.task_id) {
-        const taskId = autoDetectTaskId(session.plan_file);
-        if (taskId) linkSessionToTask(db, session_id, taskId);
-      }
-
-      // Token budget based on source
-      const tokenBudget = getTokenBudget(source ?? 'startup');
-
-      // Check if this is the very first session (no prior sessions)
-      const sessionCount = db.prepare('SELECT COUNT(*) as count FROM sessions').get() as { count: number };
-      if (sessionCount.count <= 1 && (source === 'startup' || !source)) {
-        process.stdout.write(
-          '=== MASSU AI: Active ===\n' +
-          'Session memory, code intelligence, and governance are now active.\n' +
-          `11 hooks monitoring this session. Type "${getConfig().toolPrefix ?? 'massu'}_sync" to index your codebase.\n` +
-          '=== END MASSU ===\n\n'
-        );
-      }
-
-      // Build context
-      const context = await buildContext(db, session_id, source ?? 'startup', tokenBudget, session?.task_id ?? null);
-
-      if (context.trim()) {
-        process.stdout.write(context);
-      }
-
-      // P5-001: drift banner (runs after memory context, independent of it).
-      // Plan 3a Phase 6: when a live watcher daemon exists, the drift banner
-      // is suppressed in favor of a compact watcher banner.
-      const driftBanner = await buildDriftBanner();
-      if (driftBanner) {
-        process.stdout.write(driftBanner);
-      } else {
-        const watcherBanner = buildWatcherBanner();
-        if (watcherBanner) process.stdout.write(watcherBanner);
-      }
-    } finally {
-      db.close();
-    }
-  } catch (_e) {
-    // Best-effort: never block Claude Code
-    process.exit(0);
-  }
-}
-
-function getTokenBudget(source: string): number {
-  switch (source) {
-    case 'compact': return 4000;
-    case 'startup': return 2000;
-    case 'resume': return 1000;
-    case 'clear': return 2000;
-    default: return 2000;
-  }
-}
-
-async function buildContext(db: Database.Database, sessionId: string, source: string, tokenBudget: number, taskId: string | null): Promise<string> {
-  const sections: Array<{ text: string; importance: number }> = [];
-
-  // 1. Failed attempts (highest priority - DON'T RETRY warnings)
-  const failures = getFailedAttempts(db, undefined, 10);
-  if (failures.length > 0) {
-    let failText = '### Failed Attempts (DO NOT RETRY)\n';
-    for (const f of failures) {
-      const recurrence = f.recurrence_count > 1 ? ` (${f.recurrence_count}x)` : '';
-      failText += `- ${f.title}${recurrence}\n`;
-    }
-    sections.push({ text: failText, importance: 10 });
-  }
-
-  // 2. For compact: include current session's own observations
-  if (source === 'compact') {
-    const currentObs = getRecentObservations(db, 30, sessionId);
-    if (currentObs.length > 0) {
-      let currentText = '### Current Session Observations (restored after compaction)\n';
-      for (const obs of currentObs) {
-        currentText += `- [${obs.type}] ${obs.title}\n`;
-      }
-      sections.push({ text: currentText, importance: 9 });
-    }
-  }
-
-  // 3. Recent session summaries
-  const summaryCount = source === 'compact' ? 5 : 3;
-  const summaries = getSessionSummaries(db, summaryCount);
-  if (summaries.length > 0) {
-    for (const s of summaries) {
-      let sumText = `### Session (${s.created_at.split('T')[0]})\n`;
-      if (s.request) sumText += `**Task**: ${s.request.slice(0, 200)}\n`;
-      if (s.completed) sumText += `**Completed**: ${s.completed.slice(0, 300)}\n`;
-      if (s.failed_attempts) sumText += `**Failed**: ${s.failed_attempts.slice(0, 200)}\n`;
-
-      const progress = safeParseJson(s.plan_progress);
-      if (progress && Object.keys(progress).length > 0) {
-        const total = Object.keys(progress).length;
-        const complete = Object.values(progress).filter(v => v === 'complete').length;
-        sumText += `**Plan**: ${complete}/${total} complete\n`;
-      }
-      sections.push({ text: sumText, importance: 7 });
-    }
-  }
-
-  // 4. Cross-task progress if task_id exists
-  if (taskId) {
-    const progress = getCrossTaskProgress(db, taskId);
-    if (Object.keys(progress).length > 0) {
-      const total = Object.keys(progress).length;
-      const complete = Object.values(progress).filter(v => v === 'complete').length;
-      let progressText = `### Cross-Session Task Progress (${taskId})\n`;
-      progressText += `${complete}/${total} items complete\n`;
-      sections.push({ text: progressText, importance: 8 });
-    }
-  }
-
-  // 5. Prevention rules from corrections.md
-  const preventionRules = loadCorrectionsPreventionRules();
-  if (preventionRules.length > 0) {
-    let rulesText = '### Active Prevention Rules (from corrections.md)\n';
-    for (const rule of preventionRules) {
-      rulesText += `- ${rule}\n`;
-    }
-    sections.push({ text: rulesText, importance: 9 });
-  }
-
-  // 6. Knowledge index status (warm-up check)
-  try {
-    const knowledgeDbPath = getResolvedPaths().knowledgeDbPath;
-    if (existsSync(knowledgeDbPath)) {
-      const Database = (await import('better-sqlite3')).default;
-      const kdb = new Database(knowledgeDbPath, { readonly: true });
-      try {
-        const stats = kdb.prepare(
-          'SELECT COUNT(*) as doc_count, MAX(indexed_at) as last_indexed FROM knowledge_documents'
-        ).get() as { doc_count: number; last_indexed: string | null };
-        if (stats.doc_count > 0 && stats.last_indexed) {
-          const ageMs = Date.now() - new Date(stats.last_indexed).getTime();
-          const ageHours = Math.round(ageMs / 3600000);
-          if (ageHours > 24) {
-            sections.push({
-              text: `### Knowledge Index Status\nIndex has ${stats.doc_count} documents, last indexed ${ageHours}h ago. Consider re-indexing.\n`,
-              importance: 3,
-            });
-          }
-        } else if (stats.doc_count === 0) {
-          sections.push({
-            text: '### Knowledge Index Status\nKnowledge index is empty. Run knowledge indexing to populate it.\n',
-            importance: 2,
-          });
-        }
-      } finally {
-        kdb.close();
-      }
-    }
-  } catch (_knowledgeErr) {
-    // Best-effort: never block session start
-  }
-
-  // 7. Recent observations sorted by importance
-  const recentObs = getRecentObservations(db, 20);
-  if (recentObs.length > 0) {
-    let obsText = '### Recent Observations\n';
-    const sorted = [...recentObs].sort((a, b) => b.importance - a.importance);
-    for (const obs of sorted) {
-      obsText += `- [${obs.type}|imp:${obs.importance}] ${obs.title} (${obs.created_at.split('T')[0]})\n`;
-    }
-    sections.push({ text: obsText, importance: 5 });
-  }
-
-  // Fill token budget from high-importance to low-importance
-  sections.sort((a, b) => b.importance - a.importance);
-
-  let usedTokens = 0;
-  const headerTokens = estimateTokens('=== Massu Memory: Previous Session Context ===\n\n=== END Massu Memory ===\n');
-  usedTokens += headerTokens;
-
-  const includedSections: string[] = [];
-  for (const section of sections) {
-    const sectionTokens = estimateTokens(section.text);
-    if (usedTokens + sectionTokens <= tokenBudget) {
-      includedSections.push(section.text);
-      usedTokens += sectionTokens;
-    }
-  }
-
-  if (includedSections.length === 0) return '';
-
-  return `=== Massu Memory: Previous Session Context ===\n\n${includedSections.join('\n')}\n=== END Massu Memory ===\n`;
-}
-
-function estimateTokens(text: string): number {
-  return Math.ceil(text.length / 4);
-}
-
-async function getGitBranch(): Promise<string | undefined> {
-  try {
-    const { spawnSync } = await import('child_process');
-    const result = spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
-      encoding: 'utf-8',
-      timeout: 5000,
-    });
-    if (result.status !== 0 || result.error) return undefined;
-    return result.stdout.trim();
-  } catch (_e) {
-    return undefined;
-  }
-}
-
-function readStdin(): Promise<string> {
-  return new Promise((resolve) => {
-    let data = '';
-    process.stdin.setEncoding('utf-8');
-    process.stdin.on('data', (chunk: string) => { data += chunk; });
-    process.stdin.on('end', () => resolve(data));
-    // Timeout after 3s
-    setTimeout(() => resolve(data), 3000);
-  });
-}
-
-/**
- * P5-001: compare the fingerprint stored in massu.config.yaml (detection.fingerprint,
- * stamped by init/refresh/upgrade) against a freshly-computed fingerprint. If they
- * disagree, return a plain-text banner. Returns '' on any error or when the
- * config has no fingerprint (back-compat with v1 configs).
- */
-async function buildDriftBanner(): Promise<string> {
-  try {
-    // Plan #2 P4-004: explicit opt-out for users in deliberate mid-migration windows.
-    // Stays at the top so MASSU_DRIFT_QUIET=1 remains the strongest signal
-    // (iter-1 G8: env-var override beats watcher-state suppression).
-    if (process.env.MASSU_DRIFT_QUIET === '1') return '';
-
-    // Plan 3a Phase 6: if a live watcher daemon refreshed within the last 24h,
-    // suppress this banner — the watcher already keeps the config current.
-    if (watcherIsLiveAndFresh()) return '';
-
-    const configPath = resolve(process.cwd(), 'massu.config.yaml');
-    if (!existsSync(configPath)) return '';
-    const content = readFileSync(configPath, 'utf-8');
-    // pattern-scanner-allow: yaml-parse — reason: compiled standalone hook (esbuild bundle). Per P2-023a, hooks cannot import getConfig() — they run in the Claude Code subprocess context with no module resolution path back to packages/core. Direct YAML parse is the only available access pattern.
-    const parsed = parseYaml(content) as Record<string, unknown> | null;
-    if (!parsed || typeof parsed !== 'object') return '';
-    const det = parsed.detection as Record<string, unknown> | undefined;
-    const storedFp = typeof det?.fingerprint === 'string' ? (det.fingerprint as string) : null;
-    if (!storedFp) return '';
-    // Plan #2 P4-006: skip the codebase introspector pass — the drift banner
-    // only needs the fingerprint, not the introspected detail. Saves up to 2s
-    // wall-clock from the hook's 5-second budget.
-    const detection = await runDetection(process.cwd(), undefined, { skipIntrospect: true });
-    const currentFp = computeFingerprint(detection);
-    if (currentFp === storedFp) return '';
-    return (
-      '=== Massu Config Drift ===\n' +
-      'Detected stack has changed since last config refresh.\n' +
-      `Fingerprint:  ${storedFp.slice(0, 16)}  ->  ${currentFp.slice(0, 16)}\n` +
-      'Run: npx massu config refresh\n' +
-      '(this will update massu.config.yaml AND any commands that need\n' +
-      ' re-templating for your new stack)\n' +
-      'Tip: set MASSU_DRIFT_QUIET=1 to suppress this banner during mid-migration.\n' +
-      '=== END ===\n'
-    );
-  } catch (_e) {
-    // Never block session start on drift-check failure.
-    return '';
-  }
-}
-
-function safeParseJson(json: string): Record<string, string> | null {
-  try {
-    return JSON.parse(json);
-  } catch (_e) {
-    return null;
-  }
-}
-
-/**
- * Load prevention rules from corrections.md in the memory directory.
- * Parses the markdown table format: | Date | Wrong Behavior | Correction | Prevention Rule |
- * Returns only the prevention rule column values.
- * Graceful degradation: returns empty array if file doesn't exist or can't be parsed.
- */
-function loadCorrectionsPreventionRules(): string[] {
-  try {
-    // Memory path follows Claude's project directory convention
-    const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? '';
-    const cwd = process.cwd();
-    const config = getConfig();
-    const claudeDirName = config.conventions?.claudeDirName ?? '.claude';
-    // Convert cwd to Claude's directory format: /Users/x/project -> -Users-x-project.
-    // Match both forward slashes (POSIX) and backslashes (Windows) so the lookup
-    // works cross-platform — without this, Windows users silently miss prevention
-    // rules because their projectDirName never resolves.
-    const projectDirName = cwd.replace(/[/\\]/g, '-').replace(/^-/, '');
-    const correctionsPath = join(homeDir, claudeDirName, 'projects', projectDirName, 'memory', 'corrections.md');
-
-    if (!existsSync(correctionsPath)) return [];
-
-    const content = readFileSync(correctionsPath, 'utf-8');
-    const lines = content.split('\n');
-    const rules: string[] = [];
-
-    for (const line of lines) {
-      // Match table rows: | date | wrong | correction | prevention |
-      // Skip header row and separator row
-      const trimmed = line.trim();
-      if (!trimmed.startsWith('|') || !trimmed.endsWith('|')) continue;
-
-      const cells = trimmed.split('|').map(c => c.trim()).filter(c => c.length > 0);
-      if (cells.length < 4) continue;
-
-      // Skip header and separator rows
-      if (cells[0] === 'Date' || cells[0].startsWith('-')) continue;
-
-      const preventionRule = cells[3];
-      if (preventionRule && !preventionRule.startsWith('-') && !preventionRule.startsWith('<!--')) {
-        rules.push(preventionRule);
-      }
-    }
-
-    return rules;
-  } catch (_e) {
-    // Graceful degradation: never block session start
-    return [];
-  }
-}
-
-// ============================================================
-// Plan 3a Phase 6: watcher-aware banner support
-// ============================================================
-
-interface WatchStateShape {
-  schema_version?: number;
-  daemonPid?: number | null;
-  lastRefreshAt?: string | null;
-  startedAt?: string | null;
-}
-
-function readWatchStateRaw(cwd: string): WatchStateShape | null {
-  try {
-    const path = resolve(cwd, '.massu', 'watch-state.json');
-    if (!existsSync(path)) return null;
-    const obj = JSON.parse(readFileSync(path, 'utf-8'));
-    if (!obj || typeof obj !== 'object') return null;
-    return obj as WatchStateShape;
-  } catch {
-    return null;
-  }
-}
-
-function watcherIsLiveAndFresh(): boolean {
-  // MASSU_DRIFT_QUIET takes precedence (caller already short-circuited).
-  // Fresh = last refresh within 24h AND daemonPid is alive.
-  const state = readWatchStateRaw(process.cwd());
-  if (!state) return false;
-  if (typeof state.daemonPid !== 'number' || state.daemonPid <= 0) return false;
-  if (!isPidAlive(state.daemonPid)) return false;
-  if (typeof state.lastRefreshAt !== 'string') return false;
-  const last = Date.parse(state.lastRefreshAt);
-  if (!Number.isFinite(last)) return false;
-  const ageMs = Date.now() - last;
-  return ageMs >= 0 && ageMs < 24 * 60 * 60 * 1000;
-}
-
-function buildWatcherBanner(): string {
-  // P4-004 ordering: MASSU_DRIFT_QUIET wins everywhere.
-  if (process.env.MASSU_DRIFT_QUIET === '1') return '';
-  const state = readWatchStateRaw(process.cwd());
-  if (!state) return '';
-  if (typeof state.daemonPid !== 'number' || state.daemonPid <= 0) return '';
-  if (!isPidAlive(state.daemonPid)) return '';
-  if (typeof state.lastRefreshAt !== 'string') return '';
-  const last = Date.parse(state.lastRefreshAt);
-  if (!Number.isFinite(last)) return '';
-  const ageMs = Date.now() - last;
-  if (ageMs < 0 || ageMs >= 24 * 60 * 60 * 1000) return '';
-
-  const ageStr = formatAge(ageMs);
-  return (
-    '=== Massu Watcher ===\n' +
-    `[massu] watcher running, last refresh: ${ageStr} ago (pid ${state.daemonPid})\n` +
-    '=== END ===\n'
-  );
-}
-
-function formatAge(ms: number): string {
-  const sec = Math.round(ms / 1000);
-  if (sec < 60) return `${sec}s`;
-  const min = Math.round(sec / 60);
-  if (min < 60) return `${min}m`;
-  const hr = Math.round(min / 60);
-  return `${hr}h`;
-}
-
-main();

package/src/hooks/user-prompt.ts

@@ -1,157 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-// ============================================================
-// P3-004: UserPromptSubmit Hook
-// Captures user prompts for search and context.
-// ============================================================
-
-import { getMemoryDb, createSession, addUserPrompt, linkSessionToTask, autoDetectTaskId, addObservation } from '../memory-db.ts';
-import { existsSync } from 'fs';
-import { getResolvedPaths } from '../config.ts';
-
-interface HookInput {
-  session_id: string;
-  transcript_path: string;
-  cwd: string;
-  hook_event_name: string;
-  prompt: string;
-}
-
-async function main(): Promise<void> {
-  try {
-    const input = await readStdin();
-    const hookInput = JSON.parse(input) as HookInput;
-    const { session_id, prompt } = hookInput;
-
-    if (!prompt || !prompt.trim()) {
-      process.exit(0);
-      return;
-    }
-
-    const db = getMemoryDb();
-    try {
-      // 1. Create session if not exists
-      const gitBranch = await getGitBranch();
-      createSession(db, session_id, { branch: gitBranch });
-
-      // 2. Scan prompt for plan file references
-      const planFileMatch = prompt.match(/([^\s]+docs\/plans\/[^\s]+\.md)/);
-      if (planFileMatch) {
-        const planFile = planFileMatch[1];
-        db.prepare('UPDATE sessions SET plan_file = ? WHERE session_id = ?').run(planFile, session_id);
-
-        // Auto-detect and link task_id
-        const taskId = autoDetectTaskId(planFile);
-        if (taskId) {
-          linkSessionToTask(db, session_id, taskId);
-        }
-      }
-
-      // 3. Get current prompt count for this session
-      const countResult = db.prepare(
-        'SELECT COUNT(*) as count FROM user_prompts WHERE session_id = ?'
-      ).get(session_id) as { count: number };
-      const promptNumber = countResult.count + 1;
-
-      // 4. Insert prompt
-      addUserPrompt(db, session_id, prompt.trim(), promptNumber);
-
-      // 5. Knowledge-aware prompt enrichment: detect file references and check knowledge index
-      try {
-        const fileRefs = extractFileReferences(prompt);
-        if (fileRefs.length > 0) {
-          const knowledgeDbPath = getResolvedPaths().knowledgeDbPath;
-          if (knowledgeDbPath && existsSync(knowledgeDbPath)) {
-            const Database = (await import('better-sqlite3')).default;
-            const kdb = new Database(knowledgeDbPath, { readonly: true });
-            try {
-              const placeholders = fileRefs.map(() => '?').join(',');
-              const matches = kdb.prepare(
-                `SELECT DISTINCT file_path FROM knowledge_documents WHERE file_path IN (${placeholders})`
-              ).all(...fileRefs) as Array<{ file_path: string }>;
-              if (matches.length > 0) {
-                addObservation(db, session_id, 'discovery',
-                  `Knowledge entries exist for referenced files`,
-                  `Files with knowledge context: ${matches.map(m => m.file_path).join(', ')}`,
-                  { importance: 2 }
-                );
-              }
-            } finally {
-              kdb.close();
-            }
-          }
-        }
-      } catch (_knowledgeErr) {
-        // Best-effort: never block prompt capture
-      }
-      // 6. Memory enforcement: nag when significant work detected but no memory ingestion
-      try {
-        const significantSignals = ['fix', 'implement', 'migrate', 'refactor', 'debug', 'decision', 'chose', 'architecture', 'redesign', 'rewrite'];
-        const promptLower = prompt.toLowerCase();
-        const signalCount = significantSignals.filter(s => promptLower.includes(s)).length;
-
-        if (signalCount >= 2) {
-          const memoryFileCount = db.prepare(
-            "SELECT COUNT(*) as count FROM observations WHERE session_id = ? AND title LIKE '[memory-file] %'"
-          ).get(session_id) as { count: number };
-
-          if (memoryFileCount.count === 0) {
-            process.stderr.write(
-              '\n[MEMORY REMINDER] Significant work detected but no memory files have been written.\n' +
-              'Consider saving learnings to memory/*.md files for future sessions.\n\n'
-            );
-          }
-        }
-      } catch (_memoryNagErr) {
-        // Best-effort: never block prompt capture
-      }
-    } finally {
-      db.close();
-    }
-  } catch (_e) {
-    // Best-effort: never block Claude Code
-  }
-  process.exit(0);
-}
-
-/**
- * Extract file path references from user prompt text.
- * Matches patterns like src/foo/bar.ts, packages/core/src/x.ts, etc.
- */
-function extractFileReferences(prompt: string): string[] {
-  const filePattern = /(?:^|\s)((?:src|packages|lib)\/[\w./-]+\.(?:ts|tsx|js|jsx|md))/g;
-  const matches: string[] = [];
-  let match: RegExpExecArray | null;
-  while ((match = filePattern.exec(prompt)) !== null) {
-    matches.push(match[1]);
-  }
-  return [...new Set(matches)];
-}
-
-async function getGitBranch(): Promise<string | undefined> {
-  try {
-    const { spawnSync } = await import('child_process');
-    const result = spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
-      encoding: 'utf-8',
-      timeout: 5000,
-    });
-    if (result.status !== 0 || result.error) return undefined;
-    return result.stdout.trim();
-  } catch (_e) {
-    return undefined;
-  }
-}
-
-function readStdin(): Promise<string> {
-  return new Promise((resolve) => {
-    let data = '';
-    process.stdin.setEncoding('utf-8');
-    process.stdin.on('data', (chunk: string) => { data += chunk; });
-    process.stdin.on('end', () => resolve(data));
-    setTimeout(() => resolve(data), 3000);
-  });
-}
-
-main();