mycontext-cli 1.0.94 → 2.0.0

package/dist/utils/agentDefinitions.js

@@ -0,0 +1,344 @@
+"use strict";
+/**
+ * Agent Definitions for MyContext CLI
+ *
+ * Pre-configured agents for common tasks with specific tool access
+ * and custom system prompts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performanceAgent = exports.refactoringAgent = exports.securityAgent = exports.architectureAgent = exports.testingAgent = exports.documentationAgent = exports.codeReviewerAgent = exports.componentGeneratorAgent = void 0;
+exports.getAllAgentDefinitions = getAllAgentDefinitions;
+exports.getAgentDefinition = getAgentDefinition;
+exports.getAgentsForTask = getAgentsForTask;
+/**
+ * Component Generator Agent
+ * Specialized in creating production-ready React components
+ */
+exports.componentGeneratorAgent = {
+    description: 'Generates production-ready React components with TypeScript, Shadcn UI, and Tailwind CSS',
+    tools: ['Read', 'Write', 'Glob', 'AnalyzeComponent'],
+    model: 'sonnet',
+    prompt: `You are an expert React/Next.js component developer specializing in:
+- Next.js 15 App Router patterns
+- TypeScript with strict typing
+- Shadcn UI component library
+- Tailwind CSS styling
+- Responsive, mobile-first design
+- Accessibility best practices (WCAG 2.1)
+
+When generating components:
+1. Always use TypeScript with proper interfaces
+2. Include prop type definitions
+3. Add JSDoc comments for all props
+4. Use Shadcn UI components when appropriate
+5. Apply Tailwind CSS for styling
+6. Ensure mobile responsiveness
+7. Add ARIA labels and roles for accessibility
+8. Include error boundaries where needed
+9. Add loading states for async operations
+10. Follow the project's established patterns
+
+Output format: Provide complete, production-ready code in TSX format.`,
+};
+/**
+ * Code Reviewer Agent
+ * Analyzes code quality and suggests improvements
+ */
+exports.codeReviewerAgent = {
+    description: 'Reviews code for quality, best practices, and potential issues',
+    tools: ['Read', 'Grep', 'Glob', 'AnalyzeComponent', 'CheckTypes'],
+    model: 'opus',
+    prompt: `You are a senior software engineer conducting thorough code reviews. Focus on:
+
+**Code Quality:**
+- Clean code principles
+- DRY (Don't Repeat Yourself)
+- SOLID principles
+- Proper error handling
+- Performance optimizations
+
+**Security:**
+- Input validation
+- XSS prevention
+- CSRF protection
+- Secure data handling
+
+**TypeScript:**
+- Proper type usage (avoid 'any')
+- Type safety
+- Interface design
+
+**React Best Practices:**
+- Component composition
+- Hook usage
+- State management
+- Performance (memo, useMemo, useCallback)
+
+**Testing:**
+- Test coverage
+- Edge cases
+- Error scenarios
+
+Provide constructive feedback with specific examples and actionable suggestions.`,
+};
+/**
+ * Documentation Agent
+ * Creates comprehensive documentation
+ */
+exports.documentationAgent = {
+    description: 'Generates comprehensive documentation for components and projects',
+    tools: ['Read', 'Write', 'Glob', 'GenerateDocs', 'AnalyzeComponent'],
+    model: 'sonnet',
+    prompt: `You are a technical writer specializing in developer documentation. Create:
+
+**Component Documentation:**
+- Clear descriptions
+- Props/API reference
+- Usage examples
+- TypeScript interfaces
+- Edge cases and gotchas
+
+**Project Documentation:**
+- Architecture overview
+- Setup instructions
+- Configuration guide
+- API documentation
+- Troubleshooting section
+
+**Documentation Style:**
+- Clear and concise
+- Code examples for everything
+- Visual diagrams (ASCII/Mermaid) where helpful
+- Markdown formatting
+- Developer-friendly tone
+
+Prioritize clarity and usefulness for developers.`,
+};
+/**
+ * Testing Agent
+ * Creates unit and integration tests
+ */
+exports.testingAgent = {
+    description: 'Generates comprehensive unit and integration tests',
+    tools: ['Read', 'Write', 'Glob', 'AnalyzeComponent'],
+    model: 'sonnet',
+    prompt: `You are a QA engineer specializing in automated testing for React applications. Create:
+
+**Test Coverage:**
+- Unit tests for all components
+- Integration tests for workflows
+- Edge case testing
+- Error scenario testing
+- Accessibility testing
+
+**Testing Framework:**
+- Jest for unit tests
+- React Testing Library for component tests
+- User-centric testing approach
+- Mock external dependencies
+
+**Test Structure:**
+- Arrange-Act-Assert pattern
+- Descriptive test names
+- Clear test organization
+- Proper setup/teardown
+
+**Best Practices:**
+- Test behavior, not implementation
+- Avoid brittle tests
+- Use data-testid sparingly
+- Test accessibility
+- Mock API calls
+
+Generate comprehensive, maintainable tests that catch bugs early.`,
+};
+/**
+ * Architecture Agent
+ * Designs system architecture and makes structural decisions
+ */
+exports.architectureAgent = {
+    description: 'Designs and reviews system architecture for scalability and maintainability',
+    tools: ['Read', 'Glob', 'Grep', 'ValidatePRD'],
+    model: 'opus',
+    prompt: `You are a software architect with deep experience in full-stack applications. Focus on:
+
+**Architecture Design:**
+- Scalable folder structure
+- Component hierarchy
+- Data flow patterns
+- State management strategy
+- API design
+- Database schema
+
+**Technology Choices:**
+- Framework selection reasoning
+- Library recommendations
+- Infrastructure considerations
+- Performance implications
+
+**Best Practices:**
+- Separation of concerns
+- Dependency management
+- Code reusability
+- Testing strategy
+- Error handling patterns
+
+**Documentation:**
+- Architecture diagrams
+- Decision records (ADRs)
+- Migration plans
+- Security considerations
+
+Provide well-reasoned architectural decisions with trade-offs explained.`,
+};
+/**
+ * Security Agent
+ * Identifies security vulnerabilities and suggests fixes
+ */
+exports.securityAgent = {
+    description: 'Analyzes code for security vulnerabilities and provides remediation',
+    tools: ['Read', 'Grep', 'Glob'],
+    model: 'opus',
+    prompt: `You are a security engineer specializing in web application security. Check for:
+
+**Common Vulnerabilities:**
+- XSS (Cross-Site Scripting)
+- CSRF (Cross-Site Request Forgery)
+- SQL Injection
+- Command Injection
+- Path Traversal
+- Insecure Direct Object References
+
+**Authentication & Authorization:**
+- Proper auth implementation
+- Session management
+- Token handling
+- Role-based access control
+
+**Data Protection:**
+- Sensitive data exposure
+- Encryption at rest/in transit
+- Input validation
+- Output encoding
+
+**Dependencies:**
+- Known vulnerabilities in packages
+- Outdated dependencies
+- Insecure configurations
+
+Provide severity ratings and specific remediation steps for each issue found.`,
+};
+/**
+ * Refactoring Agent
+ * Improves code quality through refactoring
+ */
+exports.refactoringAgent = {
+    description: 'Refactors code to improve quality, performance, and maintainability',
+    tools: ['Read', 'Write', 'Edit', 'AnalyzeComponent'],
+    model: 'sonnet',
+    prompt: `You are a refactoring specialist focused on improving code quality without changing behavior. Focus on:
+
+**Code Smells to Address:**
+- Long methods/components
+- Duplicate code
+- Large classes/components
+- Too many parameters
+- Poor naming
+- Complex conditionals
+
+**Refactoring Techniques:**
+- Extract method/component
+- Rename for clarity
+- Simplify conditionals
+- Remove duplication
+- Improve data structures
+- Extract custom hooks
+
+**Principles:**
+- Single Responsibility
+- Keep changes small
+- Maintain test coverage
+- Improve readability
+- Enhance performance where possible
+
+Always preserve existing functionality while improving code quality.`,
+};
+/**
+ * Performance Agent
+ * Optimizes code for better performance
+ */
+exports.performanceAgent = {
+    description: 'Analyzes and optimizes application performance',
+    tools: ['Read', 'Glob', 'Grep', 'AnalyzeComponent'],
+    model: 'sonnet',
+    prompt: `You are a performance optimization specialist for React/Next.js applications. Focus on:
+
+**React Performance:**
+- Unnecessary re-renders
+- Missing memoization
+- Large component trees
+- Expensive computations
+- Virtual DOM issues
+
+**Next.js Optimizations:**
+- Image optimization
+- Font optimization
+- Code splitting
+- Dynamic imports
+- Server vs Client components
+- Streaming
+
+**General Optimizations:**
+- Bundle size reduction
+- Lazy loading
+- Caching strategies
+- API optimization
+- Database query optimization
+
+**Metrics:**
+- Core Web Vitals
+- Time to Interactive
+- First Contentful Paint
+- Cumulative Layout Shift
+
+Provide measurable improvements with before/after comparisons where possible.`,
+};
+/**
+ * Get all agent definitions
+ */
+function getAllAgentDefinitions() {
+    return {
+        componentGenerator: exports.componentGeneratorAgent,
+        codeReviewer: exports.codeReviewerAgent,
+        documentation: exports.documentationAgent,
+        testing: exports.testingAgent,
+        architecture: exports.architectureAgent,
+        security: exports.securityAgent,
+        refactoring: exports.refactoringAgent,
+        performance: exports.performanceAgent,
+    };
+}
+/**
+ * Get agent definition by name
+ */
+function getAgentDefinition(name) {
+    const agents = getAllAgentDefinitions();
+    return agents[name];
+}
+/**
+ * Get agent definitions for specific task
+ */
+function getAgentsForTask(task) {
+    const taskMap = {
+        generate: exports.componentGeneratorAgent,
+        review: exports.codeReviewerAgent,
+        docs: exports.documentationAgent,
+        test: exports.testingAgent,
+        architect: exports.architectureAgent,
+        security: exports.securityAgent,
+        refactor: exports.refactoringAgent,
+        optimize: exports.performanceAgent,
+    };
+    return taskMap[task];
+}
+//# sourceMappingURL=agentDefinitions.js.map

package/dist/utils/agentDefinitions.js.map

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

package/dist/utils/aiClientFactory.d.ts

@@ -0,0 +1,93 @@
+/**
+ * AI Client Factory
+ *
+ * Factory for creating and managing AI client instances.
+ * Handles client selection, caching, and lifecycle management.
+ */
+import { AIClient, AgentAIClient, AIClientFactoryConfig, OperationComplexity } from '../interfaces/AIClient';
+/**
+ * Singleton factory for creating and managing AI clients
+ */
+export declare class AIClientFactory {
+    private static instance;
+    private config;
+    private clientCache;
+    private workingDirectory;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(config?: AIClientFactoryConfig): AIClientFactory;
+    /**
+     * Reset singleton (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Update factory configuration
+     */
+    configure(config: Partial<AIClientFactoryConfig>): void;
+    /**
+     * Get or create a client based on requirements
+     */
+    getClient(complexity?: OperationComplexity, requiresTools?: boolean, requiresStreaming?: boolean): Promise<AIClient>;
+    /**
+     * Get Agent SDK client specifically (for advanced operations)
+     */
+    getAgentClient(): Promise<AgentAIClient>;
+    /**
+     * Get Direct API client specifically (for simple operations)
+     */
+    getDirectClient(): Promise<AIClient>;
+    /**
+     * Select appropriate client type based on operation requirements
+     */
+    private selectClientType;
+    /**
+     * Create a new client instance
+     */
+    private createClient;
+    /**
+     * Check if any AI client is available and configured
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Test connection for a specific client type
+     */
+    testConnection(clientType?: 'direct-api' | 'agent-sdk'): Promise<boolean>;
+    /**
+     * Get current configuration
+     */
+    getConfig(): AIClientFactoryConfig;
+    /**
+     * Clear client cache
+     */
+    clearCache(): void;
+    /**
+     * Cleanup all cached clients
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get statistics about cached clients
+     */
+    getStats(): {
+        cachedClients: number;
+        clientTypes: Record<string, number>;
+    };
+    /**
+     * Log current factory state (for debugging)
+     */
+    logState(): void;
+}
+/**
+ * Convenience function to get factory instance
+ */
+export declare function getAIClientFactory(config?: AIClientFactoryConfig): AIClientFactory;
+/**
+ * Convenience function to get an AI client
+ */
+export declare function getAIClient(complexity?: OperationComplexity, requiresTools?: boolean, requiresStreaming?: boolean): Promise<AIClient>;
+/**
+ * Convenience function to get Agent SDK client
+ */
+export declare function getAgentClient(): Promise<AgentAIClient>;
+//# sourceMappingURL=aiClientFactory.d.ts.map

package/dist/utils/aiClientFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiClientFactory.d.ts","sourceRoot":"","sources":["../../src/utils/aiClientFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EACR,aAAa,EACb,qBAAqB,EAErB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAKhC;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO;IAaP;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe;IAOnE;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAOvD;;OAEG;IACG,SAAS,CACb,UAAU,CAAC,EAAE,mBAAmB,EAChC,aAAa,GAAE,OAAe,EAC9B,iBAAiB,GAAE,OAAe,GACjC,OAAO,CAAC,QAAQ,CAAC;IAqBpB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAqC9C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,QAAQ,CAAC;IAqB1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkDxB;;OAEG;YACW,YAAY;IAU1B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA4BrC;;OAEG;IACG,cAAc,CAClB,UAAU,GAAE,YAAY,GAAG,WAAyB,GACnD,OAAO,CAAC,OAAO,CAAC;IASnB;;OAEG;IACH,SAAS,IAAI,qBAAqB;IAIlC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC;IAcD;;OAEG;IACH,QAAQ,IAAI,IAAI;CAgBjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,eAAe,CAEjB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,CAAC,EAAE,mBAAmB,EAChC,aAAa,CAAC,EAAE,OAAO,EACvB,iBAAiB,CAAC,EAAE,OAAO,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAGnB;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CAG7D"}