0000-template.md

SlateDB RFC Title

Table of Contents:

Status: Draft

Authors:

• Your Name

Summary

Motivation

Goals

• Goal 1
• Goal 2

Non-Goals

• Non-goal 1
• Non-goal 2

Design

Impact Analysis

SlateDB features and components that this RFC interacts with. Check all that apply.

Core API & Query Semantics

• Basic KV API (get/put/delete)
• Range queries, iterators, seek semantics
• Range deletions
• Error model, API errors

Consistency, Isolation, and Multi-Versioning

• Transactions
• Snapshots
• Sequence numbers

Time, Retention, and Derived State

• Time to live (TTL)
• Compaction filters
• Merge operator
• Change Data Capture (CDC)

Metadata, Coordination, and Lifecycles

• Manifest format
• Checkpoints
• Clones
• Garbage collection
• Database splitting and merging
• Multi-writer

Compaction

• Compaction state persistence
• Compaction filters
• Compaction strategies
• Distributed compaction
• Compactions format

Storage Engine Internals

• Write-ahead log (WAL)
• Block cache
• Object store cache
• Indexing (bloom filters, metadata)
• SST format or block format

Ecosystem & Operations

• CLI tools
• Language bindings (Go/Python/etc)
• Observability (metrics/logging/tracing)

Operations

Performance & Cost

• Latency (reads/writes/compactions)
• Throughput (reads/writes/compactions)
• Object-store request (GET/LIST/PUT) and cost profile
• Space, read, and write amplification

Observability

• Configuration changes
• New components/services
• Metrics
• Logging

Compatibility

• Existing data on object storage / on-disk formats
• Existing public APIs (including bindings)
• Rolling upgrades / mixed-version behavior (if applicable)

Testing

• Unit tests:
• Integration tests:
• Fault-injection/chaos tests:
• Deterministic simulation tests:
• Formal methods verification:
• Performance tests:

Rollout

• Milestones / phases:
• Feature flags / opt-in:
• Docs updates:

Alternatives

List the serious alternatives and why they were rejected (including “status quo”). Include trade-offs and risks.

Open Questions

• Question 1
• Question 2

References

• Reference 1
• Reference 2

Updates

Log major changes to this RFC over time (optional).