@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/settings/index.d.ts

@@ -4,26 +4,54 @@
  * 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 type PermissionMode = 'normal' | 'plan' | 'auto-accept';
+export type PermissionLevel = 'always' | 'session' | 'once' | 'deny';
+export type NotificationMode = 'auto' | 'bell' | 'disabled';
+export type ProviderType = 'auto' | 'claude' | 'openai' | 'gemini' | 'ollama' | 'together' | 'groq' | 'fireworks' | 'perplexity' | 'openrouter' | 'custom';
+export type StartupMode = 'menu' | 'repl';
+export type ProjectStartupMode = 'last' | 'off';
+export type MascotSetting = 'none' | 'random' | 'neutral' | 'thinking' | 'looking_left' | 'looking_right' | 'sleeping' | 'alert' | 'error' | 'success' | 'success_minimal' | 'searching' | 'skeptical';
+export type ProjectSessionMode = 'auto' | 'ask' | 'fresh';
+export type CompactMode = 'active' | 'all' | 'auto';
+/**
+ * Permission rule for a tool or pattern.
+ * Supports wildcards: git_* matches git_commit, git_branch, etc.
+ */
+export interface PermissionRule {
+    toolName: string;
+    level: PermissionLevel;
+    description?: string;
+    isDefault?: boolean;
+}
 export interface Settings {
     theme?: string;
+    firstRunComplete: boolean;
+    telemetryEnabled: boolean;
     defaultProvider: ProviderType;
     defaultModel: string | null;
+    ollamaBaseUrl?: string;
     autoCompact: boolean;
     showTips: boolean;
     reviseCode: boolean;
     verbose: boolean;
     progressBar: boolean;
-    gitignore: boolean;
-    autoInstall: boolean;
+    checkUpdates: boolean;
+    lastUpdateCheck: number | null;
     permissionMode: PermissionMode;
     notifications: NotificationMode;
-    outputStyle: OutputStyle;
-    editorMode: EditorMode;
+    permissionRules: PermissionRule[];
+    startupMode: StartupMode;
+    projectStartup: ProjectStartupMode;
+    lastProjectId: number | null;
+    mascot: MascotSetting;
+    projectSessionMode: ProjectSessionMode;
+    sessionRetentionDays: number;
+    compactMode: CompactMode;
+    delegation: boolean;
+    vsDiffExtension: boolean;
+    lastSeenVersion?: string;
+    modelTiers?: Partial<Record<ProviderType, Partial<Record<'fast' | 'balanced' | 'powerful', string>>>>;
+    roleTierDefaults?: Record<string, 'fast' | 'balanced' | 'powerful'>;
 }
 /**
  * Get all settings (cached)
@@ -56,12 +84,48 @@ 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 isTelemetryEnabled: () => boolean;
+export declare const isCheckUpdatesEnabled: () => boolean;
+export declare const getLastUpdateCheck: () => number | null;
+/**
+ * Record that we checked for updates
+ */
+export declare function recordUpdateCheck(): void;
 export declare const getPermissionMode: () => PermissionMode;
 export declare const getNotificationMode: () => NotificationMode;
-export declare const getOutputStyle: () => OutputStyle;
-export declare const getEditorMode: () => EditorMode;
+type AgentMode = 'normal' | 'auto-accept' | 'plan';
+/**
+ * Map UI AgentMode to PermissionMode setting.
+ * Now 1:1 mapping (except accept-edits which has no UI equivalent).
+ */
+export declare function agentModeToPermissionMode(mode: AgentMode): PermissionMode;
+/**
+ * Map PermissionMode setting to UI AgentMode.
+ * Now 1:1 mapping for all modes.
+ */
+export declare function permissionModeToAgentMode(mode: PermissionMode): AgentMode;
+/**
+ * Sync permission mode when UI mode changes via Shift+Tab.
+ * Also returns the new permission mode for display/logging.
+ */
+export declare function syncPermissionModeFromUI(uiMode: AgentMode): PermissionMode;
+export declare const getStartupMode: () => StartupMode;
+export declare const getProjectStartupMode: () => ProjectStartupMode;
+export declare const getLastProjectId: () => number | null;
+export declare const getMascotSetting: () => MascotSetting;
+export declare const getProjectSessionMode: () => ProjectSessionMode;
+export declare const getSessionRetentionDays: () => number;
+export declare const getCompactMode: () => CompactMode;
+export declare const isDelegationEnabled: () => boolean;
+export declare const isFirstRunComplete: () => boolean;
+/**
+ * Mark onboarding as complete (called after wizard finishes)
+ */
+export declare function completeFirstRun(): void;
+/**
+ * Remember the last opened project (for 'last' mode)
+ */
+export declare function setLastProjectId(projectId: number): void;
 /**
  * Map internal permission mode to display value
  */
@@ -78,3 +142,82 @@ export declare function notificationModeToDisplay(mode: NotificationMode): strin
  * Map display value to internal notification mode
  */
 export declare function displayToNotificationMode(display: string): NotificationMode;
+/**
+ * Map internal project startup mode to display value
+ */
+export declare function projectStartupModeToDisplay(mode: ProjectStartupMode): string;
+/**
+ * Map display value to internal project startup mode
+ */
+export declare function displayToProjectStartupMode(display: string): ProjectStartupMode;
+/**
+ * Map internal project session mode to display value
+ */
+export declare function projectSessionModeToDisplay(mode: ProjectSessionMode): string;
+/**
+ * Map display value to internal project session mode
+ */
+export declare function displayToProjectSessionMode(display: string): ProjectSessionMode;
+/**
+ * Map session retention days to display value
+ */
+export declare function sessionRetentionToDisplay(days: number): string;
+/**
+ * Map display value to session retention days
+ */
+export declare function displayToSessionRetention(display: string): number;
+/**
+ * Map internal compact mode to display value
+ */
+export declare function compactModeToDisplay(mode: CompactMode): string;
+/**
+ * Map display value to internal compact mode
+ */
+export declare function displayToCompactMode(display: string): CompactMode;
+/**
+ * Get all permission rules (including defaults)
+ */
+export declare function getPermissionRules(): PermissionRule[];
+/**
+ * Add a new permission rule
+ */
+export declare function addPermissionRule(rule: Omit<PermissionRule, 'isDefault'>): void;
+/**
+ * Update a permission rule by tool name
+ */
+export declare function updatePermissionRule(toolName: string, updates: Partial<Omit<PermissionRule, 'toolName' | 'isDefault'>>): boolean;
+/**
+ * Delete a permission rule (only non-default rules can be deleted)
+ */
+export declare function deletePermissionRule(toolName: string): boolean;
+/**
+ * Reset permission rules to defaults
+ */
+export declare function resetPermissionRules(): void;
+/**
+ * Get the user's preferred model tier for a role.
+ * Returns undefined if no preference is set (use role's built-in default).
+ */
+export declare function getRoleTierDefault(roleId: string): 'fast' | 'balanced' | 'powerful' | undefined;
+/**
+ * Set the user's preferred model tier for a role.
+ */
+export declare function setRoleTierDefault(roleId: string, tier: 'fast' | 'balanced' | 'powerful'): void;
+/**
+ * Clear the user's preferred model tier for a role (revert to built-in default).
+ */
+export declare function clearRoleTierDefault(roleId: string): void;
+/**
+ * Find the permission rule that matches a tool name.
+ * Supports wildcards: git_* matches git_commit, git_branch, etc.
+ */
+export declare function findMatchingRule(toolName: string): PermissionRule | null;
+/**
+ * Map permission level to display string
+ */
+export declare function permissionLevelToDisplay(level: PermissionLevel): string;
+/**
+ * Map display string to permission level
+ */
+export declare function displayToPermissionLevel(display: string): PermissionLevel;
+export {};

package/dist/settings/index.js

@@ -17,22 +17,55 @@ const CONFIG_FILE = path.join(CONFIG_DIR, 'settings.json');
 // =============================================================================
 const DEFAULT_SETTINGS = {
     theme: 'compilr-dark',
+    // First run / onboarding
+    firstRunComplete: false, // New users start with onboarding wizard
+    // Telemetry default (opt-out model - default ON)
+    telemetryEnabled: true,
     // Provider/Model defaults
     defaultProvider: 'auto',
     defaultModel: null,
     // Boolean defaults
     autoCompact: true,
-    showTips: true,
-    reviseCode: true,
+    showTips: true, // TODO: Not yet implemented
+    reviseCode: true, // TODO: Not yet implemented
     verbose: false,
     progressBar: true,
-    gitignore: true,
-    autoInstall: true,
+    // Update defaults
+    checkUpdates: true, // Check for updates on startup
+    lastUpdateCheck: null, // Never checked
     // Cycle defaults
-    permissionMode: 'default',
+    permissionMode: 'normal',
     notifications: 'auto',
-    outputStyle: 'default',
-    editorMode: 'normal',
+    // Default permission rules
+    permissionRules: [
+        { toolName: 'bash', level: 'once', description: 'Execute shell commands', isDefault: true },
+        { toolName: 'write_file', level: 'once', description: 'Write/create files', isDefault: true },
+        { toolName: 'edit', level: 'once', description: 'Edit file contents', isDefault: true },
+        { toolName: 'git_commit', level: 'once', description: 'Create git commits', isDefault: true },
+        { toolName: 'git_branch', level: 'once', description: 'Create/delete branches', isDefault: true },
+        { toolName: 'run_tests', level: 'once', description: 'Run test suite', isDefault: true },
+        { toolName: 'run_lint', level: 'once', description: 'Run linter (may auto-fix)', isDefault: true },
+        { toolName: 'read_file', level: 'always', description: 'Read files', isDefault: true },
+        { toolName: 'glob', level: 'always', description: 'Find files by pattern', isDefault: true },
+        { toolName: 'grep', level: 'always', description: 'Search file contents', isDefault: true },
+    ],
+    // Startup default
+    startupMode: 'menu',
+    // Project startup defaults
+    projectStartup: 'last', // Default: load last opened project
+    lastProjectId: null,
+    // Mascot default
+    mascot: 'neutral', // Default: show neutral mascot with logo
+    // Project-session binding default
+    projectSessionMode: 'auto', // Default: auto-resume last session when loading project
+    // Session history retention default (30 days)
+    sessionRetentionDays: 30,
+    // Compact mode default (auto: compact agents above 70% utilization)
+    compactMode: 'auto',
+    // Tool result delegation default (enabled by default)
+    delegation: true,
+    // VS Code diff extension default (opt-in)
+    vsDiffExtension: false,
 };
 // =============================================================================
 // In-memory cache
@@ -80,6 +113,23 @@ export function getSettings() {
     }
     const stored = loadFromDisk();
     settingsCache = { ...DEFAULT_SETTINGS, ...stored };
+    // Migration: convert deprecated 'cwd' to 'off'
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (settingsCache.projectStartup === 'cwd') {
+        settingsCache.projectStartup = 'off';
+        saveToDisk(settingsCache);
+    }
+    // Migration: convert old permission mode values
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const oldPermMode = settingsCache.permissionMode;
+    if (oldPermMode === 'default' || oldPermMode === 'accept-edits') {
+        settingsCache.permissionMode = 'normal';
+        saveToDisk(settingsCache);
+    }
+    else if (oldPermMode === 'dont-ask') {
+        settingsCache.permissionMode = 'auto-accept';
+        saveToDisk(settingsCache);
+    }
     return settingsCache;
 }
 /**
@@ -127,17 +177,83 @@ 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 isShowTipsEnabled = () => getSetting('showTips'); // TODO: Not yet implemented
+export const isReviseCodeEnabled = () => getSetting('reviseCode'); // TODO: Not yet implemented
 export const isVerboseEnabled = () => getSetting('verbose');
 export const isProgressBarEnabled = () => getSetting('progressBar');
-export const isGitignoreEnabled = () => getSetting('gitignore');
-export const isAutoInstallEnabled = () => getSetting('autoInstall');
+export const isTelemetryEnabled = () => getSetting('telemetryEnabled');
+// Update getters
+export const isCheckUpdatesEnabled = () => getSetting('checkUpdates');
+export const getLastUpdateCheck = () => getSetting('lastUpdateCheck');
+/**
+ * Record that we checked for updates
+ */
+export function recordUpdateCheck() {
+    setSetting('lastUpdateCheck', Date.now());
+}
 // Cycle getters
 export const getPermissionMode = () => getSetting('permissionMode');
 export const getNotificationMode = () => getSetting('notifications');
-export const getOutputStyle = () => getSetting('outputStyle');
-export const getEditorMode = () => getSetting('editorMode');
+/**
+ * Map UI AgentMode to PermissionMode setting.
+ * Now 1:1 mapping (except accept-edits which has no UI equivalent).
+ */
+export function agentModeToPermissionMode(mode) {
+    switch (mode) {
+        case 'normal':
+            return 'normal';
+        case 'auto-accept':
+            return 'auto-accept';
+        case 'plan':
+            return 'plan';
+    }
+}
+/**
+ * Map PermissionMode setting to UI AgentMode.
+ * Now 1:1 mapping for all modes.
+ */
+export function permissionModeToAgentMode(mode) {
+    // Direct 1:1 mapping - all modes match
+    return mode;
+}
+/**
+ * Sync permission mode when UI mode changes via Shift+Tab.
+ * Also returns the new permission mode for display/logging.
+ */
+export function syncPermissionModeFromUI(uiMode) {
+    const permMode = agentModeToPermissionMode(uiMode);
+    setSetting('permissionMode', permMode);
+    return permMode;
+}
+// Startup getter
+export const getStartupMode = () => getSetting('startupMode');
+// Project startup getters
+export const getProjectStartupMode = () => getSetting('projectStartup');
+export const getLastProjectId = () => getSetting('lastProjectId');
+// Mascot getter
+export const getMascotSetting = () => getSetting('mascot');
+// Project-session binding getter
+export const getProjectSessionMode = () => getSetting('projectSessionMode');
+// Session retention getter
+export const getSessionRetentionDays = () => getSetting('sessionRetentionDays');
+// Compact mode getter
+export const getCompactMode = () => getSetting('compactMode');
+// Tool result delegation
+export const isDelegationEnabled = () => getSetting('delegation');
+// First run / onboarding
+export const isFirstRunComplete = () => getSetting('firstRunComplete');
+/**
+ * Mark onboarding as complete (called after wizard finishes)
+ */
+export function completeFirstRun() {
+    setSetting('firstRunComplete', true);
+}
+/**
+ * Remember the last opened project (for 'last' mode)
+ */
+export function setLastProjectId(projectId) {
+    setSetting('lastProjectId', projectId);
+}
 // =============================================================================
 // Display Value Mappers (for config overlay)
 // =============================================================================
@@ -146,12 +262,12 @@ export const getEditorMode = () => getSetting('editorMode');
  */
 export function permissionModeToDisplay(mode) {
     switch (mode) {
-        case 'default':
-            return 'Default';
+        case 'normal':
+            return 'Normal';
         case 'plan':
             return 'Plan';
-        case 'bypass':
-            return 'Bypass prompts';
+        case 'auto-accept':
+            return 'Auto-accept';
     }
 }
 /**
@@ -161,10 +277,10 @@ export function displayToPermissionMode(display) {
     switch (display) {
         case 'Plan':
             return 'plan';
-        case 'Bypass prompts':
-            return 'bypass';
+        case 'Auto-accept':
+            return 'auto-accept';
         default:
-            return 'default';
+            return 'normal';
     }
 }
 /**
@@ -174,8 +290,8 @@ export function notificationModeToDisplay(mode) {
     switch (mode) {
         case 'auto':
             return 'Auto';
-        case 'enabled':
-            return 'Enabled';
+        case 'bell':
+            return 'Terminal Bell';
         case 'disabled':
             return 'Disabled';
     }
@@ -185,11 +301,248 @@ export function notificationModeToDisplay(mode) {
  */
 export function displayToNotificationMode(display) {
     switch (display) {
-        case 'Enabled':
-            return 'enabled';
+        case 'Terminal Bell':
+            return 'bell';
         case 'Disabled':
             return 'disabled';
         default:
             return 'auto';
     }
 }
+/**
+ * Map internal project startup mode to display value
+ */
+export function projectStartupModeToDisplay(mode) {
+    switch (mode) {
+        case 'last':
+            return 'Last opened';
+        case 'off':
+            return 'Off';
+    }
+}
+/**
+ * Map display value to internal project startup mode
+ */
+export function displayToProjectStartupMode(display) {
+    switch (display) {
+        case 'Off':
+            return 'off';
+        default:
+            return 'last';
+    }
+}
+/**
+ * Map internal project session mode to display value
+ */
+export function projectSessionModeToDisplay(mode) {
+    switch (mode) {
+        case 'auto':
+            return 'Auto';
+        case 'ask':
+            return 'Ask';
+        case 'fresh':
+            return 'Fresh';
+        default:
+            return 'Auto';
+    }
+}
+/**
+ * Map display value to internal project session mode
+ */
+export function displayToProjectSessionMode(display) {
+    switch (display) {
+        case 'Ask':
+            return 'ask';
+        case 'Fresh':
+            return 'fresh';
+        default:
+            return 'auto';
+    }
+}
+/**
+ * Map session retention days to display value
+ */
+export function sessionRetentionToDisplay(days) {
+    if (days <= 0)
+        return 'Forever';
+    return `${String(days)} days`;
+}
+/**
+ * Map display value to session retention days
+ */
+export function displayToSessionRetention(display) {
+    if (display === 'Forever')
+        return 0;
+    const match = /^(\d+)\s*days?$/.exec(display);
+    if (match)
+        return parseInt(match[1], 10);
+    return 30; // Default fallback
+}
+/**
+ * Map internal compact mode to display value
+ */
+export function compactModeToDisplay(mode) {
+    switch (mode) {
+        case 'active':
+            return 'Active agent';
+        case 'all':
+            return 'All agents';
+        case 'auto':
+            return 'Auto (>70%)';
+    }
+}
+/**
+ * Map display value to internal compact mode
+ */
+export function displayToCompactMode(display) {
+    switch (display) {
+        case 'Active agent':
+            return 'active';
+        case 'All agents':
+            return 'all';
+        default:
+            return 'auto';
+    }
+}
+// =============================================================================
+// Permission Rules Management
+// =============================================================================
+/**
+ * Get all permission rules (including defaults)
+ */
+export function getPermissionRules() {
+    return getSetting('permissionRules');
+}
+/**
+ * Add a new permission rule
+ */
+export function addPermissionRule(rule) {
+    const rules = getPermissionRules();
+    // Check if rule with same toolName exists
+    const existingIndex = rules.findIndex(r => r.toolName === rule.toolName);
+    if (existingIndex >= 0) {
+        // Update existing rule
+        rules[existingIndex] = { ...rule, isDefault: false };
+    }
+    else {
+        // Add new rule
+        rules.push({ ...rule, isDefault: false });
+    }
+    setSetting('permissionRules', rules);
+}
+/**
+ * Update a permission rule by tool name
+ */
+export function updatePermissionRule(toolName, updates) {
+    const rules = getPermissionRules();
+    const index = rules.findIndex(r => r.toolName === toolName);
+    if (index < 0)
+        return false;
+    rules[index] = { ...rules[index], ...updates };
+    setSetting('permissionRules', rules);
+    return true;
+}
+/**
+ * Delete a permission rule (only non-default rules can be deleted)
+ */
+export function deletePermissionRule(toolName) {
+    const rules = getPermissionRules();
+    const index = rules.findIndex(r => r.toolName === toolName);
+    if (index < 0)
+        return false;
+    // Don't allow deleting default rules
+    if (rules[index].isDefault)
+        return false;
+    rules.splice(index, 1);
+    setSetting('permissionRules', rules);
+    return true;
+}
+/**
+ * Reset permission rules to defaults
+ */
+export function resetPermissionRules() {
+    setSetting('permissionRules', DEFAULT_SETTINGS.permissionRules);
+}
+// =============================================================================
+// Role Tier Defaults
+// =============================================================================
+/**
+ * Get the user's preferred model tier for a role.
+ * Returns undefined if no preference is set (use role's built-in default).
+ */
+export function getRoleTierDefault(roleId) {
+    const defaults = getSetting('roleTierDefaults');
+    return defaults?.[roleId];
+}
+/**
+ * Set the user's preferred model tier for a role.
+ */
+export function setRoleTierDefault(roleId, tier) {
+    const defaults = getSetting('roleTierDefaults') ?? {};
+    defaults[roleId] = tier;
+    setSetting('roleTierDefaults', defaults);
+}
+/**
+ * Clear the user's preferred model tier for a role (revert to built-in default).
+ */
+export function clearRoleTierDefault(roleId) {
+    const defaults = getSetting('roleTierDefaults');
+    if (defaults && roleId in defaults) {
+        const { [roleId]: _removed, ...remaining } = defaults;
+        setSetting('roleTierDefaults', Object.keys(remaining).length > 0 ? remaining : undefined);
+    }
+}
+/**
+ * Find the permission rule that matches a tool name.
+ * Supports wildcards: git_* matches git_commit, git_branch, etc.
+ */
+export function findMatchingRule(toolName) {
+    const rules = getPermissionRules();
+    // First try exact match
+    const exactMatch = rules.find(r => r.toolName === toolName);
+    if (exactMatch)
+        return exactMatch;
+    // Then try wildcard patterns
+    for (const rule of rules) {
+        if (rule.toolName.includes('*')) {
+            const pattern = rule.toolName
+                .replace(/[.+?^${}()|[\]\\]/g, '\\$&') // Escape special regex chars
+                .replace(/\*/g, '.*'); // Convert * to .*
+            const regex = new RegExp(`^${pattern}$`);
+            if (regex.test(toolName)) {
+                return rule;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Map permission level to display string
+ */
+export function permissionLevelToDisplay(level) {
+    switch (level) {
+        case 'always':
+            return 'Always';
+        case 'session':
+            return 'Session';
+        case 'once':
+            return 'Once';
+        case 'deny':
+            return 'Deny';
+    }
+}
+/**
+ * Map display string to permission level
+ */
+export function displayToPermissionLevel(display) {
+    switch (display.toLowerCase()) {
+        case 'always':
+            return 'always';
+        case 'session':
+            return 'session';
+        case 'deny':
+            return 'deny';
+        default:
+            return 'once';
+    }
+}