context-mcp-server 1.0.7 → 1.1.0

package/README.md

@@ -25,8 +25,8 @@ This gets worse as projects grow — reading 20 files to answer "what calls this
 
 ## What It Solves
 
-- **Persistent memory** — decisions, bugs, notes, and architecture saved across sessions, loaded automatically at conversation start
-- **Shared store** — `~/.context-mcp/` is one place on your machine; all AI tools read and write it
+- **Persistent memory** — decisions, bugs, notes, and config saved across sessions, loaded automatically at conversation start
+- **Shared store** — `~/.context-mcp/projects/<name>/` per-project on your machine; all AI tools read and write it
 - **ContextGraph** — build a knowledge graph of your codebase once, answer structural questions in ~500 tokens instead of ~50,000
 
 Real measured reduction on this project: **162× fewer tokens**, **99.38% reduction** per conversation.
@@ -95,10 +95,10 @@ ctx online --port 3200   # different port
 Both `ctx` and `context` are aliases for the same CLI.
 
 ```bash
-ctx                            # interactive mode (UI — no "ctx" prefix inside)
+ctx                            # interactive mode (UI)
 
 # Context
-ctx list [project]             # list entries, discussions, graphs
+ctx list [project]             # list entries by tree: graph / context / summary / plans
 ctx projects                   # all projects with graph status + recent entries
 ctx search "query"             # keyword → semantic fallback search
 ctx add                        # add entry interactively
@@ -115,7 +115,6 @@ ctx settings                   # view and edit config interactively
 
 # Tools
 ctx benchmark                  # token savings report (memory + graph)
-ctx discuss [project]          # view discussions
 ```
 
 ---
@@ -136,12 +135,12 @@ Any file or git operation outside that directory is rejected. Applies to all HTT
 
 ### Memory
 
-- `context.resume` — loads recent entries, discussions, and graph status; registers `rootPath` for sandboxing
-- `context.save` — store decisions, bugs, notes, architecture with type tags
-- `context.get` / `context.update` / `context.delete` — full CRUD
+- `context.resume` — loads recent entries, active plans, and graph status; registers `rootPath` for sandboxing
+- `context.save` — store context with 4 types: `decision`, `bug`, `note`, `config`
+- `context.get` / `context.update` / `context.delete` — full CRUD, single or batch
 - `search` — keyword-first, semantic fallback
-- `discussion` — threaded plans with steps and cross-session continuity
-- Auto-deduplication on save; auto-compact at 20 entries
+- `plan` — auto-triggered when AI makes any plan; saves a markdown summary to a `planDir` you specify
+- Auto-deduplication on save; auto-compact at 20 entries → stored in `summary.json`
 
 ### ContextGraph
 
@@ -153,7 +152,7 @@ Any file or git operation outside that directory is rejected. Applies to all HTT
 codegraph_build(path)
 ```
 
-Parses codebase via tree-sitter AST (16 languages, regex fallback). Extracts functions, classes, imports, call edges. Saved to `~/.context-mcp/`.
+Parses codebase via tree-sitter AST (16 languages, regex fallback). Extracts functions, classes, imports, call edges. Build metadata saved to `~/.context-mcp/projects/<name>/graph.json`.
 
 **Step 2 — Query** (instant, forever):
 

package/codegraph/graph/query.py

@@ -237,6 +237,49 @@ def _general_search(matched: list, nodes: list, edges: list) -> dict:
     }
 
 
+def module_map(graph_dict: dict, limit: int = 100) -> dict:
+    """
+    Return a module map: for each file, its exported functions/classes and what it imports.
+    Output grouped by file, sorted by export count descending.
+    """
+    nodes = graph_dict.get("nodes", [])
+    edges = graph_dict.get("edges", [])
+
+    files: dict[str, dict] = {}
+    for n in nodes:
+        f = n.get("file") or "unknown"
+        if f not in files:
+            files[f] = {"exports": [], "imports": set()}
+        node_type = n.get("type", "?")
+        if node_type in ("function", "class", "struct"):
+            files[f]["exports"].append({"name": n["name"], "type": node_type})
+
+    node_map = {n["id"]: n for n in nodes}
+    for e in edges:
+        from_node = node_map.get(e.get("from", ""))
+        to_node   = node_map.get(e.get("to", ""))
+        if not from_node or not to_node:
+            continue
+        from_file = from_node.get("file") or "unknown"
+        to_file   = to_node.get("file") or "unknown"
+        if from_file != to_file and from_file in files:
+            files[from_file]["imports"].add(to_file)
+
+    result = []
+    for fpath, data in sorted(files.items(), key=lambda x: -len(x[1]["exports"])):
+        result.append({
+            "file":    fpath,
+            "exports": data["exports"][:30],
+            "imports": sorted(data["imports"])[:20],
+        })
+
+    return {
+        "files":       result[:limit],
+        "total_files": len(files),
+        "truncated":   len(files) > limit,
+    }
+
+
 def _render_subgraph(result_nodes: list, all_edges: list, token_budget: int) -> str:
     """
     Render a subgraph as structured plain text (graphify-style).

package/codegraph/server.py

@@ -4,10 +4,10 @@ codegraph/server.py — MCP server exposing codebase knowledge graph tools.
 
 Tools:
   codegraph_build   — scan project, extract AST nodes, build graph (local only, no API)
-  codegraph_query   — structural question OR single-node lookup (or both); replaces codegraph_explain
+  codegraph_query   — structural question OR single-node lookup (or both)
+  codegraph_arch    — module map: every file with its exports and imports
   codegraph_report  — return full CODEGRAPH_REPORT.md
   codegraph_nodes   — list nodes of a given type
-  codegraph_path    — shortest path between two concepts
 """
 
 import asyncio
@@ -25,7 +25,7 @@ from .config import classify_file
 from .cache import file_hash, set_cached_nodes, save_cache
 from .extractors.ast_extractor import extract as ast_extract
 from .graph.builder import build, to_json_dict, save_graph, load_graph
-from .graph.query import answer as graph_answer, find_path
+from .graph.query import answer as graph_answer, module_map
 from .graph.clustering import detect_communities
 from .report import generate as generate_report
 
@@ -95,16 +95,19 @@ TOOLS = [
         },
     ),
     Tool(
-        name="codegraph_path",
-        description="Find the shortest relationship path between two concepts in the graph.",
+        name="codegraph_arch",
+        description=(
+            "Return a module map: every file with its exported functions/classes and what it imports. "
+            "Use this to understand project structure without reading any files. "
+            "Call after codegraph_build. Much faster than reading each file."
+        ),
         inputSchema={
             "type": "object",
             "properties": {
-                "path": {"type": "string"},
-                "from": {"type": "string"},
-                "to":   {"type": "string"},
+                "path":  {"type": "string", "description": "Project root"},
+                "limit": {"type": "integer", "description": "Max files in output (default 100)"},
             },
-            "required": ["path", "from", "to"],
+            "required": ["path"],
         },
     ),
 ]
@@ -125,12 +128,11 @@ async def call_tool(name: str, arguments: dict):
 
 
 async def _dispatch(name: str, args: dict):
-    if name == "codegraph_build":   return await _build(args)
-    if name == "codegraph_query":   return await _query(args)
-    if name == "codegraph_explain": return await _query(args)
-    if name == "codegraph_report":  return await _report(args)
-    if name == "codegraph_nodes":   return await _nodes(args)
-    if name == "codegraph_path":    return await _path(args)
+    if name == "codegraph_build":  return await _build(args)
+    if name == "codegraph_query":  return await _query(args)
+    if name == "codegraph_report": return await _report(args)
+    if name == "codegraph_nodes":  return await _nodes(args)
+    if name == "codegraph_arch":   return await _arch(args)
     raise ValueError(f"Unknown tool: {name}")
 
 
@@ -285,11 +287,12 @@ async def _nodes(args: dict) -> dict:
     return {"type": node_type, "count": len(matched), "nodes": matched[:limit]}
 
 
-async def _path(args: dict) -> dict:
+async def _arch(args: dict) -> dict:
     graph_dict = load_graph(args["path"])
     if not graph_dict:
         raise ValueError("No graph found. Run codegraph_build first.")
-    return find_path(args["from"], args["to"], graph_dict)
+    limit = args.get("limit", 100)
+    return module_map(graph_dict, limit=limit)
 
 
 # ── Entry point ───────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mcp-server",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "Persistent AI memory + codebase knowledge graph MCP server. Works across Claude Code, Cursor, Gemini CLI, Codex, Windsurf, VS Code Copilot, Claude.ai, and ChatGPT.",
   "type": "module",
   "bin": {
@@ -14,7 +14,7 @@
     "mcp": "node src/index.js",
     "mcp-server": "node src/http.js",
     "cli": "node src/cli.js",
-    "check": "node --check src/index.js && node --check src/server.js && node --check src/db.js && node --check src/vector.js && node --check src/summarizer.js && node --check src/search.js && node --check src/config.js && node --check src/cli.js && node --check src/http.js && node --check src/tools/context.js && node --check src/tools/search.js && node --check src/tools/discussion.js && node --check src/tools/errorCheck.js && node --check src/tools/fileTools.js && node --check src/tools/gitTools.js && node --check src/tools/codegraph.js && node --check src/hooks/autoLink.js && node --check src/hooks/autoContext.js",
+    "check": "node --check src/index.js && node --check src/server.js && node --check src/db.js && node --check src/vector.js && node --check src/summarizer.js && node --check src/search.js && node --check src/config.js && node --check src/cli.js && node --check src/http.js && node --check src/tools/context.js && node --check src/tools/search.js && node --check src/tools/plan.js &&node --check src/tools/errorCheck.js && node --check src/tools/fileTools.js && node --check src/tools/gitTools.js && node --check src/tools/codegraph.js && node --check src/hooks/autoLink.js && node --check src/hooks/autoContext.js",
     "check-mcp": "npm run check",
     "test": "node --test",
     "prepublishOnly": "npm run check"

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codegraph-mcp"
-version = "1.0.7"
+version = "1.1.0"
 description = "Codebase knowledge graph MCP server — AST extraction, graph queries, community detection"
 readme = "README.md"
 requires-python = ">=3.11"