adpa-enterprise-framework-automation/dist/modules/ai/processors/TechnicalAnalysisProcessor.js

Modular, standards-compliant Node.js/TypeScript automation framework for enterprise requirements, project, and data management. Provides CLI and API for BABOK v3, PMBOK 7th Edition, and DMBOK 2.0 (in progress). Production-ready Express.js API with TypeSpe

/**
 * Technical Analysis Processor
 * Handles AI functions related to technical analysis and architecture
 *
 * @class TechnicalAnalysisProcessor
 * @description Specialized processor for generating technical documentation
 * including data models, tech stack analysis, architecture suggestions,
 * and integration recommendations.
 *
 * @version 2.1.3
 * @author Requirements Gathering Agent Team
 * @created 2024
 * @updated June 2025
 * @since 3.1.0
 */
import { AIProcessor } from "../AIProcessor.js";
import { BaseAIProcessor } from "./BaseAIProcessor.js";
// Lazy initialization function for AIProcessor
let _aiProcessor = null;
const getAIProcessor = () => {
    if (!_aiProcessor) {
        _aiProcessor = AIProcessor.getInstance();
    }
    return _aiProcessor;
};
let _contextManager = null;
const getContextManager = async () => {
    if (!_contextManager) {
        const { ContextManager } = await import("../../contextManager");
        _contextManager = new ContextManager();
    }
    return _contextManager;
};
export class TechnicalAnalysisProcessor extends BaseAIProcessor {
    /**
     * Generates data model suggestions based on project requirements
     *
     * @param {string} context - Project context information
     * @returns {Promise<string|null>} Data model suggestions or null if generation fails
     */
    async getDataModelSuggestions(context) {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are a senior solution architect and database expert. Analyze the project requirements and suggest an optimal data model architecture.", `Based on the comprehensive project context below, provide detailed data model suggestions:

Project Context:
${context}

Your analysis should include:
- Core entities and their relationships
- Key attributes and data types
- Primary and foreign key recommendations
- Indexing recommendations
- Data integrity constraints
- Normalization level recommendations
- Entity-relationship diagrams (as text/ascii representation)
- Database technology recommendations (SQL, NoSQL, hybrid)
- Scalability and performance considerations
- Data security and privacy recommendations

Focus on creating a data model that is scalable, maintainable, and aligned with modern best practices. Consider performance, security, and flexibility in your recommendations.`);
            const aiProcessor = getAIProcessor();
            const response = await aiProcessor.makeAICall(messages, 1800);
            return getAIProcessor().extractContent(response);
        }, 'Data Model Suggestions Generation', 'data-model-suggestions');
    }
    /**
     * Analyzes and recommends a technology stack based on project requirements
     *
     * @param {string} context - Project context information
     * @returns {Promise<string|null>} Technology stack recommendations or null if generation fails
     */
    async getTechStackAnalysis(context) {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are a senior solution architect with expertise across multiple technology stacks. Analyze the project requirements and suggest an optimal technology stack architecture.", `Based on the project context below, provide a thorough technology stack analysis:

Project Context:
${context}

Include in your analysis:
- Frontend technology recommendations
- Backend technology recommendations
- Database recommendations
- DevOps and infrastructure recommendations
- Integration approaches
- API design recommendations
- Security considerations
- Scalability and performance considerations
- Development workflow recommendations
- Testing frameworks and strategies
- Monitoring and observability solutions
- Cost optimization approaches

For each technology recommendation:
- Justification for selection
- Key advantages and drawbacks
- Implementation considerations
- Considered alternatives

Focus on creating a cohesive technology ecosystem that is maintainable, scalable, and aligns with industry best practices.`);
            const aiProcessor = getAIProcessor();
            const response = await aiProcessor.makeAICall(messages, 2000);
            return getAIProcessor().extractContent(response);
        }, 'Tech Stack Analysis Generation', 'tech-stack-analysis');
    }
    /**
     * Generates Risk Analysis for technical aspects
     */
    async getRiskAnalysis(context) {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are a risk management expert with technical expertise. Analyze the project for technical and business risks.", `Based on the project context below, provide a comprehensive risk analysis:

Project Context:
${context}

Include in your risk analysis:
- Technical risks (architecture, technology choices, integration challenges)
- Business risks (market, competitive, financial)
- Operational risks (team, process, timeline)
- Security risks (data protection, compliance, vulnerabilities)
- Risk probability and impact assessment
- Risk mitigation strategies
- Risk monitoring approaches
- Contingency planning recommendations

Format as a structured risk register with clear categorization and actionable mitigation strategies.`);
            const response = await getAIProcessor().makeAICall(messages, 1800);
            return getAIProcessor().extractContent(response);
        }, 'Risk Analysis Generation', 'risk-analysis');
    }
    /**
     * Generates Compliance Considerations
     */
    async getComplianceConsiderations(context) {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are a compliance expert with knowledge of regulatory requirements across industries. Analyze compliance needs for this project.", `Based on the project context below, provide comprehensive compliance considerations:

Project Context:
${context}

Include in your compliance analysis:
- Regulatory frameworks that may apply (GDPR, CCPA, HIPAA, SOX, etc.)
- Data protection and privacy requirements
- Industry-specific compliance needs
- Security and audit requirements
- Documentation and reporting obligations
- Compliance implementation strategies
- Ongoing monitoring and maintenance needs
- Cost and resource implications

Focus on practical, actionable compliance guidance that can be integrated into the development process.`);
            const response = await getAIProcessor().makeAICall(messages, 1600);
            return getAIProcessor().extractContent(response);
        }, 'Compliance Considerations Generation', 'compliance-considerations');
    }
    /**
     * Generates UI/UX Considerations
     */
    async getUiUxConsiderations(context) {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are a UX/UI expert with extensive experience in user-centered design and PMBOK 7.0 project management practices. Analyze the project for comprehensive UI/UX considerations that align with project management standards.", `Based on the project context below, provide comprehensive UI/UX considerations that align with PMBOK 7.0 performance domains:

Project Context:
${context}

## PMBOK 7.0 Performance Domain Integration

### Stakeholder Performance Domain
- User research methodology and stakeholder engagement
- User persona development and validation processes
- Stakeholder feedback collection and integration workflows
- User advocacy and representation in project decisions

### Planning Performance Domain
- UI/UX project planning and milestone integration
- Resource allocation for design activities and user research
- Timeline considerations for design iterations and user testing
- Risk assessment and mitigation for user experience delivery

### Project Work Performance Domain
- Design-to-development handoff processes and workflows
- Cross-functional collaboration between UX and development teams
- Quality gates and checkpoints for UI/UX deliverables
- Change management for design iterations and user feedback

### Delivery Performance Domain
- User acceptance criteria and testing protocols
- Performance metrics and success measurement for UX
- User training and adoption strategies
- Post-launch optimization and continuous improvement

## Comprehensive UI/UX Analysis Required

Include detailed analysis of:
- Strategic UX planning and project integration
- User experience strategy aligned with business objectives
- User interface design guidelines and standards
- Accessibility compliance (WCAG 2.1 AA, Section 508, ADA)
- Mobile-first and responsive design considerations
- User journey mapping and experience flow optimization
- Information architecture and navigation design
- Interaction design patterns and component libraries
- Visual design principles and brand alignment
- Usability testing strategies and validation methods
- Performance optimization for user experience
- Content strategy and information design
- Internationalization and localization requirements
- Risk management specific to user experience
- Quality assurance processes for UI/UX deliverables

Focus on creating actionable, measurable recommendations that contribute to successful project delivery while ensuring exceptional user experience and alignment with PMBOK project management standards.`);
            const response = await getAIProcessor().makeAICall(messages, 2000);
            return getAIProcessor().extractContent(response);
        }, 'UI/UX Considerations Generation', 'ui-ux-considerations');
    }
}
//# sourceMappingURL=TechnicalAnalysisProcessor.js.map