maludb-core

MaluDB is a memory DBMS built in C as PostgreSQL 17 extensions (on Ubuntu 24.04 LTS, x86_64 and arm64). It targets long-term institutional memory, human-AI knowledge sharing, and contextual recall, with a retrieval model that is relational/graph-first and reserves vector search for query classes that genuinely need it. Core features include: a source-to-claim-to-fact-to-episode pipeline, bitemporal time (valid and transaction time) with corrections that never overwrite history (supersession edges), SVPOR organization registries, MAUT confidence scoring, lifecycle/decay/legal hold, recursive-CTE graph traversal, full-text search and fuzzy matching, an authorization-aware retrieval planner, workflow extraction, a skill runtime as a governed state machine, active memory pools, episode replay, local node sync, a model registry with blue-green routing, embedding adapters, and an external MCP broker. Recent versions added: data-model graph introspection (DM-1), unified graph import and path finding, graph communities with analytics, document/note reindex protocols, and pg_dump support with extension config. The extension installs into a database (default `maludb`) and exposes per-schema memory facades; applications enable schemas explicitly and grant roles like `maludb_user` or `maludb_read`. Drivers for Python, Node.js, PHP, and C are included, each validated against the live extension. External services include `maludb_modeld` (model gateway), `maludb_mc2dbd` (MCP listener), `mcp-broker`, `maludb-restd` (REST gateway), `maludb-realtimed` (SSE), and `maludb-pageindexd` (PageIndex/ChatIndex builder). The quickstart bootstraps installation, verifies the version, walks through an example, and explains how to enable memory schemas in application schemas, upgrade existing installs, and connect from application servers (network listener, password, pg_hba.conf, firewall). The project has shipped stages 1 through 16 (Version 4 with PageIndex/ChatIndex). The current extension version is 0.105.3; the latest release tag v4.5.0 shipped extension 0.100.0. Documentation covers requirements, install, getting started, admin guide, benchmarks, security review, runtime, monitoring, and the MC2DB contract.