@edtools/cli 0.4.0 → 0.5.0

package/dist/chunk-ZG6JJCRI.js

@@ -0,0 +1,539 @@
+// src/types/adapter.ts
+var AdapterRegistry = class {
+  adapters;
+  constructor() {
+    this.adapters = /* @__PURE__ */ new Map();
+  }
+  register(adapter) {
+    this.adapters.set(adapter.name, adapter);
+  }
+  get(name) {
+    return this.adapters.get(name);
+  }
+  async detectAdapter(projectPath) {
+    for (const adapter of this.adapters.values()) {
+      if (await adapter.detect(projectPath)) {
+        return adapter;
+      }
+    }
+    return null;
+  }
+  list() {
+    return Array.from(this.adapters.keys());
+  }
+};
+
+// src/adapters/html/index.ts
+import fs from "fs-extra";
+import path from "path";
+import { fileURLToPath } from "url";
+import ejs from "ejs";
+import { marked } from "marked";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.dirname(__filename);
+var HTMLAdapter = class {
+  name = "html";
+  async detect(projectPath) {
+    try {
+      const files = await fs.readdir(projectPath);
+      const hasHtmlInRoot = files.some((f) => f.endsWith(".html"));
+      const hasIndexHtml = await fs.pathExists(path.join(projectPath, "index.html"));
+      const commonDirs = ["public", "dist", "build", "src"];
+      for (const dir of commonDirs) {
+        const dirPath = path.join(projectPath, dir);
+        if (await fs.pathExists(dirPath)) {
+          const dirFiles = await fs.readdir(dirPath);
+          const hasHtmlInDir = dirFiles.some((f) => f.endsWith(".html"));
+          if (hasHtmlInDir) {
+            return true;
+          }
+        }
+      }
+      return hasHtmlInRoot || hasIndexHtml;
+    } catch (error) {
+      return false;
+    }
+  }
+  async render(content) {
+    const templatePath = path.join(__dirname, "templates", "blog-post.html.ejs");
+    if (!await fs.pathExists(templatePath)) {
+      throw new Error(`Template not found at: ${templatePath}`);
+    }
+    const template = await fs.readFile(templatePath, "utf-8");
+    const templateData = {
+      metadata: content.metadata,
+      schemaOrg: JSON.stringify(content.schemaOrg, null, 2),
+      intro: await this.markdownToHTML(content.content.intro),
+      sections: await Promise.all(
+        content.content.sections.map(async (section) => ({
+          ...section,
+          content: await this.renderSectionContent(section)
+        }))
+      ),
+      conclusion: await this.markdownToHTML(content.content.conclusion),
+      cta: content.content.cta,
+      relatedPosts: content.relatedPosts || [],
+      seoScore: content.seo.score
+    };
+    const html = ejs.render(template, templateData);
+    return html;
+  }
+  async write(output, outputPath) {
+    await fs.ensureDir(path.dirname(outputPath));
+    await fs.writeFile(outputPath, output, "utf-8");
+  }
+  getFileExtension() {
+    return ".html";
+  }
+  transformPath(basePath) {
+    if (!basePath.endsWith(".html")) {
+      return basePath + "/index.html";
+    }
+    return basePath;
+  }
+  /**
+   * Convert markdown to HTML
+   */
+  async markdownToHTML(markdown) {
+    return marked(markdown);
+  }
+  /**
+   * Render section content based on type
+   */
+  async renderSectionContent(section) {
+    switch (section.type) {
+      case "text":
+        return await this.markdownToHTML(section.content);
+      case "comparison":
+        return this.renderComparisonTable(section.data);
+      case "list":
+        return this.renderList(section.data);
+      case "code":
+        return this.renderCode(section.data);
+      default:
+        return await this.markdownToHTML(section.content);
+    }
+  }
+  /**
+   * Render comparison table
+   */
+  renderComparisonTable(data) {
+    if (!data || !data.headers || !data.rows) {
+      return "";
+    }
+    let html = '<table class="comparison-table">\n';
+    html += "  <thead>\n    <tr>\n";
+    data.headers.forEach((header) => {
+      html += `      <th>${header}</th>
+`;
+    });
+    html += "    </tr>\n  </thead>\n";
+    html += "  <tbody>\n";
+    data.rows.forEach((row) => {
+      html += "    <tr>\n";
+      row.forEach((cell) => {
+        html += `      <td>${cell}</td>
+`;
+      });
+      html += "    </tr>\n";
+    });
+    html += "  </tbody>\n";
+    html += "</table>";
+    return html;
+  }
+  /**
+   * Render list
+   */
+  renderList(data) {
+    if (!data || !data.items) {
+      return "";
+    }
+    const tag = data.ordered ? "ol" : "ul";
+    let html = `<${tag} class="content-list">
+`;
+    data.items.forEach((item) => {
+      html += "  <li>\n";
+      html += `    <strong>${item.title}</strong>
+`;
+      if (item.description) {
+        html += `    <p>${item.description}</p>
+`;
+      }
+      html += "  </li>\n";
+    });
+    html += `</${tag}>`;
+    return html;
+  }
+  /**
+   * Render code block
+   */
+  renderCode(data) {
+    if (!data || !data.code) {
+      return "";
+    }
+    let html = '<div class="code-block">\n';
+    if (data.caption) {
+      html += `  <div class="code-caption">${data.caption}</div>
+`;
+    }
+    html += `  <pre><code class="language-${data.language || "plaintext"}">${this.escapeHtml(data.code)}</code></pre>
+`;
+    html += "</div>";
+    return html;
+  }
+  /**
+   * Escape HTML entities
+   */
+  escapeHtml(text) {
+    const map = {
+      "&": "&amp;",
+      "<": "&lt;",
+      ">": "&gt;",
+      '"': "&quot;",
+      "'": "&#039;"
+    };
+    return text.replace(/[&<>"']/g, (m) => map[m]);
+  }
+};
+
+// src/core/generator.ts
+import Anthropic from "@anthropic-ai/sdk";
+import OpenAI from "openai";
+import path2 from "path";
+import fs2 from "fs-extra";
+import slugify from "slugify";
+var ContentGenerator = class {
+  anthropic = null;
+  openai = null;
+  provider;
+  adapters;
+  constructor(apiKey, provider = "anthropic") {
+    this.provider = provider;
+    if (provider === "anthropic") {
+      this.anthropic = new Anthropic({
+        apiKey: apiKey || process.env.ANTHROPIC_API_KEY || ""
+      });
+    } else if (provider === "openai") {
+      this.openai = new OpenAI({
+        apiKey: apiKey || process.env.OPENAI_API_KEY || ""
+      });
+    }
+    this.adapters = new AdapterRegistry();
+    this.adapters.register(new HTMLAdapter());
+  }
+  /**
+   * Main generate method
+   */
+  async generate(config) {
+    const results = {
+      success: true,
+      posts: [],
+      warnings: [],
+      errors: []
+    };
+    try {
+      const adapter = await this.adapters.detectAdapter(config.projectPath);
+      if (!adapter) {
+        throw new Error("No suitable adapter found for this project");
+      }
+      console.log(`\u2713 Using adapter: ${adapter.name}`);
+      const topics = config.topics || await this.generateTopics(config.productInfo, config.count || 3);
+      for (const topic of topics.slice(0, config.count || 3)) {
+        try {
+          console.log(`
+\u{1F4DD} Generating: ${topic}`);
+          const content = await this.generateContent(config.productInfo, topic);
+          const output = await adapter.render(content);
+          const slug = content.metadata.slug;
+          const fileName = adapter.transformPath?.(slug) || `${slug}/index${adapter.getFileExtension()}`;
+          const outputPath = path2.join(config.outputDir, fileName);
+          await adapter.write(output, outputPath);
+          results.posts.push({
+            title: content.metadata.title,
+            slug,
+            path: outputPath,
+            seoScore: content.seo.score
+          });
+          console.log(`\u2713 Generated: ${outputPath}`);
+          console.log(`  SEO Score: ${content.seo.score}/100`);
+        } catch (error) {
+          results.errors?.push(`Failed to generate "${topic}": ${error.message}`);
+          results.success = false;
+        }
+      }
+      if (results.posts.length > 0) {
+        await this.updateSitemap(config.projectPath, config.outputDir, results.posts);
+      }
+    } catch (error) {
+      results.success = false;
+      results.errors?.push(error.message);
+    }
+    return results;
+  }
+  /**
+   * Generate blog post content using the selected AI provider
+   */
+  async generateContent(productInfo, topic) {
+    const prompt = this.buildPrompt(productInfo, topic);
+    let contentData;
+    if (this.provider === "anthropic") {
+      contentData = await this.generateWithAnthropic(prompt);
+    } else if (this.provider === "openai") {
+      contentData = await this.generateWithOpenAI(prompt);
+    } else {
+      throw new Error(`Unsupported provider: ${this.provider}`);
+    }
+    const slug = slugify(contentData.metadata.title, { lower: true, strict: true });
+    const content = {
+      metadata: {
+        ...contentData.metadata,
+        slug,
+        datePublished: (/* @__PURE__ */ new Date()).toISOString(),
+        author: productInfo.name
+      },
+      schemaOrg: this.generateSchemaOrg({
+        ...contentData.metadata,
+        slug,
+        datePublished: (/* @__PURE__ */ new Date()).toISOString(),
+        author: productInfo.name
+      }, productInfo),
+      content: contentData.content,
+      relatedPosts: [],
+      seo: await this.calculateSEOScore(contentData)
+    };
+    return content;
+  }
+  /**
+   * Generate content using Anthropic's Claude API
+   */
+  async generateWithAnthropic(prompt) {
+    if (!this.anthropic) {
+      throw new Error("Anthropic client not initialized");
+    }
+    const response = await this.anthropic.messages.create({
+      model: "claude-3-5-sonnet-20241022",
+      max_tokens: 4096,
+      temperature: 0.7,
+      messages: [
+        {
+          role: "user",
+          content: prompt
+        }
+      ]
+    });
+    const textContent = response.content[0].type === "text" ? response.content[0].text : "";
+    const jsonMatch = textContent.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+      throw new Error("Failed to extract JSON from Claude response");
+    }
+    return JSON.parse(jsonMatch[0]);
+  }
+  /**
+   * Generate content using OpenAI's ChatGPT API
+   */
+  async generateWithOpenAI(prompt) {
+    if (!this.openai) {
+      throw new Error("OpenAI client not initialized");
+    }
+    const response = await this.openai.chat.completions.create({
+      model: "gpt-4-turbo-preview",
+      max_tokens: 4096,
+      temperature: 0.7,
+      messages: [
+        {
+          role: "user",
+          content: prompt
+        }
+      ],
+      response_format: { type: "json_object" }
+    });
+    const textContent = response.choices[0]?.message?.content || "";
+    if (!textContent) {
+      throw new Error("Failed to get response from OpenAI");
+    }
+    return JSON.parse(textContent);
+  }
+  /**
+   * Build prompt for Claude API
+   */
+  buildPrompt(productInfo, topic) {
+    return `You are an expert SEO content writer. Generate a comprehensive blog post about: "${topic}"
+
+Product context:
+- Name: ${productInfo.name}
+- Tagline: ${productInfo.tagline || ""}
+- Category: ${productInfo.category}
+- Features: ${productInfo.features.join(", ")}
+- Pricing: ${productInfo.pricingModel || "Not specified"}
+${productInfo.useCases ? `- Use cases: ${productInfo.useCases.join(", ")}` : ""}
+
+IMPORTANT INSTRUCTIONS:
+1. Write for users searching on Google and being recommended by AI assistants (Claude, ChatGPT)
+2. Focus on being helpful, not promotional
+3. Include comparisons with alternatives when relevant
+4. Use natural language, avoid keyword stuffing
+5. Make it comprehensive (1000-1500 words worth of content)
+6. Structure with clear sections (intro, 3-5 main sections, conclusion)
+7. Be factual - do NOT invent statistics or make false claims
+
+Output ONLY valid JSON in this exact format (no markdown, no code blocks):
+{
+  "metadata": {
+    "title": "SEO-optimized title (under 60 chars)",
+    "description": "Meta description (under 160 chars)",
+    "keywords": ["keyword1", "keyword2", "keyword3"],
+    "category": "${productInfo.category}"
+  },
+  "content": {
+    "intro": "Engaging introduction paragraph in markdown format",
+    "sections": [
+      {
+        "heading": "Section title",
+        "level": 2,
+        "content": "Section content in markdown format",
+        "type": "text"
+      }
+    ],
+    "conclusion": "Conclusion paragraph in markdown",
+    "cta": {
+      "text": "Try ${productInfo.name}",
+      "url": "${productInfo.websiteUrl || "/signup"}"
+    }
+  }
+}`;
+  }
+  /**
+   * Generate Schema.org structured data
+   */
+  generateSchemaOrg(metadata, productInfo) {
+    return {
+      "@context": "https://schema.org",
+      "@type": "BlogPosting",
+      headline: metadata.title,
+      description: metadata.description,
+      author: {
+        "@type": "Organization",
+        name: productInfo.name,
+        url: productInfo.websiteUrl
+      },
+      datePublished: metadata.datePublished,
+      publisher: {
+        "@type": "Organization",
+        name: productInfo.name
+      },
+      keywords: metadata.keywords.join(", "),
+      articleSection: metadata.category
+    };
+  }
+  /**
+   * Calculate SEO score
+   */
+  async calculateSEOScore(content) {
+    let score = 100;
+    const suggestions = [];
+    if (content.metadata.title.length > 60) {
+      score -= 10;
+      suggestions.push("Title is too long (should be under 60 chars)");
+    }
+    if (content.metadata.description.length > 160) {
+      score -= 10;
+      suggestions.push("Meta description is too long (should be under 160 chars)");
+    }
+    if (content.metadata.keywords.length < 3) {
+      score -= 5;
+      suggestions.push("Add more keywords (at least 3)");
+    }
+    if (content.content.sections.length < 3) {
+      score -= 10;
+      suggestions.push("Add more sections for better structure (at least 3)");
+    }
+    return {
+      score: Math.max(0, score),
+      suggestions
+    };
+  }
+  /**
+   * Generate topic suggestions
+   */
+  async generateTopics(productInfo, count) {
+    const prompt = `Generate ${count} SEO-friendly blog post topics for a product called "${productInfo.name}" in the ${productInfo.category} category.
+
+Product description: ${productInfo.description}
+Features: ${productInfo.features.join(", ")}
+
+Requirements:
+- Topics should be helpful for potential customers
+- Focus on solving problems or answering questions
+- Include comparisons, guides, and use cases
+- Optimize for search engines and AI recommendations
+
+Output ONLY a JSON array of topic strings, no markdown:
+["Topic 1", "Topic 2", "Topic 3"]`;
+    try {
+      if (this.provider === "anthropic" && this.anthropic) {
+        const response = await this.anthropic.messages.create({
+          model: "claude-3-5-sonnet-20241022",
+          max_tokens: 1024,
+          messages: [{ role: "user", content: prompt }]
+        });
+        const textContent = response.content[0].type === "text" ? response.content[0].text : "";
+        const jsonMatch = textContent.match(/\[[\s\S]*\]/);
+        if (jsonMatch) {
+          return JSON.parse(jsonMatch[0]);
+        }
+      } else if (this.provider === "openai" && this.openai) {
+        const response = await this.openai.chat.completions.create({
+          model: "gpt-4-turbo-preview",
+          max_tokens: 1024,
+          messages: [{ role: "user", content: prompt }],
+          response_format: { type: "json_object" }
+        });
+        const textContent = response.choices[0]?.message?.content || "";
+        if (textContent) {
+          const data = JSON.parse(textContent);
+          const topicsArray = data.topics || data;
+          if (Array.isArray(topicsArray)) {
+            return topicsArray;
+          }
+          if (typeof topicsArray === "object") {
+            return Object.values(topicsArray).filter((v) => typeof v === "string");
+          }
+        }
+      }
+    } catch (error) {
+      console.warn("Failed to generate topics with AI, using fallback");
+    }
+    return [
+      `Best ${productInfo.category} software ${(/* @__PURE__ */ new Date()).getFullYear()}`,
+      `How to choose ${productInfo.category} solution`,
+      `${productInfo.name} vs alternatives: Complete comparison`
+    ];
+  }
+  /**
+   * Update sitemap.xml
+   */
+  async updateSitemap(projectPath, blogDir, posts) {
+    const sitemapPath = path2.join(projectPath, "sitemap.xml");
+    const urls = posts.map((post) => {
+      return `  <url>
+    <loc>${post.slug}/</loc>
+    <lastmod>${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>`;
+    }).join("\n");
+    const sitemap = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls}
+</urlset>`;
+    await fs2.writeFile(sitemapPath, sitemap, "utf-8");
+    console.log(`
+\u2713 Updated sitemap.xml`);
+  }
+};
+
+export {
+  AdapterRegistry,
+  HTMLAdapter,
+  ContentGenerator
+};

package/dist/cli/index.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import {
   ContentGenerator
-} from "../chunk-HQMZIHQM.js";
+} from "../chunk-AJSCN4WK.js";
+import "../chunk-INVECVSW.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
@@ -55,7 +56,7 @@ function showWelcome() {
 }
 function getVersion() {
   try {
-    return "0.4.0";
+    return "0.5.0";
   } catch {
     return "dev";
   }
@@ -721,7 +722,7 @@ Error: ${error.message}
 
 // src/cli/index.ts
 var program = new Command();
-program.name("edtools").description("AI-Powered Content Marketing CLI").version("0.4.0");
+program.name("edtools").description("AI-Powered Content Marketing CLI").version("0.5.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("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);

package/dist/content-helpers-TXVEJMQK.js

@@ -0,0 +1,16 @@
+import {
+  calculateAvgReadTime,
+  calculateReadTime,
+  calculateWordCount,
+  extractShortDescription,
+  generateTimestamp,
+  generateUUID
+} from "./chunk-INVECVSW.js";
+export {
+  calculateAvgReadTime,
+  calculateReadTime,
+  calculateWordCount,
+  extractShortDescription,
+  generateTimestamp,
+  generateUUID
+};

package/dist/core/generator.d.ts

@@ -13,6 +13,8 @@ export declare class ContentGenerator {
     private generateSchemaOrg;
     private calculateSEOScore;
     private generateTopics;
+    private generateManifest;
+    private generateBlogIndex;
     private updateSitemap;
 }
 //# sourceMappingURL=generator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAUA,OAAO,EAKL,cAAc,EACd,cAAc,EAEd,UAAU,EACX,MAAM,mBAAmB,CAAC;AAI3B,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;YAsEjD,eAAe;YA2Cf,qBAAqB;YA+BrB,kBAAkB;IA8BhC,OAAO,CAAC,WAAW;IAkDnB,OAAO,CAAC,iBAAiB;YAwBX,iBAAiB;YAsCjB,cAAc;YA2Dd,aAAa;CAyB5B"}
+{"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"}