[arv]

Adds a JSON Filters section to the ZQL page, under Where. It covers:

• Using json(column, ...path) inside a cmp() callback.
• Path segments: a string reads an object key, a number reads an array index, and the two never cross over.
• Path completion and value types for columns with a custom JSON type.
• Type-strict comparisons, with a short table of examples.
• Single-type IN / NOT IN lists.
• Missing keys and JSON null, both found with IS / IS NOT.

Timing: this documents a feature that hasn't shipped yet. It should merge together with the Zero release that includes JSON path filters.

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
zero-docs	Ready	Preview	Oct 20, 2026 3:48pm UTC

[arv]

Verify Signed Commit Authors fails because the PR's one commit (91e5f2a65) is signed with the authoring session's SSH key, which isn't on the allowed list. The fix is for the author to re-sign that commit with their own key and force-push. There is nothing to fix in the content.

---

Generated by Claude Code

[Copilot]

🟡 Changes recommended

Moderate documentation inconsistencies and a stale search index must be addressed before approval.

3 open issues

• Regenerate search index for updated ZQL documentation · New
• Clarify comparison rule for null values · New
• Clarify supported types and null comparisons · New

What changed in this PR

Documents upcoming JSON path filtering support in ZQL.

Changes:

• Adds JSON path syntax and traversal semantics.
• Documents typed comparisons, IN/NOT IN, and missing/null behavior.
• Adds examples under the Where section.

File	Summary
contents/​docs/​zql.mdx	Adds the JSON Filters section. Requires search-index regeneration, clarification of null/type comparison rules, and correction of top-level examples.

_{Review effort: Lite}