atlas-pipeline-mcp 1.0.23 → 1.0.26

package/dist/tools/senior-mentor.js

@@ -0,0 +1,308 @@
+/**
+ * Atlas Server - Senior Developer Mentor Tool
+ *
+ * Helps junior/mid-level developers think like senior engineers
+ * - Architectural decision analysis
+ * - Code design patterns and trade-offs
+ * - Performance optimization strategies
+ * - Best practices and conventions
+ * - Technical debt assessment
+ *
+ * @module senior-mentor
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+import { getActiveProvider, isNoLLMMode } from '../providers/index.js';
+import { logger, createTimer } from '../utils.js';
+import { z } from 'zod';
+// ============================================================================
+// Validation Schema
+// ============================================================================
+const SeniorMentorRequestSchema = z.object({
+    problem: z.string().min(20).max(2000),
+    context: z.string().optional(),
+    code: z.string().optional(),
+    language: z.string().optional(),
+    framework: z.string().optional(),
+    constraints: z.array(z.string()).optional(),
+    desiredOutcome: z.string().optional(),
+    currentApproach: z.string().optional(),
+});
+// ============================================================================
+// Senior Mentor Analysis
+// ============================================================================
+/**
+ * Analyze a problem from a senior developer's perspective
+ */
+export async function getMentorAnalysis(request) {
+    const timer = createTimer();
+    SeniorMentorRequestSchema.parse(request);
+    logger.info({ problem: request.problem.substring(0, 100) }, 'Starting senior mentor analysis');
+    const analysis = await analyzeArchitecture(request);
+    const lessons = generateSeniorLessons(analysis);
+    const actionItems = createActionPlan(analysis);
+    const recommendations = getReadingList(request);
+    logger.info({ analysisTimeMs: timer.elapsed() }, 'Mentor analysis complete');
+    return {
+        analysis,
+        seniorLessons: lessons,
+        actionItems,
+        readingRecommendations: recommendations,
+        generatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Analyze architectural decisions from senior perspective
+ */
+async function analyzeArchitecture(request) {
+    if (!isNoLLMMode()) {
+        try {
+            return await analyzeWithAI(request);
+        }
+        catch (error) {
+            logger.warn({ error }, 'AI analysis failed, using heuristic approach');
+            return generateHeuristicAnalysis(request);
+        }
+    }
+    return generateHeuristicAnalysis(request);
+}
+/**
+ * AI-powered senior perspective analysis
+ */
+async function analyzeWithAI(request) {
+    const provider = await getActiveProvider();
+    const prompt = `You are an extremely experienced senior frontend developer with 15+ years of experience.
+Analyze this problem from a senior perspective:
+
+Problem: ${request.problem}
+
+${request.currentApproach ? `Current Approach: ${request.currentApproach}` : ''}
+${request.code ? `Code:\n${request.code}` : ''}
+${request.context ? `Context: ${request.context}` : ''}
+${request.constraints?.length ? `Constraints:\n${request.constraints.join('\n')}` : ''}
+
+Provide:
+1. Assessment of current approach (if provided)
+2. Key architectural issues
+3. 3-5 alternative approaches with pros/cons
+4. Recommended path forward
+5. Senior reasoning for the recommendation
+
+Focus on:
+- Scalability and maintainability
+- Team velocity and developer experience
+- Long-term technical debt implications
+- Industry best practices
+- Real-world trade-offs`;
+    const result = await provider.completeJson(prompt);
+    if (result.data) {
+        return result.data;
+    }
+    return generateHeuristicAnalysis(request);
+}
+/**
+ * Heuristic-based analysis (no LLM)
+ */
+function generateHeuristicAnalysis(request) {
+    const issues = [];
+    // Detect common junior developer mistakes
+    if (request.currentApproach?.toLowerCase().includes('callback')) {
+        issues.push({
+            severity: 'major',
+            title: 'Callback Hell Pattern',
+            explanation: 'Deeply nested callbacks make code hard to read and maintain.',
+            longTermImpact: 'Will cause refactoring pain as codebase grows',
+        });
+    }
+    if (request.currentApproach?.toLowerCase().includes('global') ||
+        request.currentApproach?.toLowerCase().includes('window.')) {
+        issues.push({
+            severity: 'critical',
+            title: 'Global State Management',
+            explanation: 'Global variables create hidden dependencies and make testing difficult.',
+            longTermImpact: 'Hard to test, debug, and scale. Creates tight coupling.',
+        });
+    }
+    if (request.code?.includes('any')) {
+        issues.push({
+            severity: 'major',
+            title: 'Type Looseness (any)',
+            explanation: 'Using "any" defeats the purpose of TypeScript.',
+            longTermImpact: 'Loses type safety benefits and makes refactoring risky.',
+        });
+    }
+    const approaches = [
+        {
+            name: 'Modern Async Patterns',
+            description: 'Use async/await instead of callbacks or promises',
+            pros: [
+                'More readable and maintainable',
+                'Better error handling with try-catch',
+                'Similar to synchronous code structure',
+                'Easier to debug',
+            ],
+            cons: [
+                'Requires understanding of event loop',
+                'Can lead to sequential execution when parallel is needed',
+            ],
+            complexity: 'low',
+            scalability: 'excellent',
+            maintainability: 'excellent',
+            seniorRating: 9,
+        },
+        {
+            name: 'State Management Library',
+            description: 'Use Redux, Zustand, or Jotai for predictable state',
+            pros: [
+                'Single source of truth',
+                'Time-travel debugging',
+                'Testable state logic',
+                'Developer tools available',
+            ],
+            cons: [
+                'Initial boilerplate',
+                'Learning curve',
+                'Can be overkill for small apps',
+            ],
+            complexity: 'medium',
+            scalability: 'excellent',
+            maintainability: 'excellent',
+            seniorRating: 8,
+        },
+    ];
+    return {
+        currentApproach: request.currentApproach || 'Not specified',
+        issues,
+        seniorPerspective: 'Think long-term: what will this look like when the codebase is 10x larger?',
+        alternativeApproaches: approaches,
+        recommendedPath: 'Modern async patterns with proper state management',
+        reasoning: 'Balances readability, testability, and scalability',
+    };
+}
+/**
+ * Generate senior developer lessons
+ */
+function generateSeniorLessons(analysis) {
+    return [
+        {
+            title: 'Think in Systems, Not Features',
+            lesson: 'Senior developers design systems that can evolve. They ask: "How will this scale to 100 developers?" not "Does this work today?"',
+            realWorldExample: 'Instead of just building a component, design a component system with hooks, patterns, and conventions that others can follow.',
+            whenToApply: 'Every architectural decision. Always think 3-5 years ahead.',
+        },
+        {
+            title: 'Trade-offs Over Silver Bullets',
+            lesson: 'There is no perfect solution. Good architecture is about making informed trade-offs and documenting them.',
+            realWorldExample: 'Redux adds complexity but gives you time-travel debugging and predictability. The trade-off is worth it for large teams.',
+            whenToApply: 'When evaluating solutions, list pros/cons and discuss with team.',
+        },
+        {
+            title: 'DRY is Not Always Right',
+            lesson: 'Avoid premature abstraction. Three instances means you might need a helper. Two instances might just be coincidence.',
+            realWorldExample: 'Extracting too early creates abstractions that hide important differences and become hard to maintain.',
+            whenToApply: 'When refactoring, wait for the third similar pattern before abstracting.',
+        },
+        {
+            title: 'Testability is a Design Metric',
+            lesson: 'If code is hard to test, it is usually badly designed. Use testability as feedback for architecture.',
+            realWorldExample: 'Complex components that are hard to test usually have too many responsibilities. Break them into smaller pieces.',
+            whenToApply: 'When writing code, write tests first. If tests are hard to write, redesign.',
+        },
+        {
+            title: 'Communicate Constraints',
+            lesson: 'Senior developers explicitly state constraints and assumptions. This prevents misunderstandings later.',
+            realWorldExample: 'Document: "This component assumes items are immutable" or "Performance budget: < 100ms"',
+            whenToApply: 'In code comments, PR descriptions, and architecture documents.',
+        },
+    ];
+}
+/**
+ * Create actionable next steps
+ */
+function createActionPlan(analysis) {
+    return [
+        {
+            priority: 'high',
+            action: 'Refactor critical paths first',
+            expectedBenefit: 'Reduce bugs and improve maintainability in high-impact areas',
+            estimatedEffort: '1-2 weeks',
+            timeline: 'Next sprint',
+        },
+        {
+            priority: 'high',
+            action: 'Add comprehensive test coverage',
+            expectedBenefit: 'Prevent regressions and enable safer refactoring',
+            estimatedEffort: '2-3 weeks',
+            timeline: 'Next 2 sprints',
+        },
+        {
+            priority: 'medium',
+            action: 'Document architecture decisions',
+            expectedBenefit: 'New team members understand rationale, reduce repeated discussions',
+            estimatedEffort: '3-5 days',
+            timeline: 'This week',
+        },
+        {
+            priority: 'medium',
+            action: 'Establish code review process',
+            expectedBenefit: 'Share knowledge across team, maintain consistency',
+            estimatedEffort: '2 days setup',
+            timeline: 'Start immediately',
+        },
+        {
+            priority: 'low',
+            action: 'Create internal knowledge base',
+            expectedBenefit: 'Accelerate onboarding, reduce context switching',
+            estimatedEffort: '4-6 weeks',
+            timeline: 'Ongoing effort',
+        },
+    ];
+}
+/**
+ * Recommend learning resources
+ */
+function getReadingList(request) {
+    const recommendations = [
+        {
+            title: 'Software Architecture Patterns',
+            author: 'Mark Richards',
+            type: 'book',
+            relevance: 10,
+            url: 'https://www.oreilly.com/library/view/software-architecture-patterns/9781491971437/',
+        },
+        {
+            title: 'Designing Data-Intensive Applications',
+            author: 'Martin Kleppmann',
+            type: 'book',
+            relevance: 9,
+            url: 'https://dataintensive.net/',
+        },
+        {
+            title: 'The Pragmatic Programmer',
+            author: 'David Thomas & Andrew Hunt',
+            type: 'book',
+            relevance: 9,
+        },
+        {
+            title: 'Thinking in Systems',
+            author: 'Donella Meadows',
+            type: 'book',
+            relevance: 8,
+        },
+    ];
+    // Add framework-specific resources
+    if (request.framework?.toLowerCase().includes('react')) {
+        recommendations.push({
+            title: 'Advanced React Patterns',
+            type: 'course',
+            relevance: 8,
+            url: 'https://epicreact.dev/',
+        });
+    }
+    return recommendations;
+}
+// ============================================================================
+// Export
+// ============================================================================
+export default getMentorAnalysis;
+//# sourceMappingURL=senior-mentor.js.map

package/dist/tools/senior-mentor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"senior-mentor.js","sourceRoot":"","sources":["../../src/tools/senior-mentor.ts"],"names":[],"mappings":"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"}

package/dist/tools/state-management-architect.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Atlas Server - State Management Architect
+ *
+ * Advanced state management analysis and recommendations
+ * - State structure analysis
+ * - Performance optimization for state
+ * - Scalability assessment
+ * - State management pattern recommendations
+ * - Redux/Zustand/Recoil comparison
+ * - Memory leak detection
+ *
+ * @module state-management-architect
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+export interface StateManagementRequest {
+    currentImplementation?: string;
+    stateSize?: number;
+    updateFrequency?: 'high' | 'medium' | 'low';
+    teamSize?: number;
+    appComplexity?: 'simple' | 'medium' | 'complex' | 'enterprise';
+    performanceIssues?: string[];
+    code?: string;
+    goals?: string[];
+}
+export interface StateManagementAnalysis {
+    currentState: string;
+    issues: StateIssue[];
+    recommendations: StateRecommendation[];
+    patternComparison: PatternComparison[];
+    implementation: ImplementationGuide;
+    expectedImprovements: Improvement[];
+}
+export interface StateIssue {
+    category: string;
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    issue: string;
+    impact: string;
+    affectedComponents: string[];
+}
+export interface StateRecommendation {
+    pattern: string;
+    rationale: string;
+    implementation: string;
+    pros: string[];
+    cons: string[];
+    scalability: 'poor' | 'fair' | 'good' | 'excellent';
+    teamComplexity: 'low' | 'medium' | 'high';
+    performanceRating: number;
+}
+export interface PatternComparison {
+    pattern: string;
+    bundleSize: string;
+    boilerplate: 'low' | 'medium' | 'high';
+    learningCurve: 'low' | 'medium' | 'high';
+    devExperience: string;
+    bestFor: string;
+    suitability: number;
+}
+export interface ImplementationGuide {
+    steps: string[];
+    timeline: string;
+    risks: string[];
+    mitigations: string[];
+}
+export interface Improvement {
+    metric: string;
+    currentValue?: string;
+    expectedValue?: string;
+    improvement: string;
+}
+/**
+ * Analyze and architect state management solution
+ */
+export declare function analyzeStateManagement(request: StateManagementRequest): Promise<StateManagementAnalysis>;
+export default analyzeStateManagement;
+//# sourceMappingURL=state-management-architect.d.ts.map

package/dist/tools/state-management-architect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-management-architect.d.ts","sourceRoot":"","sources":["../../src/tools/state-management-architect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IAC/D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;IACvC,cAAc,EAAE,mBAAmB,CAAC;IACpC,oBAAoB,EAAE,WAAW,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IACpD,cAAc,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAqBD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CA0BlC;AAqSD,eAAe,sBAAsB,CAAC"}