Standardize a size() method after isEmpty() on every module with clearAll(), delegating to domain counts or snapshot fields so callers can query occupancy without parsing snapshots. Co-authored-by: Cursor <[email protected]>
hyper-p2p-semantic-vector-index
HyperP2PSemanticVectorIndex Novel, production-grade semantic vector indexing and similarity search primitive for Bare/Pear P2P applications. Features:
Category: Indexes & search
Composes with: hyper-spatial-index, hyper-p2p-intent-router
Protocol: hyper-p2p-semantic-vector-index/v1
When to use
Multi-peer apps that need indexes & search over a shared Hyperswarm topic.
When not to use
Single-process tools with no P2P topic (use local APIs only or skip ready()).
Quick start
const HyperP2PSemanticVectorIndex = require('hyper-p2p-semantic-vector-index')
const index = new HyperP2PSemanticVectorIndex({ dimension: 128, topic: process.argv[2] })
const id = await index.insert([/* normalized vector */], { tags: ['docs'] })
const hits = await index.search([/* query */], 5, { minSimilarity: 0.7 })
console.log(id, hits)
await index.close()
Docs
-
docs/api.md — constructor, methods, events, errors
-
docs/architecture.md — wire types, state, composition
-
../_shared/PRODUCTION.md — production checklist
-
../_shared/DOC_STANDARDS.md — documentation standards
-
Integration:
../../real_tests/integration/—semantic-vector-index-two-node.js
Test
npm install && npm test