smart_brain 0.1.2 → 0.2.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 (74) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +15 -0
  3. data/MEMPAL_GUIDE.md +1074 -0
  4. data/README.en.md +173 -173
  5. data/README.md +467 -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/mcp.md +93 -0
  17. data/docs/memory_types.md +278 -0
  18. data/docs/multi_scope_memory_refactor_plan.md +483 -0
  19. data/docs/multi_scope_migration.md +65 -0
  20. data/docs/policies.md +308 -0
  21. data/docs/retrieval_plan.md +231 -0
  22. data/docs/smartbrain_design.md +299 -0
  23. data/docs/user_guide.md +546 -0
  24. data/example.rb +91 -91
  25. data/examples/01_memory_basic.rb +57 -0
  26. data/examples/02_governance.rb +63 -0
  27. data/examples/03_postgres_persistence.rb +63 -0
  28. data/examples/04_ollama_llm.rb +69 -0
  29. data/examples/05_smart_rag_integration.rb +79 -0
  30. data/examples/06_multi_scope_memory.rb +50 -0
  31. data/examples/README.md +49 -0
  32. data/exe/smart_brain +168 -0
  33. data/lib/smart_brain/adapters/smart_rag/direct_client.rb +16 -5
  34. data/lib/smart_brain/adapters/smart_rag/http_client.rb +16 -5
  35. data/lib/smart_brain/adapters/smart_rag/null_client.rb +7 -2
  36. data/lib/smart_brain/adapters/smart_rag/scope_filter.rb +60 -0
  37. data/lib/smart_brain/configuration.rb +57 -0
  38. data/lib/smart_brain/consolidator/working_summary.rb +80 -12
  39. data/lib/smart_brain/context_composer/composer.rb +40 -3
  40. data/lib/smart_brain/contracts/retrieval_plan.rb +10 -0
  41. data/lib/smart_brain/contracts/scope_context.rb +46 -0
  42. data/lib/smart_brain/contracts/scope_ref.rb +25 -0
  43. data/lib/smart_brain/db.rb +109 -0
  44. data/lib/smart_brain/event_store/in_memory.rb +6 -2
  45. data/lib/smart_brain/event_store/postgres.rb +199 -0
  46. data/lib/smart_brain/fusion/merger.rb +31 -2
  47. data/lib/smart_brain/governance/briefing.rb +146 -0
  48. data/lib/smart_brain/governance/fact_check.rb +110 -0
  49. data/lib/smart_brain/governance/knowledge_graph.rb +60 -0
  50. data/lib/smart_brain/governance/lifecycle.rb +225 -0
  51. data/lib/smart_brain/governance/tiers.rb +60 -0
  52. data/lib/smart_brain/memory_extractor/extractor.rb +25 -7
  53. data/lib/smart_brain/memory_store/in_memory.rb +202 -17
  54. data/lib/smart_brain/memory_store/postgres.rb +500 -0
  55. data/lib/smart_brain/model_provider/base.rb +87 -0
  56. data/lib/smart_brain/model_provider/factory.rb +49 -0
  57. data/lib/smart_brain/model_provider/ollama.rb +60 -0
  58. data/lib/smart_brain/model_provider/openai.rb +60 -0
  59. data/lib/smart_brain/model_provider/stub.rb +26 -0
  60. data/lib/smart_brain/model_provider.rb +7 -0
  61. data/lib/smart_brain/observability/tracker.rb +39 -1
  62. data/lib/smart_brain/retrievers/exact_retriever.rb +6 -0
  63. data/lib/smart_brain/retrievers/memory_retriever.rb +59 -5
  64. data/lib/smart_brain/runtime.rb +288 -16
  65. data/lib/smart_brain/scopes/conflict_resolver.rb +67 -0
  66. data/lib/smart_brain/scopes/registry.rb +133 -0
  67. data/lib/smart_brain/scopes/resolver.rb +32 -0
  68. data/lib/smart_brain/server/http_app.rb +143 -0
  69. data/lib/smart_brain/server/mcp_server.rb +385 -0
  70. data/lib/smart_brain/server/service.rb +129 -0
  71. data/lib/smart_brain/support/levenshtein.rb +35 -0
  72. data/lib/smart_brain/version.rb +5 -5
  73. data/lib/smart_brain.rb +80 -35
  74. metadata +88 -36
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 75c340badd56930942aa5962236b5fc850e2ecea1f8251feeaec57eda381c31c
4
- data.tar.gz: 9e0acf383f25d23ccb2cc9b13287ec2acd0da3b92ddd9ed6709984f1c2391d76
3
+ metadata.gz: d8680f123a98c14a68780c2ef0ec315e5f2a45446c2692cc81a8fed527ecafb7
4
+ data.tar.gz: 8f782644dbe7202bd8cfe51660b88d0f5ff9c855e1d7fb3bf121e7286975bfe2
5
5
  SHA512:
6
- metadata.gz: 3cf6e7380e1e0902b55d2b4ece8a1fceba73ad38523dd52ae964c422aa023f1557a7a8db3de9e3b73c75a5a1864dd53bb132018323b4b3f1ab819cc3e18ae5ee
7
- data.tar.gz: ce0a1f93caa6f9cb1f22890da9dd751b2f1aa533d5dd70b0c26303d069c53f48007a8a0c6ca4363289201207dfa069af5c4b17b40fa0a169b996e8bcc3767294
6
+ metadata.gz: 5f7ce80bf28a81ae4d4775ace5566b007b1c80ecc02413f15609f190207ddd46776f0fa3c45e7295447adce748f406baa0622e38566b741a8bf02a13e9388342
7
+ data.tar.gz: 2ee106f092c37f5d8d96c821b9b4d1fc0995e476d545fa57dd051234eea2e244942c9593523e90024b6c648b0024c74fa805a3881ff08d2ffee6e2fcbcdfe1ea
data/CHANGELOG.md ADDED
@@ -0,0 +1,15 @@
1
+ # Changelog
2
+
3
+ ## 0.2.0 - 2026-08-03
4
+
5
+ - Add domain-isolated global, project, expert, task, and legacy session memory scopes.
6
+ - Add multi-scope retrieval, specificity conflict resolution, scope budgets, and shadow diagnostics.
7
+ - Add PostgreSQL persistence, idempotent legacy migrations, full-text recall, and backend parity tests.
8
+ - Add knowledge lifecycle governance, cross-scope promotion provenance, retraction, fact checking, briefing, and knowledge-graph tools.
9
+ - Add HTTP, MCP, and CLI interfaces with scoped request propagation.
10
+ - Add fail-closed SmartRAG scope mapping for direct and HTTP adapters.
11
+ - Preserve compatibility for callers that only provide `session_id`.
12
+
13
+ ## 0.1.2
14
+
15
+ - Improve SmartRAG integration and Windows dependency compatibility.