vibe-commander 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 viilab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adapters/cli/commands/context-resolver.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 유닛 컨텍스트 해석기 — Layer 3 (Adapter)
+ *
+ * 유닛 ID를 받아 설정 로드, 계획서 파싱, 의존성 수집을 거쳐
+ * 최종 CommandContext를 구성하는 공통 로직을 담당한다.
+ * set-unit과 context 커맨드에서 공통으로 사용.
+ *
+ * @module
+ */
+import type { ToolResult, CommandContext, ProjectConfig, UnitTypeConfig } from '../../../types/index.js';
+/** 컨텍스트 해석 결과 (Context + 추가 메타데이터) */
+export interface ResolvedContext {
+    context: CommandContext;
+    config: ProjectConfig;
+    unitTypeKey: string;
+    unitTypeConfig: UnitTypeConfig;
+    planRelPath: string;
+    warnings: string[];
+}
+/**
+ * 유닛 ID에 해당하는 전체 컨텍스트를 해석한다
+ *
+ * @param unitId - 유닛 ID
+ * @param projectRoot - 프로젝트 루트 절대 경로
+ * @param requestKeys - 커스텀 요청사항 키 목록 (--request 옵션)
+ * @returns 해석된 컨텍스트 또는 에러
+ */
+export declare function resolveCommandContext(unitId: string, projectRoot: string, requestKeys?: string[]): ToolResult<ResolvedContext>;
+//# sourceMappingURL=context-resolver.d.ts.map

package/dist/adapters/cli/commands/context-resolver.js

@@ -0,0 +1,93 @@
+/**
+ * 유닛 컨텍스트 해석기 — Layer 3 (Adapter)
+ *
+ * 유닛 ID를 받아 설정 로드, 계획서 파싱, 의존성 수집을 거쳐
+ * 최종 CommandContext를 구성하는 공통 로직을 담당한다.
+ * set-unit과 context 커맨드에서 공통으로 사용.
+ *
+ * @module
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ok, fail } from '../../../types/index.js';
+import { loadConfig } from '../../../config/loader.js';
+import { resolveUnitType, locatePlan } from '../../../config/resolver.js';
+import { parseUnitPlan } from '../../../core/parsers/plan-parser.js';
+import { resolveDepDocs } from '../../../core/resolvers/dep-doc-resolver.js';
+import { resolveActualDocs, collectGitCommits, buildSpecialRequests } from './io-helpers.js';
+/**
+ * 유닛 ID에 해당하는 전체 컨텍스트를 해석한다
+ *
+ * @param unitId - 유닛 ID
+ * @param projectRoot - 프로젝트 루트 절대 경로
+ * @param requestKeys - 커스텀 요청사항 키 목록 (--request 옵션)
+ * @returns 해석된 컨텍스트 또는 에러
+ */
+export function resolveCommandContext(unitId, projectRoot, requestKeys) {
+    // 1. 설정 로드
+    const configResult = loadConfig(projectRoot);
+    if (!configResult.success)
+        return configResult;
+    const config = configResult.data;
+    // 2. 유닛 유형 판별
+    const typeResult = resolveUnitType(unitId, config);
+    if (!typeResult.success)
+        return typeResult;
+    const unitTypeConfig = typeResult.data;
+    // 3. 계획서 경로 결정
+    const planResult = locatePlan(unitId, config);
+    if (!planResult.success)
+        return planResult;
+    const planRelPath = planResult.data;
+    const planAbsPath = join(projectRoot, planRelPath);
+    // 4. 계획서 읽기 (Adapter I/O)
+    let planContent;
+    try {
+        planContent = readFileSync(planAbsPath, 'utf-8');
+    }
+    catch {
+        return fail('PLAN_NOT_FOUND', `계획서를 찾을 수 없습니다: ${planRelPath}`, `절대 경로: ${planAbsPath}`);
+    }
+    // 5. 계획서 파싱 (Core 순수 함수)
+    const parseResult = parseUnitPlan(planContent, unitId, config.planParsing, unitTypeConfig.idPattern);
+    if (!parseResult.success)
+        return parseResult;
+    const { meta, questions, warnings } = parseResult.data;
+    // Layer 2/3 메타데이터 추가
+    meta.unitType = unitTypeConfig.key;
+    meta.planPath = planRelPath;
+    // 6. 의존성 수집 (collectDeps=true이고 의존성이 있을 때만)
+    let depDocs = [];
+    let depCommits = [];
+    if (unitTypeConfig.collectDeps && meta.depends.length > 0) {
+        const depIds = meta.depends.map((d) => d.unitId);
+        // 6a. 의존 문서 경로 패턴 → 실제 파일 확인 (Adapter I/O)
+        const docResult = resolveDepDocs(depIds, config.paths.docRoots, config.docDiscovery);
+        if (docResult.success) {
+            depDocs = resolveActualDocs(docResult.data, projectRoot);
+        }
+        // 6b. Git 커밋 수집 (Adapter I/O)
+        depCommits = collectGitCommits(depIds, config.commitSearch, projectRoot);
+    }
+    // 7. 특별 요청사항 조합
+    const srResult = buildSpecialRequests(config, unitTypeConfig.key, requestKeys);
+    const specialRequests = srResult.requests;
+    warnings.push(...srResult.warnings);
+    // 8. CommandContext 조립
+    const context = {
+        unit: meta,
+        depDocs,
+        depCommits,
+        pairingQuestions: questions,
+        specialRequests,
+    };
+    return ok({
+        context,
+        config,
+        unitTypeKey: unitTypeConfig.key,
+        unitTypeConfig,
+        planRelPath,
+        warnings,
+    });
+}
+//# sourceMappingURL=context-resolver.js.map

package/dist/adapters/cli/commands/context.d.ts

@@ -0,0 +1,26 @@
+/**
+ * context 커맨드 핸들러 — Layer 3 (Adapter)
+ *
+ * set-unit과 동일한 파싱 파이프라인을 실행하되,
+ * 커맨드 파일을 수정하지 않고 CommandContext만 반환한다.
+ * 읽기 전용 유닛 컨텍스트 조회에 사용.
+ *
+ * Core 순수 함수들(parseUnitPlan, resolveDepDocs, findDepCommits)을 조합하며,
+ * I/O(파일 읽기, git 실행)는 이 Adapter에서만 수행.
+ *
+ * @module
+ */
+import type { ToolResult, CommandContext } from '../../../types/index.js';
+import type { ParsedArgs } from '../router.js';
+/**
+ * context 커맨드를 실행한다
+ *
+ * set-unit의 컨텍스트 해석 로직(resolveCommandContext)을 재사용하되,
+ * 섹션 렌더링·커맨드 파일 업데이트를 생략하고 JSON/텍스트 결과만 반환한다.
+ *
+ * @param args - 파싱된 CLI 인자 (command === 'context' 보장)
+ * @param projectRoot - 프로젝트 루트 절대 경로
+ * @returns CommandContext 또는 에러
+ */
+export declare function handleContext(args: ParsedArgs, projectRoot: string): ToolResult<CommandContext>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1,39 @@
+/**
+ * context 커맨드 핸들러 — Layer 3 (Adapter)
+ *
+ * set-unit과 동일한 파싱 파이프라인을 실행하되,
+ * 커맨드 파일을 수정하지 않고 CommandContext만 반환한다.
+ * 읽기 전용 유닛 컨텍스트 조회에 사용.
+ *
+ * Core 순수 함수들(parseUnitPlan, resolveDepDocs, findDepCommits)을 조합하며,
+ * I/O(파일 읽기, git 실행)는 이 Adapter에서만 수행.
+ *
+ * @module
+ */
+import { fail } from '../../../types/index.js';
+import { resolveCommandContext } from './context-resolver.js';
+/**
+ * context 커맨드를 실행한다
+ *
+ * set-unit의 컨텍스트 해석 로직(resolveCommandContext)을 재사용하되,
+ * 섹션 렌더링·커맨드 파일 업데이트를 생략하고 JSON/텍스트 결과만 반환한다.
+ *
+ * @param args - 파싱된 CLI 인자 (command === 'context' 보장)
+ * @param projectRoot - 프로젝트 루트 절대 경로
+ * @returns CommandContext 또는 에러
+ */
+export function handleContext(args, projectRoot) {
+    if (args.command !== 'context') {
+        return fail('INTERNAL_ERROR', 'handleContext에 잘못된 커맨드가 전달되었습니다');
+    }
+    const { unitId } = args;
+    // 1. 전체 컨텍스트 해석 (I/O + 파싱 + 의존성 수집)
+    const resolveResult = resolveCommandContext(unitId, projectRoot);
+    if (!resolveResult.success)
+        return resolveResult;
+    return {
+        success: true,
+        data: resolveResult.data.context,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/adapters/cli/commands/git-helpers.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Git 헬퍼 함수 — Layer 3 (Adapter)
+ *
+ * git CLI를 child_process로 실행하여 커밋 SHA를 수집한다.
+ * Layer 3에 배치: child_process 사용이므로 Core에 배치 불가.
+ *
+ * @module
+ */
+import type { ToolResult } from '../../../types/index.js';
+/**
+ * 현재 HEAD 커밋의 short SHA(8자)를 반환한다
+ *
+ * @param projectRoot - git 저장소 루트 경로
+ * @returns short SHA 문자열 또는 에러
+ */
+export declare function getHeadSha(projectRoot: string): ToolResult<string>;
+/**
+ * 특정 커밋에서 변경된 파일 경로 목록을 반환한다
+ *
+ * `git diff-tree --no-commit-id --name-only -r <SHA>` 실행.
+ * 프로젝트 루트 기준 상대 경로 배열로 반환.
+ * merge commit의 경우 첫 번째 parent 기준 diff 사용 (`-c` 옵션 미사용).
+ *
+ * @param projectRoot - git 저장소 루트 경로
+ * @param sha - 커밋 SHA (축약 또는 전체)
+ * @returns 변경 파일 경로 배열 또는 에러
+ */
+export declare function getChangedFiles(projectRoot: string, sha: string): ToolResult<string[]>;
+/**
+ * 최근 N개 커밋의 short SHA(8자) 배열을 반환한다
+ *
+ * 커밋 수가 요청보다 적으면 있는 만큼만 반환 (Graceful Degradation)
+ *
+ * @param projectRoot - git 저장소 루트 경로
+ * @param count - 가져올 커밋 수
+ * @returns short SHA 배열과 실제 개수 정보 또는 에러
+ */
+export declare function getRecentShas(projectRoot: string, count: number): ToolResult<{
+    shas: string[];
+    requested: number;
+    actual: number;
+}>;
+//# sourceMappingURL=git-helpers.d.ts.map

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

@@ -0,0 +1,99 @@
+/**
+ * Git 헬퍼 함수 — Layer 3 (Adapter)
+ *
+ * git CLI를 child_process로 실행하여 커밋 SHA를 수집한다.
+ * Layer 3에 배치: child_process 사용이므로 Core에 배치 불가.
+ *
+ * @module
+ */
+import { execSync } from 'node:child_process';
+import { ok, fail } from '../../../types/index.js';
+/**
+ * 현재 HEAD 커밋의 short SHA(8자)를 반환한다
+ *
+ * @param projectRoot - git 저장소 루트 경로
+ * @returns short SHA 문자열 또는 에러
+ */
+export function getHeadSha(projectRoot) {
+    try {
+        const sha = execSync('git rev-parse --short=8 HEAD', {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).replace(/[\r\n]+$/, '');
+        if (!sha) {
+            return fail('GIT_NO_COMMITS', '커밋이 없는 저장소입니다', '최소 1개의 커밋이 필요합니다');
+        }
+        return ok(sha);
+    }
+    catch {
+        return fail('GIT_NOT_AVAILABLE', 'git 명령을 실행할 수 없습니다', '현재 디렉토리가 git 저장소인지 확인하세요');
+    }
+}
+/**
+ * 특정 커밋에서 변경된 파일 경로 목록을 반환한다
+ *
+ * `git diff-tree --no-commit-id --name-only -r <SHA>` 실행.
+ * 프로젝트 루트 기준 상대 경로 배열로 반환.
+ * merge commit의 경우 첫 번째 parent 기준 diff 사용 (`-c` 옵션 미사용).
+ *
+ * @param projectRoot - git 저장소 루트 경로
+ * @param sha - 커밋 SHA (축약 또는 전체)
+ * @returns 변경 파일 경로 배열 또는 에러
+ */
+export function getChangedFiles(projectRoot, sha) {
+    try {
+        const output = execSync(`git diff-tree --no-commit-id --name-only -r ${sha}`, {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const files = output
+            .replace(/\r\n/g, '\n')
+            .trim()
+            .split('\n')
+            .map((s) => s.trim())
+            .filter(Boolean);
+        return ok(files);
+    }
+    catch {
+        return fail('GIT_DIFF_TREE_FAILED', `변경 파일 목록을 가져올 수 없습니다: ${sha}`, 'SHA가 유효하지 않거나 git 명령이 실패했습니다');
+    }
+}
+/**
+ * 최근 N개 커밋의 short SHA(8자) 배열을 반환한다
+ *
+ * 커밋 수가 요청보다 적으면 있는 만큼만 반환 (Graceful Degradation)
+ *
+ * @param projectRoot - git 저장소 루트 경로
+ * @param count - 가져올 커밋 수
+ * @returns short SHA 배열과 실제 개수 정보 또는 에러
+ */
+export function getRecentShas(projectRoot, count) {
+    try {
+        const output = execSync(`git log --format=%h --abbrev=8 -n ${String(count)}`, {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        })
+            .replace(/\r\n/g, '\n')
+            .trim();
+        const shas = output
+            ? output
+                .split('\n')
+                .map((s) => s.trim())
+                .filter(Boolean)
+            : [];
+        if (shas.length === 0) {
+            return fail('GIT_NO_COMMITS', '커밋이 없는 저장소입니다', '최소 1개의 커밋이 필요합니다');
+        }
+        return ok({ shas, requested: count, actual: shas.length });
+    }
+    catch {
+        return fail('GIT_NOT_AVAILABLE', 'git 명령을 실행할 수 없습니다', '현재 디렉토리가 git 저장소인지 확인하세요');
+    }
+}
+//# sourceMappingURL=git-helpers.js.map

package/dist/adapters/cli/commands/init-helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * init 공용 유틸리티 — Layer 3 (Adapter)
+ *
+ * init 커맨드의 모드(대화형/stdin/from-existing)에 관계없이
+ * 공통으로 사용되는 유틸리티 함수들을 모아 놓는다.
+ *
+ * - stdin 추출, 스캔 결과 변환, config 빌드/검증/쓰기
+ * - 스캔 결과 콘솔 출력, 기존 config 읽기, 정규식 검증
+ *
+ * @module
+ */
+import type { ToolResult, ScanResult, InitAnswers, InitResult } from '../../../types/index.js';
+export { DEFAULT_COMMANDS_PATH, DEFAULT_ROADMAP_PATH, DEFAULT_PLAN_DIR, DEFAULT_RESULT_DIR, DEFAULT_ID_PATTERN, DEFAULT_COMMAND_SECTION, DEFAULT_HEADER_TEMPLATE, extractStdinAnswers, buildAnswersFromScan, } from '../../../core/resolvers/config-generator.js';
+/**
+ * 수집된 정보로 설정 객체를 구성하고, 검증 후 파일에 쓴다
+ *
+ * @param mergeWith - 기존 설정 객체. 제공되면 스캔 결과와 병합한다.
+ */
+export declare function buildAndWriteConfig(answers: InitAnswers, configPath: string, alreadyExists: boolean, scanResult?: ScanResult, mergeWith?: Record<string, unknown>): ToolResult<InitResult>;
+/**
+ * 기존 설정 파일을 읽어 JSON 객체로 파싱한다
+ *
+ * 파싱 실패 시 null을 반환하여 병합 대신 새 config 생성으로 fallback.
+ */
+export declare function readExistingConfig(configPath: string): Record<string, unknown> | null;
+/**
+ * 스캔 결과를 콘솔에 표시한다
+ */
+export declare function printScanResults(scan: ScanResult): void;
+//# sourceMappingURL=init-helpers.d.ts.map

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

@@ -0,0 +1,112 @@
+/**
+ * init 공용 유틸리티 — Layer 3 (Adapter)
+ *
+ * init 커맨드의 모드(대화형/stdin/from-existing)에 관계없이
+ * 공통으로 사용되는 유틸리티 함수들을 모아 놓는다.
+ *
+ * - stdin 추출, 스캔 결과 변환, config 빌드/검증/쓰기
+ * - 스캔 결과 콘솔 출력, 기존 config 읽기, 정규식 검증
+ *
+ * @module
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { ok, fail } from '../../../types/index.js';
+import { projectConfigSchema } from '../../../config/schema.js';
+import { CYAN, YELLOW, GREEN, DIM, RESET, BOLD } from '../output.js';
+import { mergeConfigs } from '../../../core/resolvers/config-merger.js';
+import { buildConfigObject } from '../../../core/resolvers/config-generator.js';
+export { DEFAULT_COMMANDS_PATH, DEFAULT_ROADMAP_PATH, DEFAULT_PLAN_DIR, DEFAULT_RESULT_DIR, DEFAULT_ID_PATTERN, DEFAULT_COMMAND_SECTION, DEFAULT_HEADER_TEMPLATE, extractStdinAnswers, buildAnswersFromScan, } from '../../../core/resolvers/config-generator.js';
+/**
+ * 수집된 정보로 설정 객체를 구성하고, 검증 후 파일에 쓴다
+ *
+ * @param mergeWith - 기존 설정 객체. 제공되면 스캔 결과와 병합한다.
+ */
+export function buildAndWriteConfig(answers, configPath, alreadyExists, scanResult, mergeWith) {
+    let configObj = buildConfigObject(answers);
+    if (mergeWith) {
+        configObj = mergeConfigs(mergeWith, configObj);
+    }
+    const result = projectConfigSchema.safeParse(configObj);
+    if (!result.success) {
+        const details = result.error.issues
+            .map((issue) => `  - ${issue.path.map(String).join('.') || '(root)'}: ${issue.message}`)
+            .join('\n');
+        return fail('INIT_VALIDATION_FAILED', '생성된 설정이 스키마 검증에 실패했습니다', details);
+    }
+    const jsonContent = JSON.stringify(configObj, null, 2) + '\n';
+    try {
+        writeFileSync(configPath, jsonContent, 'utf-8');
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        return fail('INIT_WRITE_FAILED', '설정 파일 쓰기에 실패했습니다', `경로: ${configPath}, 원인: ${detail}`);
+    }
+    return ok({
+        configPath,
+        overwritten: alreadyExists,
+        merged: mergeWith !== undefined,
+        ...(scanResult && { scanResult }),
+    });
+}
+/**
+ * 기존 설정 파일을 읽어 JSON 객체로 파싱한다
+ *
+ * 파싱 실패 시 null을 반환하여 병합 대신 새 config 생성으로 fallback.
+ */
+export function readExistingConfig(configPath) {
+    try {
+        const raw = readFileSync(configPath, 'utf-8');
+        const content = raw.startsWith('\uFEFF') ? raw.slice(1) : raw;
+        const parsed = JSON.parse(content);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        console.log(`${YELLOW}⚠️  기존 설정 파일을 파싱할 수 없습니다. 새 설정을 생성합니다.${RESET}`);
+        return null;
+    }
+}
+/**
+ * 스캔 결과를 콘솔에 표시한다
+ */
+export function printScanResults(scan) {
+    console.log(`${DIM}🔍 스캔 완료: ${String(scan.totalMdFiles)}개 .md 파일 분석${RESET}`);
+    console.log('');
+    if (scan.idPatterns.length > 0) {
+        console.log(`${BOLD}📊 감지된 ID 패턴:${RESET}`);
+        for (const p of scan.idPatterns) {
+            const examples = p.examples.slice(0, 3).join(', ');
+            console.log(`  → ${CYAN}${p.displayLabel}${RESET} 패턴 (${GREEN}${String(p.matchCount)}개${RESET} 파일)  예: ${DIM}${examples}${RESET}`);
+        }
+        if (scan.suggestedIdPattern) {
+            console.log(`  ${DIM}→ 통합 패턴: ${scan.suggestedIdPattern}${RESET}`);
+        }
+        console.log('');
+    }
+    if (scan.docRoots.length > 0) {
+        console.log(`${BOLD}📂 감지된 문서 디렉토리:${RESET}`);
+        for (const d of scan.docRoots) {
+            const roleLabel = d.role !== 'other' ? `[${d.role}] ` : '';
+            console.log(`  → ${CYAN}${roleLabel}${d.dirPath}${RESET} (${String(d.fileCount)}개 파일)`);
+        }
+        console.log('');
+    }
+    if (scan.commandFiles.length > 0) {
+        console.log(`${BOLD}📄 커맨드 파일 후보:${RESET}`);
+        for (const c of scan.commandFiles) {
+            const sepInfo = c.hasSeparator ? ', 구분선 있음' : '';
+            console.log(`  → ${CYAN}${c.filePath}${RESET} (${String(c.sections.length)}개 섹션${sepInfo})`);
+        }
+        console.log('');
+    }
+    if (scan.roadmapCandidates.length > 0) {
+        console.log(`${BOLD}📋 로드맵 후보:${RESET}`);
+        for (const r of scan.roadmapCandidates) {
+            console.log(`  → ${CYAN}${r}${RESET}`);
+        }
+        console.log('');
+    }
+}
+//# sourceMappingURL=init-helpers.js.map

package/dist/adapters/cli/commands/init-interactive.d.ts

@@ -0,0 +1,25 @@
+/**
+ * init 대화형 모드 — Layer 3 (Adapter)
+ *
+ * readline 기반 대화형 질문 수집 로직을 담당한다.
+ * TTY 환경에서만 동작하며, stdin/pipe 모드와 완전히 분리된 관심사이다.
+ *
+ * - handleInteractive: 기본 대화형 초기화
+ * - handleFromExistingInteractive: 스캔 결과 확인 후 대화형 초기화
+ * - collectAnswers: 질문 세트 순서 실행
+ * - askWithDefault / askNullable: readline 헬퍼
+ *
+ * @module
+ */
+import type { ToolResult, ScanResult, InitResult } from '../../../types/index.js';
+/**
+ * 대화형 모드 — readline으로 질문을 수집하고 설정 파일을 생성한다
+ */
+export declare function handleInteractive(configPath: string, alreadyExists: boolean): Promise<ToolResult<InitResult>>;
+/**
+ * --from-existing 대화형 모드 — 스캔 결과를 보여주고 사용자 확인 후 설정 생성
+ *
+ * 기존 config가 파싱 가능하면 병합/덮어쓰기/취소 3지선다 제시
+ */
+export declare function handleFromExistingInteractive(scanResult: ScanResult, configPath: string, alreadyExists: boolean, existingConfig: Record<string, unknown> | null): Promise<ToolResult<InitResult>>;
+//# sourceMappingURL=init-interactive.d.ts.map

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

@@ -0,0 +1,143 @@
+/**
+ * init 대화형 모드 — Layer 3 (Adapter)
+ *
+ * readline 기반 대화형 질문 수집 로직을 담당한다.
+ * TTY 환경에서만 동작하며, stdin/pipe 모드와 완전히 분리된 관심사이다.
+ *
+ * - handleInteractive: 기본 대화형 초기화
+ * - handleFromExistingInteractive: 스캔 결과 확인 후 대화형 초기화
+ * - collectAnswers: 질문 세트 순서 실행
+ * - askWithDefault / askNullable: readline 헬퍼
+ *
+ * @module
+ */
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { fail } from '../../../types/index.js';
+import { CONFIG_FILENAME } from '../../../config/schema.js';
+import { isValidRegex } from '../../../core/resolvers/config-validator.js';
+import { CYAN, YELLOW, DIM, RESET, BOLD } from '../output.js';
+import { DEFAULT_COMMANDS_PATH, DEFAULT_ROADMAP_PATH, DEFAULT_PLAN_DIR, DEFAULT_RESULT_DIR, DEFAULT_ID_PATTERN, DEFAULT_COMMAND_SECTION, buildAnswersFromScan, buildAndWriteConfig, printScanResults, } from './init-helpers.js';
+/**
+ * 대화형 모드 — readline으로 질문을 수집하고 설정 파일을 생성한다
+ */
+export async function handleInteractive(configPath, alreadyExists) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        console.log('');
+        console.log(`${BOLD}📝 vibe-commander 프로젝트 초기화${RESET}`);
+        console.log(`${DIM}   각 질문에 Enter를 누르면 [기본값]이 적용됩니다.${RESET}`);
+        console.log('');
+        if (alreadyExists) {
+            const confirm = await rl.question(`${YELLOW}⚠️  이미 ${CONFIG_FILENAME}이 존재합니다. 덮어쓰시겠습니까? (y/N): ${RESET}`);
+            if (confirm.trim().toLowerCase() !== 'y') {
+                rl.close();
+                return fail('INIT_CANCELLED', '초기화가 취소되었습니다');
+            }
+            console.log('');
+        }
+        const answers = await collectAnswers(rl);
+        rl.close();
+        return buildAndWriteConfig(answers, configPath, alreadyExists);
+    }
+    catch {
+        rl.close();
+        return fail('INIT_CANCELLED', '초기화가 취소되었습니다 (사용자 중단)');
+    }
+}
+/**
+ * --from-existing 대화형 모드 — 스캔 결과를 보여주고 사용자 확인 후 설정 생성
+ *
+ * 기존 config가 파싱 가능하면 병합/덮어쓰기/취소 3지선다 제시
+ */
+export async function handleFromExistingInteractive(scanResult, configPath, alreadyExists, existingConfig) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        console.log('');
+        console.log(`${BOLD}📝 vibe-commander 프로젝트 스캔${RESET}`);
+        console.log('');
+        printScanResults(scanResult);
+        if (alreadyExists && existingConfig) {
+            console.log(`${YELLOW}⚠️  기존 ${CONFIG_FILENAME}이 존재합니다.${RESET}`);
+            console.log(`  ${CYAN}1${RESET}) 병합 (권장) — 기존 커스텀 설정 보존 + 스캔 결과 반영`);
+            console.log(`  ${CYAN}2${RESET}) 덮어쓰기 — 기존 설정을 완전히 대체`);
+            console.log(`  ${CYAN}3${RESET}) 취소`);
+            console.log('');
+            const choice = await rl.question(`${CYAN}? 선택 (1/2/3) [1]: ${RESET}`);
+            const trimmed = choice.trim();
+            if (trimmed === '3') {
+                rl.close();
+                return fail('INIT_CANCELLED', '초기화가 취소되었습니다');
+            }
+            const answers = buildAnswersFromScan(scanResult);
+            rl.close();
+            if (trimmed === '2') {
+                return buildAndWriteConfig(answers, configPath, alreadyExists, scanResult);
+            }
+            return buildAndWriteConfig(answers, configPath, alreadyExists, scanResult, existingConfig);
+        }
+        if (alreadyExists) {
+            const overwrite = await rl.question(`${YELLOW}⚠️  이미 ${CONFIG_FILENAME}이 존재합니다. 덮어쓰시겠습니까? (y/N): ${RESET}`);
+            if (overwrite.trim().toLowerCase() !== 'y') {
+                rl.close();
+                return fail('INIT_CANCELLED', '초기화가 취소되었습니다');
+            }
+            console.log('');
+        }
+        const confirm = await rl.question(`${CYAN}? 감지된 패턴으로 설정을 생성할까요? (Y/n): ${RESET}`);
+        rl.close();
+        if (confirm.trim().toLowerCase() === 'n') {
+            return fail('INIT_CANCELLED', '초기화가 취소되었습니다');
+        }
+        const answers = buildAnswersFromScan(scanResult);
+        return buildAndWriteConfig(answers, configPath, alreadyExists, scanResult);
+    }
+    catch {
+        rl.close();
+        return fail('INIT_CANCELLED', '초기화가 취소되었습니다 (사용자 중단)');
+    }
+}
+/**
+ * 대화형 질문 세트를 순서대로 실행한다
+ */
+async function collectAnswers(rl) {
+    const commandsPath = await askWithDefault(rl, '커맨드 파일 경로', DEFAULT_COMMANDS_PATH);
+    const roadmapPath = await askNullable(rl, '로드맵 파일 경로 (없으면 Enter)', DEFAULT_ROADMAP_PATH);
+    const planDir = await askWithDefault(rl, '계획서 디렉토리', DEFAULT_PLAN_DIR);
+    const resultDir = await askWithDefault(rl, '결과 보고서 디렉토리', DEFAULT_RESULT_DIR);
+    const runbookDir = await askNullable(rl, '런북 디렉토리 (없으면 Enter)', '');
+    const idPattern = await askWithDefault(rl, '유닛 ID 패턴 (정규식)', DEFAULT_ID_PATTERN);
+    const validPattern = isValidRegex(idPattern);
+    if (!validPattern) {
+        console.log(`${YELLOW}⚠️  유효하지 않은 정규식입니다. 기본값을 사용합니다.${RESET}`);
+    }
+    const commandSection = await askWithDefault(rl, '커맨드 파일 섹션 헤더', DEFAULT_COMMAND_SECTION);
+    return {
+        commandsPath,
+        roadmapPath,
+        planDir,
+        resultDir,
+        runbookDir,
+        idPattern: validPattern ? idPattern : DEFAULT_ID_PATTERN,
+        commandSection,
+    };
+}
+/**
+ * 기본값이 있는 질문 프롬프트
+ */
+async function askWithDefault(rl, prompt, defaultValue) {
+    const answer = await rl.question(`${CYAN}? ${prompt}${RESET} ${DIM}[${defaultValue}]${RESET}: `);
+    return answer.trim() || defaultValue;
+}
+/**
+ * null 가능한 질문 프롬프트 (빈 입력 → null)
+ */
+async function askNullable(rl, prompt, defaultValue) {
+    const display = defaultValue ? ` ${DIM}[${defaultValue}]${RESET}` : '';
+    const answer = await rl.question(`${CYAN}? ${prompt}${RESET}${display}: `);
+    const trimmed = answer.trim();
+    if (trimmed === '')
+        return defaultValue || null;
+    return trimmed;
+}
+//# sourceMappingURL=init-interactive.js.map