fix(ci): alembic migration ガードの誤検知を解消 — ファイル名でなくスキーマ影響で判定 - #995
Merged
Merged
Conversation
## 問題 `models 変更時 migration 必須化` は「`models.py` というファイルが変更されたか」だけで判定しており、 **中身を見ていなかった**。そのため docstring / 定数 / ヘルパ関数の変更でも FAIL する。 PR #994 で顕在化: `PHASE_1_ALLOWED_RISK_MODES` を env 由来化した変更（`_allowed_risk_modes_from_env()` の追加のみ・**列/制約/テーブルの差分ゼロ**）が落ちた。 「赤いのが常態」は本物の schema drift を見逃す土壌になる。本スクリプト自身の設計メモも **「例外（コメントのみ変更など）は未実装。まず厳密に。誤検知が問題化したら例外追加。」** と書いており、その想定どおり誤検知が問題化したので例外を実装する。 ## 修正 migration が無い models 変更について、差分の**追加/削除行**に SQLAlchemy のスキーマ関連字句が 1 つでもあるかを見る: ``` mapped_column | Column( | __tablename__ | __table_args__ | CheckConstraint | UniqueConstraint | PrimaryKeyConstraint | ForeignKey | Index( | relationship( | server_default | nullable= | primary_key | autoincrement | Mapped[ | ALTER TABLE | CREATE TABLE | DROP COLUMN | sa. ``` - 1 つでもあれば → **従来どおり FAIL**（migration 必須） - 1 つも無ければ → skip（判定根拠をログに出す） **fail-closed 設計**: コメント内の一致でも FAIL する。「スキーマ変更かもしれない」は全て FAIL 側に 倒し、確実に無関係なときだけ通す。PR description による bypass（`[skip-alembic-check]`）は **実装しない** — スクリプトが自分でグリーンにできる抜け道を作らず、人間の明示的な判断を残す。 ## 検証（実データ） 過去に実際に `backend/app/auth/models.py` を変更したコミット 20 件で判定を確認: - **本物のスキーマ変更は全て FAIL 判定**: - Phase-D D5b（`aggressive_ack_at` / `aggressive_ack_version` 列追加）→ hits=6 - per-user `privy_wallet_id` 追加 → hits=1 - 顧客 PII フィールドレベル暗号化 → hits=3 - staging-v4 月額決済（Stripe 列追加）→ hits=6 - **#994 の env 化のみ** → hits=0 = pass（期待どおり） `bash -n` 構文 OK。shellcheck の指摘は既存行の style (SC2001) のみで新規なし。 ## 併せて修正: エラーメッセージが危険な手順を案内していた 旧メッセージは `alembic revision --autogenerate` を案内していたが、**本リポジトリでは使用禁止**。 `alembic/env.py` が全モデルを import しておらず `Base.metadata` が不完全なため、実在するテーブルへの DROP を誤生成する（memory: `project_alembic_envpy_incomplete_model_imports`）。 指示に従うと本番を壊すため、「手書きで追加」+ 禁止理由の明示に変更した。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Edj3hjkB6XrjYezmARpQEq
🛡️ Path Access Control
|
🤖 Codex ReviewSecurity Check: ✅ PASS No issues found. ✨ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
問題
models 変更時 migration 必須化は 「models.pyというファイルが変更されたか」だけで判定しており、中身を見ていませんでした。docstring / 定数 / ヘルパ関数の変更でも FAIL します。PR #994 で顕在化しました。
PHASE_1_ALLOWED_RISK_MODESの env 由来化（列・制約・テーブルの差分ゼロ）が落ちています:「赤いのが常態」は本物の schema drift を見逃す土壌になります。本スクリプト自身の設計メモも「例外（コメントのみ変更など）は未実装。まず厳密に。誤検知が問題化したら例外追加。」と書いており、その想定どおりになったので実装します。
修正
migration が無い models 変更について、差分の追加/削除行に SQLAlchemy のスキーマ関連字句があるかを見ます:
fail-closed 設計です。コメント内の一致でも FAIL します。「スキーマ変更かもしれない」は全て FAIL 側に倒し、確実に無関係なときだけ通します。
[skip-alembic-check]による description バイパスは実装しません — スクリプトが自分でグリーンにできる抜け道を作らず、人間の明示的な判断を残すためです。検証（実データ）
過去に実際に
backend/app/auth/models.pyを変更したコミット20件で判定を確認しました。本物のスキーマ変更は全て FAIL 判定:
aggressive_ack_at/_version列追加）privy_wallet_id追加bash -n構文 OK。shellcheck の新規指摘なし（既存行の style SC2001 のみ）。併せて修正: エラーメッセージが危険な手順を案内していた
旧メッセージは
alembic revision --autogenerateを案内していましたが、本リポジトリでは使用禁止です。alembic/env.pyが全モデルを import しておらずBase.metadataが不完全なため、実在するテーブルへの DROP を誤生成します（memory:project_alembic_envpy_incomplete_model_imports）。CI の指示に従うと本番を壊すため、「手書きで追加」+ 禁止理由の明示に変更しました。影響
CI ガードのみ。アプリケーションコードへの変更なし。
🤖 Generated with Claude Code
https://claude.ai/code/session_01Edj3hjkB6XrjYezmARpQEq