airbyte-internal-ops 0.2.0__tar.gz → 0.2.2__tar.gz

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/release-drafter.yml

@@ -64,4 +64,5 @@ autolabeler:
       - '/^build\(deps\)\:/i'
   - label: "breaking"
     title:
-      - '/!:\s*$/i'
+      # Match conventional commit breaking change syntax: feat!: or fix!: etc.
+      - '/^[a-zA-Z]+(\([^)]+\))?!:/i'

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/workflows/autofix-command.yml

@@ -20,10 +20,9 @@ jobs:
   run-autofix-command:
     runs-on: ubuntu-latest
     steps:
-      - name: Authenticate as GitHub App (if available)
+      - name: Authenticate as GitHub App
         uses: actions/create-github-app-token@v2
         id: get-app-token
-        continue-on-error: true
         with:
           app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
           private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
@@ -33,5 +32,5 @@ jobs:
         with:
           pr: ${{ github.event.inputs.pr }}
           comment-id: ${{ github.event.inputs.comment-id }}
-          github-token: ${{ steps.get-app-token.outputs.token || secrets.GITHUB_TOKEN }}
+          github-token: ${{ steps.get-app-token.outputs.token }}
           command: autofix

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/workflows/connector-regression-test.yml

@@ -6,70 +6,67 @@ permissions:
 on:
   workflow_dispatch:
     inputs:
-      target_image:
-        description: "Target connector image (new version) with tag (e.g., airbyte/source-github:2.0.0). Optional if connector_name is provided."
-        required: false
-        type: string
-      control_image:
-        description: "Control connector image (baseline version) with tag (e.g., airbyte/source-github:1.0.0). Optional if connection_id is provided (auto-detected)."
-        required: false
-        type: string
       connector_name:
-        description: "Connector name to build target image from source (e.g., 'source-pokeapi'). If provided, builds the target image locally."
-        required: false
+        description: "Connector name to build from source (e.g., 'source-pokeapi')."
+        required: true
         type: string
       pr:
-        description: "PR number from the airbyte repo to checkout and build from (e.g., 70847). Only used when connector_name is provided."
+        description: "PR number from the airbyte repo to checkout and build from (e.g., 70847)."
+        required: true
+        type: string
+      connection_id:
+        description: "Airbyte Cloud connection ID to fetch config/catalog from."
         required: false
         type: string
-      command:
-        description: "Airbyte command to run"
+      skip_compare:
+        description: "If true, skip comparison and run single-version tests only. If false (default), run comparison tests (target vs control)."
         required: false
-        type: choice
-        options:
-          - spec
-          - check
-          - discover
-          - read
-        default: check
-      connection_id:
-        description: "Airbyte Cloud connection ID to fetch config/catalog from. If provided, control_image can be auto-detected."
+        type: boolean
+        default: false
+      skip_read_action:
+        description: "If true, skip the read action (run only spec, check, discover)."
+        required: false
+        type: boolean
+        default: false
+      override_test_image:
+        description: "Override test connector image with tag (e.g., airbyte/source-github:1.0.0). Ignored if skip_compare=false."
         required: false
         type: string
-      state_path:
-        description: "Path to state JSON file (optional for read)"
+      override_control_image:
+        description: "Override control connector image (baseline version) with tag. Ignored if skip_compare=true."
         required: false
         type: string
 
   workflow_call:
     inputs:
-      target_image:
-        description: "Target connector image (new version) with tag. Optional if connector_name is provided."
-        required: false
-        type: string
-      control_image:
-        description: "Control connector image (baseline version) with tag. Optional if connection_id is provided."
-        required: false
-        type: string
       connector_name:
-        description: "Connector name to build target image from source (e.g., 'source-pokeapi')."
-        required: false
+        description: "Connector name to build from source (e.g., 'source-pokeapi')."
+        required: true
         type: string
       pr:
-        description: "PR number from the airbyte repo to checkout and build from. Only used when connector_name is provided."
-        required: false
+        description: "PR number from the airbyte repo to checkout and build from."
+        required: true
         type: string
-      command:
-        description: "Airbyte command to run (spec, check, discover, read)"
+      connection_id:
+        description: "Airbyte Cloud connection ID to fetch config/catalog from."
         required: false
         type: string
-        default: check
-      connection_id:
-        description: "Airbyte Cloud connection ID to fetch config/catalog from. If provided, control_image can be auto-detected."
+      skip_compare:
+        description: "If true, skip comparison and run single-version tests only. If false (default), run comparison tests (target vs control)."
+        required: false
+        type: boolean
+        default: false
+      skip_read_action:
+        description: "If true, skip the read action (run only spec, check, discover)."
+        required: false
+        type: boolean
+        default: false
+      override_test_image:
+        description: "Override test connector image with tag. Ignored if skip_compare=false."
         required: false
         type: string
-      state_path:
-        description: "Path to state JSON file (optional for read)"
+      override_control_image:
+        description: "Override control connector image (baseline version) with tag. Ignored if skip_compare=true."
         required: false
         type: string
     outputs:
@@ -91,9 +88,32 @@ on:
         required: false
 
 jobs:
+  # Determine which commands to run based on inputs
+  prepare:
+    name: Prepare Test Matrix
+    runs-on: ubuntu-latest
+    outputs:
+      commands: ${{ steps.set-commands.outputs.commands }}
+    steps:
+      - name: Determine commands to run
+        id: set-commands
+        run: |
+          SKIP_READ="${{ inputs.skip_read_action }}"
+          
+          if [ "$SKIP_READ" = "true" ]; then
+            echo 'commands=["spec", "check", "discover"]' >> "$GITHUB_OUTPUT"
+          else
+            echo 'commands=["spec", "check", "discover", "read"]' >> "$GITHUB_OUTPUT"
+          fi
+
   regression-test:
-    name: Run Regression Test
+    name: Run Regression Test (${{ matrix.command }})
+    needs: prepare
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        command: ${{ fromJson(needs.prepare.outputs.commands) }}
     outputs:
       success: ${{ steps.regression-test.outputs.success }}
       summary_url: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
@@ -116,19 +136,12 @@ jobs:
         run: uv sync --group dev
 
       - name: Resolve Airbyte ref
-        if: ${{ inputs.connector_name != '' }}
         id: resolve-airbyte-ref
         run: |
-          if [ -n "${{ inputs.pr }}" ]; then
-            echo "resolved_ref=refs/pull/${{ inputs.pr }}/head" >> "$GITHUB_OUTPUT"
-            echo "Using PR ${{ inputs.pr }} -> refs/pull/${{ inputs.pr }}/head"
-          else
-            echo "resolved_ref=master" >> "$GITHUB_OUTPUT"
-            echo "No PR specified, using master"
-          fi
+          echo "resolved_ref=refs/pull/${{ inputs.pr }}/head" >> "$GITHUB_OUTPUT"
+          echo "Using PR ${{ inputs.pr }} -> refs/pull/${{ inputs.pr }}/head"
 
       - name: Checkout Airbyte repo
-        if: ${{ inputs.connector_name != '' }}
         uses: actions/checkout@v6
         with:
           repository: airbytehq/airbyte
@@ -145,27 +158,30 @@ jobs:
           GCP_PROD_DB_ACCESS_CREDENTIALS: ${{ secrets.GCP_GSM_CREDENTIALS_FOR_TESTING_TOOL }}
           USE_CONNECTION_SECRET_RETRIEVER: "true"
         run: |
-          ARGS=(--command "${{ inputs.command }}")
+          SKIP_COMPARE="${{ inputs.skip_compare }}"
+          ARGS=(--command "${{ matrix.command }}")
 
-          if [ -n "${{ inputs.target_image }}" ]; then
-            ARGS+=(--target-image "${{ inputs.target_image }}")
-          fi
-
-          if [ -n "${{ inputs.control_image }}" ]; then
-            ARGS+=(--control-image "${{ inputs.control_image }}")
-          fi
-
-          if [ -n "${{ inputs.connector_name }}" ]; then
-            ARGS+=(--connector-name "${{ inputs.connector_name }}")
-            ARGS+=(--repo-root "${{ github.workspace }}/airbyte")
-          fi
+          # Always add connector_name and repo-root (both are required)
+          ARGS+=(--connector-name "${{ inputs.connector_name }}")
+          ARGS+=(--repo-root "${{ github.workspace }}/airbyte")
 
+          # Add connection_id if provided
           if [ -n "${{ inputs.connection_id }}" ]; then
             ARGS+=(--connection-id "${{ inputs.connection_id }}")
           fi
 
-          if [ -n "${{ inputs.state_path }}" ]; then
-            ARGS+=(--state-path "${{ inputs.state_path }}")
+          if [ "$SKIP_COMPARE" = "true" ]; then
+            # Single-version mode: use --skip-compare flag
+            ARGS+=(--skip-compare)
+
+            if [ -n "${{ inputs.override_test_image }}" ]; then
+              ARGS+=(--test-image "${{ inputs.override_test_image }}")
+            fi
+          else
+            # Comparison mode (default): run target vs control
+            if [ -n "${{ inputs.override_control_image }}" ]; then
+              ARGS+=(--control-image "${{ inputs.override_control_image }}")
+            fi
           fi
 
           uv run airbyte-ops cloud connector regression-test "${ARGS[@]}"
@@ -186,6 +202,18 @@ jobs:
 
             const conclusion = '${{ steps.regression-test.outcome }}' === 'success' ? 'success' : 'failure';
 
+            const skipCompare = '${{ inputs.skip_compare }}' === 'true';
+            const connectorName = '${{ inputs.connector_name }}';
+            const prNumber = '${{ inputs.pr }}';
+            let summary;
+            if (skipCompare) {
+              const image = '${{ inputs.override_test_image }}' || `(built from ${connectorName} PR #${prNumber})`;
+              summary = `Single-version regression test: \`${image}\` using \`${{ matrix.command }}\` command.`;
+            } else {
+              const controlImage = '${{ inputs.override_control_image }}' || '(auto-detected)';
+              summary = `Comparison regression test: \`${connectorName}\` (PR #${prNumber}) vs \`${controlImage}\` using \`${{ matrix.command }}\` command.`;
+            }
+
             const check = await github.rest.checks.create({
               owner: context.repo.owner,
               repo: context.repo.repo,
@@ -195,7 +223,7 @@ jobs:
               conclusion: conclusion,
               output: {
                 title: 'Regression Test Report',
-                summary: `Regression test comparing \`${{ inputs.target_image }}\` vs \`${{ inputs.control_image }}\` using \`${{ inputs.command }}\` command.`,
+                summary: summary,
                 text: reportContent
               }
             });
@@ -218,6 +246,6 @@ jobs:
         if: always()
         uses: actions/upload-artifact@v5
         with:
-          name: regression-test-artifacts-${{ github.run_id }}
+          name: regression-test-artifacts-${{ matrix.command }}-${{ github.run_id }}
           path: /tmp/regression_test_artifacts/
           retention-days: 7

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/workflows/lock-command.yml

@@ -20,10 +20,9 @@ jobs:
   run-lock-command:
     runs-on: ubuntu-latest
     steps:
-      - name: Authenticate as GitHub App (if available)
+      - name: Authenticate as GitHub App
         uses: actions/create-github-app-token@v2
         id: get-app-token
-        continue-on-error: true
         with:
           app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
           private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
@@ -33,5 +32,5 @@ jobs:
         with:
           pr: ${{ github.event.inputs.pr }}
           comment-id: ${{ github.event.inputs.comment-id }}
-          github-token: ${{ steps.get-app-token.outputs.token || secrets.GITHUB_TOKEN }}
+          github-token: ${{ steps.get-app-token.outputs.token }}
           command: lock

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/workflows/poe-command.yml

@@ -18,10 +18,9 @@ jobs:
   run-poe-command:
     runs-on: ubuntu-latest
     steps:
-      - name: Authenticate as GitHub App (if available)
+      - name: Authenticate as GitHub App
         uses: actions/create-github-app-token@v2
         id: get-app-token
-        continue-on-error: true
         with:
           app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
           private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
@@ -31,4 +30,4 @@ jobs:
         with:
           pr: ${{ github.event.inputs.pr }}
           comment-id: ${{ github.event.inputs.comment-id }}
-          github-token: ${{ steps.get-app-token.outputs.token || secrets.GITHUB_TOKEN }}
+          github-token: ${{ steps.get-app-token.outputs.token }}

airbyte_internal_ops-0.2.0/.github/workflows/live-tests-ci.yml → airbyte_internal_ops-0.2.2/.github/workflows/regression-tests-ci.yml

@@ -1,6 +1,6 @@
-# CI smoke test for live_tests code changes
-# Runs a lightweight regression test to validate live_tests code works correctly
-name: Live Tests CI
+# CI smoke test for regression tests code changes
+# Runs a lightweight regression test to validate regression tests code works correctly
+name: Regression Tests CI
 
 permissions:
   contents: read
@@ -9,8 +9,9 @@ permissions:
 on:
   pull_request:
     paths:
-      - 'src/airbyte_ops_mcp/live_tests/**'
-      - '.github/workflows/live-tests-ci.yml'
+      - 'src/airbyte_ops_mcp/regression_tests/**'
+      - 'src/airbyte_ops_mcp/mcp/regression_tests.py'
+      - '.github/workflows/regression-tests-ci.yml'
       - '.github/workflows/connector-regression-test.yml'
 
   # Allow manual triggering for testing
@@ -22,7 +23,7 @@ concurrency:
 
 jobs:
   smoke-test:
-    name: Live Tests Smoke Test
+    name: Regression Tests Smoke Test
     uses: ./.github/workflows/connector-regression-test.yml
     with:
       # Use source-pokeapi as a stable, public connector for smoke testing

airbyte_internal_ops-0.2.2/.github/workflows/release-drafter.yml

@@ -0,0 +1,23 @@
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: release-drafter
+  cancel-in-progress: false
+
+jobs:
+  update_release_draft:
+    permissions:
+      contents: write
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: release-drafter/release-drafter@v6.0.0
+        with:
+          config-name: release-drafter.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

airbyte_internal_ops-0.2.2/.github/workflows/semantic-pr-check.yml

@@ -0,0 +1,103 @@
+# Semantic PR Title Validation
+#
+# This workflow validates PR titles follow conventional commit format and applies
+# labels automatically based on the title.
+#
+# Jobs:
+# 1. validate-pr-title - Ensures PR titles follow semantic format (feat:, fix:, etc.)
+# 2. autolabel - Uses Release Drafter's autolabeler to apply labels based on title
+#    (e.g., "feat:" -> enhancement -> minor, "fix:" -> bug -> patch)
+#
+# Note: The autolabeler uses the same release-drafter.yml config but only applies
+# labels when triggered from PR events (it doesn't create/update draft releases).
+
+name: Semantic PR Title Validation
+
+on:
+  pull_request:
+    types: [opened, edited, ready_for_review]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  autolabel:
+    name: Auto-label PR
+    # Apply labels based on PR title using Release Drafter's autolabeler.
+    # Skip if 'edited' event but the title wasn't changed (e.g., only description was edited).
+    # Skipping unnecessary runs reduces unlabel-relabel spam on the PR.
+    # Some notification triggers run upon label additions, so this also prevents notification spam.
+    if: >
+      github.event.action != 'edited'
+      || (
+        github.event.changes.title &&
+        github.event.changes.title.from != ''
+      )
+    runs-on: ubuntu-latest
+    steps:
+      # Remove title-derived labels first to make autolabeler idempotent
+      # (e.g., if PR title changes from "fix:" to "ci:", remove old "bug" label)
+      - name: Remove title-derived labels
+        uses: actions-ecosystem/action-remove-labels@v1
+        with:
+          labels: |
+            bug
+            enhancement
+            chore
+            ci
+            docs
+            testing
+            security
+            dependencies
+            breaking
+
+      # Run release-drafter with disable-releaser to only apply labels (not create releases)
+      - uses: release-drafter/release-drafter@v6
+        with:
+          config-name: release-drafter.yml
+          disable-releaser: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  validate-pr-title:
+    name: Validate PR Title
+    # Skip if 'edited' event but the title wasn't changed (e.g., only description was edited)
+    if: >
+      github.event.action != 'edited'
+      || (
+        github.event.changes.title &&
+        github.event.changes.title.from != ''
+      )
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check semantic PR title
+        uses: amannn/action-semantic-pull-request@v5
+        if: ${{ github.event.pull_request.draft == false }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          # Configure which types are allowed (newline-delimited).
+          # Comparison is case-insensitive, so only lowercase variants are needed.
+          # See: https://github.com/commitizen/conventional-commit-types/blob/master/index.json
+          types: |
+            fix
+            feat
+            docs
+            ci
+            chore
+            build
+            test
+            refactor
+            perf
+            style
+
+      - name: Check for "do not merge" in PR title
+        if: ${{ github.event.pull_request.draft == false }}
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const title = context.payload.pull_request.title.toLowerCase();
+            if (title.includes('do not merge') || title.includes('do-not-merge')) {
+              core.setFailed('PR title contains "do not merge" or "do-not-merge". Please remove this before merging.');
+            }

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/workflows/sentry-apply-command.yml

@@ -30,6 +30,11 @@ env:
   # Note: This is the backend storage location, NOT PULUMI_HOME (which is for CLI config)
   PULUMI_BACKEND_DIR: ${{ github.workspace }}/infra/sentry/.pulumi-state
 
+# Ensure only one Sentry apply runs at a time to prevent state conflicts
+concurrency:
+  group: sentry-prod-deploy
+  cancel-in-progress: false  # Queue instead of cancel to avoid losing deployments
+
 jobs:
   sentry-apply:
     name: Sentry Apply
@@ -68,10 +73,9 @@ jobs:
           fi
         working-directory: .
 
-      - name: Authenticate as GitHub App (if available)
+      - name: Authenticate as GitHub App
         uses: actions/create-github-app-token@v2
         id: get-app-token
-        continue-on-error: true
         with:
           app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
           private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
@@ -103,7 +107,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           ref: ${{ steps.pr-info.outputs.ref || github.ref }}
-          token: ${{ steps.get-app-token.outputs.token || secrets.GITHUB_TOKEN }}
+          token: ${{ steps.get-app-token.outputs.token }}
 
       - name: Append comment with job run link
         if: github.event.inputs.comment-id
@@ -132,7 +136,7 @@ jobs:
 
       - name: Generate Sentry provider SDK
         run: |
-          pulumi package add terraform-provider jianyuan/sentry 0.14.1
+          pulumi package add terraform-provider jianyuan/sentry 0.14.5
 
       - name: Install generated SDK
         run: |
@@ -145,6 +149,9 @@ jobs:
         with:
           name: ${{ env.STATE_ARTIFACT_NAME }}
           path: ${{ env.PULUMI_BACKEND_DIR }}
+          # Download from this workflow's previous successful runs on main
+          workflow: sentry-apply-command.yml
+          branch: main
           workflow_conclusion: success
           search_artifacts: true
           if_no_artifact_found: warn

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/workflows/sentry-preview.yml

@@ -43,7 +43,7 @@ jobs:
 
       - name: Generate Sentry provider SDK
         run: |
-          pulumi package add terraform-provider jianyuan/sentry 0.14.1
+          pulumi package add terraform-provider jianyuan/sentry 0.14.5
 
       - name: Install generated SDK
         run: |
@@ -56,6 +56,9 @@ jobs:
         with:
           name: ${{ env.STATE_ARTIFACT_NAME }}
           path: ${{ env.PULUMI_BACKEND_DIR }}
+          # Must specify the Apply workflow to get state from production deploys
+          workflow: sentry-apply-command.yml
+          branch: main
           workflow_conclusion: success
           search_artifacts: true
           if_no_artifact_found: warn

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/workflows/slash-command-dispatch.yml

@@ -16,10 +16,9 @@ jobs:
     if: ${{ github.event.issue.pull_request }}
     runs-on: ubuntu-latest
     steps:
-      - name: Authenticate as GitHub App (if available)
+      - name: Authenticate as GitHub App
         uses: actions/create-github-app-token@v2
         id: get-app-token
-        continue-on-error: true
         with:
           app-id: ${{ secrets.OCTAVIA_BOT_APP_ID }}
           private-key: ${{ secrets.OCTAVIA_BOT_PRIVATE_KEY }}
@@ -29,7 +28,7 @@ jobs:
         uses: peter-evans/slash-command-dispatch@v5
         with:
           repository: ${{ github.repository }}
-          token: ${{ steps.get-app-token.outputs.token || secrets.GITHUB_TOKEN }}
+          token: ${{ steps.get-app-token.outputs.token }}
           dispatch-type: workflow
           issue-type: pull-request
           commands: |

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/.github/workflows/test-connection-retriever.yml

@@ -59,7 +59,7 @@ jobs:
 
           # Run the test
           uv run python -c "
-          from airbyte_ops_mcp.live_tests.connection_secret_retriever import retrieve_unmasked_config
+          from airbyte_ops_mcp.regression_tests.connection_secret_retriever import retrieve_unmasked_config
           import os
 
           connection_id = os.environ['CONNECTION_ID']

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/CONTRIBUTING.md

@@ -99,11 +99,28 @@ gcloud secrets get-iam-policy projects/587336813068/secrets/CONNECTION_RETRIEVER
 
 When running outside of the VPC (without Tailscale), use the Cloud SQL Auth Proxy:
 
+**Option A: Using the CLI (Recommended)**
+
+Pre-install the CLI tool:
+```bash
+uv tool install airbyte-internal-ops
+airbyte-ops cloud db start-proxy --port=5433
+```
+
+Or use as a single-step command:
+```bash
+uvx --from=airbyte-internal-ops airbyte-ops cloud db start-proxy --port=5433
+```
+
+**Option B: Manual startup**
+
 ```bash
-# Start the proxy (use a non-conflicting port if 5432 is in use)
+# Start the proxy on port 5433 (avoids conflicts with default PostgreSQL port 5432)
 cloud-sql-proxy prod-ab-cloud-proj:us-west3:prod-pgsql-replica --port=5433
+```
 
-# Set environment variables for your application
+Then set environment variables for your application:
+```bash
 export USE_CLOUD_SQL_PROXY=1
 export DB_PORT=5433
 export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json

{airbyte_internal_ops-0.2.0 → airbyte_internal_ops-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-internal-ops
-Version: 0.2.0
+Version: 0.2.2
 Summary: MCP and API interfaces that let the agents do the admin work
 Author-email: Aaron Steers <aj@airbyte.io>
 Keywords: admin,airbyte,api,mcp
@@ -13,7 +13,7 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: <3.13,>=3.11
 Requires-Dist: airbyte-cdk<8.0,>=7.3.9
 Requires-Dist: airbyte-protocol-models-pdv2>=0.13.0
-Requires-Dist: airbyte>=0.34.0
+Requires-Dist: airbyte==0.35.4
 Requires-Dist: asyncer<1.0,>=0.0.4
 Requires-Dist: click<9.0,>=8.1.3
 Requires-Dist: cloud-sql-python-connector[pg8000]<2.0,>=1.7.0
@@ -121,7 +121,23 @@ Some tools (like `list_org_connections_by_source_type_db`) require access to the
    gcloud auth application-default login
    ```
 
-2. Start Cloud SQL Proxy:
+2. Start Cloud SQL Proxy using one of the following methods:
+
+   **Option A: Using the CLI (Recommended)**
+   
+   Pre-install the CLI tool:
+   ```bash
+   uv tool install airbyte-internal-ops
+   airbyte-ops cloud db start-proxy --port=15432
+   ```
+   
+   Or use as a single-step command:
+   ```bash
+   uvx --from=airbyte-internal-ops airbyte-ops cloud db start-proxy --port=15432
+   ```
+
+   **Option B: Manual startup**
+   
    ```bash
    cloud-sql-proxy prod-ab-cloud-proj:us-west3:prod-pgsql-replica --port=15432
    ```