aiwf 0.3.4 → 0.3.5

package/.aiwf/metrics/metrics.json

@@ -0,0 +1,18 @@
+{
+  "sessions": [],
+  "personaPerformance": {},
+  "taskOutcomes": [],
+  "aggregated": {
+    "eventCounts": {
+      "persona_switch": 1
+    },
+    "personaSwitches": [
+      {
+        "from": "developer",
+        "to": "architect",
+        "trigger": "auto",
+        "timestamp": 1752885541651
+      }
+    ]
+  }
+}

package/.aiwf/personas/current.json

@@ -0,0 +1,5 @@
+{
+  "name": "developer",
+  "description": "일반 개발자 (기본값)",
+  "activatedAt": "2025-07-19T01:15:42.150Z"
+}

package/.claude/commands/aiwf/aiwf_persona_architect.md

@@ -3,7 +3,7 @@
 AI를 시스템 아키텍처 전문가 모드로 전환합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js architect
+aiwf persona set architect
 ```
 
 ## 페르소나 컨텍스트 적용

package/.claude/commands/aiwf/aiwf_persona_backend.md

@@ -3,7 +3,7 @@
 AI를 백엔드 개발 전문가 모드로 전환합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js backend
+aiwf persona set developer
 ```
 
 ## 페르소나 컨텍스트 적용

package/.claude/commands/aiwf/aiwf_persona_data_analyst.md

@@ -3,7 +3,7 @@
 AI를 데이터 분석 전문가 모드로 전환합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js data_analyst
+aiwf persona set developer
 ```
 
 ## 페르소나 컨텍스트 적용

package/.claude/commands/aiwf/aiwf_persona_frontend.md

@@ -3,7 +3,7 @@
 AI를 프론트엔드 개발 전문가 모드로 전환합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js frontend
+aiwf persona set developer
 ```
 
 ## 페르소나 컨텍스트 적용

package/.claude/commands/aiwf/aiwf_persona_security.md

@@ -3,7 +3,7 @@
 AI를 보안 전문가 모드로 전환합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js security
+aiwf persona set security
 ```
 
 ## 페르소나 컨텍스트 적용

package/.claude/commands/aiwf/aiwf_persona_status.md

@@ -3,7 +3,7 @@
 현재 활성화된 AI 페르소나의 상태를 확인합니다.
 
 ```bash
-cd .aiwf && node ../claude-code/aiwf/ko/commands/ai-persona.js status
+aiwf persona status
 ```
 
 ## 설명

package/CHANGELOG.md

@@ -7,6 +7,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.5] - 2025-07-19
+
+### ✨ Features
+- **Persona Management**: Implement unified persona management system (`b913da0`)
+- **Runtime State**: Add runtime persona state and metrics tracking (`6e5ca2c`)
+- **Templates**: Add AIWF test instance and project templates (`3034bce`)
+- **Korean Support**: AIWF 한글 템플릿 추가 문서 및 파일 보완 (`5a24037`)
+- **Template Structure**: AIWF 한글 템플릿 구조 완성 (`f12fb76`)
+- **Template Manager**: 템플릿 관리자 구현 및 작업 템플릿 개선 (`feec001`)
+- **Context Compression**: Implement persona-aware context compression (`646fd4c`)
+- **Quality Evaluation**: Add persona quality evaluation system (`4b60a79`)
+- **Claude Commands**: Add Claude Code commands for 5 AI personas (`3ccdb7b`)
+- **Feature Ledger**: Implement Feature Ledger CLI with full CRUD operations (`97c15b3`)
+
+### 📝 Documentation
+- **Persona Docs**: Standardize persona command documentation (`a5a1a98`)
+- **README**: Update README with new persona features (`5dbafc6`)
+
+### ♻️ Refactoring
+- **Project Structure**: 완전한 src 폴더 구조 통합 및 정리 (`92fc7f0`)
+- **Evaluation System**: Replace complex evaluation with lightweight background monitoring (`b39da95`)
+
+### 🔧 Build/Config
+- **Dependencies**: Bump version to 0.3.4 and clean up dependencies (`66166cb`)
+- **Gitignore**: Add .aiwf/backup_*/ pattern to .gitignore (`2952457`)
+- **Development Rules**: Update .gitignore and add framework development rules to CLAUDE.md (`e58a4eb`)
+
+### 🔄 Other Changes
+- 버전 0.3.3으로 업데이트 및 불필요한 압축 관련 문서 삭제 (`9c7c67e`)
+- 설치 완료 플래그 파일 생성 및 기존 설치 확인 로직 수정 (`e956b59`)
+- 버전 업데이트 및 불필요한 CLI 명령어 제거 (`659e6b5`)
+
+## [0.3.4] - 2025-07-19
+
+### 🔧 Build/Config
+- Clean up dependencies and update package configuration
+
+## [0.3.3] - 2025-07-14
+
+### 🔄 Other Changes
+- Remove unnecessary compression-related documentation
+- Create installation completion flag file
+- Fix existing installation check logic
+- Remove unnecessary CLI commands
+
 ### Added
 - 📚 **Comprehensive Documentation Suite**
   - API Reference guide with complete module documentation
@@ -124,8 +169,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - GitHub repository download functionality
 - Simple installation script
 
-[Unreleased]: https://github.com/aiwf/aiwf/compare/v1.0.0...HEAD
-[1.0.0]: https://github.com/aiwf/aiwf/compare/v0.3.0...v1.0.0
-[0.3.0]: https://github.com/aiwf/aiwf/compare/v0.2.0...v0.3.0
-[0.2.0]: https://github.com/aiwf/aiwf/compare/v0.1.0...v0.2.0
-[0.1.0]: https://github.com/aiwf/aiwf/releases/tag/v0.1.0
+[Unreleased]: https://github.com/moonklabs/aiwf/compare/v0.3.5...HEAD
+[0.3.5]: https://github.com/moonklabs/aiwf/compare/v0.3.4...v0.3.5
+[0.3.4]: https://github.com/moonklabs/aiwf/compare/v0.3.3...v0.3.4
+[0.3.3]: https://github.com/moonklabs/aiwf/compare/v0.3.1...v0.3.3
+[0.3.1]: https://github.com/moonklabs/aiwf/compare/v1.0.0...v0.3.1
+[1.0.0]: https://github.com/moonklabs/aiwf/compare/v0.3.0...v1.0.0
+[0.3.0]: https://github.com/moonklabs/aiwf/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/moonklabs/aiwf/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/moonklabs/aiwf/releases/tag/v0.1.0

package/claude-code/aiwf/ko/commands/ai-persona.js

@@ -5,7 +5,7 @@
  * 다양한 개발 작업을 위한 AI 행동 페르소나 관리
  */
 
-import { AIPersonaManager } from '../../../../lib/ai-persona-manager.js';
+import { AIPersonaManager } from '../../../../src/lib/ai-persona-manager.js';
 import { getBackgroundMonitor } from '../utils/background-monitor.js';
 import path from 'path';
 import chalk from 'chalk';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "aiwf",
-    "version": "0.3.4",
+    "version": "0.3.5",
     "description": "AI Workflow Framework for Claude Code with multi-language support (Korean/English)",
     "main": "index.js",
     "type": "module",

package/src/cli/index.js

@@ -4,6 +4,7 @@ import { program } from 'commander';
 import chalk from 'chalk';
 import { installAIWF } from '../lib/installer.js';
 import AIToolCommand from '../commands/ai-tool.js';
+import PersonaCommand from '../commands/persona.js';
 import { CacheCLI } from './cache-cli.js';
 
 // Parse version from package.json
@@ -161,5 +162,45 @@ lang
     await resetLanguage();
   });
 
+// Persona management commands
+const persona = program.command('persona');
+persona.description('Manage AI personas / AI 페르소나 관리');
+
+persona
+  .command('status')
+  .alias('s')
+  .description('Show current persona status / 현재 페르소나 상태 표시')
+  .action(async () => {
+    const personaCmd = new PersonaCommand();
+    await personaCmd.showStatus();
+  });
+
+persona
+  .command('list')
+  .alias('ls')
+  .description('List available personas / 사용 가능한 페르소나 목록')
+  .action(async () => {
+    const personaCmd = new PersonaCommand();
+    await personaCmd.listPersonas();
+  });
+
+persona
+  .command('set <persona-name>')
+  .alias('switch')
+  .description('Switch to specific persona / 특정 페르소나로 전환')
+  .action(async (personaName) => {
+    const personaCmd = new PersonaCommand();
+    await personaCmd.setPersona(personaName);
+  });
+
+persona
+  .command('reset')
+  .alias('r')
+  .description('Reset to default persona / 기본 페르소나로 리셋')
+  .action(async () => {
+    const personaCmd = new PersonaCommand();
+    await personaCmd.resetPersona();
+  });
+
 // Parse command line arguments
 program.parse(process.argv);

package/src/commands/persona.js

@@ -0,0 +1,288 @@
+#!/usr/bin/env node
+
+/**
+ * AI 페르소나 명령어
+ * AI 행동 페르소나 관리 및 전환
+ */
+
+import { AIPersonaManager } from '../lib/ai-persona-manager.js';
+import path from 'path';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+class PersonaCommand {
+  constructor() {
+    this.personaManager = null;
+  }
+
+  /**
+   * 페르소나 매니저 초기화
+   */
+  async initPersonaManager() {
+    if (!this.personaManager) {
+      this.personaManager = new AIPersonaManager({
+        personaConfigPath: path.join(process.cwd(), '.aiwf', 'personas'),
+        metricsPath: path.join(process.cwd(), '.aiwf', 'metrics'),
+        metricsEnabled: true,
+        autoDetectionEnabled: true
+      });
+      
+      await this.personaManager.init();
+    }
+    
+    return this.personaManager;
+  }
+
+  /**
+   * 페르소나 상태 표시
+   */
+  async showStatus() {
+    try {
+      // 파일에서 현재 페르소나 읽기
+      const fs = await import('fs/promises');
+      const path = await import('path');
+      const personaFile = path.join(process.cwd(), '.aiwf', 'personas', 'current.json');
+      
+      try {
+        const content = await fs.readFile(personaFile, 'utf-8');
+        const currentPersona = JSON.parse(content);
+        
+        console.log(chalk.cyan('🎭 현재 AI 페르소나 상태'));
+        console.log(chalk.gray('-'.repeat(50)));
+        console.log(`현재 페르소나: ${chalk.yellow(currentPersona.name)}`);
+        console.log(`설명: ${currentPersona.description}`);
+        console.log(`활성화 시간: ${new Date(currentPersona.activatedAt).toLocaleString('ko-KR')}`);
+        
+        const behaviors = this.getKoreanBehaviors(currentPersona.name);
+        if (behaviors.length > 0) {
+          console.log('\n주요 동작:');
+          behaviors.forEach(behavior => {
+            console.log(`  • ${behavior}`);
+          });
+        }
+
+        console.log(chalk.gray('\n' + '-'.repeat(50)));
+        console.log(chalk.green('✅ 페르소나가 활성화되어 있습니다.'));
+        
+      } catch (fileError) {
+        console.log(chalk.yellow('⚠️  현재 활성화된 페르소나가 없습니다.'));
+        console.log(chalk.gray('사용 가능한 페르소나 목록을 보려면: aiwf persona list'));
+        console.log(chalk.gray('페르소나를 설정하려면: aiwf persona set <페르소나명>'));
+      }
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 페르소나 상태 확인 중 오류가 발생했습니다:'), error.message);
+      console.error(error.stack);
+    }
+  }
+
+  /**
+   * 페르소나 목록 표시
+   */
+  async listPersonas() {
+    try {
+      console.log(chalk.cyan('🎭 사용 가능한 AI 페르소나'));
+      console.log(chalk.gray('-'.repeat(50)));
+      
+      // 기본 페르소나 목록을 하드코딩으로 표시 (초기화 문제 회피)
+      const defaultPersonas = [
+        { name: 'architect', description: '시스템 설계 및 아키텍처 전문가' },
+        { name: 'developer', description: '일반 개발자 (기본값)' },
+        { name: 'reviewer', description: '코드 리뷰 및 품질 관리 전문가' },
+        { name: 'debugger', description: '디버깅 및 문제 해결 전문가' },
+        { name: 'optimizer', description: '성능 최적화 전문가' },
+        { name: 'security', description: '보안 및 취약점 분석 전문가' },
+        { name: 'documenter', description: '문서화 및 기술 작성 전문가' }
+      ];
+      
+      defaultPersonas.forEach(persona => {
+        const displayName = chalk.yellow(persona.name);
+        console.log(`  ${displayName} - ${persona.description}`);
+      });
+      
+      console.log(chalk.gray('\n' + '-'.repeat(50)));
+      console.log(chalk.gray('사용법: aiwf persona set <페르소나명>'));
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 페르소나 목록 조회 중 오류가 발생했습니다:'), error.message);
+      console.error(error.stack);
+    }
+  }
+
+  /**
+   * 페르소나 전환
+   */
+  async setPersona(personaName) {
+    if (!personaName) {
+      console.error(chalk.red('❌ 페르소나 이름을 지정해주세요.'));
+      console.log(chalk.gray('사용법: aiwf persona set <페르소나명>'));
+      console.log(chalk.gray('사용 가능한 페르소나: aiwf persona list'));
+      return;
+    }
+
+    try {
+      // 유효한 페르소나인지 확인
+      const validPersonas = ['architect', 'developer', 'reviewer', 'debugger', 'optimizer', 'security', 'documenter'];
+      
+      if (!validPersonas.includes(personaName)) {
+        console.error(chalk.red(`❌ 페르소나 '${personaName}'를 찾을 수 없습니다.`));
+        console.log(chalk.gray('사용 가능한 페르소나: aiwf persona list'));
+        return;
+      }
+
+      // 간단한 페르소나 설정 (파일 기반)
+      const fs = await import('fs/promises');
+      const path = await import('path');
+      const personaDir = path.join(process.cwd(), '.aiwf', 'personas');
+      
+      // 디렉토리 생성
+      await fs.mkdir(personaDir, { recursive: true });
+      
+      // 현재 페르소나 저장
+      const personaConfig = {
+        name: personaName,
+        description: this.getKoreanDescription(personaName),
+        activatedAt: new Date().toISOString()
+      };
+      
+      await fs.writeFile(
+        path.join(personaDir, 'current.json'),
+        JSON.stringify(personaConfig, null, 2)
+      );
+      
+      console.log(chalk.green('🎭 AI 페르소나 활성화 완료'));
+      console.log(chalk.gray('-'.repeat(50)));
+      console.log(`현재 페르소나: ${chalk.yellow(personaName)}`);
+      console.log(`전문 분야: ${this.getKoreanDescription(personaName)}`);
+      console.log(chalk.gray('-'.repeat(50)));
+      console.log(chalk.green('✅ 페르소나가 성공적으로 활성화되었습니다.'));
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 페르소나 전환 중 오류가 발생했습니다:'), error.message);
+      console.error(error.stack);
+    }
+  }
+
+  /**
+   * 페르소나 리셋
+   */
+  async resetPersona() {
+    try {
+      // 기본 페르소나(developer)로 리셋
+      await this.setPersona('developer');
+      console.log(chalk.green('🔄 페르소나가 기본값(developer)으로 리셋되었습니다.'));
+      
+    } catch (error) {
+      console.error(chalk.red('❌ 페르소나 리셋 중 오류가 발생했습니다:'), error.message);
+      console.error(error.stack);
+    }
+  }
+
+  /**
+   * 명령어 실행
+   */
+  async execute(args) {
+    const [subcommand, ...restArgs] = args;
+
+    switch (subcommand) {
+      case 'status':
+        await this.showStatus();
+        break;
+      case 'list':
+        await this.listPersonas();
+        break;
+      case 'set':
+        await this.setPersona(restArgs[0]);
+        break;
+      case 'reset':
+        await this.resetPersona();
+        break;
+      default:
+        this.showHelp();
+        break;
+    }
+  }
+
+  /**
+   * 도움말 표시
+   */
+  showHelp() {
+    console.log(chalk.cyan('🎭 AIWF 페르소나 관리'));
+    console.log(chalk.gray('-'.repeat(50)));
+    console.log('사용법: aiwf persona <명령어> [옵션]');
+    console.log('');
+    console.log('명령어:');
+    console.log('  status              현재 페르소나 상태 표시');
+    console.log('  list                사용 가능한 페르소나 목록');
+    console.log('  set <페르소나명>     특정 페르소나로 전환');
+    console.log('  reset               기본 페르소나로 리셋');
+    console.log('');
+    console.log('예시:');
+    console.log('  aiwf persona status');
+    console.log('  aiwf persona list');
+    console.log('  aiwf persona set architect');
+    console.log('  aiwf persona reset');
+  }
+
+  /**
+   * 한국어 설명 가져오기
+   */
+  getKoreanDescription(persona) {
+    const descriptions = {
+      architect: '시스템 설계 및 아키텍처 전문가',
+      developer: '일반 개발자 (기본값)',
+      reviewer: '코드 리뷰 및 품질 관리 전문가',
+      debugger: '디버깅 및 문제 해결 전문가',
+      optimizer: '성능 최적화 전문가',
+      security: '보안 및 취약점 분석 전문가',
+      devops: 'DevOps 및 인프라 관리 전문가',
+      tester: '테스트 및 QA 전문가',
+      documenter: '문서화 및 기술 작성 전문가',
+      mentor: '멘토링 및 교육 전문가'
+    };
+    
+    return descriptions[persona] || '설명 없음';
+  }
+
+  /**
+   * 한국어 동작 설명 가져오기
+   */
+  getKoreanBehaviors(persona) {
+    const behaviors = {
+      architect: [
+        '큰 그림과 전체 시스템 구조에 집중',
+        '확장성과 유지보수성 우선시',
+        '디자인 패턴과 아키텍처 원칙 적용',
+        '통합 지점과 인터페이스 고려'
+      ],
+      developer: [
+        '실용적이고 효율적인 코드 작성',
+        '베스트 프랙티스 적용',
+        '가독성과 유지보수성 중시'
+      ],
+      reviewer: [
+        '코드 품질과 표준 준수 확인',
+        '잠재적 버그와 개선점 식별',
+        '성능과 보안 측면 검토'
+      ],
+      debugger: [
+        '문제의 근본 원인 분석',
+        '체계적인 디버깅 접근',
+        '재현 가능한 테스트 케이스 생성'
+      ],
+      optimizer: [
+        '성능 병목 지점 식별',
+        '메모리 사용량 최적화',
+        '알고리즘 효율성 개선'
+      ]
+    };
+    
+    return behaviors[persona] || ['기본 동작'];
+  }
+}
+
+export default PersonaCommand;