diff --git a/.gitignore b/.gitignore index 2248d5ac..bcee4b31 100644 --- a/.gitignore +++ b/.gitignore @@ -19,6 +19,7 @@ demo/*.omni/ /docs/internal # Local-only working files (not for the public repo) +/archived/ .claude/ .worktrees/ /CLAUDE.md diff --git a/og-cheet-sheet.md b/og-cheet-sheet.md deleted file mode 100644 index 2cb4d76e..00000000 --- a/og-cheet-sheet.md +++ /dev/null @@ -1,40 +0,0 @@ -# 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 --target 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