codehere 0.1.1

package/dist/infrastructure/ux/expectation-management.js

@@ -0,0 +1,327 @@
+/**
+ * Infrastructure: Expectation Management System
+ *
+ * Clearly communicates AI limitations to prevent user frustration
+ * Research: Expectation management - clear limitations, "can make mistakes" warnings
+ *
+ * Features:
+ * - Clear capability communication
+ * - Limitation warnings
+ * - Contextual disclaimers
+ * - Error prevention messaging
+ * - First-time AI operation disclaimers
+ * - Uncertainty indicators
+ */
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+export class ExpectationManagement {
+    messages = new Map();
+    shownMessages = new Set(); // Track shown messages
+    disclaimerShown = false;
+    constructor() {
+        this.initializeDefaultMessages();
+        this.loadDisclaimerState();
+    }
+    /**
+     * Assess capability for an operation
+     */
+    assessCapability(operation, context) {
+        const { complexity = 'moderate', domain, uncertainty = 0.5, riskLevel = 'medium' } = context;
+        let capability = 'moderate';
+        let confidence = 0.7;
+        const limitations = [];
+        const warnings = [];
+        // Adjust based on complexity
+        if (complexity === 'simple') {
+            capability = 'confident';
+            confidence = 0.9;
+        }
+        else if (complexity === 'complex') {
+            capability = 'uncertain';
+            confidence = 0.5;
+            limitations.push('Complex operations may require multiple iterations');
+        }
+        // Adjust based on uncertainty
+        if (uncertainty > 0.7) {
+            capability = 'risky';
+            confidence = 0.3;
+            warnings.push('High uncertainty detected - verify output carefully');
+            warnings.push('This may indicate hallucination risk');
+        }
+        // Adjust based on risk level
+        if (riskLevel === 'critical') {
+            warnings.push('Critical operation - human review recommended');
+            capability = 'risky';
+            confidence = Math.min(confidence, 0.4);
+        }
+        else if (riskLevel === 'high') {
+            warnings.push('High-risk operation - please review before applying');
+        }
+        // Domain-specific limitations
+        if (domain === 'security') {
+            limitations.push('Security-sensitive code requires careful review');
+            warnings.push('Always verify security implications manually');
+        }
+        else if (domain === 'financial') {
+            limitations.push('Financial code requires compliance verification');
+            warnings.push('Ensure regulatory compliance before deployment');
+        }
+        const canProceed = capability !== 'risky' || riskLevel !== 'critical';
+        return {
+            operation,
+            capability,
+            confidence,
+            limitations,
+            warnings,
+            canProceed,
+            recommendedApproach: this.generateRecommendedApproach(capability, complexity, riskLevel),
+        };
+    }
+    /**
+     * Get expectation message for operation
+     */
+    getExpectationMessage(operation, context) {
+        // Check for contextual messages first
+        if (context) {
+            for (const message of this.messages.values()) {
+                if (message.contextual && this.matchesContext(message, context)) {
+                    return message;
+                }
+            }
+        }
+        // Check for operation-specific message
+        const operationMessage = this.messages.get(operation);
+        if (operationMessage) {
+            if (operationMessage.showOnce && this.shownMessages.has(operation)) {
+                return null; // Already shown
+            }
+            this.shownMessages.add(operation);
+            return operationMessage;
+        }
+        return null;
+    }
+    /**
+     * Register custom expectation message
+     */
+    registerMessage(message) {
+        this.messages.set(message.operation, message);
+    }
+    /**
+     * Format capability assessment for display
+     */
+    formatAssessment(assessment) {
+        let output = '';
+        // Capability level indicator
+        const capabilityIcons = {
+            confident: '✓',
+            moderate: '◐',
+            uncertain: '⚠',
+            risky: '⚠⚠',
+        };
+        output += `${capabilityIcons[assessment.capability]} ${assessment.operation}\n`;
+        output += `Confidence: ${(assessment.confidence * 100).toFixed(0)}%\n\n`;
+        if (assessment.limitations.length > 0) {
+            output += `Limitations:\n`;
+            for (const limitation of assessment.limitations) {
+                output += `  • ${limitation}\n`;
+            }
+            output += '\n';
+        }
+        if (assessment.warnings.length > 0) {
+            output += `Warnings:\n`;
+            for (const warning of assessment.warnings) {
+                output += `  ⚠ ${warning}\n`;
+            }
+            output += '\n';
+        }
+        if (assessment.recommendedApproach) {
+            output += `Recommended: ${assessment.recommendedApproach}\n`;
+        }
+        if (!assessment.canProceed) {
+            output += `\n⚠️ This operation requires human review before proceeding.\n`;
+        }
+        return output;
+    }
+    // Private helpers
+    initializeDefaultMessages() {
+        // General disclaimer
+        this.registerMessage({
+            type: 'disclaimer',
+            operation: 'general',
+            message: 'AI-generated code may contain errors. Please review and test before deploying.',
+            severity: 'info',
+            showOnce: true,
+        });
+        // Security operations
+        this.registerMessage({
+            type: 'warning',
+            operation: 'security-sensitive',
+            message: 'Security-sensitive operations require careful manual review. The AI may not catch all vulnerabilities.',
+            severity: 'warning',
+            contextual: true,
+        });
+        // Critical operations
+        this.registerMessage({
+            type: 'warning',
+            operation: 'critical',
+            message: 'This is a high-risk operation. Human review is mandatory before proceeding.',
+            severity: 'error',
+            contextual: true,
+        });
+    }
+    matchesContext(message, context) {
+        // Simple context matching logic
+        if (message.operation === 'security-sensitive' && context.domain === 'security') {
+            return true;
+        }
+        if (message.operation === 'critical' && context.riskLevel === 'critical') {
+            return true;
+        }
+        return false;
+    }
+    generateRecommendedApproach(capability, complexity, riskLevel) {
+        if (capability === 'risky' || riskLevel === 'critical') {
+            return 'Review generated code carefully, test thoroughly, and get human approval before deployment';
+        }
+        else if (capability === 'uncertain' || complexity === 'complex') {
+            return 'Review the generated code and test incrementally';
+        }
+        else if (capability === 'moderate') {
+            return 'Review the code before committing';
+        }
+        return undefined;
+    }
+    /**
+     * Check if first-time AI operation disclaimer should be shown
+     */
+    shouldShowFirstTimeDisclaimer() {
+        return !this.disclaimerShown;
+    }
+    /**
+     * Get first-time AI operation disclaimer notice
+     */
+    getFirstTimeDisclaimer() {
+        return `┌────────────────────────────────────────────────────┐
+│ ⚠️  AI Assistant Notice                            │
+│                                                     │
+│ This AI can make mistakes. Please verify:          │
+│ • Generated code correctness                       │
+│ • Security implications                            │
+│ • License compliance                               │
+│ • Output accuracy and completeness                 │
+│                                                     │
+│ Capabilities:                                      │
+│ • Can generate, explain, and modify code           │
+│ • May not catch all edge cases                     │
+│ • May not be aware of latest APIs                  │
+│ • Processing patterns, not "thinking"              │
+│                                                     │
+│ Always review generated code before deploying.     │
+└────────────────────────────────────────────────────┘`;
+    }
+    /**
+     * Mark first-time disclaimer as shown
+     */
+    markDisclaimerShown() {
+        this.disclaimerShown = true;
+        this.saveDisclaimerState();
+    }
+    /**
+     * Get uncertainty indicator message
+     */
+    getUncertaintyIndicator(confidence) {
+        if (confidence < 0.65) {
+            const percent = (confidence * 100).toFixed(0);
+            return `┌────────────────────────────────────────────────────┐
+│ ⚠️  Uncertainty Detected                           │
+│                                                     │
+│ I'm less confident about this answer (${percent}%).        │
+│ Please verify the information carefully.           │
+│                                                     │
+│ This may indicate:                                 │
+│ • Limited context for the query                    │
+│ • Ambiguous or complex requirements                │
+│ • Potential hallucination risk                     │
+│                                                     │
+│ Recommendation: Review output thoroughly.          │
+└────────────────────────────────────────────────────┘`;
+        }
+        return null;
+    }
+    /**
+     * Get capability boundaries notice
+     */
+    getCapabilityBoundaries() {
+        return `Capability Boundaries:
+
+What I CAN do:
+  ✓ Answer questions about your codebase
+  ✓ Generate and modify code
+  ✓ Explain code structure and logic
+  ✓ Suggest improvements and refactorings
+  ✓ Identify potential issues
+
+What I CANNOT do:
+  ✗ Guarantee code correctness
+  ✗ Always detect all security vulnerabilities
+  ✗ Know your specific business requirements
+  ✗ Replace thorough testing
+  ✗ Ensure compliance with all regulations
+
+Important:
+  • Always review generated code
+  • Test thoroughly before deploying
+  • Verify security and compliance requirements
+  • Use as an assistant, not a replacement for expertise`;
+    }
+    /**
+     * Format disclaimer for console display (honest tone, no anthropomorphization)
+     */
+    formatDisclaimerForConsole() {
+        return `⚠️  AI Assistant Notice
+
+This AI assistant processes code patterns and generates suggestions based on training data.
+It can make mistakes and may not understand all context.
+
+Please verify:
+  • Generated code correctness and logic
+  • Security implications (vulnerabilities, data exposure)
+  • License compliance (license conflicts, attribution)
+  • Output accuracy (may miss edge cases or latest APIs)
+
+Remember: The AI is processing patterns, not "thinking" or "understanding"
+in the human sense. Always review and test before deploying.`;
+    }
+    // Private helpers for disclaimer state management
+    loadDisclaimerState() {
+        try {
+            const configDir = join(process.cwd(), 'data');
+            const disclaimerPath = join(configDir, 'ai-disclaimer.json');
+            if (existsSync(disclaimerPath)) {
+                const state = JSON.parse(readFileSync(disclaimerPath, 'utf-8'));
+                this.disclaimerShown = state.shown || false;
+            }
+        }
+        catch {
+            // Ignore errors - will default to not shown
+        }
+    }
+    saveDisclaimerState() {
+        try {
+            const configDir = join(process.cwd(), 'data');
+            if (!existsSync(configDir)) {
+                mkdirSync(configDir, { recursive: true });
+            }
+            const disclaimerPath = join(configDir, 'ai-disclaimer.json');
+            const state = {
+                shown: true,
+                shownDate: new Date().toISOString(),
+            };
+            writeFileSync(disclaimerPath, JSON.stringify(state, null, 2));
+        }
+        catch {
+            // Ignore errors - non-critical
+        }
+    }
+}
+//# sourceMappingURL=expectation-management.js.map

package/dist/infrastructure/ux/expectation-management.js.map

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

package/dist/infrastructure/ux/feature-discovery.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Feature Discovery (v0.5.0-alpha.0 - Stub)
+ * TODO: Implement feature discovery system
+ */
+export interface FeatureDiscovery {
+    id: string;
+    message: string;
+    features: Array<{
+        name: string;
+        description: string;
+        command: string;
+    }>;
+}
+export declare function trackCommand(command: string): void;
+export declare function shouldShowFeatureDiscovery(command: string): FeatureDiscovery | null;
+export declare function markFeatureDiscoveryShown(id: string): void;
+//# sourceMappingURL=feature-discovery.d.ts.map

package/dist/infrastructure/ux/feature-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-discovery.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ux/feature-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAEnF;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE1D"}

package/dist/infrastructure/ux/feature-discovery.js

@@ -0,0 +1,14 @@
+/**
+ * Feature Discovery (v0.5.0-alpha.0 - Stub)
+ * TODO: Implement feature discovery system
+ */
+export function trackCommand(command) {
+    // Stub implementation
+}
+export function shouldShowFeatureDiscovery(command) {
+    return null;
+}
+export function markFeatureDiscoveryShown(id) {
+    // Stub implementation
+}
+//# sourceMappingURL=feature-discovery.js.map

package/dist/infrastructure/ux/feature-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-discovery.js","sourceRoot":"","sources":["../../../src/infrastructure/ux/feature-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,sBAAsB;AACxB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,EAAU;IAClD,sBAAsB;AACxB,CAAC"}

package/dist/infrastructure/ux/feedback-prompt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Feedback Prompt
+ * Collect and store user feedback for bidirectional learning
+ *
+ * Phase 1: v0.5.0-alpha.0
+ */
+interface FeedbackContext {
+    query?: string;
+    response?: string;
+    sessionId?: string;
+    operation?: string;
+}
+/**
+ * Prompt user for feedback (non-blocking, returns null if user skips)
+ */
+export declare function promptForFeedback(operation: string, context: FeedbackContext): Promise<string | null>;
+/**
+ * Store feedback in the learning system
+ */
+export declare function storeFeedback(learningSystem: any, userId: string, feedback: string, metadata: FeedbackContext): void;
+/**
+ * Display feedback confirmation message
+ */
+export declare function displayFeedbackConfirmation(feedback: string): void;
+export {};
+//# sourceMappingURL=feedback-prompt.d.ts.map

package/dist/infrastructure/ux/feedback-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-prompt.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ux/feedback-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,GAAG,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGlE"}

package/dist/infrastructure/ux/feedback-prompt.js

@@ -0,0 +1,45 @@
+/**
+ * Feedback Prompt
+ * Collect and store user feedback for bidirectional learning
+ *
+ * Phase 1: v0.5.0-alpha.0
+ */
+/**
+ * Prompt user for feedback (non-blocking, returns null if user skips)
+ */
+export async function promptForFeedback(operation, context) {
+    // In alpha, we skip interactive prompts to avoid blocking
+    // This can be enhanced later with readline-based prompts
+    return null;
+}
+/**
+ * Store feedback in the learning system
+ */
+export function storeFeedback(learningSystem, userId, feedback, metadata) {
+    if (!learningSystem || !feedback) {
+        return;
+    }
+    try {
+        // Store feedback if learning system supports it
+        if (typeof learningSystem.storeFeedback === 'function') {
+            learningSystem.storeFeedback({
+                userId,
+                feedback,
+                metadata,
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    catch (error) {
+        // Silent failure - feedback collection should not break the workflow
+        console.error('Failed to store feedback:', error);
+    }
+}
+/**
+ * Display feedback confirmation message
+ */
+export function displayFeedbackConfirmation(feedback) {
+    // In alpha, skip confirmation display to keep CLI clean
+    // This can be enhanced later
+}
+//# sourceMappingURL=feedback-prompt.js.map

package/dist/infrastructure/ux/feedback-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-prompt.js","sourceRoot":"","sources":["../../../src/infrastructure/ux/feedback-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAiB,EACjB,OAAwB;IAExB,0DAA0D;IAC1D,yDAAyD;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,cAAmB,EACnB,MAAc,EACd,QAAgB,EAChB,QAAyB;IAEzB,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,gDAAgD;QAChD,IAAI,OAAO,cAAc,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;YACvD,cAAc,CAAC,aAAa,CAAC;gBAC3B,MAAM;gBACN,QAAQ;gBACR,QAAQ;gBACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qEAAqE;QACrE,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAgB;IAC1D,wDAAwD;IACxD,6BAA6B;AAC/B,CAAC"}

package/dist/infrastructure/ux/hitl-validation.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Infrastructure: Human-in-the-Loop (HITL) Validation System
+ *
+ * Architecturally embedded human intervention points for supervision and decision-making
+ * Research: Human-in-the-Loop (HITL) validation mandatory, prevents automation bias
+ *
+ * Features:
+ * - Mandatory validation checkpoints
+ * - Centralized review hub
+ * - Review queue management
+ * - Approval workflow
+ */
+export type ReviewStatus = 'pending' | 'approved' | 'rejected' | 'needs_changes' | 'cancelled';
+export type ReviewPriority = 'low' | 'normal' | 'high' | 'critical';
+export type HITLStrictness = 'minimal' | 'balanced' | 'strict';
+export interface HITLConfiguration {
+    strictness: HITLStrictness;
+    allowAutoProceed: boolean;
+    mandatoryRiskLevels?: ('low' | 'medium' | 'high' | 'critical')[];
+}
+export interface ReviewCheckpoint {
+    checkpointId: string;
+    operation: string;
+    description: string;
+    priority: ReviewPriority;
+    status: ReviewStatus;
+    createdAt: number;
+    reviewedAt?: number;
+    reviewedBy?: string;
+    isMandatory: boolean;
+    changes: {
+        type: 'edit' | 'create' | 'delete' | 'move' | 'refactor';
+        filepath?: string;
+        diff?: string;
+        summary: string;
+    }[];
+    context: {
+        query: string;
+        riskLevel: 'low' | 'medium' | 'high' | 'critical';
+        uncertainty?: number;
+        securityFindings?: any[];
+        licenseFindings?: any[];
+    };
+    metadata: {
+        sessionId?: string;
+        userId?: string;
+        decisionTreeId?: string;
+        lineageId?: string;
+        [key: string]: any;
+    };
+}
+export interface ReviewDecision {
+    checkpointId: string;
+    decision: 'approve' | 'reject' | 'request_changes';
+    reviewer: string;
+    comment?: string;
+    timestamp: number;
+}
+/**
+ * Human-in-the-Loop Validation System
+ * Manages mandatory validation checkpoints for critical operations
+ * Task 4.2: Adaptive HITL - Supports mandatory vs optional checkpoints based on risk
+ */
+export declare class HITLValidation {
+    private checkpoints;
+    private reviewQueue;
+    private config;
+    constructor(config?: HITLConfiguration);
+    /**
+     * Set HITL configuration (user preferences)
+     */
+    setConfiguration(config: HITLConfiguration): void;
+    /**
+     * Get current HITL configuration
+     */
+    getConfiguration(): HITLConfiguration;
+    /**
+     * Create review checkpoint
+     * Task 4.2: Determines if checkpoint is mandatory or optional based on risk and user preferences
+     */
+    createCheckpoint(operation: string, changes: ReviewCheckpoint['changes'], context: ReviewCheckpoint['context'], metadata?: ReviewCheckpoint['metadata']): ReviewCheckpoint;
+    /**
+     * Task 4.2: Determine if checkpoint requires mandatory approval
+     * Low-risk operations can be optional (auto-proceed if user preference allows)
+     * High-risk operations are always mandatory
+     */
+    isMandatoryCheckpoint(context: {
+        riskLevel: 'low' | 'medium' | 'high' | 'critical';
+        isDestructive?: boolean;
+        modifiesSecuritySensitiveCode?: boolean;
+        affectsMultipleFiles?: boolean;
+        uncertainty?: number;
+    }): boolean;
+    /**
+     * Task 4.2: Check if checkpoint can auto-proceed (optional checkpoint with user preference)
+     */
+    canAutoProceed(checkpoint: ReviewCheckpoint): boolean;
+    /**
+     * Check if operation requires HITL validation
+     */
+    requiresValidation(context: {
+        riskLevel: 'low' | 'medium' | 'high' | 'critical';
+        isDestructive?: boolean;
+        modifiesSecuritySensitiveCode?: boolean;
+        affectsMultipleFiles?: boolean;
+        uncertainty?: number;
+    }): boolean;
+    /**
+     * Get next checkpoint in review queue
+     */
+    getNextCheckpoint(): ReviewCheckpoint | null;
+    /**
+     * Submit review decision
+     */
+    submitDecision(decision: ReviewDecision): void;
+    /**
+     * Get checkpoint by ID
+     */
+    getCheckpoint(checkpointId: string): ReviewCheckpoint | null;
+    /**
+     * Get all pending checkpoints
+     */
+    getPendingCheckpoints(priority?: ReviewPriority): ReviewCheckpoint[];
+    /**
+     * Get review queue status
+     */
+    getReviewQueueStatus(): {
+        total: number;
+        pending: number;
+        byPriority: Record<ReviewPriority, number>;
+    };
+    /**
+     * Format checkpoint for review
+     */
+    formatCheckpoint(checkpoint: ReviewCheckpoint): string;
+    private addToReviewQueue;
+    private generateDescription;
+}
+//# sourceMappingURL=hitl-validation.d.ts.map

package/dist/infrastructure/ux/hitl-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl-validation.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ux/hitl-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,GAAG,WAAW,CAAC;AAC/F,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,cAAc,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,CAAC,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC;CAClE;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IACJ,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QAClD,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;QACzB,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,CAAC,EAAE,iBAAiB;IAQtC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAIjD;;OAEG;IACH,gBAAgB,IAAI,iBAAiB;IAIrC;;;OAGG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACtC,gBAAgB;IAgCnB;;;;OAIG;IACH,qBAAqB,CAAC,OAAO,EAAE;QAC7B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QAClD,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,6BAA6B,CAAC,EAAE,OAAO,CAAC;QACxC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO;IA+CX;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO;IAkBrD;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QAClD,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,6BAA6B,CAAC,EAAE,OAAO,CAAC;QACxC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO;IA0CX;;OAEG;IACH,iBAAiB,IAAI,gBAAgB,GAAG,IAAI;IAS5C;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAqB9C;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI5D;;OAEG;IACH,qBAAqB,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,gBAAgB,EAAE;IAepE;;OAEG;IACH,oBAAoB,IAAI;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;KAC5C;IAyBD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM;IA0CtD,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,mBAAmB;CAQ5B"}