airbyte-internal-ops 0.6.1__py3-none-any.whl → 0.7.1__py3-none-any.whl

{airbyte_internal_ops-0.6.1.dist-info → airbyte_internal_ops-0.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-internal-ops
-Version: 0.6.1
+Version: 0.7.1
 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
@@ -15,6 +15,7 @@ Requires-Dist: airbyte-cdk<8.0,>=7.3.9
 Requires-Dist: airbyte-connector-models<1.0,>=0.1.3
 Requires-Dist: airbyte-protocol-models-pdv2>=0.13.0
 Requires-Dist: airbyte==0.35.4
+Requires-Dist: asyncclick<9.0,>=8.1.7
 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
@@ -28,12 +29,16 @@ Requires-Dist: google-cloud-logging<4.0,>=3.9.0
 Requires-Dist: google-cloud-secret-manager<3.0,>=2.18.0
 Requires-Dist: google-cloud-storage<3.0,>=2.8.0
 Requires-Dist: jinja2<4.0,>=3.1.2
+Requires-Dist: markdown-it-py<3.0,>=2.2.0
 Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydash<8.0,>=6.0.2
 Requires-Dist: python-dotenv<2.0,>=1.0.0
 Requires-Dist: pyyaml<7.0,>=6.0.0
 Requires-Dist: requests<3.0,>=2.31.0
 Requires-Dist: rich<14.0,>=13.0.0
 Requires-Dist: semver<4.0,>=3.0.1
+Requires-Dist: sentry-sdk>=2.50.0
+Requires-Dist: simpleeval<1.0,>=0.9.13
 Requires-Dist: slack-sdk<4.0,>=3.36.0
 Requires-Dist: sqlalchemy<3.0,>=2.0.0
 Requires-Dist: toml<1.0,>=0.10.2

{airbyte_internal_ops-0.6.1.dist-info → airbyte_internal_ops-0.7.1.dist-info}/RECORD

@@ -1,4 +1,5 @@
 airbyte_ops_mcp/__init__.py,sha256=tuzdlMkfnWBnsri5KGHM2M_xuNnzFk2u_aR79mmN7Yg,772
+airbyte_ops_mcp/_sentry.py,sha256=bCgLfIdD6Jf_8bdLkhs0JchtMLXLiK3skPxaRK36fzU,3351
 airbyte_ops_mcp/constants.py,sha256=xU8ARMs7jG0-1hseKn3K1dmhyMOMM3JTetRZugLSKEo,7695
 airbyte_ops_mcp/docker_hub.py,sha256=qdOYpj2KOFOsEGsl2b2rcVPzyYDharOVM_lJxNTytds,5833
 airbyte_ops_mcp/gcp_auth.py,sha256=i0cm1_xX4fj_31iKlfARpNvTaSr85iGTSw9KMf4f4MU,7206
@@ -150,27 +151,6 @@ airbyte_ops_mcp/_legacy/airbyte_ci/connector_pipelines/models/steps.py,sha256=t7
 airbyte_ops_mcp/_legacy/airbyte_ci/connector_pipelines/models/contexts/__init__.py,sha256=4Hw-PX1-VgESLF16cDdvuYCzGJtHntThLF4qIiULWeo,61
 airbyte_ops_mcp/_legacy/airbyte_ci/connector_pipelines/models/contexts/click_pipeline_context.py,sha256=aPwt8XTzt2NOIU2ItAj0mLTZu4lmQwgwut7iOfM6lnI,5458
 airbyte_ops_mcp/_legacy/airbyte_ci/connector_pipelines/models/contexts/pipeline_context.py,sha256=68lfAR5NuLMqUgaHayJKkwXt-vqcucsKWq5L6PA4rqA,15640
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/README.md,sha256=ajuFHew-gZPqGwoX3AAPbGvuysUyQJqTKmzvVEDJRWk,5146
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/cli.py,sha256=-GpHJvlZDBU49XJmepBDqXlkRmf47K4GIpQYG0tVkKk,5152
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/consts.py,sha256=XK0M1dend18Mz1ThxS-tUEiU1zb_4HUcje7BR9Eb6mQ,1161
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/models.py,sha256=VSTLs7CSObwF5_m6Fh1tYZODAMgGxeTuEMIBjRsbpA0,11572
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/utils.py,sha256=MSQFYK87hLXISh2IeDHJTDap23ZOHI_vEB9qoOLbe0I,1514
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/__init__.py,sha256=aN4T6K0hfj-jOroBNu93BD5FKG9XxCjDiL1foZLNQkg,578
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/assets.py,sha256=cQqM1UTNo3VBYjg8b_dgMVJzbqNuE-9fZnhJT2CZsi8,4440
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/metadata.py,sha256=d3ZhQPgyGN-Q4is2M1j0GPio2OUyAy65kBm0KGM5vAQ,11256
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/packaging.py,sha256=ME5MtSIs5NFlpN1eYe_FpOWKanNfe9nRJpFinFw5HHQ,11383
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/security.py,sha256=bd0AX9f7O78RfebYgxDh5LAur-WNrV5vdTGx-MlHqAU,6140
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/version.py,sha256=W-3YC5mQoykpAcqUag0wJsCkv1u8sbGp32wea5QAuZo,5629
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/documentation/__init__.py,sha256=8KFZmApEqToxV9wolNKSbNy8LO6z6J0pDSKDCHExQBQ,1058
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/documentation/documentation.py,sha256=4Vkos46JmMxYSTUMOvDXT2FdYgFhKlPlnRPDlfAhx8o,28187
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/documentation/helpers.py,sha256=89ueBU9uo3f-fOcD3Jd7J8XoO8ymRSZc0vPf9CQ9MCc,6250
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/documentation/models.py,sha256=-X8RpJ3QdLFOTLTwPcBE7arR-Fx6VPfaJE_qn7BdTNg,5533
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/documentation/templates/documentation_headers_check_description.md.j2,sha256=EFcYAhOQvvoc58YO_yqu6DgmSZFe8l0JnOTmG_3g7e4,572
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/documentation/templates/section_content_description.md.j2,sha256=2TXJbvt_S9-PTlJ-MmC3xUanpOvuCY4dUjTYuoocwdc,365
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/checks/documentation/templates/template.md.j2,sha256=bYxLfOP3GDwQC9Q3PiVbxsL5GS0p5b10k1dwzfOrm1M,1962
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-airbyte_ops_mcp/_legacy/airbyte_ci/connector_qa/templates/qa_checks.md.j2,sha256=v3NyYUAYkqRiYAFDQ2NgpgYK6PIDhDKrqfRgpX8454s,1946
 airbyte_ops_mcp/_legacy/airbyte_ci/metadata_service/README.md,sha256=uAAl7KUD4NRgwRhyTAgRSV7NVYMELfGRiGGVmDar8ss,602
 airbyte_ops_mcp/_legacy/airbyte_ci/metadata_service/commands.py,sha256=5nUC1UF6Jt0I9XmnH_ON1c24JlG8Y3lwkc9EATKQ0sA,13338
 airbyte_ops_mcp/_legacy/airbyte_ci/metadata_service/constants.py,sha256=bSXsx-RQjRh5Nlw0-621p28UuaUx4B9PKSe-TF3HEpc,2664
@@ -243,11 +223,11 @@ airbyte_ops_mcp/airbyte_repo/utils.py,sha256=TXlOAfhiu_hVRNjCxB4PRPVDhTWCU5lYmgq
 airbyte_ops_mcp/cli/__init__.py,sha256=XpL7FyVfgabfBF2JR7u7NwJ2krlYqjd_OwLcWf-Xc7s,114
 airbyte_ops_mcp/cli/_base.py,sha256=I8tWnyQf0ks4r3J8N8h-5GZxyn37T-55KsbuHnxYlcg,415
 airbyte_ops_mcp/cli/_shared.py,sha256=jg-xMyGzTCGPqKd8VTfE_3kGPIyO_3Kx5sQbG4rPc0Y,1311
-airbyte_ops_mcp/cli/app.py,sha256=SEdBpqFUG2O8zGV5ifwptxrLGFph_dLr66-MX9d69gQ,789
+airbyte_ops_mcp/cli/app.py,sha256=xxlyJzlFvZuy-qKAhTPPmzj-t0o7MSqQ7aPHonfT1vU,790
 airbyte_ops_mcp/cli/cloud.py,sha256=jac0FcG3UvNNeNNhqZR04uY9BCyVvins1kjO0LRZ86Y,45861
 airbyte_ops_mcp/cli/gh.py,sha256=koJPu0MDB6AW7mJq2z4dZV65ofvsZTkqoeitGF8KJR8,5364
+airbyte_ops_mcp/cli/local.py,sha256=7C6PZ2RHDnOciurrSan5te93LWPjC1Rfwes6y37JL5Q,20756
 airbyte_ops_mcp/cli/registry.py,sha256=L4nDKhlegr31gSE-GUvDFSq10KgDz5kJuZXgLIxYIyg,9785
-airbyte_ops_mcp/cli/repo.py,sha256=G1hoQpH0XYhUH3FFOsia9xabGB0LP9o3XcwBuqvFVo0,16331
 airbyte_ops_mcp/cloud_admin/__init__.py,sha256=cqE96Q10Kp6elhH9DAi6TVsIwSUy3sooDLLrxTaktGk,816
 airbyte_ops_mcp/cloud_admin/api_client.py,sha256=pzdnZpIxOaXJsF_vQuw9_goiDbqwgEQxFwZwsoupY40,57459
 airbyte_ops_mcp/cloud_admin/auth.py,sha256=qE2Aqe0qbZB755KscL65s54Jz78-F-X5a8fXKsrYEOQ,3749
@@ -257,11 +237,34 @@ airbyte_ops_mcp/connection_config_retriever/__init__.py,sha256=Xoi-YvARrNPhECdpw
 airbyte_ops_mcp/connection_config_retriever/audit_logging.py,sha256=QdOG9984NXeMaKeJnFUZ4oCOmqi37PBRG2NRBBjrZQQ,2753
 airbyte_ops_mcp/connection_config_retriever/retrieval.py,sha256=s6yeCyrboWkUd6KdaheEo87x-rLtQNTL8XeR8O9z2HI,12160
 airbyte_ops_mcp/connection_config_retriever/secrets_resolution.py,sha256=12g0lZzhCzAPl4Iv4eMW6d76mvXjIBGspOnNhywzks4,3644
+airbyte_ops_mcp/connector_ops/__init__.py,sha256=5nkBfeHDRKVyqEln8bvPs-J1qDDM6RBvRYPgWNb5dZk,370
+airbyte_ops_mcp/connector_ops/utils.py,sha256=yZsrdj2Jv-6rb97recNncZCkmY79EqpPiZOMUOf8ke4,28573
+airbyte_ops_mcp/connector_qa/README.md,sha256=ajuFHew-gZPqGwoX3AAPbGvuysUyQJqTKmzvVEDJRWk,5146
+airbyte_ops_mcp/connector_qa/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+airbyte_ops_mcp/connector_qa/cli.py,sha256=e9hygxSttegibGzs3g6xEJ1AiXEnOnrIFQQEsNWTY6E,5037
+airbyte_ops_mcp/connector_qa/consts.py,sha256=XK0M1dend18Mz1ThxS-tUEiU1zb_4HUcje7BR9Eb6mQ,1161
+airbyte_ops_mcp/connector_qa/models.py,sha256=PDWeKVzqOa5VLa5iLHE76h7qePL3r-zhf8dmeLuXMUw,11488
+airbyte_ops_mcp/connector_qa/utils.py,sha256=AtegjKBGmYqq9juPedJ4-Jt7LBxcD4ZYNIIS7iLEqiU,1476
+airbyte_ops_mcp/connector_qa/checks/__init__.py,sha256=aN4T6K0hfj-jOroBNu93BD5FKG9XxCjDiL1foZLNQkg,578
+airbyte_ops_mcp/connector_qa/checks/assets.py,sha256=94LgVaHmlDkVL3u6dkHHHUtyXv8xsTk_QjESeUfYYIU,4369
+airbyte_ops_mcp/connector_qa/checks/metadata.py,sha256=ZSIc-odQ8lyuOGVLCVMqqzgaulo47a7exwjOEt-UVDs,11332
+airbyte_ops_mcp/connector_qa/checks/packaging.py,sha256=KyS9vc0FmvLrxZUVwizoWN-D60sMCUmH2nplJ3KGEZI,11456
+airbyte_ops_mcp/connector_qa/checks/security.py,sha256=JEZJAOrAXF6PsLKZQAJ1JDLQpiBPaF_4aLdBO9y5buI,6072
+airbyte_ops_mcp/connector_qa/checks/version.py,sha256=zWLmLLbBooPGmJhHzQ6glOfwc2DPjujkKvAVuZeezOI,9240
+airbyte_ops_mcp/connector_qa/checks/documentation/__init__.py,sha256=CFLhD2C4tlGkYcLRnd6xSzWB1MvQfXXswgp76HcoIjk,1039
+airbyte_ops_mcp/connector_qa/checks/documentation/documentation.py,sha256=cA8f2huCi4Jcut9sOkmwnuEFcoxmwDRWokHKsy6KubY,28236
+airbyte_ops_mcp/connector_qa/checks/documentation/helpers.py,sha256=89ueBU9uo3f-fOcD3Jd7J8XoO8ymRSZc0vPf9CQ9MCc,6250
+airbyte_ops_mcp/connector_qa/checks/documentation/models.py,sha256=c4xH7TsLI0EqkdwwTOYA_RpeU-zxvFRuy9ZNKcd_FjQ,5533
+airbyte_ops_mcp/connector_qa/checks/documentation/templates/documentation_headers_check_description.md.j2,sha256=EFcYAhOQvvoc58YO_yqu6DgmSZFe8l0JnOTmG_3g7e4,572
+airbyte_ops_mcp/connector_qa/checks/documentation/templates/section_content_description.md.j2,sha256=2TXJbvt_S9-PTlJ-MmC3xUanpOvuCY4dUjTYuoocwdc,365
+airbyte_ops_mcp/connector_qa/checks/documentation/templates/template.md.j2,sha256=bYxLfOP3GDwQC9Q3PiVbxsL5GS0p5b10k1dwzfOrm1M,1962
+airbyte_ops_mcp/connector_qa/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+airbyte_ops_mcp/connector_qa/templates/qa_checks.md.j2,sha256=v3NyYUAYkqRiYAFDQ2NgpgYK6PIDhDKrqfRgpX8454s,1946
 airbyte_ops_mcp/gcp_logs/__init__.py,sha256=IqkxclXJnD1U4L2at7aC9GYqPXnuLdYLgmkm3ZiIu6s,409
 airbyte_ops_mcp/gcp_logs/error_lookup.py,sha256=Ufl1FtNQJKP_yWndVT1Xku1mT-gxW_0atmNMCYMXvOo,12757
 airbyte_ops_mcp/mcp/__init__.py,sha256=Y5K-iKUxSY5KM_2XWrYRJqGpjjTHE_ezriED98ZzalU,538
-airbyte_ops_mcp/mcp/_guidance.py,sha256=48tQSnDnxqXtyGJxxgjz0ZiI814o_7Fj7f6R8jpQ7so,2375
-airbyte_ops_mcp/mcp/cloud_connector_versions.py,sha256=ZisoDEZMbgUwf3aarz2L5CaJcON3J5-vXH3v7kmM0IY,34741
+airbyte_ops_mcp/mcp/_guidance.py,sha256=n0dLggQXNi2PKZ0eFDqQx5YIjhQpMnI3xcjouub9AGA,4211
+airbyte_ops_mcp/mcp/cloud_connector_versions.py,sha256=dRKrgsRGadQieTSvBrc5HYI6TTDzVAT6-4tiOHNcDHU,36244
 airbyte_ops_mcp/mcp/connector_analysis.py,sha256=OC4KrOSkMkKPkOisWnSv96BDDE5TQYHq-Jxa2vtjJpo,298
 airbyte_ops_mcp/mcp/connector_qa.py,sha256=aImpqdnqBPDrz10BS0owsV4kuIU2XdalzgbaGZsbOL0,258
 airbyte_ops_mcp/mcp/gcp_logs.py,sha256=QCDQHmsxQHJ26BB0sxkBgKXr7Ja9wVFkdpY6423H-xo,2677
@@ -273,7 +276,7 @@ airbyte_ops_mcp/mcp/prod_db_queries.py,sha256=EdZyrccrM5tHKEtjks4598hzbZ62FuDCCH
 airbyte_ops_mcp/mcp/prompts.py,sha256=v4bguskw7hSsISkseACzKQm5QwrIXmiwbs27oclXTE8,1591
 airbyte_ops_mcp/mcp/registry.py,sha256=PW-VYUj42qx2pQ_apUkVaoUFq7VgB9zEU7-aGrkSCCw,290
 airbyte_ops_mcp/mcp/regression_tests.py,sha256=zwdQ-ymUhWtVcIjwiNIZAC151GKhuxi55HDi4S91RnI,17046
-airbyte_ops_mcp/mcp/server.py,sha256=u9P-cJkAe9KkSj6Kcvkly68toOn1Wt8KCOxLrmav2u0,7061
+airbyte_ops_mcp/mcp/server.py,sha256=ID7wZIds8e-qcGAhsaK0vTJDQQ4YNSdYKTQGQWL3Evw,7280
 airbyte_ops_mcp/prod_db_access/__init__.py,sha256=5pxouMPY1beyWlB0UwPnbaLTKTHqU6X82rbbgKY2vYU,1069
 airbyte_ops_mcp/prod_db_access/db_engine.py,sha256=VUqEWZtharJUR-Cri_pMwtGh1C4Neu4s195mbEXlm-w,9190
 airbyte_ops_mcp/prod_db_access/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -302,7 +305,7 @@ airbyte_ops_mcp/regression_tests/regression/comparators.py,sha256=MJkLZEKHivgrG0
 airbyte_ops_mcp/regression_tests/validation/__init__.py,sha256=MBEwGOoNuqT4_oCahtoK62OKWIjUCfWa7vZTxNj_0Ek,1532
 airbyte_ops_mcp/regression_tests/validation/catalog_validators.py,sha256=jqqVAMOk0mtdPgwu4d0hA0ZEjtsNh5gapvGydRv3_qk,12553
 airbyte_ops_mcp/regression_tests/validation/record_validators.py,sha256=RjauAhKWNwxMBTu0eNS2hMFNQVs5CLbQU51kp6FOVDk,7432
-airbyte_internal_ops-0.6.1.dist-info/METADATA,sha256=BPnWlT4bx1Ayw9-1n7gvikiutGNwsKI34PtI26rhjSw,5777
-airbyte_internal_ops-0.6.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-airbyte_internal_ops-0.6.1.dist-info/entry_points.txt,sha256=WxP0l7bRFss4Cr5uQqVj9mTEKwnRKouNuphXQF0lotA,171
-airbyte_internal_ops-0.6.1.dist-info/RECORD,,
+airbyte_internal_ops-0.7.1.dist-info/METADATA,sha256=t0gLi4mWDcu44KHUYJJ43_6l1fFlkQBnO2V9ywznbNQ,5964
+airbyte_internal_ops-0.7.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+airbyte_internal_ops-0.7.1.dist-info/entry_points.txt,sha256=WxP0l7bRFss4Cr5uQqVj9mTEKwnRKouNuphXQF0lotA,171
+airbyte_internal_ops-0.7.1.dist-info/RECORD,,

airbyte_ops_mcp/_sentry.py

@@ -0,0 +1,101 @@
+# Copyright (c) 2025 Airbyte, Inc., all rights reserved.
+"""Sentry error tracking integration for airbyte-ops-mcp.
+
+This module provides automatic error tracking via Sentry for the airbyte-ops-mcp
+package. Errors during server startup, tool execution, and API interactions are
+automatically captured and reported.
+
+The Sentry DSN is embedded in the package since it only allows write access
+(sending errors), not read access. This is standard practice for client-side
+error tracking.
+
+To disable Sentry tracking, set the environment variable:
+    AIRBYTE_DISABLE_SENTRY=1
+"""
+
+import logging
+import os
+from typing import Literal
+
+import sentry_sdk
+
+# Valid Sentry severity levels
+SentryLevel = Literal["fatal", "error", "warning", "info", "debug"]
+
+logger = logging.getLogger(__name__)
+
+# Environment variable to disable Sentry tracking
+DISABLE_SENTRY_ENV_VAR = "AIRBYTE_DISABLE_SENTRY"
+
+# Sentry DSN for the airbyte-ops-mcp project
+# This DSN only allows sending errors to Sentry, not reading data.
+# It is safe to embed in client-side code per Sentry's documentation.
+# Project: https://airbytehq.sentry.io/projects/internal-ops-app/
+_SENTRY_DSN = "https://292842cbf7f632f34c68cff23f2deee3@o1009025.ingest.us.sentry.io/4510746336559104"
+
+_sentry_initialized = False
+
+
+def _get_package_version() -> str:
+    """Get the package version for Sentry release tracking."""
+    try:
+        from importlib.metadata import version
+
+        return version("airbyte-internal-ops")
+    except Exception as exc:
+        logger.debug("Failed to get package version for Sentry release", exc_info=exc)
+        return "unknown"
+
+
+def init_sentry_tracking() -> bool:
+    """Initialize Sentry error tracking if not already initialized.
+
+    Returns:
+        True if Sentry was initialized successfully, False otherwise.
+    """
+    global _sentry_initialized
+
+    if _sentry_initialized:
+        return True
+
+    if os.getenv(DISABLE_SENTRY_ENV_VAR):
+        logger.debug("Sentry tracking is disabled via environment variable")
+        return False
+
+    try:
+        sentry_sdk.init(
+            dsn=_SENTRY_DSN,
+            release=f"airbyte-ops-mcp@{_get_package_version()}",
+            environment=os.getenv("SENTRY_ENVIRONMENT", "production"),
+            # Only send errors, not performance data
+            traces_sample_rate=0.0,
+            # Attach request data for better debugging
+            send_default_pii=False,
+            # Set server name to help identify the source
+            server_name=os.getenv("HOSTNAME", "unknown"),
+        )
+        _sentry_initialized = True
+        logger.debug("Sentry initialized successfully")
+        return True
+    except Exception as e:
+        logger.warning(f"Failed to initialize Sentry: {e}")
+        return False
+
+
+def capture_exception(exception: BaseException) -> None:
+    """Capture an exception and send it to Sentry.
+
+    This is a convenience wrapper that ensures Sentry is initialized
+    before capturing the exception.
+    """
+    if init_sentry_tracking():
+        sentry_sdk.capture_exception(exception)
+
+
+def capture_message(message: str, level: SentryLevel = "info") -> None:
+    """Capture a message and send it to Sentry.
+
+    This is useful for logging important events that aren't exceptions.
+    """
+    if init_sentry_tracking():
+        sentry_sdk.capture_message(message, level=level)

airbyte_ops_mcp/cli/app.py

@@ -12,8 +12,8 @@ and provides the main() function for the CLI entry point.
 from airbyte_ops_mcp.cli import (
     cloud,  # noqa: F401
     gh,  # noqa: F401
+    local,  # noqa: F401
     registry,  # noqa: F401
-    repo,  # noqa: F401
 )
 from airbyte_ops_mcp.cli._base import app
 

airbyte_ops_mcp/cli/{repo.py → local.py}

@@ -2,9 +2,11 @@
 """CLI commands for local Airbyte monorepo operations.
 
 Commands:
-    airbyte-ops repo connector list - List connectors in the monorepo
-    airbyte-ops repo connector info - Get metadata for a single connector
-    airbyte-ops repo connector bump-version - Bump connector version
+    airbyte-ops local connector list - List connectors in the monorepo
+    airbyte-ops local connector info - Get metadata for a single connector
+    airbyte-ops local connector bump-version - Bump connector version
+    airbyte-ops local connector qa - Run QA checks on a connector
+    airbyte-ops local connector qa-docs-generate - Generate QA checks documentation
 """
 
 from __future__ import annotations
@@ -15,6 +17,7 @@ from typing import Annotated, Literal
 
 import yaml
 from cyclopts import App, Parameter
+from jinja2 import Environment, PackageLoader, select_autoescape
 from rich.console import Console
 
 from airbyte_ops_mcp.airbyte_repo.bump_version import (
@@ -31,6 +34,19 @@ from airbyte_ops_mcp.airbyte_repo.list_connectors import (
 )
 from airbyte_ops_mcp.cli._base import app
 from airbyte_ops_mcp.cli._shared import exit_with_error, print_json
+from airbyte_ops_mcp.connector_ops.utils import Connector
+from airbyte_ops_mcp.connector_qa.checks import ENABLED_CHECKS
+from airbyte_ops_mcp.connector_qa.consts import CONNECTORS_QA_DOC_TEMPLATE_NAME
+from airbyte_ops_mcp.connector_qa.models import (
+    Check,
+    CheckCategory,
+    CheckStatus,
+    Report,
+)
+from airbyte_ops_mcp.connector_qa.utils import (
+    get_all_connectors_in_directory,
+    remove_strict_encrypt_suffix,
+)
 from airbyte_ops_mcp.mcp.github_repo_ops import list_connectors_in_repo
 
 console = Console()
@@ -138,13 +154,13 @@ def _get_connector_info(
     }
 
 
-# Create the repo sub-app
-repo_app = App(name="repo", help="Local Airbyte monorepo operations.")
-app.command(repo_app)
+# Create the local sub-app
+local_app = App(name="local", help="Local Airbyte monorepo operations.")
+app.command(local_app)
 
-# Create the connector sub-app under repo
+# Create the connector sub-app under local
 connector_app = App(name="connector", help="Connector operations in the monorepo.")
-repo_app.command(connector_app)
+local_app.command(connector_app)
 
 
 @connector_app.command(name="list")
@@ -486,3 +502,110 @@ def bump_version(
             "new_version": result.new_version,
         }
     )
+
+
+@connector_app.command(name="qa")
+def run_qa_checks(
+    name: Annotated[
+        list[str] | None,
+        Parameter(
+            help="Connector technical name(s) (e.g., source-github). Can be specified multiple times."
+        ),
+    ] = None,
+    connector_directory: Annotated[
+        str | None,
+        Parameter(
+            help="Directory containing connectors to run checks on all connectors in this directory."
+        ),
+    ] = None,
+    check: Annotated[
+        list[str] | None,
+        Parameter(help="Specific check(s) to run. Can be specified multiple times."),
+    ] = None,
+    report_path: Annotated[
+        str | None,
+        Parameter(help="Path to write the JSON report file."),
+    ] = None,
+) -> None:
+    """Run QA checks on connector(s).
+
+    Validates connector metadata, documentation, packaging, security, and versioning.
+    Exit code is non-zero if any checks fail.
+    """
+    # Determine which checks to run
+    checks_to_run = ENABLED_CHECKS
+    if check:
+        check_names = set(check)
+        checks_to_run = [c for c in ENABLED_CHECKS if type(c).__name__ in check_names]
+        if not checks_to_run:
+            exit_with_error(
+                f"No matching checks found. Available checks: {[type(c).__name__ for c in ENABLED_CHECKS]}"
+            )
+
+    # Collect connectors to check
+    connectors: list[Connector] = []
+    if name:
+        connectors.extend(Connector(remove_strict_encrypt_suffix(n)) for n in name)
+    if connector_directory:
+        connectors.extend(get_all_connectors_in_directory(Path(connector_directory)))
+
+    if not connectors:
+        exit_with_error("No connectors specified. Use --name or --connector-directory.")
+
+    connectors = sorted(connectors, key=lambda c: c.technical_name)
+
+    # Run checks synchronously (simpler than async for CLI)
+    all_results = []
+    for connector in connectors:
+        for qa_check in checks_to_run:
+            result = qa_check.run(connector)
+            status_icon = (
+                "[green]PASS[/green]"
+                if result.status == CheckStatus.PASSED
+                else "[red]FAIL[/red]"
+            )
+            console.print(
+                f"{status_icon} {connector.technical_name}: {result.check.name}"
+            )
+            if result.message:
+                console.print(f"    {result.message}")
+            all_results.append(result)
+
+    # Write report if requested
+    if report_path:
+        Report(check_results=all_results).write(Path(report_path))
+        console.print(f"Report written to {report_path}")
+
+    # Exit with error if any checks failed
+    failed = [r for r in all_results if r.status == CheckStatus.FAILED]
+    if failed:
+        exit_with_error(f"{len(failed)} check(s) failed")
+
+
+@connector_app.command(name="qa-docs-generate")
+def generate_qa_docs(
+    output_file: Annotated[
+        str,
+        Parameter(help="Path to write the generated documentation file."),
+    ],
+) -> None:
+    """Generate documentation for QA checks.
+
+    Creates a markdown file documenting all available QA checks organized by category.
+    """
+    checks_by_category: dict[CheckCategory, list[Check]] = {}
+    for qa_check in ENABLED_CHECKS:
+        checks_by_category.setdefault(qa_check.category, []).append(qa_check)
+
+    jinja_env = Environment(
+        loader=PackageLoader("airbyte_ops_mcp.connector_qa", "templates"),
+        autoescape=select_autoescape(),
+        trim_blocks=False,
+        lstrip_blocks=True,
+    )
+    template = jinja_env.get_template(CONNECTORS_QA_DOC_TEMPLATE_NAME)
+    documentation = template.render(checks_by_category=checks_by_category)
+
+    output_path = Path(output_file)
+    output_path.write_text(documentation)
+    console.print(f"Documentation written to {output_file}")

airbyte_ops_mcp/connector_ops/__init__.py

@@ -0,0 +1,17 @@
+"""Connector operations utilities."""
+
+from airbyte_ops_mcp.connector_ops.utils import (
+    Connector,
+    ConnectorInvalidNameError,
+    ConnectorLanguage,
+    ConnectorLanguageError,
+    ConnectorVersionNotFound,
+)
+
+__all__ = [
+    "Connector",
+    "ConnectorInvalidNameError",
+    "ConnectorLanguage",
+    "ConnectorLanguageError",
+    "ConnectorVersionNotFound",
+]