feat(docs): update configuration examples to use nested config syntax

This commit updates documentation examples across multiple files to demonstrate the new nested configuration structure for HTM. The changes include:

- Replacing flat configuration attributes like `embedding_provider` with nested attributes like `config.embedding.provider`
- Adding a new configuration example for job and chunking settings
- Maintaining consistency in configuration syntax across documentation files

The update reflects a likely change in the library's configuration API, providing clearer and more modular configuration options.

Author: MadBomber

docs/api/yard/HTM/Configuration.md

@@ -16,37 +16,48 @@ HTM uses RubyLLM for multi-provider LLM support. Supported providers:
 *   :deepseek (DeepSeek)
 
 
-**`@example`**
+**`@example`** Using nested configuration sections
 ```ruby
 HTM.configure do |config|
-  config.embedding_provider = :openai
-  config.embedding_model = 'text-embedding-3-small'
-  config.tag_provider = :openai
-  config.tag_model = 'gpt-4o-mini'
+  config.embedding.provider = :openai
+  config.embedding.model = 'text-embedding-3-small'
+  config.tag.provider = :openai
+  config.tag.model = 'gpt-4o-mini'
   config.openai_api_key = ENV['OPENAI_API_KEY']
 end
 ```
-**`@example`**
+**`@example`** Using Ollama (local default)
 ```ruby
 HTM.configure do |config|
-  config.embedding_provider = :ollama
-  config.embedding_model = 'nomic-embed-text'
-  config.tag_provider = :ollama
-  config.tag_model = 'llama3'
+  config.embedding.provider = :ollama
+  config.embedding.model = 'nomic-embed-text'
+  config.tag.provider = :ollama
+  config.tag.model = 'llama3'
   config.ollama_url = 'http://localhost:11434'
 end
 ```
-**`@example`**
+**`@example`** Mixed providers
 ```ruby
 HTM.configure do |config|
-  config.embedding_provider = :openai
-  config.embedding_model = 'text-embedding-3-small'
+  config.embedding.provider = :openai
+  config.embedding.model = 'text-embedding-3-small'
   config.openai_api_key = ENV['OPENAI_API_KEY']
-  config.tag_provider = :anthropic
-  config.tag_model = 'claude-3-haiku-20240307'
+  config.tag.provider = :anthropic
+  config.tag.model = 'claude-3-haiku-20240307'
   config.anthropic_api_key = ENV['ANTHROPIC_API_KEY']
 end
 ```
+**`@example`** Job and chunking configuration
+```ruby
+HTM.configure do |config|
+  config.job.backend = :inline  # or :sidekiq, :active_job, :thread
+  config.chunking.size = 1024
+  config.chunking.overlap = 64
+  config.proposition.enabled = true
+  config.proposition.provider = :ollama
+  config.proposition.model = 'gemma3:latest'
+end
+```
 **`@example`**
 ```ruby
 HTM.configure do |config|

docs/api/yard/HTM/JobAdapter.md

@@ -18,7 +18,7 @@ Supported backends:
 **`@example`**
 ```ruby
 HTM.configure do |config|
-  config.job_backend = :active_job
+  config.job.backend = :active_job
 end
 ```
 **`@example`**

docs/api/yard/HTM/Railtie.md

@@ -20,8 +20,8 @@ This railtie automatically configures HTM when Rails boots:
 ```ruby
 # config/initializers/htm.rb
 HTM.configure do |config|
-  config.embedding_model = 'custom-model'
-  config.tag_model = 'custom-tag-model'
+  config.embedding.model = 'custom-model'
+  config.tag.model = 'custom-tag-model'
 end
 ```
 

docs/getting-started/quick-start.md

@@ -125,10 +125,10 @@ Create an HTM instance for your robot:
 ```ruby
 # Configure HTM globally (optional - uses Ollama by default)
 HTM.configure do |config|
-  config.embedding_provider = :ollama
-  config.embedding_model = 'nomic-embed-text:latest'
-  config.tag_provider = :ollama
-  config.tag_model = 'gemma3:latest'
+  config.embedding.provider = :ollama
+  config.embedding.model = 'nomic-embed-text:latest'
+  config.tag.provider = :ollama
+  config.tag.model = 'gemma3:latest'
 end
 
 # Initialize HTM with a robot name
@@ -338,10 +338,10 @@ puts "=" * 60
 
 # Step 1: Configure and initialize HTM
 HTM.configure do |config|
-  config.embedding_provider = :ollama
-  config.embedding_model = 'nomic-embed-text:latest'
-  config.tag_provider = :ollama
-  config.tag_model = 'gemma3:latest'
+  config.embedding.provider = :ollama
+  config.embedding.model = 'nomic-embed-text:latest'
+  config.tag.provider = :ollama
+  config.tag.model = 'gemma3:latest'
 end
 
 htm = HTM.new(
@@ -522,8 +522,8 @@ htm = HTM.new(
 
 # Try different embedding models via configure
 HTM.configure do |config|
-  config.embedding_provider = :ollama
-  config.embedding_model = 'llama3:latest'  # Use Llama3
+  config.embedding.provider = :ollama
+  config.embedding.model = 'llama3:latest'  # Use Llama3
 end
 
 # Try different recall strategies

docs/guides/robot-groups.md

@@ -89,10 +89,10 @@ require 'htm'
 
 # Configure HTM
 HTM.configure do |config|
-  config.embedding_provider = :ollama
-  config.embedding_model = 'nomic-embed-text'
-  config.tag_provider = :ollama
-  config.tag_model = 'llama3'
+  config.embedding.provider = :ollama
+  config.embedding.model = 'nomic-embed-text'
+  config.tag.provider = :ollama
+  config.tag.model = 'llama3'
 end
 
 # Create a robot group with active and passive members
@@ -386,8 +386,8 @@ group_name = 'distributed-service'
 
 # Configure HTM
 HTM.configure do |config|
-  config.embedding_provider = :ollama
-  config.embedding_model = 'nomic-embed-text'
+  config.embedding.provider = :ollama
+  config.embedding.model = 'nomic-embed-text'
 end
 
 # Create HTM instance for this worker

docs/index.md

@@ -81,10 +81,10 @@ require 'htm'
 
 # Configure HTM globally (optional - uses Ollama by default)
 HTM.configure do |config|
-  config.embedding_provider = :ollama
-  config.embedding_model = 'nomic-embed-text:latest'
-  config.tag_provider = :ollama
-  config.tag_model = 'gemma3:latest'
+  config.embedding.provider = :ollama
+  config.embedding.model = 'nomic-embed-text:latest'
+  config.tag.provider = :ollama
+  config.tag.model = 'gemma3:latest'
 end
 
 # Initialize HTM for your robot

docs/multi_framework_support.md

@@ -15,7 +15,7 @@ require 'htm'
 
 # Configure for CLI (synchronous execution)
 HTM.configure do |config|
-  config.job_backend = :inline  # Jobs run immediately
+  config.job.backend = :inline  # Jobs run immediately
 end
 
 htm = HTM.new(robot_name: "cli_assistant")
@@ -151,7 +151,7 @@ HTM.configuration.job_backend  # => :thread
 
 ```ruby
 HTM.configure do |config|
-  config.job_backend = :inline  # Force synchronous
+  config.job.backend = :inline  # Force synchronous
 end
 ```
 
@@ -177,7 +177,7 @@ export HTM_JOB_BACKEND=inline  # Override auto-detection
 ```ruby
 # Use inline backend
 HTM.configure do |config|
-  config.job_backend = :inline
+  config.job.backend = :inline
 
   # CLI-friendly logging
   config.logger.formatter = proc do |severity, datetime, progname, msg|
@@ -253,8 +253,8 @@ gem 'htm'
 
 # config/initializers/htm.rb (optional)
 HTM.configure do |config|
-  config.embedding_model = 'nomic-embed-text'
-  config.tag_model = 'llama3'
+  config.embedding.model = 'nomic-embed-text'
+  config.tag.model = 'llama3'
 end
 ```
 
@@ -397,8 +397,8 @@ bundle exec sidekiq
 ```ruby
 # Use faster/smaller models
 HTM.configure do |config|
-  config.embedding_model = 'all-minilm'  # Smaller, faster
-  config.tag_model = 'gemma2:2b'         # Smaller model
+  config.embedding.model = 'all-minilm'  # Smaller, faster
+  config.tag.model = 'gemma2:2b'         # Smaller model
 end
 
 # Or disable features
@@ -438,7 +438,7 @@ end
 
 # After (explicit inline):
 HTM.configure do |config|
-  config.job_backend = :inline
+  config.job.backend = :inline
 end
 # Jobs run synchronously, guaranteed to complete
 ```