@stacksjs/buddy 0.70.160 → 0.70.162

package/README.md

@@ -35,7 +35,7 @@ curl -Ssf stacksjs.com/install | sh # wip
 
 # alternatively, if Bun >= v1.1.11 is installed already
 # you may also get started via
-bunx stacks new my-project
+panx @stacksjs/buddy new my-project
 ```
 
 ## Usage
@@ -79,7 +79,7 @@ buddy --help # view help menu
 # `command --help` flag to review the help menu
 
 buddy install # installs dependencies
-buddy add # adds a stack or dependency
+buddy add calendar # pulls a registered project-shaped stack into this project
 buddy fresh # fresh reinstall of all deps
 buddy clean # removes all deps
 buddy setup # sets up the project initially
@@ -126,7 +126,7 @@ buddy build:views # builds SSG views
 buddy build:desktop # builds Desktop application
 buddy build:library # builds any or all libraries
 buddy build:functions # builds function library
-buddy build:components # builds Vue component library & Web Component library
+buddy build:components # builds the STX component library and Web Component library
 buddy build:web-components # builds framework agnostic Web Component library (i.e. Custom Elements)
 buddy build:all # builds all your code
 
@@ -154,7 +154,7 @@ buddy make:factory cars # creates a Car factory file
 buddy make:table cars # bootstraps a cars data table
 buddy make:notification welcome-email # bootstraps a welcome-email notification
 buddy make:lang de # bootstraps a lang/de.yml language file
-buddy make:stack my-project # shares logic with `bunx stacks new my-project`
+buddy make:stack my-project # scaffolds a project-shaped registry stack
 
 buddy migrate # runs database migrations
 buddy migrate:dns # sets the ./config/dns.ts file
@@ -192,7 +192,6 @@ buddy cloud:add --jump-box # adds a jump box to your cloud setup
 
 # select the example to run (follow CLI prompts)
 buddy example # prompts you to select which example to run
-buddy example:vue # runs the Vue example
 buddy example:web-components # runs the Web Component example
 
 # you likely won’t need to run these commands as they are auto-triggered, but they are available
@@ -250,7 +249,7 @@ _Develop dynamic UIs with helpers for atomic design, and much more._
 - 🖥️ **Desktop** _transforms your web app into a desktop app, plus more_
 - 📝 **Documentation** _markdown-based documentation, auto-generated_
 - 📚 **Library** _auto-builds & manages component & function libraries_
-- ⚡️ Powered by Bun, Tauri, Headwind, Vite, VitePress and Vue
+- ⚡️ Powered by Bun, STX, Tauri, Crosswind, and BunPress
 
 ### Backend Development
 
@@ -274,7 +273,6 @@ _Develop serverless (or server) functions with countless helpers to build scalab
 - 💾 **Storage** _a secure-by-default File API that feels right_
 - 🧪 **Tinker** _a powerful TypeScript REPL_
 - 🌪️ **Validation** _e2e type-safety (true frontend & backend harmony)_
-- 🎯 **X-Ray** _all you need to debug, log & analyze_
 
 ### Cloud Development
 
@@ -314,7 +312,7 @@ Convention over configuration, while staying wholly configurable. _No more boile
 - 🚗 **Auto Imports** _your components & functions, including date, string, array, & object helpers_
 - ⏩ **Code Snippets** _goodbye to the boilerplate code—thank you Sarah Drasner_
 - 🔤 **Spell Checker** _be notified once there are typos_
-- 🛠️ **Essential Utilities** _powers at your fingertips. Collections, VueUse, and more_
+- 🛠️ **Essential Utilities** _powers at your fingertips. Collections, STX composables, and more_
 - 👥 **Team Management** _manage your team & their permissions_
 - 🧪 **Streamlined Testing** _unit & e2e tests powered by Bun, Vitest & Playwright_
 

package/dist/cli.js

@@ -3,6 +3,7 @@ import process from "node:process";
 import { cli, log } from "@stacksjs/cli";
 import { path as p } from "@stacksjs/path";
 import { registerGlobalOptions } from "./global-options";
+import { shouldSkipAppKeyCheck } from "./project-setup";
 try {
   const { isSupportedBunVersion, minimumBunVersion } = await import("@stacksjs/utils"), currentBunVersion = typeof Bun < "u" ? Bun.version : process.versions.bun;
   if (currentBunVersion && !isSupportedBunVersion(currentBunVersion)) {
@@ -10,35 +11,7 @@ try {
     process.exit(1);
   }
 } catch {}
-const args = process.argv.slice(2), requestedCommand = args[0] || "help", isHelpFlag = args.includes("--help") || args.includes("-h"), isVersionOnly = ["--version", "-V", "version"].includes(requestedCommand), isHelpMode = requestedCommand === "help" || isHelpFlag && args.length <= 2, skipAppKeyCheck = [
-  "build",
-  "lint",
-  "lint:fix",
-  "test",
-  "test:types",
-  "test:unit",
-  "test:feature",
-  "typecheck",
-  "types:fix",
-  "types:generate",
-  "clean",
-  "fresh",
-  "about",
-  "doctor",
-  "setup",
-  "setup:ssl",
-  "setup:oh-my-zsh",
-  "deploy",
-  "serve",
-  "new",
-  "create",
-  "migrate",
-  "seed",
-  "generate",
-  "make",
-  "key:generate",
-  "scaffold:crud"
-].some((cmd) => requestedCommand === cmd || requestedCommand.startsWith(`${cmd}:`)) || isHelpFlag || isHelpMode, needsFullSetup = !isVersionOnly;
+const args = process.argv.slice(2), requestedCommand = args[0] || "help", isHelpFlag = args.includes("--help") || args.includes("-h"), isVersionOnly = ["--version", "-V", "version"].includes(requestedCommand), isHelpMode = requestedCommand === "help" || isHelpFlag && args.length <= 2, skipAppKeyCheck = shouldSkipAppKeyCheck(requestedCommand, { isHelpFlag, isHelpMode }), needsFullSetup = !isVersionOnly;
 if (needsFullSetup) {
   const reportFatal = (label, error) => {
     log.debug(`Buddy ${label}`);

package/dist/commands/add.js

@@ -1,33 +1,25 @@
 import process from "node:process";
-import { runAdd } from "@stacksjs/actions";
-import { log } from "@stacksjs/logging";
+import { installStack } from "@stacksjs/actions";
+import { intro, italic, log, onUnknownSubcommand, outro } from "@stacksjs/cli";
 import { ExitCode } from "@stacksjs/types";
-import { onUnknownSubcommand } from "@stacksjs/cli";
 export function add(buddy) {
-  const descriptions = {
-    add: "Add a stack to your project (table and calendar available, more coming soon)",
-    table: "Add the Table Stack to your project",
-    calendar: "Add the Calendar Stack to your project",
-    all: "Add all stacks",
-    select: "Which stack/s are you trying to add?",
-    project: "Target a specific project",
-    verbose: "Enable verbose output"
-  };
-  buddy.command("add", descriptions.add).option("-t, --table", descriptions.table, { default: !1 }).option("-c, --calendar", descriptions.calendar, { default: !1 }).option("-a, --all", descriptions.all, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    log.debug("Running `buddy add`...", options);
-    if (hasNoOptions(options))
-      ;
-    await runAdd(options);
+  buddy.command("add <stack>", "Pull a registered stack and merge its project files into this Stacks application").option("--force", "Overwrite existing files", { default: !1 }).option("--dry-run", "Show which files would be installed without changing the project", { default: !1 }).option("--conflict <strategy>", "Resolve existing files with skip, overwrite, or backup", { default: "skip" }).option("-p, --project <path>", "Target a specific Stacks project").option("--verbose", "Show every file copied or skipped", { default: !1 }).example("buddy add calendar").example("buddy add table --dry-run").example("buddy add calendar --conflict backup").action(async (stack, options) => {
+    const perf = await intro("buddy add");
+    if (!await installStack({
+      name: stack,
+      force: options.force,
+      dryRun: options.dryRun,
+      conflict: options.conflict,
+      project: options.project,
+      verbose: options.verbose
+    })) {
+      await outro(`Could not add stack ${italic(stack)}.`, { startTime: perf, useSeconds: !0 });
+      process.exit(ExitCode.FatalError);
+    }
+    if (options.dryRun)
+      log.info("Dry run complete. No project files were changed.");
+    await outro(`Stack ${italic(stack)} added.`, { startTime: perf, useSeconds: !0 });
     process.exit(ExitCode.Success);
   });
-  buddy.command("add:table", descriptions.table).option("-t, --table", descriptions.table, { default: !0 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    await runAdd(options);
-  });
-  buddy.command("add:calendar", descriptions.calendar).option("-t, --calendar", descriptions.calendar, { default: !0 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    await runAdd(options);
-  });
   onUnknownSubcommand(buddy, "add");
 }
-function hasNoOptions(options) {
-  return !options.all && !options.table && !options.calendar;
-}

package/dist/commands/build.d.ts

@@ -1,2 +1,3 @@
-import type { CLI } from '@stacksjs/types';
+import type { BuildOptions, CLI } from '@stacksjs/types';
 export declare function build(buddy: CLI): void;
+export declare function applyBuildTarget(target: string | undefined, options: BuildOptions): void;

package/dist/commands/build.js

@@ -28,39 +28,9 @@ export function build(buddy) {
     project: "Target a specific project",
     verbose: "Enable verbose output"
   };
-  buddy.command("build [type]", descriptions.build).option("-c, --components", descriptions.components).option("-w, --web-components", descriptions.webComponents).option("-e, --elements", descriptions.elements).option("-f, --functions", descriptions.functions).option("-p, --views", descriptions.pages).option("--pages", descriptions.pages).option("-d, --docs", descriptions.docs).option("-b, --buddy", descriptions.buddy, { default: !1 }).option("-s, --stacks", descriptions.framework, { default: !1 }).option("--project [project]", descriptions.project, { default: !1 }).option("--server", descriptions.server, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (server, options) => {
+  buddy.command("build [type]", descriptions.build).option("-c, --components", descriptions.components).option("-w, --web-components", descriptions.webComponents).option("-e, --elements", descriptions.elements).option("-f, --functions", descriptions.functions).option("-k, --desktop", descriptions.desktop).option("-p, --views", descriptions.pages).option("--pages", descriptions.pages).option("-d, --docs", descriptions.docs).option("-b, --buddy", descriptions.buddy, { default: !1 }).option("-s, --stacks", descriptions.framework, { default: !1 }).option("--project [project]", descriptions.project, { default: !1 }).option("--server", descriptions.server, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (server, options) => {
     log.debug("Running `buddy build` ...", options);
-    switch (server) {
-      case "components":
-        options.components = !0;
-        break;
-      case "web-components":
-        options.webComponents = !0;
-        break;
-      case "functions":
-        options.functions = !0;
-        break;
-      case "views":
-        options.views = !0;
-        break;
-      case "docs":
-        options.docs = !0;
-        break;
-      case "buddy":
-        options.buddy = !0;
-        break;
-      case "cli":
-        options.buddy = !0;
-        break;
-      case "stacks":
-        options.stacks = !0;
-        break;
-      case "server":
-        options.server = !0;
-        break;
-      default:
-        break;
-    }
+    applyBuildTarget(server, options);
     if (hasNoOptions(options)) {
       if (!isCI && hasTTY && process.stdin.isTTY) {
         const answers = await multiselect({
@@ -70,6 +40,7 @@ export function build(buddy) {
             { label: "Components", value: "components" },
             { label: "Web Components", value: "webComponents" },
             { label: "Functions", value: "functions" },
+            { label: "Desktop application", value: "desktop" },
             { label: "Documentation", value: "docs" },
             { label: "Stacks framework", value: "stacks" },
             { label: "Buddy CLI", value: "buddy" },
@@ -84,6 +55,8 @@ export function build(buddy) {
           options.webComponents = !0;
         if (selected.has("functions"))
           options.functions = !0;
+        if (selected.has("desktop"))
+          options.desktop = !0;
         if (selected.has("docs"))
           options.docs = !0;
         if (selected.has("stacks"))
@@ -107,6 +80,8 @@ export function build(buddy) {
       succeeded = await runBuildAction(Action.BuildWebComponentLib, "web component library") && succeeded;
     if (options.functions)
       succeeded = await runBuildAction(Action.BuildFunctionLib, "function library") && succeeded;
+    if (options.desktop)
+      succeeded = await runBuildAction(Action.BuildDesktop, "desktop application") && succeeded;
     if (options.views)
       succeeded = await runBuildAction(Action.BuildViews, "frontend") && succeeded;
     if (options.stacks)
@@ -188,7 +163,39 @@ export function build(buddy) {
   onUnknownSubcommand(buddy, "build");
 }
 function hasNoOptions(options) {
-  return !options.components && !options.webComponents && !options.elements && !options.functions && !options.views && !options.docs && !options.stacks && !options.buddy && !options.server;
+  return !options.components && !options.webComponents && !options.elements && !options.functions && !options.desktop && !options.views && !options.docs && !options.stacks && !options.buddy && !options.server;
+}
+export function applyBuildTarget(target, options) {
+  switch (target) {
+    case "components":
+      options.components = !0;
+      break;
+    case "web-components":
+      options.webComponents = !0;
+      break;
+    case "functions":
+      options.functions = !0;
+      break;
+    case "desktop":
+      options.desktop = !0;
+      break;
+    case "views":
+      options.views = !0;
+      break;
+    case "docs":
+      options.docs = !0;
+      break;
+    case "buddy":
+    case "cli":
+      options.buddy = !0;
+      break;
+    case "stacks":
+      options.stacks = !0;
+      break;
+    case "server":
+      options.server = !0;
+      break;
+  }
 }
 async function runBuildAction(action, target) {
   const result = await runAction(action);

package/dist/commands/create.js

@@ -15,7 +15,6 @@ export function create(buddy) {
     ui: "Are you building a UI?",
     components: "Are you building UI components?",
     webComponents: "Automagically built optimized custom elements/web components?",
-    vue: "Automagically built a Vue component library?",
     views: "How about views?",
     functions: "Are you developing functions/composables?",
     api: "Are you building an API?",
@@ -27,7 +26,7 @@ export function create(buddy) {
     minimal: "Skip optional feature bundles (cms, commerce, dashboard, marketing, monitoring, realtime, queue) \u2014 bare-bones API/SPA starter that can re-add them later via `./buddy <feature>:install`.",
     verbose: "Enable verbose output"
   };
-  buddy.command("new [name]", descriptions.command).alias("create [name]").option("-n, --name [name]", descriptions.name, { default: !1 }).option("-u, --ui", descriptions.ui, { default: !0 }).option("-c, --components", descriptions.components, { default: !0 }).option("-w, --web-components", descriptions.webComponents, { default: !0 }).option("--vue", descriptions.vue, { default: !0 }).option("-p, --views", descriptions.views, { default: !0 }).option("-f, --functions", descriptions.functions, { default: !0 }).option("-a, --api", descriptions.api, { default: !0 }).option("-d, --database", descriptions.database, { default: !0 }).option("-ca, --cache", descriptions.cache, { default: !1 }).option("-e, --email", descriptions.email, { default: !1 }).option("-P, --project [project]", descriptions.project, { default: !1 }).option("-m, --minimal", descriptions.minimal, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (name, options) => {
+  buddy.command("new [name]", descriptions.command).alias("create [name]").option("-n, --name [name]", descriptions.name, { default: !1 }).option("-u, --ui", descriptions.ui, { default: !0 }).option("-c, --components", descriptions.components, { default: !0 }).option("-w, --web-components", descriptions.webComponents, { default: !0 }).option("-p, --views", descriptions.views, { default: !0 }).option("-f, --functions", descriptions.functions, { default: !0 }).option("-a, --api", descriptions.api, { default: !0 }).option("-d, --database", descriptions.database, { default: !0 }).option("-ca, --cache", descriptions.cache, { default: !1 }).option("-e, --email", descriptions.email, { default: !1 }).option("-P, --project [project]", descriptions.project, { default: !1 }).option("-m, --minimal", descriptions.minimal, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (name, options) => {
     log.debug("Running `buddy new <name>` ...", options);
     const startTime = await intro("buddy new");
     name = name ?? options.name;
@@ -104,14 +103,8 @@ async function ensureEnv(path, _options) {
 }
 async function install(path, options) {
   log.info("Installing & setting up Stacks");
-  log.info("Running bun install...");
-  let result = await runCommand("bun install", { ...options, cwd: path });
-  if (result?.isErr) {
-    log.error(result.error);
-    process.exit(ExitCode.FatalError);
-  }
   log.info("Copying .env.example \u2192 .env");
-  result = await runCommand("cp .env.example .env", { ...options, cwd: path });
+  let result = await runCommand("cp .env.example .env", { ...options, cwd: path });
   if (result?.isErr) {
     log.error(result.error);
     process.exit(ExitCode.FatalError);

package/dist/commands/dev.js

@@ -159,7 +159,7 @@ export function dev(buddy) {
   });
   buddy.command("dev:components", descriptions.components).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
     const perf = await intro("buddy dev:components"), result = await runCommand("bun run dev", {
-      cwd: libsPath("components/vue")
+      cwd: libsPath("components/stx")
     });
     if (options.verbose)
       log.info("buddy dev:components result", result);
@@ -277,7 +277,6 @@ export async function startDevelopmentServer(_options, _startTime) {
   process.on("SIGTERM", cleanup);
   process.on("SIGHUP", cleanup);
   const quietOpts = { ...options, quiet: !0 }, a = await actions(), ports = [
-    { name: "Frontend", port: frontendPort },
     { name: "API", port: apiPort }
   ], readinessTimeoutMs = 30000;
   let readyAnnounced = !1;

package/dist/commands/list.d.ts

@@ -1,2 +1,27 @@
 import type { CLI } from '@stacksjs/types';
+import type { Command } from '@stacksjs/clapp';
 export declare function list(buddy: CLI): void;
+export declare function commandInventoryEntry(command: Command): BuddyCommandInventoryEntry;
+export declare interface BuddyCommandInventoryOption {
+  name: string
+  flags: string[]
+  description: string
+  required: boolean
+  boolean: boolean
+  negated: boolean
+  default?: unknown
+}
+export declare interface BuddyCommandInventoryEntry {
+  name: string
+  description: string
+  aliases: string[]
+  namespace?: string
+  usage: string
+  arguments: Array<{
+    name: string
+    required: boolean
+    variadic: boolean
+  }>
+  options: BuddyCommandInventoryOption[]
+  examples: string[]
+}

package/dist/commands/list.js

@@ -9,16 +9,17 @@ export function list(buddy) {
     filter: "Filter commands by name or group",
     namespace: "Filter commands by namespace (e.g., make, env, db)",
     grouped: "Group commands by category",
-    format: "Output format (text, json)"
+    format: "Output format (text, json)",
+    json: "Output the complete command inventory as JSON"
   };
-  buddy.command("list", descriptions.list).option("-p, --project [project]", descriptions.project, { default: !1 }).option("-f, --filter [filter]", descriptions.filter).option("-n, --namespace [namespace]", descriptions.namespace).option("-g, --grouped", descriptions.grouped, { default: !0 }).option("--format [format]", descriptions.format, { default: "text" }).option("--verbose", descriptions.verbose, { default: !1 }).example("buddy list").example("buddy list --filter=make").example("buddy list --namespace=make").example("buddy list --namespace=env").example("buddy list --no-grouped").example("buddy list --format=json").action(async (options) => {
+  buddy.command("list", descriptions.list).option("-p, --project [project]", descriptions.project, { default: !1 }).option("-f, --filter [filter]", descriptions.filter).option("-n, --namespace [namespace]", descriptions.namespace).option("-g, --grouped", descriptions.grouped, { default: !0 }).option("--format [format]", descriptions.format, { default: "text" }).option("-J, --json", descriptions.json, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).example("buddy list").example("buddy list --filter=make").example("buddy list --namespace=make").example("buddy list --namespace=env").example("buddy list --no-grouped").example("buddy list --format=json").example("buddy list --json").action(async (options) => {
     log.debug("Running `buddy list` ...", options);
     const { bold, dim, green } = await import("@stacksjs/cli"), commands = buddy.commands || [];
     let filteredCommands = commands;
     if (options.filter) {
       const filterStr = String(options.filter).toLowerCase();
       filteredCommands = commands.filter((cmd) => {
-        const name = cmd.name || "", desc = cmd.description || "";
+        const name = canonicalCommandName(cmd), desc = cmd.description || "";
         return name.toLowerCase().includes(filterStr) || desc.toLowerCase().includes(filterStr);
       });
     }
@@ -29,7 +30,7 @@ export function list(buddy) {
       });
     }
     if (filteredCommands.length === 0) {
-      if (options.format === "json")
+      if (usesJsonOutput(options))
         console.log(JSON.stringify({ commands: [], total: 0 }, null, 2));
       else {
         console.log(dim("No commands found"));
@@ -38,19 +39,15 @@ export function list(buddy) {
       }
       return;
     }
-    if (options.format === "json") {
-      const jsonOutput = filteredCommands.map((cmd) => ({
-        name: cmd.name || "",
-        description: cmd.description || "",
-        aliases: cmd.aliasNames || []
-      }));
+    if (usesJsonOutput(options)) {
+      const jsonOutput = filteredCommands.map(commandInventoryEntry).sort((a, b) => a.name.localeCompare(b.name));
       console.log(JSON.stringify({ commands: jsonOutput, total: jsonOutput.length }, null, 2));
       return;
     }
     if (options.grouped) {
       const groups = new Map;
       for (const cmd of filteredCommands) {
-        const name = cmd.name || "";
+        const name = canonicalCommandName(cmd);
         if (!name)
           continue;
         let group = "General";
@@ -83,9 +80,9 @@ export function list(buddy) {
       });
       for (const [group, cmds] of sortedGroups) {
         console.log(bold(`${group}:`));
-        cmds.sort((a, b) => (a.name || "").localeCompare(b.name || ""));
+        cmds.sort((a, b) => canonicalCommandName(a).localeCompare(canonicalCommandName(b)));
         for (const cmd of cmds) {
-          const name = (cmd.name || "").padEnd(20), desc = cmd.description || "";
+          const name = canonicalCommandName(cmd).padEnd(20), desc = cmd.description || "";
           console.log(`  ${green(name)} ${dim(desc)}`);
         }
         console.log("");
@@ -94,9 +91,9 @@ export function list(buddy) {
       console.log("");
       console.log(bold(green("Available Commands:")));
       console.log("");
-      filteredCommands.sort((a, b) => (a.name || "").localeCompare(b.name || ""));
+      filteredCommands.sort((a, b) => canonicalCommandName(a).localeCompare(canonicalCommandName(b)));
       for (const cmd of filteredCommands) {
-        const name = (cmd.name || "").padEnd(20), desc = cmd.description || "";
+        const name = canonicalCommandName(cmd).padEnd(20), desc = cmd.description || "";
         console.log(`  ${green(name)} ${dim(desc)}`);
       }
       console.log("");
@@ -106,3 +103,38 @@ export function list(buddy) {
   });
   onUnknownSubcommand(buddy, "list");
 }
+export function commandInventoryEntry(command) {
+  const entry = {
+    name: canonicalCommandName(command),
+    description: command.description,
+    aliases: [...command.aliasNames],
+    usage: command.usageLine,
+    arguments: command.args.map((argument) => ({
+      name: argument.value,
+      required: argument.required,
+      variadic: argument.variadic
+    })),
+    options: command.options.map((option) => ({
+      name: option.name,
+      flags: declaredOptionFlags(option.rawName),
+      description: option.description,
+      required: option.required === !0,
+      boolean: option.isBoolean === !0,
+      negated: option.negated,
+      ...option.config.default === void 0 ? {} : { default: option.config.default }
+    })),
+    examples: command.examples.map((example) => typeof example === "string" ? example : example("buddy"))
+  };
+  if (command.namespace)
+    entry.namespace = command.namespace;
+  return entry;
+}
+function canonicalCommandName(command) {
+  return command.namespace ? `${command.namespace}:${command.name}` : command.name;
+}
+function declaredOptionFlags(rawName) {
+  return [...rawName.matchAll(/-{1,2}([\w-]+)/g)].map((match) => match[1]);
+}
+function usesJsonOutput(options) {
+  return options.json === !0 || options.format === "json";
+}

package/dist/commands/mail.js

@@ -17,7 +17,7 @@ export function sanitizeLineCount(value) {
   const count = Number.parseInt(value || "50", 10);
   return String(Number.isFinite(count) ? Math.min(5000, Math.max(1, count)) : 50);
 }
-function shellQuote(value) {
+function shellQuote(_value) {
   return `'${value.replace(/'/g, "'\\''")}'`;
 }
 async function resolveOperationalMailHost() {

package/dist/commands/setup.d.ts

@@ -2,7 +2,6 @@ import type { CLI, CliOptions } from '@stacksjs/types';
 export declare function setup(buddy: CLI): void;
 export declare function ensurePantryInstalled(): Promise<void>;
 export declare function ensurePantryDependencies(cwd: string): Promise<void>;
-export declare function ensureNodeDependencies(cwd: string): Promise<void>;
 export declare function ensureAppKey(cwd: string): Promise<void>;
 export declare function ensureIdeSettings(cwd: string): void;
 export declare function pantryDatabasePackage(connection: string): DatabasePackage | undefined;

package/dist/commands/setup.js

@@ -1,4 +1,5 @@
 import { cpSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { join } from "node:path";
 import process from "node:process";
 import { runAction } from "@stacksjs/actions";
@@ -15,7 +16,7 @@ function getTimeoutMs(envVar, fallbackMs) {
     return value;
   return fallbackMs;
 }
-const PANTRY_CHECK_TIMEOUT_MS = getTimeoutMs("PANTRY_CHECK_TIMEOUT_MS", 15000), PANTRY_INSTALL_TIMEOUT_MS = getTimeoutMs("PANTRY_INSTALL_TIMEOUT_MS", 600000), PANTRY_DEPENDENCIES_TIMEOUT_MS = getTimeoutMs("PANTRY_DEPENDENCIES_TIMEOUT_MS", 1200000), BUN_INSTALL_TIMEOUT_MS = getTimeoutMs("BUN_INSTALL_TIMEOUT_MS", 600000), KEYGEN_TIMEOUT_MS = getTimeoutMs("KEYGEN_TIMEOUT_MS", 120000), AWS_CONFIG_TIMEOUT_MS = getTimeoutMs("AWS_CONFIG_TIMEOUT_MS", 900000);
+const PANTRY_CHECK_TIMEOUT_MS = getTimeoutMs("PANTRY_CHECK_TIMEOUT_MS", 15000), PANTRY_INSTALL_TIMEOUT_MS = getTimeoutMs("PANTRY_INSTALL_TIMEOUT_MS", 600000), PANTRY_DEPENDENCIES_TIMEOUT_MS = getTimeoutMs("PANTRY_DEPENDENCIES_TIMEOUT_MS", 1200000), KEYGEN_TIMEOUT_MS = getTimeoutMs("KEYGEN_TIMEOUT_MS", 120000), AWS_CONFIG_TIMEOUT_MS = getTimeoutMs("AWS_CONFIG_TIMEOUT_MS", 900000);
 export function setup(buddy) {
   const descriptions = {
     setup: "This command ensures your project is setup correctly",
@@ -69,59 +70,41 @@ async function isPantryInstalled() {
   }
 }
 async function installPantry() {
-  const result = await runCommand(p.frameworkPath("scripts/pantry-install"), {
+  const bundledInstaller = p.frameworkPath("scripts/pantry-install"), command = existsSync(bundledInstaller) ? [bundledInstaller] : ["sh", "-c", "curl -fsSL https://pantry.dev | bash"], result = await runCommand(command, {
     timeoutMs: PANTRY_INSTALL_TIMEOUT_MS
-  });
-  if (result.isOk)
+  }), localBin = join(homedir(), ".local", "bin");
+  if (!process.env.PATH?.split(":").includes(localBin))
+    process.env.PATH = `${localBin}:${process.env.PATH || ""}`;
+  if (result.isOk && await isPantryInstalled())
     return;
-  handleError(result.error);
+  if (result.isErr)
+    handleError(result.error);
+  else
+    log.error("Pantry installed but is not available on PATH. Open a new shell and run `buddy setup` again.");
   process.exit(ExitCode.FatalError);
 }
 export async function ensurePantryInstalled() {
   if (await isPantryInstalled())
     return;
-  const installer = p.frameworkPath("scripts/pantry-install");
-  if (!existsSync(installer)) {
-    log.debug("Pantry is not installed and no bundled installer is present; continuing without it.");
-    return;
-  }
+  log.info("Pantry is required. Installing it from https://pantry.dev...");
   await installPantry();
 }
 export async function ensurePantryDependencies(cwd) {
-  if (!await isPantryInstalled()) {
-    log.debug("Pantry not installed; skipping pantry dependency install (deps come from node_modules).");
-    return;
-  }
-  log.info("Installing Pantry dependencies...");
+  await ensurePantryInstalled();
+  log.info("Installing project dependencies with Pantry...");
   const result = await runCommand("pantry install", {
     cwd,
     timeoutMs: PANTRY_DEPENDENCIES_TIMEOUT_MS
   });
-  if (result.isOk) {
-    log.success("Installed Pantry dependencies");
-    return;
-  }
-  handleError(result.error);
-  process.exit(ExitCode.FatalError);
-}
-export async function ensureNodeDependencies(cwd) {
-  if (existsSync(join(cwd, "node_modules"))) {
-    log.success("node_modules existed, skipping bun install");
-    return;
-  }
-  log.info("Running bun install...");
-  const result = await runCommand("bun install", {
-    cwd,
-    timeoutMs: BUN_INSTALL_TIMEOUT_MS
-  }).catch((error) => {
-    handleError(error);
-    process.exit(ExitCode.FatalError);
-  });
   if (result.isErr) {
     handleError(result.error);
     process.exit(ExitCode.FatalError);
   }
-  log.success("Installed node dependencies");
+  if (existsSync(join(cwd, "package.json")) && !existsSync(join(cwd, "node_modules"))) {
+    log.error("Pantry completed without installing the project JavaScript dependencies.");
+    process.exit(ExitCode.FatalError);
+  }
+  log.success("Installed project dependencies with Pantry");
 }
 function hasAppKey(cwd) {
   const envPath = join(cwd, ".env");
@@ -167,7 +150,6 @@ async function runInitialMigration(cwd) {
 async function initializeProject(options) {
   const cwd = options.cwd || p.projectPath();
   await ensurePantryDependencies(cwd);
-  await ensureNodeDependencies(cwd);
   await ensureEnvIsSet(options);
   if (!options.skipKeygen)
     await ensureAppKey(cwd);

package/dist/commands/stacks.js

@@ -11,13 +11,14 @@ export function stacks(buddy) {
     force: "Force overwrite existing files",
     dryRun: "Show what would be installed without making changes",
     conflict: "Conflict resolution strategy: skip, overwrite, or backup",
-    verbose: "Enable verbose output"
+    verbose: "Enable verbose output",
+    project: "Target a specific Stacks project"
   };
-  buddy.command("stack:install <name>", descriptions.install).option("--force", descriptions.force, { default: !1 }).option("--dry-run", descriptions.dryRun, { default: !1 }).option("--conflict <strategy>", descriptions.conflict, { default: "skip" }).option("--verbose", descriptions.verbose, { default: !1 }).example("buddy stack:install @stacksjs/blog").example("buddy stack:install blog --force").example("buddy stack:install blog --conflict backup --verbose").example("buddy stack:install blog --dry-run").action(async (name, options) => {
+  buddy.command("stack:install <name>", descriptions.install).option("--force", descriptions.force, { default: !1 }).option("--dry-run", descriptions.dryRun, { default: !1 }).option("--conflict <strategy>", descriptions.conflict, { default: "skip" }).option("-p, --project <path>", descriptions.project).option("--verbose", descriptions.verbose, { default: !1 }).example("buddy add calendar").example("buddy add table --force").example("buddy add calendar --conflict backup --verbose").example("buddy add table --dry-run").action(async (name, options) => {
     const perf = await intro("buddy stack:install");
     if (!name) {
       log.error("You need to specify a stack name.");
-      log.info("Example: buddy stack:install @stacksjs/blog");
+      log.info("Example: buddy add calendar");
       process.exit(ExitCode.FatalError);
     }
     if (!await installStack({
@@ -25,6 +26,7 @@ export function stacks(buddy) {
       force: options.force,
       dryRun: options.dryRun,
       conflict: options.conflict || "skip",
+      project: options.project,
       verbose: options.verbose
     }) && !options.dryRun) {
       await outro("Failed to install stack", { startTime: perf, useSeconds: !0 });
@@ -33,7 +35,7 @@ export function stacks(buddy) {
     await outro(`Stack ${italic(name)} installed.`, { startTime: perf, useSeconds: !0 });
     process.exit(ExitCode.Success);
   });
-  buddy.command("stack:uninstall <name>", descriptions.uninstall).option("--force", descriptions.force, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).example("buddy stack:uninstall blog").example("buddy stack:uninstall blog --force").action(async (name, options) => {
+  buddy.command("stack:uninstall <name>", descriptions.uninstall).option("--force", descriptions.force, { default: !1 }).option("-p, --project <path>", descriptions.project).option("--verbose", descriptions.verbose, { default: !1 }).example("buddy stack:uninstall blog").example("buddy stack:uninstall blog --force").action(async (name, options) => {
     const perf = await intro("buddy stack:uninstall");
     if (!name) {
       log.error("You need to specify a stack name.");
@@ -42,6 +44,7 @@ export function stacks(buddy) {
     if (!await uninstallStack({
       name,
       force: options.force,
+      project: options.project,
       verbose: options.verbose
     })) {
       await outro("Failed to uninstall stack", { startTime: perf, useSeconds: !0 });
@@ -50,10 +53,10 @@ export function stacks(buddy) {
     await outro(`Stack ${italic(name)} uninstalled.`, { startTime: perf, useSeconds: !0 });
     process.exit(ExitCode.Success);
   });
-  buddy.command("stack:list", descriptions.list).alias("stack:ls").example("buddy stack:list").action(async () => {
-    const perf = await intro("buddy stack:list"), entries = await listStacks();
+  buddy.command("stack:list", descriptions.list).alias("stack:ls").option("-p, --project <path>", descriptions.project).example("buddy stack:list").action(async (options) => {
+    const perf = await intro("buddy stack:list"), entries = await listStacks(options.project);
     if (entries.length === 0)
-      log.info("No stacks found. Install one with: buddy stack:install <name>");
+      log.info("No stacks found. Install one with: buddy add <name>");
     else {
       log.info(`Found ${entries.length} stack(s):`);
       log.info("");

package/dist/project-setup.d.ts

@@ -0,0 +1 @@
+export declare function shouldSkipAppKeyCheck(requestedCommand: string, mode?: { isHelpFlag?: boolean, isHelpMode?: boolean }): boolean;

package/dist/project-setup.js

@@ -0,0 +1,35 @@
+const APP_KEY_OPTIONAL_COMMANDS = [
+  "build",
+  "lint",
+  "lint:fix",
+  "test",
+  "test:types",
+  "test:unit",
+  "test:feature",
+  "typecheck",
+  "types:fix",
+  "types:generate",
+  "clean",
+  "fresh",
+  "about",
+  "doctor",
+  "list",
+  "setup",
+  "setup:ssl",
+  "setup:oh-my-zsh",
+  "deploy",
+  "serve",
+  "new",
+  "create",
+  "upgrade",
+  "update",
+  "migrate",
+  "seed",
+  "generate",
+  "make",
+  "key:generate",
+  "scaffold:crud"
+];
+export function shouldSkipAppKeyCheck(requestedCommand, mode = {}) {
+  return Boolean(mode.isHelpFlag || mode.isHelpMode || APP_KEY_OPTIONAL_COMMANDS.some((command) => requestedCommand === command || requestedCommand.startsWith(`${command}:`)));
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/buddy",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.160",
+  "version": "0.70.162",
   "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "contributors": [
@@ -32,7 +32,7 @@
     "pwa",
     "modern",
     "library",
-    "vue",
+    "stx",
     "web components",
     "typescript",
     "javascript",
@@ -92,52 +92,52 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/actions": "^0.70.160",
-    "@stacksjs/ai": "^0.70.160",
-    "@stacksjs/alias": "^0.70.160",
-    "@stacksjs/arrays": "^0.70.160",
-    "@stacksjs/auth": "^0.70.160",
-    "@stacksjs/build": "^0.70.160",
-    "@stacksjs/cache": "^0.70.160",
-    "@stacksjs/cli": "^0.70.160",
+    "@stacksjs/actions": "^0.70.162",
+    "@stacksjs/ai": "^0.70.162",
+    "@stacksjs/alias": "^0.70.162",
+    "@stacksjs/arrays": "^0.70.162",
+    "@stacksjs/auth": "^0.70.162",
+    "@stacksjs/build": "^0.70.162",
+    "@stacksjs/cache": "^0.70.162",
+    "@stacksjs/cli": "^0.70.162",
     "@stacksjs/clapp": "^0.2.12",
-    "@stacksjs/cloud": "^0.70.160",
-    "@stacksjs/collections": "^0.70.160",
-    "@stacksjs/config": "^0.70.160",
-    "@stacksjs/database": "^0.70.160",
-    "@stacksjs/desktop": "^0.70.160",
-    "@stacksjs/dns": "^0.70.160",
-    "@stacksjs/email": "^0.70.160",
-    "@stacksjs/enums": "^0.70.160",
-    "@stacksjs/error-handling": "^0.70.160",
-    "@stacksjs/events": "^0.70.160",
-    "@stacksjs/git": "^0.70.160",
+    "@stacksjs/cloud": "^0.70.162",
+    "@stacksjs/collections": "^0.70.162",
+    "@stacksjs/config": "^0.70.162",
+    "@stacksjs/database": "^0.70.162",
+    "@stacksjs/desktop": "^0.70.162",
+    "@stacksjs/dns": "^0.70.162",
+    "@stacksjs/email": "^0.70.162",
+    "@stacksjs/enums": "^0.70.162",
+    "@stacksjs/error-handling": "^0.70.162",
+    "@stacksjs/events": "^0.70.162",
+    "@stacksjs/git": "^0.70.162",
     "@stacksjs/gitit": "^0.2.5",
-    "@stacksjs/health": "^0.70.160",
+    "@stacksjs/health": "^0.70.162",
     "@stacksjs/dnsx": "^0.2.3",
     "@stacksjs/httx": "^0.1.10",
-    "@stacksjs/lint": "^0.70.160",
-    "@stacksjs/logging": "^0.70.160",
-    "@stacksjs/notifications": "^0.70.160",
-    "@stacksjs/objects": "^0.70.160",
-    "@stacksjs/orm": "^0.70.160",
-    "@stacksjs/path": "^0.70.160",
-    "@stacksjs/payments": "^0.70.160",
-    "@stacksjs/realtime": "^0.70.160",
-    "@stacksjs/router": "^0.70.160",
+    "@stacksjs/lint": "^0.70.162",
+    "@stacksjs/logging": "^0.70.162",
+    "@stacksjs/notifications": "^0.70.162",
+    "@stacksjs/objects": "^0.70.162",
+    "@stacksjs/orm": "^0.70.162",
+    "@stacksjs/path": "^0.70.162",
+    "@stacksjs/payments": "^0.70.162",
+    "@stacksjs/realtime": "^0.70.162",
+    "@stacksjs/router": "^0.70.162",
     "@stacksjs/rpx": "^0.11.31",
-    "@stacksjs/search-engine": "^0.70.160",
-    "@stacksjs/security": "^0.70.160",
-    "@stacksjs/server": "^0.70.160",
-    "@stacksjs/storage": "^0.70.160",
-    "@stacksjs/strings": "^0.70.160",
-    "@stacksjs/testing": "^0.70.160",
-    "@stacksjs/tunnel": "^0.70.160",
-    "@stacksjs/types": "^0.70.160",
-    "@stacksjs/ui": "^0.70.160",
-    "@stacksjs/utils": "^0.70.160",
-    "@stacksjs/validation": "^0.70.160",
-    "@stacksjs/ts-cloud": "^0.7.49"
+    "@stacksjs/search-engine": "^0.70.162",
+    "@stacksjs/security": "^0.70.162",
+    "@stacksjs/server": "^0.70.162",
+    "@stacksjs/storage": "^0.70.162",
+    "@stacksjs/strings": "^0.70.162",
+    "@stacksjs/testing": "^0.70.162",
+    "@stacksjs/tunnel": "^0.70.162",
+    "@stacksjs/types": "^0.70.162",
+    "@stacksjs/ui": "^0.70.162",
+    "@stacksjs/utils": "^0.70.162",
+    "@stacksjs/validation": "^0.70.162",
+    "@stacksjs/ts-cloud": "^0.7.56"
   },
   "devDependencies": {
     "better-dx": "^0.2.17"