oe-integration-mode-smoke
Smoke-test “integration mode” safely (Supabase + optional live OpenAI integration tests). Use when debugging prod-only differences, validating Supabase connectivity, or running backend/tests_integration without turning every local run into a deployment.
When & Why to Use This Skill
This Claude skill facilitates safe and efficient smoke-testing for backend integration modes, specifically targeting Supabase and OpenAI environments. It enables developers to validate connectivity, run targeted integration tests, and debug production-level discrepancies locally without the overhead of a full deployment, ensuring robust backend performance.
Use Cases
- Validating Supabase database connectivity and environment variable configurations to ensure the backend can communicate with the data layer.
- Executing live OpenAI integration tests in a dedicated 'test mode' to verify AI model responses and API reliability before shipping.
- Debugging production-only issues by simulating integration layers locally using specific adapter and field mapping configurations.
- Running backend integration smoke tests (backend/tests_integration) safely without triggering a full CI/CD deployment cycle.
| name | oe-integration-mode-smoke |
|---|---|
| description | Smoke-test “integration mode” safely (Supabase + optional live OpenAI integration tests). Use when debugging prod-only differences, validating Supabase connectivity, or running backend/tests_integration without turning every local run into a deployment. |
oe-integration-mode-smoke
Supabase connectivity (fastest signal)
Export required env vars:
export OE_INTEGRATION_MODE=supabaseexport OE_SUPABASE_URL=...export OE_SUPABASE_KEY=...export OE_TEAM_ID=...export OE_SYSTEM_USER_ID=...- (optional)
export OE_EMAIL_ACCOUNT_ID=...
Run the built-in connection validator:
python -m backend.workflows.io.integration.test_connection
Live OpenAI integration lane (only when explicitly needed)
Export integration test env vars:
export AGENT_MODE=openaiexport OPENAI_TEST_MODE=1export OPENAI_API_KEY=...
Run the integration tests:
pytest backend/tests_integration/ -v
If a test fails
- Prefer fixing the contract in the integration adapter layer first:
backend/workflows/io/integration/adapter.pybackend/workflows/io/integration/field_mapping.pybackend/workflows/io/integration/status_utils.py