Closes #1490

Problem

The Maintenance Tasks web UI auto-refreshes pages every 3 seconds to keep run statuses up to date. This behavior is driven by JavaScript in the application layout: when an element with data-refresh is present and truthy, the page periodically fetches the current URL and replaces the refreshed content in place.

While this is useful when monitoring active runs, it can be disruptive in other situations:

• Debugging or inspecting the page — the DOM is replaced every few seconds, making it hard to read logs, copy values, or use browser dev tools.
• Stable UI for screenshots or demos — auto-refresh causes the page to flicker and the cursor to change to a wait state.
• Reduced background activity — unnecessary polling when the operator does not need live updates.

Two pages are affected:

There was no user-facing way to turn auto-refresh off on either page.

Proposed solution

Add a user-facing toggle on the task show page (when the task has active runs) to disable and re-enable auto-refresh. Respect a shared ?refresh=false URL parameter in the controller so the preference applies consistently across both pages.

Behavior

Task show page (primary UI)

The toggle is shown only when the task has active runs (@task.refresh?). When there are no active runs, the page does not auto-refresh and no toggle is displayed.

• Auto-refresh remains on by default when active runs are present.
• Disabling auto-refresh navigates to the same task with ?refresh=false.
• Re-enabling auto-refresh navigates back to the task path without the query parameter.
• The toggle is a small button aligned to the top-right, above the runs section.

Task list page

The task list continues to auto-refresh by default and respects ?refresh=false when present, but does not include a toggle control. Users who disable auto-refresh on a task show page can keep refresh=false in the URL when navigating back to the list, or append it manually.

Implementation outline

1. Controller — Run set_refresh on both index and show, and read the refresh query parameter:

   before_action :set_refresh, only: [:index, :show]
   def set_refresh
    @refresh = params[:refresh] != "false"
   end

2. Task show view — In app/views/maintenance_tasks/tasks/show.html.erb:

   • Render Disable/Enable toggle links when @task.refresh? is true.
   • Set data-refresh from @task.refresh? && @refresh so both active-run status and the user preference are respected.

3. Task list view — In app/views/maintenance_tasks/tasks/index.html.erb, continue setting data-refresh from @refresh (no toggle UI).

4. Tests — Integration tests in test/integration/maintenance_tasks/tasks_controller_test.rb covering:

   • Task show page auto-refreshes by default when there are active runs ([data-refresh=true] present).
   • refresh=false disables auto-refresh on the task show page ([data-refresh=true] absent).
   • Correct toggle link is shown in each state on the task show page.
   • No toggle links when the task has no active runs.

5. Documentation — Document the toggle and ?refresh=false URL parameter in the README (under "Running a Task from the Web UI").

Mocks

• Screenshot 2026年05月29日 alle 21 45 41
• Screenshot 2026年05月29日 alle 21 45 14

Scope

• In scope: User toggle on the task show page when active runs exist; controller-level ?refresh=false support on both index and show actions.
• Out of scope: Toggle UI on the task list page; persisting the preference beyond the current URL (e.g. cookies or local storage).

Acceptance criteria

• Task show page auto-refreshes by default when there are active runs (no change to current default behavior).
• Users can disable auto-refresh via a visible control on the task show page (when active runs exist).
• Disabling auto-refresh persists via the ?refresh=false URL parameter.
• Users can re-enable auto-refresh from the same page.
• No toggle is shown when the task has no active runs.
• Integration tests cover both refresh states, toggle links, and the no-active-runs case.
• README documents the feature.