@aiquants/daily-report 0.46.1 → 0.47.0

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 All notable changes to `@aiquants/daily-report` are documented here.
 
+## 0.47.0 (2026-10-16)
+
+版番号は 0.47.0 (minor) とする: 状態の表に列を求め、公開の型・アクション・SSE のワイヤの形を変える (下の Breaking)。
+
+### Added
+
+- **既読の後の更新**: 閲覧者が既読にした後に日報の中身が変わると、閲覧者に見分けられるようにする。サーバーは日報を読むたびに日報自身の中身の版
+  (`DailyReportDetail.contentDigest`: 件名・本文・営業日・区分・作成区分・訪問時間・顧客名・面談者・添付の名前と大きさと登録日時を、届く JSON のとおりに
+  並べた SHA-256。小文字の 16 進 64 桁) を求め、既読の印は閲覧者の画面が見せている版を閲覧者の状態の行へ記録する (`DailyReportDetail.readContentDigest`)。
+  コメント・ラベル (下書きの公開)・人と時刻の欄・スターと既読は版を変えないので、コメントや同じ中身の取り込み直しは更新に数えない。
+  記録した版が今の版と違えば、持ち主でない閲覧者には両ビューのカードと側面ペインの操作の列に札 (`labels.updatedSinceRead`: `Updated` / `更新あり`。
+  `data-daily-report-updated-since-read`、読み上げから隠す) と既読の切り替えの更新のアイコンを見せ、切り替えの名前は `labels.markUpdateRead`
+  (`Mark the update as read` / `更新を既読にする`)、行の状態は `Read, updated since` / `既読後に更新あり`。押すと既読のまま版を今の版へ進める。
+  持ち主は自分の書いた更新を知らされない。側面ペインの自動既読も、既読の後に更新された日報を今の版で既読にする。
+  ほかの利用者の更新は SSE で新しい中身の版として届き、閲覧者の読んだ版は手元の値を保つので、読み直さずに既読の後の更新になる。
+  共有の入口は、公開した宣言が参照する `DailyReportReadMark`・`DailyReportReadState`・`DailyReportReadStatus` を型として公開する。
+
+### Breaking
+
+- **状態の表に読んだ版の列が要る**: `DailyReportUserStatus` に `read_content_digest char(64) NULL` を足してから上げる
+  (`defineDailyReportSchema` は宣言する)。注入する表の `tables.userStatus.readContentDigest` が無いか `char(64)` でなければ、サービスの生成のときに
+  `RangeError` (`[daily-report] tables.userStatus.readContentDigest must be a char(64) column (the version the viewer marked read, 64 lowercase hex digits); got <SQL の型>`)
+  で止まる。列の無かった頃に書かれた既読の行は版を持たず (NULL)、既読として読む。
+  Migration: `ALTER TABLE <schema>.DailyReportUserStatus ADD read_content_digest char(64) NULL` を流し、ホストの drizzle のモデルに
+  `readContentDigest: char("read_content_digest", { length: 64 })` を足す。
+- **`DailyReportDetail` に必須の `contentDigest: string` と `readContentDigest: string | null` が増える**: 詳細の読み手 (`dailyReportDetailSchema`) は
+  どちらも既定値で補わずに求める。Migration: 詳細を自分で組むホスト (試験の代役を含む) は 2 つの欄を詰める。
+- **既読の切り替えは既読の印を受ける**: クライアントの `toggleRead(reportHubId, mark, businessDate)` とサービスの
+  `setReadStatus(scope, userId, reportHubId, businessDate, mark, clientTempId)` は真偽の代わりに `DailyReportReadMark`
+  (`{ isRead: true, contentDigest }` か `{ isRead: false }`) を受ける。サービスは形の誤った版を、どのクエリよりも前に `RangeError`
+  (`[daily-report] setReadStatus: contentDigest must be 64 lowercase hex digits; got <値>`) で断る。action の `toggleRead` のフォームは `isRead=true` のとき
+  `contentDigest` を求め (`contentDigest required`・`Invalid contentDigest`)、`isRead=false` のときは拒む (`contentDigest is not allowed when isRead is false`)。
+  スターと既読の切り替えの答えの `updatedStatus` は `readContentDigest` を持つ。アクションの台帳の `pendingReadUpdates` の値は真偽から
+  `DailyReportReadStatus` (`{ isRead, readContentDigest }`) になる。
+  Migration: 自分で既読を書くホストは、見せている詳細の `contentDigest` で `{ isRead: true, contentDigest }` を渡す (未読は `{ isRead: false }`)。
+- **ラベルの `rowState` は読みの状態を受ける**: `rowState({ readState, isStarred })` (`readState` は `unread`・`read`・`updatedSinceRead`)。
+  ラベルのキーが 2 つ増える (`markUpdateRead`・`updatedSinceRead`。固有のキーは 113、全体は 124)。
+  Migration: `rowState` を上書きするホストは `isRead` の代わりに `readState` を読む。
+- **SSE のワイヤの版は v5**: ストリームのキーは `<接頭辞>:sse-stream:v5`。日報を埋め込む知らせの詳細は 2 つの版を、状態の知らせ (`status-update`) は
+  書いた後の行の `readContentDigest` を必須で運ぶ。v4 のストリームは書かれなくなり (手で消せる)、配備をまたいで開いていた前の版のタブは読み直すまで
+  SSE の更新を受けない。データベースへ書くワーカーは一緒に配備する。
+- **依存の `@aiquants/sse` は ^0.3.0**: 公開の範囲が ^0.2.0 から上がる (0.3.0 はサーバーの `createSseResponse` に、省けば切ってある `compressible` を足しただけで、日報の振る舞いは変わらない)。
+
 ## 0.46.1 (2026-10-16)
 
 版番号は 0.46.1 (patch) とする: 公開の型は変えず、外部ソースの日報へ誤って書き込む経路を閉じる。

package/README.md

@@ -30,6 +30,7 @@ domain-specific knowledge. It is one module with four entries:
   - [Source-type visibility](#source-type-visibility)
     - [Contract](#contract)
   - [Comment visibility](#comment-visibility)
+  - [Read after update](#read-after-update)
   - [Attachments](#attachments)
     - [Configuration](#configuration)
     - [Read port](#read-port)
@@ -229,6 +230,11 @@ const tables = defineDailyReportSchema("dbo_app", { userTable: Users })
 (`[daily-report] tables.hub.sourceType must be an nvarchar(n) column with a declared length (source types compare as UTF-16 bytes); got "<SQL type>"`).
 Every write to an existing report starts its transaction with an update of the report's live hub row that changes no value and outputs the row, so
 the hub's `update` must support drizzle's `output()` (a hand-written database stand-in answers it).
+`DailyReportUserStatus.read_content_digest` must be a `char(64)` column that allows NULL (`defineDailyReportSchema` declares it): the version of the
+report's content the viewer marked read ([Read after update](#read-after-update)), and `createDailyReportService` stops with a `RangeError` for any
+other column and for a missing one (`[daily-report] tables.userStatus.readContentDigest must be a char(64) column (the version the viewer marked read,
+64 lowercase hex digits); got <SQL type>`). An existing table takes the column with `ALTER TABLE … ADD read_content_digest char(64) NULL` before the
+package is upgraded; a row written before it has no version, which reads as read.
 
 The text search adds two optional tables in a schema of their own (see [Text search](#text-search)); `defineDailyReportSearchSchema(schemaName)`
 defines them, and a host may inject its own models of the same shape. The service also needs `execute` on `DailyReportDb` (drizzle's `db.execute`; the
@@ -519,7 +525,10 @@ its payload — with one strict parser each, after authentication and before any
     200 for `defineDailyReportSchema`'s `nvarchar(200)`, which counts code units as `String.length` does, so a surrogate pair takes 2); a longer one
     is `Invalid title`. The package's client always sends both fields as typed.
   - **`toggleStar` / `toggleRead`**: `isStarred` / `isRead` is exactly `true` or `false`. Anything else — `TRUE`, `1`, `yes`, the empty text — is
-    `Invalid isStarred` / `Invalid isRead`, and a missing one is `isStarred required` / `isRead required`.
+    `Invalid isStarred` / `Invalid isRead`, and a missing one is `isStarred required` / `isRead required`. `toggleRead` with `isRead=true` also
+    carries `contentDigest`, the version of the report the viewer's page shows (64 lowercase hex digits; a missing one is `contentDigest required`,
+    any other text `Invalid contentDigest`), and with `isRead=false` it carries none (`contentDigest is not allowed when isRead is false`;
+    [Read after update](#read-after-update)).
   - **`addComment`**: `content` is a non-empty text (`Content required` otherwise). **`deleteComment`**: `commentId` (**Ids** above).
   - **Visibility, then the user**: once the form is read and checked, the action resolves the viewer's source-type visibility once
     ([Source-type visibility](#source-type-visibility)). When the port throws or answers outside its contract, the action answers 503
@@ -608,7 +617,7 @@ its payload — with one strict parser each, after authentication and before any
   shared draft-label test, beside the hub row) or true when its creation category is one of the names; a row whose flag reads as anything but 1 or 0
   throws.
   The client compares no name: the views open the viewer's own draft in the editor by `isDraft` alone, so a draft named by any of the names, or by a
-  variant the collation equates, behaves as one ([Client wiring](#client-wiring)). The SSE stream's key carries the wire version (`<redisKeyPrefix>:sse-stream:v4`; [Realtime architecture](#realtime-architecture)),
+  variant the collation equates, behaves as one ([Client wiring](#client-wiring)). The SSE stream's key carries the wire version (`<redisKeyPrefix>:sse-stream:v5`; [Realtime architecture](#realtime-architecture)),
   so an entry written before `isDraft` existed is never read.
 - `resolveVisibleSourceTypes(request, { reason })` — **Required row-level authorization port.** Returns the `Hub.source_type` values this request may
   view, or the explicit opt-out `{ unrestricted: "<reason>" }` of a deployment that does not restrict by source type. Applies uniformly to every server
@@ -673,7 +682,7 @@ its payload — with one strict parser each, after authentication and before any
   Every number among them is an integer of at least 1, and only an omitted one takes its default: `0`, a negative number, `NaN`, a fraction or 2^53
   stops `createDailyReportService` and `createDailyReportServer` with a `RangeError` that names the key
   (`[daily-report] idsTtlMs must be an integer >= 1; got 0`).
-- `redisKeyPrefix` (`daily-report` by default) — the prefix of every Redis key of the service: the SSE stream `<prefix>:sse-stream:v4` and the
+- `redisKeyPrefix` (`daily-report` by default) — the prefix of every Redis key of the service: the SSE stream `<prefix>:sse-stream:v5` and the
   cross-worker epochs `<prefix>:ids:epoch`, `<prefix>:date-epoch:<business date>` and `<prefix>:detail-epoch:<report id>`. Environments that share
   one Redis (development and production, say) each pass their own prefix, so that neither reads the other's notifications nor drops the other's
   cached reads. The prefix is one or more characters without whitespace or control characters, neither
@@ -922,6 +931,27 @@ resolveVisibleSourceTypes: async (request, { reason }) => {
 - **Cache**: the dimension is folded into the cache-key digest, so revoking only the comment grant invalidates immediately. When `comment` follows
   `read` (the default) the digest equals the single-dimension digest of `read`, so such a deployment's cache keys do not depend on the dimension.
 
+### Read after update
+
+A viewer who marked a report read sees when its content changed afterwards. The server computes the version of a report's own content on every read
+(`DailyReportDetail.contentDigest`: 64 lowercase hex digits, one SHA-256 over the subject, body, business date, category, creation category, visit
+times, customer name, interviewers (name and affiliation) and attachments (file name, size and registration time) in a fixed order, as the JSON the
+client receives carries them), and a read mark records the version the viewer's page showed (`DailyReportDetail.readContentDigest`, the viewer's
+`DailyReportUserStatus.read_content_digest`; null for an unread report and for a read row that recorded no version). Comments, labels (a draft's
+publication), people, times, stars and the read flag never change the version, so a new comment or a re-import of the same content is no update.
+
+- **Read state** (`DailyReportReadState`, what both views and `labels.rowState` read): `unread` when the flag is false; `read` when the recorded
+  version is null or equals the current one; otherwise `updatedSinceRead`, except for the report's owner, who sees `read` (their own edits are no
+  news to them). A viewer without an id owns no report.
+- **Marks**: a report updated since read draws the pill `labels.updatedSinceRead` (`Updated` / `更新あり`; `data-daily-report-updated-since-read`,
+  hidden from assistive technology) between the source badge and the star, its read toggle shows an update icon and is named
+  `labels.markUpdateRead` (`Mark the update as read` / `更新を既読にする`), and its row state reads `Read, updated since` / `既読後に更新あり`.
+- **Toggle**: `toggleRead(reportHubId, mark, businessDate)` takes a `DailyReportReadMark`: `{ isRead: false }` for a read report, and
+  `{ isRead: true, contentDigest }` with the shown report's `contentDigest` for an unread one and for one updated since read (marking the update
+  read keeps the flag and moves the version). The List side pane's auto-read marks any shown report that is not `read`.
+- **Live**: another user's edit reaches the viewer as a new `contentDigest` while the viewer's own `readContentDigest` is kept, so a report the viewer
+  read turns `updatedSinceRead` without a reload. The toggles' `updatedStatus` and every `status-update` message carry the row's `readContentDigest`.
+
 ### Attachments
 
 Attachment bytes are served by `dailyReportServer.attachment.loader` at `GET {apiBasePath}/attachment/{token}`. The query string names exactly one
@@ -1647,7 +1677,7 @@ and without the retry the victim would answer 500 and lose what it wrote.
 
 ### Realtime architecture
 
-1. Mutation services publish to Redis Stream (`<redisKeyPrefix>:sse-stream:v4`, `daily-report:sse-stream:v4` by default: the key carries the wire version of the
+1. Mutation services publish to Redis Stream (`<redisKeyPrefix>:sse-stream:v5`, `daily-report:sse-stream:v5` by default: the key carries the wire version of the
    stream's messages and their embedded report, so a deployment that changes a required key of them reads no entry an older version wrote, and the stream of the previous version
    stops growing and can be deleted by hand; a host that reads or writes the stream itself, such as an integration test, builds the key with the
    server entry's `buildDailyReportRedisKeys(redisKeyPrefix).sseStream` instead of restating the version) in sequence:
@@ -3199,7 +3229,8 @@ the resize handle and the side pane lie outside the list.
   detail, an open editor, its comments, its thumbnails) renders under the next, and coming back to a report mounts its attachments once (one
   conditional request per loaded thumbnail) and shows an editor it left open as it was left, with what was typed (**Editing** below). The chosen tab
   (article or relations) belongs to the pane, and to the mobile overlay, and is kept across reports.
-  Auto-read and the article tab's scroll to the top follow the displayed report. Auto-read marks an unread report read once the pane has dwelt on it
+  Auto-read and the article tab's scroll to the top follow the displayed report. Auto-read marks a shown report that is not read (unread, or updated since the viewer read it: [Read after update](#read-after-update)) read at
+  its shown version once the pane has dwelt on it
   for 500 ms: on the desktop layout while the pane has caught up with the selection (the displayed report is the selected one and the pane is not
   `aria-busy`), in the mobile overlay while the overlay is open. The clock stops when the pane stops dwelling (a newer key, a held key's stream, the
   overlay sliding out)
@@ -3216,7 +3247,7 @@ the resize handle and the side pane lie outside the list.
   `"false"` on every other, so Chromium adds no implicit selection. Its surface is the row's one `gridcell`, named by the row's name element, so a
   cell is never named by the whole card.
   A List row with a card is named by its card's primary button, whose content is "YYYY-MM-DD creator" (`aria-labelledby`), and described by the row
-  state (`labels.rowState`: read or unread, and starred), the markers the card paints, the preview and, while the screen holds a search marks store,
+  state (`labels.rowState`: unread, read or read and updated since, and starred), the markers the card paints, the preview and, while the screen holds a search marks store,
   the match description; the button itself is described first by its position in the list (`labels.listRowPosition`, a visually hidden text: en
   "3 of 40", ja 「全 40 件中 3 件目」), because touch screen readers land on the button, which carries no position attribute.
   A DetailList row with a body is named by its report heading (date, author and subject; `aria-labelledby`) and described by the row state, the
@@ -4184,9 +4215,9 @@ locale**: English (`"en"`, the default) and Japanese (`"ja"`). Pick the language
 />
 ```
 
-- **One surface for all wording.** The catalog covers the 11 engine chrome keys of `@aiquants/virtualscroll` plus 111 own keys: field headings, the
-  page title (`title`, passed to `renderHeader` and used as the accessible name of both lists), the lists' keyboard help, the row states (read and
-  starred, editing) and the List card's position read to screen readers, tabs, buttons, placeholders, the `confirm()` text, stream badges, the search box, its filter row and the
+- **One surface for all wording.** The catalog covers the 11 engine chrome keys of `@aiquants/virtualscroll` plus 113 own keys: field headings, the
+  page title (`title`, passed to `renderHeader` and used as the accessible name of both lists), the lists' keyboard help, the row states (read, read and updated since, and
+  starred, editing), the updated-since-read pill and the List card's position read to screen readers, tabs, buttons, placeholders, the `confirm()` text, stream badges, the search box, its filter row and the
   search's match indicator, the status screen and the page's status region and the mutation-failure message with its repeat count. The engine part of
   each catalog is `@aiquants/virtualscroll`'s own catalog of the same locale, reused by value, so the scroll arrows, the names of the scroll bar and
   its thumb, and the "No items" text always speak the same language as the rest.
@@ -4199,7 +4230,7 @@ locale**: English (`"en"`, the default) and Japanese (`"ja"`). Pick the language
   `streamRetrying(loaded)`, `reportLoadFailed(reportHubId)`, `reportSummaryLoadFailed(reportHubId)`,
   `interviewerWithAffiliation(name, affiliation)`, `operationFailed(operation)` (`operation` is a
   `DailyReportOperation`: `create` / `update` / `publish` / `delete` / `addComment` / `deleteComment` /
-  `toggleStar` / `toggleRead`), `noticeRepeated(count)`, `rowState({ isRead, isStarred })`, `rowEditingState({ isDraft })`, `listRowPosition(position, total)`,
+  `toggleStar` / `toggleRead`), `noticeRepeated(count)`, `rowState({ readState, isStarred })`, `rowEditingState({ isDraft })`, `listRowPosition(position, total)`,
   `listRowPositionInUnknownTotal(position)`,
   `searchHitCount(count)`, `searchFailed(failure)` (`failure` is `invalid` / `busy` / `unavailable` / `failed`),
   `searchMatchedKeywords(matched, total)`, `searchMatchedKeywordsDescription(matched, total)`, `searchFieldMatched(field)` and
@@ -4210,7 +4241,7 @@ locale**: English (`"en"`, the default) and Japanese (`"ja"`). Pick the language
   locale built once (the row positions and counts re-render on every stream publish); a host override receives
   the raw number and formats it itself.
 - **Fail-fast**: an unsupported `locale` (`"EN"`, `"ja-JP"`, `"fr"`, `""`, `null`, ...) throws a
-  `RangeError` at render. So do an unknown `labels` key (a key error that lists the 122 keys), a string
+  `RangeError` at render. So do an unknown `labels` key (a key error that lists the 124 keys), a string
   key whose value is not a string with non-whitespace content, and a formatter key whose value is not a
   function. An `undefined` value keeps the catalog value.
 - **`config` has a closed key set**: `apiBasePath`, `ssePath`, `locale`, `labels`,
@@ -4248,7 +4279,7 @@ locale**: English (`"en"`, the default) and Japanese (`"ja"`). Pick the language
   grouping follows `locale` (`en` → `"en-US"`, `ja` → `"ja-JP"`) and dates stay in ISO form. Packages
   that do format dates (for example `@aiquants/period-slider`) name that separate axis `formatLocale`.
 
-Exported API (`@aiquants/daily-report/client`): `DAILY_REPORT_LABEL_KEYS` (all 122 keys, the 11 engine keys
+Exported API (`@aiquants/daily-report/client`): `DAILY_REPORT_LABEL_KEYS` (all 124 keys, the 11 engine keys
 first), `DAILY_REPORT_LABEL_CATALOGS` (the frozen catalogs), `resolveDailyReportLabels(locale, labels)`
 (the effective frozen labels — the catalog object itself when `labels` is `undefined`), the resolved
 `locale` / `labels` on `useDailyReportConfig()`, and the types `DailyReportLocale` (= `VirtualScrollLocale`),
@@ -4322,6 +4353,8 @@ first), `DAILY_REPORT_LABEL_CATALOGS` (the frozen catalogs), `resolveDailyReport
 | `starRemove` | star toggle (starred) | Remove star | スターを外す |
 | `markRead` | read toggle (unread) | Mark as read | 既読にする |
 | `markUnread` | read toggle (read) | Mark as unread | 未読にする |
+| `markUpdateRead` | read toggle (updated since the viewer read it; [Read after update](#read-after-update)) | Mark the update as read | 更新を既読にする |
+| `updatedSinceRead` | pill of a report updated since the viewer read it (hidden from assistive technology; the row state says it) | Updated | 更新あり |
 | `deleteReport` | report delete button | Delete | 削除する |
 | `edit` | edit button of the viewer's own report (`aria-label` / tooltip) | Edit | 編集 |
 | `resizeHandle` | list / detail resize handle `aria-label` | Resize the border between the report list and the detail pane | 日報一覧と詳細ペインの境界のサイズ変更ハンドル |
@@ -4366,7 +4399,7 @@ first), `DAILY_REPORT_LABEL_CATALOGS` (the frozen catalogs), `resolveDailyReport
 | `interviewerWithAffiliation` | interviewer chip | `("Sato", "Acme")` → Sato (Acme) | `("佐藤", "山田商事")` → 佐藤 (山田商事) |
 | `operationFailed` | the error notice / `DailyReportErrorInfo.message` | `("update")` → Failed to save the report. Please try again later. | `("update")` → 日報の保存に失敗しました。時間をおいて再度お試しください。 |
 | `noticeRepeated` | the error notice, beside its message when failures with the same message follow one another (`count` is how many came in a row, from 2; part of the notice's name) | `(2)` → (2 times) | `(2)` → (2 回目) |
-| `rowState` | visually hidden row state, the first description of a card row in both views and the second of the List card's primary button | `({ isRead: false, isStarred: true })` → Unread, starred | `({ isRead: false, isStarred: true })` → 未読、スター付き |
+| `rowState` | visually hidden row state, the first description of a card row in both views and the second of the List card's primary button | `({ readState: "unread", isStarred: true })` → Unread, starred; `updatedSinceRead` → Read, updated since | `({ readState: "unread", isStarred: true })` → 未読、スター付き; `updatedSinceRead` → 既読後に更新あり |
 | `rowEditingState` | visually hidden state of a DetailList row that shows its edit form in place of the card (the viewer's own draft opens there by itself), the row's description | `({ isDraft: true })` → Editing draft; `({ isDraft: false })` → Editing | `({ isDraft: true })` → 下書きを編集中; `({ isDraft: false })` → 編集中 |
 | `listRowPosition` | visually hidden position of a List card in the list, the first description of its primary button (`position` is 1-based; `total` is the size of the views' set) | `(3, 1234)` → 3 of 1,234 | `(3, 1234)` → 全 1,234 件中 3 件目 |
 | `listRowPositionInUnknownTotal` | the same position while the size of the views' set is unknown (the ids stream has not declared its total yet), in place of `listRowPosition`; it also ends the description of a card row in both views while the size is unknown | `(3)` → Item 3 | `(3)` → 3 件目 |
@@ -4520,8 +4553,10 @@ Documenting a name here is no reason to export it, and the values that tune the
   - Types reached by the closure: `DailyReportAttachmentState` (the verification state of an attachment's object), `DailyReportBusinessDateInput`
     (what `normalizeBusinessDateKey` takes), `DailyReportUIComment` (a comment as `useDailyReportComments` returns it), `DailyReportIdsStreamCursor`
     (the ids stream's resume cursor),
-    `DailyReportSseTerminalEvent` (one name of `DAILY_REPORT_SSE_TERMINAL_EVENTS`) and `DailyReportLogger` (the console-compatible logger the server's
-    `logger` takes).
+    `DailyReportSseTerminalEvent` (one name of `DAILY_REPORT_SSE_TERMINAL_EVENTS`), `DailyReportLogger` (the console-compatible logger the server's
+    `logger` takes), and the read state of the read-after-update marks ([Read after update](#read-after-update)): `DailyReportReadMark` (what
+    `toggleRead` writes: `{ isRead: true, contentDigest }` or `{ isRead: false }`), `DailyReportReadState` (`unread`, `read` or `updatedSinceRead`,
+    what `labels.rowState` reads) and `DailyReportReadStatus` (`{ isRead, readContentDigest }`, the value of `pendingReadUpdates`).
   - The text search's wire: `DAILY_REPORT_SEARCH_COMBINES` with its type `DailyReportSearchCombine` (the `combine` values, `intersection` and
     `union`), `DailyReportSearchHit` (one hit as the server holds it before the column-wise answer),
     `DAILY_REPORT_SEARCH_BATCHES_IN_FLIGHT` (2, the batched reads the package's client keeps in flight per API base path, from which the server sizes
@@ -4607,7 +4642,7 @@ Documenting a name here is no reason to export it, and the values that tune the
     decode-work and walk bounds, for a host's conformance checks) / `DAILY_REPORT_ATTACHMENT_THUMBNAIL_OUTPUT_MEDIA_TYPES` /
     `DAILY_REPORT_ATTACHMENT_THUMBNAIL_MAX_OUTPUT_BYTES`.
   - SSE and caching: `buildDailyReportRedisKeys(redisKeyPrefix)` (`DailyReportRedisKeys`: the keys the service builds under the prefix, the SSE
-    stream `sseStream` with the wire version, `<prefix>:sse-stream:v4`, and the epoch keys `idsEpoch`, `dateEpochPrefix` and `detailEpochPrefix`,
+    stream `sseStream` with the wire version, `<prefix>:sse-stream:v5`, and the epoch keys `idsEpoch`, `dateEpochPrefix` and `detailEpochPrefix`,
     for a host that reads or writes the stream or the epochs itself) / `DailyReportSseReader` /
     `readDailyReportSseStreamEntry(raw, logger)` (reads one Redis stream entry, `{ id, message }` as the client returns it, once: `{ entry, json }`,
     the frozen `StreamEntry` the shared reader hands every subscriber and the entry's parsed JSON value; for a host whose own reader keeps the same

package/dist/client.d.mts

@@ -1,15 +1,15 @@
 import * as react from "react";
 import { RefObject, ReactNode, Context } from "react";
-import { D as DailyReportRows } from "./instrumentation-CobsTeyw.mjs";
-export { a as DailyReportInstrumentation, b as DailyReportInstrumentationContext, I as DailyReportInstrumentedView, L as DailyReportListNavigationHandle, c as DailyReportRevealOptions, V as DailyReportViewInstrumentation } from "./instrumentation-CobsTeyw.mjs";
-import { D as DailyReportItem, a as DailyReportUser, b as DailyReportDetail } from "./types-BP1kIGMo.mjs";
+import { D as DailyReportRows } from "./instrumentation-Bks6vyM7.mjs";
+export { a as DailyReportInstrumentation, b as DailyReportInstrumentationContext, I as DailyReportInstrumentedView, L as DailyReportListNavigationHandle, c as DailyReportRevealOptions, V as DailyReportViewInstrumentation } from "./instrumentation-Bks6vyM7.mjs";
+import { D as DailyReportItem, a as DailyReportUser, b as DailyReportDetail } from "./types-CcUNWIyC.mjs";
 import { VirtualScrollLocale, VirtualScrollLabels } from "@aiquants/virtualscroll";
-import { D as DailyReportActionIntent, U as UIComment } from "./source-types-Hy_znWJl.mjs";
-export { f as foldDailyReportSourceTypeToken } from "./source-types-Hy_znWJl.mjs";
+import { D as DailyReportActionIntent, U as UIComment } from "./source-types-a15dGIN1.mjs";
+export { f as foldDailyReportSourceTypeToken } from "./source-types-a15dGIN1.mjs";
+import { D as DailyReportReadState, a as DailyReportSseStreamAnchor, b as DailyReportSseTerminalEvent, c as DailyReportSseMessage, d as DailyReportReadMark, e as DailyReportReadStatus } from "./sse-schema-Bk_iO1vF.mjs";
 import { D as DailyReportSearchFilterFacet } from "./search-filters-wire-5MWi6GWu.mjs";
 export { a as DAILY_REPORT_SEARCH_FILTER_FACETS } from "./search-filters-wire-5MWi6GWu.mjs";
 import { UseReopeningEventSourceResult } from "@aiquants/sse/react";
-import { D as DailyReportSseStreamAnchor, a as DailyReportSseTerminalEvent, b as DailyReportSseMessage } from "./sse-schema-CM_YM7xU.mjs";
 import * as _aiquants_route_revalidation from "@aiquants/route-revalidation";
 import "zod/v3";
 type DailyReportAttachmentIndicatorProps = {
@@ -96,6 +96,8 @@ type DailyReportLabels = VirtualScrollLabels & {
     readonly starRemove: string;
     readonly markRead: string;
     readonly markUnread: string;
+    readonly markUpdateRead: string;
+    readonly updatedSinceRead: string;
     readonly deleteReport: string;
     readonly edit: string;
     readonly resizeHandle: string;
@@ -141,7 +143,7 @@ type DailyReportLabels = VirtualScrollLabels & {
     readonly operationFailed: (operation: DailyReportOperation) => string;
     readonly noticeRepeated: (count: number) => string;
     readonly rowState: (state: {
-        readonly isRead: boolean;
+        readonly readState: DailyReportReadState;
         readonly isStarred: boolean;
     }) => string;
     readonly rowEditingState: (state: {
@@ -228,6 +230,8 @@ declare const DAILY_REPORT_LABEL_KEYS: readonly [
     "starRemove",
     "markRead",
     "markUnread",
+    "markUpdateRead",
+    "updatedSinceRead",
     "deleteReport",
     "edit",
     "resizeHandle",
@@ -431,7 +435,7 @@ type DailyReportActionFunctions = {
     addComment: (reportHubId: number, content: string, businessDate: ReportBusinessDate) => Promise<void>;
     deleteComment: (reportHubId: number, commentId: number, businessDate: ReportBusinessDate) => Promise<void>;
     toggleStar: (reportHubId: number, isStarred: boolean, businessDate: ReportBusinessDate) => Promise<void>;
-    toggleRead: (reportHubId: number, isRead: boolean, businessDate: ReportBusinessDate) => Promise<void>;
+    toggleRead: (reportHubId: number, mark: DailyReportReadMark, businessDate: ReportBusinessDate) => Promise<void>;
     createReport: (businessDate: string) => Promise<number>;
     updateReport: (reportHubId: number, data: {
         title: string;
@@ -450,7 +454,7 @@ type DailyReportActionLedgers = {
     readonly pendingAddCommentIds: DailyReportLedgerView<ReadonlyMap<number, ReadonlyMap<number, string>>>;
     readonly pendingDeleteCommentIds: DailyReportLedgerView<ReadonlyMap<number, ReadonlySet<number>>>;
     readonly pendingStarUpdates: DailyReportLedgerView<ReadonlyMap<number, boolean>>;
-    readonly pendingReadUpdates: DailyReportLedgerView<ReadonlyMap<number, boolean>>;
+    readonly pendingReadUpdates: DailyReportLedgerView<ReadonlyMap<number, DailyReportReadStatus>>;
     readonly resolvedIdMap: DailyReportLedgerView<ReadonlyMap<number, number>>;
 };
 type DailyReportActions = DailyReportActionFunctions & DailyReportActionLedgers & {

package/dist/client.d.ts

@@ -1,15 +1,15 @@
 import * as react from "react";
 import { RefObject, ReactNode, Context } from "react";
-import { D as DailyReportRows } from "./instrumentation-Dz7Uh7dT.js";
-export { a as DailyReportInstrumentation, b as DailyReportInstrumentationContext, I as DailyReportInstrumentedView, L as DailyReportListNavigationHandle, c as DailyReportRevealOptions, V as DailyReportViewInstrumentation } from "./instrumentation-Dz7Uh7dT.js";
-import { D as DailyReportItem, a as DailyReportUser, b as DailyReportDetail } from "./types-BP1kIGMo.js";
+import { D as DailyReportRows } from "./instrumentation-CCr0sezP.js";
+export { a as DailyReportInstrumentation, b as DailyReportInstrumentationContext, I as DailyReportInstrumentedView, L as DailyReportListNavigationHandle, c as DailyReportRevealOptions, V as DailyReportViewInstrumentation } from "./instrumentation-CCr0sezP.js";
+import { D as DailyReportItem, a as DailyReportUser, b as DailyReportDetail } from "./types-CcUNWIyC.js";
 import { VirtualScrollLocale, VirtualScrollLabels } from "@aiquants/virtualscroll";
-import { D as DailyReportActionIntent, U as UIComment } from "./source-types-Cg7T2dm6.js";
-export { f as foldDailyReportSourceTypeToken } from "./source-types-Cg7T2dm6.js";
+import { D as DailyReportActionIntent, U as UIComment } from "./source-types-C1LvfRRJ.js";
+export { f as foldDailyReportSourceTypeToken } from "./source-types-C1LvfRRJ.js";
+import { D as DailyReportReadState, a as DailyReportSseStreamAnchor, b as DailyReportSseTerminalEvent, c as DailyReportSseMessage, d as DailyReportReadMark, e as DailyReportReadStatus } from "./sse-schema-BLe0x7BD.js";
 import { D as DailyReportSearchFilterFacet } from "./search-filters-wire-5MWi6GWu.js";
 export { a as DAILY_REPORT_SEARCH_FILTER_FACETS } from "./search-filters-wire-5MWi6GWu.js";
 import { UseReopeningEventSourceResult } from "@aiquants/sse/react";
-import { D as DailyReportSseStreamAnchor, a as DailyReportSseTerminalEvent, b as DailyReportSseMessage } from "./sse-schema-BmhpWHVK.js";
 import * as _aiquants_route_revalidation from "@aiquants/route-revalidation";
 import "zod/v3";
 type DailyReportAttachmentIndicatorProps = {
@@ -96,6 +96,8 @@ type DailyReportLabels = VirtualScrollLabels & {
     readonly starRemove: string;
     readonly markRead: string;
     readonly markUnread: string;
+    readonly markUpdateRead: string;
+    readonly updatedSinceRead: string;
     readonly deleteReport: string;
     readonly edit: string;
     readonly resizeHandle: string;
@@ -141,7 +143,7 @@ type DailyReportLabels = VirtualScrollLabels & {
     readonly operationFailed: (operation: DailyReportOperation) => string;
     readonly noticeRepeated: (count: number) => string;
     readonly rowState: (state: {
-        readonly isRead: boolean;
+        readonly readState: DailyReportReadState;
         readonly isStarred: boolean;
     }) => string;
     readonly rowEditingState: (state: {
@@ -228,6 +230,8 @@ declare const DAILY_REPORT_LABEL_KEYS: readonly [
     "starRemove",
     "markRead",
     "markUnread",
+    "markUpdateRead",
+    "updatedSinceRead",
     "deleteReport",
     "edit",
     "resizeHandle",
@@ -431,7 +435,7 @@ type DailyReportActionFunctions = {
     addComment: (reportHubId: number, content: string, businessDate: ReportBusinessDate) => Promise<void>;
     deleteComment: (reportHubId: number, commentId: number, businessDate: ReportBusinessDate) => Promise<void>;
     toggleStar: (reportHubId: number, isStarred: boolean, businessDate: ReportBusinessDate) => Promise<void>;
-    toggleRead: (reportHubId: number, isRead: boolean, businessDate: ReportBusinessDate) => Promise<void>;
+    toggleRead: (reportHubId: number, mark: DailyReportReadMark, businessDate: ReportBusinessDate) => Promise<void>;
     createReport: (businessDate: string) => Promise<number>;
     updateReport: (reportHubId: number, data: {
         title: string;
@@ -450,7 +454,7 @@ type DailyReportActionLedgers = {
     readonly pendingAddCommentIds: DailyReportLedgerView<ReadonlyMap<number, ReadonlyMap<number, string>>>;
     readonly pendingDeleteCommentIds: DailyReportLedgerView<ReadonlyMap<number, ReadonlySet<number>>>;
     readonly pendingStarUpdates: DailyReportLedgerView<ReadonlyMap<number, boolean>>;
-    readonly pendingReadUpdates: DailyReportLedgerView<ReadonlyMap<number, boolean>>;
+    readonly pendingReadUpdates: DailyReportLedgerView<ReadonlyMap<number, DailyReportReadStatus>>;
     readonly resolvedIdMap: DailyReportLedgerView<ReadonlyMap<number, number>>;
 };
 type DailyReportActions = DailyReportActionFunctions & DailyReportActionLedgers & {