feat(sponsors): add email functionality with template support

- Introduced `EmailArgs` struct for handling email command arguments.
- Implemented email sending logic in `email.rs`, including template fetching and variable substitution.
- Added interactive template selection for email composition.
- Created `args.rs` for command-line argument parsing related to sponsors.
- Developed `interactive.rs` for interactive sponsor listing and detail viewing.
- Added `template.rs` for handling email template variable substitution and unresolved variable detection.
- Created `email_template.rs` to define data structures for email templates and responses.
- Updated `mod.rs` to include new modules and functionalities.
- Enhanced `main.rs` to support the new email command.
- Added end-to-end tests for email template fetching, variable substitution, and sending.

Author: Starefossen

CHANGELOG.md

@@ -9,6 +9,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Added
 
+- `cnctl admin sponsors email <id>` — send templated emails to sponsors
+  - Interactive fuzzy-search template picker, pre-sorted by relevance
+  - `--template <slug>` for non-interactive template selection
+  - `--message` for direct message (skip templates)
+  - `--edit` to open `$EDITOR` before sending
+  - `--dry-run` to preview without sending
+  - `--json` for machine-readable output
+  - Automatic variable substitution (`{{{SPONSOR_NAME}}}`, etc.)
+- Template variable engine (`template.rs`) with unresolved variable detection
 - Browser-based OAuth login (GitHub / LinkedIn) with conference selection
 - `cnctl login` / `cnctl logout` / `cnctl status` commands
 - `cnctl admin proposals list` — list all talk proposals

Cargo.toml

@@ -19,6 +19,7 @@ open = "5"
 reqwest = { version = "0.13", features = ["json"] }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
+tempfile = "3"
 terminal_size = "0.4"
 tiny_http = "0.12"
 tokio = { version = "1", features = ["full"] }

README.md

@@ -11,6 +11,7 @@ The organizer CLI for [Cloud Native Days Norway](https://cloudnativedays.no). Re
 - 🔐 **Browser-based login** — authenticate with GitHub or LinkedIn OAuth, no API keys to manage
 - 📋 **Interactive proposal review** — fuzzy-search, filter by status/format, sort by rating, and scroll through details with vim-style keybindings
 - 💰 **Sponsor pipeline** — track sponsors from prospect to paid, with contacts, tiers, and contract status
+- 📧 **Sponsor emails** — send templated emails to sponsors with interactive template picker, `$EDITOR` integration, and variable substitution
 - 🎨 **Color-coded output** — status badges at a glance (green = confirmed, yellow = submitted, red = rejected, …)
 - 📊 **JSON output** — pipe to `jq` or feed into scripts with `--json`
 - 🖥️ **Cross-platform** — prebuilt binaries for macOS, Linux, and Windows
@@ -97,6 +98,11 @@ cnctl admin sponsors list
 cnctl admin sponsors list --status negotiating,closedWon
 cnctl admin sponsors get <id>
 
+cnctl admin sponsors email <id>                    # interactive template picker
+cnctl admin sponsors email <id> --template <slug>  # use specific template
+cnctl admin sponsors email <id> --message "Hello"  # send direct message
+cnctl admin sponsors email <id> --dry-run          # preview without sending
+
 cnctl logout         # clear credentials
 ```
 
@@ -230,6 +236,52 @@ Dive into a specific sponsor for contacts, billing details, and notes:
 cnctl admin sponsors get <sponsor-id>
 ```
 
+### Sponsor Emails
+
+Send templated emails to sponsor contacts directly from the terminal. Templates are managed in the web UI and delivered with full conference branding via Resend.
+
+**Interactive mode** (default) — shows a fuzzy-search template picker, pre-sorted by relevance for the sponsor's status and language:
+
+```sh
+cnctl admin sponsors email <sponsor-id>
+```
+
+**Select a specific template:**
+
+```sh
+cnctl admin sponsors email <sponsor-id> --template cold-outreach-en
+```
+
+**Send a direct message** (skip templates):
+
+```sh
+cnctl admin sponsors email <sponsor-id> --message "Quick follow-up on our call."
+```
+
+**Preview without sending:**
+
+```sh
+cnctl admin sponsors email <sponsor-id> --dry-run
+cnctl admin sponsors email <sponsor-id> --dry-run --json
+```
+
+**Edit in your editor before sending:**
+
+```sh
+cnctl admin sponsors email <sponsor-id> --edit
+```
+
+| Flag           | Description                                           |
+| -------------- | ----------------------------------------------------- |
+| `--template`   | Template slug (skip interactive picker)                |
+| `--subject`    | Override the email subject                             |
+| `--message`    | Use this body directly (skip template selection)       |
+| `--edit`       | Open `$EDITOR` to edit the message before sending      |
+| `--dry-run`    | Preview the email without sending                      |
+| `--json`       | Output as JSON                                         |
+
+Template variables like `{{{SPONSOR_NAME}}}`, `{{{CONTACT_NAMES}}}`, and `{{{CONFERENCE_TITLE}}}` are automatically resolved from the sponsor and conference context.
+
 ## 🛠️ Development
 
 ### Prerequisites
@@ -259,9 +311,10 @@ src/
   auth.rs         — browser-based OAuth flow with local callback server
   client.rs       — tRPC HTTP client
   config.rs       — TOML config read/write (~/.config/cnctl/)
+  template.rs     — {{{VAR}}} template variable substitution
   commands/       — command orchestration
     proposals/    — proposal list, detail, review, filters, interactive mode
-    sponsors.rs   — sponsor list and detail
+    sponsors/     — sponsor list, detail, email sending with template picker
   display/        — terminal output formatting (colors, layout, truncation)
   types/          — API response types with typed enums (serde)
   ui/             — reusable TUI components (pager, spinner, terminal helpers)

src/commands/sponsors/args.rs

@@ -0,0 +1,44 @@
+use clap::Args;
+
+use crate::types::SponsorStatus;
+
+#[derive(Args)]
+pub struct ListArgs {
+    /// Filter by status (comma-separated)
+    #[arg(long, value_delimiter = ',', value_enum)]
+    pub status: Option<Vec<SponsorStatus>>,
+
+    /// Output as JSON
+    #[arg(long)]
+    pub json: bool,
+}
+
+#[derive(Args)]
+pub struct EmailArgs {
+    /// Sponsor-for-conference ID
+    pub id: String,
+
+    /// Template slug to use (interactive picker if omitted)
+    #[arg(long)]
+    pub template: Option<String>,
+
+    /// Override the email subject
+    #[arg(long)]
+    pub subject: Option<String>,
+
+    /// Use this message body directly (skip template selection)
+    #[arg(long)]
+    pub message: Option<String>,
+
+    /// Open $EDITOR to edit the message before sending
+    #[arg(long)]
+    pub edit: bool,
+
+    /// Preview the email without sending
+    #[arg(long)]
+    pub dry_run: bool,
+
+    /// Output as JSON
+    #[arg(long)]
+    pub json: bool,
+}