@sonordev/site-kit 4.2.2 → 4.2.3

package/dist/cli/index.mjs

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { traverse, isJSXIdentifier, isJSXAttribute, isFunctionDeclaration, isVariableDeclarator, isIdentifier, isStringLiteral, isJSXMemberExpression, isJSXExpressionContainer, isTemplateLiteral, isArrayExpression, isObjectExpression, isJSXText } from '../chunk-JOYMIGR2.mjs';
 import { parse } from '../chunk-5YA6SI4Z.mjs';
-import { buildOgHtml } from '../chunk-DQO4UKFE.mjs';
+import { buildOgHtml, TITLE_MAX_PX, OG_REPORT_ATTR } from '../chunk-HTLWSCUQ.mjs';
 import { require_main } from '../chunk-NNZDWY3L.mjs';
-import { SITE_KIT_VERSION } from '../chunk-NPCWPOCE.mjs';
+import { findAppDirForDiscovery, discoverNextJsRoutes } from '../chunk-XIJ4F6IE.mjs';
+import { SITE_KIT_VERSION } from '../chunk-XCFCG46K.mjs';
 import { __commonJS, __require, __toESM, __export, __privateAdd, __publicField, __privateGet, __privateMethod, __privateSet, __privateWrapper } from '../chunk-BEXTDHO4.mjs';
 import { EventEmitter } from 'events';
 import childProcess, { execFile as execFile$1, execSync, spawnSync, spawn } from 'child_process';
@@ -6201,10 +6202,10 @@ var require_lib2 = __commonJS({
     exports.analyse = analyse;
     var detectFile = (filepath, opts = {}) => new Promise((resolve, reject) => {
       let fd;
-      const fs26 = (0, node_1.default)();
+      const fs27 = (0, node_1.default)();
       const handler = (err, buffer) => {
         if (fd) {
-          fs26.closeSync(fd);
+          fs27.closeSync(fd);
         }
         if (err) {
           reject(err);
@@ -6216,9 +6217,9 @@ var require_lib2 = __commonJS({
       };
       const sampleSize = (opts === null || opts === void 0 ? void 0 : opts.sampleSize) || 0;
       if (sampleSize > 0) {
-        fd = fs26.openSync(filepath, "r");
+        fd = fs27.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(sampleSize);
-        fs26.read(fd, sample, 0, sampleSize, opts.offset, (err, bytesRead) => {
+        fs27.read(fd, sample, 0, sampleSize, opts.offset, (err, bytesRead) => {
           if (err) {
             handler(err, null);
           } else {
@@ -6230,22 +6231,22 @@ var require_lib2 = __commonJS({
         });
         return;
       }
-      fs26.readFile(filepath, handler);
+      fs27.readFile(filepath, handler);
     });
     exports.detectFile = detectFile;
     var detectFileSync = (filepath, opts = {}) => {
-      const fs26 = (0, node_1.default)();
+      const fs27 = (0, node_1.default)();
       if (opts && opts.sampleSize) {
-        const fd = fs26.openSync(filepath, "r");
+        const fd = fs27.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(opts.sampleSize);
-        const bytesRead = fs26.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
+        const bytesRead = fs27.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
         if (bytesRead < opts.sampleSize) {
           sample = sample.subarray(0, bytesRead);
         }
-        fs26.closeSync(fd);
+        fs27.closeSync(fd);
         return (0, exports.detect)(sample);
       }
-      return (0, exports.detect)(fs26.readFileSync(filepath));
+      return (0, exports.detect)(fs27.readFileSync(filepath));
     };
     exports.detectFileSync = detectFileSync;
     exports.default = {
@@ -13235,9 +13236,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @param {string} [path]
    * @return {(string|null|Command)}
    */
-  executableDir(path26) {
-    if (path26 === void 0) return this._executableDir;
-    this._executableDir = path26;
+  executableDir(path27) {
+    if (path27 === void 0) return this._executableDir;
+    this._executableDir = path27;
     return this;
   }
   /**
@@ -20344,9 +20345,9 @@ function observableToAsyncIterable(source) {
 
 // node_modules/.pnpm/inquirer@14.0.2_@types+node@26.2.0/node_modules/inquirer/dist/ui/prompt.js
 var _ = {
-  set: (obj, path26 = "", value) => {
+  set: (obj, path27 = "", value) => {
     let pointer = obj;
-    path26.split(".").forEach((key, index, arr) => {
+    path27.split(".").forEach((key, index, arr) => {
       if (key === "__proto__" || key === "constructor")
         return;
       if (index === arr.length - 1) {
@@ -20357,8 +20358,8 @@ var _ = {
       pointer = pointer[key];
     });
   },
-  get: (obj, path26 = "", defaultValue) => {
-    const travel = (regexp) => String.prototype.split.call(path26, regexp).filter(Boolean).reduce(
+  get: (obj, path27 = "", defaultValue) => {
+    const travel = (regexp) => String.prototype.split.call(path27, regexp).filter(Boolean).reduce(
       // @ts-expect-error implicit any on res[key]
       (res, key) => res == null ? res : res[key],
       obj
@@ -20715,18 +20716,18 @@ function scanForForms(ast, content, filePath) {
   const forms = [];
   content.split("\n");
   traverse(ast, {
-    JSXElement(path26) {
-      const opening = path26.node.openingElement;
+    JSXElement(path27) {
+      const opening = path27.node.openingElement;
       if (isJSXIdentifier(opening.name) && opening.name.name === "form") {
-        const fields = extractFieldsFromForm(path26);
+        const fields = extractFieldsFromForm(path27);
         const hasOnSubmit = opening.attributes.some(
           (attr) => isJSXAttribute(attr) && isJSXIdentifier(attr.name) && attr.name.name === "onSubmit"
         );
         if (hasOnSubmit && fields.length > 0) {
-          const startLine = path26.node.loc?.start.line || 0;
-          const endLine = path26.node.loc?.end.line || 0;
+          const startLine = path27.node.loc?.start.line || 0;
+          const endLine = path27.node.loc?.end.line || 0;
           let componentName = "UnknownForm";
-          let current = path26.parentPath;
+          let current = path27.parentPath;
           while (current) {
             if (isFunctionDeclaration(current.node) && current.node.id) {
               componentName = current.node.id.name;
@@ -20759,7 +20760,7 @@ function scanForForms(ast, content, filePath) {
       }
       if (isJSXIdentifier(opening.name) && opening.name.name === "Form") {
         if (content.includes("Formik") || content.includes("formik")) {
-          const fields = extractFieldsFromFormik(path26);
+          const fields = extractFieldsFromFormik(path27);
           if (fields.length > 0) {
             forms.push({
               filePath,
@@ -20770,8 +20771,8 @@ function scanForForms(ast, content, filePath) {
               submitsTo: null,
               complexity: "moderate",
               suggestedAction: "assisted",
-              startLine: path26.node.loc?.start.line || 0,
-              endLine: path26.node.loc?.end.line || 0
+              startLine: path27.node.loc?.start.line || 0,
+              endLine: path27.node.loc?.end.line || 0
             });
           }
         }
@@ -20789,8 +20790,8 @@ function extractFieldsFromForm(formPath) {
   const radioGroups = /* @__PURE__ */ new Map();
   const checkboxGroups = /* @__PURE__ */ new Map();
   formPath.traverse({
-    JSXElement(path26) {
-      const opening = path26.node.openingElement;
+    JSXElement(path27) {
+      const opening = path27.node.openingElement;
       const tagName = isJSXIdentifier(opening.name) ? opening.name.name : null;
       if (["input", "textarea", "select"].includes(tagName || "")) {
         const attrs = opening.attributes;
@@ -20837,7 +20838,7 @@ function extractFieldsFromForm(formPath) {
         }
         if (tagName === "select") {
           const selectOptions = [];
-          path26.traverse({
+          path27.traverse({
             JSXElement(optionPath) {
               const optOpening = optionPath.node.openingElement;
               const optTagName = isJSXIdentifier(optOpening.name) ? optOpening.name.name : null;
@@ -20912,8 +20913,8 @@ function extractFieldsFromForm(formPath) {
 function extractFieldsFromFormik(formPath, content) {
   const fields = [];
   formPath.traverse({
-    JSXElement(path26) {
-      const opening = path26.node.openingElement;
+    JSXElement(path27) {
+      const opening = path27.node.openingElement;
       const tagName = isJSXIdentifier(opening.name) ? opening.name.name : null;
       if (tagName === "Field" || tagName === "FastField") {
         const attrs = opening.attributes;
@@ -21032,11 +21033,11 @@ function scanForMetadata(ast, content, filePath) {
   }
   let hasHeadComponent = false;
   traverse(ast, {
-    JSXElement(path26) {
-      const opening = path26.node.openingElement;
+    JSXElement(path27) {
+      const opening = path27.node.openingElement;
       if (isJSXIdentifier(opening.name) && opening.name.name === "Head") {
         hasHeadComponent = true;
-        path26.stop();
+        path27.stop();
       }
     }
   });
@@ -21071,8 +21072,8 @@ function scanForWidgets(ast, content, filePath) {
   for (const { pattern, type } of widgetPatterns) {
     if (pattern.test(content)) {
       traverse(ast, {
-        JSXElement(path26) {
-          const opening = path26.node.openingElement;
+        JSXElement(path27) {
+          const opening = path27.node.openingElement;
           if (isJSXIdentifier(opening.name) && (opening.name.name === "script" || opening.name.name === "Script")) {
             const srcAttr = opening.attributes.find(
               (attr) => isJSXAttribute(attr) && isJSXIdentifier(attr.name) && attr.name.name === "src"
@@ -21087,8 +21088,8 @@ function scanForWidgets(ast, content, filePath) {
                   filePath,
                   widgetType: type,
                   scriptTag: src,
-                  startLine: path26.node.loc?.start.line || 0,
-                  endLine: path26.node.loc?.end.line || 0
+                  startLine: path27.node.loc?.start.line || 0,
+                  endLine: path27.node.loc?.end.line || 0
                 });
               }
             }
@@ -21227,8 +21228,8 @@ function scanForSchemas(ast, content, filePath) {
     return schemas;
   }
   traverse(ast, {
-    JSXElement(path26) {
-      const opening = path26.node.openingElement;
+    JSXElement(path27) {
+      const opening = path27.node.openingElement;
       if (isJSXIdentifier(opening.name) && (opening.name.name === "script" || opening.name.name === "Script")) {
         const typeAttr = opening.attributes.find(
           (attr) => isJSXAttribute(attr) && isJSXIdentifier(attr.name) && attr.name.name === "type"
@@ -21255,8 +21256,8 @@ function scanForSchemas(ast, content, filePath) {
               filePath,
               type: detectedType,
               schemaType,
-              startLine: path26.node.loc?.start.line || 0,
-              endLine: path26.node.loc?.end.line || 0
+              startLine: path27.node.loc?.start.line || 0,
+              endLine: path27.node.loc?.end.line || 0
             });
           }
         }
@@ -21289,8 +21290,8 @@ function scanForFAQs(ast, content, filePath) {
     /questions?\s*(?:and|&)?\s*answers?/i
   ];
   traverse(ast, {
-    JSXElement(path26) {
-      const opening = path26.node.openingElement;
+    JSXElement(path27) {
+      const opening = path27.node.openingElement;
       let tagName = "";
       if (isJSXIdentifier(opening.name)) {
         tagName = opening.name.name;
@@ -21303,8 +21304,8 @@ function scanForFAQs(ast, content, filePath) {
         faqs.push({
           filePath,
           type: "details-summary",
-          startLine: path26.node.loc?.start.line || 0,
-          endLine: path26.node.loc?.end.line || 0,
+          startLine: path27.node.loc?.start.line || 0,
+          endLine: path27.node.loc?.end.line || 0,
           hasSchema: content.includes("FAQPage") || content.includes("application/ld+json")
         });
         return;
@@ -21312,7 +21313,7 @@ function scanForFAQs(ast, content, filePath) {
       for (const pattern of faqPatterns) {
         if (pattern.test(tagName)) {
           let itemCount = 0;
-          path26.traverse({
+          path27.traverse({
             JSXElement(itemPath) {
               const itemOpening = itemPath.node.openingElement;
               if (isJSXIdentifier(itemOpening.name)) {
@@ -21328,8 +21329,8 @@ function scanForFAQs(ast, content, filePath) {
             type: "accordion",
             componentName: tagName,
             itemCount: itemCount || void 0,
-            startLine: path26.node.loc?.start.line || 0,
-            endLine: path26.node.loc?.end.line || 0,
+            startLine: path27.node.loc?.start.line || 0,
+            endLine: path27.node.loc?.end.line || 0,
             hasSchema: content.includes("FAQPage") || content.includes("application/ld+json")
           });
           return;
@@ -21452,8 +21453,8 @@ function scanForImages(ast, content, filePath) {
     return images;
   }
   traverse(ast, {
-    JSXElement(path26) {
-      const opening = path26.node.openingElement;
+    JSXElement(path27) {
+      const opening = path27.node.openingElement;
       if (!isJSXIdentifier(opening.name)) return;
       const tagName = opening.name.name;
       if (tagName === "img" || tagName === "Image") {
@@ -21481,8 +21482,8 @@ function scanForImages(ast, content, filePath) {
           src: src || void 0,
           alt: alt || void 0,
           isLocal,
-          startLine: path26.node.loc?.start.line || 0,
-          endLine: path26.node.loc?.end.line || 0
+          startLine: path27.node.loc?.start.line || 0,
+          endLine: path27.node.loc?.end.line || 0
         });
       }
     }
@@ -22396,18 +22397,18 @@ async function migrateFile(filePath, options) {
   let componentName = "Form";
   const traverse2 = (await import('../lib-RSDMEKDQ.mjs')).default;
   traverse2(ast, {
-    ExportNamedDeclaration(path26) {
-      const decl = path26.node.declaration;
+    ExportNamedDeclaration(path27) {
+      const decl = path27.node.declaration;
       if (decl && decl.type === "FunctionDeclaration" && decl.id) {
         componentName = decl.id.name;
-        path26.stop();
+        path27.stop();
       }
     },
-    ExportDefaultDeclaration(path26) {
-      const decl = path26.node.declaration;
+    ExportDefaultDeclaration(path27) {
+      const decl = path27.node.declaration;
       if (decl && decl.type === "FunctionDeclaration" && decl.id) {
         componentName = decl.id.name;
-        path26.stop();
+        path27.stop();
       }
     }
   });
@@ -22734,15 +22735,15 @@ var wslDefaultBrowser = async () => {
   const { stdout } = await executePowerShell(command, { powerShellPath: psPath });
   return stdout.trim();
 };
-var convertWslPathToWindows = async (path26) => {
-  if (/^[a-z]+:\/\//i.test(path26)) {
-    return path26;
+var convertWslPathToWindows = async (path27) => {
+  if (/^[a-z]+:\/\//i.test(path27)) {
+    return path27;
   }
   try {
-    const { stdout } = await execFile2("wslpath", ["-aw", path26], { encoding: "utf8" });
+    const { stdout } = await execFile2("wslpath", ["-aw", path27], { encoding: "utf8" });
     return stdout.trim();
   } catch {
-    return path26;
+    return path27;
   }
 };
 
@@ -25161,8 +25162,8 @@ async function templateCommand(sourcePath, options, config2) {
     const slots = [];
     const componentNames = [];
     traverse(ast, {
-      JSXElement(path26) {
-        const openingElement = path26.node.openingElement;
+      JSXElement(path27) {
+        const openingElement = path27.node.openingElement;
         if (isJSXIdentifier(openingElement.name)) {
           const componentName = openingElement.name.name;
           if (componentName[0] === componentName[0].toUpperCase()) {
@@ -26366,6 +26367,98 @@ async function uploadSchemas(pages, globalSchema, config2) {
     }
   }
 }
+var APP_DIRS = ["app", path10.join("src", "app")];
+var CARD_FILE = /^(opengraph-image|twitter-image)\b.*\.(png|jpe?g|gif|webp)$/i;
+function safeExists(p) {
+  try {
+    return fs__default.existsSync(p);
+  } catch {
+    return false;
+  }
+}
+function findPageCards(cwd) {
+  const found = [];
+  const walk = (dir) => {
+    let entries;
+    try {
+      entries = fs__default.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+      const full = path10.join(dir, entry.name);
+      if (entry.isDirectory()) walk(full);
+      else if (CARD_FILE.test(entry.name)) found.push(full);
+    }
+  };
+  for (const rel of APP_DIRS) walk(path10.join(cwd, rel));
+  return found;
+}
+function readOgWiring(cwd) {
+  const siteCard = ["public/og.png", "public/og.jpg", "public/opengraph.png"].some(
+    (rel) => safeExists(path10.join(cwd, rel))
+  );
+  const layoutPath = ["app/layout.tsx", "src/app/layout.tsx"].map((rel) => path10.join(cwd, rel)).find(safeExists);
+  let layout = "";
+  if (layoutPath) {
+    try {
+      layout = fs__default.readFileSync(layoutPath, "utf-8");
+    } catch {
+    }
+  }
+  return {
+    siteCard,
+    pageCards: findPageCards(cwd),
+    layoutDeclaresImages: /images:\s*\[/.test(layout),
+    largeCard: /summary_large_image/.test(layout),
+    referencesImage: /og\.png|opengraph-image|og:image|images:\s*\[/.test(layout),
+    layoutFound: !!layoutPath
+  };
+}
+function judgeOgWiring(facts) {
+  const problems = [];
+  if (!facts.layoutFound) {
+    return [{ message: "no app/layout.tsx found to verify metadata", fix: "Run this from the site root." }];
+  }
+  if (!facts.siteCard && !facts.pageCards.length) {
+    return [
+      {
+        message: "no OG card \u2014 shared links render as bare URLs",
+        fix: "Run: sonor-setup og (add og.config.ts for the real brand palette)"
+      }
+    ];
+  }
+  if (facts.pageCards.length) {
+    if (facts.layoutDeclaresImages) {
+      problems.push({
+        message: `openGraph/twitter images are declared in the root layout, which overrides all ${facts.pageCards.length} per-page cards`,
+        fix: "Remove the images arrays from the root layout metadata and let Next serve each route its own opengraph-image file."
+      });
+    }
+    problems.push({
+      message: "seo_pages.managed_og_image (if set in Sonor) overrides per-page cards the same way",
+      fix: "Clear managed_og_image for this project so each page serves its own card."
+    });
+  } else if (!facts.referencesImage) {
+    problems.push({
+      message: "card asset exists but layout metadata never references it",
+      fix: "Add openGraph.images: ['/og.png'] (and twitter.images) to the root layout metadata."
+    });
+  }
+  if (!facts.largeCard) {
+    problems.push({
+      message: "twitter.card is not 'summary_large_image' \u2014 previews render as a small square",
+      fix: "Set twitter: { card: 'summary_large_image' } in the root layout metadata."
+    });
+  }
+  return problems;
+}
+function checkOgWiring(cwd) {
+  return judgeOgWiring(readOgWiring(cwd));
+}
+
+// src/cli/agent/checks.ts
 var API_URL4 = process.env.SONOR_API_URL || "https://api.sonor.io";
 async function readFileOrNull(p) {
   try {
@@ -27028,58 +27121,19 @@ async function checkImageDimsDrift(cwd) {
   return { id: "images.dims-drift", title: "Image dims vs SVG", level: "ok", message: "Declared dims match SVG viewBoxes" };
 }
 async function checkOgCard(cwd) {
-  const staticCard = ["public/og.png", "public/og.jpg", "public/opengraph.png"].some(
-    (rel) => existsSyncSafe(path10.join(cwd, rel))
-  );
-  let fileConvention = false;
-  for (const appDir of ["app", "src/app"]) {
-    try {
-      const entries = await fs3.readdir(path10.join(cwd, appDir));
-      if (entries.some((e) => e.startsWith("opengraph-image") || e.startsWith("twitter-image"))) {
-        fileConvention = true;
-      }
-    } catch {
-    }
-  }
-  const layoutPath = ["app/layout.tsx", "src/app/layout.tsx"].map((rel) => path10.join(cwd, rel)).find(existsSyncSafe);
-  const layout = layoutPath ? await readFileOrNull(layoutPath) : null;
-  const referencesImage = !!layout && /og\.png|opengraph-image|og:image|images:\s*\[/.test(layout);
-  const largeCard = !!layout && /summary_large_image/.test(layout);
-  if (!staticCard && !fileConvention) {
-    return {
-      id: "og.card",
-      title: "Open Graph card",
-      level: "warn",
-      message: "No OG card \u2014 shared links render as bare URLs",
-      fix: "Run: sonor-setup og (add og.config.ts for the real brand palette)"
-    };
-  }
-  if (!referencesImage) {
-    return {
-      id: "og.card",
-      title: "Open Graph card",
-      level: "warn",
-      message: "Card asset exists but layout metadata never references it",
-      fix: "Add openGraph.images: ['/og.png'] (and twitter.images) to the root layout metadata."
-    };
-  }
-  if (!largeCard) {
-    return {
-      id: "og.card",
-      title: "Open Graph card",
-      level: "warn",
-      message: "twitter.card is not 'summary_large_image' \u2014 previews render as a small square",
-      fix: "Set twitter: { card: 'summary_large_image' } in the root layout metadata."
-    };
-  }
-  return { id: "og.card", title: "Open Graph card", level: "ok", message: "Card present and wired" };
-}
-function existsSyncSafe(p) {
-  try {
-    return __require("fs").existsSync(p);
-  } catch {
-    return false;
+  const problems = judgeOgWiring(readOgWiring(cwd));
+  if (!problems.length) {
+    return { id: "og.card", title: "Open Graph card", level: "ok", message: "Cards present and wired" };
   }
+  const [first, ...rest] = problems;
+  return {
+    id: "og.card",
+    title: "Open Graph card",
+    level: "warn",
+    message: first.message,
+    ...rest.length ? { detail: rest.map((p) => `${p.message} \u2014 ${p.fix}`).join("\n") } : {},
+    fix: first.fix
+  };
 }
 async function staticChecks(cwd) {
   return [
@@ -27162,7 +27216,64 @@ async function statusCommand(options) {
   const online = options.offline ? false : true;
   await runCommand(ctx, (c) => run2(c, online), renderChecksHuman("Site-Kit Integration Status"));
 }
+
+// src/og/pages.ts
+function stripBrandSuffix(title, brand) {
+  const cleaned = title.replace(/\s*[|–—-]\s*[^|–—-]+$/, "").trim();
+  if (!cleaned) return title.trim();
+  if (brand && cleaned.toLowerCase() === brand.toLowerCase()) return title.trim();
+  return cleaned;
+}
+function titleFromPath(path27) {
+  const last = path27.split("/").filter(Boolean).pop();
+  if (!last) return "Home";
+  return last.replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()).trim();
+}
+function kickerFromPath(path27, fallback) {
+  const parts = path27.split("/").filter(Boolean);
+  if (parts.length < 2) return fallback;
+  return parts.slice(0, -1).join(" / ").replace(/[-_]+/g, " ");
+}
+function clampSubtitle(text, max = 100) {
+  if (!text) return void 0;
+  const flat = text.replace(/\s+/g, " ").trim();
+  if (!flat) return void 0;
+  if (flat.length <= max) return flat;
+  const sentence = flat.slice(0, max + 1).match(/^.*[.!?](?=\s|$)/)?.[0];
+  if (sentence && sentence.length >= 30) return sentence.trim();
+  const cut = flat.slice(0, flat.lastIndexOf(" ", max) || max).trim();
+  return `${cut.replace(/[.,;:!?…]+$/, "")}\u2026`;
+}
+function slugForPath(path27) {
+  const trimmed = path27.replace(/^\/+|\/+$/g, "");
+  if (!trimmed) return "home";
+  return trimmed.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase();
+}
+function pageCardConfig(base, route, brand) {
+  const override = base.cards?.[route.path] ?? base.cards?.[slugForPath(route.path)];
+  const title = route.title ? stripBrandSuffix(route.title, brand) : titleFromPath(route.path);
+  const derived = {
+    ...base,
+    // `cards` is a build-time instruction, not part of a rendered card.
+    cards: void 0,
+    content: {
+      ...base.content,
+      kicker: kickerFromPath(route.path, base.content.kicker),
+      title,
+      subtitle: clampSubtitle(route.description) ?? base.content.subtitle
+    }
+  };
+  if (!override) return derived;
+  return {
+    ...derived,
+    ...override,
+    content: { ...derived.content, ...override.content }
+  };
+}
+
+// src/cli/commands/og.ts
 var execFileAsync5 = promisify(execFile$1);
+var RENDER_CONCURRENCY = 4;
 var CHROME_CANDIDATES = [
   process.env.SONOR_CHROME_PATH,
   "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
@@ -27237,32 +27348,139 @@ function inlinePublicPaths(html, cwd) {
     return existsSync(full) ? `src="file://${full}"` : `src="${p}"`;
   });
 }
-async function verifyMetadataWiring(cwd) {
-  const problems = [];
-  const layoutPath = ["app/layout.tsx", "src/app/layout.tsx"].map((r) => path10.join(cwd, r)).find(existsSync);
-  if (!layoutPath) return ["no app/layout.tsx found to verify metadata"];
-  const layout = await fs3.readFile(layoutPath, "utf-8");
-  if (!/og\.png|opengraph-image|og:image|images:\s*\[/.test(layout)) {
-    problems.push("layout metadata never references the card \u2014 add openGraph.images: ['/og.png']");
+async function renderCard(config2, outPath, cwd, chrome, tmpSuffix) {
+  const tmpHtml = path10.join(cwd, `.sonor-og-${tmpSuffix}.html`);
+  try {
+    await fs3.mkdir(path10.dirname(outPath), { recursive: true });
+    await fs3.writeFile(tmpHtml, inlinePublicPaths(buildOgHtml(config2), cwd));
+    const { stdout } = await execFileAsync5(
+      chrome,
+      [
+        "--headless=new",
+        "--disable-gpu",
+        "--hide-scrollbars",
+        "--window-size=1200,630",
+        "--virtual-time-budget=10000",
+        `--screenshot=${outPath}`,
+        "--dump-dom",
+        `file://${tmpHtml}`
+      ],
+      { maxBuffer: 32 * 1024 * 1024 }
+    );
+    return parseReport(stdout);
+  } finally {
+    await fs3.rm(tmpHtml, { force: true });
+  }
+}
+function parseReport(dom) {
+  const raw = dom.match(new RegExp(`${OG_REPORT_ATTR}="([^"]*)"`))?.[1];
+  if (!raw) {
+    return { fits: true, titlePx: TITLE_MAX_PX, issues: ["card rendered but could not be measured (fitter did not run)"] };
   }
-  if (!/summary_large_image/.test(layout)) {
-    problems.push("twitter.card is not 'summary_large_image' \u2014 previews render as a small square");
+  try {
+    const decoded = raw.replace(/&quot;/g, '"').replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">");
+    return JSON.parse(decoded);
+  } catch {
+    return { fits: true, titlePx: TITLE_MAX_PX, issues: ["card rendered but the fit report was unreadable"] };
   }
-  const ogTitle = layout.match(/openGraph[\s\S]{0,400}?title:\s*['"`]([^'"`]+)/)?.[1];
-  if (ogTitle && ogTitle.length > 60) {
-    problems.push(`og:title is ${ogTitle.length} chars \u2014 iMessage/Facebook truncate around 60`);
+}
+async function compressCard(pngPath, cwd) {
+  try {
+    const require_ = (await import('module')).createRequire(path10.join(cwd, "package.json"));
+    const sharp = require_("sharp");
+    const jpgPath = pngPath.replace(/\.png$/, ".jpg");
+    await sharp(pngPath).jpeg({ quality: 84, mozjpeg: true }).toFile(jpgPath);
+    await fs3.rm(pngPath, { force: true });
+    return jpgPath;
+  } catch {
+    return pngPath;
+  }
+}
+function discoverDynamicSegments(appDir) {
+  const found = [];
+  const walk = (dir, urlSegments) => {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
+      if (entry.name === "api" || entry.name === "node_modules") continue;
+      const full = path10.join(dir, entry.name);
+      const isGroup = entry.name.startsWith("(") && entry.name.endsWith(")");
+      const isDynamic = entry.name.startsWith("[") && entry.name.endsWith("]");
+      const nextUrl = isGroup || isDynamic ? urlSegments : [...urlSegments, entry.name];
+      if (isDynamic) {
+        const hasPage = ["tsx", "jsx", "ts", "js"].some((ext2) => existsSync(path10.join(full, `page.${ext2}`)));
+        if (hasPage) found.push({ dir: full, urlish: `/${urlSegments.join("/")}` });
+      }
+      walk(full, nextUrl);
+    }
+  };
+  walk(appDir, []);
+  return found;
+}
+async function pooled(items, limit, fn) {
+  const results = new Array(items.length);
+  let cursor = 0;
+  const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+    while (cursor < items.length) {
+      const i = cursor++;
+      results[i] = await fn(items[i], i);
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+async function resolveRouteCopy(paths) {
+  let getSEOPageData = null;
+  try {
+    if (process.env.SONOR_API_KEY) {
+      ;
+      ({ getSEOPageData } = await import('../api-NTHZ6PAW.mjs'));
+    }
+  } catch {
+    getSEOPageData = null;
   }
-  return problems;
+  if (!getSEOPageData) return paths.map((p) => ({ path: p }));
+  return pooled(paths, RENDER_CONCURRENCY, async (p) => {
+    try {
+      const page = await getSEOPageData("", p);
+      const title = page?.managed_title ?? page?.managed_og_title;
+      const description = page?.managed_meta_description ?? page?.managed_og_description;
+      return { path: p, title: title || void 0, description: description || void 0 };
+    } catch {
+      return { path: p };
+    }
+  });
+}
+function reportCard(label, report) {
+  if (report.fits && !report.issues.length) {
+    const shrunk = report.titlePx < TITLE_MAX_PX ? source_default.gray(` (title fitted to ${report.titlePx}px)`) : "";
+    console.log(`    ${source_default.green("\u2713")} ${label}${shrunk}`);
+    return true;
+  }
+  console.log(`    ${report.fits ? source_default.yellow("!") : source_default.red("\u2717")} ${label}`);
+  for (const issue of report.issues) {
+    console.log(source_default.gray(`        ${issue}`));
+  }
+  return report.fits;
 }
 async function ogCommand(options) {
+  const ctx = makeContext("og", options);
+  await runCommand(ctx, () => runOg(options));
+}
+async function runOg(options) {
   console.log("");
-  console.log(source_default.bold("  Generate Open Graph card"));
+  console.log(source_default.bold("  Generate Open Graph cards"));
   console.log("");
   const cwd = process.cwd();
+  const checks = [];
   const chrome = findChrome();
   if (!chrome) {
     console.log(source_default.red("  \u2717 No Chrome/Chromium found. Set SONOR_CHROME_PATH or install Chrome."));
-    process.exit(1);
+    return {
+      exitCode: 1 /* FAILED */,
+      summary: "No Chrome/Chromium found",
+      errors: [{ code: "chrome_missing", message: "No Chrome or Chromium binary found", fix: "Install Chrome, or set SONOR_CHROME_PATH to its path." }]
+    };
   }
   let config2 = await loadConfig4(cwd);
   let seeded = false;
@@ -27272,49 +27490,173 @@ async function ogCommand(options) {
     console.log(source_default.yellow("  ! No og.config.ts \u2014 generating a seed card from Sonor brand data."));
     console.log(source_default.gray("    The site owns its theme: add og.config.ts (defineOgCard) with the real palette."));
   }
-  const spinner = ora("Rendering with headless Chrome...").start();
   const outPath = path10.resolve(cwd, options.out || "public/og.png");
-  const tmpHtml = path10.join(cwd, ".sonor-og-tmp.html");
+  let clean = true;
+  let pageCardsWritten = 0;
+  let totalCardBytes = 0;
+  const spinner = ora("Rendering the site card...").start();
   try {
-    const html = inlinePublicPaths(buildOgHtml(config2), cwd);
-    await fs3.writeFile(tmpHtml, html);
-    await execFileAsync5(chrome, [
-      "--headless=new",
-      "--disable-gpu",
-      "--hide-scrollbars",
-      "--window-size=1200,630",
-      "--virtual-time-budget=10000",
-      `--screenshot=${outPath}`,
-      `file://${tmpHtml}`
-    ]);
-    spinner.succeed(`Wrote ${path10.relative(cwd, outPath)} (1200x630${seeded ? ", seed card" : ""})`);
-    if (options.preview !== false) {
-      try {
-        const require_ = (await import('module')).createRequire(path10.join(cwd, "package.json"));
-        const sharp = require_("sharp");
-        const previewPath = path10.join(cwd, "public/og-preview.png");
-        await sharp(outPath).resize(300).toFile(previewPath);
-        console.log(source_default.gray(`  Preview at thumbnail size: ${path10.relative(cwd, previewPath)} \u2014 if text is mush there, fix the card.`));
-      } catch {
-        console.log(source_default.gray("  (sharp not resolvable \u2014 skipped the 300px preview)"));
+    const report = await renderCard(config2, outPath, cwd, chrome, "site");
+    spinner.stop();
+    console.log(source_default.bold(`  Site card${seeded ? source_default.gray(" (seed)") : ""}`));
+    clean = reportCard(`${path10.relative(cwd, outPath)} \u2014 1200x630`, report) && clean;
+    checks.push(cardCheck("site card", path10.relative(cwd, outPath), report));
+  } catch (err) {
+    const message = err instanceof Error ? err.message.split("\n")[0] : String(err);
+    spinner.fail(`Render failed: ${message}`);
+    return {
+      exitCode: 1 /* FAILED */,
+      summary: `Site card render failed: ${message}`,
+      errors: [{ code: "render_failed", message, fix: "Check og.config.ts loads and the referenced assets exist under public/." }]
+    };
+  }
+  if (options.pages !== false) {
+    const appDir = findAppDirForDiscovery(cwd);
+    if (!appDir) {
+      console.log(source_default.yellow("  ! No app/ directory found \u2014 skipped per-page cards."));
+    } else {
+      const routes = [...new Set(discoverNextJsRoutes(appDir).map((r) => r.path))];
+      if (!routes.length) {
+        console.log(source_default.yellow("  ! No static routes discovered \u2014 skipped per-page cards."));
+      } else {
+        console.log("");
+        console.log(source_default.bold(`  Page cards`));
+        const copySpinner = ora("Reading managed titles from Sonor...").start();
+        const withCopy = await resolveRouteCopy(routes);
+        const named = withCopy.filter((r) => r.title).length;
+        copySpinner.stop();
+        if (named) {
+          console.log(source_default.gray(`    ${named}/${routes.length} titled from Sonor, the rest from the route path`));
+        } else {
+          console.log(source_default.gray("    titled from route paths (no SONOR_API_KEY, or no managed titles yet)"));
+        }
+        const brand = config2.content.title.replace(/\n/g, " ").trim();
+        const copyByPath = new Map(withCopy.map((r) => [r.path, r]));
+        const dynamic = discoverDynamicSegments(appDir).map((seg) => ({
+          ...copyByPath.get(seg.urlish) ?? { path: seg.urlish },
+          path: `${seg.urlish}/*`,
+          dir: seg.dir
+        }));
+        const targets = [...withCopy, ...dynamic];
+        const reports = await pooled(targets, RENDER_CONCURRENCY, async (route, i) => {
+          const pageConfig = pageCardConfig(config2, route, brand);
+          const dir = route.dir ?? routeOutputDir(appDir, route.path);
+          for (const ext2 of ["png", "jpg", "jpeg"]) {
+            await fs3.rm(path10.join(dir, `opengraph-image.${ext2}`), { force: true });
+          }
+          const png = path10.join(dir, "opengraph-image.png");
+          const report = await renderCard(pageConfig, png, cwd, chrome, `page-${i}`);
+          const file = await compressCard(png, cwd);
+          return { route, file, report };
+        });
+        for (const { route, file, report } of reports) {
+          clean = reportCard(`${route.path}  ${source_default.gray(path10.relative(cwd, file))}`, report) && clean;
+          checks.push(cardCheck(route.path, path10.relative(cwd, file), report));
+        }
+        pageCardsWritten = reports.length;
+        const bytes = await totalBytes(reports.map((r) => r.file));
+        totalCardBytes = bytes;
+        console.log(source_default.gray(`    ${(bytes / 1024 / 1024).toFixed(1)} MB of cards. Next serves these automatically \u2014 no per-page metadata needed.`));
       }
     }
-    const problems = await verifyMetadataWiring(cwd);
-    if (problems.length) {
+  }
+  if (options.preview !== false) {
+    try {
+      const require_ = (await import('module')).createRequire(path10.join(cwd, "package.json"));
+      const sharp = require_("sharp");
+      const previewPath = path10.join(cwd, ".sonor", "og-preview.png");
+      await fs3.mkdir(path10.dirname(previewPath), { recursive: true });
+      await sharp(outPath).resize(300).toFile(previewPath);
       console.log("");
-      console.log(source_default.yellow("  Metadata wiring:"));
-      for (const p of problems) console.log(source_default.yellow(`    ! ${p}`));
-    } else {
-      console.log(source_default.green("  \u2713 Metadata wiring looks right (og:image, summary_large_image, title length)"));
+      console.log(source_default.gray(`  Thumbnail check: ${path10.relative(cwd, previewPath)} \u2014 if text is mush there, fix the card.`));
+    } catch {
+      console.log(source_default.gray("  (sharp not resolvable \u2014 skipped the 300px preview)"));
     }
-    console.log(source_default.gray("  Reminder: Facebook caches cards \u2014 re-scrape at developers.facebook.com/tools/debug/"));
+  }
+  const problems = checkOgWiring(cwd);
+  console.log("");
+  if (problems.length) {
+    console.log(source_default.yellow("  Metadata wiring:"));
+    for (const p of problems) {
+      console.log(source_default.yellow(`    ! ${p.message}`));
+      console.log(source_default.gray(`      ${p.fix}`));
+    }
+  } else {
+    console.log(source_default.green("  \u2713 Metadata wiring looks right (og:image, summary_large_image, title length)"));
+  }
+  const domain = await siteDomain(cwd);
+  console.log(
+    source_default.gray(
+      `  Facebook caches cards \u2014 re-scrape at https://developers.facebook.com/tools/debug/${domain ? `?q=${encodeURIComponent(domain)}` : ""}`
+    )
+  );
+  console.log("");
+  if (!clean) {
+    console.log(source_default.red("  \u2717 One or more cards do not fit. Fix the copy above and re-run."));
     console.log("");
-  } catch (err) {
-    spinner.fail(`Render failed: ${err instanceof Error ? err.message.split("\n")[0] : err}`);
-    process.exit(1);
-  } finally {
-    await fs3.rm(tmpHtml, { force: true });
   }
+  for (const problem of problems) {
+    checks.push({
+      id: "og.wiring",
+      title: "Metadata wiring",
+      level: "warn",
+      message: problem.message,
+      fix: problem.fix
+    });
+  }
+  const cards = 1 + pageCardsWritten;
+  return {
+    exitCode: clean ? 0 /* OK */ : 1 /* FAILED */,
+    summary: clean ? `${cards} card${cards === 1 ? "" : "s"} rendered, all fitting` : `${cards} card${cards === 1 ? "" : "s"} rendered, some do not fit`,
+    data: { cards, bytes: totalCardBytes },
+    checks,
+    nextSteps: problems.map((p) => p.fix)
+  };
+}
+function cardCheck(label, file, report) {
+  const clean = report.fits && !report.issues.length;
+  return {
+    id: "og.card",
+    title: label,
+    level: clean ? "ok" : report.fits ? "warn" : "error",
+    message: clean ? `${file} (title ${report.titlePx}px)` : report.issues.join("; "),
+    ...clean ? {} : { fix: "Shorten the copy for this card, or give it an override in og.config.ts `cards`." }
+  };
+}
+function routeOutputDir(appDir, urlPath) {
+  const segments = urlPath.split("/").filter(Boolean);
+  let dir = appDir;
+  for (const segment of segments) {
+    const direct = path10.join(dir, segment);
+    if (existsSync(direct)) {
+      dir = direct;
+      continue;
+    }
+    const group = existsSync(dir) ? readdirSync(dir, { withFileTypes: true }).find(
+      (e) => e.isDirectory() && e.name.startsWith("(") && e.name.endsWith(")") && existsSync(path10.join(dir, e.name, segment))
+    ) : void 0;
+    dir = group ? path10.join(dir, group.name, segment) : direct;
+  }
+  return dir;
+}
+async function totalBytes(files) {
+  let total = 0;
+  for (const f of files) {
+    try {
+      total += (await fs3.stat(f)).size;
+    } catch {
+    }
+  }
+  return total;
+}
+async function siteDomain(cwd) {
+  const envFile = path10.join(cwd, ".env.local");
+  if (existsSync(envFile)) {
+    const env3 = await fs3.readFile(envFile, "utf-8").catch(() => "");
+    const url = env3.match(/^NEXT_PUBLIC_SITE_URL=(.+)$/m)?.[1]?.trim();
+    if (url) return url.replace(/\/+$/, "");
+  }
+  return null;
 }
 var execFileAsync6 = promisify(execFile$1);
 async function next16Command() {
@@ -27433,14 +27775,14 @@ var hs = new RegExp(pe, "g");
 var as = /\\\\/g;
 var ls = /\\{/g;
 var cs = /\\}/g;
-var fs19 = /\\,/g;
+var fs20 = /\\,/g;
 var us = /\\./g;
 var ds = 1e5;
 function Ht(n5) {
   return isNaN(n5) ? n5.charCodeAt(0) : parseInt(n5, 10);
 }
 function ps(n5) {
-  return n5.replace(as, fe).replace(ls, ue).replace(cs, qt).replace(fs19, de).replace(us, pe);
+  return n5.replace(as, fe).replace(ls, ue).replace(cs, qt).replace(fs20, de).replace(us, pe);
 }
 function ms(n5) {
   return n5.replace(is, "\\").replace(rs, "{").replace(ns, "}").replace(os5, ",").replace(hs, ".");
@@ -32034,7 +32376,7 @@ withAgentFlags(
   program2.command("manifest").description("Print the machine-readable agent manifest (modules, env, patterns, failure modes)").option("--section <name>", "Print one section: env | modules | commands | blessedPatterns | failureModes")
 ).action(manifestCommand);
 withAgentFlags(
-  program2.command("og").description("Generate the Open Graph card (public/og.png) from og.config.ts via headless Chrome").option("--no-preview", "Skip the 300px thumbnail legibility preview").option("--out <path>", "Output path (default public/og.png)")
+  program2.command("og").description("Generate Open Graph cards \u2014 the site card plus one per page \u2014 via headless Chrome").option("--no-preview", "Skip the 300px thumbnail legibility preview").option("--no-pages", "Only render the site card, skip the per-page cards").option("--out <path>", "Site card output path (default public/og.png)")
 ).action(ogCommand);
 withAgentFlags(
   program2.command("next16").description("Migrate middleware.ts to proxy.ts (official codemod) and verify")