HQL To Helix DSL Queries

Translate legacy HelixQL (HQL) — the deprecated .hx text language (QUERY Foo(...) => ... RETURN ...) — into the Rust DSL or TypeScript DSL that replace it in HelixDB v2. Both DSLs serialize to the same JSON query AST, so a Rust query and a TypeScript query that emit identical JSON are semantically identical — that is the lever you use to confirm a migration is faithful.

Some HQL features have no equivalent in either DSL (upsert, reranking, shortest-path, inline embedding, advanced math, relationship-existence filters, schema defaults, macros). For those, flag the gap and move the logic into application code — never invent a fake DSL shape.

When To Use

Use this skill when the task is to:

• translate an HQL query or a .hx file into the Rust DSL or the TypeScript DSL
• port a HelixQL route into the v2 code-native DSL
• decide how an HQL construct (traversal, filter, projection, search, write) maps to a DSL builder
• identify which parts of an HQL query cannot be expressed in the DSL and must move to app code