feat(cli): implement new last CLI flag

Author: Mersho

@commitlint/cli/src/cli.test.ts

@@ -527,6 +527,8 @@ test('should print help', async () => {
 		                       edit=false                                       [string]
 		      --git-log-args   additional git log arguments as space separated string,
 		                       example '--first-parent --cherry-pick'           [string]
+		  -l, --last           just analyze the last commit; applies if edit=false
+		                                                                       [boolean]
 		  -o, --format         output format of the results                     [string]
 		  -p, --parser-preset  configuration preset to use for
 		                       conventional-commits-parser                      [string]

@commitlint/cli/src/cli.ts

@@ -82,6 +82,11 @@ const cli = yargs
 				"additional git log arguments as space separated string, example '--first-parent --cherry-pick'",
 			type: 'string',
 		},
+		last: {
+			alias: 'l',
+			description: 'just analyze the last commit; applies if edit=false',
+			type: 'boolean',
+		},
 		format: {
 			alias: 'o',
 			description: 'output format of the results',
@@ -212,7 +217,7 @@ async function main(args: MainArgs): Promise<void> {
 
 	if (messages.length === 0 && !checkFromRepository(flags)) {
 		const err = new CliError(
-			'[input] is required: supply via stdin, or --env or --edit or --from and --to',
+			'[input] is required: supply via stdin, or --env or --edit or --last or --from and --to',
 			pkg.name
 		);
 		yargs.showHelp('log');
@@ -355,7 +360,11 @@ function checkFromEdit(flags: CliFlags): boolean {
 }
 
 function checkFromHistory(flags: CliFlags): boolean {
-	return typeof flags.from === 'string' || typeof flags.to === 'string';
+	return (
+		typeof flags.from === 'string' ||
+		typeof flags.to === 'string' ||
+		typeof flags.last === 'boolean'
+	);
 }
 
 function normalizeFlags(flags: CliFlags): CliFlags {

@commitlint/cli/src/types.ts

@@ -9,6 +9,7 @@ export interface CliFlags {
 	'help-url'?: string;
 	from?: string;
 	'git-log-args'?: string;
+	last?: boolean;
 	format?: string;
 	'parser-preset'?: string;
 	quiet: boolean;