context-mcp-server 1.0.5 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mcp-server",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "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": {

package/pyproject.toml

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

package/src/cli.js

@@ -186,7 +186,7 @@ function cmdList(args) {
 
   for (const projectName of projectNames) {
     const pData     = projects[projectName];
-    const graph     = allGraphs.find(g => g.path?.toLowerCase().includes(projectName.toLowerCase()));
+    const graph     = _graphForProject(allGraphs, projectName);
     const activeD   = pData.discussions.filter(d => d.status === 'active').length;
     const totalSecs = (pData.contexts.length > 0 ? 1 : 0) + (pData.discussions.length > 0 ? 1 : 0) + (graph ? 1 : 0);
     let   secIdx    = 0;
@@ -240,7 +240,7 @@ function cmdList(args) {
   }
 
   // Orphan graphs (no matching project)
-  const orphanGraphs = allGraphs.filter(g => !projectNames.some(p => g.path?.toLowerCase().includes(p.toLowerCase())));
+  const orphanGraphs = allGraphs.filter(g => !projectNames.some(p => _graphForProject([g], p)));
   if (orphanGraphs.length) {
     console.log(`\n  ${color(C.dblue, '◇')} ${muted('other graphs')}`);
     for (const g of orphanGraphs) {
@@ -292,7 +292,7 @@ function cmdProjects() {
     const entries   = getContext({ project: project.name, limit: 3, compact: true }).filter(e => e.status !== 'archived');
     const discs     = allDiscs.filter(d => (d.project || 'global') === project.name);
     const activeD   = discs.filter(d => d.status === 'active');
-    const graph     = graphs.find(g => g.path?.toLowerCase().includes(project.name.toLowerCase()));
+    const graph     = _graphForProject(graphs, project.name);
 
     const barLen = Math.min(Math.ceil(project.count / 2), 24);
     const bar    = color(C.dblue, '█'.repeat(barLen)) + color(C.darkgray, '░'.repeat(24 - barLen));
@@ -567,6 +567,30 @@ const _GLOBAL_GITIGNORE_ENTRIES = [
   '.mcp.json',
 ];
 
+// Match a graph to a project by exact last-path-component comparison (not substring)
+function _graphForProject(graphs, projectName) {
+  const norm = p => (p || '').toLowerCase().replace(/\\/g, '/').replace(/\/$/, '');
+  const name = projectName.toLowerCase();
+  return graphs.find(g => norm(g.path).split('/').pop() === name) || null;
+}
+
+const _PROJECT_GITIGNORE_ENTRIES = [
+  '.claude/', '.cursor/', '.vscode/', '.gemini/', '.codex/',
+  'codegraph-cache/', '.mcp.json', 'CLAUDE.md', 'GEMINI.md', 'AGENTS.md',
+];
+
+function _updateProjectGitignore(projectDir) {
+  const giPath = join(projectDir, '.gitignore');
+  const existing = existsSync(giPath) ? readFileSync(giPath, 'utf8') : '';
+  const lines = existing.split(/\r?\n/);
+  const missing = _PROJECT_GITIGNORE_ENTRIES.filter(e => !lines.includes(e));
+  if (!missing.length) return;
+  const block = '\n# context-mcp — written by ctx install\n' + missing.join('\n') + '\n';
+  writeFileSync(giPath, (existing ? existing.trimEnd() : '') + block, 'utf8');
+  console.log(`  ${ok('✓')} ${'project .gitignore'.padEnd(28)} ${faint(giPath.replace(/\\/g, '/'))}`);
+  for (const e of missing) console.log(`      ${faint('+ ' + e)}`);
+}
+
 function _updateGlobalGitignore() {
   // Resolve global gitignore path: git config > ~/.gitignore_global > ~/.gitignore
   let giPath = null;
@@ -829,6 +853,9 @@ async function cmdInstall(args) {
   console.log(faint(`  ${keys.length} platform(s) installed  ·  scope: ${scope}  ·  ${destLabel}`));
   console.log('');
 
+  // ── Project .gitignore — add context-mcp entries for this project ──────────
+  _updateProjectGitignore(process.cwd());
+
   // ── Global gitignore — add context-mcp runtime files if global gitignore exists ──
   _updateGlobalGitignore();
   console.log('');

package/src/db.js

@@ -23,6 +23,11 @@ const PROJECTS_PATH     = join(DATA_DIR, 'projects.json');
 
 const MAX_CONTENT_LENGTH = 5000;
 const PREVIEW_LENGTH = 200;
+
+// Normalize file paths for cross-platform comparison (Windows case + slash variants)
+function normPath(p) {
+  return p ? p.toLowerCase().replace(/\\/g, '/').replace(/\/$/, '') : '';
+}
 const WRITE_DEBOUNCE_MS = 500;
 const LOCK_WAIT_TIMEOUT_MS = 2000;
 
@@ -126,9 +131,9 @@ function mergeStore(latest, local) {
     if (_changedDiscussionNames.has(disc.name)) discussionsByName.set(disc.name, disc);
   }
 
-  const graphsByPath = new Map((latest.graphs || []).map(g => [g.path, g]));
+  const graphsByPath = new Map((latest.graphs || []).map(g => [normPath(g.path), g]));
   for (const graph of (local.graphs || [])) {
-    if (_changedGraphPaths.has(graph.path)) graphsByPath.set(graph.path, graph);
+    if (_changedGraphPaths.has(graph.path)) graphsByPath.set(normPath(graph.path), graph);
   }
 
   const projectsById = new Map((latest.projects || []).map(p => [p.id, p]));
@@ -713,7 +718,7 @@ export function flushStore() { flushToDisk(); }
 
 // ── Auto-compaction ───────────────────────────────────────────────────────────
 
-const COMPACTION_THRESHOLD = 50;
+const COMPACTION_THRESHOLD = 20;
 const COMPACTION_TARGET = 30;
 
 export function shouldCompact(project) {
@@ -753,7 +758,14 @@ export function compactProject(project, summaryContent) {
 export function saveGraph({ path, nodes, edges, communities, cached, changed, time_ms, summary }) {
   refreshFromDisk();
   const store = load();
-  const existing = store.graphs.find(g => g.path === path);
+  // Deduplicate: collapse any case/slash variants of same path, keep newest
+  const dupes = store.graphs.filter(g => normPath(g.path) === normPath(path));
+  if (dupes.length > 1) {
+    const keep = dupes.reduce((a, b) => (a.builtAt >= b.builtAt ? a : b));
+    store.graphs = store.graphs.filter(g => normPath(g.path) !== normPath(path));
+    store.graphs.push(keep);
+  }
+  const existing = store.graphs.find(g => normPath(g.path) === normPath(path));
   const record = {
     path,
     nodes:       nodes       ?? existing?.nodes       ?? 0,
@@ -777,7 +789,7 @@ export function saveGraph({ path, nodes, edges, communities, cached, changed, ti
 
 export function getGraph(path) {
   const store = load();
-  if (path) return store.graphs.find(g => g.path === path) || null;
+  if (path) return store.graphs.find(g => normPath(g.path) === normPath(path)) || null;
   return store.graphs;
 }
 

package/src/hooks/autoContext.js

@@ -3,7 +3,7 @@ import { fireAutoLink } from './autoLink.js';
 
 export function saveAutoContext({ title, content, type, files, state, tags = [] }) {
   const entry = saveContext({
-    project:   state.sessionProject || 'global',
+    project:   state.sessionProject || null,
     sessionId: state.sessionId || null,
     title,
     content,

package/src/templates/CLAUDE.md

@@ -15,7 +15,12 @@ Every conversation starts with `context.resume`. Every codebase question uses `c
 
 ## 1. Start of Every Conversation (MANDATORY)
 
-Call `context` tool, `action: "resume"`, `project: "<project-name>"` **before anything else**.
+Call `context` tool **before anything else** with:
+- `action: "resume"`
+- `project: "<basename of git repo root dir>"` — infer from cwd if not stated
+- `rootPath: "<absolute path to git repo root>"` — required for sandbox + graph lookup
+
+Both fields are required: `project` names the memory bucket, `rootPath` enables exact graph matching and file sandboxing.
 
 Returns:
 - `recentEntries` — decisions, bugs, notes from previous conversations
@@ -34,7 +39,7 @@ Then:
 
 **After graph build or rebuild** — every time `codegraph_build` completes:
 ```
-context.save  type: "architecture"  title: "ContextGraph built — <project>"
+context.save  project: "<project>"  type: "architecture"  title: "ContextGraph built — <project>"
 content: "nodes: X | edges: Y | communities: Z"
 ```
 
@@ -59,7 +64,7 @@ Do NOT save: routine reads, search results, temporary debugging dead-ends.
 
 Feature spans multiple sessions → `discussion.create` or `discussion.update`.
 Need past info → `search` before asking user.
-Always pass `project`. Auto-compact fires at >50 entries.
+Always pass `project`. Auto-compact fires at >20 entries.
 
 ---
 

package/src/templates/commands/context-resume.md

@@ -1,4 +1,6 @@
-Call the `context` MCP tool with `action: "resume"` and `project: "$ARGUMENTS"` (if no argument given, infer the project name from the current working directory name).
+Call the `context` MCP tool with `action: "resume"`, `project: "$ARGUMENTS"` (if no argument given, infer the project name from the current working directory name), and `rootPath: "<absolute path to the project root / git repo root>"`.
+
+Both `project` and `rootPath` are required: `project` names the memory bucket, `rootPath` enables exact graph lookup and file sandboxing.
 
 This loads:
 - Recent decisions, bugs, and notes from past sessions

package/src/templates/skills/SKILL.md

@@ -18,9 +18,12 @@ Persistent memory + codebase knowledge graph across every conversation.
 
 ## MANDATORY: Start of Every Conversation
 
-Call `context` tool, `action: "resume"`, `project: "<project-name>"` **before any tool or response**.
+Call `context` tool **before any tool or response** with:
+- `action: "resume"`
+- `project: "<basename of git repo root dir>"` — infer from `cwd` if not stated
+- `rootPath: "<absolute path to git repo root>"` — required for sandbox + graph lookup
 
-Infer `project` from the working directory name if not stated.
+Both fields are required: `project` names the memory bucket, `rootPath` enables exact graph matching and file sandboxing.
 
 Returns:
 - `recentEntries` — decisions, bugs, notes from past sessions
@@ -40,7 +43,7 @@ Then:
 **1. After graph build or rebuild**
 Every time `codegraph_build` completes successfully, immediately call:
 ```
-context.save  type: "architecture"  title: "ContextGraph built — <project>"
+context.save  project: "<project>"  type: "architecture"  title: "ContextGraph built — <project>"
 content: "nodes: X | edges: Y | communities: Z | built: <timestamp>"
 ```
 
@@ -70,7 +73,7 @@ Do NOT save for: routine file reads, search results, explanations of existing co
 | Deploy / release step discovered | `note` |
 | Milestone / feature / task completed | `note` |
 
-Always pass `project`. Feature spans multiple sessions → `discussion.create` or `discussion.update`. Need past info → `search` before asking user. Auto-compact fires at >50 entries.
+Always pass `project`. Feature spans multiple sessions → `discussion.create` or `discussion.update`. Need past info → `search` before asking user. Auto-compact fires at >20 entries.
 
 ---
 

package/src/tools/codegraph.js

@@ -184,7 +184,10 @@ export function handle(name, args, state) {
         summary:     result.summary || '',
       });
 
-      const project = state?.sessionProject || 'global';
+      const inferredProject = args.path
+        ? args.path.replace(/\\/g, '/').replace(/\/$/, '').split('/').pop()
+        : null;
+      const project = state?.sessionProject || inferredProject || null;
       const title   = `CodeGraph — ${args.path}`;
       const content = [
         `nodes: ${result.nodes} | edges: ${result.edges} | communities: ${result.communities}`,

package/src/tools/context.js

@@ -92,9 +92,15 @@ export async function handle(args, state) {
         .filter(e => e.status !== 'archived');
       const discussions   = listDiscussions({ project: proj, status: 'active' });
       const allGraphs     = listGraphs();
-      const graph         = proj
-        ? allGraphs.find(g => g.path?.toLowerCase().includes(proj.toLowerCase())) || allGraphs[0] || null
-        : allGraphs[0] || null;
+      const np = p => (p || '').toLowerCase().replace(/\\/g, '/');
+      const graph         = resolvedRoot
+        ? allGraphs.find(g => np(g.path) === np(resolvedRoot)) || null
+        : proj
+          ? allGraphs.find(g => {
+              const parts = np(g.path).split('/');
+              return parts[parts.length - 1] === proj.toLowerCase();
+            }) || null
+          : null;
       const totalEntries  = countContext(proj);
 
       // Auto-restore single active discussion

package/src/tools/gitTools.js

@@ -29,11 +29,10 @@ function resolveCwd(args, state) {
   // Auto-detect project root on first use if not already configured.
   if (!state.projectRootPath) {
     const detected = autoDetectRoot(args.cwd ? pathResolve(args.cwd) : process.cwd());
-    if (detected) state.projectRootPath = detected;
+    state.projectRootPath = detected || process.cwd();
   }
-  const raw = args.cwd ? pathResolve(args.cwd) : (state.projectRootPath || process.cwd());
-  if (state.projectRootPath) return guardPath(raw, state.projectRootPath);
-  return raw;
+  const raw = args.cwd ? pathResolve(args.cwd) : state.projectRootPath;
+  return guardPath(raw, state.projectRootPath);
 }
 
 const ROOT_NOTE = ' All paths must be within the project root (sandboxed — access outside root is denied).';

package/uv.lock

@@ -168,7 +168,7 @@ wheels = [
 
 [[package]]
 name = "codegraph-mcp"
-version = "1.0.4"
+version = "1.0.5"
 source = { editable = "." }
 dependencies = [
     { name = "mcp" },