aiwf 0.3.22 → 0.4.0

package/src/lib/resources/utils/context-update-manager.js

@@ -1,502 +0,0 @@
-/**
- * 컨텍스트 실시간 업데이트 관리자
- * 페르소나 컨텍스트 파일의 변경을 감지하고 실시간으로 반영하는 모듈
- */
-
-const fs = require('fs');
-const path = require('path');
-const EventEmitter = require('events');
-const chokidar = require('chokidar');
-const ContextRuleParser = require('./context-rule-parser');
-
-class ContextUpdateManager extends EventEmitter {
-  constructor() {
-    super();
-    this.contextParser = new ContextRuleParser();
-    this.watchers = new Map();
-    this.updateQueue = [];
-    this.isProcessing = false;
-    this.pollingInterval = null;
-    this.lastUpdateTimes = new Map();
-  }
-
-  /**
-   * 컨텍스트 파일 감시 시작
-   * @param {Array} personas - 감시할 페르소나 목록
-   * @param {Object} options - 감시 옵션
-   */
-  startWatching(personas = ['architect', 'frontend', 'backend', 'data_analyst', 'security'], options = {}) {
-    const watchOptions = {
-      persistent: true,
-      ignoreInitial: true,
-      awaitWriteFinish: {
-        stabilityThreshold: 1000,
-        pollInterval: 100
-      },
-      ...options
-    };
-
-    personas.forEach(persona => {
-      const contextPath = path.join(
-        process.cwd(),
-        '.aiwf',
-        '07_AI_PERSONAS',
-        persona,
-        'context_rules.md'
-      );
-
-      try {
-        // 파일이 존재하는지 확인
-        if (!fs.existsSync(contextPath)) {
-          this.createDefaultContextFile(persona, contextPath);
-        }
-
-        // Chokidar 감시자 생성
-        const watcher = chokidar.watch(contextPath, watchOptions);
-
-        watcher
-          .on('change', () => this.handleFileChange(persona, contextPath))
-          .on('add', () => this.handleFileAdd(persona, contextPath))
-          .on('unlink', () => this.handleFileRemove(persona, contextPath))
-          .on('error', error => this.handleWatchError(persona, error));
-
-        this.watchers.set(persona, watcher);
-        console.log(`컨텍스트 감시 시작: ${persona}`);
-      } catch (error) {
-        console.error(`감시 설정 실패 (${persona}):`, error);
-        // 폴백: 폴링 방식으로 전환
-        this.startPolling(persona, contextPath);
-      }
-    });
-
-    // 이벤트 리스너 설정
-    this.setupEventHandlers();
-  }
-
-  /**
-   * 기본 컨텍스트 파일 생성
-   * @param {string} persona - 페르소나 이름
-   * @param {string} filePath - 파일 경로
-   */
-  createDefaultContextFile(persona, filePath) {
-    const defaultContexts = {
-      architect: `---
-persona_name: architect
-analysis_approach: 시스템 설계 중심
-design_principles:
-  - 확장성
-  - 유지보수성
-  - 성능
-communication_style: 구조적이고 논리적
----
-
-# 아키텍트 페르소나 컨텍스트
-
-## 핵심 역할
-시스템 전체 구조를 설계하고 기술적 결정을 내리는 역할을 수행합니다.
-
-## 분석 접근법
-- 전체 시스템 관점에서 문제 분석
-- 컴포넌트 간 상호작용 고려
-- 장기적 확장성과 유지보수성 중시
-
-## 소통 스타일
-- 다이어그램과 구조도를 활용한 설명
-- 기술적 트레이드오프 명확히 제시
-- 단계별 구현 계획 제공`,
-
-      frontend: `---
-persona_name: frontend
-analysis_approach: UI/UX 중심
-design_principles:
-  - 사용성
-  - 접근성
-  - 반응성
-communication_style: 시각적이고 직관적
----
-
-# 프론트엔드 페르소나 컨텍스트
-
-## 핵심 역할
-사용자 인터페이스와 경험을 설계하고 구현하는 역할을 수행합니다.
-
-## 분석 접근법
-- 사용자 관점에서 문제 접근
-- 시각적 요소와 인터랙션 중시
-- 다양한 디바이스와 브라우저 고려
-
-## 소통 스타일
-- 목업과 프로토타입 활용
-- 사용자 시나리오 기반 설명
-- 직관적이고 이해하기 쉬운 표현`,
-
-      backend: `---
-persona_name: backend
-analysis_approach: API 및 데이터 처리 중심
-design_principles:
-  - 보안
-  - 효율성
-  - 확장성
-communication_style: 기술적이고 정확함
----
-
-# 백엔드 페르소나 컨텍스트
-
-## 핵심 역할
-서버 사이드 로직과 데이터 처리를 담당하는 역할을 수행합니다.
-
-## 분석 접근법
-- 데이터 흐름과 처리 로직 중심
-- 성능과 보안 최적화 고려
-- API 설계와 데이터베이스 구조 중시
-
-## 소통 스타일
-- API 문서와 데이터 스키마 제공
-- 기술적 세부사항 명확히 전달
-- 성능 지표와 보안 고려사항 강조`,
-
-      data_analyst: `---
-persona_name: data_analyst
-analysis_approach: 데이터 기반 의사결정
-design_principles:
-  - 정확성
-  - 통찰력
-  - 시각화
-communication_style: 분석적이고 통계적
----
-
-# 데이터 분석가 페르소나 컨텍스트
-
-## 핵심 역할
-데이터를 분석하여 인사이트를 도출하고 의사결정을 지원하는 역할을 수행합니다.
-
-## 분석 접근법
-- 정량적 데이터 분석 우선
-- 통계적 방법론 적용
-- 시각화를 통한 인사이트 전달
-
-## 소통 스타일
-- 차트와 그래프 활용
-- 데이터 기반 근거 제시
-- 객관적이고 중립적인 관점`,
-
-      security: `---
-persona_name: security
-analysis_approach: 보안 취약점 중심
-design_principles:
-  - 보안성
-  - 무결성
-  - 기밀성
-communication_style: 신중하고 방어적
----
-
-# 보안 페르소나 컨텍스트
-
-## 핵심 역할
-시스템의 보안 취약점을 식별하고 보호 방안을 제시하는 역할을 수행합니다.
-
-## 분석 접근법
-- 위협 모델링과 취약점 분석
-- 보안 모범 사례 적용
-- 컴플라이언스 요구사항 고려
-
-## 소통 스타일
-- 위험도 평가와 우선순위 제시
-- 구체적인 보안 대책 제안
-- 예방적 접근과 지속적 모니터링 강조`
-    };
-
-    const content = defaultContexts[persona] || `---
-persona_name: ${persona}
-analysis_approach: 일반적 접근
-design_principles:
-  - 품질
-  - 효율성
-communication_style: 표준적
----
-
-# ${persona} 페르소나 컨텍스트
-
-기본 페르소나 컨텍스트입니다.`;
-
-    // 디렉토리 생성
-    const dir = path.dirname(filePath);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-
-    // 파일 생성
-    fs.writeFileSync(filePath, content, 'utf-8');
-    console.log(`기본 컨텍스트 파일 생성: ${persona}`);
-  }
-
-  /**
-   * 파일 변경 처리
-   * @param {string} persona - 페르소나 이름
-   * @param {string} filePath - 파일 경로
-   */
-  async handleFileChange(persona, filePath) {
-    console.log(`컨텍스트 변경 감지: ${persona}`);
-    
-    // 업데이트 큐에 추가
-    this.updateQueue.push({
-      type: 'change',
-      persona,
-      filePath,
-      timestamp: new Date().toISOString()
-    });
-
-    // 큐 처리
-    this.processUpdateQueue();
-  }
-
-  /**
-   * 파일 추가 처리
-   * @param {string} persona - 페르소나 이름
-   * @param {string} filePath - 파일 경로
-   */
-  handleFileAdd(persona, filePath) {
-    console.log(`컨텍스트 파일 추가: ${persona}`);
-    
-    this.updateQueue.push({
-      type: 'add',
-      persona,
-      filePath,
-      timestamp: new Date().toISOString()
-    });
-
-    this.processUpdateQueue();
-  }
-
-  /**
-   * 파일 제거 처리
-   * @param {string} persona - 페르소나 이름
-   * @param {string} filePath - 파일 경로
-   */
-  handleFileRemove(persona, filePath) {
-    console.log(`컨텍스트 파일 제거: ${persona}`);
-    
-    this.updateQueue.push({
-      type: 'remove',
-      persona,
-      filePath,
-      timestamp: new Date().toISOString()
-    });
-
-    this.processUpdateQueue();
-  }
-
-  /**
-   * 감시 오류 처리
-   * @param {string} persona - 페르소나 이름
-   * @param {Error} error - 오류 객체
-   */
-  handleWatchError(persona, error) {
-    console.error(`감시 오류 (${persona}):`, error);
-    
-    // 폴링으로 전환
-    const contextPath = path.join(
-      process.cwd(),
-      '.aiwf',
-      '07_AI_PERSONAS',
-      persona,
-      'context_rules.md'
-    );
-    this.startPolling(persona, contextPath);
-  }
-
-  /**
-   * 폴링 방식으로 파일 감시
-   * @param {string} persona - 페르소나 이름
-   * @param {string} filePath - 파일 경로
-   */
-  startPolling(persona, filePath) {
-    const pollInterval = 5000; // 5초마다 확인
-
-    const checkFile = async () => {
-      try {
-        const stats = await fs.promises.stat(filePath);
-        const lastModified = stats.mtimeMs;
-        const previousModified = this.lastUpdateTimes.get(persona);
-
-        if (previousModified && lastModified !== previousModified) {
-          this.handleFileChange(persona, filePath);
-        }
-
-        this.lastUpdateTimes.set(persona, lastModified);
-      } catch (error) {
-        // 파일이 없으면 생성
-        if (error.code === 'ENOENT') {
-          this.createDefaultContextFile(persona, filePath);
-        }
-      }
-    };
-
-    // 기존 인터벌 정리
-    if (this.pollingInterval) {
-      clearInterval(this.pollingInterval);
-    }
-
-    // 새 인터벌 설정
-    this.pollingInterval = setInterval(checkFile, pollInterval);
-    console.log(`폴링 모드로 전환: ${persona}`);
-  }
-
-  /**
-   * 업데이트 큐 처리
-   */
-  async processUpdateQueue() {
-    if (this.isProcessing || this.updateQueue.length === 0) {
-      return;
-    }
-
-    this.isProcessing = true;
-
-    while (this.updateQueue.length > 0) {
-      const update = this.updateQueue.shift();
-      
-      try {
-        await this.processUpdate(update);
-      } catch (error) {
-        console.error('업데이트 처리 오류:', error);
-        this.emit('error', { update, error });
-      }
-    }
-
-    this.isProcessing = false;
-  }
-
-  /**
-   * 개별 업데이트 처리
-   * @param {Object} update - 업데이트 정보
-   */
-  async processUpdate(update) {
-    const { type, persona, filePath, timestamp } = update;
-
-    switch (type) {
-      case 'change':
-      case 'add':
-        // 컨텍스트 다시 파싱
-        const newContext = await this.contextParser.parseContextRules(persona);
-        
-        // 캐시 무효화
-        this.contextParser.clearCache();
-        
-        // 이벤트 발생
-        this.emit('contextUpdated', {
-          persona,
-          context: newContext,
-          updateType: type,
-          timestamp
-        });
-        
-        console.log(`컨텍스트 업데이트 완료: ${persona}`);
-        break;
-
-      case 'remove':
-        // 기본 컨텍스트로 복원
-        this.createDefaultContextFile(persona, filePath);
-        
-        this.emit('contextRemoved', {
-          persona,
-          timestamp
-        });
-        break;
-    }
-  }
-
-  /**
-   * 이벤트 핸들러 설정
-   */
-  setupEventHandlers() {
-    // 컨텍스트 업데이트 시 로깅
-    this.on('contextUpdated', (data) => {
-      console.log(`[이벤트] 컨텍스트 업데이트: ${data.persona} (${data.updateType})`);
-    });
-
-    // 오류 발생 시 로깅
-    this.on('error', (data) => {
-      console.error(`[이벤트] 오류 발생:`, data.error);
-    });
-  }
-
-  /**
-   * 모든 감시 중지
-   */
-  stopWatching() {
-    // Chokidar 감시자 정리
-    this.watchers.forEach((watcher, persona) => {
-      watcher.close();
-      console.log(`감시 중지: ${persona}`);
-    });
-    this.watchers.clear();
-
-    // 폴링 인터벌 정리
-    if (this.pollingInterval) {
-      clearInterval(this.pollingInterval);
-      this.pollingInterval = null;
-    }
-
-    // 큐 초기화
-    this.updateQueue = [];
-    this.isProcessing = false;
-  }
-
-  /**
-   * 특정 페르소나 감시 중지
-   * @param {string} persona - 페르소나 이름
-   */
-  stopWatchingPersona(persona) {
-    const watcher = this.watchers.get(persona);
-    if (watcher) {
-      watcher.close();
-      this.watchers.delete(persona);
-      console.log(`감시 중지: ${persona}`);
-    }
-  }
-
-  /**
-   * 감시 상태 확인
-   * @returns {Object} 감시 상태 정보
-   */
-  getWatchStatus() {
-    const activeWatchers = Array.from(this.watchers.keys());
-    const queueLength = this.updateQueue.length;
-    const isPolling = this.pollingInterval !== null;
-
-    return {
-      activeWatchers,
-      watcherCount: activeWatchers.length,
-      queueLength,
-      isProcessing: this.isProcessing,
-      isPolling,
-      lastUpdateTimes: Object.fromEntries(this.lastUpdateTimes)
-    };
-  }
-
-  /**
-   * 강제 업데이트 트리거
-   * @param {string} persona - 페르소나 이름
-   */
-  forceUpdate(persona) {
-    const contextPath = path.join(
-      process.cwd(),
-      '.aiwf',
-      '07_AI_PERSONAS',
-      persona,
-      'context_rules.md'
-    );
-
-    this.handleFileChange(persona, contextPath);
-  }
-
-  /**
-   * 모든 페르소나 강제 업데이트
-   */
-  forceUpdateAll() {
-    const personas = Array.from(this.watchers.keys());
-    personas.forEach(persona => this.forceUpdate(persona));
-  }
-}
-
-module.exports = ContextUpdateManager;

package/src/lib/resources/utils/git-utils.js

@@ -1,220 +0,0 @@
-const { exec } = require('child_process');
-const { promisify } = require('util');
-const execAsync = promisify(exec);
-const path = require('path');
-const { extractFeatureIds, extractFeatureIdFromBranch } = require('../config/commit-patterns');
-
-/**
- * Git 커밋 정보를 추출하는 유틸리티 모듈
- */
-
-/**
- * Git 명령어 실행
- * @param {string} command - 실행할 git 명령어
- * @param {string} cwd - 작업 디렉토리 (선택사항)
- * @returns {Promise<string>} - 명령어 출력
- */
-async function runGitCommand(command, cwd = process.cwd()) {
-  try {
-    const { stdout, stderr } = await execAsync(`git ${command}`, { cwd });
-    if (stderr && !stderr.includes('warning:')) {
-      throw new Error(`Git command failed: ${stderr}`);
-    }
-    return stdout.trim();
-  } catch (error) {
-    throw new Error(`Git command execution failed: ${error.message}`);
-  }
-}
-
-/**
- * 현재 브랜치 이름 가져오기
- * @returns {Promise<string>} - 브랜치 이름
- */
-async function getCurrentBranch() {
-  return await runGitCommand('rev-parse --abbrev-ref HEAD');
-}
-
-/**
- * 커밋 정보 객체 구조
- * @typedef {Object} CommitInfo
- * @property {string} hash - 커밋 해시
- * @property {string} author - 작성자
- * @property {string} date - 커밋 날짜
- * @property {string} message - 커밋 메시지
- * @property {Array<string>} featureIds - 관련 Feature ID 목록
- */
-
-/**
- * 특정 커밋의 상세 정보 가져오기
- * @param {string} commitHash - 커밋 해시
- * @returns {Promise<CommitInfo>} - 커밋 정보
- */
-async function getCommitInfo(commitHash) {
-  const format = '%H%n%an%n%aI%n%s%n%b';
-  const output = await runGitCommand(`show -s --format="${format}" ${commitHash}`);
-  const lines = output.split('\n');
-  
-  const message = lines.slice(3).join('\n').trim();
-  const featureIds = extractFeatureIds(message);
-  
-  return {
-    hash: lines[0],
-    author: lines[1],
-    date: lines[2],
-    message: message,
-    featureIds: featureIds
-  };
-}
-
-/**
- * 커밋 범위에서 Feature 관련 커밋 찾기
- * @param {string} since - 시작 날짜 (예: '2025-01-01')
- * @param {string} until - 종료 날짜 (선택사항)
- * @returns {Promise<Array<CommitInfo>>} - Feature 관련 커밋 목록
- */
-async function getFeatureRelatedCommits(since, until = 'HEAD') {
-  try {
-    // git log 명령어 구성
-    let command = `log --since="${since}"`;
-    if (until !== 'HEAD') {
-      command += ` --until="${until}"`;
-    }
-    command += ' --pretty=format:"%H" --grep="FL[0-9]\\{3\\}"';
-    
-    const output = await runGitCommand(command);
-    if (!output) {
-      return [];
-    }
-    
-    const commitHashes = output.split('\n').filter(Boolean);
-    const commits = [];
-    
-    for (const hash of commitHashes) {
-      const commitInfo = await getCommitInfo(hash);
-      if (commitInfo.featureIds.length > 0) {
-        commits.push(commitInfo);
-      }
-    }
-    
-    return commits;
-  } catch (error) {
-    console.error('Error getting feature related commits:', error);
-    return [];
-  }
-}
-
-/**
- * 특정 Feature ID와 관련된 모든 커밋 찾기
- * @param {string} featureId - Feature ID (예: 'FL001')
- * @returns {Promise<Array<CommitInfo>>} - 해당 Feature의 커밋 목록
- */
-async function getCommitsByFeatureId(featureId) {
-  try {
-    const command = `log --pretty=format:"%H" --grep="${featureId}"`;
-    const output = await runGitCommand(command);
-    
-    if (!output) {
-      return [];
-    }
-    
-    const commitHashes = output.split('\n').filter(Boolean);
-    const commits = [];
-    
-    for (const hash of commitHashes) {
-      const commitInfo = await getCommitInfo(hash);
-      if (commitInfo.featureIds.includes(featureId)) {
-        commits.push(commitInfo);
-      }
-    }
-    
-    return commits;
-  } catch (error) {
-    console.error(`Error getting commits for feature ${featureId}:`, error);
-    return [];
-  }
-}
-
-/**
- * 현재 브랜치의 Feature ID 추출
- * @returns {Promise<string|null>} - Feature ID 또는 null
- */
-async function getCurrentFeatureId() {
-  try {
-    const branch = await getCurrentBranch();
-    return extractFeatureIdFromBranch(branch);
-  } catch (error) {
-    console.error('Error getting current feature ID:', error);
-    return null;
-  }
-}
-
-/**
- * 최근 N개의 커밋에서 Feature 관련 커밋 찾기
- * @param {number} count - 확인할 커밋 수
- * @returns {Promise<Array<CommitInfo>>} - Feature 관련 커밋 목록
- */
-async function getRecentFeatureCommits(count = 10) {
-  try {
-    const command = `log -${count} --pretty=format:"%H"`;
-    const output = await runGitCommand(command);
-    
-    if (!output) {
-      return [];
-    }
-    
-    const commitHashes = output.split('\n').filter(Boolean);
-    const featureCommits = [];
-    
-    for (const hash of commitHashes) {
-      const commitInfo = await getCommitInfo(hash);
-      if (commitInfo.featureIds.length > 0) {
-        featureCommits.push(commitInfo);
-      }
-    }
-    
-    return featureCommits;
-  } catch (error) {
-    console.error('Error getting recent feature commits:', error);
-    return [];
-  }
-}
-
-/**
- * Git 저장소인지 확인
- * @param {string} dir - 확인할 디렉토리
- * @returns {Promise<boolean>}
- */
-async function isGitRepository(dir = process.cwd()) {
-  try {
-    await runGitCommand('rev-parse --git-dir', dir);
-    return true;
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * 변경된 파일 목록 가져오기
- * @returns {Promise<Array<string>>} - 변경된 파일 경로 목록
- */
-async function getChangedFiles() {
-  try {
-    const output = await runGitCommand('diff --name-only HEAD');
-    return output ? output.split('\n').filter(Boolean) : [];
-  } catch (error) {
-    console.error('Error getting changed files:', error);
-    return [];
-  }
-}
-
-module.exports = {
-  runGitCommand,
-  getCurrentBranch,
-  getCommitInfo,
-  getFeatureRelatedCommits,
-  getCommitsByFeatureId,
-  getCurrentFeatureId,
-  getRecentFeatureCommits,
-  isGitRepository,
-  getChangedFiles
-};