@stacksjs/buddy 0.70.258 → 0.70.259

package/dist/commands/serve.js

@@ -1,55 +1 @@
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import process from "node:process";
-import { log } from "@stacksjs/logging";
-import { ExitCode } from "@stacksjs/types";
-import { startProductionServer } from "../production-server";
-export {
-  loadStxPartialsDir,
-  resolveUserPartialsPath,
-  startProductionServer
-} from "../production-server";
-export function serve(buddy) {
-  buddy.command("serve", "Start the production HTTP server (STX views + /api proxy + coming-soon/maintenance gate)").option("-p, --port <port>", "Port to listen on (defaults to PORT env or 3000)").option("--verbose", "Enable verbose output", { default: !1 }).action(startProductionServer);
-}
-export function serveApi(buddy) {
-  buddy.command("serve:api", "Start the production API server (bun-router routes the frontend proxies /api to)").option("-p, --port <port>", "Port to listen on (defaults to PORT env or 3008)").action(async (options) => {
-    if (options?.port)
-      process.env.PORT = String(options.port);
-    process.env.APP_ENV = process.env.APP_ENV || "production";
-    await import(resolveApiEntry());
-  });
-}
-function resolveApiEntry() {
-  const vendored = join(process.cwd(), "storage/framework/core/actions/src/serve/api.ts");
-  if (existsSync(vendored))
-    return vendored;
-  return "@stacksjs/actions/serve/api";
-}
-export function preview(buddy) {
-  buddy.command("preview [dir]", "Serve a static build locally, the way a static host would").option("-p, --port <port>", "Port to listen on", { default: "3001" }).example("buddy preview").example("buddy preview dist --port 4000").action(async (dir, options) => {
-    const root = dir || "dist", port = Number(options?.port) || 3001;
-    if (!existsSync(root)) {
-      log.error(`No \`${root}\` directory to preview. Run \`buddy build\` first, or pass the directory to serve.`);
-      process.exit(ExitCode.FatalError);
-    }
-    Bun.serve({
-      port,
-      async fetch(req) {
-        let pathname = new URL(req.url).pathname;
-        if (pathname === "/" || pathname === "")
-          pathname = "/index.html";
-        else if (!pathname.includes("."))
-          pathname = `${pathname.replace(/\/$/, "")}.html`;
-        const file = Bun.file(join(root, pathname));
-        if (await file.exists())
-          return new Response(file);
-        const notFound = Bun.file(join(root, "404.html"));
-        if (await notFound.exists())
-          return new Response(notFound, { status: 404 });
-        return new Response("Not Found", { status: 404 });
-      }
-    });
-    log.success(`Previewing ./${root} at http://localhost:${port}`);
-  });
-}
+import{existsSync}from"node:fs";import{join}from"node:path";import process from"node:process";import{log}from"@stacksjs/logging";import{ExitCode}from"@stacksjs/types";import{startProductionServer}from"../production-server";export{loadStxPartialsDir,resolveUserPartialsPath,startProductionServer}from"../production-server";export function serve(buddy){buddy.command("serve","Start the production HTTP server (STX views + /api proxy + coming-soon/maintenance gate)").option("-p, --port <port>","Port to listen on (defaults to PORT env or 3000)").option("--verbose","Enable verbose output",{default:!1}).action(startProductionServer)}export function serveApi(buddy){buddy.command("serve:api","Start the production API server (bun-router routes the frontend proxies /api to)").option("-p, --port <port>","Port to listen on (defaults to PORT env or 3008)").action(async(options)=>{if(options?.port)process.env.PORT=String(options.port);process.env.APP_ENV=process.env.APP_ENV||"production";await import(resolveApiEntry())})}function resolveApiEntry(){const vendored=join(process.cwd(),"storage/framework/core/actions/src/serve/api.ts");if(existsSync(vendored))return vendored;return"@stacksjs/actions/serve/api"}export function preview(buddy){buddy.command("preview [dir]","Serve a static build locally, the way a static host would").option("-p, --port <port>","Port to listen on",{default:"3001"}).example("buddy preview").example("buddy preview dist --port 4000").action(async(dir,options)=>{const root=dir||"dist",port=Number(options?.port)||3001;if(!existsSync(root)){log.error(`No \`${root}\` directory to preview. Run \`buddy build\` first, or pass the directory to serve.`);process.exit(ExitCode.FatalError)}Bun.serve({port,async fetch(req){let pathname=new URL(req.url).pathname;if(pathname==="/"||pathname==="")pathname="/index.html";else if(!pathname.includes("."))pathname=`${pathname.replace(/\/$/,"")}.html`;const file=Bun.file(join(root,pathname));if(await file.exists())return new Response(file);const notFound=Bun.file(join(root,"404.html"));if(await notFound.exists())return new Response(notFound,{status:404});return new Response("Not Found",{status:404})}});log.success(`Previewing ./${root} at http://localhost:${port}`)})}

package/dist/commands/setup-ai.js

@@ -1,121 +1,2 @@
-import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
-import process from "node:process";
-import { dim, green, log, yellow } from "@stacksjs/cli";
-import { frameworkPath, join, projectPath, relative } from "@stacksjs/path";
-import { listSkills, resolveSkillPath } from "@stacksjs/skills";
-export const AI_PROVIDERS = [
-  { id: "claude", label: "Claude Code", reads: ["AGENTS.md", "CLAUDE.md", ".claude/skills", ".claude/launch.json"] },
-  { id: "codex", label: "OpenAI Codex CLI", reads: ["AGENTS.md"] },
-  { id: "cursor", label: "Cursor", reads: ["AGENTS.md", ".cursor/rules"] },
-  { id: "copilot", label: "GitHub Copilot", reads: ["AGENTS.md", ".github/copilot-instructions.md"] },
-  { id: "gemini", label: "Gemini CLI", reads: ["AGENTS.md", "GEMINI.md"] }
-];
-export function isAiProvider(value) {
-  return AI_PROVIDERS.some((provider) => provider.id === value);
-}
-function materialize(target, path, options) {
-  const existing = lstatSync(path, { throwIfNoEntry: !1 });
-  if (existing) {
-    if (!existing.isSymbolicLink() && !options.force)
-      return !1;
-    rmSync(path, { recursive: !0, force: !0 });
-  }
-  mkdirSync(join(path, ".."), { recursive: !0 });
-  if (options.copy)
-    cpSync(target, path, { recursive: !0 });
-  else
-    symlinkSync(relative(join(path, ".."), target), path, process.platform === "win32" ? "junction" : "dir");
-  return !0;
-}
-function materializeFile(source, path, options) {
-  if (existsSync(path) && !options.force)
-    return !1;
-  mkdirSync(join(path, ".."), { recursive: !0 });
-  cpSync(source, path, { recursive: !0, force: !0 });
-  return !0;
-}
-function installSkills(destination, options) {
-  const names = listSkills();
-  let installed = 0, skipped = 0;
-  mkdirSync(destination, { recursive: !0 });
-  for (const entry of readdirSync(destination)) {
-    const path = join(destination, entry);
-    if (lstatSync(path, { throwIfNoEntry: !1 })?.isSymbolicLink() && !existsSync(path))
-      rmSync(path, { force: !0 });
-  }
-  for (const name of names) {
-    const source = resolveSkillPath(name);
-    if (!source)
-      continue;
-    if (materialize(source, join(destination, name), options))
-      installed++;
-    else
-      skipped++;
-  }
-  return { installed, skipped };
-}
-export function setupAiProvider(provider, options = {}) {
-  const created = [], skipped = [], defaults = frameworkPath("defaults/ai"), rel = (path) => relative(projectPath(), path), record = (path, didCreate) => {
-    (didCreate ? created : skipped).push(rel(path));
-  }, agents = projectPath("AGENTS.md");
-  record(agents, materializeFile(join(defaults, "AGENTS.md"), agents, { ...options, force: !1 }));
-  switch (provider) {
-    case "claude": {
-      const claudeMd = projectPath("CLAUDE.md");
-      record(claudeMd, materialize(agents, claudeMd, { ...options, copy: !1 }));
-      const launch = projectPath(".claude/launch.json");
-      record(launch, materializeFile(join(defaults, "claude/launch.json"), launch, options));
-      const skillsDir = projectPath(".claude/skills"), { installed, skipped: untouched } = installSkills(skillsDir, options);
-      if (installed > 0)
-        created.push(`${rel(skillsDir)} (${installed} skills)`);
-      if (untouched > 0)
-        skipped.push(`${rel(skillsDir)} (${untouched} skills)`);
-      break;
-    }
-    case "codex":
-      break;
-    case "cursor": {
-      const rules = projectPath(".cursor/rules");
-      record(rules, materialize(frameworkPath("defaults/ide/cursor/rules"), rules, options));
-      break;
-    }
-    case "copilot": {
-      const instructions = projectPath(".github/copilot-instructions.md");
-      if (existsSync(instructions) && !options.force)
-        skipped.push(rel(instructions));
-      else {
-        mkdirSync(projectPath(".github"), { recursive: !0 });
-        writeFileSync(instructions, pointerFile("AGENTS.md"), "utf8");
-        created.push(rel(instructions));
-      }
-      break;
-    }
-    case "gemini": {
-      const geminiMd = projectPath("GEMINI.md");
-      record(geminiMd, materialize(agents, geminiMd, { ...options, copy: !1 }));
-      break;
-    }
-  }
-  return { created, skipped };
-}
-function pointerFile(target) {
-  return [
-    "# Project instructions",
-    "",
-    `This project keeps its agent guidance in [\`${target}\`](../${target}), so every`,
-    "agent works from the same rules. Read that file.",
-    "",
-    "Regenerate this pointer with `buddy setup:ai copilot --force`.",
-    ""
-  ].join(`
-`);
-}
-export function reportAiSetup(provider, result) {
-  for (const path of result.created)
-    log.info(`  ${green("+")} ${path}`);
-  for (const path of result.skipped)
-    log.info(`  ${yellow("\xB7")} ${path} ${dim("(already present, left alone)")}`);
-  if (result.created.length === 0)
-    log.info(dim("  Nothing to do - re-run with --force to overwrite."));
-  log.success(`${provider.label} is set up. It reads: ${provider.reads.join(", ")}`);
-}
+import{cpSync,existsSync,lstatSync,mkdirSync,readdirSync,rmSync,symlinkSync,writeFileSync}from"node:fs";import process from"node:process";import{dim,green,log,yellow}from"@stacksjs/cli";import{frameworkPath,join,projectPath,relative}from"@stacksjs/path";import{listSkills,resolveSkillPath}from"@stacksjs/skills";export const AI_PROVIDERS=[{id:"claude",label:"Claude Code",reads:["AGENTS.md","CLAUDE.md",".claude/skills",".claude/launch.json"]},{id:"codex",label:"OpenAI Codex CLI",reads:["AGENTS.md"]},{id:"cursor",label:"Cursor",reads:["AGENTS.md",".cursor/rules"]},{id:"copilot",label:"GitHub Copilot",reads:["AGENTS.md",".github/copilot-instructions.md"]},{id:"gemini",label:"Gemini CLI",reads:["AGENTS.md","GEMINI.md"]}];export function isAiProvider(value){return AI_PROVIDERS.some((provider)=>provider.id===value)}function materialize(target,path,options){const existing=lstatSync(path,{throwIfNoEntry:!1});if(existing){if(!existing.isSymbolicLink()&&!options.force)return!1;rmSync(path,{recursive:!0,force:!0})}mkdirSync(join(path,".."),{recursive:!0});if(options.copy)cpSync(target,path,{recursive:!0});else symlinkSync(relative(join(path,".."),target),path,process.platform==="win32"?"junction":"dir");return!0}function materializeFile(source,path,options){if(existsSync(path)&&!options.force)return!1;mkdirSync(join(path,".."),{recursive:!0});cpSync(source,path,{recursive:!0,force:!0});return!0}function installSkills(destination,options){const names=listSkills();let installed=0,skipped=0;mkdirSync(destination,{recursive:!0});for(const entry of readdirSync(destination)){const path=join(destination,entry);if(lstatSync(path,{throwIfNoEntry:!1})?.isSymbolicLink()&&!existsSync(path))rmSync(path,{force:!0})}for(const name of names){const source=resolveSkillPath(name);if(!source)continue;if(materialize(source,join(destination,name),options))installed++;else skipped++}return{installed,skipped}}export function setupAiProvider(provider,options={}){const created=[],skipped=[],defaults=frameworkPath("defaults/ai"),rel=(path)=>relative(projectPath(),path),record=(path,didCreate)=>{(didCreate?created:skipped).push(rel(path))},agents=projectPath("AGENTS.md");record(agents,materializeFile(join(defaults,"AGENTS.md"),agents,{...options,force:!1}));switch(provider){case"claude":{const claudeMd=projectPath("CLAUDE.md");record(claudeMd,materialize(agents,claudeMd,{...options,copy:!1}));const launch=projectPath(".claude/launch.json");record(launch,materializeFile(join(defaults,"claude/launch.json"),launch,options));const skillsDir=projectPath(".claude/skills"),{installed,skipped:untouched}=installSkills(skillsDir,options);if(installed>0)created.push(`${rel(skillsDir)} (${installed} skills)`);if(untouched>0)skipped.push(`${rel(skillsDir)} (${untouched} skills)`);break}case"codex":break;case"cursor":{const rules=projectPath(".cursor/rules");record(rules,materialize(frameworkPath("defaults/ide/cursor/rules"),rules,options));break}case"copilot":{const instructions=projectPath(".github/copilot-instructions.md");if(existsSync(instructions)&&!options.force)skipped.push(rel(instructions));else{mkdirSync(projectPath(".github"),{recursive:!0});writeFileSync(instructions,pointerFile("AGENTS.md"),"utf8");created.push(rel(instructions))}break}case"gemini":{const geminiMd=projectPath("GEMINI.md");record(geminiMd,materialize(agents,geminiMd,{...options,copy:!1}));break}}return{created,skipped}}function pointerFile(target){return["# Project instructions","",`This project keeps its agent guidance in [\`${target}\`](../${target}), so every`,"agent works from the same rules. Read that file.","","Regenerate this pointer with `buddy setup:ai copilot --force`.",""].join(`
+`)}export function reportAiSetup(provider,result){for(const path of result.created)log.info(`  ${green("+")} ${path}`);for(const path of result.skipped)log.info(`  ${yellow("\xB7")} ${path} ${dim("(already present, left alone)")}`);if(result.created.length===0)log.info(dim("  Nothing to do - re-run with --force to overwrite."));log.success(`${provider.label} is set up. It reads: ${provider.reads.join(", ")}`)}

package/dist/commands/setup.js

@@ -1,306 +1,3 @@
-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";
-import { log, onUnknownSubcommand, runCommand } from "@stacksjs/cli";
-import { Action } from "@stacksjs/enums";
-import { handleError } from "@stacksjs/error-handling";
-import { path as p } from "@stacksjs/path";
-import { copyFile, storage } from "@stacksjs/storage";
-import { ExitCode } from "@stacksjs/types";
-import { setupPrettyDevEnvironment } from "./dev";
-function getTimeoutMs(envVar, fallbackMs) {
-  const value = Number(process.env[envVar]);
-  if (Number.isFinite(value) && value > 0)
-    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), 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",
-    ssl: "Setup SSL certificates and hosts file for HTTPS development",
-    ai: "Set the project up for an AI coding agent (Claude Code, Codex, Cursor, Copilot, Gemini)",
-    copy: "Copy the agent files instead of symlinking them, so they can be edited per project",
-    force: "Overwrite files that already exist",
-    ohMyZsh: "Enable Oh My Zsh",
-    aws: "Ensures AWS is connected to the project",
-    project: "Target a specific project",
-    verbose: "Enable verbose output",
-    domain: "Custom domain to setup (defaults to APP_URL)",
-    skipHosts: "Skip adding domain to hosts file",
-    skipTrust: "Skip trusting the certificate",
-    skipAws: "Skip AWS configuration during setup",
-    skipKeygen: "Skip generating an application key during setup"
-  };
-  buddy.command("setup", descriptions.setup).alias("ensure").option("-p, --project [project]", descriptions.project, { default: !1 }).option("--skip-aws", descriptions.skipAws, { default: !1 }).option("--skip-keygen", descriptions.skipKeygen, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    log.debug("Running `buddy setup` ...", options);
-    await ensurePantryInstalled();
-    await optimizePantryDeps();
-    await initializeProject(options);
-  });
-  buddy.command("setup:ssl", descriptions.ssl).alias("ssl:setup").option("-d, --domain [domain]", descriptions.domain).option("--skip-hosts", descriptions.skipHosts, { default: !1 }).option("--skip-trust", descriptions.skipTrust, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    log.debug("Running `buddy setup:ssl` ...", options);
-    if (!await setupPrettyDevEnvironment({
-      domain: options.domain,
-      skipHosts: options.skipHosts,
-      skipTrust: options.skipTrust,
-      verbose: options.verbose
-    })) {
-      log.warn("SSL setup completed with warnings");
-      log.info("You may need to manually trust certificates or update hosts file");
-    }
-  });
-  buddy.command("setup:ai [provider]", descriptions.ai).alias("ai:setup").option("--copy", descriptions.copy, { default: !1 }).option("--force", descriptions.force, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (provider, options) => {
-    log.debug("Running `buddy setup:ai` ...", options);
-    const { AI_PROVIDERS, isAiProvider, reportAiSetup, setupAiProvider } = await import("./setup-ai");
-    let id = provider;
-    if (!id) {
-      const { select } = await import("@stacksjs/cli");
-      id = await select({
-        message: "Which AI coding agent do you use?",
-        choices: AI_PROVIDERS.map((entry) => ({ value: entry.id, label: entry.label })),
-        initial: 0
-      });
-    }
-    if (!id || !isAiProvider(id)) {
-      log.error(`Unknown AI provider: ${id}. Expected one of: ${AI_PROVIDERS.map((entry) => entry.id).join(", ")}`);
-      process.exit(ExitCode.InvalidArgument);
-    }
-    const definition = AI_PROVIDERS.find((entry) => entry.id === id);
-    reportAiSetup(definition, setupAiProvider(id, { copy: options.copy, force: options.force }));
-  });
-  buddy.command("setup:oh-my-zsh", descriptions.ohMyZsh).alias("upgrade:oh-my-zsh").option("--verbose", descriptions.verbose, { default: !1 }).action(async (_options) => {
-    log.debug("Running `buddy setup:oh-my-zsh` ...", _options);
-    const result = await runAction(Action.UpgradeShell);
-    if (result.isErr) {
-      log.error(result.error);
-      process.exit(ExitCode.FatalError);
-    }
-  });
-  onUnknownSubcommand(buddy, "setup");
-}
-async function isPantryInstalled() {
-  try {
-    return (await runCommand("pantry --version", {
-      silent: !0,
-      timeoutMs: PANTRY_CHECK_TIMEOUT_MS
-    })).isOk;
-  } catch {
-    return !1;
-  }
-}
-async function installPantry() {
-  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
-  }), 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;
-  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;
-  log.info("Pantry is required. Installing it from https://pantry.dev...");
-  await installPantry();
-}
-export async function ensurePantryDependencies(cwd) {
-  await ensurePantryInstalled();
-  log.info("Installing project dependencies with Pantry...");
-  const result = await runCommand("pantry install", {
-    cwd,
-    timeoutMs: PANTRY_DEPENDENCIES_TIMEOUT_MS
-  });
-  if (result.isErr) {
-    handleError(result.error);
-    process.exit(ExitCode.FatalError);
-  }
-  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");
-  if (!existsSync(envPath))
-    return !1;
-  return /^APP_KEY=.+$/m.test(readFileSync(envPath, "utf-8"));
-}
-export async function ensureAppKey(cwd) {
-  if (hasAppKey(cwd) || process.env.APP_KEY && process.env.APP_KEY.length > 0) {
-    log.success("APP_KEY existed");
-    return;
-  }
-  const keyResult = await runCommand("./buddy key:generate", {
-    cwd,
-    timeoutMs: KEYGEN_TIMEOUT_MS
-  });
-  if (keyResult.isErr) {
-    handleError(keyResult.error);
-    process.exit(ExitCode.FatalError);
-  }
-  log.success("Generated application key");
-}
-async function runInitialMigration(cwd) {
-  const appEnv = (process.env.APP_ENV || process.env.NODE_ENV || "local").toLowerCase();
-  if (!["local", "development", "dev", "test"].includes(appEnv)) {
-    log.info(`Skipping initial migration in the ${appEnv} environment`);
-    return;
-  }
-  log.info("Running initial database migration...");
-  try {
-    const result = await runAction(Action.Migrate, { cwd });
-    if (result.isErr) {
-      log.warn("Initial migration did not complete - you can run it later via ./buddy migrate");
-      log.debug(result.error);
-      return;
-    }
-    log.success("Database is migrated");
-  } catch (error) {
-    log.warn("Initial migration did not complete - you can run it later via ./buddy migrate");
-    log.debug(error);
-  }
-}
-async function initializeProject(options) {
-  const cwd = options.cwd || p.projectPath();
-  await ensurePantryDependencies(cwd);
-  await ensureEnvIsSet(options);
-  if (!options.skipKeygen)
-    await ensureAppKey(cwd);
-  await runInitialMigration(cwd);
-  ensureIdeSettings(cwd);
-  if (!options.skipAws) {
-    log.info("Ensuring AWS is connected...");
-    try {
-      const awsResult = await runCommand("./buddy configure:aws", {
-        cwd,
-        timeoutMs: AWS_CONFIG_TIMEOUT_MS
-      });
-      if (awsResult.isErr) {
-        log.warn("AWS not configured - you can do this later via ./buddy configure:aws");
-        log.debug(awsResult.error);
-      } else
-        log.success("Configured AWS");
-    } catch (error) {
-      log.warn("AWS not configured - you can do this later via ./buddy configure:aws");
-      log.debug(error);
-    }
-  }
-  log.success("Project is setup");
-  log.info("Run `./buddy doctor` anytime to check your setup. Happy coding! \uD83D\uDC99");
-}
-export function ensureIdeSettings(cwd) {
-  const source = p.frameworkPath("defaults/ide/vscode/.vscode"), destination = join(cwd, ".vscode");
-  if (existsSync(destination)) {
-    log.debug(".vscode already exists; keeping the project settings");
-    return;
-  }
-  if (!existsSync(source)) {
-    log.debug("No bundled VS Code settings found; skipping IDE setup");
-    return;
-  }
-  cpSync(source, destination, { recursive: !0 });
-  log.success("Installed project VS Code settings");
-}
-const DB_CONNECTION_PACKAGES = {
-  postgres: { name: "postgresql.org", version: "^17.10", service: "postgres" },
-  mysql: { name: "mysql.com", version: "*", service: "mysql" },
-  sqlite: { name: "sqlite.org", version: "^3.47.2" }
-};
-function databaseAliases(connection, pkg) {
-  return [connection, pkg.name];
-}
-export function pantryDatabasePackage(connection) {
-  return DB_CONNECTION_PACKAGES[connection];
-}
-function detectDbPackage(cwd) {
-  const envPath = join(cwd, ".env"), envExamplePath = join(cwd, ".env.example"), filePath = existsSync(envPath) ? envPath : existsSync(envExamplePath) ? envExamplePath : void 0;
-  if (!filePath)
-    return;
-  const match = readFileSync(filePath, "utf-8").match(/^DB_CONNECTION=(.+)$/m);
-  if (!match)
-    return;
-  const value = match[1].trim().replace(/['"]/g, "");
-  return pantryDatabasePackage(value);
-}
-export async function optimizePantryDeps() {
-  const cwd = p.projectPath(), depsConfigPath = join(cwd, "config", "deps.ts");
-  if (!existsSync(depsConfigPath)) {
-    log.debug("No config/deps.ts found, skipping dependency optimization");
-    return;
-  }
-  let configDeps = {}, configServices = [];
-  try {
-    const mod = await import(depsConfigPath), config = mod.config || mod.default;
-    if (config?.dependencies)
-      configDeps = { ...config.dependencies };
-    if (Array.isArray(config?.services?.autoStart))
-      configServices = config.services.autoStart.filter((name) => typeof name === "string");
-  } catch (err) {
-    log.debug("Could not load config/deps.ts, skipping dependency optimization");
-    return;
-  }
-  const dbPackage = detectDbPackage(cwd), autoStart = [...configServices];
-  if (dbPackage) {
-    const selected = new Set(Object.entries(DB_CONNECTION_PACKAGES).filter(([, pkg]) => pkg.name === dbPackage.name).flatMap(([connection, pkg]) => databaseAliases(connection, pkg))), unused = new Set(Object.entries(DB_CONNECTION_PACKAGES).flatMap(([connection, pkg]) => databaseAliases(connection, pkg)).filter((alias) => !selected.has(alias)));
-    for (const pkg of Object.keys(configDeps)) {
-      const domain = pkg.split("/")[0];
-      if (unused.has(domain)) {
-        log.info(`DB_CONNECTION selects ${dbPackage.name}, dropping unused ${pkg}`);
-        delete configDeps[pkg];
-      }
-    }
-    if (!Object.keys(configDeps).some((key) => {
-      const domain = key.split("/")[0];
-      return selected.has(domain);
-    })) {
-      log.info(`Detected DB_CONNECTION requires ${dbPackage.name}, adding to dependencies`);
-      configDeps[dbPackage.name] = dbPackage.version;
-    }
-    if (dbPackage.service && !autoStart.includes(dbPackage.service))
-      autoStart.push(dbPackage.service);
-  }
-  const lines = [
-    "# Auto-generated from config/deps.ts and .env sniffing.",
-    "# This file is regenerated on each `buddy setup` run.",
-    "#",
-    "# To learn more, please visit:",
-    "# https://stacksjs.com/docs/dependency-management",
-    "",
-    "dependencies:"
-  ];
-  for (const [pkg, version] of Object.entries(configDeps))
-    lines.push(`  ${pkg}: ${version}`);
-  if (autoStart.length > 0) {
-    lines.push("", "services:", "  enabled: true", "  autoStart:");
-    for (const service of autoStart)
-      lines.push(`    - ${service}`);
-  }
-  const depsYamlPath = join(cwd, "deps.yaml");
-  writeFileSync(depsYamlPath, `${lines.join(`
+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";import{log,onUnknownSubcommand,runCommand}from"@stacksjs/cli";import{Action}from"@stacksjs/enums";import{handleError}from"@stacksjs/error-handling";import{path as p}from"@stacksjs/path";import{copyFile,storage}from"@stacksjs/storage";import{ExitCode}from"@stacksjs/types";import{setupPrettyDevEnvironment}from"./dev";function getTimeoutMs(envVar,fallbackMs){const value=Number(process.env[envVar]);if(Number.isFinite(value)&&value>0)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),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",ssl:"Setup SSL certificates and hosts file for HTTPS development",ai:"Set the project up for an AI coding agent (Claude Code, Codex, Cursor, Copilot, Gemini)",copy:"Copy the agent files instead of symlinking them, so they can be edited per project",force:"Overwrite files that already exist",ohMyZsh:"Enable Oh My Zsh",aws:"Ensures AWS is connected to the project",project:"Target a specific project",verbose:"Enable verbose output",domain:"Custom domain to setup (defaults to APP_URL)",skipHosts:"Skip adding domain to hosts file",skipTrust:"Skip trusting the certificate",skipAws:"Skip AWS configuration during setup",skipKeygen:"Skip generating an application key during setup"};buddy.command("setup",descriptions.setup).alias("ensure").option("-p, --project [project]",descriptions.project,{default:!1}).option("--skip-aws",descriptions.skipAws,{default:!1}).option("--skip-keygen",descriptions.skipKeygen,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{log.debug("Running `buddy setup` ...",options);await ensurePantryInstalled();await optimizePantryDeps();await initializeProject(options)});buddy.command("setup:ssl",descriptions.ssl).alias("ssl:setup").option("-d, --domain [domain]",descriptions.domain).option("--skip-hosts",descriptions.skipHosts,{default:!1}).option("--skip-trust",descriptions.skipTrust,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{log.debug("Running `buddy setup:ssl` ...",options);if(!await setupPrettyDevEnvironment({domain:options.domain,skipHosts:options.skipHosts,skipTrust:options.skipTrust,verbose:options.verbose})){log.warn("SSL setup completed with warnings");log.info("You may need to manually trust certificates or update hosts file")}});buddy.command("setup:ai [provider]",descriptions.ai).alias("ai:setup").option("--copy",descriptions.copy,{default:!1}).option("--force",descriptions.force,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(provider,options)=>{log.debug("Running `buddy setup:ai` ...",options);const{AI_PROVIDERS,isAiProvider,reportAiSetup,setupAiProvider}=await import("./setup-ai");let id=provider;if(!id){const{select}=await import("@stacksjs/cli");id=await select({message:"Which AI coding agent do you use?",choices:AI_PROVIDERS.map((entry)=>({value:entry.id,label:entry.label})),initial:0})}if(!id||!isAiProvider(id)){log.error(`Unknown AI provider: ${id}. Expected one of: ${AI_PROVIDERS.map((entry)=>entry.id).join(", ")}`);process.exit(ExitCode.InvalidArgument)}const definition=AI_PROVIDERS.find((entry)=>entry.id===id);reportAiSetup(definition,setupAiProvider(id,{copy:options.copy,force:options.force}))});buddy.command("setup:oh-my-zsh",descriptions.ohMyZsh).alias("upgrade:oh-my-zsh").option("--verbose",descriptions.verbose,{default:!1}).action(async(_options)=>{log.debug("Running `buddy setup:oh-my-zsh` ...",_options);const result=await runAction(Action.UpgradeShell);if(result.isErr){log.error(result.error);process.exit(ExitCode.FatalError)}});onUnknownSubcommand(buddy,"setup")}async function isPantryInstalled(){try{return(await runCommand("pantry --version",{silent:!0,timeoutMs:PANTRY_CHECK_TIMEOUT_MS})).isOk}catch{return!1}}async function installPantry(){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}),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;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;log.info("Pantry is required. Installing it from https://pantry.dev...");await installPantry()}export async function ensurePantryDependencies(cwd){await ensurePantryInstalled();log.info("Installing project dependencies with Pantry...");const result=await runCommand("pantry install",{cwd,timeoutMs:PANTRY_DEPENDENCIES_TIMEOUT_MS});if(result.isErr){handleError(result.error);process.exit(ExitCode.FatalError)}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");if(!existsSync(envPath))return!1;return/^APP_KEY=.+$/m.test(readFileSync(envPath,"utf-8"))}export async function ensureAppKey(cwd){if(hasAppKey(cwd)||process.env.APP_KEY&&process.env.APP_KEY.length>0){log.success("APP_KEY existed");return}const keyResult=await runCommand("./buddy key:generate",{cwd,timeoutMs:KEYGEN_TIMEOUT_MS});if(keyResult.isErr){handleError(keyResult.error);process.exit(ExitCode.FatalError)}log.success("Generated application key")}async function runInitialMigration(cwd){const appEnv=(process.env.APP_ENV||process.env.NODE_ENV||"local").toLowerCase();if(!["local","development","dev","test"].includes(appEnv)){log.info(`Skipping initial migration in the ${appEnv} environment`);return}log.info("Running initial database migration...");try{const result=await runAction(Action.Migrate,{cwd});if(result.isErr){log.warn("Initial migration did not complete - you can run it later via ./buddy migrate");log.debug(result.error);return}log.success("Database is migrated")}catch(error){log.warn("Initial migration did not complete - you can run it later via ./buddy migrate");log.debug(error)}}async function initializeProject(options){const cwd=options.cwd||p.projectPath();await ensurePantryDependencies(cwd);await ensureEnvIsSet(options);if(!options.skipKeygen)await ensureAppKey(cwd);await runInitialMigration(cwd);ensureIdeSettings(cwd);if(!options.skipAws){log.info("Ensuring AWS is connected...");try{const awsResult=await runCommand("./buddy configure:aws",{cwd,timeoutMs:AWS_CONFIG_TIMEOUT_MS});if(awsResult.isErr){log.warn("AWS not configured - you can do this later via ./buddy configure:aws");log.debug(awsResult.error)}else log.success("Configured AWS")}catch(error){log.warn("AWS not configured - you can do this later via ./buddy configure:aws");log.debug(error)}}log.success("Project is setup");log.info("Run `./buddy doctor` anytime to check your setup. Happy coding! \uD83D\uDC99")}export function ensureIdeSettings(cwd){const source=p.frameworkPath("defaults/ide/vscode/.vscode"),destination=join(cwd,".vscode");if(existsSync(destination)){log.debug(".vscode already exists; keeping the project settings");return}if(!existsSync(source)){log.debug("No bundled VS Code settings found; skipping IDE setup");return}cpSync(source,destination,{recursive:!0});log.success("Installed project VS Code settings")}const DB_CONNECTION_PACKAGES={postgres:{name:"postgresql.org",version:"^17.10",service:"postgres"},mysql:{name:"mysql.com",version:"*",service:"mysql"},sqlite:{name:"sqlite.org",version:"^3.47.2"}};function databaseAliases(connection,pkg){return[connection,pkg.name]}export function pantryDatabasePackage(connection){return DB_CONNECTION_PACKAGES[connection]}function detectDbPackage(cwd){const envPath=join(cwd,".env"),envExamplePath=join(cwd,".env.example"),filePath=existsSync(envPath)?envPath:existsSync(envExamplePath)?envExamplePath:void 0;if(!filePath)return;const match=readFileSync(filePath,"utf-8").match(/^DB_CONNECTION=(.+)$/m);if(!match)return;const value=match[1].trim().replace(/['"]/g,"");return pantryDatabasePackage(value)}export async function optimizePantryDeps(){const cwd=p.projectPath(),depsConfigPath=join(cwd,"config","deps.ts");if(!existsSync(depsConfigPath)){log.debug("No config/deps.ts found, skipping dependency optimization");return}let configDeps={},configServices=[];try{const mod=await import(depsConfigPath),config=mod.config||mod.default;if(config?.dependencies)configDeps={...config.dependencies};if(Array.isArray(config?.services?.autoStart))configServices=config.services.autoStart.filter((name)=>typeof name==="string")}catch(err){log.debug("Could not load config/deps.ts, skipping dependency optimization");return}const dbPackage=detectDbPackage(cwd),autoStart=[...configServices];if(dbPackage){const selected=new Set(Object.entries(DB_CONNECTION_PACKAGES).filter(([,pkg])=>pkg.name===dbPackage.name).flatMap(([connection,pkg])=>databaseAliases(connection,pkg))),unused=new Set(Object.entries(DB_CONNECTION_PACKAGES).flatMap(([connection,pkg])=>databaseAliases(connection,pkg)).filter((alias)=>!selected.has(alias)));for(const pkg of Object.keys(configDeps)){const domain=pkg.split("/")[0];if(unused.has(domain)){log.info(`DB_CONNECTION selects ${dbPackage.name}, dropping unused ${pkg}`);delete configDeps[pkg]}}if(!Object.keys(configDeps).some((key)=>{const domain=key.split("/")[0];return selected.has(domain)})){log.info(`Detected DB_CONNECTION requires ${dbPackage.name}, adding to dependencies`);configDeps[dbPackage.name]=dbPackage.version}if(dbPackage.service&&!autoStart.includes(dbPackage.service))autoStart.push(dbPackage.service)}const lines=["# Auto-generated from config/deps.ts and .env sniffing.","# This file is regenerated on each `buddy setup` run.","#","# To learn more, please visit:","# https://stacksjs.com/docs/dependency-management","","dependencies:"];for(const[pkg,version]of Object.entries(configDeps))lines.push(`  ${pkg}: ${version}`);if(autoStart.length>0){lines.push("","services:","  enabled: true","  autoStart:");for(const service of autoStart)lines.push(`    - ${service}`)}const depsYamlPath=join(cwd,"deps.yaml");writeFileSync(depsYamlPath,`${lines.join(`
 `)}
-`);
-  log.success("Generated deps.yaml from config/deps.ts");
-}
-export async function ensureEnvIsSet(options) {
-  log.info("Ensuring .env exists...");
-  const cwd = options.cwd || p.projectPath(), envPath = `${cwd}/.env`, envExamplePath = `${cwd}/.env.example`;
-  if (storage.doesNotExist(envPath)) {
-    try {
-      copyFile(envExamplePath, envPath);
-    } catch (error) {
-      handleError(error);
-      process.exit(ExitCode.FatalError);
-    }
-    log.success(".env created");
-  } else
-    log.success(".env existed");
-}
+`);log.success("Generated deps.yaml from config/deps.ts")}export async function ensureEnvIsSet(options){log.info("Ensuring .env exists...");const cwd=options.cwd||p.projectPath(),envPath=`${cwd}/.env`,envExamplePath=`${cwd}/.env.example`;if(storage.doesNotExist(envPath)){try{copyFile(envExamplePath,envPath)}catch(error){handleError(error);process.exit(ExitCode.FatalError)}log.success(".env created")}else log.success(".env existed")}