git-paid 2.1.7 → 2.1.9

package/lib/engine.js

@@ -58,6 +58,30 @@ function inferCategories(text) {
   return cats.slice(0, 3);
 }
 
+export function isPlaceholderTitle(title = "") {
+  const clean = String(title || "").trim().toLowerCase();
+  if (!clean) return true;
+  return /^(lovable app|vite app|react app|vite \+ react(\s*\+\s*ts)?|vite \+ vue(\s*\+\s*ts)?|create next app|next\.js app|bolt app|v0 app|replit|untitled|document|home|welcome|my app|new app|app|website|index)(\s*[-|—–].*)?$/i.test(
+    clean
+  );
+}
+
+export function humanizeDomainName(domain = "") {
+  const base =
+    String(domain || "app")
+      .toLowerCase()
+      .replace(/^https?:\/\//, "")
+      .replace(/^www\./, "")
+      .split(".")[0] || "app";
+  return (
+    base
+      .split(/[-_]+/)
+      .filter(Boolean)
+      .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+      .join(" ") || "App"
+  );
+}
+
 export async function scanTargetUrl(rawInput, options = {}) {
   let targetUrl = (rawInput || "https://www.postbuild.dev").trim();
   if (!/^https?:\/\//i.test(targetUrl)) {
@@ -127,9 +151,12 @@ export async function scanTargetUrl(rawInput, options = {}) {
   }
 
   const extractedTitle = extractTag(html, /<title[^>]*>([^<]+)<\/title>/i);
+  const hasPlaceholderTitle = isPlaceholderTitle(extractedTitle);
+  const fallbackBrand = humanizeDomainName(domain);
   const rawTitle =
-    extractedTitle ||
-    `${slug.charAt(0).toUpperCase() + slug.slice(1)} — Web Application`;
+    extractedTitle && !hasPlaceholderTitle
+      ? extractedTitle
+      : `${fallbackBrand} — Web Application`;
 
   const description =
     extractTag(html, /<meta[^>]+name=["']description["'][^>]+content=["']([^"']+)["']/i) ||
@@ -145,7 +172,9 @@ export async function scanTargetUrl(rawInput, options = {}) {
   const ogTitle =
     extractTag(html, /<meta[^>]+property=["']og:title["'][^>]+content=["']([^"']+)["']/i) || "";
 
-  const h1List = extractAllTags(html, /<h1[^>]*>([\s\S]*?)<\/h1>/gi, 3);
+  const h1List = extractAllTags(html, /<h1[^>]*>([\s\S]*?)<\/h1>/gi, 3).filter(
+    (h) => !isPlaceholderTitle(h)
+  );
   const h2List = extractAllTags(html, /<h2[^>]*>([\s\S]*?)<\/h2>/gi, 6);
 
   const hasJsonLd = /application\/ld\+json/i.test(html);
@@ -156,15 +185,16 @@ export async function scanTargetUrl(rawInput, options = {}) {
 
   const hasAiCrawlerRules = hasRobots && /OAI-SearchBot|PerplexityBot|ClaudeBot|GPTBot/i.test(robotsText);
   const sitemapUrlCount = hasSitemap ? (sitemapText.match(/<loc>/gi) || []).length : 0;
-  const hasPseoSitemap = sitemapUrlCount >= 10;
+  const hasValidSitemap = hasSitemap && sitemapUrlCount >= 1;
 
   const checks = [
     {
       id: "title",
       label: "Title Tag & Server-Rendered H1",
-      passed: Boolean(extractedTitle && extractedTitle.length > 10 && h1List.length > 0),
-      detail:
-        extractedTitle && h1List.length > 0
+      passed: Boolean(extractedTitle && !hasPlaceholderTitle && extractedTitle.length > 10 && h1List.length > 0),
+      detail: hasPlaceholderTitle && extractedTitle
+        ? `Default builder title detected ("${extractedTitle}") — set your real product title`
+        : extractedTitle && h1List.length > 0
           ? `${extractedTitle} (H1: ${h1List[0].slice(0, 48)})`
           : !extractedTitle
             ? "Missing <title> tag in HTML"
@@ -183,7 +213,7 @@ export async function scanTargetUrl(rawInput, options = {}) {
     {
       id: "og",
       label: "OpenGraph Social Preview Card",
-      passed: Boolean(ogImage || ogTitle),
+      passed: Boolean((ogImage && !/\.svg(\?|$)/i.test(ogImage)) || ogTitle),
       detail: ogImage
         ? `Detected og:image (${ogImage.slice(0, 48)})`
         : ogTitle
@@ -208,11 +238,11 @@ export async function scanTargetUrl(rawInput, options = {}) {
     },
     {
       id: "sitemap",
-      label: "Programmatic SEO Sitemap (10+ Routes)",
-      passed: hasPseoSitemap,
-      detail: hasSitemap
-        ? `sitemap.xml active (${sitemapUrlCount} indexed routes — ${hasPseoSitemap ? "pSEO active" : "25 pSEO routes ready to add"})`
-        : "No sitemap.xml found — 25 structured pSEO routes ready to deploy"
+      label: "XML Sitemap",
+      passed: hasValidSitemap,
+      detail: hasValidSitemap
+        ? `sitemap.xml active (${sitemapUrlCount} indexed ${sitemapUrlCount === 1 ? "URL" : "URLs"})`
+        : "No valid sitemap.xml found — ready to generate"
     },
     {
       id: "paywall",
@@ -234,7 +264,8 @@ export async function scanTargetUrl(rawInput, options = {}) {
   const readinessScore = reachable ? Math.round((passedCount / checks.length) * 100) : 0;
 
   const titleParts = rawTitle.split(/\s*[|—–-]\s*/);
-  const cleanName = (titleParts[0] || slug).trim();
+  const rawFirstPart = (titleParts[0] || "").trim();
+  const cleanName = !rawFirstPart || isPlaceholderTitle(rawFirstPart) ? fallbackBrand : rawFirstPart;
   const h1Candidate =
     h1List[0] && h1List[0].length <= 75 && h1List[0].toLowerCase() !== cleanName.toLowerCase()
       ? h1List[0]
@@ -244,7 +275,9 @@ export async function scanTargetUrl(rawInput, options = {}) {
       ? titleParts[1].trim()
       : null) ||
     h1Candidate ||
-    (description ? description.slice(0, 60).trim() : domain);
+    (description ? truncateWordBoundary(description, 60) : `${cleanName} on ${domain}`);
+
+  const needsCopyReview = Boolean(hasPlaceholderTitle || !description || description.length < 25);
 
   const launchKit = generateLaunchKit({
     origin: parsedUrl.origin,
@@ -255,7 +288,9 @@ export async function scanTargetUrl(rawInput, options = {}) {
     description,
     h1List,
     h2List,
-    botEmail
+    botEmail,
+    needsCopyReview,
+    detectedPlaceholderTitle: hasPlaceholderTitle ? extractedTitle || "" : ""
   });
 
   const pseoPages = generatePseoPages(parsedUrl.origin, slug, cleanName);
@@ -292,19 +327,31 @@ export async function scanTargetUrl(rawInput, options = {}) {
   };
 }
 
-function generateLaunchKit({ origin, domain, slug, cleanName, tagline, description, h1List, h2List, botEmail }) {
+function generateLaunchKit({
+  origin,
+  domain,
+  slug,
+  cleanName,
+  tagline,
+  description,
+  h1List,
+  h2List,
+  botEmail,
+  needsCopyReview = false,
+  detectedPlaceholderTitle = ""
+}) {
   const cleanTagline = tagline.length > 64 ? truncateWordBoundary(tagline, 64) : tagline;
   const shortPitch =
     description && description.length >= 25
       ? truncateWordBoundary(description, 160)
-      : `${cleanName} (${domain}) — web application and online workspace available at ${origin}.`;
+      : `${cleanName} (${domain}) — available at ${origin}.`;
 
   const featureBullets =
     h2List.length >= 2
       ? h2List.slice(0, 4).map((h) => `- **${h}**`).join("\n")
       : [
-          `- **Web Workspace**: Access ${cleanName} directly at ${origin}.`,
-          `- **Focused Workflow**: Built for teams and individuals using ${domain}.`
+          `- **Direct Web Access**: Explore ${cleanName} at ${origin}.`,
+          `- **Streamlined Setup**: Built for ${domain} users.`
         ].join("\n");
 
   const utmUrl = `${origin}/?utm_source=postbuild&utm_medium=directory&utm_campaign=${slug}_launch`;
@@ -329,7 +376,9 @@ Try it live: ${utmUrl}`;
     shortPitch,
     showHnTitle: `Show HN: ${cleanName} – ${cleanTagline}`,
     categories,
-    longDescription
+    longDescription,
+    needsCopyReview,
+    detectedPlaceholderTitle
   };
 }
 
@@ -379,7 +428,11 @@ export function generatePseoPages(origin, slug, cleanName) {
 
 function generateArtifacts(origin, slug, cleanName, description, pseoPages) {
   const today = new Date().toISOString().split("T")[0];
-  const isPostbuildSelf = origin.includes("postbuild.dev");
+  let parsedHostname = "";
+  try {
+    parsedHostname = new URL(origin).hostname.toLowerCase();
+  } catch {}
+  const isPostbuildSelf = parsedHostname === "postbuild.dev" || parsedHostname === "www.postbuild.dev";
 
   const routeEntries = pseoPages
     .map(
@@ -445,7 +498,7 @@ Sitemap: ${origin}/sitemap.xml`;
 </script>`;
 
   const paywallCode = `// 1. Client Component: Drop-In Stripe Checkout Gate for ${cleanName}
-export async function startCheckout({ priceId = "price_YOUR_STRIPE_PRICE_ID", plan = "pro", email = "" } = {}) {
+export async function startCheckout({ priceId = "price_YOUR_STRIPE_PRICE_ID", plan = "standard", email = "" } = {}) {
   const res = await fetch("/api/checkout", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -456,7 +509,7 @@ export async function startCheckout({ priceId = "price_YOUR_STRIPE_PRICE_ID", pl
   return data;
 }
 
-export function CheckoutGate({ priceId = "price_YOUR_STRIPE_PRICE_ID", label = "Get ${cleanName} Pro — $29" }) {
+export function CheckoutGate({ priceId = "price_YOUR_STRIPE_PRICE_ID", label = "Continue to ${cleanName} Checkout" }) {
   return (
     <button
       type="button"

package/lib/fixer.js

@@ -1,6 +1,8 @@
 import fs from "node:fs";
 import path from "node:path";
+import zlib from "node:zlib";
 import { writePseoHtmlFiles } from "./pseo.js";
+import { DIRECTORIES } from "./directories.js";
 
 /**
  * Detects the static public folder of a local project (Next.js, Vite, Astro, SvelteKit, or generic).
@@ -13,11 +15,19 @@ export function detectPublicDir(cwd = process.cwd()) {
   }
 
   let framework = "Static / Node";
-  if (fs.existsSync(path.join(cwd, "next.config.js")) || fs.existsSync(path.join(cwd, "next.config.mjs")) || fs.existsSync(path.join(cwd, "next.config.ts"))) {
+  if (
+    fs.existsSync(path.join(cwd, "next.config.js")) ||
+    fs.existsSync(path.join(cwd, "next.config.mjs")) ||
+    fs.existsSync(path.join(cwd, "next.config.ts"))
+  ) {
     framework = "Next.js";
   } else if (fs.existsSync(path.join(cwd, "astro.config.mjs")) || fs.existsSync(path.join(cwd, "astro.config.ts"))) {
     framework = "Astro";
-  } else if (fs.existsSync(path.join(cwd, "vite.config.js")) || fs.existsSync(path.join(cwd, "vite.config.ts")) || fs.existsSync(path.join(cwd, "vite.config.mjs"))) {
+  } else if (
+    fs.existsSync(path.join(cwd, "vite.config.js")) ||
+    fs.existsSync(path.join(cwd, "vite.config.ts")) ||
+    fs.existsSync(path.join(cwd, "vite.config.mjs"))
+  ) {
     framework = "Vite";
   }
 
@@ -43,31 +53,114 @@ export function buildOgCardSvg(brandName = "Web Application", domain = "example.
 `;
 }
 
-export function buildLlmsTxt(report) {
+function crc32(buf) {
+  let crc = 0xffffffff;
+  for (let i = 0; i < buf.length; i++) {
+    crc ^= buf[i];
+    for (let j = 0; j < 8; j++) {
+      crc = (crc >>> 1) ^ (crc & 1 ? 0xedb88320 : 0);
+    }
+  }
+  return (crc ^ 0xffffffff) >>> 0;
+}
+
+function makePngChunk(type, data) {
+  const typeBuf = Buffer.from(type, "ascii");
+  const lenBuf = Buffer.alloc(4);
+  lenBuf.writeUInt32BE(data.length, 0);
+  const crcInput = Buffer.concat([typeBuf, data]);
+  const crcBuf = Buffer.alloc(4);
+  crcBuf.writeUInt32BE(crc32(crcInput), 0);
+  return Buffer.concat([lenBuf, typeBuf, data, crcBuf]);
+}
+
+/**
+ * Generates a valid 1200x630 RGB PNG social card using built-in node:zlib (zero external dependencies).
+ */
+export function buildOgCardPngBuffer() {
+  const width = 1200;
+  const height = 630;
+  const rowLen = 1 + width * 3;
+  const raw = Buffer.alloc(rowLen * height);
+
+  for (let y = 0; y < height; y++) {
+    const rowStart = y * rowLen;
+    raw[rowStart] = 0; // filter type 0 (None)
+    const inCardY = y >= 48 && y < 582;
+    const inAccentBarY = y >= 48 && y < 60;
+
+    for (let x = 0; x < width; x++) {
+      const px = rowStart + 1 + x * 3;
+      const inCardX = x >= 48 && x < 1152;
+      if (inCardX && inAccentBarY) {
+        // Emerald top accent bar (#047857)
+        raw[px] = 4;
+        raw[px + 1] = 120;
+        raw[px + 2] = 87;
+      } else if (inCardX && inCardY) {
+        // White card surface (#FFFFFF)
+        raw[px] = 255;
+        raw[px + 1] = 255;
+        raw[px + 2] = 255;
+      } else {
+        // Light slate outer frame (#F8FAFC)
+        raw[px] = 248;
+        raw[px + 1] = 250;
+        raw[px + 2] = 252;
+      }
+    }
+  }
+
+  const signature = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
+  const ihdr = Buffer.alloc(13);
+  ihdr.writeUInt32BE(width, 0);
+  ihdr.writeUInt32BE(height, 4);
+  ihdr[8] = 8; // 8-bit depth
+  ihdr[9] = 2; // RGB color type
+  ihdr[10] = 0;
+  ihdr[11] = 0;
+  ihdr[12] = 0;
+
+  const compressed = zlib.deflateSync(raw, { level: 6 });
+  return Buffer.concat([
+    signature,
+    makePngChunk("IHDR", ihdr),
+    makePngChunk("IDAT", compressed),
+    makePngChunk("IEND", Buffer.alloc(0))
+  ]);
+}
+
+export function buildLlmsTxt(report, options = {}) {
   const kit = report.launchKit || {};
   const brand = kit.brandName || kit.productName || report.domain;
   const tagline =
     kit.tagline && kit.tagline.toLowerCase() !== brand.toLowerCase()
       ? kit.tagline
       : report.meta?.description || `${brand} (${report.domain})`;
+  const includePublishedRoutes = Boolean(options.includePublishedRoutes || report.domain === "postbuild.dev");
   const lines = [
     `# ${brand}`,
     ``,
     `> ${tagline}`,
     ``,
     `- Canonical URL: ${report.targetUrl}`,
-    `- Contact: ${report.botEmail}`,
     `- Category: ${kit.categories && kit.categories.length ? kit.categories.join(", ") : "Web Application"}`,
     ``,
     `## Overview`,
-    `${kit.shortPitch || kit.longDescription || `${brand} at ${report.targetUrl}`}`,
-    ``,
-    `## Guides & Resources (Add published routes here)`,
-    ...(report.pseoPages || []).slice(0, 8).map(
-      (p) => `- [${p.keyword || p.path}](${report.targetUrl.replace(/\/$/, "")}${p.path || p.slug}): ${p.category || p.volume || "Guide"}`
-    ),
-    ``
+    `${kit.shortPitch || kit.longDescription || `${brand} at ${report.targetUrl}`}`
   ];
+
+  if (includePublishedRoutes && Array.isArray(report.pseoPages) && report.pseoPages.length > 0) {
+    lines.push(
+      ``,
+      `## Guides & Resources`,
+      ...report.pseoPages.slice(0, 8).map(
+        (p) => `- [${p.keyword || p.path}](${report.targetUrl.replace(/\/$/, "")}${p.path || p.slug}): ${p.category || p.volume || "Guide"}`
+      )
+    );
+  }
+
+  lines.push(``);
   return lines.join("\n");
 }
 
@@ -80,7 +173,9 @@ export function buildHeadSeoSnippet(report, verificationToken = "") {
       : report.meta?.title || `${brand} (${report.domain})`;
   const desc = report.launchKit?.shortPitch || report.meta?.description || `${brand} (${report.domain})`;
   const cleanOrigin = String(report.targetUrl || `https://${report.domain}`).replace(/\/$/, "");
-  const ogImg = report.ogImage || `${cleanOrigin}/og-card.svg`;
+  const existingOgImg =
+    report.ogImage && !/\.svg(\?|$)/i.test(report.ogImage) ? report.ogImage : "";
+  const ogImg = existingOgImg || `${cleanOrigin}/og-card.png`;
   const verifyTag =
     verificationToken || report.verificationToken
       ? `\n<!-- Domain Ownership Verification -->\n<meta name="postbuild-verification" content="${verificationToken || report.verificationToken}" />\n`
@@ -111,9 +206,15 @@ export function buildStartHereMd(report, verificationToken = "") {
   const brand = report.launchKit?.brandName || report.launchKit?.productName || domain;
   const botEmail = report.botEmail || `${domain.replace(/\./g, "-")}-bot@postbuild.dev`;
   const token = verificationToken || report.verificationToken || "";
+  const dirs = Array.isArray(report.directories) && report.directories.length > 0 ? report.directories : DIRECTORIES;
+  const linkCount = dirs.filter((d) => d.prefillMode === "url_params").length;
+  const copyCount = dirs.length - linkCount;
+  const dirOnlyCount = dirs.filter((d) => d.listingType !== "community").length;
+  const commCount = dirs.length - dirOnlyCount;
+
   return `# START HERE — 3-Step Launch Guide for ${brand} (${domain})
 
-Built with **Lovable, Bolt, v0, Replit, Cursor, or Claude**? You do **not** need to know how to code or configure SEO manually. Follow these 3 steps in order:
+Built with **Lovable, Bolt, v0, Replit, Cursor, or Claude**? You do **not** need to configure SEO manually. Follow these 3 steps in order:
 
 ---
 
@@ -124,12 +225,12 @@ Upload or drag this folder into your AI builder (Lovable, Bolt, Replit, Cursor,
 > **Copy & Paste Prompt for Your AI Builder:**
 > \`\`\`text
 > Please add the SEO & Launch files to my project:
-> 1. Place public/robots.txt, public/sitemap.xml, public/llms.txt, public/og-card.svg, and public/.well-known/postbuild-verify.txt into my static public/ folder so they are served at /robots.txt, /sitemap.xml, /llms.txt, /og-card.svg, and /.well-known/postbuild-verify.txt.
+> 1. Place public/robots.txt, public/sitemap.xml, public/llms.txt, public/og-card.png, and public/.well-known/postbuild-verify.txt into my static public/ folder so they are served at /robots.txt, /sitemap.xml, /llms.txt, /og-card.png, and /.well-known/postbuild-verify.txt.
 > 2. Copy the meta tags (including <meta name="postbuild-verification" ...>), canonical link, OpenGraph tags, and JSON-LD structured data from head-seo-snippet.html directly into the static HTML <head> of my root index.html (do not inject via client-only JavaScript so crawlers and domain verification can read them on initial HTTP fetch).
-> 3. Review the starter HTML guides in .postbuild/pseo/ (or starter-pages/). Copy only the 5–8 routes that match our product into public/, customize their copy with our real features/pricing, and add only those published routes from sitemap-starter-routes.xml into public/sitemap.xml and public/llms.txt (remove any unpublished route links so nothing 404s).
+> 3. Review the starter HTML templates in .postbuild/pseo/ (or starter-pages/). Copy only the 5–8 routes that match our product into public/, customize their copy with our real features/pricing, remove <meta name="robots" content="noindex" />, and add only those published routes from sitemap-starter-routes.xml into public/sitemap.xml and public/llms.txt.
 > \`\`\`
 
-> **Editorial Note on Starter HTML Pages:** The static HTML pages in \`.postbuild/pseo/\` are **starter drafts** synthesized from your homepage scan. \`public/sitemap.xml\` lists only your root URL (\`https://${domain}/\`) by default so you never publish broken 404 URLs. Copy and customize only the pages you want to publish, then add those URLs from \`sitemap-starter-routes.xml\` into \`public/sitemap.xml\`.
+> **Editorial Note on Starter HTML Templates:** The static HTML pages in \`.postbuild/pseo/\` include \`<meta name="robots" content="noindex" />\` by default so unedited drafts are never indexed by search engines. \`public/sitemap.xml\` lists only your root URL (\`https://${domain}/\`) by default so you never publish broken 404 URLs. Customize only the 5–8 pages you want to publish, remove \`noindex\`, and add those URLs into \`public/sitemap.xml\`.
 
 ---
 
@@ -143,14 +244,16 @@ Before submitting to directories with \`${botEmail}\`, confirm your inbox is unl
 
 ---
 
-## Step 3: Submit to 85 Curated Startup & AI Directories (No Personal Inbox Spam)
+## Step 3: Submit Across ${dirOnlyCount} Curated Directories & ${commCount} Launch Communities
 
 1. Open \`directories-85.csv\` (or the **Dispatch (85)** tab on \`https://www.postbuild.dev\`).
-2. Click any **Prefilled Launch URL** — your product name, URL, UTM tags, and description are already pre-populated in the link parameters.
-3. For directories with custom form fields, drag the **1-Click Auto-Fill Bookmarklet** on the Postbuild **Dispatch (85)** tab to your browser bookmarks bar and click it on any directory page to fill the form automatically.
-4. **Use your verified inbox address** when a directory asks for an email address:
-   \`${botEmail}\`
-5. Every confirmation email or 6-digit OTP code sent to \`${botEmail}\` arrives in your **Account & Verification Inbox** on \`https://www.postbuild.dev\`.
+2. **How the 85 links work (${linkCount} fill by link, ${copyCount} fill by copy):**
+   - **${linkCount} URL Auto-Prefill links (\`Fill method: Link\`):** Clicking the link opens the submission page with your title, URL, and pitch pre-populated via URL query parameters.
+   - **${copyCount} Standalone Web Forms (\`Fill method: Copy\`):** Browsers block cross-site scripts from injecting text into third-party forms, so use the 1-click field copy buttons (or the Auto-Fill Bookmarklet on desktop) on the **Dispatch (85)** tab to paste your Name, URL, Tagline, Pitch, and verification email.
+3. **Pace your community posts:** For community channels (Hacker News, Reddit subreddits, Indie Hackers), post to only 1–2 relevant communities per week and follow each community's self-promotion rules.
+4. **Use your verified inbox address** when a directory asks for a verification email:
+   \`${botEmail}\` *(Note: For B2B vendor portals like G2, Capterra, and Crunchbase that require a work email on your own domain, use your \`@${domain}\` address).*
+5. Confirmation emails and 6-digit OTP codes sent to \`${botEmail}\` arrive in your **Account & Verification Inbox** on \`https://www.postbuild.dev\`.
 
 ---
 
@@ -159,16 +262,45 @@ Before submitting to directories with \`${botEmail}\`, confirm your inbox is unl
 - \`public/.well-known/postbuild-verify.txt\` — Domain ownership verification file for \`${botEmail}\`
 - \`public/robots.txt\` — Search & AI crawler rules (OAI-SearchBot, ClaudeBot, PerplexityBot)
 - \`public/sitemap.xml\` — Clean XML Sitemap indexing your root URL (\`https://${domain}/\`)
-- \`sitemap-starter-routes.xml\` — Full XML Sitemap entries for the optional starter HTML routes
+- \`sitemap-starter-routes.xml\` — XML Sitemap entries for the optional starter HTML routes
 - \`public/llms.txt\` — Structured markdown manifest for ChatGPT Search, Claude, and Perplexity
-- \`public/og-card.svg\` — Social preview card fallback image
+- \`public/og-card.png\` — 1200×630 PNG social preview card fallback image (plus \`og-card.svg\` vector source)
 - \`head-seo-snippet.html\` — Title, meta description, domain verification tag, OpenGraph tags, and Schema.org JSON-LD
-- \`launch-kit.md\` — Ready-to-post copy for Show HN, Product Hunt, and startup directories
-- \`directories-85.csv\` — All 85 curated directories ranked by Domain Rating (DR) with prefilled URLs
-- \`.postbuild/pseo/{use-cases,compare,guides,checklists,templates,calculators}/**/index.html\` — Starter static HTML SEO drafts to review before publishing
+- \`launch-kit.md\` — Ready-to-post copy for Show HN, Product Hunt, and software directories
+- \`directories-85.csv\` — All ${dirs.length} directories & communities (${linkCount} fill by link, ${copyCount} fill by copy)
+- \`.postbuild/pseo/{use-cases,compare,guides,checklists,templates,calculators}/**/index.html\` — Starter static HTML SEO templates (\`noindex\` until customized)
 `;
 }
 
+function mergeRobotsTxtWithExisting(existingRobots = "", newRobots = "") {
+  if (!existingRobots || !existingRobots.trim()) return newRobots;
+  const customDisallows = existingRobots
+    .split(/\r?\n/)
+    .map((l) => l.trim())
+    .filter((l) => /^Disallow:\s*\S+/i.test(l) && !/^Disallow:\s*$/i.test(l));
+  if (customDisallows.length === 0) return newRobots;
+  const uniqueDisallows = [...new Set(customDisallows)];
+  return newRobots.replace(
+    /User-agent:\s*\*\r?\nAllow:\s*\//i,
+    `User-agent: *\nAllow: /\n${uniqueDisallows.join("\n")}`
+  );
+}
+
+function mergeSitemapWithExisting(existingXml = "", newXml = "") {
+  if (!existingXml || !/<urlset/i.test(existingXml)) return newXml;
+  const existingLocs = [...existingXml.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/gi)].map((m) => m[1].trim());
+  if (existingLocs.length === 0) return newXml;
+  const newLocs = new Set([...newXml.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/gi)].map((m) => m[1].trim()));
+  const today = new Date().toISOString().split("T")[0];
+  const preservedEntries = existingLocs
+    .filter((loc) => !newLocs.has(loc))
+    .map(
+      (loc) => `  <url>\n    <loc>${loc}</loc>\n    <lastmod>${today}</lastmod>\n    <changefreq>weekly</changefreq>\n    <priority>0.8</priority>\n  </url>`
+    );
+  if (preservedEntries.length === 0) return newXml;
+  return newXml.replace(/<\/urlset>/i, `${preservedEntries.join("\n")}\n</urlset>`);
+}
+
 export function applyLocalSeoFixes(report, options = {}) {
   const cwd = options.cwd || process.cwd();
   const overwritePublic = Boolean(options.overwritePublic);
@@ -181,6 +313,7 @@ export function applyLocalSeoFixes(report, options = {}) {
   fs.mkdirSync(outDir, { recursive: true });
 
   const writtenFiles = [];
+  const overwrittenPublicFiles = [];
 
   // 0. START_HERE.md in .postbuild/
   const startHerePath = path.join(outDir, "START_HERE.md");
@@ -200,7 +333,7 @@ export function applyLocalSeoFixes(report, options = {}) {
     fs.writeFileSync(path.join(outWellKnownDir, "postbuild-verify.txt"), `${verificationToken}\n`, "utf8");
   }
 
-  // 0c. Default og-card.svg in public/ (if no og-card.svg or og-card.png exists yet)
+  // 0c. Default og-card.png (1200x630 PNG) in public/ (if no og-card.png exists yet) + og-card.svg source in .postbuild/
   const ogSvgPath = path.join(publicDir, "og-card.svg");
   const ogPngPath = path.join(publicDir, "og-card.png");
   const ogSvgContent = buildOgCardSvg(
@@ -208,34 +341,49 @@ export function applyLocalSeoFixes(report, options = {}) {
     report.domain,
     report.launchKit?.tagline || ""
   );
-  if (!fs.existsSync(ogSvgPath) && !fs.existsSync(ogPngPath)) {
+  const ogPngBuffer = buildOgCardPngBuffer();
+  if (!fs.existsSync(ogPngPath)) {
+    fs.writeFileSync(ogPngPath, ogPngBuffer);
+    writtenFiles.push({ path: path.relative(cwd, ogPngPath), role: "OpenGraph Social Preview Card (og-card.png)" });
+  }
+  if (!fs.existsSync(ogSvgPath)) {
     fs.writeFileSync(ogSvgPath, ogSvgContent, "utf8");
-    writtenFiles.push({ path: path.relative(cwd, ogSvgPath), role: "OpenGraph Social Preview Card (og-card.svg)" });
   }
+  fs.writeFileSync(path.join(outDir, "og-card.png"), ogPngBuffer);
   fs.writeFileSync(path.join(outDir, "og-card.svg"), ogSvgContent, "utf8");
 
-  // 1. robots.txt in public/ (if missing or overwritePublic)
+  // 1. robots.txt in public/ (if missing or overwritePublic — merges existing Disallow rules)
   const robotsPath = path.join(publicDir, "robots.txt");
-  if (!fs.existsSync(robotsPath) || overwritePublic) {
-    fs.writeFileSync(robotsPath, report.artifacts.robotsTxt, "utf8");
+  const hadRobots = fs.existsSync(robotsPath);
+  if (!hadRobots || overwritePublic) {
+    const existingRobots = hadRobots ? fs.readFileSync(robotsPath, "utf8") : "";
+    const mergedRobots = mergeRobotsTxtWithExisting(existingRobots, report.artifacts.robotsTxt);
+    fs.writeFileSync(robotsPath, mergedRobots, "utf8");
+    if (hadRobots) overwrittenPublicFiles.push(path.relative(cwd, robotsPath));
     writtenFiles.push({ path: path.relative(cwd, robotsPath), role: "AI + Search Crawler Rules (robots.txt)" });
   }
 
-  // 2. sitemap.xml in public/ (root URL only by default unless publishPseoToPublic or postbuild.dev)
+  // 2. sitemap.xml in public/ (root URL only by default unless publishPseoToPublic or postbuild.dev; merges existing URLs)
   const sitemapPath = path.join(publicDir, "sitemap.xml");
+  const hadSitemap = fs.existsSync(sitemapPath);
   const rootSitemapXml = report.artifacts.rootSitemapXml || report.artifacts.sitemapXml;
   const fullSitemapXml = report.artifacts.sitemapAllRoutesXml || report.artifacts.sitemapXml;
-  if (!fs.existsSync(sitemapPath) || overwritePublic) {
-    const publicSitemapContent = publishPseoToPublic || report.domain === "postbuild.dev" ? fullSitemapXml : rootSitemapXml;
-    fs.writeFileSync(sitemapPath, publicSitemapContent, "utf8");
+  if (!hadSitemap || overwritePublic) {
+    const existingSitemap = hadSitemap ? fs.readFileSync(sitemapPath, "utf8") : "";
+    const baseSitemapContent = publishPseoToPublic || report.domain === "postbuild.dev" ? fullSitemapXml : rootSitemapXml;
+    const mergedSitemap = mergeSitemapWithExisting(existingSitemap, baseSitemapContent);
+    fs.writeFileSync(sitemapPath, mergedSitemap, "utf8");
+    if (hadSitemap) overwrittenPublicFiles.push(path.relative(cwd, sitemapPath));
     writtenFiles.push({ path: path.relative(cwd, sitemapPath), role: "XML Sitemap (sitemap.xml)" });
   }
 
   // 3. llms.txt in public/ for AI Answer Engines (ChatGPT, Claude, Perplexity)
   const llmsPath = path.join(publicDir, "llms.txt");
-  const llmsContent = buildLlmsTxt(report);
-  if (!fs.existsSync(llmsPath) || overwritePublic) {
+  const hadLlms = fs.existsSync(llmsPath);
+  const llmsContent = buildLlmsTxt(report, { includePublishedRoutes: publishPseoToPublic });
+  if (!hadLlms || overwritePublic) {
     fs.writeFileSync(llmsPath, llmsContent, "utf8");
+    if (hadLlms) overwrittenPublicFiles.push(path.relative(cwd, llmsPath));
     writtenFiles.push({ path: path.relative(cwd, llmsPath), role: "AI Answer Engine Manifest (llms.txt)" });
   }
 
@@ -275,7 +423,7 @@ export function applyLocalSeoFixes(report, options = {}) {
   const renderedPseo = writePseoHtmlFiles(report.pseoPages || [], pseoOutDir, pseoRenderOpts);
   writtenFiles.push({
     path: path.relative(cwd, pseoOutDir),
-    role: `${renderedPseo.length} Starter Static SEO HTML Drafts (review & copy selected routes to public/)`
+    role: `${renderedPseo.length} Starter Static SEO HTML Templates (noindex active until customized)`
   });
 
   if (publishPseoToPublic) {
@@ -286,20 +434,34 @@ export function applyLocalSeoFixes(report, options = {}) {
   fs.writeFileSync(launchKitOut, report.launchKit?.longDescription || report.launchKit?.shortPitch || "", "utf8");
   writtenFiles.push({ path: path.relative(cwd, launchKitOut), role: "Synthesized Launch Copy (HN, Product Hunt, Directories)" });
 
-  // 5. CSV export of all 85 directories with prefilled submission links
-  const csvHeader = "ID,Directory Name,Category,Domain Rating,Submission URL,Prefilled Launch URL,Auto-Fill\n";
+  // 5. CSV export of all 85 directories & communities with honest Fill method (Link vs Copy)
+  const csvHeader = "ID,Directory Name,Type,Category,Domain Rating,Pricing,Submission link,Fill method,Verification Route\n";
   const csvRows = (report.directories || []).map((d) => {
     const q = (val) => `"${String(val || "").replace(/"/g, '""')}"`;
-    return [d.id, q(d.name), q(d.category), d.dr, q(d.submitUrl || d.url), q(d.prefilledUrl), d.auto ? "Yes" : "Manual"].join(",");
+    const typeLabel = d.listingType === "community" ? "Community" : "Directory";
+    const fillMethod = d.prefillMode === "url_params" ? "Link" : "Copy";
+    const subLink = d.prefilledUrl || d.submitUrl || d.url;
+    return [
+      d.id,
+      q(d.name),
+      q(typeLabel),
+      q(d.category),
+      d.dr,
+      q(d.pricing || "Free"),
+      q(subLink),
+      q(fillMethod),
+      q(d.authType || "Direct Form")
+    ].join(",");
   });
   const csvOut = path.join(outDir, "directories-85.csv");
   fs.writeFileSync(csvOut, csvHeader + csvRows.join("\n") + "\n", "utf8");
-  writtenFiles.push({ path: path.relative(cwd, csvOut), role: "85 Curated Directories CSV with Prefilled URLs" });
+  writtenFiles.push({ path: path.relative(cwd, csvOut), role: "85 Directories & Communities CSV (23 Link / 62 Copy)" });
 
   return {
     framework,
     publicDir: path.relative(cwd, publicDir) || "public",
     outDir: path.relative(cwd, outDir) || ".postbuild",
-    writtenFiles
+    writtenFiles,
+    overwrittenPublicFiles
   };
 }

package/lib/inbox.js

@@ -201,7 +201,7 @@ export async function ingestInboundEmail(rawPayload = {}, options = {}) {
       const forwardTarget = (process.env.ADMIN_FORWARD_EMAIL || process.env.ADMIN_EMAIL || "").trim();
       if (forwardTarget && forwardTarget.includes("@")) {
         try {
-          await fetch("https://api.resend.com/emails", {
+          const fwdResp = await fetch("https://api.resend.com/emails", {
             method: "POST",
             headers: {
               Authorization: `Bearer ${resendApiKey}`,
@@ -216,7 +216,13 @@ export async function ingestInboundEmail(rawPayload = {}, options = {}) {
             }),
             signal: AbortSignal.timeout(4500)
           });
-        } catch {}
+          if (!fwdResp.ok) {
+            const errText = await fwdResp.text().catch(() => "");
+            console.error("[inbox/support-forward] Resend forward failed:", fwdResp.status, errText);
+          }
+        } catch (fwdErr) {
+          console.error("[inbox/support-forward] Error forwarding support email:", fwdErr?.message || fwdErr);
+        }
       }
     }
     return {

package/lib/mcp.js

@@ -936,7 +936,7 @@ export async function executeMcpToolCall(name, args = {}, sessionId = "mcp-stdio
 
     const fixRes = applyLocalSeoFixes(report, {
       cwd: args.cwd || process.cwd(),
-      overwritePublic: true,
+      overwritePublic: Boolean(args.force || args.overwritePublic),
       verificationToken: license.verificationToken || ""
     });
     return fixRes;