[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 29, 2026 10:41am 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}

[Copilot]

🟡 Changes recommended

An active documentation inconsistency remains in contents/docs/zql.mdx regarding how invalid JSON path steps resolve and whether they can match null.

1 open issue

• Clarify invalid path steps resolve as missing values · New

3 resolved since last review

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

_{Review effort: Lite}