feat(inquirerer): add skipPrompt flag to skip prompting for optional fields

Adds skipPrompt?: boolean to BaseQuestion. When set to true:
- The question is skipped entirely during interactive prompting
- CLI flag overrides still work (--fieldName value)
- The field still appears in man pages
- The field is simply left out of the answers object if not provided

This is useful for fields with backend-managed defaults where the CLI
should not prompt the user, but still allow explicit overrides.

Author: pyramation

packages/inquirerer/__tests__/prompt.test.ts

@@ -232,6 +232,108 @@ describe('Inquirerer', () => {
     snap(result);
   });
 
+  describe('skipPrompt', () => {
+    it('should skip question with skipPrompt: true and not include it in result', async () => {
+      enqueueInputResponse({ type: 'read', value: 'my name' });
+
+      const prompter = new Inquirerer({
+        input: mockInput,
+        output: mockOutput,
+        noTty: false
+      });
+      const questions: Question[] = [
+        { name: 'name', type: 'text' },
+        { name: 'status', type: 'text', skipPrompt: true },
+      ];
+
+      const result = await prompter.prompt({}, questions);
+
+      // 'status' should not be in the result since it was skipped
+      expect(result).toEqual({ name: 'my name' });
+      expect('status' in result).toBe(false);
+    });
+
+    it('should still allow CLI flag override when skipPrompt is true', async () => {
+      enqueueInputResponse({ type: 'read', value: 'my name' });
+
+      const prompter = new Inquirerer({
+        input: mockInput,
+        output: mockOutput,
+        noTty: false
+      });
+      const questions: Question[] = [
+        { name: 'name', type: 'text' },
+        { name: 'status', type: 'text', skipPrompt: true },
+      ];
+
+      // Pass status via argv (simulating --status "active")
+      const result = await prompter.prompt({ status: 'active' }, questions);
+
+      expect(result).toEqual({ name: 'my name', status: 'active' });
+    });
+
+    it('should skip question in noTty mode with skipPrompt: true', async () => {
+      const prompter = new Inquirerer({
+        input: mockInput,
+        output: mockOutput,
+        noTty: true
+      });
+      const questions: Question[] = [
+        { name: 'name', type: 'text', required: true },
+        { name: 'status', type: 'text', skipPrompt: true },
+      ];
+
+      const result = await prompter.prompt({ name: 'test' }, questions);
+
+      expect(result).toEqual({ name: 'test' });
+      expect('status' in result).toBe(false);
+    });
+
+    it('should include skipPrompt question in man page', () => {
+      const prompter = new Inquirerer({
+        input: mockInput,
+        output: mockOutput,
+        noTty: false
+      });
+      const questions: Question[] = [
+        { name: 'name', type: 'text', required: true },
+        { name: 'status', type: 'text', skipPrompt: true },
+      ];
+
+      const manPage = prompter.generateManPage({
+        commandName: 'test-cmd',
+        questions,
+      });
+
+      // Both fields should appear in the man page
+      expect(manPage).toContain('NAME');
+      expect(manPage).toContain('STATUS');
+    });
+
+    it('should skip multiple skipPrompt questions and only prompt remaining', async () => {
+      enqueueInputResponse({ type: 'read', value: 'hello' });
+
+      const prompter = new Inquirerer({
+        input: mockInput,
+        output: mockOutput,
+        noTty: false
+      });
+      const questions: Question[] = [
+        { name: 'greeting', type: 'text' },
+        { name: 'createdAt', type: 'text', skipPrompt: true },
+        { name: 'updatedAt', type: 'text', skipPrompt: true },
+        { name: 'internalId', type: 'text', skipPrompt: true },
+      ];
+
+      const result = await prompter.prompt({}, questions);
+
+      expect(result).toEqual({ greeting: 'hello' });
+      expect('createdAt' in result).toBe(false);
+      expect('updatedAt' in result).toBe(false);
+      expect('internalId' in result).toBe(false);
+    });
+  });
+
   it('handles readline inputs', async () => {
 
     const prompter = new Inquirerer({

packages/inquirerer/src/prompt.ts

@@ -475,6 +475,15 @@ export class Inquirerer {
         continue;
       }
 
+      // Skip prompt entirely if skipPrompt is set.
+      // The question still appears in man pages and CLI flag overrides still work
+      // (handled by the `question.name in obj` check above), but no interactive
+      // prompt is shown. The field is simply left out of the answers object.
+      if (question.skipPrompt) {
+        ctx.nextQuestion();
+        continue;
+      }
+
       // Apply default value if applicable
       // this is if useDefault is set, rare! not typical defaults which happen AFTER
       // this is mostly to avoid a prompt for "hidden" options

packages/inquirerer/src/question/types.ts

@@ -32,6 +32,7 @@ export interface BaseQuestion {
     pattern?: string;
     dependsOn?: string[];
     when?: (answers: any) => boolean;
+    skipPrompt?: boolean;
   }
 
   export interface ConfirmQuestion extends BaseQuestion {