query-farm/VGI Lint Check
Run vgi-lint-check, the metadata-quality linter, against a VGI worker and gate on a quality level. Language-agnostic: point it at any subprocess command, binary path, or no-auth HTTP URL.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| location | Worker location to lint: a subprocess command / binary path (e.g. "$PWD/target/release/units-worker" or "uv run worker.py") or a no-auth HTTP URL (e.g. "http://localhost:9009"). The worker must already be built/available; this action does not build it. | yes | — |
| fail-on | Minimum finding severity that fails the run: info | warning | error | never. | no | error |
| version | vgi-lint-check version to run. A bare version pins exactly ("0.26.0"); a requirement operator is honored verbatim (">=0.26.0,<0.27"). The default floors at 0.26.0, which FORCE-installs the signed vgi community extension itself (so a cached/stale copy on the runner is refreshed). | no | >=0.26.0 |
| working-directory | Directory to run in — used for config ([tool.vgi-lint-check] / vgi-lint.toml) and baseline discovery. | no | . |
| data-version | Lint a specific worker data version (passes --data-version). Ignored when all-data-versions is true. | no | "" |
| all-data-versions | Lint every published data version (passes --all-data-versions). | no | false |
| baseline | Baseline file prefix (passes --baseline). With a baseline set, only NEW findings count toward fail-on. | no | "" |
| execute | Run the VGI9xx execution rules against the worker. On by default; set 'false' for a static-only lint (passes --no-execute). | no | true |
| spatial | Load the DuckDB spatial extension (best-effort). On by default; set 'false' to skip (passes --no-spatial). | no | true |
| format | Output format: terminal | json | agent | jsonl. Use agent/json for machine-readable findings. | no | terminal |
| config | Explicit config file (passes --config). Empty uses normal discovery. | no | "" |
| attach-options | Extra ATTACH options for workers that require options/credentials to attach, one KEY=VALUE per line (passes a --attach-option per line). A worker that resolves credentials lazily attaches fine with a placeholder secret for a static lint, e.g.: provider=imap secret=lint | no | "" |
| setup-sql | SQL statements to run on the connection before ATTACH, one per line (passes a --setup-sql per line) — e.g. a CREATE SECRET needed by --execute rules. | no | "" |
| args | Extra raw arguments appended to the vgi-lint invocation (word-split). | no | "" |
| uv-version | uv version to install via astral-sh/setup-uv. | no | 0.11.7 |
| summary | Append the lint output to the GitHub Actions job summary. | no | true |
Outputs
| name | description |
|---|---|
| exit-code | The vgi-lint exit code: 0 clean / below fail-on · 1 config error · 2 findings >= fail-on · 3 connection error. |