@hasna/shortlinks 0.2.5 → 0.2.7

package/dist/cli/index.js

@@ -33,7 +33,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = import.meta.require;
 
-// node_modules/.pnpm/commander@13.1.0/node_modules/commander/lib/error.js
+// node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
   class CommanderError extends Error {
     constructor(exitCode, code, message) {
@@ -57,7 +57,7 @@ var require_error = __commonJS((exports) => {
   exports.InvalidArgumentError = InvalidArgumentError;
 });
 
-// node_modules/.pnpm/commander@13.1.0/node_modules/commander/lib/argument.js
+// node_modules/commander/lib/argument.js
 var require_argument = __commonJS((exports) => {
   var { InvalidArgumentError } = require_error();
 
@@ -136,7 +136,7 @@ var require_argument = __commonJS((exports) => {
   exports.humanReadableArgName = humanReadableArgName;
 });
 
-// node_modules/.pnpm/commander@13.1.0/node_modules/commander/lib/help.js
+// node_modules/commander/lib/help.js
 var require_help = __commonJS((exports) => {
   var { humanReadableArgName } = require_argument();
 
@@ -486,7 +486,7 @@ ${itemIndentStr}`);
   exports.stripColor = stripColor;
 });
 
-// node_modules/.pnpm/commander@13.1.0/node_modules/commander/lib/option.js
+// node_modules/commander/lib/option.js
 var require_option = __commonJS((exports) => {
   var { InvalidArgumentError } = require_error();
 
@@ -664,7 +664,7 @@ var require_option = __commonJS((exports) => {
   exports.DualOptions = DualOptions;
 });
 
-// node_modules/.pnpm/commander@13.1.0/node_modules/commander/lib/suggestSimilar.js
+// node_modules/commander/lib/suggestSimilar.js
 var require_suggestSimilar = __commonJS((exports) => {
   var maxDistance = 3;
   function editDistance(a, b) {
@@ -737,7 +737,7 @@ var require_suggestSimilar = __commonJS((exports) => {
   exports.suggestSimilar = suggestSimilar;
 });
 
-// node_modules/.pnpm/commander@13.1.0/node_modules/commander/lib/command.js
+// node_modules/commander/lib/command.js
 var require_command = __commonJS((exports) => {
   var EventEmitter = __require("events").EventEmitter;
   var childProcess = __require("child_process");
@@ -979,7 +979,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this._exitCallback = (err) => {
           if (err.code !== "commander.executeSubCommandAsync") {
             throw err;
-          } else {}
+          }
         };
       }
       return this;
@@ -2047,7 +2047,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
   exports.useColor = useColor;
 });
 
-// node_modules/.pnpm/commander@13.1.0/node_modules/commander/index.js
+// node_modules/commander/index.js
 var require_commander = __commonJS((exports) => {
   var { Argument } = require_argument();
   var { Command } = require_command();
@@ -2894,7 +2894,7 @@ async function upsertCloudflareDnsRecord(options) {
   return { id: created.id, action: "created" };
 }
 
-// node_modules/@hasna/events/dist/commander.js
+// node_modules/@hasna/events/dist/index.js
 import { chmod, mkdir, readFile, rename, writeFile } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
 import { homedir as homedir2 } from "os";
@@ -3413,172 +3413,8 @@ function normalizeRetryPolicy(policy) {
     multiplier: Math.max(1, policy?.multiplier ?? 2)
   };
 }
-function parseJsonObject2(value, fallback) {
-  if (!value)
-    return fallback;
-  const parsed = JSON.parse(value);
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error("Expected a JSON object");
-  }
-  return parsed;
-}
-function parseHeaders(values) {
-  if (!values?.length)
-    return;
-  const headers = {};
-  for (const value of values) {
-    const separator = value.indexOf("=");
-    if (separator === -1)
-      throw new Error(`Invalid header, expected name=value: ${value}`);
-    headers[value.slice(0, separator)] = value.slice(separator + 1);
-  }
-  return headers;
-}
-function parseFilter(options) {
-  const filter2 = {};
-  if (options.source)
-    filter2.source = options.source;
-  if (options.type)
-    filter2.type = options.type;
-  if (options.subject)
-    filter2.subject = options.subject;
-  if (options.severity)
-    filter2.severity = options.severity;
-  return Object.keys(filter2).length > 0 ? [filter2] : undefined;
-}
-function createClient(options) {
-  if (options.createClient)
-    return options.createClient();
-  return new EventsClient({ store: new JsonEventsStore(options.dataDir) });
-}
-function print(value, json2, text) {
-  if (json2)
-    console.log(JSON.stringify(value, null, 2));
-  else
-    console.log(text);
-}
-function hasJsonOption(options) {
-  return Boolean(options?.json || options?.opts?.().json || options?.optsWithGlobals?.().json || options?.parent?.opts?.().json || options?.parent?.optsWithGlobals?.().json);
-}
-function wantsJson(actionOptions, command) {
-  return hasJsonOption(actionOptions) || hasJsonOption(command);
-}
-function registerWebhookCommands(program, options) {
-  const webhooks = program.command(options.webhooksCommandName ?? "webhooks").description("Manage Hasna event webhook subscriptions");
-  webhooks.command("add").description("Add or replace a webhook or command subscription").argument("<target>", "Webhook URL or command binary").requiredOption("--id <id>", "Subscription/channel identifier").option("--transport <kind>", "Transport kind: webhook or command", "webhook").option("--name <name>", "Display name").option("--type <pattern>", "Event type filter, e.g. todos.task.*").option("--source <pattern>", "Event source filter").option("--subject <pattern>", "Event subject filter").option("--severity <pattern>", "Event severity filter").option("--secret <secret>", "Webhook HMAC secret").option("--header <name=value...>", "Webhook header", collectValues, []).option("--arg <arg...>", "Command argument", collectValues, []).option("--timeout-ms <ms>", "Transport timeout in milliseconds", parseNumber).option("--retry-attempts <n>", "Maximum delivery attempts", parseNumber).option("--retry-backoff-ms <ms>", "Initial retry backoff in milliseconds", parseNumber).option("--redact <path...>", "Event field path to redact before delivery", collectValues, []).option("--disabled", "Create channel disabled", false).option("-j, --json", "Print JSON output", false).action(async (target, actionOptions, command) => {
-    const timestamp = new Date().toISOString();
-    const channel = {
-      id: actionOptions.id,
-      name: actionOptions.name,
-      enabled: !actionOptions.disabled,
-      transport: actionOptions.transport,
-      filters: parseFilter(actionOptions),
-      retry: actionOptions.retryAttempts || actionOptions.retryBackoffMs ? { maxAttempts: actionOptions.retryAttempts, backoffMs: actionOptions.retryBackoffMs } : undefined,
-      redact: actionOptions.redact?.length ? { paths: actionOptions.redact } : undefined,
-      createdAt: timestamp,
-      updatedAt: timestamp
-    };
-    if (actionOptions.transport === "webhook") {
-      channel.webhook = { url: target, secret: actionOptions.secret, headers: parseHeaders(actionOptions.header), timeoutMs: actionOptions.timeoutMs };
-    } else if (actionOptions.transport === "command") {
-      channel.command = { command: target, args: actionOptions.arg ?? [], timeoutMs: actionOptions.timeoutMs };
-    } else {
-      throw new Error(`Transport ${actionOptions.transport} is reserved for future use and cannot be added yet`);
-    }
-    const saved = await createClient(options).addChannel(channel);
-    print(sanitizeChannelForOutput(saved), wantsJson(actionOptions, command), `Added ${saved.transport} channel ${saved.id}`);
-  });
-  webhooks.command("list").description("List configured subscriptions").option("-j, --json", "Print JSON output", false).action(async (actionOptions, command) => {
-    const channels = await createClient(options).listChannels();
-    if (wantsJson(actionOptions, command)) {
-      console.log(JSON.stringify(sanitizeChannelsForOutput(channels), null, 2));
-      return;
-    }
-    if (!channels.length) {
-      console.log("No channels configured.");
-      return;
-    }
-    for (const channel of channels) {
-      console.log(`${channel.id}	${channel.enabled ? "enabled" : "disabled"}	${channel.transport}	${channel.webhook?.url ?? channel.command?.command ?? channel.transport}`);
-    }
-  });
-  webhooks.command("remove").description("Remove a subscription").argument("<id>", "Subscription/channel identifier").option("-j, --json", "Print JSON output", false).action(async (id, actionOptions, command) => {
-    const removed = await createClient(options).removeChannel(id);
-    print({ removed }, wantsJson(actionOptions, command), removed ? `Removed ${id}` : `Channel not found: ${id}`);
-  });
-  webhooks.command("test").description("Send a test event to one subscription").argument("<id>", "Subscription/channel identifier").option("--type <type>", "Event type", "events.test").option("--subject <subject>", "Event subject").option("--message <message>", "Event message", "Hasna events test delivery").option("--data <json>", "Event data JSON object").option("-j, --json", "Print JSON output", false).action(async (id, actionOptions, command) => {
-    const result = await createClient(options).testChannel(id, {
-      source: options.source,
-      type: actionOptions.type,
-      subject: actionOptions.subject ?? id,
-      message: actionOptions.message,
-      data: parseJsonObject2(actionOptions.data, { test: true })
-    });
-    print(result, wantsJson(actionOptions, command), `${result.status}: ${result.channelId}`);
-  });
-  return webhooks;
-}
-function registerEventCommands(program, options) {
-  const events = program.command(options.eventsCommandName ?? "events").description("Emit, list, and replay Hasna events");
-  events.command("emit").description("Emit an event from this app").argument("<type>", "Event type").option("--source <source>", "Event source override").option("--subject <subject>", "Event subject").option("--severity <severity>", "Event severity", "info").option("--message <message>", "Event message").option("--dedupe-key <key>", "Dedupe key").option("--data <json>", "Event data JSON object").option("--metadata <json>", "Event metadata JSON object").option("--no-deliver", "Record without delivering").option("--no-dedupe", "Allow duplicate id/dedupeKey events").option("-j, --json", "Print JSON output", false).action(async (type, actionOptions, command) => {
-    const result = await createClient(options).emit({
-      source: actionOptions.source ?? options.source,
-      type,
-      subject: actionOptions.subject,
-      severity: actionOptions.severity,
-      message: actionOptions.message,
-      dedupeKey: actionOptions.dedupeKey,
-      data: parseJsonObject2(actionOptions.data, {}),
-      metadata: parseJsonObject2(actionOptions.metadata, {})
-    }, { deliver: actionOptions.deliver, dedupe: actionOptions.dedupe });
-    print(result, wantsJson(actionOptions, command), `${result.deduped ? "Deduped" : "Emitted"} ${result.event.id} to ${result.deliveries.length} channel(s)`);
-  });
-  events.command("list").description("List recorded events").option("--source <source>", "Filter by source").option("--type <type>", "Filter by type").option("--limit <n>", "Limit results", parseNumber).option("-j, --json", "Print JSON output", false).action(async (actionOptions, command) => {
-    let rows = await createClient(options).listEvents();
-    if (actionOptions.source)
-      rows = rows.filter((event) => event.source === actionOptions.source);
-    if (actionOptions.type)
-      rows = rows.filter((event) => event.type === actionOptions.type);
-    if (actionOptions.limit)
-      rows = rows.slice(-actionOptions.limit);
-    if (wantsJson(actionOptions, command)) {
-      console.log(JSON.stringify(rows, null, 2));
-      return;
-    }
-    if (!rows.length) {
-      console.log("No events recorded.");
-      return;
-    }
-    for (const event of rows)
-      console.log(`${event.time}	${event.id}	${event.source}	${event.type}	${event.severity}`);
-  });
-  events.command("replay").description("Replay recorded events").option("--id <id>", "Replay one event id").option("--source <source>", "Filter by source").option("--type <type>", "Filter by type").option("--dry-run", "Preview without delivery", false).option("-j, --json", "Print JSON output", false).action(async (actionOptions, command) => {
-    const result = await createClient(options).replay({
-      eventId: actionOptions.id,
-      source: actionOptions.source,
-      type: actionOptions.type,
-      dryRun: actionOptions.dryRun
-    });
-    print(result, wantsJson(actionOptions, command), `Replayed ${result.events.length} event(s), ${result.deliveries.length} delivery result(s)`);
-  });
-  return events;
-}
-function registerEventsCommands(program, options) {
-  registerWebhookCommands(program, options);
-  registerEventCommands(program, options);
-}
-function parseNumber(value) {
-  const parsed = Number(value);
-  if (!Number.isFinite(parsed))
-    throw new Error(`Expected a number, got ${value}`);
-  return parsed;
-}
-function collectValues(value, previous) {
-  previous.push(value);
-  return previous;
-}
 
-// node_modules/.pnpm/commander@13.1.0/node_modules/commander/esm.mjs
+// node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
   program,
@@ -3594,7 +3430,7 @@ var {
   Help
 } = import__.default;
 
-// node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/vendor/ansi-styles/index.js
+// node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
 var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
 var wrapAnsi256 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
@@ -3771,7 +3607,7 @@ function assembleStyles() {
 var ansiStyles = assembleStyles();
 var ansi_styles_default = ansiStyles;
 
-// node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/vendor/supports-color/index.js
+// node_modules/chalk/source/vendor/supports-color/index.js
 import process2 from "process";
 import os from "os";
 import tty from "tty";
@@ -3903,7 +3739,7 @@ var supportsColor = {
 };
 var supports_color_default = supportsColor;
 
-// node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/utilities.js
+// node_modules/chalk/source/utilities.js
 function stringReplaceAll(string, substring, replacer) {
   let index = string.indexOf(substring);
   if (index === -1) {
@@ -3936,7 +3772,7 @@ function stringEncaseCRLFWithFirstIndex(string, prefix, postfix, index) {
   return returnValue;
 }
 
-// node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/index.js
+// node_modules/chalk/source/index.js
 var { stdout: stdoutColor, stderr: stderrColor } = supports_color_default;
 var GENERATOR = Symbol("GENERATOR");
 var STYLER = Symbol("STYLER");
@@ -4089,7 +3925,7 @@ import { dirname as dirname3, join as join6 } from "path";
 import { fileURLToPath } from "url";
 import { spawnSync as spawnSync3 } from "child_process";
 
-// node_modules/.pnpm/@hasna+contracts@0.5.2/node_modules/@hasna/contracts/dist/client/storage.js
+// node_modules/@hasna/contracts/dist/client/storage.js
 var __defProp2 = Object.defineProperty;
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
@@ -10797,7 +10633,7 @@ var program2 = new Command;
 function useJson(localOpts) {
   return Boolean(localOpts?.json || program2.opts().json);
 }
-function print2(data, localOpts, human) {
+function print(data, localOpts, human) {
   if (useJson(localOpts)) {
     console.log(JSON.stringify(data, null, 2));
     return;
@@ -10822,13 +10658,335 @@ async function withRuntimeStore(fn) {
     await store.close();
   }
 }
-function formatLink(link) {
-  return `${source_default.green(link.short_url || `${link.hostname}/${link.slug}`)} ${source_default.dim("->")} ${link.destination_url}`;
-}
 function commandExists(command) {
   const result = spawnSync3("which", [command], { encoding: "utf-8" });
   return result.status === 0;
 }
+var DEFAULT_HUMAN_LIMIT = 20;
+var DEFAULT_JSON_LIMIT = 100;
+var TEXT_LIMIT = 88;
+var EXTERNAL_OUTPUT_LIMIT = 20;
+var EXTERNAL_OUTPUT_WIDTH = 120;
+function parseLimit(value, fallback, label = "--limit") {
+  if (value === undefined || value === null || value === "")
+    return fallback;
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed <= 0)
+    throw new Error(`${label} must be a positive integer.`);
+  return parsed;
+}
+function humanLimit(opts) {
+  return parseLimit(opts.limit, DEFAULT_HUMAN_LIMIT);
+}
+function jsonLimit(opts) {
+  return opts.limit === undefined ? undefined : parseLimit(opts.limit, DEFAULT_JSON_LIMIT);
+}
+function truncateText(value, max = TEXT_LIMIT) {
+  const text = value || "";
+  return text.length > max ? `${text.slice(0, Math.max(0, max - 3))}...` : text;
+}
+function yesNo(value) {
+  return value ? "yes" : "no";
+}
+function printHint(message) {
+  console.log(source_default.dim(message));
+}
+function printVerbose(data, opts) {
+  if (!opts.verbose)
+    return false;
+  console.log(JSON.stringify(data, null, 2));
+  return true;
+}
+function formatLink(link, maxDestinationLength = 72) {
+  return `${source_default.green(link.short_url || `${link.hostname}/${link.slug}`)} ${source_default.dim("->")} ${truncateText(link.destination_url, maxDestinationLength)}`;
+}
+function printBoundedTextOutput(text, stream) {
+  const lines = text.trim().split(/\r?\n/).filter(Boolean);
+  let truncated = lines.length > EXTERNAL_OUTPUT_LIMIT;
+  for (const line of lines.slice(0, EXTERNAL_OUTPUT_LIMIT)) {
+    const output = truncateText(line, EXTERNAL_OUTPUT_WIDTH);
+    if (output !== line)
+      truncated = true;
+    if (stream === "stderr")
+      console.error(output);
+    else
+      console.log(output);
+  }
+  return truncated;
+}
+function printExternalCommandResult(result, opts, label) {
+  if (opts.verbose) {
+    if (result.stdout.trim())
+      console.log(result.stdout.trim());
+    if (result.stderr.trim())
+      console.error(result.stderr.trim());
+    return;
+  }
+  const stdoutTruncated = result.stdout.trim() ? printBoundedTextOutput(result.stdout, "stdout") : false;
+  const stderrTruncated = result.stderr.trim() ? printBoundedTextOutput(result.stderr, "stderr") : false;
+  if (stdoutTruncated || stderrTruncated)
+    printHint(`Use --verbose or --json for full ${label} command output.`);
+}
+function printDomainSummary(domain) {
+  console.log(`${domain.default_domain ? "*" : " "} ${domain.hostname} ${source_default.dim(domain.provider)} default=${yesNo(domain.default_domain)}`);
+  if (domain.origin_url)
+    console.log(`  origin: ${truncateText(domain.origin_url)}`);
+  if (domain.cloudflare_worker_name)
+    console.log(`  worker: ${domain.cloudflare_worker_name}`);
+  printHint("Use `shortlinks domain get <hostname> --verbose` or `--json` for full details.");
+}
+function printLinkSummary(link) {
+  console.log(formatLink(link));
+  console.log(`  slug: ${link.slug}`);
+  console.log(`  domain: ${link.hostname}`);
+  console.log(`  active: ${yesNo(link.active)}`);
+  if (link.title)
+    console.log(`  title: ${truncateText(link.title)}`);
+  if (link.expires_at)
+    console.log(`  expires: ${link.expires_at}`);
+  printHint("Use `shortlinks link get <slug> --verbose` or `--json` for full details.");
+}
+function printStatsSummary(stats) {
+  if ("link" in stats) {
+    console.log(`${stats.link.short_url || `${stats.link.hostname}/${stats.link.slug}`} clicks=${stats.clicks}`);
+    console.log(`  destination: ${truncateText(stats.link.destination_url)}`);
+    console.log(`  last clicked: ${stats.last_clicked_at || "never"}`);
+    const topReferrer = stats.top_referrers[0];
+    const topAgent = stats.top_user_agents[0];
+    if (topReferrer)
+      console.log(`  top referrer: ${truncateText(topReferrer.referer || "(direct)", 72)} (${topReferrer.clicks})`);
+    if (topAgent)
+      console.log(`  top user agent: ${truncateText(topAgent.user_agent || "(unknown)", 72)} (${topAgent.clicks})`);
+    printHint("Use `shortlinks stats <slug> --verbose` or `--json` for full stats.");
+    return;
+  }
+  console.log(`domains=${stats.domains} links=${stats.links} clicks=${stats.clicks}`);
+}
+function printConfigSummary(data) {
+  const config = data.config;
+  console.log("shortlinks config");
+  console.log(`  path: ${data.path}`);
+  console.log(`  default domain: ${config.defaultDomain || "(unset)"}`);
+  console.log(`  public base URL: ${config.publicBaseUrl || "(unset)"}`);
+  if (config.cloudflare) {
+    console.log(`  cloudflare worker: ${config.cloudflare.workerName || "(unset)"}`);
+    console.log(`  cloudflare origin: ${config.cloudflare.origin || "(unset)"}`);
+  }
+  printHint("Use `shortlinks config show --verbose` or `--json` for full config.");
+}
+function printCloudflarePlanSummary(plan) {
+  console.log(`Cloudflare plan for ${plan.hostname}`);
+  console.log(`  CNAME: ${plan.hostname} -> ${plan.target} proxied=${yesNo(plan.proxied)}`);
+  console.log(`  worker: ${plan.workerName}`);
+  console.log(`  origin: ${truncateText(plan.origin)}`);
+  console.log(`  deploy: ${plan.wranglerCommand}`);
+  printHint("Use `--verbose` or `--json` for the full DNS payload.");
+}
+function printCloudflareDnsSummary(result) {
+  if (result && typeof result === "object" && "dnsRecord" in result) {
+    printCloudflarePlanSummary(result);
+    return;
+  }
+  const value = result;
+  console.log(`Cloudflare DNS ${value.action || "updated"} ${value.id || ""}`.trim());
+  printHint("Use `--json` for the full API result.");
+}
+function printLocalPlanSummary(plan) {
+  console.log(`Local plan for ${plan.domain}`);
+  console.log(`  target: ${plan.targetHost}:${plan.port}`);
+  console.log(`  hosts: ${plan.hostsEntry}`);
+  console.log(`  cert: ${truncateText(plan.certPath)}`);
+  console.log(`  key: ${truncateText(plan.keyPath)}`);
+  console.log(`  machines: ${plan.machinesCommand}`);
+  printHint("Use `--verbose` or `--json` for the full Caddy snippet.");
+}
+function printDoctorSummary(data) {
+  const missingCommands = Object.entries(data.commands).filter(([, present]) => !present).map(([name]) => name);
+  const presentEnv = Object.entries(data.environment).filter(([, present]) => present).map(([name]) => name);
+  console.log(`${data.service} doctor`);
+  console.log(`  store: ${data.store}`);
+  console.log(`  db: ${data.db_exists ? "found" : "missing"} ${truncateText(data.db_path)}`);
+  console.log(`  stats: domains=${data.stats.domains} links=${data.stats.links} clicks=${data.stats.clicks}`);
+  console.log(`  commands: ${missingCommands.length ? `missing ${missingCommands.join(", ")}` : "ok"}`);
+  console.log(`  env: ${presentEnv.length ? presentEnv.join(", ") : "no optional env vars detected"}`);
+  printHint("Use `shortlinks doctor --verbose` or `--json` for paths and full readiness data.");
+}
+function parseNumber(value) {
+  if (value === undefined)
+    return;
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed))
+    throw new Error(`Expected a number, got ${value}`);
+  return parsed;
+}
+function collectValues(value, previous = []) {
+  return [...previous, value];
+}
+function parseJsonObject2(value, fallback = {}) {
+  if (!value)
+    return fallback;
+  const parsed = JSON.parse(value);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("Expected a JSON object.");
+  }
+  return parsed;
+}
+function parseHeaders(values = []) {
+  const headers = {};
+  for (const value of values) {
+    const index = value.indexOf("=");
+    if (index <= 0)
+      throw new Error(`Header must be name=value: ${value}`);
+    headers[value.slice(0, index)] = value.slice(index + 1);
+  }
+  return headers;
+}
+function parseEventFilter(opts) {
+  const filter = {};
+  if (opts.type)
+    filter.type = opts.type;
+  if (opts.source)
+    filter.source = opts.source;
+  if (opts.subject)
+    filter.subject = opts.subject;
+  if (opts.severity)
+    filter.severity = opts.severity;
+  return Object.keys(filter).length ? [filter] : [];
+}
+function createEventsClient() {
+  return new EventsClient;
+}
+function formatEventRow(event) {
+  return `${event.time}	${event.id}	${event.source}	${event.type}	${event.severity}${event.subject ? `	${truncateText(event.subject, 48)}` : ""}`;
+}
+function formatChannelTarget(channel) {
+  return channel.webhook?.url ?? channel.command?.command ?? channel.transport;
+}
+function registerCompactEventsCommands(program3) {
+  const webhooks = program3.command("webhooks").description("Manage Hasna event webhook subscriptions");
+  webhooks.command("add").description("Add or replace a webhook or command subscription").argument("<target>", "Webhook URL or command binary").requiredOption("--id <id>", "Subscription/channel identifier").option("--transport <kind>", "Transport kind: webhook or command", "webhook").option("--name <name>", "Display name").option("--type <pattern>", "Event type filter, e.g. todos.task.*").option("--source <pattern>", "Event source filter").option("--subject <pattern>", "Event subject filter").option("--severity <pattern>", "Event severity filter").option("--secret <secret>", "Webhook HMAC secret").option("--header <name=value...>", "Webhook header", collectValues, []).option("--arg <arg...>", "Command argument", collectValues, []).option("--timeout-ms <ms>", "Transport timeout in milliseconds", parseNumber).option("--retry-attempts <n>", "Maximum delivery attempts", parseNumber).option("--retry-backoff-ms <ms>", "Initial retry backoff in milliseconds", parseNumber).option("--redact <path...>", "Event field path to redact before delivery", collectValues, []).option("--disabled", "Create channel disabled", false).option("-j, --json", "Output JSON").action(async (target, opts) => {
+    try {
+      const transport = opts.transport;
+      const channel = {
+        id: opts.id,
+        name: opts.name,
+        enabled: !opts.disabled,
+        transport,
+        filters: parseEventFilter(opts),
+        retry: opts.retryAttempts || opts.retryBackoffMs ? { maxAttempts: opts.retryAttempts, backoffMs: opts.retryBackoffMs } : undefined,
+        redact: opts.redact?.length ? { paths: opts.redact } : undefined
+      };
+      if (transport === "webhook") {
+        channel.webhook = { url: target, secret: opts.secret, headers: parseHeaders(opts.header), timeoutMs: opts.timeoutMs };
+      } else if (transport === "command") {
+        channel.command = { command: target, args: opts.arg ?? [], timeoutMs: opts.timeoutMs };
+      } else {
+        throw new Error(`Transport ${transport} is reserved for future use and cannot be added yet.`);
+      }
+      const saved = sanitizeChannelForOutput(await createEventsClient().addChannel(channel));
+      print(saved, opts, () => console.log(`Added ${saved.transport} channel ${saved.id}`));
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  webhooks.command("list").description("List configured subscriptions").option("--limit <n>", "Maximum rows").option("-j, --json", "Output JSON").action(async (opts) => {
+    try {
+      const channels = sanitizeChannelsForOutput(await createEventsClient().listChannels());
+      const outputChannels = useJson(opts) && opts.limit === undefined ? channels : channels.slice(0, useJson(opts) ? parseLimit(opts.limit, channels.length) : humanLimit(opts));
+      print(outputChannels, opts, () => {
+        if (!channels.length) {
+          console.log("No channels configured.");
+          return;
+        }
+        for (const channel of outputChannels) {
+          console.log(`${channel.id}	${channel.enabled ? "enabled" : "disabled"}	${channel.transport}	${truncateText(formatChannelTarget(channel), 80)}`);
+        }
+        console.log(source_default.dim(`Showing ${outputChannels.length} of ${channels.length} channel(s).`));
+        if (channels.length > outputChannels.length)
+          printHint(`Use --limit ${channels.length} or --json for more.`);
+      });
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  webhooks.command("remove").description("Remove a subscription").argument("<id>", "Subscription/channel identifier").option("-j, --json", "Output JSON").action(async (id, opts) => {
+    try {
+      const removed = await createEventsClient().removeChannel(id);
+      print({ removed }, opts, () => console.log(removed ? `Removed ${id}` : `Channel not found: ${id}`));
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  webhooks.command("test").description("Send a test event to one subscription").argument("<id>", "Subscription/channel identifier").option("--type <type>", "Event type", "events.test").option("--subject <subject>", "Event subject").option("--message <message>", "Event message", "Hasna events test delivery").option("--data <json>", "Event data JSON object").option("-j, --json", "Output JSON").action(async (id, opts) => {
+    try {
+      const result = await createEventsClient().testChannel(id, {
+        source: "shortlinks",
+        type: opts.type,
+        subject: opts.subject ?? id,
+        message: opts.message,
+        data: parseJsonObject2(opts.data, { test: true })
+      });
+      print(result, opts, () => console.log(`${result.status}: ${result.channelId}`));
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  const events = program3.command("events").description("Emit, list, and replay Hasna events");
+  events.command("emit").description("Emit an event from this app").argument("<type>", "Event type").option("--source <source>", "Event source override").option("--subject <subject>", "Event subject").option("--severity <severity>", "Event severity", "info").option("--message <message>", "Event message").option("--dedupe-key <key>", "Dedupe key").option("--data <json>", "Event data JSON object").option("--metadata <json>", "Event metadata JSON object").option("--no-deliver", "Record without delivering").option("--no-dedupe", "Allow duplicate id/dedupeKey events").option("-j, --json", "Output JSON").action(async (type, opts) => {
+    try {
+      const result = await createEventsClient().emit({
+        source: opts.source ?? "shortlinks",
+        type,
+        subject: opts.subject,
+        severity: opts.severity,
+        message: opts.message,
+        dedupeKey: opts.dedupeKey,
+        data: parseJsonObject2(opts.data, {}),
+        metadata: parseJsonObject2(opts.metadata, {})
+      }, { deliver: opts.deliver, dedupe: opts.dedupe });
+      print(result, opts, () => console.log(`${result.deduped ? "Deduped" : "Emitted"} ${result.event.id} to ${result.deliveries.length} channel(s)`));
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  events.command("list").description("List recorded events").option("--source <source>", "Filter by source").option("--type <type>", "Filter by type").option("--limit <n>", "Maximum rows").option("-j, --json", "Output JSON").action(async (opts) => {
+    try {
+      let rows = await createEventsClient().listEvents();
+      if (opts.source)
+        rows = rows.filter((event) => event.source === opts.source);
+      if (opts.type)
+        rows = rows.filter((event) => event.type === opts.type);
+      const limit = useJson(opts) ? jsonLimit(opts) : humanLimit(opts);
+      const outputRows = limit === undefined ? rows : rows.slice(-limit);
+      print(outputRows, opts, () => {
+        if (!rows.length) {
+          console.log("No events recorded.");
+          return;
+        }
+        for (const event of outputRows)
+          console.log(formatEventRow(event));
+        console.log(source_default.dim(`Showing ${outputRows.length} of ${rows.length} event(s).`));
+        if (rows.length > outputRows.length)
+          printHint(`Use --limit ${rows.length} or --json for more.`);
+      });
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  events.command("replay").description("Replay recorded events").option("--id <id>", "Replay one event id").option("--source <source>", "Filter by source").option("--type <type>", "Filter by type").option("--dry-run", "Preview without delivery", false).option("-j, --json", "Output JSON").action(async (opts) => {
+    try {
+      const result = await createEventsClient().replay({
+        eventId: opts.id,
+        source: opts.source,
+        type: opts.type,
+        dryRun: opts.dryRun
+      });
+      print(result, opts, () => console.log(`Replayed ${result.events.length} event(s), ${result.deliveries.length} delivery result(s)`));
+    } catch (error) {
+      handleError(error);
+    }
+  });
+}
 program2.name("shortlinks").description("Shortlink manager with custom domains, click tracking, and Cloudflare helpers \u2014 local SQLite or self-hosted cloud /v1 API storage").version(getPackageVersion()).option("--db <path>", "SQLite database path (local mode only)").option("-j, --json", "Output JSON for agents and scripts");
 program2.command("init").description("Initialize local shortlinks storage").option("--domain <hostname>", "Add a default shortlink domain").option("--public-base-url <url>", "Public URL base for generated links").option("-j, --json", "Output JSON").action(async (opts) => {
   try {
@@ -10856,7 +11014,7 @@ program2.command("init").description("Initialize local shortlinks storage").opti
         stats: await store.totalStats()
       };
     });
-    print2(result, opts, () => {
+    print(result, opts, () => {
       console.log(source_default.green("shortlinks initialized"));
       console.log(`  Data: ${result.data_dir}`);
       console.log(`  DB: ${result.db_path}`);
@@ -10868,9 +11026,13 @@ program2.command("init").description("Initialize local shortlinks storage").opti
   }
 });
 var configCmd = program2.command("config").description("View and update local config");
-configCmd.command("show").description("Show local config").option("-j, --json", "Output JSON").action((opts) => {
+configCmd.command("show").description("Show local config").option("--verbose", "Show full config object").option("-j, --json", "Output JSON").action((opts) => {
   const data = { path: getConfigPath(), config: loadConfig() };
-  print2(data, opts, () => console.log(JSON.stringify(data, null, 2)));
+  print(data, opts, () => {
+    if (printVerbose(data, opts))
+      return;
+    printConfigSummary(data);
+  });
 });
 configCmd.command("set <key> <value>").description("Set config value: default-domain, public-base-url, cloudflare-account-id, cloudflare-worker-name, cloudflare-origin").option("-j, --json", "Output JSON").action((key, value, opts) => {
   try {
@@ -10894,7 +11056,7 @@ configCmd.command("set <key> <value>").description("Set config value: default-do
       default:
         throw new Error(`Unknown config key: ${key}`);
     }
-    print2({ path: getConfigPath(), config }, opts, () => console.log(source_default.green(`Set ${key}.`)));
+    print({ path: getConfigPath(), config }, opts, () => console.log(source_default.green(`Set ${key}.`)));
   } catch (error) {
     handleError(error);
   }
@@ -10912,7 +11074,7 @@ domainCmd.command("add <hostname>").description("Add or update a custom domain")
       originUrl: opts.origin,
       notes: opts.notes
     }));
-    print2(domain, opts, () => {
+    print(domain, opts, () => {
       console.log(source_default.green(`Domain ready: ${domain.hostname}`));
       if (domain.default_domain)
         console.log(source_default.dim("Default domain updated."));
@@ -10921,10 +11083,12 @@ domainCmd.command("add <hostname>").description("Add or update a custom domain")
     handleError(error);
   }
 });
-domainCmd.command("list").description("List configured domains").option("-j, --json", "Output JSON").action(async (opts) => {
+domainCmd.command("list").description("List configured domains").option("--limit <n>", "Maximum rows").option("-j, --json", "Output JSON").action(async (opts) => {
   try {
-    const domains = await withRuntimeStore((store) => store.listDomains());
-    print2(domains, opts, () => {
+    const allDomains = await withRuntimeStore((store) => store.listDomains());
+    const outputDomains = useJson(opts) && opts.limit === undefined ? allDomains : allDomains.slice(0, useJson(opts) ? parseLimit(opts.limit, allDomains.length) : humanLimit(opts));
+    print(outputDomains, opts, () => {
+      const domains = outputDomains;
       if (domains.length === 0) {
         console.log(source_default.dim("No domains configured."));
         return;
@@ -10933,17 +11097,25 @@ domainCmd.command("list").description("List configured domains").option("-j, --j
         const marker = domain.default_domain ? source_default.green("*") : " ";
         console.log(`${marker} ${domain.hostname} ${source_default.dim(domain.provider)}`);
       }
+      console.log(source_default.dim(`Showing ${domains.length} of ${allDomains.length} domain(s).`));
+      if (allDomains.length > domains.length)
+        printHint(`Use --limit ${allDomains.length} or --json for more.`);
+      printHint("Use `shortlinks domain get <hostname>` for details.");
     });
   } catch (error) {
     handleError(error);
   }
 });
-domainCmd.command("get <hostname>").description("Show a configured domain").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
+domainCmd.command("get <hostname>").alias("show").description("Show a configured domain").option("--verbose", "Show full domain object").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
   try {
     const domain = await withRuntimeStore((store) => store.getDomain(hostname2));
     if (!domain)
       throw new Error("Domain not found.");
-    print2(domain, opts, () => console.log(JSON.stringify(domain, null, 2)));
+    print(domain, opts, () => {
+      if (printVerbose(domain, opts))
+        return;
+      printDomainSummary(domain);
+    });
   } catch (error) {
     handleError(error);
   }
@@ -10951,7 +11123,7 @@ domainCmd.command("get <hostname>").description("Show a configured domain").opti
 domainCmd.command("remove <hostname>").alias("delete").alias("rm").description("Delete a domain and all of its links and clicks").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
   try {
     const domain = await withRuntimeStore((store) => store.deleteDomain(hostname2));
-    print2({ deleted: true, hostname: domain.hostname }, opts, () => {
+    print({ deleted: true, hostname: domain.hostname }, opts, () => {
       console.log(source_default.green(`Domain removed: ${domain.hostname}`));
       console.log(source_default.dim("Its links and clicks were deleted."));
     });
@@ -10959,7 +11131,7 @@ domainCmd.command("remove <hostname>").alias("delete").alias("rm").description("
     handleError(error);
   }
 });
-domainCmd.command("setup <hostname>").description("Add a domain locally and optionally prepare Cloudflare DNS").option("--default", "Make this the default domain").option("--origin <url>", "Origin redirect server URL").option("--cloudflare", "Upsert Cloudflare CNAME record").option("--target <hostname>", "CNAME target for Cloudflare DNS").option("--zone-id <id>", "Cloudflare zone ID").option("--dry-run", "Show the Cloudflare plan without changing DNS").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
+domainCmd.command("setup <hostname>").description("Add a domain locally and optionally prepare Cloudflare DNS").option("--default", "Make this the default domain").option("--origin <url>", "Origin redirect server URL").option("--cloudflare", "Upsert Cloudflare CNAME record").option("--target <hostname>", "CNAME target for Cloudflare DNS").option("--zone-id <id>", "Cloudflare zone ID").option("--dry-run", "Show the Cloudflare plan without changing DNS").option("--verbose", "Show full setup result").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
   try {
     const result = await withRuntimeStore(async (store) => {
       const domain = await store.addDomain({
@@ -10976,33 +11148,31 @@ domainCmd.command("setup <hostname>").description("Add a domain locally and opti
       }) : null;
       return { domain, cloudflare };
     });
-    print2(result, opts, () => {
+    print(result, opts, () => {
+      if (printVerbose(result, opts))
+        return;
       console.log(source_default.green(`Domain ready: ${result.domain.hostname}`));
       if (result.cloudflare)
-        console.log(JSON.stringify(result.cloudflare, null, 2));
+        printCloudflareDnsSummary(result.cloudflare);
+      if (!result.cloudflare)
+        printHint("Use --cloudflare --dry-run to preview DNS changes.");
     });
   } catch (error) {
     handleError(error);
   }
 });
-domainCmd.command("check <hostname>").description("Check domain availability through @hasna/domains").option("--dry-run", "Print the command without running it").option("-j, --json", "Output JSON").action((hostname2, opts) => {
+domainCmd.command("check <hostname>").description("Check domain availability through @hasna/domains").option("--dry-run", "Print the command without running it").option("--verbose", "Show full domains CLI output").option("-j, --json", "Output JSON").action((hostname2, opts) => {
   const result = runDomains("check", hostname2, { dryRun: opts.dryRun });
-  print2(result, opts, () => {
-    if (result.stdout.trim())
-      console.log(result.stdout.trim());
-    if (result.stderr.trim())
-      console.error(result.stderr.trim());
+  print(result, opts, () => {
+    printExternalCommandResult(result, opts, "domains check");
     if (result.status !== 0)
       process.exit(result.status || 1);
   });
 });
-domainCmd.command("buy <hostname>").description("Buy a domain through @hasna/domains / Route 53").option("--dry-run", "Print the command without running it").option("-j, --json", "Output JSON").action((hostname2, opts) => {
+domainCmd.command("buy <hostname>").description("Buy a domain through @hasna/domains / Route 53").option("--dry-run", "Print the command without running it").option("--verbose", "Show full domains CLI output").option("-j, --json", "Output JSON").action((hostname2, opts) => {
   const result = runDomains("buy", hostname2, { dryRun: opts.dryRun });
-  print2(result, opts, () => {
-    if (result.stdout.trim())
-      console.log(result.stdout.trim());
-    if (result.stderr.trim())
-      console.error(result.stderr.trim());
+  print(result, opts, () => {
+    printExternalCommandResult(result, opts, "domains buy");
     if (result.status !== 0)
       process.exit(result.status || 1);
   });
@@ -11018,38 +11188,51 @@ async function createLinkAction(url, opts) {
       expiresAt: opts.expires,
       slugLength: opts.length ? Number(opts.length) : undefined
     }));
-    print2(link, opts, () => console.log(formatLink(link)));
+    print(link, opts, () => console.log(formatLink(link)));
   } catch (error) {
     handleError(error);
   }
 }
 linkCmd.command("create <url>").description("Create a shortlink").option("--domain <hostname>", "Domain to use").option("--slug <slug>", "Custom slug").option("--title <title>", "Human title").option("--expires <date>", "Expiration date").option("--length <n>", "Generated slug length", "7").option("-j, --json", "Output JSON").action(createLinkAction);
 program2.command("create <url>").description("Create a shortlink").option("--domain <hostname>", "Domain to use").option("--slug <slug>", "Custom slug").option("--title <title>", "Human title").option("--expires <date>", "Expiration date").option("--length <n>", "Generated slug length", "7").option("-j, --json", "Output JSON").action(createLinkAction);
-linkCmd.command("list").description("List shortlinks").option("--domain <hostname>", "Filter by domain").option("--active", "Only active links").option("--limit <n>", "Maximum rows", "100").option("-j, --json", "Output JSON").action(async (opts) => {
+linkCmd.command("list").description("List shortlinks").option("--domain <hostname>", "Filter by domain").option("--active", "Only active links").option("--limit <n>", "Maximum rows").option("-j, --json", "Output JSON").action(async (opts) => {
   try {
+    const requestedLimit = useJson(opts) ? jsonLimit(opts) : humanLimit(opts) + 1;
     const links = await withRuntimeStore((store) => store.listLinks({
       domain: opts.domain,
       activeOnly: opts.active,
-      limit: Number(opts.limit)
+      limit: requestedLimit
     }));
-    print2(links, opts, () => {
+    print(links, opts, () => {
       if (links.length === 0) {
         console.log(source_default.dim("No links yet."));
         return;
       }
-      for (const link of links)
-        console.log(formatLink(link));
+      const limit = humanLimit(opts);
+      const displayed = links.slice(0, limit);
+      for (const link of displayed) {
+        const status = link.active ? "active" : "disabled";
+        console.log(`${formatLink(link)} ${source_default.dim(status)}`);
+      }
+      console.log(source_default.dim(`Showing ${displayed.length}${links.length > displayed.length ? "+" : ""} link(s).`));
+      if (links.length > displayed.length)
+        printHint(`Use --limit ${limit * 2} or --json to see more rows.`);
+      printHint("Use `shortlinks link get <slug>` for details.");
     });
   } catch (error) {
     handleError(error);
   }
 });
-linkCmd.command("get <slug>").description("Show a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action(async (slug, opts) => {
+linkCmd.command("get <slug>").alias("show").description("Show a shortlink").option("--domain <hostname>", "Domain to use").option("--verbose", "Show full shortlink object").option("-j, --json", "Output JSON").action(async (slug, opts) => {
   try {
     const link = await withRuntimeStore((store) => opts.domain ? store.getLink(opts.domain, slug) : store.getLink(slug));
     if (!link)
       throw new Error("Link not found.");
-    print2(link, opts, () => console.log(JSON.stringify(link, null, 2)));
+    print(link, opts, () => {
+      if (printVerbose(link, opts))
+        return;
+      printLinkSummary(link);
+    });
   } catch (error) {
     handleError(error);
   }
@@ -11057,7 +11240,7 @@ linkCmd.command("get <slug>").description("Show a shortlink").option("--domain <
 linkCmd.command("disable <slug>").description("Disable a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action(async (slug, opts) => {
   try {
     const link = await withRuntimeStore((store) => opts.domain ? store.setLinkActive(opts.domain, slug, false) : store.setLinkActive(slug, false));
-    print2(link, opts, () => console.log(source_default.green(`Disabled ${link.short_url}`)));
+    print(link, opts, () => console.log(source_default.green(`Disabled ${link.short_url}`)));
   } catch (error) {
     handleError(error);
   }
@@ -11065,7 +11248,7 @@ linkCmd.command("disable <slug>").description("Disable a shortlink").option("--d
 linkCmd.command("enable <slug>").description("Enable a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action(async (slug, opts) => {
   try {
     const link = await withRuntimeStore((store) => opts.domain ? store.setLinkActive(opts.domain, slug, true) : store.setLinkActive(slug, true));
-    print2(link, opts, () => console.log(source_default.green(`Enabled ${link.short_url}`)));
+    print(link, opts, () => console.log(source_default.green(`Enabled ${link.short_url}`)));
   } catch (error) {
     handleError(error);
   }
@@ -11073,7 +11256,7 @@ linkCmd.command("enable <slug>").description("Enable a shortlink").option("--dom
 linkCmd.command("delete <slug>").description("Delete a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action(async (slug, opts) => {
   try {
     const link = await withRuntimeStore((store) => opts.domain ? store.deleteLink(opts.domain, slug) : store.deleteLink(slug));
-    print2(link, opts, () => console.log(source_default.green(`Deleted ${link.short_url}`)));
+    print(link, opts, () => console.log(source_default.green(`Deleted ${link.short_url}`)));
   } catch (error) {
     handleError(error);
   }
@@ -11083,19 +11266,23 @@ program2.command("resolve <slug>").description("Resolve a slug to its destinatio
     const link = await withRuntimeStore((store) => opts.domain ? store.getLink(opts.domain, slug) : store.getLink(slug));
     if (!link)
       throw new Error("Link not found.");
-    print2(link, opts, () => console.log(link.destination_url));
+    print(link, opts, () => console.log(link.destination_url));
   } catch (error) {
     handleError(error);
   }
 });
-program2.command("stats [slug]").description("Show overall stats or stats for a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action(async (slug, opts) => {
+program2.command("stats [slug]").description("Show overall stats or stats for a shortlink").option("--domain <hostname>", "Domain to use").option("--verbose", "Show full stats object").option("-j, --json", "Output JSON").action(async (slug, opts) => {
   try {
     const result = await withRuntimeStore((store) => {
       if (slug)
         return opts.domain ? store.getStats(opts.domain, slug) : store.getStats(slug);
       return store.totalStats();
     });
-    print2(result, opts, () => console.log(JSON.stringify(result, null, 2)));
+    print(result, opts, () => {
+      if (printVerbose(result, opts))
+        return;
+      printStatsSummary(result);
+    });
   } catch (error) {
     handleError(error);
   }
@@ -11115,7 +11302,7 @@ program2.command("serve").description("Run the on-box redirect server that recor
   }
 });
 var cfCmd = program2.command("cloudflare").description("Cloudflare DNS and Worker helpers");
-cfCmd.command("plan <hostname>").description("Print the Cloudflare setup plan").requiredOption("--target <hostname>", "CNAME target").option("--origin <url>", "Origin redirect server URL", process.env.SHORTLINKS_ORIGIN || "https://shortlinks.example.com").option("--worker <name>", "Worker name", "shortlinks").option("--no-proxied", "Create unproxied DNS record").option("-j, --json", "Output JSON").action((hostname2, opts) => {
+cfCmd.command("plan <hostname>").description("Print the Cloudflare setup plan").requiredOption("--target <hostname>", "CNAME target").option("--origin <url>", "Origin redirect server URL", process.env.SHORTLINKS_ORIGIN || "https://shortlinks.example.com").option("--worker <name>", "Worker name", "shortlinks").option("--no-proxied", "Create unproxied DNS record").option("--verbose", "Show full Cloudflare setup plan").option("-j, --json", "Output JSON").action((hostname2, opts) => {
   try {
     const plan = createCloudflarePlan({
       hostname: hostname2,
@@ -11124,7 +11311,11 @@ cfCmd.command("plan <hostname>").description("Print the Cloudflare setup plan").
       workerName: opts.worker,
       proxied: opts.proxied
     });
-    print2(plan, opts, () => console.log(JSON.stringify(plan, null, 2)));
+    print(plan, opts, () => {
+      if (printVerbose(plan, opts))
+        return;
+      printCloudflarePlanSummary(plan);
+    });
   } catch (error) {
     handleError(error);
   }
@@ -11132,7 +11323,7 @@ cfCmd.command("plan <hostname>").description("Print the Cloudflare setup plan").
 cfCmd.command("worker").description("Write Cloudflare Worker files").option("--out-dir <dir>", "Output directory", "cloudflare").option("--worker <name>", "Worker name", "shortlinks").option("--origin <url>", "Origin redirect server URL", process.env.SHORTLINKS_ORIGIN || "https://shortlinks.example.com").option("-j, --json", "Output JSON").action((opts) => {
   try {
     const result = writeWorkerFiles({ outDir: opts.outDir, workerName: opts.worker, origin: opts.origin });
-    print2(result, opts, () => {
+    print(result, opts, () => {
       console.log(source_default.green(`Wrote ${result.workerPath}`));
       console.log(source_default.green(`Wrote ${result.wranglerPath}`));
     });
@@ -11140,7 +11331,7 @@ cfCmd.command("worker").description("Write Cloudflare Worker files").option("--o
     handleError(error);
   }
 });
-cfCmd.command("dns <hostname>").description("Create or update the Cloudflare CNAME record").requiredOption("--target <hostname>", "CNAME target").option("--zone-id <id>", "Cloudflare zone ID").option("--dry-run", "Show plan without changing DNS").option("--no-proxied", "Create unproxied DNS record").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
+cfCmd.command("dns <hostname>").description("Create or update the Cloudflare CNAME record").requiredOption("--target <hostname>", "CNAME target").option("--zone-id <id>", "Cloudflare zone ID").option("--dry-run", "Show plan without changing DNS").option("--no-proxied", "Create unproxied DNS record").option("--verbose", "Show full Cloudflare API result or dry-run plan").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
   try {
     const result = await upsertCloudflareDnsRecord({
       hostname: hostname2,
@@ -11149,25 +11340,33 @@ cfCmd.command("dns <hostname>").description("Create or update the Cloudflare CNA
       dryRun: opts.dryRun,
       proxied: opts.proxied
     });
-    print2(result, opts, () => console.log(JSON.stringify(result, null, 2)));
+    print(result, opts, () => {
+      if (printVerbose(result, opts))
+        return;
+      printCloudflareDnsSummary(result);
+    });
   } catch (error) {
     handleError(error);
   }
 });
 var localCmd = program2.command("local").description("Local domain setup helpers");
-localCmd.command("plan <domain>").description("Render hosts and reverse-proxy setup for a local shortlink domain").option("--port <port>", "Local redirect server port", "8787").option("--target-host <host>", "Local target host", "127.0.0.1").option("-j, --json", "Output JSON").action((domain, opts) => {
+localCmd.command("plan <domain>").description("Render hosts and reverse-proxy setup for a local shortlink domain").option("--port <port>", "Local redirect server port", "8787").option("--target-host <host>", "Local target host", "127.0.0.1").option("--verbose", "Show full local setup plan").option("-j, --json", "Output JSON").action((domain, opts) => {
   try {
     const plan = createLocalSetupPlan({
       domain,
       port: Number(opts.port),
       targetHost: opts.targetHost
     });
-    print2(plan, opts, () => console.log(JSON.stringify(plan, null, 2)));
+    print(plan, opts, () => {
+      if (printVerbose(plan, opts))
+        return;
+      printLocalPlanSummary(plan);
+    });
   } catch (error) {
     handleError(error);
   }
 });
-localCmd.command("setup <domain>").description("Record local domain mapping with machines and print remaining sudo-only setup").option("--port <port>", "Local redirect server port", "8787").option("--target-host <host>", "Local target host", "127.0.0.1").option("--skip-machines", "Do not call machines dns add").option("-j, --json", "Output JSON").action((domain, opts) => {
+localCmd.command("setup <domain>").description("Record local domain mapping with machines and print remaining sudo-only setup").option("--port <port>", "Local redirect server port", "8787").option("--target-host <host>", "Local target host", "127.0.0.1").option("--skip-machines", "Do not call machines dns add").option("--verbose", "Show full local setup result").option("-j, --json", "Output JSON").action((domain, opts) => {
   try {
     const plan = createLocalSetupPlan({
       domain,
@@ -11180,17 +11379,21 @@ localCmd.command("setup <domain>").description("Record local domain mapping with
       targetHost: opts.targetHost
     });
     const result = { plan, machines };
-    print2(result, opts, () => {
+    print(result, opts, () => {
       if (machines && machines.status !== 0) {
         console.error(source_default.yellow(machines.stderr.trim() || "machines dns add failed"));
       }
-      console.log(JSON.stringify(result, null, 2));
+      if (printVerbose(result, opts))
+        return;
+      printLocalPlanSummary(plan);
+      if (machines)
+        console.log(`  machines status: ${machines.status ?? "not started"}`);
     });
   } catch (error) {
     handleError(error);
   }
 });
-program2.command("doctor").description("Check local shortlinks tooling and integration readiness").option("-j, --json", "Output JSON").action(async (opts) => {
+program2.command("doctor").description("Check local shortlinks tooling and integration readiness").option("--verbose", "Show full diagnostic object").option("-j, --json", "Output JSON").action(async (opts) => {
   try {
     const dbPath = getDatabasePath(program2.opts().db);
     const data = await withRuntimeStore(async (store) => ({
@@ -11217,10 +11420,14 @@ program2.command("doctor").description("Check local shortlinks tooling and integ
         shortlinks_origin_present: Boolean(process.env.SHORTLINKS_ORIGIN)
       }
     }));
-    print2(data, opts, () => console.log(JSON.stringify(data, null, 2)));
+    print(data, opts, () => {
+      if (printVerbose(data, opts))
+        return;
+      printDoctorSummary(data);
+    });
   } catch (error) {
     handleError(error);
   }
 });
-registerEventsCommands(program2, { source: "shortlinks" });
+registerCompactEventsCommands(program2);
 program2.parseAsync(process.argv).catch(handleError);