Add experimental openCypher graph query frontend

[xiangfu0]

Summary

Adds an experimental graph query feature that translates a subset of openCypher into SQL JOINs and executes via Pinot's multi-stage engine. This enables graph-style traversal queries over existing Pinot tables without native graph runtime operators.

• New pinot-graph module (SPI + planner) with hand-written Cypher parser → IR → SQL transpiler
• POST /query/graph broker endpoint behind pinot.graph.enabled feature flag (default: false)
• Supports 1-hop and 2-hop traversals, WHERE (comparisons, AND/OR/NOT, STARTS WITH, ENDS WITH, CONTAINS, IN), RETURN (DISTINCT, AS aliases, COUNT/SUM/AVG/MIN/MAX with GROUP BY), ORDER BY, SKIP, LIMIT
• Graph schema passed inline in request JSON mapping vertex/edge labels to Pinot tables
• Zero impact on existing SQL query path — purely additive changes

Design doc posted on #17935: #17935 (comment)

Closes #17935

Test plan

• 211 unit tests (parser: 94, SQL generator: 49, translator: 52, golden: 16) — all pass
• 12 broker handler tests — all pass
• 10 E2E integration tests with 2 servers and distributed data (50 users, 200 edges, 4 segments/table) — all pass
• spotless, checkstyle, license checks — all clean
• Existing SQL path unaffected (no modifications to query execution)
• Feature disabled by default; returns clear 400 error when disabled
• Unsupported Cypher syntax rejected with clear error messages

🤖 Generated with Claude Code

[codecov-commenter]

Codecov Report

❌ Patch coverage is 83.73860% with 214 lines in your changes missing coverage. Please review.
✅ Project coverage is 63.43%. Comparing base (1329e1f) to head (0263674).
⚠️ Report is 238 commits behind head on master.

Files with missing lines	Patch %	Lines
...a/org/apache/pinot/graph/planner/CypherParser.java	88.41%	30 Missing and 27 partials ⚠️
...che/pinot/graph/planner/CypherToSqlTranslator.java	72.32%	27 Missing and 17 partials ⚠️
...pinot/broker/api/resources/PinotClientRequest.java	0.00%	43 Missing ⚠️
...a/org/apache/pinot/graph/planner/SqlGenerator.java	85.50%	27 Missing and 12 partials ⚠️
...e/pinot/graph/planner/CypherSemanticValidator.java	79.77%	9 Missing and 9 partials ⚠️
.../java/org/apache/pinot/graph/planner/CypherIR.java	97.00%	3 Missing and 2 partials ⚠️
...not/broker/requesthandler/GraphRequestHandler.java	93.75%	0 Missing and 4 partials ⚠️
...ache/pinot/graph/planner/CypherParseException.java	50.00%	2 Missing ⚠️
.../org/apache/pinot/graph/spi/GraphSchemaConfig.java	96.42%	1 Missing ⚠️
...va/org/apache/pinot/spi/utils/CommonConstants.java	0.00%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##             master   #17938      +/-   ##
============================================
+ Coverage     63.25%   63.43%   +0.17%     
- Complexity     1490     1543      +53     
============================================
  Files          3191     3208      +17     
  Lines        192609   195484    +2875     
  Branches      29542    30111     +569     
============================================
+ Hits         121844   124002    +2158     
- Misses        61224    61761     +537     
- Partials       9541     9721     +180     

Flag	Coverage Δ
custom-integration1	100.00% <ø> (ø)
integration	100.00% <ø> (ø)
integration1	100.00% <ø> (ø)
integration2	0.00% <ø> (ø)
java-11	63.40% <83.73%> (+0.18%)	⬆️
java-21	63.40% <83.73%> (+0.24%)	⬆️
temurin	63.43% <83.73%> (+0.17%)	⬆️
unittests	63.43% <83.73%> (+0.17%)	⬆️
unittests1	55.54% <0.00%> (+0.02%)	⬆️
unittests2	34.52% <83.73%> (+0.25%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.