Support Herald rules for Herald rules

Summary:
Depends on D19399. Ref T13130. This adds basic support for writing Herald rules against Herald rules. See T13130 for a lot more detail.

This needs a bit more work to be useful: for example, there's no way to specify the rule type or subject, so you can't say "notify me when global rules are edited" or "notify me when Maniphest rules are edited". I'll add some fields for that in followup changes to actually solve the original use case.

Test Plan:
  - Wrote Herald rules against Herald rules.
  - Ran them by editing rules and in the test console.
  - Verified they sent some mail with `bin/mail list-outbound`.

Reviewers: amckinley

Reviewed By: amckinley

Maniphest Tasks: T13130

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

src/__phutil_library_map__.php

@@ -1485,12 +1485,14 @@ phutil_register_library_map(array(
     'HeraldRemarkupFieldValue' => 'applications/herald/value/HeraldRemarkupFieldValue.php',
     'HeraldRemarkupRule' => 'applications/herald/remarkup/HeraldRemarkupRule.php',
     'HeraldRule' => 'applications/herald/storage/HeraldRule.php',
+    'HeraldRuleAdapter' => 'applications/herald/adapter/HeraldRuleAdapter.php',
     'HeraldRuleController' => 'applications/herald/controller/HeraldRuleController.php',
     'HeraldRuleDatasource' => 'applications/herald/typeahead/HeraldRuleDatasource.php',
     'HeraldRuleEditor' => 'applications/herald/editor/HeraldRuleEditor.php',
     'HeraldRuleListController' => 'applications/herald/controller/HeraldRuleListController.php',
     'HeraldRulePHIDType' => 'applications/herald/phid/HeraldRulePHIDType.php',
     'HeraldRuleQuery' => 'applications/herald/query/HeraldRuleQuery.php',
+    'HeraldRuleReplyHandler' => 'applications/herald/mail/HeraldRuleReplyHandler.php',
     'HeraldRuleSearchEngine' => 'applications/herald/query/HeraldRuleSearchEngine.php',
     'HeraldRuleSerializer' => 'applications/herald/editor/HeraldRuleSerializer.php',
     'HeraldRuleTestCase' => 'applications/herald/storage/__tests__/HeraldRuleTestCase.php',
@@ -6918,12 +6920,14 @@ phutil_register_library_map(array(
       'PhabricatorDestructibleInterface',
       'PhabricatorSubscribableInterface',
     ),
+    'HeraldRuleAdapter' => 'HeraldAdapter',
     'HeraldRuleController' => 'HeraldController',
     'HeraldRuleDatasource' => 'PhabricatorTypeaheadDatasource',
     'HeraldRuleEditor' => 'PhabricatorApplicationTransactionEditor',
     'HeraldRuleListController' => 'HeraldController',
     'HeraldRulePHIDType' => 'PhabricatorPHIDType',
     'HeraldRuleQuery' => 'PhabricatorCursorPagedPolicyAwareQuery',
+    'HeraldRuleReplyHandler' => 'PhabricatorApplicationTransactionReplyHandler',
     'HeraldRuleSearchEngine' => 'PhabricatorApplicationSearchEngine',
     'HeraldRuleSerializer' => 'Phobject',
     'HeraldRuleTestCase' => 'PhabricatorTestCase',

src/applications/herald/adapter/HeraldRuleAdapter.php

@@ -0,0 +1,74 @@
+<?php
+
+final class HeraldRuleAdapter extends HeraldAdapter {
+
+  private $rule;
+
+  protected function newObject() {
+    return new HeraldRule();
+  }
+
+  public function getAdapterApplicationClass() {
+    return 'PhabricatorHeraldApplication';
+  }
+
+  public function getAdapterContentDescription() {
+    return pht('React to Herald rules being created or updated.');
+  }
+
+  public function isTestAdapterForObject($object) {
+    return ($object instanceof HeraldRule);
+  }
+
+  public function getAdapterTestDescription() {
+    return pht(
+      'Test rules which run when another Herald rule is created or '.
+      'updated.');
+  }
+
+  protected function initializeNewAdapter() {
+    $this->rule = $this->newObject();
+  }
+
+  public function supportsApplicationEmail() {
+    return true;
+  }
+
+  public function supportsRuleType($rule_type) {
+    switch ($rule_type) {
+      case HeraldRuleTypeConfig::RULE_TYPE_GLOBAL:
+      case HeraldRuleTypeConfig::RULE_TYPE_PERSONAL:
+        return true;
+      case HeraldRuleTypeConfig::RULE_TYPE_OBJECT:
+      default:
+        return false;
+    }
+  }
+
+  public function setRule(HeraldRule $rule) {
+    $this->rule = $rule;
+    return $this;
+  }
+
+  public function getRule() {
+    return $this->rule;
+  }
+
+  public function setObject($object) {
+    $this->rule = $object;
+    return $this;
+  }
+
+  public function getObject() {
+    return $this->rule;
+  }
+
+  public function getAdapterContentName() {
+    return pht('Herald Rules');
+  }
+
+  public function getHeraldName() {
+    return $this->getRule()->getMonogram();
+  }
+
+}

src/applications/herald/editor/HeraldRuleEditor.php

@@ -87,4 +87,54 @@ final class HeraldRuleEditor
     return;
   }
 
+  protected function shouldApplyHeraldRules(
+    PhabricatorLiskDAO $object,
+    array $xactions) {
+    return true;
+  }
+
+  protected function buildHeraldAdapter(
+    PhabricatorLiskDAO $object,
+    array $xactions) {
+    return id(new HeraldRuleAdapter())
+      ->setRule($object);
+  }
+
+  protected function shouldSendMail(
+    PhabricatorLiskDAO $object,
+    array $xactions) {
+    return true;
+  }
+
+  protected function getMailTo(PhabricatorLiskDAO $object) {
+    $phids = array();
+
+    $phids[] = $this->getActingAsPHID();
+
+    if ($object->isPersonalRule()) {
+      $phids[] = $object->getAuthorPHID();
+    }
+
+    return $phids;
+  }
+
+  protected function buildReplyHandler(PhabricatorLiskDAO $object) {
+    return id(new HeraldRuleReplyHandler())
+      ->setMailReceiver($object);
+  }
+
+  protected function buildMailTemplate(PhabricatorLiskDAO $object) {
+    $monogram = $object->getMonogram();
+    $name = $object->getName();
+
+    $subject = pht('%s: %s', $monogram, $name);
+
+    return id(new PhabricatorMetaMTAMail())
+      ->setSubject($subject);
+  }
+
+  protected function getMailSubjectPrefix() {
+    return pht('[Herald]');
+  }
+
 }

src/applications/herald/mail/HeraldRuleReplyHandler.php

@@ -0,0 +1,16 @@
+<?php
+
+final class HeraldRuleReplyHandler
+  extends PhabricatorApplicationTransactionReplyHandler {
+
+  public function validateMailReceiver($mail_receiver) {
+    if (!($mail_receiver instanceof HeraldRule)) {
+      throw new Exception(pht('Mail receiver is not a %s!', 'HeraldRule'));
+    }
+  }
+
+  public function getObjectPrefix() {
+    return 'H';
+  }
+
+}