stomp_base 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 432af31faec38b086abee4fa9d32c0e1bd9ef3ccc15671a89f9e3edbf1fa5046
-  data.tar.gz: 41c7d84e8ebb7db6dc7283af52a2a2b34f3eced03fc0d50adb941eb99eb9a623
+  metadata.gz: 8b134d98cdd58b0e0f96d5045fdc83e9bc07379cd95e2bae7a7ee462d5ec9cc4
+  data.tar.gz: 3b1f9f0e9aada4b215c1c2d9277af0478a447ab309492004d76ab43a91171761
 SHA512:
-  metadata.gz: bf0f56a08d45a7044bd93efa8eb6389687b1984d0c5993e2e00808481ddda350e79460849982b20d5fc866e7c8915a3a8117c1c6ab614ff22b3fe0cf4af751ba
-  data.tar.gz: c01073b6cf496092b6fcda82ee5de049084d4f7ba79e542431147ed72a2a472bb507bad835dbe914ec4644955d4c10eb6bba0cc386eb7e05a123bd0abaf63e1b
+  metadata.gz: 49c1f34fc9b74d9c79e59e95a4acc47c518086f883f75586f04058338f8b27190a5de807569c09f4e1be37a2e765dc84bcf00a13324bfd466798c9e77a66f0c0
+  data.tar.gz: 7bd934b72a8ddaf2d29b65f71792d6a72883c9cb53272483b1f39b2c70205d41d65dab12b972328b87e5eda39ff22ccb607cddeb62918b2b93e25890742176eb

data/CHANGELOG.md

@@ -7,17 +7,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2025-07-27
+
+### Added
+- **Terminal-Style Console Interface**: Complete redesign of the browser console
+  - Real terminal-like experience with command history and session persistence
+  - Session state management to maintain console state across page reloads
+  - Responsive design optimized for both desktop and mobile devices
+  - Comprehensive Japanese and English translations
+- **Enhanced Documentation**: Comprehensive documentation for API-only Rails support and authentication features
+
+### Improved
+- **Console Functionality**: Enhanced console session management and user experience
+- **Test Coverage**: Added comprehensive tests for terminal console interface
+- **Responsive Design**: Improved mobile and tablet compatibility for console interface
+
+### Fixed
+- **Timezone Dependencies**: Resolved timezone dependency issues in console specifications
+- **Session Persistence**: Fixed console session state persistence across browser reloads
+
+## [0.2.1] - 2025-06-28
+
+### Added
+- **API-only Rails Support**: Automatic compatibility for API-only Rails applications
+  - Auto-configure necessary middleware (session, cookies, flash, method override)
+  - Automatic session store configuration for API-only applications
+  - No manual middleware configuration required in host applications
+- **Japanese Documentation**: Complete Japanese translation of README.md (README.ja.md)
+- **Rails Demo API**: Complete API-only Rails demonstration application
+  - Sample models, migrations, and authentication specifications
+  - Proper bin/ directory with Rails binstubs
+
 ### Changed
-- **Test Structure**: Updated test helper file structure for better separation of concerns
-  - Moved configuration tests to `spec/unit/configuration_spec.rb`
-  - Updated `spec_helper.rb` for pure Ruby logic tests only
-  - Deprecated main `spec/rails_helper.rb` with automatic redirection to appropriate helpers
-  - Rails-based tests now use `spec/rails_demo/spec/rails_helper.rb`
-- **Configuration**: Fixed duplicate `disable_authentication` method in Configuration class
+- **Settings Controller**: Improved settings save functionality with proper flash message handling
+- **Application Controller**: Simplified to use Rails standard flash functionality
+- **Routes**: Added POST route support for settings form submission
+- **Documentation**: Added cross-language links between README files
 
 ### Fixed
-- Removed duplicate method definitions in `StompBase::Configuration`
-- Updated test helper references for consistency
+- **RuboCop Issues**: Fixed RuboCop execution and code style issues
+- **CSS Assets**: Resolved CSS asset loading issues in API-only Rails applications
+- **Error Handling**: Improved error handling and logging for middleware setup
 
 ## [0.2.0] - 2025-05-28
 
@@ -71,5 +101,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 🔧 Easy Integration: Simple gem installation and mounting process
 - 🔐 Built-in Authentication: Simple authentication options (Basic Auth, API keys, Custom)
 
+[0.2.2]: https://github.com/snowwshiro/stomp_base/releases/tag/v0.2.2
+[0.2.1]: https://github.com/snowwshiro/stomp_base/releases/tag/v0.2.1
 [0.2.0]: https://github.com/snowwshiro/stomp_base/releases/tag/v0.2.0
 [0.1.0]: https://github.com/snowwshiro/stomp_base/releases/tag/v0.1.0

data/README.md

@@ -1,5 +1,7 @@
 # 🎛️ Stomp Base
 
+[ja README](./README.ja.md)
+
 [![CI](https://github.com/snowwshiro/stomp_base/workflows/CI/badge.svg)](https://github.com/snowwshiro/stomp_base/actions/workflows/ci.yml)
 [![Code Quality](https://github.com/snowwshiro/stomp_base/workflows/Code%20Quality/badge.svg)](https://github.com/snowwshiro/stomp_base/actions/workflows/code-quality.yml)
 [![Coverage](https://github.com/snowwshiro/stomp_base/workflows/Coverage/badge.svg)](https://github.com/snowwshiro/stomp_base/actions/workflows/coverage.yml)
@@ -59,6 +61,30 @@ end
 2. **Install View Component** (automatically included as dependency):
 The gem includes View Component as a dependency, so no additional setup is required.
 
+### API-Only Rails Applications
+
+StompBase automatically works with API-only Rails applications! The engine detects when the asset pipeline is not available and configures static asset serving automatically.
+
+**No additional configuration needed** - StompBase will:
+- Detect API-only mode (`config.api_only = true`)
+- Automatically serve CSS assets via `ActionDispatch::Static` middleware
+- Display helpful warnings if public file server is disabled
+
+If you encounter styling issues in an API-only app, ensure public file server is enabled:
+
+```ruby
+# config/application.rb or config/environments/development.rb
+config.public_file_server.enabled = true
+```
+
+Alternatively, you can enable ActionView and the asset pipeline:
+
+```ruby
+# config/application.rb
+require "action_view/railtie"
+# Remove or comment out: config.api_only = true
+```
+
 ## Usage
 
 ### Accessing the Dashboard
@@ -245,6 +271,9 @@ StompBase.configure do |config|
   config.locale = :ja                    # Set interface language
   config.available_locales = [:en, :ja]  # Available language options (read-only)
   
+  # Console configuration
+  config.allow_console_in_production = false # Allow console functionality in production (default: false)
+  
   # Authentication options
   config.enable_authentication(          # Enable authentication
     method: :basic_auth,                 # :basic_auth, :api_key, or :custom
@@ -270,6 +299,20 @@ StompBase.enable_authentication(method: :basic_auth, username: 'admin', password
 StompBase.disable_authentication
 ```
 
+### Console Configuration
+
+For security reasons, the Rails console functionality is disabled in production environments by default. You can enable it if needed:
+
+```ruby
+# config/initializers/stomp_base.rb
+StompBase.configure do |config|
+  # Enable console functionality in production (disabled by default for security)
+  config.allow_console_in_production = true
+end
+```
+
+**⚠️ Security Warning**: Enabling console functionality in production environments poses significant security risks. Only enable this feature if you fully understand the implications and have proper security measures in place.
+
 ### Direct Configuration
 
 ```ruby
@@ -435,6 +478,8 @@ StompBase.configure do |config|
       method: :api_key,
       keys: [ENV['STOMP_BASE_API_KEY']]
     )
+    # Console disabled in production by default for security
+    # config.allow_console_in_production = true  # Uncomment only if absolutely necessary
   elsif Rails.env.development?
     # Simple authentication for development
     config.enable_authentication(
@@ -442,6 +487,7 @@ StompBase.configure do |config|
       username: 'dev',
       password: 'dev'
     )
+    # Console enabled in development by default
   else
     # Disable authentication for test environment
     config.disable_authentication
@@ -455,6 +501,8 @@ end
 - Use HTTPS (especially when using Basic Authentication)
 - Update API keys regularly
 - Be careful not to output authentication information to log files
+- **Console functionality should remain disabled in production environments** unless absolutely necessary for debugging
+- If console access is required in production, ensure strong authentication is enabled and access is properly logged
 
 ## Implementation Summary
 

data/app/components/stomp_base/console/console_examples_component.html.erb

@@ -9,7 +9,7 @@
   <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 0.5rem;">
     <% console_examples.each do |example| %>
       <button 
-        onclick="insertExampleCommand('<%= example[:command] %>')"
+        onclick="insertTerminalCommand('<%= example[:command] %>')"
         class="stomp-base-btn" 
         style="text-align: left; padding: 0.75rem; background-color: #f8fafc; color: #374151; border: 1px solid #e2e8f0; border-radius: 0.375rem; font-family: 'Courier New', monospace; font-size: 0.8125rem; transition: all 0.2s ease;"
         onmouseover="this.style.backgroundColor='#f1f5f9'; this.style.borderColor='#cbd5e1';"

data/app/components/stomp_base/console/terminal_component.html.erb

@@ -0,0 +1,317 @@
+<!-- Terminal-style Console Interface -->
+<div class="stomp-base-card" style="margin-bottom: 0.75rem; background-color: #1e1e1e; border: 1px solid #333; border-radius: 0.5rem; overflow: hidden;">
+  <div style="display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 0.5rem; padding: 0.75rem 1rem; background-color: #2d2d2d; border-bottom: 1px solid #333;">
+    <div style="display: flex; align-items: center; min-width: 0;">
+      <svg style="width: 1.25rem; height: 1.25rem; margin-right: 0.5rem; color: #10b981; flex-shrink: 0;" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 002 2z"></path>
+      </svg>
+      <span style="color: #e5e7eb; font-weight: 600; font-size: 0.875rem; white-space: nowrap;">Rails Console</span>
+    </div>
+    <div style="display: flex; gap: 0.5rem; flex-shrink: 0;">
+      <button onclick="clearTerminal()" class="stomp-base-btn" style="padding: 0.375rem 0.75rem; font-size: 0.75rem; background-color: #374151; color: #e5e7eb; border: 1px solid #4b5563; border-radius: 0.375rem; white-space: nowrap;">
+        <%= t('stomp_base.console.clear') %>
+      </button>
+      <button onclick="restartSession()" class="stomp-base-btn" style="padding: 0.375rem 0.75rem; font-size: 0.75rem; background-color: #dc2626; color: #fff; border: 1px solid #dc2626; border-radius: 0.375rem; white-space: nowrap;">
+        Restart
+      </button>
+    </div>
+  </div>
+
+  <!-- Terminal Display Area -->
+  <div 
+    id="terminal-display" 
+    style="height: 400px; max-height: 60vh; overflow-y: auto; padding: 1rem; background-color: #1e1e1e; font-family: 'Courier New', 'Monaco', 'Consolas', monospace; font-size: 0.875rem; line-height: 1.4; color: #e5e7eb;"
+  >
+    <div id="terminal-output">
+      <div style="color: #10b981; margin-bottom: 0.5rem;"><%= welcome_message %></div>
+    </div>
+    <div id="terminal-input-line" style="display: flex; align-items: flex-start; gap: 0.25rem;">
+      <span id="terminal-prompt" style="color: #10b981; flex-shrink: 0; user-select: none; font-size: 0.875rem; line-height: 1.4;"><%= initial_prompt %></span>
+      <div style="flex: 1; min-width: 0; position: relative;">
+        <textarea
+          id="terminal-input"
+          style="width: 100%; min-height: 1.4em; background: transparent; border: none; outline: none; color: #e5e7eb; font-family: inherit; font-size: inherit; line-height: inherit; resize: none; padding: 0; margin: 0; overflow: hidden; word-wrap: break-word;"
+          placeholder="<%= t('stomp_base.console.placeholder') %>"
+          rows="1"
+          onkeydown="handleTerminalKeydown(event)"
+          oninput="adjustTerminalInputHeight()"
+        ></textarea>
+      </div>
+    </div>
+  </div>
+
+  <!-- Hidden session ID for JavaScript -->
+  <input type="hidden" id="terminal-session-id" value="<%= session_id %>">
+</div>
+
+<style>
+  @media (max-width: 640px) {
+    #terminal-display {
+      height: 300px !important;
+      max-height: 50vh !important;
+      padding: 0.75rem !important;
+      font-size: 0.8125rem !important;
+    }
+    
+    #terminal-input {
+      font-size: 0.8125rem !important;
+    }
+    
+    #terminal-prompt {
+      font-size: 0.8125rem !important;
+    }
+  }
+  
+  @media (max-width: 480px) {
+    #terminal-display {
+      height: 250px !important;
+      max-height: 40vh !important;
+      padding: 0.5rem !important;
+      font-size: 0.75rem !important;
+    }
+    
+    #terminal-input {
+      font-size: 0.75rem !important;
+    }
+    
+    #terminal-prompt {
+      font-size: 0.75rem !important;
+    }
+  }
+</style>
+
+<script>
+// Terminal functionality
+let terminalHistory = [];
+let terminalHistoryIndex = -1;
+let terminalCommandCounter = 1;
+let terminalSessionId = document.getElementById('terminal-session-id').value;
+
+function handleTerminalKeydown(event) {
+  const input = event.target;
+  
+  // Execute on Enter (without Shift)
+  if (event.key === 'Enter' && !event.shiftKey) {
+    event.preventDefault();
+    executeTerminalCommand();
+    return;
+  }
+  
+  // Allow Shift+Enter for multi-line input
+  if (event.key === 'Enter' && event.shiftKey) {
+    // Let the default behavior handle the new line
+    setTimeout(() => adjustTerminalInputHeight(), 0);
+    return;
+  }
+  
+  // History navigation with Up/Down arrows
+  if (event.key === 'ArrowUp' && terminalHistory.length > 0) {
+    event.preventDefault();
+    terminalHistoryIndex = Math.min(terminalHistoryIndex + 1, terminalHistory.length - 1);
+    input.value = terminalHistory[terminalHistoryIndex];
+    adjustTerminalInputHeight();
+  } else if (event.key === 'ArrowDown') {
+    event.preventDefault();
+    if (terminalHistoryIndex > 0) {
+      terminalHistoryIndex--;
+      input.value = terminalHistory[terminalHistoryIndex];
+    } else {
+      terminalHistoryIndex = -1;
+      input.value = '';
+    }
+    adjustTerminalInputHeight();
+  }
+}
+
+function adjustTerminalInputHeight() {
+  const input = document.getElementById('terminal-input');
+  input.style.height = 'auto';
+  input.style.height = input.scrollHeight + 'px';
+}
+
+function showSessionPersistenceNotice() {
+  const notice = document.createElement('div');
+  notice.style.cssText = `
+    position: fixed;
+    top: 20px;
+    right: 20px;
+    background: #10b981;
+    color: white;
+    padding: 12px 16px;
+    border-radius: 6px;
+    font-size: 14px;
+    z-index: 1000;
+    opacity: 0;
+    transform: translateX(100%);
+    transition: all 0.3s ease;
+  `;
+  notice.textContent = '<%= t('stomp_base.console.variable_persistence') %>';
+  
+  document.body.appendChild(notice);
+  
+  setTimeout(() => {
+    notice.style.opacity = '1';
+    notice.style.transform = 'translateX(0)';
+  }, 100);
+  
+  setTimeout(() => {
+    notice.style.opacity = '0';
+    notice.style.transform = 'translateX(100%)';
+    setTimeout(() => notice.remove(), 300);
+  }, 3000);
+}
+
+// Show session persistence notice on first command
+let firstCommandExecuted = false;
+function executeTerminalCommand() {
+  const input = document.getElementById('terminal-input');
+  const command = input.value.trim();
+  
+  if (!command) return;
+  
+  // Show persistence notice on first command
+  if (!firstCommandExecuted) {
+    showSessionPersistenceNotice();
+    firstCommandExecuted = true;
+  }
+  
+  // Add to history
+  terminalHistory.unshift(command);
+  if (terminalHistory.length > 50) {
+    terminalHistory = terminalHistory.slice(0, 50);
+  }
+  terminalHistoryIndex = -1;
+  
+  // Display command in terminal
+  displayTerminalCommand(command);
+  
+  // Clear input and reset height
+  input.value = '';
+  input.style.height = 'auto';
+  
+  // Execute command via AJAX
+  fetch('<%= StompBase::Engine.routes.url_helpers.console_execute_path %>', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'X-CSRF-Token': document.querySelector('[name="csrf-token"]').content
+    },
+    body: JSON.stringify({ 
+      command: command, 
+      session_id: terminalSessionId,
+      command_counter: terminalCommandCounter
+    })
+  })
+  .then(response => response.json())
+  .then(data => {
+    if (data.success) {
+      displayTerminalOutput(data.result, data.command_counter);
+    } else {
+      displayTerminalError(data.error, data.command_counter);
+    }
+    terminalCommandCounter = data.command_counter ? data.command_counter + 1 : terminalCommandCounter + 1;
+    updateTerminalPrompt();
+  })
+  .catch(error => {
+    displayTerminalError(`Network error: ${error.message}`, terminalCommandCounter);
+    terminalCommandCounter++;
+    updateTerminalPrompt();
+  });
+}
+
+function displayTerminalCommand(command) {
+  const output = document.getElementById('terminal-output');
+  const commandDiv = document.createElement('div');
+  commandDiv.innerHTML = `<span style="color: #10b981;">${getCurrentPrompt()}</span>${escapeHtml(command)}`;
+  output.appendChild(commandDiv);
+  scrollTerminalToBottom();
+}
+
+function displayTerminalOutput(result, commandCounter) {
+  const output = document.getElementById('terminal-output');
+  const resultDiv = document.createElement('div');
+  resultDiv.style.color = '#e5e7eb';
+  resultDiv.style.marginBottom = '0.5rem';
+  resultDiv.style.whiteSpace = 'pre-wrap';
+  resultDiv.textContent = result;
+  output.appendChild(resultDiv);
+  scrollTerminalToBottom();
+}
+
+function displayTerminalError(error, commandCounter) {
+  const output = document.getElementById('terminal-output');
+  const errorDiv = document.createElement('div');
+  errorDiv.style.color = '#ef4444';
+  errorDiv.style.marginBottom = '0.5rem';
+  errorDiv.style.whiteSpace = 'pre-wrap';
+  errorDiv.textContent = error;
+  output.appendChild(errorDiv);
+  scrollTerminalToBottom();
+}
+
+function getCurrentPrompt() {
+  return `irb(main):${String(terminalCommandCounter).padStart(3, '0')}:0> `;
+}
+
+function updateTerminalPrompt() {
+  const prompt = document.getElementById('terminal-prompt');
+  prompt.textContent = getCurrentPrompt();
+}
+
+function scrollTerminalToBottom() {
+  const display = document.getElementById('terminal-display');
+  display.scrollTop = display.scrollHeight;
+}
+
+function clearTerminal() {
+  const output = document.getElementById('terminal-output');
+  output.innerHTML = `<div style="color: #10b981; margin-bottom: 0.5rem;"><%= welcome_message %></div>`;
+  terminalCommandCounter = 1;
+  updateTerminalPrompt();
+  document.getElementById('terminal-input').focus();
+}
+
+function restartSession() {
+  if (confirm('Are you sure you want to restart the console session? All variables will be lost.')) {
+    terminalSessionId = generateSessionId();
+    document.getElementById('terminal-session-id').value = terminalSessionId;
+    clearTerminal();
+    
+    // Notify server to clear session
+    fetch('<%= StompBase::Engine.routes.url_helpers.console_execute_path %>', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-CSRF-Token': document.querySelector('[name="csrf-token"]').content
+      },
+      body: JSON.stringify({ 
+        command: '__restart_session__', 
+        session_id: terminalSessionId 
+      })
+    });
+  }
+}
+
+function generateSessionId() {
+  return Math.random().toString(36).substr(2, 9);
+}
+
+function escapeHtml(text) {
+  const div = document.createElement('div');
+  div.textContent = text;
+  return div.innerHTML;
+}
+
+function insertTerminalCommand(command) {
+  const input = document.getElementById('terminal-input');
+  input.value = command;
+  input.focus();
+  adjustTerminalInputHeight();
+}
+
+// Focus input on page load
+document.addEventListener('DOMContentLoaded', function() {
+  document.getElementById('terminal-input').focus();
+  updateTerminalPrompt();
+});
+</script>

data/app/components/stomp_base/console/terminal_component.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module StompBase
+  module Console
+    class TerminalComponent < StompBase::BaseComponent
+      def initialize(session_id: nil)
+        super()
+        @session_id = session_id || SecureRandom.hex(8)
+      end
+
+      private
+
+      attr_reader :session_id
+
+      def initial_prompt
+        "irb(main):001:0> "
+      end
+
+      def welcome_message
+        "#{t("stomp_base.console.terminal_welcome")}\n#{t("stomp_base.console.terminal_help")}"
+      end
+    end
+  end
+end

data/app/components/stomp_base/pages/console_component.html.erb

@@ -3,21 +3,17 @@
   display_options: { 
     gradient_colors: { from: '#1f2937', to: '#374151' },
     status_message: t('stomp_base.console.welcome_message'),
-    custom_button: '<button onclick="clearConsoleOutput()" class="stomp-base-btn" style="display: inline-flex; align-items: center; padding: 0.375rem 0.625rem; font-size: 0.8125rem; background-color: rgba(255,255,255,0.2); color: white; border: 1px solid rgba(255,255,255,0.3); backdrop-filter: blur(10px);">
+    custom_button: '<button onclick="restartSession()" class="stomp-base-btn" style="display: inline-flex; align-items: center; padding: 0.375rem 0.625rem; font-size: 0.8125rem; background-color: rgba(220,38,38,0.8); color: white; border: 1px solid rgba(220,38,38,0.3); backdrop-filter: blur(10px);">
       <svg style="width: 0.75rem; height: 0.75rem; margin-right: 0.375rem;" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-        <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"></path>
+        <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"></path>
       </svg>
-      ' + t('stomp_base.console.clear') + '
+      Restart Session
     </button>'.html_safe
   }
 ) %>
 
 <%= render StompBase::Console::SecurityWarningComponent.new %>
 
-<%= render StompBase::Console::ConsoleInterfaceComponent.new %>
+<%= render StompBase::Console::TerminalComponent.new %>
 
 <%= render StompBase::Console::ConsoleExamplesComponent.new %>
-
-<%= render StompBase::Console::ConsoleJavascriptComponent.new %>
-
-<%= render StompBase::Console::ConsoleCssComponent.new %>

data/app/controllers/stomp_base/application_controller.rb

@@ -2,6 +2,10 @@
 
 module StompBase
   class ApplicationController < ActionController::Base
+    # Include necessary modules for API-only compatibility
+    include ActionController::Cookies
+    include ActionController::Flash unless included_modules.include?(ActionController::Flash)
+
     include StompBase::I18nHelper
     include StompBase::Authentication
 

data/app/controllers/stomp_base/console_controller.rb

@@ -43,40 +43,50 @@ module StompBase
 
     def execute
       command = params[:command]&.strip
+      session_id = params[:session_id]
+      command_counter = params[:command_counter]&.to_i || 1
+
       return render_error(I18n.t("stomp_base.console.error")) if command.blank?
 
-      process_console_command(command)
+      # Handle session restart
+      if command == "__restart_session__"
+        clear_session_binding(session_id)
+        return render json: { success: true, result: "Session restarted", command_counter: 1 }
+      end
+
+      process_console_command(command, session_id, command_counter)
     rescue StandardError => e
-      handle_execution_error(e)
+      handle_execution_error(e, command_counter)
     end
 
-    def process_console_command(command)
+    def process_console_command(command, session_id, command_counter)
       Rails.logger.info "StompBase Console Command: #{command}"
       return render_dangerous_command_error if dangerous_command?(command)
 
-      result = execute_in_rails_console(command)
-      render_success(result)
+      result = execute_in_rails_console(command, session_id)
+      render_success(result, command_counter)
     end
 
-    def handle_execution_error(error)
+    def handle_execution_error(error, command_counter = 1)
       Rails.logger.error "StompBase Console Error: #{error.message}"
-      render_error(error.message)
+      render_error(error.message, command_counter)
     end
 
     private
 
-    def render_error(message)
-      render json: { success: false, error: message, result: nil }
+    def render_error(message, command_counter = 1)
+      render json: { success: false, error: message, result: nil, command_counter: command_counter }
     end
 
-    def render_success(result)
-      render json: { success: true, result: result.to_s, error: false }
+    def render_success(result, command_counter = 1)
+      render json: { success: true, result: result.to_s, error: false, command_counter: command_counter }
     end
 
     def render_dangerous_command_error
       render json: {
         success: false,
-        error: "Dangerous command detected. Execution denied."
+        error: "Dangerous command detected. Execution denied.",
+        command_counter: 1
       }
     end
 
@@ -90,10 +100,10 @@ module StompBase
       DANGEROUS_PATTERNS.any? { |pattern| command.match?(pattern) }
     end
 
-    def execute_in_rails_console(command)
+    def execute_in_rails_console(command, session_id)
       # Evaluate command in secure execution environment
-      # Simulate basic Rails console environment
-      binding_context = create_console_binding
+      # Maintain session state for each session_id
+      binding_context = get_or_create_session_binding(session_id)
 
       # Set timeout (10 seconds)
       result = Timeout.timeout(10) do
@@ -104,6 +114,47 @@ module StompBase
       format_result(result)
     end
 
+    # Class-level session storage to persist across requests
+    @@session_bindings = {}
+    @@session_mutex = Mutex.new
+    @@session_timestamps = {}
+
+    def get_or_create_session_binding(session_id)
+      @@session_mutex.synchronize do
+        # Clean up old sessions (older than 30 minutes)
+        cleanup_old_sessions
+
+        # Create or retrieve session binding
+        unless @@session_bindings[session_id]
+          @@session_bindings[session_id] = create_console_binding
+          @@session_timestamps[session_id] = Time.current
+        end
+
+        # Update timestamp
+        @@session_timestamps[session_id] = Time.current
+        @@session_bindings[session_id]
+      end
+    end
+
+    def clear_session_binding(session_id)
+      @@session_mutex.synchronize do
+        @@session_bindings.delete(session_id)
+        @@session_timestamps.delete(session_id)
+      end
+    end
+
+    def cleanup_old_sessions
+      current_time = Time.current
+      expired_sessions = @@session_timestamps.select do |_session_id, timestamp|
+        current_time - timestamp > 30.minutes
+      end
+
+      expired_sessions.each_key do |session_id|
+        @@session_bindings.delete(session_id)
+        @@session_timestamps.delete(session_id)
+      end
+    end
+
     def create_console_binding
       binding_object = ConsoleBindingHelper.new
       binding_object.instance_eval { binding }
@@ -207,5 +258,33 @@ module StompBase
     rescue StandardError => e
       "#{result} (inspect failed: #{e.message})"
     end
+
+    # Session management utility methods
+    def active_sessions_count
+      @@session_mutex.synchronize do
+        @@session_bindings.size
+      end
+    end
+
+    def session_info(session_id)
+      @@session_mutex.synchronize do
+        return nil unless @@session_bindings.key?(session_id)
+
+        {
+          session_id: session_id,
+          created_at: @@session_timestamps[session_id],
+          last_accessed: @@session_timestamps[session_id],
+          active: true
+        }
+      end
+    end
+
+    def all_sessions_info
+      @@session_mutex.synchronize do
+        @@session_bindings.keys.map do |session_id|
+          session_info(session_id)
+        end
+      end
+    end
   end
 end

data/app/controllers/stomp_base/settings_controller.rb

@@ -14,7 +14,7 @@ module StompBase
 
       update_theme_setting(params[:theme]) if params[:theme]
 
-      redirect_back(fallback_location: stomp_base.root_path, notice: t("stomp_base.settings.settings_updated"))
+      safe_redirect_with_notice(t("stomp_base.settings.settings_updated"))
     end
 
     def update_locale
@@ -43,7 +43,7 @@ module StompBase
       respond_to do |format|
         format.json { render json: { status: "success", locale: locale } }
         format.html do
-          redirect_back(fallback_location: stomp_base.root_path, notice: t("stomp_base.settings.settings_updated"))
+          safe_redirect_with_notice(t("stomp_base.settings.settings_updated"))
         end
       end
     end
@@ -55,7 +55,7 @@ module StompBase
                  status: :unprocessable_entity
         end
         format.html do
-          redirect_back(fallback_location: stomp_base.root_path, alert: t("stomp_base.settings.invalid_locale"))
+          safe_redirect_with_alert(t("stomp_base.settings.invalid_locale"))
         end
       end
     end
@@ -75,5 +75,15 @@ module StompBase
 
       session[:stomp_base_theme] = theme
     end
+
+    def safe_redirect_with_notice(message)
+      flash[:notice] = message
+      redirect_back(fallback_location: stomp_base.root_path)
+    end
+
+    def safe_redirect_with_alert(message)
+      flash[:alert] = message
+      redirect_back(fallback_location: stomp_base.root_path)
+    end
   end
 end

data/config/locales/en.yml

@@ -82,10 +82,12 @@ en:
       available: "Available"
       open_console: "Open Console"
       welcome_message: "Rails Console"
-      placeholder: "Enter Ruby code (e.g., User.count)"
+      placeholder: "Type your Ruby code here..."
       execute: "Execute"
       clear: "Clear"
       clear_history: "Clear History"
+      restart_session: "Restart Session"
+      session_restarted: "Session restarted"
       history: "History"
       output: "Output"
       no_output: "No output"
@@ -97,6 +99,8 @@ en:
       sandbox_mode: "Sandbox Mode"
       enable_sandbox: "Enable Sandbox"
       disable_sandbox: "Disable Sandbox"
+      terminal_welcome: "Welcome to StompBase Rails Console"
+      terminal_help: "Type 'help' for available commands"
       examples:
         title: "Example Commands"
         user_count: "User.count"
@@ -181,3 +185,11 @@ en:
       table_name_label: "Table Name"
       record_count_label: "Records"
       null_value: "NULL"
+      session_info: "Session Information"
+      session_id: "Session ID"
+      session_active: "Active"
+      session_created_at: "Created At"
+      session_last_accessed: "Last Accessed"
+      active_sessions: "Active Sessions Count"
+      variable_persistence: "Variable state is maintained between commands"
+      session_timeout: "Sessions automatically expire after 30 minutes of inactivity"

data/config/locales/ja.yml

@@ -82,10 +82,12 @@ ja:
       available: "利用可能"
       open_console: "コンソールを開く"
       welcome_message: "Rails Console"
-      placeholder: "Rubyコードを入力してください（例: User.count）"
+      placeholder: "Rubyコードを入力してください..."
       execute: "実行"
       clear: "クリア"
       clear_history: "履歴をクリア"
+      restart_session: "セッションを再開"
+      session_restarted: "セッションが再開されました"
       history: "履歴"
       output: "出力"
       no_output: "出力がありません"
@@ -97,6 +99,7 @@ ja:
       sandbox_mode: "サンドボックスモード"
       enable_sandbox: "サンドボックスを有効にする"
       disable_sandbox: "サンドボックスを無効にする"
+      terminal_welcome: "StompBase Rails Console へようこそ"
       examples:
         title: "コマンド例"
         user_count: "User.count"
@@ -186,3 +189,11 @@ ja:
       table_name_label: "テーブル名"
       record_count_label: "レコード数"
       null_value: "NULL"
+      session_info: "セッション情報"
+      session_id: "セッションID"
+      session_active: "アクティブ"
+      session_created_at: "作成日時"
+      session_last_accessed: "最終アクセス"
+      active_sessions: "アクティブセッション数"
+      variable_persistence: "変数の状態はセッション間で保持されます"
+      session_timeout: "セッションは30分間非アクティブ状態が続くと自動的に終了します"

data/config/routes.rb

@@ -8,7 +8,9 @@ StompBase::Engine.routes.draw do
 
   get "settings", to: "settings#index"
   patch "settings", to: "settings#update"
+  post "settings", to: "settings#update"
   patch "settings/locale", to: "settings#update_locale", as: "update_locale"
+  post "settings/locale", to: "settings#update_locale"
 
   # Console routes
   get "console", to: "console#index"

data/lib/stomp_base/engine.rb

@@ -15,14 +15,16 @@ module StompBase
       g.helper true
     end
 
-    # Add asset paths for Rails 8 compatibility
-    if defined?(Rails.application.config.assets)
-      config.assets.paths << root.join("app", "assets", "javascripts")
-      config.assets.paths << root.join("app", "assets", "stylesheets")
-      config.assets.paths << root.join("app", "javascript")
+    # Add asset paths for Rails compatibility (when asset pipeline is available)
+    config.after_initialize do |app|
+      if app.config.respond_to?(:assets)
+        app.config.assets.paths << root.join("app", "assets", "javascripts")
+        app.config.assets.paths << root.join("app", "assets", "stylesheets")
+        app.config.assets.paths << root.join("app", "javascript")
 
-      # CSS precompilation (JavaScript is managed by importmap)
-      config.assets.precompile += %w[stomp_base/application.css stomp_base/base.css]
+        # CSS precompilation (JavaScript is managed by importmap)
+        app.config.assets.precompile += %w[stomp_base/application.css stomp_base/base.css]
+      end
     end
 
     # I18n configuration
@@ -36,5 +38,102 @@ module StompBase
         I18n.default_locale = StompBase.locale
       end
     end
+
+    # Configure static asset serving for API-only Rails applications
+    initializer "stomp_base.static_assets" do |app|
+      if self.class.should_serve_static_assets?(app.config)
+        app.middleware.use(
+          ::ActionDispatch::Static,
+          "#{root}/app/assets",
+          headers: {
+            "Cache-Control" => "public, max-age=31536000"
+          }
+        )
+      end
+    end
+
+    # Configuration validation for StompBase compatibility
+    initializer "stomp_base.validate_configuration" do |app|
+      app.config.after_initialize do
+        if app.config.api_only && !app.config.respond_to?(:assets)
+          Rails.logger.info "StompBase: Detected API-only Rails application without asset pipeline"
+
+          if app.config.public_file_server.enabled
+            Rails.logger.info "StompBase: Configured static asset serving for API-only mode"
+          else
+            Rails.logger.warn <<~WARNING
+              ⚠️  StompBase Warning: Your API-only Rails application has public file server disabled.
+              StompBase requires CSS assets to be served for proper UI functionality.
+
+              To fix this, add to your config/application.rb or config/environments/#{Rails.env}.rb:
+                config.public_file_server.enabled = true
+
+              Or enable ActionView and asset pipeline by uncommenting in config/application.rb:
+                require "action_view/railtie"
+            WARNING
+          end
+        end
+      end
+    end
+
+    # Configure middleware for API-only Rails applications
+    initializer "stomp_base.api_middleware", before: :build_middleware_stack do |app|
+      if app.config.api_only
+        Rails.logger.info "StompBase: Configuring middleware for API-only Rails application"
+
+        # Add necessary middleware for StompBase compatibility
+        required_middleware = [
+          [Rack::MethodOverride, []],
+          [ActionDispatch::Cookies, []],
+          [ActionDispatch::Session::CookieStore, []],
+          [ActionDispatch::Flash, []]
+        ]
+
+        required_middleware.each do |middleware_class, args|
+          app.config.middleware.use middleware_class, *args
+          Rails.logger.debug { "StompBase: Added #{middleware_class} middleware" }
+        rescue ArgumentError => e
+          # Middleware might already be present
+          Rails.logger.debug { "StompBase: #{middleware_class} middleware already present or error: #{e.message}" }
+        end
+
+        Rails.logger.info "StompBase: Middleware configuration completed"
+      end
+    end
+
+    # Configure session store for API-only Rails applications
+    initializer "stomp_base.session_store" do |app|
+      if app.config.api_only && !Rails.application.config.session_store
+        app.config.session_store :cookie_store, key: "_#{Rails.application.class.module_parent_name.underscore}_session"
+        Rails.logger.info "StompBase: Configured cookie session store for API-only application"
+      end
+    end
+
+    # Check if we need to serve static assets (for API-only Rails apps)
+    def self.should_serve_static_assets?(app_config)
+      # Serve static assets if:
+      # 1. The asset pipeline is not available (API-only mode)
+      # 2. Public file server is enabled (default in development/test)
+      !app_config.respond_to?(:assets) && app_config.public_file_server.enabled
+    end
+
+    # Check for ActionView availability and provide guidance
+    initializer "stomp_base.actionview_check", after: :load_config_initializers do |app|
+      if app.config.api_only
+        if defined?(ActionView::Railtie) && Rails.application.config.railties_order.include?(ActionView::Railtie)
+          Rails.logger.info "StompBase: ActionView railtie detected - full UI functionality available"
+        else
+          Rails.logger.warn <<~WARNING
+            ⚠️  StompBase Notice: ActionView railtie is not loaded.
+            StompBase requires ActionView for rendering UI components.
+
+            To enable ActionView, uncomment this line in your config/application.rb:
+              require "action_view/railtie"
+
+            StompBase will attempt to function with limited capabilities.
+          WARNING
+        end
+      end
+    end
   end
 end

data/lib/stomp_base/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StompBase
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stomp_base
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - snowwshiro
@@ -69,6 +69,8 @@ files:
 - app/components/stomp_base/console/console_javascript_component.rb
 - app/components/stomp_base/console/security_warning_component.html.erb
 - app/components/stomp_base/console/security_warning_component.rb
+- app/components/stomp_base/console/terminal_component.html.erb
+- app/components/stomp_base/console/terminal_component.rb
 - app/components/stomp_base/dashboard/database_info_card_component.html.erb
 - app/components/stomp_base/dashboard/database_info_card_component.rb
 - app/components/stomp_base/dashboard/performance_metrics_card_component.html.erb