smart_brain 0.1.2 → 0.2.0

data/lib/smart_brain/version.rb

@@ -1,5 +1,5 @@
-# frozen_string_literal: true
-
-module SmartBrain
-  VERSION = "0.1.2"
-end
+# frozen_string_literal: true
+
+module SmartBrain
+  VERSION = '0.2.0'
+end

data/lib/smart_brain.rb

@@ -1,35 +1,80 @@
-# frozen_string_literal: true
-
-require 'time'
-require_relative 'smart_brain/version'
-require_relative 'smart_brain/configuration'
-require_relative 'smart_brain/runtime'
-
-module SmartBrain
-  class << self
-    attr_writer :runtime
-
-    def configure(config_path: nil, smart_rag_client: nil, clock: -> { Time.now.utc })
-      config = Configuration.load(config_path)
-      @runtime = Runtime.build(config: config, smart_rag_client: smart_rag_client, clock: clock)
-    end
-
-    def commit_turn(session_id:, turn_events:)
-      runtime.commit_turn(session_id: session_id, turn_events: turn_events)
-    end
-
-    def compose_context(session_id:, user_message:, agent_state: {})
-      runtime.compose_context(session_id: session_id, user_message: user_message, agent_state: agent_state)
-    end
-
-    def diagnostics
-      runtime.diagnostics
-    end
-
-    private
-
-    def runtime
-      @runtime ||= Runtime.build(config: Configuration.load, clock: -> { Time.now.utc })
-    end
-  end
-end
+# frozen_string_literal: true
+
+require 'time'
+require_relative 'smart_brain/version'
+require_relative 'smart_brain/configuration'
+require_relative 'smart_brain/runtime'
+
+module SmartBrain
+  class << self
+    attr_writer :runtime
+
+    def configure(config_path: nil, smart_rag_client: nil, clock: -> { Time.now.utc })
+      config = Configuration.load(config_path)
+      @runtime = Runtime.build(config: config, smart_rag_client: smart_rag_client, clock: clock)
+    end
+
+    def commit_turn(session_id:, turn_events:, domain_id: nil, scope_context: nil)
+      runtime.commit_turn(session_id: session_id, turn_events: turn_events, domain_id: domain_id, scope_context: scope_context)
+    end
+
+    def compose_context(session_id:, user_message:, agent_state: {}, domain_id: nil, scope_context: nil)
+      runtime.compose_context(
+        session_id: session_id, user_message: user_message, agent_state: agent_state,
+        domain_id: domain_id, scope_context: scope_context
+      )
+    end
+
+    def search_memory(session_id:, query:, limit: nil, domain_id: nil, scope_context: nil)
+      runtime.search_memory(
+        session_id: session_id, query: query, limit: limit, domain_id: domain_id, scope_context: scope_context
+      )
+    end
+
+    def memory_item(id:)
+      runtime.memory_item(id: id)
+    end
+
+    def storage_backend
+      runtime.storage_backend
+    end
+
+    def migrate(config_path: nil)
+      config = Configuration.load(config_path)
+      require_relative 'smart_brain/db'
+      SmartBrain::DB.migrate(SmartBrain::DB.connect(config))
+    end
+
+    def distill(...) = runtime.distill(...)
+    def gate(...) = runtime.gate(...)
+    def promote(...) = runtime.promote(...)
+    def demote(...) = runtime.demote(...)
+    def retract(...) = runtime.retract(...)
+    def promote_to_scope(...) = runtime.promote_to_scope(...)
+    def demote_from_scope(...) = runtime.demote_from_scope(...)
+    def promotion_lineage(...) = runtime.promotion_lineage(...)
+    def knowledge_events(...) = runtime.knowledge_events(...)
+
+    def kg_add(...) = runtime.kg_add(...)
+    def kg_query(...) = runtime.kg_query(...)
+    def kg_timeline(...) = runtime.kg_timeline(...)
+    def kg_invalidate(...) = runtime.kg_invalidate(...)
+    def kg_stats(...) = runtime.kg_stats(...)
+
+    def fact_check(...) = runtime.fact_check(...)
+
+    def brief(...) = runtime.brief(...)
+    def wake_up(...) = runtime.wake_up(...)
+    def resume(...) = runtime.resume(...)
+
+    def diagnostics
+      runtime.diagnostics
+    end
+
+    private
+
+    def runtime
+      @runtime ||= Runtime.build(config: Configuration.load, clock: -> { Time.now.utc })
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smart_brain
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - SmartBrain Team
@@ -79,6 +79,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: sequel
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +107,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.87'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
 - !ruby/object:Gem::Dependency
   name: smart_rag
   requirement: !ruby/object:Gem::Requirement
@@ -149,20 +177,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.3.2
-- !ruby/object:Gem::Dependency
-  name: puma
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '7.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -205,20 +219,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.13'
-- !ruby/object:Gem::Dependency
-  name: sinatra
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.2'
 - !ruby/object:Gem::Dependency
   name: smart_agent
   requirement: !ruby/object:Gem::Requirement
@@ -233,50 +233,102 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.2.3
-description: SmartBrain provides commit_turn and compose_context APIs for agent memory,
-  retrieval planning, evidence fusion, and context assembly.
+description: SmartBrain provides scoped agent memory, retrieval planning, evidence
+  fusion, governance, and context assembly.
 email:
 - team@smartbrain.dev
-executables: []
+executables:
+- smart_brain
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
+- MEMPAL_GUIDE.md
 - README.en.md
 - README.md
 - agents/brain_assistant.rb
 - config/brain.yml
 - conversation_demo.rb
 - db/migrate/001_init.sql
+- db/migrate/002_turn_events_payload.sql
+- db/migrate/003_tiers_and_lifecycle.sql
+- db/migrate/004_kg_edges.sql
+- db/migrate/005_domains_and_memory_scopes.sql
+- docs/coding_todo.md
+- docs/context_package.md
+- docs/evidence_pack.md
+- docs/gap_vs_mempal.md
+- docs/mcp.md
+- docs/memory_types.md
+- docs/multi_scope_memory_refactor_plan.md
+- docs/multi_scope_migration.md
+- docs/policies.md
+- docs/retrieval_plan.md
+- docs/smartbrain_design.md
+- docs/user_guide.md
 - example.rb
+- examples/01_memory_basic.rb
+- examples/02_governance.rb
+- examples/03_postgres_persistence.rb
+- examples/04_ollama_llm.rb
+- examples/05_smart_rag_integration.rb
+- examples/06_multi_scope_memory.rb
+- examples/README.md
+- exe/smart_brain
 - lib/smart_brain.rb
 - lib/smart_brain/adapters/smart_rag/direct_client.rb
 - lib/smart_brain/adapters/smart_rag/http_client.rb
 - lib/smart_brain/adapters/smart_rag/null_client.rb
+- lib/smart_brain/adapters/smart_rag/scope_filter.rb
 - lib/smart_brain/configuration.rb
 - lib/smart_brain/consolidator/working_summary.rb
 - lib/smart_brain/context_composer/composer.rb
 - lib/smart_brain/contracts/context_package.rb
 - lib/smart_brain/contracts/evidence_pack.rb
 - lib/smart_brain/contracts/retrieval_plan.rb
+- lib/smart_brain/contracts/scope_context.rb
+- lib/smart_brain/contracts/scope_ref.rb
+- lib/smart_brain/db.rb
 - lib/smart_brain/event_store/in_memory.rb
+- lib/smart_brain/event_store/postgres.rb
 - lib/smart_brain/fusion/merger.rb
+- lib/smart_brain/governance/briefing.rb
+- lib/smart_brain/governance/fact_check.rb
+- lib/smart_brain/governance/knowledge_graph.rb
+- lib/smart_brain/governance/lifecycle.rb
+- lib/smart_brain/governance/tiers.rb
 - lib/smart_brain/memory_extractor/extractor.rb
 - lib/smart_brain/memory_store/in_memory.rb
+- lib/smart_brain/memory_store/postgres.rb
+- lib/smart_brain/model_provider.rb
+- lib/smart_brain/model_provider/base.rb
+- lib/smart_brain/model_provider/factory.rb
+- lib/smart_brain/model_provider/ollama.rb
+- lib/smart_brain/model_provider/openai.rb
+- lib/smart_brain/model_provider/stub.rb
 - lib/smart_brain/observability/tracker.rb
 - lib/smart_brain/retrieval_planner/planner.rb
 - lib/smart_brain/retrievers/exact_retriever.rb
 - lib/smart_brain/retrievers/memory_retriever.rb
 - lib/smart_brain/retrievers/relational_retriever.rb
 - lib/smart_brain/runtime.rb
+- lib/smart_brain/scopes/conflict_resolver.rb
+- lib/smart_brain/scopes/registry.rb
+- lib/smart_brain/scopes/resolver.rb
+- lib/smart_brain/server/http_app.rb
+- lib/smart_brain/server/mcp_server.rb
+- lib/smart_brain/server/service.rb
+- lib/smart_brain/support/levenshtein.rb
 - lib/smart_brain/version.rb
 - templates/brain_assistant.erb
 - workers/brain_assistant.rb
-homepage: https://github.com/smart-ai/smart_brain
+homepage: https://github.com/zhuangbiaowei/smart_brain
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/smart-ai/smart_brain
+  source_code_uri: https://github.com/zhuangbiaowei/smart_brain
+  changelog_uri: https://github.com/zhuangbiaowei/smart_brain/blob/master/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -284,14 +336,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.13
 specification_version: 4
 summary: Agent memory runtime and context composer
 test_files: []