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.

⭐0stars🔀1forks📁View on GitHub🕐Updated Jan 8, 2026⬇️2downloads

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.
nameoe-integration-mode-smoke
descriptionSmoke-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)

  1. Export required env vars:

    • export OE_INTEGRATION_MODE=supabase
    • export OE_SUPABASE_URL=...
    • export OE_SUPABASE_KEY=...
    • export OE_TEAM_ID=...
    • export OE_SYSTEM_USER_ID=...
    • (optional) export OE_EMAIL_ACCOUNT_ID=...
  2. Run the built-in connection validator:

    • python -m backend.workflows.io.integration.test_connection

Live OpenAI integration lane (only when explicitly needed)

  1. Export integration test env vars:

    • export AGENT_MODE=openai
    • export OPENAI_TEST_MODE=1
    • export OPENAI_API_KEY=...
  2. 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.py
    • backend/workflows/io/integration/field_mapping.py
    • backend/workflows/io/integration/status_utils.py