completion-kit 0.4.8 → 0.5.1

data/app/views/completion_kit/provider_credentials/_form.html.erb

@@ -27,7 +27,7 @@
     </div>
 
     <div class="ck-actions">
-      <%= link_to "Cancel", provider_credentials_path, class: ck_button_classes(:light, variant: :outline) %>
+      <%= link_to "Cancel", provider_credentials_path, class: ck_button_classes(:light, variant: :outline), tabindex: "0" %>
       <%= form.submit(provider_credential.persisted? ? "Save provider" : "Create provider", class: ck_button_classes(:dark)) %>
     </div>
 

data/app/views/completion_kit/provider_credentials/index.html.erb

@@ -2,9 +2,11 @@
   <%= turbo_stream_from "completion_kit_provider_#{pc.id}" %>
 <% end %>
 
+<%= render "completion_kit/shared/settings_nav", section_label: "Providers" %>
+
 <section class="ck-page-header">
   <div>
-    <h1 class="ck-title">Settings</h1>
+    <h1 class="ck-title">Providers</h1>
     <p class="ck-lead">API keys for LLM providers. These are used for both generating prompt completions and running judge evaluations.</p>
   </div>
   <div class="ck-actions">

data/app/views/completion_kit/runs/_form.html.erb

@@ -115,9 +115,24 @@
           </div>
           <div class="ck-metric-divider"><span>or pick individually</span></div>
         <% end %>
-        <div class="ck-metric-checkboxes">
+
+        <% available_filter_tags = @all_metrics.flat_map(&:tags).uniq.sort_by(&:name) %>
+        <% if available_filter_tags.any? %>
+          <div class="ck-metric-tag-filter" data-metric-tag-filter>
+            <span class="ck-metric-tag-filter__label">Filter metrics by tag</span>
+            <% available_filter_tags.each do |tag| %>
+              <button type="button"
+                      class="tag-mark tag-mark--off ck-metric-tag-filter__chip"
+                      style="--mark-color: var(--tag-<%= tag.color %>);"
+                      data-filter-tag="<%= tag.name %>"
+                      onclick="ckToggleMetricGroupFilter(this)"><%= tag.name %></button>
+            <% end %>
+          </div>
+        <% end %>
+
+        <div class="ck-metric-checkboxes" data-metric-checkboxes>
           <% @all_metrics.each do |metric| %>
-            <label class="ck-checkbox-label">
+            <label class="ck-checkbox-label" data-metric-tags="<%= metric.tag_names.join(",") %>">
               <%= check_box_tag "run[metric_ids][]", metric.id, run.metric_ids.include?(metric.id), class: "ck-checkbox", id: "run_metric_#{metric.id}" %>
               <span class="ck-checkbox-label__box" aria-hidden="true"></span>
               <span class="ck-checkbox-label__body">
@@ -125,6 +140,11 @@
                 <% if metric.instruction.present? %>
                   <span class="ck-checkbox-label__hint"><%= truncate(metric.instruction.to_s, length: 90) %></span>
                 <% end %>
+                <% if metric.tags.any? %>
+                  <div class="tag-marks-row">
+                    <%= render "completion_kit/tags/marks", tags: metric.tags %>
+                  </div>
+                <% end %>
               </span>
             </label>
           <% end %>
@@ -248,8 +268,10 @@ document.querySelectorAll('input[name="run[metric_ids][]"]').forEach(function(cb
 updateRunForm();
     </script>
 
+    <%= render "completion_kit/tags/picker", record: run, param_namespace: :run %>
+
     <div class="ck-actions">
-      <%= link_to "Cancel", run.persisted? ? run_path(run) : runs_path, class: ck_button_classes(:light, variant: :outline) %>
+      <%= link_to "Cancel", run.persisted? ? run_path(run) : runs_path, class: ck_button_classes(:light, variant: :outline), tabindex: "0" %>
       <%= form.submit(run.persisted? ? "Save run" : "Create run", class: ck_button_classes(:dark), id: "run-submit") %>
     </div>
   </div>

data/app/views/completion_kit/runs/_row.html.erb

@@ -13,6 +13,11 @@
           <%= link_to run.dataset.name, dataset_path(run.dataset), class: "ck-runs-table__config-link", onclick: "event.stopPropagation();" %>
         <% end %>
       </div>
+      <% if run.tags.any? %>
+        <div class="tag-marks-row">
+          <%= render "completion_kit/tags/marks", tags: run.tags %>
+        </div>
+      <% end %>
     </div>
   </td>
   <td>

data/app/views/completion_kit/runs/index.html.erb

@@ -8,6 +8,11 @@
   </div>
 </section>
 
+<%= render "completion_kit/tags/filter_bar",
+      available: @available_tags,
+      selected: @selected_tags,
+      base_path: runs_path %>
+
 <% if @runs.any? %>
   <table class="ck-results-table ck-runs-table">
     <thead>
@@ -26,6 +31,10 @@
       <% end %>
     </tbody>
   </table>
+<% elsif @selected_tags.any? %>
+  <div class="ck-empty">
+    <p>No runs match these tags. <%= link_to "Clear filters", runs_path, class: "ck-link" %>.</p>
+  </div>
 <% else %>
   <div class="ck-empty">No runs yet.&ensp;<%= link_to "Create your first run →", new_run_path, class: "ck-link" %></div>
 <% end %>

data/app/views/completion_kit/runs/show.html.erb

@@ -7,6 +7,12 @@
 
 <%= render "status_header", run: @run %>
 
+<% if @run.tags.any? %>
+  <div class="tag-marks-row tag-marks-row--header">
+    <%= render "completion_kit/tags/marks", tags: @run.tags %>
+  </div>
+<% end %>
+
 <% if @run.dataset %>
   <% dataset_lines = @run.dataset.csv_data.to_s.lines %>
   <% dataset_preview_lines = dataset_lines.first(50) %>

data/app/views/completion_kit/shared/_settings_nav.html.erb

@@ -0,0 +1,9 @@
+<p class="ck-settings-kicker">
+  Settings <span class="ck-settings-kicker__sep">/</span>
+  <% link = local_assigns[:section_link] %>
+  <%= link ? link_to(section_label, link, class: "ck-settings-kicker__link") : section_label %>
+  <% if local_assigns[:trail].present? %>
+    <span class="ck-settings-kicker__sep">/</span>
+    <%= trail.html_safe %>
+  <% end %>
+</p>

data/app/views/completion_kit/tags/_filter_bar.html.erb

@@ -0,0 +1,15 @@
+<% if available.any? %>
+  <div class="ck-tag-filter">
+    <span class="ck-tag-filter__label">Filter by tag</span>
+    <% available.each do |tag| %>
+      <% on = selected.any? { |s| s.id == tag.id } %>
+      <%= link_to tag.name,
+            tag_filter_url(base_path, selected, tag),
+            class: ["tag-mark", ("tag-mark--off" unless on)].compact.join(" "),
+            style: "--mark-color: var(--tag-#{tag.color});" %>
+    <% end %>
+    <% if selected.any? %>
+      <%= link_to "× clear", base_path, class: "ck-tag-filter__clear" %>
+    <% end %>
+  </div>
+<% end %>

data/app/views/completion_kit/tags/_form.html.erb

@@ -0,0 +1,40 @@
+<%= form_with(model: tag, local: true) do |form| %>
+  <div class="ck-card ck-form-card">
+    <% name_error = tag.errors[:name].first %>
+    <div class="ck-field">
+      <%= form.label :name, "Tag name", class: "ck-label" %>
+      <%= form.text_field :name,
+            id: "tag_name",
+            class: ["ck-input", ("ck-input--error" if name_error)].compact.join(" "),
+            placeholder: "e.g. production",
+            autofocus: true,
+            "aria-invalid": name_error ? "true" : nil %>
+      <% if name_error %>
+        <p class="ck-field-error" role="alert"><%= name_error %></p>
+      <% elsif !tag.persisted? %>
+        <p class="ck-hint">Color is auto-assigned from a 10-color palette.</p>
+      <% end %>
+    </div>
+
+<div class="ck-actions">
+      <% if tag.persisted? %>
+        <% applied_n = tag.taggings.count %>
+        <% confirm = if applied_n.zero?
+             "Delete \"#{tag.name}\"? It's not currently applied to anything."
+           else
+             "Delete \"#{tag.name}\"? It's currently applied to #{pluralize(applied_n, 'item')} — they'll lose this tag."
+           end %>
+        <%= button_to tag_path(tag), method: :delete,
+              form_class: "inline-block",
+              class: "ck-icon-btn",
+              title: "Delete tag",
+              "aria-label": "Delete tag",
+              data: { turbo_confirm: confirm } do %>
+          <%= heroicon_tag "trash", variant: :outline, size: 16, "aria-hidden": "true" %>
+        <% end %>
+      <% end %>
+      <%= link_to "Cancel", tags_path, class: ck_button_classes(:light, variant: :outline), tabindex: "0" %>
+      <%= form.submit(tag.persisted? ? "Save tag" : "Create tag", class: ck_button_classes(:dark)) %>
+    </div>
+  </div>
+<% end %>

data/app/views/completion_kit/tags/_marks.html.erb

@@ -0,0 +1,3 @@
+<% Array(tags).each do |tag| %>
+  <span class="tag-mark" style="--mark-color: var(--tag-<%= tag.color %>);"><%= tag.name %></span>
+<% end %>

data/app/views/completion_kit/tags/_picker.html.erb

@@ -0,0 +1,20 @@
+<div class="ck-field">
+  <% label_text = local_assigns[:label].presence || "#{param_namespace.to_s.titleize} tags" %>
+  <%= label_tag "#{param_namespace}_tags", label_text, class: "ck-label" %>
+  <% all_tags = CompletionKit::Tag.order(:name) %>
+  <% selected_ids = record.persisted? ? record.tags.pluck(:id) : [] %>
+  <div class="ck-tag-picker">
+    <% all_tags.each do |tag| %>
+      <% checked = selected_ids.include?(tag.id) %>
+      <label class="tag-mark" style="--mark-color: var(--tag-<%= tag.color %>);">
+        <%= check_box_tag "#{param_namespace}[tag_names][]", tag.name, checked, hidden: true %>
+        <%= tag.name %>
+      </label>
+    <% end %>
+    <%= text_field_tag "#{param_namespace}[tag_names][]", "",
+          id: "#{param_namespace}_tags",
+          class: "ck-tag-picker__input",
+          placeholder: all_tags.any? ? "+ create tag" : "+ create first tag",
+          autocomplete: "off" %>
+  </div>
+</div>

data/app/views/completion_kit/tags/edit.html.erb

@@ -0,0 +1,20 @@
+<% original = @tag.name_was.presence || "tag" %>
+<% display_name = @tag.name.presence || original %>
+<% pill = content_tag(:span,
+       content_tag(:span, display_name, id: "tag-pill-text", data: { placeholder: original }),
+       id: "tag-breadcrumb-pill",
+       class: "tag-mark",
+       style: "--mark-color: var(--tag-#{@tag.color});") %>
+
+<%= render "completion_kit/shared/settings_nav",
+      section_label: "Tags",
+      section_link: tags_path,
+      trail: pill %>
+
+<section class="ck-page-header">
+  <div>
+    <h1 class="ck-title">Edit tag</h1>
+  </div>
+</section>
+
+<%= render "form", tag: @tag %>

data/app/views/completion_kit/tags/index.html.erb

@@ -0,0 +1,45 @@
+<%= render "completion_kit/shared/settings_nav", section_label: "Tags" %>
+
+<section class="ck-page-header">
+  <div>
+    <h1 class="ck-title">Tags</h1>
+    <p class="ck-lead">Domain labels for organizing metrics, prompts, runs, and datasets.</p>
+  </div>
+  <div class="ck-actions">
+    <%= link_to "New tag", new_tag_path, class: ck_button_classes(:dark) %>
+  </div>
+</section>
+
+<% if @tags.any? %>
+  <table class="ck-results-table ck-tags-table">
+    <thead>
+      <tr>
+        <th>Tag</th>
+        <th>Applied to</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @tags.each do |tag| %>
+        <% count = @tagging_counts.fetch(tag.id, 0) %>
+        <% by_type = @tagging_by_type.select { |(tid, _), _| tid == tag.id } %>
+        <% breakdown = by_type.map { |(_, type), n| pluralize(n, type.demodulize.titleize.downcase) }.join(" · ") %>
+        <tr onclick="window.location='<%= edit_tag_path(tag) %>'" style="cursor: pointer;">
+          <td><span class="tag-mark tag-mark--lg" style="--mark-color: var(--tag-<%= tag.color %>);"><%= tag.name %></span></td>
+          <td class="ck-meta-copy">
+            <% if count.zero? %>
+              <span class="ck-tags-table__unused">Not used yet</span>
+            <% else %>
+              <%= breakdown %>
+            <% end %>
+          </td>
+          <td class="ck-results-table__arrow">&rarr;</td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% else %>
+  <div class="ck-empty">
+    <p>No tags yet. <%= link_to "Create your first tag", new_tag_path, class: "ck-link" %> to start organizing.</p>
+  </div>
+<% end %>

data/app/views/completion_kit/tags/new.html.erb

@@ -0,0 +1,20 @@
+<% display_name = @tag.name.presence.to_s %>
+<% pill = content_tag(:span,
+       content_tag(:span, display_name, id: "tag-pill-text", data: { placeholder: "" }),
+       id: "tag-breadcrumb-pill",
+       class: "tag-mark",
+       style: "--mark-color: var(--tag-#{@tag.color});") %>
+
+<%= render "completion_kit/shared/settings_nav",
+      section_label: "Tags",
+      section_link: tags_path,
+      trail: pill %>
+
+<section class="ck-page-header">
+  <div>
+    <h1 class="ck-title">New tag</h1>
+    <p class="ck-lead">Tags help you filter metrics, prompts, runs, and datasets by domain.</p>
+  </div>
+</section>
+
+<%= render "form", tag: @tag %>

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

@@ -9,6 +9,7 @@
   <%= favicon_link_tag "completion_kit/logo.svg", type: "image/svg+xml" %>
   <%= stylesheet_link_tag "completion_kit/application", media: "all" %>
   <%= javascript_include_tag "turbo", type: "module" %>
+  <%= javascript_include_tag "completion_kit/application", defer: true %>
   <%= action_cable_meta_tag %>
 </head>
 <body class="ck-app">
@@ -22,7 +23,16 @@
         <%= link_to "Metrics", metrics_path, class: request.path.start_with?(metrics_path) || request.path.start_with?(metric_groups_path) ? ck_button_classes(:dark) : ck_button_classes(:light, variant: :outline) %>
         <%= link_to "Datasets", datasets_path, class: active.(datasets_path) %>
         <%= link_to "Runs", runs_path, class: active.(runs_path) %>
-        <%= link_to "Settings", provider_credentials_path, class: active.(provider_credentials_path) %>
+        <% settings_active = request.path.start_with?(provider_credentials_path) || request.path.start_with?(tags_path) %>
+        <details class="ck-settings-menu">
+          <summary class="<%= settings_active ? ck_button_classes(:dark) : ck_button_classes(:light, variant: :outline) %> ck-settings-menu__trigger" aria-label="Settings">
+            Settings
+          </summary>
+          <div class="ck-settings-menu__panel" role="menu">
+            <%= link_to "Providers", provider_credentials_path, class: "ck-settings-menu__item" %>
+            <%= link_to "Tags", tags_path, class: "ck-settings-menu__item" %>
+          </div>
+        </details>
         <%= link_to "API", api_reference_path, class: active.(api_reference_path) %>
         <% if main_app.respond_to?(:logout_path) %>
           <%= button_to "Log out", main_app.logout_path, method: :delete, class: ck_button_classes(:light, variant: :outline) %>
@@ -42,136 +52,5 @@
     <%= yield %>
     </div>
   </main>
-<script>
-document.addEventListener("turbo:load", function() {
-  document.querySelectorAll("[data-local-time]").forEach(function(el) {
-    var d = new Date(el.getAttribute("datetime"));
-    el.textContent = d.toLocaleString(undefined, {year:"numeric",month:"short",day:"numeric",hour:"2-digit",minute:"2-digit"});
-  });
-  ckTickRelativeTimes();
-});
-
-function ckRelativeTime(then) {
-  var seconds = Math.round((Date.now() - then.getTime()) / 1000);
-  if (seconds < 5) return "just now";
-  if (seconds < 60) return "less than a minute";
-  var minutes = Math.round(seconds / 60);
-  if (minutes < 60) return minutes === 1 ? "1 minute" : minutes + " minutes";
-  var hours = Math.round(minutes / 60);
-  if (hours < 24) return hours === 1 ? "about 1 hour" : "about " + hours + " hours";
-  var days = Math.round(hours / 24);
-  if (days < 30) return days === 1 ? "1 day" : days + " days";
-  var months = Math.round(days / 30);
-  if (months < 12) return months === 1 ? "about 1 month" : "about " + months + " months";
-  var years = Math.round(days / 365);
-  return years === 1 ? "about 1 year" : "about " + years + " years";
-}
-
-function ckRelativeTimeCompact(then) {
-  var seconds = Math.round((Date.now() - then.getTime()) / 1000);
-  if (seconds < 60) return "now";
-  var minutes = Math.round(seconds / 60);
-  if (minutes < 60) return minutes + "m";
-  var hours = Math.round(minutes / 60);
-  if (hours < 24) return hours + "h";
-  var days = Math.round(hours / 24);
-  if (days < 30) return days + "d";
-  var months = Math.round(days / 30);
-  if (months < 12) return months + "mo";
-  var years = Math.round(days / 365);
-  return years + "y";
-}
-
-function ckTickRelativeTimes() {
-  document.querySelectorAll("[data-relative-time]").forEach(function(el) {
-    var then = new Date(el.getAttribute("datetime"));
-    if (isNaN(then.getTime())) return;
-    var verbose = el.getAttribute("data-relative-time") === "verbose";
-    el.textContent = verbose ? ckRelativeTime(then) : ckRelativeTimeCompact(then);
-    el.setAttribute("title", then.toLocaleString());
-  });
-}
-
-if (!window.ckRelativeTimeInterval) {
-  window.ckRelativeTimeInterval = setInterval(ckTickRelativeTimes, 30000);
-}
-document.addEventListener("turbo:before-stream-render", function() {
-  requestAnimationFrame(ckTickRelativeTimes);
-});
-
-var ckCsvHoverTimer = null;
-var ckCsvHoverRow = null;
-document.addEventListener("mouseover", function(e) {
-  var row = e.target.closest && e.target.closest(".ck-csv-table tbody tr");
-  if (!row || row === ckCsvHoverRow) return;
-  if (ckCsvHoverRow) ckCsvHoverRow.classList.remove("ck-csv-row--expanded");
-  ckCsvHoverRow = row;
-  clearTimeout(ckCsvHoverTimer);
-  ckCsvHoverTimer = setTimeout(function() {
-    if (ckCsvHoverRow === row) row.classList.add("ck-csv-row--expanded");
-  }, 350);
-});
-document.addEventListener("mouseout", function(e) {
-  var row = e.target.closest && e.target.closest(".ck-csv-table tbody tr");
-  if (!row) return;
-  var related = e.relatedTarget && e.relatedTarget.closest && e.relatedTarget.closest(".ck-csv-table tbody tr");
-  if (related === row) return;
-  clearTimeout(ckCsvHoverTimer);
-  row.classList.remove("ck-csv-row--expanded");
-  if (ckCsvHoverRow === row) ckCsvHoverRow = null;
-});
-
-var ckRefreshing = false;
-function ckRefreshModels() {
-  if (ckRefreshing) return;
-  ckRefreshing = true;
-  var btn = document.querySelector('.ck-icon-btn[title="Refresh models"]');
-  if (btn) btn.classList.add('ck-icon-btn--spinning');
-  ckUpdateRefreshProgress();
-  var csrfToken = document.querySelector('meta[name="csrf-token"]').getAttribute("content");
-  fetch("/completion_kit/refresh_models", {
-    method: "POST",
-    headers: { "X-CSRF-Token": csrfToken }
-  });
-}
-
-function ckUpdateRefreshProgress() {
-  var status = document.getElementById('refresh-status');
-  if (!status) return;
-  var carriers = document.querySelectorAll('[data-refresh-progress-carriers] [id^="discovery_status_"]');
-  var totalCurrent = 0, totalTotal = 0, anyDiscovering = false;
-  carriers.forEach(function(node) {
-    if (!node.querySelector('.ck-discovery-bar')) return;
-    if (node.querySelector('.ck-discovery-bar--failed') || node.querySelector('.ck-discovery-bar--completed')) return;
-    anyDiscovering = true;
-    var match = node.textContent.match(/(\d+)\s*\/\s*(\d+)/);
-    if (match) {
-      totalCurrent += parseInt(match[1], 10);
-      totalTotal += parseInt(match[2], 10);
-    }
-  });
-  if (anyDiscovering || ckRefreshing) {
-    if (totalTotal > 0) {
-      status.textContent = 'Refreshing models\u2026 ' + totalCurrent + '/' + totalTotal;
-    } else {
-      status.textContent = 'Refreshing models\u2026';
-    }
-  }
-}
-
-document.addEventListener("turbo:before-stream-render", function(event) {
-  var target = event.target.getAttribute("target");
-  if (target && target.indexOf("discovery_status_") === 0) {
-    requestAnimationFrame(ckUpdateRefreshProgress);
-  }
-  if (target === "prompt_llm_model" || target === "run_judge_model") {
-    ckRefreshing = false;
-    var btn = document.querySelector('.ck-icon-btn[title="Refresh models"]');
-    if (btn) btn.classList.remove('ck-icon-btn--spinning');
-    var status = document.getElementById('refresh-status');
-    if (status) { status.textContent = 'Models updated.'; setTimeout(function() { status.textContent = '\u00a0'; }, 3000); }
-  }
-});
-</script>
 </body>
 </html>

data/config/routes.rb

@@ -10,6 +10,7 @@ CompletionKit::Engine.routes.draw do
   resources :datasets
   resources :metrics
   resources :metric_groups
+  resources :tags
 
   resources :runs do
     member do
@@ -52,6 +53,7 @@ CompletionKit::Engine.routes.draw do
       resources :datasets
       resources :metrics
       resources :metric_groups
+      resources :tags
       resources :provider_credentials
     end
   end

data/db/migrate/20260509000001_create_completion_kit_tags.rb

@@ -0,0 +1,10 @@
+class CreateCompletionKitTags < ActiveRecord::Migration[8.1]
+  def change
+    create_table :completion_kit_tags do |t|
+      t.string :name, null: false
+      t.string :color, null: false
+      t.timestamps
+    end
+    add_index :completion_kit_tags, :name, unique: true
+  end
+end

data/db/migrate/20260509000002_create_completion_kit_taggings.rb

@@ -0,0 +1,16 @@
+class CreateCompletionKitTaggings < ActiveRecord::Migration[8.1]
+  def change
+    create_table :completion_kit_taggings do |t|
+      t.references :tag, null: false,
+                         foreign_key: { to_table: :completion_kit_tags }
+      t.string :taggable_type, null: false
+      t.bigint :taggable_id, null: false
+      t.timestamps
+    end
+    add_index :completion_kit_taggings, [:taggable_type, :taggable_id]
+    add_index :completion_kit_taggings,
+              [:tag_id, :taggable_type, :taggable_id],
+              unique: true,
+              name: "idx_taggings_unique"
+  end
+end

data/lib/completion_kit/engine.rb

@@ -8,7 +8,11 @@ module CompletionKit
     paths.add "app/services", eager_load: true
 
     def self.register_assets(app)
-      app.config.assets.precompile += %w( completion_kit/application.css completion_kit/logo.svg )
+      app.config.assets.precompile += %w(
+        completion_kit/application.css
+        completion_kit/application.js
+        completion_kit/logo.svg
+      )
     end
 
     initializer("completion_kit.assets") { |app| Engine.register_assets(app) }

data/lib/completion_kit/version.rb

@@ -1,3 +1,3 @@
 module CompletionKit
-  VERSION = "0.4.8"
+  VERSION = "0.5.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: completion-kit
 version: !ruby/object:Gem::Version
-  version: 0.4.8
+  version: 0.5.1
 platform: ruby
 authors:
 - Damien Bastin
@@ -228,6 +228,7 @@ files:
 - app/assets/config/completion_kit_manifest.js
 - app/assets/config/manifest.js
 - app/assets/images/completion_kit/logo.svg
+- app/assets/javascripts/completion_kit/application.js
 - app/assets/stylesheets/completion_kit/application.css
 - app/controllers/completion_kit/api/v1/base_controller.rb
 - app/controllers/completion_kit/api/v1/datasets_controller.rb
@@ -237,6 +238,7 @@ files:
 - app/controllers/completion_kit/api/v1/provider_credentials_controller.rb
 - app/controllers/completion_kit/api/v1/responses_controller.rb
 - app/controllers/completion_kit/api/v1/runs_controller.rb
+- app/controllers/completion_kit/api/v1/tags_controller.rb
 - app/controllers/completion_kit/api_reference_controller.rb
 - app/controllers/completion_kit/application_controller.rb
 - app/controllers/completion_kit/datasets_controller.rb
@@ -248,6 +250,8 @@ files:
 - app/controllers/completion_kit/responses_controller.rb
 - app/controllers/completion_kit/runs_controller.rb
 - app/controllers/completion_kit/suggestions_controller.rb
+- app/controllers/completion_kit/tags_controller.rb
+- app/controllers/concerns/completion_kit/tag_filtering.rb
 - app/helpers/completion_kit/application_helper.rb
 - app/jobs/completion_kit/application_job.rb
 - app/jobs/completion_kit/generate_row_job.rb
@@ -268,6 +272,9 @@ files:
 - app/models/completion_kit/run.rb
 - app/models/completion_kit/run_metric.rb
 - app/models/completion_kit/suggestion.rb
+- app/models/completion_kit/tag.rb
+- app/models/completion_kit/tagging.rb
+- app/models/concerns/completion_kit/taggable.rb
 - app/services/completion_kit/anthropic_client.rb
 - app/services/completion_kit/api_config.rb
 - app/services/completion_kit/csv_processor.rb
@@ -282,6 +289,7 @@ files:
 - app/services/completion_kit/mcp_tools/provider_credentials.rb
 - app/services/completion_kit/mcp_tools/responses.rb
 - app/services/completion_kit/mcp_tools/runs.rb
+- app/services/completion_kit/mcp_tools/tags.rb
 - app/services/completion_kit/model_discovery_service.rb
 - app/services/completion_kit/ollama_client.rb
 - app/services/completion_kit/open_ai_client.rb
@@ -329,7 +337,15 @@ files:
 - app/views/completion_kit/runs/index.html.erb
 - app/views/completion_kit/runs/new.html.erb
 - app/views/completion_kit/runs/show.html.erb
+- app/views/completion_kit/shared/_settings_nav.html.erb
 - app/views/completion_kit/suggestions/show.html.erb
+- app/views/completion_kit/tags/_filter_bar.html.erb
+- app/views/completion_kit/tags/_form.html.erb
+- app/views/completion_kit/tags/_marks.html.erb
+- app/views/completion_kit/tags/_picker.html.erb
+- app/views/completion_kit/tags/edit.html.erb
+- app/views/completion_kit/tags/index.html.erb
+- app/views/completion_kit/tags/new.html.erb
 - app/views/layouts/completion_kit/application.html.erb
 - config/routes.rb
 - db/migrate/20260311000001_create_completion_kit_tables.rb
@@ -351,6 +367,8 @@ files:
 - db/migrate/20260501000005_collapse_run_status_and_add_failure_summary.rb
 - db/migrate/20260507000001_add_discovery_error_to_provider_credentials.rb
 - db/migrate/20260507150000_add_temperature_ignored_to_runs.rb
+- db/migrate/20260509000001_create_completion_kit_tags.rb
+- db/migrate/20260509000002_create_completion_kit_taggings.rb
 - lib/completion-kit.rb
 - lib/completion_kit.rb
 - lib/completion_kit/concurrency_check.rb