@lynxflow/seo-engine 1.5.2 → 1.5.4

package/dist/index.js

@@ -3642,17 +3642,20 @@ Your role is to configure, resolve, and maintain programmatic SEO pages, XML sit
 
 ---
 
-### \uD83D\uDEA8 1. CRITICAL RULE: FEATURE DISCOVERY FROM FRONTEND ONLY (NEVER USE BACKEND / PROVIDERS)
+### \uD83D\uDEA8 1. CRITICAL RULE: SEMANTIC PRODUCT DISCOVERY FROM THE FRONTEND
 
-When discovering or listing product modules, features, or services to build the SEO matrices:
+When discovering product modules, features, or services to build the SEO matrices:
 - **❌ NEVER inspect backend API routes, internal database folders, or third-party providers:**
   - DO NOT create programmatic pages for internal plumbing like: \`/api/stripe\`, \`/api/resend\`, \`/api/auth\`, \`/api/d1\`, \`/api/webhooks\`, \`/api/openai\`.
   - DO NOT expose internal infrastructure, vendors, or suppliers (e.g. Stripe, Resend, Cloudflare D1, Better-Auth, Supabase, PostgreSQL drivers) as public product features. End users never search for or buy your internal backend plumbing.
-- **✅ ALWAYS inspect the FRONTEND user-facing interface & commercial value propositions:**
-  - Read marketing navigation menus & dropdowns (\`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\`).
-  - Read marketing feature pages & pricing tiers (\`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\`).
-  - Read dashboard UI workflows & user modules (\`components/dashboard/*\`, \`components/sidebar/*\`).
-  - Identify the actual **benefits and tools the end-user buys** (e.g. "Visual Pipeline Kanban", "Automated Invoice Tracking", "Electronic Signature", "Real-Time Client Portal", "Custom Reporting").
+- **✅ DEEPLY READ & UNDERSTAND THE FRONTEND PRODUCT (SEMANTIC ANALYSIS):**
+  - **Framework-Agnostic Exploration:** Do not look for specific filenames (e.g. \`Navbar.tsx\` or \`Header.tsx\`). Every codebase organizes UI differently (React, Vue, Svelte, Astro, Remix, Next.js, HTML).
+  - **Read the Public Product Pages & User UI:** Read the website's landing pages, public feature descriptions, menus/navigation (whatever they are named), pricing tables, and user dashboard views.
+  - **Understand the Core Value & Workflows:** For every distinct tool or capability of the application:
+    - *What does this module actually do?* (e.g. "Automates quote follow-ups", "Visual drag-and-drop pipeline", "Real-time client portal").
+    - *What pain point does it solve for the end user?*
+    - *Who is the primary persona/industry benefiting from it?*
+  - **Extraction Requirement:** For EACH detected product module or major feature branch, create at least 1 programmatic service entry with \`slug\`, \`name\`, \`category\`, \`description\`, \`keyFeatures\`, and \`priceMonthly\`.
 
 ---
 
@@ -3689,7 +3692,114 @@ How category leaders generate millions of high-converting pages without server s
 
 ---
 
-### \uD83C\uDFDB️ 4. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
+### \uD83D\uDEE0️ 4. AI AGENT IMPLEMENTATION PROTOCOL (STEP-BY-STEP)
+
+When setting up programmatic SEO in any codebase, the AI Agent MUST generate these exact 4 files:
+
+#### File 1: Configuration & Dataset (\`lib/seo.ts\`)
+\`\`\`typescript
+import { PseoMatrixEngine } from "@lynxflow/seo-engine";
+
+export const matrixEngine = new PseoMatrixEngine();
+
+export const SEO_CONFIG = {
+  brandName: "Acme",
+  language: "en",
+  minPopulationToIndex: 15_000,
+};
+
+// Discovered EXCLUSIVELY from Frontend UI components
+export const PSEO_DATASET = {
+  services: [
+    // 1 per major frontend feature branch
+    { slug: "crm-pipeline", name: "Visual CRM Pipeline", category: "Sales", keyFeatures: ["Kanban", "Lead scoring"], description: "Visual deal tracking" },
+  ],
+  targets: [
+    { slug: "law-firms", name: "Law Firms", type: "industry", painPoints: ["Billing"], benefits: ["Compliance"] },
+  ],
+  integrations: [
+    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Order sync"] },
+  ],
+  templates: [
+    { slug: "sales-tracker-excel", title: "Sales Tracker", topic: "Sales", format: "excel", benefits: ["Instant setup"] },
+  ],
+  glossaryTerms: [
+    { slug: "mrr", term: "MRR", shortDefinition: "Monthly Recurring Revenue" },
+  ],
+};
+\`\`\`
+
+#### File 2: Universal Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
+\`\`\`tsx
+import { notFound } from "next/navigation";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function generateMetadata({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) return {};
+  return { title: page.title, description: page.description, alternates: { canonical: page.canonicalUrl }, robots: page.robots };
+}
+
+export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) notFound();
+
+  return (
+    <article className="max-w-4xl mx-auto py-12 px-6">
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
+      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
+      <p className="mt-4 text-xl text-gray-600">{page.description}</p>
+      {page.disclaimerText && <aside className="mt-8 p-4 bg-gray-50 border rounded text-xs text-gray-500">{page.disclaimerText}</aside>}
+    </article>
+  );
+}
+\`\`\`
+
+#### File 3: Dynamic XML Sitemap (\`app/sitemap.ts\`)
+\`\`\`typescript
+import { MetadataRoute } from "next";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  return pages.filter((p) => p.robots.includes("index")).map((p) => ({
+    url: p.canonicalUrl,
+    lastModified: new Date(),
+    changeFrequency: "weekly",
+    priority: 0.8,
+  }));
+}
+\`\`\`
+
+#### File 4: Dynamic AI Search Markdown Feed (\`app/llms.txt/route.ts\`)
+\`\`\`typescript
+import { NextResponse } from "next/server";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function GET() {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const markdown = [
+    \`# \${SEO_CONFIG.brandName} Solutions Index\`,
+    \`> Structured knowledge feed for LLMs and AI search engines (ChatGPT, Perplexity).\`,
+    \`\`,
+    \`## Solutions & Matrices\`,
+    ...pages.map((p) => \`- [\${p.h1}](\${p.canonicalUrl}): \${p.description}\`),
+  ].join("\\n");
+  return new NextResponse(markdown, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+}
+\`\`\`
+
+---
+
+### \uD83C\uDFDB️ 5. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
 
 1. **10 Canonical Root Pillars:**
    - Comparisons: \`/vs/{competitor}\`
@@ -3714,7 +3824,7 @@ How category leaders generate millions of high-converting pages without server s
 
 ---
 
-### \uD83E\uDDF9 5. URL SLUG INTEGRITY & SCHEMA.ORG
+### \uD83E\uDDF9 6. URL SLUG INTEGRITY & SCHEMA.ORG
 
 - Use \`cleanSeoSlug(text, { language })\` to strip accents, dates, and stop words.
 - Use \`ExtendedSchemaGraphBuilder\` to output valid JSON-LD graphs (\`SoftwareApplication\`, \`LocalBusiness\`, \`HowTo\`, \`FAQPage\`, \`BreadcrumbList\`, \`Organization\`).

package/dist/index.mjs

@@ -3544,17 +3544,20 @@ Your role is to configure, resolve, and maintain programmatic SEO pages, XML sit
 
 ---
 
-### \uD83D\uDEA8 1. CRITICAL RULE: FEATURE DISCOVERY FROM FRONTEND ONLY (NEVER USE BACKEND / PROVIDERS)
+### \uD83D\uDEA8 1. CRITICAL RULE: SEMANTIC PRODUCT DISCOVERY FROM THE FRONTEND
 
-When discovering or listing product modules, features, or services to build the SEO matrices:
+When discovering product modules, features, or services to build the SEO matrices:
 - **❌ NEVER inspect backend API routes, internal database folders, or third-party providers:**
   - DO NOT create programmatic pages for internal plumbing like: \`/api/stripe\`, \`/api/resend\`, \`/api/auth\`, \`/api/d1\`, \`/api/webhooks\`, \`/api/openai\`.
   - DO NOT expose internal infrastructure, vendors, or suppliers (e.g. Stripe, Resend, Cloudflare D1, Better-Auth, Supabase, PostgreSQL drivers) as public product features. End users never search for or buy your internal backend plumbing.
-- **✅ ALWAYS inspect the FRONTEND user-facing interface & commercial value propositions:**
-  - Read marketing navigation menus & dropdowns (\`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\`).
-  - Read marketing feature pages & pricing tiers (\`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\`).
-  - Read dashboard UI workflows & user modules (\`components/dashboard/*\`, \`components/sidebar/*\`).
-  - Identify the actual **benefits and tools the end-user buys** (e.g. "Visual Pipeline Kanban", "Automated Invoice Tracking", "Electronic Signature", "Real-Time Client Portal", "Custom Reporting").
+- **✅ DEEPLY READ & UNDERSTAND THE FRONTEND PRODUCT (SEMANTIC ANALYSIS):**
+  - **Framework-Agnostic Exploration:** Do not look for specific filenames (e.g. \`Navbar.tsx\` or \`Header.tsx\`). Every codebase organizes UI differently (React, Vue, Svelte, Astro, Remix, Next.js, HTML).
+  - **Read the Public Product Pages & User UI:** Read the website's landing pages, public feature descriptions, menus/navigation (whatever they are named), pricing tables, and user dashboard views.
+  - **Understand the Core Value & Workflows:** For every distinct tool or capability of the application:
+    - *What does this module actually do?* (e.g. "Automates quote follow-ups", "Visual drag-and-drop pipeline", "Real-time client portal").
+    - *What pain point does it solve for the end user?*
+    - *Who is the primary persona/industry benefiting from it?*
+  - **Extraction Requirement:** For EACH detected product module or major feature branch, create at least 1 programmatic service entry with \`slug\`, \`name\`, \`category\`, \`description\`, \`keyFeatures\`, and \`priceMonthly\`.
 
 ---
 
@@ -3591,7 +3594,114 @@ How category leaders generate millions of high-converting pages without server s
 
 ---
 
-### \uD83C\uDFDB️ 4. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
+### \uD83D\uDEE0️ 4. AI AGENT IMPLEMENTATION PROTOCOL (STEP-BY-STEP)
+
+When setting up programmatic SEO in any codebase, the AI Agent MUST generate these exact 4 files:
+
+#### File 1: Configuration & Dataset (\`lib/seo.ts\`)
+\`\`\`typescript
+import { PseoMatrixEngine } from "@lynxflow/seo-engine";
+
+export const matrixEngine = new PseoMatrixEngine();
+
+export const SEO_CONFIG = {
+  brandName: "Acme",
+  language: "en",
+  minPopulationToIndex: 15_000,
+};
+
+// Discovered EXCLUSIVELY from Frontend UI components
+export const PSEO_DATASET = {
+  services: [
+    // 1 per major frontend feature branch
+    { slug: "crm-pipeline", name: "Visual CRM Pipeline", category: "Sales", keyFeatures: ["Kanban", "Lead scoring"], description: "Visual deal tracking" },
+  ],
+  targets: [
+    { slug: "law-firms", name: "Law Firms", type: "industry", painPoints: ["Billing"], benefits: ["Compliance"] },
+  ],
+  integrations: [
+    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Order sync"] },
+  ],
+  templates: [
+    { slug: "sales-tracker-excel", title: "Sales Tracker", topic: "Sales", format: "excel", benefits: ["Instant setup"] },
+  ],
+  glossaryTerms: [
+    { slug: "mrr", term: "MRR", shortDefinition: "Monthly Recurring Revenue" },
+  ],
+};
+\`\`\`
+
+#### File 2: Universal Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
+\`\`\`tsx
+import { notFound } from "next/navigation";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function generateMetadata({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) return {};
+  return { title: page.title, description: page.description, alternates: { canonical: page.canonicalUrl }, robots: page.robots };
+}
+
+export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) notFound();
+
+  return (
+    <article className="max-w-4xl mx-auto py-12 px-6">
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
+      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
+      <p className="mt-4 text-xl text-gray-600">{page.description}</p>
+      {page.disclaimerText && <aside className="mt-8 p-4 bg-gray-50 border rounded text-xs text-gray-500">{page.disclaimerText}</aside>}
+    </article>
+  );
+}
+\`\`\`
+
+#### File 3: Dynamic XML Sitemap (\`app/sitemap.ts\`)
+\`\`\`typescript
+import { MetadataRoute } from "next";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  return pages.filter((p) => p.robots.includes("index")).map((p) => ({
+    url: p.canonicalUrl,
+    lastModified: new Date(),
+    changeFrequency: "weekly",
+    priority: 0.8,
+  }));
+}
+\`\`\`
+
+#### File 4: Dynamic AI Search Markdown Feed (\`app/llms.txt/route.ts\`)
+\`\`\`typescript
+import { NextResponse } from "next/server";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function GET() {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const markdown = [
+    \`# \${SEO_CONFIG.brandName} Solutions Index\`,
+    \`> Structured knowledge feed for LLMs and AI search engines (ChatGPT, Perplexity).\`,
+    \`\`,
+    \`## Solutions & Matrices\`,
+    ...pages.map((p) => \`- [\${p.h1}](\${p.canonicalUrl}): \${p.description}\`),
+  ].join("\\n");
+  return new NextResponse(markdown, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+}
+\`\`\`
+
+---
+
+### \uD83C\uDFDB️ 5. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
 
 1. **10 Canonical Root Pillars:**
    - Comparisons: \`/vs/{competitor}\`
@@ -3616,7 +3726,7 @@ How category leaders generate millions of high-converting pages without server s
 
 ---
 
-### \uD83E\uDDF9 5. URL SLUG INTEGRITY & SCHEMA.ORG
+### \uD83E\uDDF9 6. URL SLUG INTEGRITY & SCHEMA.ORG
 
 - Use \`cleanSeoSlug(text, { language })\` to strip accents, dates, and stop words.
 - Use \`ExtendedSchemaGraphBuilder\` to output valid JSON-LD graphs (\`SoftwareApplication\`, \`LocalBusiness\`, \`HowTo\`, \`FAQPage\`, \`BreadcrumbList\`, \`Organization\`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxflow/seo-engine",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "High-Performance Multilingual Programmatic SEO & AI Search Engine SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/llm-prompt.ts

@@ -10,17 +10,20 @@ Your role is to configure, resolve, and maintain programmatic SEO pages, XML sit
 
 ---
 
-### 🚨 1. CRITICAL RULE: FEATURE DISCOVERY FROM FRONTEND ONLY (NEVER USE BACKEND / PROVIDERS)
+### 🚨 1. CRITICAL RULE: SEMANTIC PRODUCT DISCOVERY FROM THE FRONTEND
 
-When discovering or listing product modules, features, or services to build the SEO matrices:
+When discovering product modules, features, or services to build the SEO matrices:
 - **❌ NEVER inspect backend API routes, internal database folders, or third-party providers:**
   - DO NOT create programmatic pages for internal plumbing like: \`/api/stripe\`, \`/api/resend\`, \`/api/auth\`, \`/api/d1\`, \`/api/webhooks\`, \`/api/openai\`.
   - DO NOT expose internal infrastructure, vendors, or suppliers (e.g. Stripe, Resend, Cloudflare D1, Better-Auth, Supabase, PostgreSQL drivers) as public product features. End users never search for or buy your internal backend plumbing.
-- **✅ ALWAYS inspect the FRONTEND user-facing interface & commercial value propositions:**
-  - Read marketing navigation menus & dropdowns (\`components/Navbar.tsx\`, \`components/Header.tsx\`, \`components/Navigation.tsx\`).
-  - Read marketing feature pages & pricing tiers (\`app/(marketing)/*\`, \`pages/features/*\`, \`app/pricing/*\`).
-  - Read dashboard UI workflows & user modules (\`components/dashboard/*\`, \`components/sidebar/*\`).
-  - Identify the actual **benefits and tools the end-user buys** (e.g. "Visual Pipeline Kanban", "Automated Invoice Tracking", "Electronic Signature", "Real-Time Client Portal", "Custom Reporting").
+- **✅ DEEPLY READ & UNDERSTAND THE FRONTEND PRODUCT (SEMANTIC ANALYSIS):**
+  - **Framework-Agnostic Exploration:** Do not look for specific filenames (e.g. \`Navbar.tsx\` or \`Header.tsx\`). Every codebase organizes UI differently (React, Vue, Svelte, Astro, Remix, Next.js, HTML).
+  - **Read the Public Product Pages & User UI:** Read the website's landing pages, public feature descriptions, menus/navigation (whatever they are named), pricing tables, and user dashboard views.
+  - **Understand the Core Value & Workflows:** For every distinct tool or capability of the application:
+    - *What does this module actually do?* (e.g. "Automates quote follow-ups", "Visual drag-and-drop pipeline", "Real-time client portal").
+    - *What pain point does it solve for the end user?*
+    - *Who is the primary persona/industry benefiting from it?*
+  - **Extraction Requirement:** For EACH detected product module or major feature branch, create at least 1 programmatic service entry with \`slug\`, \`name\`, \`category\`, \`description\`, \`keyFeatures\`, and \`priceMonthly\`.
 
 ---
 
@@ -57,7 +60,114 @@ How category leaders generate millions of high-converting pages without server s
 
 ---
 
-### 🏛️ 4. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
+### 🛠️ 4. AI AGENT IMPLEMENTATION PROTOCOL (STEP-BY-STEP)
+
+When setting up programmatic SEO in any codebase, the AI Agent MUST generate these exact 4 files:
+
+#### File 1: Configuration & Dataset (\`lib/seo.ts\`)
+\`\`\`typescript
+import { PseoMatrixEngine } from "@lynxflow/seo-engine";
+
+export const matrixEngine = new PseoMatrixEngine();
+
+export const SEO_CONFIG = {
+  brandName: "Acme",
+  language: "en",
+  minPopulationToIndex: 15_000,
+};
+
+// Discovered EXCLUSIVELY from Frontend UI components
+export const PSEO_DATASET = {
+  services: [
+    // 1 per major frontend feature branch
+    { slug: "crm-pipeline", name: "Visual CRM Pipeline", category: "Sales", keyFeatures: ["Kanban", "Lead scoring"], description: "Visual deal tracking" },
+  ],
+  targets: [
+    { slug: "law-firms", name: "Law Firms", type: "industry", painPoints: ["Billing"], benefits: ["Compliance"] },
+  ],
+  integrations: [
+    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Order sync"] },
+  ],
+  templates: [
+    { slug: "sales-tracker-excel", title: "Sales Tracker", topic: "Sales", format: "excel", benefits: ["Instant setup"] },
+  ],
+  glossaryTerms: [
+    { slug: "mrr", term: "MRR", shortDefinition: "Monthly Recurring Revenue" },
+  ],
+};
+\`\`\`
+
+#### File 2: Universal Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
+\`\`\`tsx
+import { notFound } from "next/navigation";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function generateMetadata({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) return {};
+  return { title: page.title, description: page.description, alternates: { canonical: page.canonicalUrl }, robots: page.robots };
+}
+
+export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
+  const path = "/" + params.slug.join("/");
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const page = pages.find((p) => p.urlPath === path);
+  if (!page) notFound();
+
+  return (
+    <article className="max-w-4xl mx-auto py-12 px-6">
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
+      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
+      <p className="mt-4 text-xl text-gray-600">{page.description}</p>
+      {page.disclaimerText && <aside className="mt-8 p-4 bg-gray-50 border rounded text-xs text-gray-500">{page.disclaimerText}</aside>}
+    </article>
+  );
+}
+\`\`\`
+
+#### File 3: Dynamic XML Sitemap (\`app/sitemap.ts\`)
+\`\`\`typescript
+import { MetadataRoute } from "next";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  return pages.filter((p) => p.robots.includes("index")).map((p) => ({
+    url: p.canonicalUrl,
+    lastModified: new Date(),
+    changeFrequency: "weekly",
+    priority: 0.8,
+  }));
+}
+\`\`\`
+
+#### File 4: Dynamic AI Search Markdown Feed (\`app/llms.txt/route.ts\`)
+\`\`\`typescript
+import { NextResponse } from "next/server";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function GET() {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
+  const markdown = [
+    \`# \${SEO_CONFIG.brandName} Solutions Index\`,
+    \`> Structured knowledge feed for LLMs and AI search engines (ChatGPT, Perplexity).\`,
+    \`\`,
+    \`## Solutions & Matrices\`,
+    ...pages.map((p) => \`- [\${p.h1}](\${p.canonicalUrl}): \${p.description}\`),
+  ].join("\\n");
+  return new NextResponse(markdown, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+}
+\`\`\`
+
+---
+
+### 🏛️ 5. MATRIX ARCHITECTURE: 10 ROOT PILLARS & 50+ SPECIALIZED SUB-MATRICES
 
 1. **10 Canonical Root Pillars:**
    - Comparisons: \`/vs/{competitor}\`
@@ -82,7 +192,7 @@ How category leaders generate millions of high-converting pages without server s
 
 ---
 
-### 🧹 5. URL SLUG INTEGRITY & SCHEMA.ORG
+### 🧹 6. URL SLUG INTEGRITY & SCHEMA.ORG
 
 - Use \`cleanSeoSlug(text, { language })\` to strip accents, dates, and stop words.
 - Use \`ExtendedSchemaGraphBuilder\` to output valid JSON-LD graphs (\`SoftwareApplication\`, \`LocalBusiness\`, \`HowTo\`, \`FAQPage\`, \`BreadcrumbList\`, \`Organization\`).