htm 0.0.14 → 0.0.15

data/docs/api/yard/index.csv

@@ -15,10 +15,23 @@ HTM::Observability.record_query_timing,Method,HTM/Observability.md#method-c-reco
 HTM::Observability.record_tag_timing,Method,HTM/Observability.md#method-c-record_tag_timing
 HTM::Observability.reset_metrics!,Method,HTM/Observability.md#method-c-reset_metrics!
 HTM::Observability.service_timing_stats,Method,HTM/Observability.md#method-c-service_timing_stats
+HTM::Telemetry,Module,HTM/Telemetry.md
+HTM::Telemetry.cache_operations,Method,HTM/Telemetry.md#method-c-cache_operations
+HTM::Telemetry.embedding_latency,Method,HTM/Telemetry.md#method-c-embedding_latency
+HTM::Telemetry.enabled?,Method,HTM/Telemetry.md#method-c-enabled?
+HTM::Telemetry.job_counter,Method,HTM/Telemetry.md#method-c-job_counter
+HTM::Telemetry.measure,Method,HTM/Telemetry.md#method-c-measure
+HTM::Telemetry.meter,Method,HTM/Telemetry.md#method-c-meter
+HTM::Telemetry.reset!,Method,HTM/Telemetry.md#method-c-reset!
+HTM::Telemetry.sdk_available?,Method,HTM/Telemetry.md#method-c-sdk_available?
+HTM::Telemetry.search_latency,Method,HTM/Telemetry.md#method-c-search_latency
+HTM::Telemetry.setup,Method,HTM/Telemetry.md#method-c-setup
+HTM::Telemetry.tag_latency,Method,HTM/Telemetry.md#method-c-tag_latency
 HTM,Class,HTM.md
 HTM.configure,Method,HTM.md#method-c-configure
 HTM.count_tokens,Method,HTM.md#method-c-count_tokens
 HTM.embed,Method,HTM.md#method-c-embed
+HTM.extract_propositions,Method,HTM.md#method-c-extract_propositions
 HTM.extract_tags,Method,HTM.md#method-c-extract_tags
 HTM.logger,Method,HTM.md#method-c-logger
 HTM.reset_configuration!,Method,HTM.md#method-c-reset_configuration!
@@ -55,6 +68,11 @@ azure_endpoint,Attribute,HTM/Configuration.md#attribute-i-azure_endpoint
 bedrock_access_key,Attribute,HTM/Configuration.md#attribute-i-bedrock_access_key
 bedrock_region,Attribute,HTM/Configuration.md#attribute-i-bedrock_region
 bedrock_secret_key,Attribute,HTM/Configuration.md#attribute-i-bedrock_secret_key
+chunk_overlap,Attribute,HTM/Configuration.md#attribute-i-chunk_overlap
+chunk_size,Attribute,HTM/Configuration.md#attribute-i-chunk_size
+circuit_breaker_failure_threshold,Attribute,HTM/Configuration.md#attribute-i-circuit_breaker_failure_threshold
+circuit_breaker_half_open_max_calls,Attribute,HTM/Configuration.md#attribute-i-circuit_breaker_half_open_max_calls
+circuit_breaker_reset_timeout,Attribute,HTM/Configuration.md#attribute-i-circuit_breaker_reset_timeout
 connection_timeout,Attribute,HTM/Configuration.md#attribute-i-connection_timeout
 deepseek_api_key,Attribute,HTM/Configuration.md#attribute-i-deepseek_api_key
 embedding_dimensions,Attribute,HTM/Configuration.md#attribute-i-embedding_dimensions
@@ -62,19 +80,32 @@ embedding_generator,Attribute,HTM/Configuration.md#attribute-i-embedding_generat
 embedding_model,Attribute,HTM/Configuration.md#attribute-i-embedding_model
 embedding_provider,Attribute,HTM/Configuration.md#attribute-i-embedding_provider
 embedding_timeout,Attribute,HTM/Configuration.md#attribute-i-embedding_timeout
+extract_propositions,Attribute,HTM/Configuration.md#attribute-i-extract_propositions
 gemini_api_key,Attribute,HTM/Configuration.md#attribute-i-gemini_api_key
 huggingface_api_key,Attribute,HTM/Configuration.md#attribute-i-huggingface_api_key
 job_backend,Attribute,HTM/Configuration.md#attribute-i-job_backend
 logger,Attribute,HTM/Configuration.md#attribute-i-logger
+max_embedding_dimension,Attribute,HTM/Configuration.md#attribute-i-max_embedding_dimension
+max_tag_depth,Attribute,HTM/Configuration.md#attribute-i-max_tag_depth
 ollama_url,Attribute,HTM/Configuration.md#attribute-i-ollama_url
 openai_api_key,Attribute,HTM/Configuration.md#attribute-i-openai_api_key
 openai_organization,Attribute,HTM/Configuration.md#attribute-i-openai_organization
 openai_project,Attribute,HTM/Configuration.md#attribute-i-openai_project
 openrouter_api_key,Attribute,HTM/Configuration.md#attribute-i-openrouter_api_key
+proposition_extractor,Attribute,HTM/Configuration.md#attribute-i-proposition_extractor
+proposition_model,Attribute,HTM/Configuration.md#attribute-i-proposition_model
+proposition_provider,Attribute,HTM/Configuration.md#attribute-i-proposition_provider
+proposition_timeout,Attribute,HTM/Configuration.md#attribute-i-proposition_timeout
+relevance_access_weight,Attribute,HTM/Configuration.md#attribute-i-relevance_access_weight
+relevance_recency_half_life_hours,Attribute,HTM/Configuration.md#attribute-i-relevance_recency_half_life_hours
+relevance_recency_weight,Attribute,HTM/Configuration.md#attribute-i-relevance_recency_weight
+relevance_semantic_weight,Attribute,HTM/Configuration.md#attribute-i-relevance_semantic_weight
+relevance_tag_weight,Attribute,HTM/Configuration.md#attribute-i-relevance_tag_weight
 tag_extractor,Attribute,HTM/Configuration.md#attribute-i-tag_extractor
 tag_model,Attribute,HTM/Configuration.md#attribute-i-tag_model
 tag_provider,Attribute,HTM/Configuration.md#attribute-i-tag_provider
 tag_timeout,Attribute,HTM/Configuration.md#attribute-i-tag_timeout
+telemetry_enabled,Attribute,HTM/Configuration.md#attribute-i-telemetry_enabled
 token_counter,Attribute,HTM/Configuration.md#attribute-i-token_counter
 week_start,Attribute,HTM/Configuration.md#attribute-i-week_start
 HTM::Database,Class,HTM/Database.md
@@ -94,6 +125,7 @@ HTM::EmbeddingService,Class,HTM/EmbeddingService.md
 HTM::EmbeddingService.circuit_breaker,Method,HTM/EmbeddingService.md#method-c-circuit_breaker
 HTM::EmbeddingService.format_for_storage,Method,HTM/EmbeddingService.md#method-c-format_for_storage
 HTM::EmbeddingService.generate,Method,HTM/EmbeddingService.md#method-c-generate
+HTM::EmbeddingService.max_dimension,Method,HTM/EmbeddingService.md#method-c-max_dimension
 HTM::EmbeddingService.pad_embedding,Method,HTM/EmbeddingService.md#method-c-pad_embedding
 HTM::EmbeddingService.reset_circuit_breaker!,Method,HTM/EmbeddingService.md#method-c-reset_circuit_breaker!
 HTM::EmbeddingService.validate_embedding!,Method,HTM/EmbeddingService.md#method-c-validate_embedding!
@@ -103,51 +135,87 @@ HTM::ResourceExhaustedError,Class,HTM/ResourceExhaustedError.md
 HTM::NotFoundError,Class,HTM/NotFoundError.md
 HTM::EmbeddingError,Class,HTM/EmbeddingError.md
 HTM::TagError,Class,HTM/TagError.md
+HTM::PropositionError,Class,HTM/PropositionError.md
 HTM::DatabaseError,Class,HTM/DatabaseError.md
 HTM::QueryTimeoutError,Class,HTM/QueryTimeoutError.md
 HTM::AuthorizationError,Class,HTM/AuthorizationError.md
 HTM::CircuitBreakerOpenError,Class,HTM/CircuitBreakerOpenError.md
 HTM::LongTermMemory,Class,HTM/LongTermMemory.md
-HTM::LongTermMemory.add,Method,HTM/LongTermMemory.md#method-i-add
-HTM::LongTermMemory.add_tag,Method,HTM/LongTermMemory.md#method-i-add_tag
-HTM::LongTermMemory.batch_load_node_tags,Method,HTM/LongTermMemory.md#method-i-batch_load_node_tags
-HTM::LongTermMemory.calculate_relevance,Method,HTM/LongTermMemory.md#method-i-calculate_relevance
 HTM::LongTermMemory.clear_cache!,Method,HTM/LongTermMemory.md#method-i-clear_cache!
-HTM::LongTermMemory.delete,Method,HTM/LongTermMemory.md#method-i-delete
-HTM::LongTermMemory.exists?,Method,HTM/LongTermMemory.md#method-i-exists?
-HTM::LongTermMemory.find_query_matching_tags,Method,HTM/LongTermMemory.md#method-i-find_query_matching_tags
-HTM::LongTermMemory.get_node_tags,Method,HTM/LongTermMemory.md#method-i-get_node_tags
 HTM::LongTermMemory.initialize,Method,HTM/LongTermMemory.md#method-i-initialize
-HTM::LongTermMemory.link_robot_to_node,Method,HTM/LongTermMemory.md#method-i-link_robot_to_node
-HTM::LongTermMemory.mark_evicted,Method,HTM/LongTermMemory.md#method-i-mark_evicted
-HTM::LongTermMemory.node_topics,Method,HTM/LongTermMemory.md#method-i-node_topics
-HTM::LongTermMemory.nodes_by_topic,Method,HTM/LongTermMemory.md#method-i-nodes_by_topic
-HTM::LongTermMemory.ontology_structure,Method,HTM/LongTermMemory.md#method-i-ontology_structure
 HTM::LongTermMemory.pool_size,Method,HTM/LongTermMemory.md#method-i-pool_size
-HTM::LongTermMemory.popular_tags,Method,HTM/LongTermMemory.md#method-i-popular_tags
-HTM::LongTermMemory.register_robot,Method,HTM/LongTermMemory.md#method-i-register_robot
-HTM::LongTermMemory.retrieve,Method,HTM/LongTermMemory.md#method-i-retrieve
-HTM::LongTermMemory.search,Method,HTM/LongTermMemory.md#method-i-search
-HTM::LongTermMemory.search_by_tags,Method,HTM/LongTermMemory.md#method-i-search_by_tags
-HTM::LongTermMemory.search_fulltext,Method,HTM/LongTermMemory.md#method-i-search_fulltext
-HTM::LongTermMemory.search_hybrid,Method,HTM/LongTermMemory.md#method-i-search_hybrid
-HTM::LongTermMemory.search_with_relevance,Method,HTM/LongTermMemory.md#method-i-search_with_relevance
 HTM::LongTermMemory.shutdown,Method,HTM/LongTermMemory.md#method-i-shutdown
 HTM::LongTermMemory.stats,Method,HTM/LongTermMemory.md#method-i-stats
-HTM::LongTermMemory.topic_relationships,Method,HTM/LongTermMemory.md#method-i-topic_relationships
-HTM::LongTermMemory.track_access,Method,HTM/LongTermMemory.md#method-i-track_access
-HTM::LongTermMemory.update_last_accessed,Method,HTM/LongTermMemory.md#method-i-update_last_accessed
-HTM::LongTermMemory.update_robot_activity,Method,HTM/LongTermMemory.md#method-i-update_robot_activity
 query_timeout,Attribute,HTM/LongTermMemory.md#attribute-i-query_timeout
+HTM::PropositionService,Class,HTM/PropositionService.md
+HTM::PropositionService.circuit_breaker,Method,HTM/PropositionService.md#method-c-circuit_breaker
+HTM::PropositionService.extract,Method,HTM/PropositionService.md#method-c-extract
+HTM::PropositionService.parse_propositions,Method,HTM/PropositionService.md#method-c-parse_propositions
+HTM::PropositionService.reset_circuit_breaker!,Method,HTM/PropositionService.md#method-c-reset_circuit_breaker!
+HTM::PropositionService.valid_proposition?,Method,HTM/PropositionService.md#method-c-valid_proposition?
+HTM::PropositionService.validate_and_filter_propositions,Method,HTM/PropositionService.md#method-c-validate_and_filter_propositions
+HTM::QueryCache,Class,HTM/QueryCache.md
+HTM::QueryCache.clear!,Method,HTM/QueryCache.md#method-i-clear!
+HTM::QueryCache.enabled?,Method,HTM/QueryCache.md#method-i-enabled?
+HTM::QueryCache.fetch,Method,HTM/QueryCache.md#method-i-fetch
+HTM::QueryCache.initialize,Method,HTM/QueryCache.md#method-i-initialize
+HTM::QueryCache.invalidate!,Method,HTM/QueryCache.md#method-i-invalidate!
+HTM::QueryCache.invalidate_methods!,Method,HTM/QueryCache.md#method-i-invalidate_methods!
+HTM::QueryCache.stats,Method,HTM/QueryCache.md#method-i-stats
+enabled,Attribute,HTM/QueryCache.md#attribute-i-enabled
 HTM::Railtie,Class,HTM/Railtie.md
+HTM::RobotGroup,Class,HTM/RobotGroup.md
+HTM::RobotGroup.active?,Method,HTM/RobotGroup.md#method-i-active?
+HTM::RobotGroup.active_robot_names,Method,HTM/RobotGroup.md#method-i-active_robot_names
+HTM::RobotGroup.add_active,Method,HTM/RobotGroup.md#method-i-add_active
+HTM::RobotGroup.add_passive,Method,HTM/RobotGroup.md#method-i-add_passive
+HTM::RobotGroup.clear_working_memory,Method,HTM/RobotGroup.md#method-i-clear_working_memory
+HTM::RobotGroup.demote,Method,HTM/RobotGroup.md#method-i-demote
+HTM::RobotGroup.failover!,Method,HTM/RobotGroup.md#method-i-failover!
+HTM::RobotGroup.in_sync?,Method,HTM/RobotGroup.md#method-i-in_sync?
+HTM::RobotGroup.initialize,Method,HTM/RobotGroup.md#method-i-initialize
+HTM::RobotGroup.member?,Method,HTM/RobotGroup.md#method-i-member?
+HTM::RobotGroup.member_ids,Method,HTM/RobotGroup.md#method-i-member_ids
+HTM::RobotGroup.passive?,Method,HTM/RobotGroup.md#method-i-passive?
+HTM::RobotGroup.passive_robot_names,Method,HTM/RobotGroup.md#method-i-passive_robot_names
+HTM::RobotGroup.promote,Method,HTM/RobotGroup.md#method-i-promote
+HTM::RobotGroup.recall,Method,HTM/RobotGroup.md#method-i-recall
+HTM::RobotGroup.remember,Method,HTM/RobotGroup.md#method-i-remember
+HTM::RobotGroup.remove,Method,HTM/RobotGroup.md#method-i-remove
+HTM::RobotGroup.shutdown,Method,HTM/RobotGroup.md#method-i-shutdown
+HTM::RobotGroup.status,Method,HTM/RobotGroup.md#method-i-status
+HTM::RobotGroup.sync_all,Method,HTM/RobotGroup.md#method-i-sync_all
+HTM::RobotGroup.sync_robot,Method,HTM/RobotGroup.md#method-i-sync_robot
+HTM::RobotGroup.sync_stats,Method,HTM/RobotGroup.md#method-i-sync_stats
+HTM::RobotGroup.transfer_working_memory,Method,HTM/RobotGroup.md#method-i-transfer_working_memory
+HTM::RobotGroup.working_memory_contents,Method,HTM/RobotGroup.md#method-i-working_memory_contents
+channel,Attribute,HTM/RobotGroup.md#attribute-i-channel
+max_tokens,Attribute,HTM/RobotGroup.md#attribute-i-max_tokens
+name,Attribute,HTM/RobotGroup.md#attribute-i-name
+HTM::SqlBuilder,Class,HTM/SqlBuilder.md
+HTM::SqlBuilder.apply_metadata,Method,HTM/SqlBuilder.md#method-c-apply_metadata
+HTM::SqlBuilder.apply_timeframe,Method,HTM/SqlBuilder.md#method-c-apply_timeframe
+HTM::SqlBuilder.metadata_condition,Method,HTM/SqlBuilder.md#method-c-metadata_condition
+HTM::SqlBuilder.pad_embedding,Method,HTM/SqlBuilder.md#method-c-pad_embedding
+HTM::SqlBuilder.sanitize_embedding,Method,HTM/SqlBuilder.md#method-c-sanitize_embedding
+HTM::SqlBuilder.sanitize_like_pattern,Method,HTM/SqlBuilder.md#method-c-sanitize_like_pattern
+HTM::SqlBuilder.timeframe_condition,Method,HTM/SqlBuilder.md#method-c-timeframe_condition
 HTM::TagService,Class,HTM/TagService.md
 HTM::TagService.circuit_breaker,Method,HTM/TagService.md#method-c-circuit_breaker
 HTM::TagService.extract,Method,HTM/TagService.md#method-c-extract
+HTM::TagService.max_depth,Method,HTM/TagService.md#method-c-max_depth
 HTM::TagService.parse_hierarchy,Method,HTM/TagService.md#method-c-parse_hierarchy
 HTM::TagService.parse_tags,Method,HTM/TagService.md#method-c-parse_tags
 HTM::TagService.reset_circuit_breaker!,Method,HTM/TagService.md#method-c-reset_circuit_breaker!
 HTM::TagService.valid_tag?,Method,HTM/TagService.md#method-c-valid_tag?
 HTM::TagService.validate_and_filter_tags,Method,HTM/TagService.md#method-c-validate_and_filter_tags
+HTM::Telemetry::NullMeter,Class,HTM/Telemetry/NullMeter.md
+HTM::Telemetry::NullMeter.create_counter,Method,HTM/Telemetry/NullMeter.md#method-i-create_counter
+HTM::Telemetry::NullMeter.create_histogram,Method,HTM/Telemetry/NullMeter.md#method-i-create_histogram
+HTM::Telemetry::NullMeter.create_up_down_counter,Method,HTM/Telemetry/NullMeter.md#method-i-create_up_down_counter
+HTM::Telemetry::NullInstrument,Class,HTM/Telemetry/NullInstrument.md
+HTM::Telemetry::NullInstrument.add,Method,HTM/Telemetry/NullInstrument.md#method-i-add
+HTM::Telemetry::NullInstrument.record,Method,HTM/Telemetry/NullInstrument.md#method-i-record
 HTM::TimeframeExtractor,Class,HTM/TimeframeExtractor.md
 HTM::TimeframeExtractor.extract,Method,HTM/TimeframeExtractor.md#method-c-extract
 HTM::TimeframeExtractor.temporal?,Method,HTM/TimeframeExtractor.md#method-c-temporal?
@@ -162,6 +230,15 @@ HTM::Timeframe::Result,Class,HTM/Timeframe/Result.md
 extracted,Attribute,HTM/Timeframe/Result.md#attribute-i-extracted
 query,Attribute,HTM/Timeframe/Result.md#attribute-i-query
 timeframe,Attribute,HTM/Timeframe/Result.md#attribute-i-timeframe
+HTM::WorkingMemoryChannel,Class,HTM/WorkingMemoryChannel.md
+HTM::WorkingMemoryChannel.channel_name,Method,HTM/WorkingMemoryChannel.md#method-i-channel_name
+HTM::WorkingMemoryChannel.initialize,Method,HTM/WorkingMemoryChannel.md#method-i-initialize
+HTM::WorkingMemoryChannel.listening?,Method,HTM/WorkingMemoryChannel.md#method-i-listening?
+HTM::WorkingMemoryChannel.notify,Method,HTM/WorkingMemoryChannel.md#method-i-notify
+HTM::WorkingMemoryChannel.on_change,Method,HTM/WorkingMemoryChannel.md#method-i-on_change
+HTM::WorkingMemoryChannel.start_listening,Method,HTM/WorkingMemoryChannel.md#method-i-start_listening
+HTM::WorkingMemoryChannel.stop_listening,Method,HTM/WorkingMemoryChannel.md#method-i-stop_listening
+notifications_received,Attribute,HTM/WorkingMemoryChannel.md#attribute-i-notifications_received
 HTM::WorkingMemory,Class,HTM/WorkingMemory.md
 HTM::WorkingMemory.add,Method,HTM/WorkingMemory.md#method-i-add
 HTM::WorkingMemory.add_from_sync,Method,HTM/WorkingMemory.md#method-i-add_from_sync

data/docs/api/yard-reference.md

@@ -30,12 +30,20 @@ Complete API documentation generated by [YARD](https://yardoc.org/) with [yard-m
 | [HTM::JobAdapter](yard/HTM/JobAdapter.md) | Background job abstraction layer |
 | [HTM::LongTermMemory](yard/HTM/LongTermMemory.md) | PostgreSQL-backed permanent storage |
 | [HTM::Observability](yard/HTM/Observability.md) | Metrics and logging instrumentation |
+| [HTM::PropositionService](yard/HTM/PropositionService.md) | HTM::PropositionService class |
+| [HTM::QueryCache](yard/HTM/QueryCache.md) | HTM::QueryCache class |
+| [HTM::RobotGroup](yard/HTM/RobotGroup.md) | HTM::RobotGroup class |
+| [HTM::SqlBuilder](yard/HTM/SqlBuilder.md) | HTM::SqlBuilder class |
 | [HTM::TagService](yard/HTM/TagService.md) | Hierarchical tag extraction service |
+| [HTM::Telemetry](yard/HTM/Telemetry.md) | HTM::Telemetry class |
+| [HTM::Telemetry::NullInstrument](yard/HTM/Telemetry/NullInstrument.md) | HTM::Telemetry::NullInstrument class |
+| [HTM::Telemetry::NullMeter](yard/HTM/Telemetry/NullMeter.md) | HTM::Telemetry::NullMeter class |
 | [HTM::Timeframe](yard/HTM/Timeframe.md) | Time-based query filtering |
 | [HTM::Timeframe::Result](yard/HTM/Timeframe/Result.md) | HTM::Timeframe::Result class |
 | [HTM::TimeframeExtractor](yard/HTM/TimeframeExtractor.md) | Natural language time parsing |
 | [HTM::TimeframeExtractor::Result](yard/HTM/TimeframeExtractor/Result.md) | HTM::TimeframeExtractor::Result class |
 | [HTM::WorkingMemory](yard/HTM/WorkingMemory.md) | Token-limited in-memory cache |
+| [HTM::WorkingMemoryChannel](yard/HTM/WorkingMemoryChannel.md) | HTM::WorkingMemoryChannel class |
 
 ## Generating Documentation
 

data/docs/assets/images/multi-provider-failover.svg

@@ -0,0 +1,51 @@
+<svg viewBox="0 0 800 400" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <!-- Title -->
+  <text x="400" y="30" text-anchor="middle" fill="#E0E0E0" font-size="16" font-weight="bold">Multi-Provider Failover Strategy</text>
+
+  <!-- Primary -->
+  <rect x="50" y="80" width="200" height="100" fill="rgba(76, 175, 80, 0.2)" stroke="#4CAF50" stroke-width="2" rx="5"/>
+  <text x="150" y="105" text-anchor="middle" fill="#4CAF50" font-size="12" font-weight="bold">PRIMARY</text>
+  <text x="150" y="130" text-anchor="middle" fill="#E0E0E0" font-size="14">OpenAI GPT-4</text>
+  <text x="150" y="155" text-anchor="middle" fill="#B0B0B0" font-size="10">Fast, cost-effective</text>
+  <text x="150" y="170" text-anchor="middle" fill="#B0B0B0" font-size="10">JSON output format</text>
+
+  <!-- Standby 1 -->
+  <rect x="300" y="80" width="200" height="100" fill="rgba(255, 152, 0, 0.2)" stroke="#FF9800" stroke-width="2" rx="5"/>
+  <text x="400" y="105" text-anchor="middle" fill="#FF9800" font-size="12" font-weight="bold">STANDBY 1</text>
+  <text x="400" y="130" text-anchor="middle" fill="#E0E0E0" font-size="14">Anthropic Claude</text>
+  <text x="400" y="155" text-anchor="middle" fill="#B0B0B0" font-size="10">Different provider</text>
+  <text x="400" y="170" text-anchor="middle" fill="#B0B0B0" font-size="10">XML output format</text>
+
+  <!-- Standby 2 -->
+  <rect x="550" y="80" width="200" height="100" fill="rgba(255, 152, 0, 0.2)" stroke="#FF9800" stroke-width="2" rx="5"/>
+  <text x="650" y="105" text-anchor="middle" fill="#FF9800" font-size="12" font-weight="bold">STANDBY 2</text>
+  <text x="650" y="130" text-anchor="middle" fill="#E0E0E0" font-size="14">Google Gemini</text>
+  <text x="650" y="155" text-anchor="middle" fill="#B0B0B0" font-size="10">Third provider option</text>
+  <text x="650" y="170" text-anchor="middle" fill="#B0B0B0" font-size="10">Markdown output format</text>
+
+  <!-- Arrows -->
+  <path d="M 250 130 L 290 130" stroke="#4CAF50" stroke-width="2" marker-end="url(#arrow-fail)"/>
+  <path d="M 500 130 L 540 130" stroke="#FF9800" stroke-width="2" marker-end="url(#arrow-fail)"/>
+  <text x="270" y="120" fill="#F44336" font-size="10">failover</text>
+  <text x="520" y="120" fill="#F44336" font-size="10">failover</text>
+
+  <!-- Shared Context Box -->
+  <rect x="150" y="230" width="500" height="80" fill="rgba(33, 150, 243, 0.15)" stroke="#2196F3" stroke-width="2" rx="5"/>
+  <text x="400" y="260" text-anchor="middle" fill="#E0E0E0" font-size="14" font-weight="bold">Shared Working Memory</text>
+  <text x="400" y="285" text-anchor="middle" fill="#2196F3" font-size="12">Same context across all providers</text>
+
+  <!-- Connections to shared -->
+  <line x1="150" y1="180" x2="200" y2="230" stroke="#4CAF50" stroke-width="1.5"/>
+  <line x1="400" y1="180" x2="400" y2="230" stroke="#FF9800" stroke-width="1.5"/>
+  <line x1="650" y1="180" x2="600" y2="230" stroke="#FF9800" stroke-width="1.5"/>
+
+  <!-- Key points -->
+  <text x="400" y="350" text-anchor="middle" fill="#4CAF50" font-size="12">Context is shared</text>
+  <text x="400" y="370" text-anchor="middle" fill="#F44336" font-size="12">Prompts are provider-specific</text>
+
+  <defs>
+    <marker id="arrow-fail" markerWidth="10" markerHeight="10" refX="9" refY="3" orient="auto">
+      <polygon points="0 0, 10 3, 0 6" fill="#F44336"/>
+    </marker>
+  </defs>
+</svg>

data/docs/assets/images/robot-group-architecture.svg

@@ -0,0 +1,65 @@
+<svg viewBox="0 0 900 550" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <!-- Title -->
+  <text x="450" y="30" text-anchor="middle" fill="#E0E0E0" font-size="18" font-weight="bold">Robot Group: Shared Working Memory + Real-Time Sync</text>
+
+  <!-- Active Robot 1 -->
+  <rect x="50" y="80" width="220" height="120" fill="rgba(76, 175, 80, 0.2)" stroke="#4CAF50" stroke-width="2" rx="5"/>
+  <text x="160" y="105" text-anchor="middle" fill="#4CAF50" font-size="12" font-weight="bold">ACTIVE</text>
+  <text x="160" y="130" text-anchor="middle" fill="#E0E0E0" font-size="14" font-weight="bold">Primary Agent</text>
+  <text x="160" y="155" text-anchor="middle" fill="#B0B0B0" font-size="11">Working Memory: 5 nodes</text>
+  <text x="160" y="175" text-anchor="middle" fill="#B0B0B0" font-size="11">Provider: OpenAI</text>
+
+  <!-- Active Robot 2 -->
+  <rect x="340" y="80" width="220" height="120" fill="rgba(76, 175, 80, 0.2)" stroke="#4CAF50" stroke-width="2" rx="5"/>
+  <text x="450" y="105" text-anchor="middle" fill="#4CAF50" font-size="12" font-weight="bold">ACTIVE</text>
+  <text x="450" y="130" text-anchor="middle" fill="#E0E0E0" font-size="14" font-weight="bold">Secondary Agent</text>
+  <text x="450" y="155" text-anchor="middle" fill="#B0B0B0" font-size="11">Working Memory: 5 nodes</text>
+  <text x="450" y="175" text-anchor="middle" fill="#B0B0B0" font-size="11">Provider: Anthropic</text>
+
+  <!-- Passive Robot -->
+  <rect x="630" y="80" width="220" height="120" fill="rgba(255, 152, 0, 0.2)" stroke="#FF9800" stroke-width="2" rx="5"/>
+  <text x="740" y="105" text-anchor="middle" fill="#FF9800" font-size="12" font-weight="bold">PASSIVE (Standby)</text>
+  <text x="740" y="130" text-anchor="middle" fill="#E0E0E0" font-size="14" font-weight="bold">Backup Agent</text>
+  <text x="740" y="155" text-anchor="middle" fill="#B0B0B0" font-size="11">Working Memory: 5 nodes</text>
+  <text x="740" y="175" text-anchor="middle" fill="#B0B0B0" font-size="11">Provider: Gemini</text>
+
+  <!-- Sync Layer -->
+  <rect x="100" y="250" width="700" height="80" fill="rgba(33, 150, 243, 0.15)" stroke="#2196F3" stroke-width="2" rx="5"/>
+  <text x="450" y="280" text-anchor="middle" fill="#E0E0E0" font-size="14" font-weight="bold">Real-Time Sync Layer</text>
+  <text x="450" y="305" text-anchor="middle" fill="#2196F3" font-size="12">PostgreSQL LISTEN/NOTIFY (HTM::WorkingMemoryChannel)</text>
+
+  <!-- Connections to sync layer -->
+  <line x1="160" y1="200" x2="160" y2="250" stroke="#4CAF50" stroke-width="2" marker-end="url(#arrow-green)"/>
+  <line x1="450" y1="200" x2="450" y2="250" stroke="#4CAF50" stroke-width="2" marker-end="url(#arrow-green)"/>
+  <line x1="740" y1="200" x2="740" y2="250" stroke="#FF9800" stroke-width="2" marker-end="url(#arrow-orange)"/>
+
+  <!-- Shared Long-Term Memory -->
+  <ellipse cx="450" cy="430" rx="200" ry="80" fill="rgba(156, 39, 176, 0.2)" stroke="#9C27B0" stroke-width="3"/>
+  <text x="450" y="415" text-anchor="middle" fill="#E0E0E0" font-size="14" font-weight="bold">Shared Long-Term Memory</text>
+  <text x="450" y="440" text-anchor="middle" fill="#B0B0B0" font-size="12">PostgreSQL (Hive Mind)</text>
+  <text x="450" y="460" text-anchor="middle" fill="#9C27B0" font-size="11">All Robots Access Here</text>
+
+  <!-- Connection from sync to LTM -->
+  <line x1="450" y1="330" x2="450" y2="350" stroke="#9C27B0" stroke-width="2" marker-end="url(#arrow-purple)"/>
+
+  <!-- Arrows -->
+  <defs>
+    <marker id="arrow-green" markerWidth="10" markerHeight="10" refX="9" refY="3" orient="auto">
+      <polygon points="0 0, 10 3, 0 6" fill="#4CAF50"/>
+    </marker>
+    <marker id="arrow-orange" markerWidth="10" markerHeight="10" refX="9" refY="3" orient="auto">
+      <polygon points="0 0, 10 3, 0 6" fill="#FF9800"/>
+    </marker>
+    <marker id="arrow-purple" markerWidth="10" markerHeight="10" refX="9" refY="3" orient="auto">
+      <polygon points="0 0, 10 3, 0 6" fill="#9C27B0"/>
+    </marker>
+  </defs>
+
+  <!-- Legend -->
+  <rect x="50" y="520" width="15" height="15" fill="rgba(76, 175, 80, 0.3)" stroke="#4CAF50"/>
+  <text x="75" y="532" fill="#B0B0B0" font-size="11">Active (handles requests)</text>
+  <rect x="250" y="520" width="15" height="15" fill="rgba(255, 152, 0, 0.3)" stroke="#FF9800"/>
+  <text x="275" y="532" fill="#B0B0B0" font-size="11">Passive (warm standby)</text>
+  <rect x="450" y="520" width="15" height="15" fill="rgba(33, 150, 243, 0.3)" stroke="#2196F3"/>
+  <text x="475" y="532" fill="#B0B0B0" font-size="11">Real-time sync</text>
+</svg>

data/docs/database/README.md

@@ -5,12 +5,12 @@
 | Name | Columns | Comment | Type |
 | ---- | ------- | ------- | ---- |
 | [public.file_sources](public.file_sources.md) | 9 | Source file metadata for loaded documents | BASE TABLE |
-| [public.node_tags](public.node_tags.md) | 4 | Join table connecting nodes to tags (many-to-many) | BASE TABLE |
+| [public.node_tags](public.node_tags.md) | 5 | Join table connecting nodes to tags (many-to-many) | BASE TABLE |
 | [public.nodes](public.nodes.md) | 14 | Core memory storage for conversation messages and context | BASE TABLE |
-| [public.robot_nodes](public.robot_nodes.md) | 9 | Join table connecting robots to nodes (many-to-many) | BASE TABLE |
+| [public.robot_nodes](public.robot_nodes.md) | 10 | Join table connecting robots to nodes (many-to-many) | BASE TABLE |
 | [public.robots](public.robots.md) | 4 | Registry of all LLM robots using the HTM system | BASE TABLE |
 | [public.schema_migrations](public.schema_migrations.md) | 1 |  | BASE TABLE |
-| [public.tags](public.tags.md) | 3 | Unique tag names for categorization | BASE TABLE |
+| [public.tags](public.tags.md) | 4 | Unique tag names for categorization | BASE TABLE |
 
 ## Stored procedures and functions
 

data/docs/database/public.file_sources.svg

@@ -4,11 +4,11 @@
 <!-- Generated by graphviz version 12.1.2 (20240928.0832)
  -->
 <!-- Title: public.file_sources Pages: 1 -->
-<svg width="1329pt" height="1469pt"
- viewBox="0.00 0.00 1328.70 1468.80" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1464.8)">
+<svg width="1329pt" height="1500pt"
+ viewBox="0.00 0.00 1328.70 1499.60" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1495.6)">
 <title>public.file_sources</title>
-<polygon fill="white" stroke="none" points="-4,4 -4,-1464.8 1324.7,-1464.8 1324.7,4 -4,4"/>
+<polygon fill="white" stroke="none" points="-4,4 -4,-1495.6 1324.7,-1495.6 1324.7,4 -4,4"/>
 <!-- public.file_sources -->
 <g id="node1" class="node">
 <title>public.file_sources</title>
@@ -128,16 +128,20 @@
 <!-- public.node_tags -->
 <g id="node3" class="node">
 <title>public.node_tags</title>
-<polygon fill="#efefef" stroke="none" points="43.2,-1294.6 43.2,-1340.6 512.41,-1340.6 512.41,-1294.6 43.2,-1294.6"/>
-<polygon fill="none" stroke="black" points="43.2,-1294.6 43.2,-1340.6 512.41,-1340.6 512.41,-1294.6 43.2,-1294.6"/>
-<text text-anchor="start" x="154.32" y="-1318.4" font-family="Arial Bold" font-size="18.00">public.node_tags</text>
-<text text-anchor="start" x="276.8" y="-1318.4" font-family="Arial" font-size="14.00">    </text>
-<text text-anchor="start" x="307.92" y="-1318.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
-<text text-anchor="start" x="116.72" y="-1304" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting nodes to tags (many&#45;to&#45;many)</text>
+<polygon fill="#efefef" stroke="none" points="43.2,-1325.4 43.2,-1371.4 512.41,-1371.4 512.41,-1325.4 43.2,-1325.4"/>
+<polygon fill="none" stroke="black" points="43.2,-1325.4 43.2,-1371.4 512.41,-1371.4 512.41,-1325.4 43.2,-1325.4"/>
+<text text-anchor="start" x="154.32" y="-1349.2" font-family="Arial Bold" font-size="18.00">public.node_tags</text>
+<text text-anchor="start" x="276.8" y="-1349.2" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="307.92" y="-1349.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
+<text text-anchor="start" x="116.72" y="-1334.8" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting nodes to tags (many&#45;to&#45;many)</text>
+<polygon fill="none" stroke="black" points="43.2,-1294.6 43.2,-1325.4 512.41,-1325.4 512.41,-1294.6 43.2,-1294.6"/>
+<text text-anchor="start" x="50.2" y="-1306.8" font-family="Arial" font-size="14.00">created_at </text>
+<text text-anchor="start" x="120.25" y="-1306.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
+<text text-anchor="start" x="285.97" y="-1306.8" font-family="Arial" font-size="14.00"> When this association was created</text>
 <polygon fill="none" stroke="black" points="43.2,-1263.8 43.2,-1294.6 512.41,-1294.6 512.41,-1263.8 43.2,-1263.8"/>
-<text text-anchor="start" x="50.2" y="-1276" font-family="Arial" font-size="14.00">created_at </text>
-<text text-anchor="start" x="120.25" y="-1276" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
-<text text-anchor="start" x="285.97" y="-1276" font-family="Arial" font-size="14.00"> When this association was created</text>
+<text text-anchor="start" x="50.2" y="-1276" font-family="Arial" font-size="14.00">deleted_at </text>
+<text text-anchor="start" x="119.48" y="-1276" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
+<text text-anchor="start" x="285.21" y="-1276" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
 <polygon fill="none" stroke="black" points="43.2,-1233 43.2,-1263.8 512.41,-1263.8 512.41,-1233 43.2,-1233"/>
 <text text-anchor="start" x="50.2" y="-1245.2" font-family="Arial" font-size="14.00">id </text>
 <text text-anchor="start" x="64.99" y="-1245.2" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
@@ -160,15 +164,19 @@
 <!-- public.robot_nodes -->
 <g id="node4" class="node">
 <title>public.robot_nodes</title>
-<polygon fill="#efefef" stroke="none" points="617.06,-1371.6 617.06,-1417.6 1246.55,-1417.6 1246.55,-1371.6 617.06,-1371.6"/>
-<polygon fill="none" stroke="black" points="617.06,-1371.6 617.06,-1417.6 1246.55,-1417.6 1246.55,-1371.6 617.06,-1371.6"/>
-<text text-anchor="start" x="800.32" y="-1395.4" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
-<text text-anchor="start" x="938.8" y="-1395.4" font-family="Arial" font-size="14.00">    </text>
-<text text-anchor="start" x="969.92" y="-1395.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
-<text text-anchor="start" x="764.5" y="-1381" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
+<polygon fill="#efefef" stroke="none" points="617.06,-1402.4 617.06,-1448.4 1246.55,-1448.4 1246.55,-1402.4 617.06,-1402.4"/>
+<polygon fill="none" stroke="black" points="617.06,-1402.4 617.06,-1448.4 1246.55,-1448.4 1246.55,-1402.4 617.06,-1402.4"/>
+<text text-anchor="start" x="800.32" y="-1426.2" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
+<text text-anchor="start" x="938.8" y="-1426.2" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="969.92" y="-1426.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
+<text text-anchor="start" x="764.5" y="-1411.8" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
+<polygon fill="none" stroke="black" points="617.06,-1371.6 617.06,-1402.4 1246.55,-1402.4 1246.55,-1371.6 617.06,-1371.6"/>
+<text text-anchor="start" x="624.06" y="-1383.8" font-family="Arial" font-size="14.00">created_at </text>
+<text text-anchor="start" x="694.11" y="-1383.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
 <polygon fill="none" stroke="black" points="617.06,-1340.8 617.06,-1371.6 1246.55,-1371.6 1246.55,-1340.8 617.06,-1340.8"/>
-<text text-anchor="start" x="624.06" y="-1353" font-family="Arial" font-size="14.00">created_at </text>
-<text text-anchor="start" x="694.11" y="-1353" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
+<text text-anchor="start" x="624.06" y="-1353" font-family="Arial" font-size="14.00">deleted_at </text>
+<text text-anchor="start" x="693.34" y="-1353" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
+<text text-anchor="start" x="859.07" y="-1353" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
 <polygon fill="none" stroke="black" points="617.06,-1310 617.06,-1340.8 1246.55,-1340.8 1246.55,-1310 617.06,-1310"/>
 <text text-anchor="start" x="624.06" y="-1322.2" font-family="Arial" font-size="14.00">first_remembered_at </text>
 <text text-anchor="start" x="757.12" y="-1322.2" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>

data/docs/database/public.node_tags.md

@@ -9,6 +9,7 @@ Join table connecting nodes to tags (many-to-many)
 | Name | Type | Default | Nullable | Children | Parents | Comment |
 | ---- | ---- | ------- | -------- | -------- | ------- | ------- |
 | created_at | timestamp with time zone | CURRENT_TIMESTAMP | true |  |  | When this association was created |
+| deleted_at | timestamp with time zone |  | true |  |  | Soft delete timestamp |
 | id | bigint | nextval('node_tags_id_seq'::regclass) | false |  |  |  |
 | node_id | bigint |  | false |  | [public.nodes](public.nodes.md) | ID of the node being tagged |
 | tag_id | bigint |  | false |  | [public.tags](public.tags.md) | ID of the tag being applied |
@@ -25,6 +26,7 @@ Join table connecting nodes to tags (many-to-many)
 
 | Name | Definition |
 | ---- | ---------- |
+| idx_node_tags_deleted_at | CREATE INDEX idx_node_tags_deleted_at ON public.node_tags USING btree (deleted_at) |
 | idx_node_tags_node_id | CREATE INDEX idx_node_tags_node_id ON public.node_tags USING btree (node_id) |
 | idx_node_tags_tag_id | CREATE INDEX idx_node_tags_tag_id ON public.node_tags USING btree (tag_id) |
 | idx_node_tags_unique | CREATE UNIQUE INDEX idx_node_tags_unique ON public.node_tags USING btree (node_id, tag_id) |