@tolinax/ayoune-cli 2026.11.0 → 2026.11.1

package/lib/api/login.js

@@ -13,10 +13,14 @@ export const login = async () => {
     const token = randomAsciiString();
     const url = `${config.loginUrl}/ayoune?cli=${token}`;
     const clickable = terminalLink(chalk.cyan.underline(url), url);
-    console.log();
-    console.log(`  ${chalk.dim("Open this URL to authenticate:")}`);
-    console.log(`  ${clickable}`);
-    console.log();
+    // Print the auth URL to STDERR — the same stream the spinner uses — so we
+    // don't pollute stdout when a piped command triggers a re-login (e.g. 401
+    // refresh inside apiCallHandler). stdout is reserved for the data payload
+    // so `ay list contacts | jq` keeps working.
+    process.stderr.write("\n");
+    process.stderr.write(`  ${chalk.dim("Open this URL to authenticate:")}\n`);
+    process.stderr.write(`  ${clickable}\n`);
+    process.stderr.write("\n");
     const credentials = await waitForCredentials(token);
     return credentials;
 };

package/lib/commands/createJobsCommand.js

@@ -9,7 +9,16 @@ export function createJobsCommand(program) {
     const jobs = program
         .command("jobs")
         .alias("j")
-        .description("Manage background jobs, automations, and triggers");
+        .description("Manage background jobs, automations, and triggers")
+        .addHelpText("after", `
+Examples:
+  ay jobs list                       List queued + scheduled jobs
+  ay jobs list --status failed       Show only failed jobs
+  ay jobs get <id>                   Inspect a single job
+  ay jobs retry <id>                 Retry a failed job
+  ay jobs cancel <id>                Cancel a queued job
+  ay jobs triggers list              List automation triggers
+  ay jobs notifications list         List recent notifications`);
     // ay jobs list
     jobs
         .command("list")

package/lib/commands/createLoginCommand.js

@@ -9,6 +9,11 @@ export function createLoginCommand(program) {
         .command("login")
         .alias("auth")
         .description("Authenticate with your aYOUne account via browser or JWT token")
+        .addHelpText("after", `
+Examples:
+  ay login                           Open browser to authenticate
+  ay login --token <jwt>             Authenticate with an existing JWT
+  ay auth                            Alias of \`ay login\``)
         .action(async (_options, cmd) => {
         var _a, _b, _c, _d;
         try {

package/lib/commands/createLogoutCommand.js

@@ -7,6 +7,10 @@ export function createLogoutCommand(program) {
         .command("logout")
         .alias("signout")
         .description("Clear stored credentials and log out")
+        .addHelpText("after", `
+Examples:
+  ay logout                          Clear stored credentials
+  ay signout                         Alias of \`ay logout\``)
         .action(async (options) => {
         try {
             spinner.start({ text: "Clearing credentials" });

package/lib/commands/createStorageCommand.js

@@ -14,6 +14,10 @@ export function createStorageCommand(program) {
         .command("storage")
         .alias("s")
         .description("Display stored session data and preferences")
+        .addHelpText("after", `
+Examples:
+  ay storage                         Show stored tokens (redacted) and config defaults
+  ay s                               Alias of \`ay storage\``)
         .action(async () => {
         var _a, _b;
         try {

package/lib/commands/createTemplateCommand.js

@@ -9,7 +9,14 @@ export function createTemplateCommand(program) {
     const tmpl = program
         .command("templates")
         .alias("tmpl")
-        .description("Manage platform templates (email, notification, report, store)");
+        .description("Manage platform templates (email, notification, report, store)")
+        .addHelpText("after", `
+Examples:
+  ay templates email list            List email templates
+  ay templates email get <id>        Show one email template
+  ay templates notification list     List notification templates
+  ay templates report list           List report templates
+  ay templates store list            List store templates`);
     // ── EMAIL TEMPLATES ────────────────────────────────────
     const email = tmpl
         .command("email")

package/lib/commands/createUsersCommand.js

@@ -9,7 +9,16 @@ import { parseInteger } from "../helpers/parseInt.js";
 export function createUsersCommand(program) {
     const users = program
         .command("users")
-        .description("Manage users, teams, and roles");
+        .description("Manage users, teams, and roles")
+        .addHelpText("after", `
+Examples:
+  ay users list                      List users (paginated)
+  ay users get <id>                  Show a single user
+  ay users create                    Create a user (interactive wizard)
+  ay users update <id>               Update a user
+  ay users delete <id>               Delete a user
+  ay users teams list                List teams
+  ay users roles list                List roles`);
     // ── USERS ──────────────────────────────────────────────
     // ay users list
     users

package/lib/commands/createWebhooksCommand.js

@@ -9,7 +9,15 @@ export function createWebhooksCommand(program) {
     const hooks = program
         .command("webhooks")
         .alias("hooks")
-        .description("Manage webhooks and event subscriptions");
+        .description("Manage webhooks and event subscriptions")
+        .addHelpText("after", `
+Examples:
+  ay webhooks list                   List registered webhooks
+  ay webhooks get <id>               Show one webhook
+  ay webhooks create                 Create a webhook (interactive wizard)
+  ay webhooks delete <id>            Delete a webhook
+  ay webhooks deliveries <id>        List recent delivery attempts
+  ay webhooks redeliver <id>         Re-fire a failed delivery`);
     // ay webhooks list
     hooks
         .command("list")

package/lib/commands/createWhoAmICommand.js

@@ -69,6 +69,10 @@ export function createWhoAmICommand(program) {
         .command("whoami")
         .alias("who")
         .description("Display the currently authenticated user")
+        .addHelpText("after", `
+Examples:
+  ay whoami                          Show your current user info
+  ay who                             Alias of \`ay whoami\``)
         .action(async (options) => {
         try {
             const tokenPayload = decodeToken(secureStorage.getItem("token"));

package/lib/commands/deploy/index.js

@@ -19,7 +19,19 @@ export function createDeployCommand(program) {
     const deploy = program
         .command("deploy")
         .alias("dp")
-        .description("Manage deployments, pods, clusters, pipelines, and plans via DevOps API");
+        .description("Manage deployments, pods, clusters, pipelines, and plans via DevOps API")
+        .addHelpText("after", `
+Examples:
+  ay deploy deployments list                List active deployments
+  ay deploy deployments rollback api-crm    Rollback a deployment
+  ay deploy pods list api-crm               List pods for a service
+  ay deploy pods logs <pod>                 Tail pod logs
+  ay deploy clusters list                   List clusters
+  ay deploy alerts list                     Show open alerts
+  ay deploy pipelines list                  Recent CI pipelines
+  ay deploy plans list                      Saved deployment plans
+  ay deploy repos list                      Repository status
+  ay deploy dashboard                       Live deployment dashboard`);
     addDeploymentsSubcommands(deploy, program);
     addPodsSubcommands(deploy, program);
     addClustersSubcommands(deploy, program);

package/lib/helpers/parseInt.js

@@ -1,4 +1,4 @@
-export function parseInteger(value, dummyPrevious) {
+export function parseInteger(value, _dummyPrevious) {
     const parsedValue = parseInt(value, 10);
     if (isNaN(parsedValue)) {
         throw new Error("Not a number.");

package/package.json

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