@aiquants/daily-report 0.35.0 → 0.37.0

package/CHANGELOG.md

@@ -2,6 +2,147 @@
 
 All notable changes to `@aiquants/daily-report` are documented here.
 
+## 0.37.0 (2026-10-09)
+
+### Added
+
+- **読みの印の説明**: ローマ字の読みでだけ当たった印 (`reading`) は、支援技術へも説明 (`aria-description`) で弱い当たりであることを伝える。説明は新しいラベル `searchReadingMarkDescription` (en `Matched by its romaji reading`、ja `ローマ字の読みで一致`) で、打った語の印 (`word`) は説明を持たない (よくある印の読み上げを増やさない)。印の属性の値と説明は tier ごとの 1 つの表 (`SEARCH_MARK_LOOKS`) から取る。固有キーは 101 から 102 (文字列のキー 85・整形関数 17。キーの表は全 113 キー)。
+  以前は読みの当たりと語の当たりの違いが下線の形 (点線か実線か) にしか無く、読み上げはどちらも同じ `mark` として伝えた (WCAG 1.3.1)。
+- **DetailList の行の説明に一致の印の文**: 画面が印の store を持つ間、DetailList の行の説明 (`aria-describedby`) は、状態・添付の目印・種別のバッジの後に、見出しの一致の印の隠した文 (`キーワード 2 個のうち 1 個に一致`・`この画面に出していない項目 (ラベル・明細など) で一致しました`) を続ける。隠した 2 つの文は 1 つの要素にまとまり、見える印と置き物はその外にある。
+  以前は行の説明が一致の印を含まず、矢印キーで行を移る読み上げには、目で見る利用者が行ごとに見る `一致 k/n` と `表示外で一致` が届かなかった。
+
+### Changed
+
+- **検索の印の要求は送る時に決める**: 印の store は、購読された日報を 1 つの待ち行列に置き、要求の枠が空くたびに、まだ行が購読している日報を新しい順に 100 件まで取って送る (`createIdBatchScheduler`。同時に 2 本まで)。待つ間に行が外れた日報は送らないので、スクロールや押し続けたキーが通り過ぎた行の印は頼まず、止まった窓の印は空いた最初の枠で頼む。
+  どの行も購読しなくなった要求は止め (サーバーはその印の計算をやめる。下の Fixed)、送る前に外れた行と、止めた要求の行は、戻ってきたときに頼み直す。日報ごとの記録 (印・送った順・頼んだ epoch・429 のやり直し・再検証) は 1 つにまとまり、どの行も購読しない日報の記録は `SEARCH_MARKS_RECORD_BOUND` (400) を超えた分を古いものから忘れるので、持つ量はスクロールした距離でなく描いている窓に従う。
+  以前はマイクロタスクごとに購読された ID をそのまま束にし、束を古い順に 2 本ずつ、行がまだ載っているかを見ずに送った。2 秒の PageDown の押し続けでは要求 61 本の ID の 93.5 %、1 秒の List のスクロールバーの引きでは 95.2 % が送る時に既に外れた行のもので、止まった窓の印は要求 1 本が 196 / 500 / 927 ms のとき押し終わりから 4.4 / 13.9 / 26.8 秒後に届いた (store の模擬。今は外れた行の ID は 0 で、止まった窓の印は押し終わりの後の最初の要求で届く)。
+- **印が届いても描き直すのは葉と一致の印だけ**: 行 (List のカード・DetailList の本文カード・側面ペインの中身) は自分の部分木を印の囲み (`DailyReportSearchMarksScope`) で包み、日報の印を購読するのは囲みで、行の本体は印を読まない。印が届いて描き直すのは囲みと印を読む葉 (`SearchMarkedText`) と一致の印だけで、行の本体・見出し・添付の一覧・コメントの節は急ぎの描画でも後追いの描画でも描き直さない。
+  以前は行の本体が購読のフックを呼んだので、印が届くたびに本体の部分木を急ぎの描画 (出力は同じ) と後追いの描画で 2 度描いた (載っている 8 行で子孫の描画 48 回・5.9 ms)。
+- **`search-marks` の答えは ETag を持たない**: 経路が組むどの答え (印・400・404・429・離れた要求の 503) も、1 回だけ直列化した `Cache-Control: no-store` の JSON で、ETag を持たず、`If-None-Match` を読まない (共有のセキュリティヘッダーは同じ)。まとまりは送るたびに描いている行から組むので同じ URL はほとんど繰り返されず、パッケージのクライアントは `If-None-Match` を送らない。以前は本文全体の SHA-256 で使われない ETag を作った。
+- **行の並びは塊を共有する永続の並び**: プロバイダーの行は 1,024 行の書き換えない塊を背骨が束ねる並び (`ReportRowList`) で、導きの編集は触らない塊をどれも前の版と共有した新しい版を 1 回で作る。末尾へ足す publish が書くのは背骨と最後の塊の行と足した行だけで、80,000 行に 4,000 行を足す publish の参照の書き込みは 84,000 から 4,128 になった。途中の削除と差し込みは、最初に変わる塊から後ろを 1 回だけ詰め直す。
+  ビュー・キーボード・アクションの状態・検索の一覧の導きは、行を長さ・位置 (`at`)・走査だけで読む (下の Breaking)。一覧に無い id の走査 (削除の直後の選択) は塊を位置で読み、行ごとの関数の呼び出しを持たない (22.8 万行で 4.1〜4.6 ms から 1.9〜2.6 ms)。
+- **答えを見せている間の一覧の導き**: 検索の答えの一覧 (`deriveSearchListItems`、`src/client/search/search-list-items.ts`) は、publish が書いた塊だけを確かめ (前の版と共有する塊は確かめ直さない)、答えの日報に関わらない publish では前の一覧そのものを返すので、ビューも行も描き直さない。以前は publish のたびにストリームの一覧全体をなめ、答えを見せている間の押し続けたキーの 1 回の保持ごとに 10〜22 ms の描画を足した。
+- **ids のストリームの無音の見張りは接続ごとにタイマー 1 本**: 本文の read の無音は、接続ごとに 1 本のタイマーが上限に足りない分だけ張り直して見張り (`watchReadSilence`)、無音が `readStallTimeoutMs` に届いたときだけ読み手を取り消してカーソルから再開する。以前は read ごとにタイマーを張って外し、配信中の 1 回の保持ごとに 26〜46 ms を使った。
+- **数の整形は作り置きの書式**: 組み込みの整形関数は、ロケールごとに 1 度だけ作った `Intl.NumberFormat` で桁を区切る (出力は同じ)。以前は呼ぶたびに書式を作る `toLocaleString` を、ストリームの publish ごとに描き直す行の位置と件数のたびに呼んだ。
+- **本文の位置つきの置き換えは 1 回の走査**: 位置つきの表示の文字の置き換え (`replaceDisplayText`) は、区間の位置を前へだけ進める 1 回の走査で、側面ペインの本文 (`paneContentOf`) はタグの数に比例する (段落 2,000 で 122 ms から 1.3 ms。出力は同じ)。添付のファイル名の NFC の表示 (`nfcDisplayOf`) も名前の長さに比例する (244 単位で 1,184 µs から 89 µs)。以前はどちらも長さの 2 乗だった。
+- **読み上げ用のファイル名は自分のはみ出しを切らない**: 添付のファイル名の読み上げ用の写し (名前の中とダウンロードのリンクの中) は、`sr-only` (`overflow: hidden` と `clip`) でなく、切らない透明な 1 px の文 (`VISUALLY_HIDDEN_CLASS_NAME`) に layout の閉じ込めを足して隠す (`HiddenFileName`)。閉じ込めは、仮想化した行の外 (側面ペイン・オーバーレイ) で 1 行の長い名前がスクロールの箱の横幅を広げないため。添付の節はほかに切る中身 (見える名前の省略・収めた名前・大きさの注記・サムネイルの枠の角) を持つので、添付のある DetailList の行は窓をずらすスクロールの 1 段でなお描き直される。
+- **ログ: クライアントの ids のストリームのチャンネル**: ids のストリームのクライアントの警告 (再検証の諦め・読めない行と種類の分からない行の読み飛ばし・形の誤ったアンカー) は、チャンネル `[DailyReportIdsStream]` (`DAILY_REPORT_LOG_CHANNELS` の `IdsStream`) から console へ書く。どの行も接頭辞をちょうど 1 つ持ち、古い詳細の更新の行は `[DailyReportDetailLoader] Stale update skipped id=<id>`、アンカーの行は `skipped a malformed streamAnchor: <値>`。`DailyReportIdsStreamClientOptions.warn` へ注入した書き先はチャンネルの代わりに、文面と引数を接頭辞無しで受ける。
+  以前はクライアントの ids のストリームが文面に `[DailyReportIdsStream]` を手で綴り (一覧に無い 4 つ目のクライアントのチャンネル)、古い更新の行は `[DailyReportDetailLoader] [DailyReportCache] …` と接頭辞を 2 つ持った。
+- **公開の docstring は既定値を値で書く**: `createDailyReportServer` の `cacheDefaultTtlMs` と `cacheMaxBuckets` の docstring は、ホストが読み込めないモジュールの内部の定数の名前でなく、既定値 (60,000 ms と 4,096) を書く。振る舞いは同じ。
+- **開発者向け**:
+  - `src/docs-examples.spec.ts` は、公開する markdown (`package.json` の `files` の `.md`) がパッケージの例のスキーマ (`dbo_app`・`dbo_daily_report_search`) のほかのデータベースのスキーマを名指さないことを確かめる (修飾した `dbo_<名前>.<表>`・角括弧で囲んだスキーマで修飾した名前・修飾した `dbo`、修飾の無い `dbo_<名前>`)。0.36.0 の README と CHANGELOG はホストの表の名前を 1 つずつ持った (下の Fixed)。
+  - `src/shared/logger.call-sites.spec.ts` は、ロガーのモジュールの外のどの文字列の字面も `[DailyReport` の接頭辞の形を綴らないことを確かめる。
+  - 12 px の文字の下限の検査は、`src/client` の下のどのモジュールも 1 回の走査で読み (例外の一覧は無い)、検索の葉と一致の印も対象にする。
+  - 印が届いたときの描画の回数 (List・DetailList・画面)、`表示外で一致` の場合ごとのビューのテスト、印の store の模擬の場合 (60 回の確定・2 つの聞き手・429 と dispose)、塊の共有、下書きの規則の SQL (本物の SQL の処理系で流す) を、それぞれの spec が確かめる。
+  - 印の tier は名前 (`DAILY_REPORT_SEARCH_TIER`: `word` が 0、`reading` が 1。入口からは出さない) で書き、通信の読み取りと計画と印の見え方の表が同じ判定 (`isDailyReportSearchAlternativeTier`) を使う。表に無い tier の印はパッケージの名を名乗る誤りで描画を止める (通信の読み取りが通さないので、来るのは崩れた不変条件だけ)。
+  - `display-text.ts` の改行のタグの規則は 1 つの元 (`LINE_BREAK_TAG_SOURCE`) から 3 つのパターンを作る (振る舞いは同じ)。
+  - 文書の直し: `TabsContent` の `tabStop` (最初の意味のある中身がフォーカスを受けないか、中身が Tab の届くべきスクロールの容器のとき)、内部ユーザーを持たない閲覧者の読み取り (データの問い合わせは無いが、ID の解決は受け入れの前と読み取りの中で 2 回走り、見つからない間はキャッシュしない)、`mergeComments` と `resolveCommentColorClass` の docstring。
+
+### Fixed
+
+- **`表示外で一致` はビューの葉が描いた印から決める**: 行の葉 (`SearchMarkedText`) は描いている間だけ、欄の印が描く値について今のものかと塗った印の数を行の集計 (`drawn-search-marks-tally.ts`) へ登録し、一致の印は集計だけを読む。登録がどれも今のもので合計が 0 のときだけ `表示外で一致` を出す。
+  以前の一致の印はビューが描く欄の写しを手で持ち (`countVisibleSearchMarks`)、4 つの場合でビューと食い違って、印も `表示外で一致` も出さなかった: 側面ペインの関連のタブ (記事を描かないのに件名・顧客・本文・添付・コメントを描いたと数えた)、利用者が削除を送っているコメント、ホストのひな形が素で描く面談者の札、収めたファイル名の省いた中ほどだけの当たり。CSS の省略が隠す当たりは、印を塗るので今も描いたものと数える (何を隠すかはブラウザーが決める)。
+- **一致の印の書体は 12 px**: 一致の印 (`SEARCH_INDICATOR_CLASS_NAME`) は、ページの文字の書体でパッケージの下限の 12 px (`text-xs`) を 16 px の行に置き、数字は等幅の数字 (`tabular-nums`) で `一致 k/n` の幅を一定にする。色と比は同じ (slate-600 / 暗色 slate-300)。以前は 11 px の等幅で、パッケージの 12 px の下限を割り、`一致`・`表示外で一致` は各 OS の等幅の和文の代わりの書体で描かれた (下限の検査は、検索の部品のディレクトリを読んでいなかった)。
+- **側面ペインの作成者の行は折り返す**: 作成者の行 (作成者・種別のバッジ・一致の印の枠) は 4 px の間で折り返し、見出し語の `作成者` は縮めずに 1 行のまま、値だけが縮んで折り返す。狭いペインで収まらない一致の印の枠は、自分の 16 px の行へ落ちる。以前は行が折り返さず、200 px の最小の幅から約 400 px までの間は枠が作成者を押し潰し (`作成者` が 1 字ずつ縦に積まれ、長い名前で見出しの行が 24 px から 160 px に伸びた)、最小の幅では枠が見出しの箱からはみ出して切られた。
+- **検索の印の要求は離れたら枠を返し、新しい答えのまとまりは待つ**: `search-marks` の経路は要求のシグナルをサービスへ渡し (`markDailyReportSearchHits(…, ids, { signal })`)、サービスは読み取りの前と日報ごとの印の前に確かめて、離れた要求の仕事をそこで止める (走っている SQL の読み取りは止められないので、枠はその終わりまで持つ)。離れた要求には本文の無い 503 (`Retry-After` 付き) で答え、誤りの行を書かない。
+  受け入れは、ゲートが満杯か閲覧者が取り分を持ちきっているとき、検索の印だけを待たせる (閲覧者ごとに `DAILY_REPORT_SEARCH_BATCHES_IN_FLIGHT` 個・全体で受け入れの同時数まで、`SEARCH_MARKS_WAIT_MS` = 2,000 ms まで。検索と ID でまとめた詳細は今までどおりすぐに断る)。中断された要求の拒否は、3 つの経路のどれでも満杯として記録しない。
+  以前は離れた要求のサービスが 2 つの SQL の読み取りと印の計算を最後まで走らせて閲覧者の取り分を持ち、新しい検索の最初のまとまりが待たずに 429 (`Retry-After: 1`) で断られた。負荷の下では 1 回きりのやり直しも断られ、その行はその epoch の間、印なしのままだった。
+- **取りこぼしのゲートは枠の少ない閲覧者へ先に渡す**: キャッシュの取りこぼしのゲート (`createCacheMissGate`) とサムネイルの生成の待ち行列は、空いた枠を、上限に達していない利用者のうち保持数の最も少ない利用者の最も古い待機者へ渡す (`createConcurrencyGate`。利用者の中と保持数の等しい利用者の間は到着順)。以前は上限に達していない最も古い待機者へ渡したので、全部の枠が埋まっている間は、上限まで持つ閲覧者の先に並んだ読み取りが枠を取り直し続け、後から来た閲覧者の最初の読み取りが待った (模擬では、忙しい閲覧者が 8 人いるときの新しい閲覧者の最初の読み取りの中央値が 1,293 ms から 334 ms になった。残りはドライバーの接続の待ち)。
+- **429 を待つ間の dispose も頼み直しを残さない**: 印の store を dispose すると、429 のやり直しの時計が持つ日報も、待っている・送っている日報と一緒に頼んでいないものに戻す。以前は時計だけを消したので、React が同じ store をもう一度マウントすると (`<Activity>` を隠して見せ直す)、その日報はその epoch の間二度と頼まれず、行は印なしのままだった。429 で断られた行が `Retry-After` の前に外れて後で戻った場合も同じだった。
+- **長い行の印は書記素の塊を割らない**: 4,000 単位より長く片に分けた行では、片の境目が書記素の塊を割りうるので、印の範囲を生の値の塊の境目まで広げる (`Intl.Segmenter`)。以前は 👍🏽 の 4,000 単位を超える連なりを 👍 で探すと、印が絵文字を割った。上限以内の行の範囲は同じ。
+- **印の範囲のまとめは出現の数と欄の長さに比例する**: 欄の印は tier ごとの覆いの差分からまとめる (`markSearchText`)。範囲は重ならない最大の連なりなので、欄の範囲は単位の数を超えず、答えは描く値の長さに比例する (1 字の語で 21,200 単位の日報 100 件を探す答えは 1.6〜2.9 MB で、同じ日報の詳細の答えは 2.2 MB)。以前は出現ごとに覆う単位を塗ったので、費用は出現の数 × 覆う長さで、長い書記素の塊の中の出現では数の 2 乗に伸びた (塊の境目まで広げた肌の色の修飾 10 万個の塊 1 つで 51 秒)。
+- **読みの計画は語を打つ順によらない**: 語とキーワードの重複を、正規化した文字でなく候補の集まり全体 (文字と tier。読みを含む) で除く。正規化して同じでも読みを持つかが違う語 (`Ⅱです` は読まず、`iiです` は イイデス と読む) は両方残り、語を打つ順を入れ替えた検索語は同じ計画になる (キーワードと語の並びのほか)。上限は今までどおり打った語で数える。以前は先に打った語だけが残り、読みを探すかが打つ順で決まり、OR の検索語に語を足すと答えが狭まりえた。
+- **長音を重ねた 1 字の読みは足さない**: 読みの文字の塊 (`readingLetterClusterCountOf`) は、長音の連なりを 1 つと数える。`ha--` → ハーー と `ha---` → ハーーー は文字の塊が 2 つなので読みを持たず、`site-` → シテー と `ko-hi-` → コーヒー は読む。以前は連なりの長音を 1 つずつ数えたので、ハーー は 3 つと数えて足し、「それは――」(索引では ソレハーー) のような言い回しに当たった。
+- **NFKC で英字でなくなる修飾文字の語は読まない**: 読みを持つには、打った語に加えて正規化した語も英字の文字を含む必要がある。英字の修飾文字 U+10781 (→ ː) と U+10782 (→ ˑ) を足した語 (`納期ヲ確認` と修飾文字) は読みを持たず、0.35.0 と同じ計画になる。以前は打った語の判定だけを通り、正規化した語の読みが `納期オ確認` のような同音の畳み込みを足した。
+- **下書きの規則は 1 つの定義で、日報は 1 行**: 閲覧者が何を見てよいかを決めるサービスの読み取り (ID の一覧と最初のページ・添付・ID でまとめた詳細と営業日の詳細と検索の印が使う `fetchVisibleHubDetails`・詳細・ミューテーションの対象の確かめ) と検索の SQL は、下書きの規則を 1 つの定義 (`buildDraftVisibilityCondition`: 作成者か、日報のどのラベルも下書きの名前を持たないことを、ラベルの関係への `NOT EXISTS` で書く) から作る。見える日報の集合は同じ。
+  以前の読み取りは下書きのラベルの関係を `LEFT JOIN` で結合して絞ったので、閲覧者自身の日報が下書きのラベルを 2 つ持つと (`draftLabelNames` に複数の名前) その日報を 2 行で返した (`search-marks` だけは答えの中で重複を除いていた)。ステージング (22.8 万件、下書きの関係は 0 件) の ID の一覧の全量の読み取りは、CPU が 500〜516 ms から 248〜263 ms に減り、経過時間は計画が並列のハッシュ結合から直列の入れ子のループになって 128〜162 ms から 248〜263 ms に延びた (最初のページは 7 ms)。
+- **自動既読のスイッチの文言は自分のスイッチに結ぶ**: 自動既読のスイッチと文言は `useId` の id で結び、開発用の SSE のスイッチは固定の id を持たない (自分の `aria-label` が名前)。以前は文書全体で固定の id (`auto-read-mode`・`sse-mode`) を使ったので、画面が 2 つ描かれると (`<Activity>` が隠した画面を残すとき) 2 つ目の文言が 1 つ目のスイッチを切り替え、2 つ目のスイッチは名前を失った。
+- **文書の誤り**: 0.36.0 の README と CHANGELOG は、外部の文字だけで当たった日報の例にホストの表の名前を書いていた (README の **Highlights** と、下の 0.36.0 の Added。汎用の口 `externalSourceTexts` の言葉で書き直した)。README は、一覧の 1 行に切った後ろとファイル名の省いた部分を「印は付くが見えない」と書いたが、Chromium は印を切る省略記号を印の中に描く (印の地は `…` の下まで続き、下線は最後に見える文字で終わる)。
+
+### Breaking
+
+- **`DailyReportActionState.items` は配列でない**: アクションの状態の行 (`useDailyReportActionContext().items`) は、長さ (`length`)・位置の日報 (`at`)・走査だけで読む永続の並び (型は `Pick<ReadonlyArray<DailyReportItem>, "length" | "at"> & Iterable<DailyReportItem>`) で、行が変わるたびに新しいオブジェクトになる。ビューの `dailyReportItems` も同じ形を受ける (配列も渡せる)。
+  Migration: `items` を配列として読むホスト (`items[i]`・`map`・`filter`・`find`) は、`items.at(i)`・`for…of`・`Array.from(items)` で読む (`Array.from` は一覧全体を写す)。
+- **`markDailyReportSearchHits` は要求のシグナルを求める**: サービスの `markDailyReportSearchHits(scope, userId, plan, ids, { signal })` は 5 つ目の引数に要求のシグナルを取り、確かめた時点で中断されていればその `reason` を投げる。
+  Migration: サービスを自分で呼ぶホストは、要求の `request.signal` (止めないなら `new AbortController().signal`) を渡し、投げた `reason` を要求の中断として扱う。
+
+## 0.36.0 (2026-10-08)
+
+### Added
+
+- **検索の答えのハイライト**: 答えを見せている間、List のカード (本文の先頭の行と作成者)・側面ペイン・DetailList の行は、サーバーが当たりと判定した所に `<mark data-daily-report-search-mark>` を付ける。打った語の形で当たった所 (正規化でだけ当たった所を含む: `ﾃﾞﾝﾌﾟﾝ` は でんぷん に付く) は `word` で実線の下線、ローマ字の読みでだけ当たった所は `reading` で点線の下線。
+  側面ペインと DetailList は検索する欄の描いている文字すべて (件名・本文・作成者と更新者と社員の名前・区分と作成区分・顧客・面談者の名前と所属・添付のファイル名・コメントの作者と本文) に付ける。2 つ以上のキーワードの OR では、日報が当たったキーワードの語だけに付ける。
+  印を付けないもの: ラベル名と外部の文字 (ホストの読み取りの口が外部ソースの区分ごとに渡す文字 (`externalSourceTexts`) はビューが描かないので、それだけで当たった日報には印が出ず、一致の印が `表示外で一致` を出す)・一覧と側面ペインが除くタグ・一覧の 4 行目以降と切った後ろ・省いたファイル名の部分・編集のフォーム・作者不明の代わりの名・値でない文字。そのまま値を差し込まない `interviewerWithAffiliation` のひな形は札を素で描く。
+  位置はサーバーが索引と同じ処理から求めるので、印は検索が当たらない所に付かず、ブラウザーは正規化しない (`@aiquants/fuzzy-search` はクライアントの束に入らない。`src/client-bundle.structure.spec.ts` が確かめる)。印は箱を 0 にして書体を受け継ぐので、行の幅も高さも変えない。yellow-200 に slate-900 (暗色 yellow-800 に yellow-50、15.33:1 と 6.61:1)、強制配色では `Mark` と `MarkText`。
+- **一致の印**: 側面ペインの作成者の行と DetailList の行の見出しに、contact map の点数と同じ書体 (11 px の等幅、slate-600 / 暗色 slate-300) の控えめな印を出す。2 つ以上のキーワードの OR では当たったキーワードの数 (`一致 2/3`)、日報が当たったのにそのビューが描く印が 1 つも無いとき (ラベルや明細だけで当たったなど) は `表示外で一致` (en `Hidden match`)。答えの最も長い文字の幅を前もって取っておくので、印が届いても見出しは流れ直さない。印は `aria-hidden` で `title` を持ち、画面に出さない文を添える。
+- **ローマ字の読み**: 英字を打った検索語は、fuzzy-search の公開関数 (`queryNeedles` と `convertRomaji`) で読んだ完全な仮名の読みでも探す (`denpun` → でんぷん・デンプン・ﾃﾞﾝﾌﾟﾝ)。ヘボン式と IME の綴りの両方 (`shinbun` と `sinbun`)。読みは文字の塊 3 つ以上 (`SEARCH_READING_MIN_CLUSTERS`。数字・記号・先頭のダッシュは数えない) を語ごとに 2 つまで (`DAILY_REPORT_SEARCH_READINGS_PER_WORD`) で、英字の綴りそのものも候補に残る。
+  文字の塊が 1 つか 2 つの読みは足さない (0.36.0 は長音の連なりの長音を 1 つずつ数えた。下の Fixed を参照): 索引は平仮名を片仮名へ畳むので、短い読みはありふれた言い回しに当たる (日報 228,794 件で `site` → シテ が「して」に当たって 43.55 %、1,244 ms)。`memo` や `kome` のような 2 文字の語は仮名で打ち、`ha100` も読みを持たない。
+  漢字には届かず (`nouki` は 納期 に当たらない)、長音は畳まず、同音の綴りは片側だけ (`numazu` は ぬまづ に当たらないので `numadu` か仮名で打つ)。仮名の語でローマ字の本文は探さない。英字を打っていない語 (NFKC で英字になるローマ数字や № の `Ⅱです`・`№12` を含む) の計画は変わらず、正規化の版も変わらないので、索引の作り直しは要らない。
+- **検索の答えの `words`**: `search` の答えは `{ ids, businessDates, sourceTypes, words }` で、`words` は計画の語 (キーワード → 語 → 候補 `{ text, tier }`)。`q` と `combine` だけで決まり、閲覧者のことは明かさない。パッケージのクライアントは語を厳しく読み、崩れていれば答えを丸ごと拒む。
+- **検索の印の要求**: `GET {apiBasePath}/search-marks?q=&combine=&ids=` (ID は 100 件まで) が、頼んだ日報のうち閲覧者が読めるものの欄ごとの印の範囲 (生の値の UTF-16 の位置と tier、値の指紋) と、2 つ以上のキーワードの OR では当たったキーワードの組を返す (`{ wordsDigest, reports }`)。設定が無ければ 404。
+  受け入れは検索と同じ工場から作る自分のインスタンス (同時数は検索の `concurrency` とクライアントが同時に送る数 `DAILY_REPORT_SEARCH_BATCHES_IN_FLIGHT` = 2 の大きい方の `SEARCH_MARKS_CONCURRENCY_PER_SEARCH_CONCURRENCY` = 2 倍、回数は `rateLimitPerMinute` の `SEARCH_MARKS_RATE_PER_SEARCH_RATE` = 10 倍、拒否の行は `route=search-marks`)。サービスの `markDailyReportSearchHits`、エンジンの口の `matchedSets`。
+  パッケージのクライアントは描く行の ID をまとめて (1 回 100 件・同時に 2 本まで) 頼み、答えは送った順に当て、行は自分の印が届いたときだけ描き直す。
+- **添付のファイル名の印**: 格子の外の CSS の省略の形では語幹と拡張子の 2 つの要素がそれぞれ自分の部分に、収めた形では収めた文字に印を付ける (省いた中ほどと `…` には付けない)。分解された名前の印は合成した文字の全体を覆う。`title`・データ属性・読み上げ用の名前は素のまま。
+- **`DailyReportUIComment.isAuthorUnknown`**: `mergeComments` は作者名の無いコメント (代わりの名を見せるもの) に `true` を付ける。検索はその代わりの名に印を付けない。
+- **ラベル 4 個** (固有キーは 98 から 101。下の Breaking の `deleteFailed` を除いた数): `searchMatchOutsideView`・`searchMatchOutsideViewDescription` と、整形関数の `searchMatchedKeywords(matched, total)`・`searchMatchedKeywordsDescription(matched, total)`。
+- **SQL の結果のキャッシュの上限** `cacheMaxBuckets` (`createDailyReportServer`、既定 4,096): 書き込みは書いた順の最も新しいものとして入れ直し、上限を超えた分は最も古く書いたバケットから捨てる。期限切れの掃除は単調な時計で既定の TTL ごとに多くとも 1 回なので、書き込みの費用は表の大きさによらない。
+- **公開の名前**: 共有エントリの `DailyReportSearchFieldMarks`・`DailyReportSearchReportMarks`・`DailyReportSearchMarksAnswer` (`search-marks` の答え)、server の `DailyReportSearchAlternative`・`DailyReportSearchAlternativeTier`・`DailyReportSqlResultCacheMissAdmission`、client の `DailyReportLedgerView`。
+
+### Changed
+
+- **検索の答えを見せている間の一覧の組み立てを軽くした**: ストリームの一覧が変わるたびに全件の表を作る代わりに、答えの日報の ID の集合 (答えごとに 1 回作る) でストリームを 1 回なめ、答えが持つ日報だけを拾う。
+  一覧の中身と順は変わらない。合成のデータでの目安 (22.8 万件の一覧、一覧の変化 1 回): 答え 10 件で 35 → 3.4 ms、1,000 件で 27 → 5.8 ms、5 万件で 33 → 10 ms、18.9 万件で 43 → 24 ms。
+- **`DailyReportSearchWord.alternatives` は `{ text, tier }` の並び** (公開の型の変更): tier 0 は打った語の形、tier 1 はローマ字の読みの形。SQL と照合の基準と答えの `words` と印がこの形を読む。計画の型 (`DailyReportSearchPlan`) を読むホストは、候補の文字を `alternative.text` で読む。
+- **検索の書き方の説明** (`labels.searchSyntaxHelp`) は、英字の語がローマ字の読みでも仮名を探すことと、読みで当たった所を点線の下線で示すことを 1 文で足した (en と ja)。
+- **検索窓の行は格子に乗る**: 行は操作列と同じ 32 px の格子のブロック 1 つで、24 px の操作部品を下端に置く (操作列から G、ビューの最初の面の G 上)。始まりと終わりの寄せは帯が持ち、操作列と検索の行が共有するので、入力欄の終わりの縁はカードの終わりの縁に揃う。帯はビューより上に重なり、検索の操作部品のフォーカスの輪がビューの余白の上に描かれる。
+  消去のボタンは入力欄の箱の中に置き、その場所を入力欄がいつも空けておくので、文字を打っても入力欄の幅は変わらない。状態の行は文言を省かずに折り返す (幅は行の半分まで、空なら場所を取らない)。以前は 32 px の箱の中央に 24 px の操作部品を置いたので見える隙間が 4・12・8 px になり、入力欄の終わりの縁はどこにも揃わず、最初の打鍵で消去のボタンが入力欄を 32 px 縮め、8rem の状態の列は日本語の 5 つの文言のうち 3 つを切った。
+- **ログのチャンネルは閉じた一覧**: どのロガーも `createChannelLogger(hostLogger, defaultLevel, channel)` で作り、`channel` は閉じた一覧 `DAILY_REPORT_LOG_CHANNELS` の名前でしか名指せない (接頭辞 `[DailyReport<チャンネル>]` を綴るのはロガーのモジュールだけ)。書き間違いは型の誤りになり、どの一覧も知らないチャンネルを黙って作らない。
+  クライアントの 3 つのロガーも同じ接頭辞を持つ (`[DailyReportActionProvider]`・`[DailyReportDetailLoader]`・`[DailyReportSseConnection]`。以前は角括弧の無いモジュールの名前)。キャッシュの取りこぼしの受け入れの拒否は新しいチャンネル `[DailyReportReads]` (warn) に書く。
+- **`cacheDefaultTtlMs` は 1 以上の整数**: `createDailyReportServer` は `cacheDefaultTtlMs` と `cacheMaxBuckets` を `requireIntegerSetting` で読み、ほかの値は設定の名前を名乗る `RangeError` で止まる。
+- **開発者向け**:
+  - 網羅率のつめ車 (`pnpm run check:coverage`) は、測った値の切り捨てより低い下限 (余り) も、どちらの指標でも落とす (`<file>: <metric> floor <f> below measured <m>; run pnpm run coverage:ratchet`)。spec が足した網羅率は下限としてすぐに固定される。
+  - モノレポの根の解決 (`scripts/lib/repository-root.mjs`) は物理パスで読み、ファイルシステムの根の手前で止まり、起点にファイル・ディレクトリ・`file:` の URL を受け、空白の起点を拒む。リポジトリの契約の表 (`.config/scripts/lib/repository-root-contract.mjs`) を `src/repository-root.spec.ts` が走らせる。
+  - プロファイル用の source map: `DAILY_REPORT_PROFILE_SOURCE_MAPS=1` のビルドは、ソースの本文を持たない source map をローカルのプロファイルのために書く (公開のビルドは map を書かず、ほかの値はビルドを止める)。
+  - `src/docs-examples.spec.ts` のテストの名前は名指す例と文書の名前を切らずに持つ (`it.each` の書式は値を 40 字で切り、2 つのテストが同じ名前になっていた)。
+  - 文字の欄、検索の印、一致の印の色のコントラストと、行の導きの写しの数、検索の 3 つの設定の下の描画の回数、公開のプロバイダーのコンテキストの読み方を、それぞれの spec が確かめる。
+
+### Fixed
+
+- **キャッシュの取りこぼしも閲覧者ごとに縛る**: `business-date`・`report`・ids のストリームの読み取りがキャッシュを取りこぼして取得を始めるとき、閲覧者の取りこぼしの枠を 1 つ取る (`createCacheMissGate`: 閲覧者ごとに 8、ワーカーごとに 64。待ち行列は閲覧者ごとに 256・ワーカーごとに 1,024 で、待つのは 60 秒まで)。命中と同じキーの取得への相乗りは枠を取らない。待ち行列か待ちの上限を超えた読み取りは問い合わせを始めず、`{"error":{"message":"Too many reads"}}` と `Retry-After: 5` の 503 で答える (ids のストリームは、再開の GET がその 503、新規の GET は本体を定型のエラー行で閉じる)。既に中断した要求は枠を取らず取得も始めない。拒否は `[DailyReportReads]` に閲覧者の窓ごとに 2 行まで。
+  以前はキャッシュ (`cache`) が同じ読み取りしか分け合わず、0001 年から 9999 年のどの営業日も、どの ID も別のキーなので、キーを変えるだけで 1 人の閲覧者が際限なく問い合わせを走らせられ、結果は上限なしに TTL の間残った (32,000 個のキーで 32,000 回の問い合わせと 11.7 秒のメインスレッド)。
+- **ビューの Tab の止まり先は 1 つ**: ビューを入れるタブの中身は Tab の止まり先ではなくなった (`TabsContent` の必須の `tabStop`。中身が自分の止まり先を持たないときだけ止まり先)。ビューの前の最後の操作部品からの Tab 1 回で行のカーソルへ届き、行からの `Ctrl+Home` はその操作部品 (検索窓があれば検索の行の最後の操作部品) へ出る。以前はどのビューのタブの中身も 2 つ目の止まり先で、`Ctrl+Home` はそこ (キーが何もしない所) へ出た。
+- **コメントの投稿と削除の失敗は画面でも巻き戻る**: 楽観的な状態の台帳を変えるのはプロバイダーのただ 1 つの書き手で、変更と同じ呼び出しで台帳の版を進める。投稿に失敗したコメントは一覧から消え、削除に失敗したコメントは戻る。以前は失敗の処理が台帳だけを書いて版を進めなかったので、知らせは失敗を伝えるのに、画面は投稿したまま・消したままに見えた。
+- **側面ペインの削除の失敗は 1 回だけ知らせる**: 削除のボタンは拒否を受けて戻るだけで、誤りの知らせが失敗を伝える。以前は知らせに加えて別の文言のネイティブの `alert()` を出し、閉じるまでストリーム・SSE・時計のスクリプトを止めた。
+- **文字の欄の境界と置き文字は 3:1 と 4.5:1 を満たす**: コメントの入力欄・編集フォームの `Input` と `Textarea`・検索の入力欄と AND/OR の切り替えの OR の面は、1 つのトークン (`INPUT_FIELD_CLASS_NAME`) から slate-500 の枠線と slate-500 (暗色 slate-400) の置き文字を取る (明: 白に 4.76、slate-50 に 4.55。暗: slate-900 に 3.74、slate-800 に 3.07)。ホストの `--input` などの色のトークンは使わない。以前の枠線は 1.2〜2.7:1 で WCAG 1.4.11 に届かなかった。
+- **AND/OR の切り替えはフォーカスを保つ**: 押してもフォーカスは切り替えに残り、名前が新しい状態を伝える (WCAG 3.2.2)。以前はフォーカスを入力欄へ移したので、2 度目の Space は空白を打ち、読み上げは新しい状態を伝えなかった。
+- **自動既読のスイッチは説明を持つ**: スイッチは見える文言を名前に、自動既読が表示に依ること (`labels.autoReadTitle`) を説明 (`aria-describedby`) とツールチップに持つ。以前の説明は包みの `title` だけで、名前にも説明にもならず、キーボードのフォーカスでは出なかった。
+- **API・action・SSE の経路のどの応答も同じセキュリティヘッダーを持つ**: `X-Content-Type-Options: nosniff`・`X-Frame-Options: DENY`・`Content-Security-Policy: default-src 'none'` を、ステータスによらず (JSON の答えと拒否・action の答え・要求の隔離の拒否・SSE のストリームと誤り・ids の NDJSON) 1 か所の組 (`RESOURCE_RESPONSE_SECURITY_HEADERS`) から付ける。以前は action の答え、SSE の経路の 404・503・500、隔離の拒否がそれぞれ組の一部を欠いた。
+- **Chrome 121〜124 でもビューの列は中央に残る**: 列の原点の `round()` の宣言は `@supports` の下に置く。値は `var()` を含むので、`round()` を持たない描画エンジン (下限の内の Chrome 121〜124) は宣言を計算値の段階で無効にして `margin-left` を 0 にし、列を左端に寄せていた。
+- **行の導きは描画のやり直しで写しを重ねない**: 前の行と読むもの (元の版と変化の鎖・落ち着き・削除の印) の組 1 つの導きは、React が描画を何回やり直しても 1 回だけ (`deriveReportRowsOnce`)。README の「publish 1 回に参照の写し 1 回」は、押し続けたキーが publish を運ぶトランジションの描画を捨てて根からやり直させる間も成り立つ。以前は 1 回の publish の導きと写しがやり直しの数だけ走った (本物の並行の描画で 21〜25 回、80,000 行で写し 1 回が約 320 KB)。
+- **取り下げた削除の印が隠していた行は戻る**: 削除の印がある間のストリームの値は隠す行として覚え、削除が断られて印を取り下げると、その行をストリームの値で正準の場所へすぐに戻す (`withdrawRemovalMark`)。以前は印の間に同じ値の中継が届くと行が戻らず、落ち着いた次の導きで持つ行として手放された (乱数の操作列の 128 件のうち 11 件で、一覧全体から導いた行と食い違った)。
+- **DetailList の行は自分のはみ出しを切る中身を持たない**: 行の中の画面に出さない文 (見出しと状態・種別のバッジの展開した名前) は `sr-only` (`overflow: hidden` と `clip`) でなく、切らない透明な 1 px の文 (`VISUALLY_HIDDEN_CLASS_NAME`) で描く。Chromium は窓をずらすスクロールの 1 段で、はみ出しを切る中身を持つ行をすべて描き直す (描く範囲の 11 行から 2 行へ)。
+- **ID でまとめた詳細 (`reports`) は、閲覧者 1 人にクライアントが同時に送る数の読み取りを通す**: 受け入れの同時数は、検索の `concurrency` と `DAILY_REPORT_SEARCH_BATCHES_IN_FLIGHT` (2) の大きい方の `REPORTS_CONCURRENCY_PER_SEARCH_CONCURRENCY` (2) 倍で、閲覧者の取り分は 2 を下回らない (`concurrency` が 1 ならプロセスで 4)。以前は `concurrency` が 1 のとき取り分が 1 で、クライアントの 2 本目の読み取りが 429 で断られた。
+- **検索の印とローマ字の読み (上の Added) の直し**:
+  - 読みの下限は文字の塊で数える (`readingLetterClusterCountOf`): 数字・記号・先頭のダッシュは数えないので、仮名 1〜2 字の読み (`ha100` → ハ100・`no12` → ノ12・`-site` → ーシテ) を足さず、「単価は100円」「10月の12日」「コピーして」のような言い回しに当たらない。ただし 0.36.0 は長音の連なりの長音を 1 つずつ数えたので、仮名 1 字に長音を 2 つ以上続けた読み (`ha--` → ハーー) は足し、「それは――」(索引では ソレハーー) のような言い回しに当たった (連なりを 1 つと数えるのは次の版から)。
+  - 読むかは打った語で決める: 英字の文字を打った語だけが読みを持ち、英字の文字を打たずに NFKC で英字になるローマ数字や № を含む語 (`Ⅱです`・`№12`・`第Ⅲ期`) は 0.35.0 と同じ計画になる。
+  - 詳細の読み取りが同じ日報を 2 行で返しても (自分の日報が 2 つの下書きのラベルを持つとき)、`search-marks` の答えは日報ごとに 1 つで、クライアントの読み取りが束ごと拒んで窓の印を落とすことは無い。
+  - 閲覧者 1 人は、クライアントが同時に送る数の `search-marks` の要求を持てる (`concurrency` が 1 でも 2 本目が 429 にならない)。
+  - 見せる答えの検索が替わると、載ったままの行は新しい答えの印が届くまで素の文字を描き、前の答えの印と当たったキーワードの数を描かない。
+  - 印の答えは送った順に当てる: 前の epoch のまとまりや編集の前に送ったまとまりの答えが遅れて届いても、後に送った要求が置いた新しい印を上書きしない。
+
+### Breaking
+
+- **`DailyReportConfigProvider` は必須**: 設定のコンテキストは既定値を持たず、プロバイダーの外の `useDailyReportConfig` (と、設定を読むパッケージのどの部品) は描画で `[daily-report] useDailyReportConfig must be used within a DailyReportConfigProvider` を投げる。以前は en の既定の設定と検索なしで黙って描いた。
+  Migration: `DailyReportPage` を使うホストは変更が要らない。ビュー・`DailyReportResolvedContent`・アクションのプロバイダーを自分で組むホストは `DailyReportConfigProvider` で包む。
+- **ラベル `deleteFailed` を外した**: 側面ペインの削除の失敗は誤りの知らせだけが伝える (上の Fixed)。
+  Migration: `labels.deleteFailed` を上書きしていたホストは、その鍵を外す (残すと知らないキーとして `RangeError`)。文言は `operationFailed('delete')` が持つ。
+- **server の `generateETag` と `jsonResponseWithETag` を外した**: どちらもパッケージの内部の部品で、入口からは出さない。
+  Migration: 使っていたホストは自分の実装を持つ (ETag は本文の字面のハッシュ、`If-None-Match` は弱い比較で読む)。
+- **`SqlResultCache` は `maxBuckets` を求める**: コンストラクターの設定は `{ defaultTtlMs, maxBuckets }` で、どちらも 1 以上の整数。
+  Migration: `SqlResultCache` を自分で作るホストは `maxBuckets` を渡す (`createDailyReportServer` を使うホストは `cacheMaxBuckets` で変えられ、省けば 4,096)。
+- **楽観的な状態の台帳は読むだけ** (`DailyReportActionLedgers`): どの台帳も `DailyReportLedgerView` (凍結した `{ current }` と読むだけの Map) で、中身を変えるのはプロバイダーの書き手だけ。以前は書き換えられる `MutableRefObject` だった。
+  Migration: 台帳を読むだけのホストは変更が要らない。書き込んでいたホストはアクションのコンテキストの関数 (`toggleStar`・`addComment` など) を使う。
+
 ## 0.35.0 (2026-10-08)
 
 任意の文字の検索。サーバーの設定のブロック `search` とクライアントの `config.search` を渡したホストだけで働き、渡さないホストの振る舞いは変わらない (公開・削除・コメントの経路がトランザクションに入ることと、`DailyReportDb` の `execute` を除く)。仕様は `docs/specs/2026.10.07 [AI] 03-search-specification.md`、README の **Text search** が今の振る舞いを述べる。