callgraph-mcp 1.4.1 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +4 -14
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -145,7 +145,7 @@ The agent calls `flowmap_find_cycles(workspacePath)`. Each cycle is returned as
145
145
 
146
146
  > *"I want to delete code safely. Give me every function that is provably unreachable — not called by anything, not an entry point. Include file and line number."*
147
147
 
148
- The agent calls `flowmap_find_orphans(workspacePath)`. This returns every function not reachable from any entry point in the call graph — with file path and line number for each one. These are not "probably unused" — they are graph-theoretically unreachable. Safe to delete. No cross-checking required.
148
+ The agent calls `flowmap_find_orphans(workspacePath)`. This returns every function not reachable from any entry point in the call graph — with file path and line number for each one.
149
149
 
150
150
  ---
151
151
 
@@ -173,14 +173,6 @@ The agent calls `flowmap_get_callers` for each modified function and `flowmap_ge
173
173
 
174
174
  ---
175
175
 
176
- ### Understand a single file before editing it
177
-
178
- > *"What does `src/auth/middleware.ts` export and what does it call?"*
179
-
180
- The agent calls `flowmap_analyze_file("/abs/path/to/src/auth/middleware.ts")` to get a precise list of every function, its parameters, return type, and all outgoing calls — without needing to read the file itself.
181
-
182
- ---
183
-
184
176
  ### Agentic code generation with structural guardrails
185
177
 
186
178
  When an agent is generating new code, it can call `flowmap_analyze_workspace` before and after to verify:
@@ -194,9 +186,9 @@ When an agent is generating new code, it can call `flowmap_analyze_workspace` be
194
186
 
195
187
  > *"We've been using an AI agent to build this codebase for 3 months. How much logic has it silently duplicated?"*
196
188
 
197
- Agents optimize for the current instruction, not long-term architecture. When a task requires shared logic, the agent rarely stops to ask "does this already exist?" — refactoring requires understanding dependencies and predicting side effects, which is harder than just writing new code that works. So it copies, tweaks slightly, and moves on. It satisfied the step. It made the problem worse.
189
+ Agents optimize for the current instruction, not long-term architecture. It copies, tweaks slightly, and moves on. It satisfied the local goal.
198
190
 
199
- The agent calls `flowmap_find_duplicates(workspacePath)`. Each cluster in the result is a group of functions with different names — often in different components — that call the same set of dependencies. That's the callee-set fingerprint of duplicated business logic. The output names exactly which functions to merge and which file to consolidate them into.
191
+ The agent calls `flowmap_find_duplicates(workspacePath)`. Each cluster in the result is a group of functions with different names — often in different components — that call the same set of dependencies.
200
192
 
201
193
  ---
202
194
 
@@ -204,9 +196,7 @@ The agent calls `flowmap_find_duplicates(workspacePath)`. Each cluster in the re
204
196
 
205
197
  > *"The agent has been adding features for weeks. Are there any circular call dependencies I should know about before this becomes a production problem?"*
206
198
 
207
- Agents don't track long-term call structure. When told to wire up a feature quickly, they take the fastest path: call whatever is needed, from wherever is convenient. Over time this creates circular dependencies — `A` calls `B` calls `C` calls `A` that are invisible until something breaks or hangs at runtime.
208
-
209
- The agent calls `flowmap_find_cycles(workspacePath)`. Every cycle is returned with the exact functions involved, their file locations, and the specific edges forming the loop. No guessing about which modules "seem" circular. The result tells you precisely where to break the chain.
199
+ The agent calls `flowmap_find_cycles(workspacePath)`. Every cycle is returned with the exact functions involved.
210
200
 
211
201
  ---
212
202
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "callgraph-mcp",
3
- "version": "1.4.1",
3
+ "version": "1.4.2",
4
4
  "description": "MCP server for codebase call-flow analysis. Local, deterministic, language-agnostic. Powered by @codeflow-map/core.",
5
5
  "keywords": [
6
6
  "mcp",