Write namespace RAG indexes under namespace dirs

Author: tae2089

internal/cli/docs.go

@@ -164,13 +164,21 @@ func buildDocsRAGIndex(ctx context.Context, deps *Deps, opts docsRAGOptions) (in
 	b := &ragindex.Builder{
 		DB:          deps.DB,
 		OutDir:      opts.OutDir,
-		IndexDir:    opts.IndexDir,
+		IndexDir:    namespaceRagIndexDir(opts.IndexDir, ns),
 		ProjectDesc: opts.ProjectDesc,
 	}
 	communities, files, err := b.Build(ctx)
 	return communities, files, rebuilt, err
 }
 
+// @intent align CLI RAG index output with MCP and Wiki server namespace lookup paths.
+func namespaceRagIndexDir(baseDir, namespace string) string {
+	if ctxns.Normalize(namespace) == ctxns.DefaultNamespace {
+		return baseDir
+	}
+	return filepath.Join(baseDir, namespace)
+}
+
 // resolveRagIndexDir honors rag.index_dir when the CLI flag is left at its default.
 // @intent keep docs and rag-index commands aligned with config-based RAG output paths.
 func resolveRagIndexDir(flagValue string) string {

internal/cli/docs_test.go

@@ -98,6 +98,40 @@ func TestDocsCommand_BuildsRAGIndexByDefault(t *testing.T) {
 	}
 }
 
+func TestDocsCommand_BuildsNamespaceIndexes(t *testing.T) {
+	deps, stdout, stderr, db := setupDocsTest(t)
+
+	db.Create(&model.Node{
+		Namespace:     "alpha",
+		QualifiedName: "pkg.Main",
+		Kind:          model.NodeKindFunction,
+		Name:          "Main",
+		FilePath:      "pkg/main.go",
+		StartLine:     1, EndLine: 5,
+		Hash: "h1", Language: "go",
+	})
+
+	outDir := t.TempDir()
+	indexDir := t.TempDir()
+	if err := executeCmd(deps, stdout, stderr, "--namespace", "alpha", "docs", "--out", outDir, "--rag-index-dir", indexDir); err != nil {
+		t.Fatalf("docs: %v", err)
+	}
+
+	if _, err := os.Stat(filepath.Join(indexDir, "alpha", "doc-index.json")); err != nil {
+		t.Fatalf("expected namespace doc-index.json to be created: %v", err)
+	}
+	if _, err := os.Stat(filepath.Join(indexDir, "alpha", "wiki-index.json")); err != nil {
+		t.Fatalf("expected namespace wiki-index.json to be created: %v", err)
+	}
+	if _, err := os.Stat(filepath.Join(indexDir, "doc-index.json")); !os.IsNotExist(err) {
+		t.Fatalf("default doc-index.json should not be written for named namespace, stat err=%v", err)
+	}
+	out := stdout.String()
+	if !strings.Contains(out, "Wiki index written:") || !strings.Contains(out, "RAG index written:") {
+		t.Fatalf("expected index output, got:\n%s", out)
+	}
+}
+
 func TestDocsCommand_RAGFlagCanDisableIndexBuild(t *testing.T) {
 	deps, stdout, stderr, db := setupDocsTest(t)
 

internal/cli/ragindex.go

@@ -41,12 +41,12 @@ func newRagIndexCmd(deps *Deps) *cobra.Command {
 			b := &ragindex.Builder{
 				DB:          deps.DB,
 				OutDir:      resolveOutDir(outDir),
-				IndexDir:    indexDir,
+				IndexDir:    namespaceRagIndexDir(indexDir, viper.GetString("namespace")),
 				ProjectDesc: projectDesc,
 			}
 
 			ctx := cmd.Context()
-			ns, _ := cmd.Flags().GetString("namespace")
+			ns := viper.GetString("namespace")
 			ctx = ctxns.WithNamespace(ctx, ns)
 
 			communities, files, err := b.Build(ctx)

internal/cli/ragindex_test.go

@@ -141,7 +141,7 @@ func TestRagIndexCmd_NamespaceFiltersDocIndex(t *testing.T) {
 		t.Fatalf("Execute() error: %v", err)
 	}
 
-	idx, err := ragindex.LoadIndex(filepath.Join(indexDir, "doc-index.json"))
+	idx, err := ragindex.LoadIndex(filepath.Join(indexDir, "backend", "doc-index.json"))
 	if err != nil {
 		t.Fatalf("loadIndex: %v", err)
 	}