leedab 0.7.1 → 0.7.2

package/bin/leedab.js

@@ -14,6 +14,7 @@ import { startGateway, stopGateway } from "../dist/gateway.js";
 import { loadConfig, initConfig } from "../dist/config/index.js";
 import { setupChannels } from "../dist/channels/index.js";
 import { runOnboard } from "../dist/onboard/index.js";
+import { ensureFirstRun } from "../dist/first-run/ensure.js";
 import { startConsole, stopConsole } from "../dist/console-launcher.js";
 import { execBranded } from "../dist/brand.js";
 import { resolveOpenClawBin, openclawArgs, openclawEnv } from "../dist/openclaw.js";
@@ -135,9 +136,12 @@ function ensureAdminToken() {
 }
 
 /** Commands that don't require an existing project directory or license. */
-const NO_PROJECT_REQUIRED = new Set(["onboard", "init", "help"]);
-/** Commands that need a project but not a license (onboard handles its own license check). */
-const NO_LICENSE_REQUIRED = new Set(["onboard", "init", "help", "stop"]);
+// `start` is intentionally listed here. The action runs ensureFirstRun()
+// inline before any operations that depend on a configured workspace or
+// license; the project + license guards would bail too eagerly on a fresh
+// install otherwise.
+const NO_PROJECT_REQUIRED = new Set(["onboard", "init", "help", "start"]);
+const NO_LICENSE_REQUIRED = new Set(["onboard", "init", "help", "stop", "start"]);
 
 /**
  * Auto-recover from the "two-state-dirs" footgun. If the current working
@@ -269,7 +273,7 @@ function requireProject(command) {
 
   if (!existsSync(STATE_DIR)) {
     console.error(chalk.red("\n  LeedAB is not set up yet.\n"));
-    console.error(chalk.dim("  Run ") + chalk.cyan("leedab onboard") + chalk.dim(" to get started.\n"));
+    console.error(chalk.dim("  Run ") + chalk.cyan("leedab start") + chalk.dim(" to get started — it'll prompt for what's missing.\n"));
     process.exit(1);
   }
 }
@@ -289,7 +293,7 @@ async function requireLicense(command) {
   const license = await ensureLicense();
   if (!license) {
     console.error(chalk.red("\n  Invalid or expired license.\n"));
-    console.error(chalk.dim("  Re-enter your key: ") + chalk.cyan("leedab onboard"));
+    console.error(chalk.dim("  Re-enter your key: ") + chalk.cyan("leedab start"));
     console.error(chalk.dim("  Get a key at:      ") + chalk.cyan("https://leedab.com\n"));
     process.exit(1);
   }
@@ -311,7 +315,7 @@ program
 
 program
   .command("onboard")
-  .description("Interactive setup wizard — connect channels and set up credential vault")
+  .description("Optional. Walks the full setup wizard including channels and the vault. `leedab start` covers the basics inline.")
   .action(async () => {
     try {
       // Provision the writable workspace + admin token before runOnboard
@@ -333,14 +337,14 @@ program
     const { loadLicense, validateLicenseKey, saveLicense } = await import("../dist/license.js");
     const cached = await loadLicense();
     if (!cached?.key) {
-      console.log(chalk.red("\n  No valid license found. Run `leedab onboard` to enter your key.\n"));
+      console.log(chalk.red("\n  No valid license found. Run `leedab start` to enter your key.\n"));
       process.exit(1);
     }
     // Always fetch live
     const license = await validateLicenseKey(cached.key);
     await saveLicense(license);
     if (!license) {
-      console.log(chalk.red("\n  No valid license found. Run `leedab onboard` to enter your key.\n"));
+      console.log(chalk.red("\n  No valid license found. Run `leedab start` to enter your key.\n"));
       process.exit(1);
     }
     console.log("");
@@ -426,6 +430,17 @@ program
       "Pouring the coffee...",
       "Almost there...",
     ];
+    // First-run gate. Quietly returns when license + provider are already
+    // set; prompts inline for what's missing on a fresh install. Replaces
+    // the standalone `leedab onboard` wizard as the entry path so the
+    // operator never has to know about a separate setup command.
+    try {
+      await ensureFirstRun();
+    } catch (err) {
+      console.error(chalk.red(`\n  Setup failed: ${err.message}\n`));
+      process.exit(1);
+    }
+
     const spinner = ora("Starting LeedAB agent...").start();
     let lastIdx = -1;
     const rotate = setInterval(() => {

package/dist/first-run/ensure.d.ts

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

package/dist/first-run/ensure.js

@@ -0,0 +1,132 @@
+import { writeFile, mkdir, readFile, access } from "node:fs/promises";
+import { resolve } from "node:path";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { onboardProvider } from "../onboard/steps/provider.js";
+import { DEFAULT_CONFIG } from "../config/schema.js";
+import { loadConfig } from "../config/index.js";
+import { initMemory } from "../memory/index.js";
+import { validateLicenseKey, saveLicense, loadLicense } from "../license.js";
+import { STATE_DIR } from "../paths.js";
+// First-run gate for `leedab start`. Idempotent: returns silently when
+// the license + LLM provider are already configured; prompts inline for
+// whatever's missing, persists results, and returns. Replaces the older
+// standalone `leedab onboard` wizard for the load-bearing setup so the
+// operator doesn't have to remember a separate command before they can
+// run the agent. Channel and vault setup remain accessible via
+// `leedab configure` / the admin panel.
+export async function ensureFirstRun() {
+    // Banner only when something is actually missing — quiet on re-runs.
+    let printed = false;
+    const banner = () => {
+        if (printed)
+            return;
+        console.log();
+        console.log(chalk.bold("  Welcome to LeedAB."));
+        console.log(chalk.dim("  A local AI OS that learns your operations."));
+        console.log();
+        printed = true;
+    };
+    // 1. License
+    const existingLicense = await loadLicense();
+    if (!existingLicense?.valid) {
+        banner();
+        await promptForLicense();
+    }
+    // 2. Provider (auth profile in openclaw.json)
+    const hasProvider = await openClawHasProfile();
+    if (!hasProvider) {
+        banner();
+        console.log(chalk.bold("  Pick a model"));
+        console.log(chalk.dim("  Your key stays local. Switch any time with ") + chalk.cyan("leedab configure model") + chalk.dim("."));
+        console.log();
+        const provider = await onboardProvider();
+        // Materialise leedab config.json with the chosen model so subsequent
+        // commands have a config to read. We don't write a model value when
+        // the provider step bailed (operator hit Ctrl-C inside the picker);
+        // they'll be re-prompted next start.
+        if (provider) {
+            const existing = await loadExistingConfig();
+            const next = {
+                ...(existing ?? DEFAULT_CONFIG),
+                agent: {
+                    ...((existing ?? DEFAULT_CONFIG).agent),
+                    model: provider.model,
+                },
+            };
+            await mkdir(STATE_DIR, { recursive: true });
+            await writeFile(resolve(STATE_DIR, "config.json"), JSON.stringify(next, null, 2) + "\n");
+            // Memory dir on first run.
+            next.memory.dir = resolve(STATE_DIR, "memory");
+            await initMemory(next.memory.dir);
+        }
+    }
+    if (printed) {
+        console.log();
+        console.log(chalk.green("  You're set."));
+        console.log();
+    }
+}
+async function loadExistingConfig() {
+    const path = resolve(STATE_DIR, "config.json");
+    try {
+        await access(path);
+    }
+    catch {
+        return null;
+    }
+    // loadConfig logs a warning when the file is missing; we already
+    // gated above so this read is safe.
+    return loadConfig(path);
+}
+async function openClawHasProfile() {
+    try {
+        const raw = await readFile(resolve(STATE_DIR, "openclaw.json"), "utf-8");
+        const cfg = JSON.parse(raw);
+        return Object.keys(cfg.auth?.profiles ?? {}).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function promptForLicense() {
+    console.log(chalk.bold("  License key"));
+    console.log(chalk.dim("  Buy at ") + chalk.cyan("https://leedab.com") + chalk.dim(" — key is sent to your email."));
+    console.log();
+    while (true) {
+        let key;
+        try {
+            const answers = await inquirer.prompt([
+                {
+                    type: "password",
+                    name: "key",
+                    message: "License key:",
+                    mask: "*",
+                    validate: (v) => v.trim().startsWith("am_live_") || "Key should start with am_live_",
+                },
+            ]);
+            key = answers.key;
+        }
+        catch {
+            console.log(chalk.dim("\n\n  Exiting. Run `leedab start` again when you have your key.\n"));
+            process.exit(0);
+        }
+        process.stdout.write(chalk.dim("  Validating..."));
+        const result = await validateLicenseKey(key.trim());
+        if (result.valid) {
+            await saveLicense(result);
+            console.log(chalk.green(` valid (${result.tier} plan)`));
+            console.log();
+            return;
+        }
+        console.log(chalk.red(" invalid key."));
+        const { retry } = await inquirer.prompt([
+            { type: "confirm", name: "retry", message: "Try again?", default: true },
+        ]);
+        if (!retry) {
+            console.log(chalk.red("\n  A valid license key is required to use LeedAB."));
+            console.log(chalk.dim("  Get one at ") + chalk.cyan("https://leedab.com\n"));
+            process.exit(1);
+        }
+    }
+}

package/dist/onboard/index.js

@@ -1,6 +1,5 @@
-import { writeFile, readFile, mkdir, readdir, copyFile } from "node:fs/promises";
-import { resolve, join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
+import { writeFile, mkdir } from "node:fs/promises";
+import { resolve } from "node:path";
 import chalk from "chalk";
 import inquirer from "inquirer";
 import { printWelcome } from "./steps/welcome.js";
@@ -72,7 +71,8 @@ export async function runOnboard() {
             }
         }
     }
-    // Agent name
+    // Agent name. Kept as a single quick prompt so the operator can rebrand
+    // the assistant if they want; defaults to LeedAB.
     const { agentName } = await inquirer.prompt([
         {
             type: "input",
@@ -81,30 +81,18 @@ export async function runOnboard() {
             default: "LeedAB",
         },
     ]);
-    // Vertical selection
-    const { vertical } = await inquirer.prompt([
-        {
-            type: "list",
-            name: "vertical",
-            message: "What type of operations?",
-            choices: [
-                { name: "General purpose", value: "general" },
-                { name: "Supply chain & logistics", value: "supply-chain" },
-            ],
-        },
-    ]);
+    // Vertical / industry presets used to live here — dropped 2026-05.
+    // The brain learns the operation from real signals; pre-categorising
+    // at setup contradicts the closed-loop positioning and forces a
+    // self-categorisation decision before the brain has seen any data.
+    // Same call killed the vertical-specific template + vault seeding;
+    // the marketplace is the pull model for additional operators now.
     const config = {
         ...DEFAULT_CONFIG,
-        agent: { ...DEFAULT_CONFIG.agent, name: agentName, vertical },
+        agent: { ...DEFAULT_CONFIG.agent, name: agentName },
     };
     // Secrets go to .leedab/secrets.json (gitignored)
     const secrets = {};
-    // --- Seed vertical templates ---
-    if (vertical !== "general") {
-        await seedVerticalTemplates(vertical);
-        await seedVerticalVault(vertical);
-        console.log(chalk.green(`\n  Loaded ${vertical} templates and vault entries.`));
-    }
     // --- LLM Provider ---
     const provider = await onboardProvider();
     if (provider) {
@@ -237,44 +225,3 @@ export async function runOnboard() {
     console.log(chalk.dim(`  Memory:  ~/.leedab/memory/`));
     console.log(chalk.bold(`\n  Start your agent: ${chalk.cyan("leedab start")}\n`));
 }
-/**
- * Copy vertical-specific workspace templates (SOUL.md, HEARTBEAT.md, etc.)
- * into workspace/, overwriting defaults.
- */
-async function seedVerticalTemplates(vertical) {
-    const srcDir = join(dirname(fileURLToPath(import.meta.url)), "..", "templates", "verticals", vertical);
-    const destDir = resolve("workspace");
-    await mkdir(destDir, { recursive: true });
-    try {
-        const files = await readdir(srcDir);
-        for (const file of files) {
-            if (file.endsWith(".json"))
-                continue; // Skip vault-template.json
-            await copyFile(join(srcDir, file), join(destDir, file));
-        }
-    }
-    catch {
-        // Templates directory may not exist for this vertical
-    }
-}
-/**
- * Pre-populate vault with entries from the vertical's vault-template.json.
- * Only adds entries that don't already exist (won't overwrite user credentials).
- */
-async function seedVerticalVault(vertical) {
-    const templatePath = join(dirname(fileURLToPath(import.meta.url)), "..", "templates", "verticals", vertical, "vault-template.json");
-    try {
-        const raw = await readFile(templatePath, "utf-8");
-        const template = JSON.parse(raw);
-        for (const [service, entry] of Object.entries(template)) {
-            // Only add if service doesn't already exist in vault
-            const existing = await listEntries();
-            if (!existing.some((e) => e.service === service)) {
-                await addEntry(service, entry);
-            }
-        }
-    }
-    catch {
-        // No vault template for this vertical
-    }
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leedab",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "A local AI operating system that learns your operations and runs them with Artificial Beings. Across portals, ERPs, dashboards, inboxes, spreadsheets, and PDFs. On your hardware. Your data. No APIs.",
   "license": "UNLICENSED",
   "author": "LeedAB <hello@leedab.com>",