chore: track all files from merged branches (codex, framewerx, readme-showcase)

Author: FAST26 Developer

.gitignore

@@ -4,7 +4,12 @@ VXUG-Papers/
 libqihse.so
 *.o
 *.gch
+*.png
+*.pyc
+__pycache__/
 test_*
 !test_*.c
 tests/qihse_*_test
 !tests/qihse_*_test.c
+qihse_benchmark
+qihse_benchmark_*

LICENSE

@@ -1,3 +1,67 @@
+================================================================================
+                          NOTICE: COMMERCIAL COMPLIANCE POLICY
+================================================================================
+
+QIHSE is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
+This license is INTENTIONALLY STRONG COPYLEFT. Read it carefully.
+
+TECHNICAL SHOWCASE STATUS
+-------------------------
+This repository is published as a technical demonstration of quantum-inspired
+vector search architecture. You are welcome to study, evaluate, and experiment
+with the code for research, educational, and non-commercial purposes.
+
+COMMERCIAL USE RESTRICTIONS
+---------------------------
+ANY commercial deployment, hosting-as-a-service, or internal production use of
+this software — in whole or in part — REQUIRES strict compliance with AGPL-3.0.
+Specifically, you MUST:
+
+  1. Provide the COMPLETE corresponding source code to ALL users who interact
+     with the software over a network (Section 13 of the AGPL).
+  2. License your ENTIRE combined work under AGPL-3.0 (Sections 4, 5).
+  3. Preserve ALL copyright notices, warranty disclaimers, and license terms
+     (Section 7).
+  4. Make the source available under the same terms — no additional restrictions,
+     no proprietary wrappers, no SaaS shell games.
+
+NON-COMPLIANCE CONSEQUENCES
+---------------------------
+Failure to comply with the above obligations constitutes COPYRIGHT INFRINGEMENT.
+The copyright holder reserves the right to pursue ALL available legal remedies,
+including but not limited to injunctive relief, statutory damages, and attorneys'
+fees. There will be NO WARNINGS. There will be NO SETTLEMENTS without full
+source publication. If you use this code commercially and fail to meet AGPL
+obligations, you WILL face enforcement action.
+
+THIS IS NOT A PERMISSIVE LICENSE. THIS IS NOT MIT. THIS IS NOT APACHE.
+This is AGPL-3.0. Act accordingly.
+
+COMMERCIAL LICENSING ALTERNATIVE
+----------------------------------
+If you wish to use QIHSE in a closed-source or commercial SaaS product WITHOUT
+releasing your entire codebase under AGPL-3.0, a commercial license is available.
+
+Standard commercial terms start at **25% of gross revenue** derived from the
+product or service incorporating this software, with annual true-ups and audit
+rights reserved. These terms are intentionally set high to encourage AGPL
+compliance. I am open to negotiation for genuine startups, non-profits, academic
+spin-outs, and serious commercial ventures — but you must reach out first.
+
+INTENTIONALLY UNREASONABLE COMPLIANCE PATH
+-------------------------------------------
+If you choose to comply with AGPL-3.0 rather than negotiate a commercial
+license, be aware that the copyright holder reserves the right to require that
+THEY be the primary recipient of the COMPLETE corresponding source code,
+INCLUDING all revisions, derivative works, and future modifications, delivered
+in full and without redaction. This path is deliberately designed to be more
+burdensome than a simple conversation. If you have a real use case, email me.
+
+Contact: intel@swordintelligence.airforce
+(Domain was a gift — not affiliated with any military organisation.)
+
+================================================================================
+
                     GNU AFFERO GENERAL PUBLIC LICENSE
                        Version 3, 19 November 2007
 

SESSION_COMMITS.txt

@@ -0,0 +1,117 @@
+0a9126b 2026-06-02 Merge remote-tracking branch 'origin/codex/qihse-file-persistence'
+b7d6555 2026-06-02 Cascade snapshot 2026-06-02T09:47:01.631299873Z
+c88376a 2026-06-02 feat: hierarchical storage management with automatic hot/cold tiering
+714e885 2026-05-18 Update README.md
+5add142 2026-05-18 chore: include remaining docs, build, and runtime updates
+1018390 2026-05-18 docs: finalize native vector DB API contracts and usage docs
+122a2d4 2026-05-18 Add opt-in qmag bypass mode for approximate-only search
+392648b 2026-05-18 Add randomized trinary sweep helper and docs
+76e6fa1 2026-05-18 docs: highlight statistically validated trinary win conditions
+9ef5edc 2026-05-18 meta: fix project name typo Hilbert
+de02991 2026-05-18 docs: expand README project name to Quantum Inspire dHilbert
+52bdf95 2026-05-18 meta: set version string to full Quantum Inspire name
+0cf86af 2026-05-18 docs: add native build helper and fix mermaid diagrams
+78524f0 2026-05-18 build: add workspace bootstrap/cleanup targets for ignored artifacts
+33d8530 2026-05-18 docs: fix Mermaid line breaks for GitHub render
+c00084d 2026-05-18 docs: add mermaid persistence lifecycle diagram
+e6b7e2b 2026-05-18 docs: add mermaid architecture snapshot to README
+57c6b6c 2026-05-18 docs: balance README wow-factor with developer clarity
+66e368e 2026-05-18 docs: condense README to concise, non-dense format
+9252996 2026-05-18 docs: expand README with stronger code showcase
+7a6e13b 2026-05-18 docs: rewrite README and switch to AGPL license
+d9a3fb9 2026-05-18 chore: move root-level test executables into tests directory
+db004a2 2026-05-18 docs: advertise trinary persistence and finalize memory planner plumbing
+09247c6 2026-05-18 docs: add finalization plan for upstream and persistence
+afbe8ae 2026-05-18 Merge pull request #1 from SWORDIntel/framewerx-sync
+2cdfa91 2026-05-18 Finalize qihse persistence workload and upstream handoff loop
+61be8c0 2026-05-18 docs: refresh persistence checkpoint status after continuation
+3ebcf54 2026-05-18 Add next-slice execution plan for remaining persistence milestones
+d34c556 2026-05-18 Add explicit milestone checklist and slice completion status
+dae2915 2026-05-18 Align QIHSE workflow controls with upstream ownership
+6593ac8 2026-05-18 QIHSE persistence: expand manifest/index corruption coverage
+08847cc 2026-05-18 Make reference benchmarks resilient when SIFT1M is missing
+0d4e068 2026-05-17 Reject corrupt QIHSE index snapshots
+a42cbc4 2026-05-17 Cover checkpoint snapshot tmp recovery
+cf3a1b2 2026-05-17 Add QIHSE upstream workflow check
+a94ed55 2026-05-17 Add QIHSE reference workflow validation target
+5e0e8e5 2026-05-17 Add QIHSE benchmark result summary gate
+951ecc5 2026-05-17 Add QIHSE reference runner smoke test
+c04f976 2026-05-17 Generalize QIHSE reference workload runner
+f9bd12f 2026-05-17 Record QIHSE VXUG benchmark results
+931cb09 2026-05-17 Add QIHSE VXUG benchmark runner
+5a6061f 2026-05-17 Add QIHSE VXUG PDF sample workload
+862e89a 2026-05-17 Add QIHSE reference workload file inspection
+1d96c63 2026-05-17 Add QIHSE reference workload manifest
+ffbaa2a 2026-05-17 Tighten QIHSE trinary calibration plan
+f76fe51 2026-05-17 Extend QIHSE recovery boundary coverage
+ab19d54 2026-05-17 Add QIHSE recovery persistence fixtures
+1667294 2026-05-17 Remove stale QIHSE mirror roots
+72c9a7b 2026-05-17 Canonicalize QIHSE runtime root
+e8ac861 2026-05-17 Extend QIHSE persistence checkpoint coverage
+1deb49f 2026-05-17 Harden QIHSE persistence candidate defaults
+73a961c 2026-05-17 Benchmark persisted QIHSE qmag search
+11b4900 2026-05-17 Persist QIHSE magnitude trinary sidecar
+ffdcbda 2026-05-17 Prototype QIHSE magnitude trinary scoring
+8cfaf5e 2026-05-17 Add weighted QIHSE trinary candidate scoring
+8389f67 2026-05-17 Add QIHSE trinary candidate sweep benchmark
+a81deb1 2026-05-17 Add opt-in QIHSE trinary search path
+cf464f4 2026-05-17 Merge QIHSE branch into FRAMEWERX master
+b446538 2026-05-17 Expand QIHSE trinary search benchmark datasets
+5bf3d28 2026-05-17 Expand QIHSE trinary search benchmark datasets
+b87150a 2026-05-17 Add QIHSE compaction recovery coverage
+ddec756 2026-05-17 Add QIHSE compaction recovery coverage
+b8a37a3 2026-05-17 Implement physical QIHSE compaction
+1b4f3f3 2026-05-17 Implement physical QIHSE compaction
+7df0e3e 2026-05-17 Add mutation WAL replay and trinary search benchmark
+a86a756 2026-05-17 Add mutation WAL replay and trinary search benchmark
+bf933cc 2026-05-17 Implement QIHSE mutation APIs and DB trinary benchmark
+03f1f60 2026-05-17 Implement QIHSE mutation APIs and DB trinary benchmark
+0fe36b0 2026-05-17 Update QIHSE persistence plan checkpoint
+572ebf1 2026-05-17 Stage mutation APIs and extend mmap benchmarks
+8b6defb 2026-05-17 Stage mutation APIs and extend mmap benchmarks
+45e9f1e 2026-05-17 Update QIHSE persistence checkpoint
+67be8a7 2026-05-17 Extend mmap and trinary candidate work
+e194479 2026-05-17 Extend mmap and trinary candidate work
+9483006 2026-05-17 Continue QIHSE persistence roadmap
+c5c8cec 2026-05-17 Continue QIHSE persistence roadmap
+d12e59a 2026-05-17 Harden QIHSE WAL recovery
+906e84b 2026-05-17 Harden QIHSE WAL recovery
+fb6b7b1 2026-05-17 Add native QIHSE file persistence
+560d65a 2026-05-17 Add native QIHSE file persistence
+ffa291b 2026-05-11 Fix: Flesh out stubs, resolve unused parameter warnings, and fix calloc arguments in C core
+0a24811 2026-05-11 Fix: Flesh out stubs, resolve unused parameter warnings, and fix calloc arguments in C core
+fd5e422 2026-04-28 Make SIMD backends opt-in for native builds
+206e758 2026-04-28 Make SIMD backends opt-in for native builds
+5ec0563 2026-04-07 feat: implement actual priority pinning logic for Linux UMA
+87ae9d9 2026-04-07 feat: implement actual priority pinning logic for Linux UMA
+dda32d7 2026-03-24 Include QIHSE PGP public key for secure verification
+c494b56 2026-03-24 Synchronize Makefile with CUDA backend and update binaries
+977554b 2026-03-24 Synchronize Makefile with CUDA backend and update binaries
+1991835 2026-03-24 Update documentation with 52x speedup results and finalize CI/CD infrastructure
+b85fb90 2026-03-24 Implement native accelerated hooks, industry benchmarks, and Python bindings
+10a8be1 2026-03-24 Implement native accelerated hooks, industry benchmarks, and Python bindings
+8ce6a35 2026-03-24 Finalize QIHSE ecosystem: Consolidate documentation, implement AVX2 chunking, and tune accuracy/speed balance
+5455326 2026-03-24 Finalize QIHSE ecosystem: Consolidate documentation, implement AVX2 chunking, and tune accuracy/speed balance
+501e221 2026-03-23 Fix memory safety issues and integrate heterogeneous compute pipeline (NPU/GPU)
+c288351 2026-03-23 Fix memory safety issues and integrate heterogeneous compute pipeline (NPU/GPU)
+e24c709 2026-03-21 Native exports consolidation for Python ctypes compatibility
+1dcf12c 2026-03-21 Native exports consolidation for Python ctypes compatibility
+01e2fc1 2026-03-21 Final native reconciliation: Dynamic ISA dispatch, explicit exports for ctypes, and build cleanup
+34811d7 2026-03-21 Final native reconciliation: Dynamic ISA dispatch, explicit exports for ctypes, and build cleanup
+ac51596 2026-03-21 Modularize QIHSE core, add AVX-VNNI support, and fix ISA-specific crashes
+9d1b2f4 2026-03-21 Modularize QIHSE core, add AVX-VNNI support, and fix ISA-specific crashes
+772af2c 2026-03-21 Update UMA and vector DB behavior
+d7cd50e 2026-03-21 Update UMA and vector DB behavior
+e4142d4 2026-01-20 Update README.md
+2bdc542 2026-01-12 Reorganize: Move QIHSE under libs/search_algorithms as parent directory
+baf8120 2026-01-12 Reorganize: Move QIHSE under libs/search_algorithms as parent directory
+3ab75a8 2025-12-24 Remove AVX512 contact/licensing sentence from both documentation files
+832859b 2025-12-24 Make AVX512 mention more subtle and normal - remove dramatic all-caps formatting
+f23a00a 2025-12-24 Add AVX512 implementation status - have implementation but cannot morally upload without proof
+5e800c7 2025-12-24 Add New York exemption and enhance NotPetya theming with industrial warnings
+1645006 2025-12-24 Remove AVX512 derivatives notice - AVX512 counted but cannot provide without proof
+1719f53 2025-12-24 Add NotPetya-themed HTML documentation with performance graphs
+667fa8a 2025-12-24 Add AVX512 derivatives notice and fix contact email
+3f762f8 2025-12-24 Fix repository URL: update to correct SWORDIntel organization
+fd85efd 2025-12-24 Fix sed command damage: correct NOT_Competitor → NOT_STISLA naming
+23b4f23 2025-12-24 Initial release: NOT_STISLA ultra-high-performance search algorithm

algorithms/qihse_anchor.h

@@ -15,7 +15,7 @@
 #ifndef QIHSE_ANCHOR_H
 #define QIHSE_ANCHOR_H
 
-#include "../qihse.h"
+#include "qihse.h"
 #include "qihse_anchor_search.h"
 
 #ifdef __cplusplus

backends/cpu/qihse_cpu_distance.c

@@ -0,0 +1,83 @@
+/*
+ * QIHSE - CPU Distance Function Dispatch
+ *
+ * Runtime selection of the best distance function implementation
+ * based on CPU feature detection.
+ */
+
+#include "qihse_cpu_distance.h"
+#include "qihse_cpu_detect.h"
+#include <pthread.h>
+#include <math.h>
+
+/* -------------------------------------------------------------------------- */
+/* Scalar fallback implementations */
+/* -------------------------------------------------------------------------- */
+static float qihse_distance_dot_scalar(const float* a, const float* b, size_t dims) {
+    float sum = 0.0f;
+    for (size_t i = 0; i < dims; i++) {
+        sum += a[i] * b[i];
+    }
+    return sum;
+}
+
+static float qihse_distance_cosine_scalar(const float* a, const float* b, size_t dims) {
+    float dot = 0.0f, na = 0.0f, nb = 0.0f;
+    for (size_t i = 0; i < dims; i++) {
+        dot += a[i] * b[i];
+        na  += a[i] * a[i];
+        nb  += b[i] * b[i];
+    }
+    if (na <= 0.0f || nb <= 0.0f) return 0.0f;
+    return dot / (sqrtf(na) * sqrtf(nb));
+}
+
+static float qihse_distance_euclidean_scalar(const float* a, const float* b, size_t dims) {
+    float sum = 0.0f;
+    for (size_t i = 0; i < dims; i++) {
+        float d = a[i] - b[i];
+        sum += d * d;
+    }
+    return sqrtf(sum);
+}
+
+/* -------------------------------------------------------------------------- */
+/* Dispatch table */
+/* -------------------------------------------------------------------------- */
+static qihse_distance_fn_t g_cosine_fn = NULL;
+static qihse_distance_fn_t g_dot_fn = NULL;
+static qihse_distance_fn_t g_euclidean_fn = NULL;
+static pthread_once_t g_init_once = PTHREAD_ONCE_INIT;
+
+static void qihse_distance_init_once(void) {
+    qihse_cpu_info_t info = qihse_cpu_detect();
+
+    if (qihse_cpu_has_feature(&info, QIHSE_CPU_FEATURE_AVX2) &&
+        qihse_cpu_has_feature(&info, QIHSE_CPU_FEATURE_AVX)) {
+        g_cosine_fn    = qihse_distance_cosine_avx2;
+        g_dot_fn       = qihse_distance_dot_avx2;
+        g_euclidean_fn = qihse_distance_euclidean_avx2;
+    } else {
+        g_cosine_fn    = qihse_distance_cosine_scalar;
+        g_dot_fn       = qihse_distance_dot_scalar;
+        g_euclidean_fn = qihse_distance_euclidean_scalar;
+    }
+}
+
+/* -------------------------------------------------------------------------- */
+/* Public API */
+/* -------------------------------------------------------------------------- */
+float qihse_distance_cosine(const float* a, const float* b, size_t dims) {
+    pthread_once(&g_init_once, qihse_distance_init_once);
+    return g_cosine_fn(a, b, dims);
+}
+
+float qihse_distance_dot(const float* a, const float* b, size_t dims) {
+    pthread_once(&g_init_once, qihse_distance_init_once);
+    return g_dot_fn(a, b, dims);
+}
+
+float qihse_distance_euclidean(const float* a, const float* b, size_t dims) {
+    pthread_once(&g_init_once, qihse_distance_init_once);
+    return g_euclidean_fn(a, b, dims);
+}

backends/cpu/qihse_cpu_distance.h

@@ -0,0 +1,36 @@
+/*
+ * QIHSE - CPU SIMD Distance Functions
+ *
+ * Runtime-dispatched SIMD-accelerated vector distance computations.
+ * Auto-selects AVX2, AVX512, or scalar fallback based on CPU features.
+ */
+
+#ifndef QIHSE_CPU_DISTANCE_H
+#define QIHSE_CPU_DISTANCE_H
+
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Distance function signatures */
+typedef float (*qihse_distance_fn_t)(const float* a, const float* b, size_t dims);
+
+/* Runtime-dispatched distance functions.
+ * These auto-select the best implementation (AVX512 > AVX2 > scalar)
+ * on first call. */
+float qihse_distance_cosine(const float* a, const float* b, size_t dims);
+float qihse_distance_dot(const float* a, const float* b, size_t dims);
+float qihse_distance_euclidean(const float* a, const float* b, size_t dims);
+
+/* Explicit SIMD implementations (for benchmarking/comparison) */
+float qihse_distance_cosine_avx2(const float* a, const float* b, size_t dims);
+float qihse_distance_dot_avx2(const float* a, const float* b, size_t dims);
+float qihse_distance_euclidean_avx2(const float* a, const float* b, size_t dims);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* QIHSE_CPU_DISTANCE_H */