Deployed fb06383 with MkDocs version: 1.6.1

Author: actions-user

api/yard-reference/index.html

@@ -4291,10 +4291,34 @@ <h2 id="classes-modules">Classes &amp; Modules<a class="headerlink" href="#class
 <td>Metrics and logging instrumentation</td>
 </tr>
 <tr>
+<td><a href="../yard/HTM/PropositionService/">HTM::PropositionService</a></td>
+<td>HTM::PropositionService class</td>
+</tr>
+<tr>
+<td><a href="../yard/HTM/QueryCache/">HTM::QueryCache</a></td>
+<td>HTM::QueryCache class</td>
+</tr>
+<tr>
+<td><a href="../yard/HTM/SqlBuilder/">HTM::SqlBuilder</a></td>
+<td>HTM::SqlBuilder class</td>
+</tr>
+<tr>
 <td><a href="../yard/HTM/TagService/">HTM::TagService</a></td>
 <td>Hierarchical tag extraction service</td>
 </tr>
 <tr>
+<td><a href="../yard/HTM/Telemetry/">HTM::Telemetry</a></td>
+<td>HTM::Telemetry class</td>
+</tr>
+<tr>
+<td><a href="../yard/HTM/Telemetry/NullInstrument/">HTM::Telemetry::NullInstrument</a></td>
+<td>HTM::Telemetry::NullInstrument class</td>
+</tr>
+<tr>
+<td><a href="../yard/HTM/Telemetry/NullMeter/">HTM::Telemetry::NullMeter</a></td>
+<td>HTM::Telemetry::NullMeter class</td>
+</tr>
+<tr>
 <td><a href="../yard/HTM/Timeframe/">HTM::Timeframe</a></td>
 <td>Time-based query filtering</td>
 </tr>

api/yard/HTM/Configuration/index.html

@@ -4229,6 +4229,16 @@ <h2 id="attribute-i-bedrock_region">bedrock_region[RW]<a class="headerlink" href
 <p>Returns the value of attribute bedrock_region.</p>
 <h2 id="attribute-i-bedrock_secret_key">bedrock_secret_key[RW]<a class="headerlink" href="#attribute-i-bedrock_secret_key" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute bedrock_secret_key.</p>
+<h2 id="attribute-i-chunk_overlap">chunk_overlap[RW]<a class="headerlink" href="#attribute-i-chunk_overlap" title="Permanent link">&para;</a></h2>
+<p>Character overlap between chunks (default: 64)</p>
+<h2 id="attribute-i-chunk_size">chunk_size[RW]<a class="headerlink" href="#attribute-i-chunk_size" title="Permanent link">&para;</a></h2>
+<p>Chunking configuration (for file loading)</p>
+<h2 id="attribute-i-circuit_breaker_failure_threshold">circuit_breaker_failure_threshold[RW]<a class="headerlink" href="#attribute-i-circuit_breaker_failure_threshold" title="Permanent link">&para;</a></h2>
+<p>Circuit breaker configuration</p>
+<h2 id="attribute-i-circuit_breaker_half_open_max_calls">circuit_breaker_half_open_max_calls[RW]<a class="headerlink" href="#attribute-i-circuit_breaker_half_open_max_calls" title="Permanent link">&para;</a></h2>
+<p>Successes to close (default: 3)</p>
+<h2 id="attribute-i-circuit_breaker_reset_timeout">circuit_breaker_reset_timeout[RW]<a class="headerlink" href="#attribute-i-circuit_breaker_reset_timeout" title="Permanent link">&para;</a></h2>
+<p>Seconds before half-open (default: 60)</p>
 <h2 id="attribute-i-connection_timeout">connection_timeout[RW]<a class="headerlink" href="#attribute-i-connection_timeout" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute connection_timeout.</p>
 <h2 id="attribute-i-deepseek_api_key">deepseek_api_key[RW]<a class="headerlink" href="#attribute-i-deepseek_api_key" title="Permanent link">&para;</a></h2>
@@ -4243,6 +4253,8 @@ <h2 id="attribute-i-embedding_provider">embedding_provider[RW]<a class="headerli
 <p>Returns the value of attribute embedding_provider.</p>
 <h2 id="attribute-i-embedding_timeout">embedding_timeout[RW]<a class="headerlink" href="#attribute-i-embedding_timeout" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute embedding_timeout.</p>
+<h2 id="attribute-i-extract_propositions">extract_propositions[RW]<a class="headerlink" href="#attribute-i-extract_propositions" title="Permanent link">&para;</a></h2>
+<p>Returns the value of attribute extract_propositions.</p>
 <h2 id="attribute-i-gemini_api_key">gemini_api_key[RW]<a class="headerlink" href="#attribute-i-gemini_api_key" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute gemini_api_key.</p>
 <h2 id="attribute-i-huggingface_api_key">huggingface_api_key[RW]<a class="headerlink" href="#attribute-i-huggingface_api_key" title="Permanent link">&para;</a></h2>
@@ -4251,6 +4263,10 @@ <h2 id="attribute-i-job_backend">job_backend[RW]<a class="headerlink" href="#att
 <p>Returns the value of attribute job_backend.</p>
 <h2 id="attribute-i-logger">logger[RW]<a class="headerlink" href="#attribute-i-logger" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute logger.</p>
+<h2 id="attribute-i-max_embedding_dimension">max_embedding_dimension[RW]<a class="headerlink" href="#attribute-i-max_embedding_dimension" title="Permanent link">&para;</a></h2>
+<p>Limit configuration</p>
+<h2 id="attribute-i-max_tag_depth">max_tag_depth[RW]<a class="headerlink" href="#attribute-i-max_tag_depth" title="Permanent link">&para;</a></h2>
+<p>Max tag hierarchy depth (default: 4)</p>
 <h2 id="attribute-i-ollama_url">ollama_url[RW]<a class="headerlink" href="#attribute-i-ollama_url" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute ollama_url.</p>
 <h2 id="attribute-i-openai_api_key">openai_api_key[RW]<a class="headerlink" href="#attribute-i-openai_api_key" title="Permanent link">&para;</a></h2>
@@ -4261,6 +4277,24 @@ <h2 id="attribute-i-openai_project">openai_project[RW]<a class="headerlink" href
 <p>Provider-specific API keys and endpoints</p>
 <h2 id="attribute-i-openrouter_api_key">openrouter_api_key[RW]<a class="headerlink" href="#attribute-i-openrouter_api_key" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute openrouter_api_key.</p>
+<h2 id="attribute-i-proposition_extractor">proposition_extractor[RW]<a class="headerlink" href="#attribute-i-proposition_extractor" title="Permanent link">&para;</a></h2>
+<p>Returns the value of attribute proposition_extractor.</p>
+<h2 id="attribute-i-proposition_model">proposition_model[RW]<a class="headerlink" href="#attribute-i-proposition_model" title="Permanent link">&para;</a></h2>
+<p>Returns the value of attribute proposition_model.</p>
+<h2 id="attribute-i-proposition_provider">proposition_provider[RW]<a class="headerlink" href="#attribute-i-proposition_provider" title="Permanent link">&para;</a></h2>
+<p>Returns the value of attribute proposition_provider.</p>
+<h2 id="attribute-i-proposition_timeout">proposition_timeout[RW]<a class="headerlink" href="#attribute-i-proposition_timeout" title="Permanent link">&para;</a></h2>
+<p>Returns the value of attribute proposition_timeout.</p>
+<h2 id="attribute-i-relevance_access_weight">relevance_access_weight[RW]<a class="headerlink" href="#attribute-i-relevance_access_weight" title="Permanent link">&para;</a></h2>
+<p>Access frequency weight (default: 0.1)</p>
+<h2 id="attribute-i-relevance_recency_half_life_hours">relevance_recency_half_life_hours[RW]<a class="headerlink" href="#attribute-i-relevance_recency_half_life_hours" title="Permanent link">&para;</a></h2>
+<p>Decay half-life in hours (default: 168 = 1 week)</p>
+<h2 id="attribute-i-relevance_recency_weight">relevance_recency_weight[RW]<a class="headerlink" href="#attribute-i-relevance_recency_weight" title="Permanent link">&para;</a></h2>
+<p>Temporal freshness weight (default: 0.1)</p>
+<h2 id="attribute-i-relevance_semantic_weight">relevance_semantic_weight[RW]<a class="headerlink" href="#attribute-i-relevance_semantic_weight" title="Permanent link">&para;</a></h2>
+<p>Relevance scoring weights (must sum to 1.0)</p>
+<h2 id="attribute-i-relevance_tag_weight">relevance_tag_weight[RW]<a class="headerlink" href="#attribute-i-relevance_tag_weight" title="Permanent link">&para;</a></h2>
+<p>Tag overlap weight (default: 0.3)</p>
 <h2 id="attribute-i-tag_extractor">tag_extractor[RW]<a class="headerlink" href="#attribute-i-tag_extractor" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute tag_extractor.</p>
 <h2 id="attribute-i-tag_model">tag_model[RW]<a class="headerlink" href="#attribute-i-tag_model" title="Permanent link">&para;</a></h2>
@@ -4269,6 +4303,8 @@ <h2 id="attribute-i-tag_provider">tag_provider[RW]<a class="headerlink" href="#a
 <p>Returns the value of attribute tag_provider.</p>
 <h2 id="attribute-i-tag_timeout">tag_timeout[RW]<a class="headerlink" href="#attribute-i-tag_timeout" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute tag_timeout.</p>
+<h2 id="attribute-i-telemetry_enabled">telemetry_enabled[RW]<a class="headerlink" href="#attribute-i-telemetry_enabled" title="Permanent link">&para;</a></h2>
+<p>Enable OpenTelemetry metrics (default: false)</p>
 <h2 id="attribute-i-token_counter">token_counter[RW]<a class="headerlink" href="#attribute-i-token_counter" title="Permanent link">&para;</a></h2>
 <p>Returns the value of attribute token_counter.</p>
 <h2 id="attribute-i-week_start">week_start[RW]<a class="headerlink" href="#attribute-i-week_start" title="Permanent link">&para;</a></h2>

api/yard/HTM/Database/index.html

@@ -4168,16 +4168,18 @@ <h1 id="class-htmdatabase">Class: HTM::Database<a class="headerlink" href="#clas
 initialization</p>
 <h1 id="class-methods">Class Methods<a class="headerlink" href="#class-methods" title="Permanent link">&para;</a></h1>
 <h2 id="method-c-default_config">default_config()<a class="headerlink" href="#method-c-default_config" title="Permanent link">&para;</a></h2>
-<p>Get default database configuration
-<strong><code>@return</code></strong> [Hash, nil] Connection configuration hash</p>
+<p>Get default database configuration (respects RAILS_ENV)</p>
+<p>Uses ActiveRecordConfig which reads from config/database.yml and respects
+RAILS_ENV for environment-specific database selection.
+<strong><code>@return</code></strong> [Hash, nil] Connection configuration hash with PG-style keys</p>
 <h2 id="method-c-drop">drop(db_url nil)<a class="headerlink" href="#method-c-drop" title="Permanent link">&para;</a></h2>
-<p>Drop all HTM tables
-<strong><code>@param</code></strong> [String] Database connection URL (uses ENV['HTM_DBURL'] if not provided)</p>
+<p>Drop all HTM tables (respects RAILS_ENV)
+<strong><code>@param</code></strong> [String] Database connection URL (uses default_config if not provided)</p>
 <p><strong><code>@return</code></strong> [void] </p>
 <h2 id="method-c-dump_schema">dump_schema(db_url nil)<a class="headerlink" href="#method-c-dump_schema" title="Permanent link">&para;</a></h2>
-<p>Dump current database schema to db/schema.sql</p>
+<p>Dump current database schema to db/schema.sql (respects RAILS_ENV)</p>
 <p>Uses pg_dump to create a clean SQL schema file without data
-<strong><code>@param</code></strong> [String] Database connection URL (uses ENV['HTM_DBURL'] if not provided)</p>
+<strong><code>@param</code></strong> [String] Database connection URL (uses default_config if not provided)</p>
 <p><strong><code>@return</code></strong> [void] </p>
 <h2 id="method-c-generate_docs">generate_docs(db_url nil)<a class="headerlink" href="#method-c-generate_docs" title="Permanent link">&para;</a></h2>
 <p>Generate database documentation using tbls</p>
@@ -4190,13 +4192,13 @@ <h2 id="method-c-generate_docs">generate_docs(db_url nil)<a class="headerlink" h
 <strong><code>@param</code></strong> [String] Database connection URL (uses ENV['HTM_DBURL'] if not provided)</p>
 <p><strong><code>@return</code></strong> [void] </p>
 <h2 id="method-c-info">info(db_url nil)<a class="headerlink" href="#method-c-info" title="Permanent link">&para;</a></h2>
-<p>Show database info
-<strong><code>@param</code></strong> [String] Database connection URL (uses ENV['HTM_DBURL'] if not provided)</p>
+<p>Show database info (respects RAILS_ENV)
+<strong><code>@param</code></strong> [String] Database connection URL (uses default_config if not provided)</p>
 <p><strong><code>@return</code></strong> [void] </p>
 <h2 id="method-c-load_schema">load_schema(db_url nil)<a class="headerlink" href="#method-c-load_schema" title="Permanent link">&para;</a></h2>
-<p>Load schema from db/schema.sql</p>
+<p>Load schema from db/schema.sql (respects RAILS_ENV)</p>
 <p>Uses psql to load the schema file
-<strong><code>@param</code></strong> [String] Database connection URL (uses ENV['HTM_DBURL'] if not provided)</p>
+<strong><code>@param</code></strong> [String] Database connection URL (uses default_config if not provided)</p>
 <p><strong><code>@return</code></strong> [void] </p>
 <h2 id="method-c-migrate">migrate(db_url nil)<a class="headerlink" href="#method-c-migrate" title="Permanent link">&para;</a></h2>
 <p>Run pending database migrations

api/yard/HTM/EmbeddingService/index.html

@@ -4191,8 +4191,11 @@ <h2 id="method-c-generate">generate(text )<a class="headerlink" href="#method-c-
   storage_embedding: String,         # Formatted for database storage
   storage_dimension: Integer         # Padded dimension (2000)
 }</p>
+<h2 id="method-c-max_dimension">max_dimension()<a class="headerlink" href="#method-c-max_dimension" title="Permanent link">&para;</a></h2>
+<p>Maximum embedding dimension (configurable, default 2000)
+<strong><code>@return</code></strong> [Integer] Max dimensions for pgvector HNSW index</p>
 <h2 id="method-c-pad_embedding">pad_embedding(embedding )<a class="headerlink" href="#method-c-pad_embedding" title="Permanent link">&para;</a></h2>
-<p>Pad embedding to MAX_DIMENSION with zeros
+<p>Pad embedding to max_dimension with zeros
 <strong><code>@param</code></strong> [Array<Float>] Original embedding</p>
 <p><strong><code>@return</code></strong> [Array<Float>] Padded embedding</p>
 <h2 id="method-c-reset_circuit_breaker!">reset_circuit_breaker!()<a class="headerlink" href="#method-c-reset_circuit_breaker!" title="Permanent link">&para;</a></h2>