Skip to content

Add explicit migration operator guidance and surface on schema mismatch - #71

Merged
DeepZone merged 1 commit into
mainfrom
codex/perform-final-release-readiness-check
May 24, 2026
Merged

Add explicit migration operator guidance and surface on schema mismatch#71
DeepZone merged 1 commit into
mainfrom
codex/perform-final-release-readiness-check

Conversation

@DeepZone

Copy link
Copy Markdown
Owner

Motivation

  • Provide a single, clear operator guidance message for database migration mismatches and surface it both in system status and runtime schema-mismatch errors so operators have exact commands to remediate.

Description

  • Add MIGRATION_OPERATOR_GUIDANCE to backend/app/core/system_status.py and use it in build_system_status when migration_status is not up_to_date.
  • Replace the inline 503 error text in backend/app/api/routes_checks.py OperationalError handling with the shared MIGRATION_OPERATOR_GUIDANCE so persistence failures due to missing migration columns return consistent remediation steps.

Testing

  • Ran backend tests cd backend && pytest -q (107 passed) and frontend build cd frontend && npm run build (successful), and executed Alembic/app smoke checks with PYTHONPATH=. (alembic heads, alembic current, and python -c "from app.main import app; print('app import ok', bool(app))") which succeeded, noting alembic current fails in this shell without PYTHONPATH=..

Codex Task

@DeepZone
DeepZone merged commit 5890790 into main May 24, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant