rails_ai_admin 0.1.0

data/app/jobs/rails_ai_admin/assistant_turn_job.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  # Runs due assistant turns of one chat. Loading this file loads no RubyLLM
+  # code; the assistant is required only when a job actually runs.
+  class AssistantTurnJob < ActiveJob::Base
+    queue_as { RailsAiAdmin.configuration.queue_name }
+
+    def perform(chat_ref)
+      return unless RailsAiAdmin.configuration.assistant
+      require "rails_ai_admin/assistant"
+      Assistant::Coordinator.new.run(chat_ref)
+    end
+  end
+end

data/app/jobs/rails_ai_admin/collections/execution_job.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  module Collections
+    class ExecutionJob < ActiveJob::Base
+      queue_as { RailsAiAdmin.configuration.queue_name }
+      def perform(job_ref)
+        Dispatcher.new.run(job_ref)
+      end
+    end
+  end
+end

data/app/jobs/rails_ai_admin/outbox/delivery_job.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  module Outbox
+    class DeliveryJob < ActiveJob::Base
+      queue_as { RailsAiAdmin.configuration.queue_name }
+
+      def perform(work_ref)
+        Dispatcher.new.run(work_ref)
+      end
+    end
+  end
+end

data/app/models/rails_ai_admin/application_record.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  # Shares ActiveRecord::Base's primary pool; cross-pool operations are refused.
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/rails_ai_admin/audit_event.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  # Minimal append-only execution evidence. Direct SQL is outside this boundary.
+  class AuditEvent < ApplicationRecord
+    self.table_name = "rails_ai_admin_audit_events"
+
+    def readonly?
+      persisted? || super
+    end
+  end
+end

data/app/models/rails_ai_admin/batch_item.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  # Execution bookkeeping; success commits in the target's Runner transaction.
+  class BatchItem < ApplicationRecord
+    self.table_name = "rails_ai_admin_batch_items"
+  end
+end

data/app/models/rails_ai_admin/operation_run.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  # Durable server-issued intent and atomic receipt; not a public write API.
+  class OperationRun < ApplicationRecord
+    self.table_name = "rails_ai_admin_operation_runs"
+    after_update_commit :dispatch_collection
+
+    private
+
+    def dispatch_collection
+      if selection_id && status == "queued" && saved_change_to_status? && RailsAiAdmin.configuration.collection_auto_dispatch
+        Collections::ExecutionJob.perform_later(id)
+      end
+    rescue StandardError
+      # A scheduled pending scan must recover a lost enqueue.
+      nil
+    end
+  end
+end

data/app/models/rails_ai_admin/selection.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  # Immutable target snapshot, not approval or execution authority.
+  class Selection < ApplicationRecord
+    self.table_name = "rails_ai_admin_selections"
+    def readonly? = persisted?
+  end
+end

data/app/models/rails_ai_admin/selection_item.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  # Only exact canonical identity and optimistic version are retained.
+  class SelectionItem < ApplicationRecord
+    self.table_name = "rails_ai_admin_selection_items"
+    def readonly? = persisted?
+  end
+end

data/app/models/rails_ai_admin/work_item.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module RailsAiAdmin
+  class WorkItem < ApplicationRecord
+    self.table_name = "rails_ai_admin_work_items"
+    after_create_commit :dispatch_after_commit
+
+    private
+
+    def dispatch_after_commit
+      Outbox::DeliveryJob.perform_later(id) if RailsAiAdmin.configuration.outbox_auto_dispatch
+    rescue StandardError
+      # The durable pending row survives a queue outage or process loss. A host
+      # must schedule scan_pending! even when after-commit acceleration is enabled.
+      nil
+    end
+  end
+end

data/app/views/layouts/rails_ai_admin/application.html.erb

@@ -0,0 +1,49 @@
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="turbo-cache-control" content="no-cache">
+  <%# Turbo 8 prefetches links on hover. Admin form pages prepare an intent on GET,
+      so a prefetch would write a row per hover (RAA-005); keep navigation explicit. %>
+  <meta name="turbo-prefetch" content="false">
+  <meta name="csp-nonce" content="<%= @admin_csp_nonce %>">
+  <%# "Edit ORD-0001 · Orders · Administration" (RAA-024). Views provide :raa_title. %>
+  <title><%= admin_page_title %></title>
+  <%= csrf_meta_tags %>
+  <%= stylesheet_link_tag "rails_ai_admin", "data-turbo-track": "reload" %>
+  <%= javascript_include_tag "rails_ai_admin", type: "module", "data-turbo-track": "reload", defer: true, preload_links_header: false %>
+</head>
+<body class="raa" data-raa-messages="<%= t("rails_ai_admin.script").to_json %>">
+  <a class="raa-skip" href="#raa-main"><%= t("rails_ai_admin.layout.skip") %></a>
+  <header class="raa-header"><%= link_to RailsAiAdmin.configuration.title, root_path %>
+    <% if @context && searchable_resources.any? %>
+      <%= form_with url: global_search_path, method: :get, local: true, class: "raa-global-search", html: { role: "search", aria: { label: t("rails_ai_admin.search.label") } } do |form| %>
+        <%= form.label :q, t("rails_ai_admin.search.label"), class: "raa-visually-hidden", for: "raa-global-search" %>
+        <%= form.search_field :q, id: "raa-global-search", value: (controller_path == "rails_ai_admin/search" ? @query : nil), maxlength: 200, placeholder: t("rails_ai_admin.search.placeholder") %>
+      <% end %>
+    <% end %>
+    <div class="raa-header-meta">
+      <% if RailsAiAdmin.configuration.environment_label %><span class="raa-environment"><%= RailsAiAdmin.configuration.environment_label %></span><% end %>
+      <%= render "rails_ai_admin/shared/session" %>
+    </div>
+  </header>
+  <div class="raa-shell">
+    <nav aria-label="<%= t("rails_ai_admin.layout.resources_nav") %>">
+      <div class="raa-nav-primary">
+        <%= link_to t("rails_ai_admin.layout.overview"), root_path, aria: { current: (controller_path == "rails_ai_admin/dashboard" ? "page" : nil) } %>
+        <% if assistant_available? %><%= link_to t("rails_ai_admin.layout.assistant"), assistant_path, aria: { current: (controller_path == "rails_ai_admin/assistant" ? "location" : nil) } %><% end %>
+        <% if RailsAiAdmin.configuration.mcp && assistant_available? %><%= link_to t("rails_ai_admin.mcp.nav"), mcp_tokens_path, aria: { current: (controller_path == "rails_ai_admin/mcp_tokens" ? "location" : nil) } %><% end %>
+        <% if audit_log_available? %><%= link_to t("rails_ai_admin.layout.audit_log"), audit_log_path, aria: { current: (controller_path == "rails_ai_admin/audit" ? "location" : nil) } %><% end %>
+        <% if collection_jobs_available? %><%= link_to t("rails_ai_admin.layout.collection_jobs"), collection_jobs_path, aria: { current: (controller_path == "rails_ai_admin/collection_jobs" ? "location" : nil) } %><% end %>
+      </div>
+      <%= render "rails_ai_admin/shared/navigation", groups: resource_navigation %>
+    </nav>
+    <main id="raa-main" tabindex="-1">
+      <% if return_state_discarded? %><p class="raa-notice" role="status"><%= t("rails_ai_admin.layout.return_state_discarded") %></p><% end %>
+      <% flash.each do |_, message| %><p class="raa-notice" role="status"><%= message %></p><% end %>
+      <%= yield %>
+    </main>
+  </div>
+</body>
+</html>

data/app/views/layouts/rails_ai_admin/frame.html.erb

@@ -0,0 +1,5 @@
+<!DOCTYPE html>
+<html lang="en">
+<head><meta charset="utf-8"><title><%= RailsAiAdmin.configuration.title %></title></head>
+<body><%= yield %></body>
+</html>

data/app/views/layouts/rails_ai_admin/status.html.erb

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="turbo-visit-control" content="reload">
+  <title><%= @admin_status.title %> · Administration</title>
+  <%= stylesheet_link_tag "rails_ai_admin" %>
+</head>
+<body class="raa">
+  <main id="raa-main" class="raa-status-page" tabindex="-1"><%= yield %></main>
+</body>
+</html>

data/app/views/rails_ai_admin/assistant/_ask.html.erb

@@ -0,0 +1,16 @@
+<%# "Ask the assistant" from a record or list page. The server names the page in a
+    Context line only after checking the assistant grant again. %>
+<details class="raa-ask">
+  <summary><%= record ? t("rails_ai_admin.assistant.ask_record") : t("rails_ai_admin.assistant.ask_list") %></summary>
+  <%= form_with url: assistant_conversations_path, method: :post, local: true, class: "raa-chat-composer" do |form| %>
+    <%= hidden_field_tag "about[resource]", resource.key, id: nil %>
+    <% if record %><%= hidden_field_tag "about[id]", record.id, id: nil %><% else %>
+      <% if navigation_state["q"] %><%= hidden_field_tag "about[q]", navigation_state["q"], id: nil %><% end %>
+      <% if navigation_state["scope"] %><%= hidden_field_tag "about[scope]", navigation_state["scope"], id: nil %><% end %>
+    <% end %>
+    <%= label_tag "raa-ask-content", t("rails_ai_admin.assistant.message") %>
+    <%= text_area_tag :content, nil, id: "raa-ask-content", rows: 2, maxlength: 3500, required: true,
+      placeholder: record ? t("rails_ai_admin.assistant.ask_record_placeholder") : t("rails_ai_admin.assistant.ask_list_placeholder") %>
+    <div class="raa-actions"><%= form.submit t("rails_ai_admin.assistant.ask"), name: nil %></div>
+  <% end %>
+</details>

data/app/views/rails_ai_admin/assistant/_transcript.html.erb

@@ -0,0 +1,45 @@
+<%= turbo_frame_tag "raa_assistant_transcript", class: "raa-chat", data: { controller: "raa-poll", raa_poll_url_value: assistant_conversation_path(chat_ref: @chat.ref) } do %>
+  <% if @entries.empty? && !@pending && !@failure %>
+    <div class="raa-chat-empty">
+      <h2><%= t("rails_ai_admin.assistant.empty_title") %></h2>
+      <p><%= t("rails_ai_admin.assistant.empty") %></p>
+    </div>
+  <% end %>
+  <ol class="raa-chat-log" role="list" aria-label="<%= t("rails_ai_admin.assistant.conversation") %>">
+    <% @entries.each do |entry| %>
+      <% case entry.kind %>
+      <% when :user %>
+        <li class="raa-chat-message raa-chat-user"><span class="raa-chat-role"><%= t("rails_ai_admin.assistant.roles.user") %></span><div class="raa-chat-text"><%= h(entry.text) %></div></li>
+      <% when :continuation %>
+        <li class="raa-chat-message raa-chat-event"><span class="raa-chat-role"><%= t("rails_ai_admin.assistant.roles.review") %></span><div class="raa-chat-text"><%= h(entry.text) %></div></li>
+      <% when :assistant %>
+        <li class="raa-chat-message raa-chat-assistant"><span class="raa-chat-role"><%= t("rails_ai_admin.assistant.roles.assistant") %></span><div class="raa-chat-text"><%= h(entry.text) %></div></li>
+      <% when :activity %>
+        <li class="raa-chat-activity"><%= entry.text %></li>
+      <% when :records %>
+        <li class="raa-chat-records"><span class="raa-chat-role"><%= t("rails_ai_admin.assistant.roles.records") %></span>
+          <ul><% entry.links.each do |link| %><li><%= link_to link.label, resource_path(resource: link.resource_key, id: link.id), data: { turbo_frame: "_top" } %></li><% end %></ul>
+        </li>
+      <% when :surface %>
+        <li class="raa-chat-surface"><%= admin_assistant_surface(entry.surface_id, scope: @surface_scope) if @surface_scope %></li>
+      <% end %>
+    <% end %>
+    <% if @current && @streaming_text %>
+      <li class="raa-chat-message raa-chat-assistant raa-chat-streaming" aria-busy="true"><span class="raa-chat-role"><%= t("rails_ai_admin.assistant.roles.assistant") %></span><div class="raa-chat-text"><%= h(@streaming_text) %></div></li>
+    <% end %>
+  </ol>
+  <% if @pending %>
+    <div class="raa-chat-turn">
+      <p class="raa-chat-status" role="status" data-raa-pending="<%= @streaming_text ? "streaming" : "waiting" %>">
+        <%= @retry_status || (@running ? t("rails_ai_admin.assistant.working") : t("rails_ai_admin.assistant.waiting")) %>
+      </p>
+      <%= button_to t("rails_ai_admin.assistant.stop"), cancel_assistant_conversation_path(chat_ref: @chat.ref), method: :post, class: "raa-secondary", form: { data: { turbo_frame: "_top" } } %>
+      <%= link_to t("rails_ai_admin.assistant.refresh"), assistant_conversation_path(chat_ref: @chat.ref), data: { turbo_frame: "_top" } %>
+    </div>
+  <% elsif @failure %>
+    <div class="raa-chat-turn">
+      <p class="raa-chat-status raa-chat-failure" role="status"><%= @failure_message %></p>
+      <% if @retryable %><%= button_to t("rails_ai_admin.assistant.try_again"), retry_assistant_conversation_path(chat_ref: @chat.ref), method: :post, class: "raa-secondary", form: { data: { turbo_frame: "_top" } } %><% end %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/rails_ai_admin/assistant/frame.html.erb

@@ -0,0 +1 @@
+<%= render "rails_ai_admin/assistant/transcript" %>

data/app/views/rails_ai_admin/assistant/index.html.erb

@@ -0,0 +1,14 @@
+<% admin_title t("rails_ai_admin.layout.assistant") %>
+<h1><%= t("rails_ai_admin.layout.assistant") %></h1>
+<p><%= t("rails_ai_admin.assistant.intro") %></p>
+<%= button_to t("rails_ai_admin.assistant.new"), assistant_conversations_path, method: :post, class: "raa-button" %>
+<% if @chats.empty? %>
+  <p><%= t("rails_ai_admin.assistant.none") %></p>
+<% else %>
+  <ul class="raa-chat-list">
+    <% @chats.each do |chat| %>
+      <li><%= link_to t("rails_ai_admin.assistant.from", time: l(chat.created_at.in_time_zone(@context.time_zone), format: :short)), assistant_conversation_path(chat_ref: chat.ref) %>
+        <% if chat.status == "archived" %> — <%= t("rails_ai_admin.assistant.archived_mark") %><% elsif !chat.current_for?(@context) %> — <%= t("rails_ai_admin.assistant.closed_mark") %><% end %></li>
+    <% end %>
+  </ul>
+<% end %>

data/app/views/rails_ai_admin/assistant/show.html.erb

@@ -0,0 +1,44 @@
+<% admin_title t("rails_ai_admin.assistant.conversation"), t("rails_ai_admin.layout.assistant") %>
+<section class="raa-conversation" aria-labelledby="raa-conversation-title" data-controller="raa-conversation">
+  <header class="raa-conversation-header">
+    <div>
+      <%= link_to t("rails_ai_admin.assistant.all"), assistant_path %>
+      <h1 id="raa-conversation-title"><%= t("rails_ai_admin.assistant.title") %></h1>
+    </div>
+    <% if @current %>
+      <div class="raa-actions">
+        <%= button_to t("rails_ai_admin.assistant.new"), assistant_conversations_path, method: :post, class: "raa-secondary" %>
+        <%= button_to t("rails_ai_admin.assistant.archive"), archive_assistant_conversation_path(chat_ref: @chat.ref), method: :post, class: "raa-chat-archive" %>
+      </div>
+    <% end %>
+  </header>
+  <% if @current %>
+    <div class="raa-conversation-thread" data-raa-conversation-target="thread"
+      data-action="scroll->raa-conversation#track turbo:frame-load->raa-conversation#follow"
+      role="region" aria-label="<%= t("rails_ai_admin.assistant.transcript") %>" tabindex="0">
+      <%= render "rails_ai_admin/assistant/transcript" %>
+    </div>
+    <footer class="raa-conversation-footer">
+      <button type="button" class="raa-secondary raa-chat-latest" hidden data-raa-conversation-target="latest"
+        data-action="raa-conversation#jump"><%= t("rails_ai_admin.assistant.latest") %></button>
+      <%= form_with url: assistant_messages_path(chat_ref: @chat.ref), method: :post, class: "raa-chat-composer raa-conversation-composer" do |form| %>
+        <%= hidden_field_tag :admission_key, @admission_key, id: nil %>
+        <%= form.label :content, t("rails_ai_admin.assistant.message"), class: "raa-visually-hidden" %>
+        <% if @message_error %><p class="raa-field-error" id="raa-chat-error" role="alert"><%= @message_error %></p><% end %>
+        <div class="raa-chat-input">
+          <%= form.text_area :content, value: @draft, rows: 2, maxlength: RailsAiAdmin::Assistant::Coordinator::MAX_CONTENT, required: true,
+            placeholder: t("rails_ai_admin.assistant.compose_placeholder"),
+            data: { action: "keydown->raa-conversation#submitOnEnter" },
+            aria: { describedby: (@message_error ? "raa-chat-error" : nil), invalid: (@message_error ? true : nil) } %>
+          <%= form.submit t("rails_ai_admin.assistant.send"), data: { turbo_submits_with: t("rails_ai_admin.assistant.sending") } %>
+        </div>
+        <p class="raa-chat-shortcut" hidden data-raa-conversation-target="shortcut"><%= t("rails_ai_admin.assistant.shortcut") %></p>
+      <% end %>
+    </footer>
+  <% else %>
+    <div class="raa-conversation-closed">
+      <p class="raa-notice" role="status"><%= @chat.status == "archived" ? t("rails_ai_admin.assistant.archived_note") : t("rails_ai_admin.assistant.closed_note") %></p>
+      <%= button_to t("rails_ai_admin.assistant.new"), assistant_conversations_path, method: :post %>
+    </div>
+  <% end %>
+</section>

data/app/views/rails_ai_admin/audit/index.html.erb

@@ -0,0 +1,40 @@
+<% admin_title t("rails_ai_admin.audit.title") %>
+<h1><%= t("rails_ai_admin.audit.title") %></h1>
+<p><%= t("rails_ai_admin.audit.intro") %></p>
+<%= form_with url: audit_log_path, method: :get, local: true, class: "raa-filters raa-audit-filters" do |form| %>
+  <div class="raa-filter"><%= label_tag "raa-audit-resource", t("rails_ai_admin.audit.resource") %>
+    <%= select_tag :resource, options_for_select(@log.resources.map { |resource| [ resource.label, resource.key.to_s ] }, @filters["resource"]), include_blank: t("rails_ai_admin.audit.any"), id: "raa-audit-resource" %></div>
+  <div class="raa-filter"><%= label_tag "raa-audit-operation", t("rails_ai_admin.audit.change") %>
+    <%= select_tag :operation, options_for_select(%w[create update destroy export].map { |key| [ t(key, scope: %i[rails_ai_admin history operations]), key ] }, @filters["operation"]), include_blank: t("rails_ai_admin.audit.any"), id: "raa-audit-operation" %></div>
+  <div class="raa-filter"><%= label_tag "raa-audit-status", t("rails_ai_admin.audit.outcome") %>
+    <%= select_tag :status, options_for_select([ [ t("rails_ai_admin.audit.saved"), "succeeded" ], [ t("rails_ai_admin.history.not_saved"), "rejected" ] ], @filters["status"]), include_blank: t("rails_ai_admin.audit.any"), id: "raa-audit-status" %></div>
+  <% if @filters["actor"] %><%= hidden_field_tag :actor, @filters["actor"], id: nil %><% end %>
+  <div class="raa-actions"><%= form.submit t("rails_ai_admin.resources.index.apply_filters"), name: nil %>
+  <% if @filters.except("before").any? %><%= link_to t("rails_ai_admin.resources.index.clear_filters"), audit_log_path %><% end %></div>
+<% end %>
+<% if @filters["actor"] %><p class="raa-notice" role="status"><%= t("rails_ai_admin.audit.only_actor", actor: @actor_labels.fetch(@filters["actor"])) %></p><% end %>
+<% if @page.entries.empty? %>
+  <p><%= t("rails_ai_admin.audit.empty") %></p>
+<% else %>
+  <div class="raa-table-scroll"><table class="raa-history">
+    <caption><%= t("rails_ai_admin.history.caption") %></caption>
+    <thead><tr>
+      <th scope="col"><%= t("rails_ai_admin.history.when") %></th>
+      <th scope="col"><%= t("rails_ai_admin.audit.record") %></th>
+      <th scope="col"><%= t("rails_ai_admin.history.change") %></th>
+      <th scope="col"><%= t("rails_ai_admin.history.fields") %></th>
+      <th scope="col"><%= t("rails_ai_admin.history.by") %></th>
+    </tr></thead>
+    <tbody>
+      <% @page.entries.each do |entry| %><tr>
+        <td class="raa-cell-compact"><%= admin_history_time(entry.at) %></td>
+        <td><% if entry.record_id.nil? %><%= entry.resource.label %><% else %><% text = "#{entry.resource.label.singularize} ##{entry.record_id}" %><% if entry.operation == "destroy" && entry.status == "succeeded" %><%= text %><% else %><%= link_to text, resource_path(resource: entry.resource.key, id: entry.record_id) %><% end %><% end %></td>
+        <td><%= admin_history_change(entry.resource, entry) %></td>
+        <td><%= admin_history_fields(entry) %></td>
+        <td><%= link_to @actor_labels.fetch(entry.actor_ref), audit_log_path(@filters.except("before").merge("actor" => entry.actor_ref)) %><% if entry.actor_ref == @context.actor_ref %> <span class="raa-muted"><%= t("rails_ai_admin.history.you") %></span><% end %>
+          <% unless entry.origin == "ui" %><br><span class="raa-muted"><%= t(entry.origin, scope: %i[rails_ai_admin history origins], default: entry.origin.to_s.humanize) %></span><% end %></td>
+      </tr><% end %>
+    </tbody>
+  </table></div>
+  <% if @page.older %><p><%= link_to t("rails_ai_admin.history.older"), audit_log_path(@filters.merge("before" => @page.older)) %></p><% end %>
+<% end %>

data/app/views/rails_ai_admin/collection_jobs/index.html.erb

@@ -0,0 +1,5 @@
+<% admin_title t("rails_ai_admin.layout.collection_jobs") %>
+<h1><%= t("rails_ai_admin.layout.collection_jobs") %></h1>
+<p><%= t("rails_ai_admin.collection_jobs.intro") %></p>
+<% if @jobs.empty? %><p><%= t("rails_ai_admin.collection_jobs.empty") %></p><% end %>
+<ul><% @jobs.each do |job| %><li><%= link_to job.description, collection_job_path(job_ref: job.job_ref) %> — <%= admin_state_name(job.status) %></li><% end %></ul>

data/app/views/rails_ai_admin/collection_jobs/show.html.erb

@@ -0,0 +1,24 @@
+<% admin_title @job.description, t("rails_ai_admin.layout.collection_jobs") %>
+<p><%= link_to t("rails_ai_admin.layout.collection_jobs"), collection_jobs_path %> · <%= link_to list_return_label, list_return_path %></p>
+<h1><%= @job.description %></h1>
+<p><%= t("rails_ai_admin.collection_jobs.status_html", status: tag.strong(admin_state_name(@job.status))) %></p>
+<% if @job.waiting_since %>
+  <p class="raa-notice" role="status"><%= t("rails_ai_admin.collection_jobs.waiting", age: distance_of_time_in_words(@job.waiting_since, Time.current)) %>
+  <% if @job.waiting_since < 5.minutes.ago %><%= t("rails_ai_admin.collection_jobs.waiting_hint_html", queue: tag.code(RailsAiAdmin.configuration.queue_name)) %><% end %></p>
+<% end %>
+<p><%= admin_state_counts(@job.counts) %></p>
+<p><%= link_to t("rails_ai_admin.collection_jobs.refresh"), collection_job_path(job_ref: @job.job_ref, **navigation_params) %></p>
+<% if @job.warning %><p class="raa-errors" role="alert"><%= t("rails_ai_admin.collection_jobs.warning") %></p><% end %>
+<% if @job.can_cancel %>
+  <%= button_to t("rails_ai_admin.collection_jobs.cancel"), cancel_collection_job_path(job_ref: @job.job_ref), method: :post, params: navigation_params, data: { turbo: false } %>
+<% end %>
+<p><%= t("rails_ai_admin.collection_jobs.committed_note") %></p>
+<div class="raa-table-scroll" role="region" aria-label="<%= t("rails_ai_admin.collection_jobs.items") %>" tabindex="0"><table>
+<caption><%= t("rails_ai_admin.collection_jobs.items") %></caption>
+<thead><tr><th scope="col"><%= t("rails_ai_admin.collection_jobs.record") %></th><th scope="col"><%= t("rails_ai_admin.collection_jobs.business_status") %></th><th scope="col"><%= t("rails_ai_admin.collection_jobs.reason") %></th><th scope="col"><%= t("rails_ai_admin.collection_jobs.follow_up") %></th></tr></thead>
+<tbody><% @job.entries.each do |entry| %><tr>
+<td><%= link_to entry.label, resource_path(resource: @resource.key, id: entry.record_id, **navigation_params) %></td>
+<td><%= admin_state_name(entry.status) %><% if entry.warning %> <%= t("rails_ai_admin.collection_jobs.callback_warning") %><% end %></td><td><%= admin_outcome(entry.code) if entry.code && entry.code != "OK" %></td>
+<td><%= admin_state_counts(entry.work_statuses) %></td>
+</tr><% end %></tbody></table></div>
+<% if @job.hidden_count > 0 %><p><%= t("rails_ai_admin.collection_jobs.hidden") %></p><% end %>

data/app/views/rails_ai_admin/collection_operations/confirmation.html.erb

@@ -0,0 +1,25 @@
+<% admin_title t("rails_ai_admin.collection_operations.review_title"), @resource.label %>
+<h1><%= t("rails_ai_admin.collection_operations.review_title") %></h1>
+<p><%= @definition.description %></p>
+<p><%= t("rails_ai_admin.collection_operations.targets_note", count: @proposal.targets.size) %></p>
+<h2><%= t("rails_ai_admin.collection_operations.confirmed_input") %></h2>
+<%# Labels and formatting match the member confirmation page (RAA-029). %>
+<% input_fields = @definition.handler_class.input.index_by { |field| field.name.to_s } %>
+<% record_fields = @resource.fields.index_by { |field| field.name.to_s } %>
+<dl class="raa-details"><% @proposal.values.each do |name, value| %><% field = input_fields[name] %><dt><%= field ? field.label : name.humanize %></dt><dd><%= field ? field.format(value, time_zone: @context.time_zone) : value %></dd><% end %></dl>
+<h2><%= t("rails_ai_admin.collection_operations.previews") %></h2>
+<% @proposal.targets.each do |target| %>
+  <section><h3><%= target.label %></h3><p><%= t("rails_ai_admin.collection_operations.target_id", id: target.id) %></p>
+    <% if target.changes.empty? %><p><%= t("rails_ai_admin.collection_operations.no_differences") %></p><% else %>
+      <dl class="raa-details"><% target.changes.each do |name, change| %><% field = record_fields[name] %><dt><%= field ? field.label : name.humanize %></dt><dd><%= field ? field.format(change["before"], time_zone: @context.time_zone) : change["before"] %> → <%= field ? field.format(change["after"], time_zone: @context.time_zone) : change["after"] %></dd><% end %></dl>
+    <% end %>
+  </section>
+<% end %>
+<%= form_with url: collection_operation_execute_path(resource: @resource.key, operation: @definition.key), method: :post, local: true, data: { turbo: false } do |form| %>
+  <%= hidden_field_tag :intent_ref, @proposal.intent.id %>
+  <%= return_navigation_fields %>
+  <%= hidden_field_tag :selection_ref, @proposal.intent.selection_id %>
+  <%= hidden_field_tag :confirmed_input, @wire_input %>
+  <%= form.submit t("rails_ai_admin.collection_operations.confirm") %>
+<% end %>
+<p><%= link_to t("rails_ai_admin.collection_operations.edit_input"), collection_operation_form_path(resource: @resource.key, operation: @definition.key, selection_ref: @proposal.intent.selection_id, **navigation_params) %></p>

data/app/views/rails_ai_admin/collection_operations/failure.html.erb

@@ -0,0 +1,10 @@
+<% admin_title t("rails_ai_admin.collection_operations.failure_title"), @resource.label %>
+<h1><%= t("rails_ai_admin.collection_operations.failure_title") %></h1>
+<% if @uncertain_job_ref %>
+<p><%= t("rails_ai_admin.collection_operations.uncertain") %></p>
+<p><%= link_to t("rails_ai_admin.collection_operations.check_run"), collection_job_path(job_ref: @uncertain_job_ref, **navigation_params) %></p>
+<% else %>
+<p><%= admin_outcome(@failure_code) %></p>
+<p><%= t("rails_ai_admin.collection_operations.failure_note") %></p>
+<% end %>
+<p><%= link_to t("rails_ai_admin.collection_operations.return"), list_return_path %></p>

data/app/views/rails_ai_admin/collection_operations/new.html.erb

@@ -0,0 +1,11 @@
+<p><%= link_to t("rails_ai_admin.selections.title"), selection_path(selection_ref: @selection.selection_ref, **navigation_params) %></p>
+<% admin_title @definition.description, @resource.label %>
+<h1><%= @definition.description %></h1>
+<p><%= t("rails_ai_admin.collection_operations.form_note", count: @selection.targets.size) %></p>
+<%= form_with scope: :input, url: collection_operation_preflight_path(resource: @resource.key, operation: @definition.key), method: :post, local: true, namespace: "raa_#{@resource.key}_#{@selection.selection_ref}_#{@definition.key}", data: { turbo: false, controller: "raa-dirty-form", action: "input->raa-dirty-form#change submit->raa-dirty-form#submit" } do |form| %>
+  <%= return_navigation_fields %>
+  <%= hidden_field_tag :selection_ref, @selection.selection_ref %>
+  <%= render "rails_ai_admin/resources/errors", form: form, fields: @form_fields %>
+  <%= render "rails_ai_admin/shared/input_fields", form: form, fields: @form_fields, values: @form_values, errors: @errors %>
+  <%= form.submit t("rails_ai_admin.collection_operations.review") %>
+<% end %>

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

@@ -0,0 +1,33 @@
+<h1><%= t("rails_ai_admin.dashboard.title") %></h1>
+<p class="raa-dashboard-intro"><%= t("rails_ai_admin.dashboard.intro") %></p>
+<ul class="raa-cards">
+  <% resource_navigation.each do |group| %>
+    <% group.entries.each do |entry| %>
+      <li><%= link_to resources_path(resource: entry.key) do %><%= navigation_icon(entry.icon) %><span><%= entry.label %><% if (count = @counts[entry.key]) %><span class="raa-card-count"><%= t(count.capped ? "rails_ai_admin.dashboard.count_capped" : "rails_ai_admin.dashboard.count", count: count.count, number: number_with_delimiter(count.count)) %></span><% end %></span><% end %></li>
+    <% end %>
+  <% end %>
+</ul>
+<% if resource_navigation.empty? %><p><%= t("rails_ai_admin.dashboard.empty") %></p><% end %>
+<% @widgets.each do |section| %>
+<section class="raa-dashboard-section" aria-labelledby="raa-dashboard-<%= section.resource.key %>">
+  <h2 id="raa-dashboard-<%= section.resource.key %>"><%= link_to section.resource.label, resources_path(resource: section.resource.key) %></h2>
+  <% if section.metrics.any? %>
+    <ul class="raa-metrics">
+      <% section.metrics.each do |metric| %>
+        <li><%= link_to resources_path(resource: section.resource.key, **(metric.scope ? { scope: metric.scope } : {})) do %><span class="raa-metric-value"><%= admin_number(metric.count, metric.capped) %></span> <span class="raa-metric-label"><%= metric.label %></span><% end %></li>
+      <% end %>
+    </ul>
+  <% end %>
+  <% section.trends.each do |trend| %>
+    <figure class="raa-trend">
+      <figcaption><strong><%= trend.label %></strong> — <%= t("rails_ai_admin.dashboard.trend_total", count: trend.total, days: trend.days.size, number: number_with_delimiter(trend.total)) %><% if trend.capped %> <%= t("rails_ai_admin.dashboard.trend_capped") %><% end %></figcaption>
+      <%= admin_trend_chart(trend) %>
+      <div class="raa-trend-axis" aria-hidden="true"><span><%= l(trend.days.first.first, format: :short) %></span><span><%= l(trend.days.last.first, format: :short) %></span></div>
+      <details><summary><%= t("rails_ai_admin.dashboard.show_data") %></summary>
+        <table><thead><tr><th scope="col"><%= t("rails_ai_admin.dashboard.day") %></th><th scope="col"><%= t("rails_ai_admin.dashboard.records") %></th></tr></thead>
+        <tbody><% trend.days.reverse_each do |day, count| %><tr><td><time datetime="<%= day.iso8601 %>"><%= day.iso8601 %></time></td><td><%= count %></td></tr><% end %></tbody></table>
+      </details>
+    </figure>
+  <% end %>
+</section>
+<% end %>

data/app/views/rails_ai_admin/fields/_index.html.erb

@@ -0,0 +1 @@
+<%= text %>

data/app/views/rails_ai_admin/fields/_input.html.erb

@@ -0,0 +1,21 @@
+<%# A select without a blank option always has a value, so HTML `required` is invalid there; aria-required still marks it. %>
+<% case field.scalar_type; when :textarea %><%= form.text_area field.name, value: value, maxlength: field.options[:max_length], rows: 5, **input_options %>
+<% when :boolean %><%= form.select field.name, [[t("rails_ai_admin.fields.yes"), "true"], [t("rails_ai_admin.fields.no"), "false"]], { selected: value.to_s, include_blank: field.options[:nullable] ? t("rails_ai_admin.fields.not_set") : false }, field.options[:nullable] ? input_options : input_options.except(:required) %>
+<% when :enum, :select %><%= form.select field.name, admin_field_choices(field, value), { selected: value, include_blank: field.options[:nullable] ? t("rails_ai_admin.fields.not_set") : t("rails_ai_admin.fields.choose_value") }, input_options %>
+<% when :belongs_to %><%= admin_reference_input(form, field, value, input_options) %>
+<% when :integer %><%= form.number_field field.name, value: value, step: 1, **input_options %>
+<% when :decimal %><%= form.text_field field.name, value: value.is_a?(BigDecimal) ? field.format_decimal(value) : value, inputmode: "decimal", **input_options %>
+<% when :date %><%= form.date_field field.name, value: value, **input_options %>
+<% when :datetime %><%= form.datetime_local_field field.name, value: admin_datetime_input_value(value), step: 1, **input_options %>
+<% when :time %><% time_value = admin_time_input_value(field, value) %><%= form.time_field field.name, value: time_value, step: time_value.to_s.length > 5 ? 1 : 60, **input_options %>
+<% when :email %><%= form.email_field field.name, value: value, maxlength: field.options[:max_length], autocomplete: "off", spellcheck: false, **input_options %>
+<% when :url %><%= form.url_field field.name, value: value, maxlength: field.options[:max_length], autocomplete: "off", spellcheck: false, **input_options %>
+<%# A password is never prefilled or echoed back, even after a failed save. %>
+<% when :password %><%= form.password_field field.name, value: nil, maxlength: field.options[:max_length], autocomplete: "new-password", **input_options %>
+<% when :references %><%= admin_references_input(form, field, value, input_options) %>
+<% when :rich_text %><%= admin_rich_text_input(form, field, value, input_options) %>
+<% when :files %><%= admin_files_input(form, field, value, input_options) %>
+<% when :file %><%= admin_file_input(form, field, value, input_options) %>
+<% when :json %><%= form.text_area field.name, value: admin_json_input_value(value), rows: 8, spellcheck: false, class: "raa-json-input", **input_options %>
+<% else %><%= form.text_field field.name, value: value, maxlength: field.options[:max_length], **input_options %>
+<% end %>

data/app/views/rails_ai_admin/fields/_reference.html.erb

@@ -0,0 +1 @@
+<% if reference.nil? %>—<% elsif reference.visible %><%= link_to reference.label, resource_path(resource: reference.resource_key, id: reference.id) %><% else %><%= reference.label %><% end %>

data/app/views/rails_ai_admin/fields/_reference_picker.html.erb

@@ -0,0 +1,14 @@
+<%# Progressive enhancement for a typed reference key. Without JavaScript the
+    key input works alone; with it, a search box fills the key from the target
+    resource's own search. The search box has no name, so it is never submitted. %>
+<div class="raa-reference" data-controller="raa-reference-picker" data-raa-reference-picker-url-value="<%= reference_search_path(resource: target.key) %>" data-raa-reference-picker-key-value="<%= key_id %>" data-raa-reference-picker-messages-value="<%= admin_reference_messages.to_json %>">
+  <%= key_input %>
+  <% if current %><p class="raa-reference-current" data-raa-reference-picker-target="current"><%= t("rails_ai_admin.references.current", label: current.label) %></p>
+  <% else %><p class="raa-reference-current" data-raa-reference-picker-target="current" hidden></p><% end %>
+  <div class="raa-reference-search" data-raa-reference-picker-target="panel" hidden>
+    <label for="<%= key_id %>--search"><%= t("rails_ai_admin.references.find", target: target.label) %></label>
+    <input type="search" id="<%= key_id %>--search" autocomplete="off" spellcheck="false" maxlength="200" aria-controls="<%= key_id %>--results" aria-describedby="<%= key_id %>--status" data-raa-reference-picker-target="query" data-action="input->raa-reference-picker#search keydown->raa-reference-picker#keydown">
+    <p class="raa-reference-status" id="<%= key_id %>--status" role="status" data-raa-reference-picker-target="status"></p>
+    <ul class="raa-reference-results" id="<%= key_id %>--results" data-raa-reference-picker-target="results"></ul>
+  </div>
+</div>

data/app/views/rails_ai_admin/fields/_row.html.erb

@@ -0,0 +1,27 @@
+<% field = entry.field %>
+<% error_id = "#{form.field_id(field.name)}--error" %>
+<% help_id = "#{form.field_id(field.name)}--help" %>
+<% has_error = entry.editable && errors.key?(field.name.to_s) %>
+<% keep_password = entry.editable && field.scalar_type == :password && @operation == :update %>
+<% keep_id = "#{form.field_id(field.name)}--keep" %>
+<% descriptions = [field.options[:help_text] ? help_id : nil, keep_password ? keep_id : nil, has_error ? error_id : nil].compact.join(" ") %>
+<% required = entry.editable && admin_field_required?(field) %>
+<div class="raa-field">
+  <% if entry.editable %>
+    <% if %i[references rich_text].include?(field.scalar_type) && !field.plugin? %>
+    <%# A checkbox group and a rich-text editor are not labelable elements; they name themselves through this text. %>
+    <span class="raa-label" id="<%= form.field_id(field.name) %>--label"><%= field.label %><% if required %> <span class="raa-required" aria-hidden="true">*</span><% end %></span>
+    <% else %>
+    <%= form.label field.name do %><%= field.label %><% if required %> <span class="raa-required" aria-hidden="true">*</span><% end %><% end %>
+    <% end %>
+    <% input_options = { required: required || nil, aria: { invalid: has_error, required: required || nil, describedby: descriptions.presence } } %>
+    <%= render partial: field.form_partial || "rails_ai_admin/fields/input", locals: { field: field, form: form, value: entry.value, input_options: input_options } %>
+  <% else %>
+    <%# A readonly value is plain text named by its label, not a live region (RAA-023). %>
+    <span class="raa-label" id="<%= form.field_id(field.name) %>--label"><%= field.label %></span>
+    <div class="raa-readonly" id="<%= form.field_id(field.name) %>" role="group" aria-labelledby="<%= form.field_id(field.name) %>--label" aria-describedby="<%= descriptions.presence %>"><%= admin_field_value(field, entry.value, view: :show) %></div>
+  <% end %>
+  <% if field.options[:help_text] %><p class="raa-field-help" id="<%= help_id %>"><%= field.options[:help_text] %></p><% end %>
+  <% if keep_password %><p class="raa-field-help" id="<%= keep_id %>"><%= t("rails_ai_admin.fields.keep_password") %></p><% end %>
+  <% if has_error %><p class="raa-field-error" id="<%= error_id %>"><%= errors[field.name.to_s].join(", ") %></p><% end %>
+</div>

data/app/views/rails_ai_admin/fields/_show.html.erb

@@ -0,0 +1 @@
+<%= text %>