@tolinax/ayoune-cli 2026.3.0 → 2026.4.0

package/lib/commands/createContextCommand.js

@@ -0,0 +1,163 @@
+import chalk from "chalk";
+import { spinner } from "../../index.js";
+import { contextSlots, getSlot, getSlotsByTier } from "../../data/contextSlots.js";
+import { getActiveContext, setContextEntry, unsetContextEntry, clearAllContext, } from "../helpers/contextStore.js";
+import { resolveEntity, validateHierarchy, getDependentSlots } from "../helpers/contextResolver.js";
+import { EXIT_MISUSE } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
+export function createContextCommand(program) {
+    const ctx = program
+        .command("context")
+        .alias("ctx")
+        .description("Manage active entity context for scoped commands")
+        .addHelpText("after", `
+Examples:
+  ay context                              Show active context
+  ay context set project "Website"        Set project context by name
+  ay context set sprint "Sprint 14"       Set sprint (auto-filtered by project)
+  ay context unset project                Unset project (cascades to children)
+  ay context clear                        Clear all context
+  ay context list                         List all available context slots`);
+    // Default action: show active context
+    ctx.action(() => {
+        showContext();
+    });
+    // ay context show
+    ctx
+        .command("show")
+        .description("Show active context")
+        .action(() => {
+        showContext();
+    });
+    // ay context set <slot> <name>
+    ctx
+        .command("set <slot> <nameOrId...>")
+        .description("Set active context for a slot")
+        .action(async (slot, nameOrIdParts, options) => {
+        const opts = { ...program.opts(), ...options };
+        const nameOrId = nameOrIdParts.join(" ");
+        const slotDef = getSlot(slot);
+        if (!slotDef) {
+            const available = contextSlots.map((s) => s.slot).join(", ");
+            cliError(`Unknown context slot: "${slot}". Available: ${available}`, EXIT_MISUSE);
+            return;
+        }
+        // Hierarchy warning
+        const warning = validateHierarchy(slot);
+        if (warning) {
+            console.error(chalk.yellow(`  ${warning}`));
+        }
+        spinner.start({ text: `Resolving ${slot} "${nameOrId}"...`, color: "magenta" });
+        const matches = await resolveEntity(slot, nameOrId);
+        if (matches.length === 0) {
+            spinner.error({ text: `No ${slot} found matching "${nameOrId}"` });
+            spinner.stop();
+            return;
+        }
+        let selected = matches[0];
+        // If multiple matches and interactive TTY, let user pick
+        if (matches.length > 1 && process.stdin.isTTY) {
+            spinner.stop();
+            console.error(chalk.dim(`  Multiple matches for "${nameOrId}":`));
+            matches.forEach((m, i) => {
+                console.error(`  ${chalk.cyan(`[${i + 1}]`)} ${m.name} ${chalk.dim(`(${m.id})`)}`);
+            });
+            console.error(chalk.dim(`  Using first match. Use an ObjectId for exact selection.\n`));
+            selected = matches[0];
+        }
+        else if (matches.length > 1) {
+            spinner.stop();
+        }
+        setContextEntry(slot, {
+            id: selected.id,
+            name: selected.name,
+            collection: slotDef.collection,
+            module: slotDef.module,
+            setAt: new Date().toISOString(),
+        });
+        spinner.success({ text: `Context ${slot} set to "${selected.name}" (${selected.id})` });
+        spinner.stop();
+    });
+    // ay context unset <slot>
+    ctx
+        .command("unset <slot>")
+        .description("Remove context for a slot (cascades to children)")
+        .action((slot) => {
+        const slotDef = getSlot(slot);
+        if (!slotDef) {
+            cliError(`Unknown context slot: "${slot}"`, EXIT_MISUSE);
+            return;
+        }
+        // Cascade unset children
+        const children = getDependentSlots(slot);
+        const unset = [slot];
+        for (const child of children) {
+            const entry = getActiveContext()[child];
+            if (entry) {
+                unsetContextEntry(child);
+                unset.push(child);
+            }
+        }
+        unsetContextEntry(slot);
+        if (unset.length > 1) {
+            console.error(chalk.dim(`  Cascade: also unset ${unset.slice(1).join(", ")}`));
+        }
+        spinner.success({ text: `Context "${slot}" unset` });
+        spinner.stop();
+    });
+    // ay context clear
+    ctx
+        .command("clear")
+        .description("Clear all active context")
+        .option("--force", "Skip confirmation")
+        .action((options) => {
+        const opts = { ...program.opts(), ...options };
+        const active = getActiveContext();
+        const count = Object.keys(active).length;
+        if (count === 0) {
+            console.error(chalk.dim("  No active context to clear."));
+            return;
+        }
+        clearAllContext();
+        spinner.success({ text: `Cleared ${count} context entries` });
+        spinner.stop();
+    });
+    // ay context list
+    ctx
+        .command("list")
+        .description("List all available context slots")
+        .action(() => {
+        const active = getActiveContext();
+        const tierLabels = {
+            1: "Core",
+            2: "Domain",
+            3: "AI / Automation",
+        };
+        for (const tier of [1, 2, 3]) {
+            const slots = getSlotsByTier(tier);
+            console.log(chalk.bold(`\n  ${tierLabels[tier]}`));
+            for (const s of slots) {
+                const entry = active[s.slot];
+                const status = entry
+                    ? chalk.green(`= "${entry.name}" (${entry.id})`)
+                    : chalk.dim("not set");
+                const parent = s.parent ? chalk.dim(` [parent: ${s.parent}]`) : "";
+                console.log(`    ${chalk.cyan(s.slot.padEnd(14))} ${s.collection.padEnd(22)} ${status}${parent}`);
+            }
+        }
+        console.log();
+    });
+}
+function showContext() {
+    const active = getActiveContext();
+    const entries = Object.entries(active);
+    if (entries.length === 0) {
+        console.log(chalk.dim("  No active context. Use `ay context set <slot> <name>` to set one."));
+        return;
+    }
+    console.log(chalk.bold("\n  Active Context"));
+    for (const [slot, entry] of entries) {
+        console.log(`    ${chalk.cyan(slot.padEnd(14))} ${entry.name} ${chalk.dim(`(${entry.collection}, ${entry.id})`)}`);
+    }
+    console.log();
+}

package/lib/commands/createCopyCommand.js

@@ -2,8 +2,8 @@ import { Argument } from "commander";
 import { getModuleFromCollection } from "../models/getModuleFromCollection.js";
 import { handleCopySingleOperation } from "../operations/handleCopySingleOperation.js";
 import { localStorage } from "../helpers/localStorage.js";
-import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
 export function createCopyCommand(program) {
     program
         .command("copy")
@@ -18,12 +18,10 @@ Examples:
         .action(async (collection, id, options) => {
         try {
             if (!collection) {
-                spinner.error({ text: "Missing required argument: collection. Run a list or get command first, or provide it explicitly." });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: collection. Run a list or get command first, or provide it explicitly.", EXIT_MISUSE);
             }
             if (!id) {
-                spinner.error({ text: "Missing required argument: id. Provide an entry ID explicitly." });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: id. Provide an entry ID explicitly.", EXIT_MISUSE);
             }
             const opts = { ...program.opts(), ...options };
             const module = getModuleFromCollection(collection);
@@ -32,8 +30,7 @@ Examples:
             });
         }
         catch (e) {
-            spinner.error({ text: e.message || "An unexpected error occurred" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "An unexpected error occurred", EXIT_GENERAL_ERROR);
         }
     });
 }

package/lib/commands/createCreateCommand.js

@@ -4,8 +4,8 @@ import { promptCollectionWithModule } from "../prompts/promptCollectionWithModul
 import { handleCreateSingleOperation } from "../operations/handleCreateSingleOperation.js";
 import { promptName } from "../prompts/promptName.js";
 import { localStorage } from "../helpers/localStorage.js";
-import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
 export function createCreateCommand(program) {
     program
         .command("create")
@@ -22,8 +22,7 @@ Examples:
             const opts = { ...program.opts(), ...options };
             if (!collection) {
                 if (!process.stdin.isTTY) {
-                    spinner.error({ text: "Missing required argument: collection" });
-                    process.exit(EXIT_MISUSE);
+                    cliError("Missing required argument: collection", EXIT_MISUSE);
                 }
                 collection = await promptCollectionWithModule();
             }
@@ -31,8 +30,7 @@ Examples:
             let entryName = name;
             if (!entryName) {
                 if (!process.stdin.isTTY) {
-                    spinner.error({ text: "Missing required argument: name" });
-                    process.exit(EXIT_MISUSE);
+                    cliError("Missing required argument: name", EXIT_MISUSE);
                 }
                 entryName = await promptName();
             }
@@ -43,8 +41,7 @@ Examples:
             localStorage.setItem("lastCollection", collection);
         }
         catch (e) {
-            spinner.error({ text: e.message || "An unexpected error occurred" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "An unexpected error occurred", EXIT_GENERAL_ERROR);
         }
     });
 }

package/lib/commands/createDeleteCommand.js

@@ -5,6 +5,7 @@ import { handleDeleteSingleOperation } from "../operations/handleDeleteSingleOpe
 import { localStorage } from "../helpers/localStorage.js";
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
 export function createDeleteCommand(program) {
     program
         .command("delete")
@@ -22,8 +23,7 @@ Examples:
         .action(async (collection, ids, options) => {
         try {
             if (!collection) {
-                spinner.error({ text: "Missing required argument: collection. Run a list or get command first, or provide it explicitly." });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: collection. Run a list or get command first, or provide it explicitly.", EXIT_MISUSE);
             }
             const opts = { ...program.opts(), ...options };
             const module = getModuleFromCollection(collection);
@@ -47,8 +47,7 @@ Examples:
                 }
             }
             if (idList.length === 0) {
-                spinner.error({ text: "No IDs provided. Pass IDs as argument or via --ids-stdin." });
-                process.exit(EXIT_MISUSE);
+                cliError("No IDs provided. Pass IDs as argument or via --ids-stdin.", EXIT_MISUSE);
             }
             // Confirmation prompt (unless --force)
             if (!opts.force && process.stdin.isTTY) {
@@ -91,8 +90,7 @@ Examples:
             }
         }
         catch (e) {
-            spinner.error({ text: e.message || "An unexpected error occurred" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "An unexpected error occurred", EXIT_GENERAL_ERROR);
         }
     });
 }

package/lib/commands/createDeployCommand.js

@@ -3,11 +3,12 @@ import { getModuleBaseUrl } from "../api/apiClient.js";
 import { apiCallHandler } from "../api/apiCallHandler.js";
 import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOptions.js";
 import { saveFile } from "../helpers/saveFile.js";
-import { localStorage } from "../helpers/localStorage.js";
+import { secureStorage } from "../helpers/secureStorage.js";
 import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
 function getToken() {
-    return localStorage.getItem("token") || process.env.AYOUNE_TOKEN || "";
+    return secureStorage.getItem("token") || process.env.AYOUNE_TOKEN || "";
 }
 export function createDeployCommand(program) {
     const deploy = program
@@ -27,7 +28,7 @@ export function createDeployCommand(program) {
         .option("-l, --limit <number>", "Limit", parseInt, 50)
         .option("-p, --page <number>", "Page", parseInt, 1)
         .action(async (options) => {
-        var _a, _b, _c;
+        var _a, _b;
         try {
             const opts = { ...program.opts(), ...options };
             spinner.start({ text: "Fetching deployments...", color: "magenta" });
@@ -47,16 +48,15 @@ export function createDeployCommand(program) {
             if (opts.search)
                 params.q = opts.search;
             const res = await apiCallHandler("devops", "deployments", "get", null, params);
-            handleResponseFormatOptions(opts, res);
-            const total = (_c = (_b = (_a = res.meta) === null || _a === void 0 ? void 0 : _a.pageInfo) === null || _b === void 0 ? void 0 : _b.totalEntries) !== null && _c !== void 0 ? _c : 0;
+            const { result: fmtResult, meta: fmtMeta } = handleResponseFormatOptions(opts, res);
+            const total = (_b = (_a = fmtMeta === null || fmtMeta === void 0 ? void 0 : fmtMeta.pageInfo) === null || _a === void 0 ? void 0 : _a.totalEntries) !== null && _b !== void 0 ? _b : (Array.isArray(fmtResult) ? fmtResult.length : 0);
             spinner.success({ text: `Found ${total} deployments` });
             spinner.stop();
             if (opts.save)
                 await saveFile("deploy-list", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list deployments" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list deployments", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy get <id>
@@ -76,8 +76,7 @@ export function createDeployCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to get deployment" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to get deployment", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy logs <id>
@@ -113,8 +112,7 @@ Examples:
                     },
                 }, (res) => {
                     if (res.statusCode !== 200) {
-                        console.error(chalk.red(`  Error: HTTP ${res.statusCode}`));
-                        process.exit(EXIT_GENERAL_ERROR);
+                        cliError(`Error: HTTP ${res.statusCode}`, EXIT_GENERAL_ERROR);
                     }
                     res.setEncoding("utf-8");
                     res.on("data", (chunk) => {
@@ -146,8 +144,7 @@ Examples:
                     });
                 });
                 req.on("error", (e) => {
-                    console.error(chalk.red(`  Stream error: ${e.message}`));
-                    process.exit(EXIT_GENERAL_ERROR);
+                    cliError(`Stream error: ${e.message}`, EXIT_GENERAL_ERROR);
                 });
                 // Keep alive until Ctrl+C
                 process.on("SIGINT", () => {
@@ -173,8 +170,7 @@ Examples:
             }
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to fetch logs" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to fetch logs", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy scale <deployment> <replicas>
@@ -194,8 +190,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to scale deployment" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to scale deployment", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy restart <deployment>
@@ -214,8 +209,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to restart deployment" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to restart deployment", EXIT_GENERAL_ERROR);
         }
     });
     // ─── PODS ──────────────────────────────────────────────
@@ -255,8 +249,7 @@ Examples:
                 await saveFile("deploy-pods", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list pods" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list pods", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy pod-delete <id>
@@ -275,8 +268,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to delete pod" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to delete pod", EXIT_GENERAL_ERROR);
         }
     });
     // ─── CLUSTERS ──────────────────────────────────────────
@@ -308,8 +300,7 @@ Examples:
                 await saveFile("deploy-clusters", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list clusters" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list clusters", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy cluster-sync <id>
@@ -328,8 +319,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to sync cluster" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to sync cluster", EXIT_GENERAL_ERROR);
         }
     });
     // ─── ALERTS ────────────────────────────────────────────
@@ -363,8 +353,7 @@ Examples:
                 await saveFile("deploy-alerts", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to fetch alerts" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to fetch alerts", EXIT_GENERAL_ERROR);
         }
     });
     // ─── PIPELINES ─────────────────────────────────────────
@@ -399,8 +388,7 @@ Examples:
                 await saveFile("deploy-pipelines", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to fetch pipelines" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to fetch pipelines", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy trigger <repo>
@@ -432,8 +420,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to trigger pipeline" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to trigger pipeline", EXIT_GENERAL_ERROR);
         }
     });
     // ─── DEPLOYMENT PLANS ──────────────────────────────────
@@ -466,8 +453,7 @@ Examples:
                 await saveFile("deploy-plans", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list deployment plans" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list deployment plans", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy plans get <id>
@@ -487,8 +473,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to get plan" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to get plan", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy plans create --body '{...}'
@@ -507,8 +492,7 @@ Examples:
                     body = JSON.parse(opts.body);
                 }
                 catch (_b) {
-                    spinner.error({ text: "Invalid JSON in --body" });
-                    process.exit(EXIT_GENERAL_ERROR);
+                    cliError("Invalid JSON in --body", EXIT_GENERAL_ERROR);
                 }
             }
             else if (opts.bodyFile) {
@@ -518,13 +502,11 @@ Examples:
                     body = JSON.parse(content);
                 }
                 catch (_c) {
-                    spinner.error({ text: `Invalid JSON in file: ${opts.bodyFile}` });
-                    process.exit(EXIT_GENERAL_ERROR);
+                    cliError(`Invalid JSON in file: ${opts.bodyFile}`, EXIT_GENERAL_ERROR);
                 }
             }
             if (!body) {
-                spinner.error({ text: "Provide plan definition via --body or --body-file" });
-                process.exit(EXIT_GENERAL_ERROR);
+                cliError("Provide plan definition via --body or --body-file", EXIT_GENERAL_ERROR);
             }
             spinner.start({ text: "Creating deployment plan...", color: "magenta" });
             const res = await apiCallHandler("devops", "deployment-plans", "post", body, {
@@ -536,8 +518,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to create plan" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to create plan", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy plans execute <id>
@@ -557,8 +538,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to execute plan" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to execute plan", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy plans delete <id>
@@ -578,8 +558,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to delete plan" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to delete plan", EXIT_GENERAL_ERROR);
         }
     });
     // ─── REPOSITORIES ──────────────────────────────────────
@@ -616,8 +595,7 @@ Examples:
                 await saveFile("deploy-repos", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list repositories" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list repositories", EXIT_GENERAL_ERROR);
         }
     });
     // ay deploy repos sync <id>
@@ -636,8 +614,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to sync repository" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to sync repository", EXIT_GENERAL_ERROR);
         }
     });
     // ─── DASHBOARD ─────────────────────────────────────────
@@ -659,8 +636,7 @@ Examples:
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to load dashboard" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to load dashboard", EXIT_GENERAL_ERROR);
         }
     });
 }

package/lib/commands/createDescribeCommand.js

@@ -2,8 +2,8 @@ import { Argument } from "commander";
 import { getModuleFromCollection } from "../models/getModuleFromCollection.js";
 import { handleDescribeSingleOperation } from "../operations/handleDescribeSingleOperation.js";
 import { localStorage } from "../helpers/localStorage.js";
-import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
 export function createDescribeCommand(program) {
     program
         .command("describe")
@@ -11,19 +11,21 @@ export function createDescribeCommand(program) {
         .description("Show detailed YAML description of an entry")
         .addHelpText("after", `
 Examples:
-  ay describe contacts 64a1b2c3d4e5     Describe a contact entry
-  ay d                                   Describe last used entry`)
+  ay describe contacts 64a1b2c3d4e5              Describe a contact entry
+  ay describe tasks 64a1b2c3d4e5 comments        Extract sub-resource array
+  ay describe tasks 64a1b2c3d4e5 comments -r json Sub-resource as JSON
+  ay describe tasks 64a1b2c3d4e5 --jq "subject"  JMESPath on describe
+  ay d                                            Describe last used entry`)
         .addArgument(new Argument("[collection]", "The collection to use").default(localStorage.getItem("lastCollection"), `The last used collection (${localStorage.getItem("lastCollection")})`))
         .addArgument(new Argument("[id]", "The ID of the entry to describe").default(localStorage.getItem("lastId"), `The last used id (${localStorage.getItem("lastId")})`))
-        .action(async (collection, id, options) => {
+        .addArgument(new Argument("[subResource]", "Extract a sub-resource array (e.g., comments, attachments, worklogs)"))
+        .action(async (collection, id, subResource, options) => {
         try {
             if (!collection) {
-                spinner.error({ text: "Missing required argument: collection. Run a list or get command first, or provide it explicitly." });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: collection. Run a list or get command first, or provide it explicitly.", EXIT_MISUSE);
             }
             if (!id) {
-                spinner.error({ text: "Missing required argument: id. Provide an entry ID explicitly." });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: id. Provide an entry ID explicitly.", EXIT_MISUSE);
             }
             const opts = { ...program.opts(), ...options };
             const module = getModuleFromCollection(collection);
@@ -32,11 +34,11 @@ Examples:
             localStorage.setItem("lastId", id);
             await handleDescribeSingleOperation(module.module, collection, id, {
                 ...opts,
+                subResource,
             });
         }
         catch (e) {
-            spinner.error({ text: e.message || "An unexpected error occurred" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "An unexpected error occurred", EXIT_GENERAL_ERROR);
         }
     });
 }

package/lib/commands/createEditCommand.js

@@ -2,9 +2,10 @@ import { Argument } from "commander";
 import { getModuleFromCollection } from "../models/getModuleFromCollection.js";
 import { handleGetSingleOperation } from "../operations/handleGetSingleOperation.js";
 import { handleEditOperation } from "../operations/handleEditOperation.js";
+import { handleEditRawOperation } from "../operations/handleEditRawOperation.js";
 import { localStorage } from "../helpers/localStorage.js";
-import { spinner } from "../../index.js";
 import { EXIT_GENERAL_ERROR, EXIT_MISUSE } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
 export function createEditCommand(program) {
     program
         .command("edit")
@@ -19,12 +20,10 @@ Examples:
         .action(async (collection, id, options) => {
         try {
             if (!collection) {
-                spinner.error({ text: "Missing required argument: collection. Run a list or get command first, or provide it explicitly." });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: collection. Run a list or get command first, or provide it explicitly.", EXIT_MISUSE);
             }
             if (!id) {
-                spinner.error({ text: "Missing required argument: id. Provide an entry ID explicitly." });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: id. Provide an entry ID explicitly.", EXIT_MISUSE);
             }
             const opts = { ...program.opts(), ...options };
             const module = getModuleFromCollection(collection);
@@ -33,11 +32,17 @@ Examples:
             localStorage.setItem("lastId", id);
             let result = {};
             result = await handleGetSingleOperation(module.module, collection, id, opts);
-            await handleEditOperation(module.module, collection, result.content);
+            // handleEditOperation expects {columns, rows} table structure;
+            // fall back to raw JSON editor if content doesn't have columns
+            if (result.content && result.content.columns) {
+                await handleEditOperation(module.module, collection, result.content);
+            }
+            else {
+                await handleEditRawOperation(module.module, collection, result.result || result.data);
+            }
         }
         catch (e) {
-            spinner.error({ text: e.message || "An unexpected error occurred" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "An unexpected error occurred", EXIT_GENERAL_ERROR);
         }
     });
 }