@timmeck/brain 1.0.0 → 1.1.0

package/src/research/trend-analyzer.ts

@@ -1,127 +1,127 @@
-import type { ResearchConfig } from '../types/config.types.js';
-import type { ErrorRepository } from '../db/repositories/error.repository.js';
-import type { SolutionRepository } from '../db/repositories/solution.repository.js';
-import type { ProjectRepository } from '../db/repositories/project.repository.js';
-import type { InsightRepository } from '../db/repositories/insight.repository.js';
-import { getLogger } from '../utils/logger.js';
-
-/**
- * Analyzes error frequency and solution success rate trends over time windows.
- */
-export class TrendAnalyzer {
-  private logger = getLogger();
-
-  constructor(
-    private errorRepo: ErrorRepository,
-    private solutionRepo: SolutionRepository,
-    private projectRepo: ProjectRepository,
-    private insightRepo: InsightRepository,
-    private config: ResearchConfig,
-  ) {}
-
-  analyze(): number {
-    const projects = this.projectRepo.getAll();
-    let insightsCreated = 0;
-
-    for (const project of projects) {
-      insightsCreated += this.analyzeErrorTrend(project.id, project.name);
-      insightsCreated += this.analyzeSolutionTrend(project.id, project.name);
-    }
-
-    this.logger.info(`Trend analysis complete: ${insightsCreated} insights`);
-    return insightsCreated;
-  }
-
-  private analyzeErrorTrend(projectId: number, projectName: string): number {
-    const windowDays = this.config.trendWindowDays;
-    const now = Date.now();
-    const recentSince = new Date(now - windowDays * 86400000).toISOString();
-    const previousSince = new Date(now - windowDays * 2 * 86400000).toISOString();
-
-    const recentErrors = this.errorRepo.countSince(recentSince, projectId);
-    const allSinceDouble = this.errorRepo.countSince(previousSince, projectId);
-    const previousErrors = allSinceDouble - recentErrors;
-
-    if (previousErrors <= 0) return 0;
-
-    const changeRate = (recentErrors - previousErrors) / previousErrors;
-    const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
-
-    if (changeRate > 0.5) {
-      this.insightRepo.create({
-        type: 'warning',
-        title: `Error rate rising in ${projectName}`,
-        description: `${Math.round(changeRate * 100)}% more errors in the last ${windowDays} days vs previous window. Check recent changes: new dependencies, refactoring, or API changes.`,
-        evidence: JSON.stringify({ recentErrors, previousErrors, changeRate, windowDays }),
-        priority: Math.min(90, 50 + Math.round(changeRate * 30)),
-        project_id: projectId,
-        active: 1,
-        expires_at: expiresAt,
-      });
-      return 1;
-    }
-
-    if (changeRate < -0.3) {
-      this.insightRepo.create({
-        type: 'pattern',
-        title: `Error rate declining in ${projectName}`,
-        description: `${Math.round(-changeRate * 100)}% fewer errors in the last ${windowDays} days. Whatever you're doing is working.`,
-        evidence: JSON.stringify({ recentErrors, previousErrors, changeRate, windowDays }),
-        priority: 20,
-        project_id: projectId,
-        active: 1,
-        expires_at: expiresAt,
-      });
-      return 1;
-    }
-
-    return 0;
-  }
-
-  private analyzeSolutionTrend(projectId: number, projectName: string): number {
-    const errors = this.errorRepo.findByProject(projectId);
-    if (errors.length < this.config.minDataPoints) return 0;
-
-    let totalRate = 0;
-    let recentRate = 0;
-    let totalCount = 0;
-    let recentCount = 0;
-    const recentCutoff = new Date(Date.now() - this.config.trendWindowDays * 86400000).toISOString();
-
-    for (const error of errors) {
-      const solutions = this.solutionRepo.findForError(error.id);
-      for (const sol of solutions) {
-        const rate = this.solutionRepo.successRate(sol.id);
-        totalRate += rate;
-        totalCount++;
-
-        if (sol.updated_at >= recentCutoff) {
-          recentRate += rate;
-          recentCount++;
-        }
-      }
-    }
-
-    if (totalCount === 0 || recentCount === 0) return 0;
-
-    const avgTotal = totalRate / totalCount;
-    const avgRecent = recentRate / recentCount;
-
-    if (avgRecent < avgTotal - 0.15 && totalCount >= this.config.minDataPoints) {
-      const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
-      this.insightRepo.create({
-        type: 'warning',
-        title: `Solution quality declining in ${projectName}`,
-        description: `Recent success rate ${Math.round(avgRecent * 100)}% vs overall ${Math.round(avgTotal * 100)}%. Solutions are becoming less effective.`,
-        evidence: JSON.stringify({ avgRecent, avgTotal, recentCount, totalCount }),
-        priority: 60,
-        project_id: projectId,
-        active: 1,
-        expires_at: expiresAt,
-      });
-      return 1;
-    }
-
-    return 0;
-  }
-}
+import type { ResearchConfig } from '../types/config.types.js';
+import type { ErrorRepository } from '../db/repositories/error.repository.js';
+import type { SolutionRepository } from '../db/repositories/solution.repository.js';
+import type { ProjectRepository } from '../db/repositories/project.repository.js';
+import type { InsightRepository } from '../db/repositories/insight.repository.js';
+import { getLogger } from '../utils/logger.js';
+
+/**
+ * Analyzes error frequency and solution success rate trends over time windows.
+ */
+export class TrendAnalyzer {
+  private logger = getLogger();
+
+  constructor(
+    private errorRepo: ErrorRepository,
+    private solutionRepo: SolutionRepository,
+    private projectRepo: ProjectRepository,
+    private insightRepo: InsightRepository,
+    private config: ResearchConfig,
+  ) {}
+
+  analyze(): number {
+    const projects = this.projectRepo.getAll();
+    let insightsCreated = 0;
+
+    for (const project of projects) {
+      insightsCreated += this.analyzeErrorTrend(project.id, project.name);
+      insightsCreated += this.analyzeSolutionTrend(project.id, project.name);
+    }
+
+    this.logger.info(`Trend analysis complete: ${insightsCreated} insights`);
+    return insightsCreated;
+  }
+
+  private analyzeErrorTrend(projectId: number, projectName: string): number {
+    const windowDays = this.config.trendWindowDays;
+    const now = Date.now();
+    const recentSince = new Date(now - windowDays * 86400000).toISOString();
+    const previousSince = new Date(now - windowDays * 2 * 86400000).toISOString();
+
+    const recentErrors = this.errorRepo.countSince(recentSince, projectId);
+    const allSinceDouble = this.errorRepo.countSince(previousSince, projectId);
+    const previousErrors = allSinceDouble - recentErrors;
+
+    if (previousErrors <= 0) return 0;
+
+    const changeRate = (recentErrors - previousErrors) / previousErrors;
+    const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
+
+    if (changeRate > 0.5) {
+      this.insightRepo.create({
+        type: 'warning',
+        title: `Error rate rising in ${projectName}`,
+        description: `${Math.round(changeRate * 100)}% more errors in the last ${windowDays} days vs previous window. Check recent changes: new dependencies, refactoring, or API changes.`,
+        evidence: JSON.stringify({ recentErrors, previousErrors, changeRate, windowDays }),
+        priority: Math.min(90, 50 + Math.round(changeRate * 30)),
+        project_id: projectId,
+        active: 1,
+        expires_at: expiresAt,
+      });
+      return 1;
+    }
+
+    if (changeRate < -0.3) {
+      this.insightRepo.create({
+        type: 'pattern',
+        title: `Error rate declining in ${projectName}`,
+        description: `${Math.round(-changeRate * 100)}% fewer errors in the last ${windowDays} days. Whatever you're doing is working.`,
+        evidence: JSON.stringify({ recentErrors, previousErrors, changeRate, windowDays }),
+        priority: 20,
+        project_id: projectId,
+        active: 1,
+        expires_at: expiresAt,
+      });
+      return 1;
+    }
+
+    return 0;
+  }
+
+  private analyzeSolutionTrend(projectId: number, projectName: string): number {
+    const errors = this.errorRepo.findByProject(projectId);
+    if (errors.length < this.config.minDataPoints) return 0;
+
+    let totalRate = 0;
+    let recentRate = 0;
+    let totalCount = 0;
+    let recentCount = 0;
+    const recentCutoff = new Date(Date.now() - this.config.trendWindowDays * 86400000).toISOString();
+
+    for (const error of errors) {
+      const solutions = this.solutionRepo.findForError(error.id);
+      for (const sol of solutions) {
+        const rate = this.solutionRepo.successRate(sol.id);
+        totalRate += rate;
+        totalCount++;
+
+        if (sol.updated_at >= recentCutoff) {
+          recentRate += rate;
+          recentCount++;
+        }
+      }
+    }
+
+    if (totalCount === 0 || recentCount === 0) return 0;
+
+    const avgTotal = totalRate / totalCount;
+    const avgRecent = recentRate / recentCount;
+
+    if (avgRecent < avgTotal - 0.15 && totalCount >= this.config.minDataPoints) {
+      const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
+      this.insightRepo.create({
+        type: 'warning',
+        title: `Solution quality declining in ${projectName}`,
+        description: `Recent success rate ${Math.round(avgRecent * 100)}% vs overall ${Math.round(avgTotal * 100)}%. Solutions are becoming less effective.`,
+        evidence: JSON.stringify({ avgRecent, avgTotal, recentCount, totalCount }),
+        priority: 60,
+        project_id: projectId,
+        active: 1,
+        expires_at: expiresAt,
+      });
+      return 1;
+    }
+
+    return 0;
+  }
+}

package/src/services/analytics.service.ts

@@ -1,87 +1,87 @@
-import type { ErrorRepository } from '../db/repositories/error.repository.js';
-import type { SolutionRepository } from '../db/repositories/solution.repository.js';
-import type { CodeModuleRepository } from '../db/repositories/code-module.repository.js';
-import type { RuleRepository } from '../db/repositories/rule.repository.js';
-import type { AntipatternRepository } from '../db/repositories/antipattern.repository.js';
-import type { InsightRepository } from '../db/repositories/insight.repository.js';
-import type { SynapseManager } from '../synapses/synapse-manager.js';
-import type { NetworkStats } from '../types/synapse.types.js';
-
-export interface ProjectSummary {
-  errors: { total: number; unresolved: number; last7d: number };
-  solutions: { total: number };
-  rules: { active: number };
-  antipatterns: { total: number };
-  modules: { total: number };
-  insights: { active: number };
-}
-
-export interface NetworkOverview {
-  stats: NetworkStats;
-  strongestSynapses: Array<{
-    id: number;
-    source: string;
-    target: string;
-    type: string;
-    weight: number;
-  }>;
-}
-
-export class AnalyticsService {
-  constructor(
-    private errorRepo: ErrorRepository,
-    private solutionRepo: SolutionRepository,
-    private codeModuleRepo: CodeModuleRepository,
-    private ruleRepo: RuleRepository,
-    private antipatternRepo: AntipatternRepository,
-    private insightRepo: InsightRepository,
-    private synapseManager: SynapseManager,
-  ) {}
-
-  getSummary(projectId?: number): ProjectSummary {
-    const sevenDaysAgo = new Date(Date.now() - 7 * 86400000).toISOString();
-
-    const unresolvedErrors = this.errorRepo.findUnresolved(projectId);
-    const allErrors = projectId ? this.errorRepo.findByProject(projectId) : [];
-    const last7dCount = this.errorRepo.countSince(sevenDaysAgo, projectId);
-
-    const rules = this.ruleRepo.findActive(projectId);
-    const antipatterns = projectId
-      ? this.antipatternRepo.findByProject(projectId)
-      : this.antipatternRepo.findGlobal();
-
-    const moduleCount = projectId
-      ? this.codeModuleRepo.findByProject(projectId).length
-      : this.codeModuleRepo.countAll();
-    const insights = this.insightRepo.findActive(projectId);
-
-    return {
-      errors: {
-        total: allErrors.length,
-        unresolved: unresolvedErrors.length,
-        last7d: last7dCount,
-      },
-      solutions: { total: 0 }, // solutions are global, not per-project
-      rules: { active: rules.length },
-      antipatterns: { total: antipatterns.length },
-      modules: { total: moduleCount },
-      insights: { active: insights.length },
-    };
-  }
-
-  getNetworkOverview(limit: number = 10): NetworkOverview {
-    const stats = this.synapseManager.getNetworkStats();
-    const strongest = this.synapseManager.getStrongestSynapses(limit);
-
-    return {
-      stats,
-      strongestSynapses: strongest.map(s => ({
-        id: s.id,
-        source: `${s.source_type}:${s.source_id}`,
-        target: `${s.target_type}:${s.target_id}`,
-        type: s.synapse_type,
-        weight: s.weight,
-      })),
-    };
-  }
-}
+import type { ErrorRepository } from '../db/repositories/error.repository.js';
+import type { SolutionRepository } from '../db/repositories/solution.repository.js';
+import type { CodeModuleRepository } from '../db/repositories/code-module.repository.js';
+import type { RuleRepository } from '../db/repositories/rule.repository.js';
+import type { AntipatternRepository } from '../db/repositories/antipattern.repository.js';
+import type { InsightRepository } from '../db/repositories/insight.repository.js';
+import type { SynapseManager } from '../synapses/synapse-manager.js';
+import type { NetworkStats } from '../types/synapse.types.js';
+
+export interface ProjectSummary {
+  errors: { total: number; unresolved: number; last7d: number };
+  solutions: { total: number };
+  rules: { active: number };
+  antipatterns: { total: number };
+  modules: { total: number };
+  insights: { active: number };
+}
+
+export interface NetworkOverview {
+  stats: NetworkStats;
+  strongestSynapses: Array<{
+    id: number;
+    source: string;
+    target: string;
+    type: string;
+    weight: number;
+  }>;
+}
+
+export class AnalyticsService {
+  constructor(
+    private errorRepo: ErrorRepository,
+    private solutionRepo: SolutionRepository,
+    private codeModuleRepo: CodeModuleRepository,
+    private ruleRepo: RuleRepository,
+    private antipatternRepo: AntipatternRepository,
+    private insightRepo: InsightRepository,
+    private synapseManager: SynapseManager,
+  ) {}
+
+  getSummary(projectId?: number): ProjectSummary {
+    const sevenDaysAgo = new Date(Date.now() - 7 * 86400000).toISOString();
+
+    const unresolvedErrors = this.errorRepo.findUnresolved(projectId);
+    const allErrors = projectId ? this.errorRepo.findByProject(projectId) : [];
+    const last7dCount = this.errorRepo.countSince(sevenDaysAgo, projectId);
+
+    const rules = this.ruleRepo.findActive(projectId);
+    const antipatterns = projectId
+      ? this.antipatternRepo.findByProject(projectId)
+      : this.antipatternRepo.findGlobal();
+
+    const moduleCount = projectId
+      ? this.codeModuleRepo.findByProject(projectId).length
+      : this.codeModuleRepo.countAll();
+    const insights = this.insightRepo.findActive(projectId);
+
+    return {
+      errors: {
+        total: allErrors.length,
+        unresolved: unresolvedErrors.length,
+        last7d: last7dCount,
+      },
+      solutions: { total: 0 }, // solutions are global, not per-project
+      rules: { active: rules.length },
+      antipatterns: { total: antipatterns.length },
+      modules: { total: moduleCount },
+      insights: { active: insights.length },
+    };
+  }
+
+  getNetworkOverview(limit: number = 10): NetworkOverview {
+    const stats = this.synapseManager.getNetworkStats();
+    const strongest = this.synapseManager.getStrongestSynapses(limit);
+
+    return {
+      stats,
+      strongestSynapses: strongest.map(s => ({
+        id: s.id,
+        source: `${s.source_type}:${s.source_id}`,
+        target: `${s.target_type}:${s.target_id}`,
+        type: s.synapse_type,
+        weight: s.weight,
+      })),
+    };
+  }
+}

package/src/services/code.service.ts

@@ -127,11 +127,14 @@ export class CodeService {
     return findSemanticMatches(source, allModules, 0.5);
   }
 
-  listModules(projectId?: number): CodeModuleRecord[] {
+  listModules(projectId?: number, language?: string, limit?: number): CodeModuleRecord[] {
     if (projectId) {
       return this.codeModuleRepo.findByProject(projectId);
     }
-    return [];
+    if (language) {
+      return this.codeModuleRepo.findByLanguage(language, limit);
+    }
+    return this.codeModuleRepo.findAll(limit);
   }
 
   getById(id: number): CodeModuleRecord | undefined {