rails_console_ai 0.28.0 → 0.30.0

data/app/views/rails_console_ai/agents/show.html.erb

@@ -0,0 +1,108 @@
+<%
+  is_db = @agent.is_a?(RailsConsoleAi::Agent)
+  is_builtin = !is_db && @agent['source'] == :builtin
+  is_file = !is_db && @agent['source'] == :file
+
+  name = is_db ? @agent.name : @agent['name']
+  description = is_db ? @agent.description : @agent['description']
+  body = is_db ? @agent.body : @agent['body']
+  max_rounds = is_db ? @agent.max_rounds : @agent['max_rounds']
+  model = is_db ? @agent.model : @agent['model']
+  tools = is_db ? Array(@agent.tools) : Array(@agent['tools'])
+  file_key = is_db ? nil : @agent['file_key']
+%>
+
+<%= link_to '← All agents', agents_path, class: 'back-link' %>
+
+<% if is_db && !@agent.approved? %>
+  <div class="flash flash-alert" style="margin-bottom:16px;">
+    <strong>Awaiting approval.</strong> The AI cannot invoke this agent via delegate_task until a human approves it.
+    Review the body and tools list below, then click <strong>Approve</strong>.
+  </div>
+<% end %>
+
+<% if is_builtin %>
+  <div class="flash flash-notice" style="margin-bottom:16px;">
+    This is a <strong>built-in agent</strong> shipped with the gem. It's read-only here.
+    To customize it, <%= link_to 'create a same-named DB override', new_agent_path(from_builtin: name) %> — your DB agent will shadow this one.
+  </div>
+<% end %>
+
+<div class="meta-card">
+  <h2 style="margin-bottom:8px;">
+    <%= name %>
+    <% if is_db %>
+      <span class="badge source-db">DB</span>
+      <% if @agent.approved? %>
+        <span class="badge status-approved">APPROVED</span>
+      <% else %>
+        <span class="badge status-proposed">PROPOSED</span>
+      <% end %>
+    <% elsif is_builtin %>
+      <span class="badge source-builtin">BUILTIN</span>
+    <% else %>
+      <span class="badge source-file">FILE</span>
+    <% end %>
+  </h2>
+  <p class="text-muted"><%= description %></p>
+  <div class="meta-grid" style="margin-top:16px;">
+    <div class="meta-item"><label>Model</label><span><%= model || '(default)' %></span></div>
+    <div class="meta-item"><label>Max rounds</label><span><%= max_rounds || '(default)' %></span></div>
+    <div class="meta-item"><label>Tool whitelist</label><span><%= tools.empty? ? '(default set)' : tools.join(', ') %></span></div>
+    <% if is_db %>
+      <div class="meta-item"><label>Updated</label><span><%= @agent.updated_at.strftime('%Y-%m-%d %H:%M') %></span></div>
+      <div class="meta-item"><label>Versions</label><span><%= @agent.versions.count %></span></div>
+      <div class="meta-item"><label>Times invoked</label><span><%= @agent.use_count %></span></div>
+      <div class="meta-item"><label>Last invoked</label><span><%= @agent.last_used_at&.strftime('%Y-%m-%d %H:%M') || 'never' %></span></div>
+      <% if @agent.approved? %>
+        <div class="meta-item"><label>Approved by</label><span><%= @agent.approved_by || '—' %></span></div>
+        <div class="meta-item"><label>Approved at</label><span><%= @agent.approved_at&.strftime('%Y-%m-%d %H:%M') || '—' %></span></div>
+      <% end %>
+    <% else %>
+      <div class="meta-item"><label>Path</label><span class="mono"><%= file_key %></span></div>
+    <% end %>
+  </div>
+</div>
+
+<div class="btn-bar">
+  <% if is_db %>
+    <% unless @agent.approved? %>
+      <%= form_with url: approve_agent_path(@agent), method: :post, local: true, style: 'display:inline' do %>
+        <input type="text" name="approved_by" placeholder="Your name (required)" style="padding:7px 10px; border:1px solid #ccc; border-radius:4px; margin-right:6px;">
+        <button type="submit" class="btn btn-danger" data-confirm="Approve this agent? The AI will then be able to invoke it via delegate_task with the configured tool whitelist.">Approve</button>
+      <% end %>
+    <% end %>
+    <%= link_to 'Edit', edit_agent_path(@agent), class: 'btn' %>
+    <%= link_to 'Versions', agent_versions_path(@agent), class: 'btn btn-secondary' %>
+    <%= button_to 'Delete', agent_path(@agent), method: :delete, class: 'btn btn-danger', form: { style: 'display:inline' }, data: { confirm: 'Delete this agent? Past versions remain in history.' } %>
+  <% elsif is_builtin %>
+    <%= link_to 'Create DB override', new_agent_path(from_builtin: name), class: 'btn' %>
+  <% end %>
+</div>
+
+<h3 style="margin-bottom:8px;">Body / instructions</h3>
+<div class="markdown-body"><%= body %></div>
+
+<% if is_db && @versions && @versions.any? %>
+  <h3 style="margin:24px 0 8px;">Recent versions</h3>
+  <div class="versions-list">
+    <% @versions.first(5).each do |v| %>
+      <div class="ver-row">
+        <div>
+          <strong>v<%= v.id %></strong>
+          <span class="ver-meta">— <%= v.created_at.strftime('%Y-%m-%d %H:%M') %> by <%= v.edited_by || 'unknown' %></span>
+          <% if v.status == 'approved' %><span class="badge status-approved">APPROVED</span><% end %>
+          <% if v.change_note.present? %><div class="ver-meta"><%= v.change_note %></div><% end %>
+        </div>
+        <div>
+          <%= link_to 'View', agent_version_path(@agent, v) %>
+          ·
+          <%= link_to 'Diff vs current', diff_agents_path(agent_id: @agent.id, from: v.id) %>
+        </div>
+      </div>
+    <% end %>
+  </div>
+  <% if @versions.size > 5 %>
+    <p style="margin-top:8px;"><%= link_to "See all #{@versions.size} versions →", agent_versions_path(@agent) %></p>
+  <% end %>
+<% end %>

data/app/views/rails_console_ai/memories/_form.html.erb

@@ -0,0 +1,36 @@
+<%= form_with model: @memory, url: form_url, method: form_method, local: true do |f| %>
+  <div class="form-card">
+    <div class="form-row">
+      <label>Name</label>
+      <%= f.text_field :name, value: @memory.name, required: true %>
+    </div>
+
+    <div class="form-row">
+      <label>Description</label>
+      <%= f.text_area :description, value: @memory.description, rows: 14 %>
+      <div class="hint">The fact or pattern you're persisting. Markdown is fine.</div>
+    </div>
+
+    <div class="form-row">
+      <label>Tags (comma-separated)</label>
+      <%= f.text_field :tags, value: Array(@memory.tags).join(', '), placeholder: 'database, sharding' %>
+    </div>
+
+    <hr style="margin: 20px 0; border: 0; border-top: 1px solid #eee;">
+
+    <div class="form-row">
+      <label>Edited by</label>
+      <input type="text" name="edited_by" value="<%= params[:edited_by] %>" placeholder="Your name or handle">
+    </div>
+
+    <div class="form-row">
+      <label>Change note (optional)</label>
+      <input type="text" name="change_note" value="" placeholder="What did you change and why?">
+    </div>
+  </div>
+
+  <div class="btn-bar">
+    <%= f.submit submit_label, class: 'btn' %>
+    <%= link_to 'Cancel', cancel_path, class: 'btn btn-secondary' %>
+  </div>
+<% end %>

data/app/views/rails_console_ai/memories/diff.html.erb

@@ -0,0 +1,19 @@
+<%= link_to '← Back to memory', memory_path(@memory), class: 'back-link' %>
+
+<h2 style="margin-bottom:8px;">Diff — <%= @memory.name %></h2>
+<p class="text-muted" style="margin-bottom:16px;">
+  Version #<%= @from.id %> (<%= @from.created_at.strftime('%Y-%m-%d %H:%M') %>) → <%= @to_label %>
+</p>
+
+<h3 style="margin:16px 0 6px;">Description</h3>
+<%= render_text_diff(@from.description, @to_description, left_label: "v##{@from.id}", right_label: @to_label) %>
+
+<h3 style="margin:24px 0 6px;">Tags</h3>
+<%= render_json_diff(Array(@from.tags), @to_tags, left_label: "v##{@from.id}", right_label: @to_label) %>
+
+<div class="btn-bar" style="margin-top:24px;">
+  <% if @to.nil? %>
+    <%= button_to "Restore v##{@from.id}", restore_memory_version_path(@memory, @from), method: :post, class: 'btn btn-danger', data: { confirm: 'Restoring will overwrite the current memory (a new version row is created).' } %>
+  <% end %>
+  <%= link_to 'Back', memory_path(@memory), class: 'btn btn-secondary' %>
+</div>

data/app/views/rails_console_ai/memories/edit.html.erb

@@ -0,0 +1,7 @@
+<%= link_to '← Back to memory', memory_path(@memory), class: 'back-link' %>
+<h2 style="margin-bottom:16px;">Edit memory</h2>
+<%= render 'form',
+      form_url: memory_path(@memory),
+      form_method: :patch,
+      submit_label: 'Save changes',
+      cancel_path: memory_path(@memory) %>

data/app/views/rails_console_ai/memories/index.html.erb

@@ -0,0 +1,67 @@
+<div class="btn-bar">
+  <%= link_to 'New memory', new_memory_path, class: 'btn' %>
+  <% if @sort == 'used' %>
+    <%= link_to 'Sort: alphabetical', memories_path(q: @q), class: 'btn btn-secondary' %>
+  <% else %>
+    <%= link_to 'Sort: most used', memories_path(q: @q, sort: 'used'), class: 'btn btn-secondary' %>
+  <% end %>
+  <form method="get" action="<%= memories_path %>" style="margin-left:auto;">
+    <input type="text" name="q" value="<%= @q %>" placeholder="Search memories…" style="padding:6px 10px; border:1px solid #ccc; border-radius:4px;">
+    <% if @sort.present? %><input type="hidden" name="sort" value="<%= @sort %>"><% end %>
+  </form>
+</div>
+
+<% if @memories.empty? %>
+  <div class="meta-card">
+    <p class="text-muted">No memories yet. <%= link_to 'Create one', new_memory_path %> or drop a Markdown file in <code>.rails_console_ai/memories/</code>.</p>
+  </div>
+<% else %>
+  <table>
+    <thead>
+      <tr>
+        <th>Name</th>
+        <th>Description</th>
+        <th>Tags</th>
+        <th>Source</th>
+        <th title="Number of times the AI recalled this memory (DB only)">Uses</th>
+        <th>Last used</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @memories.each do |m| %>
+        <% link_id = m['id'] || m['name'] %>
+        <tr>
+          <td><strong><%= link_to m['name'], memory_path(link_id) %></strong></td>
+          <td class="query-cell"><%= m['description'].to_s[0, 140] %></td>
+          <td>
+            <% Array(m['tags']).each do |t| %><span class="tag"><%= t %></span><% end %>
+          </td>
+          <td>
+            <% if m['source'] == :db %>
+              <span class="badge source-db">DB</span>
+            <% else %>
+              <span class="badge source-file">FILE</span>
+            <% end %>
+          </td>
+          <td>
+            <% if m['source'] == :db %>
+              <%= m['use_count'] || 0 %>
+            <% else %>
+              <span class="text-muted">—</span>
+            <% end %>
+          </td>
+          <td class="text-muted" style="font-size:12px;">
+            <%= m['last_used_at']&.strftime('%Y-%m-%d %H:%M') || '—' %>
+          </td>
+          <td>
+            <%= link_to 'View', memory_path(link_id) %>
+            <% if m['source'] == :db %>
+              · <%= link_to 'Edit', edit_memory_path(m['id']) %>
+            <% end %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% end %>

data/app/views/rails_console_ai/memories/new.html.erb

@@ -0,0 +1,23 @@
+<%= link_to '← All memories', memories_path, class: 'back-link' %>
+<h2 style="margin-bottom:16px;">New memory</h2>
+
+<%= form_with url: import_memories_path, method: :post, local: true do %>
+  <div class="form-card" style="background:#f8f9fa;">
+    <div class="form-row" style="margin-bottom:8px;">
+      <label>Paste a .md file (optional)</label>
+      <textarea name="content" rows="12" placeholder="---&#10;name: My memory&#10;tags: [database]&#10;---&#10;&#10;The fact or pattern …"></textarea>
+      <div class="hint">
+        Paste the full contents of a Markdown file (YAML frontmatter + body) — same
+        format as <code>.rails_console_ai/memories/*.md</code>. The fields below will
+        be prefilled from the paste.
+      </div>
+    </div>
+    <button type="submit" class="btn btn-secondary">Parse pasted content ↓</button>
+  </div>
+<% end %>
+
+<%= render 'form',
+      form_url: memories_path,
+      form_method: :post,
+      submit_label: 'Create memory',
+      cancel_path: memories_path %>

data/app/views/rails_console_ai/memories/show.html.erb

@@ -0,0 +1,65 @@
+<%
+  is_db = @memory.is_a?(RailsConsoleAi::Memory)
+  name = is_db ? @memory.name : @memory['name']
+  description = is_db ? @memory.description : @memory['description']
+  tags = is_db ? Array(@memory.tags) : Array(@memory['tags'])
+  file_key = is_db ? nil : @memory['file_key']
+%>
+
+<%= link_to '← All memories', memories_path, class: 'back-link' %>
+
+<div class="meta-card">
+  <h2 style="margin-bottom:8px;">
+    <%= name %>
+    <% if is_db %>
+      <span class="badge source-db">DB</span>
+    <% else %>
+      <span class="badge source-file">FILE</span>
+    <% end %>
+  </h2>
+  <div class="meta-grid" style="margin-top:16px;">
+    <div class="meta-item"><label>Tags</label><span><%= tags.empty? ? '—' : tags.join(', ') %></span></div>
+    <% if is_db %>
+      <div class="meta-item"><label>Updated</label><span><%= @memory.updated_at.strftime('%Y-%m-%d %H:%M') %></span></div>
+      <div class="meta-item"><label>Versions</label><span><%= @memory.versions.count %></span></div>
+      <div class="meta-item"><label>Times recalled</label><span><%= @memory.use_count %></span></div>
+      <div class="meta-item"><label>Last recalled</label><span><%= @memory.last_used_at&.strftime('%Y-%m-%d %H:%M') || 'never' %></span></div>
+    <% else %>
+      <div class="meta-item"><label>Path</label><span class="mono"><%= file_key %></span></div>
+    <% end %>
+  </div>
+</div>
+
+<div class="btn-bar">
+  <% if is_db %>
+    <%= link_to 'Edit', edit_memory_path(@memory), class: 'btn' %>
+    <%= link_to 'Versions', memory_versions_path(@memory), class: 'btn btn-secondary' %>
+    <%= button_to 'Delete', memory_path(@memory), method: :delete, class: 'btn btn-danger', form: { style: 'display:inline' },data: { confirm: 'Delete this memory? Past versions remain in history.' } %>
+  <% end %>
+</div>
+
+<h3 style="margin-bottom:8px;">Description</h3>
+<div class="markdown-body"><%= description %></div>
+
+<% if is_db && @versions && @versions.any? %>
+  <h3 style="margin:24px 0 8px;">Recent versions</h3>
+  <div class="versions-list">
+    <% @versions.first(5).each do |v| %>
+      <div class="ver-row">
+        <div>
+          <strong>v<%= v.id %></strong>
+          <span class="ver-meta">— <%= v.created_at.strftime('%Y-%m-%d %H:%M') %> by <%= v.edited_by || 'unknown' %></span>
+          <% if v.change_note.present? %><div class="ver-meta"><%= v.change_note %></div><% end %>
+        </div>
+        <div>
+          <%= link_to 'View', memory_version_path(@memory, v) %>
+          ·
+          <%= link_to 'Diff vs current', diff_memories_path(memory_id: @memory.id, from: v.id) %>
+        </div>
+      </div>
+    <% end %>
+  </div>
+  <% if @versions.size > 5 %>
+    <p style="margin-top:8px;"><%= link_to "See all #{@versions.size} versions →", memory_versions_path(@memory) %></p>
+  <% end %>
+<% end %>

data/app/views/rails_console_ai/memory_versions/index.html.erb

@@ -0,0 +1,26 @@
+<%= link_to '← Back to memory', memory_path(@memory), class: 'back-link' %>
+
+<h2 style="margin-bottom:16px;">Versions — <%= @memory.name %></h2>
+
+<% if @versions.empty? %>
+  <div class="meta-card"><p class="text-muted">No versions recorded yet.</p></div>
+<% else %>
+  <div class="versions-list">
+    <% @versions.each do |v| %>
+      <div class="ver-row">
+        <div>
+          <strong>v<%= v.id %></strong>
+          <span class="ver-meta">— <%= v.created_at.strftime('%Y-%m-%d %H:%M:%S') %> by <%= v.edited_by || 'unknown' %></span>
+          <% if v.change_note.present? %><div class="ver-meta"><%= v.change_note %></div><% end %>
+        </div>
+        <div>
+          <%= link_to 'View', memory_version_path(@memory, v) %>
+          ·
+          <%= link_to 'Diff vs current', diff_memories_path(memory_id: @memory.id, from: v.id) %>
+          ·
+          <%= button_to 'Restore', restore_memory_version_path(@memory, v), method: :post, class: 'btn btn-secondary', form: { style: 'display:inline' },data: { confirm: "Restore version ##{v.id}? A new version row will be created from this snapshot." } %>
+        </div>
+      </div>
+    <% end %>
+  </div>
+<% end %>

data/app/views/rails_console_ai/memory_versions/show.html.erb

@@ -0,0 +1,21 @@
+<%= link_to '← All versions', memory_versions_path(@memory), class: 'back-link' %>
+
+<div class="meta-card">
+  <h2 style="margin-bottom:8px;"><%= @version.name %> <span class="badge source-db">v<%= @version.id %></span></h2>
+  <div class="meta-grid" style="margin-top:16px;">
+    <div class="meta-item"><label>Edited by</label><span><%= @version.edited_by || '—' %></span></div>
+    <div class="meta-item"><label>At</label><span><%= @version.created_at.strftime('%Y-%m-%d %H:%M:%S') %></span></div>
+    <div class="meta-item"><label>Tags</label><span><%= Array(@version.tags).join(', ').presence || '—' %></span></div>
+  </div>
+  <% if @version.change_note.present? %>
+    <p style="margin-top:12px;"><strong>Change note:</strong> <%= @version.change_note %></p>
+  <% end %>
+</div>
+
+<div class="btn-bar">
+  <%= button_to "Restore this version", restore_memory_version_path(@memory, @version), method: :post, class: 'btn btn-danger', data: { confirm: "Restore version ##{@version.id}? Current memory will be overwritten." } %>
+  <%= link_to 'Diff vs current', diff_memories_path(memory_id: @memory.id, from: @version.id), class: 'btn btn-secondary' %>
+</div>
+
+<h3 style="margin-top:24px; margin-bottom:8px;">Description</h3>
+<div class="markdown-body"><%= @version.description %></div>

data/app/views/rails_console_ai/skill_versions/index.html.erb

@@ -0,0 +1,28 @@
+<%= link_to '← Back to skill', skill_path(@skill), class: 'back-link' %>
+
+<h2 style="margin-bottom:16px;">Versions — <%= @skill.name %></h2>
+
+<% if @versions.empty? %>
+  <div class="meta-card"><p class="text-muted">No versions recorded yet.</p></div>
+<% else %>
+  <div class="versions-list">
+    <% @versions.each do |v| %>
+      <div class="ver-row">
+        <div>
+          <strong>v<%= v.id %></strong>
+          <span class="ver-meta">— <%= v.created_at.strftime('%Y-%m-%d %H:%M:%S') %> by <%= v.edited_by || 'unknown' %></span>
+          <% if v.status == 'approved' %><span class="badge status-approved">APPROVED</span>
+          <% elsif v.status == 'proposed' %><span class="badge status-proposed">PROPOSED</span><% end %>
+          <% if v.change_note.present? %><div class="ver-meta"><%= v.change_note %></div><% end %>
+        </div>
+        <div>
+          <%= link_to 'View', skill_version_path(@skill, v) %>
+          ·
+          <%= link_to 'Diff vs current', diff_skills_path(skill_id: @skill.id, from: v.id) %>
+          ·
+          <%= button_to 'Restore', restore_skill_version_path(@skill, v), method: :post, class: 'btn btn-secondary', form: { style: 'display:inline' }, data: { confirm: "Restore version ##{v.id}? Restoring reverts the skill to PROPOSED and a new version row will be created." } %>
+        </div>
+      </div>
+    <% end %>
+  </div>
+<% end %>

data/app/views/rails_console_ai/skill_versions/show.html.erb

@@ -0,0 +1,23 @@
+<%= link_to '← All versions', skill_versions_path(@skill), class: 'back-link' %>
+
+<div class="meta-card">
+  <h2 style="margin-bottom:8px;"><%= @version.name %> <span class="badge source-db">v<%= @version.id %></span></h2>
+  <p class="text-muted"><%= @version.description %></p>
+  <div class="meta-grid" style="margin-top:16px;">
+    <div class="meta-item"><label>Edited by</label><span><%= @version.edited_by || '—' %></span></div>
+    <div class="meta-item"><label>At</label><span><%= @version.created_at.strftime('%Y-%m-%d %H:%M:%S') %></span></div>
+    <div class="meta-item"><label>Tags</label><span><%= Array(@version.tags).join(', ').presence || '—' %></span></div>
+    <div class="meta-item"><label>Bypass guards</label><span><%= Array(@version.bypass_guards_for_methods).join(', ').presence || '—' %></span></div>
+  </div>
+  <% if @version.change_note.present? %>
+    <p style="margin-top:12px;"><strong>Change note:</strong> <%= @version.change_note %></p>
+  <% end %>
+</div>
+
+<div class="btn-bar">
+  <%= button_to "Restore this version", restore_skill_version_path(@skill, @version), method: :post, class: 'btn btn-danger', data: { confirm: "Restore version ##{@version.id}? Current skill will be overwritten." } %>
+  <%= link_to 'Diff vs current', diff_skills_path(skill_id: @skill.id, from: @version.id), class: 'btn btn-secondary' %>
+</div>
+
+<h3 style="margin-top:24px; margin-bottom:8px;">Recipe</h3>
+<div class="markdown-body"><%= @version.body %></div>

data/app/views/rails_console_ai/skills/_form.html.erb

@@ -0,0 +1,65 @@
+<% if @skill.persisted? && @skill.respond_to?(:approved?) && @skill.approved? %>
+  <div class="flash flash-alert" style="margin-bottom:16px;">
+    Heads up: this skill is currently <strong>approved</strong>. Editing it will revert its status to <strong>proposed</strong> and the AI won't be able to activate it again until someone re-approves it.
+  </div>
+<% elsif !@skill.persisted? %>
+  <div class="flash flash-notice" style="margin-bottom:16px;">
+    New DB skills start as <strong>proposed</strong>. After saving, an approver (likely you) needs to click the Approve button on the show page before the AI can activate this skill.
+  </div>
+<% end %>
+
+<%= form_with model: @skill, url: form_url, method: form_method, local: true do |f| %>
+  <div class="form-card">
+    <div class="form-row">
+      <label>Name</label>
+      <%= f.text_field :name, value: @skill.name, required: true %>
+    </div>
+
+    <div class="form-row">
+      <label>Description</label>
+      <%= f.text_field :description, value: @skill.description, placeholder: 'One-line description of when to use this skill' %>
+    </div>
+
+    <div class="form-row">
+      <label>Body (markdown)</label>
+      <%= f.text_area :body, value: @skill.body, rows: 18 %>
+      <div class="hint">Include "## When to use", "## Recipe" (numbered steps with code blocks), "## Notes".</div>
+    </div>
+
+    <div class="form-row">
+      <label>Tags (comma-separated)</label>
+      <%= f.text_field :tags, value: Array(@skill.tags).join(', '), placeholder: 'booking-page, admin' %>
+    </div>
+
+    <div class="form-row">
+      <label>Bypass guards for methods (one per line)</label>
+      <%= f.text_area :bypass_guards_for_methods, value: Array(@skill.bypass_guards_for_methods).join("\n"), rows: 4 %>
+      <div class="hint">
+        Two forms accepted — anything else is ignored:
+        <ul style="margin:6px 0 0 18px; padding:0;">
+          <li><code>ClassName#method</code> — instance method, e.g. <code>BookingPage#save!</code></li>
+          <li><code>ClassName.method</code> — class (singleton) method, e.g. <code>User.create_admin!</code></li>
+        </ul>
+        Namespaced classes work: <code>Acme::Booking#destroy</code>. The <code>!</code> is part of the match, so <code>save</code> and <code>save!</code> are different specs. While the skill is active, calls to these methods skip the configured safety guards (DB writes, HTTP mutations, email, etc.) <strong>for that tool-call only</strong>.
+      </div>
+    </div>
+
+    <hr style="margin: 20px 0; border: 0; border-top: 1px solid #eee;">
+
+    <div class="form-row">
+      <label>Edited by</label>
+      <input type="text" name="edited_by" value="<%= params[:edited_by] || cookies[:rca_edited_by] %>" placeholder="Your name or handle">
+      <div class="hint">Recorded with this version. Free text — the gem does not assume authentication beyond the admin login.</div>
+    </div>
+
+    <div class="form-row">
+      <label>Change note (optional)</label>
+      <input type="text" name="change_note" value="" placeholder="What did you change and why?">
+    </div>
+  </div>
+
+  <div class="btn-bar">
+    <%= f.submit submit_label, class: 'btn' %>
+    <%= link_to 'Cancel', cancel_path, class: 'btn btn-secondary' %>
+  </div>
+<% end %>

data/app/views/rails_console_ai/skills/diff.html.erb

@@ -0,0 +1,22 @@
+<%= link_to '← Back to skill', skill_path(@skill), class: 'back-link' %>
+
+<h2 style="margin-bottom:8px;">Diff — <%= @skill.name %></h2>
+<p class="text-muted" style="margin-bottom:16px;">
+  Version #<%= @from.id %> (<%= @from.created_at.strftime('%Y-%m-%d %H:%M') %>) → <%= @to_label %>
+</p>
+
+<h3 style="margin:16px 0 6px;">Body</h3>
+<%= render_text_diff(@from.body, @to_body, left_label: "v##{@from.id}", right_label: @to_label) %>
+
+<h3 style="margin:24px 0 6px;">Tags</h3>
+<%= render_json_diff(Array(@from.tags), @to_tags, left_label: "v##{@from.id}", right_label: @to_label) %>
+
+<h3 style="margin:24px 0 6px;">Bypass guards</h3>
+<%= render_json_diff(Array(@from.bypass_guards_for_methods), @to_bypass, left_label: "v##{@from.id}", right_label: @to_label) %>
+
+<div class="btn-bar" style="margin-top:24px;">
+  <% if @to.nil? %>
+    <%= button_to "Restore v##{@from.id}", restore_skill_version_path(@skill, @from), method: :post, class: 'btn btn-danger', data: { confirm: 'Restoring will overwrite the current skill (a new version row is created).' } %>
+  <% end %>
+  <%= link_to 'Back', skill_path(@skill), class: 'btn btn-secondary' %>
+</div>

data/app/views/rails_console_ai/skills/edit.html.erb

@@ -0,0 +1,7 @@
+<%= link_to '← Back to skill', skill_path(@skill), class: 'back-link' %>
+<h2 style="margin-bottom:16px;">Edit skill</h2>
+<%= render 'form',
+      form_url: skill_path(@skill),
+      form_method: :patch,
+      submit_label: 'Save changes',
+      cancel_path: skill_path(@skill) %>

data/app/views/rails_console_ai/skills/index.html.erb

@@ -0,0 +1,79 @@
+<div class="btn-bar">
+  <%= link_to 'New skill', new_skill_path, class: 'btn' %>
+  <% if @sort == 'used' %>
+    <%= link_to 'Sort: alphabetical', skills_path(q: @q), class: 'btn btn-secondary' %>
+  <% else %>
+    <%= link_to 'Sort: most used', skills_path(q: @q, sort: 'used'), class: 'btn btn-secondary' %>
+  <% end %>
+  <form method="get" action="<%= skills_path %>" style="margin-left:auto;">
+    <input type="text" name="q" value="<%= @q %>" placeholder="Search skills…" style="padding:6px 10px; border:1px solid #ccc; border-radius:4px;">
+    <% if @sort.present? %><input type="hidden" name="sort" value="<%= @sort %>"><% end %>
+  </form>
+</div>
+
+<% proposed_count = @skills.count { |s| s['source'] == :db && s['status'] != 'approved' } %>
+<% if proposed_count > 0 %>
+  <div class="flash flash-alert" style="margin-bottom:16px;">
+    <strong><%= proposed_count %></strong> skill<%= proposed_count == 1 ? '' : 's' %> awaiting approval. The AI cannot activate them until a human approves.
+  </div>
+<% end %>
+
+<% if @skills.empty? %>
+  <div class="meta-card">
+    <p class="text-muted">No skills yet. <%= link_to 'Create one', new_skill_path %> or drop a Markdown file in <code>.rails_console_ai/skills/</code>.</p>
+  </div>
+<% else %>
+  <table>
+    <thead>
+      <tr>
+        <th>Name</th>
+        <th>Description</th>
+        <th>Tags</th>
+        <th>Source / Status</th>
+        <th title="Number of times the AI activated this skill (DB only)">Uses</th>
+        <th>Last used</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @skills.each do |s| %>
+        <% link_id = s['id'] || s['name'] %>
+        <tr>
+          <td><strong><%= link_to s['name'], skill_path(link_id) %></strong></td>
+          <td class="query-cell"><%= s['description'] %></td>
+          <td>
+            <% Array(s['tags']).each do |t| %><span class="tag"><%= t %></span><% end %>
+          </td>
+          <td>
+            <% if s['source'] == :db %>
+              <span class="badge source-db">DB</span>
+              <% if s['status'] == 'approved' %>
+                <span class="badge status-approved">APPROVED</span>
+              <% else %>
+                <span class="badge status-proposed">PROPOSED</span>
+              <% end %>
+            <% else %>
+              <span class="badge source-file">FILE</span>
+            <% end %>
+          </td>
+          <td>
+            <% if s['source'] == :db %>
+              <%= s['use_count'] || 0 %>
+            <% else %>
+              <span class="text-muted">—</span>
+            <% end %>
+          </td>
+          <td class="text-muted" style="font-size:12px;">
+            <%= s['last_used_at']&.strftime('%Y-%m-%d %H:%M') || '—' %>
+          </td>
+          <td>
+            <%= link_to 'View', skill_path(link_id) %>
+            <% if s['source'] == :db %>
+              · <%= link_to 'Edit', edit_skill_path(s['id']) %>
+            <% end %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% end %>

data/app/views/rails_console_ai/skills/new.html.erb

@@ -0,0 +1,25 @@
+<%= link_to '← All skills', skills_path, class: 'back-link' %>
+<h2 style="margin-bottom:16px;">New skill</h2>
+
+<%= form_with url: import_skills_path, method: :post, local: true do %>
+  <div class="form-card" style="background:#f8f9fa;">
+    <div class="form-row" style="margin-bottom:8px;">
+      <label>Paste a .md file (optional)</label>
+      <textarea name="content" rows="14" placeholder="---&#10;name: My skill&#10;description: What it does&#10;tags: [admin]&#10;bypass_guards_for_methods: []&#10;---&#10;&#10;## When to use&#10;…&#10;&#10;## Recipe&#10;1. …"></textarea>
+      <div class="hint">
+        Paste the full contents of a Markdown file (YAML frontmatter between
+        <code>---</code> lines, then a markdown body) — same format as
+        <code>.rails_console_ai/skills/*.md</code>. The fields below will be
+        prefilled from the paste. You can review and tweak before clicking
+        <strong>Create skill</strong>.
+      </div>
+    </div>
+    <button type="submit" class="btn btn-secondary">Parse pasted content ↓</button>
+  </div>
+<% end %>
+
+<%= render 'form',
+      form_url: skills_path,
+      form_method: :post,
+      submit_label: 'Create skill',
+      cancel_path: skills_path %>