dsh-global-todo 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.2] — 2026-10-19
+
+Noise is the failure mode that matters for a list other people are asked to trust.
+
+- **Capture decides with a gate, not a title comparison.** The old check compared normalized
+  titles exactly against active rows, which missed the ordinary case — same errand, different
+  wording — and happily re-admitted something finished yesterday. `lib/capture.js` now refuses an
+  item when its normalized title matches a live row, when a close paraphrase (Dice over character
+  bigrams, 0.8) appears within 72 hours, or when the same errand was finished in the last 7 days.
+  Archived and cancelled rows are set-aside history and do not block a new one; every refusal
+  carries its reason in `skipped[]`.
+## [0.4.1] — 2026-10-19
+
+The half-finished half: the selection could only be assigned, and the only way to get a record out
+of the list was to delete it. Both are now actions of their own.
+
+- **A selection can be completed, archived and tagged.** `POST /bulk` applies one change across the
+  picked rows, and the selection bar gained 完成 / 归档 / a tag field. Each record still goes through
+  the same validation and activity trail as a single edit; an id that no longer exists is reported
+  in `unmatched` rather than failing the whole batch, because a selection is a human gesture and one
+  stale row must not discard the other nine.
+
+- **Archive instead of delete.** `archived` joined the statuses, so a finished-or-abandoned record can
+  leave the active view without losing its history. The panel offers 归档 / 取消归档 in the row menu,
+  the filter chip appears only once something is archived, and `global_todo_update` now accepts
+  `status` at all — before this, marking something in progress required the tool named
+  `global_todo_done`, which is exactly the kind of name/capability mismatch that makes a model misuse
+  a tool.
+
+Still deliberately out of scope for this release: the wide two-column detail layout, and the
+cross-machine conflict check — both deserve their own pass rather than riding along with a data-model
+change.
 ## [0.4.0] — 2026-10-19
 
 The first release after the plugin was listed in a community catalog. It is a reliability

package/README.md

@@ -194,7 +194,7 @@ Your list is not touched by install or uninstall: it lives outside the plugin, a
 | `global_todo_capture` | **Record a batch**: for 「抓一下待办」 or a turn that produced several follow-ups; each entry is validated on its own |
 | `global_todo_list` | Query by state, tag or text; every row carries its creation time |
 | `global_todo_get` | Read one item in full, including attachments and the last hand-off |
-| `global_todo_update` | Change any field of one item; `""` clears, `[]` empties |
+| `global_todo_update` | Change any field of one item, including `status` (`archived` archives without deleting); `""` clears, `[]` empties |
 | `global_todo_link` | Attach or detach documents and addresses |
 | `global_todo_done` | Mark done, back to open, or in progress |
 | `global_todo_reopen` | Put a **wrongly finished** item back (`done` / `cancelled` → `open`); refuses anything else, and the trail records it as the agent |
@@ -227,6 +227,12 @@ produces noise, and a noisy list is worse than an empty one:
 The boundary: it **records, it never starts work**. The list belongs to the human, and
 starting a task stays a human decision (see the non-goals in [ROADMAP](docs/ROADMAP.md)).
 
+
+Capture is not allowed to become noise. Before an item is written, the same normalized title
+(full-width, case, spacing and punctuation folded away), a close paraphrase within the last 72
+hours (Dice similarity over character bigrams, 0.8), and the same errand finished in the last 7
+days are all refused with a reason on the record; archived and cancelled rows do not block a
+new one. The rules live in `lib/capture.js` and are tested on their own.
 ### HTTP API
 
 The panel talks to the host over these routes. They are fenced by the host connection
@@ -240,6 +246,7 @@ fence when that service is present, and by a strict loopback check otherwise.
 | GET | `/api/global-todo/export` | — (the store's own JSON document, for backup or migration) |
 | POST | `/api/global-todo/import` | `{ doc, mode?: replace\|merge }` — `replace` is an exact round trip, `merge` updates by id and appends (what the panel sends) |
 | POST | `/api/global-todo/capture` | `{ sessionId? }` — ask the current conversation to collect its follow-ups |
+| POST | `/api/global-todo/bulk` | `{ ids, status?, addTags?, removeTags? }` — one change across a selection; a stale id lands in `unmatched` instead of failing the batch |
 | GET | `/api/global-todo/health` | — (store location, counts, dispatch capabilities, plus **tool registration** and **whether the completion watcher attached** — both fail quietly, so both are reported — and `metrics`: dispatch success rate, agent tool calls, list growth; `autoCollect`: why each waiting conversation was or was not asked, counters, and how the settings file loaded) |
 | POST | `/api/global-todo/create` | `{ title, description?, links?, tags?, priority?, dueAt? }` |
 | POST | `/api/global-todo/update` | `{ id, ...fields, by?: human\|agent }` |

package/README.zh.md

@@ -120,7 +120,7 @@ dsh plugin --profile web remove dsh-global-todo
 | `global_todo_capture` | **一次登记多条**（批量抓取）：用户说「抓一下待办」，或你一轮里发现好几件要跟进的；逐条校验，坏的那条只跳过它自己 |
 | `global_todo_list` | 按状态/标签/关键词查询，每条都带上加入时间 |
 | `global_todo_get` | 读一条的全文，含附件与最近一次派发 |
-| `global_todo_update` | 改任意字段；`""` 清空，`[]` 清空列表 |
+| `global_todo_update` | 改任意字段，包括 `status`（`archived` 归档而不删除）；`""` 清空，`[]` 清空列表 |
 | `global_todo_link` | 挂上或摘掉文档与地址 |
 | `global_todo_done` | 标完成 / 标回未完成 / 标进行中 |
 | `global_todo_reopen` | 把**被误标完成**的一条标回未完成（只做 `done` / `cancelled` → `open`）；本来就未完成的会被拒绝，动作按 agent 记进活动轨迹 |
@@ -143,6 +143,7 @@ dsh plugin --profile web remove dsh-global-todo
 | POST | `/api/global-todo/import` | `{ doc, mode?: replace\|merge }`——`replace` 是无损往返，`merge` 同 id 覆盖、新 id 追加（面板用的是这个） |
 | POST | `/api/global-todo/note` | `{ id, text }`（追加进展记录） |
 | POST | `/api/global-todo/capture` | `{ sessionId? }`（请当前对话把要跟进的事抓进清单） |
+| POST | `/api/global-todo/bulk` | `{ ids, status?, addTags?, removeTags? }`——一次改一整批；失效的 id 进 `unmatched`，不会让整批失败 |
 | GET | `/api/global-todo/health` | —（数据位置、统计、派发能力，以及**工具注册状态**与**自动收尾观察者是否挂上**——这两种失败是静默的，所以必须能查；还有 `metrics`：派发成功率、工具调用次数、清单增长；`autoCollect`：每个候选对话**为什么被问/没被问**、计次，以及设置文件是怎么加载进来的） |
 | POST | `/api/global-todo/create` | `{ title, description?, links?, tags?, priority?, dueAt? }` |
 | POST | `/api/global-todo/update` | `{ id, ...字段, by?: human\|agent }` |

package/docs/DESIGN.md

@@ -14,7 +14,7 @@ so the file stays readable, hand-editable and diffable.
 | `id` | string | `t-` + 8 hex; unique within the file |
 | `title` | string | 1–200 characters, trimmed |
 | `description` | string | up to 10 000 characters, Markdown-ish plain text |
-| `status` | `open` \| `doing` \| `done` \| `cancelled` | `doing` means someone is on it |
+| `status` | `open` \| `doing` \| `done` \| `cancelled` \| `archived` | `doing` means someone is on it; `archived` keeps the record out of the active view without deleting it |
 | `priority` | `low` \| `normal` \| `high` \| `urgent` | `urgent` was added in front of the first three; `normal` stays the default |
 | `dueAt` | ISO-8601 string \| `null` | canonicalised to UTC on write |
 | `tags` | string[] | ≤ 20, each ≤ 32, de-duplicated case-insensitively |
@@ -157,6 +157,13 @@ rest of the batch — a partial success is reported as a partial success, never
 The ceiling: **capture ends at the list.** Nothing the plugin does starts work by itself;
 "hand it to an agent" is always a human click.
 
+
+The gate has to be narrower than "remember things": a capture run that re-registers what the list
+already holds is how a trusted list becomes noise. So an item is refused, with the reason on the
+record, when its normalized title matches a live row, when a close paraphrase (Dice over character
+bigrams, 0.8) appears in the last 72 hours, or when the same errand was finished within 7 days.
+Archived and cancelled rows are history a person set aside and must not block a new one; the rules
+are pure and live in `lib/capture.js` so they can be tested without a store.
 ## A fallback must never quietly outrank the real rule
 
 The routes are fenced: the Host's connection service decides (`isTrustedApiRequest` against

package/docs/ROADMAP.md

@@ -97,6 +97,15 @@ asked / succeeded / failed / dropped (`explainAutoCollect` in `lib/settings.js`,
 in `lib/index.js`). A failed question releases its booking and retries after 1 / 5 / 25 minutes
 (`retryDelayMs`), and an ask that never settles is bounded by a ten-second timeout. An unknown
 working directory is never asked, because the exemption cannot be checked against it.
+**Batch completion and tagging, and archive** — `/bulk` applies a status or tag change across a
+selection in one request; a stale id is reported in `unmatched` instead of discarding the batch
+(`bulk()` in `lib/service.js`, `runBulk` in `lib/client.js`). `archived` joined the statuses, so a
+record can leave the active view without being deleted; the filter chip only appears once something
+is archived, and `global_todo_update` finally accepts `status`.
+**A capture gate, not a title comparison** — before `global_todo_capture` writes an item it asks
+`findDuplicate` (`lib/capture.js`): normalized title against live rows, a close paraphrase inside
+72 hours, and the same errand finished in the last 7 days. The decision is pure, the reason lands
+in `skipped[]`, and archived/cancelled rows deliberately do not block a new one.
 ### Partly landed
 
 - **Batch and multi-select** — the selection mode, its per-row markers and the batch

package/lib/capture.js

@@ -0,0 +1,104 @@
+/**
+ * Capture quality gate.
+ *
+ * `global_todo_capture` is the one path that can add several records at once, and a capture run
+ * that keeps re-registering what the list already has is how the list turns into noise. The
+ * first version compared normalised titles exactly against the active rows; that misses the
+ * common case — same errand, different wording — and it re-admits something that was finished
+ * yesterday. Both are pure decisions, so they live here and are tested without a store.
+ *
+ * @module dsh-global-todo/capture
+ */
+
+/** Titles closer than this are treated as the same errand. */
+const SIMILARITY = 0.8
+/** Only compare against rows from the last few days; older ones are history, not duplicates. */
+const DEDUPE_WINDOW_HOURS = 72
+/** A finished errand stays done this long before the same title may come back. */
+const DONE_COOLDOWN_DAYS = 7
+
+/**
+ * Fold a title to what it means: width, case, spacing and punctuation are noise.
+ *
+ * Numbers and dates are kept on purpose — "10 月 20 日交" and "10 月 21 日交" are different
+ * errands even though they differ by one character.
+ *
+ * @param {unknown} title
+ * @returns {string}
+ */
+export function normalizeTitle(title) {
+  return String(title ?? '').normalize('NFKC').toLowerCase().replace(/[\s\p{P}\p{S}]+/gu, '')
+}
+
+/** @param {string} text @returns {Set<string>} */
+function bigrams(text) {
+  const chars = [...text]
+  if (chars.length < 2) return new Set(chars)
+  const out = new Set()
+  for (let index = 0; index < chars.length - 1; index += 1) out.add(chars[index] + chars[index + 1])
+  return out
+}
+
+/**
+ * Dice coefficient over character bigrams: 0 when unrelated, 1 when identical.
+ *
+ * @param {unknown} left
+ * @param {unknown} right
+ * @returns {number}
+ */
+export function similarity(left, right) {
+  const a = bigrams(normalizeTitle(left))
+  const b = bigrams(normalizeTitle(right))
+  if (a.size === 0 || b.size === 0) return 0
+  let shared = 0
+  for (const gram of a) if (b.has(gram)) shared += 1
+  return (2 * shared) / (a.size + b.size)
+}
+
+/**
+ * Is this title already on the list, in a way a person would call a duplicate?
+ *
+ * @param {{ title?: unknown, existing?: object[], now?: number, similarity?: number, windowHours?: number, doneCooldownDays?: number }} input
+ * @returns {{ duplicate: boolean, reason?: string, matchId?: string }}
+ */
+export function findDuplicate(input) {
+  const title = input.title
+  const key = normalizeTitle(title)
+  if (key === '') return { duplicate: false }
+  const now = Number.isFinite(input.now) ? input.now : Date.now()
+  const windowMs = (input.windowHours ?? DEDUPE_WINDOW_HOURS) * 60 * 60 * 1000
+  const cooldownMs = (input.doneCooldownDays ?? DONE_COOLDOWN_DAYS) * 24 * 60 * 60 * 1000
+  const threshold = Number.isFinite(input.similarity) ? input.similarity : SIMILARITY
+  for (const todo of Array.isArray(input.existing) ? input.existing : []) {
+    if (todo === null || typeof todo !== 'object' || typeof todo.title !== 'string') continue
+    // Archived is history a person chose to keep out of the way; it must not block the same
+    // errand from being written again. Cancelled is likewise not a live duplicate.
+    if (todo.status === 'cancelled' || todo.status === 'archived') continue
+    const doneAt = Number.isFinite(todo.doneAt)
+      ? todo.doneAt
+      : Number.isFinite(todo.updatedAt) ? todo.updatedAt : 0
+    if (normalizeTitle(todo.title) === key) {
+      if (todo.status === 'done') {
+        if (now - doneAt < cooldownMs) return { duplicate: true, reason: 'recently-done', matchId: todo.id }
+      } else {
+        return { duplicate: true, reason: 'same-active', matchId: todo.id }
+      }
+    }
+    if (todo.status !== 'done') {
+      const created = Number.isFinite(todo.createdAt) ? todo.createdAt : now
+      // A five-day-old item is not evidence that today's wording is a duplicate; only the
+      // recent window is compared for similarity.
+      if (now - created < windowMs && similarity(title, todo.title) >= threshold) {
+        return { duplicate: true, reason: 'similar-active', matchId: todo.id }
+      }
+    }
+  }
+  return { duplicate: false }
+}
+
+/** The sentence a person reads in `skipped[].error`. */
+export const CAPTURE_REASONS = Object.freeze({
+  'same-active': '清单里已有同名的未完成条目，未重复登记',
+  'similar-active': '清单里已有一条很相似的未完成条目，未重复登记',
+  'recently-done': '这条刚完成不久（7 天内），没有重复登记',
+})

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 = 'ui24'
+    const UI_REV = 'ui25'
     /** Last language resolved for the shell; module-level so a fetch failure can be worded too. */
     let activeLang = 'zh'
 
@@ -75,6 +75,8 @@ window.__ModuleLoader__.load({
       'action.done': '完成',
       'action.reopen': '标回未完成',
       'action.doing': '标为进行中',
+      'action.archive': '归档',
+      'action.unarchive': '取消归档',
       'action.remove': '删除',
       'action.removeConfirm': '确认删除',
       'action.unlink': '摘掉',
@@ -102,6 +104,12 @@ window.__ModuleLoader__.load({
       'select.all': '全选',
       'select.allOn': '取消全选',
       'select.assign': '一键分配',
+      'select.complete': '完成',
+      'select.archive': '归档',
+      'field.bulkTag': '标签…',
+      'select.addTag': '加标签',
+      'notice.bulk': '已更新 {n} 条',
+      'notice.bulkPartial': '已更新 {n} 条，跳过 {m} 条',
       'select.clear': '清除',
       'select.done': '完成',
       'select.hint': '先勾几条待办，再点「一键分配」：优先回到写下它的那个对话，其次同工作区的对话，都找不到才让你选。',
@@ -173,6 +181,7 @@ window.__ModuleLoader__.load({
       'filter.doing': '进行中',
       'filter.done': '已完成',
       'filter.overdue': '逾期',
+      'filter.archived': '已归档',
       'filter.label': '筛选',
       'field.title': '要做什么？回车即存',
       'field.description': '描述：验收标准、已知的坑…',
@@ -276,6 +285,8 @@ window.__ModuleLoader__.load({
       'action.done': 'Done',
       'action.reopen': 'Reopen',
       'action.doing': 'Start',
+      'action.archive': 'Archive',
+      'action.unarchive': 'Unarchive',
       'action.remove': 'Delete',
       'action.removeConfirm': 'Confirm delete',
       'action.unlink': 'Remove',
@@ -303,6 +314,12 @@ window.__ModuleLoader__.load({
       'select.all': 'Select all',
       'select.allOn': 'Clear selection',
       'select.assign': 'Assign',
+      'select.complete': 'Complete',
+      'select.archive': 'Archive',
+      'field.bulkTag': 'Tag…',
+      'select.addTag': 'Add tag',
+      'notice.bulk': 'Updated {n}',
+      'notice.bulkPartial': 'Updated {n}, skipped {m}',
       'select.clear': 'Clear',
       'select.done': 'Done',
       'select.hint': 'Pick a few todos, then Assign: back to the conversation that wrote each one, else a conversation in the same workspace, else you choose.',
@@ -376,6 +393,7 @@ window.__ModuleLoader__.load({
       'filter.doing': 'Doing',
       'filter.done': 'Done',
       'filter.overdue': 'Overdue',
+      'filter.archived': 'Archived',
       'filter.label': 'Filters',
       'field.title': 'What needs doing? Enter to save',
       'field.description': 'Description: acceptance, known traps…',
@@ -1598,6 +1616,9 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                 done
                   ? { key: 'reopen', label: t('action.reopen'), icon: 'check', onSelect: () => onAction('reopen', todo) }
                   : { key: 'doing', label: t('action.doing'), icon: 'clock', onSelect: () => onAction('doing', todo) },
+                todo.status === 'archived'
+                  ? { key: 'unarchive', label: t('action.unarchive'), icon: 'check', onSelect: () => onAction('unarchive', todo) }
+                  : { key: 'archive', label: t('action.archive'), icon: 'doc', onSelect: () => onAction('archive', todo) },
                 {
                   key: 'remove',
                   label: confirming ? t('action.removeConfirm') : t('action.remove'),
@@ -1939,6 +1960,9 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       // The hidden file input behind 导入: a page cannot open a file dialog by itself.
       const importRef = useRef(null)
       const [selected, setSelected] = useState({})
+      // One tag field for the whole selection: typing a tag then pressing add applies it to
+      // every picked row in one request, which is the batch half that was missing.
+      const [bulkTag, setBulkTag] = useState('')
       const [assignBusy, setAssignBusy] = useState(false)
       const [assignAsk, setAssignAsk] = useState(null)
       const [groupMode, setGroupMode] = useState(() => readStoredGroupMode())
@@ -2619,6 +2643,10 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         if (kind === 'done') return run(todo.id, () => call('status', { method: 'POST', body: { id: todo.id, status: 'done' } }))
         if (kind === 'reopen') return run(todo.id, () => call('status', { method: 'POST', body: { id: todo.id, status: 'open' } }))
         if (kind === 'doing') return run(todo.id, () => call('status', { method: 'POST', body: { id: todo.id, status: 'doing' } }))
+        // Archive keeps the history without cluttering the list; delete stays a separate,
+        // deliberate action reached only through the two-step menu item.
+        if (kind === 'archive') return run(todo.id, () => call('status', { method: 'POST', body: { id: todo.id, status: 'archived' } }))
+        if (kind === 'unarchive') return run(todo.id, () => call('status', { method: 'POST', body: { id: todo.id, status: 'open' } }))
         if (kind === 'save') return run(todo.id, () => call('update', { method: 'POST', body: { id: todo.id, ...payload } }))
         if (kind === 'note') return run(todo.id, () => call('note', { method: 'POST', body: { id: todo.id, ...payload } }))
         if (kind === 'link') return run(todo.id, () => call('link', { method: 'POST', body: { id: todo.id, ...payload } }))
@@ -2664,7 +2692,32 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         return undefined
       }
 
-      const counts = state.counts ?? { total: 0, open: 0, doing: 0, done: 0, cancelled: 0, overdue: 0 }
+      /** Apply one change to the whole selection; a stale id is reported, not fatal. */
+      const runBulk = async (change) => {
+        const ids = Object.keys(selected)
+        if (ids.length === 0) return
+        try {
+          const data = await call('bulk', { method: 'POST', body: { ids, ...change } })
+          const skipped = (data?.unmatched?.length ?? 0) + (data?.errors?.length ?? 0)
+          setNotice({
+            text:
+              skipped > 0
+                ? t('notice.bulkPartial', { n: data?.updated ?? 0, m: skipped })
+                : t('notice.bulk', { n: data?.updated ?? 0 }),
+            sessionId: '',
+          })
+          setTimeout(() => setNotice(null), 6000)
+          setSelected({})
+          setError(null)
+          void reload()
+          void refreshHealth()
+        } catch (failure) {
+          reportFailure('bulk', { message: failure?.message })
+          setError(failure)
+        }
+      }
+
+      const counts = state.counts ?? { total: 0, open: 0, doing: 0, done: 0, cancelled: 0, archived: 0, overdue: 0 }
       const groups = useMemo(
         () => groupTodos(state.todos, Date.now(), groupMode, sessionTitles, t),
         [state.todos, groupMode, sessionTitles, lang],
@@ -2875,6 +2928,9 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                 ['doing', counts.doing],
                 ['done', counts.done],
                 ['overdue', counts.overdue],
+                // Only shown once something is archived: an empty filter that exists from
+                // day one is furniture, not a control.
+                ...(counts.archived > 0 ? [['archived', counts.archived]] : []),
               ].map(([key, count]) => filterChip(key, key === 'all' ? undefined : count)),
             ),
             h('span', { className: 'gt-divider' }),
@@ -3097,6 +3153,48 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                   },
                   assignBusy ? t('assign.working') : t('select.assign'),
                 ),
+                h(
+                  'button',
+                  {
+                    type: 'button',
+                    className: 'gt-btn gt-btn-quiet',
+                    disabled: Object.keys(selected).length === 0,
+                    onClick: () => void runBulk({ status: 'done' }),
+                  },
+                  t('select.complete'),
+                ),
+                h(
+                  'button',
+                  {
+                    type: 'button',
+                    className: 'gt-btn gt-btn-quiet',
+                    disabled: Object.keys(selected).length === 0,
+                    onClick: () => void runBulk({ status: 'archived' }),
+                  },
+                  t('select.archive'),
+                ),
+                h('input', {
+                  className: 'gt-input gt-bulk-tag',
+                  value: bulkTag,
+                  placeholder: t('field.bulkTag'),
+                  'aria-label': t('field.bulkTag'),
+                  onChange: (event) => setBulkTag(event.target.value),
+                }),
+                h(
+                  'button',
+                  {
+                    type: 'button',
+                    className: 'gt-btn gt-btn-quiet',
+                    disabled: Object.keys(selected).length === 0 || bulkTag.trim() === '',
+                    onClick: () => {
+                      const tag = bulkTag.trim()
+                      if (tag === '') return
+                      void runBulk({ addTags: [tag] })
+                      setBulkTag('')
+                    },
+                  },
+                  t('select.addTag'),
+                ),
                 h(
                   'button',
                   { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: () => setSelected({}) },

package/lib/index.js

@@ -35,7 +35,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.4.0'
+export const VERSION = '0.4.2'
 
 /** Plugin id. Also the Loader row id in `cordis.patch.yml`. */
 export const name = 'dsh-global-todo'

package/lib/model.js

@@ -20,7 +20,7 @@ import { LINK_KINDS, linkKey, normalizeLink } from './links.js'
 export const SCHEMA_VERSION = 1
 
 /** Lifecycle states. `doing` is the explicit "an agent (or I) am on it" state. */
-export const STATUSES = Object.freeze(['open', 'doing', 'done', 'cancelled'])
+export const STATUSES = Object.freeze(['open', 'doing', 'done', 'cancelled', 'archived'])
 
 /** Priorities are deliberately coarse: three levels people actually use. */
 /**
@@ -653,17 +653,17 @@ export function recordDispatch(todo, info, options = {}) {
  * @returns {boolean}
  */
 export function isOverdue(todo, now = Date.now()) {
-  if (todo.dueAt === null || todo.status === 'done' || todo.status === 'cancelled') return false
+  if (todo.dueAt === null || todo.status === 'done' || todo.status === 'cancelled' || todo.status === 'archived') return false
   const due = Date.parse(todo.dueAt)
   return Number.isFinite(due) && due < now
 }
 
 /**
  * @param {object[]} todos
- * @returns {{ total: number, open: number, doing: number, done: number, cancelled: number, overdue: number }}
+ * @returns {{ total: number, open: number, doing: number, done: number, cancelled: number, archived: number, overdue: number }}
  */
 export function counts(todos, now = Date.now()) {
-  const out = { total: todos.length, open: 0, doing: 0, done: 0, cancelled: 0, overdue: 0 }
+  const out = { total: todos.length, open: 0, doing: 0, done: 0, cancelled: 0, archived: 0, overdue: 0 }
   for (const todo of todos) {
     if (todo.status in out) out[todo.status] += 1
     if (isOverdue(todo, now)) out.overdue += 1

package/lib/routes.js

@@ -468,6 +468,15 @@ export function createRoutes(deps) {
       return dispatcher.assignMany(body ?? {})
     }),
 
+    exact('POST', `${ROUTE_BASE}/bulk`, async (request) => {
+      const body = await readJsonBody(request)
+      return service.bulk(
+        body.ids,
+        { status: body.status, addTags: body.addTags, removeTags: body.removeTags },
+        { by: actorOf(body) },
+      )
+    }),
+
     exact('POST', `${ROUTE_BASE}/capture`, async (request) => {
       const body = await readJsonBody(request)
       return dispatcher.requestCapture(body ?? {})

package/lib/service.js

@@ -33,7 +33,7 @@ import {
 } from './model.js'
 
 /** Filters the panel and the tools may ask for. */
-export const FILTERS = Object.freeze(['all', 'active', 'open', 'doing', 'done', 'cancelled', 'overdue'])
+export const FILTERS = Object.freeze(['all', 'active', 'open', 'doing', 'done', 'cancelled', 'archived', 'overdue'])
 
 /** Sort keys the panel and the tools may ask for. */
 export const SORTS = Object.freeze(['created', 'updated', 'due', 'priority'])
@@ -618,6 +618,54 @@ export function createService(options) {
     })
   }
 
+  /**
+   * Apply one change to several todos.
+   *
+   * Each record goes through the same validation and trail as a single edit. A stale id is
+   * reported in `unmatched` instead of failing the batch: a selection is a human gesture, and
+   * one row that moved must not discard the other nine.
+   *
+   * @param {string[]} ids
+   * @param {{ status?: string, addTags?: string[], removeTags?: string[] }} change
+   * @param {{ by?: 'human' | 'agent' }} [context]
+   * @returns {Promise<{ updated: number, ids: string[], unmatched: string[], errors: { id: string, error: string }[] }>}
+   */
+  async function bulk(ids, change = {}, context = {}) {
+    const wanted = Array.isArray(ids) ? ids.filter((id) => typeof id === 'string' && id.trim() !== '') : []
+    if (wanted.length === 0) throw new TodoError('invalid-body', '要改哪些待办？给一个非空的 ids')
+    const hasStatus = typeof change.status === 'string' && change.status !== ''
+    const addTags = Array.isArray(change.addTags) ? change.addTags : []
+    const removeTags = Array.isArray(change.removeTags) ? change.removeTags : []
+    if (!hasStatus && addTags.length === 0 && removeTags.length === 0) {
+      throw new TodoError('invalid-body', '批量修改需要 status / addTags / removeTags 之一')
+    }
+    const updated = []
+    const unmatched = []
+    const errors = []
+    for (const id of wanted) {
+      try {
+        const todo = await store.update((doc) => {
+          const target = doc.todos.find((candidate) => candidate.id === id)
+          if (target === undefined) return { result: null }
+          const patch = {}
+          if (hasStatus) patch.status = change.status
+          if (addTags.length > 0 || removeTags.length > 0) {
+            const merged = new Map(target.tags.map((tag) => [tag.toLowerCase(), tag]))
+            for (const tag of addTags) merged.set(String(tag).toLowerCase(), String(tag))
+            for (const tag of removeTags) merged.delete(String(tag).toLowerCase())
+            patch.tags = [...merged.values()]
+          }
+          const changed = applyPatch(target, patch, { ...modelOptions(context.by), ...linkOptions() })
+          return changed.length === 0 ? { result: target } : { next: doc.todos, result: target }
+        })
+        if (todo === null) unmatched.push(id)
+        else updated.push(id)
+      } catch (error) {
+        errors.push({ id, error: error instanceof TodoError ? error.message : String(error?.message ?? error) })
+      }
+    }
+    return { updated: updated.length, ids: updated, unmatched, errors }
+  }
   /** @returns {Promise<object>} counts for the panel header and tool summaries */
   async function stats() {
     const todos = await store.all()
@@ -637,6 +685,7 @@ export function createService(options) {
     findBySession,
     remove,
     restore,
+    bulk,
     addLink,
     removeLink,
     recordDispatch,

package/lib/tools.js

@@ -13,6 +13,7 @@
  * @module dsh-global-todo/tools
  */
 
+import { CAPTURE_REASONS, findDuplicate } from './capture.js'
 import { asTodoError } from './errors.js'
 import { formatLink } from './links.js'
 import { LIMITS, PRIORITIES, PRIORITY_LABELS, STATUSES } from './model.js'
@@ -384,27 +385,30 @@ export function createTools(service, options = {}) {
         const origin = originOf(exec)
         const todos = []
         const skipped = []
-        // A capture run that keeps re-registering what is already on the list is how the
-        // list fills with near-duplicates. One lookup, then skip by normalised title.
+        // The quality gate decides per item: exact title, a close paraphrase within the
+        // recent window, or the same errand finished days ago. One lookup of everything —
+        // done and archived rows matter too, which the active-only lookup used to miss.
         let existing = []
         try {
-          existing = (await service.list({ status: 'active' })).todos
+          existing = (await service.list({ status: 'all', limit: 1000 })).todos
         } catch {
           existing = []
         }
-        const keyOf = (title) =>
-          String(title ?? '').trim().toLowerCase().replace(/\s+/g, '')
-        const seen = new Set(existing.map((todo) => keyOf(todo.title)))
+        const nowMs = now()
         for (const item of items) {
-          const itemKey = keyOf(item?.title)
-          if (itemKey !== '' && seen.has(itemKey)) {
-            skipped.push({ title: String(item?.title ?? '(无标题)'), error: '清单里已有同名的未完成条目，未重复登记' })
+          const verdict = findDuplicate({ title: item?.title, existing, now: nowMs })
+          if (verdict.duplicate === true) {
+            skipped.push({
+              title: String(item?.title ?? '(无标题)'),
+              error: CAPTURE_REASONS[verdict.reason] ?? '清单里已有重复条目，未重复登记',
+            })
             continue
           }
           const outcome = await attempt(() => service.create(item ?? {}, { by: 'agent', origin }))
           if (outcome.ok === true) {
-            if (itemKey !== '') seen.add(itemKey)
             todos.push(presentTodo(outcome.value, now()))
+            // Later items in the same batch must see this one as existing.
+            existing.push(outcome.value)
           }
           else skipped.push({ title: String(item?.title ?? '(无标题)'), error: outcome.error })
         }
@@ -423,7 +427,7 @@ export function createTools(service, options = {}) {
         properties: {
           status: {
             type: 'string',
-            enum: ['all', 'active', 'open', 'doing', 'done', 'cancelled', 'overdue'],
+            enum: ['all', 'active', 'open', 'doing', 'done', 'cancelled', 'archived', 'overdue'],
             description: '缺省 active',
           },
           query: { type: 'string', description: '在标题、描述、标签、附件里模糊匹配' },
@@ -518,7 +522,7 @@ export function createTools(service, options = {}) {
     {
       name: 'global_todo_update',
       description:
-        '改一条全局待办。只传要改的字段；`dueAt: ""` 清空截止时间，`tags: []` 清空标签，`links` 是整体替换（要单独加附件请用 global_todo_link）。',
+        '改一条全局待办。只传要改的字段；`dueAt: ""` 清空截止时间，`tags: []` 清空标签，`links` 是整体替换（要单独加附件请用 global_todo_link），`status` 可以设为 archived（归档，不删除）。',
       parameters: {
         type: 'object',
         properties: {
@@ -526,6 +530,9 @@ export function createTools(service, options = {}) {
           title: { type: 'string' },
           description: { type: 'string' },
           priority: { type: 'string', enum: [...PRIORITIES] },
+          // `status` belongs here: marking something in progress used to require the tool
+          // named `global_todo_done`, and archiving had no entry point at all.
+          status: { type: 'string', enum: [...STATUSES], description: 'open / doing / done / cancelled / archived' },
           dueAt: { oneOf: [{ type: 'string' }, { type: 'null' }], description: '空串或 null 表示清空' },
           tags: { type: 'array', items: { type: 'string' } },
           links: LINKS_INPUT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-global-todo",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "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",