@edtools/cli 0.3.2 → 0.4.0

package/dist/cli/index.js

@@ -5,17 +5,99 @@ import {
 
 // src/cli/index.ts
 import { Command } from "commander";
-import chalk3 from "chalk";
+import chalk5 from "chalk";
 
 // src/cli/commands/init.ts
 import fs from "fs-extra";
 import path from "path";
-import chalk from "chalk";
+import chalk2 from "chalk";
 import ora from "ora";
 import inquirer from "inquirer";
 import { load as loadCheerio } from "cheerio";
+
+// src/ui/banner.ts
+import figlet from "figlet";
+import gradient from "gradient-string";
+import boxen from "boxen";
+import chalk from "chalk";
+function generateBanner() {
+  const asciiArt = figlet.textSync("edtools", {
+    font: "ANSI Shadow",
+    horizontalLayout: "default",
+    verticalLayout: "default"
+  });
+  const coloredAscii = gradient(["#00D9FF", "#00FF9F"])(asciiArt);
+  const tagline = chalk.gray("AI-Powered Content Marketing CLI");
+  const version = chalk.dim(`v${getVersion()}`);
+  const content = `${coloredAscii}
+
+${tagline}  ${version}`;
+  return boxen(content, {
+    padding: 1,
+    margin: 1,
+    borderStyle: "round",
+    borderColor: "cyan",
+    dimBorder: false
+  });
+}
+function showWelcome() {
+  console.log(generateBanner());
+  console.log("");
+  console.log(chalk.bold.cyan("  Quick Start:"));
+  console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  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 analyze")}       ${chalk.gray("Analyze Google Search Console CSV")}`);
+  console.log("");
+  console.log(chalk.gray("  Run ") + chalk.cyan("edtools --help") + chalk.gray(" for all commands"));
+  console.log("");
+}
+function getVersion() {
+  try {
+    return "0.4.0";
+  } catch {
+    return "dev";
+  }
+}
+function successBox(message) {
+  return boxen(chalk.green("\u2713 ") + message, {
+    padding: 1,
+    margin: 1,
+    borderStyle: "round",
+    borderColor: "green"
+  });
+}
+function errorBox(message) {
+  return boxen(chalk.red("\u2717 ") + message, {
+    padding: 1,
+    margin: 1,
+    borderStyle: "round",
+    borderColor: "red"
+  });
+}
+function infoBox(title, content) {
+  return boxen(`${chalk.cyan.bold(title)}
+
+${content}`, {
+    padding: 1,
+    margin: 1,
+    borderStyle: "round",
+    borderColor: "cyan"
+  });
+}
+function warningBox(message) {
+  return boxen(chalk.yellow("\u26A0 ") + message, {
+    padding: 1,
+    margin: 1,
+    borderStyle: "round",
+    borderColor: "yellow"
+  });
+}
+
+// src/cli/commands/init.ts
 async function initCommand(options) {
-  console.log(chalk.cyan.bold("\n\u{1F680} Initializing Edtools...\n"));
+  console.log(chalk2.cyan.bold("\n\u{1F680} Initializing Edtools...\n"));
   const projectPath = path.resolve(options.path);
   const configPath = path.join(projectPath, "edtools.config.js");
   if (await fs.pathExists(configPath)) {
@@ -28,7 +110,7 @@ async function initCommand(options) {
       }
     ]);
     if (!overwrite) {
-      console.log(chalk.yellow("Cancelled."));
+      console.log(chalk2.yellow("Cancelled."));
       return;
     }
   }
@@ -62,7 +144,7 @@ async function initCommand(options) {
   } catch (error) {
     spinner.fail("Failed to analyze landing page");
   }
-  console.log(chalk.cyan("\n\u{1F4DD} Please provide some information about your product:\n"));
+  console.log(chalk2.cyan("\n\u{1F4DD} Please provide some information about your product:\n"));
   const answers = await inquirer.prompt([
     {
       type: "input",
@@ -133,7 +215,7 @@ async function initCommand(options) {
       default: "anthropic"
     }
   ]);
-  console.log(chalk.cyan("\n\u{1F511} API Key Setup:\n"));
+  console.log(chalk2.cyan("\n\u{1F511} API Key Setup:\n"));
   const apiKeyAnswer = await inquirer.prompt([
     {
       type: "password",
@@ -192,17 +274,21 @@ async function initCommand(options) {
   await fs.writeFile(edtoolsConfigPath, JSON.stringify(edtoolsConfig, null, 2), "utf-8");
   const gitignorePath = path.join(edtoolsDir, ".gitignore");
   await fs.writeFile(gitignorePath, "*\n!.gitignore\n", "utf-8");
-  console.log(chalk.green("\n\u2713 Configuration created successfully!\n"));
-  console.log(chalk.cyan("Files created:"));
-  console.log(`  - ${chalk.white("edtools.config.js")}`);
-  console.log(`  - ${chalk.white(".edtools/config.json")} (API key stored securely)
-`);
-  console.log(chalk.cyan("Next steps:"));
-  console.log(`  1. Review ${chalk.white("edtools.config.js")}`);
-  console.log(`  2. Generate content: ${chalk.white("edtools generate")}
+  console.log("");
+  console.log(successBox("Configuration created successfully!"));
+  const filesCreated = `${chalk2.cyan("Files created:")}
+
+${chalk2.white("edtools.config.js")}
+${chalk2.gray("Product configuration and settings")}
+
+${chalk2.white(".edtools/config.json")}
+${chalk2.gray("API key stored securely (gitignored)")}`;
+  console.log(infoBox("Setup Complete", filesCreated));
+  console.log(chalk2.cyan.bold("Next steps:"));
+  console.log(`  ${chalk2.cyan("1.")} Review ${chalk2.white("edtools.config.js")}`);
+  console.log(`  ${chalk2.cyan("2.")} Generate content: ${chalk2.white("edtools generate -n 3")}
 `);
-  console.log(chalk.gray(`\u{1F4A1} Your API key is stored locally in .edtools/config.json`));
-  console.log(chalk.gray(`   This folder is gitignored to keep your key safe
+  console.log(chalk2.gray(`\u{1F4A1} Your API key is stored locally and gitignored for security
 `));
 }
 
@@ -210,22 +296,23 @@ async function initCommand(options) {
 import fs2 from "fs-extra";
 import path2 from "path";
 import { pathToFileURL } from "url";
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 import ora2 from "ora";
+import Table from "cli-table3";
 async function generateCommand(options) {
-  console.log(chalk2.cyan.bold("\n\u{1F4DD} Generating content...\n"));
+  console.log(chalk3.cyan.bold("\n\u{1F4DD} Generating content...\n"));
   const projectPath = process.cwd();
   const configPath = path2.join(projectPath, "edtools.config.js");
   if (!await fs2.pathExists(configPath)) {
-    console.log(chalk2.red("\u2717 No edtools.config.js found"));
-    console.log(chalk2.yellow('  Run "edtools init" first\n'));
+    console.log(chalk3.red("\u2717 No edtools.config.js found"));
+    console.log(chalk3.yellow('  Run "edtools init" first\n'));
     process.exit(1);
   }
   const configUrl = pathToFileURL(configPath).href;
   const config = await import(configUrl);
   const productInfo = config.default.product;
   if (!productInfo || !productInfo.name) {
-    console.log(chalk2.red("\u2717 Invalid configuration in edtools.config.js"));
+    console.log(chalk3.red("\u2717 Invalid configuration in edtools.config.js"));
     process.exit(1);
   }
   const provider = productInfo.preferredProvider || "anthropic";
@@ -242,44 +329,65 @@ async function generateCommand(options) {
   if (provider === "anthropic") {
     apiKey = options.apiKey || process.env.ANTHROPIC_API_KEY || storedApiKey;
     if (!apiKey) {
-      console.log(chalk2.red("\u2717 No Anthropic API key found"));
-      console.log(chalk2.yellow('  Run "edtools init" to configure your API key'));
-      console.log(chalk2.yellow("  Or set ANTHROPIC_API_KEY environment variable"));
-      console.log(chalk2.yellow("  Or use --api-key option\n"));
+      console.log(chalk3.red("\u2717 No Anthropic API key found"));
+      console.log(chalk3.yellow('  Run "edtools init" to configure your API key'));
+      console.log(chalk3.yellow("  Or set ANTHROPIC_API_KEY environment variable"));
+      console.log(chalk3.yellow("  Or use --api-key option\n"));
       process.exit(1);
     }
   } else if (provider === "openai") {
     apiKey = options.apiKey || process.env.OPENAI_API_KEY || storedApiKey;
     if (!apiKey) {
-      console.log(chalk2.red("\u2717 No OpenAI API key found"));
-      console.log(chalk2.yellow('  Run "edtools init" to configure your API key'));
-      console.log(chalk2.yellow("  Or set OPENAI_API_KEY environment variable"));
-      console.log(chalk2.yellow("  Or use --api-key option\n"));
+      console.log(chalk3.red("\u2717 No OpenAI API key found"));
+      console.log(chalk3.yellow('  Run "edtools init" to configure your API key'));
+      console.log(chalk3.yellow("  Or set OPENAI_API_KEY environment variable"));
+      console.log(chalk3.yellow("  Or use --api-key option\n"));
+      process.exit(1);
+    }
+  }
+  let topics = options.topics;
+  if (options.fromCsv) {
+    const opportunitiesPath = path2.join(projectPath, ".edtools", "opportunities.json");
+    if (!await fs2.pathExists(opportunitiesPath)) {
+      console.log(chalk3.red("\u2717 No CSV analysis found"));
+      console.log(chalk3.yellow('  Run "edtools analyze" first to analyze your GSC data\n'));
+      process.exit(1);
+    }
+    try {
+      const oppData = await fs2.readJson(opportunitiesPath);
+      topics = oppData.opportunities.slice(0, parseInt(options.posts, 10)).map((opp) => opp.suggestedTitle);
+      console.log(chalk3.cyan("\u{1F4CA} Using topics from CSV analysis:\n"));
+      topics.forEach((topic, i) => {
+        console.log(`  ${chalk3.cyan((i + 1).toString() + ".")} ${chalk3.white(topic)}`);
+      });
+      console.log("");
+    } catch (error) {
+      console.log(chalk3.red("\u2717 Failed to load CSV analysis"));
       process.exit(1);
     }
   }
   const count = parseInt(options.posts, 10);
   if (isNaN(count) || count < 1 || count > 10) {
-    console.log(chalk2.red("\u2717 Invalid number of posts (must be 1-10)"));
+    console.log(chalk3.red("\u2717 Invalid number of posts (must be 1-10)"));
     process.exit(1);
   }
   if (count > 5) {
-    console.log(chalk2.yellow(`\u26A0\uFE0F  Generating ${count} posts at once may trigger spam detection`));
-    console.log(chalk2.yellow("   Recommended: 3-5 posts per week\n"));
+    console.log(chalk3.yellow(`\u26A0\uFE0F  Generating ${count} posts at once may trigger spam detection`));
+    console.log(chalk3.yellow("   Recommended: 3-5 posts per week\n"));
   }
   const outputDir = path2.resolve(projectPath, options.output);
   await fs2.ensureDir(outputDir);
-  console.log(chalk2.cyan("Configuration:"));
-  console.log(`  Product: ${chalk2.white(productInfo.name)}`);
-  console.log(`  Category: ${chalk2.white(productInfo.category)}`);
-  console.log(`  AI Provider: ${chalk2.white(provider === "anthropic" ? "Claude (Anthropic)" : "ChatGPT (OpenAI)")}`);
-  console.log(`  Posts to generate: ${chalk2.white(count)}`);
-  console.log(`  Output directory: ${chalk2.white(outputDir)}
+  console.log(chalk3.cyan("Configuration:"));
+  console.log(`  Product: ${chalk3.white(productInfo.name)}`);
+  console.log(`  Category: ${chalk3.white(productInfo.category)}`);
+  console.log(`  AI Provider: ${chalk3.white(provider === "anthropic" ? "Claude (Anthropic)" : "ChatGPT (OpenAI)")}`);
+  console.log(`  Posts to generate: ${chalk3.white(count)}`);
+  console.log(`  Output directory: ${chalk3.white(outputDir)}
 `);
   const generator = new ContentGenerator(apiKey, provider);
   const generateConfig = {
     productInfo,
-    topics: options.topics,
+    topics,
     count,
     outputDir,
     projectPath,
@@ -293,61 +401,340 @@ async function generateCommand(options) {
   try {
     const result = await generator.generate(generateConfig);
     if (result.success && result.posts.length > 0) {
-      spinner.succeed("Content generated successfully!");
-      console.log(chalk2.green("\n\u2713 Generated posts:\n"));
+      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) => {
-        console.log(`${i + 1}. ${chalk2.white(post.title)}`);
-        console.log(`   ${chalk2.gray(post.path)}`);
-        console.log(`   ${chalk2.cyan("SEO Score:")} ${getScoreColor(post.seoScore)}${post.seoScore}/100${chalk2.reset()}`);
+        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());
+      console.log("");
+      console.log(successBox(`Generated ${result.posts.length} SEO-optimized ${result.posts.length === 1 ? "post" : "posts"}!`));
       if (result.warnings && result.warnings.length > 0) {
-        console.log(chalk2.yellow("\n\u26A0\uFE0F  Warnings:"));
-        result.warnings.forEach((warning) => {
-          console.log(`   ${warning}`);
-        });
+        const warningText = result.warnings.join("\n");
+        console.log(warningBox(warningText));
       }
-      console.log(chalk2.cyan("\nNext steps:"));
-      console.log(`  1. Review generated content in ${chalk2.white(outputDir)}`);
-      console.log(`  2. Edit posts to add personal experience/expertise`);
-      console.log(`  3. Deploy to your website`);
-      console.log(chalk2.yellow(`
-\u{1F4A1} Tip: Wait 3-7 days before generating more posts to avoid spam detection
+      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("Failed to generate content");
+      spinner.fail(chalk3.bold("Failed to generate content"));
       if (result.errors && result.errors.length > 0) {
-        console.log(chalk2.red("\nErrors:"));
-        result.errors.forEach((error) => {
-          console.log(`  ${error}`);
-        });
+        const errorText = result.errors.join("\n");
+        console.log(errorBox(errorText));
       }
       process.exit(1);
     }
   } catch (error) {
-    spinner.fail("Error during generation");
-    console.log(chalk2.red(`
-${error.message}
-`));
+    spinner.fail(chalk3.bold("Error during generation"));
+    console.log(errorBox(error.message));
     process.exit(1);
   }
 }
-function getScoreColor(score) {
-  if (score >= 80) return chalk2.green("");
-  if (score >= 60) return chalk2.yellow("");
-  return chalk2.red("");
+function getScoreColorFn(score) {
+  if (score >= 80) return chalk3.green;
+  if (score >= 60) return chalk3.yellow;
+  return chalk3.red;
+}
+
+// src/cli/commands/analyze.ts
+import fs4 from "fs-extra";
+import path3 from "path";
+import chalk4 from "chalk";
+import ora3 from "ora";
+import Table2 from "cli-table3";
+
+// src/integrations/gsc-csv-analyzer.ts
+import fs3 from "fs-extra";
+import { parse } from "csv-parse/sync";
+async function parseGSCCSV(filePath) {
+  const content = await fs3.readFile(filePath, "utf-8");
+  const records = parse(content, {
+    columns: true,
+    skip_empty_lines: true,
+    cast: (value, context) => {
+      if (context.column === "Clicks" || context.column === "Impressions") {
+        return parseInt(value.replace(/,/g, ""), 10);
+      }
+      if (context.column === "CTR") {
+        return parseFloat(value.replace("%", "")) / 100;
+      }
+      if (context.column === "Position") {
+        return parseFloat(value);
+      }
+      return value;
+    }
+  });
+  const data = records.map((record) => ({
+    query: record["Top queries"] || record["Query"] || record["query"] || "",
+    impressions: record["Impressions"] || record["impressions"] || 0,
+    clicks: record["Clicks"] || record["clicks"] || 0,
+    ctr: record["CTR"] || record["ctr"] || 0,
+    position: record["Position"] || record["position"] || 0,
+    url: record["Top pages"] || record["Page"] || record["url"] || void 0
+  }));
+  return data.filter((d) => d.query && d.impressions > 0);
+}
+function analyzeGSCData(data, config = {}) {
+  const {
+    minImpressions = 50,
+    minPosition = 20,
+    maxPosition = 100,
+    minPotentialClicks = 10,
+    limit = 10
+  } = config;
+  const totalQueries = data.length;
+  const totalImpressions = data.reduce((sum, d) => sum + d.impressions, 0);
+  const totalClicks = data.reduce((sum, d) => sum + d.clicks, 0);
+  const avgCTR = totalClicks / totalImpressions || 0;
+  const avgPosition = data.reduce((sum, d) => sum + d.position, 0) / totalQueries || 0;
+  const opportunities = data.filter((d) => d.impressions >= minImpressions && d.position >= minPosition && d.position <= maxPosition).map((d) => {
+    const estimatedCTRTop10 = 0.15;
+    const potentialClicks = Math.round(d.impressions * estimatedCTRTop10 - d.clicks);
+    let priority = "low";
+    if (d.impressions > 100 && potentialClicks > 20) {
+      priority = "high";
+    } else if (d.impressions > 50 && potentialClicks > 10) {
+      priority = "medium";
+    }
+    const suggestedTitle = generateSuggestedTitle(d.query);
+    const reason = `${d.impressions} impressions at position ${d.position.toFixed(1)} \u2192 potential +${potentialClicks} clicks`;
+    return {
+      keyword: d.query,
+      impressions: d.impressions,
+      clicks: d.clicks,
+      ctr: d.ctr,
+      position: d.position,
+      potentialClicks,
+      priority,
+      suggestedTitle,
+      reason
+    };
+  }).filter((opp) => opp.potentialClicks >= minPotentialClicks).sort((a, b) => {
+    const priorityOrder = { high: 3, medium: 2, low: 1 };
+    const priorityDiff = priorityOrder[b.priority] - priorityOrder[a.priority];
+    if (priorityDiff !== 0) return priorityDiff;
+    return b.potentialClicks - a.potentialClicks;
+  }).slice(0, limit);
+  const topKeywords = [...data].sort((a, b) => b.clicks - a.clicks).slice(0, 10);
+  const lowCTRPages = data.filter((d) => d.position <= 20 && d.ctr < 0.02).sort((a, b) => a.ctr - b.ctr).slice(0, 10);
+  return {
+    totalQueries,
+    totalImpressions,
+    totalClicks,
+    avgCTR,
+    avgPosition,
+    opportunities,
+    topKeywords,
+    lowCTRPages
+  };
+}
+function generateSuggestedTitle(keyword) {
+  const words = keyword.split(" ");
+  const capitalized = words.map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  const currentYear = (/* @__PURE__ */ new Date()).getFullYear();
+  if (!capitalized.includes(currentYear.toString())) {
+    return `${capitalized}: Complete Guide ${currentYear}`;
+  }
+  return `${capitalized}: Complete Guide`;
+}
+async function saveOpportunities(opportunities, outputPath) {
+  const data = {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    count: opportunities.length,
+    opportunities
+  };
+  await fs3.writeJson(outputPath, data, { spaces: 2 });
+}
+
+// src/cli/commands/analyze.ts
+async function analyzeCommand(options) {
+  console.log(chalk4.cyan.bold("\n\u{1F4CA} Analyzing Google Search Console Data...\n"));
+  const projectPath = process.cwd();
+  let csvPath;
+  if (options.file) {
+    csvPath = path3.resolve(options.file);
+  } else {
+    const files = await fs4.readdir(projectPath);
+    const csvFiles = files.filter((f) => f.endsWith(".csv") && f.toLowerCase().includes("search"));
+    if (csvFiles.length === 0) {
+      console.log(chalk4.red("\u2717 No CSV file found"));
+      console.log(chalk4.yellow("  Please provide a CSV file using --file option"));
+      console.log(chalk4.yellow("  Example: edtools analyze --file search-console-data.csv\n"));
+      process.exit(1);
+    }
+    if (csvFiles.length > 1) {
+      console.log(chalk4.yellow("\u26A0 Multiple CSV files found:"));
+      csvFiles.forEach((f) => console.log(`  - ${f}`));
+      console.log(chalk4.yellow("\nUsing first file. Specify with --file to use a different one.\n"));
+    }
+    csvPath = path3.join(projectPath, csvFiles[0]);
+  }
+  if (!await fs4.pathExists(csvPath)) {
+    console.log(chalk4.red(`\u2717 File not found: ${csvPath}
+`));
+    process.exit(1);
+  }
+  const spinner = ora3("Parsing CSV data...").start();
+  let data;
+  try {
+    data = await parseGSCCSV(csvPath);
+    spinner.succeed(`Parsed ${chalk4.white(data.length)} keywords from ${chalk4.white(path3.basename(csvPath))}`);
+  } catch (error) {
+    spinner.fail("Failed to parse CSV");
+    console.log(chalk4.red(`
+Error: ${error.message}
+`));
+    process.exit(1);
+  }
+  const analyzeSpinner = ora3("Analyzing opportunities...").start();
+  const config = {
+    minImpressions: options.minImpressions ? parseInt(options.minImpressions, 10) : 50,
+    minPosition: options.minPosition ? parseInt(options.minPosition, 10) : 20,
+    limit: options.limit ? parseInt(options.limit, 10) : 10
+  };
+  const analysis = analyzeGSCData(data, config);
+  analyzeSpinner.succeed("Analysis complete!");
+  console.log("");
+  const metricsTable = new Table2({
+    head: [chalk4.cyan.bold("Metric"), chalk4.cyan.bold("Value")],
+    colWidths: [30, 20],
+    style: {
+      head: [],
+      border: ["cyan"]
+    }
+  });
+  metricsTable.push(
+    ["Total Keywords", chalk4.white(analysis.totalQueries.toLocaleString())],
+    ["Total Impressions", chalk4.white(analysis.totalImpressions.toLocaleString())],
+    ["Total Clicks", chalk4.white(analysis.totalClicks.toLocaleString())],
+    ["Average CTR", chalk4.white((analysis.avgCTR * 100).toFixed(2) + "%")],
+    ["Average Position", chalk4.white(analysis.avgPosition.toFixed(1))]
+  );
+  console.log(chalk4.bold.cyan("\u{1F4C8} Overall Metrics\n"));
+  console.log(metricsTable.toString());
+  console.log("");
+  if (analysis.opportunities.length === 0) {
+    console.log(warningBox("No opportunities found with current criteria.\nTry lowering --min-impressions or increasing --min-position."));
+  } else {
+    console.log(chalk4.bold.cyan(`\u{1F3AF} Top ${analysis.opportunities.length} Content Opportunities
+`));
+    const oppTable = new Table2({
+      head: [
+        chalk4.cyan.bold("#"),
+        chalk4.cyan.bold("Keyword"),
+        chalk4.cyan.bold("Impressions"),
+        chalk4.cyan.bold("Position"),
+        chalk4.cyan.bold("Potential"),
+        chalk4.cyan.bold("Priority")
+      ],
+      colWidths: [5, 40, 14, 12, 12, 12],
+      wordWrap: true,
+      style: {
+        head: [],
+        border: ["cyan"]
+      }
+    });
+    analysis.opportunities.forEach((opp, i) => {
+      const priorityColor = opp.priority === "high" ? chalk4.green : opp.priority === "medium" ? chalk4.yellow : chalk4.gray;
+      oppTable.push([
+        chalk4.gray((i + 1).toString()),
+        chalk4.white(opp.keyword),
+        chalk4.cyan(opp.impressions.toLocaleString()),
+        chalk4.yellow(opp.position.toFixed(1)),
+        chalk4.green(`+${opp.potentialClicks}`),
+        priorityColor(opp.priority.toUpperCase())
+      ]);
+    });
+    console.log(oppTable.toString());
+    console.log("");
+    console.log(chalk4.bold.cyan("\u{1F4A1} Suggested Blog Post Titles\n"));
+    analysis.opportunities.slice(0, 5).forEach((opp, i) => {
+      console.log(`  ${chalk4.cyan((i + 1).toString() + ".")} ${chalk4.white(opp.suggestedTitle)}`);
+      console.log(`     ${chalk4.gray(opp.reason)}
+`);
+    });
+  }
+  if (analysis.topKeywords.length > 0) {
+    console.log(chalk4.bold.cyan("\u2B50 Top Performing Keywords (by clicks)\n"));
+    const topTable = new Table2({
+      head: [
+        chalk4.cyan.bold("#"),
+        chalk4.cyan.bold("Keyword"),
+        chalk4.cyan.bold("Clicks"),
+        chalk4.cyan.bold("Impressions"),
+        chalk4.cyan.bold("CTR")
+      ],
+      colWidths: [5, 40, 12, 14, 12],
+      wordWrap: true,
+      style: {
+        head: [],
+        border: ["cyan"]
+      }
+    });
+    analysis.topKeywords.slice(0, 5).forEach((kw, i) => {
+      topTable.push([
+        chalk4.gray((i + 1).toString()),
+        chalk4.white(kw.query),
+        chalk4.green(kw.clicks.toString()),
+        chalk4.cyan(kw.impressions.toLocaleString()),
+        chalk4.yellow((kw.ctr * 100).toFixed(2) + "%")
+      ]);
+    });
+    console.log(topTable.toString());
+    console.log("");
+  }
+  const edtoolsDir = path3.join(projectPath, ".edtools");
+  await fs4.ensureDir(edtoolsDir);
+  const opportunitiesPath = path3.join(edtoolsDir, "opportunities.json");
+  await saveOpportunities(analysis.opportunities, opportunitiesPath);
+  console.log(successBox(`Analysis saved to ${chalk4.white(".edtools/opportunities.json")}`));
+  console.log(chalk4.cyan.bold("Next steps:"));
+  console.log(`  ${chalk4.cyan("1.")} Generate content: ${chalk4.white("edtools generate --from-csv")}`);
+  console.log(`  ${chalk4.cyan("2.")} Or specify topics: ${chalk4.white('edtools generate -t "topic 1" "topic 2"')}
+`);
+  console.log(chalk4.gray("\u{1F4A1} Use --from-csv to automatically generate posts for top opportunities\n"));
 }
 
 // src/cli/index.ts
 var program = new Command();
-program.name("edtools").description("Generate SEO-optimized content for LLM discovery").version("0.1.0");
+program.name("edtools").description("AI-Powered Content Marketing CLI").version("0.4.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)").action(generateCommand);
+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("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("config").description("View or set configuration").option("--set-api-key <key>", "Set Anthropic API key").action(async (options) => {
   if (options.setApiKey) {
-    console.log(chalk3.green("\u2713 API key saved"));
+    console.log(chalk5.green("\u2713 API key saved"));
   } else {
-    console.log(chalk3.cyan("Configuration:"));
+    console.log(chalk5.cyan("Configuration:"));
     console.log(`  API Key: ${process.env.ANTHROPIC_API_KEY ? "[set]" : "[not set]"}`);
   }
 });
+if (process.argv.length === 2) {
+  showWelcome();
+  process.exit(0);
+}
 program.parse();

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;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,kDAAkD,CAAC;KAC/D,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,eAAe,CAAC,CAAC;AAG3B,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,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"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"}