vibe-commander 0.2.3 → 0.2.5

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

@@ -10,7 +10,7 @@
  * @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';
+export { DEFAULT_COMMANDS_PATH, DEFAULT_ROADMAP_PATH, DEFAULT_PLAN_DIR, DEFAULT_RESULT_DIR, DEFAULT_RUNBOOK_DIR, DEFAULT_ID_PATTERN, DEFAULT_COMMAND_SECTION, DEFAULT_HEADER_TEMPLATE, extractStdinAnswers, buildAnswersFromScan, } from '../../../core/resolvers/config-generator.js';
 /**
  * 수집된 정보로 설정 객체를 구성하고, 검증 후 파일에 쓴다
  *

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

@@ -15,7 +15,7 @@ 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';
+export { DEFAULT_COMMANDS_PATH, DEFAULT_ROADMAP_PATH, DEFAULT_PLAN_DIR, DEFAULT_RESULT_DIR, DEFAULT_RUNBOOK_DIR, DEFAULT_ID_PATTERN, DEFAULT_COMMAND_SECTION, DEFAULT_HEADER_TEMPLATE, extractStdinAnswers, buildAnswersFromScan, } from '../../../core/resolvers/config-generator.js';
 /**
  * 수집된 정보로 설정 객체를 구성하고, 검증 후 파일에 쓴다
  *

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

@@ -17,7 +17,7 @@ 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';
+import { DEFAULT_COMMANDS_PATH, DEFAULT_ROADMAP_PATH, DEFAULT_PLAN_DIR, DEFAULT_RESULT_DIR, DEFAULT_RUNBOOK_DIR, DEFAULT_ID_PATTERN, DEFAULT_COMMAND_SECTION, buildAnswersFromScan, buildAndWriteConfig, printScanResults, } from './init-helpers.js';
 /**
  * 대화형 모드 — readline으로 질문을 수집하고 설정 파일을 생성한다
  */
@@ -105,7 +105,7 @@ async function collectAnswers(rl) {
     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 runbookDir = await askNullable(rl, '런북 디렉토리 (없으면 Enter)', DEFAULT_RUNBOOK_DIR);
     const idPattern = await askWithDefault(rl, '유닛 ID 패턴 (정규식)', DEFAULT_ID_PATTERN);
     const validPattern = isValidRegex(idPattern);
     if (!validPattern) {
@@ -132,7 +132,7 @@ async function askWithDefault(rl, prompt, defaultValue) {
 /**
  * null 가능한 질문 프롬프트 (빈 입력 → null)
  */
-async function askNullable(rl, prompt, defaultValue) {
+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();

package/dist/core/parsers/dep-line-parser.js

@@ -43,12 +43,19 @@ export function parseDependencyLines(lines, idPattern) {
                     artifacts: currentArtifacts,
                 });
             }
-            // 새 dep 파싱
-            const parsed = extractDepFromLine(trimmed, idPattern);
-            if (parsed) {
-                currentUnitId = parsed.unitId;
-                currentDescription = parsed.description;
-                currentArtifacts = parsed.artifacts;
+            // 새 dep 파싱 (멀티 반환 지원)
+            const parsedList = extractDepFromLine(trimmed, idPattern);
+            if (parsedList.length > 0) {
+                // 마지막 이외 항목은 즉시 deps에 push (하위 항목은 마지막 유닛에만 연결)
+                for (let i = 0; i < parsedList.length - 1; i++) {
+                    const dep = parsedList[i];
+                    if (dep)
+                        deps.push(dep);
+                }
+                const last = parsedList[parsedList.length - 1];
+                currentUnitId = last?.unitId ?? '';
+                currentDescription = last?.description ?? '';
+                currentArtifacts = last?.artifacts;
                 hasCurrent = true;
             }
             else {
@@ -83,49 +90,86 @@ export function parseDependencyLines(lines, idPattern) {
     return { deps, contextNotes };
 }
 /**
- * 한 라인에서 의존 유닛 정보를 추출한다
+ * 한 라인에서 의존 유닛 정보를 추출한다 (멀티 반환 지원)
  *
  * 추출 우선순위:
  * 1. 링크 텍스트 `[ID](url)` — 더 구체적 (문서 링크 포함)
  * 2. 볼드 텍스트 `**ID**` — 일반적인 의존성 표기
  *
  * idPattern이 제공되면 추출된 후보를 필터링하여 실제 유닛 ID만 선별.
+ * 한 줄에 콤마로 구분된 복수 유닛이 있을 경우 모두 추출.
  *
  * @param line - 리스트 항목 라인 (리스트 마커 제거 전)
  * @param idPattern - 유닛 ID 필터링 패턴 (선택)
- * @returns 추출된 DepInfo 또는 null
+ * @returns 추출된 DepInfo 배열 (없으면 빈 배열)
  */
 function extractDepFromLine(line, idPattern) {
-    // 리스트 마커 제거
     const content = line.replace(/^[-*]\s+/, '');
-    // 후보 ID 수집 (링크 우선, 볼드 후순위)
     const candidates = [];
-    // 링크 텍스트: [ID](url) — 중첩 괄호 1레벨 지원 (예: [U-002[Mvp]])
     const linkRegex = /\[((?:[^[\]]*(?:\[[^\]]*\])?[^[\]]*)*)\]\([^)]*\)/g;
     let match;
     while ((match = linkRegex.exec(content)) !== null) {
         if (match[1])
-            candidates.push({ id: match[1].trim(), source: 'link' });
+            candidates.push({
+                id: match[1].trim(),
+                source: 'link',
+                matchStart: match.index,
+                matchEnd: match.index + match[0].length,
+            });
     }
-    // 볼드 텍스트: **ID**
     const boldRegex = /\*\*([^*]+)\*\*/g;
     while ((match = boldRegex.exec(content)) !== null) {
         if (match[1])
-            candidates.push({ id: match[1].trim(), source: 'bold' });
+            candidates.push({
+                id: match[1].trim(),
+                source: 'bold',
+                matchStart: match.index,
+                matchEnd: match.index + match[0].length,
+            });
     }
     if (candidates.length === 0)
-        return null;
-    // idPattern으로 필터링: 볼드 헤더(`**헤더**: [ID](url)`)에서 비유닛 볼드를 건너뜀
+        return [];
     const idRegex = idPattern ? safeRegex(idPattern) : null;
-    const validCandidate = idRegex ? candidates.find((c) => idRegex.test(c.id)) : candidates[0];
-    if (!validCandidate)
-        return null;
-    const unitId = validCandidate.id;
-    if (isNoneDependency(unitId))
-        return null;
-    // 설명 추출: ID 참조 이후의 텍스트에서 구분자 제거
-    const description = extractDescription(content, unitId, validCandidate.source);
-    return { unitId, description };
+    const validCandidates = idRegex
+        ? candidates
+            .filter((c) => idRegex.test(c.id))
+            .map((c) => {
+            // 볼드가 링크를 감싸는 경우(`**[ID](url)**`) ID를 실제 유닛 ID로 정규화
+            const actualMatch = c.id.match(idRegex);
+            return actualMatch ? { ...c, id: actualMatch[0] } : c;
+        })
+        : candidates[0]
+            ? [candidates[0]]
+            : [];
+    // None 의존성 필터링 + 동일 ID 중복 제거 (첫 등장 유지)
+    const seen = new Set();
+    const filtered = validCandidates.filter((c) => {
+        if (isNoneDependency(c.id))
+            return false;
+        if (seen.has(c.id))
+            return false;
+        seen.add(c.id);
+        return true;
+    });
+    if (filtered.length === 0)
+        return [];
+    // 단일 후보: 기존 extractDescription 로직 사용 (성능/호환성 보장)
+    if (filtered.length === 1) {
+        const c = filtered[0];
+        if (!c)
+            return [];
+        const description = extractDescription(content, c.id, c.source);
+        return [{ unitId: c.id, description }];
+    }
+    // 복수 후보: 등장 순서 정렬 후 위치 기반 description 범위 분할
+    const sorted = [...filtered].sort((a, b) => a.matchStart - b.matchStart);
+    return sorted.map((c, i) => {
+        const nextCandidate = sorted[i + 1];
+        const nextStart = nextCandidate ? nextCandidate.matchStart : content.length;
+        const descText = content.slice(c.matchEnd, nextStart);
+        const description = cleanupMultiDescription(descText);
+        return { unitId: c.id, description };
+    });
 }
 /**
  * ID 참조 이후의 설명 텍스트를 추출한다
@@ -157,6 +201,19 @@ function extractDescription(content, unitId, source) {
     rest = rest.replace(/^[—-]\s+/, '');
     return rest.trim();
 }
+/**
+ * 멀티 의존성 description 텍스트를 정리한다
+ *
+ * 위치 기반 범위 분할로 추출된 raw description에서
+ * 선행 구분자(`:`, `—`, `-`)와 후행 콤마를 제거.
+ */
+function cleanupMultiDescription(text) {
+    let rest = text.trim();
+    rest = rest.replace(/^[:—]\s*/, '');
+    rest = rest.replace(/^[—-]\s+/, '');
+    rest = rest.replace(/,\s*$/, '');
+    return rest.trim();
+}
 /**
  * 하위 항목에서 artifact 텍스트를 추출한다
  *

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

@@ -120,9 +120,16 @@ function extractBySource(content, config, idPattern) {
 /** 섹션 기반으로 의존성과 비유닛 컨텍스트 항목을 추출한다 */
 function extractFromSection(content, sectionName, idPattern) {
     const sectionLines = findSectionLines(content, sectionName, { allowBoldMarker: true });
-    if (sectionLines.length === 0)
-        return { deps: [], contextNotes: [] };
-    return parseDependencyLines(sectionLines, idPattern);
+    if (sectionLines.length > 0) {
+        return parseDependencyLines(sectionLines, idPattern);
+    }
+    // Fallback: 볼드 마커의 인라인 콘텐츠 추출
+    // `**이전 작업에서 가져올 것**: [U-102[Mmp]](url) — 설명` 형태 처리
+    const inlineContent = findBoldMarkerInlineContent(content, sectionName);
+    if (inlineContent) {
+        return parseDependencyLines([`- ${inlineContent}`], idPattern);
+    }
+    return { deps: [], contextNotes: [] };
 }
 /** YAML frontmatter의 depends 필드에서 의존성을 추출한다 (배열/콤마/단일값) */
 function extractFromFrontmatter(content) {
@@ -179,13 +186,27 @@ function extractFromMetadataTable(content, tableConfig) {
  * 2. 하이픈(-)은 유닛 ID와 혼동될 수 있으므로 반드시 앞뒤 공백 필요
  */
 const DESC_SEPARATOR_RE = /^(?:(.+?)\s*([—:])\s*(.+)|(.+?)\s+-\s+(.+))$/;
+/**
+ * 마크다운 링크 구문을 제거하고 텍스트만 추출한다
+ *
+ * `[U-102[Mmp]](U-102[Mmp].md)` → `U-102[Mmp]`
+ *
+ * 중첩 대괄호 1레벨 지원. 링크가 아니면 원본 반환.
+ */
+function stripMarkdownLink(token) {
+    const linkMatch = token.match(/^\[((?:[^[\]]*(?:\[[^\]]*\])?[^[\]]*)*)\]\([^)]*\)$/);
+    return linkMatch?.[1]?.trim() ?? token;
+}
 /**
  * `U-101 — Token 발급` 같은 토큰에서 unitId와 description을 분리한다
  *
+ * 마크다운 링크 구문(`[ID](url)`)이 있으면 먼저 제거한 뒤 처리.
  * 구분자가 없으면 전체가 unitId, description은 빈 문자열.
  */
 function splitUnitIdAndDescription(rawToken) {
-    const match = rawToken.match(DESC_SEPARATOR_RE);
+    // 마크다운 링크 제거: [text](url) → text
+    const stripped = stripMarkdownLink(rawToken);
+    const match = stripped.match(DESC_SEPARATOR_RE);
     if (match) {
         // 1번 그룹(ID), 3번 그룹(Desc) 또는 4번 그룹(ID), 5번 그룹(Desc)
         const unitId = (match[1] || match[4] || '').trim();
@@ -194,7 +215,29 @@ function splitUnitIdAndDescription(rawToken) {
             return { unitId, description };
         }
     }
-    return { unitId: rawToken, description: '' };
+    return { unitId: stripped, description: '' };
+}
+/**
+ * 볼드 마커 라인에서 인라인 콘텐츠를 추출한다
+ *
+ * `**섹션명**: [U-102[Mmp]](url) — 설명` → `[U-102[Mmp]](url) — 설명`
+ *
+ * findSectionLines가 볼드 마커 라인의 인라인 콘텐츠를 건너뛰는 경우의 Fallback.
+ */
+function findBoldMarkerInlineContent(content, sectionName) {
+    const marker = `**${sectionName}**`;
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        const idx = trimmed.indexOf(marker);
+        if (idx === -1)
+            continue;
+        const afterMarker = trimmed
+            .slice(idx + marker.length)
+            .replace(/^\s*[:\-—]\s*/, '')
+            .trim();
+        return afterMarker || null;
+    }
+    return null;
 }
 /**
  * 본문 전체에서 ID 패턴으로 의존성을 스캔한다 (Fallback 최후 수단)

package/dist/core/parsers/md-utils.d.ts

@@ -10,7 +10,7 @@
 export declare const FRONTMATTER_RE: RegExp;
 /** 마크다운 헤딩 패턴: # ~ ###### 레벨 */
 export declare const HEADING_RE: RegExp;
-/** 볼드 마커 패턴: **섹션명** (콜론/대시 허용) */
+/** 볼드 마커 패턴: **섹션명** (콜론/대시 허용, 인라인 콘텐츠 포함) */
 export declare const BOLD_MARKER_RE: RegExp;
 /**
  * 섹션 탐색 옵션

package/dist/core/parsers/md-utils.js

@@ -10,8 +10,8 @@
 export const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
 /** 마크다운 헤딩 패턴: # ~ ###### 레벨 */
 export const HEADING_RE = /^(#{1,6})\s+(.+)$/;
-/** 볼드 마커 패턴: **섹션명** (콜론/대시 허용) */
-export const BOLD_MARKER_RE = /^\*\*[^*]+\*\*\s*[:\-—]?\s*$/;
+/** 볼드 마커 패턴: **섹션명** (콜론/대시 허용, 인라인 콘텐츠 포함) */
+export const BOLD_MARKER_RE = /^\*\*[^*]+\*\*(?:\s*[:\-—]|\s*$)/;
 /**
  * 섹션명에 해당하는 콘텐츠 라인들을 추출한다
  *

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

@@ -58,8 +58,8 @@ export function renderSection(context, unitTypeConfig, docPrefix = DEFAULT_DOC_P
 /**
  * 의존 유닛 목록과 비유닛 컨텍스트 항목을 렌더링한다
  *
- * 유닛 항목: `- **{unitId}**: {description}`
- * 비유닛 항목: `- {description}` (볼드 유닛 ID 없이)
+ * 유닛 항목: `- {unitId}: {description}`
+ * 비유닛 항목: `- {description}` (유닛 ID 없이)
  */
 function renderDepUnits(lines, context) {
     lines.push('');
@@ -68,7 +68,7 @@ function renderDepUnits(lines, context) {
     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}`);
+            lines.push(`- ${dep.unitId}: ${dep.description}`);
         }
         for (const note of contextNotes) {
             lines.push(`- ${note}`);

package/dist/core/resolvers/config-generator.d.ts

@@ -12,6 +12,7 @@ export declare const DEFAULT_ROADMAP_PATH = "vibe/roadmap.md";
 export declare const DEFAULT_PLAN_DIR = "vibe/unit-plans";
 export declare const DEFAULT_RESULT_DIR = "vibe/unit-results";
 export declare const DEFAULT_ID_PATTERN = "^(U-\\d+|CP-).*";
+export declare const DEFAULT_RUNBOOK_DIR = "vibe/unit-runbooks";
 export declare const DEFAULT_COMMAND_SECTION = "# \uC720\uB2DB \uAD6C\uD604";
 export declare const DEFAULT_HEADER_TEMPLATE = "### \uD604\uC7AC \uAD6C\uD604 \uC720\uB2DB: {{title}}\n- \uD604\uC7AC \uAD6C\uD604 \uC720\uB2DB \uAC1C\uBC1C \uACC4\uD68D\uC11C: @{{planPath}}\n- \uD604\uC7AC \uAD6C\uD604 Commit(\uBCC0\uACBD\uC810 \uD655\uC778\uD558\uC5EC \uB9E5\uB77D\uC73C\uB85C \uC0AC\uC6A9): -";
 /**

package/dist/core/resolvers/config-generator.js

@@ -12,6 +12,7 @@ export const DEFAULT_ROADMAP_PATH = 'vibe/roadmap.md';
 export const DEFAULT_PLAN_DIR = 'vibe/unit-plans';
 export const DEFAULT_RESULT_DIR = 'vibe/unit-results';
 export const DEFAULT_ID_PATTERN = '^(U-\\d+|CP-).*';
+export const DEFAULT_RUNBOOK_DIR = 'vibe/unit-runbooks';
 export const DEFAULT_COMMAND_SECTION = '# 유닛 구현';
 export const DEFAULT_HEADER_TEMPLATE = '### 현재 구현 유닛: {{title}}\n- 현재 구현 유닛 개발 계획서: @{{planPath}}\n- 현재 구현 Commit(변경점 확인하여 맥락으로 사용): -';
 /**
@@ -45,7 +46,7 @@ export function extractStdinAnswers(data) {
         roadmapPath: DEFAULT_ROADMAP_PATH,
         planDir: DEFAULT_PLAN_DIR,
         resultDir: DEFAULT_RESULT_DIR,
-        runbookDir: null,
+        runbookDir: DEFAULT_RUNBOOK_DIR,
         idPattern: DEFAULT_ID_PATTERN,
         commandSection: DEFAULT_COMMAND_SECTION,
     };

package/dist/core/resolvers/config-merger.js

@@ -53,7 +53,6 @@ function mergePaths(existing, scanned) {
         const existingDocRoots = isPlainObject(existing['docRoots']) ? existing['docRoots'] : {};
         const mergedDocRoots = { ...existingDocRoots };
         for (const key of Object.keys(scanned['docRoots'])) {
-            // 스캔 결과에 있는 docRoots 키는 무조건 반영 (갱신 또는 추가)
             mergedDocRoots[key] = scanned['docRoots'][key];
         }
         merged['docRoots'] = mergedDocRoots;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-commander",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "description": "Unit-based vibe coding workflow automation CLI — automate context collection from unit ID to command file in 10 seconds",
   "license": "MIT",