@tolinax/ayoune-cli 2026.3.0 → 2026.4.0

package/lib/commands/createUpdateCommand.js

@@ -6,6 +6,7 @@ import { saveFile } from "../helpers/saveFile.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 createUpdateCommand(program) {
     program
         .command("update")
@@ -29,12 +30,10 @@ Examples:
         .action(async (collection, id, options) => {
         try {
             if (!collection) {
-                spinner.error({ text: "Missing required argument: collection" });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: collection", EXIT_MISUSE);
             }
             if (!id) {
-                spinner.error({ text: "Missing required argument: id" });
-                process.exit(EXIT_MISUSE);
+                cliError("Missing required argument: id", EXIT_MISUSE);
             }
             const opts = { ...program.opts(), ...options };
             const module = getModuleFromCollection(collection);
@@ -45,8 +44,7 @@ Examples:
                     body = JSON.parse(opts.body);
                 }
                 catch (_a) {
-                    spinner.error({ text: "Invalid JSON in --body" });
-                    process.exit(EXIT_MISUSE);
+                    cliError("Invalid JSON in --body", EXIT_MISUSE);
                 }
             }
             if (opts.bodyFile) {
@@ -56,8 +54,7 @@ Examples:
                     body = JSON.parse(content);
                 }
                 catch (_b) {
-                    spinner.error({ text: `Invalid JSON in file: ${opts.bodyFile}` });
-                    process.exit(EXIT_MISUSE);
+                    cliError(`Invalid JSON in file: ${opts.bodyFile}`, EXIT_MISUSE);
                 }
             }
             if (opts.bodyStdin && !process.stdin.isTTY) {
@@ -71,14 +68,12 @@ Examples:
                         body = JSON.parse(stdinContent);
                     }
                     catch (_c) {
-                        spinner.error({ text: "Invalid JSON from stdin" });
-                        process.exit(EXIT_MISUSE);
+                        cliError("Invalid JSON from stdin", EXIT_MISUSE);
                     }
                 }
             }
             if (!body) {
-                spinner.error({ text: "No update data provided. Use --body, --body-file, or --body-stdin." });
-                process.exit(EXIT_MISUSE);
+                cliError("No update data provided. Use --body, --body-file, or --body-stdin.", EXIT_MISUSE);
             }
             // Merge mode: GET existing → merge → PUT
             if (opts.merge) {
@@ -98,7 +93,10 @@ Examples:
                 verbosity: opts.verbosity,
                 hideMeta: opts.hideMeta,
             });
-            handleResponseFormatOptions(opts, res);
+            // Dry-run returns null payload — skip output to avoid printing "null"
+            if ((res === null || res === void 0 ? void 0 : res.payload) !== null && (res === null || res === void 0 ? void 0 : res.payload) !== undefined) {
+                handleResponseFormatOptions(opts, res);
+            }
             spinner.success({ text: `Updated entry ${id} in ${collection}` });
             spinner.stop();
             localStorage.setItem("lastModule", module.module);
@@ -108,8 +106,7 @@ Examples:
                 await saveFile("update", opts, res);
         }
         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/createUsersCommand.js

@@ -4,6 +4,7 @@ import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOpti
 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";
 export function createUsersCommand(program) {
     const users = program
         .command("users")
@@ -36,7 +37,7 @@ export function createUsersCommand(program) {
                 params.role = opts.role;
             if (opts.active)
                 params.active = "true";
-            const res = await apiCallHandler("config", "users", "get", null, params);
+            const res = await apiCallHandler("su", "users", "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;
             spinner.success({ text: `Found ${total} users` });
@@ -45,8 +46,7 @@ export function createUsersCommand(program) {
                 await saveFile("users-list", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list users" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list users", EXIT_GENERAL_ERROR);
         }
     });
     // ay users get <id>
@@ -57,7 +57,7 @@ export function createUsersCommand(program) {
         try {
             const opts = { ...program.opts(), ...options };
             spinner.start({ text: `Fetching user ${id}...`, color: "magenta" });
-            const res = await apiCallHandler("config", `users/${id}`, "get", null, {
+            const res = await apiCallHandler("su", `users/${id}`, "get", null, {
                 responseFormat: opts.responseFormat,
                 verbosity: opts.verbosity,
             });
@@ -66,8 +66,7 @@ export function createUsersCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to get user" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to get user", EXIT_GENERAL_ERROR);
         }
     });
     // ay users invite --email <email> --role <roleId>
@@ -89,7 +88,7 @@ export function createUsersCommand(program) {
                 body.firstName = opts.firstName;
             if (opts.lastName)
                 body.lastName = opts.lastName;
-            const res = await apiCallHandler("config", "users", "post", body, {
+            const res = await apiCallHandler("su", "users", "post", body, {
                 responseFormat: opts.responseFormat,
             });
             handleResponseFormatOptions(opts, res);
@@ -97,8 +96,7 @@ export function createUsersCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to invite user" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to invite user", EXIT_GENERAL_ERROR);
         }
     });
     // ay users deactivate <id>
@@ -119,7 +117,7 @@ export function createUsersCommand(program) {
                 }
             }
             spinner.start({ text: `Deactivating user ${id}...`, color: "magenta" });
-            const res = await apiCallHandler("config", "users", "put", { _id: id, active: false }, {
+            const res = await apiCallHandler("su", "users", "put", { _id: id, active: false }, {
                 responseFormat: opts.responseFormat,
             });
             handleResponseFormatOptions(opts, res);
@@ -127,8 +125,7 @@ export function createUsersCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to deactivate user" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to deactivate user", EXIT_GENERAL_ERROR);
         }
     });
     // ── TEAMS ──────────────────────────────────────────────
@@ -156,7 +153,7 @@ export function createUsersCommand(program) {
             };
             if (opts.search)
                 params.q = opts.search;
-            const res = await apiCallHandler("config", "teams", "get", null, params);
+            const res = await apiCallHandler("su", "teams", "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;
             spinner.success({ text: `Found ${total} teams` });
@@ -165,8 +162,7 @@ export function createUsersCommand(program) {
                 await saveFile("teams-list", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list teams" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list teams", EXIT_GENERAL_ERROR);
         }
     });
     // ay users teams get <id>
@@ -177,7 +173,7 @@ export function createUsersCommand(program) {
         try {
             const opts = { ...program.opts(), ...options };
             spinner.start({ text: `Fetching team ${id}...`, color: "magenta" });
-            const res = await apiCallHandler("config", `teams/${id}`, "get", null, {
+            const res = await apiCallHandler("su", `teams/${id}`, "get", null, {
                 responseFormat: opts.responseFormat,
                 verbosity: opts.verbosity,
             });
@@ -186,8 +182,7 @@ export function createUsersCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to get team" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to get team", EXIT_GENERAL_ERROR);
         }
     });
     // ay users teams create --body '{...}'
@@ -205,19 +200,17 @@ export function createUsersCommand(program) {
                     body = JSON.parse(opts.body);
                 }
                 catch (_a) {
-                    spinner.error({ text: "Invalid JSON in --body" });
-                    process.exit(EXIT_MISUSE);
+                    cliError("Invalid JSON in --body", EXIT_MISUSE);
                 }
             }
             else if (opts.name) {
                 body = { name: opts.name };
             }
             if (!body) {
-                spinner.error({ text: "Provide team definition via --name or --body" });
-                process.exit(EXIT_MISUSE);
+                cliError("Provide team definition via --name or --body", EXIT_MISUSE);
             }
             spinner.start({ text: "Creating team...", color: "magenta" });
-            const res = await apiCallHandler("config", "teams", "post", body, {
+            const res = await apiCallHandler("su", "teams", "post", body, {
                 responseFormat: opts.responseFormat,
             });
             handleResponseFormatOptions(opts, res);
@@ -225,8 +218,7 @@ export function createUsersCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to create team" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to create team", EXIT_GENERAL_ERROR);
         }
     });
     // ── ROLES ──────────────────────────────────────────────
@@ -244,7 +236,7 @@ export function createUsersCommand(program) {
         try {
             const opts = { ...program.opts(), ...options };
             spinner.start({ text: "Fetching roles...", color: "magenta" });
-            const res = await apiCallHandler("config", "roles", "get", null, {
+            const res = await apiCallHandler("su", "roles", "get", null, {
                 limit: opts.limit,
                 responseFormat: opts.responseFormat,
                 verbosity: opts.verbosity,
@@ -257,8 +249,7 @@ export function createUsersCommand(program) {
                 await saveFile("roles-list", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list roles" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list roles", EXIT_GENERAL_ERROR);
         }
     });
     // ay users roles get <id>
@@ -269,7 +260,7 @@ export function createUsersCommand(program) {
         try {
             const opts = { ...program.opts(), ...options };
             spinner.start({ text: `Fetching role ${id}...`, color: "magenta" });
-            const res = await apiCallHandler("config", `roles/${id}`, "get", null, {
+            const res = await apiCallHandler("su", `roles/${id}`, "get", null, {
                 responseFormat: opts.responseFormat,
                 verbosity: opts.verbosity,
             });
@@ -278,8 +269,7 @@ export function createUsersCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to get role" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to get role", EXIT_GENERAL_ERROR);
         }
     });
 }

package/lib/commands/createWebhooksCommand.js

@@ -3,6 +3,7 @@ import { handleResponseFormatOptions } from "../helpers/handleResponseFormatOpti
 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";
 export function createWebhooksCommand(program) {
     const hooks = program
         .command("webhooks")
@@ -16,7 +17,7 @@ export function createWebhooksCommand(program) {
         .option("-l, --limit <number>", "Limit results", parseInt, 50)
         .option("-p, --page <number>", "Page number", parseInt, 1)
         .action(async (options) => {
-        var _a, _b, _c;
+        var _a, _b;
         try {
             const opts = { ...program.opts(), ...options };
             spinner.start({ text: "Fetching webhooks...", color: "magenta" });
@@ -26,16 +27,15 @@ export function createWebhooksCommand(program) {
                 responseFormat: opts.responseFormat,
                 verbosity: opts.verbosity,
             });
-            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} webhooks` });
             spinner.stop();
             if (opts.save)
                 await saveFile("webhooks-list", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list webhooks" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list webhooks", EXIT_GENERAL_ERROR);
         }
     });
     // ay webhooks get <id>
@@ -55,8 +55,7 @@ export function createWebhooksCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to get webhook" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to get webhook", EXIT_GENERAL_ERROR);
         }
     });
     // ay webhooks create --body '{...}'
@@ -74,8 +73,7 @@ export function createWebhooksCommand(program) {
                     body = JSON.parse(opts.body);
                 }
                 catch (_a) {
-                    spinner.error({ text: "Invalid JSON in --body" });
-                    process.exit(EXIT_MISUSE);
+                    cliError("Invalid JSON in --body", EXIT_MISUSE);
                 }
             }
             else if (opts.bodyFile) {
@@ -84,13 +82,11 @@ export function createWebhooksCommand(program) {
                     body = JSON.parse(fs.readFileSync(opts.bodyFile, "utf-8"));
                 }
                 catch (_b) {
-                    spinner.error({ text: `Invalid JSON in file: ${opts.bodyFile}` });
-                    process.exit(EXIT_MISUSE);
+                    cliError(`Invalid JSON in file: ${opts.bodyFile}`, EXIT_MISUSE);
                 }
             }
             if (!body) {
-                spinner.error({ text: "Provide webhook definition via --body or --body-file" });
-                process.exit(EXIT_MISUSE);
+                cliError("Provide webhook definition via --body or --body-file", EXIT_MISUSE);
             }
             spinner.start({ text: "Creating webhook...", color: "magenta" });
             const res = await apiCallHandler("config", "hooks", "post", body, {
@@ -101,8 +97,7 @@ export function createWebhooksCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to create webhook" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to create webhook", EXIT_GENERAL_ERROR);
         }
     });
     // ay webhooks delete <id>
@@ -122,8 +117,7 @@ export function createWebhooksCommand(program) {
             spinner.stop();
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to delete webhook" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to delete webhook", EXIT_GENERAL_ERROR);
         }
     });
     // ay webhooks templates
@@ -132,7 +126,7 @@ export function createWebhooksCommand(program) {
         .description("List available webhook templates")
         .option("-l, --limit <number>", "Limit results", parseInt, 50)
         .action(async (options) => {
-        var _a, _b, _c;
+        var _a, _b;
         try {
             const opts = { ...program.opts(), ...options };
             spinner.start({ text: "Fetching webhook templates...", color: "magenta" });
@@ -141,16 +135,15 @@ export function createWebhooksCommand(program) {
                 responseFormat: opts.responseFormat,
                 verbosity: opts.verbosity,
             });
-            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} webhook templates` });
             spinner.stop();
             if (opts.save)
                 await saveFile("webhook-templates", opts, res);
         }
         catch (e) {
-            spinner.error({ text: e.message || "Failed to list templates" });
-            process.exit(EXIT_GENERAL_ERROR);
+            cliError(e.message || "Failed to list templates", EXIT_GENERAL_ERROR);
         }
     });
 }

package/lib/commands/createWhoAmICommand.js

@@ -1,10 +1,10 @@
 import chalk from "chalk";
 import moment from "moment";
-import { localStorage } from "../helpers/localStorage.js";
+import { secureStorage } from "../helpers/secureStorage.js";
 import { decodeToken } from "../api/decodeToken.js";
-import { spinner } from "../../index.js";
 import { login } from "../api/login.js";
 import { EXIT_GENERAL_ERROR } from "../exitCodes.js";
+import { cliError } from "../helpers/cliError.js";
 const LABEL_MAP = {
     _id: "User ID",
     _customerID: "Customer",
@@ -30,6 +30,9 @@ function formatValue(key, value) {
         }
         return `${formatted} ${chalk.dim(`(${relative})`)}`;
     }
+    if (key === "type" && value === "superuser") {
+        return chalk.yellow.bold("superuser");
+    }
     if (typeof value === "object" && value !== null) {
         return JSON.stringify(value);
     }
@@ -68,21 +71,20 @@ export function createWhoAmICommand(program) {
         .description("Display the currently authenticated user")
         .action(async (options) => {
         try {
-            const tokenPayload = decodeToken(localStorage.getItem("token"));
+            const tokenPayload = decodeToken(secureStorage.getItem("token"));
             if (tokenPayload) {
                 displayUser(tokenPayload.payload);
             }
             else {
                 await login();
-                const newPayload = decodeToken(localStorage.getItem("token"));
+                const newPayload = decodeToken(secureStorage.getItem("token"));
                 if (newPayload) {
                     displayUser(newPayload.payload);
                 }
             }
         }
         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/helpers/cliError.js

@@ -0,0 +1,24 @@
+import { spinner } from "../../index.js";
+let jsonErrorsEnabled = false;
+export function setJsonErrorsEnabled(enabled) {
+    jsonErrorsEnabled = enabled;
+}
+export function isJsonErrorsEnabled() {
+    return jsonErrorsEnabled;
+}
+/**
+ * Centralized CLI error handler.
+ * When --json-errors is active, emits structured JSON to stderr.
+ * Otherwise, uses spinner.error for human-readable output.
+ * Always calls process.exit with the given code.
+ */
+export function cliError(message, code, type = "cli_error") {
+    if (jsonErrorsEnabled) {
+        const err = { error: type, code, message };
+        console.error(JSON.stringify(err));
+    }
+    else {
+        spinner.error({ text: message });
+    }
+    process.exit(code);
+}

package/lib/helpers/config.js

@@ -3,4 +3,5 @@ export const config = {
     auditUrl: process.env.AYOUNE_AUDIT_URL || "https://audit.ayoune.app",
     notifierUrl: process.env.AYOUNE_NOTIFIER_URL || "https://notifier.ayoune.app",
     loginUrl: process.env.AYOUNE_LOGIN_URL || "https://login.ayoune.app",
+    searchUrl: process.env.AYOUNE_SEARCH_HOST || "https://search-api.ayoune.app",
 };

package/lib/helpers/configLoader.js

@@ -58,3 +58,9 @@ export function getNotifierUrl(config) {
         profile.notifierUrl ||
         "https://notifier.ayoune.app");
 }
+export function getSearchUrl(config) {
+    const profile = getActiveProfile(config);
+    return (process.env.AYOUNE_SEARCH_HOST ||
+        profile.searchUrl ||
+        "https://search-api.ayoune.app");
+}

package/lib/helpers/contextInjector.js

@@ -0,0 +1,65 @@
+import { contextSlots } from "../../data/contextSlots.js";
+import { getActiveContext } from "./contextStore.js";
+let contextDisabled = false;
+export function disableContext() {
+    contextDisabled = true;
+}
+export function hasActiveContext() {
+    if (contextDisabled)
+        return false;
+    return Object.keys(getActiveContext()).length > 0;
+}
+export function getContextCreateFields(collection) {
+    if (contextDisabled)
+        return {};
+    const active = getActiveContext();
+    const fields = {};
+    const col = collection.toLowerCase();
+    for (const slot of contextSlots) {
+        const entry = active[slot.slot];
+        if (!entry)
+            continue;
+        const fieldName = slot.injectAsCreateField[col];
+        if (fieldName) {
+            fields[fieldName] = entry.id;
+        }
+    }
+    return fields;
+}
+export function getContextFilterParams(collection) {
+    if (contextDisabled)
+        return {};
+    const active = getActiveContext();
+    const params = {};
+    const col = collection.toLowerCase();
+    for (const slot of contextSlots) {
+        const entry = active[slot.slot];
+        if (!entry)
+            continue;
+        const paramName = slot.injectAsFilterField[col];
+        if (paramName) {
+            params[paramName] = entry.id;
+        }
+    }
+    return params;
+}
+export function getContextSummary() {
+    if (contextDisabled)
+        return "";
+    const active = getActiveContext();
+    const entries = Object.entries(active);
+    if (entries.length === 0)
+        return "";
+    const lines = entries.map(([slot, entry]) => `- Active ${slot}: "${entry.name}" (${entry.collection}, ID: ${entry.id})`);
+    return `[Active context]\n${lines.join("\n")}`;
+}
+export function getContextForAI() {
+    if (contextDisabled)
+        return {};
+    const active = getActiveContext();
+    const result = {};
+    for (const [slot, entry] of Object.entries(active)) {
+        result[slot] = { id: entry.id, name: entry.name, collection: entry.collection };
+    }
+    return result;
+}

package/lib/helpers/contextResolver.js

@@ -0,0 +1,70 @@
+import { apiCallHandler } from "../api/apiCallHandler.js";
+import { getSlot, getChildSlots } from "../../data/contextSlots.js";
+import { getContextEntry } from "./contextStore.js";
+const OBJECT_ID_RE = /^[0-9a-fA-F]{24}$/;
+export async function resolveEntity(slot, input) {
+    const slotDef = getSlot(slot);
+    if (!slotDef)
+        return [];
+    // Direct ID lookup
+    if (OBJECT_ID_RE.test(input)) {
+        try {
+            const res = await apiCallHandler(slotDef.module, `${slotDef.collection}/${input}`, "get", null, { fields: `_id,${slotDef.nameField}`, responseFormat: "json" });
+            if (res === null || res === void 0 ? void 0 : res.payload) {
+                const entity = Array.isArray(res.payload) ? res.payload[0] : res.payload;
+                if (entity === null || entity === void 0 ? void 0 : entity._id) {
+                    return [{ id: entity._id, name: entity[slotDef.nameField] || entity._id }];
+                }
+            }
+        }
+        catch (_a) {
+            // Fall through to search
+        }
+    }
+    // Search by name
+    const params = {
+        q: input,
+        limit: 5,
+        responseFormat: "json",
+        fields: `_id,${slotDef.nameField}`,
+    };
+    // If parent context is active, filter by it
+    if (slotDef.parent) {
+        const parentEntry = getContextEntry(slotDef.parent);
+        if (parentEntry) {
+            const parentSlot = getSlot(slotDef.parent);
+            if (parentSlot) {
+                const filterField = parentSlot.injectAsFilterField[slotDef.collection];
+                if (filterField) {
+                    params[filterField] = parentEntry.id;
+                }
+            }
+        }
+    }
+    try {
+        const res = await apiCallHandler(slotDef.module, slotDef.collection, "get", null, params);
+        if ((res === null || res === void 0 ? void 0 : res.payload) && Array.isArray(res.payload)) {
+            return res.payload.map((e) => ({
+                id: e._id,
+                name: e[slotDef.nameField] || e._id,
+            }));
+        }
+    }
+    catch (_b) {
+        // API error — return empty
+    }
+    return [];
+}
+export function validateHierarchy(slot) {
+    const slotDef = getSlot(slot);
+    if (!(slotDef === null || slotDef === void 0 ? void 0 : slotDef.parent))
+        return null;
+    const parentEntry = getContextEntry(slotDef.parent);
+    if (!parentEntry) {
+        return `Warning: Setting "${slot}" without parent "${slotDef.parent}" context. Results may not be scoped correctly.`;
+    }
+    return null;
+}
+export function getDependentSlots(slot) {
+    return getChildSlots(slot).map((s) => s.slot);
+}

package/lib/helpers/contextStore.js

@@ -0,0 +1,46 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import path from "path";
+import os from "os";
+const CONTEXT_PATH = path.join(os.homedir(), ".config", "ayoune", "context.json");
+function ensureDir() {
+    const dir = path.dirname(CONTEXT_PATH);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+export function loadContext() {
+    if (!existsSync(CONTEXT_PATH)) {
+        return { active: {} };
+    }
+    try {
+        const raw = readFileSync(CONTEXT_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch (_a) {
+        return { active: {} };
+    }
+}
+export function saveContext(data) {
+    ensureDir();
+    writeFileSync(CONTEXT_PATH, JSON.stringify(data, null, 2), "utf-8");
+}
+export function getContextEntry(slot) {
+    const ctx = loadContext();
+    return ctx.active[slot];
+}
+export function setContextEntry(slot, entry) {
+    const ctx = loadContext();
+    ctx.active[slot] = entry;
+    saveContext(ctx);
+}
+export function unsetContextEntry(slot) {
+    const ctx = loadContext();
+    delete ctx.active[slot];
+    saveContext(ctx);
+}
+export function clearAllContext() {
+    saveContext({ active: {} });
+}
+export function getActiveContext() {
+    return loadContext().active;
+}