Support image descriptions for Basil Commission images

Author: drusepth

app/controllers/basil_controller.rb

@@ -836,6 +836,24 @@ def delete
     end
   end
 
+  def update_commission
+    @commission = BasilCommission.find_by(
+      id:   params[:id],
+      user: current_user
+    )
+
+    if @commission.nil?
+      render json: { error: "Commission not found" }, status: :not_found
+      return
+    end
+
+    if @commission.update(update_commission_params)
+      render json: { success: true }, status: 200
+    else
+      render json: { error: @commission.errors.full_messages }, status: :unprocessable_entity
+    end
+  end
+
   private
 
   # Cache user content for Basil without universe filtering
@@ -862,4 +880,8 @@ def commission_params
   def jam_params
     params.require(:commission).permit(:name, :age, features: [])
   end
+
+  def update_commission_params
+    params.require(:basil_commission).permit(:notes)
+  end
 end

app/views/content/edit/_gallery_panel.html.erb

@@ -113,7 +113,18 @@
                     <% end %>
                   </div>
                   <div class="p-3 border-t border-gray-100 dark:border-gray-700">
-                    <span class="text-xs text-purple-600 dark:text-purple-400 font-medium">Generated with Basil</span>
+                    <div class="mb-2 flex items-center justify-between">
+                      <span class="text-xs text-purple-600 dark:text-purple-400 font-medium">Generated with Basil</span>
+                      <% if image_data.image.attached? %>
+                        <span class="text-xs text-gray-500">
+                          <%= Filesize.from("#{image_data.image.byte_size}B").to_f('KB').round(2) %> KB
+                        </span>
+                      <% end %>
+                    </div>
+                    <textarea class="w-full text-sm p-2 border border-gray-300 dark:border-gray-600 rounded bg-white dark:bg-gray-700 text-gray-900 dark:text-gray-100 focus:ring-blue-500 focus:border-blue-500 js-image-notes" rows="2" placeholder="Add descriptions, creation date, or notes..." data-image-id="<%= image_id %>"><%= image_data.notes %></textarea>
+                    <div class="text-right mt-1">
+                      <button class="btn-small text-xs px-2 py-1 bg-blue-600 hover:bg-blue-700 text-white rounded js-save-image-notes" style="display: none;">Save Notes</button>
+                    </div>
                   </div>
 
                   <!-- Pin button -->
@@ -347,6 +358,8 @@ function initializeGalleryEvents() {
 // Handle notes save
 function handleNotesSave(textarea, button) {
   var imageId = textarea.getAttribute('data-image-id');
+  var imageItem = textarea.closest('.gallery-sortable-item');
+  var imageType = imageItem ? imageItem.getAttribute('data-image-type') : 'image_upload';
   var notes = textarea.value;
 
   if (button && button.classList.contains('processing')) return;
@@ -361,15 +374,23 @@ function handleNotesSave(textarea, button) {
     return;
   }
 
-  fetch('/image_uploads/' + imageId, {
+  var endpointUrl = '/image_uploads/' + imageId;
+  var payload = { image_upload: { notes: notes } };
+  
+  if (imageType === 'basil_commission') {
+    endpointUrl = '/ai/basil/commission/' + imageId;
+    payload = { basil_commission: { notes: notes } };
+  }
+
+  fetch(endpointUrl, {
     method: 'PATCH',
     headers: {
       'X-Requested-With': 'XMLHttpRequest',
       'X-CSRF-Token': csrfToken.content,
       'Content-Type': 'application/json',
       'Accept': 'application/json'
     },
-    body: JSON.stringify({ image_upload: { notes: notes } }),
+    body: JSON.stringify(payload),
     credentials: 'same-origin'
   })
   .then(response => {

config/routes.rb

@@ -36,6 +36,7 @@
       post   '/:id/save',        to: 'basil#save',     as: :basil_save
       delete '/:id/delete',      to: 'basil#delete',   as: :basil_delete
       get    '/commission/:jobid', to: 'basil#commission_info', as: :basil_commission_info
+      patch  '/commission/:id',    to: 'basil#update_commission', as: :basil_commission_update
 
       # Landing pages
       get  '/jam',               to: 'basil#jam',        as: :basil_jam

db/migrate/20260401171734_add_notes_to_basil_commissions.rb

@@ -0,0 +1,5 @@
+class AddNotesToBasilCommissions < ActiveRecord::Migration[6.1]
+  def change
+    add_column :basil_commissions, :notes, :text
+  end
+end

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema.define(version: 2026_03_21_082539) do
+ActiveRecord::Schema.define(version: 2026_04_01_171734) do
 
   create_table "active_storage_attachments", force: :cascade do |t|
     t.string "name", null: false
@@ -204,6 +204,7 @@
     t.integer "basil_version", default: 2
     t.boolean "pinned", default: false
     t.integer "position"
+    t.text "notes"
     t.index ["entity_type", "entity_id", "pinned"], name: "index_basil_commissions_on_entity_pinned"
     t.index ["entity_type", "entity_id", "position"], name: "index_basil_commissions_on_entity_position"
     t.index ["entity_type", "entity_id", "saved_at"], name: "basil_commissions_ees"
@@ -458,6 +459,18 @@
     t.index ["user_id"], name: "index_character_magics_on_user_id"
   end
 
+  create_table "character_system_chats", force: :cascade do |t|
+    t.integer "character_id"
+    t.integer "user_id"
+    t.string "uid"
+    t.json "messages", default: []
+    t.datetime "created_at", precision: 6, null: false
+    t.datetime "updated_at", precision: 6, null: false
+    t.index ["character_id"], name: "index_character_system_chats_on_character_id"
+    t.index ["uid"], name: "index_character_system_chats_on_uid", unique: true
+    t.index ["user_id"], name: "index_character_system_chats_on_user_id"
+  end
+
   create_table "character_technologies", force: :cascade do |t|
     t.integer "user_id"
     t.integer "character_id"