completion-kit 0.4.7 → 0.5.0

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,39 @@
+<%= 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,
+            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

@@ -22,7 +22,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) %>
@@ -49,8 +58,36 @@ document.addEventListener("turbo:load", function() {
     el.textContent = d.toLocaleString(undefined, {year:"numeric",month:"short",day:"numeric",hour:"2-digit",minute:"2-digit"});
   });
   ckTickRelativeTimes();
+  ckAutoFocusFirstError();
 });
 
+document.addEventListener("input", function(e) {
+  if (!e.target || e.target.id !== "tag_name") return;
+  var text = document.getElementById("tag-pill-text");
+  if (!text) return;
+  var v = e.target.value.trim().toLowerCase();
+  text.textContent = v.length ? v : (text.dataset.placeholder || "");
+});
+
+function ckAutoFocusFirstError() {
+  var fieldSelector = "input:not([type=hidden]):not([type=submit]):not([type=button]):not([type=reset]):not([type=file]), textarea, select";
+  var marker = document.querySelector("form .ck-flash--alert, form [aria-invalid='true'], form .ck-field-error");
+
+  var target;
+  if (marker) {
+    var form = marker.closest("form");
+    target = form && (form.querySelector("[aria-invalid='true']") || form.querySelector(fieldSelector));
+  } else if (/\/new(\/|$)/.test(window.location.pathname)) {
+    target = document.querySelector("form " + fieldSelector);
+  }
+
+  if (!target || typeof target.focus !== "function") return;
+  target.focus({ preventScroll: false });
+  if (typeof target.setSelectionRange === "function" && typeof target.value === "string") {
+    try { target.setSelectionRange(target.value.length, target.value.length); } catch (e) {}
+  }
+}
+
 function ckRelativeTime(then) {
   var seconds = Math.round((Date.now() - then.getTime()) / 1000);
   if (seconds < 5) return "just now";

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/version.rb

@@ -1,3 +1,3 @@
 module CompletionKit
-  VERSION = "0.4.7"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: completion-kit
 version: !ruby/object:Gem::Version
-  version: 0.4.7
+  version: 0.5.0
 platform: ruby
 authors:
 - Damien Bastin
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -238,6 +237,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
@@ -249,6 +249,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
@@ -269,6 +271,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
@@ -283,6 +288,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
@@ -330,7 +336,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
@@ -352,6 +366,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
@@ -369,7 +385,6 @@ metadata:
   homepage_uri: https://github.com/homemade-software-inc/completion-kit
   source_code_uri: https://github.com/homemade-software-inc/completion-kit
   changelog_uri: https://github.com/homemade-software-inc/completion-kit/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -384,8 +399,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Your prompts need tests too. Run them against real data, score outputs with
   an LLM judge, iterate until they work.