refactor: remove Apache AGE, rename agestore → pgstore

- Remove AGE extension dependency and execute_cypher MCP tool
- Remove CLI query command (Cypher)
- Rename agestore → pgstore (plain PostgreSQL + pgvector)
- Docker: apache/age → pgvector/pgvector:pg16
- 18 MCP tools (back from 19, removed execute_cypher)

Architecture simplified:
  SQLite (local) — GORM + FTS5
  PostgreSQL (team) — GORM + tsvector + pgvector
  No graph DB needed — GORM + Go BFS handles all analysis

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: tae2089

docker-compose.yml

@@ -13,8 +13,8 @@ services:
       timeout: 5s
       retries: 10
 
-  age:
-    image: apache/age
+  pgvector:
+    image: pgvector/pgvector:pg16
     environment:
       POSTGRES_USER: ccg
       POSTGRES_PASSWORD: ccg

internal/cli/build.go

@@ -11,7 +11,7 @@ import (
 
 	"github.com/imtaebin/code-context-graph/internal/model"
 	"github.com/imtaebin/code-context-graph/internal/parse"
-	"github.com/imtaebin/code-context-graph/internal/store/agestore"
+	"github.com/imtaebin/code-context-graph/internal/store/pgstore"
 )
 
 var skipDirs = map[string]bool{
@@ -175,30 +175,30 @@ func newBuildCmd(deps *Deps) *cobra.Command {
 			}
 
 			// Sync to Apache AGE graph + pgvector if --graph flag is set
-			if syncGraph && deps.AgeStore != nil {
+			if syncGraph && deps.PGStore != nil {
 				deps.Logger.Info("syncing to AGE graph")
-				if err := deps.AgeStore.ClearGraph(ctx); err != nil {
+				if err := deps.PGStore.ClearGraph(ctx); err != nil {
 					deps.Logger.Warn("clear graph failed", "error", err)
 				}
-				if err := deps.AgeStore.SyncNodes(ctx, indexNodes); err != nil {
+				if err := deps.PGStore.SyncNodes(ctx, indexNodes); err != nil {
 					deps.Logger.Warn("sync nodes to AGE failed", "error", err)
 				} else {
 					var edges []model.Edge
 					deps.DB.Find(&edges)
-					if err := deps.AgeStore.SyncEdges(ctx, edges); err != nil {
+					if err := deps.PGStore.SyncEdges(ctx, edges); err != nil {
 						deps.Logger.Warn("sync edges to AGE failed", "error", err)
 					} else {
 						deps.Logger.Info("AGE graph synced", "nodes", len(indexNodes), "edges", len(edges))
 					}
 				}
 
 				// Sync pgvector documents for semantic search
-				if err := deps.AgeStore.InitPGVector(ctx); err != nil {
+				if err := deps.PGStore.InitPGVector(ctx); err != nil {
 					deps.Logger.Warn("pgvector init failed", "error", err)
 				} else {
-					var pvDocs []agestore.PGVectorDocument
+					var pvDocs []pgstore.PGVectorDocument
 					for _, n := range indexNodes {
-						pvDocs = append(pvDocs, agestore.PGVectorDocument{
+						pvDocs = append(pvDocs, pgstore.PGVectorDocument{
 							NodeID:  n.ID,
 							Content: buildContent(n),
 							Metadata: map[string]string{
@@ -209,7 +209,7 @@ func newBuildCmd(deps *Deps) *cobra.Command {
 							},
 						})
 					}
-					if err := deps.AgeStore.SyncPGVectorDocuments(ctx, pvDocs); err != nil {
+					if err := deps.PGStore.SyncPGVectorDocuments(ctx, pvDocs); err != nil {
 						deps.Logger.Warn("pgvector sync failed", "error", err)
 					} else {
 						deps.Logger.Info("pgvector documents synced", "documents", len(pvDocs))

internal/cli/query.go

@@ -9,7 +9,7 @@ import (
 	"gorm.io/gorm"
 
 	"github.com/imtaebin/code-context-graph/internal/analysis/incremental"
-	"github.com/imtaebin/code-context-graph/internal/store/agestore"
+	"github.com/imtaebin/code-context-graph/internal/store/pgstore"
 	"github.com/imtaebin/code-context-graph/internal/parse/treesitter"
 	"github.com/imtaebin/code-context-graph/internal/store"
 	"github.com/imtaebin/code-context-graph/internal/store/search"
@@ -24,7 +24,7 @@ type Deps struct {
 	Walkers       map[string]*treesitter.Walker
 	Syncer        *incremental.Syncer
 	ServeFunc     func(cfg ServeConfig) error
-	AgeStore      *agestore.Store
+	PGStore       *pgstore.Store
 }
 
 // NewRootCmd creates the root cobra command with all subcommands attached.
@@ -72,7 +72,6 @@ func NewRootCmd(deps *Deps) *cobra.Command {
 		newStatusCmd(deps),
 		newSearchCmd(deps),
 		newServeCmd(deps),
-		newQueryCmd(deps),
 	)
 
 	return rootCmd

internal/cli/root.go

@@ -1109,26 +1109,3 @@ func getBool(request mcp.CallToolRequest, name string, defaultVal bool) bool {
 	}
 	return defaultVal
 }
-
-func (h *handlers) executeCypher(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
-	log := h.logger()
-
-	cypher, err := request.RequireString("cypher")
-	if err != nil {
-		return mcp.NewToolResultError(fmt.Sprintf("missing parameter: %v", err)), nil
-	}
-	columns := request.GetInt("columns", 1)
-
-	log.Info("execute_cypher called", "cypher", cypher, "columns", columns)
-
-	if h.deps.AgeStore == nil {
-		return mcp.NewToolResultError("Apache AGE not configured — start with AGE_DSN environment variable"), nil
-	}
-
-	result, err := h.deps.AgeStore.ExecuteCypherJSON(ctx, cypher, columns)
-	if err != nil {
-		return mcp.NewToolResultError(fmt.Sprintf("cypher error: %v", err)), nil
-	}
-
-	return mcp.NewToolResultText(result), nil
-}

internal/mcp/handlers.go

@@ -19,7 +19,6 @@ import (
 	"github.com/imtaebin/code-context-graph/internal/analysis/query"
 	"github.com/imtaebin/code-context-graph/internal/model"
 	"github.com/imtaebin/code-context-graph/internal/store"
-	"github.com/imtaebin/code-context-graph/internal/store/agestore"
 	storesearch "github.com/imtaebin/code-context-graph/internal/store/search"
 )
 
@@ -89,7 +88,6 @@ type Deps struct {
 	CoverageAnalyzer  CoverageAnalyzer
 	CommunityBuilder  CommunityBuilder
 	Incremental       IncrementalSyncer
-	AgeStore          *agestore.Store
 }
 
 func NewServer(deps *Deps) *server.MCPServer {
@@ -246,16 +244,9 @@ func NewServer(deps *Deps) *server.MCPServer {
 			),
 			Handler: h.findDeadCode,
 		},
-		server.ServerTool{
-			Tool: mcp.NewTool("execute_cypher",
-				mcp.WithDescription("Execute a Cypher query on the Apache AGE code graph. Use this for custom graph traversals, path finding, pattern matching, and impact analysis."),
-				mcp.WithString("cypher", mcp.Description("Cypher query string (e.g. MATCH (n:Function)-[:CALLS]->(m) RETURN n, m)"), mcp.Required()),
-			),
-			Handler: h.executeCypher,
-		},
 	)
 
-	log.Info("MCP server created", "name", "code-context-graph", "version", "1.0.0", "tools", 19, "prompts", 5)
+	log.Info("MCP server created", "name", "code-context-graph", "version", "1.0.0", "tools", 18, "prompts", 5)
 
 	p := &promptHandlers{deps: deps}
 	srv.AddPrompts(

internal/mcp/server.go

@@ -30,7 +30,6 @@ func TestMCPServer_ListTools(t *testing.T) {
 		"get_community",
 		"get_architecture_overview",
 		"find_dead_code",
-		"execute_cypher",
 	}
 
 	if len(tools) != len(expected) {
@@ -55,13 +54,13 @@ func TestMCPServer_Start(t *testing.T) {
 	var _ *server.MCPServer = srv
 }
 
-func TestMCPServer_ListTools_19(t *testing.T) {
+func TestMCPServer_ListTools_18(t *testing.T) {
 	deps := &Deps{}
 	srv := NewServer(deps)
 	tools := srv.ListTools()
 
-	if len(tools) != 19 {
-		t.Fatalf("expected 19 tools, got %d", len(tools))
+	if len(tools) != 18 {
+		t.Fatalf("expected 18 tools, got %d", len(tools))
 	}
 }