systemlens 1.0.0

package/src/renderer/cli.renderer.js

@@ -0,0 +1,318 @@
+// ─── CLI Renderer ────────────────────────────────────────────────
+// Beautiful terminal output for SystemLens
+import chalk from 'chalk';
+import Table from 'cli-table3';
+import { progressBar } from '../utils/helpers.js';
+
+export class CliRenderer {
+    constructor() {
+        this.width = process.stdout.columns || 80;
+    }
+
+    /**
+     * Render the full system report
+     * @param {Object} report - { analysis, explanation, suggestions, snapshot }
+     */
+    render(report) {
+        const { analysis, explanation, suggestions, snapshot, aiInsights } = report;
+
+        console.clear();
+        this._renderHeader();
+        this._renderHealthBanner(explanation.health);
+        this._renderHeadline(explanation.headline);
+        this._renderSystemSummary(analysis.cpu, analysis.memory, snapshot);
+        this._renderExplanation(explanation.explanation);
+        this._renderCauseEffect(explanation.causeAndEffect);
+        this._renderTopProcesses(analysis.rawProcesses?.topByCpu || []);
+        this._renderDevInsights(explanation.devInsights);
+        this._renderPatterns(explanation.patternNarrative);
+        this._renderAIInsights(aiInsights);
+        this._renderSuggestions(suggestions);
+        this._renderFooter(analysis.patterns);
+    }
+
+    // ─── Header ──────────────────────────────────────────────
+    _renderHeader() {
+        const title = chalk.bold.cyan(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║          🔬  S Y S T E M L E N S                         ║
+  ║          Intelligent System Explainer                     ║
+  ║          CreatedBYNJ5.0                                   ║
+  ╚═══════════════════════════════════════════════════════════╝`);
+        console.log(title);
+        console.log();
+    }
+
+    // ─── Health Banner ───────────────────────────────────────
+    _renderHealthBanner(health) {
+        const colors = {
+            excellent: chalk.bgGreen.black.bold,
+            good: chalk.bgYellow.black.bold,
+            stressed: chalk.bgHex('#FF8C00').black.bold,
+            critical: chalk.bgRed.white.bold,
+        };
+
+        const colorFn = colors[health.status] || chalk.bgGray.white.bold;
+        const banner = colorFn(` ${health.emoji}  SYSTEM STATUS: ${health.label.toUpperCase()}  `);
+        console.log(`  ${banner}`);
+        console.log(chalk.dim(`  ${health.description}`));
+        console.log();
+    }
+
+    // ─── Headline ────────────────────────────────────────────
+    _renderHeadline(headline) {
+        console.log(chalk.bold.white(`  ${headline}`));
+        console.log();
+    }
+
+    // ─── System Summary ──────────────────────────────────────
+    _renderSystemSummary(cpu, memory, snapshot) {
+        console.log(chalk.bold.underline.cyan('  📊 System Summary'));
+        console.log();
+
+        // CPU bar
+        const cpuColor = cpu.overall >= 80 ? chalk.red : cpu.overall >= 60 ? chalk.yellow : chalk.green;
+        const cpuBar = this._coloredBar(cpu.overall);
+        console.log(`  CPU    ${cpuBar}  ${cpuColor.bold(`${cpu.overall}%`)}`);
+        console.log(chalk.dim(`         User: ${cpu.details.user}%  │  System: ${cpu.details.system}%  │  Idle: ${cpu.details.idle}%`));
+
+        // Memory bar
+        const memPct = memory.usedPercent;
+        const memColor = memPct >= 80 ? chalk.red : memPct >= 60 ? chalk.yellow : chalk.green;
+        const memBar = this._coloredBar(memPct);
+        console.log(`  Memory ${memBar}  ${memColor.bold(`${memPct}%`)}`);
+        console.log(chalk.dim(`         Used: ${memory.details.formatted.used}  │  Free: ${memory.details.formatted.free}  │  Total: ${memory.details.formatted.total}`));
+
+        // Disk (if available)
+        if (snapshot?.disk?.filesystems?.length > 0) {
+            const rootFs = snapshot.disk.filesystems.find(f => f.mount === '/') || snapshot.disk.filesystems[0];
+            if (rootFs) {
+                const diskBar = this._coloredBar(rootFs.usedPercent);
+                const diskColor = rootFs.usedPercent >= 90 ? chalk.red : rootFs.usedPercent >= 75 ? chalk.yellow : chalk.green;
+                console.log(`  Disk   ${diskBar}  ${diskColor.bold(`${rootFs.usedPercent}%`)}`);
+                console.log(chalk.dim(`         Used: ${rootFs.formatted.used}  │  Free: ${rootFs.formatted.available}  │  Total: ${rootFs.formatted.size}  [${rootFs.mount}]`));
+            }
+        }
+
+        // Temperature
+        if (cpu.details.temperature) {
+            const tempColor = cpu.details.temperature > 80 ? chalk.red : cpu.details.temperature > 60 ? chalk.yellow : chalk.green;
+            console.log(`  Temp   ${tempColor.bold(`${cpu.details.temperature}°C`)}`);
+        }
+
+        console.log();
+    }
+
+    // ─── Main Explanation ────────────────────────────────────
+    _renderExplanation(explanation) {
+        if (!explanation) return;
+
+        console.log(chalk.bold.underline.cyan('  💬 What\'s Happening'));
+        console.log();
+
+        const paragraphs = explanation.split('\n\n');
+        for (const para of paragraphs) {
+            // Word-wrap each paragraph
+            const wrapped = this._wordWrap(para, this.width - 6);
+            for (const line of wrapped) {
+                console.log(chalk.white(`  ${line}`));
+            }
+            console.log();
+        }
+    }
+
+    // ─── Cause & Effect ──────────────────────────────────────
+    _renderCauseEffect(chains) {
+        if (!chains || chains.length === 0) return;
+
+        console.log(chalk.bold.underline.cyan('  🔗 Cause & Effect'));
+        console.log();
+
+        for (const chain of chains) {
+            console.log(chalk.bold(`  ${chain.emoji} Cause:       `) + chalk.white(chain.cause));
+            console.log(chalk.bold(`     Effect:      `) + chalk.yellow(chain.effect));
+            console.log(chalk.bold(`     Consequence: `) + chalk.red(chain.consequence));
+            console.log();
+        }
+    }
+
+    // ─── Top Processes Table ─────────────────────────────────
+    _renderTopProcesses(processes) {
+        if (!processes || processes.length === 0) return;
+
+        // Filter out system & background processes — only show apps the user can actually close
+        const userProcesses = processes.filter(p => {
+            const cat = p.classification?.category;
+            return cat !== 'SYSTEM' && cat !== 'BACKGROUND';
+        });
+
+        if (userProcesses.length === 0) {
+            console.log(chalk.bold.underline.cyan('  🔍 Apps Using Resources'));
+            console.log();
+            console.log(chalk.green('  All resource usage is from system processes — nothing for you to close.'));
+            console.log();
+            return;
+        }
+
+        console.log(chalk.bold.underline.cyan('  🔍 Apps Using Resources'));
+        console.log(chalk.dim('  (System processes hidden — only showing apps you can close)'));
+        console.log();
+
+        const table = new Table({
+            head: [
+                chalk.cyan('PID'),
+                chalk.cyan('Name'),
+                chalk.cyan('Category'),
+                chalk.cyan('CPU %'),
+                chalk.cyan('Memory %'),
+                chalk.cyan('Memory'),
+            ],
+            style: { head: [], border: ['dim'] },
+            colWidths: [8, 20, 16, 8, 10, 10],
+            chars: {
+                'top': '─', 'top-mid': '┬', 'top-left': '  ┌', 'top-right': '┐',
+                'bottom': '─', 'bottom-mid': '┴', 'bottom-left': '  └', 'bottom-right': '┘',
+                'left': '  │', 'left-mid': '  ├', 'mid': '─', 'mid-mid': '┼',
+                'right': '│', 'right-mid': '┤', 'middle': '│'
+            },
+        });
+
+        for (const proc of userProcesses.slice(0, 8)) {
+            const cpuColor = proc.cpu >= 30 ? chalk.red : proc.cpu >= 15 ? chalk.yellow : chalk.white;
+            const memColor = proc.mem >= 20 ? chalk.red : proc.mem >= 10 ? chalk.yellow : chalk.white;
+
+            table.push([
+                chalk.dim(proc.pid.toString()),
+                chalk.bold.white(proc.name.substring(0, 18)),
+                (proc.classification?.label || '❓ Other').substring(0, 14),
+                cpuColor(proc.cpu.toString()),
+                memColor(proc.mem.toString()),
+                chalk.dim(proc.memRssFormatted || ''),
+            ]);
+        }
+
+        console.log(table.toString());
+        console.log();
+    }
+
+    // ─── Dev Insights ────────────────────────────────────────
+    _renderDevInsights(devInsights) {
+        if (!devInsights || devInsights.length === 0) return;
+
+        console.log(chalk.bold.underline.magenta('  🛠️ Developer Insights'));
+        console.log();
+
+        for (const insight of devInsights) {
+            const prefix = insight.actionable ? chalk.yellow('!') : chalk.green('✓');
+            console.log(`  ${insight.emoji} ${prefix} ${chalk.white(insight.insight)}`);
+        }
+        console.log();
+    }
+
+    // ─── Pattern Narratives ──────────────────────────────────
+    _renderPatterns(patterns) {
+        if (!patterns || patterns.length === 0) return;
+
+        console.log(chalk.bold.underline.cyan('  📈 Trends & Patterns'));
+        console.log();
+
+        for (const narrative of patterns) {
+            console.log(chalk.white(`  ${narrative}`));
+        }
+        console.log();
+    }
+
+    // ─── AI Insights ─────────────────────────────────────────
+    _renderAIInsights(aiInsights) {
+        if (!aiInsights) return;
+
+        console.log(chalk.bold.underline.hex('#8B5CF6')('  🤖 AI Deep Insights'));
+        console.log();
+
+        if (aiInsights.deepInsight) {
+            console.log(chalk.hex('#A78BFA')(`  💡 ${aiInsights.deepInsight}`));
+        }
+        if (aiInsights.prediction) {
+            console.log(chalk.hex('#818CF8')(`  🔮 ${aiInsights.prediction}`));
+        }
+        if (aiInsights.proTip) {
+            console.log(chalk.hex('#6366F1')(`  ⚡ ${aiInsights.proTip}`));
+        }
+        console.log();
+    }
+
+    // ─── Suggestions ─────────────────────────────────────────
+    _renderSuggestions(suggestions) {
+        if (!suggestions || suggestions.length === 0) {
+            console.log(chalk.bold.underline.green('  ✅ Suggested Actions'));
+            console.log();
+            console.log(chalk.green('  No action needed — system is running well!'));
+            console.log();
+            return;
+        }
+
+        console.log(chalk.bold.underline.green('  ✅ Suggested Actions'));
+        console.log();
+
+        for (let i = 0; i < suggestions.length; i++) {
+            const s = suggestions[i];
+            const impactColors = {
+                critical: chalk.red.bold,
+                high: chalk.yellow.bold,
+                medium: chalk.cyan,
+                low: chalk.dim,
+            };
+            const impactFn = impactColors[s.impact] || chalk.white;
+
+            console.log(`  ${s.emoji} ${chalk.bold.white(`${i + 1}. ${s.action}`)}`);
+            console.log(chalk.dim(`     ${s.reason}`));
+            console.log(`     Impact: ${impactFn(s.impact.toUpperCase())}  │  Category: ${chalk.cyan(s.category)}`);
+            console.log();
+        }
+    }
+
+    // ─── Footer ──────────────────────────────────────────────
+    _renderFooter(patterns) {
+        const time = new Date().toLocaleTimeString();
+        const dataPoints = patterns?.cpu?.recentAvg !== undefined
+            ? chalk.dim(` │ Avg CPU: ${patterns.cpu.recentAvg}% │ Trend: ${patterns.cpu.trend}`)
+            : '';
+
+        console.log(chalk.dim(`  ─────────────────────────────────────────────────────────────`));
+        console.log(chalk.dim(`  🕐 Last updated: ${time}${dataPoints}`));
+        console.log(chalk.dim(`  Press Ctrl+C to exit  │  Refreshes every 3 seconds  │  CreatedBYNJ5.0`));
+        console.log();
+    }
+
+    // ─── Helpers ─────────────────────────────────────────────
+    _coloredBar(value, width = 25) {
+        const filled = Math.round((value / 100) * width);
+        const empty = width - filled;
+
+        let barColor;
+        if (value >= 80) barColor = chalk.red;
+        else if (value >= 60) barColor = chalk.yellow;
+        else if (value >= 40) barColor = chalk.cyan;
+        else barColor = chalk.green;
+
+        return barColor('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
+    }
+
+    _wordWrap(text, maxWidth) {
+        const words = text.split(' ');
+        const lines = [];
+        let currentLine = '';
+
+        for (const word of words) {
+            if ((currentLine + ' ' + word).trim().length > maxWidth) {
+                lines.push(currentLine.trim());
+                currentLine = word;
+            } else {
+                currentLine += ' ' + word;
+            }
+        }
+        if (currentLine.trim()) lines.push(currentLine.trim());
+
+        return lines;
+    }
+}

package/src/utils/constants.js

@@ -0,0 +1,80 @@
+// ─── SystemLens Constants ────────────────────────────────────────
+// Thresholds, categories, and configuration for the analysis engine
+
+export const THRESHOLDS = {
+  CPU_HIGH: 80,
+  CPU_WARNING: 60,
+  CPU_MODERATE: 40,
+  MEMORY_HIGH: 80,
+  MEMORY_WARNING: 60,
+  MEMORY_MODERATE: 40,
+  DISK_HIGH: 90,
+  DISK_WARNING: 75,
+  PROCESS_CPU_HIGH: 30,
+  PROCESS_CPU_WARNING: 15,
+  PROCESS_MEM_HIGH: 20,
+  PROCESS_MEM_WARNING: 10,
+  SPIKE_THRESHOLD: 20,       // % jump considered a spike
+  SUSTAINED_DURATION: 60000, // ms — 60s of high usage = sustained
+};
+
+export const PROCESS_CATEGORIES = {
+  BROWSER: {
+    label: '🌐 Browser',
+    patterns: ['chrome', 'chromium', 'firefox', 'brave', 'safari', 'edge', 'opera', 'vivaldi'],
+    color: '#4285F4',
+  },
+  DEV_TOOLS: {
+    label: '🛠️ Development',
+    patterns: ['node', 'npm', 'npx', 'yarn', 'pnpm', 'code', 'electron', 'webpack', 'vite', 'tsc', 'tsx', 'esbuild', 'turbo', 'jest', 'vitest', 'cargo', 'rustc', 'go', 'python', 'python3', 'pip', 'java', 'javac', 'gradle', 'maven', 'docker', 'git'],
+    color: '#F7DF1E',
+  },
+  EDITORS: {
+    label: '📝 Editors/IDE',
+    patterns: ['code', 'cursor', 'windsurf', 'sublime', 'atom', 'vim', 'nvim', 'emacs', 'idea', 'webstorm', 'pycharm', 'android-studio'],
+    color: '#007ACC',
+  },
+  MEDIA: {
+    label: '🎵 Media',
+    patterns: ['spotify', 'vlc', 'mpv', 'ffmpeg', 'obs', 'audacity', 'gimp', 'blender', 'kdenlive'],
+    color: '#1DB954',
+  },
+  COMMUNICATION: {
+    label: '💬 Communication',
+    patterns: ['slack', 'discord', 'teams', 'zoom', 'telegram', 'signal', 'skype', 'thunderbird'],
+    color: '#7289DA',
+  },
+  SYSTEM: {
+    label: '⚙️ System',
+    patterns: ['systemd', 'init', 'kworker', 'ksoftirqd', 'kswapd', 'irq', 'migration', 'watchdog', 'dbus', 'polkit', 'NetworkManager', 'snapd', 'thermald', 'upowerd', 'udisks', 'accounts-daemon', 'gdm', 'lightdm', 'sddm', 'Xorg', 'Xwayland', 'gnome-shell', 'plasmashell', 'pipewire', 'pulseaudio', 'wireplumber', 'krunner', 'kactivitymanagerd', 'kwin_wayland', 'kwin_x11', 'kwin', 'kglobalaccel', 'kded', 'ksmserver', 'kscreen', 'ksystemstats', 'powerdevil', 'polkit-kde', 'xdg-desktop-portal', 'xdg-document-portal', 'xdg-permission-store', 'gsd-', 'gnome-keyring', 'at-spi', 'ibus', 'fcitx', 'gvfs', 'nautilus', 'dolphin', 'evolution-', 'goa-', 'mutter', 'marco', 'xfwm', 'xfce4-', 'cinnamon', 'budgie', 'exe'],
+    color: '#6C757D',
+  },
+  BACKGROUND: {
+    label: '🔄 Background',
+    patterns: ['cron', 'atd', 'rsyslog', 'journald', 'cupsd', 'avahi', 'colord', 'packagekitd', 'fwupd', 'tracker', 'baloo', 'zeitgeist', 'gvfsd', 'dconf', 'at-spi-bus', 'xdg-', 'evolution-data', 'gnome-calendar', 'update-notifier', 'unattended-upgrade', 'packagekit'],
+    color: '#ADB5BD',
+  },
+  UNKNOWN: {
+    label: '❓ Other',
+    patterns: [],
+    color: '#CED4DA',
+  },
+};
+
+export const SEVERITY = {
+  CRITICAL: { label: 'CRITICAL', emoji: '🔴', color: 'red' },
+  WARNING: { label: 'WARNING', emoji: '🟡', color: 'yellow' },
+  INFO: { label: 'INFO', emoji: '🟢', color: 'green' },
+  OK: { label: 'OK', emoji: '✅', color: 'green' },
+};
+
+export const MONITORING_INTERVAL = 3000; // ms between data collection cycles
+export const HISTORY_MAX_ENTRIES = 200;   // max snapshots in history
+export const TOP_PROCESSES_COUNT = 10;    // number of top processes to analyze
+
+export const HEALTH_LABELS = {
+  EXCELLENT: { emoji: '🟢', label: 'Excellent', description: 'System is running smoothly' },
+  GOOD: { emoji: '🟡', label: 'Good', description: 'Minor load detected' },
+  STRESSED: { emoji: '🟠', label: 'Stressed', description: 'System under notable pressure' },
+  CRITICAL: { emoji: '🔴', label: 'Critical', description: 'System is struggling — action needed' },
+};

package/src/utils/helpers.js

@@ -0,0 +1,110 @@
+// ─── SystemLens Helpers ──────────────────────────────────────────
+
+/**
+ * Format bytes into human-readable string
+ */
+export function formatBytes(bytes, decimals = 1) {
+    if (bytes === 0) return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(decimals))} ${sizes[i]}`;
+}
+
+/**
+ * Format uptime seconds into human-readable duration
+ */
+export function formatUptime(seconds) {
+    const days = Math.floor(seconds / 86400);
+    const hours = Math.floor((seconds % 86400) / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+
+    const parts = [];
+    if (days > 0) parts.push(`${days}d`);
+    if (hours > 0) parts.push(`${hours}h`);
+    if (minutes > 0) parts.push(`${minutes}m`);
+
+    return parts.length > 0 ? parts.join(' ') : '< 1m';
+}
+
+/**
+ * Format percentage with color  coding level
+ */
+export function classifyPercentage(value) {
+    if (value >= 80) return 'critical';
+    if (value >= 60) return 'warning';
+    if (value >= 40) return 'moderate';
+    return 'normal';
+}
+
+/**
+ * Calculate percentage
+ */
+export function percentage(part, total) {
+    if (total === 0) return 0;
+    return parseFloat(((part / total) * 100).toFixed(1));
+}
+
+/**
+ * Truncate string to max length with ellipsis
+ */
+export function truncate(str, maxLength = 30) {
+    if (!str) return '';
+    return str.length > maxLength ? str.substring(0, maxLength - 1) + '…' : str;
+}
+
+/**
+ * Get current timestamp in ISO format
+ */
+export function timestamp() {
+    return new Date().toISOString();
+}
+
+/**
+ * Sleep for ms milliseconds
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * Generate a progress bar string
+ */
+export function progressBar(value, maxValue = 100, width = 20) {
+    const ratio = Math.min(value / maxValue, 1);
+    const filled = Math.round(ratio * width);
+    const empty = width - filled;
+
+    let bar;
+    if (ratio >= 0.8) {
+        bar = '█'.repeat(filled) + '░'.repeat(empty);
+    } else if (ratio >= 0.6) {
+        bar = '█'.repeat(filled) + '░'.repeat(empty);
+    } else {
+        bar = '█'.repeat(filled) + '░'.repeat(empty);
+    }
+
+    return bar;
+}
+
+/**
+ * Round to n decimal places
+ */
+export function round(value, decimals = 1) {
+    return Number(Math.round(value + 'e' + decimals) + 'e-' + decimals);
+}
+
+/**
+ * Deep clone an object (simple, non-circular)
+ */
+export function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+
+/**
+ * Calculate average of an array
+ */
+export function average(arr) {
+    if (!arr || arr.length === 0) return 0;
+    return arr.reduce((sum, val) => sum + val, 0) / arr.length;
+}