@su-record/vibe 3.2.64 → 4.0.1

package/dist/cli/setup/ProjectSetup.js

@@ -1,694 +0,0 @@
-/**
- * ProjectSetup - 프로젝트 레벨 설정
- */
-import path from 'path';
-import fs from 'fs';
-import os from 'os';
-import { fileURLToPath } from 'url';
-import { ensureDir, removeDirRecursive, log } from '../utils.js';
-import { STACK_NAMES } from '../detect.js';
-import { detectOsLanguage } from './LanguageDetector.js';
-import { getCoreConfigDir } from './GlobalInstaller.js';
-import { handleCaughtError } from '../../infra/lib/utils.js';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-// VIBE 섹션 감싸는 마커 — CLAUDE.md/AGENTS.md 둘 다 이 마커 사이를 재생성.
-const VIBE_START = '<!-- VIBE:START -->';
-const VIBE_END_TAG = '<!-- VIBE:END -->';
-/**
- * constitution.md 생성 또는 업데이트
- */
-export function updateConstitution(coreDir, detectedStacks, stackDetails) {
-    const templatePath = path.join(__dirname, '../../../vibe/templates/constitution-template.md');
-    const constitutionPath = path.join(coreDir, 'constitution.md');
-    if (!fs.existsSync(templatePath))
-        return;
-    let constitution = fs.readFileSync(templatePath, 'utf-8');
-    const backendStack = detectedStacks.find(s => s.type.includes('python') || s.type.includes('node') ||
-        s.type.includes('go') || s.type.includes('java') || s.type.includes('rust'));
-    const frontendStack = detectedStacks.find(s => s.type.includes('react') || s.type.includes('vue') ||
-        s.type.includes('flutter') || s.type.includes('swift') || s.type.includes('android'));
-    if (backendStack && STACK_NAMES[backendStack.type]) {
-        const info = STACK_NAMES[backendStack.type];
-        constitution = constitution.replace('- Language: {Python 3.11+ / Node.js / etc.}', `- Language: ${info.lang}`);
-        constitution = constitution.replace('- Framework: {FastAPI / Express / etc.}', `- Framework: ${info.framework}`);
-    }
-    if (frontendStack && STACK_NAMES[frontendStack.type]) {
-        const info = STACK_NAMES[frontendStack.type];
-        constitution = constitution.replace('- Framework: {Flutter / React / etc.}', `- Framework: ${info.framework}`);
-    }
-    constitution = constitution.replace('- Database: {PostgreSQL / MongoDB / etc.}', stackDetails.databases.length > 0 ? `- Database: ${stackDetails.databases.join(', ')}` : '- Database: (configure for your project)');
-    constitution = constitution.replace('- State Management: {Provider / Redux / etc.}', stackDetails.stateManagement.length > 0 ? `- State Management: ${stackDetails.stateManagement.join(', ')}` : '- State Management: (configure for your project)');
-    constitution = constitution.replace('- Hosting: {Cloud Run / Vercel / etc.}', stackDetails.hosting.length > 0 ? `- Hosting: ${stackDetails.hosting.join(', ')}` : '- Hosting: (configure for your project)');
-    constitution = constitution.replace('- CI/CD: {GitHub Actions / etc.}', stackDetails.cicd.length > 0 ? `- CI/CD: ${stackDetails.cicd.join(', ')}` : '- CI/CD: (configure for your project)');
-    fs.writeFileSync(constitutionPath, constitution);
-}
-/**
- * CLAUDE.md 업데이트 (core 섹션 추가/교체)
- */
-/**
- * VIBE 섹션을 파일에 쓰기 — START/END 마커 기반 idempotent 갱신
- */
-function writeVibeMarkedFile(filePath, section, createIfMissing = true) {
-    const wrapped = `${VIBE_START}\n${section}\n${VIBE_END_TAG}`;
-    if (fs.existsSync(filePath)) {
-        const existing = fs.readFileSync(filePath, 'utf-8');
-        const startIdx = existing.indexOf(VIBE_START);
-        const legacyStartIdx = existing.indexOf('# VIBE');
-        const endIdx = existing.indexOf(VIBE_END_TAG);
-        if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
-            const before = existing.substring(0, startIdx).trimEnd();
-            const after = existing.substring(endIdx + VIBE_END_TAG.length).trimStart();
-            fs.writeFileSync(filePath, (before ? before + '\n\n' : '') + wrapped + (after ? '\n\n' + after : ''));
-        }
-        else if (legacyStartIdx !== -1 && endIdx !== -1) {
-            const before = existing.substring(0, legacyStartIdx).trimEnd();
-            const after = existing.substring(endIdx + VIBE_END_TAG.length).trimStart();
-            fs.writeFileSync(filePath, (before ? before + '\n\n' : '') + wrapped + (after ? '\n\n' + after : ''));
-        }
-        else if (legacyStartIdx !== -1) {
-            const before = existing.substring(0, legacyStartIdx).trimEnd();
-            fs.writeFileSync(filePath, (before ? before + '\n\n' : '') + wrapped);
-        }
-        else {
-            fs.writeFileSync(filePath, existing.trimEnd() + '\n\n' + wrapped + '\n');
-        }
-    }
-    else if (createIfMissing) {
-        ensureDir(path.dirname(filePath));
-        fs.writeFileSync(filePath, wrapped + '\n');
-    }
-}
-/** CLI 변환 공용 헬퍼 (Claude Code → {label}, .claude/ → {dirName}/, CLAUDE.md → {targetFile}) */
-function adaptSection(section, label, dirName, targetFile) {
-    return section
-        .replace(/Claude Code/g, label)
-        .replace(/~\/\.claude\//g, `~/${dirName}/`)
-        .replace(/\.claude\//g, `${dirName}/`)
-        .replace(/`CLAUDE\.md`/g, `\`${targetFile}\``)
-        .replace(new RegExp(`${dirName.replace('.', '\\.')}\\/CLAUDE\\.md`, 'g'), `${dirName}/${targetFile}`);
-}
-/**
- * Codex 는 top-level `/vibe.*` 슬래시 커맨드가 없다 — 진입점은 skill 이다.
- *
- * 행마다 정확 문자열로 치환하면 buildGlobalSection 문구가 바뀔 때 조용히 어긋난다
- * (감사 2026-07-27: `| 3+ files |` 행과 `Exclude:` 행이 실제로 그렇게 깨져 있었다).
- * 변환은 규칙 하나로 하고, Codex 전용 안내만 따로 덧붙인다.
- */
-function adaptCodexInvocation(section) {
-    return section
-        .replace(/\/vibe(\.[a-z-]+)?\b/g, (_match, sub) => `$vibe${sub ?? ''}`)
-        .replace('## Workflow\n\n| Task | Command |', '## Workflow\n\nCodex exposes Vibe as skills, not top-level `/vibe.*` slash commands. Invoke with `$vibe`, `$vibe.spec`, or `/skills`.\n\n| Task | Codex invocation |')
-        // 접두만 매칭 — 뒤쪽 항목이 늘어도 깨지지 않는다 (Codex 는 commands/ 를 쓰지 않는다)
-        .replace('Exclude: `~/.codex/{rules,commands,agents,skills}/`', 'Exclude: `~/.codex/{rules,agents,skills}/`');
-}
-export function adaptToCodex(section) {
-    return adaptCodexInvocation(adaptSection(section, 'Codex', '.codex', 'AGENTS.md'));
-}
-const adaptToAntigravity = (section) => adaptSection(section, 'Antigravity', '.gemini', 'GEMINI.md');
-/**
- * 전역 ~/.claude/CLAUDE.md 생성/갱신 — vibe 규약(룰·키워드·워크플로) 전역 주입
- */
-export function generateGlobalClaudeMd() {
-    const globalPath = path.join(os.homedir(), '.claude', 'CLAUDE.md');
-    const section = buildGlobalSection(detectOsLanguage());
-    writeVibeMarkedFile(globalPath, section);
-}
-function getCodexConfigDir() {
-    return process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
-}
-/**
- * Codex 운영 규칙 — native hook이 설치되지 않았거나 trust가 꺼진 세션에서도
- * AGENTS.md 규칙을 하네스 백업 가드로 유지한다.
- */
-const CODEX_SOFT_HOOK_RULES = `## Operating Rules (vibe hooks)
-
-> vibe는 Codex native hooks와 notify lifecycle을 설치한다. hook이 실행되지 않는 환경에서는 아래 규칙을 직접 지킨다.
-
-- **Scope guard**: 변경하는 모든 라인은 사용자의 요청으로 추적 가능해야 한다. 요청 범위 밖 파일은 수정하지 않는다.
-- **Forbidden patterns**: 커밋 전 \`console.log\`, \`any\`/\`as any\`/\`@ts-ignore\`, 주석 처리된 코드, 하드코딩된 문자열/숫자를 남기지 않는다.
-- **Read before edit**: 수정 대상 파일은 부분 grep 이 아니라 전체를 읽은 뒤 수정한다.
-- **Loop contract**: \`$vibe\` 는 SPEC 승인 1회 후 게이트 통과까지 루프가 기본이다 (\`vibe/rules/loop-contract.md\`). \`ralph\`/\`verify\` 는 기본 동작의 deprecated 별칭, \`quick\` → \`--max-iter 1\`, \`ultrawork\` → \`automationLevel: autonomous\` + 병렬.
-- **Smallest unit**: 가장 작은 검증 단위로 구현 → 검증 → 다음. 여러 단위를 묶어 빅뱅으로 만들지 않는다.
-- **Turn 완료 후처리**(auto-commit·devlog)는 \`~/.codex/config.toml\` 의 \`notify\` 가 수행한다.`;
-/**
- * 전역 ~/.codex/AGENTS.md 생성/갱신 (Codex CLI 감지 시에만 호출)
- */
-export function generateGlobalCodexAgentsMd() {
-    const globalPath = path.join(getCodexConfigDir(), 'AGENTS.md');
-    const section = adaptToCodex(buildGlobalSection(detectOsLanguage())) + '\n\n' + CODEX_SOFT_HOOK_RULES;
-    writeVibeMarkedFile(globalPath, section);
-}
-/**
- * 전역 ~/.gemini/GEMINI.md 생성/갱신 (Antigravity CLI context file)
- */
-export function generateGlobalAntigravityMd() {
-    const globalPath = path.join(os.homedir(), '.gemini', 'GEMINI.md');
-    const section = adaptToAntigravity(buildGlobalSection(detectOsLanguage()));
-    writeVibeMarkedFile(globalPath, section);
-}
-/**
- * 프로젝트 분석 → CLAUDE.md 생성/갱신 (프로젝트별 섹션만)
- * 전역 규약은 `~/.claude/CLAUDE.md`에서 별도 관리.
- */
-export function generateProjectClaudeMd(projectRoot, detectedStacks, stackDetails, createIfMissing = true) {
-    const claudeMdPath = path.join(projectRoot, 'CLAUDE.md');
-    if (!createIfMissing && !fs.existsSync(claudeMdPath))
-        return;
-    const dirs = analyzeProjectStructure(projectRoot);
-    const stackNames = detectedStacks.map(s => STACK_NAMES[s.type]?.name || s.type);
-    const section = buildProjectSection(dirs, stackNames, stackDetails);
-    writeVibeMarkedFile(claudeMdPath, section, createIfMissing);
-}
-/**
- * 프로젝트 분석 → AGENTS.md 생성/갱신 (Codex 용, 프로젝트별 섹션만)
- * @param createIfMissing false 시 존재하는 파일만 갱신 (update --dynamic 용)
- */
-export function generateProjectAgentsMd(projectRoot, detectedStacks, stackDetails, createIfMissing = true) {
-    const agentsMdPath = path.join(projectRoot, 'AGENTS.md');
-    if (!createIfMissing && !fs.existsSync(agentsMdPath))
-        return;
-    const dirs = analyzeProjectStructure(projectRoot);
-    const stackNames = detectedStacks.map(s => STACK_NAMES[s.type]?.name || s.type);
-    const section = adaptToCodex(buildProjectSection(dirs, stackNames, stackDetails));
-    if (!fs.existsSync(agentsMdPath)) {
-        writeVibeMarkedFile(agentsMdPath, section);
-        return;
-    }
-    const existing = fs.readFileSync(agentsMdPath, 'utf-8');
-    const hasMarker = existing.includes(VIBE_START) || existing.includes('# VIBE');
-    if (hasMarker || !existing.includes('/vibe.spec')) {
-        writeVibeMarkedFile(agentsMdPath, section);
-    }
-}
-/**
- * 프로젝트 분석 → GEMINI.md 생성/갱신 (Antigravity context file)
- * @param createIfMissing false 시 존재하는 파일만 갱신
- */
-export function generateProjectAntigravityMd(projectRoot, detectedStacks, stackDetails, createIfMissing = true) {
-    const antigravityMdPath = path.join(projectRoot, 'GEMINI.md');
-    if (!createIfMissing && !fs.existsSync(antigravityMdPath))
-        return;
-    const dirs = analyzeProjectStructure(projectRoot);
-    const stackNames = detectedStacks.map(s => STACK_NAMES[s.type]?.name || s.type);
-    const section = adaptToAntigravity(buildProjectSection(dirs, stackNames, stackDetails));
-    writeVibeMarkedFile(antigravityMdPath, section, createIfMissing);
-}
-function analyzeProjectStructure(projectRoot) {
-    const topLevel = fs.readdirSync(projectRoot)
-        .filter(f => !f.startsWith('.') || f === '.dev' || f === '.vibe' || f === '.claude' || f === '.codex')
-        .filter(f => {
-        try {
-            return fs.statSync(path.join(projectRoot, f)).isDirectory();
-        }
-        catch {
-            return false;
-        }
-    });
-    const srcDir = path.join(projectRoot, 'src');
-    const libDir = path.join(projectRoot, 'lib');
-    const appDir = path.join(projectRoot, 'app');
-    const mainSrc = fs.existsSync(srcDir) ? srcDir : fs.existsSync(libDir) ? libDir : fs.existsSync(appDir) ? appDir : null;
-    let srcChildren = [];
-    if (mainSrc) {
-        srcChildren = fs.readdirSync(mainSrc)
-            .filter(f => {
-            try {
-                return fs.statSync(path.join(mainSrc, f)).isDirectory();
-            }
-            catch {
-                return false;
-            }
-        })
-            .slice(0, 15);
-    }
-    // 빌드/테스트 커맨드 감지
-    let buildCommand = '';
-    let testCommand = '';
-    let packageManager = 'npm';
-    const pkgPath = path.join(projectRoot, 'package.json');
-    const pyprojectPath = path.join(projectRoot, 'pyproject.toml');
-    if (fs.existsSync(pkgPath)) {
-        try {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-            buildCommand = pkg.scripts?.build ? `${packageManager} run build` : '';
-            testCommand = pkg.scripts?.test ? `${packageManager} test` : '';
-            if (fs.existsSync(path.join(projectRoot, 'pnpm-lock.yaml')))
-                packageManager = 'pnpm';
-            else if (fs.existsSync(path.join(projectRoot, 'yarn.lock')))
-                packageManager = 'yarn';
-            else if (fs.existsSync(path.join(projectRoot, 'bun.lockb')))
-                packageManager = 'bun';
-        }
-        catch { /* ignore */ }
-    }
-    else if (fs.existsSync(pyprojectPath)) {
-        buildCommand = 'python -m build';
-        testCommand = 'pytest';
-        packageManager = 'pip';
-    }
-    return {
-        hasSrc: mainSrc !== null,
-        hasDocs: fs.existsSync(path.join(projectRoot, 'docs')),
-        hasDev: fs.existsSync(path.join(projectRoot, '.dev')),
-        hasTests: fs.existsSync(path.join(projectRoot, 'tests')) || fs.existsSync(path.join(projectRoot, '__tests__')),
-        hasOut: fs.existsSync(path.join(projectRoot, 'dist')) || fs.existsSync(path.join(projectRoot, 'out')) || fs.existsSync(path.join(projectRoot, 'build')),
-        topLevel,
-        srcChildren,
-        buildCommand,
-        testCommand,
-        packageManager,
-    };
-}
-/**
- * 전역 VIBE 규약 섹션 (프로젝트 독립) — ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md
- * export 이유: 하네스별 변환 결과를 테스트가 직접 검증한다 (instruction-drift.test.ts).
- *
- * **여기 적는 것의 기준**: 이 섹션은 사용자의 모든 프로젝트에서 매 요청에 실린다.
- * 살짝 틀린 한 줄은 한 번의 나쁜 응답이 아니라 몇 달치 세금이 된다. 그래서
- * 남기는 줄은 둘 중 하나여야 한다 — (a) 모델이 코드에서 관측할 수 없는 vibe 고유
- * 메커니즘(훅이 무엇을 잡는지, 진입점이 무엇인지, 루프가 언제 끝나는지), 또는
- * (b) 실측된 실패 모드. 일반적인 코딩 조언은 적지 않는다: 모델이 이미 아는 것을
- * 다시 적으면 토큰만 쓰고 판단을 좁힌다.
- *
- * 실제로 지운 것 (2026-08): Rob Pike 최적화 5계명, 디버깅 5계명, 복잡도 수치.
- * 앞의 둘은 순수 일반론이었고, 복잡도 수치는 `references.rules[]` 가 이미 들고
- * 있어서 필요할 때 읽으면 되는 것을 상시 로드하고 있었다.
- */
-export function buildGlobalSection(language) {
-    const lines = [];
-    lines.push('# VIBE');
-    lines.push('');
-    lines.push('> Global vibe conventions — shared across all projects using Claude Code.');
-    lines.push('> Project-specific stack/structure lives in each project\'s `CLAUDE.md`.');
-    lines.push('');
-    if (language === 'ko') {
-        lines.push('**IMPORTANT: Always respond in Korean (한국어) unless the user explicitly requests otherwise.**');
-        lines.push('');
-    }
-    lines.push('## Constraints');
-    lines.push('');
-    lines.push('- Modify only requested scope — every changed line traces to the request');
-    lines.push('- Write code that reads like the surrounding code: match its naming, comment density, and idiom');
-    lines.push('- Prefer editing existing files; create new ones when the task asks for a feature, module, or scaffold');
-    lines.push('');
-    lines.push('### What the gate checks (mechanism, not style advice)');
-    lines.push('');
-    lines.push('- PostToolUse flags `any` / `as any` / `@ts-ignore` and `console.log` — fix at the root, don\'t suppress');
-    lines.push('- Stop warns when a run started but verify never passed');
-    lines.push('- Structure standards live in `.vibe/config.json` → `references.rules[]`, not here');
-    lines.push('');
-    lines.push('## Workflow');
-    lines.push('');
-    lines.push('| Task | Command |');
-    lines.push('|------|---------|');
-    lines.push('| 1-2 files | Plan Mode |');
-    lines.push('| 3+ files | `/vibe` (or `/vibe.spec` to start at the SPEC phase) |');
-    lines.push('| Analyze | `/vibe.analyze` (code, docs, web, Figma) |');
-    lines.push('| Harness check | `/vibe.harness` |');
-    lines.push('| Project structure | `/vibe.scaffold` |');
-    lines.push('');
-    lines.push('**Hard trigger (mandatory, not advisory)**: if the request creates or modifies 3+ files, ' +
-        'or asks for a new feature or scaffold, run `/vibe` FIRST — before any direct implementation. ' +
-        'The file-count condition alone decides; do not skip because the task looks simple.');
-    lines.push('');
-    lines.push('## Loop Contract');
-    lines.push('');
-    lines.push('`/vibe` = SPEC approval once → loop until gates pass (deterministic JUDGE; stuck/max-iter guards). ' +
-        'Deprecated aliases: `ralph`/`verify`→default, `quick`→`--max-iter 1`, `ultrawork`→`automationLevel: autonomous`+parallel');
-    lines.push('');
-    lines.push('## Quality');
-    lines.push('');
-    lines.push('Convergence: loop until P1=0. Changed files only.');
-    lines.push('At 85%+ context: save_memory → /new → /vibe.continue (raised from 70% — /new discards KV prefix cache; compact less often to preserve cache reuse)');
-    lines.push('');
-    lines.push('## Git');
-    lines.push('');
-    lines.push('Include: `.vibe/{plans,specs,features,todos,research,regressions,contracts,recipes,anti-patterns,loops,config.json,constitution.md}`, `CLAUDE.md`');
-    lines.push('Exclude: `~/.claude/{rules,commands,agents,skills}/`, `.claude/settings.local.json`, `.codex/hooks.json`, `.vibe/{memories,checkpoints,metrics}/`');
-    return lines.join('\n');
-}
-/** 프로젝트별 VIBE 섹션 (스택·구조·커맨드) — 프로젝트 루트 CLAUDE.md/AGENTS.md */
-function buildProjectSection(dirs, stackNames, stackDetails) {
-    const lines = [];
-    lines.push('# VIBE (project)');
-    lines.push('');
-    lines.push('> Global rules: `~/.claude/CLAUDE.md`. This file is project-specific only.');
-    lines.push('');
-    if (stackNames.length > 0) {
-        lines.push('## Tech Stack');
-        lines.push('');
-        lines.push(stackNames.join(', '));
-        if (stackDetails.databases.length > 0) {
-            lines.push(`DB: ${stackDetails.databases.join(', ')}`);
-        }
-        if (stackDetails.stateManagement.length > 0) {
-            lines.push(`State: ${stackDetails.stateManagement.join(', ')}`);
-        }
-        lines.push('');
-    }
-    lines.push('## Project Structure');
-    lines.push('');
-    const structureRows = [];
-    for (const dir of dirs.topLevel) {
-        switch (dir) {
-            case 'src':
-            case 'lib':
-            case 'app':
-                structureRows.push(`| \`${dir}/\` | Business logic |`);
-                break;
-            case 'docs':
-                structureRows.push('| `docs/` | Human-maintained business docs — **read before work** |');
-                break;
-            case '.dev':
-                structureRows.push('| `.dev/` | AI work logs, learnings, scratch |');
-                break;
-            case '.vibe':
-                structureRows.push('| `.vibe/` | Vibe SSOT (specs, plans, memories) — Claude/Codex 공용 |');
-                break;
-            case 'tests':
-            case '__tests__':
-            case 'test':
-                structureRows.push(`| \`${dir}/\` | Test infrastructure |`);
-                break;
-            case '.claude':
-                structureRows.push('| `.claude/` | Claude Code CLI 설정 |');
-                break;
-            case '.codex':
-                structureRows.push('| `.codex/` | Codex CLI 설정 |');
-                break;
-            case 'dist':
-            case 'out':
-            case 'build':
-                structureRows.push(`| \`${dir}/\` | Build output |`);
-                break;
-            default:
-                structureRows.push(`| \`${dir}/\` | |`);
-        }
-    }
-    if (structureRows.length > 0) {
-        lines.push('| Folder | Purpose |');
-        lines.push('|--------|---------|');
-        lines.push(...structureRows);
-        lines.push('');
-    }
-    if (dirs.srcChildren.length > 0) {
-        lines.push(`### Source layout: ${dirs.srcChildren.map(d => `${d}/`).join(', ')}`);
-        lines.push('');
-    }
-    if (dirs.buildCommand || dirs.testCommand) {
-        lines.push('## Commands');
-        lines.push('');
-        if (dirs.buildCommand)
-            lines.push(`- Build: \`${dirs.buildCommand}\``);
-        if (dirs.testCommand)
-            lines.push(`- Test: \`${dirs.testCommand}\``);
-        lines.push('');
-    }
-    lines.push('## References');
-    lines.push('');
-    lines.push('- Rules: `.vibe/config.json` → `references.rules[]`');
-    lines.push('- Languages: `~/.claude/vibe/languages/` (global)');
-    lines.push('- Constitution: `.vibe/constitution.md`');
-    if (dirs.hasDocs)
-        lines.push('- Business docs: `docs/`');
-    return lines.join('\n');
-}
-/**
- * 프로젝트 core 폴더 설정
- */
-export function updateRules(coreDir, detectedStacks, isUpdate = false) {
-    // 레거시 폴더 정리 (이전 버전에서 복사된 것들)
-    const legacyFolders = ['rules', 'languages', 'templates'];
-    legacyFolders.forEach(folder => {
-        const legacyPath = path.join(coreDir, folder);
-        if (fs.existsSync(legacyPath)) {
-            removeDirRecursive(legacyPath);
-        }
-    });
-    // specs, features 폴더 확인/생성
-    ['specs', 'features'].forEach(dir => {
-        ensureDir(path.join(coreDir, dir));
-    });
-}
-/**
- * 프로젝트 레벨 훅 설치 (.claude/settings.local.json)
- *
- * @param projectRoot 프로젝트 루트
- * @param harnessDir 하네스 디렉토리 이름 ('.claude', 기본값: '.claude')
- */
-/**
- * 설치된 프로젝트 훅이 패키지 템플릿과 어긋났는가.
- *
- * WHY: `repairProjectHooks` 가 **부재**만 봤다 — 훅 키가 있으면 무조건 최신으로
- * 취급했다. 그래서 훅 내용이 바뀌어도(예: PostToolUse matcher 에 `Agent` 추가)
- * 이미 설치한 사용자에게는 **영영 도달하지 않는다**. 실측: v3.2.35 로 upgrade 한
- * 직후에도 `.claude/settings.local.json` 은 옛 matcher 를 그대로 갖고 있었다.
- *
- * 전역 자산은 `staleGlobalAssets` 로 같은 문제를 이미 막았는데 프로젝트 훅에는
- * 그 장치가 없었다. 설치 자체가 idempotent 하므로(아래 installer 는 `hooks` 키만
- * 통째로 교체하고 나머지 설정은 보존한다) 어긋나면 그냥 다시 깔면 된다.
- */
-export function projectHooksStale(projectRoot, harnessDir = '.claude') {
-    const template = path.join(path.resolve(__dirname, '..', '..', '..'), 'hooks', 'hooks.json');
-    if (!fs.existsSync(template))
-        return false; // 템플릿이 없으면 판정하지 않는다
-    try {
-        const expected = JSON.parse(fs.readFileSync(template, 'utf-8')
-            .replace(/\{\{VIBE_PATH\}\}/g, getCoreConfigDir().replace(/\\/g, '/')));
-        const installed = JSON.parse(fs.readFileSync(path.join(projectRoot, harnessDir, 'settings.local.json'), 'utf-8'));
-        if (!installed.hooks)
-            return false; // 부재는 stale 이 아니라 미설치 — 호출부가 따로 본다
-        return JSON.stringify(installed.hooks) !== JSON.stringify(expected.hooks);
-    }
-    catch {
-        return false; // 판독 불가는 stale 로 보지 않는다 — 사용자 설정을 함부로 덮지 않는다
-    }
-}
-export function installProjectHooks(projectRoot, harnessDir = '.claude') {
-    const claudeDir = path.join(projectRoot, harnessDir);
-    const settingsLocalPath = path.join(claudeDir, 'settings.local.json');
-    const packageRoot = path.resolve(__dirname, '..', '..', '..');
-    const hooksTemplate = path.join(packageRoot, 'hooks', 'hooks.json');
-    if (!fs.existsSync(hooksTemplate))
-        return;
-    ensureDir(claudeDir);
-    // 템플릿 읽고 플레이스홀더 치환
-    let hooksContent = fs.readFileSync(hooksTemplate, 'utf-8');
-    const coreConfigPath = getCoreConfigDir();
-    // Windows 경로는 슬래시 사용
-    const corePathForUrl = coreConfigPath.replace(/\\/g, '/');
-    hooksContent = hooksContent.replace(/\{\{VIBE_PATH\}\}/g, corePathForUrl);
-    const coreHooks = JSON.parse(hooksContent);
-    if (fs.existsSync(settingsLocalPath)) {
-        // 기존 settings.local.json에 hooks 병합
-        try {
-            const existingSettings = JSON.parse(fs.readFileSync(settingsLocalPath, 'utf-8'));
-            existingSettings.hooks = coreHooks.hooks;
-            fs.writeFileSync(settingsLocalPath, JSON.stringify(existingSettings, null, 2));
-        }
-        catch (e) {
-            handleCaughtError('recoverable', 'Parsing existing settings.local.json failed, recreating', e, log);
-            fs.writeFileSync(settingsLocalPath, JSON.stringify(coreHooks, null, 2));
-        }
-    }
-    else {
-        // 새로 생성
-        fs.writeFileSync(settingsLocalPath, JSON.stringify(coreHooks, null, 2));
-    }
-}
-// Codex config.toml 의 vibe 관리 블록 마커
-const CODEX_NOTIFY_START = '# >>> vibe notify (managed) — do not edit >>>';
-const CODEX_NOTIFY_END = '# <<< vibe notify (managed) <<<';
-function splitCodexNotifyBlock(existing) {
-    const startIdx = existing.indexOf(CODEX_NOTIFY_START);
-    const endIdx = existing.indexOf(CODEX_NOTIFY_END);
-    if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) {
-        return { found: false, before: '', after: '', rest: existing };
-    }
-    const before = existing.substring(0, startIdx).trimEnd();
-    const after = existing.substring(endIdx + CODEX_NOTIFY_END.length).trimStart();
-    const rest = [before, after].filter(Boolean).join('\n\n');
-    return { found: true, before, after, rest: rest ? rest + '\n' : '' };
-}
-/**
- * Codex notify 설치 — `~/.codex/config.toml` 에 `notify` 프로그램을 등록한다.
- *
- * Codex 는 Claude Code 의 settings.local.json hook 을 읽지 않는다. 대신 lifecycle
- * 이벤트를 `notify` 배열에 등록된 프로그램으로 발화하므로, 이를 vibe 의 codex-notify
- * 어댑터에 연결해 turn 완료 시 auto-commit/devlog 를 돌린다.
- *
- * - 관리 블록(마커)으로 idempotent 갱신
- * - 관리 블록 밖에 다른 `notify` 키가 있으면 덮어쓰지 않는다(경고). TOML 은 루트 키
- *   중복을 허용하지 않아, 둘을 함께 두면 codex 가 `duplicate key` 로 기동조차 못 한다.
- *   Codex computer-use 는 기존 notify 를 `--previous-notify` 로 체인해 자체 키를
- *   기록하므로, 이 경우 관리 블록을 제거하는 편이 vibe 어댑터도 함께 살린다.
- * - TOML 루트 키는 테이블 헤더 이전에 와야 하므로 관리 블록을 파일 최상단에 둔다
- *
- * @param configDir Codex 설정 디렉토리 (보통 `~/.codex`)
- */
-export function installCodexNotify(configDir) {
-    const configPath = path.join(configDir, 'config.toml');
-    const corePath = getCoreConfigDir().replace(/\\/g, '/');
-    const notifyScript = `${corePath}/hooks/scripts/codex-notify.js`;
-    const block = `${CODEX_NOTIFY_START}\nnotify = ["node", ${JSON.stringify(notifyScript)}]\n${CODEX_NOTIFY_END}`;
-    if (!fs.existsSync(configPath)) {
-        ensureDir(configDir);
-        fs.writeFileSync(configPath, block + '\n');
-        return;
-    }
-    const existing = fs.readFileSync(configPath, 'utf-8');
-    const { found, before, after, rest } = splitCodexNotifyBlock(existing);
-    // 관리 블록 밖에 다른 notify 키가 있는 경우 — 덮어쓰지 않는다
-    if (/^\s*notify\s*=/m.test(rest)) {
-        if (found) {
-            fs.writeFileSync(configPath, rest);
-            log(`⚠️  Codex config.toml defines its own 'notify'; removed the vibe managed block to avoid a duplicate key (${configPath})`);
-            return;
-        }
-        log(`⚠️  Codex config.toml already defines 'notify'; skipping vibe notify install (${configPath})`);
-        return;
-    }
-    if (found) {
-        // 기존 관리 블록 교체
-        fs.writeFileSync(configPath, (before ? before + '\n\n' : '') + block + (after ? '\n\n' + after : '') + '\n');
-        return;
-    }
-    // 루트 키는 테이블 헤더 이전이어야 하므로 최상단에 prepend
-    fs.writeFileSync(configPath, block + '\n\n' + existing.trimStart());
-}
-/**
- * .gitignore 업데이트
- *
- * @param harnessDir '.claude' | '.codex' (기본값: '.claude')
- *   하네스-특정 경로(settings.local.json, checkpoints/)는 해당 디렉토리에 쓰기 위해 사용.
- */
-export function updateGitignore(projectRoot, harnessDir = '.claude') {
-    const gitignorePath = path.join(projectRoot, '.gitignore');
-    if (!fs.existsSync(gitignorePath))
-        return;
-    let gitignore = fs.readFileSync(gitignorePath, 'utf-8');
-    let modified = false;
-    // settings.local.json 추가
-    const settingsPath = `${harnessDir}/settings.local.json`;
-    if (!gitignore.includes(settingsPath)) {
-        gitignore = gitignore.trimEnd() + `\n\n# core project hooks (personal)\n${settingsPath}\n`;
-        modified = true;
-    }
-    // .gemini/settings.json 추가 (Antigravity 개인 설정)
-    if (!gitignore.includes('.gemini/settings.json')) {
-        gitignore = gitignore.trimEnd() + '\n\n# Antigravity settings (personal)\n.gemini/settings.json\n';
-        modified = true;
-    }
-    // checkpoints 디렉토리 제외 (Phase Isolation Protocol 임시 파일) — .vibe/ SSOT
-    const checkpointsPath = `.vibe/checkpoints/`;
-    if (!gitignore.includes(checkpointsPath)) {
-        gitignore = gitignore.trimEnd() + `\n\n# Phase checkpoints (ephemeral)\n${checkpointsPath}\n`;
-        modified = true;
-    }
-    // 메모리 DB 제외 — 바이너리 SQLite 파일, 프로젝트마다 다름
-    if (!gitignore.includes('.vibe/memories/')) {
-        gitignore = gitignore.trimEnd() + '\n\n# Project memory DB (local)\n.vibe/memories/\n';
-        modified = true;
-    }
-    // 레거시 mcp 폴더 제외 제거
-    if (gitignore.includes('.claude/vibe/mcp/')) {
-        gitignore = gitignore.replace(/# core MCP\n\.claude\/vibe\/mcp\/\n?/g, '');
-        gitignore = gitignore.replace(/\.claude\/vibe\/mcp\/\n?/g, '');
-        modified = true;
-    }
-    // .dev/scratch/ (AI experiment files, not committed)
-    if (!gitignore.includes('.dev/scratch/')) {
-        gitignore = gitignore.trimEnd() + '\n\n# AI scratch files (ephemeral)\n.dev/scratch/\n';
-        modified = true;
-    }
-    // 레거시 node_modules 제외 제거
-    if (gitignore.includes('.claude/vibe/node_modules/')) {
-        gitignore = gitignore.replace(/# core local packages\n\.claude\/vibe\/node_modules\/\n?/g, '');
-        gitignore = gitignore.replace(/\.claude\/vibe\/node_modules\/\n?/g, '');
-        modified = true;
-    }
-    if (modified) {
-        fs.writeFileSync(gitignorePath, gitignore);
-    }
-}
-/**
- * harnessDir(.claude/.codex/.gemini) → 글로벌 vibe 에셋 경로 접두사
- */
-function resolveGlobalCoreDir(harnessDir) {
-    const name = harnessDir.startsWith('.') ? harnessDir : `.${harnessDir}`;
-    return `~/${name}/vibe`;
-}
-/**
- * 스택 기반 references 생성
- */
-function generateReferences(detectedStacks, harnessDir = '.claude') {
-    const globalCoreDir = resolveGlobalCoreDir(harnessDir);
-    const rules = [
-        `${globalCoreDir}/rules/principles/quick-start.md`,
-        `${globalCoreDir}/rules/principles/development-philosophy.md`,
-        `${globalCoreDir}/rules/principles/communication-guide.md`,
-        `${globalCoreDir}/rules/quality/checklist.md`,
-        `${globalCoreDir}/rules/quality/bdd-contract-testing.md`,
-        `${globalCoreDir}/rules/quality/testing-strategy.md`,
-        `${globalCoreDir}/rules/standards/anti-patterns.md`,
-        `${globalCoreDir}/rules/standards/code-structure.md`,
-        `${globalCoreDir}/rules/standards/complexity-metrics.md`,
-        `${globalCoreDir}/rules/standards/naming-conventions.md`
-    ];
-    const languages = detectedStacks.map(stack => `${globalCoreDir}/languages/${stack.type}.md`);
-    const templates = [
-        `${globalCoreDir}/templates/plan-template.md`,
-        `${globalCoreDir}/templates/spec-template.md`,
-        `${globalCoreDir}/templates/feature-template.md`,
-        `${globalCoreDir}/templates/constitution-template.md`,
-        `${globalCoreDir}/templates/contract-backend-template.md`,
-        `${globalCoreDir}/templates/contract-frontend-template.md`
-    ];
-    return { rules, languages, templates };
-}
-/**
- * config.json 생성/업데이트
- */
-export function updateConfig(coreDir, detectedStacks, stackDetails, isUpdate = false, harnessDir = '.claude') {
-    const configPath = path.join(coreDir, 'config.json');
-    const references = generateReferences(detectedStacks, harnessDir);
-    if (isUpdate && fs.existsSync(configPath)) {
-        try {
-            const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-            if (!config.language) {
-                config.language = detectOsLanguage();
-            }
-            if (!config.quality) {
-                config.quality = { strict: true, autoVerify: true };
-            }
-            config.stacks = detectedStacks;
-            config.details = stackDetails;
-            config.references = references;
-            fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-        }
-        catch (e) {
-            handleCaughtError('recoverable', 'Config update failed, using defaults', e, log);
-        }
-    }
-    else {
-        const config = {
-            language: detectOsLanguage(),
-            quality: { strict: true, autoVerify: true },
-            stacks: detectedStacks,
-            details: stackDetails,
-            references
-        };
-        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-    }
-}
-// VIBE에서 관리하는 언어 룰 파일 패턴 (항상 업데이트)
-const VIBE_MANAGED_LANGUAGE_RULES = [
-    'typescript-', 'python-', 'dart-', 'go.', 'rust.', 'kotlin-',
-    'java-', 'swift-', 'ruby-', 'csharp-', 'gdscript-'
-];
-// 레거시 파일명 (정리 대상)
-const LEGACY_RULE_FILES = [
-    'react-patterns.mdc', 'typescript-standards.mdc', 'python-standards.mdc'
-];
-//# sourceMappingURL=ProjectSetup.js.map