aiwf 0.3.8 → 0.3.12

package/src/config/yolo-config-template.yaml

@@ -0,0 +1,168 @@
+# YOLO Mode Configuration Template
+# AIWF 자율 실행 모드 설정
+# 이 파일을 .aiwf/yolo-config.yaml에 복사하여 사용하세요
+
+# 엔지니어링 레벨 설정
+engineering_level: minimal  # minimal, balanced, complete
+
+# 포커스 규칙 - 곁길로 빠지지 않도록 제어
+focus_rules:
+  # 요구사항 우선 - 명시된 요구사항만 구현
+  requirement_first: true
+  
+  # 간단한 해결책 선호
+  simple_solution: true
+  
+  # 골드 플레이팅 방지 - 필요 이상의 기능 추가 금지
+  no_gold_plating: true
+  
+  # 트랙 유지 - 원래 목표에서 벗어나지 않음
+  stay_on_track: true
+  
+  # 리팩토링 제한 - 필수적인 경우만 허용
+  limit_refactoring: false
+
+# 실행 모드 설정
+execution:
+  # 스마트 모드 - 컨텍스트 기반 의사결정
+  smart_mode: false
+  
+  # 빠른 실행 - 최소한의 검증만 수행
+  fast_mode: true
+  
+  # 테스트 실행 - 각 태스크 완료 후 테스트
+  run_tests: true
+  
+  # 커밋 자동화 - 태스크 완료 시 자동 커밋
+  auto_commit: false
+  
+  # 브랜치 전략
+  branch_strategy: feature  # feature, direct, worktree
+
+# 중단 조건 - 이러한 상황에서 YOLO 모드 중단
+breakpoints:
+  # 중요 파일 수정 시
+  critical_files:
+    - .env
+    - database/migrations/*
+    - config/production.js
+  
+  # 테스트 실패 임계값 (%)
+  test_failure_threshold: 10
+  
+  # 데이터베이스 스키마 변경 시
+  schema_changes: true
+  
+  # 보안 관련 변경 시
+  security_changes: true
+  
+  # 외부 API 통합 시
+  external_api: false
+
+# 진행률 리포트 설정
+reporting:
+  # 상세 레벨
+  verbosity: normal  # quiet, normal, verbose
+  
+  # 진행률 업데이트 빈도 (태스크 단위)
+  update_frequency: 1
+  
+  # 요약 리포트 생성
+  generate_summary: true
+  
+  # 메트릭 추적
+  track_metrics: true
+
+# 오버엔지니어링 방지 규칙
+overengineering_prevention:
+  # 최대 파일 크기 (줄)
+  max_file_lines: 300
+  
+  # 최대 함수 크기 (줄)
+  max_function_lines: 50
+  
+  # 최대 중첩 깊이
+  max_nesting_depth: 4
+  
+  # 추상화 레벨 제한
+  max_abstraction_layers: 3
+  
+  # 디자인 패턴 사용 제한
+  limit_design_patterns: true
+  
+  # 미래를 위한 코드 금지
+  no_future_proofing: true
+
+# 체크포인트 설정
+checkpoint:
+  # 체크포인트 활성화
+  enabled: true
+  
+  # 체크포인트 간격 (태스크 수)
+  interval: 5
+  
+  # 복구 모드
+  recovery_mode: auto  # auto, manual, disabled
+  
+  # 상태 저장 위치
+  state_file: .aiwf/yolo-state.json
+
+# 태스크 우선순위 설정
+priority:
+  # 우선순위 가중치
+  weights:
+    urgency: 0.4
+    importance: 0.3
+    dependencies: 0.2
+    effort: 0.1
+  
+  # 의존성 우선 실행
+  dependency_first: true
+  
+  # 블로커 태스크 즉시 처리
+  handle_blockers: true
+
+# AI 페르소나 설정
+persona:
+  # 기본 페르소나
+  default: developer
+  
+  # 태스크별 페르소나 자동 선택
+  auto_select: true
+  
+  # 페르소나 전환 규칙
+  rules:
+    - pattern: "API|백엔드|서버"
+      persona: backend
+    - pattern: "UI|프론트|컴포넌트"
+      persona: frontend
+    - pattern: "테스트|검증|QA"
+      persona: tester
+
+# 성능 최적화
+performance:
+  # 병렬 실행 (실험적)
+  parallel_tasks: false
+  
+  # 캐시 활용
+  use_cache: true
+  
+  # 불필요한 파일 읽기 스킵
+  skip_unchanged: true
+  
+  # 압축 모드 사용
+  compression_mode: auto
+
+# 안전 장치
+safety:
+  # 드라이런 모드 - 실제 변경 없이 시뮬레이션
+  dry_run: false
+  
+  # 백업 생성
+  create_backup: true
+  
+  # 최대 실행 시간 (분)
+  max_runtime: 120
+  
+  # 확인 프롬프트 표시
+  confirmation_prompts: false

package/src/lib/file-downloader.js

@@ -3,6 +3,13 @@ import { createWriteStream } from 'fs';
 import fs from 'fs/promises';
 import { pipeline } from 'stream/promises';
 import path from 'path';
+import {
+  COMMAND_FILES,
+  GLOBAL_RULES_FILES,
+  MANUAL_RULES_FILES,
+  TEMPLATE_FILES,
+  PROMPT_FILES
+} from '../config/file-lists.js';
 
 const GITHUB_RAW_URL = 'https://raw.githubusercontent.com/moonklabs/aiwf/main';
 const GITHUB_CONTENT_PREFIX = 'claude-code/aiwf';
@@ -11,78 +18,6 @@ const GITHUB_OWNER = 'moonklabs';
 const GITHUB_REPO = 'aiwf';
 const GITHUB_BRANCH = 'main';
 
-// Pre-defined list of command files
-const COMMAND_FILES = [
-  'aiwf_changelog.md',
-  'aiwf_code_review.md',
-  'aiwf_commit.md',
-  'aiwf_compress_aggressive_persona.md',
-  'aiwf_compress_context.md',
-  'aiwf_compress_minimal_persona.md',
-  'aiwf_compress_stats.md',
-  'aiwf_compress_with_persona.md',
-  'aiwf_create_feature_ledger.md',
-  'aiwf_create_general_task.md',
-  'aiwf_create_milestone_plan.md',
-  'aiwf_create_prd.md',
-  'aiwf_create_sprint_tasks.md',
-  'aiwf_create_sprints_from_milestone.md',
-  'aiwf_default_mode.md',
-  'aiwf_discuss_review.md',
-  'aiwf_do_task.md',
-  'aiwf_docs.md',
-  'aiwf_evaluate.md',
-  'aiwf_get_feature_details.md',
-  'aiwf_infinite.md',
-  'aiwf_initialize.md',
-  'aiwf_issue_create.md',
-  'aiwf_link_feature_to_milestone.md',
-  'aiwf_list_features.md',
-  'aiwf_mermaid.md',
-  'aiwf_persona_architect.md',
-  'aiwf_persona_backend.md',
-  'aiwf_persona_data_analyst.md',
-  'aiwf_persona_frontend.md',
-  'aiwf_persona_security.md',
-  'aiwf_persona_status.md',
-  'aiwf_pr_create.md',
-  'aiwf_prime.md',
-  'aiwf_project_review.md',
-  'aiwf_switch_language.md',
-  'aiwf_test.md',
-  'aiwf_testing_review.md',
-  'aiwf_tm-run-all-subtask.md',
-  'aiwf_ultrathink_code_advanced.md',
-  'aiwf_ultrathink_code_basic.md',
-  'aiwf_ultrathink_general.md',
-  'aiwf_update_docs_kr.md',
-  'aiwf_update_feature_status.md',
-  'aiwf_yolo.md'
-];
-
-// Pre-defined list of global rules files
-const GLOBAL_RULES_FILES = [
-  'code-style-guide.md',
-  'coding-principles.md',
-  'development-process.md',
-  'global-rules.md'
-];
-
-// Pre-defined list of manual rules files
-const MANUAL_RULES_FILES = [
-  'generate-plan-docs.md'
-];
-
-// Pre-defined list of template files (these might not exist in the repo)
-const TEMPLATE_FILES = [
-  // Add template files here when they are available
-];
-
-// Pre-defined list of prompt files (these might not exist in the repo)
-const PROMPT_FILES = [
-  // Add prompt files here when they are available
-];
-
 /**
  * Fetch content from URL
  * @param {string} url - The URL to fetch from

package/src/lib/github-integration.js

@@ -0,0 +1,402 @@
+/**
+ * AIWF GitHub Integration
+ * GitHub Issues와 Pull Requests 통합 관리
+ */
+
+import { execSync } from 'child_process';
+import fs from 'fs/promises';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { StateIndexManager } from './state/state-index.js';
+
+export class GitHubIntegration {
+  constructor() {
+    this.projectRoot = null;
+    this.aiwfPath = null;
+    this.stateIndexManager = null;
+  }
+
+  /**
+   * 초기화
+   */
+  async init() {
+    this.projectRoot = await this.findProjectRoot();
+    this.aiwfPath = path.join(this.projectRoot, '.aiwf');
+    this.stateIndexManager = new StateIndexManager(this.aiwfPath);
+  }
+
+  async findProjectRoot(startDir = process.cwd()) {
+    let currentDir = startDir;
+    
+    while (currentDir !== path.parse(currentDir).root) {
+      try {
+        const aiwfPath = path.join(currentDir, '.aiwf');
+        await fs.access(aiwfPath);
+        return currentDir;
+      } catch {
+        currentDir = path.dirname(currentDir);
+      }
+    }
+    
+    throw new Error('.aiwf directory not found. Are you in an AIWF project?');
+  }
+
+  /**
+   * GitHub CLI 사용 가능 여부 확인
+   */
+  checkGitHubCLI() {
+    try {
+      execSync('gh --version', { stdio: 'ignore' });
+      return true;
+    } catch {
+      throw new Error('GitHub CLI (gh) is not installed. Please install it first: https://cli.github.com/');
+    }
+  }
+
+  /**
+   * 태스크에서 GitHub 이슈 생성
+   */
+  async createIssue(taskId) {
+    const spinner = ora('Creating GitHub issue...').start();
+    
+    try {
+      await this.init();
+      this.checkGitHubCLI();
+      
+      // 상태 인덱스에서 태스크 정보 로드
+      const stateIndex = await this.stateIndexManager.loadIndex();
+      if (!stateIndex) {
+        throw new Error('State index not found. Run "aiwf state update" first.');
+      }
+      
+      const task = stateIndex.tasks[taskId];
+      if (!task) {
+        throw new Error(`Task ${taskId} not found in state index.`);
+      }
+      
+      spinner.text = 'Generating issue template...';
+      
+      // 이슈 템플릿 생성
+      const issueBody = this.generateIssueTemplate(task);
+      const issueTitle = `${taskId}: ${task.title}`;
+      
+      // GitHub CLI로 이슈 생성
+      spinner.text = 'Creating issue on GitHub...';
+      const labels = this.generateLabels(task);
+      
+      const createCommand = [
+        'gh', 'issue', 'create',
+        '--title', `"${issueTitle}"`,
+        '--body', `"${issueBody}"`,
+        '--label', `"${labels.join(',')}"`,
+        '--assignee', '@me'
+      ].join(' ');
+      
+      const result = execSync(createCommand, { 
+        encoding: 'utf8',
+        cwd: this.projectRoot 
+      });
+      
+      // 이슈 URL 추출
+      const issueUrl = result.trim();
+      const issueNumber = this.extractIssueNumber(issueUrl);
+      
+      // 태스크 파일에 GitHub 이슈 정보 추가
+      if (task.file_path) {
+        await this.updateTaskWithIssue(task.file_path, issueNumber, issueUrl);
+      }
+      
+      spinner.succeed(`GitHub issue created successfully: ${issueUrl}`);
+      
+      console.log(chalk.cyan('\n📋 Issue Details:'));
+      console.log(`   Title: ${issueTitle}`);
+      console.log(`   URL: ${issueUrl}`);
+      console.log(`   Labels: ${labels.join(', ')}`);
+      
+    } catch (error) {
+      spinner.fail(`Failed to create GitHub issue: ${error.message}`);
+      throw error;
+    }
+  }
+
+  /**
+   * Pull Request 생성
+   */
+  async createPullRequest(taskId) {
+    const spinner = ora('Creating pull request...').start();
+    
+    try {
+      await this.init();
+      this.checkGitHubCLI();
+      
+      // 현재 브랜치 확인
+      const currentBranch = execSync('git branch --show-current', { 
+        encoding: 'utf8',
+        cwd: this.projectRoot 
+      }).trim();
+      
+      if (currentBranch === 'main' || currentBranch === 'master') {
+        throw new Error('Cannot create PR from main/master branch. Please create a feature branch first.');
+      }
+      
+      spinner.text = 'Checking branch status...';
+      
+      // 변경사항 확인
+      const diffStat = execSync('git diff main...HEAD --stat', { 
+        encoding: 'utf8',
+        cwd: this.projectRoot 
+      });
+      
+      if (!diffStat.trim()) {
+        throw new Error('No changes found between current branch and main.');
+      }
+      
+      // 커밋 히스토리 확인
+      const commits = execSync('git log main..HEAD --oneline', { 
+        encoding: 'utf8',
+        cwd: this.projectRoot 
+      });
+      
+      spinner.text = 'Generating PR template...';
+      
+      // PR 템플릿 생성
+      const prBody = this.generatePRTemplate(taskId, commits, diffStat);
+      const prTitle = taskId ? `${taskId}: Complete task implementation` : `Complete feature implementation`;
+      
+      // GitHub CLI로 PR 생성
+      spinner.text = 'Creating pull request on GitHub...';
+      
+      const createCommand = [
+        'gh', 'pr', 'create',
+        '--title', `"${prTitle}"`,
+        '--body', `"${prBody}"`,
+        '--base', 'main',
+        '--head', currentBranch
+      ].join(' ');
+      
+      const result = execSync(createCommand, { 
+        encoding: 'utf8',
+        cwd: this.projectRoot 
+      });
+      
+      const prUrl = result.trim();
+      
+      spinner.succeed(`Pull request created successfully: ${prUrl}`);
+      
+      console.log(chalk.cyan('\n🔀 Pull Request Details:'));
+      console.log(`   Title: ${prTitle}`);
+      console.log(`   URL: ${prUrl}`);
+      console.log(`   Base: main ← ${currentBranch}`);
+      
+    } catch (error) {
+      spinner.fail(`Failed to create pull request: ${error.message}`);
+      throw error;
+    }
+  }
+
+  /**
+   * GitHub 이슈와 AIWF 태스크 동기화
+   */
+  async syncIssues() {
+    const spinner = ora('Syncing GitHub issues...').start();
+    
+    try {
+      await this.init();
+      this.checkGitHubCLI();
+      
+      // GitHub에서 이슈 목록 가져오기
+      spinner.text = 'Fetching GitHub issues...';
+      const issuesJson = execSync('gh issue list --json number,title,state,labels,assignees', { 
+        encoding: 'utf8',
+        cwd: this.projectRoot 
+      });
+      
+      const issues = JSON.parse(issuesJson);
+      
+      // AIWF 태스크와 연결된 이슈들 확인
+      const stateIndex = await this.stateIndexManager.loadIndex();
+      if (!stateIndex) {
+        throw new Error('State index not found. Run "aiwf state update" first.');
+      }
+      
+      spinner.text = 'Analyzing synchronization...';
+      
+      let syncCount = 0;
+      const syncResults = [];
+      
+      for (const issue of issues) {
+        // 이슈 제목에서 태스크 ID 추출
+        const taskIdMatch = issue.title.match(/^([A-Z]\d+):/);
+        if (taskIdMatch) {
+          const taskId = taskIdMatch[1];
+          const task = stateIndex.tasks[taskId];
+          
+          if (task) {
+            // 상태 동기화 확인
+            const issueState = issue.state.toLowerCase();
+            const taskState = task.status;
+            
+            let needsSync = false;
+            if (issueState === 'closed' && taskState !== 'completed') {
+              needsSync = true;
+            } else if (issueState === 'open' && taskState === 'completed') {
+              needsSync = true;
+            }
+            
+            if (needsSync) {
+              syncResults.push({
+                taskId,
+                issueNumber: issue.number,
+                issueState,
+                taskState,
+                needsSync
+              });
+              syncCount++;
+            }
+          }
+        }
+      }
+      
+      spinner.succeed(`GitHub sync completed. Found ${syncCount} items needing attention.`);
+      
+      if (syncResults.length > 0) {
+        console.log(chalk.cyan('\n🔄 Sync Status:'));
+        for (const result of syncResults) {
+          console.log(`   ${result.taskId}: Issue #${result.issueNumber} (${result.issueState}) ↔ Task (${result.taskState})`);
+        }
+        console.log(chalk.yellow('\nNote: Manual review recommended for state mismatches.'));
+      } else {
+        console.log(chalk.green('\n✅ All GitHub issues are in sync with AIWF tasks.'));
+      }
+      
+    } catch (error) {
+      spinner.fail(`Failed to sync GitHub issues: ${error.message}`);
+      throw error;
+    }
+  }
+
+  /**
+   * 이슈 템플릿 생성
+   */
+  generateIssueTemplate(task) {
+    return `## 📋 Task: ${task.title}
+
+### Description
+${task.description || 'No description provided.'}
+
+### Acceptance Criteria
+- [ ] Task implementation completed
+- [ ] Tests written and passing
+- [ ] Documentation updated
+- [ ] Code reviewed
+
+### Additional Information
+- **Task ID**: ${task.id}
+- **Sprint**: ${task.sprint_id || 'N/A'}
+- **Priority**: ${task.priority_score?.toFixed(2) || 'N/A'}
+- **Estimated Hours**: ${task.estimated_hours || 'N/A'}
+- **Complexity**: ${task.complexity || 'N/A'}
+
+### Task File
+\`${task.file_path || 'N/A'}\`
+
+---
+*This issue was automatically created by AIWF*`;
+  }
+
+  /**
+   * PR 템플릿 생성
+   */
+  generatePRTemplate(taskId, commits, diffStat) {
+    return `## 🎯 Overview
+${taskId ? `Completed implementation of ${taskId}.` : 'Completed feature implementation.'}
+
+## 📝 Changes
+\`\`\`
+${commits}
+\`\`\`
+
+## 📊 Changed Files
+\`\`\`
+${diffStat}
+\`\`\`
+
+## ✅ Checklist
+- [ ] Tests pass
+- [ ] Code review completed
+- [ ] Documentation updated
+
+## 🔗 Related Information
+${taskId ? `- Related Task: ${taskId}` : '- No specific task linked'}
+
+---
+*This pull request was automatically created by AIWF*`;
+  }
+
+  /**
+   * 태스크 타입과 상태에 따른 라벨 생성
+   */
+  generateLabels(task) {
+    const labels = ['aiwf-task'];
+    
+    if (task.type) {
+      labels.push(task.type);
+    }
+    
+    if (task.sprint_id && task.sprint_id !== 'general') {
+      labels.push('sprint-task');
+    }
+    
+    if (task.priority_score && task.priority_score > 0.8) {
+      labels.push('high-priority');
+    }
+    
+    if (task.complexity === 'high' || task.complexity === 'very-high') {
+      labels.push('complex');
+    }
+    
+    return labels;
+  }
+
+  /**
+   * 이슈 URL에서 이슈 번호 추출
+   */
+  extractIssueNumber(issueUrl) {
+    const match = issueUrl.match(/\/issues\/(\d+)$/);
+    return match ? match[1] : null;
+  }
+
+  /**
+   * 태스크 파일에 GitHub 이슈 정보 추가
+   */
+  async updateTaskWithIssue(filePath, issueNumber, issueUrl) {
+    try {
+      const content = await fs.readFile(filePath, 'utf8');
+      
+      // 이미 GitHub 정보가 있는지 확인
+      if (content.includes('github_issue:') || content.includes('GitHub Issue:')) {
+        return; // 이미 있으면 업데이트하지 않음
+      }
+      
+      // YAML frontmatter가 있는지 확인
+      const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+      
+      let updatedContent;
+      if (frontmatterMatch) {
+        // YAML frontmatter에 추가
+        const frontmatter = frontmatterMatch[1];
+        const body = frontmatterMatch[2];
+        const updatedFrontmatter = `${frontmatter}\ngithub_issue: ${issueNumber}\ngithub_url: ${issueUrl}`;
+        updatedContent = `---\n${updatedFrontmatter}\n---\n${body}`;
+      } else {
+        // 파일 시작 부분에 GitHub 정보 추가
+        updatedContent = `<!-- GitHub Issue: #${issueNumber} - ${issueUrl} -->\n\n${content}`;
+      }
+      
+      await fs.writeFile(filePath, updatedContent, 'utf8');
+    } catch (error) {
+      console.warn(`Failed to update task file with GitHub issue: ${error.message}`);
+    }
+  }
+}