htm 0.0.15 → 0.0.18

data/lib/htm.rb

@@ -2,7 +2,7 @@
 
 require_relative "htm/version"
 require_relative "htm/errors"
-require_relative "htm/configuration"
+require_relative "htm/config"
 require_relative "htm/circuit_breaker"
 require_relative "htm/active_record_config"
 require_relative "htm/database"
@@ -70,7 +70,7 @@ class HTM
   #
   # @param working_memory_size [Integer] Maximum tokens for working memory (default: 128,000)
   # @param robot_name [String] Human-readable name for this robot (auto-generated if not provided)
-  # @param db_config [Hash] Database configuration (uses ENV['HTM_DBURL'] if not provided)
+  # @param db_config [Hash] Database configuration (uses ENV['HTM_DATABASE__URL'] if not provided)
   # @param db_pool_size [Integer] Database connection pool size (default: 5)
   # @param db_query_timeout [Integer] Database query timeout in milliseconds (default: 30000)
   # @param db_cache_size [Integer] Number of database query results to cache (default: 1000, use 0 to disable)
@@ -170,7 +170,7 @@ class HTM
       enqueue_tags_job(node_id, manual_tags: tags)
 
       # Enqueue proposition extraction if enabled and not already a proposition
-      if HTM.configuration.extract_propositions && !metadata[:is_proposition]
+      if HTM.config.extract_propositions && !metadata[:is_proposition]
         enqueue_propositions_job(node_id)
       end
     else
@@ -251,7 +251,6 @@ class HTM
     normalized_timeframe = if timeframe == :auto
       result = HTM::Timeframe.normalize(:auto, query: topic)
       search_query = result.query  # Use cleaned query for search
-      HTM.logger.debug "Auto-extracted timeframe: #{result.extracted.inspect}" if result.extracted
       result.timeframe
     else
       HTM::Timeframe.normalize(timeframe)
@@ -595,7 +594,6 @@ class HTM
         tag = HTM::Models::Tag.find_or_create_by!(name: tag_name)
         HTM::Models::NodeTag.find_or_create_by!(node_id: node_id, tag_id: tag.id)
       end
-      HTM.logger.debug "Added #{manual_tags.length} manual tags to node #{node_id}"
     end
 
     # Enqueue tag generation using configured job backend
@@ -679,4 +677,125 @@ class HTM
     end
   end
 
+  # ===========================================================================
+  # Class Methods
+  # ===========================================================================
+
+  class << self
+    # Get current configuration (singleton)
+    #
+    # @return [HTM::Config]
+    #
+    def config
+      @config ||= Config.new
+    end
+
+    # Alias for backward compatibility
+    alias configuration config
+
+    # Configure HTM
+    #
+    # @yield [config] Configuration object
+    # @yieldparam config [HTM::Config]
+    #
+    # @example Custom configuration
+    #   HTM.configure do |config|
+    #     config.embedding_generator = ->(text) { MyEmbedder.embed(text) }
+    #     config.tag_extractor = ->(text, ontology) { MyTagger.extract(text, ontology) }
+    #   end
+    #
+    # @example Default configuration
+    #   HTM.configure  # Uses RubyLLM defaults
+    #
+    def configure
+      yield(config) if block_given?
+      config.validate!
+      config
+    end
+
+    # Reset configuration to defaults
+    def reset_configuration!
+      @config = nil
+    end
+
+    # Get current environment
+    #
+    # @return [String] Current environment name
+    #
+    def env
+      Config.env
+    end
+
+    # Check if running in test environment
+    #
+    # @return [Boolean]
+    #
+    def test?
+      env == 'test'
+    end
+
+    # Check if running in development environment
+    #
+    # @return [Boolean]
+    #
+    def development?
+      env == 'development'
+    end
+
+    # Check if running in production environment
+    #
+    # @return [Boolean]
+    #
+    def production?
+      env == 'production'
+    end
+
+    # Generate embedding using EmbeddingService
+    #
+    # @param text [String] Text to embed
+    # @return [Array<Float>] Embedding vector (original, not padded)
+    #
+    def embed(text)
+      result = HTM::EmbeddingService.generate(text)
+      result[:embedding]
+    end
+
+    # Extract tags using TagService
+    #
+    # @param text [String] Text to analyze
+    # @param existing_ontology [Array<String>] Sample of existing tags for context
+    # @return [Array<String>] Extracted and validated tag names
+    #
+    def extract_tags(text, existing_ontology: [])
+      HTM::TagService.extract(text, existing_ontology: existing_ontology)
+    end
+
+    # Extract propositions using PropositionService
+    #
+    # @param text [String] Text to analyze
+    # @return [Array<String>] Extracted atomic propositions
+    #
+    def extract_propositions(text)
+      HTM::PropositionService.extract(text)
+    end
+
+    # Count tokens using configured counter
+    #
+    # @param text [String] Text to count tokens for
+    # @return [Integer] Token count
+    #
+    def count_tokens(text)
+      config.token_counter.call(text)
+    rescue StandardError => e
+      raise HTM::ValidationError, "Token counting failed: #{e.message}"
+    end
+
+    # Get configured logger
+    #
+    # @return [Logger] Configured logger instance
+    #
+    def logger
+      config.logger
+    end
+  end
 end

data/lib/tasks/htm.rake

@@ -68,14 +68,13 @@ namespace :htm do
       end
     end
 
-    desc "Verify database connection (respects RAILS_ENV)"
+    desc "Verify database connection (respects HTM_ENV/RAILS_ENV)"
     task :verify do
       require 'htm'
 
-      env = ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
       config = HTM::ActiveRecordConfig.load_database_config
 
-      puts "Verifying HTM database connection (#{env})..."
+      puts "Verifying HTM database connection (#{HTM.env})..."
       puts "  Host: #{config[:host]}"
       puts "  Port: #{config[:port]}"
       puts "  Database: #{config[:database]}"
@@ -107,14 +106,13 @@ namespace :htm do
       end
     end
 
-    desc "Open PostgreSQL console (respects RAILS_ENV)"
+    desc "Open PostgreSQL console (respects HTM_ENV/RAILS_ENV)"
     task :console do
       require 'htm'
 
-      env = ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
       config = HTM::ActiveRecordConfig.load_database_config
 
-      puts "Connecting to #{config[:database]} (#{env})..."
+      puts "Connecting to #{config[:database]} (#{HTM.env})..."
       exec "psql", "-h", config[:host],
                    "-p", config[:port].to_s,
                    "-U", config[:username],
@@ -416,15 +414,14 @@ namespace :htm do
       end
     end
 
-    desc "Create database if it doesn't exist (respects RAILS_ENV)"
+    desc "Create database if it doesn't exist (respects HTM_ENV/RAILS_ENV)"
     task :create do
       require 'htm'
 
-      env = ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
       config = HTM::ActiveRecordConfig.load_database_config
       db_name = config[:database]
 
-      puts "Creating database: #{db_name} (#{env})"
+      puts "Creating database: #{db_name} (#{HTM.env})"
 
       admin_config = config.dup
       admin_config[:database] = 'postgres'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: htm
 version: !ruby/object:Gem::Version
-  version: 0.0.15
+  version: 0.0.18
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -149,6 +149,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: anyway_config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -256,7 +270,7 @@ description: |
 email:
 - dvanhoozer@gmail.com
 executables:
-- htm_mcp.rb
+- htm_mcp
 extensions: []
 extra_rdoc_files: []
 files:
@@ -290,8 +304,7 @@ files:
 - README.md
 - Rakefile
 - SETUP.md
-- bin/htm_mcp.rb
-- config/database.yml
+- bin/htm_mcp
 - db/migrate/00001_enable_extensions.rb
 - db/migrate/00002_create_robots.rb
 - db/migrate/00003_create_file_sources.rb
@@ -454,11 +467,65 @@ files:
 - examples/basic_usage.rb
 - examples/cli_app/README.md
 - examples/cli_app/htm_cli.rb
+- examples/config_file_example/README.md
+- examples/config_file_example/config/htm.local.yml
+- examples/config_file_example/custom_config.yml
+- examples/config_file_example/show_config.rb
 - examples/custom_llm_configuration.rb
 - examples/example_app/Rakefile
 - examples/example_app/app.rb
 - examples/file_loader_usage.rb
 - examples/mcp_client.rb
+- examples/rails_app/.gitignore
+- examples/rails_app/Gemfile
+- examples/rails_app/Gemfile.lock
+- examples/rails_app/Procfile.dev
+- examples/rails_app/README.md
+- examples/rails_app/Rakefile
+- examples/rails_app/app/assets/stylesheets/application.css
+- examples/rails_app/app/assets/stylesheets/inter-font.css
+- examples/rails_app/app/controllers/application_controller.rb
+- examples/rails_app/app/controllers/dashboard_controller.rb
+- examples/rails_app/app/controllers/files_controller.rb
+- examples/rails_app/app/controllers/memories_controller.rb
+- examples/rails_app/app/controllers/robots_controller.rb
+- examples/rails_app/app/controllers/search_controller.rb
+- examples/rails_app/app/controllers/tags_controller.rb
+- examples/rails_app/app/javascript/application.js
+- examples/rails_app/app/javascript/controllers/application.js
+- examples/rails_app/app/javascript/controllers/index.js
+- examples/rails_app/app/views/dashboard/index.html.erb
+- examples/rails_app/app/views/files/index.html.erb
+- examples/rails_app/app/views/files/new.html.erb
+- examples/rails_app/app/views/files/show.html.erb
+- examples/rails_app/app/views/layouts/application.html.erb
+- examples/rails_app/app/views/memories/_memory_card.html.erb
+- examples/rails_app/app/views/memories/deleted.html.erb
+- examples/rails_app/app/views/memories/edit.html.erb
+- examples/rails_app/app/views/memories/index.html.erb
+- examples/rails_app/app/views/memories/new.html.erb
+- examples/rails_app/app/views/memories/show.html.erb
+- examples/rails_app/app/views/robots/index.html.erb
+- examples/rails_app/app/views/robots/new.html.erb
+- examples/rails_app/app/views/robots/show.html.erb
+- examples/rails_app/app/views/search/index.html.erb
+- examples/rails_app/app/views/shared/_navbar.html.erb
+- examples/rails_app/app/views/shared/_stat_card.html.erb
+- examples/rails_app/app/views/tags/index.html.erb
+- examples/rails_app/app/views/tags/show.html.erb
+- examples/rails_app/bin/dev
+- examples/rails_app/bin/rails
+- examples/rails_app/bin/rake
+- examples/rails_app/config.ru
+- examples/rails_app/config/application.rb
+- examples/rails_app/config/boot.rb
+- examples/rails_app/config/database.yml
+- examples/rails_app/config/environment.rb
+- examples/rails_app/config/importmap.rb
+- examples/rails_app/config/routes.rb
+- examples/rails_app/config/tailwind.config.js
+- examples/rails_app/log/.keep
+- examples/rails_app/tmp/local_secret.txt
 - examples/robot_groups/multi_process.rb
 - examples/robot_groups/robot_worker.rb
 - examples/robot_groups/same_process.rb
@@ -473,7 +540,8 @@ files:
 - lib/htm.rb
 - lib/htm/active_record_config.rb
 - lib/htm/circuit_breaker.rb
-- lib/htm/configuration.rb
+- lib/htm/config.rb
+- lib/htm/config/defaults.yml
 - lib/htm/database.rb
 - lib/htm/embedding_service.rb
 - lib/htm/errors.rb
@@ -482,8 +550,10 @@ files:
 - lib/htm/jobs/generate_embedding_job.rb
 - lib/htm/jobs/generate_propositions_job.rb
 - lib/htm/jobs/generate_tags_job.rb
+- lib/htm/loaders/defaults_loader.rb
 - lib/htm/loaders/markdown_chunker.rb
 - lib/htm/loaders/markdown_loader.rb
+- lib/htm/loaders/xdg_config_loader.rb
 - lib/htm/long_term_memory.rb
 - lib/htm/long_term_memory/fulltext_search.rb
 - lib/htm/long_term_memory/hybrid_search.rb
@@ -492,6 +562,11 @@ files:
 - lib/htm/long_term_memory/robot_operations.rb
 - lib/htm/long_term_memory/tag_operations.rb
 - lib/htm/long_term_memory/vector_search.rb
+- lib/htm/mcp/cli.rb
+- lib/htm/mcp/group_tools.rb
+- lib/htm/mcp/resources.rb
+- lib/htm/mcp/server.rb
+- lib/htm/mcp/tools.rb
 - lib/htm/models/file_source.rb
 - lib/htm/models/node.rb
 - lib/htm/models/node_tag.rb
@@ -541,7 +616,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.0
+rubygems_version: 4.0.2
 specification_version: 4
 summary: Hierarchical Temporal Memory for LLM robots
 test_files: []