vibe-commander 0.2.0 → 0.2.1

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.js

@@ -68,8 +68,14 @@ export async function handleSetUnit(args, projectRoot) {
             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}' 섹션을 찾을 수 없습니다`);

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

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

@@ -231,150 +231,4 @@ function isValidateResult(data) {
         'warnings' in data &&
         'items' in data);
 }
-// ── 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-unit.js.map

package/dist/adapters/cli/index.js

@@ -23,7 +23,8 @@ import { handleInit } from './commands/init.js';
 import { handleValidate } from './commands/validate.js';
 import { handleSkillInstall } from './commands/skill-install.js';
 import { handleSchema } from './commands/schema.js';
-import { formatContext, formatSetUnit, formatInit, formatValidate, formatSkillInstall, formatSchema, } from './formatters-unit.js';
+import { formatContext, formatSetUnit, formatInit, formatValidate } from './formatters-unit.js';
+import { formatSkillInstall, formatSchema } from './formatters-schema.js';
 import { formatListUnits, formatUpdateCommit } from './formatters-list.js';
 const handlers = {
     init: handleInit,

package/dist/adapters/cli/router.d.ts

@@ -79,18 +79,6 @@ export type CommandFormatter = (result: ToolResult<unknown>, json: boolean) => v
  * @returns 파싱된 커맨드 인자 또는 에러
  */
 export declare function parseArgs(argv: readonly string[]): ToolResult<ParsedArgs>;
-/**
- * stdin JSON 데이터로부터 ParsedArgs를 생성한다
- *
- * 서브커맨드는 argv에서 결정되고, 인자/옵션은 stdin JSON에서 추출.
- * --stdin은 --no-prompt를 암시한다 (stdin이 JSON 데이터에 사용되므로 인터랙티브 불가).
- *
- * @param subcommand - argv에서 추출한 서브커맨드 이름
- * @param data - stdin에서 파싱한 JSON 객체
- * @param json - --json 플래그 여부
- * @returns ParsedArgs 또는 에러
- */
-export declare function parseStdinArgs(subcommand: string, data: Record<string, unknown>, json: boolean, rawArgs?: readonly string[]): ToolResult<ParsedArgs>;
 /**
  * CLI 라우터 메인 실행 함수
  *

package/dist/adapters/cli/router.js

@@ -7,9 +7,10 @@
  *
  * @module
  */
-import { ok, fail } from '../../types/index.js';
+import { fail } from '../../types/index.js';
 import { printHelp, printVersion, printUnknownCommand, printMissingArg, printSuccess, printError, } from './output.js';
 import { readStdin, parseStdinJson } from '../pipe/stdin-reader.js';
+import { parseStdinArgs } from './stdin-parser.js';
 // ── arg 파싱 ──
 /**
  * process.argv로부터 서브커맨드와 인자/옵션을 파싱한다
@@ -245,106 +246,6 @@ function getOptionValue(args, option) {
 function isValueOption(arg) {
     return ['--mode', '--section', '--phase', '--request', '--output'].includes(arg);
 }
-// ── stdin → ParsedArgs 변환 ──
-/**
- * stdin JSON 데이터로부터 ParsedArgs를 생성한다
- *
- * 서브커맨드는 argv에서 결정되고, 인자/옵션은 stdin JSON에서 추출.
- * --stdin은 --no-prompt를 암시한다 (stdin이 JSON 데이터에 사용되므로 인터랙티브 불가).
- *
- * @param subcommand - argv에서 추출한 서브커맨드 이름
- * @param data - stdin에서 파싱한 JSON 객체
- * @param json - --json 플래그 여부
- * @returns ParsedArgs 또는 에러
- */
-export function parseStdinArgs(subcommand, data, json, rawArgs) {
-    switch (subcommand) {
-        case 'set-unit': {
-            const unitId = typeof data.unitId === 'string' ? data.unitId : undefined;
-            if (!unitId) {
-                return fail('STDIN_MISSING_FIELD', 'stdin JSON에 "unitId" (string) 필드가 필요합니다', '예시: {"unitId": "U-001[Mvp]"}');
-            }
-            const requestKeys = Array.isArray(data.requestKeys)
-                ? data.requestKeys.filter((k) => typeof k === 'string')
-                : [];
-            const dryRun = rawArgs?.includes('--dry-run') ?? false;
-            return ok({ command: 'set-unit', unitId, requestKeys, noPrompt: true, dryRun, json });
-        }
-        case 'update-commit': {
-            const modeValue = typeof data.mode === 'string' ? data.mode : undefined;
-            const mode = modeValue === 'append' ? 'append' : 'replace';
-            const section = typeof data.section === 'string' ? data.section : undefined;
-            const base = {
-                command: 'update-commit',
-                mode,
-                ...(section !== undefined && { section }),
-                json,
-            };
-            if (typeof data.sha === 'string') {
-                return ok({ ...base, commitMode: 'manual', sha: data.sha });
-            }
-            if (typeof data.count === 'number' && Number.isInteger(data.count) && data.count > 0) {
-                return ok({ ...base, commitMode: 'auto-recent', count: data.count });
-            }
-            return ok({ ...base, commitMode: 'auto-head' });
-        }
-        case 'list-units': {
-            const phase = typeof data.phase === 'string' ? data.phase : undefined;
-            return ok({
-                command: 'list-units',
-                ...(phase !== undefined && { phase }),
-                json,
-            });
-        }
-        case 'context': {
-            const unitId = typeof data.unitId === 'string' ? data.unitId : undefined;
-            if (!unitId) {
-                return fail('STDIN_MISSING_FIELD', 'stdin JSON에 "unitId" (string) 필드가 필요합니다', '예시: {"unitId": "U-001[Mvp]"}');
-            }
-            return ok({ command: 'context', unitId, json });
-        }
-        case 'validate':
-            return ok({ command: 'validate', json });
-        case 'init':
-            return ok({
-                command: 'init',
-                json,
-                stdinData: data,
-                fromExisting: rawArgs?.includes('--from-existing') ?? false,
-                force: rawArgs?.includes('--force') ?? false,
-            });
-        case 'skill': {
-            if (!rawArgs?.includes('install')) {
-                return fail('UNKNOWN_COMMAND', 'skill 서브커맨드가 필요합니다', '사용법: vc skill install --stdin --json');
-            }
-            const stdinTargets = Array.isArray(data.targets)
-                ? data.targets.filter((t) => t === 'cursor' || t === 'claude' || t === 'gemini')
-                : [];
-            const targets = stdinTargets.length > 0 ? stdinTargets : ['cursor', 'claude', 'gemini'];
-            return ok({
-                command: 'skill-install',
-                targets,
-                force: rawArgs.includes('--force'),
-                json,
-            });
-        }
-        case 'schema': {
-            const sub = typeof data.subcommand === 'string' ? data.subcommand : undefined;
-            if (sub && sub !== 'config' && sub !== 'commands' && sub !== 'types') {
-                return fail('UNKNOWN_SUBCOMMAND', `알 수 없는 schema 서브커맨드: ${sub}`, '사용 가능한 서브커맨드: config, commands, types');
-            }
-            const output = typeof data.output === 'string' ? data.output : undefined;
-            return ok({
-                command: 'schema',
-                ...(sub !== undefined && { subcommand: sub }),
-                json,
-                ...(output !== undefined && { output }),
-            });
-        }
-        default:
-            return fail('UNKNOWN_COMMAND', `알 수 없는 명령어: ${subcommand}`, '사용 가능한 명령어: init, set-unit, update-commit, list-units, context, validate, skill, schema');
-    }
-}
 // ── 메인 라우터 ──
 /**
  * CLI 라우터 메인 실행 함수
@@ -445,12 +346,12 @@ function emitError(result, json) {
     process.exitCode = 1;
 }
 /**
- * 스텁 핸들러 — 후속 유닛에서 교체될 임시 핸들러
+ * 스텁 핸들러 — 미구현 커맨드용 임시 핸들러
  *
  * 해당 커맨드가 아직 구현되지 않았음을 알린다.
  */
 function stubHandler(args) {
-    return fail('NOT_IMPLEMENTED', `'${args.command}' 명령어는 아직 구현되지 않았습니다`, '후속 유닛(U-014 ~ U-016)에서 구현 예정');
+    return fail('NOT_IMPLEMENTED', `'${args.command}' 명령어는 아직 구현되지 않았습니다`, '이 명령어는 아직 구현되지 않았습니다');
 }
 /**
  * 에러 상세 메시지에서 인자 이름을 추출

package/dist/adapters/cli/stdin-parser.d.ts

@@ -0,0 +1,23 @@
+/**
+ * stdin JSON → ParsedArgs 변환 — Layer 3 (Adapter)
+ *
+ * stdin을 통해 전달된 JSON 데이터를 ParsedArgs로 변환한다.
+ * 서브커맨드는 argv에서 결정되고, 인자/옵션은 stdin JSON에서 추출.
+ *
+ * @module
+ */
+import type { ToolResult } from '../../types/index.js';
+import type { ParsedArgs } from './router.js';
+/**
+ * stdin JSON 데이터로부터 ParsedArgs를 생성한다
+ *
+ * 서브커맨드는 argv에서 결정되고, 인자/옵션은 stdin JSON에서 추출.
+ * --stdin은 --no-prompt를 암시한다 (stdin이 JSON 데이터에 사용되므로 인터랙티브 불가).
+ *
+ * @param subcommand - argv에서 추출한 서브커맨드 이름
+ * @param data - stdin에서 파싱한 JSON 객체
+ * @param json - --json 플래그 여부
+ * @returns ParsedArgs 또는 에러
+ */
+export declare function parseStdinArgs(subcommand: string, data: Record<string, unknown>, json: boolean, rawArgs?: readonly string[]): ToolResult<ParsedArgs>;
+//# sourceMappingURL=stdin-parser.d.ts.map