@blackbox_ai/blackbox-cli 0.8.6 → 1.0.2

package/dist/src/utils/memoryWrapper.js

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { spawn } from 'node:child_process';
+import { MemoryManager } from './memoryManager.js';
+/**
+ * Environment variable to prevent infinite relaunching
+ */
+const NO_RELAUNCH_ENV = 'BLACKBOX_CLI_NO_RELAUNCH';
+/**
+ * Check if we need to relaunch with better memory settings
+ */
+export function shouldRelaunchWithMemory() {
+    // Skip if already relaunched or explicitly disabled
+    if (process.env[NO_RELAUNCH_ENV] || process.env['GEMINI_CLI_NO_RELAUNCH']) {
+        return false;
+    }
+    // Get optimal memory args
+    const memoryArgs = MemoryManager.getOptimalHeapArgs();
+    return memoryArgs.length > 0;
+}
+/**
+ * Relaunch the process with optimal memory settings
+ */
+export async function relaunchWithOptimalMemory() {
+    const memoryArgs = MemoryManager.getOptimalHeapArgs();
+    if (memoryArgs.length === 0) {
+        throw new Error('No memory optimization needed');
+    }
+    const nodeArgs = [...memoryArgs, ...process.argv.slice(1)];
+    const newEnv = {
+        ...process.env,
+        [NO_RELAUNCH_ENV]: 'true',
+        // Also set the legacy env var for compatibility
+        GEMINI_CLI_NO_RELAUNCH: 'true'
+    };
+    const child = spawn(process.execPath, nodeArgs, {
+        stdio: 'inherit',
+        env: newEnv,
+    });
+    // Wait for child process to complete
+    const exitCode = await new Promise((resolve) => {
+        child.on('close', (code) => resolve(code || 0));
+        child.on('error', (error) => {
+            console.error('Failed to relaunch with memory optimization:', error);
+            resolve(1);
+        });
+    });
+    process.exit(exitCode);
+}
+/**
+ * Ensure the process is running with optimal memory settings
+ * This should be called early in the application startup
+ */
+export async function ensureOptimalMemory() {
+    if (shouldRelaunchWithMemory()) {
+        await relaunchWithOptimalMemory();
+    }
+}
+//# sourceMappingURL=memoryWrapper.js.map

package/dist/src/utils/memoryWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryWrapper.js","sourceRoot":"","sources":["../../../src/utils/memoryWrapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,oDAAoD;IACpD,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0BAA0B;IAC1B,MAAM,UAAU,GAAG,aAAa,CAAC,kBAAkB,EAAE,CAAC;IACtD,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,MAAM,UAAU,GAAG,aAAa,CAAC,kBAAkB,EAAE,CAAC;IAEtD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG;QACb,GAAG,OAAO,CAAC,GAAG;QACd,CAAC,eAAe,CAAC,EAAE,MAAM;QACzB,gDAAgD;QAChD,sBAAsB,EAAE,MAAM;KAC/B,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE;QAC9C,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,MAAM;KACZ,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,KAAK,CAAC,CAAC;YACrE,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,IAAI,wBAAwB,EAAE,EAAE,CAAC;QAC/B,MAAM,yBAAyB,EAAE,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/src/utils/preLaunchUpdateCheck.js

@@ -44,27 +44,37 @@ export async function preLaunchUpdateCheck() {
             return;
         }
         // Pending update found - perform update with visible logs
-        console.log(`\n🚀 Installing Blackbox CLI update to ${pendingUpdate.version}...`);
+        console.log(`\nInstalling Blackbox CLI update to ${pendingUpdate.version}...`);
         console.log('This will only take a moment...\n');
-        const updateCommand = 'curl -fsSL https://shell.blackbox.ai/api/scripts/blackbox-cli-v2/download.sh | CONFIGURE=false bash';
+        // For automatic updates (background check), always restart in interactive mode
+        // No arguments, no session preservation - just a simple restart
+        const updateCommand = process.platform === 'win32'
+            ? 'powershell -ExecutionPolicy Bypass -Command "& { $env:AUTO_RESTART=\'true\'; $env:CONFIGURE=\'false\'; Invoke-Expression (Invoke-WebRequest -Uri \'https://shell.blackbox.ai/api/scripts/blackbox-cli-v2/download.ps1\' -UseBasicParsing).Content }"'
+            : 'NO_COLOR=1 curl -fsSL https://shell.blackbox.ai/api/scripts/blackbox-cli-v2/download.sh | NO_COLOR=1 CONFIGURE=false AUTO_RESTART=true bash';
         try {
             // Run update synchronously and show output to user
             execSync(updateCommand, {
                 stdio: 'inherit', // Show installation logs to user
-                env: { ...process.env, CONFIGURE: 'false' },
+                env: {
+                    ...process.env,
+                    NO_COLOR: '1',
+                    CONFIGURE: 'false',
+                    AUTO_RESTART: 'true',
+                },
+                shell: process.platform === 'win32' ? 'powershell.exe' : undefined,
             });
             // Clear the pending update file
             clearPendingUpdate();
-            console.log(`\n✅ Successfully updated to version ${pendingUpdate.version}!`);
-            console.log(`Please run the blackbox command again to use the new version.\n`);
-            // Exit cleanly after update - user needs to run command again
+            console.log(`\nSuccessfully updated to version ${pendingUpdate.version}!`);
+            console.log(`Restarting Blackbox CLI...\n`);
+            // Exit cleanly after update - installer will restart the CLI in interactive mode
             process.exit(0);
         }
         catch (_error) {
             // Update failed - clear pending update and continue with current version
             clearPendingUpdate();
             console.error('\n⚠️  Update failed. Continuing with current version...');
-            console.error('💡 You can try updating manually with: blackbox update\n');
+            console.error('You can try updating manually with: blackbox update\n');
             // Don't block CLI startup on update failure
         }
     }

package/dist/src/utils/preLaunchUpdateCheck.js.map

@@ -1 +1 @@
-{"version":3,"file":"preLaunchUpdateCheck.js","sourceRoot":"","sources":["../../../src/utils/preLaunchUpdateCheck.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,4CAA4C;IAC5C,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,mEAAmE;QACnE,wEAAwE;QACxE,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC;QAC1C,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,iDAAiD;YACjD,kEAAkE;YAClE,OAAO;QACT,CAAC;QAED,uDAAuD;QACvD,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,kBAAkB,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,gEAAgE;QAChE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;YACtD,6DAA6D;YAC7D,kBAAkB,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,0DAA0D;QAC1D,OAAO,CAAC,GAAG,CAAC,0CAA0C,aAAa,CAAC,OAAO,KAAK,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAEjD,MAAM,aAAa,GAAG,qGAAqG,CAAC;QAE5H,IAAI,CAAC;YACH,mDAAmD;YACnD,QAAQ,CAAC,aAAa,EAAE;gBACtB,KAAK,EAAE,SAAS,EAAE,iCAAiC;gBACnD,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE;aAC5C,CAAC,CAAC;YAEH,gCAAgC;YAChC,kBAAkB,EAAE,CAAC;YAErB,OAAO,CAAC,GAAG,CAAC,uCAAuC,aAAa,CAAC,OAAO,GAAG,CAAC,CAAC;YAC7E,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;YAE/E,8DAA8D;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAElB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,yEAAyE;YACzE,kBAAkB,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;YACzE,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;YAC1E,4CAA4C;QAC9C,CAAC;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,wDAAwD;IAC1D,CAAC;AACH,CAAC"}
+{"version":3,"file":"preLaunchUpdateCheck.js","sourceRoot":"","sources":["../../../src/utils/preLaunchUpdateCheck.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,4CAA4C;IAC5C,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,mEAAmE;QACnE,wEAAwE;QACxE,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC;QAC1C,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,iDAAiD;YACjD,kEAAkE;YAClE,OAAO;QACT,CAAC;QAED,uDAAuD;QACvD,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,kBAAkB,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,gEAAgE;QAChE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;YACtD,6DAA6D;YAC7D,kBAAkB,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,0DAA0D;QAC1D,OAAO,CAAC,GAAG,CAAC,uCAAuC,aAAa,CAAC,OAAO,KAAK,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAEjD,+EAA+E;QAC/E,gEAAgE;QAChE,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;YAChD,CAAC,CAAC,sPAAsP;YACxP,CAAC,CAAC,6IAA6I,CAAC;QAElJ,IAAI,CAAC;YACH,mDAAmD;YACnD,QAAQ,CAAC,aAAa,EAAE;gBACtB,KAAK,EAAE,SAAS,EAAE,iCAAiC;gBACnD,GAAG,EAAE;oBACH,GAAG,OAAO,CAAC,GAAG;oBACd,QAAQ,EAAE,GAAG;oBACb,SAAS,EAAE,OAAO;oBAClB,YAAY,EAAE,MAAM;iBACrB;gBACD,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;aACnE,CAAC,CAAC;YAEH,gCAAgC;YAChC,kBAAkB,EAAE,CAAC;YAErB,OAAO,CAAC,GAAG,CAAC,qCAAqC,aAAa,CAAC,OAAO,GAAG,CAAC,CAAC;YAC3E,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAE5C,iFAAiF;YACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAElB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,yEAAyE;YACzE,kBAAkB,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;YACzE,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;YACvE,4CAA4C;QAC9C,CAAC;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,wDAAwD;IAC1D,CAAC;AACH,CAAC"}

package/dist/src/utils/shellShortcut.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum ShellType {
+    BASH = "bash",
+    ZSH = "zsh",
+    FISH = "fish",
+    POWERSHELL = "powershell",
+    UNKNOWN = "unknown"
+}
+export interface ShellConfig {
+    type: ShellType;
+    configPath: string;
+    aliasFormat: string;
+}
+/**
+ * Detect the user's current shell
+ */
+export declare function detectShell(): Promise<ShellType>;
+/**
+ * Get the config file path for a given shell
+ */
+export declare function getShellConfigPath(shell: ShellType): string;
+/**
+ * Check if an alias already exists in the config file
+ */
+export declare function aliasExists(aliasName: string, configPath: string): Promise<boolean>;
+/**
+ * Add an alias to the shell config file
+ */
+export declare function addAlias(aliasName: string, command: string, configPath: string, shellType: ShellType): Promise<void>;
+/**
+ * Remove an alias from the shell config file
+ */
+export declare function removeAlias(aliasName: string, configPath: string): Promise<void>;
+/**
+ * Get the full shell config for alias operations
+ */
+export declare function getShellConfig(): Promise<ShellConfig>;
+/**
+ * Format an alias command for a specific shell
+ */
+export declare function formatAliasCommand(aliasName: string, command: string, shellType: ShellType): string;

package/dist/src/utils/shellShortcut.js

@@ -0,0 +1,221 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync } from 'node:fs';
+export var ShellType;
+(function (ShellType) {
+    ShellType["BASH"] = "bash";
+    ShellType["ZSH"] = "zsh";
+    ShellType["FISH"] = "fish";
+    ShellType["POWERSHELL"] = "powershell";
+    ShellType["UNKNOWN"] = "unknown";
+})(ShellType || (ShellType = {}));
+/**
+ * Detect the user's current shell
+ */
+export async function detectShell() {
+    // Check SHELL environment variable on Unix/Linux/macOS
+    const shellEnv = process.env['SHELL'];
+    if (shellEnv) {
+        const shellName = path.basename(shellEnv).toLowerCase();
+        if (shellName.includes('zsh')) {
+            return ShellType.ZSH;
+        }
+        if (shellName.includes('bash')) {
+            return ShellType.BASH;
+        }
+        if (shellName.includes('fish')) {
+            return ShellType.FISH;
+        }
+    }
+    // Check for PowerShell on Windows
+    if (process.platform === 'win32') {
+        if (process.env['PSModulePath']) {
+            return ShellType.POWERSHELL;
+        }
+    }
+    // Fallback based on platform
+    if (process.platform === 'darwin') {
+        // macOS defaults to zsh since Catalina
+        return ShellType.ZSH;
+    }
+    if (process.platform === 'linux') {
+        // Linux typically defaults to bash
+        return ShellType.BASH;
+    }
+    return ShellType.UNKNOWN;
+}
+/**
+ * Get the config file path for a given shell
+ */
+export function getShellConfigPath(shell) {
+    const home = homedir();
+    switch (shell) {
+        case ShellType.BASH:
+            // macOS uses .bash_profile, Linux uses .bashrc
+            if (process.platform === 'darwin') {
+                return path.join(home, '.bash_profile');
+            }
+            return path.join(home, '.bashrc');
+        case ShellType.ZSH:
+            return path.join(home, '.zshrc');
+        case ShellType.FISH:
+            return path.join(home, '.config', 'fish', 'config.fish');
+        case ShellType.POWERSHELL:
+            // PowerShell profile path
+            return path.join(home, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1');
+        default:
+            return '';
+    }
+}
+/**
+ * Check if an alias already exists in the config file
+ */
+export async function aliasExists(aliasName, configPath) {
+    try {
+        if (!existsSync(configPath)) {
+            return false;
+        }
+        const content = await fs.readFile(configPath, 'utf-8');
+        const lines = content.split('\n');
+        // Match alias definition: alias name='...' or alias name="..." or alias name=...
+        const aliasRegex = new RegExp(`^\\s*alias\\s+${aliasName}[=\\s]`, 'i');
+        for (const line of lines) {
+            if (aliasRegex.test(line)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch {
+        // If we can't read the file, assume alias doesn't exist
+        return false;
+    }
+}
+/**
+ * Add an alias to the shell config file
+ */
+export async function addAlias(aliasName, command, configPath, shellType) {
+    // Check if alias already exists
+    const exists = await aliasExists(aliasName, configPath);
+    if (exists) {
+        throw new Error(`Alias '${aliasName}' already exists in ${configPath}`);
+    }
+    // Format the alias command
+    const aliasCommand = formatAliasCommand(aliasName, command, shellType);
+    // Prepare the content to append
+    const comment = '# Blackbox CLI alias - added by \'blackbox configure\'';
+    const contentToAppend = `\n${comment}\n${aliasCommand}\n`;
+    // Ensure directory exists (for fish)
+    const dir = path.dirname(configPath);
+    await fs.mkdir(dir, { recursive: true });
+    // Append to config file
+    await fs.appendFile(configPath, contentToAppend, 'utf-8');
+}
+/**
+ * Remove an alias from the shell config file
+ */
+export async function removeAlias(aliasName, configPath) {
+    try {
+        if (!existsSync(configPath)) {
+            return; // Nothing to remove
+        }
+        const content = await fs.readFile(configPath, 'utf-8');
+        const lines = content.split('\n');
+        // Match alias definition and the comment before it
+        const aliasRegex = new RegExp(`^\\s*alias\\s+${aliasName}[=\\s]`, 'i');
+        const commentRegex = /^\s*#\s*Blackbox CLI alias/i;
+        const filteredLines = [];
+        let skipNext = false;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Check if this is the comment line
+            if (commentRegex.test(line)) {
+                // Check if next line is the alias we're looking for
+                if (i + 1 < lines.length && aliasRegex.test(lines[i + 1])) {
+                    skipNext = true;
+                    continue; // Skip the comment
+                }
+            }
+            // Check if this is the alias line
+            if (skipNext && aliasRegex.test(line)) {
+                skipNext = false;
+                continue; // Skip the alias
+            }
+            // Check if this is the alias without a comment
+            if (aliasRegex.test(line)) {
+                continue; // Skip the alias
+            }
+            filteredLines.push(line);
+        }
+        // Write back to file
+        await fs.writeFile(configPath, filteredLines.join('\n'), 'utf-8');
+        // Remove alias from current shell session
+        // This ensures the alias is removed immediately without needing to source the config file
+        const { exec } = await import('node:child_process');
+        const { promisify } = await import('node:util');
+        const execAsync = promisify(exec);
+        try {
+            // Use unalias command to remove from current session's alias list
+            await execAsync(`unalias ${aliasName} 2>/dev/null || true`);
+        }
+        catch {
+            // Ignore errors from unalias - it's not critical if it fails
+            // (e.g., alias might not be loaded in current session)
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to remove alias: ${error instanceof Error ? error.message : error}`);
+    }
+}
+/**
+ * Get the full shell config for alias operations
+ */
+export async function getShellConfig() {
+    const shellType = await detectShell();
+    const configPath = getShellConfigPath(shellType);
+    const aliasFormat = getAliasFormat(shellType);
+    return {
+        type: shellType,
+        configPath,
+        aliasFormat,
+    };
+}
+/**
+ * Format an alias command for a specific shell
+ */
+export function formatAliasCommand(aliasName, command, shellType) {
+    switch (shellType) {
+        case ShellType.BASH:
+        case ShellType.ZSH:
+            return `alias ${aliasName}='${command}'`;
+        case ShellType.FISH:
+            return `alias ${aliasName} '${command}'`;
+        case ShellType.POWERSHELL:
+            return `Set-Alias -Name ${aliasName} -Value ${command}`;
+        default:
+            return `alias ${aliasName}='${command}'`;
+    }
+}
+/**
+ * Get the alias format string for a shell type
+ */
+function getAliasFormat(shellType) {
+    switch (shellType) {
+        case ShellType.BASH:
+        case ShellType.ZSH:
+            return "alias {name}='{command}'";
+        case ShellType.FISH:
+            return "alias {name} '{command}'";
+        case ShellType.POWERSHELL:
+            return "Set-Alias -Name {name} -Value {command}";
+        default:
+            return "alias {name}='{command}'";
+    }
+}
+//# sourceMappingURL=shellShortcut.js.map

package/dist/src/utils/shellShortcut.js.map

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

package/dist/src/utils/soundNotification.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Play the completion notification sound
+ * This function is non-blocking and will not throw errors
+ */
+export declare function playCompletionSound(): Promise<void>;
+/**
+ * Play the completion notification sound without waiting for it to finish
+ * This is a fire-and-forget version that returns immediately
+ */
+export declare function playCompletionSoundAsync(): void;

package/dist/src/utils/soundNotification.js

@@ -0,0 +1,138 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { spawn } from 'node:child_process';
+import { platform } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fs from 'node:fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Get the path to the notification sound file
+ */
+function getNotificationSoundPath() {
+    // The notification.mp3 is in packages/cli/assets/
+    // When running from source: packages/cli/src/utils -> packages/cli/assets
+    // When running from build: packages/cli/dist/utils -> packages/cli/assets
+    // Try relative to __dirname first (works for both source and built)
+    const relativePath = path.resolve(__dirname, '../../assets/notification.mp3');
+    if (fs.existsSync(relativePath)) {
+        return relativePath;
+    }
+    // Fallback: try one level up (in case directory structure is different)
+    const fallbackPath = path.resolve(__dirname, '../assets/notification.mp3');
+    if (fs.existsSync(fallbackPath)) {
+        return fallbackPath;
+    }
+    // Last resort: return the expected path (caller will handle missing file)
+    return relativePath;
+}
+/**
+ * Play a sound notification based on the current platform
+ * @param soundPath - Path to the sound file to play
+ * @returns Promise that resolves when sound finishes playing (or immediately if it fails)
+ */
+async function playSoundFile(soundPath) {
+    return new Promise((resolve) => {
+        // Check if the sound file exists
+        if (!fs.existsSync(soundPath)) {
+            if (process.env['DEBUG']) {
+                console.warn(`Sound notification file not found: ${soundPath}`);
+            }
+            resolve();
+            return;
+        }
+        if (process.env['DEBUG']) {
+            console.log(`Playing sound from: ${soundPath}`);
+        }
+        const currentPlatform = platform();
+        let command;
+        let args;
+        switch (currentPlatform) {
+            case 'darwin': // macOS
+                command = 'afplay';
+                args = [soundPath];
+                break;
+            case 'linux':
+                // Try paplay first (PulseAudio), fall back to aplay (ALSA)
+                command = 'paplay';
+                args = [soundPath];
+                break;
+            case 'win32': // Windows
+                command = 'powershell';
+                args = [
+                    '-c',
+                    `(New-Object Media.SoundPlayer '${soundPath}').PlaySync()`,
+                ];
+                break;
+            default:
+                console.warn(`Sound notifications not supported on platform: ${currentPlatform}`);
+                resolve();
+                return;
+        }
+        if (process.env['DEBUG']) {
+            console.log(`Executing: ${command} ${args.join(' ')}`);
+        }
+        const child = spawn(command, args, {
+            stdio: 'ignore',
+            detached: false,
+        });
+        // Set a timeout to prevent hanging
+        const timeout = setTimeout(() => {
+            child.kill();
+            resolve();
+        }, 5000); // 5 second timeout
+        child.on('error', (_error) => {
+            clearTimeout(timeout);
+            // If paplay fails on Linux, try aplay as fallback
+            if (currentPlatform === 'linux' && command === 'paplay') {
+                const fallbackChild = spawn('aplay', [soundPath], {
+                    stdio: 'ignore',
+                    detached: false,
+                });
+                fallbackChild.on('error', () => {
+                    // Silently fail if both commands don't work
+                    resolve();
+                });
+                fallbackChild.on('close', () => {
+                    resolve();
+                });
+            }
+            else {
+                // Silently fail - don't crash the app if sound can't play
+                resolve();
+            }
+        });
+        child.on('close', () => {
+            clearTimeout(timeout);
+            resolve();
+        });
+    });
+}
+/**
+ * Play the completion notification sound
+ * This function is non-blocking and will not throw errors
+ */
+export async function playCompletionSound() {
+    try {
+        const soundPath = getNotificationSoundPath();
+        await playSoundFile(soundPath);
+    }
+    catch (_error) {
+        // Silently fail - sound notifications should never crash the app
+        // Only log in debug mode if needed
+    }
+}
+/**
+ * Play the completion notification sound without waiting for it to finish
+ * This is a fire-and-forget version that returns immediately
+ */
+export function playCompletionSoundAsync() {
+    playCompletionSound().catch(() => {
+        // Silently ignore errors
+    });
+}
+//# sourceMappingURL=soundNotification.js.map

package/dist/src/utils/soundNotification.js.map

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

package/dist/src/utils/userStartupWarnings.js

@@ -4,27 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import fs from 'node:fs/promises';
-import * as os from 'node:os';
 import path from 'node:path';
 // Individual warning checks
-const homeDirectoryCheck = {
-    id: 'home-directory',
-    check: async (workspaceRoot) => {
-        try {
-            const [workspaceRealPath, homeRealPath] = await Promise.all([
-                fs.realpath(workspaceRoot),
-                fs.realpath(os.homedir()),
-            ]);
-            if (workspaceRealPath === homeRealPath) {
-                return 'You are running Blackbox Code in your home directory. It is recommended to run in a project-specific directory.';
-            }
-            return null;
-        }
-        catch (_err) {
-            return 'Could not verify the current directory due to a file system error.';
-        }
-    },
-};
 const rootDirectoryCheck = {
     id: 'root-directory',
     check: async (workspaceRoot) => {
@@ -44,7 +25,6 @@ const rootDirectoryCheck = {
 };
 // All warning checks
 const WARNING_CHECKS = [
-    homeDirectoryCheck,
     rootDirectoryCheck,
 ];
 export async function getUserStartupWarnings(workspaceRoot) {

package/dist/src/utils/userStartupWarnings.js.map

@@ -1 +1 @@
-{"version":3,"file":"userStartupWarnings.js","sourceRoot":"","sources":["../../../src/utils/userStartupWarnings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,4BAA4B;AAC5B,MAAM,kBAAkB,GAAiB;IACvC,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,KAAK,EAAE,aAAqB,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1D,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAC1B,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;aAC1B,CAAC,CAAC;YAEH,IAAI,iBAAiB,KAAK,YAAY,EAAE,CAAC;gBACvC,OAAO,iHAAiH,CAAC;YAC3H,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,IAAa,EAAE,CAAC;YACvB,OAAO,oEAAoE,CAAC;QAC9E,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,kBAAkB,GAAiB;IACvC,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,KAAK,EAAE,aAAqB,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC3D,MAAM,YAAY,GAChB,yLAAyL,CAAC;YAE5L,gCAAgC;YAChC,IAAI,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,iBAAiB,EAAE,CAAC;gBAC1D,OAAO,YAAY,CAAC;YACtB,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,IAAa,EAAE,CAAC;YACvB,OAAO,oEAAoE,CAAC;QAC9E,CAAC;IACH,CAAC;CACF,CAAC;AAEF,qBAAqB;AACrB,MAAM,cAAc,GAA4B;IAC9C,kBAAkB;IAClB,kBAAkB;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,aAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAC1D,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"userStartupWarnings.js","sourceRoot":"","sources":["../../../src/utils/userStartupWarnings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,4BAA4B;AAC5B,MAAM,kBAAkB,GAAiB;IACvC,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,KAAK,EAAE,aAAqB,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC3D,MAAM,YAAY,GAChB,yLAAyL,CAAC;YAE5L,gCAAgC;YAChC,IAAI,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,iBAAiB,EAAE,CAAC;gBAC1D,OAAO,YAAY,CAAC;YACtB,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,IAAa,EAAE,CAAC;YACvB,OAAO,oEAAoE,CAAC;QAC9E,CAAC;IACH,CAAC;CACF,CAAC;AAEF,qBAAqB;AACrB,MAAM,cAAc,GAA4B;IAC9C,kBAAkB;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,aAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAC1D,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/src/utils/versionStorage.d.ts

@@ -38,6 +38,13 @@ export interface PendingUpdateInfo {
     version: string;
     checkedAt: number;
 }
+/**
+ * Interface for last check timestamp information
+ */
+export interface LastCheckInfo {
+    timestamp: number;
+    success: boolean;
+}
 /**
  * Reads pending update information
  */
@@ -50,3 +57,16 @@ export declare function writePendingUpdate(version: string): boolean;
  * Clears pending update information
  */
 export declare function clearPendingUpdate(): boolean;
+/**
+ * Reads last check information
+ */
+export declare function readLastCheck(): LastCheckInfo | null;
+/**
+ * Writes last check information
+ */
+export declare function writeLastCheck(success: boolean): boolean;
+/**
+ * Checks if enough time has passed since last check
+ * @param minIntervalMs Minimum interval in milliseconds (default: 10 minutes)
+ */
+export declare function shouldCheckForUpdate(minIntervalMs?: number): boolean;