rails_nexus 2.0.0

data/lib/generators/rails_nexus/templates/backup/models/sync_backup.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+# Sync backup template — remote sync to backup server
+
+model :sync_backup do
+  # Database
+  database Mysql do |db|
+    db.name = ENV["DATABASE_NAME"] || "myapp_production"
+    db.username = ENV["DATABASE_USER"] || "root"
+    db.password = ENV["DATABASE_PASSWORD"] || ""
+    db.host = ENV["DATABASE_HOST"] || "localhost"
+    db.port = (ENV["DATABASE_PORT"] || 3306).to_i
+
+    # Skip large/temporary tables
+    skip_tables = ENV["BACKUP_SKIP_TABLES"] || "sessions,caches,active_storage"
+    skip_tables.split(",").each { |t| db.skip_tables << t.strip }
+  end
+
+  # Compress with Gzip
+  compress_with Gzip
+
+  # Store locally (staging area)
+  store_with Local do |local|
+    local.path = ENV["BACKUP_DUMP_PATH"] || File.expand_path("storage/rails_nexus/backups/sync", Rails.root)
+    local.keep = 1
+  end
+
+  # Sync to remote server
+  notify_by Sync do |sync|
+    sync.directories do |directory|
+      directory.path = ENV["BACKUP_DUMP_PATH"] || File.expand_path("storage/rails_nexus/backups/sync", Rails.root)
+    end
+
+    connection do |conn|
+      conn.host = ENV["BACKUP_RSYNC_HOST"] || "backup.example.com"
+      conn.port = ENV["BACKUP_RSYNC_PORT"] || 22
+      conn.username = ENV["BACKUP_RSYNC_USER"] || "backup"
+      conn.ssh_options = {
+        keys: ENV["BACKUP_SSH_KEY"] || File.expand_path("~/.ssh/id_rsa"),
+        timeout: 30
+      }
+    end
+  end
+end

data/lib/generators/rails_nexus/templates/backup/mysql-config/db_config.cnf

@@ -0,0 +1,15 @@
+# RailsNexus Backup MySQL Configuration
+# Generated by: rails generate rails_nexus:backup
+#
+# This file is used by the backup gem for database authentication.
+# Keep this file secure and do not commit to version control.
+
+[client]
+user=<%= ENV['DATABASE_USER'] || 'root' %>
+password=<%= ENV['DATABASE_PASSWORD'] || '' %>
+host=<%= ENV['DATABASE_HOST'] || 'localhost' %>
+port=<%= (ENV['DATABASE_PORT'] || 3306).to_i %>
+database=<%= ENV['DATABASE_NAME'] || 'myapp_production' %>
+
+# Dump options
+default-character-set=utf8mb4

data/lib/generators/rails_nexus/templates/backup/schedule.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+# RailsNexus Backup Schedule
+# Generated by: rails generate rails_nexus:backup
+#
+# This file is parsed by the BackupService to show schedule info in the UI.
+# Actual cron should be installed separately: whenever --write-crontab
+
+# ─── Backup Schedule ──────────────────────────────────────────────
+
+# Full backup daily at 2:00 AM (all tables, local only)
+every 1.day, at: "2:00 am" do
+  command "cd #{File.expand_path('../..', __FILE__)} && bundle exec backup perform -t full_backup --triggered_by system"
+end
+
+# Incremental backup every 4 hours (skipping large tables)
+every 4.hours do
+  command "cd #{File.expand_path('../..', __FILE__)} && bundle exec backup perform -t incremental_backup --triggered_by system"
+end
+
+# Remote sync weekly on Sunday at 3:00 AM
+every 1.week, at: "3:00 am" do
+  command "cd #{File.expand_path('../..', __FILE__)} && bundle exec backup perform -t sync_backup --triggered_by system"
+end
+
+# Cleanup old backups monthly
+every 1.month, at: "4:00 am" do
+  command "cd #{File.expand_path('../..', __FILE__)} && bundle exec backup perform -t full_backup --cleanup"
+end

data/lib/generators/rails_nexus/templates/javascript/controllers/rails_nexus_controller.js

@@ -0,0 +1,310 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = ["activity", "shortcutsDialog", "tabs", "tabContent", "exceptionList", "backtraceHidden", "backtraceContent"]
+  static values = { shortcuts: Boolean }
+
+  connect() {
+    this.selectedIndex = -1
+    this.rows = []
+
+    this.showActivity = this.showActivity.bind(this)
+    this.hideActivity = this.hideActivity.bind(this)
+
+    document.addEventListener("turbo:before-fetch-request", this.showActivity)
+    document.addEventListener("turbo:before-fetch-response", this.hideActivity)
+    document.addEventListener("turbo:submit-end", this.hideActivity)
+
+    if (this.shortcutsValue) {
+      this.boundKeydown = this.handleKeydown.bind(this)
+      document.addEventListener("keydown", this.boundKeydown)
+    }
+  }
+
+  disconnect() {
+    document.removeEventListener("turbo:before-fetch-request", this.showActivity)
+    document.removeEventListener("turbo:before-fetch-response", this.hideActivity)
+    document.removeEventListener("turbo:submit-end", this.hideActivity)
+
+    if (this.boundKeydown) {
+      document.removeEventListener("keydown", this.boundKeydown)
+    }
+  }
+
+  handleKeydown(event) {
+    const tag = event.target.tagName.toLowerCase()
+    if (tag === "input" || tag === "textarea" || tag === "select") {
+      if (event.key === "Escape") {
+        event.target.blur()
+        event.preventDefault()
+      }
+      return
+    }
+
+    switch (event.key) {
+      case "/":
+        event.preventDefault()
+        this.focusSearch()
+        break
+      case "j":
+      case "ArrowDown":
+        event.preventDefault()
+        this.navigateDown()
+        break
+      case "k":
+      case "ArrowUp":
+        event.preventDefault()
+        this.navigateUp()
+        break
+      case "Enter":
+        event.preventDefault()
+        this.openSelected()
+        break
+      case "p":
+      case "ArrowLeft":
+        event.preventDefault()
+        this.navigateToPrev()
+        break
+      case "n":
+      case "ArrowRight":
+        event.preventDefault()
+        this.navigateToNext()
+        break
+      case "t":
+        event.preventDefault()
+        this.toggleTheme()
+        break
+      case "Escape":
+        event.preventDefault()
+        this.closeDetails(event)
+        this.closeShortcuts()
+        break
+      case "?":
+        event.preventDefault()
+        this.toggleShortcuts()
+        break
+      case "1": case "2": case "3": case "4": case "5":
+        event.preventDefault()
+        this.switchTabByIndex(parseInt(event.key) - 1)
+        break
+    }
+  }
+
+  focusSearch() {
+    const search = this.element.querySelector(".rn-search .rn-input, input[type='search']")
+    if (search) {
+      search.focus()
+      search.select()
+    }
+  }
+
+  refreshRows() {
+    if (this.hasExceptionListTarget) {
+      this.rows = Array.from(this.exceptionListTarget.querySelectorAll("tr[data-url]"))
+    } else {
+      this.rows = Array.from(this.element.querySelectorAll("tr[data-url]"))
+    }
+  }
+
+  navigateDown() {
+    this.refreshRows()
+    if (this.rows.length === 0) return
+    this.selectedIndex = Math.min(this.selectedIndex + 1, this.rows.length - 1)
+    this.highlightRow()
+  }
+
+  navigateUp() {
+    this.refreshRows()
+    if (this.rows.length === 0) return
+    this.selectedIndex = Math.max(this.selectedIndex - 1, 0)
+    this.highlightRow()
+  }
+
+  highlightRow() {
+    this.rows.forEach((row, i) => {
+      row.classList.toggle("selected", i === this.selectedIndex)
+    })
+    const row = this.rows[this.selectedIndex]
+    if (row) row.scrollIntoView({ block: "nearest", behavior: "smooth" })
+  }
+
+  openSelected() {
+    this.refreshRows()
+    if (this.selectedIndex < 0 || this.selectedIndex >= this.rows.length) return
+    const row = this.rows[this.selectedIndex]
+    if (row.dataset.url) {
+      this.selectRow({ currentTarget: row, preventDefault: () => {} })
+    }
+  }
+
+  selectRow(event) {
+    event.preventDefault()
+    const row = event.currentTarget
+    const url = row.dataset.url
+    if (!url) return
+
+    this.refreshRows()
+    this.rows.forEach(r => r.classList.remove("selected"))
+    row.classList.add("selected")
+
+    const detailPanel = document.getElementById("exception-detail-desktop")
+    if (detailPanel) {
+      detailPanel.hidden = false
+      detailPanel.classList.remove("hidden")
+    }
+
+    const frame = document.getElementById("exception-details")
+    if (frame) {
+      frame.innerHTML = ""
+      frame.src = url
+    }
+  }
+
+  stopPropagation(event) {
+    event.stopPropagation()
+  }
+
+  closeDetails(event) {
+    event.preventDefault()
+    this.refreshRows()
+    this.rows.forEach(r => r.classList.remove("selected"))
+    this.selectedIndex = -1
+
+    const detailPanel = document.getElementById("exception-detail-desktop")
+    if (detailPanel) {
+      detailPanel.hidden = true
+      detailPanel.classList.add("hidden")
+    }
+
+    const frame = document.getElementById("exception-details")
+    if (frame) {
+      frame.innerHTML = `
+        <div class="text-center py-12">
+          <div class="w-10 h-10 rounded-full flex items-center justify-center mx-auto" style="background: var(--rn-bg-secondary)">
+            <svg class="w-5 h-5" style="color: var(--rn-text-muted)" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">
+              <path stroke-linecap="round" stroke-linejoin="round" d="M19.5 14.25v-2.625a3.375 3.375 0 00-3.375-3.375h-1.5A1.125 1.125 0 0113.5 7.125v-1.5a3.375 3.375 0 00-3.375-3.375H8.25m0 12.75h7.5m-7.5 3H12M10.5 2.25H5.625c-.621 0-1.125.504-1.125 1.125v17.25c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 00-9-9z" />
+            </svg>
+          </div>
+          <p class="mt-2 text-xs" style="color: var(--rn-text-muted)">Select an exception to view details</p>
+          <p class="mt-1 text-xs" style="color: var(--rn-text-muted)">Click a row or press <span class="rn-kbd">↓</span> <span class="rn-kbd">↑</span> to navigate</p>
+        </div>
+      `
+    }
+  }
+
+  switchTab(event) {
+    const tabName = event.currentTarget.dataset.flTabParam || event.currentTarget.dataset.flTab
+    this.activateTab(tabName)
+  }
+
+  switchTabByIndex(index) {
+    if (!this.hasTabsTarget) return
+    const tabs = this.tabsTarget.querySelectorAll(".rn-tab")
+    if (index >= 0 && index < tabs.length) {
+      const tabName = tabs[index].dataset.flTabParam || tabs[index].dataset.flTab
+      this.activateTab(tabName)
+    }
+  }
+
+  activateTab(tabName) {
+    if (this.hasTabsTarget) {
+      this.tabsTarget.querySelectorAll(".rn-tab").forEach(tab => {
+        const isActive = (tab.dataset.flTabParam || tab.dataset.flTab) === tabName
+        tab.classList.toggle("active", isActive)
+      })
+    }
+    this.tabContentTargets.forEach(content => {
+      const isTarget = content.dataset.flTabContent === tabName
+      content.style.display = isTarget ? "" : "none"
+    })
+  }
+
+  toggleTheme() {
+    const themeController = this.application.getControllerForElementAndIdentifier(
+      document.documentElement, "rails_nexus-theme"
+    )
+    if (themeController) {
+      themeController.toggle()
+    } else {
+      const root = document.documentElement
+      const isDark = root.classList.contains("dark")
+      root.classList.remove("dark", "light")
+      root.classList.add(isDark ? "light" : "dark")
+      localStorage.setItem("rails_nexus-theme", isDark ? "light" : "dark")
+    }
+  }
+
+  toggleShortcuts() {
+    if (!this.hasShortcutsDialogTarget) return
+    const isOpen = this.shortcutsDialogTarget.classList.contains("open")
+    if (isOpen) { this.closeShortcuts() } else { this.shortcutsDialogTarget.classList.add("open") }
+  }
+
+  closeShortcuts() {
+    if (this.hasShortcutsDialogTarget) this.shortcutsDialogTarget.classList.remove("open")
+  }
+
+  navigateToPrev() {
+    const prevLink = document.querySelector(".rn-nav-link[href*='logged_exceptions']")
+    if (prevLink && prevLink.querySelector(".rn-nav-link-label")?.textContent === "Previous") prevLink.click()
+  }
+
+  navigateToNext() {
+    const links = document.querySelectorAll(".rn-nav-link[href*='logged_exceptions']")
+    const nextLink = Array.from(links).find(l => l.querySelector(".rn-nav-link-label")?.textContent === "Next")
+    if (nextLink) nextLink.click()
+  }
+
+  copyId(event) {
+    const id = event.currentTarget.dataset.rails_nexusIdValue
+    if (id) this.copyToClipboard(id, event.currentTarget)
+  }
+
+  copyMessage(event) {
+    const msg = event.currentTarget.dataset.rails_nexusMessageValue
+    if (msg) this.copyToClipboard(msg, event.currentTarget)
+  }
+
+  copyBacktrace(event) {
+    const bt = event.currentTarget.dataset.rails_nexusBacktraceValue
+    if (bt) this.copyToClipboard(bt, event.currentTarget)
+  }
+
+  async copyToClipboard(text, button) {
+    try {
+      await navigator.clipboard.writeText(text)
+    } catch {
+      const ta = document.createElement("textarea")
+      ta.value = text; ta.style.position = "fixed"; ta.style.opacity = "0"
+      document.body.appendChild(ta); ta.select(); document.execCommand("copy"); document.body.removeChild(ta)
+    }
+    const orig = button.innerHTML
+    button.classList.add("copied")
+    button.innerHTML = `<svg class="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5" /></svg> Copied!`
+    setTimeout(() => { button.classList.remove("copied"); button.innerHTML = orig }, 2000)
+  }
+
+  expandBacktrace(event) {
+    event.preventDefault()
+    const hidden = this.backtraceHiddenTarget
+    if (hidden) {
+      hidden.style.display = hidden.style.display === "none" ? "" : "none"
+      event.currentTarget.textContent = hidden.style.display === "none"
+        ? `Show more frames` : "Hide additional frames"
+    }
+  }
+
+  submit() {
+    this.showActivity()
+    const form = this.element.querySelector("form[data-turbo-frame]")
+    if (form) form.requestSubmit()
+  }
+
+  debouncedSubmit() {
+    clearTimeout(this._debounceTimer)
+    this._debounceTimer = setTimeout(() => this.submit(), 400)
+  }
+
+  showActivity() { this.activityTarget?.classList.remove("hidden") }
+  hideActivity() { this.activityTarget?.classList.add("hidden") }
+}

data/lib/generators/rails_nexus/templates/javascript/controllers/rails_nexus_detail_controller.js

@@ -0,0 +1,98 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = ["tabs", "tabContent", "backtraceContent", "backtraceHidden"]
+
+  // ─── Tab Switching ────────────────────────────────────────
+
+  switchTab(event) {
+    const tabName = event.params.tab || event.currentTarget.getAttribute("data-rn-tab-param")
+    if (!tabName) return
+
+    // Update tab buttons
+    this.tabsTarget.querySelectorAll(".rn-tab").forEach(tab => {
+      const isActive = tab.getAttribute("data-rn-tab-param") === tabName
+      tab.classList.toggle("active", isActive)
+    })
+
+    // Show/hide tab content
+    this.tabContentTargets.forEach(content => {
+      const isTarget = content.getAttribute("data-rn-tab-content") === tabName
+      content.style.display = isTarget ? "" : "none"
+    })
+  }
+
+  // ─── Copy to Clipboard ───────────────────────────────────
+
+  copyId(event) {
+    const id = event.currentTarget.getAttribute("data-rails_nexus-detail-id-value") ||
+               event.currentTarget.dataset.rails_nexusDetailIdValue
+    if (id) this.copyToClipboard(id, event.currentTarget)
+  }
+
+  copyMessage(event) {
+    const msg = event.currentTarget.getAttribute("data-rails_nexus-detail-message-value") ||
+                event.currentTarget.dataset.rails_nexusDetailMessageValue
+    if (msg) this.copyToClipboard(msg, event.currentTarget)
+  }
+
+  copyBacktrace(event) {
+    const bt = event.currentTarget.getAttribute("data-rails_nexus-detail-backtrace-value") ||
+               event.currentTarget.dataset.rails_nexusDetailBacktraceValue
+    if (bt) this.copyToClipboard(bt, event.currentTarget)
+  }
+
+  async copyToClipboard(text, button) {
+    try {
+      await navigator.clipboard.writeText(text)
+    } catch {
+      const textarea = document.createElement("textarea")
+      textarea.value = text
+      textarea.style.position = "fixed"
+      textarea.style.opacity = "0"
+      document.body.appendChild(textarea)
+      textarea.select()
+      document.execCommand("copy")
+      document.body.removeChild(textarea)
+    }
+    const orig = button.innerHTML
+    button.classList.add("copied")
+    button.innerHTML = `<svg class="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5" /></svg> Copied!`
+    setTimeout(() => { button.classList.remove("copied"); button.innerHTML = orig }, 2000)
+  }
+
+  // ─── Backtrace Expand ────────────────────────────────────
+
+  expandBacktrace(event) {
+    event.preventDefault()
+    const hidden = this.backtraceHiddenTarget
+    if (hidden) {
+      hidden.style.display = hidden.style.display === "none" ? "" : "none"
+      event.currentTarget.textContent = hidden.style.display === "none"
+        ? "Show more frames"
+        : "Hide additional frames"
+    }
+  }
+
+  // ─── Close Details ───────────────────────────────────────
+
+  closeDetails() {
+    const frame = document.getElementById("exception-details")
+    if (frame) {
+      frame.innerHTML = `
+        <div class="text-center py-12">
+          <div class="w-10 h-10 rounded-full flex items-center justify-center mx-auto" style="background: var(--rn-bg-secondary)">
+            <svg class="w-5 h-5" style="color: var(--rn-text-muted)" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">
+              <path stroke-linecap="round" stroke-linejoin="round" d="M19.5 14.25v-2.625a3.375 3.375 0 00-3.375-3.375h-1.5A1.125 1.125 0 0113.5 7.125v-1.5a3.375 3.375 0 00-3.375-3.375H8.25m0 12.75h7.5m-7.5 3H12M10.5 2.25H5.625c-.621 0-1.125.504-1.125 1.125v17.25c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 00-9-9z" />
+            </svg>
+          </div>
+          <p class="mt-2 text-xs" style="color: var(--rn-text-muted)">Select an exception to view details</p>
+          <p class="mt-1 text-xs" style="color: var(--rn-text-muted)">Click a row or press <span class="rn-kbd">↓</span> <span class="rn-kbd">↑</span> to navigate</p>
+        </div>
+      `
+    }
+
+    // Deselect rows
+    document.querySelectorAll(".rn-table tbody tr.selected").forEach(r => r.classList.remove("selected"))
+  }
+}

data/lib/generators/rails_nexus/templates/javascript/controllers/rails_nexus_sidebar_controller.js

@@ -0,0 +1,15 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = ["drawer", "overlay"]
+
+  toggle() {
+    this.drawerTarget.classList.toggle("open")
+    this.overlayTarget.classList.toggle("open")
+  }
+
+  close() {
+    this.drawerTarget.classList.remove("open")
+    this.overlayTarget.classList.remove("open")
+  }
+}

data/lib/generators/rails_nexus/templates/javascript/controllers/rails_nexus_theme_controller.js

@@ -0,0 +1,30 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static values = { theme: String }
+
+  connect() {
+    const saved = localStorage.getItem("rails_nexus-theme")
+    if (saved) {
+      this.applyTheme(saved)
+    } else if (this.themeValue && this.themeValue !== "auto") {
+      this.applyTheme(this.themeValue)
+    } else {
+      const prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches
+      this.applyTheme(prefersDark ? "dark" : "light")
+    }
+  }
+
+  toggle() {
+    const root = document.documentElement
+    const isDark = root.classList.contains("dark")
+    this.applyTheme(isDark ? "light" : "dark")
+  }
+
+  applyTheme(theme) {
+    const root = document.documentElement
+    root.classList.remove("dark", "light")
+    root.classList.add(theme)
+    localStorage.setItem("rails_nexus-theme", theme)
+  }
+}

data/lib/generators/rails_nexus/templates/migration.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+class CreateRailsNexusLoggedExceptions < ActiveRecord::Migration<%= "[#{ActiveRecord::Migration.current_version}]" %>
+  def change
+    create_table :rails_nexus_exceptions do |t|
+      t.string :exception_class
+      t.string :controller_name
+      t.string :action_name
+      t.text   :message
+      t.text   :backtrace
+      t.text   :environment
+      t.text   :request
+      t.string :user_info
+      t.string :user_agent
+      t.string :remote_ip
+
+      t.timestamps
+    end
+
+    add_index :rails_nexus_exceptions, :created_at
+    add_index :rails_nexus_exceptions, :exception_class
+    add_index :rails_nexus_exceptions, [:controller_name, :action_name]
+  end
+end

data/lib/generators/rails_nexus/templates/migration_advanced_features.rb

@@ -0,0 +1,30 @@
+class AddAdvancedFeaturesToRailsNexusLoggedExceptions < ActiveRecord::Migration[8.0]
+  def change
+    # Exception cause chain
+    add_column :rails_nexus_exceptions, :cause_chain, :text
+
+    # Breadcrumbs (activity trail before crash)
+    add_column :rails_nexus_exceptions, :breadcrumbs, :text
+
+    # System health snapshot at crash time
+    add_column :rails_nexus_exceptions, :system_health, :text
+
+    # User impact tracking
+    add_column :rails_nexus_exceptions, :user_id, :string
+    add_column :rails_nexus_exceptions, :user_type, :string
+
+    # Storm protection: occurrence count (deduplication)
+    add_column :rails_nexus_exceptions, :occurrence_count, :integer, default: 1
+
+    # Custom fingerprint for grouping
+    add_column :rails_nexus_exceptions, :fingerprint, :string
+
+    # Local/instance variables captured at raise time
+    add_column :rails_nexus_exceptions, :local_variables, :text
+    add_column :rails_nexus_exceptions, :instance_variables, :text
+
+    add_index :rails_nexus_exceptions, :user_id
+    add_index :rails_nexus_exceptions, :fingerprint
+    add_index :rails_nexus_exceptions, :occurrence_count
+  end
+end

data/lib/generators/rails_nexus/templates/migration_cron_jobs.rb

@@ -0,0 +1,22 @@
+class CreateRailsNexusCronJobs < ActiveRecord::Migration[8.0]
+  def change
+    create_table :rails_nexus_cron_jobs do |t|
+      t.string :name, null: false
+      t.string :status, null: false, default: "pending"
+      t.text :output
+      t.text :error_message
+      t.float :duration
+      t.string :hostname
+      t.json :metadata
+      t.datetime :started_at
+      t.datetime :finished_at
+
+      t.timestamps
+    end
+
+    add_index :rails_nexus_cron_jobs, :name
+    add_index :rails_nexus_cron_jobs, :status
+    add_index :rails_nexus_cron_jobs, :created_at
+    add_index :rails_nexus_cron_jobs, :started_at
+  end
+end