fix: honor config-file namespace over flag default in CLI commands

Add resolveNamespace() so a namespace set only in .ccg.yaml is not masked
by the --namespace flag's default value. Priority: explicit --namespace
flag > config namespace > default. Applied across build, docs, lint,
search, status, and update commands, with tests for search and status.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: tae2089

.ccg.yaml

@@ -3,7 +3,7 @@ db:
   driver: postgres
   dsn: "host=localhost user=postgres password=postgres dbname=ccg_test sslmode=disable"
 
-namespace: default
+namespace: ccg
 
 output:
   dir: ./docs

internal/adapters/inbound/cli/build.go

@@ -56,7 +56,7 @@ func newBuildCmd(deps *Deps) *cobra.Command {
 			}
 
 			ctx := context.Background()
-			ns, _ := cmd.Flags().GetString("namespace")
+			ns := resolveNamespace(cmd)
 			ctx = requestctx.WithNamespace(ctx, ns)
 			stats, err := svc.Build(ctx, opts)
 			if err != nil {

internal/adapters/inbound/cli/docs.go

@@ -45,7 +45,7 @@ func newDocsCmd(deps *Deps) *cobra.Command {
 				Files:      contentfiles.NewRoot(absOut),
 				OutDir:     absOut,
 				Exclude:    resolveExcludes(excludePatterns),
-				Namespace:  viper.GetString("namespace"),
+				Namespace:  resolveNamespace(cmd),
 				Prune:      prune,
 			}
 
@@ -58,7 +58,7 @@ func newDocsCmd(deps *Deps) *cobra.Command {
 				OutDir:      absOut,
 				IndexDir:    resolveRagIndexDir(ragIndexDir),
 				ProjectDesc: resolveRagDescription(projectDesc),
-				Namespace:   viper.GetString("namespace"),
+				Namespace:   resolveNamespace(cmd),
 				Exclude:     resolveExcludes(excludePatterns),
 			})
 			if err != nil {

internal/adapters/inbound/cli/lint.go

@@ -443,7 +443,7 @@ func newLintCmd(deps *Deps) *cobra.Command {
 				Files:      contentfiles.NewRoot(absOut),
 				OutDir:     absOut,
 				Exclude:    resolveExcludes(excludePatterns),
-				Namespace:  viper.GetString("namespace"),
+				Namespace:  resolveNamespace(cmd),
 			}
 
 			report, err := gen.Lint()

internal/adapters/inbound/cli/root.go

@@ -200,6 +200,21 @@ func resolveOutDir(flagValue string) string {
 	return flagValue
 }
 
+// resolveNamespace returns the effective namespace for a command, reading through
+// viper instead of cmd.Flags() so a namespace set only in the config file is not
+// masked by the --namespace flag's default value.
+// @intent config의 namespace 설정이 --namespace 플래그 기본값에 가려지지 않도록 우선순위대로 해석한다.
+// @ensures 우선순위는 명시적 --namespace 플래그 > CCG_NAMESPACE 환경변수 > config namespace > 기본값(default) 순이다.
+func resolveNamespace(cmd *cobra.Command) string {
+	if flag := cmd.Flags().Lookup("namespace"); flag != nil && flag.Changed {
+		return flag.Value.String()
+	}
+	if ns := viper.GetString("namespace"); ns != "" {
+		return ns
+	}
+	return requestctx.DefaultNamespace
+}
+
 // resolveExcludes merges exclude patterns from the config file (viper "exclude"
 // key) and the command-line flag, deduplicating nothing — order is config first,
 // then flags.

internal/adapters/inbound/cli/search.go

@@ -29,7 +29,7 @@ func newSearchCmd(deps *Deps) *cobra.Command {
 				return fmt.Errorf("limit must be > 0, got %d", limit)
 			}
 			ctx := cmd.Context()
-			ns, _ := cmd.Flags().GetString("namespace")
+			ns := resolveNamespace(cmd)
 			ctx = requestctx.WithNamespace(ctx, ns)
 
 			// Over-fetch a wider candidate pool so structural reranking can

internal/adapters/inbound/cli/search_test.go

@@ -7,6 +7,7 @@ import (
 	"strings"
 	"testing"
 
+	"github.com/spf13/viper"
 	"gorm.io/driver/sqlite"
 	"gorm.io/gorm"
 	gormlogger "gorm.io/gorm/logger"
@@ -280,6 +281,52 @@ func TestSearchCommand_RejectsNonPositiveLimit(t *testing.T) {
 	}
 }
 
+func TestSearchCommand_NamespaceFromConfig(t *testing.T) {
+	viper.Reset()
+	defer viper.Reset()
+
+	deps, stdout, stderr, _ := setupSearchTest(t)
+
+	var gotNS string
+	deps.SearchReader = &spySearchBackend{queryFn: func(ctx context.Context, query string, queryLimit int) ([]graph.Node, error) {
+		gotNS = requestctx.FromContext(ctx)
+		return nil, nil
+	}}
+
+	// Config selects namespace=backend; no --namespace flag is passed.
+	viper.Set("namespace", "backend")
+
+	if err := executeCmd(deps, stdout, stderr, "search", "hello"); err != nil {
+		t.Fatalf("search: %v", err)
+	}
+	if gotNS != "backend" {
+		t.Fatalf("expected config namespace 'backend', got %q", gotNS)
+	}
+}
+
+func TestSearchCommand_FlagOverridesConfigNamespace(t *testing.T) {
+	viper.Reset()
+	defer viper.Reset()
+
+	deps, stdout, stderr, _ := setupSearchTest(t)
+
+	var gotNS string
+	deps.SearchReader = &spySearchBackend{queryFn: func(ctx context.Context, query string, queryLimit int) ([]graph.Node, error) {
+		gotNS = requestctx.FromContext(ctx)
+		return nil, nil
+	}}
+
+	// Explicit --namespace must win over the config value.
+	viper.Set("namespace", "backend")
+
+	if err := executeCmd(deps, stdout, stderr, "--namespace", "frontend", "search", "hello"); err != nil {
+		t.Fatalf("search: %v", err)
+	}
+	if gotNS != "frontend" {
+		t.Fatalf("expected flag namespace 'frontend' to override config, got %q", gotNS)
+	}
+}
+
 func TestSearchCommand_UsesCommandContext(t *testing.T) {
 	deps, stdout, stderr, _ := setupSearchTest(t)
 	ctx, cancel := context.WithCancel(context.Background())

internal/adapters/inbound/cli/status.go

@@ -27,7 +27,7 @@ func newStatusCmd(deps *Deps) *cobra.Command {
 				return errDBNotInitialized
 			}
 
-			ns, _ := cmd.Flags().GetString("namespace")
+			ns := resolveNamespace(cmd)
 			ctx := requestctx.WithNamespace(cmd.Context(), ns)
 			stats, err := deps.Statistics.GraphStatistics(ctx)
 			if err != nil {

internal/adapters/inbound/cli/status_test.go

@@ -5,6 +5,7 @@ import (
 	"strings"
 	"testing"
 
+	"github.com/spf13/viper"
 	"gorm.io/driver/sqlite"
 	"gorm.io/gorm"
 	gormlogger "gorm.io/gorm/logger"
@@ -322,3 +323,37 @@ func TestStatusCommand_RespectsNamespace(t *testing.T) {
 		t.Fatalf("unexpected cross-namespace aggregation: %s", out)
 	}
 }
+
+func TestStatusCommand_NamespaceFromConfig(t *testing.T) {
+	viper.Reset()
+	defer viper.Reset()
+
+	deps, stdout, stderr, db := setupStatusTest(t)
+
+	// One node in the default namespace, two in "backend".
+	if err := db.Create(&graph.Node{Namespace: requestctx.DefaultNamespace, QualifiedName: "default.Foo", Kind: graph.NodeKindFunction, Name: "Foo", FilePath: "default/foo.go", StartLine: 1, EndLine: 2, Language: "go"}).Error; err != nil {
+		t.Fatal(err)
+	}
+	if err := db.Create(&graph.Node{Namespace: "backend", QualifiedName: "backend.Bar", Kind: graph.NodeKindFunction, Name: "Bar", FilePath: "backend/bar.go", StartLine: 1, EndLine: 2, Language: "go"}).Error; err != nil {
+		t.Fatal(err)
+	}
+	if err := db.Create(&graph.Node{Namespace: "backend", QualifiedName: "backend.Baz", Kind: graph.NodeKindFunction, Name: "Baz", FilePath: "backend/baz.go", StartLine: 1, EndLine: 2, Language: "go"}).Error; err != nil {
+		t.Fatal(err)
+	}
+
+	// Config selects namespace=backend; no --namespace flag is passed, so the
+	// config value must win over the flag's default.
+	viper.Set("namespace", "backend")
+
+	stdout.Reset()
+	stderr.Reset()
+
+	if err := executeCmd(deps, stdout, stderr, "status"); err != nil {
+		t.Fatalf("status: %v", err)
+	}
+
+	out := stdout.String()
+	if !strings.Contains(out, "Nodes: 2") {
+		t.Fatalf("expected config namespace 'backend' (2 nodes), got: %s", out)
+	}
+}

internal/adapters/inbound/cli/update.go

@@ -37,7 +37,7 @@ func newUpdateCmd(deps *Deps) *cobra.Command {
 			fileLimit := resolveMaxFileBytes(maxFileBytes)
 			totalLimit := resolveMaxTotalParsedBytes(maxTotalParsedBytes)
 			ctx := cmd.Context()
-			ns, _ := cmd.Flags().GetString("namespace")
+			ns := resolveNamespace(cmd)
 			ctx = requestctx.WithNamespace(ctx, ns)
 
 			svc := &workflow.Service{