feat: add ccg version command and --namespace global flag

- version subcommand with ldflags injection (version/commit/date)
- Makefile for build with automatic git tag injection
- --namespace PersistentFlag on root cmd (build/update/search)
- release workflow updated with version ldflags
- docs: CLI reference, README updated

Author: tae2089

.github/workflows/release.yml

@@ -56,7 +56,10 @@ jobs:
           GOARCH: ${{ matrix.goarch }}
           CGO_ENABLED: 1
         run: |
-          go build -tags "fts5" -ldflags "-s -w" -o ${{ matrix.artifact }} ./cmd/ccg/
+          VERSION=${GITHUB_REF#refs/tags/}
+          COMMIT=${GITHUB_SHA::7}
+          DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+          go build -tags "fts5" -ldflags "-s -w -X main.version=${VERSION} -X main.commit=${COMMIT} -X main.date=${DATE}" -o ${{ matrix.artifact }} ./cmd/ccg/
 
       - name: Install UPX (Linux)
         if: runner.os == 'Linux'

Makefile

@@ -0,0 +1,19 @@
+VERSION  ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo dev)
+COMMIT   ?= $(shell git rev-parse --short HEAD 2>/dev/null || echo unknown)
+DATE     ?= $(shell date -u +%Y-%m-%dT%H:%M:%SZ)
+PKG       = github.com/imtaebin/code-context-graph/cmd/ccg
+LDFLAGS   = -X main.version=$(VERSION) -X main.commit=$(COMMIT) -X main.date=$(DATE)
+
+.PHONY: build install test clean
+
+build:
+	CGO_ENABLED=1 go build -tags "fts5" -ldflags '$(LDFLAGS)' -o ccg ./cmd/ccg/
+
+install:
+	CGO_ENABLED=1 go install -tags "fts5" -ldflags '$(LDFLAGS)' ./cmd/ccg/
+
+test:
+	CGO_ENABLED=1 go test -tags "fts5" ./...
+
+clean:
+	rm -f ccg

README.md

@@ -33,6 +33,9 @@ go install github.com/tae2089/code-context-graph/cmd/ccg@latest
 
 ```bash
 CGO_ENABLED=1 go build -tags "fts5" -o ccg ./cmd/ccg/
+
+# Or use Makefile (injects version from git tag automatically)
+make build
 ```
 
 ## Quick Start
@@ -50,6 +53,13 @@ ccg search "결제"       # finds functions with @intent/@domainRule about payme
 
 # Graph statistics
 ccg status
+
+# Version info
+ccg version
+
+# Namespace isolation (MSA)
+ccg build ./backend --namespace backend
+ccg search --namespace backend "auth"
 ```
 
 ## MCP Server

cmd/ccg/main.go

@@ -53,6 +53,12 @@ var (
 	_ mcpserver.IncrementalSyncer = (*incremental.Syncer)(nil)
 )
 
+var (
+	version = "dev"
+	commit  = "unknown"
+	date    = "unknown"
+)
+
 // main wires CLI dependencies and executes the root command.
 // @intent 애플리케이션 시작 시 DB, 워커, MCP 실행 의존성을 구성해 CLI를 실행한다.
 // @sideEffect 시그널 핸들러를 등록하고 명령 실행 중 필요한 리소스를 초기화한다.
@@ -61,6 +67,11 @@ func main() {
 
 	deps := &cli.Deps{
 		Logger: logger,
+		Version: cli.VersionInfo{
+			Version: version,
+			Commit:  commit,
+			Date:    date,
+		},
 	}
 
 	deps.InitFunc = func(driver, dsn string) error {
@@ -158,7 +169,7 @@ func buildWalkers(logger *slog.Logger) map[string]*treesitter.Walker {
 		{treesitter.RustSpec, []string{".rs"}},
 		{treesitter.KotlinSpec, []string{".kt", ".kts"}},
 		{treesitter.PHPSpec, []string{".php"}},
-		{treesitter.LuaSpec, []string{".lua"}},
+		{treesitter.LuaSpec, []string{".lua", ".luau"}},
 	}
 
 	walkers := make(map[string]*treesitter.Walker)

guide/cli-reference.md

@@ -1,5 +1,32 @@
 # CLI Reference
 
+## Global Flags
+
+| Flag | Description |
+|------|-------------|
+| `--namespace <name>` | Namespace for data isolation (e.g. `--namespace backend`) |
+| `--db-driver <driver>` | Database driver: `sqlite`, `postgres` (default `sqlite`) |
+| `--db-dsn <dsn>` | Database connection string (default `ccg.db`) |
+| `--log-level <level>` | Log level: `debug`, `info`, `warn`, `error` (default `info`) |
+| `--log-json` | Output logs in JSON format |
+| `--config <path>` | Config file path (default: `.ccg.yaml` in `./` then `~/.config/ccg/`) |
+
+### Namespace
+
+MSA 환경에서 서비스별 코드 그래프를 하나의 DB에 격리 저장할 수 있습니다.
+
+```bash
+# 서비스별 빌드
+ccg build ./backend --namespace backend
+ccg build ./frontend --namespace frontend
+
+# 특정 namespace 내에서만 검색
+ccg search --namespace backend "auth"
+
+# 증분 업데이트도 namespace 적용
+ccg update ./backend --namespace backend
+```
+
 ## Commands
 
 | Command | Description |
@@ -23,6 +50,7 @@
 | `ccg hooks install --lint-strict` | Install hook that blocks commit on issues |
 | `ccg lint [--out dir]` | 8-category docs lint |
 | `ccg lint --strict` | Exit 1 on issues (for CI/pre-commit) |
+| `ccg version` | Print build version, commit, date |
 
 ### Serve
 

internal/cli/build.go

@@ -7,6 +7,7 @@ import (
 	"github.com/spf13/cobra"
 	"github.com/tae2089/trace"
 
+	"github.com/imtaebin/code-context-graph/internal/ctxns"
 	"github.com/imtaebin/code-context-graph/internal/service"
 )
 
@@ -45,6 +46,9 @@ func newBuildCmd(deps *Deps) *cobra.Command {
 			}
 
 			ctx := context.Background()
+			if ns, _ := cmd.Flags().GetString("namespace"); ns != "" {
+				ctx = ctxns.WithNamespace(ctx, ns)
+			}
 			stats, err := svc.Build(ctx, opts)
 			if err != nil {
 				return trace.Wrap(err, "build project")

internal/cli/build_test.go

@@ -191,6 +191,32 @@ func Beta() {}
 	_ = ctx
 }
 
+func TestBuildCommand_Namespace_StoresWithNamespace(t *testing.T) {
+	deps, stdout, stderr, db := setupBuildTest(t)
+
+	dir := t.TempDir()
+	writeGoFile(t, dir, "hello.go", `package hello
+func Hello() {}
+`)
+
+	err := executeCmd(deps, stdout, stderr, "build", "--namespace", "backend", dir)
+	if err != nil {
+		t.Fatalf("unexpected error: %v", err)
+	}
+
+	var nodes []model.Node
+	db.Where("namespace = ?", "backend").Find(&nodes)
+	if len(nodes) == 0 {
+		t.Fatal("expected nodes with namespace 'backend'")
+	}
+
+	for _, n := range nodes {
+		if n.Namespace != "backend" {
+			t.Errorf("expected namespace 'backend', got %q", n.Namespace)
+		}
+	}
+}
+
 func TestBuildCommand_NoRecursive_SkipsSubdirs(t *testing.T) {
 	deps, stdout, stderr, db := setupBuildTest(t)
 

internal/cli/root.go

@@ -33,6 +33,7 @@ type Deps struct {
 	ServeFunc     func(cfg ServeConfig) error
 	InitFunc      func(dbDriver, dsn string) error
 	CleanupFunc   func()
+	Version       VersionInfo
 }
 
 // NewRootCmd creates the root cobra command with all subcommands attached.
@@ -108,6 +109,7 @@ func NewRootCmd(deps *Deps) *cobra.Command {
 	// Global database configuration flags
 	rootCmd.PersistentFlags().String("db-driver", "sqlite", "Database driver (sqlite, postgres)")
 	rootCmd.PersistentFlags().String("db-dsn", "ccg.db", "Database connection string")
+	rootCmd.PersistentFlags().String("namespace", "", "Namespace for data isolation (e.g. --namespace backend)")
 
 	// Bind flags to viper
 	_ = viper.BindPFlag("db.driver", rootCmd.PersistentFlags().Lookup("db-driver"))
@@ -132,6 +134,7 @@ func NewRootCmd(deps *Deps) *cobra.Command {
 		newIndexCmd(deps),
 		newLintCmd(deps),
 		newRagIndexCmd(deps),
+		newVersionCmd(deps),
 	)
 
 	return rootCmd

internal/cli/search.go

@@ -7,6 +7,8 @@ import (
 
 	"github.com/spf13/cobra"
 	"github.com/tae2089/trace"
+
+	"github.com/imtaebin/code-context-graph/internal/ctxns"
 )
 
 // newSearchCmd creates the full-text search command.
@@ -24,6 +26,9 @@ func newSearchCmd(deps *Deps) *cobra.Command {
 		RunE: func(cmd *cobra.Command, args []string) error {
 			query := args[0]
 			ctx := context.Background()
+			if ns, _ := cmd.Flags().GetString("namespace"); ns != "" {
+				ctx = ctxns.WithNamespace(ctx, ns)
+			}
 
 			fetchLimit := limit
 			if pathPrefix != "" {

internal/cli/update.go

@@ -12,6 +12,7 @@ import (
 	"github.com/tae2089/trace"
 
 	"github.com/imtaebin/code-context-graph/internal/analysis/incremental"
+	"github.com/imtaebin/code-context-graph/internal/ctxns"
 	"github.com/imtaebin/code-context-graph/internal/pathutil"
 )
 
@@ -71,6 +72,9 @@ func newUpdateCmd(deps *Deps) *cobra.Command {
 			}
 
 			ctx := context.Background()
+			if ns, _ := cmd.Flags().GetString("namespace"); ns != "" {
+				ctx = ctxns.WithNamespace(ctx, ns)
+			}
 			stats, err := deps.Syncer.Sync(ctx, files)
 			if err != nil {
 				return trace.Wrap(err, "incremental sync")