aprender-db 0.29.0

GPU-first embedded analytics database with SIMD fallback and SQL query interface
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

# Renacer Performance Assertions for trueno-db
#
# These assertions enforce performance budgets for trueno-db (GPU-first analytics database).
# Assertions run at build time (via cargo test) and fail CI if violated.
#
# Toyota Way Principle: Andon (stop the line when defects detected)

[[assertion]]
name = "query_execution_latency"
type = "critical_path"
max_duration_ms = 500  # SQL queries should complete in <500ms for small datasets
fail_on_violation = true
enabled = true

[[assertion]]
name = "max_syscall_budget"
type = "span_count"
max_spans = 2000  # Database operations may have higher I/O for Arrow/Parquet
fail_on_violation = true
enabled = true

[[assertion]]
name = "memory_allocation_budget"
type = "memory_usage"
max_bytes = 524288000  # 500MB maximum for columnar data + query execution
tracking_mode = "allocations"
fail_on_violation = true
enabled = true

[[assertion]]
name = "prevent_god_process"
type = "anti_pattern"
pattern = "GodProcess"
threshold = 0.8  # 80% confidence threshold
fail_on_violation = false  # Warning only (not blocking)
enabled = true

[[assertion]]
name = "detect_pcie_bottleneck"
type = "anti_pattern"
pattern = "PCIeBottleneck"
threshold = 0.7  # Detect excessive GPU memory transfers
fail_on_violation = false  # Warning only (GPU features optional)
enabled = true

# Disabled assertion (example - can be enabled for stricter checking)
[[assertion]]
name = "ultra_strict_latency"
type = "critical_path"
max_duration_ms = 100  # <100ms (very aggressive for analytics queries)
fail_on_violation = true
enabled = false  # Disabled by default

# ==============================================================================
# Golden Trace Performance Validation
# ==============================================================================
# Validates that analytics queries (aggregations, filters, SQL) meet
# performance expectations using golden traces for regression detection.

[semantic_equivalence]
enabled = true
baseline_dir = "golden_traces/baseline"
min_confidence = 0.90  # 90% confidence required for PASS

# Validation checks
check_write_patterns = true          # Output correctness
check_file_operations = true         # Arrow/Parquet I/O validation
check_output_correctness = true      # Exact output matching
check_memory_allocations = false     # Columnar allocations may vary

# Performance expectations (SIMD vs baseline)
expected_speedup_min = 1.0           # Baseline comparison
expected_speedup_max = 20.0          # Sanity check for SIMD speedups

# Lamport clock configuration
[lamport_clock]
enabled = true
propagate_across_fork = true
propagate_across_exec = true
env_var = "RENACER_LAMPORT_CLOCK"

# Trace compression
[compression]
enabled = true
algorithm = "rle"  # Run-length encoding
min_file_size_kb = 100  # Only compress traces >100KB

# OpenTelemetry export (optional - for Jaeger/Grafana integration)
[otlp]
enabled = false  # Enable when observability stack available
endpoint = "http://localhost:4317"
service_name = "trueno-db"

# CI/CD integration
[ci]
fail_fast = true  # Stop on first assertion failure (Andon principle)
export_format = "json"
export_path = "target/renacer-reports"
compare_with_baseline = true