@emailens/cli 0.1.0 → 0.3.0

package/README.md

@@ -48,6 +48,32 @@ emailens export email.html --json -o ./report
 emailens export email.html --dark-mode --screenshots -o ./report
 ```
 
+### `emailens fix <file>`
+
+Generate AI-powered fixes for email compatibility issues. Uses `@emailens/engine` analysis to build a structured prompt, then calls Claude to fix structural issues (table layouts, VML, MSO conditionals) that static snippets can't handle.
+
+Requires `ANTHROPIC_API_KEY` environment variable and the optional `@anthropic-ai/sdk` dependency.
+
+```bash
+emailens fix email.html                           # Fix and print to stdout
+emailens fix email.html -o fixed.html             # Write to file
+emailens fix email.html --estimate                 # Show token estimate only (no AI call)
+emailens fix email.html --clients outlook-windows  # Scope to one client
+emailens fix email.html --json                     # Full JSON output with metadata
+emailens fix email.html --max-tokens 8000          # Limit prompt size
+cat email.html | emailens fix - --format jsx       # Pipe from stdin
+```
+
+| Flag | Alias | Description |
+|------|-------|-------------|
+| `--format` | `-f` | Input format: `html`, `jsx`, `mjml`, `maizzle` |
+| `--clients` | `-c` | Comma-separated client IDs to scope the fix |
+| `--output` | `-o` | Write fixed code to file instead of stdout |
+| `--json` | | Output as JSON (includes token estimates and metadata) |
+| `--quiet` | `-q` | Suppress spinners and decorations |
+| `--estimate` | | Only show token estimate without calling the AI |
+| `--max-tokens` | | Maximum input tokens for the prompt (default: 16000) |
+
 ### `emailens clients`
 
 List all 12 supported email clients.
@@ -76,6 +102,24 @@ Preview and export add:
 | `--screenshots` | | Capture screenshots (requires `BROWSERLESS_URL`) |
 | `--out` | `-o` | Output directory |
 
+## AI Fixes
+
+The `fix` command requires an `ANTHROPIC_API_KEY` environment variable and the `@anthropic-ai/sdk` package:
+
+```bash
+npm install @anthropic-ai/sdk
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+Use `--estimate` to check token usage before making an API call:
+
+```bash
+emailens fix email.html --estimate
+#   Input tokens:    ~4,200
+#   Output tokens:   ~5,400
+#   Warnings:        23 (5 structural)
+```
+
 ## Framework Support
 
 The CLI can compile React Email (JSX/TSX), MJML, and Maizzle templates to HTML before analysis. Format is auto-detected from file extension, or specify with `--format`.

package/dist/index.js

@@ -1,39 +1,22 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { defineCommand as defineCommand5, runMain } from "citty";
+import { defineCommand as defineCommand7, runMain } from "citty";
 
 // src/commands/analyze.ts
 import { defineCommand } from "citty";
 import ora from "ora";
 import {
   analyzeEmail,
-  generateCompatibilityScore
+  generateCompatibilityScore,
+  warningsForClient,
+  CompileError
 } from "@emailens/engine";
 
 // src/utils.ts
 import { readFileSync } from "fs";
 import { EMAIL_CLIENTS } from "@emailens/engine";
-
-// src/compile/detect.ts
-import { extname } from "path";
-function detectFormat(filePath) {
-  const ext = extname(filePath).toLowerCase();
-  switch (ext) {
-    case ".tsx":
-    case ".jsx":
-      return "jsx";
-    case ".mjml":
-      return "mjml";
-    case ".html":
-    case ".htm":
-      return "html";
-    default:
-      return "html";
-  }
-}
-
-// src/utils.ts
+import { detectFormat } from "@emailens/engine/compile";
 var VALID_FORMATS = /* @__PURE__ */ new Set(["html", "jsx", "mjml", "maizzle"]);
 async function readInput(pathOrStdin) {
   if (pathOrStdin === "-") {
@@ -99,27 +82,8 @@ function toFramework(format) {
   return void 0;
 }
 
-// src/compile/index.ts
-async function compile(source, format, _filePath) {
-  switch (format) {
-    case "html":
-      return source;
-    case "jsx": {
-      const { compileReactEmail } = await import("./react-email-ZWLGXROP.js");
-      return compileReactEmail(source);
-    }
-    case "mjml": {
-      const { compileMjml } = await import("./mjml-KG66APFB.js");
-      return compileMjml(source);
-    }
-    case "maizzle": {
-      const { compileMaizzle } = await import("./maizzle-JGKTYDDO.js");
-      return compileMaizzle(source);
-    }
-    default:
-      throw new Error(`Unknown format: "${format}". Use html, jsx, mjml, or maizzle.`);
-  }
-}
+// src/commands/analyze.ts
+import { compile } from "@emailens/engine/compile";
 
 // src/output/terminal.ts
 import pc from "picocolors";
@@ -315,7 +279,7 @@ var analyze_default = defineCommand({
           scores[id] = data;
         }
       }
-      const filteredWarnings = warnings.filter((w) => clientSet.has(w.client));
+      const filteredWarnings = clientIds.flatMap((id) => warningsForClient(warnings, id));
       spinner?.succeed("Analysis complete");
       if (args.json) {
         printJson({ scores, warnings: filteredWarnings });
@@ -324,7 +288,11 @@ var analyze_default = defineCommand({
         printWarnings(filteredWarnings, { quiet: args.quiet });
       }
     } catch (err) {
-      spinner?.fail(err.message);
+      if (err instanceof CompileError) {
+        spinner?.fail(`Compilation failed (${err.phase}): ${err.message}`);
+      } else {
+        spinner?.fail(err.message);
+      }
       process.exit(1);
     }
   }
@@ -337,8 +305,11 @@ import {
   transformForAllClients,
   analyzeEmail as analyzeEmail2,
   generateCompatibilityScore as generateCompatibilityScore2,
-  simulateDarkMode
+  simulateDarkMode,
+  warningsForClient as warningsForClient2,
+  CompileError as CompileError2
 } from "@emailens/engine";
+import { compile as compile2 } from "@emailens/engine/compile";
 var preview_default = defineCommand2({
   meta: {
     name: "preview",
@@ -391,7 +362,7 @@ var preview_default = defineCommand2({
       spinner?.start("Reading input...");
       const source = await readInput(args.input);
       spinner?.succeed("Input read");
-      const html = await compile(source, format, args.input !== "-" ? args.input : void 0);
+      const html = await compile2(source, format, args.input !== "-" ? args.input : void 0);
       const clientIds = resolveClients(args.clients);
       const clientSet = new Set(clientIds);
       spinner?.start("Transforming for all clients...");
@@ -408,7 +379,7 @@ var preview_default = defineCommand2({
           scores[id] = data;
         }
       }
-      const filteredWarnings = warnings.filter((w) => clientSet.has(w.client));
+      const filteredWarnings = clientIds.flatMap((id) => warningsForClient2(warnings, id));
       spinner?.succeed("Analysis complete");
       let darkMode;
       if (args["dark-mode"]) {
@@ -443,7 +414,11 @@ var preview_default = defineCommand2({
         printWarnings(filteredWarnings, { quiet: args.quiet });
       }
     } catch (err) {
-      spinner?.fail(err.message);
+      if (err instanceof CompileError2) {
+        spinner?.fail(`Compilation failed (${err.phase}): ${err.message}`);
+      } else {
+        spinner?.fail(err.message);
+      }
       process.exit(1);
     }
   }
@@ -515,8 +490,11 @@ import {
   transformForAllClients as transformForAllClients2,
   analyzeEmail as analyzeEmail3,
   generateCompatibilityScore as generateCompatibilityScore3,
-  simulateDarkMode as simulateDarkMode2
+  simulateDarkMode as simulateDarkMode2,
+  warningsForClient as warningsForClient3,
+  CompileError as CompileError3
 } from "@emailens/engine";
+import { compile as compile3 } from "@emailens/engine/compile";
 
 // src/output/html-report.ts
 import { EMAIL_CLIENTS as EMAIL_CLIENTS4 } from "@emailens/engine";
@@ -641,7 +619,7 @@ var export_default = defineCommand4({
       spinner?.start("Reading input...");
       const source = await readInput(args.input);
       spinner?.succeed("Input read");
-      const html = await compile(source, format, args.input !== "-" ? args.input : void 0);
+      const html = await compile3(source, format, args.input !== "-" ? args.input : void 0);
       const clientIds = resolveClients(args.clients);
       const clientSet = new Set(clientIds);
       spinner?.start("Transforming for all clients...");
@@ -658,7 +636,7 @@ var export_default = defineCommand4({
           scores[id] = data;
         }
       }
-      const filteredWarnings = warnings.filter((w) => clientSet.has(w.client));
+      const filteredWarnings = clientIds.flatMap((id) => warningsForClient3(warnings, id));
       spinner?.succeed("Analysis complete");
       let darkMode;
       if (args["dark-mode"]) {
@@ -712,24 +690,341 @@ var export_default = defineCommand4({
         console.log();
       }
     } catch (err) {
-      spinner?.fail(err.message);
+      if (err instanceof CompileError3) {
+        spinner?.fail(`Compilation failed (${err.phase}): ${err.message}`);
+      } else {
+        spinner?.fail(err.message);
+      }
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/fix.ts
+import { defineCommand as defineCommand5 } from "citty";
+import ora4 from "ora";
+import pc3 from "picocolors";
+import {
+  analyzeEmail as analyzeEmail4,
+  generateCompatibilityScore as generateCompatibilityScore4,
+  generateAiFix,
+  estimateAiFixTokens,
+  AI_FIX_SYSTEM_PROMPT,
+  CompileError as CompileError4
+} from "@emailens/engine";
+import { compile as compile4 } from "@emailens/engine/compile";
+var fix_default = defineCommand5({
+  meta: {
+    name: "fix",
+    description: "Generate AI-powered fixes for email compatibility issues"
+  },
+  args: {
+    input: {
+      type: "positional",
+      description: "HTML file path or - for stdin",
+      required: true
+    },
+    format: {
+      type: "string",
+      alias: "f",
+      description: "Input format: html, jsx, mjml, maizzle"
+    },
+    clients: {
+      type: "string",
+      alias: "c",
+      description: "Comma-separated client IDs to scope the fix"
+    },
+    output: {
+      type: "string",
+      alias: "o",
+      description: "Write fixed code to file instead of stdout"
+    },
+    json: {
+      type: "boolean",
+      description: "Output as JSON (includes token estimates and metadata)"
+    },
+    quiet: {
+      type: "boolean",
+      alias: "q",
+      description: "Suppress spinners and decorations"
+    },
+    estimate: {
+      type: "boolean",
+      description: "Only show token estimate without calling the AI"
+    },
+    "max-tokens": {
+      type: "string",
+      description: "Maximum input tokens for the prompt (default: 16000)"
+    }
+  },
+  async run({ args }) {
+    const spinner = args.quiet || args.json ? null : ora4();
+    try {
+      const format = resolveFormat(args.format, args.input);
+      const framework = toFramework(format);
+      spinner?.start("Reading input...");
+      const source = await readInput(args.input);
+      const html = await compile4(source, format, args.input !== "-" ? args.input : void 0);
+      spinner?.succeed("Input read");
+      spinner?.start("Analyzing compatibility...");
+      const warnings = analyzeEmail4(html, framework);
+      const scores = generateCompatibilityScore4(warnings);
+      spinner?.succeed(`Found ${warnings.length} warnings`);
+      if (warnings.length === 0) {
+        if (args.json) {
+          console.log(JSON.stringify({ message: "No issues found", code: source }, null, 2));
+        } else {
+          console.log(pc3.green("\n  No compatibility issues found \u2014 nothing to fix.\n"));
+        }
+        return;
+      }
+      const clientIds = resolveClients(args.clients);
+      let scope;
+      let selectedClientId;
+      let scopedWarnings = warnings;
+      let scopedScores = scores;
+      if (args.clients && clientIds.length === 1) {
+        scope = "current";
+        selectedClientId = clientIds[0];
+      } else if (args.clients && clientIds.length > 1) {
+        const clientSet = new Set(clientIds);
+        scope = "all";
+        selectedClientId = void 0;
+        scopedWarnings = warnings.filter((w) => clientSet.has(w.client));
+        scopedScores = Object.fromEntries(
+          Object.entries(scores).filter(([id]) => clientSet.has(id))
+        );
+      } else {
+        scope = "all";
+        selectedClientId = void 0;
+      }
+      const maxInputTokens = args["max-tokens"] ? parseInt(args["max-tokens"], 10) : 16e3;
+      const estimate = await estimateAiFixTokens({
+        originalHtml: html,
+        warnings: scopedWarnings,
+        scores: scopedScores,
+        scope,
+        selectedClientId,
+        format,
+        maxInputTokens
+      });
+      const structuralPct = estimate.warningCount > 0 ? Math.round(estimate.structuralCount / estimate.warningCount * 100) : 0;
+      if (args.estimate) {
+        if (args.json) {
+          console.log(JSON.stringify(estimate, null, 2));
+        } else {
+          console.log(`
+  ${pc3.bold("Token Estimate")}`);
+          console.log(`  Input tokens:    ~${estimate.inputTokens.toLocaleString()}`);
+          console.log(`  Output tokens:   ~${estimate.estimatedOutputTokens.toLocaleString()}`);
+          console.log(`  Warnings:        ${estimate.warningCount} (${estimate.structuralCount} structural)`);
+          if (estimate.truncated) {
+            console.log(`  ${pc3.yellow(`Truncated: ${estimate.warningsRemoved} low-priority warnings removed`)}`);
+          }
+          console.log();
+        }
+        return;
+      }
+      const apiKey = process.env.ANTHROPIC_API_KEY;
+      if (!apiKey) {
+        spinner?.fail("ANTHROPIC_API_KEY environment variable is required");
+        console.error(pc3.dim("\n  Set it with: export ANTHROPIC_API_KEY=sk-ant-...\n"));
+        process.exit(1);
+      }
+      if (!args.quiet && !args.json) {
+        console.log(pc3.dim(`  ~${estimate.inputTokens.toLocaleString()} input tokens, ${estimate.warningCount} warnings (${structuralPct}% structural)`));
+        if (estimate.truncated) {
+          console.log(pc3.yellow(`  Truncated ${estimate.warningsRemoved} low-priority warnings to fit token limit`));
+        }
+      }
+      spinner?.start("Generating AI fix...");
+      let Anthropic;
+      try {
+        Anthropic = (await import("./sdk-HQZAL655.js")).default;
+      } catch {
+        spinner?.fail("@anthropic-ai/sdk is required for the fix command");
+        console.error(pc3.dim("\n  Install it with: npm install @anthropic-ai/sdk\n"));
+        process.exit(1);
+      }
+      const anthropic = new Anthropic({ apiKey });
+      const provider = async (prompt) => {
+        const msg = await anthropic.messages.create({
+          model: "claude-sonnet-4-6",
+          max_tokens: 8192,
+          system: AI_FIX_SYSTEM_PROMPT,
+          messages: [{ role: "user", content: prompt }]
+        });
+        const textBlock = msg.content.find((b) => b.type === "text");
+        return textBlock?.type === "text" ? textBlock.text : "";
+      };
+      const result = await generateAiFix({
+        originalHtml: html,
+        warnings: scopedWarnings,
+        scores: scopedScores,
+        scope,
+        selectedClientId,
+        format,
+        maxInputTokens,
+        provider
+      });
+      spinner?.succeed(`Fixed ${result.targetedWarnings} warnings (${result.structuralCount} structural)`);
+      if (args.output) {
+        const { writeFileSync: writeFileSync2 } = await import("fs");
+        writeFileSync2(args.output, result.code, "utf-8");
+        if (!args.quiet) {
+          console.log(pc3.green(`
+  Fixed code written to ${args.output}
+`));
+        }
+      } else if (args.json) {
+        console.log(JSON.stringify({
+          code: result.code,
+          targetedWarnings: result.targetedWarnings,
+          structuralCount: result.structuralCount,
+          tokenEstimate: result.tokenEstimate
+        }, null, 2));
+      } else {
+        console.log("\n" + result.code);
+      }
+    } catch (err) {
+      if (err instanceof CompileError4) {
+        spinner?.fail(`Compilation failed (${err.phase}): ${err.message}`);
+      } else {
+        spinner?.fail(err.message);
+      }
       process.exit(1);
     }
   }
 });
 
+// src/commands/audit.ts
+import { defineCommand as defineCommand6 } from "citty";
+import ora5 from "ora";
+import pc4 from "picocolors";
+import Table3 from "cli-table3";
+import {
+  auditEmail,
+  CompileError as CompileError5
+} from "@emailens/engine";
+import { compile as compile5 } from "@emailens/engine/compile";
+var VALID_SKIPS = /* @__PURE__ */ new Set(["spam", "links", "accessibility", "images", "compatibility"]);
+var audit_default = defineCommand6({
+  meta: {
+    name: "audit",
+    description: "Full email audit: compatibility + spam + links + accessibility + images"
+  },
+  args: {
+    input: {
+      type: "positional",
+      description: "HTML file path or - for stdin",
+      required: true
+    },
+    format: {
+      type: "string",
+      alias: "f",
+      description: "Input format: html, jsx, mjml, maizzle"
+    },
+    json: {
+      type: "boolean",
+      description: "Output as JSON"
+    },
+    quiet: {
+      type: "boolean",
+      alias: "q",
+      description: "Suppress spinners and decorations"
+    },
+    skip: {
+      type: "string",
+      description: "Comma-separated checks to skip: spam,links,accessibility,images,compatibility"
+    }
+  },
+  async run({ args }) {
+    const spinner = args.quiet || args.json ? null : ora5();
+    try {
+      const format = resolveFormat(args.format, args.input);
+      spinner?.start("Reading input...");
+      const source = await readInput(args.input);
+      spinner?.succeed("Input read");
+      const html = await compile5(source, format, args.input !== "-" ? args.input : void 0);
+      const skip = [];
+      if (args.skip) {
+        for (const s of args.skip.split(",").map((s2) => s2.trim()).filter(Boolean)) {
+          if (!VALID_SKIPS.has(s)) {
+            throw new Error(`Unknown skip value "${s}". Valid: ${Array.from(VALID_SKIPS).join(", ")}`);
+          }
+          skip.push(s);
+        }
+      }
+      spinner?.start("Running full audit...");
+      const framework = toFramework(format);
+      const report = auditEmail(html, { framework, skip });
+      spinner?.succeed("Audit complete");
+      if (args.json) {
+        console.log(JSON.stringify(report, null, 2));
+      } else {
+        if (!skip.includes("compatibility")) {
+          printScoreTable(report.compatibility.scores, report.compatibility.warnings, { quiet: args.quiet });
+          printWarnings(report.compatibility.warnings, { quiet: args.quiet });
+        }
+        printQualitySummary(report, skip, { quiet: args.quiet });
+      }
+    } catch (err) {
+      if (err instanceof CompileError5) {
+        spinner?.fail(`Compilation failed (${err.phase}): ${err.message}`);
+      } else {
+        spinner?.fail(err.message);
+      }
+      process.exit(1);
+    }
+  }
+});
+function printQualitySummary(report, skip, options) {
+  if (!options?.quiet) {
+    console.log(pc4.bold("  Quality Summary"));
+    console.log();
+  }
+  const table = new Table3({
+    head: [pc4.bold("Check"), pc4.bold("Result")],
+    style: { head: [], border: [] }
+  });
+  if (!skip.includes("spam")) {
+    const { score, level, issues } = report.spam;
+    const color = score >= 90 ? pc4.green : score >= 70 ? pc4.yellow : pc4.red;
+    table.push(["Spam Score", `${color(String(score))}/100 (${level}) \u2014 ${issues.length} issue${issues.length === 1 ? "" : "s"}`]);
+  }
+  if (!skip.includes("links")) {
+    const { totalLinks, issues } = report.links;
+    const color = issues.length === 0 ? pc4.green : pc4.yellow;
+    table.push(["Links", `${totalLinks} link${totalLinks === 1 ? "" : "s"} \u2014 ${color(`${issues.length} issue${issues.length === 1 ? "" : "s"}`)}`]);
+  }
+  if (!skip.includes("accessibility")) {
+    const { score, issues } = report.accessibility;
+    const color = score >= 90 ? pc4.green : score >= 70 ? pc4.yellow : pc4.red;
+    table.push(["Accessibility", `${color(String(score))}/100 \u2014 ${issues.length} issue${issues.length === 1 ? "" : "s"}`]);
+  }
+  if (!skip.includes("images")) {
+    const { total, issues } = report.images;
+    const color = issues.length === 0 ? pc4.green : pc4.yellow;
+    table.push(["Images", `${total} image${total === 1 ? "" : "s"} \u2014 ${color(`${issues.length} issue${issues.length === 1 ? "" : "s"}`)}`]);
+  }
+  console.log(table.toString());
+  console.log();
+}
+
 // src/index.ts
-var main = defineCommand5({
+var main = defineCommand7({
   meta: {
     name: "emailens",
-    version: "0.1.0",
+    version: "0.3.0",
     description: "Email compatibility analysis CLI \u2014 preview how HTML emails render across 12 email clients."
   },
   subCommands: {
     analyze: analyze_default,
     preview: preview_default,
     clients: clients_default,
-    export: export_default
+    export: export_default,
+    fix: fix_default,
+    audit: audit_default
   }
 });
 runMain(main);