Add fuzzy autocomplete to account selection prompt

changelog.txt

@@ -1,13 +1,11 @@
-★ Release Notes: 2026-01-29 ★
+★ Release Notes: 2026-02-25 ★
 ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
 
 Thanks for upgrading to the latest version of the ALKS CLI!
 
-* Fixed metadata server path resolution issues and launch daemon loading (DE565327).
-  - Corrected paths for metadata-server.js, forever daemon root, and service files
-  - Fixed launch daemon plist to properly load pf rules as an anchor
-  - Improved daemon loading logic to ensure service starts even if files were previously installed
-* Fixed favorites not being displayed correctly in certain scenarios.
+* Added real-time search/filter to account selection prompt.
+  - Type to filter accounts by alias or account ID instead of scrolling
+  - Uses case-insensitive substring matching
 
 Have feedback? https://github.com/Cox-Automotive/ALKS-CLI/issues
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "alks",
-  "version": "3.24.3",
+  "version": "3.24.4",
   "description": "CLI for working with ALKS",
   "main": "dist/src/bin/alks.js",
   "scripts": {
@@ -54,6 +54,7 @@
     "fuzzy": "^0.1.1",
     "ini": "^2.0.0",
     "inquirer": "^8.2.7",
+    "inquirer-autocomplete-prompt": "^2.0.1",
     "lodash": "^4.17.21",
     "lokijs": "^1.5.1",
     "memoizee": "^0.4.15",

src/lib/getStdErrPrompt.ts

@@ -1,5 +1,8 @@
 import { createPromptModule } from 'inquirer';
+import AutocompletePrompt from 'inquirer-autocomplete-prompt';
 
 export function getStdErrPrompt() {
-  return createPromptModule({ output: process.stderr });
+  const prompt = createPromptModule({ output: process.stderr });
+  prompt.registerPrompt('autocomplete', AutocompletePrompt);
+  return prompt;
 }

src/lib/promptForAlksAccountAndRole.test.ts

@@ -78,7 +78,9 @@ describe('promptForAlksAccountAndRole', () => {
   it('prompts the user with formatted role output', async () => {
     await promptForAlksAccountAndRole({});
 
-    expect(mockPromptFn.mock.calls[0][0][0].choices).toStrictEqual([
+    const promptConfig = mockPromptFn.mock.calls[0][0][0];
+    const results = await promptConfig.source({}, undefined);
+    expect(results).toStrictEqual([
       // favorites pulled to top after alphabetical sort
       'clientstaging .. 678901234567/ALKSAdmin                 ::  Admin',
       'commontools .... 567890123456/ALKSReadOnly              ::  ReadOnly',
@@ -109,9 +111,31 @@ describe('promptForAlksAccountAndRole', () => {
 
   it('should filter non-favorites if filterFavorites is true', async () => {
     await promptForAlksAccountAndRole({ filterFavorites: true });
-    expect(mockPromptFn.mock.calls[0][0][0].choices.length).toBe(
-      mockFavorites.length
-    );
+    const promptConfig = mockPromptFn.mock.calls[0][0][0];
+    const results = await promptConfig.source({}, undefined);
+    expect(results.length).toBe(mockFavorites.length);
+  });
+
+  it('should return all choices when input is an empty string', async () => {
+    await promptForAlksAccountAndRole({});
+    const promptConfig = mockPromptFn.mock.calls[0][0][0];
+    const results = await promptConfig.source({}, '');
+    expect(results.length).toBe(mockAccounts.length);
+  });
+
+  it('should return only matching results when input is provided', async () => {
+    await promptForAlksAccountAndRole({});
+    const promptConfig = mockPromptFn.mock.calls[0][0][0];
+    const results = await promptConfig.source({}, 'devlabs');
+    expect(results.length).toBeGreaterThan(0);
+    expect(results.every((r: string) => r.includes('devlabs'))).toBe(true);
+  });
+
+  it('should return no results when input does not match any account', async () => {
+    await promptForAlksAccountAndRole({});
+    const promptConfig = mockPromptFn.mock.calls[0][0][0];
+    const results = await promptConfig.source({}, 'rafa');
+    expect(results.length).toBe(0);
   });
 
   it('should throw an error if no accounts are found', async () => {

src/lib/promptForAlksAccountAndRole.ts

@@ -19,7 +19,10 @@ export interface AlksAccountPromptData {
   type: string;
   name: string;
   message: string;
-  choices: string[];
+  source: (
+    answers: Record<string, unknown>,
+    input: string | undefined
+  ) => Promise<string[]>;
   pageSize: number;
   default?: string;
 }
@@ -69,11 +72,23 @@ export async function promptForAlksAccountAndRole(
     throw new Error('No accounts found.');
   }
 
+  const allChoices = indexedAlksAccounts.map((a) => a.formattedOutput);
+
   const promptData: AlksAccountPromptData = {
-    type: 'list',
+    type: 'autocomplete',
     name: 'alksAccount',
     message: opts.prompt,
-    choices: indexedAlksAccounts.map((a) => a.formattedOutput), // Use the formatted output for choices
+    source: (
+      _answers: Record<string, unknown>,
+      input: string | undefined
+    ): Promise<string[]> => {
+      if (!input) {
+        return Promise.resolve(allChoices);
+      }
+      return Promise.resolve(
+        allChoices.filter((c) => c.toLowerCase().includes(input.toLowerCase()))
+      );
+    },
     pageSize: 15,
   };
 

src/types/inquirer-autocomplete-prompt.d.ts

@@ -0,0 +1,5 @@
+declare module 'inquirer-autocomplete-prompt' {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const AutocompletePrompt: any;
+  export default AutocompletePrompt;
+}