htm 0.0.15 → 0.0.17

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/lib/htm/active_record_config.rb

@@ -37,14 +37,11 @@ class HTM
         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]
+        config = db_config[HTM.env]
 
         unless config
-          raise "No database configuration found for environment: #{env}"
+          raise "No database configuration found for environment: #{HTM.env}"
         end
 
         # Convert string keys to symbols for ActiveRecord

data/lib/htm/configuration.rb

@@ -329,8 +329,7 @@ class HTM
       end
 
       # Detect test environment - use inline for synchronous execution
-      test_env = ENV['RACK_ENV'] == 'test' || ENV['RAILS_ENV'] == 'test' || ENV['APP_ENV'] == 'test'
-      return :inline if test_env
+      return :inline if HTM.test?
 
       # Detect Rails - prefer ActiveJob
       if defined?(ActiveJob)
@@ -682,6 +681,40 @@ class HTM
   class << self
     attr_writer :configuration
 
+    # Get current environment
+    #
+    # Priority: HTM_ENV > RAILS_ENV > RACK_ENV > 'development'
+    #
+    # @return [String] Current environment name
+    #
+    def env
+      ENV['HTM_ENV'] || ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
+    end
+
+    # Check if running in test environment
+    #
+    # @return [Boolean]
+    #
+    def test?
+      env == 'test'
+    end
+
+    # Check if running in development environment
+    #
+    # @return [Boolean]
+    #
+    def development?
+      env == 'development'
+    end
+
+    # Check if running in production environment
+    #
+    # @return [Boolean]
+    #
+    def production?
+      env == 'production'
+    end
+
     # Get current configuration
     #
     # @return [HTM::Configuration]

data/lib/htm/database.rb

@@ -114,8 +114,7 @@ class HTM
         config = db_url ? parse_connection_url(db_url) : default_config
         raise "Database configuration not found" unless config
 
-        env = ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
-        puts "Environment: #{env}"
+        puts "Environment: #{HTM.env}"
         puts "Database: #{config[:dbname]}"
 
         conn = PG.connect(config)
@@ -369,16 +368,14 @@ class HTM
         config = db_url ? parse_connection_url(db_url) : default_config
         raise "Database configuration not found" unless config
 
-        env = ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
-
         conn = PG.connect(config)
 
-        puts "\nHTM Database Information (#{env})"
+        puts "\nHTM Database Information (#{HTM.env})"
         puts "=" * 80
 
         # Connection info
         puts "\nConnection:"
-        puts "  Environment: #{env}"
+        puts "  Environment: #{HTM.env}"
         puts "  Host: #{config[:host]}"
         puts "  Port: #{config[:port]}"
         puts "  Database: #{config[:dbname]}"