@stackweld/cli 0.2.2 → 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Orlando Fernandez / XPlus Technologies LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -2,9 +2,9 @@
 /**
  * Stackweld CLI — The operating system for your dev stacks.
  */
+import { input, select, Separator } from "@inquirer/prompts";
 import chalk from "chalk";
 import { Command } from "commander";
-import { select, input } from "@inquirer/prompts";
 import { aiCommand } from "./commands/ai.js";
 import { analyzeCommand } from "./commands/analyze.js";
 import { benchmarkCommand } from "./commands/benchmark.js";
@@ -41,8 +41,7 @@ import { statusCommand } from "./commands/status.js";
 import { templateCommand } from "./commands/template.js";
 import { upCommand } from "./commands/up.js";
 import { versionCommand } from "./commands/version-cmd.js";
-import { banner } from "./ui/format.js";
-const VERSION = "0.2.1";
+const VERSION = "0.2.3";
 const program = new Command();
 program
     .name("stackweld")
@@ -85,228 +84,463 @@ program
     .addCommand(costCommand)
     .addCommand(pluginCommand)
     .addCommand(versionCommand);
-// ── Interactive Menu ───────────────────────────────────────────────
+// ─── Helpers ──────────────────────────────────────────────
+function isExitSignal(err) {
+    if (!err || typeof err !== "object")
+        return false;
+    const e = err;
+    return (e.name === "ExitPromptError" ||
+        e.code === "ERR_USE_AFTER_CLOSE");
+}
+async function pressEnterToContinue() {
+    await input({ message: chalk.dim("Press Enter to continue...") });
+}
+async function run(args) {
+    try {
+        await program.parseAsync(["node", "stackweld", ...args]);
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "commander.helpDisplayed" || code === "commander.version")
+            return;
+        if (code === "commander.missingMandatoryOptionValue" || code === "commander.missingArgument") {
+            return;
+        }
+        throw err;
+    }
+}
+// ─── ASCII Art Logo ──────────────────────────────────────
+function printLogo() {
+    const g = chalk.hex("#FFD700"); // gold
+    const c = chalk.hex("#00E3FD"); // cyan
+    const m = chalk.hex("#FF51FA"); // magenta
+    const p = chalk.hex("#7C5CFC"); // purple/brand
+    const logo = [
+        "",
+        `  ${g("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")} ${g("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")} ${g("\u2588\u2588\u2588\u2588\u2588\u2557")}  ${c("\u2588\u2588\u2588\u2588\u2588\u2588\u2557")} ${c("\u2588\u2588\u2557  \u2588\u2588\u2557")} ${c("\u2588\u2588\u2557")}    ${m("\u2588\u2588\u2557")} ${m("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")} ${m("\u2588\u2588\u2557")}     ${m("\u2588\u2588\u2588\u2588\u2588\u2588\u2557 ")}`,
+        `  ${g("\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D")} ${g("\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D")} ${g("\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557")} ${c("\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D")} ${c("\u2588\u2588\u2551 \u2588\u2588\u2554\u255D")} ${c("\u2588\u2588\u2551")}    ${m("\u2588\u2588\u2551")} ${m("\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D")} ${m("\u2588\u2588\u2551")}     ${m("\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557")}`,
+        `  ${g("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}    ${g("\u2588\u2588\u2551")}   ${g("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551")} ${c("\u2588\u2588\u2551")}      ${c("\u2588\u2588\u2588\u2588\u2588\u2554\u255D")}  ${c("\u2588\u2588\u2551")} ${c("\u2588\u2588\u2557")} ${m("\u2588\u2588\u2551")} ${m("\u2588\u2588\u2588\u2588\u2588\u2557")}   ${m("\u2588\u2588\u2551")}     ${m("\u2588\u2588\u2551  \u2588\u2588\u2551")}`,
+        `  ${g("\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551")}    ${g("\u2588\u2588\u2551")}   ${g("\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551")} ${c("\u2588\u2588\u2551")}      ${c("\u2588\u2588\u2554\u2550\u2588\u2588\u2557")}  ${c("\u2588\u2588\u2551")} ${c("\u2588\u2588\u2588\u2557")}${m("\u2588\u2588\u2551")} ${m("\u2588\u2588\u2554\u2550\u2550\u255D")}   ${m("\u2588\u2588\u2551")}     ${m("\u2588\u2588\u2551  \u2588\u2588\u2551")}`,
+        `  ${g("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551")}    ${g("\u2588\u2588\u2551")}   ${g("\u2588\u2588\u2551  \u2588\u2588\u2551")} ${c("\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557")} ${c("\u2588\u2588\u2551  \u2588\u2588\u2557")} ${c("\u255A\u2588\u2588\u2588\u2554\u2588\u2588\u2588\u2554\u255D")} ${m("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")} ${m("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")} ${m("\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D")}`,
+        `  ${g("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D")}    ${g("\u255A\u2550\u255D")}   ${g("\u255A\u2550\u255D  \u255A\u2550\u255D")}  ${c("\u255A\u2550\u2550\u2550\u2550\u2550\u255D")} ${c("\u255A\u2550\u255D  \u255A\u2550\u255D")}  ${c("\u255A\u2550\u2550\u255D\u255A\u2550\u2550\u255D")}  ${m("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D")} ${m("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D")} ${m("\u255A\u2550\u2550\u2550\u2550\u2550\u255D")} `,
+        "",
+        `  ${p.bold("The Developer's Forge")}  ${chalk.dim(`v${VERSION}`)}`,
+        `  ${chalk.dim("github.com/mundowise/Stackweld")}`,
+        "",
+    ];
+    for (const line of logo) {
+        console.log(line);
+    }
+}
+// ─── Command List ────────────────────────────────────────
+function printCommandList() {
+    const b = chalk.hex("#7C5CFC").bold;
+    const d = chalk.dim;
+    const w = chalk.white;
+    const categories = [
+        {
+            name: "Project Setup",
+            commands: [
+                ["init", "Create a new project interactively"],
+                ["create", "Create a stack definition from options"],
+                ["generate", "Generate docker-compose & configs"],
+                ["scaffold", "Scaffold project files from a stack"],
+                ["template", "Manage & apply stack templates"],
+            ],
+        },
+        {
+            name: "Stack Management",
+            commands: [
+                ["list", "List all saved stacks"],
+                ["info", "Show stack or technology details"],
+                ["save", "Save current stack definition"],
+                ["delete", "Delete a saved stack"],
+                ["clone", "Clone an existing stack"],
+                ["export", "Export stack to a file"],
+                ["import", "Import stack from a file"],
+                ["share", "Share stack via URL"],
+                ["import-url", "Import stack from a shared URL"],
+                ["compare", "Compare two stacks side-by-side"],
+            ],
+        },
+        {
+            name: "Runtime & Services",
+            commands: [
+                ["up", "Start stack services (docker-compose up)"],
+                ["down", "Stop stack services"],
+                ["status", "Show running service status"],
+                ["logs", "View service logs"],
+                ["health", "Run health checks on services"],
+                ["env", "Manage environment variables"],
+            ],
+        },
+        {
+            name: "Analysis & Intelligence",
+            commands: [
+                ["browse", "Browse available technologies"],
+                ["analyze", "Analyze an existing project"],
+                ["score", "Score compatibility between technologies"],
+                ["learn", "Learn about a technology in depth"],
+                ["migrate", "Get migration guide between technologies"],
+                ["cost", "Estimate hosting costs for a stack"],
+                ["benchmark", "Profile performance characteristics"],
+                ["doctor", "Check system prerequisites"],
+                ["ai", "AI-powered stack recommendations"],
+            ],
+        },
+        {
+            name: "Tools & Settings",
+            commands: [
+                ["config", "View/set configuration preferences"],
+                ["completion", "Generate shell completions"],
+                ["deploy", "Generate deploy infrastructure"],
+                ["lint", "Lint stack against best practices"],
+                ["preview", "Preview stack in browser"],
+                ["plugin", "Manage CLI plugins"],
+                ["version", "Show detailed version info"],
+            ],
+        },
+    ];
+    console.log(`\n  ${b("Available Commands")}\n`);
+    for (const cat of categories) {
+        console.log(`  ${chalk.yellow.bold(cat.name)}`);
+        for (const [cmd, desc] of cat.commands) {
+            console.log(`    ${w(`stackweld ${cmd}`)}  ${d(desc)}`);
+        }
+        console.log("");
+    }
+    console.log(`  ${d("Run")} ${w("stackweld <command> --help")} ${d("for detailed usage.")}\n`);
+}
+// ─── Submenus ─────────────────────────────────────────────
+async function stacksSubmenu() {
+    const action = await select({
+        message: "Manage saved stacks",
+        loop: false,
+        pageSize: 15,
+        choices: [
+            { name: "\uD83D\uDCCB List all stacks", value: "list" },
+            { name: "\uD83D\uDD0D Stack/tech info", value: "info" },
+            { name: "\uD83D\uDDD1\uFE0F  Delete a stack", value: "delete" },
+            { name: "\uD83D\uDCC2 Clone a stack", value: "clone" },
+            { name: "\uD83D\uDCE4 Export a stack", value: "export" },
+            { name: "\uD83D\uDCE5 Import a stack", value: "import" },
+            { name: "\uD83D\uDD17 Share a stack (URL)", value: "share" },
+            { name: "\uD83D\uDD17 Import from URL", value: "import-url" },
+            { name: "\uD83D\uDD0D Compare two stacks", value: "compare" },
+            new Separator(),
+            { name: "\u2B05\uFE0F  Back to main menu", value: "back" },
+        ],
+    });
+    if (action === "back")
+        return;
+    switch (action) {
+        case "list":
+            await run(["list"]);
+            break;
+        case "info": {
+            const id = await input({ message: "Stack or technology ID:" });
+            if (id.trim())
+                await run(["info", id.trim()]);
+            break;
+        }
+        case "delete": {
+            const id = await input({ message: "Stack ID to delete:" });
+            if (id.trim())
+                await run(["delete", id.trim()]);
+            break;
+        }
+        case "clone": {
+            const id = await input({ message: "Stack ID to clone:" });
+            if (id.trim())
+                await run(["clone", id.trim()]);
+            break;
+        }
+        case "export": {
+            const id = await input({ message: "Stack ID to export:" });
+            if (id.trim())
+                await run(["export", id.trim()]);
+            break;
+        }
+        case "import": {
+            const file = await input({ message: "File path to import:" });
+            if (file.trim())
+                await run(["import", file.trim()]);
+            break;
+        }
+        case "share": {
+            const id = await input({ message: "Stack ID to share:" });
+            if (id.trim())
+                await run(["share", id.trim()]);
+            break;
+        }
+        case "import-url": {
+            const url = await input({ message: "Share URL to import:" });
+            if (url.trim())
+                await run(["import-url", url.trim()]);
+            break;
+        }
+        case "compare": {
+            const a = await input({ message: "First stack ID:" });
+            const b = await input({ message: "Second stack ID:" });
+            if (a.trim() && b.trim())
+                await run(["compare", a.trim(), b.trim()]);
+            break;
+        }
+    }
+}
+async function runtimeSubmenu() {
+    const action = await select({
+        message: "Runtime & services",
+        loop: false,
+        pageSize: 10,
+        choices: [
+            { name: "\u25B6\uFE0F  Start services (up)", value: "up" },
+            { name: "\u23F9\uFE0F  Stop services (down)", value: "down" },
+            { name: "\uD83D\uDFE2 Service status", value: "status" },
+            { name: "\uD83D\uDCDC View logs", value: "logs" },
+            { name: "\uD83C\uDFE5 Health checks", value: "health" },
+            { name: "\uD83D\uDD10 Environment variables", value: "env" },
+            new Separator(),
+            { name: "\u2B05\uFE0F  Back to main menu", value: "back" },
+        ],
+    });
+    if (action === "back")
+        return;
+    switch (action) {
+        case "up":
+            await run(["up"]);
+            break;
+        case "down":
+            await run(["down"]);
+            break;
+        case "status":
+            await run(["status"]);
+            break;
+        case "logs":
+            await run(["logs"]);
+            break;
+        case "health":
+            await run(["health"]);
+            break;
+        case "env":
+            await run(["env"]);
+            break;
+    }
+}
+async function settingsSubmenu() {
+    const action = await select({
+        message: "Settings & tools",
+        loop: false,
+        pageSize: 10,
+        choices: [
+            { name: "\u2699\uFE0F  Configuration preferences", value: "config" },
+            { name: "\uD83D\uDCDD Shell completions (bash/zsh/fish)", value: "completion" },
+            { name: "\uD83D\uDD0C Manage plugins", value: "plugins" },
+            { name: "\uD83D\uDE80 Generate deploy infrastructure", value: "deploy" },
+            { name: "\uD83D\uDCCF Lint stack against standards", value: "lint" },
+            { name: "\uD83D\uDD0D Preview stack in browser", value: "preview" },
+            new Separator(),
+            { name: "\u2B05\uFE0F  Back to main menu", value: "back" },
+        ],
+    });
+    if (action === "back")
+        return;
+    switch (action) {
+        case "config":
+            await run(["config", "list"]);
+            break;
+        case "completion": {
+            const shell = await select({
+                message: "Shell type:",
+                loop: false,
+                choices: [
+                    { name: "bash", value: "bash" },
+                    { name: "zsh", value: "zsh" },
+                    { name: "fish", value: "fish" },
+                ],
+            });
+            await run(["completion", shell]);
+            break;
+        }
+        case "plugins":
+            await run(["plugin", "list"]);
+            break;
+        case "deploy": {
+            const id = await input({ message: "Stack ID to deploy:" });
+            if (id.trim())
+                await run(["deploy", id.trim()]);
+            break;
+        }
+        case "lint":
+            await run(["lint"]);
+            break;
+        case "preview":
+            await run(["preview"]);
+            break;
+    }
+}
+// ─── Interactive Menu ─────────────────────────────────────
 async function interactiveMenu() {
+    program.exitOverride();
     console.clear();
-    console.log(banner(VERSION));
+    printLogo();
     while (true) {
+        let choice;
         try {
-            const action = await select({
-                message: chalk.bold("What would you like to do?"),
+            choice = await select({
+                message: "What would you like to do?",
+                loop: false,
+                pageSize: 20,
                 choices: [
-                    { name: `${chalk.green("🚀")} Create a new project`, value: "create" },
-                    { name: `${chalk.cyan("📋")} Browse technologies (83)`, value: "browse" },
-                    { name: `${chalk.yellow("📊")} Score compatibility`, value: "score" },
-                    { name: `${chalk.blue("🔍")} Analyze an existing project`, value: "analyze" },
-                    { name: `${chalk.magenta("🏥")} System health check (doctor)`, value: "doctor" },
-                    { name: `${chalk.cyan("📚")} Learn about a technology`, value: "learn" },
-                    { name: `${chalk.yellow("🔄")} Migrate between technologies`, value: "migrate" },
-                    { name: `${chalk.green("💰")} Estimate hosting costs`, value: "cost-ask" },
-                    { name: `${chalk.blue("⚡")} Performance profile`, value: "bench-ask" },
-                    { name: `${chalk.cyan("🩺")} Check project health`, value: "health" },
-                    { name: `${chalk.yellow("🌐")} Environment sync (.env)`, value: "env" },
-                    new (await import("@inquirer/prompts")).Separator(),
-                    { name: `${chalk.dim("📦")} Manage saved stacks`, value: "stacks" },
-                    { name: `${chalk.dim("🐳")} Docker runtime`, value: "docker" },
-                    { name: `${chalk.dim("⚙️")}  Settings & tools`, value: "settings" },
-                    new (await import("@inquirer/prompts")).Separator(),
-                    { name: `${chalk.red("❌")} Exit`, value: "exit" },
+                    { name: "\uD83D\uDE80 Create a new project", value: "init" },
+                    { name: "\uD83D\uDCCB Browse technologies", value: "browse" },
+                    { name: "\uD83D\uDD0D Analyze an existing project", value: "analyze" },
+                    { name: "\uD83C\uDFE5 Check system health (doctor)", value: "doctor" },
+                    { name: "\uD83D\uDCCA Score compatibility", value: "score" },
+                    { name: "\uD83D\uDCDA Learn about a technology", value: "learn" },
+                    { name: "\uD83D\uDD04 Migrate between technologies", value: "migrate" },
+                    { name: "\uD83D\uDCB0 Estimate hosting costs", value: "cost" },
+                    { name: "\u26A1 Performance profile", value: "benchmark" },
+                    { name: "\uD83E\uDD16 AI stack recommendations", value: "ai" },
+                    new Separator(),
+                    { name: "\uD83D\uDCE6 Manage saved stacks", value: "stacks" },
+                    { name: "\uD83D\uDDA5\uFE0F  Runtime & services", value: "runtime" },
+                    { name: "\u2699\uFE0F  Settings & tools", value: "settings" },
+                    new Separator(),
+                    { name: "\uD83D\uDCD6 Show all commands", value: "commands" },
+                    { name: "\u274C Exit", value: "exit" },
                 ],
             });
-            if (action === "exit") {
-                console.log(chalk.dim("\n  Goodbye! 👋\n"));
+        }
+        catch (err) {
+            if (isExitSignal(err)) {
+                console.log(chalk.dim("\n  Goodbye!\n"));
                 process.exit(0);
             }
-            console.log("");
-            switch (action) {
-                case "create":
-                    await program.parseAsync(["node", "stackweld", "init"]);
+            throw err;
+        }
+        if (choice === "exit") {
+            console.log(chalk.dim("\n  Goodbye!\n"));
+            process.exit(0);
+        }
+        if (choice === "commands") {
+            printCommandList();
+            try {
+                await pressEnterToContinue();
+            }
+            catch (err) {
+                if (isExitSignal(err)) {
+                    console.log(chalk.dim("\n  Goodbye!\n"));
+                    process.exit(0);
+                }
+            }
+            console.clear();
+            printLogo();
+            continue;
+        }
+        console.log("");
+        try {
+            switch (choice) {
+                case "init":
+                    await run(["init"]);
                     break;
                 case "browse":
-                    await program.parseAsync(["node", "stackweld", "browse"]);
-                    break;
-                case "score": {
-                    const techA = await input({ message: "First technology ID:" });
-                    const techB = await input({ message: "Second technology ID (or Enter to see best/worst):" });
-                    const args = ["node", "stackweld", "score", techA];
-                    if (techB)
-                        args.push(techB);
-                    await program.parseAsync(args);
+                    await run(["browse"]);
                     break;
-                }
                 case "analyze": {
-                    const path = await input({ message: "Project path:", default: "." });
-                    await program.parseAsync(["node", "stackweld", "analyze", path]);
+                    const path = await input({ message: "Project path to analyze:", default: process.cwd() });
+                    await run(["analyze", path]);
                     break;
                 }
                 case "doctor":
-                    await program.parseAsync(["node", "stackweld", "doctor"]);
+                    await run(["doctor"]);
+                    break;
+                case "score": {
+                    const techA = await input({ message: "First technology ID (e.g. react, nextjs):" });
+                    const techB = await input({
+                        message: "Second technology ID (optional, Enter to skip):",
+                    });
+                    const scoreArgs = ["score", techA.trim()];
+                    if (techB.trim())
+                        scoreArgs.push(techB.trim());
+                    await run(scoreArgs);
                     break;
+                }
                 case "learn": {
-                    const tech = await input({ message: "Technology to learn about:" });
-                    await program.parseAsync(["node", "stackweld", "learn", tech]);
+                    const tech = await input({ message: "Technology ID (e.g. nextjs, react, docker):" });
+                    if (tech.trim())
+                        await run(["learn", tech.trim()]);
                     break;
                 }
                 case "migrate": {
                     const from = await input({ message: "Migrate FROM (technology ID):" });
                     const to = await input({ message: "Migrate TO (technology ID):" });
-                    await program.parseAsync(["node", "stackweld", "migrate", "--from", from, "--to", to]);
-                    break;
-                }
-                case "cost-ask": {
-                    const stackId = await input({ message: "Stack ID:" });
-                    await program.parseAsync(["node", "stackweld", "cost", stackId]);
+                    if (from.trim() && to.trim()) {
+                        await run(["migrate", "--from", from.trim(), "--to", to.trim()]);
+                    }
                     break;
                 }
-                case "bench-ask": {
-                    const stackId = await input({ message: "Stack ID:" });
-                    await program.parseAsync(["node", "stackweld", "benchmark", stackId]);
+                case "cost": {
+                    const stackId = await input({ message: "Stack ID to estimate costs:" });
+                    if (stackId.trim())
+                        await run(["cost", stackId.trim()]);
                     break;
                 }
-                case "health": {
-                    const path = await input({ message: "Project path:", default: "." });
-                    await program.parseAsync(["node", "stackweld", "health", path]);
+                case "benchmark": {
+                    const stackId = await input({ message: "Stack ID to profile:" });
+                    if (stackId.trim())
+                        await run(["benchmark", stackId.trim()]);
                     break;
                 }
-                case "env": {
-                    const subAction = await select({
-                        message: "Environment action:",
-                        choices: [
-                            { name: "Sync .env.example with .env", value: "sync" },
-                            { name: "Check for dangerous values", value: "check" },
-                        ],
-                    });
-                    const path = await input({ message: "Project path:", default: "." });
-                    await program.parseAsync(["node", "stackweld", "env", subAction, "--path", path]);
+                case "ai":
+                    await run(["ai"]);
                     break;
-                }
-                case "stacks": {
-                    const subAction = await select({
-                        message: "Stack management:",
-                        choices: [
-                            { name: "📋 List all stacks", value: "list" },
-                            { name: "🔍 Stack info", value: "info" },
-                            { name: "🗑️  Delete a stack", value: "delete" },
-                            { name: "📤 Export a stack", value: "export" },
-                            { name: "📥 Import a stack", value: "import" },
-                            { name: "🔗 Share via URL", value: "share" },
-                            { name: "📑 Compare two stacks", value: "compare" },
-                            { name: "📋 Clone a stack", value: "clone" },
-                            { name: "⬅️  Back", value: "back" },
-                        ],
-                    });
-                    if (subAction === "back")
-                        break;
-                    if (subAction === "list") {
-                        await program.parseAsync(["node", "stackweld", "list"]);
-                    }
-                    else if (subAction === "info") {
-                        const id = await input({ message: "Stack ID:" });
-                        await program.parseAsync(["node", "stackweld", "info", id]);
-                    }
-                    else if (subAction === "delete") {
-                        const id = await input({ message: "Stack ID to delete:" });
-                        await program.parseAsync(["node", "stackweld", "delete", id]);
-                    }
-                    else if (subAction === "export") {
-                        const id = await input({ message: "Stack ID:" });
-                        await program.parseAsync(["node", "stackweld", "export", id]);
-                    }
-                    else if (subAction === "import") {
-                        const file = await input({ message: "File path:" });
-                        await program.parseAsync(["node", "stackweld", "import", file]);
-                    }
-                    else if (subAction === "share") {
-                        const id = await input({ message: "Stack ID:" });
-                        await program.parseAsync(["node", "stackweld", "share", id]);
-                    }
-                    else if (subAction === "compare") {
-                        const a = await input({ message: "First stack ID:" });
-                        const b = await input({ message: "Second stack ID:" });
-                        await program.parseAsync(["node", "stackweld", "compare", a, b]);
-                    }
-                    else if (subAction === "clone") {
-                        const id = await input({ message: "Stack ID to clone:" });
-                        await program.parseAsync(["node", "stackweld", "clone", id]);
-                    }
+                case "stacks":
+                    await stacksSubmenu();
                     break;
-                }
-                case "docker": {
-                    const subAction = await select({
-                        message: "Docker runtime:",
-                        choices: [
-                            { name: "▶️  Start services (up)", value: "up" },
-                            { name: "⏹️  Stop services (down)", value: "down" },
-                            { name: "📊 Service status", value: "status" },
-                            { name: "📜 View logs", value: "logs" },
-                            { name: "⬅️  Back", value: "back" },
-                        ],
-                    });
-                    if (subAction === "back")
-                        break;
-                    await program.parseAsync(["node", "stackweld", subAction]);
+                case "runtime":
+                    await runtimeSubmenu();
                     break;
-                }
-                case "settings": {
-                    const subAction = await select({
-                        message: "Settings & tools:",
-                        choices: [
-                            { name: "⚙️  Configuration", value: "config" },
-                            { name: "🔌 Plugins", value: "plugin" },
-                            { name: "🏗️  Deploy (generate IaC)", value: "deploy-ask" },
-                            { name: "✅ Lint (team standards)", value: "lint" },
-                            { name: "📝 Templates", value: "template" },
-                            { name: "🤖 AI assistant", value: "ai" },
-                            { name: "⬅️  Back", value: "back" },
-                        ],
-                    });
-                    if (subAction === "back")
-                        break;
-                    if (subAction === "deploy-ask") {
-                        const id = await input({ message: "Stack ID:" });
-                        const target = await select({
-                            message: "Deploy target:",
-                            choices: [
-                                { name: "VPS (Docker + nginx)", value: "vps" },
-                                { name: "AWS (ECS Fargate)", value: "aws" },
-                                { name: "GCP (Cloud Run)", value: "gcp" },
-                            ],
-                        });
-                        await program.parseAsync(["node", "stackweld", "deploy", id, "--target", target]);
-                    }
-                    else if (subAction === "config") {
-                        await program.parseAsync(["node", "stackweld", "config", "list"]);
-                    }
-                    else if (subAction === "plugin") {
-                        await program.parseAsync(["node", "stackweld", "plugin", "list"]);
-                    }
-                    else {
-                        await program.parseAsync(["node", "stackweld", subAction]);
-                    }
+                case "settings":
+                    await settingsSubmenu();
                     break;
-                }
             }
-            // Pause before showing menu again
-            console.log("");
-            await input({ message: chalk.dim("Press Enter to continue...") });
-            console.clear();
-            console.log(banner(VERSION));
         }
         catch (err) {
-            // Handle Ctrl+C gracefully
-            if (err && typeof err === "object" && "name" in err && err.name === "ExitPromptError") {
-                console.log(chalk.dim("\n  Goodbye! 👋\n"));
+            if (isExitSignal(err)) {
+                console.log(chalk.dim("\n  Goodbye!\n"));
                 process.exit(0);
             }
-            throw err;
+            console.error(chalk.red(`\n  \u2716 ${err instanceof Error ? err.message : String(err)}\n`));
+        }
+        console.log("");
+        try {
+            await pressEnterToContinue();
         }
+        catch (err) {
+            if (isExitSignal(err)) {
+                console.log(chalk.dim("\n  Goodbye!\n"));
+                process.exit(0);
+            }
+        }
+        console.clear();
+        printLogo();
     }
 }
-// ── Entry Point ───────────────────────────────────────────────────
+// ─── Entry Point ──────────────────────────────────────────
 if (process.argv.length <= 2) {
     interactiveMenu().catch(() => process.exit(0));
 }
 else {
-    program.parse();
+    program.parseAsync(process.argv).catch((err) => {
+        if (err && err.code === "commander.unknownCommand") {
+            const cmd = process.argv[2];
+            console.error(chalk.red(`\u2716 Unknown command: "${cmd}"`));
+            console.error(chalk.dim(`  Run ${chalk.white("stackweld --help")} to see available commands.`));
+            process.exit(1);
+        }
+        console.error(chalk.red(`\u2716 ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(1);
+    });
 }
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackweld/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "The operating system for your dev stacks — define, validate, scaffold, and launch development environments from the terminal.",
   "license": "MIT",
   "author": "Orlando Fernandez <hello@xplustechnologies.com>",
@@ -10,7 +10,15 @@
     "url": "https://github.com/mundowise/Stackweld.git",
     "directory": "packages/cli"
   },
-  "keywords": ["cli", "devtools", "scaffold", "stack", "docker", "developer-tools", "project-generator"],
+  "keywords": [
+    "cli",
+    "devtools",
+    "scaffold",
+    "stack",
+    "docker",
+    "developer-tools",
+    "project-generator"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
@@ -25,28 +33,28 @@
   "engines": {
     "node": ">=22.0.0"
   },
-  "scripts": {
-    "build": "tsc -b",
-    "dev": "tsc -b --watch",
-    "test": "vitest run --passWithNoTests",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check src/",
-    "clean": "rm -rf dist .turbo"
-  },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.80.0",
     "@inquirer/prompts": "^7.0.0",
-    "@stackweld/core": "0.2.1",
-    "@stackweld/registry": "0.2.1",
-    "@stackweld/templates": "0.2.1",
     "chalk": "^5.4.0",
     "commander": "^13.0.0",
     "ora": "^8.0.0",
-    "yaml": "^2.8.3"
+    "yaml": "^2.8.3",
+    "@stackweld/core": "0.2.1",
+    "@stackweld/registry": "0.2.1",
+    "@stackweld/templates": "0.2.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.0.0",
     "typescript": "^5.9.0",
     "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "clean": "rm -rf dist .turbo"
   }
-}
+}