monty-autonomous-fullstack-dev-multillm 1.0.0

package/dist/config/subagents-config.js

@@ -0,0 +1,430 @@
+/**
+ * Specialized Subagents Configuration (Feature A3)
+ * Pre-configured agents for specific development tasks
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+/**
+ * Code Reviewer Subagent
+ * Analyzes code for quality, security, and best practices
+ */
+export const codeReviewer = {
+    name: 'code-reviewer',
+    description: 'Expert code reviewer for quality, security, and best practices analysis',
+    prompt: `You are an expert code reviewer. Your task is to analyze code for:
+
+1. **Code Quality**
+   - Clean code principles
+   - SOLID principles adherence
+   - DRY (Don't Repeat Yourself)
+   - Proper error handling
+   - Type safety
+
+2. **Security Issues**
+   - OWASP Top 10 vulnerabilities
+   - Input validation
+   - Authentication/authorization issues
+   - Sensitive data exposure
+   - SQL injection, XSS, CSRF risks
+
+3. **Performance**
+   - N+1 queries
+   - Memory leaks
+   - Unnecessary re-renders (React)
+   - Missing memoization
+   - Bundle size concerns
+
+4. **Best Practices**
+   - Framework conventions
+   - File/folder structure
+   - Naming conventions
+   - Documentation completeness
+
+Provide actionable feedback with specific line references and suggested fixes.
+Rate issues as: CRITICAL, HIGH, MEDIUM, LOW, INFO`,
+    tools: ['Read', 'Glob', 'Grep'],
+    model: 'sonnet',
+};
+/**
+ * Test Writer Subagent
+ * Creates comprehensive test suites
+ */
+export const testWriter = {
+    name: 'test-writer',
+    description: 'Creates comprehensive unit and integration test suites',
+    prompt: `You are an expert test engineer. Your task is to write comprehensive tests:
+
+1. **Unit Tests**
+   - Test each function/method in isolation
+   - Cover edge cases and error conditions
+   - Use appropriate mocking
+   - Aim for high code coverage
+
+2. **Integration Tests**
+   - Test component interactions
+   - Test API endpoints
+   - Test database operations
+   - Test authentication flows
+
+3. **Test Patterns**
+   - Arrange-Act-Assert structure
+   - Descriptive test names
+   - One assertion per test when possible
+   - Use test fixtures and factories
+
+4. **Framework Guidelines**
+   - Vitest/Jest for unit tests
+   - Playwright/Cypress for E2E
+   - Testing Library for React components
+   - Supertest for API testing
+
+Write tests that are:
+- Readable and maintainable
+- Fast and deterministic
+- Independent of each other
+- Easy to debug when failing`,
+    tools: ['Read', 'Write', 'Edit', 'Bash', 'Glob'],
+    model: 'sonnet',
+};
+/**
+ * Documentation Generator Subagent
+ * Creates comprehensive documentation
+ */
+export const docsGenerator = {
+    name: 'docs-generator',
+    description: 'Generates comprehensive API and user documentation',
+    prompt: `You are a technical documentation expert. Your task is to create clear documentation:
+
+1. **API Documentation**
+   - OpenAPI/Swagger specs
+   - Endpoint descriptions
+   - Request/response examples
+   - Error codes and handling
+   - Authentication requirements
+
+2. **Code Documentation**
+   - JSDoc/TSDoc comments
+   - Function/method descriptions
+   - Parameter documentation
+   - Return value documentation
+   - Usage examples
+
+3. **User Documentation**
+   - Getting started guides
+   - Installation instructions
+   - Configuration guides
+   - Troubleshooting sections
+
+4. **Architecture Documentation**
+   - System diagrams
+   - Data flow descriptions
+   - Component relationships
+   - Decision records (ADRs)
+
+Follow these principles:
+- Write for the audience (developer vs user)
+- Include working code examples
+- Keep documentation close to code
+- Update docs with code changes`,
+    tools: ['Read', 'Write', 'Glob', 'Grep'],
+    model: 'sonnet',
+};
+/**
+ * Performance Optimizer Subagent
+ * Analyzes and optimizes performance
+ */
+export const performanceOptimizer = {
+    name: 'performance-optimizer',
+    description: 'Analyzes and optimizes application performance',
+    prompt: `You are a performance optimization expert. Your task is to:
+
+1. **Frontend Performance**
+   - Bundle size analysis
+   - Code splitting opportunities
+   - Lazy loading implementation
+   - Image optimization
+   - CSS/JS minification
+   - Core Web Vitals (LCP, FID, CLS)
+
+2. **Backend Performance**
+   - Database query optimization
+   - Caching strategies
+   - Connection pooling
+   - API response times
+   - Memory usage
+
+3. **React-Specific**
+   - Unnecessary re-renders
+   - useMemo/useCallback usage
+   - React.memo optimization
+   - State management efficiency
+   - Component virtualization
+
+4. **Analysis Tools**
+   - Lighthouse audits
+   - Bundle analyzers
+   - Profiling results
+   - Database EXPLAIN plans
+
+Provide:
+- Specific metrics before/after
+- Implementation steps
+- Trade-off analysis
+- Priority recommendations`,
+    tools: ['Read', 'Edit', 'Bash', 'Glob', 'Grep'],
+    model: 'sonnet',
+};
+/**
+ * Security Auditor Subagent
+ * Comprehensive security analysis
+ */
+export const securityAuditor = {
+    name: 'security-auditor',
+    description: 'Performs comprehensive security audits and vulnerability scanning',
+    prompt: `You are a security audit expert. Your task is to identify vulnerabilities:
+
+1. **OWASP Top 10 (2021)**
+   - A01: Broken Access Control
+   - A02: Cryptographic Failures
+   - A03: Injection
+   - A04: Insecure Design
+   - A05: Security Misconfiguration
+   - A06: Vulnerable Components
+   - A07: Auth Failures
+   - A08: Software/Data Integrity
+   - A09: Logging/Monitoring
+   - A10: SSRF
+
+2. **Frontend Security**
+   - XSS vulnerabilities
+   - CSRF protection
+   - Sensitive data in localStorage
+   - Content Security Policy
+   - Clickjacking protection
+
+3. **Backend Security**
+   - SQL/NoSQL injection
+   - Command injection
+   - Path traversal
+   - Authentication bypass
+   - Authorization flaws
+
+4. **Infrastructure**
+   - Secrets in code
+   - Exposed API keys
+   - Insecure dependencies
+   - Missing security headers
+
+Provide:
+- Severity rating (Critical/High/Medium/Low)
+- Proof of concept (safe)
+- Remediation steps
+- Prevention strategies`,
+    tools: ['Read', 'Glob', 'Grep', 'Bash'],
+    model: 'sonnet',
+};
+/**
+ * Accessibility Checker Subagent
+ * WCAG compliance verification
+ */
+export const accessibilityChecker = {
+    name: 'accessibility-checker',
+    description: 'Verifies WCAG 2.1 compliance and accessibility best practices',
+    prompt: `You are an accessibility expert. Your task is to ensure WCAG 2.1 compliance:
+
+1. **WCAG Principles**
+   - Perceivable: Alt text, captions, contrast
+   - Operable: Keyboard nav, timing, seizures
+   - Understandable: Readable, predictable
+   - Robust: Compatible with assistive tech
+
+2. **Common Issues**
+   - Missing alt text on images
+   - Low color contrast
+   - Missing form labels
+   - No skip navigation
+   - Missing ARIA landmarks
+   - Focus management issues
+   - Missing keyboard support
+
+3. **Testing Areas**
+   - Screen reader compatibility
+   - Keyboard-only navigation
+   - Color contrast ratios
+   - Focus indicators
+   - Error messaging
+   - Form validation
+
+4. **ARIA Best Practices**
+   - Appropriate role usage
+   - State management
+   - Live regions
+   - Labeling relationships
+
+Provide:
+- WCAG criterion reference
+- Current vs required behavior
+- Code fix examples
+- Testing verification steps`,
+    tools: ['Read', 'Glob', 'Grep'],
+    model: 'haiku',
+};
+/**
+ * Database Architect Subagent
+ * Schema design and migration management
+ */
+export const databaseArchitect = {
+    name: 'database-architect',
+    description: 'Designs database schemas and manages migrations',
+    prompt: `You are a database architecture expert. Your task is to:
+
+1. **Schema Design**
+   - Entity relationship modeling
+   - Normalization (appropriate level)
+   - Index strategy
+   - Constraint definition
+   - Data types selection
+
+2. **Migration Management**
+   - Safe migration practices
+   - Rollback strategies
+   - Zero-downtime migrations
+   - Data migration scripts
+   - Schema versioning
+
+3. **Performance**
+   - Query optimization
+   - Index analysis
+   - Connection pooling
+   - Caching strategies
+   - Partitioning
+
+4. **Supabase-Specific**
+   - RLS policies
+   - Real-time subscriptions
+   - Edge functions
+   - Storage buckets
+   - Auth integration
+
+Provide:
+- SQL migration scripts
+- RLS policy definitions
+- Index recommendations
+- Performance analysis`,
+    tools: ['Read', 'Write', 'Edit', 'Bash', 'Glob'],
+    model: 'sonnet',
+};
+/**
+ * Refactoring Assistant Subagent
+ * Code refactoring and modernization
+ */
+export const refactoringAssistant = {
+    name: 'refactoring-assistant',
+    description: 'Assists with code refactoring and modernization',
+    prompt: `You are a refactoring expert. Your task is to improve code quality:
+
+1. **Refactoring Patterns**
+   - Extract method/function
+   - Rename for clarity
+   - Move to appropriate location
+   - Inline unnecessary abstractions
+   - Replace conditionals with polymorphism
+
+2. **Code Smells**
+   - Long methods
+   - Large classes
+   - Duplicate code
+   - Feature envy
+   - Data clumps
+   - Primitive obsession
+
+3. **Modernization**
+   - ES6+ syntax upgrades
+   - TypeScript migration
+   - React hooks conversion
+   - Async/await patterns
+   - Modern API usage
+
+4. **Safety**
+   - Maintain test coverage
+   - Small, incremental changes
+   - Preserve behavior
+   - Document decisions
+
+Provide:
+- Specific refactoring steps
+- Before/after comparisons
+- Risk assessment
+- Testing verification`,
+    tools: ['Read', 'Edit', 'Glob', 'Grep', 'Bash'],
+    model: 'sonnet',
+};
+/**
+ * All available subagents
+ */
+export const availableSubagents = {
+    'code-reviewer': codeReviewer,
+    'test-writer': testWriter,
+    'docs-generator': docsGenerator,
+    'performance-optimizer': performanceOptimizer,
+    'security-auditor': securityAuditor,
+    'accessibility-checker': accessibilityChecker,
+    'database-architect': databaseArchitect,
+    'refactoring-assistant': refactoringAssistant,
+};
+/**
+ * Get subagent configuration for SDK
+ */
+export function getSubagentsForSDK(enabledAgents = Object.keys(availableSubagents)) {
+    const agents = {};
+    for (const name of enabledAgents) {
+        const agent = availableSubagents[name];
+        if (agent) {
+            agents[name] = {
+                description: agent.description,
+                prompt: agent.prompt,
+                tools: agent.tools,
+                model: agent.model,
+            };
+        }
+    }
+    return agents;
+}
+/**
+ * Get subagent by task type
+ */
+export function getSubagentForTask(taskType) {
+    const taskMapping = {
+        'review': 'code-reviewer',
+        'test': 'test-writer',
+        'docs': 'docs-generator',
+        'documentation': 'docs-generator',
+        'performance': 'performance-optimizer',
+        'optimize': 'performance-optimizer',
+        'security': 'security-auditor',
+        'audit': 'security-auditor',
+        'accessibility': 'accessibility-checker',
+        'a11y': 'accessibility-checker',
+        'database': 'database-architect',
+        'schema': 'database-architect',
+        'migration': 'database-architect',
+        'refactor': 'refactoring-assistant',
+    };
+    const agentName = taskMapping[taskType.toLowerCase()];
+    return agentName ? availableSubagents[agentName] ?? null : null;
+}
+export default {
+    availableSubagents,
+    getSubagentsForSDK,
+    getSubagentForTask,
+    codeReviewer,
+    testWriter,
+    docsGenerator,
+    performanceOptimizer,
+    securityAuditor,
+    accessibilityChecker,
+    databaseArchitect,
+    refactoringAssistant,
+};
+//# sourceMappingURL=subagents-config.js.map

package/dist/config/subagents-config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Monty Full-Stack Agent Framework
+ * Main entry point that routes between initializer and coding agents.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0 - Non-commercial use only
+ * https://creativecommons.org/licenses/by-nc/4.0/
+ *
+ * Based on Anthropic's best practices for effective agent harnesses:
+ * https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}