sql-client-conformance.json

{
  "schemaVersion": 1,
  "ownerRequirementDate": "2026-10-03",
  "decision": "ADR-065",
  "workingDialect": "PostgreSQL18",
  "dialectSelectedBy": "integration-planning-owner; optional owner preference unanswered",
  "targetDefinition": "https://www.postgresql.org/docs/18/sql.html",
  "fullSqlComplete": false,
  "nativeClientProtocolQualified": false,
  "currentTransport": [
    "HTTP JSON",
    "official MCP Streamable HTTP"
  ],
  "nativeWireTarget": {
    "initial": "3.0",
    "laterNegotiation": "3.2",
    "implementation": "pending"
  },
  "inventoryStatus": "183 official command names inventoried; complete semantic contracts and execution fixtures pending",
  "families": [
    {
      "id": "SQLC-LEX",
      "name": "lexical comments, quoting, identifiers, literals, parameters",
      "syntax": "Q1 subset plus line and nested block comments",
      "execution": "Q1 subset",
      "evidence": "Original full CI baseline7d9852 and existing lexical/RF3 cases; Historical intermediate report removed from repository; no current qualification inferred; full PostgreSQL lexical conformance pending"
    },
    {
      "id": "SQLC-READ",
      "name": "SELECT expressions, types, casts, nulls, collations, scalar functions",
      "syntax": "Q1 fields and predicates plus bounded BETWEEN/NOT BETWEEN qualified at source7d1196",
      "execution": "Qualified bounded Q1 only; full PostgreSQL18 typed expressions pending",
      "evidence": "AC-SQLC-006A original21unit cases in each normal/scalar mode and2genuine RF3cases pass; Historical intermediate report removed from repository; no current qualification inferred; complete AC-SQLC-006 remains pending"
    },
    {
      "id": "SQLC-JOIN",
      "name": "joins, subqueries, correlated queries, CTEs including recursive/data modifying",
      "syntax": "Closed Q2/AST2 Text primary-key INNER equijoin source joined; all other join/subquery/CTE forms remain pending",
      "execution": "Real ZoneTree single authorized committed cut, literal SQL/AST projections, ordinal ordering, both source identities, policy/redaction, cumulative bounds, cancellation and reopen exercised in owning local normal/scalar; public RF3/Linux and remaining negative inventories pending",
      "evidence": "ADR118/RelationalStorage/QueryExecution mapped subcriteria; R291/R292 owning606/606 with zero drift/skips. No full REQ/AC-SQLC-006 closure, full SQL or native SQL protocol inferred."
    },
    {
      "id": "SQLC-GROUP",
      "name": "aggregates, grouping sets, having, windows",
      "syntax": "pending",
      "execution": "pending",
      "evidence": "AC-SQLC-006 pending"
    },
    {
      "id": "SQLC-SET",
      "name": "set operations, distinct, order, offset, fetch, limit",
      "syntax": "Q1 order and limit only",
      "execution": "Q1 order and limit only",
      "evidence": "AC-SQLC-006 pending"
    },
    {
      "id": "SQLC-DML",
      "name": "INSERT, UPDATE, DELETE, MERGE, conflict handling, RETURNING, COPY",
      "syntax": "pending",
      "execution": "typed canonical row APIs only",
      "evidence": "AC-SQLC-006 pending"
    },
    {
      "id": "SQLC-DDL",
      "name": "database/schema/table/type/domain/index/view/materialized view/sequence create alter drop",
      "syntax": "pending",
      "execution": "canonical resource/schema APIs only",
      "evidence": "AC-SQLC-006 pending"
    },
    {
      "id": "SQLC-INTEGRITY",
      "name": "primary unique check foreign keys, deferred constraints, triggers, rules",
      "syntax": "pending",
      "execution": "typed row required/type/key checks only",
      "evidence": "AC-SQLC-006 pending"
    },
    {
      "id": "SQLC-TXN",
      "name": "BEGIN, COMMIT, ROLLBACK, SAVEPOINT, isolation, locks, prepared transactions",
      "syntax": "pending",
      "execution": "canonical atomic command boundary only",
      "evidence": "AC-SQLC-006/008 pending"
    },
    {
      "id": "SQLC-ROUTINE",
      "name": "functions, procedures, DO, CALL",
      "syntax": "canonical CALL envelope in default query dialect1 only; nondefault version explicitly unsupported",
      "execution": "sole canonical operation catalog only; additive source-only CALL keyload_messages_receive_across_lanes(@args) uses MultiLaneReceiveRequest and independent typed lane outcomes in SQL envelope1/queryDialectVersion1",
      "evidence": "TASK-KL087-MULTI-LANE-RECEIVE-001, REQ-MSG-007/AC-MSG-007, ADR-026; MultiLaneReceiveRf3Tests authors real SDK/MCP/SQL-SDK/SQL-MCP parity, execution pending. Full routine execution, full SQL and native client protocol qualification remain pending"
    },
    {
      "id": "SQLC-SESSION",
      "name": "SET, RESET, SHOW, PREPARE, EXECUTE, DEALLOCATE, cursor lifecycle",
      "syntax": "pending",
      "execution": "pending",
      "evidence": "AC-SQLC-007/008 pending"
    },
    {
      "id": "SQLC-AUTH",
      "name": "roles, GRANT, REVOKE, row security and policy DDL",
      "syntax": "pending",
      "execution": "persisted canonical authorization APIs only",
      "evidence": "AC-SQLC-006/008 pending"
    },
    {
      "id": "SQLC-META",
      "name": "EXPLAIN, catalog/information_schema, diagnostics and client bootstrap",
      "syntax": "Q1 EXPLAIN only",
      "execution": "Q1 EXPLAIN only",
      "evidence": "AC-SQLC-006/007 pending"
    },
    {
      "id": "SQLC-ADMIN",
      "name": "maintenance, notifications, publication/subscription, extensions and remaining PostgreSQL18 SQL commands",
      "syntax": "pending",
      "execution": "pending",
      "evidence": "complete command inventory and AC-SQLC-001/006 pending"
    },
    {
      "id": "SQLC-MODELS",
      "name": "linked documents, rows, graph, vector/text search, series, blobs, queues, events",
      "syntax": "canonical CALL only",
      "execution": "existing canonical operations only",
      "evidence": "declarative typed execution AC-SQLC-006 pending"
    }
  ],
  "qualification": {
    "testsLocation": "GitHub Actions only",
    "newLexicalCasesExecuted": "Existing comment cases are included in the genuine qualified baseline; full PostgreSQL lexical conformance is not established.",
    "coverage": "collector unavailable; pending",
    "fullNativeClientEvidence": null,
    "completePerformanceCohort": null,
    "latestQualifiedBaseline": "Historical intermediate report removed from repository; no current qualification inferred",
    "currentBetween": {
      "sourceRevision": "be2e8918d9636c2507af26588279035e7183c918",
      "sourceRunConclusion": "cancelled_no_steps_or_original_reports",
      "successorSourceRevision": "7d1196db51f682f64ffcf4560e7b3f12b49b499b",
      "ciRunId": 37132491153,
      "ownedSourceFilesByteEquivalent": 11,
      "runtimeQualification": "passed44original_execution_rows_and_full_source_ci",
      "normalCasesExpected": 21,
      "scalarCasesExpected": 21,
      "rf3CasesExpected": 2,
      "originalPassedCounts": {
        "normal": 21,
        "scalar": 21,
        "rf3": 2
      },
      "qualificationReceipt": "Historical intermediate report removed from repository; no current qualification inferred",
      "coverageQualified": false,
      "performanceQualified": false
    }
  },
  "commandInventory": "docs/implementation/sql-client-commands-postgresql18.json",
  "officialCommandCount": 183,
  "commandInventoryStatus": "all official names mapped for planning; semantic contracts and real execution fixtures pending; family mappings are research inference",
  "currentLanguageContract": {
    "decision": "ADR-118",
    "defaultAstVersion": 1,
    "defaultQueryDialectVersion": 1,
    "sourceTargetAstVersions": [
      1,
      2
    ],
    "sourceTargetQueryDialectVersions": [
      1,
      2
    ],
    "q2Profile": "Q2.InnerJoin.v1",
    "q2Profiles": ["Q2.InnerJoin.v1", "Q2.InnerJoin.LeftPredicate.v1", "Q2.QueueEntityRefJoin.v1", "Q2.EventEntityRefJoin.v1"],
    "q2Scope": "Explicit source projection; one same-partition typed Text-primary-key INNER JOIN with declared top-level left predicates, or QUEUE_MESSAGES/EVENTS payload.to canonical reference JOIN to one typed target. Left ordinal primary-key/message-id or event revision order, explicit full-scan consent, bounded LIMIT and one authorized native read cut",
    "sourceStage": "Current source contains the four finite Q2 profiles; current-source public RF3/Linux and complete SQL/client qualification remain pending. The preserved normal/scalar606 receipts below are immutable historical development evidence, not current-source qualification",
    "q2Unsupported": [
      "right-source WHERE predicates",
      "nested or metadata predicates on typed left tables",
      "arbitrary model sources/reference paths",
      "cursor",
      "self or multiple joins",
      "outer/cross joins",
      "non-primary-key right key",
      "non-Text key",
      "star projection",
      "EXPLAIN INNER JOIN",
      "GROUP/aggregate/subquery/CTE",
      "CALL with nondefault query dialect"
    ],
    "fullSqlComplete": false,
    "nativeClientProtocolQualified": false,
    "localDevelopmentEvidence": {
      "normalTrxSha256": "523837cecb848838ed013f6cdaa6352a4f72e813c0576b683937f50efe97621c",
      "scalarTrxSha256": "55357a69d0c777973beaec0ba6e5b7b175480a7329acc250361281e6fd6f30ab",
      "fullSqlComplete": false,
      "nativeClientProtocolQualified": false
    }
  },
  "textIndexFoundation": {
    "repository": "https://github.com/ZoneTree/ZoneTree.FullTextSearch",
    "decision": "selected by owner on2026-10-03",
    "ownership": "native node-local full-text index over canonical ZoneTree records; not an SQL parser or replacement canonical database",
    "integration": "existing native selected provider; its scoped tests and qualification remain in Search/FullTextNative",
    "performanceQualification": "open; SQL conformance does not qualify comparative search performance"
  }
}