GFQL deprecated validation API removal policy and release gate #1440

Activity

1. lmeyerov commented on May 15, 2026

   

   lmeyerov

   on May 15, 2026

   ContributorAuthor

   More actions

   #1440 policy decision / closeout receipt

   Decision: removal is not approved for this deletion wave.

   Rationale:

   • Current master at f8d02053 still exposes this as public compatibility API:
     • graphistry/compute/gfql/validate.py remains a deprecated public module.
     • graphistry.compute.gfql re-exports its symbols.
     • graphistry.compute.gfql_validation remains a deprecated compatibility import package.
   • Tests still pin both import surfaces:
     • graphistry/tests/compute/test_validate.py
     • graphistry/tests/compute/test_gfql_validation.py
   • Removing it would be a user-facing import/API break, not cleanup-only deletion.

   Policy outcome:

   • Keep graphistry.compute.gfql.validate and graphistry.compute.gfql_validation as deprecated-but-public compatibility API for now.
   • Exclude this surface from [META] GFQL deletion wave: remove 2K+ LOC of obsolete compatibility paths #1419's 2K LOC deletion target.
   • Do not file a code deletion PR from GFQL deprecated validation API removal policy and release gate #1440.
   • Future removal needs an explicit major-release or version-gated approval, migration docs, hard deprecation-warning policy, changelog, and a follow-up code issue/PR.

   Validation/review receipts:

   • Branch based on latest origin/master: f8d02053d5501565bef65befb469d2f7ddd85afb.
   • Focused compatibility tests: python3 -m pytest -q graphistry/tests/compute/test_validate.py graphistry/tests/compute/test_gfql_validation.py → 37 passed.
   • git diff --check: clean.
   • Review-skill loop: converged after 2 local waves, 0 blocker / 0 important findings.
   • DGX/RAPIDS: not applicable; no code or cuDF/GPU path changed.

   Meta trackers to sync: #1419, #1259, #992.
2. lmeyerov commented on May 15, 2026

   

   lmeyerov

   on May 15, 2026

   ContributorAuthor

   More actions

   Closed per policy decision receipt above: removal is not approved for this deletion wave, no code deletion PR, and the deprecated public validation surface is excluded from #1419 deletion math unless future release-gated approval lands.
3. lmeyerov

   closed this as completedon May 15, 2026