symbiot 0.41.2 → 0.41.3

package/README.md

@@ -55,6 +55,11 @@ Tabs:
   **no AI key**; reviews and suggestions use your chosen model. While the scan runs
   the Map shows its progress. Under the graph is the [experimental](#screens-blueprints-for-screen-automation)
   **Screens** view.
+- **Dashboard** — everything you [watch](#screens-blueprints-for-screen-automation)
+  side by side: a card for each page (your inbox, GitHub, WhatsApp, any other) with
+  how many new since yesterday (or in the last 3 or 7 days), its latest brief, the
+  newest items, and **Open**, **Draft a reply** and **Check now** on them. The tab
+  shows the count, so you see what's waiting from any tab.
 - **Drift** — the [`symbiot drift`](#whats-out-of-sync-symbiot-drift) report, with
   a "fetch latest" toggle (and an [experimental](#experimental) "check CI").
 - **Week / Standup / Todo** — the write-ups (these use your chosen AI).
@@ -113,6 +118,12 @@ repo is now archived), without Electron:
   then opens that copy's window. Switch it off to remove the entry. It needs an
   installed Symbiot (`npm install -g symbiot`), not `npx`.
 
+For a script or tray of your own: `isAppRunningWeekly()` (from
+`symbiot/index.mjs`) says whether a running `symbiot app` already writes the
+week, with no port or token to know; and `runWeekly(produce, { notify: false })`
+(from `symbiot/desktop.mjs`) writes and saves the week in the same `weeks/`
+format without the notification, for a caller that tells you itself.
+
 ### On your phone (Android, in Termux)
 
 Experimental, and tried on one phone so far (a Galaxy A26, Android 16), where it
@@ -620,7 +631,9 @@ there with what it has seen. It only reads: no screenshot is saved and nothing
 on the page is pressed or typed. The first read just learns what's there, so it
 never announces your whole inbox. After that, anything new (a new email, a new
 reply in a thread) gets a desktop notification and goes under **Watching** in
-Screens, newest first. A row is the same row whether its time reads `9:05 AM`,
+Screens, newest first, and on the page's card in the **Dashboard** tab. A chat
+works the same way: map `web.whatsapp.com` once you've signed in, watch it, and new
+messages (counted as WhatsApp messages in Standup) arrive with your mail and GitHub. A row is the same row whether its time reads `9:05 AM`,
 `Oct 5` or `2 hours ago`, or you've read it since. On a page with no rows it
 watches the links instead. If the site has signed you out, the watch says so,
 and notifies you once. With
@@ -633,6 +646,7 @@ symbiot watch add <screen id> --every 15   # watch a mapped page (or: symbiot wa
 symbiot watch add github                   # your GitHub notifications (see below)
 symbiot watch new --hours 24               # what's new, newest first (JSON)
 symbiot watch check                        # read them all now (JSON)
+symbiot watch draft <id>                   # Draft a reply to a new email (see below)
 symbiot watch brief on                     # your AI says what needs you (off to stop)
 symbiot watch                              # what you watch, and what's new
 symbiot watch remove <id>
@@ -666,7 +680,8 @@ your mail's site (`mail.google.com`) under Trusted sites. Each email gets a fold
 of its own in `~/.config/symbiot/drafts` (yours only) with the agent's brief, and
 the run shows in the Agents tab like any other: what it asks (a date only you
 know, say) is answered there. The agent sees the email's text, so it reaches
-whatever AI your agent uses.
+whatever AI your agent uses. From a terminal, `symbiot watch new` marks the
+emails `"mail": true`, and `symbiot watch draft <id>` does the same as the button.
 
 **In Standup.** Standup ends with what's waiting on you since yesterday, counted
 from what Watch found: `Waiting on you: 3 emails, 2 GitHub notifications`. Symbiot

package/agents.mjs

@@ -292,7 +292,7 @@ const readSymbiot = (path, f) => { try { return readFileSync(join(path, ".symbio
 // bullet under Questions is a question with no options.
 function parseQuestions(md) {
   const questions = [], suggestions = []; let sec = "q", cur = null;
-  const clip = (s) => String(s).trim().slice(0, 300);
+  const clip = (s) => String(s).trim().slice(0, 1000); // as long as a task holds (addTask), so an idea added in one click arrives whole
   for (const raw of String(md || "").split(/\r?\n/)) {
     const l = raw.trim(); if (!l) continue;
     let m;

package/desktop.mjs

@@ -55,16 +55,19 @@ function latestWeek() {
 }
 function weeklyState() { return { ...weeklyCfg(), latest: latestWeek() }; }
 // Write the week with `produce` (index.mjs), save it and notify. `last` is set
-// first, so a slow or failing run is never retried every minute.
-async function runWeekly(produce) {
+// first, so a slow or failing run is never retried every minute. notify: false
+// skips the notification, for a caller that tells you itself (the saved file
+// and what's returned are the same either way).
+async function runWeekly(produce, { notify: on = true } = {}) {
+  const notify = (body) => on && desktopNotify("Symbiot", body);
   const cfg = loadConfig(); cfg.weekly = { ...weeklyCfg(cfg), last: Date.now() }; saveConfig(cfg);
   const r = await produce("week");
-  if (r.error === "not-connected") { desktopNotify("Symbiot", "Time for your weekly update. Connect an AI in Symbiot's Settings and it writes it for you."); return { error: r.error }; }
-  if (/^\(?couldn't reach the model/i.test(String(r.text || ""))) { desktopNotify("Symbiot", "Couldn't write your week: the model didn't answer. Try the Week tab."); return { error: r.text }; }
+  if (r.error === "not-connected") { notify("Time for your weekly update. Connect an AI in Symbiot's Settings and it writes it for you."); return { error: r.error }; }
+  if (/^\(?couldn't reach the model/i.test(String(r.text || ""))) { notify("Couldn't write your week: the model didn't answer. Try the Week tab."); return { error: r.text }; }
   const file = join(WEEKS_DIR, localDay() + ".md");
   try { mkdirSync(WEEKS_DIR, { recursive: true }); writeFileSync(file, String(r.text || "").trim() + (r.footer ? FOOT + r.footer : "") + "\n"); }
   catch (e) { return { error: "Couldn't save the write-up: " + ((e && e.message) || e) }; }
-  desktopNotify("Symbiot", "Your week is written. Open the Week tab in Symbiot, or " + file);
+  notify("Your week is written. Open the Week tab in Symbiot, or " + file);
   return { ok: true, file, text: r.text };
 }
 // Checks once a minute while the app runs. Returns a stop function.

package/index.mjs

@@ -25,6 +25,7 @@
 
 import { spawn } from "node:child_process";
 import { homedir } from "node:os";
+import { join } from "node:path";
 import { realpathSync } from "node:fs";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
@@ -38,9 +39,9 @@ import { buildTasksMd, taskType, shipChanges, shipWithBump, bumpOffer, learnNpm,
 import { produce, mailState, setMail, sentMail } from "./writeups.mjs";
 import { loadScreens, screenImage, blueprint } from "./screens.mjs";
 import { mapPage, pressRegion, typeRegion, signIn, isTrusted } from "./headless.mjs";
-import { watchState, addWatch, removeWatch, newsSince, checkWatch, setBrief } from "./watch.mjs";
+import { watchState, addWatch, removeWatch, newsSince, checkWatch, setBrief, isMail, draftReply } from "./watch.mjs";
 import { PORT as PHONE_PORT, phoneState, pairComputer, pollComputer, forgetComputer } from "./phone.mjs";
-import { startApp, updateCmd } from "./server.mjs";
+import { startApp, updateCmd, isAppRunningWeekly } from "./server.mjs";
 
 // ---- tiny arg parse --------------------------------------------------------
 const argv = process.argv.slice(2);
@@ -369,7 +370,13 @@ async function cmdWatch() {
     for (const n of news.slice(0, 20)) console.log(`  ${c.d(new Date(n.ts).toLocaleString())}  ${n.text.slice(0, 110)}  ${c.d(n.name.slice(0, 30))}`);
     return;
   }
-  if (sub === "new") return out(newsSince(hours));
+  if (sub === "new") { const mail = new Set(watchState().watches.filter((w) => isMail(w.url)).map((w) => w.id)); return out(newsSince(hours).map((n) => (mail.has(n.watch) ? { ...n, mail: true } : n))); }
+  // the same as the app's Draft a reply button: through the app when it runs, so its Agents tab tracks the run
+  if (sub === "draft") {
+    if (!a1) return out({ error: "Give the email's id: symbiot watch new lists them, and the ones marked \"mail\": true can get a reply." });
+    const r = (await viaApp("/api/watch/draft", { id: a1 })) || draftReply(a1);
+    return out(r.ok ? { ...r, next: "Your agent is writing the reply and leaves it in Drafts, never sent. Its log is in " + join(r.dir, ".symbiot", "agent.log") + " (and the app's Agents tab)." } : r);
+  }
   if (sub === "add") { const screen = loadScreens().some((s) => s.id === a1) ? a1 : ""; return out(addWatch({ screen, site: screen ? "" : a1, every: flag("every", 15) })); }
   if (sub === "remove") return out(removeWatch(String(a1 || "")));
   if (sub === "brief") { if (a1 === "on" || a1 === "off") return out(setBrief(a1 === "on")); return out({ brief: watchState().brief, briefs: watchState().briefs }); }
@@ -387,6 +394,9 @@ async function cmdWatch() {
                                                failed CI runs (through gh when it's signed in)
   symbiot watch new [--hours 24]               what's new, newest first (JSON)
   symbiot watch check [id]                     read them now (JSON)
+  symbiot watch draft <id>                     your agent drafts a reply to that new email
+                                               ("mail": true in watch new) and leaves it in
+                                               Drafts, never sent, like Draft a reply in the app
   symbiot watch brief [on|off]                 your AI says what needs you, and what can wait
   symbiot watch remove <id>                    stop watching it
   While the app runs it reads each page every few minutes in its hidden browser
@@ -548,5 +558,5 @@ const isMain = (() => {
 })();
 if (isMain) main();
 
-export { authorship, repoState, readmeInfo, repoShape, houseRules, findAllRepos, buildMap, reportFooter, detectHardware, recommendModels, computeDrift, driftRepo, gitDefaultBranch, buildTasksMd, taskType, EMBEDDED_UI, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, fillHandoff, handoffCmd, setHandoffCmd, ORCA_CLAUDE_CMD, CLAUDE_CMD, HANDOFF_PROMPT, shipChanges, shipWithBump, bumpOffer, learnNpm, releaseNeeded, withReleases, setVersion, syncTasks, pendingReview, unreleased, publishesOnMerge, addTask, approveRepo, approveChanges, sendBack, pushTasks, semverGt, updateCmd, parseQuestions, agentQuestions };
+export { authorship, repoState, readmeInfo, repoShape, houseRules, findAllRepos, buildMap, reportFooter, detectHardware, recommendModels, computeDrift, driftRepo, gitDefaultBranch, buildTasksMd, taskType, EMBEDDED_UI, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, fillHandoff, handoffCmd, setHandoffCmd, ORCA_CLAUDE_CMD, CLAUDE_CMD, HANDOFF_PROMPT, shipChanges, shipWithBump, bumpOffer, learnNpm, releaseNeeded, withReleases, setVersion, syncTasks, pendingReview, unreleased, publishesOnMerge, addTask, approveRepo, approveChanges, sendBack, pushTasks, semverGt, updateCmd, parseQuestions, agentQuestions, isAppRunningWeekly };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "symbiot",
-  "version": "0.41.2",
+  "version": "0.41.3",
   "description": "Your week, written from your real work. Reads your local git and writes it up with the AI of your choice — Claude, OpenAI, Gemini, or a local model.",
   "type": "module",
   "bin": {

package/server.mjs

@@ -19,7 +19,7 @@ import { repoReview, repoSuggest, folderSuggest, taskChat, clearTaskChat, mailSt
 import { loadScreens, screenImage, captureScreen, splitScreen, listMonitors, allowScreenshots, importScreen, setRegions, renameScreen, removeScreen, blueprint, clickRegion } from "./screens.mjs";
 import { mapPage, pressRegion, typeRegion, signIn, keepBrowserOpen, isTrusted, trustedSites, trustSite, untrustSite } from "./headless.mjs";
 import { weeklyState, setWeekly, runWeekly, startWeekly, autostartState, setAutostart } from "./desktop.mjs";
-import { watchState, addWatch, setEvery, removeWatch, clearNews, checkWatch, startWatches, setBrief, draftReply } from "./watch.mjs";
+import { watchState, addWatch, setEvery, removeWatch, clearNews, checkWatch, startWatches, setBrief, draftReply, watchBoard } from "./watch.mjs";
 import { phoneState, setPhoneLink, newCode, unpairPhone, pairComputer, forgetComputer, pollComputer, startPhone } from "./phone.mjs";
 
 // The in-app update installs the EXACT newest version (not the `latest` tag, which
@@ -69,6 +69,21 @@ function openApp(url) {
     return "browser tab";
   } catch { return null; }
 }
+// What the `symbiot app` already serving on this computer says at /api/<path>,
+// or null when none answers. Knows the app's port and token, so a caller (a
+// tray, a script, startApp's single-instance check) doesn't have to.
+async function askRunningApp(path, { port, token, ms = 800 } = {}) {
+  const cfg = loadConfig(); token = token || cfg.appToken; if (!token) return null;
+  port = port || Number(process.env.SYMBIOT_PORT || cfg.appPort) || 7391;
+  const ctrl = new AbortController(), to = setTimeout(() => ctrl.abort(), ms);
+  try {
+    const r = await fetch(`http://127.0.0.1:${port}/api/${path}`, { headers: { "x-symbiot-token": token }, signal: ctrl.signal });
+    return r.ok ? await r.json() : null;
+  } catch { return null; } finally { clearTimeout(to); }
+}
+// True when a `symbiot app` is running with the weekly write-up on, so it
+// writes the week (and notifies) itself and nothing else needs to.
+async function isAppRunningWeekly() { const d = await askRunningApp("desktop"); return !!(d && d.weekly && d.weekly.on); }
 // How long the app keeps Screens' hidden browser open after an action.
 const BROWSER_KEEP = 5 * 60 * 1000;
 const PLAIN_COLOURS = { g: (s) => s, d: (s) => s, b: (s) => s, y: (s) => s };
@@ -92,21 +107,14 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
   // open a second window and exit, leaving nothing serving either window.
   const RELAUNCH = process.env.SYMBIOT_RELAUNCH === "1"; delete process.env.SYMBIOT_RELAUNCH;
   if (!process.env.SYMBIOT_FORCE_NEW && !RELAUNCH) {
-    try {
-      const ctrl = new AbortController(); const to = setTimeout(() => ctrl.abort(), 800);
-      const r = await fetch(`http://127.0.0.1:${PORT}/api/ping`, { headers: { "x-symbiot-token": TOKEN }, signal: ctrl.signal }).catch(() => null);
-      clearTimeout(to);
-      if (r && r.ok) {
-        const p = await r.json().catch(() => ({}));
-        if (p && p.version) {
-          const url = `http://127.0.0.1:${PORT}/?t=${TOKEN}`; const how = process.env.SYMBIOT_NO_OPEN === "1" ? "" : openApp(url);
-          console.log(`\n${c.g("●")} ${c.b("Symbiot")} is already running (v${p.version}) at ${c.b(url)}`);
-          console.log(how ? c.d(`  Opened the existing window (a ${how}).`) : c.d("  Open that URL in your browser."));
-          console.log(c.d("  (Not starting a second copy. Set SYMBIOT_FORCE_NEW=1 to force one.)"));
-          return;
-        }
-      }
-    } catch {}
+    const p = await askRunningApp("ping", { port: PORT, token: TOKEN });
+    if (p && p.version) {
+      const url = `http://127.0.0.1:${PORT}/?t=${TOKEN}`; const how = process.env.SYMBIOT_NO_OPEN === "1" ? "" : openApp(url);
+      console.log(`\n${c.g("●")} ${c.b("Symbiot")} is already running (v${p.version}) at ${c.b(url)}`);
+      console.log(how ? c.d(`  Opened the existing window (a ${how}).`) : c.d("  Open that URL in your browser."));
+      console.log(c.d("  (Not starting a second copy. Set SYMBIOT_FORCE_NEW=1 to force one.)"));
+      return;
+    }
   }
   // Screens' hidden browser stays open between map, press and type (headless.mjs),
   // so an agent can type into a field and then press a separate button there.
@@ -201,6 +209,7 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
       if (u.pathname === "/api/screens/signin" && req.method === "POST") { const b = await readBody(req); return json(res, await signIn(b.site)); }
       // Watch (watch.mjs): a mapped page read again every few minutes, and what's new on it.
       if (u.pathname === "/api/watch") return json(res, watchState());
+      if (u.pathname === "/api/watch/board") return json(res, watchBoard(Math.min(168, Math.max(1, Number(u.searchParams.get("hours")) || 24))));
       if (u.pathname === "/api/watch/add" && req.method === "POST") { const b = await readBody(req); return json(res, addWatch({ screen: b.screen ? String(b.screen) : "", site: b.site, every: b.every })); }
       if (u.pathname === "/api/watch/every" && req.method === "POST") { const b = await readBody(req); return json(res, setEvery(String(b.id || ""), b.every)); }
       if (u.pathname === "/api/watch/remove" && req.method === "POST") { const b = await readBody(req); return json(res, removeWatch(String(b.id || ""))); }
@@ -222,7 +231,7 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
       // What symbiot-desktop added (desktop.mjs): the weekly write-up, start at login.
       if (u.pathname === "/api/desktop") return json(res, { weekly: weeklyState(), autostart: autostartState() });
       if (u.pathname === "/api/desktop/weekly" && req.method === "POST") { const b = await readBody(req); return json(res, setWeekly(b)); }
-      if (u.pathname === "/api/desktop/weekly/run" && req.method === "POST") return json(res, await runWeekly(writeup));
+      if (u.pathname === "/api/desktop/weekly/run" && req.method === "POST") { const b = await readBody(req); return json(res, await runWeekly(writeup, { notify: b.notify !== false })); }
       if (u.pathname === "/api/desktop/autostart" && req.method === "POST") { const b = await readBody(req); return json(res, setAutostart(!!b.on, bin)); }
       if (u.pathname === "/api/run" && req.method === "POST") { const b = await readBody(req); const cmd = ["week", "standup", "todo"].includes(b.cmd) ? b.cmd : "week"; return json(res, await writeup(cmd)); }
       if (u.pathname === "/api/connect" && req.method === "POST") { return json(res, await connectProvider(await readBody(req))); }
@@ -269,4 +278,4 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
   startPhone(); // Watch on your phone: the computer listens if it's switched on, the phone asks if it's paired
 }
 
-export { updateCmd, BROWSER_KEEP, startApp };
+export { updateCmd, BROWSER_KEEP, startApp, askRunningApp, isAppRunningWeekly };

package/ui.mjs

@@ -133,6 +133,15 @@ label.check input{width:auto}
 .scrbox{position:absolute;border:2px solid var(--green);background:rgba(61,220,151,.12);pointer-events:none}
 .scrbox span{position:absolute;left:0;top:0;font-size:11px;background:var(--green);color:var(--ink);padding:1px 6px;white-space:nowrap}
 .scrbox.draw{border:2px dashed var(--amber);background:rgba(242,165,65,.14)}
+.board{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:12px;margin-top:12px}
+.bcard{border:1px solid var(--line);border-radius:12px;padding:12px 14px;background:var(--ink2);min-width:0}
+.bcard.has{border-color:#2a6b52}
+.bcard .bh{display:flex;gap:8px;align-items:center}.bcard .bn{color:var(--bone);font-weight:600;flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.bcard .bc{font-size:26px;font-weight:700;color:var(--faint);margin-top:6px}.bcard.has .bc{color:var(--green)}
+.bcard .bl{font-size:12px;color:var(--faint)}
+.bcard .bi{display:flex;gap:8px;align-items:flex-start;padding:7px 0;border-top:1px solid var(--line);font-size:13px;color:var(--text)}
+.bcard .bi .t{flex:1;min-width:0;overflow-wrap:anywhere}.bcard .bi button{padding:4px 9px;font-size:12px}
+.bcard .bbrief{white-space:pre-line;margin:8px 0;padding:8px 10px;border-left:3px solid var(--green);background:var(--ink3);border-radius:0 8px 8px 0;font-size:13px;color:var(--bone)}
 @media(max-width:760px){.maprow{flex-direction:column}.detail{width:auto;max-height:none}}
 @media(max-width:600px){#panel-tasks .row>#newtask,#screenname,#pagesite{flex:1 1 100%!important}.tabs{overflow-x:auto;scrollbar-width:none;padding:0 8px;gap:0}.tabs::-webkit-scrollbar{display:none}.tab{flex:none;padding:9px 11px}header{padding:12px 14px 8px}main{padding:12px}}
 </style></head><body>
@@ -141,6 +150,7 @@ label.check input{width:auto}
 <header><span class="dot"></span><span class="brand">Symbiot</span><span class="ver" id="ver"></span><span class="status" id="status">...</span></header>
 <div class="tabs">
 <button class="tab active" data-tab="map">Map</button>
+<button class="tab" data-tab="board" id="boardtab">Dashboard</button>
 <button class="tab" data-tab="drift">Drift</button>
 <button class="tab" data-tab="week">Week</button>
 <button class="tab" data-tab="standup">Standup</button>
@@ -180,6 +190,11 @@ label.check input{width:auto}
 <div id="screenview"></div>
 </div>
 </section>
+<section id="panel-board" class="hidden">
+<div class="row"><span class="muted" id="boardsum" style="flex:1">Everything you watch, side by side.</span><select id="boardhours" title="how far back" style="flex:0 0 auto;width:auto"><option value="24">last 24 hours</option><option value="72">last 3 days</option><option value="168">last 7 days</option></select><button class="ghost" id="boardrefresh">Refresh</button></div>
+<div id="boardmsg"></div>
+<div id="board" class="board"></div>
+</section>
 <section id="panel-run" class="hidden">
 <div class="row"><button class="act" id="write">Write my <span id="what">week</span></button>
 <button class="ghost hidden" id="copy">Copy</button>
@@ -293,8 +308,9 @@ var current='map';var mapLoaded=false;var driftLoaded=false;
 var COLORS={person:'#3DDC97',repo:'#F4F1EA',lang:'#F2A541',tool:'#6bb3ff',agent:'#c58af9',ai:'#5fe3b0',folder:'#b7a98c'};
 function tabs(){return document.querySelectorAll('.tab');}
 function setTab(tab){current=tab;tabs().forEach(function(t){t.classList.toggle('active',t.dataset.tab===tab);});
-var isMap=tab==='map',isSet=tab==='settings',isTasks=tab==='tasks',isDrift=tab==='drift',isAgents=tab==='agents',isRun=(tab==='week'||tab==='standup'||tab==='todo');
+var isMap=tab==='map',isSet=tab==='settings',isTasks=tab==='tasks',isDrift=tab==='drift',isAgents=tab==='agents',isBoard=tab==='board',isRun=(tab==='week'||tab==='standup'||tab==='todo');
 $('panel-map').classList.toggle('hidden',!isMap);
+$('panel-board').classList.toggle('hidden',!isBoard);if(isBoard)loadBoard();
 $('panel-run').classList.toggle('hidden',!isRun);
 $('panel-settings').classList.toggle('hidden',!isSet);
 $('panel-tasks').classList.toggle('hidden',!isTasks);
@@ -734,7 +750,7 @@ var wb=$('scrwatch');if(wb)wb.addEventListener('click',function(){watchUI(s,wb);
 var WATCH={watches:[],news:[],every:[5,15,30,60]};
 function watchOf(s){var w=null;(WATCH.watches||[]).forEach(function(x){if(s&&s.page&&x.url===s.page.url)w=x;});return w;}
 function agoTxt(t){var m=Math.max(0,(Date.now()-t)/60000);return m<1.5?'just now':m<90?Math.round(m)+' min ago':m<2160?Math.round(m/60)+' h ago':Math.round(m/1440)+' days ago';}
-function loadWatchUI(){api('/api/watch').then(function(d){if(d&&d.watches)WATCH=d;renderWatch();});}
+function loadWatchUI(){api('/api/watch').then(function(d){if(d&&d.watches)WATCH=d;renderWatch();});loadBoard();}
 function watchUI(s,b){var w=watchOf(s);
 if(w){if(typeof confirm==='function'&&!confirm('Stop watching '+w.name+'? What it found goes too.'))return;api('/api/watch/remove',{id:w.id}).then(function(){api('/api/watch').then(function(d){if(d&&d.watches)WATCH=d;renderWatch();renderScreen();});});return;}
 b.disabled=true;api('/api/watch/add',{screen:s.id,every:15}).then(function(x){b.disabled=false;if(!x||x.error){screenErr((x&&x.error)||'failed');return;}
@@ -758,14 +774,44 @@ var wbr=$('wbrief');if(wbr)wbr.addEventListener('change',function(){api('/api/wa
 box.querySelectorAll('.wevery').forEach(function(sel){sel.addEventListener('change',function(){var w=ws[+sel.closest('.task').getAttribute('data-i')];api('/api/watch/every',{id:w.id,every:+sel.value}).then(loadWatchUI);});});
 box.querySelectorAll('.wrm').forEach(function(b){b.addEventListener('click',function(){var w=ws[+b.closest('.task').getAttribute('data-i')];if(typeof confirm==='function'&&!confirm('Stop watching '+w.name+'? What it found goes too.'))return;api('/api/watch/remove',{id:w.id}).then(function(){api('/api/watch').then(function(d){if(d&&d.watches)WATCH=d;renderWatch();renderScreen();});});});});
 box.querySelectorAll('.wcheck').forEach(function(b){b.addEventListener('click',function(){var w=ws[+b.closest('.task').getAttribute('data-i')];b.disabled=true;b.textContent='Reading…';
-api('/api/watch/check',{id:w.id}).then(function(x){b.disabled=false;b.textContent='Check now';if(!x||x.error){screenErr((x&&x.error)||'failed');loadWatchUI();return;}var m=x.busy?"The hidden browser is busy with a map, press or type. It reads "+esc(w.name)+" once that's done.":x.learned!=null?"Read "+esc(x.name)+": learned the "+x.learned+" things listed there now. From here on, anything new is noted.":x["new"]&&x["new"].length?"&#10003; "+x["new"].length+" new on "+esc(x.name)+".":"Read "+esc(x.name)+": nothing new.";
-$('screenmsg').innerHTML="<div class='note "+(x["new"]&&x["new"].length?"ok":"muted")+"'>"+m+"</div>";loadWatchUI();}).catch(function(e){b.disabled=false;b.textContent='Check now';screenErr(String((e&&e.message)||e));});});});
+api('/api/watch/check',{id:w.id}).then(function(x){b.disabled=false;b.textContent='Check now';if(!x||x.error){screenErr((x&&x.error)||'failed');loadWatchUI();return;}
+$('screenmsg').innerHTML="<div class='note "+(x["new"]&&x["new"].length?"ok":"muted")+"'>"+watchCheckMsg(w,x)+"</div>";loadWatchUI();}).catch(function(e){b.disabled=false;b.textContent='Check now';screenErr(String((e&&e.message)||e));});});});
 box.querySelectorAll('.wopen').forEach(function(b){b.addEventListener('click',function(){var n=ns[+b.closest('.task').getAttribute('data-i')];if(n&&/^https?:/.test(n.href))window.open(n.href,'_blank','noopener');});});
 // Draft a reply (watch.mjs draftReply): handed to your agent, which never sends it
 box.querySelectorAll('.wdraft').forEach(function(b){b.addEventListener('click',function(){var n=ns[+b.closest('.task').getAttribute('data-i')];b.disabled=true;
 api('/api/watch/draft',{id:n.id}).then(function(x){b.disabled=false;if(!x||x.error){screenErr((x&&x.error)||'failed');return;}
-$('screenmsg').innerHTML="<div class='note ok'>&#10003; Your agent is drafting a reply to it. It opens the email in your inbox through Screens, writes the reply and leaves it in Drafts for you to read and send: it never presses Send. Follow it, and answer anything it asks, in the Agents tab.</div>";loadWatchUI();}).catch(function(e){b.disabled=false;screenErr(String((e&&e.message)||e));});});});
+$('screenmsg').innerHTML="<div class='note ok'>"+DRAFTING+"</div>";loadWatchUI();}).catch(function(e){b.disabled=false;screenErr(String((e&&e.message)||e));});});});
 var wc=$('wclear');if(wc)wc.addEventListener('click',function(){api('/api/watch/clear',{}).then(loadWatchUI);});}
+// what Check now found, for Watching and the Dashboard
+function watchCheckMsg(w,x){return x.busy?"The hidden browser is busy with a map, press or type. It reads "+esc(w.name)+" once that's done.":x.learned!=null?"Read "+esc(x.name)+": learned the "+x.learned+" things listed there now. From here on, anything new is noted.":x["new"]&&x["new"].length?"&#10003; "+x["new"].length+" new on "+esc(x.name)+".":"Read "+esc(x.name)+": nothing new.";}
+var DRAFTING="&#10003; Your agent is drafting a reply to it. It opens the email in your inbox through Screens, writes the reply and leaves it in Drafts for you to read and send: it never presses Send. Follow it, and answer anything it asks, in the Agents tab.";
+// ---- Dashboard: a card per page you watch (your inbox, GitHub, WhatsApp…), what's new on each ----
+var BOARD=null;var BOARDICON={mail:'&#9993;&#65039;',github:'&#128276;',chat:'&#128172;',page:'&#127760;'};
+function loadBoard(){api('/api/watch/board?hours='+(+$('boardhours').value||24)).then(function(b){if(b&&b.cards){BOARD=b;renderBoard();}});}
+function boardMsg(cls,html){$('boardmsg').innerHTML="<div class='note "+cls+"'>"+html+"</div>";}
+function renderBoard(){var b=BOARD,cs=b.cards,el=$('board');
+var tab=$('boardtab');if(tab)tab.textContent='Dashboard'+(b.total?' · '+b.total:'');
+if(!cs.length){$('boardsum').textContent='Everything you watch, side by side.';
+el.innerHTML="<div style='grid-column:1/-1'><div class='note muted' style='margin-top:0'>Nothing watched yet. Map your inbox, a chat (web.whatsapp.com) or any page under <b>Screens</b> on the Map tab and click <b>Watch</b> on it, or click <b>Watch GitHub</b> there. Each one gets a card here with what's new on it.</div><div class='row' style='margin-top:8px'><button class='ghost' id='boardgo'>Go to Screens</button></div></div>";
+$('boardgo').addEventListener('click',function(){setTab('map');var w=$('watchbox');if(w&&w.scrollIntoView)w.scrollIntoView({block:'center'});});return;}
+var when=b.hours===24?'since yesterday':b.hours===72?'in the last 3 days':'in the last 7 days';
+var waiting=cs.filter(function(c){return c.count;}).map(function(c){return c.label+(c.source==='page'?' on '+c.name:'');});
+$('boardsum').innerHTML=waiting.length?"<b style='color:var(--bone)'>Waiting on you "+when+":</b> "+esc(waiting.join(', ')):"Nothing new "+when+" on the "+cs.length+" thing"+(cs.length===1?"":"s")+" you watch.";
+el.innerHTML=cs.map(function(c,i){
+return "<div class='bcard"+(c.count?" has":"")+"' data-i='"+i+"'><div class='bh'><span>"+(BOARDICON[c.source]||BOARDICON.page)+"</span><span class='bn' title='"+esc(c.url)+"'>"+esc(c.name)+"</span><button class='ghost bcheck' title='read it now' style='padding:4px 9px;font-size:12px'>Check now</button></div>"
++"<div class='bc'>"+c.count+"</div><div class='bl'>"+esc(c.count?c.label.replace(/^\\d+ /,''):'nothing new')+" &middot; "+(c.checked?"read "+agoTxt(c.checked):c.last?"tried "+agoTxt(c.last):"first read within a minute")+(c.via==='gh'?" &middot; through gh":"")+"</div>"
++(c.error?"<div class='note err'>"+esc(c.error)+"</div>":"")
++(c.brief?"<div class='bbrief'>"+esc(c.brief.text)+"</div>":"")
++c.items.map(function(n,j){return "<div class='bi' data-j='"+j+"'><span class='t'>"+esc(n.text)+" <span class='muted' style='font-size:11px'>"+agoTxt(n.ts)+"</span></span>"+(n.href?"<button class='ghost bopen' title='open it in your browser'>Open</button>":"")+(n.mail?"<button class='ghost bdraft' title='your coding agent writes a reply and leaves it in Drafts. It never presses Send'>"+(n.drafted?"Drafted &middot; again":"Draft a reply")+"</button>":"")+"</div>";}).join('')
++(c.count>c.items.length?"<div class='bl' style='margin-top:6px'>&hellip;and "+(c.count-c.items.length)+" more</div>":"")+"</div>";}).join('');
+function card(btn){return cs[+btn.closest('.bcard').getAttribute('data-i')];}
+function item(btn){return card(btn).items[+btn.closest('.bi').getAttribute('data-j')];}
+el.querySelectorAll('.bcheck').forEach(function(btn){btn.addEventListener('click',function(){var c=card(btn);btn.disabled=true;btn.textContent='Reading…';
+api('/api/watch/check',{id:c.id}).then(function(x){if(!x||x.error)boardMsg('err',esc((x&&x.error)||'failed'));else boardMsg(x["new"]&&x["new"].length?'ok':'muted',watchCheckMsg(c,x));loadWatchUI();}).catch(function(e){btn.disabled=false;btn.textContent='Check now';boardMsg('err',esc(String((e&&e.message)||e)));});});});
+el.querySelectorAll('.bopen').forEach(function(btn){btn.addEventListener('click',function(){var n=item(btn);if(n&&/^https?:/.test(n.href))window.open(n.href,'_blank','noopener');});});
+el.querySelectorAll('.bdraft').forEach(function(btn){btn.addEventListener('click',function(){var n=item(btn);btn.disabled=true;
+api('/api/watch/draft',{id:n.id}).then(function(x){btn.disabled=false;if(!x||x.error){boardMsg('err',esc((x&&x.error)||'failed'));return;}boardMsg('ok',DRAFTING);loadWatchUI();}).catch(function(e){btn.disabled=false;boardMsg('err',esc(String((e&&e.message)||e)));});});});}
+$('boardrefresh').addEventListener('click',loadBoard);$('boardhours').addEventListener('change',loadBoard);
 // A web page, mapped by itself in the hidden browser (headless.mjs): no capture,
 // no dragging. It takes a few seconds, so the button says so meanwhile.
 function mapUI(site,b){site=(site||'').trim();if(!site){screenErr('Type a site to map first: gmail, github.com/pulls or a web address.');return;}b.disabled=true;

package/watch.mjs

@@ -187,6 +187,7 @@ function kindOf(url) {
   const h = hostOf(url);
   if (isGitHubInbox(url)) return ["GitHub notification", "GitHub notifications"];
   if (/^(mail|webmail)\.|^outlook\.(live|office|office365)\.com$/.test(h)) return ["email", "emails"];
+  if (h === "web.whatsapp.com") return ["WhatsApp message", "WhatsApp messages"];
   return null;
 }
 // What's new on each page you watch in the last `hours`: [{ name, count, label,
@@ -203,6 +204,23 @@ function waitingOn(hours = 24, now = Date.now()) {
   });
 }
 
+// ---- the Dashboard: one card per page you watch ----------------------------------
+// Each watch with what it found in the last `hours`: its source (mail, github,
+// chat, page), how many ("3 emails"), the newest few and its latest brief. Read
+// from all of watch.json, so a busy GitHub can't push your mail off the board the
+// way it can off the 50 newest under Watching.
+const sourceOf = (url) => (isGitHubInbox(url) ? "github" : isMail(url) ? "mail" : hostOf(url) === "web.whatsapp.com" ? "chat" : "page");
+function watchBoard(hours = 24, now = Date.now()) {
+  const d = loadWatch(), since = now - hours * 3600000;
+  const cards = d.watches.map((w) => {
+    const recent = d.news.filter((n) => n.watch === w.id && n.ts >= since), k = kindOf(w.url), mail = isMail(w.url), count = recent.length;
+    const b = d.briefs.find((x) => x.watch === w.id && x.ts >= since);
+    return { ...view(w), source: sourceOf(w.url), count, label: k ? `${count} ${k[count === 1 ? 0 : 1]}` : `${count} new`,
+      items: recent.slice(0, 8).map((n) => (mail ? { ...n, mail: true } : n)), ...(b ? { brief: { text: b.text, ts: b.ts, count: b.count } } : {}) };
+  });
+  return { hours, total: cards.reduce((s, c) => s + c.count, 0), cards, brief: briefOn() };
+}
+
 // A batch of news as one notification: how many and where, then the brief if
 // there is one, else the first few. The phone (phone.mjs) shows the same.
 function newsNotice(news, name, brief = "") {
@@ -349,4 +367,4 @@ function startWatches(opts = {}) {
   return () => { clearTimeout(first); clearInterval(every); };
 }
 
-export { WATCH_FILE, EVERY, GITHUB_INBOX, DRAFTS_DIR, itemsOf, itemKey, newItems, remember, isGitHubInbox, githubItems, readGitHub, setBrief, briefOf, newsNotice, watchState, addWatch, setEvery, removeWatch, clearNews, newsSince, newsAfter, waitingOn, draftsUrl, draftBrief, draftReply, checkWatch, dueWatches, startWatches };
+export { WATCH_FILE, EVERY, GITHUB_INBOX, DRAFTS_DIR, itemsOf, itemKey, newItems, remember, isGitHubInbox, githubItems, readGitHub, setBrief, briefOf, newsNotice, watchState, addWatch, setEvery, removeWatch, clearNews, newsSince, newsAfter, waitingOn, watchBoard, isMail, draftsUrl, draftBrief, draftReply, checkWatch, dueWatches, startWatches };