aiwf 0.3.5 → 0.3.6

package/.claude/commands/aiwf/aiwf_install_git_hooks.md

@@ -0,0 +1,63 @@
+# Install Git Hooks
+
+Install or manage AIWF Git hooks for automatic Feature-Git integration.
+
+## Command Usage
+
+```bash
+# Install hooks
+/project:aiwf:install_git_hooks
+
+# Check status
+/project:aiwf:install_git_hooks status
+
+# Uninstall hooks
+/project:aiwf:install_git_hooks uninstall
+```
+
+## What It Does
+
+### Install (default)
+1. Backs up existing Git hooks if present
+2. Installs AIWF pre-commit hook
+3. Installs AIWF post-commit hook
+4. Installs AIWF post-merge hook
+
+### Status
+- Shows which hooks are installed
+- Indicates if AIWF hooks or other hooks are active
+
+### Uninstall
+- Removes AIWF hooks
+- Restores original hooks from backup if available
+
+## Hooks Functionality
+
+### Pre-commit Hook
+- Scans staged files for Feature ID references
+- Prepares for feature tracking
+
+### Post-commit Hook
+- Extracts Feature ID from commit message
+- Automatically links commit to feature
+- Updates feature status (planned → active)
+
+### Post-merge Hook
+- Detects merges to main/master branch
+- Updates feature status to completed
+- Finalizes feature metrics
+
+## Implementation
+
+Execute the following command:
+
+```bash
+node .aiwf/scripts/install-git-hooks.cjs {{COMMAND}}
+```
+
+## Notes
+
+- Must be run from a Git repository root
+- Preserves existing hooks as .aiwf-backup files
+- Hooks are non-intrusive and fast
+- Can be safely installed/uninstalled anytime

package/.claude/commands/aiwf/aiwf_link_feature_branch.md

@@ -0,0 +1,43 @@
+# Link Feature Branch
+
+Link the current Git branch to a Feature in the Feature Ledger.
+
+## Command Usage
+
+```bash
+/project:aiwf:link_feature_branch <feature-id>
+```
+
+## Parameters
+
+- `feature-id`: The Feature ID to link the current branch to (e.g., FL001)
+
+## What It Does
+
+1. Gets the current Git branch name
+2. Updates the feature's git_branch field
+3. Establishes the branch-feature relationship
+
+## Examples
+
+```bash
+# On branch feature/FL001-user-auth
+/project:aiwf:link_feature_branch FL001
+
+# Creates the link between current branch and feature
+```
+
+## Implementation
+
+Execute the following command:
+
+```bash
+node .aiwf/scripts/git-integration.cjs link-branch {{FEATURE_ID}}
+```
+
+## Notes
+
+- Must be run from within a Git repository
+- The current branch will be linked to the feature
+- Overwrites any existing branch link
+- Useful when branch naming doesn't follow the FL### pattern

package/.claude/commands/aiwf/aiwf_link_feature_commit.md

@@ -0,0 +1,46 @@
+# Link Feature Commit
+
+Manually link a Git commit to a Feature in the Feature Ledger.
+
+## Command Usage
+
+```bash
+/project:aiwf:link_feature_commit <feature-id> <commit-hash>
+```
+
+## Parameters
+
+- `feature-id`: The Feature ID (e.g., FL001)
+- `commit-hash`: The Git commit hash to link (full or short hash)
+
+## What It Does
+
+1. Retrieves commit information (message, author, date, stats)
+2. Links the commit to the specified feature
+3. Updates feature status if needed (planned → active)
+4. Records the commit in the feature's git_commits array
+
+## Examples
+
+```bash
+# Link a specific commit to feature FL001
+/project:aiwf:link_feature_commit FL001 abc123def
+
+# Link the latest commit
+/project:aiwf:link_feature_commit FL002 HEAD
+```
+
+## Implementation
+
+Execute the following command:
+
+```bash
+node .aiwf/scripts/git-integration.cjs link-commit {{FEATURE_ID}} {{COMMIT_HASH}}
+```
+
+## Notes
+
+- The commit must exist in the current repository
+- The feature file must exist in the Feature Ledgers
+- Duplicate commits are automatically ignored
+- Feature status automatically updates from 'planned' to 'active' on first commit

package/package.json

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

package/src/cli/index.js

@@ -6,6 +6,7 @@ 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';
+import { addTaskToSprint } from '../commands/sprint-task.js';
 
 // Parse version from package.json
 import { readFileSync } from 'fs';
@@ -22,9 +23,9 @@ program
   .version(packageJson.version)
   .description('AIWF - AI Workflow Framework');
 
-// Install command (default action)
+// Install command
 program
-  .command('install', { isDefault: true })
+  .command('install')
   .description('Install AIWF framework')
   .option('-f, --force', 'Force install without prompts')
   .action((options) => installAIWF({ ...options, debugLog: true }));
@@ -202,5 +203,19 @@ persona
     await personaCmd.resetPersona();
   });
 
+// Sprint task management command
+program
+  .command('sprint-task <sprintId> <taskTitle>')
+  .alias('st')
+  .description('Add a task to an existing sprint / 스프린트에 태스크 추가')
+  .action(async (sprintId, taskTitle) => {
+    try {
+      await addTaskToSprint(sprintId, taskTitle);
+    } catch (error) {
+      console.error(chalk.red(`오류: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
 // Parse command line arguments
 program.parse(process.argv);

package/src/commands/create-project.js

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 
-const fs = require('fs-extra');
-const path = require('path');
-const prompts = require('prompts');
-const chalk = require('chalk');
-const ora = require('ora');
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import prompts from 'prompts';
+import chalk from 'chalk';
+import ora from 'ora';
 
-const TEMPLATES_DIR = path.join(__dirname, '../templates');
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const TEMPLATES_DIR = path.join(__dirname, '../../templates');
 
 async function createProject() {
   console.log(chalk.cyan('\n🚀 AIWF 프로젝트 생성기\n'));
@@ -148,4 +151,4 @@ if (require.main === module) {
   });
 }
 
-module.exports = { createProject };
+export { createProject };

package/src/commands/sprint-task.js

@@ -0,0 +1,262 @@
+#!/usr/bin/env node
+
+/**
+ * 스프린트 태스크 관리 명령어
+ * 스프린트에 개별 태스크를 추가하고 관리하는 기능
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+
+// 프로젝트 루트에서 .aiwf 디렉토리 찾기
+async function 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 디렉토리를 찾을 수 없습니다. AIWF 프로젝트 내에서 실행해주세요.');
+}
+
+// 스프린트 존재 확인
+async function verifySprintExists(projectRoot, sprintId) {
+  const sprintsDir = path.join(projectRoot, '.aiwf', '03_SPRINTS');
+  
+  try {
+    const entries = await fs.readdir(sprintsDir);
+    const sprintDir = entries.find(entry => entry.startsWith(sprintId + '_'));
+    
+    if (!sprintDir) {
+      throw new Error(`스프린트 ${sprintId}를 찾을 수 없습니다.`);
+    }
+    
+    return path.join(sprintsDir, sprintDir);
+  } catch (error) {
+    throw new Error(`스프린트 디렉토리 읽기 실패: ${error.message}`);
+  }
+}
+
+// 다음 태스크 번호 결정
+async function getNextTaskNumber(sprintPath, sprintId) {
+  try {
+    const files = await fs.readdir(sprintPath);
+    const taskFiles = files.filter(f => f.match(/^T\d+_/));
+    
+    if (taskFiles.length === 0) {
+      return 'T01';
+    }
+    
+    const numbers = taskFiles.map(f => {
+      const match = f.match(/^T(\d+)_/);
+      return match ? parseInt(match[1]) : 0;
+    });
+    
+    const maxNumber = Math.max(...numbers);
+    return `T${String(maxNumber + 1).padStart(2, '0')}`;
+  } catch {
+    return 'T01';
+  }
+}
+
+// 태스크 파일 생성
+async function createTaskFile(sprintPath, taskNumber, sprintId, taskTitle) {
+  const timestamp = new Date().toISOString().slice(0, 16).replace('T', ' ');
+  const fileName = `${taskNumber}_${sprintId}_${taskTitle.toLowerCase().replace(/\s+/g, '_').replace(/[^a-z0-9_가-힣]/g, '')}.md`;
+  const filePath = path.join(sprintPath, fileName);
+  
+  const content = `# ${taskNumber}: ${taskTitle}
+
+**스프린트**: ${sprintId}
+**생성일**: ${timestamp}
+**상태**: pending
+**우선순위**: medium
+**예상 시간**: TBD
+
+## 개요
+
+[태스크에 대한 간단한 설명을 작성하세요]
+
+## 요구사항
+
+- [ ] [구체적인 요구사항 1]
+- [ ] [구체적인 요구사항 2]
+- [ ] [구체적인 요구사항 3]
+
+## 승인 기준
+
+- [ ] [완료 조건 1]
+- [ ] [완료 조건 2]
+- [ ] [완료 조건 3]
+
+## 기술 가이드라인
+
+- [관련 아키텍처 결정 참조]
+- [기존 코드베이스 패턴 참조]
+- [사용할 기술 스택]
+
+## 구현 노트
+
+- [구현 시 고려사항]
+- [잠재적 리스크]
+- [테스트 전략]
+
+## 참조
+
+- [관련 문서나 코드 링크]
+`;
+
+  await fs.writeFile(filePath, content);
+  return { filePath, fileName, taskNumber };
+}
+
+// 스프린트 메타 파일 업데이트
+async function updateSprintMeta(sprintPath, taskNumber, taskTitle) {
+  const files = await fs.readdir(sprintPath);
+  const metaFile = files.find(f => f.includes('sprint_meta.md'));
+  
+  if (!metaFile) {
+    console.warn(chalk.yellow('⚠️  스프린트 메타 파일을 찾을 수 없습니다.'));
+    return;
+  }
+  
+  const metaPath = path.join(sprintPath, metaFile);
+  let content = await fs.readFile(metaPath, 'utf-8');
+  
+  // 태스크 섹션 찾기 및 업데이트
+  const taskSectionRegex = /## 태스크 목록[\s\S]*?(?=##|$)/;
+  const taskMatch = content.match(taskSectionRegex);
+  
+  if (taskMatch) {
+    const newTaskLine = `- [ ] ${taskNumber}: ${taskTitle} - 상태: pending\n`;
+    const updatedSection = taskMatch[0] + newTaskLine;
+    content = content.replace(taskSectionRegex, updatedSection);
+  } else {
+    // 태스크 섹션이 없으면 추가
+    content += `\n## 태스크 목록\n\n- [ ] ${taskNumber}: ${taskTitle} - 상태: pending\n`;
+  }
+  
+  await fs.writeFile(metaPath, content);
+}
+
+// 매니페스트 업데이트
+async function updateManifest(projectRoot, sprintId, taskNumber, taskTitle) {
+  const manifestPath = path.join(projectRoot, '.aiwf', '00_PROJECT_MANIFEST.md');
+  
+  try {
+    let content = await fs.readFile(manifestPath, 'utf-8');
+    
+    // 최종 업데이트 날짜 변경
+    const dateRegex = /\*\*마지막 업데이트\*\*: \d{4}-\d{2}-\d{2}/;
+    const today = new Date().toISOString().slice(0, 10);
+    content = content.replace(dateRegex, `**마지막 업데이트**: ${today}`);
+    
+    // 활성 태스크 섹션에 추가
+    const activeTasksRegex = /## 활성 태스크[\s\S]*?### 계획됨/;
+    const match = content.match(activeTasksRegex);
+    
+    if (match) {
+      const newTaskLine = `\n- **${taskNumber}_${sprintId}**: ${taskTitle} (pending → ${today} 생성)\n`;
+      const updatedSection = match[0].replace('### 계획됨', newTaskLine + '### 계획됨');
+      content = content.replace(activeTasksRegex, updatedSection);
+    }
+    
+    // 태스크 통계 업데이트
+    const statsRegex = /- \*\*총 태스크\*\*: (\d+)/;
+    const statsMatch = content.match(statsRegex);
+    if (statsMatch) {
+      const total = parseInt(statsMatch[1]) + 1;
+      content = content.replace(statsRegex, `- **총 태스크**: ${total}`);
+    }
+    
+    await fs.writeFile(manifestPath, content);
+  } catch (error) {
+    console.warn(chalk.yellow(`⚠️  매니페스트 업데이트 실패: ${error.message}`));
+  }
+}
+
+// 메인 함수
+export async function addTaskToSprint(sprintId, taskTitle) {
+  const spinner = ora('스프린트에 태스크 추가 중...').start();
+  
+  try {
+    // 1. 프로젝트 루트 찾기
+    const projectRoot = await findProjectRoot();
+    
+    // 2. 스프린트 존재 확인
+    spinner.text = '스프린트 확인 중...';
+    const sprintPath = await verifySprintExists(projectRoot, sprintId);
+    
+    // 3. 다음 태스크 번호 결정
+    spinner.text = '태스크 번호 결정 중...';
+    const taskNumber = await getNextTaskNumber(sprintPath, sprintId);
+    
+    // 4. 태스크 파일 생성
+    spinner.text = '태스크 파일 생성 중...';
+    const { filePath, fileName, taskNumber: finalTaskNumber } = await createTaskFile(
+      sprintPath, 
+      taskNumber, 
+      sprintId, 
+      taskTitle
+    );
+    
+    // 5. 스프린트 메타 업데이트
+    spinner.text = '스프린트 메타 업데이트 중...';
+    await updateSprintMeta(sprintPath, finalTaskNumber, taskTitle);
+    
+    // 6. 매니페스트 업데이트
+    spinner.text = '프로젝트 매니페스트 업데이트 중...';
+    await updateManifest(projectRoot, sprintId, finalTaskNumber, taskTitle);
+    
+    spinner.succeed('태스크 추가 완료!');
+    
+    // 성공 메시지
+    console.log('\n' + chalk.green('✅ 태스크 추가 완료!'));
+    console.log('\n📄 생성된 파일: ' + chalk.cyan(fileName));
+    console.log('🏃 스프린트: ' + chalk.yellow(sprintId));
+    console.log('📋 태스크: ' + chalk.yellow(`${finalTaskNumber} - ${taskTitle}`));
+    console.log('⏱️  상태: ' + chalk.blue('pending'));
+    
+    console.log('\n' + chalk.bold('📝 다음 단계:'));
+    console.log('1. 태스크 파일을 열어 세부사항 작성');
+    console.log(`2. ${chalk.cyan(`/aiwf:do_task ${finalTaskNumber}`)}로 작업 시작`);
+    console.log(`3. 완료 후 ${chalk.cyan(`/aiwf:update_task_status ${finalTaskNumber} completed`)} 실행`);
+    
+    console.log('\n💡 팁: 태스크 목록 확인은 ' + chalk.cyan(`/aiwf:list_sprint_tasks ${sprintId}`));
+    
+    return { success: true, taskNumber: finalTaskNumber, filePath };
+    
+  } catch (error) {
+    spinner.fail(`태스크 추가 실패: ${error.message}`);
+    throw error;
+  }
+}
+
+// CLI 실행
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const args = process.argv.slice(2);
+  
+  if (args.length < 2) {
+    console.error(chalk.red('사용법: aiwf-sprint-task <스프린트ID> <태스크 제목>'));
+    console.error(chalk.gray('예시: aiwf-sprint-task S03 "API 성능 최적화"'));
+    process.exit(1);
+  }
+  
+  const [sprintId, ...titleParts] = args;
+  const taskTitle = titleParts.join(' ').replace(/^["']|["']$/g, '');
+  
+  addTaskToSprint(sprintId, taskTitle).catch(error => {
+    console.error(chalk.red(`오류: ${error.message}`));
+    process.exit(1);
+  });
+}
+
+export default addTaskToSprint;

package/src/lib/file-downloader.js

@@ -1,5 +1,6 @@
 import https from 'https';
 import { createWriteStream } from 'fs';
+import fs from 'fs/promises';
 import { pipeline } from 'stream/promises';
 import path from 'path';
 
@@ -109,6 +110,10 @@ async function fetchContent(url) {
  * @returns {Promise<void>}
  */
 async function downloadFile(url, destPath) {
+  // Ensure destination directory exists
+  const destDir = path.dirname(destPath);
+  await fs.mkdir(destDir, { recursive: true });
+  
   return new Promise((resolve, reject) => {
     https.get(url, { headers: { 'User-Agent': 'aiwf' } }, (response) => {
       if (response.statusCode !== 200) {

package/src/lib/installer.js

@@ -182,9 +182,14 @@ async function handleExistingInstallation(msg, options) {
 async function createDirectoryStructure() {
   const aiwfDirs = getAllAiwfDirectories();
 
+  // Create AIWF directories
   for (const dir of aiwfDirs) {
     await fs.mkdir(dir, { recursive: true });
   }
+
+  // Create tool-specific directories
+  await fs.mkdir(TOOL_DIRS.CURSOR_RULES, { recursive: true });
+  await fs.mkdir(TOOL_DIRS.WINDSURF_RULES, { recursive: true });
 }
 
 /**
@@ -301,7 +306,7 @@ async function downloadAndProcessRules(spinner, msg, debugLog) {
   // Try to download rules/global from GitHub
   try {
     await downloadDirectory(
-      `${GITHUB_CONTENT_PREFIX}/rules/global`,
+      `rules/global`,
       tmpRulesGlobal,
       spinner,
       debugLog
@@ -310,20 +315,25 @@ async function downloadAndProcessRules(spinner, msg, debugLog) {
   } catch (error) {
     logWithSpinner(spinner, `Failed to download rules/global from GitHub, trying local files`, debugLog);
     // Fallback to local files
-    const localRulesGlobal = 'rules/global';
+    const localRulesGlobal = path.join(process.cwd(), 'rules/global');
     try {
+      logWithSpinner(spinner, `Trying to access: ${localRulesGlobal}`, debugLog);
       await fs.access(localRulesGlobal);
+      logWithSpinner(spinner, `Successfully accessed local rules/global`, debugLog);
       // Copy local files to temp directory
       await fs.mkdir(tmpRulesGlobal, { recursive: true });
       const files = await fs.readdir(localRulesGlobal);
+      logWithSpinner(spinner, `Found ${files.length} files in rules/global: ${files.join(', ')}`, debugLog);
       for (const file of files) {
         const srcPath = path.join(localRulesGlobal, file);
         const destPath = path.join(tmpRulesGlobal, file);
         await fs.copyFile(srcPath, destPath);
+        logWithSpinner(spinner, `Copied: ${file}`, debugLog);
       }
       useLocalGlobal = true;
       logWithSpinner(spinner, `Using local rules/global directory`, debugLog);
     } catch (localError) {
+      logWithSpinner(spinner, `Local rules/global error: ${localError.message}`, debugLog);
       logWithSpinner(spinner, msg.rulesGlobalNotFound, debugLog);
     }
   }
@@ -331,7 +341,7 @@ async function downloadAndProcessRules(spinner, msg, debugLog) {
   // Try to download rules/manual from GitHub
   try {
     await downloadDirectory(
-      `${GITHUB_CONTENT_PREFIX}/rules/manual`,
+      `rules/manual`,
       tmpRulesManual,
       spinner,
       debugLog
@@ -340,7 +350,7 @@ async function downloadAndProcessRules(spinner, msg, debugLog) {
   } catch (error) {
     logWithSpinner(spinner, `Failed to download rules/manual from GitHub, trying local files`, debugLog);
     // Fallback to local files
-    const localRulesManual = 'rules/manual';
+    const localRulesManual = path.join(process.cwd(), 'rules/manual');
     try {
       await fs.access(localRulesManual);
       // Copy local files to temp directory