CLI: --email flag missing from help output

[buger]

Description

The --email flag for the email frontend runner is not shown in visor --help output, even though it's fully implemented and documented in the TypeScript types (cli.d.ts line 63-64):

/** Enable Email polling runner (IMAP/Resend) */
email?: boolean;

Expected

visor --help should list --email alongside --slack and --telegram:

--slack                               Enable Slack Socket Mode runner
--telegram                            Enable Telegram long-polling runner
--email                               Enable Email polling runner (IMAP/Resend)

Actual

Only --slack, --telegram, and --a2a appear in help output.

Version

@probelabs/visor@0.1.178

[probelabs]

Thank you for reporting this issue! I've investigated the CLI help output implementation and can confirm the problem.

Issue Analysis

Category: Bug
Priority: Low
Complexity: Simple

What I Found

The --email flag is fully implemented in the codebase:

1. TypeScript types (src/types/cli.ts:63-64): The CliOptions interface correctly defines:

   /** Enable Email polling runner (IMAP/Resend) */
   email?: boolean;

2. setupProgram() (src/cli.ts:31-122): The main CLI setup does include the flag:

   .option('--email', 'Enable Email polling runner (IMAP/SMTP or Resend)')

3. parseArgs() (src/cli.ts:134-338): The argument parser correctly handles the email option and returns it in the parsed options.

4. Documentation (docs/email-integration.md): The email integration is fully documented.

The Root Cause

The bug is in the getHelpText() method (src/cli.ts:387-451). This method creates a separate Command instance to generate help text, but it's missing several bot integration flags:

• Missing: --email, --whatsapp, --teams
• Present: --slack, --telegram, --a2a

This is a clear inconsistency — the setupProgram() method has all 6 bot flags, but getHelpText() only has 3 of them.

Impact

• The --email flag works functionally when used
• It's simply missing from the help output, which is a documentation/UX issue
• The same issue affects --whatsapp and --teams flags

Recommended Fix

Add the missing bot integration options to the getHelpText() method to match setupProgram():

.option('--email', 'Enable Email polling runner (IMAP/SMTP or Resend)')
.option('--whatsapp', 'Enable WhatsApp webhook runner (uses WHATSAPP_ACCESS_TOKEN)')
.option('--teams', 'Enable Microsoft Teams webhook runner (uses TEAMS_APP_ID)')

This should be added around line 407 in src/cli.ts, alongside the existing --slack and --telegram options.

Additional Context

The parseArgs() method also has a similar inconsistency — it only defines --slack, --telegram, and --a2a but not --email, --whatsapp, or --teams. However, since the parsed options still return these flags correctly (they're handled via Boolean(options.email) etc.), the functional impact is limited to the help display.

---

References:

• src/cli.ts:31-122 – setupProgram() with all bot flags including --email
• src/cli.ts:387-451 – getHelpText() missing --email, --whatsapp, --teams
• src/cli.ts:134-338 – parseArgs() returning email option
• src/types/cli.ts:63-64 – CliOptions.email type definition
• docs/email-integration.md:49-70 – Email integration documentation

---

Powered by Visor from Probelabs

💡 TIP: You can chat with Visor using /visor ask <your question>