位置づけ

第 3 弾のコードレビュー(main fca42699 対象、2026-10-19〜21)は、利用上限で何度も中断した。そのため、横断観点の洗い出し 5 担当と、洗い出したが検証していない指摘 43 件が残った。2026-10-23 に nishio の「土日に仕事したくないから多めに使っといて」を受けて、この残りを仕上げた。観測時点は kouchou-ai main b675e032(#1058 まで merge 済み)。source-codeより

進め方はこれまでと同じで、洗い出し → 1 件ずつ反証・再現で検証 → 確定したものだけを修正、の順。修正は指摘ごとに main から別ブランチを切り、先に「修正前のコードで落ちるテスト」を書いてから直した。前回までの経緯は deep-code-review-2026-10-19 と code-health-review-2026-10-18。

洗い出しと検証の結果

範囲洗い出し確定反証
テストの質330
ドキュメントの正確さ1091
設定と環境変数440
規模と性能660
未検証だった 43 件—394
  • 未検証 43 件の反証 4 件のうち 2 件は、#1043 などで既に直っていた。
  • 確定 39 件のうち 1 件は、既知 Issue #954 と同じ内容だった。
  • 重要度 high は、規模と性能の 1 件だけだった(下の #1102)。

修正 PR(すべて未 merge)

公開ビューア

  • #1063:属性が空の意見が、検索と属性フィルタの併用で一致扱いになる
  • #1064:属性列の無いレポートでフィルタボタンが出ない
  • #1065:metadata の message・reporter が無いと落ちる
  • #1066:数値範囲の入力が 1 文字ごとに丸められる
  • #1096:Firefox でツリーマップの着色が落ちる
  • #1097:フィルタ変更でリストの展開が閉じる
  • #1098:タブを戻るたびに勝手にスクロールする
  • #1085:静的書き出しの og:image が存在しないファイルを指す

公開ビューアの性能

  • 3 本は積み上げで、merge の順は #1069 → #1070 → #1071。後ろの 2 本は draft にしてある。
  • 内容は、フィルタ中の線形探索の除去、描画データの memo 化、ツリーマップの葉を表示階層に絞ること。
  • jest での計測では、4 万件の散布図の再描画が約 25 秒から約 0.5 秒になった。
  • 描画データとピクセルが修正前と一致することも確かめた。

管理画面

  • #1083:意見グループ編集が開き直せない
  • #1084:CSV の二重解析
  • #1081:取り込んだ属性名に attribute_ が二重に付く。新しく作るレポートの属性名の見え方が変わる
  • #1095:LLM 直接グルーピング中の進捗表示

API

  • #1062:OpenRouter のモデル名が「unknown - …」になる
  • #1067:削除したレポートが再集計の完了で復活する
  • #1078:複製で並列数がラベリングに届かない
  • #1079:起動時の同期を、削除済みと複製専用の成果物について絞る
  • #1080:プラグインの応答に placeholder と isEnabled が無い

analysis-core

  • #1068:結果 JSON を一時ファイル経由で 1 回だけ書く
  • #1082:1 段のレポートの report.html に意見一覧が出ない
  • #1086:外部プラグインの読み込み順と、その案内
  • #1099:3 件以下の入力で UMAP が落ちる
  • #1100:report.html の書き出し失敗が成功扱いになる
  • #1101:LLM 直接グルーピングのタイムアウトが固定値

規模

  • #1102(high):埋め込みを float32 の配列で持つ。
    • 3 万件で最大メモリが 4.2GB から 2.0GB に下がった。
    • 古い embeddings.pkl も読める。UMAP の座標は修正前と一致した。
  • #1103:抽出をバッチ待ちではなくプールで回す。
  • #1104:Web 経路では使わない UMAP モデルを保存しない。

設定・デプロイ設定

  • #1087:admin のサーバー側が読む ADMIN_API_KEY が渡らず、再利用・複製が失敗する
  • #1088:キャッシュ破棄用の secret が public-viewer に渡らない
  • #1089:admin のビルド引数

開発基盤

  • #1090:docs のワークフローの起動条件と concurrency
  • #1091:dummy-server のポート
  • #1092:setup スクリプトの終了コード
  • #1093:rye の無い環境の pre-push
  • #1094:sha256sum の無い環境

ドキュメント・テスト

  • #1072:Python 利用ガイドの結果読み込み例が、今の出力形式で動かない
  • #1073:プラグイン開発ガイドの例
  • #1074:Linux・セルフホストの手順
  • #1075:PyPI リリース手順
  • #1076:.env の timeout 設定でテストが落ちる
  • #1077:公開 API の公開範囲のテストを追加

ほかに確定した修正が数件ある。別の修正と出す順序を合わせる必要があるので、後日出す。

気づき

  • 洗い出しより検証が安い
    • 未検証 14〜15 件の検証ワークフローは、どれも約 7 分で終わった。
    • 洗い出し 1 担当は 12 分〜1 時間半かかった。
    • 前回、上限で中断したのは洗い出しを 3 本並行させたときだった。今回は 1 本あたり 2 担当にして、5 時間枠に当たらずに回せた。
  • 検証は落とすべきものを落とす
    • 43 件のうち 4 件が反証された。そのうち 2 件は、その後の PR で既に直っていた。
    • 洗い出しから時間が経った指摘は、検証の前に「base..HEAD で直っていないか」を見る仕組みが効く。
  • 修正担当は指摘の誤りも直す
    • #1071 では、検証者の修正方針にあった Plotly のズームの深さの理解が誤っていた。修正担当が実際に描画して確かめ、訂正した。
    • #1076 では、「環境を固定する」案が既定引数の評価のタイミングのせいで効かないことを見つけた。

Open Questions

  • 修正しなかった確定指摘の残件。どれも設計の判断が要る。
    • 公開ビューアが結果 JSON 全体を HTML に埋め込む(3 万件で SSR 約 1GB)
    • 静的書き出しが全レポートを毎回書き出す
    • LLM 直接グルーピングの割当は PR #1118 で並列化済みだが、途中経過の保存は未実装
    • 抽出の形式不正・途中切れは PR #1119 でその回答だけ再試行する。再試行しても失敗する場合の扱いは残る(コンテンツフィルタ時の継続は PR #1150 で別途対応)
    • 複製で入力 CSV を取れないときの黙った続行は PR #1120 の警告で解消したが、代替入力で続行する方針自体を変えるかは未決
    • エラーのレポートを再利用する導線が無い
    • 削除が論理削除である
  • 散布図で同じ点が 2 本のトレースに重なっている件。消すとホバー文言が変わる可能性があり、実ブラウザでの確認が要る。

Updates

  • 2026-10-23 夜:PR の独立レビューと、残りの 2 観点の洗い出しを行った。
    • 独立レビュー
      • その時点で開いていた修正 PR を、作った担当とは別の担当が読んだ。10 件を洗い出し、9 件が確定した。
      • #1079 の後、複製時に Blob から取る埋め込みファイルの取得が途中で失敗すると、空のファイルが残り、取り直されない。書き込み方の問題自体は main に元からある。
      • #1084 の後も、CSV の解析中にタブを移ると列が上書きされる。
      • この 2 件は、それぞれの PR に commit を足して直した。
      • クラスタ一覧の再描画は、#1105 にした(draft、#1071 の後)。
      • 残りの指摘は、#1060(表示言語切替)に対するもの。作者に伝えた。
    • LLM プロバイダの組み合わせ(6 件)
      • #1112:複製でプロバイダを替えたときの埋め込みモデル
      • #1113:Azure の推論モデルの判定
      • #1114:local の strict な json_schema
      • #1115:OpenRouter の取り直しのトークン数
      • #1116:公開ページのモデル名
      • #1117:Gemini 2.5 Flash の単価
    • 分析結果の不変条件(6 件)
      • #1106:CLI の limit の既定値 1000 で黙って切り詰める
      • #1107:0 件のグループのラベルが原点に浮く
      • #1108:10 段以上の階層
      • #1109:relations の重複行
      • #1110:空の説明が ‘None’ になる
      • #1111:階層リストのフィルタ中の件数
    • 判断が要る点
      • #1106:既定値を全件にするか
      • #1116:Azure の実際のモデル名を公開ページに出すか
  • 2026-10-23 深夜:nishio「使用量見て、まだ回せるなら続けて」を受けて、さらに次を行った。
    • 夜の 13 本の独立レビュー:3 件が確定。
      • #1113 は、表示名の MODEL_NAME を持つ Azure 環境で 400 になる。判定を「どちらかが推論モデル名なら推論」に変えた。
      • #1102 と #1116 は、merge 順の注意を PR にコメントした。
    • 確定済みで未修正だった 3 件
      • #1118:LLM 直接グルーピングの割当を並列にする。mock の 5,000 件で 10 秒から 0.4 秒になった。
      • #1119:形式が壊れた応答を、その回答だけ送り直す。
      • #1120:複製で入力を作り直したら、警告を残す。
    • 批評ラウンドの 2 回目
      • 番号で区切ったため、独立レビューから抜けていた PR があった。そのレビューで 5 件が確定し、#1104・#1095・#1102 に commit を足した。
      • 旧バージョンのレポートの互換性:旧タグで実際に成果物を作り、今のコードに通して試した。3 件が確定した。
        • #1121(draft、#1102 の後):v4.0 以前の埋め込みファイルは pandas 形式のため、クラスタ数を変える再利用が必ず失敗する
        • #1122:v2.0 のレポートに provider が無い
        • #1123:v1.0 の status で一覧が 500 になる
    • 気づき
      • PR のレビューを番号の範囲で分担すると、範囲の境目に抜けが出る。批評ラウンドがそれを見つけた。
      • 旧バージョンの互換性は、fixture が無かったため、過去の担当は「未再現」として見送っていた。旧タグで実際に成果物を作ると、すぐ再現できた。
  • 2026-10-23 深夜(最後):残りの 2 つを見た。6 件が確定した。
    • 深夜の PR の独立レビュー:#1118 と #1119 の詰めの甘さ 2 件に、commit を足した。
    • 管理画面の本番ビルドを実ブラウザで操作する検査:
      • #1124(medium):約 10MB を超える CSV からレポートを作れない。Basic 認証の middleware が本文を 10MB で切るため、#804 で上げたはずの上限が一度も効いていなかった。
      • #1125:5 分を超える静的書き出しのダウンロードが失敗する。
      • #1126:アップロードが長いと、カードが「作成中」のまま止まる。
      • ほかにも確定した指摘があるが、別の修正と出す順序を合わせる必要があるので、後日出す。
    • 気づき:jest と dummy-server の E2E では、本番ビルドの middleware の挙動が見えない。本番ビルドに実ブラウザで通すと、すぐ見つかった。
  • 2026-10-24:nishio の指示(「CodeRabbit の review を見つつ、CI が通ったら merge」「のんびりと第 2 陣・第 3 陣も続けて」)を受けて、修正 PR を 3 陣に分けて 1 本ずつ admin merge した。
    • merge した数:64 本。#1127(Next.js 16.4.2)を含めると 65 本で、main は bdc3e469。
    • 衝突:積み上げの PR と、衝突する組み合わせは、PR 本文とコメントに書いておいた解き方で rebase して解いた。
    • CodeRabbit の指摘:実際の指摘は 10 件ほどで、追加の commit で直してから merge した。主なもの:
      • #1084:再解析中に作成できた
      • #1095:工程の記録が無いまま error になると待ち続けた
      • #1102:次元がそろわない埋め込み
      • #1104:null の扱いと文書
    • レビューが無いまま merge したもの:大半の PR は rate limit でレビューされず、10/23 の独立レビューだけを経ている。
    • main でのテスト:merge 後の main で全件通った。CLI も、偽の LLM で hierarchical と llm_grouping を最後まで通した。
      • analysis-core:608 件
      • api:472 件
      • admin:240 件
      • public-viewer:253 件
    • 残り
      • #1079:実行環境の権限判定で merge と force push が止まり、nishio の判断待ち。
      • #1119 への CodeRabbit の指摘(parse 経路で送り直した分のトークンが 0 と数えられる)は、範囲外として別の課題に残した。
  • 2026-10-24(続き):
    • #1079 を最新の main に rebase し直し、nishio が merge した(7fff37a4)。修正 PR 65 本は、これですべて merge 済み。
    • #1119 への CodeRabbit の指摘は、Issue #1128 にした。
    • 外部コントリビュータの #1061(Node runtime 依存一覧の訂正)は、最新の main と照合してレビューし、merge した(f422dcc6)。軽微な修正はこちらで後から行う。
  • 2026-11-07: Open Questions から除去 — 「43 本の PR のレビューと merge の判断。人間の attention を使う操作なので、明示の指示があるときだけ行う。merge の前に、独立したレビューを別に回している。」。#1062–#1104 の43本すべてが10月24日の main 履歴にある。レビューの品質を別途保証する判定ではない。(根拠: kouchou-ai upstream/main: git log —grep (#1062) … (#1104)(2026-10-24、43件))。
  • 2026-11-07: Open Questions から除去 — 「挙動・見た目の判断が要る PR(詳細は各 PR 本文)」。6件とも対応するPRが10月24日に main 入りし、当時の採否待ちは解消。Web の UMAP 再利用 #989 全体の完了とはしない。(根拠: kouchou-ai 4262aec69 / a9a378465 / a0e7f1621 / c342e51b5 / 6c4af54a2 / 9a924e2f1)。
  • 2026-11-07: Open Questions の現状を更新 — 「修正しなかった確定指摘。どれも設計の判断が要る。」。割当の並列化 #1118、抽出の再試行 #1119、複製時警告 #1120 が後続実装された。途中保存や抽出の最終失敗時の扱いは残る。(根拠: kouchou-ai cdca53e71 / 5e4850572 / b775d64e2(2026-10-24);kouchou-ai 769dfbc08(2026-10-27、コンテンツフィルタ時の継続))。