mirror of
https://github.com/ModernRelay/omnigraph.git
synced 2026-06-15 01:55:13 +02:00
c2db7b5002
L6 renamed the flag but left stragglers. Two were functional: the `resolve_target_uri` "URI must be provided …" error still named `--target`, and `docker/entrypoint.sh` passed `--target` to omnigraph-server (which now only accepts `--graph`) — so the container failed to boot. Both fixed (plus the entrypoint smoke test's expected args). The rest are code comments across the config/server/cli crates and tests, and the cheat sheet, swept `--target` → `--graph`. `--target-branch` (policy explain) is a distinct flag and untouched; past release notes keep `--target` (accurate for those versions).
40 lines
1.1 KiB
Markdown
40 lines
1.1 KiB
Markdown
# Omnigraph Cheat Sheet
|
|
|
|
## Local Query Validation
|
|
|
|
Use an explicit schema file:
|
|
|
|
```bash
|
|
omnigraph lint --query ./queries.gq --schema ./schema.pg --json
|
|
omnigraph check --query ./queries.gq --schema ./schema.pg
|
|
```
|
|
|
|
Use a local or `s3://` repo target:
|
|
|
|
```bash
|
|
omnigraph lint --query ./queries.gq ./repo.omni --json
|
|
omnigraph check --query ./queries.gq s3://bucket/repo
|
|
```
|
|
|
|
Use `omnigraph.yaml` target resolution:
|
|
|
|
```bash
|
|
omnigraph lint --query ./queries.gq --graph local --config ./omnigraph.yaml
|
|
```
|
|
|
|
> The previous `omnigraph query lint` / `omnigraph query check` spellings
|
|
> are kept as deprecated argv shims that print a one-line warning to
|
|
> stderr and rewrite to the canonical `omnigraph lint` / `omnigraph check`.
|
|
|
|
## What It Checks
|
|
|
|
- parses every query in the file
|
|
- typechecks each query against the resolved schema
|
|
- warns on hardcoded mutation queries with no params
|
|
- warns when nullable node fields have no update-query coverage
|
|
|
|
## Current Limits
|
|
|
|
- repo-backed lint is local/S3-only in v1
|
|
- HTTP targets need `--schema`
|
|
- exit code is nonzero only when there are strict validation errors
|