sql-client-conformance.json

{
  "schemaVersion": 2,
  "ownerRequirementDate": "2026-10-03",
  "decision": "ADR-130",
  "workingDialect": "T-SQL",
  "dialectSelectedBy": "owner explicit selection 2026-10-13",
  "targetDefinition": "https://github.com/microsoft/SqlScriptDOM",
  "syntaxLibrary": {
    "package": "Microsoft.SqlServer.TransactSql.ScriptDom",
    "version": "180.140.0",
    "versionAuthority": "Existing centrally pinned owner-selected ADR-130 contract; this doc packet does not change/adopt a package.",
    "role": "native parser and AST, not executor or TDS implementation"
  },
  "fullSqlComplete": false,
  "nativeClientProtocolQualified": false,
  "currentTransport": [
    "HTTP JSON",
    "official MCP Streamable HTTP",
    "source-integrated bounded PostgreSQL3.0 TLS/API-key native session; independent qualification OPEN"
  ],
  "nativeWireTarget": {
    "initial": "3.0",
    "laterNegotiation": "3.2",
    "implementation": "closed PostgreSQL3.0 TLS/API-key session source; qualification pending",
    "initialProfile": {
      "name": "native-sql-v1-jsonb-result",
      "transport": "native Kestrel TLS ConnectionContext/Pipelines; not HTTP",
      "authentication": "same persisted API-key verifier, verified subject only, fresh credential/policy every Execute",
      "result": "one JSONB keyload_result containing entire canonical result",
      "queryDialects": [
        1,
        2
      ],
      "preparedProtocol": [
        "Parse",
        "Bind",
        "Describe",
        "Execute",
        "Close",
        "Sync",
        "Flush",
        "Terminate"
      ],
      "limits": "eight statements/eight portals, current native query/JSON/frame/output and shared retained byte grants",
      "driver": "Npgsql10.0.3 VerifyFull/root CA; GSS encryption disabled; pooling false; built-in-only type loading; no parameter logging",
      "qualification": "pending exact-source Linux Aspire RF3 original artifacts",
      "int16ParameterSourceContract": "Guarded next source: exact signedInt16 int2 OID21 text/two-byte binary using original canonical numeric parameters. Wrong width/syntax/overflow Validation, no new grants/SQLgrammar/fallback; genuine Npgsql/SDK/MCP complete operation source and exact Linux qualification pending.",
      "notDelivered": [
        "general PostgreSQL catalog/bootstrap and typed column metadata",
        "SQL PREPARE/EXECUTE/DEALLOCATE syntax",
        "suspended portals/cursors",
        "explicit/implicit multistatement transactions",
        "protocol3.2 negotiation",
        "general T-SQL execution",
        "SQL Server TDS interoperability"
      ],
      "numericParameterSourceContract": "Prepared guarded source only: text/binary OID1700 exact .NET decimal96/scale28 without rounding; malformed Validation, specials/nonrepresentable/hidden-dscale precision UnsupportedCapability. Genuine Npgsql/SDK/MCP whole-flow and exact-source Linux qualification pending; no general PostgreSQL numeric compatibility.",
      "language": "Selected T-SQL lowered through ScriptDOM; PostgreSQL framing/driver contracts are independent",
      "operationLanguage": "canonical EXEC",
      "historicalNumericAndStringEvidence": "Original positional/prepared parameter source and qualification receipts remain in the historical inventory; current T-SQL binding requires its own exact-source proof."
    }
  },
  "inventoryStatus": "Selected T-SQL grammar; finite source execution inventory; retired PostgreSQL TABLE/LIMIT/CALL and handwritten NEXT lexical proposals are historical only; all whole-product qualification gates OPEN",
  "families": [
    {
      "id": "SQLC-LEX",
      "name": "T-SQL lexical syntax, quoting, identifiers, literals and variables",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "OPEN: no complete family execution claim",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-READ",
      "name": "SELECT projection, predicates, scalar types and functions",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "Source: bounded SELECT lowering to existing typed plans; exact selected nodes only.",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-JOIN",
      "name": "typed and model-source joins, subqueries and common table expressions",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "Source: closed same-partition typed/model-source graph/reference profiles; arbitrary joins remain unsupported.",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-GROUP",
      "name": "aggregate, GROUP BY, HAVING and window execution",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "OPEN: no complete family execution claim",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-SET",
      "name": "set operators, DISTINCT, ORDER BY, TOP and OFFSET/FETCH",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "Source: bounded ordering/TOP/ordered OFFSET-FETCH lowering; general set execution is not qualified.",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-DML",
      "name": "INSERT, UPDATE, DELETE, MERGE and OUTPUT execution",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "SOURCE CANDIDATE: existing closed graph/queue composition plus bounded ordinary typed INSERT VALUES/parameters; general INSERT SELECT/UPDATE/DELETE/MERGE/OUTPUT remain OPEN.",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored.",
      "ordinaryInsertCandidate": {
        "profile": "TSQL.InsertValues.v1",
        "contract": "docs/Features/RelationalStorage/OrdinarySqlInsert.md",
        "identity": "Original SqlOperationRequest.CommandId / unchanged one-shot native connection arm",
        "atomicity": "Current persisted schema, Text PK, DocsWrite/field/index/row authorization and create-only absence inside original Batch apply gate; complete multirow rollback and original outcomes",
        "tests": [
          "SqlTypedInsertWholeFlowTests",
          "SqlTypedInsertRf3WholeFlowTests"
        ],
        "qualified": false,
        "unsupported": [
          "INSERT SELECT",
          "DEFAULT VALUES",
          "OUTPUT",
          "schema-qualified targets",
          "identity/default/computed fields",
          "foreign keys",
          "general UPDATE/DELETE/MERGE"
        ]
      }
    },
    {
      "id": "SQLC-DDL",
      "name": "database, schema, table, type, index, view and sequence DDL",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "SOURCE CANDIDATE: bounded canonical CREATE TABLE only; full DDL family remains OPEN",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored.",
      "createTableCandidate": {
        "profile": "TSQL.CreateTable.v1",
        "types": [
          "NVARCHAR(MAX)",
          "BIT",
          "BIGINT"
        ],
        "identity": "Explicit original SqlOperationRequest.CommandId; restricted native SET CONTEXT_INFO arm; original EXEC identity must agree",
        "atomicity": "Create-only inside existing node-local command transaction, original successful/failed outcome replay and current policy fencing",
        "tests": [
          "SqlCreateTableWholeFlowTests",
          "SqlCreateTableRf3WholeFlowTests"
        ],
        "qualified": false,
        "unsupported": [
          "temporary tables",
          "schema-qualified names",
          "ALTER TABLE",
          "DROP TABLE",
          "defaults",
          "foreign keys",
          "checks",
          "secondary uniqueness",
          "computed/generated/identity columns",
          "storage/index/view/type/sequence/database DDL"
        ],
        "ordinaryRowSqlInsert": "SOURCE CANDIDATE TSQL.InsertValues.v1; owning canonical ordinary typed INSERT contract, whole runtime/Linux qualification OPEN"
      }
    },
    {
      "id": "SQLC-INTEGRITY",
      "name": "keys, unique/check/foreign constraints and triggers",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "OPEN: no complete family execution claim",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-TXN",
      "name": "transaction, savepoint, isolation and locking execution",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "OPEN: no complete family execution claim",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-ROUTINE",
      "name": "canonical EXEC lowering and general routine execution",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "Source: EXEC of the canonical operation catalog with typed verified arguments; dynamic execution/general stored routines are unsupported.",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-SESSION",
      "name": "session settings, native prepared statements and portals",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "OPEN: no complete family execution claim",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-AUTH",
      "name": "persisted authorization and SQL authorization statements",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "OPEN: no complete family execution claim",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-META",
      "name": "capability reporting, diagnostics and client catalog bootstrap",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "OPEN: no complete family execution claim",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-ADMIN",
      "name": "administrative execution families",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "OPEN: no complete family execution claim",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    },
    {
      "id": "SQLC-MODELS",
      "name": "linked document, relational, graph, vector/search, series, blob, queue and event operations",
      "grammarOwner": "Microsoft ScriptDOM T-SQL AST",
      "execution": "Source: existing typed model plans and closed declared graph/model sources; parsing broader syntax does not enable a new model plan.",
      "qualified": false,
      "requirement": "REQ-SQLC-006 / AC-SQLC-006",
      "acceptance": "Complete independently literal success/refusal→healthy operation, current authority, original receipts, bounds/cancellation, recovery and RF3 evidence required; unsupported AST cannot be ignored."
    }
  ],
  "qualification": {
    "currentSelectedDialect": "OPEN; exact-source Linux build/analyzer/native discovery/Unit/Recovery/Aspire RF3 and resource/cancellation originals required",
    "syntaxAcceptanceIsExecution": false,
    "fullNativeClientEvidence": null,
    "completePerformanceCohort": null,
    "historicalEvidence": "docs/implementation/sql-client-conformance-postgresql18.historical.json"
  },
  "commandInventory": null,
  "officialCommandCount": null,
  "commandInventoryStatus": "No complete T-SQL command enumeration or executed conformance claim. Previous183 PostgreSQL command names are retired historical research.",
  "currentLanguageContract": {
    "decision": "ADR-130",
    "astIdentity": "Existing KeyLoad typed AST/version/aliases unchanged by documentation",
    "sourceExecutionFamilies": [
      "bounded SELECT",
      "canonical EXEC",
      "closed same-partition queue/graph INSERT",
      "closed graph/model-source plans"
    ],
    "unsupportedPolicy": "Valid unhandled native AST => UnsupportedCapability before effect/view admission; malformed => bounded Validation. No fallback grammar.",
    "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"
  },
  "retiredInventories": [
    {
      "path": "docs/implementation/sql-client-conformance-postgresql18.historical.json",
      "sha256": "c97b3e6dbe4d916cb70da6e1f997f22163d2492e6f168cd12002028a0e1a452f",
      "active": false,
      "reason": "Superseded PostgreSQL18 grammar and lexical candidates; original JSON bytes preserved"
    },
    {
      "path": "docs/implementation/sql-client-commands-postgresql18.json",
      "sha256": "2e2185ad0d3ac713a63e736f668c122790bd6f5a5be1b2c0f9a25a44b1226bb7",
      "active": false,
      "commandCount": 183,
      "role": "immutable previous grammar research; not current conformance target"
    }
  ],
  "primarySources": [
    {
      "url": "https://github.com/microsoft/SqlScriptDOM",
      "claim": "Microsoft owns the T-SQL parser and AST library; it is not a database executor.",
      "sourcePin": "official live repository inspected; not proof of restored package binary"
    },
    {
      "url": "https://learn.microsoft.com/en-us/dotnet/api/microsoft.sqlserver.transactsql.scriptdom.tsqlparser.parse?view=sql-transactsql-161",
      "claim": "Parse returns TSqlFragment and parser errors; API documentation version is not the KeyLoad selected package version."
    },
    {
      "url": "https://github.com/microsoft/SqlScriptDOM/blob/main/SqlScriptDom/Parser/TSql/Ast.xml",
      "claim": "Native AST has separate query, execute and insert nodes; native syntax coverage does not imply supported KeyLoad execution."
    }
  ],
  "benchmarkBoundary": "PostgreSQL remains an actual native comparison database; this syntax selection changes no competitor, topology, workload or evidence.",
  "schemaContract": {
    "id": "KeyLoad.SqlConformance.Inventory.v2",
    "previousVersion": 1,
    "breakingFields": [
      "families.syntax/evidence and old vendor-specific NEXT candidates retired to v1 archive",
      "commandInventory/officialCommandCount nullable: no completed T-SQL command enumeration is claimed",
      "workingDialect/decision/targetDefinition now owner-selected T-SQL/ADR-130/Microsoft"
    ],
    "readerContract": "Require schemaVersion2 and named required fields before consuming. Unknown schemas must be rejected, not treated as current PostgreSQL inventory or complete SQL. No runtime SQL/parser fallback is introduced.",
    "archive": {
      "path": "docs/implementation/sql-client-conformance-postgresql18.historical.json",
      "sha256": "c97b3e6dbe4d916cb70da6e1f997f22163d2492e6f168cd12002028a0e1a452f",
      "active": false,
      "reason": "Superseded PostgreSQL18 grammar and lexical candidates; original JSON bytes preserved"
    },
    "preserved": [
      "all15 SQLC family IDs",
      "fullSqlComplete false",
      "nativeClientProtocolQualified false",
      "original wire/Npgsql profile",
      "original historical evidence bytes"
    ]
  }
}