Improve warning for Promote issue to epic

- Warning only displays when issue is confidential
- Change promote command description
- Update banner copy on confirm issue has been promoted

app/assets/javascripts/gfm_auto_complete.js

@@ -107,8 +107,13 @@ class GfmAutoComplete {
         if (value.params.length > 0) {
           tpl += ' <small class="params"><%- params.join(" ") %></small>';
         }
-        if (value.description !== '') {
-          tpl += '<small class="description"><i><%- description %> <%- warningText %></i></small>';
+        if (value.warning && value.icon && value.icon === 'confidential') {
+          tpl +=
+            '<small class="description"><em><i class="fa fa-eye-slash" aria-hidden="true"/><%- warning %></em></small>';
+        } else if (value.warning) {
+          tpl += '<small class="description"><em><%- warning %></em></small>';
+        } else if (value.description !== '') {
+          tpl += '<small class="description"><em><%- description %></em></small>';
         }
         tpl += '</li>';
 
@@ -119,7 +124,6 @@ class GfmAutoComplete {
         return _.template(tpl)({
           ...value,
           className: cssClasses.join(' '),
-          warningText: value.warning ? `(${value.warning})` : '',
         });
       },
       insertTpl(value) {
@@ -150,6 +154,7 @@ class GfmAutoComplete {
               params: c.params,
               description: c.description,
               warning: c.warning,
+              icon: c.icon,
               search,
             };
           });

app/assets/stylesheets/vendors/atwho.scss

@@ -23,9 +23,9 @@
   }
 
   .has-warning {
-    .name,
     .description {
       color: $orange-700;
+      background-color: $orange-100;
     }
   }
 
@@ -59,7 +59,6 @@
 
         &.has-warning {
           color: $orange-700;
-          background-color: $orange-100;
         }
       }
 

changelogs/unreleased/9215-promote-issue-to-epic-may-expose-confidential-information-warning-ne.yml

+---
+title: Improve warning for Promote issue to epic
+merge_request: 21158
+author:
+type: changed

doc/user/group/epics/index.md

@@ -218,7 +218,9 @@ link in the issue sidebar.
 If you have [permissions](../../permissions.md) to close an issue and create an
 epic in the parent group, you can promote an issue to an epic with the `/promote`
 [quick action](../../project/quick_actions.md#quick-actions-for-issues-merge-requests-and-epics).
-Only issues from projects that are in groups can be promoted.
+Only issues from projects that are in groups can be promoted. When attempting to promote a confidential
+issue, a warning will display. Promoting a confidential issue to an epic will make all information
+related to the issue public as epics are public to group members.
 
 When the quick action is executed:
 

ee/lib/ee/gitlab/quick_actions/issue_actions.rb

@@ -49,9 +49,23 @@ module EE
             @updates[:epic] = nil
           end
 
-          desc _('Promote issue to an epic')
-          explanation _('Promote issue to an epic.')
-          warning _('may expose confidential information')
+          promote_message = _('Promote issue to an epic')
+          promote_message_confidential = _('Promote confidential issue to a non-confidential epic')
+
+          desc do
+            if quick_action_target.confidential?
+              promote_message_confidential
+            else
+              promote_message
+            end
+          end
+          explanation promote_message
+          warning do
+            if quick_action_target.confidential?
+              promote_message_confidential
+            end
+          end
+          icon 'confidential'
           types Issue
           condition do
             quick_action_target.persisted? &&
@@ -60,7 +74,12 @@ module EE
           end
           command :promote do
             Epics::IssuePromoteService.new(quick_action_target.project, current_user).execute(quick_action_target)
-            @execution_message[:promote] = _('Promoted issue to an epic.')
+
+            @execution_message[:promote] = if quick_action_target.confidential?
+                                             _('Promoted confidential issue to a non-confidential epic. Information in this issue is no longer confidential as epics are public to group members.')
+                                           else
+                                             _('Promoted issue to an epic.')
+                                           end
           end
 
           def extract_epic(params)

ee/spec/controllers/groups/autocomplete_sources_controller_spec.rb

@@ -63,7 +63,7 @@ describe Groups::AutocompleteSourcesController do
       expect(json_response).to include(
         {
           'name' => 'close', 'aliases' => [], 'description' => 'Close this epic',
-          'params' => [], 'warning' => ''
+          'params' => [], 'warning' => '', 'icon' => ''
         }
       )
     end

ee/spec/features/epics/issue_promotion_spec.rb

@@ -49,6 +49,15 @@ describe 'Issue promotion', :js do
         visit project_issue_path(project, issue)
       end
 
+      it 'displays warning' do
+        note = find('#note-body')
+        type(note, '/promote')
+
+        wait_for_requests
+
+        expect(page).to have_content 'Promote issue to an epic'
+      end
+
       it 'promotes the issue' do
         add_note('/promote')
 
@@ -63,5 +72,48 @@ describe 'Issue promotion', :js do
         expect(epic.author).to eq(user)
       end
     end
+
+    context 'when issue is confidential' do
+      let(:confidential_issue) { create(:issue, :confidential, project: project) }
+
+      before do
+        group.add_developer(user)
+        visit project_issue_path(project, confidential_issue)
+      end
+
+      it 'displays warning' do
+        note = find('#note-body')
+        type(note, '/promote')
+
+        wait_for_requests
+
+        expect(page).to have_content 'Promote confidential issue to a non-confidential epic'
+      end
+
+      it 'promotes the issue' do
+        add_note('/promote')
+
+        wait_for_requests
+
+        epic = Epic.last
+
+        expect(page).to have_content 'Promoted confidential issue to a non-confidential epic. Information in this issue is no longer confidential as epics are public to group members.'
+        expect(confidential_issue.reload).to be_closed
+        expect(epic.title).to eq(confidential_issue.title)
+        expect(epic.description).to eq(confidential_issue.description)
+        expect(epic.author).to eq(user)
+      end
+    end
+  end
+
+  private
+
+  # `note` is a textarea where the given text should be typed.
+  # We don't want to find it each time this function gets called.
+  def type(note, text)
+    page.within('.timeline-content-form') do
+      note.set('')
+      note.native.send_keys(text)
+    end
   end
 end

lib/gitlab/quick_actions/command_definition.rb

@@ -4,7 +4,7 @@ module Gitlab
   module QuickActions
     class CommandDefinition
       attr_accessor :name, :aliases, :description, :explanation, :execution_message,
-        :params, :condition_block, :parse_params_block, :action_block, :warning, :types
+        :params, :condition_block, :parse_params_block, :action_block, :warning, :icon, :types
 
       def initialize(name, attributes = {})
         @name = name
@@ -12,6 +12,7 @@ module Gitlab
         @aliases = attributes[:aliases] || []
         @description = attributes[:description] || ''
         @warning = attributes[:warning] || ''
+        @icon = attributes[:icon] || ''
         @explanation = attributes[:explanation] || ''
         @execution_message = attributes[:execution_message] || ''
         @params = attributes[:params] || []
@@ -45,7 +46,13 @@ module Gitlab
                     explanation
                   end
 
-        warning.empty? ? message : "#{message} (#{warning})"
+        warning_text = if warning.respond_to?(:call)
+                         execute_block(warning, context, arg)
+                       else
+                         warning
+                       end
+
+        warning.empty? ? message : "#{message} (#{warning_text})"
       end
 
       def execute(context, arg)
@@ -72,6 +79,11 @@ module Gitlab
           desc = context.instance_exec(&desc) rescue ''
         end
 
+        warn = warning
+        if warn.respond_to?(:call)
+          warn = context.instance_exec(&warn) rescue ''
+        end
+
         prms = params
         if prms.respond_to?(:call)
           prms = Array(context.instance_exec(&prms)) rescue params
@@ -81,7 +93,8 @@ module Gitlab
           name: name,
           aliases: aliases,
           description: desc,
-          warning: warning,
+          warning: warn,
+          icon: icon,
           params: prms
         }
       end

lib/gitlab/quick_actions/dsl.rb

@@ -33,8 +33,12 @@ module Gitlab
           @description = block_given? ? block : text
         end
 
-        def warning(message = '')
-          @warning = message
+        def warning(text = '', &block)
+          @warning = block_given? ? block : text
+        end
+
+        def icon(string = '')
+          @icon = string
         end
 
         # Allows to define params for the next quick action.
@@ -192,6 +196,7 @@ module Gitlab
             aliases: aliases,
             description: @description,
             warning: @warning,
+            icon: @icon,
             explanation: @explanation,
             execution_message: @execution_message,
             params: @params,
@@ -213,6 +218,7 @@ module Gitlab
           @params = nil
           @condition_block = nil
           @warning = nil
+          @icon = nil
           @parse_params_block = nil
           @types = nil
         end

locale/gitlab.pot

@@ -14420,10 +14420,10 @@ msgstr ""
 msgid "Promote"
 msgstr ""
 
-msgid "Promote issue to an epic"
+msgid "Promote confidential issue to a non-confidential epic"
 msgstr ""
 
-msgid "Promote issue to an epic."
+msgid "Promote issue to an epic"
 msgstr ""
 
 msgid "Promote these project milestones into a group milestone."
@@ -14444,6 +14444,9 @@ msgstr ""
 msgid "PromoteMilestone|Promotion failed - %{message}"
 msgstr ""
 
+msgid "Promoted confidential issue to a non-confidential epic. Information in this issue is no longer confidential as epics are public to group members."
+msgstr ""
+
 msgid "Promoted issue to an epic."
 msgstr ""
 
@@ -21707,9 +21710,6 @@ msgstr ""
 msgid "math|There was an error rendering this math block"
 msgstr ""
 
-msgid "may expose confidential information"
-msgstr ""
-
 msgid "merge request"
 msgid_plural "merge requests"
 msgstr[0] ""