timsquad 2.0.0 → 2.1.0

package/dist/commands/metrics.js

@@ -7,11 +7,11 @@ import { getDateString, getTimestamp } from '../utils/date.js';
 export function registerMetricsCommand(program) {
     const metricsCmd = program
         .command('metrics')
-        .description('Collect and view project metrics');
+        .description('Collect and view project quality metrics');
     // tsq metrics collect
     metricsCmd
         .command('collect')
-        .description('Collect metrics from logs')
+        .description('Collect metrics from logs and session events')
         .option('-d, --days <days>', 'Days to analyze', '7')
         .action(async (options) => {
         try {
@@ -25,7 +25,7 @@ export function registerMetricsCommand(program) {
     // tsq metrics summary
     metricsCmd
         .command('summary')
-        .description('Show metrics summary')
+        .description('Show latest metrics summary with explanations')
         .action(async () => {
         try {
             await showMetricsSummary();
@@ -35,6 +35,20 @@ export function registerMetricsCommand(program) {
             process.exit(1);
         }
     });
+    // tsq metrics trend
+    metricsCmd
+        .command('trend')
+        .description('Compare metrics across collection periods')
+        .option('-n <count>', 'Number of periods to compare', '5')
+        .action(async (options) => {
+        try {
+            await showTrend(parseInt(options.n, 10));
+        }
+        catch (error) {
+            printError(error.message);
+            process.exit(1);
+        }
+    });
     // tsq metrics export
     metricsCmd
         .command('export')
@@ -50,6 +64,9 @@ export function registerMetricsCommand(program) {
         }
     });
 }
+// ============================================================
+// Collect
+// ============================================================
 async function collectMetrics(days) {
     const projectRoot = await findProjectRoot();
     if (!projectRoot) {
@@ -59,15 +76,16 @@ async function collectMetrics(days) {
     printKeyValue('Period', `Last ${days} days`);
     const now = new Date();
     const startDate = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
-    // Collect log statistics
+    // Collect all data sources in parallel
     const logsDir = path.join(projectRoot, '.timsquad', 'logs');
-    const logStats = await collectLogStats(logsDir, startDate);
-    // Collect feedback statistics
-    const feedbackStats = await collectFeedbackStats(logsDir, startDate);
-    // Collect SSOT statistics
     const ssotDir = path.join(projectRoot, '.timsquad', 'ssot');
-    const ssotStats = await collectSSOTStats(ssotDir);
-    // Create metrics data
+    const sessionsDir = path.join(projectRoot, '.timsquad', 'logs', 'sessions');
+    const [logStats, feedbackStats, ssotStats, sessionStats] = await Promise.all([
+        collectLogStats(logsDir, startDate),
+        collectFeedbackStats(logsDir, startDate),
+        collectSSOTStats(ssotDir),
+        collectSessionStats(sessionsDir, startDate),
+    ]);
     const metrics = {
         collectedAt: getTimestamp(),
         period: {
@@ -77,6 +95,7 @@ async function collectMetrics(days) {
         logs: logStats,
         feedback: feedbackStats,
         ssot: ssotStats,
+        sessions: sessionStats,
     };
     // Save metrics
     const metricsDir = path.join(projectRoot, '.timsquad', 'retrospective', 'metrics');
@@ -85,41 +104,41 @@ async function collectMetrics(days) {
     await fs.writeJson(metricsFile, metrics, { spaces: 2 });
     printSuccess('Metrics collected');
     console.log(colors.path(`\nSaved to: ${metricsFile}`));
-    // Show summary
     console.log('');
     await displayMetrics(metrics);
 }
+// ============================================================
+// Log Statistics
+// ============================================================
 async function collectLogStats(logsDir, startDate) {
     const stats = {
         total: 0,
         byAgent: {},
         byType: {},
+        decisionRatio: 0,
+        errorRate: 0,
     };
-    if (!await exists(logsDir)) {
+    if (!await exists(logsDir))
         return stats;
-    }
     const files = await listFiles('*.md', logsDir);
     const startDateStr = startDate.toISOString().split('T')[0];
     for (const file of files) {
-        // Skip templates
         if (file.startsWith('_'))
             continue;
-        // Parse filename: YYYY-MM-DD-agent.md
         const match = file.match(/^(\d{4}-\d{2}-\d{2})-([a-z]+)\.md$/);
         if (!match)
             continue;
         const [, dateStr, agent] = match;
-        // Check date range
         if (dateStr < startDateStr)
             continue;
         stats.total++;
         stats.byAgent[agent] = (stats.byAgent[agent] || 0) + 1;
-        // Count entries in the file
         try {
             const content = await readFile(path.join(logsDir, file));
-            const workEntries = (content.match(/## \d{2}:\d{2}:\d{2} \[work\]/g) || []).length;
-            const errorEntries = (content.match(/## \d{2}:\d{2}:\d{2} \[error\]/g) || []).length;
-            const decisionEntries = (content.match(/## \d{2}:\d{2}:\d{2} \[decision\]/g) || []).length;
+            // log.sh 형식: ## [HH:MM:SS] type
+            const workEntries = (content.match(/## \[[\d:]+\] work/g) || []).length;
+            const errorEntries = (content.match(/## \[[\d:]+\] error/g) || []).length;
+            const decisionEntries = (content.match(/## \[[\d:]+\] decision/g) || []).length;
             stats.byType['work'] = (stats.byType['work'] || 0) + workEntries;
             stats.byType['error'] = (stats.byType['error'] || 0) + errorEntries;
             stats.byType['decision'] = (stats.byType['decision'] || 0) + decisionEntries;
@@ -128,63 +147,84 @@ async function collectLogStats(logsDir, startDate) {
             // Ignore read errors
         }
     }
+    // 파생 지표 계산
+    const totalEntries = Object.values(stats.byType).reduce((a, b) => a + b, 0);
+    if (totalEntries > 0) {
+        stats.decisionRatio = Math.round(((stats.byType['decision'] || 0) / totalEntries) * 100);
+        stats.errorRate = Math.round(((stats.byType['error'] || 0) / totalEntries) * 100);
+    }
     return stats;
 }
+// ============================================================
+// Feedback Statistics
+// ============================================================
 async function collectFeedbackStats(logsDir, startDate) {
-    const stats = {
-        total: 0,
-        byLevel: {},
-    };
-    if (!await exists(logsDir)) {
-        return stats;
-    }
-    const files = await listFiles('*-feedback.md', logsDir);
-    const startDateStr = startDate.toISOString().split('T')[0];
-    for (const file of files) {
-        // Parse filename: YYYY-MM-DD-feedback.md
-        const match = file.match(/^(\d{4}-\d{2}-\d{2})-feedback\.md$/);
-        if (!match)
-            continue;
-        const [, dateStr] = match;
-        // Check date range
-        if (dateStr < startDateStr)
-            continue;
-        // Count feedback entries
-        try {
-            const content = await readFile(path.join(logsDir, file));
-            const level1 = (content.match(/\[Level 1\]/g) || []).length;
-            const level2 = (content.match(/\[Level 2\]/g) || []).length;
-            const level3 = (content.match(/\[Level 3\]/g) || []).length;
-            stats.byLevel['1'] = (stats.byLevel['1'] || 0) + level1;
-            stats.byLevel['2'] = (stats.byLevel['2'] || 0) + level2;
-            stats.byLevel['3'] = (stats.byLevel['3'] || 0) + level3;
-            stats.total += level1 + level2 + level3;
+    const stats = { total: 0, byLevel: {} };
+    // Structured JSON feedback (우선)
+    const projectRoot = path.dirname(logsDir.replace(/\/.timsquad\/logs$/, ''));
+    const structuredDir = path.join(projectRoot, '.timsquad', 'feedback');
+    if (await exists(structuredDir)) {
+        const jsonFiles = await listFiles('FB-*.json', structuredDir);
+        for (const file of jsonFiles) {
+            try {
+                const data = await fs.readJson(path.join(structuredDir, file));
+                if (data.level) {
+                    const level = String(data.level);
+                    stats.byLevel[level] = (stats.byLevel[level] || 0) + 1;
+                    stats.total++;
+                }
+            }
+            catch {
+                // skip
+            }
         }
-        catch {
-            // Ignore read errors
+    }
+    // Fallback: markdown feedback logs
+    if (stats.total === 0 && await exists(logsDir)) {
+        const startDateStr = startDate.toISOString().split('T')[0];
+        const files = await listFiles('*-feedback.md', logsDir);
+        for (const file of files) {
+            const match = file.match(/^(\d{4}-\d{2}-\d{2})-feedback\.md$/);
+            if (!match)
+                continue;
+            const [, dateStr] = match;
+            if (dateStr < startDateStr)
+                continue;
+            try {
+                const content = await readFile(path.join(logsDir, file));
+                const level1 = (content.match(/\[Level 1\]/g) || []).length;
+                const level2 = (content.match(/\[Level 2\]/g) || []).length;
+                const level3 = (content.match(/\[Level 3\]/g) || []).length;
+                stats.byLevel['1'] = (stats.byLevel['1'] || 0) + level1;
+                stats.byLevel['2'] = (stats.byLevel['2'] || 0) + level2;
+                stats.byLevel['3'] = (stats.byLevel['3'] || 0) + level3;
+                stats.total += level1 + level2 + level3;
+            }
+            catch {
+                // skip
+            }
         }
     }
     return stats;
 }
+// ============================================================
+// SSOT Statistics
+// ============================================================
 async function collectSSOTStats(ssotDir) {
     const stats = {
         documentsCount: 0,
         filledCount: 0,
         completionRate: 0,
     };
-    if (!await exists(ssotDir)) {
+    if (!await exists(ssotDir))
         return stats;
-    }
     const files = await listFiles('*.md', ssotDir);
     for (const file of files) {
-        // Skip templates
         if (file.includes('template'))
             continue;
         stats.documentsCount++;
-        // Check if document has content
         try {
             const content = await readFile(path.join(ssotDir, file));
-            // Consider filled if more than 200 characters of non-template content
             const cleanContent = content
                 .replace(/^#.*$/gm, '')
                 .replace(/^\s*$/gm, '')
@@ -194,7 +234,7 @@ async function collectSSOTStats(ssotDir) {
             }
         }
         catch {
-            // Ignore read errors
+            // skip
         }
     }
     stats.completionRate = stats.documentsCount > 0
@@ -202,73 +242,331 @@ async function collectSSOTStats(ssotDir) {
         : 0;
     return stats;
 }
-async function showMetricsSummary() {
-    const projectRoot = await findProjectRoot();
-    if (!projectRoot) {
-        throw new Error('Not a TimSquad project');
+// ============================================================
+// Session Statistics (세션 이벤트 기반 품질 지표)
+// ============================================================
+async function collectSessionStats(sessionsDir, startDate) {
+    const stats = {
+        totalSessions: 0,
+        totalEvents: 0,
+        totalToolUses: 0,
+        totalFailures: 0,
+        toolEfficiency: 0,
+        subagentCount: 0,
+        tokens: {
+            totalInput: 0,
+            totalOutput: 0,
+            totalCacheCreate: 0,
+            totalCacheRead: 0,
+            cacheHitRate: 0,
+            avgOutputPerTurn: 0,
+            maxOutputPerTurn: 0,
+        },
+        toolBreakdown: {},
+        cliAdoption: {
+            totalBashCommands: 0,
+            tsqCommands: 0,
+            adoptionRate: 0,
+        },
+    };
+    if (!await exists(sessionsDir))
+        return stats;
+    const files = await listFiles('*.jsonl', sessionsDir);
+    const startDateStr = startDate.toISOString().split('T')[0];
+    const allTurnOutputs = [];
+    for (const file of files) {
+        // 날짜 필터
+        const dateStr = file.split('-').slice(0, 3).join('-');
+        if (dateStr < startDateStr)
+            continue;
+        stats.totalSessions++;
+        try {
+            const content = await readFile(path.join(sessionsDir, file));
+            const events = [];
+            for (const line of content.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    events.push(JSON.parse(trimmed));
+                }
+                catch { /* skip */ }
+            }
+            stats.totalEvents += events.length;
+            for (const ev of events) {
+                // 도구 사용 통계
+                if (ev.event === 'PostToolUse') {
+                    stats.totalToolUses++;
+                    if (ev.tool) {
+                        stats.toolBreakdown[ev.tool] = (stats.toolBreakdown[ev.tool] || 0) + 1;
+                    }
+                    // CLI 채택률: Bash 명령 중 tsq 사용 비율
+                    if (ev.tool === 'Bash') {
+                        stats.cliAdoption.totalBashCommands++;
+                        const cmd = ev.detail?.command || '';
+                        if (cmd.match(/^(tsq|npx tsq)\s/)) {
+                            stats.cliAdoption.tsqCommands++;
+                        }
+                    }
+                }
+                if (ev.event === 'PostToolUseFailure')
+                    stats.totalFailures++;
+                if (ev.event === 'SubagentStart')
+                    stats.subagentCount++;
+                // 토큰 (Stop 이벤트에서 턴별 수집)
+                if (ev.event === 'Stop' && ev.usage) {
+                    allTurnOutputs.push(ev.usage.output || 0);
+                }
+                // 토큰 (SessionEnd에서 세션 합산)
+                if (ev.event === 'SessionEnd' && ev.total_usage) {
+                    stats.tokens.totalInput += ev.total_usage.total_input || 0;
+                    stats.tokens.totalOutput += ev.total_usage.total_output || 0;
+                    stats.tokens.totalCacheCreate += ev.total_usage.total_cache_create || 0;
+                    stats.tokens.totalCacheRead += ev.total_usage.total_cache_read || 0;
+                }
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
     }
-    printHeader('Metrics Summary');
-    // Load latest metrics
-    const metricsDir = path.join(projectRoot, '.timsquad', 'retrospective', 'metrics');
-    if (!await exists(metricsDir)) {
-        console.log(colors.dim('No metrics collected yet'));
-        console.log(colors.dim('\nRun: tsq metrics collect'));
-        return;
+    // 파생 지표 계산
+    const totalToolAttempts = stats.totalToolUses + stats.totalFailures;
+    stats.toolEfficiency = totalToolAttempts > 0
+        ? Math.round((stats.totalToolUses / totalToolAttempts) * 100) : 0;
+    const allInput = stats.tokens.totalInput + stats.tokens.totalCacheCreate + stats.tokens.totalCacheRead;
+    stats.tokens.cacheHitRate = allInput > 0
+        ? Math.round((stats.tokens.totalCacheRead / allInput) * 100) : 0;
+    if (allTurnOutputs.length > 0) {
+        stats.tokens.avgOutputPerTurn = Math.round(allTurnOutputs.reduce((a, b) => a + b, 0) / allTurnOutputs.length);
+        stats.tokens.maxOutputPerTurn = Math.max(...allTurnOutputs);
     }
-    const files = await listFiles('metrics-*.json', metricsDir);
-    files.sort().reverse();
-    if (files.length === 0) {
-        console.log(colors.dim('No metrics collected yet'));
-        console.log(colors.dim('\nRun: tsq metrics collect'));
-        return;
-    }
-    // Load latest metrics
-    const latestFile = path.join(metricsDir, files[0]);
-    const metrics = await fs.readJson(latestFile);
-    await displayMetrics(metrics);
+    stats.cliAdoption.adoptionRate = stats.cliAdoption.totalBashCommands > 0
+        ? Math.round((stats.cliAdoption.tsqCommands / stats.cliAdoption.totalBashCommands) * 100) : 0;
+    return stats;
 }
+// ============================================================
+// Display
+// ============================================================
 async function displayMetrics(metrics) {
     printKeyValue('Collected at', metrics.collectedAt);
     printKeyValue('Period', `${metrics.period.start} ~ ${metrics.period.end}`);
-    console.log(colors.subheader('\n📊 Log Statistics'));
-    printKeyValue('Total log files', String(metrics.logs.total));
+    // ── 프로세스 지표 ──
+    console.log(colors.subheader('\n  Process Metrics'));
+    console.log(colors.dim('  에이전트 작업 기록 현황. 프로세스 준수도를 나타냄\n'));
+    printKeyValue('  Log files', String(metrics.logs.total));
     if (Object.keys(metrics.logs.byAgent).length > 0) {
-        console.log(colors.dim('\nBy Agent:'));
+        console.log(colors.dim('  By Agent:'));
         Object.entries(metrics.logs.byAgent)
             .sort((a, b) => b[1] - a[1])
             .forEach(([agent, count]) => {
-            console.log(`  ${agent.padEnd(12)} ${colors.highlight(String(count))}`);
+            console.log(`    ${agent.padEnd(12)} ${colors.highlight(String(count))}`);
         });
     }
     if (Object.keys(metrics.logs.byType).length > 0) {
-        console.log(colors.dim('\nBy Type:'));
+        console.log(colors.dim('  By Type:'));
         Object.entries(metrics.logs.byType)
             .sort((a, b) => b[1] - a[1])
             .forEach(([type, count]) => {
-            console.log(`  ${type.padEnd(12)} ${colors.highlight(String(count))}`);
+            console.log(`    ${type.padEnd(12)} ${colors.highlight(String(count))}`);
         });
     }
-    console.log(colors.subheader('\n📝 Feedback Statistics'));
-    printKeyValue('Total feedback', String(metrics.feedback.total));
+    printKeyValue('  Decision Ratio', `${metrics.logs.decisionRatio}%`);
+    console.log(colors.dim('    의사결정 기록 비율. 높을수록 결정 추적 가능'));
+    printKeyValue('  Error Rate', `${metrics.logs.errorRate}%`);
+    console.log(colors.dim('    에러 로그 비율. 낮을수록 안정적'));
+    // ── 피드백 지표 ──
+    console.log(colors.subheader('\n  Feedback Metrics'));
+    console.log(colors.dim('  피드백 레벨별 분포. Level 3이 잦으면 요구사항 정의 개선 필요\n'));
+    printKeyValue('  Total feedback', String(metrics.feedback.total));
     if (Object.keys(metrics.feedback.byLevel).length > 0) {
-        console.log(colors.dim('\nBy Level:'));
+        const levelDesc = {
+            '1': '구현 수정 - 경미한 코드 수정 (정상적 개발 과정)',
+            '2': '설계 수정 - SSOT 변경 필요 (빈번하면 초기 설계 검토)',
+            '3': '기획 수정 - 요구사항 재검토 (잦으면 기획 프로세스 개선)',
+        };
         ['1', '2', '3'].forEach(level => {
             const count = metrics.feedback.byLevel[level] || 0;
-            const label = level === '1' ? '구현 수정' : level === '2' ? '설계 수정' : '기획 수정';
-            console.log(`  Level ${level} (${label.padEnd(6)}) ${colors.highlight(String(count))}`);
+            const bar = count > 0 ? ' ' + '█'.repeat(Math.min(count, 20)) : '';
+            console.log(`    Level ${level}  ${colors.highlight(String(count).padStart(3))}${colors.dim(bar)}`);
+            console.log(colors.dim(`           ${levelDesc[level]}`));
         });
     }
-    console.log(colors.subheader('\n📄 SSOT Status'));
-    printKeyValue('Documents', String(metrics.ssot.documentsCount));
-    printKeyValue('Filled', String(metrics.ssot.filledCount));
-    printKeyValue('Completion rate', `${metrics.ssot.completionRate}%`);
+    // ── SSOT 지표 ──
+    console.log(colors.subheader('\n  SSOT Health'));
+    console.log(colors.dim('  문서 기반 개발 성숙도. 100%에 가까울수록 SSOT 운영 양호\n'));
+    printKeyValue('  Documents', `${metrics.ssot.filledCount}/${metrics.ssot.documentsCount}`);
+    printKeyValue('  Completion', `${metrics.ssot.completionRate}%`);
+    if (metrics.ssot.completionRate < 50) {
+        console.log(colors.dim('    SSOT 완성률이 낮음. 문서 작성을 우선 진행하세요'));
+    }
+    // ── 세션 지표 ──
+    const s = metrics.sessions;
+    console.log(colors.subheader('\n  Session & Token Metrics'));
+    console.log(colors.dim('  Claude Code 세션 활동. 토큰 효율과 에이전트 정확도 추적\n'));
+    printKeyValue('  Sessions', String(s.totalSessions));
+    printKeyValue('  Total events', String(s.totalEvents));
+    printKeyValue('  Tool uses', String(s.totalToolUses));
+    printKeyValue('  Failures', String(s.totalFailures));
+    printKeyValue('  Tool Efficiency', `${s.toolEfficiency}%`);
+    console.log(colors.dim('    도구 성공률. 95%+ 정상, 90% 미만이면 에이전트 프롬프트 점검'));
+    if (s.subagentCount > 0) {
+        printKeyValue('  Subagents', String(s.subagentCount));
+    }
+    // 토큰
+    if (s.tokens.totalOutput > 0) {
+        console.log('');
+        console.log(colors.dim('  Token Usage:'));
+        printKeyValue('    Input', formatTokens(s.tokens.totalInput));
+        printKeyValue('    Output', formatTokens(s.tokens.totalOutput));
+        printKeyValue('    Cache Create', formatTokens(s.tokens.totalCacheCreate));
+        printKeyValue('    Cache Read', formatTokens(s.tokens.totalCacheRead));
+        printKeyValue('    Cache Hit Rate', `${s.tokens.cacheHitRate}%`);
+        if (s.tokens.cacheHitRate >= 80) {
+            console.log(colors.dim('      우수 - 프롬프트 구조 안정, 캐시 효율 높음'));
+        }
+        else if (s.tokens.cacheHitRate >= 60) {
+            console.log(colors.dim('      보통 - 일부 프롬프트 변경으로 캐시 미스 발생'));
+        }
+        else {
+            console.log(colors.dim('      주의 - 프롬프트 구조 불안정, 캐시 효율 낮음. CLAUDE.md 검토 필요'));
+        }
+        printKeyValue('    Avg Output/Turn', formatTokens(s.tokens.avgOutputPerTurn));
+        console.log(colors.dim('      턴당 평균 출력 토큰. 비정상적으로 높으면 응답이 불필요하게 장황'));
+        printKeyValue('    Max Output/Turn', formatTokens(s.tokens.maxOutputPerTurn));
+        console.log(colors.dim('      최대 출력 토큰. 이상치 턴 감지용'));
+    }
+    // 도구 분포
+    if (Object.keys(s.toolBreakdown).length > 0) {
+        console.log('');
+        console.log(colors.dim('  Tool Breakdown:'));
+        const sorted = Object.entries(s.toolBreakdown).sort(([, a], [, b]) => b - a);
+        for (const [tool, count] of sorted.slice(0, 8)) {
+            const bar = '█'.repeat(Math.min(Math.round(count / Math.max(1, sorted[0][1]) * 20), 20));
+            console.log(`    ${colors.primary(tool.padEnd(12))} ${colors.dim(bar)} ${count}`);
+        }
+    }
+    // CLI 채택률
+    if (s.cliAdoption.totalBashCommands > 0) {
+        console.log('');
+        printKeyValue('  CLI Adoption', `${s.cliAdoption.adoptionRate}% (${s.cliAdoption.tsqCommands}/${s.cliAdoption.totalBashCommands} Bash commands)`);
+        console.log(colors.dim('    Bash 명령 중 tsq CLI 사용 비율. 높을수록 프레임워크 정착도 높음'));
+    }
 }
-async function exportMetrics(outputPath) {
+// ============================================================
+// Trend (시계열 비교)
+// ============================================================
+async function showTrend(count) {
     const projectRoot = await findProjectRoot();
-    if (!projectRoot) {
+    if (!projectRoot)
         throw new Error('Not a TimSquad project');
+    const metricsDir = path.join(projectRoot, '.timsquad', 'retrospective', 'metrics');
+    if (!await exists(metricsDir)) {
+        console.log(colors.dim('No metrics collected yet. Run: tsq metrics collect'));
+        return;
     }
-    // Load all metrics
+    const files = await listFiles('metrics-*.json', metricsDir);
+    files.sort().reverse();
+    if (files.length < 2) {
+        console.log(colors.dim('Need at least 2 collection periods for trend analysis.'));
+        console.log(colors.dim('Run: tsq metrics collect --days 7'));
+        return;
+    }
+    printHeader('Metrics Trend');
+    console.log(colors.dim('  핵심 지표의 시계열 변화. 우측이 최신.\n'));
+    const periods = [];
+    for (const file of files.slice(0, count).reverse()) {
+        const data = await fs.readJson(path.join(metricsDir, file));
+        periods.push(data);
+    }
+    // 헤더
+    const dates = periods.map(p => p.period.end.slice(5)); // MM-DD
+    console.log(`  ${'Metric'.padEnd(22)} ${dates.map(d => d.padStart(8)).join('')}`);
+    console.log(colors.dim(`  ${'─'.repeat(22 + dates.length * 8)}`));
+    // SSOT Completion
+    const ssotValues = periods.map(p => `${p.ssot.completionRate}%`);
+    console.log(`  ${'SSOT Completion'.padEnd(22)} ${ssotValues.map(v => v.padStart(8)).join('')}`);
+    // Feedback Total
+    const fbValues = periods.map(p => String(p.feedback.total));
+    console.log(`  ${'Feedback Count'.padEnd(22)} ${fbValues.map(v => v.padStart(8)).join('')}`);
+    // Decision Ratio
+    const drValues = periods.map(p => `${p.logs.decisionRatio || 0}%`);
+    console.log(`  ${'Decision Ratio'.padEnd(22)} ${drValues.map(v => v.padStart(8)).join('')}`);
+    // Error Rate
+    const erValues = periods.map(p => `${p.logs.errorRate || 0}%`);
+    console.log(`  ${'Error Rate'.padEnd(22)} ${erValues.map(v => v.padStart(8)).join('')}`);
+    // Session metrics (if available)
+    if (periods.some(p => p.sessions?.totalSessions > 0)) {
+        console.log('');
+        const teValues = periods.map(p => `${p.sessions?.toolEfficiency || 0}%`);
+        console.log(`  ${'Tool Efficiency'.padEnd(22)} ${teValues.map(v => v.padStart(8)).join('')}`);
+        const chValues = periods.map(p => `${p.sessions?.tokens.cacheHitRate || 0}%`);
+        console.log(`  ${'Cache Hit Rate'.padEnd(22)} ${chValues.map(v => v.padStart(8)).join('')}`);
+        const aoValues = periods.map(p => formatTokens(p.sessions?.tokens.avgOutputPerTurn || 0));
+        console.log(`  ${'Avg Output/Turn'.padEnd(22)} ${aoValues.map(v => v.padStart(8)).join('')}`);
+        const caValues = periods.map(p => `${p.sessions?.cliAdoption.adoptionRate || 0}%`);
+        console.log(`  ${'CLI Adoption'.padEnd(22)} ${caValues.map(v => v.padStart(8)).join('')}`);
+    }
+    // 변화 분석
+    if (periods.length >= 2) {
+        const prev = periods[periods.length - 2];
+        const curr = periods[periods.length - 1];
+        console.log(colors.subheader('\n  Changes (latest vs previous):'));
+        const changes = [];
+        const ssotDelta = curr.ssot.completionRate - prev.ssot.completionRate;
+        if (ssotDelta !== 0) {
+            changes.push(`  SSOT Completion: ${ssotDelta > 0 ? colors.success(`+${ssotDelta}%`) : colors.error(`${ssotDelta}%`)}`);
+        }
+        if (curr.sessions && prev.sessions) {
+            const cacheDelta = curr.sessions.tokens.cacheHitRate - prev.sessions.tokens.cacheHitRate;
+            if (cacheDelta !== 0) {
+                changes.push(`  Cache Hit Rate:  ${cacheDelta > 0 ? colors.success(`+${cacheDelta}%`) : colors.error(`${cacheDelta}%`)}`);
+            }
+            const effDelta = curr.sessions.toolEfficiency - prev.sessions.toolEfficiency;
+            if (effDelta !== 0) {
+                changes.push(`  Tool Efficiency: ${effDelta > 0 ? colors.success(`+${effDelta}%`) : colors.error(`${effDelta}%`)}`);
+            }
+        }
+        if (changes.length > 0) {
+            changes.forEach(c => console.log(c));
+        }
+        else {
+            console.log(colors.dim('  No significant changes detected.'));
+        }
+    }
+}
+// ============================================================
+// Summary
+// ============================================================
+async function showMetricsSummary() {
+    const projectRoot = await findProjectRoot();
+    if (!projectRoot)
+        throw new Error('Not a TimSquad project');
+    printHeader('Metrics Summary');
+    const metricsDir = path.join(projectRoot, '.timsquad', 'retrospective', 'metrics');
+    if (!await exists(metricsDir)) {
+        console.log(colors.dim('No metrics collected yet'));
+        console.log(colors.dim('\nRun: tsq metrics collect'));
+        return;
+    }
+    const files = await listFiles('metrics-*.json', metricsDir);
+    files.sort().reverse();
+    if (files.length === 0) {
+        console.log(colors.dim('No metrics collected yet'));
+        console.log(colors.dim('\nRun: tsq metrics collect'));
+        return;
+    }
+    const latestFile = path.join(metricsDir, files[0]);
+    const metrics = await fs.readJson(latestFile);
+    await displayMetrics(metrics);
+}
+// ============================================================
+// Export
+// ============================================================
+async function exportMetrics(outputPath) {
+    const projectRoot = await findProjectRoot();
+    if (!projectRoot)
+        throw new Error('Not a TimSquad project');
     const metricsDir = path.join(projectRoot, '.timsquad', 'retrospective', 'metrics');
     if (!await exists(metricsDir)) {
         throw new Error('No metrics collected yet. Run: tsq metrics collect');
@@ -277,15 +575,12 @@ async function exportMetrics(outputPath) {
     if (files.length === 0) {
         throw new Error('No metrics collected yet. Run: tsq metrics collect');
     }
-    // Load all metrics files
     const allMetrics = [];
     for (const file of files.sort()) {
         const data = await fs.readJson(path.join(metricsDir, file));
         allMetrics.push(data);
     }
-    // Determine output path
     const output = outputPath || path.join(projectRoot, `timsquad-metrics-export-${getDateString()}.json`);
-    // Export
     const exportData = {
         exportedAt: getTimestamp(),
         projectRoot,
@@ -296,4 +591,14 @@ async function exportMetrics(outputPath) {
     printSuccess('Metrics exported');
     console.log(colors.path(`\n${output}`));
 }
+// ============================================================
+// Helpers
+// ============================================================
+function formatTokens(tokens) {
+    if (tokens < 1000)
+        return String(tokens);
+    if (tokens < 1000000)
+        return `${(tokens / 1000).toFixed(1)}K`;
+    return `${(tokens / 1000000).toFixed(2)}M`;
+}
 //# sourceMappingURL=metrics.js.map