htm 0.0.15 → 0.0.18

data/examples/rails_app/app/views/tags/index.html.erb

@@ -0,0 +1,131 @@
+<div class="space-y-6">
+  <!-- Header -->
+  <div class="flex items-center justify-between">
+    <div>
+      <h1 class="text-2xl font-bold text-white">Tags</h1>
+      <p class="mt-1 text-sm text-gray-400">Hierarchical tag organization</p>
+    </div>
+    <div class="flex items-center gap-2 rounded-lg bg-gray-800 border border-gray-700 p-1">
+      <%= link_to tags_path(view: 'list'), class: "rounded px-3 py-1.5 text-sm font-medium #{@view_type == 'list' ? 'bg-indigo-600 text-white' : 'text-gray-400 hover:text-white'}" do %>
+        List
+      <% end %>
+      <%= link_to tags_path(view: 'tree'), class: "rounded px-3 py-1.5 text-sm font-medium #{@view_type == 'tree' ? 'bg-indigo-600 text-white' : 'text-gray-400 hover:text-white'}" do %>
+        Tree
+      <% end %>
+      <%= link_to tags_path(view: 'mermaid'), class: "rounded px-3 py-1.5 text-sm font-medium #{@view_type == 'mermaid' ? 'bg-indigo-600 text-white' : 'text-gray-400 hover:text-white'}" do %>
+        Diagram
+      <% end %>
+    </div>
+  </div>
+
+  <% case @view_type %>
+  <% when 'tree' %>
+    <!-- Tree View -->
+    <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+      <!-- Text Tree -->
+      <div class="rounded-lg bg-gray-800 border border-gray-700 p-6">
+        <h2 class="text-lg font-medium text-white mb-4">Text Tree</h2>
+        <% if @tree_string.present? %>
+          <pre class="text-sm text-gray-300 font-mono overflow-x-auto"><%= @tree_string %></pre>
+        <% else %>
+          <p class="text-sm text-gray-500">No tags to display.</p>
+        <% end %>
+      </div>
+
+      <!-- SVG Visualization -->
+      <div class="rounded-lg bg-gray-800 border border-gray-700 p-6">
+        <h2 class="text-lg font-medium text-white mb-4">Visual Hierarchy</h2>
+        <% if @tree_svg.present? %>
+          <div class="overflow-x-auto">
+            <%= raw @tree_svg %>
+          </div>
+        <% else %>
+          <p class="text-sm text-gray-500">No tags to display.</p>
+        <% end %>
+      </div>
+    </div>
+
+  <% when 'mermaid' %>
+    <!-- Mermaid Diagram -->
+    <div class="rounded-lg bg-gray-800 border border-gray-700 p-6">
+      <h2 class="text-lg font-medium text-white mb-4">Mermaid Diagram</h2>
+      <% if @tree_mermaid.present? %>
+        <div class="rounded-md bg-gray-900 p-4 overflow-x-auto">
+          <pre class="text-sm text-gray-300 font-mono"><%= @tree_mermaid %></pre>
+        </div>
+        <p class="mt-4 text-xs text-gray-500">Copy this code to render in any Mermaid-compatible viewer.</p>
+      <% else %>
+        <p class="text-sm text-gray-500">No tags to display.</p>
+      <% end %>
+    </div>
+
+  <% else %>
+    <!-- List View -->
+    <div class="rounded-lg bg-gray-800 border border-gray-700 p-4">
+      <%= form_with url: tags_path, method: :get, class: 'flex gap-4' do %>
+        <div class="flex-1">
+          <%= text_field_tag :prefix, params[:prefix], placeholder: 'Filter by prefix (e.g., database)', class: 'w-full rounded-md bg-gray-700 border-gray-600 text-white placeholder-gray-400 text-sm focus:ring-indigo-500 focus:border-indigo-500' %>
+        </div>
+        <%= submit_tag 'Filter', class: 'rounded-md bg-indigo-600 px-4 py-2 text-sm font-medium text-white hover:bg-indigo-500 cursor-pointer' %>
+        <% if params[:prefix].present? %>
+          <%= link_to 'Clear', tags_path, class: 'rounded-md bg-gray-700 px-4 py-2 text-sm font-medium text-white hover:bg-gray-600' %>
+        <% end %>
+      <% end %>
+    </div>
+
+    <% if @tags.any? %>
+      <div class="rounded-lg bg-gray-800 border border-gray-700 overflow-hidden">
+        <table class="min-w-full divide-y divide-gray-700">
+          <thead class="bg-gray-800/50">
+            <tr>
+              <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-400 uppercase tracking-wider">Tag</th>
+              <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-400 uppercase tracking-wider">Hierarchy</th>
+              <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-400 uppercase tracking-wider">Memories</th>
+              <th scope="col" class="relative px-6 py-3"><span class="sr-only">Actions</span></th>
+            </tr>
+          </thead>
+          <tbody class="divide-y divide-gray-700">
+            <% @tags.each do |tag| %>
+              <tr class="hover:bg-gray-700/50 transition-colors">
+                <td class="px-6 py-4 whitespace-nowrap">
+                  <%= link_to tag_path(tag), class: 'inline-flex items-center rounded-full bg-indigo-900/50 border border-indigo-500/30 px-3 py-1 text-sm text-indigo-300 hover:bg-indigo-800/50 transition-colors' do %>
+                    <%= tag.name %>
+                  <% end %>
+                </td>
+                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-400">
+                  <% parts = tag.name.split(':') %>
+                  <% parts.each_with_index do |part, i| %>
+                    <% if i > 0 %><span class="text-gray-600 mx-1">/</span><% end %>
+                    <span class="<%= i == parts.length - 1 ? 'text-white' : 'text-gray-500' %>"><%= part %></span>
+                  <% end %>
+                </td>
+                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-400">
+                  <%= tag.node_count %>
+                </td>
+                <td class="px-6 py-4 whitespace-nowrap text-right text-sm font-medium">
+                  <%= link_to 'View', tag_path(tag), class: 'text-indigo-400 hover:text-indigo-300' %>
+                  <span class="mx-2 text-gray-600">|</span>
+                  <%= link_to 'Filter Memories', memories_path(tag: tag.name), class: 'text-indigo-400 hover:text-indigo-300' %>
+                </td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    <% else %>
+      <div class="rounded-lg bg-gray-800 border border-gray-700 p-8 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="M7 7h.01M7 3h5c.512 0 1.024.195 1.414.586l7 7a2 2 0 010 2.828l-7 7a2 2 0 01-2.828 0l-7-7A1.994 1.994 0 013 12V7a4 4 0 014-4z" />
+        </svg>
+        <h3 class="mt-4 text-lg font-medium text-white">No tags found</h3>
+        <p class="mt-2 text-sm text-gray-400">
+          <% if params[:prefix].present? %>
+            No tags match that prefix. <%= link_to 'Clear filter', tags_path, class: 'text-indigo-400 hover:text-indigo-300' %>.
+          <% else %>
+            Tags are automatically generated when you add memories.
+          <% end %>
+        </p>
+      </div>
+    <% end %>
+  <% end %>
+</div>

data/examples/rails_app/app/views/tags/show.html.erb

@@ -0,0 +1,67 @@
+<div class="space-y-6">
+  <!-- Back link -->
+  <div>
+    <%= link_to tags_path, class: 'inline-flex items-center gap-1 text-sm text-gray-400 hover:text-white 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="M10 19l-7-7m0 0l7-7m-7 7h18" />
+      </svg>
+      Back to Tags
+    <% end %>
+  </div>
+
+  <!-- Tag Header -->
+  <div class="rounded-lg bg-gray-800 border border-gray-700 p-6">
+    <div class="flex items-start justify-between">
+      <div>
+        <div class="flex items-center gap-3">
+          <div class="rounded-full bg-indigo-900/50 border border-indigo-500/30 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="M7 7h.01M7 3h5c.512 0 1.024.195 1.414.586l7 7a2 2 0 010 2.828l-7 7a2 2 0 01-2.828 0l-7-7A1.994 1.994 0 013 12V7a4 4 0 014-4z" />
+            </svg>
+          </div>
+          <h1 class="text-2xl font-bold text-white"><%= @tag.name %></h1>
+        </div>
+
+        <!-- Hierarchy breadcrumb -->
+        <div class="mt-3 flex items-center gap-1 text-sm">
+          <% parts = @tag.name.split(':') %>
+          <% parts.each_with_index do |part, i| %>
+            <% if i > 0 %>
+              <svg class="h-4 w-4 text-gray-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" />
+              </svg>
+            <% end %>
+            <% prefix = parts[0..i].join(':') %>
+            <% matching_tag = HTM::Models::Tag.find_by(name: prefix) %>
+            <% if matching_tag %>
+              <%= link_to part, tag_path(matching_tag), class: "#{i == parts.length - 1 ? 'text-indigo-400' : 'text-gray-400 hover:text-white'}" %>
+            <% else %>
+              <span class="text-gray-500"><%= part %></span>
+            <% end %>
+          <% end %>
+        </div>
+      </div>
+
+      <div class="text-right">
+        <p class="text-2xl font-bold text-white"><%= @memories.count %></p>
+        <p class="text-sm text-gray-400">memories</p>
+      </div>
+    </div>
+  </div>
+
+  <!-- Memories with this tag -->
+  <div>
+    <h2 class="text-lg font-medium text-white mb-4">Memories with this tag</h2>
+    <% if @memories.any? %>
+      <div class="space-y-4">
+        <% @memories.each do |memory| %>
+          <%= render 'memories/memory_card', memory: memory %>
+        <% end %>
+      </div>
+    <% else %>
+      <div class="rounded-lg bg-gray-800 border border-gray-700 p-8 text-center">
+        <p class="text-sm text-gray-500">No memories with this tag.</p>
+      </div>
+    <% end %>
+  </div>
+</div>

data/examples/rails_app/bin/dev

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+if ! gem list foreman -i --silent; then
+  echo "Installing foreman..."
+  gem install foreman
+fi
+
+exec foreman start -f Procfile.dev "$@"

data/examples/rails_app/bin/rails

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+APP_PATH = File.expand_path("../config/application", __dir__)
+require_relative "../config/boot"
+require "rails/commands"

data/examples/rails_app/bin/rake

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require_relative "../config/boot"
+require "rake"
+Rake.application.run

data/examples/rails_app/config/application.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative 'boot'
+
+require 'rails'
+require 'active_model/railtie'
+require 'active_job/railtie'
+require 'active_record/railtie'
+require 'action_controller/railtie'
+require 'action_view/railtie'
+
+# Require HTM - this will auto-load the Railtie
+require 'htm'
+
+module HtmRailsExample
+  class Application < Rails::Application
+    config.load_defaults 7.1
+
+    # Full-stack Rails app (not API-only)
+    config.api_only = false
+
+    # Use inline jobs for simplicity in demo
+    config.active_job.queue_adapter = :inline
+
+    # Generators config
+    config.generators do |g|
+      g.test_framework nil
+      g.stylesheets false
+      g.javascripts false
+      g.helper false
+    end
+  end
+end

data/examples/rails_app/config/boot.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../Gemfile', __dir__)
+
+require 'bundler/setup'

data/examples/rails_app/config/database.yml

@@ -0,0 +1,15 @@
+# Rails app database (not used - HTM uses its own database)
+# This is required for Rails to boot but can be sqlite/memory
+
+default: &default
+  adapter: postgresql
+  encoding: unicode
+  pool: 5
+
+development:
+  <<: *default
+  database: htm_rails_example_dev
+
+test:
+  <<: *default
+  database: htm_rails_example_test

data/examples/rails_app/config/environment.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require_relative 'application'
+
+Rails.application.initialize!

data/examples/rails_app/config/importmap.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+pin "application"
+pin "@hotwired/turbo-rails", to: "turbo.min.js"
+pin "@hotwired/stimulus", to: "stimulus.min.js"
+pin "@hotwired/stimulus-loading", to: "stimulus-loading.js"
+pin_all_from "app/javascript/controllers", under: "controllers"

data/examples/rails_app/config/routes.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+Rails.application.routes.draw do
+  root 'dashboard#index'
+
+  resources :memories do
+    collection do
+      get :deleted
+    end
+    member do
+      post :restore
+    end
+  end
+
+  resources :tags, only: [:index, :show]
+
+  resources :robots, only: [:index, :show, :new, :create] do
+    member do
+      post :switch
+    end
+  end
+
+  resource :search, only: [:index], controller: 'search' do
+    get '/', action: :index
+  end
+
+  resources :files, only: [:index, :show, :new, :create, :destroy] do
+    collection do
+      post :load_directory
+      post :upload
+      post :upload_directory
+      post :sync_all
+    end
+    member do
+      post :sync
+    end
+  end
+end

data/examples/rails_app/config/tailwind.config.js

@@ -0,0 +1,35 @@
+const defaultTheme = require('tailwindcss/defaultTheme')
+
+module.exports = {
+  darkMode: 'class',
+  content: [
+    './app/views/**/*.html.erb',
+    './app/helpers/**/*.rb',
+    './app/javascript/**/*.js',
+    './app/assets/stylesheets/**/*.css',
+  ],
+  theme: {
+    extend: {
+      fontFamily: {
+        sans: ['Inter', ...defaultTheme.fontFamily.sans],
+        mono: ['JetBrains Mono', ...defaultTheme.fontFamily.mono],
+      },
+      colors: {
+        htm: {
+          50: '#f0f9ff',
+          100: '#e0f2fe',
+          200: '#bae6fd',
+          300: '#7dd3fc',
+          400: '#38bdf8',
+          500: '#0ea5e9',
+          600: '#0284c7',
+          700: '#0369a1',
+          800: '#075985',
+          900: '#0c4a6e',
+          950: '#082f49',
+        },
+      },
+    },
+  },
+  plugins: [],
+}

data/examples/rails_app/config.ru

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require_relative 'config/environment'
+
+run Rails.application

data/examples/rails_app/tmp/local_secret.txt

@@ -0,0 +1 @@
+8ec864777deb2e477c24acfa26c5a4721c6d36f04e80b9ecb00d22002a591a12d213fd8e4d2107471e65de7f546f2a1e27317d1ea2c0130dc19e39f36af610a9

data/examples/robot_groups/multi_process.rb

@@ -13,7 +13,7 @@
 # 4. Dynamic scaling by spawning new processes
 #
 # Prerequisites:
-# 1. Set HTM_DBURL environment variable
+# 1. Set HTM_DATABASE__URL environment variable
 # 2. Initialize database schema: rake db_setup
 
 require_relative '../../lib/htm'
@@ -36,7 +36,7 @@ class RobotProcess
 
     # Spawn the worker process
     @stdin, @stdout, @stderr, @wait_thread = Open3.popen3(
-      { 'HTM_DBURL' => ENV['HTM_DBURL'] },
+      { 'HTM_DATABASE__URL' => ENV['HTM_DATABASE__URL'] },
       'ruby', WORKER_SCRIPT, name, group_name
     )
     @pid = @wait_thread.pid
@@ -119,9 +119,9 @@ def run_demo
 
   BANNER
 
-  unless ENV['HTM_DBURL']
-    puts 'ERROR: HTM_DBURL not set.'
-    puts '  export HTM_DBURL="postgresql://user@localhost:5432/htm_development"'
+  unless ENV['HTM_DATABASE__URL']
+    puts 'ERROR: HTM_DATABASE__URL not set.'
+    puts '  export HTM_DATABASE__URL="postgresql://user@localhost:5432/htm_development"'
     exit 1
   end
 

data/examples/robot_groups/robot_worker.rb

@@ -37,11 +37,11 @@ end
 
 # Configure HTM with logger to stderr (keep stdout clean for JSON)
 HTM.configure do |config|
-  config.embedding_provider = :ollama
-  config.embedding_model = 'nomic-embed-text:latest'
-  config.embedding_dimensions = 768
-  config.tag_provider = :ollama
-  config.tag_model = 'gemma3:latest'
+  config.embedding.provider = :ollama
+  config.embedding.model = 'nomic-embed-text:latest'
+  config.embedding.dimensions = 768
+  config.tag.provider = :ollama
+  config.tag.model = 'gemma3:latest'
   config.logger = Logger.new($stderr, level: Logger::WARN)
 end
 

data/examples/robot_groups/same_process.rb

@@ -19,7 +19,7 @@
 #    synchronization of in-memory working memory across robots.
 #
 # Prerequisites:
-# 1. Set HTM_DBURL environment variable
+# 1. Set HTM_DATABASE__URL environment variable
 # 2. Initialize database schema: rake db_setup
 # 3. Install dependencies: bundle install
 
@@ -33,9 +33,9 @@ require 'json'
 puts 'HTM Robot Group Demo - Shared Working Memory & Failover'
 puts '=' * 60
 
-unless ENV['HTM_DBURL']
-  puts 'ERROR: HTM_DBURL not set. Please set it:'
-  puts '  export HTM_DBURL="postgresql://postgres@localhost:5432/htm_development"'
+unless ENV['HTM_DATABASE__URL']
+  puts 'ERROR: HTM_DATABASE__URL not set. Please set it:'
+  puts '  export HTM_DATABASE__URL="postgresql://postgres@localhost:5432/htm_development"'
   exit 1
 end
 
@@ -43,11 +43,11 @@ begin
   # Configure HTM
   puts "\n1. Configuring HTM..."
   HTM.configure do |config|
-    config.embedding_provider = :ollama
-    config.embedding_model = 'nomic-embed-text:latest'
-    config.embedding_dimensions = 768
-    config.tag_provider = :ollama
-    config.tag_model = 'gemma3:latest'
+    config.embedding.provider = :ollama
+    config.embedding.model = 'nomic-embed-text:latest'
+    config.embedding.dimensions = 768
+    config.tag.provider = :ollama
+    config.tag.model = 'gemma3:latest'
   end
   puts '✓ HTM configured'
 

data/examples/sinatra_app/app.rb

@@ -14,7 +14,7 @@
 #   bundle exec ruby app.rb
 #
 # Environment:
-#   HTM_DBURL - PostgreSQL connection URL (required)
+#   HTM_DATABASE__URL - PostgreSQL connection URL (required)
 #   REDIS_URL - Redis connection URL (for Sidekiq, default: redis://localhost:6379/0)
 #   OLLAMA_URL - Ollama server URL (default: http://localhost:11434)
 #

data/examples/timeframe_demo.rb

@@ -4,7 +4,7 @@
 # Timeframe Demo - Demonstrates the various ways to use timeframes with recall
 #
 # Run with:
-#   HTM_DBURL="postgresql://localhost/htm_development" ruby examples/timeframe_demo.rb
+#   HTM_DATABASE__URL="postgresql://localhost/htm_development" ruby examples/timeframe_demo.rb
 
 require_relative "../lib/htm"
 

data/lib/htm/active_record_config.rb

@@ -3,14 +3,17 @@
 require 'active_record'
 require 'pg'
 require 'neighbor'
-require 'erb'
-require 'yaml'
 
 class HTM
   # ActiveRecord database configuration and model loading
+  #
+  # Uses HTM::Config for database settings. Configuration can come from:
+  # - Environment variables (HTM_DATABASE__URL, HTM_DATABASE__HOST, etc.)
+  # - Programmatic configuration via HTM.configure
+  #
   class ActiveRecordConfig
     class << self
-      # Establish database connection from config/database.yml
+      # Establish database connection from HTM::Config
       def establish_connection!
         config = load_database_config
 
@@ -25,30 +28,12 @@ class HTM
         true
       end
 
-      # Load and parse database configuration from YAML with ERB
+      # Load database configuration from HTM::Config
+      #
+      # @return [Hash] ActiveRecord-compatible configuration hash
+      #
       def load_database_config
-        config_path = File.expand_path('../../config/database.yml', __dir__)
-
-        unless File.exist?(config_path)
-          raise "Database configuration file not found at #{config_path}"
-        end
-
-        # Read and parse ERB
-        erb_content = ERB.new(File.read(config_path)).result
-        db_config = YAML.safe_load(erb_content, aliases: true)
-
-        # Determine environment
-        env = ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
-
-        # Get configuration for current environment
-        config = db_config[env]
-
-        unless config
-          raise "No database configuration found for environment: #{env}"
-        end
-
-        # Convert string keys to symbols for ActiveRecord
-        config.transform_keys(&:to_sym)
+        HTM.config.database_config
       end
 
       # Check if connection is established and active
@@ -59,8 +44,7 @@ class HTM
         ActiveRecord::Base.connected? && ActiveRecord::Base.connection.active?
       rescue ActiveRecord::ConnectionNotDefined, ActiveRecord::ConnectionNotEstablished
         false
-      rescue StandardError => e
-        HTM.logger.debug "Connection check failed: #{e.class} - #{e.message}"
+      rescue StandardError
         false
       end
 

data/lib/htm/circuit_breaker.rb

@@ -73,8 +73,6 @@ class HTM
             HTM.logger.warn "CircuitBreaker[#{@name}]: Circuit is OPEN, failing fast"
             raise CircuitBreakerOpenError, "Circuit breaker '#{@name}' is open. Service unavailable."
           end
-        when :half_open
-          HTM.logger.debug "CircuitBreaker[#{@name}]: Circuit is HALF-OPEN, testing service"
         end
       end