lumencode 0.4.3

package/lib/scenario.js

@@ -0,0 +1,183 @@
+// 基于工具调用 + 用户文本关键词的使用场景分类引擎
+
+const TOOL_SCENARIO_MAP = {
+  // Claude Code
+  Write: 'coding',
+  Edit: 'coding',
+  NotebookEdit: 'coding',
+  Bash: 'execution',
+  Read: 'reading',
+  Glob: 'reading',
+  Grep: 'reading',
+  TaskCreate: 'planning',
+  TaskUpdate: 'planning',
+  TaskList: 'planning',
+  TaskGet: 'planning',
+  Agent: 'planning',
+  EnterPlanMode: 'planning',
+  ExitPlanMode: 'planning',
+  AskUserQuestion: 'interaction',
+  Skill: 'skill',
+  WebSearch: 'research',
+  WebFetch: 'research',
+  CronCreate: 'automation',
+  CronDelete: 'automation',
+  // Codex
+  shell_command: 'execution',
+  update_plan: 'planning',
+  view_image: 'reading',
+  browser_navigate: 'testing',
+  browser_run_code_unsafe: 'testing',
+  browser_console_messages: 'testing',
+  // OpenCode
+  write: 'coding',
+  edit: 'coding',
+  bash: 'execution',
+  glob: 'reading',
+  question: 'interaction',
+  todowrite: 'planning',
+  // Codex (serena MCP)
+  activate_project: 'coding',
+  initial_instructions: 'reading',
+  check_onboarding_performed: 'reading',
+  onboarding: 'reading',
+  find_symbol: 'reading',
+  find_declaration: 'reading',
+  find_referencing_symbols: 'reading',
+  find_implementations: 'reading',
+  get_symbols_overview: 'reading',
+  replace_symbol_body: 'coding',
+  replace_content: 'coding',
+  insert_before_symbol: 'coding',
+  insert_after_symbol: 'coding',
+  get_diagnostics_for_file: 'testing',
+};
+
+const MCP_TOOL_SCENARIOS = {
+  'mcp__Playwright': 'testing',
+  'mcp__context7': 'research',
+  'mcp__open-websearch': 'research',
+  'mcp__serena': 'coding',
+  'mcp__mcp-deepwiki': 'research',
+  'mcp__web_reader': 'research',
+};
+
+export function classifyRecord(record, scenarioKeywords) {
+  const scenarios = {};
+  // 兼容 UsageRecord 格式（metadata.toolCalls）和原始格式（toolCalls）
+  const toolCalls = record.metadata?.toolCalls || record.toolCalls || [];
+  const tools = toolCalls.map(t => t.name);
+
+  // 基于工具调用的分类
+  const toolScenarios = new Set();
+  for (const tool of tools) {
+    if (TOOL_SCENARIO_MAP[tool]) {
+      toolScenarios.add(TOOL_SCENARIO_MAP[tool]);
+    }
+    // MCP 工具前缀匹配
+    for (const [prefix, scenario] of Object.entries(MCP_TOOL_SCENARIOS)) {
+      if (tool.startsWith(prefix)) {
+        toolScenarios.add(scenario);
+      }
+    }
+  }
+
+  // 重新构建工具场景计数，确保每个工具都被计数
+  for (const tool of tools) {
+    if (TOOL_SCENARIO_MAP[tool]) {
+      scenarios[TOOL_SCENARIO_MAP[tool]] = (scenarios[TOOL_SCENARIO_MAP[tool]] || 0) + 1;
+    }
+    // MCP 工具前缀匹配
+    for (const [prefix, scenario] of Object.entries(MCP_TOOL_SCENARIOS)) {
+      if (tool.startsWith(prefix)) {
+        scenarios[scenario] = (scenarios[scenario] || 0) + 1;
+        break; // 只匹配第一个前缀，避免重复计数
+      }
+    }
+  }
+
+  // 基于用户文本的关键词分类（仅对 user 消息）
+  // 兼容 UsageRecord 格式（metadata.type/text）和原始格式（type/text）
+  const recordType = record.metadata?.type || record.type;
+  const recordText = record.metadata?.text || record.text;
+  if (recordType === 'user' && recordText && scenarioKeywords) {
+    const lowerText = recordText.toLowerCase();
+    for (const [scenario, keywords] of Object.entries(scenarioKeywords)) {
+      for (const kw of keywords) {
+        const lowerKw = kw.toLowerCase();
+        // 简化正则表达式，对于中文使用简单的包含匹配
+        if (lowerText.includes(lowerKw)) {
+          scenarios[scenario] = (scenarios[scenario] || 0) + 1;
+          break;
+        }
+      }
+    }
+  }
+
+  return scenarios;
+}
+
+// 将内部场景映射为用户友好的分类
+export function mapToDisplayScenarios(internalScenarios) {
+  const display = {
+    '编码': 0,
+    '测试/QA': 0,
+    '调试/排错': 0,
+    '文档': 0,
+    '阅读/研究': 0,
+    '规划/设计': 0,
+    '代码审查': 0,
+    '其他': 0,
+  };
+
+  for (const [key, count] of Object.entries(internalScenarios)) {
+    switch (key) {
+      case 'coding':
+        display['编码'] += count;
+        break;
+      case 'testing':
+        display['测试/QA'] += count;
+        break;
+      case 'debugging':
+        display['调试/排错'] += count;
+        break;
+      case 'documentation':
+        display['文档'] += count;
+        break;
+      case 'reading':
+      case 'research':
+        display['阅读/研究'] += count;
+        break;
+      case 'planning':
+        display['规划/设计'] += count;
+        break;
+      case 'review':
+        display['代码审查'] += count;
+        break;
+      case 'execution':
+        display['编码'] += count;
+        break;
+      case 'interaction':
+      case 'skill':
+      case 'automation':
+      default:
+        display['其他'] += count;
+        break;
+    }
+  }
+
+  return display;
+}
+
+export function aggregateScenarios(records, scenarioKeywords) {
+  const total = {};
+
+  for (const record of records) {
+    const scenarios = classifyRecord(record, scenarioKeywords);
+    for (const [key, count] of Object.entries(scenarios)) {
+      total[key] = (total[key] || 0) + count;
+    }
+  }
+
+  return mapToDisplayScenarios(total);
+}

package/lib/server.js

@@ -0,0 +1,412 @@
+import { createServer } from 'http';
+import { readFileSync, existsSync } from 'fs';
+import { join, extname, resolve, sep } from 'path';
+import { fileURLToPath } from 'url';
+import { saveConfig } from './config.js';
+import { generateWorkReport, generateFeishuCard } from './report.js';
+import { collectAllRecords, filterRecordsByPeriod, groupBySessions } from './aggregate.js';
+import { normalizeProjectPath } from './aggregate.js';
+import { invalidateFileCache } from './cache.js';
+import { invalidateGitCache, getGitStatsForMultipleReposAsync, finalizeGitStats } from './git.js';
+import { identifyBillingBlocks } from './blocks.js';
+import { detectAvailableTools, parseAllEnabledTools } from './parsers/index.js';
+
+// basename 提取，兼容不同路径格式
+function getProjectBaseName(p) {
+  if (!p) return '';
+  return p.replace(/\\/g, '/').replace(/\/$/, '').split('/').pop() || '';
+}
+
+const __dirname = fileURLToPath(new URL('..', import.meta.url));
+
+const MIME = {
+  '.html': 'text/html',
+  '.css': 'text/css',
+  '.js': 'application/javascript; charset=utf-8',
+  '.json': 'application/json',
+  '.png': 'image/png',
+  '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon',
+};
+
+export function startServer(config, effectiveIncludeProjects, buildReportData, configPath) {
+  function computeIncludeProjects(cfg) {
+    if (cfg.repos && cfg.repos.length > 0) {
+      return cfg.repos.map(r => normalizeProjectPath(r));
+    }
+    return null;
+  }
+
+  const PORT = process.env.LUMENCODE_PORT || 4567;
+
+  const server = createServer(async (req, res) => {
+    const url = new URL(req.url, `http://localhost:${PORT}`);
+
+    // 安全响应头
+    res.setHeader('X-Content-Type-Options', 'nosniff');
+    res.setHeader('X-Frame-Options', 'DENY');
+    res.setHeader('Referrer-Policy', 'no-referrer');
+
+    // API endpoint
+    if (url.pathname === '/api/tools') {
+      try {
+        const tools = await detectAvailableTools(config);
+        const enabled = config.enabledTools || tools.filter(t => t.detected).map(t => t.name);
+        const result = tools.map(({ name, displayName, detected, version }) => ({
+          name, displayName, detected, version,
+          enabled: enabled.includes(name),
+        }));
+        res.writeHead(200, { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': 'http://localhost:' + PORT });
+        res.end(JSON.stringify(result));
+      } catch (err) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        console.error('API error:', err.message);
+        res.end(JSON.stringify({ error: '服务器内部错误' }));
+      }
+      return;
+    }
+
+    if (url.pathname === '/api/report') {
+      const period = url.searchParams.get('period') || 'daily';
+      const date = url.searchParams.get('date') || new Date().toISOString().slice(0, 10);
+      const format = url.searchParams.get('format') || 'json';
+      const tool = url.searchParams.get('tool') || 'all';
+
+      // 未配置时返回友好提示
+      if (!config.claudeDir || !existsSync(config.claudeDir)) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+          error: '未配置',
+          hint: '尚未配置 Claude 日志目录，请在下方完成初始设置',
+        }));
+        return;
+      }
+
+      try {
+        const data = await buildReportData(period, date, config, computeIncludeProjects(config), tool);
+        if (!data) {
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({
+            error: '未找到数据',
+            hint: '请检查 Claude 日志目录配置是否正确，确认目录下有 projects/ 子目录',
+          }));
+          return;
+        }
+
+        if (format === 'work') {
+          const platform = url.searchParams.get('platform') || 'default';
+          const level = url.searchParams.get('level') || 'detailed';
+          const feishuCard = url.searchParams.get('feishuCard') === 'true';
+
+          if (feishuCard) {
+            const card = generateFeishuCard(data.usageStats, data.gitStats, period, data.start, data.end, tool);
+            res.writeHead(200, { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': 'http://localhost:' + PORT });
+            res.end(JSON.stringify(card));
+            return;
+          }
+
+          const markdown = generateWorkReport(data.usageStats, data.gitStats, period, data.start, data.end, data.prevStats, { level, platform, tool });
+          res.writeHead(200, {
+            'Content-Type': 'text/plain; charset=utf-8',
+            'Access-Control-Allow-Origin': 'http://localhost:' + PORT,
+          });
+          res.end(markdown);
+          return;
+        }
+
+        // 按工具替换 aiContribution
+        if (tool !== 'all' && data.gitStats?.aiContributionByTool) {
+          const toolAi = data.gitStats.aiContributionByTool[tool];
+          if (toolAi) {
+            data.gitStats.aiContribution = toolAi;
+          }
+        }
+
+        // 添加费用分解
+        if (data.usageStats?.models) {
+          const modelEntries = Object.entries(data.usageStats.models)
+            .sort((a, b) => b[1].cost - a[1].cost);
+          const totalCost = modelEntries.reduce((s, [, d]) => s + (d.cost || 0), 0);
+          // 缓存节省 = (inputTokens - cacheRead) * avgInputRate - 已通过 cacheRead 低价体现
+          // 简化：缓存节省 = cacheRead * avgInputRate * (1 - cacheReadRate/inputRate)
+          const cacheRead = data.usageStats.cacheRead || 0;
+          const cacheCreate = data.usageStats.cacheCreate || 0;
+          let cacheSaving = 0;
+          if (totalCost > 0 && (cacheRead + cacheCreate) > 0) {
+            const totalInput = data.usageStats.inputTokens || 1;
+            const avgInputCostPerToken = totalCost / (totalInput + data.usageStats.outputTokens + cacheRead + cacheCreate || 1);
+            cacheSaving = Math.round(cacheRead * avgInputCostPerToken * 0.9 * 100) / 100;
+          }
+          data.costBreakdown = {
+            models: modelEntries.map(([name, d]) => ({
+              name,
+              cost: d.cost || 0,
+              mode: d.costMode || 'unknown',
+              requests: d.count,
+              inputTokens: d.inputTokens,
+              outputTokens: d.outputTokens,
+            })),
+            cacheSaving,
+            total: Math.round(totalCost * 100) / 100,
+          };
+        }
+
+        res.writeHead(200, {
+          'Content-Type': 'application/json',
+          'Access-Control-Allow-Origin': 'http://localhost:' + PORT,
+        });
+        res.end(JSON.stringify(data));
+      } catch (err) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        console.error('API error:', err.message);
+        res.end(JSON.stringify({ error: '服务器内部错误' }));
+      }
+      return;
+    }
+
+    if (url.pathname === '/api/sessions') {
+      const period = url.searchParams.get('period') || 'daily';
+      const date = url.searchParams.get('date') || new Date().toISOString().slice(0, 10);
+      const project = url.searchParams.get('project') || '';
+      const tool = url.searchParams.get('tool') || '';
+      try {
+        const { records: allRecords } = await parseAllEnabledTools(config, {
+          excludeProjects: config.excludeProjects,
+          includeProjects: computeIncludeProjects(config),
+        });
+        const { filtered, start, end } = filterRecordsByPeriod(allRecords, period, date);
+        const tooledRecords = tool ? filtered.filter(r => r.tool === tool) : filtered;
+        // basename 匹配，兼容不同工具的路径格式差异
+        const projected = project ? tooledRecords.filter(r => getProjectBaseName(r.project) === project) : tooledRecords;
+        const sessions = groupBySessions(projected);
+
+        // 附加 commits 信息（若配置了 repos），按覆盖项目过滤，扩展窗口匹配跨天提交
+        if (config.repos?.length) {
+          try {
+            const coveredBases = new Set(projected.map(r => {
+              const p = r.project || '';
+              return p.replace(/\\/g, '/').replace(/\/$/, '').split('/').pop();
+            }).filter(Boolean));
+            const sessionRepos = config.repos.filter(r => coveredBases.has(r.replace(/\\/g, '/').replace(/\/$/, '').split('/').pop()));
+            if (sessionRepos.length > 0) {
+              const extEnd = new Date(end);
+              extEnd.setDate(extEnd.getDate() + 2);
+              const gitStats = await getGitStatsForMultipleReposAsync(sessionRepos, start, extEnd.toISOString().slice(0, 10) + 'T23:59:59');
+              finalizeGitStats(gitStats, sessions);
+            }
+          } catch {}
+        }
+
+        // 精简返回字段，保留效率指标
+        const slim = sessions.map(s => {
+          const startMs = Date.parse(s.startTime);
+          const endMs = Date.parse(s.endTime);
+          const duration = Number.isFinite(startMs) && Number.isFinite(endMs) ? Math.round((endMs - startMs) / 1000) : 0;
+          return {
+            id: s.id,
+            project: s.project,
+            startTime: s.startTime,
+            endTime: s.endTime,
+            duration,
+            requests: s.requests,
+            userMessages: s.userMessages,
+            inputTokens: s.inputTokens,
+            outputTokens: s.outputTokens,
+            models: s.models,
+            primaryTool: s.primaryTool || null,
+            touchedFileCount: (s.touchedFiles || []).length,
+            toolSequence: (s.toolSequence || []).map(tc => tc.name),
+            shellCommandCount: (s.shellCommands || []).length,
+            commits: s.commits || [],
+          };
+        });
+
+        res.writeHead(200, { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': 'http://localhost:' + PORT });
+        res.end(JSON.stringify(slim));
+      } catch (err) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        console.error('API error:', err.message);
+        res.end(JSON.stringify({ error: '服务器内部错误' }));
+      }
+      return;
+    }
+
+    if (url.pathname === '/api/details') {
+      const period = url.searchParams.get('period') || 'daily';
+      const date = url.searchParams.get('date') || new Date().toISOString().slice(0, 10);
+      const dimension = url.searchParams.get('dimension') || '';
+      const key = url.searchParams.get('key') || '';
+      try {
+        const { records: allRecords } = await parseAllEnabledTools(config, {
+          excludeProjects: config.excludeProjects,
+          includeProjects: computeIncludeProjects(config),
+        });
+        const { filtered } = filterRecordsByPeriod(allRecords, period, date);
+        let result = [];
+        if (dimension === 'model') {
+          const modelRecords = filtered.filter(r => {
+            const isAssistant = r.metadata?.type === 'assistant' || (r.tool === 'codex') || (r.tool === 'opencode' && r.metadata?.role !== 'user') || (r.type === 'assistant' && !r.tool);
+            return isAssistant && (r.model || '') === key;
+          });
+          const dailyMap = {};
+          for (const r of modelRecords) {
+            const d = r.timestamp.slice(0, 10);
+            if (!dailyMap[d]) dailyMap[d] = { date: d, requests: 0, inputTokens: 0, outputTokens: 0 };
+            dailyMap[d].requests++;
+            dailyMap[d].inputTokens += r.inputTokens || r.tokens?.input || 0;
+            dailyMap[d].outputTokens += r.outputTokens || r.tokens?.output || 0;
+          }
+          result = Object.values(dailyMap).sort((a, b) => a.date.localeCompare(b.date));
+        } else if (dimension === 'scenario') {
+          const matched = filtered.filter(r => {
+            const text = r.metadata?.text || r.text || '';
+            const type = r.metadata?.type || r.type;
+            return type === 'user' && text;
+          });
+          for (const r of matched) {
+            const text = r.metadata?.text || r.text || '';
+            const lower = text.toLowerCase();
+            const keywords = config.scenarioKeywords?.[key] || [];
+            for (const kw of keywords) {
+              if (lower.includes(kw.toLowerCase())) {
+                result.push({ text: text.slice(0, 200), timestamp: r.timestamp, project: r.project });
+                break;
+              }
+            }
+            if (result.length >= 10) break;
+          }
+        }
+        res.writeHead(200, { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': 'http://localhost:' + PORT });
+        res.end(JSON.stringify(result));
+      } catch (err) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        console.error('API error:', err.message);
+        res.end(JSON.stringify({ error: '服务器内部错误' }));
+      }
+      return;
+    }
+
+    // Billing blocks endpoint
+    if (url.pathname === '/api/blocks') {
+      const period = url.searchParams.get('period') || 'daily';
+      const date = url.searchParams.get('date') || new Date().toISOString().slice(0, 10);
+      try {
+        const { records: allRecords } = await parseAllEnabledTools(config, {
+          excludeProjects: config.excludeProjects,
+          includeProjects: computeIncludeProjects(config),
+        });
+        const { filtered } = filterRecordsByPeriod(allRecords, period, date);
+        const blocks = identifyBillingBlocks(filtered, 5, config.costMode);
+        res.writeHead(200, { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': 'http://localhost:' + PORT });
+        res.end(JSON.stringify(blocks));
+      } catch (err) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        console.error('API error:', err.message);
+        res.end(JSON.stringify({ error: '服务器内部错误' }));
+      }
+      return;
+    }
+
+    // Config endpoint
+    if (url.pathname === '/api/config') {
+      if (req.method === 'GET') {
+        res.writeHead(200, {
+          'Content-Type': 'application/json',
+          'Access-Control-Allow-Origin': 'http://localhost:' + PORT,
+        });
+        res.end(JSON.stringify({
+          claudeDir: config.claudeDir,
+          codexDir: config.codexDir || '',
+          opencodeDir: config.opencodeDir || '',
+          enabledTools: config.enabledTools || [],
+          repos: config.repos || [],
+          excludeProjects: config.excludeProjects || [],
+          scenarioKeywords: config.scenarioKeywords || {},
+        }));
+        return;
+      }
+
+      if (req.method === 'POST') {
+        let body = '';
+        let bodySize = 0;
+        const MAX_BODY = 1024 * 1024; // 1MB
+        req.on('data', chunk => {
+          bodySize += chunk.length;
+          if (bodySize > MAX_BODY) { req.destroy(); return; }
+          body += chunk;
+        });
+        req.on('end', () => {
+          if (bodySize > MAX_BODY) {
+            res.writeHead(413, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: '请求体过大' }));
+            return;
+          }
+          try {
+            const newConfig = JSON.parse(body);
+            // 路径字段验证：必须是字符串且路径存在或为空
+            const validatePath = (v) => typeof v === 'string';
+            if (newConfig.claudeDir !== undefined) { if (!validatePath(newConfig.claudeDir)) { res.writeHead(400, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: 'claudeDir 格式无效' })); return; } config.claudeDir = newConfig.claudeDir; }
+            if (newConfig.codexDir !== undefined) { if (!validatePath(newConfig.codexDir)) { res.writeHead(400, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: 'codexDir 格式无效' })); return; } config.codexDir = newConfig.codexDir; }
+            if (newConfig.opencodeDir !== undefined) { if (!validatePath(newConfig.opencodeDir)) { res.writeHead(400, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: 'opencodeDir 格式无效' })); return; } config.opencodeDir = newConfig.opencodeDir; }
+            if (newConfig.enabledTools !== undefined) config.enabledTools = newConfig.enabledTools;
+            if (newConfig.repos !== undefined) { if (!Array.isArray(newConfig.repos)) { res.writeHead(400, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: 'repos 格式无效' })); return; } config.repos = newConfig.repos; }
+            if (newConfig.excludeProjects !== undefined) config.excludeProjects = newConfig.excludeProjects;
+            if (newConfig.scenarioKeywords !== undefined) config.scenarioKeywords = newConfig.scenarioKeywords;
+            invalidateFileCache();
+            invalidateGitCache();
+            saveConfig(config, configPath);
+            res.writeHead(200, { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': 'http://localhost:' + PORT });
+            res.end(JSON.stringify({ success: true }));
+          } catch {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'JSON 解析失败' }));
+          }
+        });
+        return;
+      }
+
+      res.writeHead(405, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'Method not allowed' }));
+      return;
+    }
+
+    // Favicon - 返回空响应避免 404 控制台报错
+    if (url.pathname === '/favicon.ico') {
+      res.writeHead(204);
+      res.end();
+      return;
+    }
+
+    // Static files
+    let filePath = url.pathname === '/' ? '/index.html' : decodeURIComponent(url.pathname);
+    const resolved = resolve(__dirname, 'public', filePath.replace(/^\//, ''));
+    const publicDir = resolve(__dirname, 'public');
+
+    if (!resolved.startsWith(publicDir + sep) && resolved !== publicDir) {
+      res.writeHead(403);
+      res.end('Forbidden');
+      return;
+    }
+
+    if (!existsSync(resolved)) {
+      res.writeHead(404);
+      res.end('Not Found');
+      return;
+    }
+
+    const content = readFileSync(resolved);
+    const type = MIME[extname(resolved)] || 'application/octet-stream';
+    res.writeHead(200, { 'Content-Type': type });
+    res.end(content);
+  });
+
+  server.listen(PORT, '127.0.0.1', () => {
+    console.log(`\n  LumenCode server running at http://localhost:${PORT}\n`);
+
+    // Auto-open browser
+    const openCmd = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+    import('child_process').then(({ exec }) => {
+      exec(`${openCmd} http://localhost:${PORT}`, () => {});
+    });
+  });
+}

package/lib/table.js

@@ -0,0 +1,67 @@
+// 轻量级终端表格渲染器
+
+export class Table {
+  constructor({ columns }) {
+    this.columns = columns;
+    this.rows = [];
+  }
+
+  addRow(cells) {
+    this.rows.push(cells);
+  }
+
+  render() {
+    const colWidths = this.columns.map((col, i) => {
+      const maxDataLen = Math.max(...this.rows.map(r => this._visualWidth(String(r[i] || ''))));
+      return Math.max(this._visualWidth(col.title), maxDataLen, col.width || 10);
+    });
+
+    const sep = (l, m, r) => l + colWidths.map(w => '─'.repeat(w + 2)).join(m) + r;
+
+    const lines = [];
+    lines.push(sep('┌', '┬', '┐'));
+
+    // Header
+    lines.push('│ ' + this.columns.map((col, i) => this._pad(col.title, colWidths[i])).join(' │ ') + ' │');
+    lines.push(sep('├', '┼', '┤'));
+
+    // Rows
+    for (const row of this.rows) {
+      lines.push('│ ' + row.map((cell, i) => this._pad(String(cell || ''), colWidths[i])).join(' │ ') + ' │');
+    }
+
+    lines.push(sep('└', '┴', '┘'));
+    return lines.join('\n');
+  }
+
+  _visualWidth(str) {
+    let width = 0;
+    for (const ch of str) {
+      const code = ch.codePointAt(0);
+      if (code >= 0x1100 && (
+        code <= 0x115F ||
+        code === 0x2329 || code === 0x232A ||
+        (code >= 0x2E80 && code <= 0xA4CF && code !== 0x303F) ||
+        (code >= 0xAC00 && code <= 0xD7A3) ||
+        (code >= 0xF900 && code <= 0xFAFF) ||
+        (code >= 0xFE10 && code <= 0xFE19) ||
+        (code >= 0xFE30 && code <= 0xFE6F) ||
+        (code >= 0xFF01 && code <= 0xFF60) ||
+        (code >= 0xFFE0 && code <= 0xFFE6) ||
+        (code >= 0x20000 && code <= 0x2FFFD) ||
+        (code >= 0x30000 && code <= 0x3FFFD)
+      )) {
+        width += 2;
+      } else {
+        width += 1;
+      }
+    }
+    return width;
+  }
+
+  _pad(str, width) {
+    const visual = this._visualWidth(str);
+    const pad = Math.max(0, width - visual);
+    return str + ' '.repeat(pad);
+  }
+}