htm 0.0.31 → 0.0.32

data/examples/12_rails_app/app/models/chat.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+class Chat < ApplicationRecord
+  acts_as_chat
+
+  # Override to_llm to pass assume_model_exists for cloud providers
+  # This allows using models that may not be in RubyLLM's local registry
+  def to_llm
+    model_record = model_association
+    api_provider = map_provider_for_api(model_record.provider)
+
+    Rails.logger.info "Chat#to_llm: provider=#{model_record.provider} -> #{api_provider}, model=#{model_record.model_id}"
+
+    # Create fresh chat object each request to respect current provider config
+    @chat = (context || RubyLLM).chat(
+      model: model_record.model_id,
+      provider: api_provider,
+      assume_model_exists: true
+    )
+
+    @chat.reset_messages!
+    messages_association.each { |msg| @chat.add_message(msg.to_llm) }
+    setup_persistence_callbacks
+  end
+
+  private
+
+  # Map display providers to RubyLLM API providers
+  # LM Studio uses OpenAI-compatible API
+  def map_provider_for_api(provider)
+    case provider.to_s
+    when 'lmstudio' then :openai
+    else provider.to_sym
+    end
+  end
+end

data/examples/12_rails_app/app/models/message.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class Message < ApplicationRecord
+  acts_as_message
+end

data/examples/12_rails_app/app/models/model.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class Model < ApplicationRecord
+  acts_as_model
+end

data/examples/12_rails_app/app/models/tool_call.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class ToolCall < ApplicationRecord
+  acts_as_tool_call
+end

data/examples/12_rails_app/app/views/chats/index.html.erb

@@ -0,0 +1,61 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
+<div class="space-y-6">
+  <!-- Header -->
+  <div class="flex items-center justify-between">
+    <div>
+      <h1 class="text-2xl font-bold text-white">Chats</h1>
+      <p class="mt-1 text-sm text-gray-400">AI-powered conversations with RAG context from HTM</p>
+    </div>
+    <%= button_to chats_path, method: :post, class: 'inline-flex items-center gap-2 rounded-md bg-indigo-600 px-4 py-2 text-sm font-medium text-white hover:bg-indigo-500 transition-colors cursor-pointer' do %>
+      <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+      </svg>
+      New Chat
+    <% end %>
+  </div>
+
+  <% if @chats.any? %>
+    <div class="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3">
+      <% @chats.each do |chat| %>
+        <%= link_to chat_path(chat), class: 'block rounded-lg bg-gray-800 border border-gray-700 p-4 hover:border-indigo-500 transition-colors group' do %>
+          <div class="flex items-center gap-3 mb-3">
+            <div class="rounded-full bg-indigo-900/50 p-2">
+              <svg class="h-5 w-5 text-indigo-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z" />
+              </svg>
+            </div>
+            <div class="flex-1 min-w-0">
+              <p class="text-sm font-medium text-white group-hover:text-indigo-400 transition-colors">
+                Chat #<%= chat.id %>
+              </p>
+              <p class="text-xs text-gray-500">
+                <%= chat.messages.count %> messages
+              </p>
+            </div>
+          </div>
+          <% if (last_message = chat.messages.last) %>
+            <p class="text-sm text-gray-400 line-clamp-2"><%= truncate(last_message.content, length: 100) %></p>
+          <% else %>
+            <p class="text-sm text-gray-500 italic">No messages yet</p>
+          <% end %>
+          <p class="mt-2 text-xs text-gray-500"><%= time_ago_in_words(chat.updated_at) %> ago</p>
+        <% end %>
+      <% end %>
+    </div>
+  <% else %>
+    <div class="rounded-lg bg-gray-800 border border-gray-700 p-12 text-center">
+      <svg class="mx-auto h-12 w-12 text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z" />
+      </svg>
+      <h3 class="mt-4 text-lg font-medium text-white">No chats yet</h3>
+      <p class="mt-2 text-sm text-gray-400">Start a new conversation to begin chatting with AI using HTM context.</p>
+      <%= button_to chats_path, method: :post, class: 'mt-4 inline-flex items-center gap-2 rounded-md bg-indigo-600 px-4 py-2 text-sm font-medium text-white hover:bg-indigo-500 transition-colors cursor-pointer' do %>
+        <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+        </svg>
+        Start New Chat
+      <% end %>
+    </div>
+  <% end %>
+</div>

data/examples/12_rails_app/app/views/chats/show.html.erb

@@ -0,0 +1,213 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
+<div class="flex flex-col h-[calc(100vh-10rem)]">
+  <!-- Header -->
+  <div class="flex items-center justify-between pb-4 border-b border-gray-700">
+    <div class="flex items-center gap-4">
+      <%= link_to app_root_path, class: 'text-gray-400 hover:text-white transition-colors' do %>
+        <svg class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 19l-7-7 7-7" />
+        </svg>
+      <% end %>
+      <div>
+        <h1 class="text-lg font-bold text-white">Chat #<%= @chat.id %></h1>
+        <p class="text-xs text-gray-500"><%= @messages.count %> messages</p>
+      </div>
+    </div>
+    <%= button_to chat_path(@chat), method: :delete, form: { data: { turbo_confirm: 'Delete this chat?' } }, class: 'text-gray-400 hover:text-red-400 transition-colors cursor-pointer' do %>
+      <svg class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
+      </svg>
+    <% end %>
+  </div>
+
+  <!-- Messages -->
+  <div id="messages-container" class="flex-1 overflow-y-auto py-4 space-y-4">
+    <% if @messages.any? %>
+      <% @messages.each do |message| %>
+        <%= render 'messages/message', message: message %>
+      <% end %>
+    <% else %>
+      <div class="flex items-center justify-center h-full">
+        <div class="text-center">
+          <svg class="mx-auto h-12 w-12 text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z" />
+          </svg>
+          <p class="mt-4 text-gray-400">Start the conversation</p>
+          <p class="mt-1 text-sm text-gray-500">Your messages will be enhanced with HTM context</p>
+        </div>
+      </div>
+    <% end %>
+  </div>
+
+  <!-- Input -->
+  <div class="pt-4 border-t border-gray-700">
+    <%= form_with url: chat_messages_path(@chat), method: :post, id: 'message-form', class: 'flex gap-3' do |f| %>
+      <div class="flex-1">
+        <%= f.text_area :content,
+            rows: 1,
+            placeholder: 'Type your message...',
+            class: 'block w-full rounded-lg border-gray-600 bg-gray-800 text-white placeholder-gray-400 focus:border-indigo-500 focus:ring-indigo-500 resize-none px-4 py-3',
+            autofocus: true,
+            id: 'message-input' %>
+      </div>
+      <button type="submit" id="send-button" class="inline-flex items-center gap-2 rounded-lg bg-indigo-600 px-4 py-3 text-sm font-medium text-white hover:bg-indigo-500 transition-colors cursor-pointer disabled:opacity-50 disabled:cursor-not-allowed">
+        <span id="send-text">Send</span>
+        <svg id="send-spinner" class="hidden animate-spin h-4 w-4" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
+          <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
+          <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
+        </svg>
+      </button>
+    <% end %>
+    <div class="mt-2 flex items-center justify-center gap-3 text-xs text-gray-500">
+      <% current_provider = @chat.model&.provider || 'ollama' %>
+      <% current_model_name = @chat.model&.model_id %>
+
+      <!-- Provider dropdown -->
+      <div class="flex items-center gap-1">
+        <span>Provider:</span>
+        <%= form_with url: chat_path(@chat), method: :patch, id: 'provider-form', class: 'inline-flex items-center' do |f| %>
+          <%= f.select :provider,
+              options_for_select(@available_providers.map { |p| [p[:name], p[:id]] }, current_provider),
+              {},
+              id: 'provider-select',
+              class: 'rounded border-gray-600 bg-gray-800 text-gray-300 text-xs py-1 px-2 focus:border-indigo-500 focus:ring-indigo-500',
+              onchange: 'this.form.submit()' %>
+        <% end %>
+      </div>
+
+      <span class="text-gray-600">|</span>
+
+      <!-- Model dropdown -->
+      <div class="flex items-center gap-1">
+        <span>Model:</span>
+        <%= form_with url: chat_path(@chat), method: :patch, id: 'model-form', class: 'inline-flex items-center' do |f| %>
+          <%= f.select :model_id,
+              options_for_select(@available_models, current_model_name),
+              {},
+              id: 'model-select',
+              class: 'rounded border-gray-600 bg-gray-800 text-gray-300 text-xs py-1 px-2 focus:border-indigo-500 focus:ring-indigo-500',
+              onchange: 'this.form.submit()' %>
+        <% end %>
+      </div>
+    </div>
+
+    <!-- HTM Context Enhancement Controls -->
+    <div class="mt-3 pt-3 border-t border-gray-700">
+      <%= form_with url: update_htm_settings_chat_path(@chat), method: :patch, id: 'htm-settings-form', class: 'flex flex-col gap-2' do |f| %>
+        <div class="flex items-center justify-center gap-4 text-xs text-gray-500">
+          <span class="text-gray-400 font-medium">HTM:</span>
+
+          <!-- Strategy radio buttons -->
+          <div class="flex items-center gap-3">
+            <% strategies = [['Off', 'off'], ['Vector', 'vector'], ['Fulltext', 'fulltext'], ['Hybrid', 'hybrid']] %>
+            <% strategies.each do |label, value| %>
+              <label class="flex items-center gap-1 cursor-pointer">
+                <%= radio_button_tag :htm_strategy, value,
+                    @htm_settings[:strategy] == value,
+                    class: 'text-indigo-500 focus:ring-indigo-500 bg-gray-800 border-gray-600',
+                    onchange: 'this.form.submit()' %>
+                <span class="<%= @htm_settings[:strategy] == value ? 'text-indigo-400' : 'text-gray-400' %>"><%= label %></span>
+              </label>
+            <% end %>
+          </div>
+
+          <span class="text-gray-600">|</span>
+
+          <!-- Limit dropdown -->
+          <div class="flex items-center gap-1">
+            <span>Limit:</span>
+            <%= select_tag :htm_limit,
+                options_for_select([[3, 3], [5, 5], [10, 10], [15, 15], [20, 20], [30, 30], [40, 40], [50, 50], [75, 75], [100, 100], ['All', 'all']], @htm_settings[:limit]),
+                class: 'rounded border-gray-600 bg-gray-800 text-gray-300 text-xs py-1 px-2 focus:border-indigo-500 focus:ring-indigo-500',
+                onchange: 'this.form.submit()',
+                disabled: @htm_settings[:strategy] == 'off' %>
+          </div>
+        </div>
+
+        <!-- Additional options -->
+        <div class="flex items-center justify-center gap-4 text-xs text-gray-500">
+          <label class="flex items-center gap-1 cursor-pointer <%= @htm_settings[:strategy] == 'off' ? 'opacity-50' : '' %>">
+            <%= check_box_tag :htm_propositions, '1',
+                @htm_settings[:propositions],
+                class: 'rounded text-indigo-500 focus:ring-indigo-500 bg-gray-800 border-gray-600',
+                onchange: 'this.form.submit()',
+                disabled: @htm_settings[:strategy] == 'off' %>
+            <span>Include propositions</span>
+          </label>
+
+          <label class="flex items-center gap-1 cursor-pointer <%= @htm_settings[:strategy] == 'off' ? 'opacity-50' : '' %>">
+            <%= check_box_tag :htm_tags_only, '1',
+                @htm_settings[:tags_only],
+                class: 'rounded text-indigo-500 focus:ring-indigo-500 bg-gray-800 border-gray-600',
+                onchange: 'this.form.submit()',
+                disabled: @htm_settings[:strategy] == 'off' %>
+            <span>Tags only</span>
+          </label>
+
+          <!-- Tag filter input -->
+          <div class="flex items-center gap-1 <%= @htm_settings[:strategy] == 'off' ? 'opacity-50' : '' %>">
+            <span>Tag filter:</span>
+            <%= text_field_tag :htm_tag_filter,
+                @htm_settings[:tag_filter],
+                placeholder: 'e.g. database:',
+                class: 'rounded border-gray-600 bg-gray-800 text-gray-300 text-xs py-1 px-2 w-24 focus:border-indigo-500 focus:ring-indigo-500 placeholder-gray-600',
+                disabled: @htm_settings[:strategy] == 'off',
+                onblur: 'this.form.submit()' %>
+          </div>
+        </div>
+      <% end %>
+    </div>
+  </div>
+</div>
+
+<script>
+  // Auto-scroll messages container to bottom
+  function scrollToBottom() {
+    const container = document.getElementById('messages-container');
+    if (container) {
+      container.scrollTop = container.scrollHeight;
+    }
+  }
+
+  // Convert UTC timestamps to local timezone
+  function convertTimestampsToLocal() {
+    document.querySelectorAll('time.local-time').forEach(el => {
+      const utcTime = new Date(el.getAttribute('datetime'));
+      const hours = utcTime.getHours().toString().padStart(2, '0');
+      const minutes = utcTime.getMinutes().toString().padStart(2, '0');
+      el.textContent = `${hours}:${minutes}`;
+    });
+  }
+
+  // Initialize on page load (same pattern as search page spinner)
+  document.addEventListener('DOMContentLoaded', () => {
+    scrollToBottom();
+    convertTimestampsToLocal();
+
+    const form = document.getElementById('message-form');
+    const btn = document.getElementById('send-button');
+    const spinner = document.getElementById('send-spinner');
+    const btnText = document.getElementById('send-text');
+    const input = document.getElementById('message-input');
+
+    if (form && btn) {
+      form.addEventListener('submit', (e) => {
+        // Validate: prevent submission if input is empty
+        if (!input || !input.value.trim()) {
+          e.preventDefault();
+          input && input.focus();
+          return;
+        }
+
+        // Show spinner and disable button (same pattern as search page)
+        spinner.classList.remove('hidden');
+        btnText.textContent = 'Sending...';
+        btn.disabled = true;
+        btn.classList.add('opacity-75', 'cursor-wait');
+        btn.classList.remove('hover:bg-indigo-500');
+        // Form submits normally - spinner shows until page reloads with response
+      });
+    }
+  });
+</script>

data/examples/12_rails_app/app/views/dashboard/index.html.erb

@@ -3,6 +3,9 @@
   <div>
     <h1 class="text-2xl font-bold text-white">HTM Memory Explorer</h1>
     <p class="mt-1 text-sm text-gray-400">Monitor and explore your Hierarchical Temporal Memory system</p>
+    <p class="mt-2 text-xs text-gray-500 font-mono bg-gray-800 rounded px-2 py-1 inline-block">
+      <span class="text-gray-400">HTM Database:</span> <%= @htm_database_url %>
+    </p>
   </div>
 
   <!-- Stats Grid -->

data/examples/12_rails_app/app/views/files/index.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Header -->
   <div class="flex items-center justify-between">
@@ -33,7 +35,10 @@
       </div>
       <div class="ml-3">
         <p class="text-sm text-blue-300">
-          <strong>File Loading:</strong> HTM can load markdown files into memory with automatic chunking. Each chunk becomes a separate memory node with its own embedding and tags. Changes are tracked for re-sync.
+          <strong>File Loading:</strong> HTM can load markdown files into memory with automatic chunking. Each chunk becomes a separate memory node with its own embedding and tags.
+        </p>
+        <p class="text-sm text-blue-300/70 mt-2">
+          <strong>Sync:</strong> Re-reads the source file and performs a differential update. Unchanged content is preserved (keeping embeddings and tags); new content is added; removed content is soft-deleted (recoverable).
         </p>
       </div>
     </div>
@@ -56,7 +61,7 @@
           <% @file_sources.each do |source| %>
             <tr class="hover:bg-gray-700/50 transition-colors">
               <td class="px-6 py-4">
-                <%= link_to file_path(source), class: 'text-sm text-indigo-400 hover:text-indigo-300' do %>
+                <%= link_to file_path(source.id), class: 'text-sm text-indigo-400 hover:text-indigo-300' do %>
                   <span class="font-mono"><%= source.file_path %></span>
                 <% end %>
                 <% if source.frontmatter.present? && source.frontmatter['title'] %>
@@ -83,11 +88,11 @@
                 <%= time_ago_in_words(source.updated_at) %> ago
               </td>
               <td class="px-6 py-4 whitespace-nowrap text-right text-sm font-medium">
-                <%= link_to 'View', file_path(source), class: 'text-indigo-400 hover:text-indigo-300' %>
+                <%= link_to 'View', file_path(source.id), class: 'text-indigo-400 hover:text-indigo-300' %>
                 <span class="mx-2 text-gray-600">|</span>
-                <%= button_to 'Sync', sync_file_path(source), method: :post, class: 'text-indigo-400 hover:text-indigo-300 bg-transparent border-0 cursor-pointer' %>
+                <%= button_to 'Sync', sync_file_path(source.id), method: :post, class: 'text-indigo-400 hover:text-indigo-300 bg-transparent border-0 cursor-pointer' %>
                 <span class="mx-2 text-gray-600">|</span>
-                <%= button_to 'Unload', file_path(source), method: :delete, class: 'text-red-400 hover:text-red-300 bg-transparent border-0 cursor-pointer', data: { turbo_confirm: 'Unload this file? All chunks will be soft-deleted.' } %>
+                <%= button_to 'Unload', file_path(source.id), method: :delete, data: { confirm: 'Unload this file? All chunks will be soft-deleted.' }, class: 'text-red-400 hover:text-red-300 bg-transparent border-0 cursor-pointer' %>
               </td>
             </tr>
           <% end %>

data/examples/12_rails_app/app/views/files/new.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <!-- Full-page loading overlay -->
 <div id="upload-overlay" class="hidden fixed inset-0 bg-gray-900/90 z-50 flex items-center justify-center">
   <div class="bg-gray-800 rounded-lg border border-gray-700 p-8 max-w-md w-full mx-4 text-center">
@@ -30,7 +32,7 @@
     <div class="rounded-lg bg-gray-800 border border-gray-700 p-6">
       <h2 class="text-lg font-bold text-white mb-4">Upload Files</h2>
 
-      <%= form_with url: upload_files_path, method: :post, multipart: true, class: 'space-y-4', id: 'upload-files-form', data: { turbo: false } do %>
+      <%= form_with url: upload_files_path, method: :post, multipart: true, class: 'space-y-4', id: 'upload-files-form' do %>
         <div>
           <label for="files" class="block text-sm font-medium text-gray-300 mb-2">Select Files</label>
           <input
@@ -69,7 +71,7 @@
         <p class="text-xs text-yellow-400"><strong>Note:</strong> Browser uploads limited to ~100 files due to OS restrictions. For larger directories, use <strong>Load Directory by Path</strong> below.</p>
       </div>
 
-      <%= form_with url: upload_directory_files_path, method: :post, multipart: true, class: 'space-y-4', id: 'upload-dir-form', data: { turbo: false } do %>
+      <%= form_with url: upload_directory_files_path, method: :post, multipart: true, class: 'space-y-4', id: 'upload-dir-form' do %>
         <div>
           <label for="directory" class="block text-sm font-medium text-gray-300 mb-2">Select Directory</label>
           <input

data/examples/12_rails_app/app/views/files/show.html.erb

@@ -1,3 +1,6 @@
+<%# Disable auto-refresh on file detail page %>
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Back link -->
   <div>
@@ -41,14 +44,14 @@
           </span>
         <% end %>
 
-        <%= button_to sync_file_path(@file_source), method: :post, class: 'inline-flex items-center gap-2 rounded-md bg-gray-700 px-3 py-2 text-sm font-medium text-white hover:bg-gray-600 transition-colors' do %>
+        <%= button_to sync_file_path(@file_source.id), method: :post, class: 'inline-flex items-center gap-2 rounded-md bg-gray-700 px-3 py-2 text-sm font-medium text-white hover:bg-gray-600 transition-colors' do %>
           <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
           </svg>
           Sync Now
         <% end %>
 
-        <%= button_to file_path(@file_source), method: :delete, class: 'inline-flex items-center gap-2 rounded-md bg-red-600/80 px-3 py-2 text-sm font-medium text-white hover:bg-red-600 transition-colors', data: { turbo_confirm: 'Unload this file? All chunks will be soft-deleted.' } do %>
+        <%= button_to file_path(@file_source.id), method: :delete, data: { confirm: 'Unload this file? All chunks will be soft-deleted.' }, class: 'inline-flex items-center gap-2 rounded-md bg-red-600/80 px-3 py-2 text-sm font-medium text-white hover:bg-red-600 transition-colors' do %>
           <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
           </svg>
@@ -57,6 +60,19 @@
       </div>
     </div>
 
+    <!-- Sync Info -->
+    <div class="mt-6 pt-6 border-t border-gray-700">
+      <div class="rounded-md bg-gray-700/50 p-3">
+        <p class="text-xs text-gray-400">
+          <strong class="text-gray-300">What does Sync do?</strong>
+          Re-reads the source file and performs a differential update. Unchanged chunks are preserved (keeping their embeddings and tags); new content creates new chunks; removed content is soft-deleted (recoverable).
+          <% if @file_source.needs_sync? %>
+            <span class="text-yellow-400 ml-1">The source file has changed since last sync.</span>
+          <% end %>
+        </p>
+      </div>
+    </div>
+
     <!-- Stats -->
     <div class="mt-6 grid grid-cols-3 gap-4 pt-6 border-t border-gray-700">
       <div>
@@ -100,7 +116,7 @@
                 <%= i + 1 %>
               </span>
               <div class="flex-1 min-w-0">
-                <%= link_to memory_path(chunk), class: 'block group' do %>
+                <%= link_to memory_path(chunk.id), class: 'block group' do %>
                   <p class="text-sm text-gray-300 group-hover:text-white transition-colors whitespace-pre-wrap line-clamp-4">
                     <%= chunk.content %>
                   </p>

data/examples/12_rails_app/app/views/home/index.html.erb

@@ -0,0 +1,45 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
+<div class="min-h-[calc(100vh-8rem)] flex items-center justify-center">
+  <div class="max-w-4xl mx-auto px-4">
+    <div class="text-center mb-12">
+      <div class="flex justify-center mb-4">
+        <svg class="h-16 w-16 text-indigo-500" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path d="M12 2L2 7l10 5 10-5-10-5zM2 17l10 5 10-5M2 12l10 5 10-5"/>
+        </svg>
+      </div>
+      <h1 class="text-4xl font-bold text-white mb-4">HTM Demo</h1>
+      <p class="text-xl text-gray-400">Hierarchical Temporal Memory + RAG Chatbot</p>
+    </div>
+
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
+      <!-- Chat Section -->
+      <%= link_to app_root_path, class: 'block rounded-xl bg-gray-800 border border-gray-700 p-8 hover:border-indigo-500 transition-colors group' do %>
+        <div class="flex items-center gap-4 mb-4">
+          <div class="rounded-full bg-indigo-900/50 p-3">
+            <svg class="h-8 w-8 text-indigo-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z" />
+            </svg>
+          </div>
+          <h2 class="text-2xl font-bold text-white group-hover:text-indigo-400 transition-colors">Chat</h2>
+        </div>
+        <p class="text-gray-400 mb-4">AI-powered chatbot with RAG. Answers are augmented with context from HTM memory.</p>
+        <p class="text-sm text-gray-500"><%= pluralize(@chat_count, 'conversation') %></p>
+      <% end %>
+
+      <!-- HTM Management Section -->
+      <%= link_to htm_root_path, class: 'block rounded-xl bg-gray-800 border border-gray-700 p-8 hover:border-purple-500 transition-colors group' do %>
+        <div class="flex items-center gap-4 mb-4">
+          <div class="rounded-full bg-purple-900/50 p-3">
+            <svg class="h-8 w-8 text-purple-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 7v10c0 2.21 3.582 4 8 4s8-1.79 8-4V7M4 7c0 2.21 3.582 4 8 4s8-1.79 8-4M4 7c0-2.21 3.582-4 8-4s8 1.79 8 4" />
+            </svg>
+          </div>
+          <h2 class="text-2xl font-bold text-white group-hover:text-purple-400 transition-colors">HTM Management</h2>
+        </div>
+        <p class="text-gray-400 mb-4">Manage memories, tags, robots, and files in the HTM knowledge base.</p>
+        <p class="text-sm text-gray-500"><%= pluralize(@memory_count, 'memory') %></p>
+      <% end %>
+    </div>
+  </div>
+</div>

data/examples/12_rails_app/app/views/layouts/application.html.erb

@@ -3,9 +3,6 @@
 <head>
   <title>HTM Memory Explorer</title>
   <meta name="viewport" content="width=device-width,initial-scale=1">
-  <meta name="turbo-cache-control" content="no-preview">
-  <meta name="turbo-refresh-method" content="morph">
-  <meta name="turbo-refresh-scroll" content="preserve">
   <%= csrf_meta_tags %>
   <%= csp_meta_tag %>
 
@@ -40,28 +37,33 @@
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
 
-  <%= stylesheet_link_tag "application", "data-turbo-track": "reload" %>
+  <%= stylesheet_link_tag "application" %>
 
-  <%# Hotwire via CDN - no build step needed %>
-  <script type="module">
-    import * as Turbo from 'https://cdn.jsdelivr.net/npm/@hotwired/turbo@8.0.12/+esm'
-
-    // Live reload: auto-refresh every 3 seconds using Turbo morphing
-    // This preserves scroll position and smoothly updates only changed elements
+  <%# Auto-refresh without Turbo Drive - CDN Turbo doesn't integrate well with Rails %>
+  <script>
+    // Simple auto-refresh using standard page reload
+    // Turbo Drive via CDN causes navigation issues, so we use plain JS instead
+    // Auto-refresh can be disabled by adding data-no-auto-refresh to the body
     let autoRefreshEnabled = true;
     let formFieldFocused = false;
     let refreshInterval = 3000;
 
     function autoRefresh() {
+      // Don't refresh if disabled globally or via data attribute
+      if (!autoRefreshEnabled) return;
+      if (document.body.hasAttribute('data-no-auto-refresh')) return;
       // Don't refresh if form field is focused (would interrupt typing)
-      if (autoRefreshEnabled && document.visibilityState === 'visible' && !formFieldFocused) {
-        Turbo.visit(window.location.href, { action: 'replace' });
-      }
+      if (document.visibilityState !== 'visible' || formFieldFocused) return;
+
+      window.location.reload();
     }
 
     // Start auto-refresh after page loads
-    document.addEventListener('turbo:load', () => {
-      setInterval(autoRefresh, refreshInterval);
+    document.addEventListener('DOMContentLoaded', () => {
+      // Only start auto-refresh if not disabled
+      if (!document.body.hasAttribute('data-no-auto-refresh')) {
+        setInterval(autoRefresh, refreshInterval);
+      }
 
       // Pause refresh when any form field is focused
       document.addEventListener('focusin', (e) => {
@@ -79,8 +81,8 @@
 
     // Pause refresh when page is hidden
     document.addEventListener('visibilitychange', () => {
-      // Refresh immediately when tab becomes visible again
-      if (document.visibilityState === 'visible') {
+      // Refresh immediately when tab becomes visible again (if enabled)
+      if (document.visibilityState === 'visible' && !document.body.hasAttribute('data-no-auto-refresh')) {
         autoRefresh();
       }
     });
@@ -99,7 +101,7 @@
   </style>
 </head>
 
-<body class="h-full bg-gray-900 text-gray-100">
+<body class="h-full bg-gray-900 text-gray-100" <%= yield :body_attributes %>>
   <div class="min-h-full">
     <%= render 'shared/navbar' %>
 

data/examples/12_rails_app/app/views/memories/_memory_card.html.erb

@@ -41,7 +41,7 @@
           <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z" />
         </svg>
       <% end %>
-      <%= button_to memory_path(memory.id), method: :delete, class: 'rounded p-1.5 text-gray-400 hover:text-red-400 hover:bg-gray-700 transition-colors', title: 'Delete', data: { turbo_confirm: 'Move this memory to trash?' } do %>
+      <%= button_to memory_path(memory.id), method: :delete, data: { confirm: 'Move this memory to trash?' }, class: 'rounded p-1.5 text-gray-400 hover:text-red-400 hover:bg-gray-700 transition-colors', title: 'Delete' do %>
         <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
           <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
         </svg>

data/examples/12_rails_app/app/views/memories/deleted.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Header -->
   <div class="flex items-center justify-between">
@@ -39,7 +41,7 @@
                 </svg>
                 Restore
               <% end %>
-              <%= button_to memory_path(memory.id, permanent: true), method: :delete, class: 'inline-flex items-center gap-1 rounded-md bg-red-600/80 px-3 py-1.5 text-xs font-medium text-white hover:bg-red-600 transition-colors', data: { turbo_confirm: 'Permanently delete? This cannot be undone!' } do %>
+              <%= button_to memory_path(memory.id, permanent: true), method: :delete, data: { confirm: 'Permanently delete? This cannot be undone!' }, class: 'inline-flex items-center gap-1 rounded-md bg-red-600/80 px-3 py-1.5 text-xs font-medium text-white hover:bg-red-600 transition-colors' do %>
                 <svg class="h-3 w-3" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                   <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
                 </svg>

data/examples/12_rails_app/app/views/memories/edit.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Back link -->
   <div>

data/examples/12_rails_app/app/views/memories/index.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Header -->
   <div class="flex items-center justify-between">

data/examples/12_rails_app/app/views/memories/new.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Back link -->
   <div>