atlas-pipeline-mcp 1.0.21 → 1.0.23

package/README.md

@@ -1,45 +1,129 @@
+# Atlas MCP Server
 
-# Atlas MCP Server (`atlas-pipeline-mcp`)
+<div align="center">
 
-**The Agentic AI Pipeline for your IDE.**
-Works natively with **Cursor**, **GitHub Copilot**, **Windsurf**, and **VS Code**.
+[![npm version](https://img.shields.io/npm/v/atlas-pipeline-mcp.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/atlas-pipeline-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/atlas-pipeline-mcp.svg?style=flat-square&color=green)](https://www.npmjs.com/package/atlas-pipeline-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-18+-green?style=flat-square&logo=node.js)](https://nodejs.org/)
 
-Atlas is an MCP server that gives your IDE "Agentic Superpowers". Instead of just creating code, it enables a full analysis pipeline:
-**Intent → Context → Decomposition → Variants → Critique → Optimization**.
+**The Agentic AI Pipeline for your IDE**
+
+Advanced AI/ML-powered development tools with RAG search, ML bug prediction, intelligent code migration, and comprehensive test generation.
+
+[Installation](#installation-1-click-setup) • [Features](#key-features) • [Tools](#all-available-tools-17-total) • [Usage](#how-to-use-cheat-sheet) • [Documentation](#advanced-integration-optional)
+
+</div>
 
 ---
 
-## 🚀 What's New in v1.0.19
+## Overview
+
+Atlas MCP Server gives your IDE "Agentic Superpowers" through a full analysis pipeline:
+
+**Intent → Context → Decomposition → Variants → Critique → Optimization**
 
-**Performance Optimizations:**
-- ⚡ **LRU Cache** - Intelligent caching for LLM responses and pipeline results
-- 🔄 **Request Deduplication** - Prevents duplicate concurrent API calls
-- 📊 **Metrics Collection** - Built-in performance monitoring with P50/P95/P99 stats
-- 🔒 **Circuit Breaker** - Resilient provider connections with automatic recovery
-- 🧹 **Session Management** - Automatic cleanup of stale thinking sessions
-- 🚀 **Parallel Execution** - Independent pipeline stages run concurrently
+Works natively with **Cursor**, **Windsurf**, **Claude Desktop**, **GitHub Copilot**, and **VS Code**.
+
+---
+
+---
 
-**All 15 Powerful Tools:**
-- 🔒 **atlas_security** - Scan code for vulnerabilities (SQL injection, XSS, secrets, etc.)
-- 🧪 **atlas_test** - Auto-generate comprehensive test cases
-- 📚 **atlas_docs** - Generate documentation (JSDoc, TSDoc, PyDoc)
-- 💡 **atlas_explain** - Explain code with complexity analysis & design patterns
-- 🐛 **atlas_debug** - Debug errors with root cause analysis & fix suggestions
-- 🧠 **atlas_think** - Advanced sequential reasoning with branching & verification
+## ✨ What's New in v1.0.23
+
+### Advanced AI/ML Tools (4 New)
+
+<table>
+<tr>
+<td width="25%"><b>RAG Search</b></td>
+<td>Semantic code search with knowledge graphs and natural language queries</td>
+</tr>
+<tr>
+<td><b>ML Predictor</b></td>
+<td>Bug & performance prediction with 70-85% accuracy using machine learning</td>
+</tr>
+<tr>
+<td><b>Code Migration</b></td>
+<td>Intelligent migration (12 types: JS→TS, React upgrades, Callbacks→Async)</td>
+</tr>
+<tr>
+<td><b>Test Generator</b></td>
+<td>Advanced test generation with edge cases, mocks, and property-based testing</td>
+</tr>
+</table>
+
+### Core Professional Tools (13)
+
+<table>
+<tr>
+<td width="25%"><b>Refactor</b></td>
+<td>Code refactoring engine with complexity analysis</td>
+</tr>
+<tr>
+<td><b>Profiler</b></td>
+<td>Performance profiling & bottleneck detection (O(n), O(n²), etc.)</td>
+</tr>
+<tr>
+<td><b>Review</b></td>
+<td>Automated code review with quality scores and security checks</td>
+</tr>
+<tr>
+<td><b>Dependencies</b></td>
+<td>Dependency analysis, unused package detection, vulnerability scanning</td>
+</tr>
+<tr>
+<td><b>Dashboard</b></td>
+<td>Interactive HTML metrics dashboards with real-time data</td>
+</tr>
+<tr>
+<td><b>Security</b></td>
+<td>Security vulnerability scanning (CWE, OWASP standards)</td>
+</tr>
+<tr>
+<td><b>Test Gen</b></td>
+<td>Comprehensive test case generation (Jest, Vitest, Pytest, Mocha)</td>
+</tr>
+<tr>
+<td><b>Docs Gen</b></td>
+<td>Auto-generate documentation (JSDoc, TSDoc, PyDoc)</td>
+</tr>
+</table>
 
 ---
 
-## Key Features
+## 🎯 Key Features
 
-- **Zero Config**: No API keys required. It uses your IDE's built-in AI (Copilot/Cursor) for analysis.
-- **Agentic Workflow**: Breaks down specific tasks into a DAG (Directed Acyclic Graph) of subtasks.
-- **Optimization Loop**: Generates variants, critiques them, and produces a final optimized solution.
-- **Context Aware**: Deeply analyzes project structure, file dependencies, and git history.
-- **Security Scanner**: Detects vulnerabilities with CWE IDs and OWASP categories.
-- **Test Generator**: Creates unit/integration tests for Jest, Vitest, Pytest, Mocha.
-- **Smart Debugging**: Analyzes errors, parses stack traces, suggests fixes.
-- **Sequential Thinking**: Advanced reasoning with branching, revision, and hypothesis verification.
-- **High Performance**: LRU caching, request deduplication, and parallel execution.
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🤖 AI/ML Capabilities
+- **RAG Search** - Semantic code understanding with knowledge graphs
+- **ML Prediction** - Bug & performance forecasting (70-85% accuracy)
+- **Code Migration** - 12 intelligent migration types
+- **Test Generation** - Advanced test suites with edge cases
+
+</td>
+<td width="50%" valign="top">
+
+### ⚡ Professional Tools
+- **Full Pipeline** - Intent → Context → Variants → Optimize
+- **Quality Analysis** - Code review, security, complexity
+- **Performance** - Profiling, bottleneck detection
+- **Automation** - Tests, docs, refactoring
+
+</td>
+</tr>
+</table>
+
+### 🌟 Why Atlas?
+
+- **Zero Config**: No API keys required - uses your IDE's built-in AI (Copilot/Cursor)
+- **17 Professional Tools**: 13 core + 4 advanced AI/ML capabilities
+- **Agentic Workflow**: DAG-based task decomposition
+- **Context Aware**: Project structure, dependencies, git history analysis
+- **High Performance**: LRU caching, request deduplication, parallel execution
 
 ---
 
@@ -64,25 +148,128 @@ Restart your editor. You should see the Atlas server connected in your MCP setti
 
 ---
 
-## All Available Tools (15 Total)
-
-| Tool | Description |
-| :--- | :--- |
-| `atlas_pipeline` | Full agentic pipeline: Intent → Context → Decompose → Variants → Critique → Optimize |
-| `atlas_intent` | Analyze user intent from natural language |
-| `atlas_context` | Gather project context, dependencies, and structure |
-| `atlas_git` | Analyze Git history, branches, and file changes |
-| `atlas_decompose` | Break down complex tasks into subtasks (DAG) |
-| `atlas_variants` | Generate multiple solution approaches |
-| `atlas_critique` | Review code for quality, security, best practices |
-| `atlas_optimize` | Optimize code based on feedback |
-| `atlas_security` | Scan for security vulnerabilities (CWE, OWASP) |
-| `atlas_test` | Generate comprehensive test cases |
-| `atlas_docs` | Generate documentation (JSDoc/TSDoc/PyDoc) |
-| `atlas_explain` | Explain code with complexity & pattern analysis |
-| `atlas_debug` | Debug errors with root cause analysis |
-| `atlas_think` | Advanced sequential reasoning with branching |
-| `atlas_providers` | Check LLM provider status |
+## 🛠️ All Available Tools (17 Total)
+
+### 🔥 Advanced AI/ML Tools
+
+<table>
+<tr>
+<td width="30%"><code>atlas_rag_search</code></td>
+<td><b>RAG-Powered Semantic Search</b><br/>Natural language code search with knowledge graphs. Ask "how does auth work?" and get contextual results.</td>
+</tr>
+<tr>
+<td><code>atlas_ml_predict</code></td>
+<td><b>ML Bug & Performance Prediction</b><br/>Predict bugs before production with 70-85% accuracy. Analyzes complexity, churn, and code patterns.</td>
+</tr>
+<tr>
+<td><code>atlas_migrate</code></td>
+<td><b>Intelligent Code Migration</b><br/>Automated migration support for 12 types: JS→TS, React upgrades, Callbacks→Async, and more.</td>
+</tr>
+<tr>
+<td><code>atlas_testgen_advanced</code></td>
+<td><b>Advanced Test Generation</b><br/>Generate comprehensive test suites with edge cases, mocks, stubs, and 90%+ coverage projection.</td>
+</tr>
+</table>
+
+### ⚡ Core Pipeline & Analysis Tools
+
+<table>
+<tr>
+<td width="30%"><code>atlas_pipeline</code></td>
+<td><b>Full Agentic Pipeline</b><br/>Complete workflow: Intent → Context → Decompose → Variants → Critique → Optimize</td>
+</tr>
+<tr>
+<td><code>atlas_intent</code></td>
+<td><b>Intent Analysis</b><br/>Extract actionable intent from natural language requests</td>
+</tr>
+<tr>
+<td><code>atlas_context</code></td>
+<td><b>Project Context Gathering</b><br/>Analyze project structure, dependencies, and file relationships</td>
+</tr>
+<tr>
+<td><code>atlas_git</code></td>
+<td><b>Git History Analysis</b><br/>Analyze commits, branches, file changes, and code evolution</td>
+</tr>
+<tr>
+<td><code>atlas_decompose</code></td>
+<td><b>Task Decomposition</b><br/>Break complex tasks into DAG (Directed Acyclic Graph) of subtasks</td>
+</tr>
+<tr>
+<td><code>atlas_variants</code></td>
+<td><b>Solution Variants</b><br/>Generate multiple implementation approaches with pros/cons analysis</td>
+</tr>
+</table>
+
+### 🎯 Quality & Optimization Tools
+
+<table>
+<tr>
+<td width="30%"><code>atlas_review</code></td>
+<td><b>Automated Code Review</b><br/>Comprehensive analysis with quality scores, security checks, and best practice validation</td>
+</tr>
+<tr>
+<td><code>atlas_critique</code></td>
+<td><b>Code Critique</b><br/>Deep review for quality, security, performance, and maintainability</td>
+</tr>
+<tr>
+<td><code>atlas_optimize</code></td>
+<td><b>Code Optimization</b><br/>Apply improvements based on critique feedback and best practices</td>
+</tr>
+<tr>
+<td><code>atlas_refactor</code></td>
+<td><b>Smart Refactoring</b><br/>Code restructuring with complexity metrics and structural analysis</td>
+</tr>
+<tr>
+<td><code>atlas_security</code></td>
+<td><b>Security Scanner</b><br/>Detect vulnerabilities with CWE IDs and OWASP category mapping</td>
+</tr>
+</table>
+
+### 🚀 Development Productivity Tools
+
+<table>
+<tr>
+<td width="30%"><code>atlas_profiler</code></td>
+<td><b>Performance Profiling</b><br/>Detect bottlenecks, analyze time complexity (O(n), O(n²)), and memory usage</td>
+</tr>
+<tr>
+<td><code>atlas_test</code></td>
+<td><b>Test Case Generation</b><br/>Generate comprehensive tests for Jest, Vitest, Pytest, Mocha</td>
+</tr>
+<tr>
+<td><code>atlas_docs</code></td>
+<td><b>Auto Documentation</b><br/>Generate JSDoc, TSDoc, or PyDoc documentation automatically</td>
+</tr>
+<tr>
+<td><code>atlas_dependencies</code></td>
+<td><b>Dependency Analysis</b><br/>Detect unused packages, analyze dependencies, scan for vulnerabilities</td>
+</tr>
+<tr>
+<td><code>atlas_dashboard</code></td>
+<td><b>Metrics Dashboard</b><br/>Generate interactive HTML dashboards with real-time metrics</td>
+</tr>
+<tr>
+<td><code>atlas_explain</code></td>
+<td><b>Code Explanation</b><br/>Explain code with complexity analysis and pattern detection</td>
+</tr>
+<tr>
+<td><code>atlas_debug</code></td>
+<td><b>Smart Debugging</b><br/>Root cause analysis, stack trace parsing, and fix suggestions</td>
+</tr>
+<tr>
+<td><code>atlas_think</code></td>
+<td><b>Advanced Reasoning</b><br/>Sequential reasoning with branching logic for complex problems</td>
+</tr>
+</table>
+
+### 🔧 Utility Tools
+
+<table>
+<tr>
+<td width="30%"><code>atlas_providers</code></td>
+<td><b>Provider Status</b><br/>Check available LLM providers and their current status</td>
+</tr>
+</table>
 
 ---
 
@@ -90,9 +277,22 @@ Restart your editor. You should see the Atlas server connected in your MCP setti
 
 Once installed, simply chat with your AI Assistant (Copilot Chat or Cursor Chat). The server automatically activates based on your intent.
 
+### Advanced AI/ML Tools
+| Goal | What to Ask | Tool Used |
+| :--- | :--- | :--- |
+| **Semantic Code Search** | "Search for authentication code using RAG" | `atlas_rag_search` |
+| **Predict Bugs** | "Predict bug probability in payment-processor.ts" | `atlas_ml_predict` |
+| **Migrate Codebase** | "Migrate this file from JavaScript to TypeScript" | `atlas_migrate` |
+| **Advanced Testing** | "Generate comprehensive tests with edge cases" | `atlas_testgen_advanced` |
+
+### Professional Development Tools
 | Goal | What to Ask | Tool Used |
 | :--- | :--- | :--- |
 | **Fix a complex file** | "Run the **pipeline** on `utils.ts` to refactor it." | `atlas_pipeline` |
+| **Refactor Code** | "Refactor this code and reduce complexity" | `atlas_refactor` |
+| **Performance Analysis** | "Profile this code for performance bottlenecks" | `atlas_profiler` |
+| **Code Review** | "Review this PR for quality and security" | `atlas_review` |
+| **Check Dependencies** | "Analyze dependencies and find unused packages" | `atlas_dependencies` |
 | **Plan a feature** | "**Decompose** the task of adding JWT auth." | `atlas_decompose` |
 | **Explore ideas** | "Generate **3 variants** for this button component." | `atlas_variants` |
 | **Review Code** | "**Critique** this code for security issues." | `atlas_critique` |

package/dist/tools/advanced-testgen.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Atlas Server - AI-Powered Test Generation Engine
+ *
+ * Advanced test generation with AI/ML:
+ * - Unit test generation with edge cases
+ * - Integration test scaffolding
+ * - E2E test generation
+ * - Property-based testing
+ * - Mutation testing
+ * - Test data generation (realistic, edge cases, boundary values)
+ * - Mock/stub generation
+ * - Test coverage analysis & gap detection
+ * - Regression test selection
+ * - Visual regression tests
+ * - Performance test generation
+ * - Security test cases
+ *
+ * @module advanced-testgen
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+export interface TestGenOptions {
+    projectPath: string;
+    sourceFile: string;
+    testTypes?: TestType[];
+    framework?: TestFramework;
+    coverageGoal?: number;
+    includeEdgeCases?: boolean;
+    includeMocks?: boolean;
+    includeIntegration?: boolean;
+    useAI?: boolean;
+    creativity?: number;
+}
+export type TestType = 'unit' | 'integration' | 'e2e' | 'property' | 'mutation' | 'performance' | 'security' | 'visual';
+export type TestFramework = 'jest' | 'vitest' | 'mocha' | 'pytest' | 'junit' | 'cypress' | 'playwright';
+export interface TestGenResult {
+    sourceFile: string;
+    testFile: string;
+    framework: TestFramework;
+    tests: GeneratedTest[];
+    mocks: GeneratedMock[];
+    fixtures: TestFixture[];
+    coverage: CoverageAnalysis;
+    recommendations: string[];
+    generationTimeMs: number;
+}
+export interface GeneratedTest {
+    name: string;
+    type: TestType;
+    description: string;
+    code: string;
+    targetFunction: string;
+    testCase: TestCase;
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    confidence: number;
+}
+export interface TestCase {
+    scenario: string;
+    inputs: any[];
+    expectedOutput: any;
+    assertions: string[];
+    setup?: string;
+    teardown?: string;
+}
+export interface GeneratedMock {
+    name: string;
+    type: 'mock' | 'stub' | 'spy';
+    target: string;
+    code: string;
+}
+export interface TestFixture {
+    name: string;
+    data: any;
+    description: string;
+}
+export interface CoverageAnalysis {
+    currentCoverage: number;
+    projectedCoverage: number;
+    gaps: CoverageGap[];
+    recommendations: string[];
+}
+export interface CoverageGap {
+    location: string;
+    type: 'branch' | 'statement' | 'function';
+    reason: string;
+    suggestedTest: string;
+}
+/**
+ * Generate comprehensive tests for source file
+ */
+export declare function generateTests(options: TestGenOptions): Promise<TestGenResult>;
+export default generateTests;
+//# sourceMappingURL=advanced-testgen.d.ts.map

package/dist/tools/advanced-testgen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-testgen.d.ts","sourceRoot":"","sources":["../../src/tools/advanced-testgen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAYH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAG7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,aAAa,GACb,KAAK,GACL,UAAU,GACV,UAAU,GACV,aAAa,GACb,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,YAAY,CAAC;AAEjB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IAEzB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IAGb,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IAEnB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,cAAc,EAAE,GAAG,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AA8RD;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAwJnF;AAMD,eAAe,aAAa,CAAC"}