refactor: rename project from iscc-vdb to iscc-search

Major refactoring to rename the project and better reflect its purpose
as a high-performance ISCC similarity search engine.

Changes:
- Rename package: iscc_vdb → iscc_search
- Update project name: iscc-vdb → iscc-search
- Update description: "Embedded Vector Database" → "High-performance ISCC similarity search engine"
- Update repository URL: github.com/iscc/iscc-vdb → github.com/iscc/iscc-search
- Update documentation URL: vdb.iscc.codes → search.iscc.codes
- Update CLI command: iscc-vdb → iscc-search
- Update all imports and references across codebase
- Update all documentation and configuration files

All 803 tests passing with 100% coverage.

Author: titusz

CLAUDE.md

@@ -4,8 +4,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-**iscc-vdb** is an Embedded Vector Database for ISCC (International Standard Content Code). In active
-development (v0.0.1), it provides high-performance vector similarity search for variable-length binary ISCC
+**iscc-search** is a high-performance ISCC similarity search engine for ISCC (International Standard Content Code).
+In active development (v0.0.1), it provides high-performance vector similarity search for variable-length binary ISCC
 vectors using the Normalized Prefix Hamming Distance (NPHD) metric. Built on top of usearch for fast approximate
 nearest neighbor search.
 
@@ -38,7 +38,7 @@ uv run poe all              # Format, test, and all checks
 
 The project structure follows standard Python packaging conventions:
 
-- `iscc_vdb/` - Main package directory
+- `iscc_search/` - Main package directory
     - `nphd.py` - NphdIndex class for ANNS with variable-length binary vectors
     - `metrics.py` - Custom NPHD metric implementation using Numba
 - `tests/` - Test files using pytest
@@ -51,13 +51,13 @@ The project structure follows standard Python packaging conventions:
 
 ### Core Components
 
-**NphdIndex** (`iscc_vdb/nphd.py`): Main index class that wraps usearch Index with:
+**NphdIndex** (`iscc_search/nphd.py`): Main index class that wraps usearch Index with:
 
 - Automatic vector padding/unpadding for variable-length ISCC vectors
 - NPHD metric configuration (binary vectors with length signal byte)
 - Supports 64-256 bit vectors (configurable via `max_dim` parameter)
 
-**Custom NPHD Metric** (`iscc_vdb/metrics.py`):
+**Custom NPHD Metric** (`iscc_search/metrics.py`):
 
 - Compiled Numba function for fast NPHD calculation
 - Handles variable-length vectors via length signal in first byte

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to `iscc-vdb`
+# Contributing to `iscc-search`
 
 Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be
 given.
@@ -9,7 +9,7 @@ You can contribute in many ways:
 
 ## Report Bugs
 
-Report bugs at https://github.com/iscc/iscc-vdb/issues
+Report bugs at https://github.com/iscc/iscc-search/issues
 
 If you are reporting a bug, please include:
 
@@ -29,12 +29,12 @@ whoever wants to implement it.
 
 ## Write Documentation
 
-iscc-vdb could always use more documentation, whether as part of the official docs, in docstrings, or even on
+iscc-search could always use more documentation, whether as part of the official docs, in docstrings, or even on
 the web in blog posts, articles, and such.
 
 ## Submit Feedback
 
-The best way to send feedback is to file an issue at https://github.com/iscc/iscc-vdb/issues.
+The best way to send feedback is to file an issue at https://github.com/iscc/iscc-search/issues.
 
 If you are proposing a new feature:
 
@@ -44,22 +44,22 @@ If you are proposing a new feature:
 
 # Get Started!
 
-Ready to contribute? Here's how to set up `iscc-vdb` for local development. Please note this documentation
+Ready to contribute? Here's how to set up `iscc-search` for local development. Please note this documentation
 assumes you already have `uv` and `Git` installed and ready to go.
 
-1. Fork the `iscc-vdb` repo on GitHub.
+1. Fork the `iscc-search` repo on GitHub.
 
 2. Clone your fork locally:
 
 ```bash
 cd <directory_in_which_repo_should_be_created>
-git clone git@github.com:YOUR_NAME/iscc-vdb.git
+git clone git@github.com:YOUR_NAME/iscc-search.git
 ```
 
 1. Now we need to install the environment. Navigate into the directory
 
 ```bash
-cd iscc-vdb
+cd iscc-search
 ```
 
 Then, install and activate the environment with:

Dockerfile

@@ -18,4 +18,4 @@ COPY . /app
 # Sync the project
 RUN uv sync --frozen
 
-CMD [ "python", "iscc_vdb/foo.py" ]
+CMD [ "python", "iscc_search/foo.py" ]

README.md

@@ -1,21 +1,21 @@
-# iscc-vdb
+# iscc-search
 
-[![Release](https://img.shields.io/github/v/release/iscc/iscc-vdb)](https://img.shields.io/github/v/release/iscc/iscc-vdb)
-[![Build status](https://img.shields.io/github/actions/workflow/status/iscc/iscc-vdb/main.yml?branch=main)](https://github.com/iscc/iscc-vdb/actions/workflows/main.yml?query=branch%3Amain)
-[![codecov](https://codecov.io/gh/iscc/iscc-vdb/branch/main/graph/badge.svg)](https://codecov.io/gh/iscc/iscc-vdb)
-[![Commit activity](https://img.shields.io/github/commit-activity/m/iscc/iscc-vdb)](https://img.shields.io/github/commit-activity/m/iscc/iscc-vdb)
-[![License](https://img.shields.io/github/license/iscc/iscc-vdb)](https://img.shields.io/github/license/iscc/iscc-vdb)
+[![Release](https://img.shields.io/github/v/release/iscc/iscc-search)](https://img.shields.io/github/v/release/iscc/iscc-search)
+[![Build status](https://img.shields.io/github/actions/workflow/status/iscc/iscc-search/main.yml?branch=main)](https://github.com/iscc/iscc-search/actions/workflows/main.yml?query=branch%3Amain)
+[![codecov](https://codecov.io/gh/iscc/iscc-search/branch/main/graph/badge.svg)](https://codecov.io/gh/iscc/iscc-search)
+[![Commit activity](https://img.shields.io/github/commit-activity/m/iscc/iscc-search)](https://img.shields.io/github/commit-activity/m/iscc/iscc-search)
+[![License](https://img.shields.io/github/license/iscc/iscc-search)](https://img.shields.io/github/license/iscc/iscc-search)
 
 > [!WARNING]
 > **This project is in early development and not ready for production use.**
 >
 > The API and features are subject to significant changes. Use at your own risk.
 
-High-performance embedded vector database for variable-length binary [ISCC](https://iscc.codes) codes with fast
+High-performance ISCC similarity search engine for variable-length binary [ISCC](https://iscc.codes) codes with fast
 approximate nearest neighbor search.
 
-- **Github repository**: <https://github.com/iscc/iscc-vdb/>
-- **Documentation** <https://vdb.iscc.codes/>
+- **Github repository**: <https://github.com/iscc/iscc-search/>
+- **Documentation** <https://search.iscc.codes/>
 
 ## Features
 
@@ -36,21 +36,21 @@ querying ISCC codes at scale.
 ## Installation
 
 ```bash
-pip install iscc-vdb
+pip install iscc-search
 ```
 
 For development installation:
 
 ```bash
-git clone https://github.com/iscc/iscc-vdb.git
-cd iscc-vdb
+git clone https://github.com/iscc/iscc-search.git
+cd iscc-search
 uv sync
 ```
 
 ## Quick Start
 
 ```python
-from iscc_vdb import NphdIndex
+from iscc_search import NphdIndex
 import numpy as np
 
 # Create index for up to 256-bit vectors
@@ -168,6 +168,8 @@ Contributions are welcome! Please ensure:
 - Coverage remains at 100%
 - Changes are documented
 
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
 ______________________________________________________________________
 
 Repository initiated with [fpgmaas/cookiecutter-uv](https://github.com/fpgmaas/cookiecutter-uv).

docs/architecture.md

@@ -23,10 +23,10 @@ CLI and REST API frontends to work seamlessly with different storage implementat
 │  │   CLI Package       │              │  Server Package      │         │
 │  │   (cli/)            │              │  (server/)           │         │
 │  │                     │              │                      │         │
-│  │  - iscc-vdb index   │              │  - FastAPI app       │         │
-│  │  - iscc-vdb add     │              │  - Route handlers    │         │
-│  │  - iscc-vdb search  │              │  - Error handling    │         │
-│  │  - iscc-vdb delete  │              │  - Sync endpoints    │         │
+│  │  - iscc-search index   │              │  - FastAPI app       │         │
+│  │  - iscc-search add     │              │  - Route handlers    │         │
+│  │  - iscc-search search  │              │  - Error handling    │         │
+│  │  - iscc-search delete  │              │  - Sync endpoints    │         │
 │  └──────────┬──────────┘              └──────────┬───────────┘         │
 │             │                                    │                     │
 │             └────────────────┬───────────────────┘                     │
@@ -142,7 +142,7 @@ indexes/
 ## Module Structure
 
 ```
-iscc_vdb/
+iscc_search/
 ├── __init__.py
 │
 ├── protocol.py              # IsccIndexProtocol definition
@@ -322,14 +322,14 @@ All methods are synchronous. Backends may use threading/connection pools interna
 export ISCC_VDB_INDEXES_URI=/path/to/index_data
 
 # CLI commands
-iscc-vdb create myindex
-iscc-vdb add myindex /data/
-iscc-vdb search myindex "ISCC:..."
-iscc-vdb list
-iscc-vdb delete myindex
+iscc-search create myindex
+iscc-search add myindex /data/
+iscc-search search myindex "ISCC:..."
+iscc-search list
+iscc-search delete myindex
 
 # Start API server with LMDB backend
-uvicorn iscc_vdb.server.app:app --host 0.0.0.0 --port 8000
+uvicorn iscc_search.server.app:app --host 0.0.0.0 --port 8000
 ```
 
 ### Memory Index (Testing)
@@ -339,12 +339,12 @@ uvicorn iscc_vdb.server.app:app --host 0.0.0.0 --port 8000
 export ISCC_VDB_INDEXES_URI=memory://
 
 # CLI works with in-memory storage (no persistence)
-iscc-vdb create myindex
-iscc-vdb add myindex /data/
-iscc-vdb search myindex "ISCC:..."
+iscc-search create myindex
+iscc-search add myindex /data/
+iscc-search search myindex "ISCC:..."
 
 # Start API server with in-memory index (for testing)
-uvicorn iscc_vdb.server.app:app --host 0.0.0.0 --port 8000
+uvicorn iscc_search.server.app:app --host 0.0.0.0 --port 8000
 ```
 
 ### Postgres Index (Future)
@@ -354,8 +354,8 @@ uvicorn iscc_vdb.server.app:app --host 0.0.0.0 --port 8000
 export ISCC_VDB_INDEXES_URI=postgresql://user:password@localhost/isccdb
 
 # CLI and server work the same way across all backends
-iscc-vdb create myindex
-uvicorn iscc_vdb.server.app:app --host 0.0.0.0 --port 8000
+iscc-search create myindex
+uvicorn iscc_search.server.app:app --host 0.0.0.0 --port 8000
 ```
 
 ## Key Benefits

docs/index.md

@@ -1,8 +1,8 @@
-# iscc-vdb
+# iscc-search
 
-[![Release](https://img.shields.io/github/v/release/iscc/iscc-vdb)](https://img.shields.io/github/v/release/iscc/iscc-vdb)
-[![Build status](https://img.shields.io/github/actions/workflow/status/iscc/iscc-vdb/main.yml?branch=main)](https://github.com/iscc/iscc-vdb/actions/workflows/main.yml?query=branch%3Amain)
-[![Commit activity](https://img.shields.io/github/commit-activity/m/iscc/iscc-vdb)](https://img.shields.io/github/commit-activity/m/iscc/iscc-vdb)
-[![License](https://img.shields.io/github/license/iscc/iscc-vdb)](https://img.shields.io/github/license/iscc/iscc-vdb)
+[![Release](https://img.shields.io/github/v/release/iscc/iscc-search)](https://img.shields.io/github/v/release/iscc/iscc-search)
+[![Build status](https://img.shields.io/github/actions/workflow/status/iscc/iscc-search/main.yml?branch=main)](https://github.com/iscc/iscc-search/actions/workflows/main.yml?query=branch%3Amain)
+[![Commit activity](https://img.shields.io/github/commit-activity/m/iscc/iscc-search)](https://img.shields.io/github/commit-activity/m/iscc/iscc-search)
+[![License](https://img.shields.io/github/license/iscc/iscc-search)](https://img.shields.io/github/license/iscc/iscc-search)
 
 Embedded Vector Database for ISCC

docs/modules.md

@@ -1,3 +1,3 @@
-::: iscc_vdb.metrics
+::: iscc_search.metrics
 
-::: iscc_vdb.nphd
+::: iscc_search.nphd

docs/spec.md

@@ -97,7 +97,7 @@ Index Entry:
 
 ### IsccStore Class
 
-**Module:** `iscc_vdb/store.py`
+**Module:** `iscc_search/store.py`
 
 The `IsccStore` class provides durable LMDB-backed storage for ISCC entries and metadata. It serves as the
 primary source of truth, with UnitIndex and InstanceIndex acting as derived indexes for search.
@@ -647,31 +647,31 @@ All Python API methods exposed as CLI commands:
 
 ```bash
 # Add single entry with auto-generated ISCC-ID
-iscc-vdb add --iscc-code "ISCC:KAC..."
+iscc-search add --iscc-code "ISCC:KAC..."
 
 # Add entry with explicit ISCC-ID
-iscc-vdb add --iscc-id "ISCC:IAA..." --iscc-code "ISCC:KAC..."
+iscc-search add --iscc-id "ISCC:IAA..." --iscc-code "ISCC:KAC..."
 
 # Add entry with pre-decomposed units
-iscc-vdb add --units "ISCC:GAA..." "ISCC:EAA..." "ISCC:IAA..."
+iscc-search add --units "ISCC:GAA..." "ISCC:EAA..." "ISCC:IAA..."
 
 # Add from JSON file (batch)
-iscc-vdb add --file entries.json
+iscc-search add --file entries.json
 
 # Get entry
-iscc-vdb get "ISCC:IAACBFKZG52UU"
+iscc-search get "ISCC:IAACBFKZG52UU"
 
 # Search
-iscc-vdb search --iscc-code "ISCC:KAC..." --count 10
-iscc-vdb search --units "ISCC:GAA..." "ISCC:EAA..." --count 5 --exact
+iscc-search search --iscc-code "ISCC:KAC..." --count 10
+iscc-search search --units "ISCC:GAA..." "ISCC:EAA..." --count 5 --exact
 
 # Remove
-iscc-vdb remove "ISCC:IAACBFKZG52UU"
+iscc-search remove "ISCC:IAACBFKZG52UU"
 
 # Index management
-iscc-vdb save
-iscc-vdb rebuild  # Rebuild indexes from primary storage
-iscc-vdb info  # Show index stats (size, unit_types, etc.)
+iscc-search save
+iscc-search rebuild  # Rebuild indexes from primary storage
+iscc-search info  # Show index stats (size, unit_types, etc.)
 ```
 
 ## REST API Interface

iscc_search/__init__.py

@@ -0,0 +1,16 @@
+"""High-performance ISCC similarity search engine."""
+
+from platformdirs import PlatformDirs
+from importlib import metadata
+
+__package_name__ = "iscc-search"
+__author__ = "iscc"
+__version__ = metadata.version(__package_name__)
+dirs = PlatformDirs(appname=__package_name__, appauthor=__author__)
+
+from iscc_search.settings import VdbSettings, vdb_settings  # noqa: E402
+from iscc_search.nphd import NphdIndex  # noqa: E402
+from iscc_search.unit import UnitIndex  # noqa: E402
+from iscc_search.instance import InstanceIndex  # noqa: E402
+
+__all__ = ["NphdIndex", "UnitIndex", "InstanceIndex", "VdbSettings", "vdb_settings"]