@compilr-dev/cli 0.5.0 → 0.5.2

package/dist/settings/index.d.ts

@@ -4,33 +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)
@@ -63,16 +84,44 @@ 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)
  */
@@ -101,3 +150,74 @@ export declare function projectStartupModeToDisplay(mode: ProjectStartupMode): s
  * 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,38 @@ 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
@@ -40,6 +56,16 @@ const DEFAULT_SETTINGS = {
     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
@@ -93,6 +119,17 @@ export function getSettings() {
         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;
 }
 /**
@@ -140,17 +177,54 @@ 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
@@ -158,6 +232,22 @@ 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)
  */
@@ -172,12 +262,12 @@ export function setLastProjectId(projectId) {
  */
 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';
     }
 }
 /**
@@ -187,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';
     }
 }
 /**
@@ -200,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';
     }
@@ -211,8 +301,8 @@ export function notificationModeToDisplay(mode) {
  */
 export function displayToNotificationMode(display) {
     switch (display) {
-        case 'Enabled':
-            return 'enabled';
+        case 'Terminal Bell':
+            return 'bell';
         case 'Disabled':
             return 'disabled';
         default:
@@ -241,3 +331,218 @@ export function displayToProjectStartupMode(display) {
             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';
+    }
+}