kickload-watcher-mcp 0.1.0 → 0.1.2

package/config.js

@@ -1,103 +1,113 @@
-import dotenv from "dotenv";
-dotenv.config();
-
-export const config = {
-  anthropic: {
-    apiKey:           process.env.ANTHROPIC_API_KEY            || "",
-    complianceApiKey: process.env.ANTHROPIC_COMPLIANCE_API_KEY || "",
-    complianceBaseUrl:"https://api.anthropic.com/v1",
-    pollIntervalMs:   parseInt(process.env.POLL_INTERVAL_MS    || "60000"),
-    model:            "claude-sonnet-4-20250514",
-  },
-
-  kickload: {
-    apiToken:         process.env.KICKLOAD_API_TOKEN || "",
-    baseUrl:          process.env.KICKLOAD_BASE_URL  || "https://kickload.neeyatai.com/api",
-    defaultThreads:   parseInt(process.env.DEFAULT_THREADS || "5"),
-    defaultLoopCount: parseInt(process.env.DEFAULT_LOOPS   || "2"),
-    defaultRampTime:  parseInt(process.env.DEFAULT_RAMP    || "2"),
-  },
-
-  targetApiBaseUrl: process.env.TARGET_API_BASE_URL || null,
-
-  // ngrok.enabled is now advisory only — pipeline auto-enables for localhost
-  ngrok: {
-    enabled:   process.env.NGROK_ENABLED !== "false", // default true
-    authToken: process.env.NGROK_AUTHTOKEN || "",
-    binDir:    ".bin",
-  },
-
-  email: {
-    provider: process.env.EMAIL_PROVIDER || "smtp",
-    smtp: {
-      host: process.env.SMTP_HOST || "smtp.gmail.com",
-      port: parseInt(process.env.SMTP_PORT || "465"),
-      user: process.env.SMTP_USER || "",
-      pass: process.env.SMTP_PASS || "",
-    },
-    sendgrid: { apiKey: process.env.SENDGRID_API_KEY || "" },
-    ses: {
-      accessKey: process.env.AWS_ACCESS_KEY_ID     || "",
-      secretKey: process.env.AWS_SECRET_ACCESS_KEY || "",
-      region:    process.env.AWS_REGION            || "us-east-1",
-    },
-    fromName:    process.env.EMAIL_FROM_NAME    || "KickLoad Watcher",
-    fromAddress: process.env.EMAIL_FROM_ADDRESS || "",
-  },
-
-  watcher: {
-    watchPaths: (process.env.WATCH_PATHS || ".").split(",").map(p => p.trim()),
-    extensions: [".js", ".ts", ".py", ".go", ".java", ".rb", ".php", ".cs", ".rs"],
-    ignore:     ["**/node_modules/**", "**/.git/**", "**/dist/**", "**/build/**"],
-  },
-
-  identity: {
-    mapFile:         process.env.IDENTITY_MAP            || "./users.json",
-    defaultUserId:   process.env.DEFAULT_USER_ID         || null,
-    defaultDevEmail: process.env.DEFAULT_DEVELOPER_EMAIL || null,
-  },
-
-  triggerMode: process.env.TRIGGER_MODE || "claudecode",
-
-  github: {
-    token:         process.env.GITHUB_TOKEN          || "",
-    webhookPort:   parseInt(process.env.GITHUB_WEBHOOK_PORT || "3456"),
-    webhookSecret: process.env.GITHUB_WEBHOOK_SECRET || "",
-  },
-
-  logLevel: process.env.LOG_LEVEL || "info",
-};
-
-export function validateConfig() {
-  const errors   = [];
-  const warnings = [];
-
-  if (!config.anthropic.apiKey)  errors.push("ANTHROPIC_API_KEY is required");
-  if (!config.kickload.apiToken) errors.push("KICKLOAD_API_TOKEN is required");
-  if (!config.email.fromAddress) errors.push("EMAIL_FROM_ADDRESS is required");
-
-  if (config.email.provider === "smtp") {
-    if (!config.email.smtp.user) errors.push("SMTP_USER is required for smtp provider");
-    if (!config.email.smtp.pass) errors.push("SMTP_PASS is required for smtp provider");
-  }
-
-  if (config.email.provider === "sendgrid" && !config.email.sendgrid.apiKey) {
-    errors.push("SENDGRID_API_KEY is required when EMAIL_PROVIDER=sendgrid");
-  }
-
-  // ngrok token is a warning, not a hard error — auto-mode handles it gracefully
-  if (!config.ngrok.authToken) {
-    warnings.push("NGROK_AUTHTOKEN not set — ngrok tunnel will not authenticate (localhost backends cannot be tested)");
-  }
-
-  if (warnings.length) {
-    warnings.forEach(w => console.warn(`  ⚠️  ${w}`));
-  }
-
-  if (errors.length) {
-    console.error("\n❌ Missing required configuration:");
-    errors.forEach(e => console.error(`   • ${e}`));
-    console.error("\n   Fix: delete .env and re-run to go through setup again, or edit .env manually.\n");
-    process.exit(1);
-  }
-}
+import dotenv from "dotenv";
+dotenv.config();
+
+// Called by index.js after setup writes .env so all fields reflect the real values.
+export function reloadConfig() {
+  dotenv.config({ override: true });
+  Object.assign(config, buildConfig());
+}
+
+function buildConfig() {
+  return {
+  anthropic: {
+    apiKey:           process.env.ANTHROPIC_API_KEY            || "",
+    complianceApiKey: process.env.ANTHROPIC_COMPLIANCE_API_KEY || "",
+    complianceBaseUrl:"https://api.anthropic.com/v1",
+    pollIntervalMs:   parseInt(process.env.POLL_INTERVAL_MS    || "60000"),
+    model:            "claude-sonnet-4-20250514",
+  },
+
+  kickload: {
+    apiToken:         process.env.KICKLOAD_API_TOKEN || "",
+    baseUrl:          process.env.KICKLOAD_BASE_URL  || "https://kickload.neeyatai.com/api",
+    defaultThreads:   parseInt(process.env.DEFAULT_THREADS || "5"),
+    defaultLoopCount: parseInt(process.env.DEFAULT_LOOPS   || "2"),
+    defaultRampTime:  parseInt(process.env.DEFAULT_RAMP    || "2"),
+  },
+
+  targetApiBaseUrl: process.env.TARGET_API_BASE_URL || null,
+
+  // ngrok.enabled is now advisory only — pipeline auto-enables for localhost
+  ngrok: {
+    enabled:   process.env.NGROK_ENABLED !== "false", // default true
+    authToken: process.env.NGROK_AUTHTOKEN || "",
+    binDir:    ".bin",
+  },
+
+  email: {
+    provider: process.env.EMAIL_PROVIDER || "smtp",
+    smtp: {
+      host: process.env.SMTP_HOST || "smtp.gmail.com",
+      port: parseInt(process.env.SMTP_PORT || "465"),
+      user: process.env.SMTP_USER || "",
+      pass: process.env.SMTP_PASS || "",
+    },
+    sendgrid: { apiKey: process.env.SENDGRID_API_KEY || "" },
+    ses: {
+      accessKey: process.env.AWS_ACCESS_KEY_ID     || "",
+      secretKey: process.env.AWS_SECRET_ACCESS_KEY || "",
+      region:    process.env.AWS_REGION            || "us-east-1",
+    },
+    fromName:    process.env.EMAIL_FROM_NAME    || "KickLoad Watcher",
+    fromAddress: process.env.EMAIL_FROM_ADDRESS || "",
+  },
+
+  watcher: {
+    watchPaths: (process.env.WATCH_PATHS || ".").split(",").map(p => p.trim()),
+    extensions: [".js", ".ts", ".py", ".go", ".java", ".rb", ".php", ".cs", ".rs"],
+    ignore:     ["**/node_modules/**", "**/.git/**", "**/dist/**", "**/build/**"],
+  },
+
+  identity: {
+    mapFile:         process.env.IDENTITY_MAP            || "./users.json",
+    defaultUserId:   process.env.DEFAULT_USER_ID         || null,
+    defaultDevEmail: process.env.DEFAULT_DEVELOPER_EMAIL || null,
+  },
+
+  triggerMode: process.env.TRIGGER_MODE || "claudecode",
+
+  github: {
+    token:         process.env.GITHUB_TOKEN          || "",
+    webhookPort:   parseInt(process.env.GITHUB_WEBHOOK_PORT || "3456"),
+    webhookSecret: process.env.GITHUB_WEBHOOK_SECRET || "",
+  },
+
+  logLevel: process.env.LOG_LEVEL || "info",
+  }; // end return
+} // end buildConfig
+
+export const config = buildConfig();
+
+export function validateConfig() {
+  const errors   = [];
+  const warnings = [];
+
+  if (!config.anthropic.apiKey)  errors.push("ANTHROPIC_API_KEY is required");
+  if (!config.kickload.apiToken) errors.push("KICKLOAD_API_TOKEN is required");
+  if (!config.email.fromAddress) errors.push("EMAIL_FROM_ADDRESS is required");
+
+  if (config.email.provider === "smtp") {
+    if (!config.email.smtp.user) errors.push("SMTP_USER is required for smtp provider");
+    if (!config.email.smtp.pass) errors.push("SMTP_PASS is required for smtp provider");
+  }
+
+  if (config.email.provider === "sendgrid" && !config.email.sendgrid.apiKey) {
+    errors.push("SENDGRID_API_KEY is required when EMAIL_PROVIDER=sendgrid");
+  }
+
+  // ngrok token is a warning, not a hard error — auto-mode handles it gracefully
+  if (!config.ngrok.authToken) {
+    warnings.push("NGROK_AUTHTOKEN not set — ngrok tunnel will not authenticate (localhost backends cannot be tested)");
+  }
+
+  if (warnings.length) {
+    warnings.forEach(w => console.warn(`  ⚠️  ${w}`));
+  }
+
+  if (errors.length) {
+    console.error("\n❌ Missing required configuration:");
+    errors.forEach(e => console.error(`   • ${e}`));
+    console.error("\n   Fix: delete .env and re-run to go through setup again, or edit .env manually.\n");
+    process.exit(1);
+  }
+}

package/email-sender.js

@@ -1,137 +1,137 @@
-import nodemailer from "nodemailer";
-import { config }  from "./config.js";
-
-let transporter = null;
-
-export function _getTransporter() { return transporter; }
-
-/**
- * Initialize email transporter.
- * Does NOT verify — call verifyEmailService() for startup check.
- */
-export function initEmailSender() {
-  const p = config.email.provider;
-
-  if (p === "smtp") {
-    transporter = nodemailer.createTransport({
-      host:   config.email.smtp.host,
-      port:   config.email.smtp.port,
-      secure: config.email.smtp.port === 465,
-      auth:   { user: config.email.smtp.user, pass: config.email.smtp.pass },
-    });
-  } else if (p === "sendgrid") {
-    transporter = nodemailer.createTransport({
-      host: "smtp.sendgrid.net", port: 587,
-      auth: { user: "apikey", pass: config.email.sendgrid.apiKey },
-    });
-  } else if (p === "ses") {
-    transporter = nodemailer.createTransport({
-      host:   `email-smtp.${config.email.ses.region}.amazonaws.com`,
-      port:   587, secure: false,
-      auth:   { user: config.email.ses.accessKey, pass: config.email.ses.secretKey },
-    });
-  } else {
-    throw new Error(`Unknown email provider: ${p}`);
-  }
-}
-
-/**
- * PROBLEM 2 — Email strict mode.
- * Verifies the transporter can authenticate.
- * Exits process if verification fails.
- */
-export async function verifyEmailService() {
-  if (!transporter) {
-    console.error("\n❌ Email transporter not initialized before verify()");
-    process.exit(1);
-  }
-
-  process.stdout.write("   Verifying email service... ");
-  try {
-    await transporter.verify();
-    console.log("✅ Email service verified");
-  } catch (err) {
-    console.log(""); // newline after the "..."
-    console.error("\n❌ Email verification failed — cannot start.");
-    console.error(`   Provider : ${config.email.provider}`);
-    console.error(`   User     : ${config.email.smtp.user || "(none)"}`);
-    console.error(`   Error    : ${err.message}`);
-    console.error("\n   Fix: check SMTP_USER / SMTP_PASS in .env");
-    console.error("   For Gmail, use an App Password: myaccount.google.com/apppasswords\n");
-    process.exit(1);
-  }
-}
-
-export async function sendResultEmail({ toEmail, endpoint, passed, summary, downloadUrl, pdfFilename, durationMs, testPrompt }) {
-  if (!transporter) throw new Error("Email sender not initialized");
-
-  const status       = passed ? "✅ PASS" : "❌ FAIL";
-  const statusColor  = passed ? "#16a34a" : "#dc2626";
-  const statusBg     = passed ? "#f0fdf4" : "#fef2f2";
-  const statusBorder = passed ? "#86efac" : "#fca5a5";
-  const durationSec  = durationMs ? Math.round(durationMs / 1000) : null;
-  const testedAt     = new Date().toLocaleString("en-IN", { timeZone: "Asia/Kolkata", dateStyle: "medium", timeStyle: "short" });
-  const subject      = `[KickLoad Watcher] ${status} — ${endpoint}`;
-
-  const rows = [
-    ["Endpoint",   `<span style="font-family:monospace">${endpoint}</span>`],
-    ["Tested At",  `${testedAt} IST`],
-    summary?.averageLatency  != null ? ["Latency",    `${summary.averageLatency}ms`]                    : null,
-    summary?.errorPercentage != null ? ["Error Rate", `${summary.errorPercentage}%`]                   : null,
-    summary?.throughput      != null ? ["Throughput", `${summary.throughput?.toLocaleString()} req/s`] : null,
-    durationSec              != null ? ["Duration",   `${durationSec}s`]                               : null,
-  ].filter(Boolean).map(([label, value]) =>
-    `<tr style="border-bottom:1px solid #f3f4f6;">
-      <td style="padding:8px 16px;color:#6b7280;font-size:14px;">${label}</td>
-      <td style="padding:8px 16px;color:#111827;font-size:14px;font-weight:600;text-align:right;">${value}</td>
-    </tr>`
-  ).join("");
-
-  const downloadBtn = downloadUrl
-    ? `<a href="${downloadUrl}" style="display:inline-block;background:#f47c20;color:#fff;text-decoration:none;padding:12px 28px;border-radius:8px;font-weight:700;font-size:14px;">Download Report</a>
-       <p style="color:#9ca3af;font-size:12px;margin-top:8px;">${pdfFilename || ""} · expires in 24hrs</p>`
-    : `<p style="color:#9ca3af;font-size:13px;">Report available in KickLoad dashboard.</p>`;
-
-  const html = `<!DOCTYPE html><html><body style="margin:0;padding:0;background:#f9fafb;font-family:Inter,Arial,sans-serif;">
-<table width="100%" cellpadding="0" cellspacing="0" style="padding:40px 20px;"><tr><td align="center">
-<table width="560" cellpadding="0" cellspacing="0" style="background:#fff;border-radius:12px;overflow:hidden;box-shadow:0 1px 3px rgba(0,0,0,0.1);">
-<tr><td style="background:linear-gradient(135deg,#1e202a,#303952);padding:28px 32px;">
-  <h1 style="margin:0;color:#fff;font-size:22px;font-weight:800;">KickLoad Watcher</h1>
-  <p style="margin:4px 0 0;color:#9ca3af;font-size:13px;">OneQA — Automated API Testing</p>
-</td></tr>
-<tr><td style="padding:28px 32px 0;">
-  <div style="background:${statusBg};border:1px solid ${statusBorder};border-radius:10px;padding:16px 20px;">
-    <div style="font-size:20px;font-weight:800;color:${statusColor};">${status}</div>
-    <div style="font-size:13px;color:#6b7280;margin-top:2px;font-family:monospace;">${endpoint}</div>
-  </div>
-</td></tr>
-<tr><td style="padding:20px 32px 0;">
-  <table width="100%" cellpadding="0" cellspacing="0" style="border:1px solid #e5e7eb;border-radius:8px;overflow:hidden;">
-    <tr style="background:#f9fafb;"><td colspan="2" style="padding:10px 16px;font-size:12px;font-weight:700;color:#9ca3af;text-transform:uppercase;border-bottom:1px solid #e5e7eb;">Test Details</td></tr>
-    ${rows}
-  </table>
-</td></tr>
-<tr><td style="padding:24px 32px;text-align:center;">${downloadBtn}</td></tr>
-<tr><td style="padding:20px 32px;border-top:1px solid #f3f4f6;">
-  <p style="margin:0;color:#9ca3af;font-size:12px;text-align:center;">
-    KickLoad Watcher · <a href="https://kickload.neeyatai.com" style="color:#f47c20;text-decoration:none;">NeeyatAI</a>
-  </p>
-</td></tr>
-</table></td></tr></table></body></html>`;
-
-  const text =
-    `KickLoad Watcher — ${status}\nEndpoint: ${endpoint}\nTested: ${testedAt} IST\n` +
-    (summary?.averageLatency  != null ? `Latency: ${summary.averageLatency}ms\n`    : "") +
-    (summary?.errorPercentage != null ? `Errors: ${summary.errorPercentage}%\n`     : "") +
-    (summary?.throughput      != null ? `Throughput: ${summary.throughput} req/s\n` : "") +
-    (durationSec              != null ? `Duration: ${durationSec}s\n`               : "") +
-    (downloadUrl              ? `\nReport: ${downloadUrl}\n`                        : "") +
-    `\n— KickLoad Watcher`;
-
-  const info = await transporter.sendMail({
-    from: `"${config.email.fromName}" <${config.email.fromAddress}>`,
-    to: toEmail, subject, html, text,
-  });
-
-  console.log(`📧 Email sent → ${toEmail} (${info.messageId})`);
-}
+import nodemailer from "nodemailer";
+import { config }  from "./config.js";
+
+let transporter = null;
+
+export function _getTransporter() { return transporter; }
+
+/**
+ * Initialize email transporter.
+ * Does NOT verify — call verifyEmailService() for startup check.
+ */
+export function initEmailSender() {
+  const p = config.email.provider;
+
+  if (p === "smtp") {
+    transporter = nodemailer.createTransport({
+      host:   config.email.smtp.host,
+      port:   config.email.smtp.port,
+      secure: config.email.smtp.port === 465,
+      auth:   { user: config.email.smtp.user, pass: config.email.smtp.pass },
+    });
+  } else if (p === "sendgrid") {
+    transporter = nodemailer.createTransport({
+      host: "smtp.sendgrid.net", port: 587,
+      auth: { user: "apikey", pass: config.email.sendgrid.apiKey },
+    });
+  } else if (p === "ses") {
+    transporter = nodemailer.createTransport({
+      host:   `email-smtp.${config.email.ses.region}.amazonaws.com`,
+      port:   587, secure: false,
+      auth:   { user: config.email.ses.accessKey, pass: config.email.ses.secretKey },
+    });
+  } else {
+    throw new Error(`Unknown email provider: ${p}`);
+  }
+}
+
+/**
+ * PROBLEM 2 — Email strict mode.
+ * Verifies the transporter can authenticate.
+ * Exits process if verification fails.
+ */
+export async function verifyEmailService() {
+  if (!transporter) {
+    console.error("\n❌ Email transporter not initialized before verify()");
+    process.exit(1);
+  }
+
+  process.stdout.write("   Verifying email service... ");
+  try {
+    await transporter.verify();
+    console.log("✅ Email service verified");
+  } catch (err) {
+    console.log(""); // newline after the "..."
+    console.error("\n❌ Email verification failed — cannot start.");
+    console.error(`   Provider : ${config.email.provider}`);
+    console.error(`   User     : ${config.email.smtp.user || "(none)"}`);
+    console.error(`   Error    : ${err.message}`);
+    console.error("\n   Fix: check SMTP_USER / SMTP_PASS in .env");
+    console.error("   For Gmail, use an App Password: myaccount.google.com/apppasswords\n");
+    process.exit(1);
+  }
+}
+
+export async function sendResultEmail({ toEmail, endpoint, passed, summary, downloadUrl, pdfFilename, durationMs, testPrompt }) {
+  if (!transporter) throw new Error("Email sender not initialized");
+
+  const status       = passed ? "✅ PASS" : "❌ FAIL";
+  const statusColor  = passed ? "#16a34a" : "#dc2626";
+  const statusBg     = passed ? "#f0fdf4" : "#fef2f2";
+  const statusBorder = passed ? "#86efac" : "#fca5a5";
+  const durationSec  = durationMs ? Math.round(durationMs / 1000) : null;
+  const testedAt     = new Date().toLocaleString("en-IN", { timeZone: "Asia/Kolkata", dateStyle: "medium", timeStyle: "short" });
+  const subject      = `[KickLoad Watcher] ${status} — ${endpoint}`;
+
+  const rows = [
+    ["Endpoint",   `<span style="font-family:monospace">${endpoint}</span>`],
+    ["Tested At",  `${testedAt} IST`],
+    summary?.averageLatency  != null ? ["Latency",    `${summary.averageLatency}ms`]                    : null,
+    summary?.errorPercentage != null ? ["Error Rate", `${summary.errorPercentage}%`]                   : null,
+    summary?.throughput      != null ? ["Throughput", `${summary.throughput?.toLocaleString()} req/s`] : null,
+    durationSec              != null ? ["Duration",   `${durationSec}s`]                               : null,
+  ].filter(Boolean).map(([label, value]) =>
+    `<tr style="border-bottom:1px solid #f3f4f6;">
+      <td style="padding:8px 16px;color:#6b7280;font-size:14px;">${label}</td>
+      <td style="padding:8px 16px;color:#111827;font-size:14px;font-weight:600;text-align:right;">${value}</td>
+    </tr>`
+  ).join("");
+
+  const downloadBtn = downloadUrl
+    ? `<a href="${downloadUrl}" style="display:inline-block;background:#f47c20;color:#fff;text-decoration:none;padding:12px 28px;border-radius:8px;font-weight:700;font-size:14px;">Download Report</a>
+       <p style="color:#9ca3af;font-size:12px;margin-top:8px;">${pdfFilename || ""} · expires in 24hrs</p>`
+    : `<p style="color:#9ca3af;font-size:13px;">Report available in KickLoad dashboard.</p>`;
+
+  const html = `<!DOCTYPE html><html><body style="margin:0;padding:0;background:#f9fafb;font-family:Inter,Arial,sans-serif;">
+<table width="100%" cellpadding="0" cellspacing="0" style="padding:40px 20px;"><tr><td align="center">
+<table width="560" cellpadding="0" cellspacing="0" style="background:#fff;border-radius:12px;overflow:hidden;box-shadow:0 1px 3px rgba(0,0,0,0.1);">
+<tr><td style="background:linear-gradient(135deg,#1e202a,#303952);padding:28px 32px;">
+  <h1 style="margin:0;color:#fff;font-size:22px;font-weight:800;">KickLoad Watcher</h1>
+  <p style="margin:4px 0 0;color:#9ca3af;font-size:13px;">OneQA — Automated API Testing</p>
+</td></tr>
+<tr><td style="padding:28px 32px 0;">
+  <div style="background:${statusBg};border:1px solid ${statusBorder};border-radius:10px;padding:16px 20px;">
+    <div style="font-size:20px;font-weight:800;color:${statusColor};">${status}</div>
+    <div style="font-size:13px;color:#6b7280;margin-top:2px;font-family:monospace;">${endpoint}</div>
+  </div>
+</td></tr>
+<tr><td style="padding:20px 32px 0;">
+  <table width="100%" cellpadding="0" cellspacing="0" style="border:1px solid #e5e7eb;border-radius:8px;overflow:hidden;">
+    <tr style="background:#f9fafb;"><td colspan="2" style="padding:10px 16px;font-size:12px;font-weight:700;color:#9ca3af;text-transform:uppercase;border-bottom:1px solid #e5e7eb;">Test Details</td></tr>
+    ${rows}
+  </table>
+</td></tr>
+<tr><td style="padding:24px 32px;text-align:center;">${downloadBtn}</td></tr>
+<tr><td style="padding:20px 32px;border-top:1px solid #f3f4f6;">
+  <p style="margin:0;color:#9ca3af;font-size:12px;text-align:center;">
+    KickLoad Watcher · <a href="https://kickload.neeyatai.com" style="color:#f47c20;text-decoration:none;">NeeyatAI</a>
+  </p>
+</td></tr>
+</table></td></tr></table></body></html>`;
+
+  const text =
+    `KickLoad Watcher — ${status}\nEndpoint: ${endpoint}\nTested: ${testedAt} IST\n` +
+    (summary?.averageLatency  != null ? `Latency: ${summary.averageLatency}ms\n`    : "") +
+    (summary?.errorPercentage != null ? `Errors: ${summary.errorPercentage}%\n`     : "") +
+    (summary?.throughput      != null ? `Throughput: ${summary.throughput} req/s\n` : "") +
+    (durationSec              != null ? `Duration: ${durationSec}s\n`               : "") +
+    (downloadUrl              ? `\nReport: ${downloadUrl}\n`                        : "") +
+    `\n— KickLoad Watcher`;
+
+  const info = await transporter.sendMail({
+    from: `"${config.email.fromName}" <${config.email.fromAddress}>`,
+    to: toEmail, subject, html, text,
+  });
+
+  console.log(`📧 Email sent → ${toEmail} (${info.messageId})`);
+}