@compilr-dev/cli 0.4.0

package/dist/settings/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Settings Module
+ *
+ * Centralized settings management for the CLI.
+ * Persistence in ~/.compilr-dev/settings.json
+ */
+export type PermissionMode = 'default' | 'plan' | 'bypass';
+export type NotificationMode = 'auto' | 'enabled' | 'disabled';
+export type OutputStyle = 'default' | 'compact' | 'verbose';
+export type EditorMode = 'normal' | 'vim' | 'emacs';
+export type ProviderType = 'auto' | 'claude' | 'openai' | 'gemini' | 'ollama';
+export interface Settings {
+    theme?: string;
+    defaultProvider: ProviderType;
+    defaultModel: string | null;
+    autoCompact: boolean;
+    showTips: boolean;
+    reviseCode: boolean;
+    verbose: boolean;
+    progressBar: boolean;
+    gitignore: boolean;
+    autoInstall: boolean;
+    permissionMode: PermissionMode;
+    notifications: NotificationMode;
+    outputStyle: OutputStyle;
+    editorMode: EditorMode;
+}
+/**
+ * Get all settings (cached)
+ */
+export declare function getSettings(): Settings;
+/**
+ * Get a single setting
+ */
+export declare function getSetting<K extends keyof Settings>(key: K): Settings[K];
+/**
+ * Set a single setting
+ */
+export declare function setSetting<K extends keyof Settings>(key: K, value: Settings[K]): void;
+/**
+ * Update multiple settings at once
+ */
+export declare function updateSettings(updates: Partial<Settings>): void;
+/**
+ * Reset all settings to defaults
+ */
+export declare function resetSettings(): void;
+/**
+ * Clear settings cache (for testing or forced reload)
+ */
+export declare function clearSettingsCache(): void;
+export declare const getDefaultProvider: () => ProviderType;
+export declare const getDefaultModel: () => string | null;
+export declare const isAutoCompactEnabled: () => boolean;
+export declare const isShowTipsEnabled: () => boolean;
+export declare const isReviseCodeEnabled: () => boolean;
+export declare const isVerboseEnabled: () => boolean;
+export declare const isProgressBarEnabled: () => boolean;
+export declare const isGitignoreEnabled: () => boolean;
+export declare const isAutoInstallEnabled: () => boolean;
+export declare const getPermissionMode: () => PermissionMode;
+export declare const getNotificationMode: () => NotificationMode;
+export declare const getOutputStyle: () => OutputStyle;
+export declare const getEditorMode: () => EditorMode;
+/**
+ * Map internal permission mode to display value
+ */
+export declare function permissionModeToDisplay(mode: PermissionMode): string;
+/**
+ * Map display value to internal permission mode
+ */
+export declare function displayToPermissionMode(display: string): PermissionMode;
+/**
+ * Map internal notification mode to display value
+ */
+export declare function notificationModeToDisplay(mode: NotificationMode): string;
+/**
+ * Map display value to internal notification mode
+ */
+export declare function displayToNotificationMode(display: string): NotificationMode;

package/dist/settings/index.js

@@ -0,0 +1,195 @@
+/**
+ * Settings Module
+ *
+ * Centralized settings management for the CLI.
+ * Persistence in ~/.compilr-dev/settings.json
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// =============================================================================
+// Constants
+// =============================================================================
+const CONFIG_DIR = path.join(os.homedir(), '.compilr-dev');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'settings.json');
+// =============================================================================
+// Defaults
+// =============================================================================
+const DEFAULT_SETTINGS = {
+    theme: 'compilr-dark',
+    // Provider/Model defaults
+    defaultProvider: 'auto',
+    defaultModel: null,
+    // Boolean defaults
+    autoCompact: true,
+    showTips: true,
+    reviseCode: true,
+    verbose: false,
+    progressBar: true,
+    gitignore: true,
+    autoInstall: true,
+    // Cycle defaults
+    permissionMode: 'default',
+    notifications: 'auto',
+    outputStyle: 'default',
+    editorMode: 'normal',
+};
+// =============================================================================
+// In-memory cache
+// =============================================================================
+let settingsCache = null;
+// =============================================================================
+// Persistence
+// =============================================================================
+/**
+ * Load settings from disk
+ */
+function loadFromDisk() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const data = fs.readFileSync(CONFIG_FILE, 'utf-8');
+            return JSON.parse(data);
+        }
+    }
+    catch {
+        // Ignore errors, return empty
+    }
+    return {};
+}
+/**
+ * Save settings to disk
+ */
+function saveToDisk(settings) {
+    try {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(settings, null, 2), 'utf-8');
+    }
+    catch (error) {
+        console.error('Failed to save settings:', error);
+    }
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Get all settings (cached)
+ */
+export function getSettings() {
+    if (settingsCache) {
+        return settingsCache;
+    }
+    const stored = loadFromDisk();
+    settingsCache = { ...DEFAULT_SETTINGS, ...stored };
+    return settingsCache;
+}
+/**
+ * Get a single setting
+ */
+export function getSetting(key) {
+    return getSettings()[key];
+}
+/**
+ * Set a single setting
+ */
+export function setSetting(key, value) {
+    const settings = getSettings();
+    settings[key] = value;
+    settingsCache = settings;
+    saveToDisk(settings);
+}
+/**
+ * Update multiple settings at once
+ */
+export function updateSettings(updates) {
+    const settings = getSettings();
+    Object.assign(settings, updates);
+    settingsCache = settings;
+    saveToDisk(settings);
+}
+/**
+ * Reset all settings to defaults
+ */
+export function resetSettings() {
+    settingsCache = { ...DEFAULT_SETTINGS };
+    saveToDisk(settingsCache);
+}
+/**
+ * Clear settings cache (for testing or forced reload)
+ */
+export function clearSettingsCache() {
+    settingsCache = null;
+}
+// =============================================================================
+// Convenience Getters (for type-safe access)
+// =============================================================================
+// Provider/Model getters
+export const getDefaultProvider = () => getSetting('defaultProvider');
+export const getDefaultModel = () => getSetting('defaultModel');
+// Boolean getters
+export const isAutoCompactEnabled = () => getSetting('autoCompact');
+export const isShowTipsEnabled = () => getSetting('showTips');
+export const isReviseCodeEnabled = () => getSetting('reviseCode');
+export const isVerboseEnabled = () => getSetting('verbose');
+export const isProgressBarEnabled = () => getSetting('progressBar');
+export const isGitignoreEnabled = () => getSetting('gitignore');
+export const isAutoInstallEnabled = () => getSetting('autoInstall');
+// Cycle getters
+export const getPermissionMode = () => getSetting('permissionMode');
+export const getNotificationMode = () => getSetting('notifications');
+export const getOutputStyle = () => getSetting('outputStyle');
+export const getEditorMode = () => getSetting('editorMode');
+// =============================================================================
+// Display Value Mappers (for config overlay)
+// =============================================================================
+/**
+ * Map internal permission mode to display value
+ */
+export function permissionModeToDisplay(mode) {
+    switch (mode) {
+        case 'default':
+            return 'Default';
+        case 'plan':
+            return 'Plan';
+        case 'bypass':
+            return 'Bypass prompts';
+    }
+}
+/**
+ * Map display value to internal permission mode
+ */
+export function displayToPermissionMode(display) {
+    switch (display) {
+        case 'Plan':
+            return 'plan';
+        case 'Bypass prompts':
+            return 'bypass';
+        default:
+            return 'default';
+    }
+}
+/**
+ * Map internal notification mode to display value
+ */
+export function notificationModeToDisplay(mode) {
+    switch (mode) {
+        case 'auto':
+            return 'Auto';
+        case 'enabled':
+            return 'Enabled';
+        case 'disabled':
+            return 'Disabled';
+    }
+}
+/**
+ * Map display value to internal notification mode
+ */
+export function displayToNotificationMode(display) {
+    switch (display) {
+        case 'Enabled':
+            return 'enabled';
+        case 'Disabled':
+            return 'disabled';
+        default:
+            return 'auto';
+    }
+}

package/dist/shared-handlers.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared Handlers Module
+ *
+ * This module provides a shared registry for handlers that need to be
+ * accessible from tools but are set up at the application level.
+ * This avoids circular imports between index.ts and tool modules.
+ */
+export interface AskUserQuestion {
+    id: string;
+    header: string;
+    question: string;
+    options?: string[];
+    allowCustom?: boolean;
+    multiSelect?: boolean;
+}
+export interface AskUserInput {
+    questions: AskUserQuestion[];
+    context?: string;
+}
+export interface AskUserResult {
+    answers: Record<string, string | string[]>;
+    skipped: string[];
+}
+export type AskUserHandler = (input: AskUserInput) => Promise<AskUserResult>;
+export interface AskUserSimpleInput {
+    /** The question text */
+    question: string;
+    /** Predefined options (optional, max 5) */
+    options?: string[];
+    /** Allow free-text input (default: true) */
+    allowCustom?: boolean;
+}
+export interface AskUserSimpleResult {
+    /** User's answer */
+    answer: string;
+    /** True if user skipped the question */
+    skipped: boolean;
+}
+export type AskUserSimpleHandler = (input: AskUserSimpleInput) => Promise<AskUserSimpleResult>;
+/**
+ * Register the ask_user handler. Called during app initialization.
+ */
+export declare function registerAskUserHandler(handler: AskUserHandler): void;
+/**
+ * Get the registered ask_user handler. Called by the ask_user tool.
+ */
+export declare function getAskUserHandler(): AskUserHandler | undefined;
+/**
+ * Register the ask_user_simple handler. Called during app initialization.
+ */
+export declare function registerAskUserSimpleHandler(handler: AskUserSimpleHandler): void;
+/**
+ * Get the registered ask_user_simple handler. Called by the ask_user_simple tool.
+ */
+export declare function getAskUserSimpleHandler(): AskUserSimpleHandler | undefined;
+/**
+ * Set overlay active state. Called when showing/hiding overlays.
+ */
+export declare function setOverlayActive(active: boolean): void;
+/**
+ * Check if an overlay is currently active.
+ */
+export declare function isOverlayActive(): boolean;

package/dist/shared-handlers.js

@@ -0,0 +1,57 @@
+/**
+ * Shared Handlers Module
+ *
+ * This module provides a shared registry for handlers that need to be
+ * accessible from tools but are set up at the application level.
+ * This avoids circular imports between index.ts and tool modules.
+ */
+// =============================================================================
+// Handler Registry
+// =============================================================================
+let askUserHandler;
+let askUserSimpleHandler;
+/**
+ * Register the ask_user handler. Called during app initialization.
+ */
+export function registerAskUserHandler(handler) {
+    askUserHandler = handler;
+}
+/**
+ * Get the registered ask_user handler. Called by the ask_user tool.
+ */
+export function getAskUserHandler() {
+    return askUserHandler;
+}
+/**
+ * Register the ask_user_simple handler. Called during app initialization.
+ */
+export function registerAskUserSimpleHandler(handler) {
+    askUserSimpleHandler = handler;
+}
+/**
+ * Get the registered ask_user_simple handler. Called by the ask_user_simple tool.
+ */
+export function getAskUserSimpleHandler() {
+    return askUserSimpleHandler;
+}
+// =============================================================================
+// Overlay State (for buffering output during overlays)
+// =============================================================================
+/**
+ * Flag indicating if an overlay is currently active.
+ * When true, the REPL should buffer text output instead of rendering.
+ * This prevents text from appearing in the middle of overlay UI.
+ */
+let overlayActive = false;
+/**
+ * Set overlay active state. Called when showing/hiding overlays.
+ */
+export function setOverlayActive(active) {
+    overlayActive = active;
+}
+/**
+ * Check if an overlay is currently active.
+ */
+export function isOverlayActive() {
+    return overlayActive;
+}

package/dist/slash-autocomplete.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Slash Command Autocomplete
+ *
+ * Claude Code-style autocomplete for slash commands.
+ * Features:
+ * - Horizontal separator line above input
+ * - Autocomplete dropdown for slash commands
+ * - Multiline input with \ continuation
+ * - Proper wrapping for long input
+ */
+/**
+ * Slash command definition
+ */
+export interface SlashCommand {
+    name: string;
+    description: string;
+    aliases?: string[];
+}
+/**
+ * Available slash commands
+ */
+export declare const SLASH_COMMANDS: SlashCommand[];
+/**
+ * Todo item for display
+ */
+export interface TodoDisplayItem {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    activeForm?: string;
+}
+/**
+ * Strip ANSI codes from string
+ */
+export declare function stripAnsi(str: string): string;
+/**
+ * Create interactive input with autocomplete
+ */
+export declare function createInteractiveInput(prompt: string, onSubmit: (input: string) => void, showSeparator?: boolean, getTodos?: () => TodoDisplayItem[]): {
+    start: () => void;
+    stop: () => void;
+};