relational/

Package ddl defines the DDL action interfaces for the relational layer.

Package plandiff is the Phase 4.-1 plan-equivalence harness from RFC-022 §4.-1.

Package yamsql is a SQL-level conformance harness for the Go SQL driver.

Package catalog contains concrete implementations of the api.StoreCatalog / api.SchemaTemplateCatalog / api.Transaction interfaces.

Package embedded implements the embedded (in-process) SQL execution engine for the FoundationDB relational layer.

Package functions holds SQL-value operations that don't need connection/session state: checked integer arithmetic, numeric + bitwise operators with SQL semantics, type-coercion helpers used by scalar-function arguments, and (in future PRs) the scalar function dispatcher + protoreflect <-> driver.Value marshaling.

Package keyspace defines the relational-layer FDB key structure.

Package metadata provides concrete bridge implementations of the api.* metadata interfaces backed by *recordlayer.RecordMetaData.

Package parser houses the generated ANTLR4 lexer and parser for the Relational SQL dialect, plus the thin Go wrapper that wires them into a ParseTree suitable for consumption by the semantic analyzer.

Package grammar is a go-sentinel (empty) package whose only job is to anchor the *.g4 grammar files in the Go module tree so they travel with builds and gazelle doesn't delete the directory.

Package query defines the planner/plan seam between the SQL frontend (database/sql driver, future gRPC server, REPL) and the SQL execution engine.

Package expr is the parse-tree → values.Value resolver.

Package logical holds the Phase 3 (TODO.md §"Phase 3 — Semantic analysis") logical-operator hierarchy.

Package plangen converts the embedded engine's LogicalOperator hierarchy into the Cascades-side RelationalExpression hierarchy.

Package semantic is the Go port of Java's `com.apple.foundationdb.relational.recordlayer.query.SemanticAnalyzer` plus related Identifier / Expression / reference-resolution helpers.

Package rlcatalog adapts the Record Layer's `RecordMetaData` into the `semantic.Catalog` interface.

Package session holds per-connection resource state for the relational SQL engine.