nodebench-mcp 2.17.0 → 2.18.1

package/dist/analytics/smartPreset.js

@@ -0,0 +1,300 @@
+/**
+ * Smart Preset Generator — Weighted Multi-Signal Scoring Model
+ *
+ * Recommends preset (default vs full) using 5 weighted signals derived from
+ * actual project context and historical usage data:
+ *
+ *   1. Project Type Affinity   — static: how many specialized toolsets fit this project type
+ *   2. Usage Breadth            — empirical: how many distinct toolsets were actually used
+ *   3. Specialized Usage Depth  — empirical: calls to non-default toolsets (weighted by recency)
+ *   4. Failure Penalty          — empirical: frequently failing tools penalize confidence
+ *   5. History Weight           — meta: more history = higher confidence in the recommendation
+ *
+ * The final score is a weighted sum normalized to [0, 1].
+ *   score > 0.55  →  recommend full
+ *   score <= 0.55 →  recommend default
+ *   confidence = f(history_weight, failure_penalty)
+ */
+import { detectProject } from './projectDetector.js';
+import { getToolUsageStats, getToolsetUsageStats, getFrequentlyFailingTools, } from './usageStats.js';
+// ── Constants ───────────────────────────────────────────────────────────
+const DEFAULT_TOOLSETS = ['verification', 'eval', 'quality_gate', 'learning', 'flywheel', 'recon', 'security', 'boilerplate'];
+const DEFAULT_TOOLSET_SET = new Set(DEFAULT_TOOLSETS);
+const SCORE_THRESHOLD = 0.55; // above this → recommend full
+// Signal weights (sum to 1.0)
+const W_PROJECT_TYPE = 0.25;
+const W_USAGE_BREADTH = 0.30;
+const W_SPECIALIZED_DEPTH = 0.30;
+const W_HISTORY = 0.15;
+// Project type → extra toolsets beyond default
+const PROJECT_TYPE_EXTRAS = {
+    web_frontend: ['ui_capture', 'vision'],
+    web_backend: ['web', 'github'],
+    fullstack: ['ui_capture', 'vision', 'web', 'github', 'llm'],
+    mobile: [],
+    desktop: [],
+    cli: [],
+    library: ['docs', 'github'],
+    data_science: ['local_file', 'llm'],
+    devops: ['github'],
+    unknown: [],
+};
+// All toolsets considered "specialized" (not in default)
+const SPECIALIZED_TOOLSETS = [
+    'ui_capture', 'vision', 'web', 'github', 'docs', 'local_file',
+    'self_eval', 'parallel', 'llm', 'platform', 'research_writing',
+    'bootstrap', 'flicker_detection', 'figma_flow', 'benchmark',
+    'gaia_solvers', 'session_memory', 'toon', 'pattern', 'git_workflow',
+    'seo', 'voice_bridge', 'critter', 'email', 'rss', 'architect',
+];
+// ── Helpers ─────────────────────────────────────────────────────────────
+function calculateToolsetCount(toolsets, toolsetMap) {
+    let count = 0;
+    for (const ts of toolsets)
+        count += toolsetMap[ts]?.length || 0;
+    return count + 6; // +6 meta/discovery
+}
+function createPresets(toolsetMap) {
+    return {
+        default: {
+            name: 'default',
+            toolsets: DEFAULT_TOOLSETS,
+            toolCount: calculateToolsetCount(DEFAULT_TOOLSETS, toolsetMap),
+        },
+        full: {
+            name: 'full',
+            toolsets: Object.keys(toolsetMap),
+            toolCount: Object.values(toolsetMap).reduce((s, t) => s + t.length, 0) + 6,
+        },
+    };
+}
+// ── Signal computation ──────────────────────────────────────────────────
+function computeProjectTypeAffinity(projectType) {
+    const extras = PROJECT_TYPE_EXTRAS[projectType] || [];
+    // 0 extras → 0.0 (default is fine), 5+ extras → 1.0 (needs full)
+    return Math.min(extras.length / 5, 1.0);
+}
+function computeUsageBreadth(toolsetStats, totalAvailableToolsets) {
+    if (totalAvailableToolsets === 0)
+        return 0;
+    const usedCount = toolsetStats.filter(ts => ts.totalCalls > 0).length;
+    // Fraction of available toolsets that were actually used
+    return Math.min(usedCount / totalAvailableToolsets, 1.0);
+}
+function computeSpecializedDepth(toolsetStats, totalCalls) {
+    if (totalCalls === 0)
+        return 0;
+    // What fraction of total calls went to non-default toolsets?
+    const specializedCalls = toolsetStats
+        .filter(ts => !DEFAULT_TOOLSET_SET.has(ts.toolset))
+        .reduce((sum, ts) => sum + ts.totalCalls, 0);
+    return Math.min(specializedCalls / totalCalls, 1.0);
+}
+function computeFailurePenalty(failingTools, totalCalls) {
+    if (totalCalls === 0 || failingTools.length === 0)
+        return 0;
+    const totalFailures = failingTools.reduce((s, t) => s + t.failureCount, 0);
+    // Cap at 0.5 — failures reduce confidence but don't dominate
+    return Math.min(totalFailures / totalCalls, 0.5);
+}
+function computeHistoryWeight(totalCalls) {
+    // No history → 0, 10 calls → 0.5, 100+ calls → 1.0 (logarithmic)
+    if (totalCalls === 0)
+        return 0;
+    return Math.min(Math.log10(totalCalls + 1) / 2, 1.0);
+}
+// ── Core: generate recommendation ───────────────────────────────────────
+export function generateSmartPreset(db, toolsetMap, projectPath = process.cwd()) {
+    const projectContext = detectProject(projectPath);
+    const presets = createPresets(toolsetMap);
+    const availableToolsets = Object.keys(toolsetMap);
+    // Gather empirical data
+    const toolsetStats = getToolsetUsageStats(db, projectPath, 30);
+    const toolStats = getToolUsageStats(db, projectPath, 30);
+    const failingToolsRaw = getFrequentlyFailingTools(db, projectPath, 30, 2);
+    const totalCalls = toolStats.reduce((s, t) => s + t.callCount, 0);
+    // Compute 5 signals
+    const projectTypeAffinity = computeProjectTypeAffinity(projectContext.projectType);
+    const usageBreadth = computeUsageBreadth(toolsetStats, availableToolsets.length);
+    const specializedDepth = computeSpecializedDepth(toolsetStats, totalCalls);
+    const failurePenalty = computeFailurePenalty(failingToolsRaw, totalCalls);
+    const historyWeight = computeHistoryWeight(totalCalls);
+    const signals = {
+        projectTypeAffinity,
+        usageBreadth,
+        specializedDepth,
+        failurePenalty,
+        historyWeight,
+    };
+    // Weighted score: blend static (project type) with empirical signals
+    // When history is low, project type dominates. When history is rich, usage dominates.
+    const empiricalBlend = historyWeight; // 0 = no history, 1 = trust history fully
+    const staticScore = projectTypeAffinity;
+    const empiricalScore = (usageBreadth * W_USAGE_BREADTH + specializedDepth * W_SPECIALIZED_DEPTH + historyWeight * W_HISTORY)
+        / (W_USAGE_BREADTH + W_SPECIALIZED_DEPTH + W_HISTORY);
+    // Normalize: simple weighted average where empirical grows with history
+    const score = Math.min(staticScore * (1 - empiricalBlend) + empiricalScore * empiricalBlend, 1.0);
+    // Decision
+    const preset = score > SCORE_THRESHOLD ? 'full' : 'default';
+    // Confidence: higher with more history, penalized by failures
+    const baseConfidence = historyWeight > 0
+        ? 0.6 + historyWeight * 0.35 // 0.6 → 0.95 as history grows
+        : 0.5 + projectTypeAffinity * 0.3; // 0.5 → 0.8 for static-only
+    const confidence = Math.max(0.3, baseConfidence - failurePenalty * 0.2);
+    // Build reason
+    const reason = buildReason(preset, signals, projectContext, totalCalls);
+    // Build suggested toolsets: default + project-type extras + actually-used specialized
+    const extras = PROJECT_TYPE_EXTRAS[projectContext.projectType] || [];
+    const usedSpecialized = toolsetStats
+        .filter(ts => !DEFAULT_TOOLSET_SET.has(ts.toolset) && ts.totalCalls > 0)
+        .map(ts => ts.toolset);
+    const suggestedToolsets = [...new Set([...DEFAULT_TOOLSETS, ...extras, ...usedSpecialized])];
+    const optionalToolsets = SPECIALIZED_TOOLSETS.filter(ts => !suggestedToolsets.includes(ts));
+    // Usage insights
+    const mostUsedToolsets = toolsetStats
+        .filter(ts => ts.totalCalls > 0)
+        .sort((a, b) => b.totalCalls - a.totalCalls)
+        .map(ts => ts.toolset)
+        .slice(0, 5);
+    const usedSet = new Set(toolsetStats.filter(ts => ts.totalCalls > 0).map(ts => ts.toolset));
+    const unusedToolsets = availableToolsets.filter(ts => !usedSet.has(ts));
+    return {
+        preset,
+        reason,
+        confidence: Math.round(confidence * 100) / 100,
+        score: Math.round(score * 1000) / 1000,
+        suggestedToolsets,
+        optionalToolsets,
+        projectContext,
+        usageInsights: {
+            mostUsedToolsets,
+            unusedToolsets,
+            frequentlyFailingTools: failingToolsRaw.map(t => ({
+                name: t.toolName,
+                failures: t.failureCount,
+                lastError: t.lastError,
+            })),
+            totalCallsLast30d: totalCalls,
+            uniqueToolsetsUsed: toolsetStats.filter(ts => ts.totalCalls > 0).length,
+        },
+        signals,
+    };
+}
+function buildReason(preset, signals, ctx, totalCalls) {
+    const parts = [];
+    if (totalCalls === 0) {
+        parts.push(`No usage history yet.`);
+        if (preset === 'full') {
+            parts.push(`Project type (${ctx.projectType}) suggests specialized toolsets would help.`);
+        }
+        else {
+            parts.push(`Project type (${ctx.projectType}) aligns with default preset.`);
+        }
+        parts.push(`As you use more tools, this recommendation will improve.`);
+    }
+    else {
+        parts.push(`Based on ${totalCalls} tool calls across ${signals.historyWeight > 0.5 ? 'rich' : 'limited'} history.`);
+        if (signals.specializedDepth > 0.3) {
+            parts.push(`${(signals.specializedDepth * 100).toFixed(0)}% of calls use specialized (non-default) toolsets.`);
+        }
+        if (signals.usageBreadth > 0.4) {
+            parts.push(`Broad toolset usage detected across ${(signals.usageBreadth * 100).toFixed(0)}% of available toolsets.`);
+        }
+        if (preset === 'full') {
+            parts.push(`Full preset recommended for comprehensive coverage.`);
+        }
+        else {
+            parts.push(`Default preset covers your current usage patterns.`);
+        }
+    }
+    if (signals.failurePenalty > 0.1) {
+        parts.push(`Note: ${(signals.failurePenalty * 100).toFixed(0)}% failure rate detected - check failing tools below.`);
+    }
+    return parts.join(' ');
+}
+// ── Preset listing ──────────────────────────────────────────────────────
+export function getPresetConfig(preset, toolsetMap) {
+    return createPresets(toolsetMap)[preset];
+}
+export function listPresets(toolsetMap) {
+    const presets = createPresets(toolsetMap);
+    const THEMED_PRESETS = [
+        { name: 'web_dev', extras: ['ui_capture', 'vision', 'web', 'seo', 'git_workflow', 'architect'], description: 'Web projects — adds visual QA, SEO audit, git workflow, code architecture' },
+        { name: 'research', extras: ['web', 'llm', 'rss', 'email', 'docs'], description: 'Research workflows — adds web search, LLM calls, RSS feeds, email, docs' },
+        { name: 'data', extras: ['local_file', 'llm', 'web'], description: 'Data analysis — adds CSV/XLSX/PDF/JSON parsing, LLM extraction, web fetch' },
+        { name: 'devops', extras: ['git_workflow', 'session_memory', 'benchmark', 'pattern'], description: 'CI/CD & ops — adds git compliance, session memory, benchmarks, pattern mining' },
+        { name: 'mobile', extras: ['ui_capture', 'vision', 'flicker_detection'], description: 'Mobile apps — adds screenshot capture, vision analysis, flicker detection' },
+        { name: 'academic', extras: ['research_writing', 'llm', 'web', 'local_file'], description: 'Academic papers — adds polish, review, translate, logic check, data analysis' },
+        { name: 'multi_agent', extras: ['parallel', 'self_eval', 'session_memory', 'pattern', 'toon'], description: 'Multi-agent teams — adds task locking, messaging, roles, oracle testing' },
+        { name: 'content', extras: ['llm', 'critter', 'email', 'rss', 'platform', 'architect'], description: 'Content & publishing — adds LLM, accountability, email, RSS, platform queue' },
+    ];
+    const result = [
+        {
+            name: 'default',
+            toolsets: presets.default.toolsets,
+            toolCount: presets.default.toolCount,
+            description: 'Core AI Flywheel methodology — verification, eval, quality gates, learning, recon, security, boilerplate',
+        },
+    ];
+    for (const themed of THEMED_PRESETS) {
+        const toolsets = [...DEFAULT_TOOLSETS, ...themed.extras];
+        result.push({
+            name: themed.name,
+            toolsets,
+            toolCount: calculateToolsetCount(toolsets, toolsetMap),
+            description: themed.description,
+        });
+    }
+    result.push({
+        name: 'full',
+        toolsets: presets.full.toolsets,
+        toolCount: presets.full.toolCount,
+        description: `All ${presets.full.toolCount} tools across ${Object.keys(toolsetMap).length} toolsets — complete coverage`,
+    });
+    return result;
+}
+// ── Formatted output ────────────────────────────────────────────────────
+export function formatPresetRecommendation(recommendation, toolsetMap) {
+    const lines = [];
+    const { signals: s, usageInsights: u, projectContext: p } = recommendation;
+    lines.push(`\n=== Smart Preset Recommendation ===\n`);
+    lines.push(`  Preset:     ${recommendation.preset.toUpperCase()}`);
+    lines.push(`  Confidence: ${(recommendation.confidence * 100).toFixed(0)}%`);
+    lines.push(`  Score:      ${recommendation.score.toFixed(3)} (threshold: ${SCORE_THRESHOLD})\n`);
+    lines.push(`  ${recommendation.reason}`);
+    // Signal breakdown
+    lines.push(`\n--- Signal Breakdown ---`);
+    lines.push(`  Project Type Affinity:  ${(s.projectTypeAffinity * 100).toFixed(0)}%  (${p.projectType}/${p.language}${p.framework ? '/' + p.framework : ''})`);
+    lines.push(`  Usage Breadth:          ${(s.usageBreadth * 100).toFixed(0)}%  (${u.uniqueToolsetsUsed}/${Object.keys(toolsetMap).length} toolsets used)`);
+    lines.push(`  Specialized Depth:      ${(s.specializedDepth * 100).toFixed(0)}%  (non-default call share)`);
+    lines.push(`  History Weight:         ${(s.historyWeight * 100).toFixed(0)}%  (${u.totalCallsLast30d} calls in 30d)`);
+    lines.push(`  Failure Penalty:        ${(s.failurePenalty * 100).toFixed(0)}%`);
+    // Project context
+    lines.push(`\n--- Project ---`);
+    lines.push(`  Type: ${p.projectType}  |  Language: ${p.language}${p.framework ? '  |  Framework: ' + p.framework : ''}`);
+    lines.push(`  Tests: ${p.hasTests ? 'Yes' : 'No'}  |  CI: ${p.hasCI ? 'Yes' : 'No'}  |  Files: ${p.fileCount}`);
+    // Suggested toolsets
+    lines.push(`\n--- Suggested Toolsets (${calculateToolsetCount(recommendation.suggestedToolsets, toolsetMap)} tools) ---`);
+    lines.push(`  ${recommendation.suggestedToolsets.join(', ')}`);
+    // Usage insights
+    if (u.mostUsedToolsets.length > 0) {
+        lines.push(`\n--- Most Used (30d) ---`);
+        lines.push(`  ${u.mostUsedToolsets.join(', ')}`);
+    }
+    // Failing tools warnings
+    if (u.frequentlyFailingTools.length > 0) {
+        lines.push(`\n--- Failing Tools (action required) ---`);
+        for (const t of u.frequentlyFailingTools) {
+            lines.push(`  ! ${t.name}: ${t.failures} failures${t.lastError ? ' - ' + t.lastError.slice(0, 80) : ''}`);
+        }
+    }
+    // How to apply
+    lines.push(`\n--- Apply ---`);
+    lines.push(`  npx nodebench-mcp --preset ${recommendation.preset}`);
+    if (recommendation.suggestedToolsets.length > DEFAULT_TOOLSETS.length) {
+        lines.push(`  npx nodebench-mcp --toolsets ${recommendation.suggestedToolsets.join(',')}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=smartPreset.js.map

package/dist/analytics/smartPreset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartPreset.js","sourceRoot":"","sources":["../../src/analytics/smartPreset.ts"],"names":[],"mappings":"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"}

package/dist/analytics/toolTracker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * AnalyticsTracker — Singleton analytics engine for NodeBench MCP
+ *
+ * Owns the full lifecycle: DB open, tool-call recording, project context,
+ * session stats, retention cleanup, and graceful shutdown.
+ * index.ts calls tracker.record() instead of inline SQL.
+ */
+import Database from 'better-sqlite3';
+export interface TrackerConfig {
+    projectPath: string;
+    preset: string;
+    toolCount: number;
+    /** tool name → toolset name lookup */
+    toolToToolset: Map<string, string>;
+    /** Tools to skip tracking (avoid recursion) */
+    skipTools?: Set<string>;
+    /** Days to keep analytics data (default 90) */
+    retentionDays?: number;
+}
+export interface SessionStats {
+    totalCalls: number;
+    successCount: number;
+    failureCount: number;
+    totalDuration: number;
+    uniqueTools: number;
+    topTools: Array<{
+        name: string;
+        count: number;
+    }>;
+    errorRate: number;
+}
+export declare class AnalyticsTracker {
+    private db;
+    private projectPath;
+    private preset;
+    private toolToToolset;
+    private skipTools;
+    private sessionStart;
+    private _callCount;
+    private _insertStmt;
+    private constructor();
+    /** Get or create the singleton tracker */
+    static init(config: TrackerConfig): AnalyticsTracker;
+    /** Get existing instance (returns null if not initialized) */
+    static get(): AnalyticsTracker | null;
+    /** Underlying DB handle (for stats queries that need it) */
+    getDb(): Database.Database;
+    /**
+     * Record a tool call outcome. Called from the CallToolRequestSchema handler.
+     * Returns silently on any error — analytics must never break tool dispatch.
+     */
+    record(toolName: string, startMs: number, success: boolean, errorMsg: string | null, args?: Record<string, unknown>): void;
+    getSessionStats(): SessionStats;
+    get callCount(): number;
+    close(): void;
+    private _initProjectContext;
+}
+/** @deprecated Use AnalyticsTracker.init() instead */
+export declare function initializeProjectContext(db: Database.Database, projectPath: string | undefined, preset: string, toolCount?: number): void;

package/dist/analytics/toolTracker.js

@@ -0,0 +1,163 @@
+/**
+ * AnalyticsTracker — Singleton analytics engine for NodeBench MCP
+ *
+ * Owns the full lifecycle: DB open, tool-call recording, project context,
+ * session stats, retention cleanup, and graceful shutdown.
+ * index.ts calls tracker.record() instead of inline SQL.
+ */
+import { getAnalyticsDb, closeAnalyticsDb, updateProjectContext, recordPresetSelection, clearOldRecords, } from './schema.js';
+import { detectProject } from './projectDetector.js';
+// ── Singleton ───────────────────────────────────────────────────────────
+let _instance = null;
+export class AnalyticsTracker {
+    db;
+    projectPath;
+    preset;
+    toolToToolset;
+    skipTools;
+    sessionStart;
+    _callCount = 0;
+    _insertStmt = null;
+    constructor(config) {
+        this.db = getAnalyticsDb();
+        this.projectPath = config.projectPath;
+        this.preset = config.preset;
+        this.toolToToolset = config.toolToToolset;
+        this.skipTools = config.skipTools ?? new Set();
+        this.sessionStart = Date.now();
+        // Run retention cleanup once on startup (non-blocking, best-effort)
+        const retentionDays = config.retentionDays ?? 90;
+        try {
+            clearOldRecords(this.db, retentionDays);
+        }
+        catch { /* ignore */ }
+        // Register project context
+        this._initProjectContext(config);
+        // Pre-compile the insert statement for performance
+        this._insertStmt = this.db.prepare(`INSERT INTO tool_usage (tool_name, toolset, timestamp, duration, success, error_message, project_path, preset, args)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+    }
+    /** Get or create the singleton tracker */
+    static init(config) {
+        if (!_instance) {
+            _instance = new AnalyticsTracker(config);
+        }
+        return _instance;
+    }
+    /** Get existing instance (returns null if not initialized) */
+    static get() {
+        return _instance;
+    }
+    /** Underlying DB handle (for stats queries that need it) */
+    getDb() {
+        return this.db;
+    }
+    // ── Core: record a tool call ────────────────────────────────────────
+    /**
+     * Record a tool call outcome. Called from the CallToolRequestSchema handler.
+     * Returns silently on any error — analytics must never break tool dispatch.
+     */
+    record(toolName, startMs, success, errorMsg, args) {
+        if (this.skipTools.has(toolName))
+            return;
+        try {
+            const toolset = this.toolToToolset.get(toolName) ?? 'unknown';
+            this._insertStmt.run(toolName, toolset, startMs, Date.now() - startMs, success ? 1 : 0, errorMsg, this.projectPath, this.preset, args ? JSON.stringify(args) : null);
+            this._callCount++;
+        }
+        catch { /* never break tool dispatch */ }
+    }
+    // ── Session stats ───────────────────────────────────────────────────
+    getSessionStats() {
+        const stmt = this.db.prepare(`
+      SELECT
+        COUNT(*) as totalCalls,
+        SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END) as successCount,
+        SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) as failureCount,
+        SUM(duration) as totalDuration,
+        COUNT(DISTINCT tool_name) as uniqueTools
+      FROM tool_usage
+      WHERE project_path = ? AND timestamp >= ?
+    `);
+        const r = stmt.get(this.projectPath, this.sessionStart);
+        const topStmt = this.db.prepare(`
+      SELECT tool_name as name, COUNT(*) as count
+      FROM tool_usage
+      WHERE project_path = ? AND timestamp >= ?
+      GROUP BY tool_name ORDER BY count DESC LIMIT 5
+    `);
+        const topTools = topStmt.all(this.projectPath, this.sessionStart);
+        const total = r.totalCalls || 0;
+        const failures = r.failureCount || 0;
+        return {
+            totalCalls: total,
+            successCount: r.successCount || 0,
+            failureCount: failures,
+            totalDuration: r.totalDuration || 0,
+            uniqueTools: r.uniqueTools || 0,
+            topTools,
+            errorRate: total > 0 ? failures / total : 0,
+        };
+    }
+    get callCount() {
+        return this._callCount;
+    }
+    // ── Lifecycle ───────────────────────────────────────────────────────
+    close() {
+        try {
+            closeAnalyticsDb(this.db);
+        }
+        catch { /* ignore */ }
+        _instance = null;
+    }
+    // ── Private helpers ─────────────────────────────────────────────────
+    _initProjectContext(config) {
+        const context = detectProject(config.projectPath);
+        const now = Date.now();
+        updateProjectContext(this.db, {
+            projectPath: config.projectPath,
+            projectType: context.projectType,
+            detectedAt: now,
+            lastSeen: now,
+            language: context.language,
+            framework: context.framework,
+            hasTests: context.hasTests,
+            hasCI: context.hasCI,
+            hasDocs: context.hasDocs,
+            fileCount: context.fileCount,
+        });
+        recordPresetSelection(this.db, {
+            projectPath: config.projectPath,
+            preset: config.preset,
+            toolsetCount: config.toolCount,
+            selectedAt: now,
+            selectionReason: 'manual',
+        });
+    }
+}
+// ── Convenience re-exports for backward compat ────────────────────────
+/** @deprecated Use AnalyticsTracker.init() instead */
+export function initializeProjectContext(db, projectPath = process.cwd(), preset, toolCount = 44) {
+    const context = detectProject(projectPath);
+    const now = Date.now();
+    updateProjectContext(db, {
+        projectPath,
+        projectType: context.projectType,
+        detectedAt: now,
+        lastSeen: now,
+        language: context.language,
+        framework: context.framework,
+        hasTests: context.hasTests,
+        hasCI: context.hasCI,
+        hasDocs: context.hasDocs,
+        fileCount: context.fileCount,
+    });
+    recordPresetSelection(db, {
+        projectPath,
+        preset,
+        toolsetCount: toolCount,
+        selectedAt: now,
+        selectionReason: 'manual',
+    });
+}
+//# sourceMappingURL=toolTracker.js.map

package/dist/analytics/toolTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolTracker.js","sourceRoot":"","sources":["../../src/analytics/toolTracker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,cAAc,EACd,gBAAgB,EAEhB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA0BrD,2EAA2E;AAE3E,IAAI,SAAS,GAA4B,IAAI,CAAC;AAE9C,MAAM,OAAO,gBAAgB;IACnB,EAAE,CAAoB;IACtB,WAAW,CAAS;IACpB,MAAM,CAAS;IACf,aAAa,CAAsB;IACnC,SAAS,CAAc;IACvB,YAAY,CAAS;IACrB,UAAU,GAAG,CAAC,CAAC;IACf,WAAW,GAA8B,IAAI,CAAC;IAEtD,YAAoB,MAAqB;QACvC,IAAI,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,GAAG,EAAE,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE/B,oEAAoE;QACpE,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC;YAAC,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAEvE,2BAA2B;QAC3B,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAEjC,mDAAmD;QACnD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAChC;0CACoC,CACrC,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,IAAI,CAAC,MAAqB;QAC/B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8DAA8D;IAC9D,MAAM,CAAC,GAAG;QACR,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,4DAA4D;IAC5D,KAAK;QACH,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,uEAAuE;IAEvE;;;OAGG;IACH,MAAM,CACJ,QAAgB,EAChB,OAAe,EACf,OAAgB,EAChB,QAAuB,EACvB,IAA8B;QAE9B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QACzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;YAC9D,IAAI,CAAC,WAAY,CAAC,GAAG,CACnB,QAAQ,EACR,OAAO,EACP,OAAO,EACP,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EACpB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACf,QAAQ,EACR,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CACnC,CAAC;YACF,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC,CAAC,+BAA+B,CAAC,CAAC;IAC7C,CAAC;IAED,uEAAuE;IAEvE,eAAe;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;KAS5B,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAQ,CAAC;QAE/D,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;KAK/B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAA2C,CAAC;QAE5G,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;QACrC,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC;YACjC,YAAY,EAAE,QAAQ;YACtB,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC;YACnC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC;YAC/B,QAAQ;YACR,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;SAC5C,CAAC;IACJ,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,uEAAuE;IAEvE,KAAK;QACH,IAAI,CAAC;YAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACzD,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,uEAAuE;IAE/D,mBAAmB,CAAC,MAAqB;QAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE;YAC5B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,GAAG;YACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,qBAAqB,CAAC,IAAI,CAAC,EAAE,EAAE;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY,EAAE,MAAM,CAAC,SAAS;YAC9B,UAAU,EAAE,GAAG;YACf,eAAe,EAAE,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AAED,yEAAyE;AAEzE,sDAAsD;AACtD,MAAM,UAAU,wBAAwB,CACtC,EAAqB,EACrB,cAAsB,OAAO,CAAC,GAAG,EAAE,EACnC,MAAc,EACd,YAAoB,EAAE;IAEtB,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,oBAAoB,CAAC,EAAE,EAAE;QACvB,WAAW;QACX,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IACH,qBAAqB,CAAC,EAAE,EAAE;QACxB,WAAW;QACX,MAAM;QACN,YAAY,EAAE,SAAS;QACvB,UAAU,EAAE,GAAG;QACf,eAAe,EAAE,QAAQ;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/analytics/usageStats.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Usage Statistics Aggregation
+ *
+ * Aggregates tool usage data to generate insights and recommendations.
+ */
+import Database from 'better-sqlite3';
+export interface ToolUsageStats {
+    toolName: string;
+    toolset: string;
+    callCount: number;
+    successCount: number;
+    failureCount: number;
+    avgDuration: number;
+    lastUsed: number;
+    firstUsed: number;
+}
+export interface ToolsetUsageStats {
+    toolset: string;
+    toolCount: number;
+    totalCalls: number;
+    uniqueToolsUsed: number;
+    avgCallsPerTool: number;
+}
+export interface ProjectUsageSummary {
+    projectPath: string;
+    totalCalls: number;
+    uniqueToolsUsed: number;
+    totalDuration: number;
+    avgDuration: number;
+    successRate: number;
+    mostUsedTool: string;
+    mostUsedToolset: string;
+    topTools: Array<{
+        name: string;
+        count: number;
+    }>;
+    topToolsets: Array<{
+        name: string;
+        count: number;
+    }>;
+}
+export interface UsageTrend {
+    date: string;
+    callCount: number;
+    uniqueTools: number;
+    avgDuration: number;
+}
+export declare function getToolUsageStats(db: Database.Database, projectPath: string, days?: number): ToolUsageStats[];
+export declare function getToolsetUsageStats(db: Database.Database, projectPath: string, days?: number): ToolsetUsageStats[];
+export declare function getProjectUsageSummary(db: Database.Database, projectPath: string, days?: number): ProjectUsageSummary | null;
+export declare function getUsageTrend(db: Database.Database, projectPath: string, days?: number): UsageTrend[];
+export declare function getUnusedTools(db: Database.Database, projectPath: string, availableTools: string[], days?: number): string[];
+export declare function getFrequentlyFailingTools(db: Database.Database, projectPath: string, days?: number, minFailures?: number): Array<{
+    toolName: string;
+    failureCount: number;
+    lastError: string | null;
+}>;
+export declare function getAllProjects(db: Database.Database): Array<{
+    projectPath: string;
+    lastSeen: number;
+}>;
+export declare function exportUsageStats(db: Database.Database, projectPath: string, days?: number): string;
+export declare function getCachedProjectSummary(db: Database.Database, projectPath: string, days?: number): ProjectUsageSummary | null;
+export declare function formatStatsDisplay(summary: ProjectUsageSummary, projectPath: string): string;