levix-bot 2.0.0

package/src/commands/help.cjs

@@ -0,0 +1,230 @@
+const fs = require("fs");
+const path = require("path");
+const logger = require("../utils/logger.cjs");
+const brand = require("../config/brand.cjs");
+const { sendBotMessage } = require("../utils/sendBotMessage.cjs");
+const runtimeConfig = require("../config/runtime-config.cjs");
+
+// Recursive function to get all command files
+function getAllCommandFiles(dirPath, fileList = []) {
+  const files = fs.readdirSync(dirPath);
+
+  files.forEach((file) => {
+    const filePath = path.join(dirPath, file);
+    if (fs.statSync(filePath).isDirectory()) {
+      fileList = getAllCommandFiles(filePath, fileList);
+    } else if (file.endsWith(".cjs") || file.endsWith(".js")) {
+      fileList.push(filePath);
+    }
+  });
+
+  return fileList;
+}
+
+// Cache the loaded command modules so we don't re-require on every invocation.
+let cached = null;
+function loadAllCommands() {
+  if (cached) return cached;
+  const commandsPath = path.join(__dirname);
+  const files = getAllCommandFiles(commandsPath).filter(
+    (file) =>
+      path.basename(file) !== "help.cjs" && path.basename(file) !== "help.js"
+  );
+
+  const commands = { general: [], group: [] };
+  for (const file of files) {
+    try {
+      const command = require(file);
+      if (!command?.name || !command?.description) continue;
+      const relativePath = path.relative(commandsPath, file);
+      if (path.dirname(relativePath) === "group") {
+        commands.group.push(command);
+      } else {
+        commands.general.push(command);
+      }
+    } catch (error) {
+      logger.error(error, `Could not load command from ${file}:`);
+    }
+  }
+
+  commands.general.push(module.exports);
+
+  // Build alias index for inverse lookup.
+  const aliasIndex = new Map();
+  for (const cmd of [...commands.general, ...commands.group]) {
+    for (const alias of aliasesOf(cmd)) {
+      aliasIndex.set(String(alias).toLowerCase(), cmd);
+    }
+  }
+
+  commands.general.sort((a, b) => a.name.localeCompare(b.name));
+  commands.group.sort((a, b) => a.name.localeCompare(b.name));
+
+  cached = { commands, aliasIndex };
+  return cached;
+}
+
+function findCommand(query, commands, aliasIndex) {
+  const q = query.toLowerCase();
+  const all = [...commands.general, ...commands.group];
+  const direct = all.find((cmd) => cmd.name.toLowerCase() === q);
+  if (direct) return direct;
+  if (aliasIndex.has(q)) return aliasIndex.get(q);
+  return null;
+}
+
+// Prefix, aliases and permissions are all changeable at runtime (`!setprefix`,
+// the dashboard), so read the live values rather than the file defaults.
+function currentPrefix() {
+  return runtimeConfig.getPrefix();
+}
+
+/** Effective aliases: a dashboard override if there is one, else the file's. */
+function aliasesOf(command) {
+  return runtimeConfig.getAliases(command.name, command.aliases || []);
+}
+
+/**
+ * `usage` is authored WITHOUT the prefix ("kick @user [reason]") and may hold
+ * several variants separated by newlines. Render each one with the live prefix.
+ */
+function usageLines(command, prefix) {
+  const raw = command.usage || command.name;
+  return String(raw)
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => `${prefix}${line}`);
+}
+
+// Permission level as configured for this command (group sub-commands live in
+// their own map). Shown in the detail view so members know why a command is
+// refusing them.
+const PERMISSION_LABELS = {
+  MEMBERS: "الكل",
+  ALL: "الكل",
+  ADMINS_ONLY: "المشرفين فقط",
+  ADMINS_OWNER: "المشرفين والمالك",
+  OWNER_ONLY: "المالك فقط",
+};
+
+function permissionFor(command, isGroupCommand) {
+  const level = runtimeConfig.getPermission(
+    isGroupCommand ? `group:${command.name}` : command.name
+  );
+  return PERMISSION_LABELS[level] || level;
+}
+
+const CHAT_LABELS = {
+  all: "كل المحادثات",
+  group: "المجموعات فقط",
+  private: "الخاص فقط",
+};
+
+module.exports = {
+  name: "help",
+  aliases: ["menu", "commands", "h"],
+  description: "Shows a list of all commands or info about a specific command.",
+  usage: "help [اسم الأمر]",
+  chat: "all",
+
+  async execute(sock, msg, args) {
+    const prefix = currentPrefix();
+    const { commands, aliasIndex } = loadAllCommands();
+
+    if (!args[0]) {
+      const section = (title, list) => {
+        let text = `├─ *${title}*\n`;
+        list.forEach((cmd) => {
+          const aliases = aliasesOf(cmd);
+          const aliasSnippet = aliases.length
+            ? ` _(${aliases.map((a) => prefix + a).join(", ")})_`
+            : "";
+          text += `│  ◦ *${prefix}${cmd.name}*${aliasSnippet}\n`;
+          text += `│     ${cmd.description}\n`;
+          // The parameters are the whole point of a help list — show them.
+          usageLines(cmd, prefix).forEach((line) => {
+            text += `│     ⌨️ \`${line}\`\n`;
+          });
+        });
+        return `${text}│\n`;
+      };
+
+      // A command switched off from the dashboard can't run, so it has no
+      // business in the menu.
+      const live = (list) =>
+        list.filter((cmd) => !runtimeConfig.isDisabled(cmd.name));
+
+      const general = live(commands.general);
+      const group = live(commands.group);
+
+      let helpText = `╭───「 *🤖 ${brand.name} Commands* 」\n│\n`;
+      if (general.length) helpText += section("General Commands", general);
+      if (group.length) helpText += section("Group Commands", group);
+
+      helpText += `├─ *الرموز*\n`;
+      helpText += `│  \`<...>\` مطلوب · \`[...]\` اختياري · \`a|b\` اختر واحد\n│\n`;
+      helpText += `╰───「 اكتب *${prefix}help <أمر>* لتفاصيل أكتر 」`;
+
+      return sendBotMessage(sock, msg.key.remoteJid, { text: helpText }, { replyTo: msg });
+    }
+
+    const query = args[0].startsWith(prefix) ? args[0].slice(prefix.length) : args[0];
+    const command = findCommand(query, commands, aliasIndex);
+
+    if (!command) {
+      return sendBotMessage(
+        sock,
+        msg.key.remoteJid,
+        {
+          text:
+            `❌ الأمر "*${args[0]}*" غير موجود.\n` +
+            `اكتب \`${prefix}help\` لعرض كل الأوامر.`,
+        },
+        { replyTo: msg }
+      );
+    }
+
+    let usageText = `╭───「 *Command Details* 」\n│\n`;
+    usageText += `├─ *الأمر:* ${prefix}${command.name}\n`;
+
+    const commandAliases = aliasesOf(command);
+    if (commandAliases.length) {
+      usageText += `├─ *اختصارات:* ${commandAliases
+        .map((a) => `${prefix}${a}`)
+        .join(", ")}\n`;
+    }
+
+    if (command.description) {
+      usageText += `├─ *الوصف:* ${command.description}\n`;
+    }
+
+    usageText += `├─ *الاستخدام:*\n`;
+    usageLines(command, prefix).forEach((line) => {
+      usageText += `│     \`${line}\`\n`;
+    });
+
+    if (command.examples?.length) {
+      usageText += `├─ *أمثلة:*\n`;
+      command.examples.forEach((example) => {
+        usageText += `│     \`${prefix}${example}\`\n`;
+      });
+    }
+
+    usageText += `├─ *المكان:* ${CHAT_LABELS[command.chat] || command.chat || "كل المحادثات"}\n`;
+    const isGroupCommand = commands.group.includes(command);
+    usageText += `├─ *الصلاحية:* ${permissionFor(command, isGroupCommand)}\n`;
+
+    if (command.userAdminRequired) {
+      usageText += `├─ ⚠️ لازم تكون مشرف\n`;
+    }
+    if (command.botAdminRequired) {
+      usageText += `├─ ⚠️ لازم البوت يكون مشرف\n`;
+    }
+
+    usageText += `│\n├─ \`<...>\` مطلوب · \`[...]\` اختياري\n`;
+    usageText += `│\n╰───「 ${brand.name} 」`;
+
+    return sendBotMessage(sock, msg.key.remoteJid, { text: usageText }, { replyTo: msg });
+  },
+};

package/src/commands/listschedules.cjs

@@ -0,0 +1,47 @@
+// file: /commands/listschedules.js
+const { getScheduledJobs } = require("../../scheduler.cjs");
+
+module.exports = {
+  name: "listschedules",
+  description: "Lists all active and pending scheduled jobs.",
+  usage: "listschedules",
+  chat: "all",
+  userAdminRequired: true,
+
+  async execute(sock, msg) {
+    const jobs = getScheduledJobs();
+    const activeJobs = jobs.filter(
+      (job) => job.status === "pending" || job.status === "active"
+    );
+
+    if (activeJobs.length === 0) {
+      return await sock.sendMessage(msg.key.remoteJid, {
+        text: "لا توجد مهام مجدولة حاليًا.",
+      });
+    }
+
+    let reply = "*⏰ المهام المجدولة النشطة:*\n\n";
+
+    activeJobs.forEach((job, index) => {
+      reply += `*${index + 1}. المهمة:*\n`;
+      reply += `*ID:* \`${job.id}\`\n`;
+      reply += `*الرسالة:* "${job.message}"\n`;
+
+      if (job.type === "recurring") {
+        reply += `*التكرار:* ${job.cronString} (يوميًا/أسبوعيًا)\n`;
+      } else {
+        const jobDate = new Date(job.date).toLocaleString("ar-EG", {
+          timeZone: "Africa/Cairo",
+        });
+        reply += `*الوقت المحدد:* ${jobDate}\n`;
+      }
+      reply += `*الوجهة:* ${
+        job.targetJid.endsWith("@g.us") ? "هذا الجروب" : "محادثة خاصة"
+      }\n\n`;
+    });
+
+    reply += "*لحذف مهمة، استخدم:*\n`!deleteschedule <ID>`";
+
+    await sock.sendMessage(msg.key.remoteJid, { text: reply });
+  },
+};

package/src/commands/loop.cjs

@@ -0,0 +1,163 @@
+// تكرار — !loop
+//
+// Repeats a number range or a piece of text, either bundled into ONE message
+// or sent as SEPARATE messages.
+//
+//   !loop 5 اهلا              5 lines in one message
+//   !loop 1-10                the numbers 1 … 10
+//   !loop 1-20:5              1, 6, 11, 16  (step 5)
+//   !loop 3 صباح الخير -s     three separate messages
+//   !loop 1-5 السطر رقم {n}   {n} = current number, {i} = iteration index
+//
+// Hard caps keep an innocent `!loop 100000` from turning the bot into a
+// flood bot (and from getting the account banned).
+
+const { sendBotMessage } = require("../utils/sendBotMessage.cjs");
+
+const MAX_ITEMS = 100; // total iterations, one-message mode
+const MAX_SPLIT_ITEMS = 15; // total iterations, separate-messages mode
+const MAX_OUTPUT_CHARS = 3500; // WhatsApp starts truncating well past this
+const SPLIT_GAP_MS = 900; // breathing room between separate sends
+
+const SPLIT_FLAGS = new Set(["-s", "--split", "split", "منفصل", "منفصلة"]);
+const NO_NUMBER_FLAGS = new Set(["-n", "--nonum", "--plain", "بدون-ترقيم"]);
+
+const HELP_TEXT =
+  "🔁 *أمر التكرار*\n\n" +
+  "*الاستخدام:*\n" +
+  "`!loop <عدد> <النص>` — يكرر النص في رسالة واحدة\n" +
+  "`!loop <من>-<إلى>` — يطبع الأرقام من/إلى\n" +
+  "`!loop <من>-<إلى>:<خطوة>` — بخطوة مخصصة\n\n" +
+  "*خيارات:*\n" +
+  "`-s` رسائل منفصلة بدل رسالة واحدة\n" +
+  "`-n` من غير ترقيم\n\n" +
+  "*متغيرات داخل النص:*\n" +
+  "`{n}` الرقم الحالي · `{i}` رقم التكرار\n\n" +
+  "*أمثلة:*\n" +
+  "`!loop 5 اهلا`\n" +
+  "`!loop 1-10`\n" +
+  "`!loop 0-100:25 العداد {n}`\n" +
+  "`!loop 3 صباح الخير -s`\n\n" +
+  `_الحد الأقصى: ${MAX_ITEMS} تكرار في رسالة واحدة، ${MAX_SPLIT_ITEMS} رسالة منفصلة._`;
+
+/**
+ * `5` -> 1..5 · `3-9` -> 3..9 · `0-100:25` -> 0,25,50,75,100
+ * Returns null when the token isn't a count/range at all.
+ */
+function parseRange(token) {
+  if (!token) return null;
+
+  const match = String(token)
+    .replace(/[٠-٩]/g, (d) => String("٠١٢٣٤٥٦٧٨٩".indexOf(d)))
+    .match(/^(-?\d+)(?:\s*(?:-|\.\.|إلى|to)\s*(-?\d+))?(?::(\d+))?$/);
+  if (!match) return null;
+
+  const first = Number(match[1]);
+  const second = match[2] === undefined ? null : Number(match[2]);
+  const step = match[3] ? Number(match[3]) : 1;
+  if (!step || step < 1) return null;
+
+  // A bare number is a repeat count, not a range.
+  const from = second === null ? 1 : first;
+  const to = second === null ? first : second;
+
+  return { from, to, step, isCount: second === null };
+}
+
+/** How many iterations the range asks for — computed, not enumerated. */
+function countOf({ from, to, step }) {
+  return Math.floor(Math.abs(to - from) / step) + 1;
+}
+
+function buildNumbers({ from, to, step }, limit) {
+  const numbers = [];
+  const descending = to < from;
+  for (
+    let value = from;
+    descending ? value >= to : value <= to;
+    value += descending ? -step : step
+  ) {
+    numbers.push(value);
+    if (numbers.length >= limit) break;
+  }
+  return numbers;
+}
+
+function renderLine(template, number, index) {
+  if (!template) return String(number);
+  return template
+    .replace(/\{n\}/gi, String(number))
+    .replace(/\{i\}/gi, String(index));
+}
+
+module.exports = {
+  name: "loop",
+  aliases: ["repeat", "كرر", "تكرار"],
+  description: "يكرر نص أو أرقام — في رسالة واحدة أو رسائل منفصلة.",
+  usage:
+    "loop <عدد|من-إلى[:خطوة]> [النص] [-s رسائل منفصلة] [-n بدون ترقيم]",
+  chat: "all",
+
+  async execute(sock, msg, args) {
+    const chatId = msg.key.remoteJid;
+    const reply = (text) => sendBotMessage(sock, chatId, { text }, { replyTo: msg });
+
+    // Pull the flags out wherever the user put them.
+    let split = false;
+    let numbered = true;
+    const rest = [];
+    for (const arg of args) {
+      const token = arg.toLowerCase();
+      if (SPLIT_FLAGS.has(token)) split = true;
+      else if (NO_NUMBER_FLAGS.has(token)) numbered = false;
+      else rest.push(arg);
+    }
+
+    const range = parseRange(rest[0]);
+    if (!range) return reply(HELP_TEXT);
+
+    const template = rest.slice(1).join(" ").trim();
+    const limit = split ? MAX_SPLIT_ITEMS : MAX_ITEMS;
+    const requested = countOf(range);
+
+    if (requested < 1) return reply("❌ المدى ده مش بيطلع أي أرقام.");
+    if (requested > limit) {
+      return reply(
+        `❌ ${requested} تكرار كتير أوي.\n` +
+          `الحد الأقصى ${limit} ${split ? "رسالة منفصلة" : "تكرار في الرسالة الواحدة"}.`
+      );
+    }
+
+    const numbers = buildNumbers(range, limit);
+    if (!numbers.length) return reply("❌ المدى ده مش بيطلع أي أرقام.");
+
+    // A bare count with text repeats the text; a range without text prints the
+    // numbers. Either way {n}/{i} are substituted per line.
+    const lines = numbers.map((number, index) =>
+      renderLine(template, number, index + 1)
+    );
+
+    if (split) {
+      for (let i = 0; i < lines.length; i++) {
+        const body = numbered ? `${i + 1}. ${lines[i]}` : lines[i];
+        await sendBotMessage(
+          sock,
+          chatId,
+          { text: body },
+          { replyTo: i === 0 ? msg : null, typing: false, delayMs: SPLIT_GAP_MS }
+        );
+      }
+      return;
+    }
+
+    let text = lines
+      .map((line, i) => (numbered ? `${i + 1}. ${line}` : line))
+      .join("\n");
+
+    if (text.length > MAX_OUTPUT_CHARS) {
+      text = `${text.slice(0, MAX_OUTPUT_CHARS)}\n…\n_(اتقصت عشان طولها)_`;
+    }
+
+    return reply(text);
+  },
+};

package/src/commands/memory.cjs

@@ -0,0 +1,201 @@
+// Long-term memory, straight from WhatsApp.
+//
+// The AI can save/forget things by itself (see services/aiTools.cjs) — this
+// command is the manual door to the same Markdown files:
+//
+//   memory/global.md                 shared by every chat
+//   memory/chats/<chat-id>.md        this conversation only
+//
+// Anyone can add a fact to the chat they're in; touching the global memory,
+// deleting entries or exporting a file is for admins/owners.
+
+const fs = require("fs");
+
+const memory = require("../utils/memory.cjs");
+const { sendBotMessage } = require("../utils/sendBotMessage.cjs");
+const {
+  isOwnerJidSync,
+  isBotAdminUserSync,
+  isAdminInGroupSync,
+} = require("../utils/permissions.cjs");
+const logger = require("../utils/logger.cjs");
+
+const GLOBAL_WORDS = new Set(["global", "-g", "--global", "عام", "العام", "الكل"]);
+
+function isGlobalFlag(value) {
+  return GLOBAL_WORDS.has(String(value || "").toLowerCase());
+}
+
+/** Pull a `global` flag out of the args wherever the user put it. */
+function extractScope(args) {
+  const rest = [];
+  let scope = "chat";
+  for (const arg of args) {
+    if (isGlobalFlag(arg)) scope = "global";
+    else rest.push(arg);
+  }
+  return { scope, rest };
+}
+
+function formatEntries(entries, { limit = 30 } = {}) {
+  if (!entries.length) return "_(فاضية)_";
+  const shown = entries.slice(-limit);
+  const lines = shown.map((entry, index) => {
+    const number = entries.length - shown.length + index + 1;
+    const when = entry.at ? entry.at.slice(0, 10) : "";
+    const who = entry.by ? ` · ${entry.by}` : "";
+    const meta = when || who ? `\n   _${when}${who}_` : "";
+    return `*${number}.* ${entry.content}${meta}`;
+  });
+  const skipped = entries.length - shown.length;
+  return (
+    (skipped > 0 ? `_(+${skipped} أقدم مش معروضين)_\n\n` : "") + lines.join("\n")
+  );
+}
+
+module.exports = {
+  name: "memory",
+  aliases: ["mem", "ذاكرة", "remember"],
+  description:
+    "الذاكرة الدائمة للبوت (ملفات .md): إضافة، عرض، بحث، حذف، أو تصدير الملف.",
+  usage:
+    "memory\nmemory add <المعلومة>\nmemory add global <المعلومة>\nmemory search <كلمة>\nmemory forget <رقم|جزء من النص>\nmemory clear [global]\nmemory file [global]",
+  chat: "all",
+
+  async execute(sock, msg, args, body, groupMetadata) {
+    const chatId = msg.key.remoteJid;
+    const isGroup = chatId.endsWith("@g.us");
+    const senderId = isGroup ? msg.key.participant : msg.key.remoteJid;
+
+    const isOwner = msg.key.fromMe || isOwnerJidSync(senderId);
+    const privileged =
+      isOwner ||
+      isBotAdminUserSync(senderId) ||
+      (isGroup && isAdminInGroupSync(groupMetadata, senderId));
+
+    const action = String(args[0] || "").toLowerCase();
+    const { scope, rest } = extractScope(args.slice(1));
+
+    const reply = (text, extra = {}) =>
+      sendBotMessage(sock, chatId, { text, ...extra }, { replyTo: msg });
+
+    const denied = () =>
+      reply("🚫 ده للمشرفين والمالك بس. تقدر تضيف معلومة لذاكرة الشات عادي.");
+
+    try {
+      // ---------------------------------------------------------------- add
+      if (["add", "save", "احفظ", "ضيف", "اضف"].includes(action)) {
+        const content = rest.join(" ").trim();
+        if (!content) {
+          return reply(
+            "اكتب المعلومة بعد الأمر.\nمثال: `!memory add الاجتماع كل تلات الساعة ٩`"
+          );
+        }
+        if (scope === "global" && !privileged) return denied();
+
+        const entry = memory.addMemory({
+          scope,
+          chatId,
+          content,
+          by: msg.pushName || senderId,
+          chatName: groupMetadata?.subject || null,
+        });
+
+        return reply(
+          `🧠 اتحفظت في *${scope === "global" ? "الذاكرة العامة" : "ذاكرة الشات"}*.\n` +
+            `\`${entry.id}\` — ${content.length > 80 ? content.slice(0, 80) + "…" : content}`
+        );
+      }
+
+      // ------------------------------------------------------------- search
+      if (["search", "find", "بحث", "دور"].includes(action)) {
+        const query = rest.join(" ").trim();
+        if (!query) return reply("اكتب الكلمة اللي بتدور عليها.");
+        const chatHits = memory.searchMemory(query, { scope: "chat", chatId });
+        const globalHits = memory.searchMemory(query, { scope: "global" });
+
+        if (!chatHits.length && !globalHits.length) {
+          return reply(`🔍 مفيش حاجة متسجلة عن "${query}".`);
+        }
+        return reply(
+          `🔍 *نتايج البحث عن* "${query}"\n\n` +
+            `*ذاكرة الشات (${chatHits.length}):*\n${formatEntries(chatHits, { limit: 10 })}\n\n` +
+            `*الذاكرة العامة (${globalHits.length}):*\n${formatEntries(globalHits, { limit: 10 })}`
+        );
+      }
+
+      // ------------------------------------------------------------- forget
+      if (["forget", "del", "delete", "remove", "امسح", "انسى"].includes(action)) {
+        if (!privileged) return denied();
+        const ref = rest.join(" ").trim();
+        if (!ref) {
+          return reply(
+            "حدد اللي عايز تمسحه: رقمه من `!memory` أو جزء من نصه.\n" +
+              "مثال: `!memory forget 3`"
+          );
+        }
+        const removed = memory.removeMemory({ scope, chatId, ref });
+        return reply(
+          removed
+            ? `🗑️ اتمسحت: ${removed.content.slice(0, 120)}`
+            : `مالقيتش حاجة تطابق "${ref}" في ${
+                scope === "global" ? "الذاكرة العامة" : "ذاكرة الشات"
+              }.`
+        );
+      }
+
+      // -------------------------------------------------------------- clear
+      if (["clear", "reset", "wipe", "تصفير"].includes(action)) {
+        if (!privileged) return denied();
+        const count = memory.clearMemory({ scope, chatId });
+        return reply(
+          count
+            ? `🧹 اتمسحت *${count}* معلومة من ${
+                scope === "global" ? "الذاكرة العامة" : "ذاكرة الشات"
+              }.`
+            : "الذاكرة كانت فاضية أصلاً."
+        );
+      }
+
+      // --------------------------------------------------------------- file
+      if (["file", "export", "md", "ملف"].includes(action)) {
+        if (!privileged) return denied();
+        const filePath = memory.memoryFilePath(scope, chatId);
+        if (!fs.existsSync(filePath)) {
+          return reply("مفيش ملف ذاكرة لسه — ابدأ بـ `!memory add ...`.");
+        }
+        return sendBotMessage(
+          sock,
+          chatId,
+          {
+            document: fs.readFileSync(filePath),
+            mimetype: "text/markdown",
+            fileName: scope === "global" ? "global.md" : `${chatId}.md`,
+            caption: `🧠 ملف ${
+              scope === "global" ? "الذاكرة العامة" : "ذاكرة الشات"
+            }`,
+          },
+          { replyTo: msg }
+        );
+      }
+
+      // --------------------------------------------------------------- list
+      const stats = memory.memoryStats(chatId);
+      const target = scope === "global" ? "global" : "chat";
+      const entries = memory.listMemory({ scope: target, chatId });
+
+      return reply(
+        `🧠 *${target === "global" ? "الذاكرة العامة" : "ذاكرة المحادثة دي"}* ` +
+          `(${entries.length} معلومة)\n\n` +
+          `${formatEntries(entries)}\n\n` +
+          `_الشات: ${stats.chatCount} · العام: ${stats.globalCount}_\n` +
+          "`!memory add <معلومة>` · `!memory add global <معلومة>` · `!memory forget <رقم>` · `!memory file`"
+      );
+    } catch (error) {
+      logger.error({ err: error }, "[memory] command failed");
+      return reply(
+        `❌ *مشكلة في الذاكرة*\n\n*التفاصيل:* ${error.message || error}`
+      );
+    }
+  },
+};