Maintainer wanted model, badge, action and admin UI.

Author: isoos

app/lib/frontend/templates/package.dart

@@ -116,6 +116,7 @@ d.Node renderPkgHeader(PackagePageData data) {
     packageName: package.name!,
     publisherId: package.publisherId,
     published: data.version.created!,
+    isMaintainerWanted: package.isMaintainerWanted ?? false,
     isNullSafe: isNullSafe,
     isDart3Compatible:
         pkgView.tags.contains(PackageVersionTags.isDart3Compatible),

app/lib/frontend/templates/package_misc.dart

@@ -35,6 +35,9 @@ final nameMatchBadgeNode = packageBadgeNode(
   color: 'name-match',
 );
 
+/// Renders the maintainer-wanted badged used by package listing and package page.
+final maintainerWantedBadgeNode = packageBadgeNode(label: 'Maintainer wanted');
+
 /// Renders the null-safe badge used by package listing and package page.
 d.Node nullSafeBadgeNode({String? title}) {
   return packageBadgeNode(

app/lib/frontend/templates/views/pkg/admin_page.dart

@@ -200,6 +200,19 @@ d.Node packageAdminPageNode({
         ),
       ),
     ],
+    d.a(name: 'maintainer-wanted'),
+    d.h3(text: 'Maintainer wanted'),
+    d.markdown(
+        'A package that\'s marked as *maintainWanted* will be featured with an '
+        'extra badge on the package page and in the search results.'),
+    d.div(
+      classes: ['-pub-form-checkbox-row'],
+      child: material.checkbox(
+        id: '-admin-is-maintainer-wanted-checkbox',
+        label: 'Mark "maintainWanted"',
+        checked: package.isMaintainerWanted ?? false,
+      ),
+    ),
     _automatedPublishing(package),
     d.a(name: 'version-retraction'),
     d.h2(text: 'Version retraction'),

app/lib/frontend/templates/views/pkg/header.dart

@@ -12,6 +12,7 @@ d.Node packageHeaderNode({
   required String packageName,
   required String? publisherId,
   required DateTime published,
+  required bool isMaintainerWanted,
   required bool isNullSafe,
   required bool isDart3Compatible,
   required bool isDart3Incompatible,
@@ -22,6 +23,7 @@ d.Node packageHeaderNode({
     d.span(child: d.xAgoTimestamp(published)),
     d.text(' '),
     if (publisherId != null) ..._publisher(publisherId),
+    if (isMaintainerWanted) maintainerWantedBadgeNode,
     if (isNullSafe && !isDart3Compatible) nullSafeBadgeNode(),
     if (isDart3Compatible) dart3CompatibleNode,
     if (isDart3Incompatible) dart3IncompatibleNode,

app/lib/frontend/templates/views/pkg/package_list.dart

@@ -79,6 +79,7 @@ d.Node _packageItem(
   required bool isNameMatch,
 }) {
   final isFlutterFavorite = view.tags.contains(PackageTags.isFlutterFavorite);
+  final isMaintainerWanted = view.tags.contains(PackageTags.isMaintainerWanted);
   final isNullSafe = view.tags.contains(PackageVersionTags.isNullSafe);
   final isDart3Compatible =
       view.tags.contains(PackageVersionTags.isDart3Compatible);
@@ -139,6 +140,7 @@ d.Node _packageItem(
         child: licenseNode,
       ),
     if (isFlutterFavorite) flutterFavoriteBadgeNode,
+    if (isMaintainerWanted) maintainerWantedBadgeNode,
     if (isNullSafe && !isDart3Compatible) nullSafeBadgeNode(),
     if (isDart3Compatible) dart3CompatibleNode,
     if (isDart3Incompatible) dart3IncompatibleNode,

app/lib/package/backend.dart

@@ -419,6 +419,7 @@ class PackageBackend {
       isDiscontinued: p.isDiscontinued,
       replacedBy: p.replacedBy,
       isUnlisted: p.isUnlisted,
+      isMaintainerWanted: p.isMaintainerWanted ?? false,
     );
   }
 
@@ -463,6 +464,13 @@ class PackageBackend {
         p.isUnlisted = options.isUnlisted!;
         optionsChanges.add('unlisted');
       }
+      if ((options.isMaintainerWanted ?? false) &&
+          (options.isMaintainerWanted ?? false) !=
+              (p.isMaintainerWanted ?? false)) {
+        p.updateMaintainerWanted(
+            isMaintainerWanted: options.isMaintainerWanted ?? false);
+        optionsChanges.add('maintainerWanted');
+      }
 
       if (optionsChanges.isEmpty) {
         return;
@@ -471,7 +479,8 @@ class PackageBackend {
       p.updated = clock.now().toUtc();
       _logger.info('Updating $package options: '
           'isDiscontinued: ${p.isDiscontinued} '
-          'isUnlisted: ${p.isUnlisted}');
+          'isUnlisted: ${p.isUnlisted} '
+          'isMaintainerWanted: ${p.isMaintainerWanted}');
       tx.insert(p);
       tx.insert(await AuditLogRecord.packageOptionsUpdated(
         agent: authenticatedUser,

app/lib/package/models.dart

@@ -137,6 +137,16 @@ class Package extends db.ExpandoModel<String> {
   @db.DateTimeProperty()
   DateTime? adminDeletedAt;
 
+  /// `true` if a package admin wants to advertise that they are looking for new maintainer(s).
+  ///
+  /// Note: the value expires and resets to false after a set period (e.g. 6 months after setting it).
+  @db.BoolProperty(required: false)
+  bool? isMaintainerWanted;
+
+  /// The timestamp when the [isMaintainerWanted] flag was set.
+  @db.DateTimeProperty()
+  DateTime? maintainerWantedStartedAt;
+
   /// Tags that are assigned to this package.
   ///
   /// The permissions required to assign a tag typically depends on the tag.
@@ -188,6 +198,7 @@ class Package extends db.ExpandoModel<String> {
       ..isUnlisted = false
       ..isModerated = false
       ..isAdminDeleted = false
+      ..isMaintainerWanted = false
       ..assignedTags = []
       ..deletedVersions = [];
   }
@@ -380,6 +391,7 @@ class Package extends db.ExpandoModel<String> {
       ],
       if (isUnlisted) PackageTags.isUnlisted,
       if (publisherId != null) PackageTags.publisherTag(publisherId!),
+      if (isMaintainerWanted ?? false) PackageTags.isMaintainerWanted,
     };
   }
 
@@ -419,6 +431,14 @@ class Package extends db.ExpandoModel<String> {
     adminDeletedAt = isAdminDeleted ? clock.now().toUtc() : null;
     updated = clock.now().toUtc();
   }
+
+  void updateMaintainerWanted({
+    required bool isMaintainerWanted,
+  }) {
+    this.isMaintainerWanted = isMaintainerWanted;
+    maintainerWantedStartedAt = isMaintainerWanted ? clock.now().toUtc() : null;
+    updated = clock.now().toUtc();
+  }
 }
 
 /// Describes the various categories of latest releases.

app/lib/shared/integrity.dart

@@ -449,6 +449,11 @@ class IntegrityChecker {
       isAdminDeleted: p.isAdminDeleted,
       adminDeletedAt: p.adminDeletedAt,
     );
+    yield* _checkMaintainerWantedFlags(
+      package: p.name!,
+      isMaintainerWanted: p.isMaintainerWanted,
+      maintainerWantedStartedAt: p.maintainerWantedStartedAt,
+    );
     if (p.isModerated) {
       _packagesWithIsModeratedFlag.add(p.name!);
     }
@@ -1056,3 +1061,18 @@ Stream<String> _checkAdminDeletedFlags({
     yield '$kind "$id" has `isAdminDeleted = false` but `adminDeletedAt` is not null.';
   }
 }
+
+/// Check that `isMaintainerWanted` and `maintainerWantedStartedAt` are consistent.
+Stream<String> _checkMaintainerWantedFlags({
+  required String package,
+  required bool? isMaintainerWanted,
+  required DateTime? maintainerWantedStartedAt,
+}) async* {
+  isMaintainerWanted ??= false;
+  if (isMaintainerWanted && maintainerWantedStartedAt == null) {
+    yield 'Package "$package" has `isMaintainerWanted = true` but `maintainerWantedStartedAt` is null.';
+  }
+  if (!isMaintainerWanted && maintainerWantedStartedAt != null) {
+    yield 'Package "$package" has `isMaintainerWanted = false` but `maintainerWantedStartedAt` is not null.';
+  }
+}

app/lib/tool/test_profile/importer.dart

@@ -161,6 +161,7 @@ Future<void> importProfile({
               isDiscontinued: testPackage.isDiscontinued,
               replacedBy: testPackage.replacedBy,
               isUnlisted: testPackage.isUnlisted,
+              isMaintainerWanted: testPackage.isMaintainerWanted,
             ));
 
         if (testPackage.retractedVersions != null) {

app/lib/tool/test_profile/models.dart

@@ -80,6 +80,7 @@ class TestPackage {
   final bool? isDiscontinued;
   final String? replacedBy;
   final bool? isUnlisted;
+  final bool? isMaintainerWanted;
   final bool? isFlutterFavorite;
   final List<String>? retractedVersions;
   final int? likeCount;
@@ -92,6 +93,7 @@ class TestPackage {
     this.isDiscontinued,
     this.replacedBy,
     this.isUnlisted,
+    this.isMaintainerWanted,
     this.isFlutterFavorite,
     this.retractedVersions,
     this.likeCount,