vibe-commander 0.1.0

package/dist/core/parsers/title-extractor.js

@@ -0,0 +1,101 @@
+/**
+ * 제목 추출기 — Layer 1 순수 함수
+ *
+ * 계획서 마크다운에서 제목을 추출한다.
+ * `titleSource` 설정에 따라 H1 헤더 또는 YAML frontmatter에서 가져온다.
+ *
+ * PRD §8.1 계획서 파싱:
+ *   titleSource: "h1" → 첫 번째 H1 라인에서 추출
+ *   titleSource: "frontmatter:title" → YAML frontmatter의 title 필드
+ *
+ * @module
+ */
+import { ok } from '../../types/index.js';
+import { FRONTMATTER_RE, normalizeLineEndings } from './md-utils.js';
+/**
+ * 계획서에서 제목을 추출한다
+ *
+ * `titleSource` 설정값에 따라 추출 전략을 선택:
+ * - `"h1"`: 첫 번째 H1 헤더에서 추출
+ * - `"frontmatter:필드명"`: YAML frontmatter의 해당 필드에서 추출
+ *
+ * 못 찾으면 `undefined`를 포함한 성공 결과 반환 (에러가 아닌 부분 실패 — Graceful Degradation).
+ *
+ * @param content - 계획서 마크다운 전체 내용
+ * @param titleSource - 제목 추출 소스 설정 ("h1" | "frontmatter:title" 등)
+ * @returns 제목 문자열(또는 undefined)을 포함한 ToolResult
+ *
+ * @example
+ * ```typescript
+ * const result = extractTitle('# U-005: 제목 추출기\n\n본문', 'h1');
+ * if (result.success) {
+ *   // result.data → 'U-005: 제목 추출기'
+ * }
+ * ```
+ */
+export function extractTitle(content, titleSource) {
+    const normalized = normalizeLineEndings(content);
+    if (titleSource === 'h1') {
+        return ok(extractH1Title(normalized));
+    }
+    if (titleSource.startsWith('frontmatter:')) {
+        const field = titleSource.slice('frontmatter:'.length);
+        return ok(extractFrontmatterField(normalized, field));
+    }
+    // 알 수 없는 소스 — undefined 반환 (Graceful Degradation)
+    return ok(undefined);
+}
+// ── 내부 헬퍼 ──
+/**
+ * 첫 번째 H1 헤더에서 제목을 추출한다
+ *
+ * 멀티라인 모드(`m` 플래그)로 `# ` 시작 라인을 탐색.
+ * H2 이상(## )은 무시하며, `#` 뒤 공백 필수.
+ *
+ * @param content - 마크다운 내용
+ * @returns H1 제목 또는 undefined
+ */
+function extractH1Title(content) {
+    const match = content.match(/^#\s+(.+)$/m);
+    return match?.[1]?.trim() ?? undefined;
+}
+/**
+ * YAML frontmatter에서 특정 필드 값을 추출한다
+ *
+ * YAML 라이브러리 없이 `key: value` 라인 기반으로 파싱.
+ * 따옴표(`"`, `'`)로 감싼 값은 따옴표를 제거하여 반환.
+ * 멀티라인 YAML 값은 지원하지 않음 (단일 라인만).
+ *
+ * @param content - 마크다운 내용 (frontmatter 포함)
+ * @param field - 추출할 필드명 (예: "title")
+ * @returns 필드 값 또는 undefined
+ */
+function extractFrontmatterField(content, field) {
+    // frontmatter는 문서 시작 ---로 시작하고 ---로 끝남
+    const fmMatch = content.match(FRONTMATTER_RE);
+    if (!fmMatch?.[1])
+        return undefined;
+    const fmContent = fmMatch[1];
+    const lines = fmContent.split('\n');
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (trimmedLine === '' || trimmedLine.startsWith('#'))
+            continue;
+        // key: value 패턴 매칭 (첫 번째 콜론 기준으로 분리)
+        const kvMatch = trimmedLine.match(/^([^:]+):\s*(.+)$/);
+        if (!kvMatch?.[1] || !kvMatch[2])
+            continue;
+        const key = kvMatch[1].trim();
+        if (key !== field)
+            continue;
+        let value = kvMatch[2].trim();
+        // 따옴표 제거
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        return value || undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=title-extractor.js.map

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

@@ -0,0 +1,15 @@
+/**
+ * Core 렌더러 — 공개 API barrel export
+ *
+ * 커맨드 파일 섹션 렌더링/업데이트 함수의 진입점.
+ *
+ * @module
+ */
+export { toShortId, toBareId, toSlug, buildTemplateVars, interpolatePattern, } from './interpolate.js';
+export { extractTitleOnly, buildSectionVars, interpolateTemplate } from './template-engine.js';
+export { renderSection } from './section-renderer.js';
+export { updateSection, updateField } from './section-updater.js';
+export type { UpdateResult, MarkerOptions } from './section-updater.js';
+export { createBeginMarker, createEndMarker, findMarkerRange, isValidSectionKey, wrapWithMarkers, stripMarkers, } from './marker-utils.js';
+export type { MarkerRange } from './marker-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/renderers/index.js

@@ -0,0 +1,18 @@
+/**
+ * Core 렌더러 — 공개 API barrel export
+ *
+ * 커맨드 파일 섹션 렌더링/업데이트 함수의 진입점.
+ *
+ * @module
+ */
+// 템플릿 보간
+export { toShortId, toBareId, toSlug, buildTemplateVars, interpolatePattern, } from './interpolate.js';
+// 템플릿 엔진
+export { extractTitleOnly, buildSectionVars, interpolateTemplate } from './template-engine.js';
+// 섹션 렌더링
+export { renderSection } from './section-renderer.js';
+// 섹션 업데이트
+export { updateSection, updateField } from './section-updater.js';
+// 마커 유틸리티
+export { createBeginMarker, createEndMarker, findMarkerRange, isValidSectionKey, wrapWithMarkers, stripMarkers, } from './marker-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/core/renderers/interpolate.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 템플릿 변수 보간 유틸리티 — Layer 1 순수 함수
+ *
+ * 유닛 ID에서 다양한 형태의 식별자를 추출하고,
+ * {{변수}} 플레이스홀더를 치환하는 기능 제공.
+ *
+ * PRD §8.2 문서 탐색 변수:
+ *   {{unitId}}  — 원본 ID ("U-117[Mmp]")
+ *   {{shortId}} — phase 제거 ("U-117")
+ *   {{bareId}}  — 숫자만 ("117")
+ *   {{slug}}    — kebab-case ("u-117-mmp")
+ *
+ * @module
+ */
+/**
+ * 유닛 ID에서 phase 태그를 제거한다
+ *
+ * 대괄호([...])로 둘러싸인 phase 정보를 ID 끝에서 제거.
+ * phase 태그가 없으면 원본 그대로 반환.
+ *
+ * @param unitId - 원본 유닛 ID
+ * @returns phase 제거된 유닛 ID
+ *
+ * @example
+ * ```typescript
+ * toShortId('U-118[Mmp]')  // → 'U-118'
+ * toShortId('RU-010-S3')   // → 'RU-010-S3' (변화 없음)
+ * ```
+ */
+export declare function toShortId(unitId: string): string;
+/**
+ * 유닛 ID에서 첫 번째 숫자 시퀀스만 추출한다
+ *
+ * prefix와 phase를 제거하고 순수 숫자 부분만 반환.
+ * 숫자가 없으면 shortId 그대로 반환 (Graceful Degradation).
+ *
+ * @param unitId - 원본 유닛 ID
+ * @returns 숫자 문자열
+ *
+ * @example
+ * ```typescript
+ * toBareId('U-118[Mmp]')   // → '118'
+ * toBareId('RU-010-S3')    // → '010'
+ * toBareId('CP-MMP-03')    // → '03'
+ * ```
+ */
+export declare function toBareId(unitId: string): string;
+/**
+ * 유닛 ID를 kebab-case 슬러그로 변환한다
+ *
+ * 대괄호/특수문자를 하이픈으로 치환하고 소문자로 변환.
+ *
+ * @param unitId - 원본 유닛 ID
+ * @returns kebab-case 슬러그
+ *
+ * @example
+ * ```typescript
+ * toSlug('U-118[Mmp]')   // → 'u-118-mmp'
+ * toSlug('RU-010-S3')    // → 'ru-010-s3'
+ * ```
+ */
+export declare function toSlug(unitId: string): string;
+/**
+ * 유닛 ID에서 템플릿 변수 맵을 생성한다
+ *
+ * 패턴 보간에 사용되는 4개 변수를 한 번에 생성.
+ *
+ * @param unitId - 원본 유닛 ID
+ * @returns 변수명 → 값 맵
+ */
+export declare function buildTemplateVars(unitId: string): Record<string, string>;
+/**
+ * 패턴 내 {{변수}} 플레이스홀더를 치환한다
+ *
+ * `eval()` 사용 금지 — `string.replace()` 기반 구현 (RULE-006 준수).
+ * 미등록 변수는 원본 플레이스홀더를 유지 (Graceful Degradation).
+ *
+ * @param pattern - {{변수}} 플레이스홀더가 포함된 패턴 문자열
+ * @param vars - 변수명 → 값 맵
+ * @returns 치환된 문자열
+ *
+ * @example
+ * ```typescript
+ * interpolatePattern('{{unitId}}.md', { unitId: 'U-118[Mmp]' })
+ * // → 'U-118[Mmp].md'
+ *
+ * interpolatePattern('{{shortId}}-*-runbook.md', { shortId: 'U-118' })
+ * // → 'U-118-*-runbook.md'
+ * ```
+ */
+export declare function interpolatePattern(pattern: string, vars: Record<string, string>): string;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/core/renderers/interpolate.js

@@ -0,0 +1,117 @@
+/**
+ * 템플릿 변수 보간 유틸리티 — Layer 1 순수 함수
+ *
+ * 유닛 ID에서 다양한 형태의 식별자를 추출하고,
+ * {{변수}} 플레이스홀더를 치환하는 기능 제공.
+ *
+ * PRD §8.2 문서 탐색 변수:
+ *   {{unitId}}  — 원본 ID ("U-117[Mmp]")
+ *   {{shortId}} — phase 제거 ("U-117")
+ *   {{bareId}}  — 숫자만 ("117")
+ *   {{slug}}    — kebab-case ("u-117-mmp")
+ *
+ * @module
+ */
+/**
+ * 유닛 ID에서 phase 태그를 제거한다
+ *
+ * 대괄호([...])로 둘러싸인 phase 정보를 ID 끝에서 제거.
+ * phase 태그가 없으면 원본 그대로 반환.
+ *
+ * @param unitId - 원본 유닛 ID
+ * @returns phase 제거된 유닛 ID
+ *
+ * @example
+ * ```typescript
+ * toShortId('U-118[Mmp]')  // → 'U-118'
+ * toShortId('RU-010-S3')   // → 'RU-010-S3' (변화 없음)
+ * ```
+ */
+export function toShortId(unitId) {
+    return unitId.replace(/\[.*?\]$/, '');
+}
+/**
+ * 유닛 ID에서 첫 번째 숫자 시퀀스만 추출한다
+ *
+ * prefix와 phase를 제거하고 순수 숫자 부분만 반환.
+ * 숫자가 없으면 shortId 그대로 반환 (Graceful Degradation).
+ *
+ * @param unitId - 원본 유닛 ID
+ * @returns 숫자 문자열
+ *
+ * @example
+ * ```typescript
+ * toBareId('U-118[Mmp]')   // → '118'
+ * toBareId('RU-010-S3')    // → '010'
+ * toBareId('CP-MMP-03')    // → '03'
+ * ```
+ */
+export function toBareId(unitId) {
+    const short = toShortId(unitId);
+    const match = short.match(/\d+/);
+    return match !== null ? match[0] : short;
+}
+/**
+ * 유닛 ID를 kebab-case 슬러그로 변환한다
+ *
+ * 대괄호/특수문자를 하이픈으로 치환하고 소문자로 변환.
+ *
+ * @param unitId - 원본 유닛 ID
+ * @returns kebab-case 슬러그
+ *
+ * @example
+ * ```typescript
+ * toSlug('U-118[Mmp]')   // → 'u-118-mmp'
+ * toSlug('RU-010-S3')    // → 'ru-010-s3'
+ * ```
+ */
+export function toSlug(unitId) {
+    return unitId
+        .replace(/[[\](){}]/g, '-')
+        .replace(/[^a-zA-Z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .toLowerCase();
+}
+/**
+ * 유닛 ID에서 템플릿 변수 맵을 생성한다
+ *
+ * 패턴 보간에 사용되는 4개 변수를 한 번에 생성.
+ *
+ * @param unitId - 원본 유닛 ID
+ * @returns 변수명 → 값 맵
+ */
+export function buildTemplateVars(unitId) {
+    return {
+        unitId,
+        shortId: toShortId(unitId),
+        bareId: toBareId(unitId),
+        slug: toSlug(unitId),
+    };
+}
+/**
+ * 패턴 내 {{변수}} 플레이스홀더를 치환한다
+ *
+ * `eval()` 사용 금지 — `string.replace()` 기반 구현 (RULE-006 준수).
+ * 미등록 변수는 원본 플레이스홀더를 유지 (Graceful Degradation).
+ *
+ * @param pattern - {{변수}} 플레이스홀더가 포함된 패턴 문자열
+ * @param vars - 변수명 → 값 맵
+ * @returns 치환된 문자열
+ *
+ * @example
+ * ```typescript
+ * interpolatePattern('{{unitId}}.md', { unitId: 'U-118[Mmp]' })
+ * // → 'U-118[Mmp].md'
+ *
+ * interpolatePattern('{{shortId}}-*-runbook.md', { shortId: 'U-118' })
+ * // → 'U-118-*-runbook.md'
+ * ```
+ */
+export function interpolatePattern(pattern, vars) {
+    return pattern.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+        const value = vars[key];
+        return value !== undefined ? value : match;
+    });
+}
+//# sourceMappingURL=interpolate.js.map

package/dist/core/renderers/marker-utils.d.ts

@@ -0,0 +1,60 @@
+/**
+ * HTML 주석 마커 유틸리티 — Layer 1 순수 함수
+ *
+ * 커맨드 파일 섹션 경계를 안전하게 식별하기 위한
+ * `<!-- vc:begin:{key} -->` / `<!-- vc:end:{key} -->` 마커를 생성/탐색한다.
+ *
+ * sectionKey는 unitType.key 값(예: "implement", "refactor")을 사용하며,
+ * 영문 소문자 + 숫자 + 하이픈만 허용한다.
+ *
+ * @module
+ */
+/** 마커 범위 (라인 인덱스 기반, inclusive) */
+export interface MarkerRange {
+    /** begin 마커의 라인 인덱스 */
+    start: number;
+    /** end 마커의 라인 인덱스 */
+    end: number;
+}
+/**
+ * sectionKey가 유효한지 검증한다
+ *
+ * 허용: 영문 소문자로 시작, 소문자+숫자+하이픈 조합
+ */
+export declare function isValidSectionKey(key: string): boolean;
+/**
+ * begin 마커 문자열을 생성한다
+ *
+ * @example createBeginMarker('implement') → '<!-- vc:begin:implement -->'
+ */
+export declare function createBeginMarker(sectionKey: string): string;
+/**
+ * end 마커 문자열을 생성한다
+ *
+ * @example createEndMarker('implement') → '<!-- vc:end:implement -->'
+ */
+export declare function createEndMarker(sectionKey: string): string;
+/**
+ * 라인 배열에서 지정된 sectionKey의 마커 범위를 찾는다
+ *
+ * begin 마커를 먼저 찾고, 이후 나타나는 첫 번째 end 마커를 매칭한다.
+ * 마커가 없거나 begin만 있고 end가 없으면 null을 반환한다.
+ *
+ * @param lines - 파일 콘텐츠를 줄 단위로 분할한 배열
+ * @param sectionKey - 탐색할 섹션 키 (예: "implement")
+ * @returns 마커 범위 (라인 인덱스) 또는 null
+ */
+export declare function findMarkerRange(lines: readonly string[], sectionKey: string): MarkerRange | null;
+/**
+ * 내부 콘텐츠 라인들을 마커로 래핑한다
+ *
+ * @param sectionKey - 섹션 키
+ * @param innerLines - 마커로 감쌀 라인 배열
+ * @returns 마커를 포함한 라인 배열
+ */
+export declare function wrapWithMarkers(sectionKey: string, innerLines: readonly string[]): string[];
+/**
+ * 콘텐츠에서 모든 마커 라인을 제거한다 (테스트/디버그용)
+ */
+export declare function stripMarkers(content: string): string;
+//# sourceMappingURL=marker-utils.d.ts.map

package/dist/core/renderers/marker-utils.js

@@ -0,0 +1,85 @@
+/**
+ * HTML 주석 마커 유틸리티 — Layer 1 순수 함수
+ *
+ * 커맨드 파일 섹션 경계를 안전하게 식별하기 위한
+ * `<!-- vc:begin:{key} -->` / `<!-- vc:end:{key} -->` 마커를 생성/탐색한다.
+ *
+ * sectionKey는 unitType.key 값(예: "implement", "refactor")을 사용하며,
+ * 영문 소문자 + 숫자 + 하이픈만 허용한다.
+ *
+ * @module
+ */
+import { stripCR } from '../parsers/md-utils.js';
+/** sectionKey 허용 패턴: 영문 소문자 시작, 소문자+숫자+하이픈 */
+const SECTION_KEY_RE = /^[a-z][a-z0-9-]*$/;
+/** 마커 라인 매칭 정규식 */
+const MARKER_LINE_RE = /^<!--\s*vc:(begin|end):([a-z][a-z0-9-]*)\s*-->$/;
+/**
+ * sectionKey가 유효한지 검증한다
+ *
+ * 허용: 영문 소문자로 시작, 소문자+숫자+하이픈 조합
+ */
+export function isValidSectionKey(key) {
+    return SECTION_KEY_RE.test(key);
+}
+/**
+ * begin 마커 문자열을 생성한다
+ *
+ * @example createBeginMarker('implement') → '<!-- vc:begin:implement -->'
+ */
+export function createBeginMarker(sectionKey) {
+    return `<!-- vc:begin:${sectionKey} -->`;
+}
+/**
+ * end 마커 문자열을 생성한다
+ *
+ * @example createEndMarker('implement') → '<!-- vc:end:implement -->'
+ */
+export function createEndMarker(sectionKey) {
+    return `<!-- vc:end:${sectionKey} -->`;
+}
+/**
+ * 라인 배열에서 지정된 sectionKey의 마커 범위를 찾는다
+ *
+ * begin 마커를 먼저 찾고, 이후 나타나는 첫 번째 end 마커를 매칭한다.
+ * 마커가 없거나 begin만 있고 end가 없으면 null을 반환한다.
+ *
+ * @param lines - 파일 콘텐츠를 줄 단위로 분할한 배열
+ * @param sectionKey - 탐색할 섹션 키 (예: "implement")
+ * @returns 마커 범위 (라인 인덱스) 또는 null
+ */
+export function findMarkerRange(lines, sectionKey) {
+    const beginMarker = createBeginMarker(sectionKey);
+    const endMarker = createEndMarker(sectionKey);
+    let startIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = stripCR(lines[i] ?? '').trim();
+        if (trimmed === beginMarker && startIdx === -1) {
+            startIdx = i;
+        }
+        else if (trimmed === endMarker && startIdx !== -1) {
+            return { start: startIdx, end: i };
+        }
+    }
+    return null;
+}
+/**
+ * 내부 콘텐츠 라인들을 마커로 래핑한다
+ *
+ * @param sectionKey - 섹션 키
+ * @param innerLines - 마커로 감쌀 라인 배열
+ * @returns 마커를 포함한 라인 배열
+ */
+export function wrapWithMarkers(sectionKey, innerLines) {
+    return [createBeginMarker(sectionKey), ...innerLines, createEndMarker(sectionKey)];
+}
+/**
+ * 콘텐츠에서 모든 마커 라인을 제거한다 (테스트/디버그용)
+ */
+export function stripMarkers(content) {
+    return content
+        .split('\n')
+        .filter((line) => !MARKER_LINE_RE.test(stripCR(line).trim()))
+        .join('\n');
+}
+//# sourceMappingURL=marker-utils.js.map

package/dist/core/renderers/section-renderer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 커맨드 파일 섹션 렌더러 — Layer 1 순수 함수
+ *
+ * CommandContext와 UnitTypeConfig를 받아
+ * 커맨드 파일에 삽입할 섹션 본문을 생성한다.
+ *
+ * 렌더링 결과는 separator를 포함하지 않으며,
+ * 섹션 헤더(예: "# 유닛 구현")도 포함하지 않는다.
+ *
+ * 형식 레퍼런스: vibe/commands.md
+ *
+ * @module
+ */
+import type { CommandContext, UnitTypeConfig } from '../../types/index.js';
+/**
+ * 커맨드 파일 섹션을 렌더링한다
+ *
+ * 렌더링 순서:
+ * 1. headerTemplate 보간 → 헤더 블록
+ * 2. 의존 유닛 목록 (collectDeps=true일 때)
+ * 3. 의존성 문서 경로 (collectDeps=true일 때)
+ * 4. 의존성 커밋 SHA (collectDeps=true일 때)
+ * 5. 특별 요청사항 (항상)
+ *
+ * @param context - 렌더링할 전체 컨텍스트 (유닛 메타 + 의존성 + 특별 요청)
+ * @param unitTypeConfig - 유닛 유형 설정 (headerTemplate, collectDeps 등)
+ * @param docPrefix - 문서 경로 앞에 붙일 프리픽스 (기본: "@")
+ * @returns 렌더링된 섹션 본문 문자열
+ */
+export declare function renderSection(context: CommandContext, unitTypeConfig: UnitTypeConfig, docPrefix?: string): string;
+//# sourceMappingURL=section-renderer.d.ts.map

package/dist/core/renderers/section-renderer.js

@@ -0,0 +1,171 @@
+/**
+ * 커맨드 파일 섹션 렌더러 — Layer 1 순수 함수
+ *
+ * CommandContext와 UnitTypeConfig를 받아
+ * 커맨드 파일에 삽입할 섹션 본문을 생성한다.
+ *
+ * 렌더링 결과는 separator를 포함하지 않으며,
+ * 섹션 헤더(예: "# 유닛 구현")도 포함하지 않는다.
+ *
+ * 형식 레퍼런스: vibe/commands.md
+ *
+ * @module
+ */
+import { interpolateTemplate } from './template-engine.js';
+/** 문서 경로 앞에 붙일 기본 프리픽스 */
+const DEFAULT_DOC_PREFIX = '@';
+/** 빈 항목 표시 마커 */
+const EMPTY_MARKER = '-';
+/**
+ * 커맨드 파일 섹션을 렌더링한다
+ *
+ * 렌더링 순서:
+ * 1. headerTemplate 보간 → 헤더 블록
+ * 2. 의존 유닛 목록 (collectDeps=true일 때)
+ * 3. 의존성 문서 경로 (collectDeps=true일 때)
+ * 4. 의존성 커밋 SHA (collectDeps=true일 때)
+ * 5. 특별 요청사항 (항상)
+ *
+ * @param context - 렌더링할 전체 컨텍스트 (유닛 메타 + 의존성 + 특별 요청)
+ * @param unitTypeConfig - 유닛 유형 설정 (headerTemplate, collectDeps 등)
+ * @param docPrefix - 문서 경로 앞에 붙일 프리픽스 (기본: "@")
+ * @returns 렌더링된 섹션 본문 문자열
+ */
+export function renderSection(context, unitTypeConfig, docPrefix = DEFAULT_DOC_PREFIX) {
+    const lines = [];
+    // 1. Header block (headerTemplate 변수 보간)
+    const header = interpolateTemplate(unitTypeConfig.headerTemplate, context.unit);
+    lines.push(header);
+    // 2. 의존성 섹션 (collectDeps=true일 때만)
+    if (unitTypeConfig.collectDeps) {
+        renderDepUnits(lines, context);
+        renderDepDocs(lines, context, docPrefix);
+        renderDepCommits(lines, context);
+    }
+    // 3. 특별 요청사항 (항상 렌더링)
+    renderSpecialRequests(lines, context);
+    return lines.join('\n');
+}
+/**
+ * 의존 유닛 목록과 비유닛 컨텍스트 항목을 렌더링한다
+ *
+ * 유닛 항목: `- **{unitId}**: {description}`
+ * 비유닛 항목: `- {description}` (볼드 유닛 ID 없이)
+ */
+function renderDepUnits(lines, context) {
+    lines.push('');
+    lines.push('### 의존 유닛 및 기능:');
+    const contextNotes = context.unit.contextNotes ?? [];
+    const hasContent = context.unit.depends.length > 0 || contextNotes.length > 0;
+    if (hasContent) {
+        for (const dep of context.unit.depends) {
+            lines.push(`- **${dep.unitId}**: ${dep.description}`);
+        }
+        for (const note of contextNotes) {
+            lines.push(`- ${note}`);
+        }
+    }
+    else {
+        lines.push(EMPTY_MARKER);
+    }
+}
+/**
+ * 의존성 문서 경로를 렌더링한다
+ *
+ * 형식: `- @{path}` (docPrefix 제어 가능)
+ */
+function renderDepDocs(lines, context, docPrefix) {
+    lines.push('');
+    lines.push('### 의존성 문서:');
+    const allDocs = context.depDocs.flatMap((d) => d.found);
+    if (allDocs.length > 0) {
+        for (const doc of allDocs) {
+            lines.push(`- ${docPrefix}${doc.path}`);
+        }
+    }
+    else {
+        lines.push(EMPTY_MARKER);
+    }
+}
+/**
+ * 의존성 커밋 SHA를 렌더링한다
+ *
+ * 형식: `- {sha}`
+ */
+function renderDepCommits(lines, context) {
+    lines.push('');
+    lines.push('### 의존성 Commits:');
+    if (context.depCommits.length > 0) {
+        for (const sha of context.depCommits) {
+            lines.push(`- ${sha}`);
+        }
+    }
+    else {
+        lines.push(EMPTY_MARKER);
+    }
+}
+/**
+ * 특별 요청사항을 렌더링한다
+ *
+ * 형식: `- {request}`
+ *
+ * 페어링 질문 확인 항목("페어링 질문의 결정을 확인합니다")이 있을 때,
+ * 모든 미결정 질문이 답변되었으면 자동으로 ✅를 추가한다.
+ * 답변된 페어링 질문은 특별 요청사항 뒤에 체크리스트 형태로 렌더링.
+ */
+function renderSpecialRequests(lines, context) {
+    lines.push('');
+    lines.push('### 특별 요청사항');
+    const allAnswered = areAllQuestionsAnswered(context);
+    if (context.specialRequests.length > 0) {
+        for (const req of context.specialRequests) {
+            if (allAnswered && isPairingConfirmItem(req) && !req.includes('✅')) {
+                lines.push(`- ${req}✅`);
+            }
+            else {
+                lines.push(`- ${req}`);
+            }
+        }
+    }
+    else {
+        lines.push(EMPTY_MARKER);
+    }
+    renderPairingAnswers(lines, context);
+}
+/** "페어링 질문의 결정을 확인합니다" 항목인지 판별 */
+function isPairingConfirmItem(text) {
+    return text.includes('페어링 질문의 결정을 확인합니다');
+}
+/**
+ * 모든 미결정 페어링 질문이 답변되었는지 확인
+ *
+ * 미결정 질문이 0개이면 false (확인할 필요 없음),
+ * pairingAnswers 수가 미결정 질문 수 이상이면 true.
+ */
+function areAllQuestionsAnswered(context) {
+    const unresolvedCount = context.pairingQuestions.filter((q) => !q.resolved).length;
+    if (unresolvedCount === 0)
+        return false;
+    const answerCount = context.pairingAnswers?.length ?? 0;
+    return answerCount >= unresolvedCount;
+}
+/**
+ * 페어링 질문과 답변을 렌더링한다
+ *
+ * 미결정 질문: `- [ ] **Q1**: 질문`
+ * 답변된 질문: `- [x] **Q1**: 질문 → **답변: {선택/입력값}**`
+ */
+function renderPairingAnswers(lines, context) {
+    const unresolvedQuestions = context.pairingQuestions.filter((q) => !q.resolved);
+    if (unresolvedQuestions.length === 0)
+        return;
+    const answers = context.pairingAnswers ?? [];
+    for (const question of unresolvedQuestions) {
+        const answer = answers.find((a) => a.questionId === question.id);
+        if (answer) {
+            const answerText = answer.selectedOption ?? answer.freeText ?? '';
+            lines.push(`- [x] **${question.id}**: ${question.text} → **답변: ${answerText}**`);
+        }
+    }
+}
+//# sourceMappingURL=section-renderer.js.map