aiwf 0.3.0 → 0.3.2

package/claude-code/aiwf/en/tests/test-git-integration.js

@@ -0,0 +1,164 @@
+const { describe, it, expect, beforeEach, afterEach } = require('@jest/globals');
+const { 
+  extractFeatureIds, 
+  extractCommitType, 
+  isFeatureRelatedCommit,
+  extractFeatureIdFromBranch 
+} = require('../config/commit-patterns');
+const {
+  getCommitInfo,
+  getCurrentBranch,
+  isGitRepository
+} = require('../utils/git-utils');
+const {
+  findFeatureFile,
+  readFeatureFile,
+  updateFeatureProgress
+} = require('../utils/feature-updater');
+
+describe('Git-Feature Integration Tests', () => {
+  
+  describe('커밋 메시지 파싱', () => {
+    it('다양한 형식의 Feature ID를 추출해야 함', () => {
+      const testCases = [
+        { message: 'FL001 기능 구현', expected: ['FL001'] },
+        { message: '[FL002] 버그 수정', expected: ['FL002'] },
+        { message: 'feat(FL003): 새 기능', expected: ['FL003'] },
+        { message: '업데이트 #FL004', expected: ['FL004'] },
+        { message: 'FL001, FL002 관련 수정', expected: ['FL001', 'FL002'] },
+        { message: '일반 커밋 메시지', expected: [] }
+      ];
+      
+      testCases.forEach(({ message, expected }) => {
+        const result = extractFeatureIds(message);
+        expect(result).toEqual(expected);
+      });
+    });
+    
+    it('커밋 타입을 추출해야 함', () => {
+      expect(extractCommitType('feat: 새 기능')).toBe('feat');
+      expect(extractCommitType('fix(FL001): 버그 수정')).toBe('fix');
+      expect(extractCommitType('일반 커밋')).toBeNull();
+    });
+    
+    it('Feature 관련 커밋을 식별해야 함', () => {
+      expect(isFeatureRelatedCommit('FL001 구현')).toBe(true);
+      expect(isFeatureRelatedCommit('일반 커밋')).toBe(false);
+    });
+    
+    it('브랜치 이름에서 Feature ID를 추출해야 함', () => {
+      expect(extractFeatureIdFromBranch('feature/FL001-auth')).toBe('FL001');
+      expect(extractFeatureIdFromBranch('main')).toBeNull();
+    });
+  });
+  
+  describe('Git 유틸리티', () => {
+    it('Git 저장소 확인이 작동해야 함', async () => {
+      const isRepo = await isGitRepository();
+      expect(typeof isRepo).toBe('boolean');
+    });
+    
+    it('현재 브랜치를 가져올 수 있어야 함', async () => {
+      try {
+        const branch = await getCurrentBranch();
+        expect(typeof branch).toBe('string');
+        expect(branch.length).toBeGreaterThan(0);
+      } catch (error) {
+        // Git 저장소가 아닌 경우 스킵
+        expect(error.message).toContain('Git');
+      }
+    });
+  });
+  
+  describe('Feature 업데이터', () => {
+    it('Feature 파일 경로를 올바르게 구성해야 함', async () => {
+      // findFeatureFile 함수 테스트
+      const result = await findFeatureFile('FL999'); // 존재하지 않는 Feature
+      expect(result).toBeNull();
+    });
+    
+    it('진행률 업데이트 검증', async () => {
+      // 진행률 값 범위 확인 (0-100)
+      const testValues = [-10, 0, 50, 100, 150];
+      const expectedValues = [0, 0, 50, 100, 100];
+      
+      // 실제 파일 없이 로직만 테스트
+      testValues.forEach((value, index) => {
+        const clamped = Math.min(100, Math.max(0, value));
+        expect(clamped).toBe(expectedValues[index]);
+      });
+    });
+  });
+  
+  describe('통합 시나리오', () => {
+    it('커밋 메시지 → Feature ID → 파일 업데이트 플로우', async () => {
+      // 시나리오: 커밋 메시지에서 Feature ID 추출하여 파일 업데이트
+      const commitMessage = 'feat(FL001): 사용자 인증 구현';
+      
+      // 1. Feature ID 추출
+      const featureIds = extractFeatureIds(commitMessage);
+      expect(featureIds).toContain('FL001');
+      
+      // 2. 커밋 타입 추출
+      const commitType = extractCommitType(commitMessage);
+      expect(commitType).toBe('feat');
+      
+      // 3. Feature 관련 커밋 확인
+      const isRelated = isFeatureRelatedCommit(commitMessage);
+      expect(isRelated).toBe(true);
+    });
+    
+    it('여러 Feature ID 처리', async () => {
+      const commitMessage = 'refactor: FL001, FL002, FL003 공통 로직 추출';
+      
+      const featureIds = extractFeatureIds(commitMessage);
+      expect(featureIds).toHaveLength(3);
+      expect(featureIds).toEqual(['FL001', 'FL002', 'FL003']);
+    });
+  });
+  
+  describe('엣지 케이스', () => {
+    it('잘못된 Feature ID 형식 처리', () => {
+      const invalidCases = [
+        'F001',           // FL 접두사 없음
+        'FL1',            // 숫자 부족
+        'FL0001',         // 숫자 초과
+        'fl001',          // 소문자
+        'FL00a'           // 문자 포함
+      ];
+      
+      invalidCases.forEach(message => {
+        const ids = extractFeatureIds(message);
+        expect(ids).toHaveLength(0);
+      });
+    });
+    
+    it('특수 문자가 포함된 커밋 메시지', () => {
+      const specialCases = [
+        { message: 'feat(FL001): 한글 지원 추가 🎉', expected: ['FL001'] },
+        { message: 'fix: FL002 & FL003 동시 수정', expected: ['FL002', 'FL003'] },
+        { message: 'docs: [FL004] README 업데이트', expected: ['FL004'] }
+      ];
+      
+      specialCases.forEach(({ message, expected }) => {
+        const result = extractFeatureIds(message);
+        expect(result).toEqual(expected);
+      });
+    });
+  });
+});
+
+// 실행 예시를 위한 테스트 헬퍼
+if (require.main === module) {
+  console.log('Git-Feature Integration 테스트 실행 중...');
+  
+  // 간단한 검증
+  const testMessage = 'feat(FL001): 테스트 커밋';
+  const ids = extractFeatureIds(testMessage);
+  console.log(`Feature IDs: ${ids.join(', ')}`);
+  
+  const type = extractCommitType(testMessage);
+  console.log(`Commit Type: ${type}`);
+  
+  console.log('테스트 완료!');
+}

package/claude-code/aiwf/en/tests/token-tracking.test.js

@@ -0,0 +1,537 @@
+/**
+ * 토큰 추적 시스템 테스트 스위트
+ */
+import { TokenCounter } from '../utils/token-counter.js';
+import { TokenTracker } from '../utils/token-tracker.js';
+import { TokenStorage } from '../utils/token-storage.js';
+import { TokenReporter } from '../utils/token-reporter.js';
+import { TokenMonitor } from '../utils/token-monitor.js';
+import { TokenTrackingCommands } from '../commands/token-tracking.js';
+import fs from 'fs';
+import path from 'path';
+
+describe('Token Tracking System', () => {
+  let testDir;
+  let counter;
+  let tracker;
+  let storage;
+  let reporter;
+  let monitor;
+  let commands;
+
+  beforeEach(() => {
+    // 테스트용 임시 디렉토리 생성
+    testDir = path.join(process.cwd(), 'test-temp', Date.now().toString());
+    if (!fs.existsSync(testDir)) {
+      fs.mkdirSync(testDir, { recursive: true });
+    }
+    
+    // 테스트 인스턴스 생성
+    counter = new TokenCounter();
+    tracker = new TokenTracker(path.join(testDir, 'sessions'));
+    storage = new TokenStorage(path.join(testDir, 'token-data'));
+    reporter = new TokenReporter();
+    monitor = new TokenMonitor();
+    commands = new TokenTrackingCommands();
+  });
+
+  afterEach(() => {
+    // 테스트 후 정리
+    try {
+      if (counter) counter.cleanup();
+      if (tracker) tracker.cleanup();
+      if (monitor) monitor.stopMonitoring();
+      if (commands) commands.cleanup();
+      
+      // 임시 디렉토리 삭제
+      if (fs.existsSync(testDir)) {
+        fs.rmSync(testDir, { recursive: true, force: true });
+      }
+    } catch (error) {
+      console.error('테스트 정리 중 오류:', error);
+    }
+  });
+
+  describe('TokenCounter', () => {
+    test('should count tokens correctly', () => {
+      const testText = 'Hello, world! This is a test.';
+      const tokens = counter.countTokens(testText);
+      
+      expect(tokens).toBeGreaterThan(0);
+      expect(typeof tokens).toBe('number');
+    });
+
+    test('should handle empty text', () => {
+      expect(counter.countTokens('')).toBe(0);
+      expect(counter.countTokens(null)).toBe(0);
+      expect(counter.countTokens(undefined)).toBe(0);
+    });
+
+    test('should count file tokens', () => {
+      const testFile = path.join(testDir, 'test.md');
+      const testContent = '# Test\n\nThis is a test file.';
+      
+      fs.writeFileSync(testFile, testContent);
+      
+      const tokens = counter.countFileTokens(testFile);
+      expect(tokens).toBeGreaterThan(0);
+    });
+
+    test('should handle non-existent file', () => {
+      const tokens = counter.countFileTokens('non-existent.md');
+      expect(tokens).toBe(0);
+    });
+
+    test('should analyze token distribution', () => {
+      const testContent = `# Section 1
+This is the first section.
+
+## Section 2
+This is the second section.
+
+### Section 3
+This is the third section.`;
+
+      const distribution = counter.analyzeTokenDistribution(testContent);
+      
+      expect(Array.isArray(distribution)).toBe(true);
+      expect(distribution.length).toBeGreaterThan(0);
+      
+      distribution.forEach(section => {
+        expect(section).toHaveProperty('name');
+        expect(section).toHaveProperty('tokens');
+        expect(section).toHaveProperty('percentage');
+      });
+    });
+  });
+
+  describe('TokenTracker', () => {
+    test('should track command execution', () => {
+      const result = tracker.trackCommand('test-command', 'input text', 'output text');
+      
+      expect(result).toBeTruthy();
+      expect(result.command).toBe('test-command');
+      expect(result.inputTokens).toBeGreaterThan(0);
+      expect(result.outputTokens).toBeGreaterThan(0);
+      expect(result.totalTokens).toBeGreaterThan(0);
+    });
+
+    test('should track compression', () => {
+      const originalTokens = 1000;
+      const compressedTokens = 600;
+      
+      tracker.trackCompression(originalTokens, compressedTokens);
+      
+      expect(tracker.usage.total).toBe(originalTokens);
+      expect(tracker.usage.compressed).toBe(compressedTokens);
+      expect(tracker.usage.saved).toBe(400);
+      expect(tracker.usage.ratio).toBe(40);
+    });
+
+    test('should generate session report', () => {
+      // 몇 개의 명령어 실행을 시뮬레이션
+      tracker.trackCommand('cmd1', 'input1', 'output1');
+      tracker.trackCommand('cmd2', 'input2', 'output2');
+      tracker.trackCommand('cmd3', 'input3', 'output3');
+      
+      const report = tracker.generateReport();
+      
+      expect(report).toBeTruthy();
+      expect(report.sessionId).toBeDefined();
+      expect(report.totalCommands).toBe(3);
+      expect(report.totalTokens).toBeGreaterThan(0);
+    });
+
+    test('should get session stats', () => {
+      const stats = tracker.getSessionStats();
+      
+      expect(stats).toBeTruthy();
+      expect(stats.sessionId).toBeDefined();
+      expect(stats.totalTokens).toBeGreaterThanOrEqual(0);
+      expect(stats.commandCount).toBeGreaterThanOrEqual(0);
+    });
+  });
+
+  describe('TokenStorage', () => {
+    test('should record session usage', () => {
+      const sessionData = {
+        sessionId: 'test-session',
+        totalTokens: 1000,
+        commands: [
+          { command: 'test-cmd', totalTokens: 500 },
+          { command: 'test-cmd2', totalTokens: 500 }
+        ],
+        compressions: [
+          { originalTokens: 1000, compressedTokens: 600, savedTokens: 400 }
+        ]
+      };
+      
+      storage.recordSessionUsage(sessionData);
+      
+      expect(storage.data.totalTokens).toBe(1000);
+      expect(storage.data.sessionsCount).toBe(1);
+    });
+
+    test('should generate usage report', () => {
+      // 테스트 데이터 설정
+      const today = new Date().toISOString().split('T')[0];
+      storage.data.dailyUsage[today] = {
+        tokens: 1000,
+        sessions: 5,
+        commands: 20
+      };
+      
+      const report = storage.generateUsageReport('daily');
+      
+      expect(report).toBeTruthy();
+      expect(report.type).toBe('daily');
+      expect(report.summary).toBeDefined();
+      expect(report.dailyUsage).toBeDefined();
+    });
+
+    test('should check thresholds', () => {
+      const thresholds = {
+        dailyTokenLimit: 500,
+        warningThreshold: 80
+      };
+      
+      // 임계값을 초과하는 데이터 설정
+      const today = new Date().toISOString().split('T')[0];
+      storage.data.dailyUsage[today] = {
+        tokens: 1000,
+        sessions: 5
+      };
+      
+      const violations = storage.checkThresholds(thresholds);
+      
+      expect(Array.isArray(violations)).toBe(true);
+      expect(violations.length).toBeGreaterThan(0);
+    });
+  });
+
+  describe('TokenReporter', () => {
+    test('should generate project analysis report', () => {
+      // 임시 프로젝트 구조 생성
+      const projectDir = path.join(testDir, 'project');
+      const aiwfDir = path.join(projectDir, '.aiwf', '03_SPRINTS');
+      
+      fs.mkdirSync(aiwfDir, { recursive: true });
+      fs.writeFileSync(path.join(aiwfDir, 'test.md'), '# Test\n\nThis is a test file.');
+      
+      const report = reporter.generateProjectAnalysisReport(projectDir);
+      
+      expect(report).toBeTruthy();
+      expect(report.analysis).toBeDefined();
+      expect(report.analysis.totalTokens).toBeGreaterThan(0);
+    });
+
+    test('should identify compression opportunities', () => {
+      const directoryBreakdown = {
+        '.aiwf/03_SPRINTS': { tokens: 10000, files: [] },
+        '.aiwf/05_COMPLETED_TASKS': { tokens: 5000, files: [] }
+      };
+      
+      const opportunities = reporter.identifyCompressionOpportunities(directoryBreakdown);
+      
+      expect(Array.isArray(opportunities)).toBe(true);
+      expect(opportunities.length).toBeGreaterThan(0);
+    });
+  });
+
+  describe('TokenMonitor', () => {
+    test('should enable/disable monitoring', () => {
+      monitor.setEnabled(true);
+      expect(monitor.isEnabled).toBe(true);
+      
+      monitor.setEnabled(false);
+      expect(monitor.isEnabled).toBe(false);
+    });
+
+    test('should set thresholds', () => {
+      const newThresholds = {
+        dailyTokenLimit: 5000,
+        warningThreshold: 75
+      };
+      
+      monitor.setThresholds(newThresholds);
+      
+      expect(monitor.thresholds.dailyTokenLimit).toBe(5000);
+      expect(monitor.thresholds.warningThreshold).toBe(75);
+    });
+
+    test('should create alerts', () => {
+      const violation = {
+        type: 'test_violation',
+        message: 'Test violation message',
+        threshold: 100,
+        current: 150
+      };
+      
+      monitor.createAlert(violation);
+      
+      expect(monitor.alerts.length).toBeGreaterThan(0);
+      expect(monitor.alerts[0].type).toBe('test_violation');
+    });
+
+    test('should acknowledge alerts', () => {
+      const violation = {
+        type: 'test_violation',
+        message: 'Test violation message',
+        threshold: 100,
+        current: 150
+      };
+      
+      monitor.createAlert(violation);
+      const alertId = monitor.alerts[0].id;
+      
+      monitor.acknowledgeAlert(alertId);
+      
+      expect(monitor.alerts[0].acknowledged).toBe(true);
+    });
+  });
+
+  describe('TokenTrackingCommands', () => {
+    test('should count tokens through command interface', async () => {
+      const result = await commands.countTokens({ text: 'Hello, world!' });
+      
+      expect(result).toBeTruthy();
+      expect(result.type).toBe('text');
+      expect(result.tokens).toBeGreaterThan(0);
+    });
+
+    test('should track command execution', async () => {
+      const result = await commands.trackCommand({
+        command: 'test-command',
+        input: 'input text',
+        output: 'output text'
+      });
+      
+      expect(result).toBeTruthy();
+      expect(result.command).toBe('test-command');
+      expect(result.totalTokens).toBeGreaterThan(0);
+    });
+
+    test('should generate session report', async () => {
+      // 명령어 실행 시뮬레이션
+      await commands.trackCommand({
+        command: 'test-command',
+        input: 'input',
+        output: 'output'
+      });
+      
+      const report = await commands.generateSessionReport();
+      
+      expect(report).toBeTruthy();
+      expect(report.sessionId).toBeDefined();
+      expect(report.totalCommands).toBeGreaterThan(0);
+    });
+
+    test('should track compression', async () => {
+      const result = await commands.trackCompression({
+        originalTokens: 1000,
+        compressedTokens: 600
+      });
+      
+      expect(result).toBeTruthy();
+      expect(result.savedTokens).toBe(400);
+      expect(result.compressionRatio).toBe('40.00');
+    });
+
+    test('should setup monitoring', async () => {
+      const result = await commands.setupMonitoring({
+        enable: true,
+        thresholds: { dailyTokenLimit: 5000 }
+      });
+      
+      expect(result.success).toBe(true);
+      expect(result.status).toBeDefined();
+    });
+
+    test('should manage alerts', async () => {
+      const result = await commands.manageAlerts({ action: 'list' });
+      
+      expect(Array.isArray(result)).toBe(true);
+    });
+  });
+
+  describe('Performance Tests', () => {
+    test('should count tokens efficiently for large text', () => {
+      const largeText = 'This is a test. '.repeat(1000);
+      
+      const startTime = performance.now();
+      const tokens = counter.countTokens(largeText);
+      const endTime = performance.now();
+      
+      expect(tokens).toBeGreaterThan(0);
+      expect(endTime - startTime).toBeLessThan(1000); // Should complete within 1 second
+    });
+
+    test('should handle multiple concurrent tracking operations', async () => {
+      const operations = [];
+      
+      for (let i = 0; i < 100; i++) {
+        operations.push(
+          commands.trackCommand({
+            command: `test-command-${i}`,
+            input: `input ${i}`,
+            output: `output ${i}`
+          })
+        );
+      }
+      
+      const results = await Promise.all(operations);
+      
+      expect(results.length).toBe(100);
+      results.forEach(result => {
+        expect(result).toBeTruthy();
+        expect(result.totalTokens).toBeGreaterThan(0);
+      });
+    });
+
+    test('should compress large directory efficiently', () => {
+      // 대용량 디렉토리 시뮬레이션
+      const testFiles = [];
+      for (let i = 0; i < 10; i++) {
+        const fileName = path.join(testDir, `test-${i}.md`);
+        const content = `# Test ${i}\n\n${'This is test content. '.repeat(100)}`;
+        fs.writeFileSync(fileName, content);
+        testFiles.push(fileName);
+      }
+      
+      const startTime = performance.now();
+      const tokens = counter.countDirectoryTokens(testDir);
+      const endTime = performance.now();
+      
+      expect(tokens).toBeGreaterThan(0);
+      expect(endTime - startTime).toBeLessThan(5000); // Should complete within 5 seconds
+      
+      // 파일 정리
+      testFiles.forEach(file => {
+        if (fs.existsSync(file)) {
+          fs.unlinkSync(file);
+        }
+      });
+    });
+  });
+
+  describe('Error Handling', () => {
+    test('should handle file system errors gracefully', () => {
+      const invalidPath = '/invalid/path/file.md';
+      const tokens = counter.countFileTokens(invalidPath);
+      
+      expect(tokens).toBe(0);
+    });
+
+    test('should handle invalid token counting input', () => {
+      expect(counter.countTokens(null)).toBe(0);
+      expect(counter.countTokens(undefined)).toBe(0);
+      expect(counter.countTokens(123)).toBe(0);
+      expect(counter.countTokens({})).toBe(0);
+    });
+
+    test('should handle storage errors gracefully', () => {
+      const invalidSessionData = null;
+      
+      expect(() => {
+        storage.recordSessionUsage(invalidSessionData);
+      }).not.toThrow();
+    });
+
+    test('should handle monitoring errors gracefully', () => {
+      const invalidThresholds = null;
+      
+      expect(() => {
+        monitor.setThresholds(invalidThresholds);
+      }).not.toThrow();
+    });
+  });
+
+  describe('Integration Tests', () => {
+    test('should work end-to-end', async () => {
+      // 1. 토큰 카운팅
+      const countResult = await commands.countTokens({ text: 'Hello, world!' });
+      expect(countResult).toBeTruthy();
+      
+      // 2. 명령어 추적
+      const trackResult = await commands.trackCommand({
+        command: 'test-command',
+        input: 'input',
+        output: 'output'
+      });
+      expect(trackResult).toBeTruthy();
+      
+      // 3. 압축 추적
+      const compressionResult = await commands.trackCompression({
+        originalTokens: 1000,
+        compressedTokens: 600
+      });
+      expect(compressionResult).toBeTruthy();
+      
+      // 4. 세션 보고서 생성
+      const sessionReport = await commands.generateSessionReport();
+      expect(sessionReport).toBeTruthy();
+      
+      // 5. 모니터링 설정
+      const monitoringResult = await commands.setupMonitoring({
+        enable: true,
+        thresholds: { dailyTokenLimit: 5000 }
+      });
+      expect(monitoringResult.success).toBe(true);
+      
+      // 6. 시스템 상태 확인
+      const systemStatus = await commands.getSystemStatus();
+      expect(systemStatus).toBeTruthy();
+    });
+  });
+});
+
+// 성능 벤치마크 함수
+export function runPerformanceBenchmark() {
+  console.log('=== Token Tracking System Performance Benchmark ===');
+  
+  const counter = new TokenCounter();
+  const results = {
+    tokenCounting: [],
+    fileProcessing: [],
+    directoryAnalysis: []
+  };
+  
+  // 토큰 카운팅 성능 테스트
+  const testTexts = [
+    'Short text',
+    'Medium length text. '.repeat(100),
+    'Very long text. '.repeat(1000)
+  ];
+  
+  testTexts.forEach((text, index) => {
+    const startTime = performance.now();
+    const tokens = counter.countTokens(text);
+    const endTime = performance.now();
+    
+    results.tokenCounting.push({
+      textLength: text.length,
+      tokens,
+      processingTime: endTime - startTime,
+      tokensPerSecond: tokens / ((endTime - startTime) / 1000)
+    });
+  });
+  
+  // 결과 출력
+  console.log('\n--- Token Counting Performance ---');
+  results.tokenCounting.forEach((result, index) => {
+    console.log(`Test ${index + 1}:`);
+    console.log(`  Text Length: ${result.textLength.toLocaleString()} characters`);
+    console.log(`  Tokens: ${result.tokens.toLocaleString()}`);
+    console.log(`  Processing Time: ${result.processingTime.toFixed(2)}ms`);
+    console.log(`  Tokens/Second: ${result.tokensPerSecond.toFixed(0)}`);
+  });
+  
+  // 정리
+  counter.cleanup();
+  
+  console.log('\n=== Benchmark Complete ===');
+  
+  return results;
+}
+
+export default runPerformanceBenchmark;