smart_brain 0.1.2 → 0.3.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.3.0'
+end

data/lib/smart_brain.rb

@@ -1,35 +1,93 @@
-# 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,
+                        resource_filters: {})
+      runtime.compose_context(
+        session_id: session_id, user_message: user_message, agent_state: agent_state,
+        domain_id: domain_id, scope_context: scope_context, resource_filters: resource_filters
+      )
+    end
+
+    def add_document(source:, options: {}) = runtime.add_document(source: source, options: options)
+    def add_media(source:, options: {}) = runtime.add_media(source: source, options: options)
+    def add_image(source:, options: {}) = runtime.add_image(source: source, options: options)
+    def add_audio(source:, options: {}) = runtime.add_audio(source: source, options: options)
+    def add_video(source:, options: {}) = runtime.add_video(source: source, options: options)
+    def enqueue_media(source:, options: {}) = runtime.enqueue_media(source: source, options: options)
+    def media_job(job_id:) = runtime.media_job(job_id: job_id)
+    def media_jobs(status: nil, limit: 20, offset: 0) = runtime.media_jobs(status: status, limit: limit, offset: offset)
+    def cancel_media_job(job_id:) = runtime.cancel_media_job(job_id: job_id)
+    def retry_media_job(job_id:) = runtime.retry_media_job(job_id: job_id)
+    def media_job_statistics = runtime.media_job_statistics
+
+    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.3.0
 platform: ruby
 authors:
 - SmartBrain Team
@@ -10,75 +10,75 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: dry-struct
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '2.11'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '2.11'
 - !ruby/object:Gem::Dependency
-  name: dry-validation
+  name: faraday-multipart
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: faraday
+  name: pg
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.11'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.11'
+        version: '1.5'
 - !ruby/object:Gem::Dependency
-  name: oj
+  name: puma
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.16'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.16'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
-  name: pg
+  name: rackup
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '2.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: sequel
   requirement: !ruby/object:Gem::Requirement
@@ -94,19 +94,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '5.87'
 - !ruby/object:Gem::Dependency
-  name: smart_rag
+  name: sinatra
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '4.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '4.2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -149,20 +149,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 +191,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 +205,124 @@ 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/installation.md
+- docs/mcp.md
+- docs/media_memory_schema.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/07_media_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/http_transport.rb
+- lib/smart_brain/adapters/smart_rag/media_metadata_extractor.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
+  documentation_uri: https://github.com/zhuangbiaowei/smart_brain/blob/master/docs/user_guide.md
+post_install_message: |
+  SmartBrain 已安装（0.3.0）。默认零外部依赖：memory 后端 + stub LLM。
+
+  快速开始：
+    smart_brain --version
+    smart_brain status
+    ruby -e "require 'smart_brain'; SmartBrain.configure; p SmartBrain.compose_context(session_id: 's', user_message: '你好')"
+
+  常用配置（环境变量）：
+    SMARTBRAIN_BACKEND=postgres          # 持久化（需先建库，或 smart_brain migrate）
+    SMARTBRAIN_DB_NAME=smart_brain_development  # 其余 SMARTBRAIN_DB_{HOST,PORT,USER,PASSWORD}
+    SMARTBRAIN_LLM_PROVIDER=ollama       # 真 LLM 摘要/重排（需本地 ollama + 生成式模型如 qwen3/llama2）
+    SMARTBRAIN_LLM_BASE_URL / SMARTBRAIN_LLM_API_KEY / SMARTBRAIN_LLM_MODEL
+
+  资源 RAG（可选）：gem install smart_rag，再用 SmartBrain::Adapters::SmartRag::DirectClient / HttpClient。
+  详见 README 与 docs/user_guide.md、docs/installation.md。
 rdoc_options: []
 require_paths:
 - lib
@@ -284,14 +330,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.16
 specification_version: 4
 summary: Agent memory runtime and context composer
 test_files: []