@stacksjs/buddy 0.70.162 → 0.70.163

package/dist/commands/ai-context.d.ts

@@ -0,0 +1,13 @@
+import type { CLI, CliOptions } from '@stacksjs/types';
+export declare function generateAiContextOutput(options?: AiContextCommandOptions, projectRoot?: string): AiContextCommandResult;
+export declare function aiContext(buddy: CLI): void;
+export declare interface AiContextCommandOptions extends CliOptions {
+  json?: boolean
+  output?: string
+  maxChars?: string | number
+  model?: string
+}
+export declare interface AiContextCommandResult {
+  output: string
+  outputPath: string | null
+}

package/dist/commands/ai-context.js

@@ -0,0 +1,29 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import process from "node:process";
+import { buildProjectContext } from "@stacksjs/ai";
+import { onUnknownSubcommand } from "@stacksjs/cli";
+export function generateAiContextOutput(options = {}, projectRoot = process.cwd()) {
+  const maxChars = options.maxChars === void 0 ? void 0 : Number(options.maxChars), result = buildProjectContext(projectRoot, { maxChars, model: options.model }), output = options.json ? `${JSON.stringify(result, null, 2)}
+` : `${result.text}
+
+Context metrics:
+${JSON.stringify(result.metrics, null, 2)}
+`;
+  if (!options.output)
+    return { output, outputPath: null };
+  const outputPath = resolve(projectRoot, String(options.output));
+  mkdirSync(dirname(outputPath), { recursive: !0 });
+  writeFileSync(outputPath, output);
+  return { output, outputPath };
+}
+export function aiContext(buddy) {
+  buddy.command("ai:context", "Generate compact deterministic project context for coding models").option("-J, --json", "Emit the versioned machine-readable context contract", { default: !1 }).option("-o, --output [path]", "Write output to a file instead of stdout").option("--max-chars [characters]", "Maximum characters in the prompt context payload", { default: 4000 }).option("--model [model]", "Model family used for the heuristic token estimate", { default: "gpt-4o" }).example("buddy ai:context").example("buddy ai:context --json").example("buddy ai:context --json --output .stacks/ai-context.json").action((options) => {
+    const generated = generateAiContextOutput(options);
+    if (generated.outputPath)
+      console.log(`Wrote AI project context to ${generated.outputPath}`);
+    else
+      process.stdout.write(generated.output);
+  });
+  onUnknownSubcommand(buddy, "ai:context");
+}

package/dist/commands/deploy.js

@@ -395,7 +395,7 @@ async function pollUntil(opts) {
   let lastHeartbeat = 0;
   for (;; )
     try {
-      opts.check();
+      await opts.check();
       return;
     } catch {
       const elapsedSecs = Math.floor((Date.now() - started) / 1000);
@@ -408,33 +408,18 @@ async function pollUntil(opts) {
       await new Promise((r) => setTimeout(r, opts.intervalMs ?? 5000));
     }
 }
-async function waitForRemoteReady(ip, verbose) {
-  const { execSync } = await import("node:child_process"), sshArgs = [
-    "-o",
-    "StrictHostKeyChecking=no",
-    "-o",
-    "UserKnownHostsFile=/dev/null",
-    "-o",
-    "BatchMode=yes",
-    "-o",
-    "ConnectTimeout=10",
-    `root@${ip}`
-  ], run = (remote) => execSync(`ssh ${sshArgs.map((a) => `'${a}'`).join(" ")} '${remote.replace(/'/g, "'\\''")}'`, {
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", verbose ? "inherit" : "pipe"]
-  }), sshWaitSecs = readWaitSecs("TS_CLOUD_SSH_WAIT_SECS", 480);
+async function waitForRemoteReady(ip) {
+  const { sshExecOrThrow } = await import("@stacksjs/ts-cloud"), run = (remote) => sshExecOrThrow(ip, remote, { user: "root", connectTimeoutSec: 10 }), sshWaitSecs = readWaitSecs("TS_CLOUD_SSH_WAIT_SECS", 480);
   await pollUntil({
     label: "Waiting for SSH to come up",
     timeoutSecs: sshWaitSecs,
-    check: () => {
-      run("true");
-    },
+    check: () => run("true"),
     timeoutMessage: (elapsed) => `SSH did not become reachable on ${ip} within ${fmtDuration(sshWaitSecs)} (waited ${elapsed}s). ` + "The box may still be booting \u2014 raise TS_CLOUD_SSH_WAIT_SECS and retry."
   });
   log.success("SSH is up");
   log.info("Waiting for cloud-init (installing bun + caddy)...");
   try {
-    run("cloud-init status --wait || true");
+    await run("cloud-init status --wait || true");
   } catch (err) {
     log.debug("cloud-init status --wait returned non-zero (continuing):", err);
   }
@@ -442,9 +427,7 @@ async function waitForRemoteReady(ip, verbose) {
   await pollUntil({
     label: "Waiting for the bun runtime",
     timeoutSecs: bootWaitSecs,
-    check: () => {
-      run("test -x /usr/local/bin/bun");
-    },
+    check: () => run("test -x /usr/local/bin/bun"),
     timeoutMessage: (elapsed) => `bun runtime did not appear at /usr/local/bin/bun within ${fmtDuration(bootWaitSecs)} (waited ${elapsed}s). ` + "cloud-init may have failed \u2014 SSH in and check /var/log/cloud-init-output.log; " + "raise TS_CLOUD_BOOT_WAIT_SECS for slow regions."
   });
   log.success("Server is ready (bun installed)");
@@ -716,7 +699,7 @@ async function runHetznerDeploy(args) {
     log.error("Provisioned server has no public IP \u2014 cannot deploy over SSH.");
     process.exit(ExitCode.FatalError);
   }
-  await waitForRemoteReady(ip, verbose);
+  await waitForRemoteReady(ip);
   const { execSync } = await import("node:child_process"), { tmpdir } = await import("node:os"), sites = applyEnvironmentToSites(tsCloudConfig.sites || {}, environment, tsCloudConfig), slug = tsCloudConfig.project?.slug || "app";
   let sha;
   try {

package/dist/commands/migrate.js

@@ -214,7 +214,7 @@ export function migrate(buddy) {
             log.info(`  \u2022 ${describeOp(op)}${op.destructive ? "  [destructive]" : ""}`);
         }
       } catch (error) {
-        log.error("Failed to preview migrations:", error);
+        await log.error("Failed to preview migrations:", error);
       }
       await outro("Diff complete \u2014 no changes applied.", { startTime: perf, useSeconds: !0 });
       process.exit(ExitCode.Success);
@@ -224,6 +224,7 @@ export function migrate(buddy) {
         log.debug("[migrate] confirmMigrate guard skipped \u2014 non-interactive environment.");
       else {
         const APP_ENV = process.env.APP_ENV || "local";
+        await log.flush();
         if (!await confirm({
           message: `Run migrations against the ${APP_ENV} database "${currentDatabaseLabel()}"?`,
           initial: !0
@@ -234,7 +235,7 @@ export function migrate(buddy) {
       }
     const lock = acquireMigrationLock();
     if (!lock.acquired) {
-      log.error("Another migration is already running (.stacks/migrations.lock exists). Wait for it to finish, or remove the lockfile if it is stale.");
+      log.syncError("Another migration is already running (.stacks/migrations.lock exists). Wait for it to finish, or remove the lockfile if it is stale.");
       process.exit(ExitCode.FatalError);
     }
     if (!await confirmDestructiveMigrations({ force: options.force, fromDb: options.fromDb, applyRenames })) {
@@ -303,7 +304,7 @@ export function migrate(buddy) {
     }
     const guards = await resolveMigrationGuards(), dbLabel = currentDatabaseLabel(), APP_ENV = process.env.APP_ENV || "local";
     if (guards.migrateFresh === "disabled") {
-      log.error(`\`buddy migrate:fresh\` is disabled by your migration safety guards (it DROPS every table).
+      await log.error(`\`buddy migrate:fresh\` is disabled by your migration safety guards (it DROPS every table).
   Target: ${APP_ENV} database "${dbLabel}"
   To allow it, set database.safety.migrateFresh to 'allow' in config/database.ts,
   or run once with: DB_MIGRATE_FRESH=allow ./buddy migrate:fresh`);
@@ -313,11 +314,12 @@ export function migrate(buddy) {
     if (!(guards.migrateFresh === "allow" && options.force === !0)) {
       if (isCI || !hasTTY) {
         const hint = guards.migrateFresh === "confirm" ? 'Guard is "confirm": migrate:fresh must be run interactively.' : "Re-run with --force to drop the database non-interactively.";
-        log.error(`Refusing to drop the ${APP_ENV} database "${dbLabel}" in a non-interactive environment. ${hint}`);
+        await log.error(`Refusing to drop the ${APP_ENV} database "${dbLabel}" in a non-interactive environment. ${hint}`);
         await outro("migrate:fresh cancelled.", { startTime: perf, useSeconds: !0 });
         process.exit(ExitCode.FatalError);
       }
       log.warn(`This will DROP ALL TABLES in the ${APP_ENV} database "${dbLabel}" and rebuild them from scratch. All data will be lost.`);
+      await log.flush();
       if ((await text({ message: `Type the database name "${dbLabel}" to confirm (blank to cancel):` })).trim() !== dbLabel) {
         await outro("migrate:fresh cancelled \u2014 confirmation did not match.", { startTime: perf, useSeconds: !0 });
         process.exit(ExitCode.Success);

package/dist/lazy-commands.js

@@ -1,6 +1,7 @@
 const commandRegistry = {
   about: { path: "./commands/about.js", exportName: "about" },
   add: { path: "./commands/add.js", exportName: "add" },
+  "ai:context": { path: "./commands/ai-context.js", exportName: "aiContext" },
   auth: { path: "./commands/auth.js", exportName: "auth" },
   build: { path: "./commands/build.js", exportName: "build" },
   cd: { path: "./commands/cd.js", exportName: "cd" },

package/dist/project-setup.js

@@ -12,6 +12,7 @@ const APP_KEY_OPTIONAL_COMMANDS = [
   "clean",
   "fresh",
   "about",
+  "ai:context",
   "doctor",
   "list",
   "setup",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/buddy",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.162",
+  "version": "0.70.163",
   "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "contributors": [
@@ -64,7 +64,6 @@
   "types": "dist/index.d.ts",
   "bin": {
     "stacks": "dist/cli.js",
-    "stx": "dist/cli.js",
     "buddy": "dist/cli.js",
     "bud": "dist/cli.js"
   },
@@ -92,51 +91,51 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@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/actions": "^0.70.163",
+    "@stacksjs/ai": "^0.70.163",
+    "@stacksjs/alias": "^0.70.163",
+    "@stacksjs/arrays": "^0.70.163",
+    "@stacksjs/auth": "^0.70.163",
+    "@stacksjs/build": "^0.70.163",
+    "@stacksjs/cache": "^0.70.163",
+    "@stacksjs/cli": "^0.70.163",
     "@stacksjs/clapp": "^0.2.12",
-    "@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/cloud": "^0.70.163",
+    "@stacksjs/collections": "^0.70.163",
+    "@stacksjs/config": "^0.70.163",
+    "@stacksjs/database": "^0.70.163",
+    "@stacksjs/desktop": "^0.70.163",
+    "@stacksjs/dns": "^0.70.163",
+    "@stacksjs/email": "^0.70.163",
+    "@stacksjs/enums": "^0.70.163",
+    "@stacksjs/error-handling": "^0.70.163",
+    "@stacksjs/events": "^0.70.163",
+    "@stacksjs/git": "^0.70.163",
     "@stacksjs/gitit": "^0.2.5",
-    "@stacksjs/health": "^0.70.162",
+    "@stacksjs/health": "^0.70.163",
     "@stacksjs/dnsx": "^0.2.3",
     "@stacksjs/httx": "^0.1.10",
-    "@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/lint": "^0.70.163",
+    "@stacksjs/logging": "^0.70.163",
+    "@stacksjs/notifications": "^0.70.163",
+    "@stacksjs/objects": "^0.70.163",
+    "@stacksjs/orm": "^0.70.163",
+    "@stacksjs/path": "^0.70.163",
+    "@stacksjs/payments": "^0.70.163",
+    "@stacksjs/realtime": "^0.70.163",
+    "@stacksjs/router": "^0.70.163",
     "@stacksjs/rpx": "^0.11.31",
-    "@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/search-engine": "^0.70.163",
+    "@stacksjs/security": "^0.70.163",
+    "@stacksjs/server": "^0.70.163",
+    "@stacksjs/storage": "^0.70.163",
+    "@stacksjs/strings": "^0.70.163",
+    "@stacksjs/testing": "^0.70.163",
+    "@stacksjs/tunnel": "^0.70.163",
+    "@stacksjs/types": "^0.70.163",
+    "@stacksjs/ui": "^0.70.163",
+    "@stacksjs/utils": "^0.70.163",
+    "@stacksjs/validation": "^0.70.163",
     "@stacksjs/ts-cloud": "^0.7.56"
   },
   "devDependencies": {