@su-record/vibe 3.2.47 → 3.2.49

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vibe",
   "displayName": "Vibe",
-  "version": "3.2.47",
+  "version": "3.2.49",
   "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.47",
+  "version": "3.2.49",
   "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/hooks/scripts/lib/loop-ledger.js

@@ -36,7 +36,7 @@ export function hashDiscoverOutput(text) {
  * 루프 이벤트를 jsonl 파일에 append한다.
  *
  * @param {string} projectDir
- * @param {{ loop: string, event: 'start'|'discover'|'end'|'iteration', result?: 'ok'|'fail'|'stuck', summary?: string, discoverHash?: string, verified?: boolean }} opts
+ * @param {{ loop: string, event: 'start'|'discover'|'end'|'iteration'|'trial-approved', result?: 'ok'|'fail'|'stuck', summary?: string, discoverHash?: string, verified?: boolean }} opts
  * @returns {boolean} 성공 여부
  */
 export function appendLoopEvent(projectDir, opts) {
@@ -169,3 +169,49 @@ export function readBudget(projectDir, loop, maxIterations = 10) {
     return empty;
   }
 }
+
+/**
+ * 시운전 게이트 — 처음 거는 루프는 **두 바퀴만** 돌고 멈춘다.
+ *
+ * WHY: 자율 루프의 첫 실행은 정의가 맞는지 아무도 모르는 상태다. discover 가
+ * 엉뚱한 것을 긁거나 verify 기준이 틀려 있으면 루프는 그걸 **성실하게 반복**한다.
+ * 사람이 안 보는 동안 도는 것이 목적이므로, 틀린 채로 도는 것도 안 보인다.
+ * 그래서 처음에는 몇 바퀴만 돌려 기록을 눈으로 확인한 뒤 풀어준다.
+ *
+ * `max_iterations` 와는 다른 축이다 — 그건 **한 실행의 폭주**를 막고, 이건
+ * **정의가 검증되지 않은 루프**를 막는다. 폭주 예산은 매 `start` 마다 초기화되지만
+ * 시운전은 승인 전까지 계속 걸린다.
+ *
+ * 승인은 이력에 남긴다(`event: 'trial-approved'`) — 설정 파일이 아니라 원장에
+ * 두는 이유는 루프별로 다르고, 언제 누가 풀었는지가 감사 대상이기 때문이다.
+ *
+ * @param {string} projectDir
+ * @param {string} loop
+ * @param {number} [trialIterations=2] 시운전 회전 수
+ * @returns {{ inTrial: boolean, cap: number|null, iterations: number, exhausted: boolean }}
+ */
+export function readTrialGate(projectDir, loop, trialIterations = 2) {
+  const cap = Math.max(1, Number(trialIterations) || 2);
+  try {
+    const raw = fs.readFileSync(historyPath(projectDir), 'utf-8');
+    const events = raw.split('\n')
+      .map(line => { try { return JSON.parse(line); } catch { return null; } })
+      .filter(e => e && e.loop === loop);
+
+    if (events.some(e => e.event === 'trial-approved')) {
+      return { inTrial: false, cap: null, iterations: 0, exhausted: false };
+    }
+
+    // 시운전 회전은 실행을 가로질러 누적한다 — 매 start 마다 초기화되면
+    // 루프를 다시 걸기만 해도 시운전이 무한정 연장된다.
+    const iterations = events.filter(e => e.event === 'iteration').length;
+    return { inTrial: true, cap, iterations, exhausted: iterations >= cap };
+  } catch {
+    return { inTrial: true, cap, iterations: 0, exhausted: false };
+  }
+}
+
+/** 시운전을 풀어 이 루프를 정상 예산으로 돌린다 — 사람이 기록을 확인한 뒤 호출한다 */
+export function approveTrial(projectDir, loop) {
+  return appendLoopEvent(projectDir, { loop, event: 'trial-approved' });
+}

package/hooks/scripts/loop-ledger.js

@@ -13,13 +13,17 @@
  *   node hooks/scripts/loop-ledger.js gate answer <id> <answer>
  *   node hooks/scripts/loop-ledger.js iteration <name> <verified|unverified>
  *   node hooks/scripts/loop-ledger.js budget <name> [maxIterations]
+ *   node hooks/scripts/loop-ledger.js trial <name> [trialIterations]
+ *   node hooks/scripts/loop-ledger.js trial-approve <name>
  *
  * check-stuck: 'stuck' 또는 'ok'를 stdout에 출력하고 항상 exit 0.
  * anchor: 재고정 번들 JSON을 stdout에 출력한다 (loop-contract ANCHOR 절).
  * 항상 exit 0 (fail-open).
  */
 
-import { appendLoopEvent, isStuck, recordIteration, readBudget } from './lib/loop-ledger.js';
+import {
+  appendLoopEvent, isStuck, recordIteration, readBudget, readTrialGate, approveTrial,
+} from './lib/loop-ledger.js';
 import { buildAnchor } from './lib/anchor.js';
 import { prependInboxBlock } from './lib/inbox.js';
 import { openGate, listOpenGates, answerGate, formatOpenGates } from './lib/gates.js';
@@ -96,6 +100,26 @@ if (subcommand === 'start') {
   const b = readBudget(projectDir, loop, Number.isInteger(max) && max > 0 ? max : 10);
   process.stdout.write(JSON.stringify(b) + '\n');
 
+} else if (subcommand === 'trial') {
+  // 처음 거는 루프는 몇 바퀴만 돌고 멈춘다 — 정의가 틀린 채로 성실히 반복하는 것을 막는다
+  const [loop, capRaw] = args;
+  if (!loop) {
+    process.stdout.write('[loop-ledger] error: trial 에 루프 이름이 필요합니다\n');
+    process.exit(0);
+  }
+  const cap = Number.parseInt(capRaw ?? '2', 10);
+  const t = readTrialGate(projectDir, loop, Number.isInteger(cap) && cap > 0 ? cap : 2);
+  process.stdout.write(JSON.stringify(t) + '\n');
+
+} else if (subcommand === 'trial-approve') {
+  const [loop] = args;
+  if (!loop) {
+    process.stdout.write('[loop-ledger] error: trial-approve 에 루프 이름이 필요합니다\n');
+    process.exit(0);
+  }
+  approveTrial(projectDir, loop);
+  process.stdout.write(`[loop-ledger] ${loop} 시운전 해제 — 이후 max_iterations 예산으로 돈다\n`);
+
 } else if (subcommand === 'gate') {
   // 사람 판단 지점을 디스크에 남긴다 — 세션이 죽어도 무엇을 묻고 있었는지 남는다
   const [action, id, ...rest] = args;

package/package.json

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

package/skills/vibe.loop/SKILL.md

@@ -52,7 +52,7 @@ HISTORY=".vibe/metrics/loop-history.jsonl"
 3. **생성 직후 반드시 검증한다** — 실패 시 정의를 고치고 재검증, 통과 전에는 install/run 금지:
 
 ```bash
-node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const fs = require('fs'); const r = t.validateLoopDefinition(fs.readFileSync('.vibe/loops/<name>.md', 'utf-8')); console.log(JSON.stringify(r.errors.length ? r.errors : 'valid')); })"
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/loop/index.js').then(t => { const fs = require('fs'); const r = t.validateLoopDefinition(fs.readFileSync('.vibe/loops/<name>.md', 'utf-8')); console.log(JSON.stringify(r.errors.length ? r.errors : 'valid')); })"
 ```
 
 **기본 제안 레시피 — nightly-triage** (사용자가 목표를 정하지 못하면 이것을 제안):
@@ -73,6 +73,9 @@ node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index
              → missing[] 이 비어 있지 않으면 없는 아티팩트를 기억으로 메우지 않는다.
                재고정 실패를 인박스에 남기고 종료한다.
 1. 검증     validateLoopDefinition 통과 확인 (위 design 3의 명령) — 실패 시 인박스에 기록 후 종료
+1-b. 시운전   node "$HOOKS_DIR/loop-ledger.js" trial <name> [trial_iterations]
+             → `inTrial: true` 면 이 실행의 회전 상한은 `cap` 이다 (max_iterations 아님).
+               `exhausted: true` 면 **한 바퀴도 돌지 않고** 종료한다 — 6-c 참조.
 2. 시작 기록  node "$HOOKS_DIR/loop-ledger.js" start <name>
 3. DISCOVER  정의의 discover 지시 실행 → 일거리 목록 산출
 4. STUCK 검사 DISCOVER_HASH=$(node -e "...hashDiscoverOutput...")   # 발견 목록 텍스트의 해시
@@ -91,6 +94,13 @@ node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index
              node "$HOOKS_DIR/loop-ledger.js" budget <name> <max_iterations>
              → exhausted 면 잔여를 인박스로 이월하고 종료한다. 회전 수를 모델이
                세지 않는다 — 폭주 방어는 코드가 판정한다 (loop-contract 예산 절).
+6-c. 시운전 확인 시운전 중이면(1-b 의 `inTrial`) 매 회전 뒤 다시 확인한다:
+             node "$HOOKS_DIR/loop-ledger.js" trial <name> [trial_iterations]
+             → exhausted 면 **거기서 멈춘다.** 인박스에 아래를 남기고 종료:
+               · 무엇을 발견했고 무엇을 고쳤는지 (회전별 한 줄)
+               · 확인할 것: `.vibe/metrics/loop-history.jsonl` 과 실제 변경 diff
+               · 이어서 돌리려면: loop-ledger.js trial-approve <name>
+               승인 없이 계속 도는 것 금지 — 정의가 맞는지 아직 아무도 모른다.
 7. 종료 기록  node "$HOOKS_DIR/loop-ledger.js" end <name> <ok|fail|stuck> "<한 줄 요약>"
 8. 인박스    node "$HOOKS_DIR/loop-ledger.js" inbox <name> <ok|fail|stuck> \
                "발견: N건 / 처리: M건 / 검증: <기준과 결과>" \

package/skills/vibe.loop/references/install-adapters.md

@@ -6,5 +6,20 @@ Load only for `vibe.loop install`. Never register a schedule without the user's
 |------|------|
 | Claude Code (세션 루프) | `/loop <interval> "/vibe.loop run <name>"` |
 | Claude Code (클라우드 루틴) | `/schedule`로 cron `<schedule>` + prompt `/vibe.loop run <name>` 등록 |
-| OS cron fallback | `<schedule> cd <project> && claude -p "/vibe.loop run <name>" --permission-mode acceptEdits` |
+| OS cron fallback | 아래 참조 — **PATH 를 반드시 명시한다** |
+
+### OS cron 등록
+
+```cron
+# PATH 를 적지 않으면 cron 은 /usr/bin:/bin 만 들고 실행한다 — claude 를 찾지 못해
+# 루프가 **아무 소리 없이** 한 번도 돌지 않는다. 등록 전에 실제 경로를 확인할 것:
+#   which claude   →  예: /usr/local/bin/claude, ~/.local/bin/claude, ~/.nvm/.../bin/claude
+PATH=/usr/local/bin:/usr/bin:/bin:<claude 가 있는 디렉토리>
+
+<schedule> cd <project> && claude -p "/vibe.loop run <name>" --permission-mode acceptEdits >> <project>/.vibe/loops/<name>.log 2>&1
+```
+
+- **PATH**: `which claude` 결과의 디렉토리를 반드시 포함시킨다. nvm·Homebrew·`~/.local/bin` 중 어디든 cron 기본 PATH 에는 없다
+- **로그 리다이렉트**: cron 은 출력을 메일로 보내거나 버린다. 파일로 받아야 루프가 왜 멈췄는지 알 수 있다
+- **등록 후 1회 검증**: 다음 실행 시각을 기다리지 말고 같은 명령을 `env -i PATH=... sh -c '...'` 로 한 번 돌려 본다 — cron 과 같은 최소 환경에서 되는지 확인하는 것이 목적이다
 | Codex | Automations에 `<schedule>` + `$vibe.loop run <name>` 등록 |

package/vibe/rules/loop-contract.md

@@ -195,4 +195,14 @@ JUDGE는 이번 feature의 **신규 생성 파일** 기준으로 검증 코드
 | `ralplan` | 같은 계약을 계획 단계에 적용 |
 | `ultrawork` / `ulw` | `automationLevel: autonomous` + 병렬 ACT — 루프 시맨틱이 아니라 자율성·병렬성 축. **병렬 항목이 파일을 수정하면 항목별 worktree 격리 필수** (`vibe.loop` 의 `isolation` 축과 같은 규칙) |
 
+### 시운전 (처음 거는 루프)
+승인 이력이 없는 루프는 **`trial_iterations`(기본 2) 회전만 돌고 멈춘다.** `max_iterations` 와 다른 축이다 — 그건 한 실행의 폭주를 막고, 이건 **정의가 검증되지 않은 루프**를 막는다. 폭주 예산은 매 `start` 마다 초기화되지만 시운전 회전은 실행을 가로질러 누적한다(다시 걸기만 해도 연장되면 게이트가 무의미하다).
+
+| 판정 | 명령 |
+|---|---|
+| 시운전 상태 | `loop-ledger.js trial <name> [n]` → `{inTrial, cap, iterations, exhausted}` |
+| 해제 | `loop-ledger.js trial-approve <name>` — 사람이 기록을 확인한 뒤 |
+
+WHY: 자율 루프의 첫 실행은 정의가 맞는지 아무도 모르는 상태다. discover 가 엉뚱한 것을 긁거나 verify 기준이 틀려 있으면 루프는 그걸 **성실하게 반복한다.** 사람이 안 보는 동안 도는 것이 목적이므로 틀린 채로 도는 것도 안 보인다. 해제 기록을 설정이 아니라 원장에 남기는 이유는 루프별로 다르고 언제 풀렸는지가 감사 대상이기 때문이다.
+
 > **폭이 수십 단위를 넘으면** Claude Code 네이티브 `Workflow`(누적 1000 에이전트 / 동시 min(16, cores-2))를 **제안**한다 — 자동 전환하지 않는다. 옵트인 도구이고, 조율 비용만 절약될 뿐 에이전트 사용량은 그대로 든다. Codex 에는 등가물이 없으므로 루프 계약 자체는 양쪽 동일하게 유지한다. 넘기더라도 위의 격리 규정과 검증자 컨텍스트 규정은 그대로 적용된다. 상세: `CLAUDE.md` "폭이 큰 작업 — 네이티브 workflow 로 라우팅".