@su-record/vibe 2.12.5 → 2.14.0

package/hooks/scripts/__tests__/run-ledger-verify-required.test.js

@@ -0,0 +1,146 @@
+/**
+ * run-ledger verifyRequired 확장 테스트
+ *
+ * 검증 대상:
+ *   - recordVerifyRequired: verifyRequired=true, reason 설정
+ *   - recordVerify(pass) → verifyRequired 클리어
+ *   - recordVerify(fail) → verifyRequired 유지
+ *   - auto-commit 게이트: verifyRequired=true 시 skip
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { fileURLToPath } from 'url';
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+let tmpDir;
+beforeEach(() => {
+  tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'vibe-verify-required-'));
+});
+afterEach(() => {
+  try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch { /* ignore */ }
+});
+
+async function importLedger() {
+  const ledgerPath = path.resolve(__dirname, '..', 'lib', 'run-ledger.js');
+  return import(ledgerPath);
+}
+
+describe('run-ledger: verifyRequired', () => {
+  it('초기 상태: verifyRequired 없음', async () => {
+    const { recordRunStart, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+    const ledger = readLedger(tmpDir);
+    // verifyRequired는 undefined 또는 false여야 함
+    expect(ledger.verifyRequired).toBeFalsy();
+  });
+
+  it('recordVerifyRequired → verifyRequired=true, reason 설정', async () => {
+    const { recordRunStart, recordVerifyRequired, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+    recordVerifyRequired(tmpDir, 'P1 any-type line 5');
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyRequired).toBe(true);
+    expect(ledger.verifyRequiredReason).toBe('P1 any-type line 5');
+  });
+
+  it('recordVerify(pass) → verifyRequired 클리어', async () => {
+    const { recordRunStart, recordVerifyRequired, recordVerify, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+    recordVerifyRequired(tmpDir, 'P1 console.log found');
+    recordVerify(tmpDir, true);
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyRequired).toBe(false);
+    expect(ledger.verifyRequiredReason).toBeNull();
+    expect(ledger.verifyPassed).toBe(true);
+  });
+
+  it('recordVerify(fail) → verifyRequired 유지됨', async () => {
+    const { recordRunStart, recordVerifyRequired, recordVerify, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+    recordVerifyRequired(tmpDir, 'P1 issue');
+    recordVerify(tmpDir, false);
+    const ledger = readLedger(tmpDir);
+    // fail 시 verifyRequired는 유지되어야 함
+    expect(ledger.verifyRequired).toBe(true);
+    expect(ledger.verifyPassed).toBe(false);
+  });
+
+  it('reason 없이 recordVerifyRequired → 기본 reason 설정', async () => {
+    const { recordRunStart, recordVerifyRequired, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+    recordVerifyRequired(tmpDir, '');
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyRequired).toBe(true);
+    expect(typeof ledger.verifyRequiredReason).toBe('string');
+  });
+
+  it('recordVerifyRequired fail-open (레저 없이도 작동)', async () => {
+    const { recordVerifyRequired, readLedger } = await importLedger();
+    // runStart 없이 호출
+    recordVerifyRequired(tmpDir, 'standalone P1');
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyRequired).toBe(true);
+  });
+});
+
+describe('auto-commit: verifyRequired 게이트 로직', () => {
+  function autoCommitGatePass(ledger) {
+    if (!ledger) return true;
+
+    // verify 게이트 (기존)
+    if (ledger.runStarted) {
+      const verifyOk = ledger.verifyPassed === true
+        && ledger.verifyAt
+        && ledger.verifyAt > ledger.runStarted;
+      if (!verifyOk) return false;
+    }
+
+    // verifyRequired 게이트 (신규)
+    if (ledger.verifyRequired === true) return false;
+
+    return true;
+  }
+
+  it('verifyRequired=true → 차단', () => {
+    expect(autoCommitGatePass({
+      runStarted: null,
+      verifyRequired: true,
+      verifyRequiredReason: 'P1 any-type',
+    })).toBe(false);
+  });
+
+  it('verifyRequired=false → 통과 (verifyRequired만 확인 시)', () => {
+    expect(autoCommitGatePass({
+      runStarted: null,
+      verifyRequired: false,
+    })).toBe(true);
+  });
+
+  it('verifyRequired=undefined → 통과 (기존 레저 호환)', () => {
+    expect(autoCommitGatePass({
+      runStarted: null,
+      verifyRequired: undefined,
+    })).toBe(true);
+  });
+
+  it('runStarted + verifyPassed + verifyRequired=true → 차단 (verifyRequired 우선)', () => {
+    expect(autoCommitGatePass({
+      runStarted: '2026-01-01T10:00:00.000Z',
+      verifyPassed: true,
+      verifyAt: '2026-01-01T10:05:00.000Z',
+      verifyRequired: true,
+    })).toBe(false);
+  });
+
+  it('runStarted + verifyPassed + verifyRequired=false → 통과', () => {
+    expect(autoCommitGatePass({
+      runStarted: '2026-01-01T10:00:00.000Z',
+      verifyPassed: true,
+      verifyAt: '2026-01-01T10:05:00.000Z',
+      verifyRequired: false,
+    })).toBe(true);
+  });
+});

package/hooks/scripts/__tests__/run-ledger.test.js

@@ -0,0 +1,330 @@
+/**
+ * run-ledger 라이브러리 테스트
+ *
+ * REQ-harness-remediation-005, 006, 007, 008 커버리지:
+ *   - round-trip 읽기/쓰기
+ *   - verifyAt > runStarted 로직
+ *   - extractRunFeature / isVibeRunPrompt 헬퍼
+ *   - recordRunStart → verifyPassed 리셋
+ *   - recordVerify pass/fail
+ *   - prompt-dispatcher 에서의 vibe.run 감지 (CLI 실행)
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execFileSync, spawnSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// 테스트 격리용 임시 디렉토리
+let tmpDir;
+beforeEach(() => {
+  tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'vibe-ledger-test-'));
+});
+afterEach(() => {
+  try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch { /* ignore */ }
+});
+
+// 모듈 임포트 (ESM 동적)
+async function importLedger() {
+  const ledgerPath = path.resolve(__dirname, '..', 'lib', 'run-ledger.js');
+  // 캐시 버스팅 불필요 — 순수 함수, 상태 없음
+  return import(ledgerPath);
+}
+
+// ──────────────────────────────────────────────────────────────────
+// readLedger / recordRunStart / recordVerify round-trip
+// ──────────────────────────────────────────────────────────────────
+describe('run-ledger: round-trip', () => {
+  it('존재하지 않는 레저 → null 반환', async () => {
+    const { readLedger } = await importLedger();
+    const result = readLedger(tmpDir);
+    expect(result).toBeNull();
+  });
+
+  it('recordRunStart 후 읽으면 runStarted가 ISO 문자열', async () => {
+    const { recordRunStart, readLedger } = await importLedger();
+    const before = new Date().toISOString();
+    recordRunStart(tmpDir, 'my-feature');
+    const ledger = readLedger(tmpDir);
+    expect(ledger).not.toBeNull();
+    expect(ledger.runStarted).toBeDefined();
+    expect(ledger.runStarted >= before).toBe(true);
+    expect(ledger.runFeature).toBe('my-feature');
+  });
+
+  it('recordRunStart는 verifyPassed를 false로 리셋', async () => {
+    const { recordRunStart, recordVerify, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'f1');
+    recordVerify(tmpDir, true);
+    // 두 번째 run — 리셋
+    recordRunStart(tmpDir, 'f2');
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyPassed).toBe(false);
+    expect(ledger.verifyAt).toBeNull();
+    expect(ledger.stopWarned).toBe(false);
+  });
+
+  it('recordVerify(pass) → verifyPassed=true, verifyAt 설정', async () => {
+    const { recordRunStart, recordVerify, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+    const before = new Date().toISOString();
+    recordVerify(tmpDir, true);
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyPassed).toBe(true);
+    expect(ledger.verifyAt).toBeDefined();
+    expect(ledger.verifyAt >= before).toBe(true);
+  });
+
+  it('recordVerify(fail) → verifyPassed=false', async () => {
+    const { recordRunStart, recordVerify, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+    recordVerify(tmpDir, false);
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyPassed).toBe(false);
+  });
+});
+
+// ──────────────────────────────────────────────────────────────────
+// verifyAt > runStarted 관계 검증
+// ──────────────────────────────────────────────────────────────────
+describe('run-ledger: verifyAt > runStarted', () => {
+  it('recordVerify 후 verifyAt > runStarted', async () => {
+    const { recordRunStart, recordVerify, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'f');
+    // 동일 밀리초 내 실행 가능성을 피하기 위해 runStarted를 과거로 조작
+    const ledger = readLedger(tmpDir);
+    const p = path.join(tmpDir, '.vibe', 'metrics', 'run-ledger.json');
+    const patched = { ...ledger, runStarted: new Date(Date.now() - 1000).toISOString() };
+    fs.writeFileSync(p, JSON.stringify(patched), 'utf-8');
+
+    recordVerify(tmpDir, true);
+    const after = readLedger(tmpDir);
+    expect(after.verifyAt > after.runStarted).toBe(true);
+    expect(after.verifyPassed).toBe(true);
+  });
+
+  it('verifyAt이 runStarted보다 이르면 gate 불충족 (simulate)', async () => {
+    const { readLedger } = await importLedger();
+    const p = path.join(tmpDir, '.vibe', 'metrics', 'run-ledger.json');
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const now = new Date();
+    // runStarted가 verifyAt보다 나중
+    const data = {
+      runStarted: new Date(now.getTime() + 5000).toISOString(),
+      runFeature: 'f',
+      verifyPassed: true,
+      verifyAt: now.toISOString(),
+      stopWarned: false,
+    };
+    fs.writeFileSync(p, JSON.stringify(data), 'utf-8');
+    const ledger = readLedger(tmpDir);
+    // auto-commit 게이트 로직: verifyPassed=true 이지만 verifyAt < runStarted
+    const gatePass = ledger.verifyPassed === true
+      && ledger.verifyAt
+      && ledger.verifyAt > ledger.runStarted;
+    expect(gatePass).toBe(false);
+  });
+});
+
+// ──────────────────────────────────────────────────────────────────
+// isVibeRunPrompt / extractRunFeature
+// ──────────────────────────────────────────────────────────────────
+describe('run-ledger: vibe.run 감지 헬퍼', () => {
+  it('/vibe.run 감지', async () => {
+    const { isVibeRunPrompt } = await importLedger();
+    expect(isVibeRunPrompt('/vibe.run my-feature')).toBe(true);
+  });
+
+  it('$vibe.run 감지', async () => {
+    const { isVibeRunPrompt } = await importLedger();
+    expect(isVibeRunPrompt('$vibe.run my-feature')).toBe(true);
+  });
+
+  it('대소문자 무관', async () => {
+    const { isVibeRunPrompt } = await importLedger();
+    expect(isVibeRunPrompt('/VIBE.RUN feature')).toBe(true);
+  });
+
+  it('부분 매칭 방지 — vibe.runs 는 미감지', async () => {
+    const { isVibeRunPrompt } = await importLedger();
+    // "vibe.runs"는 \b로 경계 처리됨
+    expect(isVibeRunPrompt('vibe.runs everything')).toBe(false);
+  });
+
+  it('단어 내 포함은 미감지', async () => {
+    const { isVibeRunPrompt } = await importLedger();
+    expect(isVibeRunPrompt('I was talking about vibe.runner')).toBe(false);
+  });
+
+  it('extractRunFeature: 기능명 추출', async () => {
+    const { extractRunFeature } = await importLedger();
+    expect(extractRunFeature('/vibe.run my-feature')).toBe('my-feature');
+  });
+
+  it('extractRunFeature: $vibe.run에서 추출', async () => {
+    const { extractRunFeature } = await importLedger();
+    expect(extractRunFeature('$vibe.run auth-login ultrawork')).toBe('auth-login');
+  });
+
+  it('extractRunFeature: 기능명 없으면 null', async () => {
+    const { extractRunFeature } = await importLedger();
+    expect(extractRunFeature('/vibe.run --phase 1')).toBeNull();
+  });
+
+  it('extractRunFeature: /vibe.run만 있으면 null', async () => {
+    const { extractRunFeature } = await importLedger();
+    expect(extractRunFeature('/vibe.run')).toBeNull();
+  });
+});
+
+// ──────────────────────────────────────────────────────────────────
+// markStopWarned
+// ──────────────────────────────────────────────────────────────────
+describe('run-ledger: stopWarned', () => {
+  it('markStopWarned → stopWarned=true', async () => {
+    const { recordRunStart, markStopWarned, readLedger } = await importLedger();
+    recordRunStart(tmpDir, 'f');
+    markStopWarned(tmpDir);
+    const ledger = readLedger(tmpDir);
+    expect(ledger.stopWarned).toBe(true);
+  });
+});
+
+// ──────────────────────────────────────────────────────────────────
+// verify-ledger.js CLI
+// ──────────────────────────────────────────────────────────────────
+describe('verify-ledger CLI', () => {
+  const CLI = path.resolve(__dirname, '..', 'verify-ledger.js');
+
+  it('pass 인자 → verifyPassed=true, exit 0', async () => {
+    const { recordRunStart } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+
+    const result = spawnSync('node', [CLI, 'pass'], {
+      encoding: 'utf-8',
+      timeout: 5000,
+      env: { ...process.env, CLAUDE_PROJECT_DIR: tmpDir },
+    });
+    expect(result.status).toBe(0);
+    expect(result.stdout).toContain('verifyPassed=true');
+
+    const { readLedger } = await importLedger();
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyPassed).toBe(true);
+  });
+
+  it('fail 인자 → verifyPassed=false, exit 0', async () => {
+    const { recordRunStart } = await importLedger();
+    recordRunStart(tmpDir, 'feat');
+
+    const result = spawnSync('node', [CLI, 'fail'], {
+      encoding: 'utf-8',
+      timeout: 5000,
+      env: { ...process.env, CLAUDE_PROJECT_DIR: tmpDir },
+    });
+    expect(result.status).toBe(0);
+    expect(result.stdout).toContain('verifyPassed=false');
+
+    const { readLedger } = await importLedger();
+    const ledger = readLedger(tmpDir);
+    expect(ledger.verifyPassed).toBe(false);
+  });
+
+  it('인자 없이도 exit 0 (fail-open)', () => {
+    const result = spawnSync('node', [CLI], {
+      encoding: 'utf-8',
+      timeout: 5000,
+      env: { ...process.env, CLAUDE_PROJECT_DIR: tmpDir },
+    });
+    expect(result.status).toBe(0);
+  });
+});
+
+// ──────────────────────────────────────────────────────────────────
+// prompt-dispatcher vibe.run 감지 (sanity — ledger 파일 생성 확인)
+// ──────────────────────────────────────────────────────────────────
+describe('prompt-dispatcher: vibe.run 감지 → ledger 파일 생성', () => {
+  const DISPATCHER = path.resolve(__dirname, '..', 'prompt-dispatcher.js');
+
+  it('/vibe.run 프롬프트 → run-ledger.json 생성', () => {
+    const payload = JSON.stringify({ prompt: '/vibe.run test-feature' });
+    const result = spawnSync('node', [DISPATCHER], {
+      input: payload,
+      encoding: 'utf-8',
+      timeout: 10000,
+      env: {
+        ...process.env,
+        CLAUDE_PROJECT_DIR: tmpDir,
+        VIBE_HOOK_DEPTH: undefined,
+        // keyword-detector 등 자식 프로세스 타임아웃 내 완료
+      },
+    });
+    expect(result.status).toBe(0);
+    const ledgerFile = path.join(tmpDir, '.vibe', 'metrics', 'run-ledger.json');
+    expect(fs.existsSync(ledgerFile)).toBe(true);
+    const ledger = JSON.parse(fs.readFileSync(ledgerFile, 'utf-8'));
+    expect(ledger.runStarted).toBeDefined();
+    expect(ledger.runFeature).toBe('test-feature');
+    expect(ledger.verifyPassed).toBe(false);
+  });
+
+  it('일반 프롬프트 → ledger 파일 미생성', () => {
+    const payload = JSON.stringify({ prompt: 'implement the login form' });
+    spawnSync('node', [DISPATCHER], {
+      input: payload,
+      encoding: 'utf-8',
+      timeout: 10000,
+      env: { ...process.env, CLAUDE_PROJECT_DIR: tmpDir },
+    });
+    const ledgerFile = path.join(tmpDir, '.vibe', 'metrics', 'run-ledger.json');
+    expect(fs.existsSync(ledgerFile)).toBe(false);
+  });
+});
+
+// ──────────────────────────────────────────────────────────────────
+// auto-commit 게이트 로직 (단위 수준 — 레저 상태별 gate 검증)
+// ──────────────────────────────────────────────────────────────────
+describe('auto-commit: verify gate 로직 (레저 상태 시뮬레이션)', () => {
+  function gatePass(ledger) {
+    if (!ledger || !ledger.runStarted) return true; // 레저 없으면 통과 (기존 동작)
+    return ledger.verifyPassed === true
+      && ledger.verifyAt
+      && ledger.verifyAt > ledger.runStarted;
+  }
+
+  it('레저 없음 → 통과 (기존 동작 유지)', () => {
+    expect(gatePass(null)).toBe(true);
+  });
+
+  it('runStarted 없음 → 통과', () => {
+    expect(gatePass({ verifyPassed: false, verifyAt: null })).toBe(true);
+  });
+
+  it('verifyPassed=false → 차단', () => {
+    expect(gatePass({
+      runStarted: '2026-01-01T10:00:00.000Z',
+      verifyPassed: false,
+      verifyAt: null,
+    })).toBe(false);
+  });
+
+  it('verifyPassed=true + verifyAt > runStarted → 통과', () => {
+    expect(gatePass({
+      runStarted: '2026-01-01T10:00:00.000Z',
+      verifyPassed: true,
+      verifyAt: '2026-01-01T10:05:00.000Z',
+    })).toBe(true);
+  });
+
+  it('verifyPassed=true 이지만 verifyAt < runStarted → 차단', () => {
+    expect(gatePass({
+      runStarted: '2026-01-01T10:05:00.000Z',
+      verifyPassed: true,
+      verifyAt: '2026-01-01T10:00:00.000Z',
+    })).toBe(false);
+  });
+});

package/hooks/scripts/__tests__/scope-from-spec.test.js

@@ -0,0 +1,215 @@
+/**
+ * scope-from-spec.js 단위 테스트
+ *
+ * REQ-harness-remediation-009: scope-guard 기본 활성화
+ *  - enabled 미설정(undefined) → sync 실행 (기본 ON)
+ *  - enabled === false → skip (명시적 opt-out)
+ *  - SPEC 없음 → scope.json 생성 안 함 (노이즈 가드)
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { isScopeGuardEnabled, syncScopeFile, findActiveSpecs } from '../lib/scope-from-spec.js';
+
+// 임시 프로젝트 디렉토리 헬퍼
+function makeTempDir() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), 'vibe-scope-test-'));
+}
+
+function cleanDir(dir) {
+  try { fs.rmSync(dir, { recursive: true, force: true }); } catch { /* ignore */ }
+}
+
+// config.json 작성 헬퍼
+function writeConfig(dir, scopeGuard) {
+  const vibeDir = path.join(dir, '.vibe');
+  fs.mkdirSync(vibeDir, { recursive: true });
+  fs.writeFileSync(path.join(vibeDir, 'config.json'), JSON.stringify({ scopeGuard }));
+}
+
+// 최소 SPEC 작성 헬퍼
+function writeSpec(dir, filename, content, status = 'in-progress') {
+  const specsDir = path.join(dir, '.vibe', 'specs');
+  fs.mkdirSync(specsDir, { recursive: true });
+  const frontmatter = status ? `---\nstatus: ${status}\n---\n` : '';
+  fs.writeFileSync(path.join(specsDir, filename), frontmatter + (content || ''));
+}
+
+// ══════════════════════════════════════════════════
+// isScopeGuardEnabled — 기본 ON 동작
+// ══════════════════════════════════════════════════
+describe('isScopeGuardEnabled', () => {
+  let tmpDir;
+  beforeEach(() => { tmpDir = makeTempDir(); });
+  afterEach(() => { cleanDir(tmpDir); });
+
+  it('config 없음 → true (기본 ON)', () => {
+    expect(isScopeGuardEnabled(tmpDir)).toBe(true);
+  });
+
+  it('scopeGuard 키 없는 config → true', () => {
+    writeConfig(tmpDir, undefined);
+    expect(isScopeGuardEnabled(tmpDir)).toBe(true);
+  });
+
+  it('scopeGuard.enabled 없는 config → true', () => {
+    const vibeDir = path.join(tmpDir, '.vibe');
+    fs.mkdirSync(vibeDir, { recursive: true });
+    fs.writeFileSync(path.join(vibeDir, 'config.json'), JSON.stringify({ scopeGuard: {} }));
+    expect(isScopeGuardEnabled(tmpDir)).toBe(true);
+  });
+
+  it('scopeGuard.enabled=true → true', () => {
+    writeConfig(tmpDir, { enabled: true });
+    expect(isScopeGuardEnabled(tmpDir)).toBe(true);
+  });
+
+  it('scopeGuard.enabled=false → false (명시적 opt-out)', () => {
+    writeConfig(tmpDir, { enabled: false });
+    expect(isScopeGuardEnabled(tmpDir)).toBe(false);
+  });
+
+  it('legacy .claude/vibe/config.json에서도 enabled=false 인식', () => {
+    const legacyDir = path.join(tmpDir, '.claude', 'vibe');
+    fs.mkdirSync(legacyDir, { recursive: true });
+    fs.writeFileSync(path.join(legacyDir, 'config.json'), JSON.stringify({ scopeGuard: { enabled: false } }));
+    expect(isScopeGuardEnabled(tmpDir)).toBe(false);
+  });
+});
+
+// ══════════════════════════════════════════════════
+// syncScopeFile — 노이즈 가드: SPEC 없으면 생성 안 함
+// ══════════════════════════════════════════════════
+describe('syncScopeFile — no specs → no scope created', () => {
+  let tmpDir;
+  beforeEach(() => { tmpDir = makeTempDir(); });
+  afterEach(() => { cleanDir(tmpDir); });
+
+  it('SPEC 없음 → skipped-no-specs, scope.json 미생성', () => {
+    fs.mkdirSync(path.join(tmpDir, '.vibe'), { recursive: true });
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('skipped-no-specs');
+    expect(fs.existsSync(path.join(tmpDir, '.vibe', 'scope.json'))).toBe(false);
+  });
+
+  it('specs 디렉토리 없음 → skipped-no-specs', () => {
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('skipped-no-specs');
+  });
+});
+
+// ══════════════════════════════════════════════════
+// syncScopeFile — SPEC 있을 때 sync 실행
+// ══════════════════════════════════════════════════
+describe('syncScopeFile — spec exists → scope created', () => {
+  let tmpDir;
+  beforeEach(() => { tmpDir = makeTempDir(); });
+  afterEach(() => { cleanDir(tmpDir); });
+
+  // 파생 glob은 실존 디렉토리만 통과하므로, 참조 경로를 실제로 만들어 준다
+  function materialize(dir, relFile) {
+    const full = path.join(dir, relFile);
+    fs.mkdirSync(path.dirname(full), { recursive: true });
+    fs.writeFileSync(full, '');
+  }
+
+  it('활성 SPEC 있음 → scope.json 생성', () => {
+    writeSpec(tmpDir, 'feature.md', 'edit `src/cli/index.ts`');
+    materialize(tmpDir, 'src/cli/index.ts');
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('created');
+    const scopeJson = path.join(tmpDir, '.vibe', 'scope.json');
+    expect(fs.existsSync(scopeJson)).toBe(true);
+    const scope = JSON.parse(fs.readFileSync(scopeJson, 'utf-8'));
+    expect(scope.auto).toBe(true);
+    expect(Array.isArray(scope.allow)).toBe(true);
+  });
+
+  it('status 없는 최근 SPEC은 활성 간주 → scope.json 생성', () => {
+    writeSpec(tmpDir, 'no-status.md', 'modify `hooks/scripts/foo.js`', null);
+    materialize(tmpDir, 'hooks/scripts/foo.js');
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('created');
+  });
+
+  it('status 없는 오래된 SPEC(>14일)은 비활성 → skipped-no-specs', () => {
+    writeSpec(tmpDir, 'stale.md', 'modify `hooks/scripts/foo.js`', null);
+    materialize(tmpDir, 'hooks/scripts/foo.js');
+    const old = new Date(Date.now() - 15 * 24 * 60 * 60 * 1000);
+    fs.utimesSync(path.join(tmpDir, '.vibe', 'specs', 'stale.md'), old, old);
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('skipped-no-specs');
+  });
+
+  it('활성 SPEC에 산출 가능한 경로 없음 → skipped-no-paths, scope.json 미생성', () => {
+    writeSpec(tmpDir, 'no-paths.md', 'just prose, `nonexistent/dir/file` reference only');
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('skipped-no-paths');
+    expect(fs.existsSync(path.join(tmpDir, '.vibe', 'scope.json'))).toBe(false);
+  });
+
+  it('경로 산출 불가로 전환되면 기존 auto scope.json 제거', () => {
+    writeSpec(tmpDir, 'feature.md', 'edit `src/cli/index.ts`');
+    materialize(tmpDir, 'src/cli/index.ts');
+    syncScopeFile(tmpDir); // 생성
+    fs.rmSync(path.join(tmpDir, 'src'), { recursive: true, force: true });
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('removed');
+    expect(fs.existsSync(path.join(tmpDir, '.vibe', 'scope.json'))).toBe(false);
+  });
+
+  it('completed SPEC만 있을 때 → skipped-no-specs (비활성 SPEC은 제외)', () => {
+    writeSpec(tmpDir, 'done.md', 'edit `src/foo.ts`', 'completed');
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('skipped-no-specs');
+  });
+
+  it('수동 관리 scope.json(auto:false) → 건드리지 않음', () => {
+    writeSpec(tmpDir, 'feature.md', 'edit `src/bar.ts`');
+    const scopeDir = path.join(tmpDir, '.vibe');
+    fs.mkdirSync(scopeDir, { recursive: true });
+    const manual = { auto: false, mode: 'block', allow: ['src/**'], deny: [] };
+    fs.writeFileSync(path.join(scopeDir, 'scope.json'), JSON.stringify(manual));
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('skipped-manual');
+    const existing = JSON.parse(fs.readFileSync(path.join(scopeDir, 'scope.json'), 'utf-8'));
+    expect(existing.mode).toBe('block'); // 원본 유지
+  });
+
+  it('활성 SPEC 제거 후 재호출 → auto scope.json 삭제', () => {
+    writeSpec(tmpDir, 'feature.md', 'edit `src/cli/index.ts`');
+    materialize(tmpDir, 'src/cli/index.ts');
+    syncScopeFile(tmpDir); // 생성
+    // specs 디렉토리 비우기
+    fs.rmSync(path.join(tmpDir, '.vibe', 'specs'), { recursive: true, force: true });
+    const result = syncScopeFile(tmpDir);
+    expect(result.action).toBe('removed');
+    expect(fs.existsSync(path.join(tmpDir, '.vibe', 'scope.json'))).toBe(false);
+  });
+});
+
+// ══════════════════════════════════════════════════
+// findActiveSpecs — legacy .claude/vibe/specs 폴백
+// ══════════════════════════════════════════════════
+describe('findActiveSpecs — resolution order', () => {
+  let tmpDir;
+  beforeEach(() => { tmpDir = makeTempDir(); });
+  afterEach(() => { cleanDir(tmpDir); });
+
+  it('.vibe/specs 우선', () => {
+    writeSpec(tmpDir, 'main.md', 'content');
+    const specs = findActiveSpecs(tmpDir);
+    expect(specs.length).toBe(1);
+    expect(specs[0]).toContain('.vibe');
+  });
+
+  it('.vibe 없고 .claude/vibe/specs 있으면 legacy 사용', () => {
+    const legacySpecsDir = path.join(tmpDir, '.claude', 'vibe', 'specs');
+    fs.mkdirSync(legacySpecsDir, { recursive: true });
+    fs.writeFileSync(path.join(legacySpecsDir, 'old.md'), '---\nstatus: in-progress\n---\ncontent');
+    const specs = findActiveSpecs(tmpDir);
+    expect(specs.length).toBe(1);
+    expect(specs[0]).toContain('.claude');
+  });
+});