@tienne/gestalt 0.9.1 → 0.9.2

package/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/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/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. 변경된 파일이 없으면 "현재 미커밋 변경이 없습니다." 안내합니다.