feat: add ProjectDesc field to ragindex.Builder for root node summary

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: tae2089

cmd/ccg/main.go

@@ -157,6 +157,7 @@ func runServe(deps *cli.Deps, cfg cli.ServeConfig) error {
 		Logger:            deps.Logger,
 		Cache:             cache,
 		RagIndexDir:       viper.GetString("rag.index_dir"),
+		RagProjectDesc:    viper.GetString("description"),
 	}
 
 	srv := mcpserver.NewServer(mcpDeps)

internal/cli/ragindex.go

@@ -14,6 +14,7 @@ import (
 func newRagIndexCmd(deps *Deps) *cobra.Command {
 	var outDir string
 	var indexDir string
+	var projectDesc string
 
 	cmd := &cobra.Command{
 		Use:   "rag-index",
@@ -25,9 +26,10 @@ func newRagIndexCmd(deps *Deps) *cobra.Command {
 			}
 
 			b := &ragindex.Builder{
-				DB:       deps.DB,
-				OutDir:   resolveOutDir(outDir),
-				IndexDir: indexDir,
+				DB:          deps.DB,
+				OutDir:      resolveOutDir(outDir),
+				IndexDir:    indexDir,
+				ProjectDesc: projectDesc,
 			}
 
 			communities, files, err := b.Build()
@@ -54,6 +56,7 @@ func newRagIndexCmd(deps *Deps) *cobra.Command {
 
 	cmd.Flags().StringVar(&outDir, "out", "docs", "Documentation directory")
 	cmd.Flags().StringVar(&indexDir, "index-dir", ".ccg", "Directory for doc-index.json output")
+	cmd.Flags().StringVar(&projectDesc, "desc", "", "Project description for root node summary")
 
 	return cmd
 }

internal/mcp/handlers.go

@@ -1366,9 +1366,10 @@ func (h *handlers) buildRagIndex(ctx context.Context, request mcp.CallToolReques
 	}
 
 	b := &ragindex.Builder{
-		DB:       h.deps.DB,
-		OutDir:   outDir,   // empty string → Builder uses "docs" default
-		IndexDir: indexDir, // empty string → Builder uses ".ccg" default
+		DB:          h.deps.DB,
+		OutDir:      outDir,   // empty string → Builder uses "docs" default
+		IndexDir:    indexDir, // empty string → Builder uses ".ccg" default
+		ProjectDesc: h.deps.RagProjectDesc,
 	}
 	communities, files, err := b.Build()
 	if err != nil {

internal/mcp/server.go

@@ -94,6 +94,8 @@ type Deps struct {
 
 	// RagIndexDir — doc-index.json이 저장되는 디렉토리 (기본: ".ccg")
 	RagIndexDir string
+	// RagProjectDesc — root 노드 summary에 사용되는 프로젝트 설명
+	RagProjectDesc string
 }
 
 func NewServer(deps *Deps) *server.MCPServer {

internal/ragindex/builder.go

@@ -33,9 +33,10 @@ type Index struct {
 
 // Builder는 DB에서 인덱스를 빌드하는 구조체이다.
 type Builder struct {
-	DB       *gorm.DB
-	OutDir   string // docs 디렉토리 (기본: "docs")
-	IndexDir string // .ccg 디렉토리 (기본: ".ccg")
+	DB          *gorm.DB
+	OutDir      string // docs 디렉토리 (기본: "docs")
+	IndexDir    string // .ccg 디렉토리 (기본: ".ccg")
+	ProjectDesc string // root 노드 summary (기본: "")
 }
 
 // indexDir는 IndexDir 필드의 기본값을 반환한다.
@@ -97,6 +98,7 @@ func (b *Builder) Build() (int, int, error) {
 	root := &TreeNode{
 		ID:       "root",
 		Label:    "Root",
+		Summary:  b.ProjectDesc,
 		Children: []*TreeNode{},
 	}
 

internal/ragindex/builder_test.go

@@ -300,6 +300,34 @@ func TestBuilder_WritesJSON(t *testing.T) {
 	}
 }
 
+// TestBuilder_ProjectDesc: ProjectDesc 설정 시 root.Summary에 반영됨을 검증한다.
+func TestBuilder_ProjectDesc(t *testing.T) {
+	db := setupDB(t)
+	tmpDir := t.TempDir()
+
+	b := &ragindex.Builder{
+		DB:          db,
+		OutDir:      filepath.Join(tmpDir, "docs"),
+		IndexDir:    filepath.Join(tmpDir, ".ccg"),
+		ProjectDesc: "테스트 프로젝트 설명",
+	}
+
+	_, _, err := b.Build()
+	if err != nil {
+		t.Fatalf("Build: %v", err)
+	}
+
+	idxPath := filepath.Join(tmpDir, ".ccg", "doc-index.json")
+	idx, err := ragindex.LoadIndex(idxPath)
+	if err != nil {
+		t.Fatalf("LoadIndex: %v", err)
+	}
+
+	if idx.Root.Summary != "테스트 프로젝트 설명" {
+		t.Errorf("root.Summary = %q, want %q", idx.Root.Summary, "테스트 프로젝트 설명")
+	}
+}
+
 // TestFindNode: FindNode가 재귀적으로 트리에서 노드를 찾는지 검증한다.
 func TestFindNode(t *testing.T) {
 	root := &ragindex.TreeNode{