When accepting revisions, allow users to accept on behalf of a subset of reviewers

Summary:
Ref T12271. Currenty, when you "Accept" a revision, you always accept it for all reviewers you have authority over.

There are some situations where communication can be more clear if users can accept as only themselves, or for only some packages, etc. T12271 discusses some of these use cases in more depth.

Instead of making "Accept" a blanket action, default it to doing what it does now but let the user uncheck reviewers.

In cases where project/package reviewers aren't in use, this doesn't change anything.

For now, "reject" still acts the old way (reject everything). We could make that use checkboxes too, but I'm not sure there's as much of a use case for it, and I generally want users who are blocking stuff to have more direct accountability in a product sense.

Test Plan:
- Accepted normally.
- Accepted a subset.
- Tried to accept none.
- Tried to accept bogus reviewers.
- Accepted with myself not a reviewer
- Accepted with only one reviewer (just got normal "this will be accepted" text).

{F4251255}

Reviewers: chad

Reviewed By: chad

Maniphest Tasks: T12271

Differential Revision: https://secure.phabricator.com/D17533

resources/celerity/map.php

···
   'names' => array(
     'conpherence.pkg.css' => '82aca405',
     'conpherence.pkg.js' => '6249a1cf',
-    'core.pkg.css' => 'c012c648',
+    'core.pkg.css' => 'dc689e29',
     'core.pkg.js' => '1fa7c0c5',
     'darkconsole.pkg.js' => 'e7393ebb',
     'differential.pkg.css' => '90b30783',
···
     'rsrc/css/phui/phui-document.css' => 'c32e8dec',
     'rsrc/css/phui/phui-feed-story.css' => '44a9c8e9',
     'rsrc/css/phui/phui-fontkit.css' => '1320ed01',
-    'rsrc/css/phui/phui-form-view.css' => 'cf198e10',
+    'rsrc/css/phui/phui-form-view.css' => '6175808d',
     'rsrc/css/phui/phui-form.css' => 'b62c01d8',
     'rsrc/css/phui/phui-head-thing.css' => 'fd311e5f',
     'rsrc/css/phui/phui-header-view.css' => '9cf828ce',
···
     'rsrc/js/phuix/PHUIXActionView.js' => 'b3465b9b',
     'rsrc/js/phuix/PHUIXAutocomplete.js' => '7c492cd2',
     'rsrc/js/phuix/PHUIXDropdownMenu.js' => '8018ee50',
-    'rsrc/js/phuix/PHUIXFormControl.js' => 'bbece68d',
+    'rsrc/js/phuix/PHUIXFormControl.js' => '83e03671',
     'rsrc/js/phuix/PHUIXIconView.js' => 'bff6884b',
   ),
   'symbols' => array(
···
     'phui-font-icon-base-css' => '870a7360',
     'phui-fontkit-css' => '1320ed01',
     'phui-form-css' => 'b62c01d8',
-    'phui-form-view-css' => 'cf198e10',
+    'phui-form-view-css' => '6175808d',
     'phui-head-thing-view-css' => 'fd311e5f',
     'phui-header-view-css' => '9cf828ce',
     'phui-hovercard' => '1bd28176',
···
     'phuix-action-view' => 'b3465b9b',
     'phuix-autocomplete' => '7c492cd2',
     'phuix-dropdown-menu' => '8018ee50',
-    'phuix-form-control-view' => 'bbece68d',
+    'phuix-form-control-view' => '83e03671',
     'phuix-icon-view' => 'bff6884b',
     'policy-css' => '957ea14c',
     'policy-edit-css' => '815c66f7',
···
       'javelin-behavior',
       'javelin-scrollbar',
     ),
+    '83e03671' => array(
+      'javelin-install',
+      'javelin-dom',
+    ),
     '8499b6ab' => array(
       'javelin-behavior',
       'javelin-dom',
···
       'javelin-dom',
       'javelin-vector',
       'javelin-install',
-    ),
-    'bbece68d' => array(
-      'javelin-install',
-      'javelin-dom',
     ),
     'bcaccd64' => array(
       'javelin-behavior',

src/__phutil_library_map__.php

···
     'PhabricatorEdgesDestructionEngineExtension' => 'infrastructure/edges/engineextension/PhabricatorEdgesDestructionEngineExtension.php',
     'PhabricatorEditEngine' => 'applications/transactions/editengine/PhabricatorEditEngine.php',
     'PhabricatorEditEngineAPIMethod' => 'applications/transactions/editengine/PhabricatorEditEngineAPIMethod.php',
+    'PhabricatorEditEngineCheckboxesCommentAction' => 'applications/transactions/commentaction/PhabricatorEditEngineCheckboxesCommentAction.php',
     'PhabricatorEditEngineColumnsCommentAction' => 'applications/transactions/commentaction/PhabricatorEditEngineColumnsCommentAction.php',
     'PhabricatorEditEngineCommentAction' => 'applications/transactions/commentaction/PhabricatorEditEngineCommentAction.php',
     'PhabricatorEditEngineCommentActionGroup' => 'applications/transactions/commentaction/PhabricatorEditEngineCommentActionGroup.php',
···
       'PhabricatorPolicyInterface',
     ),
     'PhabricatorEditEngineAPIMethod' => 'ConduitAPIMethod',
+    'PhabricatorEditEngineCheckboxesCommentAction' => 'PhabricatorEditEngineCommentAction',
     'PhabricatorEditEngineColumnsCommentAction' => 'PhabricatorEditEngineCommentAction',
     'PhabricatorEditEngineCommentAction' => 'Phobject',
     'PhabricatorEditEngineCommentActionGroup' => 'Phobject',

src/applications/differential/storage/DifferentialReviewer.php

···
     return ($this->getReviewerStatus() == $status_resigned);
   }
 
+  public function isAccepted($diff_phid) {
+    $status_accepted = DifferentialReviewerStatus::STATUS_ACCEPTED;
+
+    if ($this->getReviewerStatus() != $status_accepted) {
+      return false;
+    }
+
+    if (!$diff_phid) {
+      return true;
+    }
+
+    $action_phid = $this->getLastActionDiffPHID();
+
+    if (!$action_phid) {
+      return true;
+    }
+
+    if ($action_phid == $diff_phid) {
+      return true;
+    }
+
+    $sticky_key = 'differential.sticky-accept';
+    $is_sticky = PhabricatorEnv::getEnvConfig($sticky_key);
+
+    if ($is_sticky) {
+      return true;
+    }
+
+    return false;
+  }
+
 }

src/applications/differential/xaction/DifferentialRevisionAcceptTransaction.php

···
     return pht('Accept a revision.');
   }
 
+  protected function getActionOptions(
+    PhabricatorUser $viewer,
+    DifferentialRevision $revision) {
+
+    $reviewers = $revision->getReviewers();
+
+    $options = array();
+    $value = array();
+
+    // Put the viewer's user reviewer first, if it exists, so that "Accept as
+    // yourself" is always at the top.
+    $head = array();
+    $tail = array();
+    foreach ($reviewers as $key => $reviewer) {
+      if ($reviewer->isUser()) {
+        $head[$key] = $reviewer;
+      } else {
+        $tail[$key] = $reviewer;
+      }
+    }
+    $reviewers = $head + $tail;
+
+    $diff_phid = $this->getActiveDiffPHID($revision);
+    $reviewer_phids = array();
+
+    // If the viewer isn't a reviewer, add them to the list of options first.
+    // This happens when you navigate to some revision you aren't involved in:
+    // you can accept and become a reviewer.
+
+    $viewer_phid = $viewer->getPHID();
+    if ($viewer_phid) {
+      if (!isset($reviewers[$viewer_phid])) {
+        $reviewer_phids[$viewer_phid] = $viewer_phid;
+      }
+    }
+
+    foreach ($reviewers as $reviewer) {
+      if (!$reviewer->hasAuthority($viewer)) {
+        // If the viewer doesn't have authority to act on behalf of a reviewer,
+        // don't include that reviewer as an option.
+        continue;
+      }
+
+      if ($reviewer->isAccepted($diff_phid)) {
+        // If a reviewer is already in a full "accepted" state, don't
+        // include that reviewer as an option.
+        continue;
+      }
+
+      $reviewer_phid = $reviewer->getReviewerPHID();
+      $reviewer_phids[$reviewer_phid] = $reviewer_phid;
+    }
+
+    $handles = $viewer->loadHandles($reviewer_phids);
+
+    foreach ($reviewer_phids as $reviewer_phid) {
+      $options[$reviewer_phid] = pht(
+        'Accept as %s',
+        $viewer->renderHandle($reviewer_phid));
+
+      $value[] = $reviewer_phid;
+    }
+
+    return array($options, $value);
+  }
+
   public function generateOldValue($object) {
     $actor = $this->getActor();
     return $this->isViewerFullyAccepted($object, $actor);
···
     }
   }
 
+  protected function validateOptionValue($object, $actor, array $value) {
+    if (!$value) {
+      throw new Exception(
+        pht(
+          'When accepting a revision, you must accept on behalf of at '.
+          'least one reviewer.'));
+    }
+
+    list($options) = $this->getActionOptions($actor, $object);
+    foreach ($value as $phid) {
+      if (!isset($options[$phid])) {
+        throw new Exception(
+          pht(
+            'Reviewer "%s" is not a valid reviewer which you have authority '.
+            'to accept on behalf of.',
+            $phid));
+      }
+    }
+  }
+
   public function getTitle() {
-    return pht(
-      '%s accepted this revision.',
-      $this->renderAuthor());
+    $new = $this->getNewValue();
+    if (is_array($new) && $new) {
+      return pht(
+        '%s accepted this revision as %s reviewer(s): %s.',
+        $this->renderAuthor(),
+        phutil_count($new),
+        $this->renderHandleList($new));
+    } else {
+      return pht(
+        '%s accepted this revision.',
+        $this->renderAuthor());
+    }
   }
 
   public function getTitleForFeed() {

src/applications/differential/xaction/DifferentialRevisionActionTransaction.php

···
   abstract protected function validateAction($object, PhabricatorUser $viewer);
   abstract protected function getRevisionActionLabel();
 
+  protected function validateOptionValue($object, $actor, array $value) {
+    return null;
+  }
+
   public function getCommandKeyword() {
     return null;
   }
···
     return ($viewer->getPHID() === $revision->getAuthorPHID());
   }
 
+  protected function getActionOptions(
+    PhabricatorUser $viewer,
+    DifferentialRevision $revision) {
+    return array(
+      array(),
+      null,
+    );
+  }
+
   public function newEditField(
     DifferentialRevision $revision,
     PhabricatorUser $viewer) {
···
         // It's not clear that these combinations are actually useful, so just
         // keep things simple for now.
         $field->setActionConflictKey('revision.action');
+
+        list($options, $value) = $this->getActionOptions($viewer, $revision);
+        if (count($options) > 1) {
+          $field->setOptions($options);
+          $field->setValue($value);
+        }
       }
     }
 
···
       if ($action_exception) {
         $errors[] = $this->newInvalidError(
           $action_exception->getMessage(),
+          $xaction);
+        continue;
+      }
+
+      $new = $xaction->getNewValue();
+      if (!is_array($new)) {
+        continue;
+      }
+
+      try {
+        $this->validateOptionValue($object, $actor, $new);
+      } catch (Exception $ex) {
+        $errors[] = $this->newInvalidError(
+          $ex->getMessage(),
           $xaction);
       }
     }

src/applications/differential/xaction/DifferentialRevisionReviewTransaction.php

···
     return DifferentialRevisionEditEngine::ACTIONGROUP_REVIEW;
   }
 
+  public function generateNewValue($object, $value) {
+    if (!is_array($value)) {
+      return true;
+    }
+
+    // If the list of options is the same as the default list, just treat this
+    // as a "take the default action" transaction.
+    $viewer = $this->getActor();
+    list($options, $default) = $this->getActionOptions($viewer, $object);
+
+    sort($default);
+    sort($value);
+
+    if ($default === $value) {
+      return true;
+    }
+
+    return $value;
+  }
+
   protected function isViewerAnyReviewer(
     DifferentialRevision $revision,
     PhabricatorUser $viewer) {
···
 
     // In all cases, you affect yourself.
     $map[$viewer->getPHID()] = $status;
+
+    // If the user has submitted a specific list of reviewers to act as (by
+    // unchecking some checkboxes under "Accept"), only affect those reviewers.
+    if (is_array($value)) {
+      $map = array_select_keys($map, $value);
+    }
 
     // Convert reviewer statuses into edge data.
     foreach ($map as $reviewer_phid => $reviewer_status) {

src/applications/transactions/commentaction/PhabricatorEditEngineCheckboxesCommentAction.php

···
+<?php
+
+final class PhabricatorEditEngineCheckboxesCommentAction
+  extends PhabricatorEditEngineCommentAction {
+
+  private $options = array();
+
+  public function setOptions(array $options) {
+    $this->options = $options;
+    return $this;
+  }
+
+  public function getOptions() {
+    return $this->options;
+  }
+
+  public function getPHUIXControlType() {
+    return 'checkboxes';
+  }
+
+  public function getPHUIXControlSpecification() {
+    $options = $this->getOptions();
+
+    $labels = array();
+    foreach ($options as $key => $option) {
+      $labels[$key] = hsprintf('%s', $option);
+    }
+
+    return array(
+      'value' => $this->getValue(),
+      'keys' => array_keys($options),
+      'labels' => $labels,
+    );
+  }
+
+}

src/applications/transactions/editfield/PhabricatorApplyEditField.php

···
 
   private $actionDescription;
   private $actionConflictKey;
+  private $options;
 
   protected function newControl() {
     return null;
···
     return $this->actionConflictKey;
   }
 
+  public function setOptions(array $options) {
+    $this->options = $options;
+    return $this;
+  }
+
+  public function getOptions() {
+    return $this->options;
+  }
+
   protected function newHTTPParameterType() {
-    return new AphrontBoolHTTPParameterType();
+    if ($this->getOptions()) {
+      return new AphrontPHIDListHTTPParameterType();
+    } else {
+      return new AphrontBoolHTTPParameterType();
+    }
   }
 
   protected function newConduitParameterType() {
···
   }
 
   protected function newCommentAction() {
-    return id(new PhabricatorEditEngineStaticCommentAction())
-      ->setDescription($this->getActionDescription())
-      ->setConflictKey($this->getActionConflictKey());
+    $options = $this->getOptions();
+    if ($options) {
+      return id(new PhabricatorEditEngineCheckboxesCommentAction())
+        ->setConflictKey($this->getActionConflictKey())
+        ->setOptions($options);
+    } else {
+      return id(new PhabricatorEditEngineStaticCommentAction())
+        ->setConflictKey($this->getActionConflictKey())
+        ->setDescription($this->getActionDescription());
+    }
   }
 
 }

src/infrastructure/internationalization/translation/PhabricatorUSEnglishTranslation.php

···
         ),
       ),
 
+      '%s accepted this revision as %s reviewer(s): %s.' =>
+        '%s accepted this revision as: %3$s.',
     );
   }
 

webroot/rsrc/css/phui/phui-form-view.css

···
   padding: 4px;
   color: {$bluetext};
 }
+
+.phuix-form-checkbox-action {
+  padding: 4px;
+  color: {$bluetext};
+}
+
+.phuix-form-checkbox-action input[type=checkbox] {
+  margin: 4px 0;
+}
+
+.phuix-form-checkbox-label {
+  margin-left: 4px;
+}

webroot/rsrc/js/phuix/PHUIXFormControl.js

···
         case 'static':
           input = this._newStatic(spec);
           break;
+        case 'checkboxes':
+          input = this._newCheckboxes(spec);
+          break;
         default:
           // TODO: Default or better error?
           JX.$E('Bad Input Type');
···
         set: function() {
           return;
         }
+      };
+    },
+
+    _newCheckboxes: function(spec) {
+      var checkboxes = [];
+      var checkbox_list = [];
+      for (var ii = 0; ii < spec.keys.length; ii++) {
+        var key = spec.keys[ii];
+        var checkbox_id = 'checkbox-' + Math.floor(Math.random() * 1000000);
+
+        var checkbox = JX.$N(
+          'input',
+          {
+            type: 'checkbox',
+            value: key,
+            id: checkbox_id
+          });
+
+        checkboxes.push(checkbox);
+
+        var label = JX.$N(
+          'label',
+          {
+            className: 'phuix-form-checkbox-label',
+            htmlFor: checkbox_id
+          },
+          JX.$H(spec.labels[key] || ''));
+
+        var display = JX.$N(
+          'div',
+          {
+            className: 'phuix-form-checkbox-item'
+          },
+          [checkbox, label]);
+
+        checkbox_list.push(display);
+      }
+
+      var node = JX.$N(
+        'div',
+        {
+          className: 'phuix-form-checkbox-action'
+        },
+        checkbox_list);
+
+      var get_value = function() {
+        var list = [];
+        for (var ii = 0; ii < checkboxes.length; ii++) {
+          if (checkboxes[ii].checked) {
+            list.push(checkboxes[ii].value);
+          }
+        }
+        return list;
+      };
+
+      var set_value = function(value) {
+        value = value || [];
+
+        if (!value.length) {
+          value = [];
+        }
+
+        var map = {};
+        var ii;
+        for (ii = 0; ii < value.length; ii++) {
+          map[value[ii]] = true;
+        }
+
+        for (ii = 0; ii < checkboxes.length; ii++) {
+          if (map.hasOwnProperty(checkboxes[ii].value)) {
+            checkboxes[ii].checked = 'checked';
+          } else {
+            checkboxes[ii].checked = false;
+          }
+        }
+      };
+
+      set_value(spec.value);
+
+      return {
+        node: node,
+        get: get_value,
+        set: set_value
       };
     },