maintenance_on_steroids 0.2.0

data/app/views/maintenance_on_steroids/dashboard/index.html.erb

@@ -0,0 +1,163 @@
+<div class="page-header">
+  <div>
+    <h1>Dashboard</h1>
+    <p class="subtitle">Maintenance tasks overview</p>
+  </div>
+</div>
+
+<%# Stats Cards %>
+<div class="stats-grid" id="dashboard-stats">
+  <div class="stat-card">
+    <div class="stat-number"><%= @stats[:total_tasks] %></div>
+    <div class="stat-label">Available Tasks</div>
+  </div>
+  <div class="stat-card stat-card-active">
+    <div class="stat-number"><%= @stats[:active_runs] %></div>
+    <div class="stat-label">Active Runs</div>
+  </div>
+  <div class="stat-card stat-card-completed">
+    <div class="stat-number"><%= @stats[:completed] %></div>
+    <div class="stat-label">Completed</div>
+  </div>
+  <div class="stat-card stat-card-errored">
+    <div class="stat-number"><%= @stats[:errored] %></div>
+    <div class="stat-label">Errored</div>
+  </div>
+</div>
+
+<%# Currently Active Runs %>
+<div class="dashboard-section">
+  <h2>Active Runs</h2>
+  <div class="card" style="padding: 0; overflow: hidden;" id="active-runs-section">
+    <% if @active_runs.any? %>
+      <%# Sentinel for _auto_refresh's stop_when_gone: once no run is active
+          there is nothing left to poll for, so the poller shuts itself down
+          instead of re-rendering the dashboard every 4s indefinitely. %>
+      <span id="has-active-runs" hidden></span>
+      <table>
+        <thead>
+          <tr>
+            <th>ID</th>
+            <th>Task</th>
+            <th>Status</th>
+            <th>Progress</th>
+            <th>Duration</th>
+            <th>User</th>
+            <th></th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @active_runs.each do |run| %>
+            <tr>
+              <td><a href="<%= run_path(run) %>">#<%= run.id %></a></td>
+              <td>
+                <% if run.task_exists? %>
+                  <a href="<%= job_path(id: run.task_class) %>" class="cell-truncate" title="<%= run.task_title %>"><%= run.task_title %></a>
+                <% else %>
+                  <span class="cell-truncate" style="color: var(--text-muted);" title="<%= run.task_class %> (task class no longer exists)"><%= run.task_class %></span>
+                <% end %>
+              </td>
+              <td>
+                <span class="badge badge-<%= run.status %>"><%= run.status %></span>
+                <% if (artifact_count = @artifact_counts.fetch(run.id, 0)) > 0 %>
+                  <span class="badge" title="<%= pluralize(artifact_count, "artifact") %>">&#128206; <%= artifact_count %></span>
+                <% end %>
+              </td>
+              <td>
+                <% if run.progress_total > 0 %>
+                  <div class="progress-container" style="height: 10px; width: 100px; display: inline-block; vertical-align: middle;">
+                    <div class="progress-bar" style="width: <%= run.progress_percentage %>%; height: 100%;"></div>
+                  </div>
+                  <span style="font-size: 12px; color: var(--text-muted); margin-left: 6px;"><%= run.progress_percentage %>%</span>
+                <% else %>
+                  <span style="color: var(--text-muted);">&mdash;</span>
+                <% end %>
+              </td>
+              <td><%= run.formatted_duration %></td>
+              <td>
+                <% if run.user_id.present? %>
+                  <span class="cell-truncate-sm" title="<%= run.user_display %>"><%= run.user_display %></span>
+                <% else %>
+                  &mdash;
+                <% end %>
+              </td>
+              <td><a href="<%= run_path(run) %>" class="btn btn-outline btn-sm">View</a></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    <% else %>
+      <div class="empty-state" style="padding: 32px;">
+        <p>No active runs</p>
+      </div>
+    <% end %>
+  </div>
+</div>
+
+<%# Recent History %>
+<div class="dashboard-section">
+  <h2>Recent History</h2>
+  <div class="card" style="padding: 0; overflow: hidden;">
+    <% if @recent_runs.any? %>
+      <table>
+        <thead>
+          <tr>
+            <th>ID</th>
+            <th>Task</th>
+            <th>Status</th>
+            <th>Progress</th>
+            <th>Duration</th>
+            <th>User</th>
+            <th>Created</th>
+            <th></th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @recent_runs.each do |run| %>
+            <tr>
+              <td><a href="<%= run_path(run) %>">#<%= run.id %></a></td>
+              <td>
+                <% if run.task_exists? %>
+                  <a href="<%= job_path(id: run.task_class) %>" class="cell-truncate" title="<%= run.task_title %>"><%= run.task_title %></a>
+                <% else %>
+                  <span class="cell-truncate" style="color: var(--text-muted);" title="<%= run.task_class %> (task class no longer exists)"><%= run.task_class %></span>
+                <% end %>
+              </td>
+              <td>
+                <span class="badge badge-<%= run.status %>"><%= run.status %></span>
+                <% if (artifact_count = @artifact_counts.fetch(run.id, 0)) > 0 %>
+                  <span class="badge" title="<%= pluralize(artifact_count, "artifact") %>">&#128206; <%= artifact_count %></span>
+                <% end %>
+              </td>
+              <td>
+                <% if run.progress_total > 0 %>
+                  <%= run.progress_current %> / <%= run.progress_total %>
+                <% else %>
+                  <span style="color: var(--text-muted);">&mdash;</span>
+                <% end %>
+              </td>
+              <td><%= run.formatted_duration %></td>
+              <td>
+                <% if run.user_id.present? %>
+                  <span class="cell-truncate-sm" title="<%= run.user_display %>"><%= run.user_display %></span>
+                <% else %>
+                  &mdash;
+                <% end %>
+              </td>
+              <td style="white-space: nowrap;"><%= run.created_at.strftime("%b %d, %Y %H:%M") %></td>
+              <td><a href="<%= run_path(run) %>" class="btn btn-outline btn-sm">View</a></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    <% else %>
+      <div class="empty-state" style="padding: 32px;">
+        <p>No runs yet</p>
+      </div>
+    <% end %>
+  </div>
+</div>
+
+<%= render "maintenance_on_steroids/shared/auto_refresh",
+           target_ids: ["dashboard-stats", "active-runs-section"],
+           stop_when_gone: "has-active-runs" %>

data/app/views/maintenance_on_steroids/jobs/index.html.erb

@@ -0,0 +1,35 @@
+<div class="page-header">
+  <div>
+    <h1>Maintenance Tasks</h1>
+    <p class="subtitle">Available tasks in your application</p>
+  </div>
+  <div class="sort-toggle">
+    <span class="sort-label">Sort:</span>
+    <a href="<%= jobs_path %>" class="<%= "active" if @sort == "name" %>">Name</a>
+    <a href="<%= jobs_path(sort: "last_run") %>" class="<%= "active" if @sort == "last_run" %>">Last run</a>
+  </div>
+</div>
+
+<% any_active = @active_run_counts.values.sum.positive? %>
+<div class="card" style="padding: 0; overflow: hidden;" id="jobs-list">
+  <%# Sentinel: present only while a task is active. The poller swaps #jobs-list
+      and stops once a refresh no longer contains this marker. %>
+  <% if any_active %><span id="mos-active-sentinel" hidden></span><% end %>
+  <% if @task_classes.any? %>
+    <% @task_classes.each do |task_class| %>
+      <%= render "maintenance_on_steroids/shared/task_list_item", task_class: task_class, active_count: @active_run_counts.fetch(task_class.name, 0), last_run: @last_runs[task_class.name] %>
+    <% end %>
+  <% else %>
+    <div class="empty-state">
+      <h3>No tasks found</h3>
+      <p>Create task classes in <code>app/maintenance/</code> that inherit from <code>MaintenanceOnSteroids::Task</code></p>
+    </div>
+  <% end %>
+</div>
+
+<%# Live-refresh the task list while any task is in progress (active badges and
+    last-run ages update without a full reload), mirroring the dashboard. %>
+<% if any_active %>
+  <%= render "maintenance_on_steroids/shared/auto_refresh",
+             target_ids: ["jobs-list"], stop_when_gone: "mos-active-sentinel" %>
+<% end %>

data/app/views/maintenance_on_steroids/jobs/show.html.erb

@@ -0,0 +1,107 @@
+<div class="breadcrumb">
+  <a href="<%= jobs_path %>">Tasks</a> &rsaquo; <%= @task_class.task_title %>
+</div>
+
+<div class="page-header">
+  <div>
+    <h1><%= @task_class.task_title %></h1>
+    <% if @task_class.task_description %>
+      <p class="subtitle"><%= @task_class.task_description %></p>
+    <% end %>
+  </div>
+  <div class="btn-group">
+    <a href="<%= source_job_path(id: @task_class.name) %>" class="btn btn-outline btn-sm">Source</a>
+    <a href="<%= new_job_run_path(job_id: @task_class.name) %>" class="btn btn-primary btn-sm">New Run</a>
+  </div>
+</div>
+
+<div class="card" style="margin-bottom: 20px;">
+  <div class="info-grid">
+    <div class="info-item">
+      <label>Class</label>
+      <div class="value"><%= @task_class.name %></div>
+    </div>
+    <% if @task_class.task_owner %>
+      <div class="info-item">
+        <label>Owner</label>
+        <div class="value"><%= @task_class.task_owner %></div>
+      </div>
+    <% end %>
+    <% if @task_class.job_config.queue_name %>
+      <div class="info-item">
+        <label>Queue</label>
+        <div class="value"><%= @task_class.job_config.queue_name %></div>
+      </div>
+    <% end %>
+    <% if @task_class.form_inputs.any? %>
+      <div class="info-item">
+        <label>Inputs</label>
+        <div class="value"><%= @task_class.form_inputs.map { |i| "#{i.name} (#{i.type})" }.join(", ") %></div>
+      </div>
+    <% end %>
+    <% if @task_class.artifact_definitions.any? %>
+      <div class="info-item">
+        <label>Artifacts</label>
+        <div class="value"><%= @task_class.artifact_definitions.map { |a| "#{a.name} (#{a.type})" }.join(", ") %></div>
+      </div>
+    <% end %>
+  </div>
+</div>
+
+<h2>Runs</h2>
+<div class="card" style="padding: 0; overflow: hidden; margin-top: 8px;">
+  <% if @runs.any? %>
+    <table>
+      <thead>
+        <tr>
+          <th>ID</th>
+          <th>Status</th>
+          <th>Progress</th>
+          <th>Duration</th>
+          <th>User</th>
+          <th>Created</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @runs.each do |run| %>
+          <tr>
+            <td><a href="<%= run_path(run) %>">#<%= run.id %></a></td>
+            <td>
+              <span class="badge badge-<%= run.status %>"><%= run.status %></span>
+              <% if (artifact_count = @artifact_counts.fetch(run.id, 0)) > 0 %>
+                <span class="badge" title="<%= pluralize(artifact_count, "artifact") %>">&#128206; <%= artifact_count %></span>
+              <% end %>
+            </td>
+            <td>
+              <% if run.progress_total > 0 %>
+                <%= run.progress_current %> / <%= run.progress_total %> (<%= run.progress_percentage %>%)
+              <% else %>
+                —
+              <% end %>
+            </td>
+            <td><%= run.formatted_duration %></td>
+            <td>
+              <% if run.user_id.present? %>
+                <span class="cell-truncate-sm" title="<%= run.user_display %>"><%= run.user_display %></span>
+              <% else %>
+                —
+              <% end %>
+            </td>
+            <td style="white-space: nowrap;"><%= run.created_at.strftime("%b %d, %Y %H:%M") %></td>
+            <td><a href="<%= run_path(run) %>" class="btn btn-outline btn-sm">View</a></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% else %>
+    <div class="empty-state">
+      <h3>No runs yet</h3>
+      <p>Click "New Run" to start this task.</p>
+    </div>
+  <% end %>
+</div>
+
+<%= render "maintenance_on_steroids/shared/pager",
+           page: @page, total_pages: @total_pages, total: @total_runs,
+           url_proc: ->(n) { job_path(id: @task_class.name, page: n) } %>

data/app/views/maintenance_on_steroids/jobs/source.html.erb

@@ -0,0 +1,79 @@
+<div class="breadcrumb">
+  <a href="<%= jobs_path %>">Tasks</a> &rsaquo;
+  <a href="<%= job_path(id: @task_class.name) %>"><%= @task_class.task_title %></a> &rsaquo;
+  Source
+</div>
+
+<div class="page-header">
+  <div>
+    <h1>Source: <%= @task_class.task_title %></h1>
+    <p class="subtitle"><%= @task_class.name %></p>
+  </div>
+  <a href="<%= job_path(id: @task_class.name) %>" class="btn btn-outline btn-sm">Back</a>
+</div>
+
+<% if @source_code %>
+  <div class="source-code-container">
+    <div class="source-code-header">
+      <span><%= @source_file %></span>
+    </div>
+    <div class="source-code-body">
+      <pre><% @source_code.lines.each_with_index do |line, idx| %><div class="source-line"><span class="source-line-number"><%= idx + 1 %></span><span class="source-line-content"><%= ERB::Util.html_escape(line.chomp) %></span></div><% end %></pre>
+    </div>
+  </div>
+
+  <%# Optional Ruby syntax highlighting via highlight.js (CDN). If the CDN is
+      unreachable, hljs is undefined and the plain line view above is left as-is. %>
+  <link id="hljs-theme" rel="stylesheet" crossorigin="anonymous">
+  <%# highlight.js version lives in one place; the script src, the stylesheet
+      URL (built in JS below) and the SRI hash all derive from it. When bumping
+      `hljs_version`, recompute `hljs_integrity` for the new highlight.min.js:
+        curl -fsSL <src-url> | openssl dgst -sha384 -binary | openssl base64 -A
+      Do the same for each theme stylesheet in `hljs_theme_integrity` below. %>
+  <% hljs_version   = "11.9.0" %>
+  <% hljs_integrity = "sha384-F/bZzf7p3Joyp5psL90p/p89AZJsndkSoGwRpXcZhleCWhd8SnRuoYo4d0yirjJp" %>
+  <%# Theme stylesheets are pinned too: this is a privileged admin surface, and
+      unpinned CSS from a compromised CDN can exfiltrate page content via
+      attribute selectors or overlay the pause/cancel controls. Recompute both
+      alongside `hljs_integrity` when bumping `hljs_version`. %>
+  <% hljs_theme_integrity = {
+       "github-dark" => "sha384-wH75j6z1lH97ZOpMOInqhgKzFkAInZPPSPlZpYKYTOqsaizPvhQZmAtLcPKXpLyH",
+       "github"      => "sha384-eFTL69TLRZTkNfYZOLM+G04821K1qZao/4QLJbet1pP4tcF+fdXq/9CdqAbWRl/L"
+     } %>
+  <%# Subresource Integrity pins the exact bytes of this build: a compromised or
+      MITM'd CDN serving anything else is refused by the browser (admin surface). %>
+  <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@<%= hljs_version %>/build/highlight.min.js"
+          integrity="<%= hljs_integrity %>"
+          crossorigin="anonymous"></script>
+  <script>
+  (function() {
+    if (typeof hljs === "undefined") { return; }
+    var dark = document.documentElement.getAttribute("data-theme") !== "light";
+    var theme = dark ? "github-dark" : "github";
+    var themeIntegrity = JSON.parse('<%= j hljs_theme_integrity.to_json %>');
+    var link = document.getElementById("hljs-theme");
+    // integrity must be set before href, or the browser starts the fetch
+    // unpinned and the hash is never enforced.
+    link.setAttribute("integrity", themeIntegrity[theme]);
+    link.href =
+      "https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@<%= hljs_version %>/build/styles/" + theme + ".min.css";
+    document.querySelectorAll(".source-code-body .source-line-content").forEach(function(el) {
+      // Skip already-highlighted lines so a Turbo cache re-exec doesn't
+      // re-highlight token-tagged HTML.
+      if (el.dataset.hljsDone) { return; }
+      // textContent is the raw (unescaped) line; hljs returns escaped, token-tagged HTML.
+      try {
+        el.innerHTML = hljs.highlight(el.textContent, { language: "ruby" }).value;
+        el.dataset.hljsDone = "1";
+      } catch (e) { /* leave plain */ }
+    });
+  })();
+  </script>
+<% else %>
+  <div class="card">
+    <div class="empty-state">
+      <h3>Source unavailable</h3>
+      <p>Could not locate the source file for this task class.</p>
+    </div>
+  </div>
+<% end %>

data/app/views/maintenance_on_steroids/runs/new.html.erb

@@ -0,0 +1,98 @@
+<div class="breadcrumb">
+  <a href="<%= jobs_path %>">Tasks</a> &rsaquo;
+  <a href="<%= job_path(id: @task_class.name) %>"><%= @task_class.task_title %></a> &rsaquo;
+  New Run
+</div>
+
+<div class="page-header">
+  <div>
+    <h1>New Run: <%= @task_class.task_title %></h1>
+    <p class="subtitle">Configure parameters and start the task.</p>
+  </div>
+</div>
+
+<div class="card">
+  <%= form_with url: job_runs_path(job_id: @task_class.name), method: :post, multipart: true do %>
+    <% if @task_class.form_inputs.any? %>
+      <% @task_class.form_inputs.each do |input| %>
+        <div class="form-group">
+          <label for="task_params_<%= input.name %>">
+            <%= input.label %>
+            <% if input.required %>
+              <span class="required-mark">*</span>
+            <% end %>
+          </label>
+
+          <% case input.html_input_type %>
+          <% when "textarea" %>
+            <textarea
+              name="task_params[<%= input.name %>]"
+              id="task_params_<%= input.name %>"
+              placeholder="<%= input.placeholder %>"
+              <%= "required" if input.required %>
+            ><%= input.default %></textarea>
+
+          <% when "select" %>
+            <select
+              name="task_params[<%= input.name %>]"
+              id="task_params_<%= input.name %>"
+              <%= "required" if input.required %>
+            >
+              <option value="">Select...</option>
+              <% (input.options || []).each do |opt| %>
+                <option value="<%= opt %>" <%= "selected" if opt.to_s == input.default.to_s %>><%= opt %></option>
+              <% end %>
+            </select>
+
+          <% when "checkbox" %>
+            <div style="padding-top: 4px;">
+              <input
+                type="hidden"
+                name="task_params[<%= input.name %>]"
+                value="0"
+              >
+              <input
+                type="checkbox"
+                name="task_params[<%= input.name %>]"
+                id="task_params_<%= input.name %>"
+                value="1"
+                <%= "checked" if input.default %>
+                style="width: auto;"
+              >
+            </div>
+
+          <% when "file" %>
+            <input
+              type="file"
+              name="task_params[<%= input.name %>]"
+              id="task_params_<%= input.name %>"
+              <%= "required" if input.required %>
+            >
+
+          <% else %>
+            <input
+              type="<%= input.html_input_type %>"
+              name="task_params[<%= input.name %>]"
+              id="task_params_<%= input.name %>"
+              value="<%= input.default %>"
+              placeholder="<%= input.placeholder %>"
+              <%= "required" if input.required %>
+              <% if input.type == :float %>step="any"<% end %>
+            >
+          <% end %>
+
+          <% if input.help_text %>
+            <div class="help-text"><%= input.help_text %></div>
+          <% end %>
+        </div>
+      <% end %>
+    <% else %>
+      <p style="color: var(--text-muted); margin-bottom: 16px;">This task has no input parameters.</p>
+    <% end %>
+
+    <div class="btn-group" style="margin-top: 20px;">
+      <button type="submit" class="btn btn-primary">Start Run</button>
+      <a href="<%= job_path(id: @task_class.name) %>" class="btn btn-outline">Cancel</a>
+    </div>
+  <% end %>
+</div>