lsh-framework 0.5.13 → 0.7.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,36 +68,36 @@ program
             await startInteractiveShell(options);
         }
         else {
-            // No arguments - show commands without verbose options
-            console.log('LSH - A modern shell with ZSH features and superior job management');
+            // No arguments - show secrets-focused help
+            console.log('LSH - Encrypted Secrets Manager with Automatic Rotation');
             console.log('');
-            console.log('Usage: lsh [options] [command]');
+            console.log('🔐 Secrets Management (Primary Features):');
+            console.log('  lib secrets sync        Check sync status & get recommendations');
+            console.log('  lib secrets push        Upload .env to encrypted cloud storage');
+            console.log('  lib secrets pull        Download .env from cloud storage');
+            console.log('  lib secrets list        List all stored environments');
+            console.log('  lib secrets show        View secrets (masked)');
+            console.log('  lib secrets key         Generate encryption key');
+            console.log('  lib secrets create      Create new .env file');
             console.log('');
-            console.log('Commands:');
-            console.log('  repl                    JavaScript REPL interactive shell');
-            console.log('  script <file>           Execute shell script');
-            console.log('  config                  Manage configuration');
-            console.log('  zsh                     ZSH compatibility commands');
-            console.log('  help                    Show detailed help');
+            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('Self-Management:');
-            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');
-            console.log('  self zsh-import         Import ZSH configs');
+            console.log('🚀 Quick Start:');
+            console.log('  lsh lib secrets key                   # Generate encryption key');
+            console.log('  lsh lib secrets push --env dev        # Push your secrets');
+            console.log('  lsh lib secrets pull --env dev        # Pull on another machine');
             console.log('');
-            console.log('Library Services:');
+            console.log('📚 More Commands:');
             console.log('  lib api                 API server management');
-            console.log('  lib daemon              Daemon management');
-            console.log('  lib cron                Cron job management');
-            console.log('  lib secrets             Secrets management');
             console.log('  lib supabase            Supabase database management');
+            console.log('  self                    Self-management commands');
+            console.log('  -i, --interactive       Start interactive shell');
+            console.log('  --help                  Show all options');
             console.log('');
-            console.log('Quick Start:');
-            console.log('  lsh -i                  Start interactive shell');
-            console.log('  lsh --help              Show all options');
-            console.log('  lsh help                Show detailed help with examples');
+            console.log('📖 Documentation: https://github.com/gwicho38/lsh');
         }
     }
     catch (error) {
@@ -158,6 +162,50 @@ 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
@@ -173,6 +221,63 @@ 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);
 })();

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

package/dist/lib/secrets-manager.js

@@ -3,6 +3,7 @@
  * Sync .env files across machines using encrypted Supabase storage
  */
 import * as fs from 'fs';
+import * as path from 'path';
 import * as crypto from 'crypto';
 import DatabasePersistence from './database-persistence.js';
 import { createLogger } from './logger.js';
@@ -212,5 +213,131 @@ export class SecretsManager {
         }
         console.log();
     }
+    /**
+     * Get status of secrets for an environment
+     */
+    async status(envFilePath = '.env', environment = 'dev') {
+        const status = {
+            localExists: false,
+            localKeys: 0,
+            localModified: undefined,
+            cloudExists: false,
+            cloudKeys: 0,
+            cloudModified: undefined,
+            keySet: !!process.env.LSH_SECRETS_KEY,
+            keyMatches: undefined,
+            suggestions: [],
+        };
+        // Check local file
+        if (fs.existsSync(envFilePath)) {
+            status.localExists = true;
+            const stat = fs.statSync(envFilePath);
+            status.localModified = stat.mtime;
+            const content = fs.readFileSync(envFilePath, 'utf8');
+            const env = this.parseEnvFile(content);
+            status.localKeys = Object.keys(env).length;
+        }
+        // Check cloud storage
+        try {
+            const jobs = await this.persistence.getActiveJobs();
+            const secretsJobs = jobs
+                .filter(j => j.command === 'secrets_sync' && j.job_id.includes(environment))
+                .sort((a, b) => new Date(b.started_at).getTime() - new Date(a.started_at).getTime());
+            if (secretsJobs.length > 0) {
+                status.cloudExists = true;
+                const latestSecret = secretsJobs[0];
+                status.cloudModified = new Date(latestSecret.completed_at || latestSecret.started_at);
+                // Try to decrypt to check if key matches
+                if (latestSecret.output) {
+                    try {
+                        const decrypted = this.decrypt(latestSecret.output);
+                        const env = this.parseEnvFile(decrypted);
+                        status.cloudKeys = Object.keys(env).length;
+                        status.keyMatches = true;
+                    }
+                    catch (error) {
+                        status.keyMatches = false;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Cloud check failed, likely no connection
+        }
+        return status;
+    }
+    /**
+     * Sync command - check status and suggest actions
+     */
+    async sync(envFilePath = '.env', environment = 'dev') {
+        console.log(`\n🔍 Checking secrets status for environment: ${environment}\n`);
+        const status = await this.status(envFilePath, environment);
+        // Display status
+        console.log('📊 Status:');
+        console.log(`  Encryption key set: ${status.keySet ? '✅' : '❌'}`);
+        console.log(`  Local .env file: ${status.localExists ? `✅ (${status.localKeys} keys)` : '❌'}`);
+        console.log(`  Cloud storage: ${status.cloudExists ? `✅ (${status.cloudKeys} keys)` : '❌'}`);
+        if (status.cloudExists && status.keyMatches !== undefined) {
+            console.log(`  Key matches cloud: ${status.keyMatches ? '✅' : '❌'}`);
+        }
+        console.log();
+        // Generate suggestions
+        const suggestions = [];
+        if (!status.keySet) {
+            suggestions.push('⚠️  No encryption key set!');
+            suggestions.push('   Generate a key: lsh lib secrets key');
+            suggestions.push('   Add it to .env: LSH_SECRETS_KEY=<your-key>');
+            suggestions.push('   Load it: export $(cat .env | xargs)');
+        }
+        if (status.cloudExists && status.keyMatches === false) {
+            suggestions.push('⚠️  Encryption key does not match cloud storage!');
+            suggestions.push('   Either use the original key, or push new secrets:');
+            suggestions.push(`   lsh lib secrets push -f ${envFilePath} -e ${environment}`);
+        }
+        if (!status.localExists && status.cloudExists && status.keyMatches) {
+            suggestions.push('💡 Cloud secrets available but no local file');
+            suggestions.push(`   Pull from cloud: lsh lib secrets pull -f ${envFilePath} -e ${environment}`);
+        }
+        if (status.localExists && !status.cloudExists) {
+            suggestions.push('💡 Local .env exists but not in cloud');
+            suggestions.push(`   Push to cloud: lsh lib secrets push -f ${envFilePath} -e ${environment}`);
+        }
+        if (status.localExists && status.cloudExists && status.keyMatches) {
+            if (status.localModified && status.cloudModified) {
+                const localNewer = status.localModified > status.cloudModified;
+                const timeDiff = Math.abs(status.localModified.getTime() - status.cloudModified.getTime());
+                const daysDiff = Math.floor(timeDiff / (1000 * 60 * 60 * 24));
+                if (localNewer && daysDiff > 0) {
+                    suggestions.push('💡 Local file is newer than cloud');
+                    suggestions.push(`   Push to cloud: lsh lib secrets push -f ${envFilePath} -e ${environment}`);
+                }
+                else if (!localNewer && daysDiff > 0) {
+                    suggestions.push('💡 Cloud is newer than local file');
+                    suggestions.push(`   Pull from cloud: lsh lib secrets pull -f ${envFilePath} -e ${environment}`);
+                }
+                else {
+                    suggestions.push('✅ Local and cloud are in sync!');
+                }
+            }
+        }
+        // Show how to load secrets in current shell
+        if (status.localExists && status.keySet) {
+            suggestions.push('');
+            suggestions.push('📝 To load secrets in your current shell:');
+            suggestions.push(`   export $(cat ${envFilePath} | grep -v '^#' | xargs)`);
+            suggestions.push('');
+            suggestions.push('   Or for safer loading (with quotes):');
+            suggestions.push(`   set -a; source ${envFilePath}; set +a`);
+            suggestions.push('');
+            suggestions.push('💡 Add to your shell profile for auto-loading:');
+            suggestions.push(`   echo "set -a; source ${path.resolve(envFilePath)}; set +a" >> ~/.zshrc`);
+        }
+        // Display suggestions
+        if (suggestions.length > 0) {
+            console.log('📋 Recommendations:\n');
+            suggestions.forEach(s => console.log(s));
+            console.log();
+        }
+    }
 }
 export default SecretsManager;

package/dist/services/secrets/secrets.js

@@ -154,6 +154,39 @@ API_KEY=
             process.exit(1);
         }
     });
+    // Sync command - check status and suggest actions
+    secretsCmd
+        .command('sync')
+        .description('Check secrets sync status and show recommended actions')
+        .option('-f, --file <path>', 'Path to .env file', '.env')
+        .option('-e, --env <name>', 'Environment name', 'dev')
+        .action(async (options) => {
+        try {
+            const manager = new SecretsManager();
+            await manager.sync(options.file, options.env);
+        }
+        catch (error) {
+            console.error('❌ Failed to check sync status:', error.message);
+            process.exit(1);
+        }
+    });
+    // Status command - get detailed status info
+    secretsCmd
+        .command('status')
+        .description('Get detailed secrets status (JSON output)')
+        .option('-f, --file <path>', 'Path to .env file', '.env')
+        .option('-e, --env <name>', 'Environment name', 'dev')
+        .action(async (options) => {
+        try {
+            const manager = new SecretsManager();
+            const status = await manager.status(options.file, options.env);
+            console.log(JSON.stringify(status, null, 2));
+        }
+        catch (error) {
+            console.error('❌ Failed to get status:', error.message);
+            process.exit(1);
+        }
+    });
     // Delete .env file with confirmation
     secretsCmd
         .command('delete')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lsh-framework",
-  "version": "0.5.13",
-  "description": "A powerful, extensible shell with advanced job management, database persistence, and modern CLI features",
+  "version": "0.7.0",
+  "description": "Encrypted secrets manager with automatic rotation, team sync, and multi-environment support. Built on a powerful shell with daemon scheduling and CI/CD integration.",
   "main": "dist/app.js",
   "bin": {
     "lsh": "./dist/cli.js"
@@ -36,21 +36,25 @@
     "audit:security": "npm audit --audit-level moderate"
   },
   "keywords": [
-    "cli",
+    "secrets-manager",
+    "secrets",
+    "env-manager",
+    "dotenv",
+    "environment-variables",
+    "encryption",
+    "credential-management",
+    "team-sync",
+    "secrets-rotation",
+    "multi-environment",
+    "devops",
+    "security",
     "shell",
-    "terminal",
-    "job-manager",
+    "automation",
     "cron",
     "daemon",
-    "zsh",
-    "bash",
-    "posix",
-    "database-persistence",
-    "task-scheduler",
-    "command-line",
-    "automation",
-    "devops",
-    "cicd"
+    "job-scheduler",
+    "cicd",
+    "cli"
   ],
   "engines": {
     "node": ">=20.18.0",
@@ -138,7 +142,7 @@
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.2.0",
     "supertest": "^7.1.4",
-    "ts-jest": "^29.4.4",
+    "ts-jest": "^29.2.5",
     "typescript": "^5.4.5"
   }
 }