aiag-cli 1.6.3 → 1.7.1

package/dist/utils/initializerAgent.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Initializer Agent 실행 유틸리티
+ * PRD를 분석하여 feature_list.json과 CLAUDE.md를 생성
+ */
+export interface InitializerResult {
+    success: boolean;
+    featuresGenerated?: number;
+    categories?: string[];
+    error?: string;
+}
+/**
+ * Initializer Agent를 실행하여 PRD로부터 feature_list.json 생성
+ */
+export declare function runInitializerAgent(prdPath: string, baseDir: string): Promise<InitializerResult>;
+/**
+ * feature_list.json에서 카테고리별 기능 수 계산
+ */
+export declare function countFeaturesByCategory(baseDir: string, category: string): number;
+/**
+ * Claude Code CLI를 사용한 자동 실행 (옵션)
+ * 환경에 Claude Code가 설치되어 있어야 함
+ */
+export declare function executeInitializerWithClaudeCode(promptPath: string, baseDir: string): Promise<void>;
+//# sourceMappingURL=initializerAgent.d.ts.map

package/dist/utils/initializerAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializerAgent.d.ts","sourceRoot":"","sources":["../../src/utils/initializerAgent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAqD5B;AAgHD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMjF;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/utils/initializerAgent.js

@@ -0,0 +1,182 @@
+/**
+ * Initializer Agent 실행 유틸리티
+ * PRD를 분석하여 feature_list.json과 CLAUDE.md를 생성
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import { printInfo, colors, messages } from './output.js';
+import { readFeatureList } from './featureList.js';
+/**
+ * Initializer Agent를 실행하여 PRD로부터 feature_list.json 생성
+ */
+export async function runInitializerAgent(prdPath, baseDir) {
+    try {
+        printInfo(messages.init.runningInitializer);
+        console.log('');
+        // 템플릿 읽기
+        const templatePath = path.join(baseDir, '.aiag', 'templates', 'initializer.md');
+        if (!fs.existsSync(templatePath)) {
+            return {
+                success: false,
+                error: 'initializer.md 템플릿을 찾을 수 없습니다.',
+            };
+        }
+        const template = fs.readFileSync(templatePath, 'utf-8');
+        // PRD 읽기
+        const prdContent = fs.readFileSync(prdPath, 'utf-8');
+        // 프롬프트 생성
+        const prompt = generateInitializerPrompt(template, prdContent, prdPath, baseDir);
+        // 진행 상황 출력
+        printInfo(`📄 ${messages.init.progress.readingPrd}`);
+        printInfo(`🧠 ${messages.init.progress.analyzing}`);
+        printInfo(`🔨 ${messages.init.progress.decomposing}`);
+        console.log('');
+        // Initializer Agent 실행
+        // 현재는 프롬프트를 파일로 저장하여 사용자가 수동으로 실행할 수 있도록 함
+        // 추후 Claude Code CLI나 API 통합 예정
+        const promptFilePath = await saveInitializerPrompt(prompt, baseDir);
+        printInfo(`💡 Initializer Agent 프롬프트가 생성되었습니다:`);
+        console.log(`   ${colors.cyan(promptFilePath)}`);
+        console.log('');
+        console.log(colors.dim('수동 실행 방법:'));
+        console.log(`   ${colors.cyan('claude code')} 를 실행하여 위 프롬프트의 내용을 입력하세요.`);
+        console.log('');
+        console.log(colors.dim('또는 자동 실행 (Claude Code CLI 필요):'));
+        console.log(`   ${colors.cyan(`claude code --print "$(cat ${promptFilePath})"`)}`);
+        console.log('');
+        // feature_list.json이 생성되었는지 확인 (수동 실행 후)
+        const result = checkInitializerResult(baseDir);
+        return result;
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: String(error),
+        };
+    }
+}
+/**
+ * Initializer Agent 프롬프트 생성
+ */
+function generateInitializerPrompt(template, prdContent, prdPath, baseDir) {
+    const relativePrdPath = path.relative(baseDir, prdPath);
+    return `
+${template}
+
+---
+
+## 작업 지시
+
+다음 PRD를 분석하여 \`.aiag/feature_list.json\`을 생성하고, 프로젝트 루트에 \`CLAUDE.md\`를 생성하세요.
+
+### PRD 위치
+\`${relativePrdPath}\`
+
+### PRD 내용
+
+\`\`\`markdown
+${prdContent}
+\`\`\`
+
+### 생성할 파일
+
+#### 1. .aiag/feature_list.json
+- 30-100개의 테스트 가능한 기능으로 분해
+- 각 기능은 30분-2시간 내 구현 가능한 크기
+- 명확한 acceptanceCriteria 포함
+- 실행 가능한 testCommand 포함
+- 모든 passes는 false로 설정
+- priority는 의존성을 고려하여 설정 (critical > high > medium > low)
+
+#### 2. CLAUDE.md
+프로젝트 루트에 다음 내용을 포함한 문서 생성:
+- 프로젝트 개요 (PRD에서 추출한 핵심 목표)
+- 주요 기능 (3-5개 요약)
+- 기술 스택 (package.json 분석 + PRD 명시사항)
+- 아키텍처 (프로젝트 구조 및 설계 패턴)
+- 도메인 지식 (비즈니스 용어 및 규칙)
+- 제약사항 (성능, 브라우저, 접근성 등)
+- AIAG 워크플로우
+- 코딩 컨벤션
+
+### 주의사항
+1. feature_list.json의 모든 기능은 \`"passes": false\`로 설정
+2. 각 기능은 독립적으로 테스트 가능해야 함
+3. testCommand는 실제로 실행 가능한 명령어여야 함
+4. CLAUDE.md는 Claude Code가 세션 시작 시 읽을 수 있도록 명확하게 작성
+
+### 현재 디렉토리
+\`${baseDir}\`
+
+작업을 시작하세요.
+`.trim();
+}
+/**
+ * 프롬프트를 파일로 저장
+ */
+async function saveInitializerPrompt(prompt, baseDir) {
+    const promptPath = path.join(baseDir, '.aiag', '.initializer_prompt.md');
+    fs.writeFileSync(promptPath, prompt);
+    return promptPath;
+}
+/**
+ * Initializer Agent 실행 결과 확인
+ */
+function checkInitializerResult(baseDir) {
+    const featureListPath = path.join(baseDir, '.aiag', 'feature_list.json');
+    if (!fs.existsSync(featureListPath)) {
+        return {
+            success: false,
+            error: 'feature_list.json이 아직 생성되지 않았습니다. Initializer Agent를 실행하세요.',
+        };
+    }
+    try {
+        const featureList = readFeatureList(baseDir);
+        if (!featureList) {
+            return {
+                success: false,
+                error: 'feature_list.json을 읽을 수 없습니다.',
+            };
+        }
+        const features = featureList.features || [];
+        const categories = [...new Set(features.map((f) => f.category))];
+        return {
+            success: true,
+            featuresGenerated: features.length,
+            categories,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `feature_list.json 파싱 오류: ${error}`,
+        };
+    }
+}
+/**
+ * feature_list.json에서 카테고리별 기능 수 계산
+ */
+export function countFeaturesByCategory(baseDir, category) {
+    const featureList = readFeatureList(baseDir);
+    if (!featureList)
+        return 0;
+    const features = featureList.features || [];
+    return features.filter((f) => f.category === category).length;
+}
+/**
+ * Claude Code CLI를 사용한 자동 실행 (옵션)
+ * 환경에 Claude Code가 설치되어 있어야 함
+ */
+export async function executeInitializerWithClaudeCode(promptPath, baseDir) {
+    try {
+        execSync(`claude code --print "$(cat ${promptPath})"`, {
+            cwd: baseDir,
+            stdio: 'inherit',
+        });
+    }
+    catch (error) {
+        throw new Error(`Claude Code 실행 실패: ${error}`);
+    }
+}
+//# sourceMappingURL=initializerAgent.js.map

package/dist/utils/initializerAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializerAgent.js","sourceRoot":"","sources":["../../src/utils/initializerAgent.ts"],"names":[],"mappings":"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"}

package/dist/utils/messages.d.ts

@@ -0,0 +1,184 @@
+/**
+ * 한국어 메시지 관리 시스템
+ * 모든 CLI 출력 메시지를 중앙에서 관리
+ */
+export declare const messages: {
+    common: {
+        success: string;
+        error: string;
+        warning: string;
+        loading: string;
+        notInitialized: string;
+        runInitFirst: string;
+    };
+    init: {
+        header: string;
+        alreadyInitialized: string;
+        useForce: string;
+        noPrdFound: string;
+        prdGuidance: {
+            title: string;
+            createFirst: string;
+            files: string[];
+            whatToInclude: string;
+            includes: string[];
+            orSkip: string;
+            skipCommand: string;
+        };
+        foundPrd: string;
+        runningInitializer: string;
+        progress: {
+            creatingStructure: string;
+            readingPrd: string;
+            analyzing: string;
+            decomposing: string;
+            generatingClaudeMd: string;
+            validating: string;
+        };
+        complete: {
+            success: string;
+            filesCreated: string;
+            featureListDesc: string;
+            progressDesc: string;
+            claudeMdDesc: string;
+            nextSteps: string;
+            steps: string[];
+        };
+        files: {
+            featureList: string;
+            progress: string;
+            initSh: string;
+            sessionContext: string;
+            templates: string;
+            vscode: string;
+            claudeMd: string;
+        };
+    };
+    status: {
+        header: string;
+        notInitialized: string;
+        progress: string;
+        byCategory: string;
+        byPriority: string;
+        recentActivity: string;
+        noFeatures: string;
+        completedFeatures: string;
+        remainingFeatures: string;
+        lastUpdate: string;
+    };
+    next: {
+        header: string;
+        notInitialized: string;
+        noFeaturesAvailable: string;
+        allComplete: string;
+        recommended: string;
+        startWith: string;
+        category: string;
+        priority: string;
+        description: string;
+        acceptanceCriteria: string;
+    };
+    work: {
+        header: string;
+        notInitialized: string;
+        notFound: string;
+        alreadyComplete: string;
+        starting: string;
+        sessionUpdated: string;
+        promptReady: string;
+        feature: string;
+        status: string;
+        testCommand: string;
+    };
+    auto: {
+        header: string;
+        notInitialized: string;
+        noFeatures: string;
+        starting: string;
+        loopMode: string;
+        resumeMode: string;
+        processing: string;
+        completed: string;
+        skipped: string;
+        currentFeature: string;
+        progress: string;
+    };
+    test: {
+        header: string;
+        notInitialized: string;
+        notFound: string;
+        noTestCommand: string;
+        running: string;
+        passed: string;
+        failed: string;
+        allPassed: string;
+        summary: string;
+        total: string;
+        passed_count: string;
+        failed_count: string;
+    };
+    complete: {
+        header: string;
+        notInitialized: string;
+        notFound: string;
+        alreadyComplete: string;
+        testRequired: string;
+        skipTest: string;
+        marked: string;
+        runningTest: string;
+        testPassed: string;
+        updated: string;
+    };
+    commit: {
+        header: string;
+        notInitialized: string;
+        noChanges: string;
+        analyzing: string;
+        generatingMessage: string;
+        committed: string;
+    };
+    session: {
+        start: {
+            header: string;
+            notInitialized: string;
+            started: string;
+            checking: string;
+            ready: string;
+        };
+        end: {
+            header: string;
+            notInitialized: string;
+            ended: string;
+            summary: string;
+            featuresCompleted: string;
+            nextSession: string;
+        };
+    };
+    validate: {
+        header: string;
+        notInitialized: string;
+        valid: string;
+        invalid: string;
+        errors: string;
+        warnings: string;
+        checking: string;
+        issuesFound: string;
+    };
+    errors: {
+        fileNotFound: string;
+        invalidJson: string;
+        commandFailed: string;
+        unknownError: string;
+    };
+};
+/**
+ * 메시지 템플릿에 매개변수를 치환
+ * @example formatMessage("기능 {count}개 생성됨", { count: 47 })
+ */
+export declare function formatMessage(template: string, params: Record<string, string | number>): string;
+/**
+ * 중첩된 객체에서 키 경로로 메시지 가져오기
+ * @example getMessage("init.header") → "AIAG 프로젝트 초기화"
+ */
+export declare function getMessage(keyPath: string): string;
+//# sourceMappingURL=messages.d.ts.map

package/dist/utils/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/utils/messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuNpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAalD"}

package/dist/utils/messages.js

@@ -0,0 +1,232 @@
+/**
+ * 한국어 메시지 관리 시스템
+ * 모든 CLI 출력 메시지를 중앙에서 관리
+ */
+export const messages = {
+    // 공통 메시지
+    common: {
+        success: '성공',
+        error: '오류',
+        warning: '경고',
+        loading: '처리 중...',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        runInitFirst: '"aiag init"를 먼저 실행하세요.',
+    },
+    // Init 명령 메시지
+    init: {
+        header: 'AIAG 프로젝트 초기화',
+        alreadyInitialized: 'AIAG가 이미 초기화되어 있습니다.',
+        useForce: '--force 옵션을 사용하여 재초기화할 수 있습니다.',
+        // PRD 관련
+        noPrdFound: 'PRD를 찾을 수 없습니다',
+        prdGuidance: {
+            title: 'AIAG는 Product Requirements Document(PRD)와 함께 사용할 때 최상의 결과를 제공합니다.',
+            createFirst: '먼저 다음 파일 중 하나를 생성하세요:',
+            files: [
+                'PRD.md (권장)',
+                'REQUIREMENTS.md',
+                'docs/prd.md'
+            ],
+            whatToInclude: 'PRD에 포함할 내용:',
+            includes: [
+                '프로젝트 개요 및 목표',
+                '핵심 기능 및 요구사항',
+                '기술적 제약사항',
+                '성공 기준'
+            ],
+            orSkip: '또는 다음 명령으로 최소 초기화만 수행:',
+            skipCommand: 'aiag init --minimal'
+        },
+        foundPrd: 'PRD를 찾았습니다',
+        runningInitializer: 'Initializer Agent 실행 중...',
+        // 진행 상태
+        progress: {
+            creatingStructure: '.aiag/ 디렉토리 구조 생성 중...',
+            readingPrd: 'PRD 읽는 중...',
+            analyzing: '요구사항 분석 중...',
+            decomposing: '기능으로 분해 중...',
+            generatingClaudeMd: 'CLAUDE.md 생성 중...',
+            validating: 'Feature list 유효성 검사 중...',
+        },
+        // 완료 메시지
+        complete: {
+            success: 'AIAG 초기화 완료!',
+            filesCreated: '생성된 파일:',
+            featureListDesc: '작업 목록 (무엇을 할지)',
+            progressDesc: '진행 기록 (무엇을 했는지)',
+            claudeMdDesc: 'Claude 작업 지침 (어떻게 할지)',
+            nextSteps: '다음 단계:',
+            steps: [
+                'CLAUDE.md 검토 및 필요시 수정',
+                '.aiag/feature_list.json 검토',
+                "'aiag status' 실행하여 기능 분포 확인",
+                "'aiag next' 실행하여 첫 번째 기능 시작",
+                "(선택) 커밋: git add .aiag CLAUDE.md && git commit -m \"feat: AIAG 초기화\""
+            ]
+        },
+        // 파일 생성 로그
+        files: {
+            featureList: '.aiag/feature_list.json',
+            progress: '.aiag/progress.md',
+            initSh: '.aiag/init.sh',
+            sessionContext: '.aiag/session_context.md',
+            templates: '.aiag/templates/',
+            vscode: '.vscode/settings.json',
+            claudeMd: 'CLAUDE.md'
+        }
+    },
+    // Status 명령 메시지
+    status: {
+        header: '프로젝트 진행 상황',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        progress: '전체 진행률',
+        byCategory: '카테고리별 진행률',
+        byPriority: '우선순위별 진행률',
+        recentActivity: '최근 활동',
+        noFeatures: '기능이 정의되지 않았습니다.',
+        completedFeatures: '완료된 기능',
+        remainingFeatures: '남은 기능',
+        lastUpdate: '마지막 업데이트',
+    },
+    // Next 명령 메시지
+    next: {
+        header: '다음 작업 추천',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        noFeaturesAvailable: '작업 가능한 기능이 없습니다.',
+        allComplete: '🎉 모든 기능이 완료되었습니다!',
+        recommended: '추천 기능:',
+        startWith: '다음 명령으로 시작하세요:',
+        category: '카테고리',
+        priority: '우선순위',
+        description: '설명',
+        acceptanceCriteria: '완료 조건',
+    },
+    // Work 명령 메시지
+    work: {
+        header: '기능 작업 시작',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        notFound: '기능을 찾을 수 없습니다: {id}',
+        alreadyComplete: '이 기능은 이미 완료되었습니다: {id}',
+        starting: '작업 시작 중: {id}',
+        sessionUpdated: '세션 컨텍스트가 업데이트되었습니다.',
+        promptReady: '작업 프롬프트가 준비되었습니다.',
+        feature: '기능',
+        status: '상태',
+        testCommand: '테스트 명령',
+    },
+    // Auto 명령 메시지
+    auto: {
+        header: 'AI Agent 자동 실행 모드',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        noFeatures: '작업할 기능이 없습니다.',
+        starting: 'AI Agent 실행 중... (최대 {count}개 기능)',
+        loopMode: '🔄 무한 루프 모드 활성화 (Ctrl+C로 중단)',
+        resumeMode: '▶️  이어서 시작 모드 활성화',
+        processing: '처리 중',
+        completed: '완료',
+        skipped: '건너뜀',
+        currentFeature: '현재 작업',
+        progress: '진행률',
+    },
+    // Test 명령 메시지
+    test: {
+        header: '기능 테스트 실행',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        notFound: '기능을 찾을 수 없습니다: {id}',
+        noTestCommand: '테스트 명령이 정의되지 않았습니다.',
+        running: '테스트 실행 중...',
+        passed: '✅ 테스트 통과',
+        failed: '❌ 테스트 실패',
+        allPassed: '모든 테스트 통과!',
+        summary: '테스트 요약',
+        total: '전체',
+        passed_count: '통과',
+        failed_count: '실패',
+    },
+    // Complete 명령 메시지
+    complete: {
+        header: '기능 완료 처리',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        notFound: '기능을 찾을 수 없습니다: {id}',
+        alreadyComplete: '이미 완료된 기능입니다.',
+        testRequired: '완료 처리 전에 테스트를 통과해야 합니다.',
+        skipTest: '--skip-test 옵션으로 테스트를 건너뛸 수 있습니다.',
+        marked: '기능이 완료 처리되었습니다: {id}',
+        runningTest: '테스트 실행 중...',
+        testPassed: '테스트 통과!',
+        updated: 'feature_list.json 업데이트됨',
+    },
+    // Commit 명령 메시지
+    commit: {
+        header: 'Git 커밋',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        noChanges: '커밋할 변경사항이 없습니다.',
+        analyzing: '변경사항 분석 중...',
+        generatingMessage: '커밋 메시지 생성 중...',
+        committed: '커밋 완료',
+    },
+    // Session 명령 메시지
+    session: {
+        start: {
+            header: '세션 시작',
+            notInitialized: 'AIAG가 초기화되지 않았습니다.',
+            started: '새 세션이 시작되었습니다.',
+            checking: '환경 확인 중...',
+            ready: '개발 환경 준비 완료',
+        },
+        end: {
+            header: '세션 종료',
+            notInitialized: 'AIAG가 초기화되지 않았습니다.',
+            ended: '세션이 종료되었습니다.',
+            summary: '세션 요약',
+            featuresCompleted: '완료된 기능',
+            nextSession: '다음 세션 시 권장사항',
+        }
+    },
+    // Validate 명령 메시지
+    validate: {
+        header: 'Feature List 유효성 검사',
+        notInitialized: 'AIAG가 초기화되지 않았습니다.',
+        valid: '✅ Feature list가 유효합니다.',
+        invalid: '❌ Feature list에 문제가 있습니다.',
+        errors: '오류',
+        warnings: '경고',
+        checking: '유효성 검사 중...',
+        issuesFound: '개의 문제 발견',
+    },
+    // 에러 메시지
+    errors: {
+        fileNotFound: '파일을 찾을 수 없습니다: {path}',
+        invalidJson: 'JSON 파싱 오류: {path}',
+        commandFailed: '명령 실행 실패: {command}',
+        unknownError: '알 수 없는 오류가 발생했습니다.',
+    }
+};
+/**
+ * 메시지 템플릿에 매개변수를 치환
+ * @example formatMessage("기능 {count}개 생성됨", { count: 47 })
+ */
+export function formatMessage(template, params) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => {
+        const value = params[key];
+        return value !== undefined ? String(value) : `{${key}}`;
+    });
+}
+/**
+ * 중첩된 객체에서 키 경로로 메시지 가져오기
+ * @example getMessage("init.header") → "AIAG 프로젝트 초기화"
+ */
+export function getMessage(keyPath) {
+    const keys = keyPath.split('.');
+    let result = messages;
+    for (const key of keys) {
+        if (result && typeof result === 'object' && key in result) {
+            result = result[key];
+        }
+        else {
+            return keyPath; // 키를 찾지 못하면 원래 키 반환
+        }
+    }
+    return typeof result === 'string' ? result : keyPath;
+}
+//# sourceMappingURL=messages.js.map

package/dist/utils/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/utils/messages.ts"],"names":[],"mappings":"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"}

package/dist/utils/output.d.ts

@@ -1,6 +1,8 @@
+import { messages, formatMessage, getMessage } from './messages.js';
 /**
  * Output utilities for CLI
  */
+export { messages, formatMessage, getMessage };
 export declare const colors: {
     success: import("chalk").ChalkInstance;
     error: import("chalk").ChalkInstance;
@@ -69,4 +71,24 @@ export declare function printInfo(message: string): void;
  * Print a key-value pair
  */
 export declare function printKeyValue(key: string, value: string | number): void;
+/**
+ * Print a message using key path
+ * @example printMessageByKey('init.header') → "AIAG 프로젝트 초기화"
+ */
+export declare function printMessageByKey(keyPath: string, params?: Record<string, string | number>): void;
+/**
+ * Print a list of items with bullets
+ */
+export declare function printList(items: string[], options?: {
+    indent?: number;
+    bullet?: string;
+}): void;
+/**
+ * Print a divider line
+ */
+export declare function printDivider(char?: string, length?: number): void;
+/**
+ * Print empty lines
+ */
+export declare function printEmptyLine(count?: number): void;
 //# sourceMappingURL=output.d.ts.map