@brandsystem/mcp 0.3.0

package/dist/tools/brand-check-compliance.js

@@ -0,0 +1,243 @@
+import { z } from "zod";
+import { readFile } from "node:fs/promises";
+import { BrandDir } from "../lib/brand-dir.js";
+import { buildResponse, safeParseParams } from "../lib/response.js";
+import { loadBrandContext, isHtmlContent } from "../lib/content-scorer.js";
+import * as cheerio from "cheerio";
+import { ERROR_CODES } from "../types/index.js";
+// ---------------------------------------------------------------------------
+// Inline utilities (fast-path versions — no full scoring overhead)
+// ---------------------------------------------------------------------------
+function normalizeHex(hex) {
+    let h = hex.toLowerCase().trim();
+    if (/^#[0-9a-f]{3}$/.test(h))
+        h = `#${h[1]}${h[1]}${h[2]}${h[2]}${h[3]}${h[3]}`;
+    if (/^#[0-9a-f]{8}$/.test(h))
+        h = h.slice(0, 7);
+    return h;
+}
+function rgbToHex(rgb) {
+    const match = rgb.match(/rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/);
+    if (!match)
+        return null;
+    const [, r, g, b] = match;
+    const toHex = (n) => parseInt(n, 10).toString(16).padStart(2, "0");
+    return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+function extractCssColors(css) {
+    const colors = [];
+    let m;
+    const hexRe = /#[0-9a-fA-F]{3,8}\b/g;
+    while ((m = hexRe.exec(css)) !== null)
+        colors.push(normalizeHex(m[0]));
+    const rgbRe = /rgba?\(\s*\d+\s*,\s*\d+\s*,\s*\d+(?:\s*,\s*[\d.]+)?\s*\)/g;
+    while ((m = rgbRe.exec(css)) !== null) {
+        const hex = rgbToHex(m[0]);
+        if (hex)
+            colors.push(normalizeHex(hex));
+    }
+    return [...new Set(colors)];
+}
+function extractFontFamilies(css) {
+    const families = [];
+    const re = /font-family\s*:\s*([^;}"]+)/gi;
+    let m;
+    while ((m = re.exec(css)) !== null) {
+        for (const part of m[1].split(",")) {
+            const clean = part.trim().replace(/^['"]|['"]$/g, "").trim();
+            if (clean)
+                families.push(clean);
+        }
+    }
+    return [...new Set(families)];
+}
+const SYSTEM_FONTS = new Set([
+    "serif", "sans-serif", "monospace", "cursive", "fantasy", "system-ui",
+    "ui-serif", "ui-sans-serif", "ui-monospace", "ui-rounded",
+    "-apple-system", "blinkmacsystemfont", "segoe ui", "roboto",
+    "helvetica neue", "arial", "noto sans", "liberation sans",
+    "helvetica", "times new roman", "times", "georgia", "courier new",
+    "courier", "verdana", "tahoma", "trebuchet ms", "lucida grande",
+    "lucida sans unicode", "lucida console", "monaco", "menlo", "consolas",
+]);
+const NEUTRAL_COLORS = new Set([
+    "#000000", "#ffffff", "#111111", "#222222", "#333333", "#444444",
+    "#555555", "#666666", "#777777", "#888888", "#999999",
+    "#aaaaaa", "#bbbbbb", "#cccccc", "#dddddd", "#eeeeee",
+    "#f5f5f5", "#f8f8f8", "#fafafa",
+]);
+const ANTI_PATTERN_MATCHERS = [
+    { keywords: ["drop shadow", "drop-shadow", "box shadow", "box-shadow"], test: (css) => /box-shadow\s*:/i.test(css) || /text-shadow\s*:/i.test(css) || /filter\s*:.*drop-shadow/i.test(css) },
+    { keywords: ["gradient"], test: (css) => /(?:linear|radial|conic)-gradient/i.test(css) },
+    { keywords: ["border radius", "border-radius", "rounded corner", "pill shape"], test: (css) => /border-radius\s*:/i.test(css) },
+    { keywords: ["blur"], test: (css) => /filter\s*:.*blur/i.test(css) || /backdrop-filter\s*:.*blur/i.test(css) },
+];
+function matchAntiPattern(rule, css) {
+    const lower = rule.toLowerCase();
+    for (const m of ANTI_PATTERN_MATCHERS) {
+        if (m.keywords.some((kw) => lower.includes(kw)))
+            return m.test(css);
+    }
+    return false;
+}
+function countOccurrences(text, pattern) {
+    const lower = text.toLowerCase();
+    const target = pattern.toLowerCase();
+    let count = 0, idx = 0;
+    while ((idx = lower.indexOf(target, idx)) !== -1) {
+        count++;
+        idx += target.length;
+    }
+    return count;
+}
+// ---------------------------------------------------------------------------
+// Content resolution
+// ---------------------------------------------------------------------------
+async function resolveContent(input) {
+    if (/\.(html?|md|txt)$/i.test(input.trim()) && !input.includes("\n") && input.length < 500) {
+        try {
+            const content = await readFile(input.trim(), "utf-8");
+            return { content, isHtml: /\.html?$/i.test(input.trim()) || isHtmlContent(content) };
+        }
+        catch { /* not a file */ }
+    }
+    return { content: input, isHtml: isHtmlContent(input) };
+}
+async function handler(input) {
+    const brandDir = new BrandDir(process.cwd());
+    if (!(await brandDir.exists())) {
+        return buildResponse({
+            what_happened: "No .brand/ directory found",
+            next_steps: ["Run brand_start to create a brand system first"],
+            data: { error: ERROR_CODES.NOT_INITIALIZED },
+        });
+    }
+    let ctx;
+    try {
+        ctx = await loadBrandContext(brandDir);
+    }
+    catch {
+        return buildResponse({
+            what_happened: "Could not read brand identity data",
+            next_steps: ["Run brand_extract_web to populate core identity"],
+            data: { error: ERROR_CODES.NO_CORE_IDENTITY },
+        });
+    }
+    const { content, isHtml } = await resolveContent(input.content);
+    const checks = [];
+    const layersChecked = ["core_identity"];
+    // Parse HTML
+    let css = "";
+    let text = content;
+    if (isHtml) {
+        const $ = cheerio.load(content);
+        const parts = [];
+        $("style").each((_i, el) => { const t = $(el).text(); if (t)
+            parts.push(t); });
+        $("[style]").each((_i, el) => { const s = $(el).attr("style"); if (s)
+            parts.push(s); });
+        css = parts.join("\n");
+        $("script, style, noscript, svg, iframe").remove();
+        text = $("body").text() || $.text();
+    }
+    // --- Critical color check ---
+    if (ctx.identity.colors.length > 0 && isHtml && css) {
+        const brandColors = new Set(ctx.identity.colors.map((c) => normalizeHex(c.value)));
+        const usedColors = extractCssColors(css);
+        const offPalette = usedColors.filter((c) => !brandColors.has(c) && !NEUTRAL_COLORS.has(c));
+        checks.push({
+            id: "CRT-COLOR",
+            status: offPalette.length > 0 ? "fail" : "pass",
+            message: offPalette.length > 0
+                ? `${offPalette.length} off-palette color(s): ${offPalette.slice(0, 3).join(", ")}`
+                : "All colors on-palette",
+        });
+    }
+    // --- Critical font check ---
+    if (ctx.identity.typography.length > 0 && isHtml && css) {
+        const brandFonts = new Set(ctx.identity.typography.map((t) => t.family.toLowerCase()));
+        const customFonts = extractFontFamilies(css).filter((f) => !SYSTEM_FONTS.has(f.toLowerCase()));
+        const nonBrand = customFonts.filter((f) => !brandFonts.has(f.toLowerCase()));
+        checks.push({
+            id: "CRT-FONT",
+            status: nonBrand.length > 0 ? "fail" : "pass",
+            message: nonBrand.length > 0
+                ? `Non-brand font(s): ${nonBrand.join(", ")}`
+                : "All fonts are brand fonts",
+        });
+    }
+    // --- Hard anti-pattern checks (Session 2+) ---
+    if (ctx.visual && ctx.visual.anti_patterns.length > 0 && isHtml && css) {
+        layersChecked.push("visual_identity");
+        for (const ap of ctx.visual.anti_patterns) {
+            if (ap.severity === "hard" || input.strict) {
+                const violated = matchAntiPattern(ap.rule, css);
+                checks.push({
+                    id: ap.preflight_id || `AP-${ap.rule.slice(0, 15).replace(/\s+/g, "-")}`,
+                    status: violated ? "fail" : "pass",
+                    message: violated ? `Anti-pattern violated: ${ap.rule}` : `OK: ${ap.rule}`,
+                    detail: violated ? `Severity: ${ap.severity}` : undefined,
+                });
+            }
+        }
+    }
+    // --- Never-say checks (Session 3+) ---
+    if (ctx.messaging?.voice) {
+        layersChecked.push("messaging");
+        for (const ns of ctx.messaging.voice.vocabulary.never_say) {
+            const count = countOccurrences(text, ns.word);
+            checks.push({
+                id: `NS-${ns.word.replace(/\s+/g, "-")}`,
+                status: count > 0 ? "fail" : "pass",
+                message: count > 0
+                    ? `Never-say word "${ns.word}" found (${count}x)`
+                    : `OK: "${ns.word}" not found`,
+                detail: count > 0 ? ns.reason : undefined,
+            });
+        }
+    }
+    // --- Result ---
+    const failures = checks.filter((c) => c.status === "fail");
+    const pass = failures.length === 0;
+    return buildResponse({
+        what_happened: pass
+            ? `Compliance check: PASS (${checks.length} rules checked, 0 failures)`
+            : `Compliance check: FAIL (${checks.length} rules checked, ${failures.length} failure(s))`,
+        next_steps: pass
+            ? ["Content passes compliance — safe to publish"]
+            : [
+                `Fix ${failures.length} failing rule(s) before publishing`,
+                "Run brand_audit_content for detailed scoring breakdown",
+            ],
+        data: {
+            result: pass ? "pass" : "fail",
+            rules_checked: checks.length,
+            failures: failures.length,
+            checks: checks.slice(0, 20),
+            strict_mode: input.strict,
+            layers_checked: layersChecked,
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+const paramsShape = {
+    content: z
+        .string()
+        .describe("Content to check: raw text, HTML string, or a file path ending in .html/.htm/.md/.txt"),
+    strict: z
+        .boolean()
+        .default(false)
+        .describe("Strict mode: treat soft anti-patterns as failures too (default: only hard anti-patterns fail)"),
+};
+const ParamsSchema = z.object(paramsShape);
+export function register(server) {
+    server.tool("brand_check_compliance", "Check if content is on-brand — fast pass/fail gate for brand compliance before publishing. Use when asked 'is this on-brand?', 'brand compliance gate', 'can I publish this?', or in CI/CD pipelines. Verifies on-palette colors, brand fonts, anti-pattern rules, and never-say words. Returns PASS or FAIL with specific failures. Enable strict mode for soft anti-patterns. For detailed 0-100 scoring, use brand_audit_content. NOT for HTML/CSS rule checking (use brand_preflight).", paramsShape, async (args) => {
+        const parsed = safeParseParams(ParamsSchema, args);
+        if (!parsed.success)
+            return parsed.response;
+        return handler(parsed.data);
+    });
+}
+//# sourceMappingURL=brand-check-compliance.js.map

package/dist/tools/brand-check-compliance.js.map

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

package/dist/tools/brand-clarify.d.ts

@@ -0,0 +1,21 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Match a natural-language color description (e.g. "purple", "dark", "the light one")
+ * to the best-matching hex value from a list of colors.
+ * Returns the hex string of the best match, or null if no keyword matched.
+ */
+export declare function matchColorByDescription(desc: string, colors: Array<{
+    value: string;
+    role: string;
+}>): string | null;
+/**
+ * Match a natural-language color description to the top N best-matching hex values.
+ * Used when the user refers to colors in the plural ("the coral/red ones are secondary").
+ * Returns up to `limit` hex strings sorted by score (best first), or empty array if no match.
+ */
+export declare function matchMultipleColorsByDescription(desc: string, colors: Array<{
+    value: string;
+    role: string;
+}>, limit?: number): string[];
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=brand-clarify.d.ts.map

package/dist/tools/brand-clarify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-clarify.d.ts","sourceRoot":"","sources":["../../src/tools/brand-clarify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgKzE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,MAAM,GAAG,IAAI,CAmBf;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9C,KAAK,SAAI,GACR,MAAM,EAAE,CAeV;AA2UD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAWzC"}