nlp2sql 0.2.0rc13__tar.gz → 0.2.0rc14__tar.gz

nlp2sql-0.2.0rc14/.github/workflows/ci.yml

@@ -0,0 +1,84 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Set up Python 3.12
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - name: Install uv
+      run: python -m pip install uv
+
+    - name: Install dependencies
+      run: |
+        uv pip install --system .
+        uv pip install --system ".[dev]"
+
+    - name: Unit tests
+      env:
+        PYTHONPATH: src
+      run: pytest -m "not integration and not llm" -q
+
+  pgvector-integration:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: pgvector/pgvector:pg16
+        env:
+          POSTGRES_USER: testuser
+          POSTGRES_PASSWORD: testpass
+          POSTGRES_DB: testdb
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U testuser -d testdb"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Set up Python 3.12
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - name: Install uv
+      run: python -m pip install uv
+
+    - name: Install dependencies (with pgvector extra)
+      run: |
+        uv pip install --system ".[dev]"
+        uv pip install --system ".[pgvector]"
+
+    # Scoped to the pgvector adapter suite so the job is self-contained (the
+    # broader integration suite needs init-schema.sql / LocalStack Redshift,
+    # which are out of scope for this lane). NLP2SQL_REQUIRE_INTEGRATION makes
+    # the fixtures FAIL instead of skip, so a misconfigured service goes red
+    # rather than green-via-skip (collection != execution).
+    - name: pgvector integration tests
+      env:
+        PYTHONPATH: src
+        NLP2SQL_REQUIRE_INTEGRATION: "1"
+        NLP2SQL_TEST_POSTGRES_HOST: localhost
+        NLP2SQL_TEST_POSTGRES_PORT: "5432"
+        NLP2SQL_TEST_POSTGRES_USER: testuser
+        NLP2SQL_TEST_POSTGRES_PASS: testpass
+        NLP2SQL_TEST_POSTGRES_DB: testdb
+      run: pytest tests/test_pgvector_example_repository.py -m integration -q

{nlp2sql-0.2.0rc13 → nlp2sql-0.2.0rc14}/.gitignore

@@ -176,6 +176,7 @@ query_cache.db
 !README.md
 !CONTRIBUTING.md
 !SECURITY.md
+!CHANGELOG.md
 !docs/*.md
 !**/README.md
 !.github/**/*.md

nlp2sql-0.2.0rc14/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Versioning policy
+
+- **MAJOR** — incompatible public API changes (removing/renaming a public symbol
+  or changing a port/ABC contract in a non-backward-compatible way).
+- **MINOR** — backward-compatible functionality (new adapters, new optional
+  parameters, new optional extras).
+- **PATCH** — backward-compatible bug fixes.
+
+Pre-1.0 the project ships release candidates (e.g. `0.2.0rcN`). Public surface
+changes — moving/renaming exported symbols, or adding methods to a published
+port such as `ExampleRepositoryPort` — MUST be recorded under `Unreleased`
+before release and called out as **Breaking** if they affect external
+implementers. Backward-compatible shims are preferred over hard breaks while
+pre-1.0.
+
+## [Unreleased]
+
+## [0.2.0rc14] - 2026-09-16
+
+### Added
+- `PgvectorExampleRepository`: a Postgres + `pgvector` implementation of
+  `ExampleRepositoryPort`, an alternative to the on-disk FAISS `ExampleStore`
+  for storing and semantically searching few-shot examples. Stores examples in
+  a single table with a `namespace` column (per-database isolation via
+  `md5(database_url:schema_name)`, byte-identical to `ExampleStore`), cosine
+  distance search over an HNSW index, and idempotent `auto_migrate` DDL.
+- Optional `pgvector` extra: `pip install 'nlp2sql[pgvector]'`.
+- CI: a `pgvector-integration` job that runs the adapter's integration tests
+  against a `pgvector/pgvector:pg16` service. The job fails (rather than skips)
+  when the database or `vector` extension is unavailable
+  (`NLP2SQL_REQUIRE_INTEGRATION`).
+
+### Changed
+- `docker/docker-compose.yml`: the `postgres` service image is now
+  `pgvector/pgvector:pg16` (drop-in replacement for `postgres:16`, adds the
+  `vector` extension) so integration tests run out of the box.

{nlp2sql-0.2.0rc13 → nlp2sql-0.2.0rc14}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: nlp2sql
-Version: 0.2.0rc13
+Version: 0.2.0rc14
 Summary: Enterprise-ready Natural Language to SQL converter with multi-provider support. Built for production scale (1000+ tables) with Clean Architecture.
 Project-URL: Homepage, https://github.com/luiscarbonel1991/nlp2sql
 Project-URL: Bug Tracker, https://github.com/luiscarbonel1991/nlp2sql/issues
@@ -74,6 +74,8 @@ Requires-Dist: mysql-connector-python>=8.0.0; extra == 'mysql'
 Requires-Dist: pymysql>=1.1.0; extra == 'mysql'
 Provides-Extra: oracle
 Requires-Dist: oracledb>=2.0.0; extra == 'oracle'
+Provides-Extra: pgvector
+Requires-Dist: pgvector>=0.2.5; extra == 'pgvector'
 Description-Content-Type: text/markdown
 
 <p align="center">

{nlp2sql-0.2.0rc13 → nlp2sql-0.2.0rc14}/docker/docker-compose.yml

@@ -1,6 +1,6 @@
 services:
   postgres:
-    image: postgres:${POSTGRES_VERSION:-16}
+    image: pgvector/pgvector:pg${POSTGRES_VERSION:-16}
     container_name: ${SIMPLE_CONTAINER_NAME:-nlp2sql-postgres}
     environment:
       POSTGRES_USER: ${SIMPLE_DB_USER:-testuser}

{nlp2sql-0.2.0rc13 → nlp2sql-0.2.0rc14}/mcp_server/__init__.py

@@ -1,3 +1,3 @@
 """nlp2sql MCP Server - Expose nlp2sql as MCP tools."""
 
-__version__ = "0.2.0rc6"
+__version__ = "0.2.0rc14"

{nlp2sql-0.2.0rc13 → nlp2sql-0.2.0rc14}/mcp_server/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nlp2sql-mcp"
-version = "0.1.0"
+version = "0.2.0rc14"
 description = "MCP server for nlp2sql - Natural Language to SQL conversion"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -21,4 +21,4 @@ build-backend = "hatchling.build"
 [tool.mcp]
 name = "nlp2sql"
 description = "Convert natural language queries to SQL using multiple AI providers"
-version = "0.1.0"
+version = "0.2.0rc14"

{nlp2sql-0.2.0rc13 → nlp2sql-0.2.0rc14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nlp2sql"
-version = "0.2.0rc13"
+version = "0.2.0rc14"
 description = "Enterprise-ready Natural Language to SQL converter with multi-provider support. Built for production scale (1000+ tables) with Clean Architecture."
 readme = "README.md"
 license = {text = "MIT"}
@@ -57,6 +57,7 @@ all-providers = ["anthropic>=0.18.0", "google-generativeai>=0.3.0"]
 embeddings-local = ["sentence-transformers>=2.5.0"]
 embeddings-openai = []
 all-embeddings = ["sentence-transformers>=2.5.0"]
+pgvector = ["pgvector>=0.2.5"]
 dev = [
     "pytest>=7.4.0",
     "pytest-asyncio>=0.21.0",

{nlp2sql-0.2.0rc13 → nlp2sql-0.2.0rc14}/src/nlp2sql/__init__.py

@@ -46,7 +46,7 @@ from .ports.semantic_validator import SemanticValidatorPort
 from .schema.example_store import ExampleStore
 from .services.query_service import QueryGenerationService
 
-__version__ = "0.2.0rc13"
+__version__ = "0.2.0rc14"
 __author__ = "Luis Carbonel"
 __email__ = "devhighlevel@gmail.com"
 

{nlp2sql-0.2.0rc13 → nlp2sql-0.2.0rc14}/src/nlp2sql/adapters/__init__.py

@@ -7,3 +7,11 @@ __all__ = [
     "LocalEmbeddingAdapter",
     "OpenAIEmbeddingAdapter",
 ]
+
+# Optional: pgvector-backed example repository (requires the [pgvector] extra)
+try:
+    from .pgvector_example_repository import PgvectorExampleRepository
+except ImportError:
+    pass
+else:
+    __all__.append("PgvectorExampleRepository")