Fuzzy Search is now at 80-85%

  - Expanded aliases and curated positive/adversarial quality coverage.
  - Added safer whole-phrase alias matching and acronym normalization.
  - Formalized ASCII, UTF-8 rejection, resource, and threading contracts.
  - Added the opt-in benchmark and CI coverage.
  - Kept linear scanning: measured approximately 2.1 ms/query for 256 entries, 8.4 ms for 1,024, 31.9 ms for 4,096, and 128 ms for 16,384.
  - Documented the future immutable index boundary in OpenMeta/docs/fuzzy_search.md:1.

Author: ssh4net

.github/workflows/ci.yml

@@ -154,16 +154,21 @@ jobs:
           -DOPENMETA_BUILD_STATIC=ON
           -DOPENMETA_BUILD_SHARED=OFF
           -DOPENMETA_BUILD_TESTS=ON
+          -DOPENMETA_BUILD_BENCHMARKS=ON
           -DOPENMETA_BUILD_PYTHON=OFF
           -DOPENMETA_WITH_DNG_SDK_ADAPTER=OFF
 
       - name: Build fuzzy-search release gate
         run: >
           cmake --build build-fuzzy --parallel
           --target openmeta_gate_fuzzy_search_release
+          openmeta_benchmark_fuzzy_search
 
       - name: Run fuzzy-search release gate
         run: >
           ctest --test-dir build-fuzzy
           -R openmeta_fuzzy_search_release_gate
           --output-on-failure
+
+      - name: Run informational fuzzy-search benchmark
+        run: ./build-fuzzy/openmeta_benchmark_fuzzy_search

CHANGES.md

@@ -1,5 +1,33 @@
 # OpenMeta Changes
 
+## 0.4.90 - 2026-07-30
+
+Changes compared with `0.4.89`.
+
+### Added
+
+- Expanded the curated Fuzzy Search alias vocabulary and quality gate across
+  descriptive, capture, geometry, color, RAW-processing, rights, location,
+  lens, and history terminology.
+- Added metadata-like adversarial negatives plus explicit ASCII separator,
+  camel-case, acronym-boundary, and UTF-8 policy tests.
+- Added the opt-in `OPENMETA_BUILD_BENCHMARKS` configuration and
+  `openmeta_benchmark_fuzzy_search` deterministic scaling workload, compiled
+  and executed by the RapidFuzz Release/libc++ CI job.
+- Added a dedicated Fuzzy Search contract covering ranking, resource and
+  threading bounds, quality gates, benchmark use, and indexing policy.
+
+### Changed
+
+- Fuzzy alias typos now require whole-phrase and per-token similarity, avoiding
+  unrelated matches caused by one shared word.
+- ASCII normalization now splits acronym-to-word boundaries such as
+  `GPSLatitude` and `ICCProfile`.
+- Fuzzy Search readiness is now tracked at about 80-85%; the active project
+  sequence moves to Creation, Editing, Transfer, Translation, and Writing.
+  Fuzzy Search resumes before Adapters and Utilities for Unicode/multilingual
+  behavior and an optional immutable large-store index.
+
 ## 0.4.89 - 2026-07-30
 
 Changes compared with `0.4.88`.

CMakeLists.txt

@@ -29,6 +29,7 @@ option(OPENMETA_BUILD_STATIC "Build libopenmeta.a" ON)
 option(OPENMETA_BUILD_SHARED "Build libopenmeta.so/.dylib/.dll" ON)
 option(OPENMETA_BUILD_TOOLS "Build OpenMeta CLI tools" ON)
 option(OPENMETA_BUILD_TESTS "Build OpenMeta unit tests" OFF)
+option(OPENMETA_BUILD_BENCHMARKS "Build OpenMeta benchmark executables" OFF)
 option(OPENMETA_BUILD_FUZZERS "Build OpenMeta libFuzzer targets" OFF)
 option(OPENMETA_BUILD_FUZZTEST "Build OpenMeta fuzz tests (FuzzTest)" OFF)
 option(OPENMETA_FUZZTEST_FUZZING_MODE "Enable FuzzTest fuzzing mode flags" OFF)
@@ -41,7 +42,7 @@ option(OPENMETA_WITH_ZLIB "Enable zlib/deflate payload decompression" ON)
 option(OPENMETA_WITH_BROTLI "Enable brotli payload decompression" ON)
 option(OPENMETA_WITH_EXPAT "Enable XMP packet decode via Expat" ON)
 option(OPENMETA_ENABLE_RAPIDFUZZ
-  "Enable RapidFuzz-backed metadata search and semantic query matching" OFF)
+  "Enable RapidFuzz-backed metadata fuzzy search" OFF)
 option(OPENMETA_WITH_DNG_SDK_ADAPTER
   "Enable the optional Adobe DNG SDK adapter bridge" OFF)
 option(OPENMETA_ENABLE_C2PA_VERIFY "Enable draft C2PA verification scaffold fields" OFF)
@@ -455,6 +456,18 @@ else()
   set(OPENMETA_LIB_TARGET openmeta_shared)
 endif()
 
+if(OPENMETA_BUILD_BENCHMARKS)
+  if(NOT OPENMETA_RAPIDFUZZ_FOUND)
+    message(FATAL_ERROR
+      "OPENMETA_BUILD_BENCHMARKS requires OPENMETA_ENABLE_RAPIDFUZZ=ON")
+  endif()
+  add_executable(openmeta_benchmark_fuzzy_search
+    tests/benchmarks/metadata_fuzzy_search_benchmark.cc)
+  openmeta_apply_target_settings(openmeta_benchmark_fuzzy_search)
+  target_link_libraries(openmeta_benchmark_fuzzy_search
+    PRIVATE ${OPENMETA_LIB_TARGET})
+endif()
+
 if(OPENMETA_BUILD_TOOLS)
   add_executable(metaread src/tools/metaread.cc)
   openmeta_apply_target_settings(metaread)
@@ -635,6 +648,7 @@ if(OPENMETA_BUILD_WHEEL)
   openmeta_append_wheel_config_define(OPENMETA_BUILD_WHEEL OFF)
   openmeta_append_wheel_config_define(OPENMETA_BUILD_TOOLS OFF)
   openmeta_append_wheel_config_define(OPENMETA_BUILD_TESTS OFF)
+  openmeta_append_wheel_config_define(OPENMETA_BUILD_BENCHMARKS OFF)
   openmeta_append_wheel_config_define(OPENMETA_BUILD_FUZZERS OFF)
   openmeta_append_wheel_config_define(OPENMETA_BUILD_FUZZTEST OFF)
   openmeta_append_wheel_config_define(OPENMETA_BUILD_DOCS OFF)

README.md

@@ -64,6 +64,8 @@ If you already own the encoder, SDK objects, or output container, follow
 - [docs/metadata_support.md](docs/metadata_support.md): metadata support matrix
 - [docs/metadata_transfer_plan.md](docs/metadata_transfer_plan.md): transfer
   status and roadmap
+- [docs/fuzzy_search.md](docs/fuzzy_search.md): optional ranked metadata-name
+  search contract, quality gates, and benchmark
 - [docs/doxygen.md](docs/doxygen.md): API reference
 - [SECURITY.md](SECURITY.md): security model and reporting
 - [NOTICE.md](NOTICE.md): notices and third-party dependency information

VERSION

@@ -1 +1 @@
-0.4.89
+0.4.90

cmake/OpenMetaReport.cmake

@@ -59,6 +59,7 @@ function(openmeta_print_config_summary)
   message(STATUS "    OPENMETA_BUILD_SHARED: ${OPENMETA_BUILD_SHARED}")
   message(STATUS "    OPENMETA_BUILD_TOOLS: ${OPENMETA_BUILD_TOOLS}")
   message(STATUS "    OPENMETA_BUILD_TESTS: ${OPENMETA_BUILD_TESTS}")
+  message(STATUS "    OPENMETA_BUILD_BENCHMARKS: ${OPENMETA_BUILD_BENCHMARKS}")
   message(STATUS "    OPENMETA_BUILD_FUZZERS: ${OPENMETA_BUILD_FUZZERS}")
   message(STATUS "    OPENMETA_BUILD_FUZZTEST: ${OPENMETA_BUILD_FUZZTEST}")
   message(STATUS "    OPENMETA_FUZZTEST_FUZZING_MODE: ${OPENMETA_FUZZTEST_FUZZING_MODE}")
@@ -82,7 +83,7 @@ function(openmeta_print_config_summary)
   openmeta_report_dependency("ZLIB (deflate)" "${OPENMETA_WITH_ZLIB}" "${OPENMETA_ZLIB_FOUND}" "system")
   openmeta_report_dependency("Brotli" "${OPENMETA_WITH_BROTLI}" "${OPENMETA_BROTLI_FOUND}" "system")
   openmeta_report_dependency("EXPAT (XMP XML)" "${OPENMETA_WITH_EXPAT}" "${OPENMETA_EXPAT_FOUND}" "system")
-  openmeta_report_dependency("RapidFuzz (metadata search/query)" "${OPENMETA_ENABLE_RAPIDFUZZ}"
+  openmeta_report_dependency("RapidFuzz (metadata fuzzy search)" "${OPENMETA_ENABLE_RAPIDFUZZ}"
     "${OPENMETA_RAPIDFUZZ_FOUND}" "${OPENMETA_RAPIDFUZZ_PROVIDER}")
   openmeta_report_dependency("Adobe DNG SDK adapter" "${OPENMETA_WITH_DNG_SDK_ADAPTER}" "${OPENMETA_DNG_SDK_FOUND}" "dng_sdk package")
   set(_openmeta_native_needed OFF)