lua-cli 1.2.1 → 1.3.0-alpha.1

package/CHANGELOG.md

@@ -5,6 +5,51 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0-alpha.1] - 2024-12-19
+
+### Added
+- **Centralized CLI Utilities**: New `src/utils/cli.ts` module for consistent error handling and output management
+- **Command Restructuring**: Reorganized commands into logical groups:
+  - `lua auth` - Authentication management (configure, logout, key)
+  - `lua skill` - Skill development (init, compile, test, push, deploy)
+- **Enhanced Error Handling**: Graceful handling of Ctrl+C (SIGINT) across all commands
+- **Consistent Output Management**: Standardized progress messages, success messages, and prompt clearing
+- **Tool Name Validation**: Regex-based validation for tool names (alphanumeric, hyphens, underscores only)
+- **Version Management**: TOML-based version tracking with automatic versioning
+- **Skill Push/Deploy**: New commands for version management and production deployment
+- **Comprehensive Testing**: 100% test coverage for CLI utilities with 44 passing tests
+
+### Changed
+- **Command Structure**: 
+  - `lua configure` → `lua auth configure`
+  - `lua destroy` → `lua auth logout` 
+  - `lua apiKey` → `lua auth key`
+  - `lua init` → `lua skill init`
+  - `lua compile` → `lua skill compile`
+  - `lua test` → `lua skill test`
+  - Added `lua skill push` and `lua skill deploy`
+- **LuaSkill Constructor**: Now accepts object `{description, context}` instead of separate parameters
+- **TOML Configuration**: Added `version` and `skillId` fields to `lua.skill.toml`
+- **Error Messages**: Standardized format: `"❌ Error during [command]: [message]"`
+- **Output Consistency**: All commands now use centralized utilities for consistent UX
+
+### Technical Improvements
+- **Zero Code Duplication**: Centralized error handling eliminates repetitive code
+- **Professional UX**: Clean, consistent output with preserved command history
+- **Maintainable Architecture**: Single source of truth for CLI patterns
+- **Type Safety**: Enhanced TypeScript interfaces and validation
+- **Test Coverage**: Comprehensive test suite with 100% CLI utility coverage
+
+### Security
+- **Input Validation**: Tool name validation prevents injection attacks
+- **Graceful Cancellation**: Proper handling of user interruptions
+- **Error Isolation**: Centralized error handling prevents crashes
+
+### Documentation
+- **Updated README**: Reflects new command structure and features
+- **Developer Guide**: Enhanced documentation for LuaSkill constructor
+- **API Reference**: Updated examples and usage patterns
+
 ## [1.2.1] - 2024-09-19
 
 ### Fixed

package/README.md

@@ -33,13 +33,13 @@ lua --help
 
 1. **Configure your authentication:**
    ```bash
-   lua configure
+   lua auth configure
    ```
    Choose between API key or email authentication methods.
 
 2. **Initialize a new skill project:**
    ```bash
-   lua init
+   lua skill init
    ```
    Select your organization and agent, then provide skill details.
 
@@ -51,25 +51,27 @@ lua --help
 
 4. **Compile your skill:**
    ```bash
-   lua compile
+   lua skill compile
    ```
    Bundles dependencies and creates deployable files.
 
 5. **Test your tools:**
    ```bash
-   lua test
+   lua skill test
    ```
    Interactive testing interface for your tools.
 
 6. **Deploy your skill:**
    ```bash
-   lua deploy
+   lua skill deploy
    ```
    Deploy to the Lua platform.
 
 ## Commands
 
-### `lua configure`
+### Authentication Commands
+
+#### `lua auth configure`
 
 Set up your authentication credentials. You can choose between:
 
@@ -77,55 +79,49 @@ Set up your authentication credentials. You can choose between:
 - **Email**: Email-based OTP authentication
 
 ```bash
-lua configure
-```
-
-### `lua init`
-
-Initialize a new Lua skill project in the current directory.
-
-```bash
-lua init
+lua auth configure
 ```
 
-This command will:
-- Fetch your organizations and agents from the API
-- Let you select an organization by name
-- Let you choose an agent from the selected organization
-- Prompt for skill name and description
-- Create a `lua.skill.toml` configuration file
-- Copy template files to the current directory
-
-### `lua apiKey`
+#### `lua auth key`
 
 Display your stored API key (with confirmation prompt).
 
 ```bash
-lua apiKey
+lua auth key
 ```
 
-### `lua agents`
+#### `lua auth logout`
 
-Fetch and display your agents from the HeyLua API.
+Delete your stored API key and credentials.
 
 ```bash
-lua agents
+lua auth logout
 ```
 
-### `lua destroy`
+### Skill Management Commands
 
-Delete your stored API key and credentials.
+#### `lua skill init`
+
+Initialize a new Lua skill project in the current directory.
 
 ```bash
-lua destroy
+lua skill init
 ```
 
-### `lua compile`
+This command will:
+- Fetch your organizations and agents from the API
+- Let you select an organization by name
+- Let you choose an agent from the selected organization
+- Prompt for skill name and description
+- Create a `lua.skill.toml` configuration file
+- Copy template files to the current directory
+
+#### `lua skill compile`
 
 Compile your LuaSkill and bundle all dependencies.
 
 ```bash
-lua compile
+lua skill compile
 ```
 
 This command will:
@@ -139,12 +135,12 @@ This command will:
 - `--watch` - Watch for changes and recompile automatically
 - `--minify` - Minify the bundled code
 
-### `lua test`
+#### `lua skill test`
 
 Interactive testing interface for your tools.
 
 ```bash
-lua test
+lua skill test
 ```
 
 Features:
@@ -154,23 +150,39 @@ Features:
 - Error reporting and debugging
 - Mock data support
 
-### `lua deploy`
+#### `lua skill push`
+
+Push your compiled skill version to the server.
+
+```bash
+lua skill push
+```
+
+This command will:
+- Compile your skill first
+- Confirm the version you want to push
+- Send the compiled skill data to the server
+- Store the skill ID in your TOML file
 
-Deploy your compiled skill to the Lua platform.
+#### `lua skill deploy`
+
+Deploy a version to production.
 
 ```bash
-lua deploy
+lua skill deploy
 ```
 
+This command will:
+- Fetch available versions from the server
+- Let you select which version to deploy
+- Show a warning about deploying to all users
+- Publish the selected version to production
+
 **Requirements:**
-- Valid API key (configured with `lua configure`)
-- Compiled skill (run `lua compile` first)
+- Valid API key (configured with `lua auth configure`)
+- Compiled skill (run `lua skill compile` first)
 - Active internet connection
 
-**Output:**
-- Skill deployed to your selected agent
-- Deployment confirmation and status
-
 ## Template System
 
 The Lua CLI includes a comprehensive template system with examples and documentation:
@@ -225,7 +237,7 @@ template/
 
 ## Configuration File
 
-The `lua.skill.toml` file is created when you run `lua init`:
+The `lua.skill.toml` file is created when you run `lua skill init`:
 
 ```toml
 [agent]
@@ -234,21 +246,22 @@ orgId = "your-organization-id"
 
 [skill]
 name = "Your Skill Name"
-description = "Description of your skill"
+version = "0.0.1"
+skillId = "your-skill-id"
 ```
 
 ## Authentication Methods
 
 ### API Key Authentication
 
-1. Run `lua configure`
+1. Run `lua auth configure`
 2. Select "API Key"
 3. Enter your API key when prompted
 4. The key is validated and stored securely
 
 ### Email Authentication
 
-1. Run `lua configure`
+1. Run `lua auth configure`
 2. Select "Email"
 3. Enter your email address
 4. Check your email for the OTP code
@@ -267,7 +280,7 @@ description = "Description of your skill"
 ### 1. Project Setup
 ```bash
 # Initialize a new skill project
-lua init
+lua skill init
 
 # Or copy the template
 cp -r template/ my-skill/
@@ -285,26 +298,32 @@ npm install
 ### 3. Testing
 ```bash
 # Compile your skill
-lua compile
+lua skill compile
 
 # Test your tools interactively
-lua test
+lua skill test
 ```
 
 ### 4. Deployment
 ```bash
-# Deploy to Lua platform
-lua deploy
+# Push version to server
+lua skill push
+
+# Deploy to production
+lua skill deploy
 ```
 
 ### 5. Iteration
 ```bash
 # Make changes to your tools
 # Recompile and test
-lua compile && lua test
+lua skill compile && lua skill test
+
+# Push updates
+lua skill push
 
 # Deploy updates
-lua deploy
+lua skill deploy
 ```
 
 ## Requirements
@@ -333,10 +352,18 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 For support and questions:
 - Create an issue on [GitHub](https://github.com/lua-ai-global/lua-cli/issues)
-- Contact: stefan@heylua.ai
+- Contact: stefan@lua.dev
 
 ## Changelog
 
+### 1.3.0
+- **Command Restructure**: Reorganized commands under `lua auth` and `lua skill` groups
+- **New Push Command**: Added `lua skill push` to push versions to server
+- **New Deploy Command**: Added `lua skill deploy` to deploy versions to production
+- **Version Management**: Added version field to TOML configuration
+- **Improved UX**: Better command organization and intuitive naming
+- **Enhanced Workflow**: Complete skill lifecycle from init to production deployment
+
 ### 1.2.0
 - **Tool Development Framework**: Complete LuaSkill and LuaTool framework
 - **Dependency Bundling**: Automatic bundling of npm packages using esbuild

package/dist/commands/agents.js

@@ -1,20 +1,24 @@
 import fetch from "node-fetch";
 import { loadApiKey } from "../services/auth.js";
+import { withErrorHandling, writeSuccess } from "../utils/cli.js";
 export async function agentsCommand() {
-    const apiKey = await loadApiKey();
-    if (!apiKey) {
-        console.error("❌ No API key found. Run `lua configure` first.");
-        process.exit(1);
-    }
-    const response = await fetch("https://api.heylua.ai/admin", {
-        headers: {
-            Authorization: `Bearer ${apiKey}`,
-        },
-    });
-    if (!response.ok) {
-        console.error(`❌ Error ${response.status}: ${await response.text()}`);
-        process.exit(1);
-    }
-    const data = await response.json();
-    console.log("✅ Agents:", JSON.stringify(data, null, 2));
+    return withErrorHandling(async () => {
+        const apiKey = await loadApiKey();
+        if (!apiKey) {
+            console.error("❌ No API key found. Run `lua configure` first.");
+            process.exit(1);
+        }
+        const response = await fetch("https://api.lua.dev/admin", {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            console.error(`❌ Error ${response.status}: ${await response.text()}`);
+            process.exit(1);
+        }
+        const data = await response.json();
+        writeSuccess("✅ Agents retrieved successfully:");
+        console.log(JSON.stringify(data, null, 2));
+    }, "agents listing");
 }

package/dist/commands/apiKey.js

@@ -1,24 +1,29 @@
 import inquirer from "inquirer";
 import { loadApiKey } from "../services/auth.js";
+import { withErrorHandling, clearPromptLines, writeProgress, writeSuccess } from "../utils/cli.js";
 export async function apiKeyCommand() {
-    const apiKey = await loadApiKey();
-    if (!apiKey) {
-        console.log("ℹ️  No API key found. Run `lua configure` first.");
-        return;
-    }
-    const { confirm } = await inquirer.prompt([
-        {
-            type: "confirm",
-            name: "confirm",
-            message: "This will display your API key. Are you sure you want to continue?",
-            default: false
+    return withErrorHandling(async () => {
+        const apiKey = await loadApiKey();
+        if (!apiKey) {
+            writeProgress("ℹ️  No API key found. Run `lua configure` first.");
+            return;
         }
-    ]);
-    if (confirm) {
-        console.log("🔑 Your API key:");
-        console.log(apiKey);
-    }
-    else {
-        console.log("ℹ️  API key display cancelled.");
-    }
+        const { confirm } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "confirm",
+                message: "This will display your API key. Are you sure you want to continue?",
+                default: false
+            }
+        ]);
+        // Clear the confirmation prompt lines
+        clearPromptLines(2);
+        if (confirm) {
+            writeSuccess("🔑 Your API key:");
+            console.log(apiKey);
+        }
+        else {
+            writeProgress("ℹ️  API key display cancelled.");
+        }
+    }, "key display");
 }

package/dist/commands/compile.d.ts

@@ -0,0 +1 @@
+export declare function compileCommand(): Promise<void>;