bijux-vex 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

bijux_vex/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.2.0'
-__version_tuple__ = version_tuple = (0, 2, 0)
+__version__ = version = '0.2.2'
+__version_tuple__ = version_tuple = (0, 2, 2)
 
 __commit_id__ = commit_id = None

{bijux_vex-0.2.0.dist-info → bijux_vex-0.2.2.dist-info}/METADATA

@@ -1,17 +1,38 @@
 Metadata-Version: 2.4
 Name: bijux-vex
-Version: 0.2.0
+Version: 0.2.2
 Summary: Vector execution runtime with replayable determinism and audited ANN (nothing implicit).
-Project-URL: Homepage, https://bijux.github.io/bijux-vex/
+Project-URL: Homepage, https://github.com/bijux/bijux-vex
+Project-URL: Repository, https://github.com/bijux/bijux-vex.git
+Project-URL: Bug Tracker, https://github.com/bijux/bijux-vex/issues
 Project-URL: Documentation, https://bijux.github.io/bijux-vex/
-Project-URL: Source, https://github.com/bijux/bijux-vex
-Project-URL: Issues, https://github.com/bijux/bijux-vex/issues
-Project-URL: Changelog, https://github.com/bijux/bijux-vex/blob/main/CHANGELOG.md
+Project-URL: Changelog, https://bijux.github.io/bijux-vex/changelog
+Project-URL: Discussions, https://github.com/bijux/bijux-vex/discussions
 Project-URL: Security, https://github.com/bijux/bijux-vex/blob/main/SECURITY.md
 Project-URL: Funding, https://github.com/sponsors/bijux
 Author-email: Bijan Mousavi <mousavi.bijan@gmail.com>
 Maintainer-email: Bijan Mousavi <mousavi.bijan@gmail.com>
-License: MIT
+License: MIT License
+        
+        Copyright (c) 2025 Bijan Mousavi
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
 License-File: LICENSE
 Keywords: ann,audit,bijux,determinism,execution,nearest-neighbor,provenance,replay,reproducibility,vector,vector-search,vex
 Classifier: Development Status :: 4 - Beta
@@ -100,77 +121,51 @@ Requires-Dist: numpy<3.0,>=1.26; extra == 'vdb'
 Requires-Dist: qdrant-client<2.0,>=1.9.0; extra == 'vdb'
 Description-Content-Type: text/markdown
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/bijux/bijux-vex/main/docs/assets/bijux_logo_hq.png" alt="Bijux-Vex" width="180" />
-</p>
+# bijux-vex — explicit vector execution
 
-# bijux-vex
+[![PyPI - Version](https://img.shields.io/pypi/v/bijux-vex.svg)](https://pypi.org/project/bijux-vex/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
+[![Typing: typed (PEP 561)](https://img.shields.io/badge/typing-typed-4F8CC9.svg)](https://peps.python.org/pep-0561/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/bijux/bijux-vex/raw/main/LICENSES/MIT.txt)
+[![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-brightgreen)](https://bijux.github.io/bijux-vex/)
+[![CI Status](https://github.com/bijux/bijux-vex/actions/workflows/ci.yml/badge.svg)](https://github.com/bijux/bijux-vex/actions)
 
-**Vector execution runtime with replayable determinism + audited ANN (nothing implicit).**
+**What it is**  
+Bijux‑Vex is a vector execution runtime with replayable determinism and audited ND (ANN).
 
-Why this exists: production vector search drifts quietly. Bijux‑Vex makes correctness explicit, and refuses when guarantees cannot be met.
+**Why it exists**  
+Production vector search drifts quietly. Bijux‑Vex makes correctness explicit and refuses when guarantees cannot be met.
 
-If you only read one page, read this: https://bijux.github.io/bijux-vex/user/only_read_one_page/
+**Anti‑goals**  
+Not a vector DB. Not a RAG framework. Not a hosted service. No implicit “best‑effort” correctness.
 
-## Why bijux-vex
-
-- Replayable determinism for results you can defend
-- Audited, bounded ND (ANN) instead of silent approximation
-- Nothing implicit: fail‑closed by design
-
-## Hello world (deterministic, exact)
+## Quickstart (deterministic)
 
 ```bash
-bijux vex ingest --doc "hello" --vector "[0.0, 1.0, 0.0]" \
+python -m bijux_vex.boundaries.cli.app ingest --doc "hello" --vector "[0,1,0]" --vector-store memory
+python -m bijux_vex.boundaries.cli.app materialize --execution-contract deterministic --vector-store memory
+python -m bijux_vex.boundaries.cli.app execute --vector "[0,1,0]" \
+  --execution-contract deterministic \
+  --execution-intent exact_validation \
   --vector-store memory
-bijux vex materialize --execution-contract deterministic --vector-store memory
-bijux vex execute --artifact-id art-1 \
-  --execution-contract deterministic --execution-intent exact_validation \
-  --execution-mode strict --vector "[0.0, 1.0, 0.0]"
-```
-
-## Hello world (ND / ANN with quality)
-
-```bash
-bijux vex materialize --execution-contract non_deterministic --index-mode ann \
-  --vector-store faiss --vector-store-uri ./index.faiss
-bijux vex execute --artifact-id art-1 \
-  --execution-contract non_deterministic --execution-intent exploratory_search \
-  --execution-mode bounded --randomness-seed 42 --randomness-sources ann_probe \
-  --nd-witness sample --vector "[0.0, 1.0, 0.0]"
 ```
 
-## Concept map (instant mental model)
-
-```
-request → plan → execute → provenance
-            ├─ deterministic (exact)
-            └─ ND (ANN) + quality
-vector store: optional + explicit
-```
-
-## When NOT to use this
-
-- Not a vector DB (no implicit CRUD or query language)
-- Not a RAG framework (no prompts, no orchestration)
-- Not a hosted service (you run it)
-
-## Stability & support
+## Start Here
 
-- Supported Python: 3.11–3.14
-- Determinism: stable and replayable
-- ND (ANN): experimental but audited and bounded
+- Start here (10 minutes): https://bijux.github.io/bijux-vex/user/start_here_10_minutes/
+- Start here (human): https://bijux.github.io/bijux-vex/user/start_here_human/
+- Start here (canonical doc): `docs/user/start_here.md`
+- Why Bijux‑Vex exists: https://bijux.github.io/bijux-vex/user/why_bijux_vex_exists/
+- Docs home: https://bijux.github.io/bijux-vex/
 
-## Getting help / reporting issues
+## Production readiness (explicit)
 
-GitHub issues: https://github.com/bijux/bijux-vex/issues
-Include `bijux vex debug-bundle` output when reporting a bug.
+- Determinism enforced and replayable
+- ND is bounded and audited
+- CI gates required before release
 
-## Quick links
+## Project values
 
-- Start Here (10 minutes): https://bijux.github.io/bijux-vex/user/start_here_10_minutes/
-- Start Here (human): https://bijux.github.io/bijux-vex/user/start_here_human/
-- Concept Map: https://bijux.github.io/bijux-vex/user/concept_map/
-- ND Production Guide: https://bijux.github.io/bijux-vex/guides/nd_production/
-- Security Policy: https://github.com/bijux/bijux-vex/blob/main/SECURITY.md
-- Changelog: https://github.com/bijux/bijux-vex/blob/main/CHANGELOG.md
+- Correctness over convenience
+- Explicit over implicit
+- Honest failure over silent success

bijux_vex-0.2.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+bijux_vex/_version.py,sha256=o3ZTescp-19Z9cvBGq9dQnbppljgzdUYUf98Nov0spY,704
+bijux_vex/py.typed,sha256=NU-OYcV83NloaV7vtRk0bk8kc64u5PuiDkBRJwvHkBE,107
+bijux_vex-0.2.2.dist-info/METADATA,sha256=EQbOh3-Qx6g-Rb5SsfFIyzigjaBwkn2_erO2IDuVzEI,8590
+bijux_vex-0.2.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+bijux_vex-0.2.2.dist-info/entry_points.txt,sha256=CvD_SRleGRmZJp49y1VMy-GpVh4KPse0kW7JLGyE26g,234
+bijux_vex-0.2.2.dist-info/licenses/LICENSE,sha256=JtT2Sv8_KhmjvSaHKZVexlCuwWiKuqtNOVY-xolsRAo,1070
+bijux_vex-0.2.2.dist-info/RECORD,,

{bijux_vex-0.2.0.dist-info → bijux_vex-0.2.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.28.0
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any

bijux_vex-0.2.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-bijux_vex/_version.py,sha256=Dg8AmJomLVpjKL6prJylOONZAPRtB86LOce7dorQS_A,704
-bijux_vex/py.typed,sha256=NU-OYcV83NloaV7vtRk0bk8kc64u5PuiDkBRJwvHkBE,107
-bijux_vex-0.2.0.dist-info/METADATA,sha256=fWey2D5rziRBn-c_MKOFx4uiXI8429kYnwUTqIeIAbg,7773
-bijux_vex-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-bijux_vex-0.2.0.dist-info/entry_points.txt,sha256=CvD_SRleGRmZJp49y1VMy-GpVh4KPse0kW7JLGyE26g,234
-bijux_vex-0.2.0.dist-info/licenses/LICENSE,sha256=JtT2Sv8_KhmjvSaHKZVexlCuwWiKuqtNOVY-xolsRAo,1070
-bijux_vex-0.2.0.dist-info/RECORD,,