refactor: make xorq an optional (extra) dependency

.github/workflows/ci-release.yml

@@ -19,9 +19,43 @@ concurrency:
   cancel-in-progress: ${{ github.event_name != 'release' }}
 
 jobs:
-  # Run tests, examples, and build docs
+  # Run the test suite with and without the xorq extra. The no-xorq leg
+  # verifies xorq is truly optional (its tests skip, not error).
   test:
-    name: Test & Build
+    name: Test (${{ matrix.name }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: full
+            sync: uv sync --all-extras
+          - name: no-xorq
+            sync: uv sync --all-extras --no-extra xorq --no-extra examples
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Install dependencies (${{ matrix.name }})
+        run: ${{ matrix.sync }}
+
+      - name: Verify import works
+        run: uv run python -c "import boring_semantic_layer; print('import OK')"
+
+      - name: Run tests
+        run: uv run pytest
+
+  # Build examples, docs, and skills (require the full env incl. Node).
+  build:
+    name: Build (examples + docs + skills)
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -47,8 +81,14 @@ jobs:
           uv sync --all-extras
           cd docs/web && npm ci
 
-      - name: Run all checks (tests + examples + docs build)
-        run: make check
+      - name: Run examples
+        run: make examples
+
+      - name: Build docs
+        run: make docs-build
+
+      - name: Check skills are up to date
+        run: make skills-check
 
       - name: Upload docs artifact
         if: github.event_name == 'release'
@@ -60,7 +100,7 @@ jobs:
   deploy-docs:
     name: Deploy Docs
     if: github.event_name == 'release'
-    needs: test
+    needs: [test, build]
     runs-on: ubuntu-latest
     environment:
       name: github-pages
@@ -74,7 +114,7 @@ jobs:
   release-pypi:
     name: Release to PyPI
     if: github.event_name == 'release'
-    needs: test
+    needs: [test, build]
     runs-on: ubuntu-latest
     environment:
       name: release

pyproject.toml

@@ -11,7 +11,6 @@ dependencies = [
     "pyyaml>=6.0",
     "returns>=0.26.0",
     "toolz>=1.0.0",
-    "xorq>=0.3.25",
 ]
 urls = { Homepage = "https://github.com/boringdata/boring-semantic-layer/tree/main" }
 license = "MIT"
@@ -26,7 +25,8 @@ bsl = "boring_semantic_layer.agents.cli:main"
 bsl = "boring_semantic_layer.serialization.tag_handler:bsl_tag_handler"
 
 [project.optional-dependencies]
-examples = ["xorq[duckdb]>=0.3.4", "xorq", "duckdb<1.4"]
+xorq = ["xorq>=0.3.25"]
+examples = ["xorq[duckdb]>=0.3.25", "duckdb<1.4"]
 
 # Visualization backends
 viz-altair = ["altair>=5.0.0", "vl-convert-python>=1.0.0"]
@@ -51,11 +51,22 @@ server = [
     "uvicorn[standard]>=0.30.0",
 ]
 
+# Baseline test environment for the no-xorq CI leg: pulled in via
+# `uv sync --all-extras` so the suite has a duckdb backend (and pyarrow)
+# without depending on xorq or the examples extra.
+test-core = [
+    "ibis-framework[duckdb]>=11.0.0",
+    "pytest",
+    "pandas>=2.3.0",
+    "pytest-asyncio",
+]
+
 dev = [
-    "boring-semantic-layer[agent,mcp,server,examples,viz-altair,viz-plotly,viz-plotext]",
+    # LLM provider clients needed to test agent backends (not user-facing extras)
     "openai>=1.0.0",
     "langchain-openai>=0.3.0",
     "langchain-anthropic>=0.3.0",
+    # Developer tooling
     "ruff>=0.6.7",
     "pre-commit>=4.2.0",
     "pytest",