kickload-watcher-mcp 0.1.0

package/email-sender.js

@@ -0,0 +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})`);
+}

package/env-check.js

@@ -0,0 +1,117 @@
+import { execSync } from "child_process";
+import fs           from "fs";
+import path         from "path";
+import readline     from "readline";
+
+const MIN_NODE_MAJOR = 18;
+
+export async function runStartupChecks() {
+  checkNodeVersion();
+  await ensureEnvFile();
+}
+
+function checkNodeVersion() {
+  const major = parseInt(process.versions.node.split(".")[0]);
+  if (major < MIN_NODE_MAJOR) {
+    console.error(`\nNode.js ${MIN_NODE_MAJOR}+ required. You have ${process.versions.node}.`);
+    console.error(`Download: https://nodejs.org\n`);
+    process.exit(1);
+  }
+}
+
+export function checkNgrokInstalled() {
+  try {
+    execSync("ngrok version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function printNgrokInstallGuide() {
+  console.error("\nngrok is not installed or not in PATH.");
+  console.error("Install it from: https://ngrok.com/download");
+  console.error("Then add your authtoken: ngrok config add-authtoken <token>");
+  console.error("Get your token at: https://dashboard.ngrok.com\n");
+}
+
+async function ensureEnvFile() {
+  const envPath = path.resolve(".env");
+
+  if (fs.existsSync(envPath)) return;
+
+  console.log("\nNo .env file found. Running first-time setup...\n");
+
+  const anthropicKey = await askMasked("Enter ANTHROPIC_API_KEY: ");
+
+  if (!anthropicKey) {
+    console.error("ANTHROPIC_API_KEY is required.");
+    process.exit(1);
+  }
+
+  const lines = [
+    `ANTHROPIC_API_KEY=${anthropicKey}`,
+    `KICKLOAD_API_TOKEN=`,
+    `KICKLOAD_BASE_URL=https://kickload.neeyatai.com/api`,
+    ``,
+    `NGROK_ENABLED=false`,
+    `NGROK_AUTHTOKEN=`,
+    ``,
+    `EMAIL_PROVIDER=smtp`,
+    `EMAIL_FROM_NAME=KickLoad Watcher`,
+    `EMAIL_FROM_ADDRESS=`,
+    `SMTP_HOST=smtp.gmail.com`,
+    `SMTP_PORT=465`,
+    `SMTP_USER=`,
+    `SMTP_PASS=`,
+    ``,
+    `WATCH_PATHS=.`,
+    `TRIGGER_MODE=claudecode`,
+    `DEFAULT_DEVELOPER_EMAIL=`,
+    `LOG_LEVEL=info`,
+  ];
+
+  fs.writeFileSync(envPath, lines.join("\n") + "\n", "utf-8");
+  console.log(".env created. Fill in KICKLOAD_API_TOKEN and email settings, then run again.\n");
+  process.exit(0);
+}
+
+function askMasked(prompt) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    process.stdout.write(prompt);
+
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.setEncoding("utf8");
+      let value = "";
+
+      process.stdin.on("data", function handler(char) {
+        char = char.toString();
+        if (char === "\r" || char === "\n") {
+          process.stdin.setRawMode(false);
+          process.stdin.removeListener("data", handler);
+          process.stdout.write("\n");
+          rl.close();
+          resolve(value.trim());
+        } else if (char === "\u0003") {
+          process.stdout.write("\n");
+          process.exit(0);
+        } else if (char === "\u007F" || char === "\b") {
+          if (value.length > 0) {
+            value = value.slice(0, -1);
+            process.stdout.clearLine(0);
+            process.stdout.cursorTo(0);
+            process.stdout.write(prompt + "*".repeat(value.length));
+          }
+        } else {
+          value += char;
+          process.stdout.write("*");
+        }
+      });
+    } else {
+      rl.question("", (answer) => { rl.close(); resolve(answer.trim()); });
+    }
+  });
+}

package/file-watcher.js

@@ -0,0 +1,230 @@
+import chokidar from "chokidar";
+import fs        from "fs";
+import path      from "path";
+import { config }       from "./config.js";
+import { createLogger } from "./logger.js";
+
+const logger      = createLogger("file-watcher");
+const DEBOUNCE_MS = 3000;
+
+const apiFileCallbacks = [];
+const debounceTimers   = new Map();
+
+export function onNewApiFile(callback) {
+  apiFileCallbacks.push(callback);
+}
+
+export function startFileWatcher() {
+  const watchPaths = config.watcher.watchPaths.filter(p => {
+    if (!fs.existsSync(p)) {
+      logger.warn(`Watch path does not exist: ${p}`);
+      return false;
+    }
+    return true;
+  });
+
+  if (watchPaths.length === 0) {
+    logger.warn("No valid watch paths. Set WATCH_PATHS in .env");
+    return null;
+  }
+
+  const watcher = chokidar.watch(watchPaths, {
+    ignored:          buildIgnorePatterns(),
+    persistent:       true,
+    ignoreInitial:    true,
+    awaitWriteFinish: { stabilityThreshold: 500, pollInterval: 100 },
+  });
+
+  watcher
+    .on("add",    fp => scheduleCheck(fp, "created"))
+    .on("change", fp => scheduleCheck(fp, "modified"))
+    .on("error",  err => logger.error(`Watcher error: ${err.message}`))
+    .on("ready",  () => {
+      logger.info(`File watcher active on ${watchPaths.length} path(s):`);
+      watchPaths.forEach(p => logger.info(`  ${p}`));
+      logger.info("Watching for backend API file changes...");
+    });
+
+  return watcher;
+}
+
+function scheduleCheck(filePath, eventType) {
+  // PROBLEM 3 — Smart filter: extension check first (cheap)
+  if (!isAllowedExtension(filePath)) return;
+  // Then path-based ignores
+  if (isIgnoredPath(filePath))       return;
+  // Then test file check
+  if (isTestFile(filePath))          return;
+
+  if (debounceTimers.has(filePath)) clearTimeout(debounceTimers.get(filePath));
+
+  const timer = setTimeout(() => {
+    debounceTimers.delete(filePath);
+    processStableFile(filePath, eventType);
+  }, DEBOUNCE_MS);
+
+  debounceTimers.set(filePath, timer);
+}
+
+function processStableFile(filePath, eventType) {
+  let content;
+  try {
+    content = fs.readFileSync(filePath, "utf-8");
+  } catch (err) {
+    if (err.code !== "ENOENT") logger.error(`Cannot read ${filePath}: ${err.message}`);
+    return;
+  }
+
+  // PROBLEM 3 — Reject frontend code
+  if (isFrontendCode(content)) {
+    logger.debug(`Skipping frontend file: ${path.basename(filePath)}`);
+    return;
+  }
+
+  // PROBLEM 3 — Must contain backend route patterns
+  if (!containsBackendRoutes(content)) {
+    logger.debug(`No API patterns in: ${path.basename(filePath)}`);
+    return;
+  }
+
+  // PROBLEM 3 — Extract endpoints; skip if none found
+  const endpoints = extractAllEndpoints(content);
+  if (endpoints.length === 0) {
+    logger.debug(`No extractable endpoints in: ${path.basename(filePath)}`);
+    return;
+  }
+
+  logger.info(`Backend API file detected: ${path.basename(filePath)} [${eventType}]`);
+  logger.info(`Endpoints found (${endpoints.length}): ${endpoints.join(", ")}`);
+
+  const event = {
+    filePath,
+    fileName:          path.basename(filePath),
+    fileContent:       content,
+    detectedEndpoints: endpoints,
+    timestamp:         new Date().toISOString(),
+    eventType,
+    source:            "file_watcher",
+    userId:            process.env.DEFAULT_USER_ID || null,
+  };
+
+  for (const cb of apiFileCallbacks) {
+    cb(event).catch(err => logger.error(`Callback error: ${err.message}`));
+  }
+}
+
+// ── PROBLEM 3: Filter helpers ─────────────────────────────────────────────────
+
+/**
+ * Allow only backend-relevant file extensions.
+ */
+function isAllowedExtension(filePath) {
+  const ALLOWED = new Set([".js", ".ts", ".py", ".go", ".java", ".rb", ".php", ".cs", ".rs"]);
+  return ALLOWED.has(path.extname(filePath).toLowerCase());
+}
+
+/**
+ * Ignore common non-backend directories.
+ */
+function isIgnoredPath(filePath) {
+  const IGNORED = new Set([
+    "node_modules", "frontend", "client", "public", "static",
+    "assets", "dist", "build", "out", ".next", ".nuxt", ".vite",
+    "coverage", "__pycache__", ".git", "venv", ".venv", "env",
+  ]);
+  return filePath.replace(/\\/g, "/").split("/").some(s => IGNORED.has(s.toLowerCase()));
+}
+
+function containsBackendRoutes(content) {
+  if (isFrontendCode(content)) return false;
+  return BACKEND_ROUTE_PATTERNS.some(p => { p.lastIndex = 0; return p.test(content); });
+}
+
+function isFrontendCode(content) {
+  return [
+    /from\s+['"]react['"]/i, /from\s+['"]vue['"]/i, /from\s+['"]@angular/i,
+    /import\s+React/i, /createApp\s*\(/, /ReactDOM\.render/,
+    /useState\s*\(/, /useEffect\s*\(/, /JSX\.Element/,
+    /<\s*[A-Z][A-Za-z]+\s*\//, /export\s+default\s+function\s+[A-Z]/,
+    /className\s*=/, /getElementById\s*\(/, /querySelector\s*\(/,
+    /addEventListener\s*\(/, /axios\.(get|post|put|delete|patch)\s*\(/i,
+    /fetch\s*\(\s*['"`]\/api/i,
+  ].some(p => p.test(content));
+}
+
+const BACKEND_ROUTE_PATTERNS = [
+  /\bapp\.(get|post|put|patch|delete|use)\s*\(\s*['"`]/i,
+  /\brouter\.(get|post|put|patch|delete|use)\s*\(\s*['"`]/i,
+  /\bfastify\.(get|post|put|patch|delete)\s*\(\s*['"`]/i,
+  /\bserver\.(get|post|put|patch|delete)\s*\(\s*['"`]/i,
+  /@(app|bp|blueprint|router|api)\.(route|get|post|put|patch|delete)\s*\(\s*['"`]/i,
+  /add_url_rule\s*\(\s*['"`]/i,
+  /path\s*\(\s*['"`][^'"`]*['"`]\s*,\s*\w/,
+  /re_path\s*\(\s*['"`]/i,
+  /\br\.(GET|POST|PUT|PATCH|DELETE)\s*\(\s*['"`]/,
+  /\be\.(GET|POST|PUT|PATCH|DELETE)\s*\(\s*['"`]/,
+  /http\.HandleFunc\s*\(\s*['"`]/, /\.HandleFunc\s*\(\s*['"`]/,
+  /@(GetMapping|PostMapping|PutMapping|DeleteMapping|PatchMapping|RequestMapping)\s*\(/i,
+  /\bresources\s+:/,
+  /\bget\s+['"`][^'"]+['"`]\s*,\s*to:/, /\bpost\s+['"`][^'"]+['"`]\s*,\s*to:/,
+  /\[Http(Get|Post|Put|Delete|Patch)\]/i,
+  /MapGet\s*\(\s*['"`]/i, /MapPost\s*\(\s*['"`]/i,
+];
+
+function extractAllEndpoints(content) {
+  const endpoints = new Set();
+  let m;
+
+  for (const pattern of [
+    /(?:app|router|fastify|server)\s*\.\s*(?:get|post|put|patch|delete|use)\s*\(\s*(['"`])(\/[^'"`\s,)]*)\1/gi,
+    /@(?:app|bp|blueprint|router|api)\s*\.\s*(?:route|get|post|put|patch|delete)\s*\(\s*(['"`])(\/[^'"`\s,)]*)\1/gi,
+    /(?:r|e|router)\s*\.\s*(?:GET|POST|PUT|PATCH|DELETE)\s*\(\s*(['"`])(\/[^'"`\s,)]*)\1/g,
+    /\.HandleFunc\s*\(\s*(['"`])(\/[^'"`\s,)]*)\1/g,
+    /@(?:GetMapping|PostMapping|PutMapping|DeleteMapping|PatchMapping|RequestMapping)\s*\(\s*(?:value\s*=\s*)?(['"`])(\/[^'"`\s,)]*)\1/gi,
+    /Map(?:Get|Post|Put|Delete|Patch)\s*\(\s*(['"`])(\/[^'"`\s,)]*)\1/gi,
+  ]) {
+    pattern.lastIndex = 0;
+    while ((m = pattern.exec(content)) !== null) {
+      const ep = m[2];
+      if (isValidEndpoint(ep)) endpoints.add(ep);
+    }
+  }
+
+  // Django path()
+  const djangoPattern = /(?:re_)?path\s*\(\s*r?(['"`])([^'"`]+)\1\s*,/gi;
+  djangoPattern.lastIndex = 0;
+  while ((m = djangoPattern.exec(content)) !== null) {
+    const raw = m[2].replace(/\^|\$|\?P<[^>]+>/g, "");
+    const ep  = raw.startsWith("/") ? raw : `/${raw}`;
+    if (isValidEndpoint(ep)) endpoints.add(ep);
+  }
+
+  return [...endpoints];
+}
+
+function isValidEndpoint(ep) {
+  if (!ep || !ep.startsWith("/")) return false;
+  if (ep.length < 2 || ep.includes(" ")) return false;
+  if (ep === "/*" || ep === "/**")        return false;
+  return true;
+}
+
+function isTestFile(filePath) {
+  const name = path.basename(filePath).toLowerCase();
+  return (
+    name.includes(".test.")  || name.includes(".spec.")  ||
+    name.startsWith("test_") || name.endsWith("_test.js") ||
+    /\/(tests?|__tests?__|spec)\//i.test(filePath)
+  );
+}
+
+function buildIgnorePatterns() {
+  return [
+    "**/node_modules/**", "**/.git/**", "**/dist/**", "**/build/**",
+    "**/out/**", "**/.next/**", "**/.nuxt/**", "**/.vite/**",
+    "**/coverage/**", "**/__pycache__/**", "**/venv/**", "**/.venv/**",
+    "**/public/**", "**/static/**", "**/assets/**",
+    "**/frontend/**", "**/client/**",
+    ...(config.watcher.ignore || []),
+  ];
+}