ruvector/docs/postgres
rUv 0f739ba9c7 feat(postgres): Add RuVector Postgres v2 implementation plan
Complete specification for RuVector Postgres v2 with:

Architecture:
- PostgreSQL extension (pgrx) with hybrid architecture
- SQL handles ACID/joins, RuVector engine handles vectors/graphs/learning
- Backward compatible with pgvector SQL surface
- Shared memory IPC with bounded contracts (64KB inline, 16MB shared)

4-Phase Implementation:
- Phase 1: pgvector-compatible search (1a: function-based, 1b: Index AM)
- Phase 2: Tiered storage with compression and exactness GUC
- Phase 3: Graph engine with Cypher and SQL join keys
- Phase 4: Dynamic mincut integrity gating (key differentiator)

Key Technical Details:
- lambda_cut: Minimum cut value via Stoer-Wagner (PRIMARY integrity metric)
- lambda2: Algebraic connectivity (OPTIONAL drift signal) - DIFFERENT from mincut!
- Contracted operational graph (~1000 nodes) - never compute on full similarity graph
- Hysteresis model with consecutive samples and cooldown
- Operation risk classification (Low/Medium/High)
- MVCC visibility with incremental paging API
- WAL replay with idempotency and LSN ordering
- Partition map versioning and epoch fencing for cluster mode

Files:
- 00-overview.md: Architecture, consistency contract, benchmark spec
- 01-sql-schema.md: SQL schema and types
- 02-background-workers.md: IPC contract, mincut worker
- 03-index-access-methods.md: Index AM specification
- 04-integrity-events.md: Events, hysteresis, operation classes
- 05-phase1-pgvector-compat.md: Phase 1a/1b incremental path
- 06-phase2-tiered-storage.md: Tiered storage with GUC exactness
- 07-phase3-graph-cypher.md: Graph engine with SQL joins
- 08-phase4-integrity-control.md: Mincut gating with Stoer-Wagner
- 09-migration-guide.md: Migration from pgvector
- 10-consistency-replication.md: Consistency and replication model

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-25 20:49:12 +00:00
..
v2 feat(postgres): Add RuVector Postgres v2 implementation plan 2025-12-25 20:49:12 +00:00
zero-copy docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00
operator-quick-reference.md docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00
parallel-implementation-summary.md docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00
parallel-query-guide.md docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00
postgres-memory-implementation-summary.md docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00
postgres-zero-copy-memory.md docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00
postgres-zero-copy-quick-reference.md docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00
SPARSEVEC_IMPLEMENTATION.md docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00
SPARSEVEC_QUICKSTART.md docs: Reorganize documentation and add postgres README 2025-12-02 16:45:44 +00:00