aiwf 0.3.8 → 0.3.12

package/claude-code/aiwf/en/utils/token-reporter.js

@@ -1,453 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { TokenStorage } from './token-storage.js';
-import { TokenCounter } from './token-counter.js';
-
-/**
- * 토큰 사용량 보고서를 생성하고 포맷팅하는 클래스
- */
-export class TokenReporter {
-  constructor() {
-    this.storage = new TokenStorage();
-    this.counter = new TokenCounter();
-  }
-
-  /**
-   * 프로젝트 전체 토큰 분석 보고서를 생성합니다
-   * @param {string} projectPath - 프로젝트 경로
-   * @returns {Object} 프로젝트 토큰 분석 보고서
-   */
-  generateProjectAnalysisReport(projectPath = '.') {
-    try {
-      const report = {
-        generatedAt: new Date().toISOString(),
-        projectPath,
-        analysis: {
-          totalTokens: 0,
-          fileBreakdown: {},
-          directoryBreakdown: {},
-          compressionOpportunities: [],
-          recommendations: []
-        }
-      };
-
-      // 주요 AIWF 디렉토리 분석
-      const directories = [
-        '.aiwf/01_PROJECT_DOCS',
-        '.aiwf/02_REQUIREMENTS',
-        '.aiwf/03_SPRINTS',
-        '.aiwf/04_GENERAL_TASKS',
-        '.aiwf/05_COMPLETED_TASKS',
-        '.aiwf/06_FEATURE_LEDGERS',
-        '.aiwf/07_AI_PERSONAS'
-      ];
-
-      // 각 디렉토리별 토큰 수 분석
-      for (const dir of directories) {
-        const dirPath = path.join(projectPath, dir);
-        if (fs.existsSync(dirPath)) {
-          const tokens = this.counter.countDirectoryTokens(dirPath);
-          report.analysis.directoryBreakdown[dir] = {
-            tokens,
-            percentage: 0, // 나중에 계산
-            files: this.getFileAnalysis(dirPath)
-          };
-          report.analysis.totalTokens += tokens;
-        }
-      }
-
-      // 퍼센티지 계산
-      Object.keys(report.analysis.directoryBreakdown).forEach(dir => {
-        const breakdown = report.analysis.directoryBreakdown[dir];
-        breakdown.percentage = report.analysis.totalTokens > 0 
-          ? ((breakdown.tokens / report.analysis.totalTokens) * 100).toFixed(1)
-          : 0;
-      });
-
-      // 압축 기회 식별
-      report.analysis.compressionOpportunities = this.identifyCompressionOpportunities(
-        report.analysis.directoryBreakdown
-      );
-
-      // 권장사항 생성
-      report.analysis.recommendations = this.generateRecommendations(
-        report.analysis.totalTokens,
-        report.analysis.compressionOpportunities
-      );
-
-      return report;
-    } catch (error) {
-      console.error('프로젝트 분석 보고서 생성 중 오류 발생:', error);
-      return null;
-    }
-  }
-
-  /**
-   * 디렉토리 내 파일별 토큰 분석을 수행합니다
-   * @param {string} dirPath - 디렉토리 경로
-   * @returns {Array<Object>} 파일별 분석 결과
-   */
-  getFileAnalysis(dirPath) {
-    try {
-      const files = this.counter.getMarkdownFiles(dirPath);
-      const analysis = [];
-
-      for (const file of files) {
-        const tokens = this.counter.countFileTokens(file);
-        const relativePath = path.relative(process.cwd(), file);
-        
-        analysis.push({
-          path: relativePath,
-          tokens,
-          size: fs.statSync(file).size,
-          tokensPerByte: tokens > 0 ? (tokens / fs.statSync(file).size).toFixed(3) : 0
-        });
-      }
-
-      return analysis.sort((a, b) => b.tokens - a.tokens);
-    } catch (error) {
-      console.error('파일 분석 중 오류 발생:', error);
-      return [];
-    }
-  }
-
-  /**
-   * 압축 기회를 식별합니다
-   * @param {Object} directoryBreakdown - 디렉토리별 분석 결과
-   * @returns {Array<Object>} 압축 기회 목록
-   */
-  identifyCompressionOpportunities(directoryBreakdown) {
-    const opportunities = [];
-
-    try {
-      // 대용량 디렉토리 식별
-      const largeDirectories = Object.entries(directoryBreakdown)
-        .filter(([_, data]) => data.tokens > 5000)
-        .sort((a, b) => b[1].tokens - a[1].tokens);
-
-      for (const [dir, data] of largeDirectories) {
-        opportunities.push({
-          type: 'large_directory',
-          target: dir,
-          currentTokens: data.tokens,
-          description: `대용량 디렉토리 (${data.tokens} 토큰)`,
-          potentialSavings: Math.round(data.tokens * 0.3),
-          priority: data.tokens > 10000 ? 'high' : 'medium'
-        });
-      }
-
-      // 반복 콘텐츠 식별
-      opportunities.push({
-        type: 'repetitive_content',
-        target: 'all',
-        description: '반복되는 템플릿 및 보일러플레이트 콘텐츠',
-        potentialSavings: Math.round(Object.values(directoryBreakdown).reduce((sum, data) => sum + data.tokens, 0) * 0.15),
-        priority: 'medium'
-      });
-
-      // 완료된 태스크 압축
-      if (directoryBreakdown['.aiwf/05_COMPLETED_TASKS']) {
-        opportunities.push({
-          type: 'completed_tasks',
-          target: '.aiwf/05_COMPLETED_TASKS',
-          currentTokens: directoryBreakdown['.aiwf/05_COMPLETED_TASKS'].tokens,
-          description: '완료된 태스크 아카이브',
-          potentialSavings: Math.round(directoryBreakdown['.aiwf/05_COMPLETED_TASKS'].tokens * 0.6),
-          priority: 'low'
-        });
-      }
-    } catch (error) {
-      console.error('압축 기회 식별 중 오류 발생:', error);
-    }
-
-    return opportunities.sort((a, b) => {
-      const priorityOrder = { high: 3, medium: 2, low: 1 };
-      return priorityOrder[b.priority] - priorityOrder[a.priority];
-    });
-  }
-
-  /**
-   * 권장사항을 생성합니다
-   * @param {number} totalTokens - 총 토큰 수
-   * @param {Array<Object>} opportunities - 압축 기회 목록
-   * @returns {Array<Object>} 권장사항 목록
-   */
-  generateRecommendations(totalTokens, opportunities) {
-    const recommendations = [];
-
-    try {
-      // 총 토큰 수에 따른 권장사항
-      if (totalTokens > 50000) {
-        recommendations.push({
-          type: 'aggressive_compression',
-          priority: 'high',
-          title: '적극적 압축 모드 권장',
-          description: `프로젝트 크기가 ${totalTokens.toLocaleString()} 토큰으로 매우 큽니다. 적극적 압축 모드를 사용하여 50-70% 압축을 권장합니다.`,
-          action: 'aiwf compress --mode aggressive --level 4'
-        });
-      } else if (totalTokens > 20000) {
-        recommendations.push({
-          type: 'balanced_compression',
-          priority: 'medium',
-          title: '균형 압축 모드 권장',
-          description: `프로젝트 크기가 ${totalTokens.toLocaleString()} 토큰입니다. 균형 압축 모드를 사용하여 30-50% 압축을 권장합니다.`,
-          action: 'aiwf compress --mode balanced --level 3'
-        });
-      }
-
-      // 압축 기회 기반 권장사항
-      const highPriorityOpportunities = opportunities.filter(op => op.priority === 'high');
-      if (highPriorityOpportunities.length > 0) {
-        recommendations.push({
-          type: 'targeted_compression',
-          priority: 'high',
-          title: '특정 디렉토리 압축 권장',
-          description: `${highPriorityOpportunities.length}개의 대용량 디렉토리가 식별되었습니다.`,
-          action: 'aiwf compress --target-directories'
-        });
-      }
-
-      // 정기적 정리 권장사항
-      recommendations.push({
-        type: 'regular_cleanup',
-        priority: 'low',
-        title: '정기적 프로젝트 정리',
-        description: '오래된 로그, 완료된 태스크 등을 정기적으로 정리하여 토큰 사용량을 최적화하세요.',
-        action: 'aiwf cleanup --older-than 30d'
-      });
-
-      // 토큰 모니터링 권장사항
-      recommendations.push({
-        type: 'monitoring',
-        priority: 'medium',
-        title: '토큰 사용량 모니터링 설정',
-        description: '토큰 사용량을 실시간으로 모니터링하고 임계값을 설정하세요.',
-        action: 'aiwf token-monitor --enable --threshold 10000'
-      });
-    } catch (error) {
-      console.error('권장사항 생성 중 오류 발생:', error);
-    }
-
-    return recommendations.sort((a, b) => {
-      const priorityOrder = { high: 3, medium: 2, low: 1 };
-      return priorityOrder[b.priority] - priorityOrder[a.priority];
-    });
-  }
-
-  /**
-   * 사용량 보고서를 생성합니다
-   * @param {string} type - 보고서 타입
-   * @returns {Object} 사용량 보고서
-   */
-  generateUsageReport(type = 'daily') {
-    try {
-      const report = this.storage.generateUsageReport(type);
-      
-      if (!report) {
-        return null;
-      }
-
-      // 보고서 포맷팅
-      const formattedReport = {
-        ...report,
-        formatted: {
-          summary: this.formatSummary(report.summary),
-          dailyUsage: this.formatDailyUsage(report.dailyUsage),
-          topCommands: this.formatTopCommands(report.topCommands),
-          compressionStats: this.formatCompressionStats(report.compressionStats),
-          trends: this.formatTrends(report.trends)
-        }
-      };
-
-      return formattedReport;
-    } catch (error) {
-      console.error('사용량 보고서 생성 중 오류 발생:', error);
-      return null;
-    }
-  }
-
-  /**
-   * 요약 정보를 포맷팅합니다
-   * @param {Object} summary - 요약 정보
-   * @returns {Object} 포맷팅된 요약 정보
-   */
-  formatSummary(summary) {
-    return {
-      totalTokens: summary.totalTokens.toLocaleString(),
-      totalSessions: summary.totalSessions.toLocaleString(),
-      avgTokensPerSession: summary.avgTokensPerSession.toLocaleString(),
-      efficiency: summary.avgTokensPerSession > 1000 ? 'High' : 
-                  summary.avgTokensPerSession > 500 ? 'Medium' : 'Low'
-    };
-  }
-
-  /**
-   * 일일 사용량을 포맷팅합니다
-   * @param {Object} dailyUsage - 일일 사용량
-   * @returns {Array<Object>} 포맷팅된 일일 사용량
-   */
-  formatDailyUsage(dailyUsage) {
-    return Object.entries(dailyUsage)
-      .map(([date, usage]) => ({
-        date,
-        tokens: usage.tokens.toLocaleString(),
-        sessions: usage.sessions,
-        commands: usage.commands,
-        avgTokensPerSession: usage.sessions > 0 ? 
-          Math.round(usage.tokens / usage.sessions).toLocaleString() : '0'
-      }))
-      .sort((a, b) => new Date(b.date) - new Date(a.date));
-  }
-
-  /**
-   * 상위 명령어를 포맷팅합니다
-   * @param {Array<Object>} topCommands - 상위 명령어 목록
-   * @returns {Array<Object>} 포맷팅된 상위 명령어 목록
-   */
-  formatTopCommands(topCommands) {
-    return topCommands.map(cmd => ({
-      command: cmd.command,
-      count: cmd.count.toLocaleString(),
-      totalTokens: cmd.totalTokens.toLocaleString(),
-      avgTokens: cmd.avgTokens.toLocaleString(),
-      efficiency: cmd.avgTokens > 1000 ? 'High' : 
-                  cmd.avgTokens > 500 ? 'Medium' : 'Low'
-    }));
-  }
-
-  /**
-   * 압축 통계를 포맷팅합니다
-   * @param {Object} compressionStats - 압축 통계
-   * @returns {Object} 포맷팅된 압축 통계
-   */
-  formatCompressionStats(compressionStats) {
-    return {
-      totalOriginal: compressionStats.totalOriginal.toLocaleString(),
-      totalCompressed: compressionStats.totalCompressed.toLocaleString(),
-      totalSaved: compressionStats.totalSaved.toLocaleString(),
-      avgRatio: compressionStats.avgRatio.toFixed(1) + '%',
-      efficiency: compressionStats.avgRatio > 50 ? 'High' : 
-                  compressionStats.avgRatio > 25 ? 'Medium' : 'Low'
-    };
-  }
-
-  /**
-   * 트렌드를 포맷팅합니다
-   * @param {Object} trends - 트렌드 정보
-   * @returns {Object} 포맷팅된 트렌드 정보
-   */
-  formatTrends(trends) {
-    const trendEmoji = {
-      increasing: '📈',
-      decreasing: '📉',
-      stable: '➡️',
-      insufficient_data: '❓',
-      error: '❌'
-    };
-
-    return {
-      trend: trends.trend,
-      emoji: trendEmoji[trends.trend] || '❓',
-      change: trends.change > 0 ? `+${trends.change}%` : `${trends.change}%`,
-      recentAvg: trends.recentAvg?.toLocaleString() || '0',
-      olderAvg: trends.olderAvg?.toLocaleString() || '0',
-      description: this.getTrendDescription(trends.trend, trends.change)
-    };
-  }
-
-  /**
-   * 트렌드 설명을 생성합니다
-   * @param {string} trend - 트렌드
-   * @param {number} change - 변화율
-   * @returns {string} 트렌드 설명
-   */
-  getTrendDescription(trend, change) {
-    switch (trend) {
-      case 'increasing':
-        return `토큰 사용량이 ${Math.abs(change)}% 증가하고 있습니다`;
-      case 'decreasing':
-        return `토큰 사용량이 ${Math.abs(change)}% 감소하고 있습니다`;
-      case 'stable':
-        return '토큰 사용량이 안정적입니다';
-      case 'insufficient_data':
-        return '분석할 데이터가 부족합니다';
-      default:
-        return '트렌드 분석에 오류가 발생했습니다';
-    }
-  }
-
-  /**
-   * 보고서를 콘솔에 출력합니다
-   * @param {Object} report - 보고서 데이터
-   */
-  printReport(report) {
-    try {
-      console.log('\n=== 토큰 사용량 보고서 ===');
-      console.log(`생성일시: ${new Date(report.generatedAt).toLocaleString()}`);
-      console.log(`보고서 타입: ${report.type}`);
-      console.log(`기간: ${report.period.start} ~ ${report.period.end}`);
-      
-      if (report.formatted) {
-        console.log('\n--- 요약 ---');
-        console.log(`총 토큰: ${report.formatted.summary.totalTokens}`);
-        console.log(`총 세션: ${report.formatted.summary.totalSessions}`);
-        console.log(`세션당 평균 토큰: ${report.formatted.summary.avgTokensPerSession}`);
-        console.log(`효율성: ${report.formatted.summary.efficiency}`);
-        
-        console.log('\n--- 트렌드 ---');
-        console.log(`${report.formatted.trends.emoji} ${report.formatted.trends.description}`);
-        console.log(`변화율: ${report.formatted.trends.change}`);
-        
-        if (report.formatted.topCommands.length > 0) {
-          console.log('\n--- 상위 명령어 ---');
-          report.formatted.topCommands.slice(0, 5).forEach((cmd, idx) => {
-            console.log(`${idx + 1}. ${cmd.command}: ${cmd.totalTokens} 토큰 (${cmd.count}회)`);
-          });
-        }
-        
-        if (report.formatted.compressionStats.totalOriginal > 0) {
-          console.log('\n--- 압축 통계 ---');
-          console.log(`원본: ${report.formatted.compressionStats.totalOriginal} 토큰`);
-          console.log(`압축: ${report.formatted.compressionStats.totalCompressed} 토큰`);
-          console.log(`절약: ${report.formatted.compressionStats.totalSaved} 토큰`);
-          console.log(`압축률: ${report.formatted.compressionStats.avgRatio}`);
-        }
-      }
-      
-      console.log('\n========================\n');
-    } catch (error) {
-      console.error('보고서 출력 중 오류 발생:', error);
-    }
-  }
-
-  /**
-   * 보고서를 파일로 저장합니다
-   * @param {Object} report - 보고서 데이터
-   * @param {string} filename - 파일명
-   */
-  saveReportToFile(report, filename) {
-    try {
-      const reportDir = '.aiwf/token-data/reports';
-      if (!fs.existsSync(reportDir)) {
-        fs.mkdirSync(reportDir, { recursive: true });
-      }
-      
-      const filepath = path.join(reportDir, filename);
-      fs.writeFileSync(filepath, JSON.stringify(report, null, 2));
-      console.log(`보고서가 ${filepath}에 저장되었습니다.`);
-    } catch (error) {
-      console.error('보고서 저장 중 오류 발생:', error);
-    }
-  }
-
-  /**
-   * 리소스를 정리합니다
-   */
-  cleanup() {
-    if (this.counter) {
-      this.counter.cleanup();
-    }
-  }
-}
-
-export default TokenReporter;