callgraph-mcp 1.8.1 → 1.8.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 +14 -11
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -118,6 +118,20 @@ Optional parameters shown in `[brackets]`.
118
118
 
119
119
  **`workspacePath`** — absolute path to the repo root (e.g. `/home/user/my-project` or `C:\projects\my-app`).
120
120
 
121
+ ### Token-Saving Use Cases
122
+
123
+ | Tool | Token-saving use case |
124
+ |------|------------------------|
125
+ | `flowmap_analyze_workspace` | One call replaces reading every file for an architecture overview |
126
+ | `flowmap_analyze_file` | Structural map of a single file without loading its full content |
127
+ | `flowmap_get_callers` | Impact analysis without reading the whole codebase |
128
+ | `flowmap_get_callees` | Dependency lookup without loading source |
129
+ | `flowmap_get_flow` | End-to-end trace of a feature path without reading each file |
130
+ | `flowmap_list_entry_points` | Instant onboarding map; no file-by-file scanning needed |
131
+ | `flowmap_find_orphans` | Dead code report without reading any file |
132
+ | `flowmap_find_cycles` | Circular dependency identification without reading all text |
133
+ | `flowmap_find_duplicates` | Detects silently duplicated logic without comparing file contents |
134
+
121
135
  ---
122
136
 
123
137
  ## Environment Variable Reference
@@ -129,20 +143,9 @@ Optional parameters shown in `[brackets]`.
129
143
  | `FLOWMAP_GRAMMARS` | *(bundled)* | Override path to WASM grammar files |
130
144
  | `FLOWMAP_BATCH_SIZE` | `50` | Files per parallel parsing batch (must be ≥ 1) |
131
145
  | `FLOWMAP_CACHE_TTL_MS` | `30000` | Result cache time-to-live in milliseconds (0 to disable) |
132
- | `FLOWMAP_VERBOSE` | `true` | Enable/disable diagnostic log lines on stderr (`Log: ...`) |
133
146
  | `FLOWMAP_DUP_THRESHOLD` | `0.75` | Jaccard similarity threshold for `find_duplicates` (0–1) |
134
147
  | `FLOWMAP_DUP_MIN_CALLEES` | `2` | Min callee count for `find_duplicates` |
135
148
 
136
- ### stderr output format
137
-
138
- FlowMap writes structured runtime messages to `stderr` with a severity prefix:
139
-
140
- - `Log: ...` for verbose progress and diagnostic output
141
- - `Warning: ...` for recoverable configuration/runtime issues
142
- - `Error: ...` for startup failures and other fatal errors
143
-
144
- Set `FLOWMAP_VERBOSE=false` to suppress `Log:` lines while keeping `Warning:` and `Error:` output.
145
-
146
149
  ---
147
150
 
148
151
  ## Example Use Cases
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "callgraph-mcp",
3
- "version": "1.8.1",
3
+ "version": "1.8.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",