vibe-commander 0.2.0 → 0.2.1

package/schemas/config-schema.json

@@ -0,0 +1,409 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "description": "JSON Schema URL for IDE autocomplete and validation",
+      "type": "string"
+    },
+    "version": {
+      "type": "number",
+      "const": 1,
+      "description": "Configuration file version (currently 1)"
+    },
+    "paths": {
+      "type": "object",
+      "properties": {
+        "commands": {
+          "default": "commands.md",
+          "description": "Command file path where unit context sections are managed",
+          "type": "string"
+        },
+        "roadmap": {
+          "default": "roadmap.md",
+          "description": "Roadmap/backlog file path. Set to null to disable list-units command",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "docRoots": {
+          "default": {
+            "plan": "unit-plans",
+            "result": "unit-results",
+            "runbook": "unit-runbooks"
+          },
+          "description": "Document root directories by role (key: role name, value: relative path)",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "refactorSubDir": {
+          "default": null,
+          "description": "Refactoring sub-unit directory. Set to null if sub-units are not used",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "commands",
+        "roadmap",
+        "docRoots",
+        "refactorSubDir"
+      ],
+      "additionalProperties": false
+    },
+    "unitTypes": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string",
+            "description": "Unique type key (e.g. 'implement', 'refactor', 'feature')"
+          },
+          "displayName": {
+            "description": "Human-readable display name for this type",
+            "type": "string"
+          },
+          "idPattern": {
+            "type": "string",
+            "description": "Regex pattern to match unit IDs (e.g. '^U-\\\\d+.*', '^FEAT-\\\\d+$')"
+          },
+          "planDir": {
+            "type": "string",
+            "description": "Document root key (from paths.docRoots) where plans are stored"
+          },
+          "commandSection": {
+            "type": "string",
+            "description": "Target section header in the command file (e.g. '# Unit Implementation')"
+          },
+          "collectDeps": {
+            "type": "boolean",
+            "description": "Whether to collect dependency documents and commits for this type"
+          },
+          "headerTemplate": {
+            "type": "string",
+            "description": "Section header template with variable interpolation: {{unitId}}, {{title}}, {{titleOnly}}, {{planPath}}, {{shortId}}"
+          }
+        },
+        "required": [
+          "key",
+          "idPattern",
+          "planDir",
+          "commandSection",
+          "collectDeps",
+          "headerTemplate"
+        ],
+        "additionalProperties": false
+      },
+      "description": "Unit type definitions. Array order determines ID matching priority (first match wins)"
+    },
+    "docDiscovery": {
+      "default": {
+        "plan": {
+          "pattern": "{{unitId}}.md",
+          "glob": false
+        },
+        "result": {
+          "pattern": "{{unitId}}.md",
+          "glob": false
+        },
+        "runbook": {
+          "pattern": "{{shortId}}-*-runbook.md",
+          "glob": true
+        }
+      },
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "pattern": {
+            "type": "string",
+            "description": "File search pattern. Supports {{unitId}} and {{shortId}} variables"
+          },
+          "glob": {
+            "default": false,
+            "description": "Whether to use glob matching (true) or exact match (false)",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "pattern",
+          "glob"
+        ],
+        "additionalProperties": false
+      },
+      "description": "Document discovery rules by role. Defines file name patterns for finding unit documents"
+    },
+    "planParsing": {
+      "type": "object",
+      "properties": {
+        "titleSource": {
+          "default": "h1",
+          "description": "How to extract the unit title: 'h1' from first heading, 'frontmatter:title' from YAML frontmatter",
+          "type": "string",
+          "enum": [
+            "h1",
+            "frontmatter:title"
+          ]
+        },
+        "dependsSource": {
+          "default": "section",
+          "description": "How to extract dependencies: 'section' from markdown section, 'frontmatter' from YAML, 'metadata-table' from 2-column table",
+          "type": "string",
+          "enum": [
+            "section",
+            "frontmatter",
+            "metadata-table"
+          ]
+        },
+        "dependsSectionName": {
+          "default": "이전 작업에서 가져올 것",
+          "description": "Dependency section header name. Set to null to disable section-based extraction",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "pairingQuestionSection": {
+          "default": "페어링 질문",
+          "description": "Section header name for pairing questions (checkbox items)",
+          "type": "string"
+        },
+        "metadataTable": {
+          "type": "object",
+          "properties": {
+            "idField": {
+              "default": "Unit ID",
+              "description": "Field name for the unit ID in the metadata table",
+              "type": "string"
+            },
+            "phaseField": {
+              "default": "Phase",
+              "description": "Field name for the phase in the metadata table",
+              "type": "string"
+            },
+            "dependsField": {
+              "default": "의존성",
+              "description": "Field name for dependencies in the metadata table",
+              "type": "string"
+            }
+          },
+          "required": [
+            "idField",
+            "phaseField",
+            "dependsField"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "titleSource",
+        "dependsSource",
+        "dependsSectionName",
+        "pairingQuestionSection",
+        "metadataTable"
+      ],
+      "additionalProperties": false
+    },
+    "backlogParsing": {
+      "type": "object",
+      "properties": {
+        "sectionHeader": {
+          "default": "## 작업 백로그",
+          "description": "Backlog section start header in the roadmap file",
+          "type": "string"
+        },
+        "entryPattern": {
+          "default": "ID=\\[(?<id>.+?)\\]\\((?<path>[^)]+)\\)\\s*\\|\\s*(?<title>[^|]+)\\|\\s*Depends=(?<deps>[^|]*)\\|\\s*(?<status>.+)",
+          "description": "Regex pattern with named groups (id, path, title, deps, status) to match backlog entries",
+          "type": "string"
+        },
+        "completedSection": {
+          "default": "### 완료",
+          "description": "Section header for completed units",
+          "type": "string"
+        },
+        "statusMap": {
+          "type": "object",
+          "properties": {
+            "ready": {
+              "default": "⏸️",
+              "description": "Ready/waiting status indicator",
+              "type": "string"
+            },
+            "inProgress": {
+              "default": "🚧",
+              "description": "In-progress status indicator",
+              "type": "string"
+            },
+            "completed": {
+              "default": "✅",
+              "description": "Completed status indicator",
+              "type": "string"
+            },
+            "blocked": {
+              "default": "❌",
+              "description": "Blocked status indicator",
+              "type": "string"
+            }
+          },
+          "required": [
+            "ready",
+            "inProgress",
+            "completed",
+            "blocked"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "sectionHeader",
+        "entryPattern",
+        "completedSection",
+        "statusMap"
+      ],
+      "additionalProperties": false
+    },
+    "commitSearch": {
+      "type": "object",
+      "properties": {
+        "strategy": {
+          "default": "git-log-grep",
+          "description": "Search strategy: 'git-log-grep', 'conventional-commit', or 'disabled'",
+          "type": "string"
+        },
+        "extractId": {
+          "default": "shortId",
+          "description": "ID transformation for grep: 'shortId' removes phase tag (e.g. U-001[Mvp] → U-001)",
+          "type": "string"
+        },
+        "maxResults": {
+          "default": 5,
+          "description": "Maximum number of commits to return per dependency",
+          "type": "number"
+        },
+        "excludePaths": {
+          "default": [],
+          "description": "Glob patterns for paths to exclude (e.g. 'docs/**' to filter doc-only commits)",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "requirePaths": {
+          "default": [],
+          "description": "Glob patterns that at least one changed file must match (e.g. 'src/**' for source-only commits)",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "strategy",
+        "extractId",
+        "maxResults",
+        "excludePaths",
+        "requirePaths"
+      ],
+      "additionalProperties": false
+    },
+    "commandSections": {
+      "type": "object",
+      "properties": {
+        "separator": {
+          "default": "---------------------------------------------------",
+          "description": "Section separator string in the command file",
+          "type": "string"
+        },
+        "preserveOtherSections": {
+          "default": true,
+          "description": "Whether to preserve sections not managed by the current unit type",
+          "type": "boolean"
+        },
+        "commitFieldName": {
+          "default": "Commit",
+          "description": "Field keyword for recording commit SHA in the command file",
+          "type": "string"
+        },
+        "useMarkers": {
+          "default": false,
+          "description": "Use HTML comment markers (<!-- vc:begin/end -->) for safer section boundary detection",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "separator",
+        "preserveOtherSections",
+        "commitFieldName",
+        "useMarkers"
+      ],
+      "additionalProperties": false
+    },
+    "defaultSpecialRequests": {
+      "default": [],
+      "description": "Default special request strings appended to every unit context",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "specialRequestsByType": {
+      "default": {},
+      "description": "Additional special requests per unit type (key: unitType.key, value: string array)",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "customRequests": {
+      "default": {},
+      "description": "Named special requests selectable via --request option (key: identifier, value: text)",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "string"
+      }
+    }
+  },
+  "required": [
+    "version",
+    "unitTypes"
+  ],
+  "additionalProperties": false,
+  "$id": "https://raw.githubusercontent.com/viilab/vibe-commander/main/schemas/config-schema.json",
+  "title": "vibe-commander Configuration",
+  "description": "Unit-based vibe coding workflow automation CLI configuration. Defines project structure, unit types, parsing rules, and command sections."
+}

package/skills/claude/SKILL.md

@@ -119,9 +119,31 @@ vc validate --json    # JSON ToolResult
 ```bash
 vc init                    # 대화형 설정 생성
 vc init --from-existing    # 기존 .md 파일 스캔 → 패턴 자동 감지 → 설정 생성
+vc init --force            # 기존 설정 덮어쓰기
 ```
 
 `--from-existing`은 기존 설정이 있으면 커스텀 필드를 보존하며 병합합니다.
+`--force`는 기존 설정 파일이 있어도 강제로 덮어씁니다.
+
+### `vc schema` — 런타임 스키마 조회
+
+에이전트가 CLI 구조를 동적으로 파악할 수 있는 인트로스펙션 기능:
+
+```bash
+vc schema config --json                          # 설정 파일의 JSON Schema 반환
+vc schema commands --json                        # 모든 커맨드의 메타데이터 반환
+vc schema types --json                           # 프로젝트의 unitTypes 및 idPattern 반환
+vc schema config --output schemas/config-schema.json  # 파일로 저장
+```
+
+### `vc skill install` — SKILL 파일 설치
+
+npm 패키지에 번들된 SKILL 파일을 프로젝트에 설치:
+
+```bash
+vc skill install             # 기존 파일이 있으면 건너뜀
+vc skill install --force     # 기존 파일 덮어쓰기
+```
 
 ### 파이프 모드 (에이전트/오케스트레이터 연동)
 

package/skills/common/cli-reference.md

@@ -110,9 +110,31 @@ vc validate --json    # JSON ToolResult
 ```bash
 vc init                    # 대화형 설정 생성
 vc init --from-existing    # 기존 .md 파일 스캔 → 패턴 자동 감지 → 설정 생성
+vc init --force            # 기존 설정 덮어쓰기
 ```
 
 `--from-existing`은 기존 설정이 있으면 커스텀 필드를 보존하며 병합합니다.
+`--force`는 기존 설정 파일이 있어도 강제로 덮어씁니다.
+
+### `vc schema` — 런타임 스키마 조회
+
+에이전트가 CLI 구조를 동적으로 파악할 수 있는 인트로스펙션 기능:
+
+```bash
+vc schema config --json                          # 설정 파일의 JSON Schema 반환
+vc schema commands --json                        # 모든 커맨드의 메타데이터 반환
+vc schema types --json                           # 프로젝트의 unitTypes 및 idPattern 반환
+vc schema config --output schemas/config-schema.json  # 파일로 저장
+```
+
+### `vc skill install` — SKILL 파일 설치
+
+npm 패키지에 번들된 SKILL 파일을 프로젝트에 설치:
+
+```bash
+vc skill install             # 기존 파일이 있으면 건너뜀
+vc skill install --force     # 기존 파일 덮어쓰기
+```
 
 ### 파이프 모드 (에이전트/오케스트레이터 연동)
 

package/skills/cursor/SKILL.md

@@ -119,9 +119,31 @@ vc validate --json    # JSON ToolResult
 ```bash
 vc init                    # 대화형 설정 생성
 vc init --from-existing    # 기존 .md 파일 스캔 → 패턴 자동 감지 → 설정 생성
+vc init --force            # 기존 설정 덮어쓰기
 ```
 
 `--from-existing`은 기존 설정이 있으면 커스텀 필드를 보존하며 병합합니다.
+`--force`는 기존 설정 파일이 있어도 강제로 덮어씁니다.
+
+### `vc schema` — 런타임 스키마 조회
+
+에이전트가 CLI 구조를 동적으로 파악할 수 있는 인트로스펙션 기능:
+
+```bash
+vc schema config --json                          # 설정 파일의 JSON Schema 반환
+vc schema commands --json                        # 모든 커맨드의 메타데이터 반환
+vc schema types --json                           # 프로젝트의 unitTypes 및 idPattern 반환
+vc schema config --output schemas/config-schema.json  # 파일로 저장
+```
+
+### `vc skill install` — SKILL 파일 설치
+
+npm 패키지에 번들된 SKILL 파일을 프로젝트에 설치:
+
+```bash
+vc skill install             # 기존 파일이 있으면 건너뜀
+vc skill install --force     # 기존 파일 덮어쓰기
+```
 
 ### 파이프 모드 (에이전트/오케스트레이터 연동)
 

package/dist/adapters/cli/formatters.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=formatters.d.ts.map

package/dist/adapters/cli/formatters.js

@@ -1,3 +0,0 @@
-export {};
-// DEPRECATED: Split into formatters-unit.ts and formatters-list.ts
-//# sourceMappingURL=formatters.js.map