dsh-global-todo 0.5.2 → 0.5.3

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [0.5.3] — 2026-10-20
+
+Settings a person can reach, and reminders that behave like reminders.
+
+- **A settings popover.** Reminders and the external ingest door were both API-only; the header
+  now opens a small panel for the reminder switch, the lead time, the ingest switch, the token
+  (generate a fresh one in place; leave blank to keep the current) and the inbox confidence
+  threshold. The token still never comes back from the host.
+- **Reminders gained a lead time and a switch.** remindersEnabled and reminderLeadMinutes live in
+  settings; the host sweep reads them each tick, announces at dueAt minus lead, and clears the due
+  list when reminders are off.
+- **Browser notifications are opt-in.** When the panel is open and a new deadline becomes due, it
+  fires a system notification if permission was granted; otherwise the due bar offers to ask for
+  permission. The notification is a bonus — the bar is the source of truth.
+
 # Changelog
 
 All notable changes to this project are documented in this file.

package/lib/client.js

@@ -50,7 +50,7 @@ window.__ModuleLoader__.load({
      * different mechanisms (restart vs. hot reload), so "which one am I looking
      * at" needs an answer that the bundle itself carries.
      */
-    const UI_REV = 'ui33'
+    const UI_REV = 'ui35'
     /** Last language resolved for the shell; module-level so a fetch failure can be worded too. */
     let activeLang = 'zh'
 
@@ -90,6 +90,19 @@ window.__ModuleLoader__.load({
       'action.import': '导入',
       'action.exportHint': '把整份清单导出成 JSON 文件（就是存储用的那份文档）',
       'action.importHint': '从 JSON 文件导入：同 id 覆盖、新 id 追加，不删除现有待办',
+      'settings.title': '设置',
+      'settings.reminders': '到点提醒',
+      'settings.remindersEnable': '开启到点提醒',
+      'settings.lead': '提前（分钟）',
+      'settings.ingest': '外部接入（ingest）',
+      'settings.ingestEnable': '启用外部写入',
+      'settings.token': '访问 token',
+      'settings.tokenSet': '已设置，留空保持不变',
+      'settings.generate': '生成新 token',
+      'settings.confirmBelow': '低于此置信度进收件箱',
+      'settings.save': '保存',
+      'settings.cancel': '取消',
+      'settings.saved': '设置已保存',
       'notice.exported': '已导出 {n} 条待办',
       'notice.imported': '已导入 {n} 条（合并，现有共 {total} 条）',
       'import.badJson': '这个文件不是合法的 JSON',
@@ -138,6 +151,8 @@ window.__ModuleLoader__.load({
       'notice.externalChange': '清单在别处被改过，已载入最新内容',
       'reminder.title': '到点提醒（{n}）',
       'reminder.dismiss': '知道了',
+      'reminder.enableNotifications': '开启系统通知',
+      'reminder.notifyTitle': '待办到点',
       'import.preview': '将导入 {total} 条：新增 {create}、更新 {update}',
       'import.confirm': '导入',
       'meta.seqHint': '给人看的编号',
@@ -311,6 +326,19 @@ window.__ModuleLoader__.load({
       'action.import': 'Import',
       'action.exportHint': 'Download the whole list as JSON (the document the store keeps)',
       'action.importHint': 'Import a JSON file: same ids are updated, new ids appended, nothing deleted',
+      'settings.title': 'Settings',
+      'settings.reminders': 'Due reminders',
+      'settings.remindersEnable': 'Announce deadlines',
+      'settings.lead': 'Lead time (min)',
+      'settings.ingest': 'External ingest',
+      'settings.ingestEnable': 'Accept external writes',
+      'settings.token': 'Access token',
+      'settings.tokenSet': 'Set — leave blank to keep',
+      'settings.generate': 'New token',
+      'settings.confirmBelow': 'Below this confidence → inbox',
+      'settings.save': 'Save',
+      'settings.cancel': 'Cancel',
+      'settings.saved': 'Settings saved',
       'notice.exported': 'Exported {n} todos',
       'notice.imported': 'Imported {n} (merged; {total} in the list now)',
       'import.badJson': 'That file is not valid JSON',
@@ -359,6 +387,8 @@ window.__ModuleLoader__.load({
       'notice.externalChange': 'The list changed somewhere else; the latest content is loaded',
       'reminder.title': 'Due now ({n})',
       'reminder.dismiss': 'Dismiss',
+      'reminder.enableNotifications': 'Enable notifications',
+      'reminder.notifyTitle': 'Todo due',
       'import.preview': 'Will import {total}: {create} new, {update} updated',
       'import.confirm': 'Import',
       'meta.seqHint': 'Human-facing number',
@@ -1014,6 +1044,13 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
   color: var(--dsw-alias-label-primary); font: inherit; font-size: 12.5px; padding: 3px 8px;
   border-radius: 999px; cursor: pointer; max-width: 260px; overflow: hidden; text-overflow: ellipsis;
   white-space: nowrap; }
+.gt-settings { align-self: flex-end; width: 330px; display: flex; flex-direction: column; gap: 8px;
+  padding: 12px 14px; border: 1px solid var(--dsw-alias-border-l2); border-radius: 12px;
+  background: var(--dsw-alias-bg-layer-1); font-size: 12.5px; }
+.gt-settings-head { font-weight: 650; }
+.gt-check-line { display: flex; align-items: center; gap: 8px; justify-content: space-between;
+  color: var(--dsw-alias-label-primary); }
+.gt-settings-row { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
 .gt-inbox { margin-left: 6px; padding: 1px 6px; border-radius: 999px; font-size: 10.5px; font-weight: 600;
   color: var(--dsw-alias-state-warn-primary); border: 1px solid var(--dsw-alias-state-warn-primary);
   vertical-align: 1px; }
@@ -2042,6 +2079,20 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       // A picked file is previewed first: a merge is not undoable, and "did I pick the right
       // export" is exactly the kind of question a dry run answers before anything changes.
       const [importAsk, setImportAsk] = useState(null)
+      // One settings popover: reminders and the external door both need a place a person can
+      // reach without curl.
+      const [settingsOpen, setSettingsOpen] = useState(false)
+      const [tokenDraft, setTokenDraft] = useState('')
+      const [ingestDraft, setIngestDraft] = useState(false)
+      const [belowDraft, setBelowDraft] = useState('0.8')
+      const [remindersDraft, setRemindersDraft] = useState(true)
+      const [leadDraft, setLeadDraft] = useState('0')
+      const [notificationPerm, setNotificationPerm] = useState(
+        typeof window !== 'undefined' && typeof window.Notification === 'function'
+          ? window.Notification.permission
+          : 'unsupported',
+      )
+      const notifiedRef = useRef(new Set())
       const [groupMode, setGroupMode] = useState(() => readStoredGroupMode())
       // A notice may carry an action: after a hand-off the useful next step is
       // to go and look at the conversation the work is actually in.
@@ -2863,6 +2914,47 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         return undefined
       }
 
+      /** Fill the popover from the host's state, so saving cannot send stale values. */
+      const openSettings = () => {
+        const current = state.health?.settings ?? {}
+        setIngestDraft(current.ingest?.enabled === true)
+        setBelowDraft(String(current.ingest?.confirmBelow ?? 0.8))
+        setRemindersDraft(current.remindersEnabled !== false)
+        setLeadDraft(String(current.reminderLeadMinutes ?? 0))
+        setTokenDraft('')
+        setSettingsOpen(true)
+      }
+
+      const generateToken = () => {
+        const bytes = new window.Uint8Array(24)
+        window.crypto.getRandomValues(bytes)
+        setTokenDraft(Array.from(bytes).map((byte) => byte.toString(16).padStart(2, '0')).join(''))
+        setIngestDraft(true)
+      }
+
+      const saveSettings = async () => {
+        try {
+          await call('settings', {
+            method: 'POST',
+            body: {
+              remindersEnabled: remindersDraft,
+              reminderLeadMinutes: Number(leadDraft),
+              ingestEnabled: ingestDraft,
+              ingestConfirmBelow: Number(belowDraft),
+              ...(tokenDraft.trim() === '' ? {} : { ingestToken: tokenDraft.trim() }),
+            },
+          })
+          setSettingsOpen(false)
+          setTokenDraft('')
+          await refreshHealth()
+          setNotice({ text: t('settings.saved'), sessionId: '' })
+          setTimeout(() => setNotice(null), 5000)
+        } catch (failure) {
+          reportFailure('settings', { message: failure?.message })
+          setError(failure)
+        }
+      }
+
       /** Acknowledge reminders so the host stops listing them. */
       const ackReminders = async (ids) => {
         try {
@@ -2901,6 +2993,30 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
 
       const counts = state.counts ?? { total: 0, open: 0, doing: 0, done: 0, cancelled: 0, archived: 0, overdue: 0, inbox: 0 }
       const remindersDue = Array.isArray(state.health?.reminders?.due) ? state.health.reminders.due : []
+      const dueKey = remindersDue.map((item) => `${item.id}:${item.dueAt}`).join('|')
+      useEffect(() => {
+        if (typeof window === 'undefined' || typeof window.Notification !== 'function') return
+        for (const item of remindersDue) {
+          const key = `${item.id}:${item.dueAt}`
+          if (notifiedRef.current.has(key)) continue
+          notifiedRef.current.add(key)
+          if (window.Notification.permission !== 'granted') continue
+          try {
+            const note = new window.Notification(t('reminder.notifyTitle'), { body: item.title, tag: item.id })
+            note.onclick = () => {
+              try {
+                window.focus()
+              } catch {
+                /* focus is a nicety */
+              }
+              setExpandedId(item.id)
+            }
+          } catch {
+            /* a notification is a bonus, never a failure */
+          }
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+      }, [dueKey])
       const groups = useMemo(
         () => groupTodos(state.todos, Date.now(), groupMode, sessionTitles, t),
         [state.todos, groupMode, sessionTitles, lang],
@@ -3011,6 +3127,16 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
               },
               t('action.import'),
             ),
+            h(
+              'button',
+              {
+                type: 'button',
+                className: 'gt-btn gt-btn-quiet',
+                'aria-expanded': settingsOpen,
+                onClick: () => (settingsOpen ? setSettingsOpen(false) : openSettings()),
+              },
+              t('settings.title'),
+            ),
             h('input', {
               ref: importRef,
               type: 'file',
@@ -3020,6 +3146,71 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
               onChange: (event) => void importJson(event),
             }),
           ),
+          settingsOpen
+            ? h(
+                'div',
+                { className: 'gt-settings', role: 'dialog', 'aria-label': t('settings.title') },
+                h('div', { className: 'gt-settings-head' }, t('settings.title')),
+                h('div', { className: 'gt-section-title' }, t('settings.reminders')),
+                h(
+                  'label',
+                  { className: 'gt-check-line' },
+                  h('input', { type: 'checkbox', checked: remindersDraft, onChange: (event) => setRemindersDraft(event.target.checked) }),
+                  t('settings.remindersEnable'),
+                ),
+                h(
+                  'label',
+                  { className: 'gt-check-line' },
+                  t('settings.lead'),
+                  h('input', {
+                    type: 'number',
+                    min: 0,
+                    max: 1440,
+                    className: 'gt-input gt-input-xs',
+                    value: leadDraft,
+                    onChange: (event) => setLeadDraft(event.target.value),
+                  }),
+                ),
+                h('div', { className: 'gt-section-title' }, t('settings.ingest')),
+                h(
+                  'label',
+                  { className: 'gt-check-line' },
+                  h('input', { type: 'checkbox', checked: ingestDraft, onChange: (event) => setIngestDraft(event.target.checked) }),
+                  t('settings.ingestEnable'),
+                ),
+                h('input', {
+                  className: 'gt-input',
+                  type: 'password',
+                  value: tokenDraft,
+                  placeholder:
+                    state.health?.settings?.ingest?.tokenSet === true ? t('settings.tokenSet') : t('settings.token'),
+                  autoComplete: 'new-password',
+                  onChange: (event) => setTokenDraft(event.target.value),
+                }),
+                h(
+                  'div',
+                  { className: 'gt-settings-row' },
+                  h('button', { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: generateToken }, t('settings.generate')),
+                  h('button', { type: 'button', className: 'gt-btn gt-btn-brand', onClick: () => void saveSettings() }, t('settings.save')),
+                  h('button', { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: () => setSettingsOpen(false) }, t('settings.cancel')),
+                ),
+                h(
+                  'label',
+                  { className: 'gt-check-line' },
+                  t('settings.confirmBelow'),
+                  h('input', {
+                    type: 'number',
+                    min: 0,
+                    max: 1,
+                    step: 0.05,
+                    className: 'gt-input gt-input-xs',
+                    value: belowDraft,
+                    onChange: (event) => setBelowDraft(event.target.value),
+                  }),
+                ),
+              )
+            : null,
+
           error !== null
             ? h(
                 'div',
@@ -3462,6 +3653,19 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                     `${item.seq > 0 ? `#${item.seq} ` : ''}${item.title}`,
                   ),
                 ),
+                notificationPerm === 'default'
+                  ? h(
+                      'button',
+                      {
+                        type: 'button',
+                        className: 'gt-btn gt-btn-quiet',
+                        onClick: () => {
+                          void window.Notification.requestPermission().then((permission) => setNotificationPerm(permission))
+                        },
+                      },
+                      t('reminder.enableNotifications'),
+                    )
+                  : null,
                 h(
                   'button',
                   { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: () => void ackReminders(remindersDue.map((item) => item.id)) },

package/lib/index.js

@@ -36,7 +36,7 @@ import { createStore, resolveStorePath } from './store.js'
 import { createTools } from './tools.js'
 
 /** Must equal `package.json`'s version; `npm run check` enforces that. */
-export const VERSION = '0.5.2'
+export const VERSION = '0.5.3'
 
 /** Plugin id. Also the Loader row id in `cordis.patch.yml`. */
 export const name = 'dsh-global-todo'
@@ -418,8 +418,17 @@ export function apply(ctx, config) {
   ctx.effect(() => {
     const tick = async () => {
       try {
+        const current = settings.get()
+        if (current.remindersEnabled === false) {
+          reminderState.due = []
+          return
+        }
         const { todos } = await service.list({ status: 'active' })
-        const due = dueReminders(todos, { now: Date.now(), reminded: reminderState.reminded })
+        const due = dueReminders(todos, {
+          now: Date.now(),
+          reminded: reminderState.reminded,
+          leadMs: (current.reminderLeadMinutes ?? 0) * 60_000,
+        })
         if (due.length === 0) return
         for (const item of due) reminderState.reminded[item.id] = item.dueAt
         const known = new Set(reminderState.due.map((item) => item.id))

package/lib/reminders.js

@@ -17,6 +17,8 @@
  */
 export function dueReminders(todos, options = {}) {
   const now = Number.isFinite(options.now) ? options.now : Date.now()
+  // A lead time turns "at the deadline" into "a little before it": the same rule, shifted.
+  const lead = Number.isFinite(options.leadMs) && options.leadMs > 0 ? options.leadMs : 0
   const reminded = options.reminded !== null && typeof options.reminded === 'object' ? options.reminded : {}
   const due = []
   for (const todo of Array.isArray(todos) ? todos : []) {
@@ -24,7 +26,7 @@ export function dueReminders(todos, options = {}) {
     if (todo.status !== 'open' && todo.status !== 'doing') continue
     if (todo.dueAt === null || todo.dueAt === undefined || typeof todo.dueAt !== 'string') continue
     const at = Date.parse(todo.dueAt)
-    if (!Number.isFinite(at) || at > now) continue
+    if (!Number.isFinite(at) || at - lead > now) continue
     if (reminded[todo.id] === todo.dueAt) continue
     due.push({
       id: todo.id,

package/lib/routes.js

@@ -417,6 +417,8 @@ export function createRoutes(deps) {
           loadError: settingsInfo.error,
           // The token itself never leaves the settings file; the panel only needs to know
           // whether one is set before it can usefully show the ingest section.
+          remindersEnabled: deps.settings?.get?.().remindersEnabled !== false,
+          reminderLeadMinutes: deps.settings?.get?.().reminderLeadMinutes ?? 0,
           ingest: {
             enabled: deps.settings?.get?.().ingestEnabled === true,
             sources: deps.settings?.get?.().ingestSources ?? [],

package/lib/settings.js

@@ -66,6 +66,10 @@ export const SETTINGS_DEFAULTS = Object.freeze({
   ingestSources: [...INGEST_SOURCES],
   /** Items below this confidence wait in the inbox instead of joining the list. */
   ingestConfirmBelow: 0.8,
+  /** Announce deadlines in the panel. On by default; a deadline nobody hears about is just data. */
+  remindersEnabled: true,
+  /** Announce this many minutes before the deadline (0 = at the deadline). */
+  reminderLeadMinutes: 0,
 })
 
 /**
@@ -105,6 +109,7 @@ export function normalizeSettings(raw) {
     sources.push(kind)
   }
   const below = Number(source.ingestConfirmBelow)
+  const lead = Number(source.reminderLeadMinutes)
   return {
     autoCollect: source.autoCollect === true,
     cooldownMinutes: Number.isInteger(minutes) ? Math.min(Math.max(minutes, 5), 24 * 60) : SETTINGS_DEFAULTS.cooldownMinutes,
@@ -117,6 +122,8 @@ export function normalizeSettings(raw) {
     ingestToken: typeof source.ingestToken === 'string' ? source.ingestToken.trim().slice(0, 512) : '',
     ingestSources: sources.length === 0 ? [...INGEST_SOURCES] : sources,
     ingestConfirmBelow: Number.isFinite(below) ? Math.min(Math.max(below, 0), 1) : SETTINGS_DEFAULTS.ingestConfirmBelow,
+    remindersEnabled: source.remindersEnabled !== false,
+    reminderLeadMinutes: Number.isFinite(lead) ? Math.min(Math.max(lead, 0), 24 * 60) : SETTINGS_DEFAULTS.reminderLeadMinutes,
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-global-todo",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "icon": "./docs/icon.svg",
   "description": "Global, cross-session todos for DeepSeek Harness: one list owned by the human and the agent together, with creation time, attached documents and links, and one-click hand-off to an agent session. 全局待办：跨会话一份清单，记录加入时间，可挂文档与地址，可一键交给 Agent 继续干。",
   "type": "module",