@su-record/vibe 3.2.18 → 3.2.20

package/skills/vibe/SKILL.md

@@ -103,12 +103,25 @@ user-invocable: true
 
 ### Phase 2: Smart Resume 감지
 
+**파일 존재 검사는 눈으로 하지 않는다 — 명령이 확정한다.** Phase 0 의 URL·첨부 분류와
+stakes 의 결정론 신호(config 유무·임시 디렉토리·git 여부)도 이 한 번의 호출로 함께 받는다:
+
+```bash
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { console.log(JSON.stringify(t.collectDispatchSignals(process.cwd(), {urls: [], attachments: [], feature: undefined}), null, 2)); })"
 ```
-.vibe/.last-feature 존재 → 직전 feature 이름 추출
-.vibe/specs/{feature}/ 또는 .vibe/specs/{feature}.md 존재 → spec 단계 완료
-.vibe/features/{feature}/ 또는 .vibe/features/{feature}.feature 존재 → feature 단계 완료
-.vibe/plans/{feature}.md · .vibe/interviews/{feature}.md 존재 → 레거시 아티팩트 (구버전) — spec 패스의 입력 컨텍스트로만 사용, 재생성 금지
-```
+
+반환값을 **사실로 받는다**:
+
+| 필드 | 의미 |
+|---|---|
+| `resume.resumeFrom` | `run`(SPEC 있음) / `none`(처음부터) |
+| `resume.specPath` · `featurePath` | 실제 경로 (분할 SPEC `_index.md` 포함) |
+| `resume.legacyArtifacts` | 구버전 plans/interviews — **입력 컨텍스트로만** 쓰고 재생성 금지 |
+| `stakes.hasVibeConfig` · `isTempDir` · `isGitRepo` | Phase 1-b 의 결정론 신호 (언어 신호는 모델 판단으로 남는다) |
+| `urls[].kind` | `figma` / `github` / `youtube` / `web` |
+| `attachments[].kind` · `exists` | `spec` / `feature` / `document` / `image` / `code` |
+
+> 의도 분류(Phase 1)는 그대로 모델이 한다 — 애매한 판단은 모델, 파일 존재·도메인·확장자는 코드다.
 
 감지된 진행 상태가 있으면 사용자에게 명시:
 

package/skills/vibe.image/SKILL.md

@@ -34,6 +34,14 @@ Generate images using the Antigravity image backend.
 **Step 0: Script path:**
 - `[LLM_SCRIPT]` = `{{VIBE_PATH}}/hooks/scripts/llm-orchestrate.js`
 
+**Step 0-b: 비용 게이트 (생성 전 의무)** — 이미지 생성은 되돌릴 수 없는 지출이다. SSOT: `vibe/rules/loop-contract.md` 비용 게이트 절.
+
+```bash
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const op={kind:'paid-generation',provider:'antigravity',label:'이미지 {N}장 생성'}; console.log(t.formatCostGate(op, t.evaluateCostGate(op))); })"
+```
+
+`ask` 면 생성 전에 무엇을 몇 장 만들지 제시하고 확인받는다. `autonomous` 면 묻지 않고 인박스에 기록한 뒤 진행한다. `.vibe/config.json` 의 `costGate.paidGenerationRequiresApproval: false` 로 끌 수 있다.
+
 **General image generation (Antigravity fast image):**
 ```bash
 node "[LLM_SCRIPT]" antigravity image "IMAGE_DESCRIPTION" --output "OUTPUT_PATH"

package/skills/vibe.review/SKILL.md

@@ -124,6 +124,14 @@ Detect project tech stack FIRST before launching reviewers.
 
 **Spawn one reviewer per focus, as concurrently as the harness allows** — a `code-reviewer` instance per focus plus `security-reviewer`, each scoped to the changed files.
 
+**스폰 직전 비용 게이트** (SSOT: `vibe/rules/loop-contract.md` 비용 게이트 절). 위 표대로 정한 리뷰어 수를 그대로 넣는다:
+
+```bash
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const op={kind:'agent-fanout',agentCount:{N},label:'리뷰어 {N}종 병렬'}; console.log(t.formatCostGate(op, t.evaluateCostGate(op))); })"
+```
+
+기본 임계값(12)에서 demo 2종·prototype 3종·production 8종은 전부 **통과**한다 — 평상시 규모는 멈추지 않는다. `ask` 가 나오면 스폰 전에 사용자에게 확인하고, `record` (autonomous) 면 묻지 않고 인박스에 남긴 뒤 진행한다.
+
 호출 계약(하네스 무관): "에이전트 `{agent}` 를 인자 `Review {FILES} — focus: {focus}` 로 실행한다"
 
 ```

package/skills/vibe.spec/SKILL.md

@@ -35,6 +35,8 @@ Input 분석 + Smart Resume
     ↓
 Execute the bundled implementation below — 단일 패스: 컨텍스트 수집 → (필요시) 인라인 질문 → SPEC + Feature 작성 → 셀프 리뷰 1회
     ↓
+SPEC Code Guard (아래) — P1 이 있으면 승인으로 가지 않고 SPEC 작성으로 되돌아간다
+    ↓
 SPEC 승인 (1회 — automationLevel: autonomous 면 생략)
     ↓
 /vibe.run "{feature-name}"
@@ -65,6 +67,25 @@ Legacy `.vibe/interviews/` or `.vibe/plans/` artifacts가 실제로 감지된
 - 개인 작업 포인터이므로 git 커밋 금지 (`.gitignore` 에 `.vibe/.last-feature`).
 - 워크플로 완주(verify 통과) 시 삭제.
 
+## SPEC Code Guard (승인 전 의무)
+
+SPEC 을 쓴 직후, **승인을 요청하기 전에** 실행한다. 셀프 리뷰가 아니라 코드 판정이다:
+
+```bash
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const fs=require('fs'); const p='.vibe/specs/{feature-name}.md'; const r=t.validateSpecDocument(fs.readFileSync(p,'utf-8'),{specPath:p}); console.log(t.formatSpecValidation(r)); process.exitCode = r.valid ? 0 : 1; })"
+```
+
+| 검사 | 심각도 | 왜 하류가 깨지는가 |
+|---|---|---|
+| REQ-* ID 부재 | P1 | RTM 이 `status:"empty"` — 커버리지 게이트가 판정불가가 된다 |
+| Stakes 부재/오값 | P1 | 디스패처가 파이프라인 깊이를 정할 입력이 없다 |
+| Done Criteria 부재/빈 섹션 | P1 | JUDGE 가 판정할 기준이 없다 |
+| 미치환 placeholder | P1 | 직역 하네스가 예시 텍스트를 실데이터로 넣는다 |
+| Scenarios 부재 | P2 | `vibe.run` 시나리오 루프의 분해 단위가 없다 |
+| REQ 슬러그 ≠ 파일명 | P2 | 게이트는 통과하나 ID 규약 이탈로 추적이 흐려진다 |
+
+**P1 이 하나라도 있으면 승인 요청으로 넘어가지 않는다** — SPEC 작성으로 되돌아가 고치고 다시 검사한다 (backward edge). 2회 연속 같은 findings 면 stuck 으로 처리한다 (SSOT: `vibe/rules/loop-contract.md`). P2 는 통과를 막지 않고 승인 메시지에 함께 표시한다.
+
 ## 승인과 루프
 
 SPEC 승인이 `vibe/rules/loop-contract.md` 가 정의하는 **유일한 의무적 사람 개입**이다. 승인 후에는 ANCHOR→ACT→JUDGE→RECORD 루프가 게이트 통과까지 자동 반복한다 (`/vibe.run` → `/vibe.verify`). 별도의 파이프라인 승인·단계별 stop gate 는 없다.

package/vibe/rules/loop-contract.md

@@ -62,6 +62,37 @@ node "$HOOKS_DIR/loop-ledger.js" anchor [feature]
 
 > `autonomous` 의 "계속" 은 **stuck 난 루프를 더 돌린다는 뜻이 아니다** — 2회 연속 동일 발견은 정의상 재시도가 무의미하다. 같은 목표를 붙잡지 않고 다음 단위로 넘어간다는 뜻이며, 미달은 TODO/인박스에 남는다. 미달 상태를 **완료로 기록하지 않는다.**
 
+### 비용 게이트 — 사람은 시작점에만 서지 않는다
+
+SPEC 승인은 **유일한 의무 게이트**로 남는다. 다만 승인 이후 max_iterations 까지 무인이라, 그 안의 되돌릴 수 없는 지출과 이상 규모 팬아웃을 아무도 보지 못했다. 비용 게이트는 그 둘만 잡는다 — 평상시 규모는 그대로 통과시킨다.
+
+```bash
+node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index.js').then(t => { const d=t.evaluateCostGate({kind:'agent-fanout',agentCount:N}); console.log(t.formatCostGate({kind:'agent-fanout',agentCount:N}, d)); })"
+```
+
+| 작업 | 기본 판정 | 근거 |
+|---|---|---|
+| `paid-generation` | **묻는다** | 되돌릴 수 없는 지출 |
+| `agent-fanout` > 12 | **묻는다** | 위임마다 컨텍스트 재주입 — 비용이 개수에 비례 |
+| `agent-fanout` ≤ 12 | 통과 | production 기본 리뷰어 셋(8종)+조건부는 평상시 규모다 |
+
+- 임계값을 기본 셋 아래로 두면 매 리뷰가 멈춘다 — **의례가 된 게이트는 무시당한다.** 조정은 `.vibe/config.json` 의 `costGate.{enabled, maxAgentsWithoutApproval, paidGenerationRequiresApproval}`.
+- `autonomous` 는 **묻지 않는다.** 대신 결정을 인박스에 기록한다 (`loop-ledger.js inbox`) — stuck 처리와 같은 원칙: 비대화형이라고 판정을 없애지 않고, 사람이 볼 자리로 옮긴다.
+
+### 노드 가드 — 게이트를 끝에만 두지 않는다
+
+결정론 게이트가 전부 JUDGE(파이프라인 끝)에만 있으면, 쓸 수 없는 산출물이 체인을 끝까지 타고 간 뒤에야 걸린다. 실패는 **만들어진 노드에서** 잡는 것이 싸다.
+
+- 산출물을 내는 노드는 그 산출물이 **하류가 요구하는 형태인지** 코드로 검사한다. 취향이 아니라 계약을 검사한다 — "이게 없으면 하류의 무엇이 깨지는가"로 항목을 정한다.
+- 실패하면 다음 노드로 가지 않고 **그 노드로 되돌아간다** (backward edge). 루프 전체를 재시작하지 않는다.
+- 되돌린 뒤에도 같은 findings 가 2회 연속이면 stuck 이다 (위 stuck 절).
+
+| 노드 | 가드 | 검사 근거 |
+|---|---|---|
+| `vibe.spec` | `validateSpecDocument` | RTM 이 게이트로 동작할 REQ-* / JUDGE 입력인 Done Criteria / 디스패처 입력인 Stakes / 직역 하네스가 실데이터로 넣는 placeholder |
+| `vibe.run` | 테스트 exit code · run-ledger | 기존 JUDGE |
+| `vibe.clone` · `vibe.figma` | pixelmatch diffRatio · computed CSS delta | 측정된 P1 (위 Judge 권한 경계 표) |
+
 ### 실행 실패 (error) — stuck 과 다른 종료 사유
 
 stuck 은 **같은 발견이 반복되는** 상태다. 스킬이 로드되지 않거나, 도구가 없거나, 파일이 없거나, 명령이 비정상 종료하는 것은 stuck 이 아니라 **실행 실패**이며 해시 비교로는 잡히지 않는다. 재시도 대상도 아니다 — 환경이 바뀌지 않는 한 결과가 같다.

package/dist/infra/lib/DeepInit.d.ts

@@ -1,60 +0,0 @@
-/**
- * DeepInit - Hierarchical AGENTS.md Generation
- * Creates AI-readable documentation hierarchy with parent references
- */
-export interface DirectoryInfo {
-    path: string;
-    name: string;
-    depth: number;
-    parent?: string;
-    children: string[];
-    files: FileInfo[];
-    purpose?: string;
-}
-export interface FileInfo {
-    name: string;
-    path: string;
-    extension: string;
-    size?: number;
-    isEntry?: boolean;
-    description?: string;
-}
-export interface AgentsMdContent {
-    header: string;
-    parentRef?: string;
-    purpose: string;
-    structure: string;
-    keyFiles: string;
-    conventions: string;
-    dependencies: string;
-    notes: string;
-}
-/**
- * Detect directory purpose from name
- */
-export declare function detectDirectoryPurpose(dirName: string): string;
-/**
- * Check if file is an entry point
- */
-export declare function isEntryPoint(fileName: string): boolean;
-/**
- * Generate AGENTS.md content for a directory
- */
-export declare function generateAgentsMd(dir: DirectoryInfo): AgentsMdContent;
-/**
- * Format full AGENTS.md content
- */
-export declare function formatAgentsMd(content: AgentsMdContent): string;
-/**
- * Preserve manual notes from existing AGENTS.md
- */
-export declare function preserveManualNotes(existing: string, newContent: string): string;
-/**
- * Generate navigation header
- */
-export declare function generateNavigationHeader(dir: DirectoryInfo, rootPath: string): string;
-/**
- * Describe DeepInit workflow
- */
-export declare function describeDeepInitWorkflow(): string;
-//# sourceMappingURL=DeepInit.d.ts.map

package/dist/infra/lib/DeepInit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DeepInit.d.ts","sourceRoot":"","sources":["../../../src/infra/lib/DeepInit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AA6CD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CAoFpE;AAsCD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAe/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAahF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAarF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA0BjD"}

package/dist/infra/lib/DeepInit.js

@@ -1,245 +0,0 @@
-/**
- * DeepInit - Hierarchical AGENTS.md Generation
- * Creates AI-readable documentation hierarchy with parent references
- */
-import path from 'path';
-// Common directory purposes
-const DIRECTORY_PURPOSES = {
-    src: 'Source code directory',
-    lib: 'Library/utility code',
-    utils: 'Utility functions',
-    helpers: 'Helper functions',
-    components: 'UI components',
-    pages: 'Page components/routes',
-    hooks: 'React/custom hooks',
-    services: 'Business logic services',
-    api: 'API endpoints/clients',
-    models: 'Data models/schemas',
-    types: 'TypeScript type definitions',
-    interfaces: 'Interface definitions',
-    controllers: 'Request controllers',
-    routes: 'Route definitions',
-    middleware: 'Middleware functions',
-    config: 'Configuration files',
-    constants: 'Constant values',
-    assets: 'Static assets',
-    styles: 'CSS/styling files',
-    tests: 'Test files',
-    __tests__: 'Jest test directory',
-    spec: 'Test specifications',
-    fixtures: 'Test fixtures/data',
-    mocks: 'Mock implementations',
-    scripts: 'Build/utility scripts',
-    tools: 'Development tools',
-    docs: 'Documentation',
-    dist: 'Build output',
-    build: 'Build output',
-    node_modules: 'Dependencies (skip)',
-    '.git': 'Git directory (skip)',
-};
-// File patterns to identify entry points
-const ENTRY_PATTERNS = [
-    /^index\.(ts|js|tsx|jsx)$/,
-    /^main\.(ts|js|tsx|jsx)$/,
-    /^app\.(ts|js|tsx|jsx)$/,
-    /^server\.(ts|js|tsx|jsx)$/,
-];
-/**
- * Detect directory purpose from name
- */
-export function detectDirectoryPurpose(dirName) {
-    const lower = dirName.toLowerCase();
-    return DIRECTORY_PURPOSES[lower] || DIRECTORY_PURPOSES[dirName] || 'Project directory';
-}
-/**
- * Check if file is an entry point
- */
-export function isEntryPoint(fileName) {
-    return ENTRY_PATTERNS.some(pattern => pattern.test(fileName));
-}
-/**
- * Generate AGENTS.md content for a directory
- */
-export function generateAgentsMd(dir) {
-    const header = `# AGENTS.md - ${dir.name}`;
-    // Parent reference
-    const parentRef = dir.parent
-        ? `<!-- Parent: ${path.relative(dir.path, dir.parent)}/AGENTS.md -->`
-        : undefined;
-    // Purpose
-    const purpose = `## Purpose\n\n${dir.purpose || detectDirectoryPurpose(dir.name)}`;
-    // Structure
-    const structureLines = ['## Structure\n', '```'];
-    structureLines.push(`${dir.name}/`);
-    for (const child of dir.children) {
-        structureLines.push(`├── ${child}/`);
-    }
-    for (const file of dir.files) {
-        const marker = isEntryPoint(file.name) ? ' ← entry' : '';
-        structureLines.push(`├── ${file.name}${marker}`);
-    }
-    structureLines.push('```');
-    const structure = structureLines.join('\n');
-    // Key files
-    const keyFilesLines = ['## Key Files\n'];
-    const entryFiles = dir.files.filter(f => isEntryPoint(f.name));
-    if (entryFiles.length > 0) {
-        keyFilesLines.push('### Entry Points');
-        for (const file of entryFiles) {
-            keyFilesLines.push(`- \`${file.name}\`: ${file.description || 'Main entry point'}`);
-        }
-        keyFilesLines.push('');
-    }
-    // Group by extension
-    const byExtension = new Map();
-    for (const file of dir.files) {
-        const ext = file.extension || 'other';
-        if (!byExtension.has(ext))
-            byExtension.set(ext, []);
-        byExtension.get(ext).push(file);
-    }
-    for (const [ext, files] of byExtension) {
-        if (files.length > 5) {
-            keyFilesLines.push(`- \`*.${ext}\`: ${files.length} files`);
-        }
-        else {
-            for (const file of files) {
-                if (!isEntryPoint(file.name)) {
-                    keyFilesLines.push(`- \`${file.name}\``);
-                }
-            }
-        }
-    }
-    const keyFiles = keyFilesLines.join('\n');
-    // Conventions (auto-detected)
-    const conventions = generateConventions(dir);
-    // Dependencies (child directories)
-    const dependenciesLines = ['## Dependencies\n'];
-    if (dir.children.length > 0) {
-        dependenciesLines.push('### Child Modules');
-        for (const child of dir.children) {
-            dependenciesLines.push(`- [\`${child}/\`](./${child}/AGENTS.md)`);
-        }
-    }
-    else {
-        dependenciesLines.push('No child modules.');
-    }
-    const dependencies = dependenciesLines.join('\n');
-    // Notes placeholder
-    const notes = '## Notes\n\n<!-- Add manual notes here. They will be preserved on regeneration. -->';
-    return {
-        header,
-        parentRef,
-        purpose,
-        structure,
-        keyFiles,
-        conventions,
-        dependencies,
-        notes,
-    };
-}
-/**
- * Generate conventions based on file patterns
- */
-function generateConventions(dir) {
-    const lines = ['## Conventions\n'];
-    // Detect naming conventions
-    const hasKebab = dir.files.some(f => f.name.includes('-'));
-    const hasCamel = dir.files.some(f => /[a-z][A-Z]/.test(f.name));
-    const hasPascal = dir.files.some(f => /^[A-Z]/.test(f.name));
-    if (hasPascal)
-        lines.push('- **Naming**: PascalCase for components/classes');
-    if (hasCamel)
-        lines.push('- **Naming**: camelCase for utilities/functions');
-    if (hasKebab)
-        lines.push('- **Naming**: kebab-case for files');
-    // Detect test patterns
-    const hasTestFiles = dir.files.some(f => f.name.includes('.test.') || f.name.includes('.spec.'));
-    if (hasTestFiles) {
-        lines.push('- **Testing**: Co-located test files (*.test.ts, *.spec.ts)');
-    }
-    // Detect TypeScript
-    const hasTs = dir.files.some(f => f.extension === 'ts' || f.extension === 'tsx');
-    if (hasTs) {
-        lines.push('- **Language**: TypeScript');
-    }
-    if (lines.length === 1) {
-        lines.push('No specific conventions detected.');
-    }
-    return lines.join('\n');
-}
-/**
- * Format full AGENTS.md content
- */
-export function formatAgentsMd(content) {
-    const sections = [content.header];
-    if (content.parentRef) {
-        sections.push('', content.parentRef);
-    }
-    sections.push('', content.purpose);
-    sections.push('', content.structure);
-    sections.push('', content.keyFiles);
-    sections.push('', content.conventions);
-    sections.push('', content.dependencies);
-    sections.push('', content.notes);
-    return sections.join('\n');
-}
-/**
- * Preserve manual notes from existing AGENTS.md
- */
-export function preserveManualNotes(existing, newContent) {
-    // Extract notes section from existing
-    const notesMatch = existing.match(/## Notes\n\n([\s\S]*?)(?=\n## |$)/);
-    if (!notesMatch || notesMatch[1].trim() === '<!-- Add manual notes here. They will be preserved on regeneration. -->') {
-        return newContent;
-    }
-    // Replace notes section in new content
-    const preservedNotes = notesMatch[1].trim();
-    return newContent.replace(/## Notes\n\n<!-- Add manual notes here\. They will be preserved on regeneration\. -->/, `## Notes\n\n${preservedNotes}`);
-}
-/**
- * Generate navigation header
- */
-export function generateNavigationHeader(dir, rootPath) {
-    const parts = dir.path.replace(rootPath, '').split(path.sep).filter(Boolean);
-    const breadcrumbs = parts.map((part, i) => {
-        const depth = parts.length - i;
-        const prefix = '../'.repeat(depth);
-        return `[${part}](${prefix}AGENTS.md)`;
-    });
-    if (breadcrumbs.length === 0) {
-        return '📍 Root';
-    }
-    return `📍 ${breadcrumbs.join(' / ')}`;
-}
-/**
- * Describe DeepInit workflow
- */
-export function describeDeepInitWorkflow() {
-    return `
-## DeepInit Workflow
-
-Hierarchical AI-readable documentation generation:
-
-\`\`\`
-project/
-├── AGENTS.md              ← Root documentation
-├── src/
-│   ├── AGENTS.md          ← <!-- Parent: ../AGENTS.md -->
-│   ├── components/
-│   │   └── AGENTS.md      ← <!-- Parent: ../AGENTS.md -->
-│   └── services/
-│       └── AGENTS.md      ← <!-- Parent: ../AGENTS.md -->
-└── tests/
-    └── AGENTS.md          ← <!-- Parent: ../AGENTS.md -->
-\`\`\`
-
-Features:
-- Parent references for navigation
-- Auto-detected purpose and conventions
-- Preserved manual notes on regeneration
-- Entry point identification
-- Child module linking
-`.trim();
-}
-//# sourceMappingURL=DeepInit.js.map

package/dist/infra/lib/DeepInit.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DeepInit.js","sourceRoot":"","sources":["../../../src/infra/lib/DeepInit.ts"],"names":[],"mappings":"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"}

package/dist/infra/lib/FrameworkDetector.d.ts

@@ -1,56 +0,0 @@
-/**
- * Framework Detector - Automatically detect project framework from package.json
- * Inspired by Vercel's deploy script
- */
-export interface FrameworkInfo {
-    id: string;
-    name: string;
-    category: 'frontend' | 'backend' | 'fullstack' | 'static' | 'docs';
-    runtime?: 'node' | 'bun' | 'deno' | 'browser';
-    features?: string[];
-}
-export declare const FRAMEWORKS: Record<string, FrameworkInfo>;
-export interface PackageJson {
-    name?: string;
-    version?: string;
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    scripts?: Record<string, string>;
-}
-export interface DetectionResult {
-    framework: FrameworkInfo | null;
-    confidence: 'high' | 'medium' | 'low';
-    matchedDep?: string;
-    allDetected: string[];
-    packageJson?: PackageJson;
-    projectType: 'monorepo' | 'single' | 'static' | 'unknown';
-}
-/**
- * Detect framework from package.json
- */
-export declare function detectFramework(projectPath: string): Promise<DetectionResult>;
-/**
- * Detect framework from string content (for analysis without file access)
- */
-export declare function detectFrameworkFromContent(content: string): DetectionResult;
-/**
- * Get recommended rules/agents based on framework
- */
-export declare function getFrameworkRecommendations(framework: FrameworkInfo): {
-    reviewers: string[];
-    rules: string[];
-    features: string[];
-};
-/**
- * Format detection result for display
- */
-export declare function formatDetectionResult(result: DetectionResult): string;
-/**
- * Quick check if project uses a specific framework
- */
-export declare function isFramework(projectPath: string, frameworkId: string): Promise<boolean>;
-/**
- * Get all supported frameworks grouped by category
- */
-export declare function getSupportedFrameworks(): Record<string, FrameworkInfo[]>;
-//# sourceMappingURL=FrameworkDetector.d.ts.map

package/dist/infra/lib/FrameworkDetector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FrameworkDetector.d.ts","sourceRoot":"","sources":["../../../src/infra/lib/FrameworkDetector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAoDpD,CAAC;AA6DF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC3D;AAoDD;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmCnF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAmB3E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,aAAa,GAAG;IACrE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAoCA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAyBrE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG5F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAcxE"}