Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
2c3c7a5
feat(compiler): parse and type-check GQ edition 3 behind the gq 3 line
ragnorc Nov 9, 2026
81d69a1
test(gqt): walk the edition-2 corpus from the crate that owns it
ragnorc Nov 9, 2026
b4ab156
Merge origin/main into gq3/phase-0-front-end
ragnorc Nov 9, 2026
75cb05f
release(notes): select new notes for v0.15.1 now v0.15.0 is tagged
ragnorc Nov 9, 2026
ec18d6f
refactor: retire engine v1 and keep the edition-3 preview's pull requ…
ragnorc Nov 9, 2026
562a3bc
Merge origin/main into gq3/phase-0-front-end
ragnorc Nov 9, 2026
f6946f5
chore: drop the GQT runner's unused imports and the catalog cfg left …
ragnorc Nov 10, 2026
f7ec10b
refactor(compiler): name the query front end's modules by role
ragnorc Nov 10, 2026
dc95d4a
test(compiler): check section 3's recursive example as the RFC writes it
ragnorc Nov 10, 2026
64e727b
Merge remote-tracking branch 'origin/main' into gq3/phase-0-front-end
ragnorc Nov 10, 2026
3ce87e2
refactor(compiler): move the bound expression to ir/expr.rs and give …
ragnorc Nov 10, 2026
a14fe7b
refactor(compiler): hold the core IR's scalars as the bound expression
ragnorc Nov 10, 2026
6d40bc4
feat(compiler,planner,engine)!: replace the query language in one break
ragnorc Nov 10, 2026
ae9c2a4
test(gqt): name the old delete form's refusal by text the served door…
ragnorc Nov 10, 2026
2fd8760
test(reference,gqt): compare query rows with a reference interpreter …
ragnorc Nov 10, 2026
863cdc9
docs(gqt): say where the reference interpreter follows the engine ove…
ragnorc Nov 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 0 additions & 1 deletion .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,6 @@
/crates/omnigraph-gqt/ @azimafroozeh
/crates/omnigraph-planner/ @azimafroozeh @aaltshuler
/crates/omnigraph-policy/ @aaltshuler
/crates/omnigraph-reference-engine/ @azimafroozeh @aaltshuler
/crates/omnigraph-seams/ @azimafroozeh @aaltshuler
/crates/omnigraph-server/ @aaltshuler
/crates/omnigraph-storage/ @azimafroozeh @aaltshuler
Expand Down
16 changes: 7 additions & 9 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,8 @@ Tools that support `@` imports include these automatically:
skill in the CLI and MCP), `omnigraph-mcp` (MCP protocol and catalog), server,
Azure admission wrapper, benchmark harness,
`omnigraph-gqt` (the `.gqt` logic-test corpus and its runner; one libtest
test per case), and `omnigraph-dst` (deterministic simulation testing; needs
test per case), `omnigraph-reference` (the core IR's reference
interpreter, which GQT compares query rows against), and `omnigraph-dst` (deterministic simulation testing; needs
`--cfg tokio_unstable`, set by the workspace `.cargo/config.toml` for every
build — the workspace test gate excludes the crate by name)
- License: MIT
Expand All @@ -59,7 +60,7 @@ HTTP server.
CLI / HTTP server
|
v
compiler: parse, typecheck, IR, lowering
compiler: parse, type check to the core IR
|
v
engine: snapshots, execution, graph publication, recovery
Expand Down Expand Up @@ -211,13 +212,10 @@ Set `OMNIGRAPH_UPDATE_OPENAPI=1` only when the drift is intentional.
`.github/workflows/tests-slow-nightly.yml`, the nightly job that runs them
with `--run-ignored only` and refuses a run in which an enrolled name did
not pass.
- Engine v1 is frozen: every file under
`crates/omnigraph-reference-engine/src/` is pinned by
`crates/omnigraph-reference-engine/tests/frozen.rs`. v1 is reachable only
through GQT's `--- expect same as v1`, which compares a query step's v2
rows with v1's. A defect seen on v1 is fixed on v2
(`crates/omnigraph/src/engine/`); a v1 edit needs the pin updated in the
same PR and a reviewer's eyes.
- `crates/omnigraph-reference` evaluates the core IR as the RFC's operator
table states it; GQT's `--- expect same as reference` compares a query
step's rows with it. It is not frozen: a change to core semantics updates it
in the same pull request, and a disagreement is a bug in one of the two.
- A change to what an operation reads or writes in storage adds or updates
its row in the DST storage-cost golden,
`crates/omnigraph-dst/cost_table.txt`, and the pull request explains every
Expand Down
23 changes: 4 additions & 19 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@ members = [
"crates/omnigraph-catalog",
"crates/omnigraph-planner",
"crates/omnigraph",
"crates/omnigraph-reference-engine",
"crates/omnigraph-cli",
"crates/omnigraph-api-types",
"crates/omnigraph-cluster",
Expand All @@ -20,6 +19,7 @@ members = [
"crates/omnigraph-dst",
"crates/omnigraph-gqt",
"crates/omnigraph-gqt-core",
"crates/omnigraph-reference",
"crates/omnigraph-gqt-served",
"skills",
"tools/omnigraph-vocabulary-guard",
Expand Down
63 changes: 35 additions & 28 deletions benchmarks/benchmarks.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -96,39 +96,39 @@ scenarios:
ordinal: 1
text: |
--- mutate
query hot_write() { update Hot set { value: 1 } where key = "hot" }
query hot_write() { $x: Hot $x.key = "hot" update $x set { value: 1 } }
- id: hot-table-idle-branches-4-aged
fixture: fixtures/hot_table_idle_branches_4_aged.gqt
workload: workloads/hot_table_idle_branches_4_aged.gqt
measured_step:
ordinal: 1
text: |
--- mutate
query hot_write() { update Hot set { value: 1 } where key = "hot" }
query hot_write() { $x: Hot $x.key = "hot" update $x set { value: 1 } }
- id: hot-table-idle-branches-4
fixture: fixtures/hot_table_idle_branches_4.gqt
workload: workloads/hot_table_idle_branches_4.gqt
measured_step:
ordinal: 1
text: |
--- mutate
query hot_write() { update Hot set { value: 1 } where key = "hot" }
query hot_write() { $x: Hot $x.key = "hot" update $x set { value: 1 } }
- id: hot-table-idle-tables-4
fixture: fixtures/hot_table_idle_tables_4.gqt
workload: workloads/hot_table_idle_tables_4.gqt
measured_step:
ordinal: 1
text: |
--- mutate
query hot_write() { update Hot set { value: 1 } where key = "hot" }
query hot_write() { $x: Hot $x.key = "hot" update $x set { value: 1 } }
- id: identity-lifecycle
fixture: fixtures/identity_lifecycle.gqt
workload: workloads/identity_lifecycle.gqt
measured_step:
ordinal: 1
text: |
--- mutate branch: feature
query new_lifetime_write() { update Item set { value: 1 } where key = "alice" }
query new_lifetime_write() { $x: Item $x.key = "alice" update $x set { value: 1 } }
- id: nearest-ranks-updated-embedding
fixture: fixtures/nearest_ranks_updated_embedding.gqt
workload: workloads/nearest_ranks_updated_embedding.gqt
Expand All @@ -137,9 +137,9 @@ scenarios:
text: |
--- query
query nearest_after_update($q: Vector(4)) {
match { $d: Doc }
match { from nearest({ match { $d: Doc } return { $d } }, $d.embedding, $q, k: 6) }
return { $d.slug }
order { nearest($d.embedding, $q) }
order { $distance }
limit 6
}
- id: nearest-skips-deleted-rows-and-fills-limit
Expand All @@ -150,9 +150,9 @@ scenarios:
text: |
--- query
query nearest_after_delete($q: Vector(4)) {
match { $d: Doc }
match { from nearest({ match { $d: Doc } return { $d } }, $d.embedding, $q, k: 3) }
return { $d.slug }
order { nearest($d.embedding, $q) }
order { $distance }
limit 3
}
- id: parallel-tables-1
Expand All @@ -163,7 +163,8 @@ scenarios:
text: |
--- mutate
query update_tables() {
update T0 set { value: 1 } where key = "row"
$x: T0 $x.key = "row"
update $x set { value: 1 }
}
- id: parallel-tables-2
fixture: fixtures/parallel_tables.gqt
Expand All @@ -173,8 +174,10 @@ scenarios:
text: |
--- mutate
query update_tables() {
update T0 set { value: 1 } where key = "row"
update T1 set { value: 1 } where key = "row"
$x: T0 $x.key = "row"
update $x set { value: 1 }
$x: T1 $x.key = "row"
update $x set { value: 1 }
}
- id: parallel-tables-4
fixture: fixtures/parallel_tables.gqt
Expand All @@ -184,10 +187,14 @@ scenarios:
text: |
--- mutate
query update_tables() {
update T0 set { value: 1 } where key = "row"
update T1 set { value: 1 } where key = "row"
update T2 set { value: 1 } where key = "row"
update T3 set { value: 1 } where key = "row"
$x: T0 $x.key = "row"
update $x set { value: 1 }
$x: T1 $x.key = "row"
update $x set { value: 1 }
$x: T2 $x.key = "row"
update $x set { value: 1 }
$x: T3 $x.key = "row"
update $x set { value: 1 }
}
- id: repeated-deletion-recreation-branches
fixture: fixtures/repeated_deletion_recreation_branches.gqt
Expand Down Expand Up @@ -326,7 +333,7 @@ scenarios:
ordinal: 1
text: |
--- mutate
query next_write() { update HistoryRow set { value: 1 } where key = "hot" }
query next_write() { $x: HistoryRow $x.key = "hot" update $x set { value: 1 } }
- id: very-long-history-10000-read
fixture: fixtures/very_long_history_10000.gqt
workload: workloads/very_long_history_read.gqt
Expand All @@ -348,7 +355,7 @@ scenarios:
ordinal: 1
text: |
--- mutate
query next_write() { update HistoryRow set { value: 1 } where key = "hot" }
query next_write() { $x: HistoryRow $x.key = "hot" update $x set { value: 1 } }
- id: very-long-history-100000-read
fixture: fixtures/very_long_history_100000.gqt
workload: workloads/very_long_history_read.gqt
Expand All @@ -370,7 +377,7 @@ scenarios:
ordinal: 1
text: |
--- mutate
query next_write() { update HistoryRow set { value: 1 } where key = "hot" }
query next_write() { $x: HistoryRow $x.key = "hot" update $x set { value: 1 } }
- id: very-long-history-32-read
fixture: fixtures/very_long_history_32.gqt
workload: workloads/very_long_history_read.gqt
Expand All @@ -392,23 +399,23 @@ scenarios:
ordinal: 1
text: |
--- mutate
query next_write() { update HistoryRow set { value: 1 } where key = "hot" }
query next_write() { $x: HistoryRow $x.key = "hot" update $x set { value: 1 } }
- id: very-long-history-32-write-unattached
fixture: fixtures/very_long_history_32.gqt
workload: workloads/very_long_history_write_unattached.gqt
measured_step:
ordinal: 1
text: |
--- mutate
query next_write() as unattached branch { update HistoryRow set { value: 1 } where key = "hot" }
query next_write() as unattached branch { $x: HistoryRow $x.key = "hot" update $x set { value: 1 } }
- id: unattached-chain-32-write
fixture: fixtures/unattached_chain_32.gqt
workload: workloads/very_long_history_write_unattached.gqt
measured_step:
ordinal: 1
text: |
--- mutate
query next_write() as unattached branch { update HistoryRow set { value: 1 } where key = "hot" }
query next_write() as unattached branch { $x: HistoryRow $x.key = "hot" update $x set { value: 1 } }
- id: e2e-merge-all-changed
fixture: fixtures/e2e_merge_all_changed.gqt
workload: workloads/e2e_merge_all_changed.gqt
Expand Down Expand Up @@ -514,9 +521,9 @@ scenarios:
text: |
--- query
query filtered_nearest($q: Vector(4)) {
match { $d: Doc { status: "hit" } }
match { from nearest({ match { $d: Doc { status: "hit" } } return { $d } }, $d.embedding, $q, k: 3) }
return { $d.slug }
order { nearest($d.embedding, $q) }
order { $distance }
limit 3
}
- id: e2e-nearest-nprobes-one
Expand All @@ -528,9 +535,9 @@ scenarios:
--- query
set ann_nprobes = 1;
query nearest_matching_rows($q: Vector(4)) {
match { $d: Doc $d.n > 3 }
match { from nearest({ match { $d: Doc $d.n > 3 } return { $d } }, $d.embedding, $q, k: 3) }
return { $d.slug }
order { nearest($d.embedding, $q) }
order { $distance }
limit 3
}
- id: e2e-rrf-traversal
Expand All @@ -541,14 +548,14 @@ scenarios:
text: |
--- query
query recall_two_terms($q1: String, $q2: String) {
match {
match { let $all = { match { $c: Chunk } return { $c } } from rrf(bm25($all, $c.text, $q1), bm25($all, $c.text, $q2), k: 60)
$c: Chunk
$a: Artifact
$c chunkOfArtifact $a
search($c.text, $q1)
}
return { $c.slug }
order { rrf(bm25($c.text, $q1), bm25($c.text, $q2)) }
order { $score desc }
limit 1
}
- id: e2e-query-scan
Expand Down
16 changes: 8 additions & 8 deletions benchmarks/fixtures/branch_merge_d50.gqt
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,7 @@ tables:
--- expect ok

--- mutate branch: bench-source
query delete_src_0($c: String) { delete BenchE000 where cohort = $c }
query delete_src_0($c: String) { $x: BenchE000 $x.cohort = $c delete $x }
--- params
{"c": "d50_src_del"}
--- expect ok
Expand All @@ -161,7 +161,7 @@ tables:
--- expect ok

--- mutate branch: bench-source
query delete_src_1($c: String) { delete BenchE001 where cohort = $c }
query delete_src_1($c: String) { $x: BenchE001 $x.cohort = $c delete $x }
--- params
{"c": "d50_src_del"}
--- expect ok
Expand All @@ -184,7 +184,7 @@ tables:
--- expect ok

--- mutate branch: bench-source
query delete_src_2($c: String) { delete BenchE002 where cohort = $c }
query delete_src_2($c: String) { $x: BenchE002 $x.cohort = $c delete $x }
--- params
{"c": "d50_src_del"}
--- expect ok
Expand All @@ -207,7 +207,7 @@ tables:
--- expect ok

--- mutate branch: bench-source
query delete_src_3($c: String) { delete BenchE003 where cohort = $c }
query delete_src_3($c: String) { $x: BenchE003 $x.cohort = $c delete $x }
--- params
{"c": "d50_src_del"}
--- expect ok
Expand Down Expand Up @@ -298,7 +298,7 @@ tables:
--- expect ok

--- mutate branch: bench-target
query delete_tgt_0($c: String) { delete BenchE000 where cohort = $c }
query delete_tgt_0($c: String) { $x: BenchE000 $x.cohort = $c delete $x }
--- params
{"c": "d50_tgt_del"}
--- expect ok
Expand All @@ -321,7 +321,7 @@ tables:
--- expect ok

--- mutate branch: bench-target
query delete_tgt_1($c: String) { delete BenchE001 where cohort = $c }
query delete_tgt_1($c: String) { $x: BenchE001 $x.cohort = $c delete $x }
--- params
{"c": "d50_tgt_del"}
--- expect ok
Expand All @@ -344,7 +344,7 @@ tables:
--- expect ok

--- mutate branch: bench-target
query delete_tgt_2($c: String) { delete BenchE002 where cohort = $c }
query delete_tgt_2($c: String) { $x: BenchE002 $x.cohort = $c delete $x }
--- params
{"c": "d50_tgt_del"}
--- expect ok
Expand All @@ -367,7 +367,7 @@ tables:
--- expect ok

--- mutate branch: bench-target
query delete_tgt_3($c: String) { delete BenchE003 where cohort = $c }
query delete_tgt_3($c: String) { $x: BenchE003 $x.cohort = $c delete $x }
--- params
{"c": "d50_tgt_del"}
--- expect ok
Expand Down
Loading
Loading