docs: update guides for Lua/Luau parser, include_paths, and panic recovery

Author: tae2089

README.md

@@ -6,10 +6,10 @@ Inspired by [code-review-graph](https://github.com/tirth8205/code-review-graph)
 
 ## Features
 
-- **12 languages**: Go, Python, TypeScript, Java, Ruby, JavaScript, C, C++, Rust, Kotlin, PHP, Lua
+- **12 languages**: Go, Python, TypeScript, Java, Ruby, JavaScript, C, C++, Rust, Kotlin, PHP, Lua/Luau
 - **29 MCP tools**: parse, search, impact analysis, flow tracing, dead code detection, file workspace management, and more
 - **Custom annotations**: `@intent`, `@domainRule`, `@sideEffect`, `@mutates`, `@index` — search code by business context ([details](guide/annotations.md))
-- **Webhook sync**: GitHub / Gitea push events → auto clone + build with per-repo branch filtering ([details](guide/webhook.md))
+- **Webhook sync**: GitHub / Gitea push events → auto clone + build with per-repo branch filtering and `.ccg.yaml` `include_paths` auto-loading ([details](guide/webhook.md))
 - **Multi-DB**: SQLite (local), PostgreSQL
 - **Full-text search**: FTS5 (SQLite), tsvector+GIN (PostgreSQL)
 

guide/architecture.md

@@ -25,7 +25,9 @@ Source Code → Tree-sitter Parser → Nodes + Edges + Annotations
 
 Tree-sitter 기반 코드 파서. 12개 언어를 지원하며 각 언어별 `LangSpec`으로 함수, 클래스, 타입, 임포트, 호출 관계를 추출합니다.
 
-**지원 언어**: Go, Python, TypeScript, Java, Ruby, JavaScript, C, C++, Rust, Kotlin, PHP, Lua
+**지원 언어**: Go, Python, TypeScript, Java, Ruby, JavaScript, C, C++, Rust, Kotlin, PHP, Lua/Luau
+
+> Lua 파서는 Luau(Roblox) 문법도 지원합니다. 타입 어노테이션은 tree-sitter 에러 복구로 무시되며, 함수(global, local, method), 주석(한줄, 블록, `--!strict`)을 모두 추출합니다.
 
 ### Store (`internal/store/gormstore/`)
 
@@ -61,6 +63,15 @@ DB별 전문 검색 백엔드:
 
 28개 도구를 MCP 프로토콜로 노출. stdio와 Streamable HTTP 두 가지 전송 모드 지원.
 
+### Reliability
+
+운영 안정성을 위해 모든 goroutine에 panic recovery가 적용되어 있습니다:
+
+- **Signal handler**: panic 시 에러 로깅 후 `os.Exit(2)`
+- **HTTP server**: panic을 에러 채널로 전파하여 정상 종료 흐름 유지
+- **SyncQueue worker**: panic 로깅 후 다른 워커에 영향 없이 계속 동작
+- **SyncQueue shutdown**: shutdown 과정의 panic 격리
+
 ### Webhook (`internal/webhook/`)
 
 GitHub/Gitea push 이벤트 수신 → 자동 clone/build 파이프라인.

guide/cli-reference.md

@@ -79,10 +79,28 @@ exclude:
   - ".*\\.pb\\.go$"
   - ".*_test\\.go$"
 
+include_paths:
+  - src/
+  - lib/
+
 docs:
   out: docs
 ```
 
+### `include_paths`
+
+빌드 대상 경로를 제한합니다. 설정 시 지정된 경로 하위만 파싱됩니다.
+
+- CLI: `ccg build` 시 `.ccg.yaml`의 `include_paths` 자동 적용
+- Webhook: 레포 clone 후 `.ccg.yaml`의 `include_paths`를 자동 로딩하여 빌드 범위 제한
+- 증분 빌드(`ccg update`): 변경 파일 수집 시 `include_paths` 필터 적용
+
+```yaml
+include_paths:
+  - src/backend/
+  - src/shared/
+```
+
 ### Regex Patterns
 
 `exclude`와 `rules` 패턴 필드는 정규표현식을 지원합니다. `$`, `^`, `+`, `{}`, `|`, `\.`, `.*` 를 포함하는 패턴은 자동으로 regex로 감지됩니다:

guide/development.md

@@ -48,9 +48,9 @@ internal/
   cli/                — CLI 커맨드 정의
   ctxns/              — Context namespace
   docs/               — 문서 생성
-  mcp/                — MCP 서버 (28 tools)
+  mcp/                — MCP 서버 (29 tools)
   model/              — DB 모델
-  parse/treesitter/   — Tree-sitter 파서 (12 languages)
+  parse/treesitter/   — Tree-sitter 파서 (12 languages, Lua/Luau 포함)
   pathutil/           — 경로 유틸리티
   ragindex/           — RAG 인덱스
   service/            — 비즈니스 로직

guide/webhook.md

@@ -98,3 +98,26 @@ Push Event → HMAC Verify → RepoFilter.IsAllowedRef()
 - 기본 4개 워커
 - 서로 다른 레포는 병렬 처리
 - 같은 레포는 순차 처리 (dirty requeue)
+
+## `.ccg.yaml` include_paths 자동 반영
+
+Webhook 빌드 시 clone된 레포 내 `.ccg.yaml` 파일의 `include_paths` 설정을 자동으로 읽어 빌드 범위를 제한합니다.
+
+```yaml
+# 레포 내 .ccg.yaml
+include_paths:
+  - src/
+  - lib/
+```
+
+- `.ccg.yaml` 파일이 없거나 `include_paths` 키가 없으면 전체 디렉토리를 빌드합니다
+- CLI의 `--config` 플래그와 독립적으로 동작합니다 (viper 미사용, yaml 직접 파싱)
+
+## Panic Recovery
+
+모든 goroutine에 `defer recover()`가 적용되어 있어 개별 워커 panic이 전체 프로세스를 크래시시키지 않습니다:
+
+- Signal handler goroutine
+- HTTP server goroutine
+- SyncQueue worker goroutine
+- SyncQueue shutdown goroutine