aliasmate 1.0.0 → 1.3.0

package/dist/utils/executor.js

@@ -42,34 +42,59 @@ const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 /**
  * Execute a command in a specific directory
- * Cross-platform command execution using execa
+ * Uses execa with shell mode for cross-platform compatibility
+ *
+ * @param command - The shell command to execute
+ * @param cwd - The working directory to execute the command in
+ * @returns A promise that resolves with the execution result
+ * @throws {Error} If the directory doesn't exist
+ *
+ * @example
+ * ```ts
+ * const result = await executeCommand('npm install', '/path/to/project');
+ * if (result.success) {
+ *   console.log('Installation successful');
+ * }
+ * ```
  */
 async function executeCommand(command, cwd) {
+    // Validate inputs
+    if (!command || !command.trim()) {
+        throw new Error('Command cannot be empty');
+    }
+    // Resolve the directory path
+    const resolvedCwd = path.resolve(cwd);
+    // Check if directory exists
+    if (!fs.existsSync(resolvedCwd)) {
+        throw new Error(`Directory does not exist: ${resolvedCwd}`);
+    }
+    // Check if it's actually a directory
+    const stats = fs.statSync(resolvedCwd);
+    if (!stats.isDirectory()) {
+        throw new Error(`Path is not a directory: ${resolvedCwd}`);
+    }
     try {
-        // Resolve the directory path
-        const resolvedCwd = path.resolve(cwd);
-        // Check if directory exists
-        if (!fs.existsSync(resolvedCwd)) {
-            throw new Error(`Directory does not exist: ${resolvedCwd}`);
-        }
         // Execute the command using the user's shell
         // stdio: 'inherit' allows real-time output to terminal
         await (0, execa_1.default)(command, {
             shell: true,
             cwd: resolvedCwd,
-            stdio: 'inherit'
+            stdio: 'inherit',
         });
         return {
             success: true,
             stdout: '',
-            stderr: ''
+            stderr: '',
+            exitCode: 0,
         };
     }
     catch (error) {
+        const execaError = error;
         return {
             success: false,
-            stdout: error.stdout || '',
-            stderr: error.stderr || error.message
+            stdout: execaError.stdout || '',
+            stderr: execaError.stderr || execaError.message,
+            exitCode: execaError.exitCode,
         };
     }
 }

package/dist/utils/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/utils/executor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,wCA8BC;AA5CD,kDAA0B;AAC1B,2CAA6B;AAC7B,uCAAyB;AAQzB;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,GAAW;IAC/D,IAAI,CAAC;QACH,6BAA6B;QAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEtC,4BAA4B;QAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,6CAA6C;QAC7C,uDAAuD;QACvD,MAAM,IAAA,eAAK,EAAC,OAAO,EAAE;YACnB,KAAK,EAAE,IAAI;YACX,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO;SACtC,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/utils/executor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,wCA4CC;AA/ED,kDAA0B;AAC1B,2CAA6B;AAC7B,uCAAyB;AAgBzB;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,GAAW;IAC/D,kBAAkB;IAClB,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,qCAAqC;IACrC,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,WAAW,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC;QACH,6CAA6C;QAC7C,uDAAuD;QACvD,MAAM,IAAA,eAAK,EAAC,OAAO,EAAE;YACnB,KAAK,EAAE,IAAI;YACX,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,KAAyB,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;YAC/B,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,OAAO;YAC/C,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/utils/history.d.ts

@@ -1,19 +1,37 @@
 /**
  * Get the last command from shell history
  *
- * IMPORTANT: This implementation reads from the shell history file,
- * which may not include the most recent commands until the shell writes them.
+ * IMPORTANT: This reads from the shell history file, which may not include
+ * the most recent commands until the shell writes them.
  *
- * For best results, users should configure their shell for immediate history writing:
+ * For best results, configure your shell for immediate history writing:
  * - zsh: Add "setopt INC_APPEND_HISTORY" or "setopt SHARE_HISTORY" to ~/.zshrc
  * - bash: Add "PROMPT_COMMAND='history -a'" to ~/.bashrc
  * - PowerShell (Windows): History is written immediately by default
  *
  * Alternative: Use environment variable ALIASMATE_LAST_CMD passed from parent shell
+ *
+ * @returns The last command from history, or null if unavailable
+ *
+ * @example
+ * ```ts
+ * const lastCmd = getLastCommand();
+ * if (lastCmd) {
+ *   console.log(`Last command was: ${lastCmd}`);
+ * }
+ * ```
  */
 export declare function getLastCommand(): string | null;
 /**
  * Get shell-specific configuration instructions for real-time history
+ *
+ * @returns Instructions formatted for the user's shell
+ *
+ * @example
+ * ```ts
+ * const instructions = getHistoryConfigInstructions();
+ * console.log(`Configure your shell:\n${instructions}`);
+ * ```
  */
 export declare function getHistoryConfigInstructions(): string;
 //# sourceMappingURL=history.d.ts.map

package/dist/utils/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/utils/history.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CA8F9C;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAsBrD"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/utils/history.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CA8F9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAsBrD"}

package/dist/utils/history.js

@@ -41,15 +41,25 @@ const os = __importStar(require("os"));
 /**
  * Get the last command from shell history
  *
- * IMPORTANT: This implementation reads from the shell history file,
- * which may not include the most recent commands until the shell writes them.
+ * IMPORTANT: This reads from the shell history file, which may not include
+ * the most recent commands until the shell writes them.
  *
- * For best results, users should configure their shell for immediate history writing:
+ * For best results, configure your shell for immediate history writing:
  * - zsh: Add "setopt INC_APPEND_HISTORY" or "setopt SHARE_HISTORY" to ~/.zshrc
  * - bash: Add "PROMPT_COMMAND='history -a'" to ~/.bashrc
  * - PowerShell (Windows): History is written immediately by default
  *
  * Alternative: Use environment variable ALIASMATE_LAST_CMD passed from parent shell
+ *
+ * @returns The last command from history, or null if unavailable
+ *
+ * @example
+ * ```ts
+ * const lastCmd = getLastCommand();
+ * if (lastCmd) {
+ *   console.log(`Last command was: ${lastCmd}`);
+ * }
+ * ```
  */
 function getLastCommand() {
     try {
@@ -90,7 +100,7 @@ function getLastCommand() {
                     path.join(homeDir, '.zsh_history'),
                     path.join(homeDir, '.bash_history'),
                     path.join(homeDir, '.sh_history'),
-                    path.join(homeDir, '.history')
+                    path.join(homeDir, '.history'),
                 ];
                 for (const file of possibleFiles) {
                     if (fs.existsSync(file)) {
@@ -133,29 +143,33 @@ function getLastCommand() {
 }
 /**
  * Get shell-specific configuration instructions for real-time history
+ *
+ * @returns Instructions formatted for the user's shell
+ *
+ * @example
+ * ```ts
+ * const instructions = getHistoryConfigInstructions();
+ * console.log(`Configure your shell:\n${instructions}`);
+ * ```
  */
 function getHistoryConfigInstructions() {
     const platform = os.platform();
     const shell = process.env.SHELL || '';
     if (platform === 'win32') {
-        return 'PowerShell writes history immediately. If using Git Bash, add to ~/.bashrc:\n' +
-            '  PROMPT_COMMAND="history -a"';
+        return ('PowerShell writes history immediately. If using Git Bash, add to ~/.bashrc:\n' +
+            '  PROMPT_COMMAND="history -a"');
     }
     else if (shell.includes('zsh')) {
-        return 'Add to ~/.zshrc:\n' +
-            '  setopt INC_APPEND_HISTORY\n' +
-            'Then run: source ~/.zshrc';
+        return 'Add to ~/.zshrc:\n' + '  setopt INC_APPEND_HISTORY\n' + 'Then run: source ~/.zshrc';
     }
     else if (shell.includes('bash')) {
-        return 'Add to ~/.bashrc:\n' +
-            '  PROMPT_COMMAND="history -a"\n' +
-            'Then run: source ~/.bashrc';
+        return 'Add to ~/.bashrc:\n' + '  PROMPT_COMMAND="history -a"\n' + 'Then run: source ~/.bashrc';
     }
     else if (shell.includes('fish')) {
         return 'Fish writes history immediately by default';
     }
-    return 'Configure your shell to write history immediately.\n' +
+    return ('Configure your shell to write history immediately.\n' +
         'For bash: Add PROMPT_COMMAND="history -a" to ~/.bashrc\n' +
-        'For zsh: Add "setopt INC_APPEND_HISTORY" to ~/.zshrc';
+        'For zsh: Add "setopt INC_APPEND_HISTORY" to ~/.zshrc');
 }
 //# sourceMappingURL=history.js.map

package/dist/utils/history.js.map

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

package/dist/utils/llm-generator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Generate LLM.txt content with all AliasMate features and documentation
+ */
+export declare function generateLLMContent(): string;
+/**
+ * Create llm.txt file in the specified directory
+ * @param targetDir - The directory where llm.txt should be created
+ * @returns The full path to the created file
+ */
+export declare function createLLMFile(targetDir: string): string;
+/**
+ * Get the default LLM command configuration
+ * This command will be auto-created during onboarding
+ */
+export declare function getDefaultLLMCommand(): {
+    name: string;
+    command: string;
+    directory: string;
+    pathMode: 'current';
+};
+//# sourceMappingURL=llm-generator.d.ts.map

package/dist/utils/llm-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-generator.d.ts","sourceRoot":"","sources":["../../src/utils/llm-generator.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA4Q3C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,CAOhH"}

package/dist/utils/llm-generator.js

@@ -0,0 +1,337 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateLLMContent = generateLLMContent;
+exports.createLLMFile = createLLMFile;
+exports.getDefaultLLMCommand = getDefaultLLMCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const constants_1 = require("./constants");
+/**
+ * Generate LLM.txt content with all AliasMate features and documentation
+ */
+function generateLLMContent() {
+    return `# AliasMate - Terminal Command Management CLI
+
+Version: ${constants_1.APP_VERSION}
+Official Tool: ${constants_1.APP_NAME}
+
+## Overview
+
+AliasMate is a powerful CLI utility that saves, manages, and re-runs shell commands with their working directories. It helps developers save time, reduce errors, and boost productivity by eliminating the need to retype complex commands or remember their exact locations.
+
+## Core Capabilities
+
+### 1. Command Storage
+- Save any shell command with a memorable name
+- Store the working directory where the command should execute
+- Preserve metadata (creation date, last modified)
+- Support for complex multi-line commands and scripts
+
+### 2. Command Execution
+- Run saved commands from anywhere in the filesystem
+- Automatic directory switching to the saved location
+- Option to override execution directory (use current or saved path)
+- Support for both absolute and relative path overrides
+
+### 3. Command Management
+- List all saved commands with full details
+- Search commands by name, command text, or directory
+- Edit existing commands interactively
+- Delete unwanted commands
+- Export/import commands for backup and team sharing
+
+## Available Commands
+
+### aliasmate prev <name>
+Save the previous command from shell history.
+- Automatically captures the last executed command
+- Saves current working directory
+- Example: \`aliasmate prev build\`
+
+### aliasmate run <name> [path]
+Execute a saved command.
+- Runs in saved directory by default
+- Optional path parameter to override directory
+- Supports path mode (saved vs current directory)
+- Example: \`aliasmate run build\` or \`aliasmate run build .\`
+
+### aliasmate save
+Interactively create a new saved command.
+- Prompts for command name
+- Prompts for command to execute
+- Prompts for working directory
+- Prompts for path mode preference
+- Example: \`aliasmate save\`
+
+### aliasmate list (alias: ls)
+Display all saved commands.
+- Shows command name, actual command, and directory
+- Displays path mode for each command
+- Color-coded output for readability
+- Example: \`aliasmate list\`
+
+### aliasmate search <query> (alias: find)
+Search for commands by keyword.
+- Searches in command name, command text, and directory path
+- Case-insensitive matching
+- Example: \`aliasmate search deploy\`
+
+### aliasmate edit <name>
+Modify an existing command.
+- Interactive prompts with current values
+- Update command text, directory, or path mode
+- Example: \`aliasmate edit build\`
+
+### aliasmate delete <name> (alias: rm)
+Remove a saved command.
+- Permanently deletes the command
+- Example: \`aliasmate delete old-build\`
+
+### aliasmate export <file>
+Export all commands to a JSON file.
+- Backup your commands
+- Share with team members
+- Example: \`aliasmate export my-commands.json\`
+
+### aliasmate import <file>
+Import commands from a JSON file.
+- Restore from backup
+- Load teammate's commands
+- Prompts before overwriting existing commands
+- Example: \`aliasmate import my-commands.json\`
+
+### aliasmate llm
+Generate this llm.txt file (default command).
+- Creates comprehensive documentation
+- Can be shared with AI assistants
+- Example: \`aliasmate run llm\`
+
+## Path Mode Feature
+
+Each saved command can have a path mode that determines where it executes:
+
+### Saved Directory Mode (default)
+- Command always runs in the directory where it was saved
+- Useful for project-specific commands
+- Example: Build scripts that must run in the project root
+
+### Current Directory Mode
+- Command runs in your current working directory
+- Useful for general-purpose utilities
+- Example: Git commands that work in any repository
+
+You can choose the path mode when saving or editing a command.
+
+## Configuration
+
+### Storage Location
+- Config file: \`~/.config/aliasmate/config.json\`
+- Contains all saved commands and their metadata
+- JSON format for easy editing if needed
+
+### Command Alias Structure
+Each command contains:
+- \`command\`: The shell command to execute
+- \`directory\`: The saved working directory path
+- \`pathMode\`: Either "saved" or "current"
+- \`createdAt\`: ISO 8601 timestamp
+- \`updatedAt\`: ISO 8601 timestamp
+
+## Use Cases
+
+### Development Workflows
+- Save complex build commands: \`aliasmate prev build-prod\`
+- Run test suites: \`aliasmate prev test-integration\`
+- Deploy applications: \`aliasmate prev deploy-staging\`
+
+### Multi-Project Management
+- Switch between projects easily
+- Run project-specific commands without navigating
+- Maintain consistent workflows across projects
+
+### Team Collaboration
+- Export team workflows: \`aliasmate export team-commands.json\`
+- Share best practices and scripts
+- Onboard new team members quickly
+
+### DevOps and Automation
+- Save deployment scripts with correct paths
+- Manage multiple environment configurations
+- Quick access to frequently used operations
+
+## Best Practices
+
+1. **Descriptive Names**: Use clear, memorable names for commands
+   - Good: \`deploy-prod\`, \`test-unit\`, \`start-server\`
+   - Avoid: \`cmd1\`, \`x\`, \`temp\`
+
+2. **Path Mode Selection**: Choose the right mode for each command
+   - Use "saved" for project-specific commands
+   - Use "current" for general utilities
+
+3. **Regular Backups**: Export commands periodically
+   - \`aliasmate export ~/backups/aliases-\$(date +%Y%m%d).json\`
+
+4. **Team Sharing**: Maintain a shared command repository
+   - Version control your command exports
+   - Document complex commands
+
+5. **Command Organization**: Use prefixes for grouping
+   - \`test-unit\`, \`test-integration\`, \`test-e2e\`
+   - \`deploy-dev\`, \`deploy-staging\`, \`deploy-prod\`
+
+## Integration with AI Assistants
+
+This llm.txt file is designed to help AI assistants understand AliasMate's full capabilities. When asking an AI for help with AliasMate:
+
+1. Share this file for complete context
+2. Mention specific commands you're working with
+3. Describe your workflow or use case
+4. Ask for command suggestions or optimizations
+
+## Troubleshooting
+
+### Command Not Found
+- Run \`aliasmate list\` to see available commands
+- Check spelling of command name
+- Verify command was saved successfully
+
+### Directory Not Found
+- Ensure the saved directory still exists
+- Use path override to run in different location
+- Edit command to update directory: \`aliasmate edit <name>\`
+
+### Command Execution Fails
+- Verify command syntax is correct
+- Check if required tools/dependencies are installed
+- Ensure directory permissions are correct
+
+## Technical Details
+
+- Written in TypeScript
+- Cross-platform (Linux, macOS, Windows)
+- Node.js 14.0.0 or higher required
+- Dependencies: chalk, commander, execa, inquirer
+
+## Getting Help
+
+- View all commands: \`aliasmate --help\`
+- View command help: \`aliasmate <command> --help\`
+- GitHub Issues: Report bugs or request features
+- Version info: \`aliasmate --version\`
+
+## Example Workflows
+
+### Frontend Development
+\`\`\`bash
+# Save development server
+npm run dev
+aliasmate prev dev
+
+# Save production build
+npm run build
+aliasmate prev build
+
+# Save test suite
+npm test
+aliasmate prev test
+
+# Run from anywhere
+aliasmate run dev
+aliasmate run build
+aliasmate run test
+\`\`\`
+
+### Backend API
+\`\`\`bash
+# Save API server
+npm start
+aliasmate prev api
+
+# Save database migrations
+npm run migrate
+aliasmate prev migrate
+
+# Save seed data
+npm run seed
+aliasmate prev seed
+\`\`\`
+
+### DevOps
+\`\`\`bash
+# Save deployment scripts
+./scripts/deploy.sh production
+aliasmate prev deploy-prod
+
+# Save log viewing
+tail -f /var/log/app.log
+aliasmate prev logs
+
+# Save health checks
+curl http://localhost:3000/health
+aliasmate prev health-check
+\`\`\`
+
+---
+
+Generated by AliasMate v${constants_1.APP_VERSION}
+For more information, visit: https://github.com/aliasmate/aliasmate
+`;
+}
+/**
+ * Create llm.txt file in the specified directory
+ * @param targetDir - The directory where llm.txt should be created
+ * @returns The full path to the created file
+ */
+function createLLMFile(targetDir) {
+    const content = generateLLMContent();
+    const filePath = path.join(targetDir, 'llm.txt');
+    fs.writeFileSync(filePath, content, 'utf8');
+    return filePath;
+}
+/**
+ * Get the default LLM command configuration
+ * This command will be auto-created during onboarding
+ */
+function getDefaultLLMCommand() {
+    return {
+        name: 'llm',
+        command: `cat > llm.txt << 'ALIASMATE_LLM_EOF'\n${generateLLMContent()}\nALIASMATE_LLM_EOF\necho "✓ Created llm.txt in $(pwd)"`,
+        directory: process.cwd(),
+        pathMode: 'current', // Run in current directory so users can create llm.txt anywhere
+    };
+}
+//# sourceMappingURL=llm-generator.js.map

package/dist/utils/llm-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-generator.js","sourceRoot":"","sources":["../../src/utils/llm-generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,gDA4QC;AAOD,sCAOC;AAMD,oDAOC;AA9SD,uCAAyB;AACzB,2CAA6B;AAC7B,2CAAoD;AAEpD;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO;;WAEE,uBAAW;iBACL,oBAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAqQC,uBAAW;;CAEpC,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,SAAiB;IAC7C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEjD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE5C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,yCAAyC,kBAAkB,EAAE,yDAAyD;QAC/H,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE;QACxB,QAAQ,EAAE,SAAS,EAAE,gEAAgE;KACtF,CAAC;AACJ,CAAC"}

package/dist/utils/onboarding.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Check if this is a first install or upgrade, and show appropriate onboarding
+ * @returns true if onboarding was shown, false otherwise
+ */
+export declare function checkAndShowOnboarding(): boolean;
+/**
+ * Check if user has completed onboarding
+ */
+export declare function hasCompletedOnboarding(): boolean;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/utils/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/utils/onboarding.ts"],"names":[],"mappings":"AA6IA;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAoChD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD"}