context-mcp-server 1.1.2 → 1.1.4

package/src/templates/gemini/GEMINI.md

@@ -71,13 +71,24 @@ Call `search` before asking user to re-explain past work.
 codegraph_build(path)                    → build AST graph + auto-generate all visualizations
 codegraph_arch(path, limit?)             → module map: files, exports, imports
 codegraph_query(path, question?, node?)  → find symbol or answer structural question
-codegraph_nodes(path, type)              → list all nodes of a type
-codegraph_report(path)                   → structural analysis
+codegraph_nodes(path, type)              → list all nodes of a type (class|function|module|file|struct|table)
+codegraph_report(path)                   → structural analysis, god nodes, clusters
 codegraph_affected(path, node, depth?)   → blast radius BFS — what breaks if X changes?
 codegraph_html(path, formats?)           → regenerate visualizations on demand
+get_symbol_detail(name, path)            → source code for one function/class — no full file read
+tool_registry()                          → which tools have side effects + approval requirements
+safety_policy()                          → which actions need user confirmation
 ```
 
-Use `codegraph_arch` first. Never read files for structure questions.
+Decision rules:
+- **Unknown codebase**: `codegraph_report` first (god nodes + surprises)
+- **"Where is X?"**: `codegraph_query node:"X"`
+- **Before any refactor**: `codegraph_affected node:"X"` — FIRST
+- **"Show me function X"**: `get_symbol_detail` — avoids full file read
+- **List all classes**: `codegraph_nodes type:"class"`
+- **`search`** finds past decisions. **`codegraph_query`** finds code. Different tools.
+
+Never read files for structure questions.
 
 ---
 

package/src/templates/windsurf/windsurf-rules.md

@@ -66,13 +66,24 @@ Call `search` before asking user to re-explain past work.
 ```
 codegraph_arch(path)                   → module map (files, exports, imports)
 codegraph_query(path, ...)             → find specific function/class/file
-codegraph_nodes(path, type)            → list all nodes of a type
-codegraph_report(path)                 → structural analysis
+codegraph_nodes(path, type)            → list all nodes of a type (class|function|module|file|struct|table)
+codegraph_report(path)                 → structural analysis, god nodes, clusters
 codegraph_affected(path, node, depth?) → blast radius — what breaks if X changes?
 codegraph_html(path, formats?)         → regenerate visualizations (auto on every build)
+get_symbol_detail(name, path)          → source code for one function/class — no full file read
+tool_registry()                        → which tools have side effects + approval requirements
+safety_policy()                        → which actions need user confirmation
 ```
 
-Use `codegraph_arch` first. Never read files for structure questions.
+Decision rules:
+- **Unknown codebase**: `codegraph_report` first
+- **"Where is X?"**: `codegraph_query node:"X"`
+- **Before any refactor**: `codegraph_affected node:"X"` — FIRST
+- **"Show me function X"**: `get_symbol_detail` — avoids full file read
+- **List all classes**: `codegraph_nodes type:"class"`
+- **`search`** finds past decisions. **`codegraph_query`** finds code. Different tools.
+
+Never read files for structure questions.
 
 ---
 

package/src/tools/codegraph.js

@@ -71,7 +71,10 @@ export const definitions = [
   },
   {
     name: 'codegraph_nodes',
-    description: 'List all nodes of a given type in the graph.',
+    description:
+      'List all nodes of a given type in the graph. ' +
+      'type must be one of: class, function, module, concept, service, file, struct, table. ' +
+      'Use to enumerate all classes before refactoring, all functions in a module, or all files of a type.',
     inputSchema: {
       type: 'object',
       properties: {

package/src/tools/context.js

@@ -89,15 +89,15 @@ export async function handle(args, state) {
 
       const rawEntries    = getContext({ project: proj, limit: 15, compact: false })
         .filter(e => e.status !== 'archived');
-      // Newest 5 get full content; older entries get a lightweight preview
+      // Full content only for: newest 2, or high-signal entries (why+outcome+files)
+      // ponytail: avoids dumping 5 full auto-entries (graph builds, etc.) every resume
       const entries = rawEntries.map((e, i) => {
-        if (i < 5) return e;
+        const isHighSignal = e.why && e.outcome && Array.isArray(e.files) && e.files.length > 0;
+        if (i < 2 || isHighSignal) return e;
         return {
           id: e.id, project: e.project, title: e.title, type: e.type,
           status: e.status, tags: e.tags, source: e.source,
           createdAt: e.createdAt, updatedAt: e.updatedAt,
-          ...(e.why     ? { why: e.why }         : {}),
-          ...(e.outcome ? { outcome: e.outcome }  : {}),
           preview: (e.content || '').slice(0, 200),
         };
       });
@@ -116,12 +116,12 @@ export async function handle(args, state) {
 
       if (discussions.length === 1) state.discussionId = discussions[0].id;
 
-      const digest = totalEntries > 10
+      const digest = totalEntries > 25
         ? autoDigest(getContext({ project: proj, limit: 30 }), proj)
         : null;
 
       const graphStatus = graph
-        ? { built: true, path: graph.path, nodes: graph.nodes, edges: graph.edges, communities: graph.communities, builtAt: graph.builtAt }
+        ? { built: true, path: graph.path, nodes: graph.nodes, edges: graph.edges, builtAt: graph.builtAt }
         : { built: false };
 
       return {

package/src/tools/errorCheck.js

@@ -35,7 +35,7 @@ export async function handle(args, state) {
 
   if (action === 'check') {
     const results = unifiedSearch({ mode: 'semantic', query: errorMessage, project, limit: 5 })
-      .filter(r => r.type === 'bug');
+      .filter(r => Array.isArray(r.tags) && r.tags.includes('error-log'));
     if (results.length > 0 && results[0].similarity > 0.4) {
       return {
         success: true, found: true,
@@ -53,8 +53,8 @@ export async function handle(args, state) {
       sessionId: state.sessionId || null,
       title:   `Error: ${errorMessage.split('\n')[0].slice(0, 60)}`,
       content: `Command: ${command || 'unknown'}\n\nError:\n${errorMessage}\n\nSolution:\n${solution}`,
-      type:    'bug',
-      status:  'done',
+      type:    'note',
+      status:  'active',
       tags:    ['error-log', command].filter(Boolean),
     });
     fireAutoLink(entry.id, state);

package/src/tools/fileTools.js

@@ -107,7 +107,7 @@ export async function handle(name, args, state) {
       saveAutoContext({
         title:   `wrote ${filePath.split(/[\\/]/).pop()}`,
         content: `write_file: created/overwrote ${filePath}`,
-        type:    'code',
+        type:    'note',
         files:   [{ path: filePath, action: 'modified' }],
         tags:    ['file-write'],
         state,
@@ -159,7 +159,7 @@ export async function handle(name, args, state) {
         title:   `patched ${filePath.split(/[\\/]/).pop()}${sorted.length > 1 ? ` (${sorted.length} edits)` : ''}`,
         content: `patch_file: ${sorted.length} edit(s) in ${filePath}\n` +
                  sorted.map(e => `  ${e.description}: -${e.old_str.split('\n').length} +${e.new_str.split('\n').length} lines`).join('\n'),
-        type:    'code',
+        type:    'note',
         files:   [{ path: filePath, action: 'modified' }],
         tags:    ['file-patch'],
         state,

package/src/tools/gitTools.js

@@ -175,7 +175,7 @@ export async function handle(name, args, state) {
       saveAutoContext({
         title:   `git commit: ${args.message.slice(0, 57)}${args.message.length > 57 ? '...' : ''}`,
         content: `hash: ${hash} | branch: ${branch}\nmessage: ${args.message}\nfiles: ${stagedFiles.map(f => f.path).join(', ')}`,
-        type:    'decision',
+        type:    'note',
         files:   stagedFiles,
         tags:    ['git', 'commit', branch],
         state,

package/src/tools/search.js

@@ -44,7 +44,7 @@ export async function handle(args, _state) {
     id: e.id, project: e.project, title: e.title || '',
     tags: e.tags, createdAt: e.createdAt,
     similarity: e.similarity,
-    preview: (e.content || '').slice(0, 200),
+    // ponytail: preview omitted — call context.get id:[...] for full content
   }));
   return {
     matches, count: matches.length, mode,

package/src/tools/symbolDetail.js

@@ -0,0 +1,74 @@
+/**
+ * get_symbol_detail — return source code for a single function/class by name.
+ * Uses codegraph_query to locate the symbol, then reads only the relevant lines.
+ */
+
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { handle as codegraphHandle } from './codegraph.js';
+
+export const definition = {
+  name: 'get_symbol_detail',
+  description:
+    'Return the source code and location for a single function, class, or method by name. ' +
+    'Use instead of reading the whole file — much cheaper. Requires codegraph to be built. ' +
+    'Pass file to narrow when multiple symbols share the same name.',
+  inputSchema: {
+    type: 'object',
+    required: ['name'],
+    properties: {
+      name: { type: 'string', description: 'Symbol name (function, class, method)' },
+      file: { type: 'string', description: 'Optional: narrow by file path (partial match ok)' },
+      path: { type: 'string', description: 'Project root path (required if codegraph was built for a specific path)' },
+      context_lines: { type: 'number', description: 'Extra lines to include above/below (default 3)' },
+    },
+  },
+};
+
+export async function handle(args, state) {
+  const { name, file, context_lines = 3 } = args;
+  const rootPath = args.path || state.projectRootPath;
+  if (!rootPath) throw new Error('path or projectRootPath required');
+
+  // Ask codegraph for the node location
+  const queryResult = codegraphHandle('codegraph_query', { path: rootPath, node: name }, state);
+
+  // Find the node matching name (and optionally file)
+  const nodes = queryResult?.nodes || queryResult?.results || [];
+  let match = nodes.find(n =>
+    n.name === name && (!file || (n.file || '').includes(file))
+  );
+  if (!match && nodes.length === 1) match = nodes[0];
+  if (!match) {
+    return {
+      found: false,
+      message: `Symbol "${name}" not found in graph. Run codegraph_build first, or check spelling.`,
+      candidates: nodes.slice(0, 5).map(n => ({ name: n.name, file: n.file, type: n.type })),
+    };
+  }
+
+  // Read the source file around the symbol's line
+  const absFile = join(rootPath, match.file);
+  let source;
+  try {
+    source = readFileSync(absFile, 'utf8');
+  } catch {
+    return { found: true, ...match, error: `Could not read file: ${absFile}` };
+  }
+
+  const lines = source.split('\n');
+  const startLine = Math.max(0, (match.line || 1) - 1 - context_lines);
+  // Heuristic: read up to 80 lines or until we find the closing brace/dedent
+  const endLine = Math.min(lines.length, startLine + 80 + context_lines);
+  const snippet = lines.slice(startLine, endLine).join('\n');
+
+  return {
+    found: true,
+    name: match.name,
+    type: match.type,
+    file: match.file,
+    line: match.line,
+    source: snippet,
+    hint: `Lines ${startLine + 1}–${endLine} of ${match.file}. Use read_file for the full file.`,
+  };
+}

package/src/tools/toolRegistry.js

@@ -0,0 +1,77 @@
+/**
+ * tool_registry + safety_policy — static metadata about every MCP tool.
+ * No DB queries. Pure JSON describing side-effects and approval requirements.
+ */
+
+const REGISTRY = [
+  // Core memory tools
+  { name: 'context',           side_effects: 'Writes to ~/.context-mcp on save/update/delete', requires_approval: false },
+  { name: 'search',            side_effects: 'none',                                            requires_approval: false },
+  { name: 'plan',              side_effects: 'Writes plan files to planDir on save/update',     requires_approval: false },
+  { name: 'error_check',       side_effects: 'Writes to ~/.context-mcp on save',                requires_approval: false },
+  // Graph tools
+  { name: 'codegraph_build',   side_effects: 'Writes codegraph-cache/ in project root',         requires_approval: false },
+  { name: 'codegraph_query',   side_effects: 'none',                                            requires_approval: false },
+  { name: 'codegraph_arch',    side_effects: 'none',                                            requires_approval: false },
+  { name: 'codegraph_nodes',   side_effects: 'none',                                            requires_approval: false },
+  { name: 'codegraph_report',  side_effects: 'Writes CODEGRAPH_REPORT.md in project root',      requires_approval: false },
+  { name: 'codegraph_affected',side_effects: 'none',                                            requires_approval: false },
+  { name: 'codegraph_html',    side_effects: 'Writes HTML/GraphML files to codegraph-cache/',   requires_approval: false },
+  { name: 'get_symbol_detail', side_effects: 'none',                                            requires_approval: false },
+  // File tools (HTTP mode only)
+  { name: 'read_file',         side_effects: 'none',                                            requires_approval: false },
+  { name: 'list_dir',          side_effects: 'none',                                            requires_approval: false },
+  { name: 'write_file',        side_effects: 'Creates or overwrites a file',                    requires_approval: true  },
+  { name: 'patch_file',        side_effects: 'Modifies an existing file',                       requires_approval: true  },
+  { name: 'create_dir',        side_effects: 'Creates a directory',                             requires_approval: false },
+  { name: 'delete_file',       side_effects: 'Permanently deletes a file or directory',         requires_approval: true  },
+  // Git tools (ACCESS_GIT=true only)
+  { name: 'git_status',        side_effects: 'none',                                            requires_approval: false },
+  { name: 'git_diff',          side_effects: 'none',                                            requires_approval: false },
+  { name: 'git_log',           side_effects: 'none',                                            requires_approval: false },
+  { name: 'git_show',          side_effects: 'none',                                            requires_approval: false },
+  { name: 'git_add',           side_effects: 'Stages files for commit',                         requires_approval: false },
+  { name: 'git_commit',        side_effects: 'Creates a git commit',                            requires_approval: true  },
+  { name: 'git_push',          side_effects: 'Pushes commits to remote — IRREVERSIBLE',         requires_approval: true  },
+  { name: 'git_pull',          side_effects: 'Modifies working tree',                           requires_approval: true  },
+  { name: 'git_branch',        side_effects: 'May create or switch branches',                   requires_approval: false },
+  { name: 'git_stash',         side_effects: 'Modifies stash stack',                            requires_approval: false },
+  { name: 'git_reset',         side_effects: 'Modifies staging area or HEAD — use with care',   requires_approval: true  },
+];
+
+const SAFETY_POLICY = {
+  description: 'Actions that require explicit user confirmation before execution.',
+  requires_confirmation: REGISTRY.filter(t => t.requires_approval).map(t => t.name),
+  rules: [
+    'Always confirm before git_push — pushes affect the remote and are hard to undo.',
+    'Always confirm before delete_file — no recycle bin.',
+    'Always confirm before git_reset if mode is hard — discards uncommitted work.',
+    'Always confirm before write_file on files that look like credentials or config.',
+  ],
+};
+
+export const definitions = [
+  {
+    name: 'tool_registry',
+    description:
+      'Lists every MCP tool with its side effects and whether it requires user approval. ' +
+      'Read this before calling any destructive tool to understand the risk.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'safety_policy',
+    description:
+      'Lists which operations require explicit user confirmation before execution ' +
+      '(git_push, git_reset, delete_file, write_file, git_commit, patch_file). ' +
+      'Read before performing any irreversible action.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+];
+
+export const TOOL_NAMES = new Set(definitions.map(d => d.name));
+
+export function handle(name) {
+  if (name === 'tool_registry') return { tools: REGISTRY, count: REGISTRY.length };
+  if (name === 'safety_policy') return SAFETY_POLICY;
+  throw new Error(`Unknown tool: ${name}`);
+}

package/src/vector.js

@@ -64,15 +64,20 @@ function buildIDF(docs) {
   return idf;
 }
 
+let _idfFingerprint = null;
+
 function getCachedIDF(corpus) {
   const gen = getGeneration();
-  // Cache hit: same generation (no mutations) and same corpus size
-  if (_idfCache && _idfGeneration === gen && _idfCorpusLen === corpus.length) {
+  // Fingerprint first 20 IDs to detect content change at same size (e.g. delete+add)
+  const fingerprint = corpus.slice(0, 20).map(e => e.id).join(',');
+  if (_idfCache && _idfGeneration === gen && _idfCorpusLen === corpus.length
+      && _idfFingerprint === fingerprint) {
     return _idfCache;
   }
   _idfCache = buildIDF(corpus);
   _idfGeneration = gen;
   _idfCorpusLen = corpus.length;
+  _idfFingerprint = fingerprint;
   return _idfCache;
 }
 

package/uv.lock

@@ -201,7 +201,7 @@ wheels = [
 
 [[package]]
 name = "codegraph-mcp"
-version = "1.1.0"
+version = "1.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "mcp" },
@@ -2308,8 +2308,8 @@ name = "uvicorn"
 version = "0.46.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "click" },
-    { name = "h11" },
+    { name = "click", marker = "python_full_version < '3.15' or sys_platform != 'emscripten'" },
+    { name = "h11", marker = "python_full_version < '3.15' or sys_platform != 'emscripten'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/1f/93/041fca8274050e40e6791f267d82e0e2e27dd165627bd640d3e0e378d877/uvicorn-0.46.0.tar.gz", hash = "sha256:fb9da0926999cc6cb22dc7cd71a94a632f078e6ae47ff683c5c420750fb7413d", size = 88758, upload-time = "2026-04-23T07:16:00.151Z" }
 wheels = [