feat(cli): add interactive TUI document picker, streamline client/config, and bump to v0.1.4-alpha

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "maxsimd"
-version = "0.1.3-alpha"
+version = "0.1.4-alpha"
 edition = "2024"
 homepage = "https://github.com/cmd-HMN"
 description = "This packages is the simd implementations of max sim function for faster calculation"
@@ -19,20 +19,15 @@ rust.unsafe_code = "allow"
 
 [dependencies]
 pyo3 = "0.29.0"
-rayon   = "1.10"
+rayon = "1.10"
 pyo3-stub-gen = "0.23.0"
 intel-mkl-src = { version = "0.8.1", optional = true, features = ["mkl-static-lp64-seq"] }
-libc = {version = "0.2", optional = true}
-# [dependencies.intel-mkl-src]
-# version = "0.8.1"
-# optional = true
+libc = { version = "0.2", optional = true }
 
 [dev-dependencies]
 criterion = "0.8.2"
-approx = "0.5"
 rand = "0.10.2"
 
-
 [[bin]]
 name = "stub"
 path = "rust-core/_bin/stub.rs"

README.md

@@ -107,6 +107,10 @@ rag_top_k: 3
 Launch the document indexing server. It will monitor `data/watch/` for new PDF files and automatically compute embeddings:
 
 ```bash
+# Using the bbq CLI command
+bbq server --config config.yaml
+
+# Or via Python module
 python -m bbq.src.main server --config config.yaml
 ```
 
@@ -115,14 +119,32 @@ python -m bbq.src.main server --config config.yaml
 Search indexed documents from the command line:
 
 ```bash
-# Query top 3 matching pages
-python -m bbq.src.main query "What was the operating margin in Q3?" --top-k 3
+# Fetch top 10 matching pages (prints ASCII BBQ banner on run)
+bbq client "What was the operating margin in Q3?"
+# Or: python -m bbq.src.main query "What was the operating margin in Q3?"
+
+# Fetch without ASCII logo banner
+bbq client --without-logo "What was the operating margin in Q3?"
 
-# Query with Gemini Multimodal RAG (generates grounded answer from top 3 page images)
+# Query with Gemini Multimodal LLM (displays live cooking spinner and multimodal answer)
 export GEMINI_API_KEY="your-gemini-api-key"
-python -m bbq.src.main query "Summarize the revenue growth" --top-k 3
+bbq client "Summarize the revenue growth" --use-llm
+
+# Continuous interactive query prompt loop (--infinite / -inf)
+bbq client --infinite
+# Or with LLM cooking enabled:
+bbq client --infinite --use-llm
+
+# Run directly via the client module
+python -m bbq.src.client --infinite --use-llm
 ```
 
+In `--infinite` mode, an interactive prompt (`bbq[query] >> `) appears for continuous querying:
+- Type any query to search.
+- Type `help` or `?` to show the commands menu.
+- Type `clear` or `cls` to clear the terminal screen.
+- Type `q`, `quit`, or `exit` (or `Ctrl+C`) to quit.
+
 If no Gemini API key is provided or the API is unavailable, the client automatically displays the matching document pages without crashing.
 
 ### 4. Python API Usage
@@ -207,7 +229,3 @@ We express our sincere thanks to the original authors and maintainers for their
 For full project lineage, paper citations, and intellectual property notices, see [ABOUT.md](ABOUT.md).
 
 ---
-
-## Disclaimer
-
-This project, its documentation, and parts of its codebase and benchmarks were developed with the assistance of AI tools. As an evolving early-stage project, this README and documentation may contain preliminary assumptions or specifications that are actively being refined. Future commits will continuously audit, validate, and update these details to ensure ongoing accuracy, correctness, and benchmarking rigor. No warranties or guarantees of fitness for a particular purpose are provided.

bbq/__init__.py

@@ -0,0 +1,5 @@
+"""BBQ package."""
+
+from bbq.src.common.version import __version__
+
+__all__ = ["__version__"]

bbq/maxsimd/__init__.pyi

@@ -47,4 +47,4 @@ def maxsim(
     **kwargs: typing.Any,
 ) -> builtins.list[builtins.float]: ...
 
-__version__ = "0.1.3-alpha"
+__version__ = "0.1.4-alpha"

bbq/src/client/__init__.py

@@ -1,5 +1,5 @@
 from bbq.src.client.client import BBQClient, get_local_pdf_page_image
 from bbq.src.client.gemini import GeminiClient
+from bbq.src.terminal.tui import print_bbq
 
-__all__ = ["BBQClient", "GeminiClient", "get_local_pdf_page_image"]
-
+__all__ = ["BBQClient", "GeminiClient", "get_local_pdf_page_image", "print_bbq"]