vibe-commander 0.1.0

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

@@ -0,0 +1,72 @@
+/**
+ * 커맨드 파일 섹션 교체기 — Layer 1 순수 함수
+ *
+ * 커맨드 파일의 특정 섹션만 교체하고 나머지를 보존한다.
+ * separator(구분선) + 동급 헤딩 기반으로 섹션 범위를 안전하게 결정한다.
+ *
+ * HTML 주석 마커(`<!-- vc:begin:{key} -->` / `<!-- vc:end:{key} -->`)가
+ * 활성화되면 마커 기반 경계 탐색을 우선 시도하고, 미발견 시 기존
+ * 헤더 기반 Fallback으로 처리한다 (점진적 마이그레이션 지원).
+ *
+ * RULE-007 준수: 전체 파일 덮어쓰기 금지, 대상 섹션만 교체.
+ *
+ * 형식 레퍼런스: vibe/commands.md
+ * PRD §8.3: 커맨드 파일 섹션 교체 규칙
+ *
+ * @module
+ */
+import type { ToolResult } from '../../types/index.js';
+/**
+ * 섹션/필드 업데이트 결과
+ *
+ * 업데이트 성공 여부를 `updated` 필드로 판별.
+ * 섹션/필드 미발견 시 원본 반환 + `updated: false` (에러 아님).
+ */
+export interface UpdateResult {
+    /** 업데이트된 전체 콘텐츠 */
+    content: string;
+    /** 실제로 교체가 이루어졌는지 여부 */
+    updated: boolean;
+}
+/** 마커 옵션. sectionKey를 전달하면 마커 기반 탐색/삽입이 활성화된다. */
+export interface MarkerOptions {
+    /** 섹션 키 (unitType.key 값, 예: "implement", "refactor") */
+    sectionKey: string;
+}
+/**
+ * 커맨드 파일의 특정 섹션 본문을 교체한다
+ *
+ * **Fallback 체인** (markerOptions 제공 시):
+ * 1. 1차 시도: 마커 기반 경계 탐색 (`<!-- vc:begin:{key} -->` ~ `<!-- vc:end:{key} -->`)
+ * 2. 2차 시도: 기존 헤더 + separator 기반 텍스트 탐색 (마커 자동 삽입으로 점진적 마이그레이션)
+ * 3. 둘 다 실패: 원본 반환 + `updated: false`
+ *
+ * markerOptions 미제공 시: 기존 헤더 기반 탐색 (마커 없음)
+ *
+ * @param content - 전체 파일 콘텐츠
+ * @param sectionHeader - 대상 섹션 헤더 (예: "# 유닛 구현")
+ * @param newBody - 교체할 새 본문
+ * @param separator - 섹션 구분자 문자열
+ * @param markerOptions - 마커 옵션 (선택). 제공 시 마커 기반 탐색/삽입 활성화
+ * @returns 교체된 콘텐츠와 교체 여부
+ */
+export declare function updateSection(content: string, sectionHeader: string, newBody: string, separator: string, markerOptions?: MarkerOptions): ToolResult<UpdateResult>;
+/**
+ * 커맨드 파일의 특정 섹션 내 필드 값만 교체한다
+ *
+ * 섹션 범위 내에서 fieldPattern에 매칭되는 첫 번째 라인을 찾고,
+ * 해당 라인의 값 부분(마지막 ": " 이후)을 교체 또는 추가한다.
+ *
+ * 마커가 존재하면 마커 범위 내에서 필드를 탐색한다.
+ *
+ * @param content - 전체 파일 콘텐츠
+ * @param sectionHeader - 대상 섹션 헤더
+ * @param fieldPattern - 필드를 식별하는 정규식
+ * @param newValue - 새 값
+ * @param separator - 섹션 구분자 문자열
+ * @param mode - "replace" 또는 "append"
+ * @param markerOptions - 마커 옵션 (선택)
+ * @returns 필드가 교체된 콘텐츠와 교체 여부
+ */
+export declare function updateField(content: string, sectionHeader: string, fieldPattern: RegExp, newValue: string, separator: string, mode?: 'replace' | 'append', markerOptions?: MarkerOptions): ToolResult<UpdateResult>;
+//# sourceMappingURL=section-updater.d.ts.map

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

@@ -0,0 +1,175 @@
+/**
+ * 커맨드 파일 섹션 교체기 — Layer 1 순수 함수
+ *
+ * 커맨드 파일의 특정 섹션만 교체하고 나머지를 보존한다.
+ * separator(구분선) + 동급 헤딩 기반으로 섹션 범위를 안전하게 결정한다.
+ *
+ * HTML 주석 마커(`<!-- vc:begin:{key} -->` / `<!-- vc:end:{key} -->`)가
+ * 활성화되면 마커 기반 경계 탐색을 우선 시도하고, 미발견 시 기존
+ * 헤더 기반 Fallback으로 처리한다 (점진적 마이그레이션 지원).
+ *
+ * RULE-007 준수: 전체 파일 덮어쓰기 금지, 대상 섹션만 교체.
+ *
+ * 형식 레퍼런스: vibe/commands.md
+ * PRD §8.3: 커맨드 파일 섹션 교체 규칙
+ *
+ * @module
+ */
+import { ok } from '../../types/index.js';
+import { normalizeLineEndings, getHeadingPrefix, isSameLevelHeading } from '../parsers/index.js';
+import { findHeaderIndex, getBodyStartIndex, findBodyEndIndex, replaceFieldValue, isSeparatorLine, } from './updater-helpers.js';
+import { findMarkerRange, wrapWithMarkers, createBeginMarker, createEndMarker, } from './marker-utils.js';
+/**
+ * 커맨드 파일의 특정 섹션 본문을 교체한다
+ *
+ * **Fallback 체인** (markerOptions 제공 시):
+ * 1. 1차 시도: 마커 기반 경계 탐색 (`<!-- vc:begin:{key} -->` ~ `<!-- vc:end:{key} -->`)
+ * 2. 2차 시도: 기존 헤더 + separator 기반 텍스트 탐색 (마커 자동 삽입으로 점진적 마이그레이션)
+ * 3. 둘 다 실패: 원본 반환 + `updated: false`
+ *
+ * markerOptions 미제공 시: 기존 헤더 기반 탐색 (마커 없음)
+ *
+ * @param content - 전체 파일 콘텐츠
+ * @param sectionHeader - 대상 섹션 헤더 (예: "# 유닛 구현")
+ * @param newBody - 교체할 새 본문
+ * @param separator - 섹션 구분자 문자열
+ * @param markerOptions - 마커 옵션 (선택). 제공 시 마커 기반 탐색/삽입 활성화
+ * @returns 교체된 콘텐츠와 교체 여부
+ */
+export function updateSection(content, sectionHeader, newBody, separator, markerOptions) {
+    const normalized = normalizeLineEndings(content);
+    const lines = normalized.split('\n');
+    const newBodyLines = newBody.split('\n');
+    // 마커 옵션이 제공된 경우: Fallback 체인
+    if (markerOptions) {
+        const { sectionKey } = markerOptions;
+        // 1차: 마커 기반 탐색
+        const markerRange = findMarkerRange(lines, sectionKey);
+        if (markerRange) {
+            return replaceMarkerRange(lines, markerRange, sectionHeader, newBodyLines, separator, sectionKey);
+        }
+        // 2차: 헤더 기반 Fallback + 마커 자동 삽입 (점진적 마이그레이션)
+        return fallbackWithMarkerInjection(lines, content, sectionHeader, newBodyLines, separator, sectionKey);
+    }
+    // 마커 비활성: 기존 헤더 기반 탐색
+    return headerBasedUpdate(lines, content, sectionHeader, newBodyLines, separator);
+}
+/**
+ * 커맨드 파일의 특정 섹션 내 필드 값만 교체한다
+ *
+ * 섹션 범위 내에서 fieldPattern에 매칭되는 첫 번째 라인을 찾고,
+ * 해당 라인의 값 부분(마지막 ": " 이후)을 교체 또는 추가한다.
+ *
+ * 마커가 존재하면 마커 범위 내에서 필드를 탐색한다.
+ *
+ * @param content - 전체 파일 콘텐츠
+ * @param sectionHeader - 대상 섹션 헤더
+ * @param fieldPattern - 필드를 식별하는 정규식
+ * @param newValue - 새 값
+ * @param separator - 섹션 구분자 문자열
+ * @param mode - "replace" 또는 "append"
+ * @param markerOptions - 마커 옵션 (선택)
+ * @returns 필드가 교체된 콘텐츠와 교체 여부
+ */
+export function updateField(content, sectionHeader, fieldPattern, newValue, separator, mode = 'replace', markerOptions) {
+    const normalized = normalizeLineEndings(content);
+    const lines = normalized.split('\n');
+    // 마커 옵션이 있으면 마커 범위 내에서 탐색 시도
+    if (markerOptions) {
+        const markerRange = findMarkerRange(lines, markerOptions.sectionKey);
+        if (markerRange) {
+            return replaceFieldInRange(lines, content, fieldPattern, newValue, mode, markerRange.start, markerRange.end + 1);
+        }
+    }
+    // 기존 헤더 기반 필드 탐색
+    const headerIdx = findHeaderIndex(lines, sectionHeader);
+    if (headerIdx === -1) {
+        return ok({ content, updated: false });
+    }
+    const headingPrefix = getHeadingPrefix(sectionHeader);
+    const bodyStartIdx = getBodyStartIndex(lines, headerIdx, separator);
+    const bodyEndIdx = findBodyEndIndex(lines, bodyStartIdx, separator, headingPrefix, isSameLevelHeading);
+    return replaceFieldInRange(lines, content, fieldPattern, newValue, mode, bodyStartIdx, bodyEndIdx);
+}
+// ── 내부 헬퍼 ──
+/**
+ * 마커 범위를 새 콘텐츠로 교체한다 (마커 포함 전체 대체)
+ */
+function replaceMarkerRange(lines, markerRange, sectionHeader, newBodyLines, separator, sectionKey) {
+    const before = lines.slice(0, markerRange.start);
+    const after = lines.slice(markerRange.end + 1);
+    const innerLines = [sectionHeader.trim(), separator, ...newBodyLines, separator];
+    const markerWrapped = wrapWithMarkers(sectionKey, innerLines);
+    const result = [...before, ...markerWrapped, ...after].join('\n');
+    return ok({ content: result, updated: true });
+}
+/**
+ * 헤더 기반 Fallback으로 섹션을 찾고, 마커를 자동 삽입한다 (점진적 마이그레이션)
+ */
+function fallbackWithMarkerInjection(lines, originalContent, sectionHeader, newBodyLines, separator, sectionKey) {
+    const headerIdx = findHeaderIndex(lines, sectionHeader);
+    if (headerIdx === -1) {
+        return ok({ content: originalContent, updated: false });
+    }
+    const headingPrefix = getHeadingPrefix(sectionHeader);
+    const bodyStartIdx = getBodyStartIndex(lines, headerIdx, separator);
+    const bodyEndIdx = findBodyEndIndex(lines, bodyStartIdx, separator, headingPrefix, isSameLevelHeading);
+    const closingLine = bodyEndIdx < lines.length ? lines[bodyEndIdx] : undefined;
+    const closingIsSep = closingLine !== undefined && isSeparatorLine(closingLine, separator);
+    // 고아 마커 제거 (begin만 또는 end만 남은 경우)
+    const beginMarker = createBeginMarker(sectionKey);
+    const endMarker = createEndMarker(sectionKey);
+    const isOrphanedMarker = (line) => {
+        const trimmed = line.trim();
+        return trimmed === beginMarker || trimmed === endMarker;
+    };
+    const beforeSection = lines.slice(0, headerIdx).filter((l) => !isOrphanedMarker(l));
+    const afterSection = (closingIsSep ? lines.slice(bodyEndIdx + 1) : lines.slice(bodyEndIdx)).filter((l) => !isOrphanedMarker(l));
+    const innerLines = [
+        (lines[headerIdx] ?? sectionHeader).trim(),
+        separator,
+        ...newBodyLines,
+        ...(closingIsSep ? [separator] : []),
+    ];
+    const markerWrapped = wrapWithMarkers(sectionKey, innerLines);
+    const result = [...beforeSection, ...markerWrapped, ...afterSection].join('\n');
+    return ok({ content: result, updated: true });
+}
+/**
+ * 기존 헤더 기반 섹션 교체 (마커 없음, 기존 동작 유지)
+ */
+function headerBasedUpdate(lines, originalContent, sectionHeader, newBodyLines, separator) {
+    const headerIdx = findHeaderIndex(lines, sectionHeader);
+    if (headerIdx === -1) {
+        return ok({ content: originalContent, updated: false });
+    }
+    const headingPrefix = getHeadingPrefix(sectionHeader);
+    const bodyStartIdx = getBodyStartIndex(lines, headerIdx, separator);
+    const bodyEndIdx = findBodyEndIndex(lines, bodyStartIdx, separator, headingPrefix, isSameLevelHeading);
+    const before = lines.slice(0, bodyStartIdx);
+    const after = lines.slice(bodyEndIdx);
+    const result = [...before, ...newBodyLines, ...after].join('\n');
+    return ok({ content: result, updated: true });
+}
+/**
+ * 지정된 범위 내에서 필드를 찾아 값을 교체한다
+ */
+function replaceFieldInRange(lines, originalContent, fieldPattern, newValue, mode, rangeStart, rangeEnd) {
+    let fieldFound = false;
+    for (let i = rangeStart; i < rangeEnd; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            break;
+        fieldPattern.lastIndex = 0;
+        if (fieldPattern.test(line)) {
+            lines[i] = replaceFieldValue(line, newValue, mode);
+            fieldFound = true;
+            break;
+        }
+    }
+    if (!fieldFound) {
+        return ok({ content: originalContent, updated: false });
+    }
+    return ok({ content: lines.join('\n'), updated: true });
+}
+//# sourceMappingURL=section-updater.js.map

package/dist/core/renderers/template-engine.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 템플릿 엔진 — Layer 1 순수 함수
+ *
+ * UnitMeta에서 PRD 부록 B 전체 템플릿 변수(8개)를 생성하고,
+ * headerTemplate에 변수를 보간하는 기능을 제공한다.
+ *
+ * 기존 interpolate.ts의 ID 기반 변수(unitId, shortId, bareId, slug)에
+ * 계획서 메타데이터 변수(title, titleOnly, planPath, phase)를 추가.
+ *
+ * @module
+ */
+import type { UnitMeta } from '../../types/index.js';
+/**
+ * 유닛 제목에서 ID 부분을 제거하고 순수 제목만 추출한다
+ *
+ * 일반적인 제목 형식: "U-010[Mvp]: 템플릿 렌더러 (renderSection)"
+ * → titleOnly: "템플릿 렌더러 (renderSection)"
+ *
+ * 리팩토링 서브 유닛 형식: "[ID: RU-003-Q5] VERSION 상수 제거"
+ * → titleOnly: "VERSION 상수 제거"
+ *
+ * 콜론이 없으면 전체 제목을 그대로 반환 (Graceful Degradation).
+ *
+ * @param title - 유닛 전체 제목 (ID 포함)
+ * @returns ID를 제거한 순수 제목
+ */
+export declare function extractTitleOnly(title: string): string;
+/**
+ * UnitMeta에서 PRD 부록 B 전체 템플릿 변수 맵을 생성한다
+ *
+ * | 변수 | 설명 | 예시 |
+ * |------|------|------|
+ * | unitId | 원본 유닛 ID | U-118[Mmp] |
+ * | shortId | phase 제거 | U-118 |
+ * | bareId | 숫자만 | 118 |
+ * | slug | kebab-case | u-118-mmp |
+ * | title | 전체 제목 | U-118[Mmp]: 이미지 링크 삽입 |
+ * | titleOnly | 순수 제목 | 이미지 링크 삽입 |
+ * | planPath | 계획서 경로 | vibe/unit-plans/U-118[Mmp].md |
+ * | phase | phase 문자열 | Mmp |
+ *
+ * @param unit - 유닛 메타데이터
+ * @returns 변수명 → 값 맵 (8개 항목)
+ */
+export declare function buildSectionVars(unit: UnitMeta): Record<string, string>;
+/**
+ * headerTemplate에 UnitMeta 변수를 보간한다
+ *
+ * eval() 사용 금지 (RULE-006 준수).
+ * 미등록 변수는 원본 플레이스홀더를 유지 (Graceful Degradation).
+ *
+ * @param template - {{변수}} 플레이스홀더가 포함된 템플릿 문자열
+ * @param unit - 유닛 메타데이터
+ * @returns 변수가 치환된 문자열
+ *
+ * @example
+ * ```typescript
+ * const unit: UnitMeta = {
+ *   unitId: 'U-010[Mvp]',
+ *   title: 'U-010[Mvp]: 템플릿 렌더러',
+ *   planPath: 'vibe/unit-plans/U-010[Mvp].md',
+ *   // ...
+ * };
+ * interpolateTemplate('### {{title}}\n- 계획서: @{{planPath}}', unit);
+ * // → '### U-010[Mvp]: 템플릿 렌더러\n- 계획서: @vibe/unit-plans/U-010[Mvp].md'
+ * ```
+ */
+export declare function interpolateTemplate(template: string, unit: UnitMeta): string;
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/core/renderers/template-engine.js

@@ -0,0 +1,92 @@
+/**
+ * 템플릿 엔진 — Layer 1 순수 함수
+ *
+ * UnitMeta에서 PRD 부록 B 전체 템플릿 변수(8개)를 생성하고,
+ * headerTemplate에 변수를 보간하는 기능을 제공한다.
+ *
+ * 기존 interpolate.ts의 ID 기반 변수(unitId, shortId, bareId, slug)에
+ * 계획서 메타데이터 변수(title, titleOnly, planPath, phase)를 추가.
+ *
+ * @module
+ */
+import { buildTemplateVars, interpolatePattern } from './interpolate.js';
+/**
+ * 유닛 제목에서 ID 부분을 제거하고 순수 제목만 추출한다
+ *
+ * 일반적인 제목 형식: "U-010[Mvp]: 템플릿 렌더러 (renderSection)"
+ * → titleOnly: "템플릿 렌더러 (renderSection)"
+ *
+ * 리팩토링 서브 유닛 형식: "[ID: RU-003-Q5] VERSION 상수 제거"
+ * → titleOnly: "VERSION 상수 제거"
+ *
+ * 콜론이 없으면 전체 제목을 그대로 반환 (Graceful Degradation).
+ *
+ * @param title - 유닛 전체 제목 (ID 포함)
+ * @returns ID를 제거한 순수 제목
+ */
+export function extractTitleOnly(title) {
+    // 1. [ID: ...] 패턴으로 시작하면 해당 부분을 통째로 제거
+    const idPrefixMatch = title.match(/^\[ID:\s*[^\]]+\]\s*:?\s*/i);
+    if (idPrefixMatch) {
+        return title.substring(idPrefixMatch[0].length).trim();
+    }
+    // 2. 일반적인 "ID: 제목" 패턴 처리
+    const colonIndex = title.indexOf(': ');
+    if (colonIndex === -1)
+        return title;
+    return title.substring(colonIndex + 2).trim();
+}
+/**
+ * UnitMeta에서 PRD 부록 B 전체 템플릿 변수 맵을 생성한다
+ *
+ * | 변수 | 설명 | 예시 |
+ * |------|------|------|
+ * | unitId | 원본 유닛 ID | U-118[Mmp] |
+ * | shortId | phase 제거 | U-118 |
+ * | bareId | 숫자만 | 118 |
+ * | slug | kebab-case | u-118-mmp |
+ * | title | 전체 제목 | U-118[Mmp]: 이미지 링크 삽입 |
+ * | titleOnly | 순수 제목 | 이미지 링크 삽입 |
+ * | planPath | 계획서 경로 | vibe/unit-plans/U-118[Mmp].md |
+ * | phase | phase 문자열 | Mmp |
+ *
+ * @param unit - 유닛 메타데이터
+ * @returns 변수명 → 값 맵 (8개 항목)
+ */
+export function buildSectionVars(unit) {
+    const baseVars = buildTemplateVars(unit.unitId);
+    return {
+        ...baseVars,
+        title: unit.title,
+        titleOnly: extractTitleOnly(unit.title),
+        planPath: unit.planPath,
+        phase: unit.phase ?? '',
+    };
+}
+/**
+ * headerTemplate에 UnitMeta 변수를 보간한다
+ *
+ * eval() 사용 금지 (RULE-006 준수).
+ * 미등록 변수는 원본 플레이스홀더를 유지 (Graceful Degradation).
+ *
+ * @param template - {{변수}} 플레이스홀더가 포함된 템플릿 문자열
+ * @param unit - 유닛 메타데이터
+ * @returns 변수가 치환된 문자열
+ *
+ * @example
+ * ```typescript
+ * const unit: UnitMeta = {
+ *   unitId: 'U-010[Mvp]',
+ *   title: 'U-010[Mvp]: 템플릿 렌더러',
+ *   planPath: 'vibe/unit-plans/U-010[Mvp].md',
+ *   // ...
+ * };
+ * interpolateTemplate('### {{title}}\n- 계획서: @{{planPath}}', unit);
+ * // → '### U-010[Mvp]: 템플릿 렌더러\n- 계획서: @vibe/unit-plans/U-010[Mvp].md'
+ * ```
+ */
+export function interpolateTemplate(template, unit) {
+    const vars = buildSectionVars(unit);
+    return interpolatePattern(template, vars);
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/core/renderers/updater-helpers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 섹션 업데이트용 내부 헬퍼 함수 — Layer 1 순수 함수
+ *
+ * @module
+ */
+/**
+ * 라인이 separator인지 확인한다
+ *
+ * 앞뒤 공백 및 Windows \r을 무시하고 비교.
+ */
+export declare function isSeparatorLine(line: string, separator: string): boolean;
+/**
+ * 섹션 헤더 라인의 인덱스를 찾는다
+ *
+ * @returns 헤더 인덱스 또는 -1 (미발견)
+ */
+export declare function findHeaderIndex(lines: readonly string[], sectionHeader: string): number;
+/**
+ * 섹션 본문의 시작 인덱스를 결정한다
+ *
+ * 헤더 다음 줄이 separator이면 그 다음 줄(본문 첫 줄),
+ * separator가 아니면 헤더 바로 다음 줄이 본문 시작.
+ */
+export declare function getBodyStartIndex(lines: readonly string[], headerIdx: number, separator: string): number;
+/**
+ * 섹션 본문의 끝 인덱스를 찾는다 (exclusive)
+ *
+ * 탐색 순서:
+ * 1. separator 라인 → 섹션 경계
+ * 2. 동급 헤딩 → 다른 섹션 시작
+ * 3. EOF → 마지막 섹션
+ *
+ * @param isSameLevelHeading - 외부에서 주입받는 헤딩 비교 함수
+ */
+export declare function findBodyEndIndex(lines: readonly string[], bodyStartIdx: number, separator: string, headingPrefix: string | null, isSameLevelHeading: (line: string, prefix: string | null) => boolean): number;
+/**
+ * 필드 라인의 값 부분(": " 이후)을 교체 또는 추가한다
+ *
+ * @param line - 원본 필드 라인
+ * @param newValue - 새 값
+ * @param mode - "replace": 값 전체 교체, "append": 기존 값에 추가
+ * @returns 값이 교체된 라인
+ */
+export declare function replaceFieldValue(line: string, newValue: string, mode: 'replace' | 'append'): string;
+//# sourceMappingURL=updater-helpers.d.ts.map

package/dist/core/renderers/updater-helpers.js

@@ -0,0 +1,83 @@
+/**
+ * 섹션 업데이트용 내부 헬퍼 함수 — Layer 1 순수 함수
+ *
+ * @module
+ */
+import { stripCR } from '../parsers/md-utils.js';
+/**
+ * 라인이 separator인지 확인한다
+ *
+ * 앞뒤 공백 및 Windows \r을 무시하고 비교.
+ */
+export function isSeparatorLine(line, separator) {
+    return stripCR(line).trim() === separator.trim();
+}
+/**
+ * 섹션 헤더 라인의 인덱스를 찾는다
+ *
+ * @returns 헤더 인덱스 또는 -1 (미발견)
+ */
+export function findHeaderIndex(lines, sectionHeader) {
+    const needle = sectionHeader.trim();
+    return lines.findIndex((l) => stripCR(l).trim() === needle);
+}
+/**
+ * 섹션 본문의 시작 인덱스를 결정한다
+ *
+ * 헤더 다음 줄이 separator이면 그 다음 줄(본문 첫 줄),
+ * separator가 아니면 헤더 바로 다음 줄이 본문 시작.
+ */
+export function getBodyStartIndex(lines, headerIdx, separator) {
+    const nextIdx = headerIdx + 1;
+    const nextLine = lines[nextIdx];
+    if (nextLine !== undefined && isSeparatorLine(nextLine, separator)) {
+        return nextIdx + 1;
+    }
+    return nextIdx;
+}
+/**
+ * 섹션 본문의 끝 인덱스를 찾는다 (exclusive)
+ *
+ * 탐색 순서:
+ * 1. separator 라인 → 섹션 경계
+ * 2. 동급 헤딩 → 다른 섹션 시작
+ * 3. EOF → 마지막 섹션
+ *
+ * @param isSameLevelHeading - 외부에서 주입받는 헤딩 비교 함수
+ */
+export function findBodyEndIndex(lines, bodyStartIdx, separator, headingPrefix, isSameLevelHeading) {
+    for (let i = bodyStartIdx; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            break;
+        if (isSeparatorLine(line, separator))
+            return i;
+        if (isSameLevelHeading(line, headingPrefix))
+            return i;
+    }
+    return lines.length;
+}
+/**
+ * 필드 라인의 값 부분(": " 이후)을 교체 또는 추가한다
+ *
+ * @param line - 원본 필드 라인
+ * @param newValue - 새 값
+ * @param mode - "replace": 값 전체 교체, "append": 기존 값에 추가
+ * @returns 값이 교체된 라인
+ */
+export function replaceFieldValue(line, newValue, mode) {
+    const colonIdx = line.lastIndexOf(': ');
+    if (colonIdx === -1)
+        return line;
+    const prefix = line.substring(0, colonIdx + 2);
+    const currentValue = stripCR(line.substring(colonIdx + 2)).trim();
+    if (mode === 'replace') {
+        return prefix + newValue;
+    }
+    // append 모드: 현재 값이 빈 마커('-')이거나 비어있으면 교체, 아니면 콤마 구분 추가
+    if (currentValue === '-' || currentValue === '') {
+        return prefix + newValue;
+    }
+    return prefix + currentValue + ', ' + newValue;
+}
+//# sourceMappingURL=updater-helpers.js.map

package/dist/core/resolvers/commit-filter.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 커밋 교차 검증 필터 — Layer 1 순수 함수
+ *
+ * `git diff-tree`로 수집된 변경 파일 목록을 기반으로,
+ * excludePaths/requirePaths glob 패턴에 따라 커밋을 필터링한다.
+ *
+ * **순수 함수**: child_process, fs 등 I/O 모듈을 사용하지 않음.
+ * 변경 파일 수집은 Adapter(Layer 3)의 책임이며,
+ * 이 함수는 이미 수집된 목록을 받아 필터링만 담당한다.
+ *
+ * **Q2 결정 (Option C — 독립 적용)**:
+ * excludePaths와 requirePaths를 독립 필터로 순차 적용.
+ * - excludePaths 필터: 변경 파일이 모두 exclude 패턴에 매칭되면 제거 (문서 전용 커밋)
+ * - requirePaths 필터: 변경 파일 중 require 패턴에 하나도 매칭 안 되면 제거
+ * - 두 필터가 모두 빈 배열이면 기존 동작 유지
+ *
+ * @module
+ */
+/**
+ * 변경 파일 목록을 포함한 커밋 정보
+ */
+export interface CommitWithFiles {
+    /** 커밋 SHA */
+    sha: string;
+    /** 변경된 파일 경로 목록 (프로젝트 루트 기준 상대 경로) */
+    changedFiles: string[];
+}
+/**
+ * 필터 옵션
+ */
+export interface CommitFilterOptions {
+    /**
+     * 제외할 경로 glob 패턴 목록.
+     * 변경 파일이 **모두** 이 패턴에 매칭되는 커밋은 필터링됨.
+     */
+    excludePaths?: string[];
+    /**
+     * 필수 포함 경로 glob 패턴 목록.
+     * 변경 파일 중 **하나라도** 이 패턴에 매칭되어야 통과.
+     */
+    requirePaths?: string[];
+}
+/**
+ * 변경 파일 목록을 기반으로 커밋을 필터링한다
+ *
+ * excludePaths와 requirePaths를 독립 필터로 순차 적용 (Option C).
+ * 두 필터가 모두 빈 배열이면 모든 커밋 통과 (Graceful Degradation).
+ *
+ * @param commits - 변경 파일 목록이 포함된 커밋 배열
+ * @param options - 필터 옵션 (excludePaths, requirePaths)
+ * @returns 필터를 통과한 커밋 배열
+ *
+ * @example
+ * ```typescript
+ * const commits = [
+ *   { sha: 'abc1234', changedFiles: ['src/core/parser.ts', 'vibe/unit-plans/U-001.md'] },
+ *   { sha: 'def5678', changedFiles: ['vibe/unit-plans/U-001.md'] },
+ * ];
+ * const filtered = filterCommitsByChangedFiles(commits, {
+ *   excludePaths: ['vibe/**'],
+ * });
+ * // filtered → [{ sha: 'abc1234', changedFiles: [...] }]
+ * // def5678 제거: 변경 파일이 모두 vibe/** 패턴에 매칭됨
+ * ```
+ */
+export declare function filterCommitsByChangedFiles(commits: CommitWithFiles[], options?: CommitFilterOptions): CommitWithFiles[];
+/**
+ * 파일 경로가 glob 패턴에 매칭되는지 검사한다
+ *
+ * 지원하는 와일드카드:
+ * - `**` — 모든 경로 세그먼트 매칭 (슬래시 포함)
+ * - `*`  — 단일 경로 세그먼트 매칭 (슬래시 미포함)
+ *
+ * 예시:
+ * - `src/**` → `src/core/foo.ts` ✅, `docs/foo.ts` ❌
+ * - `**\/*.md` → `vibe/unit-plans/U-001.md` ✅, `src/core/foo.ts` ❌
+ * - `src/*.ts` → `src/foo.ts` ✅, `src/core/foo.ts` ❌
+ *
+ * @param filePath - 검사할 파일 경로 (프로젝트 루트 기준 상대 경로)
+ * @param pattern - glob 패턴
+ * @returns 매칭 여부
+ */
+export declare function matchesGlobPattern(filePath: string, pattern: string): boolean;
+//# sourceMappingURL=commit-filter.d.ts.map