peakurl 1.0.3 → 1.1.1

package/bin/peakurl.js

@@ -4,14 +4,6 @@
 import { readFile as readFile3 } from "fs/promises";
 import { Command, CommanderError, InvalidArgumentError } from "commander";
 
-// src/commands/core.ts
-import { cwd } from "process";
-
-// src/config/store.ts
-import { chmod, mkdir, readFile, unlink, writeFile } from "fs/promises";
-import { dirname, join } from "path";
-import envPaths from "env-paths";
-
 // src/lib/errors.ts
 var CliError = class extends Error {
   exitCode;
@@ -27,13 +19,682 @@ function ensureCliError(error) {
   if (error instanceof CliError) {
     return error;
   }
-  if (error instanceof Error) {
-    return new CliError(error.message, 1, { cause: error });
+  if (error instanceof Error) {
+    return new CliError(error.message, 1, { cause: error });
+  }
+  return new CliError("Unexpected error.");
+}
+
+// src/lib/url.ts
+function validateHttpUrl(parsed, label) {
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new CliError(`${label} must use http or https.`);
+  }
+  if (parsed.username || parsed.password) {
+    throw new CliError(`${label} must not include embedded credentials.`);
+  }
+}
+function getApiBaseUrl(value) {
+  const input = value.trim();
+  if (!input) {
+    throw new CliError("A PeakURL API base URL is required.");
+  }
+  let parsed;
+  try {
+    parsed = new URL(input);
+  } catch {
+    throw new CliError(`Invalid API base URL: ${value}`);
+  }
+  validateHttpUrl(parsed, "PeakURL API base URL");
+  parsed.hash = "";
+  parsed.search = "";
+  const pathname = parsed.pathname.replace(/\/+$/, "");
+  if (!/\/api\/v1$/i.test(pathname)) {
+    throw new CliError("PeakURL API base URL must end with /api/v1.");
+  }
+  return `${parsed.origin}${pathname}`;
+}
+function buildApiUrl(apiBaseUrl, path, query) {
+  const cleanBaseUrl = getApiBaseUrl(apiBaseUrl);
+  const cleanPath = path.replace(/^\/+/, "");
+  const url = new URL(cleanPath, `${cleanBaseUrl}/`);
+  for (const [key, value] of Object.entries(query ?? {})) {
+    if (value === void 0 || value === "") {
+      continue;
+    }
+    url.searchParams.set(key, String(value));
+  }
+  return url.toString();
+}
+function normalizeDestinationUrl(value) {
+  const input = value.trim();
+  if (!input) {
+    throw new CliError("A destination URL is required.");
+  }
+  try {
+    const parsed = new URL(input);
+    validateHttpUrl(parsed, "Destination URL");
+    return parsed.toString();
+  } catch (error) {
+    if (error instanceof CliError) {
+      throw error;
+    }
+    throw new CliError(`Invalid destination URL: ${value}`);
+  }
+}
+function normalizeWebhookUrl(value) {
+  const input = value.trim();
+  if (!input) {
+    throw new CliError("A webhook URL is required.");
+  }
+  try {
+    const parsed = new URL(input);
+    validateHttpUrl(parsed, "Webhook URL");
+    return parsed.toString();
+  } catch (error) {
+    if (error instanceof CliError) {
+      throw error;
+    }
+    throw new CliError(`Invalid webhook URL: ${value}`);
+  }
+}
+
+// src/api/client.ts
+function isApiResponse(value) {
+  return Boolean(
+    value && typeof value === "object" && "success" in value && "message" in value && "timestamp" in value
+  );
+}
+function networkError(apiBaseUrl, error) {
+  if (error instanceof Error && error.message) {
+    return `Could not reach PeakURL at ${apiBaseUrl}. ${error.message}`;
+  }
+  return `Could not reach PeakURL at ${apiBaseUrl}.`;
+}
+var ApiClient = class {
+  /**
+   * Creates a client bound to one resolved credential set.
+   *
+   * @param config Explicit API base URL plus bearer API key.
+   */
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Loads the currently authenticated user.
+   *
+   * PeakURL accepts bearer API keys on `GET /users/me`, which is also the
+   * CLI login verification flow.
+   *
+   * @returns API response envelope containing the authenticated user.
+   */
+  whoami() {
+    return this.request("GET", "users/me");
+  }
+  /**
+   * Loads the current system status snapshot for the authenticated site.
+   *
+   * @returns API response envelope containing system status sections.
+   */
+  getStatus() {
+    return this.request("GET", "system/status");
+  }
+  /**
+   * Creates a short URL.
+   *
+   * @param payload Request body accepted by `POST /api/v1/urls`.
+   * @returns API response envelope containing the created link.
+   */
+  createUrl(payload) {
+    return this.request("POST", "urls", payload);
+  }
+  /**
+   * Lists short URLs with optional pagination and filtering.
+   *
+   * The current PeakURL app returns `{ items, meta }` under `data`, but the
+   * CLI keeps a slightly broader compatibility type for future-proofing.
+   *
+   * @param query Optional query-string values.
+   * @returns API response envelope containing list data.
+   */
+  listUrls(query) {
+    return this.request("GET", "urls", void 0, query);
+  }
+  /**
+   * Exports the full accessible link dataset for the authenticated user.
+   *
+   * @param query Optional search and sort values.
+   * @returns API response envelope containing the full export payload.
+   */
+  exportUrls(query) {
+    return this.request(
+      "GET",
+      "urls/export",
+      void 0,
+      query
+    );
+  }
+  /**
+   * Imports multiple short links in one bulk request.
+   *
+   * @param payload Request body accepted by `POST /api/v1/urls/bulk`.
+   * @returns API response envelope containing created rows plus row errors.
+   */
+  importUrls(payload) {
+    return this.request("POST", "urls/bulk", payload);
+  }
+  /**
+   * Loads a single short URL by identifier or alias.
+   *
+   * PeakURL resolves IDs, short codes, and aliases through the same route.
+   *
+   * @param idOrAlias Link identifier, short code, or alias.
+   * @returns API response envelope containing the resolved link.
+   */
+  getUrl(idOrAlias) {
+    return this.request(
+      "GET",
+      `urls/${encodeURIComponent(idOrAlias)}`
+    );
+  }
+  /**
+   * Deletes a short URL by its stable row ID.
+   *
+   * The current PeakURL backend delete route expects the row ID. The CLI can
+   * still accept an alias at the command layer by resolving it first.
+   *
+   * @param id Stable link row ID.
+   * @returns API response envelope containing the deletion result.
+   */
+  deleteUrl(id) {
+    return this.request(
+      "DELETE",
+      `urls/${encodeURIComponent(id)}`
+    );
+  }
+  /**
+   * Deletes multiple short URLs in a single bulk operation.
+   *
+   * @param ids Array of short URL IDs to delete.
+   * @returns API response envelope with deleted count.
+   */
+  deleteUrlsBulk(ids) {
+    return this.request("DELETE", "urls/bulk", { ids });
+  }
+  /**
+   * Deletes all accessible short URLs for the authenticated user.
+   *
+   * @returns API response envelope with deleted count.
+   */
+  clearUrls() {
+    return this.request("DELETE", "urls");
+  }
+  /**
+   * Empties all short links currently in trash.
+   *
+   * @returns API response envelope with deleted count.
+   */
+  emptyTrash() {
+    return this.request("DELETE", "urls/trash");
+  }
+  /**
+   * Lists audit log activity entries.
+   *
+   * @param query Optional query-string parameters for pagination or filters.
+   * @returns API response envelope containing activity items and meta.
+   */
+  listActivity(query) {
+    return this.request(
+      "GET",
+      "analytics/activity",
+      void 0,
+      query
+    );
+  }
+  /**
+   * Deletes a single audit log activity entry by its row ID.
+   *
+   * @param id Audit log row ID.
+   * @returns API response envelope confirming deletion.
+   */
+  deleteActivity(id) {
+    return this.request(
+      "DELETE",
+      `analytics/activity/${encodeURIComponent(id)}`
+    );
+  }
+  /**
+   * Deletes multiple audit log activity entries in bulk.
+   *
+   * @param ids Array of audit log row IDs.
+   * @returns API response envelope with deleted count.
+   */
+  deleteActivityBulk(ids) {
+    return this.request(
+      "DELETE",
+      "analytics/activity/bulk",
+      { ids }
+    );
+  }
+  /**
+   * Clears all audit log activity records.
+   *
+   * @returns API response envelope confirming all logs were deleted.
+   */
+  clearActivity() {
+    return this.request("DELETE", "analytics/activity");
+  }
+  /**
+   * Lists outbound webhooks for the authenticated user.
+   *
+   * @returns API response envelope containing webhook rows.
+   */
+  listWebhooks() {
+    return this.request("GET", "webhooks");
+  }
+  /**
+   * Creates one outbound webhook subscription.
+   *
+   * @param payload Request body accepted by `POST /api/v1/webhooks`.
+   * @returns API response envelope containing the created webhook.
+   */
+  createWebhook(payload) {
+    return this.request("POST", "webhooks", payload);
+  }
+  /**
+   * Deletes one webhook by its stable row ID.
+   *
+   * @param id Webhook identifier returned by the list/create endpoints.
+   * @returns API response envelope containing the deletion result.
+   */
+  deleteWebhook(id) {
+    return this.request(
+      "DELETE",
+      `webhooks/${encodeURIComponent(id)}`
+    );
+  }
+  /**
+   * Loads the current status of the cron scheduler.
+   *
+   * @returns API response envelope containing the scheduler status.
+   */
+  getJobStatus() {
+    return this.request("GET", "system/cron");
+  }
+  /**
+   * Triggers all due cron jobs to run.
+   *
+   * @returns API response envelope containing the execution results.
+   */
+  runDueJobs() {
+    return this.request("POST", "system/cron/run");
+  }
+  /**
+   * Forces a specific cron job to run immediately.
+   *
+   * @param id Job identifier.
+   * @returns API response envelope containing the execution result.
+   */
+  runJob(id) {
+    return this.request(
+      "POST",
+      `system/cron/run/${encodeURIComponent(id)}`
+    );
+  }
+  /**
+   * Clears cron execution history.
+   *
+   * @param jobId Optional job identifier to clear history only for one job.
+   * @returns API response envelope containing the deleted count.
+   */
+  clearJobHistory(jobId) {
+    return this.request(
+      "POST",
+      "system/cron/history/clear",
+      jobId ? { job_id: jobId } : void 0
+    );
+  }
+  /**
+   * Updates the schedule configuration for a cron job.
+   *
+   * @param id Job identifier.
+   * @param payload New configuration options.
+   * @returns API response envelope containing the updated job.
+   */
+  updateJobSchedule(id, payload) {
+    return this.request(
+      "PATCH",
+      `system/cron/jobs/${encodeURIComponent(id)}`,
+      payload
+    );
+  }
+  /**
+   * Resets a cron job schedule to its default configuration.
+   *
+   * @param id Job identifier.
+   * @returns API response envelope containing the restored job.
+   */
+  resetJobSchedule(id) {
+    return this.request(
+      "POST",
+      `system/cron/jobs/${encodeURIComponent(id)}/reset`
+    );
+  }
+  /**
+   * Updates the global cron settings, such as history retention.
+   *
+   * @param payload New global settings.
+   * @returns API response envelope containing the updated retention settings.
+   */
+  updateJobSettings(payload) {
+    return this.request(
+      "POST",
+      "system/cron/settings",
+      payload
+    );
+  }
+  /**
+   * Performs one authenticated API request and normalizes the response.
+   *
+   * @param method HTTP method to send.
+   * @param path Route path relative to `/api/v1`.
+   * @param body Optional JSON body.
+   * @param query Optional query-string values.
+   * @returns Parsed PeakURL response envelope.
+   * @throws {CliError} When the network request fails or the API returns an error.
+   */
+  async request(method, path, body, query) {
+    const url = buildApiUrl(this.config.apiBaseUrl, path, query);
+    let response;
+    try {
+      response = await fetch(url, {
+        method,
+        headers: {
+          Accept: "application/json",
+          Authorization: `Bearer ${this.config.apiKey}`,
+          ...body ? { "Content-Type": "application/json" } : {}
+        },
+        body: body ? JSON.stringify(body) : void 0
+      });
+    } catch (error) {
+      throw new CliError(networkError(this.config.apiBaseUrl, error), 1, {
+        cause: error instanceof Error ? error : void 0
+      });
+    }
+    const rawText = await response.text();
+    if (!rawText) {
+      if (!response.ok) {
+        throw new CliError(
+          `PeakURL request failed with HTTP ${response.status}.`
+        );
+      }
+      return {
+        success: true,
+        message: "Request completed.",
+        data: void 0,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(rawText);
+    } catch {
+      if (!response.ok) {
+        throw new CliError(
+          `PeakURL request failed with HTTP ${response.status}.`
+        );
+      }
+      throw new CliError("PeakURL returned an invalid JSON response.");
+    }
+    if (!isApiResponse(parsed)) {
+      throw new CliError(
+        "PeakURL returned an unexpected response envelope."
+      );
+    }
+    if (!response.ok || !parsed.success) {
+      const statusCode = response.status === 401 ? 2 : 1;
+      throw new CliError(
+        parsed.message || `PeakURL request failed with HTTP ${response.status}.`,
+        statusCode
+      );
+    }
+    return parsed;
+  }
+};
+
+// src/lib/output.ts
+function writeStdout(message = "") {
+  process.stdout.write(`${message}
+`);
+}
+function writeStderr(message = "") {
+  process.stderr.write(`${message}
+`);
+}
+function outputStream(target) {
+  return target === "stdout" ? process.stdout : process.stderr;
+}
+function useColor(target) {
+  return Boolean(outputStream(target).isTTY && !process.env.NO_COLOR);
+}
+function successLine(message, target = "stdout") {
+  const label = useColor(target) ? "\x1B[32mSuccess\x1B[39m" : "Success";
+  return `${label}: ${message}`;
+}
+function errorLine(message, target = "stderr") {
+  const label = useColor(target) ? "\x1B[31mError\x1B[39m" : "Error";
+  return `${label}: ${message}`;
+}
+function writeNoticeBox(title, lines, target = "stderr") {
+  const contentLines = lines.length > 0 ? lines : [""];
+  const width = Math.max(
+    title.length,
+    ...contentLines.map((line) => line.length)
+  );
+  const stream = outputStream(target);
+  const useTuiBox = stream.isTTY;
+  const border = useTuiBox ? {
+    topLeft: "\u250C",
+    topRight: "\u2510",
+    bottomLeft: "\u2514",
+    bottomRight: "\u2518",
+    horizontal: "\u2500",
+    vertical: "\u2502",
+    separatorLeft: "\u251C",
+    separatorRight: "\u2524"
+  } : {
+    topLeft: "+",
+    topRight: "+",
+    bottomLeft: "+",
+    bottomRight: "+",
+    horizontal: "-",
+    vertical: "|",
+    separatorLeft: "+",
+    separatorRight: "+"
+  };
+  const topBorder = `${border.topLeft}${border.horizontal.repeat(width + 2)}${border.topRight}`;
+  const separator = `${border.separatorLeft}${border.horizontal.repeat(width + 2)}${border.separatorRight}`;
+  const bottomBorder = `${border.bottomLeft}${border.horizontal.repeat(width + 2)}${border.bottomRight}`;
+  const writeLine = target === "stdout" ? writeStdout : writeStderr;
+  writeLine(topBorder);
+  writeLine(`${border.vertical} ${title.padEnd(width)} ${border.vertical}`);
+  writeLine(separator);
+  for (const line of contentLines) {
+    writeLine(
+      `${border.vertical} ${line.padEnd(width)} ${border.vertical}`
+    );
+  }
+  writeLine(bottomBorder);
+}
+function formatTable(headers, rows2, target = "stdout") {
+  const stream = outputStream(target);
+  const useTuiBox = stream.isTTY;
+  const border = useTuiBox ? {
+    topLeft: "\u250C",
+    topRight: "\u2510",
+    bottomLeft: "\u2514",
+    bottomRight: "\u2518",
+    horizontal: "\u2500",
+    vertical: "\u2502",
+    separatorLeft: "\u251C",
+    separatorRight: "\u2524",
+    topJunction: "\u252C",
+    middleJunction: "\u253C",
+    bottomJunction: "\u2534"
+  } : {
+    topLeft: "+",
+    topRight: "+",
+    bottomLeft: "+",
+    bottomRight: "+",
+    horizontal: "-",
+    vertical: "|",
+    separatorLeft: "+",
+    separatorRight: "+",
+    topJunction: "+",
+    middleJunction: "+",
+    bottomJunction: "+"
+  };
+  const getLines = (value) => (value ?? "").split("\n");
+  const widths = headers.map(
+    (header, index) => Math.max(
+      header.length,
+      ...rows2.flatMap(
+        (row2) => getLines(row2[index]).map((line) => line.length)
+      )
+    )
+  );
+  const formatTableBorder = (left, join3, right) => `${left}${widths.map((width) => border.horizontal.repeat(width + 2)).join(join3)}${right}`;
+  const formatTableRow = (cells) => {
+    const linesByCell = cells.map(getLines);
+    const rowHeight = Math.max(...linesByCell.map((lines) => lines.length));
+    return Array.from(
+      { length: rowHeight },
+      (_value, rowIndex) => `${border.vertical}${linesByCell.map(
+        (lines, cellIndex) => ` ${(lines[rowIndex] ?? "").padEnd(widths[cellIndex])} `
+      ).join(border.vertical)}${border.vertical}`
+    ).join("\n");
+  };
+  return [
+    formatTableBorder(border.topLeft, border.topJunction, border.topRight),
+    formatTableRow(headers),
+    formatTableBorder(
+      border.separatorLeft,
+      border.middleJunction,
+      border.separatorRight
+    ),
+    ...rows2.map(formatTableRow),
+    formatTableBorder(
+      border.bottomLeft,
+      border.bottomJunction,
+      border.bottomRight
+    )
+  ].join("\n");
+}
+function formatDetailsTable(rows2, target = "stdout") {
+  return formatTable(["Detail", "Information"], rows2, target);
+}
+function writeJson(value) {
+  writeStdout(JSON.stringify(value, null, 2));
+}
+
+// src/lib/activity.ts
+var ACTIVITY_LIST_KEYS = [
+  "items",
+  "results",
+  "activities",
+  "history"
+];
+function asObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function asString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function asNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function truncate(value, maxLength) {
+  return value.length > maxLength ? `${value.slice(0, maxLength - 1)}\u2026` : value;
+}
+function getActivityMeta(data) {
+  const record = asObject(data);
+  if (!record) {
+    return null;
+  }
+  const meta = asObject(record.meta);
+  if (meta) {
+    return {
+      page: asNumber(meta.page),
+      limit: asNumber(meta.limit),
+      totalItems: asNumber(meta.totalItems),
+      totalPages: asNumber(meta.totalPages)
+    };
+  }
+  return {
+    page: asNumber(record.page),
+    limit: asNumber(record.limit),
+    totalItems: asNumber(record.total),
+    totalPages: asNumber(record.totalPages)
+  };
+}
+function extractActivity(data) {
+  if (Array.isArray(data)) {
+    return data;
+  }
+  const record = asObject(data);
+  if (record) {
+    for (const key of ACTIVITY_LIST_KEYS) {
+      const value = record[key];
+      if (Array.isArray(value)) {
+        return value;
+      }
+    }
+  }
+  return [];
+}
+function formatActivityTable(items) {
+  if (items.length === 0) {
+    return "No activity logs found.";
+  }
+  const headers = [
+    "ID",
+    "Action",
+    "User",
+    "IP Address",
+    "Timestamp",
+    "Message"
+  ];
+  const rows2 = items.map((item) => [
+    truncate(asString(item.id) || "-", 18),
+    truncate(asString(item.type) || "-", 18),
+    truncate(
+      asString(item.userName) || asString(item.userEmail) || "-",
+      18
+    ),
+    truncate(asString(item.ipAddress) || "-", 16),
+    truncate(asString(item.createdAt) || "-", 22),
+    truncate(asString(item.message) || "-", 40)
+  ]);
+  return formatTable(headers, rows2);
+}
+function formatActivitySummary(data, count) {
+  const meta = getActivityMeta(data);
+  if (!meta) {
+    return `${count} activity record${count === 1 ? "" : "s"} returned.`;
   }
-  return new CliError("Unexpected error.");
+  const total = meta.totalItems;
+  const page = meta.page;
+  const totalPages = meta.totalPages;
+  if (total !== void 0 && page !== void 0 && totalPages !== void 0) {
+    return `Page ${page} of ${totalPages}. ${total} total activity record${total === 1 ? "" : "s"}.`;
+  }
+  return `${count} activity record${count === 1 ? "" : "s"} returned.`;
 }
 
 // src/config/store.ts
+import { chmod, mkdir, readFile, unlink, writeFile } from "fs/promises";
+import { dirname, join } from "path";
+import envPaths from "env-paths";
 var CONFIG_FILENAME = "config.json";
 var STATE_FILENAME = "state.json";
 function getConfigPath() {
@@ -186,80 +847,6 @@ var StateStore = class {
   }
 };
 
-// src/lib/url.ts
-function validateHttpUrl(parsed, label) {
-  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    throw new CliError(`${label} must use http or https.`);
-  }
-  if (parsed.username || parsed.password) {
-    throw new CliError(`${label} must not include embedded credentials.`);
-  }
-}
-function getApiBaseUrl(value) {
-  const input = value.trim();
-  if (!input) {
-    throw new CliError("A PeakURL API base URL is required.");
-  }
-  let parsed;
-  try {
-    parsed = new URL(input);
-  } catch {
-    throw new CliError(`Invalid API base URL: ${value}`);
-  }
-  validateHttpUrl(parsed, "PeakURL API base URL");
-  parsed.hash = "";
-  parsed.search = "";
-  const pathname = parsed.pathname.replace(/\/+$/, "");
-  if (!/\/api\/v1$/i.test(pathname)) {
-    throw new CliError("PeakURL API base URL must end with /api/v1.");
-  }
-  return `${parsed.origin}${pathname}`;
-}
-function buildApiUrl(apiBaseUrl, path, query) {
-  const cleanBaseUrl = getApiBaseUrl(apiBaseUrl);
-  const cleanPath = path.replace(/^\/+/, "");
-  const url = new URL(cleanPath, `${cleanBaseUrl}/`);
-  for (const [key, value] of Object.entries(query ?? {})) {
-    if (value === void 0 || value === "") {
-      continue;
-    }
-    url.searchParams.set(key, String(value));
-  }
-  return url.toString();
-}
-function normalizeDestinationUrl(value) {
-  const input = value.trim();
-  if (!input) {
-    throw new CliError("A destination URL is required.");
-  }
-  try {
-    const parsed = new URL(input);
-    validateHttpUrl(parsed, "Destination URL");
-    return parsed.toString();
-  } catch (error) {
-    if (error instanceof CliError) {
-      throw error;
-    }
-    throw new CliError(`Invalid destination URL: ${value}`);
-  }
-}
-function normalizeWebhookUrl(value) {
-  const input = value.trim();
-  if (!input) {
-    throw new CliError("A webhook URL is required.");
-  }
-  try {
-    const parsed = new URL(input);
-    validateHttpUrl(parsed, "Webhook URL");
-    return parsed.toString();
-  } catch (error) {
-    if (error instanceof CliError) {
-      throw error;
-    }
-    throw new CliError(`Invalid webhook URL: ${value}`);
-  }
-}
-
 // src/lib/auth.ts
 var AUTH_REQUIRED_MESSAGE = "PeakURL credentials are not configured.";
 var EXAMPLE_BASE_URL = "https://example.com/api/v1";
@@ -326,143 +913,6 @@ import { tmpdir } from "os";
 import { dirname as dirname2, join as join2, resolve } from "path";
 import { posix as pathPosix } from "path";
 import { inflateRawSync } from "zlib";
-
-// src/lib/output.ts
-function writeStdout(message = "") {
-  process.stdout.write(`${message}
-`);
-}
-function writeStderr(message = "") {
-  process.stderr.write(`${message}
-`);
-}
-function outputStream(target) {
-  return target === "stdout" ? process.stdout : process.stderr;
-}
-function useColor(target) {
-  return Boolean(outputStream(target).isTTY && !process.env.NO_COLOR);
-}
-function successLine(message, target = "stdout") {
-  const label = useColor(target) ? "\x1B[32mSuccess\x1B[39m" : "Success";
-  return `${label}: ${message}`;
-}
-function errorLine(message, target = "stderr") {
-  const label = useColor(target) ? "\x1B[31mError\x1B[39m" : "Error";
-  return `${label}: ${message}`;
-}
-function writeNoticeBox(title, lines, target = "stderr") {
-  const contentLines = lines.length > 0 ? lines : [""];
-  const width = Math.max(
-    title.length,
-    ...contentLines.map((line) => line.length)
-  );
-  const stream = outputStream(target);
-  const useTuiBox = stream.isTTY;
-  const border = useTuiBox ? {
-    topLeft: "\u250C",
-    topRight: "\u2510",
-    bottomLeft: "\u2514",
-    bottomRight: "\u2518",
-    horizontal: "\u2500",
-    vertical: "\u2502",
-    separatorLeft: "\u251C",
-    separatorRight: "\u2524"
-  } : {
-    topLeft: "+",
-    topRight: "+",
-    bottomLeft: "+",
-    bottomRight: "+",
-    horizontal: "-",
-    vertical: "|",
-    separatorLeft: "+",
-    separatorRight: "+"
-  };
-  const topBorder = `${border.topLeft}${border.horizontal.repeat(width + 2)}${border.topRight}`;
-  const separator = `${border.separatorLeft}${border.horizontal.repeat(width + 2)}${border.separatorRight}`;
-  const bottomBorder = `${border.bottomLeft}${border.horizontal.repeat(width + 2)}${border.bottomRight}`;
-  const writeLine = target === "stdout" ? writeStdout : writeStderr;
-  writeLine(topBorder);
-  writeLine(`${border.vertical} ${title.padEnd(width)} ${border.vertical}`);
-  writeLine(separator);
-  for (const line of contentLines) {
-    writeLine(
-      `${border.vertical} ${line.padEnd(width)} ${border.vertical}`
-    );
-  }
-  writeLine(bottomBorder);
-}
-function formatTable(headers, rows2, target = "stdout") {
-  const stream = outputStream(target);
-  const useTuiBox = stream.isTTY;
-  const border = useTuiBox ? {
-    topLeft: "\u250C",
-    topRight: "\u2510",
-    bottomLeft: "\u2514",
-    bottomRight: "\u2518",
-    horizontal: "\u2500",
-    vertical: "\u2502",
-    separatorLeft: "\u251C",
-    separatorRight: "\u2524",
-    topJunction: "\u252C",
-    middleJunction: "\u253C",
-    bottomJunction: "\u2534"
-  } : {
-    topLeft: "+",
-    topRight: "+",
-    bottomLeft: "+",
-    bottomRight: "+",
-    horizontal: "-",
-    vertical: "|",
-    separatorLeft: "+",
-    separatorRight: "+",
-    topJunction: "+",
-    middleJunction: "+",
-    bottomJunction: "+"
-  };
-  const getLines = (value) => (value ?? "").split("\n");
-  const widths = headers.map(
-    (header, index) => Math.max(
-      header.length,
-      ...rows2.flatMap(
-        (row2) => getLines(row2[index]).map((line) => line.length)
-      )
-    )
-  );
-  const formatTableBorder = (left, join3, right) => `${left}${widths.map((width) => border.horizontal.repeat(width + 2)).join(join3)}${right}`;
-  const formatTableRow = (cells) => {
-    const linesByCell = cells.map(getLines);
-    const rowHeight = Math.max(...linesByCell.map((lines) => lines.length));
-    return Array.from(
-      { length: rowHeight },
-      (_value, rowIndex) => `${border.vertical}${linesByCell.map(
-        (lines, cellIndex) => ` ${(lines[rowIndex] ?? "").padEnd(widths[cellIndex])} `
-      ).join(border.vertical)}${border.vertical}`
-    ).join("\n");
-  };
-  return [
-    formatTableBorder(border.topLeft, border.topJunction, border.topRight),
-    formatTableRow(headers),
-    formatTableBorder(
-      border.separatorLeft,
-      border.middleJunction,
-      border.separatorRight
-    ),
-    ...rows2.map(formatTableRow),
-    formatTableBorder(
-      border.bottomLeft,
-      border.bottomJunction,
-      border.bottomRight
-    )
-  ].join("\n");
-}
-function formatDetailsTable(rows2, target = "stdout") {
-  return formatTable(["Detail", "Information"], rows2, target);
-}
-function writeJson(value) {
-  writeStdout(JSON.stringify(value, null, 2));
-}
-
-// src/lib/core.ts
 var DEFAULT_RELEASE_API_URL = "https://api.peakurl.org/v1/update";
 var DEFAULT_CORE_PACKAGE_URL = "https://peakurl.org/latest.zip";
 var EOCD_SIGNATURE = 101010256;
@@ -481,7 +931,7 @@ function getCorePackageUrl(env) {
     "package download"
   );
 }
-function asString(value) {
+function asString2(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
 function validateUrl(value, label) {
@@ -500,7 +950,7 @@ function validateUrl(value, label) {
   return parsed.toString();
 }
 function normalizeSha256(value) {
-  const candidate = asString(value)?.toLowerCase();
+  const candidate = asString2(value)?.toLowerCase();
   if (!candidate || !/^[a-f0-9]{64}$/.test(candidate)) {
     throw new CliError(
       "PeakURL release metadata is missing a valid SHA-256 checksum."
@@ -718,13 +1168,13 @@ async function getCoreRelease(env) {
     throw new CliError("PeakURL release metadata could not be loaded.");
   }
   const payload = await response.json();
-  const version = asString(payload.version) || "latest";
+  const version = asString2(payload.version) || "latest";
   return {
     version,
     downloadUrl: getCorePackageUrl(env),
     checksumSha256: normalizeSha256(payload.checksumSha256),
-    releasedAt: asString(payload.releasedAt),
-    releaseNotesUrl: asString(payload.releaseNotesUrl)
+    releasedAt: asString2(payload.releasedAt),
+    releaseNotesUrl: asString2(payload.releaseNotesUrl)
   };
 }
 async function downloadCorePackage(release, targetPath, force = false) {
@@ -793,17 +1243,23 @@ var EXPORT_HEADERS = [
   "created_at"
 ];
 function text(value) {
-  return typeof value === "string" ? value : "";
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  return "";
 }
 function csvValue(value) {
-  const content = value == null ? "" : String(value);
+  const content = value === null || value === void 0 ? "" : text(value);
   if (/[",\r\n]/.test(content)) {
     return `"${content.replace(/"/g, '""')}"`;
   }
   return content;
 }
 function xmlValue(value) {
-  return String(value ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+  return text(value ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
 function aliasValue(link) {
   return text(link.alias) || text(link.shortCode);
@@ -1093,7 +1549,7 @@ function getImportFormat(filePath, value) {
   );
 }
 async function readImportRows(filePath, format) {
-  let textContent = "";
+  let textContent;
   try {
     textContent = await readFile2(filePath, "utf8");
   } catch (error) {
@@ -1138,53 +1594,53 @@ function formatImportSummary(data) {
 
 // src/lib/links.ts
 var LIST_KEYS = ["urls", "items", "results"];
-function asObject(value) {
+function asObject2(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
-function asString2(value) {
+function asString3(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
-function asNumber(value) {
+function asNumber2(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
 function pickText(link, keys) {
   for (const key of keys) {
-    const value = asString2(link[key]);
+    const value = asString3(link[key]);
     if (value) {
       return value;
     }
   }
   return void 0;
 }
-function truncate(value, maxLength) {
+function truncate2(value, maxLength) {
   return value.length > maxLength ? `${value.slice(0, maxLength - 1)}\u2026` : value;
 }
 function getListMeta(data) {
-  const record = asObject(data);
+  const record = asObject2(data);
   if (!record) {
     return null;
   }
-  const meta = asObject(record.meta);
+  const meta = asObject2(record.meta);
   if (meta) {
     return {
-      page: asNumber(meta.page),
-      limit: asNumber(meta.limit),
-      totalItems: asNumber(meta.totalItems),
-      totalPages: asNumber(meta.totalPages)
+      page: asNumber2(meta.page),
+      limit: asNumber2(meta.limit),
+      totalItems: asNumber2(meta.totalItems),
+      totalPages: asNumber2(meta.totalPages)
     };
   }
   return {
-    page: asNumber(record.page),
-    limit: asNumber(record.limit),
-    totalItems: asNumber(record.total),
-    totalPages: asNumber(record.totalPages)
+    page: asNumber2(record.page),
+    limit: asNumber2(record.limit),
+    totalItems: asNumber2(record.total),
+    totalPages: asNumber2(record.totalPages)
   };
 }
 function extractLinks(data) {
   if (Array.isArray(data)) {
     return data;
   }
-  const record = asObject(data);
+  const record = asObject2(data);
   if (record) {
     for (const key of LIST_KEYS) {
       const value = record[key];
@@ -1221,14 +1677,14 @@ function formatLinkDetails(link) {
     ["Alias", getLinkAlias(link)],
     ["Short URL", getLinkShortUrl(link)],
     ["Destination", getLinkDestination(link)],
-    ["Title", asString2(link.title)],
-    ["Status", asString2(link.status)],
+    ["Title", asString3(link.title)],
+    ["Status", asString3(link.status)],
     [
       "Clicks",
-      asNumber(link.clicks) === void 0 ? void 0 : String(link.clicks)
+      asNumber2(link.clicks) === void 0 ? void 0 : String(link.clicks)
     ],
-    ["Created", asString2(link.createdAt)],
-    ["Updated", asString2(link.updatedAt)]
+    ["Created", asString3(link.createdAt)],
+    ["Updated", asString3(link.updatedAt)]
   ].filter((entry) => Boolean(entry[1]));
   if (rows2.length === 0) {
     return "No link fields returned.";
@@ -1241,11 +1697,11 @@ function formatLinksTable(links) {
   }
   const headers = ["ID", "Alias", "Short URL", "Destination", "Status"];
   const rows2 = links.map((link) => [
-    truncate(getLinkId(link) || "-", 18),
-    truncate(getLinkAlias(link) || "-", 12),
-    truncate(getLinkShortUrl(link) || "-", 36),
-    truncate(getLinkDestination(link) || "-", 52),
-    truncate(asString2(link.status) || "-", 12)
+    truncate2(getLinkId(link) || "-", 18),
+    truncate2(getLinkAlias(link) || "-", 12),
+    truncate2(getLinkShortUrl(link) || "-", 36),
+    truncate2(getLinkDestination(link) || "-", 52),
+    truncate2(asString3(link.status) || "-", 12)
   ]);
   return formatTable(headers, rows2);
 }
@@ -1527,6 +1983,33 @@ function locationRows(location) {
     row("Download command", text3(location.downloadCommand), 60)
   ]);
 }
+function cacheRows(cache) {
+  if (!cache) {
+    return [];
+  }
+  const redisEndpoint = cache.redis?.available || cache.redis?.configured ? `${text3(cache.redis.host) ?? "127.0.0.1"}:${formatCount(cache.redis.port) ?? "6379"}` : void 0;
+  const redisStatus = cache.redis?.available ? cache.redis.serverVersion ? `Connected (v${cache.redis.serverVersion})` : "Connected" : cache.redis?.configured ? "Configured, unavailable" : void 0;
+  const apcuStatus = cache.apcu?.available ? "Available" : cache.apcu?.extensionLoaded ? "Loaded, disabled" : cache.apcu !== void 0 && cache.apcu !== null ? "Missing" : void 0;
+  return rows([
+    row("Status", formatState(cache.status)),
+    row("Enabled", yesNo(cache.enabled, "Enabled", "Disabled")),
+    row("Active driver", text3(cache.activeDriver)),
+    row("Configured driver", text3(cache.configuredDriver)),
+    row("Cache size", formatSize(cache.sizeBytes)),
+    row(
+      cache.activeDriver === "redis" || cache.activeDriver === "apcu" ? "Cached items" : "Cached files",
+      formatCount(cache.fileCount)
+    ),
+    row("Default TTL", formatSeconds(cache.defaultTtl)),
+    row("Negative TTL", formatSeconds(cache.negativeTtl)),
+    row("Cache directory", text3(cache.path), 60),
+    row("Directory exists", yesNo(cache.directoryExists)),
+    row("Directory writable", yesNo(cache.writable)),
+    row("Redis server", redisEndpoint),
+    row("Redis status", redisStatus),
+    row("APCu extension", apcuStatus)
+  ]);
+}
 function dataRows(data) {
   if (!data) {
     return [];
@@ -1575,11 +2058,127 @@ ${checks}` : void 0,
     section("Storage", storageRows(status2.storage)),
     section("Mail", mailRows(status2.mail)),
     section("Location", locationRows(status2.location)),
+    section("Cache", cacheRows(status2.cache)),
     section("Data", dataRows(status2.data))
   ].filter((value) => Boolean(value));
   return sections.length > 0 ? sections.join("\n\n") : "No system status fields returned.";
 }
 
+// src/lib/job.ts
+function formatInterval(seconds) {
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h`;
+  const days = Math.floor(hours / 24);
+  return `${days}d`;
+}
+function formatDate(date) {
+  if (!date) return "never";
+  return new Date(date).toISOString().replace("T", " ").substring(0, 19);
+}
+function formatJobsList(status2) {
+  const rows2 = status2.jobs.map((job) => [
+    job.id,
+    job.title,
+    job.status,
+    job.is_enabled ? "yes" : "no",
+    formatDate(job.next_run_at)
+  ]);
+  const table = formatTable(
+    ["ID", "Job", "Status", "Enabled", "Next Run"],
+    rows2
+  );
+  const summary = `
+${status2.jobs_count} jobs registered.
+Timezone: ${status2.timezone}
+History retention: ${status2.retention_days} days`;
+  return `${table}${summary}`;
+}
+function formatJobDetails(job) {
+  const rows2 = [
+    ["ID", job.id],
+    ["Title", job.title],
+    ["Status", job.status],
+    ["Enabled", job.is_enabled ? "yes" : "no"],
+    ["Current interval", formatInterval(job.interval_seconds)],
+    [
+      "Recommended interval",
+      formatInterval(job.recommended_interval_seconds)
+    ],
+    ["Preferred run time", job.preferred_run_time || "none"],
+    ["Customized", job.is_customized ? "yes" : "no"],
+    ["Next run", formatDate(job.next_run_at)],
+    ["Last run", formatDate(job.last_run_at)],
+    ["Last finished", formatDate(job.last_finished_at)],
+    ["Attempts", String(job.attempts)],
+    ["Maximum attempts", String(job.max_attempts)],
+    ["Last error", job.last_error || "none"]
+  ];
+  let out = formatDetailsTable(rows2);
+  if (job.recent_runs && job.recent_runs.length > 0) {
+    out += `
+
+Recent Runs:
+${formatJobHistory(job.recent_runs)}`;
+  }
+  return out;
+}
+function formatJobHistory(runs) {
+  if (!runs || runs.length === 0) {
+    return "No recent runs.";
+  }
+  const rows2 = runs.map((run) => [
+    run.id,
+    run.status,
+    String(run.attempt),
+    formatDate(run.started_at),
+    formatDate(run.finished_at),
+    run.duration_ms ? `${run.duration_ms}ms` : "-",
+    run.output_summary || "-",
+    run.error_message || "-"
+  ]);
+  return formatTable(
+    [
+      "Run ID",
+      "Status",
+      "Attempt",
+      "Started",
+      "Finished",
+      "Duration",
+      "Summary",
+      "Error"
+    ],
+    rows2
+  );
+}
+function formatRunJobResult(result) {
+  let out = `Job: ${result.job_id}
+Status: ${result.status}`;
+  if (result.summary) {
+    out += `
+Summary: ${result.summary}`;
+  }
+  if (result.error) {
+    out += `
+Error: ${result.error}`;
+  }
+  return out;
+}
+function formatRunDueResult(result) {
+  if (!result.results || result.results.length === 0) {
+    return "No jobs were due.";
+  }
+  const rows2 = result.results.map((r) => [
+    r.job_id,
+    r.status,
+    r.summary || "-",
+    r.error || "-"
+  ]);
+  return formatTable(["Job ID", "Status", "Summary", "Error"], rows2);
+}
+
 // src/lib/update.ts
 var PACKAGE_NAME = "peakurl";
 var DEFAULT_REGISTRY_URL = "https://registry.npmjs.org";
@@ -1846,7 +2445,7 @@ function text5(value) {
 function textList(value) {
   return Array.isArray(value) ? value.map((item) => text5(item)).filter((item) => Boolean(item)) : [];
 }
-function truncate2(value, maxLength) {
+function truncate3(value, maxLength) {
   return value.length > maxLength ? `${value.slice(0, maxLength - 1)}\u2026` : value;
 }
 function parseWebhookEvents(value, previous = []) {
@@ -1893,11 +2492,11 @@ function formatWebhooksTable(webhooks) {
   return formatTable(
     ["ID", "URL", "Events", "Status", "Secret"],
     webhooks.map((webhook) => [
-      truncate2(getWebhookId(webhook) || "-", 18),
-      truncate2(getWebhookUrl(webhook) || "-", 42),
-      truncate2(getWebhookEvents(webhook).join(", ") || "-", 30),
+      truncate3(getWebhookId(webhook) || "-", 18),
+      truncate3(getWebhookUrl(webhook) || "-", 42),
+      truncate3(getWebhookEvents(webhook).join(", ") || "-", 30),
       webhook.isActive === false ? "inactive" : "active",
-      truncate2(text5(webhook.secretHint) || "-", 18)
+      truncate3(text5(webhook.secretHint) || "-", 18)
     ])
   );
 }
@@ -1923,249 +2522,141 @@ function formatWebhooksSummary(webhooks) {
   return `${webhooks.length} webhook${webhooks.length === 1 ? "" : "s"} returned.`;
 }
 
-// src/commands/core.ts
-async function downloadCore(options) {
-  const release = await getCoreRelease(process.env);
-  const result = await downloadCorePackage(
-    release,
-    cwd(),
-    Boolean(options.force)
-  );
-  const responseBody = {
-    success: true,
-    message: "PeakURL downloaded.",
-    data: result,
-    timestamp: (/* @__PURE__ */ new Date()).toISOString()
-  };
+// src/commands/activity.ts
+async function listActivity(options) {
+  const config = await getAuthConfig(process.env);
+  const response = await new ApiClient(config).listActivity({
+    page: options.page,
+    limit: options.limit,
+    search: options.search
+  });
+  const items = extractActivity(response.data);
   if (options.json) {
-    writeJson(responseBody);
+    writeJson(response);
     return;
   }
   if (options.quiet) {
-    writeStdout(result.path);
+    for (const item of items) {
+      if (item.id) {
+        writeStdout(String(item.id));
+      }
+    }
     return;
   }
-  writeStdout(successLine(responseBody.message));
-  writeStdout(formatCoreDownload(result));
-}
-
-// src/commands/links.ts
-import { mkdir as mkdir3, writeFile as writeFile3 } from "fs/promises";
-import { dirname as dirname3, resolve as resolve2 } from "path";
-
-// src/api/client.ts
-function isApiResponse(value) {
-  return Boolean(
-    value && typeof value === "object" && "success" in value && "message" in value && "timestamp" in value
-  );
-}
-function networkError(apiBaseUrl, error) {
-  if (error instanceof Error && error.message) {
-    return `Could not reach PeakURL at ${apiBaseUrl}. ${error.message}`;
-  }
-  return `Could not reach PeakURL at ${apiBaseUrl}.`;
+  writeStdout(successLine(response.message || "Activity loaded."));
+  writeStdout(formatActivityTable(items));
+  writeStdout(formatActivitySummary(response.data, items.length));
 }
-var ApiClient = class {
-  /**
-   * Creates a client bound to one resolved credential set.
-   *
-   * @param config Explicit API base URL plus bearer API key.
-   */
-  constructor(config) {
-    this.config = config;
-  }
-  config;
-  /**
-   * Loads the currently authenticated user.
-   *
-   * PeakURL accepts bearer API keys on `GET /users/me`, which is also the
-   * CLI login verification flow.
-   *
-   * @returns API response envelope containing the authenticated user.
-   */
-  whoami() {
-    return this.request("GET", "users/me");
-  }
-  /**
-   * Loads the current system status snapshot for the authenticated site.
-   *
-   * @returns API response envelope containing system status sections.
-   */
-  getStatus() {
-    return this.request("GET", "system/status");
-  }
-  /**
-   * Creates a short URL.
-   *
-   * @param payload Request body accepted by `POST /api/v1/urls`.
-   * @returns API response envelope containing the created link.
-   */
-  createUrl(payload) {
-    return this.request("POST", "urls", payload);
-  }
-  /**
-   * Lists short URLs with optional pagination and filtering.
-   *
-   * The current PeakURL app returns `{ items, meta }` under `data`, but the
-   * CLI keeps a slightly broader compatibility type for future-proofing.
-   *
-   * @param query Optional query-string values.
-   * @returns API response envelope containing list data.
-   */
-  listUrls(query) {
-    return this.request("GET", "urls", void 0, query);
-  }
-  /**
-   * Exports the full accessible link dataset for the authenticated user.
-   *
-   * @param query Optional search and sort values.
-   * @returns API response envelope containing the full export payload.
-   */
-  exportUrls(query) {
-    return this.request(
-      "GET",
-      "urls/export",
-      void 0,
-      query
-    );
-  }
-  /**
-   * Imports multiple short links in one bulk request.
-   *
-   * @param payload Request body accepted by `POST /api/v1/urls/bulk`.
-   * @returns API response envelope containing created rows plus row errors.
-   */
-  importUrls(payload) {
-    return this.request("POST", "urls/bulk", payload);
-  }
-  /**
-   * Loads a single short URL by identifier or alias.
-   *
-   * PeakURL resolves IDs, short codes, and aliases through the same route.
-   *
-   * @param idOrAlias Link identifier, short code, or alias.
-   * @returns API response envelope containing the resolved link.
-   */
-  getUrl(idOrAlias) {
-    return this.request(
-      "GET",
-      `urls/${encodeURIComponent(idOrAlias)}`
-    );
-  }
-  /**
-   * Deletes a short URL by its stable row ID.
-   *
-   * The current PeakURL backend delete route expects the row ID. The CLI can
-   * still accept an alias at the command layer by resolving it first.
-   *
-   * @param id Stable link row ID.
-   * @returns API response envelope containing the deletion result.
-   */
-  deleteUrl(id) {
-    return this.request(
-      "DELETE",
-      `urls/${encodeURIComponent(id)}`
-    );
-  }
-  /**
-   * Lists outbound webhooks for the authenticated user.
-   *
-   * @returns API response envelope containing webhook rows.
-   */
-  listWebhooks() {
-    return this.request("GET", "webhooks");
-  }
-  /**
-   * Creates one outbound webhook subscription.
-   *
-   * @param payload Request body accepted by `POST /api/v1/webhooks`.
-   * @returns API response envelope containing the created webhook.
-   */
-  createWebhook(payload) {
-    return this.request("POST", "webhooks", payload);
-  }
-  /**
-   * Deletes one webhook by its stable row ID.
-   *
-   * @param id Webhook identifier returned by the list/create endpoints.
-   * @returns API response envelope containing the deletion result.
-   */
-  deleteWebhook(id) {
-    return this.request(
-      "DELETE",
-      `webhooks/${encodeURIComponent(id)}`
+async function deleteActivity(identifiers, options) {
+  const config = await getAuthConfig(process.env);
+  const client = new ApiClient(config);
+  if (options.all) {
+    const response2 = await client.clearActivity();
+    if (options.json) {
+      writeJson(response2);
+      return;
+    }
+    if (options.quiet) {
+      return;
+    }
+    writeStdout(
+      successLine(response2.message || "All activity logs deleted.")
     );
+    return;
   }
-  /**
-   * Performs one authenticated API request and normalizes the response.
-   *
-   * @param method HTTP method to send.
-   * @param path Route path relative to `/api/v1`.
-   * @param body Optional JSON body.
-   * @param query Optional query-string values.
-   * @returns Parsed PeakURL response envelope.
-   * @throws {CliError} When the network request fails or the API returns an error.
-   */
-  async request(method, path, body, query) {
-    const url = buildApiUrl(this.config.apiBaseUrl, path, query);
-    let response;
-    try {
-      response = await fetch(url, {
-        method,
-        headers: {
-          Accept: "application/json",
-          Authorization: `Bearer ${this.config.apiKey}`,
-          ...body ? { "Content-Type": "application/json" } : {}
-        },
-        body: body ? JSON.stringify(body) : void 0
-      });
-    } catch (error) {
-      throw new CliError(networkError(this.config.apiBaseUrl, error), 1, {
-        cause: error instanceof Error ? error : void 0
-      });
-    }
-    const rawText = await response.text();
-    if (!rawText) {
-      if (!response.ok) {
-        throw new CliError(
-          `PeakURL request failed with HTTP ${response.status}.`
-        );
+  const rawTargets = [];
+  if (typeof identifiers === "string" && identifiers.trim()) {
+    rawTargets.push(identifiers.trim());
+  } else if (Array.isArray(identifiers)) {
+    for (const item of identifiers) {
+      if (typeof item === "string" && item.trim()) {
+        rawTargets.push(item.trim());
       }
-      return {
-        success: true,
-        message: "Request completed.",
-        data: void 0,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
-      };
     }
-    let parsed;
-    try {
-      parsed = JSON.parse(rawText);
-    } catch {
-      if (!response.ok) {
-        throw new CliError(
-          `PeakURL request failed with HTTP ${response.status}.`
-        );
+  }
+  if (options.ids) {
+    for (const id of options.ids.split(",")) {
+      const trimmed = id.trim();
+      if (trimmed) {
+        rawTargets.push(trimmed);
       }
-      throw new CliError("PeakURL returned an invalid JSON response.");
     }
-    if (!isApiResponse(parsed)) {
-      throw new CliError(
-        "PeakURL returned an unexpected response envelope."
-      );
+  }
+  const uniqueTargets = Array.from(new Set(rawTargets));
+  if (uniqueTargets.length === 0) {
+    throw new CliError(
+      "Specify one or more activity IDs to delete, or use --all to delete all activity logs."
+    );
+  }
+  if (uniqueTargets.length === 1) {
+    const response2 = await client.deleteActivity(uniqueTargets[0]);
+    if (options.json) {
+      writeJson(response2);
+      return;
     }
-    if (!response.ok || !parsed.success) {
-      const statusCode = response.status === 401 ? 2 : 1;
-      throw new CliError(
-        parsed.message || `PeakURL request failed with HTTP ${response.status}.`,
-        statusCode
-      );
+    if (options.quiet) {
+      return;
     }
-    return parsed;
+    writeStdout(successLine(response2.message || "Activity log deleted."));
+    return;
   }
-};
+  const response = await client.deleteActivityBulk(uniqueTargets);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    return;
+  }
+  writeStdout(
+    successLine(
+      response.message || `Deleted ${uniqueTargets.length} activity record${uniqueTargets.length === 1 ? "" : "s"}.`
+    )
+  );
+}
+async function clearActivity(options) {
+  const config = await getAuthConfig(process.env);
+  const response = await new ApiClient(config).clearActivity();
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    return;
+  }
+  writeStdout(successLine(response.message || "All activity logs deleted."));
+}
+
+// src/commands/core.ts
+import { cwd } from "process";
+async function downloadCore(options) {
+  const release = await getCoreRelease(process.env);
+  const result = await downloadCorePackage(
+    release,
+    cwd(),
+    Boolean(options.force)
+  );
+  const responseBody = {
+    success: true,
+    message: "PeakURL downloaded.",
+    data: result,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  if (options.json) {
+    writeJson(responseBody);
+    return;
+  }
+  if (options.quiet) {
+    writeStdout(result.path);
+    return;
+  }
+  writeStdout(successLine(responseBody.message));
+  writeStdout(formatCoreDownload(result));
+}
 
 // src/commands/links.ts
+import { mkdir as mkdir3, writeFile as writeFile3 } from "fs/promises";
+import { dirname as dirname3, resolve as resolve2 } from "path";
 function normalizeExpiresAt(value) {
   if (!value) {
     return void 0;
@@ -2308,17 +2799,93 @@ async function getLink(idOrAlias, options) {
   writeStdout(successLine(response.message));
   writeStdout(formatLinkDetails(response.data));
 }
-async function deleteLink(idOrAlias, options) {
+async function deleteLink(identifiers, options) {
   const config = await getAuthConfig(process.env);
   const client = new ApiClient(config);
-  const lookupResponse = await client.getUrl(idOrAlias);
-  const resolvedId = getLinkId(lookupResponse.data);
-  if (!resolvedId) {
+  if (options.all) {
+    const response2 = await client.clearUrls();
+    if (options.json) {
+      writeJson(response2);
+      return;
+    }
+    if (options.quiet) {
+      return;
+    }
+    writeStdout(
+      successLine(response2.message || "All short links deleted.")
+    );
+    return;
+  }
+  if (options.trash || options.emptyTrash) {
+    const response2 = await client.emptyTrash();
+    if (options.json) {
+      writeJson(response2);
+      return;
+    }
+    if (options.quiet) {
+      return;
+    }
+    writeStdout(successLine(response2.message || "Trash emptied."));
+    return;
+  }
+  const rawTargets = [];
+  if (typeof identifiers === "string" && identifiers.trim()) {
+    rawTargets.push(identifiers.trim());
+  } else if (Array.isArray(identifiers)) {
+    for (const item of identifiers) {
+      if (typeof item === "string" && item.trim()) {
+        rawTargets.push(item.trim());
+      }
+    }
+  }
+  if (options.ids) {
+    for (const id of options.ids.split(",")) {
+      const trimmed = id.trim();
+      if (trimmed) {
+        rawTargets.push(trimmed);
+      }
+    }
+  }
+  const uniqueTargets = Array.from(new Set(rawTargets));
+  if (uniqueTargets.length === 0) {
     throw new CliError(
-      "PeakURL returned a link record without an ID, so the CLI cannot delete it safely."
+      "Specify one or more link identifiers or aliases to delete, or use --all to delete all links."
     );
   }
-  const response = await client.deleteUrl(resolvedId);
+  if (uniqueTargets.length === 1) {
+    const lookupResponse = await client.getUrl(uniqueTargets[0]);
+    const resolvedId = getLinkId(lookupResponse.data);
+    if (!resolvedId) {
+      throw new CliError(
+        "PeakURL returned a link record without an ID, so the CLI cannot delete it safely."
+      );
+    }
+    const response2 = await client.deleteUrl(resolvedId);
+    if (options.json) {
+      writeJson(response2);
+      return;
+    }
+    if (options.quiet) {
+      return;
+    }
+    writeStdout(successLine(response2.message));
+    return;
+  }
+  const resolvedIds = [];
+  for (const target of uniqueTargets) {
+    try {
+      const lookup = await client.getUrl(target);
+      const id = getLinkId(lookup.data);
+      if (id) {
+        resolvedIds.push(id);
+      } else {
+        resolvedIds.push(target);
+      }
+    } catch {
+      resolvedIds.push(target);
+    }
+  }
+  const response = await client.deleteUrlsBulk(resolvedIds);
   if (options.json) {
     writeJson(response);
     return;
@@ -2326,7 +2893,11 @@ async function deleteLink(idOrAlias, options) {
   if (options.quiet) {
     return;
   }
-  writeStdout(successLine(response.message));
+  writeStdout(
+    successLine(
+      response.message || `Deleted ${resolvedIds.length} short link${resolvedIds.length === 1 ? "" : "s"}.`
+    )
+  );
 }
 
 // src/commands/login.ts
@@ -2513,7 +3084,7 @@ async function deleteWebhook(id, options) {
   }
   writeStdout(successLine(response.message));
 }
-async function listWebhookEvents(options) {
+function listWebhookEvents(options) {
   const response = {
     success: true,
     message: "Webhook events loaded.",
@@ -2550,6 +3121,230 @@ async function whoami(options) {
   writeStdout(userTable(response.data, config.apiBaseUrl));
 }
 
+// src/commands/job.ts
+async function getClient() {
+  const config = await getAuthConfig(process.env);
+  return new ApiClient(config);
+}
+async function listJobs(options) {
+  const client = await getClient();
+  const response = await client.getJobStatus();
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    const ids = response.data.jobs.map((job) => job.id).join("\n");
+    if (ids) {
+      writeStdout(ids);
+    }
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatJobsList(response.data));
+}
+async function getJob(id, options) {
+  const client = await getClient();
+  const response = await client.getJobStatus();
+  const job = response.data.jobs.find((j) => j.id === id);
+  if (!job) {
+    throw new CliError(`Job '${id}' not found.`, 1);
+  }
+  if (options.json) {
+    writeJson({
+      success: true,
+      message: "Job loaded.",
+      data: job,
+      timestamp: response.timestamp
+    });
+    return;
+  }
+  if (options.quiet) {
+    writeStdout(job.id);
+    return;
+  }
+  writeStdout(successLine(`Job ${job.id} loaded.`));
+  writeStdout();
+  writeStdout(formatJobDetails(job));
+}
+async function runJob(id, options) {
+  const client = await getClient();
+  const response = await client.runJob(id);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    writeStdout(response.data.status);
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatRunJobResult(response.data));
+}
+async function runDueJobs(options) {
+  const client = await getClient();
+  const response = await client.runDueJobs();
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    const statuses = response.data.results.map((r) => r.status).join("\n");
+    if (statuses) {
+      writeStdout(statuses);
+    }
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatRunDueResult(response.data));
+}
+async function listJobHistory(id, options) {
+  const client = await getClient();
+  const response = await client.getJobStatus();
+  const job = response.data.jobs.find((j) => j.id === id);
+  if (!job) {
+    throw new CliError(`Job '${id}' not found.`, 1);
+  }
+  if (options.json) {
+    writeJson({
+      success: true,
+      message: "History loaded.",
+      data: job.recent_runs || [],
+      timestamp: response.timestamp
+    });
+    return;
+  }
+  if (options.quiet) {
+    const ids = (job.recent_runs || []).map((r) => r.id).join("\n");
+    if (ids) {
+      writeStdout(ids);
+    }
+    return;
+  }
+  writeStdout(successLine(`History for job ${job.id} loaded.`));
+  writeStdout();
+  writeStdout(formatJobHistory(job.recent_runs || []));
+}
+async function clearJobHistory(options) {
+  const client = await getClient();
+  const response = await client.clearJobHistory(options.job);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    return;
+  }
+  writeStdout(successLine(response.message));
+}
+async function updateJobSchedule(id, options) {
+  const client = await getClient();
+  if (options.enabled && options.disabled) {
+    throw new CliError("Cannot specify both --enabled and --disabled.", 1);
+  }
+  const payload = {};
+  if (options.interval !== void 0) {
+    const interval = parseInt(options.interval, 10);
+    if (isNaN(interval) || interval <= 0) {
+      throw new CliError("Interval must be a positive integer.", 1);
+    }
+    payload.interval_seconds = interval;
+  }
+  if (options.preferredTime !== void 0) {
+    if (options.preferredTime.toLowerCase() === "none" || options.preferredTime === "") {
+      payload.preferred_run_time = null;
+    } else if (/^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/.test(options.preferredTime)) {
+      payload.preferred_run_time = options.preferredTime;
+    } else {
+      throw new CliError(
+        "Preferred time must be in HH:MM format or 'none'.",
+        1
+      );
+    }
+  }
+  if (options.enabled !== void 0) {
+    payload.is_enabled = true;
+  } else if (options.disabled !== void 0) {
+    payload.is_enabled = false;
+  }
+  if (Object.keys(payload).length === 0) {
+    throw new CliError("No schedule changes requested.", 1);
+  }
+  const response = await client.updateJobSchedule(id, payload);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatJobDetails(response.data));
+}
+async function resetJobSchedule(id, options) {
+  const client = await getClient();
+  const response = await client.resetJobSchedule(id);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatJobDetails(response.data));
+}
+async function updateJobSettings(options) {
+  const client = await getClient();
+  if (options.retentionDays !== void 0) {
+    const days = parseInt(options.retentionDays, 10);
+    if (isNaN(days) || days < 0) {
+      throw new CliError(
+        "Retention days must be a non-negative integer.",
+        1
+      );
+    }
+    const response2 = await client.updateJobSettings({
+      retention_days: days
+    });
+    if (options.json) {
+      writeJson(response2);
+      return;
+    }
+    if (options.quiet) {
+      writeStdout(String(response2.data.retention_days));
+      return;
+    }
+    writeStdout(successLine(response2.message));
+    return;
+  }
+  const response = await client.getJobStatus();
+  if (options.json) {
+    writeJson({
+      success: true,
+      message: "Settings loaded.",
+      data: {
+        retention_days: response.data.retention_days,
+        timezone: response.data.timezone
+      },
+      timestamp: response.timestamp
+    });
+    return;
+  }
+  if (options.quiet) {
+    writeStdout(String(response.data.retention_days));
+    return;
+  }
+  writeStdout(successLine("Settings loaded."));
+  writeStdout(`History retention: ${response.data.retention_days} days`);
+  writeStdout(`Timezone: ${response.data.timezone}`);
+}
+
 // src/index.ts
 function parseNumber(label) {
   return (value) => {
@@ -2584,7 +3379,7 @@ function getRetryCommandName(argv) {
   if (!first || first.startsWith("-")) {
     return void 0;
   }
-  if (first === "webhook" || first === "webhooks") {
+  if (first === "webhook" || first === "activity" || first === "job") {
     const second = argv[3]?.trim();
     if (second && !second.startsWith("-")) {
       return `${first} ${second}`;
@@ -2592,10 +3387,33 @@ function getRetryCommandName(argv) {
   }
   return first;
 }
+var COMMAND_SUGGESTIONS = {
+  activities: "activity",
+  webhooks: "webhook",
+  jobs: "job",
+  cron: "job",
+  "scheduled-jobs": "job",
+  links: "list",
+  urls: "list"
+};
 async function main() {
   const program = new Command();
   const version = await getCliVersion();
-  program.name("peakurl").description("Manage your PeakURL site from the terminal.").helpOption("-h, --help", "Show help").helpCommand("help [command]", "Show help for a command").version(version, "-v, --version", "Show CLI version").showHelpAfterError().showSuggestionAfterError().addHelpText(
+  program.name("peakurl").description("Manage your PeakURL site from the terminal.").helpOption("-h, --help", "Show help").helpCommand("help [command]", "Show help for a command").version(version, "-v, --version", "Show CLI version").configureOutput({
+    outputError: (str, write) => {
+      const match = /error: unknown command '([^']+)'/.exec(str);
+      if (match && COMMAND_SUGGESTIONS[match[1]]) {
+        const suggestion = COMMAND_SUGGESTIONS[match[1]];
+        write(
+          `error: unknown command '${match[1]}'. Did you mean 'peakurl ${suggestion}'?
+
+`
+        );
+        return;
+      }
+      write(str);
+    }
+  }).showHelpAfterError().showSuggestionAfterError().addHelpText(
     "after",
     `
 Get Started:
@@ -2609,6 +3427,8 @@ Common Commands:
   peakurl list --limit 10
   peakurl import ./links.csv
   peakurl export --format csv
+  peakurl activity list
+  peakurl job list
   peakurl webhook list
   peakurl update --check
 
@@ -2710,8 +3530,57 @@ Run 'peakurl <command> --help' for command-specific flags and examples.`
     ["peakurl get docs", "peakurl get url_123 --json"]
   );
   addExamples(
-    program.command("delete").summary("Delete one short link").description("Delete a PeakURL short link by id or alias.").helpOption("-h, --help", "Show help").argument("<id-or-alias>", "Link identifier or alias").option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(deleteLink),
-    ["peakurl delete docs", "peakurl delete url_123 --quiet"]
+    program.command("delete").summary("Delete short links").description(
+      "Delete PeakURL short links by ID or alias, in bulk, or clear all links."
+    ).helpOption("-h, --help", "Show help").argument("[id-or-alias...]", "Link identifier(s) or alias(es)").option("--all", "Delete all accessible short links").option(
+      "--trash, --empty-trash",
+      "Empty all short links currently in trash"
+    ).option(
+      "--ids <ids>",
+      "Comma-separated list of link IDs to bulk delete"
+    ).option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(deleteLink),
+    [
+      "peakurl delete docs",
+      "peakurl delete docs pricing launch",
+      "peakurl delete --ids url_1,url_2,url_3",
+      "peakurl delete --empty-trash",
+      "peakurl delete --all"
+    ]
+  );
+  const activity = program.command("activity").summary("View and manage activity logs").helpOption("-h, --help", "Show help").description(
+    "View audit log activity entries, delete specific records, or clear all history."
+  );
+  addExamples(activity, [
+    "peakurl activity list",
+    "peakurl activity delete act_123 act_456",
+    "peakurl activity clear"
+  ]);
+  addExamples(
+    activity.command("list", { isDefault: true }).summary("List activity logs").description("List audit log activity records.").helpOption("-h, --help", "Show help").option("--page <number>", "Page number", parseNumber("page")).option("--limit <number>", "Page size", parseNumber("limit")).option("--search <query>", "Search term").option("--json", "Print machine-readable output").option("--quiet", "Print only activity record IDs").action(listActivity),
+    [
+      "peakurl activity",
+      "peakurl activity list",
+      "peakurl activity list --limit 25 --page 1",
+      "peakurl activity list --search delete --json"
+    ]
+  );
+  addExamples(
+    activity.command("delete").summary("Delete activity logs").description(
+      "Delete one or more activity logs by ID, or clear all logs with --all."
+    ).helpOption("-h, --help", "Show help").argument("[ids...]", "One or more activity log IDs to delete").option("--all", "Delete all activity log history").option(
+      "--ids <ids>",
+      "Comma-separated list of activity log IDs to delete"
+    ).option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(deleteActivity),
+    [
+      "peakurl activity delete act_123",
+      "peakurl activity delete act_123 act_456",
+      "peakurl activity delete --ids act_1,act_2",
+      "peakurl activity delete --all"
+    ]
+  );
+  addExamples(
+    activity.command("clear").summary("Clear all activity logs").description("Delete all audit log activity records permanently.").helpOption("-h, --help", "Show help").option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(clearActivity),
+    ["peakurl activity clear", "peakurl activity clear --json"]
   );
   addExamples(
     program.command("update").summary("Check for CLI updates").description(
@@ -2719,18 +3588,110 @@ Run 'peakurl <command> --help' for command-specific flags and examples.`
     ).helpOption("-h, --help", "Show help").option(
       "--check",
       "Alias for checking update status without changing anything"
-    ).option("--json", "Print machine-readable output").option("--quiet", "Print minimal output").action((options) => checkUpdate(options, version)),
+    ).option("--json", "Print machine-readable output").option("--quiet", "Print minimal output").action(
+      (options) => checkUpdate(options, version)
+    ),
     ["peakurl update", "peakurl update --check", "peakurl update --json"]
   );
-  const webhook = program.command("webhook").alias("webhooks").summary("Manage webhooks").helpOption("-h, --help", "Show help").description("Manage outbound webhook integrations.");
+  const jobCmd = program.command("job").summary("Manage scheduled jobs").description(
+    "Manage server-side scheduled jobs, view their execution history, and run them manually."
+  ).helpOption("-h, --help", "Show help");
+  addExamples(jobCmd, [
+    "peakurl job",
+    "peakurl job list",
+    "peakurl job get peakurl_version_check",
+    "peakurl job run peakurl_version_check",
+    "peakurl job run-due"
+  ]);
+  addExamples(
+    jobCmd.command("list", { isDefault: true }).summary("List scheduled jobs").description("List all registered scheduled jobs.").helpOption("-h, --help", "Show help").option("--json", "Print machine-readable output").option("--quiet", "Print only job IDs").action(listJobs),
+    [
+      "peakurl job",
+      "peakurl job list",
+      "peakurl job list --json",
+      "peakurl job list --quiet"
+    ]
+  );
+  addExamples(
+    jobCmd.command("get").summary("Show job details").description(
+      "Show detailed configuration and status for one scheduled job."
+    ).helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--json", "Print machine-readable output").option("--quiet", "Print only the job ID").action(getJob),
+    [
+      "peakurl job get peakurl_version_check",
+      "peakurl job get peakurl_version_check --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("run").summary("Run a scheduled job").description("Force a specific scheduled job to run immediately.").helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--json", "Print machine-readable output").option("--quiet", "Print only the execution status").action(runJob),
+    [
+      "peakurl job run peakurl_version_check",
+      "peakurl job run peakurl_version_check --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("run-due").summary("Run due jobs").description("Trigger all scheduled jobs that are currently due.").helpOption("-h, --help", "Show help").option("--json", "Print machine-readable output").option("--quiet", "Print only the execution statuses").action(runDueJobs),
+    ["peakurl job run-due", "peakurl job run-due --json"]
+  );
+  addExamples(
+    jobCmd.command("history").summary("View job history").description("View recent execution history for a scheduled job.").helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--json", "Print machine-readable output").option("--quiet", "Print only history record IDs").action(listJobHistory),
+    [
+      "peakurl job history peakurl_version_check",
+      "peakurl job history peakurl_version_check --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("clear-history").summary("Clear job history").description(
+      "Clear execution history for all jobs or a specific job."
+    ).helpOption("-h, --help", "Show help").option("--job <id>", "Specific job identifier to clear").option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(clearJobHistory),
+    [
+      "peakurl job clear-history",
+      "peakurl job clear-history --job peakurl_version_check",
+      "peakurl job clear-history --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("schedule").summary("Update job schedule").description("Update the schedule configuration for a job.").helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--interval <seconds>", "Execution interval in seconds").option(
+      "--preferred-time <time>",
+      "Preferred run time (HH:MM or 'none')"
+    ).option("--enabled", "Enable the job").option("--disabled", "Disable the job").option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(updateJobSchedule),
+    [
+      "peakurl job schedule peakurl_version_check --interval 43200",
+      "peakurl job schedule peakurl_version_check --preferred-time 03:00",
+      "peakurl job schedule peakurl_version_check --disabled"
+    ]
+  );
+  addExamples(
+    jobCmd.command("reset").summary("Reset job schedule").description("Reset a job's schedule to its default configuration.").helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(resetJobSchedule),
+    [
+      "peakurl job reset peakurl_version_check",
+      "peakurl job reset peakurl_version_check --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("settings").summary("Manage scheduler settings").description("View or update global scheduler settings.").helpOption("-h, --help", "Show help").option(
+      "--retention-days <days>",
+      "Number of days to keep execution history"
+    ).option("--json", "Print machine-readable output").option("--quiet", "Print minimal output").action(updateJobSettings),
+    [
+      "peakurl job settings",
+      "peakurl job settings --retention-days 14",
+      "peakurl job settings --json"
+    ]
+  );
+  const webhook = program.command("webhook").summary("Manage webhooks").helpOption("-h, --help", "Show help").description("Manage outbound webhook integrations.");
   addExamples(webhook, [
+    "peakurl webhook",
     "peakurl webhook list",
     "peakurl webhook create https://example.com/api/webhooks/peakurl --event link.clicked",
     "peakurl webhook events"
   ]);
   addExamples(
-    webhook.command("list").summary("List webhooks").description("List outbound webhooks.").helpOption("-h, --help", "Show help").option("--json", "Print machine-readable output").option("--quiet", "Print minimal webhook identifiers").action(listWebhooks),
-    ["peakurl webhook list", "peakurl webhook list --json"]
+    webhook.command("list", { isDefault: true }).summary("List webhooks").description("List outbound webhooks.").helpOption("-h, --help", "Show help").option("--json", "Print machine-readable output").option("--quiet", "Print minimal webhook identifiers").action(listWebhooks),
+    [
+      "peakurl webhook",
+      "peakurl webhook list",
+      "peakurl webhook list --json"
+    ]
   );
   addExamples(
     webhook.command("create").summary("Create a webhook").description("Create an outbound webhook.").helpOption("-h, --help", "Show help").argument("<url>", "Webhook endpoint URL").option(