docs: v1.5.1 changelog, readme, architecture sanity pass

- CHANGELOG: add [1.5.1] section (dead code removal, complexity fixes, 360 tests)
- README: v1.5.1 badge, What's New in v1.5.1 patch section, test count 331->360
- Architecture.md: version v1.5.0->v1.5.1, test count 331->360, v1.5.1 feature line
- pyproject.toml + __init__.py: version 1.5.0 -> 1.5.1

Author: Flamehaven CI

CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.5.1] - 2026-04-18
+
+### Removed
+
+- **`engine/embedding_generator_legacy.py`**: Deleted. Identical API surface and
+  100% function overlap with `embedding_generator.py`; the file was never imported
+  by production code and represented 306 lines of dead duplicate code.
+
+### Refactored
+
+- **`engine/text_chunker.py`**: Extracted `_split_section()` and `_make_chunk()`
+  helpers from `chunk_text()` to reduce nesting depth and cyclomatic complexity.
+
+- **`engine/file_parser.py`**: Extracted `_extract_table_rows()` from
+  `_extract_pptx()` (nesting depth 5 → 3); split bare `except` clauses in
+  `_extract_doc()` into typed `FileNotFoundError` / `subprocess.TimeoutExpired`
+  handlers with proper log messages.
+
+- **`engine/gravitas_pack.py`**: Extracted `_estimate_field_reduction()` from
+  `estimate_compression_ratio()` to eliminate nested for-loops.
+
+- **`engine/chronos_grid.py`**: Extracted `_upsert_vector()` from
+  `inject_essence()` to collapse 4-level nesting.
+
+- **`usage_middleware.py`**: Extracted `_collect_exceeded_quotas()` module-level
+  helper to flatten nested loop inside `dispatch()`.
+
+- **`api.py`**: Extracted `_save_upload_file()` from `upload_multiple_files()`
+  to resolve critical nested_complexity (depth=4 + high cyclomatic complexity).
+
+### Tests
+
+- 360 tests pass (13 skipped) — 29 more than v1.5.0 (360 vs 331).
+- AI-Slop-Detector: **CLEAN** | critical deficits 7 → 0 | avg deficit score
+  13.46 → 11.25.
+- ruff: no issues.
+
+---
+
 ## [1.5.0] - 2026-04-16
 
 ### Added

README.md

@@ -7,7 +7,7 @@
 ### Self-hosted RAG search engine. Production-ready in 3 minutes.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.5.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.5.1-blue.svg)](CHANGELOG.md)
 [![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
 [![Docker](https://img.shields.io/badge/docker-ready-brightgreen.svg)](https://hub.docker.com/r/flamehaven/filesearch)
 
@@ -60,6 +60,12 @@ Open source & MIT licensed</p>
 - **⚡ Ultra-Fast Vectors** - DSP v2.0 algorithm generates embeddings in <1ms without ML frameworks
 - **🎯 Source Attribution** - Every answer includes links back to source documents
 
+### What's New in v1.5.1 (patch)
+
+- **Dead code removed** — `embedding_generator_legacy.py` deleted (306-line duplicate, unused)
+- **Code quality** — Critical nested_complexity eliminated in 6 files; avg slop-detector score 13.46 → 11.25
+- **Test suite expanded** — 360 tests (was 331); AI-Slop-Detector critical deficits 7 → 0
+
 ### What's New in v1.5.0
 
 - **Universal Document Parser** — 34 file formats, zero external document-AI dependency
@@ -290,7 +296,7 @@ security:
 </tr>
 <tr>
 <td>Test Suite</td>
-<td><code>331 tests</code></td>
+<td><code>360 tests</code></td>
 <td>All passing (pytest)</td>
 </tr>
 <tr>
@@ -479,7 +485,7 @@ Use the links below to jump to the most relevant guide.
 | [Document Parsing](docs/wiki/Document_Parsing.md) | Supported formats, internal parsers, RAG chunking |
 | [Framework Integrations](docs/wiki/Framework_Integrations.md) | LangChain, LlamaIndex, Haystack, CrewAI adapters |
 | [API Reference](docs/wiki/API_Reference.md) | REST endpoints, payloads, rate limits |
-| [Architecture](docs/wiki/Architecture.md) | How all layers fit together (v1.5.0) |
+| [Architecture](docs/wiki/Architecture.md) | How all layers fit together (v1.5.1) |
 | [Configuration Reference](docs/wiki/Configuration.md) | Full list of environment variables and config fields |
 | [Production Deployment](docs/wiki/Production_Deployment.md) | Docker, systemd, reverse proxy, scaling tips |
 | [Troubleshooting](docs/wiki/Troubleshooting.md) | Step-by-step debugging playbook |

docs/wiki/Architecture.md

@@ -1,13 +1,14 @@
 # Architecture Overview
 
 Flamehaven FileSearch balances simplicity with production-grade safeguards. This
-document describes the moving parts as of **v1.5.0**, featuring:
+document describes the moving parts as of **v1.5.1**, featuring:
 - **Gravitas DSP Engine** (v1.3.1+)
 - **Multimodal Search** (v1.4.0+)
 - **pgvector with HNSW** (v1.4.0+)
 - **Circuit Breaker & Health Checks** (v1.4.1+)
 - **ABC base classes, ruff CI, Windows filename fix** (v1.4.2)
 - **Universal Document Parser, Internal Chunker, Framework Integrations** (v1.5.0)
+- **Dead code removal, critical complexity fixes, 360-test suite** (v1.5.1)
 
 ---
 
@@ -84,7 +85,7 @@ The new **Chronos-Grid** integration handles high-speed vector storage and simil
 
 ## 6. Testing & Quality (v1.4.2)
 
-- **Test Framework**: `pytest` — 331 tests collected, all passing.
+- **Test Framework**: `pytest` — 360 tests collected, all passing.
 - **Lint**: `black` (format) + `ruff` (lint/unused imports) — both enforced in CI.
 - **Validation**: `validators.py` enforces security policies (Filename 200-char max, FileSize, SearchQuery XSS/SQLi checks).
 - **SIDRCE Certification**: Omega 0.9894 (S++) — AI-Slop-Detector P0-P5 clean.

flamehaven_filesearch/__init__.py

@@ -6,7 +6,7 @@
 Fast, simple, and transparent file search for developers
 """
 
-__version__ = "1.5.0"
+__version__ = "1.5.1"
 __author__ = "FLAMEHAVEN"
 __license__ = "MIT"
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flamehaven-filesearch"
-version = "1.5.0"
+version = "1.5.1"
 description = "FLAMEHAVEN FileSearch - Open source semantic document search with API authentication powered by Google Gemini"
 readme = "README.md"
 requires-python = ">=3.8"