release: GeoBrix 0.5.0 — virtual tiles, v2 tile struct, CRS families

.claude/qc-judge/config.json

@@ -1,5 +1,5 @@
 {
-  "release_notes_path": "docs/docs/beta-release-notes.mdx",
+  "release_notes_path": "docs/docs/release-notes.mdx",
   "internals_extra_patterns": [
     "wave\\s*\\d+",
     "@databricks\\.com",
@@ -30,6 +30,24 @@
       "expect_exit": 0,
       "timeout_seconds": 30
     },
+    "param-name-parity": {
+      "name": "Parameter name consistency and arity parity across tiers",
+      "type": "command",
+      "severity": "warn",
+      "enabled": true,
+      "cmd": "[ -f docs/scripts/check-param-names.py ] || { echo 'param-names script absent; skip'; exit 0; }; python3 docs/scripts/check-param-names.py",
+      "expect_exit": 0,
+      "timeout_seconds": 30
+    },
+    "docs-examples": {
+      "name": "Docs example output tables well-formed + all declared tabs complete",
+      "type": "command",
+      "severity": "warn",
+      "enabled": true,
+      "cmd": "[ -f docs/scripts/check-docs-examples.py ] || { echo 'absent; skip'; exit 0; }; python3 docs/scripts/check-docs-examples.py",
+      "expect_exit": 0,
+      "timeout_seconds": 30
+    },
     "doc-coverage": {
       "name": "Every registered function documented + no placeholder example outputs",
       "type": "command",

.github/actions/pyrx_build/action.yml

@@ -40,10 +40,10 @@ runs:
         # Hash-pinned supply chain (matches requirements-ci.txt / dev-container
         # discipline; see docs/docs/security.mdx): every wheel is sha256-verified,
         # so a compromised mirror serving same-version-different-bytes fails closed.
-        # Regenerate via: uv pip compile --generate-hashes python/geobrix/requirements-pyrx-ci.in
+        # Regenerate via: uv pip compile --generate-hashes python/geobrix/requirements-light-ci.in
         # No GDAL exception here — rasterio's bundled-GDAL binary wheel is pinned
         # in the lock too (the lightweight API installs no native GDAL, no JAR).
-        pip install --require-hashes -r python/geobrix/requirements-pyrx-ci.txt
+        pip install --require-hashes -r python/geobrix/requirements-light-ci.txt
         # Install the in-repo package itself with --no-deps; every dependency is
         # already in the hash-pinned closure above.
         pip install --no-deps python/geobrix
@@ -68,4 +68,4 @@ runs:
         # bench (bench-harness spec/compare/fingerprint/runner unit tests -- guards
         # the light bench FnSpec registry + cross-tier count invariants).
         # See test/conftest.py for the maintained condition.
-        pytest test/pyrx test/ds test/pyvx test/pygx test/pmtiles_light test/stac test/earthdata test/vizx test/sample test/bench -m "not integration" -v
+        pytest test/pyrx test/ds test/pyvx test/pygx test/pmtiles_light test/stac test/earthdata test/vizx test/sample test/bench test/core -m "not integration" -v

.github/actions/python_build/action.yml

@@ -6,7 +6,7 @@ inputs:
     description: 'Run Python lint (isort, black, flake8) and fail build on errors? true or false. Typically true only for PRs targeting main.'
     default: 'false'
   enable_coverage:
-    description: 'Run pytest with coverage (--cov) and emit coverage.xml for Codecov? true or false.'
+    description: 'Run pytest with coverage (--cov) and emit coverage.xml? true or false.'
     default: 'false'
 runs:
   using: "composite"
@@ -117,14 +117,14 @@ runs:
         # Heavyweight must not test lightweight. The lightweight tiers (pyrx, pyvx,
         # pygx, ds, pmtiles_light, stac, earthdata, vizx, sample) need
         # rasterio/shapely/pandas/pyarrow etc. that are NOT in requirements-ci.txt;
-        # they run in their own 'pyrx' CI job against requirements-pyrx-ci.txt.
+        # they run in their own 'pyrx' CI job against requirements-light-ci.txt.
         # test/conftest.py collect_ignore already skips these when rasterio is
         # absent, but we ALSO pass --ignore explicitly so a light dir can never run
         # in the heavy phase even if the env drifts (gains rasterio) or a caller
         # invokes a light dir directly. This list MUST stay in sync with
         # _LIGHT_TEST_DIRS in test/conftest.py.
         # pytest-cov is already locked in requirements-ci.txt; no extra install needed.
-        LIGHT_IGNORES="--ignore=test/pyrx --ignore=test/pyvx --ignore=test/pygx --ignore=test/ds --ignore=test/pmtiles_light --ignore=test/stac --ignore=test/earthdata --ignore=test/vizx --ignore=test/sample --ignore=test/bench"
+        LIGHT_IGNORES="--ignore=test/pyrx --ignore=test/pyvx --ignore=test/pygx --ignore=test/ds --ignore=test/pmtiles_light --ignore=test/stac --ignore=test/earthdata --ignore=test/vizx --ignore=test/sample --ignore=test/bench --ignore=test/core"
         if [ "${{ inputs.enable_coverage }}" = "true" ]; then
           pytest -m "not integration" $LIGHT_IGNORES --cov=src --cov-report=xml --cov-report=term --cov-config=pyproject.toml -q
         else

.github/docs/ci-runner-and-cache.md

@@ -20,7 +20,7 @@ runs-on:
 
 Currently used by: `build_main` build, `build_python` build, `build_scala`
 build, `build_scala_by_package` test-package, `codecov-scala-parallel`
-coverage-package, `codecov-upload` coverage, `codeql-analysis` analyze.
+coverage-package, `codeql-analysis` analyze.
 
 ### Light jobs — `databrickslabs-protected-runner-group` / `linux-ubuntu-latest`
 
@@ -33,7 +33,7 @@ runs-on:
   labels: linux-ubuntu-latest
 ```
 
-Currently used by: `build_main` update-doc-inventory + codecov,
+Currently used by: `build_main` update-doc-inventory,
 `codecov-scala-parallel` merge-and-upload, `verify-maven-pgp` verify,
 `deploy-docs` build + deploy.
 

.github/workflows/build_main.yml

@@ -112,7 +112,7 @@ jobs:
       - name: build scala
         uses: ./.github/actions/scala_build
         with:
-          # Disable scoverage in main build to keep CI ~10–15 min (full Scala coverage is ~30+ min). Run "Upload coverage to Codecov" workflow manually for Scala+Python coverage.
+          # Disable scoverage in main build to keep CI ~10–15 min (full Scala coverage is ~30+ min). Run coverage locally via the gbx:coverage:* commands.
           enable_coverage: "false"
           fail_on_scalastyle: ${{ github.event_name == 'pull_request' && github.base_ref == 'main' }}
       - name: build python
@@ -130,44 +130,6 @@ jobs:
         run: |
           mkdir -p "$GBX_SAMPLE_DATA_ROOT"
           sudo -E mvn -C -q test -Dsuites='tests.docs.scala.*,docs.tests.scala.*' -DfailIfNoTests=false -Dscoverage.skip
-      - name: Stage coverage for upload job
-        run: |
-          mkdir -p coverage-reports
-          cp -f target/scoverage.xml coverage-reports/ 2>/dev/null || true
-          cp -f target/scoverage-report/scoverage.xml coverage-reports/scoverage-report.xml 2>/dev/null || true
-          cp -f python/geobrix/coverage.xml coverage-reports/ 2>/dev/null || true
-          if [ -z "$(ls -A coverage-reports 2>/dev/null)" ]; then
-            echo "No coverage files found. Expected Scala: target/scoverage.xml or target/scoverage-report/scoverage.xml; Python: python/geobrix/coverage.xml"
-            exit 1
-          fi
-          ls -la coverage-reports/
-      - name: Upload coverage artifacts
-        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f  # v7.0.0
-        with:
-          name: coverage-reports
-          path: coverage-reports
-          if-no-files-found: warn
       - name: upload artifacts
         uses: ./.github/actions/upload_artifacts
 
-  codecov:
-    name: Upload to Codecov
-    runs-on:
-      group: databrickslabs-protected-runner-group
-      labels: linux-ubuntu-latest
-    needs: build
-    if: always() && needs.build.result == 'success'
-    permissions:
-      contents: read
-    steps:
-      - name: Download coverage artifacts
-        uses: actions/download-artifact@70fc10c6e5e1ce46ad2ea6f2b72d43f7d47b13c3  # v8.0.0
-        with:
-          name: coverage-reports
-          path: coverage-reports
-      - name: Upload to Codecov
-        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de  # v5.5.2
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          directory: coverage-reports
-          fail_ci_if_error: false

.github/workflows/build_scala.yml

@@ -45,9 +45,3 @@ jobs:
           enable_coverage: "true"
       - name: upload artifacts
         uses: ./.github/actions/upload_artifacts
-      - name: Publish test coverage to Codecov
-        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de  # v5.5.2
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          files: target/scoverage.xml,target/scoverage-report/scoverage.xml
-          fail_ci_if_error: false

.github/workflows/codecov-scala-parallel.yml

@@ -1,8 +1,8 @@
-# Optional: Run Scala coverage by package in parallel, merge, then upload to Codecov.
+# Optional: Run Scala coverage by package in parallel and merge into one report.
 # Faster wall-clock time than a single job running all tests (~10–15 min vs ~30–45 min).
 # Trigger: workflow_dispatch only (or add schedule/on push if desired).
+# The merged scoverage.xml is published as a workflow artifact (scoverage-merged).
 #
-# Requires: CODECOV_TOKEN secret.
 # Merge script: scripts/ci/merge_scoverage.py
 # Design: .github/docs/scala-coverage-parallel-design.md
 
@@ -108,9 +108,9 @@ jobs:
             echo "=============================================================================="
           fi
 
-      - name: Upload to Codecov
-        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de  # v5.5.2
+      - name: Upload merged coverage artifact
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f  # v7.0.0
         with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          files: merged/scoverage.xml
-          fail_ci_if_error: false
+          name: scoverage-merged
+          path: merged/scoverage.xml
+          if-no-files-found: warn

.gitignore

@@ -53,3 +53,17 @@ test-logs/bench/
 # Lakeflow DAB local override files (real per-workspace values; template committed as *.override.yml.example)
 *.override.yml
 .databricks/
+
+# Agent/session scratch + local tooling (never committed). All internal planning
+# (specs, plans, prompts, input, SDD ledgers) is consolidated under /.superpowers/;
+# the public representation of decisions lives in docs/docs/. The legacy root
+# locations (/prompts/, /input/, /docs/superpowers/) stay ignored as guards.
+/.superpowers/
+/docs/superpowers/
+/.isaac/
+/.tmp
+/scratchpad/
+# pytest cache (appears in repo root and under docs/, python/, notebooks/, etc.)
+.pytest_cache/
+# Locally-built docs bundle (only the LFS platform tarball in resources/static/ is committed)
+/resources/static/geobrix-docs-*.zip

CHANGELOG.md

@@ -1,10 +1,10 @@
 ## v0.2.0
 
-Version bump with notable fixes and improvements. See [Beta Release Notes](docs/docs/beta-release-notes.mdx) for API and naming changes.
+Version bump with notable fixes and improvements. See [Release Notes](docs/docs/release-notes.mdx) for API and naming changes.
 
 ### Notable changes
 - BNG aggregators (`bng_cellunion_agg`, `bng_cellintersection_agg`): fixed shared aggregation buffer bug (fresh buffer per partition); chip field resolution by type/name in union agg.
-- Reader renames and other API changes documented in Beta Release Notes.
+- Reader renames and other API changes documented in Release Notes.
 
 ---