aiwf 0.3.0 → 0.3.2

package/claude-code/aiwf/ko/templates/npm-library/template/README.md

@@ -0,0 +1,201 @@
+# {{projectName}}
+
+{{description}}
+
+## 설치
+
+```bash
+npm install {{projectName}}
+```
+
+## 사용법
+
+### 기본 사용
+
+```typescript
+import { AiwfIntegration } from '{{projectName}}';
+
+const aiwf = new AiwfIntegration({
+  projectName: 'my-project',
+  projectType: 'npm-library',
+  features: {
+    featureLedger: true,
+    contextCompression: true,
+    aiPersona: false,
+  },
+});
+
+// Validate integration
+const result = await aiwf.validate();
+console.log(result);
+```
+
+### Feature Tracking
+
+```typescript
+const tracker = aiwf.getFeatureTracker();
+
+// Add a new feature
+const feature = tracker.addFeature({
+  name: 'New API Endpoint',
+  description: 'Add user authentication endpoint',
+  type: 'feature',
+  status: 'planned',
+  tags: ['api', 'auth'],
+});
+
+// Update feature status
+tracker.updateFeatureStatus(feature.id, 'in_progress');
+
+// Get statistics
+const stats = tracker.getStatistics();
+console.log(stats); // { total: 1, completed: 0, inProgress: 1, planned: 0 }
+```
+
+### Context Compression
+
+```typescript
+const contextManager = aiwf.getContextManager();
+
+// Compress content
+const compressed = contextManager.compress(largeContent);
+
+// Check token limit
+const isWithinLimit = contextManager.checkTokenLimit(content);
+
+// Get token usage
+const usage = contextManager.getTokenUsage();
+console.log(`Token usage: ${usage.percentage}%`);
+```
+
+## API 문서
+
+### AiwfIntegration
+
+메인 통합 클래스입니다.
+
+#### Constructor
+
+```typescript
+new AiwfIntegration(config: AiwfConfig)
+```
+
+#### Methods
+
+- `getConfig(): AiwfConfig` - 현재 설정 반환
+- `getFeatureTracker(): FeatureTracker | undefined` - Feature Tracker 인스턴스
+- `getContextManager(): ContextManager | undefined` - Context Manager 인스턴스
+- `validate(): Promise<IntegrationResult>` - 통합 유효성 검사
+
+### FeatureTracker
+
+기능 추적을 관리합니다.
+
+#### Methods
+
+- `addFeature(feature: Omit<Feature, 'id' | 'createdAt'>): Feature` - 새 기능 추가
+- `updateFeatureStatus(featureId: string, status: Feature['status']): Feature | undefined` - 상태 업데이트
+- `getAllFeatures(): Feature[]` - 모든 기능 조회
+- `getFeaturesByStatus(status: Feature['status']): Feature[]` - 상태별 기능 조회
+- `getStatistics(): Record<string, number>` - 통계 조회
+- `exportToJSON(): string` - JSON으로 내보내기
+
+### ContextManager
+
+컨텍스트 압축과 토큰 관리를 담당합니다.
+
+#### Methods
+
+- `compress(content: string): string` - 컨텐츠 압축
+- `estimateTokens(content: string): number` - 토큰 수 추정
+- `checkTokenLimit(content: string): boolean` - 토큰 한도 확인
+- `updateTokenUsage(tokens: number): void` - 토큰 사용량 업데이트
+- `getTokenUsage(): { used: number; limit: number; percentage: number }` - 사용량 조회
+- `clearCache(): void` - 캐시 초기화
+- `getCacheStats(): { size: number; entries: number }` - 캐시 통계
+
+## 타입 정의
+
+```typescript
+interface AiwfConfig {
+  projectName: string;
+  projectType: 'web-app' | 'api-server' | 'npm-library' | 'custom';
+  features: {
+    featureLedger?: boolean;
+    contextCompression?: boolean;
+    aiPersona?: boolean;
+  };
+  options?: Record<string, unknown>;
+}
+
+interface Feature {
+  id: string;
+  name: string;
+  description: string;
+  type: 'feature' | 'bugfix' | 'enhancement' | 'setup';
+  status: 'planned' | 'in_progress' | 'completed';
+  createdAt: Date;
+  completedAt?: Date;
+  tags: string[];
+  metadata?: Record<string, unknown>;
+}
+```
+
+## 개발
+
+### 설치
+
+```bash
+npm install
+```
+
+### 개발 모드
+
+```bash
+npm run dev
+```
+
+### 테스트
+
+```bash
+npm test
+npm run test:coverage
+```
+
+### 빌드
+
+```bash
+npm run build
+```
+
+### 릴리즈
+
+```bash
+npm run release
+```
+
+## AIWF 기능
+
+이 라이브러리는 AIWF와 완벽하게 통합되어 있습니다:
+
+- **Feature Ledger**: 라이브러리 기능 개발 추적
+- **Context Compression**: 토큰 사용 최적화
+- **AI Persona**: 라이브러리 개발에 특화된 AI 어시스턴트
+
+```bash
+npm run aiwf:status    # 프로젝트 상태 확인
+npm run aiwf:feature   # Feature 관리
+npm run aiwf:version   # 버전 관리
+```
+
+## 기여하기
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 라이선스
+
+MIT License - see the [LICENSE](LICENSE) file for details

package/claude-code/aiwf/ko/templates/npm-library/template/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.1",
+  "description": "{{description}}",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint . --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "prepublishOnly": "npm run lint && npm test && npm run build",
+    "prepare": "husky install",
+    "release": "np",
+    "aiwf": "node .aiwf/scripts/cli.js",
+    "aiwf:status": "npm run aiwf status",
+    "aiwf:feature": "npm run aiwf feature",
+    "aiwf:version": "npm run aiwf version"
+  },
+  "keywords": [
+    "typescript",
+    "library",
+    "aiwf"
+  ],
+  "author": "{{author}}",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/{{username}}/{{projectName}}"
+  },
+  "bugs": {
+    "url": "https://github.com/{{username}}/{{projectName}}/issues"
+  },
+  "homepage": "https://github.com/{{username}}/{{projectName}}#readme",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^5.60.0",
+    "@typescript-eslint/parser": "^5.60.0",
+    "typescript": "^5.1.0",
+    "rollup": "^3.25.0",
+    "@rollup/plugin-typescript": "^11.1.0",
+    "@rollup/plugin-node-resolve": "^15.1.0",
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-json": "^6.0.0",
+    "rollup-plugin-terser": "^7.0.2",
+    "rollup-plugin-dts": "^5.3.0",
+    "eslint": "^8.43.0",
+    "jest": "^29.5.0",
+    "@types/jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "np": "^8.0.0",
+    "husky": "^8.0.0",
+    "lint-staged": "^13.0.0",
+    "prettier": "^2.8.0"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "np": {
+    "yarn": false,
+    "tests": true
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/claude-code/aiwf/ko/templates/web-app/config.json

@@ -0,0 +1,53 @@
+{
+  "name": "web-app",
+  "displayName": "웹 애플리케이션 (React + TypeScript)",
+  "description": "React 18과 TypeScript로 구성된 모던 웹 애플리케이션 템플릿",
+  "type": "web-app",
+  "language": "typescript",
+  "framework": "react",
+  "features": [
+    "React 18",
+    "TypeScript",
+    "Vite",
+    "React Router",
+    "Zustand",
+    "Tailwind CSS",
+    "AIWF Dashboard"
+  ],
+  "structure": {
+    "src": "소스 코드",
+    "public": "정적 파일",
+    ".aiwf": "AIWF 설정 및 메타데이터",
+    "tests": "테스트 파일"
+  },
+  "dependencies": {
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-router-dom": "^6.14.0",
+    "zustand": "^4.3.8",
+    "axios": "^1.4.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^5.60.0",
+    "@typescript-eslint/parser": "^5.60.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "autoprefixer": "^10.4.14",
+    "eslint": "^8.43.0",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "eslint-plugin-react-refresh": "^0.4.0",
+    "postcss": "^8.4.24",
+    "tailwindcss": "^3.3.2",
+    "typescript": "^5.1.0",
+    "vite": "^4.3.0"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "preview": "vite preview",
+    "test": "jest",
+    "aiwf": "node .aiwf/scripts/cli.js"
+  }
+}

package/claude-code/aiwf/ko/templates/web-app/template/.aiwf/config.json

@@ -0,0 +1,54 @@
+{
+  "project_name": "{{projectName}}",
+  "project_type": "web-app",
+  "framework": "react",
+  "language": "typescript",
+  "created_at": "{{createdAt}}",
+  "version": "0.0.1",
+  "features": {
+    "feature_ledger": {
+      "enabled": true,
+      "auto_track": true,
+      "git_integration": true
+    },
+    "ai_persona": {
+      "enabled": true,
+      "default": "fullstack-developer",
+      "available": [
+        "fullstack-developer",
+        "frontend-specialist",
+        "ui-ux-designer",
+        "performance-optimizer",
+        "security-auditor"
+      ]
+    },
+    "context_compression": {
+      "enabled": true,
+      "level": "balanced",
+      "token_limit": 100000,
+      "cache_enabled": true
+    },
+    "token_tracking": {
+      "enabled": true,
+      "alert_threshold": 80000,
+      "history_days": 30
+    }
+  },
+  "structure": {
+    "src_dir": "src",
+    "test_dir": "tests",
+    "build_dir": "dist",
+    "public_dir": "public"
+  },
+  "conventions": {
+    "component_style": "functional",
+    "state_management": "zustand",
+    "styling": "tailwind",
+    "testing": "jest",
+    "linting": "eslint"
+  },
+  "scripts": {
+    "pre_commit": "npm run lint && npm test",
+    "post_feature": "npm run aiwf:feature update"
+  }
+}

package/claude-code/aiwf/ko/templates/web-app/template/.aiwf/feature-ledger.json

@@ -0,0 +1,37 @@
+{
+  "version": "1.0.0",
+  "project": "{{projectName}}",
+  "created": "{{createdAt}}",
+  "features": [
+    {
+      "id": "F001",
+      "name": "프로젝트 초기 설정",
+      "description": "React + TypeScript + Vite 기반 웹 애플리케이션 초기 설정",
+      "type": "setup",
+      "status": "completed",
+      "created_at": "{{createdAt}}",
+      "completed_at": "{{createdAt}}",
+      "components": [
+        "프로젝트 구조",
+        "빌드 설정",
+        "TypeScript 설정",
+        "ESLint 설정",
+        "Tailwind CSS 설정"
+      ],
+      "files": [
+        "package.json",
+        "vite.config.ts",
+        "tsconfig.json",
+        "tailwind.config.js",
+        ".eslintrc.cjs"
+      ],
+      "tags": ["초기설정", "인프라", "설정"]
+    }
+  ],
+  "statistics": {
+    "total_features": 1,
+    "completed": 1,
+    "in_progress": 0,
+    "planned": 0
+  }
+}

package/claude-code/aiwf/ko/templates/web-app/template/.aiwf/personas/fullstack-developer.json

@@ -0,0 +1,40 @@
+{
+  "id": "fullstack-developer",
+  "name": "풀스택 개발자",
+  "description": "React 웹 애플리케이션 전체 스택 개발 전문가",
+  "expertise": [
+    "React 18+ 최신 기능",
+    "TypeScript 고급 패턴",
+    "상태 관리 (Zustand, Redux)",
+    "API 통합 및 데이터 페칭",
+    "성능 최적화",
+    "테스트 전략"
+  ],
+  "context": {
+    "focus_areas": [
+      "컴포넌트 설계 및 구현",
+      "타입 안정성",
+      "코드 재사용성",
+      "성능 최적화",
+      "접근성 (a11y)"
+    ],
+    "code_style": {
+      "components": "함수형 컴포넌트 + Hooks",
+      "naming": "camelCase (함수), PascalCase (컴포넌트)",
+      "imports": "절대 경로 사용 (@/...)",
+      "types": "인터페이스 우선, 필요시 타입 별칭"
+    },
+    "best_practices": [
+      "컴포넌트 단일 책임 원칙",
+      "Props 타입 명시",
+      "커스텀 훅 활용",
+      "메모이제이션 적절히 사용",
+      "에러 바운더리 구현"
+    ]
+  },
+  "prompts": {
+    "component_creation": "React 18의 최신 기능을 활용하여 재사용 가능하고 타입 안전한 컴포넌트를 만들어주세요.",
+    "optimization": "React.memo, useMemo, useCallback을 적절히 사용하여 성능을 최적화해주세요.",
+    "testing": "Jest와 React Testing Library를 사용하여 컴포넌트 테스트를 작성해주세요."
+  }
+}

package/claude-code/aiwf/ko/templates/web-app/template/.aiwf/scripts/cli.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+const command = args[0];
+const subcommand = args[1];
+
+const projectRoot = path.resolve(__dirname, '../..');
+const aiwfDir = path.join(projectRoot, '.aiwf');
+const featureLedgerPath = path.join(aiwfDir, 'feature-ledger.json');
+const configPath = path.join(aiwfDir, 'config.json');
+
+// Feature Ledger 관련 명령어
+if (command === 'feature') {
+  const ledger = JSON.parse(fs.readFileSync(featureLedgerPath, 'utf8'));
+
+  switch (subcommand) {
+    case 'list':
+      console.log('\n📋 Feature Ledger\n');
+      ledger.features.forEach(feature => {
+        const status = {
+          completed: '✅',
+          in_progress: '🔄',
+          planned: '📝'
+        }[feature.status];
+        console.log(`${status} [${feature.id}] ${feature.name}`);
+        console.log(`   ${feature.description}`);
+        console.log(`   Tags: ${feature.tags.join(', ')}`);
+        console.log();
+      });
+      console.log(`총 ${ledger.features.length}개 기능`);
+      break;
+
+    case 'add':
+      console.log('새 기능 추가는 아직 구현되지 않았습니다.');
+      break;
+
+    case 'update':
+      console.log('기능 업데이트는 아직 구현되지 않았습니다.');
+      break;
+
+    default:
+      console.log('사용법: npm run aiwf feature [list|add|update]');
+  }
+}
+
+// Context 관련 명령어
+else if (command === 'context') {
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+
+  switch (subcommand) {
+    case 'status':
+      console.log('\n📊 Context 상태\n');
+      console.log(`압축 레벨: ${config.features.context_compression.level}`);
+      console.log(`캐시 활성화: ${config.features.context_compression.cache_enabled ? '예' : '아니오'}`);
+      console.log(`토큰 한도: ${config.features.context_compression.token_limit.toLocaleString()}`);
+      break;
+
+    case 'compress':
+      console.log('수동 압축은 아직 구현되지 않았습니다.');
+      break;
+
+    default:
+      console.log('사용법: npm run aiwf context [status|compress]');
+  }
+}
+
+// 상태 명령어
+else if (command === 'status') {
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  const ledger = JSON.parse(fs.readFileSync(featureLedgerPath, 'utf8'));
+
+  console.log('\n🚀 AIWF 프로젝트 상태\n');
+  console.log(`프로젝트: ${config.project_name}`);
+  console.log(`타입: ${config.project_type}`);
+  console.log(`버전: ${config.version}`);
+  console.log();
+  console.log('📊 통계:');
+  console.log(`- 총 기능: ${ledger.statistics.total_features}`);
+  console.log(`- 완료: ${ledger.statistics.completed}`);
+  console.log(`- 진행중: ${ledger.statistics.in_progress}`);
+  console.log(`- 계획됨: ${ledger.statistics.planned}`);
+  console.log();
+  console.log('🤖 AI 페르소나:', config.features.ai_persona.default);
+  console.log('📦 Context 압축:', config.features.context_compression.level);
+}
+
+// 도움말
+else {
+  console.log(`
+AIWF CLI - AI Workflow Framework
+
+사용법: npm run aiwf [command] [subcommand]
+
+명령어:
+  status              프로젝트 상태 보기
+  feature list        기능 목록 보기
+  feature add         새 기능 추가
+  feature update      기능 상태 업데이트
+  context status      Context 압축 상태 보기
+  context compress    수동 압축 실행
+
+예시:
+  npm run aiwf status
+  npm run aiwf feature list
+  npm run aiwf context status
+`);
+}

package/claude-code/aiwf/ko/templates/web-app/template/.eslintrc.cjs

@@ -0,0 +1,20 @@
+module.exports = {
+  root: true,
+  env: { browser: true, es2020: true },
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:react-hooks/recommended',
+  ],
+  ignorePatterns: ['dist', '.eslintrc.cjs'],
+  parser: '@typescript-eslint/parser',
+  plugins: ['react-refresh'],
+  rules: {
+    'react-refresh/only-export-components': [
+      'warn',
+      { allowConstantExport: true },
+    ],
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+  },
+}