@phuetz/code-buddy 0.1.0

package/dist/utils/history-manager.js

@@ -0,0 +1,486 @@
+/**
+ * History Manager for CLI commands
+ *
+ * Inspired by mistral-vibe's history_manager.py that provides:
+ * - Command history navigation with up/down arrows
+ * - Prefix filtering for quick command recall
+ * - Persistent storage in JSON format
+ * - Duplicate prevention
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+/**
+ * Manages command history with prefix filtering and navigation
+ */
+export class HistoryManager {
+    config;
+    history = [];
+    navigationIndex = -1;
+    temporaryInput = '';
+    currentPrefix = '';
+    reverseSearchState = {
+        active: false,
+        query: '',
+        matchIndex: 0,
+        matches: [],
+        originalInput: '',
+    };
+    static DEFAULT_CONFIG = {
+        maxEntries: 1000, // Increased default limit
+        historyFile: path.join(os.homedir(), '.codebuddy', 'history.json'),
+        excludePrefixes: [], // Include all commands by default
+        includeSlashCommands: true, // Include slash commands
+    };
+    constructor(config = {}) {
+        this.config = { ...HistoryManager.DEFAULT_CONFIG, ...config };
+        this.loadHistory();
+    }
+    /**
+     * Load history from file
+     */
+    loadHistory() {
+        try {
+            if (fs.existsSync(this.config.historyFile)) {
+                const data = fs.readFileSync(this.config.historyFile, 'utf-8');
+                const parsed = JSON.parse(data);
+                // Handle both old format (string[]) and new format (HistoryEntry[])
+                if (Array.isArray(parsed)) {
+                    if (parsed.length > 0 && typeof parsed[0] === 'string') {
+                        // Old format - convert to new format
+                        this.history = parsed.map((text) => ({
+                            text,
+                            timestamp: Date.now(),
+                        }));
+                    }
+                    else {
+                        this.history = parsed;
+                    }
+                }
+                // Trim to max entries
+                if (this.history.length > this.config.maxEntries) {
+                    this.history = this.history.slice(-this.config.maxEntries);
+                }
+            }
+        }
+        catch (error) {
+            // Graceful degradation - start with empty history
+            console.warn('Failed to load history:', error);
+            this.history = [];
+        }
+    }
+    /**
+     * Save history to file
+     */
+    saveHistory() {
+        try {
+            const dir = path.dirname(this.config.historyFile);
+            fs.ensureDirSync(dir);
+            fs.writeFileSync(this.config.historyFile, JSON.stringify(this.history, null, 2), 'utf-8');
+        }
+        catch (error) {
+            console.warn('Failed to save history:', error);
+        }
+    }
+    /**
+     * Add a new entry to history
+     * @param text - The command text to add
+     * @returns true if added, false if excluded or duplicate
+     */
+    add(text) {
+        // Trim whitespace
+        const trimmed = text.trim();
+        if (!trimmed)
+            return false;
+        // Check excluded prefixes (like slash commands)
+        for (const prefix of this.config.excludePrefixes) {
+            if (trimmed.startsWith(prefix)) {
+                return false;
+            }
+        }
+        // Prevent consecutive duplicates
+        if (this.history.length > 0) {
+            const lastEntry = this.history[this.history.length - 1];
+            if (lastEntry.text === trimmed) {
+                return false;
+            }
+        }
+        // Add new entry
+        this.history.push({
+            text: trimmed,
+            timestamp: Date.now(),
+        });
+        // Enforce max entries limit
+        if (this.history.length > this.config.maxEntries) {
+            this.history = this.history.slice(-this.config.maxEntries);
+        }
+        // Save to file
+        this.saveHistory();
+        return true;
+    }
+    /**
+     * Get the previous entry in history (navigate up)
+     * @param currentInput - The current input text (saved for restoration)
+     * @param prefix - Optional prefix to filter by
+     * @returns The previous matching history entry, or currentInput if at start
+     */
+    getPrevious(currentInput, prefix) {
+        // Save current input if starting navigation
+        if (this.navigationIndex === -1) {
+            this.temporaryInput = currentInput;
+            this.currentPrefix = prefix || '';
+        }
+        // Filter history by prefix if provided
+        const filtered = this.getFilteredHistory(this.currentPrefix);
+        if (filtered.length === 0) {
+            return currentInput;
+        }
+        // Navigate backward
+        if (this.navigationIndex < filtered.length - 1) {
+            this.navigationIndex++;
+        }
+        return filtered[filtered.length - 1 - this.navigationIndex]?.text || currentInput;
+    }
+    /**
+     * Get the next entry in history (navigate down)
+     * @param prefix - Optional prefix to filter by
+     * @returns The next matching history entry, or the temporary input
+     */
+    getNext(prefix) {
+        // Can't navigate forward past the start
+        if (this.navigationIndex <= 0) {
+            this.resetNavigation();
+            return this.temporaryInput;
+        }
+        const filtered = this.getFilteredHistory(prefix || this.currentPrefix);
+        this.navigationIndex--;
+        if (this.navigationIndex < 0) {
+            return this.temporaryInput;
+        }
+        return filtered[filtered.length - 1 - this.navigationIndex]?.text || this.temporaryInput;
+    }
+    /**
+     * Get history filtered by prefix
+     */
+    getFilteredHistory(prefix) {
+        if (!prefix) {
+            return this.history;
+        }
+        return this.history.filter(entry => entry.text.toLowerCase().startsWith(prefix.toLowerCase()));
+    }
+    /**
+     * Reset navigation state
+     */
+    resetNavigation() {
+        this.navigationIndex = -1;
+        this.temporaryInput = '';
+        this.currentPrefix = '';
+    }
+    /**
+     * Search history for entries containing a query
+     * @param query - The search query
+     * @param limit - Maximum number of results
+     * @returns Matching history entries (most recent first)
+     */
+    search(query, limit = 10) {
+        const lowerQuery = query.toLowerCase();
+        return this.history
+            .filter(entry => entry.text.toLowerCase().includes(lowerQuery))
+            .slice(-limit)
+            .reverse();
+    }
+    /**
+     * Get all history entries
+     */
+    getAll() {
+        return [...this.history];
+    }
+    /**
+     * Get recent history entries
+     */
+    getRecent(limit = 10) {
+        return this.history.slice(-limit).reverse();
+    }
+    /**
+     * Clear all history
+     */
+    clear() {
+        this.history = [];
+        this.resetNavigation();
+        this.saveHistory();
+    }
+    /**
+     * Get current navigation index (for debugging)
+     */
+    getNavigationIndex() {
+        return this.navigationIndex;
+    }
+    /**
+     * Get history count
+     */
+    get count() {
+        return this.history.length;
+    }
+    /**
+     * Get auto-completion suggestions based on input prefix
+     * @param prefix - The current input to complete
+     * @param limit - Maximum number of suggestions
+     * @returns Array of matching history entries, scored by relevance
+     */
+    getSuggestions(prefix, limit = 5) {
+        if (!prefix || prefix.length < 2) {
+            return [];
+        }
+        const lowerPrefix = prefix.toLowerCase();
+        const scored = [];
+        for (const entry of this.history) {
+            const lowerText = entry.text.toLowerCase();
+            // Exact prefix match gets highest score
+            if (lowerText.startsWith(lowerPrefix)) {
+                scored.push({
+                    text: entry.text,
+                    score: 100 + (1000 - entry.text.length), // Prefer shorter matches
+                });
+            }
+            // Word boundary match gets medium score
+            else if (lowerText.includes(' ' + lowerPrefix) || lowerText.includes('\n' + lowerPrefix)) {
+                scored.push({
+                    text: entry.text,
+                    score: 50,
+                });
+            }
+            // Contains match gets lower score
+            else if (lowerText.includes(lowerPrefix)) {
+                scored.push({
+                    text: entry.text,
+                    score: 25,
+                });
+            }
+        }
+        // Sort by score descending, then by recency
+        scored.sort((a, b) => b.score - a.score);
+        // Remove duplicates and return top matches
+        const seen = new Set();
+        const results = [];
+        for (const item of scored) {
+            if (!seen.has(item.text)) {
+                seen.add(item.text);
+                results.push(item.text);
+                if (results.length >= limit)
+                    break;
+            }
+        }
+        return results;
+    }
+    /**
+     * Get the best single completion for inline suggestion
+     * @param prefix - The current input
+     * @returns The best matching completion or null
+     */
+    getInlineCompletion(prefix) {
+        if (!prefix || prefix.length < 3) {
+            return null;
+        }
+        const lowerPrefix = prefix.toLowerCase();
+        // Look for exact prefix matches, preferring recent entries
+        for (let i = this.history.length - 1; i >= 0; i--) {
+            const entry = this.history[i];
+            if (entry.text.toLowerCase().startsWith(lowerPrefix) && entry.text.length > prefix.length) {
+                return entry.text;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get frequently used commands
+     * @param limit - Maximum number of results
+     * @returns Most frequently used commands
+     */
+    getFrequent(limit = 10) {
+        const counts = new Map();
+        for (const entry of this.history) {
+            const count = counts.get(entry.text) || 0;
+            counts.set(entry.text, count + 1);
+        }
+        return Array.from(counts.entries())
+            .map(([text, count]) => ({ text, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, limit);
+    }
+    // ============================================================================
+    // Reverse Search (Ctrl+R) Methods
+    // ============================================================================
+    /**
+     * Start reverse search mode
+     * @param currentInput - Current input to save for restoration
+     */
+    startReverseSearch(currentInput) {
+        this.reverseSearchState = {
+            active: true,
+            query: '',
+            matchIndex: 0,
+            matches: [],
+            originalInput: currentInput,
+        };
+    }
+    /**
+     * Check if reverse search is active
+     */
+    isReverseSearchActive() {
+        return this.reverseSearchState.active;
+    }
+    /**
+     * Get the current reverse search state
+     */
+    getReverseSearchState() {
+        return { ...this.reverseSearchState };
+    }
+    /**
+     * Update the reverse search query and find matches
+     * @param query - The search query
+     * @returns The best matching entry or null
+     */
+    updateReverseSearch(query) {
+        this.reverseSearchState.query = query;
+        if (!query) {
+            this.reverseSearchState.matches = [];
+            this.reverseSearchState.matchIndex = 0;
+            return null;
+        }
+        // Find all matching entries (most recent first)
+        const lowerQuery = query.toLowerCase();
+        this.reverseSearchState.matches = this.history
+            .filter(entry => entry.text.toLowerCase().includes(lowerQuery))
+            .reverse();
+        this.reverseSearchState.matchIndex = 0;
+        return this.reverseSearchState.matches[0] || null;
+    }
+    /**
+     * Navigate to the next match in reverse search (older)
+     * @returns The next matching entry or null
+     */
+    reverseSearchNext() {
+        const { matches, matchIndex } = this.reverseSearchState;
+        if (matches.length === 0)
+            return null;
+        const newIndex = Math.min(matchIndex + 1, matches.length - 1);
+        this.reverseSearchState.matchIndex = newIndex;
+        return matches[newIndex] || null;
+    }
+    /**
+     * Navigate to the previous match in reverse search (newer)
+     * @returns The previous matching entry or null
+     */
+    reverseSearchPrev() {
+        const { matches, matchIndex } = this.reverseSearchState;
+        if (matches.length === 0)
+            return null;
+        const newIndex = Math.max(matchIndex - 1, 0);
+        this.reverseSearchState.matchIndex = newIndex;
+        return matches[newIndex] || null;
+    }
+    /**
+     * Accept the current reverse search match
+     * @returns The selected entry text or original input if no match
+     */
+    acceptReverseSearch() {
+        const { matches, matchIndex, originalInput } = this.reverseSearchState;
+        const result = matches[matchIndex]?.text || originalInput;
+        this.cancelReverseSearch();
+        return result;
+    }
+    /**
+     * Cancel reverse search and restore original input
+     * @returns The original input before search started
+     */
+    cancelReverseSearch() {
+        const originalInput = this.reverseSearchState.originalInput;
+        this.reverseSearchState = {
+            active: false,
+            query: '',
+            matchIndex: 0,
+            matches: [],
+            originalInput: '',
+        };
+        return originalInput;
+    }
+    /**
+     * Get formatted display for reverse search prompt
+     * @returns Formatted string showing search state
+     */
+    formatReverseSearchPrompt() {
+        const { query, matches, matchIndex } = this.reverseSearchState;
+        const matchCount = matches.length;
+        const currentMatch = matches[matchIndex];
+        if (!query) {
+            return '(reverse-i-search)`\': ';
+        }
+        if (matchCount === 0) {
+            return `(reverse-i-search)\`${query}': [no match]`;
+        }
+        const position = matchCount > 1 ? ` [${matchIndex + 1}/${matchCount}]` : '';
+        return `(reverse-i-search)\`${query}'${position}: ${currentMatch?.text || ''}`;
+    }
+    /**
+     * Format history list for display
+     * @param limit - Maximum entries to show
+     * @param showTimestamp - Whether to show timestamps
+     * @returns Formatted history string
+     */
+    formatHistoryList(limit = 20, showTimestamp = false) {
+        const entries = this.getRecent(limit);
+        if (entries.length === 0) {
+            return 'No command history.';
+        }
+        const lines = ['Command History:', ''];
+        entries.forEach((entry, index) => {
+            const num = String(entries.length - index).padStart(4, ' ');
+            if (showTimestamp) {
+                const date = new Date(entry.timestamp);
+                const timeStr = date.toLocaleString();
+                lines.push(`${num}  ${timeStr}  ${entry.text}`);
+            }
+            else {
+                lines.push(`${num}  ${entry.text}`);
+            }
+        });
+        lines.push('');
+        lines.push(`Total: ${this.count} entries (showing ${entries.length})`);
+        return lines.join('\n');
+    }
+    /**
+     * Get the configured maximum entries
+     */
+    getMaxEntries() {
+        return this.config.maxEntries;
+    }
+    /**
+     * Set the maximum number of entries
+     * @param max - New maximum (will trim history if needed)
+     */
+    setMaxEntries(max) {
+        this.config.maxEntries = max;
+        if (this.history.length > max) {
+            this.history = this.history.slice(-max);
+            this.saveHistory();
+        }
+    }
+}
+// Singleton instance
+let historyManager = null;
+/**
+ * Get the global history manager instance
+ */
+export function getHistoryManager() {
+    if (!historyManager) {
+        historyManager = new HistoryManager();
+    }
+    return historyManager;
+}
+/**
+ * Create a new history manager with custom config
+ */
+export function createHistoryManager(config) {
+    return new HistoryManager(config);
+}
+//# sourceMappingURL=history-manager.js.map

package/dist/utils/history-manager.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Utils Module - Centralized exports for utility functions
+ *
+ * Note: Some modules have types with the same names (e.g., CacheEntry, CacheStats).
+ * Import directly from the specific module if you need a specific version.
+ */
+export { CodeBuddyError, APIKeyError, APIError, NetworkError, TimeoutError, FileError, FileNotFoundError, ToolExecutionError, InvalidCommandError, CommandExecutionError, ValidationError as CodeBuddyValidationError, ConfigurationError, MCPError, SearchError, ParserError, PathTraversalError, JSONParseError, LoopTimeoutError, UserFriendlyError, ModelNotFoundError, ToolArgumentParseError, ProviderNotAvailableError, isCodeBuddyError, getErrorMessage, withTimeout, withRetry, createLoopGuard, type LoopGuardOptions, type UserFriendlyErrorOptions, } from "./errors.js";
+export { Logger, LogLevel, LogFormat, LogContext, LogEntry, LoggerOptions, getLogger, createLogger, resetLogger, logger, isDebugEnabled, debug, } from "./logger.js";
+export { LRUCache, LRUCacheOptions, CacheEntry as LRUCacheEntry, CacheStats as LRUCacheStats, } from "./lru-cache.js";
+export { PathValidator, PathValidatorOptions, PathValidationResult, getPathValidator, initializePathValidator, validatePath, isPathSafe, } from "./path-validator.js";
+export { ValidationResult, ValidationOptions, validateString, validateStringLength, validatePattern, validateNumber, validateNumberRange, validatePositiveInteger, validateArray, validateObject, validateChoice, validateBoolean, validateUrl, validateEmail, validateFilePath, validateOptional, validateWithDefault, validateSchema, assertValid, assertString, assertNumber, validateCommand, sanitizeForShell, sanitizeFilePath as sanitizeFilePathInput, isPathSafeForWrite, sanitizeUrl as sanitizeUrlInput, isUrlSafe as isUrlSafeInput, validators, type UnifiedValidationResult, type PathValidationOptions, type UrlValidationOptions, type JsonParseOptions, type SanitizeOptions, VALIDATION_LIMITS, TOOL_SCHEMAS, validateToolArgs, safeValidateToolArgs, ToolValidationError, } from "./input-validator.js";
+export { SettingsManager, getSettingsManager, } from "./settings-manager.js";
+export type { UserSettings, ProjectSettings, } from "./settings-manager.js";
+export { ConfigValidator, ValidationError as ConfigValidationError, ValidationResult as ConfigValidationResult, JSONSchema, SCHEMAS, getConfigValidator, validateStartupConfig, } from "./config-validator.js";
+export { ModelConfig as ModelConfigType, ModelOption, getCurrentModel, loadModelConfig, getDefaultModels, updateCurrentModel, updateDefaultModel, } from "./model-config.js";
+export { ModelName, ModelProvider, ModelInfo, isSupportedModel, getModelInfo, validateModel, getDefaultModel, getSupportedModels, getModelsByProvider, suggestModel, formatModelInfo, } from "./model-utils.js";
+export { CostTracker, TokenUsage, CostReport, CostConfig, ModelPricing, getCostTracker, } from "./cost-tracker.js";
+export { RateLimiter, RateLimitConfig, RateLimitStatus, QueuedRequest, getRateLimiter, resetRateLimiter, rateLimited, } from "./rate-limiter.js";
+export { Cache, CacheEntry as SimpleCacheEntry, createCacheKey, } from "./cache.js";
+export { ResponseCache, CacheEntry as ResponseCacheEntry, CacheStats as ResponseCacheStats, getResponseCache, resetResponseCache, } from "./response-cache.js";
+export { SemanticCache, CacheEntry as SemanticCacheEntry, CacheConfig as SemanticCacheConfig, CacheStats as SemanticCacheStats, CacheLookupResult, getApiCache, resetApiCache, createToolCacheKey, isCacheable, } from "./semantic-cache.js";
+export { TextPosition, TextSelection, isWordBoundary, findWordStart, findWordEnd, moveToPreviousWord, moveToNextWord, deleteWordBefore, deleteWordAfter, getTextPosition, moveToLineStart, moveToLineEnd, deleteCharBefore, deleteCharAfter, insertText, } from "./text-utils.js";
+export { sanitizeFilePath, sanitizeCommandArg, escapeRegex, sanitizeHTML, sanitizeEmail as sanitizeEmailAddress, sanitizeURL, isAlphanumeric, truncateString, removeControlCharacters, sanitizeJSON, sanitizePort, sanitizeLLMOutput, ExtractedToolCall, extractCommentaryToolCalls, } from "./sanitize.js";
+export { TokenCounter, formatTokenCount, createTokenCounter, countTokens, } from "./token-counter.js";
+export { AutonomyManager, AutonomyLevel, AutonomyConfig, YOLOConfig, getAutonomyManager, } from "./autonomy-manager.js";
+export { ModelRouter, ModelRouterConfig, ModelConfig as RouterModelConfig, TaskType, getModelRouter, } from "./model-router.js";
+export { WorkspaceDetector, WorkspaceConfig, ProjectType, PackageManager, getWorkspaceDetector, detectWorkspace, } from "./workspace-detector.js";
+export { ConfirmationService, ConfirmationOptions, ConfirmationResult, } from "./confirmation-service.js";
+export { SelfHealingEngine, SelfHealingOptions, FixAttempt, SelfHealingResult, getSelfHealingEngine, resetSelfHealingEngine, } from "./self-healing.js";
+export { ErrorContext, ERROR_TEMPLATES, formatError, formatErrorJson, createErrorContext, printError, printErrorJson, formatWarning, formatSuccess, formatInfo, } from "./error-formatter.js";
+export { EXIT_CODES, ExitCode, EXIT_CODE_DESCRIPTIONS, exitWithCode, getExitCodeDescription, errorToExitCode, handleFatalError, } from "./exit-codes.js";
+export { ParseResult as TestParseResult, parseTestOutput, isLikelyTestOutput, createTestResultsData, } from "./test-output-parser.js";
+export { CustomCommand, loadCustomCommands, getCustomCommand, processCommandPrompt, ensureCommandDirectories, createSampleCommand, } from "./custom-commands.js";
+export { loadCustomInstructions } from "./custom-instructions.js";
+export { ConversationExporter, ExportOptions, getConversationExporter, resetConversationExporter, } from "./conversation-export.js";
+export { ShellType, CompletionOption, generateCompletion, getInstallInstructions, printCompletion, getSlashCommands, getCliOptions, } from "./shell-completions.js";
+export { parseJSON, parseJSONSafe, parseJSONStrict, parseJSONUntyped, validateObject as validateObjectWithZod, formatZodError, isValidJSON, matchesSchema, ConfigFileSchema, ApprovalModeConfigSchema, SettingsSchema, SessionSchema, CacheEntrySchema, ToolCallSchema, LLMResponseSchema, GitHubPRSchema, HookConfigSchema, z, type ParseResult as ZodParseResult, type ValidationOptions as ZodValidationOptions, } from "./json-validator.js";
+export { withStreamTimeout, safeStreamRead, withMaxIterations, handleStreamError, createTimeoutController, mergeAsyncIterables, drainAsyncIterable, type StreamTimeoutOptions, type SafeStreamReadOptions, type SafeStreamReadResult, type StreamErrorContext, } from "./stream-helpers.js";

package/dist/utils/index.js

@@ -0,0 +1,83 @@
+/**
+ * Utils Module - Centralized exports for utility functions
+ *
+ * Note: Some modules have types with the same names (e.g., CacheEntry, CacheStats).
+ * Import directly from the specific module if you need a specific version.
+ */
+// Core utilities - errors provides base error classes
+export { 
+// Base error classes
+CodeBuddyError, APIKeyError, APIError, NetworkError, TimeoutError, FileError, FileNotFoundError, ToolExecutionError, InvalidCommandError, CommandExecutionError, ValidationError as CodeBuddyValidationError, ConfigurationError, MCPError, SearchError, ParserError, PathTraversalError, JSONParseError, LoopTimeoutError, 
+// User-friendly error classes for better UX
+UserFriendlyError, ModelNotFoundError, ToolArgumentParseError, ProviderNotAvailableError, 
+// Utility functions
+isCodeBuddyError, getErrorMessage, withTimeout, withRetry, createLoopGuard, } from "./errors.js";
+// Logger
+export { Logger, getLogger, createLogger, resetLogger, logger, isDebugEnabled, debug, } from "./logger.js";
+// LRU Cache (primary cache implementation)
+export { LRUCache, } from "./lru-cache.js";
+// Path and input validation
+export { PathValidator, getPathValidator, initializePathValidator, validatePath, isPathSafe, } from "./path-validator.js";
+export { 
+// String validators
+validateString, validateStringLength, validatePattern, 
+// Number validators
+validateNumber, validateNumberRange, validatePositiveInteger, 
+// Collection validators
+validateArray, validateObject, validateChoice, validateBoolean, 
+// Special validators
+validateUrl, validateEmail, validateFilePath, 
+// Composite validators
+validateOptional, validateWithDefault, validateSchema, 
+// Assertion helpers
+assertValid, assertString, assertNumber, 
+// Command validation
+validateCommand, sanitizeForShell, 
+// Path sanitization
+sanitizeFilePath as sanitizeFilePathInput, isPathSafeForWrite, 
+// URL sanitization
+sanitizeUrl as sanitizeUrlInput, isUrlSafe as isUrlSafeInput, 
+// Unified validators object (recommended API)
+validators, 
+// Tool validation
+VALIDATION_LIMITS, TOOL_SCHEMAS, validateToolArgs, safeValidateToolArgs, ToolValidationError, } from "./input-validator.js";
+// Settings and configuration
+export { SettingsManager, getSettingsManager, } from "./settings-manager.js";
+export { ConfigValidator, SCHEMAS, getConfigValidator, validateStartupConfig, } from "./config-validator.js";
+export { getCurrentModel, loadModelConfig, getDefaultModels, updateCurrentModel, updateDefaultModel, } from "./model-config.js";
+export { isSupportedModel, getModelInfo, validateModel, getDefaultModel, getSupportedModels, getModelsByProvider, suggestModel, formatModelInfo, } from "./model-utils.js";
+// Cost and rate limiting
+export { CostTracker, getCostTracker, } from "./cost-tracker.js";
+export { RateLimiter, getRateLimiter, resetRateLimiter, rateLimited, } from "./rate-limiter.js";
+// Caching - export with prefixed names to avoid conflicts
+export { Cache, createCacheKey, } from "./cache.js";
+export { ResponseCache, getResponseCache, resetResponseCache, } from "./response-cache.js";
+export { SemanticCache, getApiCache, resetApiCache, createToolCacheKey, isCacheable, } from "./semantic-cache.js";
+// Text processing
+export { isWordBoundary, findWordStart, findWordEnd, moveToPreviousWord, moveToNextWord, deleteWordBefore, deleteWordAfter, getTextPosition, moveToLineStart, moveToLineEnd, deleteCharBefore, deleteCharAfter, insertText, } from "./text-utils.js";
+export { sanitizeFilePath, sanitizeCommandArg, escapeRegex, sanitizeHTML, sanitizeEmail as sanitizeEmailAddress, sanitizeURL, isAlphanumeric, truncateString, removeControlCharacters, sanitizeJSON, sanitizePort, sanitizeLLMOutput, extractCommentaryToolCalls, } from "./sanitize.js";
+export { TokenCounter, formatTokenCount, createTokenCounter, countTokens, } from "./token-counter.js";
+// System utilities
+export { AutonomyManager, getAutonomyManager, } from "./autonomy-manager.js";
+export { ModelRouter, getModelRouter, } from "./model-router.js";
+export { WorkspaceDetector, getWorkspaceDetector, detectWorkspace, } from "./workspace-detector.js";
+export { ConfirmationService, } from "./confirmation-service.js";
+export { SelfHealingEngine, getSelfHealingEngine, resetSelfHealingEngine, } from "./self-healing.js";
+// Error handling
+export { ERROR_TEMPLATES, formatError, formatErrorJson, createErrorContext, printError, printErrorJson, formatWarning, formatSuccess, formatInfo, } from "./error-formatter.js";
+export { EXIT_CODES, EXIT_CODE_DESCRIPTIONS, exitWithCode, getExitCodeDescription, errorToExitCode, handleFatalError, } from "./exit-codes.js";
+// Specialized utilities
+export { parseTestOutput, isLikelyTestOutput, createTestResultsData, } from "./test-output-parser.js";
+export { loadCustomCommands, getCustomCommand, processCommandPrompt, ensureCommandDirectories, createSampleCommand, } from "./custom-commands.js";
+export { loadCustomInstructions } from "./custom-instructions.js";
+export { ConversationExporter, getConversationExporter, resetConversationExporter, } from "./conversation-export.js";
+export { generateCompletion, getInstallInstructions, printCompletion, getSlashCommands, getCliOptions, } from "./shell-completions.js";
+// JSON validation with Zod
+export { parseJSON, parseJSONSafe, parseJSONStrict, parseJSONUntyped, validateObject as validateObjectWithZod, formatZodError, isValidJSON, matchesSchema, 
+// Common schemas
+ConfigFileSchema, ApprovalModeConfigSchema, SettingsSchema, SessionSchema, CacheEntrySchema, ToolCallSchema, LLMResponseSchema, GitHubPRSchema, HookConfigSchema, 
+// Re-export zod for convenience
+z, } from "./json-validator.js";
+// Stream helpers
+export { withStreamTimeout, safeStreamRead, withMaxIterations, handleStreamError, createTimeoutController, mergeAsyncIterables, drainAsyncIterable, } from "./stream-helpers.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/utils/init-project.d.ts

@@ -0,0 +1,23 @@
+export interface InitOptions {
+    force?: boolean;
+    includeHooks?: boolean;
+    includeMcp?: boolean;
+    includeCommands?: boolean;
+    includeSecurity?: boolean;
+    includeGitignore?: boolean;
+}
+export interface InitResult {
+    success: boolean;
+    created: string[];
+    skipped: string[];
+    errors: string[];
+}
+/**
+ * Initialize .grok directory with templates and configurations
+ * Similar to Claude Code's project initialization
+ */
+export declare function initCodeBuddyProject(workingDirectory?: string, options?: InitOptions): InitResult;
+/**
+ * Format init result for display
+ */
+export declare function formatInitResult(result: InitResult): string;