codehere 0.1.0 → 0.3.0

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,47 @@
+/**
+ * Feature Discovery System
+ * Shows contextual feature discovery prompts based on user activity
+ */
+export interface OnboardingState {
+    onboardingComplete: boolean;
+    onboardingDate?: string;
+    commandCount: number;
+    featuresDiscovered: string[];
+    lastDiscoveryShown?: string;
+    lastDiscoveryDate?: string;
+}
+export interface FeatureDiscovery {
+    id: string;
+    trigger: {
+        commandCount?: number;
+        commands?: string[];
+        condition?: (state: OnboardingState) => boolean;
+    };
+    message: string;
+    features: Array<{
+        name: string;
+        description: string;
+        command: string;
+    }>;
+}
+/**
+ * Track command usage
+ */
+export declare function trackCommand(command: string): void;
+/**
+ * Check if feature discovery should be shown
+ */
+export declare function shouldShowFeatureDiscovery(command: string): FeatureDiscovery | null;
+/**
+ * Mark feature discovery as shown
+ */
+export declare function markFeatureDiscoveryShown(discoveryId: string): void;
+/**
+ * Check if user is first-time (onboarding not complete)
+ */
+export declare function isFirstTimeUser(): boolean;
+/**
+ * Get command count for analytics
+ */
+export declare function getCommandCount(): number;
+//# 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;AAKH,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC;KACjD,CAAC;IACF,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;AAiHD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAUlD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GACd,gBAAgB,GAAG,IAAI,CA6CzB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAKnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC"}

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

@@ -0,0 +1,190 @@
+/**
+ * Feature Discovery System
+ * Shows contextual feature discovery prompts based on user activity
+ */
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+const DISCOVERY_FEATURES = [
+    {
+        id: 'basic-commands',
+        trigger: { commandCount: 3 },
+        message: 'You\'ve mastered the basics! Try these next:',
+        features: [
+            {
+                name: 'Multi-agent Orchestration',
+                description: 'Plan and execute complex multi-step tasks',
+                command: 'codehere orchestrate "your goal"',
+            },
+            {
+                name: 'ReAct Reasoning',
+                description: 'Debug and solve complex problems step-by-step',
+                command: 'codehere react "your problem"',
+            },
+            {
+                name: 'Planning',
+                description: 'Generate hierarchical plans for large tasks',
+                command: 'codehere plan "your goal"',
+            },
+        ],
+    },
+    {
+        id: 'advanced-features',
+        trigger: { commandCount: 5 },
+        message: 'Ready for advanced features? Discover more:',
+        features: [
+            {
+                name: 'Execution Tracing',
+                description: 'View and reproduce agent execution traces',
+                command: 'codehere trace show <runId>',
+            },
+            {
+                name: 'Knowledge Management',
+                description: 'Query and manage preserved knowledge',
+                command: 'codehere knowledge query "your query"',
+            },
+            {
+                name: 'Learning Dashboard',
+                description: 'View patterns and insights learned',
+                command: 'codehere learning overview',
+            },
+        ],
+    },
+    {
+        id: 'config-management',
+        trigger: { commands: ['ask', 'explain', 'edit'] },
+        message: 'Customize your experience:',
+        features: [
+            {
+                name: 'Configuration',
+                description: 'Manage preferences and settings',
+                command: 'codehere config',
+            },
+            {
+                name: 'Auto-completion',
+                description: 'Install shell completion for faster commands',
+                command: 'codehere completion bash',
+            },
+        ],
+    },
+];
+/**
+ * Get onboarding state from file
+ */
+function getOnboardingState() {
+    try {
+        const configDir = join(process.cwd(), 'data');
+        const onboardingPath = join(configDir, 'onboarding.json');
+        if (existsSync(onboardingPath)) {
+            const state = JSON.parse(readFileSync(onboardingPath, 'utf-8'));
+            return {
+                onboardingComplete: state.onboardingComplete || false,
+                onboardingDate: state.onboardingDate,
+                commandCount: state.commandCount || 0,
+                featuresDiscovered: state.featuresDiscovered || [],
+                lastDiscoveryShown: state.lastDiscoveryShown,
+                lastDiscoveryDate: state.lastDiscoveryDate,
+            };
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return {
+        onboardingComplete: false,
+        commandCount: 0,
+        featuresDiscovered: [],
+    };
+}
+/**
+ * Save onboarding state
+ */
+function saveOnboardingState(state) {
+    try {
+        const configDir = join(process.cwd(), 'data');
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        const onboardingPath = join(configDir, 'onboarding.json');
+        writeFileSync(onboardingPath, JSON.stringify(state, null, 2));
+    }
+    catch {
+        // Ignore errors - non-critical
+    }
+}
+/**
+ * Track command usage
+ */
+export function trackCommand(command) {
+    const state = getOnboardingState();
+    state.commandCount = (state.commandCount || 0) + 1;
+    // Track feature discovery
+    if (!state.featuresDiscovered.includes(command)) {
+        state.featuresDiscovered.push(command);
+    }
+    saveOnboardingState(state);
+}
+/**
+ * Check if feature discovery should be shown
+ */
+export function shouldShowFeatureDiscovery(command) {
+    const state = getOnboardingState();
+    // Don't show if onboarding not complete
+    if (!state.onboardingComplete) {
+        return null;
+    }
+    // Don't show discovery too frequently (once per day max)
+    const lastDate = state.lastDiscoveryDate;
+    if (lastDate) {
+        const lastShown = new Date(lastDate);
+        const now = new Date();
+        const daysSince = (now.getTime() - lastShown.getTime()) / (1000 * 60 * 60 * 24);
+        if (daysSince < 1) {
+            return null; // Already shown today
+        }
+    }
+    // Check each discovery feature
+    for (const discovery of DISCOVERY_FEATURES) {
+        // Skip if already shown
+        if (state.lastDiscoveryShown === discovery.id) {
+            continue;
+        }
+        const trigger = discovery.trigger;
+        // Check command count trigger
+        if (trigger.commandCount && state.commandCount >= trigger.commandCount) {
+            return discovery;
+        }
+        // Check commands trigger
+        if (trigger.commands && trigger.commands.includes(command)) {
+            return discovery;
+        }
+        // Check custom condition
+        if (trigger.condition && trigger.condition(state)) {
+            return discovery;
+        }
+    }
+    return null;
+}
+/**
+ * Mark feature discovery as shown
+ */
+export function markFeatureDiscoveryShown(discoveryId) {
+    const state = getOnboardingState();
+    state.lastDiscoveryShown = discoveryId;
+    state.lastDiscoveryDate = new Date().toISOString();
+    saveOnboardingState(state);
+}
+/**
+ * Check if user is first-time (onboarding not complete)
+ */
+export function isFirstTimeUser() {
+    const state = getOnboardingState();
+    return !state.onboardingComplete;
+}
+/**
+ * Get command count for analytics
+ */
+export function getCommandCount() {
+    const state = getOnboardingState();
+    return state.commandCount || 0;
+}
+//# 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":"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"}

package/dist/infrastructure/ux/hitl-review-portal.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Infrastructure: Enhanced HITL Review Portal
+ * Task 4.1: Centralized review portal for batch approval/rejection
+ *
+ * Features:
+ * - Display all pending checkpoints
+ * - Batch approval/rejection
+ * - Risk assessment visualization
+ * - Diff preview
+ */
+import { HITLValidation, ReviewCheckpoint, ReviewPriority } from './hitl-validation.js';
+export interface BatchDecision {
+    checkpointIds: string[];
+    decision: 'approve' | 'reject';
+    comment?: string;
+}
+/**
+ * Display centralized HITL review portal
+ */
+export declare function displayReviewPortal(hitlValidation: HITLValidation): {
+    checkpoints: ReviewCheckpoint[];
+    status: {
+        total: number;
+        pending: number;
+        byPriority: Record<ReviewPriority, number>;
+    };
+};
+/**
+ * Display detailed checkpoint view
+ */
+export declare function displayCheckpointDetails(checkpoint: ReviewCheckpoint): void;
+/**
+ * Display batch approval prompt
+ */
+export declare function displayBatchApprovalPrompt(checkpointIds: string[]): void;
+/**
+ * Display batch decision summary
+ */
+export declare function displayBatchDecisionSummary(decisions: Array<{
+    checkpointId: string;
+    decision: 'approve' | 'reject';
+}>): void;
+/**
+ * Format checkpoint for batch display
+ */
+export declare function formatCheckpointForBatch(checkpoint: ReviewCheckpoint): string;
+//# sourceMappingURL=hitl-review-portal.d.ts.map

package/dist/infrastructure/ux/hitl-review-portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl-review-portal.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ux/hitl-review-portal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,cAAc,GAC7B;IACD,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACxF,CAyCA;AAgCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAwD3E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAYxE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC,GACzE,IAAI,CAgBN;AAwDD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAW7E"}