@brandsystem/mcp 0.3.0

package/dist/lib/logo-extractor.js

@@ -0,0 +1,384 @@
+import * as cheerio from "cheerio";
+import { getVersion } from "./version.js";
+import { safeFetch } from "./url-validator.js";
+// ── Icon filtering ──────────────────────────────────────────────
+// SVGs that are clearly NOT logos
+const ICON_CLASSES = /chevron|arrow|close|hamburger|caret|toggle|spinner|loader|decoration|ornament|pattern/i;
+// Separate patterns that are too broad as substrings — require word boundary or standalone class
+const ICON_STANDALONE = /\b(icon|menu|search|play|pause)\b/i;
+const ICON_DATA_ATTRS = /data-prefix="fa|data-icon|svg-inline--fa/;
+const SOCIAL_ICONS = /twitter|instagram|facebook|linkedin|youtube|dribbble|github|tiktok|pinterest|reddit|discord|slack|whatsapp/i;
+function isIconSvg($, el) {
+    // Override: if this SVG or its parent is explicitly labeled as a logo, it's NOT an icon
+    const ariaLabel = $(el).attr("aria-label") || "";
+    const parentClass = $(el).parent()?.attr("class") || "";
+    const parentHref = $(el).parent()?.attr("href") || "";
+    if (/logo|brand|wordmark/i.test(ariaLabel))
+        return false;
+    if (/logo|brand|wordmark/i.test(parentClass) && /home|\/$/i.test(parentHref))
+        return false;
+    const html = $.html(el);
+    const outerHtml = html || "";
+    // Social media icons (Font Awesome, etc.)
+    if (ICON_DATA_ATTRS.test(outerHtml))
+        return true;
+    if (SOCIAL_ICONS.test(outerHtml))
+        return true;
+    // Tiny utility icons (< 24px)
+    const width = parseInt($(el).attr("width") || "0", 10);
+    const height = parseInt($(el).attr("height") || "0", 10);
+    if (width > 0 && width < 24 && height > 0 && height < 24)
+        return true;
+    // Icon-named classes (exact patterns that don't substring-match in logo contexts)
+    const className = $(el).attr("class") || "";
+    if (ICON_CLASSES.test(className))
+        return true;
+    // Check parent class with standalone patterns (avoid "menu" matching "navigation-menu-home-link")
+    // Split parent class into individual classes and check each
+    const parentClasses = parentClass.split(/\s+/);
+    for (const cls of parentClasses) {
+        if (ICON_CLASSES.test(cls))
+            return true;
+        // Standalone check: only match if the class IS the word (e.g., "menu" but not "menu-home-link")
+        if (ICON_STANDALONE.test(cls) && cls.length < 20)
+            return true;
+    }
+    return false;
+}
+// ── Client logo cloud detection ─────────────────────────────────
+// Detect when an img is inside a logo cloud/carousel (client logos, not the company logo)
+const LOGO_CLOUD_CLASSES = /logo-cloud|logos|clients|partners|carousel|slider|marquee|trust|social-proof|logo-wall|logo-grid|logo-bar|logo-strip|companies|brands|featured-in|as-seen/i;
+function isInLogoCloud($, el) {
+    // Check parents up to 4 levels
+    let current = $(el).parent();
+    for (let i = 0; i < 4; i++) {
+        if (!current.length)
+            break;
+        const cls = current.attr("class") || "";
+        const id = current.attr("id") || "";
+        if (LOGO_CLOUD_CLASSES.test(cls) || LOGO_CLOUD_CLASSES.test(id))
+            return true;
+        // If this parent has 3+ img children with "logo" in src, it's a logo cloud
+        const logoImgs = current.find('img[src*="logo"], img[data-src*="logo"]');
+        if (logoImgs.length >= 3)
+            return true;
+        current = current.parent();
+    }
+    return false;
+}
+// ── Size scoring ────────────────────────────────────────────────
+function getSvgWidthScore(el, $) {
+    const width = parseInt($(el).attr("width") || "0", 10);
+    const viewBox = $(el).attr("viewBox");
+    let vbWidth = 0;
+    if (viewBox) {
+        const parts = viewBox.split(/\s+/);
+        if (parts.length === 4)
+            vbWidth = parseFloat(parts[2]);
+    }
+    const effectiveWidth = width || vbWidth;
+    if (effectiveWidth >= 80)
+        return 3; // Likely a meaningful logo
+    if (effectiveWidth >= 50)
+        return 1; // Possible
+    return -1; // Too small, probably an icon
+}
+/**
+ * Extract logo candidates from HTML.
+ * Returns candidates sorted by confidence (best first).
+ * Filters out icons, social media SVGs, and client logo clouds.
+ */
+export function extractLogos(html, baseUrl) {
+    const $ = cheerio.load(html);
+    const logos = [];
+    const base = baseUrl.replace(/\/$/, "");
+    function resolveUrl(href) {
+        if (!href)
+            return null;
+        if (href.startsWith("data:"))
+            return null;
+        if (href.startsWith("http"))
+            return href;
+        if (href.startsWith("//"))
+            return `https:${href}`;
+        if (href.startsWith("/"))
+            return `${base}${href}`;
+        return `${base}/${href}`;
+    }
+    // ── 1. Inline SVGs in header/nav (HIGHEST priority) ──────────
+    // The first meaningful SVG in header or nav is almost always the company logo
+    const headerNavSvgs = $("header svg, nav svg, .header svg, .navbar svg, .site-header svg");
+    for (let i = 0; i < headerNavSvgs.length; i++) {
+        const el = headerNavSvgs[i];
+        if (isIconSvg($, el))
+            continue;
+        const sizeScore = getSvgWidthScore(el, $);
+        if (sizeScore < 0)
+            continue; // Too small
+        const svgHtml = $.html(el);
+        if (!svgHtml || svgHtml.length < 50 || svgHtml.length > 100_000)
+            continue;
+        // Check for logo-related class/id on the SVG or its parent
+        const cls = $(el).attr("class") || "";
+        const parentCls = $(el).parent()?.attr("class") || "";
+        const parentId = $(el).parent()?.attr("id") || "";
+        const isLogoClassed = /logo|brand|wordmark|site-logo/i.test(cls + parentCls + parentId);
+        logos.push({
+            url: `inline:svg:${Buffer.from(svgHtml).toString("base64").substring(0, 40)}`,
+            type: "selector-svg",
+            confidence: isLogoClassed || sizeScore >= 3 ? "high" : "medium",
+            inline_svg: svgHtml,
+        });
+        // Only take the first good header SVG — it's almost always the logo
+        break;
+    }
+    // ── 2. SVG favicon (clean logomark) ───────────────────────────
+    $('link[rel="icon"][type="image/svg+xml"]').each((_, el) => {
+        const url = resolveUrl($(el).attr("href"));
+        if (url)
+            logos.push({ url, type: "svg-favicon", confidence: "high" });
+    });
+    // ── 3. IMG tags in header/nav with logo indicators ────────────
+    const headerImgSelectors = [
+        'header img[src*="logo"]',
+        'header img[data-src*="logo"]',
+        'header img[alt*="logo" i]',
+        'nav img[src*="logo"]',
+        'nav img[data-src*="logo"]',
+        '.header img[src*="logo"]',
+        '.header img[data-src*="logo"]',
+        'a[href="/"] img',
+    ];
+    for (const sel of headerImgSelectors) {
+        $(sel).each((_, el) => {
+            if (isInLogoCloud($, el))
+                return;
+            // Prefer data-src (lazy-loaded) over src
+            const url = resolveUrl($(el).attr("data-src") || $(el).attr("src"));
+            if (url)
+                logos.push({ url, type: "selector-img", confidence: "high" });
+        });
+    }
+    // ── 4. Logo-classed elements (outside header) ─────────────────
+    const logoClassSelectors = [
+        '.logo img',
+        '#logo img',
+        '[class*="site-logo"] img',
+        '.logo svg',
+        '#logo svg',
+    ];
+    for (const sel of logoClassSelectors) {
+        $(sel).each((_, el) => {
+            if (isInLogoCloud($, el))
+                return;
+            const tagName = el.tagName?.toLowerCase();
+            if (tagName === "svg") {
+                if (isIconSvg($, el))
+                    return;
+                const svgHtml = $.html(el);
+                if (svgHtml && svgHtml.length > 50 && svgHtml.length < 100_000) {
+                    logos.push({
+                        url: `inline:svg:${Buffer.from(svgHtml).toString("base64").substring(0, 40)}`,
+                        type: "selector-svg",
+                        confidence: "medium",
+                        inline_svg: svgHtml,
+                    });
+                }
+            }
+            else {
+                const url = resolveUrl($(el).attr("data-src") || $(el).attr("src"));
+                if (url)
+                    logos.push({ url, type: "selector-img", confidence: "medium" });
+            }
+        });
+    }
+    // ── 5. OG image ───────────────────────────────────────────────
+    const ogImage = $('meta[property="og:image"]').attr("content");
+    if (ogImage) {
+        const url = resolveUrl(ogImage);
+        if (url)
+            logos.push({ url, type: "og-image", confidence: "low" });
+    }
+    // ── 6. Apple touch icon ───────────────────────────────────────
+    $('link[rel="apple-touch-icon"]').each((_, el) => {
+        const url = resolveUrl($(el).attr("href"));
+        if (url)
+            logos.push({ url, type: "apple-touch-icon", confidence: "low" });
+    });
+    // ── 7. Standard favicon ───────────────────────────────────────
+    $('link[rel="icon"], link[rel="shortcut icon"]').each((_, el) => {
+        const url = resolveUrl($(el).attr("href"));
+        if (url)
+            logos.push({ url, type: "favicon", confidence: "low" });
+    });
+    // Deduplicate by URL
+    const seen = new Set();
+    return logos.filter((l) => {
+        if (seen.has(l.url))
+            return false;
+        seen.add(l.url);
+        return true;
+    });
+}
+/**
+ * Try to find a logo via Clearbit's free Logo API.
+ * Returns a high-quality company logo PNG for most domains.
+ */
+export async function fetchClearbitLogo(domain) {
+    const cleanDomain = domain.replace(/^https?:\/\//, "").replace(/^www\./, "").replace(/\/.*$/, "");
+    const url = `https://logo.clearbit.com/${cleanDomain}`;
+    try {
+        const response = await safeFetch(url, {
+            signal: AbortSignal.timeout(5000),
+            headers: { "User-Agent": `brandsystem-mcp/${getVersion()}` },
+        });
+        if (!response.ok)
+            return null;
+        const contentType = response.headers.get("content-type") || "";
+        if (!contentType.includes("image"))
+            return null;
+        const buffer = Buffer.from(await response.arrayBuffer());
+        if (buffer.length < 100)
+            return null; // Too small, probably an error
+        // Convert to data URI
+        const base64 = buffer.toString("base64");
+        const mimeType = contentType.split(";")[0].trim();
+        const data_uri = `data:${mimeType};base64,${base64}`;
+        return {
+            url,
+            type: "clearbit",
+            confidence: "medium",
+            data_uri,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Try common logo file paths on a domain.
+ * Many sites have predictable logo locations.
+ */
+export async function probeCommonLogoPaths(baseUrl) {
+    const base = baseUrl.replace(/\/$/, "");
+    const paths = [
+        "/logo.svg",
+        "/logo.png",
+        "/images/logo.svg",
+        "/images/logo.png",
+        "/assets/logo.svg",
+        "/assets/images/logo.svg",
+        "/img/logo.svg",
+        "/img/logo.png",
+        "/static/logo.svg",
+        "/static/logo.png",
+    ];
+    for (const path of paths) {
+        try {
+            const url = `${base}${path}`;
+            const response = await safeFetch(url, {
+                signal: AbortSignal.timeout(3000),
+                method: "HEAD",
+                headers: { "User-Agent": `brandsystem-mcp/${getVersion()}` },
+            });
+            if (response.ok) {
+                const contentType = response.headers.get("content-type") || "";
+                if (contentType.includes("svg") || contentType.includes("image")) {
+                    return {
+                        url,
+                        type: "common-path",
+                        confidence: "medium",
+                    };
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * Google's favicon service — GUARANTEED to return something for any domain.
+ * Returns a 256x256 favicon. This is the floor — we always get at least this.
+ */
+export async function fetchGoogleFavicon(domain) {
+    const cleanDomain = domain.replace(/^https?:\/\//, "").replace(/^www\./, "").replace(/\/.*$/, "");
+    const url = `https://www.google.com/s2/favicons?domain=${cleanDomain}&sz=256`;
+    try {
+        const response = await safeFetch(url, {
+            signal: AbortSignal.timeout(5000),
+            headers: { "User-Agent": `brandsystem-mcp/${getVersion()}` },
+        });
+        if (!response.ok)
+            return null;
+        const buffer = Buffer.from(await response.arrayBuffer());
+        if (buffer.length < 100)
+            return null;
+        const contentType = response.headers.get("content-type") || "image/png";
+        const base64 = buffer.toString("base64");
+        const mimeType = contentType.split(";")[0].trim();
+        return {
+            url,
+            type: "favicon",
+            confidence: "low",
+            data_uri: `data:${mimeType};base64,${base64}`,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch any logo candidate URL and convert to a data URI.
+ * Works for SVG, PNG, JPG, ICO — anything fetchable.
+ * Returns both the raw content (for file writing) and a data_uri (for embedding).
+ */
+export async function fetchAndEncodeLogo(url) {
+    if (url.startsWith("inline:"))
+        return null;
+    try {
+        const response = await safeFetch(url, {
+            signal: AbortSignal.timeout(10000),
+            headers: { "User-Agent": `brandsystem-mcp/${getVersion()}` },
+        });
+        if (!response.ok)
+            return null;
+        const contentType = response.headers.get("content-type") || "";
+        const buffer = Buffer.from(await response.arrayBuffer());
+        if (buffer.length > 500_000)
+            return null;
+        const base64 = buffer.toString("base64");
+        const mimeType = contentType.split(";")[0].trim() || "image/png";
+        const data_uri = `data:${mimeType};base64,${base64}`;
+        return { content: buffer, contentType, data_uri };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch a logo URL and return its content.
+ * Returns null if fetch fails or content is too large (>500KB).
+ */
+export async function fetchLogo(url) {
+    if (url.startsWith("inline:"))
+        return null;
+    try {
+        const response = await safeFetch(url, {
+            signal: AbortSignal.timeout(10000),
+            headers: { "User-Agent": `brandsystem-mcp/${getVersion()}` },
+        });
+        if (!response.ok)
+            return null;
+        const contentType = response.headers.get("content-type") || "";
+        const buffer = Buffer.from(await response.arrayBuffer());
+        if (buffer.length > 500_000)
+            return null; // too large
+        return { content: buffer, contentType };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=logo-extractor.js.map

package/dist/lib/logo-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo-extractor.js","sourceRoot":"","sources":["../../src/lib/logo-extractor.ts"],"names":[],"mappings":"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"}

package/dist/lib/report-html.d.ts

@@ -0,0 +1,20 @@
+import type { CoreIdentity, BrandConfig, ClarificationItem } from "../types/index.js";
+export interface ReportData {
+    config: BrandConfig;
+    identity: CoreIdentity;
+    clarifications: ClarificationItem[];
+    tokenCount: number;
+    auditSummary: {
+        pass: number;
+        warn: number;
+        fail: number;
+    };
+}
+/**
+ * Generate a plain-text brand instruction block that can be pasted
+ * into any AI tool's custom instructions / project context / system prompt.
+ * Written as a directive to an AI, not a description for a human.
+ */
+export declare function generateBrandInstructions(config: BrandConfig, identity: CoreIdentity): string;
+export declare function generateReportHTML(data: ReportData): string;
+//# sourceMappingURL=report-html.d.ts.map

package/dist/lib/report-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-html.d.ts","sourceRoot":"","sources":["../../src/lib/report-html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAwE7F;AAwVD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAuiB3D"}