vibe-commander 0.2.0 → 0.2.2

package/dist/core/renderers/index.js

@@ -16,5 +16,5 @@ export { updateSection, updateField } from './section-updater.js';
 // 마커 유틸리티
 export { createBeginMarker, createEndMarker, findMarkerRange, isValidSectionKey, wrapWithMarkers, stripMarkers, } from './marker-utils.js';
 // 스키마 렌더러
-export { COMMAND_REGISTRY, SCHEMA_SUBCOMMANDS, renderCommandsSchema, renderTypesSchema, } from './schema-renderer.js';
+export { COMMAND_REGISTRY, SCHEMA_SUBCOMMANDS, renderConfigSchema, renderCommandsSchema, renderTypesSchema, } from './schema-renderer.js';
 //# sourceMappingURL=index.js.map

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

@@ -10,10 +10,12 @@
  * @module
  */
 import { stripCR } from '../parsers/md-utils.js';
+/** HTML 주석 마커의 네임스페이스 접두어 */
+const MARKER_PREFIX = 'vc';
 /** sectionKey 허용 패턴: 영문 소문자 시작, 소문자+숫자+하이픈 */
 const SECTION_KEY_RE = /^[a-z][a-z0-9-]*$/;
 /** 마커 라인 매칭 정규식 */
-const MARKER_LINE_RE = /^<!--\s*vc:(begin|end):([a-z][a-z0-9-]*)\s*-->$/;
+const MARKER_LINE_RE = new RegExp(`^<!--\\s*${MARKER_PREFIX}:(begin|end):([a-z][a-z0-9-]*)\\s*-->$`);
 /**
  * sectionKey가 유효한지 검증한다
  *
@@ -28,7 +30,7 @@ export function isValidSectionKey(key) {
  * @example createBeginMarker('implement') → '<!-- vc:begin:implement -->'
  */
 export function createBeginMarker(sectionKey) {
-    return `<!-- vc:begin:${sectionKey} -->`;
+    return `<!-- ${MARKER_PREFIX}:begin:${sectionKey} -->`;
 }
 /**
  * end 마커 문자열을 생성한다
@@ -36,7 +38,7 @@ export function createBeginMarker(sectionKey) {
  * @example createEndMarker('implement') → '<!-- vc:end:implement -->'
  */
 export function createEndMarker(sectionKey) {
-    return `<!-- vc:end:${sectionKey} -->`;
+    return `<!-- ${MARKER_PREFIX}:end:${sectionKey} -->`;
 }
 /**
  * 라인 배열에서 지정된 sectionKey의 마커 범위를 찾는다

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

@@ -7,6 +7,7 @@
  *
  * @module
  */
+import { z } from 'zod';
 import type { UnitTypeConfig } from '../../types/index.js';
 /** CLI 커맨드 인자 스키마 */
 export interface ArgSchema {
@@ -69,6 +70,21 @@ export type SchemaResult = {
 export declare const COMMAND_REGISTRY: CommandSchema[];
 /** schema 서브커맨드 도움말 정보 */
 export declare const SCHEMA_SUBCOMMANDS: SchemaSubcommandInfo[];
+/**
+ * 프로젝트 설정 스키마를 JSON Schema (Draft 2020-12) 형식으로 렌더링한다
+ *
+ * Zod 4의 z.toJSONSchema() 내장 기능을 활용하여 변환.
+ * 에이전트가 설정 파일 구조를 런타임에 조회할 수 있도록 한다.
+ *
+ * @param schema - 변환할 Zod 스키마
+ * @param metadata - 스키마 메타데이터 ($id, title, description)
+ * @returns JSON Schema 호환 객체
+ */
+export declare function renderConfigSchema(schema: z.ZodType, metadata?: {
+    id?: string;
+    title?: string;
+    description?: string;
+}): Record<string, unknown>;
 /**
  * 커맨드 메타데이터를 구조화된 형태로 렌더링한다
  *

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

@@ -7,6 +7,7 @@
  *
  * @module
  */
+import { z } from 'zod';
 // ── 커맨드 레지스트리 (정적 메타데이터) ──
 const GLOBAL_FLAGS = [
     { name: '--help', alias: '-h', type: 'boolean', description: '도움말 출력' },
@@ -127,6 +128,26 @@ export const SCHEMA_SUBCOMMANDS = [
     { name: 'types', description: '현재 프로젝트의 유닛 유형 목록 + ID 패턴 출력' },
 ];
 // ── 공개 API ──
+/**
+ * 프로젝트 설정 스키마를 JSON Schema (Draft 2020-12) 형식으로 렌더링한다
+ *
+ * Zod 4의 z.toJSONSchema() 내장 기능을 활용하여 변환.
+ * 에이전트가 설정 파일 구조를 런타임에 조회할 수 있도록 한다.
+ *
+ * @param schema - 변환할 Zod 스키마
+ * @param metadata - 스키마 메타데이터 ($id, title, description)
+ * @returns JSON Schema 호환 객체
+ */
+export function renderConfigSchema(schema, metadata) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
+    const jsonSchema = z.toJSONSchema(schema);
+    return {
+        ...jsonSchema,
+        ...(metadata?.id && { $id: metadata.id }),
+        ...(metadata?.title && { title: metadata.title }),
+        ...(metadata?.description && { description: metadata.description }),
+    };
+}
 /**
  * 커맨드 메타데이터를 구조화된 형태로 렌더링한다
  *

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

@@ -12,6 +12,13 @@
  * @module
  */
 import type { CommandContext, UnitTypeConfig } from '../../types/index.js';
+/** renderSection 옵션 */
+export interface RenderSectionOptions {
+    /** 보존할 기존 특별 요청사항 콘텐츠 (헤딩 포함). truthy이면 설정 기반 렌더링 대신 사용 */
+    preservedSpecialRequests?: string;
+    /** 특별 요청사항 섹션 헤딩 (기본: "### 특별 요청사항") */
+    specialRequestsHeading?: string;
+}
 /**
  * 커맨드 파일 섹션을 렌더링한다
  *
@@ -25,7 +32,8 @@ import type { CommandContext, UnitTypeConfig } from '../../types/index.js';
  * @param context - 렌더링할 전체 컨텍스트 (유닛 메타 + 의존성 + 특별 요청)
  * @param unitTypeConfig - 유닛 유형 설정 (headerTemplate, collectDeps 등)
  * @param docPrefix - 문서 경로 앞에 붙일 프리픽스 (기본: "@")
+ * @param options - 추가 렌더링 옵션 (보존 콘텐츠, 커스텀 헤딩 등)
  * @returns 렌더링된 섹션 본문 문자열
  */
-export declare function renderSection(context: CommandContext, unitTypeConfig: UnitTypeConfig, docPrefix?: string): string;
+export declare function renderSection(context: CommandContext, unitTypeConfig: UnitTypeConfig, docPrefix?: string, options?: RenderSectionOptions): string;
 //# sourceMappingURL=section-renderer.d.ts.map

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

@@ -16,6 +16,8 @@ import { interpolateTemplate } from './template-engine.js';
 const DEFAULT_DOC_PREFIX = '@';
 /** 빈 항목 표시 마커 */
 const EMPTY_MARKER = '-';
+/** 기본 특별 요청사항 헤딩 */
+const DEFAULT_SPECIAL_REQUESTS_HEADING = '### 특별 요청사항';
 /**
  * 커맨드 파일 섹션을 렌더링한다
  *
@@ -29,9 +31,10 @@ const EMPTY_MARKER = '-';
  * @param context - 렌더링할 전체 컨텍스트 (유닛 메타 + 의존성 + 특별 요청)
  * @param unitTypeConfig - 유닛 유형 설정 (headerTemplate, collectDeps 등)
  * @param docPrefix - 문서 경로 앞에 붙일 프리픽스 (기본: "@")
+ * @param options - 추가 렌더링 옵션 (보존 콘텐츠, 커스텀 헤딩 등)
  * @returns 렌더링된 섹션 본문 문자열
  */
-export function renderSection(context, unitTypeConfig, docPrefix = DEFAULT_DOC_PREFIX) {
+export function renderSection(context, unitTypeConfig, docPrefix = DEFAULT_DOC_PREFIX, options) {
     const lines = [];
     // 1. Header block (headerTemplate 변수 보간)
     const header = interpolateTemplate(unitTypeConfig.headerTemplate, context.unit);
@@ -42,8 +45,14 @@ export function renderSection(context, unitTypeConfig, docPrefix = DEFAULT_DOC_P
         renderDepDocs(lines, context, docPrefix);
         renderDepCommits(lines, context);
     }
-    // 3. 특별 요청사항 (항상 렌더링)
-    renderSpecialRequests(lines, context);
+    // 3. 특별 요청사항: 보존 콘텐츠가 있으면 그대로 사용, 없으면 설정에서 렌더링
+    if (options?.preservedSpecialRequests) {
+        lines.push('');
+        lines.push(...options.preservedSpecialRequests.split('\n'));
+    }
+    else {
+        renderSpecialRequests(lines, context, options?.specialRequestsHeading);
+    }
     return lines.join('\n');
 }
 /**
@@ -113,9 +122,9 @@ function renderDepCommits(lines, context) {
  * 모든 미결정 질문이 답변되었으면 자동으로 ✅를 추가한다.
  * 답변된 페어링 질문은 특별 요청사항 뒤에 체크리스트 형태로 렌더링.
  */
-function renderSpecialRequests(lines, context) {
+function renderSpecialRequests(lines, context, heading) {
     lines.push('');
-    lines.push('### 특별 요청사항');
+    lines.push(heading ?? DEFAULT_SPECIAL_REQUESTS_HEADING);
     const allAnswered = areAllQuestionsAnswered(context);
     if (context.specialRequests.length > 0) {
         for (const req of context.specialRequests) {

package/dist/core/resolvers/backlog-resolver.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 백로그 분류 리졸버 — Layer 1 (Core)
+ *
+ * 파싱된 백로그 항목들을 필터링하고 상태별(ready/inProgress/blocked)로 분류한다.
+ *
+ * @module
+ */
+import type { BacklogEntry, ToolResult } from '../../types/index.js';
+/** 백로그 분류 옵션 */
+export interface BacklogFilterOptions {
+    phase?: string;
+    excludeCompleted?: boolean;
+}
+/** 백로그 분류 결과 */
+export interface ClassifiedBacklog {
+    total: number;
+    inProgress: BacklogEntry[];
+    ready: BacklogEntry[];
+    blocked: BacklogEntry[];
+    phase?: string;
+}
+/**
+ * 백로그 항목들을 분류한다 (Pure Function)
+ *
+ * @param entries - 파싱된 전체 백로그 항목
+ * @param options - 필터링 옵션
+ * @returns 분류된 결과
+ */
+export declare function classifyBacklog(entries: BacklogEntry[], options?: BacklogFilterOptions): ToolResult<ClassifiedBacklog>;
+/**
+ * 유닛 ID에서 phase 태그를 추출한다 (Pure Function)
+ *
+ * "U-016[Mvp]" → "Mvp"
+ * "CP-MVP-03" → null
+ */
+export declare function extractPhaseFromId(unitId: string): string | null;
+//# sourceMappingURL=backlog-resolver.d.ts.map

package/dist/core/resolvers/backlog-resolver.js

@@ -0,0 +1,50 @@
+/**
+ * 백로그 분류 리졸버 — Layer 1 (Core)
+ *
+ * 파싱된 백로그 항목들을 필터링하고 상태별(ready/inProgress/blocked)로 분류한다.
+ *
+ * @module
+ */
+import { ok } from '../../types/index.js';
+/**
+ * 백로그 항목들을 분류한다 (Pure Function)
+ *
+ * @param entries - 파싱된 전체 백로그 항목
+ * @param options - 필터링 옵션
+ * @returns 분류된 결과
+ */
+export function classifyBacklog(entries, options = {}) {
+    const { phase, excludeCompleted = true } = options;
+    // 1. 완료 항목 제외 (옵션에 따라)
+    let activeEntries = excludeCompleted ? entries.filter((e) => e.status !== 'completed') : entries;
+    // 2. phase 필터링 (대소문자 무시)
+    if (phase) {
+        const normalizedPhase = phase.toLowerCase();
+        activeEntries = activeEntries.filter((e) => {
+            const entryPhase = extractPhaseFromId(e.unitId);
+            return entryPhase !== null && entryPhase.toLowerCase() === normalizedPhase;
+        });
+    }
+    // 3. 상태별 분류
+    const inProgress = activeEntries.filter((e) => e.status === 'inProgress');
+    const ready = activeEntries.filter((e) => e.status === 'ready');
+    const blocked = activeEntries.filter((e) => e.status === 'blocked');
+    return ok({
+        total: activeEntries.length,
+        inProgress,
+        ready,
+        blocked,
+        ...(phase !== undefined && { phase }),
+    });
+}
+/**
+ * 유닛 ID에서 phase 태그를 추출한다 (Pure Function)
+ *
+ * "U-016[Mvp]" → "Mvp"
+ * "CP-MVP-03" → null
+ */
+export function extractPhaseFromId(unitId) {
+    const match = unitId.match(/\[([^\]]+)\]$/);
+    return match?.[1] ?? null;
+}
+//# sourceMappingURL=backlog-resolver.js.map

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

@@ -8,8 +8,6 @@
 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/examples/nextjs-web.config.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://raw.githubusercontent.com/viilab/vibe-commander/main/schemas/config-schema.json",
+  "version": 1,
+
+  "paths": {
+    "commands": ".cursor/context.md",
+    "roadmap": "docs/backlog.md",
+    "docRoots": {
+      "spec": "docs/specs",
+      "result": "docs/results"
+    },
+    "refactorSubDir": null
+  },
+
+  "unitTypes": [
+    {
+      "key": "feature",
+      "displayName": "Feature",
+      "idPattern": "^FEAT-\\d+$",
+      "planDir": "spec",
+      "commandSection": "# Current Feature",
+      "collectDeps": true,
+      "headerTemplate": "### Feature: {{title}}\n- Spec: @{{planPath}}\n- Latest Commit: -"
+    },
+    {
+      "key": "bugfix",
+      "displayName": "Bugfix",
+      "idPattern": "^BUG-\\d+$",
+      "planDir": "spec",
+      "commandSection": "# Current Bugfix",
+      "collectDeps": true,
+      "headerTemplate": "### Bugfix: {{title}}\n- Spec: @{{planPath}}\n- Latest Commit: -"
+    }
+  ],
+
+  "planParsing": {
+    "titleSource": "frontmatter:title",
+    "dependsSource": "frontmatter",
+    "dependsSectionName": null,
+    "pairingQuestionSection": "Open Questions"
+  },
+
+  "backlogParsing": {
+    "sectionHeader": "## Backlog",
+    "entryPattern": "- \\[(?<status>.)\\] (?<id>\\S+) — (?<title>.+?)(?:\\s*\\(deps: (?<deps>[^)]+)\\))?$",
+    "completedSection": "### Done",
+    "statusMap": {
+      "ready": " ",
+      "inProgress": "~",
+      "completed": "x",
+      "blocked": "!"
+    }
+  },
+
+  "commitSearch": {
+    "strategy": "git-log-grep",
+    "extractId": "shortId",
+    "maxResults": 3,
+    "excludePaths": ["docs/**", "*.md"],
+    "requirePaths": ["src/**", "app/**"]
+  },
+
+  "commandSections": {
+    "separator": "---",
+    "preserveOtherSections": true,
+    "useMarkers": false
+  },
+
+  "defaultSpecialRequests": [
+    "**Use Next.js App Router patterns**",
+    "**Run `pnpm test` before marking complete**"
+  ]
+}

package/examples/python-backend.config.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://raw.githubusercontent.com/viilab/vibe-commander/main/schemas/config-schema.json",
+  "version": 1,
+
+  "paths": {
+    "commands": ".dev/context.md",
+    "roadmap": ".dev/backlog.md",
+    "docRoots": {
+      "plan": ".dev/plans",
+      "result": ".dev/results",
+      "runbook": ".dev/runbooks"
+    },
+    "refactorSubDir": null
+  },
+
+  "unitTypes": [
+    {
+      "key": "task",
+      "displayName": "Task",
+      "idPattern": "^TASK-\\d{3,}$",
+      "planDir": "plan",
+      "commandSection": "# Current Task",
+      "collectDeps": true,
+      "headerTemplate": "### Task: {{title}}\n- Plan: @{{planPath}}\n- Commit: -"
+    },
+    {
+      "key": "refactor",
+      "displayName": "Refactor",
+      "idPattern": "^REFACTOR-\\d{3,}$",
+      "planDir": "plan",
+      "commandSection": "# Current Refactor",
+      "collectDeps": false,
+      "headerTemplate": "### Refactor: {{title}}\n- Plan: @{{planPath}}\n- Commit: -"
+    }
+  ],
+
+  "docDiscovery": {
+    "plan": { "pattern": "{{unitId}}.md" },
+    "result": { "pattern": "{{unitId}}.md" },
+    "runbook": { "pattern": "{{shortId}}-*-runbook.md", "glob": true }
+  },
+
+  "planParsing": {
+    "titleSource": "h1",
+    "dependsSource": "metadata-table",
+    "dependsSectionName": null,
+    "pairingQuestionSection": "Open Questions",
+    "metadataTable": {
+      "idField": "Task ID",
+      "phaseField": "Sprint",
+      "dependsField": "Depends On"
+    }
+  },
+
+  "backlogParsing": {
+    "sectionHeader": "## Sprint Backlog",
+    "entryPattern": "- (?<status>[⬜🔄✅❌]) \\[(?<id>\\S+)\\]\\((?<path>[^)]+)\\)\\s*(?<title>[^(]+?)(?:\\s*\\(deps: (?<deps>[^)]+)\\))?$",
+    "completedSection": "### Completed",
+    "statusMap": {
+      "ready": "⬜",
+      "inProgress": "🔄",
+      "completed": "✅",
+      "blocked": "❌"
+    }
+  },
+
+  "commitSearch": {
+    "strategy": "git-log-grep",
+    "extractId": "shortId",
+    "maxResults": 5,
+    "excludePaths": [".dev/**"],
+    "requirePaths": ["src/**", "apps/**", "tests/**"]
+  },
+
+  "commandSections": {
+    "separator": "---",
+    "preserveOtherSections": true,
+    "commitFieldName": "Latest Commit",
+    "useMarkers": true
+  },
+
+  "defaultSpecialRequests": [
+    "**Follow Django best practices and PEP 8**",
+    "**Run `pytest` before marking complete**"
+  ],
+
+  "customRequests": {
+    "migration": "**Create and test Django migrations for any model changes**",
+    "api-docs": "**Update OpenAPI/Swagger documentation for API changes**"
+  }
+}

package/examples/tauri-app.config.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://raw.githubusercontent.com/viilab/vibe-commander/main/schemas/config-schema.json",
+  "version": 1,
+
+  "paths": {
+    "commands": "vibe/commands.md",
+    "roadmap": "vibe/roadmap.md",
+    "docRoots": {
+      "plan": "vibe/unit-plans",
+      "result": "vibe/unit-results",
+      "runbook": "vibe/unit-runbooks",
+      "refactorSub": "vibe/refactors"
+    },
+    "refactorSubDir": "vibe/refactors"
+  },
+
+  "unitTypes": [
+    {
+      "key": "refactor-sub",
+      "displayName": "리팩토링 서브유닛",
+      "idPattern": "^RU-\\d+-[A-Z]\\d+$",
+      "planDir": "refactorSub",
+      "commandSection": "# 리팩토링 유닛 구현 (의존X)",
+      "collectDeps": false,
+      "headerTemplate": "### 현재 리팩토링 유닛: [ID: {{unitId}}] {{titleOnly}}\n- 계획서: @{{planPath}}\n- Commit: -"
+    },
+    {
+      "key": "implement",
+      "displayName": "유닛 구현",
+      "idPattern": "^(U-\\d+|CP-).*",
+      "planDir": "plan",
+      "commandSection": "# 유닛 구현",
+      "collectDeps": true,
+      "headerTemplate": "### 현재 구현 유닛: {{title}}\n- 개발 계획서: @{{planPath}}\n- Commit: -"
+    },
+    {
+      "key": "refactor",
+      "displayName": "리팩토링 유닛",
+      "idPattern": "^RU-\\d+\\[.*\\]$",
+      "planDir": "plan",
+      "commandSection": "# 리팩토링 유닛 제안",
+      "collectDeps": true,
+      "headerTemplate": "### 현재 리팩토링 유닛: {{title}}\n- 계획서: @{{planPath}}\n- Commit: -"
+    }
+  ],
+
+  "docDiscovery": {
+    "plan": { "pattern": "{{unitId}}.md" },
+    "result": { "pattern": "{{unitId}}.md" },
+    "runbook": { "pattern": "{{shortId}}-*-runbook.md", "glob": true },
+    "refactorSub": { "pattern": "{{unitId}}.md" }
+  },
+
+  "planParsing": {
+    "titleSource": "h1",
+    "dependsSource": "section",
+    "dependsSectionName": "이전 작업에서 가져올 것",
+    "pairingQuestionSection": "페어링 질문",
+    "metadataTable": {
+      "idField": "Unit ID",
+      "phaseField": "Phase",
+      "dependsField": "의존성"
+    }
+  },
+
+  "commitSearch": {
+    "strategy": "git-log-grep",
+    "extractId": "shortId",
+    "maxResults": 5,
+    "excludePaths": ["vibe/**", "docs/**"],
+    "requirePaths": ["src/**", "src-tauri/**"]
+  },
+
+  "commandSections": {
+    "separator": "---------------------------------------------------",
+    "preserveOtherSections": true,
+    "useMarkers": true
+  },
+
+  "defaultSpecialRequests": [
+    "**페어링 질문의 결정을 확인합니다**"
+  ],
+
+  "specialRequestsByType": {
+    "implement": [
+      "**Tauri v2 공식 문서를 참고하여 구현합니다**",
+      "**Shell Tool을 이용하여 직접 테스트합니다**"
+    ]
+  },
+
+  "customRequests": {
+    "doc-update": "**vibe/architecture.md, vibe/progress.md, vibe/roadmap.md 문서를 업데이트합니다**",
+    "playwright": "**Playwright를 사용하여 E2E 테스트를 실행합니다**"
+  }
+}

package/examples/vscode-tasks.json

@@ -0,0 +1,101 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "vc: Set Unit",
+      "type": "shell",
+      "command": "npx vc set-unit ${input:unitId}",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "vc: Set Unit (Dry Run)",
+      "type": "shell",
+      "command": "npx vc set-unit ${input:unitId} --dry-run",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "vc: Update Commit (HEAD)",
+      "type": "shell",
+      "command": "npx vc update-commit",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "vc: Update Commit (N)",
+      "type": "shell",
+      "command": "npx vc update-commit ${input:commitCount}",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "vc: List Units",
+      "type": "shell",
+      "command": "npx vc list-units",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "vc: Validate",
+      "type": "shell",
+      "command": "npx vc validate",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "vc: Context (JSON)",
+      "type": "shell",
+      "command": "npx vc context ${input:unitId} --json",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true
+      },
+      "problemMatcher": []
+    }
+  ],
+  "inputs": [
+    {
+      "id": "unitId",
+      "type": "promptString",
+      "description": "유닛 ID 입력 (예: U-001[Mvp])"
+    },
+    {
+      "id": "commitCount",
+      "type": "promptString",
+      "description": "최근 커밋 수 (예: 3)"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-commander",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "description": "Unit-based vibe coding workflow automation CLI — automate context collection from unit ID to command file in 10 seconds",
   "license": "MIT",
@@ -34,9 +34,12 @@
     "dist/**/*.d.ts",
     "!dist/**/*.d.ts.map",
     "skills/",
+    "schemas/",
+    "examples/",
     "AGENTS.md",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "README.ko.md"
   ],
   "scripts": {
     "dev": "tsx src/adapters/cli/index.ts",
@@ -73,6 +76,15 @@
     "typescript-eslint": "^8.54.0",
     "vitest": "^4.0.18"
   },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "engines": {
     "node": ">=24.0.0"
   }