@byh3071/vhk 1.4.0 → 1.5.1

package/README.md

@@ -1,12 +1,13 @@
 ---
 id: vhk-readme
 date: 2026-05-28
-tags: [vhk, cli, readme, v1.4.0, ga]
+tags: [vhk, cli, readme, v1.5.1, ga]
 ---
 
 # 🔧 VHK — Vibe Harness Kit
 
-> 🎉 **v1.4.0** — 바이브코더의 올인원 CLI. 컨텍스트 + 자율 하네스 + 포터빌리티.
+> 🎉 **v1.5.1** — **규칙은 한 벌로 Cursor·Claude·Windsurf·Copilot·Antigravity에, 맥락은 클라우드로.**
+> 도구·기기를 옮겨도 `vhk` 명령으로 그대로 불러옵니다. (포터빌리티)
 >
 > AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI**.
 >
@@ -14,6 +15,20 @@ tags: [vhk, cli, readme, v1.4.0, ga]
 
 명령어를 외우지 않아도 됩니다. `vhk`만 치면 메뉴가 나오고, 한국어로 말해도 알아듣습니다.
 
+## 왜 VHK? — 포터빌리티
+
+AI 코딩 도구는 저마다 규칙 파일이 다르고(`.cursorrules`·`CLAUDE.md`·`.windsurfrules`·`.github/copilot-instructions.md`·`.agents/rules/`…), 컴퓨터를 바꾸면 프로젝트 맥락을 처음부터 다시 모읍니다. VHK는 이 둘을 한 곳에서 관리합니다.
+
+| 문제 | VHK 해결 | 명령 |
+|------|----------|------|
+| 도구마다 규칙 파일이 따로 논다 | `RULES.md` 한 벌 → Cursor·Claude·Windsurf·Copilot·Antigravity 규칙 동시 생성 | `vhk sync` |
+| 컴퓨터·환경 바뀌면 맥락 유실 | `.vhk/` 맥락을 GitHub gist로 백업·복원 | `vhk cloud push` / `pull` |
+| 새 프로젝트 세팅 반복 | 유형별 문서·규칙·맥락 뼈대를 한 번에 | `vhk init` |
+
+> 규칙·맥락은 **자동이 아니라 명령으로** 동기화됩니다(한 줄이면 충분). 개인 메모(`memory.json`)·참고링크(`refs.json`)는 프라이버시 위해 기본 제외, 새 PC의 코드 자체는 `git clone` 으로 받습니다.
+>
+> ℹ️ Windsurf·Copilot·Antigravity 출력 경로·포맷은 각 도구의 **공식 문서 기준**으로 생성합니다(`.windsurfrules` · `.github/copilot-instructions.md` · `.agents/rules/`). Antigravity 는 파일당 12,000자 제한이 있어 초과 시 안전하게 절삭하고 전체는 `RULES.md` 에 남습니다.
+
 ## 3분 안에 시작하기 (Getting Started)
 
 ### 1. 설치
@@ -40,12 +55,12 @@ vhk start
 vhk gate          # 퀵 5문항 — GO / 다듬기 / 다른 아이디어
 ```
 
-### 3. v1.3 핵심 기능 한눈에
+### 3. 그 외 기능 한눈에 (v1.5)
 
 | 기능 | 한 줄 요약 | 진입 명령 |
 |------|-----------|-----------|
 | 🎯 **Goals 체계** | 단계별 미션 + 게이트 스크립트로 AI가 목표를 스스로 추적 | `vhk goal init` |
-| ▶️ **자율 루프** | `goal next → 작업 → goal check → goal done`. FAIL 3회면 자동 블로커 | `vhk goal next` |
+| ▶️ **자율 루프** | `goal next → 작업 → goal check → goal done`. FAIL 시 `vhk blocker` 수동 기록 → 블로커 3건 누적 시 HARD_STOP 자동 | `vhk goal next` |
 | 🚧 **HARD_STOP 안전장치** | 블로커 3건 누적 → `.vhk/HARD_STOP` 트립와이어. `vhk resume --confirm` 만 해제 | `vhk blocker "<증상>"` |
 | 🔌 **MCP 24 tool** | Cursor·Claude Desktop 등에서 vhk를 채팅으로 호출 | `vhk mcp-init` |
 | 📋 **컨텍스트 영속화** | `.vhk/context.md` + `memory.json` + `brief.md` 로 세션 간 맥락 유지 | `vhk context` |
@@ -115,7 +130,7 @@ vhk 기획 끝났고 바로 시작
 | `vhk gate` | `검증`, `아이디어` | 아이디어 검증 (퀵 5문항 / 풀 13문항 / 스킵) |
 | `vhk init` | `시작`, `만들기` | 프로젝트 초기화 + 하네스 생성 |
 | `vhk recap` | `정리`, `오늘` | Git 변경 → `docs/log/` 세션 로그 |
-| `vhk sync` | `규칙`, `맞추기` | RULES.md → `.cursorrules` + CLAUDE.md + `.windsurfrules` |
+| `vhk sync` | `규칙`, `맞추기` | RULES.md → `.cursorrules` + CLAUDE.md + `.windsurfrules` + `.github/copilot-instructions.md` + `.agents/rules/vhk-rules.md` (5개) |
 | `vhk check` | `점검`, `린트` | RULES.md 규칙 위반 검사 |
 | `vhk secure` | `보안` | 시크릿·키 유출 스캔 (`scan` / `스캔` 동일). **CRITICAL/HIGH 발견 시 exit code 1** (CI용) |
 | `vhk ship` | `출하` | 배포 체크리스트 + 회고 + 빌드 로그 |
@@ -300,10 +315,10 @@ vhk ref open 1          # 1번 레퍼런스를 브라우저로 열기
 
 | 기능 | 설명 |
 |------|------|
-| **MCP 서버** | `vhk mcp` — stdio MCP 서버 첫 도입 (v0.6.0 당시 8개 도구 — save/undo/status/diff/ship/doctor/check/recap). 현재 v1.3 기준 **24개** 로 확장 — 위 "Cursor와 MCP로 연동하기" 섹션 참조 |
+| **MCP 서버** | `vhk mcp` — stdio MCP 서버 첫 도입 (v0.6.0 당시 8개 도구 — save/undo/status/diff/ship/doctor/check/recap). 현재 v1.5 기준 **24개** 로 확장 — 위 "Cursor와 MCP로 연동하기" 섹션 참조 |
 | **mcp-init** | `vhk mcp-init` — Cursor `.cursor/mcp.json` 자동 생성. 재시작 한 번으로 연동 완료 |
 | **자연어 라우팅 확장** | `vhk mcp설정` → `vhk mcp-init` 별칭 |
-| **보안** | MCP save 도구의 shell injection 차단 — 모든 git 호출에 `execFileSync` 사용 |
+| **보안** | MCP save 도구의 shell injection 차단 — 모든 git 호출에 shell 미경유 `safeExecFile` 사용 |
 
 ## v0.5.3 하이라이트
 

package/dist/{chunk-3DV7AEN4.js → chunk-4KWZANQG.js}

@@ -755,6 +755,9 @@ var ko = {
     cursorrulesDone: "\u2705 .cursorrules \uB9DE\uCDA4 \uC644\uB8CC",
     claudeDone: "\u2705 CLAUDE.md \uB9DE\uCDA4 \uC644\uB8CC",
     windsurfDone: "\u2705 .windsurfrules \uB9DE\uCDA4 \uC644\uB8CC",
+    copilotDone: "\u2705 .github/copilot-instructions.md \uB9DE\uCDA4 \uC644\uB8CC",
+    antigravityDone: "\u2705 .agents/rules/vhk-rules.md \uB9DE\uCDA4 \uC644\uB8CC",
+    antigravityTruncated: "Antigravity 12,000\uC790 \uC81C\uD55C\uC73C\uB85C \uC77C\uBD80 \uC808\uC0AD\uB428 \u2014 \uC804\uCCB4\uB294 RULES.md \uCC38\uC870",
     done: "\u{1F504} \uB9DE\uCD94\uAE30 \uC644\uB8CC!"
   },
   cloud: {
@@ -882,7 +885,9 @@ var ko = {
     nextTitle: "\u27A1\uFE0F  \uB2E4\uC74C Goal",
     initTitle: "\u{1F3D7}\uFE0F  goals/ \uAD6C\uC870 \uC2A4\uCE90\uD3F4\uB529",
     checkTitle: "\u2705 Goal \uAC8C\uC774\uD2B8 \uAC80\uC99D",
-    doneTitle: "\u{1F3C1} Goal \uC644\uB8CC \uCC98\uB9AC"
+    doneTitle: "\u{1F3C1} Goal \uC644\uB8CC \uCC98\uB9AC",
+    duplicateId: (ids) => `\u26A0 \uC911\uBCF5\uB41C goal id: ${ids} \u2014 \uAC19\uC740 id \uD30C\uC77C\uC774 \uC5EC\uB7EC \uAC1C\uBA74 \uCCAB \uB9E4\uCE58\uB9CC \uC0AC\uC6A9\uB429\uB2C8\uB2E4. id \uB97C \uC720\uC77C\uD558\uAC8C \uACE0\uCE58\uC138\uC694.`,
+    notFound: (id) => `goal id ${id} \uC5C6\uC74C \u2014 vhk goal list \uB85C \uD655\uC778\uD558\uC138\uC694.`
   },
   agent: {
     blockerTitle: "\u{1F6D1} Blocker \uAE30\uB85D",

package/dist/index.js

@@ -20,7 +20,7 @@ import {
   scanProjectForSecrets,
   startMcpServer,
   t
-} from "./chunk-3DV7AEN4.js";
+} from "./chunk-4KWZANQG.js";
 
 // src/index.ts
 import { Command, Help } from "commander";
@@ -1676,12 +1676,12 @@ function parseRulesMd(content) {
   }
   return sections;
 }
-function toCursorrules(sections, projectName) {
+function buildCodingDoc(headerTitle, sections, projectName) {
   const codingSections = sections.filter(
     (s) => CURSORRULES_KEYS.some((k) => s.title.includes(k))
   );
   const lines = [
-    `# ${projectName} \u2014 Cursor Rules`,
+    `# ${projectName} \u2014 ${headerTitle}`,
     "",
     "> \uCF54\uB529/\uB514\uC790\uC778 \uC804\uC6A9. \uAE30\uB85D/\uC6B4\uC601 \u2192 CLAUDE.md \uCC38\uC870.",
     "> \u26A1 \uC774 \uD30C\uC77C\uC740 RULES.md\uC5D0\uC11C \uC790\uB3D9 \uC0DD\uC131\uB428 (vhk sync). \uC9C1\uC811 \uC218\uC815 \uAE08\uC9C0.",
@@ -1697,26 +1697,38 @@ function toCursorrules(sections, projectName) {
   }
   return lines.join("\n");
 }
+function toCursorrules(sections, projectName) {
+  return buildCodingDoc("Cursor Rules", sections, projectName);
+}
 function toWindsurfrules(sections, projectName) {
-  const codingSections = sections.filter(
-    (s) => CURSORRULES_KEYS.some((k) => s.title.includes(k))
-  );
-  const lines = [
-    `# ${projectName} \u2014 Windsurf Rules`,
-    "",
-    "> \uCF54\uB529/\uB514\uC790\uC778 \uC804\uC6A9. \uAE30\uB85D/\uC6B4\uC601 \u2192 CLAUDE.md \uCC38\uC870.",
-    "> \u26A1 \uC774 \uD30C\uC77C\uC740 RULES.md\uC5D0\uC11C \uC790\uB3D9 \uC0DD\uC131\uB428 (vhk sync). \uC9C1\uC811 \uC218\uC815 \uAE08\uC9C0.",
-    "",
-    "## \uD544\uC218 \uCC38\uC870",
-    "- docs/PRD.md \xB7 docs/ARCHITECTURE.md \xB7 CLAUDE.md \xB7 RULES.md",
-    ""
-  ];
-  for (const section of codingSections) {
-    lines.push(`## ${section.title}`);
-    lines.push(section.content);
-    lines.push("");
-  }
-  return lines.join("\n");
+  return buildCodingDoc("Windsurf Rules", sections, projectName);
+}
+function toCopilotInstructions(sections, projectName) {
+  return buildCodingDoc("GitHub Copilot Instructions", sections, projectName);
+}
+var ANTIGRAVITY_CHAR_LIMIT = 12e3;
+var ANTIGRAVITY_TRUNCATE_MARKER = "\n\n<!-- \u26A0\uFE0F Antigravity 12,000\uC790 \uC81C\uD55C\uC73C\uB85C \uC808\uC0AD\uB428 \u2014 \uC804\uCCB4 \uADDC\uCE59\uC740 RULES.md \uCC38\uC870 -->\n";
+function truncateForAntigravity(content, limit = ANTIGRAVITY_CHAR_LIMIT) {
+  if (Buffer.byteLength(content, "utf8") <= limit) return content;
+  const SAFETY = 200;
+  const budget = limit - Buffer.byteLength(ANTIGRAVITY_TRUNCATE_MARKER, "utf8") - SAFETY;
+  let lo = 0;
+  let hi = content.length;
+  while (lo < hi) {
+    const mid = lo + hi + 1 >> 1;
+    if (Buffer.byteLength(content.slice(0, mid), "utf8") <= budget) lo = mid;
+    else hi = mid - 1;
+  }
+  const charCut = lo;
+  let cut = content.lastIndexOf("\n## ", charCut);
+  if (cut < charCut * 0.5) {
+    const nl = content.lastIndexOf("\n", charCut);
+    cut = nl > 0 ? nl : charCut;
+  }
+  return content.slice(0, cut).trimEnd() + ANTIGRAVITY_TRUNCATE_MARKER;
+}
+function toAntigravityRules(sections, projectName) {
+  return truncateForAntigravity(buildCodingDoc("Antigravity Rules", sections, projectName));
 }
 function toClaudeMd(sections, existing) {
   const recordSections = sections.filter(
@@ -1780,9 +1792,22 @@ ${ko.sync.title}
   const windsurfPath = path6.join(cwd, ".windsurfrules");
   fs5.writeFileSync(windsurfPath, toWindsurfrules(sections, projectName), "utf-8");
   console.log(chalk5.green(`  ${ko.sync.windsurfDone}`));
+  const copilotPath = path6.join(cwd, ".github", "copilot-instructions.md");
+  fs5.mkdirSync(path6.dirname(copilotPath), { recursive: true });
+  fs5.writeFileSync(copilotPath, toCopilotInstructions(sections, projectName), "utf-8");
+  console.log(chalk5.green(`  ${ko.sync.copilotDone}`));
+  const antigravityPath = path6.join(cwd, ".agents", "rules", "vhk-rules.md");
+  fs5.mkdirSync(path6.dirname(antigravityPath), { recursive: true });
+  const antigravityDoc = toAntigravityRules(sections, projectName);
+  fs5.writeFileSync(antigravityPath, antigravityDoc, "utf-8");
+  console.log(chalk5.green(`  ${ko.sync.antigravityDone}`));
+  if (antigravityDoc.includes("\uC808\uC0AD\uB428")) {
+    console.log(chalk5.yellow(`    \u26A0\uFE0F  ${ko.sync.antigravityTruncated}`));
+  }
   console.log(chalk5.bold.green(`
 ${ko.sync.done}`));
-  console.log(chalk5.dim("  RULES.md (\uC6D0\uBCF8) \u2192 .cursorrules + CLAUDE.md + .windsurfrules (\uC790\uB3D9 \uC0DD\uC131)"));
+  console.log(chalk5.dim("  RULES.md (\uC6D0\uBCF8) \u2192 .cursorrules + CLAUDE.md + .windsurfrules"));
+  console.log(chalk5.dim("             + .github/copilot-instructions.md + .agents/rules/vhk-rules.md (\uC790\uB3D9 \uC0DD\uC131)"));
   console.log(chalk5.dim("  \uADDC\uCE59 \uBCC0\uACBD\uC740 \uD56D\uC0C1 RULES.md\uC5D0\uC11C\uB9CC \uD558\uC138\uC694."));
   printNextStep({
     message: "\uADDC\uCE59 \uB3D9\uAE30\uD654 \uC644\uB8CC! \uC774\uC81C Cursor\uAC00 \uC0C8 \uADDC\uCE59\uC744 \uB530\uB985\uB2C8\uB2E4.",
@@ -2024,6 +2049,19 @@ function listGoals(goalsDir) {
   parsed.sort((a, b) => a.frontmatter.id - b.frontmatter.id);
   return parsed;
 }
+function findDuplicateIds(goals) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const g of goals) {
+    const id = g.frontmatter.id;
+    if (typeof id !== "number") continue;
+    counts.set(id, (counts.get(id) ?? 0) + 1);
+  }
+  const dups = [];
+  for (const [id, n] of counts) {
+    if (n > 1) dups.push(id);
+  }
+  return dups.sort((a, b) => a - b);
+}
 function updateFrontmatterStatus(content, newStatus, extraFields) {
   const m = content.match(FRONTMATTER_RE);
   if (!m) return content;
@@ -2108,6 +2146,11 @@ ${ko.goal.listTitle}
       `  [${id}] ${icon} ${status2.padEnd(11)} ${pri} ${ver} ${fm.title ?? "(untitled)"}`
     );
   }
+  const dups = findDuplicateIds(goals);
+  if (dups.length > 0) {
+    console.log("");
+    console.log(chalk6.yellow(`  ${ko.goal.duplicateId(dups.join(", "))}`));
+  }
 }
 async function goalNext() {
   console.log(chalk6.bold(`
@@ -2221,6 +2264,11 @@ ${ko.goal.checkTitle}
     process.exitCode = 1;
     return;
   }
+  if (!goals.some((g) => g.frontmatter.id === id)) {
+    console.log(chalk6.red(`  \u274C ${ko.goal.notFound(id)}`));
+    process.exitCode = 1;
+    return;
+  }
   const scriptPath = findGateScript(id);
   if (!scriptPath) {
     console.log(
@@ -2258,7 +2306,7 @@ ${ko.goal.doneTitle}
   }
   const target = goals.find((g) => g.frontmatter.id === id);
   if (!target) {
-    console.log(chalk6.red(`  \u274C goal id ${id} \uD30C\uC77C \uC5C6\uC74C.`));
+    console.log(chalk6.red(`  \u274C ${ko.goal.notFound(id)}`));
     process.exitCode = 1;
     return;
   }

package/dist/mcp/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   startMcpServer
-} from "../chunk-3DV7AEN4.js";
+} from "../chunk-4KWZANQG.js";
 
 // src/mcp/index.ts
 startMcpServer().catch((err) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@byh3071/vhk",
-  "version": "1.4.0",
-  "description": "Vibe Harness Kit — 바이브코딩 풀사이클 CLI",
+  "version": "1.5.1",
+  "description": "Vibe Harness Kit — AI 코딩 도구·기기를 바꿔도 규칙·맥락이 따라가는 포터빌리티 CLI (sync: Cursor·Claude·Windsurf·Copilot·Antigravity / cloud 백업)",
   "bin": {
     "vhk": "dist/index.js",
     "vhk-mcp": "dist/mcp/index.js"
@@ -18,7 +18,14 @@
     "cli",
     "scaffold",
     "session-log",
-    "rules-sync"
+    "rules-sync",
+    "portability",
+    "ai-coding",
+    "cursor",
+    "claude",
+    "windsurf",
+    "copilot",
+    "context-sync"
   ],
   "author": "byh3071 <byh3071@gmail.com>",
   "license": "MIT",