@su-record/vibe 2.8.50 → 2.8.52

package/hooks/scripts/devlog-gen.js

@@ -0,0 +1,230 @@
+/**
+ * Stop Hook - 개발일지 자동 생성
+ *
+ * 매 커밋 후 카운터를 확인하여 interval(기본 10)에 도달하면
+ * LLM을 통해 개발일지를 생성하고 설정된 블로그 레포에 저장합니다.
+ *
+ * Config: .claude/vibe/config.json → devlog 섹션
+ */
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { PROJECT_DIR, readProjectConfig } from './utils.js';
+
+const DEFAULTS = {
+  targetDir: 'posts',
+  prefix: 'devlog',
+  interval: 10,
+  autoPush: false,
+  lang: 'ko',
+  category: 'dev-log',
+  tags: [],
+};
+
+function getDevlogConfig() {
+  const config = readProjectConfig();
+  const devlog = config.devlog;
+  if (!devlog || !devlog.enabled) return null;
+  if (!devlog.targetRepo) return null;
+  return { ...DEFAULTS, ...devlog };
+}
+
+function getProjectName() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(PROJECT_DIR, 'package.json'), 'utf-8'));
+    return pkg.name || path.basename(PROJECT_DIR);
+  } catch {
+    return path.basename(PROJECT_DIR);
+  }
+}
+
+function getGitAuthor() {
+  try {
+    return execSync('git config user.name', { cwd: PROJECT_DIR, encoding: 'utf-8' }).trim();
+  } catch {
+    return 'Unknown';
+  }
+}
+
+function findLastDevlogNumber(config) {
+  const dir = path.join(config.targetRepo, config.targetDir);
+  if (!fs.existsSync(dir)) return 0;
+
+  const files = fs.readdirSync(dir)
+    .filter(f => f.startsWith(config.prefix + '-') && f.endsWith('.md'))
+    .sort();
+
+  if (files.length === 0) return 0;
+
+  const last = files[files.length - 1];
+  const match = last.match(new RegExp(`${config.prefix}-(\\d+)\\.md$`));
+  return match ? parseInt(match[1], 10) : 0;
+}
+
+function findLastDevlogDate(config) {
+  const num = findLastDevlogNumber(config);
+  if (num === 0) return null;
+
+  const padded = String(num).padStart(4, '0');
+  const filePath = path.join(config.targetRepo, config.targetDir, `${config.prefix}-${padded}.md`);
+
+  try {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const dateMatch = content.match(/^date:\s*"?(\d{4}-\d{2}-\d{2})"?/m);
+    return dateMatch ? dateMatch[1] : null;
+  } catch {
+    return null;
+  }
+}
+
+function countCommitsSinceLastDevlog(config) {
+  const lastDate = findLastDevlogDate(config);
+  try {
+    const args = lastDate ? `--after="${lastDate}"` : '';
+    const log = execSync(`git log --oneline ${args}`, {
+      cwd: PROJECT_DIR,
+      encoding: 'utf-8',
+    }).trim();
+    return log ? log.split('\n').length : 0;
+  } catch {
+    return 0;
+  }
+}
+
+function getCommitsSinceLastDevlog(config) {
+  const lastDate = findLastDevlogDate(config);
+  const args = lastDate ? `--after="${lastDate}"` : '';
+  try {
+    return execSync(
+      `git log --oneline --reverse --format="%h %ad %s" --date=short ${args}`,
+      { cwd: PROJECT_DIR, encoding: 'utf-8' }
+    ).trim();
+  } catch {
+    return '';
+  }
+}
+
+function generateDevlogContent(config, commits, nextNumber) {
+  const projectName = getProjectName();
+  const author = config.author || getGitAuthor();
+  const today = new Date().toISOString().slice(0, 10);
+  const padded = String(nextNumber).padStart(4, '0');
+
+  const lines = commits.split('\n').filter(Boolean);
+  const interval = Math.min(lines.length, config.interval);
+
+  // 이번 배치의 커밋만 (최대 interval개)
+  const batch = lines.slice(0, interval);
+  const dates = batch.map(l => l.split(' ')[1]).filter(Boolean);
+  const startDate = dates[0] || today;
+  const endDate = dates[dates.length - 1] || today;
+
+  // 버전 범프 감지
+  const versions = batch
+    .map(l => l.split(' ').slice(2).join(' '))
+    .filter(msg => /^\d+\.\d+/.test(msg));
+  const startVersion = versions[0] || '';
+  const endVersion = versions[versions.length - 1] || '';
+
+  // 의미 있는 커밋 분류
+  const meaningful = batch
+    .map(l => {
+      const parts = l.split(' ');
+      return { hash: parts[0], date: parts[1], msg: parts.slice(2).join(' ') };
+    })
+    .filter(c => !/^\d+\.\d+/.test(c.msg)); // 버전 범프 제외
+
+  // 커밋 테이블 생성
+  const commitTable = meaningful.slice(0, 8).map(c => {
+    const shortMsg = c.msg.length > 60 ? c.msg.slice(0, 57) + '...' : c.msg;
+    return `| \`${shortMsg}\` | |`;
+  }).join('\n');
+
+  const versionInfo = startVersion && endVersion
+    ? `- **버전**: ${startVersion} → ${endVersion}`
+    : '';
+
+  return `---
+title: "${projectName} 개발일지 #${nextNumber} - (${interval}개 커밋)"
+date: "${today}"
+category: "${config.category}"
+description: ""
+tags: [${[projectName, ...config.tags].map(t => `"${t}"`).join(', ')}]
+author: "${author}"
+lang: "${config.lang}"
+---
+
+# ${projectName} 개발일지 #${nextNumber}
+
+**작업 기간**: ${startDate}${startDate !== endDate ? ` ~ ${endDate}` : ''}
+
+## 이번 기간 작업 내용
+
+### ${interval}개 커밋
+
+| 커밋 | 내용 |
+|------|------|
+${commitTable}
+
+## 개발 현황
+
+${versionInfo}
+
+---
+
+**다음 개발일지**: ${config.prefix}-${String(nextNumber + 1).padStart(4, '0')} (다음 ${config.interval}개 커밋 후)
+`;
+}
+
+function writeDevlog(config, content, nextNumber) {
+  const padded = String(nextNumber).padStart(4, '0');
+  const targetDir = path.join(config.targetRepo, config.targetDir);
+  const filePath = path.join(targetDir, `${config.prefix}-${padded}.md`);
+
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
+
+  fs.writeFileSync(filePath, content, 'utf-8');
+  console.log(`[DEVLOG] Generated: ${filePath}`);
+
+  if (config.autoPush) {
+    try {
+      const relPath = path.join(config.targetDir, `${config.prefix}-${padded}.md`);
+      execSync(`git add "${relPath}"`, { cwd: config.targetRepo, stdio: 'ignore' });
+      execSync(`git commit -m "post: Add ${config.prefix} #${nextNumber}"`, {
+        cwd: config.targetRepo,
+        stdio: 'ignore',
+      });
+      execSync('git push', { cwd: config.targetRepo, stdio: 'ignore' });
+      console.log(`[DEVLOG] Pushed to ${config.targetRepo}`);
+    } catch (e) {
+      console.error(`[DEVLOG] Push failed: ${e.message}`);
+    }
+  }
+}
+
+try {
+  const config = getDevlogConfig();
+  if (!config) process.exit(0);
+
+  if (!fs.existsSync(config.targetRepo)) {
+    console.error(`[DEVLOG] targetRepo not found: ${config.targetRepo}`);
+    process.exit(0);
+  }
+
+  const commitCount = countCommitsSinceLastDevlog(config);
+  if (commitCount < config.interval) {
+    process.exit(0);
+  }
+
+  const nextNumber = findLastDevlogNumber(config) + 1;
+  const commits = getCommitsSinceLastDevlog(config);
+
+  if (!commits) process.exit(0);
+
+  const content = generateDevlogContent(config, commits, nextNumber);
+  writeDevlog(config, content, nextNumber);
+} catch {
+  // devlog generation failure should never block
+}

package/package.json

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

package/skills/brand-assets/SKILL.md

@@ -17,7 +17,7 @@ Auto-generate app icons and favicons based on SPEC brand information.
 
 ## Prerequisites
 
-- Gemini API key configured (`vibe gemini auth`)
+- Gemini API key configured (`vibe gemini key <key>`)
 - SPEC with brand context (app name, colors, style)
 
 ## Generated Assets

package/skills/chub-usage/SKILL.md

@@ -19,12 +19,6 @@ Training data의 지식 컷오프 문제를 해결합니다.
 | 웹 검색 → 노이즈 섞인 결과 | chub search → 큐레이션된 문서만 |
 | 세션마다 같은 실수 반복 | chub annotate → 학습 누적 |
 
-## Prerequisites
-
-```bash
-npm install -g @aisuite/chub
-```
-
 ## When to Use
 
 | Situation | Example |
@@ -39,6 +33,8 @@ npm install -g @aisuite/chub
 ```
 외부 API/SDK 코드 작성 요청
     ↓
+Step 0: chub 설치 확인 (없으면 자동 설치)
+    ↓
 Step 1: chub search "<라이브러리명>"
     ↓
 Step 2: chub get <id> --lang ts
@@ -48,6 +44,32 @@ Step 3: 문서 기반 코드 작성
 Step 4: gotcha 발견 시 chub annotate
 ```
 
+## Step 0 — 자동 설치 (Auto-install)
+
+**스킬 실행 전 반드시 먼저 수행한다.**
+
+```bash
+# 1. chub 존재 여부 확인
+which chub || command -v chub
+```
+
+chub이 없으면 자동 설치를 시도한다:
+
+```bash
+npm install -g @aisuite/chub
+```
+
+설치 실패 시 `npx @aisuite/chub`로 대체 실행한다:
+
+```bash
+# search 예시
+npx @aisuite/chub search "stripe"
+# get 예시
+npx @aisuite/chub get stripe/api --lang ts
+```
+
+`npx`도 실패하면 context7 또는 Web Search로 폴백한다 (Fallback Chain 참조).
+
 ## Usage
 
 ### Step 1 — 문서 검색
@@ -107,9 +129,11 @@ chub search    # 인자 없이 실행하면 전체 목록 확인 가능
 ## Fallback Chain
 
 ```
-chub 설치 안 됨
+which chub 실패
+    ↓
+npm install -g @aisuite/chub (자동 시도)
     ↓
-Prompt: npm install -g @aisuite/chub
+실패 시 npx @aisuite/chub <command> (임시 실행)
     ↓
-If still unavailable: context7 또는 Web Search fallback
+npx도 실패 시 context7 또는 Web Search fallback
 ```

package/skills/devlog/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: devlog
+tier: standard
+description: "Auto-generate devlog posts from git commit history. Triggers every N commits, writes markdown to configured target repo."
+triggers: [devlog, 개발일지, dev log, devlog 작성, 개발일지 작성]
+priority: 60
+---
+# Devlog Auto-Generator
+
+Git 커밋 히스토리를 분석하여 개발일지를 자동 생성하고, 설정된 블로그 레포에 포스트로 저장합니다.
+
+## Config
+
+`.claude/vibe/config.json`의 `devlog` 섹션:
+
+```json
+{
+  "devlog": {
+    "enabled": true,
+    "targetRepo": "/absolute/path/to/blog-repo",
+    "targetDir": "posts",
+    "prefix": "devlog",
+    "interval": 10,
+    "autoPush": false,
+    "lang": "ko",
+    "author": "Su",
+    "category": "dev-log",
+    "tags": []
+  }
+}
+```
+
+| Key | Required | Default | Description |
+|-----|----------|---------|-------------|
+| `enabled` | Y | `false` | 활성화 여부 |
+| `targetRepo` | Y | — | 블로그 레포 절대 경로 |
+| `targetDir` | N | `"posts"` | 포스트 저장 디렉토리 |
+| `prefix` | N | `"devlog"` | 파일명 프리픽스 (`{prefix}-{NNNN}.md`) |
+| `interval` | N | `10` | 몇 커밋마다 생성할지 |
+| `autoPush` | N | `false` | targetRepo에 자동 commit+push |
+| `lang` | N | `"ko"` | 작성 언어 |
+| `author` | N | git user.name | 작성자 |
+| `category` | N | `"dev-log"` | frontmatter category |
+| `tags` | N | `[]` | 기본 태그 (프로젝트명 등 자동 추가) |
+
+## Trigger Modes
+
+### 1. Auto (post-commit hook)
+
+`devlog-gen.js` hook이 매 커밋마다 카운터를 확인하고, `interval`에 도달하면 `llm-orchestrate.js`를 통해 개발일지를 생성합니다.
+
+### 2. Manual
+
+사용자가 직접 `/devlog` 또는 `개발일지 작성` 키워드로 트리거. 마지막 개발일지 이후의 커밋을 모아 즉시 생성합니다.
+
+## Generation Process
+
+### Step 1: Collect Commits
+
+마지막 개발일지의 날짜 이후 커밋을 수집합니다:
+
+```bash
+# 마지막 devlog 파일에서 날짜 추출
+# targetRepo/targetDir/{prefix}-NNNN.md 의 frontmatter date
+git log --oneline --after="{last_date}" --reverse
+```
+
+### Step 2: Analyze & Group
+
+- 버전 범프 커밋 식별 (X.Y.Z 패턴)
+- feat/fix/refactor/docs 분류
+- 주요 커밋 선별 (의미 있는 변경)
+
+### Step 3: Generate Markdown
+
+다음 frontmatter 포맷으로 생성:
+
+```markdown
+---
+title: "{project_name} 개발일지 #{next_number} - {summary_title} ({interval}개 커밋)"
+date: "{today}"
+category: "{category}"
+description: "{one_line_description}"
+tags: [{project_tags}, {auto_detected_tags}]
+author: "{author}"
+lang: "{lang}"
+---
+
+# {title}
+
+**작업 기간**: {start_date} ~ {end_date}
+
+## 이번 기간 작업 내용
+
+### {theme} ({interval}개 커밋)
+
+{overview_paragraph}
+
+| 커밋 | 내용 |
+|------|------|
+| `{meaningful_commit_message}` | **{highlight}** |
+...
+
+## 작업 하이라이트
+
+{2-3 highlights with code blocks or diagrams}
+
+## 개발 현황
+
+- **버전**: {start_version} → {end_version}
+- **핵심**: {key_changes}
+
+---
+
+**다음 개발일지**: {prefix}-{next+1} (다음 {interval}개 커밋 후)
+```
+
+### Step 4: Write File
+
+```
+{targetRepo}/{targetDir}/{prefix}-{NNNN}.md
+```
+
+번호는 기존 파일에서 마지막 번호 + 1로 자동 결정.
+
+### Step 5: (Optional) Auto Push
+
+`autoPush: true`이면:
+
+```bash
+cd {targetRepo}
+git add {targetDir}/{prefix}-{NNNN}.md
+git commit -m "post: Add {prefix} #{NNNN}"
+git push
+```
+
+## Rules
+
+- **커밋 메시지 원문 보존** — 커밋 메시지를 그대로 인용, 임의 변경 금지
+- **버전 범프 커밋 포함** — 테이블에는 포함하되 하이라이트에서 제외
+- **하이라이트는 최대 3개** — 가장 영향력 있는 변경만 선별
+- **코드 블록 활용** — Before/After 비교, 아키텍처 다이어그램 권장
+- **숫자 강조** — 줄 수 변화(-N줄), 버전 범위, 파일 수 등