@su-record/vibe 3.2.52 → 3.2.54

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vibe",
   "displayName": "Vibe",
-  "version": "3.2.52",
+  "version": "3.2.54",
   "description": "Verification harness for AI coding agents — \"done\" is decided by deterministic gates (test exit codes, run-ledger, regression memory), not the model self-report.",
   "author": {
     "name": "su-record",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe",
-  "version": "3.2.52",
+  "version": "3.2.54",
   "description": "Verification harness for AI coding agents — \"done\" is decided by deterministic gates (test exit codes, run-ledger, regression memory), not the model self-report.",
   "author": {
     "name": "su-record",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "3.2.52",
+  "version": "3.2.54",
   "description": "AI Coding Framework for Claude Code — 7+ agents, 52 skills, multi-LLM orchestration",
   "type": "module",
   "main": "dist/cli/index.js",

package/skills/vibe.review/references/worked-examples.md

@@ -78,13 +78,13 @@ Examples:
 **1. Validate code quality before review:**
 
 ```bash
-node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => t.validateCodeQuality({targetPath: 'src/', projectPath: process.cwd()}).then(r => console.log(r.content[0].text)))"
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/convention/index.js').then(t => t.validateCodeQuality({targetPath: 'src/', projectPath: process.cwd()}).then(r => console.log(r.content[0].text)))"
 ```
 
 **2. Analyze complexity of changed files:**
 
 ```bash
-node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => t.analyzeComplexity({targetPath: 'src/api/users.ts', projectPath: process.cwd()}).then(r => console.log(r.content[0].text)))"
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/convention/index.js').then(t => t.analyzeComplexity({targetPath: 'src/api/users.ts', projectPath: process.cwd()}).then(r => console.log(r.content[0].text)))"
 ```
 
 **3. Save critical finding for reference:**

package/skills/vibe.run/references/coverage-loop.md

@@ -40,7 +40,7 @@ max_iterations(기본 10) 도달 → 잔여 인박스 이월
 ## RTM 생성
 
 ```bash
-node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const r = t.generateTraceabilityMatrix('{feature-name}', {projectPath: process.cwd()}); console.log(JSON.stringify(r, null, 2)); })"
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/spec/index.js').then(t => { const r = t.generateTraceabilityMatrix('{feature-name}', {projectPath: process.cwd()}); console.log(JSON.stringify(r, null, 2)); })"
 ```
 
 `generateTraceabilityMatrix` 는 동기 함수다 — 반환값에 `.then()` 을 쓰지 않는다.

package/skills/vibe.run/references/process-steps.md

@@ -24,7 +24,7 @@ Step 3: If neither → Error: "Run /vibe.spec first"
 For a monolithic SPEC, compile it after resolving the canonical path. For a split SPEC, do not compile `_index.md`; defer this step until each active phase file is loaded in Phase Isolation Step B. Compile with `writeExecutionPacket`, then immediately verify the saved artifact with `validateExecutionPacket`.
 
 ```bash
-node -e "import('file://{{VIBE_PATH}}/dist/tools/index.js').then(t => {
+node -e "import('file://{{VIBE_PATH}}/dist/tools/spec/index.js').then(t => {
   const projectPath=process.cwd(), specPath='.vibe/specs/{feature-name}.md';
   const profile='{codex-or-claude-code}';
   const written=t.writeExecutionPacket({projectPath,specPath,profile});
@@ -168,7 +168,7 @@ After ALL phases complete:
 
 ```bash
 # generateTraceabilityMatrix is synchronous — no .then()
-node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const r = t.generateTraceabilityMatrix('{feature-name}', {projectPath: process.cwd()}); console.log(JSON.stringify(r, null, 2)); })"
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/spec/index.js').then(t => { const r = t.generateTraceabilityMatrix('{feature-name}', {projectPath: process.cwd()}); console.log(JSON.stringify(r, null, 2)); })"
 ```
 
 > Default SPEC path is `.vibe/specs/<feature>.md`. `status === 'empty'` must be treated as failed/not-applicable — never as 100% pass.

package/skills/vibe.spec/SKILL.md

@@ -67,12 +67,31 @@ Legacy `.vibe/interviews/` or `.vibe/plans/` artifacts가 실제로 감지된
 - 개인 작업 포인터이므로 git 커밋 금지 (`.gitignore` 에 `.vibe/.last-feature`).
 - 워크플로 완주(verify 통과) 시 삭제.
 
+## 구조 다이어그램 (조건부, 승인 전)
+
+**경계가 바뀌는 SPEC 에만** 붙인다. 셋 중 하나라도 해당할 때:
+
+1. 새 모듈·서비스 **경계** 도입
+2. **데이터 흐름** 변경 (읽고 쓰는 주체나 순서)
+3. **3개 이상 모듈** 횡단
+
+해당하면 `vibe.docs` 의 `references/diagram-spec.md` 를 읽어 그 규범대로 Mermaid 를
+그리고 SPEC 의 `### Structure` 절에 넣는다. **규범을 여기에 복사하지 않는다** — 코드
+근거·노드 상한·간선 라벨 규칙은 그쪽이 SSOT 다.
+
+왜 승인 **전**인가: 구현이 끝난 뒤 diff 에서 구조적 오해를 발견하면 수정 범위가
+커진다. 산문 SPEC 은 "박스가 빠졌다 / 화살표가 거꾸로다" 를 숨기지만 그림은 드러낸다.
+
+왜 **조건부**인가: 해당 없는 기능에까지 강제하면 비용만 오르고 통과 의식이 된다.
+그리고 시각적 완성도는 정확성을 착각하게 만든다 — 그릴 이유가 없으면 그리지 않는 편이
+낫다. 트리거에 걸리지 않으면 절을 지우고 넘어간다.
+
 ## SPEC Code Guard (승인 전 의무)
 
 SPEC 을 쓴 직후, **승인을 요청하기 전에** 실행한다. 셀프 리뷰가 아니라 코드 판정이다:
 
 ```bash
-node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const fs=require('fs'); const p='.vibe/specs/{feature-name}.md'; const r=t.validateSpecDocument(fs.readFileSync(p,'utf-8'),{specPath:p}); console.log(t.formatSpecValidation(r)); process.exitCode = r.valid ? 0 : 1; })"
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/spec/index.js').then(t => { const fs=require('fs'); const p='.vibe/specs/{feature-name}.md'; const r=t.validateSpecDocument(fs.readFileSync(p,'utf-8'),{specPath:p}); console.log(t.formatSpecValidation(r)); process.exitCode = r.valid ? 0 : 1; })"
 ```
 
 | 검사 | 심각도 | 왜 하류가 깨지는가 |

package/skills/vibe.verify/references/trace-mode.md

@@ -188,10 +188,10 @@ The RTM generation uses core tools:
 
 ```bash
 # Generate RTM (generateTraceabilityMatrix is synchronous — no .then())
-node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const m = t.generateTraceabilityMatrix('login', {projectPath: process.cwd()}); console.log(t.formatMatrixAsMarkdown(m)); })"
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/spec/index.js').then(t => { const m = t.generateTraceabilityMatrix('login', {projectPath: process.cwd()}); console.log(t.formatMatrixAsMarkdown(m)); })"
 
 # Generate HTML
-node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const m = t.generateTraceabilityMatrix('login', {projectPath: process.cwd()}); console.log(t.formatMatrixAsHtml(m)); })"
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/spec/index.js').then(t => { const m = t.generateTraceabilityMatrix('login', {projectPath: process.cwd()}); console.log(t.formatMatrixAsHtml(m)); })"
 ```
 
 > **Note:** Default SPEC path is `.vibe/specs/<feature>.md` (falls back to `.claude/vibe/specs/` then `.claude/specs/` for legacy projects).

package/vibe/templates/spec-template.md

@@ -23,6 +23,26 @@
 
 - {Invariant or implementation boundary that every execution packet must preserve}
 
+### Structure (경계가 바뀔 때만)
+
+> 아래 셋 중 **하나라도** 해당하면 채운다. 아니면 이 절을 통째로 지운다 —
+> 해당 없는데 그려두면 통과 의식이 되고, 시각적 완성도가 정확성을 착각하게 만든다.
+>
+> 1. 새 모듈·서비스 **경계**를 만든다
+> 2. **데이터 흐름**이 바뀐다 (읽고 쓰는 주체나 순서)
+> 3. **3개 이상 모듈**을 횡단한다
+>
+> 규범은 `vibe.docs` 의 `references/diagram-spec.md` 를 따른다 — 코드에서 확인한
+> 것만 그리고, 확인 못 한 요소는 뺀다. 여기에 다시 적지 않는다(SSOT).
+>
+> 목적은 설명이 아니라 **리뷰 표면**이다. 산문으로는 "박스가 빠졌다 / 화살표가
+> 거꾸로다" 가 안 보이지만 그림에서는 승인 전에 보인다.
+
+```mermaid
+graph TB
+  {노드와 간선 — 각 노드 옆에 근거 파일 경로를 주석으로}
+```
+
 ### Rejected Alternatives (Traps)
 
 > Approaches considered and rejected, each with a mechanistic reason — so the loop never revisits a dead end. Omit only when no real design choice existed (or on demo/prototype stakes).