shellwecount 1.0.0

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "shellwecount",
+  "version": "1.0.0",
+  "description": "A terminal-based command history timeline visualizer with color-coded categories, frequency ranking, and density heatmap. / 基于终端的命令历史时间线可视化工具，支持命令分类着色、使用频率排名和密度热力图。",
+  "main": "shellwecount.js",
+  "bin": {
+    "shellwecount": "shellwecount.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "terminal",
+    "cli",
+    "history",
+    "timeline",
+    "visualization",
+    "shell",
+    "count",
+    "命令历史",
+    "时间线",
+    "可视化"
+  ],
+  "author": "yangsta",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "preferGlobal": true
+}

package/shellwecount.js

@@ -0,0 +1,516 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ─── i18n ──────────────────────────────────────────────────────
+const i18n = {
+  en: {
+    title: 'Command History Timeline',
+    totalCmds: 'Total',
+    cmdsLabel: 'commands',
+    topCommands: 'Top Commands',
+    times: 'times',
+    categories: 'Categories',
+    density: 'Density Heatmap',
+    legend: 'Legend',
+    low: 'Low',
+    medium: 'Med',
+    high: 'High',
+    extreme: 'Extreme',
+    cmdList: 'Command List',
+    noRecords: 'No commands found for this time period.',
+    using: 'Using',
+    errorNoHistory: 'Error: No history file found',
+    usage: `
+Command History Timeline Visualizer
+
+Usage: shellwecount [options]
+
+Options:
+  -r, --range <range>   Time range (today|yesterday|week|month)  [default: today]
+  -f, --format <format> Display format:
+                        both     - All views (default)
+                        top      - Top commands ranking
+                        stats    - Ranking + Category breakdown
+                        density  - Density heatmap
+                        list     - Command list
+  -t, --top <count>     Show top N commands  [default: 10]
+  -l, --lang <lang>     Language (en|zh)  [default: auto-detect]
+  -h, --help            Show help
+
+Examples:
+  shellwecount --range today            # Today's full view
+  shellwecount -r week -f top           # This week's top 10
+  shellwecount -r month -t 20 -f top    # This month's top 20
+  shellwecount -r week -f stats         # This week's stats + ranking
+`,
+  },
+  zh: {
+    title: '命令历史时间线',
+    totalCmds: '共',
+    cmdsLabel: '条命令',
+    topCommands: '常用命令 TOP',
+    times: '次',
+    categories: '命令分类',
+    density: '密度热力图',
+    legend: '图例',
+    low: '低',
+    medium: '中',
+    high: '高',
+    extreme: '极高',
+    cmdList: '命令列表',
+    noRecords: '该时间段内没有命令记录',
+    using: '使用',
+    errorNoHistory: '错误: 未找到历史文件',
+    usage: `
+命令历史时间线可视化工具
+
+用法: shellwecount [选项]
+
+选项:
+  -r, --range <范围>    时间范围 (today|yesterday|week|month)  [默认: today]
+  -f, --format <格式>   显示格式:
+                        both     - 全部 (默认)
+                        top      - 常用命令排名
+                        stats    - 排名 + 分类统计
+                        density  - 密度热力图
+                        list     - 命令列表
+  -t, --top <数量>      显示排名前N的命令  [默认: 10]
+  -l, --lang <语言>     语言 (en|zh)  [默认: 自动检测]
+  -h, --help            显示帮助
+
+示例:
+  shellwecount --range today            # 今天的完整视图
+  shellwecount -r week -f top           # 本周常用命令TOP10
+  shellwecount -r month -t 20 -f top    # 本月TOP20
+  shellwecount -r week -f stats         # 本周统计+排名
+`,
+  },
+};
+
+function detectLang() {
+  const locale = process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || '';
+  return locale.includes('zh') || locale.includes('CN') ? 'zh' : 'en';
+}
+
+let lang = detectLang();
+function t(key) { return i18n[lang]?.[key] || i18n.en[key] || key; }
+
+// ─── ANSI Colors ───────────────────────────────────────────────
+const colors = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  red: '\x1b[31m',
+  white: '\x1b[37m',
+  gray: '\x1b[90m',
+};
+
+// ─── Command Category Classifier ───────────────────────────────
+const categories = [
+  { name: 'git', patterns: [/^git\s/, /^gh\s/], color: colors.magenta },
+  { name: 'npm', patterns: [/^npm\s/, /^yarn\s/, /^pnpm\s/, /^bun\s/], color: colors.red },
+  { name: 'docker', patterns: [/^docker\s/, /^docker-compose\s/, /^kubectl\s/], color: colors.blue },
+  { name: 'python', patterns: [/^python[3]?\s/, /^pip[3]?\s/, /^uv\s/], color: colors.yellow },
+  { name: 'node', patterns: [/^node\s/, /^npx\s/, /^deno\s/], color: colors.green },
+  { name: 'editor', patterns: [/^vim\s/, /^nvim\s/, /^nano\s/, /^code\s/, /^emacs\s/], color: colors.cyan },
+  { name: 'build', patterns: [/^make\s/, /^cmake\s/, /^cargo\s/, /^go\s/], color: colors.yellow },
+  { name: 'system', patterns: [/^sudo\s/, /^apt\s/, /^dnf\s/, /^pacman\s/, /^systemctl\s/, /^service\s/], color: colors.gray },
+  { name: 'network', patterns: [/^curl\s/, /^wget\s/, /^ssh\s/, /^scp\s/, /^rsync\s/], color: colors.blue },
+];
+
+function classifyCommand(cmd) {
+  for (const cat of categories) {
+    for (const pattern of cat.patterns) {
+      if (pattern.test(cmd)) return cat;
+    }
+  }
+  return { name: 'other', color: colors.white };
+}
+
+function getCommandBase(cmd) {
+  return cmd.split(/\s+/)[0] || cmd;
+}
+
+// ─── History File Detection & Parsing ─────────────────────────
+function findHistoryFile() {
+  const shell = process.env.SHELL || '';
+  const home = os.homedir();
+
+  if (shell.includes('zsh')) {
+    const zshHist = path.join(home, '.zsh_history');
+    if (fs.existsSync(zshHist)) return { path: zshHist, type: 'zsh' };
+  }
+  if (shell.includes('bash')) {
+    const bashHist = path.join(home, '.bash_history');
+    if (fs.existsSync(bashHist)) return { path: bashHist, type: 'bash' };
+  }
+
+  const zshHist = path.join(home, '.zsh_history');
+  if (fs.existsSync(zshHist)) return { path: zshHist, type: 'zsh' };
+  const bashHist = path.join(home, '.bash_history');
+  if (fs.existsSync(bashHist)) return { path: bashHist, type: 'bash' };
+
+  return null;
+}
+
+function parseZshHistory(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const lines = content.split('\n');
+  const entries = [];
+
+  for (const line of lines) {
+    if (!line.startsWith(': ')) continue;
+    const match = line.match(/^:\s+(\d+):(\d+);(.*)$/);
+    if (match) {
+      entries.push({
+        timestamp: parseInt(match[1], 10),
+        duration: parseInt(match[2], 10),
+        command: match[3].trim(),
+      });
+    }
+  }
+  return entries;
+}
+
+function parseBashHistory(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const lines = content.split('\n');
+  const entries = [];
+
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].startsWith('#')) {
+      const timestamp = parseInt(lines[i].slice(1), 10);
+      const command = lines[i + 1];
+      if (!isNaN(timestamp) && command && command.trim()) {
+        entries.push({
+          timestamp,
+          duration: 0,
+          command: command.trim(),
+        });
+        i++;
+      }
+    }
+  }
+  return entries;
+}
+
+function parseHistory() {
+  const histFile = findHistoryFile();
+  if (!histFile) {
+    console.error(`${colors.red}${t('errorNoHistory')}${colors.reset}`);
+    process.exit(1);
+  }
+  console.error(`${colors.dim}${t('using')}: ${histFile.path} (${histFile.type})${colors.reset}`);
+
+  if (histFile.type === 'zsh') return parseZshHistory(histFile.path);
+  return parseBashHistory(histFile.path);
+}
+
+// ─── Time Filtering & Binning ──────────────────────────────────
+function filterByRange(entries, range) {
+  const now = Date.now() / 1000;
+  let start;
+
+  switch (range) {
+    case 'today':
+      start = new Date();
+      start.setHours(0, 0, 0, 0);
+      start = start.getTime() / 1000;
+      break;
+    case 'yesterday':
+      start = new Date();
+      start.setDate(start.getDate() - 1);
+      start.setHours(0, 0, 0, 0);
+      start = start.getTime() / 1000;
+      break;
+    case 'week':
+      start = now - 7 * 24 * 60 * 60;
+      break;
+    case 'month':
+      start = now - 30 * 24 * 60 * 60;
+      break;
+    default:
+      start = now - 24 * 60 * 60;
+  }
+
+  return entries.filter(e => e.timestamp >= start && e.timestamp <= now);
+}
+
+function getTimeBucketSize(range) {
+  switch (range) {
+    case 'today':
+    case 'yesterday': return 15 * 60;
+    case 'week': return 2 * 60 * 60;
+    case 'month': return 6 * 60 * 60;
+    default: return 15 * 60;
+  }
+}
+
+function binByTime(entries, range) {
+  if (entries.length === 0) return { bins: [] };
+
+  const bucketSize = getTimeBucketSize(range);
+  const minTime = Math.floor(entries[0].timestamp / bucketSize) * bucketSize;
+  const maxTime = Math.ceil(entries[entries.length - 1].timestamp / bucketSize) * bucketSize;
+
+  const bins = [];
+  for (let t = minTime; t <= maxTime; t += bucketSize) {
+    const bucketEntries = entries.filter(e => e.timestamp >= t && e.timestamp < t + bucketSize);
+    bins.push({ start: t, count: bucketEntries.length });
+  }
+
+  return { bins, bucketSize };
+}
+
+// ─── Command Ranking ───────────────────────────────────────────
+function rankCommands(entries, topN = 10) {
+  const freq = new Map();
+
+  for (const entry of entries) {
+    const base = getCommandBase(entry.command);
+    const cat = classifyCommand(entry.command);
+    const key = `${cat.name}:${base}`;
+
+    if (!freq.has(key)) {
+      freq.set(key, { command: base, category: cat, count: 0 });
+    }
+    freq.get(key).count++;
+  }
+
+  return Array.from(freq.values())
+    .sort((a, b) => b.count - a.count)
+    .slice(0, topN);
+}
+
+// ─── Rendering ─────────────────────────────────────────────────
+function formatTime(timestamp) {
+  const d = new Date(timestamp * 1000);
+  return `${d.getHours().toString().padStart(2, '0')}:${d.getMinutes().toString().padStart(2, '0')}`;
+}
+
+function formatDate(timestamp) {
+  const d = new Date(timestamp * 1000);
+  return `${d.getFullYear()}-${(d.getMonth() + 1).toString().padStart(2, '0')}-${d.getDate().toString().padStart(2, '0')}`;
+}
+
+function renderTopCommands(entries, topN = 10) {
+  const ranked = rankCommands(entries, topN);
+  if (ranked.length === 0) return [];
+
+  const maxCount = ranked[0].count;
+  const barMaxWidth = 30;
+
+  const lines = [];
+  lines.push(`${colors.bold}${colors.cyan}▎${t('topCommands')} ${topN}${colors.reset}`);
+
+  for (let i = 0; i < ranked.length; i++) {
+    const { command, category, count } = ranked[i];
+    const rank = (i + 1).toString().padStart(2);
+    const barWidth = Math.max(1, Math.round((count / maxCount) * barMaxWidth));
+    const bar = `${category.color}${'█'.repeat(barWidth)}${colors.reset}`;
+    const num = i < 3 ? `${colors.bold}${colors.yellow}${rank}${colors.reset}` : `${colors.dim}${rank}${colors.reset}`;
+    lines.push(`  ${num} ${category.color}${command.padEnd(20)}${colors.reset} ${bar} ${colors.green}${count}${colors.reset} ${t('times')}`);
+  }
+
+  return lines;
+}
+
+function renderCategoryBreakdown(entries) {
+  const catFreq = new Map();
+  for (const entry of entries) {
+    const cat = classifyCommand(entry.command);
+    catFreq.set(cat.name, (catFreq.get(cat.name) || 0) + 1);
+  }
+
+  const sorted = Array.from(catFreq.entries()).sort((a, b) => b[1] - a[1]);
+  const total = entries.length;
+  const barMax = 25;
+
+  const lines = [];
+  lines.push(`${colors.bold}${colors.cyan}▎${t('categories')}${colors.reset}`);
+
+  for (const [name, count] of sorted) {
+    const cat = categories.find(c => c.name === name) || { color: colors.white };
+    const pct = ((count / total) * 100).toFixed(1);
+    const barLen = Math.round((count / total) * barMax);
+    const bar = `${cat.color}${'█'.repeat(Math.max(1, barLen))}${colors.reset}`;
+    lines.push(`  ${cat.color}${name.padEnd(10)}${colors.reset} ${bar} ${colors.green}${count}${colors.reset} (${pct}%)`);
+  }
+
+  return lines;
+}
+
+function renderDensity(bins) {
+  const maxCount = Math.max(...bins.map(b => b.count), 1);
+
+  function densityColor(level) {
+    if (level === 0) return colors.dim;
+    if (level < 0.25) return colors.green;
+    if (level < 0.5) return colors.yellow;
+    if (level < 0.75) return colors.red;
+    return colors.magenta;
+  }
+
+  const terminalWidth = process.stdout.columns || 100;
+  const barWidth = Math.max(20, terminalWidth - 6);
+  const binsPerCol = Math.max(1, Math.ceil(bins.length / barWidth));
+  const columns = [];
+
+  for (let i = 0; i < bins.length; i += binsPerCol) {
+    const group = bins.slice(i, i + binsPerCol);
+    const total = group.reduce((sum, b) => sum + b.count, 0);
+    columns.push({ start: group[0]?.start, total });
+  }
+
+  let bar = '  ';
+  for (const col of columns) {
+    const level = col.total / maxCount;
+    bar += `${densityColor(level)}█${colors.reset}`;
+  }
+
+  const lines = [];
+  lines.push(`${colors.bold}${colors.cyan}▎${t('density')}${colors.reset}`);
+  lines.push(bar);
+
+  const timeMarkers = [];
+  const markerInterval = Math.max(1, Math.floor(columns.length / 6));
+  for (let i = 0; i < columns.length; i += markerInterval) {
+    timeMarkers.push({ pos: i + 2, time: formatTime(columns[i].start) });
+  }
+
+  let markerLine = '  ';
+  let lastEnd = 0;
+  for (const m of timeMarkers) {
+    const spaces = m.pos - lastEnd;
+    markerLine += ' '.repeat(Math.max(0, spaces)) + colors.dim + m.time + colors.reset;
+    lastEnd = m.pos + m.time.length;
+  }
+  lines.push(markerLine);
+  lines.push(`  ${colors.dim}${t('legend')}: ${colors.green}${t('low')}${colors.reset} ${colors.yellow}${t('medium')}${colors.reset} ${colors.red}${t('high')}${colors.reset} ${colors.magenta}${t('extreme')}${colors.reset}`);
+
+  return lines;
+}
+
+function renderList(entries) {
+  const lines = [];
+  lines.push(`${colors.bold}${colors.cyan}▎${t('cmdList')}${colors.reset}`);
+
+  const terminalWidth = process.stdout.columns || 100;
+  const cmdMaxWidth = terminalWidth - 12;
+  for (const entry of entries) {
+    const cat = classifyCommand(entry.command);
+    const timeStr = formatTime(entry.timestamp);
+    const cmdStr = entry.command.length > cmdMaxWidth ? entry.command.slice(0, cmdMaxWidth - 3) + '...' : entry.command;
+    lines.push(`  ${colors.dim}${timeStr}${colors.reset}  ${cat.color}${cmdStr}${colors.reset}`);
+  }
+
+  return lines;
+}
+
+function renderTimeline(entries, range, format) {
+  const filtered = filterByRange(entries, range);
+
+  if (filtered.length === 0) {
+    console.log(`${colors.yellow}${t('noRecords')}${colors.reset}`);
+    return;
+  }
+
+  const { bins } = binByTime(filtered, range);
+  const dateStr = formatDate(filtered[0].timestamp);
+  const lastDateStr = formatDate(filtered[filtered.length - 1].timestamp);
+  const dateRange = dateStr === lastDateStr ? dateStr : `${dateStr} → ${lastDateStr}`;
+  const totalCmds = filtered.length;
+  const histInfo = findHistoryFile();
+
+  // Header
+  const lines = [];
+  lines.push('');
+  lines.push(`${colors.bold}${colors.cyan}${t('title')}${colors.reset}  ${colors.dim}${dateRange}${colors.reset}`);
+  lines.push(`${t('totalCmds')} ${colors.green}${totalCmds}${colors.reset} ${t('cmdsLabel')}  ${colors.dim}·${colors.reset}  ${colors.dim}${histInfo?.type || 'N/A'}${colors.reset}`);
+  lines.push('');
+
+  if (format === 'top' || format === 'both' || format === 'stats') {
+    lines.push(...renderTopCommands(filtered));
+    lines.push('');
+  }
+
+  if (format === 'stats' || format === 'both') {
+    lines.push(...renderCategoryBreakdown(filtered));
+    lines.push('');
+  }
+
+  if (format === 'density' || format === 'both') {
+    lines.push(...renderDensity(bins));
+    lines.push('');
+  }
+
+  if (format === 'list' || format === 'both') {
+    lines.push(...renderList(filtered));
+    lines.push('');
+  }
+
+  console.log(lines.join('\n'));
+}
+
+// ─── CLI Arguments ─────────────────────────────────────────────
+function parseArgs() {
+  const args = process.argv.slice(2);
+  let range = 'today';
+  let format = 'both';
+  let topN = 10;
+  let langArg = null;
+
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case '--range':
+      case '-r':
+        range = args[++i] || 'today';
+        break;
+      case '--format':
+      case '-f':
+        format = args[++i] || 'both';
+        break;
+      case '--top':
+      case '-t':
+        topN = parseInt(args[++i], 10) || 10;
+        break;
+      case '--lang':
+      case '-l':
+        langArg = args[++i];
+        break;
+      case '--help':
+      case '-h':
+        printHelp();
+        process.exit(0);
+    }
+  }
+
+  if (langArg) {
+    lang = langArg === 'zh' ? 'zh' : 'en';
+  }
+
+  return { range, format, topN };
+}
+
+function printHelp() {
+  console.log(t('usage'));
+}
+
+// ─── Main ──────────────────────────────────────────────────────
+function main() {
+  const { range, format, topN } = parseArgs();
+  const entries = parseHistory();
+  renderTimeline(entries, range, format);
+}
+
+main();