codehere 0.1.1

package/dist/infrastructure/ux/cli-style-guide.js

@@ -0,0 +1,220 @@
+/**
+ * CLI UX Design System
+ * Consistent styling and output patterns for Codehere CLI
+ *
+ * Design Principles:
+ * 1. Fast perceived performance (immediate feedback)
+ * 2. Clear, actionable output
+ * 3. Progressive disclosure (brief by default, verbose on request)
+ * 4. Professional, enterprise-ready appearance
+ */
+import { colors, symbols, separator, createSpinner } from '../../ui.js';
+// ============================================================================
+// OUTPUT STRUCTURE HELPERS
+// ============================================================================
+/**
+ * Standard command header - shows what's happening
+ */
+export function printCommandHeader(command, description) {
+    console.log();
+    console.log(separator('═', 80));
+    console.log(colors.bold('Codehere') + colors.dim(` • ${command}`));
+    if (description) {
+        console.log(colors.dim(`  ${description}`));
+    }
+    console.log(separator('═', 80));
+    console.log();
+}
+/**
+ * Quick mode header indicator
+ */
+export function printQuickModeIndicator() {
+    console.log(colors.dim('  ⚡ Quick Mode - Reading files directly'));
+}
+/**
+ * Section header within output
+ */
+export function printSection(title) {
+    console.log(colors.bold(title));
+    console.log(separator('─', Math.min(title.length + 10, 60)));
+}
+/**
+ * Subsection with indent
+ */
+export function printSubsection(title) {
+    console.log(colors.dim(`  ${symbols.arrow} ${title}`));
+}
+// ============================================================================
+// STATUS MESSAGES
+// ============================================================================
+/**
+ * Success message with checkmark
+ */
+export function printSuccess(message, details) {
+    console.log(colors.green(`${symbols.success} ${message}`));
+    if (details) {
+        console.log(colors.dim(`  ${details}`));
+    }
+}
+/**
+ * Error message with X
+ */
+export function printError(message, suggestion) {
+    console.log(colors.red(`${symbols.error} ${message}`));
+    if (suggestion) {
+        console.log(colors.dim(`  Suggestion: ${suggestion}`));
+    }
+}
+/**
+ * Warning message
+ */
+export function printWarning(message) {
+    console.log(colors.yellow(`${symbols.warning} ${message}`));
+}
+/**
+ * Info message
+ */
+export function printInfo(message) {
+    console.log(colors.blue(`${symbols.info} ${message}`));
+}
+// ============================================================================
+// PROGRESS FEEDBACK
+// ============================================================================
+/**
+ * Inline progress indicator for fast operations (<2s expected)
+ * Returns a function to call when done
+ */
+export function startInlineProgress(message) {
+    process.stdout.write(colors.dim(`${symbols.processing} ${message}...`));
+    const startTime = Date.now();
+    return () => {
+        const elapsed = Date.now() - startTime;
+        const timeStr = elapsed < 1000 ? `${elapsed}ms` : `${(elapsed / 1000).toFixed(1)}s`;
+        process.stdout.write(colors.dim(` done (${timeStr})\n`));
+    };
+}
+/**
+ * Spinner for medium operations (2-10s expected)
+ */
+export function startSpinner(message) {
+    const spinner = createSpinner(message);
+    spinner.start();
+    return spinner;
+}
+/**
+ * Stop spinner with success/failure
+ */
+export function stopSpinner(spinner, success, message) {
+    if (success) {
+        spinner.succeed(message || spinner.text);
+    }
+    else {
+        spinner.fail(message || spinner.text);
+    }
+}
+// ============================================================================
+// STRUCTURED OUTPUT
+// ============================================================================
+/**
+ * Key-value pair
+ */
+export function printKeyValue(key, value, indent = 0) {
+    const padding = '  '.repeat(indent);
+    console.log(`${padding}${colors.dim(key + ':')} ${value}`);
+}
+/**
+ * List item
+ */
+export function printListItem(item, indent = 0) {
+    const padding = '  '.repeat(indent);
+    console.log(`${padding}${colors.dim(symbols.bullet)} ${item}`);
+}
+/**
+ * Code block
+ */
+export function printCodeBlock(code, language) {
+    console.log(colors.dim('```' + (language || '')));
+    console.log(code);
+    console.log(colors.dim('```'));
+}
+/**
+ * Tip/suggestion box
+ */
+export function printTip(message, command) {
+    console.log();
+    console.log(colors.cyan(`💡 Tip: ${message}`));
+    if (command) {
+        console.log(colors.dim(`   Try: ${colors.cyan(command)}`));
+    }
+}
+/**
+ * Next steps suggestion
+ */
+export function printNextSteps(steps) {
+    console.log();
+    console.log(colors.bold('Next steps:'));
+    steps.forEach((step, i) => {
+        console.log(colors.dim(`  ${i + 1}. ${step}`));
+    });
+}
+// ============================================================================
+// SUMMARY FOOTER
+// ============================================================================
+/**
+ * Standard summary footer with metrics
+ */
+export function printSummary(metrics) {
+    console.log();
+    console.log(separator('─', 40));
+    Object.entries(metrics).forEach(([key, value]) => {
+        console.log(colors.dim(`${key}: ${value}`));
+    });
+}
+/**
+ * Execution time footer
+ */
+export function printExecutionTime(startTime) {
+    const elapsed = Date.now() - startTime;
+    const timeStr = elapsed < 1000 ? `${elapsed}ms` : `${(elapsed / 1000).toFixed(2)}s`;
+    console.log(colors.dim(`Completed in ${timeStr}`));
+}
+// ============================================================================
+// INTERACTIVE ELEMENTS
+// ============================================================================
+/**
+ * Confirmation prompt styling
+ */
+export function formatConfirmPrompt(question) {
+    return `${colors.yellow('?')} ${question} ${colors.dim('(y/n)')} `;
+}
+/**
+ * Selection styling
+ */
+export function formatSelection(items, selectedIndex) {
+    return items.map((item, i) => {
+        if (i === selectedIndex) {
+            return colors.cyan(`${symbols.arrow} ${item}`);
+        }
+        return colors.dim(`  ${item}`);
+    });
+}
+// ============================================================================
+// CONSTANTS FOR CONSISTENT SIZING
+// ============================================================================
+export const CLI_CONSTANTS = {
+    MAX_WIDTH: 80,
+    INDENT_SIZE: 2,
+    PROGRESS_BAR_WIDTH: 30,
+    TRUNCATE_LENGTH: 60,
+    MAX_FILES_SHOWN: 5,
+    MAX_PREVIEW_LINES: 10,
+};
+/**
+ * Truncate text with ellipsis
+ */
+export function truncate(text, maxLength = CLI_CONSTANTS.TRUNCATE_LENGTH) {
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength - 3) + '...';
+}
+//# sourceMappingURL=cli-style-guide.js.map

package/dist/infrastructure/ux/cli-style-guide.js.map

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

package/dist/infrastructure/ux/comprehensive-formatter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Comprehensive Formatter
+ * Format content for CLI display with proper indentation and wrapping
+ *
+ * Phase 1: v0.5.0-alpha.0
+ */
+interface FormatOptions {
+    indent?: number;
+    maxWidth?: number;
+    preserveMarkdown?: boolean;
+}
+/**
+ * Format content for CLI display
+ */
+export declare function formatContent(content: string, options?: FormatOptions): string;
+/**
+ * Format reflection/analysis output
+ */
+export declare function formatReflection(reflection: any, options?: FormatOptions): string;
+export {};
+//# sourceMappingURL=comprehensive-formatter.d.ts.map

package/dist/infrastructure/ux/comprehensive-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comprehensive-formatter.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ux/comprehensive-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAsDlF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAiCrF"}

package/dist/infrastructure/ux/comprehensive-formatter.js

@@ -0,0 +1,117 @@
+/**
+ * Comprehensive Formatter
+ * Format content for CLI display with proper indentation and wrapping
+ *
+ * Phase 1: v0.5.0-alpha.0
+ */
+/**
+ * Format content for CLI display
+ */
+export function formatContent(content, options = {}) {
+    const { indent = 0, maxWidth = 76, preserveMarkdown = true, } = options;
+    if (!content) {
+        return '';
+    }
+    const indentStr = ' '.repeat(indent);
+    const actualMaxWidth = maxWidth - indent;
+    // If content is short enough, return as-is with indentation
+    if (content.length <= actualMaxWidth && !content.includes('\n')) {
+        return indentStr + content;
+    }
+    // Handle markdown code blocks
+    if (preserveMarkdown && content.includes('```')) {
+        return formatMarkdownContent(content, indent, actualMaxWidth);
+    }
+    // Simple word wrapping
+    const lines = content.split('\n');
+    const wrappedLines = [];
+    for (const line of lines) {
+        if (line.length <= actualMaxWidth) {
+            wrappedLines.push(indentStr + line);
+        }
+        else {
+            // Word wrap
+            const words = line.split(/\s+/);
+            let currentLine = '';
+            for (const word of words) {
+                if ((currentLine + word).length <= actualMaxWidth) {
+                    currentLine += (currentLine ? ' ' : '') + word;
+                }
+                else {
+                    if (currentLine) {
+                        wrappedLines.push(indentStr + currentLine);
+                    }
+                    currentLine = word;
+                }
+            }
+            if (currentLine) {
+                wrappedLines.push(indentStr + currentLine);
+            }
+        }
+    }
+    return wrappedLines.join('\n');
+}
+/**
+ * Format reflection/analysis output
+ */
+export function formatReflection(reflection, options = {}) {
+    if (!reflection) {
+        return '';
+    }
+    if (typeof reflection === 'string') {
+        return formatContent(reflection, options);
+    }
+    if (typeof reflection === 'object') {
+        // Format structured reflection
+        const parts = [];
+        if (reflection.insight) {
+            parts.push(`💡 Insight:\n${formatContent(reflection.insight, { ...options, indent: (options.indent || 0) + 2 })}`);
+        }
+        if (reflection.reasoning) {
+            parts.push(`🧠 Reasoning:\n${formatContent(reflection.reasoning, { ...options, indent: (options.indent || 0) + 2 })}`);
+        }
+        if (reflection.summary) {
+            parts.push(`📋 Summary:\n${formatContent(reflection.summary, { ...options, indent: (options.indent || 0) + 2 })}`);
+        }
+        if (parts.length === 0) {
+            return formatContent(JSON.stringify(reflection, null, 2), options);
+        }
+        return parts.join('\n\n');
+    }
+    return String(reflection);
+}
+/**
+ * Format markdown content with code block preservation
+ */
+function formatMarkdownContent(content, indent, maxWidth) {
+    const indentStr = ' '.repeat(indent);
+    const lines = content.split('\n');
+    const formatted = [];
+    let inCodeBlock = false;
+    let codeBlockLang = '';
+    for (const line of lines) {
+        if (line.trim().startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+            if (inCodeBlock) {
+                codeBlockLang = line.trim().substring(3).trim();
+            }
+            formatted.push(indentStr + line);
+        }
+        else if (inCodeBlock) {
+            // Preserve code blocks as-is
+            formatted.push(indentStr + line);
+        }
+        else {
+            // Format regular markdown lines
+            if (line.length <= maxWidth) {
+                formatted.push(indentStr + line);
+            }
+            else {
+                // Word wrap for non-code content
+                formatted.push(formatContent(line, { indent, maxWidth: maxWidth + indent }));
+            }
+        }
+    }
+    return formatted.join('\n');
+}
+//# sourceMappingURL=comprehensive-formatter.js.map

package/dist/infrastructure/ux/comprehensive-formatter.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * Contextual Feature Discovery (v0.5.0-alpha.0 - Stub)
+ * TODO: Implement contextual feature suggestions
+ */
+export interface ContextualSuggestion {
+    reason: string;
+    command: string;
+    description: string;
+}
+export declare function shouldShowContextualSuggestion(query: string, command?: string): ContextualSuggestion | null;
+//# sourceMappingURL=contextual-feature-discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextual-feature-discovery.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ux/contextual-feature-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAI3G"}

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

@@ -0,0 +1,10 @@
+/**
+ * Contextual Feature Discovery (v0.5.0-alpha.0 - Stub)
+ * TODO: Implement contextual feature suggestions
+ */
+export function shouldShowContextualSuggestion(query, command) {
+    // In alpha, return null (no suggestions)
+    // Can be enhanced later with heuristics
+    return null;
+}
+//# sourceMappingURL=contextual-feature-discovery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextual-feature-discovery.js","sourceRoot":"","sources":["../../../src/infrastructure/ux/contextual-feature-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,8BAA8B,CAAC,KAAa,EAAE,OAAgB;IAC5E,yCAAyC;IACzC,wCAAwC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,98 @@
+/**
+ * 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
+ */
+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 interface AIDisclaimerNotice {
+    shown: boolean;
+    shownDate?: string;
+}
+export declare class ExpectationManagement {
+    private messages;
+    private shownMessages;
+    private disclaimerShown;
+    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;
+    /**
+     * Check if first-time AI operation disclaimer should be shown
+     */
+    shouldShowFirstTimeDisclaimer(): boolean;
+    /**
+     * Get first-time AI operation disclaimer notice
+     */
+    getFirstTimeDisclaimer(): string;
+    /**
+     * Mark first-time disclaimer as shown
+     */
+    markDisclaimerShown(): void;
+    /**
+     * Get uncertainty indicator message
+     */
+    getUncertaintyIndicator(confidence: number): string | null;
+    /**
+     * Get capability boundaries notice
+     */
+    getCapabilityBoundaries(): string;
+    /**
+     * Format disclaimer for console display (honest tone, no anthropomorphization)
+     */
+    formatDisclaimerForConsole(): string;
+    private loadDisclaimerState;
+    private saveDisclaimerState;
+}
+//# 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;;;;;;;;;;;;;GAaG;AAKH,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,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,eAAe,CAAkB;;IAOzC;;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;IAenC;;OAEG;IACH,6BAA6B,IAAI,OAAO;IAIxC;;OAEG;IACH,sBAAsB,IAAI,MAAM;IAoBhC;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAK3B;;OAEG;IACH,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAoB1D;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAwBjC;;OAEG;IACH,0BAA0B,IAAI,MAAM;IAkBpC,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,mBAAmB;CAkB5B"}