flag unlabeled PRs with wildcard label

README.md

@@ -117,12 +117,54 @@ The supported options are:
 
 - `labels`: GitHub PR labels mapped to changelog section headers
 
+- `wildcardLabel`: A label to identify commits that don't have a GitHub PR label 
+  which matches a value in `labels`. (e.g. `unlabeled`) By default, this has no value. [Read more about this option](#wildcardlabel).
+
 - `ignoreCommitters`: List of committers to ignore (exact or partial match).
   Useful for example to ignore commits from bots.
 
 - `cacheDir`: Path to a GitHub API response cache to avoid throttling
   (e.g. `.changelog`)
 
+### wildcardLabel
+
+For some projects, it may be beneficial to list PRs in the changelog that don't 
+have a matching label defined in the configuration `labels`. Listing these PRs also allows you to review the changelog and identify any PRs that should be re-labeled on GitHub. For example, forgetting to label a breaking change.
+
+```json5
+{
+  // ...
+  "changelog": {
+    "wildcardLabel": "unlabeled"
+  }
+}
+```
+
+A default changlog heading of `:present: Additional updates` is set when a value for `wildcardLabel` is in the configuration.
+
+```md
+## Unreleased (2018-05-24)
+
+#### 🎁 Additional updates
+* [#514](https://github.com/my-org/my-repo/pull/514) Setting to mute video ([@diligent-developer](https://github.com/diligent-developer))
+```
+
+You can overwrite the default heading by including the `wildcardLabel` value in the configuration's `labels` object. For example:
+
+```json5
+{
+  // ...
+  "changelog": {
+    "labels": {
+      "feature": "New Feature",
+      "bug": "Bug Fix",
+      "unlabeled": "Unlabeled PRs"
+    },
+    "wildcardLabel": "unlabeled"
+  }
+}
+```
+
 
 License
 ------------------------------------------------------------------------------

src/changelog.ts

@@ -206,6 +206,17 @@ export default class Changelog {
 
       const labels = commit.githubIssue.labels.map(label => label.name.toLowerCase());
 
+      if (this.config.wildcardLabel) {
+        // check whether the commit has any of the labels from the learna.json config.
+        // If not, label this commit with the provided label
+
+        let foundLabel = Object.keys(this.config.labels).some(label => labels.indexOf(label.toLowerCase()) !== -1);
+
+        if (!foundLabel) {
+          labels.push(this.config.wildcardLabel);
+        }
+      }
+
       commit.categories = Object.keys(this.config.labels)
         .filter(label => labels.indexOf(label.toLowerCase()) !== -1)
         .map(label => this.config.labels[label]);

src/configuration.ts

@@ -13,6 +13,7 @@ export interface Configuration {
   cacheDir?: string;
   nextVersion: string | undefined;
   nextVersionFromMetadata?: boolean;
+  wildcardLabel?: string;
 }
 
 export interface ConfigLoaderOptions {
@@ -31,7 +32,7 @@ export function fromPath(rootPath: string, options: ConfigLoaderOptions = {}): C
   let config = fromPackageConfig(rootPath) || fromLernaConfig(rootPath) || {};
 
   // Step 2: fill partial config with defaults
-  let { repo, nextVersion, labels, cacheDir, ignoreCommitters } = config;
+  let { repo, nextVersion, labels, cacheDir, ignoreCommitters, wildcardLabel } = config;
 
   if (!repo) {
     repo = findRepo(rootPath);
@@ -58,6 +59,10 @@ export function fromPath(rootPath: string, options: ConfigLoaderOptions = {}): C
     };
   }
 
+  if (wildcardLabel && !labels[wildcardLabel]) {
+    labels[wildcardLabel] = "️:present: Additional updates";
+  }
+
   if (!ignoreCommitters) {
     ignoreCommitters = [
       "dependabot-bot",
@@ -76,6 +81,7 @@ export function fromPath(rootPath: string, options: ConfigLoaderOptions = {}): C
     labels,
     ignoreCommitters,
     cacheDir,
+    wildcardLabel,
   };
 }