feat(cmd/email): implement email integration with draft and send functionality

- Add 'draft' subcommand with upload/export/preview/plain-text-only modes
- Add 'send-with-confirm' subcommand with confirmation flow
- Implement automatic report directory detection (latest report-* dir)
- Add --report flag to specify custom report directory
- Add --no-set-message-id flag to skip Message-ID generation
- Include comprehensive help text with usage examples
- Support IMAP upload, .eml export, and preview display modes

The email command generates emails based on evidence reports created by
down-force, automatically selecting the latest report directory by default.

Author: canaria-computer

cmd/email.go

@@ -0,0 +1,256 @@
+/*
+Copyright © 2025 canaria-computer
+*/
+package cmd
+
+import (
+	"fmt"
+
+	"github.com/charmbracelet/log"
+	"github.com/spf13/cobra"
+)
+
+var (
+	// Persistent flags for email command
+	emailReportDir string
+
+	// Flags for draft subcommand
+	emailDraftUpload      bool
+	emailDraftExport      bool
+	emailDraftPreview     bool
+	emailDraftPlainText   bool
+
+	// Flags for send-with-confirm subcommand
+	emailSendNoMessageID bool
+)
+
+// emailCmd represents the email command
+var emailCmd = &cobra.Command{
+	Use:   "email",
+	Short: "Generate and send emails based on evidence reports",
+	Long: `Generate emails from evidence collection reports and send them via SMTP or export as .eml files.
+
+The email command creates properly formatted emails based on down-force evidence reports,
+including attachments, HTML/plain-text content, and proper headers.
+
+By default, the command automatically selects the most recent report directory
+(report-* with the latest timestamp). Use --report to specify a different directory.
+
+Available subcommands:
+  draft              Create email drafts (upload to IMAP, export .eml, or preview)
+  send-with-confirm  Send email after user confirmation
+
+Examples:
+  # Preview email draft from latest report
+  down-force email draft --preview
+
+  # Upload draft to IMAP server
+  down-force email draft --upload
+
+  # Export draft as .eml file
+  down-force email draft --export
+
+  # Send email with confirmation prompt
+  down-force email send-with-confirm
+
+  # Use specific report directory
+  down-force email draft --preview --report report-20240101-120000`,
+	Run: func(cmd *cobra.Command, args []string) {
+		cmd.Help()
+	},
+}
+
+// emailDraftCmd represents the draft subcommand
+var emailDraftCmd = &cobra.Command{
+	Use:   "draft",
+	Short: "Create email draft from evidence report",
+	Long: `Create an email draft based on the evidence collection report.
+
+The draft command generates a properly formatted email with:
+  - Subject line based on phishing target information
+  - HTML and plain-text body with report summary
+  - Attachments (screenshots, HTML files, evidence data)
+  - Proper MIME encoding and headers
+
+Output modes:
+  --upload         Upload draft to IMAP server's Drafts folder
+  --export         Export as .eml file to current directory
+  --preview        Display email preview in terminal
+  --plain-text-only Generate plain-text only (no HTML)
+
+If no mode is specified, --preview is used by default.
+
+The command automatically detects the latest report directory (report-YYYYMMDD-HHMMSS)
+in the current working directory. Use --report to specify a different report.
+
+Examples:
+  # Preview draft from latest report
+  down-force email draft
+  down-force email draft --preview
+
+  # Upload to IMAP Drafts folder
+  down-force email draft --upload
+
+  # Export as email.eml file
+  down-force email draft --export
+
+  # Generate plain-text only email
+  down-force email draft --plain-text-only
+
+  # Use specific report directory
+  down-force email draft --preview --report report-20240101-120000
+
+Configuration:
+  IMAP/SMTP credentials should be configured via environment variables or config file.
+  See 'down-force config email' for email configuration setup.`,
+	Run: runEmailDraft,
+}
+
+// emailSendCmd represents the send-with-confirm subcommand
+var emailSendCmd = &cobra.Command{
+	Use:   "send-with-confirm",
+	Short: "Send email after confirmation",
+	Long: `Generate email from evidence report and send it after user confirmation.
+
+This command:
+  1. Generates the email from the evidence report
+  2. Displays a preview of the email content
+  3. Prompts for user confirmation
+  4. Sends the email via SMTP if confirmed
+  5. Optionally sets Message-ID header for tracking
+
+The Message-ID header is automatically generated by default for email tracking and threading.
+Use --no-set-message-id to skip Message-ID generation and let the mail server assign one.
+
+Examples:
+  # Send email with confirmation (default behavior)
+  down-force email send-with-confirm
+
+  # Send without setting Message-ID
+  down-force email send-with-confirm --no-set-message-id
+
+  # Send from specific report directory
+  down-force email send-with-confirm --report report-20240101-120000
+
+Configuration:
+  SMTP server settings must be configured before sending.
+  Use 'down-force config email' to set up SMTP credentials.
+
+Security:
+  - Passwords are never logged or displayed
+  - TLS/SSL encryption is enforced for SMTP connections
+  - Confirmation prompt prevents accidental sends`,
+	Run: runEmailSend,
+}
+
+func init() {
+	rootCmd.AddCommand(emailCmd)
+	emailCmd.AddCommand(emailDraftCmd)
+	emailCmd.AddCommand(emailSendCmd)
+
+	// Persistent flags (available to all email subcommands)
+	emailCmd.PersistentFlags().StringVar(&emailReportDir, "report", "",
+		"Report directory to use (default: latest report-* directory)")
+
+	// Draft subcommand flags
+	emailDraftCmd.Flags().BoolVar(&emailDraftUpload, "upload", false,
+		"Upload draft to IMAP Drafts folder")
+	emailDraftCmd.Flags().BoolVar(&emailDraftExport, "export", false,
+		"Export draft as .eml file")
+	emailDraftCmd.Flags().BoolVar(&emailDraftPreview, "preview", false,
+		"Display email preview in terminal (default if no mode specified)")
+	emailDraftCmd.Flags().BoolVar(&emailDraftPlainText, "plain-text-only", false,
+		"Generate plain-text only email (no HTML)")
+
+	// Send subcommand flags
+	emailSendCmd.Flags().BoolVar(&emailSendNoMessageID, "no-set-message-id", false,
+		"Skip Message-ID generation (let server assign)")
+}
+
+func runEmailDraft(cmd *cobra.Command, args []string) {
+	// Determine report directory
+	reportDir, err := getReportDirectory(emailReportDir)
+	if err != nil {
+		log.Fatalf("Failed to determine report directory: %v", err)
+	}
+
+	log.Infof("Using report directory: %s", reportDir)
+
+	// Determine output mode (default to preview if none specified)
+	if !emailDraftUpload && !emailDraftExport && !emailDraftPreview {
+		emailDraftPreview = true
+	}
+
+	// Validate that only one mode is selected
+	modeCount := 0
+	if emailDraftUpload {
+		modeCount++
+	}
+	if emailDraftExport {
+		modeCount++
+	}
+	if emailDraftPreview {
+		modeCount++
+	}
+
+	if modeCount > 1 {
+		log.Fatal("Error: Only one output mode can be specified (--upload, --export, or --preview)")
+	}
+
+	// Execute based on selected mode
+	if emailDraftUpload {
+		log.Info("Uploading draft to IMAP Drafts folder...")
+		// TODO: Implement IMAP upload
+		log.Warn("IMAP upload not yet implemented")
+	} else if emailDraftExport {
+		log.Info("Exporting draft as .eml file...")
+		// TODO: Implement .eml export
+		log.Warn(".eml export not yet implemented")
+	} else if emailDraftPreview {
+		log.Info("Displaying email preview...")
+		// TODO: Implement preview display
+		log.Warn("Preview display not yet implemented")
+	}
+
+	if emailDraftPlainText {
+		log.Info("Generating plain-text only format")
+	}
+
+	fmt.Printf("\nReport directory: %s\n", reportDir)
+	fmt.Println("Email draft functionality will be implemented here.")
+}
+
+func runEmailSend(cmd *cobra.Command, args []string) {
+	// Determine report directory
+	reportDir, err := getReportDirectory(emailReportDir)
+	if err != nil {
+		log.Fatalf("Failed to determine report directory: %v", err)
+	}
+
+	log.Infof("Using report directory: %s", reportDir)
+
+	if emailSendNoMessageID {
+		log.Info("Message-ID generation disabled")
+	} else {
+		log.Info("Message-ID will be generated for tracking")
+	}
+
+	// TODO: Implement email send with confirmation
+	log.Warn("Email send functionality not yet implemented")
+
+	fmt.Printf("\nReport directory: %s\n", reportDir)
+	fmt.Println("Email send-with-confirm functionality will be implemented here.")
+}
+
+// getReportDirectory determines which report directory to use
+// If reportDir is specified, use that. Otherwise, find the latest report-* directory.
+func getReportDirectory(reportDir string) (string, error) {
+	if reportDir != "" {
+		// User specified a directory
+		return reportDir, nil
+	}
+
+	// TODO: Implement automatic detection of latest report-* directory
+	// For now, return a placeholder
+	return "report-latest", fmt.Errorf("automatic report directory detection not yet implemented")
+}