aiwf 0.3.13 → 0.3.15

package/src/lib/installer.js

@@ -52,6 +52,61 @@ async function checkExistingInstallation() {
   return flagExists;
 }
 
+/**
+ * Check if existing project files exist
+ * @returns {Promise<{hasProject: boolean, projectFiles: string[]}>} Project status
+ */
+async function checkExistingProject() {
+  const projectFiles = [];
+  let hasProject = false;
+
+  // Check for key project files
+  const keyFiles = [
+    FILES.PROJECT_MANIFEST,
+    path.join(AIWF_DIRS.PROJECT_DOCS, 'README.md'),
+    path.join(AIWF_DIRS.REQUIREMENTS, 'requirements.md'),
+    path.join(AIWF_DIRS.SPRINTS, 'sprint-01.md'),
+    path.join(AIWF_DIRS.GENERAL_TASKS, 'tasks.md'),
+    path.join(AIWF_DIRS.ARCHITECTURAL_DECISIONS, 'decisions.md'),
+    path.join(AIWF_DIRS.STATE_OF_PROJECT, 'current-state.md')
+  ];
+
+  for (const file of keyFiles) {
+    try {
+      await fs.access(file);
+      projectFiles.push(file);
+      hasProject = true;
+    } catch (error) {
+      // File doesn't exist, continue
+    }
+  }
+
+  // Check for any .md files in project directories
+  const projectDirs = [
+    AIWF_DIRS.PROJECT_DOCS,
+    AIWF_DIRS.REQUIREMENTS,
+    AIWF_DIRS.SPRINTS,
+    AIWF_DIRS.GENERAL_TASKS,
+    AIWF_DIRS.ARCHITECTURAL_DECISIONS,
+    AIWF_DIRS.STATE_OF_PROJECT
+  ];
+
+  for (const dir of projectDirs) {
+    try {
+      const files = await fs.readdir(dir);
+      const mdFiles = files.filter(file => file.endsWith('.md'));
+      if (mdFiles.length > 0) {
+        hasProject = true;
+        projectFiles.push(...mdFiles.map(file => path.join(dir, file)));
+      }
+    } catch (error) {
+      // Directory doesn't exist, continue
+    }
+  }
+
+  return { hasProject, projectFiles };
+}
+
 /**
  * Log with spinner for debug mode
  * @param {Object} spinner - Ora spinner instance
@@ -146,34 +201,145 @@ async function selectLanguage(options) {
  * Handle existing installation
  * @param {Object} msg - Localized messages
  * @param {Object} options - Installation options
- * @returns {Promise<boolean>} Continue with installation
+ * @returns {Promise<{continue: boolean, installType: string, preserveProject: boolean}>} Installation decision
  */
 async function handleExistingInstallation(msg, options) {
+
   if (options.force) {
-    return true;
+    return { continue: true, installType: 'reinstall', preserveProject: false };
   }
 
-  const response = await prompts({
+  // First, ask about installation type
+  const installResponse = await prompts({
     type: 'select',
     name: 'action',
     message: msg.existingDetected,
     choices: [
       { title: msg.updateOption, value: 'update' },
+      { title: msg.reinstallOption, value: 'reinstall' },
       { title: msg.skipOption, value: 'skip' },
       { title: msg.cancelOption, value: 'cancel' }
     ]
   });
 
-  if (response.action === 'skip' || response.action === 'cancel') {
+
+
+  if (installResponse.action === 'skip' || installResponse.action === 'cancel') {
     console.log(chalk.yellow(msg.installCancelled));
     process.exit(0);
   }
 
-  if (response.action === 'update') {
+  let preserveProject = true; // Default to preserve
+  
+  // If reinstalling, don't preserve project (complete fresh install)
+  if (installResponse.action === 'reinstall') {
+    preserveProject = false;
+  }
+
+  // Backup if updating
+  if (installResponse.action === 'update') {
     await backupCommandsAndDocs(msg);
   }
 
-  return true;
+  return {
+    continue: true,
+    installType: installResponse.action,
+    preserveProject
+  };
+}
+
+/**
+ * Backup project files
+ * @param {string[]} projectFiles - List of project files to backup
+ * @param {Object} msg - Localized messages
+ * @returns {Promise<string>} Backup directory path
+ */
+async function backupProjectFiles(projectFiles, msg) {
+  if (projectFiles.length === 0) {
+    return null;
+  }
+
+  const backupDir = path.join(os.tmpdir(), `aiwf-project-backup-${Date.now()}`);
+  await fs.mkdir(backupDir, { recursive: true });
+
+  console.log(chalk.cyan('💾 Backing up project files...'));
+  
+  for (const file of projectFiles) {
+    try {
+      const relativePath = path.relative(process.cwd(), file);
+      const backupPath = path.join(backupDir, relativePath);
+      const backupDirPath = path.dirname(backupPath);
+      
+      await fs.mkdir(backupDirPath, { recursive: true });
+      await fs.copyFile(file, backupPath);
+    } catch (error) {
+      console.log(chalk.yellow(`Warning: Could not backup ${file}: ${error.message}`));
+    }
+  }
+
+  console.log(chalk.green(`✅ Project files backed up to: ${backupDir}`));
+  return backupDir;
+}
+
+/**
+ * Restore project files from backup
+ * @param {string} backupDir - Backup directory path
+ * @param {Object} msg - Localized messages
+ */
+async function restoreProjectFiles(backupDir, msg) {
+  if (!backupDir) {
+    return;
+  }
+
+  console.log(chalk.cyan('🔄 Restoring project files...'));
+  
+  try {
+    const backupFiles = await fs.readdir(backupDir, { recursive: true });
+    
+    for (const file of backupFiles) {
+      const backupFilePath = path.join(backupDir, file);
+      const stat = await fs.stat(backupFilePath);
+      
+      if (stat.isFile()) {
+        const targetPath = path.join(process.cwd(), file);
+        const targetDir = path.dirname(targetPath);
+        
+        await fs.mkdir(targetDir, { recursive: true });
+        await fs.copyFile(backupFilePath, targetPath);
+      }
+    }
+    
+    console.log(chalk.green(msg.projectPreserved));
+    
+    // Clean up backup directory
+    await fs.rm(backupDir, { recursive: true, force: true });
+  } catch (error) {
+    console.log(chalk.yellow(`Warning: Could not restore some project files: ${error.message}`));
+    console.log(chalk.yellow(`Backup preserved at: ${backupDir}`));
+  }
+}
+
+/**
+ * Remove project files
+ * @param {string[]} projectFiles - List of project files to remove
+ * @param {Object} msg - Localized messages
+ */
+async function removeProjectFiles(projectFiles, msg) {
+  if (projectFiles.length === 0) {
+    return;
+  }
+
+  console.log(chalk.cyan('🗑️  Removing existing project files...'));
+  
+  for (const file of projectFiles) {
+    try {
+      await fs.unlink(file);
+    } catch (error) {
+      // File might already be deleted, continue
+    }
+  }
+  
+  console.log(chalk.green(msg.projectOverwritten));
 }
 
 /**
@@ -190,6 +356,7 @@ async function createDirectoryStructure() {
   // Create tool-specific directories
   await fs.mkdir(TOOL_DIRS.CURSOR_RULES, { recursive: true });
   await fs.mkdir(TOOL_DIRS.WINDSURF_RULES, { recursive: true });
+  await fs.mkdir(TOOL_DIRS.CLAUDE_AGENTS, { recursive: true });
 }
 
 /**
@@ -285,7 +452,7 @@ async function updateDocumentation(languagePath, spinner, msg, debugLog) {
 }
 
 /**
- * Update commands
+ * Update Claude commands and agents
  * @param {string} languagePath - Language path
  * @param {Object} spinner - Ora spinner instance
  * @param {Object} msg - Localized messages
@@ -298,7 +465,14 @@ async function updateCommands(languagePath, spinner, msg, debugLog) {
     await fs.rm(TOOL_DIRS.CLAUDE_COMMANDS, { recursive: true, force: true });
   }
 
+  // Delete existing agents folder if it exists
+  if (await fs.access(TOOL_DIRS.CLAUDE_AGENTS).then(() => true).catch(() => false)) {
+    logWithSpinner(spinner, 'Deleting old agents...', debugLog);
+    await fs.rm(TOOL_DIRS.CLAUDE_AGENTS, { recursive: true, force: true });
+  }
+
   await fs.mkdir(TOOL_DIRS.CLAUDE_COMMANDS, { recursive: true });
+  await fs.mkdir(TOOL_DIRS.CLAUDE_AGENTS, { recursive: true });
 
   // Download commands
   logWithSpinner(spinner, msg.downloadingCommands, debugLog);
@@ -314,11 +488,28 @@ async function updateCommands(languagePath, spinner, msg, debugLog) {
   } catch (error) {
     logWithSpinner(spinner, msg.commandsNotFound, debugLog);
   }
+
+  // Download agents
+  logWithSpinner(spinner, 'Downloading agents...', debugLog);
+  try {
+    await downloadDirectory(
+      `${GITHUB_CONTENT_PREFIX}/${languagePath}/${TOOL_DIRS.CLAUDE_AGENTS}`,
+      TOOL_DIRS.CLAUDE_AGENTS,
+      spinner,
+      msg,
+      languagePath,
+      false // agents도 기존 방식 유지 (파일 리스트 사용)
+    );
+    logWithSpinner(spinner, 'Successfully downloaded agents', debugLog);
+  } catch (error) {
+    logWithSpinner(spinner, 'Agents not found or failed to download', debugLog);
+  }
 }
 
 /**
  * Download and process rules
  * @param {Object} spinner - Ora spinner instance
+{{ ... }}
  * @param {Object} msg - Localized messages
  * @param {boolean} debugLog - Debug mode flag
  */
@@ -584,9 +775,22 @@ export async function installAIWF(options = {}) {
   // Check existing installation
   const hasExisting = await checkExistingInstallation();
 
+  let installDecision = { continue: true, installType: 'fresh', preserveProject: false };
+  let projectBackupDir = null;
+
   if (hasExisting) {
-    const shouldContinue = await handleExistingInstallation(msg, options);
-    if (!shouldContinue) return;
+
+    installDecision = await handleExistingInstallation(msg, options);
+
+    if (!installDecision.continue) return;
+    
+    // If reinstalling and preserving project, backup project files
+    if (installDecision.installType === 'reinstall' && installDecision.preserveProject) {
+      const { hasProject, projectFiles } = await checkExistingProject();
+      if (hasProject) {
+        projectBackupDir = await backupProjectFiles(projectFiles, msg);
+      }
+    }
   }
 
   const spinner = ora(msg.fetching).start();
@@ -595,16 +799,20 @@ export async function installAIWF(options = {}) {
     // Create directory structure
     await createDirectoryStructure();
 
-    // Download manifest (fresh installs only)
-    if (!hasExisting) {
+    // Download manifest (fresh installs only or complete reinstall)
+    if (!hasExisting || installDecision.installType === 'reinstall') {
       await downloadManifest(languagePath, spinner, msg, debugLog);
     }
 
-    // Download templates
-    await downloadTemplates(languagePath, spinner, msg, debugLog);
+    // Download templates (fresh installs and complete reinstall only)
+    if (!hasExisting || installDecision.installType === 'reinstall') {
+      await downloadTemplates(languagePath, spinner, msg, debugLog);
+    }
 
-    // Update documentation
-    await updateDocumentation(languagePath, spinner, msg, debugLog);
+    // Update documentation (fresh installs and complete reinstall only)
+    if (!hasExisting || installDecision.installType === 'reinstall') {
+      await updateDocumentation(languagePath, spinner, msg, debugLog);
+    }
 
     // Update commands
     await updateCommands(languagePath, spinner, msg, debugLog);
@@ -612,8 +820,13 @@ export async function installAIWF(options = {}) {
     // Download and process rules
     await downloadAndProcessRules(spinner, msg, debugLog);
 
+    // Restore project files if needed
+    if (projectBackupDir) {
+      await restoreProjectFiles(projectBackupDir, msg);
+    }
+
     // Success
-    if (hasExisting) {
+    if (hasExisting && installDecision.installType === 'update') {
       spinner.succeed(chalk.green(msg.updateSuccess));
     } else {
       spinner.succeed(chalk.green(msg.installSuccess));

package/src/utils/messages.js

@@ -11,8 +11,16 @@ export const messages = {
     english: 'English',
     existingDetected: '기존 AIWF 설치가 감지되었습니다. 무엇을 하시겠습니까?',
     updateOption: '업데이트 (명령어와 문서만 업데이트하고 작업 내용은 보존)',
+    reinstallOption: '완전 재설치 (모든 내용을 새로 설치, 기존 프로젝트 덮어쓰기)',
     skipOption: '설치 건너뛰기',
     cancelOption: '취소',
+    projectDetected: '기존 프로젝트가 감지되었습니다. 프로젝트 파일을 어떻게 처리하시겠습니까?',
+    preserveProject: '프로젝트 보존 (기존 프로젝트 파일 유지)',
+    overwriteProject: '덮어쓰기 (새로 설치하고 기존 프로젝트 삭제)',
+    checkingProject: '기존 프로젝트 확인 중...',
+    projectFound: '기존 프로젝트가 발견되었습니다:',
+    projectPreserved: '💾 프로젝트가 보존되었습니다.',
+    projectOverwritten: '🔄 프로젝트가 새로 설치되었습니다.',
     installCancelled: '\n설치가 취소되었습니다.',
     backingUp: '기존 명령어 및 문서 백업 중...',
     fetching: 'GitHub에서 AIWF 프레임워크를 가져오는 중...',
@@ -72,8 +80,16 @@ export const messages = {
     english: 'English',
     existingDetected: 'Existing AIWF installation detected. What would you like to do?',
     updateOption: 'Update (Update commands and docs only, preserve work content)',
+    reinstallOption: 'Complete reinstall (Install everything fresh, overwrite existing project)',
     skipOption: 'Skip installation',
     cancelOption: 'Cancel',
+    projectDetected: 'Existing project detected. How would you like to handle project files?',
+    preserveProject: 'Preserve project (Keep existing project files)',
+    overwriteProject: 'Overwrite (Fresh install and remove existing project)',
+    checkingProject: 'Checking for existing project...',
+    projectFound: 'Existing project found:',
+    projectPreserved: '💾 Project has been preserved.',
+    projectOverwritten: '🔄 Project has been freshly installed.',
     installCancelled: '\nInstallation cancelled.',
     backingUp: 'Backing up existing commands and documents...',
     fetching: 'Fetching AIWF framework from GitHub...',

package/src/utils/paths.js

@@ -22,7 +22,7 @@ export const AIWF_DIRS = {
   REQUIREMENTS: path.join(BASE_DIRS.AIWF, '02_REQUIREMENTS'),
   SPRINTS: path.join(BASE_DIRS.AIWF, '03_SPRINTS'),
   GENERAL_TASKS: path.join(BASE_DIRS.AIWF, '04_GENERAL_TASKS'),
-  ARCHITECTURE_DECISIONS: path.join(BASE_DIRS.AIWF, '05_ARCHITECTURE_DECISIONS'),
+  ARCHITECTURAL_DECISIONS: path.join(BASE_DIRS.AIWF, '05_ARCHITECTURAL_DECISIONS'),
   STATE_OF_PROJECT: path.join(BASE_DIRS.AIWF, '10_STATE_OF_PROJECT'),
   PROMPTS: path.join(BASE_DIRS.AIWF, '98_PROMPTS'),
   TEMPLATES: path.join(BASE_DIRS.AIWF, '99_TEMPLATES'),
@@ -37,6 +37,7 @@ export const AIWF_DIRS = {
 // Tool-specific directories
 export const TOOL_DIRS = {
   CLAUDE_COMMANDS: path.join(BASE_DIRS.CLAUDE, 'commands', 'aiwf'),
+  CLAUDE_AGENTS: path.join(BASE_DIRS.CLAUDE, 'agents'),
   GEMINI_PROMPTS: path.join(BASE_DIRS.GEMINI, 'prompts', 'aiwf'),
   CURSOR_RULES: path.join(BASE_DIRS.CURSOR, 'rules'),
   WINDSURF_RULES: path.join(BASE_DIRS.WINDSURF, 'rules')
@@ -76,7 +77,7 @@ export function getAllAiwfDirectories() {
     AIWF_DIRS.REQUIREMENTS,
     AIWF_DIRS.SPRINTS,
     AIWF_DIRS.GENERAL_TASKS,
-    AIWF_DIRS.ARCHITECTURE_DECISIONS,
+    AIWF_DIRS.ARCHITECTURAL_DECISIONS,
     AIWF_DIRS.STATE_OF_PROJECT,
     AIWF_DIRS.PROMPTS,
     AIWF_DIRS.TEMPLATES

package/docs/CLEANUP_RECOMMENDATIONS.md

@@ -1,86 +0,0 @@
-# AIWF 프로젝트 정리 권장사항
-
-## ✅ 완료된 작업
-
-1. **import 경로 수정**
-   - index.js의 잘못된 경로 수정 완료
-   - `./src/commands/ai-tool.js` → `./commands/ai-tool.js`
-
-2. **미사용 파일 삭제** (4개 파일, 1,734줄 제거)
-   - lib/file-batch-processor.js
-   - lib/performance-benchmark.js
-   - lib/template-manager.js
-   - lib/cache-integration.js
-
-## 📋 추가 권장사항
-
-### 1. 코드 구조 개선
-
-#### index.js 모듈화 (1,950줄 → 여러 모듈로 분리)
-```
-index.js
-├── lib/installer.js         # 설치 로직
-├── lib/validator.js         # 검증 로직
-├── lib/backup-manager.js    # 백업/복원 로직
-└── lib/github-client.js     # GitHub API 통신
-```
-
-#### 토큰 관리 시스템 통합
-현재 8개 파일에 분산된 토큰 기능을 2개로 통합:
-- `lib/token-manager.js` - 핵심 토큰 관리
-- `commands/token-tracking.js` - CLI 명령어
-
-### 2. 파일명 일관성
-
-스네이크 케이스를 케밥 케이스로 통일:
-```bash
-# 변경 필요
-sync-feature-commits.js → sync-feature-commits.js ✓ (완료)
-feature-commit-report.js → feature-commit-report.js ✓ (완료)
-scan-git-history.js → scan-git-history.js ✓ (완료)
-```
-
-### 3. 중복 기능 통합
-
-#### 압축 시스템 (4개 → 2개)
-- 유지: `utils/context-compressor.js`, `commands/compress-context.js`
-- 통합: `compression-strategies.js`, `persona-aware-compressor.js`
-
-### 4. 문서 정리
-
-중복되거나 오래된 문서 통합:
-- PRD.md와 PRD.ko.md의 정보 동기화
-- 여러 개의 가이드 문서를 하나로 통합
-- 사용되지 않는 문서에서만 참조되는 기능 제거
-
-### 5. 테스트 개선
-
-- 큰 테스트 파일 분리 (compression-test-suite.js: 1,251줄)
-- 주석 처리된 테스트 코드 정리
-- 실제 사용되는 유틸리티에 대한 테스트 추가
-
-### 6. 성능 최적화
-
-- 복잡한 메트릭 수집 간소화 (metrics-collector.js: 884줄)
-- 불필요한 추상화 레벨 제거
-- 캐시 시스템 단순화
-
-## 🎯 예상 효과
-
-- **코드 감소**: 약 20-30% 코드량 감소
-- **유지보수성**: 파일 구조 명확화로 이해도 향상
-- **성능**: 불필요한 추상화 제거로 성능 개선
-- **일관성**: 명명 규칙 통일로 개발 경험 개선
-
-## ⚠️ 주의사항
-
-1. **Git 통합 파일들은 유지**: 실제로 활발히 사용 중
-2. **페르소나 시스템 유지**: Claude Code 통합에 필수
-3. **변경 시 테스트 필수**: 기능 손상 방지
-
-## 🔄 단계별 진행
-
-1. **Phase 1** (즉시): ✅ 미사용 파일 제거 (완료)
-2. **Phase 2** (단기): 파일명 통일, 중복 통합
-3. **Phase 3** (중기): index.js 모듈화, 테스트 개선
-4. **Phase 4** (장기): 전체 구조 최적화