@aiquants/daily-report 0.41.0 → 0.42.0

package/CHANGELOG.md

@@ -2,6 +2,165 @@
 
 All notable changes to `@aiquants/daily-report` are documented here.
 
+## 0.42.0 (2026-10-12)
+
+### Added
+
+- **可視のポートの記憶の部品 `createDailyReportVisibilityCache({ ttlMs, readViewerKey, resolve })`** (server エントリ。設定の型 `DailyReportVisibilityCacheConfig`、上限
+  `DAILY_REPORT_VISIBILITY_MAX_CACHE_TTL_MS` = 60,000): ホストの問い合わせを包み、ポートの記憶の規則を持つ可視のポートを返す。閲覧者のキーごとに答えを `ttlMs` (1〜60,000 ms の整数。
+  ほかは `RangeError`) の間使い回し (単調な時計)、記憶を読むのは `initial` だけで、`refresh` は問い合わせ直して書き戻し、並んだ問い合わせを共有し、失敗は覚えず (後から書いた答えは残す)、
+  閲覧者を名指さない要求は問い合わせる前に投げる。ホストが文章から書き写した記憶はこれに置き換えられる。
+- **区分の語彙** (共有エントリ): パッケージ自身の区分 `DAILY_REPORT_INTERNAL_SOURCE_TYPE` (`"Internal"`) と、可視のポートが返すトークンをサーバーが畳む関数
+  `foldDailyReportSourceTypeToken` (前後の空白を除いて小文字)。トークンを組むホストと起動のときの照合は、綴りと畳み方を書き写さずにこれを読む。
+- **明示の opt-out の型 `DailyReportVisibilityOptOut`** (`{ unrestricted: <理由> }`。server エントリ。下の Breaking)。
+
+### Changed
+
+- **キーは DOM のフォーカスを動かさず、アクティブな行を動かす** (下の Breaking): 両ビューの複合ウィジェット (VirtualScroll のコンテンツ要素。`role="treegrid"`・`tabIndex=0`) がビューのただ 1 つの
+  Tab の止まり先で、キーの間 DOM のフォーカスはそこに残る。キーが動かすのはアクティブな行 (支援技術のフォーカスが載る行) で、複合ウィジェットの `aria-activedescendant` は
+  `@aiquants/virtualscroll` の `activeItemIndex` を通して、名指す行と同じ描画で描かれる (行が描画窓の外へ出ても留め置かれるので、参照はいつも解決する)。キーの処理は `focus()` を呼ばず、
+  DOM の位置も読まない (キーの起点はアクティブな行の記録)。
+  - 複合ウィジェットでの Enter / Space は、両ビューでアクティブな行を起動する: List はカードの主ボタンの押下と同じ (モバイルの配置ではオーバーレイも開く)、DetailList はスクロールせずに選ぶ。
+    既定動作はアクティブな行が無くてもいつも止める (ページはスクロールしない)。
+  - アクティブな行の中の操作部品 (★・既読・編集・削除・添付の繋がり・コメントの欄) で押した移動のキーは、その行から動かし、フォーカスを複合ウィジェットへ 1 度だけ戻す (続く繰り返しは
+    複合ウィジェットへ届く)。Escape はアクティブな行を変えずに複合ウィジェットへ戻す。行の中の編集とコメントのフォームの入力欄とボタンからも戻り (打った文字は欄と編集の置き場に残る)、
+    扱わないのは既定動作が止まった・IME の変換の間・Escape が自分の意味を持つ要素 (`select`・検索の欄・編集可能要素・操作部品を持つ再生の要素) の中・行までの祖先が
+    `aria-expanded="true"` のときだけ。移動のキーと出口は入力の領域の中では今までどおり扱わない。
+  - Tab は複合ウィジェットからアクティブな行の操作部品へ DOM の順に進み、最後の部品の次はビューの外へ出る。Tab は選択しない。既定の動作がアクティブな行の中に着き、その行が見えていなければ、
+    Tab と Shift+Tab の keydown の中で行を近いほうの端で見せてから既定動作に渡す (Chromium は `focusin` より前に焦点のスクロールを決めるので、`focusin` で見せても文書がスクロールする)。
+    着く先はパッケージの Tab 順の模型で決め (`tabLandsInRow`)、ビューの外へ出る Tab と Shift+Tab は何も見せない (一覧は利用者が離れた位置のまま)。
+  - ビューの外から複合ウィジェットへ入ると、マウスかペンで押した行がアクティブになり (押した行は見せ直さない)、それ以外 (Tab) は見えているアクティブな行・見えている選択中の日報・
+    可視の先頭の行の順で、一部しか見えていなければ近いほうの端で見せる。フォーカスがビューの外の要素へ出たとき (Tab・Shift+Tab・Ctrl+Home / Ctrl+End の出口・ビューの外の押下) と、
+    ビューの外にフォーカスがある間の可視範囲の変化も同じ規則でアクティブな行を選び直す (逆向きの Tab で入っても見えている行の操作部品に着く)。押下の行の記録は、ビューの中のどの
+    `focusin` と扱ったどのキーでも捨てる (ビューが自分で動かしたフォーカスは、中からの入りとして扱う)。
+  - ビューへフォーカスを戻す受け渡し (オーバーレイを閉じた・アクティブな行やコメント節が消えた・フォーカスを持つ操作部品がほかの理由で行から外れた・ページの状態の画面から本体への引き継ぎ) は、
+    行をアクティブにして近いほうの端で見せ、最後の入力の様式で行き先を決める: キーボード (と入力の記録が無いとき) は複合ウィジェット、ポインターとタッチは行そのもののフォーカスを受ける要素
+    (`data-daily-report-row-focus`: List のカードの主ボタン、DetailList のカードの画面に出さない名前の見出し (`tabIndex=-1`)。カードの無い行では複合ウィジェット。
+    iOS VoiceOver・TalkBack・スイッチ操作は DOM のフォーカスを追う)。利用者がよそに置いたフォーカスは奪わない。
+  - 複合ウィジェットがキーボードのフォーカスを持つ間、アクティブな行が見えていればその行のアウトライン、行が無いか見えていなければ VirtualScroll のペインの 2 px の輪が印になる。
+    表示域の縁に切られた行は、その縁で 4 px (G − アウトラインの offset) より多く見えるときだけ見えていると数える (`activeItemVisibleInset`) ので、アウトラインが欠ける重なりでは輪が残る。
+    輪の色は VirtualScroll の変数 `--aqvs-focus-ring-color` を行のアウトラインの色 (blue-600、暗色 blue-400) へ結んだもので、1 つのフォーカスは配色ごとに 1 つの色で描かれる。
+  - 行の無い一覧では、空の文言を複合ウィジェットの外 (同じ箱の上の層) に描き、複合ウィジェットの `aria-describedby` の先頭がそれを名指す (キーの説明の前)。区分を 1 つも見られない閲覧者の
+    空のビューも、名前・空の文言・キーの説明で読まれる。
+  - コメントの入力欄の名前はコメントの節の見出し (`labels.comments`。`aria-labelledby`) で、置き文字は手がかりのまま。
+  - 性能の試験 (9 つの条件): 押し続けあたりの `focus()` は 16.4〜18.7 ms から 0 ms、keydown の配送と押し続けのフレームの中の強制したスタイルと配置は 0、キーの処理の時間の p95 は最大 4.34 ms、
+    どの実行も 40 キーで 40 行を動かした。Chromium のアクセシビリティの木で、40 回の ArrowDown のどれでも、両ビューのアクティブな行の関係・名前・説明・選択・位置が正しい。
+- **行の 2 段のマウント**: 見える範囲の外でマウントする行は、まず行の枠と空の面 (殻。名前は営業日の ISO 表記で `aria-busy="true"`) だけを描き、ビューに 1 つの送り手が、フレームの描画の直後の枠
+  (MessageChannel の処理 1 つ) で行を 1 つずつ本体へ進める (1 つの単位が 1 つの確定)。順は見える・アクティブな行の届く範囲・近い・遠いの帯で、帯の中ではアクティブな行からの距離の順
+  (同じ距離なら進む向きの側を先)。枠ごとに単位は 1 つ、次の単位が見えるか届く範囲の行ならもう 1 つ。見えるようになった行は、見えるようにした確定の中で本体を描くので、見える行が殻のまま
+  塗られることは無い。届く帯か近い帯に入った待つ行は眠った送り手を起こすので、キーが見せうる行はそのキーより前の枠で本体を持つ。後から届いた日報のカード (読み込みの答え・SSE の更新) も
+  同じ送り手が載せ (`useDeferredValue` では遅らせない)、すでに見えている行へ届いたカードは、押し続けの外なら届いた確定の中で載る (見えている行は押し続けの外では古い描画のまま塗られない)。
+  キーの押し続けの間は、送り手がキーの描くフレームを避ける: 遠い帯の行は殻のままで届いたカードも載せず (離した後に載せる)、枠は次の繰り返しの keydown (押し続けの最新の 8 つの keydown の
+  間隔の中央値と最も早い位相から見込む) がその確定を描くフレームより前に来ないときだけ走り (枠を予約するフレームのコールバックで決め、走る時点でもう一度確かめる)、枠の 2 つ目の単位は
+  どちらの行も決まった箱 (List) のときだけ。見えている行へ届いたカードも、押し続けの間はこの枠を待つ (見える帯の単位が最初)。殻の箱は VirtualScroll の行の高さなので、本体が来ても何も動かない。
+- **遠い行は描画を飛ばす**: 見える範囲を両側へ表示域 1 つぶん広げた帯と、アクティブな行の届く範囲 (前後の行から表示域 1 つぶん。1 行か 2 行の 1 段が見せうるどの行も、行の高さによらず
+  ここに入る) の外にあるマウント済みの行は、寸法が決まっていれば `content-visibility: hidden` と `aria-hidden="true"` で描画を飛ばす (`@aiquants/virtualscroll` の `itemZones`)。
+  飛ばした行は支援技術の木・ブラウズモード・スワイプの読み上げ・ページ内検索から外れる。アクティブな行・その届く範囲・見える範囲の前後 1 表示域は外れない。行の箱は変わらないので、
+  飛ばしても見せても何も動かない。DetailList の行は本体を測るまで、コメントの一覧が変われば測り直すまで飛ばさない。`content-visibility` を持たないエンジン (Safari 18 より前) では
+  何も飛ばさず、何も隠さない。性能の試験で、スクロールしたキーあたりの塗りの段 (p50) は DetailList が 3.85〜4.47 ms から 2.07〜2.46 ms、List が 3.13〜3.81 ms から 2.11〜2.49 ms。
+- **選択の輪とアウトラインは行の枠の状態から描く**: 選択の輪と強制配色の選択の線は行の枠の `aria-selected="true"` から、キーボードのフォーカスのアウトラインは、ビューの根がキーボードの
+  フォーカスの属性 (`data-daily-report-keyboard-focus`) を持ち、祖先の複合ウィジェットが `:focus-visible` の間に、アクティブな行 (`data-daily-report-active`) の面へ描く。押下は
+  アウトラインを出さない。幾何・色・詳細度は変わらず、行の画素は 0.41.0 と同じ。どの選択子も `aria-activedescendant` を読まない (キーごとに変わる値で部分木を無効にしない)。List の
+  カードの面は、主ボタンがキーボードのフォーカスを持つ間のアウトラインを描き続ける (ポインターとタッチの受け渡しの後に Enter などを押したとき)。
+- **キー操作の説明の文言** (`labels.listKeyboardHelp`): Enter または Space で選択、Tab でその日報の操作部品へ、Escape で日報の行へ戻ることを足した。ja は
+  「↑↓ で前後の日報、Home / End で先頭・末尾、PageUp / PageDown でページ移動、Enter または Space で選択、Tab でその日報の操作部品へ、Escape で日報の行へ戻ります。Ctrl+Home / Ctrl+End で一覧の直前・直後の操作部品があればそこへ移ります。」、
+  en は「Up and Down arrows: previous or next report. Home and End: first or last report. Page Up and Page Down: move by a page. Enter or Space: select. Tab: the report's controls. Escape: back to the report row. Control+Home and Control+End: move to the nearest control before or after the list, when there is one.」。
+  上書きしているホストは文言を見直す。
+- **見出しのストリームの札は 1 つの枠に置き、枠の大きさは局面で変わらない**: `DailyReportIdsStreamStatus` は見出しの並びに 1 つの枠を持ち、枠の 1 つの格子の升に、見えない寸法の札
+  (どの局面の札も、いまの桁数で最も広い形にして重ねる。件数の箱 `CounterText` と同じ組み立て) と、いまの札を持つ入れ物を重ねる。枠はどの局面でも (何も見せない間も) 同じ大きさで
+  配置されるので、札が現れても消えても局面が変わっても、見出しの並びの行の数と下の検索の帯は動かない (幅が変わるのは件数の桁数が変わるときだけ)。空の入れ物は描かず読み上げない
+  (`visibility: hidden`。配置は残す。以前は `display: none` で配置しなかった)。最新化中の表示は、ほかの局面と同じ 24px の丸い札 (無彩色) になった。札の文字は枠の始まりに揃う
+  (`text-start`。ホストの見出しの右寄せを受け継がないので、狭い局面の札の名前が点から離れない)。フォーカスを持ったまま空になった入れ物は、描かれたビューの複合ウィジェット
+  (無ければ選ばれたビューのタブ) へフォーカスを渡す。
+- **閲覧を決められない要求は「今は答えられない」で答える** (下の Breaking): 可視のポートが投げたか契約の外で答えた要求は、空の一覧ではなく、JSON の経路と ids のストリームが読み取りの前に
+  503 `{"error":{"message":"Report visibility is unavailable"}}` (`Retry-After: 5`・`Cache-Control: no-store`)、action が利用者の解決の前に 503 `{"error":"Report visibility is unavailable"}`、
+  添付が混雑と同じ 503、SSE の接続が 503 で答え、開いている SSE の流れは定期の再解決が失敗すると、まだ配っていないエントリにアンカーを書かずに閉じる (ブラウザーが開き直し、追いつきが配る)。
+  記録は `[DailyReportVisibility]` の `visibility unavailable cause=<port_failure|port_contract> reason=<initial|refresh>` で、原因ごとに 60 秒の窓の最初の 1 行と窓の終わりの数の 1 行だけ。
+  空の答え (`[]`) は今までどおり本当の剥奪。
+- **ids のストリームの欠けた行はバイト列のまま持つ**: NDJSON の行の分け方は、行の終わりを届いたバイト列から探し、終わっていない行をバイト列 (チャンクから写した欠片) のまま持ち、
+  行が完結したときに 1 度だけ復号する。以前はチャンクごとに復号した字面を行の欠片として持ち、速さを抑えたストリームでは行の届き終わるまでヒープの文字列が若い世代のごみ集めを生き残って
+  古い世代へ昇格し、押し続けの間の大きいごみ集めを早めた。
+- **開発者向け**:
+  - キャッシュの寿命の大域の上書き (`__DAILY_REPORT_CACHE_TTL__`・`__DAILY_REPORT_CACHE_REVIVE_MS__`) は、モジュールの読み込みでなく最初に使う時に 1 度ずつ読む。
+  - 100 万単位の検索の文字の試験と 228,222 行の試験は、網羅率を測らない `guards` のプロジェクトの `*.scale.spec.ts` で走り、DOM を使わない client の spec は node の環境で走る。
+  - ソースを走査する 4 つの守り (枠線の線種・動きの方針・余白の段・Tailwind のセレクターの範囲) は `*.guard.spec.ts` (`border-style`・`motion-policy`・`spacing-ladder`・
+    `tailwind-selector-scope`) で、同じ `guards` のプロジェクトで走る。
+
+### Fixed
+
+- **最初の既読とスターの書き込みが重なっても 500 にならない**: `setStarStatus` と `setReadStatus` は、閲覧者の状態の行を `MERGE … WITH (HOLDLOCK)` の 1 文 (`db.execute`) で書く。ある行は旗を
+  更新し、無い行はもう一方の旗を偽にして入れ、書いた行を出力から読む。値の変わらない付け直しは行を 1 バイトも変えない (監査の列も)。以前は行を読んでから入れる 2 文で、同じ日報と閲覧者への
+  最初の 2 つの書き込み (日報を開いた自動の既読とスターなど) が両方とも「行が無い」と読み、主キーで衝突して 500 になった。
+- **論理削除した日報は公開できない**: `publishDailyReport` は削除した日報に Not Found (404) で答え、何も書かない (下書きのラベルを外さず、検索の索引も書かない)。以前は削除した日報の下書きの
+  ラベルを外して索引を書き直し、null を答えた。
+- **作った日報は作成者に既読で読める**: `createDailyReport` は作成者の状態の行 (既読、スター無し、監査は作成者) を、日報と同じトランザクションの中で索引より前に入れる。以前は作成の答えだけが
+  既読で、読み直すと未読だった。
+- **公開の答えは操作者の閲覧の範囲を通る** (下の Breaking): 公開の答えは操作者の範囲で読み直した日報で、コメントの次元が除く区分の他人のコメント (自分の投稿は残る) と外部のコメントを持たない。
+  以前は範囲を当てない読み取りをそのまま答え、区分の規則とコメントの規則の外のコメントまで返した。公開の知らせ (`report-publish`) は日報の全体を運び、SSE の配信が受け手ごとに絞る。
+  作成の答えも操作者の範囲で読み直す。
+- **前後に空白のある区分の値は、どの経路でも見えない**: SQL の区分の述語は小文字にした格納の値とトークンをバイト列で比べる (`CAST(LOWER(source_type) AS VARBINARY(2n)) IN (…)`、
+  n は列の宣言した長さ)。以前の `LOWER(source_type) IN (…)` は SQL Server の文字列の比較が末尾の空白を埋めて比べ (幅を区別しない照合順序では全角と半角も同じに扱う) ので、`kintone␠` の
+  日報が SQL の読み取りでは `kintone` を見る閲覧者に見え、JS の判定 (SSE・書き込みの関門・添付) では誰にも見えなかった。列より長いトークンは一覧に入れない (切り詰めた頭が一致しない)。
+- **関門の後に確定した削除の上には書かない**: 自分の日報の更新・公開とコメントの追加と削除は、トランザクションの最初の文で生きている hub の行に書き込みの鍵を取り (値を変えない更新。
+  監査の列も書かない)、行を選ばなければ Not Found で巻き戻す。削除は自分の更新に同じ条件を持つ。以前は関門と書き込みの間に確定した削除の上へ公開と更新を書き、削除した日報の下書きの
+  ラベルを外して検索の索引を書き直した。
+- **見えない日報のコメントの削除は 404**: `deleteComment` はコメント自身の日報の書き込みの関門を投稿者より先に通す。以前は本文の次元だけを見て、他人の下書きや論理削除した日報にある
+  ほかの利用者のコメントには 403、無いコメントには 404 を答え、答えの違いから存在が漏れた。論理削除した日報や見えない区分の日報のコメントは、投稿者自身にも Not Found。
+- **コメントの入力欄は置き文字だけで名付けない**: 入力欄の名前はコメントの節の見出し (「コメント」。`aria-labelledby`) で、置き文字 (`labels.commentPlaceholder`) は手がかりのまま。
+  以前は置き文字 (「コメントを追加...」) だけが名前で、見えている見出しと欄が結び付いていなかった (置き文字は打ち始めると見えなくなる)。
+
+### Breaking
+
+- **行は `treegrid` の `row`、面は `gridcell`**: ビューのコンテンツ要素は `role="treegrid"` (`role="list"` ではない) で、名前は `labels.title`、`aria-rowcount` は行が属する集合の大きさ
+  (分からない間は −1)。行の枠は `role="row"` (`role="listitem"` ではない) で、`id` はビューの複合ウィジェットの id と日報 id から `virtualScrollItemElementId` で導く id、
+  `aria-rowindex` = `aria-posinset` = 位置 + 1、`aria-setsize`、`aria-level="1"` を持つ。行の面 (`data-daily-report-row-surface`) は `role="gridcell"` で、行の名前の要素を
+  `aria-labelledby` で参照する。カードの行の名前は名前の要素 (List はカードの主ボタン「営業日 作成者」、DetailList は画面に出さない日報の見出し「営業日 作成者 件名」)、説明は状態・描いた目印・
+  プレビュー (List)・一致の文で、集合の大きさが分からない間だけ位置の文言を最後に足す。殻とカードの無い行は営業日の ISO 表記を `aria-label` に持つ。
+  Migration: 行を `[role="listitem"]` や `[role="list"]` で探すホストの試験と CSS は `[data-daily-report-row]` (と `[role="row"]`・`[role="treegrid"]`) で探す。位置は `aria-rowindex`・
+  `aria-posinset`、集合は `aria-setsize`・`aria-rowcount` で読む。ARIA のスナップショットは treegrid > row > gridcell で取り直す。
+- **選択は `aria-selected`**: どの行も `aria-selected="true"` か `"false"` を明示し、`aria-current` は行にも List のカードの主ボタンにも無い。アクティブな行だけが `data-daily-report-active` を持つ。
+  Migration: 選択を `aria-current="true"` で読む所は行の枠の `aria-selected="true"` で読む。アクティブな行は複合ウィジェットの `aria-activedescendant` (行の `id`) か `[data-daily-report-active]` で読む。
+- **フォーカスは複合ウィジェットに残る**: キーはフォーカスを行へ移さない (上の Changed)。List のカードの主ボタンは Tab の止まり先でなく (`tabIndex=-1`。クリックの的とポインターの受け渡しの行き先で、
+  `data-daily-report-button` を保つ)、行の枠は `tabindex` を持たない。DetailList の行は `data-daily-report-button` も `tabindex` も持たず、フォーカスを受けない。アクティブな行の操作部品だけが
+  Tab の順に入る (ほかの行の部品は `tabIndex=-1`)。
+  Migration: 「選んだ行がフォーカスを持つ」を確かめる試験は、複合ウィジェットが `document.activeElement` で、その `aria-activedescendant` が選んだ行の `id` を名指し、行が
+  `aria-selected="true"` と `data-daily-report-active` を持つことを確かめる。DetailList の行は `[data-daily-report-button="<id>"]` でなく `[data-daily-report-row="<id>"]` で探す。
+  Tab の道筋を数える試験は、複合ウィジェット・アクティブな行の操作部品・ビューの外の順で数える。
+- **ピアの `@aiquants/virtualscroll` は `^3.17.0`**: ビューは `activeItemIndex` (アクティブな行の `aria-activedescendant` と留め置き)・`activeItemVisibleInset`・`itemZones` と
+  `useVirtualScrollItem` (帯と遠い行の描画の飛ばし)・`virtualScrollItemElementId`・空の複合ウィジェットの説明・`--aqvs-focus-ring-color` を使う。ピアの下限は 3.17.0
+  (`peer-floors.json`)。Migration: `@aiquants/virtualscroll` を 3.17.0 以上へ上げる。
+- **可視のポート `resolveVisibleSourceTypes` は必須で、`null` は契約の外**: `DailyReportServerConfig` とハンドラーの設定のポートは必須 (省いた設定は型で書けず、型を外したホストは
+  生成のときに `TypeError` `[daily-report] resolveVisibleSourceTypes must be a function`、関数でない値は `RangeError`)。ポートの答えは区分の配列・`{ read, comment? }`・
+  `{ unrestricted: "<理由>" }` の 3 つの形だけで、`null`・`undefined`・ほかの形 (知らない鍵・空の理由・文字列でない要素) は契約の外として閲覧を決められない要求になる (上の Changed の 503)。
+  以前はポートを省くことも `null` を返すことも「全件」を意味し、区分を結線していないホストはどの閲覧者にもどの区分も見せていた。
+  Migration: 区分で絞る配備は今までどおり配列か `{ read, comment }` を返す (`null` を返していた所は無くす)。どの閲覧者にもどの区分も見せる配備は
+  `resolveVisibleSourceTypes: () => ({ unrestricted: "<この配備が区分で絞らない理由>" })` を渡す。
+- **閲覧を決められない要求は 503** (上の Changed): ポートの失敗は全拒否 (空の答え) ではなく 503 か SSE の接続の終わりになる。Migration: 一時の障害を空の一覧として確かめる試験と監視は、
+  503 (`Retry-After: 5`) と `visibility unavailable` の行を待つ。
+- **`loginRedirectPath` は必須**: パッケージは既定のサインインのパス (`/auth/login`) を持たない。`createDailyReportServer` と `createDailyReportHandlers` は空白だけでない文字の
+  `loginRedirectPath` を受け、ほかは生成のときに `RangeError` (`[daily-report] loginRedirectPath must be the non-blank path of the host's sign-in route; got <value>`)。
+  Migration: 設定にホストのサインインの経路のパスを渡す (画面の loader を使わないホストも渡す)。
+- **作成は閲覧の範囲を最初の引数に取り、`Internal` を見ない閲覧者の作成は 403**: `createDailyReport(scope, userId, businessDate, clientTempId)`。範囲がパッケージ自身の区分
+  (`Internal`) を見せなければ、どのクエリよりも前に `Forbidden` で断り、action は 403 `{"error":"Creating reports is restricted"}` で答える (行も状態の行も索引も知らせも書かない)。
+  以前は作成が関門を通らず、区分の閲覧権の無い作成者が、自分のどの読み取りと書き込みも断る下書きを作れた。
+  Migration: サービスの作成を直接呼ぶ所は範囲を最初に渡す。日報を書く利用者には `Internal` の閲覧権を与える。
+- **区分の列は `nvarchar(n)`**: 区分の SQL の述語はバイト列で比べるので、`tables.hub.sourceType` は長さ 1〜4,000 の `nvarchar(n)` の列でなければならず、ほかはサービスの生成のときに
+  `RangeError` (`[daily-report] tables.hub.sourceType must be an nvarchar(n) column with a declared length (source types compare as UTF-16 bytes); got "<SQL の型>"`)。
+  `defineDailyReportSchema` の列 (`nvarchar(20)`) はそのまま通る。Migration: 自前のモデルを注入するホストは区分の列の型を確かめる。
+- **既にある日報への書き込みは hub の行の更新で始まる** (上の Fixed): 更新・公開・コメントの追加と削除のトランザクションの最初の文は hub の行の `update(...).set(...).output().where(...)`。
+  drizzle の `db` をそのまま渡していれば変更は要らない。Migration: 手で書いた db の代役を渡す試験は、更新の `output()` に選んだ行を答える。
+- **`DailyReportService.getDailyReportsByBusinessDate` を外した**: 閲覧者ごとの規則 (他人の下書きを隠す・閲覧者の既読とスター) を当てない営業日の読み取りは公開のサービスに無い
+  (その読み取りのキャッシュの鍵も無い)。Migration: 営業日の日報は閲覧者ごとの読み取り `getDailyReportsByBusinessDateByExternalId` で読む。
+- **自分の日報の更新・公開・削除は閲覧の範囲を最初の引数に取り、見えない日報は 404**: `updateDailyReport`・`publishDailyReport`・`deleteDailyReport` は最初の引数に
+  `DailyReportViewerScope` を取り、所有者の確かめの前に閲覧の関門 (読み取りと同じ述語) を通す。範囲の外の区分の日報・他人の下書き・無い日報・論理削除した日報には、どれも同じ 1 つの
+  SELECT の後に Not Found (404) で答え (以前は他人の日報に Unauthorized (403))、トランザクションを開かず何も書かない。見える他人の日報には今までどおり Unauthorized。
+  公開の答えは操作者の範囲で読み直した日報 (上の Fixed)。パッケージの API の経路を使っていれば、要求の範囲が渡るので変更は要らない。
+  Migration: サービスを直接呼ぶ所 (結合試験など) は、要求の範囲を最初の引数に渡すか、範囲を当てない呼び出しには `DailyReportViewerScope.unrestricted(<理由>)` を渡す。下書きを他人が
+  更新する試験は Unauthorized でなく Not Found を待つ (公開した日報なら Unauthorized のまま)。
+- **状態の切り替えは `execute` の MERGE 1 文で書く** (上の Fixed): `setStarStatus` と `setReadStatus` は `db.execute` で状態の行の upsert を 1 文で流し、出力の行 (`recordset`) を
+  ちょうど 1 行として読む (読めなければ `[daily-report] user status: the upsert must output the one status row of report <id> and user <id>; got <output>`)。drizzle の `db` をそのまま渡していれば
+  変更は要らない。Migration: 手で書いた db の代役を渡す試験は、`execute` が状態の行の upsert に出力の行を答えるようにする。
+
 ## 0.41.0 (2026-10-11)
 
 ### Added