Meta: GFQL compiler/planner post-M4 execution DAG (active wave)

[lmeyerov]

Summary

Post-M4 GFQL compiler/planner execution DAG meta-tracker.

Completed Active Lanes

• [FEA] GFQL bindings_table (row bindings) from chain using Yannakakis prune #880 residual split and benchmark closeouts are complete.
• graphistry/pyg-bench#11/edge colors can't be set #12/Bind call required before most others #19/print out current set of bindings #20/Cannot bind nodes/edges in Plotter #18 and associated PRs are complete.
• Test hardening: replace direct cuDF .to_pandas().to_dict() conversions in GFQL lowering tests #1439, D4 prep: native physical dispatch coverage needed to retire GFQL compat executor #1441, GFQL deprecated validation API removal policy and release gate #1440, GFQL row-pipeline: anonymous-source MATCH projects boolean reachability, not bound node/edge — blocks tck-gfql with-skip-limit{1-2,2-4} #1438, GFQL row pipeline: cuDF host-bridge gap in order_by + test placement debt for compute/gfql/row/ (follow-ups from #1362/#1359) #1373, [FEA] Cypher binder: enable strict-name-resolution to centralize alias-scope enforcement #1357 are complete.
• [META] GFQL deletion wave: remove 2K+ LOC of obsolete compatibility paths #1419 deletion wave is closed as revised/de-scoped after D8 final GFQL compat-executor reachability audit and deletion/shrink decision #1466 / GFQL compat-executor reachability shrink #1467.
• GFQL deletion: remove Cypher reentry compiletime lowering-symbol shim #1471 reentry compiletime lowering-symbol shim deletion is complete via Remove Cypher reentry compiletime lowering shim #1474.

Direct-Cypher Residual Cleanup (#1353)

Fresh #1353 snapshot after graphistry/tck-gfql#125, against pygraphistry 592e34a6 + tck-gfql 0fbaa42e:

• tracked non-validation debt: 1
• success_matches_expected: 1 (match5-8 bookkeeping)
• success_wrong_rows: 0
• unexpected_success_expected_error: 0
• additional fastfail drift: with5-2 now returns expected rows while its direct-Cypher xfail contract still expects GFQLValidationError

Completed:

• [META-split] Direct-Cypher wrong-rows tranche A: comparator + ORDER BY semantics #1405
• [META-split] Direct-Cypher wrong-rows tranche B: temporal comparison/canonicalization #1406 via fix(cypher): temporal historical canonicalization/comparison tranche #1409
• [META-split] Direct-Cypher wrong-rows tranche C: tri-valued list/map/null semantics #1407
• [META-split] Direct-Cypher wrong-rows tranche D: string/type-conversion cleanup #1429 via Reject invalid Direct-Cypher toString list items #1434 + Update direct Cypher string/typeconversion contract tck-gfql#104
• GFQL/Cypher: temporal wrong-row follow-up (11 remaining, #1353 item #2) #1374 via Add Temporal7 temporal comparison regressions #1442 + Promote expr-literals6-5 direct Cypher contract tck-gfql#110
• Tranche: Comparison/list/null wrong-row semantics (14 cases) under #1353 #1367 via Fix empty post-aggregate list projection #1445 + Promote empty aggregate direct Cypher rows tck-gfql#109
• Tranche: mixed wrong-row tail cleanup under #1353 #1369 via [codex] Fix Cypher zero-hop and empty post-aggregate rows #1443 + Promote match5-8 direct Cypher contract tck-gfql#112
• Tranche: Literals/string/type-conversion wrong-row semantics under #1353 #1368 issue-only closeout
• Direct-Cypher residual: pattern predicate wrong rows under #1369 #1449 via Fix Cypher pattern predicate row expansion #1451 + Rebaseline pattern predicate direct-Cypher contract tck-gfql#117
• Direct-Cypher residual: string list-index expected-error drift under #1369 #1450 via fix(gfql): reject scalar string integer subscripts #1452 + Rebaseline string index expected-error drift tck-gfql#116
• Direct-Cypher residual: reconcile return2-9 map row cardinality tck-gfql#113 via demos(csv upload miniapp): icij medical implant files #121
• Direct-Cypher residual: reconcile match5-25/26 fixture or contract tck-gfql#114 via docs(v1 of zeek hunting masterclass) #124
• Direct-Cypher residual: reconcile with2-1 setup/join contract tck-gfql#115 via docs(finale corelight notebook) #125
• GFQL/Cypher: audit and broaden cuDF coverage for temporal comparisons #1446 via Broaden cuDF temporal comparison coverage #1447

Remaining support:

• Direct-Cypher promotion bookkeeping for match5-8 and with5-2 tck-gfql#129 — final promotion/accounting sidecar for match5-8 + with5-2

Closed Large Deletion Wave

• [META] GFQL deletion wave: remove 2K+ LOC of obsolete compatibility paths #1419 closed/revised after final D8 D8 final GFQL compat-executor reachability audit and deletion/shrink decision #1466 / PR GFQL compat-executor reachability shrink #1467.
  • [DEL] D1 remove obsolete row-join fallback branches after #880 post-rerun fixes #1418 via [codex] Remove connected-match row-join compat fallback #1431 + Remove connected optional compat fallback #1435
  • [DEL] D2 remove pre-strict binder compatibility guards after #1357 #1420 via Remove pre-strict Cypher binder guards #1432
  • [DEL] D3 remove stale reentry failfast scaffolding #1421 via [codex] Remove stale reentry failfast scaffolding #1433
  • D4 prep: native physical dispatch coverage needed to retire GFQL compat executor #1441 via Add native physical dispatch for planned GFQL routes #1448
  • GFQL deprecated validation API removal policy and release gate #1440 deprecated validation API policy gate
  • D5 prep: inventory remaining compat executor fallbacks and CALL route decision #1455 via Route Cypher CALL through physical dispatch #1458
  • D6 deletion prep: native route for simple top-level OPTIONAL MATCH fallback #1460 via Route simple OPTIONAL MATCH through native physical dispatch #1463
  • D7 deletion prep: native route for OPTIONAL MATCH reentry fallback #1461 via Route optional reentry through native planning #1462
  • D8 final GFQL compat-executor reachability audit and deletion/shrink decision #1466 D8 final compat-executor reachability audit and deletion/shrink decision via GFQL compat-executor reachability shrink #1467

Post-#1419 concrete deletion follow-up:

• GFQL deletion: remove Cypher reentry compiletime lowering-symbol shim #1471 via Remove Cypher reentry compiletime lowering shim #1474 removed the reentry compiletime lowering-symbol shim and added guards against broad shim reintroduction.

Final deletion-wave receipt:

• _execute_compiled_query_compat_non_union() is deleted.
• Projection-level WITH/RETURN DISTINCT now plans natively through logical Distinct.
• Remaining safe deletion surface did not approach the original >=2K LOC target; D8 source delta was net -24.
• Coordinator decision: treat the original [META] GFQL deletion wave: remove 2K+ LOC of obsolete compatibility paths #1419 LOC target as revised/de-scoped. New deletion work needs a new concrete target.

Next Dispatch

• feat(gfql): add public declarative schema model #1457/GFQL type system follow-on A: public declarative schema model + stable exports #1337 is already active in /home/lmeyerov/Work/pygraphistry5; review/merge only.
• Typed schema follow-ons (GFQL type system follow-on B: schema inference API + typed topology extraction #1338/GFQL type system follow-on C: public schema-Arrow APIs + plottable boundary enforcement #1339/GFQL remote: send bound typed GraphSchema with gfql_remote requests #1465/GFQL schema tutorial: infer, refine, bind, and validate Cypher #1464) are a separate stack.
• Direct-Cypher promotion bookkeeping for match5-8 and with5-2 tck-gfql#129 for match5-8/with5-2 promotion bookkeeping only.
• Do not assign [META] GFQL deletion wave: remove 2K+ LOC of obsolete compatibility paths #1419/D8 final GFQL compat-executor reachability audit and deletion/shrink decision #1466/GFQL deletion: remove Cypher reentry compiletime lowering-symbol shim #1471 further; all are closed for this wave.

Coordination Metas

• Meta: benchmark coverage unlock plan for GFQL and GFQL/Cypher #992 synced
• Cypher/GFQL rejects multi-stage MATCH ... WITH ... MATCH ... WITH ... MATCH read queries #999 closed

[lmeyerov]

Status update for active #1262 lane: T1 slice #1296 is implemented in PR #1298 (https://github.com/graphistry/pygraphistry/pull/1298).\n\nChecks are green (including tck-gfql/docs). Pending merge.

[lmeyerov]

Execution lane update: #1296 is now merged via PR #1298\nhttps://github.com//pull/1298\n\nMerge commit: 559bdc7\n\nStatus: T1 schema-contract/canonical-naming lane complete; downstream lanes can build on the stabilized schema surface.

[lmeyerov]

Lane update: #1302 (T2 under #1262) has landed via PR #1308.\n\nMerge receipt:\n- merged to master on 2026-05-05\n- merge commit: a23c34c\n- checks green at merge time (including tck-gfql + ReadTheDocs)\n\nActive type-system lane now shifts to #1300 (T3) under #1262.