@massu/core 1.10.8 → 1.12.1

package/src/regression-detector.ts

@@ -1,319 +0,0 @@
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-import type Database from 'better-sqlite3';
-import type { ToolDefinition, ToolResult } from './tools.ts';
-import { getConfig } from './config.ts';
-
-// ============================================================
-// Regression Detection
-// ============================================================
-
-/** Prefix a base tool name with the configured tool prefix. */
-function p(baseName: string): string {
-  return `${getConfig().toolPrefix}_${baseName}`;
-}
-
-/** Default health thresholds. Configurable via regression.health_thresholds */
-const DEFAULT_HEALTH_THRESHOLDS = {
-  healthy: 80,
-  warning: 50,
-};
-
-/**
- * Get health thresholds from config or defaults.
- */
-function getHealthThresholds(): { healthy: number; warning: number } {
-  const configured = getConfig().regression?.health_thresholds;
-  return {
-    healthy: configured?.healthy ?? DEFAULT_HEALTH_THRESHOLDS.healthy,
-    warning: configured?.warning ?? DEFAULT_HEALTH_THRESHOLDS.warning,
-  };
-}
-
-/**
- * Calculate feature health score based on modification/test gaps.
- * 0 = critical, 100 = healthy.
- */
-export function calculateHealthScore(
-  testsPassing: number,
-  testsFailing: number,
-  modificationsSinceTest: number,
-  lastTested: string | null,
-  lastModified: string | null
-): number {
-  let score = 100;
-
-  // Test failures
-  if (testsFailing > 0) {
-    score -= Math.min(40, testsFailing * 10);
-  }
-
-  // Modifications since last test
-  if (modificationsSinceTest > 0) {
-    score -= Math.min(30, modificationsSinceTest * 5);
-  }
-
-  // Time gap between modification and test
-  if (lastModified && lastTested) {
-    const modDate = new Date(lastModified).getTime();
-    const testDate = new Date(lastTested).getTime();
-    if (modDate > testDate) {
-      const daysSinceTest = (modDate - testDate) / (1000 * 60 * 60 * 24);
-      score -= Math.min(20, Math.floor(daysSinceTest * 2));
-    }
-  } else if (lastModified && !lastTested) {
-    // Modified but never tested
-    score -= 30;
-  }
-
-  return Math.max(0, score);
-}
-
-/**
- * Update feature health when a file is modified.
- */
-export function trackModification(
-  db: Database.Database,
-  featureKey: string
-): void {
-  const existing = db.prepare(
-    'SELECT * FROM feature_health WHERE feature_key = ?'
-  ).get(featureKey) as Record<string, unknown> | undefined;
-
-  if (existing) {
-    db.prepare(`
-      UPDATE feature_health
-      SET last_modified = datetime('now'),
-          modifications_since_test = modifications_since_test + 1,
-          health_score = ?
-      WHERE feature_key = ?
-    `).run(
-      calculateHealthScore(
-        (existing.tests_passing as number) ?? 0,
-        (existing.tests_failing as number) ?? 0,
-        ((existing.modifications_since_test as number) ?? 0) + 1,
-        existing.last_tested as string | null,
-        new Date().toISOString()
-      ),
-      featureKey
-    );
-  } else {
-    db.prepare(`
-      INSERT INTO feature_health
-      (feature_key, last_modified, modifications_since_test, health_score, tests_passing, tests_failing)
-      VALUES (?, datetime('now'), 1, 70, 0, 0)
-    `).run(featureKey);
-  }
-}
-
-/**
- * Record test results for a feature.
- */
-export function recordTestResult(
-  db: Database.Database,
-  featureKey: string,
-  passing: number,
-  failing: number
-): void {
-  const existing = db.prepare(
-    'SELECT * FROM feature_health WHERE feature_key = ?'
-  ).get(featureKey) as Record<string, unknown> | undefined;
-
-  const healthScore = calculateHealthScore(passing, failing, 0, new Date().toISOString(), existing?.last_modified as string | null);
-
-  db.prepare(`
-    INSERT INTO feature_health
-    (feature_key, last_tested, test_coverage_pct, health_score, tests_passing, tests_failing, modifications_since_test)
-    VALUES (?, datetime('now'), ?, ?, ?, ?, 0)
-    ON CONFLICT(feature_key) DO UPDATE SET
-      last_tested = datetime('now'),
-      health_score = ?,
-      tests_passing = ?,
-      tests_failing = ?,
-      modifications_since_test = 0
-  `).run(
-    featureKey, passing > 0 ? (passing / (passing + failing)) * 100 : 0,
-    healthScore, passing, failing,
-    healthScore, passing, failing
-  );
-}
-
-/**
- * Build alerts for unhealthy features.
- */
-function buildAlerts(feature: Record<string, unknown>): string[] {
-  const alerts: string[] = [];
-
-  if ((feature.tests_failing as number) > 0) {
-    alerts.push(`${feature.tests_failing} tests failing`);
-  }
-  if ((feature.modifications_since_test as number) > 3) {
-    alerts.push(`${feature.modifications_since_test} modifications since last test`);
-  }
-  if (!feature.last_tested && feature.last_modified) {
-    alerts.push('Never tested');
-  }
-
-  return alerts;
-}
-
-// ============================================================
-// MCP Tool Definitions & Handlers
-// ============================================================
-
-export function getRegressionToolDefinitions(): ToolDefinition[] {
-  return [
-    {
-      name: p('feature_health'),
-      description: 'Feature health dashboard. Shows health scores, modification/test gaps, and alerts for registered features.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          unhealthy_only: { type: 'boolean', description: 'Show only features with health below warning threshold (default: false)' },
-        },
-        required: [],
-      },
-    },
-    {
-      name: p('regression_risk'),
-      description: 'Check if recent changes risk regression. Shows affected features, test coverage status, and risk assessment.',
-      inputSchema: {
-        type: 'object',
-        properties: {},
-        required: [],
-      },
-    },
-  ];
-}
-
-const REGRESSION_BASE_NAMES = new Set(['feature_health', 'regression_risk']);
-
-export function isRegressionTool(name: string): boolean {
-  const pfx = getConfig().toolPrefix + '_';
-  const baseName = name.startsWith(pfx) ? name.slice(pfx.length) : name;
-  return REGRESSION_BASE_NAMES.has(baseName);
-}
-
-export function handleRegressionToolCall(
-  name: string,
-  args: Record<string, unknown>,
-  memoryDb: Database.Database
-): ToolResult {
-  try {
-    const pfx = getConfig().toolPrefix + '_';
-    const baseName = name.startsWith(pfx) ? name.slice(pfx.length) : name;
-
-    switch (baseName) {
-      case 'feature_health':
-        return handleFeatureHealth(args, memoryDb);
-      case 'regression_risk':
-        return handleRegressionCheck(args, memoryDb);
-      default:
-        return text(`Unknown regression tool: ${name}`);
-    }
-  } catch (error) {
-    return text(`Error in ${name}: ${error instanceof Error ? error.message : String(error)}\n\nUsage: ${p('feature_health')} { unhealthy_only: true }, ${p('regression_risk')} {}`);
-  }
-}
-
-function handleFeatureHealth(args: Record<string, unknown>, db: Database.Database): ToolResult {
-  const unhealthyOnly = args.unhealthy_only as boolean | undefined;
-  const thresholds = getHealthThresholds();
-
-  let sql = 'SELECT * FROM feature_health';
-  const params: (string | number)[] = [];
-
-  if (unhealthyOnly) {
-    sql += ' WHERE health_score < ?';
-    params.push(thresholds.healthy);
-  }
-
-  sql += ' ORDER BY health_score ASC';
-
-  const features = db.prepare(sql).all(...params) as Array<Record<string, unknown>>;
-
-  if (features.length === 0) {
-    const filterMsg = unhealthyOnly
-      ? `No unhealthy features found (threshold: ${thresholds.healthy}). All tracked features are currently healthy. Use ${p('feature_health')} {} without filters to see all features.`
-      : `No feature health data available yet. Feature health is tracked automatically when files in registered features are modified and tested. Try: ${p('regression_risk')} {} to check for untested modifications.`;
-    return text(filterMsg);
-  }
-
-  const lines = [
-    `## Feature Health Dashboard`,
-    `Features tracked: ${features.length}`,
-    '',
-    '| Feature | Health | Tests P/F | Mods Since Test | Alerts |',
-    '|---------|--------|-----------|-----------------|--------|',
-  ];
-
-  for (const f of features) {
-    const alerts = buildAlerts(f);
-    const healthScore = f.health_score as number;
-    const healthIndicator = healthScore >= thresholds.healthy ? 'OK'
-      : healthScore >= thresholds.warning ? 'WARN'
-      : 'CRIT';
-
-    lines.push(
-      `| ${f.feature_key} | ${healthScore} [${healthIndicator}] | ${f.tests_passing ?? 0}/${f.tests_failing ?? 0} | ${f.modifications_since_test ?? 0} | ${alerts.join('; ') || '-'} |`
-    );
-  }
-
-  return text(lines.join('\n'));
-}
-
-function handleRegressionCheck(_args: Record<string, unknown>, db: Database.Database): ToolResult {
-  const thresholds = getHealthThresholds();
-
-  const recentlyModified = db.prepare(`
-    SELECT feature_key, health_score, modifications_since_test, tests_failing, last_modified, last_tested
-    FROM feature_health
-    WHERE modifications_since_test > 0
-    ORDER BY modifications_since_test DESC
-  `).all() as Array<Record<string, unknown>>;
-
-  if (recentlyModified.length === 0) {
-    return text(`No features have been modified since their last test run. Low regression risk. Use ${p('feature_health')} {} to see the full feature health dashboard.`);
-  }
-
-  const highRisk = recentlyModified.filter(f => (f.health_score as number) < thresholds.warning);
-  const mediumRisk = recentlyModified.filter(f => (f.health_score as number) >= thresholds.warning && (f.health_score as number) < thresholds.healthy);
-  const lowRisk = recentlyModified.filter(f => (f.health_score as number) >= thresholds.healthy);
-
-  const lines = [
-    `## Regression Risk Assessment`,
-    `Features with untested modifications: ${recentlyModified.length}`,
-    `High risk: ${highRisk.length} | Medium: ${mediumRisk.length} | Low: ${lowRisk.length}`,
-    '',
-  ];
-
-  if (highRisk.length > 0) {
-    lines.push('### HIGH RISK (test immediately)');
-    for (const f of highRisk) {
-      lines.push(`- **${f.feature_key}** (health: ${f.health_score}, ${f.modifications_since_test} untested modifications)`);
-    }
-    lines.push('');
-  }
-
-  if (mediumRisk.length > 0) {
-    lines.push('### Medium Risk');
-    for (const f of mediumRisk) {
-      lines.push(`- ${f.feature_key} (health: ${f.health_score}, ${f.modifications_since_test} untested modifications)`);
-    }
-    lines.push('');
-  }
-
-  if (lowRisk.length > 0) {
-    lines.push('### Low Risk');
-    for (const f of lowRisk) {
-      lines.push(`- ${f.feature_key} (health: ${f.health_score})`);
-    }
-  }
-
-  return text(lines.join('\n'));
-}
-
-function text(content: string): ToolResult {
-  return { content: [{ type: 'text', text: content }] };
-}

package/src/rules.ts

@@ -1,57 +0,0 @@
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-import { getConfig } from './config.ts';
-
-export interface PatternRule {
-  /** Glob pattern to match file paths against */
-  match: string;
-  /** List of rules that apply to matched files */
-  rules: string[];
-  /** Severity: CRITICAL rules are schema mismatches or Edge Runtime violations */
-  severity?: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
-  /** Pattern file to reference for details */
-  patternFile?: string;
-}
-
-/**
- * Get pattern rules from config.
- * Converts the config format (pattern/rules) to the internal PatternRule format.
- */
-function getPatternRules(): PatternRule[] {
-  return getConfig().rules.map((r) => ({
-    match: r.pattern,
-    rules: r.rules,
-  }));
-}
-
-/**
- * Match a file path against all pattern rules and return applicable rules.
- */
-export function matchRules(filePath: string): PatternRule[] {
-  const normalized = filePath.replace(/\\/g, '/');
-  const rules = getPatternRules();
-  return rules.filter((rule) => globMatch(normalized, rule.match));
-}
-
-/**
- * Simple glob matching for pattern rules.
- * Supports **, *, and ? wildcards.
- */
-export function globMatch(filePath: string, pattern: string): boolean {
-  // Convert glob to regex using placeholders to avoid replacement conflicts
-  let regexStr = pattern
-    .replace(/\*\*\//g, '\0GLOBSTARSLASH\0')  // **/ placeholder
-    .replace(/\*\*/g, '\0GLOBSTAR\0')          // ** placeholder
-    .replace(/\*/g, '\0STAR\0')                // * placeholder
-    .replace(/\?/g, '\0QUESTION\0')            // ? placeholder
-    .replace(/\./g, '\\.')                      // escape dots
-    .replace(/\0GLOBSTARSLASH\0/g, '(?:.*/)?') // **/ = zero or more directories
-    .replace(/\0GLOBSTAR\0/g, '.*')            // ** = anything
-    .replace(/\0STAR\0/g, '[^/]*')             // * = non-slash chars
-    .replace(/\0QUESTION\0/g, '.');            // ? = single char
-
-  // Anchor pattern
-  const regex = new RegExp(`(^|/)${regexStr}($|/)`);
-  return regex.test(filePath);
-}

package/src/schema-mapper.ts

@@ -1,232 +0,0 @@
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-import { readFileSync, existsSync, readdirSync } from 'fs';
-import { resolve, join } from 'path';
-import { getConfig, getResolvedPaths, getProjectRoot } from './config.ts';
-
-export interface SchemaModel {
-  name: string;
-  tableName: string;
-  fields: SchemaField[];
-}
-
-export interface SchemaField {
-  name: string;
-  type: string;
-  nullable: boolean;
-  isRelation: boolean;
-}
-
-export interface ColumnUsage {
-  file: string;
-  line: number;
-  usage: string;
-}
-
-export interface SchemaMismatch {
-  table: string;
-  codeColumn: string;
-  actualColumns: string[];
-  files: string[];
-  severity: 'CRITICAL' | 'HIGH';
-}
-
-/**
- * Parse the Prisma schema file and extract all models with their fields.
- */
-export function parsePrismaSchema(): SchemaModel[] {
-  const schemaPath = getResolvedPaths().prismaSchemaPath;
-  if (!existsSync(schemaPath)) {
-    throw new Error(`Prisma schema not found at ${schemaPath}`);
-  }
-
-  const source = readFileSync(schemaPath, 'utf-8');
-  const models: SchemaModel[] = [];
-  const sourceLines = source.split('\n');
-
-  // Parse models by tracking brace depth instead of regex
-  let i = 0;
-  while (i < sourceLines.length) {
-    const line = sourceLines[i].trim();
-    const modelMatch = line.match(/^model\s+(\w+)\s*\{/);
-
-    if (modelMatch) {
-      const modelName = modelMatch[1];
-      const fields: SchemaField[] = [];
-      let braceDepth = 1;
-      i++;
-
-      const bodyLines: string[] = [];
-      while (i < sourceLines.length && braceDepth > 0) {
-        const bodyLine = sourceLines[i];
-        for (const ch of bodyLine) {
-          if (ch === '{') braceDepth++;
-          if (ch === '}') braceDepth--;
-        }
-        if (braceDepth > 0) {
-          bodyLines.push(bodyLine);
-        }
-        i++;
-      }
-
-      for (const bodyLine of bodyLines) {
-        const trimmed = bodyLine.trim();
-        if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('@@')) continue;
-
-        // Parse field: fieldName Type? @annotations
-        // Must handle large whitespace padding in the schema
-        const fieldMatch = trimmed.match(/^(\w+)\s+(\w+)(\?)?(\[\])?\s*(.*)?$/);
-        if (fieldMatch) {
-          const fieldName = fieldMatch[1];
-          const fieldType = fieldMatch[2];
-          const nullable = !!fieldMatch[3];
-          const annotations = fieldMatch[5] || '';
-
-          // Skip @relation fields (they're virtual)
-          const isRelation = annotations.includes('@relation') || fieldType[0] === fieldType[0].toUpperCase() && !['String', 'Int', 'Float', 'Boolean', 'DateTime', 'Json', 'Decimal', 'BigInt', 'Bytes'].includes(fieldType);
-
-          fields.push({
-            name: fieldName,
-            type: fieldType + (fieldMatch[4] || '') + (nullable ? '?' : ''),
-            nullable,
-            isRelation,
-          });
-        }
-      }
-
-      // Derive table name from @@map or use model name directly (Prisma convention)
-      const body = bodyLines.join('\n');
-      const mapMatch = body.match(/@@map\("([^"]+)"\)/);
-      const tableName = mapMatch ? mapMatch[1] : toSnakeCase(modelName);
-
-      models.push({ name: modelName, tableName, fields });
-    } else {
-      i++;
-    }
-  }
-
-  return models;
-}
-
-function toSnakeCase(str: string): string {
-  return str
-    .replace(/([A-Z])/g, '_$1')
-    .toLowerCase()
-    .replace(/^_/, '');
-}
-
-/**
- * Find all references to a table's columns in router files.
- */
-export function findColumnUsageInRouters(tableName: string): Map<string, ColumnUsage[]> {
-  const usage = new Map<string, ColumnUsage[]>();
-  const routersDir = getResolvedPaths().routersDir;
-
-  if (!existsSync(routersDir)) return usage;
-
-  scanDirectory(routersDir, tableName, usage);
-  return usage;
-}
-
-function scanDirectory(dir: string, tableName: string, usage: Map<string, ColumnUsage[]>): void {
-  const entries = readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      scanDirectory(fullPath, tableName, usage);
-    } else if (entry.name.endsWith('.ts')) {
-      scanFile(fullPath, tableName, usage);
-    }
-  }
-}
-
-function scanFile(absPath: string, tableName: string, usage: Map<string, ColumnUsage[]>): void {
-  try {
-    const source = readFileSync(absPath, 'utf-8');
-
-    // Check if this file references the table
-    if (!source.includes(tableName)) return;
-
-    const relPath = absPath.slice(getProjectRoot().length + 1);
-    const lines = source.split('\n');
-
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-
-      // Look for property access patterns: tableName.columnName or { columnName: ... } near table references
-      // Pattern 1: where: { columnName: value }
-      const whereMatch = line.match(/(\w+)\s*:\s*(?:\{|[^,}]+)/g);
-      if (whereMatch) {
-        for (const m of whereMatch) {
-          const colName = m.split(':')[0].trim();
-          if (colName && !['where', 'data', 'select', 'orderBy', 'include', 'const', 'let', 'return', 'if', 'else', 'async', 'await'].includes(colName)) {
-            if (!usage.has(colName)) usage.set(colName, []);
-            usage.get(colName)!.push({ file: relPath, line: i + 1, usage: line.trim() });
-          }
-        }
-      }
-    }
-  } catch {
-    // Skip unreadable
-  }
-}
-
-/**
- * Detect column name mismatches between code and schema.
- */
-export function detectMismatches(models: SchemaModel[]): SchemaMismatch[] {
-  const mismatches: SchemaMismatch[] = [];
-
-  const knownMismatches = getConfig().knownMismatches ?? {};
-
-  for (const [tableName, wrongColumns] of Object.entries(knownMismatches)) {
-    const model = models.find(m => m.tableName === tableName);
-    if (!model) continue;
-
-    const actualColumnNames = model.fields.map(f => f.name);
-
-    for (const [wrongCol, correctCol] of Object.entries(wrongColumns)) {
-      // Search for the wrong column name in code
-      const routersDir = getResolvedPaths().routersDir;
-      const files = findFilesUsingColumn(routersDir, wrongCol, tableName);
-
-      if (files.length > 0) {
-        mismatches.push({
-          table: tableName,
-          codeColumn: wrongCol,
-          actualColumns: actualColumnNames,
-          files,
-          severity: 'CRITICAL',
-        });
-      }
-    }
-  }
-
-  return mismatches;
-}
-
-function findFilesUsingColumn(dir: string, column: string, tableName: string): string[] {
-  const result: string[] = [];
-  if (!existsSync(dir)) return result;
-
-  const entries = readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      result.push(...findFilesUsingColumn(fullPath, column, tableName));
-    } else if (entry.name.endsWith('.ts')) {
-      try {
-        const source = readFileSync(fullPath, 'utf-8');
-        // Only flag if both the table name and wrong column are in the file
-        if (source.includes(tableName) && source.includes(column)) {
-          result.push(fullPath.slice(getProjectRoot().length + 1));
-        }
-      } catch {
-        // Skip
-      }
-    }
-  }
-
-  return result;
-}