codehere 0.1.0 → 0.2.0

package/dist/infrastructure/ux/bi-directional-learning.d.ts.map

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

package/dist/infrastructure/ux/bi-directional-learning.js

@@ -0,0 +1,200 @@
+/**
+ * Infrastructure: Bi-directional Learning System
+ *
+ * Continuous refinement of AI models based on explicit and implicit user feedback
+ * Research: Bi-directional learning from user corrections, adapt to team preferences
+ *
+ * Features:
+ * - Edit/deletion tracking
+ * - Personalization engine
+ * - Learning from user corrections
+ * - Preference adaptation
+ */
+/**
+ * Bi-directional Learning System
+ * Learns from user edits, deletions, and explicit feedback
+ */
+export class BiDirectionalLearning {
+    feedbackHistory = new Map(); // userId -> feedbacks
+    learningPatterns = new Map(); // userId -> patterns
+    userPreferences = new Map();
+    /**
+     * Record user feedback (edit, deletion, etc.)
+     */
+    recordFeedback(userId, feedback) {
+        const feedbackId = `feedback-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        const fullFeedback = {
+            ...feedback,
+            feedbackId,
+            timestamp: Date.now(),
+        };
+        // Store feedback
+        if (!this.feedbackHistory.has(userId)) {
+            this.feedbackHistory.set(userId, []);
+        }
+        this.feedbackHistory.get(userId).push(fullFeedback);
+        // Learn from feedback
+        this.learnFromFeedback(userId, fullFeedback);
+        // Update preferences
+        this.updatePreferences(userId, fullFeedback);
+        return feedbackId;
+    }
+    /**
+     * Record explicit feedback (thumbs up/down, comments)
+     */
+    recordExplicitFeedback(userId, feedback) {
+        return this.recordFeedback(userId, {
+            type: 'explicit_feedback',
+            signal: feedback.signal,
+            filepath: feedback.codeExample || 'general',
+            context: {
+                ...feedback.context,
+            },
+            metadata: {
+                explicitFeedback: feedback.message,
+            },
+        });
+    }
+    /**
+     * Get user preferences
+     */
+    getUserPreferences(userId) {
+        if (!this.userPreferences.has(userId)) {
+            this.userPreferences.set(userId, {
+                userId,
+                preferences: {},
+                learnedAt: Date.now(),
+                lastUpdated: Date.now(),
+            });
+        }
+        return this.userPreferences.get(userId);
+    }
+    /**
+     * Get learned patterns for user
+     */
+    getLearnedPatterns(userId) {
+        return this.learningPatterns.get(userId) || [];
+    }
+    /**
+     * Apply learned preferences to code generation
+     */
+    applyPreferences(userId, code) {
+        const preferences = this.getUserPreferences(userId);
+        if (!preferences.preferences.codeStyle) {
+            return code; // No preferences learned yet
+        }
+        // Apply basic style preferences (simplified - in production, use AST transformation)
+        let modifiedCode = code;
+        const style = preferences.preferences.codeStyle;
+        // Apply quote preference (basic example)
+        if (style.quotes === 'single') {
+            modifiedCode = modifiedCode.replace(/"/g, "'");
+        }
+        else if (style.quotes === 'double') {
+            modifiedCode = modifiedCode.replace(/'/g, '"');
+        }
+        // In production, apply more sophisticated transformations based on preferences
+        return modifiedCode;
+    }
+    /**
+     * Get feedback history for user
+     */
+    getFeedbackHistory(userId, filter) {
+        const feedbacks = this.feedbackHistory.get(userId) || [];
+        let filtered = [...feedbacks];
+        if (filter?.type) {
+            filtered = filtered.filter(f => f.type === filter.type);
+        }
+        if (filter?.signal) {
+            filtered = filtered.filter(f => f.signal === filter.signal);
+        }
+        if (filter?.startTime) {
+            filtered = filtered.filter(f => f.timestamp >= filter.startTime);
+        }
+        if (filter?.endTime) {
+            filtered = filtered.filter(f => f.timestamp <= filter.endTime);
+        }
+        return filtered.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    // Private helpers
+    learnFromFeedback(userId, feedback) {
+        // Learn patterns from edits and deletions
+        if (feedback.type === 'edit' && feedback.originalCode && feedback.modifiedCode) {
+            const pattern = this.extractPattern(feedback.originalCode, feedback.modifiedCode);
+            if (pattern) {
+                this.addLearningPattern(userId, {
+                    type: 'correction',
+                    pattern: pattern,
+                    confidence: 0.7,
+                    occurrences: 1,
+                    examples: [feedback.modifiedCode],
+                });
+            }
+        }
+        // Learn from deletions (what user removes = not wanted)
+        if (feedback.type === 'deletion' && feedback.originalCode) {
+            this.addLearningPattern(userId, {
+                type: 'pattern',
+                pattern: `Avoid: ${feedback.originalCode.substring(0, 50)}`,
+                confidence: 0.6,
+                occurrences: 1,
+                examples: [],
+            });
+        }
+    }
+    updatePreferences(userId, feedback) {
+        const preferences = this.getUserPreferences(userId);
+        // Infer preferences from edits
+        if (feedback.type === 'edit' && feedback.originalCode && feedback.modifiedCode) {
+            // Infer code style preferences (simplified)
+            if (feedback.modifiedCode.includes("'") && !feedback.originalCode.includes("'")) {
+                preferences.preferences.codeStyle = preferences.preferences.codeStyle || {};
+                preferences.preferences.codeStyle.quotes = 'single';
+            }
+            else if (feedback.modifiedCode.includes('"') && !feedback.originalCode.includes('"')) {
+                preferences.preferences.codeStyle = preferences.preferences.codeStyle || {};
+                preferences.preferences.codeStyle.quotes = 'double';
+            }
+            preferences.lastUpdated = Date.now();
+        }
+        // Update based on explicit feedback
+        if (feedback.type === 'explicit_feedback' && feedback.metadata?.explicitFeedback) {
+            // Parse explicit feedback for preferences
+            const message = feedback.metadata.explicitFeedback.toLowerCase();
+            if (message.includes('style') || message.includes('format')) {
+                // Extract style preferences from feedback
+                // (In production, use NLP to parse structured preferences)
+            }
+        }
+    }
+    extractPattern(original, modified) {
+        // Simple pattern extraction (in production, use AST diffing)
+        if (original.length > 0 && modified.length > 0) {
+            return `Pattern: ${modified.substring(0, 30)}...`;
+        }
+        return null;
+    }
+    addLearningPattern(userId, pattern) {
+        if (!this.learningPatterns.has(userId)) {
+            this.learningPatterns.set(userId, []);
+        }
+        const patterns = this.learningPatterns.get(userId);
+        // Check if similar pattern exists
+        const existing = patterns.find(p => p.pattern === pattern.pattern);
+        if (existing) {
+            existing.occurrences++;
+            existing.confidence = Math.min(1.0, existing.confidence + 0.1);
+            existing.examples.push(...pattern.examples.slice(0, 3)); // Keep max 3 examples
+            existing.lastSeen = Date.now();
+        }
+        else {
+            patterns.push({
+                ...pattern,
+                patternId: `pattern-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+                createdAt: Date.now(),
+                lastSeen: Date.now(),
+            });
+        }
+    }
+}
+//# sourceMappingURL=bi-directional-learning.js.map

package/dist/infrastructure/ux/bi-directional-learning.js.map

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

package/dist/infrastructure/ux/expectation-management.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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
+ */
+export type OperationRisk = 'low' | 'medium' | 'high' | 'critical';
+export type CapabilityLevel = 'confident' | 'moderate' | 'uncertain' | 'risky';
+export interface ExpectationMessage {
+    type: 'capability' | 'limitation' | 'warning' | 'disclaimer';
+    operation: string;
+    message: string;
+    severity: 'info' | 'warning' | 'error';
+    showOnce?: boolean;
+    contextual?: boolean;
+}
+export interface CapabilityAssessment {
+    operation: string;
+    capability: CapabilityLevel;
+    confidence: number;
+    limitations: string[];
+    warnings: string[];
+    canProceed: boolean;
+    recommendedApproach?: string;
+}
+/**
+ * Expectation Management System
+ * Manages user expectations and communicates AI limitations clearly
+ */
+export declare class ExpectationManagement {
+    private messages;
+    private shownMessages;
+    constructor();
+    /**
+     * Assess capability for an operation
+     */
+    assessCapability(operation: string, context: {
+        complexity?: 'simple' | 'moderate' | 'complex';
+        domain?: string;
+        uncertainty?: number;
+        riskLevel?: OperationRisk;
+    }): CapabilityAssessment;
+    /**
+     * Get expectation message for operation
+     */
+    getExpectationMessage(operation: string, context?: Record<string, any>): ExpectationMessage | null;
+    /**
+     * Register custom expectation message
+     */
+    registerMessage(message: ExpectationMessage): void;
+    /**
+     * Format capability assessment for display
+     */
+    formatAssessment(assessment: CapabilityAssessment): string;
+    private initializeDefaultMessages;
+    private matchesContext;
+    private generateRecommendedApproach;
+}
+//# sourceMappingURL=expectation-management.d.ts.map

package/dist/infrastructure/ux/expectation-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expectation-management.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ux/expectation-management.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AACnE,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,aAAa,CAA0B;;IAM/C;;OAEG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QACP,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;QAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,aAAa,CAAC;KAC3B,GACA,oBAAoB;IAyDvB;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,kBAAkB,GAAG,IAAI;IAuBlG;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIlD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM;IA2C1D,OAAO,CAAC,yBAAyB;IA6BjC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,2BAA2B;CAcpC"}

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

@@ -0,0 +1,193 @@
+/**
+ * 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
+ */
+/**
+ * Expectation Management System
+ * Manages user expectations and communicates AI limitations clearly
+ */
+export class ExpectationManagement {
+    messages = new Map();
+    shownMessages = new Set(); // Track shown messages
+    constructor() {
+        this.initializeDefaultMessages();
+    }
+    /**
+     * 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;
+    }
+}
+//# 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/hitl-validation.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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 interface ReviewCheckpoint {
+    checkpointId: string;
+    operation: string;
+    description: string;
+    priority: ReviewPriority;
+    status: ReviewStatus;
+    createdAt: number;
+    reviewedAt?: number;
+    reviewedBy?: string;
+    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
+ */
+export declare class HITLValidation {
+    private checkpoints;
+    private reviewQueue;
+    /**
+     * Create review checkpoint
+     */
+    createCheckpoint(operation: string, changes: ReviewCheckpoint['changes'], context: ReviewCheckpoint['context'], metadata?: ReviewCheckpoint['metadata']): ReviewCheckpoint;
+    /**
+     * 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":"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"}