@su-record/vibe 2.7.10 → 2.7.12

package/package.json

@@ -1,121 +1,121 @@
-{
-  "name": "@su-record/vibe",
-  "version": "2.7.10",
-  "description": "AI Coding Framework for Claude Code — 49 agents, 41+ tools, multi-LLM orchestration",
-  "type": "module",
-  "main": "dist/cli/index.js",
-  "exports": {
-    ".": "./dist/cli/index.js",
-    "./agent": {
-      "types": "./dist/agent/index.d.ts",
-      "default": "./dist/agent/index.js"
-    },
-    "./tools": "./dist/tools/index.js",
-    "./tools/memory": "./dist/tools/memory/index.js",
-    "./tools/convention": "./dist/tools/convention/index.js",
-    "./tools/semantic": "./dist/tools/semantic/index.js",
-    "./tools/ui": "./dist/tools/ui/index.js",
-    "./tools/time": "./dist/tools/time/index.js",
-    "./tools/interaction": "./dist/tools/interaction/index.js",
-    "./orchestrator": "./dist/infra/orchestrator/index.js",
-    "./interface": {
-      "types": "./dist/interface/index.d.ts",
-      "default": "./dist/interface/index.js"
-    },
-    "./router": {
-      "types": "./dist/router/index.d.ts",
-      "default": "./dist/router/index.js"
-    },
-    "./memory": {
-      "types": "./dist/infra/lib/memory/index.d.ts",
-      "default": "./dist/infra/lib/memory/index.js"
-    },
-    "./policy": {
-      "types": "./dist/infra/policy/index.d.ts",
-      "default": "./dist/infra/policy/index.js"
-    },
-    "./lib/gpt": "./dist/infra/lib/gpt-api.js",
-    "./lib/gemini": "./dist/infra/lib/gemini-api.js"
-  },
-  "bin": {
-    "vibe": "dist/cli/index.js"
-  },
-  "scripts": {
-    "build": "tsc && chmod +x dist/cli/index.js",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build",
-    "postinstall": "node -e \"import('./dist/cli/postinstall/main.js').then(m=>m.main()).catch(()=>{})\"",
-    "release": "pnpm version patch && npm publish --access public"
-  },
-  "keywords": [
-    "ai",
-    "core",
-    "coding",
-    "spec-driven",
-    "claude",
-    "agent",
-    "requirements",
-    "user-story",
-    "ultrawork",
-    "parallel-agents",
-    "memory-management",
-    "knowledge-graph",
-    "code-analysis",
-    "code-quality"
-  ],
-  "author": "Su",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/su-record/vibe.git"
-  },
-  "homepage": "https://github.com/su-record/vibe#readme",
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "optionalDependencies": {
-    "@ast-grep/napi": "^0.40.5"
-  },
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.6",
-    "@clack/prompts": "^1.0.0",
-    "better-sqlite3": "^12.6.2",
-    "chalk": "^5.3.0",
-    "glob": "^13.0.1",
-    "node-cron": "^3.0.3",
-    "papaparse": "^5.5.3",
-    "playwright": "^1.58.2",
-    "ts-morph": "^26.0.0",
-    "uuidv7": "^1.1.0",
-    "vscode-languageserver-protocol": "^3.17.5",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^22.0.0",
-    "@types/node-cron": "^3.0.11",
-    "@types/papaparse": "^5.5.2",
-    "ajv": "^8.17.1",
-    "typescript": "^5.5.4",
-    "vitest": "^4.0.9"
-  },
-  "files": [
-    "dist/",
-    "vibe/",
-    "languages/",
-    "commands/",
-    "agents/",
-    "skills/",
-    "hooks/",
-    ".env.example",
-    ".env",
-    "CLAUDE.md",
-    "README.md",
-    "LICENSE"
-  ]
-}
+{
+  "name": "@su-record/vibe",
+  "version": "2.7.12",
+  "description": "AI Coding Framework for Claude Code — 49 agents, 41+ tools, multi-LLM orchestration",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "exports": {
+    ".": "./dist/cli/index.js",
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "default": "./dist/agent/index.js"
+    },
+    "./tools": "./dist/tools/index.js",
+    "./tools/memory": "./dist/tools/memory/index.js",
+    "./tools/convention": "./dist/tools/convention/index.js",
+    "./tools/semantic": "./dist/tools/semantic/index.js",
+    "./tools/ui": "./dist/tools/ui/index.js",
+    "./tools/time": "./dist/tools/time/index.js",
+    "./tools/interaction": "./dist/tools/interaction/index.js",
+    "./orchestrator": "./dist/infra/orchestrator/index.js",
+    "./interface": {
+      "types": "./dist/interface/index.d.ts",
+      "default": "./dist/interface/index.js"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.ts",
+      "default": "./dist/router/index.js"
+    },
+    "./memory": {
+      "types": "./dist/infra/lib/memory/index.d.ts",
+      "default": "./dist/infra/lib/memory/index.js"
+    },
+    "./policy": {
+      "types": "./dist/infra/policy/index.d.ts",
+      "default": "./dist/infra/policy/index.js"
+    },
+    "./lib/gpt": "./dist/infra/lib/gpt-api.js",
+    "./lib/gemini": "./dist/infra/lib/gemini-api.js"
+  },
+  "bin": {
+    "vibe": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm build",
+    "postinstall": "node -e \"import('./dist/cli/postinstall/main.js').then(m=>m.main()).catch(()=>{})\"",
+    "release": "pnpm version patch && npm publish --access public"
+  },
+  "keywords": [
+    "ai",
+    "core",
+    "coding",
+    "spec-driven",
+    "claude",
+    "agent",
+    "requirements",
+    "user-story",
+    "ultrawork",
+    "parallel-agents",
+    "memory-management",
+    "knowledge-graph",
+    "code-analysis",
+    "code-quality"
+  ],
+  "author": "Su",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/su-record/vibe.git"
+  },
+  "homepage": "https://github.com/su-record/vibe#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "optionalDependencies": {
+    "@ast-grep/napi": "^0.40.5"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.6",
+    "@clack/prompts": "^1.0.0",
+    "better-sqlite3": "^12.6.2",
+    "chalk": "^5.3.0",
+    "glob": "^13.0.1",
+    "node-cron": "^3.0.3",
+    "papaparse": "^5.5.3",
+    "playwright": "^1.58.2",
+    "ts-morph": "^26.0.0",
+    "uuidv7": "^1.1.0",
+    "vscode-languageserver-protocol": "^3.17.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.0.0",
+    "@types/node-cron": "^3.0.11",
+    "@types/papaparse": "^5.5.2",
+    "ajv": "^8.17.1",
+    "typescript": "^5.5.4",
+    "vitest": "^4.0.9"
+  },
+  "files": [
+    "dist/",
+    "vibe/",
+    "languages/",
+    "commands/",
+    "agents/",
+    "skills/",
+    "hooks/",
+    ".env.example",
+    ".env",
+    "CLAUDE.md",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/skills/agents-md/SKILL.md

@@ -1,120 +1,120 @@
----
-name: agents-md
-description: "Optimize AGENTS.md / CLAUDE.md by removing discoverable info and keeping only gotchas. Based on Addy Osmani's AGENTS.md principles. Activates on agents.md, claude.md, context file optimization."
-triggers: [agents.md, claude.md, context file, optimize agents, optimize claude]
-priority: 50
----
-
-# agents-md — Context File Optimizer
-
-AGENTS.md / CLAUDE.md를 최적화한다.
-근거: https://addyosmani.com/blog/agents-md/
-
-## 핵심 원칙
-
-**한 줄 테스트**: "에이전트가 코드를 읽어서 스스로 알 수 있는가?" → Yes면 삭제.
-
-## Step 1: 대상 파일 찾기
-
-프로젝트 루트에서 다음 파일을 탐색한다:
-
-```
-Glob: pattern="AGENTS.md"
-Glob: pattern="CLAUDE.md"
-Glob: pattern=".cursorrules"
-Glob: pattern=".github/copilot-instructions.md"
-Glob: pattern=".windsurfrules"
-```
-
-대상 파일이 없으면 새로 생성할지 사용자에게 확인한다.
-
-## Step 2: 현재 내용 분류
-
-파일의 각 항목을 다음 기준으로 분류한다:
-
-### 삭제 (Discoverable)
-
-에이전트가 코드 탐색으로 발견 가능한 정보:
-
-| 유형 | 예시 | 발견 경로 |
-|------|------|----------|
-| 디렉토리 구조 | "src/에 컴포넌트가 있다" | `ls`, `Glob` |
-| 기술 스택 | "React + TypeScript 사용" | `package.json`, 파일 확장자 |
-| Phase/진행 테이블 | "Phase 1 ✅, Phase 2 ✅..." | 이력일 뿐, 행동 지침 아님 |
-| 빌드/테스트 커맨드 | "npm test로 테스트 실행" | `package.json` scripts |
-| API 엔드포인트 목록 | "POST /api/users" | 라우터 코드 |
-| 기능별 상세 설명 | "Phase 3에서 서킷브레이커 구현" | 해당 코드 읽으면 파악 가능 |
-| 아키텍처 다이어그램 | ASCII 박스 다이어그램 | 개념적 설명, 실수 방지 효과 없음 |
-
-### 유지 (Non-discoverable)
-
-에이전트가 코드만으로 알 수 없는 함정과 규칙:
-
-| 유형 | 예시 |
-|------|------|
-| 런타임 함정 | "Bun이다, Node가 아니다" (package.json에 명시 안 됨) |
-| 금지 패턴 | "require() 쓰지 말 것", "React 패턴 금지" |
-| SSOT 위치 | "model-registry.ts만 수정할 것, 하드코딩 금지" |
-| 불변 순서/규칙 | "우선순위: A → B → C, 이 순서 변경 금지" |
-| 재시도/폴백 제한 | "최대 2회, 3회 이상 금지" |
-| 도구 선택 | "Zod만 사용, joi/yup 금지" |
-| 네이밍 컨벤션 | 비표준 패턴 (표준이면 삭제) |
-| 프로젝트 한 줄 소개 | 코드만으로 목적 파악 어려운 경우 |
-| 언어/응답 지시 | "한글로 답변" 같은 선호 |
-
-### 앵커링 주의
-
-기술 이름을 언급하면 에이전트가 해당 기술로 편향된다. "무엇을 쓰지 말라"는 유용하지만, "우리는 X를 쓴다"는 코드에서 이미 보인다면 불필요.
-
-## Step 3: 재구성
-
-다음 구조로 재작성한다:
-
-```markdown
-# {프로젝트명} — {한 줄 소개}
-
-{프로젝트가 무엇을 하는지 1-2문장. 코드만으로 목적 파악이 어려운 경우에만.}
-
-# Gotchas
-
-- **{함정 제목}.** {구체적 금지/규칙 설명}.
-- ...
-
-# Naming
-
-{비표준 네이밍 패턴이 있을 때만. 표준(camelCase 등)이면 생략.}
-```
-
-규칙:
-- 섹션은 최대 3개 (소개, Gotchas, Naming)
-- Gotchas 항목은 각각 **볼드 제목 + 구체적 do/don't**
-- "~를 사용한다" 보다 "~를 쓰지 말 것"이 더 유용
-- 전체 50줄 이내 목표
-
-## Step 4: CLAUDE.md 분리 (해당 시)
-
-CLAUDE.md가 존재하면 Claude 전용 지시만 남긴다:
-
-```markdown
-{Claude 전용 지시. 예: "답변은 반드시 한글로 답변할 것."}
-```
-
-공통 규칙은 AGENTS.md에 둔다. Claude Code는 둘 다 읽는다.
-
-## Step 5: 결과 보고
-
-```markdown
-## AGENTS.md 최적화 결과
-
-| 지표 | Before | After |
-|------|--------|-------|
-| 줄 수 | N | N |
-| 삭제 항목 | - | N개 (discoverable) |
-| 유지 항목 | - | N개 (gotchas) |
-
-### 삭제된 항목
-- {항목}: {삭제 이유}
-
-### 유지/추가된 항목
-- {항목}: {유지 이유}
-```
+---
+name: agents-md
+description: "Optimize AGENTS.md / CLAUDE.md by removing discoverable info and keeping only gotchas. Based on Addy Osmani's AGENTS.md principles. Activates on agents.md, claude.md, context file optimization."
+triggers: [agents.md, claude.md, context file, optimize agents, optimize claude]
+priority: 50
+---
+
+# agents-md — Context File Optimizer
+
+AGENTS.md / CLAUDE.md를 최적화한다.
+근거: https://addyosmani.com/blog/agents-md/
+
+## 핵심 원칙
+
+**한 줄 테스트**: "에이전트가 코드를 읽어서 스스로 알 수 있는가?" → Yes면 삭제.
+
+## Step 1: 대상 파일 찾기
+
+프로젝트 루트에서 다음 파일을 탐색한다:
+
+```
+Glob: pattern="AGENTS.md"
+Glob: pattern="CLAUDE.md"
+Glob: pattern=".cursorrules"
+Glob: pattern=".github/copilot-instructions.md"
+Glob: pattern=".windsurfrules"
+```
+
+대상 파일이 없으면 새로 생성할지 사용자에게 확인한다.
+
+## Step 2: 현재 내용 분류
+
+파일의 각 항목을 다음 기준으로 분류한다:
+
+### 삭제 (Discoverable)
+
+에이전트가 코드 탐색으로 발견 가능한 정보:
+
+| 유형 | 예시 | 발견 경로 |
+|------|------|----------|
+| 디렉토리 구조 | "src/에 컴포넌트가 있다" | `ls`, `Glob` |
+| 기술 스택 | "React + TypeScript 사용" | `package.json`, 파일 확장자 |
+| Phase/진행 테이블 | "Phase 1 ✅, Phase 2 ✅..." | 이력일 뿐, 행동 지침 아님 |
+| 빌드/테스트 커맨드 | "npm test로 테스트 실행" | `package.json` scripts |
+| API 엔드포인트 목록 | "POST /api/users" | 라우터 코드 |
+| 기능별 상세 설명 | "Phase 3에서 서킷브레이커 구현" | 해당 코드 읽으면 파악 가능 |
+| 아키텍처 다이어그램 | ASCII 박스 다이어그램 | 개념적 설명, 실수 방지 효과 없음 |
+
+### 유지 (Non-discoverable)
+
+에이전트가 코드만으로 알 수 없는 함정과 규칙:
+
+| 유형 | 예시 |
+|------|------|
+| 런타임 함정 | "Bun이다, Node가 아니다" (package.json에 명시 안 됨) |
+| 금지 패턴 | "require() 쓰지 말 것", "React 패턴 금지" |
+| SSOT 위치 | "model-registry.ts만 수정할 것, 하드코딩 금지" |
+| 불변 순서/규칙 | "우선순위: A → B → C, 이 순서 변경 금지" |
+| 재시도/폴백 제한 | "최대 2회, 3회 이상 금지" |
+| 도구 선택 | "Zod만 사용, joi/yup 금지" |
+| 네이밍 컨벤션 | 비표준 패턴 (표준이면 삭제) |
+| 프로젝트 한 줄 소개 | 코드만으로 목적 파악 어려운 경우 |
+| 언어/응답 지시 | "한글로 답변" 같은 선호 |
+
+### 앵커링 주의
+
+기술 이름을 언급하면 에이전트가 해당 기술로 편향된다. "무엇을 쓰지 말라"는 유용하지만, "우리는 X를 쓴다"는 코드에서 이미 보인다면 불필요.
+
+## Step 3: 재구성
+
+다음 구조로 재작성한다:
+
+```markdown
+# {프로젝트명} — {한 줄 소개}
+
+{프로젝트가 무엇을 하는지 1-2문장. 코드만으로 목적 파악이 어려운 경우에만.}
+
+# Gotchas
+
+- **{함정 제목}.** {구체적 금지/규칙 설명}.
+- ...
+
+# Naming
+
+{비표준 네이밍 패턴이 있을 때만. 표준(camelCase 등)이면 생략.}
+```
+
+규칙:
+- 섹션은 최대 3개 (소개, Gotchas, Naming)
+- Gotchas 항목은 각각 **볼드 제목 + 구체적 do/don't**
+- "~를 사용한다" 보다 "~를 쓰지 말 것"이 더 유용
+- 전체 50줄 이내 목표
+
+## Step 4: CLAUDE.md 분리 (해당 시)
+
+CLAUDE.md가 존재하면 Claude 전용 지시만 남긴다:
+
+```markdown
+{Claude 전용 지시. 예: "답변은 반드시 한글로 답변할 것."}
+```
+
+공통 규칙은 AGENTS.md에 둔다. Claude Code는 둘 다 읽는다.
+
+## Step 5: 결과 보고
+
+```markdown
+## AGENTS.md 최적화 결과
+
+| 지표 | Before | After |
+|------|--------|-------|
+| 줄 수 | N | N |
+| 삭제 항목 | - | N개 (discoverable) |
+| 유지 항목 | - | N개 (gotchas) |
+
+### 삭제된 항목
+- {항목}: {삭제 이유}
+
+### 유지/추가된 항목
+- {항목}: {유지 이유}
+```

package/skills/arch-guard/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: arch-guard
+description: "Generate architecture boundary tests that mechanically enforce layer constraints."
+triggers: [arch guard, architecture test, layer test, boundary test, structural test, arch validation]
+priority: 60
+---
+
+# Arch Guard — Architecture Boundary Test Generator
+
+> **Principle**: "Mechanical enforcement over documentation." If a rule exists only in docs, it will be violated. Turn architecture constraints into failing tests.
+
+## When to Use
+
+| Scenario | Signal |
+|----------|--------|
+| `vibe init` / `vibe update` | Auto-generate for detected stack |
+| New layer/module added | Boundaries need enforcement |
+| Architecture violation found in review | Prevent recurrence with test |
+| "Services should not import UI" type rules | Turn into automated check |
+
+## Core Flow
+
+```
+DETECT → INFER → GENERATE → VERIFY
+```
+
+### Step 1: DETECT — Identify Project Architecture
+
+Analyze the project to determine its layer structure:
+
+```
+Parallel exploration:
+- Agent 1: Scan directory structure (src/, app/, lib/, etc.)
+- Agent 2: Read existing architecture docs (CLAUDE.md, README, ADR)
+- Agent 3: Analyze import graph (which files import what)
+```
+
+**Common patterns to detect:**
+
+| Pattern | Layers | Typical Stacks |
+|---------|--------|----------------|
+| MVC | Controller → Service → Model | Rails, NestJS, Spring |
+| Clean Architecture | UI → Application → Domain → Infrastructure | General |
+| Feature-based | Feature A ↛ Feature B internals | Next.js, React |
+| Hexagonal | Adapters → Ports → Domain | DDD projects |
+| Component hierarchy | Page → Feature → Shared → UI Primitives | Frontend |
+
+### Step 2: INFER — Define Boundary Rules
+
+From detected structure, generate rules:
+
+```typescript
+// Rule format
+interface ArchRule {
+  name: string;           // "service-no-ui-import"
+  from: string;           // Glob pattern: "src/services/**"
+  cannotImport: string[]; // ["src/components/**", "src/pages/**"]
+  canImport: string[];    // ["src/models/**", "src/utils/**"]
+  reason: string;         // "Services must be UI-agnostic"
+}
+```
+
+**Default rules by stack:**
+
+| Stack | Rule |
+|-------|------|
+| Next.js / React | `components/` cannot import from `pages/` or `app/` |
+| Next.js / React | `lib/` cannot import from `components/` |
+| NestJS | `*.service.ts` cannot import from `*.controller.ts` |
+| NestJS | `*.module.ts` is the only valid cross-boundary import |
+| General TS | `src/domain/` cannot import from `src/infra/` |
+| General TS | No circular dependencies between top-level dirs |
+| Python Django | `models.py` cannot import from `views.py` |
+| Python FastAPI | `schemas/` cannot import from `routers/` |
+
+### Step 3: GENERATE — Create Test File
+
+Output: `tests/arch-guard.test.ts` (or equivalent for stack)
+
+```typescript
+/**
+ * Architecture Boundary Tests
+ * Generated by arch-guard skill
+ *
+ * These tests enforce architectural constraints mechanically.
+ * If a test fails, it means an import violates the intended architecture.
+ */
+import { describe, it, expect } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+
+// Helper: extract imports from a file
+function extractImports(filePath: string): string[] {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const importRegex = /(?:import|require)\s*\(?['"]([^'"]+)['"]\)?/g;
+  const imports: string[] = [];
+  let match;
+  while ((match = importRegex.exec(content)) !== null) {
+    imports.push(match[1]);
+  }
+  return imports;
+}
+
+// Helper: resolve relative import to absolute path
+function resolveImport(fromFile: string, importPath: string): string {
+  if (importPath.startsWith('.')) {
+    return path.resolve(path.dirname(fromFile), importPath);
+  }
+  return importPath; // external package
+}
+
+// Helper: glob files matching pattern
+function globFiles(pattern: string, baseDir: string): string[] {
+  // Use fast-glob or manual recursive scan
+  // Implementation depends on available dependencies
+}
+
+describe('Architecture Boundaries', () => {
+  // GENERATED RULES GO HERE
+  // Each rule becomes a test case:
+
+  it('services cannot import UI components', () => {
+    const serviceFiles = globFiles('src/services/**/*.ts', process.cwd());
+    const violations: string[] = [];
+
+    for (const file of serviceFiles) {
+      const imports = extractImports(file);
+      for (const imp of imports) {
+        const resolved = resolveImport(file, imp);
+        if (resolved.includes('/components/') || resolved.includes('/pages/')) {
+          violations.push(`${file} imports ${imp}`);
+        }
+      }
+    }
+
+    expect(violations).toEqual([]);
+  });
+});
+```
+
+### Step 4: VERIFY — Run and Fix
+
+1. Run the generated tests: `npx vitest run tests/arch-guard.test.ts`
+2. If violations found:
+   - Report each violation with file:line
+   - Suggest fix (move shared code to appropriate layer)
+   - Do NOT auto-fix — violations need human review
+
+## Output Files
+
+| File | Purpose |
+|------|---------|
+| `tests/arch-guard.test.ts` | Executable boundary tests |
+| `.claude/vibe/arch-rules.json` | Machine-readable rules (for CI) |
+
+## Customization
+
+Users can add custom rules to `.claude/vibe/arch-rules.json`:
+
+```json
+{
+  "rules": [
+    {
+      "name": "no-direct-db-in-handlers",
+      "from": "src/handlers/**",
+      "cannotImport": ["src/db/**"],
+      "reason": "Handlers must use services, not direct DB access"
+    }
+  ]
+}
+```
+
+The test generator reads this file and adds custom rules to the test suite.
+
+## Integration
+
+- `vibe init` → auto-detect and generate initial arch-guard tests
+- `vibe update` → refresh rules if directory structure changed
+- Pre-commit hook → run arch-guard tests before commit
+- `/vibe.review` → architecture-reviewer checks against arch-rules.json