Bump vgi-python to 0.8.4, enrich catalog metadata, wire vgi-lint CI gate

Bump the vgi-python floor to >=0.8.4 (deps, http extra, and the PEP 723
inline deps in anomaly_worker.py) and refresh uv.lock.

Add catalog- and schema-level metadata so vgi-lint reports 0 findings
(100/100): catalog comment, source_url, and the vgi.* provenance tags
(description_llm/description_md/author/copyright/license/support_contact/
support_policy_url), plus per-schema description tags. The scalar functions
already carry catalog-qualified examples.

Add a separate metadata-quality CI job that builds the worker and runs
Query-farm/vgi-lint-check@v1 with fail-on: info.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: rustyconover

.github/workflows/ci.yml

@@ -61,6 +61,27 @@ jobs:
       - name: Docstring lint (pydoclint)
         run: uvx pydoclint --config pyproject.toml vgi_anomaly/ anomaly_worker.py
 
+  metadata-quality:
+    name: Metadata quality (vgi-lint)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+
+      - name: Set up Python 3.13
+        run: uv python install 3.13
+
+      - name: Install the worker (with the http extra)
+        run: uv sync --frozen --python 3.13 --extra http
+
+      - name: vgi-lint
+        uses: Query-farm/vgi-lint-check@v1
+        with:
+          location: "uv run --python 3.13 anomaly_worker.py"
+          fail-on: info
+
   # Resolve the latest published haybarn release once, so the whole matrix tests
   # the same version (and we never hardcode/pin it).
   resolve-haybarn:

anomaly_worker.py

@@ -1,7 +1,7 @@
 # /// script
 # requires-python = ">=3.13"
 # dependencies = [
-#     "vgi-python[http]>=0.8.3",
+#     "vgi-python[http]>=0.8.4",
 #     "stumpy>=1.12",
 #     "ruptures>=1.1.9",
 #     "numpy",
@@ -50,13 +50,58 @@
 from vgi_anomaly import detectors
 from vgi_anomaly.scalars import SCALAR_FUNCTIONS
 
+_CATALOG_DESCRIPTION_LLM = (
+    "Time-series anomaly detection over a numeric series passed as a single DOUBLE[] argument "
+    "(build it in SQL with array_agg(value ORDER BY t)). Find the most anomalous subsequence "
+    "(discord) and the most repeated pattern (motif) with the matrix profile, compute the full "
+    "matrix profile, detect change points (regime shifts) with ruptures PELT/Dynp, and flag "
+    "individual outliers beyond a z-score threshold. Use for outlier detection, motif/discord "
+    "discovery, regime-change detection, and series quality checks in SQL."
+)
+
+_CATALOG_DESCRIPTION_MD = (
+    "# anomaly\n\n"
+    "Time-series anomaly detection for DuckDB/SQL, backed by `stumpy` (matrix profile), "
+    "`ruptures` (change points) and `numpy` (z-score).\n\n"
+    "Each function takes a whole numeric series as a single `DOUBLE[]` argument "
+    "(`array_agg(value ORDER BY t)`).\n\n"
+    "Scalars: `matrix_profile`, `discord_index`, `motif_index`, `change_points`, "
+    "`zscore_anomalies`."
+)
+
+_SCHEMA_DESCRIPTION_LLM = (
+    "Anomaly-detection scalar functions operating on a whole numeric series (DOUBLE[]): "
+    "matrix profile, top discord (anomaly) index, top motif index, change-point detection, "
+    "and z-score outlier indices."
+)
+
+_SCHEMA_DESCRIPTION_MD = (
+    "Time-series anomaly-detection scalar functions: matrix profile, discords, motifs, "
+    "change points, and z-score outliers."
+)
+
 _ANOMALY_CATALOG = Catalog(
     name="anomaly",
     default_schema="main",
+    comment="Time-series anomaly detection: matrix profile, change points, z-score for SQL.",
+    source_url="https://github.com/Query-farm/vgi-anomaly",
+    tags={
+        "vgi.description_llm": _CATALOG_DESCRIPTION_LLM,
+        "vgi.description_md": _CATALOG_DESCRIPTION_MD,
+        "vgi.author": "Query.Farm",
+        "vgi.copyright": "Copyright 2026 Query Farm LLC - https://query.farm",
+        "vgi.license": "MIT",
+        "vgi.support_contact": "https://github.com/Query-farm/vgi-anomaly/issues",
+        "vgi.support_policy_url": "https://github.com/Query-farm/vgi-anomaly/blob/main/README.md",
+    },
     schemas=[
         Schema(
             name="main",
             comment="Time-series anomaly detection: matrix profile, change points, z-score for SQL",
+            tags={
+                "vgi.description_llm": _SCHEMA_DESCRIPTION_LLM,
+                "vgi.description_md": _SCHEMA_DESCRIPTION_MD,
+            },
             functions=list(SCALAR_FUNCTIONS),
         ),
     ],

pyproject.toml

@@ -30,7 +30,7 @@ classifiers = [
 ]
 requires-python = ">=3.13"
 dependencies = [
-    "vgi-python>=0.8.3",
+    "vgi-python>=0.8.4",
     "stumpy>=1.12",
     "ruptures>=1.1.9",
     "numpy",
@@ -42,7 +42,7 @@ dependencies = [
 # in addition to stdio. That path needs vgi-python's `http` extra (waitress).
 # CI's http transport leg installs this via `uv sync --extra http`.
 http = [
-    "vgi-python[http]>=0.8.3",
+    "vgi-python[http]>=0.8.4",
 ]
 dev = [
     "pytest>=8",