@romiluz/clawmongo 0.1.0-rc.3 → 0.1.0-rc.4

package/dist/cli/branding.js

@@ -0,0 +1,129 @@
+/**
+ * ClawMongo CLI Branding
+ *
+ * ASCII art logo, colors, and branding elements.
+ *
+ * @module cli/branding
+ */
+/**
+ * ClawMongo ASCII art logo.
+ */
+export const LOGO = `
+\x1b[36m   _____ _                 __  __                         
+  / ____| |               |  \\/  |                        
+ | |    | | __ ___      __| \\  / | ___  _ __   __ _  ___  
+ | |    | |/ _\` \\ \\ /\\ / /| |\\/| |/ _ \\| '_ \\ / _\` |/ _ \\ 
+ | |____| | (_| |\\ V  V / | |  | | (_) | | | | (_| | (_) |
+  \\_____|_|\\__,_| \\_/\\_/  |_|  |_|\\___/|_| |_|\\__, |\\___/ 
+                                               __/ |      
+                                              |___/       \x1b[0m`;
+/**
+ * Tagline displayed under the logo.
+ */
+export const TAGLINE = "\x1b[33m  MongoDB is the brain, OpenClaw is the heart.\x1b[0m";
+/**
+ * Short tagline for compact displays.
+ */
+export const TAGLINE_SHORT = "\x1b[2mMongoDB-native agentic AI assistant\x1b[0m";
+/**
+ * Version banner with logo.
+ */
+export function getVersionBanner(version) {
+    return `${LOGO}
+${TAGLINE}
+
+  \x1b[2mVersion ${version}\x1b[0m
+`;
+}
+/**
+ * Welcome message for first-run experience.
+ */
+export function getWelcomeMessage(version) {
+    return `${LOGO}
+${TAGLINE}
+
+  \x1b[32m✨ Welcome to ClawMongo v${version}!\x1b[0m
+
+  ClawMongo is a MongoDB-native fork of OpenClaw that leverages
+  MongoDB's capabilities (Atlas Search, Vector Search, \$rankFusion)
+  while maintaining full parity with OpenClaw's features.
+
+  \x1b[36m📚 Quick Start:\x1b[0m
+  
+    \x1b[33mclawmongo init\x1b[0m        Set up your configuration
+    \x1b[33mclawmongo chat\x1b[0m        Start interactive chat
+    \x1b[33mclawmongo send\x1b[0m        Send a one-shot message
+    \x1b[33mclawmongo health\x1b[0m      Check system status
+
+  \x1b[36m🔧 Configuration:\x1b[0m
+  
+    Set these environment variables:
+    
+    \x1b[2mANTHROPIC_API_KEY\x1b[0m     Your Anthropic API key
+    \x1b[2mCLAWMONGO_MONGODB_URI\x1b[0m MongoDB connection string (optional)
+    \x1b[2mVOYAGE_API_KEY\x1b[0m        Voyage AI key for embeddings (optional)
+
+  \x1b[36m📖 Documentation:\x1b[0m
+  
+    https://github.com/romiluz13/ClawMongo
+
+  \x1b[2mRun 'clawmongo --help' for all available commands.\x1b[0m
+`;
+}
+/**
+ * Compact header for command output.
+ */
+export function getCompactHeader(version) {
+    return `\x1b[36m🐾 ClawMongo\x1b[0m v${version}`;
+}
+/**
+ * Success message with emoji.
+ */
+export function successMessage(text) {
+    return `\x1b[32m✓\x1b[0m ${text}`;
+}
+/**
+ * Error message with emoji.
+ */
+export function errorMessage(text) {
+    return `\x1b[31m✗\x1b[0m ${text}`;
+}
+/**
+ * Warning message with emoji.
+ */
+export function warnMessage(text) {
+    return `\x1b[33m⚠\x1b[0m ${text}`;
+}
+/**
+ * Info message with emoji.
+ */
+export function infoMessage(text) {
+    return `\x1b[36mℹ\x1b[0m ${text}`;
+}
+/**
+ * Step indicator for multi-step processes.
+ */
+export function stepIndicator(current, total, text) {
+    return `\x1b[36m[${current}/${total}]\x1b[0m ${text}`;
+}
+/**
+ * Progress bar.
+ */
+export function progressBar(percent, width = 30) {
+    const filled = Math.round((percent / 100) * width);
+    const empty = width - filled;
+    const bar = "\x1b[32m" + "█".repeat(filled) + "\x1b[2m" + "░".repeat(empty) + "\x1b[0m";
+    return `${bar} ${percent.toFixed(0)}%`;
+}
+/**
+ * Box drawing for important messages.
+ */
+export function boxMessage(title, lines) {
+    const maxLen = Math.max(title.length, ...lines.map(l => l.length));
+    const top = `┌${"─".repeat(maxLen + 2)}┐`;
+    const titleLine = `│ \x1b[1m${title.padEnd(maxLen)}\x1b[0m │`;
+    const sep = `├${"─".repeat(maxLen + 2)}┤`;
+    const content = lines.map(l => `│ ${l.padEnd(maxLen)} │`).join("\n");
+    const bottom = `└${"─".repeat(maxLen + 2)}┘`;
+    return `${top}\n${titleLine}\n${sep}\n${content}\n${bottom}`;
+}

package/dist/cli/commands/init.js

@@ -0,0 +1,173 @@
+/**
+ * ClawMongo Init Command
+ *
+ * Interactive setup wizard for first-time configuration.
+ *
+ * @module cli/commands/init
+ */
+import * as readline from "readline";
+import * as fs from "fs";
+import * as path from "path";
+import { ExitCode } from "./types.js";
+import { createOutput } from "./output.js";
+import { LOGO, TAGLINE, successMessage, errorMessage, stepIndicator, boxMessage } from "../branding.js";
+/**
+ * Prompt user for input with optional default.
+ */
+async function prompt(rl, question, defaultValue, isSecret = false) {
+    const defaultHint = defaultValue ? ` \x1b[2m(${isSecret ? "****" : defaultValue})\x1b[0m` : "";
+    return new Promise((resolve) => {
+        rl.question(`  ${question}${defaultHint}: `, (answer) => {
+            resolve(answer.trim() || defaultValue || "");
+        });
+    });
+}
+/**
+ * Prompt for yes/no confirmation.
+ */
+async function confirm(rl, question, defaultYes = true) {
+    const hint = defaultYes ? "[Y/n]" : "[y/N]";
+    return new Promise((resolve) => {
+        rl.question(`  ${question} ${hint}: `, (answer) => {
+            const a = answer.trim().toLowerCase();
+            if (a === "")
+                resolve(defaultYes);
+            else
+                resolve(a === "y" || a === "yes");
+        });
+    });
+}
+/**
+ * Select from a list of options using arrow keys.
+ */
+async function select(rl, question, options, defaultIndex = 0) {
+    console.log(`\n  ${question}\n`);
+    let selectedIndex = defaultIndex;
+    // For simplicity, use numbered selection (arrow keys require raw mode)
+    options.forEach((opt, i) => {
+        const marker = i === defaultIndex ? "\x1b[36m→\x1b[0m" : " ";
+        console.log(`  ${marker} ${i + 1}. ${opt.label}`);
+    });
+    return new Promise((resolve) => {
+        rl.question(`\n  Enter number (1-${options.length}): `, (answer) => {
+            const num = parseInt(answer.trim(), 10);
+            if (num >= 1 && num <= options.length) {
+                const selected = options[num - 1];
+                resolve(selected ? selected.value : options[0]?.value ?? "");
+            }
+            else {
+                const defaultOpt = options[defaultIndex];
+                resolve(defaultOpt ? defaultOpt.value : options[0]?.value ?? "");
+            }
+        });
+    });
+}
+/**
+ * Write config to .env file.
+ */
+function writeEnvFile(config, filePath) {
+    const lines = [
+        "# ClawMongo Configuration",
+        "# Generated by 'clawmongo init'",
+        "",
+    ];
+    if (config.anthropicApiKey) {
+        lines.push(`ANTHROPIC_API_KEY=${config.anthropicApiKey}`);
+    }
+    if (config.mongodbUri) {
+        lines.push(`CLAWMONGO_MONGODB_URI=${config.mongodbUri}`);
+    }
+    if (config.voyageApiKey) {
+        lines.push(`VOYAGE_API_KEY=${config.voyageApiKey}`);
+    }
+    if (config.openaiApiKey) {
+        lines.push(`OPENAI_API_KEY=${config.openaiApiKey}`);
+    }
+    lines.push("");
+    fs.writeFileSync(filePath, lines.join("\n"));
+}
+/**
+ * Init command - interactive setup wizard.
+ */
+export const initCommand = {
+    name: "init",
+    aliases: ["setup", "configure"],
+    description: "Interactive setup wizard",
+    usage: "clawmongo init [--force]",
+    async execute(ctx) {
+        const out = createOutput({ json: ctx.json });
+        const envPath = path.join(process.cwd(), ".env");
+        // Check if .env already exists
+        if (fs.existsSync(envPath) && !ctx.flags.force) {
+            out.writeln(errorMessage(".env file already exists. Use --force to overwrite."));
+            return ExitCode.ERROR;
+        }
+        // Show welcome banner
+        console.log(LOGO);
+        console.log(TAGLINE);
+        console.log("\n  \x1b[1m✨ Welcome to ClawMongo Setup!\x1b[0m\n");
+        console.log("  This wizard will help you configure ClawMongo.");
+        console.log("  Press Enter to accept defaults, or type your values.\n");
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        const config = {};
+        try {
+            // Step 1: Anthropic API Key
+            console.log(stepIndicator(1, 4, "\x1b[1mAnthropic API Key\x1b[0m"));
+            console.log("  \x1b[2mRequired for Claude AI. Get yours at https://console.anthropic.com\x1b[0m\n");
+            config.anthropicApiKey = await prompt(rl, "ANTHROPIC_API_KEY", process.env.ANTHROPIC_API_KEY, true);
+            // Step 2: MongoDB URI
+            console.log("\n" + stepIndicator(2, 4, "\x1b[1mMongoDB Connection\x1b[0m"));
+            console.log("  \x1b[2mOptional. Enables persistent storage, Atlas Search, and vector search.\x1b[0m\n");
+            const useMongo = await confirm(rl, "Configure MongoDB?", true);
+            if (useMongo) {
+                config.mongodbUri = await prompt(rl, "CLAWMONGO_MONGODB_URI", process.env.CLAWMONGO_MONGODB_URI);
+            }
+            // Step 3: Embedding Provider
+            console.log("\n" + stepIndicator(3, 4, "\x1b[1mEmbedding Provider\x1b[0m"));
+            console.log("  \x1b[2mOptional. Enables semantic search and RAG capabilities.\x1b[0m\n");
+            const embeddingProvider = await select(rl, "Select embedding provider:", [
+                { value: "none", label: "None (skip for now)" },
+                { value: "voyage", label: "Voyage AI (recommended)" },
+                { value: "openai", label: "OpenAI" }
+            ], 0);
+            if (embeddingProvider === "voyage") {
+                config.voyageApiKey = await prompt(rl, "VOYAGE_API_KEY", process.env.VOYAGE_API_KEY, true);
+            }
+            else if (embeddingProvider === "openai") {
+                config.openaiApiKey = await prompt(rl, "OPENAI_API_KEY", process.env.OPENAI_API_KEY, true);
+            }
+            // Step 4: Confirm and write
+            console.log("\n" + stepIndicator(4, 4, "\x1b[1mConfirm Configuration\x1b[0m\n"));
+            const summary = [
+                `Anthropic API Key: ${config.anthropicApiKey ? "✓ Set" : "✗ Not set"}`,
+                `MongoDB URI: ${config.mongodbUri ? "✓ Set" : "✗ Not set"}`,
+                `Voyage API Key: ${config.voyageApiKey ? "✓ Set" : "✗ Not set"}`,
+                `OpenAI API Key: ${config.openaiApiKey ? "✓ Set" : "✗ Not set"}`
+            ];
+            console.log(boxMessage("Configuration Summary", summary));
+            console.log("");
+            const shouldWrite = await confirm(rl, "Write configuration to .env?", true);
+            if (shouldWrite) {
+                writeEnvFile(config, envPath);
+                console.log("\n" + successMessage(`Configuration saved to ${envPath}`));
+                console.log("\n  \x1b[36m🚀 You're all set! Try these commands:\x1b[0m\n");
+                console.log("    \x1b[33mclawmongo health\x1b[0m    Check system status");
+                console.log("    \x1b[33mclawmongo chat\x1b[0m      Start interactive chat");
+                console.log("    \x1b[33mclawmongo send\x1b[0m      Send a message\n");
+            }
+            else {
+                console.log("\n" + errorMessage("Setup cancelled."));
+            }
+            rl.close();
+            return ExitCode.SUCCESS;
+        }
+        catch (err) {
+            rl.close();
+            out.error(err instanceof Error ? err.message : String(err));
+            return ExitCode.ERROR;
+        }
+    }
+};

package/dist/cli/commands/registry.js

@@ -74,15 +74,26 @@ export function generateHelp(command, prefix = "") {
 export function generateGlobalHelp(registry, version) {
     const commands = registry.list();
     const lines = [];
-    lines.push(`ClawMongo v${version}`);
-    lines.push("MongoDB-native agentic AI assistant");
+    // ASCII Logo
+    lines.push("\x1b[36m   _____ _                 __  __                         ");
+    lines.push("  / ____| |               |  \\/  |                        ");
+    lines.push(" | |    | | __ ___      __| \\  / | ___  _ __   __ _  ___  ");
+    lines.push(" | |    | |/ _` \\ \\ /\\ / /| |\\/| |/ _ \\| '_ \\ / _` |/ _ \\ ");
+    lines.push(" | |____| | (_| |\\ V  V / | |  | | (_) | | | | (_| | (_) |");
+    lines.push("  \\_____|_|\\__,_| \\_/\\_/  |_|  |_|\\___/|_| |_|\\__, |\\___/ ");
+    lines.push("                                               __/ |      ");
+    lines.push("                                              |___/       \x1b[0m");
+    lines.push("");
+    lines.push("\x1b[33m  MongoDB is the brain, OpenClaw is the heart.\x1b[0m");
+    lines.push("");
+    lines.push(`  \x1b[2mVersion ${version}\x1b[0m`);
     lines.push("");
     lines.push("Usage: clawmongo <command> [options]");
     lines.push("");
     lines.push("Commands:");
     for (const cmd of commands) {
         const aliasStr = cmd.aliases ? ` (${cmd.aliases.join(", ")})` : "";
-        lines.push(`  ${cmd.name.padEnd(12)}${aliasStr.padEnd(8)} ${cmd.description}`);
+        lines.push(`  \x1b[33m${cmd.name.padEnd(12)}\x1b[0m${aliasStr.padEnd(8)} ${cmd.description}`);
     }
     lines.push("");
     lines.push("Options:");
@@ -91,6 +102,6 @@ export function generateGlobalHelp(registry, version) {
     lines.push("  --json          Output as JSON");
     lines.push("  -V, --verbose   Verbose output");
     lines.push("");
-    lines.push("Run 'clawmongo <command> --help' for command-specific help.");
+    lines.push("\x1b[2mRun 'clawmongo <command> --help' for command-specific help.\x1b[0m");
     return lines.join("\n");
 }

package/dist/main.js

@@ -19,13 +19,17 @@ import { cronCommand } from "./cli/commands/cron.js";
 import { backupCommand } from "./cli/commands/backup.js";
 import { securityCommand } from "./cli/commands/security.js";
 import { benchmarkCommand } from "./cli/commands/benchmark.js";
-const VERSION = "0.1.0-rc.3";
+import { initCommand } from "./cli/commands/init.js";
+// Import branding
+import { getVersionBanner, getWelcomeMessage } from "./cli/branding.js";
+const VERSION = "0.1.0-rc.4";
 /**
  * Build the command registry.
  */
 function buildRegistry() {
     const registry = createRegistry();
     // Register all commands
+    registry.register(initCommand); // Setup wizard first
     registry.register(healthCommand);
     registry.register(statusCommand);
     registry.register(doctorCommand);
@@ -51,7 +55,12 @@ async function main() {
     const out = createOutput({ json: hasFlag(parsed.flags, "json") });
     // Handle --version
     if (hasFlag(parsed.flags, "version") || hasFlag(parsed.flags, "v")) {
-        out.writeln(`clawmongo ${VERSION}`);
+        out.writeln(getVersionBanner(VERSION));
+        return;
+    }
+    // Handle no command - show welcome message
+    if (!parsed.command && !hasFlag(parsed.flags, "help")) {
+        out.writeln(getWelcomeMessage(VERSION));
         return;
     }
     // Handle --help with no command

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@romiluz/clawmongo",
-  "version": "0.1.0-rc.3",
+  "version": "0.1.0-rc.4",
   "private": false,
   "type": "module",
   "description": "MongoDB-native OpenClaw-inspired assistant runtime",