Simplify API: Remove book/testament filters, search entire Bible by default

- Remove books and testament optional parameters from SearchRequest
- Always search all 66 books (Old and New Testament)
- Update all documentation to reflect simplified API
- Remove Book Abbreviations section from README
- Update all code examples to use only query and limit parameters

API_DOCUMENTATION.md

@@ -65,15 +65,13 @@ curl https://dssjon-biblos-api.hf.space/health
 
 **POST /search**
 
-Perform semantic search over Bible text.
+Perform semantic search over the entire Bible (both Old and New Testament).
 
 #### Request Body
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
 | `query` | string | Yes | Search query text (1-500 chars) |
-| `books` | array[string] | No | Filter by book abbreviations |
-| `testament` | string | No | Filter by testament: "old" or "new" |
 | `limit` | integer | No | Number of results (1-100, default: 10) |
 
 #### Response
@@ -95,9 +93,8 @@ Perform semantic search over Bible text.
 }
 ```
 
-#### Examples
+#### Example
 
-##### Basic Search
 ```bash
 curl -X POST https://dssjon-biblos-api.hf.space/search \
   -H "Content-Type: application/json" \
@@ -107,45 +104,6 @@ curl -X POST https://dssjon-biblos-api.hf.space/search \
   }'
 ```
 
-##### Search by Testament
-```bash
-curl -X POST https://dssjon-biblos-api.hf.space/search \
-  -H "Content-Type: application/json" \
-  -d '{
-    "query": "love your enemies",
-    "testament": "new",
-    "limit": 10
-  }'
-```
-
-##### Search Specific Books
-```bash
-curl -X POST https://dssjon-biblos-api.hf.space/search \
-  -H "Content-Type: application/json" \
-  -d '{
-    "query": "the beginning",
-    "books": ["gen", "jhn"],
-    "limit": 5
-  }'
-```
-
----
-
-## Book Abbreviations
-
-### Old Testament (39 books)
-```
-gen, exo, lev, num, deu, jos, jdg, rut, 1sa, 2sa, 1ki, 2ki, 1ch, 2ch,
-ezr, neh, est, job, psa, pro, ecc, sng, isa, jer, lam, ezk, dan, hos,
-jol, amo, oba, jon, mic, nam, hab, zep, hag, zec, mal
-```
-
-### New Testament (27 books)
-```
-mat, mrk, luk, jhn, act, rom, 1co, 2co, gal, eph, php, col, 1th, 2th,
-1ti, 2ti, tit, phm, heb, jas, 1pe, 2pe, 1jn, 2jn, 3jn, jud, rev
-```
-
 ---
 
 ## Integration Examples
@@ -154,7 +112,7 @@ mat, mrk, luk, jhn, act, rom, 1co, 2co, gal, eph, php, col, 1th, 2th,
 
 #### Basic Fetch
 ```javascript
-async function searchBible(query, options = {}) {
+async function searchBible(query, limit = 10) {
   const response = await fetch('https://dssjon-biblos-api.hf.space/search', {
     method: 'POST',
     headers: {
@@ -162,7 +120,7 @@ async function searchBible(query, options = {}) {
     },
     body: JSON.stringify({
       query,
-      ...options
+      limit
     })
   })
 
@@ -174,10 +132,7 @@ async function searchBible(query, options = {}) {
 }
 
 // Usage
-const results = await searchBible('love one another', {
-  testament: 'new',
-  limit: 5
-})
+const results = await searchBible('love one another', 5)
 
 console.log(results)
 ```
@@ -186,12 +141,6 @@ console.log(results)
 ```typescript
 import { useState, useCallback } from 'react'
 
-interface SearchOptions {
-  books?: string[]
-  testament?: 'old' | 'new'
-  limit?: number
-}
-
 interface SearchResult {
   book: string
   chapter: number
@@ -206,7 +155,7 @@ export function useBibleSearch() {
 
   const search = useCallback(async (
     query: string,
-    options?: SearchOptions
+    limit: number = 10
   ): Promise<SearchResult[]> => {
     setLoading(true)
     setError(null)
@@ -215,7 +164,7 @@ export function useBibleSearch() {
       const response = await fetch('https://dssjon-biblos-api.hf.space/search', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ query, ...options })
+        body: JSON.stringify({ query, limit })
       })
 
       if (!response.ok) {
@@ -242,7 +191,7 @@ function SearchComponent() {
   const [results, setResults] = useState([])
 
   const handleSearch = async (query: string) => {
-    const results = await search(query, { limit: 10 })
+    const results = await search(query, 10)
     setResults(results)
   }
 
@@ -260,14 +209,12 @@ function SearchComponent() {
 ```python
 import requests
 
-def search_bible(query, books=None, testament=None, limit=10):
+def search_bible(query, limit=10):
     """
     Search the Bible using semantic search
 
     Args:
         query: Search query text
-        books: Optional list of book abbreviations
-        testament: Optional filter ('old' or 'new')
         limit: Number of results to return
 
     Returns:
@@ -280,11 +227,6 @@ def search_bible(query, books=None, testament=None, limit=10):
         'limit': limit
     }
 
-    if books:
-        payload['books'] = books
-    if testament:
-        payload['testament'] = testament
-
     response = requests.post(url, json=payload)
     response.raise_for_status()
 
@@ -293,7 +235,6 @@ def search_bible(query, books=None, testament=None, limit=10):
 # Usage
 results = search_bible(
     query='faith and works',
-    testament='new',
     limit=5
 )
 
@@ -309,11 +250,11 @@ for result in results['results']:
 import asyncio
 import aiohttp
 
-async def search_bible_async(query, **kwargs):
+async def search_bible_async(query, limit=10):
     """Async version of Bible search"""
     url = 'https://dssjon-biblos-api.hf.space/search'
 
-    payload = {'query': query, **kwargs}
+    payload = {'query': query, 'limit': limit}
 
     async with aiohttp.ClientSession() as session:
         async with session.post(url, json=payload) as response:
@@ -322,11 +263,7 @@ async def search_bible_async(query, **kwargs):
 
 # Usage
 async def main():
-    results = await search_bible_async(
-        'love your neighbor',
-        testament='new',
-        limit=5
-    )
+    results = await search_bible_async('love your neighbor', limit=5)
     print(results)
 
 asyncio.run(main())
@@ -336,16 +273,6 @@ asyncio.run(main())
 
 ### cURL
 
-#### Basic Search
-```bash
-curl -X POST https://dssjon-biblos-api.hf.space/search \
-  -H "Content-Type: application/json" \
-  -d '{
-    "query": "blessed are the peacemakers"
-  }'
-```
-
-#### Pretty Print with jq
 ```bash
 curl -X POST https://dssjon-biblos-api.hf.space/search \
   -H "Content-Type: application/json" \
@@ -415,7 +342,7 @@ async function safeSearch(query) {
 2. **Debounce** search queries to reduce API calls
 3. **Implement pagination** for large result sets
 4. **Use appropriate limits** - higher limits increase response time
-5. **Filter by books/testament** when possible to reduce search space
+5. **The API searches the entire Bible** (both Old and New Testament) for comprehensive results
 
 ### Rate Limiting
 Currently no rate limiting is enforced, but please use responsibly:

README.md

@@ -16,7 +16,7 @@ Semantic search over the entire Bible using BGE-large embeddings. This API keeps
 
 - ✅ Fast semantic search with BGE-large-en-v1.5 embeddings
 - ✅ Model stays loaded in memory (no cold starts)
-- ✅ Search by testament (Old/New) or specific books
+- ✅ Searches entire Bible (Old and New Testament)
 - ✅ CORS enabled for easy integration
 - ✅ RESTful JSON API with FastAPI
 - ✅ Automatic API documentation at `/docs`
@@ -36,9 +36,7 @@ Perform semantic search
 ```json
 {
   "query": "What did Jesus say about love?",
-  "books": ["mat", "jhn"],  // Optional: filter by books
-  "testament": "new",        // Optional: "old" or "new"
-  "limit": 10               // Optional: results to return (1-100)
+  "limit": 10  // Optional: results to return (1-100, default: 10)
 }
 ```
 
@@ -60,12 +58,6 @@ Perform semantic search
 }
 ```
 
-## Book Abbreviations
-
-**Old Testament:** gen, exo, lev, num, deu, jos, jdg, rut, 1sa, 2sa, 1ki, 2ki, 1ch, 2ch, ezr, neh, est, job, psa, pro, ecc, sng, isa, jer, lam, ezk, dan, hos, jol, amo, oba, jon, mic, nam, hab, zep, hag, zec, mal
-
-**New Testament:** mat, mrk, luk, jhn, act, rom, 1co, 2co, gal, eph, php, col, 1th, 2th, 1ti, 2ti, tit, phm, heb, jas, 1pe, 2pe, 1jn, 2jn, 3jn, jud, rev
-
 ## Quick Start
 
 ### Using cURL
@@ -74,7 +66,6 @@ curl -X POST https://dssjon-biblos-api.hf.space/search \
   -H "Content-Type: application/json" \
   -d '{
     "query": "faith and works",
-    "testament": "new",
     "limit": 5
   }'
 ```
@@ -86,7 +77,6 @@ const response = await fetch('https://dssjon-biblos-api.hf.space/search', {
   headers: { 'Content-Type': 'application/json' },
   body: JSON.stringify({
     query: 'faith and works',
-    testament: 'new',
     limit: 5
   })
 })
@@ -103,7 +93,6 @@ response = requests.post(
     'https://dssjon-biblos-api.hf.space/search',
     json={
         'query': 'faith and works',
-        'testament': 'new',
         'limit': 5
     }
 )

app.py

@@ -39,8 +39,6 @@ app.add_middleware(
 # Request/Response models
 class SearchRequest(BaseModel):
     query: str = Field(..., description="Search query text", min_length=1, max_length=500)
-    books: Optional[List[str]] = Field(None, description="Filter by book abbreviations (e.g., ['gen', 'mat', 'jhn'])")
-    testament: Optional[str] = Field(None, description="Filter by testament: 'old' or 'new'")
     limit: int = Field(10, description="Number of results to return", ge=1, le=100)
 
 class SearchResult(BaseModel):
@@ -202,11 +200,9 @@ async def health_check():
 @app.post("/search", response_model=SearchResponse)
 async def search(request: SearchRequest):
     """
-    Perform semantic search over Bible text
+    Perform semantic search over the entire Bible (both Old and New Testament)
 
     - **query**: The search query text
-    - **books**: Optional list of book abbreviations to search within
-    - **testament**: Optional filter by 'old' or 'new' testament
     - **limit**: Number of results to return (1-100)
     """
     import time
@@ -225,25 +221,8 @@ async def search(request: SearchRequest):
         logger.info(f"Generating embedding for query: {request.query[:50]}...")
         query_embedding = generate_embedding(request.query)
 
-        # Determine which books to search
-        books_to_search = []
-        if request.books:
-            # Use specified books
-            books_to_search = [b.lower() for b in request.books if b.lower() in bible_embeddings]
-        elif request.testament:
-            # Filter by testament
-            if request.testament.lower() == "old":
-                books_to_search = [b for b in OLD_TESTAMENT_BOOKS if b in bible_embeddings]
-            elif request.testament.lower() == "new":
-                books_to_search = [b for b in NEW_TESTAMENT_BOOKS if b in bible_embeddings]
-            else:
-                raise HTTPException(status_code=400, detail="testament must be 'old' or 'new'")
-        else:
-            # Search all books
-            books_to_search = list(bible_embeddings.keys())
-
-        if not books_to_search:
-            raise HTTPException(status_code=400, detail="No valid books to search")
+        # Search all books (both Old and New Testament)
+        books_to_search = list(bible_embeddings.keys())
 
         # Collect all results
         all_results = []