dsh-mishu 0.7.2 → 0.7.4

package/lib/core/watch/sync.js

@@ -0,0 +1,171 @@
+/**
+ * One watch, one check: read the address, compare with what was seen last
+ * time, and turn anything new into a card.
+ *
+ * A card per watch, not per entry: "补丁公告 · 3 条新内容" is what you want to
+ * see, not three cards that say the same thing. Marking it done closes it;
+ * the next change opens it again with what changed.
+ *
+ * The first check only writes down what is there now — otherwise adding a
+ * feed would hand you every entry it ever published. Words you asked to watch
+ * for are the exception: those are shown right away, because you asked.
+ */
+import { applyVerdict } from "../fold.js";
+import { bi, MishuError } from "../i18n.js";
+import { shortDay } from "../time.js";
+import { describeWatchError, readWatchBody } from "./fetch.js";
+import { WATCH_SOURCE, watchReportKey, watchSeenKey, watchStateKey } from "./source.js";
+/** How many entry keys one watch remembers. A feed longer than this is fine; the tail ages out. */
+const SEEN_LIMIT = 500;
+function readState(store, id) {
+    return store.get(watchStateKey(id)) ?? { seen: [], primed: false };
+}
+/** Which items are new since last time, and whether the whole page changed. */
+export function diffItems(items, state) {
+    const seen = new Set(state.seen);
+    const fresh = items.filter(item => !seen.has(item.key));
+    // A single-item read is a page: its key is a hash of the text, so "new" means "the text changed".
+    const digest = items.length === 1 ? items[0].key : items.map(i => i.key).sort().join(',');
+    return { fresh, changed: state.digest !== undefined && state.digest !== digest, digest };
+}
+function matches(item, keywords) {
+    if (keywords.length === 0)
+        return undefined;
+    const haystack = `${item.title}\n${item.text}`.toLowerCase();
+    return keywords.find(word => haystack.includes(word));
+}
+function quote(items, lang) {
+    const shown = items.slice(0, 3).map(i => `「${i.title.slice(0, 80)}」`);
+    const more = items.length - shown.length;
+    if (lang === 'zh')
+        return more > 0 ? `${shown.join('、')} 等 ${items.length} 条` : shown.join('、');
+    return more > 0 ? `${shown.join(', ')} and ${more} more` : shown.join(', ');
+}
+export function judgeWatch(options) {
+    const { source, items, fresh, changed, first, now } = options;
+    const hit = (list) => list
+        .map(item => ({ item, word: matches(item, source.keywords) }))
+        .filter((x) => x.word !== undefined);
+    const freshHits = hit(fresh);
+    const allHits = hit(items);
+    const keywordMode = source.keywords.length > 0;
+    let reason;
+    let relevant;
+    let word;
+    if (keywordMode) {
+        // A word you watch for is worth a card even on the very first check.
+        relevant = (first ? allHits : freshHits).map(x => x.item);
+        if (relevant.length === 0)
+            return undefined;
+        word = (first ? allHits : freshHits)[0].word;
+        reason = 'watch-keyword';
+    }
+    else if (first) {
+        return undefined;
+    }
+    else if (fresh.length > 0) {
+        relevant = fresh;
+        reason = items.length > 1 ? 'watch-new' : 'watch-changed';
+    }
+    else if (changed) {
+        relevant = items.slice(0, 1);
+        reason = 'watch-changed';
+    }
+    else {
+        return undefined;
+    }
+    const when = shortDay(now);
+    const what = bi(`你关注「${source.label}」（${new URL(source.url).hostname}）`, `The thing you watch: "${source.label}" (${new URL(source.url).hostname})`);
+    const why = keywordMode && word !== undefined
+        ? bi(`${when} 检查时，这里有内容提到你关注的字「${word}」：${quote(relevant, 'zh')}。`, `On ${when} it mentioned "${word}", one of your words: ${quote(relevant, 'en')}.`)
+        : reason === 'watch-new'
+            ? bi(`${when} 检查时出现了 ${fresh.length} 条新内容：${quote(relevant, 'zh')}。`, `On ${when} there were ${fresh.length} new entries: ${quote(relevant, 'en')}.`)
+            : bi(`${when} 检查时，${source.label} 的内容变了：${quote(relevant, 'zh')}。`, `On ${when} "${source.label}" changed: ${quote(relevant, 'en')}.`);
+    const link = relevant.find(i => i.url !== null)?.url ?? source.url;
+    return {
+        matterKey: `watch:${source.id}`,
+        kind: 'watch',
+        title: source.label,
+        url: link,
+        status: 'open',
+        reason,
+        note: bi(keywordMode ? `提到「${word}」` : reason === 'watch-new' ? `${fresh.length} 条新内容` : '内容有变化', keywordMode ? `mentions "${word}"` : reason === 'watch-new' ? `${fresh.length} new entries` : 'changed'),
+        explain: {
+            what,
+            why,
+            fix: bi('打开看一眼；处理完点"办完了"。不想再关注了，在设置里删掉这一条。', 'Open it and have a look; mark it done afterwards. To stop watching, delete it in Settings.'),
+            link: { label: bi('打开看看', 'Open it'), url: link },
+        },
+    };
+}
+export async function syncWatch(options) {
+    const { store, source, fetcher, now } = options;
+    const report = { at: now, id: source.id, items: 0, opened: 0, closed: 0 };
+    let body;
+    try {
+        body = await fetcher(source.url);
+    }
+    catch (error) {
+        report.error = describeWatchError(error, source);
+        store.set(watchReportKey(source.id), report);
+        return report;
+    }
+    if (body.status >= 400) {
+        report.error = body.status === 404
+            ? bi(`${source.label} 打不开了（404）：这个网址可能已经变了。`, `${source.label} is gone (404): the address may have moved.`)
+            : bi(`${source.label} 返回 ${body.status}，读不到内容。`, `${source.label} answered ${body.status}, so there was nothing to read.`);
+        store.set(watchReportKey(source.id), report);
+        return report;
+    }
+    if (body.body.trim() === '') {
+        report.error = bi(`${source.label} 这次读到的是空页面。`, `${source.label} came back empty.`);
+        store.set(watchReportKey(source.id), report);
+        return report;
+    }
+    const items = readWatchBody({ body: body.body, contentType: body.contentType, url: source.url, now });
+    if (items.length === 0) {
+        report.error = bi(`${source.label} 这次读到的是空页面。`, `${source.label} came back empty.`);
+        store.set(watchReportKey(source.id), report);
+        return report;
+    }
+    report.items = items.length;
+    const state = readState(store, source.id);
+    const { fresh, changed, digest } = diffItems(items, state);
+    const verdict = judgeWatch({ source, items, fresh, changed, first: !state.primed, now });
+    store.transaction(() => {
+        if (verdict !== undefined) {
+            const counts = { opened: 0, closed: 0 };
+            applyVerdict(store, WATCH_SOURCE, { ...verdict, activityAt: Math.max(...items.map(i => i.at), now) }, now, counts);
+            report.opened = counts.opened;
+            report.closed = counts.closed;
+        }
+        const seen = [...state.seen, ...fresh.map(i => i.key)];
+        const trimmed = seen.length > SEEN_LIMIT ? seen.slice(seen.length - SEEN_LIMIT) : seen;
+        store.set(watchStateKey(source.id), { seen: trimmed, digest, primed: true });
+        store.set(watchSeenKey(source.id), trimmed.length);
+    });
+    store.set(watchReportKey(source.id), report);
+    return report;
+}
+/** Everything about one watch the settings page shows. */
+export function describeWatch(store, source, lang) {
+    const report = store.get(watchReportKey(source.id));
+    if (report === undefined)
+        return lang === 'zh' ? '还没看过' : 'not checked yet';
+    if (report.error !== undefined)
+        return report.error[lang];
+    return lang === 'zh'
+        ? `${shortDay(report.at)} 看过，${report.items} 条内容`
+        : `checked ${shortDay(report.at)}, ${report.items} entries`;
+}
+/** The words, for showing back to you. */
+export function describeKeywords(source, lang) {
+    if (source.keywords.length === 0)
+        return lang === 'zh' ? '有任何变化就告诉我' : 'tell me about any change';
+    return lang === 'zh' ? `提到 ${source.keywords.join('、')} 时告诉我` : `tell me when it mentions ${source.keywords.join(', ')}`;
+}
+/** Guard for the settings page: an address that cannot be a watch at all. */
+export function assertWatchable(source) {
+    if (!/^https?:\/\//.test(source.url))
+        throw new MishuError(bi('只支持 http 和 https 的网址', 'only http and https addresses work'));
+}

package/lib/dsh/api.js

@@ -9,7 +9,7 @@
  * travel inward: they go straight to the keychain, and no endpoint ever
  * returns one.
  */
-import { addDays, addSeries, bi, deleteFeishu, deliver, FEISHU_WEBHOOK, notifySettings, NOTIFY_REPORT_KEY, saveFeishu, saveNotifySettings, testMessage, buildAsk, buildBoard, buildDetail, dayOf, deleteGithubToken, deleteMailAccount, describeMailError, MishuError, describeSeries, detectLang, errorText, GitHubClient, MAIL_PRESETS, mailReportKey, NEW_TOKEN_URL, normalizePassword, providerMismatch, resolveSeries, saveGithubToken, saveMailAccount, saveSettings, secretAccount, secretEnvName, setStatusByUser, snoozeByUser, stopSeries, tickManual, } from "../core/index.js";
+import { describeWatchError, addDays, addSeries, bi, deleteFeishu, deliver, FEISHU_WEBHOOK, notifySettings, NOTIFY_REPORT_KEY, saveFeishu, saveNotifySettings, testMessage, buildAsk, buildBoard, buildDetail, dayOf, deleteGithubToken, deleteMailAccount, describeMailError, MishuError, describeSeries, detectLang, errorText, GitHubClient, MAIL_PRESETS, mailReportKey, NEW_TOKEN_URL, normalizePassword, providerMismatch, resolveSeries, saveGithubToken, saveMailAccount, saveSettings, secretAccount, secretEnvName, setStatusByUser, snoozeByUser, stopSeries, tickManual, deleteWatch, describeKeywords, describeWatch, parseKeywords, readWatchBody, resolveWatch, saveWatch, watchById, watchReportKey, watchSources, } from "../core/index.js";
 import { resolveAccount } from "../core/mail/account.js";
 export const API_BASE = '/api/dsh-mishu';
 class ApiError extends Error {
@@ -62,6 +62,38 @@ function accountInput(value) {
     return out;
 }
 const password = (body) => (typeof body.password === 'string' && body.password !== '' ? body.password : undefined);
+function watchInput(value) {
+    const w = (value ?? {});
+    const text = (v) => (typeof v === 'string' ? v : undefined);
+    const out = {};
+    if (Number.isInteger(Number(w.id)) && Number(w.id) > 0)
+        out.id = Number(w.id);
+    if (text(w.label) !== undefined)
+        out.label = text(w.label);
+    if (text(w.url) !== undefined)
+        out.url = text(w.url);
+    if (typeof w.keywords === 'string' || Array.isArray(w.keywords))
+        out.keywords = w.keywords;
+    if (typeof w.enabled === 'boolean')
+        out.enabled = w.enabled;
+    if (w.intervalMinutes !== undefined && w.intervalMinutes !== null && w.intervalMinutes !== '')
+        out.intervalMinutes = Number(w.intervalMinutes);
+    return out;
+}
+/** What the settings page shows for one watch. */
+function watchView(store, source, lang) {
+    return {
+        id: source.id,
+        label: source.label,
+        url: source.url,
+        keywords: source.keywords.join(' '),
+        enabled: source.enabled,
+        intervalMinutes: source.intervalMinutes,
+        status: describeWatch(store, source, lang),
+        summary: describeKeywords(source, lang),
+        report: store.get(watchReportKey(source.id)) ?? null,
+    };
+}
 export function apiHandlers(runtime, clock = Date.now) {
     const langOf = (body) => runtime.fixedLang() ?? detectLang(typeof body.lang === 'string' ? body.lang : undefined);
     const need = (lang) => {
@@ -77,6 +109,7 @@ export function apiHandlers(runtime, clock = Date.now) {
         return buildBoard(store, {
             now: at, lang, github: { enabled: settings.githubEnabled, markRead: settings.markRead },
             mailAccounts: runtime.accounts(),
+            watches: runtime.watches(),
         });
     };
     /** Everything the settings page shows. No secret is ever included. */
@@ -108,6 +141,7 @@ export function apiHandlers(runtime, clock = Date.now) {
                 ...secrets.available && secrets.file !== undefined ? { file: { path: secrets.file.path, why: secrets.file.why[lang] } } : {},
             },
             accounts,
+            watches: watchSources(store).map(source => watchView(store, source, lang)),
             notify: {
                 settings: notifySettings(store),
                 channels: await Promise.all(['desktop', 'feishu'].map(async (id) => {
@@ -117,6 +151,13 @@ export function apiHandlers(runtime, clock = Date.now) {
                 feishu: { configured: (await runtime.secrets.get(FEISHU_WEBHOOK).catch(() => undefined)) !== undefined },
                 last: store.get(NOTIFY_REPORT_KEY) ?? null,
             },
+            // DSH's own scheduled tasks; null when this Host has no Schedule service.
+            // A failing service must not take the rest of the settings page down.
+            schedule: runtime.schedule === undefined ? null : await runtime.schedule.view(lang).catch(() => ({
+                available: true,
+                tasks: [],
+                brief: { id: null, time: notifySettings(store).brief.time, timeZone: notifySettings(store).timeZone, armed: false, error: lang === 'zh' ? '读不到 DSH 的自动化任务' : 'could not read DSH\'s scheduled tasks' },
+            })),
             presets: MAIL_PRESETS.map(p => ({
                 id: p.id, label: p.label[lang], host: p.host, port: p.port, secure: p.secure, supported: p.supported, howTo: p.howTo[lang],
                 domains: p.domains, passwordLength: p.passwordLength ?? null,
@@ -194,7 +235,7 @@ export function apiHandlers(runtime, clock = Date.now) {
         '/ask': async (body) => {
             const lang = langOf(body);
             const ask = (body.ask ?? {});
-            const kinds = ['matter', 'series', 'summary', 'github-error', 'mail-error', 'mail-setup'];
+            const kinds = ['matter', 'series', 'summary', 'github-error', 'mail-error', 'mail-setup', 'watch-error', 'watch-setup'];
             if (typeof ask.kind !== 'string' || !kinds.includes(ask.kind))
                 throw new ApiError(lang === 'zh' ? '不认识要问什么' : 'Unknown question');
             const request = {
@@ -202,6 +243,7 @@ export function apiHandlers(runtime, clock = Date.now) {
                 ...ask.id === undefined ? {} : { id: Number(ask.id) },
                 ...ask.accountId === undefined ? {} : { accountId: Number(ask.accountId) },
                 ...ask.preset === undefined ? {} : { preset: String(ask.preset) },
+                ...ask.watchId === undefined ? {} : { watchId: Number(ask.watchId) },
                 ...typeof ask.error === 'string' && ask.error !== '' ? { error: ask.error.slice(0, 1000) } : {},
             };
             const prompt = buildAsk(need(lang), request, { now: clock(), lang, markRead: runtime.settings().markRead, accounts: runtime.accounts() });
@@ -247,6 +289,8 @@ export function apiHandlers(runtime, clock = Date.now) {
         '/notify/save': async (body) => {
             const lang = langOf(body);
             saveNotifySettings(need(lang), (body.notify ?? {}), clock());
+            // A brief that is also a scheduled task follows the time you just set.
+            await runtime.schedule?.followBrief(lang);
             return { view: await settingsView(lang) };
         },
         /** One test message through one channel, turned on or not. */
@@ -310,8 +354,96 @@ export function apiHandlers(runtime, clock = Date.now) {
             }
             return { view: await settingsView(lang) };
         },
-        /** Whether the page's "restart DSH" button can work here, and if not, what to do instead. */
-        '/restart/info': async (body) => {
+        // ── things you watch yourself ─────────────────────────
+        '/watch/save': async (body) => {
+            const lang = langOf(body);
+            const source = saveWatch(need(lang), watchInput(body.watch), clock());
+            return { id: source.id, view: await settingsView(lang) };
+        },
+        /**
+         * Read it once without saving: how many entries came back, and what the
+         * first one is — enough to tell a feed from a login wall.
+         */
+        '/watch/test': async (body) => {
+            const lang = langOf(body);
+            const input = watchInput(body.watch);
+            const source = resolveWatch(input, input.id ?? 0);
+            let page;
+            try {
+                page = await runtime.watchFetch(source.url);
+            }
+            catch (error) {
+                throw new MishuError(describeWatchError(error, source));
+            }
+            if (page.status >= 400)
+                throw new ApiError(lang === 'zh' ? `这个网址返回 ${page.status}` : `The address answered ${page.status}`);
+            const items = readWatchBody({ body: page.body, contentType: page.contentType, url: source.url, now: clock() });
+            if (items.length === 0)
+                throw new ApiError(lang === 'zh' ? '读到了，但里面没有内容' : 'It loaded, but there was nothing in it');
+            const first = items[0];
+            const words = parseKeywords(input.keywords);
+            const haystack = `${first.title}\n${first.text}`.toLowerCase();
+            const hit = words.find(word => haystack.includes(word));
+            return {
+                items: items.length,
+                title: first.title.slice(0, 120),
+                excerpt: first.text.slice(0, 200),
+                ...words.length === 0 ? {} : { keywordHit: hit !== undefined, ...hit === undefined ? {} : { keyword: hit } },
+            };
+        },
+        '/watch/delete': async (body) => {
+            const lang = langOf(body);
+            if (!deleteWatch(need(lang), Number(body.id), clock()))
+                throw new ApiError(lang === 'zh' ? `没有 #${body.id} 这个关注` : `There is no watch #${body.id}`);
+            return { view: await settingsView(lang) };
+        },
+        /** Look at it right now, whatever the interval says. */
+        '/watch/sync': async (body) => {
+            const lang = langOf(body);
+            const store = need(lang);
+            const source = watchById(store, Number(body.id));
+            if (source === undefined)
+                throw new ApiError(lang === 'zh' ? `没有 #${body.id} 这个关注` : `There is no watch #${body.id}`);
+            const report = await runtime.syncWatchSource(source);
+            if (report?.error !== undefined)
+                throw new ApiError(report.error[lang]);
+            return { report: report ?? null, board: board(store, lang), view: await settingsView(lang) };
+        },
+        // ── DSH's own scheduled tasks ─────────────────────────
+        /** Hand the daily brief to DSH's Schedule: it then arrives as a conversation, not a notification. */
+        '/schedule/brief/arm': async (body) => {
+            const lang = langOf(body);
+            const bridge = runtime.schedule;
+            if (bridge === undefined)
+                throw new ApiError(lang === 'zh' ? '这个 DSH 没有自动化任务服务，简报只会用桌面通知发' : 'This DSH has no scheduled tasks service; the brief stays a desktop notification');
+            // Arm first, then read the page back: the task list and the armed flag are only right afterwards.
+            const schedule = await bridge.armBrief(lang);
+            return { view: await settingsView(lang), schedule };
+        },
+        '/schedule/brief/disarm': async (body) => {
+            const lang = langOf(body);
+            const bridge = runtime.schedule;
+            if (bridge === undefined)
+                throw new ApiError(lang === 'zh' ? '这个 DSH 没有自动化任务服务' : 'This DSH has no scheduled tasks service');
+            const schedule = await bridge.disarmBrief(lang);
+            return { view: await settingsView(lang), schedule };
+        },
+        /** Run any task now. */
+        '/schedule/run': async (body) => {
+            const lang = langOf(body);
+            const bridge = runtime.schedule;
+            if (bridge === undefined)
+                throw new ApiError(lang === 'zh' ? '这个 DSH 没有自动化任务服务' : 'This DSH has no scheduled tasks service');
+            return { schedule: await bridge.run(String(body.id ?? ''), lang) };
+        },
+        '/schedule/delete': async (body) => {
+            const lang = langOf(body);
+            const bridge = runtime.schedule;
+            if (bridge === undefined)
+                throw new ApiError(lang === 'zh' ? '这个 DSH 没有自动化任务服务' : 'This DSH has no scheduled tasks service');
+            return { schedule: await bridge.delete(String(body.id ?? ''), lang) };
+        },
+        /** Whether the page's "restart DSH" button can work here, and if not, what to do instead. */ '/restart/info': async (body) => {
             const plan = runtime.restarter.plan();
             return plan.kind === 'none' ? { supported: false, why: plan.why[langOf(body)] } : { supported: true };
         },

package/lib/dsh/plugin.js

@@ -111,6 +111,15 @@ export function apply(ctx, config, runtime = new Runtime(config, ctx.logger)) {
             }));
         }
     });
+    // DSH's own scheduled tasks ("自动化任务"). Optional: a Host without the
+    // service simply keeps the brief as a desktop notification.
+    ctx.inject(['schedule'], (scheduleCtx) => {
+        const service = scheduleCtx.schedule;
+        if (service === undefined || service === null)
+            return;
+        runtime.attachSchedule(service);
+        scheduleCtx.effect(() => () => { runtime.schedule = undefined; });
+    });
     ctx.inject(['commands'], (commandCtx) => {
         const commands = commandCtx.commands;
         commandCtx.effect(() => commands.register({

package/lib/dsh/runtime.js

@@ -4,12 +4,15 @@
  * what you set on the settings page on top), the keychain, and one sync of
  * every source at a time.
  */
-import { dayOf, detectLang, effectiveSettings, GitHubClient, ImapFetcher, mailAccounts, mailReportKey, renderBrief, buildBoard, DesktopChannel, FeishuChannel, FileSecrets, GithubDeviceLogin, KeychainOrFile, notifySettings, notifyTick, mishuPaths, resolveGithubToken, secretAccount, secretFromEnv, syncGithub, syncMail, systemSecrets, tickManual, bi, restartPlan, scheduleRestart, } from "../core/index.js";
+import { dayOf, detectLang, effectiveSettings, GitHubClient, ImapFetcher, mailAccounts, mailReportKey, renderBrief, buildBoard, DesktopChannel, FeishuChannel, FileSecrets, GithubDeviceLogin, KeychainOrFile, notifySettings, notifyTick, mishuPaths, resolveGithubToken, secretAccount, secretFromEnv, syncGithub, syncMail, systemSecrets, tickManual, bi, restartPlan, scheduleRestart, dueWatches, httpFetch, syncWatch, watchReportKey, watchSources, DEFAULT_NOTIFY, } from "../core/index.js";
+import { ScheduleBridge } from "./schedule.js";
 export class Runtime {
     store;
     config;
     secrets;
     fetcher;
+    /** How watched addresses are read; tests swap it for a fake. */
+    watchFetch = httpFetch;
     logger;
     syncing;
     /** Where reminders can go; tests swap them for recorders. */
@@ -19,6 +22,11 @@ export class Runtime {
     githubLogin;
     /** How DSH restarts; tests swap it so they never restart anything. */
     restarter = { plan: () => restartPlan(), schedule: plan => scheduleRestart(plan) };
+    /**
+     * DSH's own scheduled tasks, when this Host has them. Attached by the shell
+     * once the `schedule` service shows up; absent on a Host without it.
+     */
+    schedule;
     constructor(config, logger, secrets = new KeychainOrFile(systemSecrets(), new FileSecrets(mishuPaths(config.home).secrets)), fetcher = new ImapFetcher()) {
         this.config = config;
         this.logger = logger;
@@ -44,6 +52,26 @@ export class Runtime {
     accounts() {
         return this.store === undefined ? [] : mailAccounts(this.store);
     }
+    watches() {
+        return this.store === undefined ? [] : watchSources(this.store);
+    }
+    /**
+     * Wire in DSH's Schedule service, once. The bridge reads the brief's time
+     * from the reminder settings, so a brief moved on this page moves the task
+     * too. Called again with the same service (a service restart) keeps the
+     * bridge and hands it the new handle.
+     */
+    attachSchedule(service) {
+        if (this.schedule !== undefined) {
+            this.schedule.replace(service);
+            return this.schedule;
+        }
+        this.schedule = new ScheduleBridge(service, () => this.store, () => this.lang(), () => {
+            const settings = this.store === undefined ? DEFAULT_NOTIFY : notifySettings(this.store);
+            return { time: settings.brief.time, timeZone: settings.timeZone };
+        });
+        return this.schedule;
+    }
     brief(lang = this.lang()) {
         const store = this.store;
         if (store === undefined)
@@ -55,6 +83,7 @@ export class Runtime {
             now, lang, upcomingDays: this.config.upcomingDays,
             github: { enabled: settings.githubEnabled, markRead: settings.markRead },
             mailAccounts: this.accounts(),
+            watches: this.watches(),
         });
     }
     /** The password for an account: keychain first, then the documented environment variable. */
@@ -109,6 +138,15 @@ export class Runtime {
         this.logger.info(`dsh-mishu: mail #${account.id} ${report.error === undefined ? `ok (${report.messages} unread, +${report.opened} open, ${report.closed} closed)` : 'failed'}`);
         return report;
     }
+    /** One watch; the result is also kept as its last report. */
+    async syncWatchSource(source) {
+        const store = this.store;
+        if (store === undefined)
+            return undefined;
+        const report = await syncWatch({ store, source, fetcher: this.watchFetch, now: Date.now() });
+        this.logger.info(`dsh-mishu: watch #${source.id} ${report.error === undefined ? `ok (${report.items} items, +${report.opened} open, ${report.closed} closed)` : 'failed'}`);
+        return report;
+    }
     /** The channels that are turned on and work on this computer. */
     async activeChannels() {
         const store = this.store;
@@ -125,7 +163,7 @@ export class Runtime {
     /** The board as the brief describes it. */
     board(now, lang = this.lang()) {
         const settings = this.settings();
-        return buildBoard(this.store, { now, lang, github: { enabled: settings.githubEnabled, markRead: settings.markRead }, mailAccounts: this.accounts() });
+        return buildBoard(this.store, { now, lang, github: { enabled: settings.githubEnabled, markRead: settings.markRead }, mailAccounts: this.accounts(), watches: this.watches() });
     }
     /** Send what is due now: urgent items, the daily brief. One at a time. */
     notify(now = Date.now()) {
@@ -151,6 +189,9 @@ export class Runtime {
             for (const account of this.accounts().filter(a => a.enabled)) {
                 await this.syncMailAccount(account).catch(error => this.logger.warn(`dsh-mishu: mail #${account.id} sync failed (${error.message})`));
             }
+            for (const source of dueWatches(store, Date.now())) {
+                await this.syncWatchSource(source).catch(error => this.logger.warn(`dsh-mishu: watch #${source.id} failed (${error.message})`));
+            }
             // What the sync turned up may be urgent.
             await this.notify();
         })().finally(() => { this.syncing = undefined; });