git-paid 2.1.6 → 2.1.7

package/lib/engine.js

@@ -14,25 +14,47 @@ function extractTag(html, regex) {
 }
 
 function extractAllTags(html, regex, limit = 6) {
+  const stripped = String(html || "")
+    .replace(/<!--[\s\S]*?-->/g, " ")
+    .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ")
+    .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ")
+    .replace(/<template\b[^>]*>[\s\S]*?<\/template>/gi, " ");
   const results = [];
   let match;
-  while ((match = regex.exec(html)) !== null && results.length < limit) {
+  while ((match = regex.exec(stripped)) !== null && results.length < limit) {
     const clean = match[1].replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
-    if (clean && clean.length > 3 && !results.includes(clean)) {
+    if (
+      clean &&
+      clean.length > 3 &&
+      !clean.includes("${") &&
+      !clean.includes("{") &&
+      !results.includes(clean)
+    ) {
       results.push(clean);
     }
   }
   return results;
 }
 
+function truncateWordBoundary(text, maxLen = 160) {
+  const clean = String(text || "").replace(/\s+/g, " ").trim();
+  if (clean.length <= maxLen) return clean;
+  const slice = clean.slice(0, maxLen - 3);
+  const lastSpace = slice.lastIndexOf(" ");
+  return (lastSpace > maxLen * 0.6 ? slice.slice(0, lastSpace) : slice).replace(/[.,;:\s-]+$/, "") + "...";
+}
+
 function inferCategories(text) {
-  const lower = (text || "").toLowerCase();
+  const lower = (text || "").toLowerCase().trim();
+  if (lower.length < 25) {
+    return ["Web Application"];
+  }
   const cats = [];
-  if (/cli|git|sdk|api|developer|code|terminal|repo|deploy/.test(lower)) cats.push("Developer Tools");
-  if (/ai|llm|agent|gpt|claude|model|prompt|automation/.test(lower)) cats.push("AI & Automation");
-  if (/seo|marketing|directory|launch|growth|leads|traffic/.test(lower)) cats.push("Marketing & SEO");
-  if (/stripe|pay|revenue|billing|invoice|saas|pricing/.test(lower)) cats.push("SaaS & Monetization");
-  if (cats.length === 0) cats.push("SaaS", "Productivity", "Software");
+  if (/\b(cli|git|sdk|api|developer|code|terminal|repo|deploy)\b/.test(lower)) cats.push("Developer Tools");
+  if (/\b(ai|llm|agent|gpt|claude|model|prompt)\b/.test(lower)) cats.push("AI & Automation");
+  if (/\b(seo|marketing|directory|launch|growth|leads|traffic)\b/.test(lower)) cats.push("Marketing & SEO");
+  if (/\b(stripe|pay|revenue|billing|invoice|saas|pricing)\b/.test(lower)) cats.push("SaaS & Monetization");
+  if (cats.length === 0) cats.push("Web Application");
   return cats.slice(0, 3);
 }
 
@@ -213,10 +235,16 @@ export async function scanTargetUrl(rawInput, options = {}) {
 
   const titleParts = rawTitle.split(/\s*[|—–-]\s*/);
   const cleanName = (titleParts[0] || slug).trim();
+  const h1Candidate =
+    h1List[0] && h1List[0].length <= 75 && h1List[0].toLowerCase() !== cleanName.toLowerCase()
+      ? h1List[0]
+      : null;
   const extractedTagline =
-    (titleParts[1] && titleParts[1].length >= 12 ? titleParts[1].trim() : null) ||
-    (h1List[0] && h1List[0].length <= 75 ? h1List[0] : null) ||
-    (description ? description.slice(0, 60).trim() : `${cleanName} (${domain})`);
+    (titleParts[1] && titleParts[1].length >= 12 && titleParts[1].toLowerCase() !== "web application"
+      ? titleParts[1].trim()
+      : null) ||
+    h1Candidate ||
+    (description ? description.slice(0, 60).trim() : domain);
 
   const launchKit = generateLaunchKit({
     origin: parsedUrl.origin,
@@ -253,6 +281,7 @@ export async function scanTargetUrl(rawInput, options = {}) {
     cleanName,
     reachable,
     botEmail,
+    ogImage: ogImage || "",
     readinessScore,
     checks,
     launchKit,
@@ -264,23 +293,22 @@ export async function scanTargetUrl(rawInput, options = {}) {
 }
 
 function generateLaunchKit({ origin, domain, slug, cleanName, tagline, description, h1List, h2List, botEmail }) {
-  const cleanTagline = tagline.length > 64 ? tagline.slice(0, 61).trim() + "..." : tagline;
+  const cleanTagline = tagline.length > 64 ? truncateWordBoundary(tagline, 64) : tagline;
   const shortPitch =
-    description && description.length >= 40
-      ? description.slice(0, 158)
-      : `${cleanName} (${domain}) helps teams and solo builders automate their workflow, eliminate manual bottlenecks, and ship faster.`;
+    description && description.length >= 25
+      ? truncateWordBoundary(description, 160)
+      : `${cleanName} (${domain}) — web application and online workspace available at ${origin}.`;
 
   const featureBullets =
     h2List.length >= 2
       ? h2List.slice(0, 4).map((h) => `- **${h}**`).join("\n")
       : [
-          `- **Instant Setup**: Point ${cleanName} at your live workflow and start in under 60 seconds.`,
-          `- **Automated Execution**: Replaces repetitive manual checklists with deterministic automation.`,
-          `- **Built for Builders**: Clean CLI and web workspace designed for high-velocity shipping.`
+          `- **Web Workspace**: Access ${cleanName} directly at ${origin}.`,
+          `- **Focused Workflow**: Built for teams and individuals using ${domain}.`
         ].join("\n");
 
   const utmUrl = `${origin}/?utm_source=postbuild&utm_medium=directory&utm_campaign=${slug}_launch`;
-  const categories = inferCategories(`${cleanName} ${cleanTagline} ${shortPitch} ${h1List.join(" ")} ${h2List.join(" ")}`);
+  const categories = inferCategories(`${description || ""} ${h1List.join(" ")} ${h2List.join(" ")}`);
 
   const longDescription = `${cleanName} — ${cleanTagline}
 
@@ -305,33 +333,34 @@ Try it live: ${utmUrl}`;
   };
 }
 
-function generatePseoPages(origin, slug, cleanName) {
+export function generatePseoPages(origin, slug, cleanName) {
+  const isPostbuildSelf = slug === "postbuild";
   const templates = [
-    { path: `/use-cases/${slug}-for-solo-founders`, keyword: `${slug} workflow for solo founders`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "Transactional" },
-    { path: `/use-cases/${slug}-automation-guide`, keyword: `how to automate tasks with ${cleanName}`, category: "Use Case", schema: "HowTo + FAQPage", intent: "High Intent" },
-    { path: `/compare/${slug}-vs-manual-workflow`, keyword: `${cleanName} vs manual workflow`, category: "Comparison", schema: "Article + FAQPage", intent: "Comparison" },
-    { path: `/templates/${slug}-starter-kit`, keyword: `${slug} starter template & configuration`, category: "Template", schema: "SoftwareSourceCode", intent: "Lead Magnet" },
-    { path: `/alternatives/best-${slug}-alternatives-2026`, keyword: `${slug} workflow comparison guide`, category: "Comparison", schema: "ItemList + FAQPage", intent: "Comparison" },
-    { path: `/calculators/${slug}-roi-calculator`, keyword: `${slug} time & cost estimator`, category: "Calculator", schema: "WebApplication", intent: "Interactive" },
-    { path: `/guides/${slug}-api-integration`, keyword: `connect ${cleanName} to webhook & API`, category: "Guide", schema: "TechArticle", intent: "Developer" },
-    { path: `/use-cases/${slug}-for-agencies`, keyword: `${slug} multi-project workflow`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "B2B" },
-    { path: `/checklists/${slug}-launch-checklist`, keyword: `complete ${slug} launch checklist`, category: "Checklist", schema: "HowTo + ItemList", intent: "Lead Magnet" },
-    { path: `/compare/${slug}-pricing-breakdown`, keyword: `${cleanName} pricing & plan breakdown`, category: "Comparison", schema: "Product + Offer", intent: "Bottom Funnel" },
-    { path: `/use-cases/${slug}-for-developers`, keyword: `${slug} CLI and developer workflow`, category: "Use Case", schema: "TechArticle", intent: "Transactional" },
-    { path: `/use-cases/${slug}-for-indie-hackers`, keyword: `${cleanName} for indie SaaS launches`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "Transactional" },
-    { path: `/compare/${slug}-vs-legacy-tools`, keyword: `migrating to ${cleanName}`, category: "Comparison", schema: "Article + FAQPage", intent: "Comparison" },
-    { path: `/guides/${slug}-programmatic-seo-setup`, keyword: `structured seo setup with ${cleanName}`, category: "Guide", schema: "TechArticle", intent: "High Intent" },
-    { path: `/templates/${slug}-nextjs-boilerplate`, keyword: `${slug} nextjs integration guide`, category: "Template", schema: "TechArticle", intent: "Developer" },
-    { path: `/use-cases/${slug}-for-saas-teams`, keyword: `${cleanName} for engineering teams`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "B2B" },
-    { path: `/guides/${slug}-stripe-checkout-guide`, keyword: `add self-serve checkout with ${cleanName}`, category: "Guide", schema: "HowTo + TechArticle", intent: "Transactional" },
-    { path: `/checklists/${slug}-seo-audit-checklist`, keyword: `technical seo audit checklist ${slug}`, category: "Checklist", schema: "ItemList + FAQPage", intent: "Lead Magnet" },
-    { path: `/calculators/${slug}-conversion-estimator`, keyword: `saas launch conversion estimator`, category: "Calculator", schema: "WebApplication", intent: "Interactive" },
-    { path: `/alternatives/${slug}-open-source-comparison`, keyword: `${cleanName} open source architecture`, category: "Comparison", schema: "TechArticle", intent: "Comparison" },
-    { path: `/use-cases/${slug}-for-product-hunt-launch`, keyword: `prepare product hunt launch with ${cleanName}`, category: "Use Case", schema: "HowTo + FAQPage", intent: "High Intent" },
-    { path: `/guides/${slug}-ai-search-indexing`, keyword: `configure OAI-SearchBot & PerplexityBot for ${slug}`, category: "Guide", schema: "TechArticle", intent: "High Intent" },
-    { path: `/templates/${slug}-directory-submission-kit`, keyword: `85 startup directory launch kit`, category: "Template", schema: "ItemList", intent: "Lead Magnet" },
-    { path: `/use-cases/${slug}-for-ai-wrappers`, keyword: `monetize ai apps with ${cleanName}`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "Transactional" },
-    { path: `/compare/${slug}-roi-case-study`, keyword: `${cleanName} technical launch breakdown`, category: "Walkthrough", schema: "Article", intent: "Bottom Funnel" }
+    { path: `/use-cases/${slug}-for-solo-founders`, keyword: `${cleanName} for Solo Founders — Setup & Workflow Guide`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "Transactional" },
+    { path: `/use-cases/${slug}-automation-guide`, keyword: `How to Streamline Daily Workflows with ${cleanName}`, category: "Use Case", schema: "HowTo + FAQPage", intent: "High Intent" },
+    { path: `/compare/${slug}-vs-manual-workflow`, keyword: `${cleanName} vs. Manual Workflows — Operational Comparison`, category: "Comparison", schema: "Article + FAQPage", intent: "Comparison" },
+    { path: `/templates/${slug}-starter-kit`, keyword: `${cleanName} Starter Checklist & Initial Configuration`, category: "Template", schema: "SoftwareSourceCode", intent: "Lead Magnet" },
+    { path: isPostbuildSelf ? `/alternatives/best-${slug}-alternatives-2026` : `/guides/${slug}-evaluation-criteria`, keyword: `How to Evaluate ${cleanName} & Workflow Approaches (2026)`, category: "Comparison", schema: "ItemList + FAQPage", intent: "Comparison" },
+    { path: isPostbuildSelf ? `/calculators/${slug}-roi-calculator` : `/calculators/${slug}-workflow-time-estimator`, keyword: `${cleanName} Workflow Time & Adoption Framework`, category: "Calculator", schema: "WebApplication", intent: "Interactive" },
+    { path: `/guides/${slug}-api-integration`, keyword: `Integrating ${cleanName} Into Your Team Stack`, category: "Guide", schema: "TechArticle", intent: "Developer" },
+    { path: `/use-cases/${slug}-for-agencies`, keyword: `${cleanName} for Agencies & Multi-Project Teams`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "B2B" },
+    { path: `/checklists/${slug}-launch-checklist`, keyword: `Complete ${cleanName} Rollout & Launch Checklist`, category: "Checklist", schema: "HowTo + ItemList", intent: "Lead Magnet" },
+    { path: isPostbuildSelf ? `/compare/${slug}-pricing-breakdown` : `/compare/${slug}-plan-evaluation`, keyword: `${cleanName} Plan Evaluation & Buyer Checklist`, category: "Comparison", schema: "Product + Offer", intent: "Bottom Funnel" },
+    { path: `/use-cases/${slug}-for-developers`, keyword: `${cleanName} for Developers & Technical Teams`, category: "Use Case", schema: "TechArticle", intent: "Transactional" },
+    { path: `/use-cases/${slug}-for-indie-hackers`, keyword: `${cleanName} for Indie SaaS Founders & Bootstrappers`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "Transactional" },
+    { path: `/compare/${slug}-vs-legacy-tools`, keyword: `Transitioning to ${cleanName} from Legacy Processes`, category: "Comparison", schema: "Article + FAQPage", intent: "Comparison" },
+    { path: `/guides/${slug}-programmatic-seo-setup`, keyword: `Structured Technical SEO Setup with ${cleanName}`, category: "Guide", schema: "TechArticle", intent: "High Intent" },
+    { path: isPostbuildSelf ? `/templates/${slug}-nextjs-boilerplate` : `/templates/${slug}-deployment-guide`, keyword: `${cleanName} Modern Web Workflow & Deployment Guide`, category: "Template", schema: "TechArticle", intent: "Developer" },
+    { path: `/use-cases/${slug}-for-saas-teams`, keyword: `${cleanName} for Product & Engineering Teams`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "B2B" },
+    { path: isPostbuildSelf ? `/guides/${slug}-stripe-checkout-guide` : `/guides/${slug}-onboarding-workflow`, keyword: `Self-Serve Onboarding Workflow with ${cleanName}`, category: "Guide", schema: "HowTo + TechArticle", intent: "Transactional" },
+    { path: `/checklists/${slug}-seo-audit-checklist`, keyword: `Technical Readiness & Audit Checklist for ${cleanName}`, category: "Checklist", schema: "ItemList + FAQPage", intent: "Lead Magnet" },
+    { path: `/calculators/${slug}-conversion-estimator`, keyword: `${cleanName} Funnel & Adoption Review Framework`, category: "Calculator", schema: "WebApplication", intent: "Interactive" },
+    { path: isPostbuildSelf ? `/alternatives/${slug}-open-source-comparison` : `/guides/${slug}-managed-vs-diy`, keyword: `${cleanName} Managed Workflow vs. DIY Maintenance`, category: "Comparison", schema: "TechArticle", intent: "Comparison" },
+    { path: `/use-cases/${slug}-for-product-hunt-launch`, keyword: `Preparing a Product Launch with ${cleanName}`, category: "Use Case", schema: "HowTo + FAQPage", intent: "High Intent" },
+    { path: `/guides/${slug}-ai-search-indexing`, keyword: `Configuring AI Search Indexing (ChatGPT & Perplexity) for ${cleanName}`, category: "Guide", schema: "TechArticle", intent: "High Intent" },
+    { path: `/templates/${slug}-directory-submission-kit`, keyword: `${cleanName} Distribution & Directory Launch Kit`, category: "Template", schema: "ItemList", intent: "Lead Magnet" },
+    { path: `/use-cases/${slug}-for-ai-wrappers`, keyword: `Shipping & Scaling AI Applications with ${cleanName}`, category: "Use Case", schema: "FAQPage + SoftwareApplication", intent: "Transactional" },
+    { path: isPostbuildSelf ? `/compare/${slug}-roi-case-study` : `/compare/${slug}-architecture-walkthrough`, keyword: `${cleanName} Architecture & Implementation Walkthrough`, category: "Walkthrough", schema: "Article", intent: "Bottom Funnel" }
   ];
 
   return templates.map((t, idx) => ({
@@ -339,6 +368,8 @@ function generatePseoPages(origin, slug, cleanName) {
     url: `${origin}${t.path}`,
     path: t.path,
     keyword: t.keyword,
+    category: t.category,
+    schemaType: t.schema,
     volume: t.category,
     kd: t.schema,
     intent: t.intent,
@@ -348,6 +379,7 @@ 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");
 
   const routeEntries = pseoPages
     .map(
@@ -360,7 +392,17 @@ function generateArtifacts(origin, slug, cleanName, description, pseoPages) {
     )
     .join("\n");
 
-  const sitemapXml = `<?xml version="1.0" encoding="UTF-8"?>
+  const rootSitemapXml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>${origin}/</loc>
+    <lastmod>${today}</lastmod>
+    <changefreq>daily</changefreq>
+    <priority>1.0</priority>
+  </url>
+</urlset>`;
+
+  const sitemapAllRoutesXml = `<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>${origin}/</loc>
@@ -371,6 +413,8 @@ function generateArtifacts(origin, slug, cleanName, description, pseoPages) {
 ${routeEntries}
 </urlset>`;
 
+  const sitemapXml = isPostbuildSelf ? sitemapAllRoutesXml : rootSitemapXml;
+
   const robotsTxt = `User-agent: *
 Allow: /
 
@@ -384,7 +428,6 @@ Allow: /
 
 Sitemap: ${origin}/sitemap.xml`;
 
-  const isPostbuildSelf = origin.includes("postbuild.dev");
   const offersBlock = isPostbuildSelf
     ? `,\n  "offers": {\n    "@type": "Offer",\n    "price": "29.00",\n    "priceCurrency": "USD"\n  }`
     : "";
@@ -453,7 +496,7 @@ export function CheckoutGate({ priceId = "price_YOUR_STRIPE_PRICE_ID", label = "
 //   res.status(200).json({ ok: true, checkoutUrl: session.url });
 // }`;
 
-  return { sitemapXml, robotsTxt, jsonLd, paywallCode };
+  return { sitemapXml, rootSitemapXml, sitemapAllRoutesXml, robotsTxt, jsonLd, paywallCode };
 }
 
 export const INDEXNOW_KEY = "pb7f9a2e4c8b1d6f3a5e0c9b2d4f6a8e";
@@ -533,6 +576,7 @@ export async function dispatchDirectories({ targetUrl = "https://www.postbuild.d
     category: dir.category,
     dr: dir.dr,
     authType: dir.authType,
+    prefillMode: dir.prefillMode || "clipboard_form",
     autoSubmit: Boolean(dir.autoSubmit),
     submissionUrl: dir.url,
     prefilledUrl: dir.prefilledUrl,

package/lib/fixer.js

@@ -25,113 +25,155 @@ export function detectPublicDir(cwd = process.cwd()) {
   return { framework, publicDir };
 }
 
+export function buildOgCardSvg(brandName = "Web Application", domain = "example.com", tagline = "") {
+  const esc = (s) =>
+    String(s || "")
+      .replace(/&/g, "&")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;")
+      .replace(/"/g, "&quot;");
+  const sub = tagline && tagline.toLowerCase() !== brandName.toLowerCase() ? tagline.slice(0, 72) : domain;
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630">
+  <rect width="1200" height="630" fill="#F8FAFC" />
+  <rect x="48" y="48" width="1104" height="534" rx="28" fill="#FFFFFF" stroke="#E2E8F0" stroke-width="2" />
+  <text x="108" y="270" fill="#0F172A" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, Inter, sans-serif" font-size="64" font-weight="800">${esc(brandName.slice(0, 32))}</text>
+  <text x="108" y="346" fill="#475569" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, Inter, sans-serif" font-size="30" font-weight="500">${esc(sub)}</text>
+  <text x="108" y="488" fill="#047857" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="24" font-weight="700">${esc(domain)}</text>
+</svg>
+`;
+}
+
 export function buildLlmsTxt(report) {
   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 lines = [
-    `# ${kit.brandName || kit.productName || report.domain}`,
+    `# ${brand}`,
     ``,
-    `> ${kit.tagline || report.meta?.description || "Software platform and developer workflow tool."}`,
+    `> ${tagline}`,
     ``,
     `- Canonical URL: ${report.targetUrl}`,
-    `- Verification & Press Contact: ${report.botEmail}`,
-    `- Category: ${kit.categories ? kit.categories.join(", ") : "Developer Tools, SaaS"}`,
+    `- Contact: ${report.botEmail}`,
+    `- Category: ${kit.categories && kit.categories.length ? kit.categories.join(", ") : "Web Application"}`,
     ``,
     `## Overview`,
-    `${kit.shortPitch || kit.longDescription || ""}`,
+    `${kit.shortPitch || kit.longDescription || `${brand} at ${report.targetUrl}`}`,
     ``,
-    `## Key Comparison & Programmatic SEO Guides`,
-    ...(report.pseoPages || []).slice(0, 15).map(
-      (p) => `- [${p.keyword || p.path}](${report.targetUrl.replace(/\/$/, "")}${p.path || p.slug}): ${p.intent} guide (${p.volume || p.estMonthlySearches})`
+    `## 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"}`
     ),
     ``
   ];
   return lines.join("\n");
 }
 
-export function buildHeadSeoSnippet(report) {
-  const title = report.launchKit?.tagline
-    ? `${report.launchKit.brandName || report.launchKit.productName || report.domain} — ${report.launchKit.tagline}`
-    : report.meta?.title || report.domain;
-  const desc = report.launchKit?.shortPitch || report.meta?.description || "";
+export function buildHeadSeoSnippet(report, verificationToken = "") {
+  const brand = report.launchKit?.brandName || report.launchKit?.productName || report.domain;
+  const tagline = report.launchKit?.tagline || "";
+  const title =
+    tagline && tagline.toLowerCase() !== brand.toLowerCase() && !tagline.includes(report.domain)
+      ? `${brand} — ${tagline}`
+      : 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(/\/$/, "");
-  return `<!-- Generated by postbuild (git paid fix) for ${report.domain} -->
+  const ogImg = report.ogImage || `${cleanOrigin}/og-card.svg`;
+  const verifyTag =
+    verificationToken || report.verificationToken
+      ? `\n<!-- Domain Ownership Verification -->\n<meta name="postbuild-verification" content="${verificationToken || report.verificationToken}" />\n`
+      : "";
+  return `<!-- SEO & OpenGraph <head> tags for ${report.domain} -->
 <title>${title}</title>
 <meta name="description" content="${desc.replace(/"/g, "&quot;")}" />
-<link rel="canonical" href="${report.targetUrl}" />
-
+<link rel="canonical" href="${report.targetUrl}" />${verifyTag}
 <!-- OpenGraph / Social Cards -->
 <meta property="og:type" content="website" />
-<meta property="og:site_name" content="${report.launchKit?.brandName || report.launchKit?.productName || report.domain}" />
+<meta property="og:site_name" content="${brand.replace(/"/g, "&quot;")}" />
 <meta property="og:title" content="${title.replace(/"/g, "&quot;")}" />
 <meta property="og:description" content="${desc.replace(/"/g, "&quot;")}" />
 <meta property="og:url" content="${report.targetUrl}" />
-<meta property="og:image" content="${cleanOrigin}/og-card.png" />
+<meta property="og:image" content="${ogImg.replace(/"/g, "&quot;")}" />
 <meta name="twitter:card" content="summary_large_image" />
 <meta name="twitter:title" content="${title.replace(/"/g, "&quot;")}" />
 <meta name="twitter:description" content="${desc.replace(/"/g, "&quot;")}" />
-<meta name="twitter:image" content="${cleanOrigin}/og-card.png" />
+<meta name="twitter:image" content="${ogImg.replace(/"/g, "&quot;")}" />
 
 <!-- Structured Data (JSON-LD) -->
 ${report.artifacts?.jsonLd || ""}
 `;
 }
 
-export function buildStartHereMd(report) {
+export function buildStartHereMd(report, verificationToken = "") {
   const domain = report.domain || "your-project.com";
   const brand = report.launchKit?.brandName || report.launchKit?.productName || domain;
   const botEmail = report.botEmail || `${domain.replace(/\./g, "-")}-bot@postbuild.dev`;
+  const token = verificationToken || report.verificationToken || "";
   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 quick steps:
+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:
 
 ---
 
-## Step 1: Drop the SEO & AI Crawler Files Into Your App (60 Seconds)
+## Step 1: Drop the SEO, AI Crawler & Verification Files Into Your App
 
 Upload or drag this folder into your AI builder (Lovable, Bolt, Replit, Cursor, Claude Code) and paste this exact prompt:
 
 > **Copy & Paste Prompt for Your AI Builder:**
 > \`\`\`text
-> Please add the Postbuild SEO & AI Launch files to my project:
-> 1. Place robots.txt, sitemap.xml, and llms.txt into my static public/ folder so they are served at /robots.txt, /sitemap.xml, and /llms.txt.
-> 2. Copy the meta tags, canonical link, OpenGraph tags, and JSON-LD structured data from head-seo-snippet.html into my main HTML <head> (or root layout metadata).
-> 3. Place the 25 pre-rendered static HTML guides (under guides/, comparisons/, use-cases/, checklists/) into public/ so those routes resolve cleanly.
+> 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.
+> 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).
 > \`\`\`
 
+> **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\`.
+
 ---
 
-## Step 2: Submit to Curated Startup & AI Directories (No Personal Inbox Spam)
+## Step 2: Verify Domain Ownership on postbuild.dev (Unlocks Your \`@postbuild.dev\` Inbox)
 
-1. Open \`directories-85.csv\` (or the **85 Directories** 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 **85 Directories** tab to your browser bookmarks bar and click it on any directory page to fill the form automatically.
-4. **Always use your dedicated verification email** when a directory asks for an email address:
-   \`${botEmail}\`
+Before submitting to directories with \`${botEmail}\`, confirm your inbox is unlocked:
+
+1. Deploy the Step 1 changes to \`https://${domain}\` (so \`https://${domain}/.well-known/postbuild-verify.txt\` or your \`<meta name="postbuild-verification">\` tag is live).
+2. Open **\`https://www.postbuild.dev\` → Account tab** and click **Verify Domain Now**${token ? ` (your verification token is \`${token}\`)` : ""}.
+3. Keep the verification file or meta tag in place so your \`${botEmail}\` inbox stays unlocked for all future visits.
 
 ---
 
-## Step 3: Verify Directory Emails in 1 Click
+## Step 3: Submit to 85 Curated Startup & AI Directories (No Personal Inbox Spam)
 
-1. Every confirmation email or 6-digit OTP code sent to \`${botEmail}\` arrives in your **Account & Verification Inbox** on \`https://www.postbuild.dev\`.
-2. Click **Auto-Verify Links** (or copy the 1-click OTP badge) to confirm your listings without cluttering your personal inbox.
+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\`.
 
 ---
 
 ### Files Included in This Bundle
 - \`START_HERE.md\` — This 3-step quickstart guide + copy-paste AI builder prompt
-- \`public/robots.txt\` — Search & AI crawler rules (GPTBot, ClaudeBot, PerplexityBot)
-- \`public/sitemap.xml\` — XML Sitemap indexing your main URL + 25 programmatic SEO guides
+- \`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
 - \`public/llms.txt\` — Structured markdown manifest for ChatGPT Search, Claude, and Perplexity
-- \`head-seo-snippet.html\` — Title, meta description, OpenGraph social tags, and Schema.org JSON-LD
+- \`public/og-card.svg\` — Social preview card fallback image
+- \`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
-- \`public/{use-cases,comparisons,guides,checklists}/*.html\` — 25 static HTML SEO landing pages
+- \`.postbuild/pseo/{use-cases,compare,guides,checklists,templates,calculators}/**/index.html\` — Starter static HTML SEO drafts to review before publishing
 `;
 }
 
 export function applyLocalSeoFixes(report, options = {}) {
   const cwd = options.cwd || process.cwd();
   const overwritePublic = Boolean(options.overwritePublic);
+  const publishPseoToPublic = Boolean(options.publishPseoToPublic);
+  const verificationToken = options.verificationToken || report.verificationToken || "";
   const { framework, publicDir } = detectPublicDir(cwd);
   fs.mkdirSync(publicDir, { recursive: true });
 
@@ -142,9 +184,36 @@ export function applyLocalSeoFixes(report, options = {}) {
 
   // 0. START_HERE.md in .postbuild/
   const startHerePath = path.join(outDir, "START_HERE.md");
-  fs.writeFileSync(startHerePath, buildStartHereMd(report), "utf8");
+  fs.writeFileSync(startHerePath, buildStartHereMd(report, verificationToken), "utf8");
   writtenFiles.push({ path: path.relative(cwd, startHerePath), role: "3-Step Non-Technical Quickstart & AI Builder Prompt (START_HERE.md)" });
 
+  // 0b. .well-known/postbuild-verify.txt in public/ and .postbuild/ when verificationToken is available
+  if (verificationToken) {
+    const publicWellKnownDir = path.join(publicDir, ".well-known");
+    fs.mkdirSync(publicWellKnownDir, { recursive: true });
+    const publicVerifyPath = path.join(publicWellKnownDir, "postbuild-verify.txt");
+    fs.writeFileSync(publicVerifyPath, `${verificationToken}\n`, "utf8");
+    writtenFiles.push({ path: path.relative(cwd, publicVerifyPath), role: "Domain Ownership Verification File (.well-known/postbuild-verify.txt)" });
+
+    const outWellKnownDir = path.join(outDir, ".well-known");
+    fs.mkdirSync(outWellKnownDir, { recursive: true });
+    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)
+  const ogSvgPath = path.join(publicDir, "og-card.svg");
+  const ogPngPath = path.join(publicDir, "og-card.png");
+  const ogSvgContent = buildOgCardSvg(
+    report.cleanName || report.launchKit?.productName || report.domain,
+    report.domain,
+    report.launchKit?.tagline || ""
+  );
+  if (!fs.existsSync(ogSvgPath) && !fs.existsSync(ogPngPath)) {
+    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.svg"), ogSvgContent, "utf8");
+
   // 1. robots.txt in public/ (if missing or overwritePublic)
   const robotsPath = path.join(publicDir, "robots.txt");
   if (!fs.existsSync(robotsPath) || overwritePublic) {
@@ -152,11 +221,14 @@ export function applyLocalSeoFixes(report, options = {}) {
     writtenFiles.push({ path: path.relative(cwd, robotsPath), role: "AI + Search Crawler Rules (robots.txt)" });
   }
 
-  // 2. sitemap.xml in public/ (if missing or overwritePublic)
+  // 2. sitemap.xml in public/ (root URL only by default unless publishPseoToPublic or postbuild.dev)
   const sitemapPath = path.join(publicDir, "sitemap.xml");
+  const rootSitemapXml = report.artifacts.rootSitemapXml || report.artifacts.sitemapXml;
+  const fullSitemapXml = report.artifacts.sitemapAllRoutesXml || report.artifacts.sitemapXml;
   if (!fs.existsSync(sitemapPath) || overwritePublic) {
-    fs.writeFileSync(sitemapPath, report.artifacts.sitemapXml, "utf8");
-    writtenFiles.push({ path: path.relative(cwd, sitemapPath), role: "XML Sitemap with 25 pSEO Routes" });
+    const publicSitemapContent = publishPseoToPublic || report.domain === "postbuild.dev" ? fullSitemapXml : rootSitemapXml;
+    fs.writeFileSync(sitemapPath, publicSitemapContent, "utf8");
+    writtenFiles.push({ path: path.relative(cwd, sitemapPath), role: "XML Sitemap (sitemap.xml)" });
   }
 
   // 3. llms.txt in public/ for AI Answer Engines (ChatGPT, Claude, Perplexity)
@@ -169,11 +241,11 @@ export function applyLocalSeoFixes(report, options = {}) {
 
   // 4. Complete .postbuild bundle
   const headSnippetPath = path.join(outDir, "head-seo-snippet.html");
-  fs.writeFileSync(headSnippetPath, buildHeadSeoSnippet(report), "utf8");
+  fs.writeFileSync(headSnippetPath, buildHeadSeoSnippet(report, verificationToken), "utf8");
   writtenFiles.push({ path: path.relative(cwd, headSnippetPath), role: "OpenGraph + Canonical + JSON-LD <head> Snippet" });
 
-  const sitemapOut = path.join(outDir, "sitemap.xml");
-  fs.writeFileSync(sitemapOut, report.artifacts.sitemapXml, "utf8");
+  const sitemapOut = path.join(outDir, "sitemap-starter-routes.xml");
+  fs.writeFileSync(sitemapOut, fullSitemapXml, "utf8");
 
   const robotsOut = path.join(outDir, "robots.txt");
   fs.writeFileSync(robotsOut, report.artifacts.robotsTxt, "utf8");
@@ -187,27 +259,31 @@ export function applyLocalSeoFixes(report, options = {}) {
 
   const pseoJsonOut = path.join(outDir, "pseo-routes.json");
   fs.writeFileSync(pseoJsonOut, JSON.stringify(report.pseoPages, null, 2), "utf8");
-  writtenFiles.push({ path: path.relative(cwd, pseoJsonOut), role: "25 Programmatic SEO Route Definitions (JSON)" });
+  writtenFiles.push({ path: path.relative(cwd, pseoJsonOut), role: "Programmatic SEO Route Definitions (JSON)" });
 
-  // Render the 25 static HTML landing pages into .postbuild/pseo (and public/ if overwritePublic)
+  // Render the starter HTML landing pages into .postbuild/pseo (and public/ only if explicitly requested via publishPseoToPublic)
   const pseoOutDir = path.join(outDir, "pseo");
   const pseoRenderOpts = {
     origin: report.targetUrl,
     cleanName: report.cleanName || report.launchKit?.productName || report.domain,
-    domain: report.domain
+    domain: report.domain,
+    tagline: report.launchKit?.tagline || "",
+    shortPitch: report.launchKit?.shortPitch || "",
+    categories: report.launchKit?.categories || [],
+    ogImage: report.ogImage || ""
   };
   const renderedPseo = writePseoHtmlFiles(report.pseoPages || [], pseoOutDir, pseoRenderOpts);
   writtenFiles.push({
     path: path.relative(cwd, pseoOutDir),
-    role: `${renderedPseo.length} Static Programmatic SEO HTML Landing Pages`
+    role: `${renderedPseo.length} Starter Static SEO HTML Drafts (review & copy selected routes to public/)`
   });
 
-  if (overwritePublic) {
+  if (publishPseoToPublic) {
     writePseoHtmlFiles(report.pseoPages || [], publicDir, pseoRenderOpts);
   }
 
   const launchKitOut = path.join(outDir, "launch-kit.md");
-  fs.writeFileSync(launchKitOut, report.launchKit.longDescription, "utf8");
+  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