purecontext-mcp 1.1.7 → 1.2.0

package/dist/ui/assets/{useSearch-mbMk6-M1.js → useSearch-BnBCRKui.js}

@@ -1 +1 @@
-var O=Object.defineProperty;var _=(e,t,a)=>t in e?O(e,t,{enumerable:!0,configurable:!0,writable:!0,value:a}):e[t]=a;var R=(e,t,a)=>_(e,typeof t!="symbol"?t+"":t,a);import{r as s,a as L,A as j}from"./index-i3Q1XbEh.js";function q(e,t,a,c){return JSON.stringify({repoId:e,repoIds:t?[...t].sort():void 0,query:a,kinds:[...c.kinds].sort(),filePath:c.filePath})}class B{constructor(t){R(this,"map",new Map);this.maxSize=t}get(t){const a=this.map.get(t);return a!==void 0&&(this.map.delete(t),this.map.set(t,a)),a}set(t,a){if(this.map.has(t)&&this.map.delete(t),this.map.set(t,a),this.map.size>this.maxSize){const c=this.map.keys().next().value;c!==void 0&&this.map.delete(c)}}}const T=new B(50);function H({repoId:e,repoIds:t,debounceMs:a=300,cacheSize:c=50}){const[v,P]=s.useState(""),[h,x]=s.useState({kinds:[],filePath:""}),[A,m]=s.useState([]),[F,o]=s.useState(!1),[K,f]=s.useState(null),[y,C]=s.useState(null),d=s.useRef(null),u=s.useRef(null),g=s.useRef(null);s.useEffect(()=>{!e||!h.coverageStatus||t&&t.length>1||d.current!==e&&(d.current=e,L.getRepoCoverage(e).then(n=>{const r=new Map;for(const i of n.mappings)r.set(i.symbolId,i.coverageStatus);C(r)}).catch(()=>{C(null)}))},[e,h.coverageStatus]),s.useEffect(()=>{d.current=null,C(null)},[e,t]);const z=s.useCallback((n,r,i)=>{var w;const S=t&&t.length>1;if(!S&&!e){m([]),o(!1),f(null);return}if(n.trim().length===0){m([]),o(!1),f(null);return}const b=q(e,t,n,r),k=T.get(b);if(k){const l=r.coverageStatus&&i&&!S?k.filter(E=>i.get(E.id)===r.coverageStatus):k;m(l),o(!1),f(null);return}(w=u.current)==null||w.call(u);let p=!1;u.current=()=>{p=!0},o(!0),f(null);const M={query:n,...r.kinds.length===1?{kind:r.kinds[0]}:{},...r.filePath?{filePath:r.filePath}:{},limit:50,...S?{repoIds:t}:{}};L.searchSymbols(S?null:e,M).then(l=>{if(p)return;T.set(b,l.results);const E=r.coverageStatus&&i&&!S?l.results.filter(N=>i.get(N.id)===r.coverageStatus):l.results;m(E),o(!1)}).catch(l=>{p||(f(l instanceof j?l.message:String(l)),o(!1))})},[e,t]);s.useEffect(()=>(g.current!==null&&clearTimeout(g.current),g.current=setTimeout(()=>{z(v,h,y)},a),()=>{g.current!==null&&clearTimeout(g.current)}),[v,h,y,a,z]),s.useEffect(()=>()=>{var n;(n=u.current)==null||n.call(u)},[]);const Q=s.useCallback(n=>{P(n)},[]),J=s.useCallback(()=>{var n;P(""),x({kinds:[],filePath:""}),m([]),f(null),(n=u.current)==null||n.call(u)},[]);return{query:v,setQuery:Q,filters:h,setFilters:x,results:A,loading:F,error:K,clearSearch:J}}export{H as u};
+var O=Object.defineProperty;var _=(e,t,a)=>t in e?O(e,t,{enumerable:!0,configurable:!0,writable:!0,value:a}):e[t]=a;var R=(e,t,a)=>_(e,typeof t!="symbol"?t+"":t,a);import{r as s,a as L,A as j}from"./index-nX2chMqi.js";function q(e,t,a,c){return JSON.stringify({repoId:e,repoIds:t?[...t].sort():void 0,query:a,kinds:[...c.kinds].sort(),filePath:c.filePath})}class B{constructor(t){R(this,"map",new Map);this.maxSize=t}get(t){const a=this.map.get(t);return a!==void 0&&(this.map.delete(t),this.map.set(t,a)),a}set(t,a){if(this.map.has(t)&&this.map.delete(t),this.map.set(t,a),this.map.size>this.maxSize){const c=this.map.keys().next().value;c!==void 0&&this.map.delete(c)}}}const T=new B(50);function H({repoId:e,repoIds:t,debounceMs:a=300,cacheSize:c=50}){const[v,P]=s.useState(""),[h,x]=s.useState({kinds:[],filePath:""}),[A,m]=s.useState([]),[F,o]=s.useState(!1),[K,f]=s.useState(null),[y,C]=s.useState(null),d=s.useRef(null),u=s.useRef(null),g=s.useRef(null);s.useEffect(()=>{!e||!h.coverageStatus||t&&t.length>1||d.current!==e&&(d.current=e,L.getRepoCoverage(e).then(n=>{const r=new Map;for(const i of n.mappings)r.set(i.symbolId,i.coverageStatus);C(r)}).catch(()=>{C(null)}))},[e,h.coverageStatus]),s.useEffect(()=>{d.current=null,C(null)},[e,t]);const z=s.useCallback((n,r,i)=>{var w;const S=t&&t.length>1;if(!S&&!e){m([]),o(!1),f(null);return}if(n.trim().length===0){m([]),o(!1),f(null);return}const b=q(e,t,n,r),k=T.get(b);if(k){const l=r.coverageStatus&&i&&!S?k.filter(E=>i.get(E.id)===r.coverageStatus):k;m(l),o(!1),f(null);return}(w=u.current)==null||w.call(u);let p=!1;u.current=()=>{p=!0},o(!0),f(null);const M={query:n,...r.kinds.length===1?{kind:r.kinds[0]}:{},...r.filePath?{filePath:r.filePath}:{},limit:50,...S?{repoIds:t}:{}};L.searchSymbols(S?null:e,M).then(l=>{if(p)return;T.set(b,l.results);const E=r.coverageStatus&&i&&!S?l.results.filter(N=>i.get(N.id)===r.coverageStatus):l.results;m(E),o(!1)}).catch(l=>{p||(f(l instanceof j?l.message:String(l)),o(!1))})},[e,t]);s.useEffect(()=>(g.current!==null&&clearTimeout(g.current),g.current=setTimeout(()=>{z(v,h,y)},a),()=>{g.current!==null&&clearTimeout(g.current)}),[v,h,y,a,z]),s.useEffect(()=>()=>{var n;(n=u.current)==null||n.call(u)},[]);const Q=s.useCallback(n=>{P(n)},[]),J=s.useCallback(()=>{var n;P(""),x({kinds:[],filePath:""}),m([]),f(null),(n=u.current)==null||n.call(u)},[]);return{query:v,setQuery:Q,filters:h,setFilters:x,results:A,loading:F,error:K,clearSearch:J}}export{H as u};

package/dist/ui/index.html

@@ -4,8 +4,8 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>PureContext</title>
-    <script type="module" crossorigin src="/assets/index-i3Q1XbEh.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DADf5y_L.css">
+    <script type="module" crossorigin src="/assets/index-nX2chMqi.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Ny8gn9F0.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.1.7";
+export declare const VERSION = "1.2.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '1.1.7';
+export const VERSION = '1.2.0';
 //# sourceMappingURL=version.js.map

package/docs/dev/jcodemunch-gap-analysis.md

@@ -0,0 +1,198 @@
+# jCodeMunch Gap Analysis
+
+**Date:** 2026-05-11  
+**Source:** Static analysis of `reference/jcodemunch-mcp/` vs `src/server/tools/`  
+**Purpose:** Identify PureContext feature gaps relative to jCodeMunch v1.4.1 to inform upcoming phases.
+
+---
+
+## Tool Count Summary
+
+| Server | Tool Count |
+|--------|-----------|
+| PureContext | 35 |
+| jCodeMunch | 82 |
+| **Gap** | **47 tools** |
+
+---
+
+## Shared Tools (23)
+
+Both servers expose equivalent versions of these core navigation tools:
+
+`index_folder`, `list_repos`, `resolve_repo`, `search_symbols`, `search_semantic`, `search_text`,
+`get_symbol_source`, `get_file_outline`, `get_repo_outline`, `get_file_tree`, `get_context_bundle`,
+`get_blast_radius`, `find_importers`, `find_dead_code`, `find_references`, `get_file_content`,
+`get_symbols`, `invalidate_cache`, `analyze_diff`, `get_symbol_history`, `search_columns`,
+`get_layer_violations`, `generate_docs`
+
+---
+
+## PureContext Advantages (12 tools jCodeMunch lacks)
+
+| Tool | Description |
+|------|-------------|
+| `export_index` | Serialize index to portable archive |
+| `import_index` | Import a previously exported index |
+| `fetch_public_index` | Download a pre-built index from the public registry |
+| `get_quality_metrics` | Per-file/symbol complexity, coupling, cohesion, doc coverage |
+| `get_churn_metrics` | File and symbol churn scores from git history |
+| `detect_antipatterns` | Detect god classes, circular deps, dead code structurally |
+| `get_symbols` | Batch fetch multiple symbols by ID in one call |
+| `find_cross_repo_usages` | Find usages of a symbol across indexed repos |
+| `search_similar` | HNSW vector similarity search across repos |
+| `get_savings_stats` | Cumulative token savings tracker |
+| `get_task_context` | Assemble focused context bundle for a task description |
+| `search_cross_repo` | Search symbols across multiple repos simultaneously |
+
+---
+
+## jCodeMunch Advantages (59 tools PureContext lacks)
+
+### Category 1 — Runtime Trace Integration (6 tools)
+
+**Impact: Highest.** These tools are architecturally distinct — they ingest production runtime telemetry and overlay it on the static symbol graph. PureContext is purely static; this category cannot be bridged by static analysis alone.
+
+| Tool | Description |
+|------|-------------|
+| `import_runtime_signal` | Ingest a runtime trace (coverage report, profiler output) into the index |
+| `get_runtime_coverage` | Show which symbols were hit in production vs. never called |
+| `find_hot_paths` | Identify the most-executed code paths from runtime data |
+| `find_unused_paths` | Find code that is statically reachable but never called at runtime |
+| `get_redaction_log` | Audit log of what runtime data was redacted before ingestion |
+| `annotate_with_runtime` | Attach runtime hit counts to symbol records |
+
+### Category 2 — Refactoring Guidance (8 tools)
+
+**Impact: High.** PureContext supports discovery; jCodeMunch supports the full edit lifecycle including pre-flight safety checks and ready-to-apply plans.
+
+| Tool | Description |
+|------|-------------|
+| `plan_refactoring` | Generate a sequenced, edit-ready refactoring plan for a symbol or file |
+| `check_rename_safe` | Pre-flight check: is renaming this symbol safe? Lists all affected sites |
+| `check_delete_safe` | Pre-flight check: is deleting this symbol safe? Checks for live references |
+| `check_move_safe` | Pre-flight check: is moving this file/symbol safe? Resolves import impact |
+| `apply_rename` | Execute a rename across the codebase (writes files) |
+| `preview_refactoring` | Dry-run a refactoring plan and return a unified diff |
+| `estimate_refactoring_effort` | Score the complexity and risk of a proposed refactoring |
+| `get_refactoring_history` | List past refactoring operations applied via jCodeMunch |
+
+### Category 3 — Architectural Visualization (8 tools)
+
+**Impact: High.** Visual output that the existing dep graph could power but PureContext doesn't expose.
+
+| Tool | Description |
+|------|-------------|
+| `render_diagram` | Generate Mermaid diagram from dep graph (module, call, class hierarchy) |
+| `get_tectonic_map` | High-level cluster map of the codebase's architectural zones |
+| `get_signal_chains` | Trace event/signal propagation paths through the system |
+| `render_call_graph` | Render a call graph rooted at a symbol as Mermaid/DOT |
+| `render_import_graph` | Render file-level import graph for a directory |
+| `render_class_hierarchy` | UML-style class hierarchy diagram |
+| `render_dep_matrix` | Dependency matrix heatmap (coupling between modules) |
+| `get_architecture_snapshot` | Freeze current architecture state for before/after comparison |
+
+### Category 4 — Advanced Relationship Analysis (8 tools)
+
+**Impact: High.** Deeper graph traversals than PureContext currently exposes.
+
+| Tool | Description |
+|------|-------------|
+| `get_dependency_graph` | Full dep graph for a file or module (not just blast radius) |
+| `get_call_hierarchy` | Callers and callees of a function, N levels deep |
+| `get_class_hierarchy` | Inheritance chain for a class (up and down) |
+| `find_implementations` | Find all concrete implementations of an interface or abstract class |
+| `find_overrides` | Find all method overrides for a given base method |
+| `get_coupling_map` | Per-file coupling scores with named dependencies |
+| `find_cycles` | Detect all import cycles in the graph |
+| `get_interface_contracts` | Extract all methods/properties required by an interface |
+
+### Category 5 — Health Dashboards (3 tools)
+
+**Impact: Medium.** Aggregates PureContext's individual metrics into at-a-glance views.
+
+| Tool | Description |
+|------|-------------|
+| `health_radar` | 6-axis composite health score for the repo (complexity, coupling, coverage, churn, debt, docs) |
+| `diff_health_radar` | Compare health radar between two commits or branches |
+| `get_debt_report` | Prioritized technical debt report with effort estimates |
+
+### Category 6 — Session Awareness (5 tools)
+
+**Impact: Medium.** jCodeMunch maintains stateful sessions across turns; PureContext is stateless.
+
+| Tool | Description |
+|------|-------------|
+| `start_session` | Begin a stateful editing session; tracks edits and context across turns |
+| `end_session` | Finalize a session and produce a summary of changes made |
+| `get_session_state` | Return current session context: symbols touched, edits pending |
+| `record_edit` | Log an edit to session state for rollback/audit |
+| `get_confidence_score` | Return jCodeMunch's confidence level for a proposed change |
+
+### Category 7 — AST-Level Search (4 tools)
+
+**Impact: Medium.** Structural code search beyond symbol name matching.
+
+| Tool | Description |
+|------|-------------|
+| `search_ast` | Structural AST pattern search (find all arrow functions returning JSX, etc.) |
+| `search_by_signature` | Find symbols matching a type signature pattern |
+| `search_by_decorator` | Find all symbols annotated with a given decorator |
+| `search_by_complexity` | Find symbols above a complexity threshold |
+
+### Category 8 — Code Intelligence Helpers (8 tools)
+
+**Impact: Medium.** Utility tools that improve agent decision quality.
+
+| Tool | Description |
+|------|-------------|
+| `get_entry_points` | Find all public entry points of the codebase (main, exports, routes) |
+| `get_public_api` | Extract the public API surface of a module |
+| `get_test_coverage_map` | Map symbols to their test files |
+| `find_untested_symbols` | Find exported symbols with no corresponding test |
+| `get_dependency_versions` | Report dependency versions and known vulnerabilities |
+| `get_todos` | Extract all TODO/FIXME/HACK comments with locations |
+| `get_type_graph` | Type dependency graph (which types reference which) |
+| `get_complexity_hotspots` | Top-N most complex symbols repo-wide |
+
+### Category 9 — Multi-language & Ecosystem Extras (9 tools)
+
+**Impact: Lower (mostly niche).** Additional ecosystem integrations.
+
+| Tool | Description |
+|------|-------------|
+| `index_github_repo` | Index a remote GitHub repo without cloning locally |
+| `get_npm_dependents` | Find npm packages that depend on this package |
+| `search_rust_traits` | Find Rust trait implementations |
+| `search_python_decorators` | Find Python decorated functions by decorator name |
+| `get_go_interfaces` | Extract Go interface definitions and implementors |
+| `search_sql_tables` | Find SQL table definitions across .sql files |
+| `get_proto_services` | Extract gRPC service definitions from .proto files |
+| `get_terraform_resources` | List all Terraform resource definitions |
+| `get_openapi_routes` | List all OpenAPI-defined routes with methods and schemas |
+
+---
+
+## Priority Ranking for PureContext Roadmap
+
+Ranked by value vs. implementation effort:
+
+| Priority | Category | Tools | Rationale |
+|----------|----------|-------|-----------|
+| P1 | Advanced Relationship Analysis | `find_implementations`, `get_call_hierarchy`, `get_class_hierarchy`, `find_cycles` | High value, data already in dep graph |
+| P1 | Architectural Visualization | `render_diagram`, `render_call_graph` | Data exists; just needs Mermaid renderer |
+| P2 | Refactoring Guidance | `check_rename_safe`, `check_delete_safe`, `plan_refactoring` | Safety checks are high-value, low risk |
+| P2 | Health Dashboards | `health_radar`, `diff_health_radar` | Wraps existing metrics — mostly aggregation |
+| P2 | AST-Level Search | `search_ast`, `search_by_decorator` | Needs tree-sitter query DSL; medium effort |
+| P3 | Code Intelligence Helpers | `get_entry_points`, `get_public_api`, `find_untested_symbols`, `get_todos` | Useful utilities; straightforward to implement |
+| P3 | Session Awareness | `start_session`, `get_session_state` | Requires stateful layer; architectural change |
+| P4 | Runtime Trace Integration | All 6 tools | Major architectural addition; high value but complex |
+
+---
+
+## Notes
+
+- jCodeMunch tool list extracted from `reference/jcodemunch-mcp/src/jcodemunch_mcp/server.py` lines 47–99
+- PureContext tool list extracted from `src/server/mcp-server.ts` lines 141–314
+- Some jCodeMunch tool names inferred from source; verify against their latest changelog before committing to parity work
+- Runtime trace tools require a telemetry ingestion pipeline that is out of scope for a pure static-analysis server; treat as a separate product decision

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "purecontext-mcp",
-  "version": "1.1.7",
+  "version": "1.2.0",
   "description": "Token-efficient source code navigation MCP server for AI agents",
   "type": "module",
   "license": "MIT",
@@ -35,21 +35,29 @@
     "AGENT_INSTRUCTIONS.md",
     "AGENT_INSTRUCTIONS_SHORT.md",
     "AI-SUMMARIES.md",
+    "AST-SEARCH.md",
     "CHANGELOG.md",
     "CODE-HEALTH.md",
     "CODE-HISTORY.md",
+    "CODE-INTELLIGENCE.md",
     "FINDING-CODE.md",
     "FULL-INSTALLATAION-GUIDE.md",
+    "HEALTH-DASHBOARDS.md",
     "LICENSE",
     "NAVIGATING-NEW-CODE.md",
+    "REFACTORING-SAFELY.md",
     "SAFE-CHANGES.md",
     "TEAM-SETUP.md",
+    "UNDERSTANDING-RELATIONSHIPS.md",
     "USER-GUIDE.md",
+    "user-manual.md",
+    "VISUALIZING-CODE.md",
     "WEB-UI.md",
     "WHY-PURECONTEXT.md",
     "WORKFLOW-ONBOARDING.md",
     "WORKFLOW-PR-REVIEW.md",
     "WORKFLOW-REFACTORING.md",
+    "WORKFLOW-TECH-DEBT.md",
     "docs/"
   ],
   "main": "./dist/index.js",