Modularize content sources

Summary:
Ref T10537. For Nuance, I want to introduce new sources (like "GitHub" or "GitHub via Nuance" or something) but this needs to modularize eventually.

Split ContentSource apart so applications can add new content sources.

Test Plan:
This change has huge surface area, so I'll hold it until post-release. I think it's fairly safe (and if it does break anything, the breaks should be fatals, not anything subtle or difficult to fix), there's just no reason not to hold it for a few hours.

- Viewed new module page.
- Grepped for all removed functions/constants.
- Viewed some transactions.
- Hovered over timestamps to get content source details.
- Added a comment via Conduit.
- Added a comment via web.
- Ran `bin/storage upgrade --namespace XXXXX --no-quickstart -f` to re-run all historic migrations.
- Generated some objects with `bin/lipsum`.
- Ran a bulk job on some tasks.
- Ran unit tests.

{F1190182}

Reviewers: chad

Reviewed By: chad

Maniphest Tasks: T10537

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

resources/sql/autopatches/20140211.dx.2.migcommenttext.php

···
 $rows = new LiskRawMigrationIterator($conn_w, 'differential_comment');
 
 $content_source = PhabricatorContentSource::newForSource(
-  PhabricatorContentSource::SOURCE_LEGACY,
-  array())->serialize();
+  PhabricatorOldWorldContentSource::SOURCECONST)->serialize();
 
 echo pht('Migrating Differential comment text to modern storage...')."\n";
 foreach ($rows as $row) {

resources/sql/autopatches/20140212.dx.1.armageddon.php

···
 $rows = new LiskRawMigrationIterator($conn_w, 'differential_comment');
 
 $content_source = PhabricatorContentSource::newForSource(
-  PhabricatorContentSource::SOURCE_LEGACY,
-  array())->serialize();
+  PhabricatorOldWorldContentSource::SOURCECONST)->serialize();
 
 echo pht('Migrating Differential comments to modern storage...')."\n";
 foreach ($rows as $row) {

resources/sql/autopatches/20140722.audit.3.miginlines.php

···
 echo pht('Migrating Audit inline comments to new format...')."\n";
 
 $content_source = PhabricatorContentSource::newForSource(
-  PhabricatorContentSource::SOURCE_LEGACY,
-  array())->serialize();
+  PhabricatorOldWorldContentSource::SOURCECONST)->serialize();
 
 $rows = new LiskRawMigrationIterator($conn_w, $src_table);
 foreach ($rows as $row) {

resources/sql/autopatches/20140722.audit.4.migtext.php

···
 $rows = new LiskRawMigrationIterator($conn_w, 'audit_comment');
 
 $content_source = PhabricatorContentSource::newForSource(
-  PhabricatorContentSource::SOURCE_LEGACY,
-  array())->serialize();
+  PhabricatorOldWorldContentSource::SOURCECONST)->serialize();
 
 echo pht('Migrating Audit comment text to modern storage...')."\n";
 foreach ($rows as $row) {

resources/sql/autopatches/20140725.audit.1.migxactions.php

···
 $rows = new LiskRawMigrationIterator($conn_w, 'audit_comment');
 
 $content_source = PhabricatorContentSource::newForSource(
-  PhabricatorContentSource::SOURCE_LEGACY,
-  array())->serialize();
+  PhabricatorOldWorldContentSource::SOURCECONST)->serialize();
 
 echo pht('Migrating Audit comments to modern storage...')."\n";
 foreach ($rows as $row) {

resources/sql/patches/20130715.votecomments.php

···
     PhabricatorApplicationTransactionTransactionPHIDType::TYPECONST,
     PhabricatorSlowvotePollPHIDType::TYPECONST);
 
-  $source = PhabricatorContentSource::newForSource(
-    PhabricatorContentSource::SOURCE_LEGACY,
-    array())->serialize();
+  $content_source = PhabricatorContentSource::newForSource(
+    PhabricatorOldWorldContentSource::SOURCECONST)->serialize();
 
   queryfx(
     $conn_w,

resources/sql/patches/20130728.ponderxcomment.php

···
     1,
     $row['content'],
     PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_LEGACY,
-      array())->serialize(),
+      PhabricatorOldWorldContentSource::SOURCECONST)->serialize(),
     0,
     $row['dateCreated'],
     $row['dateModified']);
···
     'null',
     'null',
     PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_LEGACY,
-      array())->serialize(),
+      PhabricatorOldWorldContentSource::SOURCECONST)->serialize(),
     '[]',
     $row['dateCreated'],
     $row['dateModified']);

resources/sql/patches/20130801.pastexactions.php

···
     'null',
     $row['filePHID'],
     PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_LEGACY,
-      array())->serialize(),
+      PhabricatorOldWorldContentSource::SOURCECONST)->serialize(),
     '[]',
     $row['dateCreated'],
     $row['dateCreated'],

resources/sql/patches/20130926.dinline.php

···
 echo pht('Migrating Differential inline comments to new format...')."\n";
 
 $content_source = PhabricatorContentSource::newForSource(
-  PhabricatorContentSource::SOURCE_LEGACY,
-  array())->serialize();
+  PhabricatorOldWorldContentSource::SOURCECONST)->serialize();
 
 $rows = new LiskRawMigrationIterator($conn_w, $src_table);
 foreach ($rows as $row) {

resources/sql/patches/20131020.pxactionmig.php

···
 echo pht('Migrating Project transactions to new format...')."\n";
 
 $content_source = PhabricatorContentSource::newForSource(
-  PhabricatorContentSource::SOURCE_LEGACY,
-  array())->serialize();
+  PhabricatorOldWorldContentSource::SOURCECONST)->serialize();
 
 $rows = new LiskRawMigrationIterator($conn_w, $src_table);
 foreach ($rows as $row) {

src/__phutil_library_map__.php

···
     'PhabricatorBotWhatsNewHandler' => 'infrastructure/daemon/bot/handler/PhabricatorBotWhatsNewHandler.php',
     'PhabricatorBritishEnglishTranslation' => 'infrastructure/internationalization/translation/PhabricatorBritishEnglishTranslation.php',
     'PhabricatorBuiltinPatchList' => 'infrastructure/storage/patch/PhabricatorBuiltinPatchList.php',
+    'PhabricatorBulkContentSource' => 'infrastructure/daemon/contentsource/PhabricatorBulkContentSource.php',
     'PhabricatorBusyUIExample' => 'applications/uiexample/examples/PhabricatorBusyUIExample.php',
     'PhabricatorCacheDAO' => 'applications/cache/storage/PhabricatorCacheDAO.php',
     'PhabricatorCacheGeneralGarbageCollector' => 'applications/cache/garbagecollector/PhabricatorCacheGeneralGarbageCollector.php',
···
     'PhabricatorConduitCertificateToken' => 'applications/conduit/storage/PhabricatorConduitCertificateToken.php',
     'PhabricatorConduitConnectionLog' => 'applications/conduit/storage/PhabricatorConduitConnectionLog.php',
     'PhabricatorConduitConsoleController' => 'applications/conduit/controller/PhabricatorConduitConsoleController.php',
+    'PhabricatorConduitContentSource' => 'infrastructure/contentsource/PhabricatorConduitContentSource.php',
     'PhabricatorConduitController' => 'applications/conduit/controller/PhabricatorConduitController.php',
     'PhabricatorConduitDAO' => 'applications/conduit/storage/PhabricatorConduitDAO.php',
     'PhabricatorConduitEditField' => 'applications/transactions/editfield/PhabricatorConduitEditField.php',
···
     'PhabricatorConpherencePreferencesSettingsPanel' => 'applications/settings/panel/PhabricatorConpherencePreferencesSettingsPanel.php',
     'PhabricatorConpherenceThreadPHIDType' => 'applications/conpherence/phid/PhabricatorConpherenceThreadPHIDType.php',
     'PhabricatorConsoleApplication' => 'applications/console/application/PhabricatorConsoleApplication.php',
-    'PhabricatorContentSource' => 'applications/metamta/contentsource/PhabricatorContentSource.php',
-    'PhabricatorContentSourceView' => 'applications/metamta/contentsource/PhabricatorContentSourceView.php',
+    'PhabricatorConsoleContentSource' => 'infrastructure/contentsource/PhabricatorConsoleContentSource.php',
+    'PhabricatorContentSource' => 'infrastructure/contentsource/PhabricatorContentSource.php',
+    'PhabricatorContentSourceModule' => 'infrastructure/contentsource/PhabricatorContentSourceModule.php',
+    'PhabricatorContentSourceView' => 'infrastructure/contentsource/PhabricatorContentSourceView.php',
     'PhabricatorContributedToObjectEdgeType' => 'applications/transactions/edges/PhabricatorContributedToObjectEdgeType.php',
     'PhabricatorController' => 'applications/base/controller/PhabricatorController.php',
     'PhabricatorCookies' => 'applications/auth/constants/PhabricatorCookies.php',
···
     'PhabricatorDaemonBulkJobMonitorController' => 'applications/daemon/controller/PhabricatorDaemonBulkJobMonitorController.php',
     'PhabricatorDaemonBulkJobViewController' => 'applications/daemon/controller/PhabricatorDaemonBulkJobViewController.php',
     'PhabricatorDaemonConsoleController' => 'applications/daemon/controller/PhabricatorDaemonConsoleController.php',
+    'PhabricatorDaemonContentSource' => 'infrastructure/daemon/contentsource/PhabricatorDaemonContentSource.php',
     'PhabricatorDaemonController' => 'applications/daemon/controller/PhabricatorDaemonController.php',
     'PhabricatorDaemonDAO' => 'applications/daemon/storage/PhabricatorDaemonDAO.php',
     'PhabricatorDaemonEventListener' => 'applications/daemon/event/PhabricatorDaemonEventListener.php',
···
     'PhabricatorElasticFulltextStorageEngine' => 'applications/search/fulltextstorage/PhabricatorElasticFulltextStorageEngine.php',
     'PhabricatorElasticSearchSetupCheck' => 'applications/config/check/PhabricatorElasticSearchSetupCheck.php',
     'PhabricatorEmailAddressesSettingsPanel' => 'applications/settings/panel/PhabricatorEmailAddressesSettingsPanel.php',
+    'PhabricatorEmailContentSource' => 'applications/metamta/contentsource/PhabricatorEmailContentSource.php',
     'PhabricatorEmailFormatSettingsPanel' => 'applications/settings/panel/PhabricatorEmailFormatSettingsPanel.php',
     'PhabricatorEmailLoginController' => 'applications/auth/controller/PhabricatorEmailLoginController.php',
     'PhabricatorEmailPreferencesSettingsPanel' => 'applications/settings/panel/PhabricatorEmailPreferencesSettingsPanel.php',
···
     'PhabricatorFactSimpleSpec' => 'applications/fact/spec/PhabricatorFactSimpleSpec.php',
     'PhabricatorFactSpec' => 'applications/fact/spec/PhabricatorFactSpec.php',
     'PhabricatorFactUpdateIterator' => 'applications/fact/extract/PhabricatorFactUpdateIterator.php',
+    'PhabricatorFaxContentSource' => 'infrastructure/contentsource/PhabricatorFaxContentSource.php',
     'PhabricatorFeedApplication' => 'applications/feed/application/PhabricatorFeedApplication.php',
     'PhabricatorFeedBuilder' => 'applications/feed/builder/PhabricatorFeedBuilder.php',
     'PhabricatorFeedConfigOptions' => 'applications/feed/config/PhabricatorFeedConfigOptions.php',
···
     'PhabricatorHelpKeyboardShortcutController' => 'applications/help/controller/PhabricatorHelpKeyboardShortcutController.php',
     'PhabricatorHelpMainMenuBarExtension' => 'applications/help/extension/PhabricatorHelpMainMenuBarExtension.php',
     'PhabricatorHeraldApplication' => 'applications/herald/application/PhabricatorHeraldApplication.php',
+    'PhabricatorHeraldContentSource' => 'applications/herald/contentsource/PhabricatorHeraldContentSource.php',
     'PhabricatorHighSecurityRequestExceptionHandler' => 'aphront/handler/PhabricatorHighSecurityRequestExceptionHandler.php',
     'PhabricatorHomeApplication' => 'applications/home/application/PhabricatorHomeApplication.php',
     'PhabricatorHomeController' => 'applications/home/controller/PhabricatorHomeController.php',
···
     'PhabricatorLibraryTestCase' => '__tests__/PhabricatorLibraryTestCase.php',
     'PhabricatorLinkProfilePanel' => 'applications/search/profilepanel/PhabricatorLinkProfilePanel.php',
     'PhabricatorLipsumArtist' => 'applications/lipsum/image/PhabricatorLipsumArtist.php',
+    'PhabricatorLipsumContentSource' => 'infrastructure/contentsource/PhabricatorLipsumContentSource.php',
     'PhabricatorLipsumGenerateWorkflow' => 'applications/lipsum/management/PhabricatorLipsumGenerateWorkflow.php',
     'PhabricatorLipsumManagementWorkflow' => 'applications/lipsum/management/PhabricatorLipsumManagementWorkflow.php',
     'PhabricatorLipsumMondrianArtist' => 'applications/lipsum/image/PhabricatorLipsumMondrianArtist.php',
···
     'PhabricatorObjectSelectorDialog' => 'view/control/PhabricatorObjectSelectorDialog.php',
     'PhabricatorObjectUsesCredentialsEdgeType' => 'applications/transactions/edges/PhabricatorObjectUsesCredentialsEdgeType.php',
     'PhabricatorOffsetPagedQuery' => 'infrastructure/query/PhabricatorOffsetPagedQuery.php',
+    'PhabricatorOldWorldContentSource' => 'infrastructure/contentsource/PhabricatorOldWorldContentSource.php',
     'PhabricatorOneTimeTriggerClock' => 'infrastructure/daemon/workers/clock/PhabricatorOneTimeTriggerClock.php',
     'PhabricatorOpcodeCacheSpec' => 'applications/cache/spec/PhabricatorOpcodeCacheSpec.php',
     'PhabricatorOwnerPathQuery' => 'applications/owners/query/PhabricatorOwnerPathQuery.php',
···
     'PhabricatorPholioConfigOptions' => 'applications/pholio/config/PhabricatorPholioConfigOptions.php',
     'PhabricatorPholioMockTestDataGenerator' => 'applications/pholio/lipsum/PhabricatorPholioMockTestDataGenerator.php',
     'PhabricatorPhortuneApplication' => 'applications/phortune/application/PhabricatorPhortuneApplication.php',
+    'PhabricatorPhortuneContentSource' => 'applications/phortune/contentsource/PhabricatorPhortuneContentSource.php',
     'PhabricatorPhortuneManagementInvoiceWorkflow' => 'applications/phortune/management/PhabricatorPhortuneManagementInvoiceWorkflow.php',
     'PhabricatorPhortuneManagementWorkflow' => 'applications/phortune/management/PhabricatorPhortuneManagementWorkflow.php',
     'PhabricatorPhragmentApplication' => 'applications/phragment/application/PhabricatorPhragmentApplication.php',
···
     'PhabricatorUIExampleRenderController' => 'applications/uiexample/controller/PhabricatorUIExampleRenderController.php',
     'PhabricatorUIExamplesApplication' => 'applications/uiexample/application/PhabricatorUIExamplesApplication.php',
     'PhabricatorUSEnglishTranslation' => 'infrastructure/internationalization/translation/PhabricatorUSEnglishTranslation.php',
+    'PhabricatorUnitTestContentSource' => 'infrastructure/contentsource/PhabricatorUnitTestContentSource.php',
     'PhabricatorUnitsTestCase' => 'view/__tests__/PhabricatorUnitsTestCase.php',
+    'PhabricatorUnknownContentSource' => 'infrastructure/contentsource/PhabricatorUnknownContentSource.php',
     'PhabricatorUnsubscribedFromObjectEdgeType' => 'applications/transactions/edges/PhabricatorUnsubscribedFromObjectEdgeType.php',
     'PhabricatorUser' => 'applications/people/storage/PhabricatorUser.php',
     'PhabricatorUserBlurbField' => 'applications/people/customfield/PhabricatorUserBlurbField.php',
···
     'PhabricatorVeryWowEnglishTranslation' => 'infrastructure/internationalization/translation/PhabricatorVeryWowEnglishTranslation.php',
     'PhabricatorViewerDatasource' => 'applications/people/typeahead/PhabricatorViewerDatasource.php',
     'PhabricatorWatcherHasObjectEdgeType' => 'applications/transactions/edges/PhabricatorWatcherHasObjectEdgeType.php',
+    'PhabricatorWebContentSource' => 'infrastructure/contentsource/PhabricatorWebContentSource.php',
     'PhabricatorWordPressAuthProvider' => 'applications/auth/provider/PhabricatorWordPressAuthProvider.php',
     'PhabricatorWorker' => 'infrastructure/daemon/workers/PhabricatorWorker.php',
     'PhabricatorWorkerActiveTask' => 'infrastructure/daemon/workers/storage/PhabricatorWorkerActiveTask.php',
···
     'PhabricatorBotWhatsNewHandler' => 'PhabricatorBotHandler',
     'PhabricatorBritishEnglishTranslation' => 'PhutilTranslation',
     'PhabricatorBuiltinPatchList' => 'PhabricatorSQLPatchList',
+    'PhabricatorBulkContentSource' => 'PhabricatorContentSource',
     'PhabricatorBusyUIExample' => 'PhabricatorUIExample',
     'PhabricatorCacheDAO' => 'PhabricatorLiskDAO',
     'PhabricatorCacheGeneralGarbageCollector' => 'PhabricatorGarbageCollector',
···
     'PhabricatorConduitCertificateToken' => 'PhabricatorConduitDAO',
     'PhabricatorConduitConnectionLog' => 'PhabricatorConduitDAO',
     'PhabricatorConduitConsoleController' => 'PhabricatorConduitController',
+    'PhabricatorConduitContentSource' => 'PhabricatorContentSource',
     'PhabricatorConduitController' => 'PhabricatorController',
     'PhabricatorConduitDAO' => 'PhabricatorLiskDAO',
     'PhabricatorConduitEditField' => 'PhabricatorEditField',
···
     'PhabricatorConpherencePreferencesSettingsPanel' => 'PhabricatorSettingsPanel',
     'PhabricatorConpherenceThreadPHIDType' => 'PhabricatorPHIDType',
     'PhabricatorConsoleApplication' => 'PhabricatorApplication',
+    'PhabricatorConsoleContentSource' => 'PhabricatorContentSource',
     'PhabricatorContentSource' => 'Phobject',
+    'PhabricatorContentSourceModule' => 'PhabricatorConfigModule',
     'PhabricatorContentSourceView' => 'AphrontView',
     'PhabricatorContributedToObjectEdgeType' => 'PhabricatorEdgeType',
     'PhabricatorController' => 'AphrontController',
···
     'PhabricatorDaemonBulkJobMonitorController' => 'PhabricatorDaemonController',
     'PhabricatorDaemonBulkJobViewController' => 'PhabricatorDaemonController',
     'PhabricatorDaemonConsoleController' => 'PhabricatorDaemonController',
+    'PhabricatorDaemonContentSource' => 'PhabricatorContentSource',
     'PhabricatorDaemonController' => 'PhabricatorController',
     'PhabricatorDaemonDAO' => 'PhabricatorLiskDAO',
     'PhabricatorDaemonEventListener' => 'PhabricatorEventListener',
···
     'PhabricatorElasticFulltextStorageEngine' => 'PhabricatorFulltextStorageEngine',
     'PhabricatorElasticSearchSetupCheck' => 'PhabricatorSetupCheck',
     'PhabricatorEmailAddressesSettingsPanel' => 'PhabricatorSettingsPanel',
+    'PhabricatorEmailContentSource' => 'PhabricatorContentSource',
     'PhabricatorEmailFormatSettingsPanel' => 'PhabricatorSettingsPanel',
     'PhabricatorEmailLoginController' => 'PhabricatorAuthController',
     'PhabricatorEmailPreferencesSettingsPanel' => 'PhabricatorSettingsPanel',
···
     'PhabricatorFactSimpleSpec' => 'PhabricatorFactSpec',
     'PhabricatorFactSpec' => 'Phobject',
     'PhabricatorFactUpdateIterator' => 'PhutilBufferedIterator',
+    'PhabricatorFaxContentSource' => 'PhabricatorContentSource',
     'PhabricatorFeedApplication' => 'PhabricatorApplication',
     'PhabricatorFeedBuilder' => 'Phobject',
     'PhabricatorFeedConfigOptions' => 'PhabricatorApplicationConfigOptions',
···
     'PhabricatorHelpKeyboardShortcutController' => 'PhabricatorHelpController',
     'PhabricatorHelpMainMenuBarExtension' => 'PhabricatorMainMenuBarExtension',
     'PhabricatorHeraldApplication' => 'PhabricatorApplication',
+    'PhabricatorHeraldContentSource' => 'PhabricatorContentSource',
     'PhabricatorHighSecurityRequestExceptionHandler' => 'PhabricatorRequestExceptionHandler',
     'PhabricatorHomeApplication' => 'PhabricatorApplication',
     'PhabricatorHomeController' => 'PhabricatorController',
···
     'PhabricatorLibraryTestCase' => 'PhutilLibraryTestCase',
     'PhabricatorLinkProfilePanel' => 'PhabricatorProfilePanel',
     'PhabricatorLipsumArtist' => 'Phobject',
+    'PhabricatorLipsumContentSource' => 'PhabricatorContentSource',
     'PhabricatorLipsumGenerateWorkflow' => 'PhabricatorLipsumManagementWorkflow',
     'PhabricatorLipsumManagementWorkflow' => 'PhabricatorManagementWorkflow',
     'PhabricatorLipsumMondrianArtist' => 'PhabricatorLipsumArtist',
···
     'PhabricatorObjectSelectorDialog' => 'Phobject',
     'PhabricatorObjectUsesCredentialsEdgeType' => 'PhabricatorEdgeType',
     'PhabricatorOffsetPagedQuery' => 'PhabricatorQuery',
+    'PhabricatorOldWorldContentSource' => 'PhabricatorContentSource',
     'PhabricatorOneTimeTriggerClock' => 'PhabricatorTriggerClock',
     'PhabricatorOpcodeCacheSpec' => 'PhabricatorCacheSpec',
     'PhabricatorOwnerPathQuery' => 'Phobject',
···
     'PhabricatorPholioConfigOptions' => 'PhabricatorApplicationConfigOptions',
     'PhabricatorPholioMockTestDataGenerator' => 'PhabricatorTestDataGenerator',
     'PhabricatorPhortuneApplication' => 'PhabricatorApplication',
+    'PhabricatorPhortuneContentSource' => 'PhabricatorContentSource',
     'PhabricatorPhortuneManagementInvoiceWorkflow' => 'PhabricatorPhortuneManagementWorkflow',
     'PhabricatorPhortuneManagementWorkflow' => 'PhabricatorManagementWorkflow',
     'PhabricatorPhragmentApplication' => 'PhabricatorApplication',
···
     'PhabricatorUIExampleRenderController' => 'PhabricatorController',
     'PhabricatorUIExamplesApplication' => 'PhabricatorApplication',
     'PhabricatorUSEnglishTranslation' => 'PhutilTranslation',
+    'PhabricatorUnitTestContentSource' => 'PhabricatorContentSource',
     'PhabricatorUnitsTestCase' => 'PhabricatorTestCase',
+    'PhabricatorUnknownContentSource' => 'PhabricatorContentSource',
     'PhabricatorUnsubscribedFromObjectEdgeType' => 'PhabricatorEdgeType',
     'PhabricatorUser' => array(
       'PhabricatorUserDAO',
···
     'PhabricatorVeryWowEnglishTranslation' => 'PhutilTranslation',
     'PhabricatorViewerDatasource' => 'PhabricatorTypeaheadDatasource',
     'PhabricatorWatcherHasObjectEdgeType' => 'PhabricatorEdgeType',
+    'PhabricatorWebContentSource' => 'PhabricatorContentSource',
     'PhabricatorWordPressAuthProvider' => 'PhabricatorOAuth2AuthProvider',
     'PhabricatorWorker' => 'Phobject',
     'PhabricatorWorkerActiveTask' => 'PhabricatorWorkerTask',

src/applications/almanac/management/AlmanacManagementWorkflow.php

···
 abstract class AlmanacManagementWorkflow
   extends PhabricatorManagementWorkflow {
 
-
   protected function loadServices(array $names) {
     if (!$names) {
       return array();
···
     $editor = id(new AlmanacServiceEditor())
       ->setActor($this->getViewer())
       ->setActingAsPHID($almanac_phid)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->setContinueOnMissingFields(true);
 
     $editor->applyTransactions($service, array($xaction));

src/applications/audit/storage/PhabricatorAuditInlineComment.php

···
 
   public function getTransactionCommentForSave() {
     $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_LEGACY,
-      array());
+      PhabricatorOldWorldContentSource::SOURCECONST);
 
     $this->proxy
       ->setViewPolicy('public')

src/applications/conduit/protocol/ConduitAPIRequest.php

···
     return $this->isClusterRequest;
   }
 
+  public function newContentSource() {
+    return PhabricatorContentSource::newForSource(
+      PhabricatorConduitContentSource::SOURCECONST);
+  }
+
 }

src/applications/conpherence/__tests__/ConpherenceRoomTestCase.php

···
 
     id(new ConpherenceEditor())
       ->setActor($creator)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->setContinueOnNoEffect(true)
       ->applyTransactions($conpherence, $xactions);
 
···
 
     id(new ConpherenceEditor())
       ->setActor($actor)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->setContinueOnNoEffect(true)
       ->applyTransactions($room, $xactions);
   }

src/applications/conpherence/__tests__/ConpherenceTestCase.php

···
     );
     $editor = id(new ConpherenceEditor())
       ->setActor($actor)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->applyTransactions($conpherence, $xactions);
 
   }
···
     );
     $editor = id(new ConpherenceEditor())
       ->setActor($actor)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->applyTransactions($conpherence, $xactions);
   }
 
···
 
     $editor = id(new ConpherenceEditor())
       ->setActor($actor)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource());
+      ->setContentSource($this->newContentSource());
 
     $xactions = $editor->generateTransactionsFromText(
       $actor,

src/applications/conpherence/conduit/ConpherenceCreateThreadConduitAPIMethod.php

···
       $participant_phids,
       $title,
       $message,
-      PhabricatorContentSource::newFromConduitRequest($request));
+      $request->newContentSource());
 
     if ($errors) {
       foreach ($errors as $error_code) {

src/applications/conpherence/conduit/ConpherenceUpdateThreadConduitAPIMethod.php

···
       throw new ConduitException('ERR_USAGE_ROOM_NOT_FOUND');
     }
 
-    $source = PhabricatorContentSource::newFromConduitRequest($request);
+    $source = $request->newContentSource();
     $editor = id(new ConpherenceEditor())
       ->setContentSource($source)
       ->setActor($user);

src/applications/conpherence/mail/ConpherenceReplyHandler.php

···
       $conpherence->attachParticipants($participants);
     }
 
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_EMAIL,
-      array(
-        'id' => $mail->getID(),
-      ));
+    $content_source = $mail->newContentSource();
 
     $editor = id(new ConpherenceEditor())
       ->setActor($user)

src/applications/differential/conduit/DifferentialCloseConduitAPIMethod.php

···
       ->setTransactionType(DifferentialTransaction::TYPE_ACTION)
       ->setNewValue(DifferentialAction::ACTION_CLOSE);
 
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_CONDUIT,
-      array());
+    $content_source = $request->newContentSource();
 
     $editor = id(new DifferentialTransactionEditor())
       ->setActor($viewer)
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setContinueOnMissingFields(true)
       ->setContinueOnNoEffect(true);
 

src/applications/differential/conduit/DifferentialConduitAPIMethod.php

···
 
     $editor = id(new DifferentialTransactionEditor())
       ->setActor($viewer)
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setContinueOnNoEffect(true)
       ->setContinueOnMissingFields(true);
 

src/applications/differential/conduit/DifferentialCreateCommentConduitAPIMethod.php

···
     $editor = id(new DifferentialTransactionEditor())
       ->setActor($viewer)
       ->setDisableEmail($request->getValue('silent'))
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setContinueOnNoEffect(true)
       ->setContinueOnMissingFields(true);
 

src/applications/differential/conduit/DifferentialCreateDiffConduitAPIMethod.php

···
 
     id(new DifferentialDiffEditor())
       ->setActor($viewer)
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setContinueOnNoEffect(true)
       ->applyTransactions($diff, $xactions);
 

src/applications/differential/conduit/DifferentialCreateRawDiffConduitAPIMethod.php

···
 
     id(new DifferentialDiffEditor())
       ->setActor($viewer)
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setContinueOnNoEffect(true)
       ->setLookupRepository(false) // respect user choice
       ->applyTransactions($diff, $xactions);

src/applications/differential/management/PhabricatorDifferentialAttachCommitWorkflow.php

···
       ->setViewer($viewer)
       ->setAuthorPHID($differential_phid);
 
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_CONSOLE,
-      array());
+    $content_source = $this->newContentSource();
 
     $extraction_engine->updateRevisionWithCommit(
       $revision,

src/applications/differential/storage/DifferentialInlineComment.php

···
 
   public function getTransactionCommentForSave() {
     $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_LEGACY,
-      array());
+      PhabricatorOldWorldContentSource::SOURCECONST);
 
     $this->proxy
       ->setViewPolicy('public')

src/applications/diffusion/conduit/DiffusionCreateCommentConduitAPIMethod.php

···
 
     id(new PhabricatorAuditEditor())
       ->setActor($request->getUser())
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setDisableEmail($request->getValue('silent'))
       ->setContinueOnMissingFields(true)
       ->applyTransactions($commit, $xactions);

src/applications/harbormaster/engine/HarbormasterBuildEngine.php

···
       ->getPHID();
 
     $daemon_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_DAEMON,
-      array());
+      PhabricatorDaemonContentSource::SOURCECONST);
 
     $editor = $object->getApplicationTransactionEditor()
       ->setActor($viewer)

src/applications/herald/contentsource/PhabricatorHeraldContentSource.php

···
+<?php
+
+final class PhabricatorHeraldContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'herald';
+
+  public function getSourceName() {
+    return pht('Herald');
+  }
+
+  public function getSourceDescription() {
+    return pht('Changes triggered by Herald rules.');
+  }
+
+}

src/applications/herald/field/HeraldContentSourceField.php

···
   }
 
   public function getHeraldFieldValueType($condition) {
-    $map = PhabricatorContentSource::getSourceNameMap();
+    $map = PhabricatorContentSource::getAllContentSources();
+    $map = mpull($map, 'getSourceName');
     asort($map);
 
     return id(new HeraldSelectFieldValue())
       ->setKey(self::FIELDCONST)
-      ->setDefault(PhabricatorContentSource::SOURCE_WEB)
+      ->setDefault(PhabricatorWebContentSource::SOURCECONST)
       ->setOptions($map);
   }
 

src/applications/lipsum/generator/PhabricatorTestDataGenerator.php

···
 
   protected function getLipsumContentSource() {
     return PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_LIPSUM,
-      array());
+      PhabricatorLipsumContentSource::SOURCECONST);
   }
 
   /**

src/applications/maniphest/__tests__/ManiphestTaskTestCase.php

···
     ManiphestTask $task,
     array $xactions) {
 
-    $content_source = PhabricatorContentSource::newConsoleSource();
+    $content_source = $this->newContentSource();
 
     $editor = id(new ManiphestTransactionEditor())
       ->setActor($viewer)

src/applications/maniphest/conduit/ManiphestConduitAPIMethod.php

···
       return;
     }
 
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_CONDUIT,
-      array());
+    $content_source = $request->newContentSource();
 
     $editor = id(new ManiphestTransactionEditor())
       ->setActor($request->getUser())

src/applications/maniphest/lipsum/PhabricatorManiphestTaskTestDataGenerator.php

···
       ->setSubPriority($this->generateTaskSubPriority())
       ->setTitle($this->generateTitle());
 
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_UNKNOWN,
-      array());
+    $content_source = $this->getLipsumContentSource();
 
     $template = new ManiphestTransaction();
     // Accumulate Transactions

src/applications/metamta/contentsource/PhabricatorContentSource.php

···
-<?php
-
-final class PhabricatorContentSource extends Phobject {
-
-  const SOURCE_UNKNOWN  = 'unknown';
-  const SOURCE_WEB      = 'web';
-  const SOURCE_EMAIL    = 'email';
-  const SOURCE_CONDUIT  = 'conduit';
-  const SOURCE_MOBILE   = 'mobile';
-  const SOURCE_TABLET   = 'tablet';
-  const SOURCE_FAX      = 'fax';
-  const SOURCE_CONSOLE  = 'console';
-  const SOURCE_HERALD   = 'herald';
-  const SOURCE_LEGACY   = 'legacy';
-  const SOURCE_DAEMON   = 'daemon';
-  const SOURCE_LIPSUM   = 'lipsum';
-  const SOURCE_PHORTUNE = 'phortune';
-  const SOURCE_BULK = 'bulk';
-
-  private $source;
-  private $params = array();
-
-  private function __construct() {
-    // <empty>
-  }
-
-  public static function newForSource($source, array $params) {
-    $obj = new PhabricatorContentSource();
-    $obj->source = $source;
-    $obj->params = $params;
-
-    return $obj;
-  }
-
-  public static function newFromSerialized($serialized) {
-    $dict = json_decode($serialized, true);
-    if (!is_array($dict)) {
-      $dict = array();
-    }
-
-    $obj = new PhabricatorContentSource();
-    $obj->source = idx($dict, 'source', self::SOURCE_UNKNOWN);
-    $obj->params = idx($dict, 'params', array());
-
-    return $obj;
-  }
-
-  public static function newConsoleSource() {
-    return self::newForSource(
-      self::SOURCE_CONSOLE,
-      array());
-  }
-
-  public static function newFromRequest(AphrontRequest $request) {
-    return self::newForSource(
-      self::SOURCE_WEB,
-      array());
-  }
-
-  public static function newFromConduitRequest(ConduitAPIRequest $request) {
-    return self::newForSource(
-      self::SOURCE_CONDUIT,
-      array());
-  }
-
-  public static function getSourceNameMap() {
-    return array(
-      self::SOURCE_WEB      => pht('Web'),
-      self::SOURCE_EMAIL    => pht('Email'),
-      self::SOURCE_CONDUIT  => pht('Conduit'),
-      self::SOURCE_MOBILE   => pht('Mobile'),
-      self::SOURCE_TABLET   => pht('Tablet'),
-      self::SOURCE_FAX      => pht('Fax'),
-      self::SOURCE_CONSOLE  => pht('Console'),
-      self::SOURCE_LEGACY   => pht('Legacy'),
-      self::SOURCE_HERALD   => pht('Herald'),
-      self::SOURCE_DAEMON   => pht('Daemons'),
-      self::SOURCE_LIPSUM   => pht('Lipsum'),
-      self::SOURCE_UNKNOWN  => pht('Old World'),
-      self::SOURCE_PHORTUNE => pht('Phortune'),
-      self::SOURCE_BULK => pht('Bulk Edit'),
-    );
-  }
-
-  public function serialize() {
-    return json_encode(array(
-      'source' => $this->getSource(),
-      'params' => $this->getParams(),
-    ));
-  }
-
-  public function getSource() {
-    return $this->source;
-  }
-
-  public function getParams() {
-    return $this->params;
-  }
-
-  public function getParam($key, $default = null) {
-    return idx($this->params, $key, $default);
-  }
-
-}

src/applications/metamta/contentsource/PhabricatorContentSourceView.php src/infrastructure/contentsource/PhabricatorContentSourceView.php

···
   }
 
   public function getSourceName() {
-    $map = PhabricatorContentSource::getSourceNameMap();
-    $source = $this->contentSource->getSource();
-    return idx($map, $source, null);
-
+    return $this->contentSource->getSourceName();
   }
 
   public function render() {
     require_celerity_resource('phabricator-content-source-view-css');
 
-    $map = PhabricatorContentSource::getSourceNameMap();
-
-    $source = $this->contentSource->getSource();
-    $type = idx($map, $source, null);
-
-    if (!$type) {
+    $name = $this->getSourceName();
+    if ($name === null) {
       return null;
     }
 
···
       array(
         'class' => 'phabricator-content-source-view',
       ),
-      pht('Via %s', $type));
+      pht('Via %s', $name));
   }
 
 }

src/applications/metamta/contentsource/PhabricatorEmailContentSource.php

···
+<?php
+
+final class PhabricatorEmailContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'email';
+
+  public function getSourceName() {
+    return pht('Email');
+  }
+
+  public function getSourceDescription() {
+    return pht('Content sent by electronic mail, also known as e-mail.');
+  }
+
+}

src/applications/metamta/storage/PhabricatorMetaMTAReceivedMail.php

···
       ->saveAndSend();
   }
 
+  public function newContentSource() {
+    return PhabricatorContentSource::newForSource(
+      PhabricatorEmailContentSource::SOURCECONST,
+      array(
+        'id' => $this->getID(),
+      ));
+  }
+
 }

src/applications/nuance/item/NuanceGitHubEventItemType.php

···
 
     // TODO: Preserve the item's original source.
     $source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_DAEMON,
-      array());
+      PhabricatorDaemonContentSource::SOURCECONST);
 
-    // TOOD: This should really be the external source.
+    // TODO: This should really be the external source.
     $acting_phid = $nuance_phid;
 
     $editor = id(new ManiphestTransactionEditor())

src/applications/nuance/item/NuanceItemType.php

···
 
     // TODO: Maybe preserve the actor's original content source?
     $source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_DAEMON,
-      array());
+      PhabricatorDaemonContentSource::SOURCECONST);
 
     $editor = id(new NuanceItemEditor())
       ->setActor($viewer)

src/applications/paste/conduit/PasteCreateConduitAPIMethod.php

···
     $editor = id(new PhabricatorPasteEditor())
       ->setActor($viewer)
       ->setContinueOnNoEffect(true)
-      ->setContentSourceFromConduitRequest($request);
+      ->setContentSource($request->newContentSource());
 
     $xactions = $editor->applyTransactions($paste, $xactions);
 

src/applications/paste/mail/PasteCreateMailReceiver.php

···
 
     $paste = PhabricatorPaste::initializeNewPaste($sender);
 
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_EMAIL,
-      array(
-        'id' => $mail->getID(),
-      ));
+    $content_source = $mail->newContentSource();
 
     $editor = id(new PhabricatorPasteEditor())
       ->setActor($sender)
···
       ->setBody($body->render())
       ->saveAndSend();
   }
+
 
 }

src/applications/pholio/lipsum/PhabricatorPholioMockTestDataGenerator.php

···
           ->loadOneWhere('phid = %s', $author_phid);
     $mock = PholioMock::initializeNewMock($author);
 
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_UNKNOWN,
-      array());
+    $content_source = $this->getLipsumContentSource();
+
     $template = id(new PholioTransaction())
       ->setContentSource($content_source);
 

src/applications/phortune/contentsource/PhabricatorPhortuneContentSource.php

···
+<?php
+
+final class PhabricatorPhortuneContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'phortune';
+
+  public function getSourceName() {
+    return pht('Phortune');
+  }
+
+  public function getSourceDescription() {
+    return pht('Updates from subscriptions and payment processors.');
+  }
+
+}

src/applications/phortune/product/PhortuneProductImplementation.php

···
 
   protected function getContentSource() {
     return PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_PHORTUNE,
-      array());
+      PhabricatorPhortuneContentSource::SOURCECONST);
   }
 
   public function getPurchaseName(

src/applications/phortune/storage/PhortuneCart.php

···
       ->setNewValue(true);
 
     $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_PHORTUNE,
-      array());
+      PhabricatorPhortuneContentSource::SOURCECONST);
 
     $editor = id(new PhortuneCartEditor())
       ->setActor($omnipotent_user)

src/applications/phortune/worker/PhortuneSubscriptionWorker.php

···
       ->setNewValue(true);
 
     $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_PHORTUNE,
-      array());
+      PhabricatorPhortuneContentSource::SOURCECONST);
 
     $acting_phid = id(new PhabricatorPhortuneApplication())->getPHID();
     $editor = id(new PhortuneCartEditor())

src/applications/phriction/conduit/PhrictionCreateConduitAPIMethod.php

···
 
     $editor = id(new PhrictionTransactionEditor())
       ->setActor($request->getUser())
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setContinueOnNoEffect(true)
       ->setDescription($request->getValue('description'));
 

src/applications/phriction/conduit/PhrictionEditConduitAPIMethod.php

···
 
     $editor = id(new PhrictionTransactionEditor())
       ->setActor($request->getUser())
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setContinueOnNoEffect(true)
       ->setDescription($request->getValue('description'));
 

src/applications/project/__tests__/PhabricatorProjectCoreTestCase.php

···
 
     $editor = id(new ManiphestTransactionEditor())
       ->setActor($viewer)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->setContinueOnNoEffect(true)
       ->applyTransactions($task, $xactions);
   }
···
 
     $editor = id(new ManiphestTransactionEditor())
       ->setActor($viewer)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->setContinueOnNoEffect(true)
       ->applyTransactions($task, $xactions);
   }
···
 
     $editor = id(new ManiphestTransactionEditor())
       ->setActor($viewer)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->setContinueOnNoEffect(true)
       ->applyTransactions($task, $xactions);
 
···
 
     $editor = id(new PhabricatorProjectTransactionEditor())
       ->setActor($user)
-      ->setContentSource(PhabricatorContentSource::newConsoleSource())
+      ->setContentSource($this->newContentSource())
       ->setContinueOnNoEffect(true)
       ->applyTransactions($project, $xactions);
   }

src/applications/project/conduit/ProjectCreateConduitAPIMethod.php

···
     $editor = id(new PhabricatorProjectTransactionEditor())
       ->setActor($user)
       ->setContinueOnNoEffect(true)
-      ->setContentSourceFromConduitRequest($request);
+      ->setContentSource($request->newContentSource());
 
     $editor->applyTransactions($project, $xactions);
 

src/applications/releeph/conduit/ReleephRequestConduitAPIMethod.php

···
         $editor = id(new ReleephRequestTransactionalEditor())
           ->setActor($user)
           ->setContinueOnNoEffect(true)
-          ->setContentSource(
-            PhabricatorContentSource::newForSource(
-              PhabricatorContentSource::SOURCE_CONDUIT,
-              array()));
+          ->setContentSource($request->newContentSource());
 
         $editor->applyTransactions($releeph_request, $xactions);
       }

src/applications/releeph/conduit/work/ReleephWorkRecordConduitAPIMethod.php

···
     $editor = id(new ReleephRequestTransactionalEditor())
       ->setActor($request->getUser())
       ->setContinueOnNoEffect(true)
-      ->setContentSource(
-        PhabricatorContentSource::newForSource(
-          PhabricatorContentSource::SOURCE_CONDUIT,
-          array()));
+      ->setContentSource($request->newContentSource());
 
     $editor->applyTransactions($releeph_request, $xactions);
   }

src/applications/releeph/conduit/work/ReleephWorkRecordPickStatusConduitAPIMethod.php

···
     $editor = id(new ReleephRequestTransactionalEditor())
       ->setActor($request->getUser())
       ->setContinueOnNoEffect(true)
-      ->setContentSource(
-        PhabricatorContentSource::newForSource(
-          PhabricatorContentSource::SOURCE_CONDUIT,
-          array()));
+      ->setContentSource($request->newContentSource());
 
     $xactions = array();
 

src/applications/releeph/differential/DifferentialReleephRequestFieldSpecification.php

···
         ->setContinueOnNoEffect(true)
         ->setContentSource(
           PhabricatorContentSource::newForSource(
-            PhabricatorContentSource::SOURCE_UNKNOWN,
-            array()));
+            PhabricatorUnknownContentSource::SOURCECONST));
 
       $editor->applyTransactions($releeph_request, $xactions);
     }

src/applications/repository/management/PhabricatorRepositoryManagementEditWorkflow.php

···
           pht('Specify one or more fields to edit!'));
       }
 
-      $content_source = PhabricatorContentSource::newConsoleSource();
+      $content_source = $this->newContentSource();
 
       $editor = id(new PhabricatorRepositoryEditor())
         ->setActor($actor)

src/applications/repository/worker/PhabricatorRepositoryCommitHeraldWorker.php

···
 
     $commit->attachRepository($repository);
 
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_DAEMON,
-      array());
+    $content_source = $this->newContentSource();
 
     $committer_phid = $data->getCommitDetail('committerPHID');
     $author_phid = $data->getCommitDetail('authorPHID');

src/applications/repository/worker/commitmessageparser/PhabricatorRepositoryCommitMessageParserWorker.php

···
             ->setViewer($actor)
             ->setAuthorPHID($acting_as_phid);
 
-          $content_source = PhabricatorContentSource::newForSource(
-            PhabricatorContentSource::SOURCE_DAEMON,
-            array());
+          $content_source = $this->newContentSource();
 
           $update_data = $extraction_engine->updateRevisionWithCommit(
             $revision,
···
 
       $xactions[] = $edge_xaction;
 
-      $content_source = PhabricatorContentSource::newForSource(
-        PhabricatorContentSource::SOURCE_DAEMON,
-        array());
+      $content_source = $this->newContentSource();
 
       $editor = id(new ManiphestTransactionEditor())
         ->setActor($actor)

src/applications/spaces/__tests__/PhabricatorSpacesTestCase.php

···
         ->setNewValue($is_default);
     }
 
-    $content_source = PhabricatorContentSource::newConsoleSource();
+    $content_source = $this->newContentSource();
 
     $editor = id(new PhabricatorSpacesNamespaceEditor())
       ->setActor($actor)

src/applications/tokens/conduit/TokenGiveConduitAPIMethod.php

···
   }
 
   protected function execute(ConduitAPIRequest $request) {
-    $content_source = PhabricatorContentSource::newFromConduitRequest($request);
+    $content_source = $request->newContentSource();
 
     $editor = id(new PhabricatorTokenGivenEditor())
       ->setActor($request->getUser())

src/applications/transactions/controller/PhabricatorApplicationTransactionCommentRawController.php

···
     $addendum = null;
     if ($request->getExists('email')) {
       $content_source = $xaction->getContentSource();
-      $source_email = PhabricatorContentSource::SOURCE_EMAIL;
+      $source_email = PhabricatorEmailContentSource::SOURCECONST;
       if ($content_source->getSource() == $source_email) {
-        $source_id = $content_source->getParam('id');
+        $source_id = $content_source->getContentSourceParameter('id');
         if ($source_id) {
           $message = id(new PhabricatorMetaMTAReceivedMail())->loadOneWhere(
             'id = %d',

src/applications/transactions/editengine/PhabricatorEditEngine.php

···
 
     $editor = $object->getApplicationTransactionEditor()
       ->setActor($viewer)
-      ->setContentSourceFromConduitRequest($request)
+      ->setContentSource($request->newContentSource())
       ->setContinueOnNoEffect(true);
 
     if (!$this->getIsCreate()) {

src/applications/transactions/editor/PhabricatorApplicationTransactionEditor.php

···
       PhabricatorContentSource::newFromRequest($request));
   }
 
-  public function setContentSourceFromConduitRequest(
-    ConduitAPIRequest $request) {
-
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_CONDUIT,
-      array());
-
-    return $this->setContentSource($content_source);
-  }
-
   public function getContentSource() {
     return $this->contentSource;
   }
···
         // out from transcripts, but it would be cleaner if you didn't have to.
 
         $herald_source = PhabricatorContentSource::newForSource(
-          PhabricatorContentSource::SOURCE_HERALD,
-          array());
+          PhabricatorHeraldContentSource::SOURCECONST);
 
         $herald_editor = newv(get_class($this), array())
           ->setContinueOnNoEffect(true)

src/applications/transactions/replyhandler/PhabricatorApplicationTransactionReplyHandler.php

···
   }
 
   private function newEditor(PhabricatorMetaMTAReceivedMail $mail) {
-    $content_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_EMAIL,
-      array(
-        'id' => $mail->getID(),
-      ));
+    $content_source = $mail->newContentSource();
 
     $editor = $this->getMailReceiver()
       ->getApplicationTransactionEditor()

src/applications/transactions/worker/PhabricatorApplicationTransactionPublishWorker.php

···
     PhabricatorApplicationTransactionInterface $object) {
     $data = $this->getTaskData();
 
-    $daemon_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_DAEMON,
-      array());
+    $daemon_source = $this->newContentSource();
 
     $viewer = PhabricatorUser::getOmnipotentUser();
     $editor = $object->getApplicationTransactionEditor()

src/infrastructure/contentsource/PhabricatorConduitContentSource.php

···
+<?php
+
+final class PhabricatorConduitContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'conduit';
+
+  public function getSourceName() {
+    return pht('Conduit');
+  }
+
+  public function getSourceDescription() {
+    return pht('Content from the Conduit API.');
+  }
+
+}

src/infrastructure/contentsource/PhabricatorConsoleContentSource.php

···
+<?php
+
+final class PhabricatorConsoleContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'console';
+
+  public function getSourceName() {
+    return pht('Console');
+  }
+
+  public function getSourceDescription() {
+    return pht('Content generated by CLI administrative tools.');
+  }
+
+}

src/infrastructure/contentsource/PhabricatorContentSource.php

···
+<?php
+
+abstract class PhabricatorContentSource extends Phobject {
+
+  private $source;
+  private $params = array();
+
+  abstract public function getSourceName();
+  abstract public function getSourceDescription();
+
+  final public function getSourceTypeConstant() {
+    return $this->getPhobjectClassConstant('SOURCECONST', 32);
+  }
+
+  final public static function getAllContentSources() {
+    return id(new PhutilClassMapQuery())
+      ->setAncestorClass(__CLASS__)
+      ->setUniqueMethod('getSourceTypeConstant')
+      ->execute();
+  }
+
+  /**
+   * Construct a new content source object.
+   *
+   * @param const The source type constant to build a source for.
+   * @param array Source parameters.
+   * @param bool True to suppress errors and force construction of a source
+   *   even if the source type is not valid.
+   * @return PhabricatorContentSource New source object.
+   */
+  final public static function newForSource(
+    $source,
+    array $params = array(),
+    $force = false) {
+
+    $map = self::getAllContentSources();
+    if (isset($map[$source])) {
+      $obj = clone $map[$source];
+    } else {
+      if ($force) {
+        $obj = new PhabricatorUnknownContentSource();
+      } else {
+        throw new Exception(
+          pht(
+            'Content source type "%s" is not known to Phabricator!',
+            $source));
+      }
+    }
+
+    $obj->source = $source;
+    $obj->params = $params;
+
+    return $obj;
+  }
+
+  public static function newFromSerialized($serialized) {
+    $dict = json_decode($serialized, true);
+    if (!is_array($dict)) {
+      $dict = array();
+    }
+
+    $source = idx($dict, 'source');
+    $params = idx($dict, 'params');
+    if (!is_array($params)) {
+      $params = array();
+    }
+
+    return self::newForSource($source, $params, true);
+  }
+
+  public static function newFromRequest(AphrontRequest $request) {
+    return self::newForSource(
+      PhabricatorWebContentSource::SOURCECONST);
+  }
+
+  final public function serialize() {
+    return phutil_json_encode(
+      array(
+        'source' => $this->getSource(),
+        'params' => $this->params,
+      ));
+  }
+
+  final public function getSource() {
+    return $this->source;
+  }
+
+  final public function getContentSourceParameter($key, $default = null) {
+    return idx($this->params, $key, $default);
+  }
+
+}

src/infrastructure/contentsource/PhabricatorContentSourceModule.php

···
+<?php
+
+final class PhabricatorContentSourceModule
+  extends PhabricatorConfigModule {
+
+  public function getModuleKey() {
+    return 'contentsource';
+  }
+
+  public function getModuleName() {
+    return pht('Content Sources');
+  }
+
+  public function renderModuleStatus(AphrontRequest $request) {
+    $viewer = $request->getViewer();
+
+    $sources = PhabricatorContentSource::getAllContentSources();
+    ksort($sources);
+
+    $rows = array();
+    foreach ($sources as $source) {
+      $rows[] = array(
+        $source->getSourceTypeConstant(),
+        get_class($source),
+        $source->getSourceName(),
+        $source->getSourceDescription(),
+      );
+    }
+
+    $table = id(new AphrontTableView($rows))
+      ->setHeaders(
+        array(
+          pht('Key'),
+          pht('Class'),
+          pht('Source'),
+          pht('Description'),
+        ))
+      ->setColumnClasses(
+        array(
+          null,
+          null,
+          'pri',
+          'wide',
+        ));
+
+    return id(new PHUIObjectBoxView())
+      ->setHeaderText(pht('Content Sources'))
+      ->setTable($table);
+  }
+
+}

src/infrastructure/contentsource/PhabricatorFaxContentSource.php

···
+<?php
+
+final class PhabricatorFaxContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'fax';
+
+  public function getSourceName() {
+    return pht('Fax');
+  }
+
+  public function getSourceDescription() {
+    return pht('Content received via fax (telefacsimile).');
+  }
+
+}

src/infrastructure/contentsource/PhabricatorLipsumContentSource.php

···
+<?php
+
+final class PhabricatorLipsumContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'lipsum';
+
+  public function getSourceName() {
+    return pht('Lipsum');
+  }
+
+  public function getSourceDescription() {
+    return pht('Test data created with bin/lipsum.');
+  }
+
+}

src/infrastructure/contentsource/PhabricatorOldWorldContentSource.php

···
+<?php
+
+final class PhabricatorOldWorldContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'legacy';
+
+  public function getSourceName() {
+    return pht('Old World');
+  }
+
+  public function getSourceDescription() {
+    return pht(
+      'Content from the distant past, before content sources existed.');
+  }
+
+}

src/infrastructure/contentsource/PhabricatorUnitTestContentSource.php

···
+<?php
+
+final class PhabricatorUnitTestContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'unittest';
+
+  public function getSourceName() {
+    return pht('Unit Test');
+  }
+
+  public function getSourceDescription() {
+    return pht('Content created by unit tests.');
+  }
+
+}

src/infrastructure/contentsource/PhabricatorUnknownContentSource.php

···
+<?php
+
+final class PhabricatorUnknownContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'unknown';
+
+  public function getSourceName() {
+    $source = $this->getSource();
+    if (strlen($source)) {
+      return pht('Unknown ("%s")', $source);
+    } else {
+      return pht('Unknown');
+    }
+  }
+
+  public function getSourceDescription() {
+    return pht('Content with no known source.');
+  }
+
+}

src/infrastructure/contentsource/PhabricatorWebContentSource.php

···
+<?php
+
+final class PhabricatorWebContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'web';
+
+  public function getSourceName() {
+    return pht('Web');
+  }
+
+  public function getSourceDescription() {
+    return pht('Content created from the web UI.');
+  }
+
+}

src/infrastructure/daemon/contentsource/PhabricatorBulkContentSource.php

···
+<?php
+
+final class PhabricatorBulkContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'bulk';
+
+  public function getSourceName() {
+    return pht('Bulk Update');
+  }
+
+  public function getSourceDescription() {
+    return pht('Changes made by bulk update.');
+  }
+
+}

src/infrastructure/daemon/contentsource/PhabricatorDaemonContentSource.php

···
+<?php
+
+final class PhabricatorDaemonContentSource
+  extends PhabricatorContentSource {
+
+  const SOURCECONST = 'daemon';
+
+  public function getSourceName() {
+    return pht('Daemon');
+  }
+
+  public function getSourceDescription() {
+    return pht('Updates from background processing in daemons.');
+  }
+
+}

src/infrastructure/daemon/workers/PhabricatorWorker.php

···
       $epoch_ago);
   }
 
+  protected function newContentSource() {
+    return PhabricatorContentSource::newForSource(
+      PhabricatorDaemonContentSource::SOURCECONST);
+  }
+
 }

src/infrastructure/daemon/workers/bulk/PhabricatorWorkerBulkJobWorker.php

···
       ->setTransactionType($type_status)
       ->setNewValue($status);
 
-    $daemon_source = PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_DAEMON,
-      array());
+    $daemon_source = $this->newContentSource();
 
     $app_phid = id(new PhabricatorDaemonsApplication())->getPHID();
 

src/infrastructure/daemon/workers/storage/PhabricatorWorkerBulkJob.php

···
 
   public function newContentSource() {
     return PhabricatorContentSource::newForSource(
-      PhabricatorContentSource::SOURCE_BULK,
+      PhabricatorBulkContentSource::SOURCECONST,
       array(
         'jobID' => $this->getID(),
       ));

src/infrastructure/management/PhabricatorManagementWorkflow.php

···
     return $epoch;
   }
 
+  protected function newContentSource() {
+    return PhabricatorContentSource::newForSource(
+      PhabricatorConsoleContentSource::SOURCECONST);
+  }
+
 }

src/infrastructure/testing/PhabricatorTestCase.php

···
     }
   }
 
+  protected function newContentSource() {
+    return PhabricatorContentSource::newForSource(
+      PhabricatorUnitTestContentSource::SOURCECONST);
+  }
 
 }

src/view/phui/PHUITimelineEventView.php

···
           ));
 
       $content_source = $this->getContentSource();
-      $source_email = PhabricatorContentSource::SOURCE_EMAIL;
+      $source_email = PhabricatorEmailContentSource::SOURCECONST;
       if ($content_source->getSource() == $source_email) {
-        $source_id = $content_source->getParam('id');
+        $source_id = $content_source->getContentSourceParameter('id');
         if ($source_id) {
           $items[] = id(new PhabricatorActionView())
             ->setIcon('fa-envelope-o')