lsh-framework 0.6.0 → 0.8.0

package/dist/cli.js

@@ -36,8 +36,12 @@ function getVersion() {
 const program = new Command();
 program
     .name('lsh')
-    .description('LSH - A modern shell with ZSH features and superior job management')
-    .version(getVersion());
+    .description('LSH - Encrypted secrets manager with automatic rotation and team sync')
+    .version(getVersion())
+    .showSuggestionAfterError(true)
+    .showHelpAfterError('(add --help for additional information)')
+    .allowUnknownOption(false)
+    .enablePositionalOptions();
 // Options for main command
 program
     .option('-i, --interactive', 'Start interactive shell')
@@ -64,8 +68,39 @@ program
             await startInteractiveShell(options);
         }
         else {
-            // No arguments - show help
-            program.help();
+            // No arguments - show secrets-focused help
+            console.log('LSH - Encrypted Secrets Manager with Automatic Rotation');
+            console.log('');
+            console.log('🔐 Secrets Management (Primary Features):');
+            console.log('  secrets sync            Check sync status & get recommendations');
+            console.log('  secrets push            Upload .env to encrypted cloud storage');
+            console.log('  secrets pull            Download .env from cloud storage');
+            console.log('  secrets list            List all stored environments');
+            console.log('  secrets show            View secrets (masked)');
+            console.log('  secrets key             Generate encryption key');
+            console.log('  secrets create          Create new .env file');
+            console.log('');
+            console.log('🔄 Automation (Schedule secret rotation):');
+            console.log('  lib cron add            Schedule automatic tasks');
+            console.log('  lib cron list           List scheduled jobs');
+            console.log('  lib daemon start        Start persistent daemon');
+            console.log('');
+            console.log('🚀 Quick Start:');
+            console.log('  lsh secrets key                   # Generate encryption key');
+            console.log('  lsh secrets push --env dev        # Push your secrets');
+            console.log('  lsh secrets pull --env dev        # Pull on another machine');
+            console.log('');
+            console.log('📚 More Commands:');
+            console.log('  lib api                 API server management');
+            console.log('  lib supabase            Supabase database management');
+            console.log('  lib daemon              Daemon management');
+            console.log('  lib cron                Cron job management');
+            console.log('  self                    Self-management commands');
+            console.log('  self zsh                ZSH compatibility commands');
+            console.log('  -i, --interactive       Start interactive shell');
+            console.log('  --help                  Show all options');
+            console.log('');
+            console.log('📖 Documentation: https://github.com/gwicho38/lsh');
         }
     }
     catch (error) {
@@ -105,8 +140,10 @@ program
         process.exit(1);
     }
 });
-// ZSH compatibility subcommand
-program
+// Self-management commands
+program.addCommand(selfCommand);
+// ZSH compatibility commands (under self)
+selfCommand
     .command('zsh')
     .description('ZSH compatibility commands')
     .option('--migrate', 'Migrate ZSH configuration to LSH')
@@ -121,8 +158,6 @@ program
         process.exit(1);
     }
 });
-// Self-management commands
-program.addCommand(selfCommand);
 // Help subcommand
 program
     .command('help')
@@ -130,26 +165,123 @@ program
     .action(() => {
     showDetailedHelp();
 });
+/**
+ * Calculate string similarity (Levenshtein distance)
+ */
+function similarity(s1, s2) {
+    const longer = s1.length > s2.length ? s1 : s2;
+    const shorter = s1.length > s2.length ? s2 : s1;
+    if (longer.length === 0)
+        return 1.0;
+    const editDistance = levenshtein(longer, shorter);
+    return (longer.length - editDistance) / longer.length;
+}
+function levenshtein(s1, s2) {
+    const costs = [];
+    for (let i = 0; i <= s1.length; i++) {
+        let lastValue = i;
+        for (let j = 0; j <= s2.length; j++) {
+            if (i === 0) {
+                costs[j] = j;
+            }
+            else if (j > 0) {
+                let newValue = costs[j - 1];
+                if (s1.charAt(i - 1) !== s2.charAt(j - 1)) {
+                    newValue = Math.min(Math.min(newValue, lastValue), costs[j]) + 1;
+                }
+                costs[j - 1] = lastValue;
+                lastValue = newValue;
+            }
+        }
+        if (i > 0)
+            costs[s2.length] = lastValue;
+    }
+    return costs[s2.length];
+}
+/**
+ * Find similar commands for suggestions
+ */
+function findSimilarCommands(input, validCommands) {
+    const similarities = validCommands
+        .map(cmd => ({ cmd, score: similarity(input, cmd) }))
+        .filter(item => item.score > 0.5) // Only suggest if similarity > 50%
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 3); // Top 3 suggestions
+    return similarities.map(item => item.cmd);
+}
 // Register async command modules
 (async () => {
     // REPL interactive shell
     await init_ishell(program);
-    // Library commands
-    await init_lib(program);
-    // Supabase commands
-    await init_supabase(program);
-    // Daemon management commands
-    await init_daemon(program);
-    // Cron commands
-    await init_cron(program);
-    // Secrets management commands
+    // Library commands (parent for service commands)
+    const libCommand = await init_lib(program);
+    // Nest service commands under lib
+    await init_supabase(libCommand);
+    await init_daemon(libCommand);
+    await init_cron(libCommand);
+    registerApiCommands(libCommand);
+    // Secrets as top-level command
     await init_secrets(program);
-    // API server commands
-    registerApiCommands(program);
-    // ZSH import commands
-    registerZshImportCommands(program);
-    // Theme commands
-    registerThemeCommands(program);
+    // Self-management commands with nested utilities
+    registerZshImportCommands(selfCommand);
+    registerThemeCommands(selfCommand);
+    // Pre-parse check for unknown commands
+    const args = process.argv.slice(2);
+    if (args.length > 0) {
+        const firstArg = args[0];
+        const validCommands = program.commands.map(cmd => cmd.name());
+        const validOptions = ['-i', '--interactive', '-c', '--command', '-s', '--script',
+            '--rc', '--zsh-compat', '--source-zshrc', '--package-manager',
+            '-v', '--verbose', '-d', '--debug', '-h', '--help', '-V', '--version'];
+        // Check if first argument looks like a command but isn't valid
+        if (!firstArg.startsWith('-') &&
+            !validCommands.includes(firstArg) &&
+            !validOptions.some(opt => args.includes(opt))) {
+            const suggestions = findSimilarCommands(firstArg, validCommands);
+            console.error(`error: unknown command '${firstArg}'`);
+            if (suggestions.length > 0) {
+                console.error(`\nDid you mean one of these?`);
+                suggestions.forEach(cmd => console.error(`    ${cmd}`));
+            }
+            console.error(`\nRun 'lsh --help' to see available commands.`);
+            process.exit(1);
+        }
+    }
+    // Configure custom error output for better suggestions
+    program.configureOutput({
+        writeErr: (str) => {
+            // Intercept error messages to add suggestions
+            if (str.includes('error: unknown command')) {
+                const match = str.match(/unknown command '([^']+)'/);
+                if (match) {
+                    const unknownCommand = match[1];
+                    const validCommands = program.commands.map(cmd => cmd.name());
+                    const suggestions = findSimilarCommands(unknownCommand, validCommands);
+                    process.stderr.write(str);
+                    if (suggestions.length > 0) {
+                        process.stderr.write(`\nDid you mean one of these?\n`);
+                        suggestions.forEach(cmd => process.stderr.write(`    ${cmd}\n`));
+                    }
+                    process.stderr.write(`\nRun 'lsh --help' to see available commands.\n`);
+                    return;
+                }
+            }
+            process.stderr.write(str);
+        }
+    });
+    // Add custom error handler for unknown commands
+    program.on('command:*', (operands) => {
+        const unknownCommand = operands[0];
+        const validCommands = program.commands.map(cmd => cmd.name());
+        const suggestions = findSimilarCommands(unknownCommand, validCommands);
+        console.error(`error: unknown command '${unknownCommand}'`);
+        if (suggestions.length > 0) {
+            console.error(`\nDid you mean one of these?`);
+            suggestions.forEach(cmd => console.error(`    ${cmd}`));
+        }
+        console.error(`\nRun 'lsh --help' to see available commands.`);
+        process.exit(1);
+    });
     // Parse command line arguments after all commands are registered
     program.parse(process.argv);
 })();
@@ -445,22 +577,28 @@ function showDetailedHelp() {
     console.log('  -V, --version          Show version');
     console.log('');
     console.log('Subcommands:');
+    console.log('  secrets                 Secrets management (primary feature)');
     console.log('  repl                    JavaScript REPL interactive shell');
-    console.log('  lib                     Library commands');
-    console.log('  supabase                Supabase database management');
     console.log('  script <file>           Execute shell script');
     console.log('  config                  Manage configuration');
-    console.log('  zsh                     ZSH compatibility commands');
-    console.log('  zsh-import              Import ZSH configs (aliases, functions, exports)');
-    console.log('  theme                   Manage themes (import Oh-My-Zsh themes)');
-    console.log('  self                    Self-management (update, version)');
-    console.log('  daemon                  Daemon management');
-    console.log('  daemon job              Job management');
-    console.log('  daemon db               Database integration');
-    console.log('  cron                    Cron job management');
-    console.log('  api                     API server management');
     console.log('  help                    Show detailed help');
     console.log('');
+    console.log('Self-Management (lsh self <command>):');
+    console.log('  self update             Update to latest version');
+    console.log('  self version            Show version information');
+    console.log('  self uninstall          Uninstall LSH from system');
+    console.log('  self theme              Manage themes (import Oh-My-Zsh themes)');
+    console.log('  self zsh                ZSH compatibility commands');
+    console.log('  self zsh-import         Import ZSH configs (aliases, functions, exports)');
+    console.log('');
+    console.log('Library Commands (lsh lib <command>):');
+    console.log('  lib api                 API server management');
+    console.log('  lib supabase            Supabase database management');
+    console.log('  lib daemon              Daemon management');
+    console.log('  lib daemon job          Job management');
+    console.log('  lib daemon db           Database integration');
+    console.log('  lib cron                Cron job management');
+    console.log('');
     console.log('Examples:');
     console.log('');
     console.log('  Shell Usage:');
@@ -476,18 +614,26 @@ function showDetailedHelp() {
     console.log('    lsh self version                    # Show version');
     console.log('    lsh self update                     # Update to latest');
     console.log('');
-    console.log('  Daemon & Job Management:');
-    console.log('    lsh daemon start                    # Start daemon');
-    console.log('    lsh daemon status                   # Check daemon status');
-    console.log('    lsh daemon job list                 # List all jobs');
-    console.log('    lsh daemon job create               # Create new job');
-    console.log('    lsh daemon job trigger <id>         # Run job immediately');
+    console.log('  Self-Management:');
+    console.log('    lsh self update                     # Update to latest version');
+    console.log('    lsh self version                    # Show version');
+    console.log('    lsh self theme list                 # List available themes');
+    console.log('    lsh self theme import robbyrussell  # Import Oh-My-Zsh theme');
+    console.log('    lsh self zsh-import aliases         # Import ZSH aliases');
+    console.log('');
+    console.log('  Secrets Management:');
+    console.log('    lsh secrets sync                    # Check sync status');
+    console.log('    lsh secrets push                    # Push secrets to cloud');
+    console.log('    lsh secrets pull                    # Pull secrets from cloud');
+    console.log('    lsh secrets list                    # List environments');
     console.log('');
-    console.log('  API Server:');
-    console.log('    lsh api start                       # Start daemon with API');
-    console.log('    lsh api key                         # Generate API key');
-    console.log('    lsh api test                        # Test API connection');
-    console.log('    lsh api example -l python           # Show Python client code');
+    console.log('  Library Services:');
+    console.log('    lsh lib daemon start                # Start daemon');
+    console.log('    lsh lib daemon status               # Check daemon status');
+    console.log('    lsh lib daemon job list             # List all jobs');
+    console.log('    lsh lib cron list                   # List cron jobs');
+    console.log('    lsh lib api start                   # Start API server');
+    console.log('    lsh lib api key                     # Generate API key');
     console.log('');
     console.log('Features:');
     console.log('  ✅ POSIX Shell Compliance (85-95%)');

package/dist/commands/self.js

@@ -60,7 +60,7 @@ async function fetchLatestVersion() {
         const options = {
             hostname: 'registry.npmjs.org',
             port: 443,
-            path: '/gwicho38-lsh',
+            path: '/lsh-framework',
             method: 'GET',
             headers: {
                 'User-Agent': 'lsh-cli',
@@ -239,7 +239,7 @@ selfCommand
         // Install update
         console.log(chalk.cyan(`📦 Installing lsh ${latestVersion}...`));
         const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-        const updateProcess = spawn(npmCmd, ['install', '-g', 'gwicho38-lsh@latest'], {
+        const updateProcess = spawn(npmCmd, ['install', '-g', 'lsh-framework@latest'], {
             stdio: 'inherit',
         });
         updateProcess.on('close', (code) => {
@@ -249,7 +249,7 @@ selfCommand
             }
             else {
                 console.log(chalk.red('✗ Update failed'));
-                console.log(chalk.yellow('ℹ Try running with sudo: sudo npm install -g gwicho38-lsh@latest'));
+                console.log(chalk.yellow('ℹ Try running with sudo: sudo npm install -g lsh-framework@latest'));
             }
         });
     }
@@ -315,4 +315,60 @@ selfCommand
     console.log();
     console.log(chalk.dim('For more info, visit: https://github.com/gwicho38/lsh'));
 });
+/**
+ * Uninstall command - remove LSH from the system
+ */
+selfCommand
+    .command('uninstall')
+    .description('Uninstall LSH from your system')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .action(async (options) => {
+    try {
+        console.log(chalk.yellow('╔════════════════════════════════════╗'));
+        console.log(chalk.yellow('║      Uninstall LSH Framework       ║'));
+        console.log(chalk.yellow('╚════════════════════════════════════╝'));
+        console.log();
+        // Ask for confirmation unless --yes flag is used
+        if (!options.yes) {
+            const readline = await import('readline');
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            const answer = await new Promise((resolve) => {
+                rl.question(chalk.yellow('Are you sure you want to uninstall LSH? (y/N) '), (ans) => {
+                    rl.close();
+                    resolve(ans);
+                });
+            });
+            if (answer.toLowerCase() !== 'y' && answer.toLowerCase() !== 'yes') {
+                console.log(chalk.yellow('Uninstall cancelled'));
+                return;
+            }
+        }
+        console.log(chalk.cyan('📦 Uninstalling lsh-framework...'));
+        console.log();
+        const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+        const uninstallProcess = spawn(npmCmd, ['uninstall', '-g', 'lsh-framework'], {
+            stdio: 'inherit',
+        });
+        uninstallProcess.on('close', (code) => {
+            if (code === 0) {
+                console.log();
+                console.log(chalk.green('✓ LSH has been uninstalled successfully'));
+                console.log();
+                console.log(chalk.dim('Thank you for using LSH!'));
+                console.log(chalk.dim('You can reinstall anytime with: npm install -g lsh-framework'));
+            }
+            else {
+                console.log();
+                console.log(chalk.red('✗ Uninstall failed'));
+                console.log(chalk.yellow('ℹ Try running with sudo: sudo npm uninstall -g lsh-framework'));
+            }
+        });
+    }
+    catch (error) {
+        console.error(chalk.red('✗ Error during uninstall:'), error);
+    }
+});
 export default selfCommand;

package/dist/commands/theme.js

@@ -61,7 +61,8 @@ export function registerThemeCommands(program) {
         console.log(chalk.dim('  lsh theme import <name>    # For Oh-My-Zsh themes'));
         console.log(chalk.dim('  lsh theme apply <name>'));
         console.log('');
-        process.exit(0);
+        // Note: Removed process.exit(0) to allow proper Jest testing
+        // Commander will handle exit automatically
     });
     themeCommand
         .command('import <name>')

package/dist/lib/base-job-manager.js

@@ -203,7 +203,8 @@ export class BaseJobManager extends EventEmitter {
     async removeJob(jobId, force = false) {
         const job = await this.getJob(jobId);
         if (!job) {
-            throw new Error(`Job ${jobId} not found`);
+            // Return false instead of throwing when job doesn't exist
+            return false;
         }
         // Check if job is running
         if (job.status === 'running' && !force) {

package/dist/lib/job-manager.js

@@ -14,13 +14,54 @@ export class JobManager extends BaseJobManager {
     nextJobId = 1;
     persistenceFile;
     schedulerInterval;
+    initPromise;
     constructor(persistenceFile = '/tmp/lsh-jobs.json') {
         super(new MemoryJobStorage(), 'JobManager');
         this.persistenceFile = persistenceFile;
-        this.loadPersistedJobs();
+        this.initPromise = this.loadPersistedJobs();
         this.startScheduler();
         this.setupCleanupHandlers();
     }
+    /**
+     * Wait for initialization to complete
+     */
+    async ready() {
+        await this.initPromise;
+    }
+    /**
+     * Create a job and persist to filesystem
+     */
+    async createJob(spec) {
+        const job = await super.createJob(spec);
+        await this.persistJobs();
+        return job;
+    }
+    /**
+     * Update a job and persist to filesystem
+     */
+    async updateJob(jobId, updates) {
+        const job = await super.updateJob(jobId, updates);
+        await this.persistJobs();
+        return job;
+    }
+    /**
+     * Remove a job and persist to filesystem
+     */
+    async removeJob(jobId, force = false) {
+        const result = await super.removeJob(jobId, force);
+        if (result) {
+            await this.persistJobs();
+        }
+        return result;
+    }
+    /**
+     * Update job status and persist to filesystem
+     */
+    async updateJobStatus(jobId, status, additionalUpdates) {
+        const job = await super.updateJobStatus(jobId, status, additionalUpdates);
+        await this.persistJobs();
+        return job;
+    }
     /**
      * Start a job (execute it as a process)
      */
@@ -67,14 +108,19 @@ export class JobManager extends BaseJobManager {
                 this.emit('jobOutput', job.id, 'stderr', data.toString());
             });
             // Handle completion
-            job.process.on('exit', (code, signal) => {
+            job.process.on('exit', async (code, signal) => {
+                // Check if job still exists (might have been removed during cleanup)
+                const existingJob = await this.getJob(job.id);
+                if (!existingJob) {
+                    this.logger.debug(`Job ${job.id} already removed, skipping status update`);
+                    return;
+                }
                 const status = code === 0 ? 'completed' : (signal === 'SIGKILL' ? 'killed' : 'failed');
-                this.updateJobStatus(job.id, status, {
+                await this.updateJobStatus(job.id, status, {
                     completedAt: new Date(),
                     exitCode: code || undefined,
                 });
                 this.emit('jobCompleted', job, code, signal);
-                this.persistJobs();
             });
             // Set timeout if specified
             if (job.timeout) {
@@ -87,7 +133,6 @@ export class JobManager extends BaseJobManager {
                 startedAt: new Date(),
                 pid: job.pid,
             });
-            await this.persistJobs();
             return updatedJob;
         }
         catch (error) {
@@ -96,7 +141,6 @@ export class JobManager extends BaseJobManager {
                 stderr: error.message,
             });
             this.emit('jobFailed', job, error);
-            await this.persistJobs();
             throw error;
         }
     }
@@ -131,7 +175,6 @@ export class JobManager extends BaseJobManager {
         const updatedJob = await this.updateJobStatus(jobId, 'stopped', {
             completedAt: new Date(),
         });
-        await this.persistJobs();
         return updatedJob;
     }
     /**
@@ -289,6 +332,11 @@ export class JobManager extends BaseJobManager {
         try {
             if (fs.existsSync(this.persistenceFile)) {
                 const data = fs.readFileSync(this.persistenceFile, 'utf8');
+                // Handle empty file
+                if (!data || data.trim() === '') {
+                    this.logger.info('Persistence file is empty, starting fresh');
+                    return;
+                }
                 const persistedJobs = JSON.parse(data);
                 for (const job of persistedJobs) {
                     // Convert date strings back to Date objects

package/dist/lib/lshrc-init.js

@@ -11,7 +11,9 @@ const __dirname = path.dirname(__filename);
 export class LshrcManager {
     lshrcPath;
     constructor(lshrcPath) {
-        this.lshrcPath = lshrcPath || path.join(os.homedir(), '.lshrc');
+        // Use process.env.HOME if set (for testability), fallback to os.homedir()
+        const homeDir = process.env.HOME || os.homedir();
+        this.lshrcPath = lshrcPath || path.join(homeDir, '.lshrc');
     }
     /**
      * Initialize .lshrc if it doesn't exist