位置づけ
第 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。
洗い出しと検証の結果
| 範囲 | 洗い出し | 確定 | 反証 |
|---|---|---|---|
| テストの質 | 3 | 3 | 0 |
| ドキュメントの正確さ | 10 | 9 | 1 |
| 設定と環境変数 | 4 | 4 | 0 |
| 規模と性能 | 6 | 6 | 0 |
| 未検証だった 43 件 | — | 39 | 4 |
- 未検証 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で直っていないか」を見る仕組みが効く。
- 修正担当は指摘の誤りも直す
Open Questions
- 修正しなかった確定指摘の残件。どれも設計の判断が要る。
- 散布図で同じ点が 2 本のトレースに重なっている件。消すとホバー文言が変わる可能性があり、実ブラウザでの確認が要る。
Updates
- 2026-10-23 夜:PR の独立レビューと、残りの 2 観点の洗い出しを行った。
- 独立レビュー
- LLM プロバイダの組み合わせ(6 件)
- 分析結果の不変条件(6 件)
- 判断が要る点
- 2026-10-23 深夜:nishio「使用量見て、まだ回せるなら続けて」を受けて、さらに次を行った。
- 夜の 13 本の独立レビュー:3 件が確定。
- 確定済みで未修正だった 3 件
- 批評ラウンドの 2 回目
- 気づき
- PR のレビューを番号の範囲で分担すると、範囲の境目に抜けが出る。批評ラウンドがそれを見つけた。
- 旧バージョンの互換性は、fixture が無かったため、過去の担当は「未再現」として見送っていた。旧タグで実際に成果物を作ると、すぐ再現できた。
- 2026-10-23 深夜(最後):残りの 2 つを見た。6 件が確定した。
- 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 した。主なもの:
- レビューが無いまま merge したもの:大半の PR は rate limit でレビューされず、10/23 の独立レビューだけを経ている。
- main でのテスト:merge 後の main で全件通った。CLI も、偽の LLM で hierarchical と llm_grouping を最後まで通した。
- analysis-core:608 件
- api:472 件
- admin:240 件
- public-viewer:253 件
- 残り
- merge した数:64 本。#1127(Next.js 16.4.2)を含めると 65 本で、main は
- 2026-10-24(続き):
- 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、コンテンツフィルタ時の継続))。