vibe-commander 0.1.0

package/dist/adapters/cli/formatters.js

@@ -0,0 +1,3 @@
+export {};
+// DEPRECATED: Split into formatters-unit.ts and formatters-list.ts
+//# sourceMappingURL=formatters.js.map

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

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * vibe-commander CLI 진입점 — Layer 3 (Adapter)
+ *
+ * hashbang을 포함하여 `npx vc` 또는 글로벌 설치 후 `vc` 명령으로 실행 가능.
+ * 설정 파일을 로드하고 서브커맨드 라우터로 위임.
+ *
+ * 파이프라인:
+ * 1. 프로젝트 루트 결정 (cwd 기준)
+ * 2. process.argv 파싱 → 서브커맨드 판별
+ * 3. loadConfig 호출 → 설정 주입
+ * 4. 서브커맨드 핸들러 실행 → 결과 출력
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/cli/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+/**
+ * vibe-commander CLI 진입점 — Layer 3 (Adapter)
+ *
+ * hashbang을 포함하여 `npx vc` 또는 글로벌 설치 후 `vc` 명령으로 실행 가능.
+ * 설정 파일을 로드하고 서브커맨드 라우터로 위임.
+ *
+ * 파이프라인:
+ * 1. 프로젝트 루트 결정 (cwd 기준)
+ * 2. process.argv 파싱 → 서브커맨드 판별
+ * 3. loadConfig 호출 → 설정 주입
+ * 4. 서브커맨드 핸들러 실행 → 결과 출력
+ *
+ * @module
+ */
+import { resolve } from 'node:path';
+import { route } from './router.js';
+import { handleSetUnit } from './commands/set-unit.js';
+import { handleUpdateCommit } from './commands/update-commit.js';
+import { handleListUnits } from './commands/list-units.js';
+import { handleContext } from './commands/context.js';
+import { handleInit } from './commands/init.js';
+import { handleValidate } from './commands/validate.js';
+import { handleSkillInstall } from './commands/skill-install.js';
+import { formatContext, formatSetUnit, formatInit, formatValidate, formatSkillInstall, } from './formatters-unit.js';
+import { formatListUnits, formatUpdateCommit } from './formatters-list.js';
+const handlers = {
+    init: handleInit,
+    'set-unit': handleSetUnit,
+    'update-commit': handleUpdateCommit,
+    'list-units': handleListUnits,
+    context: handleContext,
+    validate: handleValidate,
+    'skill-install': handleSkillInstall,
+};
+const formatters = {
+    init: formatInit,
+    'set-unit': formatSetUnit,
+    'update-commit': formatUpdateCommit,
+    'list-units': formatListUnits,
+    context: formatContext,
+    validate: formatValidate,
+    'skill-install': formatSkillInstall,
+};
+/**
+ * CLI 메인 실행 함수
+ *
+ * 프로젝트 루트를 cwd로 결정하고 라우터에 위임한다.
+ * 설정 로드는 각 서브커맨드 핸들러 내부에서 수행하여,
+ * --help, --version 등 설정 불필요 커맨드의 부팅 속도를 최적화.
+ */
+async function main() {
+    const projectRoot = resolve(process.cwd());
+    await route(process.argv, projectRoot, handlers, formatters);
+}
+main().catch((err) => {
+    console.error('예기치 않은 오류:', err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,58 @@
+/**
+ * CLI 콘솔 출력 기본 유틸리티 — Layer 3 (Adapter)
+ *
+ * ToolResult 기반 성공/에러 메시지 출력과 글로벌 도움말을 담당한다.
+ * ANSI escape 코드를 직접 사용하여 외부 의존성 없이 컬러 출력.
+ *
+ * @module
+ */
+import type { ToolResult } from '../../types/index.js';
+export declare const RESET = "\u001B[0m";
+export declare const RED = "\u001B[31m";
+export declare const GREEN = "\u001B[32m";
+export declare const YELLOW = "\u001B[33m";
+export declare const CYAN = "\u001B[36m";
+export declare const DIM = "\u001B[2m";
+export declare const BOLD = "\u001B[1m";
+/**
+ * 성공 결과를 콘솔에 출력한다
+ *
+ * JSON 모드일 경우 구조화된 JSON을 stdout에 출력하고,
+ * 일반 모드에서는 사람이 읽기 편한 포맷으로 출력한다.
+ *
+ * @param result - ToolResult 성공 결과
+ * @param json - JSON 출력 모드 여부
+ */
+export declare function printSuccess<T>(result: ToolResult<T>, json: boolean): void;
+/**
+ * 에러 결과를 콘솔에 출력한다
+ *
+ * JSON 모드일 경우 구조화된 에러 JSON을 stderr에 출력하고,
+ * 일반 모드에서는 빨간 텍스트로 사람이 읽기 편하게 출력한다.
+ *
+ * @param result - ToolResult 에러 결과
+ * @param json - JSON 출력 모드 여부
+ */
+export declare function printError<T>(result: ToolResult<T>, json: boolean): void;
+/**
+ * 도움말 메시지를 출력한다
+ */
+export declare function printHelp(): void;
+/**
+ * 버전 정보를 출력한다
+ */
+export declare function printVersion(): void;
+/**
+ * 알 수 없는 커맨드 에러를 출력한다
+ *
+ * @param command - 사용자가 입력한 알 수 없는 커맨드
+ */
+export declare function printUnknownCommand(command: string): void;
+/**
+ * 필수 인자 누락 에러를 출력한다
+ *
+ * @param command - 현재 커맨드
+ * @param argName - 누락된 인자 이름
+ */
+export declare function printMissingArg(command: string, argName: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/adapters/cli/output.js

@@ -0,0 +1,159 @@
+/**
+ * CLI 콘솔 출력 기본 유틸리티 — Layer 3 (Adapter)
+ *
+ * ToolResult 기반 성공/에러 메시지 출력과 글로벌 도움말을 담당한다.
+ * ANSI escape 코드를 직접 사용하여 외부 의존성 없이 컬러 출력.
+ *
+ * @module
+ */
+import { createRequire } from 'node:module';
+// ── ANSI 컬러 코드 ──
+export const RESET = '\x1b[0m';
+export const RED = '\x1b[31m';
+export const GREEN = '\x1b[32m';
+export const YELLOW = '\x1b[33m';
+export const CYAN = '\x1b[36m';
+export const DIM = '\x1b[2m';
+export const BOLD = '\x1b[1m';
+const require = createRequire(import.meta.url);
+const pkg = require('../../../package.json');
+const VERSION = pkg.version;
+/**
+ * 성공 결과를 콘솔에 출력한다
+ *
+ * JSON 모드일 경우 구조화된 JSON을 stdout에 출력하고,
+ * 일반 모드에서는 사람이 읽기 편한 포맷으로 출력한다.
+ *
+ * @param result - ToolResult 성공 결과
+ * @param json - JSON 출력 모드 여부
+ */
+export function printSuccess(result, json) {
+    if (!result.success)
+        return;
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        console.log(`${GREEN}✅ 성공${RESET}`);
+        if (result.data && typeof result.data === 'object') {
+            console.log(JSON.stringify(result.data, null, 2));
+        }
+        else {
+            console.log(String(result.data));
+        }
+    }
+}
+/**
+ * 에러 결과를 콘솔에 출력한다
+ *
+ * JSON 모드일 경우 구조화된 에러 JSON을 stderr에 출력하고,
+ * 일반 모드에서는 빨간 텍스트로 사람이 읽기 편하게 출력한다.
+ *
+ * @param result - ToolResult 에러 결과
+ * @param json - JSON 출력 모드 여부
+ */
+export function printError(result, json) {
+    if (result.success)
+        return;
+    if (json) {
+        console.error(JSON.stringify(result, null, 2));
+    }
+    else {
+        console.error(`${RED}❌ 에러: ${result.error.message}${RESET}`);
+        console.error(`${DIM}   코드: ${result.error.code}${RESET}`);
+        if (result.error.details) {
+            console.error(`${DIM}   상세: ${result.error.details}${RESET}`);
+        }
+    }
+}
+/**
+ * 도움말 메시지를 출력한다
+ */
+export function printHelp() {
+    console.log(`
+${BOLD}vibe-commander${RESET} ${DIM}v${VERSION}${RESET}
+${DIM}유닛 기반 바이브 코딩 워크플로우 자동화 CLI 도구${RESET}
+
+${YELLOW}사용법:${RESET}
+  ${CYAN}vc${RESET} <command> [options]
+
+${YELLOW}명령어:${RESET}
+  ${CYAN}init${RESET} [--from-existing]            프로젝트 초기화 (설정 생성)
+  ${CYAN}set-unit${RESET} <unitId> [--request]   현재 작업 유닛 설정
+  ${CYAN}update-commit${RESET} [sha|N]           커밋 SHA 업데이트 (인자 없음=HEAD, 숫자=최근 N개)
+  ${CYAN}list-units${RESET}                     미완료 유닛 목록
+  ${CYAN}context${RESET} <unitId>               유닛 컨텍스트 조회 (읽기 전용)
+  ${CYAN}validate${RESET}                       설정 파일 검증
+  ${CYAN}skill install${RESET}                  SKILL 파일 설치 (Cursor/Claude/Gemini)
+
+${YELLOW}글로벌 옵션:${RESET}
+  ${CYAN}--help${RESET}, ${CYAN}-h${RESET}                    도움말 출력
+  ${CYAN}--version${RESET}, ${CYAN}-v${RESET}                 버전 출력
+  ${CYAN}--json${RESET}                         JSON 형식으로 출력 (ToolResult 구조)
+  ${CYAN}--stdin${RESET}                        stdin에서 JSON 입력 읽기
+
+${YELLOW}set-unit 옵션:${RESET}
+  ${CYAN}--request${RESET} <key1,key2>             커스텀 특별 요청사항 키 선택 (콤마 구분)
+  ${CYAN}--no-prompt${RESET}                       페어링 질문 인터랙티브 프롬프트 비활성화
+
+${YELLOW}update-commit 옵션:${RESET}
+  ${CYAN}--mode${RESET} replace|append            값 교체 또는 추가 (기본: replace)
+  ${CYAN}--section${RESET} <name>                  대상 섹션 지정 (미지정 시 자동 감지)
+
+${YELLOW}init 옵션:${RESET}
+  ${CYAN}--from-existing${RESET}                    기존 파일 스캔으로 ID 패턴/디렉토리 자동 감지
+
+${YELLOW}skill install 옵션:${RESET}
+  ${CYAN}--cursor${RESET}                           Cursor만 설치 (.cursor/skills/)
+  ${CYAN}--claude${RESET}                           Claude Code만 설치 (.claude/skills/)
+  ${CYAN}--gemini${RESET}                           Gemini만 설치 (.gemini/skills/)
+  ${CYAN}--force${RESET}                            기존 파일 덮어쓰기
+
+${YELLOW}예시:${RESET}
+  ${DIM}$ vc validate${RESET}                          ${DIM}# 설정 파일 종합 검증${RESET}
+  ${DIM}$ vc init${RESET}
+  ${DIM}$ vc init --from-existing${RESET}              ${DIM}# 기존 파일 스캔으로 자동 설정${RESET}
+  ${DIM}$ vc set-unit U-013[Mvp]${RESET}
+  ${DIM}$ vc set-unit U-013[Mvp] --request mcp-nanobanana,mcp-codrag${RESET}
+  ${DIM}$ vc update-commit${RESET}                    ${DIM}# HEAD SHA 자동 감지${RESET}
+  ${DIM}$ vc update-commit 3${RESET}                   ${DIM}# 최근 3개 커밋 SHA${RESET}
+  ${DIM}$ vc update-commit abc1234 --mode append${RESET}
+  ${DIM}$ vc list-units --phase Mvp${RESET}
+  ${DIM}$ vc context U-013[Mvp] --json${RESET}
+  ${DIM}$ vc skill install${RESET}                    ${DIM}# Cursor + Claude + Gemini 모두 설치${RESET}
+  ${DIM}$ vc skill install --cursor${RESET}            ${DIM}# Cursor만 설치${RESET}
+  ${DIM}$ vc skill install --force${RESET}             ${DIM}# 기존 파일 덮어쓰기${RESET}
+
+${YELLOW}파이프 모드 (에이전트/오케스트레이터 연동):${RESET}
+  ${DIM}$ echo '{"unitId":"U-013[Mvp]"}' | vc set-unit --stdin --json${RESET}
+  ${DIM}$ echo '{"count":3}' | vc update-commit --stdin --json${RESET}
+  ${DIM}$ echo '{}' | vc list-units --stdin --json${RESET}
+  ${DIM}$ echo '{"unitId":"U-013[Mvp]"}' | vc context --stdin --json${RESET}
+`);
+}
+/**
+ * 버전 정보를 출력한다
+ */
+export function printVersion() {
+    console.log(`vibe-commander v${VERSION}`);
+}
+/**
+ * 알 수 없는 커맨드 에러를 출력한다
+ *
+ * @param command - 사용자가 입력한 알 수 없는 커맨드
+ */
+export function printUnknownCommand(command) {
+    console.error(`${RED}❌ 알 수 없는 명령어: ${command}${RESET}`);
+    console.error(`${DIM}   'vc --help'로 사용 가능한 명령어를 확인하세요.${RESET}\n`);
+}
+/**
+ * 필수 인자 누락 에러를 출력한다
+ *
+ * @param command - 현재 커맨드
+ * @param argName - 누락된 인자 이름
+ */
+export function printMissingArg(command, argName) {
+    console.error(`${RED}❌ '${command}' 명령어에 <${argName}> 인자가 필요합니다.${RESET}`);
+    console.error(`${DIM}   사용법: vc ${command} <${argName}>${RESET}\n`);
+}
+//# sourceMappingURL=output.js.map

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

@@ -0,0 +1,99 @@
+/**
+ * CLI 서브커맨드 라우터 — Layer 3 (Adapter)
+ *
+ * process.argv를 직접 파싱하여 4개 서브커맨드(set-unit, update-commit,
+ * list-units, context)로 라우팅한다. Commander.js 등 외부 의존성 없이
+ * 자체 arg 파싱을 구현 (RULE-003, 페어링 Q1 Option B 채택).
+ *
+ * @module
+ */
+import type { ToolResult } from '../../types/index.js';
+/** 파싱된 서브커맨드별 옵션 */
+export interface SetUnitArgs {
+    command: 'set-unit';
+    unitId: string;
+    requestKeys: string[];
+    noPrompt: boolean;
+    json: boolean;
+}
+export interface UpdateCommitArgs {
+    command: 'update-commit';
+    commitMode: 'auto-head' | 'auto-recent' | 'manual';
+    sha?: string;
+    count?: number;
+    mode: 'replace' | 'append';
+    section?: string;
+    json: boolean;
+}
+export interface ListUnitsArgs {
+    command: 'list-units';
+    phase?: string;
+    json: boolean;
+}
+export interface ContextArgs {
+    command: 'context';
+    unitId: string;
+    json: boolean;
+}
+export interface ValidateArgs {
+    command: 'validate';
+    json: boolean;
+}
+export interface InitArgs {
+    command: 'init';
+    json: boolean;
+    fromExisting: boolean;
+    force: boolean;
+    stdinData?: Record<string, unknown>;
+}
+export interface SkillInstallArgs {
+    command: 'skill-install';
+    targets: ('cursor' | 'claude' | 'gemini')[];
+    force: boolean;
+    json: boolean;
+}
+export interface HelpArgs {
+    command: 'help';
+}
+export interface VersionArgs {
+    command: 'version';
+}
+export type ParsedArgs = SetUnitArgs | UpdateCommitArgs | ListUnitsArgs | ContextArgs | ValidateArgs | InitArgs | SkillInstallArgs | HelpArgs | VersionArgs;
+export type CommandHandler = (args: ParsedArgs, projectRoot: string) => Promise<ToolResult<unknown>> | ToolResult<unknown>;
+/** 커맨드별 커스텀 출력 포맷터 (list-units, context 등에서 사용) */
+export type CommandFormatter = (result: ToolResult<unknown>, json: boolean) => void;
+/**
+ * process.argv로부터 서브커맨드와 인자/옵션을 파싱한다
+ *
+ * argv[0] = node, argv[1] = script, argv[2] = subcommand 형태.
+ * 글로벌 플래그(--help, --version)는 서브커맨드보다 우선 처리.
+ *
+ * @param argv - process.argv 배열
+ * @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 라우터 메인 실행 함수
+ *
+ * process.argv를 파싱하고, 해당 서브커맨드의 핸들러를 호출하여 결과를 출력한다.
+ * 커맨드별 커스텀 포맷터가 등록되어 있으면 기본 출력 대신 포맷터를 사용.
+ *
+ * @param argv - process.argv
+ * @param projectRoot - 프로젝트 루트 경로
+ * @param handlers - 서브커맨드별 핸들러 맵 (선택, 미제공 시 stub 사용)
+ * @param formatters - 서브커맨드별 커스텀 출력 포맷터 (선택)
+ */
+export declare function route(argv: readonly string[], projectRoot: string, handlers?: Partial<Record<string, CommandHandler>>, formatters?: Partial<Record<string, CommandFormatter>>): Promise<void>;
+//# sourceMappingURL=router.d.ts.map