Add a rake task to reslug an edition

We had a case where a superseded edition had the same slug as a new document. This meant that the new document could not be published under the ideal slug until the superseded edition frees the slug. The new document's slug had had '--2' appended to it, which is not ideal.

I've now added a rake task to reslug an edition, which will allow us to fix issues like this.
Instead of receiving the old slug as an argument, the task receives the edition's ID, just to be sure we're reslugging the intended edition.

Usage: `bundle exec rake reslug:edition[12345,new-slug]`

Author: eYinka

lib/tasks/reslugging.rake

@@ -113,4 +113,32 @@ namespace :reslug do
     statistics_announcement = StatisticsAnnouncement.find_by!(slug: args.old_slug)
     statistics_announcement.update!(slug: args.new_slug)
   end
+
+  desc "Override the slug of an Edition (DANGER!).\n
+  Use this to update the slug of an edition.
+  Usage: `bundle exec rake reslug:edition[edition_id,new-slug]`
+
+  It performs the following steps:
+  - sets slug_override on the edition
+  - pushes the updated edition to Publishing API"
+  task :edition, %i[edition_id new_slug] => :environment do |_task, args|
+    raise "Please provide both the edition ID and the new slug as arguments, e.g. `bundle exec rake reslug:edition[12345,new-slug]`" if args[:edition_id].blank? || args[:new_slug].blank?
+
+    edition = Edition.find(args[:edition_id])
+    user = User.where(name: "Scheduled Publishing Robot", uid: nil).first
+
+    puts "Updating edition: #{edition.title}'s slug: '#{edition.slug}' -> '#{args[:new_slug]}'"
+
+    edition.slug_override = args[:new_slug]
+    edition.editorial_remarks.create!(
+      body: "Slug updated from '#{edition.slug}' to '#{args[:new_slug]}' by publishing support.",
+      author: user,
+    )
+    edition.save!(validate: false)
+
+    presenter = PublishingApiPresenters.presenter_for(edition)
+    Services.publishing_api.put_content(presenter.content_id, presenter.content)
+
+    puts "Done."
+  end
 end

test/unit/lib/tasks/reslugging_test.rb

@@ -83,4 +83,45 @@ class ResluggingTest < ActiveSupport::TestCase
       end
     end
   end
+
+  describe "for edition" do
+    let(:task) { Rake::Task["reslug:edition"] }
+
+    setup do
+      create(:scheduled_publishing_robot)
+    end
+
+    test "it creates a slug override" do
+      edition = create(:draft_edition, slug_override: "old-slug")
+
+      task.invoke(edition.id, "new-slug")
+
+      edition.reload
+      assert_equal "new-slug", edition.slug
+      assert_equal "new-slug", edition.slug_override
+    end
+
+    test "it creates an editorial remark" do
+      edition = create(:draft_edition, slug_override: "old-slug--2")
+
+      task.invoke(edition.id, "new-slug")
+
+      remark = edition.editorial_remarks.last
+      assert_not_nil remark
+      assert_includes remark.body, "old-slug--2"
+      assert_includes remark.body, "new-slug"
+    end
+
+    test "it raises when edition_id is missing" do
+      assert_raises(RuntimeError) do
+        task.invoke("", "old-slug")
+      end
+    end
+
+    test "it raises when new_slug is missing" do
+      assert_raises(RuntimeError) do
+        task.invoke("12345", "")
+      end
+    end
+  end
 end