feat: add clean target to Makefile

- Add comprehensive clean target that removes build artifacts, cache files, and virtual environment
- Include clean in .PHONY declaration for reliable execution
- Clean target removes: dist/, build/, *.egg-info/, .coverage, .pytest_cache/, __pycache__ directories, *.pyc/*.pyo files, and .venv directory
- Provides user feedback during cleanup process

Author: AlmostBald-TRADING

.github/workflows/ci.yml

@@ -18,6 +18,13 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt', 'requirements-dev.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
@@ -35,6 +42,13 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt', 'requirements-dev.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
@@ -53,10 +67,18 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt', 'requirements-dev.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           pip install -r requirements.txt
+          pip install safety pip-audit
       - name: Security audit
         run: |
           safety scan --json > safety-results.json

Makefile

@@ -2,7 +2,16 @@
 VENV_PYTHON := .venv/bin/python
 VENV_PIP := .venv/bin/pip
 
-.PHONY: all venv setup run format lint smoke precommit test
+.PHONY: all venv setup run format lint smoke precommit test clean
+
+clean:
+	@echo "Cleaning generated artifacts and virtual environment..."
+	@rm -rf dist/ build/ *.egg-info/ .coverage .pytest_cache/
+	@find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
+	@find . -name "*.pyc" -delete 2>/dev/null || true
+	@find . -name "*.pyo" -delete 2>/dev/null || true
+	@rm -rf .venv
+	@echo "Clean complete."
 
 all: setup
 

clients/typescript/README.md

@@ -204,7 +204,7 @@ await client.v0Embed({
 
 **Returns:** `Promise<EmbedResponse>` with hash-based embeddings
 
-### v1 Endpoints (EPI key Required)
+### v1 Endpoints (API key Required)
 
 #### v1Store
 

docs/development.md

@@ -283,6 +283,7 @@ ruff check --select I --fix src clients/python tests
 
 ### Adding New Endpoints
 
+<!-- markdownlint-disable MD029 -->
 1. **Define Pydantic models** in `main.py`:
 
 ```python
@@ -314,6 +315,7 @@ def v1_new_endpoint(
 3. **Update OpenAPI spec** in `openapi/openapi-v1.yaml`
 
 4. **Add tests** in `tests/`
+<!-- markdownlint-enable MD029 -->
 
 ### Following API Design Rules
 

src/contextforge_memory/main.py

@@ -261,7 +261,7 @@ class EmbedResponse(BaseModel):
     "yes",
 }
 # Check if we're in testing mode
-TESTING_MODE = (
+TESTING_MODE: bool = (
     "pytest" in sys.modules or
     os.environ.get("TESTING", "").lower() in {"1", "true", "yes"}
 )