@lumerahq/cli 0.10.1 → 0.11.0

package/dist/{chunk-WTDV3MTG.js → chunk-CHRKCAIZ.js}

@@ -36,7 +36,7 @@ async function downloadAndExtract(commitSha) {
   writeFileSync(tmpFile, buffer);
   mkdirSync(cacheDir, { recursive: true });
   for (const entry of readdirSync(cacheDir)) {
-    if (entry === ".cache-meta.json") continue;
+    if (entry === ".cache-meta.json" || entry === ".refs") continue;
     rmSync(join(cacheDir, entry), { recursive: true, force: true });
   }
   const result = spawnSync("tar", ["xzf", tmpFile, "-C", cacheDir, "--strip-components=1"], { stdio: "ignore" });
@@ -56,6 +56,51 @@ async function ensureRemoteCache() {
   console.log("  Fetching latest templates...");
   return downloadAndExtract(latestSha);
 }
+function parseTemplateRef(input) {
+  const atIndex = input.lastIndexOf("@");
+  if (atIndex > 0) {
+    return {
+      name: input.slice(0, atIndex),
+      ref: input.slice(atIndex + 1)
+    };
+  }
+  return { name: input, ref: null };
+}
+async function ensureRemoteCacheForRef(ref) {
+  const refCacheDir = join(getCacheDir(), ".refs", ref);
+  if (existsSync(refCacheDir) && existsSync(join(refCacheDir, ".cache-meta.json"))) {
+    return refCacheDir;
+  }
+  console.log(`  Fetching templates at ref "${ref}"...`);
+  const urls = [
+    `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}/archive/refs/tags/${ref}.tar.gz`,
+    `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}/archive/refs/heads/${ref}.tar.gz`,
+    `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}/archive/${ref}.tar.gz`
+  ];
+  let res = null;
+  for (const url of urls) {
+    const attempt = await fetch(url);
+    if (attempt.ok) {
+      res = attempt;
+      break;
+    }
+  }
+  if (!res) {
+    throw new Error(
+      `Failed to fetch templates at ref "${ref}". Ensure the tag, branch, or SHA exists in ${GITHUB_OWNER}/${GITHUB_REPO}.`
+    );
+  }
+  const tmpFile = join(tmpdir(), `lumera-templates-${ref}-${Date.now()}.tar.gz`);
+  const buffer = Buffer.from(await res.arrayBuffer());
+  writeFileSync(tmpFile, buffer);
+  mkdirSync(refCacheDir, { recursive: true });
+  const result = spawnSync("tar", ["xzf", tmpFile, "-C", refCacheDir, "--strip-components=1"], { stdio: "ignore" });
+  if (result.status !== 0) throw new Error("Failed to extract template archive");
+  unlinkSync(tmpFile);
+  const meta = { commitSha: ref, fetchedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  writeFileSync(join(refCacheDir, ".cache-meta.json"), JSON.stringify(meta));
+  return refCacheDir;
+}
 function listTemplates(baseDir) {
   if (!existsSync(baseDir)) return [];
   const templates = [];
@@ -80,11 +125,17 @@ function listTemplates(baseDir) {
     return a.title.localeCompare(b.title);
   });
 }
-async function resolveTemplate(name) {
-  const cacheDir = await ensureRemoteCache();
+async function resolveTemplate(nameWithRef) {
+  const { name, ref } = parseTemplateRef(nameWithRef);
+  const cacheDir = ref ? await ensureRemoteCacheForRef(ref) : await ensureRemoteCache();
   const dir = join(cacheDir, name);
   if (!existsSync(dir) || !existsSync(join(dir, "template.json"))) {
     const available = listTemplates(cacheDir).map((t) => t.name).join(", ");
+    if (ref) {
+      throw new Error(
+        `Template "${name}" not found at ref "${ref}". Available: ${available || "none"}`
+      );
+    }
     throw new Error(
       `Template "${name}" not found. Available: ${available || "none"}
   Cache location: ${cacheDir}

package/dist/{chunk-WRAZC6SJ.js → chunk-HIYM7EM2.js}

@@ -143,6 +143,22 @@ function createApiClient(token, baseUrl) {
   return new ApiClient(token, baseUrl);
 }
 
+// src/lib/env.ts
+import { config } from "dotenv";
+import { existsSync } from "fs";
+import { resolve } from "path";
+function loadEnv(cwd = process.cwd()) {
+  const envPath = resolve(cwd, ".env");
+  const envLocalPath = resolve(cwd, ".env.local");
+  if (existsSync(envPath)) {
+    config({ path: envPath });
+  }
+  if (existsSync(envLocalPath)) {
+    config({ path: envLocalPath, override: true });
+  }
+}
+
 export {
-  createApiClient
+  createApiClient,
+  loadEnv
 };

package/dist/dev-2HVDP3NX.js

@@ -0,0 +1,155 @@
+import {
+  dev
+} from "./chunk-CDZZ3JYU.js";
+import {
+  createApiClient,
+  loadEnv
+} from "./chunk-HIYM7EM2.js";
+import {
+  getToken
+} from "./chunk-NDLYGKS6.js";
+import {
+  findProjectRoot,
+  getApiUrl,
+  getAppName,
+  getAppTitle
+} from "./chunk-D2BLSEGR.js";
+
+// src/commands/dev.ts
+import pc from "picocolors";
+import { execFileSync, execSync } from "child_process";
+import { existsSync } from "fs";
+import { join } from "path";
+function parseFlags(args) {
+  const result = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith("--")) {
+      const key = arg.slice(2);
+      const next = args[i + 1];
+      if (next && !next.startsWith("--")) {
+        result[key] = next;
+        i++;
+      } else {
+        result[key] = true;
+      }
+    }
+  }
+  return result;
+}
+function showHelp() {
+  console.log(`
+${pc.dim("Usage:")}
+  lumera dev [options]
+
+${pc.dim("Description:")}
+  Start the development server with Lumera registration.
+  Registers your app with Lumera and starts a local dev server.
+  On first run, automatically applies resources and seeds demo data.
+
+${pc.dim("Options:")}
+  --port <number>        Dev server port (default: 8080)
+  --url <url>            App URL for dev mode (default: http://localhost:{port})
+  --skip-setup           Skip auto-apply on first run
+  --help, -h             Show this help
+
+${pc.dim("Environment variables:")}
+  LUMERA_TOKEN           API token (overrides \`lumera login\`)
+  LUMERA_API_URL         API base URL (default: https://app.lumerahq.com/api)
+  PORT                   Dev server port (default: 8080)
+  APP_URL                App URL for dev mode
+
+${pc.dim("Examples:")}
+  lumera dev                    # Start dev server on port 8080
+  lumera dev --port 3000        # Start dev server on port 3000
+  lumera dev --skip-setup       # Skip first-run auto-apply
+`);
+}
+async function isFreshProject(projectRoot) {
+  try {
+    const api = createApiClient();
+    const remoteCollections = await api.listCollections();
+    const customCollections = remoteCollections.filter((c) => !c.system && !c.managed);
+    const platformDir = existsSync(join(projectRoot, "platform")) ? join(projectRoot, "platform") : join(projectRoot, "lumera_platform");
+    const collectionsDir = join(platformDir, "collections");
+    const hasLocalCollections = existsSync(collectionsDir);
+    return customCollections.length === 0 && hasLocalCollections;
+  } catch {
+    return false;
+  }
+}
+function runApply(projectRoot) {
+  try {
+    execFileSync(process.execPath, [...process.execArgv, process.argv[1], "apply"], {
+      cwd: projectRoot,
+      stdio: "inherit",
+      env: process.env
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function runSeed(projectRoot) {
+  const seedScript = join(projectRoot, "scripts", "seed-demo.py");
+  if (!existsSync(seedScript)) return false;
+  try {
+    execSync(`uv run "${seedScript}"`, {
+      cwd: projectRoot,
+      stdio: "inherit",
+      env: process.env
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function dev2(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    showHelp();
+    return;
+  }
+  const flags = parseFlags(args);
+  const projectRoot = findProjectRoot();
+  loadEnv(projectRoot);
+  const token = getToken(projectRoot);
+  const appName = getAppName(projectRoot);
+  const appTitle = getAppTitle(projectRoot);
+  const apiUrl = getApiUrl();
+  if (!flags["skip-setup"]) {
+    const fresh = await isFreshProject(projectRoot);
+    if (fresh) {
+      console.log();
+      console.log(pc.cyan(pc.bold("  First run detected")), pc.dim("\u2014 applying resources and seeding data..."));
+      console.log();
+      const applyOk = runApply(projectRoot);
+      if (!applyOk) {
+        console.log(pc.yellow("  \u26A0 Some resources failed to apply (continuing)"));
+      }
+      const seedScript = join(projectRoot, "scripts", "seed-demo.py");
+      if (existsSync(seedScript)) {
+        console.log();
+        console.log(pc.dim("  Running seed script..."));
+        if (runSeed(projectRoot)) {
+          console.log(pc.green("  \u2713"), pc.dim("Seed data applied"));
+        } else {
+          console.log(pc.yellow("  \u26A0"), pc.dim("Seed script failed (continuing)"));
+        }
+      }
+      console.log();
+    }
+  }
+  const port = Number(flags.port || process.env.PORT || "8080");
+  const appUrl = typeof flags.url === "string" ? flags.url : process.env.APP_URL;
+  await dev({
+    token,
+    appName,
+    appTitle,
+    port,
+    appUrl,
+    apiUrl
+  });
+}
+export {
+  dev2 as dev
+};

package/dist/index.js

@@ -1,16 +1,127 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFileSync } from "fs";
-import { dirname, join } from "path";
+import { readFileSync as readFileSync2 } from "fs";
+import { dirname, join as join2 } from "path";
 import { fileURLToPath } from "url";
 import pc from "picocolors";
+
+// src/lib/update-check.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+function getCachePath() {
+  return join(homedir(), ".lumera", "update-check.json");
+}
+function readCache() {
+  const cachePath = getCachePath();
+  if (!existsSync(cachePath)) return null;
+  try {
+    return JSON.parse(readFileSync(cachePath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function writeCache(data) {
+  const dir = join(homedir(), ".lumera");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(getCachePath(), JSON.stringify(data));
+}
+function isNewer(latest, current) {
+  const l = latest.split(".").map(Number);
+  const c = current.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] || 0) > (c[i] || 0)) return true;
+    if ((l[i] || 0) < (c[i] || 0)) return false;
+  }
+  return false;
+}
+async function checkForUpdate(currentVersion) {
+  try {
+    if (process.env.CI || process.env.LUMERA_NO_UPDATE_CHECK) return null;
+    const cache = readCache();
+    if (cache) {
+      const age = Date.now() - new Date(cache.lastCheck).getTime();
+      if (age < CHECK_INTERVAL_MS) {
+        if (isNewer(cache.latestVersion, currentVersion)) {
+          return { current: currentVersion, latest: cache.latestVersion };
+        }
+        return null;
+      }
+    }
+    const res = await fetch("https://registry.npmjs.org/@lumerahq/cli/latest");
+    if (!res.ok) return null;
+    const data = await res.json();
+    const latest = data.version;
+    writeCache({ lastCheck: (/* @__PURE__ */ new Date()).toISOString(), latestVersion: latest });
+    if (isNewer(latest, currentVersion)) {
+      return { current: currentVersion, latest };
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// src/index.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync2(join2(__dirname, "..", "package.json"), "utf-8"));
 var VERSION = pkg.version;
-var args = process.argv.slice(2);
+var rawArgs = process.argv.slice(2);
+var jsonMode = rawArgs.includes("--json");
+if (jsonMode) process.env.LUMERA_JSON = "1";
+var args = rawArgs.filter((a) => a !== "--json");
 var command = args[0];
 var subcommand = args[1];
+var COMMANDS = [
+  "plan",
+  "apply",
+  "pull",
+  "destroy",
+  "list",
+  "show",
+  "dev",
+  "run",
+  "init",
+  "templates",
+  "status",
+  "migrate",
+  "skills",
+  "login",
+  "logout",
+  "whoami"
+];
+function editDistance(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function suggestCommand(input) {
+  let best = "";
+  let bestDist = Infinity;
+  for (const cmd of COMMANDS) {
+    const d = editDistance(input.toLowerCase(), cmd);
+    if (d < bestDist) {
+      bestDist = d;
+      best = cmd;
+    }
+  }
+  const threshold = Math.max(2, Math.ceil(input.length * 0.4));
+  return bestDist <= threshold ? best : null;
+}
+function formatElapsed(ms) {
+  if (ms < 1e3) return `${Math.round(ms)}ms`;
+  return `${(ms / 1e3).toFixed(1)}s`;
+}
 function showHelp() {
   console.log(`
 ${pc.bold("Lumera CLI")} - Build and deploy Lumera apps
@@ -32,7 +143,8 @@ ${pc.dim("Development:")}
 
 ${pc.dim("Project:")}
   ${pc.cyan("init")} [name]              Scaffold a new project
-  ${pc.cyan("templates")}                List available templates
+  ${pc.cyan("templates list")}           List available templates
+  ${pc.cyan("templates validate")}       Validate a template directory
   ${pc.cyan("status")}                   Show project info
   ${pc.cyan("migrate")}                  Upgrade legacy project
 
@@ -49,6 +161,7 @@ ${pc.dim("Auth:")}
 ${pc.dim("Options:")}
   --help, -h               Show help
   --version, -v            Show version
+  --json                   Output as JSON (where supported)
 
 ${pc.dim("Resource Types:")}
   collections              Data collections (schemas)
@@ -89,40 +202,42 @@ async function main() {
       process.exit(1);
     }
   }
+  const startTime = performance.now();
+  const updateCheck = checkForUpdate(VERSION);
   try {
     switch (command) {
       // Resource commands
       case "plan":
-        await import("./resources-PGBVCS2K.js").then((m) => m.plan(args.slice(1)));
+        await import("./resources-GTG3QMVV.js").then((m) => m.plan(args.slice(1)));
         break;
       case "apply":
-        await import("./resources-PGBVCS2K.js").then((m) => m.apply(args.slice(1)));
+        await import("./resources-GTG3QMVV.js").then((m) => m.apply(args.slice(1)));
         break;
       case "pull":
-        await import("./resources-PGBVCS2K.js").then((m) => m.pull(args.slice(1)));
+        await import("./resources-GTG3QMVV.js").then((m) => m.pull(args.slice(1)));
         break;
       case "destroy":
-        await import("./resources-PGBVCS2K.js").then((m) => m.destroy(args.slice(1)));
+        await import("./resources-GTG3QMVV.js").then((m) => m.destroy(args.slice(1)));
         break;
       case "list":
-        await import("./resources-PGBVCS2K.js").then((m) => m.list(args.slice(1)));
+        await import("./resources-GTG3QMVV.js").then((m) => m.list(args.slice(1)));
         break;
       case "show":
-        await import("./resources-PGBVCS2K.js").then((m) => m.show(args.slice(1)));
+        await import("./resources-GTG3QMVV.js").then((m) => m.show(args.slice(1)));
         break;
       // Development
       case "dev":
-        await import("./dev-BHBF4ECH.js").then((m) => m.dev(args.slice(1)));
+        await import("./dev-2HVDP3NX.js").then((m) => m.dev(args.slice(1)));
         break;
       case "run":
-        await import("./run-WIRQDYYX.js").then((m) => m.run(args.slice(1)));
+        await import("./run-47GF5VVS.js").then((m) => m.run(args.slice(1)));
         break;
       // Project
       case "init":
-        await import("./init-OH433IPH.js").then((m) => m.init(args.slice(1)));
+        await import("./init-VNJNSU4Q.js").then((m) => m.init(args.slice(1)));
         break;
       case "templates":
-        await import("./templates-67O6PVFK.js").then((m) => m.templates(args.slice(1)));
+        await import("./templates-6KMZWOYH.js").then((m) => m.templates(subcommand, args.slice(2)));
         break;
       case "status":
         await import("./status-E4IHEUKO.js").then((m) => m.status(args.slice(1)));
@@ -144,10 +259,43 @@ async function main() {
       case "whoami":
         await import("./auth-7RGL7GXU.js").then((m) => m.whoami());
         break;
-      default:
+      // Convenience aliases
+      case "help":
+        showHelp();
+        break;
+      case "version":
+        showVersion();
+        break;
+      default: {
+        const suggestion = suggestCommand(command);
         console.error(pc.red(`Unknown command: ${command}`));
+        if (suggestion) {
+          console.error(`Did you mean ${pc.cyan(suggestion)}?`);
+        }
         console.error(`Run ${pc.cyan("lumera --help")} for usage.`);
         process.exit(1);
+      }
+    }
+    if (!jsonMode) {
+      const elapsed = performance.now() - startTime;
+      if (elapsed >= 500) {
+        console.log(pc.dim(`
+Done in ${formatElapsed(elapsed)}`));
+      }
+    }
+    if (!jsonMode) {
+      try {
+        const update = await Promise.race([
+          updateCheck,
+          new Promise((resolve) => setTimeout(() => resolve(null), 3e3))
+        ]);
+        if (update) {
+          console.log();
+          console.log(`  ${pc.yellow("Update available:")} ${pc.dim(update.current)} \u2192 ${pc.green(update.latest)}`);
+          console.log(`  Run ${pc.cyan("npm i -g @lumerahq/cli")} to update`);
+        }
+      } catch {
+      }
     }
   } catch (error) {
     if (error instanceof Error) {

package/dist/{init-OH433IPH.js → init-VNJNSU4Q.js}

@@ -5,15 +5,47 @@ import {
 import {
   listAllTemplates,
   resolveTemplate
-} from "./chunk-WTDV3MTG.js";
+} from "./chunk-CHRKCAIZ.js";
 import "./chunk-D2BLSEGR.js";
 
 // src/commands/init.ts
-import pc from "picocolors";
+import pc2 from "picocolors";
 import prompts from "prompts";
 import { execSync } from "child_process";
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync } from "fs";
 import { join, resolve } from "path";
+
+// src/lib/spinner.ts
+import pc from "picocolors";
+var frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function spinner(message) {
+  if (!process.stdout.isTTY) {
+    process.stdout.write(`  ${message}
+`);
+    return (doneMessage) => {
+      if (doneMessage) {
+        process.stdout.write(`  ${doneMessage}
+`);
+      }
+    };
+  }
+  let i = 0;
+  const interval = setInterval(() => {
+    const frame = frames[i % frames.length];
+    process.stdout.write(`\r  ${pc.cyan(frame)} ${message}`);
+    i++;
+  }, 80);
+  return (doneMessage) => {
+    clearInterval(interval);
+    process.stdout.write(`\r${" ".repeat(message.length + 10)}\r`);
+    if (doneMessage) {
+      process.stdout.write(`  ${doneMessage}
+`);
+    }
+  };
+}
+
+// src/commands/init.ts
 function toTitleCase(str) {
   return str.split(/[-_]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
@@ -82,13 +114,13 @@ function installUv() {
   try {
     try {
       execSync("curl -LsSf https://astral.sh/uv/install.sh | sh", {
-        stdio: "inherit",
+        stdio: "ignore",
         shell: "/bin/bash"
       });
       return true;
     } catch {
       execSync("wget -qO- https://astral.sh/uv/install.sh | sh", {
-        stdio: "inherit",
+        stdio: "ignore",
         shell: "/bin/bash"
       });
       return true;
@@ -106,12 +138,40 @@ function createPythonVenv(targetDir) {
     return false;
   }
 }
+function detectEditor() {
+  const envEditor = process.env.VISUAL || process.env.EDITOR;
+  if (envEditor) return envEditor;
+  const editors = ["cursor", "code", "zed", "subl"];
+  for (const editor of editors) {
+    try {
+      execSync(`which ${editor}`, { stdio: "ignore" });
+      return editor;
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+function openInEditor(targetDir) {
+  const editor = detectEditor();
+  if (!editor) {
+    console.log(pc2.yellow("  \u26A0"), pc2.dim("No editor detected. Set VISUAL or EDITOR env var."));
+    return;
+  }
+  try {
+    execSync(`${editor} "${targetDir}"`, { stdio: "ignore" });
+    console.log(pc2.green("  \u2713"), pc2.dim(`Opened in ${editor}`));
+  } catch {
+    console.log(pc2.yellow("  \u26A0"), pc2.dim(`Failed to open in ${editor}`));
+  }
+}
 function parseArgs(args) {
   const result = {
     projectName: void 0,
     directory: void 0,
     template: void 0,
-    install: false,
+    install: true,
+    open: false,
     yes: false,
     force: false,
     help: false
@@ -120,8 +180,10 @@ function parseArgs(args) {
     const arg = args[i];
     if (arg === "--help" || arg === "-h") {
       result.help = true;
-    } else if (arg === "--install" || arg === "-i") {
-      result.install = true;
+    } else if (arg === "--no-install") {
+      result.install = false;
+    } else if (arg === "--open" || arg === "-o") {
+      result.open = true;
     } else if (arg === "--yes" || arg === "-y") {
       result.yes = true;
     } else if (arg === "--force" || arg === "-f") {
@@ -138,25 +200,26 @@ function parseArgs(args) {
 }
 function showHelp() {
   console.log(`
-${pc.dim("Usage:")}
+${pc2.dim("Usage:")}
   lumera init [name] [options]
 
-${pc.dim("Description:")}
+${pc2.dim("Description:")}
   Scaffold a new Lumera project from a template.
 
-${pc.dim("Options:")}
-  --template, -t <name>  Template to use (run ${pc.cyan("lumera templates")} to see options)
+${pc2.dim("Options:")}
+  --template, -t <name>  Template to use (run ${pc2.cyan("lumera templates")} to see options)
   --yes, -y              Non-interactive mode (requires project name)
   --dir, -d <path>       Target directory (defaults to project name)
   --force, -f            Overwrite existing directory without prompting
-  --install, -i          Install dependencies after scaffolding
+  --no-install           Skip dependency installation
+  --open, -o             Open project in editor after scaffolding
   --help, -h             Show this help
 
-${pc.dim("Examples:")}
+${pc2.dim("Examples:")}
   lumera init my-app                              # Interactive mode
   lumera init my-app -t invoice-processing        # Use a specific template
   lumera init my-app -y                           # Non-interactive (default template)
-  lumera init my-app -t invoice-processing -y -i  # Full non-interactive setup
+  lumera init my-app -t invoice-processing -y -o  # Full non-interactive + open editor
 `);
 }
 async function init(args) {
@@ -166,34 +229,36 @@ async function init(args) {
     return;
   }
   console.log();
-  console.log(pc.cyan(pc.bold("  Create Lumera App")));
+  console.log(pc2.cyan(pc2.bold("  Create Lumera App")));
   console.log();
   let projectName = opts.projectName;
   let directory = opts.directory;
   const nonInteractive = opts.yes;
   if (nonInteractive && !projectName) {
-    console.log(pc.red("  Error: Project name is required in non-interactive mode"));
-    console.log(pc.dim("  Usage: lumera init <name> -y"));
+    console.log(pc2.red("  Error: Project name is required in non-interactive mode"));
+    console.log(pc2.dim("  Usage: lumera init <name> -y"));
     process.exit(1);
   }
   let templateName = opts.template;
   if (!templateName && !nonInteractive) {
     try {
+      const stop = spinner("Fetching templates...");
       const available = await listAllTemplates();
+      stop();
       if (available.length > 1) {
         const response = await prompts({
           type: "select",
           name: "template",
           message: "Choose a template",
           choices: available.map((t) => ({
-            title: `${t.title} ${pc.dim(`(${t.name})`)}`,
+            title: `${t.title} ${pc2.dim(`(${t.name})`)}`,
             description: t.description,
             value: t.name
           })),
           initial: 0
         });
         if (!response.template) {
-          console.log(pc.red("Cancelled"));
+          console.log(pc2.red("Cancelled"));
           process.exit(1);
         }
         templateName = response.template;
@@ -204,7 +269,9 @@ async function init(args) {
   if (!templateName) {
     templateName = "default";
   }
+  const stopResolve = spinner("Resolving template...");
   const templateDir = await resolveTemplate(templateName);
+  stopResolve();
   if (!projectName) {
     const response = await prompts({
       type: "text",
@@ -220,13 +287,13 @@ async function init(args) {
       }
     });
     if (!response.projectName) {
-      console.log(pc.red("Cancelled"));
+      console.log(pc2.red("Cancelled"));
       process.exit(1);
     }
     projectName = response.projectName;
   }
   if (!/^[a-z0-9-]+$/.test(projectName)) {
-    console.log(pc.red("  Error: Project name must use lowercase letters, numbers, and hyphens only"));
+    console.log(pc2.red("  Error: Project name must use lowercase letters, numbers, and hyphens only"));
     process.exit(1);
   }
   if (!directory) {
@@ -240,7 +307,7 @@ async function init(args) {
         initial: projectName
       });
       if (!response.directory) {
-        console.log(pc.red("Cancelled"));
+        console.log(pc2.red("Cancelled"));
         process.exit(1);
       }
       directory = response.directory;
@@ -253,8 +320,8 @@ async function init(args) {
       if (opts.force) {
         rmSync(targetDir, { recursive: true });
       } else {
-        console.log(pc.red(`  Error: Directory ${directory} already exists`));
-        console.log(pc.dim("  Use --force (-f) to overwrite"));
+        console.log(pc2.red(`  Error: Directory ${directory} already exists`));
+        console.log(pc2.dim("  Use --force (-f) to overwrite"));
         process.exit(1);
       }
     } else {
@@ -265,7 +332,7 @@ async function init(args) {
         initial: false
       });
       if (!overwrite) {
-        console.log(pc.red("Cancelled"));
+        console.log(pc2.red("Cancelled"));
         process.exit(1);
       }
       rmSync(targetDir, { recursive: true });
@@ -274,9 +341,9 @@ async function init(args) {
   mkdirSync(targetDir, { recursive: true });
   console.log();
   if (templateName !== "default") {
-    console.log(pc.dim(`  Creating ${projectName} from template ${pc.cyan(templateName)}...`));
+    console.log(pc2.dim(`  Creating ${projectName} from template ${pc2.cyan(templateName)}...`));
   } else {
-    console.log(pc.dim(`  Creating ${projectName}...`));
+    console.log(pc2.dim(`  Creating ${projectName}...`));
   }
   console.log();
   const vars = {
@@ -290,61 +357,55 @@ async function init(args) {
       if (entry.isDirectory()) {
         listFiles(join(dir, entry.name), relativePath + "/");
       } else {
-        console.log(pc.green("  \u2713"), pc.dim(relativePath));
+        console.log(pc2.green("  \u2713"), pc2.dim(relativePath));
       }
     }
   }
   listFiles(targetDir);
   if (isGitInstalled()) {
-    console.log();
-    console.log(pc.dim("  Initializing git repository..."));
+    const stopGit = spinner("Initializing git repository...");
     if (initGitRepo(targetDir, projectName)) {
-      console.log(pc.green("  \u2713"), pc.dim("Git repository initialized with initial commit"));
+      stopGit(pc2.green("\u2713") + pc2.dim(" Git repository initialized with initial commit"));
     } else {
-      console.log(pc.yellow("  \u26A0"), pc.dim("Failed to initialize git repository"));
+      stopGit(pc2.yellow("\u26A0") + pc2.dim(" Failed to initialize git repository"));
     }
   } else {
-    console.log();
-    console.log(pc.yellow("  \u26A0"), pc.dim("Git not found - skipping repository initialization"));
+    console.log(pc2.yellow("  \u26A0"), pc2.dim("Git not found \u2014 skipping repository initialization"));
   }
   let uvAvailable = isUvInstalled();
   if (!uvAvailable) {
-    console.log();
-    console.log(pc.dim("  Installing uv (Python package manager)..."));
+    const stopUv = spinner("Installing uv (Python package manager)...");
     if (installUv()) {
-      console.log(pc.green("  \u2713"), pc.dim("uv installed successfully"));
+      stopUv(pc2.green("\u2713") + pc2.dim(" uv installed successfully"));
       uvAvailable = true;
     } else {
-      console.log(pc.yellow("  \u26A0"), pc.dim("Failed to install uv - install manually: https://docs.astral.sh/uv/"));
+      stopUv(pc2.yellow("\u26A0") + pc2.dim(" Failed to install uv \u2014 install manually: https://docs.astral.sh/uv/"));
     }
   }
   if (uvAvailable) {
-    console.log();
-    console.log(pc.dim("  Creating Python venv with Lumera SDK..."));
+    const stopVenv = spinner("Creating Python venv with Lumera SDK...");
     if (createPythonVenv(targetDir)) {
-      console.log(pc.green("  \u2713"), pc.dim("Python venv created (.venv/) with lumera SDK"));
+      stopVenv(pc2.green("\u2713") + pc2.dim(" Python venv created (.venv/) with lumera SDK"));
     } else {
-      console.log(pc.yellow("  \u26A0"), pc.dim("Failed to create Python venv"));
+      stopVenv(pc2.yellow("\u26A0") + pc2.dim(" Failed to create Python venv"));
     }
   }
   if (opts.install) {
-    console.log();
-    console.log(pc.dim("  Installing dependencies..."));
+    const stopInstall = spinner("Installing dependencies...");
     try {
-      execSync("pnpm install", { cwd: targetDir, stdio: "inherit" });
-      console.log(pc.green("  \u2713"), pc.dim("Dependencies installed"));
+      execSync("pnpm install", { cwd: targetDir, stdio: "ignore" });
+      stopInstall(pc2.green("\u2713") + pc2.dim(" Dependencies installed"));
     } catch {
-      console.log(pc.yellow("  \u26A0"), pc.dim("Failed to install dependencies"));
+      stopInstall(pc2.yellow("\u26A0") + pc2.dim(" Failed to install dependencies"));
     }
   }
-  console.log();
-  console.log(pc.dim("  Installing Lumera skills for AI agents..."));
+  const stopSkills = spinner("Installing Lumera skills for AI agents...");
   try {
     const { installed, failed } = await installAllSkills(targetDir);
     if (failed > 0) {
-      console.log(pc.yellow("  \u26A0"), pc.dim(`Installed ${installed} skills (${failed} failed)`));
+      stopSkills(pc2.yellow("\u26A0") + pc2.dim(` Installed ${installed} skills (${failed} failed)`));
     } else {
-      console.log(pc.green("  \u2713"), pc.dim(`${installed} Lumera skills installed`));
+      stopSkills(pc2.green("\u2713") + pc2.dim(` ${installed} Lumera skills installed`));
     }
     syncClaudeMd(targetDir);
     if (isGitInstalled()) {
@@ -357,20 +418,22 @@ async function init(args) {
       }
     }
   } catch (err) {
-    console.log(pc.yellow("  \u26A0"), pc.dim(`Failed to install skills: ${err}`));
+    stopSkills(pc2.yellow("\u26A0") + pc2.dim(` Failed to install skills: ${err}`));
   }
   console.log();
-  console.log(pc.green(pc.bold("  Done!")), "Next steps:");
+  console.log(pc2.green(pc2.bold("  Done!")), "Next steps:");
   console.log();
-  console.log(pc.cyan(`  cd ${directory}`));
+  console.log(pc2.cyan(`  cd ${directory}`));
   if (!opts.install) {
-    console.log(pc.cyan("  pnpm install"));
+    console.log(pc2.cyan("  pnpm install"));
   }
-  console.log(pc.cyan("  lumera login"));
-  console.log(pc.cyan("  lumera apply"));
-  console.log(pc.cyan("  lumera run scripts/seed-demo.py"));
-  console.log(pc.cyan("  lumera dev"));
+  console.log(pc2.cyan("  lumera login"));
+  console.log(pc2.cyan("  lumera dev"));
   console.log();
+  if (opts.open) {
+    openInEditor(targetDir);
+    console.log();
+  }
 }
 export {
   init

package/dist/{resources-PGBVCS2K.js → resources-GTG3QMVV.js}

@@ -2,11 +2,9 @@ import {
   deploy
 } from "./chunk-CDZZ3JYU.js";
 import {
-  createApiClient
-} from "./chunk-WRAZC6SJ.js";
-import {
+  createApiClient,
   loadEnv
-} from "./chunk-2CR762KB.js";
+} from "./chunk-HIYM7EM2.js";
 import {
   getToken
 } from "./chunk-NDLYGKS6.js";

package/dist/{run-WIRQDYYX.js → run-47GF5VVS.js}

@@ -1,9 +1,7 @@
 import {
-  createApiClient
-} from "./chunk-WRAZC6SJ.js";
-import {
+  createApiClient,
   loadEnv
-} from "./chunk-2CR762KB.js";
+} from "./chunk-HIYM7EM2.js";
 import {
   getToken
 } from "./chunk-NDLYGKS6.js";

package/dist/templates-6KMZWOYH.js

@@ -0,0 +1,194 @@
+import {
+  listAllTemplates
+} from "./chunk-CHRKCAIZ.js";
+
+// src/commands/templates.ts
+import pc from "picocolors";
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { join, resolve, extname } from "path";
+function showHelp() {
+  console.log(`
+${pc.dim("Usage:")}
+  lumera templates <command> [options]
+
+${pc.dim("Commands:")}
+  list, ls               List available templates (default)
+  validate [dir]         Validate a template directory
+
+${pc.dim("Options:")}
+  --verbose, -v          Show full descriptions (list)
+  --help, -h             Show this help
+
+${pc.dim("Examples:")}
+  lumera templates                              # List available templates
+  lumera templates list -v                      # Show with descriptions
+  lumera templates validate ./my-template       # Validate a template dir
+  lumera init my-app -t invoice-processing      # Use a template
+`);
+}
+async function list(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    showHelp();
+    return;
+  }
+  const verbose = args.includes("--verbose") || args.includes("-v");
+  try {
+    const allTemplates = await listAllTemplates();
+    if (process.env.LUMERA_JSON) {
+      console.log(JSON.stringify(allTemplates, null, 2));
+      return;
+    }
+    console.log();
+    console.log(pc.cyan(pc.bold("  Available Templates")));
+    console.log();
+    if (allTemplates.length === 0) {
+      console.log(pc.dim("  No templates available."));
+      console.log();
+      return;
+    }
+    const byCategory = /* @__PURE__ */ new Map();
+    for (const t of allTemplates) {
+      const cat = t.category || "General";
+      if (!byCategory.has(cat)) byCategory.set(cat, []);
+      byCategory.get(cat).push(t);
+    }
+    for (const [category, items] of byCategory) {
+      console.log(pc.bold(`  ${category}`));
+      console.log();
+      for (const t of items) {
+        console.log(`    ${pc.green(t.title)} ${pc.dim(`(${t.name})`)}`);
+        if (verbose) {
+          console.log(`    ${pc.dim(t.description)}`);
+          console.log();
+        }
+      }
+      if (!verbose) console.log();
+    }
+    console.log(pc.dim(`  ${allTemplates.length} template${allTemplates.length === 1 ? "" : "s"} available.`));
+    console.log();
+    console.log(pc.dim("  Usage:"), pc.cyan("lumera init <name> --template <template-name>"));
+    console.log();
+  } catch (err) {
+    console.error(pc.red(`  Error: ${err}`));
+    process.exit(1);
+  }
+}
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".venv", "dist", "__pycache__", ".tanstack"]);
+var TEXT_EXTS = /* @__PURE__ */ new Set([".json", ".ts", ".tsx", ".js", ".jsx", ".py", ".md", ".html", ".css", ".yaml", ".yml", ".toml"]);
+function scanForPlaceholders(dir, prefix = "") {
+  const results = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (SKIP_DIRS.has(entry.name)) continue;
+    const fullPath = join(dir, entry.name);
+    const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      results.push(...scanForPlaceholders(fullPath, relativePath));
+    } else {
+      const ext = extname(entry.name);
+      if (!TEXT_EXTS.has(ext)) continue;
+      if (entry.name === "template.json") continue;
+      try {
+        const content = readFileSync(fullPath, "utf-8");
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+          const matches = lines[i].match(/\{\{[^}]+\}\}/g);
+          if (matches) {
+            for (const match of matches) {
+              if (match.includes(":")) continue;
+              results.push({ file: relativePath, line: i + 1, text: match });
+            }
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  return results;
+}
+async function validate(args) {
+  const dir = args.find((a) => !a.startsWith("-")) || ".";
+  const targetDir = resolve(process.cwd(), dir);
+  console.log();
+  console.log(pc.cyan(pc.bold("  Validate Template")));
+  console.log(pc.dim(`  Directory: ${targetDir}`));
+  console.log();
+  const issues = [];
+  const warnings = [];
+  const templateJsonPath = join(targetDir, "template.json");
+  if (!existsSync(templateJsonPath)) {
+    issues.push("Missing template.json");
+  } else {
+    try {
+      const meta = JSON.parse(readFileSync(templateJsonPath, "utf-8"));
+      const required = ["name", "title", "description", "category"];
+      for (const field of required) {
+        if (!meta[field]) {
+          issues.push(`template.json: missing required field "${field}"`);
+        }
+      }
+    } catch {
+      issues.push("template.json: invalid JSON");
+    }
+  }
+  if (!existsSync(join(targetDir, "package.json"))) {
+    issues.push("Missing package.json");
+  }
+  if (!existsSync(join(targetDir, "platform"))) {
+    warnings.push("Missing platform/ directory");
+  } else if (!existsSync(join(targetDir, "platform", "collections"))) {
+    warnings.push("platform/ has no collections/ subdirectory");
+  }
+  const stalePatterns = scanForPlaceholders(targetDir);
+  for (const match of stalePatterns) {
+    warnings.push(`Stale placeholder: ${match.file}:${match.line} \u2014 ${match.text}`);
+  }
+  if (issues.length === 0 && warnings.length === 0) {
+    console.log(pc.green("  \u2713 Template is valid"));
+    console.log();
+    return;
+  }
+  if (issues.length > 0) {
+    console.log(pc.red(`  ${issues.length} error${issues.length > 1 ? "s" : ""}:`));
+    for (const issue of issues) {
+      console.log(pc.red(`    \u2717 ${issue}`));
+    }
+    console.log();
+  }
+  if (warnings.length > 0) {
+    console.log(pc.yellow(`  ${warnings.length} warning${warnings.length > 1 ? "s" : ""}:`));
+    for (const warning of warnings) {
+      console.log(pc.yellow(`    \u26A0 ${warning}`));
+    }
+    console.log();
+  }
+  if (issues.length > 0) {
+    process.exit(1);
+  }
+}
+async function templates(subcommand, args) {
+  if (subcommand === "--help" || subcommand === "-h") {
+    showHelp();
+    return;
+  }
+  const cmd = subcommand || "list";
+  switch (cmd) {
+    case "list":
+    case "ls":
+      await list(args);
+      break;
+    case "validate":
+      await validate(args);
+      break;
+    default:
+      if (cmd.startsWith("-")) {
+        await list([cmd, ...args]);
+        break;
+      }
+      console.error(pc.red(`Unknown templates command: ${cmd}`));
+      console.error(`Run ${pc.cyan("lumera templates --help")} for usage.`);
+      process.exit(1);
+  }
+}
+export {
+  templates
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumerahq/cli",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "CLI for building and deploying Lumera apps",
   "type": "module",
   "engines": {

package/dist/chunk-2CR762KB.js

@@ -1,18 +0,0 @@
-// src/lib/env.ts
-import { config } from "dotenv";
-import { existsSync } from "fs";
-import { resolve } from "path";
-function loadEnv(cwd = process.cwd()) {
-  const envPath = resolve(cwd, ".env");
-  const envLocalPath = resolve(cwd, ".env.local");
-  if (existsSync(envPath)) {
-    config({ path: envPath });
-  }
-  if (existsSync(envLocalPath)) {
-    config({ path: envLocalPath, override: true });
-  }
-}
-
-export {
-  loadEnv
-};

package/dist/dev-BHBF4ECH.js

@@ -1,87 +0,0 @@
-import {
-  dev
-} from "./chunk-CDZZ3JYU.js";
-import {
-  loadEnv
-} from "./chunk-2CR762KB.js";
-import {
-  getToken
-} from "./chunk-NDLYGKS6.js";
-import {
-  findProjectRoot,
-  getApiUrl,
-  getAppName,
-  getAppTitle
-} from "./chunk-D2BLSEGR.js";
-
-// src/commands/dev.ts
-import pc from "picocolors";
-function parseFlags(args) {
-  const result = {};
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg.startsWith("--")) {
-      const key = arg.slice(2);
-      const next = args[i + 1];
-      if (next && !next.startsWith("--")) {
-        result[key] = next;
-        i++;
-      } else {
-        result[key] = true;
-      }
-    }
-  }
-  return result;
-}
-function showHelp() {
-  console.log(`
-${pc.dim("Usage:")}
-  lumera dev [options]
-
-${pc.dim("Description:")}
-  Start the development server with Lumera registration.
-  Registers your app with Lumera and starts a local dev server.
-
-${pc.dim("Options:")}
-  --port <number>        Dev server port (default: 8080)
-  --url <url>            App URL for dev mode (default: http://localhost:{port})
-  --help, -h             Show this help
-
-${pc.dim("Environment variables:")}
-  LUMERA_TOKEN           API token (overrides \`lumera login\`)
-  LUMERA_API_URL         API base URL (default: https://app.lumerahq.com/api)
-  PORT                   Dev server port (default: 8080)
-  APP_URL                App URL for dev mode
-
-${pc.dim("Examples:")}
-  lumera dev                    # Start dev server on port 8080
-  lumera dev --port 3000        # Start dev server on port 3000
-  lumera dev --url http://192.168.1.100:8080  # Custom URL for mobile testing
-`);
-}
-async function dev2(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    showHelp();
-    return;
-  }
-  const flags = parseFlags(args);
-  const projectRoot = findProjectRoot();
-  loadEnv(projectRoot);
-  const token = getToken(projectRoot);
-  const appName = getAppName(projectRoot);
-  const appTitle = getAppTitle(projectRoot);
-  const apiUrl = getApiUrl();
-  const port = Number(flags.port || process.env.PORT || "8080");
-  const appUrl = typeof flags.url === "string" ? flags.url : process.env.APP_URL;
-  await dev({
-    token,
-    appName,
-    appTitle,
-    port,
-    appUrl,
-    apiUrl
-  });
-}
-export {
-  dev2 as dev
-};

package/dist/templates-67O6PVFK.js

@@ -1,70 +0,0 @@
-import {
-  listAllTemplates
-} from "./chunk-WTDV3MTG.js";
-
-// src/commands/templates.ts
-import pc from "picocolors";
-function showHelp() {
-  console.log(`
-${pc.dim("Usage:")}
-  lumera templates [options]
-
-${pc.dim("Description:")}
-  List available project templates.
-
-${pc.dim("Options:")}
-  --verbose, -v          Show full descriptions
-  --help, -h             Show this help
-
-${pc.dim("Examples:")}
-  lumera templates                              # List available templates
-  lumera templates -v                            # Show with descriptions
-  lumera init my-app -t invoice-processing       # Use a template
-`);
-}
-async function templates(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    showHelp();
-    return;
-  }
-  const verbose = args.includes("--verbose") || args.includes("-v");
-  console.log();
-  console.log(pc.cyan(pc.bold("  Available Templates")));
-  console.log();
-  try {
-    const allTemplates = await listAllTemplates();
-    if (allTemplates.length === 0) {
-      console.log(pc.dim("  No templates available."));
-      console.log();
-      return;
-    }
-    const byCategory = /* @__PURE__ */ new Map();
-    for (const t of allTemplates) {
-      const cat = t.category || "General";
-      if (!byCategory.has(cat)) byCategory.set(cat, []);
-      byCategory.get(cat).push(t);
-    }
-    for (const [category, items] of byCategory) {
-      console.log(pc.bold(`  ${category}`));
-      console.log();
-      for (const t of items) {
-        console.log(`    ${pc.green(t.title)} ${pc.dim(`(${t.name})`)}`);
-        if (verbose) {
-          console.log(`    ${pc.dim(t.description)}`);
-          console.log();
-        }
-      }
-      if (!verbose) console.log();
-    }
-    console.log(pc.dim(`  ${allTemplates.length} template${allTemplates.length === 1 ? "" : "s"} available.`));
-    console.log();
-    console.log(pc.dim("  Usage:"), pc.cyan("lumera init <name> --template <template-name>"));
-    console.log();
-  } catch (err) {
-    console.error(pc.red(`  Error: ${err}`));
-    process.exit(1);
-  }
-}
-export {
-  templates
-};