@edtools/cli 0.5.0 → 0.6.0

package/dist/cli/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   ContentGenerator
-} from "../chunk-AJSCN4WK.js";
+} from "../chunk-JCUQ7D56.js";
 import "../chunk-INVECVSW.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 
 // src/cli/commands/init.ts
 import fs from "fs-extra";
@@ -49,14 +49,22 @@ function showWelcome() {
   console.log("");
   console.log(`  ${chalk.cyan("edtools init")}          ${chalk.gray("Initialize your project")}`);
   console.log(`  ${chalk.cyan("edtools generate")}      ${chalk.gray("Generate SEO-optimized posts")}`);
+  console.log(`  ${chalk.cyan("edtools validate")}      ${chalk.gray("Validate post quality")}`);
   console.log(`  ${chalk.cyan("edtools analyze")}       ${chalk.gray("Analyze Google Search Console CSV")}`);
   console.log("");
+  console.log(chalk.bold.cyan("  Advanced Usage:"));
+  console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log("");
+  console.log(`  ${chalk.cyan("edtools generate --dry-run")}           ${chalk.gray("Preview generation")}`);
+  console.log(`  ${chalk.cyan("edtools generate --report json")}       ${chalk.gray("JSON output")}`);
+  console.log(`  ${chalk.cyan("edtools validate --threshold 85")}      ${chalk.gray("Show posts < 85")}`);
+  console.log("");
   console.log(chalk.gray("  Run ") + chalk.cyan("edtools --help") + chalk.gray(" for all commands"));
   console.log("");
 }
 function getVersion() {
   try {
-    return "0.5.0";
+    return "0.6.0";
   } catch {
     return "dev";
   }
@@ -395,52 +403,120 @@ async function generateCommand(options) {
     avoidDuplicates: true,
     similarityThreshold: 0.85,
     provider,
-    apiKey
+    apiKey,
+    dryRun: options.dryRun
   };
   const providerName = provider === "anthropic" ? "Claude" : "ChatGPT";
   const spinner = ora2(`Generating content with ${providerName}...`).start();
   try {
     const result = await generator.generate(generateConfig);
     if (result.success && result.posts.length > 0) {
-      spinner.succeed(chalk3.bold("Content generated successfully!"));
-      console.log("");
-      const table = new Table({
-        head: [
-          chalk3.cyan.bold("#"),
-          chalk3.cyan.bold("Title"),
-          chalk3.cyan.bold("SEO Score"),
-          chalk3.cyan.bold("Path")
-        ],
-        colWidths: [5, 40, 12, 50],
-        wordWrap: true,
-        style: {
-          head: [],
-          border: ["cyan"]
-        }
-      });
-      result.posts.forEach((post, i) => {
-        const scoreColor = getScoreColorFn(post.seoScore);
-        table.push([
-          chalk3.gray((i + 1).toString()),
-          chalk3.white(post.title),
-          scoreColor(`${post.seoScore}/100`),
-          chalk3.gray(post.path)
-        ]);
-      });
-      console.log(table.toString());
+      const dryRunMode = result.dryRun || false;
+      spinner.succeed(chalk3.bold(dryRunMode ? "Preview generated successfully!" : "Content generated successfully!"));
       console.log("");
-      console.log(successBox(`Generated ${result.posts.length} SEO-optimized ${result.posts.length === 1 ? "post" : "posts"}!`));
-      if (result.warnings && result.warnings.length > 0) {
-        const warningText = result.warnings.join("\n");
-        console.log(warningBox(warningText));
+      if (dryRunMode) {
+        console.log(chalk3.yellow.bold("\u{1F50D} DRY RUN MODE - No files were written\n"));
       }
-      console.log(chalk3.cyan.bold("Next steps:"));
-      console.log(`  ${chalk3.cyan("1.")} Review generated content in ${chalk3.white(outputDir)}`);
-      console.log(`  ${chalk3.cyan("2.")} Edit posts to add personal experience/expertise`);
-      console.log(`  ${chalk3.cyan("3.")} Deploy to your website`);
-      console.log("");
-      console.log(chalk3.yellow(`\u{1F4A1} Tip: Wait 3-7 days before generating more posts to avoid spam detection
+      if (options.report === "json" || options.report === "pretty") {
+        const report = {
+          success: result.success,
+          generated: result.posts.length,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          files: result.posts.map((post) => ({
+            path: post.path,
+            slug: post.slug,
+            title: post.title,
+            url: post.url,
+            wordCount: post.wordCount,
+            readTime: post.readTime,
+            seoScore: post.seoScore,
+            issues: post.seoIssues || [],
+            metadata: {
+              id: post.id,
+              tags: post.tags,
+              keywords: post.keywords,
+              datePublished: post.datePublished
+            }
+          })),
+          manifestPath: result.manifestPath,
+          sitemapPath: result.sitemapPath,
+          stats: result.stats || {
+            avgSeoScore: result.posts.reduce((sum, p) => sum + p.seoScore, 0) / result.posts.length,
+            totalWords: result.posts.reduce((sum, p) => sum + p.wordCount, 0),
+            avgReadTime: result.posts[0]?.readTime || "0 min"
+          },
+          warnings: result.warnings || [],
+          errors: result.errors || [],
+          dryRun: dryRunMode
+        };
+        const indent = options.report === "pretty" ? 2 : 0;
+        console.log(JSON.stringify(report, null, indent));
+      } else {
+        const table = new Table({
+          head: [
+            chalk3.cyan.bold("#"),
+            chalk3.cyan.bold("Title"),
+            chalk3.cyan.bold("Words"),
+            chalk3.cyan.bold("SEO"),
+            dryRunMode ? chalk3.cyan.bold("Would Create") : chalk3.cyan.bold("Path")
+          ],
+          colWidths: [5, 35, 10, 10, 45],
+          wordWrap: true,
+          style: {
+            head: [],
+            border: ["cyan"]
+          }
+        });
+        result.posts.forEach((post, i) => {
+          const scoreColor = getScoreColorFn(post.seoScore);
+          table.push([
+            chalk3.gray((i + 1).toString()),
+            chalk3.white(truncateTitle(post.title, 33)),
+            chalk3.white(post.wordCount.toString()),
+            scoreColor(`${post.seoScore}/100`),
+            chalk3.gray(post.path)
+          ]);
+        });
+        console.log(table.toString());
+        console.log("");
+        if (result.stats) {
+          console.log(chalk3.cyan.bold("Statistics:\n"));
+          console.log(`  Total words: ${chalk3.white(result.stats.totalWords)}`);
+          console.log(`  Avg SEO score: ${getScoreColorFn(result.stats.avgSeoScore)(result.stats.avgSeoScore + "/100")}`);
+          console.log(`  Avg read time: ${chalk3.white(result.stats.avgReadTime)}`);
+          console.log("");
+        }
+        if (dryRunMode) {
+          console.log(chalk3.yellow.bold("Would create:\n"));
+          if (result.manifestPath) {
+            console.log(`  ${chalk3.yellow("\u2022")} ${chalk3.white(result.manifestPath)} (manifest with ${result.posts.length} posts)`);
+          }
+          if (result.sitemapPath) {
+            console.log(`  ${chalk3.yellow("\u2022")} ${chalk3.white(result.sitemapPath)} (sitemap with ${result.posts.length} URLs)`);
+          }
+          console.log("");
+        }
+        if (!dryRunMode) {
+          console.log(successBox(`Generated ${result.posts.length} SEO-optimized ${result.posts.length === 1 ? "post" : "posts"}!`));
+        }
+        if (result.warnings && result.warnings.length > 0) {
+          const warningText = result.warnings.join("\n");
+          console.log(warningBox(warningText));
+        }
+        if (dryRunMode) {
+          console.log(chalk3.cyan.bold("Next step:"));
+          console.log(`  ${chalk3.cyan("\u2022")} Run without ${chalk3.white("--dry-run")} to generate files
+`);
+        } else {
+          console.log(chalk3.cyan.bold("Next steps:"));
+          console.log(`  ${chalk3.cyan("1.")} Review generated content in ${chalk3.white(outputDir)}`);
+          console.log(`  ${chalk3.cyan("2.")} Edit posts to add personal experience/expertise`);
+          console.log(`  ${chalk3.cyan("3.")} Deploy to your website`);
+          console.log("");
+          console.log(chalk3.yellow(`\u{1F4A1} Tip: Wait 3-7 days before generating more posts to avoid spam detection
 `));
+        }
+      }
     } else {
       spinner.fail(chalk3.bold("Failed to generate content"));
       if (result.errors && result.errors.length > 0) {
@@ -456,10 +532,15 @@ async function generateCommand(options) {
   }
 }
 function getScoreColorFn(score) {
-  if (score >= 80) return chalk3.green;
-  if (score >= 60) return chalk3.yellow;
+  if (score >= 90) return chalk3.green;
+  if (score >= 75) return chalk3.yellow;
+  if (score >= 60) return chalk3.hex("#FFA500");
   return chalk3.red;
 }
+function truncateTitle(title, maxLen) {
+  if (title.length <= maxLen) return title;
+  return title.substring(0, maxLen - 3) + "...";
+}
 
 // src/cli/commands/analyze.ts
 import fs4 from "fs-extra";
@@ -720,17 +801,424 @@ Error: ${error.message}
   console.log(chalk4.gray("\u{1F4A1} Use --from-csv to automatically generate posts for top opportunities\n"));
 }
 
+// src/cli/commands/validate.ts
+import fs6 from "fs-extra";
+import path4 from "path";
+import chalk5 from "chalk";
+import Table3 from "cli-table3";
+
+// src/utils/seo-validator.ts
+import * as cheerio from "cheerio";
+import fs5 from "fs-extra";
+async function validatePost(htmlPath) {
+  const html = await fs5.readFile(htmlPath, "utf-8");
+  const $ = cheerio.load(html);
+  const issues = [];
+  const passed = [];
+  const metadata = {};
+  const title = $("title").text().trim();
+  metadata.titleLength = title.length;
+  if (!title) {
+    issues.push({
+      severity: "error",
+      category: "metadata",
+      message: "Missing <title> tag",
+      suggestion: "Add a descriptive title (50-60 characters)"
+    });
+  } else if (title.length < 30) {
+    issues.push({
+      severity: "warning",
+      category: "metadata",
+      message: `Title too short (${title.length} chars)`,
+      suggestion: "Optimal length is 50-60 characters for better CTR"
+    });
+  } else if (title.length > 60) {
+    issues.push({
+      severity: "warning",
+      category: "metadata",
+      message: `Title too long (${title.length} chars)`,
+      suggestion: "Shorten to 50-60 characters to avoid truncation in SERPs"
+    });
+  } else {
+    passed.push(`Title length optimal (${title.length} chars)`);
+  }
+  const metaDesc = $('meta[name="description"]').attr("content")?.trim() || "";
+  metadata.descriptionLength = metaDesc.length;
+  if (!metaDesc) {
+    issues.push({
+      severity: "error",
+      category: "metadata",
+      message: "Missing meta description",
+      suggestion: "Add a compelling description (150-160 characters)"
+    });
+  } else if (metaDesc.length < 120) {
+    issues.push({
+      severity: "warning",
+      category: "metadata",
+      message: `Meta description too short (${metaDesc.length}/160 chars)`,
+      suggestion: `Add ${160 - metaDesc.length} more characters to optimize CTR`
+    });
+  } else if (metaDesc.length > 160) {
+    issues.push({
+      severity: "warning",
+      category: "metadata",
+      message: `Meta description too long (${metaDesc.length}/160 chars)`,
+      suggestion: `Remove ${metaDesc.length - 160} characters to avoid truncation`
+    });
+  } else {
+    passed.push(`Meta description optimal (${metaDesc.length} chars)`);
+  }
+  const h1Elements = $("h1");
+  const h1Count = h1Elements.length;
+  metadata.h1Count = h1Count;
+  if (h1Count === 0) {
+    issues.push({
+      severity: "error",
+      category: "headings",
+      message: "Missing H1 heading",
+      suggestion: "Add a single H1 with primary keyword"
+    });
+  } else if (h1Count > 1) {
+    issues.push({
+      severity: "warning",
+      category: "headings",
+      message: `Multiple H1 tags found (${h1Count})`,
+      suggestion: "Use only one H1 per page for proper structure"
+    });
+  } else {
+    passed.push("Single H1 heading");
+  }
+  const h2Count = $("h2").length;
+  metadata.h2Count = h2Count;
+  if (h2Count < 2) {
+    issues.push({
+      severity: "warning",
+      category: "headings",
+      message: `Few H2 headings for readability (${h2Count} found)`,
+      suggestion: "Add 3-5 H2 headings for better structure and scannability"
+    });
+  } else if (h2Count > 10) {
+    issues.push({
+      severity: "info",
+      category: "headings",
+      message: `Many H2 headings (${h2Count})`,
+      suggestion: "Consider if all sections need H2 or some should be H3"
+    });
+  } else {
+    passed.push(`Good heading structure (${h2Count} H2s)`);
+  }
+  const images = $("img");
+  metadata.imageCount = images.length;
+  const imagesWithoutAlt = images.filter((i, el) => !$(el).attr("alt")).length;
+  if (imagesWithoutAlt > 0) {
+    issues.push({
+      severity: "warning",
+      category: "images",
+      message: `${imagesWithoutAlt} image${imagesWithoutAlt > 1 ? "s" : ""} missing alt text`,
+      suggestion: "Add descriptive alt text to all images for accessibility and SEO"
+    });
+  } else if (images.length > 0) {
+    passed.push(`All images have alt text (${images.length} images)`);
+  }
+  const schemaScript = $('script[type="application/ld+json"]');
+  if (schemaScript.length === 0) {
+    issues.push({
+      severity: "info",
+      category: "structure",
+      message: "Missing Schema.org markup",
+      suggestion: "Add structured data for rich snippets in search results"
+    });
+  } else {
+    passed.push("Has Schema.org markup");
+  }
+  const metaKeywords = $('meta[name="keywords"]');
+  if (metaKeywords.length > 0) {
+    issues.push({
+      severity: "info",
+      category: "metadata",
+      message: "Using deprecated meta keywords tag",
+      suggestion: "Remove meta keywords tag (not used by modern search engines)"
+    });
+  }
+  const ogTitle = $('meta[property="og:title"]').attr("content");
+  const ogDescription = $('meta[property="og:description"]').attr("content");
+  const ogImage = $('meta[property="og:image"]').attr("content");
+  if (!ogTitle || !ogDescription) {
+    issues.push({
+      severity: "info",
+      category: "metadata",
+      message: "Missing Open Graph tags",
+      suggestion: "Add og:title, og:description, og:image for better social sharing"
+    });
+  } else {
+    passed.push("Has Open Graph tags");
+  }
+  const bodyText = $("article, main, body").text();
+  const wordCount = bodyText.replace(/\s+/g, " ").trim().split(/\s+/).filter((word) => word.length > 0).length;
+  metadata.wordCount = wordCount;
+  if (wordCount < 300) {
+    issues.push({
+      severity: "warning",
+      category: "content",
+      message: `Content too short (${wordCount} words)`,
+      suggestion: "Aim for at least 1000 words for better SEO performance"
+    });
+  } else if (wordCount < 1e3) {
+    issues.push({
+      severity: "info",
+      category: "content",
+      message: `Content could be longer (${wordCount} words)`,
+      suggestion: "Consider expanding to 1500+ words for comprehensive coverage"
+    });
+  } else {
+    passed.push(`Good content length (${wordCount} words)`);
+  }
+  const links = $("a[href]");
+  const internalLinks = links.filter((i, el) => {
+    const href = $(el).attr("href") || "";
+    return href.startsWith("/") || href.startsWith("#");
+  }).length;
+  const externalLinks = links.length - internalLinks;
+  if (internalLinks === 0 && links.length > 0) {
+    issues.push({
+      severity: "info",
+      category: "links",
+      message: "No internal links found",
+      suggestion: "Add 2-3 internal links to related content"
+    });
+  } else if (internalLinks > 0) {
+    passed.push(`Has internal links (${internalLinks} links)`);
+  }
+  const errorCount = issues.filter((i) => i.severity === "error").length;
+  const warningCount = issues.filter((i) => i.severity === "warning").length;
+  const infoCount = issues.filter((i) => i.severity === "info").length;
+  let score = 100;
+  score -= errorCount * 20;
+  score -= warningCount * 7;
+  score -= infoCount * 2;
+  score = Math.max(0, Math.min(100, score));
+  return {
+    path: htmlPath,
+    title: title || "Untitled",
+    seoScore: score,
+    issues,
+    passed,
+    metadata
+  };
+}
+function calculateValidationStats(results) {
+  const totalPosts = results.length;
+  const avgSeoScore = results.reduce((sum, r) => sum + r.seoScore, 0) / totalPosts;
+  const totalIssues = results.reduce((sum, r) => sum + r.issues.length, 0);
+  const postsWithIssues = results.filter((r) => r.issues.length > 0).length;
+  const issuesBySeverity = {
+    error: results.reduce((sum, r) => sum + r.issues.filter((i) => i.severity === "error").length, 0),
+    warning: results.reduce((sum, r) => sum + r.issues.filter((i) => i.severity === "warning").length, 0),
+    info: results.reduce((sum, r) => sum + r.issues.filter((i) => i.severity === "info").length, 0)
+  };
+  const issuesByCategory = results.reduce((acc, r) => {
+    r.issues.forEach((issue) => {
+      acc[issue.category] = (acc[issue.category] || 0) + 1;
+    });
+    return acc;
+  }, {});
+  return {
+    totalPosts,
+    avgSeoScore: Math.round(avgSeoScore * 10) / 10,
+    totalIssues,
+    postsWithIssues,
+    issuesBySeverity,
+    issuesByCategory
+  };
+}
+
+// src/cli/commands/validate.ts
+async function validateCommand(options) {
+  console.log(chalk5.cyan.bold("\n\u{1F4CA} Validating SEO quality...\n"));
+  const projectPath = process.cwd();
+  let htmlFiles = [];
+  if (options.post) {
+    const postPath = path4.resolve(projectPath, options.post);
+    if (!await fs6.pathExists(postPath)) {
+      console.log(errorBox(`Post not found: ${postPath}`));
+      process.exit(1);
+    }
+    htmlFiles = [postPath];
+  } else if (options.posts) {
+    const postsDir = path4.resolve(projectPath, options.posts);
+    if (!await fs6.pathExists(postsDir)) {
+      console.log(errorBox(`Directory not found: ${postsDir}`));
+      process.exit(1);
+    }
+    htmlFiles = await findHtmlFiles(postsDir);
+    if (htmlFiles.length === 0) {
+      console.log(errorBox(`No HTML files found in: ${postsDir}`));
+      process.exit(1);
+    }
+  } else {
+    const defaultBlogDir = path4.join(projectPath, "blog");
+    if (await fs6.pathExists(defaultBlogDir)) {
+      htmlFiles = await findHtmlFiles(defaultBlogDir);
+      if (htmlFiles.length === 0) {
+        console.log(errorBox("No HTML files found in blog/ directory"));
+        process.exit(1);
+      }
+    } else {
+      console.log(errorBox("No posts directory specified"));
+      console.log(chalk5.yellow("Usage: edtools validate --posts <dir> or --post <file>\n"));
+      process.exit(1);
+    }
+  }
+  console.log(chalk5.cyan(`Found ${htmlFiles.length} post${htmlFiles.length > 1 ? "s" : ""} to validate
+`));
+  const results = [];
+  for (const htmlFile of htmlFiles) {
+    try {
+      const result = await validatePost(htmlFile);
+      results.push(result);
+    } catch (error) {
+      console.log(chalk5.yellow(`\u26A0\uFE0F  Failed to validate ${htmlFile}: ${error.message}`));
+    }
+  }
+  if (results.length === 0) {
+    console.log(errorBox("No posts could be validated"));
+    process.exit(1);
+  }
+  const threshold = options.threshold ? parseInt(options.threshold, 10) : 0;
+  const filteredResults = threshold > 0 ? results.filter((r) => r.seoScore < threshold) : results;
+  if (options.output) {
+    const stats2 = calculateValidationStats(results);
+    const report = {
+      success: true,
+      validated: results.length,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      posts: results.map((r) => ({
+        path: r.path,
+        title: r.title,
+        seoScore: r.seoScore,
+        issues: r.issues,
+        passed: r.passed,
+        metadata: r.metadata
+      })),
+      stats: stats2
+    };
+    const outputPath = path4.resolve(projectPath, options.output);
+    await fs6.writeJson(outputPath, report, { spaces: 2 });
+    console.log(successBox(`Validation report saved to ${outputPath}`));
+  }
+  if (filteredResults.length > 0) {
+    const table = new Table3({
+      head: [
+        chalk5.cyan.bold("#"),
+        chalk5.cyan.bold("Title"),
+        chalk5.cyan.bold("Score"),
+        chalk5.cyan.bold("Issues")
+      ],
+      colWidths: [5, 40, 10, 50],
+      wordWrap: true,
+      style: {
+        head: [],
+        border: ["cyan"]
+      }
+    });
+    filteredResults.forEach((result, i) => {
+      const scoreColor = getScoreColor(result.seoScore);
+      const issuesText = result.issues.length > 0 ? result.issues.map((issue) => {
+        const icon = issue.severity === "error" ? "\u2717" : issue.severity === "warning" ? "\u26A0" : "\u2139";
+        const color = issue.severity === "error" ? chalk5.red : issue.severity === "warning" ? chalk5.yellow : chalk5.blue;
+        return color(`${icon} ${issue.message}`);
+      }).join("\n") : chalk5.green("\u2713 No issues");
+      table.push([
+        chalk5.gray((i + 1).toString()),
+        chalk5.white(truncate(result.title, 38)),
+        scoreColor(`${result.seoScore}/100`),
+        issuesText
+      ]);
+    });
+    console.log(table.toString());
+    console.log("");
+  } else if (threshold > 0) {
+    console.log(successBox(`All posts have SEO score >= ${threshold}`));
+  }
+  const stats = calculateValidationStats(results);
+  console.log(chalk5.cyan.bold("Overall Statistics:\n"));
+  console.log(`  Total posts validated: ${chalk5.white(stats.totalPosts)}`);
+  console.log(`  Average SEO score: ${getScoreColor(stats.avgSeoScore)(stats.avgSeoScore + "/100")}`);
+  console.log(`  Posts with issues: ${chalk5.white(stats.postsWithIssues)} (${Math.round(stats.postsWithIssues / stats.totalPosts * 100)}%)`);
+  console.log(`  Total issues found: ${chalk5.white(stats.totalIssues)}`);
+  console.log("");
+  if (stats.totalIssues > 0) {
+    console.log(chalk5.cyan.bold("Issues by Severity:\n"));
+    if (stats.issuesBySeverity.error > 0) {
+      console.log(`  ${chalk5.red("\u2717 Errors:")} ${chalk5.white(stats.issuesBySeverity.error)}`);
+    }
+    if (stats.issuesBySeverity.warning > 0) {
+      console.log(`  ${chalk5.yellow("\u26A0 Warnings:")} ${chalk5.white(stats.issuesBySeverity.warning)}`);
+    }
+    if (stats.issuesBySeverity.info > 0) {
+      console.log(`  ${chalk5.blue("\u2139 Info:")} ${chalk5.white(stats.issuesBySeverity.info)}`);
+    }
+    console.log("");
+  }
+  if (Object.keys(stats.issuesByCategory).length > 0) {
+    console.log(chalk5.cyan.bold("Top Issue Categories:\n"));
+    const sortedCategories = Object.entries(stats.issuesByCategory).sort((a, b) => b[1] - a[1]).slice(0, 5);
+    sortedCategories.forEach(([category, count]) => {
+      console.log(`  ${chalk5.white(capitalize(category))}: ${chalk5.yellow(count)}`);
+    });
+    console.log("");
+  }
+  if (stats.avgSeoScore < 85) {
+    console.log(chalk5.yellow.bold("\u{1F4A1} Recommendations:\n"));
+    console.log(chalk5.yellow("  \u2022 Focus on fixing critical errors first"));
+    console.log(chalk5.yellow("  \u2022 Optimize meta descriptions to 150-160 characters"));
+    console.log(chalk5.yellow("  \u2022 Ensure all posts have proper heading structure (H1, H2s)"));
+    console.log(chalk5.yellow("  \u2022 Add alt text to all images"));
+    console.log("");
+  } else {
+    console.log(successBox(`Great job! Average SEO score is ${stats.avgSeoScore}/100`));
+  }
+}
+async function findHtmlFiles(dir) {
+  const files = [];
+  const entries = await fs6.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path4.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      const subFiles = await findHtmlFiles(fullPath);
+      files.push(...subFiles);
+    } else if (entry.isFile() && entry.name.endsWith(".html")) {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+function getScoreColor(score) {
+  if (score >= 90) return chalk5.green;
+  if (score >= 75) return chalk5.yellow;
+  if (score >= 60) return chalk5.hex("#FFA500");
+  return chalk5.red;
+}
+function truncate(str, maxLen) {
+  if (str.length <= maxLen) return str;
+  return str.substring(0, maxLen - 3) + "...";
+}
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
 // src/cli/index.ts
 var program = new Command();
-program.name("edtools").description("AI-Powered Content Marketing CLI").version("0.5.0");
+program.name("edtools").description("AI-Powered Content Marketing CLI - Generate, validate, and optimize SEO content").version("0.6.0");
 program.command("init").description("Initialize edtools in your project").option("-p, --path <path>", "Project path", process.cwd()).action(initCommand);
-program.command("generate").description("Generate blog posts").option("-n, --posts <number>", "Number of posts to generate", "3").option("-t, --topics <topics...>", "Specific topics to write about").option("-o, --output <dir>", "Output directory", "./blog").option("--api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env var)").option("--from-csv", "Generate from CSV analysis opportunities").action(generateCommand);
+program.command("generate").description("Generate SEO-optimized blog posts").option("-n, --posts <number>", "Number of posts to generate (1-10)", "3").option("-t, --topics <topics...>", "Specific topics to write about").option("-o, --output <dir>", "Output directory", "./blog").option("--api-key <key>", "API key (or use ANTHROPIC_API_KEY/OPENAI_API_KEY env var)").option("--from-csv", "Generate from CSV analysis opportunities").option("--dry-run", "Preview what would be generated without writing files").option("--report <format>", "Output format: json, table, pretty (default: table)", "table").action(generateCommand);
 program.command("analyze").description("Analyze Google Search Console CSV data").option("-f, --file <path>", "Path to CSV file (auto-detects if not provided)").option("--min-impressions <number>", "Minimum impressions for opportunities", "50").option("--min-position <number>", "Minimum position for opportunities", "20").option("--limit <number>", "Number of opportunities to show", "10").action(analyzeCommand);
+program.command("validate").description("Validate SEO quality of existing posts").option("--posts <dir>", "Posts directory to validate").option("--post <file>", "Single post file to validate").option("--output <file>", "Save validation report as JSON").option("--threshold <score>", "Only show posts below this score").action(validateCommand);
 program.command("config").description("View or set configuration").option("--set-api-key <key>", "Set Anthropic API key").action(async (options) => {
   if (options.setApiKey) {
-    console.log(chalk5.green("\u2713 API key saved"));
+    console.log(chalk6.green("\u2713 API key saved"));
   } else {
-    console.log(chalk5.cyan("Configuration:"));
+    console.log(chalk6.cyan("Configuration:"));
     console.log(`  API Key: ${process.env.ANTHROPIC_API_KEY ? "[set]" : "[not set]"}`);
   }
 });

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,kCAAkC,CAAC;KAC/C,OAAO,CAAC,OAAO,CAAC,CAAC;AAGpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,mBAAmB,EAAE,cAAc,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAC1D,MAAM,CAAC,WAAW,CAAC,CAAC;AAGvB,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,GAAG,CAAC;KAClE,MAAM,CAAC,0BAA0B,EAAE,gCAAgC,CAAC;KACpE,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,QAAQ,CAAC;KAC1D,MAAM,CAAC,iBAAiB,EAAE,sDAAsD,CAAC;KACjF,MAAM,CAAC,YAAY,EAAE,0CAA0C,CAAC;KAChE,MAAM,CAAC,eAAe,CAAC,CAAC;AAG3B,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,wCAAwC,CAAC;KACrD,MAAM,CAAC,mBAAmB,EAAE,iDAAiD,CAAC;KAC9E,MAAM,CAAC,4BAA4B,EAAE,uCAAuC,EAAE,IAAI,CAAC;KACnF,MAAM,CAAC,yBAAyB,EAAE,oCAAoC,EAAE,IAAI,CAAC;KAC7E,MAAM,CAAC,kBAAkB,EAAE,iCAAiC,EAAE,IAAI,CAAC;KACnE,MAAM,CAAC,cAAc,CAAC,CAAC;AAG1B,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,2BAA2B,CAAC;KACxC,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;KACtD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAEtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC,CAAC,CAAC;AAGL,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC9B,WAAW,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAGD,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/core/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAWA,OAAO,EAKL,cAAc,EACd,cAAc,EAEd,UAAU,EAGX,MAAM,mBAAmB,CAAC;AAW3B,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAE,UAAwB;IAuBzD,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;YAkFjD,eAAe;YAsEf,qBAAqB;YA+BrB,kBAAkB;IA8BhC,OAAO,CAAC,WAAW;IAkDnB,OAAO,CAAC,iBAAiB;YAwBX,iBAAiB;YAsCjB,cAAc;YAqEd,gBAAgB;YA4DhB,iBAAiB;YA8CjB,aAAa;CAkC5B"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAWA,OAAO,EAKL,cAAc,EACd,cAAc,EAEd,UAAU,EAGX,MAAM,mBAAmB,CAAC;AAW3B,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAE,UAAwB;IAuBzD,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;YAiHjD,eAAe;YAsEf,qBAAqB;YA+BrB,kBAAkB;IA8BhC,OAAO,CAAC,WAAW;IAkDnB,OAAO,CAAC,iBAAiB;YAwBX,iBAAiB;YAsCjB,cAAc;YAqEd,gBAAgB;YA4DhB,iBAAiB;YA8CjB,aAAa;CAkC5B"}