PomaiDB
Documentation v0.1.0

Membranes & Multimodal AI Memory Architecture

A deeply unique aspect defining the core architectural philosophy of PomaiDB is its complete rejection of the "One-Size-Fits-All Monolithic Index". Modern Edge AI and Robotics require executing profoundly different queries across substantially divergent domains simultaneously—mapping computer vision coordinates, retaining RAG textual history logs, geographically mapping obstacle clouds, and evaluating raw sensor scalar matrices.

PomaiDB isolates all of these completely differing operational profiles into logical, immutably typed collections known asMembranes.

The Membrane Typology Spectrum

Every Membrane specifies isolated dimension sets, independent hardware sharding rules, strictly designated index typologies (e.g., IVF clustering algorithms vs navigable HNSW networks), and unique retention parameters—all while safely operating atop the unified physical VFS and Log-Structured WAL system beneath.

  • kVector & kRag: Traditional dense embedding stores mapped explicitly over textual corpora for Retrieval-Augmented Generation workflows.
  • kGraph: Advanced Edge/Vertex topological stores designed specifically to empower associative logic traversing path logic between disjointed multi-dimensional coordinates.
  • kTimeSeries & kKeyValue: Extreme-velocity telemetry ingestion endpoints built directly beside the AI vector stores preventing multi-database maintenance complexity.
  • kMesh, kSpatial & kBlob: Binary object engines combined with spatial routing models specifically developed for processing LiDAR point clouds and robotic navigation meshes in real-time.
Intelligent kMesh & TaskScheduler LOD Management
The kMesh membrane encapsulates PomaiDB's most advanced edge capability. It ships with a fully asynchronous multi-Level-of-Detail (LOD) generation manager. Operating strictly via a low-priority background TaskScheduler thread, PomaiDB continuously interpolates incoming high-poly meshes and algorithmically generates decimated/compression tiers passively while standard execution continues entirely undisturbed.

When standard retrieval queries fire, the interface automatically prioritizes latency targets resulting in lower-tier LODs returning instantly. System engineers then deliberately structure override queries requiring high-resolution results where visualization necessity trumps physical compute speed.

ObjectLinker Integration (Phase 2 Roadmap)

While separating domains enforces structural security, the ability to seamlessly trace data dependencies is paramount. PomaiDB's next generation ObjectLinker technology structurally empowers deterministic multi-lateral query expansions natively internally.

Using the LinkObjects architecture, PomaiDB binds distinct internal Global Identifiers (GIDs) bridging vectors to graphs to meshes directly.

cpp
// Conceptual Membrane Linking Matrix Example
// Phase 2 Draft Integration Flowchart
pomai::MembraneSpec vision("vision_vectors", pomai::kVector, 512);
pomai::MembraneSpec taxonomy("world_graph", pomai::kGraph, 0);

db->CreateMembrane(vision);
db->CreateMembrane(taxonomy);

// Ingest visual feature arrays mapping camera object boundaries
db->OpenMembrane("vision_vectors")->Put(201, image_embedding_span);

// Connect semantic world associations directly inside the database
pomai::NodeID current_node = db->OpenMembrane("world_graph")->InsertVertex("Obstacle: Table");
db->OpenMembrane("world_graph")->InsertEdge(current_node, "IS_LOCATED_IN", "KitchenNode");

// Execute the Phase 2 ObjectLinker Binding Protocol across discrete sets!
db->LinkObjects( /* target ID */ 201, /* Linked Graph GID */ current_node );

// Later AI-Decision queries automatically cascade out:
// A spatial query matching image_embedding_span instantly navigates the graph edge
// returning 'KitchenNode' autonomously!

Multimodal Hybrid Search Orchestration

Evaluating constraints across membranes requires a sophisticated Query Orchestrator. PomaiDB executes intricate filtering combinations deterministically.

Query StageFilter TypeAlgorithmic BehaviorOutcome
Pre-FilteringMetadata (device_id='robot_4')Bitmap intersection across indicesIsolates calculation boundaries
Vector SearchCosine Similarity (Top-K=5)Quantized SIMD Matrix evaluationLocates dense geometrical proximity
Object Linked ExpandGraph Traversal limitsTraverse neighbor vertices recursivelyResolves spatial semantic association
Post-AggregationMini-OLAP AggregationsCalculate Averages / Bounds limitFinal Deterministic Telemetry