@tolinax/ayoune-cli 2026.10.0 → 2026.11.0

package/lib/commands/createServicesCommand.js

@@ -6,6 +6,7 @@ import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
 import { cliError } from "../helpers/cliError.js";
 import { aYOUneModules } from "../../data/modules.js";
 import { aYOUneServices } from "../../data/services.js";
+import { parseInteger } from "../helpers/parseInt.js";
 function buildServiceRegistry() {
     const services = [];
     // APIs from modules
@@ -70,9 +71,9 @@ export function createServicesCommand(program) {
         .command("endpoints <host>")
         .alias("ep")
         .description("List API endpoints for a service host")
-        .addHelpText("after", `
-Examples:
-  ay services endpoints ai.ayoune.app
+        .addHelpText("after", `
+Examples:
+  ay services endpoints ai.ayoune.app
   ay services endpoints crm-api.ayoune.app -r table`)
         .action(async (host, options) => {
         try {
@@ -117,7 +118,7 @@ Examples:
     svc
         .command("health [host]")
         .description("Check health of a service or all services")
-        .option("--timeout <ms>", "Request timeout in ms", parseInt, 5000)
+        .option("--timeout <ms>", "Request timeout in ms", parseInteger, 5000)
         .action(async (host, options) => {
         try {
             const opts = { ...program.opts(), ...options };
@@ -127,16 +128,17 @@ Examples:
             // Deduplicate by host
             const uniqueTargets = [...new Map(targets.map((t) => [t.host, t])).values()];
             spinner.start({ text: `Checking ${uniqueTargets.length} service(s)...`, color: "magenta" });
-            const { http } = await import("@tolinax/ayoune-core/lib/http");
             const results = await Promise.allSettled(uniqueTargets.map(async (t) => {
                 const start = Date.now();
+                // Native fetch with AbortController-driven timeout. We previously
+                // used @tolinax/ayoune-core's http wrapper here, but it loads the
+                // backend AY singleton (mongoose + ioredis + prom-client) at import
+                // time and has no place in a CLI process.
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), opts.timeout);
                 try {
-                    const resp = await http.get(`https://${t.host}/`, {
-                        timeout: opts.timeout,
-                        validateStatus: () => true,
-                        logging: false,
-                        metrics: false,
-                    });
+                    const resp = await fetch(`https://${t.host}/`, { signal: controller.signal });
+                    clearTimeout(timer);
                     return {
                         host: t.host,
                         name: t.name,
@@ -146,13 +148,14 @@ Examples:
                     };
                 }
                 catch (e) {
+                    clearTimeout(timer);
                     return {
                         host: t.host,
                         name: t.name,
                         status: "unreachable",
                         statusCode: 0,
                         responseTime: Date.now() - start,
-                        error: e.code || e.message,
+                        error: e.name === "AbortError" ? "timeout" : (e.code || e.message),
                     };
                 }
             }));

package/lib/commands/createSetupCommand.js

@@ -8,6 +8,7 @@ import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
 import { cliError } from "../helpers/cliError.js";
 import { detectRuntime } from "../helpers/dockerCompose.js";
+import { printNextSteps } from "../helpers/printNextSteps.js";
 const AVAILABLE_MODULES = [
     { name: "CRM", value: "crm", description: "Customer Relationship Management" },
     { name: "Marketing", value: "marketing", description: "Marketing automation & campaigns" },
@@ -306,20 +307,16 @@ Examples:
                 await writeFile(valuesPath, valuesContent, "utf-8");
                 spinner.success({ text: "Configuration files generated!" });
                 spinner.stop();
-                console.log(chalk.green("\n  Generated files:"));
-                console.log(chalk.dim(`    ${envPath}`));
-                console.log(chalk.dim(`    ${valuesPath}`));
-                console.log(chalk.cyan("\n  Next steps:"));
-                console.log(chalk.dim("    1. Review and adjust the generated files"));
-                console.log(chalk.dim("    2. helm install ayoune tolinax/ayoune -f values.yaml"));
-                console.log(chalk.dim("    3. ay status  — verify all services are healthy\n"));
+                printNextSteps([
+                    "Review and adjust the generated files",
+                    "helm install ayoune tolinax/ayoune -f values.yaml",
+                    "ay status — verify all services are healthy",
+                ], { preamble: ["Generated files:", `  ${envPath}`, `  ${valuesPath}`] });
             }
             else {
                 spinner.success({ text: "Configuration files generated!" });
                 spinner.stop();
                 const profiles = ["core", ...answers.modules];
-                console.log(chalk.green("\n  Generated files:"));
-                console.log(chalk.dim(`    ${envPath}`));
                 // Offer to launch the stack right away. Skipped non-interactively
                 // (CI / piped) — that path keeps the original "next steps" output.
                 const canLaunch = process.stdin.isTTY && detectRuntime() === "compose";
@@ -339,10 +336,11 @@ Examples:
                     }
                 }
                 if (!launched) {
-                    console.log(chalk.cyan("\n  Next steps:"));
-                    console.log(chalk.dim("    1. Review and adjust the .env file"));
-                    console.log(chalk.dim(`    2. docker compose --profile ${profiles.join(" --profile ")} up -d`));
-                    console.log(chalk.dim("    3. ay status  — verify all services are healthy\n"));
+                    printNextSteps([
+                        "Review and adjust the .env file",
+                        `docker compose --profile ${profiles.join(" --profile ")} up -d`,
+                        "ay status — verify all services are healthy",
+                    ], { preamble: ["Generated files:", `  ${envPath}`] });
                 }
             }
             if (!answers.licenseKey) {

package/lib/commands/createSyncCommand.js

@@ -3,6 +3,7 @@ import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOpti
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
 import { cliError } from "../helpers/cliError.js";
+import { parseInteger } from "../helpers/parseInt.js";
 export function createSyncCommand(program) {
     const sync = program
         .command("sync")
@@ -11,10 +12,10 @@ export function createSyncCommand(program) {
     sync
         .command("repos")
         .description("Sync repositories from connected providers")
-        .addHelpText("after", `
-Examples:
-  ay sync repos                      Sync all repositories
-  ay sync repos --provider bitbucket  Sync only Bitbucket repos
+        .addHelpText("after", `
+Examples:
+  ay sync repos                      Sync all repositories
+  ay sync repos --provider bitbucket  Sync only Bitbucket repos
   ay sync repos --id <repoId>        Sync a specific repository`)
         .option("--provider <provider>", "Filter by provider (bitbucket, github)")
         .option("--id <repoId>", "Sync a specific repository by ID")
@@ -112,7 +113,7 @@ Examples:
         .command("pipelines")
         .description("Sync pipeline status from CI/CD providers")
         .option("--provider <provider>", "Filter by provider (bitbucket, github)")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
         .action(async (options) => {
         try {
             const opts = { ...program.opts(), ...options };

package/lib/commands/createTemplateCommand.js

@@ -4,6 +4,7 @@ import { saveFile } from "../helpers/saveFile.js";
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
 import { cliError } from "../helpers/cliError.js";
+import { parseInteger } from "../helpers/parseInt.js";
 export function createTemplateCommand(program) {
     const tmpl = program
         .command("templates")
@@ -19,8 +20,8 @@ export function createTemplateCommand(program) {
         .alias("ls")
         .description("List email templates")
         .option("--search <query>", "Search by name")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
-        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
+        .option("-p, --page <number>", "Page number", parseInteger, 1)
         .action(async (options) => {
         var _a, _b, _c;
         try {
@@ -76,8 +77,8 @@ export function createTemplateCommand(program) {
         .command("list")
         .alias("ls")
         .description("List notification templates")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
-        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
+        .option("-p, --page <number>", "Page number", parseInteger, 1)
         .action(async (options) => {
         var _a, _b, _c;
         try {
@@ -129,7 +130,7 @@ export function createTemplateCommand(program) {
         .command("list")
         .alias("ls")
         .description("List report templates")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
         .action(async (options) => {
         var _a, _b, _c;
         try {
@@ -162,8 +163,8 @@ export function createTemplateCommand(program) {
         .description("List available store templates")
         .option("--category <category>", "Filter by category")
         .option("--search <query>", "Search templates")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
-        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
+        .option("-p, --page <number>", "Page number", parseInteger, 1)
         .action(async (options) => {
         var _a, _b, _c;
         try {

package/lib/commands/createUsersCommand.js

@@ -5,6 +5,7 @@ import { saveFile } from "../helpers/saveFile.js";
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
 import { cliError } from "../helpers/cliError.js";
+import { parseInteger } from "../helpers/parseInt.js";
 export function createUsersCommand(program) {
     const users = program
         .command("users")
@@ -18,8 +19,8 @@ export function createUsersCommand(program) {
         .option("--search <query>", "Search by name or email")
         .option("--role <roleId>", "Filter by role ID")
         .option("--active", "Show only active users")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
-        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
+        .option("-p, --page <number>", "Page number", parseInteger, 1)
         .action(async (options) => {
         var _a, _b, _c;
         try {
@@ -138,8 +139,8 @@ export function createUsersCommand(program) {
         .alias("ls")
         .description("List teams")
         .option("--search <query>", "Search teams by name")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
-        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
+        .option("-p, --page <number>", "Page number", parseInteger, 1)
         .action(async (options) => {
         var _a, _b, _c;
         try {
@@ -230,7 +231,7 @@ export function createUsersCommand(program) {
         .command("list")
         .alias("ls")
         .description("List available roles")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
         .action(async (options) => {
         var _a, _b, _c;
         try {

package/lib/commands/createWebhooksCommand.js

@@ -4,6 +4,7 @@ import { saveFile } from "../helpers/saveFile.js";
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
 import { cliError } from "../helpers/cliError.js";
+import { parseInteger } from "../helpers/parseInt.js";
 export function createWebhooksCommand(program) {
     const hooks = program
         .command("webhooks")
@@ -14,8 +15,8 @@ export function createWebhooksCommand(program) {
         .command("list")
         .alias("ls")
         .description("List registered webhooks")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
-        .option("-p, --page <number>", "Page number", parseInt, 1)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
+        .option("-p, --page <number>", "Page number", parseInteger, 1)
         .action(async (options) => {
         var _a, _b;
         try {
@@ -124,7 +125,7 @@ export function createWebhooksCommand(program) {
     hooks
         .command("templates")
         .description("List available webhook templates")
-        .option("-l, --limit <number>", "Limit results", parseInt, 50)
+        .option("-l, --limit <number>", "Limit results", parseInteger, 50)
         .action(async (options) => {
         var _a, _b;
         try {

package/lib/commands/deploy/alerts.js

@@ -7,13 +7,14 @@ import { saveFile } from "../../helpers/saveFile.js";
 import { spinner } from "../../../index.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { cliError } from "../../helpers/cliError.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addAlertsSubcommands(deploy, rootProgram) {
     deploy
         .command("alerts")
         .description("List active deployment alerts")
         .option("--severity <level>", "Filter: critical, warning, info")
         .option("--type <type>", "Filter: pod_crash, oom_killed, image_pull_error, deployment_failed, pipeline_failed, cluster_unreachable, high_restart_count, custom")
-        .option("-l, --limit <number>", "Limit", parseInt, 50)
+        .option("-l, --limit <number>", "Limit", parseInteger, 50)
         .action(async (options) => {
         var _a, _b, _c;
         try {

package/lib/commands/deploy/clusters.js

@@ -8,6 +8,7 @@ import { saveFile } from "../../helpers/saveFile.js";
 import { spinner } from "../../../index.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { cliError } from "../../helpers/cliError.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addClustersSubcommands(deploy, rootProgram) {
     // ay deploy clusters
     deploy
@@ -18,7 +19,7 @@ export function addClustersSubcommands(deploy, rootProgram) {
 Examples:
   ay deploy clusters                   List all clusters
   ay deploy clusters -r table          Show clusters in table format`)
-        .option("-l, --limit <number>", "Limit", parseInt, 50)
+        .option("-l, --limit <number>", "Limit", parseInteger, 50)
         .action(async (options) => {
         var _a, _b, _c;
         try {

package/lib/commands/deploy/deployments.js

@@ -11,6 +11,7 @@ import { spinner } from "../../../index.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { cliError } from "../../helpers/cliError.js";
 import { getDeployToken } from "./_token.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addDeploymentsSubcommands(deploy, rootProgram) {
     // ay deploy list
     deploy
@@ -21,8 +22,8 @@ export function addDeploymentsSubcommands(deploy, rootProgram) {
         .option("--namespace <ns>", "Filter by namespace")
         .option("--health <status>", "Filter: healthy, degraded, crashed, pending")
         .option("-q, --search <term>", "Search by name")
-        .option("-l, --limit <number>", "Limit", parseInt, 50)
-        .option("-p, --page <number>", "Page", parseInt, 1)
+        .option("-l, --limit <number>", "Limit", parseInteger, 50)
+        .option("-p, --page <number>", "Page", parseInteger, 1)
         .action(async (options) => {
         var _a, _b;
         try {
@@ -85,7 +86,7 @@ Examples:
   ay deploy logs 64a1b2c3d4e5 --follow       Stream logs in real-time (SSE)
   ay deploy logs 64a1b2c3d4e5 --tail 100     Last 100 log lines`)
         .option("-f, --follow", "Stream logs in real-time (Server-Sent Events)")
-        .option("--tail <lines>", "Number of recent log lines", parseInt, 50)
+        .option("--tail <lines>", "Number of recent log lines", parseInteger, 50)
         .action(async (id, options) => {
         try {
             const opts = { ...rootProgram.opts(), ...options };

package/lib/commands/deploy/pipelines.js

@@ -10,6 +10,7 @@ import { saveFile } from "../../helpers/saveFile.js";
 import { spinner } from "../../../index.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { cliError } from "../../helpers/cliError.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addPipelinesSubcommands(deploy, rootProgram) {
     // ay deploy pipelines
     deploy
@@ -18,7 +19,7 @@ export function addPipelinesSubcommands(deploy, rootProgram) {
         .description("List recent CI/CD pipelines")
         .option("--repo <slug>", "Filter by repository slug")
         .option("--result <result>", "Filter: SUCCESSFUL, FAILED, STOPPED, EXPIRED")
-        .option("-l, --limit <number>", "Limit", parseInt, 20)
+        .option("-l, --limit <number>", "Limit", parseInteger, 20)
         .action(async (options) => {
         var _a, _b, _c;
         try {

package/lib/commands/deploy/plans.js

@@ -8,6 +8,7 @@ import { saveFile } from "../../helpers/saveFile.js";
 import { spinner } from "../../../index.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { cliError } from "../../helpers/cliError.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addPlansSubcommands(deploy, rootProgram) {
     const plans = deploy.command("plans").description("Manage multi-step deployment plans");
     // ay deploy plans list
@@ -15,8 +16,8 @@ export function addPlansSubcommands(deploy, rootProgram) {
         .command("list")
         .alias("ls")
         .description("List deployment plans")
-        .option("-l, --limit <number>", "Limit", parseInt, 50)
-        .option("-p, --page <number>", "Page", parseInt, 1)
+        .option("-l, --limit <number>", "Limit", parseInteger, 50)
+        .option("-p, --page <number>", "Page", parseInteger, 1)
         .action(async (options) => {
         var _a, _b, _c;
         try {

package/lib/commands/deploy/pods.js

@@ -8,6 +8,7 @@ import { saveFile } from "../../helpers/saveFile.js";
 import { spinner } from "../../../index.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { cliError } from "../../helpers/cliError.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addPodsSubcommands(deploy, rootProgram) {
     // ay deploy pods
     deploy
@@ -17,7 +18,7 @@ export function addPodsSubcommands(deploy, rootProgram) {
         .option("--namespace <ns>", "Filter by namespace")
         .option("--status <status>", "Filter: Running, Pending, Failed, Succeeded, Unknown")
         .option("--deployment <name>", "Filter by deployment")
-        .option("-l, --limit <number>", "Limit", parseInt, 100)
+        .option("-l, --limit <number>", "Limit", parseInteger, 100)
         .action(async (options) => {
         var _a, _b, _c;
         try {

package/lib/commands/deploy/repos.js

@@ -8,6 +8,7 @@ import { saveFile } from "../../helpers/saveFile.js";
 import { spinner } from "../../../index.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { cliError } from "../../helpers/cliError.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addReposSubcommands(deploy, rootProgram) {
     const repos = deploy.command("repos").description("Manage git repositories");
     // ay deploy repos list
@@ -16,8 +17,8 @@ export function addReposSubcommands(deploy, rootProgram) {
         .alias("ls")
         .description("List registered repositories")
         .option("--provider <provider>", "Filter: bitbucket, github")
-        .option("-l, --limit <number>", "Limit", parseInt, 50)
-        .option("-p, --page <number>", "Page", parseInt, 1)
+        .option("-l, --limit <number>", "Limit", parseInteger, 50)
+        .option("-p, --page <number>", "Page", parseInteger, 1)
         .action(async (options) => {
         var _a, _b, _c;
         try {

package/lib/commands/functions/list.js

@@ -5,13 +5,14 @@ import { handleResponseFormatOptions } from "../../helpers/handleResponseFormatO
 import { cliError } from "../../helpers/cliError.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { FN_MODULE, FN_COLLECTION } from "./_shared.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addListSubcommand(fns, rootProgram) {
     fns
         .command("list")
         .alias("ls")
         .description("List user functions for the current customer")
-        .option("-l, --limit <n>", "Limit results", (v) => parseInt(v, 10), 50)
-        .option("-p, --page <n>", "Page number", (v) => parseInt(v, 10), 1)
+        .option("-l, --limit <n>", "Limit results", parseInteger, 50)
+        .option("-p, --page <n>", "Page number", parseInteger, 1)
         .option("--trigger <type>", "Filter by trigger type (cron, http, event, manual, queue)")
         .option("--search <q>", "Search by name or slug")
         .action(async (options) => {

package/lib/commands/functions/logs.js

@@ -10,6 +10,7 @@ import { handleResponseFormatOptions } from "../../helpers/handleResponseFormatO
 import { cliError } from "../../helpers/cliError.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { FN_MODULE, FN_COLLECTION, resolveFunction } from "./_shared.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 function printLogLines(entries) {
     var _a, _b, _c, _d, _e;
     for (const entry of entries) {
@@ -25,7 +26,7 @@ export function addLogsSubcommand(fns, rootProgram) {
         .command("logs <id-or-slug>")
         .description("Show execution logs for a function")
         .option("-f, --follow", "Poll for new log entries every 2s", false)
-        .option("-t, --tail <n>", "Number of recent entries to show", (v) => parseInt(v, 10), 50)
+        .option("-t, --tail <n>", "Number of recent entries to show", parseInteger, 50)
         .option("--json", "Output raw JSON instead of formatted lines", false)
         .action(async (idOrSlug, options) => {
         var _a;

package/lib/commands/functions/versions.js

@@ -8,11 +8,12 @@ import { handleResponseFormatOptions } from "../../helpers/handleResponseFormatO
 import { cliError } from "../../helpers/cliError.js";
 import { EXIT_GENERAL_ERROR } from "../../exitCodes.js";
 import { FN_MODULE, FN_COLLECTION, resolveFunction } from "./_shared.js";
+import { parseInteger } from "../../helpers/parseInt.js";
 export function addVersionsSubcommand(fns, rootProgram) {
     fns
         .command("versions <id-or-slug>")
         .description("Show version history for a function")
-        .option("-l, --limit <n>", "Limit results", (v) => parseInt(v, 10), 50)
+        .option("-l, --limit <n>", "Limit results", parseInteger, 50)
         .action(async (idOrSlug, options) => {
         var _a, _b, _c, _d, _e;
         try {

package/lib/commands/provision/hetzner.js

@@ -23,6 +23,7 @@ import { requireTool } from "./_detectTools.js";
 import { runBaseWizard } from "./_wizard.js";
 import { writeState } from "./_stateFile.js";
 import { spawn } from "child_process";
+import { parseInteger } from "../../helpers/parseInt.js";
 const HETZNER_REGIONS = ["nbg1", "fsn1", "hel1", "ash", "hil", "sin"];
 const HETZNER_INSTANCE_SIZES = ["cax21", "cax31", "cax41", "ccx13", "ccx23", "ccx33"];
 /** Stream a command (NOT docker compose) to the user's terminal. */
@@ -44,7 +45,7 @@ export function addHetznerSubcommand(prov) {
         .option("--token <token>", "Hetzner Cloud API token (or set HCLOUD_TOKEN)")
         .option("--region <region>", `Hetzner location (${HETZNER_REGIONS.join(", ")})`, "nbg1")
         .option("--size <size>", `Server type (${HETZNER_INSTANCE_SIZES.join(", ")})`, "cax21")
-        .option("--servers <n>", "Number of worker nodes", (v) => parseInt(v, 10), 3)
+        .option("--servers <n>", "Number of worker nodes", parseInteger, 3)
         .option("--dry-run", "Render terraform.tfvars and run `terraform plan` only", false)
         .option("-y, --yes", "Skip the final apply confirmation prompt", false)
         .action(async (options) => {

package/lib/helpers/printNextSteps.js

@@ -0,0 +1,34 @@
+// Tiny shared helper for the "Next steps" footer that several commands print
+// at the end of a successful run (setup, provision, local up, ...). The goal
+// is consistent visual framing across the CLI without taking on a `boxen`
+// dep — boxen is ~30 KB and we already keep the dep tree thin on purpose.
+//
+// Usage:
+//   printNextSteps([
+//     "Review the .env file",
+//     "docker compose --profile core up -d",
+//     "ay status — verify all services are healthy",
+//   ]);
+//
+// Or with a heading:
+//   printNextSteps(steps, { title: "Almost done!" });
+//
+// The output goes through console.log so it inherits whatever stdout is
+// hooked up (a TTY in normal use, /dev/null when piped). It does NOT use the
+// spinner — call this AFTER spinner.success/spinner.stop so it doesn't
+// fight the spinner's rendering loop.
+import chalk from "chalk";
+export function printNextSteps(steps, opts = {}) {
+    var _a;
+    if (opts.preamble && opts.preamble.length > 0) {
+        console.log("");
+        for (const line of opts.preamble) {
+            console.log(chalk.green(`  ${line}`));
+        }
+    }
+    console.log(chalk.cyan(`\n  ${(_a = opts.title) !== null && _a !== void 0 ? _a : "Next steps:"}`));
+    steps.forEach((step, i) => {
+        console.log(chalk.dim(`    ${i + 1}. ${step}`));
+    });
+    console.log("");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tolinax/ayoune-cli",
-  "version": "2026.10.0",
+  "version": "2026.11.0",
   "description": "CLI for the aYOUne Business-as-a-Service platform",
   "type": "module",
   "main": "./index.js",