@ninhache/probe 0.9.0 → 0.11.0

package/README.md

@@ -113,14 +113,15 @@ of macOS.
 | --------------- | ---------------------------------------------- |
 | `↑` `↓` `j` `k` | Move                                           |
 | `r`             | Check now                                      |
-| `Enter`         | Open the panel of the selected service         |
+| `Enter`         | Open the detail of the selected service        |
 | `u`             | Open its URL in the browser                    |
 | `c`             | Copy its curl command                          |
 | `/`             | Filter by name; `Enter` keeps it, `Esc` clears |
 | `a`             | Add a service                                  |
 | `e`             | Edit the selected service                      |
 | `d`             | Remove the selected service, after a question  |
-| `o`             | Options: interval and timeout                  |
+| `:`             | Find a command by what it does; `Enter` runs   |
+| `o`             | Options: interval, timeout and notifications   |
 | `?`             | Every key; `?` or `Esc` closes                 |
 | `q`             | Quit                                           |
 
@@ -132,16 +133,25 @@ to copy by hand.
 `a` and `e` open a form: name, port, host, path, expected status. `↑` `↓` or `Tab` change field, `Enter` saves,
 `Esc` cancels. A field left empty takes its default. `d` asks first: only `y` removes. All three write
 `.probe/config.yml` the way `probe add` and `probe rm` do: comments kept, [Makefile](#makefile) block kept up to
-date. While you type, in the filter or in the form, `q` and `?` are letters.
+date. While you type, in the filter, the form or the command palette, `q` and `?` are letters.
+
+`Enter` shows the last answer of the selected service above its two settings: status, latencies of this
+session, headers and the first lines of the body; for a service that is down, what failed and what to try. The
+value of a header that can carry a secret (`Authorization`, `Set-Cookie`, anything named after a token or a key)
+is replaced by `(hidden)`. None of it is written anywhere, and `probe check --json` prints what it printed before.
 
 The panels save what you change in `.probe/local.yml`, for your machine only:
 
 ```yaml
-dashboard: { interval: 5, timeout: 3 }
+dashboard: { interval: 5, timeout: 3, notify: true }
 services:
   db: { skip: true }
 ```
 
+With `notify` on, a desktop notification says when a service goes down or comes back: one per round of checks
+that saw a change, none when the dashboard starts. It names the services and nothing else, and needs
+`notify-send` on Linux (`osascript`, already there, on macOS); without it the dashboard says so once and goes on.
+
 A skipped service is left out of `probe check`, `probe wait` and the dashboard, and shown as `skipped`. Name it
 (`probe check db`) and it is checked anyway.
 

package/dist/{chunk-6UGVXAZY.js → chunk-VHDD7JN7.js}

@@ -14,6 +14,9 @@ var DEFAULT_MAKEFILE = "Makefile";
 var DEFAULT_CHECKER_TYPE = "http";
 var DEFAULT_TIMEOUT_SECONDS = 3;
 var DASHBOARD_INTERVAL_SECONDS = 2;
+var DASHBOARD_HISTORY_LENGTH = 30;
+var RESPONSE_BODY_BYTES = 2048;
+var RESPONSE_BODY_WAIT_MS = 500;
 var DASHBOARD_INTERVAL_CHOICES_SECONDS = [0.5, 1, 2, 5, 10, 30, 60];
 var DASHBOARD_TIMEOUT_CHOICES_SECONDS = [1, 2, 3, 5, 10, 30];
 var MAX_TIMEOUT_SECONDS = 2147483;
@@ -33,6 +36,7 @@ var EXIT_ERROR = 2;
 var DETECT_PORTS = [3e3, 3001, 4200, 4321, 5173, 8e3, 8080];
 var DETECT_PORTS_ENV = "PROBE_DETECT_PORTS";
 var DETECT_TIMEOUT_MS = 300;
+var NOTIFY_WAIT_MS = 5e3;
 
 // src/errors.ts
 var ProbeError = class extends Error {
@@ -162,6 +166,79 @@ function diagnoseStatus(service, status) {
   return { error, hint: `the service answers: check \`path\` and \`expect\` in ${CONFIG}` };
 }
 
+// src/checkers/response.ts
+var HIDDEN_VALUE = "(hidden)";
+var SENSITIVE_HEADER = /auth|cookie|token|secret|key|session|password|credential/i;
+var TEXT_TYPE = /^text\/|json|xml|javascript|yaml|x-www-form-urlencoded/i;
+var NUL = 0;
+var FIRST_PRINTABLE = 32;
+var DELETE = 127;
+var LAST_C1_CONTROL = 159;
+var REPLACEMENT = "\uFFFD";
+function isControl(character) {
+  const code = character.codePointAt(0) ?? NUL;
+  return code < FIRST_PRINTABLE || code >= DELETE && code <= LAST_C1_CONTROL;
+}
+function printable(text, kept = "") {
+  return Array.from(text).filter((character) => kept.includes(character) || !isControl(character)).join("");
+}
+async function readStart(body) {
+  const reader = body.getReader();
+  const chunks = [];
+  let size = 0;
+  let ended = false;
+  let timer;
+  const late = new Promise((resolve) => {
+    timer = setTimeout(() => resolve("late"), RESPONSE_BODY_WAIT_MS);
+  });
+  try {
+    while (size < RESPONSE_BODY_BYTES) {
+      const read = reader.read();
+      read.catch(() => {
+      });
+      const next = await Promise.race([read, late]);
+      if (next === "late") break;
+      if (next.done) {
+        ended = true;
+        break;
+      }
+      chunks.push(next.value);
+      size += next.value.length;
+    }
+  } catch {
+  } finally {
+    clearTimeout(timer);
+    void reader.cancel().catch(() => {
+    });
+  }
+  return {
+    bytes: Buffer.concat(chunks).subarray(0, RESPONSE_BODY_BYTES),
+    cut: !ended || size > RESPONSE_BODY_BYTES
+  };
+}
+async function describeResponse(response) {
+  const headers = [...response.headers].map(([name, value]) => [
+    printable(name),
+    SENSITIVE_HEADER.test(name) ? HIDDEN_VALUE : printable(value)
+  ]);
+  const detail = { statusText: printable(response.statusText), headers };
+  if (!response.body) return detail;
+  const type = printable(response.headers.get("content-type")?.split(";")[0] ?? "").trim();
+  if (type && !TEXT_TYPE.test(type)) {
+    void response.body.cancel().catch(() => {
+    });
+    return { ...detail, bodyNote: `${type} body, not shown` };
+  }
+  const { bytes, cut } = await readStart(response.body);
+  if (bytes.length === 0) return detail;
+  if (bytes.includes(NUL)) return { ...detail, bodyNote: "binary body, not shown" };
+  const decoded = new TextDecoder().decode(bytes).replaceAll("	", "  ");
+  const text = printable(cut ? decoded.replace(new RegExp(`${REPLACEMENT}+$`), "") : decoded, "\n");
+  const body = text.trimEnd();
+  if (!body) return detail;
+  return cut ? { ...detail, body, bodyCut: true } : { ...detail, body };
+}
+
 // src/checkers/http.ts
 function targetUrl(service) {
   const bareIpv6 = service.host.includes(":") && !service.host.startsWith("[");
@@ -183,7 +260,7 @@ function expectsRedirect(expect) {
 }
 var httpChecker = {
   type: "http",
-  async check(name, service, { timeoutMs, signal }) {
+  async check(name, service, { timeoutMs, signal, detail }) {
     const target = targetUrl(service);
     const base = { name, type: "http", target };
     const started = performance.now();
@@ -196,10 +273,20 @@ var httpChecker = {
         redirect: expectsRedirect(service.expect) ? "manual" : "follow"
       });
       const latencyMs = elapsed();
-      await response.body?.cancel();
       const { status } = response;
-      if (isExpected(service.expect, status)) return { ...base, ok: true, status, latencyMs };
-      return { ...base, ok: false, status, latencyMs, ...diagnoseStatus(service, status) };
+      const described = detail ? { response: await describeResponse(response) } : {};
+      if (!detail) await response.body?.cancel();
+      if (isExpected(service.expect, status)) {
+        return { ...base, ok: true, status, latencyMs, ...described };
+      }
+      return {
+        ...base,
+        ok: false,
+        status,
+        latencyMs,
+        ...diagnoseStatus(service, status),
+        ...described
+      };
     } catch (error) {
       const diagnosis = diagnoseFailure(error, service, timeoutMs);
       return { ...base, ok: false, latencyMs: elapsed(), ...diagnosis };
@@ -251,7 +338,8 @@ async function runChecks(config, names, options, skipped = /* @__PURE__ */ new S
       }
       return getChecker(type).check(name, service, {
         timeoutMs: resolveTimeoutMs(service, options),
-        signal: options.signal
+        signal: options.signal,
+        detail: options.detail
       });
     })
   );
@@ -417,6 +505,7 @@ export {
   DEFAULT_MAKEFILE,
   DEFAULT_TIMEOUT_SECONDS,
   DASHBOARD_INTERVAL_SECONDS,
+  DASHBOARD_HISTORY_LENGTH,
   DASHBOARD_INTERVAL_CHOICES_SECONDS,
   DASHBOARD_TIMEOUT_CHOICES_SECONDS,
   MAX_TIMEOUT_SECONDS,
@@ -436,6 +525,7 @@ export {
   DETECT_PORTS,
   DETECT_PORTS_ENV,
   DETECT_TIMEOUT_MS,
+  NOTIFY_WAIT_MS,
   CURRENT_SCHEMA_VERSION,
   SERVICE_NAME_PATTERN,
   serviceSchemaV1,

package/dist/cli.js

@@ -50,7 +50,7 @@ import {
   serviceSchemaV1,
   stripStyles,
   targetUrl
-} from "./chunk-6UGVXAZY.js";
+} from "./chunk-VHDD7JN7.js";
 import "./chunk-M3ASEG5F.js";
 
 // src/cli.ts
@@ -624,7 +624,7 @@ async function writeLock(paths, lock) {
 }
 
 // src/version.ts
-var CLI_VERSION = true ? "0.9.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.11.0" : "0.0.0-dev";
 
 // src/makefile/generator.ts
 import { createHash } from "crypto";
@@ -885,6 +885,7 @@ import { dirname as dirname2, join as join5 } from "path";
 import { isMap as isMap2, isScalar as isScalar2, parseDocument as parseDocument2 } from "yaml";
 var SECTION = "dashboard";
 var KEYS = ["interval", "timeout"];
+var NOTIFY = "notify";
 var SERVICES = "services";
 var SKIP = "skip";
 function isDelay(value) {
@@ -907,18 +908,21 @@ async function readDashboardPreferences(paths) {
     const value = doc.getIn([SECTION, key]);
     if (isDelay(value)) preferences[key] = value;
   }
+  if (doc.getIn([SECTION, NOTIFY]) === true) preferences.notify = true;
   return preferences;
 }
 function initialDashboardSettings(askedIntervalMs, saved) {
   return {
     intervalMs: askedIntervalMs ?? (saved.interval ?? DASHBOARD_INTERVAL_SECONDS) * 1e3,
-    timeoutMs: (saved.timeout ?? DEFAULT_TIMEOUT_SECONDS) * 1e3
+    timeoutMs: (saved.timeout ?? DEFAULT_TIMEOUT_SECONDS) * 1e3,
+    ...saved.notify ? { notify: true } : {}
   };
 }
 function changedPreferences(previous, next) {
   const changed = {};
   if (next.intervalMs !== previous.intervalMs) changed.interval = next.intervalMs / 1e3;
   if (next.timeoutMs !== previous.timeoutMs) changed.timeout = next.timeoutMs / 1e3;
+  if (Boolean(next.notify) !== Boolean(previous.notify)) changed.notify = Boolean(next.notify);
   return changed;
 }
 async function editLocal(paths, edit) {
@@ -951,6 +955,11 @@ function writeDashboardPreferences(paths, preferences) {
     for (const key of KEYS) {
       if (preferences[key] !== void 0) doc.setIn([SECTION, key], preferences[key]);
     }
+    if (preferences.notify) doc.setIn([SECTION, NOTIFY], true);
+    else if (preferences.notify === false && isMap2(section)) {
+      section.delete(NOTIFY);
+      if (section.items.length === 0) doc.delete(SECTION);
+    }
     return true;
   });
 }
@@ -1796,7 +1805,7 @@ async function openedDashboard(rawArgs) {
     if (!asked) return false;
     throw new ProbeError("USAGE", "No services yet. Add one: probe add api -p 3000");
   }
-  const { openDashboard } = await import("./open-YISUDM6V.js");
+  const { openDashboard } = await import("./open-QWB24XAM.js");
   let settings = initialDashboardSettings(askedMs, await readDashboardPreferences(paths));
   const saves = createSaveQueue();
   const local = `${PROBE_DIR}/${LOCAL_FILE}`;

package/dist/{open-YISUDM6V.js → open-QWB24XAM.js}

@@ -1,8 +1,10 @@
 import { createRequire as __createRequire } from "node:module";
 const require = __createRequire(import.meta.url);
 import {
+  DASHBOARD_HISTORY_LENGTH,
   DASHBOARD_INTERVAL_CHOICES_SECONDS,
   DASHBOARD_TIMEOUT_CHOICES_SECONDS,
+  NOTIFY_WAIT_MS,
   createColors,
   curlCommand,
   expectProblem,
@@ -17,7 +19,7 @@ import {
   runChecks,
   targetUrl,
   truncate
-} from "./chunk-6UGVXAZY.js";
+} from "./chunk-VHDD7JN7.js";
 import {
   __commonJS,
   __export,
@@ -18596,7 +18598,7 @@ var Box_default = Box;
 
 // node_modules/.pnpm/ink@8.0.0_@types+react@19.3.0_react@19.3.1/node_modules/ink/build/components/Text.js
 var import_react12 = __toESM(require_react(), 1);
-function Text({ color, backgroundColor, dimColor = false, bold = false, italic = false, underline = false, strikethrough = false, inverse = false, wrap = "wrap", children, "aria-label": ariaLabel, "aria-hidden": ariaHidden = false }) {
+function Text({ color, backgroundColor, dimColor = false, bold = false, italic = false, underline = false, strikethrough = false, inverse = false, wrap: wrap2 = "wrap", children, "aria-label": ariaLabel, "aria-hidden": ariaHidden = false }) {
   const { isScreenReaderEnabled } = (0, import_react12.use)(AccessibilityContext);
   const inheritedBackgroundColor = (0, import_react12.use)(BackgroundContext);
   const effectiveBackgroundColor = backgroundColor ?? inheritedBackgroundColor;
@@ -18634,7 +18636,7 @@ function Text({ color, backgroundColor, dimColor = false, bold = false, italic =
       flexGrow: 0,
       flexShrink: 1,
       flexDirection: "row",
-      textWrap: wrap
+      textWrap: wrap2
     }, internal_transform: isScreenReaderEnabled ? void 0 : transform }, childrenOrAriaLabel)
   );
 }
@@ -20278,12 +20280,50 @@ async function copyText(text, platform2 = process.platform, env3 = process.env,
   return false;
 }
 
+// src/notify.ts
+import { spawn as nodeSpawn2 } from "child_process";
+function notifierName(platform2) {
+  return platform2 === "darwin" ? "osascript" : "notify-send";
+}
+function notifierCommand(platform2, title, text) {
+  if (platform2 !== "darwin") return ["notify-send", "--app-name=probe", "--", title, text];
+  return [
+    "osascript",
+    "-e",
+    "on run argv",
+    "-e",
+    "display notification (item 2 of argv) with title (item 1 of argv)",
+    "-e",
+    "end run",
+    title,
+    text
+  ];
+}
+function sendNotification(title, text, platform2 = process.platform, spawn = nodeSpawn2) {
+  const [command = "", ...args] = notifierCommand(platform2, title, text);
+  return new Promise((resolve) => {
+    const child = spawn(command, args, { stdio: "ignore" });
+    const late = setTimeout(() => {
+      child.kill();
+      resolve(false);
+    }, NOTIFY_WAIT_MS);
+    const settle = (shown) => {
+      clearTimeout(late);
+      resolve(shown);
+    };
+    child.once("error", () => settle(false));
+    child.once("exit", (code) => settle(code === 0));
+  });
+}
+
 // src/dashboard/actions.ts
+var NOTIFICATION_TITLE = "probe";
 var system = () => ({
   platform: process.platform,
   env: process.env,
   openUrl,
-  copyText
+  copyText,
+  notify: sendNotification
 });
 function serviceActions(config, deps = system()) {
   const service = (name) => config().services[name];
@@ -20305,6 +20345,10 @@ ${url}`;
       const tools = clipboardTools(deps.platform, deps.env).map(([tool]) => tool);
       return `No ${tools.join(" or ")} to copy with. The command:
 ${command}`;
+    },
+    async onNotify(message) {
+      if (await deps.notify(NOTIFICATION_TITLE, message)) return void 0;
+      return `${notifierName(deps.platform)} could not show a desktop notification`;
     }
   };
 }
@@ -20312,6 +20356,129 @@ ${command}`;
 // src/dashboard/Dashboard.tsx
 var import_react36 = __toESM(require_react(), 1);
 
+// src/dashboard/changes.ts
+function stateChanges(known, results) {
+  const checked = results.filter(({ skipped }) => !skipped);
+  return {
+    known: new Map(checked.map(({ name, ok }) => [name, ok])),
+    changes: checked.filter(({ name, ok }) => known.has(name) && known.get(name) !== ok).map(({ name, ok }) => ({ name, up: ok }))
+  };
+}
+function changeMessage(changes) {
+  const [only] = changes;
+  if (only && changes.length === 1) return `${only.name} is ${only.up ? "back up" : "down"}`;
+  const names = (up) => changes.filter((change) => change.up === up).map(({ name }) => name).join(", ");
+  return [
+    ...names(false) ? [`down: ${names(false)}`] : [],
+    ...names(true) ? [`back up: ${names(true)}`] : []
+  ].join("; ");
+}
+
+// src/dashboard/detail.ts
+var BLOCKS = "\u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
+var HEADER_LINES = 6;
+var BODY_LINES = 5;
+var HINT_LINES = 3;
+var TRANSPORT_HEADERS = /* @__PURE__ */ new Set([
+  "connection",
+  "content-length",
+  "date",
+  "keep-alive",
+  "transfer-encoding"
+]);
+function recordLatencies(history, results) {
+  return Object.fromEntries(
+    results.map(({ name, status, skipped, latencyMs }) => {
+      const before = history[name] ?? [];
+      const answered = status !== void 0 && !skipped;
+      return [name, answered ? [...before, latencyMs].slice(-DASHBOARD_HISTORY_LENGTH) : before];
+    })
+  );
+}
+function sparkline(values, unicode, width) {
+  if (values.length === 0) return "";
+  const low = Math.min(...values);
+  const high = Math.max(...values);
+  const range = low === high ? `${low}ms` : `${low}${unicode ? "\u2013" : "-"}${high}ms`;
+  if (!unicode) return `${range} over ${values.length} ${values.length === 1 ? "check" : "checks"}`;
+  const room = width - range.length - 1;
+  if (room < 1) return range;
+  const top = BLOCKS.length - 1;
+  const bars = values.slice(-room).map((value) => BLOCKS[high === low ? 0 : Math.round((value - low) / (high - low) * top)]).join("");
+  return `${bars} ${range}`;
+}
+function wrap(text, width, maxLines) {
+  const lines = [];
+  let line = "";
+  for (const word of text.split(" ")) {
+    if (line && line.length + 1 + word.length > width) {
+      lines.push(line);
+      line = word;
+    } else line = line ? `${line} ${word}` : word;
+  }
+  lines.push(line);
+  const kept = lines.slice(0, maxLines).map((kept2) => truncate(kept2, width));
+  if (lines.length > maxLines) kept[maxLines - 1] = truncate(`${kept[maxLines - 1]} \u2026`, width);
+  return kept;
+}
+function detailLines(result, history, { unicode, width, room }) {
+  const dot = unicode ? "\xB7" : "-";
+  const more = unicode ? "\u2026" : "...";
+  const cut = (text) => truncate(text, width);
+  if (result.skipped) return [{ id: "status", text: cut("skipped: not checked"), tone: "dim" }];
+  const { response, status } = result;
+  const tone = result.ok ? "good" : "bad";
+  const lines = [];
+  if (status === void 0) lines.push({ id: "status", text: cut(result.error ?? "down"), tone });
+  else {
+    const answer = `${status} ${response?.statusText ?? ""}`.trim();
+    lines.push({ id: "status", text: cut(`${answer} ${dot} ${result.latencyMs}ms`), tone });
+    if (result.error) lines.push({ id: "error", text: cut(result.error), tone });
+  }
+  if (result.hint) {
+    for (const [index, text] of wrap(result.hint, width, HINT_LINES).entries())
+      lines.push({ id: `hint ${index}`, text, tone: "dim" });
+  }
+  const latencies = sparkline(history, unicode, width);
+  if (latencies) lines.push({ id: "latencies", text: cut(latencies), tone: "dim" });
+  if (!response) return lines;
+  const transport = ([name]) => TRANSPORT_HEADERS.has(name.toLowerCase());
+  const headers = [
+    ...response.headers.filter((header) => !transport(header)),
+    ...response.headers.filter(transport)
+  ].map(([name, value]) => `${name}: ${value}`);
+  const body = response.bodyNote ? [response.bodyNote] : response.body?.split("\n") ?? [];
+  let headerRoom = Math.min(headers.length, HEADER_LINES);
+  let bodyRoom = Math.min(body.length, BODY_LINES);
+  const left = Math.max(0, room - lines.length);
+  while (headerRoom + bodyRoom > left) {
+    if (bodyRoom > 1 && bodyRoom >= headerRoom) bodyRoom -= 1;
+    else if (headerRoom > 0) headerRoom -= 1;
+    else bodyRoom -= 1;
+  }
+  const hiddenHeaders = headers.length - headerRoom;
+  for (const [index, header] of headers.slice(0, headerRoom).entries()) {
+    const last = index === headerRoom - 1 && hiddenHeaders > 0;
+    lines.push(
+      last ? {
+        id: `header ${index}`,
+        text: cut(`${more} ${hiddenHeaders + 1} more headers`),
+        tone: "dim"
+      } : { id: `header ${index}`, text: cut(header), tone: "dim" }
+    );
+  }
+  const cutBody = body.length > bodyRoom || response.bodyCut;
+  for (const [index, text] of body.slice(0, bodyRoom).entries()) {
+    const last = index === bodyRoom - 1 && cutBody;
+    lines.push({
+      id: `body ${index}`,
+      text: last ? `${truncate(text, Math.max(1, width - more.length - 1))} ${more}`.trim() : cut(text),
+      tone: response.bodyNote ? "dim" : void 0
+    });
+  }
+  return lines;
+}
+
 // src/dashboard/form.ts
 var ROWS = [
   { key: "name", label: "Name", placeholder: "api" },
@@ -20357,16 +20524,24 @@ var list = (binding) => ({
   ...binding
 });
 var BINDINGS = [
-  list({ keys: "\u2191\u2193 jk", ascii: "jk", action: "move", help: "Move", drop: 1 }),
-  list({ keys: "r", action: "check", help: "Check now", barless: true }),
-  list({ keys: "\u21B5", ascii: "enter", action: "service", help: "Service settings", drop: 4 }),
-  list({ keys: "u", action: "open", help: "Open its URL", barless: true }),
-  list({ keys: "c", action: "copy", help: "Copy curl command", barless: true }),
-  list({ keys: "e", action: "edit", help: "Edit the service", barless: true }),
-  list({ keys: "d", action: "remove", help: "Remove it", barless: true }),
-  list({ keys: "a", action: "add", help: "Add a service", drop: 2 }),
-  list({ keys: "/", action: "filter", help: "Filter by name", drop: 3 }),
-  list({ keys: "o", action: "options", help: "Options", barless: true }),
+  list({ keys: "\u2191\u2193 jk", ascii: "jk", action: "move", help: "Move", drop: 2 }),
+  list({ keys: "r", action: "check", help: "Check now", barless: true, command: "check" }),
+  list({
+    keys: "\u21B5",
+    ascii: "enter",
+    action: "service",
+    help: "Service detail",
+    drop: 5,
+    command: "detail"
+  }),
+  list({ keys: "u", action: "open", help: "Open its URL", barless: true, command: "open" }),
+  list({ keys: "c", action: "copy", help: "Copy curl command", barless: true, command: "copy" }),
+  list({ keys: "e", action: "edit", help: "Edit the service", barless: true, command: "edit" }),
+  list({ keys: "d", action: "remove", help: "Remove it", barless: true, command: "remove" }),
+  list({ keys: "a", action: "add", help: "Add a service", drop: 3, command: "add" }),
+  list({ keys: "/", action: "filter", help: "Filter by name", drop: 4, command: "filter" }),
+  list({ keys: ":", action: "commands", help: "Find a command", drop: 1 }),
+  list({ keys: "o", action: "options", help: "Options", barless: true, command: "options" }),
   {
     screens: ["panel"],
     section: "Panels",
@@ -20404,6 +20579,9 @@ var BINDINGS = [
     help: "Keep the filter"
   },
   { screens: ["filter"], section: "Filter", keys: "esc", action: "clear", help: "Clear it" },
+  { screens: ["palette"], keys: "\u2191\u2193", ascii: "arrows", action: "move", drop: 1 },
+  { screens: ["palette"], keys: "\u21B5", ascii: "enter", action: "run" },
+  { screens: ["palette"], keys: "esc", action: "close" },
   {
     screens: ["form"],
     section: "Add and edit",
@@ -20430,14 +20608,16 @@ var BINDINGS = [
     section: "Outside a text field",
     keys: "?",
     action: "help",
-    help: "This help"
+    help: "This help",
+    command: "help"
   },
   {
     screens: ["list", "panel", "help"],
     section: "Outside a text field",
     keys: "q",
     action: "quit",
-    help: "Quit"
+    help: "Quit",
+    command: "quit"
   }
 ];
 var SECTIONS = [
@@ -20459,6 +20639,17 @@ function helpBar(screen, unicode, columns) {
   }
   return line();
 }
+function keyCommand(input, enter) {
+  return BINDINGS.find(({ keys, command }) => command && (enter ? keys === "\u21B5" : keys === input))?.command;
+}
+function paletteEntries(unicode, query = "") {
+  const wanted = query.trim().toLowerCase();
+  return BINDINGS.flatMap((binding) => {
+    const { command, help, action } = binding;
+    if (!command || !help || !`${help} ${action}`.toLowerCase().includes(wanted)) return [];
+    return [{ command, label: help, keys: written(binding, unicode) }];
+  });
+}
 var HELP_GAP = 3;
 function sectionLines(sections, unicode) {
   const described = BINDINGS.filter(({ help }) => help !== void 0);
@@ -20535,10 +20726,13 @@ function stepChoice(choices, current, direction) {
 // src/dashboard/Dashboard.tsx
 var import_jsx_runtime = __toESM(require_jsx_runtime(), 1);
 var SERVICE_ROWS = ["Skip", "Timeout"];
+var NOTIFY_ROW = SETTING_ROWS.length;
 var TIMEOUT_ROW = SERVICE_ROWS.indexOf("Timeout");
 var NO_TIMEOUTS = {};
 var MARKER_WIDTH = 2;
 var PANEL_WIDTH = 30;
+var DETAIL_WIDTH = 60;
+var DEFAULT_ROWS = 24;
 var FORM_WIDTH = 48;
 var CURSOR = "_";
 var PANEL_FRAME_WIDTH = 4;
@@ -20559,12 +20753,14 @@ function Dashboard({
   onTimeoutChange,
   onOpen,
   onCopy,
+  onNotify,
   serviceFields,
   onServiceWrite
 }) {
   const { exit } = useApp();
-  const { columns } = use_window_size_default();
+  const { columns, rows: windowRows } = use_window_size_default();
   const [latest, setLatest] = (0, import_react36.useState)(null);
+  const [history, setHistory] = (0, import_react36.useState)({});
   const [selected, setSelected] = (0, import_react36.useState)(0);
   const [settings, setSettings] = (0, import_react36.useState)(initial);
   const [skipped, setSkipped] = (0, import_react36.useState)(() => new Set(initiallySkipped));
@@ -20573,6 +20769,7 @@ function Dashboard({
   const [dialog, setDialog] = (0, import_react36.useState)(null);
   const [filter, setFilter] = (0, import_react36.useState)("");
   const [filtering, setFiltering] = (0, import_react36.useState)(false);
+  const [palette, setPalette] = (0, import_react36.useState)(null);
   const [writes, setWrites] = (0, import_react36.useState)(0);
   const [help, setHelp] = (0, import_react36.useState)(false);
   const [unsaved, setUnsaved] = (0, import_react36.useState)();
@@ -20583,6 +20780,20 @@ function Dashboard({
     void saved?.then(setUnsaved);
   };
   const { intervalMs, timeoutMs } = settings;
+  const known = (0, import_react36.useRef)(/* @__PURE__ */ new Map());
+  const notifying = (0, import_react36.useRef)(false);
+  notifying.current = settings.notify === true;
+  const warned = (0, import_react36.useRef)(false);
+  const tell = (next) => {
+    const { known: now, changes } = stateChanges(known.current, next);
+    known.current = now;
+    if (!notifying.current || changes.length === 0) return;
+    void onNotify?.(changeMessage(changes)).then((warning) => {
+      if (warning === void 0 || warned.current) return;
+      warned.current = true;
+      setNotice(warning);
+    });
+  };
   (0, import_react36.useEffect)(() => {
     const controller = new AbortController();
     const { signal } = controller;
@@ -20591,6 +20802,8 @@ function Dashboard({
         const next = await check2(signal, timeoutMs, skipped, timeouts);
         if (signal.aborted) return;
         setLatest(next);
+        tell(next);
+        setHistory((before) => recordLatencies(before, next));
         await new Promise((resolve) => {
           const timer = setTimeout(resolve, intervalMs);
           skipPause.current = () => {
@@ -20634,8 +20847,8 @@ ${outcome.warning}` : done);
     else if (key === "backspace" && field) edit(form.values[field].slice(0, -1));
     else if (typed && field) edit(form.values[field] + typed);
     else if (key === "return") {
-      const taken = (latest ?? []).map(({ name }) => name);
-      const problem = formProblem(rows2, form.values, taken);
+      const taken2 = (latest ?? []).map(({ name }) => name);
+      const problem = formProblem(rows2, form.values, taken2);
       if (problem) return setDialog({ ...form, row: problem.row, problem: problem.message });
       setDialog(null);
       const fields = formFields(form.values);
@@ -20658,10 +20871,9 @@ ${outcome.warning}` : done);
   };
   const change = (rowIndex, direction) => {
     const row = SETTING_ROWS[rowIndex];
-    if (!row) return;
-    const value = stepChoice(row.choicesMs, settings[row.key], direction);
-    if (value === settings[row.key]) return;
-    const next = { ...settings, [row.key]: value };
+    if (!row && rowIndex !== NOTIFY_ROW) return;
+    const next = row ? { ...settings, [row.key]: stepChoice(row.choicesMs, settings[row.key], direction) } : { ...settings, notify: !settings.notify };
+    if (row && next[row.key] === settings[row.key]) return;
     setSettings(next);
     track(onSettingsChange?.(next));
   };
@@ -20678,6 +20890,54 @@ ${outcome.warning}` : done);
     setTimeouts({ ...timeouts, [name]: value });
     track(onTimeoutChange?.(name, value));
   };
+  const run = (command) => {
+    const name = shown[current]?.name;
+    switch (command) {
+      case "check":
+        return skipPause.current();
+      case "options":
+        return setPanel({ kind: "options", row: 0 });
+      case "detail":
+        return name ? setPanel({ kind: "service", name, row: 0 }) : void 0;
+      case "open":
+        return name ? void onOpen?.(name).then(setNotice) : void 0;
+      case "copy":
+        return name ? void onCopy?.(name, timeouts[name]).then(setNotice) : void 0;
+      case "filter":
+        return setFiltering(true);
+      case "add":
+        return onServiceWrite ? setDialog({ kind: "form", row: 0, values: EMPTY_FORM }) : void 0;
+      case "edit": {
+        const fields = onServiceWrite && name ? serviceFields?.(name) : void 0;
+        if (fields) setDialog({ kind: "form", editing: name, row: 0, values: formValues(fields) });
+        return;
+      }
+      case "remove":
+        return onServiceWrite && name ? setDialog({ kind: "confirm", name }) : void 0;
+      case "help":
+        return setHelp(true);
+      case "quit":
+        return exit();
+      default:
+        return command;
+    }
+  };
+  const typePalette = ({ query, row }, keystroke) => {
+    const { key } = keystroke;
+    const typed = typedCharacter(keystroke);
+    const entries = paletteEntries(terminal.unicode, query);
+    if (key === "escape") setPalette(null);
+    else if (key === "return") {
+      const entry = entries[row];
+      if (!entry) return;
+      setPalette(null);
+      run(entry.command);
+    } else if (key === "up") setPalette({ query, row: Math.max(0, row - 1) });
+    else if (key === "down")
+      setPalette({ query, row: Math.max(0, Math.min(entries.length - 1, row + 1)) });
+    else if (key === "backspace") setPalette({ query: query.slice(0, -1), row: 0 });
+    else if (typed) setPalette({ query: query + typed, row: 0 });
+  };
   const press = (keystroke) => {
     const { input, key } = keystroke;
     const up2 = key === "up" || input === "k";
@@ -20685,41 +20945,29 @@ ${outcome.warning}` : done);
     const left = key === "left" || input === "h";
     const right = key === "right" || input === "l";
     const enter = key === "return";
-    const selectedName = shown[current]?.name;
     setNotice(void 0);
     if (dialog?.kind === "form") typeInForm(dialog, keystroke);
     else if (dialog) {
       setDialog(null);
       if (input === "y")
         void write({ kind: "remove", name: dialog.name }, `Removed ${dialog.name}`);
-    } else if (filtering) typeFilter(keystroke);
+    } else if (palette) typePalette(palette, keystroke);
+    else if (filtering) typeFilter(keystroke);
     else if (input === "q") exit();
     else if (help) {
       if (input === "?" || key === "escape") setHelp(false);
     } else if (input === "?") setHelp(true);
     else if (panel === null) {
-      if (input === "r") skipPause.current();
-      else if (input === "o") setPanel({ kind: "options", row: 0 });
-      else if (enter && selectedName) setPanel({ kind: "service", name: selectedName, row: 0 });
-      else if (input === "u" && selectedName) void onOpen?.(selectedName).then(setNotice);
-      else if (input === "c" && selectedName)
-        void onCopy?.(selectedName, timeouts[selectedName]).then(setNotice);
-      else if (input === "/") setFiltering(true);
+      const command = keyCommand(input, enter);
+      if (command) run(command);
+      else if (input === ":") setPalette({ query: "", row: 0 });
       else if (key === "escape") setFilter("");
-      else if (input === "a" && onServiceWrite)
-        setDialog({ kind: "form", row: 0, values: EMPTY_FORM });
-      else if (input === "e" && onServiceWrite && selectedName) {
-        const fields = serviceFields?.(selectedName);
-        if (fields)
-          setDialog({ kind: "form", editing: selectedName, row: 0, values: formValues(fields) });
-      } else if (input === "d" && onServiceWrite && selectedName)
-        setDialog({ kind: "confirm", name: selectedName });
       else if (up2) setSelected(Math.max(0, current - 1));
       else if (down) setSelected(Math.min(last, current + 1));
     } else if (key === "escape" || (panel.kind === "options" ? input === "o" : enter))
       setPanel(null);
     else if (up2 || down) {
-      const lastRow = (panel.kind === "options" ? SETTING_ROWS : SERVICE_ROWS).length - 1;
+      const lastRow = panel.kind === "options" ? NOTIFY_ROW : SERVICE_ROWS.length - 1;
       setPanel({ ...panel, row: Math.max(0, Math.min(lastRow, panel.row + (down ? 1 : -1))) });
     } else if (left || right) {
       if (panel.kind === "options") change(panel.row, right ? 1 : -1);
@@ -20775,11 +21023,12 @@ ${outcome.warning}` : done);
     ] });
   }
   if (!latest) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: cut("probe: checking\u2026") });
-  const results = shown.map((result) => {
+  const asShown = (result) => {
     if (result.skipped || !skipped.has(result.name)) return result;
     const { name, type, target } = result;
     return { name, type, target, ok: true, skipped: true, latencyMs: 0 };
-  });
+  };
+  const results = shown.map(asShown);
   const all = latest.filter((result) => !result.skipped && !skipped.has(result.name));
   const up = all.filter((result) => result.ok).length;
   const aside = latest.length - all.length;
@@ -20790,14 +21039,29 @@ ${outcome.warning}` : done);
     `every ${seconds(intervalMs)}`,
     ...filter && !filtering ? [`filter: ${filter}`] : []
   ].join(` ${dot} `);
-  const rows = results.length === 0 ? [] : formatCheckResults(results, {
-    ...terminal,
-    columns: Math.max(1, columns - MARKER_WIDTH)
-  }).split("\n");
+  const rows = results.length === 0 ? [] : (
+    // One line per service: the hint of the selected one goes under the list.
+    formatCheckResults(
+      results.map(({ hint: _, ...result }) => result),
+      { ...terminal, columns: Math.max(1, columns - MARKER_WIDTH) }
+    ).split("\n")
+  );
   const empty = filter ? `no service matches "${filter}"` : onServiceWrite ? "no service: press a to add one" : "no service";
   const focused = results[current];
-  const panelWidth = Math.min(PANEL_WIDTH, columns);
-  const panelRows = panel?.kind === "options" ? SETTING_ROWS.map((row) => [row.label, seconds(settings[row.key])]) : panel ? [
+  const panelWidth = Math.min(panel?.kind === "service" ? DETAIL_WIDTH : PANEL_WIDTH, columns);
+  const panelRoom = Math.max(1, panelWidth - PANEL_FRAME_WIDTH);
+  const detailed = panel?.kind === "service" ? latest.find(({ name }) => name === panel.name) : void 0;
+  const taken = 1 + Math.max(1, rows.length) + 1 + 2 + 1 + 1 + SERVICE_ROWS.length + 1 + 1;
+  const detail = detailed ? detailLines(asShown(detailed), history[detailed.name] ?? [], {
+    unicode,
+    width: panelRoom,
+    room: (windowRows || DEFAULT_ROWS) - taken - (unsaved === void 0 ? 0 : 1)
+  }) : [];
+  const toned = ({ text, tone }) => tone === "good" ? colors.green(text) : tone === "bad" ? colors.red(text) : tone === "dim" ? colors.dim(text) : text;
+  const panelRows = panel?.kind === "options" ? [
+    ...SETTING_ROWS.map((row) => [row.label, seconds(settings[row.key])]),
+    ["Notify", settings.notify ? "on" : "off"]
+  ] : panel ? [
     ["Skip", skipped.has(panel.name) ? "yes" : "no"],
     [
       "Timeout",
@@ -20805,8 +21069,15 @@ ${outcome.warning}` : done);
     ]
   ] : [];
   const labelWidth = Math.max(0, ...panelRows.map(([label]) => label.length));
-  const screen = dialog?.kind === "form" ? "form" : dialog ? "confirm" : filtering ? "filter" : panel ? "panel" : "list";
+  const screen = dialog?.kind === "form" ? "form" : dialog ? "confirm" : palette ? "palette" : filtering ? "filter" : panel ? "panel" : "list";
   const hint = helpBar(screen, unicode, columns);
+  const commands = palette ? paletteEntries(unicode, palette.query) : [];
+  const commandWidth = Math.max(0, ...commands.map(({ label }) => label.length));
+  const paletteRoom = Math.max(
+    1,
+    (windowRows || DEFAULT_ROWS) - (1 + Math.max(1, rows.length) + (focused ? 1 : 0) + (focused?.hint ? 1 : 0) + 1 + 1 + 1) - (unsaved === void 0 ? 0 : 1)
+  );
+  const firstCommand = Math.max(0, (palette?.row ?? 0) - paletteRoom + 1);
   const formWidth = Math.min(FORM_WIDTH, columns);
   const formLabels = dialog?.kind === "form" ? formRows(dialog.editing === void 0) : [];
   const formLabelWidth = Math.max(0, ...formLabels.map(({ label }) => label.length));
@@ -20820,6 +21091,7 @@ ${outcome.warning}` : done);
     focused && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: colors.dim(
       cut(focused.error ? `${focused.target} ${dot} ${focused.error}` : focused.target)
     ) }),
+    focused?.hint && panel?.kind !== "service" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: colors.dim(cut(focused.hint)) }),
     panel !== null && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
       Box_default,
       {
@@ -20828,20 +21100,22 @@ ${outcome.warning}` : done);
         borderStyle: unicode ? "single" : "classic",
         paddingX: 1,
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: colors.bold(
-            truncate(
-              panel.kind === "options" ? "Options" : panel.name,
-              Math.max(1, panelWidth - PANEL_FRAME_WIDTH)
-            )
-          ) }),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: colors.bold(truncate(panel.kind === "options" ? "Options" : panel.name, panelRoom)) }),
+          detail.map((line) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: toned(line) }, line.id)),
+          detail.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: colors.dim((unicode ? "\u2500" : "-").repeat(panelRoom)) }),
           panelRows.map(([label, value], index) => {
             const line = `${index === panel.row ? marker : "  "}${label.padEnd(labelWidth)}  ${unicode ? `\u2039 ${value} \u203A` : `< ${value} >`}`;
-            return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: truncate(line, Math.max(1, panelWidth - PANEL_FRAME_WIDTH)) }, label);
+            return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: truncate(line, panelRoom) }, label);
           })
         ]
       }
     ),
     filtering && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: cut(`Filter: ${filter}${CURSOR}`) }),
+    palette && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: cut(`: ${palette.query}${CURSOR}`) }),
+    palette && commands.slice(firstCommand, firstCommand + paletteRoom).map(({ command, label, keys }) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: cut(
+      `${commands[palette.row]?.command === command ? marker : "  "}${label.padEnd(commandWidth)}  ${keys}`
+    ) }, command)),
+    palette && commands.length === 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: colors.dim(cut(`no command matches "${palette.query}"`)) }),
     dialog?.kind === "confirm" && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: colors.bold(cut(`Remove ${dialog.name} from the config?`)) }),
     dialog?.kind === "form" && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
       Box_default,
@@ -20896,7 +21170,7 @@ async function openDashboard(initial, terminal, { onServiceWrite, ...state }) {
         { ...service, timeout: timeouts2[name] }
       ])
     );
-    return runChecks({ ...config, services }, [], { timeoutMs, signal }, skipped);
+    return runChecks({ ...config, services }, [], { timeoutMs, signal, detail: true }, skipped);
   };
   const timeouts = Object.fromEntries(
     Object.entries(config.services).flatMap(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ninhache/probe",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Health checks for your local dev services, from the CLI or a generated Makefile",
   "license": "MIT",
   "author": "Ninhache",