indxel-cli 0.1.0

package/dist/index.js

@@ -0,0 +1,1136 @@
+// src/index.ts
+import { Command as Command5 } from "commander";
+
+// src/commands/init.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { writeFile } from "fs/promises";
+import { join as join2 } from "path";
+
+// src/detect.ts
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import { join } from "path";
+async function detectProject(cwd) {
+  const info = {
+    root: cwd,
+    isNextJs: false,
+    usesAppRouter: false,
+    appDir: "app",
+    isTypeScript: false,
+    hasSeoConfig: false,
+    hasSitemap: false,
+    hasRobots: false
+  };
+  const nextConfigs = [
+    "next.config.ts",
+    "next.config.js",
+    "next.config.mjs",
+    "next.config.cjs"
+  ];
+  info.isNextJs = nextConfigs.some((f) => existsSync(join(cwd, f)));
+  const pkgPath = join(cwd, "package.json");
+  if (existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
+      const nextDep = pkg.dependencies?.next ?? pkg.devDependencies?.next;
+      if (nextDep) {
+        info.isNextJs = true;
+        info.nextVersion = nextDep.replace(/[\^~>=<]/g, "").trim();
+      }
+    } catch {
+    }
+  }
+  info.isTypeScript = existsSync(join(cwd, "tsconfig.json")) || existsSync(join(cwd, "tsconfig.ts"));
+  if (existsSync(join(cwd, "src", "app"))) {
+    info.usesAppRouter = true;
+    info.appDir = "src/app";
+  } else if (existsSync(join(cwd, "app"))) {
+    info.usesAppRouter = true;
+    info.appDir = "app";
+  }
+  info.hasSeoConfig = existsSync(join(cwd, "seo.config.ts")) || existsSync(join(cwd, "seo.config.js"));
+  info.hasSitemap = existsSync(join(cwd, info.appDir, "sitemap.ts")) || existsSync(join(cwd, info.appDir, "sitemap.js")) || existsSync(join(cwd, info.appDir, "sitemap.xml"));
+  info.hasRobots = existsSync(join(cwd, info.appDir, "robots.ts")) || existsSync(join(cwd, info.appDir, "robots.js")) || existsSync(join(cwd, info.appDir, "robots.txt"));
+  return info;
+}
+
+// src/templates.ts
+function seoConfigTemplate(isTypeScript) {
+  if (isTypeScript) {
+    return `import { defineSEO } from 'indxel'
+
+export default defineSEO({
+  siteName: 'My Site',
+  siteUrl: 'https://example.com',
+  titleTemplate: '%s | My Site',
+  defaultDescription: 'A short description of your site for search engines.',
+  defaultOGImage: '/og-image.png',
+  locale: 'en_US',
+  // twitter: {
+  //   handle: '@yourhandle',
+  //   cardType: 'summary_large_image',
+  // },
+  // organization: {
+  //   name: 'My Company',
+  //   logo: '/logo.png',
+  //   url: 'https://example.com',
+  // },
+})
+`;
+  }
+  return `const { defineSEO } = require('indxel')
+
+module.exports = defineSEO({
+  siteName: 'My Site',
+  siteUrl: 'https://example.com',
+  titleTemplate: '%s | My Site',
+  defaultDescription: 'A short description of your site for search engines.',
+  defaultOGImage: '/og-image.png',
+  locale: 'en_US',
+})
+`;
+}
+function sitemapTemplate(isTypeScript) {
+  if (isTypeScript) {
+    return `import type { MetadataRoute } from 'next'
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const baseUrl = 'https://example.com'
+
+  return [
+    {
+      url: baseUrl,
+      lastModified: new Date(),
+      changeFrequency: 'weekly',
+      priority: 1,
+    },
+    // Add more pages here or generate dynamically:
+    //
+    // const posts = await getPosts()
+    // return posts.map(post => ({
+    //   url: \`\${baseUrl}/blog/\${post.slug}\`,
+    //   lastModified: post.updatedAt,
+    //   changeFrequency: 'monthly',
+    //   priority: 0.7,
+    // }))
+  ]
+}
+`;
+  }
+  return `/** @returns {import('next').MetadataRoute.Sitemap} */
+export default function sitemap() {
+  const baseUrl = 'https://example.com'
+
+  return [
+    {
+      url: baseUrl,
+      lastModified: new Date(),
+      changeFrequency: 'weekly',
+      priority: 1,
+    },
+  ]
+}
+`;
+}
+function robotsTemplate(isTypeScript) {
+  if (isTypeScript) {
+    return `import type { MetadataRoute } from 'next'
+
+export default function robots(): MetadataRoute.Robots {
+  const baseUrl = 'https://example.com'
+
+  return {
+    rules: [
+      {
+        userAgent: '*',
+        allow: '/',
+        disallow: ['/api/', '/private/'],
+      },
+    ],
+    sitemap: \`\${baseUrl}/sitemap.xml\`,
+  }
+}
+`;
+  }
+  return `/** @returns {import('next').MetadataRoute.Robots} */
+export default function robots() {
+  const baseUrl = 'https://example.com'
+
+  return {
+    rules: [
+      {
+        userAgent: '*',
+        allow: '/',
+        disallow: ['/api/', '/private/'],
+      },
+    ],
+    sitemap: \`\${baseUrl}/sitemap.xml\`,
+  }
+}
+`;
+}
+
+// src/commands/init.ts
+var initCommand = new Command("init").description("Initialize indxel in your Next.js project").option("--cwd <path>", "Project directory", process.cwd()).option("--force", "Overwrite existing files", false).action(async (opts) => {
+  const cwd = opts.cwd;
+  const spinner = ora("Detecting project...").start();
+  const project = await detectProject(cwd);
+  if (!project.isNextJs) {
+    spinner.fail("Not a Next.js project");
+    console.log(
+      chalk.dim("  indxel currently supports Next.js projects only.")
+    );
+    console.log(
+      chalk.dim("  Make sure you're in a directory with a next.config file.")
+    );
+    process.exit(1);
+  }
+  spinner.succeed(
+    `Detected Next.js ${project.nextVersion ?? ""} (${project.usesAppRouter ? "App Router" : "Pages Router"})`
+  );
+  const ext = project.isTypeScript ? "ts" : "js";
+  const filesCreated = [];
+  if (!project.hasSeoConfig || opts.force) {
+    const configPath = join2(cwd, `seo.config.${ext}`);
+    await writeFile(configPath, seoConfigTemplate(project.isTypeScript), "utf-8");
+    filesCreated.push(`seo.config.${ext}`);
+    console.log(chalk.green("  \u2713") + ` Generated seo.config.${ext}`);
+  } else {
+    console.log(chalk.dim(`  - seo.config.${ext} already exists (skip)`));
+  }
+  if (!project.hasSitemap || opts.force) {
+    const sitemapPath = join2(cwd, project.appDir, `sitemap.${ext}`);
+    await writeFile(sitemapPath, sitemapTemplate(project.isTypeScript), "utf-8");
+    filesCreated.push(`${project.appDir}/sitemap.${ext}`);
+    console.log(chalk.green("  \u2713") + ` Generated ${project.appDir}/sitemap.${ext}`);
+  } else {
+    console.log(chalk.dim(`  - sitemap already exists (skip)`));
+  }
+  if (!project.hasRobots || opts.force) {
+    const robotsPath = join2(cwd, project.appDir, `robots.${ext}`);
+    await writeFile(robotsPath, robotsTemplate(project.isTypeScript), "utf-8");
+    filesCreated.push(`${project.appDir}/robots.${ext}`);
+    console.log(chalk.green("  \u2713") + ` Generated ${project.appDir}/robots.${ext}`);
+  } else {
+    console.log(chalk.dim(`  - robots already exists (skip)`));
+  }
+  console.log("");
+  if (filesCreated.length > 0) {
+    console.log(
+      chalk.bold(`  ${filesCreated.length} file${filesCreated.length > 1 ? "s" : ""} created.`)
+    );
+  } else {
+    console.log(chalk.dim("  Nothing to create \u2014 all files already exist."));
+    console.log(chalk.dim("  Use --force to overwrite."));
+  }
+  console.log("");
+  console.log(chalk.dim("  Next steps:"));
+  console.log(chalk.dim(`    1. Edit seo.config.${ext} with your site details`));
+  console.log(chalk.dim("    2. Run ") + chalk.bold("npx indxel check") + chalk.dim(" to audit your pages"));
+  console.log("");
+});
+
+// src/commands/check.ts
+import { Command as Command2 } from "commander";
+import chalk3 from "chalk";
+import ora2 from "ora";
+import { validateMetadata } from "indxel";
+
+// src/scanner.ts
+import { readFile as readFile2 } from "fs/promises";
+import { join as join3, dirname, sep } from "path";
+import { glob } from "glob";
+async function scanPages(projectRoot, appDir) {
+  const appDirFull = join3(projectRoot, appDir);
+  const pageFiles = await glob("**/page.{tsx,ts,jsx,js}", {
+    cwd: appDirFull,
+    ignore: ["**/node_modules/**", "**/_*/**"]
+  });
+  const pages = [];
+  for (const file of pageFiles) {
+    const fullPath = join3(appDirFull, file);
+    const content = await readFile2(fullPath, "utf-8");
+    const route = filePathToRoute(file);
+    const page = {
+      filePath: join3(appDir, file),
+      route,
+      hasMetadata: false,
+      hasDynamicMetadata: false,
+      extractedMetadata: createEmptyMetadata()
+    };
+    page.hasDynamicMetadata = hasExport(content, "generateMetadata");
+    page.hasMetadata = page.hasDynamicMetadata || hasExport(content, "metadata");
+    page.extractedMetadata = extractStaticMetadata(content);
+    pages.push(page);
+  }
+  const layoutFiles = await glob("**/layout.{tsx,ts,jsx,js}", {
+    cwd: appDirFull,
+    ignore: ["**/node_modules/**", "**/_*/**"]
+  });
+  for (const file of layoutFiles) {
+    const fullPath = join3(appDirFull, file);
+    const content = await readFile2(fullPath, "utf-8");
+    const route = filePathToRoute(file).replace(/\/layout$/, "") || "/";
+    const hasMetadataExport = hasExport(content, "metadata") || hasExport(content, "generateMetadata");
+    if (hasMetadataExport) {
+      const layoutMeta = extractStaticMetadata(content);
+      for (const page of pages) {
+        if (page.route.startsWith(route) || route === "/") {
+          mergeMetadata(page.extractedMetadata, layoutMeta);
+          if (!page.hasMetadata) {
+            page.hasMetadata = true;
+          }
+        }
+      }
+    }
+  }
+  return pages.sort((a, b) => a.route.localeCompare(b.route));
+}
+function filePathToRoute(filePath) {
+  const dir = dirname(filePath);
+  if (dir === ".") return "/";
+  const route = "/" + dir.split(sep).join("/");
+  return route.replace(/\/\([^)]+\)/g, "") || "/";
+}
+function hasExport(source, name) {
+  const patterns = [
+    new RegExp(`export\\s+(const|let|var)\\s+${name}\\b`),
+    new RegExp(`export\\s+(async\\s+)?function\\s+${name}\\b`),
+    new RegExp(`export\\s+\\{[^}]*\\b${name}\\b[^}]*\\}`)
+  ];
+  return patterns.some((p) => p.test(source));
+}
+function extractStaticMetadata(source) {
+  const meta = createEmptyMetadata();
+  const titleMatch = source.match(
+    /title\s*:\s*(?:["'`]([^"'`]+)["'`]|`([^`]*)`)/
+  );
+  if (titleMatch) {
+    meta.title = titleMatch[1] ?? titleMatch[2] ?? null;
+  }
+  const descMatch = source.match(
+    /description\s*:\s*(?:["'`]([^"'`]+)["'`]|`([^`]*)`)/
+  );
+  if (descMatch) {
+    meta.description = descMatch[1] ?? descMatch[2] ?? null;
+  }
+  if (/openGraph\s*:\s*\{/.test(source)) {
+    const ogTitleMatch = source.match(
+      /openGraph\s*:\s*\{[^}]*title\s*:\s*["'`]([^"'`]+)["'`]/s
+    );
+    if (ogTitleMatch) meta.ogTitle = ogTitleMatch[1];
+    const ogDescMatch = source.match(
+      /openGraph\s*:\s*\{[^}]*description\s*:\s*["'`]([^"'`]+)["'`]/s
+    );
+    if (ogDescMatch) meta.ogDescription = ogDescMatch[1];
+    if (/images\s*:\s*\[/.test(source)) {
+      meta.ogImage = "[detected]";
+    }
+  }
+  if (/twitter\s*:\s*\{/.test(source)) {
+    const cardMatch = source.match(
+      /card\s*:\s*["'`](summary|summary_large_image)["'`]/
+    );
+    if (cardMatch) meta.twitterCard = cardMatch[1];
+  }
+  if (/robots\s*:\s*\{/.test(source) || /robots\s*:\s*["'`]/.test(source)) {
+    const robotsMatch = source.match(
+      /robots\s*:\s*["'`]([^"'`]+)["'`]/
+    );
+    if (robotsMatch) meta.robots = robotsMatch[1];
+  }
+  if (/alternates\s*:\s*\{/.test(source)) {
+    const canonicalMatch = source.match(
+      /canonical\s*:\s*["'`]([^"'`]+)["'`]/
+    );
+    if (canonicalMatch) meta.canonical = canonicalMatch[1];
+  }
+  if (/application\/ld\+json/.test(source) || /generateLD/.test(source) || /JsonLD/.test(source)) {
+    meta.structuredData = [{ "@context": "https://schema.org", "@type": "detected" }];
+  }
+  if (/viewport\s*[:=]/.test(source)) {
+    meta.viewport = "detected";
+  }
+  if (/icons\s*:\s*\{/.test(source) || /favicon/.test(source)) {
+    meta.favicon = "detected";
+  }
+  return meta;
+}
+function createEmptyMetadata() {
+  return {
+    title: null,
+    description: null,
+    canonical: null,
+    ogTitle: null,
+    ogDescription: null,
+    ogImage: null,
+    ogType: null,
+    twitterCard: null,
+    twitterTitle: null,
+    twitterDescription: null,
+    robots: null,
+    alternates: null,
+    structuredData: null,
+    viewport: null,
+    favicon: null
+  };
+}
+function mergeMetadata(target, source) {
+  for (const key of Object.keys(source)) {
+    if (target[key] === null || target[key] === void 0) {
+      target[key] = source[key];
+    }
+  }
+}
+
+// src/formatter.ts
+import chalk2 from "chalk";
+function formatPageResult(result) {
+  const { page, validation } = result;
+  const lines = [];
+  const scoreColor = getScoreColor(validation.score);
+  const icon = validation.errors.length > 0 ? chalk2.red("x") : chalk2.green("\u2713");
+  lines.push(
+    `  ${icon} ${chalk2.bold(page.route)}  ${scoreColor(`${validation.score}/100`)}`
+  );
+  for (const error of validation.errors) {
+    lines.push(`    ${chalk2.red("x")} ${error.message ?? error.name}`);
+  }
+  if (validation.errors.length > 0) {
+    for (const warning of validation.warnings) {
+      lines.push(`    ${chalk2.yellow("!")} ${warning.message ?? warning.name}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatSummary(summary) {
+  const lines = [];
+  const { totalPages, passedPages, averageScore, criticalErrors } = summary;
+  lines.push("");
+  lines.push(chalk2.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  lines.push("");
+  const scoreColor = getScoreColor(averageScore);
+  lines.push(
+    `  Score: ${scoreColor(chalk2.bold(`${averageScore}/100`))} (${summary.grade})`
+  );
+  const pagesColor = passedPages === totalPages ? chalk2.green : chalk2.yellow;
+  lines.push(
+    `  Pages: ${pagesColor(`${passedPages}/${totalPages}`)} pass SEO validation`
+  );
+  if (criticalErrors > 0) {
+    lines.push("");
+    lines.push(
+      chalk2.red(`  ${criticalErrors} critical issue${criticalErrors > 1 ? "s" : ""}. Fix before deploying.`)
+    );
+  } else {
+    lines.push("");
+    lines.push(chalk2.green("  All pages pass. Ship it."));
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function formatJSON(summary) {
+  return JSON.stringify(
+    {
+      score: summary.averageScore,
+      grade: summary.grade,
+      totalPages: summary.totalPages,
+      passedPages: summary.passedPages,
+      criticalErrors: summary.criticalErrors,
+      pages: summary.results.map((r) => ({
+        route: r.page.route,
+        file: r.page.filePath,
+        score: r.validation.score,
+        grade: r.validation.grade,
+        errors: r.validation.errors.map((e) => ({
+          id: e.id,
+          message: e.message
+        })),
+        warnings: r.validation.warnings.map((w) => ({
+          id: w.id,
+          message: w.message
+        }))
+      }))
+    },
+    null,
+    2
+  );
+}
+function formatDiff(current, previous) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk2.bold("  SEO Diff:"));
+  lines.push("");
+  const scoreDelta = current.averageScore - previous.averageScore;
+  const scoreArrow = scoreDelta > 0 ? chalk2.green(`+${scoreDelta}`) : scoreDelta < 0 ? chalk2.red(`${scoreDelta}`) : chalk2.dim("0");
+  lines.push(
+    `  Score: ${previous.averageScore} -> ${current.averageScore} (${scoreArrow})`
+  );
+  lines.push("");
+  const prevMap = new Map(previous.results.map((r) => [r.page.route, r]));
+  const currMap = new Map(current.results.map((r) => [r.page.route, r]));
+  const regressions = [];
+  for (const [route, curr] of currMap) {
+    const prev = prevMap.get(route);
+    if (!prev) continue;
+    if (curr.validation.score < prev.validation.score) {
+      regressions.push(
+        `    ${chalk2.red("-")} ${route}  ${prev.validation.score} -> ${curr.validation.score}`
+      );
+    }
+  }
+  const improvements = [];
+  for (const [route, curr] of currMap) {
+    const prev = prevMap.get(route);
+    if (!prev) continue;
+    if (curr.validation.score > prev.validation.score) {
+      improvements.push(
+        `    ${chalk2.green("+")} ${route}  ${prev.validation.score} -> ${curr.validation.score}`
+      );
+    }
+  }
+  const newPages = [];
+  for (const route of currMap.keys()) {
+    if (!prevMap.has(route)) {
+      newPages.push(`    ${chalk2.blue("+")} ${route}  ${chalk2.dim("[new]")}`);
+    }
+  }
+  const removed = [];
+  for (const route of prevMap.keys()) {
+    if (!currMap.has(route)) {
+      removed.push(`    ${chalk2.dim("-")} ${route}  ${chalk2.dim("[removed]")}`);
+    }
+  }
+  if (regressions.length > 0) {
+    lines.push(chalk2.red(`  REGRESSIONS (${regressions.length}):`));
+    lines.push(...regressions);
+    lines.push("");
+  }
+  if (improvements.length > 0) {
+    lines.push(chalk2.green(`  IMPROVEMENTS (${improvements.length}):`));
+    lines.push(...improvements);
+    lines.push("");
+  }
+  if (newPages.length > 0) {
+    lines.push(chalk2.blue(`  NEW PAGES (${newPages.length}):`));
+    lines.push(...newPages);
+    lines.push("");
+  }
+  if (removed.length > 0) {
+    lines.push(chalk2.dim(`  REMOVED (${removed.length}):`));
+    lines.push(...removed);
+    lines.push("");
+  }
+  if (regressions.length === 0 && improvements.length === 0 && newPages.length === 0 && removed.length === 0) {
+    lines.push(chalk2.dim("  No changes detected."));
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function getScoreColor(score) {
+  if (score >= 90) return chalk2.green;
+  if (score >= 70) return chalk2.yellow;
+  return chalk2.red;
+}
+function computeSummary(results) {
+  const totalPages = results.length;
+  const passedPages = results.filter((r) => r.validation.errors.length === 0).length;
+  const averageScore = totalPages > 0 ? Math.round(results.reduce((sum, r) => sum + r.validation.score, 0) / totalPages) : 0;
+  const criticalErrors = results.reduce((sum, r) => sum + r.validation.errors.length, 0);
+  let grade;
+  if (averageScore >= 90) grade = "A";
+  else if (averageScore >= 80) grade = "B";
+  else if (averageScore >= 70) grade = "C";
+  else if (averageScore >= 60) grade = "D";
+  else grade = "F";
+  return { results, totalPages, passedPages, averageScore, grade, criticalErrors };
+}
+
+// src/store.ts
+import { existsSync as existsSync2 } from "fs";
+import { readFile as readFile3, writeFile as writeFile2, mkdir } from "fs/promises";
+import { join as join4 } from "path";
+var STORE_DIR = ".indxel";
+var LAST_CHECK_FILE = "last-check.json";
+async function saveCheckResult(cwd, summary) {
+  const storeDir = join4(cwd, STORE_DIR);
+  if (!existsSync2(storeDir)) {
+    await mkdir(storeDir, { recursive: true });
+  }
+  const stored = {
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    summary: {
+      ...summary,
+      // Serialize results with minimal data needed for diff
+      results: summary.results.map((r) => ({
+        page: {
+          filePath: r.page.filePath,
+          route: r.page.route,
+          hasMetadata: r.page.hasMetadata,
+          hasDynamicMetadata: r.page.hasDynamicMetadata,
+          extractedMetadata: r.page.extractedMetadata
+        },
+        validation: r.validation
+      }))
+    }
+  };
+  await writeFile2(
+    join4(storeDir, LAST_CHECK_FILE),
+    JSON.stringify(stored, null, 2),
+    "utf-8"
+  );
+}
+async function loadPreviousCheck(cwd) {
+  const filePath = join4(cwd, STORE_DIR, LAST_CHECK_FILE);
+  if (!existsSync2(filePath)) {
+    return null;
+  }
+  try {
+    const data = await readFile3(filePath, "utf-8");
+    return JSON.parse(data);
+  } catch {
+    return null;
+  }
+}
+
+// src/commands/check.ts
+var checkCommand = new Command2("check").description("Audit SEO metadata for all pages in your project").option("--cwd <path>", "Project directory", process.cwd()).option("--ci", "CI/CD mode \u2014 strict, exit 1 on any error", false).option("--diff", "Compare with previous check run", false).option("--json", "Output results as JSON", false).option("--strict", "Treat warnings as errors", false).action(async (opts) => {
+  const cwd = opts.cwd;
+  const isCI = opts.ci;
+  const isStrict = opts.strict || isCI;
+  const showDiff = opts.diff;
+  const jsonOutput = opts.json;
+  const spinner = ora2("Detecting project...").start();
+  const project = await detectProject(cwd);
+  if (!project.isNextJs) {
+    spinner.fail("Not a Next.js project");
+    if (!jsonOutput) {
+      console.log(chalk3.dim("  Run this command from a Next.js project root."));
+    }
+    process.exit(1);
+  }
+  if (!project.usesAppRouter) {
+    spinner.fail("App Router not detected");
+    if (!jsonOutput) {
+      console.log(chalk3.dim("  indxel requires Next.js App Router (src/app or app directory)."));
+    }
+    process.exit(1);
+  }
+  spinner.text = "Scanning pages...";
+  const pages = await scanPages(cwd, project.appDir);
+  if (pages.length === 0) {
+    spinner.fail("No pages found");
+    if (!jsonOutput) {
+      console.log(chalk3.dim(`  No page.tsx/ts files found in ${project.appDir}/`));
+    }
+    process.exit(1);
+  }
+  spinner.succeed(`Found ${pages.length} page${pages.length > 1 ? "s" : ""}`);
+  if (!jsonOutput) {
+    console.log("");
+    console.log(chalk3.bold(`  Checking ${pages.length} pages...`));
+    console.log("");
+  }
+  const results = [];
+  for (const page of pages) {
+    const validation = validateMetadata(page.extractedMetadata, {
+      strict: isStrict
+    });
+    const result = { page, validation };
+    results.push(result);
+    if (!jsonOutput) {
+      console.log(formatPageResult(result));
+    }
+  }
+  const summary = computeSummary(results);
+  await saveCheckResult(cwd, summary);
+  if (showDiff && !jsonOutput) {
+    const previous = await loadPreviousCheck(cwd);
+    if (previous) {
+      console.log(formatDiff(summary, previous.summary));
+    } else {
+      console.log(chalk3.dim("\n  No previous check found. Run again to see a diff.\n"));
+    }
+  }
+  if (jsonOutput) {
+    console.log(formatJSON(summary));
+  } else {
+    console.log(formatSummary(summary));
+  }
+  if (summary.criticalErrors > 0) {
+    process.exit(1);
+  }
+});
+
+// src/commands/crawl.ts
+import { Command as Command3 } from "commander";
+import chalk4 from "chalk";
+import ora3 from "ora";
+import {
+  crawlSite,
+  fetchSitemap,
+  compareSitemap,
+  fetchRobots,
+  checkUrlsAgainstRobots,
+  verifyAssets
+} from "indxel";
+var crawlCommand = new Command3("crawl").description("Crawl a live site, audit every page, check sitemap, robots.txt, and assets").argument("<url>", "URL to start crawling (e.g., https://yoursite.com)").option("--max-pages <n>", "Maximum pages to crawl", "50").option("--max-depth <n>", "Maximum link depth", "5").option("--delay <ms>", "Delay between requests in ms", "200").option("--json", "Output results as JSON", false).option("--strict", "Treat warnings as errors", false).option("--skip-assets", "Skip asset verification", false).option("--skip-sitemap", "Skip sitemap check", false).option("--skip-robots", "Skip robots.txt check", false).option("--ignore <patterns>", "Comma-separated path patterns to exclude from analysis (e.g. /app/*,/admin/*)").option("--push", "Push results to Indxel dashboard", false).option("--api-key <key>", "API key for --push (or set INDXEL_API_KEY env var)").action(async (url, opts) => {
+  const jsonOutput = opts.json;
+  const maxPages = parseInt(opts.maxPages, 10);
+  const maxDepth = parseInt(opts.maxDepth, 10);
+  const delay = parseInt(opts.delay, 10);
+  if (!url.startsWith("http://") && !url.startsWith("https://")) {
+    url = `https://${url}`;
+  }
+  if (!jsonOutput) {
+    console.log("");
+    console.log(chalk4.bold(`  indxel crawl`) + chalk4.dim(` \u2014 ${url}`));
+    console.log("");
+  }
+  let robotsResult = null;
+  if (!opts.skipRobots) {
+    const robotsSpinner = jsonOutput ? null : ora3("Checking robots.txt...").start();
+    robotsResult = await fetchRobots(url);
+    if (!jsonOutput) {
+      if (robotsResult.found) {
+        robotsSpinner.succeed("robots.txt found");
+        for (const w of robotsResult.warnings) {
+          console.log(chalk4.yellow(`  \u26A0 ${w}`));
+        }
+        if (robotsResult.sitemapUrls.length > 0) {
+          console.log(chalk4.dim(`  Sitemap references: ${robotsResult.sitemapUrls.join(", ")}`));
+        }
+      } else {
+        robotsSpinner.warn("robots.txt not found");
+        for (const e of robotsResult.errors) {
+          console.log(chalk4.dim(`  ${e}`));
+        }
+      }
+      console.log("");
+    }
+  }
+  const crawlSpinner = jsonOutput ? null : ora3("Crawling...").start();
+  let crawledCount = 0;
+  const ignorePatterns = opts.ignore ? opts.ignore.split(",").map((p) => p.trim()).filter(Boolean) : [];
+  const crawlResult = await crawlSite(url, {
+    maxPages,
+    maxDepth,
+    delay,
+    strict: opts.strict,
+    ignorePatterns,
+    onPageCrawled: (page) => {
+      crawledCount++;
+      if (crawlSpinner) {
+        crawlSpinner.text = `Crawling... ${crawledCount} pages (current: ${page.url})`;
+      }
+    }
+  });
+  if (!jsonOutput) {
+    crawlSpinner.succeed(`Crawled ${crawlResult.totalPages} pages in ${(crawlResult.durationMs / 1e3).toFixed(1)}s`);
+    console.log("");
+    for (const page of crawlResult.pages) {
+      if (page.error) {
+        console.log(chalk4.red(`  \u2717 ${page.url}`) + chalk4.dim(` \u2014 ${page.error}`));
+        continue;
+      }
+      const scoreColor = page.validation.score >= 90 ? chalk4.green : page.validation.score >= 70 ? chalk4.yellow : chalk4.red;
+      const icon = page.validation.errors.length > 0 ? chalk4.red("\u2717") : chalk4.green("\u2713");
+      console.log(
+        `  ${icon} ${page.url} ${scoreColor(`${page.validation.score}/100`)}`
+      );
+      for (const error of page.validation.errors) {
+        console.log(chalk4.red(`    \u2717 ${error.message ?? error.description}`));
+      }
+      for (const warning of page.validation.warnings) {
+        console.log(chalk4.yellow(`    \u26A0 ${warning.message ?? warning.description}`));
+      }
+    }
+    console.log("");
+  }
+  let sitemapComparison = null;
+  if (!opts.skipSitemap) {
+    const sitemapSpinner = jsonOutput ? null : ora3("Checking sitemap.xml...").start();
+    const sitemapResult = await fetchSitemap(url);
+    if (!jsonOutput) {
+      if (sitemapResult.found) {
+        sitemapSpinner.succeed(`sitemap.xml found \u2014 ${sitemapResult.urls.length} URLs`);
+        const crawledUrls = crawlResult.pages.filter((p) => !p.error).map((p) => p.url);
+        sitemapComparison = compareSitemap(
+          sitemapResult.urls.map((u) => u.loc),
+          crawledUrls
+        );
+        if (sitemapComparison.inCrawlOnly.length > 0) {
+          console.log(chalk4.yellow(`  \u26A0 ${sitemapComparison.inCrawlOnly.length} crawled pages missing from sitemap:`));
+          for (const u of sitemapComparison.inCrawlOnly.slice(0, 10)) {
+            console.log(chalk4.dim(`    - ${u}`));
+          }
+        }
+        if (sitemapComparison.inSitemapOnly.length > 0) {
+          console.log(chalk4.yellow(`  \u26A0 ${sitemapComparison.inSitemapOnly.length} sitemap URLs not reachable:`));
+          for (const u of sitemapComparison.inSitemapOnly.slice(0, 10)) {
+            console.log(chalk4.dim(`    - ${u}`));
+          }
+        }
+        if (sitemapComparison.issues.length === 0) {
+          console.log(chalk4.green(`  \u2713 Sitemap matches crawled pages`));
+        }
+      } else {
+        sitemapSpinner.warn("sitemap.xml not found");
+        for (const e of sitemapResult.errors) {
+          console.log(chalk4.dim(`  ${e}`));
+        }
+      }
+      console.log("");
+    }
+  }
+  let robotsBlockedPages = null;
+  if (robotsResult?.found && robotsResult.directives.length > 0) {
+    const crawledUrls = crawlResult.pages.filter((p) => !p.error).map((p) => p.url);
+    robotsBlockedPages = checkUrlsAgainstRobots(
+      robotsResult.directives,
+      crawledUrls
+    );
+    const blocked = robotsBlockedPages.filter((c) => c.blocked);
+    if (!jsonOutput && blocked.length > 0) {
+      console.log(chalk4.yellow(`  \u26A0 ${blocked.length} crawled pages are blocked by robots.txt:`));
+      for (const b of blocked) {
+        console.log(chalk4.dim(`    - ${b.path} (${b.blockedBy})`));
+      }
+      console.log("");
+    }
+  }
+  let assetResult = null;
+  if (!opts.skipAssets) {
+    const assetSpinner = jsonOutput ? null : ora3("Verifying assets (og:image, favicon, ...)...").start();
+    const pagesForAssetCheck = crawlResult.pages.filter((p) => !p.error).map((p) => ({ url: p.url, metadata: p.metadata }));
+    assetResult = await verifyAssets(pagesForAssetCheck);
+    if (!jsonOutput) {
+      assetSpinner.succeed(`Verified ${assetResult.totalChecked} assets`);
+      const brokenAssets = assetResult.checks.filter((c) => !c.ok);
+      const warningAssets = assetResult.checks.filter((c) => c.warning);
+      for (const asset of brokenAssets) {
+        console.log(
+          chalk4.red(`  \u2717 ${asset.type}`) + chalk4.dim(` ${asset.url}`) + chalk4.red(` \u2014 ${asset.error ?? `HTTP ${asset.status}`}`)
+        );
+      }
+      for (const asset of warningAssets) {
+        console.log(
+          chalk4.yellow(`  \u26A0 ${asset.type}`) + chalk4.dim(` ${asset.url}`) + chalk4.yellow(` \u2014 ${asset.warning}`)
+        );
+      }
+      if (brokenAssets.length === 0 && warningAssets.length === 0) {
+        console.log(chalk4.green(`  \u2713 All assets respond correctly`));
+      }
+      console.log("");
+    }
+  }
+  if (!jsonOutput) {
+    const a = crawlResult.analysis;
+    if (a.duplicateTitles.length > 0) {
+      console.log(chalk4.bold("- Duplicate titles"));
+      for (const dup of a.duplicateTitles.slice(0, 5)) {
+        console.log(chalk4.red(`  \u2717 "${dup.title.length > 60 ? dup.title.slice(0, 57) + "..." : dup.title}"`) + chalk4.dim(` (${dup.urls.length} pages)`));
+        for (const u of dup.urls.slice(0, 3)) console.log(chalk4.dim(`    ${u}`));
+        if (dup.urls.length > 3) console.log(chalk4.dim(`    ...and ${dup.urls.length - 3} more`));
+      }
+      if (a.duplicateTitles.length > 5) console.log(chalk4.dim(`  ...and ${a.duplicateTitles.length - 5} more groups`));
+      console.log("");
+    }
+    if (a.duplicateDescriptions.length > 0) {
+      console.log(chalk4.bold("- Duplicate descriptions"));
+      for (const dup of a.duplicateDescriptions.slice(0, 5)) {
+        const desc = dup.description.length > 60 ? dup.description.slice(0, 57) + "..." : dup.description;
+        console.log(chalk4.red(`  \u2717 "${desc}"`) + chalk4.dim(` (${dup.urls.length} pages)`));
+        for (const u of dup.urls.slice(0, 3)) console.log(chalk4.dim(`    ${u}`));
+        if (dup.urls.length > 3) console.log(chalk4.dim(`    ...and ${dup.urls.length - 3} more`));
+      }
+      if (a.duplicateDescriptions.length > 5) console.log(chalk4.dim(`  ...and ${a.duplicateDescriptions.length - 5} more groups`));
+      console.log("");
+    }
+    if (a.h1Issues.length > 0) {
+      const missing = a.h1Issues.filter((h) => h.issue === "missing");
+      const multiple = a.h1Issues.filter((h) => h.issue === "multiple");
+      console.log(chalk4.bold("- H1 heading issues"));
+      if (missing.length > 0) {
+        console.log(chalk4.red(`  \u2717 ${missing.length} pages missing H1`));
+        for (const h of missing.slice(0, 5)) console.log(chalk4.dim(`    ${h.url}`));
+        if (missing.length > 5) console.log(chalk4.dim(`    ...and ${missing.length - 5} more`));
+      }
+      if (multiple.length > 0) {
+        console.log(chalk4.yellow(`  \u26A0 ${multiple.length} pages with multiple H1s`));
+        for (const h of multiple.slice(0, 5)) console.log(chalk4.dim(`    ${h.url} (${h.count} H1s)`));
+        if (multiple.length > 5) console.log(chalk4.dim(`    ...and ${multiple.length - 5} more`));
+      }
+      console.log("");
+    }
+    if (a.brokenInternalLinks.length > 0) {
+      console.log(chalk4.bold("- Broken internal links"));
+      for (const bl of a.brokenInternalLinks.slice(0, 10)) {
+        console.log(chalk4.red(`  \u2717 ${bl.to}`) + chalk4.dim(` \u2190 linked from ${bl.from} (${bl.status})`));
+      }
+      if (a.brokenInternalLinks.length > 10) console.log(chalk4.dim(`  ...and ${a.brokenInternalLinks.length - 10} more`));
+      console.log("");
+    }
+    if (a.redirects.length > 0) {
+      console.log(chalk4.bold("- Redirect chains"));
+      for (const r of a.redirects.slice(0, 10)) {
+        console.log(chalk4.yellow(`  \u26A0 ${r.url}`));
+        for (const step of r.chain) console.log(chalk4.dim(`    ${step}`));
+      }
+      if (a.redirects.length > 10) console.log(chalk4.dim(`  ...and ${a.redirects.length - 10} more`));
+      console.log("");
+    }
+    if (a.thinContentPages.length > 0) {
+      const realThin = a.thinContentPages.filter((tc) => !tc.isAppPage);
+      const appThin = a.thinContentPages.filter((tc) => tc.isAppPage);
+      if (realThin.length > 0) {
+        console.log(chalk4.bold("- Thin content") + chalk4.dim(" (< 200 words)"));
+        for (const tc of realThin.slice(0, 10)) {
+          console.log(chalk4.yellow(`  \u26A0 ${tc.url}`) + chalk4.dim(` \u2014 ${tc.wordCount} words`));
+        }
+        if (realThin.length > 10) console.log(chalk4.dim(`  ...and ${realThin.length - 10} more`));
+        console.log("");
+      }
+      if (appThin.length > 0) {
+        console.log(chalk4.bold("- App/wizard pages") + chalk4.dim(" (client-rendered, low word count expected)"));
+        for (const tc of appThin.slice(0, 5)) {
+          console.log(chalk4.dim(`  \u2139 ${tc.url} \u2014 ${tc.wordCount} words`));
+        }
+        if (appThin.length > 5) console.log(chalk4.dim(`  ...and ${appThin.length - 5} more`));
+        console.log("");
+      }
+    }
+    if (a.orphanPages.length > 0) {
+      console.log(chalk4.bold("- Orphan pages") + chalk4.dim(" (0 internal links pointing to them)"));
+      for (const o of a.orphanPages.slice(0, 10)) console.log(chalk4.yellow(`  \u26A0 ${o}`));
+      if (a.orphanPages.length > 10) console.log(chalk4.dim(`  ...and ${a.orphanPages.length - 10} more`));
+      console.log("");
+    }
+    if (a.slowestPages.length > 0 && a.slowestPages[0].responseTimeMs > 1e3) {
+      console.log(chalk4.bold("- Slowest pages"));
+      for (const sp of a.slowestPages.filter((p) => p.responseTimeMs > 1e3).slice(0, 5)) {
+        const color = sp.responseTimeMs > 3e3 ? chalk4.red : chalk4.yellow;
+        console.log(color(`  \u26A0 ${sp.url}`) + chalk4.dim(` \u2014 ${(sp.responseTimeMs / 1e3).toFixed(1)}s`));
+      }
+      console.log("");
+    }
+    if (a.structuredDataSummary.length > 0) {
+      console.log(chalk4.bold("- Structured data (JSON-LD)"));
+      for (const sd of a.structuredDataSummary) {
+        console.log(chalk4.green(`  \u2713 ${sd.type}`) + chalk4.dim(` \u2014 ${sd.count} page${sd.count > 1 ? "s" : ""}`));
+      }
+      const pagesWithSD = crawlResult.pages.filter((p) => !p.error && p.structuredDataTypes.length > 0).length;
+      const pagesWithout = crawlResult.pages.filter((p) => !p.error).length - pagesWithSD;
+      if (pagesWithout > 0) {
+        console.log(chalk4.yellow(`  \u26A0 ${pagesWithout} pages without any structured data`));
+      }
+      console.log("");
+    } else {
+      console.log(chalk4.bold("- Structured data (JSON-LD)"));
+      console.log(chalk4.red(`  \u2717 No structured data found on any page`));
+      console.log("");
+    }
+  }
+  if (jsonOutput) {
+    console.log(
+      JSON.stringify(
+        {
+          crawl: crawlResult,
+          robots: robotsResult,
+          sitemap: sitemapComparison,
+          assets: assetResult
+        },
+        null,
+        2
+      )
+    );
+  } else {
+    const scoreColor = crawlResult.averageScore >= 90 ? chalk4.green : crawlResult.averageScore >= 70 ? chalk4.yellow : chalk4.red;
+    console.log(chalk4.bold("  \u2500\u2500\u2500 Summary \u2500\u2500\u2500"));
+    console.log("");
+    console.log(`  Pages crawled:  ${chalk4.bold(String(crawlResult.totalPages))}`);
+    console.log(`  Average score:  ${scoreColor(chalk4.bold(`${crawlResult.averageScore}/100`))} (${crawlResult.grade})`);
+    console.log(`  Errors:         ${crawlResult.totalErrors > 0 ? chalk4.red(String(crawlResult.totalErrors)) : chalk4.green("0")}`);
+    console.log(`  Warnings:       ${crawlResult.totalWarnings > 0 ? chalk4.yellow(String(crawlResult.totalWarnings)) : chalk4.green("0")}`);
+    if (assetResult) {
+      console.log(`  Broken assets:  ${assetResult.totalBroken > 0 ? chalk4.red(String(assetResult.totalBroken)) : chalk4.green("0")}`);
+    }
+    if (crawlResult.skippedUrls.length > 0) {
+      console.log(chalk4.dim(`  Skipped:        ${crawlResult.skippedUrls.length} URLs (over limit)`));
+    }
+    console.log("");
+  }
+  if (opts.push) {
+    const apiKey = opts.apiKey || process.env.INDXEL_API_KEY;
+    if (!apiKey) {
+      if (!jsonOutput) {
+        console.log(chalk4.red("  \u2717 --push requires an API key. Use --api-key or set INDXEL_API_KEY."));
+        console.log(chalk4.dim("    Get your key at https://indxel.com/dashboard/settings"));
+        console.log("");
+      }
+    } else {
+      const pushSpinner = jsonOutput ? null : ora3("Pushing results to Indxel...").start();
+      try {
+        const pushUrl = process.env.INDXEL_API_URL || "https://www.indxel.com";
+        const res = await fetch(`${pushUrl}/api/cli/push`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`
+          },
+          body: JSON.stringify({
+            crawl: crawlResult,
+            robots: robotsResult,
+            sitemap: sitemapComparison,
+            assets: assetResult
+          })
+        });
+        if (res.ok) {
+          const data = await res.json();
+          if (pushSpinner) pushSpinner.succeed(`Pushed to dashboard \u2014 check ${data.checkId}`);
+        } else {
+          const data = await res.json().catch(() => ({}));
+          if (pushSpinner) pushSpinner.fail(`Push failed: ${data.error || res.statusText}`);
+        }
+      } catch (err) {
+        if (pushSpinner) pushSpinner.fail(`Push failed: ${err instanceof Error ? err.message : String(err)}`);
+      }
+      if (!jsonOutput) console.log("");
+    }
+  }
+  if (crawlResult.totalErrors > 0) {
+    process.exit(1);
+  }
+});
+
+// src/commands/keywords.ts
+import { Command as Command4 } from "commander";
+import chalk5 from "chalk";
+import ora4 from "ora";
+import { researchKeywords, crawlSite as crawlSite2, analyzeContentGaps } from "indxel";
+var keywordsCommand = new Command4("keywords").description("Research keyword opportunities and find content gaps").argument("<seed>", "Seed keyword or topic to research").option("--locale <locale>", "Language locale", "en").option("--country <country>", "Country code", "us").option("--site <url>", "Site URL to analyze content gaps against").option("--max-pages <n>", "Maximum pages to crawl for gap analysis", "30").option("--json", "Output results as JSON", false).action(async (seed, opts) => {
+  const jsonOutput = opts.json;
+  if (!jsonOutput) {
+    console.log("");
+    console.log(chalk5.bold(`  indxel keywords`) + chalk5.dim(` \u2014 "${seed}"`));
+    console.log("");
+  }
+  const kwSpinner = jsonOutput ? null : ora4("Researching keywords...").start();
+  const kwResult = await researchKeywords(seed, {
+    locale: opts.locale,
+    country: opts.country
+  });
+  if (!jsonOutput) {
+    kwSpinner.succeed(`Found ${kwResult.totalKeywords} keywords`);
+    console.log("");
+    if (kwResult.suggestions.length > 0) {
+      console.log(chalk5.bold(`  Direct suggestions (${kwResult.suggestions.length})`));
+      for (const s of kwResult.suggestions) {
+        console.log(`  ${chalk5.hex("#F4A261")(s.keyword)}`);
+      }
+      console.log("");
+    }
+    if (kwResult.questions.length > 0) {
+      console.log(chalk5.bold(`  Questions (${kwResult.questions.length})`));
+      for (const q of kwResult.questions.slice(0, 20)) {
+        console.log(`  ${chalk5.cyan("?")} ${q.keyword}`);
+      }
+      console.log("");
+    }
+    if (kwResult.longTail.length > 0) {
+      console.log(chalk5.bold(`  Long-tail (${kwResult.longTail.length})`));
+      for (const lt of kwResult.longTail.slice(0, 20)) {
+        console.log(chalk5.dim(`  ${lt.keyword}`));
+      }
+      if (kwResult.longTail.length > 20) {
+        console.log(chalk5.dim(`  ... and ${kwResult.longTail.length - 20} more`));
+      }
+      console.log("");
+    }
+  }
+  let gapResult = null;
+  if (opts.site) {
+    let siteUrl = opts.site;
+    if (!siteUrl.startsWith("http://") && !siteUrl.startsWith("https://")) {
+      siteUrl = `https://${siteUrl}`;
+    }
+    const crawlSpinner = jsonOutput ? null : ora4(`Crawling ${siteUrl} for gap analysis...`).start();
+    const crawlResult = await crawlSite2(siteUrl, {
+      maxPages: parseInt(opts.maxPages, 10),
+      delay: 200
+    });
+    if (!jsonOutput) {
+      crawlSpinner.succeed(`Crawled ${crawlResult.totalPages} pages`);
+    }
+    const allKeywords = [
+      ...kwResult.suggestions,
+      ...kwResult.questions,
+      ...kwResult.longTail
+    ];
+    const existingPages = crawlResult.pages.filter((p) => !p.error).map((p) => ({ url: p.url, metadata: p.metadata }));
+    gapResult = analyzeContentGaps(allKeywords, existingPages);
+    if (!jsonOutput) {
+      console.log("");
+      console.log(
+        chalk5.bold(`  Content coverage: `) + `${gapResult.totalCovered}/${gapResult.totalKeywords} keywords (${gapResult.coveragePercent}%)`
+      );
+      console.log("");
+      if (gapResult.gaps.length > 0) {
+        const highGaps = gapResult.gaps.filter((g) => g.relevance === "high");
+        const medGaps = gapResult.gaps.filter((g) => g.relevance === "medium");
+        if (highGaps.length > 0) {
+          console.log(chalk5.bold.red(`  High priority gaps (${highGaps.length})`));
+          for (const gap of highGaps.slice(0, 15)) {
+            console.log(
+              chalk5.red(`  \u2717 `) + `"${gap.keyword}" \u2192 ` + chalk5.dim(`${gap.suggestedType} at ${gap.suggestedPath}`)
+            );
+          }
+          console.log("");
+        }
+        if (medGaps.length > 0) {
+          console.log(chalk5.bold.yellow(`  Medium priority gaps (${medGaps.length})`));
+          for (const gap of medGaps.slice(0, 10)) {
+            console.log(
+              chalk5.yellow(`  \u26A0 `) + `"${gap.keyword}" \u2192 ` + chalk5.dim(`${gap.suggestedType} at ${gap.suggestedPath}`)
+            );
+          }
+          console.log("");
+        }
+      }
+      if (gapResult.gaps.length === 0) {
+        console.log(chalk5.green(`  \u2713 All keyword opportunities are covered`));
+        console.log("");
+      }
+    }
+  }
+  if (jsonOutput) {
+    console.log(
+      JSON.stringify(
+        { keywords: kwResult, contentGaps: gapResult },
+        null,
+        2
+      )
+    );
+  }
+});
+
+// src/index.ts
+function createProgram() {
+  const program = new Command5();
+  program.name("indxel").description("Infrastructure SEO developer-first. ESLint pour le SEO.").version("0.1.0");
+  program.addCommand(initCommand);
+  program.addCommand(checkCommand);
+  program.addCommand(crawlCommand);
+  program.addCommand(keywordsCommand);
+  return program;
+}
+export {
+  checkCommand,
+  crawlCommand,
+  createProgram,
+  initCommand,
+  keywordsCommand
+};
+//# sourceMappingURL=index.js.map