GAS「Scripts may only have up to 20 versioned deployments」— 失敗表示でも反映は済んでいることがある

症状

clasp push → clasp deploy を続けて行うデプロイスクリプトが、次のエラーで失敗する:

Scripts may only have up to 20 versioned deployments at a time.

これを見て「デプロイ失敗＝変更は本番に出ていない」と判断すると誤る。

何が起きているか

1. clasp push は成功している（push に失敗すればスクリプトはその場で止まるはず。止まる作りかを先に確認する）。
2. 失敗したのは clasp deploy（新しいバージョン付きデプロイの作成）だけ。
3. Apps Script の時間主導トリガー・シートのトリガーは、バージョン付きデプロイではなく **HEAD（最新の保存コード）**で動く。 → トリガーで動く処理（定期ジョブなど）は、次回のトリガー実行から新しいコードになる。
4. 一方で Web アプリの /exec URL は、バージョン付きデプロイを指したまま＝旧コードを配信し続ける。

判定手順（AI にそのまま渡せる）

1. デプロイスクリプトの push 部分が、失敗時に例外で止まる作りかを読む。止まるなら push は成功。
2. 変えたのがトリガーで動く処理なら、トリガーの最終実行時刻が push より後かを確認する。
3. 「成功表示」ではなく、処理結果そのもの（書き込んだ外部システムの値・公開画面の表示）を読み戻して判定する。
4. Web アプリ（/exec）の挙動を変えた場合だけ、古いデプロイを減らしてから作り直す:

   clasp list-deployments
   clasp undeploy <古いdeploymentId>   # @HEAD と、現在 URL が指している ID は消さない
   clasp deploy --description "<変更内容>"
   

5. 新しいデプロイを作ったら、/exec の応答に新しく足したキーや action が入っているかで反映を判定する（応答長や成功表示では判定できない）。

やってはいけないこと

• エラーを見ただけで「未反映」と報告し、同じ変更をもう一度当てる・人に手作業を頼む。
• @HEAD や、現在使っている URL のデプロイを undeploy する。