/**
  * @task mail
  */
 protected function sendMail(PhabricatorLiskDAO $object, array $xactions)
 {
     // Check if any of the transactions are visible. If we don't have any
     // visible transactions, don't send the mail.
     $any_visible = false;
     foreach ($xactions as $xaction) {
         if (!$xaction->shouldHideForMail($xactions)) {
             $any_visible = true;
             break;
         }
     }
     if (!$any_visible) {
         return;
     }
     $email_to = array_filter(array_unique($this->getMailTo($object)));
     $email_cc = array_filter(array_unique($this->getMailCC($object)));
     $phids = array_merge($email_to, $email_cc);
     $handles = id(new PhabricatorHandleQuery())->setViewer($this->requireActor())->withPHIDs($phids)->execute();
     $template = $this->buildMailTemplate($object);
     $body = $this->buildMailBody($object, $xactions);
     $mail_tags = $this->getMailTags($object, $xactions);
     $action = $this->getMailAction($object, $xactions);
     $reply_handler = $this->buildReplyHandler($object);
     $reply_section = $reply_handler->getReplyHandlerInstructions();
     if ($reply_section !== null) {
         $body->addReplySection($reply_section);
     }
     $template->setFrom($this->getActingAsPHID())->setSubjectPrefix($this->getMailSubjectPrefix())->setVarySubjectPrefix('[' . $action . ']')->setThreadID($this->getMailThreadID($object), $this->getIsNewObject())->setRelatedPHID($object->getPHID())->setExcludeMailRecipientPHIDs($this->getExcludeMailRecipientPHIDs())->setMailTags($mail_tags)->setIsBulk(true)->setBody($body->render())->setHTMLBody($body->renderHTML());
     foreach ($body->getAttachments() as $attachment) {
         $template->addAttachment($attachment);
     }
     $herald_xscript = $this->getHeraldTranscript();
     if ($herald_xscript) {
         $herald_header = $herald_xscript->getXHeraldRulesHeader();
         $herald_header = HeraldTranscript::saveXHeraldRulesHeader($object->getPHID(), $herald_header);
     } else {
         $herald_header = HeraldTranscript::loadXHeraldRulesHeader($object->getPHID());
     }
     if ($herald_header) {
         $template->addHeader('X-Herald-Rules', $herald_header);
     }
     if ($object instanceof PhabricatorProjectInterface) {
         $this->addMailProjectMetadata($object, $template);
     }
     if ($this->getParentMessageID()) {
         $template->setParentMessageID($this->getParentMessageID());
     }
     $mails = $reply_handler->multiplexMail($template, array_select_keys($handles, $email_to), array_select_keys($handles, $email_cc));
     foreach ($mails as $mail) {
         $mail->saveAndSend();
     }
     $template->addTos($email_to);
     $template->addCCs($email_cc);
     return $template;
 }
 public function save()
 {
     $revision = $this->getRevision();
     $is_new = $this->isNewRevision();
     if ($is_new) {
         $this->initializeNewRevision($revision);
     }
     $revision->loadRelationships();
     $this->willWriteRevision();
     if ($this->reviewers === null) {
         $this->reviewers = $revision->getReviewers();
     }
     if ($this->cc === null) {
         $this->cc = $revision->getCCPHIDs();
     }
     $diff = $this->getDiff();
     if ($diff) {
         $revision->setLineCount($diff->getLineCount());
     }
     // Save the revision, to generate its ID and PHID if it is new. We need
     // the ID/PHID in order to record them in Herald transcripts, but don't
     // want to hold a transaction open while running Herald because it is
     // potentially somewhat slow. The downside is that we may end up with a
     // saved revision/diff pair without appropriate CCs. We could be better
     // about this -- for example:
     //
     //  - Herald can't affect reviewers, so we could compute them before
     //    opening the transaction and then save them in the transaction.
     //  - Herald doesn't *really* need PHIDs to compute its effects, we could
     //    run it before saving these objects and then hand over the PHIDs later.
     //
     // But this should address the problem of orphaned revisions, which is
     // currently the only problem we experience in practice.
     $revision->openTransaction();
     if ($diff) {
         $revision->setBranchName($diff->getBranch());
         $revision->setArcanistProjectPHID($diff->getArcanistProjectPHID());
     }
     $revision->save();
     if ($diff) {
         $diff->setRevisionID($revision->getID());
         $diff->save();
     }
     $revision->saveTransaction();
     // We're going to build up three dictionaries: $add, $rem, and $stable. The
     // $add dictionary has added reviewers/CCs. The $rem dictionary has
     // reviewers/CCs who have been removed, and the $stable array is
     // reviewers/CCs who haven't changed. We're going to send new reviewers/CCs
     // a different ("welcome") email than we send stable reviewers/CCs.
     $old = array('rev' => array_fill_keys($revision->getReviewers(), true), 'ccs' => array_fill_keys($revision->getCCPHIDs(), true));
     $xscript_header = null;
     $xscript_uri = null;
     $new = array('rev' => array_fill_keys($this->reviewers, true), 'ccs' => array_fill_keys($this->cc, true));
     $rem_ccs = array();
     $xscript_phid = null;
     if ($diff) {
         $adapter = new HeraldDifferentialRevisionAdapter($revision, $diff);
         $adapter->setExplicitCCs($new['ccs']);
         $adapter->setExplicitReviewers($new['rev']);
         $adapter->setForbiddenCCs($revision->getUnsubscribedPHIDs());
         $xscript = HeraldEngine::loadAndApplyRules($adapter);
         $xscript_uri = '/herald/transcript/' . $xscript->getID() . '/';
         $xscript_phid = $xscript->getPHID();
         $xscript_header = $xscript->getXHeraldRulesHeader();
         $xscript_header = HeraldTranscript::saveXHeraldRulesHeader($revision->getPHID(), $xscript_header);
         $sub = array('rev' => array(), 'ccs' => $adapter->getCCsAddedByHerald());
         $rem_ccs = $adapter->getCCsRemovedByHerald();
     } else {
         $sub = array('rev' => array(), 'ccs' => array());
     }
     // Remove any CCs which are prevented by Herald rules.
     $sub['ccs'] = array_diff_key($sub['ccs'], $rem_ccs);
     $new['ccs'] = array_diff_key($new['ccs'], $rem_ccs);
     $add = array();
     $rem = array();
     $stable = array();
     foreach (array('rev', 'ccs') as $key) {
         $add[$key] = array();
         if ($new[$key] !== null) {
             $add[$key] += array_diff_key($new[$key], $old[$key]);
         }
         $add[$key] += array_diff_key($sub[$key], $old[$key]);
         $combined = $sub[$key];
         if ($new[$key] !== null) {
             $combined += $new[$key];
         }
         $rem[$key] = array_diff_key($old[$key], $combined);
         $stable[$key] = array_diff_key($old[$key], $add[$key] + $rem[$key]);
     }
     self::alterReviewers($revision, $this->reviewers, array_keys($rem['rev']), array_keys($add['rev']), $this->actorPHID);
     // We want to attribute new CCs to a "reasonPHID", representing the reason
     // they were added. This is either a user (if some user explicitly CCs
     // them, or uses "Add CCs...") or a Herald transcript PHID, indicating that
     // they were added by a Herald rule.
     if ($add['ccs'] || $rem['ccs']) {
         $reasons = array();
         foreach ($add['ccs'] as $phid => $ignored) {
             if (empty($new['ccs'][$phid])) {
                 $reasons[$phid] = $xscript_phid;
             } else {
                 $reasons[$phid] = $this->actorPHID;
             }
         }
         foreach ($rem['ccs'] as $phid => $ignored) {
             if (empty($new['ccs'][$phid])) {
                 $reasons[$phid] = $this->actorPHID;
             } else {
                 $reasons[$phid] = $xscript_phid;
             }
         }
     } else {
         $reasons = $this->actorPHID;
     }
     self::alterCCs($revision, $this->cc, array_keys($rem['ccs']), array_keys($add['ccs']), $reasons);
     $this->updateAuxiliaryFields();
     // Add the author and users included from Herald rules to the relevant set
     // of users so they get a copy of the email.
     if (!$this->silentUpdate) {
         if ($is_new) {
             $add['rev'][$this->getActorPHID()] = true;
             if ($diff) {
                 $add['rev'] += $adapter->getEmailPHIDsAddedByHerald();
             }
         } else {
             $stable['rev'][$this->getActorPHID()] = true;
             if ($diff) {
                 $stable['rev'] += $adapter->getEmailPHIDsAddedByHerald();
             }
         }
     }
     $mail = array();
     $phids = array($this->getActorPHID());
     $handles = id(new PhabricatorObjectHandleData($phids))->loadHandles();
     $actor_handle = $handles[$this->getActorPHID()];
     $changesets = null;
     $comment = null;
     if ($diff) {
         $changesets = $diff->loadChangesets();
         // TODO: This should probably be in DifferentialFeedbackEditor?
         if (!$is_new) {
             $comment = $this->createComment();
         }
         if ($comment) {
             $mail[] = id(new DifferentialNewDiffMail($revision, $actor_handle, $changesets))->setIsFirstMailAboutRevision($is_new)->setIsFirstMailToRecipients($is_new)->setComments($this->getComments())->setToPHIDs(array_keys($stable['rev']))->setCCPHIDs(array_keys($stable['ccs']));
         }
         // Save the changes we made above.
         $diff->setDescription(preg_replace('/\\n.*/s', '', $this->getComments()));
         $diff->save();
         $this->updateAffectedPathTable($revision, $diff, $changesets);
         $this->updateRevisionHashTable($revision, $diff);
         // An updated diff should require review, as long as it's not closed
         // or accepted. The "accepted" status is "sticky" to encourage courtesy
         // re-diffs after someone accepts with minor changes/suggestions.
         $status = $revision->getStatus();
         if ($status != ArcanistDifferentialRevisionStatus::CLOSED && $status != ArcanistDifferentialRevisionStatus::ACCEPTED) {
             $revision->setStatus(ArcanistDifferentialRevisionStatus::NEEDS_REVIEW);
         }
     } else {
         $diff = $revision->loadActiveDiff();
         if ($diff) {
             $changesets = $diff->loadChangesets();
         } else {
             $changesets = array();
         }
     }
     $revision->save();
     $this->didWriteRevision();
     $event_data = array('revision_id' => $revision->getID(), 'revision_phid' => $revision->getPHID(), 'revision_name' => $revision->getTitle(), 'revision_author_phid' => $revision->getAuthorPHID(), 'action' => $is_new ? DifferentialAction::ACTION_CREATE : DifferentialAction::ACTION_UPDATE, 'feedback_content' => $is_new ? phutil_utf8_shorten($revision->getSummary(), 140) : $this->getComments(), 'actor_phid' => $revision->getAuthorPHID());
     id(new PhabricatorTimelineEvent('difx', $event_data))->recordEvent();
     id(new PhabricatorFeedStoryPublisher())->setStoryType(PhabricatorFeedStoryTypeConstants::STORY_DIFFERENTIAL)->setStoryData($event_data)->setStoryTime(time())->setStoryAuthorPHID($revision->getAuthorPHID())->setRelatedPHIDs(array($revision->getPHID(), $revision->getAuthorPHID()))->setPrimaryObjectPHID($revision->getPHID())->setSubscribedPHIDs(array_merge(array($revision->getAuthorPHID()), $revision->getReviewers(), $revision->getCCPHIDs()))->publish();
     //  TODO: Move this into a worker task thing.
     PhabricatorSearchDifferentialIndexer::indexRevision($revision);
     if ($this->silentUpdate) {
         return;
     }
     $revision->loadRelationships();
     if ($add['rev']) {
         $message = id(new DifferentialNewDiffMail($revision, $actor_handle, $changesets))->setIsFirstMailAboutRevision($is_new)->setIsFirstMailToRecipients(true)->setToPHIDs(array_keys($add['rev']));
         if ($is_new) {
             // The first time we send an email about a revision, put the CCs in
             // the "CC:" field of the same "Review Requested" email that reviewers
             // get, so you don't get two initial emails if you're on a list that
             // is CC'd.
             $message->setCCPHIDs(array_keys($add['ccs']));
         }
         $mail[] = $message;
     }
     // If we added CCs, we want to send them an email, but only if they were not
     // already a reviewer and were not added as one (in these cases, they got
     // a "NewDiff" mail, either in the past or just a moment ago). You can still
     // get two emails, but only if a revision is updated and you are added as a
     // reviewer at the same time a list you are on is added as a CC, which is
     // rare and reasonable.
     $implied_ccs = self::getImpliedCCs($revision);
     $implied_ccs = array_fill_keys($implied_ccs, true);
     $add['ccs'] = array_diff_key($add['ccs'], $implied_ccs);
     if (!$is_new && $add['ccs']) {
         $mail[] = id(new DifferentialCCWelcomeMail($revision, $actor_handle, $changesets))->setIsFirstMailToRecipients(true)->setToPHIDs(array_keys($add['ccs']));
     }
     foreach ($mail as $message) {
         $message->setHeraldTranscriptURI($xscript_uri);
         $message->setXHeraldRulesHeader($xscript_header);
         $message->send();
     }
 }
 public final function applyTransactions(PhabricatorLiskDAO $object, array $xactions)
 {
     $this->object = $object;
     $this->xactions = $xactions;
     $this->isNewObject = $object->getPHID() === null;
     $this->validateEditParameters($object, $xactions);
     $actor = $this->requireActor();
     // NOTE: Some transaction expansion requires that the edited object be
     // attached.
     foreach ($xactions as $xaction) {
         $xaction->attachObject($object);
         $xaction->attachViewer($actor);
     }
     $xactions = $this->expandTransactions($object, $xactions);
     $xactions = $this->expandSupportTransactions($object, $xactions);
     $xactions = $this->combineTransactions($xactions);
     foreach ($xactions as $xaction) {
         $xaction = $this->populateTransaction($object, $xaction);
     }
     $is_preview = $this->getIsPreview();
     $read_locking = false;
     $transaction_open = false;
     if (!$is_preview) {
         $errors = array();
         $type_map = mgroup($xactions, 'getTransactionType');
         foreach ($this->getTransactionTypes() as $type) {
             $type_xactions = idx($type_map, $type, array());
             $errors[] = $this->validateTransaction($object, $type, $type_xactions);
         }
         $errors[] = $this->validateAllTransactions($object, $xactions);
         $errors = array_mergev($errors);
         $continue_on_missing = $this->getContinueOnMissingFields();
         foreach ($errors as $key => $error) {
             if ($continue_on_missing && $error->getIsMissingFieldError()) {
                 unset($errors[$key]);
             }
         }
         if ($errors) {
             throw new PhabricatorApplicationTransactionValidationException($errors);
         }
         $this->willApplyTransactions($object, $xactions);
         if ($object->getID()) {
             foreach ($xactions as $xaction) {
                 // If any of the transactions require a read lock, hold one and
                 // reload the object. We need to do this fairly early so that the
                 // call to `adjustTransactionValues()` (which populates old values)
                 // is based on the synchronized state of the object, which may differ
                 // from the state when it was originally loaded.
                 if ($this->shouldReadLock($object, $xaction)) {
                     $object->openTransaction();
                     $object->beginReadLocking();
                     $transaction_open = true;
                     $read_locking = true;
                     $object->reload();
                     break;
                 }
             }
         }
         if ($this->shouldApplyInitialEffects($object, $xactions)) {
             if (!$transaction_open) {
                 $object->openTransaction();
                 $transaction_open = true;
             }
         }
     }
     if ($this->shouldApplyInitialEffects($object, $xactions)) {
         $this->applyInitialEffects($object, $xactions);
     }
     foreach ($xactions as $xaction) {
         $this->adjustTransactionValues($object, $xaction);
     }
     try {
         $xactions = $this->filterTransactions($object, $xactions);
     } catch (Exception $ex) {
         if ($read_locking) {
             $object->endReadLocking();
         }
         if ($transaction_open) {
             $object->killTransaction();
         }
         throw $ex;
     }
     // TODO: Once everything is on EditEngine, just use getIsNewObject() to
     // figure this out instead.
     $mark_as_create = false;
     $create_type = PhabricatorTransactions::TYPE_CREATE;
     foreach ($xactions as $xaction) {
         if ($xaction->getTransactionType() == $create_type) {
             $mark_as_create = true;
         }
     }
     if ($mark_as_create) {
         foreach ($xactions as $xaction) {
             $xaction->setIsCreateTransaction(true);
         }
     }
     // Now that we've merged, filtered, and combined transactions, check for
     // required capabilities.
     foreach ($xactions as $xaction) {
         $this->requireCapabilities($object, $xaction);
     }
     $xactions = $this->sortTransactions($xactions);
     $file_phids = $this->extractFilePHIDs($object, $xactions);
     if ($is_preview) {
         $this->loadHandles($xactions);
         return $xactions;
     }
     $comment_editor = id(new PhabricatorApplicationTransactionCommentEditor())->setActor($actor)->setActingAsPHID($this->getActingAsPHID())->setContentSource($this->getContentSource());
     if (!$transaction_open) {
         $object->openTransaction();
     }
     try {
         foreach ($xactions as $xaction) {
             $this->applyInternalEffects($object, $xaction);
         }
         $xactions = $this->didApplyInternalEffects($object, $xactions);
         try {
             $object->save();
         } catch (AphrontDuplicateKeyQueryException $ex) {
             // This callback has an opportunity to throw a better exception,
             // so execution may end here.
             $this->didCatchDuplicateKeyException($object, $xactions, $ex);
             throw $ex;
         }
         foreach ($xactions as $xaction) {
             $xaction->setObjectPHID($object->getPHID());
             if ($xaction->getComment()) {
                 $xaction->setPHID($xaction->generatePHID());
                 $comment_editor->applyEdit($xaction, $xaction->getComment());
             } else {
                 $xaction->save();
             }
         }
         if ($file_phids) {
             $this->attachFiles($object, $file_phids);
         }
         foreach ($xactions as $xaction) {
             $this->applyExternalEffects($object, $xaction);
         }
         $xactions = $this->applyFinalEffects($object, $xactions);
         if ($read_locking) {
             $object->endReadLocking();
             $read_locking = false;
         }
         $object->saveTransaction();
     } catch (Exception $ex) {
         $object->killTransaction();
         throw $ex;
     }
     // Now that we've completely applied the core transaction set, try to apply
     // Herald rules. Herald rules are allowed to either take direct actions on
     // the database (like writing flags), or take indirect actions (like saving
     // some targets for CC when we generate mail a little later), or return
     // transactions which we'll apply normally using another Editor.
     // First, check if *this* is a sub-editor which is itself applying Herald
     // rules: if it is, stop working and return so we don't descend into
     // madness.
     // Otherwise, we're not a Herald editor, so process Herald rules (possibly
     // using a Herald editor to apply resulting transactions) and then send out
     // mail, notifications, and feed updates about everything.
     if ($this->getIsHeraldEditor()) {
         // We are the Herald editor, so stop work here and return the updated
         // transactions.
         return $xactions;
     } else {
         if ($this->getIsInverseEdgeEditor()) {
             // If we're applying inverse edge transactions, don't trigger Herald.
             // From a product perspective, the current set of inverse edges (most
             // often, mentions) aren't things users would expect to trigger Herald.
             // From a technical perspective, objects loaded by the inverse editor may
             // not have enough data to execute rules. At least for now, just stop
             // Herald from executing when applying inverse edges.
         } else {
             if ($this->shouldApplyHeraldRules($object, $xactions)) {
                 // We are not the Herald editor, so try to apply Herald rules.
                 $herald_xactions = $this->applyHeraldRules($object, $xactions);
                 if ($herald_xactions) {
                     $xscript_id = $this->getHeraldTranscript()->getID();
                     foreach ($herald_xactions as $herald_xaction) {
                         // Don't set a transcript ID if this is a transaction from another
                         // application or source, like Owners.
                         if ($herald_xaction->getAuthorPHID()) {
                             continue;
                         }
                         $herald_xaction->setMetadataValue('herald:transcriptID', $xscript_id);
                     }
                     // NOTE: We're acting as the omnipotent user because rules deal with
                     // their own policy issues. We use a synthetic author PHID (the
                     // Herald application) as the author of record, so that transactions
                     // will render in a reasonable way ("Herald assigned this task ...").
                     $herald_actor = PhabricatorUser::getOmnipotentUser();
                     $herald_phid = id(new PhabricatorHeraldApplication())->getPHID();
                     // TODO: It would be nice to give transactions a more specific source
                     // which points at the rule which generated them. You can figure this
                     // out from transcripts, but it would be cleaner if you didn't have to.
                     $herald_source = PhabricatorContentSource::newForSource(PhabricatorHeraldContentSource::SOURCECONST);
                     $herald_editor = newv(get_class($this), array())->setContinueOnNoEffect(true)->setContinueOnMissingFields(true)->setParentMessageID($this->getParentMessageID())->setIsHeraldEditor(true)->setActor($herald_actor)->setActingAsPHID($herald_phid)->setContentSource($herald_source);
                     $herald_xactions = $herald_editor->applyTransactions($object, $herald_xactions);
                     // Merge the new transactions into the transaction list: we want to
                     // send email and publish feed stories about them, too.
                     $xactions = array_merge($xactions, $herald_xactions);
                 }
                 // If Herald did not generate transactions, we may still need to handle
                 // "Send an Email" rules.
                 $adapter = $this->getHeraldAdapter();
                 $this->heraldEmailPHIDs = $adapter->getEmailPHIDs();
                 $this->heraldForcedEmailPHIDs = $adapter->getForcedEmailPHIDs();
             }
         }
     }
     $this->didApplyTransactions($xactions);
     if ($object instanceof PhabricatorCustomFieldInterface) {
         // Maybe this makes more sense to move into the search index itself? For
         // now I'm putting it here since I think we might end up with things that
         // need it to be up to date once the next page loads, but if we don't go
         // there we could move it into search once search moves to the daemons.
         // It now happens in the search indexer as well, but the search indexer is
         // always daemonized, so the logic above still potentially holds. We could
         // possibly get rid of this. The major motivation for putting it in the
         // indexer was to enable reindexing to work.
         $fields = PhabricatorCustomField::getObjectFields($object, PhabricatorCustomField::ROLE_APPLICATIONSEARCH);
         $fields->readFieldsFromStorage($object);
         $fields->rebuildIndexes($object);
     }
     $herald_xscript = $this->getHeraldTranscript();
     if ($herald_xscript) {
         $herald_header = $herald_xscript->getXHeraldRulesHeader();
         $herald_header = HeraldTranscript::saveXHeraldRulesHeader($object->getPHID(), $herald_header);
     } else {
         $herald_header = HeraldTranscript::loadXHeraldRulesHeader($object->getPHID());
     }
     $this->heraldHeader = $herald_header;
     // We're going to compute some of the data we'll use to publish these
     // transactions here, before queueing a worker.
     //
     // Primarily, this is more correct: we want to publish the object as it
     // exists right now. The worker may not execute for some time, and we want
     // to use the current To/CC list, not respect any changes which may occur
     // between now and when the worker executes.
     //
     // As a secondary benefit, this tends to reduce the amount of state that
     // Editors need to pass into workers.
     $object = $this->willPublish($object, $xactions);
     if (!$this->getDisableEmail()) {
         if ($this->shouldSendMail($object, $xactions)) {
             $this->mailToPHIDs = $this->getMailTo($object);
             $this->mailCCPHIDs = $this->getMailCC($object);
         }
     }
     if ($this->shouldPublishFeedStory($object, $xactions)) {
         $this->feedRelatedPHIDs = $this->getFeedRelatedPHIDs($object, $xactions);
         $this->feedNotifyPHIDs = $this->getFeedNotifyPHIDs($object, $xactions);
     }
     PhabricatorWorker::scheduleTask('PhabricatorApplicationTransactionPublishWorker', array('objectPHID' => $object->getPHID(), 'actorPHID' => $this->getActingAsPHID(), 'xactionPHIDs' => mpull($xactions, 'getPHID'), 'state' => $this->getWorkerState()), array('objectPHID' => $object->getPHID(), 'priority' => PhabricatorWorker::PRIORITY_ALERTS));
     return $xactions;
 }
 public function save()
 {
     $revision = $this->getRevision();
     // TODO
     //    $revision->openTransaction();
     $is_new = $this->isNewRevision();
     if ($is_new) {
         // These fields aren't nullable; set them to sensible defaults if they
         // haven't been configured. We're just doing this so we can generate an
         // ID for the revision if we don't have one already.
         $revision->setLineCount(0);
         if ($revision->getStatus() === null) {
             $revision->setStatus(DifferentialRevisionStatus::NEEDS_REVIEW);
         }
         if ($revision->getTitle() === null) {
             $revision->setTitle('Untitled Revision');
         }
         if ($revision->getAuthorPHID() === null) {
             $revision->setAuthorPHID($this->getActorPHID());
         }
         if ($revision->getSummary() === null) {
             $revision->setSummary('');
         }
         if ($revision->getTestPlan() === null) {
             $revision->setTestPlan('');
         }
         $revision->save();
     }
     $revision->loadRelationships();
     $this->willWriteRevision();
     if ($this->reviewers === null) {
         $this->reviewers = $revision->getReviewers();
     }
     if ($this->cc === null) {
         $this->cc = $revision->getCCPHIDs();
     }
     // We're going to build up three dictionaries: $add, $rem, and $stable. The
     // $add dictionary has added reviewers/CCs. The $rem dictionary has
     // reviewers/CCs who have been removed, and the $stable array is
     // reviewers/CCs who haven't changed. We're going to send new reviewers/CCs
     // a different ("welcome") email than we send stable reviewers/CCs.
     $old = array('rev' => array_fill_keys($revision->getReviewers(), true), 'ccs' => array_fill_keys($revision->getCCPHIDs(), true));
     $diff = $this->getDiff();
     $xscript_header = null;
     $xscript_uri = null;
     $new = array('rev' => array_fill_keys($this->reviewers, true), 'ccs' => array_fill_keys($this->cc, true));
     $rem_ccs = array();
     if ($diff) {
         $diff->setRevisionID($revision->getID());
         $revision->setLineCount($diff->getLineCount());
         $adapter = new HeraldDifferentialRevisionAdapter($revision, $diff);
         $adapter->setExplicitCCs($new['ccs']);
         $adapter->setExplicitReviewers($new['rev']);
         $adapter->setForbiddenCCs($revision->getUnsubscribedPHIDs());
         $xscript = HeraldEngine::loadAndApplyRules($adapter);
         $xscript_uri = PhabricatorEnv::getProductionURI('/herald/transcript/' . $xscript->getID() . '/');
         $xscript_phid = $xscript->getPHID();
         $xscript_header = $xscript->getXHeraldRulesHeader();
         $xscript_header = HeraldTranscript::saveXHeraldRulesHeader($revision->getPHID(), $xscript_header);
         $sub = array('rev' => array(), 'ccs' => $adapter->getCCsAddedByHerald());
         $rem_ccs = $adapter->getCCsRemovedByHerald();
     } else {
         $sub = array('rev' => array(), 'ccs' => array());
     }
     // Remove any CCs which are prevented by Herald rules.
     $sub['ccs'] = array_diff_key($sub['ccs'], $rem_ccs);
     $new['ccs'] = array_diff_key($new['ccs'], $rem_ccs);
     $add = array();
     $rem = array();
     $stable = array();
     foreach (array('rev', 'ccs') as $key) {
         $add[$key] = array();
         if ($new[$key] !== null) {
             $add[$key] += array_diff_key($new[$key], $old[$key]);
         }
         $add[$key] += array_diff_key($sub[$key], $old[$key]);
         $combined = $sub[$key];
         if ($new[$key] !== null) {
             $combined += $new[$key];
         }
         $rem[$key] = array_diff_key($old[$key], $combined);
         $stable[$key] = array_diff_key($old[$key], $add[$key] + $rem[$key]);
     }
     self::alterReviewers($revision, $this->reviewers, array_keys($rem['rev']), array_keys($add['rev']), $this->actorPHID);
     /*
     
         // TODO: When Herald is brought over, run through this stuff to figure
         // out which adds are Herald's fault.
     
         // TODO: Still need to do this.
     
         if ($add['ccs'] || $rem['ccs']) {
           foreach (array_keys($add['ccs']) as $id) {
             if (empty($new['ccs'][$id])) {
               $reason_phid = 'TODO';//$xscript_phid;
             } else {
               $reason_phid = $this->getActorPHID();
             }
           }
           foreach (array_keys($rem['ccs']) as $id) {
             if (empty($new['ccs'][$id])) {
               $reason_phid = $this->getActorPHID();
             } else {
               $reason_phid = 'TODO';//$xscript_phid;
             }
           }
         }
     */
     self::alterCCs($revision, $this->cc, array_keys($rem['ccs']), array_keys($add['ccs']), $this->actorPHID);
     $this->updateAuxiliaryFields();
     // Add the author and users included from Herald rules to the relevant set
     // of users so they get a copy of the email.
     if (!$this->silentUpdate) {
         if ($is_new) {
             $add['rev'][$this->getActorPHID()] = true;
             if ($diff) {
                 $add['rev'] += $adapter->getEmailPHIDsAddedByHerald();
             }
         } else {
             $stable['rev'][$this->getActorPHID()] = true;
             if ($diff) {
                 $stable['rev'] += $adapter->getEmailPHIDsAddedByHerald();
             }
         }
     }
     $mail = array();
     $phids = array($this->getActorPHID());
     $handles = id(new PhabricatorObjectHandleData($phids))->loadHandles();
     $actor_handle = $handles[$this->getActorPHID()];
     $changesets = null;
     $comment = null;
     if ($diff) {
         $changesets = $diff->loadChangesets();
         // TODO: This should probably be in DifferentialFeedbackEditor?
         if (!$is_new) {
             $comment = $this->createComment();
         }
         if ($comment) {
             $mail[] = id(new DifferentialNewDiffMail($revision, $actor_handle, $changesets))->setIsFirstMailAboutRevision($is_new)->setIsFirstMailToRecipients($is_new)->setComments($this->getComments())->setToPHIDs(array_keys($stable['rev']))->setCCPHIDs(array_keys($stable['ccs']));
         }
         // Save the changes we made above.
         $diff->setDescription(substr($this->getComments(), 0, 80));
         $diff->save();
         // An updated diff should require review, as long as it's not committed
         // or accepted. The "accepted" status is "sticky" to encourage courtesy
         // re-diffs after someone accepts with minor changes/suggestions.
         $status = $revision->getStatus();
         if ($status != DifferentialRevisionStatus::COMMITTED && $status != DifferentialRevisionStatus::ACCEPTED) {
             $revision->setStatus(DifferentialRevisionStatus::NEEDS_REVIEW);
         }
     } else {
         $diff = $revision->loadActiveDiff();
         if ($diff) {
             $changesets = $diff->loadChangesets();
         } else {
             $changesets = array();
         }
     }
     $revision->save();
     $this->didWriteRevision();
     $event_data = array('revision_id' => $revision->getID(), 'revision_phid' => $revision->getPHID(), 'revision_name' => $revision->getTitle(), 'revision_author_phid' => $revision->getAuthorPHID(), 'action' => $is_new ? DifferentialAction::ACTION_CREATE : DifferentialAction::ACTION_UPDATE, 'feedback_content' => $is_new ? phutil_utf8_shorten($revision->getSummary(), 140) : $this->getComments(), 'actor_phid' => $revision->getAuthorPHID());
     id(new PhabricatorTimelineEvent('difx', $event_data))->recordEvent();
     id(new PhabricatorFeedStoryPublisher())->setStoryType(PhabricatorFeedStoryTypeConstants::STORY_DIFFERENTIAL)->setStoryData($event_data)->setStoryTime(time())->setStoryAuthorPHID($revision->getAuthorPHID())->setRelatedPHIDs(array($revision->getPHID(), $revision->getAuthorPHID()))->publish();
     // TODO
     //    $revision->saveTransaction();
     //  TODO: Move this into a worker task thing.
     PhabricatorSearchDifferentialIndexer::indexRevision($revision);
     if ($this->silentUpdate) {
         return;
     }
     $revision->loadRelationships();
     if ($add['rev']) {
         $message = id(new DifferentialNewDiffMail($revision, $actor_handle, $changesets))->setIsFirstMailAboutRevision($is_new)->setIsFirstMailToRecipients(true)->setToPHIDs(array_keys($add['rev']));
         if ($is_new) {
             // The first time we send an email about a revision, put the CCs in
             // the "CC:" field of the same "Review Requested" email that reviewers
             // get, so you don't get two initial emails if you're on a list that
             // is CC'd.
             $message->setCCPHIDs(array_keys($add['ccs']));
         }
         $mail[] = $message;
     }
     // If you were added as a reviewer and a CC, just give you the reviewer
     // email. We could go to greater lengths to prevent this, but there's
     // bunch of stuff with list subscriptions anyway. You can still get two
     // emails, but only if a revision is updated and you are added as a reviewer
     // at the same time a list you are on is added as a CC, which is rare and
     // reasonable.
     $add['ccs'] = array_diff_key($add['ccs'], $add['rev']);
     if (!$is_new && $add['ccs']) {
         $mail[] = id(new DifferentialCCWelcomeMail($revision, $actor_handle, $changesets))->setIsFirstMailToRecipients(true)->setToPHIDs(array_keys($add['ccs']));
     }
     foreach ($mail as $message) {
         $message->setHeraldTranscriptURI($xscript_uri);
         $message->setXHeraldRulesHeader($xscript_header);
         $message->send();
     }
 }