@tolinax/ayoune-cli 2026.11.4 → 2026.12.0

package/lib/commands/createAccessCommand.js

@@ -1,10 +1,24 @@
 import chalk from "chalk";
+import inquirer from "inquirer";
 import { modelsAndRights } from "../../data/modelsAndRights.js";
 import { aYOUneModules } from "../../data/modules.js";
 import { isSuperUser, getTokenPayload } from "../helpers/tokenPayload.js";
 import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
 import { cliError } from "../helpers/cliError.js";
+// ── Visual helpers ──────────────────────────────────────────────────────────
+const BAR_CHAR = "█";
+const BAR_HALF = "▌";
+const DIM_CHAR = "░";
+function bar(value, max, width) {
+    if (max === 0)
+        return chalk.dim(DIM_CHAR.repeat(width));
+    const filled = (value / max) * width;
+    const full = Math.floor(filled);
+    const half = filled - full >= 0.5 ? 1 : 0;
+    const empty = width - full - half;
+    return chalk.cyan(BAR_CHAR.repeat(full)) + (half ? chalk.cyan(BAR_HALF) : "") + chalk.dim(DIM_CHAR.repeat(empty));
+}
 function getAccessibleModules(su) {
     var _a;
     const moduleSummaries = [];
@@ -21,52 +35,209 @@ function getAccessibleModules(su) {
     }
     return moduleSummaries;
 }
-function displayAccess(modules, su) {
+function getModuleCollections(modName) {
+    return modelsAndRights
+        .filter((m) => m.module === modName)
+        .map((m) => ({ collection: m.plural, singular: m.singular, right: m.right }))
+        .sort((a, b) => a.collection.localeCompare(b.collection));
+}
+// ── Display: summary ────────────────────────────────────────────────────────
+function displaySummary(modules, su) {
     const payload = getTokenPayload();
     const name = (payload === null || payload === void 0 ? void 0 : payload.name) || (payload === null || payload === void 0 ? void 0 : payload.username) || (payload === null || payload === void 0 ? void 0 : payload.email) || "Unknown";
     const type = (payload === null || payload === void 0 ? void 0 : payload.type) || "user";
+    const totalCollections = modules.reduce((sum, m) => sum + m.collections, 0);
+    const maxCount = Math.max(...modules.map((m) => m.collections));
+    // Sort: largest modules first for visual impact
+    const sorted = [...modules].sort((a, b) => b.collections - a.collections);
     console.log();
-    console.log(chalk.bold(`  Access Summary for ${chalk.cyan(name)}`));
-    console.log(chalk.dim(`  Type: ${su ? chalk.yellow("superuser") : type}`));
-    console.log(chalk.dim(`  ${"─".repeat(50)}`));
+    console.log(chalk.bold(`  Access Summary`));
+    console.log(chalk.dim(`  User: `) + chalk.cyan(name) + chalk.dim(`  Type: `) + (su ? chalk.yellow.bold("superuser") : chalk.white(type)));
+    console.log(chalk.dim(`  ${modules.length} modules, ${totalCollections} collections accessible`));
     console.log();
-    const totalCollections = modules.reduce((sum, m) => sum + m.collections, 0);
-    // Column widths
-    const maxMod = Math.max(...modules.map((m) => m.module.length), 6);
-    const maxLabel = Math.max(...modules.map((m) => m.label.length), 5);
-    console.log(`  ${chalk.dim("MODULE".padEnd(maxMod + 2))} ${chalk.dim("LABEL".padEnd(maxLabel + 2))} ${chalk.dim("COLLECTIONS")}`);
-    console.log(chalk.dim(`  ${"─".repeat(maxMod + maxLabel + 18)}`));
-    for (const mod of modules) {
+    // Header
+    const maxMod = Math.max(...sorted.map((m) => m.module.length), 6);
+    const maxLabel = Math.max(Math.min(Math.max(...sorted.map((m) => m.label.length)), 30), 5);
+    console.log(chalk.dim(`  ${"MODULE".padEnd(maxMod + 2)} ${"LABEL".padEnd(maxLabel + 2)}  ${"#".padStart(4)}  SHARE`));
+    console.log(chalk.dim(`  ${"─".repeat(maxMod + maxLabel + 32)}`));
+    for (const mod of sorted) {
         const modName = mod.superuserOnly
             ? chalk.yellow(mod.module.padEnd(maxMod + 2))
-            : mod.module.padEnd(maxMod + 2);
-        const label = mod.label.padEnd(maxLabel + 2);
-        const count = String(mod.collections).padStart(4);
-        console.log(`  ${modName} ${label} ${count}`);
+            : chalk.white(mod.module.padEnd(maxMod + 2));
+        const labelStr = mod.label.length > 30 ? mod.label.slice(0, 28) + ".." : mod.label;
+        const label = chalk.dim(labelStr.padEnd(maxLabel + 2));
+        const count = mod.collections > 0 ? chalk.white(String(mod.collections).padStart(4)) : chalk.dim("   0");
+        const viz = bar(mod.collections, maxCount, 16);
+        console.log(`  ${modName} ${label}  ${count}  ${viz}`);
     }
     console.log();
-    console.log(chalk.dim(`  ${modules.length} modules, ${totalCollections} collections accessible`));
     if (su) {
-        console.log(chalk.yellow(`  Superuser access: all modules including system collections`));
+        console.log(chalk.yellow(`  ★ Superuser — all modules including system collections`));
+        console.log();
     }
+}
+// ── Display: module detail ──────────────────────────────────────────────────
+function displayModuleDetail(modName, modLabel, collections) {
+    const maxCol = Math.max(...collections.map((c) => c.collection.length), 10);
+    console.log();
+    console.log(chalk.bold(`  ${chalk.cyan(modLabel)} `) + chalk.dim(`(${modName})`));
+    console.log(chalk.dim(`  ${collections.length} collections`));
     console.log();
+    // Group by right prefix if there's variety, else flat list
+    const rights = [...new Set(collections.map((c) => c.right.split(".")[0]))];
+    const grouped = rights.length > 1;
+    if (grouped) {
+        for (const prefix of rights) {
+            const group = collections.filter((c) => c.right.startsWith(prefix + "."));
+            console.log(chalk.dim(`  ─ ${prefix} (${group.length})`));
+            for (const col of group) {
+                const rightSuffix = col.right.split(".").slice(1).join(".");
+                console.log(`    ${chalk.white(col.collection.padEnd(maxCol + 2))} ${chalk.dim(rightSuffix)}`);
+            }
+            console.log();
+        }
+    }
+    else {
+        console.log(chalk.dim(`  ${"COLLECTION".padEnd(maxCol + 2)}  RIGHT`));
+        console.log(chalk.dim(`  ${"─".repeat(maxCol + 30)}`));
+        for (const col of collections) {
+            console.log(`  ${chalk.white(col.collection.padEnd(maxCol + 2))}  ${chalk.dim(col.right)}`);
+        }
+        console.log();
+    }
 }
+// ── Interactive drill-down ──────────────────────────────────────────────────
+async function interactiveDrillDown(modules, su) {
+    const sorted = [...modules].sort((a, b) => b.collections - a.collections);
+    const choices = sorted.map((m) => ({
+        name: `${m.module.padEnd(14)} ${chalk.dim(m.label.padEnd(32))} ${chalk.cyan(String(m.collections).padStart(3))} collections`,
+        value: m.module,
+        short: m.module,
+    }));
+    choices.push(new inquirer.Separator());
+    choices.push({ name: chalk.dim("Exit"), value: "__exit__", short: "exit" });
+    while (true) {
+        const { selectedModule } = await inquirer.prompt([
+            {
+                type: "list",
+                name: "selectedModule",
+                message: "Select a module to explore:",
+                choices,
+                pageSize: Math.min(modules.length + 2, 20),
+            },
+        ]);
+        if (selectedModule === "__exit__")
+            break;
+        const mod = aYOUneModules.find((m) => m.module === selectedModule);
+        if (!mod)
+            break;
+        const collections = getModuleCollections(selectedModule);
+        displayModuleDetail(selectedModule, mod.label, collections);
+        // Offer to drill further into a collection or go back
+        if (collections.length > 0) {
+            const collChoices = [
+                { name: chalk.dim("← Back to modules"), value: "__back__" },
+                new inquirer.Separator(),
+                ...collections.map((c) => ({
+                    name: `${c.collection.padEnd(30)} ${chalk.dim(c.right)}`,
+                    value: c.collection,
+                    short: c.collection,
+                })),
+            ];
+            const { selectedCollection } = await inquirer.prompt([
+                {
+                    type: "list",
+                    name: "selectedCollection",
+                    message: `Drill into a collection (use with ay list ${selectedModule} <collection>):`,
+                    choices: collChoices,
+                    pageSize: Math.min(collections.length + 3, 20),
+                },
+            ]);
+            if (selectedCollection !== "__back__") {
+                console.log();
+                console.log(chalk.bold(`  Quick commands for ${chalk.cyan(selectedCollection)}:`));
+                console.log();
+                console.log(chalk.dim(`  List:     `) + `ay list ${selectedModule} ${selectedCollection.toLowerCase()}`);
+                console.log(chalk.dim(`  Get:      `) + `ay get ${selectedModule} ${selectedCollection.toLowerCase()}`);
+                console.log(chalk.dim(`  Search:   `) + `ay search ${selectedCollection.toLowerCase()} "<query>"`);
+                console.log(chalk.dim(`  Describe: `) + `ay describe ${selectedCollection.toLowerCase()} <id>`);
+                console.log(chalk.dim(`  Export:   `) + `ay export run ${selectedModule} ${selectedCollection.toLowerCase()}`);
+                console.log();
+            }
+        }
+    }
+}
+// ── Search ──────────────────────────────────────────────────────────────────
+function displaySearch(query, su) {
+    const q = query.toLowerCase();
+    const matchedCollections = modelsAndRights.filter((m) => {
+        if (m.module === "su" && !su)
+            return false;
+        return m.plural.toLowerCase().includes(q) || m.singular.toLowerCase().includes(q) || m.right.toLowerCase().includes(q);
+    });
+    if (matchedCollections.length === 0) {
+        console.log();
+        console.log(chalk.dim(`  No collections matching "${query}"`));
+        console.log();
+        return;
+    }
+    console.log();
+    console.log(chalk.bold(`  Search results for "${chalk.cyan(query)}"`));
+    console.log(chalk.dim(`  ${matchedCollections.length} matches`));
+    console.log();
+    // Group by module
+    const byModule = new Map();
+    for (const m of matchedCollections) {
+        if (!byModule.has(m.module))
+            byModule.set(m.module, []);
+        byModule.get(m.module).push(m);
+    }
+    const maxCol = Math.max(...matchedCollections.map((m) => m.plural.length), 10);
+    for (const [modName, cols] of byModule) {
+        const mod = aYOUneModules.find((m) => m.module === modName);
+        console.log(chalk.dim(`  ─ ${modName}`) + chalk.dim(` (${(mod === null || mod === void 0 ? void 0 : mod.label) || modName})`));
+        for (const col of cols) {
+            // Highlight the match
+            const highlighted = col.plural.replace(new RegExp(`(${query})`, "ig"), (m) => chalk.cyan.underline(m));
+            console.log(`    ${highlighted.padEnd(maxCol + 12)}  ${chalk.dim(col.right)}  ${chalk.dim("→")} ay list ${modName} ${col.plural.toLowerCase()}`);
+        }
+        console.log();
+    }
+}
+// ── Command ─────────────────────────────────────────────────────────────────
 export function createAccessCommand(program) {
     program
         .command("access")
         .description("Show accessible modules and collections for the current user")
         .addHelpText("after", `
 Examples:
-  ay access                   Show accessible modules and collection counts
-  ay access -r json            Output as JSON
-  ay access --module crm       Show collections in a specific module`)
+  ay access                      Interactive module explorer with drill-down
+  ay access -r json              Output as JSON (non-interactive)
+  ay access --module crm         Show collections in a specific module
+  ay access --search contacts    Find collections by name
+  ay access --no-interactive     Summary table without drill-down prompt`)
         .option("--module <name>", "Show collections for a specific module")
+        .option("--search <query>", "Search collections by name or right")
+        .option("--no-interactive", "Disable interactive drill-down")
         .action(async (options) => {
         try {
             const opts = { ...program.opts(), ...options };
             const su = isSuperUser();
             const modules = getAccessibleModules(su);
-            // Detail mode: list collections in a specific module
+            const isTTY = process.stdout.isTTY;
+            // Machine mode: explicit `-r` flag passed (e.g., -r table, -r yaml, -r csv),
+            // or saving to file, or piped (non-TTY) output.
+            // We check Commander's option source to distinguish "user typed -r table" from
+            // "user config defaults to yaml". Only an explicit CLI flag triggers machine mode.
+            const formatSource = program.getOptionValueSource("responseFormat");
+            const explicitFormat = formatSource === "cli";
+            const machineMode = explicitFormat || !!opts.save || !isTTY;
+            // ── Search mode ─────────────────────────────────────────────
+            if (opts.search) {
+                displaySearch(opts.search, su);
+                return;
+            }
+            // ── Detail mode: specific module ────────────────────────────
             if (opts.module) {
                 const modName = opts.module.toLowerCase();
                 const mod = aYOUneModules.find((m) => m.module === modName);
@@ -76,37 +247,17 @@ Examples:
                 if (mod.superuserOnly && !su) {
                     cliError(`Module "${opts.module}" requires superuser access.`, EXIT_GENERAL_ERROR);
                 }
-                const collections = modelsAndRights
-                    .filter((m) => m.module === modName)
-                    .map((m) => ({
-                    collection: m.plural,
-                    singular: m.singular,
-                    right: m.right,
-                }));
-                if (opts.responseFormat !== "json" || opts.save) {
+                const collections = getModuleCollections(modName);
+                if (machineMode) {
                     handleResponseFormatOptions(opts, collections);
                 }
                 else {
-                    console.log();
-                    console.log(chalk.bold(`  Collections in ${chalk.cyan(mod.label)} (${modName})`));
-                    console.log(chalk.dim(`  ${"─".repeat(50)}`));
-                    console.log();
-                    const maxCol = Math.max(...collections.map((c) => c.collection.length), 10);
-                    const maxRight = Math.max(...collections.map((c) => c.right.length), 5);
-                    console.log(`  ${chalk.dim("COLLECTION".padEnd(maxCol + 2))} ${chalk.dim("RIGHT")}`);
-                    console.log(chalk.dim(`  ${"─".repeat(maxCol + maxRight + 6)}`));
-                    for (const col of collections) {
-                        console.log(`  ${col.collection.padEnd(maxCol + 2)} ${chalk.dim(col.right)}`);
-                    }
-                    console.log();
-                    console.log(chalk.dim(`  ${collections.length} collections`));
-                    console.log();
+                    displayModuleDetail(modName, mod.label, collections);
                 }
                 return;
             }
-            // Summary mode: show all accessible modules
-            if (opts.responseFormat !== "json" || opts.save) {
-                // For non-default formats or save, use standard formatting
+            // ── Summary mode ────────────────────────────────────────────
+            if (machineMode) {
                 const data = modules.map((m) => ({
                     module: m.module,
                     label: m.label,
@@ -114,9 +265,12 @@ Examples:
                     ...(m.superuserOnly ? { superuserOnly: true } : {}),
                 }));
                 handleResponseFormatOptions(opts, data);
+                return;
             }
-            else {
-                displayAccess(modules, su);
+            // Pretty display + optional interactive drill-down
+            displaySummary(modules, su);
+            if (opts.interactive !== false) {
+                await interactiveDrillDown(modules, su);
             }
         }
         catch (e) {

package/package.json

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