予約投稿の冪等性――同一時刻・再試行・quote postを検証する

Cron重複やAPI timeout時に、同じ下書きが複数のX投稿として公開される経路をどう抑えるか。

コードから観測できること

1. posts routeとpost scheduler serviceが分離され、scheduler専用testがある。予約作成と公開処理は別の状態遷移である。
2. scheduled posts quote migrationにより通常投稿と引用投稿が同じ予約基盤へ拡張された履歴を確認できる。
3. X API応答が失われた場合、投稿失敗と断定して即再送すると重複する。外部post IDの照合と不明状態が必要になる。

再現・追加測定の手順

1. 同一予約を並列取得するCronを模擬する
2. API成功後に応答timeoutを注入する
3. 通常・返信・引用投稿を別々に試す
4. D1状態と実X post IDを照合する

この資料だけでは証明できないこと

1. X側の冪等性仕様はendpointごとに確認が必要。
2. 削除後の再投稿は重複検出ルールを別途定義する必要がある。

このページは新しいcommit、実測ログ、API仕様変更が得られた時点で更新します。古い観測条件と現在仕様を混同しないため、固定commitへのリンクを残します。