mcp-code-context 3.9.1 → 7.0.0

package/skills/code-context-pro/references/decision-tree.md

@@ -0,0 +1,32 @@
+# CodeContext Pro — Cognitive Routing & Decision Tree
+
+When solving software engineering tasks, AI agents waste tokens and introduce hallucinations by reading entire files or grepping blindly. Follow this deterministic decision matrix.
+
+---
+
+## 🚦 ROUTING MATRIX
+
+| User / Task Goal | Preferred Tool | Why AST Outperforms Brute Force |
+|:---|:---|:---|
+| Explore repository structure | `get_semantic_repo_map(format="xml")` | Delivers complete class, method, and DB schema skeleton with 82% token reduction. |
+| Visual architecture review | `get_semantic_repo_map(format="html")` | Standalone, interactive HTML dashboard for browser/iframe visualization. |
+| Read class / function / method | `read_file_surgical(filePath, symbolName)` | Reads only the target node; prevents prompt attention blowout. |
+| Extract type contract / interface | `explain_symbol(filePath, symbolName)` | Inverted LSP extracts inferred type skeleton + callers without heavy daemon. |
+| Run targeted tests after edit | `get_impacted_tests(filePath, symbolName)` | Maps changed symbol to test suites and provides minimal test command. |
+| Trace callers & callees (3 hops) | `get_call_hierarchy(filePath, symbolName)` | Multi-hop AST graph traversal with interactive Mermaid diagram export. |
+| Validate frontend vs backend API | `validate_wire_contract(frontendFile, backendFile)` | Cross-language schema validator catches casing drift and missing fields. |
+| Pre-merge conflict prediction | `predict_semantic_conflicts(baseBranch, targetBranch)` | AST divergence detection across Git branches flags breaking symbol changes. |
+| Search symbols by name | `search_symbols(query, fuzzy=true)` | Indexed SQLite search returns exact coordinates in < 5 ms. |
+| Find files affected by a change | `analyze_impact(filePath)` | Dependency graph traversal identifies imports and call sites. |
+| Modify a function or class | `write_file_surgical(newContent)` | 2-phase atomic write: pre-commit syntax validation + unified diff + rollback token. |
+| Textual pattern / regex search | `search_code_pattern(pattern)` | Bounded streaming regex search with ReDoS timeout protection. |
+| Read arbitrary lines (e.g. config) | `read_file_lines(startLine, endLine)` | Precision line range slicing without reading massive files. |
+
+---
+
+## 🛑 NEGATIVE PROMPT GUARDS (WHAT NOT TO DO)
+
+1. **NEVER call `read_file` or `cat` on files > 100 lines** when you only need to modify or inspect one function.
+2. **NEVER apply edits without previewing the diff** in Phase 1 dry-run.
+3. **NEVER guess database schema columns**: Call `read_file_surgical` on the model file — virtual ORM auto-injects columns from Prisma (`schema.prisma`), Drizzle (`schema.ts`), Rails (`db/schema.rb`), Laravel migrations, or Django (`models.py`).
+4. **NEVER run full test suites blindly**: Call `get_impacted_tests` to run only the tests exercising your changed symbols.

package/skills/code-context-pro/references/multi-ide-setup.md

@@ -0,0 +1,104 @@
+# CodeContext Pro — Universal Multi-IDE Setup Guide
+
+CodeContext Pro is 100% platform-agnostic and runs identically on Windows, macOS, and Linux without native C++ compilation (`node-gyp`).
+
+---
+
+## 1. CLAUDE CODE CLI & CLAUDE DESKTOP
+
+### Claude Code CLI
+Run in your terminal:
+```bash
+claude mcp add code-context -- npx -y mcp-code-context@latest
+```
+
+### Claude Desktop (`claude_desktop_config.json`)
+```json
+{
+  "mcpServers": {
+    "code-context": {
+      "command": "npx",
+      "args": ["-y", "mcp-code-context@latest"]
+    }
+  }
+}
+```
+
+---
+
+## 2. CURSOR & WINDSURF
+
+CodeContext Pro supports modern **Streamable HTTP** over SSE.
+
+### Option A: Local Process (stdio)
+In Cursor / Windsurf MCP settings:
+- **Type**: `command`
+- **Command**: `npx -y mcp-code-context@latest`
+
+### Option B: Background Daemon (HTTP / SSE)
+Start the background server:
+```bash
+npx -y mcp-code-context@latest --http --port=3000
+```
+In Cursor / Windsurf settings:
+- **Type**: `sse`
+- **URL**: `http://127.0.0.1:3000/sse`
+
+---
+
+## 3. VS CODE (ROO CODE / CLINE / COPILOT)
+
+In your MCP settings (`cline_mcp_settings.json` or Roo Code settings):
+```json
+{
+  "mcpServers": {
+    "code-context": {
+      "command": "node",
+      "args": ["C:/code/mcp-code-context/dist/src/index.js"],
+      "disabled": false,
+      "autoApprove": [
+        "get_semantic_repo_map",
+        "read_file_surgical",
+        "search_symbols",
+        "explain_symbol",
+        "analyze_impact",
+        "get_impacted_tests",
+        "get_call_hierarchy"
+      ]
+    }
+  }
+}
+```
+
+---
+
+## 4. JETBRAINS (JUNIE / CONTINUE PLUGIN)
+
+In `~/.continue/config.json`:
+```json
+{
+  "mcpServers": [
+    {
+      "name": "code-context",
+      "command": "npx",
+      "args": ["-y", "mcp-code-context@latest"]
+    }
+  ]
+}
+```
+
+---
+
+## 5. GOOGLE ANTIGRAVITY
+
+In `~/.gemini/antigravity/mcp_config.json`:
+```json
+{
+  "mcpServers": {
+    "mcp-code-context": {
+      "command": "node",
+      "args": ["C:/code/mcp-code-context/dist/src/index.js"]
+    }
+  }
+}
+```

package/HIRE_ME.md

@@ -1,234 +0,0 @@
-# 💼 Hire Me - Freelance MCP & AI Development
-
-## About Me
-
-I'm **Alejandro Chataing**, creator of **mcp-code-context**, an MCP server with 2,000+ NPM package downloads that helps developers save 70-90% on LLM token costs through surgical code editing and AST-based compression.
-
-**Location**: Caracas, Venezuela 🇻🇪  
-**Timezone**: UTC-4 (AST / VET)  
-**Languages**: Spanish (native), English (fluent)
-
----
-
-## 🎯 Core Expertise
-
-### MCP Protocol & AI Integration
-- **MCP Server Development**: Deep understanding of Model Context Protocol
-- **AI/LLM Integration**: Claude, GPT-4, Gemini, local models
-- **Context Optimization**: Token compression, semantic chunking, RAG
-- **Tool Development**: Custom MCP tools for specific workflows
-
-### Technical Skills
-- **Languages**: TypeScript, JavaScript, Python, PHP, Dart
-- **Frameworks**: Node.js, Express, Fastify
-- **AST Parsing**: Tree-sitter, Babel, custom parsers
-- **Databases**: PostgreSQL, MongoDB, Redis
-- **DevOps**: Docker, GitHub Actions, AWS
-- **AI/ML**: LangChain, OpenAI API, Anthropic API, Ollama
-
----
-
-## 🛠️ Services
-
-### 🔹 MCP Server Development
-Build custom MCP servers tailored to your workflow:
-- Custom tools for your specific use case
-- Integration with internal APIs and databases
-- Performance optimization for large codebases
-- Security hardening and audit
-- Documentation and training
-
-**Rate**: $75/hour  
-**Typical Project**: $1,500-5,000  
-**Timeline**: 1-3 weeks
-
-**Example Projects**:
-- Custom code analysis tools
-- Database query assistants
-- API integration servers
-- Documentation generators
-- Testing automation tools
-
----
-
-### 🔹 AI Integration Consulting
-Help your team integrate LLMs effectively:
-- Architecture design for AI-powered applications
-- Cost optimization strategies (reduce token usage by 70-90%)
-- Prompt engineering and fine-tuning
-- RAG (Retrieval-Augmented Generation) implementation
-- Agent orchestration and workflow design
-
-**Rate**: $100/hour  
-**Typical Project**: $2,000-10,000  
-**Timeline**: 2-6 weeks
-
-**Example Projects**:
-- AI-powered code review systems
-- Intelligent documentation assistants
-- Customer support automation
-- Internal knowledge base with AI search
-- Code generation pipelines
-
----
-
-### 🔹 Code Review & Optimization
-Expert review of your MCP/AI codebase:
-- Security audit (path traversal, injection, ReDoS)
-- Performance optimization (memory, speed, token usage)
-- Best practices implementation
-- Documentation improvement
-- Test coverage analysis
-
-**Rate**: $50/hour  
-**Typical Project**: $500-2,000  
-**Timeline**: 3-7 days
-
-**Deliverables**:
-- Detailed audit report
-- Prioritized recommendations
-- Code examples for fixes
-- Implementation guidance
-
----
-
-## 📂 Portfolio
-
-### mcp-code-context
-**The project that proves my expertise**
-
-- **GitHub**: [github.com/achatainga/mcp-code-context](https://github.com/achatainga/mcp-code-context)
-- **npm**: 2,000+ downloads/month
-- **Tech**: TypeScript, Tree-sitter WASM, MCP Protocol
-- **Impact**: Saves users 70-90% on LLM token costs
-
-**Key Features**:
-- Surgical code editing (replace one function without touching the rest)
-- AST-based compression (no regex hacks)
-- Two-phase confirmation workflow
-- Rolling backups (last 5 versions)
-- Zero native dependencies (100% WASM)
-
-**What this demonstrates**:
-- ✅ Deep understanding of MCP protocol
-- ✅ Production-grade TypeScript development
-- ✅ AST parsing and manipulation
-- ✅ Security-first design (two-phase workflow, backups)
-- ✅ Performance optimization (WASM, streaming)
-- ✅ Open source maintenance (1,000+ stars, active community)
-
----
-
-## 🤝 How to Work With Me
-
-### 1. Initial Consultation (Free, 30 min)
-- Discuss your project goals
-- Assess technical feasibility
-- Provide rough estimate and timeline
-- Answer your questions
-
-**Book a call**: Email me at a.chataing.a@gmail.com
-
----
-
-### 2. Proposal (1-2 days)
-- Detailed scope of work
-- Timeline with milestones
-- Fixed price or hourly estimate
-- Terms and conditions
-
----
-
-### 3. Development (Agile)
-- Weekly check-ins (or more frequent if needed)
-- Incremental delivery (you see progress continuously)
-- Transparent communication (Slack, Discord, Email)
-- Code reviews at each milestone
-
----
-
-### 4. Delivery & Support
-- Final code review
-- Complete documentation
-- Knowledge transfer session
-- 30 days of bug fixes included
-- Optional: Ongoing maintenance contract
-
----
-
-## 💰 Pricing & Payment
-
-### Rates
-- **MCP Development**: $75/hour
-- **AI Consulting**: $100/hour
-- **Code Review**: $50/hour
-
-### Payment Terms
-- **Hourly Projects**: Weekly invoices, payment within 7 days
-- **Fixed-Price Projects**: 50% upfront, 50% on delivery
-- **Retainer**: Monthly prepayment for ongoing work
-
-### Accepted Payment Methods
-- **PayPal**: https://paypal.me/achatainga
-- **Binance (USDT)**: 0xa68d53f7853ce0175eb96aaad4a30c068ca96444
-
----
-
-## 📅 Availability
-
-- **Current Capacity**: 20-30 hours/week for freelance projects
-- **Response Time**: Within 24 hours (usually faster)
-- **Timezone**: UTC-4 (flexible for meetings)
-- **Working Hours**: Flexible, can accommodate US/EU timezones
-
----
-
-## 🌟 Why Work With Me?
-
-### Technical Excellence
-- **Proven Track Record**: mcp-code-context has 1,000+ stars and 10,000+ downloads
-- **Production Experience**: Built systems that handle real-world scale
-- **Security-First**: Every project includes security review
-- **Performance-Focused**: Optimize for speed and cost
-
-### Communication
-- **Fluent English**: Clear, professional communication
-- **Responsive**: Quick replies, regular updates
-- **Transparent**: No surprises, honest timelines
-- **Collaborative**: Your input shapes the solution
-
-### Value
-- **Cost-Effective**: Based in Venezuela, competitive rates without compromising quality
-- **Efficient**: Years of experience = faster delivery
-- **Reliable**: Meet deadlines, deliver what's promised
-- **Long-Term**: Build relationships, not just projects
-
----
-
-## 📧 Contact
-
-**Email**: a.chataing.a@gmail.com  
-**GitHub**: [@achatainga](https://github.com/achatainga)  
-**Ko-fi**: [ko-fi.com/achatainga](https://ko-fi.com/achatainga)  
-**LinkedIn**: [linkedin.com](https://www.linkedin.com/in/alejandro-chataing-90205a1b1/)
-**Twitter/X**: [x.com/achatainga](https://x.com/achatainga)
-
----
-
-## 🚀 Let's Build Something Amazing
-
-Whether you need:
-- A custom MCP server for your workflow
-- AI integration for your product
-- Code review and optimization
-- Consulting on LLM cost reduction
-
-I'm here to help. Let's talk about your project.
-
-**Email me**: a.chataing.a@gmail.com
-
----
-
-*Looking for a developer who understands both the technical and economic constraints of AI development? You found the right person.*
-
-**Built with ❤️ from Caracas, Venezuela 🇻🇪**

package/SPONSORS.md

@@ -1,104 +0,0 @@
-# Sponsors & Supporters
-
-Thank you to everyone who supports mcp-code-context! 🙏
-
-Your contributions help keep this project:
-- ✅ Free and open source
-- ✅ Actively maintained
-- ✅ Continuously improved
-
----
-
-## 💎 Diamond Sponsors ($100+/month)
-
-*(No sponsors yet - be the first!)*
-
----
-
-## 🥇 Gold Sponsors ($50-99/month)
-
-*(No sponsors yet)*
-
----
-
-## 🥈 Silver Sponsors ($25-49/month)
-
-*(No sponsors yet)*
-
----
-
-## 🥉 Bronze Supporters ($5-24/month)
-
-*(No sponsors yet)*
-
----
-
-## ☕ One-Time Contributors
-
-*(No contributors yet - be the first!)*
-
----
-
-## 🌟 How to Become a Sponsor
-
-See the [Support This Project](#support-this-project) section in the [README](README.md#support-this-project).
-
-### Available Options:
-
-**Monthly Memberships** (Ko-fi):
-- **$5/month** - Supporter: Name in SPONSORS.md + Early access to release notes
-- **$25/month** - Contributor: Priority support + Early access to features + Vote on roadmap
-- **$100/month** - Sponsor: Feature requests + Monthly consultation + Logo in README
-
-**One-Time Donations**:
-- **Ko-fi**: https://ko-fi.com/achatainga
-- **PayPal**: https://paypal.me/achatainga
-- **Binance (USDT)**: See README for addresses
-
-- **TRC20**: `0xa68d53f7853ce0175eb96aaad4a30c068ca96444`
-- **ERC20**: `0xa68d53f7853ce0175eb96aaad4a30c068ca96444`
-- **Binance Pay ID**: `367669339`
-
----
-
-## 📊 Transparency Report
-
-### April 2025
-- **Monthly Donations**: $0
-- **One-Time Donations**: $0
-- **Total Supporters**: 0
-- **Expenses**: ~$20 (npm registry, testing credits, domain)
-- **Time Invested**: ~40 hours
-- **Net**: -$20
-
-*(Updated monthly)*
-
----
-
-## 💼 Hire Me
-
-Need custom MCP tools or AI integrations?
-
-- **Rate**: $50-75/hour
-- **Email**: a.chataing.a@gmail.com
-- **Details**: [HIRE_ME.md](HIRE_ME.md)
-
----
-
-## ❤️ Non-Financial Support
-
-Can't donate? No problem! You can still help:
-
-- ⭐ Star the repo on GitHub
-- 🐛 Report bugs or suggest features
-- 📝 Improve documentation
-- 🗣️ Share with others who might benefit
-- 💬 Help other users in discussions
-
-Every contribution matters, financial or not.
-
----
-
-**Thank you for supporting open source! 🚀**
-
-*Built with ❤️ from Caracas, Venezuela 🇻🇪*

package/vitest.config.ts

@@ -1,37 +0,0 @@
-import { defineConfig } from 'vitest/config';
-import path from 'path';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    reporters: ['default'],
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html'],
-      exclude: [
-        'node_modules/',
-        'dist/',
-        'dist-tests/',
-        '**/*.spec.ts',
-        '**/*.test.ts',
-        'tests/',
-        'scripts/'
-      ],
-      thresholds: {
-        lines: 80,
-        functions: 80,
-        branches: 75,
-        statements: 80
-      }
-    },
-    testTimeout: 60000,
-    hookTimeout: 60000,
-    outputTruncateLength: 80
-  },
-  resolve: {
-    alias: {
-      '@': path.resolve(__dirname, './src')
-    }
-  }
-});