aiwf 0.3.7 → 0.3.12

package/scripts/update-file-lists.js

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+
+/**
+ * AIWF 파일 목록 자동 업데이트 스크립트
+ * 
+ * 이 스크립트는 claude-code 디렉토리를 스캔하여
+ * src/config/file-lists.js 파일을 자동으로 업데이트합니다.
+ * 
+ * 사용법:
+ *   npm run update:file-lists
+ *   npm run update:file-lists -- --dry-run  # 미리보기만
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT_DIR = path.resolve(__dirname, '..');
+
+// 스캔할 디렉토리 경로들
+const SCAN_PATHS = {
+  commands: {
+    en: path.join(ROOT_DIR, 'claude-code/aiwf/en/.claude/commands/aiwf'),
+    ko: path.join(ROOT_DIR, 'claude-code/aiwf/ko/.claude/commands/aiwf')
+  },
+  globalRules: path.join(ROOT_DIR, 'rules/global'),
+  manualRules: path.join(ROOT_DIR, 'rules/manual')
+};
+
+const OUTPUT_FILE = path.join(ROOT_DIR, 'src/config/file-lists.js');
+
+/**
+ * 디렉토리에서 .md 파일들을 스캔
+ */
+async function scanDirectory(dirPath) {
+  try {
+    const files = await fs.readdir(dirPath);
+    return files
+      .filter(file => file.endsWith('.md'))
+      .sort();
+  } catch (error) {
+    console.warn(chalk.yellow(`Warning: Could not scan directory ${dirPath}: ${error.message}`));
+    return [];
+  }
+}
+
+/**
+ * 두 언어 버전에서 공통으로 존재하는 파일들만 추출
+ */
+async function getCommonCommandFiles() {
+  const [enFiles, koFiles] = await Promise.all([
+    scanDirectory(SCAN_PATHS.commands.en),
+    scanDirectory(SCAN_PATHS.commands.ko)
+  ]);
+
+  // 두 언어에 모두 존재하는 파일들만 포함
+  const commonFiles = enFiles.filter(file => koFiles.includes(file));
+  
+  // 언어별 특수 파일들도 포함 (선택적)
+  const enOnlyFiles = enFiles.filter(file => !koFiles.includes(file));
+  const koOnlyFiles = koFiles.filter(file => !enFiles.includes(file));
+
+  console.log(chalk.blue('📊 Command Files Analysis:'));
+  console.log(`  Common files: ${chalk.green(commonFiles.length)}`);
+  console.log(`  English only: ${chalk.yellow(enOnlyFiles.length)} ${enOnlyFiles.length > 0 ? `(${enOnlyFiles.join(', ')})` : ''}`);
+  console.log(`  Korean only: ${chalk.yellow(koOnlyFiles.length)} ${koOnlyFiles.length > 0 ? `(${koOnlyFiles.join(', ')})` : ''}`);
+
+  // 공통 파일들 + 언어별 특수 파일들을 모두 포함
+  return [...commonFiles, ...enOnlyFiles, ...koOnlyFiles].sort();
+}
+
+/**
+ * file-lists.js 파일 생성
+ */
+async function generateFileListsContent(commandFiles, globalRulesFiles, manualRulesFiles) {
+  const template = `/**
+ * AIWF 설치 시 다운로드할 파일 목록들
+ * 이 파일은 GitHub에서 다운로드할 파일들의 사전 정의된 목록을 포함합니다.
+ * 
+ * ⚠️  이 파일은 자동 생성됩니다. 수동으로 편집하지 마세요!
+ * 업데이트하려면: npm run update:file-lists
+ * 
+ * Generated at: ${new Date().toISOString()}
+ */
+
+// Claude Code 명령어 파일 목록 (한국어와 영어 공통)
+export const COMMAND_FILES = [
+${commandFiles.map(file => `  '${file}'`).join(',\n')}
+];
+
+// 글로벌 룰 파일 목록
+export const GLOBAL_RULES_FILES = [
+${globalRulesFiles.map(file => `  '${file}'`).join(',\n')}
+];
+
+// 수동 룰 파일 목록
+export const MANUAL_RULES_FILES = [
+${manualRulesFiles.map(file => `  '${file}'`).join(',\n')}
+];
+
+// 템플릿 파일 목록 (향후 추가 예정)
+export const TEMPLATE_FILES = [
+  // 템플릿 파일들이 추가되면 여기에 나열
+];
+
+// 프롬프트 파일 목록 (향후 추가 예정)
+export const PROMPT_FILES = [
+  // 프롬프트 파일들이 추가되면 여기에 나열
+];
+
+// 모든 파일 목록을 하나의 객체로 export
+export const FILE_LISTS = {
+  COMMAND_FILES,
+  GLOBAL_RULES_FILES,
+  MANUAL_RULES_FILES,
+  TEMPLATE_FILES,
+  PROMPT_FILES
+};
+
+// 개별 카테고리별 파일 수 정보
+export const FILE_COUNTS = {
+  commands: COMMAND_FILES.length,
+  globalRules: GLOBAL_RULES_FILES.length,
+  manualRules: MANUAL_RULES_FILES.length,
+  templates: TEMPLATE_FILES.length,
+  prompts: PROMPT_FILES.length,
+  total: COMMAND_FILES.length + GLOBAL_RULES_FILES.length + MANUAL_RULES_FILES.length + TEMPLATE_FILES.length + PROMPT_FILES.length
+};
+
+/**
+ * 특정 언어의 파일 존재 여부 확인을 위한 헬퍼 함수들
+ */
+
+/**
+ * 언어별로 존재하지 않을 수 있는 파일들을 필터링
+ * @param {Array<string>} fileList - 원본 파일 목록
+ * @param {string} language - 언어 코드 (ko, en)
+ * @returns {Array<string>} 필터링된 파일 목록
+ */
+export function filterFilesByLanguage(fileList, language) {
+  // 일부 파일들은 특정 언어에만 존재할 수 있음
+  const languageSpecificFiles = {
+    ko: [
+      // 한국어에만 있는 파일들 (현재는 없음)
+    ],
+    en: [
+      // 영어에만 있는 파일들 (현재는 없음)
+    ]
+  };
+  
+  // 현재는 모든 파일이 두 언어 모두 존재한다고 가정
+  return fileList;
+}
+
+/**
+ * 파일 목록 업데이트를 위한 헬퍼 함수
+ * 실제 디렉토리를 스캔하여 파일 목록을 업데이트할 수 있는 함수
+ */
+export function getLatestFileList() {
+  // 이 함수는 향후 자동 업데이트 기능 구현 시 사용
+  return {
+    commands: COMMAND_FILES,
+    globalRules: GLOBAL_RULES_FILES,
+    manualRules: MANUAL_RULES_FILES,
+    templates: TEMPLATE_FILES,
+    prompts: PROMPT_FILES
+  };
+}`;
+
+  return template;
+}
+
+/**
+ * 기존 파일과 비교하여 변경사항 확인
+ */
+async function compareWithExisting(newContent) {
+  try {
+    const existingContent = await fs.readFile(OUTPUT_FILE, 'utf-8');
+    
+    // 생성 시간 라인 제외하고 비교 (Generated at: 부분)
+    const normalizeContent = (content) => {
+      return content.replace(/Generated at: .*$/m, 'Generated at: <timestamp>');
+    };
+    
+    return normalizeContent(existingContent) === normalizeContent(newContent);
+  } catch {
+    return false; // 파일이 없으면 변경사항이 있다고 간주
+  }
+}
+
+/**
+ * 메인 실행 함수
+ */
+async function main() {
+  const isDryRun = process.argv.includes('--dry-run');
+  const isVerbose = process.argv.includes('--verbose');
+
+  console.log(chalk.blue.bold('🔄 AIWF File Lists Update Script'));
+  console.log(chalk.gray(`Scanning directories and updating file lists...\n`));
+
+  try {
+    // 각 디렉토리 스캔
+    const [commandFiles, globalRulesFiles, manualRulesFiles] = await Promise.all([
+      getCommonCommandFiles(),
+      scanDirectory(SCAN_PATHS.globalRules),
+      scanDirectory(SCAN_PATHS.manualRules)
+    ]);
+
+    // 통계 출력
+    console.log(chalk.blue('📊 Scan Results:'));
+    console.log(`  Command files: ${chalk.green(commandFiles.length)}`);
+    console.log(`  Global rules: ${chalk.green(globalRulesFiles.length)}`);
+    console.log(`  Manual rules: ${chalk.green(manualRulesFiles.length)}`);
+    console.log(`  Total files: ${chalk.green(commandFiles.length + globalRulesFiles.length + manualRulesFiles.length)}`);
+
+    if (isVerbose) {
+      console.log(chalk.gray('\n📝 Detailed file lists:'));
+      console.log(chalk.gray('Commands:'), commandFiles.join(', '));
+      console.log(chalk.gray('Global rules:'), globalRulesFiles.join(', '));
+      console.log(chalk.gray('Manual rules:'), manualRulesFiles.join(', '));
+    }
+
+    // 새 내용 생성
+    const newContent = await generateFileListsContent(commandFiles, globalRulesFiles, manualRulesFiles);
+
+    // 변경사항 확인
+    const hasChanges = !(await compareWithExisting(newContent));
+
+    if (!hasChanges) {
+      console.log(chalk.green('\n✅ File lists are already up to date!'));
+      return;
+    }
+
+    if (isDryRun) {
+      console.log(chalk.yellow('\n🔍 Dry run mode - Changes detected but not saved:'));
+      console.log(chalk.gray(`Would update: ${OUTPUT_FILE}`));
+      console.log(chalk.gray(`Content length: ${newContent.length} characters`));
+      return;
+    }
+
+    // 파일 업데이트
+    await fs.writeFile(OUTPUT_FILE, newContent, 'utf-8');
+
+    console.log(chalk.green('\n✅ Successfully updated file lists!'));
+    console.log(chalk.gray(`Updated: ${OUTPUT_FILE}`));
+    console.log(chalk.blue('\n💡 Next steps:'));
+    console.log(chalk.gray('  1. Review the changes: git diff src/config/file-lists.js'));
+    console.log(chalk.gray('  2. Test the changes: npm test'));
+    console.log(chalk.gray('  3. Commit the changes: git add . && git commit -m "update: refresh file lists"'));
+
+  } catch (error) {
+    console.error(chalk.red('\n❌ Error updating file lists:'));
+    console.error(chalk.red(error.message));
+    console.error(chalk.gray(error.stack));
+    process.exit(1);
+  }
+}
+
+// 스크립트가 직접 실행될 때만 main 함수 호출
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main();
+}
+
+export { main as updateFileLists };

package/src/cli/checkpoint-cli.js

@@ -0,0 +1,417 @@
+#!/usr/bin/env node
+
+/**
+ * AIWF 체크포인트 CLI
+ * YOLO 모드 체크포인트 관리를 위한 명령어 인터페이스
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { CheckpointManager } from '../utils/checkpoint-manager.js';
+import fs from 'fs/promises';
+import path from 'path';
+
+const program = new Command();
+
+program
+  .name('aiwf-checkpoint')
+  .description('AIWF 체크포인트 관리 도구')
+  .version('0.3.12');
+
+// 프로젝트 루트 찾기 헬퍼
+async function findProjectRoot(startDir = process.cwd()) {
+  let currentDir = startDir;
+  
+  while (currentDir !== path.parse(currentDir).root) {
+    try {
+      await fs.access(path.join(currentDir, '.aiwf'));
+      return currentDir;
+    } catch {
+      currentDir = path.dirname(currentDir);
+    }
+  }
+  
+  throw new Error('.aiwf 디렉토리를 찾을 수 없습니다. AIWF 프로젝트 내에서 실행해주세요.');
+}
+
+// 체크포인트 목록 보기
+program
+  .command('list')
+  .alias('ls')
+  .description('사용 가능한 체크포인트 목록')
+  .option('--limit <n>', '표시할 체크포인트 수 제한', '10')
+  .action(async (options) => {
+    try {
+      const projectRoot = await findProjectRoot();
+      const manager = new CheckpointManager(projectRoot);
+      
+      console.log(chalk.bold('📊 체크포인트 목록:'));
+      console.log('');
+      
+      const checkpoints = await manager.listCheckpoints();
+      
+      if (checkpoints.length === 0) {
+        console.log(chalk.yellow('📭 체크포인트가 없습니다.'));
+        console.log('');
+        console.log(chalk.gray('YOLO 모드를 실행하면 자동으로 체크포인트가 생성됩니다.'));
+        return;
+      }
+      
+      const limit = parseInt(options.limit);
+      const limitedCheckpoints = checkpoints.slice(0, limit);
+      
+      for (const cp of limitedCheckpoints) {
+        const typeIcon = cp.type === 'session_start' ? '🚀' :
+                        cp.type === 'task_complete' ? '✅' :
+                        cp.type === 'sprint_complete' ? '🎯' :
+                        cp.type === 'session_end' ? '🏁' :
+                        cp.type === 'manual' ? '📝' : '🔄';
+        
+        const timeAgo = getTimeAgo(new Date(cp.created));
+        
+        console.log(`${typeIcon} ${chalk.cyan(cp.id)} - ${chalk.yellow(cp.type)}`);
+        console.log(`    생성: ${chalk.gray(timeAgo)}`);
+        console.log(`    태스크: ${chalk.blue(cp.tasks_completed)}개 완료`);
+        
+        if (cp.metadata && Object.keys(cp.metadata).length > 0) {
+          console.log(`    메타: ${chalk.gray(JSON.stringify(cp.metadata))}`);
+        }
+        console.log('');
+      }
+      
+      if (checkpoints.length > limit) {
+        console.log(chalk.gray(`... 더 많은 체크포인트가 있습니다 (총 ${checkpoints.length}개)`));
+        console.log(chalk.blue(`모든 체크포인트를 보려면: aiwf-checkpoint list --limit ${checkpoints.length}`));
+      }
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 체크포인트 목록 조회 실패:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// 체크포인트에서 복구
+program
+  .command('restore <checkpointId>')
+  .description('체크포인트에서 복구')
+  .option('--dry-run', '실제 복구 없이 미리보기만')
+  .action(async (checkpointId, options) => {
+    try {
+      const projectRoot = await findProjectRoot();
+      const manager = new CheckpointManager(projectRoot);
+      await manager.initialize();
+      
+      console.log(chalk.blue(`🔄 체크포인트 ${checkpointId}에서 복구 중...`));
+      console.log('');
+      
+      if (options.dryRun) {
+        console.log(chalk.yellow('🔍 드라이런 모드: 실제 복구는 수행하지 않습니다.'));
+        console.log('');
+      }
+      
+      const result = await manager.restoreFromCheckpoint(checkpointId);
+      
+      if (result.success) {
+        console.log(chalk.green('✅ 체크포인트 복구 성공!'));
+        console.log('');
+        console.log(chalk.bold('📊 복구된 세션 정보:'));
+        console.log(`  세션 ID: ${chalk.cyan(result.checkpoint.state_snapshot.session_id)}`);
+        console.log(`  스프린트: ${chalk.blue(result.checkpoint.state_snapshot.sprint_id || 'N/A')}`);
+        console.log(`  모드: ${chalk.yellow(result.checkpoint.state_snapshot.mode || 'N/A')}`);
+        console.log('');
+        
+        console.log(chalk.bold('🔄 재개 가능한 작업:'));
+        if (result.tasks_to_resume.current) {
+          console.log(`  현재 태스크: ${chalk.cyan(result.tasks_to_resume.current)}`);
+        }
+        console.log(`  완료된 태스크: ${chalk.blue(result.tasks_to_resume.completed.length)}개`);
+        console.log(`  다음 작업: ${chalk.gray(result.tasks_to_resume.next_task_hint)}`);
+        console.log('');
+        
+        if (result.checkpoint.git_info) {
+          console.log(chalk.bold('📋 Git 정보:'));
+          console.log(`  브랜치: ${chalk.cyan(result.checkpoint.git_info.branch)}`);
+          console.log(`  커밋: ${chalk.gray(result.checkpoint.git_info.commit.substring(0, 8))}`);
+          console.log('');
+        }
+        
+        console.log(chalk.green('🚀 복구 완료! YOLO 모드를 다시 실행할 수 있습니다.'));
+        
+      } else {
+        console.error(chalk.red('❌ 체크포인트 복구 실패'));
+      }
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 체크포인트 복구 실패:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// 체크포인트 생성
+program
+  .command('create [message]')
+  .description('수동 체크포인트 생성')
+  .action(async (message) => {
+    try {
+      const projectRoot = await findProjectRoot();
+      const manager = new CheckpointManager(projectRoot);
+      await manager.initialize();
+      
+      const checkpointMessage = message || '수동 체크포인트';
+      
+      console.log(chalk.blue('📝 수동 체크포인트 생성 중...'));
+      
+      const checkpointId = await manager.createCheckpoint('manual', {
+        message: checkpointMessage,
+        created_by: 'user'
+      });
+      
+      console.log(chalk.green('✅ 체크포인트 생성 완료!'));
+      console.log('');
+      console.log(`체크포인트 ID: ${chalk.cyan(checkpointId)}`);
+      console.log(`메시지: ${chalk.yellow(checkpointMessage)}`);
+      console.log('');
+      console.log(chalk.gray('이 체크포인트에서 복구하려면:'));
+      console.log(chalk.blue(`aiwf-checkpoint restore ${checkpointId}`));
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 체크포인트 생성 실패:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// 현재 상태 보기
+program
+  .command('status')
+  .description('현재 YOLO 세션 상태')
+  .action(async () => {
+    try {
+      const projectRoot = await findProjectRoot();
+      const manager = new CheckpointManager(projectRoot);
+      await manager.loadState();
+      
+      console.log(chalk.bold('📊 YOLO 세션 상태:'));
+      console.log('');
+      
+      if (!manager.currentState.session_id) {
+        console.log(chalk.yellow('📭 활성 YOLO 세션이 없습니다.'));
+        console.log('');
+        console.log(chalk.gray('YOLO 모드를 시작하려면:'));
+        console.log(chalk.blue('/project:aiwf:yolo'));
+        return;
+      }
+      
+      console.log(`세션 ID: ${chalk.cyan(manager.currentState.session_id)}`);
+      console.log(`시작 시간: ${chalk.gray(new Date(manager.currentState.started_at).toLocaleString())}`);
+      console.log(`스프린트: ${chalk.blue(manager.currentState.sprint_id || 'N/A')}`);
+      console.log(`모드: ${chalk.yellow(manager.currentState.mode || 'N/A')}`);
+      console.log('');
+      
+      console.log(chalk.bold('📈 진행 상황:'));
+      console.log(`  완료된 태스크: ${chalk.green(manager.currentState.completed_tasks.length)}개`);
+      console.log(`  실패한 태스크: ${chalk.red(manager.currentState.metrics.failed_tasks)}개`);
+      console.log(`  건너뛴 태스크: ${chalk.yellow(manager.currentState.metrics.skipped_tasks)}개`);
+      
+      if (manager.currentState.current_task) {
+        console.log(`  현재 태스크: ${chalk.cyan(manager.currentState.current_task.id)}`);
+        console.log(`  시도 횟수: ${chalk.blue(manager.currentState.current_task.attempts)}회`);
+      }
+      console.log('');
+      
+      if (manager.currentState.metrics.total_time > 0) {
+        console.log(chalk.bold('⏱️ 성능 지표:'));
+        console.log(`  총 실행 시간: ${chalk.blue(manager.formatDuration(manager.currentState.metrics.total_time))}`);
+        console.log(`  평균 태스크 시간: ${chalk.blue(manager.formatDuration(manager.currentState.metrics.avg_task_time))}`);
+        console.log('');
+      }
+      
+      console.log(chalk.bold('📊 체크포인트:'));
+      console.log(`  생성된 체크포인트: ${chalk.blue(manager.currentState.checkpoints.length)}개`);
+      
+      if (manager.currentState.checkpoints.length > 0) {
+        const latest = manager.currentState.checkpoints[manager.currentState.checkpoints.length - 1];
+        console.log(`  최근 체크포인트: ${chalk.cyan(latest.id)} (${chalk.gray(latest.type)})`);
+      }
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 상태 확인 실패:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// 체크포인트 정리
+program
+  .command('clean')
+  .description('오래된 체크포인트 정리')
+  .option('--keep <n>', '유지할 체크포인트 수', '10')
+  .option('--dry-run', '실제 삭제 없이 미리보기만')
+  .action(async (options) => {
+    try {
+      const projectRoot = await findProjectRoot();
+      const manager = new CheckpointManager(projectRoot);
+      
+      const keepLast = parseInt(options.keep);
+      
+      console.log(chalk.blue(`🧹 체크포인트 정리 중... (최근 ${keepLast}개 유지)`));
+      console.log('');
+      
+      if (options.dryRun) {
+        console.log(chalk.yellow('🔍 드라이런 모드: 실제 삭제는 수행하지 않습니다.'));
+        console.log('');
+        
+        const checkpoints = await manager.listCheckpoints();
+        if (checkpoints.length <= keepLast) {
+          console.log(chalk.green('✅ 정리할 체크포인트가 없습니다.'));
+        } else {
+          const toDelete = checkpoints.slice(keepLast);
+          console.log(chalk.yellow(`삭제 예정 체크포인트 (${toDelete.length}개):`));
+          for (const cp of toDelete) {
+            console.log(`  ${chalk.red('🗑️')} ${chalk.cyan(cp.id)} - ${chalk.gray(cp.type)}`);
+          }
+        }
+      } else {
+        await manager.cleanup(keepLast);
+        console.log(chalk.green('✅ 체크포인트 정리 완료!'));
+      }
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 체크포인트 정리 실패:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// 체크포인트 리포트 생성
+program
+  .command('report')
+  .description('현재 세션의 진행 상황 리포트 생성')
+  .action(async () => {
+    try {
+      const projectRoot = await findProjectRoot();
+      const manager = new CheckpointManager(projectRoot);
+      await manager.loadState();
+      
+      console.log(chalk.blue('📊 진행 상황 리포트 생성 중...'));
+      console.log('');
+      
+      const report = await manager.generateProgressReport();
+      
+      console.log(chalk.bold('🎯 YOLO 세션 리포트'));
+      console.log(''.padEnd(50, '='));
+      console.log('');
+      
+      // 세션 정보
+      console.log(chalk.bold('📋 세션 정보:'));
+      console.log(`  ID: ${chalk.cyan(report.session.id)}`);
+      console.log(`  시작: ${chalk.gray(new Date(report.session.started).toLocaleString())}`);
+      console.log(`  스프린트: ${chalk.blue(report.session.sprint || 'N/A')}`);
+      console.log(`  모드: ${chalk.yellow(report.session.mode || 'N/A')}`);
+      console.log('');
+      
+      // 진행 상황
+      console.log(chalk.bold('📈 진행 상황:'));
+      console.log(`  완료: ${chalk.green(report.progress.completed)}개`);
+      console.log(`  실패: ${chalk.red(report.progress.failed)}개`);
+      console.log(`  건너뜀: ${chalk.yellow(report.progress.skipped)}개`);
+      console.log(`  현재: ${chalk.cyan(report.progress.current)}`);
+      console.log('');
+      
+      // 성능 지표
+      console.log(chalk.bold('⏱️ 성능 지표:'));
+      console.log(`  총 시간: ${chalk.blue(report.performance.total_time)}`);
+      console.log(`  평균 태스크 시간: ${chalk.blue(report.performance.avg_task_time)}`);
+      console.log(`  성공률: ${chalk.green(report.performance.success_rate)}`);
+      console.log('');
+      
+      // 체크포인트
+      if (report.checkpoints.length > 0) {
+        console.log(chalk.bold('📊 체크포인트:'));
+        for (const cp of report.checkpoints.slice(-5)) {  // 최근 5개만
+          const typeIcon = cp.type === 'session_start' ? '🚀' :
+                          cp.type === 'task_complete' ? '✅' :
+                          cp.type === 'auto' ? '🔄' : '📝';
+          console.log(`  ${typeIcon} ${chalk.cyan(cp.id)} - ${chalk.gray(cp.type)}`);
+        }
+        console.log('');
+      }
+      
+      // 권장사항
+      if (report.recommendations.length > 0) {
+        console.log(chalk.bold('💡 권장사항:'));
+        for (const rec of report.recommendations) {
+          console.log(`  • ${chalk.yellow(rec)}`);
+        }
+        console.log('');
+      }
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 리포트 생성 실패:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// 도움말 명령어
+program
+  .command('help')
+  .description('AIWF 체크포인트 명령어 도움말')
+  .action(() => {
+    console.log(chalk.bold('📊 AIWF 체크포인트 CLI 도움말'));
+    console.log('');
+    console.log(chalk.yellow('📋 주요 명령어:'));
+    console.log('');
+    console.log(`  ${chalk.cyan('aiwf-checkpoint list')} - 체크포인트 목록 보기`);
+    console.log(`  ${chalk.cyan('aiwf-checkpoint status')} - 현재 세션 상태`);
+    console.log(`  ${chalk.cyan('aiwf-checkpoint restore <id>')} - 체크포인트에서 복구`);
+    console.log(`  ${chalk.cyan('aiwf-checkpoint create [message]')} - 수동 체크포인트 생성`);
+    console.log(`  ${chalk.cyan('aiwf-checkpoint clean')} - 오래된 체크포인트 정리`);
+    console.log(`  ${chalk.cyan('aiwf-checkpoint report')} - 진행 상황 리포트`);
+    console.log('');
+    console.log(chalk.yellow('🔧 유용한 옵션:'));
+    console.log('');
+    console.log(`  ${chalk.blue('--dry-run')} - 실제 실행 없이 미리보기`);
+    console.log(`  ${chalk.blue('--limit <n>')} - 목록 표시 제한`);
+    console.log(`  ${chalk.blue('--keep <n>')} - 정리 시 유지할 개수`);
+    console.log('');
+    console.log(chalk.yellow('💡 사용 예시:'));
+    console.log('');
+    console.log(`  ${chalk.gray('# 최근 체크포인트에서 복구')}`);
+    console.log(`  ${chalk.blue('aiwf-checkpoint list')}`);
+    console.log(`  ${chalk.blue('aiwf-checkpoint restore cp_1234567890')}`);
+    console.log('');
+    console.log(`  ${chalk.gray('# 중요한 작업 전 수동 체크포인트 생성')}`);
+    console.log(`  ${chalk.blue('aiwf-checkpoint create "주요 리팩토링 전"')}`);
+    console.log('');
+    console.log(`  ${chalk.gray('# 오래된 체크포인트 정리')}`);
+    console.log(`  ${chalk.blue('aiwf-checkpoint clean --keep 5')}`);
+    console.log('');
+    console.log(chalk.green('🛡️ 체크포인트는 YOLO 모드 실행 중 자동으로 생성됩니다!'));
+  });
+
+// 시간 경과 계산 헬퍼
+function getTimeAgo(date) {
+  const now = new Date();
+  const diffMs = now - date;
+  const diffMins = Math.floor(diffMs / 60000);
+  const diffHours = Math.floor(diffMins / 60);
+  const diffDays = Math.floor(diffHours / 24);
+  
+  if (diffDays > 0) return `${diffDays}일 전`;
+  if (diffHours > 0) return `${diffHours}시간 전`;
+  if (diffMins > 0) return `${diffMins}분 전`;
+  return '방금 전';
+}
+
+// 에러 핸들링
+program.on('command:*', () => {
+  console.error(chalk.red('❌ 알 수 없는 명령어입니다.'));
+  console.log('');
+  console.log(chalk.blue('도움말을 보려면: aiwf-checkpoint help'));
+  process.exit(1);
+});
+
+// CLI 실행
+program.parse(process.argv);
+
+// 인수가 없으면 도움말 표시
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}