@iservu-inc/adf-cli 0.9.1 → 0.11.0

package/lib/learning/analytics-view.js

@@ -0,0 +1,508 @@
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const analytics = require('./analytics');
+const exporter = require('./analytics-exporter');
+
+/**
+ * Learning Analytics Dashboard - CLI View
+ *
+ * Interactive dashboard for visualizing learning system analytics with:
+ * - Overview statistics
+ * - Skip trends visualization
+ * - Category preferences heatmap
+ * - Pattern health indicators
+ * - ASCII charts and visualizations
+ * - Export functionality
+ */
+
+/**
+ * Display analytics dashboard
+ * @param {string} projectPath - Project root path
+ */
+async function showAnalyticsDashboard(projectPath) {
+  try {
+    console.log(chalk.cyan('\n' + '═'.repeat(70)));
+    console.log(chalk.cyan.bold('                 LEARNING ANALYTICS DASHBOARD'));
+    console.log(chalk.cyan('═'.repeat(70)) + '\n');
+
+    // Generate analytics data
+    const analyticsData = await analytics.generateAnalytics(projectPath);
+
+    // Show main dashboard
+    await showMainDashboard(analyticsData, projectPath);
+  } catch (error) {
+    console.error(chalk.red('\n❌ Error displaying analytics:'), error.message);
+  }
+}
+
+/**
+ * Show main dashboard view
+ * @param {Object} analyticsData - Complete analytics data
+ * @param {string} projectPath - Project root path
+ */
+async function showMainDashboard(analyticsData, projectPath) {
+  // Display overview
+  displayOverview(analyticsData.overview);
+  console.log(chalk.gray('─'.repeat(70)) + '\n');
+
+  // Display skip trends
+  displaySkipTrends(analyticsData.skipTrends);
+  console.log(chalk.gray('─'.repeat(70)) + '\n');
+
+  // Display effectiveness
+  displayEffectiveness(analyticsData.effectiveness);
+  console.log(chalk.gray('─'.repeat(70)) + '\n');
+
+  // Interactive menu
+  const { action } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'What would you like to do?',
+      choices: [
+        { name: 'View Category Breakdown', value: 'categories' },
+        { name: 'View Pattern Health', value: 'patterns' },
+        { name: 'View Session Timeline', value: 'timeline' },
+        { name: 'View Question Statistics', value: 'questions' },
+        { name: 'View Impactful Patterns', value: 'impact' },
+        new inquirer.Separator(),
+        { name: chalk.green('📦 Export Analytics (JSON/CSV)'), value: 'export' },
+        new inquirer.Separator(),
+        { name: chalk.gray('← Back to Learning System'), value: 'back' }
+      ]
+    }
+  ]);
+
+  // Handle action
+  switch (action) {
+    case 'categories':
+      await showCategoryView(analyticsData);
+      await showMainDashboard(analyticsData, projectPath);
+      break;
+    case 'patterns':
+      await showPatternHealthView(analyticsData);
+      await showMainDashboard(analyticsData, projectPath);
+      break;
+    case 'timeline':
+      await showTimelineView(analyticsData);
+      await showMainDashboard(analyticsData, projectPath);
+      break;
+    case 'questions':
+      await showQuestionStatsView(analyticsData);
+      await showMainDashboard(analyticsData, projectPath);
+      break;
+    case 'impact':
+      await showImpactfulPatternsView(analyticsData);
+      await showMainDashboard(analyticsData, projectPath);
+      break;
+    case 'export':
+      await handleExport(analyticsData, projectPath);
+      await showMainDashboard(analyticsData, projectPath);
+      break;
+    case 'back':
+      // Return to learning system menu
+      break;
+  }
+}
+
+/**
+ * Display overview statistics
+ * @param {Object} overview - Overview data
+ */
+function displayOverview(overview) {
+  console.log(chalk.bold('📊 OVERVIEW\n'));
+
+  console.log(`Total Sessions:       ${chalk.cyan(overview.totalSessions)} sessions`);
+  console.log(`Total Skips:          ${chalk.yellow(overview.totalSkips)} questions (${overview.manualSkips} manual, ${overview.filteredSkips} filtered)`);
+  console.log(`Total Answers:        ${chalk.green(overview.totalAnswers)} questions`);
+  console.log(`Active Patterns:      ${chalk.magenta(overview.activePatterns)} patterns`);
+  console.log(`Active Rules:         ${chalk.blue(overview.activeRules)} rules`);
+  console.log(`Learning System Age:  ${chalk.white(overview.learningAge)} days`);
+  if (overview.dataSizeMB > 0) {
+    console.log(`Data Size:            ${chalk.white(overview.dataSizeMB.toFixed(2))} MB`);
+  }
+}
+
+/**
+ * Display skip trends
+ * @param {Array} skipTrends - Skip trends data
+ */
+function displaySkipTrends(skipTrends) {
+  console.log(chalk.bold('📈 SKIP TRENDS (Last 12 Weeks)\n'));
+
+  // Find max for scaling
+  const maxSkips = Math.max(...skipTrends.map(t => t.totalSkips), 1);
+  const chartWidth = 20;
+
+  // Show last 4 weeks with bars
+  const recentWeeks = skipTrends.slice(-4);
+
+  for (const week of recentWeeks) {
+    const barWidth = Math.round((week.totalSkips / maxSkips) * chartWidth);
+    const bar = chalk.cyan('█'.repeat(barWidth)) + chalk.gray('░'.repeat(chartWidth - barWidth));
+    const label = `Week ${week.weekNumber}:`.padEnd(10);
+    const details = `${week.totalSkips} skips (${week.manualSkips} manual, ${week.filteredSkips} filtered)`;
+
+    console.log(`${label} ${bar} ${details}`);
+  }
+
+  // Calculate trend
+  const trend = calculateTrend(skipTrends);
+  console.log(`\nTrend: ${formatTrend(trend)}`);
+}
+
+/**
+ * Display effectiveness metrics
+ * @param {Object} effectiveness - Effectiveness data
+ */
+function displayEffectiveness(effectiveness) {
+  console.log(chalk.bold('✨ EFFECTIVENESS\n'));
+
+  console.log(`Time Saved:         ${chalk.green(effectiveness.timeSavedMinutes)} minutes (${effectiveness.timeSavedHours} hours)`);
+  console.log(`Questions Filtered: ${chalk.yellow(effectiveness.questionsFiltered)} questions`);
+  console.log(`Pattern Accuracy:   ${chalk.cyan(effectiveness.patternAccuracy + '%')} ${getAccuracyIndicator(effectiveness.patternAccuracy)}`);
+  console.log(`Rule Applications:  ${chalk.blue(effectiveness.totalRuleApplications)} total (${effectiveness.avgApplicationsPerRule} avg per rule)`);
+
+  const status = getEffectivenessStatus(effectiveness.overallEffectiveness);
+  console.log(`\nOverall Effectiveness: ${chalk.bold(effectiveness.overallEffectiveness + '%')} ${status}`);
+}
+
+/**
+ * Show category view
+ * @param {Object} analyticsData - Analytics data
+ */
+async function showCategoryView(analyticsData) {
+  console.clear();
+  console.log(chalk.cyan('\n' + '═'.repeat(70)));
+  console.log(chalk.cyan.bold('                   CATEGORY PREFERENCES'));
+  console.log(chalk.cyan('═'.repeat(70)) + '\n');
+
+  const categories = analyticsData.categoryPreferences;
+
+  if (categories.length === 0) {
+    console.log(chalk.gray('No category data available yet.'));
+  } else {
+    console.log(chalk.bold('🎯 SKIP RATE BY CATEGORY\n'));
+
+    // Find max for scaling
+    const maxRate = 100;
+    const chartWidth = 20;
+
+    for (const cat of categories) {
+      const barWidth = Math.round((cat.skipRate / maxRate) * chartWidth);
+      const bar = chalk.red('█'.repeat(barWidth)) + chalk.gray('░'.repeat(chartWidth - barWidth));
+      const label = cat.category.padEnd(20);
+      const details = `${cat.skipRate}% (${cat.skips}/${cat.total})`.padEnd(15);
+      const level = getLevelBadge(cat.level);
+
+      console.log(`${label} ${bar} ${details} ${level}`);
+    }
+  }
+
+  await pressAnyKey();
+}
+
+/**
+ * Show pattern health view
+ * @param {Object} analyticsData - Analytics data
+ */
+async function showPatternHealthView(analyticsData) {
+  console.clear();
+  console.log(chalk.cyan('\n' + '═'.repeat(70)));
+  console.log(chalk.cyan.bold('                     PATTERN HEALTH'));
+  console.log(chalk.cyan('═'.repeat(70)) + '\n');
+
+  const { patternDistribution, decayStatus } = analyticsData;
+
+  console.log(chalk.bold('🧬 PATTERN CONFIDENCE DISTRIBUTION\n'));
+
+  const chartWidth = 10;
+  const total = patternDistribution.totalPatterns;
+
+  if (total === 0) {
+    console.log(chalk.gray('No patterns detected yet.'));
+  } else {
+    displayDistributionBar('High (90%+):', patternDistribution.distribution.high, total, chartWidth, chalk.green);
+    displayDistributionBar('Medium (75-89%):', patternDistribution.distribution.medium, total, chartWidth, chalk.yellow);
+    displayDistributionBar('Low (50-74%):', patternDistribution.distribution.low, total, chartWidth, chalk.orange);
+    displayDistributionBar('Very Low (<50%):', patternDistribution.distribution.veryLow, total, chartWidth, chalk.red);
+
+    console.log(`\nAverage Confidence: ${chalk.cyan(patternDistribution.avgConfidence + '%')}`);
+    console.log(`At Risk (decay):    ${chalk.red(patternDistribution.atRiskCount)} patterns\n`);
+
+    console.log(chalk.bold('⏰ PATTERN DECAY STATUS\n'));
+
+    displayDistributionBar('Healthy (75%+, <3mo):', decayStatus.healthy, total, chartWidth, chalk.green);
+    displayDistributionBar('Warning (50-74%, 3-5mo):', decayStatus.warning, total, chartWidth, chalk.yellow);
+    displayDistributionBar('Critical (<50%, >5mo):', decayStatus.critical, total, chartWidth, chalk.red);
+
+    console.log(`\nRecently Renewed:   ${chalk.green(decayStatus.recentlyRenewed)} patterns (last 30 days)`);
+    console.log(`Average Age:        ${chalk.white(decayStatus.avgAge)} days`);
+
+    if (decayStatus.critical > 0) {
+      console.log(`\n${chalk.yellow('⚠')}  Warning: ${decayStatus.critical} patterns approaching removal threshold`);
+    }
+  }
+
+  await pressAnyKey();
+}
+
+/**
+ * Show timeline view
+ * @param {Object} analyticsData - Analytics data
+ */
+async function showTimelineView(analyticsData) {
+  console.clear();
+  console.log(chalk.cyan('\n' + '═'.repeat(70)));
+  console.log(chalk.cyan.bold('                    SESSION TIMELINE'));
+  console.log(chalk.cyan('═'.repeat(70)) + '\n');
+
+  const { sessionTimeline } = analyticsData;
+
+  console.log(chalk.bold('📅 SESSION HISTORY\n'));
+  console.log(`Total Sessions:     ${chalk.cyan(sessionTimeline.totalSessions)}`);
+  console.log(`Sessions per Week:  ${chalk.yellow(sessionTimeline.sessionsPerWeek)}`);
+  console.log(`First Session:      ${chalk.white(sessionTimeline.firstSession || 'N/A')}`);
+  console.log(`Last Session:       ${chalk.white(sessionTimeline.lastSession || 'N/A')}\n`);
+
+  if (sessionTimeline.timeline.length > 0) {
+    console.log(chalk.bold('Recent Sessions (Last 10):\n'));
+
+    const recentSessions = sessionTimeline.timeline.slice(0, 10);
+
+    for (const session of recentSessions) {
+      const date = new Date(session.timestamp).toLocaleDateString();
+      const time = new Date(session.timestamp).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+      const projectType = session.projectType || 'unknown';
+      const stats = `${session.answerCount}A / ${session.skipCount}S`;
+
+      console.log(`${chalk.gray(date + ' ' + time)} - ${chalk.cyan(projectType.padEnd(15))} ${chalk.white(stats)}`);
+    }
+  } else {
+    console.log(chalk.gray('No sessions recorded yet.'));
+  }
+
+  await pressAnyKey();
+}
+
+/**
+ * Show question stats view
+ * @param {Object} analyticsData - Analytics data
+ */
+async function showQuestionStatsView(analyticsData) {
+  console.clear();
+  console.log(chalk.cyan('\n' + '═'.repeat(70)));
+  console.log(chalk.cyan.bold('                   QUESTION STATISTICS'));
+  console.log(chalk.cyan('═'.repeat(70)) + '\n');
+
+  const { questionStats } = analyticsData;
+
+  // Most answered
+  console.log(chalk.bold('✅ MOST ANSWERED QUESTIONS (Top 5)\n'));
+  if (questionStats.mostAnswered.length > 0) {
+    questionStats.mostAnswered.slice(0, 5).forEach((q, i) => {
+      console.log(`${chalk.cyan((i + 1) + '.')} ${q.text}`);
+      console.log(`   ${chalk.gray(`Answered ${q.answers} times | Category: ${q.category || 'N/A'}`)}\n`);
+    });
+  } else {
+    console.log(chalk.gray('No data available.\n'));
+  }
+
+  // Most skipped
+  console.log(chalk.bold('⏭️  MOST SKIPPED QUESTIONS (Top 5)\n'));
+  if (questionStats.mostSkipped.length > 0) {
+    questionStats.mostSkipped.slice(0, 5).forEach((q, i) => {
+      console.log(`${chalk.yellow((i + 1) + '.')} ${q.text}`);
+      console.log(`   ${chalk.gray(`Skipped ${q.skips} times | Skip rate: ${q.skipRate}%`)}\n`);
+    });
+  } else {
+    console.log(chalk.gray('No data available.\n'));
+  }
+
+  await pressAnyKey();
+}
+
+/**
+ * Show impactful patterns view
+ * @param {Object} analyticsData - Analytics data
+ */
+async function showImpactfulPatternsView(analyticsData) {
+  console.clear();
+  console.log(chalk.cyan('\n' + '═'.repeat(70)));
+  console.log(chalk.cyan.bold('                   IMPACTFUL PATTERNS'));
+  console.log(chalk.cyan('═'.repeat(70)) + '\n');
+
+  const { impactfulPatterns } = analyticsData;
+
+  // Top by time saved
+  console.log(chalk.bold('⏱️  TOP PATTERNS BY TIME SAVED\n'));
+  if (impactfulPatterns.topByTimeSaved.length > 0) {
+    impactfulPatterns.topByTimeSaved.forEach((item, i) => {
+      console.log(`${chalk.green((i + 1) + '.')} ${item.pattern.questionText || item.pattern.questionId}`);
+      console.log(`   ${chalk.gray(`${item.timeSaved} minutes saved | ${item.appliedCount} applications | ${item.pattern.confidence}% confidence`)}\n`);
+    });
+  } else {
+    console.log(chalk.gray('No patterns with impact yet.\n'));
+  }
+
+  // Perfect confidence
+  if (impactfulPatterns.perfectConfidence.length > 0) {
+    console.log(chalk.bold(`💯 PERFECT CONFIDENCE PATTERNS (${impactfulPatterns.perfectConfidence.length})\n`));
+    impactfulPatterns.perfectConfidence.slice(0, 5).forEach((pattern, i) => {
+      console.log(`${chalk.magenta((i + 1) + '.')} ${pattern.questionText || pattern.questionId}`);
+      console.log(`   ${chalk.gray(`100% confidence | Type: ${pattern.type}`)}\n`);
+    });
+  }
+
+  await pressAnyKey();
+}
+
+/**
+ * Handle export
+ * @param {Object} analyticsData - Analytics data
+ * @param {string} projectPath - Project root path
+ */
+async function handleExport(analyticsData, projectPath) {
+  console.clear();
+  console.log(chalk.cyan('\n' + '═'.repeat(70)));
+  console.log(chalk.cyan.bold('                    EXPORT ANALYTICS'));
+  console.log(chalk.cyan('═'.repeat(70)) + '\n');
+
+  const { format } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'format',
+      message: 'Select export format:',
+      choices: [
+        { name: 'JSON (single comprehensive file)', value: 'json' },
+        { name: 'CSV (multiple files)', value: 'csv' },
+        new inquirer.Separator(),
+        { name: chalk.gray('← Cancel'), value: 'cancel' }
+      ]
+    }
+  ]);
+
+  if (format === 'cancel') return;
+
+  try {
+    const result = await exporter.exportAnalytics(analyticsData, projectPath, format);
+
+    console.log(chalk.green('\n✅ Analytics exported successfully!\n'));
+
+    if (format === 'json') {
+      console.log(`File: ${chalk.cyan(result.file)}`);
+      console.log(`Size: ${chalk.white(result.size)}`);
+    } else {
+      console.log(`Files exported: ${chalk.cyan(result.files.length)}`);
+      result.files.forEach(f => {
+        console.log(`  - ${chalk.white(f)}`);
+      });
+    }
+
+    console.log();
+  } catch (error) {
+    console.error(chalk.red('\n❌ Export failed:'), error.message);
+  }
+
+  await pressAnyKey();
+}
+
+// =============================================================================
+// Helper Functions
+// =============================================================================
+
+/**
+ * Display distribution bar
+ * @param {string} label - Label
+ * @param {number} count - Count
+ * @param {number} total - Total
+ * @param {number} chartWidth - Chart width
+ * @param {Function} colorFn - Chalk color function
+ */
+function displayDistributionBar(label, count, total, chartWidth, colorFn) {
+  const percentage = total > 0 ? Math.round((count / total) * 100) : 0;
+  const barWidth = Math.round((count / total) * chartWidth);
+  const bar = colorFn('█'.repeat(barWidth)) + chalk.gray('░'.repeat(chartWidth - barWidth));
+
+  console.log(`${label.padEnd(25)} ${bar} ${count} (${percentage}%)`);
+}
+
+/**
+ * Calculate trend from skip trends
+ * @param {Array} skipTrends - Skip trends data
+ * @returns {string} Trend direction
+ */
+function calculateTrend(skipTrends) {
+  if (skipTrends.length < 4) return 'stable';
+
+  const recent = skipTrends.slice(-4);
+  const first = recent[0].totalSkips;
+  const last = recent[recent.length - 1].totalSkips;
+
+  if (last > first * 1.2) return 'increasing';
+  if (last < first * 0.8) return 'decreasing';
+  return 'stable';
+}
+
+/**
+ * Format trend with icon and color
+ * @param {string} trend - Trend direction
+ * @returns {string} Formatted trend
+ */
+function formatTrend(trend) {
+  if (trend === 'increasing') return chalk.red('Increasing ↑');
+  if (trend === 'decreasing') return chalk.green('Decreasing ↓');
+  return chalk.yellow('Stable →');
+}
+
+/**
+ * Get accuracy indicator
+ * @param {number} accuracy - Accuracy percentage
+ * @returns {string} Indicator
+ */
+function getAccuracyIndicator(accuracy) {
+  if (accuracy >= 90) return chalk.green('(Excellent)');
+  if (accuracy >= 75) return chalk.yellow('(Good)');
+  if (accuracy >= 50) return chalk.orange('(Fair)');
+  return chalk.red('(Needs Improvement)');
+}
+
+/**
+ * Get effectiveness status
+ * @param {number} effectiveness - Effectiveness percentage
+ * @returns {string} Status
+ */
+function getEffectivenessStatus(effectiveness) {
+  if (effectiveness >= 90) return chalk.green('✓ EXCELLENT');
+  if (effectiveness >= 75) return chalk.green('✓ GOOD');
+  if (effectiveness >= 50) return chalk.yellow('○ FAIR');
+  return chalk.red('✗ NEEDS IMPROVEMENT');
+}
+
+/**
+ * Get level badge
+ * @param {string} level - Level ('high', 'medium', 'low')
+ * @returns {string} Badge
+ */
+function getLevelBadge(level) {
+  if (level === 'high') return chalk.red.bold('HIGH');
+  if (level === 'medium') return chalk.yellow.bold('MEDIUM');
+  return chalk.green.bold('LOW');
+}
+
+/**
+ * Press any key to continue
+ */
+async function pressAnyKey() {
+  await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'continue',
+      message: chalk.gray('Press Enter to continue...')
+    }
+  ]);
+}
+
+module.exports = {
+  showAnalyticsDashboard
+};