feat: upgrade to Python 3.12+ only support (#34)

* feat: upgrade to Python 3.12+ only support

- Update CI matrix to use Python 3.12 and 3.13 only
- Remove Python 3.10 and 3.11 support from all configurations
- Update pyproject.toml files to require Python >=3.12
- Update Black/Ruff target versions to py312
- Update all documentation to reflect Python 3.12+ requirement
- Fix numpy 2.3.4 compatibility issues with older Python versions

This resolves CI failures caused by numpy 2.3.4 not being available
for Python 3.10, and aligns with modern Python ecosystem requirements.

Breaking Change: Python 3.10 and 3.11 are no longer supported.
Users must upgrade to Python 3.12 or later.

* fix: resolve dependency conflict in requirements-dev.txt

- Update prompt-toolkit from 3.0.52 to 3.0.51 to resolve conflict with commitizen
- Regenerate requirements-dev.txt with pip-compile to ensure compatibility
- Fixes pre-push hook failure caused by dependency resolution conflicts

---------

Co-authored-by: Ben De Cock <[email protected]>

Author: VirtualAgentics

.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.10', '3.11', '3.12']
+        python-version: ['3.12', '3.13']
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
       - uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
@@ -53,7 +53,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.10', '3.11', '3.12']
+        python-version: ['3.12', '3.13']
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
       - uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0

README.md

@@ -16,7 +16,7 @@
 ![SAST: Semgrep](https://img.shields.io/badge/SAST-Semgrep-blue)
 
 <!-- Python & License -->
-![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)
+![Python Version](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue)
 ![License](https://img.shields.io/github/license/VirtualAgentics/ConextForge_memory)
 
 <!-- Repository Stats -->

clients/python/README.md

@@ -16,7 +16,7 @@ A robust Python client library for the ContextForge Memory API with comprehensiv
 
 ### Requirements
 
-- Python 3.10+
+- Python 3.12+
 - httpx (HTTP client library)
 
 ### Install Dependencies

clients/python/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "contextforge-memory-client"
-version = "0.1.0"
+version = "0.2.0"
 description = "Python client library for ContextForge Memory API"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.12"
 authors = [
     {name = "ContextForge Team", email = "[email protected]"}
 ]
@@ -19,9 +19,8 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
 ]
@@ -56,12 +55,12 @@ contextforge_memory_client = ["py.typed"]
 
 [tool.black]
 line-length = 88
-target-version = ["py310"]
+target-version = ["py312"]
 # Format all Python files by default; rely on .gitignore and excludes
 include = ".*\\.pyi?$"
 
 [tool.ruff]
-target-version = "py310"
+target-version = "py312"
 line-length = 88
 extend-exclude = [
     ".venv",

docs/ci-cd.md

@@ -75,7 +75,7 @@ The project uses GitHub Actions for continuous integration and deployment with a
 
 #### Main CI Features
 
-- **Matrix Strategy**: Tests across Python 3.10, 3.11, 3.12
+- **Matrix Strategy**: Tests across Python 3.12, 3.13
 - **Caching**: Custom pip cache action for faster builds
 - **Security**: Pinned pip version (25.2) for security (GHSA-4xh5-x5gv-qwph)
 - **Coverage**: 30% minimum coverage requirement

docs/deployment.md

@@ -4,7 +4,7 @@ This guide covers deploying the ContextForge Memory service in various environme
 
 ## Prerequisites
 
-- Python 3.10 or higher
+- Python 3.12 or higher
 - pip or pipx for package management
 - Docker (optional, for containerized deployment)
 - Systemd (for Linux service deployment)

docs/development.md

@@ -5,7 +5,7 @@ and efficiently.
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.12+
 - Git
 - Make (optional but recommended)
 

docs/renovate.md

@@ -47,8 +47,8 @@ Renovate PRs will auto-merge only if:
 
 **Required CI checks for auto-merge:**
 
-- `lint` (Python 3.10, 3.11, 3.12)
-- `test` (Python 3.10, 3.11, 3.12)
+- `lint` (Python 3.12, 3.13)
+- `test` (Python 3.12, 3.13)
 - `security`
 - `pre-commit`
 - `semgrep`

pyproject.toml

@@ -1,10 +1,10 @@
 [tool.black]
 line-length = 88
-target-version = ["py310"]
+target-version = ["py312"]
 include = "(src|clients/python|tests)/.*\\.py$"
 
 [tool.ruff]
-target-version = "py310"
+target-version = "py312"
 line-length = 88
 extend-exclude = [
   ".venv",
@@ -48,8 +48,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "contextforge-memory"
-version = "0.1.0"
+version = "0.2.0"
 description = "ContextForge Memory API"
+requires-python = ">=3.12"
 dependencies = [
   "numpy>=1.26.0",
   "fastapi>=0.115.0",

requirements-dev.txt

@@ -32,7 +32,7 @@ colorama==0.4.6
     # via commitizen
 commitizen==4.9.1
     # via -r requirements-dev.in
-cyclonedx-python-lib==11.3.0
+cyclonedx-python-lib==9.1.0
     # via pip-audit
 decli==0.6.3
     # via commitizen
@@ -64,8 +64,6 @@ mdurl==0.1.2
     # via markdown-it-py
 msgpack==1.1.2
     # via cachecontrol
-mypy==1.18.2
-    # via -r requirements-dev.in
 mypy-extensions==1.1.0
     # via black
 nodeenv==1.9.1
@@ -101,7 +99,7 @@ pluggy==1.6.0
     # via pytest
 pre-commit==4.3.0
     # via -r requirements-dev.in
-prompt-toolkit==3.0.52
+prompt-toolkit==3.0.51
     # via
     #   commitizen
     #   questionary
@@ -157,7 +155,7 @@ wcwidth==0.2.14
     # via prompt-toolkit
 wheel==0.45.1
     # via pip-tools
-wrapt==2.0.0
+wrapt==1.17.3
     # via deprecated
 
 # The following packages are considered to be unsafe in a requirements file: