@skillsmith/mcp-server 0.4.6 → 0.4.8

package/dist/src/tools/analytics.js

@@ -0,0 +1,321 @@
+/**
+ * @fileoverview Analytics MCP tools — team and enterprise usage dashboards
+ * @module @skillsmith/mcp-server/tools/analytics
+ * @see SMI-3899: Team Usage Analytics MCP Tools (Wave 2b)
+ *
+ * Split-tier analytics:
+ * - Team tier: team_analytics_dashboard, team_usage_report (usage_analytics flag)
+ * - Enterprise tier: analytics_dashboard, usage_report (advanced_analytics flag)
+ *
+ * Uses real SQLite queries against audit_logs when db is available,
+ * falls back to stub mock data when no database is present.
+ */
+import { z } from 'zod';
+import { periodDays, stubTeamAnalyticsDashboard, stubTeamUsageReport, stubAnalyticsDashboard, stubUsageReport, } from './analytics.stub.js';
+import { createRealAnalyticsService } from './analytics.service.js';
+// Re-export stub helpers for external consumers
+export { periodDays, generateDailyTrend } from './analytics.stub.js';
+/**
+ * Resolve analytics service: real (SQLite-backed) when db is available,
+ * otherwise null (handlers fall back to inline stub data).
+ */
+function resolveAnalyticsService(context) {
+    try {
+        if (context.db && context.db.open) {
+            return createRealAnalyticsService(context.db);
+        }
+    }
+    catch {
+        // Fall through to stub
+    }
+    return null;
+}
+// ============================================================================
+// Shared types
+// ============================================================================
+const periodSchema = z.enum(['7d', '30d', '90d']).optional().default('30d');
+const formatSchema = z.enum(['summary', 'detailed']).optional().default('summary');
+const enterpriseFormatSchema = z.enum(['summary', 'detailed', 'csv']).optional().default('summary');
+// ============================================================================
+// Input schemas
+// ============================================================================
+export const teamAnalyticsDashboardInputSchema = z.object({
+    period: periodSchema.describe('Time period for analytics (default 30d)'),
+});
+export const teamUsageReportInputSchema = z.object({
+    period: periodSchema.describe('Time period for report (default 30d)'),
+    format: formatSchema.describe('Report format: summary or detailed (default summary)'),
+});
+export const analyticsDashboardInputSchema = z.object({
+    period: periodSchema.describe('Time period for analytics (default 30d)'),
+    includeRecommendations: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include recommendation accuracy metrics'),
+});
+export const usageReportInputSchema = z.object({
+    period: periodSchema.describe('Time period for report (default 30d)'),
+    format: enterpriseFormatSchema.describe('Report format: summary, detailed, or csv (default summary)'),
+});
+// ============================================================================
+// Tool schemas for MCP registration
+// ============================================================================
+export const teamAnalyticsDashboardToolSchema = {
+    name: 'team_analytics_dashboard',
+    description: 'View team usage analytics: per-user tool usage counts, top tools, and daily trend. ' +
+        'Requires Team tier (usage_analytics feature).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            period: {
+                type: 'string',
+                enum: ['7d', '30d', '90d'],
+                description: 'Time period (default 30d)',
+            },
+        },
+    },
+};
+export const teamUsageReportToolSchema = {
+    name: 'team_usage_report',
+    description: 'Generate a weekly/monthly usage summary with period-over-period comparison. ' +
+        'Requires Team tier (usage_analytics feature).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            period: {
+                type: 'string',
+                enum: ['7d', '30d', '90d'],
+                description: 'Time period (default 30d)',
+            },
+            format: {
+                type: 'string',
+                enum: ['summary', 'detailed'],
+                description: 'Report format (default summary)',
+            },
+        },
+    },
+};
+export const analyticsDashboardToolSchema = {
+    name: 'analytics_dashboard',
+    description: 'Enterprise analytics dashboard: recommendation accuracy, skill adoption curves, ' +
+        'team-wide aggregation. Requires Enterprise tier (advanced_analytics feature).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            period: {
+                type: 'string',
+                enum: ['7d', '30d', '90d'],
+                description: 'Time period (default 30d)',
+            },
+            includeRecommendations: {
+                type: 'boolean',
+                description: 'Include recommendation accuracy metrics (default false)',
+            },
+        },
+    },
+};
+export const usageReportToolSchema = {
+    name: 'usage_report',
+    description: 'Comprehensive enterprise usage report with all metrics. ' +
+        'Requires Enterprise tier (advanced_analytics feature).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            period: {
+                type: 'string',
+                enum: ['7d', '30d', '90d'],
+                description: 'Time period (default 30d)',
+            },
+            format: {
+                type: 'string',
+                enum: ['summary', 'detailed', 'csv'],
+                description: 'Report format (default summary)',
+            },
+        },
+    },
+};
+// ============================================================================
+// Handlers
+// ============================================================================
+/**
+ * Team analytics dashboard handler.
+ * Returns per-user tool usage, top tools, and daily trend as markdown.
+ *
+ * Uses real service when db is available, falls back to stub
+ */
+export async function executeTeamAnalyticsDashboard(input, context) {
+    const days = periodDays(input.period);
+    const svc = resolveAnalyticsService(context);
+    if (svc) {
+        const data = svc.getDashboardData(days);
+        const total = data.totalToolCalls;
+        const avgPerDay = days > 0 ? (total / days).toFixed(1) : '0.0';
+        const lines = [
+            `# Team Analytics Dashboard (${input.period})`,
+            '',
+            '## Summary',
+            `- **Period**: Last ${days} days`,
+            `- **Total tool calls**: ${total}`,
+            `- **Unique tools**: ${data.uniqueTools}`,
+            `- **Avg calls/day**: ${avgPerDay}`,
+            `- **Data source**: live`,
+            '',
+            '## Top Tools',
+            '| Tool | Calls | % of Total |',
+            '|------|-------|------------|',
+            ...data.topTools.map((t) => {
+                const pct = total > 0 ? Math.round((t.count / total) * 100) : 0;
+                return `| ${t.tool} | ${t.count} | ${pct}% |`;
+            }),
+            '',
+            '## Period Comparison',
+            `- **Current**: ${data.periodComparison.current}`,
+            `- **Previous**: ${data.periodComparison.previous}`,
+            `- **Change**: ${data.periodComparison.changePercent >= 0 ? '+' : ''}${data.periodComparison.changePercent}%`,
+            '',
+            '## Daily Trend (last 7 days)',
+            '| Date | Calls |',
+            '|------|-------|',
+            ...data.dailyTrend.slice(-7).map((d) => `| ${d.date} | ${d.count} |`),
+        ];
+        return lines.join('\n');
+    }
+    return stubTeamAnalyticsDashboard(input.period);
+}
+/**
+ * Team usage report handler.
+ * Returns weekly/monthly summary with period comparison as markdown.
+ *
+ * Uses real service when db is available, falls back to stub
+ */
+export async function executeTeamUsageReport(input, context) {
+    const days = periodDays(input.period);
+    const svc = resolveAnalyticsService(context);
+    if (svc) {
+        const data = svc.getUsageReport(days, input.format === 'detailed');
+        const { current, previous, changePercent } = data.periodComparison;
+        const sign = changePercent >= 0 ? '+' : '';
+        const lines = [
+            `# Team Usage Report (${input.period})`,
+            '',
+            '## Period Summary',
+            `- **Current period**: ${current} total calls`,
+            `- **Previous period**: ${previous} total calls`,
+            `- **Change**: ${sign}${changePercent}%`,
+            `- **Unique tools**: ${data.uniqueTools}`,
+            `- **Data source**: live`,
+            '',
+            '## Top Tools',
+            '| Tool | Calls |',
+            '|------|-------|',
+            ...data.topTools.map((t) => `| ${t.tool} | ${t.count} |`),
+        ];
+        if (input.format === 'detailed' && data.byActor) {
+            lines.push('', '## Detailed Breakdown by User', '| User | Calls |', '|------|-------|', ...data.byActor.map((a) => `| ${a.actor} | ${a.count} |`));
+        }
+        return lines.join('\n');
+    }
+    return stubTeamUsageReport(input.period, input.format);
+}
+/**
+ * Enterprise analytics dashboard handler.
+ * Returns recommendation accuracy, adoption curves, and team aggregation as markdown.
+ *
+ * Uses real service when db is available, falls back to stub
+ */
+export async function executeAnalyticsDashboard(input, context) {
+    const days = periodDays(input.period);
+    const svc = resolveAnalyticsService(context);
+    if (svc) {
+        const data = svc.getDashboardData(days);
+        const total = data.totalToolCalls;
+        const lines = [
+            `# Enterprise Analytics Dashboard (${input.period})`,
+            '',
+            '## Organization Summary',
+            `- **Period**: Last ${days} days`,
+            `- **Total tool calls**: ${total}`,
+            `- **Unique tools**: ${data.uniqueTools}`,
+            `- **Data source**: live`,
+            '',
+            '## Top Tools',
+            '| Tool | Calls | % of Total |',
+            '|------|-------|------------|',
+            ...data.topTools.map((t) => {
+                const pct = total > 0 ? Math.round((t.count / total) * 100) : 0;
+                return `| ${t.tool} | ${t.count} | ${pct}% |`;
+            }),
+            '',
+            '## Period Comparison',
+            `- **Current**: ${data.periodComparison.current}`,
+            `- **Previous**: ${data.periodComparison.previous}`,
+            `- **Change**: ${data.periodComparison.changePercent >= 0 ? '+' : ''}${data.periodComparison.changePercent}%`,
+            '',
+            '## Daily Trend (last 7 days)',
+            '| Date | Calls |',
+            '|------|-------|',
+            ...data.dailyTrend.slice(-7).map((d) => `| ${d.date} | ${d.count} |`),
+        ];
+        if (input.includeRecommendations) {
+            lines.push('', '## Recommendation Accuracy', '_Recommendation tracking requires server-side data. ' +
+                'Use audit_export for full recommendation metrics._');
+        }
+        return lines.join('\n');
+    }
+    return stubAnalyticsDashboard(input.period, input.includeRecommendations);
+}
+/**
+ * Enterprise usage report handler.
+ * Returns comprehensive report with all metrics as markdown (or CSV).
+ *
+ * Uses real service when db is available, falls back to stub
+ */
+export async function executeUsageReport(input, context) {
+    const days = periodDays(input.period);
+    const svc = resolveAnalyticsService(context);
+    if (svc) {
+        const data = svc.getUsageReport(days, input.format === 'detailed');
+        const { current, previous, changePercent } = data.periodComparison;
+        const sign = changePercent >= 0 ? '+' : '';
+        if (input.format === 'csv') {
+            const csvLines = [
+                'metric,current_period,previous_period,change_percent',
+                `total_calls,${current},${previous},${changePercent}`,
+                `unique_tools,${data.uniqueTools},,,`,
+            ];
+            for (const t of data.topTools) {
+                csvLines.push(`tool_${t.tool},${t.count},,,`);
+            }
+            return csvLines.join('\n');
+        }
+        const lines = [
+            `# Enterprise Usage Report (${input.period})`,
+            '',
+            '## Executive Summary',
+            `- **Period**: Last ${days} days`,
+            `- **Total tool calls**: ${current} (${sign}${changePercent}% vs previous)`,
+            `- **Unique tools**: ${data.uniqueTools}`,
+            `- **Data source**: live`,
+            '',
+            '## Top Tools',
+            '| Tool | Calls | % of Total |',
+            '|------|-------|------------|',
+            ...data.topTools.map((t) => {
+                const pct = current > 0 ? Math.round((t.count / current) * 100) : 0;
+                return `| ${t.tool} | ${t.count} | ${pct}% |`;
+            }),
+            '',
+            '## Daily Trend',
+            '| Date | Calls |',
+            '|------|-------|',
+            ...data.dailyTrend.slice(-7).map((d) => `| ${d.date} | ${d.count} |`),
+        ];
+        if (input.format === 'detailed' && data.byActor) {
+            lines.push('', '## Per-User Breakdown', '| User | Calls |', '|------|-------|', ...data.byActor.map((a) => `| ${a.actor} | ${a.count} |`));
+        }
+        return lines.join('\n');
+    }
+    return stubUsageReport(input.period, input.format);
+}
+//# sourceMappingURL=analytics.js.map

package/dist/src/tools/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/tools/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EACL,UAAU,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,0BAA0B,EAAyB,MAAM,wBAAwB,CAAA;AAE1F,gDAAgD;AAChD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAEpE;;;GAGG;AACH,SAAS,uBAAuB,CAAC,OAAoB;IACnD,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC3E,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AAClF,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AAEnG,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CACzE,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACrE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,sDAAsD,CAAC;CACtF,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACxE,sBAAsB,EAAE,CAAC;SACtB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,yCAAyC,CAAC;CACvD,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACrE,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CACrC,4DAA4D,CAC7D;CACF,CAAC,CAAA;AAIF,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,IAAI,EAAE,0BAAmC;IACzC,WAAW,EACT,qFAAqF;QACrF,+CAA+C;IACjD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;gBAC1B,WAAW,EAAE,2BAA2B;aACzC;SACF;KACF;CACF,CAAA;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,mBAA4B;IAClC,WAAW,EACT,8EAA8E;QAC9E,+CAA+C;IACjD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;gBAC1B,WAAW,EAAE,2BAA2B;aACzC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;gBAC7B,WAAW,EAAE,iCAAiC;aAC/C;SACF;KACF;CACF,CAAA;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,qBAA8B;IACpC,WAAW,EACT,kFAAkF;QAClF,+EAA+E;IACjF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;gBAC1B,WAAW,EAAE,2BAA2B;aACzC;YACD,sBAAsB,EAAE;gBACtB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,yDAAyD;aACvE;SACF;KACF;CACF,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,cAAuB;IAC7B,WAAW,EACT,0DAA0D;QAC1D,wDAAwD;IAC1D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;gBAC1B,WAAW,EAAE,2BAA2B;aACzC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC;gBACpC,WAAW,EAAE,iCAAiC;aAC/C;SACF;KACF;CACF,CAAA;AAED,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAkC,EAClC,OAAoB;IAEpB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,GAAG,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAA;IAE5C,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAA;QACjC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAC9D,MAAM,KAAK,GAAG;YACZ,+BAA+B,KAAK,CAAC,MAAM,GAAG;YAC9C,EAAE;YACF,YAAY;YACZ,sBAAsB,IAAI,OAAO;YACjC,2BAA2B,KAAK,EAAE;YAClC,uBAAuB,IAAI,CAAC,WAAW,EAAE;YACzC,wBAAwB,SAAS,EAAE;YACnC,yBAAyB;YACzB,EAAE;YACF,cAAc;YACd,+BAA+B;YAC/B,+BAA+B;YAC/B,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACzB,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC/D,OAAO,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,GAAG,KAAK,CAAA;YAC/C,CAAC,CAAC;YACF,EAAE;YACF,sBAAsB;YACtB,kBAAkB,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE;YACjD,mBAAmB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE;YACnD,iBAAiB,IAAI,CAAC,gBAAgB,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,aAAa,GAAG;YAC7G,EAAE;YACF,8BAA8B;YAC9B,kBAAkB;YAClB,kBAAkB;YAClB,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;SACtE,CAAA;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,0BAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA2B,EAC3B,OAAoB;IAEpB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,GAAG,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAA;IAE5C,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAAA;QAClE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAClE,MAAM,IAAI,GAAG,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAE1C,MAAM,KAAK,GAAG;YACZ,wBAAwB,KAAK,CAAC,MAAM,GAAG;YACvC,EAAE;YACF,mBAAmB;YACnB,yBAAyB,OAAO,cAAc;YAC9C,0BAA0B,QAAQ,cAAc;YAChD,iBAAiB,IAAI,GAAG,aAAa,GAAG;YACxC,uBAAuB,IAAI,CAAC,WAAW,EAAE;YACzC,yBAAyB;YACzB,EAAE;YACF,cAAc;YACd,kBAAkB;YAClB,kBAAkB;YAClB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;SAC1D,CAAA;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,+BAA+B,EAC/B,kBAAkB,EAClB,kBAAkB,EAClB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAC1D,CAAA;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAA8B,EAC9B,OAAoB;IAEpB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,GAAG,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAA;IAE5C,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAA;QAEjC,MAAM,KAAK,GAAG;YACZ,qCAAqC,KAAK,CAAC,MAAM,GAAG;YACpD,EAAE;YACF,yBAAyB;YACzB,sBAAsB,IAAI,OAAO;YACjC,2BAA2B,KAAK,EAAE;YAClC,uBAAuB,IAAI,CAAC,WAAW,EAAE;YACzC,yBAAyB;YACzB,EAAE;YACF,cAAc;YACd,+BAA+B;YAC/B,+BAA+B;YAC/B,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACzB,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC/D,OAAO,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,GAAG,KAAK,CAAA;YAC/C,CAAC,CAAC;YACF,EAAE;YACF,sBAAsB;YACtB,kBAAkB,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE;YACjD,mBAAmB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE;YACnD,iBAAiB,IAAI,CAAC,gBAAgB,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,aAAa,GAAG;YAC7G,EAAE;YACF,8BAA8B;YAC9B,kBAAkB;YAClB,kBAAkB;YAClB,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;SACtE,CAAA;QAED,IAAI,KAAK,CAAC,sBAAsB,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,4BAA4B,EAC5B,sDAAsD;gBACpD,oDAAoD,CACvD,CAAA;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,sBAAsB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAA;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAuB,EACvB,OAAoB;IAEpB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,GAAG,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAA;IAE5C,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAAA;QAClE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAClE,MAAM,IAAI,GAAG,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAE1C,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG;gBACf,sDAAsD;gBACtD,eAAe,OAAO,IAAI,QAAQ,IAAI,aAAa,EAAE;gBACrD,gBAAgB,IAAI,CAAC,WAAW,KAAK;aACtC,CAAA;YACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAA;YAC/C,CAAC;YACD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,8BAA8B,KAAK,CAAC,MAAM,GAAG;YAC7C,EAAE;YACF,sBAAsB;YACtB,sBAAsB,IAAI,OAAO;YACjC,2BAA2B,OAAO,KAAK,IAAI,GAAG,aAAa,gBAAgB;YAC3E,uBAAuB,IAAI,CAAC,WAAW,EAAE;YACzC,yBAAyB;YACzB,EAAE;YACF,cAAc;YACd,+BAA+B;YAC/B,+BAA+B;YAC/B,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACzB,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBACnE,OAAO,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,GAAG,KAAK,CAAA;YAC/C,CAAC,CAAC;YACF,EAAE;YACF,gBAAgB;YAChB,kBAAkB;YAClB,kBAAkB;YAClB,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;SACtE,CAAA;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAC1D,CAAA;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;AACpD,CAAC"}

package/dist/src/tools/analytics.service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Real analytics service — queries audit_logs SQLite table
+ * @module @skillsmith/mcp-server/tools/analytics.service
+ * @see SMI-3916: Wave 2 — Analytics real queries
+ *
+ * Replaces stub mock data with actual SQL queries against the local
+ * audit_logs table. Falls back to the stub when no database is available.
+ */
+import type { Database } from '@skillsmith/core';
+export interface AnalyticsData {
+    totalToolCalls: number;
+    uniqueTools: number;
+    topTools: Array<{
+        tool: string;
+        count: number;
+    }>;
+    dailyTrend: Array<{
+        date: string;
+        count: number;
+    }>;
+    periodComparison: {
+        current: number;
+        previous: number;
+        changePercent: number;
+    };
+}
+export interface UsageReportData extends AnalyticsData {
+    byActor?: Array<{
+        actor: string;
+        count: number;
+    }>;
+}
+export interface AnalyticsService {
+    getDashboardData(periodDays: number): AnalyticsData;
+    getUsageReport(periodDays: number, detailed: boolean): UsageReportData;
+}
+/**
+ * Create an analytics service backed by real SQLite queries.
+ *
+ * audit_logs schema columns used:
+ * - timestamp (TEXT, ISO-8601) — event time
+ * - resource (TEXT) — tool/resource name
+ * - actor (TEXT, nullable) — user identifier
+ */
+export declare function createRealAnalyticsService(db: Database): AnalyticsService;
+//# sourceMappingURL=analytics.service.d.ts.map

package/dist/src/tools/analytics.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.service.d.ts","sourceRoot":"","sources":["../../../src/tools/analytics.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAMhD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChD,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,gBAAgB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/E;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAMD,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAA;IACnD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,eAAe,CAAA;CACvE;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,GAAG,gBAAgB,CAiFzE"}

package/dist/src/tools/analytics.service.js

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Real analytics service — queries audit_logs SQLite table
+ * @module @skillsmith/mcp-server/tools/analytics.service
+ * @see SMI-3916: Wave 2 — Analytics real queries
+ *
+ * Replaces stub mock data with actual SQL queries against the local
+ * audit_logs table. Falls back to the stub when no database is available.
+ */
+/**
+ * Create an analytics service backed by real SQLite queries.
+ *
+ * audit_logs schema columns used:
+ * - timestamp (TEXT, ISO-8601) — event time
+ * - resource (TEXT) — tool/resource name
+ * - actor (TEXT, nullable) — user identifier
+ */
+export function createRealAnalyticsService(db) {
+    return {
+        getDashboardData(periodDays) {
+            const since = new Date(Date.now() - periodDays * 86_400_000).toISOString();
+            const totalRow = db
+                .prepare('SELECT COUNT(*) as count FROM audit_logs WHERE timestamp >= ?')
+                .get(since);
+            const totalToolCalls = totalRow?.count ?? 0;
+            const uniqueRow = db
+                .prepare('SELECT COUNT(DISTINCT resource) as count FROM audit_logs WHERE timestamp >= ?')
+                .get(since);
+            const uniqueTools = uniqueRow?.count ?? 0;
+            const topTools = db
+                .prepare('SELECT resource as tool, COUNT(*) as count FROM audit_logs ' +
+                'WHERE timestamp >= ? AND resource IS NOT NULL ' +
+                'GROUP BY resource ORDER BY count DESC LIMIT 10')
+                .all(since);
+            const dailyTrend = db
+                .prepare('SELECT DATE(timestamp) as date, COUNT(*) as count FROM audit_logs ' +
+                'WHERE timestamp >= ? GROUP BY DATE(timestamp) ORDER BY date')
+                .all(since);
+            // Period comparison: current vs previous period of same length
+            const previousSince = new Date(Date.now() - periodDays * 2 * 86_400_000).toISOString();
+            const previousRow = db
+                .prepare('SELECT COUNT(*) as count FROM audit_logs WHERE timestamp >= ? AND timestamp < ?')
+                .get(previousSince, since);
+            const previous = previousRow?.count ?? 0;
+            const changePercent = previous > 0 ? Math.round(((totalToolCalls - previous) / previous) * 100) : 0;
+            return {
+                totalToolCalls,
+                uniqueTools,
+                topTools,
+                dailyTrend,
+                periodComparison: { current: totalToolCalls, previous, changePercent },
+            };
+        },
+        getUsageReport(periodDays, detailed) {
+            const data = this.getDashboardData(periodDays);
+            if (!detailed) {
+                return data;
+            }
+            // Add per-actor breakdown for detailed mode
+            const since = new Date(Date.now() - periodDays * 86_400_000).toISOString();
+            const byActor = db
+                .prepare('SELECT actor, COUNT(*) as count FROM audit_logs ' +
+                'WHERE timestamp >= ? AND actor IS NOT NULL ' +
+                'GROUP BY actor ORDER BY count DESC LIMIT 20')
+                .all(since);
+            return { ...data, byActor };
+        },
+    };
+}
+//# sourceMappingURL=analytics.service.js.map

package/dist/src/tools/analytics.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.service.js","sourceRoot":"","sources":["../../../src/tools/analytics.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6BH;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAY;IACrD,OAAO;QACL,gBAAgB,CAAC,UAAkB;YACjC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;YAE1E,MAAM,QAAQ,GAAG,EAAE;iBAChB,OAAO,CAAoB,+DAA+D,CAAC;iBAC3F,GAAG,CAAC,KAAK,CAAC,CAAA;YACb,MAAM,cAAc,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAA;YAE3C,MAAM,SAAS,GAAG,EAAE;iBACjB,OAAO,CAEL,+EAA+E,CAAC;iBAClF,GAAG,CAAC,KAAK,CAAC,CAAA;YACb,MAAM,WAAW,GAAG,SAAS,EAAE,KAAK,IAAI,CAAC,CAAA;YAEzC,MAAM,QAAQ,GAAG,EAAE;iBAChB,OAAO,CAIN,6DAA6D;gBAC3D,gDAAgD;gBAChD,gDAAgD,CACnD;iBACA,GAAG,CAAC,KAAK,CAAC,CAAA;YAEb,MAAM,UAAU,GAAG,EAAE;iBAClB,OAAO,CAIN,oEAAoE;gBAClE,6DAA6D,CAChE;iBACA,GAAG,CAAC,KAAK,CAAC,CAAA;YAEb,+DAA+D;YAC/D,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;YACtF,MAAM,WAAW,GAAG,EAAE;iBACnB,OAAO,CAEL,iFAAiF,CAAC;iBACpF,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;YAC5B,MAAM,QAAQ,GAAG,WAAW,EAAE,KAAK,IAAI,CAAC,CAAA;YACxC,MAAM,aAAa,GACjB,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAE/E,OAAO;gBACL,cAAc;gBACd,WAAW;gBACX,QAAQ;gBACR,UAAU;gBACV,gBAAgB,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE;aACvE,CAAA;QACH,CAAC;QAED,cAAc,CAAC,UAAkB,EAAE,QAAiB;YAClD,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAA;YAE9C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,IAAI,CAAA;YACb,CAAC;YAED,4CAA4C;YAC5C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;YAC1E,MAAM,OAAO,GAAG,EAAE;iBACf,OAAO,CAIN,kDAAkD;gBAChD,6CAA6C;gBAC7C,6CAA6C,CAChD;iBACA,GAAG,CAAC,KAAK,CAAC,CAAA;YAEb,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAA;QAC7B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/src/tools/analytics.service.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Tests for real analytics service (SQLite-backed)
+ * @see SMI-3916: Wave 2 — Analytics real queries
+ */
+export {};
+//# sourceMappingURL=analytics.service.test.d.ts.map

package/dist/src/tools/analytics.service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.service.test.d.ts","sourceRoot":"","sources":["../../../src/tools/analytics.service.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/tools/analytics.service.test.js

@@ -0,0 +1,151 @@
+/**
+ * @fileoverview Tests for real analytics service (SQLite-backed)
+ * @see SMI-3916: Wave 2 — Analytics real queries
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { createDatabase } from '@skillsmith/core';
+import { createRealAnalyticsService } from './analytics.service.js';
+// ============================================================================
+// Test helpers
+// ============================================================================
+function seedAuditLogs(db, rows) {
+    const stmt = db.prepare('INSERT INTO audit_logs (id, event_type, timestamp, actor, resource, action, result) ' +
+        'VALUES (?, ?, ?, ?, ?, ?, ?)');
+    for (const row of rows) {
+        stmt.run(row.id ?? crypto.randomUUID(), row.event_type ?? 'tool.call', row.timestamp ?? new Date().toISOString(), row.actor ?? null, row.resource ?? null, row.action ?? 'execute', row.result ?? 'success');
+    }
+}
+function daysAgo(n) {
+    return new Date(Date.now() - n * 86_400_000).toISOString();
+}
+// ============================================================================
+// Tests
+// ============================================================================
+describe('createRealAnalyticsService', () => {
+    let db;
+    let svc;
+    beforeEach(() => {
+        db = createDatabase(':memory:');
+        svc = createRealAnalyticsService(db);
+    });
+    afterEach(() => {
+        db.close();
+    });
+    describe('getDashboardData', () => {
+        it('returns zero counts for an empty database', () => {
+            const data = svc.getDashboardData(30);
+            expect(data.totalToolCalls).toBe(0);
+            expect(data.uniqueTools).toBe(0);
+            expect(data.topTools).toEqual([]);
+            expect(data.dailyTrend).toEqual([]);
+            expect(data.periodComparison).toEqual({
+                current: 0,
+                previous: 0,
+                changePercent: 0,
+            });
+        });
+        it('counts total tool calls within the period', () => {
+            seedAuditLogs(db, [
+                { resource: 'search', timestamp: daysAgo(5) },
+                { resource: 'search', timestamp: daysAgo(10) },
+                { resource: 'install', timestamp: daysAgo(40) }, // outside 30d
+            ]);
+            const data = svc.getDashboardData(30);
+            expect(data.totalToolCalls).toBe(2);
+        });
+        it('counts unique tools', () => {
+            seedAuditLogs(db, [
+                { resource: 'search', timestamp: daysAgo(1) },
+                { resource: 'search', timestamp: daysAgo(2) },
+                { resource: 'install', timestamp: daysAgo(3) },
+                { resource: 'validate', timestamp: daysAgo(4) },
+            ]);
+            const data = svc.getDashboardData(30);
+            expect(data.uniqueTools).toBe(3);
+        });
+        it('returns top tools ordered by count', () => {
+            seedAuditLogs(db, [
+                { resource: 'search', timestamp: daysAgo(1) },
+                { resource: 'search', timestamp: daysAgo(2) },
+                { resource: 'search', timestamp: daysAgo(3) },
+                { resource: 'install', timestamp: daysAgo(1) },
+                { resource: 'install', timestamp: daysAgo(2) },
+                { resource: 'validate', timestamp: daysAgo(1) },
+            ]);
+            const data = svc.getDashboardData(30);
+            expect(data.topTools).toHaveLength(3);
+            expect(data.topTools[0]).toEqual({ tool: 'search', count: 3 });
+            expect(data.topTools[1]).toEqual({ tool: 'install', count: 2 });
+            expect(data.topTools[2]).toEqual({ tool: 'validate', count: 1 });
+        });
+        it('limits top tools to 10', () => {
+            const resources = Array.from({ length: 15 }, (_, i) => `tool-${i}`);
+            const rows = resources.map((r) => ({ resource: r, timestamp: daysAgo(1) }));
+            seedAuditLogs(db, rows);
+            const data = svc.getDashboardData(30);
+            expect(data.topTools).toHaveLength(10);
+        });
+        it('produces daily trend grouped by date', () => {
+            seedAuditLogs(db, [
+                { resource: 'search', timestamp: daysAgo(2) },
+                { resource: 'search', timestamp: daysAgo(2) },
+                { resource: 'install', timestamp: daysAgo(1) },
+            ]);
+            const data = svc.getDashboardData(7);
+            expect(data.dailyTrend.length).toBeGreaterThanOrEqual(2);
+            // Each entry has date + count
+            for (const entry of data.dailyTrend) {
+                expect(entry.date).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+                expect(entry.count).toBeGreaterThanOrEqual(1);
+            }
+        });
+        it('computes period comparison correctly', () => {
+            // Previous period: 4 events (60-31 days ago)
+            seedAuditLogs(db, [
+                { resource: 'a', timestamp: daysAgo(35) },
+                { resource: 'a', timestamp: daysAgo(40) },
+                { resource: 'a', timestamp: daysAgo(45) },
+                { resource: 'a', timestamp: daysAgo(50) },
+            ]);
+            // Current period: 2 events (within 30 days)
+            seedAuditLogs(db, [
+                { resource: 'a', timestamp: daysAgo(5) },
+                { resource: 'a', timestamp: daysAgo(10) },
+            ]);
+            const data = svc.getDashboardData(30);
+            expect(data.periodComparison.current).toBe(2);
+            expect(data.periodComparison.previous).toBe(4);
+            expect(data.periodComparison.changePercent).toBe(-50);
+        });
+    });
+    describe('getUsageReport', () => {
+        it('returns dashboard data without byActor in non-detailed mode', () => {
+            seedAuditLogs(db, [{ resource: 'search', actor: 'alice', timestamp: daysAgo(1) }]);
+            const data = svc.getUsageReport(30, false);
+            expect(data.totalToolCalls).toBe(1);
+            expect(data.byActor).toBeUndefined();
+        });
+        it('includes byActor in detailed mode', () => {
+            seedAuditLogs(db, [
+                { resource: 'search', actor: 'alice', timestamp: daysAgo(1) },
+                { resource: 'search', actor: 'alice', timestamp: daysAgo(2) },
+                { resource: 'install', actor: 'bob', timestamp: daysAgo(1) },
+            ]);
+            const data = svc.getUsageReport(30, true);
+            expect(data.byActor).toBeDefined();
+            expect(data.byActor).toHaveLength(2);
+            expect(data.byActor[0]).toEqual({ actor: 'alice', count: 2 });
+            expect(data.byActor[1]).toEqual({ actor: 'bob', count: 1 });
+        });
+        it('excludes null actors from byActor', () => {
+            seedAuditLogs(db, [
+                { resource: 'search', actor: null, timestamp: daysAgo(1) },
+                { resource: 'search', actor: 'alice', timestamp: daysAgo(1) },
+            ]);
+            const data = svc.getUsageReport(30, true);
+            expect(data.byActor).toHaveLength(1);
+            expect(data.byActor[0].actor).toBe('alice');
+        });
+    });
+});
+//# sourceMappingURL=analytics.service.test.js.map

package/dist/src/tools/analytics.service.test.js.map

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