@su-record/vibe 3.2.25 → 3.2.26

package/.codex-plugin/plugin.json

@@ -0,0 +1,34 @@
+{
+  "name": "vibe",
+  "version": "3.2.26",
+  "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",
+    "url": "https://github.com/su-record"
+  },
+  "homepage": "https://github.com/su-record/vibe",
+  "repository": "https://github.com/su-record/vibe",
+  "license": "MIT",
+  "keywords": [
+    "verification",
+    "spec",
+    "testing",
+    "code-review",
+    "loop",
+    "harness"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/plugin-hooks.json",
+  "interface": {
+    "displayName": "Vibe",
+    "shortDescription": "Deterministic gates for AI coding — nothing unverified ships",
+    "longDescription": "Natural-language requirement to a SPEC you approve once, then an ANCHOR→ACT→JUDGE→RECORD loop that runs until deterministic gates pass. Completion is judged by test exit codes and a run-ledger, never by self-report.",
+    "developerName": "su-record",
+    "category": "Developer Tools",
+    "websiteURL": "https://github.com/su-record/vibe",
+    "defaultPrompt": [
+      "Use Vibe to turn this requirement into an approved SPEC and implement it.",
+      "Use Vibe to review my changes until there are zero P1 findings."
+    ]
+  }
+}

package/CLAUDE.md

@@ -80,7 +80,7 @@ Loop semantics SSOT: `vibe/rules/loop-contract.md` (ANCHOR→ACT→JUDGE→RECOR
 Legacy: 기존 `.claude/vibe/` 는 런타임에 자동 인식되며 `vibe init`/`update` 시 `.vibe/` 로 이동한다.
 
 ### Dual-Harness Doctrine
-하네스 차이는 경로가 아니라 **인지 방식**(CC=추론 / Codex=직역)에 있다. 원칙: **암묵적 동작에 의존하지 않는다 — 추론은 `/vibe` 디스패처가 앞단에서, skill 본문은 전부 명시적으로.** ("명시성 공통분모 + 추론 앞단"). Hook은 의도별 매핑: 라이프사이클(turn 완료) → Codex `config.toml notify`, 나머지(SessionStart·UserPromptSubmit·Pre/PostToolUse) → Codex 네이티브 hook(`.codex/hooks.json` + `codex-hook-adapter.js`). AGENTS.md soft-hook 은 폐기하지 않고 **훅 미설치 환경의 2차 방어선**으로 유지(직역이라 신뢰성↑). 전문: `vibe/rules/principles/dual-harness-doctrine.md`.
+하네스 차이는 경로가 아니라 **인지 방식**(CC=추론 / Codex=직역)에 있다. 원칙: **암묵적 동작에 의존하지 않는다 — 추론은 `/vibe` 디스패처가 앞단에서, skill 본문은 전부 명시적으로.** ("명시성 공통분모 + 추론 앞단"). Hook은 의도별 매핑: 라이프사이클(turn 완료) → Codex `config.toml notify`, 나머지(SessionStart·UserPromptSubmit·Pre/PostToolUse·Pre/PostCompact) → Codex 네이티브 hook(`.codex/hooks.json` + `codex-hook-adapter.js`). **`PostCompact` 는 압축 직후 `loop-ledger.js anchor` 로 재고정한다** — ANCHOR 가 컨텍스트 소실에 대비하는 장치인데 정작 압축 시점에 자동 실행이 없었다. AGENTS.md soft-hook 은 폐기하지 않고 **훅 미설치 환경의 2차 방어선**으로 유지(직역이라 신뢰성↑). 전문: `vibe/rules/principles/dual-harness-doctrine.md`.
 
 ### Gotchas
 - `better-sqlite3` WAL mode — synchronous API

package/README.en.md

@@ -59,7 +59,7 @@ One entry point. Single-pass SPEC → one approval → loop until the gates pass
 
 **Loop-default** — After SPEC approval, vibe loops (ANCHOR→ACT→JUDGE→RECORD) until gates pass, with deterministic stuck/iteration guards. `--interactive` for step-by-step confirmation; `--max-iter N` to cap iterations; `automationLevel: autonomous` (`.vibe/config.json`) runs non-interactively to completion.
 
-**Loop engineering** — `/vibe.loop` designs and installs autonomous goal loops (triage → run/verify pipelines). Completion is judged by deterministic gates (run-ledger/tests), not self-report; results land in a human triage inbox — loops never push or release.
+**Loop engineering** — `/vibe.loop` designs and installs autonomous goal loops (triage → run/verify pipelines). Completion is judged by deterministic gates (run-ledger/tests), not self-report — and so is runaway protection: iterations are counted in code, tracking **total rounds** and **verified rounds** separately so a thrashing loop is distinguishable from a genuinely large one. Results land in a human triage inbox — loops never push or release.
 
 ---
 
@@ -181,6 +181,8 @@ Detection at edit time, blocking at deterministic gates:
 |-------|--------------|
 | Edit hooks (Edit/Write) | **Detects** only low-false-positive hard rules — `any`/`@ts-ignore`, `console.log` → injects findings to the model (additionalContext). No length/nesting heuristics — the model judges those better in context |
 | Deterministic gates | **PR test gate** (runs the actual test suite before PR creation, incl. `gh pr create`) · **auto-commit verify gate** (refuses commits until verify passes) · **Stop hook** verify-skip warn/block · **scope-guard** (opt-in; monitors edits outside SPEC scope) · **sentinel** (blocks destructive commands and harness self-modification) |
+| Node gates | Gates are not only at the end of the pipeline — the **SPEC Code Guard** checks downstream requirements (REQ IDs, Stakes, Done Criteria, unfilled placeholders) **before** approval and sends failures back to SPEC authoring (backward edge) |
+| Human gates | **Gate objects** — a pending question is written to disk (`.vibe/gates/`) so it survives a dead session. **Cost gate** — approval is requested only before irreversible spend (paid generation) or unusually large agent fan-out; normal scale passes through |
 | Review + convergence loop | Parallel `code-reviewer` instances — one per focus (correctness / architecture / performance / data-integrity / …) — plus `security-reviewer`. Loops until P1 = 0, with convergence decided by discover-hash: two identical rounds = stuck, ask the user. Never silently proceeds. |
 
 ---
@@ -217,29 +219,57 @@ Skills teach only what the model doesn't know (domain gotchas, current APIs, pro
 |-----|--------|
 | [Claude Code](https://claude.ai/code) | Full support |
 | [Codex](https://github.com/openai/codex) | Full support (`~/.codex/`, AGENTS.md, native hooks.json, config.toml notify, codex exec agent fallback) |
-| [Cursor](https://cursor.sh) | Agents + Rules |
 | Antigravity CLI (`agy`) | Agents + Skills |
 
 ---
 
 ## Commands
 
+Start with `/vibe` and it routes the rest. Below is the list for when you want to call a specific phase directly.
+
+**Core flow**
+
 | Command | Purpose |
 |---------|---------|
-| `/vibe` | Main entry point — natural language requirement → single-pass SPEC → one approval → loop until gates pass |
-| `/vibe.spec` | Advanced — explicit single-pass SPEC (inline questions → SPEC + BDD → approval) |
+| `/vibe` | **Main entry point** — natural language requirement → single-pass SPEC → one approval → loop until gates pass |
+| `/vibe.spec` | Explicit single-pass SPEC (inline questions → SPEC + BDD → approval) |
 | `/vibe.run` | Implement from SPEC |
-| `/vibe.figma` | Figma ↔ Code (read or write, 3 modes) |
-| `/vibe.design` | DESIGN.md visual quality SSOT — init / lint / verify / sync / preview |
 | `/vibe.verify` | Verify implementation against SPEC Done criteria — result recorded in the run ledger |
+| `/vibe.continue` | Session restore — pick up after `save_memory` → `/new` at 85%+ context |
+
+**Verification & quality**
+
+| Command | Purpose |
+|---------|---------|
+| `/vibe.review` | Parallel review by focus (correctness / security / performance …) — converges to P1 = 0 |
 | `/vibe.regress` | Regression test auto-evolution — auto-registers on verify failure, promotes recurring patterns |
+| `/vibe.contract` | SPEC API contract ↔ implementation drift detection — P1 drift propagates to regress |
 | `/vibe.trace` | Requirements traceability matrix |
+| `/vibe.loop` | Design and install autonomous goal loops — completion judged by deterministic gates |
+| `/vibe.test` | vibe self-test (CC ↔ Codex parity) — recommended before every release |
+| `/vibe.harness` | Diagnose Harness Engineering maturity (6-axis, N/100) |
+
+**Design & UI**
+
+| Command | Purpose |
+|---------|---------|
+| `/vibe.figma` | Figma ↔ Code (read or write, 3 modes) |
+| `/vibe.design` | DESIGN.md visual quality SSOT — init / lint / verify / sync / preview |
+| `/vibe.clone` | Reference site URL → reproduce markup in your stack (pixel verification loop) |
+| `/vibe.image` | Image generation (Antigravity) — icons, banners, mockups |
+
+**Analysis, docs & ops**
+
+| Command | Purpose |
+|---------|---------|
 | `/vibe.analyze` | Analyze any target — code, documents, websites, Figma |
+| `/vibe.reason` | Structure hypotheses, evidence and trade-offs for hard problems |
+| `/vibe.docs` | Keep README, guides, architecture, release notes and diagrams in sync with the code |
 | `/vibe.scaffold` | Generate or audit project folder structure |
-| `/vibe.harness` | Diagnose Harness Engineering maturity (6-axis scoring) |
-| `/vibe.docs` | Generate project documentation — plus diagram / codemaps modes |
-| `/vibe.continue` | Session restore — pick up where you left off after `save_memory` → `/new` at 85%+ context |
-| `/vibe.image` | Image generation (Antigravity) — icons, banners, mockups |
+| `/vibe.llm` | Refresh the available model list per provider |
+
+> These are the common ones. The full installed skill list lives in [SKILL-CATALOG.md](SKILL-CATALOG.md),
+> and requirements not in the table are handled by `/vibe`'s description-based catch-all routing.
 
 ---
 
@@ -248,7 +278,7 @@ Skills teach only what the model doesn't know (domain gotchas, current APIs, pro
 Full guides, skill reference, and configuration details are in the [Wiki](https://github.com/su-record/vibe/wiki).
 
 - [README (Korean)](README.md)
-- [Release Notes](RELEASE_NOTES.md)
+- [Release Notes](https://github.com/su-record/vibe/releases) — generated deterministically by CI from SPECs and commits on each tag
 
 ---
 

package/README.md

@@ -7,7 +7,7 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 
-**English** — Vibe is a **verification harness** for AI coding agents. It wraps Claude Code, Codex, Cursor, and Antigravity CLI so that "done" is decided by deterministic gates — test exit codes, run-ledgers, regression memory — instead of the model's self-report. Models already plan and implement well; what's missing is a reason to trust "it's done." Vibe supplies that ground truth: vibe-code fast, but nothing unverified ships. Install with `npm install -g @su-record/vibe && vibe init`, then throw a natural-language requirement at `/vibe` — one SPEC approval, then an autonomous ANCHOR→ACT→JUDGE→RECORD loop until the gates pass. *(Full docs below are in Korean; the CLI works in any language.)*
+**English** — Vibe is a **verification harness** for AI coding agents. It wraps Claude Code, Codex, and Antigravity CLI so that "done" is decided by deterministic gates — test exit codes, run-ledgers, regression memory — instead of the model's self-report. Models already plan and implement well; what's missing is a reason to trust "it's done." Vibe supplies that ground truth: vibe-code fast, but nothing unverified ships. Install with `npm install -g @su-record/vibe && vibe init`, then throw a natural-language requirement at `/vibe` — one SPEC approval, then an autonomous ANCHOR→ACT→JUDGE→RECORD loop until the gates pass. *(Full docs below are in Korean; the CLI works in any language.)*
 
 Vibe는 AI 코딩을 위한 **검증 하네스(verification harness)** 입니다. 출처가 있는 컨텍스트로 SPEC을 고정하고, **완료 판정을 모델의 자기 보고가 아니라 결정론적 게이트(테스트 exit code, run-ledger, 회귀 기억)에 맡긴 뒤 실행별 Evidence Bundle을 남깁니다.** Model Judge는 발견만 제안하고, Human Taste는 release에서만 판단합니다. 빠르게 바이브 코딩하되, 검증 안 된 코드가 나가지 않게.
 
@@ -153,6 +153,8 @@ codex
 |------|------|
 | 편집 훅 (Edit/Write) | 오탐률 낮은 하드룰만 **탐지** — `any`/`@ts-ignore`, `console.log` → 모델에 즉시 주입(additionalContext). 함수 길이·중첩 같은 휴리스틱은 없음 — 모델이 컨텍스트 안에서 더 정확히 판단 |
 | 결정론 게이트 | **PR 테스트 게이트**(PR 생성 전 테스트 스위트 직접 실행, `gh pr create` 포함) · **auto-commit verify 게이트**(verify 통과 전 커밋 거부) · **Stop 훅** verify-skip 경고/차단 · **scope-guard**(opt-in, SPEC 범위 밖 편집 감시) · **sentinel**(파괴적 명령·하네스 자기 수정 차단) |
+| 노드 게이트 | 게이트를 파이프라인 끝에만 두지 않음 — **SPEC Code Guard**가 승인 **전에** 하류 요구사항(REQ-ID·Stakes·Done Criteria·미치환 placeholder)을 검사하고, 실패하면 SPEC 작성으로 되돌림(backward edge) |
+| 사람 게이트 | **게이트 객체** — 대기 중인 질문을 디스크(`.vibe/gates/`)에 남겨 세션이 끊겨도 무엇을 묻는지 살아남음. **비용 게이트** — 되돌릴 수 없는 지출(유료 생성)과 이상 규모 팬아웃 직전에만 승인 요청(평상시 규모는 통과) |
 | 리뷰 + 수렴 루프 | `code-reviewer`를 관점(focus)별 병렬 인스턴스로 실행(correctness/architecture/performance/data-integrity/…) + `security-reviewer`. P1=0까지 루프하되 수렴은 discover-hash가 판정 — 2라운드 동일 findings면 stuck으로 확정하고 사람에게 질문. 절대 조용히 넘어가지 않음 |
 
 ---
@@ -179,7 +181,28 @@ codex
 
 **Smart Resume** — `.last-feature` 포인터가 마지막 작업을 추적. 인자 없이 `/vibe`를 호출하면 중단된 위치를 보여주거나 진행 중 feature 목록을 제시.
 
-**루프 엔지니어링** — `/vibe.loop`로 자율 목표 루프를 설계·설치(트리아지 → run/verify 파이프라인). 완료 판정은 자기 보고가 아니라 결정론 게이트(run-ledger/테스트)가 내리고, 결과는 사람 리뷰 인박스로 — 루프는 push/release를 하지 않습니다.
+**루프 엔지니어링** — `/vibe.loop`로 자율 목표 루프를 설계·설치(트리아지 → run/verify 파이프라인). 완료 판정은 자기 보고가 아니라 결정론 게이트(run-ledger/테스트)가 내리고, 폭주 방어도 마찬가지 — 회전 수를 코드가 세고 **전체 회전**과 **검증을 통과한 회전**을 따로 집계해 헛도는 루프와 큰 작업을 구분합니다. 결과는 사람 리뷰 인박스로 — 루프는 push/release를 하지 않습니다.
+
+---
+
+## 플러그인으로 설치 (실험적)
+
+npm 전역 설치와 **병행**하는 경로다. ChatGPT 와 Codex 는 플러그인 디렉토리를 공유하므로, 한 번 패키징하면 양쪽에 올라간다.
+
+```bash
+# 저장소를 그대로 플러그인으로 설치해 검증 (repo 스코프 마켓플레이스가 이미 포함돼 있다)
+#   .agents/plugins/marketplace.json → source.path "./"
+# 1) ChatGPT 데스크톱 앱 재시작
+# 2) Plugins Directory 에서 "Vibe (local)" → vibe 설치
+```
+
+| 번들 | ChatGPT 앱 | Codex CLI |
+|---|---|---|
+| skills (52) | ✅ | ✅ |
+| hooks | **미확인** — 훅 문서가 Codex 아래에만 있다 | ✅ (trust 승인 후) |
+
+> ⚠️ 훅은 설치·활성화만으로 신뢰되지 않는다 — Codex 가 정의를 검토·승인할 때까지 건너뛴다.
+> `vibe init`·`vibe upgrade` 같은 CLI 와 프로젝트 로컬 훅 설치는 플러그인이 대체하지 못하므로 npm 설치는 계속 필요하다.
 
 ---
 
@@ -189,25 +212,57 @@ codex
 |-----|------|
 | [Claude Code](https://claude.ai/code) | 전체 지원 |
 | [Codex](https://github.com/openai/codex) | 전체 지원 (`~/.codex/`, AGENTS.md, native hooks.json, config.toml notify, codex exec agent fallback) |
-| [Cursor](https://cursor.sh) | 에이전트 + 룰 |
 | Antigravity CLI (`agy`) | 에이전트 + 스킬 |
 
 ---
 
 ## 명령어
 
+`/vibe` 하나로 시작하면 나머지는 vibe 가 라우팅한다. 아래는 특정 단계를 직접 부르고 싶을 때의 목록이다.
+
+**핵심 흐름**
+
 | 명령어 | 용도 |
 |--------|------|
 | `/vibe` | **메인 진입점** — 자연어 요구사항 → SPEC 1패스 → 1회 승인 → 게이트 통과까지 루프 |
-| `/vibe.spec` | (advanced) SPEC 1패스 명시적 호출 — 인라인 질문 → SPEC + BDD → 승인 |
-| `/vibe.run` | (advanced) SPEC 기반 구현 |
-| `/vibe.figma` | (advanced) Figma ↔ 코드 (읽기 또는 쓰기, 3가지 모드) |
-| `/vibe.design` | (advanced) DESIGN.md 시각 품질 SSOT — init / lint / verify / sync / preview |
-| `/vibe.verify` | (advanced) 구현이 SPEC Done 기준에 맞는지 검증 — 결과는 run-ledger에 기록 |
-| `/vibe.regress` | (advanced) 회귀 테스트 자동 진화 — verify 실패 자동 등록, 반복 패턴 승격 |
-| `/vibe.trace` | (advanced) 요구사항 추적 매트릭스 |
-| `/vibe.continue` | 세션 복원 — 85%+ 컨텍스트에서 `save_memory` → `/new` 후 이어서 작업 |
-| `/vibe.image` | 이미지 생성 (Antigravity) — 아이콘/배너/목업 |
+| `/vibe.spec` | SPEC 1패스 명시적 호출 — 인라인 질문 → SPEC + BDD → 승인 |
+| `/vibe.run` | SPEC 기반 구현 |
+| `/vibe.verify` | 구현이 SPEC Done 기준에 맞는지 검증 — 결과는 run-ledger 에 기록 |
+| `/vibe.continue` | 세션 복원 — 85%+ 컨텍스트에서 `save_memory` → `/new` 후 이어서 |
+
+**검증 · 품질**
+
+| 명령어 | 용도 |
+|--------|------|
+| `/vibe.review` | 관점별 병렬 리뷰 (correctness / security / performance …) — P1=0 까지 수렴 |
+| `/vibe.regress` | 회귀 테스트 자동 진화 — verify 실패 자동 등록, 반복 패턴 승격 |
+| `/vibe.contract` | SPEC API 계약 ↔ 구현 drift 탐지 — P1 drift 는 regress 로 전파 |
+| `/vibe.trace` | 요구사항 추적 매트릭스 (RTM) |
+| `/vibe.loop` | 자율 목표 루프 설계·설치 — 완료는 결정론 게이트가 판정 |
+| `/vibe.test` | vibe 설치 자가검진 (CC ↔ Codex 동등성) — 릴리즈 전 권장 |
+| `/vibe.harness` | 프로젝트 하네스 품질 6축 진단 (N/100) |
+
+**설계 · UI**
+
+| 명령어 | 용도 |
+|--------|------|
+| `/vibe.figma` | Figma ↔ 코드 (읽기 또는 쓰기, 3가지 모드) |
+| `/vibe.design` | DESIGN.md 시각 품질 SSOT — init / lint / verify / sync / preview |
+| `/vibe.clone` | 참조 사이트 URL → 현재 스택으로 마크업 재현 (픽셀 검증 루프) |
+| `/vibe.image` | 이미지 생성 (Antigravity) — 아이콘 / 배너 / 목업 |
+
+**분석 · 문서 · 운영**
+
+| 명령어 | 용도 |
+|--------|------|
+| `/vibe.analyze` | 코드·문서·웹·Figma 분석 → 근거 있는 리포트 |
+| `/vibe.reason` | 복잡한 문제의 가설·근거·트레이드오프 구조화 |
+| `/vibe.docs` | README·가이드·아키텍처·릴리즈 노트·다이어그램을 코드와 동기화 |
+| `/vibe.scaffold` | 새 프로젝트 구조 생성 / 기존 구조 감사 |
+| `/vibe.llm` | provider 별 사용 가능 모델 목록 갱신 |
+
+> 위는 자주 쓰는 것들이다. 설치된 전체 스킬 목록은 [SKILL-CATALOG.md](SKILL-CATALOG.md) 에 있고,
+> 표에 없는 요구사항도 `/vibe` 가 description 기반 Catch-all 라우팅으로 처리한다.
 
 ---
 
@@ -216,7 +271,7 @@ codex
 상세 가이드, 스킬 레퍼런스, 설정 방법은 [Wiki](https://github.com/su-record/vibe/wiki)를 참고하세요.
 
 - [README (English)](README.en.md)
-- [릴리스 노트](RELEASE_NOTES.md)
+- [릴리스 노트](https://github.com/su-record/vibe/releases) — 태그마다 CI 가 SPEC·커밋에서 결정론적으로 생성
 
 ---
 

package/dist/cli/setup/CodexHooks.d.ts

@@ -14,6 +14,7 @@ export interface CodexHooksConfig {
         Stop: CodexHookEntry[];
         /** CC 의 context_window_* Notification 등가물 — Codex 에는 임계치 알림이 없다 */
         PreCompact: CodexHookEntry[];
+        PostCompact: CodexHookEntry[];
     };
 }
 export declare function buildCodexHooksConfig(coreDir?: string): CodexHooksConfig;

package/dist/cli/setup/CodexHooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodexHooks.d.ts","sourceRoot":"","sources":["../../../src/cli/setup/CodexHooks.ts"],"names":[],"mappings":"AAKA,UAAU,gBAAgB;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,YAAY,EAAE,cAAc,EAAE,CAAC;QAC/B,gBAAgB,EAAE,cAAc,EAAE,CAAC;QACnC,UAAU,EAAE,cAAc,EAAE,CAAC;QAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;QAC9B,IAAI,EAAE,cAAc,EAAE,CAAC;QACvB,mEAAmE;QACnE,UAAU,EAAE,cAAc,EAAE,CAAC;KAC9B,CAAC;CACH;AAaD,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,MAA2B,GAAG,gBAAgB,CAY5F;AAaD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAA2B,GACnC,IAAI,CAWN"}
+{"version":3,"file":"CodexHooks.d.ts","sourceRoot":"","sources":["../../../src/cli/setup/CodexHooks.ts"],"names":[],"mappings":"AAKA,UAAU,gBAAgB;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,YAAY,EAAE,cAAc,EAAE,CAAC;QAC/B,gBAAgB,EAAE,cAAc,EAAE,CAAC;QACnC,UAAU,EAAE,cAAc,EAAE,CAAC;QAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;QAC9B,IAAI,EAAE,cAAc,EAAE,CAAC;QACvB,mEAAmE;QACnE,UAAU,EAAE,cAAc,EAAE,CAAC;QAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;KAC/B,CAAC;CACH;AAaD,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,MAA2B,GAAG,gBAAgB,CAa5F;AAaD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAA2B,GACnC,IAAI,CAWN"}

package/dist/cli/setup/CodexHooks.js

@@ -21,6 +21,7 @@ export function buildCodexHooksConfig(coreDir = getCoreConfigDir()) {
             PostToolUse: [hookEntry(normalizedCoreDir, 'PostToolUse')],
             Stop: [hookEntry(normalizedCoreDir, 'Stop')],
             PreCompact: [hookEntry(normalizedCoreDir, 'PreCompact')],
+            PostCompact: [hookEntry(normalizedCoreDir, 'PostCompact')],
         },
     };
 }

package/dist/cli/setup/CodexHooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"CodexHooks.js","sourceRoot":"","sources":["../../../src/cli/setup/CodexHooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAuBxD,SAAS,cAAc,CAAC,OAAe,EAAE,SAAiB;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvG,OAAO,QAAQ,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,SAAS,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,SAAiB;IACnD,OAAO;QACL,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAkB,gBAAgB,EAAE;IACxE,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO;QACL,KAAK,EAAE;YACL,YAAY,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;YAC5D,gBAAgB,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;YACpE,UAAU,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;YACxD,WAAW,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;YAC1D,IAAI,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;YAC5C,UAAU,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;SACzD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9E,OAAO,MAAiC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,WAAmB,EACnB,UAAkB,gBAAgB,EAAE;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG;QACX,GAAG,QAAQ;QACX,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,KAAK;KAC5C,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"CodexHooks.js","sourceRoot":"","sources":["../../../src/cli/setup/CodexHooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAwBxD,SAAS,cAAc,CAAC,OAAe,EAAE,SAAiB;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvG,OAAO,QAAQ,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,SAAS,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,SAAiB;IACnD,OAAO;QACL,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAkB,gBAAgB,EAAE;IACxE,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO;QACL,KAAK,EAAE;YACL,YAAY,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;YAC5D,gBAAgB,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;YACpE,UAAU,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;YACxD,WAAW,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;YAC1D,IAAI,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;YAC5C,UAAU,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;YACxD,WAAW,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;SAC3D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9E,OAAO,MAAiC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,WAAmB,EACnB,UAAkB,gBAAgB,EAAE;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG;QACX,GAAG,QAAQ;QACX,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,KAAK;KAC5C,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/hooks/plugin-hooks.json

@@ -0,0 +1,123 @@
+{
+  "_comment": "플러그인 번들용 훅 정의. hooks/hooks.json 과 같은 내용이되 경로가 다르다 — npm 설치 경로는 postinstall 이 {{VIBE_PATH}} 를 치환하지만, 플러그인은 치환 단계가 없어 런타임 환경변수 ${PLUGIN_ROOT} 를 쓴다. 두 파일이 갈라지지 않도록 plugin-manifest.test.ts 가 이벤트 집합을 대조한다.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/session-start.js"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/pre-tool-dispatcher.js Bash"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/pre-tool-dispatcher.js Edit"
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/pre-tool-dispatcher.js Write"
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__github__create_pull_request",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/pr-test-gate.js"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/post-edit-dispatcher.js"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write|Bash|Task|SlashCommand|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/step-counter.js"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/prompt-dispatcher.js"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "context_window_80",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/context-save.js medium"
+          }
+        ]
+      },
+      {
+        "matcher": "context_window_90",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/context-save.js high"
+          }
+        ]
+      },
+      {
+        "matcher": "context_window_95",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/context-save.js critical"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${PLUGIN_ROOT}/hooks/scripts/stop-dispatcher.js"
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/scripts/codex-hook-adapter.js

@@ -133,6 +133,27 @@ function handlePreCompact() {
   // stdout 주입 없음 — 압축 직전에 컨텍스트를 더 늘리는 것은 역효과다.
 }
 
+/**
+ * PostCompact → ANCHOR 재고정.
+ *
+ * loop-contract 는 ANCHOR 의 존재 이유를 "컨텍스트가 오염되거나 compact 로 소실돼도
+ * 루프는 깨지지 않는다" 로 규정한다. 그런데 정작 **압축 직후 자동 재고정이 없었다** —
+ * 모델이 스스로 `anchor` 를 다시 부르기를 기대하는 상태였다. 압축은 그 기대가 가장
+ * 깨지기 쉬운 순간이다(방금 지시를 잃은 참이다).
+ *
+ * PreCompact 가 압축 **전** 체크포인트를 저장한다면, PostCompact 는 압축 **후**
+ * 디스크에서 사실을 다시 읽어 컨텍스트에 넣는다. 둘은 짝이다.
+ *
+ * 재고정 결과는 additionalContext 로 주입한다 — 압축 직후는 컨텍스트가 비어 있어
+ * 주입 비용이 가장 싸고 효용이 가장 크다.
+ */
+function handlePostCompact() {
+  const out = combinedOutput(runScript('loop-ledger.js', ['anchor']));
+  if (out && out.trim()) {
+    writeAdditionalContext('[vibe] ANCHOR (post-compact re-anchor):\n' + out.trim());
+  }
+}
+
 switch (eventName) {
   case 'SessionStart':
     writeAdditionalContext(combinedOutput(runScript('session-start.js')));
@@ -152,6 +173,9 @@ switch (eventName) {
   case 'PreCompact':
     handlePreCompact();
     break;
+  case 'PostCompact':
+    handlePostCompact();
+    break;
   default:
     break;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "3.2.25",
+  "version": "3.2.26",
   "description": "AI Coding Framework for Claude Code — 7+ agents, 52 skills, multi-LLM orchestration",
   "type": "module",
   "main": "dist/cli/index.js",
@@ -34,7 +34,9 @@
     "test:coverage": "vitest run --coverage",
     "prepublishOnly": "pnpm build",
     "postinstall": "node -e \"import('./dist/cli/postinstall/main.js').then(m=>m.main()).catch(e=>process.stderr.write('\\u26a0\\ufe0f  vibe postinstall skipped: '+((e&&e.message)||e)+'\\n   Assets and hooks were not installed. Run: npx vibe upgrade\\n'))\"",
-    "release": "bash scripts/release.sh"
+    "release": "bash scripts/release.sh",
+    "sync:plugin-version": "npx tsx scripts/sync-plugin-version.ts",
+    "version": "npx tsx scripts/sync-plugin-version.ts && git add .codex-plugin/plugin.json"
   },
   "keywords": [
     "ai",
@@ -94,6 +96,7 @@
     "vitest": "^4.1.10"
   },
   "files": [
+    ".codex-plugin/",
     "dist/",
     "vibe/",
     "languages/",

package/skills/vibe.harness/SKILL.md

@@ -110,47 +110,7 @@ and dispatch concurrently when capacity permits:
 
 ### 3. Generate Report
 
-```markdown
-## Harness Diagnosis (N/100)
-
-### Score and Grade
-- **Score**: N/100
-- **Grade**: [S / A / B / C / D]
-
-| Grade | Range | Description |
-|-------|-------|-------------|
-| S | 90-100 | Production-ready Harness |
-| A | 75-89 | Well-structured, minor gaps |
-| B | 60-74 | Functional but missing key elements |
-| C | 40-59 | Basic setup, significant gaps |
-| D | 0-39 | Minimal or no Harness |
-
-### Axis Scores
-
-| Axis | Score | Details |
-|------|-------|---------|
-| Scaffolding | /20 | [findings] |
-| Context | /20 | [findings] |
-| Planning | /15 | [findings] |
-| Orchestration | /15 | [findings] |
-| Verification | /15 | [findings] |
-| Compounding | /15 | [findings] |
-
-### Top 3 Improvements
-
-1. **[lowest axis]**: [specific action with command]
-2. **[second lowest]**: [specific action with command]
-3. **[third lowest]**: [specific action with command]
-
-### Auto-Fixable Items
-
-The following can be improved immediately:
-1. [ ] `/vibe.scaffold` — generate missing project directories
-2. [ ] `vibe init` — initialize AI configuration
-3. [ ] `vibe update` — regenerate CLAUDE.md from project analysis
-
-Proceed with auto-fix? (y/n)
-```
+형식: `references/report-template.md` (Step 3 호출 시에만 읽는다).
 
 ### 4. Save Report
 

package/skills/vibe.harness/references/report-template.md

@@ -0,0 +1,46 @@
+# Harness Diagnosis — 리포트 형식
+
+> `vibe.harness` Step 3 이 출력하는 진단 리포트의 형식. 채점 루브릭은 SKILL.md 의
+> `### 2. Score Each Axis` 가 SSOT 다 — 점수 기준을 여기에 다시 적지 않는다.
+
+```markdown
+## Harness Diagnosis (N/100)
+
+### Score and Grade
+- **Score**: N/100
+- **Grade**: [S / A / B / C / D]
+
+| Grade | Range | Description |
+|-------|-------|-------------|
+| S | 90-100 | Production-ready Harness |
+| A | 75-89 | Well-structured, minor gaps |
+| B | 60-74 | Functional but missing key elements |
+| C | 40-59 | Basic setup, significant gaps |
+| D | 0-39 | Minimal or no Harness |
+
+### Axis Scores
+
+| Axis | Score | Details |
+|------|-------|---------|
+| Scaffolding | /20 | [findings] |
+| Context | /20 | [findings] |
+| Planning | /15 | [findings] |
+| Orchestration | /15 | [findings] |
+| Verification | /15 | [findings] |
+| Compounding | /15 | [findings] |
+
+### Top 3 Improvements
+
+1. **[lowest axis]**: [specific action with command]
+2. **[second lowest]**: [specific action with command]
+3. **[third lowest]**: [specific action with command]
+
+### Auto-Fixable Items
+
+The following can be improved immediately:
+1. [ ] `/vibe.scaffold` — generate missing project directories
+2. [ ] `vibe init` — initialize AI configuration
+3. [ ] `vibe update` — regenerate CLAUDE.md from project analysis
+
+Proceed with auto-fix? (y/n)
+```

package/vibe/rules/principles/dual-harness-doctrine.md

@@ -32,17 +32,24 @@
 
 ## Hooks Across Harnesses
 
-CC의 풍부한 hook 모델(PreToolUse/PostToolUse/UserPromptSubmit/Stop)에는 Codex에 완전한 등가물이 없다. hook의 **의도**별로 하네스에 맞는 메커니즘에 매핑한다.
+Codex는 네이티브 hook을 지원한다(`codex features list` → `hooks: stable`). 두 하네스의 이벤트 집합은 이제 거의 겹치므로, **경로만 다르고 의도는 같게** 매핑한다.
 
-Codex도 이제 네이티브 hook을 지원한다(`codex features list` → `hooks: stable`). vibe는 두 메커니즘을 **모두** 사용하며, hook의 **의도**별로 매핑한다.
+> 과거 이 자리에는 "Codex에 완전한 등가물이 없다" 고 적혀 있었다. 실측(2026-08-13)으로 낡은 서술임을 확인했다 — Codex는 SessionStart · UserPromptSubmit · PreToolUse · PostToolUse · PermissionRequest · Stop · SessionEnd · Pre/PostCompact · SubagentStart/Stop 를 제공한다.
 
 | hook 의도 | Claude Code | Codex |
 |---|---|---|
-| 라이프사이클 (turn 완료) | `Stop` hook | `config.toml`의 `notify` (agent-turn-complete 시 JSON 발화) |
-| 세션 시작 | `SessionStart` hook | `.codex/hooks.json` → `SessionStart` |
-| pre-edit / scope guard | `PreToolUse` (동기 deny) | `.codex/hooks.json` → `PreToolUse` (동기 deny) |
-| 키워드 디스패치 | `UserPromptSubmit` | `.codex/hooks.json` → `UserPromptSubmit` |
+| 세션 시작 | `SessionStart` | `.codex/hooks.json` → `SessionStart` |
+| 키워드 디스패치 | `UserPromptSubmit` | `UserPromptSubmit` |
+| pre-edit / scope guard | `PreToolUse` (동기 deny) | `PreToolUse` (동기 deny) |
 | 금지 패턴 차단 | `PreToolUse` | `PreToolUse` + AGENTS.md 규칙 (이중 방어) |
+| 편집 후 품질 검사 | `PostToolUse` | `PostToolUse` |
+| 압축 전 체크포인트 | `Notification` (context_window_*) | `PreCompact` — 임계치 추정이 아닌 확정 신호라 더 정확 |
+| **압축 후 재고정** | (없음 — 모델이 `anchor` 호출) | **`PostCompact` → `loop-ledger.js anchor`** |
+| 라이프사이클 (turn 완료) | `Stop` hook | `config.toml` 의 `notify` (아래 참조) |
+
+**`Stop` 이 아니라 `notify` 를 쓰는 이유**: Codex 도 `Stop` 이벤트를 제공하고 vibe 도 등록해 두었지만, turn 완료 후처리(auto-commit·devlog)는 `notify` 가 담당한다. 둘 다에서 실행하면 커밋이 중복된다 — `Stop` 핸들러는 의도적으로 비워 둔다.
+
+**미등록 이벤트와 이유**: `SessionEnd`(타임아웃 1초 — 무거운 작업 불가) · `SubagentStart/Stop`(계측 외 용도 없음) · `PermissionRequest`(비용 게이트를 하네스 강제로 올릴 자리 — 후보로 남김).
 
 **구현**: `hooks/scripts/codex-hook-adapter.js`가 Codex hook 이벤트를 기존 vibe hook 스크립트로 번역하고 deny 결정(JSON)을 보존한다. 설치는 `installProjectCodexHooks()` → `.codex/hooks.json` (프로젝트 로컬, gitignored). 라이프사이클 후처리(auto-commit·devlog)는 `codex-notify.js`가 `notify` 경로로 담당한다.
 

package/vibe/templates/loop-template.md

@@ -52,18 +52,24 @@ status: active
 - `verify: tests` — `test_command` exit code 0
 - `verify: none` — 파이프라인 마지막 스킬 완료 시
 - 연속 2회 `discoverHash` 동일 → stuck으로 중단, 인박스 기록
+- `max_iterations` 소진 → 잔여를 인박스로 이월. **회전 수는 코드가 센다** —
+  `loop-ledger.js iteration <name> <verified|unverified>` 로 기록하고
+  `budget <name> <max>` 로 확인한다 (모델이 세지 않는다)
+- 실행 실패(스킬 미설치·도구 부재·명령 비정상 종료) → stuck 이 아니라 즉시 종료.
+  같은 방식으로 재시도하지 않는다
+
+전문: `vibe/rules/loop-contract.md` (예산 · 실행 실패 절)
 
 ## 인박스 보고 형식
 
-{각 반복 완료 후 `.vibe/loops/inbox.md`에 추가되는 항목 형식.}
+블록 형식과 최신순 정렬은 **명령이 보장한다** — 손으로 마크다운을 쓰지 않는다:
 
+```bash
+node "$HOOKS_DIR/loop-ledger.js" inbox {loop-name} <ok|fail|stuck> \
+  "발견: N건 / 처리: M건 / 검증: {기준과 결과}" \
+  "리뷰 필요: {사람이 확인해야 할 사항 — 없으면 없음}"
 ```
-## [{loop-name}] {YYYY-MM-DD HH:mm}
 
-- **결과**: ok | fail | stuck
-- **처리한 항목**: {항목 설명}
-- **검증 상태**: verifyPassed=true | false
-- **리뷰 필요**: {사람이 확인해야 할 사항. 없으면 "없음"}
-```
+기록되는 형식: `## {loop-name} — {ISO 시각} — {결과}` + 본문 줄들.
 
 > 루프는 push·release·배포를 수행하지 않는다. auto-commit verify 게이트 통과 시 커밋까지만.