nodebench-mcp 2.15.0 → 2.18.0

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":"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"}

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;

package/dist/analytics/usageStats.js

@@ -0,0 +1,252 @@
+/**
+ * Usage Statistics Aggregation
+ *
+ * Aggregates tool usage data to generate insights and recommendations.
+ */
+import { getCachedStats, setCachedStats } from './schema.js';
+export function getToolUsageStats(db, projectPath, days = 30) {
+    const cutoff = Date.now() - (days * 24 * 60 * 60 * 1000);
+    const stmt = db.prepare(`
+    SELECT
+      tool_name as toolName,
+      toolset,
+      COUNT(*) as callCount,
+      SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END) as successCount,
+      SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) as failureCount,
+      AVG(duration) as avgDuration,
+      MAX(timestamp) as lastUsed,
+      MIN(timestamp) as firstUsed
+    FROM tool_usage
+    WHERE project_path = ? AND timestamp >= ?
+    GROUP BY tool_name, toolset
+    ORDER BY callCount DESC
+  `);
+    return stmt.all(projectPath, cutoff);
+}
+export function getToolsetUsageStats(db, projectPath, days = 30) {
+    const cutoff = Date.now() - (days * 24 * 60 * 60 * 1000);
+    const stmt = db.prepare(`
+    SELECT
+      toolset,
+      COUNT(DISTINCT tool_name) as toolCount,
+      SUM(call_count) as totalCalls,
+      COUNT(DISTINCT tool_name) as uniqueToolsUsed,
+      CAST(SUM(call_count) AS FLOAT) / COUNT(DISTINCT tool_name) as avgCallsPerTool
+    FROM (
+      SELECT tool_name, toolset, COUNT(*) as call_count
+      FROM tool_usage
+      WHERE project_path = ? AND timestamp >= ?
+      GROUP BY tool_name, toolset
+    )
+    GROUP BY toolset
+    ORDER BY totalCalls DESC
+  `);
+    return stmt.all(projectPath, cutoff);
+}
+export function getProjectUsageSummary(db, projectPath, days = 30) {
+    const cutoff = Date.now() - (days * 24 * 60 * 60 * 1000);
+    const stmt = db.prepare(`
+    SELECT
+      COUNT(*) as totalCalls,
+      COUNT(DISTINCT tool_name) as uniqueToolsUsed,
+      SUM(duration) as totalDuration,
+      AVG(duration) as avgDuration,
+      CAST(SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END) AS FLOAT) / COUNT(*) as successRate
+    FROM tool_usage
+    WHERE project_path = ? AND timestamp >= ?
+  `);
+    const summary = stmt.get(projectPath, cutoff);
+    if (!summary || summary.totalCalls === 0)
+        return null;
+    // Get most used tool
+    const mostUsedToolStmt = db.prepare(`
+    SELECT tool_name, COUNT(*) as count
+    FROM tool_usage
+    WHERE project_path = ? AND timestamp >= ?
+    GROUP BY tool_name
+    ORDER BY count DESC
+    LIMIT 1
+  `);
+    const mostUsedTool = mostUsedToolStmt.get(projectPath, cutoff);
+    // Get most used toolset
+    const mostUsedToolsetStmt = db.prepare(`
+    SELECT toolset, COUNT(*) as count
+    FROM tool_usage
+    WHERE project_path = ? AND timestamp >= ?
+    GROUP BY toolset
+    ORDER BY count DESC
+    LIMIT 1
+  `);
+    const mostUsedToolset = mostUsedToolsetStmt.get(projectPath, cutoff);
+    // Get top 5 tools
+    const topToolsStmt = 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 = topToolsStmt.all(projectPath, cutoff);
+    // Get top 5 toolsets
+    const topToolsetsStmt = db.prepare(`
+    SELECT toolset as name, COUNT(*) as count
+    FROM tool_usage
+    WHERE project_path = ? AND timestamp >= ?
+    GROUP BY toolset
+    ORDER BY count DESC
+    LIMIT 5
+  `);
+    const topToolsets = topToolsetsStmt.all(projectPath, cutoff);
+    return {
+        projectPath,
+        totalCalls: summary.totalCalls,
+        uniqueToolsUsed: summary.uniqueToolsUsed,
+        totalDuration: summary.totalDuration,
+        avgDuration: summary.avgDuration,
+        successRate: summary.successRate,
+        mostUsedTool: mostUsedTool?.tool_name || 'N/A',
+        mostUsedToolset: mostUsedToolset?.toolset || 'N/A',
+        topTools,
+        topToolsets,
+    };
+}
+export function getUsageTrend(db, projectPath, days = 30) {
+    const cutoff = Date.now() - (days * 24 * 60 * 60 * 1000);
+    const stmt = db.prepare(`
+    SELECT
+      DATE(timestamp / 1000, 'unixepoch') as date,
+      COUNT(*) as callCount,
+      COUNT(DISTINCT tool_name) as uniqueTools,
+      AVG(duration) as avgDuration
+    FROM tool_usage
+    WHERE project_path = ? AND timestamp >= ?
+    GROUP BY date
+    ORDER BY date ASC
+  `);
+    return stmt.all(projectPath, cutoff);
+}
+export function getUnusedTools(db, projectPath, availableTools, days = 30) {
+    const cutoff = Date.now() - (days * 24 * 60 * 60 * 1000);
+    const usedToolsStmt = db.prepare(`
+    SELECT DISTINCT tool_name
+    FROM tool_usage
+    WHERE project_path = ? AND timestamp >= ?
+  `);
+    const usedTools = usedToolsStmt.all(projectPath, cutoff);
+    const usedToolNames = new Set(usedTools.map(t => t.tool_name));
+    return availableTools.filter(tool => !usedToolNames.has(tool));
+}
+export function getFrequentlyFailingTools(db, projectPath, days = 30, minFailures = 3) {
+    const cutoff = Date.now() - (days * 24 * 60 * 60 * 1000);
+    const stmt = db.prepare(`
+    SELECT
+      tool_name as toolName,
+      SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) as failureCount,
+      MAX(error_message) as lastError
+    FROM tool_usage
+    WHERE project_path = ? AND timestamp >= ?
+    GROUP BY tool_name
+    HAVING failureCount >= ?
+    ORDER BY failureCount DESC
+  `);
+    return stmt.all(projectPath, cutoff, minFailures);
+}
+export function getAllProjects(db) {
+    const stmt = db.prepare(`
+    SELECT DISTINCT project_path as projectPath, MAX(timestamp) as lastSeen
+    FROM tool_usage
+    GROUP BY project_path
+    ORDER BY lastSeen DESC
+  `);
+    return stmt.all();
+}
+export function exportUsageStats(db, projectPath, days = 30) {
+    const summary = getProjectUsageSummary(db, projectPath, days);
+    const toolStats = getToolUsageStats(db, projectPath, days);
+    const toolsetStats = getToolsetUsageStats(db, projectPath, days);
+    const trend = getUsageTrend(db, projectPath, days);
+    const failingTools = getFrequentlyFailingTools(db, projectPath, days);
+    return JSON.stringify({
+        projectPath,
+        period: `${days} days`,
+        summary,
+        toolStats,
+        toolsetStats,
+        trend,
+        failingTools,
+        exportedAt: new Date().toISOString(),
+    }, null, 2);
+}
+// ── Cached wrapper ──────────────────────────────────────────────────────
+const SUMMARY_CACHE_TTL = 300; // 5 minutes in seconds
+export function getCachedProjectSummary(db, projectPath, days = 30) {
+    const cacheKey = `summary_${days}d`;
+    const cached = getCachedStats(db, projectPath, cacheKey);
+    if (cached) {
+        try {
+            return JSON.parse(cached);
+        }
+        catch { /* fall through */ }
+    }
+    const summary = getProjectUsageSummary(db, projectPath, days);
+    if (summary) {
+        setCachedStats(db, {
+            projectPath,
+            cacheKey,
+            stats: JSON.stringify(summary),
+            computedAt: Date.now(),
+            ttl: SUMMARY_CACHE_TTL,
+        });
+    }
+    return summary;
+}
+// ── Rich formatted display ──────────────────────────────────────────────
+function fmtDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${(ms / 60_000).toFixed(1)}m`;
+}
+function fmtPercent(n) {
+    return `${(n * 100).toFixed(1)}%`;
+}
+function bar(value, max, width = 20) {
+    const filled = max > 0 ? Math.round((value / max) * width) : 0;
+    return '\u2588'.repeat(filled) + '\u2591'.repeat(width - filled);
+}
+export function formatStatsDisplay(summary, projectPath) {
+    const lines = [];
+    const projectName = projectPath.split(/[\\/]/).pop() || projectPath;
+    lines.push(`\n=== Usage Analytics: ${projectName} (last 30 days) ===\n`);
+    // Overview
+    lines.push(`  Total calls:     ${summary.totalCalls.toLocaleString()}`);
+    lines.push(`  Unique tools:    ${summary.uniqueToolsUsed}`);
+    lines.push(`  Success rate:    ${fmtPercent(summary.successRate)}`);
+    lines.push(`  Avg duration:    ${fmtDuration(summary.avgDuration)}`);
+    lines.push(`  Total time:      ${fmtDuration(summary.totalDuration)}`);
+    // Top tools
+    if (summary.topTools.length > 0) {
+        lines.push(`\n--- Top Tools ---`);
+        const maxCount = summary.topTools[0].count;
+        for (const t of summary.topTools) {
+            const pct = summary.totalCalls > 0 ? (t.count / summary.totalCalls) : 0;
+            lines.push(`  ${bar(t.count, maxCount, 16)} ${t.name} (${t.count} calls, ${fmtPercent(pct)})`);
+        }
+    }
+    // Top toolsets
+    if (summary.topToolsets.length > 0) {
+        lines.push(`\n--- Top Toolsets ---`);
+        const maxCount = summary.topToolsets[0].count;
+        for (const t of summary.topToolsets) {
+            const pct = summary.totalCalls > 0 ? (t.count / summary.totalCalls) : 0;
+            lines.push(`  ${bar(t.count, maxCount, 16)} ${t.name} (${t.count} calls, ${fmtPercent(pct)})`);
+        }
+    }
+    lines.push(`\n  Most used tool:    ${summary.mostUsedTool}`);
+    lines.push(`  Most used toolset: ${summary.mostUsedToolset}`);
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=usageStats.js.map

package/dist/analytics/usageStats.js.map

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