Update API tracking files for queryParamPushdown interfaces

Add new exported interfaces and test functions to API snapshot files:
- CountPushdown, FilterPushdown, OrderByPushdown, QueryParamPushdown,
  SelectPushdown, TopPushdown interfaces
- Test functions for pushdown configuration validation

Document new API additions in docs/future_api.md per CI requirements.

cicd/tools/api/exported_funcs.txt

@@ -184,9 +184,11 @@ func TestBasicAddressSpaceAWSCurrent
 func TestBasicAddressSpaceGoogleCurrent
 func TestBestEffortXMLStreamTransform
 func TestConfigDrivenAliasedAddressSpaceGoogleCurrent
+func TestCustomDialectConfig
 func TestDeepDiscoveryGoogleCurrent
 func TestDiscovery01
 func TestDiscoveryAWS
+func TestEmptySupportedColumns
 func TestFatConfigDrivenAliasedAddressSpaceGoogleCurrent
 func TestFragmentedResourcesFile
 func TestGet
@@ -211,10 +213,12 @@ func TestLocalTemplatedCompositeServiceFile
 func TestLocalValidateAndParseValidProviderFile
 func TestMeaningfulStreamTransform
 func TestMeaningfulXMLStreamTransform
+func TestMinimalODataConfig
 func TestMethodLevelVariableHostRoutingFutureProofed
 func TestMonolithicCompositeServiceFile
 func TestNewAddressSpace
 func TestNoFallbackViewApi
+func TestODataFullConfig
 func TestOpensslCertTextStreamTransform
 func TestPersistence01
 func TestPersistenceSetup
@@ -266,6 +270,7 @@ func TestValidateAndParseGoogleProviderFile
 func TestValidateAndParse_ValidJSON
 func TestVariableHostRouting
 func TestVariableHostRoutingFutureProofed
+func TestWildcardSupportedColumns
 func TestXMLMArshal
 func TestXMLRequestBody
 func TestXMLSchemaInterrogation

cicd/tools/api/exported_interfaces.txt

@@ -28,6 +28,7 @@ type ClientConfiguratorInput interface
 type Column interface
 type ColumnDescriptor interface
 type ControlAttributes interface
+type CountPushdown interface
 type DataFlowCfg interface
 type DiscoveryDoc interface
 type ExecContext interface
@@ -37,6 +38,7 @@ type Executor interface
 type ExpectedRequest interface
 type ExpectedResponse interface
 type FileValidator interface
+type FilterPushdown interface
 type GQLReader interface
 type GraphQL interface
 type HTTPArmoury interface
@@ -67,6 +69,7 @@ type ObjectWithLineage interface
 type ObjectWithLineageCollection interface
 type ObjectWithLineageCollectionConfig interface
 type ObjectWithoutLineage interface
+type OrderByPushdown interface
 type OpenAPIService interface
 type OperationInverse interface
 type OperationSelector interface
@@ -87,6 +90,7 @@ type Provider interface
 type ProviderService interface
 type ProviderServiceResourceAnalyzer interface
 type QueryElement interface
+type QueryParamPushdown interface
 type QueryTransposer interface
 type QueryVar interface
 type RDBMSSystem interface
@@ -103,6 +107,7 @@ type SQLEngine interface
 type SQLExternalColumn interface
 type SQLExternalConnection interface
 type SQLExternalTable interface
+type SelectPushdown interface
 type Schema interface
 type Service interface
 type SessionContext interface
@@ -118,6 +123,7 @@ type StreamTransformer interface
 type StreamTransformerFactory interface
 type Tabulation interface
 type TokenSemantic interface
+type TopPushdown interface
 type Transform interface
 type TransformerLocator interface
 type Transport interface

docs/future_api.md

@@ -77,3 +77,28 @@ New exported API is allowed only when:
   1. Update the API snapshot files.
   2. Update this document to justify the addition.
 
+## 5. Approved API Additions
+
+### 5.1 Query Parameter Pushdown (added 2025-11)
+
+**Purpose:** Enable SQL clause pushdown to API query parameters for OData and custom APIs.
+
+**New Interfaces (in `anysdk` package):**
+
+| Interface | Description |
+|-----------|-------------|
+| `QueryParamPushdown` | Root interface for accessing pushdown configuration |
+| `SelectPushdown` | Column projection (`$select`) configuration |
+| `FilterPushdown` | Row filtering (`$filter`) with operator/column restrictions |
+| `OrderByPushdown` | Ordering (`$orderby`) configuration |
+| `TopPushdown` | Row limit (`$top`) with optional max value |
+| `CountPushdown` | Count support (`$count`) configuration |
+
+**New Functions:**
+
+| Function | Description |
+|----------|-------------|
+| `GetTestingQueryParamPushdown` | Test helper for pushdown config validation |
+
+**Justification:** These interfaces extend `StackQLConfig` to support predicate pushdown, enabling efficient SQL-to-API translation for OData-compatible endpoints. They fit the Runtime Profile as configuration extensions for provider operations.
+