2026年8月13日の開発日記

今日は、開いた作業のどれもが「思っていた原因」を裏切る一日になった。

本番の検索が壊れていた理由は、前日のデプロイではなくlocalStorageの上限超過だった。Codexのレビューは、動いているように見えて実は空振りしていた。パレート図の記憶は、85%ではなく80%だった。記事プレビューが開かない理由も、ファイアウォールやプロキシではなく、残っていたタブが指す先の開発サーバーがすでに止まっていたことだった。11セッションを3プロジェクトにまたいで動かしながら、そのたびに思い込みを実地で確かめ直す一日になった。

今日のタイムライン

今日やったこと

1. 本番検索の障害調査と方針転換

前日の非公開記事ダンプ対策を本番にデプロイして確認したあと、計画書の積み残しを片付ける途中で、本番の検索が no such column: "unpublished" というエラーを返していることに気づいた。原因を追うと、Nuxt Contentのクライアントキャッシュを置くlocalStorageが5MBの上限を超えていた。本番のダンプは11.3MBに達しており、checksumだけが更新されて古い世代のダンプが残り続け、自力では回復できない壊れ方をしていた。前日のデプロイとは無関係な既存問題だと分かり、issueに残した。計画を締めようとしたところ、別マシンからのマージでブランチがmasterに切り替わっていたので、cherry-pickで取り込んだ。プッシュはすでにoriginへ反映済みだったので不要だった。次のセッションでは検索の修正から「検索機能ごと廃止する」方向へ方針を転換し、Codexにレビューを重ねてもらいながら、404のcatch-allでも同じダンプ取得が起きるという想定外の広がりを実測で確認した。4件の決裁を得たところで、実装は次のセッションへ持ち越した。

主な成果:

• 本番検索エラーの真因をlocalStorage 5MBの上限超過と特定し、issue化
• 検索機能の廃止方針をCodexレビューで固め、4件の決裁を取得

詳細: 本番/searchが壊れた本当の原因はlocalStorageの上限超過だった

2. Codex CLIの復旧

朝のmake-diaryチェーンを回している最中、Codexのレビューがexit 0のまま静かに空振りしていることに気づいた。原因を切り分けると、PCに二重インストールされていたCodex CLIのうち、PATH上にある方だけがサンドボックス用のヘルパーバイナリを同梱しないまま、更新から取り残されていたと判明した。公式アプリ版を優先するランチャーへの切り替えを承認し、issue自身をレビューにかけて実際に動くことを確かめた。復旧したあとは、別件の技術調査でCodexに独立したクロスチェックを依頼したところ、指摘がそのまま的中し、実戦でも裏取りができた。make-diaryのレビュー検証ロジックも「exit 0だけで成功と判定しない」形に直させ、ブランチ経由でmasterに取り込んだ。

主な成果:

• Codex CLIの空振りを、二重インストールとPATHの取り違えまで特定して復旧
• レビュー検証ロジックを「exit 0だけで成功と判定しない」形に修正

詳細: Windows で Codex CLI が動かなくなった原因を切り分けて復旧した記録

3. 所有ドメインのGA4計測棚卸し

前日の対応表に残っていた未了12件を、一つずつ実地で確かめ直すところから始めた。最優先だった本体サイトの計測記録漏れは、コード側の不具合ではなく計測ツール側の反映待ちだと判明した。4サイト分のプロパティ作成を止めていたアカウント権限の壁は、サブアカウントへの切り替えで解消し、そのうちの1つはこのブログ自体だった。サーチコンソールへの登録、522エラーの原因特定に加えて、リダイレクト未追従と通信エラーの再試行という2件の見誤りも実地確認で解消し、12件のうち11件を完了させた。別セッションでは、もう使っていない旧ドメインについて、レジストリ上「そもそも登録記録が無い」状態であることを3つの経路で確認した。

主な成果:

• 未了12件のうち11件を実地確認で完了
• 旧ドメインの登録状況を3つの経路でクロスチェック

詳細: 所有ドメインのGA4計測を棚卸しし、未了12件を実地確認でつぶした

4. 図解カタログのB案統合

「85%で寝るパレート図」を探す計画書の続きに着手したが、記憶していた閾値は実際には80%で、図もリポジトリの外にあった。閾値と保存場所という二重の的外れのまま長時間の探索が空振りしていたと分かったのは、svg-diagramスキルの追加リファレンスを読んだあとだった。原典はそのまま保存し、描き直しは別工程に回すことにした。前日から持ち越していたフレーム分離のB案(フレームをVue側に持たせる案)と、ローカルworktreeにしかなかったカテゴリA11型の実装をmasterへマージした。消失リスクのある未pushブランチを最優先で退避し、並行して動いていた別セッションの終了を確認してからマージした。マージ直後に発生した10秒タイムアウトは、再コンパイル待ちによる誤検知だった。

主な成果:

• フレーム分離B案とカテゴリA11型をmasterへ統合
• 未pushブランチを退避し、消失リスクを解消

詳細: 図解カタログをB案でmasterへ統合した日。カテゴリA11型と、消えていた原典の顛末

5. 開発環境の総点検

種類も原因もまったく違う「動かない」を4つ、順番に片付けた。モニタの電源復旧をきっかけに、ノートPCの横スクロール不具合の残タスクを実測ログで確かめ、見張りタスクによる恒久対策が完了していることを確定させてコミットした。記事プレビューがConnection refusedで開けなかった原因は、停止中の開発サーバーに残ったブラウザタブと判明し、表示確認は静的検証で代替して次回に持ち越した。Chrome拡張のダウンロードボタンが動かない原因は、ChromeのPATHにPythonが入っていないことまで突き止めて修正し、実際にダウンロードが成功するところまで確認した。本番ビルド中に走りっぱなしだったdevプロセスとMCPサーバーを22個掃除し、過去に実績のあるメモリ不足クラッシュを避けた。

主な成果:

• ノートPCの横スクロール不具合の恒久対策を確定
• Chrome拡張のダウンロード機能を実際の成功まで確認
• 走りっぱなしのプロセスを22個掃除

詳細: 開発環境に溜まった4つの不具合を一日で片付けた記録

今日の試行錯誤

今日の学び

• 動いているように見えることは、成功の証拠にならない。exit 0だけを頼りにCodexレビューを信用していたら、1日分のレビューがまるごと素通りしていた
• 本番障害は、直前の変更を疑う前に、独立した既存問題である可能性を切り分ける必要がある。localStorageの上限超過は、前日のデプロイと無関係だった
• 記憶している数値は疑ってかかる。パレート図の閾値を85%だと思い込んだまま探し続け、実際は80%だった
• 環境トラブルの原因は、疑っているレイヤーとは別の場所に潜んでいる。ダウンロードボタンが動かない原因はPATHのPythonで、プレビューが開かない原因は残ったブラウザタブだった
• 消失リスクのあるブランチは、マージ作業より先に退避する

明日やること

• 検索機能の廃止を実装する（決裁済みの方針に沿って）
• パレート図の原典をもとに、図の描き直しを進める
• 記事プレビューの実際の表示を確認する（静的検証からの本確認）
• GA4計測棚卸しの残り1件を確認する

関連記事

• 本番/searchが壊れた本当の原因はlocalStorageの上限超過だった
• Windows で Codex CLI が動かなくなった原因を切り分けて復旧した記録
• 所有ドメインのGA4計測を棚卸しし、未了12件を実地確認でつぶした
• 図解カタログをB案でmasterへ統合した日。カテゴリA11型と、消えていた原典の顛末
• 開発環境に溜まった4つの不具合を一日で片付けた記録