SignalQL specification versions
SignalQL keeps language evolution transparent. Older versions remain viewable as historical references.
Current
- v0.4 — the "Operational Graph": graph pattern operators (
MATCH/CONNECTED/PATH/WITHOUT), reasoning lineage (TRACE), context bundles (CONTEXT FOR), and bitemporalAS OF(reference compiler implements v0.4-core). See v0.4 spec / roadmap. - v0.3 — aggregation, shaping, metrics binding, catalog introspection, and typed result envelope (reference compiler implements v0.3-core).
- v0.2 — generalized evidence and signal retrieval layer (stable baseline; still supported).
Historical
- v0.1 — behavioral analytics-focused baseline (
COUNT,FUNNEL,GROUP BY DAY).
Reference compiler support matrix
| Surface | v0.1 | v0.2 | v0.3-core | v0.3-extended | v0.3-capability |
|---|---|---|---|---|---|
| Parse | yes | yes | yes | yes | parse only |
| Postgres compile | yes | plan SQL | direct SQL (events) | plan SQL | CapabilityError |
| Demo CSV run | yes | — | yes | partial | — |
| Result envelope | — | — | yes | yes | — |
| MCP / CLI | yes | yes | yes | compile + guard | structured error |
v0.3-core (implemented): FROM events retrieve with WHERE, DURING, AS OF, BUCKET BY, GROUP BY, HAVING, ORDER BY, LIMIT, aggregates (count, count_distinct, sum, avg, min, max, variance, stddev, percentile, stats), v0.3 FUNNEL (->), canonical formatter, result envelope helpers.
v0.3-extended (plan SQL or guarded): entity/metric sources, signal() / probability / semantic field refs, TRAVERSE, TREND.
v0.3-capability (parse; compile/run throws CapabilityError): DESCRIBE, WATCH, governed metric(...) execution, catalog providers.
v0.4 (Operational Graph) tiers
| Surface | v0.4-core | v0.4-extended | v0.4-capability |
|---|---|---|---|
| Parse | yes | yes | yes |
| Postgres compile | direct recursive SQL | guarded | CapabilityError |
| Demo graph run | yes | partial | — |
v0.4-core (implemented): MATCH (single-hop edges) + WITHOUT absence, FIND … CONNECTED TO … VIA, PATH, TRACE ordered lineage, CONTEXT FOR bundles, bitemporal AS OF, graph limits/cycle guard, demo graph evaluator.
v0.4-extended (guarded): signal()/probability()/semantic_match() in graph predicates, aggregate returns inside graph queries, multi-hop MATCH edges.
v0.4-capability: streaming/continuous graph subscriptions.
Legacy v0.1 queries remain valid and compile through the compatibility parser path.
Compatibility policy
- New language versions are additive where practical, but may tighten grammar and contracts for determinism.
- Historical versions remain published and linkable for implementation audits.
- Tooling may support multiple versions; each tool must declare which version it executes.
Canonical links
- Current spec: v0.4
- Previous spec: v0.3
- Current scope: v0.2 scope (v0.3 extends v0.2 boundaries; scope update in progress)
- Stable baseline: v0.2
- Roadmap: v0.4 (draft)
- Historical spec: v0.1