levix-bot 2.1.1 → 2.2.0

package/public/dashboard.js

@@ -89,11 +89,14 @@
   function applyTheme(theme) {
     document.documentElement.setAttribute("data-theme", theme);
     const button = $("#theme-btn");
-    button.textContent = theme === "light" ? "☾" : "☀";
     button.setAttribute(
       "aria-label",
       theme === "light" ? "Switch to dark theme" : "Switch to light theme"
     );
+    button.setAttribute(
+      "title",
+      theme === "light" ? "Switch to dark theme" : "Switch to light theme"
+    );
     try {
       localStorage.setItem(THEME_KEY, theme);
     } catch {
@@ -140,9 +143,12 @@
     $$(".view").forEach((view) =>
       view.classList.toggle("active", view.id === `view-${target}`)
     );
-    $$(".nav a").forEach((link) =>
-      link.classList.toggle("active", link.dataset.view === target)
-    );
+    $$(".nav a").forEach((link) => {
+      const active = link.dataset.view === target;
+      link.classList.toggle("active", active);
+      if (active) link.setAttribute("aria-current", "page");
+      else link.removeAttribute("aria-current");
+    });
     $("#page-title").textContent = VIEWS[target].title;
     setSidebar(false);
 
@@ -227,20 +233,24 @@
     setStatus(stats.connection);
 
     const cards = [
-      ["Groups", stats.totalGroups],
-      ["Commands", stats.commandCount],
-      ["Open debts", stats.totalDebts],
-      ["Warnings", stats.totalWarnings],
-      ["Notes", stats.totalNotes],
-      ["Todo lists", stats.totalTodos],
+      ["Groups", stats.totalGroups, "Communities", '<svg viewBox="0 0 24 24"><circle cx="9" cy="8" r="3"/><circle cx="17" cy="9" r="2.5"/><path d="M3 19a6 6 0 0 1 12 0M15 19a5 5 0 0 1 6-4"/></svg>'],
+      ["Commands", stats.commandCount, "Available", '<svg viewBox="0 0 24 24"><path d="m5 7 5 5-5 5M12 17h7"/></svg>'],
+      ["Open debts", stats.totalDebts, "Unsettled", '<svg viewBox="0 0 24 24"><path d="M6 3h12v18l-3-2-3 2-3-2-3 2zM9 8h6M9 12h6"/></svg>'],
+      ["Warnings", stats.totalWarnings, "Issued", '<svg viewBox="0 0 24 24"><path d="M12 4 3 20h18zM12 9v5M12 17h.01"/></svg>'],
+      ["Notes", stats.totalNotes, "Saved", '<svg viewBox="0 0 24 24"><path d="M5 3h14v18H5zM8 8h8M8 12h8M8 16h5"/></svg>'],
+      ["Todo lists", stats.totalTodos, "Tracked", '<svg viewBox="0 0 24 24"><path d="m5 7 2 2 4-4M13 7h6M5 14l2 2 4-4M13 14h6"/></svg>'],
     ];
 
     $("#stat-cards").innerHTML = cards
       .map(
-        ([label, value]) => `
+        ([label, value, caption, icon]) => `
         <div class="stat">
-          <div class="label">${esc(label)}</div>
+          <div class="stat-top">
+            <span class="stat-icon" aria-hidden="true">${icon}</span>
+            <span class="label">${esc(label)}</span>
+          </div>
           <div class="value">${esc(value ?? 0)}</div>
+          <div class="stat-foot"><span>${esc(caption)}</span><i aria-hidden="true"></i></div>
         </div>`
       )
       .join("");
@@ -258,9 +268,9 @@
     $("#overview-info").innerHTML = rows
       .map(
         ([label, value]) => `
-        <div>
-          <div class="label" style="font-size:.72rem;letter-spacing:.09em;text-transform:uppercase;color:var(--faint)">${esc(label)}</div>
-          <div style="font-weight:600;margin-top:2px">${esc(value)}</div>
+        <div class="runtime-item">
+          <div class="runtime-label">${esc(label)}</div>
+          <div class="runtime-value">${esc(value)}</div>
         </div>`
       )
       .join("");
@@ -597,7 +607,7 @@
         ? scopes
             .map(
               (entry) => `
-          <button class="btn btn-sm" data-scope="${esc(entry.scope)}">
+          <button class="btn btn-sm" type="button" data-scope="${esc(entry.scope)}">
             ${entry.scope === "global" ? "🌍" : "💬"} ${esc(entry.label)}
             <span class="hint">${esc(entry.entries)} entries</span>
           </button>`
@@ -795,7 +805,7 @@
           </div>
 
           <div style="grid-column:1/-1">
-            <button class="btn btn-primary" data-save-group="${id}">Save this group</button>
+            <button class="btn btn-primary" type="button" data-save-group="${id}">Save this group</button>
             <span class="hint" style="margin-left:8px">Blacklisted: ${group.blacklist.length}</span>
           </div>
         </div>
@@ -872,6 +882,42 @@
 
   // --- data tables --------------------------------------------------------
 
+  function scheduleState(job) {
+    const lifecycleClass =
+      job.status === "active" || job.status === "pending"
+        ? " ok"
+        : job.status === "failed" || job.status === "invalid"
+        ? " danger"
+        : "";
+    const detail = job.lastRunAt
+      ? `<span class="schedule-detail">Last attempt ${esc(timeAgo(job.lastRunAt))}</span>`
+      : '<span class="schedule-detail">Not run yet</span>';
+    const delivery = job.lastDeliveryStatus
+      ? `<span class="tag${job.lastDeliveryStatus === "sent" ? " ok" : " danger"}">Last: ${esc(job.lastDeliveryStatus)}</span>`
+      : "";
+    const error = job.lastError
+      ? `<span class="schedule-error" title="${esc(job.lastError)}">${esc(job.lastError)}</span>`
+      : "";
+
+    return `<div class="schedule-state">
+      <span class="tag${lifecycleClass}">${esc(job.status)}</span>
+      ${delivery}${detail}${error}
+    </div>`;
+  }
+
+  function scheduleActions(job) {
+    const retryable =
+      job.status === "failed" || job.lastDeliveryStatus === "failed";
+    return `<div class="table-actions">
+      ${
+        retryable
+          ? `<button class="btn btn-sm" type="button" data-retry-schedule="${esc(job.id)}">Retry now</button>`
+          : ""
+      }
+      <button class="btn btn-sm btn-danger" type="button" data-drop-schedule="${esc(job.id)}">Delete</button>
+    </div>`;
+  }
+
   const TABLES = {
     debts: {
       endpoint: "/debts",
@@ -929,15 +975,13 @@
     schedules: {
       endpoint: "/schedules",
       key: "schedules",
-      columns: ["Target", "When", "Message", "Status", ""],
+      columns: ["Target", "Schedule", "Message", "Delivery", "Actions"],
       row: (job) => [
         `<code>${esc(shortJid(job.targetJid))}</code>`,
-        job.type === "recurring"
-          ? `<code>${esc(job.cronString || "—")}</code>`
-          : esc(new Date(job.date).toLocaleString()),
+        `<span class="wrap">${esc(job.when || job.cronString || "—")}</span>`,
         `<span class="wrap">${esc(String(job.message ?? "").slice(0, 120))}</span>`,
-        `<span class="tag${job.status === "active" || job.status === "pending" ? " ok" : ""}">${esc(job.status)}</span>`,
-        `<button class="btn btn-sm btn-danger" data-drop-schedule="${esc(job.id)}">Delete</button>`,
+        scheduleState(job),
+        scheduleActions(job),
       ],
     },
     users: {
@@ -983,6 +1027,24 @@
 
   function initDataActions() {
     $("#data-table").addEventListener("click", (event) => {
+      const retryButton = event.target.closest("[data-retry-schedule]");
+      if (retryButton) {
+        guard(async () => {
+          retryButton.disabled = true;
+          retryButton.textContent = "Retrying…";
+          try {
+            await api(
+              `/schedules/${encodeURIComponent(retryButton.dataset.retrySchedule)}/retry`,
+              { method: "POST" }
+            );
+            toast("Scheduled message sent", "ok");
+          } finally {
+            await loadTable();
+          }
+        })();
+        return;
+      }
+
       const button = event.target.closest("[data-drop-schedule]");
       if (!button) return;
       guard(async () => {
@@ -998,9 +1060,11 @@
       const button = event.target.closest("[data-table]");
       if (!button) return;
       dataTab = button.dataset.table;
-      $$("#data-tabs .btn").forEach((tab) =>
-        tab.classList.toggle("btn-primary", tab.dataset.table === dataTab)
-      );
+      $$("#data-tabs .btn").forEach((tab) => {
+        const active = tab.dataset.table === dataTab;
+        tab.classList.toggle("btn-primary", active);
+        tab.setAttribute("aria-selected", String(active));
+      });
       loadTable();
     });
   }
@@ -1018,7 +1082,7 @@
         <td><code>${esc(user.phone || shortJid(user.jid))}</code></td>
         <td>${esc(user.displayName || "—")}</td>
         <td>
-          <button class="btn btn-sm btn-danger" data-revoke="${esc(user.phone || shortJid(user.jid))}"
+          <button class="btn btn-sm btn-danger" type="button" data-revoke="${esc(user.phone || shortJid(user.jid))}"
                   data-role="${esc(role)}">Revoke</button>
         </td>
       </tr>`
@@ -1084,8 +1148,8 @@
         <div class="inline">
           <input type="password" id="${id}" placeholder="${setting.configured ? "•••••••• (set)" : "not set"}"
                  autocomplete="new-password"${setting.configured ? ' data-configured="1"' : ""} />
-          <button class="btn btn-sm" data-save-setting="${esc(setting.key)}">Save</button>
-          ${setting.configured ? `<button class="btn btn-sm btn-danger" data-clear-setting="${esc(setting.key)}">Clear</button>` : ""}
+          <button class="btn btn-sm" type="button" data-save-setting="${esc(setting.key)}">Save</button>
+          ${setting.configured ? `<button class="btn btn-sm btn-danger" type="button" data-clear-setting="${esc(setting.key)}">Clear</button>` : ""}
         </div>`;
     } else if (setting.type === "bool") {
       control = `
@@ -1094,7 +1158,7 @@
             <input type="checkbox" id="${id}" ${setting.value ? "checked" : ""} />
             <span class="track"></span>
           </label>
-          <button class="btn btn-sm" data-save-setting="${esc(setting.key)}">Save</button>
+          <button class="btn btn-sm" type="button" data-save-setting="${esc(setting.key)}">Save</button>
         </div>`;
     } else if (Array.isArray(setting.choices) && setting.choices.length) {
       control = `
@@ -1107,7 +1171,7 @@
               )
               .join("")}
           </select>
-          <button class="btn btn-sm" data-save-setting="${esc(setting.key)}">Save</button>
+          <button class="btn btn-sm" type="button" data-save-setting="${esc(setting.key)}">Save</button>
         </div>`;
     } else {
       control = `
@@ -1116,18 +1180,18 @@
                  value="${esc(setting.value)}"
                  ${setting.min !== null ? `min="${setting.min}"` : ""}
                  ${setting.max !== null ? `max="${setting.max}"` : ""} />
-          <button class="btn btn-sm" data-save-setting="${esc(setting.key)}">Save</button>
+          <button class="btn btn-sm" type="button" data-save-setting="${esc(setting.key)}">Save</button>
         </div>`;
     }
 
     return `
-      <div style="margin-bottom:18px">
-        <div class="inline" style="margin-bottom:5px">
-          <label for="${id}" style="font-size:.86rem;font-weight:550">${esc(setting.label)}</label>
+      <div class="setting-item">
+        <div class="inline setting-label-row">
+          <label for="${id}" class="setting-label">${esc(setting.label)}</label>
           ${source}${restart}
         </div>
         ${control}
-        ${setting.hint ? `<div class="hint" style="margin-top:5px">${esc(setting.hint)}</div>` : ""}
+        ${setting.hint ? `<div class="hint setting-hint">${esc(setting.hint)}</div>` : ""}
       </div>`;
   }
 

package/scheduler.cjs

@@ -30,6 +30,7 @@ function saveScheduledJob(job) {
 }
 
 const runningTasks = new Map();
+const deliveriesInFlight = new Set();
 let cleanupScheduled = false;
 
 function trimMediaDirectory() {
@@ -128,24 +129,70 @@ function stopTask(jobId) {
   runningTasks.delete(jobId);
 }
 
-function scheduleNewJob(sock, job) {
-  stopTask(job.id);
+function deliveryErrorMessage(error) {
+  const message = error instanceof Error ? error.message : String(error ?? "Unknown error");
+  return message.replace(/\s+/g, " ").trim().slice(0, 240) || "Unknown error";
+}
+
+function recordDelivery(jobId, status, runAt, error = null) {
+  try {
+    storage.setScheduleDelivery(jobId, status, runAt, error);
+  } catch (stateError) {
+    logger.error(
+      { err: stateError, jobId },
+      "[Scheduler] failed to record scheduled delivery state"
+    );
+  }
+}
+
+async function deliverScheduledJob(sock, job) {
+  if (deliveriesInFlight.has(job.id)) {
+    logger.warn(`[Scheduler] Job ${job.id} is already being delivered — skipping overlap`);
+    return { ok: false, reason: "in_flight", skipped: true };
+  }
+
+  deliveriesInFlight.add(job.id);
+  const runAt = Date.now();
+
+  try {
+    await sock.sendMessage(job.targetJid, {
+      text: `*رسالة مجدولة 🗓️*\n\n${job.message}`,
+    });
+    recordDelivery(job.id, "sent", runAt);
+    logger.info(`[Scheduler] Executed job ${job.id} -> ${job.targetJid}`);
+    return { ok: true, reason: "sent" };
+  } catch (error) {
+    const message = deliveryErrorMessage(error);
+    recordDelivery(job.id, "failed", runAt, message);
+    logger.error(
+      { err: error, jobId: job.id },
+      "[Scheduler] failed to send scheduled message"
+    );
+    return { ok: false, reason: "delivery_failed", error: message };
+  } finally {
+    deliveriesInFlight.delete(job.id);
+  }
+}
+
+async function executeScheduledJob(sock, job) {
+  const result = await deliverScheduledJob(sock, job);
 
-  const send = async () => {
+  if (job.type !== "recurring" && !result.skipped) {
     try {
-      await sock.sendMessage(job.targetJid, {
-        text: `*رسالة مجدولة 🗓️*\n\n${job.message}`,
-      });
-      logger.info(`[Scheduler] Executed job ${job.id} -> ${job.targetJid}`);
-    } catch (err) {
-      // مفيش حد ماسك الـ promise دي: من غير الـ catch الرفض بيطلع
-      // unhandledRejection ويوقّف البوت.
+      updateJobStatus(job.id, result.ok ? "sent" : "failed");
+    } catch (error) {
       logger.error(
-        { err, jobId: job.id },
-        "[Scheduler] failed to send scheduled message"
+        { err: error, jobId: job.id },
+        "[Scheduler] failed to record one-off schedule status"
       );
     }
-  };
+  }
+
+  return result;
+}
+
+function scheduleNewJob(sock, job) {
+  stopTask(job.id);
 
   if (job.type === "recurring") {
     if (!job.cronString || !cron.validate(job.cronString)) {
@@ -158,7 +205,9 @@ function scheduleNewJob(sock, job) {
 
     runningTasks.set(
       job.id,
-      cron.schedule(job.cronString, send, { timezone: settings.get("bot_timezone") })
+      cron.schedule(job.cronString, () => executeScheduledJob(sock, job), {
+        timezone: settings.get("bot_timezone"),
+      })
     );
   } else {
     const when = new Date(job.date).getTime();
@@ -179,9 +228,11 @@ function scheduleNewJob(sock, job) {
     runningTasks.set(
       job.id,
       scheduleAt(when, async () => {
-        await send();
-        updateJobStatus(job.id, "sent");
-        runningTasks.delete(job.id);
+        try {
+          await executeScheduledJob(sock, job);
+        } finally {
+          runningTasks.delete(job.id);
+        }
       })
     );
   }
@@ -190,6 +241,21 @@ function scheduleNewJob(sock, job) {
   return true;
 }
 
+async function retryScheduledJob(sock, jobId) {
+  const job = storage.getSchedule(jobId);
+  if (!job) return { ok: false, reason: "not_found" };
+
+  const retryable =
+    job.status === "failed" ||
+    (job.type === "recurring" &&
+      job.status === "active" &&
+      job.lastDeliveryStatus === "failed");
+  if (!retryable) return { ok: false, reason: "not_failed", job };
+
+  const result = await executeScheduledJob(sock, job);
+  return { ...result, job: storage.getSchedule(jobId) };
+}
+
 function deleteScheduledJob(jobId) {
   stopTask(jobId);
   storage.deleteSchedule(jobId);
@@ -205,6 +271,7 @@ module.exports = {
   initializeScheduledJobs,
   stopAllScheduledJobs,
   scheduleNewJob,
+  retryScheduledJob,
   getScheduledJobs,
   saveScheduledJob,
   deleteScheduledJob,

package/src/bootstrap/core.js

@@ -5,17 +5,21 @@
 // entirely optional. `levix headless` runs this file and nothing else, which is
 // what makes "no panel port is opened" a fact rather than a promise.
 //
-// Note what this does NOT do: it does not dial WhatsApp. It builds the session
-// manager and hands it back. Panel mode leaves it idle until somebody presses
-// Start on the Connection screen; headless has nobody to press anything, so it
-// asks for `autoStart`. That is the whole of the difference between the two
-// modes — there is no `if (headless)` anywhere below this line.
+// A brand-new panel install stays idle until somebody presses Start on the
+// Connection screen, so it does not generate pairing attempts nobody asked
+// for. Once the install has been paired, process restarts resume that saved
+// session automatically. Headless has no Start button, so it asks for
+// `autoStart` and starts even when pairing is still required.
 
 import { createRequire } from "module";
 import { WhatsAppSession } from "../core/session.js";
 import { loadCommands, getLoadedCommands } from "../handlers/command.handler.js";
 import { initStore } from "../db/store.esm.js";
 import { deleteQrCode } from "../utils/storage.esm.js";
+import {
+  hasPairedCredentials,
+  sessionStartupPolicy,
+} from "./session-startup-policy.js";
 
 const require = createRequire(import.meta.url);
 const logger = require("../utils/logger.cjs");
@@ -29,8 +33,9 @@ const { initializeScheduledJobs, stopAllScheduledJobs } = require("../../schedul
  * Start the bot.
  *
  * @param {object} [options]
- * @param {boolean} [options.autoStart] - connect to WhatsApp straight away.
- *   Headless does; the panel waits to be asked.
+ * @param {boolean} [options.autoStart] - force a WhatsApp start even when the
+ *   install is not paired yet. Headless uses this; panel mode resumes only an
+ *   already-paired session.
  * @returns {Promise<{ session: object, commandCount: number, wasPaired: boolean }>}
  */
 export async function bootstrapCore({ autoStart = false } = {}) {
@@ -43,9 +48,9 @@ export async function bootstrapCore({ autoStart = false } = {}) {
   // bot's state, not next to the code.
   ensureDataDir("media");
 
-  // Whether this install has ever been paired decides what the terminal says
-  // next, so read it before the socket has a chance to create credentials.
-  const wasPaired = store.hasCredentials();
+  // A `creds` row alone is not enough: Baileys creates one before pairing.
+  // `me.id` is the durable proof that this install was actually linked.
+  const wasPaired = hasPairedCredentials(store.authRead("creds"));
 
   await initStore();
   await loadCommands();
@@ -64,7 +69,8 @@ export async function bootstrapCore({ autoStart = false } = {}) {
     log: logger,
   });
 
-  if (autoStart) await session.start({ reason: "autostart" });
+  const startup = sessionStartupPolicy({ autoStart, wasPaired });
+  if (startup.start) await session.start({ reason: startup.reason });
 
   return {
     session,

package/src/bootstrap/session-startup-policy.js

@@ -0,0 +1,23 @@
+// Decide whether the WhatsApp session should be started during process boot.
+//
+// Baileys writes a `creds` row as soon as auth state is initialized, even before
+// a QR is successfully paired. Only `creds.me.id` proves that this installation
+// was actually linked to a WhatsApp account.
+export function hasPairedCredentials(rawCreds) {
+  if (!rawCreds) return false;
+  try {
+    const creds = typeof rawCreds === "string" ? JSON.parse(rawCreds) : rawCreds;
+    return Boolean(creds?.me?.id);
+  } catch {
+    return false;
+  }
+}
+
+// Panel mode must not create a fresh pairing attempt on a brand-new install,
+// but once a real pairing exists a process restart should restore that session
+// automatically. Headless has no Start button, so it always forces a start.
+export function sessionStartupPolicy({ autoStart = false, wasPaired = false } = {}) {
+  if (autoStart) return { start: true, reason: "autostart" };
+  if (wasPaired) return { start: true, reason: "resume-paired" };
+  return { start: false, reason: null };
+}

package/src/commands/autoschedule.cjs

@@ -4,6 +4,7 @@ const {
 } = require("../../scheduler.cjs");
 const { randomUUID } = require("node:crypto");
 const { defaultTimezone } = require("../utils/datetime.cjs");
+const { parseRecurringArgs } = require("../utils/recurrence.cjs");
 
 module.exports = {
   name: "autoschedule",
@@ -14,54 +15,27 @@ module.exports = {
   async execute(sock, msg, args) {
     const creatorJid = msg.key.participant || msg.key.remoteJid;
     const targetJid = msg.key.remoteJid;
-
-    const type = args[0]?.toLowerCase();
-    const time = args[1];
-    const message = args.slice(2).join(" ");
-
-    if (!type || !time || !message) {
-      return await sock.sendMessage(creatorJid, {
-        text: "الصيغة غير صحيحة. استخدم:\n`!autoschedule daily HH:mm رسالتك`\n`!autoschedule weekly day HH:mm رسالتك`",
-      });
-    }
-
-    // من غير الفحص ده أي كتابة غلط ("abc:xyz") بتتحوّل لكرون باظ يتخزّن في
-    // الملف، وبعدين كل تشغيل للبوت بيقع وهو بيحاول يجدوله.
-    const timeMatch = /^(\d{1,2}):(\d{2})$/.exec(String(time).trim());
-    const hour = timeMatch && Number(timeMatch[1]);
-    const minute = timeMatch && Number(timeMatch[2]);
-
-    if (!timeMatch || hour > 23 || minute > 59) {
-      return await sock.sendMessage(creatorJid, {
-        text: "الوقت غير صالح. استخدم صيغة `HH:mm` (مثال: `09:30`).",
-      });
-    }
-
-    let cronString = "";
-
-    if (type === "daily") {
-      cronString = `${minute} ${hour} * * *`;
-    } else if (type === "weekly") {
-      // This part can be enhanced later to support specific days like 'monday'
-      // For now, let's keep it simple. Example: !autoschedule weekly 1 10:30 "..." for Monday 10:30
-      const dayOfWeek = args[1];
-      const weeklyTime = args[2];
-      const weeklyMessage = args.slice(3).join(" ");
-      // ... logic to build weekly cron string ...
-      return await sock.sendMessage(creatorJid, {
-        text: "جدولة أسبوعية قيد التطوير.",
-      });
-    } else {
+    const parsed = parseRecurringArgs(args);
+
+    if (parsed.error) {
+      const errors = {
+        usage:
+          "الصيغة غير صحيحة. استخدم:\n`!autoschedule daily HH:mm رسالتك`\n`!autoschedule weekly day HH:mm رسالتك`",
+        type: "النوع غير مدعوم. استخدم: `daily` أو `weekly`.",
+        day: "اليوم غير صالح. استخدم اسم اليوم بالعربية أو الإنجليزية، أو رقمًا من 0 إلى 7 (0 و7 للأحد).",
+        time: "الوقت غير صالح. استخدم صيغة `HH:mm` (مثال: `09:30`).",
+        message: "اكتب الرسالة التي تريد جدولتها بعد الوقت.",
+      };
       return await sock.sendMessage(creatorJid, {
-        text: "النوع غير مدعوم. استخدم: `daily`",
+        text: errors[parsed.error],
       });
     }
 
     const newJob = {
       id: randomUUID(),
       type: "recurring",
-      cronString: cronString,
-      message: message,
+      cronString: parsed.cronString,
+      message: parsed.message,
       targetJid: targetJid,
       creatorJid: creatorJid,
       status: "active",
@@ -77,7 +51,10 @@ module.exports = {
     saveScheduledJob(newJob);
 
     await sock.sendMessage(creatorJid, {
-      text: `✅ تم جدولة رسالة يومية بنجاح في الساعة ${time} (${defaultTimezone()})`,
+      text:
+        parsed.type === "weekly"
+          ? `✅ تم جدولة الرسالة أسبوعيًا يوم ${args[1]} الساعة ${parsed.time} (${defaultTimezone()})`
+          : `✅ تم جدولة الرسالة يوميًا الساعة ${parsed.time} (${defaultTimezone()})`,
     });
   },
 };

package/src/config/ai-identity.cjs

@@ -16,9 +16,10 @@
 // be able to change what the product is called or who wrote it, and should not
 // have to look at product metadata to edit their own prompt.
 //
-// This is an open-source project. Nothing here is obfuscated and nothing here
-// is a secret — the point is that it is code-owned rather than
-// operator-configurable, and that it is not reachable from the panel.
+// This is an open-source project. Nothing here is obfuscated or secret. Public
+// credit facts also live in brand.cjs so the footer can render them; the full
+// identity object and its instruction block remain code-owned rather than
+// operator-configurable, and are not reachable from the panel.
 
 const IDENTITY = Object.freeze({
   product: "Levix",

package/src/config/brand.cjs

@@ -16,9 +16,12 @@ const BRAND = Object.freeze({
   tagline: "Personal WhatsApp Bot",
   taglineAr: "بوت واتساب شخصي",
 
+  copyrightYear: 2026,
   developer: "Abdelrhman Diab",
   developerAr: "عبدالرحمن دياب",
+  developerSite: "https://abdelrhman.leviro.net",
   studio: "Leviro",
+  studioSite: "https://leviro.net",
 
   repo: "https://github.com/Abdodiab2005/levix",
 });

package/src/db/db.cjs

@@ -173,6 +173,14 @@ const MIGRATIONS = [
       );
     `);
   },
+  // v2 — delivery history for truthful schedule status and manual retries.
+  (database) => {
+    database.exec(`
+      ALTER TABLE schedules ADD COLUMN last_run_at INTEGER;
+      ALTER TABLE schedules ADD COLUMN last_delivery_status TEXT;
+      ALTER TABLE schedules ADD COLUMN last_error TEXT;
+    `);
+  },
 ];
 
 function migrate(database, migrations = MIGRATIONS) {