CI/CD pipeline

# bitbucket-pipelines.yml — ILLUSTRATIVE (Python service: vox-backend / vox-agents / vox-dialler)
image: python:3.12-slim

definitions:
  steps:
    - step: &lint-and-test
        name: Lint & test
        caches:
          - pip
        script:
          - pip install uv
          - uv sync
          - uv run ruff check .
          - uv run pytest -v

pipelines:
  # every branch & PR — CI only, never deploys
  branches:
    '**':
      - step: *lint-and-test

  # main — CI, then a manual gate that triggers the Jenkins deploy job
  pipelines:
    main:
      - step: *lint-and-test
      - step:
          name: Trigger deploy (main only)
          trigger: manual
          script:
            - echo "Green on main — notifying Jenkins to deploy from main"
            - curl -fsS -X POST "$JENKINS_DEPLOY_HOOK"

// Jenkinsfile — ILLUSTRATIVE declarative pipeline for a Python service (e.g. vox-backend)
pipeline {
  agent any

  options {
    timestamps()
    disableConcurrentBuilds()
  }

  stages {
    stage('Install & lint') {
      steps {
        sh 'uv sync'
        sh 'uv run ruff check .'
      }
    }

    stage('Test') {
      steps {
        sh 'uv run pytest -v'
      }
    }

    // CD only runs on main — feature branches stop after Test
    stage('Deploy from main') {
      when { branch 'main' }
      steps {
        // On the target host: check out the release, rebuild the venv, restart, verify.
        sshagent(['deploy-key']) {
          sh '''
            ssh deploy@api-host '
              cd /opt/voxbridge &&
              git fetch --all --tags &&
              git checkout main &&
              git reset --hard origin/main &&
              uv sync &&
              sudo systemctl restart voxbridge
            '
          '''
        }
      }
    }

    stage('Post-deploy health check') {
      when { branch 'main' }
      steps {
        // App boots only if required settings are present; a 200 means it came up clean.
        sh 'curl -fsS http://api-host:8080/health'
      }
    }
  }

  post {
    failure {
      echo 'Build or deploy failed — main was NOT shipped. Re-run against last-known-good tag to roll back.'
    }
  }
}