context-mcp-server 1.0.7 → 1.0.8

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mcp-server",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "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.0.8"
 description = "Codebase knowledge graph MCP server — AST extraction, graph queries, community detection"
 readme = "README.md"
 requires-python = ">=3.11"

package/src/cli.js

@@ -163,17 +163,20 @@ function cmdList(args) {
 
   printSection('Context', filterProject ? `project: ${filterProject}` : 'all projects');
 
-  // Build per-project map
+  // Build per-project map, split entries into their three trees
   const projects = {};
+  const ensureProj = p => {
+    if (!projects[p]) projects[p] = { context: [], summary: [], plans: [] };
+    return projects[p];
+  };
   for (const entry of entries) {
     const p = entry.project || 'global';
-    if (!projects[p]) projects[p] = { contexts: [], discussions: [] };
-    projects[p].contexts.push(entry);
+    const d = ensureProj(p);
+    if (entry.type === 'compaction') d.summary.push(entry);
+    else d.context.push(entry);
   }
   for (const disc of allDiscussions) {
-    const p = disc.project || 'global';
-    if (!projects[p]) projects[p] = { contexts: [], discussions: [] };
-    projects[p].discussions.push(disc);
+    ensureProj(disc.project || 'global').plans.push(disc);
   }
 
   const projectNames = Object.keys(projects).sort();
@@ -185,73 +188,82 @@ function cmdList(args) {
   }
 
   for (const projectName of projectNames) {
-    const pData     = projects[projectName];
-    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;
-
-    const projReg  = projectRegistry.get(projectName);
+    const pData        = projects[projectName];
+    const graphBuild   = _graphForProject(allGraphs, projectName);
+    const totalEntries = pData.context.length + pData.summary.length;
+    const activePlans  = pData.plans.filter(p => p.status === 'active').length;
+    const sections     = [
+      graphBuild               && 'graph',
+      pData.context.length     && 'context',
+      pData.summary.length     && 'summary',
+      pData.plans.length       && 'plans',
+    ].filter(Boolean);
+    let secIdx = 0;
+
+    const projReg   = projectRegistry.get(projectName);
     const projIdStr = projReg?.id ? faint('  id:' + projReg.id.slice(0, 8)) : '';
-    console.log(`\n  ${color(C.dblue, '◆')} ${bold(lblue(projectName))}${projIdStr}  ${faint(`${pData.contexts.length} entries · ${pData.discussions.length} discussions`)}${activeD ? `  ${warn('● ' + activeD + ' active')}` : ''}`);
+    console.log(`\n  ${color(C.dblue, '◆')} ${bold(lblue(projectName))}${projIdStr}  ${faint(`${totalEntries} entries · ${pData.plans.length} plans`)}${activePlans ? `  ${warn('● ' + activePlans + ' active')}` : ''}`);
     console.log(`  ${color(C.darkgray, '│')}`);
 
-    // ── Graph ────────────────────────────────────────────────────────────────
-    if (graph) {
+    const renderEntries = (items, label, secIsLast) => {
+      console.log(`  ${color(C.darkgray, secIsLast ? '└─' : '├─')} ${muted(label)}  ${faint(items.length + ' entries')}`);
+      items.forEach((item, i) => {
+        const br   = i === items.length - 1 ? '└─' : '├─';
+        const date = (item.createdAt || '').slice(0, 10);
+        const id   = item.id.slice(0, 8);
+        const tags = safeTags(item.tags);
+        const pipe = secIsLast ? ' ' : '│';
+        console.log(`  ${color(C.darkgray, pipe)}  ${color(C.darkgray, br)} ${pill(item.type || 'note')}  ${bold(item.title || '(no title)')}  ${faint('id:' + id)}  ${faint(date)}`);
+        if (tags.length) console.log(`  ${color(C.darkgray, pipe)}     ${faint(tags.map(t => '#' + t).join(' '))}`);
+      });
+      if (!secIsLast) console.log(`  ${color(C.darkgray, '│')}`);
+    };
+
+    // ── Graph (build stats only) ──────────────────────────────────────────────
+    if (graphBuild) {
       secIdx++;
-      const isLast  = secIdx === totalSecs;
-      const builtAt = (graph.builtAt || '').slice(0, 10);
-      console.log(`  ${color(C.darkgray, isLast ? '└─' : '├─')} ${accent('⬡')} ${muted('graph')}  ${faint(`${graph.nodes}n · ${graph.edges}e · ${graph.communities} clusters · ${builtAt}`)}`);
+      const isLast  = secIdx === sections.length;
+      const builtAt = (graphBuild.builtAt || '').slice(0, 10);
+      console.log(`  ${color(C.darkgray, isLast ? '└─' : '├─')} ${accent('⬡')} ${muted('graph')}  ${faint(`${graphBuild.nodes}n · ${graphBuild.edges}e · ${graphBuild.communities} clusters · ${builtAt}`)}`);
       if (!isLast) console.log(`  ${color(C.darkgray, '│')}`);
     }
 
-    // ── Context entries ───────────────────────────────────────────────────────
-    if (pData.contexts.length) {
+    // ── Context ───────────────────────────────────────────────────────────────
+    if (pData.context.length) {
       secIdx++;
-      const isLast = secIdx === totalSecs;
-      console.log(`  ${color(C.darkgray, isLast ? '└─' : '├─')} ${muted('memory')}  ${faint(pData.contexts.length + ' entries')}`);
-      pData.contexts.forEach((item, i) => {
-        const br   = i === pData.contexts.length - 1 ? '└─' : '├─';
+      renderEntries(pData.context, 'context', secIdx === sections.length);
+    }
+
+    // ── Summary (compaction digests only — no type labels) ───────────────────
+    if (pData.summary.length) {
+      secIdx++;
+      const isLast = secIdx === sections.length;
+      console.log(`  ${color(C.darkgray, isLast ? '└─' : '├─')} ${muted('summary')}  ${faint(pData.summary.length + ' compactions')}`);
+      pData.summary.forEach((item, i) => {
+        const br   = i === pData.summary.length - 1 ? '└─' : '├─';
         const date = (item.createdAt || '').slice(0, 10);
-        const type = item.type || 'note';
-        const id   = item.id.slice(0, 8);
-        const tags = safeTags(item.tags);
         const pipe = isLast ? ' ' : '│';
-        console.log(`  ${color(C.darkgray, pipe)}  ${color(C.darkgray, br)} ${pill(type)}  ${bold(item.title || '(no title)')}  ${faint('id:' + id)}  ${faint(date)}`);
-        if (tags.length) console.log(`  ${color(C.darkgray, pipe)}     ${faint(tags.map(t => '#' + t).join(' '))}`);
+        console.log(`  ${color(C.darkgray, pipe)}  ${color(C.darkgray, br)} ${faint('◎')} ${bold(item.title || '(compaction)')}  ${faint(date)}`);
       });
       if (!isLast) console.log(`  ${color(C.darkgray, '│')}`);
     }
 
-    // ── Discussions ───────────────────────────────────────────────────────────
-    if (pData.discussions.length) {
+    // ── Plans ─────────────────────────────────────────────────────────────────
+    if (pData.plans.length) {
       secIdx++;
-      const isLast = secIdx === totalSecs;
-      console.log(`  ${color(C.darkgray, isLast ? '└─' : '├─')} ${muted('discussions')}  ${faint(pData.discussions.length + ' total')}`);
-      pData.discussions.forEach((disc, i) => {
-        const br    = i === pData.discussions.length - 1 ? '└─' : '├─';
-        const sc    = disc.status === 'done' ? 'green' : 'tcyan';
-        const steps = disc.stepsSummary?.total ? faint(` ${disc.stepsSummary.done}/${disc.stepsSummary.total}`) : '';
-        const pipe  = isLast ? ' ' : '│';
-        console.log(`  ${color(C.darkgray, pipe)}  ${color(C.darkgray, br)} ${warn(disc.status === 'active' ? '●' : '○')} ${bold(disc.name)}  ${pill(disc.status, sc)}  ${faint(disc.type || 'plan')}${steps}`);
-        if (disc.description) console.log(`  ${color(C.darkgray, pipe)}     ${faint(disc.description)}`);
+      const isLast = secIdx === sections.length;
+      console.log(`  ${color(C.darkgray, isLast ? '└─' : '├─')} ${muted('plans')}  ${faint(pData.plans.length + ' total')}`);
+      pData.plans.forEach((plan, i) => {
+        const br   = i === pData.plans.length - 1 ? '└─' : '├─';
+        const pipe = isLast ? ' ' : '│';
+        console.log(`  ${color(C.darkgray, pipe)}  ${color(C.darkgray, br)} ${warn(plan.status === 'active' ? '●' : '○')} ${bold(plan.name)}  ${pill(plan.status, plan.status === 'done' ? 'green' : 'tcyan')}  ${faint((plan.description || '').slice(0, 60))}`);
       });
     }
   }
 
-  // Orphan graphs (no matching project)
-  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) {
-      const pathShort = g.path.replace(/\\/g, '/').split('/').slice(-2).join('/');
-      console.log(`    ${accent('⬡')} ${bold(pathShort)}  ${faint(`${g.nodes}n · ${g.edges}e · ${g.communities} clusters`)}`);
-    }
-  }
-
   console.log('');
   console.log(line());
-  console.log(faint(`  ${entries.length} entries  ·  ${allDiscussions.length} discussions  ·  ${allGraphs.length} graphs  ·  ${projectNames.length} projects`));
+  console.log(faint(`  ${entries.length} entries  ·  ${allDiscussions.length} plans  ·  ${allGraphs.length} graphs  ·  ${projectNames.length} projects`));
 }
 
 // ── Search ────────────────────────────────────────────────────────────────────