Skip to content

feat(sql): expose native JOIN hint adapter seam - #192

Merged
trakhimenok merged 1 commit into
mainfrom
sql-native-join-hints
Sep 21, 2026
Merged

trakhimenok merged 1 commit into
mainfrom
sql-native-join-hints

Conversation

@trakhimenok

Copy link
Copy Markdown
Contributor

Summary

Add an opt-in native JOIN hint contract to dalgo2sql. A trusted adapter can receive the complete validated relation tree, acknowledge every hinted edge, and pass dialect-specific per-JOIN, SELECT, or query fragments to its own complete structured-query compiler. An adapter-owned eligibility hook controls native planning. The SQLite compiler and default SQL bytes remain unchanged.

This seam does not implement SQL Server or Oracle dialect translation; those adapters must provide and test their own compiler and hint policy.

Verification

  • Full GOWORK=off go test ./... suite passed with 91.0% coverage.
  • DALgo read-transaction test proves eligibility, ordered outer/nested/sibling hints, translation, and compiler handoff.
  • Rejection tests prove invalid/unacknowledged paths fail before SQL execution.
  • Local multi-module SQLite suite passed using the unmerged SQL branch through a temporary Go workspace.
  • WB hooks passed; independent adversarial review approved after strengthening multi-preference order assertions and path-specific errors.

@trakhimenok
trakhimenok merged commit 635e30e into main Sep 21, 2026
5 checks passed
@trakhimenok
trakhimenok deleted the sql-native-join-hints branch September 21, 2026 16:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant