aiwf 0.3.3 → 0.3.4

package/.eslintrc.json

@@ -0,0 +1,26 @@
+{
+  "extends": ["eslint:recommended"],
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module"
+  },
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "rules": {
+    "no-console": "warn",
+    "no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "prefer-const": "error",
+    "no-var": "error",
+    "eqeqeq": ["error", "always"],
+    "curly": ["error", "all"],
+    "quotes": ["error", "single"],
+    "semi": ["error", "always"],
+    "indent": ["error", 2],
+    "no-trailing-spaces": "error",
+    "comma-dangle": ["error", "never"],
+    "object-curly-spacing": ["error", "always"],
+    "array-bracket-spacing": ["error", "never"]
+  }
+}

package/.prettierrc

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "trailingComma": "none",
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+}

package/CLAUDE.md

@@ -20,65 +20,139 @@ The AIWF project is organized as follows:
 
 ```
 aiwf/
-├── claude-code/           # Template files for AIWF installation
-│   ├── aiwf/             # Core AIWF templates
-│   │   ├── en/           # English language templates
-│   │   └── ko/           # Korean language templates
-│   └── docker/           # Docker configuration
+├── ai-tools/             # AI tool-specific configurations
+│   ├── claude-code/      # Claude Code specific settings
+│   ├── cursor/           # Cursor AI integration
+│   ├── windsurf/        # Windsurf integration
+│   └── github-copilot/   # GitHub Copilot integration
+├── commands/             # AIWF command implementations
+│   ├── ai-persona.js     # AI persona management
+│   ├── compress-context.js # Context compression
+│   ├── evaluate.js       # Evaluation functionality
+│   ├── feature-ledger.js # Feature tracking
+│   └── token-tracking.js # Token usage monitoring
+├── config/               # Configuration files
+│   ├── commit-patterns.js # Git commit patterns
+│   └── language.json     # Language settings
 ├── docs/                 # Project documentation
+├── feature-ledger/       # Feature tracking JSON files
+│   ├── FL-001-authentication.json
+│   └── feature-index.json
+├── hooks/                # Git hooks and installation scripts
+│   ├── install-hooks.sh  # Hook installation script
+│   └── post-commit       # Post-commit hook
 ├── lib/                  # Core library modules
-├── src/                  # Source code
+├── personas/             # AI persona definitions and knowledge bases
+├── rules/                # Development rules and guidelines
+│   ├── global/          # Global development rules
+│   └── manual/          # Manual operation guides
+├── scripts/              # Build and utility scripts
+├── templates/            # Project templates
+│   ├── api-server/      # Express.js API server template
+│   ├── npm-library/     # NPM library template
+│   └── web-app/         # React web app template
 ├── tests/                # Test suites
 │   ├── integration/      # Integration tests
 │   └── unit/            # Unit tests
-├── scripts/              # Build and validation scripts
-├── rules/                # Development rules and guidelines
+├── utils/                # Utility modules
 ├── package.json          # NPM package configuration
 ├── CLAUDE.md            # This file - Claude Code guidance
 └── README.md            # Project documentation
 ```
 
-## claude-code Directory
+## AI Tools Directory
+
+The `ai-tools/` directory contains configurations for various AI coding assistants:
+
+- **claude-code/**: Claude Code specific settings and templates
+- **cursor/**: Cursor AI integration files
+- **windsurf/**: Windsurf configuration
+- **github-copilot/**: GitHub Copilot integration
+- **augment/**: Augment AI tool configuration
+
+Each tool directory includes:
+- `config.json`: Tool-specific configuration
+- `template/`: Template files for that specific AI tool
+- `README.md`: Documentation for the integration
+
+## Commands Directory
 
-The `claude-code/` directory contains template files that are copied during AIWF installation. It's structured by language:
+The `commands/` directory contains all AIWF command implementations:
 
-### Language Structure (en/ and ko/)
-- **commands/**: Claude Code command implementations
-  - ai-persona.js - AI persona management
-  - compress-context.js - Context compression utilities
-  - feature_commit_report.js - Git commit reporting
-  - scan_git_history.js - Git history analysis
-  - sync_feature_commits.js - Feature commit synchronization
-  - token-tracking.js - Token usage monitoring
+- **ai-persona.js**: Manages AI personas and their behaviors
+- **compress-context.js**: Compresses context to optimize token usage
+- **evaluate.js**: Evaluates code quality and AI responses
+- **feature-ledger.js**: Tracks features and their development status
+- **feature-commit-report.js**: Generates reports from git commits
+- **persona-context-apply.js**: Applies persona contexts to AI interactions
+- **scan-git-history.js**: Analyzes git history for insights
+- **sync-feature-commits.js**: Synchronizes feature commits with ledger
+- **token-tracking.js**: Monitors and reports token usage
 
-- **utils/**: Utility modules
-  - compression-*.js - Various compression strategies
-  - git-utils.js - Git operation utilities
-  - token-*.js - Token tracking and optimization
-  - text-summarizer.js - Text summarization utilities
+## Templates Directory
 
-- **config/**: Configuration files
-  - commit-patterns.js - Git commit pattern definitions
+The `templates/` directory provides starter templates for different project types:
 
-- **hooks/**: Git hooks
-  - post-commit - Post-commit hook script
-  - install-hooks.sh - Hook installation script
+- **api-server/**: Express.js API server with TypeScript
+  - Includes Swagger documentation
+  - AIWF middleware integration
+  - Jest testing setup
+  
+- **npm-library/**: NPM package template
+  - TypeScript configuration
+  - Rollup bundling
+  - Complete testing setup
+  
+- **web-app/**: React + Vite web application
+  - TypeScript + Tailwind CSS
+  - AIWF dashboard components
+  - State management setup
 
-- **tests/**: Test files for the templates
+## Feature Ledger Directory
 
-### Korean Version Additional Features
-The Korean version (`ko/`) includes additional features:
-- persona-context-apply.js - Persona context application
-- context-rule-parser.js - Context rule parsing
-- persona-behavior-validator.js - Behavior validation
-- persona-quality-evaluator.js - Quality evaluation
-- prompt-injector.js - Prompt injection utilities
+The `feature-ledger/` directory contains JSON files for tracking feature development:
+
+- **FL-001-authentication.json**: Authentication feature tracking
+- **feature-index.json**: Index of all features and their status
+
+Feature ledgers help track:
+- Feature status (planned, in-progress, completed)
+- Related git commits
+- Development milestones
+- Integration with git workflow through hooks
+
+## Hooks Directory
+
+The `hooks/` directory contains Git hooks for automated workflow:
+
+- **install-hooks.sh**: Script to install git hooks into the project
+- **post-commit**: Automatically syncs feature ledger with git commits
+
+To install hooks:
+```bash
+./hooks/install-hooks.sh
+```
+
+The post-commit hook automatically:
+- Parses commit messages for feature references
+- Updates feature status in the ledger
+- Maintains feature-commit relationships
+
+## Utils Directory
+
+The `utils/` directory contains utility modules for various AIWF features:
+
+- **Compression utilities**: Various strategies for context compression
+- **Git utilities**: Git operation helpers and integrations
+- **Token management**: Token counting, tracking, and optimization
+- **Text processing**: Summarization and content normalization
+- **Persona utilities**: Context parsing and behavior validation
 
 ## Key Files and Configurations
 
 ### package.json Configuration
 - **Type**: ES Module (`"type": "module"`)
-- **Version**: 0.3.1
+- **Version**: 0.3.3
 - **Main binaries**:
   - `aiwf` - Main CLI command
   - `aiwf-lang` - Language management CLI
@@ -92,9 +166,10 @@ The Korean version (`ko/`) includes additional features:
 
 ## AIWF Framework Development Rules
 
-- **CRITICAL**: All development and source code modifications for the AIWF framework itself **MUST** occur within the `claude-code/aiwf/{en|ko}/` directories.
-- The root `.aiwf/` directory is a "live" instance for testing and demonstration purposes **ONLY**. Do **NOT** modify files in the root `.aiwf/` as part of framework development.
-- Before modifying any file, confirm that the target path is within `claude-code/aiwf/`.
+- **CRITICAL**: All development and source code modifications for the AIWF framework occur directly in the root project directories.
+- When developing new features or modifying existing ones, work directly with the files in `commands/`, `utils/`, `lib/`, etc.
+- The `.aiwf/` directory (when created in user projects) is a generated instance for the end user. Framework development happens in the main repository.
+- Always test changes thoroughly before committing, as modifications directly affect the framework.
 
 ## Development Guidelines
 
@@ -105,21 +180,21 @@ This project uses ES modules. Always use:
 - File extensions in imports when needed
 
 ### Language Support
-- Maintain feature parity between `en/` and `ko/` versions
-- Document any language-specific features clearly
-- Use appropriate language codes in file paths
+- AIWF supports both English and Korean languages
+- Language is managed through the `aiwf-lang` CLI command
+- Documentation is provided in both languages (e.g., README.md, README.ko.md)
+- Commands and interfaces adapt based on the selected language
 
 ### Language Content Rules
-**IMPORTANT**: Strict language separation must be maintained:
-- `claude-code/aiwf/en/` - MUST contain ONLY English content
-  - All code comments, documentation, and strings must be in English
-  - No Korean text should appear in any files under this directory
-- `claude-code/aiwf/ko/` - MUST contain ONLY Korean content
-  - All code comments, documentation, and strings must be in Korean
-  - No English text should appear except for:
-    - Technical terms (e.g., API, function names, variable names)
-    - Library/framework names
-    - File paths and URLs
+**IMPORTANT**: Language management approach:
+- The framework uses a unified codebase with language-specific resources
+- Language selection is handled at runtime through `config/language.json`
+- Documentation files use language suffixes:
+  - English: `GUIDE.md`
+  - Korean: `GUIDE.ko.md`
+- Code comments and inline documentation should be in English for maintainability
+- User-facing messages and prompts are loaded from language-specific resources
+- Technical terms, function names, and variable names remain in English
 
 ### Testing
 - Write tests for all new features
@@ -151,4 +226,29 @@ The system automatically detects system language on first install, with fallback
 
 ## Core Architecture
 
-[... rest of the existing content remains unchanged ...]
+AIWF is built on a modular architecture designed for extensibility and AI tool integration:
+
+### Command System
+- Commands are self-contained modules in the `commands/` directory
+- Each command exports a default function that handles the command logic
+- Commands can utilize utilities from `utils/` and libraries from `lib/`
+
+### AI Persona System
+- Personas are defined in JSON format in the `personas/` directory
+- Each persona has associated knowledge bases and best practices
+- The system supports dynamic persona switching and context application
+
+### Token Management
+- Built-in token tracking and optimization
+- Multiple compression strategies for context management
+- Real-time monitoring and reporting capabilities
+
+### Template System
+- Project templates are stored in the `templates/` directory
+- Each template is a complete, working project setup
+- Templates include AIWF integration out of the box
+
+### Multi-Language Support
+- Runtime language switching via `aiwf-lang` command
+- Localized documentation and user interfaces
+- Unified codebase with language-specific resources

package/README.ko.md

@@ -132,6 +132,31 @@ your_project/
 - 📈 **경량 평가 시스템** - 최소한의 부담으로 자동 백그라운드 품질 모니터링
 - 🚀 **Feature Ledger** - 개발 진행 상황 추적을 위한 기능 ID 시스템
 - 🔍 **AI 도구 템플릿** - GitHub Copilot, Cursor, Windsurf, Augment 지원
+- 🪝 **Git Hooks 통합** - git 커밋과 함께 자동 기능 추적
+
+## 📁 프로젝트 구조
+
+```
+aiwf/
+├── ai-tools/           # AI 도구별 구성
+├── commands/           # AIWF 명령어 구현
+├── config/             # 설정 파일
+├── docs/               # 프로젝트 문서
+├── feature-ledger/     # 기능 추적 JSON 파일
+├── hooks/              # 자동화된 워크플로우를 위한 Git hooks
+├── lib/                # 핵심 라이브러리 모듈
+├── personas/           # AI 페르소나 정의
+├── rules/              # 개발 규칙 및 가이드라인
+├── scripts/            # 빌드 및 유틸리티 스크립트
+├── templates/          # 프로젝트 템플릿 (api-server, npm-library, web-app)
+├── tests/              # 테스트 스위트
+└── utils/              # 유틸리티 모듈
+```
+
+### 주요 디렉토리
+
+- **feature-ledger/**: 기능 개발 상태 및 git 커밋 관계 추적
+- **hooks/**: 자동 기능 추적을 위한 git hooks (post-commit) 포함
 
 ## 🔧 요구사항
 

package/README.md

@@ -154,6 +154,31 @@ For a complete list of AIWF commands and detailed usage, see [COMMANDS_GUIDE.md]
 - 📈 **Lightweight Evaluation** - Automatic background quality monitoring with minimal overhead
 - 🚀 **Feature Ledger** - Feature ID system for development progress tracking
 - 🔍 **AI Tool Templates** - Support for GitHub Copilot, Cursor, Windsurf, and Augment
+- 🪝 **Git Hooks Integration** - Automated feature tracking with git commits
+
+## 📁 Project Structure
+
+```
+aiwf/
+├── ai-tools/           # AI tool-specific configurations
+├── commands/           # AIWF command implementations
+├── config/             # Configuration files
+├── docs/               # Project documentation
+├── feature-ledger/     # Feature tracking JSON files
+├── hooks/              # Git hooks for automated workflows
+├── lib/                # Core library modules
+├── personas/           # AI persona definitions
+├── rules/              # Development rules and guidelines
+├── scripts/            # Build and utility scripts
+├── templates/          # Project templates (api-server, npm-library, web-app)
+├── tests/              # Test suites
+└── utils/              # Utility modules
+```
+
+### Key Directories
+
+- **feature-ledger/**: Tracks feature development status and git commit relationships
+- **hooks/**: Contains git hooks (post-commit) for automatic feature tracking
 
 ## 🔧 Requirements
 

package/TEST_RECOVERY_PLAN.md

@@ -0,0 +1,68 @@
+# AIWF 테스트 복구 계획
+
+## 현재 상황
+- 리팩토링 후 테스트 파일들이 손실되거나 불일치 상태
+- GitHub API → file-downloader.js 리팩토링 완료
+- 테스트 실행 시 다수 실패 발생
+
+## 복구 전략
+
+### Phase 1: Critical Tests (필수 테스트)
+**우선순위: 최고**
+- [ ] `basic.test.js` - 기본 프로젝트 구조
+- [ ] `installer.test.js` - 설치 프로그램 기능
+- [ ] `language-utils.test.js` - 언어 관리 유틸리티
+
+### Phase 2: Core Functionality Tests (핵심 기능)
+**우선순위: 높음**
+- [ ] `application.test.js` - 메인 애플리케이션
+- [ ] `commands.test.js` - 명령어 파일 검증
+- [ ] `integration/command-integration.test.js` - 명령어 통합
+
+### Phase 3: Advanced Features (고급 기능)
+**우선순위: 중간**
+- [ ] `unit/ai-persona-manager.test.js` - AI 페르소나 관리
+- [ ] `integration/context-compression.test.js` - 컨텍스트 압축
+- [ ] `token-tracking.test.js` - 토큰 추적
+
+### Phase 4: Optional Tests (선택적 테스트)
+**우선순위: 낮음**
+- [ ] `integration/feature-ledger.test.js` - Feature Ledger
+- [ ] `integration/git-integration.test.js` - Git 통합
+- [ ] `s02-integration.test.js` - S02 통합
+
+## 복구 방법
+
+### 1. 즉시 수정 가능한 테스트
+- 경로 불일치 수정
+- 설정 값 업데이트
+- Import 경로 수정
+
+### 2. 리팩토링 필요한 테스트
+- 삭제된 모듈 참조 제거
+- 새로운 API에 맞게 테스트 수정
+- Mock 객체 업데이트
+
+### 3. 완전히 새로 작성할 테스트
+- 새로운 file-downloader.js 테스트
+- 업데이트된 installer 로직 테스트
+
+## 실행 계획
+
+1. **Phase 1 복구** (1-2시간)
+   - basic.test.js 수정
+   - installer.test.js 업데이트
+   - language-utils.test.js 검증
+
+2. **Phase 2 복구** (2-3시간)
+   - 핵심 기능 테스트 복구
+   - 통합 테스트 수정
+
+3. **Phase 3-4 검토** (필요시)
+   - 고급 기능 테스트 평가
+   - 불필요한 테스트 제거
+
+## 성공 기준
+- [ ] 모든 Critical 테스트 통과
+- [ ] 80% 이상 테스트 커버리지
+- [ ] CI/CD 파이프라인 정상 작동

package/docs/CLEANUP_RECOMMENDATIONS.md

@@ -0,0 +1,86 @@
+# 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** (장기): 전체 구조 최적화