@massu/core 1.10.8 → 1.12.0

package/src/hooks/fix-detector.ts

@@ -1,186 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-// ============================================================
-// PostToolUse Hook: Fix Detector
-// Detects when a bug fix is being applied during a session by
-// analyzing git diffs of edited files. Sets session-level state
-// so the auto-learning pipeline can trigger at session end.
-//
-// Part of the Auto-Learning Pipeline:
-//   [Fix Detected] → Incident Report → Rule → Enforcement
-//
-// Must complete in <1000ms.
-// ============================================================
-
-import { execFileSync } from 'child_process';
-import { existsSync, appendFileSync, mkdirSync, readFileSync } from 'fs';
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { getProjectRoot, getConfig } from '../config.ts';
-
-interface HookInput {
-  session_id: string;
-  tool_name: string;
-  tool_input: { file_path?: string };
-}
-
-interface FixSignal {
-  file: string;
-  signals: string[];
-  timestamp: string;
-}
-
-// Fix detection heuristics — each returns true if the pattern matches
-const FIX_HEURISTICS: Array<{ name: string; test: (diff: string) => boolean }> = [
-  {
-    name: 'removed_broken_code',
-    test: (diff) => /^-.*\b(bug|broken|wrong|incorrect|typo|crash|error|fail|miss|stale)\b/m.test(diff),
-  },
-  {
-    name: 'added_error_handling',
-    test: (diff) => {
-      const added = (diff.match(/^\+.*(try|except|catch|guard|if.*nil|if.*None|validate|assert|raise|throw)/gm) || []).length;
-      return added > 2;
-    },
-  },
-  {
-    name: 'method_name_correction',
-    test: (diff) => {
-      const removed = diff.match(/^-.*\.([a-z_]+)\(/m);
-      const added = diff.match(/^\+.*\.([a-z_]+)\(/m);
-      return !!(removed && added && removed[1] !== added[1]);
-    },
-  },
-  {
-    name: 'auth_fix',
-    test: (diff) => /^\+.*(token|auth|header|X-Service|Bearer|credential)/im.test(diff),
-  },
-  {
-    name: 'nil_handling_fix',
-    test: (diff) => /^\+.*(= nil|= None|\.isNil|is None|!= nil|is not None|guard let|if let|optional)/m.test(diff) && /^-/m.test(diff),
-  },
-  {
-    name: 'concurrency_fix',
-    test: (diff) => /^\+.*(timeout|semaphore|lock|mutex|throttle|rate.limit|max_conn)/im.test(diff),
-  },
-  {
-    name: 'async_pattern_fix',
-    test: (diff) => /^\+.*(@MainActor|async with|asyncio\.timeout|\.await)/.test(diff) && /^-/m.test(diff),
-  },
-  {
-    name: 'added_missing_import',
-    test: (diff) => /^\+.*(import|from.*import|require)/.test(diff) && !/^-.*(import|from.*import|require)/m.test(diff),
-  },
-];
-
-function getSessionFlagPath(sessionId: string): string {
-  const dir = join(tmpdir(), 'massu-auto-learning');
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  return join(dir, `fixes-${sessionId.slice(0, 12)}.jsonl`);
-}
-
-async function main(): Promise<void> {
-  try {
-    const input = await readStdin();
-    const hookInput = JSON.parse(input) as HookInput;
-    const filePath = hookInput.tool_input?.file_path;
-
-    if (!filePath || !existsSync(filePath)) {
-      process.exit(0);
-      return;
-    }
-
-    // Only check code files
-    if (!/\.(py|swift|ts|tsx|js|jsx|rs|go|rb|sh)$/.test(filePath)) {
-      process.exit(0);
-      return;
-    }
-
-    // Skip incident/memory/doc files (those ARE pipeline output)
-    const config = getConfig();
-    const incidentDir = config.autoLearning?.incidentDir ?? 'docs/incidents';
-    const memoryDir = config.autoLearning?.memoryDir ?? 'memory';
-    if (filePath.includes(incidentDir) || filePath.includes(memoryDir) || filePath.includes('MEMORY.md')) {
-      process.exit(0);
-      return;
-    }
-
-    // Check if auto-learning is enabled
-    if (config.autoLearning?.enabled === false || config.autoLearning?.fixDetection?.enabled === false) {
-      process.exit(0);
-      return;
-    }
-
-    // Get git diff for this file
-    const root = getProjectRoot();
-    let diff = '';
-    try {
-      diff = execFileSync('git', ['diff', '--', filePath], { cwd: root, timeout: 3000, encoding: 'utf-8' });
-      if (!diff) {
-        diff = execFileSync('git', ['diff', 'HEAD', '--', filePath], { cwd: root, timeout: 3000, encoding: 'utf-8' });
-      }
-    } catch {
-      process.exit(0);
-      return;
-    }
-
-    if (!diff) {
-      process.exit(0);
-      return;
-    }
-
-    // Run fix detection heuristics
-    const enabledSignals = new Set(config.autoLearning?.fixDetection?.signals ?? FIX_HEURISTICS.map(h => h.name));
-    const detected: string[] = [];
-    for (const heuristic of FIX_HEURISTICS) {
-      if (enabledSignals.has(heuristic.name) && heuristic.test(diff)) {
-        detected.push(heuristic.name);
-      }
-    }
-
-    if (detected.length === 0) {
-      process.exit(0);
-      return;
-    }
-
-    // Record the fix detection
-    const signal: FixSignal = {
-      file: filePath,
-      signals: detected,
-      timestamp: new Date().toISOString(),
-    };
-
-    const flagPath = getSessionFlagPath(hookInput.session_id);
-    appendFileSync(flagPath, JSON.stringify(signal) + '\n');
-
-    // Count total fixes this session
-    const lines = readFileSync(flagPath, 'utf-8').split('\n').filter(Boolean);
-    if (lines.length === 1) {
-      // First fix detected — output advisory
-      console.log(
-        `[Massu Auto-Learning] Bug fix detected in ${filePath} (signals: ${detected.join(', ')}). ` +
-        `The auto-learning pipeline will prompt you at session end to create an incident report, ` +
-        `derive a prevention rule, and add enforcement.`
-      );
-    }
-  } catch {
-    // Best-effort: never block Claude Code
-  }
-  process.exit(0);
-}
-
-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();

package/src/hooks/incident-pipeline.ts

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-// ============================================================
-// PostToolUse Hook: Incident-to-Rule Pipeline
-// When a new incident report is written, automatically triggers
-// the next step: deriving a prevention rule.
-//
-// Part of the Auto-Learning Pipeline:
-//   Fix Detected → [Incident Report] → RULE DERIVATION → Enforcement
-//
-// Triggers on: Write to docs/incidents/*.md (configurable)
-// Must complete in <500ms.
-// ============================================================
-
-import { existsSync, readFileSync, readdirSync } from 'fs';
-import { basename, dirname, resolve } from 'path';
-import { getProjectRoot, getConfig } from '../config.ts';
-import { getMemoryDb, scoreFailureClasses, appendIncidentToFailureClass, addFailureClass } from '../memory-db.ts';
-
-interface HookInput {
-  session_id: string;
-  tool_name: string;
-  tool_input: { file_path?: string; content?: string };
-}
-
-async function main(): Promise<void> {
-  try {
-    const input = await readStdin();
-    const hookInput = JSON.parse(input) as HookInput;
-    const filePath = hookInput.tool_input?.file_path;
-
-    if (!filePath) {
-      process.exit(0);
-      return;
-    }
-
-    const config = getConfig();
-    if (config.autoLearning?.enabled === false) {
-      process.exit(0);
-      return;
-    }
-
-    const root = getProjectRoot();
-    const incidentDir = config.autoLearning?.incidentDir ?? 'docs/incidents';
-    const memoryDir = config.autoLearning?.memoryDir ?? 'memory';
-    // Only trigger on incident report files
-    const relPath = filePath.startsWith(root + '/') ? filePath.slice(root.length + 1) : filePath;
-    if (!relPath.startsWith(incidentDir) || !relPath.endsWith('.md')) {
-      process.exit(0);
-      return;
-    }
-
-    if (!existsSync(filePath)) {
-      process.exit(0);
-      return;
-    }
-
-    // Extract title from the incident report
-    const content = readFileSync(filePath, 'utf-8');
-    const titleMatch = content.match(/^#\s+(.+)/m);
-    const title = titleMatch?.[1] ?? basename(filePath, '.md');
-
-    // Check if a corresponding rule already exists
-    const slug = basename(filePath, '.md')
-      .replace(/^\d{4}-\d{2}-\d{2}-?/, '')
-      .toLowerCase();
-
-    const memoryDirAbs = resolve(root, memoryDir);
-    let hasExistingRule = false;
-    if (existsSync(memoryDirAbs)) {
-      const ruleFiles = readdirSync(memoryDirAbs).filter(f => f.startsWith('feedback_'));
-      for (const ruleFile of ruleFiles) {
-        if (ruleFile.toLowerCase().includes(slug.slice(0, 20))) {
-          hasExistingRule = true;
-          break;
-        }
-      }
-    }
-
-    if (hasExistingRule) {
-      // Rule already exists — no action needed
-      process.exit(0);
-      return;
-    }
-
-    // Check if incident has prevention rules section
-    const hasPrevention = /## Prevention Rules|## Prevention|## Rules/i.test(content);
-
-    if (config.autoLearning?.pipeline?.requirePreventionRule === false) {
-      process.exit(0);
-      return;
-    }
-
-    // Output rule derivation instructions
-    const lines: string[] = [];
-    lines.push('');
-    lines.push('============================================================================');
-    lines.push(' AUTO-LEARNING: Incident Report Created — Rule Derivation Required');
-    lines.push('============================================================================');
-    lines.push('');
-    lines.push(`  Incident: ${title}`);
-    lines.push(`  File: ${filePath}`);
-    lines.push('');
-
-    if (!hasPrevention) {
-      lines.push('  No "## Prevention Rules" section found in the incident report.');
-      lines.push('  Add one first, then proceed with rule derivation.');
-      lines.push('');
-    }
-
-    lines.push('  DERIVE A PREVENTION RULE:');
-    lines.push(`    a) Read the incident root cause and prevention rules`);
-    lines.push(`    b) Create: ${memoryDir}/feedback_<rule_name>.md`);
-    lines.push('       Template:');
-    lines.push('       ---');
-    lines.push('       name: <Rule Name>');
-    lines.push('       description: <one-line description>');
-    lines.push('       type: feedback');
-    lines.push('       ---');
-    lines.push('       <Rule statement>');
-    lines.push('       **Why:** <Root cause from incident>');
-    lines.push('       **How to apply:** <Concrete steps>');
-    lines.push('');
-    lines.push(`    c) Add one-line entry to ${config.autoLearning?.memoryIndexFile ?? 'MEMORY.md'}`);
-    lines.push('');
-    lines.push('  This step is MANDATORY per the auto-learning pipeline.');
-    lines.push('============================================================================');
-    lines.push('');
-
-    console.log(lines.join('\n'));
-
-    // ============================================================
-    // Taxonomy Update: Score incident against failure classes
-    // If KNOWN match → append incident to existing class
-    // If NEW → create stub entry with needs_review=true
-    // ============================================================
-    try {
-      const taxonomyConfig = config.autoLearning?.failureClassification;
-      if (taxonomyConfig?.enabled !== false) {
-        const db = getMemoryDb();
-        try {
-          const thresholds = taxonomyConfig?.thresholds ?? { known: 5, similar: 3 };
-          const scoringWeights = taxonomyConfig?.scoring;
-
-          // Extract incident number from filename (e.g., "incident-042.md" → "42")
-          const incidentNumMatch = basename(filePath, '.md').match(/(\d+)/);
-          const incidentId = incidentNumMatch ? incidentNumMatch[1] : basename(filePath, '.md');
-
-          // Score incident content against taxonomy
-          const bestMatch = scoreFailureClasses(db, content, filePath, title, scoringWeights);
-
-          if (bestMatch && bestMatch.score >= thresholds.similar) {
-            // Known or similar — append incident to existing class
-            appendIncidentToFailureClass(db, bestMatch.name, incidentId);
-          } else {
-            // New pattern — create stub entry for review
-            const stubName = `auto_${slug.replace(/[^a-z0-9_]/g, '_').slice(0, 50)}`;
-            addFailureClass(db, {
-              name: stubName,
-              description: `Auto-created from incident ${incidentId}: ${title.slice(0, 100)}`,
-              incidents: [incidentId],
-              needsReview: true,
-            });
-          }
-        } finally {
-          db.close();
-        }
-      }
-    } catch {
-      // Best-effort: taxonomy update failure must not block the pipeline
-    }
-  } catch {
-    // Best-effort: never block Claude Code
-  }
-  process.exit(0);
-}
-
-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();

package/src/hooks/intent-suggester.ts

@@ -1,131 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-// ============================================================
-// UserPromptSubmit Hook: Intent Suggester
-// Matches prompt keywords to relevant slash commands and
-// surfaces suggestions to the user as a non-blocking hint.
-// ============================================================
-
-// Force module mode for TypeScript (no external deps needed)
-export {};
-
-interface HookInput {
-  session_id: string;
-  transcript_path: string;
-  cwd: string;
-  hook_event_name: string;
-  prompt: string;
-}
-
-interface CommandMapping {
-  keywords: string[];
-  command: string;
-  description: string;
-}
-
-const COMMAND_MAPPINGS: CommandMapping[] = [
-  {
-    keywords: ['test', 'failing'],
-    command: '/massu-test',
-    description: 'Run and analyze tests',
-  },
-  {
-    keywords: ['debug', 'bug'],
-    command: '/massu-debug',
-    description: 'Debug an issue',
-  },
-  {
-    keywords: ['refactor'],
-    command: '/massu-refactor',
-    description: 'Guided refactoring workflow',
-  },
-  {
-    keywords: ['cleanup', 'dead code', 'unused'],
-    command: '/massu-cleanup',
-    description: 'Clean up dead code and unused exports',
-  },
-  {
-    keywords: ['document', 'jsdoc', 'readme'],
-    command: '/massu-doc-gen',
-    description: 'Generate documentation',
-  },
-  {
-    keywords: ['estimate', 'effort', 'how long'],
-    command: '/massu-estimate',
-    description: 'Estimate implementation effort',
-  },
-  {
-    keywords: ['release', 'deploy'],
-    command: '/massu-release',
-    description: 'Prepare a release',
-  },
-  {
-    keywords: ['commit'],
-    command: '/massu-commit',
-    description: 'Pre-commit verification gate',
-  },
-  {
-    keywords: ['push'],
-    command: '/massu-push',
-    description: 'Pre-push full verification gate',
-  },
-  {
-    keywords: ['plan'],
-    command: '/massu-create-plan',
-    description: 'Create an implementation plan',
-  },
-];
-
-function findMatchingCommand(prompt: string): CommandMapping | null {
-  const lowerPrompt = prompt.toLowerCase();
-
-  for (const mapping of COMMAND_MAPPINGS) {
-    for (const keyword of mapping.keywords) {
-      if (lowerPrompt.includes(keyword.toLowerCase())) {
-        return mapping;
-      }
-    }
-  }
-
-  return null;
-}
-
-async function main(): Promise<void> {
-  try {
-    const input = await readStdin();
-    const hookInput = JSON.parse(input) as HookInput;
-    const { prompt } = hookInput;
-
-    if (!prompt || !prompt.trim()) {
-      process.exit(0);
-      return;
-    }
-
-    const match = findMatchingCommand(prompt);
-    if (!match) {
-      process.exit(0);
-      return;
-    }
-
-    process.stdout.write(
-      `Tip: Use ${match.command} to ${match.description}.`
-    );
-  } catch (_e) {
-    // Best-effort: never block Claude Code
-  }
-  process.exit(0);
-}
-
-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();

package/src/hooks/post-edit-context.ts

@@ -1,91 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-// ============================================================
-// PostToolUse Context Hook
-// Surfaces applicable CLAUDE.md rules and warnings when editing
-// src/ files. Uses matchRules() and isInMiddlewareTree() from
-// the codegraph index - no MCP server HTTP call needed.
-// Must complete in <500ms.
-// ============================================================
-
-import Database from 'better-sqlite3';
-import { matchRules } from '../rules.ts';
-import { isInMiddlewareTree } from '../middleware-tree.ts';
-import { getResolvedPaths, getProjectRoot } from '../config.ts';
-
-interface HookInput {
-  session_id: string;
-  tool_name: string;
-  tool_input: { file_path?: string };
-}
-
-async function main(): Promise<void> {
-  try {
-    const input = await readStdin();
-    const hookInput = JSON.parse(input) as HookInput;
-    const filePath = hookInput.tool_input?.file_path;
-
-    if (!filePath) {
-      process.exit(0);
-      return;
-    }
-
-    // Convert absolute path to relative
-    const root = getProjectRoot();
-    const rel = filePath.startsWith(root + '/') ? filePath.slice(root.length + 1) : filePath;
-
-    // Only process src/ files
-    if (!rel.startsWith('src/') && !rel.endsWith('.py')) {
-      process.exit(0);
-      return;
-    }
-
-    const warnings: string[] = [];
-
-    // 1. Check applicable rules (uses rules.ts PATTERN_RULES)
-    const rules = matchRules(rel);
-    for (const rule of rules) {
-      if (rule.severity === 'CRITICAL' || rule.severity === 'HIGH') {
-        for (const r of rule.rules) {
-          warnings.push(`[${rule.severity}] ${r}`);
-        }
-      }
-    }
-
-    // 2. Check middleware tree membership
-    try {
-      const dataDb = new Database(getResolvedPaths().dataDbPath, { readonly: true });
-      try {
-        if (isInMiddlewareTree(dataDb, rel)) {
-          warnings.push('[CRITICAL] This file is in the middleware import tree. No Node.js deps allowed.');
-        }
-      } finally {
-        dataDb.close();
-      }
-    } catch (_e) {
-      // DB may not exist yet - skip middleware check
-    }
-
-    // 3. Output warnings if any
-    if (warnings.length > 0) {
-      console.log(`[Massu] ${warnings.join(' | ')}`);
-    }
-  } catch (_e) {
-    // Best-effort: never block Claude Code
-  }
-  process.exit(0);
-}
-
-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();