@tienne/gestalt 0.9.1 → 0.10.0

package/CLAUDE.md

@@ -11,6 +11,7 @@
 - **Resilience Engine**: Stagnation 감지 → Lateral Thinking Personas → Human Escalation
 - **MCP Server**: stdio transport로 Claude Code 등 AI 에이전트와 통합
 - **Skill System**: SKILL.md 기반 확장, chokidar hot-reload 지원. 각 스킬(`/interview`, `/spec`, `/execute`)은 실행 중 Claude Code Task 패널에 진행 상태를 `TaskCreate`/`TaskUpdate`로 실시간 표시 (공통 진행 패널)
+- **Code Knowledge Graph**: 코드베이스 정적 분석 → 의존성 그래프화 → Blast-Radius로 영향 파일 추림. Execute 파이프라인 태스크 실행 시 `suggestedFiles`로 자동 컨텍스트 주입해 불필요한 파일 읽기를 줄임
 - **Event Store**: better-sqlite3 WAL 모드 이벤트 소싱
 
 ## Tech Stack
@@ -25,6 +26,9 @@ pnpm tsx bin/gestalt.ts interview "topic"  # Interactive interview
 pnpm tsx bin/gestalt.ts spec <session-id>  # Generate spec
 pnpm tsx bin/gestalt.ts status             # Check sessions
 pnpm tsx bin/gestalt.ts setup              # Generate gestalt.json config
+pnpm tsx bin/gestalt.ts init               # One-step onboarding: gestalt.json + code graph + post-commit hook
+pnpm tsx bin/gestalt.ts init --skip-graph  # Skip code graph build
+pnpm tsx bin/gestalt.ts init --skip-hook   # Skip post-commit hook installation
 ```
 
 ## Configuration
@@ -89,6 +93,7 @@ interface GestaltConfig {
 - `ges_generate_spec`: sessionId? (optional), text? (optional), force?, spec? (passthrough)
 - `ges_execute`: action=[start|plan_step|plan_complete|execute_start|execute_task|evaluate|status|evolve_fix|evolve|evolve_patch|evolve_re_execute|evolve_lateral|evolve_lateral_result|role_match|role_consensus]
 - `ges_create_agent`: action=[start|submit] — 인터뷰 기반 커스텀 Role Agent 생성
+- `ges_code_graph`: action=[build|blast_radius|query|stats|db_exists] — 코드 지식 그래프 관리
 - `ges_status`: sessionId?
 
 ## MCP Passthrough Mode
@@ -367,6 +372,7 @@ ges_execute({ action: "role_consensus", sessionId: "<id>", consensus: {...} })
 - `src/spec/` — SpecGenerator, SpecExtractor
 - `src/execute/` — ExecuteEngine, DAG Validator, ExecuteSessionManager
 - `src/resilience/` — Stagnation Detector, Lateral Thinking Personas, Human Escalation
+- `src/code-graph/` — CodeGraphEngine, CodeGraphStore, BlastRadius, 언어 플러그인 8개
 - `src/skills/` — SkillRegistry, parser
 - `src/agent/` — AgentRegistry, FiguralRouter, multi-provider LLM, RoleAgentRegistry, PassthroughAgentGenerator
 - `src/registry/` — BaseRegistry 추상 클래스
@@ -376,6 +382,75 @@ ges_execute({ action: "role_consensus", sessionId: "<id>", consensus: {...} })
 - `src/cli/` — commander 기반 CLI (interview, spec, status, setup)
 - `schemas/` — JSON Schema (gestalt.schema.json)
 - `role-agents/` — 내장 Role Agent 정의 (architect, frontend-developer 등 8개)
+- `skills/` — 외부 스킬 정의 (`build-graph`, `blast-radius`)
+
+## Code Knowledge Graph
+
+코드베이스를 정적 분석해 의존성 그래프를 빌드하고, 변경 영향 파일을 빠르게 추려 AI 컨텍스트를 절약한다.
+
+### ges_code_graph MCP 툴
+
+```
+// 그래프 빌드 (최초 또는 full rebuild)
+ges_code_graph({ action: "build", repoRoot: "<절대경로>" })
+→ { nodesBuilt, edgesBuilt, timeTakenMs, installedHook }
+
+// Blast-Radius 분석 (커밋 기준 영향범위)
+ges_code_graph({ action: "blast_radius", repoRoot: "<경로>", base?: "HEAD~1", changedFiles?: [...], maxDepth?: 2 })
+→ { changedFiles, impactedFiles, riskScore, summary }
+
+// Diff-Radius 분석 (미커밋 변경 기준 영향범위)
+ges_code_graph({ action: "diff_radius", repoRoot: "<경로>", diffMode?: "staged"|"unstaged"|"all", maxDepth?: 2 })
+→ { changedFiles, impactedFiles, riskScore, summary }
+
+// 키워드 기반 관련 파일 검색
+ges_code_graph({ action: "query", repoRoot: "<경로>", pattern: "callers_of"|"callees_of"|"tests_for"|"imports_of", target: "<노드명>" })
+→ { nodes, edges }
+
+// 그래프 통계
+ges_code_graph({ action: "stats", repoRoot: "<경로>" })
+→ { totalFiles, totalNodes, totalEdges, lastBuiltAt, dbSizeBytes }
+
+// DB 존재 여부 확인
+ges_code_graph({ action: "db_exists", repoRoot: "<경로>" })
+→ { exists: boolean }
+```
+
+저장소: `.gestalt/code-graph.db` (WAL SQLite, EventStore DB와 별도)
+
+### 자동 컨텍스트 주입 (Execute 파이프라인 통합)
+
+`ges_execute { action: "start", spec: {...}, codeGraphRepoRoot: "/path" }` 호출 시 활성화.
+
+태스크 실행 시 `buildNextTaskContext()`가 자동으로:
+1. 태스크 title + description에서 키워드를 추출 (`extractKeywords()`)
+2. `codeGraphEngine.searchByKeywords()`로 관련 파일 최대 10개 검색
+3. `execute_task` 응답의 `suggestedFiles` 필드로 반환
+
+Claude Code가 `suggestedFiles`를 받으면 해당 파일을 먼저 Read한 뒤 태스크를 수행한다 (`EXECUTE_EXECUTION_SYSTEM_PROMPT` 지시).
+
+code-graph.db가 없거나 검색 실패 시 `suggestedFiles`는 undefined — 기존 동작 그대로 유지 (graceful fallback).
+
+### 스킬
+
+| 스킬 | 파일 | 설명 |
+|------|------|------|
+| `/build-graph` | `skills/build-graph/SKILL.md` | 코드 그래프 빌드 및 증분 갱신 |
+| `/blast-radius` | `skills/blast-radius/SKILL.md` (v1.1.0) | 영향범위 분석 (커밋 기준), 23개 트리거 |
+| `/diff-radius` | `skills/diff-radius/SKILL.md` (v1.0.0) | 영향범위 분석 (미커밋 기준), staged/unstaged/all 지원 |
+
+blast-radius 스킬은 "영향범위", "어디까지 영향받아", "사이드 이펙트", "리팩토링" 등 자연스러운 한국어 표현으로 자동 발동한다. CLAUDE.md나 훅과 달리 호출 시에만 토큰이 발생한다.
+
+### 언어 플러그인 (8개)
+
+TypeScript/JavaScript, Python, Go, Java, Kotlin, Rust, Swift, Objective-C
+
+각 플러그인: `{ language, extensions[], parse(filePath) → {nodes, edges} }`
+TypeScript 플러그인은 TypeScript Compiler API 사용 (Tree-sitter 불필요).
+
+### 주의사항
+- `glob` 패키지 미사용 → `readdirSync({ recursive: true })`로 파일 수집, `Dirent.parentPath` 활용
+- `noUncheckedIndexedAccess` 환경 → 배열 인덱스·regex 캡처그룹에 `!` 단언 필수
 
 ## Conventions
 - MCP 서버에서 `console.log` 사용 금지 → stderr(`log()` 유틸)

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -48,6 +48,7 @@
     "jimp": "^1.6.0",
     "node-notifier": "^10.0.1",
     "node-pty": "^1.1.0",
+    "open": "^11.0.0",
     "openai": "^6.27.0",
     "react": "^19.2.4",
     "zod": "^3.24.2"

package/dist/skills/blast-radius/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: blast-radius
+version: "1.1.0"
+description: "코드 변경 전 영향 범위를 파악해 읽어야 할 파일만 컨텍스트에 제공한다. 변경 범위가 불확실하거나 사이드 이펙트가 걱정될 때 자동 발동한다."
+triggers:
+  # 영향범위 확인 의도
+  - "영향범위"
+  - "영향범위 확인"
+  - "영향범위 얼마나 돼"
+  - "어디까지 영향받아"
+  - "어디 영향받아"
+  - "뭐가 깨질 수 있어"
+  - "어떤 파일 같이 봐야 해"
+  - "관련 파일 뭐 있어"
+  - "어디 의존하고 있어"
+  - "어디서 쓰이고 있어"
+  # 변경 전 안전 확인 의도
+  - "건드리기 전에"
+  - "수정 전에 확인"
+  - "수정 범위"
+  - "사이드 이펙트"
+  # 범위가 큰 변경 작업
+  - "시그니처 바꿔"
+  - "인터페이스 변경"
+  - "타입 바꿔"
+  - "리팩토링"
+  # 기존 영어 표현 유지
+  - "blast radius"
+  - "blast-radius"
+  - "impact analysis"
+inputs:
+  repoRoot:
+    type: string
+    required: false
+    description: "Repository root path (defaults to current working directory)"
+  changedFiles:
+    type: string[]
+    required: false
+    description: "Changed file paths (auto-detected from git diff HEAD~1 if omitted)"
+  base:
+    type: string
+    required: false
+    description: "Git base ref for diff detection (default: HEAD~1)"
+  maxDepth:
+    type: number
+    required: false
+    description: "BFS traversal depth (default: 2)"
+outputs:
+  - changedFiles
+  - impactedFiles
+  - riskScore
+  - summary
+---
+
+# Blast Radius Skill
+
+최근 코드 변경의 영향 범위를 분석해 **읽어야 할 파일만** 컨텍스트에 제공합니다. 불필요한 파일 읽기를 줄여 LLM 토큰 사용을 최소화합니다.
+
+## 전제 조건
+
+코드 지식 그래프가 먼저 빌드되어 있어야 합니다:
+```
+/build-graph
+```
+
+## 실행 방법
+
+### 기본 (마지막 커밋 변경 파일 자동 감지)
+
+```
+ges_code_graph {
+  action: "blast_radius",
+  repoRoot: "<현재 디렉토리 절대 경로>"
+}
+```
+
+### 변경 파일 직접 지정
+
+```
+ges_code_graph {
+  action: "blast_radius",
+  repoRoot: "<경로>",
+  changedFiles: ["src/auth.ts", "src/middleware.ts"]
+}
+```
+
+### Git base ref 지정
+
+```
+ges_code_graph {
+  action: "blast_radius",
+  repoRoot: "<경로>",
+  base: "main"
+}
+```
+
+## 결과 해석
+
+| 필드 | 설명 |
+|------|------|
+| `changedFiles` | 변경된 파일 목록 |
+| `impactedFiles` | 영향받는 파일 목록 (테스트 파일 우선 정렬) |
+| `riskScore` | 위험도 점수 0~1 (전체 대비 영향 노드 비율) |
+| `summary` | 한 줄 요약 |
+
+## Skill Instructions
+
+1. `repoRoot`가 주어지지 않으면 현재 작업 디렉토리를 절대 경로로 사용합니다.
+2. 코드 그래프 DB가 없으면 먼저 `/build-graph`를 실행하도록 안내합니다:
+   - `ges_code_graph { action: "db_exists", repoRoot: "<repoRoot>" }` 호출
+   - `exists: false`이면 빌드 먼저 안내
+3. `ges_code_graph { action: "blast_radius", repoRoot: "<repoRoot>", changedFiles?: [...], base?: "...", maxDepth?: 2 }` 호출합니다.
+4. 결과를 다음 형식으로 표시합니다:
+
+```
+## 영향범위 분석 결과
+
+**변경된 파일** (N개):
+- src/auth.ts
+- src/middleware.ts
+
+**영향받는 파일** (M개):
+- src/auth.test.ts        ← 테스트 파일 우선
+- src/api/routes.ts
+- src/api/middleware.ts
+
+**위험도**: 0.23 (낮음)
+**요약**: {summary}
+```
+
+5. `impactedFiles` 목록을 컨텍스트로 활용합니다:
+   - "아래 파일들이 영향을 받을 수 있습니다. 관련 작업 전 이 파일들을 먼저 읽어보겠습니다:" 형식으로 안내
+   - 파일이 많으면 (10개 이상) 가장 중요한 파일(테스트 파일, 핵심 모듈)을 우선 읽도록 제안
+6. 빌드된 그래프가 오래된 경우 `/build-graph --incremental` 실행을 권장합니다.

package/dist/skills/build-graph/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: build-graph
+version: "1.0.0"
+description: "Build a code knowledge graph for the current repository to enable blast-radius analysis"
+triggers:
+  - "build graph"
+  - "build-graph"
+  - "index codebase"
+  - "build code graph"
+inputs:
+  repoRoot:
+    type: string
+    required: false
+    description: "Repository root path (defaults to current working directory)"
+  include:
+    type: string[]
+    required: false
+    description: "Glob patterns to include (default: **/*)"
+  exclude:
+    type: string[]
+    required: false
+    description: "Glob patterns to exclude"
+  mode:
+    type: string
+    required: false
+    description: "Build mode: 'full' (default) or 'incremental' (hash-based, skip unchanged files)"
+outputs:
+  - nodesBuilt
+  - edgesBuilt
+  - timeTakenMs
+---
+
+# Build Graph Skill
+
+코드베이스를 정적 분석해 코드 지식 그래프를 빌드합니다. 이 그래프를 바탕으로 `/blast-radius` 스킬을 사용할 수 있습니다.
+
+## 목적
+
+코드 지식 그래프는 파일·함수·클래스 사이의 의존 관계를 SQLite DB(`.gestalt/code-graph.db`)에 저장합니다. 한 번 빌드해두면 `blast-radius` 분석으로 변경 영향 파일만 빠르게 조회할 수 있어 불필요한 파일 읽기를 크게 줄일 수 있습니다.
+
+## 지원 언어
+
+TypeScript / JavaScript, Python, Go, Java, Kotlin, Rust, Swift, Objective-C
+
+## 실행 방법
+
+### 기본 (전체 빌드)
+
+```
+ges_code_graph {
+  action: "build",
+  repoRoot: "<현재 디렉토리 절대 경로>"
+}
+```
+
+### 증분 빌드 (변경 파일만 재파싱)
+
+```
+ges_code_graph {
+  action: "build",
+  repoRoot: "<현재 디렉토리 절대 경로>",
+  mode: "incremental"
+}
+```
+
+### 특정 디렉토리만 포함
+
+```
+ges_code_graph {
+  action: "build",
+  repoRoot: "<경로>",
+  include: ["src/**", "lib/**"],
+  exclude: ["**/*.test.ts", "dist/**"]
+}
+```
+
+## 빌드 후 통계 확인
+
+```
+ges_code_graph {
+  action: "stats",
+  repoRoot: "<경로>"
+}
+```
+
+## 결과 해석
+
+| 필드 | 설명 |
+|------|------|
+| `nodesBuilt` | 인덱싱된 노드 수 (파일·함수·클래스·타입) |
+| `edgesBuilt` | 인덱싱된 엣지 수 (호출·임포트·상속·포함 관계) |
+| `timeTakenMs` | 소요 시간 (밀리초) |
+
+## Skill Instructions
+
+1. `repoRoot`가 주어지지 않으면 현재 작업 디렉토리(`cwd`)를 절대 경로로 사용합니다.
+2. `ges_code_graph { action: "build", repoRoot: "<repoRoot>", mode: "<mode>" }`를 호출합니다.
+3. 빌드 결과를 사용자에게 표시합니다.
+4. "그래프 빌드 완료! 이제 `/blast-radius`로 변경 영향 파일을 분석할 수 있습니다." 안내를 포함합니다.
+5. 오류가 발생하면 오류 내용을 표시하고 지원 언어인지 확인하도록 안내합니다.

package/dist/skills/diff-radius/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: diff-radius
+version: "1.0.0"
+description: "커밋 전 미저장·스테이징 변경의 영향범위를 분석한다. 작업 중인 코드가 어디까지 영향 주는지 바로 확인할 때 자동 발동한다."
+triggers:
+  # 작업 중 변경 확인
+  - "지금 바꾼 거 영향범위"
+  - "작업 중인 거 영향범위"
+  - "저장한 거 영향범위"
+  - "수정 중인 거 영향범위"
+  - "아직 커밋 안 한 거 영향범위"
+  - "미커밋 영향범위"
+  # 스테이징 확인
+  - "스테이징된 거 영향범위"
+  - "staged 영향범위"
+  - "git add 한 거 영향범위"
+  # 커밋 전 안전 확인
+  - "커밋 전에 영향범위"
+  - "올리기 전에 영향범위"
+  - "푸시 전에 영향범위"
+inputs:
+  repoRoot:
+    type: string
+    required: false
+    description: "Repository root path (defaults to current working directory)"
+  diffMode:
+    type: string
+    required: false
+    description: "staged: git diff --cached, unstaged: git diff, all: staged+unstaged (default)"
+  maxDepth:
+    type: number
+    required: false
+    description: "BFS traversal depth (default: 2)"
+outputs:
+  - changedFiles
+  - impactedFiles
+  - riskScore
+  - summary
+---
+
+# Diff Radius Skill
+
+커밋하지 않은 변경의 영향범위를 분석합니다. `/blast-radius`가 커밋 기준이라면, 이 스킬은 **지금 작업 중인 변경** 기준으로 동작합니다.
+
+## 전제 조건
+
+코드 지식 그래프가 먼저 빌드되어 있어야 합니다:
+```
+/build-graph
+```
+
+## 실행 방법
+
+### 기본 (staged + unstaged 전체)
+
+```
+ges_code_graph {
+  action: "diff_radius",
+  repoRoot: "<현재 디렉토리 절대 경로>"
+}
+```
+
+### 스테이징된 변경만 (git add 한 것)
+
+```
+ges_code_graph {
+  action: "diff_radius",
+  repoRoot: "<경로>",
+  diffMode: "staged"
+}
+```
+
+### 아직 스테이징 안 된 변경만
+
+```
+ges_code_graph {
+  action: "diff_radius",
+  repoRoot: "<경로>",
+  diffMode: "unstaged"
+}
+```
+
+## blast-radius와 차이
+
+| | `/blast-radius` | `/diff-radius` |
+|---|---|---|
+| 기준 | 마지막 커밋 (`HEAD~1`) | 현재 작업 중인 변경 |
+| git 명령 | `git diff HEAD~1` | `git diff HEAD` / `git diff --cached` |
+| 용도 | 배포된 변경 영향 확인 | 커밋 전 영향범위 사전 확인 |
+
+## 결과 해석
+
+| 필드 | 설명 |
+|------|------|
+| `changedFiles` | 변경된 파일 목록 |
+| `impactedFiles` | 영향받는 파일 목록 (테스트 파일 우선 정렬) |
+| `riskScore` | 위험도 점수 0~1 |
+| `summary` | 한 줄 요약 |
+
+## Skill Instructions
+
+1. `repoRoot`가 주어지지 않으면 현재 작업 디렉토리를 절대 경로로 사용합니다.
+2. 코드 그래프 DB가 없으면 먼저 `/build-graph`를 실행하도록 안내합니다:
+   - `ges_code_graph { action: "db_exists", repoRoot: "<repoRoot>" }` 호출
+   - `exists: false`이면 빌드 먼저 안내
+3. `ges_code_graph { action: "diff_radius", repoRoot: "<repoRoot>", diffMode?: "staged"|"unstaged"|"all", maxDepth?: 2 }` 호출합니다.
+4. 결과를 다음 형식으로 표시합니다:
+
+```
+## 영향범위 분석 결과 (미커밋 변경)
+
+**변경된 파일** (N개):
+- src/auth.ts
+- src/middleware.ts
+
+**영향받는 파일** (M개):
+- src/auth.test.ts        ← 테스트 파일 우선
+- src/api/routes.ts
+
+**위험도**: 0.23 (낮음)
+**요약**: {summary}
+```
+
+5. `impactedFiles` 목록을 컨텍스트로 활용합니다.
+6. 변경된 파일이 없으면 "현재 미커밋 변경이 없습니다." 안내합니다.

package/dist/skills/setup/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: setup
+version: "1.0.0"
+description: "Gestalt 프로젝트 초기 설정 — gestalt.json 생성, 코드 그래프 빌드, post-commit 훅 설치"
+triggers:
+  - "gestalt 초기화"
+  - "gestalt init"
+  - "gestalt setup"
+  - "setup gestalt"
+  - "프로젝트 설정"
+inputs:
+  cwd:
+    type: string
+    required: false
+    description: "초기화할 프로젝트 디렉토리 (기본값: 현재 디렉토리)"
+outputs:
+  - gestalt.json
+  - code-graph.db
+  - post-commit hook
+---
+
+# Setup Skill
+
+`gestalt init` 명령어와 동일한 초기화 작업을 Claude Code 스킬로 실행한다.
+
+## 실행 단계
+
+1. **선택 화면**: `AskUserQuestion`으로 실행할 단계를 다중 선택
+2. **gestalt.json 생성**: 프로젝트 루트에 기본 설정 파일 생성
+3. **코드 그래프 빌드**: `ges_code_graph { action: "build" }`로 의존성 그래프 구축
+4. **post-commit 훅 설치**: `gestalt init --skip-graph --skip-hook`을 활용해 훅만 설치
+
+---
+
+## 실행 방법
+
+### Step 1 — 실행할 단계 선택
+
+`AskUserQuestion`으로 다음 질문을 표시한다. **3개 모두 기본 선택**으로 제시한다.
+
+```
+질문: "실행할 초기화 단계를 선택하세요 (기본: 전체)"
+multiSelect: true
+옵션:
+  - label: "gestalt.json 생성 (Recommended)"
+    description: "프로젝트 루트에 gestalt.json 설정 파일을 생성합니다"
+  - label: "코드 그래프 빌드 (Recommended)"
+    description: "코드베이스를 분석해 의존성 그래프를 구축합니다 (시간이 걸릴 수 있음)"
+  - label: "post-commit 훅 설치 (Recommended)"
+    description: "커밋 시 코드 그래프를 자동으로 갱신하는 git 훅을 설치합니다"
+```
+
+선택된 항목에 따라 아래 단계를 순서대로 실행한다. 아무것도 선택하지 않으면 중단한다.
+
+---
+
+### Step 2 — gestalt.json 생성 (선택된 경우)
+
+프로젝트 루트에 `gestalt.json`이 이미 존재하는지 확인한다.
+
+**파일이 없으면**: Bash로 생성한다.
+
+```bash
+! pnpm tsx bin/gestalt.ts setup
+```
+
+또는 npx로 설치된 환경이면:
+
+```bash
+! npx @tienne/gestalt setup
+```
+
+**파일이 이미 존재하면**: 사용자에게 덮어쓸지 확인 후 진행한다.
+
+성공 시 출력:
+```
+✓ gestalt.json 생성 완료
+```
+
+---
+
+### Step 3 — 코드 그래프 빌드 (선택된 경우)
+
+`ges_code_graph` MCP 툴을 사용한다.
+
+```
+ges_code_graph({ action: "build", repoRoot: "<현재 디렉토리 절대경로>" })
+```
+
+응답 예시:
+```json
+{ "nodesBuilt": 1192, "edgesBuilt": 1321, "timeTakenMs": 4200 }
+```
+
+성공 시 출력:
+```
+✓ 코드 그래프 빌드 완료: 노드 {nodesBuilt}개, 엣지 {edgesBuilt}개 ({timeTakenMs}ms)
+```
+
+실패해도 다음 단계를 계속 진행한다 (non-fatal).
+
+---
+
+### Step 4 — post-commit 훅 설치 (선택된 경우)
+
+```bash
+! pnpm tsx bin/gestalt.ts init --skip-graph
+```
+
+또는:
+
+```bash
+! npx @tienne/gestalt init --skip-graph
+```
+
+성공 시 출력:
+```
+✓ post-commit 훅 설치 완료
+```
+
+---
+
+### Step 5 — 완료 메시지
+
+선택된 모든 단계 완료 후:
+
+```
+Gestalt 초기화 완료!
+
+완료된 단계:
+  ✓ gestalt.json 생성
+  ✓ 코드 그래프 빌드 (노드 1192개, 엣지 1321개)
+  ✓ post-commit 훅 설치
+
+이제 다음 스킬을 바로 사용할 수 있습니다:
+  /gestalt:interview  — 요구사항 인터뷰
+  /build-graph        — 코드 그래프 갱신
+  /blast-radius       — 영향 범위 분석
+```
+
+---
+
+## 에러 처리
+
+| 상황 | 대응 |
+|------|------|
+| `gestalt.json` 이미 존재 | 덮어쓸지 확인 후 진행 |
+| 코드 그래프 빌드 실패 | 경고 출력 후 다음 단계 계속 |
+| git 저장소 아님 | post-commit 훅 설치 건너뜀 + 안내 |
+| CLI 명령어 없음 | `pnpm add @tienne/gestalt` 안내 |

package/dist/src/cli/commands/graph-visualize.d.ts

@@ -0,0 +1,11 @@
+export interface GraphVisualizeOptions {
+    repoRoot?: string;
+    port?: number;
+    noBrowser?: boolean;
+}
+/**
+ * CLI entry point for `gestalt graph-visualize`.
+ * Starts the visualization server and keeps the process alive until Ctrl+C.
+ */
+export declare function graphVisualizeCommand(opts?: GraphVisualizeOptions): Promise<void>;
+//# sourceMappingURL=graph-visualize.d.ts.map

package/dist/src/cli/commands/graph-visualize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-visualize.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/graph-visualize.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3F"}

package/dist/src/cli/commands/graph-visualize.js

@@ -0,0 +1,26 @@
+import { resolve } from 'node:path';
+import { GraphVisualizationEngine } from '../../graph-viz/engine.js';
+/**
+ * CLI entry point for `gestalt graph-visualize`.
+ * Starts the visualization server and keeps the process alive until Ctrl+C.
+ */
+export async function graphVisualizeCommand(opts = {}) {
+    const repoRoot = resolve(opts.repoRoot ?? process.cwd());
+    const port = opts.port ? Number(opts.port) : undefined;
+    const openBrowser = !opts.noBrowser;
+    const engine = new GraphVisualizationEngine();
+    try {
+        const result = await engine.start({ repoRoot, port, openBrowser });
+        console.log(`\nGraph visualization running at: ${result.url}`);
+        console.log(`${result.message}`);
+        console.log('\nPress Ctrl+C to stop the server.\n');
+        // Keep process alive until SIGINT (the server's own SIGINT handler will exit)
+        await new Promise(() => { });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Error starting graph visualization: ${msg}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=graph-visualize.js.map

package/dist/src/cli/commands/graph-visualize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-visualize.js","sourceRoot":"","sources":["../../../../src/cli/commands/graph-visualize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAQrE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAA8B,EAAE;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;IAEpC,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,qCAAqC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QAEpD,8EAA8E;QAC9E,MAAM,IAAI,OAAO,CAAO,GAAG,EAAE,GAA2B,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/cli/commands/init.d.ts

@@ -0,0 +1,5 @@
+export declare function initCommand(options: {
+    skipGraph?: boolean;
+    skipHook?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=init.d.ts.map