feat(@angular/cli): remember after prompting users to set up autocompletion and don't prompt again

After the user rejects the autocompletion prompt or accepts and is successfully configured, the state is saved into the Angular CLI's global configuration. Before displaying the autocompletion prompt, this state is checked and the prompt is skipped if it was already shown. If the user accepts the prompt but the setup process fails, then the CLI will prompt again on the next execution, this gives users an opportunity to fix whatever issue they are encountering and try again.

Closes #23003.

Author: dgp1130

packages/angular/cli/src/utilities/completion.ts

@@ -6,13 +6,23 @@
  * found in the LICENSE file at https://angular.io/license
  */
 
-import { logging } from '@angular-devkit/core';
+import { json, logging } from '@angular-devkit/core';
 import { promises as fs } from 'fs';
 import * as path from 'path';
 import { env } from 'process';
 import { colors } from '../utilities/color';
+import { getWorkspace } from '../utilities/config';
 import { isTTY } from '../utilities/tty';
 
+/** Interface for the autocompletion configuration stored in the global workspace. */
+interface CompletionConfig {
+  /**
+   * Whether or not the user has been prompted to set up autocompletion. If `true`, should *not*
+   * prompt them again.
+   */
+  prompted?: boolean;
+}
+
 /**
  * Checks if it is appropriate to prompt the user to setup autocompletion. If not, does nothing. If
  * so prompts and sets up autocompletion for the user. Returns an exit code if the program should
@@ -23,14 +33,27 @@ export async function considerSettingUpAutocompletion(
   logger: logging.Logger,
 ): Promise<number | undefined> {
   // Check if we should prompt the user to setup autocompletion.
-  if (!(await shouldPromptForAutocompletionSetup())) {
-    return undefined; // Already set up, nothing to do.
+  const completionConfig = await getCompletionConfig();
+  if (!(await shouldPromptForAutocompletionSetup(completionConfig))) {
+    return undefined; // Already set up or prompted previously, nothing to do.
   }
 
   // Prompt the user and record their response.
   const shouldSetupAutocompletion = await promptForAutocompletion();
   if (!shouldSetupAutocompletion) {
-    return undefined; // User rejected the prompt and doesn't want autocompletion.
+    // User rejected the prompt and doesn't want autocompletion.
+    logger.info(
+      `
+Ok, you won't be prompted again. Should you change your mind, the following command will set up autocompletion for you:
+
+    ${colors.yellow(`ng completion init`)}
+    `.trim(),
+    );
+
+    // Save configuration to remember that the user was prompted and avoid prompting again.
+    await setCompletionConfig({ ...completionConfig, prompted: true });
+
+    return undefined;
   }
 
   // User accepted the prompt, set up autocompletion.
@@ -53,10 +76,36 @@ Appended \`source <(ng completion)\` to \`${rcFile}\`. Restart your terminal or
     `.trim(),
   );
 
+  // Save configuration to remember that the user was prompted.
+  await setCompletionConfig({ ...completionConfig, prompted: true });
+
   return undefined;
 }
 
-async function shouldPromptForAutocompletionSetup(): Promise<boolean> {
+async function getCompletionConfig(): Promise<CompletionConfig | undefined> {
+  const wksp = await getWorkspace('global');
+
+  return wksp?.getCli()?.['completion'];
+}
+
+async function setCompletionConfig(config: CompletionConfig): Promise<void> {
+  const wksp = await getWorkspace('global');
+  if (!wksp) {
+    throw new Error(`Could not find global workspace`);
+  }
+
+  wksp.extensions['cli'] ??= {};
+  const cli = wksp.extensions['cli'];
+  if (!json.isJsonObject(cli)) {
+    throw new Error(
+      `Invalid config found at ${wksp.filePath}. \`extensions.cli\` should be an object.`,
+    );
+  }
+  cli.completion ??= config as json.JsonObject;
+  await wksp.save();
+}
+
+async function shouldPromptForAutocompletionSetup(config?: CompletionConfig): Promise<boolean> {
   // Force whether or not to prompt for autocomplete to give an easy path for e2e testing to skip.
   const forceAutocomplete = env['NG_FORCE_AUTOCOMPLETE'];
   if (forceAutocomplete !== undefined) {
@@ -68,6 +117,11 @@ async function shouldPromptForAutocompletionSetup(): Promise<boolean> {
     return false;
   }
 
+  // Skip prompt if the user has already been prompted.
+  if (config?.prompted) {
+    return false;
+  }
+
   // `$HOME` variable is necessary to find RC files to modify.
   const home = env['HOME'];
   if (!home) {

tests/legacy-cli/e2e/tests/misc/completion-prompt.ts

@@ -2,7 +2,7 @@ import { promises as fs } from 'fs';
 import * as os from 'os';
 import * as path from 'path';
 import { env } from 'process';
-import { execWithEnv } from '../../utils/process';
+import { execAndCaptureError, execWithEnv } from '../../utils/process';
 
 const AUTOCOMPLETION_PROMPT = /Would you like to enable autocompletion\?/;
 const DEFAULT_ENV = Object.freeze({
@@ -83,6 +83,161 @@ export default async function () {
         'CLI printed that it successfully set up autocompletion when it actually' + " didn't.",
       );
     }
+
+    if (!stdout.includes("Ok, you won't be prompted again.")) {
+      throw new Error('CLI did not inform the user they will not be prompted again.');
+    }
+  });
+
+  // Does *not* prompt if the user already accepted (even if they delete the completion config).
+  await mockHome(async (home) => {
+    const bashrc = path.join(home, '.bashrc');
+    await fs.writeFile(bashrc, '# Other commands...');
+
+    const { stdout: stdout1 } = await execWithEnv(
+      'ng',
+      ['version'],
+      {
+        ...DEFAULT_ENV,
+        SHELL: '/bin/bash',
+        HOME: home,
+      },
+      'y' /* stdin: accept prompt */,
+    );
+
+    if (!AUTOCOMPLETION_PROMPT.test(stdout1)) {
+      throw new Error('First execution did not prompt for autocompletion setup.');
+    }
+
+    const bashrcContents1 = await fs.readFile(bashrc, 'utf-8');
+    if (!bashrcContents1.includes('source <(ng completion)')) {
+      throw new Error(
+        '`~/.bashrc` file was not updated after the user accepted the autocompletion' +
+          ` prompt. Contents:\n${bashrcContents1}`,
+      );
+    }
+
+    // User modifies their configuration and removes `ng completion`.
+    await fs.writeFile(bashrc, '# Some new commands...');
+
+    const { stdout: stdout2 } = await execWithEnv('ng', ['version'], {
+      ...DEFAULT_ENV,
+      SHELL: '/bin/bash',
+      HOME: home,
+    });
+
+    if (AUTOCOMPLETION_PROMPT.test(stdout2)) {
+      throw new Error(
+        'Subsequent execution after rejecting autocompletion setup prompted again' +
+          ' when it should not have.',
+      );
+    }
+
+    const bashrcContents2 = await fs.readFile(bashrc, 'utf-8');
+    if (bashrcContents2 !== '# Some new commands...') {
+      throw new Error(
+        '`~/.bashrc` file was incorrectly modified when using a modified `~/.bashrc`' +
+          ` after previously accepting the autocompletion prompt. Contents:\n${bashrcContents2}`,
+      );
+    }
+  });
+
+  // Does *not* prompt if the user already rejected.
+  await mockHome(async (home) => {
+    const bashrc = path.join(home, '.bashrc');
+    await fs.writeFile(bashrc, '# Other commands...');
+
+    const { stdout: stdout1 } = await execWithEnv(
+      'ng',
+      ['version'],
+      {
+        ...DEFAULT_ENV,
+        SHELL: '/bin/bash',
+        HOME: home,
+      },
+      'n' /* stdin: reject prompt */,
+    );
+
+    if (!AUTOCOMPLETION_PROMPT.test(stdout1)) {
+      throw new Error('First execution did not prompt for autocompletion setup.');
+    }
+
+    const { stdout: stdout2 } = await execWithEnv('ng', ['version'], {
+      ...DEFAULT_ENV,
+      SHELL: '/bin/bash',
+      HOME: home,
+    });
+
+    if (AUTOCOMPLETION_PROMPT.test(stdout2)) {
+      throw new Error(
+        'Subsequent execution after rejecting autocompletion setup prompted again' +
+          ' when it should not have.',
+      );
+    }
+
+    const bashrcContents = await fs.readFile(bashrc, 'utf-8');
+    if (bashrcContents !== '# Other commands...') {
+      throw new Error(
+        '`~/.bashrc` file was incorrectly modified when the user never accepted the' +
+          ` autocompletion prompt. Contents:\n${bashrcContents}`,
+      );
+    }
+  });
+
+  // Prompts user again on subsequent execution after accepting prompt but failing to setup.
+  await mockHome(async (home) => {
+    const bashrc = path.join(home, '.bashrc');
+    await fs.writeFile(bashrc, '# Other commands...');
+
+    // Make `~/.bashrc` readonly. This is enough for the CLI to verify that the file exists and
+    // `ng completion` is not in it, but will fail when actually trying to modify the file.
+    await fs.chmod(bashrc, 0o444);
+
+    const err = await execAndCaptureError(
+      'ng',
+      ['version'],
+      {
+        ...DEFAULT_ENV,
+        SHELL: '/bin/bash',
+        HOME: home,
+      },
+      'y' /* stdin: accept prompt */,
+    );
+
+    if (!err.message.includes('Failed to append autocompletion setup')) {
+      throw new Error(
+        `Failed first execution did not print the expected error message. Actual:\n${err.message}`,
+      );
+    }
+
+    // User corrects file permissions between executions.
+    await fs.chmod(bashrc, 0o777);
+
+    const { stdout: stdout2 } = await execWithEnv(
+      'ng',
+      ['version'],
+      {
+        ...DEFAULT_ENV,
+        SHELL: '/bin/bash',
+        HOME: home,
+      },
+      'y' /* stdin: accept prompt */,
+    );
+
+    if (!AUTOCOMPLETION_PROMPT.test(stdout2)) {
+      throw new Error(
+        'Subsequent execution after failed autocompletion setup did not prompt again when it should' +
+          ' have.',
+      );
+    }
+
+    const bashrcContents = await fs.readFile(bashrc, 'utf-8');
+    if (!bashrcContents.includes('ng completion')) {
+      throw new Error(
+        '`~/.bashrc` file does not include `ng completion` after the user never accepted the' +
+          ` autocompletion prompt a second time. Contents:\n${bashrcContents}`,
+      );
+    }
   });
 
   // Does *not* prompt user for CI executions.