@aiquants/daily-report 0.33.0 → 0.34.0

package/CHANGELOG.md

@@ -2,6 +2,67 @@
 
 All notable changes to `@aiquants/daily-report` are documented here.
 
+## 0.34.0 (2026-10-07)
+
+0.33.0 の続き: コメントの作者を ID で決めること、誤りの知らせを時間で消さず何も覆わない流れの中に置くことと、モバイルのオーバーレイの中に描くこと、自分を外す再試行ボタンのフォーカスとストリームの状態の読み上げ、端の行の `Home` / `End`、照合用 ID の衝突と消えた日報の削除、期限のある台帳と操作ごとの錠、1/8 の倍数の画素密度の装置の画素の格子、action と API のワイヤの契約の公開と ID の 1 つの定義域、キャッシュを迂回する読み取りの合わせ方と上限、閲覧者ごとのストリームの枠、JSON の応答の記録、対を持たないサロゲートのファイル名。どれも README の該当の節が今の振る舞いを述べる。
+
+### Fixed
+
+- **コメントの作者は ID で決める**: SSE で届いたコメントは、作者の ID が表示中ユーザーの ID (`userId`。`encodeUserId` のポートの値) と等しいときだけ閲覧者自身のもの。投稿中の仮のコメントの id を本物の id へ解決するのは、その投稿自身の答えだけ。
+  以前は本文の一致で決めたので、ほかの利用者が投稿中のコメントと同じ本文を書くと、そのコメントを自分のもの (`isMine: true`) としてキャッシュし、投稿中の仮の id を相手のコメントの id へ解決した。その後の投稿中のコメントの削除は相手のコメントへ向かって `Unauthorized` で断られ、自分のコメントは残って誤りを知らせた。自分の別のタブや端末のコメントは他人のもの (`isMine: false`) になり、読み直すまで削除できなかった。
+- **誤りの知らせはモバイルのオーバーレイを開いている間も操作できる**: 内蔵の知らせ (`role="alert"`) は、オーバーレイを開いている間はダイアログの中 (日報と閉じるボタンの間) に描き、閉じた後はページの置き場へ戻る。以前は知らせをプロバイダーの子の隣に描いたので、オーバーレイのモーダルな `<dialog>` の外で不活性になり、読み上げの木にも無く、押すことも閉じることもできなかった (パッケージの知らせを使うホストでは、オーバーレイの中のどの失敗も見えないままだった)。
+- **誤りの知らせは時間で消えず、何も覆わない**: 知らせは利用者が閉じるボタンか、中にフォーカスがある間の `Escape` で消すまで残り (WCAG 2.2.3)、新しい失敗は文言を置き換える。`Escape` は知らせだけを消し、オーバーレイを閉じない。フォーカスを持ったまま消えるときは、来た元へ、無ければビューの行カーソルへ、それも無ければ知らせを置いたダイアログへ戻す。
+  知らせは流れの中の置き場 (ページの下・オーバーレイの中) に描くので、フォーカスを持つ行にもボタンにも重ならない。以前の知らせは 8 秒で消え (フォーカスを持っていれば body へ落ちた)、`Escape` は効かず、下端に固定したトーストとして末尾に揃えた DetailList の行の 28 px とアウトラインの下の縁を覆った。
+- **自分を外す再試行ボタンはフォーカスを落とさず、ストリームの状態は読み上げる**: 見出しの進捗の札は局面ごとに中身だけを替える 1 つの入れ物で、ページの読み込み中と読み込みの失敗は中身だけを替える 1 つの状態の面。どちらの再試行も、押されて自分が外れる前に入れ物か面へフォーカスを渡し、面がフォーカスを持ったまま本体へ入れ替わるとビューの行カーソル (無ければページの状態の領域) へ渡す。
+  ページの常設の見えない状態の領域が、読み込み中と再接続中を `role="status"` で、失敗を `role="alert"` で知らせる。以前はどちらの再試行もフォーカスを body へ落とし、データ未受信の読み込みの失敗は読み上げの領域を持たず、読み込み中の唯一の領域 (再接続中の札) は同じ確定で外れた (WCAG 2.4.3、4.1.3)。
+- **選択されていない端の行の `Home` / `End`**: フォーカスがもう先頭 (末尾) の行にあり、その行が選択されていなければ、`Home` (`End`) はその行をその場で選ぶ (両ビュー)。以前は何もしなかったので、選択中の日報を消して末尾の行にフォーカスだけが残ると、`End` を押しても側面ペインは選択を促す表示のままだった。矢印と `PageUp` / `PageDown` は、端で動かなければ今までどおり何も選ばない。
+- **同じミリ秒の 2 つの操作は別の照合用 ID を持つ**: 楽観的な日報とコメントの仮の id (その 10 進の文字が照合用 ID) は、ページに 1 つの列から、前に引いた値より必ず小さく、壁時計のミリ秒の負の数以下の値を引く (`drawTemporaryId`)。以前は `-Date.now()` だったので、同じミリ秒の 2 つの操作が 1 つの照合用 ID を分け合い、エコーと失敗を別の操作に結び付けることがあった。
+- **もう無い日報の削除は済んだものとみなす**: 日報の削除に 404 が返ったら、巻き戻しも誤りの知らせもせずに、キャッシュと編集の項目を捨てる (一覧の行は外したまま)。ほかの操作の 404 は今までどおり巻き戻して知らせる。
+- **キャッシュを待つ SSE の知らせは期限で必ず刈る**: 自分の操作のエコーの抑止と、キャッシュをまだ持たない日報への知らせの待ちは、どちらも期限のある 1 つの台帳 (`createExpiringLedger`) が持ち、どの日報の足し・読みでも期限の過ぎた項目を先頭から外して、待ちのキャッシュの購読もやめる。以前の待ちは、同じ日報の次の知らせ・キャッシュの書き込み・日報の削除・アンマウントでしか期限を確かめなかったので、キャッシュされない 50 件の日報への知らせが 50 件の購読を残し、期限の後も 51 件が残った。
+- **操作の錠は操作ごと**: `acquireMutationLock` は錠ごとの返し方を返し、返し方はその錠だけを 1 回だけ返す。SSE のコメントの変更は錠に触れずに変更の時刻だけを記録し (`markReportMutated`)、作成の後の 1 秒の錠は後の錠で延びるだけ。以前は日報ごとに 1 つの錠で、SSE のコメントや重なった操作が進行中の操作の錠や作成の後の錠を外した。
+- **1/8 の倍数の画素密度でも行とタイルは装置の画素に乗る**: 装置の画素の格子の定義域は 1 から 3 までの 1/8 の倍数のすべて (412 px 幅の多くの Android の端末の既定 2.625 を含む)。中身が高さを決める箱 (DetailList の行の本体・誤りの知らせ) と添付のタイルの寄せは、格子のブロックの刻み (カスタムプロパティ `--aqdr-lattice-block`。1/4 の倍数で 4 px、1/8 の奇数倍で 8 px) へ切り上げ、ホバーの浮き上がりは 12 個の画素密度で整数の装置の画素へ上書きする。
+  以前は 1/4 の倍数だけを定義域にしたので、2.625 では 4 の奇数倍の行やタイルの段の下のすべてが装置の画素の半分ずれ (980 px の行の下端が 6,478.5 装置画素、オーバーレイのタイルの段の送りが 188 CSS px = 493.5 装置画素)、面の縁が 2 行の装置の画素へにじんだ。
+- **対を持たないサロゲートを含むファイル名の添付も配る**: `Content-Disposition` の `filename*` は名前の整った形 (対を持たないサロゲートは U+FFFD) の UTF-8 を符号化し、行から決まるヘッダーの部品は読み取りの前に作る。以前は符号化が `URIError` を投げ、原本を上限まで読んだ後に 500 (`URI malformed`) で答えたので、取込元の切り詰めでサロゲートの対が割れた名前の添付は、どの要求でも配れなかった。
+- **JSON の応答は要求ごとの記録を書かない**: `jsonResponseWithETag` はログを書かない純粋な組み立てで、JSON の答えの跡は API の経路が工場のロガーへ書く `debug` の 1 行 (`<状態> endpoint=<名前> etag_match=<true|false>`) だけ。要求のヘッダーの値も、エンドポイントより前の答え (401・404・405) も書かない。
+  以前はどの JSON の応答も、未認証の 401 を含めて、モジュールの console のロガーへ `info` の 1 行を `If-None-Match` の値ごと書いたので (16,000 バイトの `If-None-Match` で 16,125 バイトの行)、未認証の送り手が行の数も大きさも決められ、ホストのロガーでは行き先も量も変えられなかった。
+
+### Changed
+
+- **キャッシュを迂回する読み取りはキーごとに合わせる**: `SqlResultCache` の迂回の取得 (`forceRefresh`) は、キーごとに走る取得 1 本と待つ取得 1 本までで、同時に届いた迂回の読み取りはいくつでも多くとも 2 回の取得で答え、どの呼び出しも届いた後に始まった取得の結果を受け取る。走る迂回の取得には迂回しない読み手も相乗りし、その間に無効化されたら結果をバケットに書かない。以前の迂回は取得を合わせず登録もしなかったので、同時の 20 本の迂回は 20 回の問い合わせになった。
+- **action のレートの上限は共有の留まる時間から導く**: 側面ペインの自動既読の留まる時間 (`AUTO_READ_DWELL_MS` = 500 ms) をクライアントとサーバーが 1 つの定義から読み、上限は留まるペインの余裕 5 × ⌈60,000 ÷ 500⌉ = 600 (値は変わらない)。留まる時間を縮めれば上限も上がる (以前はサーバーが 500 を書き写していたので、クライアントだけを縮めると、留まった複数のペインの自動既読がどの spec も通ったまま 429 になった)。上限はホストの設定にしない。
+- **合わない答えは合わなかった欄を名乗る**: パッケージのクライアントは、送った操作の答えでない action の答えを `[daily-report] <intent> answered a body that is not its result (<パス>: <code>; …)` で、エンドポイントのスキーマに合わない答えを `… does not match its schema (<パス>: <code>; …)` で拒む (受け取った値は書かない)。以前はどちらもパスを名乗らなかった。
+- **ids のストリームのクエリは 1 組の符号化と解釈**: クライアントの再開と強制の再取得の URL も、サーバーの解釈も、共有の表のクエリの名前を 1 組の関数で書き・読む。片方だけの改名は往復で落ちる (以前はクライアントが 4 つの名前を字面で書いたので、改名はどの spec も通ったまま、どの再開も先頭からの全量の再送にした)。
+- **開発者向け**:
+  - ID のワイヤの定義域は `src/shared/ids.ts` (`isPositiveSafeInteger`・`dailyReportIdSchema`) の 1 つで、クエリとフォームの文字の解釈 (`parseCanonicalPositiveId`・`parseCanonicalNonNegativeInteger`・`parseWireBoolean`・`parseForceRefreshParam`) は `src/server/wire-params.ts` から `src/shared/wire-text.ts` へ移った。SSE のメッセージのどの ID の欄も同じ定義域で読む (以前の素の `z.number()` は 0・負の数・小数を通した)。合わない値の説明は `src/shared/wire-mismatch.ts` (`describeWireMismatch`)。
+  - サーバーの action の 200 の答えは、指示から組む 1 つの部品 (`answerActionCommand`) だけが組む。
+  - 同時実行のゲートは `src/server/attachment-delivery/concurrency-gate.ts` から `src/server/concurrency-gate.ts` へ移り (名前と引数の形は同じで、枠を取らない確かめ `canAcquire(owner)` を足した)、過負荷の 503 の `Retry-After` (`retryAfterHeaders`) は `src/server/response.ts` へ、整数の設定の検証 (`requireIntegerSetting`・`resolveIntegerSetting`) は `src/shared/config-errors.ts` へ移った。`src/server/rate-limit.ts` はどの機能のフォルダーも読まず、拒否の理由の名前は各経路が自分で決める (`RateLimitReason` は無い)。
+  - 追加した行の網羅率の検査と値の置き換えの検出は、リポジトリの共有のモジュール (`.config/scripts/lib/changed-lines-coverage.mjs`・`.config/scripts/lib/no-fallback.mjs`) に 1 つずつあり、パッケージの `scripts/` は自分の免除と例外のファイルを渡す薄い入口。値の置き換えの検出は右辺の関数の呼び出し・値の作成・タグ付きテンプレートも数え (`a ?? f()` と `a || f()`)、レビューした例外は `scripts/no-fallback-exceptions.json` に置く。
+  - docstring とコメントの言語の検査は本番のコードを違反 0 に保ち、基準 (`docstring-baseline.json`) に本番のコードの項目を許さない (数を数えるのは spec とテスト用の部品だけ)。
+  - 共有エントリ (公開した名前) とサーバーエントリ (迂回の合わせ方・ストリームの枠) のバンドルの基準を、見直した増加として記録した。
+
+### Added
+
+- 共有エントリ (`@aiquants/daily-report`) が action と API のワイヤの契約を公開する: `DAILY_REPORT_ACTION_INTENTS`・`DAILY_REPORT_ACTION_FIELDS`・`encodeDailyReportActionCommand`・`parseDailyReportActionResult` (`{ result }` か、合わなかった欄の説明の `{ mismatch }` を返す)・`DAILY_REPORT_API_ENDPOINTS`・`DAILY_REPORT_API_QUERY_PARAMS`・`DAILY_REPORT_CLIENT_TEMP_ID_PATTERN` と、型の `DailyReportActionIntent`・`DailyReportActionCommand`・`DailyReportActionResult`・`DailyReportActionResultOf`・`DailyReportActionFailure`。
+  パッケージのクライアントの外から action と API を呼ぶホストは、手で書き写した 2 つ目の契約の代わりにこれを読む。0.33.0 の Breaking の移行の手引きが答えを読む型として挙げた `ActionResult` は、この `DailyReportActionResult` (以前は公開していなかった)。
+- server の `readDailyReportSseStreamEntry` (Redis のストリームのエントリ 1 件を、共有リーダーと同じく 1 度だけ読む。自分のリーダーを渡すホストのため)。
+- キャッシュを迂回する読み取りの閲覧者ごとの上限: `business-date`・`report`・ids のストリームの `forceRefresh=true` は、閲覧者 1 人あたり 1 分に 60 件まで (ハンドラー工場ごと、つまりワーカーのプロセスごと。認証が返す外部の利用者 ID で数える)。上限はパッケージのクライアント自身の迂回 (ビュー 5 つ × 強制の再走査 2 回 × 要求 6 回) から導く。
+  超えた要求は引数の 400 の後、どのサービスの呼び出しよりも前に 429 (`{"error":{"message":"Too many requests"}}`、`Retry-After: 60`) で断る。行は閲覧者の窓ごとに最初の `429 endpoint=<名前> reason=refresh_rate_limit` と、窓の終わりの `refresh_rate_limit_suppressed count=<N> since=<…> route=api` の 2 行まで (warn。既定のロガーの接頭辞は `[DailyReportAPI]`。利用者 ID を書かない)。
+- 閲覧者ごとのストリームの枠: 閲覧者 1 人がワーカーのプロセス 1 つで同時に持てる SSE と ids のストリームは合わせて 32 本 (`DAILY_REPORT_STREAMS_PER_VIEWER`: ビュー 1 つの 2 本 × 16 ビュー)。枠をすべて持つ閲覧者の次のストリームは、本体の仕事を始めずに 503 (`Retry-After: 5`。SSE は本文 `Too many streams`、ids のストリームは `{"error":{"message":"Too many streams"}}`) で断り、枠はストリームが終わる後始末で返す。
+  `HEAD` は枠を取らずに確かめるだけ。行は閲覧者の窓ごとに最初の `503 <sse|ids-stream> viewer=<内部 ID> reason=streams_per_viewer` と、窓の終わりの `streams_per_viewer_suppressed count=<N> since=<…> viewer=<内部 ID> routes=sse:<n>,ids-stream:<n>` の 2 行まで (warn。既定のロガーの接頭辞は `[DailyReportStreams]`)。以前は 1 人の閲覧者の 2,000 本の同時の SSE をどれも受け、それぞれが 60 秒ごとに可視集合を解決し直した (毎秒約 33 回の認可の問い合わせ)。
+
+### Breaking
+
+- action の 200 の答えの日報の ID (`reportHubId`) と消したコメントの ID (`deletedCommentId`) は、SSE のイベントと同じ JSON の数 (1 から 2^53 − 1 までの整数)。以前は 10 進の文字だった。
+  Migration: 答えを自分で読むホストは、2 つの ID を数として読む (`parseDailyReportActionResult` で読めば型が合う)。答えを返す代役 (テストの stub など) は ID を数で返す。
+- server の `jsonResponseWithETag(request, cookie, payload, status = 200)` は 5 番目の引数 (ロガー) を持たず、ログを書かない。
+  Migration: ロガーを渡していた呼び出しは引数を外し、必要な記録は呼び出し側が自分のロガーで書く。
+- キャッシュを迂回する読み取りの閲覧者ごとの上限 (上の Added): 1 人の閲覧者が 1 つのワーカーへ 1 分に 60 件を超えて `forceRefresh=true` を送ると 429。
+  Migration: パッケージのクライアント以外から `forceRefresh=true` を送るホストは 429 を失敗として扱い、`Retry-After` の後に送り直す。
+- 閲覧者ごとのストリームの枠 (上の Added): 1 人の閲覧者が 1 つのワーカーで 32 本を超えて SSE と ids のストリームを同時に開くと 503。
+  Migration: パッケージのクライアント以外からストリームを開くホストは、使い終えたストリームを閉じ、503 を一時的な失敗として `Retry-After` の後に開き直す。
+- ピアの `@aiquants/virtualscroll` の下限を 3.14.0 へ上げた (`peer-floors.json`)。両ビューが 3.14.0 の変更に頼る所は無いが、この版の試験はすべて 3.14.0 の上で通したので、公開する範囲 (`^3.14.0`) と文書の下限をそれに合わせた。
+  Migration: `@aiquants/virtualscroll` を 3.14.0 以降へ上げる。
+
 ## 0.33.0 (2026-10-07)
 
 0.32.0 の続き: 一覧の末尾の近くの削除で錨の日報が跳ばないこと、action の照合用 ID を 2 つの正準の形だけにすること、SSE のエントリをプロセスで 1 度だけ読むことと 1 回の読み取りをバイトの予算で縛ること、action の閲覧者ごとのレートの上限、ids ストリームのアイテムの publish をトランジションの優先度で届けることと、見出しの件数とビューの本体を配置の境界にすること、action と JSON のエンドポイントの共有のワイヤの契約、後で呼ばれるタイマーを持たない期限の記録、原本の HEAD の大きさの契約。どれも README の該当の節が今の振る舞いを述べる。