@tolinax/ayoune-cli 2026.11.1 → 2026.11.2

package/lib/commands/createProgram.js

@@ -214,6 +214,7 @@ function installPreActionHook(program) {
  */
 function installGlobalOptions(program) {
     program
+        .name("ay")
         .version(pkg.version || "0.0.0")
         .addOption(new Option("-r, --responseFormat <format>", "Set the output format")
         .choices(["json", "csv", "yaml", "table"])
@@ -292,6 +293,16 @@ export async function createProgram(program) {
         // Lightweight stubs for every command so the help listing is complete and
         // commander can suggest similar names for typos.
         registerStubsForHelp(program);
+        // Bare `ay` (no args) should print help and exit cleanly. Commander's
+        // default behaviour is to print help then exit with code 1, treating
+        // "no command" as a usage error. For an end-user CLI that's hostile —
+        // a user typing `ay` to discover the tool gets a non-zero exit, which
+        // breaks shell scripts that gate on `ay && ...`. Force exit 0 here for
+        // the bare invocation.
+        if (process.argv.length <= 2) {
+            program.outputHelp();
+            process.exit(0);
+        }
     }
     else if (kind === "cmdHelp" || kind === "command") {
         if (spec) {

package/lib/commands/createServicesCommand.js

@@ -1,5 +1,5 @@
 import { apiCallHandler } from "../api/apiCallHandler.js";
-import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { handleResponseFormatOptions, printFormattedResponse, } from "../helpers/handleResponseFormatOptions.js";
 import { saveFile } from "../helpers/saveFile.js";
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
@@ -56,9 +56,10 @@ export function createServicesCommand(program) {
                 payload: services,
                 meta: { responseTime: 0, pageInfo: { totalEntries: services.length, page: 1, totalPages: 1 } },
             };
-            handleResponseFormatOptions(opts, res);
+            const formatted = handleResponseFormatOptions(opts, res, { noPrint: true });
             spinner.success({ text: `Found ${services.length} services` });
             spinner.stop();
+            printFormattedResponse(opts, formatted);
             if (opts.save)
                 await saveFile("services-list", opts, res);
         }
@@ -104,9 +105,10 @@ Examples:
                 payload: endpoints,
                 meta: { responseTime: 0, pageInfo: { totalEntries: endpoints.length, page: 1, totalPages: 1 } },
             };
-            handleResponseFormatOptions(opts, formattedRes);
+            const formatted = handleResponseFormatOptions(opts, formattedRes, { noPrint: true });
             spinner.success({ text: `Found ${endpoints.length} endpoints on ${host}` });
             spinner.stop();
+            printFormattedResponse(opts, formatted);
             if (opts.save)
                 await saveFile("service-endpoints", opts, formattedRes);
         }
@@ -168,9 +170,10 @@ Examples:
                     pageInfo: { totalEntries: payload.length, page: 1, totalPages: 1 },
                 },
             };
-            handleResponseFormatOptions(opts, res);
+            const formatted = handleResponseFormatOptions(opts, res, { noPrint: true });
             spinner.success({ text: `${healthy}/${uniqueTargets.length} services healthy` });
             spinner.stop();
+            printFormattedResponse(opts, formatted);
             if (opts.save)
                 await saveFile("services-health", opts, res);
         }
@@ -216,9 +219,10 @@ Examples:
                 payload: description,
                 meta: { responseTime: 0 },
             };
-            handleResponseFormatOptions(opts, formattedRes);
+            const formatted = handleResponseFormatOptions(opts, formattedRes, { noPrint: true });
             spinner.success({ text: `Module: ${moduleName} — ${moduleActions.length} endpoints` });
             spinner.stop();
+            printFormattedResponse(opts, formatted);
         }
         catch (e) {
             cliError(e.message || "Failed to describe service", EXIT_GENERAL_ERROR);

package/lib/helpers/handleResponseFormatOptions.js

@@ -32,7 +32,23 @@ function filterColumns(data, columns) {
     }
     return data;
 }
-export function handleResponseFormatOptions(opts, res) {
+/**
+ * Print a previously-computed formatted response to stdout. Mirrors the
+ * print branch of `handleResponseFormatOptions` exactly. Call this AFTER
+ * `spinner.success(...)` / `spinner.stop()` so the data block appears below
+ * the spinner status line, not before it.
+ */
+export function printFormattedResponse(opts, formatted) {
+    if (opts.quiet)
+        return;
+    if (opts.responseFormat === "table") {
+        console.table(formatted.result);
+    }
+    else if (formatted.content !== undefined) {
+        console.log(formatted.content);
+    }
+}
+export function handleResponseFormatOptions(opts, res, formatOpts = {}) {
     let plainResult;
     let result;
     let meta = {};
@@ -122,13 +138,9 @@ export function handleResponseFormatOptions(opts, res) {
     else {
         content = JSON.stringify(result, null, 4);
     }
-    if (!opts.quiet) {
-        if (opts.responseFormat === "table") {
-            console.table(result);
-        }
-        else if (content !== undefined) {
-            console.log(content);
-        }
+    const formatted = { plainResult, result, meta, content };
+    if (!formatOpts.noPrint) {
+        printFormattedResponse(opts, formatted);
     }
-    return { plainResult, result, meta, content };
+    return formatted;
 }

package/lib/operations/handleAuditOperation.js

@@ -1,6 +1,6 @@
 // Operation handling functions
 import { spinner } from "../../index.js";
-import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { handleResponseFormatOptions, printFormattedResponse, } from "../helpers/handleResponseFormatOptions.js";
 import { localStorage } from "../helpers/localStorage.js";
 import { auditCallHandler } from "../api/auditCallHandler.js";
 export async function handleAuditOperation(collection, id, opts) {
@@ -12,11 +12,12 @@ export async function handleAuditOperation(collection, id, opts) {
         responseFormat: opts.responseFormat,
         verbosity: opts.verbosity,
     });
-    let { plainResult, result, meta, content } = handleResponseFormatOptions({ ...opts }, res);
+    const formatted = handleResponseFormatOptions({ ...opts }, res, { noPrint: true });
     spinner.success({
         text: `Got Audit ${id} in ${collection}`,
     });
     spinner.stop();
-    localStorage.setItem("lastId", result._id);
-    return { data: plainResult, content, result, meta };
+    printFormattedResponse({ ...opts }, formatted);
+    localStorage.setItem("lastId", formatted.result._id);
+    return { data: formatted.plainResult, content: formatted.content, result: formatted.result, meta: formatted.meta };
 }

package/lib/operations/handleCopySingleOperation.js

@@ -1,9 +1,10 @@
 // Operation handling functions
 import { apiCallHandler } from "../api/apiCallHandler.js";
 import { spinner } from "../../index.js";
-import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { handleResponseFormatOptions, printFormattedResponse, } from "../helpers/handleResponseFormatOptions.js";
 import { localStorage } from "../helpers/localStorage.js";
 export async function handleCopySingleOperation(module, collection, id, opts) {
+    var _a, _b;
     spinner.start({
         text: `Copying entry ${id} in [${collection}]`,
         color: "magenta",
@@ -18,13 +19,14 @@ export async function handleCopySingleOperation(module, collection, id, opts) {
         spinner.stop();
         return { data: null, content: null, result: null, meta: {} };
     }
-    let { plainResult, result, meta, content } = handleResponseFormatOptions({ ...opts }, res);
-    const newId = (result === null || result === void 0 ? void 0 : result._id) || "unknown";
+    const formatted = handleResponseFormatOptions({ ...opts }, res, { noPrint: true });
+    const newId = ((_a = formatted.result) === null || _a === void 0 ? void 0 : _a._id) || "unknown";
     spinner.success({
         text: `Copied entry ${id} in ${collection}: New ID [${newId}]`,
     });
     spinner.stop();
-    if (result === null || result === void 0 ? void 0 : result._id)
-        localStorage.setItem("lastId", result._id);
-    return { data: plainResult, content, result, meta };
+    printFormattedResponse({ ...opts }, formatted);
+    if ((_b = formatted.result) === null || _b === void 0 ? void 0 : _b._id)
+        localStorage.setItem("lastId", formatted.result._id);
+    return { data: formatted.plainResult, content: formatted.content, result: formatted.result, meta: formatted.meta };
 }

package/lib/operations/handleCreateSingleOperation.js

@@ -1,11 +1,11 @@
 // Operation handling functions
 import { apiCallHandler } from "../api/apiCallHandler.js";
 import { spinner } from "../../index.js";
-import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { handleResponseFormatOptions, printFormattedResponse, } from "../helpers/handleResponseFormatOptions.js";
 import { localStorage } from "../helpers/localStorage.js";
 import { getContextCreateFields } from "../helpers/contextInjector.js";
 export async function handleCreateSingleOperation(module, collection, name, opts) {
-    var _a;
+    var _a, _b, _c;
     spinner.start({
         text: `Creating entry in [${collection}]`,
         color: "magenta",
@@ -26,13 +26,14 @@ export async function handleCreateSingleOperation(module, collection, name, opts
         spinner.stop();
         return { data: null, content: null, result: null, meta: (_a = res === null || res === void 0 ? void 0 : res.meta) !== null && _a !== void 0 ? _a : {} };
     }
-    let { plainResult, result, meta, content } = handleResponseFormatOptions({ ...opts }, res);
+    const formatted = handleResponseFormatOptions({ ...opts }, res, { noPrint: true });
     spinner.success({
-        text: `Created entry [${result === null || result === void 0 ? void 0 : result._id}] in ${collection}`,
+        text: `Created entry [${(_b = formatted.result) === null || _b === void 0 ? void 0 : _b._id}] in ${collection}`,
     });
     spinner.stop();
-    if (result === null || result === void 0 ? void 0 : result._id) {
-        localStorage.setItem("lastId", result._id);
+    printFormattedResponse({ ...opts }, formatted);
+    if ((_c = formatted.result) === null || _c === void 0 ? void 0 : _c._id) {
+        localStorage.setItem("lastId", formatted.result._id);
     }
-    return { data: plainResult, content, result, meta };
+    return { data: formatted.plainResult, content: formatted.content, result: formatted.result, meta: formatted.meta };
 }

package/lib/operations/handleGetOperation.js

@@ -1,7 +1,7 @@
 // Operation handling functions
 import { apiCallHandler } from "../api/apiCallHandler.js";
 import { spinner } from "../../index.js";
-import { handleResponseFormatOptions, getApiResponseFormat } from "../helpers/handleResponseFormatOptions.js";
+import { handleResponseFormatOptions, printFormattedResponse, getApiResponseFormat, } from "../helpers/handleResponseFormatOptions.js";
 import { sanitizeFields } from "../helpers/sanitizeFields.js";
 import { getContextFilterParams } from "../helpers/contextInjector.js";
 export async function handleGetOperation(module, collection, opts) {
@@ -23,7 +23,10 @@ export async function handleGetOperation(module, collection, opts) {
         verbosity: opts.verbosity,
         ...contextParams,
     });
-    let { plainResult, result, meta, content } = handleResponseFormatOptions(opts, res);
+    // Compute formatted result without printing — spinner success line should
+    // appear ABOVE the data block, not after it.
+    const formatted = handleResponseFormatOptions(opts, res, { noPrint: true });
+    const { plainResult, result, meta, content } = formatted;
     const totalEntries = (_b = (_a = meta === null || meta === void 0 ? void 0 : meta.pageInfo) === null || _a === void 0 ? void 0 : _a.totalEntries) !== null && _b !== void 0 ? _b : '?';
     const page = (_d = (_c = meta === null || meta === void 0 ? void 0 : meta.pageInfo) === null || _c === void 0 ? void 0 : _c.page) !== null && _d !== void 0 ? _d : 1;
     const totalPages = (_f = (_e = meta === null || meta === void 0 ? void 0 : meta.pageInfo) === null || _e === void 0 ? void 0 : _e.totalPages) !== null && _f !== void 0 ? _f : '?';
@@ -31,5 +34,6 @@ export async function handleGetOperation(module, collection, opts) {
         text: `Got ${opts.limit} entries of ${totalEntries} : Page ${page} of ${totalPages}`,
     });
     spinner.stop();
+    printFormattedResponse(opts, formatted);
     return { data: plainResult, content, result, meta };
 }

package/lib/operations/handleGetSingleOperation.js

@@ -1,7 +1,7 @@
 // Operation handling functions
 import { apiCallHandler } from "../api/apiCallHandler.js";
 import { spinner } from "../../index.js";
-import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { handleResponseFormatOptions, printFormattedResponse, } from "../helpers/handleResponseFormatOptions.js";
 export async function handleGetSingleOperation(module, collection, id, opts) {
     spinner.start({
         text: `Getting entry in [${collection}]`,
@@ -11,10 +11,12 @@ export async function handleGetSingleOperation(module, collection, id, opts) {
         responseFormat: "table",
         verbosity: opts.verbosity,
     });
-    let { plainResult, result, meta, content } = handleResponseFormatOptions({ ...opts, responseFormat: "table" }, res);
+    const formattedOpts = { ...opts, responseFormat: "table" };
+    const formatted = handleResponseFormatOptions(formattedOpts, res, { noPrint: true });
     spinner.success({
         text: `Got entry in ${collection}`,
     });
     spinner.stop();
-    return { data: plainResult, content, result, meta };
+    printFormattedResponse(formattedOpts, formatted);
+    return { data: formatted.plainResult, content: formatted.content, result: formatted.result, meta: formatted.meta };
 }

package/lib/operations/handleListOperation.js

@@ -1,7 +1,7 @@
 // Operation handling functions
 import { apiCallHandler } from "../api/apiCallHandler.js";
 import { spinner } from "../../index.js";
-import { handleResponseFormatOptions, getApiResponseFormat } from "../helpers/handleResponseFormatOptions.js";
+import { handleResponseFormatOptions, printFormattedResponse, getApiResponseFormat, } from "../helpers/handleResponseFormatOptions.js";
 import { getContextFilterParams, hasActiveContext } from "../helpers/contextInjector.js";
 async function fetchPage(module, collection, opts) {
     const contextParams = getContextFilterParams(collection);
@@ -47,14 +47,19 @@ export async function handleListOperation(module, collection, opts) {
             payload: allPayload,
             meta: { ...meta, pageInfo: { ...(meta.pageInfo || {}), page: 1, totalPages: 1, totalEntries: allPayload.length } },
         };
-        const { plainResult, result, content } = handleResponseFormatOptions(opts, syntheticRes);
+        // Compute formatted result without printing — we want the spinner success
+        // line to appear ABOVE the data block, not below it. handleListOperation
+        // is the canonical CRUD-display path for `ay list`.
+        const formatted = handleResponseFormatOptions(opts, syntheticRes, { noPrint: true });
         spinner.success({ text: `Got all ${allPayload.length} entries from ${totalPages} pages` });
         spinner.stop();
-        return { data: plainResult, content, result, meta: syntheticRes.meta };
+        printFormattedResponse(opts, formatted);
+        return { data: formatted.plainResult, content: formatted.content, result: formatted.result, meta: syntheticRes.meta };
     }
     // Single page fetch
     let res = await fetchPage(module, collection, opts);
-    let { plainResult, result, meta, content } = handleResponseFormatOptions(opts, res);
+    const formatted = handleResponseFormatOptions(opts, res, { noPrint: true });
+    const { plainResult, result, meta, content } = formatted;
     const count = Array.isArray(result) ? result.length : 0;
     const total = (_d = (_c = meta === null || meta === void 0 ? void 0 : meta.pageInfo) === null || _c === void 0 ? void 0 : _c.totalEntries) !== null && _d !== void 0 ? _d : count;
     spinner.success({
@@ -63,5 +68,6 @@ export async function handleListOperation(module, collection, opts) {
             : `No entries found in [${collection}]`,
     });
     spinner.stop();
+    printFormattedResponse(opts, formatted);
     return { data: plainResult, content, result, meta };
 }

package/lib/operations/handleSingleAuditOperation.js

@@ -1,6 +1,6 @@
 // Operation handling functions
 import { spinner } from "../../index.js";
-import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
+import { handleResponseFormatOptions, printFormattedResponse, } from "../helpers/handleResponseFormatOptions.js";
 import { localStorage } from "../helpers/localStorage.js";
 import { auditCallHandler } from "../api/auditCallHandler.js";
 export async function handleSingleAuditOperation(collection, id, auditId, opts) {
@@ -12,16 +12,17 @@ export async function handleSingleAuditOperation(collection, id, auditId, opts)
         responseFormat: opts.responseFormat,
         verbosity: opts.verbosity,
     });
-    let { plainResult, result, meta, content } = handleResponseFormatOptions({ ...opts }, res);
+    const formatted = handleResponseFormatOptions({ ...opts }, res, { noPrint: true });
     spinner.success({
         text: `Got audit [${auditId}] for [${id}] in [${collection}]`,
     });
     spinner.stop();
-    localStorage.setItem("lastId", result._id);
+    printFormattedResponse({ ...opts }, formatted);
+    localStorage.setItem("lastId", formatted.result._id);
     return {
-        singleData: plainResult,
-        singleContent: content,
-        singleResult: result,
-        singleMeta: meta,
+        singleData: formatted.plainResult,
+        singleContent: formatted.content,
+        singleResult: formatted.result,
+        singleMeta: formatted.meta,
     };
 }

package/package.json

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