vibe-commander 0.1.0

package/dist/core/resolvers/dep-doc-resolver.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 의존성 문서 경로 해석기 — Layer 1 순수 함수
+ *
+ * 의존 유닛 ID 목록과 문서 탐색 설정을 받아,
+ * 각 유닛별·역할별 **문서 경로 패턴**을 생성한다.
+ *
+ * 실제 파일 존재 확인은 수행하지 않음 — Adapter(Layer 3)에서 처리.
+ * glob 패턴이면 와일드카드 포함된 패턴 문자열을 반환하고,
+ * 비-glob이면 정확한 상대 경로를 반환한다.
+ *
+ * PRD §8.2 문서 탐색 (docDiscovery):
+ *   pattern에서 사용 가능한 변수: {{unitId}}, {{shortId}}, {{bareId}}, {{slug}}
+ *   glob: true이면 와일드카드(*) 포함 패턴
+ *
+ * @module
+ */
+import type { DocLocationEntry, ToolResult } from '../../types/index.js';
+/**
+ * 의존 유닛별 문서 위치 패턴 모음
+ *
+ * resolveDepDocs의 출력 단위. 한 의존 유닛에 대한
+ * 모든 역할(plan, result, runbook 등)의 경로 패턴을 포함.
+ */
+export interface DepDocPattern {
+    /** 의존 유닛 ID */
+    unitId: string;
+    /** 역할별 문서 위치 패턴 목록 */
+    locations: DocLocationEntry[];
+}
+/**
+ * 의존 유닛별 문서 경로 패턴을 생성한다
+ *
+ * 각 depId에 대해 docRoots의 모든 역할을 순회하고,
+ * docDiscovery 패턴에 템플릿 변수를 보간하여 경로 패턴을 생성한다.
+ *
+ * **순수 함수**: 파일시스템 접근 없이 문자열 연산만 수행.
+ * 실제 파일 존재 확인은 Adapter(Layer 3)의 책임.
+ *
+ * docDiscovery에 정의되지 않은 역할(docRoots에만 있는 역할)은
+ * 기본 패턴 `{{unitId}}.md`로 처리한다.
+ *
+ * @param depIds - 의존 유닛 ID 목록
+ * @param docRoots - 역할별 문서 루트 디렉토리 (예: { plan: "vibe/unit-plans" })
+ * @param docDiscovery - 역할별 파일 탐색 규칙 (예: { plan: { pattern: "{{unitId}}.md" } })
+ * @returns 의존 유닛별 문서 위치 패턴 목록을 포함한 ToolResult
+ *
+ * @example
+ * ```typescript
+ * const depIds = ['U-005[Mvp]'];
+ * const docRoots = { plan: 'vibe/unit-plans', result: 'vibe/unit-results' };
+ * const docDiscovery = {
+ *   plan: { pattern: '{{unitId}}.md', glob: false },
+ *   result: { pattern: '{{unitId}}.md', glob: false },
+ * };
+ * const result = resolveDepDocs(depIds, docRoots, docDiscovery);
+ * if (result.success) {
+ *   // result.data[0].locations →
+ *   //   [{ role: 'plan', dir: 'vibe/unit-plans', filePattern: 'U-005[Mvp].md',
+ *   //      fullPattern: 'vibe/unit-plans/U-005[Mvp].md', glob: false },
+ *   //    { role: 'result', dir: 'vibe/unit-results', filePattern: 'U-005[Mvp].md',
+ *   //      fullPattern: 'vibe/unit-results/U-005[Mvp].md', glob: false }]
+ *   // }
+ * }
+ * ```
+ */
+export declare function resolveDepDocs(depIds: string[], docRoots: Record<string, string>, docDiscovery: Record<string, {
+    pattern: string;
+    glob?: boolean;
+}>): ToolResult<DepDocPattern[]>;
+//# sourceMappingURL=dep-doc-resolver.d.ts.map

package/dist/core/resolvers/dep-doc-resolver.js

@@ -0,0 +1,84 @@
+/**
+ * 의존성 문서 경로 해석기 — Layer 1 순수 함수
+ *
+ * 의존 유닛 ID 목록과 문서 탐색 설정을 받아,
+ * 각 유닛별·역할별 **문서 경로 패턴**을 생성한다.
+ *
+ * 실제 파일 존재 확인은 수행하지 않음 — Adapter(Layer 3)에서 처리.
+ * glob 패턴이면 와일드카드 포함된 패턴 문자열을 반환하고,
+ * 비-glob이면 정확한 상대 경로를 반환한다.
+ *
+ * PRD §8.2 문서 탐색 (docDiscovery):
+ *   pattern에서 사용 가능한 변수: {{unitId}}, {{shortId}}, {{bareId}}, {{slug}}
+ *   glob: true이면 와일드카드(*) 포함 패턴
+ *
+ * @module
+ */
+import { ok } from '../../types/index.js';
+import { buildTemplateVars, interpolatePattern } from '../renderers/interpolate.js';
+/**
+ * 의존 유닛별 문서 경로 패턴을 생성한다
+ *
+ * 각 depId에 대해 docRoots의 모든 역할을 순회하고,
+ * docDiscovery 패턴에 템플릿 변수를 보간하여 경로 패턴을 생성한다.
+ *
+ * **순수 함수**: 파일시스템 접근 없이 문자열 연산만 수행.
+ * 실제 파일 존재 확인은 Adapter(Layer 3)의 책임.
+ *
+ * docDiscovery에 정의되지 않은 역할(docRoots에만 있는 역할)은
+ * 기본 패턴 `{{unitId}}.md`로 처리한다.
+ *
+ * @param depIds - 의존 유닛 ID 목록
+ * @param docRoots - 역할별 문서 루트 디렉토리 (예: { plan: "vibe/unit-plans" })
+ * @param docDiscovery - 역할별 파일 탐색 규칙 (예: { plan: { pattern: "{{unitId}}.md" } })
+ * @returns 의존 유닛별 문서 위치 패턴 목록을 포함한 ToolResult
+ *
+ * @example
+ * ```typescript
+ * const depIds = ['U-005[Mvp]'];
+ * const docRoots = { plan: 'vibe/unit-plans', result: 'vibe/unit-results' };
+ * const docDiscovery = {
+ *   plan: { pattern: '{{unitId}}.md', glob: false },
+ *   result: { pattern: '{{unitId}}.md', glob: false },
+ * };
+ * const result = resolveDepDocs(depIds, docRoots, docDiscovery);
+ * if (result.success) {
+ *   // result.data[0].locations →
+ *   //   [{ role: 'plan', dir: 'vibe/unit-plans', filePattern: 'U-005[Mvp].md',
+ *   //      fullPattern: 'vibe/unit-plans/U-005[Mvp].md', glob: false },
+ *   //    { role: 'result', dir: 'vibe/unit-results', filePattern: 'U-005[Mvp].md',
+ *   //      fullPattern: 'vibe/unit-results/U-005[Mvp].md', glob: false }]
+ *   // }
+ * }
+ * ```
+ */
+export function resolveDepDocs(depIds, docRoots, docDiscovery) {
+    const results = [];
+    for (const depId of depIds) {
+        const vars = buildTemplateVars(depId);
+        const locations = [];
+        // docRoots의 모든 역할을 순회
+        for (const role of Object.keys(docRoots)) {
+            const dir = docRoots[role];
+            if (dir === undefined)
+                continue;
+            // docDiscovery에서 해당 역할의 규칙 조회 (없으면 기본 패턴)
+            const rule = docDiscovery[role];
+            const pattern = rule?.pattern ?? '{{unitId}}.md';
+            const isGlob = rule?.glob ?? false;
+            // 템플릿 변수 보간
+            const filePattern = interpolatePattern(pattern, vars);
+            const fullPattern = `${dir}/${filePattern}`;
+            locations.push({
+                role,
+                dir,
+                filePattern,
+                fullPattern,
+                glob: isGlob,
+            });
+        }
+        results.push({ unitId: depId, locations });
+    }
+    return ok(results);
+}
+//# sourceMappingURL=dep-doc-resolver.js.map

package/dist/core/resolvers/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core 해석기 — 공개 API barrel export
+ *
+ * 의존 유닛 문서/커밋 해석 함수의 진입점.
+ *
+ * @module
+ */
+export { resolveDepDocs } from './dep-doc-resolver.js';
+export type { DepDocPattern } from './dep-doc-resolver.js';
+export { findDepCommits } from './dep-commit-resolver.js';
+export type { CommitEntry } from './dep-commit-resolver.js';
+export { filterCommitsByChangedFiles, matchesGlobPattern } from './commit-filter.js';
+export type { CommitWithFiles, CommitFilterOptions } from './commit-filter.js';
+export { mergeConfigs, isPlainObject } from './config-merger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/resolvers/index.js

@@ -0,0 +1,12 @@
+/**
+ * Core 해석기 — 공개 API barrel export
+ *
+ * 의존 유닛 문서/커밋 해석 함수의 진입점.
+ *
+ * @module
+ */
+export { resolveDepDocs } from './dep-doc-resolver.js';
+export { findDepCommits } from './dep-commit-resolver.js';
+export { filterCommitsByChangedFiles, matchesGlobPattern } from './commit-filter.js';
+export { mergeConfigs, isPlainObject } from './config-merger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * vibe-commander — 유닛 기반 바이브 코딩 워크플로우 자동화 도구
+ *
+ * 엔트리포인트 — 공유 타입 및 헬퍼 함수를 re-export합니다.
+ * @packageDocumentation
+ */
+export * from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * vibe-commander — 유닛 기반 바이브 코딩 워크플로우 자동화 도구
+ *
+ * 엔트리포인트 — 공유 타입 및 헬퍼 함수를 re-export합니다.
+ * @packageDocumentation
+ */
+export * from './types/index.js';
+//# sourceMappingURL=index.js.map

package/dist/types/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 설정 관련 타입 정의
+ *
+ * Zod 4 스키마(src/config/schema.ts)에서 추론된 타입의 re-export 허브.
+ * 런타임 검증과 컴파일 타임 타입이 단일 소스(Zod 스키마)에서 도출됩니다.
+ *
+ * @module
+ */
+export type { InferredPathsConfig as PathsConfig, InferredUnitTypeConfig as UnitTypeConfig, InferredDocDiscoveryRule as DocDiscoveryRule, InferredDocDiscoveryConfig as DocDiscoveryConfig, InferredMetadataTableConfig as MetadataTableConfig, InferredPlanParsingConfig as PlanParsingConfig, InferredStatusMapConfig as StatusMapConfig, InferredBacklogParsingConfig as BacklogParsingConfig, InferredCommitSearchConfig as CommitSearchConfig, InferredCommandSectionsConfig as CommandSectionsConfig, InferredProjectConfig as ProjectConfig, } from '../config/schema.js';
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.js

@@ -0,0 +1,10 @@
+/**
+ * 설정 관련 타입 정의
+ *
+ * Zod 4 스키마(src/config/schema.ts)에서 추론된 타입의 re-export 허브.
+ * 런타임 검증과 컴파일 타임 타입이 단일 소스(Zod 스키마)에서 도출됩니다.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/context.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 컨텍스트 관련 타입 정의
+ *
+ * 유닛 실행 컨텍스트 및 백로그 항목을 표현하는 타입.
+ * CLI의 set-unit, list-units 등 커맨드 출력에 사용.
+ *
+ * @module
+ */
+import type { DepDocs, PairingAnswer, PairingQuestion, UnitMeta } from './unit.js';
+/**
+ * 커맨드 컨텍스트
+ *
+ * 하나의 유닛에 대한 전체 컨텍스트 정보.
+ * set-unit 실행 시 수집된 모든 정보를 담는 최상위 구조체.
+ * 이 데이터를 기반으로 커맨드 파일 섹션이 렌더링됨.
+ */
+export interface CommandContext {
+    /** 유닛 메타데이터 (계획서에서 추출) */
+    unit: UnitMeta;
+    /** 의존 유닛별 문서 탐색 결과 */
+    depDocs: DepDocs[];
+    /** 의존 유닛 관련 커밋 SHA 목록 */
+    depCommits: string[];
+    /** 페어링 질문 목록 (미결정 항목 포함) */
+    pairingQuestions: PairingQuestion[];
+    /** 특별 요청사항 목록 (기본 + 유닛 유형별) */
+    specialRequests: string[];
+    /** CLI 프롬프트를 통해 수집된 페어링 질문 답변 (파싱 결과와 분리) */
+    pairingAnswers?: PairingAnswer[];
+}
+/**
+ * 백로그 항목 상태
+ *
+ * 로드맵 백로그에서 유닛의 진행 상태.
+ */
+export type BacklogStatus = 'ready' | 'inProgress' | 'completed' | 'blocked';
+/**
+ * 백로그 항목
+ *
+ * 로드맵/백로그에서 파싱한 개별 유닛 항목.
+ * list-units 커맨드의 출력 데이터 구성에 사용.
+ */
+export interface BacklogEntry {
+    /** 유닛 ID (예: "U-002[Mvp]") */
+    unitId: string;
+    /** 유닛 제목 */
+    title: string;
+    /** 의존 유닛 ID 목록 (예: ["U-001"]) */
+    depends: string[];
+    /** 현재 상태 */
+    status: BacklogStatus;
+    /** 계획서 상대 경로 */
+    path: string;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.js

@@ -0,0 +1,10 @@
+/**
+ * 컨텍스트 관련 타입 정의
+ *
+ * 유닛 실행 컨텍스트 및 백로그 항목을 표현하는 타입.
+ * CLI의 set-unit, list-units 등 커맨드 출력에 사용.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=context.js.map

package/dist/types/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * vibe-commander 공유 타입 정의
+ *
+ * 모든 레이어(Core, Config, Adapter)가 참조하는 핵심 타입을 제공합니다.
+ * 이 모듈을 통해 프로젝트 전체에서 일관된 타입 시스템을 사용합니다.
+ *
+ * @packageDocumentation
+ */
+export type { ToolResult, ToolError } from './tool-result.js';
+export { ok, fail } from './tool-result.js';
+export type { UnitMeta, DepInfo, DocEntry, DepDocs, PairingQuestion, PairingAnswer, DocLocationEntry, } from './unit.js';
+export type { ProjectConfig, PathsConfig, UnitTypeConfig, DocDiscoveryRule, DocDiscoveryConfig, MetadataTableConfig, PlanParsingConfig, StatusMapConfig, BacklogParsingConfig, CommitSearchConfig, CommandSectionsConfig, } from './config.js';
+export type { CommandContext, BacklogEntry, BacklogStatus } from './context.js';
+export type { ScanResult, InitAnswers, InitResult, DetectedPattern, DetectedDocRoot, DetectedCommandFile, } from './init.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -0,0 +1,10 @@
+/**
+ * vibe-commander 공유 타입 정의
+ *
+ * 모든 레이어(Core, Config, Adapter)가 참조하는 핵심 타입을 제공합니다.
+ * 이 모듈을 통해 프로젝트 전체에서 일관된 타입 시스템을 사용합니다.
+ *
+ * @packageDocumentation
+ */
+export { ok, fail } from './tool-result.js';
+//# sourceMappingURL=index.js.map

package/dist/types/init.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 초기화(init) 관련 타입 정의
+ *
+ * 프로젝트 스캔 결과(ScanResult) 및 사용자 답변(InitAnswers) 타입을 정의합니다.
+ * 이 타입들은 Adapter(Scanner)와 Core(Config Generator) 사이의 인터페이스 역할을 합니다.
+ *
+ * @module
+ */
+/** 프로젝트 루트 스캔 결과 전체 */
+export interface ScanResult {
+    totalMdFiles: number;
+    idPatterns: DetectedPattern[];
+    docRoots: DetectedDocRoot[];
+    commandFiles: DetectedCommandFile[];
+    roadmapCandidates: string[];
+    suggestedIdPattern: string | null;
+}
+/** 감지된 ID 패턴 정보 */
+export interface DetectedPattern {
+    prefix: string;
+    regex: string;
+    displayLabel: string;
+    matchCount: number;
+    examples: string[];
+}
+/** 감지된 문서 루트 디렉토리 */
+export interface DetectedDocRoot {
+    role: string;
+    dirPath: string;
+    fileCount: number;
+}
+/** 감지된 커맨드 파일 후보 */
+export interface DetectedCommandFile {
+    filePath: string;
+    sections: string[];
+    hasSeparator: boolean;
+    separatorSample: string | null;
+}
+/** 설정 생성을 위한 답변 데이터 */
+export interface InitAnswers {
+    commandsPath: string;
+    roadmapPath: string | null;
+    planDir: string;
+    resultDir: string;
+    runbookDir: string | null;
+    idPattern: string;
+    commandSection: string;
+}
+/** 초기화 실행 결과 */
+export interface InitResult {
+    configPath: string;
+    overwritten: boolean;
+    merged: boolean;
+    scanResult?: ScanResult;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/types/init.js

@@ -0,0 +1,10 @@
+/**
+ * 초기화(init) 관련 타입 정의
+ *
+ * 프로젝트 스캔 결과(ScanResult) 및 사용자 답변(InitAnswers) 타입을 정의합니다.
+ * 이 타입들은 Adapter(Scanner)와 Core(Config Generator) 사이의 인터페이스 역할을 합니다.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=init.js.map

package/dist/types/tool-result.d.ts

@@ -0,0 +1,75 @@
+/**
+ * ToolResult<T> — 도구 실행 결과 타입 및 헬퍼 함수
+ *
+ * 모든 공개 API의 표준 반환 타입.
+ * `success` 필드 기반 Discriminated Union으로 타입 가드 없이 안전한 분기 처리 가능.
+ *
+ * @module
+ */
+/**
+ * 구조화된 에러 정보
+ *
+ * 모든 실패 응답에 포함되는 에러 상세 정보.
+ * `code`는 프로그래밍적 처리, `message`는 사람 가독용.
+ */
+export interface ToolError {
+    /** 에러 코드 (예: "PLAN_NOT_FOUND", "CONFIG_INVALID") */
+    code: string;
+    /** 사람이 읽을 수 있는 에러 메시지 */
+    message: string;
+    /** 추가 디버깅 정보 (선택) */
+    details?: string;
+}
+/**
+ * 도구 실행 결과 (Discriminated Union)
+ *
+ * 모든 공개 API의 반환 타입. `success` 필드로 성공/실패를 구분하며,
+ * TypeScript의 제어 흐름 분석을 통해 안전한 타입 좁히기 가능.
+ *
+ * @typeParam T - 성공 시 반환 데이터 타입
+ *
+ * @example
+ * ```typescript
+ * const result = someFunction();
+ * if (result.success) {
+ *   console.log(result.data); // T 타입으로 안전하게 접근
+ * } else {
+ *   console.error(result.error.code); // ToolError 타입으로 접근
+ * }
+ * ```
+ */
+export type ToolResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: ToolError;
+};
+/**
+ * 성공 결과 생성 헬퍼
+ *
+ * @typeParam T - 성공 데이터 타입
+ * @param data - 성공 데이터
+ * @returns 성공 상태의 ToolResult
+ *
+ * @example
+ * ```typescript
+ * return ok({ unitId: 'U-002', title: '공유 타입 정의' });
+ * ```
+ */
+export declare function ok<T>(data: T): ToolResult<T>;
+/**
+ * 실패 결과 생성 헬퍼
+ *
+ * @param code - 에러 코드 (예: "PLAN_NOT_FOUND")
+ * @param message - 사람이 읽을 수 있는 에러 메시지
+ * @param details - 추가 디버깅 정보 (선택)
+ * @returns 실패 상태의 ToolResult
+ *
+ * @example
+ * ```typescript
+ * return fail('PLAN_NOT_FOUND', '계획서를 찾을 수 없음', `경로: ${planPath}`);
+ * ```
+ */
+export declare function fail(code: string, message: string, details?: string): ToolResult<never>;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/types/tool-result.js

@@ -0,0 +1,40 @@
+/**
+ * ToolResult<T> — 도구 실행 결과 타입 및 헬퍼 함수
+ *
+ * 모든 공개 API의 표준 반환 타입.
+ * `success` 필드 기반 Discriminated Union으로 타입 가드 없이 안전한 분기 처리 가능.
+ *
+ * @module
+ */
+/**
+ * 성공 결과 생성 헬퍼
+ *
+ * @typeParam T - 성공 데이터 타입
+ * @param data - 성공 데이터
+ * @returns 성공 상태의 ToolResult
+ *
+ * @example
+ * ```typescript
+ * return ok({ unitId: 'U-002', title: '공유 타입 정의' });
+ * ```
+ */
+export function ok(data) {
+    return { success: true, data };
+}
+/**
+ * 실패 결과 생성 헬퍼
+ *
+ * @param code - 에러 코드 (예: "PLAN_NOT_FOUND")
+ * @param message - 사람이 읽을 수 있는 에러 메시지
+ * @param details - 추가 디버깅 정보 (선택)
+ * @returns 실패 상태의 ToolResult
+ *
+ * @example
+ * ```typescript
+ * return fail('PLAN_NOT_FOUND', '계획서를 찾을 수 없음', `경로: ${planPath}`);
+ * ```
+ */
+export function fail(code, message, details) {
+    return { success: false, error: { code, message, details } };
+}
+//# sourceMappingURL=tool-result.js.map

package/dist/types/unit.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 유닛 관련 타입 정의
+ *
+ * 계획서 파싱, 의존성 수집, 문서 탐색 결과를 표현하는 핵심 타입.
+ * 프로젝트 구조에 독립적인 범용 타입으로, 모든 레이어에서 공유.
+ *
+ * @module
+ */
+/**
+ * 유닛 메타데이터
+ *
+ * 계획서에서 추출한 유닛의 핵심 정보.
+ * Core 파서(parseUnitPlan)의 출력 타입.
+ */
+export interface UnitMeta {
+    /** 원본 유닛 ID 문자열 (예: "U-002[Mvp]") */
+    unitId: string;
+    /** 설정의 unitTypes 키 (예: "implement", "refactor") */
+    unitType: string;
+    /** 유닛 페이즈 (예: "Mvp", "Mmp"). 없으면 undefined */
+    phase?: string;
+    /** 계획서에서 추출한 유닛 제목 */
+    title: string;
+    /** 계획서 상대 경로 (프로젝트 루트 기준) */
+    planPath: string;
+    /** 의존 유닛 목록 */
+    depends: DepInfo[];
+    /** 비유닛 컨텍스트 항목 (SKILL 참조, 기존 코드 패턴 등) */
+    contextNotes?: string[];
+}
+/**
+ * 의존 유닛 정보
+ *
+ * 계획서의 의존성 섹션에서 추출한 개별 의존 유닛 정보.
+ */
+export interface DepInfo {
+    /** 의존 유닛 ID (예: "U-001[Mvp]") */
+    unitId: string;
+    /** 의존 내용 설명 */
+    description: string;
+    /** 결과물 설명 (있으면) */
+    artifacts?: string;
+}
+/**
+ * 문서 탐색 결과 항목
+ *
+ * 파일시스템에서 발견된 개별 문서의 역할과 경로.
+ */
+export interface DocEntry {
+    /** 문서 역할 (예: "plan", "result", "runbook", 또는 커스텀) */
+    role: string;
+    /** 문서 파일 경로 (프로젝트 루트 기준 상대 경로) */
+    path: string;
+}
+/**
+ * 의존 유닛의 문서 탐색 결과
+ *
+ * 하나의 의존 유닛에 대해 발견된 모든 관련 문서 모음.
+ * Core 리졸버(resolveDepDocs)의 출력 타입.
+ */
+export interface DepDocs {
+    /** 의존 유닛 ID */
+    unitId: string;
+    /** 발견된 문서 목록 */
+    found: DocEntry[];
+}
+/**
+ * 페어링 질문
+ *
+ * 계획서에서 추출한 의사결정 필요 항목.
+ * 에이전트가 아닌 사람이 답변해야 하는 질문.
+ * resolved가 true이면 selectedOption에 선택된 옵션 정보가 포함됨.
+ */
+export interface PairingQuestion {
+    /** 질문 식별자 (예: "Q1") */
+    id: string;
+    /** 질문 본문 */
+    text: string;
+    /** 해결 여부 ([x] 체크박스 기반) */
+    resolved: boolean;
+    /** 선택된 옵션 텍스트 (해결된 경우) */
+    selectedOption?: string;
+    /** 사용 가능한 옵션 목록 (하위 리스트 항목에서 추출) */
+    options?: string[];
+}
+/**
+ * 페어링 질문 답변
+ *
+ * CLI 인터랙티브 프롬프트를 통해 사용자가 입력한 답변.
+ * 파싱 결과(PairingQuestion)와 사용자 입력을 분리하여 관리.
+ */
+export interface PairingAnswer {
+    /** 답변 대상 질문 ID (PairingQuestion.id와 매칭) */
+    questionId: string;
+    /** 옵션 선택 질문의 경우 선택된 옵션 텍스트 */
+    selectedOption?: string;
+    /** 자유 텍스트 입력의 경우 입력된 텍스트 */
+    freeText?: string;
+}
+/**
+ * 문서 위치 해석 결과
+ *
+ * 특정 역할(plan, result, runbook 등)의 문서가 위치할 경로 정보.
+ * Resolver(Layer 2)에서 생성하고 Adapter(Layer 3)에서 소비.
+ */
+export interface DocLocationEntry {
+    /** 문서 역할 (예: "plan", "result", "runbook") */
+    role: string;
+    /** 역할별 루트 디렉토리 (예: "vibe/unit-plans") */
+    dir: string;
+    /** 보간된 파일 패턴 (예: "U-118[Mmp].md") */
+    filePattern: string;
+    /** 전체 경로 패턴 (dir + "/" + filePattern) */
+    fullPattern: string;
+    /** glob 패턴 사용 여부. true이면 와일드카드 매칭 필요 */
+    glob: boolean;
+}
+//# sourceMappingURL=unit.d.ts.map

package/dist/types/unit.js

@@ -0,0 +1,10 @@
+/**
+ * 유닛 관련 타입 정의
+ *
+ * 계획서 파싱, 의존성 수집, 문서 탐색 결과를 표현하는 핵심 타입.
+ * 프로젝트 구조에 독립적인 범용 타입으로, 모든 레이어에서 공유.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=unit.js.map