{
"freeze_id": "sqlrite-api-freeze-v1",
"schema_version": 1,
"status": "active",
"date": "2026-03-02",
"owners": [
"SQLRite core"
],
"cli": {
"command": "sqlrite",
"required_commands": [
"init",
"sql",
"ingest",
"query",
"quickstart",
"serve",
"grpc",
"mcp",
"backup",
"compact",
"benchmark",
"doctor"
],
"required_env_overrides": [
"SQLRITE_VECTOR_STORAGE",
"SQLRITE_ANN_MIN_CANDIDATES",
"SQLRITE_ANN_MAX_HAMMING_RADIUS",
"SQLRITE_ANN_MAX_CANDIDATE_MULTIPLIER",
"SQLRITE_ENABLE_ANN_PERSISTENCE",
"SQLRITE_SQLITE_MMAP_SIZE",
"SQLRITE_SQLITE_CACHE_SIZE_KIB"
]
},
"http_openapi": {
"openapi_version": "3.1.0",
"required_components": [
"QueryRequest",
"SqlRequest"
],
"required_paths": {
"/v1/openapi.json": [
"GET"
],
"/v1/query": [
"POST"
],
"/v1/sql": [
"POST"
],
"/grpc/sqlrite.v1.QueryService/Query": [
"POST"
],
"/grpc/sqlrite.v1.QueryService/Sql": [
"POST"
]
}
},
"grpc": {
"proto_path": "proto/sqlrite/v1/query_service.proto",
"package": "sqlrite.v1",
"service": "QueryService",
"required_methods": [
"Health",
"Query",
"Sql"
]
},
"mcp": {
"manifest_name": "sqlrite-mcp",
"auth_argument": "auth_token",
"auth_type": "static_token",
"transport": {
"type": "stdio",
"command": "sqlrite",
"args": [
"mcp"
]
},
"required_tools": [
"search",
"ingest",
"health",
"delete_by_metadata"
]
},
"compatibility_policy": {
"breaking_change_requires": [
"new contract freeze file",
"changelog compatibility note",
"migration documentation update"
],
"deprecation_window": "two minor releases"
}
}