smart_brain 0.1.2 → 0.3.0

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 (79) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +25 -0
  3. data/MEMPAL_GUIDE.md +1074 -0
  4. data/README.en.md +206 -173
  5. data/README.md +593 -173
  6. data/config/brain.yml +69 -1
  7. data/conversation_demo.rb +438 -438
  8. data/db/migrate/002_turn_events_payload.sql +9 -0
  9. data/db/migrate/003_tiers_and_lifecycle.sql +28 -0
  10. data/db/migrate/004_kg_edges.sql +30 -0
  11. data/db/migrate/005_domains_and_memory_scopes.sql +163 -0
  12. data/docs/coding_todo.md +139 -0
  13. data/docs/context_package.md +220 -0
  14. data/docs/evidence_pack.md +190 -0
  15. data/docs/gap_vs_mempal.md +161 -0
  16. data/docs/installation.md +198 -0
  17. data/docs/mcp.md +93 -0
  18. data/docs/media_memory_schema.md +271 -0
  19. data/docs/memory_types.md +278 -0
  20. data/docs/multi_scope_memory_refactor_plan.md +483 -0
  21. data/docs/multi_scope_migration.md +65 -0
  22. data/docs/policies.md +308 -0
  23. data/docs/retrieval_plan.md +233 -0
  24. data/docs/smartbrain_design.md +299 -0
  25. data/docs/user_guide.md +547 -0
  26. data/example.rb +91 -91
  27. data/examples/01_memory_basic.rb +57 -0
  28. data/examples/02_governance.rb +63 -0
  29. data/examples/03_postgres_persistence.rb +63 -0
  30. data/examples/04_ollama_llm.rb +69 -0
  31. data/examples/05_smart_rag_integration.rb +79 -0
  32. data/examples/06_multi_scope_memory.rb +50 -0
  33. data/examples/07_media_memory.rb +53 -0
  34. data/examples/README.md +49 -0
  35. data/exe/smart_brain +168 -0
  36. data/lib/smart_brain/adapters/smart_rag/direct_client.rb +57 -5
  37. data/lib/smart_brain/adapters/smart_rag/http_client.rb +118 -5
  38. data/lib/smart_brain/adapters/smart_rag/http_transport.rb +138 -0
  39. data/lib/smart_brain/adapters/smart_rag/media_metadata_extractor.rb +255 -0
  40. data/lib/smart_brain/adapters/smart_rag/null_client.rb +44 -2
  41. data/lib/smart_brain/adapters/smart_rag/scope_filter.rb +60 -0
  42. data/lib/smart_brain/configuration.rb +60 -0
  43. data/lib/smart_brain/consolidator/working_summary.rb +80 -12
  44. data/lib/smart_brain/context_composer/composer.rb +40 -3
  45. data/lib/smart_brain/contracts/retrieval_plan.rb +10 -0
  46. data/lib/smart_brain/contracts/scope_context.rb +46 -0
  47. data/lib/smart_brain/contracts/scope_ref.rb +25 -0
  48. data/lib/smart_brain/db.rb +109 -0
  49. data/lib/smart_brain/event_store/in_memory.rb +6 -2
  50. data/lib/smart_brain/event_store/postgres.rb +199 -0
  51. data/lib/smart_brain/fusion/merger.rb +31 -2
  52. data/lib/smart_brain/governance/briefing.rb +146 -0
  53. data/lib/smart_brain/governance/fact_check.rb +110 -0
  54. data/lib/smart_brain/governance/knowledge_graph.rb +60 -0
  55. data/lib/smart_brain/governance/lifecycle.rb +225 -0
  56. data/lib/smart_brain/governance/tiers.rb +60 -0
  57. data/lib/smart_brain/memory_extractor/extractor.rb +25 -7
  58. data/lib/smart_brain/memory_store/in_memory.rb +202 -17
  59. data/lib/smart_brain/memory_store/postgres.rb +500 -0
  60. data/lib/smart_brain/model_provider/base.rb +87 -0
  61. data/lib/smart_brain/model_provider/factory.rb +49 -0
  62. data/lib/smart_brain/model_provider/ollama.rb +60 -0
  63. data/lib/smart_brain/model_provider/openai.rb +60 -0
  64. data/lib/smart_brain/model_provider/stub.rb +26 -0
  65. data/lib/smart_brain/model_provider.rb +7 -0
  66. data/lib/smart_brain/observability/tracker.rb +39 -1
  67. data/lib/smart_brain/retrievers/exact_retriever.rb +6 -0
  68. data/lib/smart_brain/retrievers/memory_retriever.rb +59 -5
  69. data/lib/smart_brain/runtime.rb +306 -16
  70. data/lib/smart_brain/scopes/conflict_resolver.rb +67 -0
  71. data/lib/smart_brain/scopes/registry.rb +133 -0
  72. data/lib/smart_brain/scopes/resolver.rb +32 -0
  73. data/lib/smart_brain/server/http_app.rb +143 -0
  74. data/lib/smart_brain/server/mcp_server.rb +385 -0
  75. data/lib/smart_brain/server/service.rb +129 -0
  76. data/lib/smart_brain/support/levenshtein.rb +35 -0
  77. data/lib/smart_brain/version.rb +5 -5
  78. data/lib/smart_brain.rb +93 -35
  79. metadata +100 -54
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 75c340badd56930942aa5962236b5fc850e2ecea1f8251feeaec57eda381c31c
4
- data.tar.gz: 9e0acf383f25d23ccb2cc9b13287ec2acd0da3b92ddd9ed6709984f1c2391d76
3
+ metadata.gz: 79a975252d1cd55bc21928851ba6c2e250ad7d6a87d26d659c025da5e18836d6
4
+ data.tar.gz: 4a5cff31efd5d411dd14e8100561a2ab6fd04678801eeb283f493261329a73c6
5
5
  SHA512:
6
- metadata.gz: 3cf6e7380e1e0902b55d2b4ece8a1fceba73ad38523dd52ae964c422aa023f1557a7a8db3de9e3b73c75a5a1864dd53bb132018323b4b3f1ab819cc3e18ae5ee
7
- data.tar.gz: ce0a1f93caa6f9cb1f22890da9dd751b2f1aa533d5dd70b0c26303d069c53f48007a8a0c6ca4363289201207dfa069af5c4b17b40fa0a169b996e8bcc3767294
6
+ metadata.gz: '01534922911c9446056dc33859bec7cb6818593a08ab59d5194beb4fb1877a104cf59535309ccf66015a4d8ac199c9bfd47d6480331a12872642dbe53d39b6cf'
7
+ data.tar.gz: 711502b6b7435e057669580b174c03425a03ccfd5f38c4d57f79307b6ec7a37e95ec6ee6090a3da36a25b435b9ed3d13ee89e9d4008206030a1cf0addb90820c
data/CHANGELOG.md ADDED
@@ -0,0 +1,25 @@
1
+ # Changelog
2
+
3
+ ## 0.3.0 - 2026-08-14
4
+
5
+ - Add document, image, audio, and video memory ingestion through the public runtime facade.
6
+ - Add asynchronous media job enqueue, status, listing, cancellation, retry, and queue statistics APIs.
7
+ - Add media metadata extraction with graceful partial-result fallbacks.
8
+ - Add multipart-capable SmartRAG HTTP transport with scoped retrieval and media operations.
9
+ - Propagate media-type resource filters into SmartRAG retrieval plans.
10
+ - Keep null, direct, and HTTP SmartRAG adapters behaviorally aligned for optional deployments.
11
+ - Require SmartRAG 0.2 for the media, principal-isolation, and durable-job contracts.
12
+
13
+ ## 0.2.0 - 2026-08-03
14
+
15
+ - Add domain-isolated global, project, expert, task, and legacy session memory scopes.
16
+ - Add multi-scope retrieval, specificity conflict resolution, scope budgets, and shadow diagnostics.
17
+ - Add PostgreSQL persistence, idempotent legacy migrations, full-text recall, and backend parity tests.
18
+ - Add knowledge lifecycle governance, cross-scope promotion provenance, retraction, fact checking, briefing, and knowledge-graph tools.
19
+ - Add HTTP, MCP, and CLI interfaces with scoped request propagation.
20
+ - Add fail-closed SmartRAG scope mapping for direct and HTTP adapters.
21
+ - Preserve compatibility for callers that only provide `session_id`.
22
+
23
+ ## 0.1.2
24
+
25
+ - Improve SmartRAG integration and Windows dependency compatibility.