wavemind 2.3.0__tar.gz → 2.3.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (164) hide show
  1. {wavemind-2.3.0 → wavemind-2.3.2}/PKG-INFO +30 -17
  2. {wavemind-2.3.0 → wavemind-2.3.2}/README.md +29 -16
  3. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/BENCHMARK_LEADERBOARD.md +1 -1
  4. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/BENCHMARK_REPORT.md +1 -1
  5. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/benchmark_matrix_results.json +13 -10
  6. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/benchmark_registry.py +5 -2
  7. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/scale_readiness_benchmark.py +65 -4
  8. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/scale_readiness_results.json +14 -11
  9. {wavemind-2.3.0 → wavemind-2.3.2}/docker-compose.yml +1 -1
  10. {wavemind-2.3.0 → wavemind-2.3.2}/docs/BENCHMARK_BRIEF.md +1 -1
  11. {wavemind-2.3.0 → wavemind-2.3.2}/docs/ROADMAP.md +10 -7
  12. {wavemind-2.3.0 → wavemind-2.3.2}/pyproject.toml +1 -1
  13. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_cli_smoke.py +5 -0
  14. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_jobs.py +36 -0
  15. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_object_store.py +55 -0
  16. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_scale_readiness_benchmark.py +3 -0
  17. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/__init__.py +3 -1
  18. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/cli.py +74 -1
  19. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/jobs.py +12 -1
  20. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/object_store.py +147 -0
  21. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind.egg-info/PKG-INFO +30 -17
  22. {wavemind-2.3.0 → wavemind-2.3.2}/CONTRIBUTING.md +0 -0
  23. {wavemind-2.3.0 → wavemind-2.3.2}/Dockerfile +0 -0
  24. {wavemind-2.3.0 → wavemind-2.3.2}/LICENSE +0 -0
  25. {wavemind-2.3.0 → wavemind-2.3.2}/MANIFEST.in +0 -0
  26. {wavemind-2.3.0 → wavemind-2.3.2}/SECURITY.md +0 -0
  27. {wavemind-2.3.0 → wavemind-2.3.2}/SUPPORT.md +0 -0
  28. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/agent_memory_benchmark.py +0 -0
  29. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/agent_memory_results.json +0 -0
  30. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/ann_index_curve_benchmark.py +0 -0
  31. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/ann_index_curve_results.json +0 -0
  32. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/dynamic_memory_benchmark.py +0 -0
  33. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/dynamic_memory_results.json +0 -0
  34. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/field_memory_dynamics_benchmark.py +0 -0
  35. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/field_memory_dynamics_results.json +0 -0
  36. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/locomo_evidence_results.json +0 -0
  37. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/locomo_memory_benchmark.py +0 -0
  38. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/locomo_sentence_evidence_results.json +0 -0
  39. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/long_memory_evidence_benchmark.py +0 -0
  40. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/long_memory_evidence_results.json +0 -0
  41. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/longmemeval_answer_benchmark.py +0 -0
  42. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/longmemeval_answer_extractive_20_results.json +0 -0
  43. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/longmemeval_answer_qwen25_0_5b_50_results.json +0 -0
  44. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/longmemeval_answer_qwen25_1_5b_50_results.json +0 -0
  45. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/longmemeval_evidence_50_results.json +0 -0
  46. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/longmemeval_evidence_results.json +0 -0
  47. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/longmemeval_memory_benchmark.py +0 -0
  48. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/memory_competitor_benchmark.py +0 -0
  49. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/memory_competitor_results.json +0 -0
  50. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/nomiracl_russian_benchmark.py +0 -0
  51. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/nomiracl_russian_results.json +0 -0
  52. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/open_retrieval_benchmark.py +0 -0
  53. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/open_retrieval_scifact_results.json +0 -0
  54. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/production_index_profile_results.json +0 -0
  55. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/production_load_benchmark.py +0 -0
  56. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/production_load_qdrant_100k_tuned_results.json +0 -0
  57. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/production_load_qdrant_1m_ef_sweep_results.json +0 -0
  58. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/production_load_qdrant_1m_results.json +0 -0
  59. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/production_load_qdrant_1m_tuned_results.json +0 -0
  60. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/production_load_results.json +0 -0
  61. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/render_benchmark_charts.py +0 -0
  62. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/render_benchmark_leaderboard.py +0 -0
  63. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/render_benchmark_report.py +0 -0
  64. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/ru_sentences_benchmark.py +0 -0
  65. {wavemind-2.3.0 → wavemind-2.3.2}/benchmarks/wavemind_capacity_results.json +0 -0
  66. {wavemind-2.3.0 → wavemind-2.3.2}/docs/CHROMA_MIGRATION.md +0 -0
  67. {wavemind-2.3.0 → wavemind-2.3.2}/docs/DEMO_SCRIPT.md +0 -0
  68. {wavemind-2.3.0 → wavemind-2.3.2}/docs/LAUNCH_KIT.md +0 -0
  69. {wavemind-2.3.0 → wavemind-2.3.2}/docs/OBSERVABILITY.md +0 -0
  70. {wavemind-2.3.0 → wavemind-2.3.2}/docs/PROJECT_BOARD.md +0 -0
  71. {wavemind-2.3.0 → wavemind-2.3.2}/docs/RELEASE.md +0 -0
  72. {wavemind-2.3.0 → wavemind-2.3.2}/docs/RU_LAUNCH_POSTS.md +0 -0
  73. {wavemind-2.3.0 → wavemind-2.3.2}/docs/USE_CASES.md +0 -0
  74. {wavemind-2.3.0 → wavemind-2.3.2}/docs/assets/benchmark-summary.svg +0 -0
  75. {wavemind-2.3.0 → wavemind-2.3.2}/docs/assets/wavemind-demo.gif +0 -0
  76. {wavemind-2.3.0 → wavemind-2.3.2}/docs/assets/wavemind-social-card.svg +0 -0
  77. {wavemind-2.3.0 → wavemind-2.3.2}/examples/agent_with_memory.py +0 -0
  78. {wavemind-2.3.0 → wavemind-2.3.2}/examples/chroma_migration.py +0 -0
  79. {wavemind-2.3.0 → wavemind-2.3.2}/examples/customer_support_memory.py +0 -0
  80. {wavemind-2.3.0 → wavemind-2.3.2}/examples/demo.py +0 -0
  81. {wavemind-2.3.0 → wavemind-2.3.2}/examples/dynamic_memory_demo.py +0 -0
  82. {wavemind-2.3.0 → wavemind-2.3.2}/examples/framework_integrations.py +0 -0
  83. {wavemind-2.3.0 → wavemind-2.3.2}/examples/langchain_memory.py +0 -0
  84. {wavemind-2.3.0 → wavemind-2.3.2}/examples/llamaindex_retriever.py +0 -0
  85. {wavemind-2.3.0 → wavemind-2.3.2}/examples/observability/README.md +0 -0
  86. {wavemind-2.3.0 → wavemind-2.3.2}/examples/observability/docker-compose.yml +0 -0
  87. {wavemind-2.3.0 → wavemind-2.3.2}/examples/observability/otel-collector.yaml +0 -0
  88. {wavemind-2.3.0 → wavemind-2.3.2}/examples/observability/prometheus-alerts.yml +0 -0
  89. {wavemind-2.3.0 → wavemind-2.3.2}/examples/observability/prometheus.yml +0 -0
  90. {wavemind-2.3.0 → wavemind-2.3.2}/examples/production-index-profile/README.md +0 -0
  91. {wavemind-2.3.0 → wavemind-2.3.2}/examples/production-index-profile/docker-compose.yml +0 -0
  92. {wavemind-2.3.0 → wavemind-2.3.2}/examples/research_notebook_memory.py +0 -0
  93. {wavemind-2.3.0 → wavemind-2.3.2}/examples/sharded_memory.py +0 -0
  94. {wavemind-2.3.0 → wavemind-2.3.2}/install.bat +0 -0
  95. {wavemind-2.3.0 → wavemind-2.3.2}/install.sh +0 -0
  96. {wavemind-2.3.0 → wavemind-2.3.2}/requirements-optional.txt +0 -0
  97. {wavemind-2.3.0 → wavemind-2.3.2}/requirements.txt +0 -0
  98. {wavemind-2.3.0 → wavemind-2.3.2}/setup.cfg +0 -0
  99. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_agent_memory_benchmark.py +0 -0
  100. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_ann_index_curve_benchmark.py +0 -0
  101. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_api.py +0 -0
  102. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_api_process_persistence.py +0 -0
  103. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_benchmark_brief.py +0 -0
  104. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_benchmark_charts.py +0 -0
  105. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_benchmark_leaderboard.py +0 -0
  106. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_benchmark_registry.py +0 -0
  107. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_benchmark_report.py +0 -0
  108. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_chroma_migration_example.py +0 -0
  109. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_cluster.py +0 -0
  110. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_core_persistence.py +0 -0
  111. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_dynamic_memory_benchmark.py +0 -0
  112. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_examples.py +0 -0
  113. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_field_graph.py +0 -0
  114. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_field_graph_integration.py +0 -0
  115. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_field_memory_dynamics_benchmark.py +0 -0
  116. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_framework_adapters.py +0 -0
  117. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_import_benchmark.py +0 -0
  118. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_indexes_encoders.py +0 -0
  119. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_langchain_integration.py +0 -0
  120. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_locomo_memory_benchmark.py +0 -0
  121. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_long_memory_evidence_benchmark.py +0 -0
  122. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_longmemeval_answer_benchmark.py +0 -0
  123. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_longmemeval_memory_benchmark.py +0 -0
  124. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_memory_competitor_benchmark.py +0 -0
  125. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_multimodal.py +0 -0
  126. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_nomiracl_russian_benchmark.py +0 -0
  127. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_observability.py +0 -0
  128. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_observability_docs.py +0 -0
  129. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_open_retrieval_benchmark.py +0 -0
  130. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_packaging_files.py +0 -0
  131. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_postgres_storage.py +0 -0
  132. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_production_index_profile.py +0 -0
  133. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_production_load_benchmark.py +0 -0
  134. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_replication.py +0 -0
  135. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_scale_plan.py +0 -0
  136. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_semantic_and_latency.py +0 -0
  137. {wavemind-2.3.0 → wavemind-2.3.2}/tests/test_sharding.py +0 -0
  138. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/__main__.py +0 -0
  139. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/api.py +0 -0
  140. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/benchmark.py +0 -0
  141. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/cluster.py +0 -0
  142. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/core.py +0 -0
  143. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/encoders.py +0 -0
  144. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/field_graph.py +0 -0
  145. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/importers.py +0 -0
  146. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/indexes.py +0 -0
  147. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/integrations/__init__.py +0 -0
  148. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/integrations/autogen.py +0 -0
  149. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/integrations/crewai.py +0 -0
  150. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/integrations/langchain.py +0 -0
  151. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/integrations/langgraph.py +0 -0
  152. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/integrations/llamaindex.py +0 -0
  153. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/multimodal.py +0 -0
  154. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/observability.py +0 -0
  155. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/replication.py +0 -0
  156. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/scale.py +0 -0
  157. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/sharding.py +0 -0
  158. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/storage.py +0 -0
  159. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind/studio.py +0 -0
  160. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind.egg-info/SOURCES.txt +0 -0
  161. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind.egg-info/dependency_links.txt +0 -0
  162. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind.egg-info/entry_points.txt +0 -0
  163. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind.egg-info/requires.txt +0 -0
  164. {wavemind-2.3.0 → wavemind-2.3.2}/wavemind.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: wavemind
3
- Version: 2.3.0
3
+ Version: 2.3.2
4
4
  Summary: Local-first dynamic memory field with vector search and wave-field re-ranking
5
5
  License-Expression: MIT
6
6
  Project-URL: Homepage, https://github.com/CaspianG/wavemind
@@ -546,14 +546,16 @@ Checked-in result:
546
546
  |---|---:|
547
547
  | Cluster planner | 4096 namespaces, 4 nodes, replication factor 2, node-loss availability `1.000`, zone-loss availability `1.000`, write quorum `2`. |
548
548
  | Hot cache | 2000 lookups, hit rate `0.920`, p99 lookup `0.003 ms`. |
549
- | Replicated runtime | 3 physical WaveMind stores, replication factor 3, write quorum 2, node-loss recall `true`, repair copied `1` missing record, tombstone repair deleted `1` stale record, p99 query-after-loss `1.31 ms`. |
550
- | Active-active delta sync | 2 regions, bidirectional convergence `true`, stale import suppressed after delete `true`, tombstone convergence `true`, sync `159.69 ms`. |
551
- | Replicated snapshot job | 3 replica files, manifest checksum validation `true`, offsite mirror validation `true`, portable archive validation `true`, S3-compatible upload validation `true`, archive restore `24.85 ms`. |
552
- | Structured payloads | image/audio/table/event retrieval, precision@1 `1.000`, p99 `0.62 ms`. |
549
+ | Replicated runtime | 3 physical WaveMind stores, replication factor 3, write quorum 2, node-loss recall `true`, repair copied `1` missing record, tombstone repair deleted `1` stale record, p99 query-after-loss `1.96 ms`. |
550
+ | Active-active delta sync | 2 regions, bidirectional convergence `true`, stale import suppressed after delete `true`, tombstone convergence `true`, sync `114.71 ms`. |
551
+ | Replicated snapshot job | 3 replica files, manifest checksum validation `true`, offsite mirror validation `true`, portable archive validation `true`, S3-compatible upload validation `true`, latest remote archive metadata validation `true`, remote archive download validation `true`, object-store retention pruned `2`, archive restore `47.91 ms`. |
552
+ | Structured payloads | image/audio/table/event retrieval, precision@1 `1.000`, p99 `0.80 ms`. |
553
553
 
554
554
  This profile validates routing, quorum-replicated runtime behavior, cache
555
555
  behavior, active-active namespace delta sync, replicated snapshot/restore, and
556
- structured payload handling, including verified offsite and archive restore.
556
+ structured payload handling, including verified offsite, archive, object-store
557
+ latest lookup, object-store download, object-store retention, and archive
558
+ restore.
557
559
  It is not a 10M-vector load test. Real 100k, 1M, and 10M latency claims should
558
560
  come from service-backed FAISS/Qdrant/pgvector load tests on production-like
559
561
  hardware.
@@ -583,16 +585,16 @@ Maintenance workers:
583
585
 
584
586
  ```sh
585
587
  wavemind maintenance --namespace user:42 --consolidate-steps 10 --consolidate-concepts --json
586
- wavemind replicated-snapshot --root ./state/replicas --node node-a --node node-b --node node-c --out ./backups/replicated --offsite ./offsite/replicated --archive ./archives/replicated --s3 s3://my-bucket/wavemind/prod --keep-last 7 --json
588
+ wavemind replicated-snapshot --root ./state/replicas --node node-a --node node-b --node node-c --out ./backups/replicated --offsite ./offsite/replicated --archive ./archives/replicated --s3 s3://my-bucket/wavemind/prod --keep-last 7 --s3-keep-last 30 --json
587
589
  ```
588
590
 
589
591
  The first command runs one deterministic memory pass: expired-memory purge,
590
592
  optional field/concept consolidation, and index-health repair. The second
591
593
  command creates a verified replicated snapshot, mirrors it to an offsite path,
592
594
  writes a portable `.tar.gz` archive, verifies that archive, can upload it to an
593
- S3-compatible object store, and applies retention. Production deployments can
594
- call these commands from cron, systemd, Kubernetes CronJobs, Celery, RQ, or
595
- Temporal.
595
+ S3-compatible object store, verify newest-archive metadata, and apply local and
596
+ object-store retention. Production deployments can call these commands from
597
+ cron, systemd, Kubernetes CronJobs, Celery, RQ, or Temporal.
596
598
 
597
599
  Hot-cache options:
598
600
 
@@ -698,6 +700,7 @@ snapshot_job = ReplicatedSnapshotWorker(memory).run_once(
698
700
  archive_destination="./archives/replicated",
699
701
  object_store_destination="s3://my-bucket/wavemind/prod",
700
702
  keep_last=7,
703
+ object_store_keep_last=30,
701
704
  )
702
705
  assert snapshot_job.ok
703
706
 
@@ -713,7 +716,9 @@ The replicated snapshot job writes one SQLite backup per replica plus
713
716
  node definitions. It can mirror the snapshot to a second path for offsite
714
717
  backup, write a portable `.tar.gz` archive for object-store/offsite systems,
715
718
  verify that archive, upload it to any S3-compatible object store through
716
- `boto3`, and apply `keep_last` retention locally, offsite, and for archives.
719
+ `boto3`, list the newest remote archive, restore from the newest remote archive,
720
+ and apply `keep_last` retention locally, offsite, for archives, and explicitly
721
+ for object-store archives through `object_store_keep_last`.
717
722
  Restore refuses to overwrite a non-empty root unless `overwrite=True` is passed.
718
723
 
719
724
  Equivalent CLI:
@@ -727,6 +732,12 @@ wavemind replicated-snapshot \
727
732
  --archive ./archives/replicated \
728
733
  --s3 s3://my-bucket/wavemind/prod \
729
734
  --keep-last 7 \
735
+ --s3-keep-last 30 \
736
+ --json
737
+
738
+ wavemind replicated-s3-archives \
739
+ --s3 s3://my-bucket/wavemind/prod \
740
+ --latest \
730
741
  --json
731
742
 
732
743
  wavemind replicated-restore \
@@ -736,7 +747,8 @@ wavemind replicated-restore \
736
747
  --json
737
748
 
738
749
  wavemind replicated-restore \
739
- --from s3://my-bucket/wavemind/prod/wavemind-replicated-20260705-120000.tar.gz \
750
+ --from s3://my-bucket/wavemind/prod \
751
+ --latest \
740
752
  --to ./state/restored-replicas \
741
753
  --overwrite \
742
754
  --json
@@ -1119,7 +1131,7 @@ Current read:
1119
1131
  | LongMemEval 50-query smoke | On the first 50 non-abstention LongMemEval-S questions, WaveMind reaches `evidence_recall@5 0.920`, `precision@1 0.760`, and `MRR@5 0.827`; Chroma/Qdrant static reach `0.600`, `0.260`, and `0.385`. | This is the fast regression profile for checking current changes before rerunning the full LongMemEval profile. WaveMind wins on quality; latency still needs work. |
1120
1132
  | ANN/index curve | At 50000 generated 128-d vectors, NumPy exact keeps `recall@10 1.000` at `6.49 ms`; quantized int8 keeps `0.934` at `24.92 ms`; Annoy is faster at `4.92 ms` but drops to `0.730` recall; Qdrant local keeps `1.000` recall at `43.49 ms`. | Current local scale boundary is clear: quantized search needs kernel work, Annoy needs tuning/FAISS, and Qdrant should be tested in service mode for a fair production comparison. |
1121
1133
  | Production load | At 100000 generated 128-d vectors, service-mode Qdrant reaches `recall@10 1.000`, avg `10.28 ms`, p99 `21.26 ms`. At 1M, tuned Qdrant reaches `recall@10 0.984`, avg `116.80 ms`, p99 `209.28 ms`; an EF sweep finds `recall@10 0.977`, avg `64.76 ms`, p99 `103.77 ms` at `hnsw_ef=2048` on 30 queries. | 100k is production-grade on the tested machine. 1M recall is now strong, but p99 still needs tuning before claiming a stable sub-100 ms SLO. |
1122
- | Scale readiness | Deterministic 1M-memory simulation validates 4096 namespace placements over 4 nodes with replication factor 2, node-loss availability `1.000`, zone-loss availability `1.000`, hot-cache hit rate `0.920`, quorum-replicated runtime recall after node loss, missing-record repair, tombstone repair, active-active delta sync, checksummed replicated snapshot/restore, offsite mirror verification, portable archive verification, S3-compatible upload verification, and structured payload precision@1 `1.000`. | This proves routing, cache, payload, replicated-runtime, namespace-delta, offsite/archive/object-store backup, and restore-drill foundations. It is not a 10M-vector latency claim; real 10M latency still needs service-backed load tests on larger hardware. |
1134
+ | Scale readiness | Deterministic 1M-memory simulation validates 4096 namespace placements over 4 nodes with replication factor 2, node-loss availability `1.000`, zone-loss availability `1.000`, hot-cache hit rate `0.920`, quorum-replicated runtime recall after node loss, missing-record repair, tombstone repair, active-active delta sync, checksummed replicated snapshot/restore, offsite mirror verification, portable archive verification, S3-compatible upload/latest-metadata/download/retention verification, and structured payload precision@1 `1.000`. | This proves routing, cache, payload, replicated-runtime, namespace-delta, offsite/archive/object-store backup lifecycle, and restore-drill foundations. It is not a 10M-vector latency claim; real 10M latency still needs service-backed load tests on larger hardware. |
1123
1135
  | Memory competitor adapters | WaveMind reaches `precision@1 0.80`, `precision@3 1.00`, stale suppression `1.00` on the small adapter profile. Mem0, Zep, and LangGraph are listed as skipped unless their real packages/services are configured. | This prevents fake competitor claims. The adapter harness is ready; real Mem0/Zep/LangGraph results still need configured installs. |
1124
1136
  | LongMemEval local answer generation | With the same local Ollama `qwen2.5:1.5b`, WaveMind reaches `exact_match 0.240`, `contains_answer 0.380`, `token_f1 0.333`, and `evidence_recall@5 0.920`; Chroma and Qdrant static both reach `0.120`, `0.160`, `0.170`, and `0.600`. | This is the first checked-in end-to-end answer benchmark against Chroma/Qdrant. It is still a 50-question lightweight smoke run, not a full LongMemEval leaderboard score. |
1125
1137
 
@@ -1138,7 +1150,7 @@ Current read:
1138
1150
  | Production index profile | Docker-backed 50000-vector profile for persisted FAISS, Qdrant service, and PostgreSQL/pgvector HNSW. | implemented | FAISS / Qdrant service / pgvector | Keep service-mode candidate generation above `0.95` recall@10 and below 10 ms average query latency at 50000 vectors. |
1139
1151
  | Production load profile | 100k and 1M service-backed candidate-index checks with p95/p99 latency. | implemented | Qdrant service / pgvector HNSW / FAISS persisted | Keep 100k at recall@10 `1.000`; push 1M p99 below 100 ms with recall@10 >= 0.95. |
1140
1152
  | Qdrant 1M HNSW ef sweep | One 1M Qdrant collection queried with multiple `hnsw_ef` values. | implemented | Qdrant service | Repeat with 100+ queries and collection-level HNSW build parameters before claiming a stable 1M SLO. |
1141
- | Scale readiness profile | Cluster placement, node/zone-loss simulation, quorum report, replicated runtime, active-active delta sync, replicated snapshot/restore with offsite, archive, and object-store verification, hot-cache behavior, and structured/multimodal payload retrieval. | implemented | Mem0 / Zep / LangGraph persistent memory / GraphRAG target adapters | Keep quorum replication, namespace-delta sync, repair, offsite/archive/object-store backup, and restore drills green while adding larger service-backed 10M load tests. |
1153
+ | Scale readiness profile | Cluster placement, node/zone-loss simulation, quorum report, replicated runtime, active-active delta sync, replicated snapshot/restore with offsite, archive, object-store latest-metadata/download/retention verification, hot-cache behavior, and structured/multimodal payload retrieval. | implemented | Mem0 / Zep / LangGraph persistent memory / GraphRAG target adapters | Keep quorum replication, namespace-delta sync, repair, offsite/archive/object-store backup lifecycle, and restore drills green while adding larger service-backed 10M load tests. |
1142
1154
  | Memory competitor adapter profile | Dynamic-memory scenario wired for external memory frameworks. | implemented | Mem0 / Zep / LangGraph persistent memory | Report real competitor results only when their packages/services are explicitly configured. |
1143
1155
  | [BEIR](https://github.com/beir-cellar/beir) | Standard zero-shot information retrieval quality. | planned | Chroma / Qdrant / FAISS | Stay within 0.02 `nDCG@10` on identical embeddings. |
1144
1156
  | [MTEB Retrieval](https://github.com/embeddings-benchmark/mteb) | Separates encoder quality from retrieval-store quality. | planned | Chroma / Qdrant / FAISS | Prove WaveMind does not reduce same-embedding retrieval quality. |
@@ -1725,10 +1737,11 @@ Near-term priorities:
1725
1737
  - Faster dynamic re-ranking through smaller candidate windows, caching, and
1726
1738
  background updates.
1727
1739
  - Better production operations: OpenTelemetry and replicated offsite snapshot
1728
- jobs with verified portable archives and S3-compatible upload are
1740
+ jobs with verified portable archives, S3-compatible upload, latest-archive
1741
+ lookup, restore from latest, and object-store retention are
1729
1742
  implemented; richer latency histograms, index-health metrics, alerting
1730
- examples, object-store retention/download drills, and Postgres PITR runbooks
1731
- are next.
1743
+ examples, real cloud disaster-recovery drills, and Postgres PITR runbooks are
1744
+ next.
1732
1745
 
1733
1746
  Longer-term direction:
1734
1747
 
@@ -490,14 +490,16 @@ Checked-in result:
490
490
  |---|---:|
491
491
  | Cluster planner | 4096 namespaces, 4 nodes, replication factor 2, node-loss availability `1.000`, zone-loss availability `1.000`, write quorum `2`. |
492
492
  | Hot cache | 2000 lookups, hit rate `0.920`, p99 lookup `0.003 ms`. |
493
- | Replicated runtime | 3 physical WaveMind stores, replication factor 3, write quorum 2, node-loss recall `true`, repair copied `1` missing record, tombstone repair deleted `1` stale record, p99 query-after-loss `1.31 ms`. |
494
- | Active-active delta sync | 2 regions, bidirectional convergence `true`, stale import suppressed after delete `true`, tombstone convergence `true`, sync `159.69 ms`. |
495
- | Replicated snapshot job | 3 replica files, manifest checksum validation `true`, offsite mirror validation `true`, portable archive validation `true`, S3-compatible upload validation `true`, archive restore `24.85 ms`. |
496
- | Structured payloads | image/audio/table/event retrieval, precision@1 `1.000`, p99 `0.62 ms`. |
493
+ | Replicated runtime | 3 physical WaveMind stores, replication factor 3, write quorum 2, node-loss recall `true`, repair copied `1` missing record, tombstone repair deleted `1` stale record, p99 query-after-loss `1.96 ms`. |
494
+ | Active-active delta sync | 2 regions, bidirectional convergence `true`, stale import suppressed after delete `true`, tombstone convergence `true`, sync `114.71 ms`. |
495
+ | Replicated snapshot job | 3 replica files, manifest checksum validation `true`, offsite mirror validation `true`, portable archive validation `true`, S3-compatible upload validation `true`, latest remote archive metadata validation `true`, remote archive download validation `true`, object-store retention pruned `2`, archive restore `47.91 ms`. |
496
+ | Structured payloads | image/audio/table/event retrieval, precision@1 `1.000`, p99 `0.80 ms`. |
497
497
 
498
498
  This profile validates routing, quorum-replicated runtime behavior, cache
499
499
  behavior, active-active namespace delta sync, replicated snapshot/restore, and
500
- structured payload handling, including verified offsite and archive restore.
500
+ structured payload handling, including verified offsite, archive, object-store
501
+ latest lookup, object-store download, object-store retention, and archive
502
+ restore.
501
503
  It is not a 10M-vector load test. Real 100k, 1M, and 10M latency claims should
502
504
  come from service-backed FAISS/Qdrant/pgvector load tests on production-like
503
505
  hardware.
@@ -527,16 +529,16 @@ Maintenance workers:
527
529
 
528
530
  ```sh
529
531
  wavemind maintenance --namespace user:42 --consolidate-steps 10 --consolidate-concepts --json
530
- wavemind replicated-snapshot --root ./state/replicas --node node-a --node node-b --node node-c --out ./backups/replicated --offsite ./offsite/replicated --archive ./archives/replicated --s3 s3://my-bucket/wavemind/prod --keep-last 7 --json
532
+ wavemind replicated-snapshot --root ./state/replicas --node node-a --node node-b --node node-c --out ./backups/replicated --offsite ./offsite/replicated --archive ./archives/replicated --s3 s3://my-bucket/wavemind/prod --keep-last 7 --s3-keep-last 30 --json
531
533
  ```
532
534
 
533
535
  The first command runs one deterministic memory pass: expired-memory purge,
534
536
  optional field/concept consolidation, and index-health repair. The second
535
537
  command creates a verified replicated snapshot, mirrors it to an offsite path,
536
538
  writes a portable `.tar.gz` archive, verifies that archive, can upload it to an
537
- S3-compatible object store, and applies retention. Production deployments can
538
- call these commands from cron, systemd, Kubernetes CronJobs, Celery, RQ, or
539
- Temporal.
539
+ S3-compatible object store, verify newest-archive metadata, and apply local and
540
+ object-store retention. Production deployments can call these commands from
541
+ cron, systemd, Kubernetes CronJobs, Celery, RQ, or Temporal.
540
542
 
541
543
  Hot-cache options:
542
544
 
@@ -642,6 +644,7 @@ snapshot_job = ReplicatedSnapshotWorker(memory).run_once(
642
644
  archive_destination="./archives/replicated",
643
645
  object_store_destination="s3://my-bucket/wavemind/prod",
644
646
  keep_last=7,
647
+ object_store_keep_last=30,
645
648
  )
646
649
  assert snapshot_job.ok
647
650
 
@@ -657,7 +660,9 @@ The replicated snapshot job writes one SQLite backup per replica plus
657
660
  node definitions. It can mirror the snapshot to a second path for offsite
658
661
  backup, write a portable `.tar.gz` archive for object-store/offsite systems,
659
662
  verify that archive, upload it to any S3-compatible object store through
660
- `boto3`, and apply `keep_last` retention locally, offsite, and for archives.
663
+ `boto3`, list the newest remote archive, restore from the newest remote archive,
664
+ and apply `keep_last` retention locally, offsite, for archives, and explicitly
665
+ for object-store archives through `object_store_keep_last`.
661
666
  Restore refuses to overwrite a non-empty root unless `overwrite=True` is passed.
662
667
 
663
668
  Equivalent CLI:
@@ -671,6 +676,12 @@ wavemind replicated-snapshot \
671
676
  --archive ./archives/replicated \
672
677
  --s3 s3://my-bucket/wavemind/prod \
673
678
  --keep-last 7 \
679
+ --s3-keep-last 30 \
680
+ --json
681
+
682
+ wavemind replicated-s3-archives \
683
+ --s3 s3://my-bucket/wavemind/prod \
684
+ --latest \
674
685
  --json
675
686
 
676
687
  wavemind replicated-restore \
@@ -680,7 +691,8 @@ wavemind replicated-restore \
680
691
  --json
681
692
 
682
693
  wavemind replicated-restore \
683
- --from s3://my-bucket/wavemind/prod/wavemind-replicated-20260705-120000.tar.gz \
694
+ --from s3://my-bucket/wavemind/prod \
695
+ --latest \
684
696
  --to ./state/restored-replicas \
685
697
  --overwrite \
686
698
  --json
@@ -1063,7 +1075,7 @@ Current read:
1063
1075
  | LongMemEval 50-query smoke | On the first 50 non-abstention LongMemEval-S questions, WaveMind reaches `evidence_recall@5 0.920`, `precision@1 0.760`, and `MRR@5 0.827`; Chroma/Qdrant static reach `0.600`, `0.260`, and `0.385`. | This is the fast regression profile for checking current changes before rerunning the full LongMemEval profile. WaveMind wins on quality; latency still needs work. |
1064
1076
  | ANN/index curve | At 50000 generated 128-d vectors, NumPy exact keeps `recall@10 1.000` at `6.49 ms`; quantized int8 keeps `0.934` at `24.92 ms`; Annoy is faster at `4.92 ms` but drops to `0.730` recall; Qdrant local keeps `1.000` recall at `43.49 ms`. | Current local scale boundary is clear: quantized search needs kernel work, Annoy needs tuning/FAISS, and Qdrant should be tested in service mode for a fair production comparison. |
1065
1077
  | Production load | At 100000 generated 128-d vectors, service-mode Qdrant reaches `recall@10 1.000`, avg `10.28 ms`, p99 `21.26 ms`. At 1M, tuned Qdrant reaches `recall@10 0.984`, avg `116.80 ms`, p99 `209.28 ms`; an EF sweep finds `recall@10 0.977`, avg `64.76 ms`, p99 `103.77 ms` at `hnsw_ef=2048` on 30 queries. | 100k is production-grade on the tested machine. 1M recall is now strong, but p99 still needs tuning before claiming a stable sub-100 ms SLO. |
1066
- | Scale readiness | Deterministic 1M-memory simulation validates 4096 namespace placements over 4 nodes with replication factor 2, node-loss availability `1.000`, zone-loss availability `1.000`, hot-cache hit rate `0.920`, quorum-replicated runtime recall after node loss, missing-record repair, tombstone repair, active-active delta sync, checksummed replicated snapshot/restore, offsite mirror verification, portable archive verification, S3-compatible upload verification, and structured payload precision@1 `1.000`. | This proves routing, cache, payload, replicated-runtime, namespace-delta, offsite/archive/object-store backup, and restore-drill foundations. It is not a 10M-vector latency claim; real 10M latency still needs service-backed load tests on larger hardware. |
1078
+ | Scale readiness | Deterministic 1M-memory simulation validates 4096 namespace placements over 4 nodes with replication factor 2, node-loss availability `1.000`, zone-loss availability `1.000`, hot-cache hit rate `0.920`, quorum-replicated runtime recall after node loss, missing-record repair, tombstone repair, active-active delta sync, checksummed replicated snapshot/restore, offsite mirror verification, portable archive verification, S3-compatible upload/latest-metadata/download/retention verification, and structured payload precision@1 `1.000`. | This proves routing, cache, payload, replicated-runtime, namespace-delta, offsite/archive/object-store backup lifecycle, and restore-drill foundations. It is not a 10M-vector latency claim; real 10M latency still needs service-backed load tests on larger hardware. |
1067
1079
  | Memory competitor adapters | WaveMind reaches `precision@1 0.80`, `precision@3 1.00`, stale suppression `1.00` on the small adapter profile. Mem0, Zep, and LangGraph are listed as skipped unless their real packages/services are configured. | This prevents fake competitor claims. The adapter harness is ready; real Mem0/Zep/LangGraph results still need configured installs. |
1068
1080
  | LongMemEval local answer generation | With the same local Ollama `qwen2.5:1.5b`, WaveMind reaches `exact_match 0.240`, `contains_answer 0.380`, `token_f1 0.333`, and `evidence_recall@5 0.920`; Chroma and Qdrant static both reach `0.120`, `0.160`, `0.170`, and `0.600`. | This is the first checked-in end-to-end answer benchmark against Chroma/Qdrant. It is still a 50-question lightweight smoke run, not a full LongMemEval leaderboard score. |
1069
1081
 
@@ -1082,7 +1094,7 @@ Current read:
1082
1094
  | Production index profile | Docker-backed 50000-vector profile for persisted FAISS, Qdrant service, and PostgreSQL/pgvector HNSW. | implemented | FAISS / Qdrant service / pgvector | Keep service-mode candidate generation above `0.95` recall@10 and below 10 ms average query latency at 50000 vectors. |
1083
1095
  | Production load profile | 100k and 1M service-backed candidate-index checks with p95/p99 latency. | implemented | Qdrant service / pgvector HNSW / FAISS persisted | Keep 100k at recall@10 `1.000`; push 1M p99 below 100 ms with recall@10 >= 0.95. |
1084
1096
  | Qdrant 1M HNSW ef sweep | One 1M Qdrant collection queried with multiple `hnsw_ef` values. | implemented | Qdrant service | Repeat with 100+ queries and collection-level HNSW build parameters before claiming a stable 1M SLO. |
1085
- | Scale readiness profile | Cluster placement, node/zone-loss simulation, quorum report, replicated runtime, active-active delta sync, replicated snapshot/restore with offsite, archive, and object-store verification, hot-cache behavior, and structured/multimodal payload retrieval. | implemented | Mem0 / Zep / LangGraph persistent memory / GraphRAG target adapters | Keep quorum replication, namespace-delta sync, repair, offsite/archive/object-store backup, and restore drills green while adding larger service-backed 10M load tests. |
1097
+ | Scale readiness profile | Cluster placement, node/zone-loss simulation, quorum report, replicated runtime, active-active delta sync, replicated snapshot/restore with offsite, archive, object-store latest-metadata/download/retention verification, hot-cache behavior, and structured/multimodal payload retrieval. | implemented | Mem0 / Zep / LangGraph persistent memory / GraphRAG target adapters | Keep quorum replication, namespace-delta sync, repair, offsite/archive/object-store backup lifecycle, and restore drills green while adding larger service-backed 10M load tests. |
1086
1098
  | Memory competitor adapter profile | Dynamic-memory scenario wired for external memory frameworks. | implemented | Mem0 / Zep / LangGraph persistent memory | Report real competitor results only when their packages/services are explicitly configured. |
1087
1099
  | [BEIR](https://github.com/beir-cellar/beir) | Standard zero-shot information retrieval quality. | planned | Chroma / Qdrant / FAISS | Stay within 0.02 `nDCG@10` on identical embeddings. |
1088
1100
  | [MTEB Retrieval](https://github.com/embeddings-benchmark/mteb) | Separates encoder quality from retrieval-store quality. | planned | Chroma / Qdrant / FAISS | Prove WaveMind does not reduce same-embedding retrieval quality. |
@@ -1669,10 +1681,11 @@ Near-term priorities:
1669
1681
  - Faster dynamic re-ranking through smaller candidate windows, caching, and
1670
1682
  background updates.
1671
1683
  - Better production operations: OpenTelemetry and replicated offsite snapshot
1672
- jobs with verified portable archives and S3-compatible upload are
1684
+ jobs with verified portable archives, S3-compatible upload, latest-archive
1685
+ lookup, restore from latest, and object-store retention are
1673
1686
  implemented; richer latency histograms, index-health metrics, alerting
1674
- examples, object-store retention/download drills, and Postgres PITR runbooks
1675
- are next.
1687
+ examples, real cloud disaster-recovery drills, and Postgres PITR runbooks are
1688
+ next.
1676
1689
 
1677
1690
  Longer-term direction:
1678
1691
 
@@ -21,7 +21,7 @@ This is a compact reader-facing view of checked-in benchmark results. It is not
21
21
  | Production load profile 100k | production-scale | Recall@k | WaveMind pgvector: 0.736 / 17.8 ms | Qdrant service: 1 / 10.3 ms | Baseline leads on quality |
22
22
  | Production load profile 1M | production-scale | Recall@k | - | Qdrant service: 0.984 / 116.8 ms | No WaveMind result |
23
23
  | Qdrant 1M HNSW ef sweep | production-scale | Recall@k | - | hnsw_ef=2048: 0.977 / 64.8 ms | No WaveMind result |
24
- | Scale readiness profile | production-scale | precision@1 | WaveMind structured payloads: 1 / 0.41 ms | - | WaveMind-only check |
24
+ | Scale readiness profile | production-scale | precision@1 | WaveMind structured payloads: 1 / 0.588 ms | - | WaveMind-only check |
25
25
  | Memory competitor adapter profile | agent-memory | precision@1 | WaveMind: 0.8 / 0.554 ms | - | WaveMind-only check |
26
26
  | [LongMemEval answer generation](https://github.com/xiaowu0162/LongMemEval) | long-term-agent-memory | token F1 | WaveMind + qwen2.5:1.5b: 0.333 / - | Chroma static + qwen2.5:1.5b: 0.17 / - | WaveMind leads on quality |
27
27
 
@@ -24,7 +24,7 @@ Planned rows are not claimed wins. They are the public proof path WaveMind must
24
24
  | Production load profile 100k | production-scale | implemented | Qdrant service: Recall@k 1.00, avg latency 10.3, p95 latency 19.0, p99 latency ms 21.3, build ms 27439.3<br>WaveMind pgvector: Recall@k 0.74, avg latency 17.8, p95 latency 23.5, build ms 455703.7<br>WaveMind faiss-persisted: skipped - Set WAVEMIND_FAISS_PATH to use the persisted FAISS backend | Tune pgvector HNSW build/search parameters and add persisted FAISS from the Linux benchmark container. |
25
25
  | Production load profile 1M | production-scale | implemented | Qdrant service: Recall@k 0.98, avg latency 116.8, p95 latency 153.8, p99 latency ms 209.3, build ms 450674.6 | Tune Qdrant indexing/search params further, then add FAISS IVF/HNSW and pgvector 1M profiles on a larger disk. |
26
26
  | Qdrant 1M HNSW ef sweep | production-scale | implemented | hnsw_ef=512: Recall@k 0.75, avg latency 47.2, p95 latency 68.5, p99 latency ms 68.5, max latency ms 68.5<br>hnsw_ef=768: Recall@k 0.85, avg latency 44.0, p95 latency 69.1, p99 latency ms 69.8, max latency ms 69.8<br>hnsw_ef=1024: Recall@k 0.88, avg latency 62.9, p95 latency 81.1, p99 latency ms 85.5, max latency ms 85.5<br>hnsw_ef=1536: Recall@k 0.94, avg latency 65.6, p95 latency 111.2, p99 latency ms 119.7, max latency ms 119.7<br>hnsw_ef=2048: Recall@k 0.98, avg latency 64.8, p95 latency 91.2, p99 latency ms 103.8, max latency ms 103.8 | Repeat with 100+ queries and collection-level HNSW build parameters before claiming a stable production SLO. |
27
- | Scale readiness profile | production-scale | implemented | WaveMind cluster planner: simulated memories 1000000, namespaces 4096, nodes 4, replication factor 2, node loss min availability 1.00, zone loss min availability 1.00, read quorum 1, write quorum 2, placement ms 62.6<br>WaveMind hot cache: queries 2000, capacity 512, hit rate 0.92, evictions 0, p99 lookup ms 0.00<br>WaveMind replicated runtime: nodes 3, replication factor 3, write quorum 2, read quorum 1, recalled after node loss True, repair copied records 1, tombstone repair deleted records 1, p99 query after loss ms 1.31<br>WaveMind active-active delta sync: regions 2, replication factor per region 3, records imported 6, converged after bidirectional sync True, suppressed stale import after delete True, tombstone converged True, sync ms 159.7<br>WaveMind replicated snapshot: nodes 3, manifest healthy True, offsite verified True, archive verified True, object store verified True, restored files 3, recalled after restore node loss True, snapshot ms 186.2, restore ms 24.9<br>WaveMind structured payloads: queries 4, precision@1 1.00, avg latency 0.41, p99 latency ms 0.62 | Move from local replicated runtime to service-backed replicated runs, object-store retention/download drills, and larger 10M candidate-index load tests. |
27
+ | Scale readiness profile | production-scale | implemented | WaveMind cluster planner: simulated memories 1000000, namespaces 4096, nodes 4, replication factor 2, node loss min availability 1.00, zone loss min availability 1.00, read quorum 1, write quorum 2, placement ms 78.8<br>WaveMind hot cache: queries 2000, capacity 512, hit rate 0.92, evictions 0, p99 lookup ms 0.00<br>WaveMind replicated runtime: nodes 3, replication factor 3, write quorum 2, read quorum 1, recalled after node loss True, repair copied records 1, tombstone repair deleted records 1, p99 query after loss ms 1.96<br>WaveMind active-active delta sync: regions 2, replication factor per region 3, records imported 6, converged after bidirectional sync True, suppressed stale import after delete True, tombstone converged True, sync ms 114.7<br>WaveMind replicated snapshot: nodes 3, manifest healthy True, offsite verified True, archive verified True, object store verified True, object store latest verified True, object store pruned 2, object store download verified True, restored files 3, recalled after restore node loss True, snapshot ms 176.1, restore ms 47.9<br>WaveMind structured payloads: queries 4, precision@1 1.00, avg latency 0.59, p99 latency ms 0.80 | Move from local replicated runtime to service-backed replicated runs, real cloud object-store disaster-recovery drills, and larger 10M candidate-index load tests. |
28
28
  | Memory competitor adapter profile | agent-memory | implemented | WaveMind: precision@1 0.80, precision@3 1.00, stale suppression 1.00, avg latency 0.55, p95 latency 0.83<br>Mem0: skipped - Install Mem0 to run this adapter profile: pip install "mem0ai"<br>Zep: skipped - Install the Zep client package and set ZEP_API_KEY or ZEP_API_URL.<br>LangGraph persistent memory: skipped - Install LangGraph to run this adapter profile: pip install "langgraph" | Add documented setup commands for each competitor adapter and store checked-in results only when those real adapters run. |
29
29
  | [LongMemEval answer generation](https://github.com/xiaowu0162/LongMemEval) | long-term-agent-memory | implemented | extractive smoke: queries 20, evidence recall@k 1.00, exact match 0.00, contains answer 0.05, token f1 0.02, avg retrieval ms 3.79, avg generation ms 0.77<br>WaveMind + qwen2.5:0.5b: queries 50, evidence recall@k 0.92, exact match 0.12, contains answer 0.18, token f1 0.18, avg retrieval ms 2.98, avg generation ms 1428.2<br>Chroma static + qwen2.5:0.5b: queries 50, evidence recall@k 0.60, exact match 0.10, contains answer 0.12, token f1 0.13, avg retrieval ms 4.10, avg generation ms 1234.7<br>Qdrant static + qwen2.5:0.5b: queries 50, evidence recall@k 0.60, exact match 0.10, contains answer 0.12, token f1 0.13, avg retrieval ms 63.8, avg generation ms 893.5<br>WaveMind + qwen2.5:1.5b: queries 50, evidence recall@k 0.92, exact match 0.24, contains answer 0.38, token f1 0.33, avg retrieval ms 2.00, avg generation ms 2153.0<br>Chroma static + qwen2.5:1.5b: queries 50, evidence recall@k 0.60, exact match 0.12, contains answer 0.16, token f1 0.17, avg retrieval ms 7.05, avg generation ms 2082.4<br>Qdrant static + qwen2.5:1.5b: queries 50, evidence recall@k 0.60, exact match 0.12, contains answer 0.16, token f1 0.17, avg retrieval ms 100.2, avg generation ms 758.1 | Run all 470 non-abstention questions with a stronger local/API model and add faithfulness/abstention scoring. |
30
30
 
@@ -764,14 +764,14 @@
764
764
  "zone_loss_min_availability": 1.0,
765
765
  "read_quorum": 1,
766
766
  "write_quorum": 2,
767
- "placement_ms": 62.552399991545826
767
+ "placement_ms": 78.79679999314249
768
768
  },
769
769
  "WaveMind hot cache": {
770
770
  "queries": 2000,
771
771
  "capacity": 512,
772
772
  "hit_rate": 0.92,
773
773
  "evictions": 0,
774
- "p99_lookup_ms": 0.0026999623514711857
774
+ "p99_lookup_ms": 0.003800028935074806
775
775
  },
776
776
  "WaveMind replicated runtime": {
777
777
  "nodes": 3,
@@ -781,7 +781,7 @@
781
781
  "recalled_after_node_loss": true,
782
782
  "repair_copied_records": 1,
783
783
  "tombstone_repair_deleted_records": 1,
784
- "p99_query_after_loss_ms": 1.3142999960109591
784
+ "p99_query_after_loss_ms": 1.9631999894045293
785
785
  },
786
786
  "WaveMind active-active delta sync": {
787
787
  "regions": 2,
@@ -790,7 +790,7 @@
790
790
  "converged_after_bidirectional_sync": true,
791
791
  "suppressed_stale_import_after_delete": true,
792
792
  "tombstone_converged": true,
793
- "sync_ms": 159.69160001259297
793
+ "sync_ms": 114.70850004116073
794
794
  },
795
795
  "WaveMind replicated snapshot": {
796
796
  "nodes": 3,
@@ -798,20 +798,23 @@
798
798
  "offsite_verified": true,
799
799
  "archive_verified": true,
800
800
  "object_store_verified": true,
801
+ "object_store_latest_verified": true,
802
+ "object_store_pruned": 2,
803
+ "object_store_download_verified": true,
801
804
  "restored_files": 3,
802
805
  "recalled_after_restore_node_loss": true,
803
- "snapshot_ms": 186.24169996473938,
804
- "restore_ms": 24.853000009898096
806
+ "snapshot_ms": 176.10959999728948,
807
+ "restore_ms": 47.905499988701195
805
808
  },
806
809
  "WaveMind structured payloads": {
807
810
  "queries": 4,
808
811
  "precision_at_1": 1.0,
809
- "avg_latency_ms": 0.4099500220036134,
810
- "p99_latency_ms": 0.6203000084497035
812
+ "avg_latency_ms": 0.5878500087419525,
813
+ "p99_latency_ms": 0.8010999881662428
811
814
  }
812
815
  },
813
- "target": "Prove the production foundation before heavier 100k, 1M, and 10M vector load tests: deterministic placement, survivable replicas, active-active sync, offsite/archive/object-store-verified restore drills, hot-cache behavior, and structured payload recall.",
814
- "next_step": "Move from local replicated runtime to service-backed replicated runs, object-store retention/download drills, and larger 10M candidate-index load tests."
816
+ "target": "Prove the production foundation before heavier 100k, 1M, and 10M vector load tests: deterministic placement, survivable replicas, active-active sync, offsite/archive/object-store upload/latest-metadata/download/retention restore drills, hot-cache behavior, and structured payload recall.",
817
+ "next_step": "Move from local replicated runtime to service-backed replicated runs, real cloud object-store disaster-recovery drills, and larger 10M candidate-index load tests."
815
818
  },
816
819
  {
817
820
  "id": "memory_competitor_adapter_profile",
@@ -768,6 +768,9 @@ def _implemented_entries(root: Path) -> list[dict[str, Any]]:
768
768
  "offsite_verified",
769
769
  "archive_verified",
770
770
  "object_store_verified",
771
+ "object_store_latest_verified",
772
+ "object_store_pruned",
773
+ "object_store_download_verified",
771
774
  "restored_files",
772
775
  "recalled_after_restore_node_loss",
773
776
  "snapshot_ms",
@@ -784,8 +787,8 @@ def _implemented_entries(root: Path) -> list[dict[str, Any]]:
784
787
  ),
785
788
  ),
786
789
  },
787
- "target": "Prove the production foundation before heavier 100k, 1M, and 10M vector load tests: deterministic placement, survivable replicas, active-active sync, offsite/archive/object-store-verified restore drills, hot-cache behavior, and structured payload recall.",
788
- "next_step": "Move from local replicated runtime to service-backed replicated runs, object-store retention/download drills, and larger 10M candidate-index load tests.",
790
+ "target": "Prove the production foundation before heavier 100k, 1M, and 10M vector load tests: deterministic placement, survivable replicas, active-active sync, offsite/archive/object-store upload/latest-metadata/download/retention restore drills, hot-cache behavior, and structured payload recall.",
791
+ "next_step": "Move from local replicated runtime to service-backed replicated runs, real cloud object-store disaster-recovery drills, and larger 10M candidate-index load tests.",
789
792
  },
790
793
  {
791
794
  "id": "memory_competitor_adapter_profile",
@@ -6,6 +6,7 @@ import statistics
6
6
  import sys
7
7
  import tempfile
8
8
  import time
9
+ from io import BytesIO
9
10
  from pathlib import Path
10
11
 
11
12
  PROJECT_ROOT = Path(__file__).resolve().parents[1]
@@ -35,11 +36,14 @@ from wavemind import (
35
36
  class InMemoryS3Client:
36
37
  def __init__(self):
37
38
  self.objects: dict[tuple[str, str], dict[str, object]] = {}
39
+ self.counter = 0
38
40
 
39
41
  def upload_file(self, filename: str, bucket: str, key: str, ExtraArgs=None):
42
+ self.counter += 1
40
43
  self.objects[(bucket, key)] = {
41
44
  "Body": Path(filename).read_bytes(),
42
45
  "Metadata": dict((ExtraArgs or {}).get("Metadata") or {}),
46
+ "LastModified": f"2026-01-01T00:00:{self.counter:02d}Z",
43
47
  }
44
48
 
45
49
  def head_object(self, Bucket: str, Key: str) -> dict[str, object]:
@@ -51,6 +55,37 @@ class InMemoryS3Client:
51
55
  "ETag": '"benchmark-etag"',
52
56
  }
53
57
 
58
+ def list_objects_v2(
59
+ self,
60
+ Bucket: str,
61
+ Prefix: str = "",
62
+ ContinuationToken: str | None = None,
63
+ ) -> dict[str, object]:
64
+ contents = []
65
+ for (bucket, key), payload in self.objects.items():
66
+ if bucket == Bucket and key.startswith(Prefix):
67
+ body = payload["Body"]
68
+ contents.append(
69
+ {
70
+ "Key": key,
71
+ "Size": len(body),
72
+ "LastModified": payload["LastModified"],
73
+ "ETag": '"benchmark-etag"',
74
+ }
75
+ )
76
+ return {"Contents": sorted(contents, key=lambda item: item["Key"])}
77
+
78
+ def delete_objects(self, Bucket: str, Delete: dict[str, object]) -> dict[str, object]:
79
+ deleted = []
80
+ for item in Delete["Objects"]:
81
+ key = item["Key"]
82
+ self.objects.pop((Bucket, key), None)
83
+ deleted.append({"Key": key})
84
+ return {"Deleted": deleted}
85
+
86
+ def get_object(self, Bucket: str, Key: str) -> dict[str, object]:
87
+ return {"Body": BytesIO(self.objects[(Bucket, Key)]["Body"])}
88
+
54
89
 
55
90
  def percentile(values: list[float], pct: float) -> float:
56
91
  if not values:
@@ -361,6 +396,10 @@ def run_replicated_snapshot_profile() -> dict[str, object]:
361
396
  "s3://wavemind-benchmark/replicated",
362
397
  client=InMemoryS3Client(),
363
398
  )
399
+ for index in range(2):
400
+ old_archive = root / f"old-object-archive-{index}.tar.gz"
401
+ old_archive.write_bytes(f"old-object-archive-{index}".encode("utf-8"))
402
+ object_store.upload_archive(old_archive)
364
403
  snapshot_job = ReplicatedSnapshotWorker(memory).run_once(
365
404
  destination=root / "snapshots",
366
405
  offsite_destination=root / "offsite",
@@ -368,13 +407,27 @@ def run_replicated_snapshot_profile() -> dict[str, object]:
368
407
  object_store_destination="s3://wavemind-benchmark/replicated",
369
408
  object_store=object_store,
370
409
  keep_last=2,
410
+ object_store_keep_last=1,
371
411
  )
372
412
  snapshot_ms = (time.perf_counter() - snapshot_started) * 1000.0
373
413
  health = ReplicatedWaveMind.verify_snapshot(snapshot_job.snapshot_path)
414
+ latest_object_archive = object_store.latest_archive()
415
+ object_store_download_verified = False
416
+ downloaded_archive = None
417
+ if latest_object_archive is not None:
418
+ downloaded_archive = object_store.download_archive(
419
+ latest_object_archive.uri,
420
+ root / "object-store-downloads",
421
+ )
422
+ object_store_download_verified = bool(
423
+ ReplicatedWaveMind.verify_snapshot_archive(downloaded_archive)[
424
+ "healthy"
425
+ ]
426
+ )
374
427
 
375
428
  restore_started = time.perf_counter()
376
429
  restored, restore = ReplicatedWaveMind.restore_snapshot_archive(
377
- snapshot_job.archive_path,
430
+ downloaded_archive or snapshot_job.archive_path,
378
431
  root / "restored",
379
432
  width=16,
380
433
  height=16,
@@ -397,6 +450,11 @@ def run_replicated_snapshot_profile() -> dict[str, object]:
397
450
  snapshot_job.object_store_upload
398
451
  and snapshot_job.object_store_upload.verified
399
452
  ),
453
+ "object_store_latest_verified": bool(
454
+ latest_object_archive and latest_object_archive.verified
455
+ ),
456
+ "object_store_pruned": len(snapshot_job.pruned_object_store),
457
+ "object_store_download_verified": object_store_download_verified,
400
458
  "total_bytes": snapshot_job.total_bytes,
401
459
  "snapshot_ms": snapshot_ms,
402
460
  "restore_ms": restore_ms,
@@ -511,9 +569,9 @@ def run_benchmark(
511
569
  "Deterministic scale-readiness profile for cluster placement, "
512
570
  "node/zone loss simulation, quorum-replicated runtime behavior, "
513
571
  "active-active delta sync, replicated snapshot/offsite/archive "
514
- "restore, S3-compatible object-store upload verification, hot-cache "
515
- "behavior, and structured payload retrieval. This is not a 10M-vector "
516
- "database load test."
572
+ "restore, S3-compatible object-store upload/latest-metadata/"
573
+ "download/retention verification, hot-cache behavior, and structured payload retrieval. "
574
+ "This is not a 10M-vector database load test."
517
575
  ),
518
576
  },
519
577
  "results": results,
@@ -562,6 +620,9 @@ def main() -> int:
562
620
  print(f"| replicated snapshot | offsite_verified | {result['offsite_verified']} |")
563
621
  print(f"| replicated snapshot | archive_verified | {result['archive_verified']} |")
564
622
  print(f"| replicated snapshot | object_store_verified | {result['object_store_verified']} |")
623
+ print(f"| replicated snapshot | object_store_latest_verified | {result['object_store_latest_verified']} |")
624
+ print(f"| replicated snapshot | object_store_pruned | {result['object_store_pruned']} |")
625
+ print(f"| replicated snapshot | object_store_download_verified | {result['object_store_download_verified']} |")
565
626
  print(f"| replicated snapshot | recalled_after_restore_node_loss | {result['recalled_after_restore_node_loss']} |")
566
627
  else:
567
628
  print(f"| structured payloads | precision@1 | {result['precision_at_1']:.3f} |")
@@ -5,7 +5,7 @@
5
5
  "namespace_count": 4096,
6
6
  "node_count": 4,
7
7
  "replication_factor": 2,
8
- "description": "Deterministic scale-readiness profile for cluster placement, node/zone loss simulation, quorum-replicated runtime behavior, active-active delta sync, replicated snapshot/offsite/archive restore, S3-compatible object-store upload verification, hot-cache behavior, and structured payload retrieval. This is not a 10M-vector database load test."
8
+ "description": "Deterministic scale-readiness profile for cluster placement, node/zone loss simulation, quorum-replicated runtime behavior, active-active delta sync, replicated snapshot/offsite/archive restore, S3-compatible object-store upload/latest-metadata/download/retention verification, hot-cache behavior, and structured payload retrieval. This is not a 10M-vector database load test."
9
9
  },
10
10
  "results": [
11
11
  {
@@ -14,7 +14,7 @@
14
14
  "namespaces": 4096,
15
15
  "nodes": 4,
16
16
  "replication_factor": 2,
17
- "placement_ms": 62.552399991545826,
17
+ "placement_ms": 78.79679999314249,
18
18
  "max_replica_load": 2413,
19
19
  "min_replica_load": 1728,
20
20
  "replica_load_stdev": 316.54462560593254,
@@ -32,8 +32,8 @@
32
32
  "capacity": 512,
33
33
  "hit_rate": 0.92,
34
34
  "evictions": 0,
35
- "avg_lookup_ms": 0.0013917501782998443,
36
- "p99_lookup_ms": 0.0026999623514711857
35
+ "avg_lookup_ms": 0.0016424998175352812,
36
+ "p99_lookup_ms": 0.003800028935074806
37
37
  },
38
38
  {
39
39
  "engine": "WaveMind replicated runtime",
@@ -47,8 +47,8 @@
47
47
  "tombstone_suppressed_before_repair": true,
48
48
  "tombstone_suppressed_after_repair": true,
49
49
  "tombstone_repair_deleted_records": 1,
50
- "avg_query_after_loss_ms": 1.3142999960109591,
51
- "p99_query_after_loss_ms": 1.3142999960109591
50
+ "avg_query_after_loss_ms": 1.9631999894045293,
51
+ "p99_query_after_loss_ms": 1.9631999894045293
52
52
  },
53
53
  {
54
54
  "engine": "WaveMind active-active delta sync",
@@ -56,7 +56,7 @@
56
56
  "replication_factor_per_region": 3,
57
57
  "records_imported": 6,
58
58
  "converged_after_bidirectional_sync": true,
59
- "sync_ms": 159.69160001259297,
59
+ "sync_ms": 114.70850004116073,
60
60
  "suppressed_stale_import_after_delete": true,
61
61
  "tombstone_deleted_records": 3,
62
62
  "tombstone_converged": true
@@ -68,9 +68,12 @@
68
68
  "offsite_verified": true,
69
69
  "archive_verified": true,
70
70
  "object_store_verified": true,
71
+ "object_store_latest_verified": true,
72
+ "object_store_pruned": 2,
73
+ "object_store_download_verified": true,
71
74
  "total_bytes": 110592,
72
- "snapshot_ms": 186.24169996473938,
73
- "restore_ms": 24.853000009898096,
75
+ "snapshot_ms": 176.10959999728948,
76
+ "restore_ms": 47.905499988701195,
74
77
  "restored_files": 3,
75
78
  "recalled_after_restore_node_loss": true
76
79
  },
@@ -84,8 +87,8 @@
84
87
  ],
85
88
  "queries": 4,
86
89
  "precision_at_1": 1.0,
87
- "avg_latency_ms": 0.4099500220036134,
88
- "p99_latency_ms": 0.6203000084497035
90
+ "avg_latency_ms": 0.5878500087419525,
91
+ "p99_latency_ms": 0.8010999881662428
89
92
  }
90
93
  ]
91
94
  }
@@ -4,7 +4,7 @@ services:
4
4
  context: .
5
5
  args:
6
6
  INSTALL_OPTIONAL: "false"
7
- image: wavemind:2.3.0
7
+ image: wavemind:2.3.2
8
8
  restart: unless-stopped
9
9
  environment:
10
10
  WAVEMIND_DB: /data/wavemind.sqlite3
@@ -31,7 +31,7 @@ purpose-built vector databases.
31
31
  | NoMIRACL Russian retrieval | WaveMind reaches `nDCG@10 0.434`; Chroma reaches `0.435`; Qdrant reaches `0.433`. Chroma is faster. | `benchmarks/nomiracl_russian_results.json` | `python benchmarks/nomiracl_russian_benchmark.py --engines wavemind chroma qdrant --output benchmarks/nomiracl_russian_results.json` |
32
32
  | Production index profile | At 50000 vectors, persisted FAISS and Qdrant service both reach `recall@10 1.000`; pgvector with `ef_search=400` reaches `0.811`. | `benchmarks/production_index_profile_results.json` | `docker compose -f examples/production-index-profile/docker-compose.yml run --rm benchmark` |
33
33
  | Production load profile | At 100000 vectors, Qdrant service reaches `recall@10 1.000`, avg `10.28 ms`, p99 `21.26 ms`. At 1M vectors, tuned Qdrant reaches `0.984`, avg `116.80 ms`, p99 `209.28 ms`; the best EF-sweep point reaches `0.977`, avg `64.76 ms`, p99 `103.77 ms`. | `benchmarks/production_load_qdrant_100k_tuned_results.json`, `benchmarks/production_load_qdrant_1m_tuned_results.json`, `benchmarks/production_load_qdrant_1m_ef_sweep_results.json` | `python benchmarks/production_load_benchmark.py --sizes 100000 --engines qdrant-service` |
34
- | Scale readiness profile | Deterministic 1M-memory simulation: namespace placement survives node loss and zone loss at `1.000`, hot-cache hit rate is `0.920`, replicated runtime survives node loss, active-active delta sync converges, replicated snapshot restore survives primary loss, offsite mirror verification is `true`, portable archive verification is `true`, S3-compatible upload verification is `true`, structured payload precision@1 is `1.000`. | `benchmarks/scale_readiness_results.json` | `python benchmarks/scale_readiness_benchmark.py --simulated-memories 1000000 --output benchmarks/scale_readiness_results.json` |
34
+ | Scale readiness profile | Deterministic 1M-memory simulation: namespace placement survives node loss and zone loss at `1.000`, hot-cache hit rate is `0.920`, replicated runtime survives node loss, active-active delta sync converges, replicated snapshot restore survives primary loss, offsite mirror verification is `true`, portable archive verification is `true`, S3-compatible upload verification is `true`, latest remote archive metadata verification is `true`, remote archive download verification is `true`, object-store retention prunes `2` stale archives, structured payload precision@1 is `1.000`. | `benchmarks/scale_readiness_results.json` | `python benchmarks/scale_readiness_benchmark.py --simulated-memories 1000000 --output benchmarks/scale_readiness_results.json` |
35
35
  | Memory competitor adapter profile | WaveMind reaches `precision@1 0.80`, `precision@3 1.00`, stale suppression `1.00`; Mem0, Zep, and LangGraph are skipped until real packages/services are configured. | `benchmarks/memory_competitor_results.json` | `python benchmarks/memory_competitor_benchmark.py --engines wavemind mem0 zep langgraph` |
36
36
 
37
37
  The generated matrix view is in `benchmarks/BENCHMARK_REPORT.md`; the compact