Typed config for the Proximum HNSW vector store, resolved via hive-di defconfig. Mirrors the DatalevinKGConfig surface so a vec slot's backend swap is config-driven, not code-driven.
Resolution per field (via hive-di coalesce):
Lives in hive-proximum (the consumer of the proximum HNSW lib);
hive-mcp depends on hive-proximum and late-binds via
hive-mcp.knowledge-graph.slots.factory/backend->store :proximum.
Typed config for the Proximum HNSW vector store, resolved via hive-di defconfig. Mirrors the DatalevinKGConfig surface so a vec slot's backend swap is config-driven, not code-driven. Resolution per field (via hive-di coalesce): 1. Explicit override map (caller passes :db-path / :dim) 2. HIVE_VEC_PROXIMUM_PATH / HIVE_VEC_PROXIMUM_DIM env var 3. ~/.config/hive-mcp/config.edn at [:services :proximum <key>] 4. Hardcoded XDG default Lives in hive-proximum (the consumer of the proximum HNSW lib); hive-mcp depends on hive-proximum and late-binds via `hive-mcp.knowledge-graph.slots.factory/backend->store :proximum`.
(->proximum-vec-config kw__79489__auto__)Coerce a keyword to a ProximumVecConfig variant (no data fields). Returns nil if keyword is not a valid variant.
Coerce a keyword to a ProximumVecConfig variant (no data fields). Returns nil if keyword is not a valid variant.
Canonical hive-mcp config file. Each field's :file source reads from here. Symmetric with DatalevinKGConfig and DatahikeKGConfig.
Canonical hive-mcp config file. Each field's :file source reads from here. Symmetric with DatalevinKGConfig and DatahikeKGConfig.
Default HNSW index capacity (max vector count). proximum's library default is 10M, which * dim * 4B overflows Integer.MAX_VALUE on the mmap backing file (capacity * dim * 4 must fit in 2GiB). 100_000 keeps the mmap under 200MB at dim=384 and is plenty for the carto snippet / memory entry slots in early Phase 2.
Operators wiring in a production-scale workload override via env (HIVE_VEC_PROXIMUM_CAPACITY) or config.edn :services :proximum :capacity. Capacity is fixed at index creation — bumping it requires creating a new index and re-inserting (proximum has no in-place resize).
Default HNSW index capacity (max vector count). proximum's library default is 10M, which * dim * 4B overflows Integer.MAX_VALUE on the mmap backing file (capacity * dim * 4 must fit in 2GiB). 100_000 keeps the mmap under 200MB at dim=384 and is plenty for the carto snippet / memory entry slots in early Phase 2. Operators wiring in a production-scale workload override via env (HIVE_VEC_PROXIMUM_CAPACITY) or config.edn :services :proximum :capacity. Capacity is fixed at index creation — bumping it requires creating a new index and re-inserting (proximum has no in-place resize).
XDG-conformant default. Sibling subdir to the Datalevin / Datahike stores so operators can keep all backends side-by-side during the STORAGE migration.
XDG-conformant default. Sibling subdir to the Datalevin / Datahike stores so operators can keep all backends side-by-side during the STORAGE migration.
Default embedding dimensionality. Matches sentence-transformers
all-MiniLM-L6-v2 (384) — the small-model fallback. Operators wiring
in a larger embedder (Qwen3 4096, OpenAI 1536) override via env or
config.edn :services :proximum :dim.
Default embedding dimensionality. Matches sentence-transformers `all-MiniLM-L6-v2` (384) — the small-model fallback. Operators wiring in a larger embedder (Qwen3 4096, OpenAI 1536) override via env or config.edn :services :proximum :dim.
(proximum-vec-config variant-kw__79486__auto__)(proximum-vec-config variant-kw__79486__auto__ data__79487__auto__)Construct a ProximumVecConfig variant. (proximum-vec-config variant-keyword) for enum variants (proximum-vec-config variant-keyword data-map) for data variants
Throws ex-info for unknown variants.
Construct a ProximumVecConfig variant. (proximum-vec-config variant-keyword) for enum variants (proximum-vec-config variant-keyword data-map) for data variants Throws ex-info for unknown variants.
(proximum-vec-config? x__79488__auto__)True if x is a ProximumVecConfig ADT value.
True if x is a ProximumVecConfig ADT value.
Config ADT for ProximumVecConfig. Auto-generated by defconfig.
Config ADT for ProximumVecConfig. Auto-generated by defconfig.
Field registry for ProximumVecConfig config.
Field registry for ProximumVecConfig config.
Malli schema for resolved ProximumVecConfig.
Malli schema for resolved ProximumVecConfig.
Malli :multi schema (dispatch :adt/variant) for ProximumVecConfig — generator-capable and EDN-safe wherever pred-sym->malli covers the declared field predicates.
Malli :multi schema (dispatch :adt/variant) for ProximumVecConfig — generator-capable and EDN-safe wherever pred-sym->malli covers the declared field predicates.
(resolve-ProximumVecConfig)(resolve-ProximumVecConfig overrides)(resolve-ProximumVecConfig overrides opts)Resolve ProximumVecConfig from environment + overrides. Returns Result: (ok resolved-map) or (err :config/resolution-failed {...})
Resolve ProximumVecConfig from environment + overrides.
Returns Result: (ok resolved-map) or (err :config/resolution-failed {...})cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |