@magicappdev/cli 0.0.3 → 0.0.5

package/README.md

@@ -0,0 +1,207 @@
+# MagicAppDev CLI
+
+![npm version](https://img.shields.io/npm/v/@magicappdev/cli)
+![npm downloads](https://img.shields.io/npm/dm/@magicappdev/cli)
+![license](https://img.shields.io/npm/l/@magicappdev/cli)
+
+A powerful CLI tool for creating and managing MagicAppDev applications. The MagicAppDev CLI simplifies the process of generating, customizing, and deploying fullstack apps across web and mobile platforms.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [Commands](#commands)
+- [Configuration](#configuration)
+- [Features](#features)
+- [Development](#development)
+- [License](#license)
+- [Contributing](#contributing)
+- [Troubleshooting](#troubleshooting)
+
+## Installation
+
+You can install the MagicAppDev CLI using npm, yarn, or pnpm:
+
+```bash
+# Using npm
+npm install -g @magicappdev/cli
+
+# Using yarn
+yarn global add @magicappdev/cli
+
+# Using pnpm
+pnpm add -g @magicappdev/cli
+```
+
+For more details, visit the [npm page](https://www.npmjs.com/package/@magicappdev/cli).
+
+## Usage
+
+The CLI provides several commands to manage your MagicAppDev projects:
+
+```bash
+# Initialize a new MagicAppDev project
+magicappdev init
+
+# Authenticate with MagicAppDev
+magicappdev auth
+
+# Start an interactive chat session
+magicappdev chat
+
+# Generate components or apps
+magicappdev generate <type> <name>
+
+# Run diagnostics on your project
+magicappdev doctor
+```
+
+## Commands
+
+### `init`
+
+Initialize a new MagicAppDev project in the current directory.
+
+```bash
+magicappdev init
+```
+
+### `auth`
+
+Authenticate with MagicAppDev services.
+
+```bash
+magicappdev auth
+```
+
+### `chat`
+
+Start an interactive chat session for app creation and management.
+
+```bash
+magicappdev chat
+```
+
+### `generate`
+
+Generate components, apps, or other resources.
+
+```bash
+# Generate a new component
+magicappdev generate component my-component
+
+# Generate a new app
+magicappdev generate app my-app
+```
+
+### `doctor`
+
+Run diagnostics to check your project setup and configuration.
+
+```bash
+magicappdev doctor
+```
+
+## Configuration
+
+### Environment Variables
+
+You can configure the CLI using environment variables in a `.env` file:
+
+```env
+MAGICAPPDEV_API_KEY=your_api_key_here
+MAGICAPPDEV_PROJECT_DIR=./my-project
+```
+
+### Config File
+
+The CLI can also be configured using a `magicappdev.config.json` file:
+
+```json
+{
+  "apiKey": "your_api_key_here",
+  "projectDir": "./my-project",
+  "defaultTemplate": "web"
+}
+```
+
+## Features
+
+- **Project Initialization**: Quickly set up new MagicAppDev projects.
+- **Authentication**: Securely authenticate with MagicAppDev services.
+- **Interactive Chat**: Use AI-powered chat for app creation and management.
+- **Code Generation**: Generate components, apps, and other resources.
+- **Diagnostics**: Run diagnostics to ensure your project is set up correctly.
+
+## Development
+
+### Prerequisites
+
+- Node.js (v18 or higher)
+- pnpm (v8 or higher)
+
+### Setup
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/magicappdev/magicappdev.git
+   cd magicappdev
+   ```
+
+2. Install dependencies:
+
+   ```bash
+   pnpm install
+   ```
+
+3. Build the CLI:
+
+   ```bash
+   cd packages/cli
+   pnpm run build
+   ```
+
+4. Link the CLI for local development:
+
+   ```bash
+   pnpm link --global
+   ```
+
+### Running Tests
+
+To run tests for the CLI:
+
+```bash
+pnpm run test
+```
+
+## License
+
+MagicAppDev CLI is licensed under the [MIT License](LICENSE).
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for more details.
+
+## Troubleshooting
+
+### Common Issues
+
+- **Command Not Found**: Ensure the CLI is installed globally and your PATH is set correctly.
+- **Authentication Errors**: Verify your API key and environment variables.
+- **Build Errors**: Check your Node.js and pnpm versions and ensure all dependencies are installed.
+
+### FAQ
+
+**Q: How do I update the CLI?**
+
+A: Run `pnpm update -g @magicappdev/cli` to update to the latest version.
+
+**Q: Can I use the CLI with npm or yarn?**
+
+A: Yes, you can install the CLI using npm or yarn, but pnpm is recommended for optimal performance.
+
+**Q: How do I report a bug?**
+
+A: Please open an issue on our [GitHub repository](https://github.com/magicappdev/magicappdev/issues).

package/dist/cli.d.ts

@@ -2,6 +2,7 @@
  * MagicAppDev CLI
  */
 import { Command } from "commander";
+/** TEST - Test if build picks up changes */
 /** Create the CLI program */
 export declare function createProgram(): Command;
 /** Run the CLI */

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,6BAA6B;AAC7B,wBAAgB,aAAa,IAAI,OAAO,CAgBvC;AAED,kBAAkB;AAClB,wBAAsB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,4CAA4C;AAE5C,6BAA6B;AAC7B,wBAAgB,aAAa,IAAI,OAAO,CAiBvC;AAED,kBAAkB;AAClB,wBAAsB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxD"}

package/dist/cli.js

@@ -2,6 +2,7 @@
  * MagicAppDev CLI
  */
 import { generateCommand } from "./commands/generate/index.js";
+import { completionsCommand } from "./commands/completions.js";
 import { doctorCommand } from "./commands/doctor.js";
 import { initCommand } from "./commands/init.js";
 import { chatCommand } from "./commands/chat.js";
@@ -12,6 +13,7 @@ const require = createRequire(import.meta.url);
 const pkg = require("../package.json");
 /** Package version */
 const VERSION = pkg.version;
+/** TEST - Test if build picks up changes */
 /** Create the CLI program */
 export function createProgram() {
     const program = new Command();
@@ -25,6 +27,7 @@ export function createProgram() {
     program.addCommand(chatCommand);
     program.addCommand(generateCommand);
     program.addCommand(doctorCommand);
+    program.addCommand(completionsCommand);
     return program;
 }
 /** Run the CLI */

package/dist/commands/completions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Completions command - Generate shell completion scripts
+ */
+import { Command } from "commander";
+export declare const completionsCommand: Command;
+//# sourceMappingURL=completions.d.ts.map

package/dist/commands/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../src/commands/completions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,kBAAkB,SAkC3B,CAAC"}

package/dist/commands/completions.js

@@ -0,0 +1,183 @@
+/**
+ * Completions command - Generate shell completion scripts
+ */
+import { success, error, info, newline } from "../lib/ui.js";
+import * as fs from "node:fs/promises";
+import { Command } from "commander";
+import * as path from "node:path";
+export const completionsCommand = new Command("completions")
+    .description("Generate shell completion script")
+    .argument("<shell>", "Shell type (bash, zsh, fish, pwsh)")
+    .option("-p, --print", "Print completion script to stdout", false)
+    .option("-i, --install", "Attempt to install completion script", false)
+    .action(async (shell, options) => {
+    try {
+        const program = completionsCommand.parent;
+        if (!program) {
+            throw new Error("Unable to get program configuration");
+        }
+        const script = generateCompletionScript(shell, program);
+        const shouldPrint = options.print || (!options.install && !options.print);
+        if (shouldPrint) {
+            console.log(script);
+            if (!options.print) {
+                newline();
+                info("To install completions, add the above to your shell config:");
+                printInstallInstructions(shell);
+                newline();
+            }
+        }
+        else if (options.install) {
+            await installCompletionScript(shell, script);
+        }
+        if (!shouldPrint || options.print) {
+            success(`Completion script generated for ${shell}`);
+        }
+    }
+    catch (err) {
+        error(`Failed to generate completions: ${err.message}`);
+        process.exit(1);
+    }
+});
+function generateCompletionScript(shell, program) {
+    switch (shell.toLowerCase()) {
+        case "bash":
+            return generateBashCompletion(program);
+        case "zsh":
+            return generateZshCompletion(program);
+        case "fish":
+            return generateFishCompletion(program);
+        case "pwsh":
+            return generatePwshCompletion(program);
+        default:
+            throw new Error(`Unsupported shell: ${shell}. Supported: bash, zsh, fish, pwsh`);
+    }
+}
+function generateBashCompletion(program) {
+    const commands = program.commands.map(cmd => cmd.name()).join(" ");
+    return `# Bash completion for magicappdev
+_magicappdev_completion() {
+    local cur prev words cword
+    _init_completion || return
+
+    COMPREPLY=($(compgen -W "${commands} --help --version" -- "\${cur}"))
+}
+
+complete -F _magicappdev_completion magicappdev mad createmagicapp
+`;
+}
+function generateZshCompletion(program) {
+    const commandDescriptions = program.commands
+        .map(cmd => `"${cmd.name()}":"${cmd.description()}"`)
+        .join("\n  ");
+    return `#compdef magicappdev mad createmagicapp
+
+_magicappdev() {
+  local -a commands
+  commands=(
+    ${commandDescriptions}
+  )
+
+  if (( CURRENT == 2 )); then
+    _describe 'command' commands
+  fi
+}
+
+_magicappdev "$@"
+`;
+}
+function generateFishCompletion(program) {
+    const commands = program.commands.map(cmd => cmd.name()).join(" ");
+    return `# Fish completion for magicappdev
+
+complete -c magicappdev -f
+complete -c mad -f
+complete -c createmagicapp -f
+
+complete -c magicappdev -a '${commands}' -d 'MagicAppDev command'
+complete -c mad -a '${commands}' -d 'MagicAppDev command'
+complete -c createmagicapp -a '${commands}' -d 'MagicAppDev command'
+`;
+}
+function generatePwshCompletion(program) {
+    const commands = program.commands.map(cmd => cmd.name());
+    return `# PowerShell completion for magicappdev
+
+using namespace System.Management.Automation
+using namespace System.Management.Automation.Language
+
+Register-ArgumentCompleter -Native -CommandName 'magicappdev', 'mad', 'createmagicapp' -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+
+    $commands = @(${commands.map(c => `'${c}'`).join(", ")})
+
+    $commandElements = $commandAst.CommandElements
+    $command = if ($commandElements.Count -gt 1) { $commandElements[1].Extent.Text } else { '' }
+
+    if ($wordToComplete -like '-*') {
+        @('--help', '--version') | Where-Object { $_ -like "$wordToComplete*" }
+    } else {
+        $commands | Where-Object { $_ -like "$wordToComplete*" }
+    }
+}
+`;
+}
+async function installCompletionScript(shell, script) {
+    const home = process.env.HOME || process.env.USERPROFILE;
+    if (!home) {
+        throw new Error("Unable to determine home directory");
+    }
+    let configPath;
+    switch (shell.toLowerCase()) {
+        case "bash":
+            configPath = path.join(home, ".bashrc");
+            break;
+        case "zsh":
+            configPath = path.join(home, ".zshrc");
+            break;
+        case "fish":
+            configPath = path.join(home, ".config", "fish", "completions", "magicappdev.fish");
+            break;
+        case "pwsh":
+            configPath = path.join(home, ".config", "powershell", "MagicAppDev_completions.ps1");
+            break;
+        default:
+            throw new Error(`Unable to determine config file for shell: ${shell}`);
+    }
+    // For fish, create the completion file directly
+    if (shell.toLowerCase() === "fish") {
+        await fs.mkdir(path.dirname(configPath), { recursive: true });
+        await fs.writeFile(configPath, script);
+        success(`Completion script installed to ${configPath}`);
+        info("Restart your shell for completions to take effect");
+        return;
+    }
+    // For other shells, append to config
+    try {
+        await fs.appendFile(configPath, `\n\n# MagicAppDev CLI completions\n${script}\n`);
+        success(`Completion script added to ${configPath}`);
+        info("Restart your shell for completions to take effect");
+    }
+    catch (err) {
+        error(`Failed to install: ${err.message}`);
+        info("You can manually add the script to your shell config");
+    }
+}
+function printInstallInstructions(shell) {
+    switch (shell.toLowerCase()) {
+        case "bash":
+            info('  echo "$(magicappdev completions bash)" >> ~/.bashrc');
+            info("  source ~/.bashrc");
+            break;
+        case "zsh":
+            info('  echo "$(magicappdev completions zsh)" >> ~/.zshrc');
+            info("  source ~/.zshrc");
+            break;
+        case "fish":
+            info("  magicappdev completions fish > ~/.config/fish/completions/magicappdev.fish");
+            break;
+        case "pwsh":
+            info("  magicappdev completions pwsh > $PROFILE");
+            break;
+    }
+}

package/dist/lib/api.d.ts

@@ -1,4 +1,4 @@
-import { ApiClient } from "@magicappdev/shared/api";
+import { ApiClient } from "@magicappdev/shared";
 export declare const AGENT_HOST: string;
 export declare const api: ApiClient;
 export type { User, Project } from "@magicappdev/shared";

package/dist/lib/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAUpD,eAAO,MAAM,UAAU,QAGsB,CAAC;AAE9C,eAAO,MAAM,GAAG,WAAyB,CAAC;AAM1C,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAUhD,eAAO,MAAM,UAAU,QAGsB,CAAC;AAE9C,eAAO,MAAM,GAAG,WAAyB,CAAC;AAM1C,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/api.js

@@ -1,4 +1,4 @@
-import { ApiClient } from "@magicappdev/shared/api";
+import { ApiClient } from "@magicappdev/shared";
 import { loadConfig } from "./config.js";
 const config = await loadConfig();
 const API_URL = process.env.MAGICAPPDEV_API_URL ||

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@magicappdev/cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "CLI tool for creating and managing MagicAppDev apps",
+  "keywords": [
+    "cli",
+    "MagicAppDev",
+    "app-dev",
+    "mobile",
+    "react-native"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,22 +33,22 @@
     "@magicappdev/templates": "workspace:*",
     "agents": "^0.3.6",
     "chalk": "^5.4.0",
-    "commander": "^13.0.0",
+    "commander": "^14.0.2",
     "execa": "^9.5.0",
     "open": "^11.0.0",
-    "ora": "^8.1.0",
+    "ora": "^9.1.0",
     "prompts": "^2.4.0",
     "tslib": "^2.3.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {
-    "@types/node": "^25.0.0",
+    "@types/node": "^25.0.10",
     "@types/prompts": "^2.4.0",
     "@types/ws": "^8.5.10",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "tsx": "^4.19.0",
-    "typescript": "~5.8.2",
+    "typescript": "~5.9.3",
     "typescript-eslint": "^8.53.1"
   }
 }