docs(v2): add nested EQL v2 reference for existing v2.2 deployments#44
Open
coderdan wants to merge 1 commit into
Open
docs(v2): add nested EQL v2 reference for existing v2.2 deployments#44coderdan wants to merge 1 commit into
coderdan wants to merge 1 commit into
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This was referenced Jul 5, 2026
Some customers still run EQL v2.2 (v2.3 is being withdrawn). The new
/reference/eql section documents EQL v3 only, so this adds a durable,
nested EQL v2 reference sourced from the v2.2 docs, surviving the
CIP-3335 deletion of the legacy /stack tree:
content/docs/reference/eql/v2/
index.mdx — EQL v2 overview (from reference/eql-guide.mdx)
indexes.mdx — index recipes, incl. the Supabase query forms
queries.mdx — equality / match / range query patterns
payload.mdx — the CipherCell v2.2 payload (b3, ocf/ocv)
Content is the v2.2 legacy docs, NOT the EQL 2.3 rewrites from #21/#22
(which no longer ship). Two grounded doc-bug fixes are carried in: the
eql-guide's fabricated index-extraction function names are corrected to
the real eql_v2.hmac_256 / bloom_filter / ore_block_u64_8_256 (verified
against the index recipes), and a stale cs_ste_vec_v2 name is aligned to
eql_v2.ste_vec.
Each page carries v2 facets (type: reference, components: [eql],
verifiedAgainst eql 2.2) and a version banner routing new projects to the
v3 reference. Wired into the EQL nav under a "Previous versions" separator.
Supersedes #21 and #22 for the v2 branch.
Claude-Session: https://claude.ai/code/session_01CqDNqLSEEkCi7xAJFq7HJA
7d9938e to
74e6b5f
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stands up a durable EQL v2 reference for customers still running EQL v2.2, in the new IA. Sourced from the shipped v2.2 docs.
Why
The new
/reference/eqlsection onv2documents EQL v3 only. v2.2 customers still need accurate v2 index/query/payload docs that survive the eventual deletion of the legacycontent/stacktree (CIP-3335).Note (changed): EQL 2.3 is being withdrawn, so this section documents v2.2, not 2.3. It is therefore sourced from the original v2.2 legacy pages — not the 2.3 rewrites in #21/#22, which would mis-document v2.2 (2.3 removed
b3/ocf/ocvfrom the payload and changed the index/Supabase query model).What's here —
content/docs/reference/eql/v2/index.mdx— EQL v2 overview (fromreference/eql-guide.mdx)indexes.mdx— index recipes, including the self-hosted vs Supabase query formsqueries.mdx— equality / match / range query patternspayload.mdx— the CipherCell v2.2 payload (b3/ocf/ocv)Nested under the existing EQL reference and wired into its nav under a "Previous versions" separator.
Fixes carried in (grounded, version-safe)
encrypted_get_hmac_256, …) corrected to the realeql_v2.hmac_256/bloom_filter/ore_block_u64_8_256, verified against the v2.2 index recipes; the config/query lists point to the generated per-release EQL API reference rather than asserting unverified names.cs_ste_vec_v2name aligned toeql_v2.ste_vec, consistent with the rest of the v2.2 docs.Facets & adaptation
type: reference,components: [eql],verifiedAgainst: { eql: "2.2" }, plus a version banner routing new projects to the v3 reference./reference/eql/v2/*; links to un-ported pages keep pointing at the still-served legacy/stacktree.Verify before merge (v2.2 accuracy)
config_add_*/encrypted_eqnames (couldn't verify against v2.2); the page points to the generated reference instead. Confirm that's acceptable, or supply the real v2.2 names.eql_v2.ste_vec(metadata) @> $1inferred from the schema-qualified naming; confirm the exact v2.2 containment query.Supersedes #21 and #22 for the v2 branch.
https://claude.ai/code/session_01CqDNqLSEEkCi7xAJFq7HJA