vibe-commander 0.2.0 → 0.2.2

package/dist/adapters/cli/commands/git-helpers.js

@@ -8,6 +8,8 @@
  */
 import { execSync } from 'node:child_process';
 import { ok, fail } from '../../../types/index.js';
+/** git CLI 실행 타임아웃 (밀리초) */
+const GIT_EXEC_TIMEOUT_MS = 5_000;
 /**
  * 현재 HEAD 커밋의 short SHA(8자)를 반환한다
  *
@@ -19,7 +21,7 @@ export function getHeadSha(projectRoot) {
         const sha = execSync('git rev-parse --short=8 HEAD', {
             cwd: projectRoot,
             encoding: 'utf-8',
-            timeout: 5000,
+            timeout: GIT_EXEC_TIMEOUT_MS,
             stdio: ['pipe', 'pipe', 'pipe'],
         }).replace(/[\r\n]+$/, '');
         if (!sha) {
@@ -47,7 +49,7 @@ export function getChangedFiles(projectRoot, sha) {
         const output = execSync(`git diff-tree --no-commit-id --name-only -r ${sha}`, {
             cwd: projectRoot,
             encoding: 'utf-8',
-            timeout: 5000,
+            timeout: GIT_EXEC_TIMEOUT_MS,
             stdio: ['pipe', 'pipe', 'pipe'],
         });
         const files = output
@@ -76,7 +78,7 @@ export function getRecentShas(projectRoot, count) {
         const output = execSync(`git log --format=%h --abbrev=8 -n ${String(count)}`, {
             cwd: projectRoot,
             encoding: 'utf-8',
-            timeout: 5000,
+            timeout: GIT_EXEC_TIMEOUT_MS,
             stdio: ['pipe', 'pipe', 'pipe'],
         })
             .replace(/\r\n/g, '\n')

package/dist/adapters/cli/commands/init-helpers.js

@@ -64,7 +64,7 @@ export function readExistingConfig(configPath) {
         return null;
     }
     catch {
-        console.log(`${YELLOW}⚠️  기존 설정 파일을 파싱할 수 없습니다. 새 설정을 생성합니다.${RESET}`);
+        console.error(`${YELLOW}⚠️  기존 설정 파일을 파싱할 수 없습니다. 새 설정을 생성합니다.${RESET}`);
         return null;
     }
 }

package/dist/adapters/cli/commands/io-helpers.js

@@ -15,6 +15,10 @@ import { loadConfig } from '../../../config/loader.js';
 import { findDepCommits } from '../../../core/resolvers/dep-commit-resolver.js';
 import { filterCommitsByChangedFiles } from '../../../core/resolvers/commit-filter.js';
 import { getChangedFiles } from './git-helpers.js';
+/** git log 조회 시 최대 커밋 수 */
+const GIT_LOG_LIMIT = 200;
+/** git log 실행 타임아웃 (밀리초) */
+const GIT_LOG_TIMEOUT_MS = 10_000;
 /**
  * 커맨드 파일을 읽어 반환한다
  */
@@ -78,10 +82,10 @@ export function collectGitCommits(depIds, commitSearch, projectRoot) {
     if (commitSearch.strategy === 'disabled')
         return [];
     try {
-        const output = execSync('git log --pretty=oneline -200', {
+        const output = execSync(`git log --pretty=oneline -${String(GIT_LOG_LIMIT)}`, {
             cwd: projectRoot,
             encoding: 'utf-8',
-            timeout: 10000,
+            timeout: GIT_LOG_TIMEOUT_MS,
             stdio: ['pipe', 'pipe', 'pipe'],
         });
         const result = findDepCommits(depIds, output, commitSearch);

package/dist/adapters/cli/commands/list-units.d.ts

@@ -27,9 +27,8 @@ export interface ListUnitsResult {
  * 2. 로드맵 경로 확인 — null이면 에러 반환
  * 3. 로드맵 파일 읽기 (Adapter I/O)
  * 4. 백로그 파싱 (parseBacklog)
- * 5. completed 제외, phase 필터링
- * 6. 상태별 분류 (inProgress/ready/blocked)
- * 7. 결과 반환
+ * 5. 백로그 분류 및 필터링 (classifyBacklog)
+ * 6. 결과 반환
  *
  * @param args - 파싱된 CLI 인자 (command === 'list-units' 보장)
  * @param projectRoot - 프로젝트 루트 절대 경로

package/dist/adapters/cli/commands/list-units.js

@@ -14,6 +14,7 @@ import { join } from 'node:path';
 import { ok, fail } from '../../../types/index.js';
 import { loadConfig } from '../../../config/loader.js';
 import { parseBacklog } from '../../../core/parsers/backlog-parser.js';
+import { classifyBacklog } from '../../../core/resolvers/backlog-resolver.js';
 /**
  * list-units 커맨드를 실행한다
  *
@@ -22,9 +23,8 @@ import { parseBacklog } from '../../../core/parsers/backlog-parser.js';
  * 2. 로드맵 경로 확인 — null이면 에러 반환
  * 3. 로드맵 파일 읽기 (Adapter I/O)
  * 4. 백로그 파싱 (parseBacklog)
- * 5. completed 제외, phase 필터링
- * 6. 상태별 분류 (inProgress/ready/blocked)
- * 7. 결과 반환
+ * 5. 백로그 분류 및 필터링 (classifyBacklog)
+ * 6. 결과 반환
  *
  * @param args - 파싱된 CLI 인자 (command === 'list-units' 보장)
  * @param projectRoot - 프로젝트 루트 절대 경로
@@ -57,36 +57,10 @@ export function handleListUnits(args, projectRoot) {
     const parseResult = parseBacklog(roadmapContent, config.backlogParsing);
     if (!parseResult.success)
         return parseResult;
-    // 5. 활성 항목만 필터 (completed 제외)
-    let entries = parseResult.data.filter((e) => e.status !== 'completed');
-    // 6. phase 필터링 (대소문자 무시)
-    if (phase) {
-        const normalizedPhase = phase.toLowerCase();
-        entries = entries.filter((e) => {
-            const entryPhase = extractPhase(e.unitId);
-            return entryPhase !== null && entryPhase.toLowerCase() === normalizedPhase;
-        });
-    }
-    // 7. 상태별 분류
-    const inProgress = entries.filter((e) => e.status === 'inProgress');
-    const ready = entries.filter((e) => e.status === 'ready');
-    const blocked = entries.filter((e) => e.status === 'blocked');
-    return ok({
-        total: entries.length,
-        inProgress,
-        ready,
-        blocked,
-        ...(phase !== undefined && { phase }),
-    });
-}
-/**
- * 유닛 ID에서 phase 태그를 추출한다
- *
- * "U-016[Mvp]" → "Mvp"
- * "CP-MVP-03" → null
- */
-function extractPhase(unitId) {
-    const match = unitId.match(/\[([^\]]+)\]$/);
-    return match?.[1] ?? null;
+    // 5. 백로그 분류 및 필터링 (Core 순수 함수)
+    const classificationResult = classifyBacklog(parseResult.data, { phase });
+    if (!classificationResult.success)
+        return classificationResult;
+    return ok(classificationResult.data);
 }
 //# sourceMappingURL=list-units.js.map

package/dist/adapters/cli/commands/schema.js

@@ -15,8 +15,8 @@ import { writeFileSync, mkdirSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
 import { ok, fail } from '../../../types/index.js';
 import { loadConfig } from '../../../config/loader.js';
-import { getConfigJsonSchema } from '../../../config/schema.js';
-import { renderCommandsSchema, renderTypesSchema, SCHEMA_SUBCOMMANDS, } from '../../../core/renderers/schema-renderer.js';
+import { projectConfigSchema } from '../../../config/schema.js';
+import { renderConfigSchema, renderCommandsSchema, renderTypesSchema, SCHEMA_SUBCOMMANDS, } from '../../../core/renderers/schema-renderer.js';
 import { validatePath } from '../../../core/validators/input-validator.js';
 /**
  * schema 커맨드를 실행한다
@@ -43,7 +43,11 @@ export function handleSchema(args, projectRoot) {
     let result;
     switch (subcommand) {
         case 'config': {
-            const schema = getConfigJsonSchema();
+            const schema = renderConfigSchema(projectConfigSchema, {
+                id: 'https://raw.githubusercontent.com/viilab/vibe-commander/main/schemas/config-schema.json',
+                title: 'vibe-commander Configuration',
+                description: 'Unit-based vibe coding workflow automation CLI configuration. Defines project structure, unit types, parsing rules, and command sections.',
+            });
             result = { subcommand: 'config', schema };
             break;
         }

package/dist/adapters/cli/commands/set-unit.d.ts

@@ -27,6 +27,11 @@ export interface SetUnitResult {
     warnings: string[];
     dryRun?: boolean;
     preview?: string;
+    autoSelected?: boolean;
+    selectedFrom?: {
+        ready: number;
+        total: number;
+    };
 }
 /**
  * set-unit 커맨드를 실행한다

package/dist/adapters/cli/commands/set-unit.js

@@ -10,11 +10,18 @@
  *
  * @module
  */
-import { writeFileSync } from 'node:fs';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
 import { ok, fail } from '../../../types/index.js';
 import { validateUnitId } from '../../../core/validators/input-validator.js';
+import { parseBacklog } from '../../../core/parsers/backlog-parser.js';
+import { classifyBacklog } from '../../../core/resolvers/backlog-resolver.js';
 import { renderSection } from '../../../core/renderers/section-renderer.js';
 import { updateSection } from '../../../core/renderers/section-updater.js';
+import { findMarkerRange } from '../../../core/renderers/marker-utils.js';
+import { extractSubsectionContent } from '../../../core/parsers/subsection-extractor.js';
+import { normalizeLineEndings } from '../../../core/parsers/md-utils.js';
+import { loadConfig } from '../../../config/loader.js';
 import { resolveCommandContext } from './context-resolver.js';
 import { readCommandsFile, enrichWithSuggestions } from './io-helpers.js';
 import { writeActiveUnitType } from './state-helpers.js';
@@ -37,9 +44,21 @@ export async function handleSetUnit(args, projectRoot) {
     if (args.command !== 'set-unit') {
         return fail('INTERNAL_ERROR', 'handleSetUnit에 잘못된 커맨드가 전달되었습니다');
     }
-    const { unitId, noPrompt, dryRun } = args;
+    const { noPrompt, dryRun, next } = args;
+    let unitId = args.unitId;
     const requestKeys = 'requestKeys' in args ? args.requestKeys : [];
-    // 0. 입력 안전성 검증 (제어 문자, 경로 순회, URL 인코딩 등)
+    let autoSelected = false;
+    let selectedFrom;
+    // 0-a. --next: 백로그에서 ready 유닛 자동 선택
+    if (next) {
+        const pickResult = pickNextUnit(projectRoot);
+        if (!pickResult.success)
+            return pickResult;
+        unitId = pickResult.data.unitId;
+        autoSelected = true;
+        selectedFrom = { ready: pickResult.data.readyCount, total: pickResult.data.totalCount };
+    }
+    // 0-b. 입력 안전성 검증 (제어 문자, 경로 순회, URL 인코딩 등)
     const safetyCheck = validateUnitId(unitId);
     if (!safetyCheck.valid) {
         return fail('INVALID_INPUT', safetyCheck.error ?? '입력 검증 실패');
@@ -57,19 +76,38 @@ export async function handleSetUnit(args, projectRoot) {
         pairingAnswers = await promptAllQuestions(context.pairingQuestions);
         context.pairingAnswers = pairingAnswers;
     }
-    // 3. 섹션 렌더링 (Core 순수 함수)
-    const sectionBody = renderSection(context, unitTypeConfig);
-    // 4. 커맨드 파일 업데이트 (Adapter I/O) — dry-run 시 건너뜀
+    // 3. 커맨드 파일 읽기 (보존 추출 + 업데이트에 재사용)
+    const cmdFile = readCommandsFile(config, projectRoot);
+    // 4. 기존 특별 요청사항 추출 (보존 로직)
+    const specialRequestsHeading = config.commandSections.specialRequestsHeading;
+    let preservedSpecialRequests;
+    if (cmdFile.success) {
+        const extracted = extractExistingSpecialRequests(cmdFile.data.content, unitTypeConfig.commandSection, specialRequestsHeading, config.commandSections.useMarkers ? unitTypeConfig.key : undefined, config.commandSections.separator);
+        if (extracted) {
+            preservedSpecialRequests = extracted;
+        }
+    }
+    // 5. 섹션 렌더링 (Core 순수 함수)
+    const sectionBody = renderSection(context, unitTypeConfig, undefined, {
+        preservedSpecialRequests,
+        specialRequestsHeading,
+    });
+    // 6. 커맨드 파일 업데이트 (Adapter I/O) — dry-run 시 건너뜀
     let commandsUpdated = false;
     if (!dryRun) {
-        const cmdFile = readCommandsFile(config, projectRoot);
         if (cmdFile.success) {
             const useMarkers = config.commandSections.useMarkers;
             const markerOptions = useMarkers ? { sectionKey: unitTypeConfig.key } : undefined;
             const updateResult = updateSection(cmdFile.data.content, unitTypeConfig.commandSection, sectionBody, config.commandSections.separator, markerOptions);
             if (updateResult.success && updateResult.data.updated) {
-                writeFileSync(cmdFile.data.absPath, updateResult.data.content, 'utf-8');
-                commandsUpdated = true;
+                try {
+                    writeFileSync(cmdFile.data.absPath, updateResult.data.content, 'utf-8');
+                    commandsUpdated = true;
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    warnings.push(`커맨드 파일 쓰기 실패: ${msg}`);
+                }
             }
             else if (updateResult.success && !updateResult.data.updated) {
                 warnings.push(`커맨드 파일에서 '${unitTypeConfig.commandSection}' 섹션을 찾을 수 없습니다`);
@@ -78,7 +116,7 @@ export async function handleSetUnit(args, projectRoot) {
         else {
             warnings.push(`커맨드 파일을 읽을 수 없습니다: ${config.paths.commands}`);
         }
-        // 5. 활성 유닛 타입 상태 기록 (update-commit 자동 감지용)
+        // 7. 활성 유닛 타입 상태 기록 (update-commit 자동 감지용)
         writeActiveUnitType(projectRoot, unitTypeKey);
     }
     // 6. 결과 반환
@@ -95,6 +133,107 @@ export async function handleSetUnit(args, projectRoot) {
         commandsUpdated,
         warnings,
         ...(dryRun && { dryRun: true, preview: sectionBody }),
+        ...(autoSelected && { autoSelected, selectedFrom }),
+    });
+}
+/**
+ * 백로그에서 첫 번째 ready 유닛을 선택한다
+ *
+ * loadConfig → 로드맵 확인 → parseBacklog → ready 필터 → 첫 번째 반환
+ */
+function pickNextUnit(projectRoot) {
+    const configResult = loadConfig(projectRoot);
+    if (!configResult.success)
+        return configResult;
+    const config = configResult.data;
+    if (!config.paths.roadmap) {
+        return fail('ROADMAP_NOT_CONFIGURED', '--next 옵션을 사용하려면 로드맵 파일이 설정되어야 합니다', 'vibe-commander.config.json의 paths.roadmap을 설정하거나, vc set-unit <unitId>로 직접 지정하세요');
+    }
+    const roadmapAbsPath = join(projectRoot, config.paths.roadmap);
+    let roadmapContent;
+    try {
+        roadmapContent = readFileSync(roadmapAbsPath, 'utf-8');
+    }
+    catch {
+        return fail('ROADMAP_NOT_FOUND', `로드맵 파일을 찾을 수 없습니다: ${config.paths.roadmap}`, `절대 경로: ${roadmapAbsPath}`);
+    }
+    const parseResult = parseBacklog(roadmapContent, config.backlogParsing);
+    if (!parseResult.success)
+        return parseResult;
+    // 백로그 분류 (Core 순수 함수)
+    const classificationResult = classifyBacklog(parseResult.data);
+    if (!classificationResult.success)
+        return classificationResult;
+    const { ready, inProgress, blocked, total } = classificationResult.data;
+    if (ready.length === 0) {
+        return fail('NO_READY_UNITS', '착수 가능한(ready) 유닛이 없습니다', `현재 상태: 진행중 ${String(inProgress.length)}개, 블록됨 ${String(blocked.length)}개. vc list-units로 확인하세요`);
+    }
+    const first = ready[0];
+    if (!first) {
+        return fail('NO_READY_UNITS', '착수 가능한(ready) 유닛이 없습니다');
+    }
+    return ok({
+        unitId: first.unitId,
+        readyCount: ready.length,
+        totalCount: total,
     });
 }
+// ── 특별 요청사항 보존 헬퍼 ──
+/**
+ * 커맨드 파일에서 대상 섹션 내 기존 특별 요청사항 콘텐츠를 추출한다
+ *
+ * Fallback 체인:
+ * 1. 마커 기반: findMarkerRange로 섹션 범위 확보 → 내부에서 서브섹션 추출
+ * 2. 헤더 기반: commandSection 헤더로 섹션 범위 확보 → 내부에서 서브섹션 추출
+ * 3. 둘 다 실패: null 반환 (기존 동작 Fallback)
+ *
+ * 추출된 콘텐츠에서 trailing separator는 제거하여 이중 separator를 방지한다.
+ */
+function extractExistingSpecialRequests(fileContent, sectionHeader, specialRequestsHeading, sectionKey, separator) {
+    const lines = normalizeLineEndings(fileContent).split('\n');
+    let raw = null;
+    // 1. 마커 기반 범위 탐색
+    if (sectionKey) {
+        const range = findMarkerRange(lines, sectionKey);
+        if (range) {
+            const sectionContent = lines.slice(range.start + 1, range.end).join('\n');
+            raw = extractSubsectionContent(sectionContent, specialRequestsHeading);
+        }
+    }
+    // 2. 헤더 기반 Fallback
+    if (raw === null) {
+        const needle = sectionHeader.trim();
+        const headerIdx = lines.findIndex((l) => l.trim() === needle);
+        if (headerIdx === -1)
+            return null;
+        const hashMatch = needle.match(/^(#+)/);
+        const level = hashMatch?.[1] ? hashMatch[1].length : 1;
+        let endIdx = lines.length;
+        for (let i = headerIdx + 1; i < lines.length; i++) {
+            const line = (lines[i] ?? '').trim();
+            const lineMatch = line.match(/^(#+)\s/);
+            if (lineMatch?.[1] && lineMatch[1].length <= level) {
+                endIdx = i;
+                break;
+            }
+        }
+        const sectionContent = lines.slice(headerIdx, endIdx).join('\n');
+        raw = extractSubsectionContent(sectionContent, specialRequestsHeading);
+    }
+    if (!raw)
+        return null;
+    // trailing separator 제거 (updateSection이 별도 삽입하므로 이중 방지)
+    if (separator) {
+        const resultLines = raw.split('\n');
+        const sep = separator.trim();
+        while (resultLines.length > 0 && (resultLines[resultLines.length - 1] ?? '').trim() === sep) {
+            resultLines.pop();
+        }
+        while (resultLines.length > 0 && (resultLines[resultLines.length - 1] ?? '').trim() === '') {
+            resultLines.pop();
+        }
+        return resultLines.length > 0 ? resultLines.join('\n') : null;
+    }
+    return raw;
+}
 //# sourceMappingURL=set-unit.js.map

package/dist/adapters/cli/commands/skill-install.js

@@ -77,9 +77,15 @@ function installForPlatform(platform, skillsRoot, projectRoot, force, result) {
         }
         result.overwritten.push(displayPath);
     }
-    mkdirSync(dirname(targetPath), { recursive: true });
-    const content = readFileSync(sourcePath, 'utf-8');
-    writeFileSync(targetPath, content, 'utf-8');
-    result.installed.push(displayPath);
+    try {
+        mkdirSync(dirname(targetPath), { recursive: true });
+        const content = readFileSync(sourcePath, 'utf-8');
+        writeFileSync(targetPath, content, 'utf-8');
+        result.installed.push(displayPath);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        result.skipped.push(`${displayPath} (I/O 오류: ${msg})`);
+    }
 }
 //# sourceMappingURL=skill-install.js.map

package/dist/adapters/cli/formatters-schema.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 스키마 및 SKILL 설치 포맷터 — Layer 3 (Adapter)
+ *
+ * schema, skill install 커맨드의 실행 결과를 포맷팅한다.
+ *
+ * @module
+ */
+import type { ToolResult } from '../../types/index.js';
+/**
+ * skill install 결과를 콘솔에 포맷팅하여 출력한다
+ */
+export declare function formatSkillInstall(result: ToolResult<unknown>, json: boolean): void;
+/**
+ * schema 결과를 콘솔에 포맷팅하여 출력한다
+ */
+export declare function formatSchema(result: ToolResult<unknown>, json: boolean): void;
+//# sourceMappingURL=formatters-schema.d.ts.map

package/dist/adapters/cli/formatters-schema.js

@@ -0,0 +1,155 @@
+/**
+ * 스키마 및 SKILL 설치 포맷터 — Layer 3 (Adapter)
+ *
+ * schema, skill install 커맨드의 실행 결과를 포맷팅한다.
+ *
+ * @module
+ */
+import { RESET, GREEN, YELLOW, CYAN, DIM, BOLD, RED } from './output.js';
+// ── skill install 포맷터 ──
+/**
+ * skill install 결과를 콘솔에 포맷팅하여 출력한다
+ */
+export function formatSkillInstall(result, json) {
+    if (!result.success)
+        return;
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    const data = result.data;
+    if (!isSkillInstallResult(data))
+        return;
+    const totalDone = data.installed.length + data.overwritten.length;
+    console.log('');
+    if (totalDone > 0) {
+        console.log(`${GREEN}✅ SKILL 파일 설치 완료${RESET}`);
+    }
+    else {
+        console.log(`${YELLOW}⚠️  설치된 파일 없음${RESET}`);
+    }
+    if (data.installed.length > 0) {
+        console.log('');
+        console.log(`${BOLD}📦 설치됨 (${String(data.installed.length)}개)${RESET}`);
+        for (const p of data.installed) {
+            console.log(`  ${GREEN}+${RESET} ${CYAN}${p}${RESET}`);
+        }
+    }
+    if (data.overwritten.length > 0) {
+        console.log('');
+        console.log(`${BOLD}🔄 덮어씀 (${String(data.overwritten.length)}개)${RESET}`);
+        for (const p of data.overwritten) {
+            console.log(`  ${YELLOW}~${RESET} ${CYAN}${p}${RESET}`);
+        }
+    }
+    if (data.skipped.length > 0) {
+        console.log('');
+        console.log(`${BOLD}⏭️  건너뜀 (${String(data.skipped.length)}개)${RESET}`);
+        for (const s of data.skipped) {
+            console.log(`  ${DIM}-${RESET} ${s}`);
+        }
+    }
+    console.log('');
+}
+/** SkillInstallResult 런타임 타입 가드 */
+function isSkillInstallResult(data) {
+    return (data !== null &&
+        typeof data === 'object' &&
+        'installed' in data &&
+        'skipped' in data &&
+        'overwritten' in data);
+}
+// ── schema 포맷터 ──
+/**
+ * schema 결과를 콘솔에 포맷팅하여 출력한다
+ */
+export function formatSchema(result, json) {
+    if (!result.success)
+        return;
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    const data = result.data;
+    if (!isSchemaResult(data))
+        return;
+    if ('outputPath' in data && data.outputPath) {
+        console.log(`\n${GREEN}✅ 스키마가 파일에 저장되었습니다: ${CYAN}${data.outputPath}${RESET}\n`);
+        return;
+    }
+    switch (data.subcommand) {
+        case 'help':
+            formatSchemaHelp(data);
+            break;
+        case 'config':
+            console.log(JSON.stringify(data.schema, null, 2));
+            break;
+        case 'commands':
+            formatSchemaCommands(data);
+            break;
+        case 'types':
+            formatSchemaTypes(data);
+            break;
+    }
+}
+function formatSchemaHelp(data) {
+    console.log('');
+    console.log(`${BOLD}vc schema${RESET} — 런타임 스키마 조회`);
+    console.log('');
+    console.log(`${YELLOW}사용 가능한 서브커맨드:${RESET}`);
+    for (const sub of data.availableSubcommands) {
+        console.log(`  ${CYAN}${sub.name}${RESET}       ${sub.description}`);
+    }
+    console.log('');
+    console.log(`${YELLOW}사용법:${RESET} ${data.usage}`);
+    console.log('');
+}
+function formatSchemaCommands(data) {
+    console.log('');
+    console.log(`${BOLD}📋 vibe-commander CLI 스키마${RESET}`);
+    console.log('');
+    console.log(`${YELLOW}글로벌 옵션:${RESET}`);
+    for (const flag of data.globalFlags) {
+        const alias = flag.alias ? `, ${CYAN}${flag.alias}${RESET}` : '';
+        console.log(`  ${CYAN}${flag.name}${RESET}${alias}  ${DIM}${flag.description}${RESET}`);
+    }
+    console.log('');
+    console.log(`${YELLOW}명령어 (${String(data.commands.length)}개):${RESET}`);
+    for (const cmd of data.commands) {
+        const argStr = cmd.args.map((a) => (a.required ? `<${a.name}>` : `[${a.name}]`)).join(' ');
+        const nameWithArgs = argStr ? `${cmd.name} ${argStr}` : cmd.name;
+        console.log(`  ${CYAN}${nameWithArgs}${RESET}`);
+        console.log(`    ${cmd.description}`);
+        if (cmd.args.length > 0) {
+            for (const arg of cmd.args) {
+                const req = arg.required ? `${RED}필수${RESET}` : `${DIM}선택${RESET}`;
+                console.log(`    ${DIM}인자:${RESET} ${arg.name} (${req}) — ${arg.description}`);
+            }
+        }
+        if (cmd.flags.length > 0) {
+            const flagNames = cmd.flags.map((f) => f.name).join(', ');
+            console.log(`    ${DIM}플래그:${RESET} ${flagNames}`);
+        }
+        console.log('');
+    }
+}
+function formatSchemaTypes(data) {
+    console.log('');
+    console.log(`${BOLD}📋 프로젝트 유닛 타입 (${String(data.types.length)}개)${RESET}`);
+    console.log('');
+    for (const t of data.types) {
+        const displayName = t.displayName ? ` (${t.displayName})` : '';
+        console.log(`  ${CYAN}${BOLD}${t.key}${RESET}${displayName}`);
+        console.log(`    ${DIM}ID 패턴:${RESET}      ${t.idPattern}`);
+        console.log(`    ${DIM}계획서:${RESET}        ${t.planDir}`);
+        console.log(`    ${DIM}커맨드 섹션:${RESET}   ${t.commandSection}`);
+        console.log(`    ${DIM}의존성 수집:${RESET}   ${t.collectDeps ? GREEN + '✅' : RED + '❌'}${RESET}`);
+        console.log(`    ${DIM}헤더 템플릿:${RESET}   ${t.headerTemplate}`);
+        console.log('');
+    }
+}
+/** SchemaResult 런타임 타입 가드 */
+function isSchemaResult(data) {
+    return data !== null && typeof data === 'object' && 'subcommand' in data;
+}
+//# sourceMappingURL=formatters-schema.js.map

package/dist/adapters/cli/formatters-unit.d.ts

@@ -37,12 +37,4 @@ export declare function formatInit(result: ToolResult<unknown>, json: boolean):
  * exit code 규칙: 에러 있으면 1, 경고만 있으면 0
  */
 export declare function formatValidate(result: ToolResult<unknown>, json: boolean): void;
-/**
- * skill install 결과를 콘솔에 포맷팅하여 출력한다
- */
-export declare function formatSkillInstall(result: ToolResult<unknown>, json: boolean): void;
-/**
- * schema 결과를 콘솔에 포맷팅하여 출력한다
- */
-export declare function formatSchema(result: ToolResult<unknown>, json: boolean): void;
 //# sourceMappingURL=formatters-unit.d.ts.map