@prenta/core 0.118.0

package/dist/ai/brand-voice-sources.js

@@ -0,0 +1,106 @@
+/**
+ * External sources for brand voice analysis — SSRF-safe URL fetch and pasted uploads.
+ */
+import { safeFetch, SsrfBlockedError } from '../security/safe-fetch.js';
+import { stripHtmlTags } from '../seo/analysis.js';
+export const MAX_ANALYZE_URLS = 5;
+export const MAX_ANALYZE_UPLOADS = 5;
+export const MAX_UPLOAD_TEXT_CHARS = 15_000;
+export const MAX_URL_FETCH_CHARS = 8_000;
+export const MAX_URL_FETCH_BYTES = 512 * 1024;
+function clampText(text, max) {
+    return text.replace(/\s+/g, ' ').trim().slice(0, max);
+}
+function extractHtmlTitle(html) {
+    const match = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+    if (!match?.[1])
+        return 'Web page';
+    return stripHtmlTags(match[1]).slice(0, 200) || 'Web page';
+}
+function extractReadableText(html) {
+    const withoutScripts = html
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<nav[\s\S]*?<\/nav>/gi, ' ')
+        .replace(/<footer[\s\S]*?<\/footer>/gi, ' ');
+    return clampText(stripHtmlTags(withoutScripts), MAX_URL_FETCH_CHARS);
+}
+export class BrandVoiceSourceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BrandVoiceSourceError';
+    }
+}
+/** Fetch and extract readable text from a public URL (SSRF-safe, no redirects). */
+export async function fetchBrandVoiceUrlSample(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new BrandVoiceSourceError(`Invalid URL: ${url}`);
+    }
+    if (!['http:', 'https:'].includes(parsed.protocol)) {
+        throw new BrandVoiceSourceError('Only http and https URLs are supported.');
+    }
+    let response;
+    try {
+        response = await safeFetch(url, { method: 'GET', timeoutMs: 8000, followRedirects: false });
+    }
+    catch (err) {
+        if (err instanceof SsrfBlockedError) {
+            throw new BrandVoiceSourceError(`URL blocked for security: ${url}`);
+        }
+        throw new BrandVoiceSourceError(`Could not fetch ${url}`);
+    }
+    if (!response.ok) {
+        throw new BrandVoiceSourceError(`URL returned HTTP ${response.status}: ${url}`);
+    }
+    const contentType = (response.headers.get('content-type') ?? '').split(';')[0]?.trim() ?? '';
+    const buffer = Buffer.from(await response.arrayBuffer());
+    if (buffer.byteLength === 0) {
+        throw new BrandVoiceSourceError(`Empty response from ${url}`);
+    }
+    if (buffer.byteLength > MAX_URL_FETCH_BYTES) {
+        throw new BrandVoiceSourceError(`Response too large from ${url}`);
+    }
+    const raw = buffer.toString('utf-8');
+    let text;
+    let title;
+    if (contentType.includes('text/html') || raw.includes('<html')) {
+        title = extractHtmlTitle(raw);
+        text = extractReadableText(raw);
+    }
+    else if (contentType.startsWith('text/') || contentType.includes('markdown')) {
+        title = parsed.hostname;
+        text = clampText(raw, MAX_URL_FETCH_CHARS);
+    }
+    else {
+        throw new BrandVoiceSourceError(`Unsupported content type "${contentType || 'unknown'}" from ${url}`);
+    }
+    if (!text) {
+        throw new BrandVoiceSourceError(`No readable text found at ${url}`);
+    }
+    return {
+        collection: 'url',
+        documentId: url,
+        title,
+        text,
+    };
+}
+export function uploadToBrandVoiceSample(name, text) {
+    const trimmed = text.trim();
+    if (!trimmed) {
+        throw new BrandVoiceSourceError(`Upload "${name}" is empty.`);
+    }
+    if (trimmed.length > MAX_UPLOAD_TEXT_CHARS) {
+        throw new BrandVoiceSourceError(`Upload "${name}" exceeds ${MAX_UPLOAD_TEXT_CHARS.toLocaleString()} characters.`);
+    }
+    return {
+        collection: 'upload',
+        documentId: name.slice(0, 120),
+        title: name.slice(0, 200) || 'Uploaded document',
+        text: trimmed,
+    };
+}
+//# sourceMappingURL=brand-voice-sources.js.map

package/dist/ai/brand-voice-sources.js.map

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

package/dist/ai/brand-voice-structured.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Structured brand voice rules — parsed from profile frontmatter and used for
+ * deterministic alignment scoring and the Phase 3 admin editors.
+ */
+export type ContractionsRule = 'allow' | 'avoid' | 'require';
+export type ExclamationRule = 'allow' | 'avoid' | 'forbid';
+export type EmojiRule = 'allow' | 'sparingly' | 'forbid';
+export type CaseRule = 'sentence' | 'title';
+export type NumbersRule = 'spell_all' | 'numerals_all' | 'numerals_for_10_plus';
+export type SpellingRule = 'us' | 'uk';
+export interface BrandVoiceToneScales {
+    formalCasual: number;
+    seriousPlayful: number;
+    conciseDetailed: number;
+    reservedBold: number;
+    readingLevel: number;
+}
+export interface BrandVoiceMechanics {
+    oxfordComma: boolean;
+    contractions: ContractionsRule;
+    exclamationPoints: ExclamationRule;
+    emoji: EmojiRule;
+    caseHeadlines: CaseRule;
+    caseButtons: CaseRule;
+    numbers: NumbersRule;
+    serialSpelling: SpellingRule;
+}
+export interface BrandVoiceBannedTerm {
+    term: string;
+    useInstead: string;
+}
+export interface BrandVoiceChannelRule {
+    id: string;
+    label: string;
+    maxChars?: number;
+    maxHeadlineChars?: number;
+    maxDescriptionChars?: number;
+    note?: string;
+}
+export interface BrandVoiceWorkedExample {
+    offBrand: string;
+    onBrand: string;
+    why: string;
+}
+export interface BrandVoiceStructuredProfile {
+    tone: BrandVoiceToneScales;
+    mechanics: BrandVoiceMechanics;
+    bannedTerms: BrandVoiceBannedTerm[];
+    preferredTerms: string[];
+    avoidPatterns: string[];
+    channels: BrandVoiceChannelRule[];
+    workedExamples: BrandVoiceWorkedExample[];
+}
+export interface BrandAlignmentIssue {
+    id: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    suggestion?: string;
+}
+export interface BrandAlignmentDimension {
+    name: string;
+    score: number;
+    feedback: string;
+}
+export interface BrandAlignmentScoreResult {
+    score: number;
+    channel?: string;
+    issues: BrandAlignmentIssue[];
+    dimensions: BrandAlignmentDimension[];
+}
+export declare const BRAND_VOICE_CHANNEL_PRESETS: Array<{
+    id: string;
+    label: string;
+}>;
+declare const MAX_WORKED_EXAMPLES = 10;
+declare const MAX_BANNED_TERMS = 40;
+declare const MAX_PREFERRED_TERMS = 40;
+declare const MAX_AVOID_PATTERNS = 20;
+export declare function defaultStructuredProfile(): BrandVoiceStructuredProfile;
+/** Parse machine-readable rules from a profile markdown document. */
+export declare function parseStructuredProfile(document: string): BrandVoiceStructuredProfile;
+/** Apply structured rule edits back into the profile markdown document. */
+export declare function applyStructuredProfileToDocument(document: string, structured: BrandVoiceStructuredProfile): string;
+/** Deterministic alignment score using frontmatter rules. */
+export declare function scoreBrandAlignment(content: string, structured: BrandVoiceStructuredProfile, channelId?: string): BrandAlignmentScoreResult;
+export { MAX_BANNED_TERMS, MAX_PREFERRED_TERMS, MAX_AVOID_PATTERNS, MAX_WORKED_EXAMPLES };
+//# sourceMappingURL=brand-voice-structured.d.ts.map

package/dist/ai/brand-voice-structured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-voice-structured.d.ts","sourceRoot":"","sources":["../../src/ai/brand-voice-structured.ts"],"names":[],"mappings":"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"}

package/dist/ai/brand-voice-structured.js

@@ -0,0 +1,438 @@
+/**
+ * Structured brand voice rules — parsed from profile frontmatter and used for
+ * deterministic alignment scoring and the Phase 3 admin editors.
+ */
+import { splitBrandVoiceDocument } from './brand-voice-document.js';
+export const BRAND_VOICE_CHANNEL_PRESETS = [
+    { id: 'meta_description', label: 'Meta description' },
+    { id: 'blog', label: 'Blog post' },
+    { id: 'google_ads', label: 'Google Ads' },
+];
+const FRONTMATTER_SECTION_END = '(?=^[^\\s#].|^#|\\Z)';
+const MAX_WORKED_EXAMPLES = 10;
+const MAX_BANNED_TERMS = 40;
+const MAX_PREFERRED_TERMS = 40;
+const MAX_AVOID_PATTERNS = 20;
+function extractSection(frontmatter, section) {
+    const re = new RegExp(`^${section}:\\s*\\n([\\s\\S]*?)${FRONTMATTER_SECTION_END}`, 'm');
+    return re.exec(frontmatter)?.[1]?.trim() ?? '';
+}
+function readScale(section, key, fallback) {
+    const match = new RegExp(`^\\s*${key}:\\s*(\\d+)`, 'm').exec(section);
+    if (!match)
+        return fallback;
+    const n = Number.parseInt(match[1], 10);
+    return Number.isFinite(n) ? Math.min(100, Math.max(0, n)) : fallback;
+}
+function readBool(section, key, fallback) {
+    const match = new RegExp(`^\\s*${key}:\\s*(true|false)`, 'm').exec(section);
+    if (!match)
+        return fallback;
+    return match[1] === 'true';
+}
+function readEnum(section, key, allowed, fallback) {
+    const match = new RegExp(`^\\s*${key}:\\s*(\\S+)`, 'm').exec(section);
+    if (!match)
+        return fallback;
+    const value = match[1];
+    return allowed.includes(value) ? value : fallback;
+}
+function parseBannedTerms(vocabularySection) {
+    const terms = [];
+    const blocks = vocabularySection.split(/\n\s*-\s*term:/).slice(1);
+    for (const block of blocks) {
+        const termMatch = /^\s*"?([^"\n]+)"?/.exec(block);
+        const useMatch = /use_instead:\s*"?([^"\n#]*)"?/.exec(block);
+        if (!termMatch)
+            continue;
+        terms.push({
+            term: termMatch[1].trim(),
+            useInstead: (useMatch?.[1] ?? '').trim(),
+        });
+    }
+    return terms.slice(0, MAX_BANNED_TERMS);
+}
+function parseSimpleList(section, key) {
+    const block = new RegExp(`^\\s*${key}:\\s*\\n((?:\\s+-\\s+.+\n?)*)`, 'm').exec(section)?.[1] ?? '';
+    return [...block.matchAll(/^\s+-\s+(.+)\s*$/gm)]
+        .map((m) => m[1].replace(/^["']|["']$/g, '').trim())
+        .filter(Boolean)
+        .slice(0, key === 'preferred' ? MAX_PREFERRED_TERMS : MAX_AVOID_PATTERNS);
+}
+function parseChannels(channelsSection) {
+    const rules = [];
+    const chunks = channelsSection.split(/\n(?=[a-z][a-z0-9_]*:)/);
+    for (const chunk of chunks) {
+        const idMatch = /^([a-z][a-z0-9_]*):/m.exec(chunk);
+        if (!idMatch)
+            continue;
+        const id = idMatch[1];
+        const preset = BRAND_VOICE_CHANNEL_PRESETS.find((p) => p.id === id);
+        const readNum = (key) => {
+            const m = new RegExp(`^\\s*${key}:\\s*(\\d+)`, 'm').exec(chunk);
+            return m ? Number.parseInt(m[1], 10) : undefined;
+        };
+        const noteMatch = /^\s*note:\s*"?([^"\n]+)"?/m.exec(chunk);
+        rules.push({
+            id,
+            label: preset?.label ?? id.replace(/_/g, ' '),
+            maxChars: readNum('max_chars'),
+            maxHeadlineChars: readNum('max_headline_chars'),
+            maxDescriptionChars: readNum('max_description_chars'),
+            note: noteMatch?.[1]?.trim(),
+        });
+    }
+    return rules;
+}
+function parseWorkedExamples(body) {
+    const sectionRe = /^##\s+Worked examples\s*$[\s\S]*?(?=^##\s+|\Z)/im;
+    const section = sectionRe.exec(body)?.[0] ?? '';
+    const rows = section
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith('|') && !line.includes('Off-brand') && !/^\|[-| ]+\|$/.test(line));
+    const examples = [];
+    for (const row of rows) {
+        const cells = row
+            .split('|')
+            .map((c) => c.trim())
+            .filter(Boolean);
+        if (cells.length < 3)
+            continue;
+        examples.push({
+            offBrand: cells[0].replace(/^["']|["']$/g, ''),
+            onBrand: cells[1].replace(/^["']|["']$/g, ''),
+            why: cells[2].replace(/^["']|["']$/g, ''),
+        });
+    }
+    return examples.slice(0, MAX_WORKED_EXAMPLES);
+}
+export function defaultStructuredProfile() {
+    return {
+        tone: {
+            formalCasual: 50,
+            seriousPlayful: 50,
+            conciseDetailed: 50,
+            reservedBold: 50,
+            readingLevel: 8,
+        },
+        mechanics: {
+            oxfordComma: true,
+            contractions: 'allow',
+            exclamationPoints: 'avoid',
+            emoji: 'forbid',
+            caseHeadlines: 'sentence',
+            caseButtons: 'sentence',
+            numbers: 'numerals_for_10_plus',
+            serialSpelling: 'us',
+        },
+        bannedTerms: [],
+        preferredTerms: [],
+        avoidPatterns: [],
+        channels: BRAND_VOICE_CHANNEL_PRESETS.map((preset) => ({
+            id: preset.id,
+            label: preset.label,
+            ...(preset.id === 'meta_description' ? { maxChars: 160 } : {}),
+            ...(preset.id === 'google_ads' ? { maxHeadlineChars: 30, maxDescriptionChars: 90 } : {}),
+            ...(preset.id === 'blog' ? { note: 'authoritative; still no hype words' } : {}),
+            ...(preset.id === 'meta_description'
+                ? { note: 'lead with the benefit; one clear action' }
+                : {}),
+        })),
+        workedExamples: [],
+    };
+}
+/** Parse machine-readable rules from a profile markdown document. */
+export function parseStructuredProfile(document) {
+    const defaults = defaultStructuredProfile();
+    const split = splitBrandVoiceDocument(document.trim());
+    if (!split)
+        return defaults;
+    const toneSection = extractSection(split.frontmatter, 'tone');
+    const mechanicsSection = extractSection(split.frontmatter, 'mechanics');
+    const vocabularySection = extractSection(split.frontmatter, 'vocabulary');
+    const channelsSection = extractSection(split.frontmatter, 'channels');
+    const parsedChannels = parseChannels(channelsSection);
+    const channels = parsedChannels.length > 0 ? parsedChannels : defaults.channels;
+    return {
+        tone: {
+            formalCasual: readScale(toneSection, 'formal_casual', defaults.tone.formalCasual),
+            seriousPlayful: readScale(toneSection, 'serious_playful', defaults.tone.seriousPlayful),
+            conciseDetailed: readScale(toneSection, 'concise_detailed', defaults.tone.conciseDetailed),
+            reservedBold: readScale(toneSection, 'reserved_bold', defaults.tone.reservedBold),
+            readingLevel: readScale(toneSection, 'reading_level', defaults.tone.readingLevel),
+        },
+        mechanics: {
+            oxfordComma: readBool(mechanicsSection, 'oxford_comma', defaults.mechanics.oxfordComma),
+            contractions: readEnum(mechanicsSection, 'contractions', ['allow', 'avoid', 'require'], defaults.mechanics.contractions),
+            exclamationPoints: readEnum(mechanicsSection, 'exclamation_points', ['allow', 'avoid', 'forbid'], defaults.mechanics.exclamationPoints),
+            emoji: readEnum(mechanicsSection, 'emoji', ['allow', 'sparingly', 'forbid'], defaults.mechanics.emoji),
+            caseHeadlines: readEnum(mechanicsSection, 'case_headlines', ['sentence', 'title'], defaults.mechanics.caseHeadlines),
+            caseButtons: readEnum(mechanicsSection, 'case_buttons', ['sentence', 'title'], defaults.mechanics.caseButtons),
+            numbers: readEnum(mechanicsSection, 'numbers', ['spell_all', 'numerals_all', 'numerals_for_10_plus'], defaults.mechanics.numbers),
+            serialSpelling: readEnum(mechanicsSection, 'serial_spelling', ['us', 'uk'], defaults.mechanics.serialSpelling),
+        },
+        bannedTerms: parseBannedTerms(vocabularySection),
+        preferredTerms: parseSimpleList(vocabularySection, 'preferred'),
+        avoidPatterns: parseSimpleList(vocabularySection, 'avoid_patterns'),
+        channels,
+        workedExamples: parseWorkedExamples(split.body),
+    };
+}
+function escapeYaml(value) {
+    if (/[:#{}[\],&*?|>-]/.test(value) || value.includes('"')) {
+        return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return value.includes('\n') ? `"${value.replace(/"/g, '\\"')}"` : value;
+}
+function renderToneSection(tone) {
+    return `tone:
+  formal_casual: ${tone.formalCasual}
+  serious_playful: ${tone.seriousPlayful}
+  concise_detailed: ${tone.conciseDetailed}
+  reserved_bold: ${tone.reservedBold}
+  reading_level: ${tone.readingLevel}`;
+}
+function renderMechanicsSection(mechanics) {
+    return `mechanics:
+  oxford_comma: ${mechanics.oxfordComma}
+  contractions: ${mechanics.contractions}
+  exclamation_points: ${mechanics.exclamationPoints}
+  emoji: ${mechanics.emoji}
+  case_headlines: ${mechanics.caseHeadlines}
+  case_buttons: ${mechanics.caseButtons}
+  numbers: ${mechanics.numbers}
+  serial_spelling: ${mechanics.serialSpelling}`;
+}
+function renderVocabularySection(structured) {
+    const banned = structured.bannedTerms.length === 0
+        ? '  banned: []'
+        : `  banned:\n${structured.bannedTerms
+            .map((row) => `    - term: ${escapeYaml(row.term)}\n      use_instead: ${escapeYaml(row.useInstead)}`)
+            .join('\n')}`;
+    const preferred = structured.preferredTerms.length === 0
+        ? '  preferred: []'
+        : `  preferred:\n${structured.preferredTerms.map((t) => `    - ${escapeYaml(t)}`).join('\n')}`;
+    const avoid = structured.avoidPatterns.length === 0
+        ? '  avoid_patterns: []'
+        : `  avoid_patterns:\n${structured.avoidPatterns.map((t) => `    - ${escapeYaml(t)}`).join('\n')}`;
+    return `vocabulary:\n${banned}\n${preferred}\n${avoid}`;
+}
+function renderChannelsSection(channels) {
+    if (channels.length === 0)
+        return 'channels: {}';
+    const lines = channels.map((channel) => {
+        const props = [`  ${channel.id}:`];
+        if (typeof channel.maxChars === 'number')
+            props.push(`    max_chars: ${channel.maxChars}`);
+        if (typeof channel.maxHeadlineChars === 'number') {
+            props.push(`    max_headline_chars: ${channel.maxHeadlineChars}`);
+        }
+        if (typeof channel.maxDescriptionChars === 'number') {
+            props.push(`    max_description_chars: ${channel.maxDescriptionChars}`);
+        }
+        if (channel.note?.trim())
+            props.push(`    note: ${escapeYaml(channel.note.trim())}`);
+        return props.join('\n');
+    });
+    return `channels:\n${lines.join('\n')}`;
+}
+function renderWorkedExamplesSection(examples) {
+    const rows = examples.length === 0
+        ? '| _Off-brand example_ | _On-brand rewrite_ | _Why the change helps._ |'
+        : examples.map((ex) => `| ${ex.offBrand} | ${ex.onBrand} | ${ex.why} |`).join('\n');
+    return `## Worked examples
+| Off-brand | On-brand | Why |
+|---|---|---|
+${rows}
+`;
+}
+function replaceFrontmatterSection(frontmatter, section, content) {
+    const re = new RegExp(`^${section}:[\\s\\S]*?(?=${FRONTMATTER_SECTION_END})`, 'm');
+    if (re.test(frontmatter))
+        return frontmatter.replace(re, content);
+    return `${frontmatter.trim()}\n\n${content}`;
+}
+function replaceBodySection(body, heading, content) {
+    const re = new RegExp(`^##\\s+${heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?(?=^##\\s+|\\Z)`, 'im');
+    if (re.test(body))
+        return body.replace(re, `${content.trim()}\n`);
+    return `${body.trim()}\n\n${content.trim()}`;
+}
+/** Apply structured rule edits back into the profile markdown document. */
+export function applyStructuredProfileToDocument(document, structured) {
+    const split = splitBrandVoiceDocument(document.trim());
+    if (!split)
+        return document;
+    let frontmatter = split.frontmatter;
+    frontmatter = replaceFrontmatterSection(frontmatter, 'tone', renderToneSection(structured.tone));
+    frontmatter = replaceFrontmatterSection(frontmatter, 'mechanics', renderMechanicsSection(structured.mechanics));
+    frontmatter = replaceFrontmatterSection(frontmatter, 'vocabulary', renderVocabularySection(structured));
+    frontmatter = replaceFrontmatterSection(frontmatter, 'channels', renderChannelsSection(structured.channels));
+    let body = replaceBodySection(split.body, 'Worked examples', renderWorkedExamplesSection(structured.workedExamples));
+    return `---\n${frontmatter.trim()}\n---\n\n${body.trim()}`;
+}
+const EMOJI_RE = /[\u{1F300}-\u{1FAFF}\u{2600}-\u{27BF}]/u;
+const CONTRACTION_RE = /\b(?:can't|won't|don't|it's|we're|you're|they're|i'm|you'll|we'll|isn't|aren't|wasn't|weren't|haven't|hasn't|didn't|doesn't|wouldn't|couldn't|shouldn't)\b/i;
+const SUPERLATIVE_RE = /\b(best|worst|greatest|revolutionary|amazing|incredible|unbelievable|world[- ]class|leading)\b/gi;
+function clampScore(score) {
+    return Math.max(0, Math.min(100, Math.round(score)));
+}
+/** Deterministic alignment score using frontmatter rules. */
+export function scoreBrandAlignment(content, structured, channelId) {
+    const text = content.trim();
+    const lower = text.toLowerCase();
+    const issues = [];
+    const dimensions = [];
+    let score = 100;
+    for (const banned of structured.bannedTerms) {
+        if (!banned.term.trim())
+            continue;
+        const term = banned.term.trim();
+        if (!lower.includes(term.toLowerCase()))
+            continue;
+        score -= 15;
+        issues.push({
+            id: `banned-${term}`,
+            severity: 'error',
+            message: `Banned term "${term}" found.`,
+            suggestion: banned.useInstead
+                ? `Use "${banned.useInstead}" instead.`
+                : 'Remove this term entirely.',
+        });
+    }
+    const exclamations = (text.match(/!/g) ?? []).length;
+    if (exclamations > 0) {
+        if (structured.mechanics.exclamationPoints === 'forbid') {
+            score -= exclamations * 12;
+            issues.push({
+                id: 'exclamation-forbid',
+                severity: 'error',
+                message: `Exclamation point${exclamations === 1 ? '' : 's'} not allowed (${exclamations}).`,
+                suggestion: 'Remove exclamation points for this brand voice.',
+            });
+        }
+        else if (structured.mechanics.exclamationPoints === 'avoid') {
+            score -= exclamations * 6;
+            issues.push({
+                id: 'exclamation-avoid',
+                severity: 'warning',
+                message: `Exclamation point${exclamations === 1 ? '' : 's'} discouraged (${exclamations}).`,
+            });
+        }
+    }
+    if (structured.mechanics.emoji === 'forbid' && EMOJI_RE.test(text)) {
+        score -= 15;
+        issues.push({
+            id: 'emoji-forbid',
+            severity: 'error',
+            message: 'Emoji are not allowed.',
+            suggestion: 'Remove emoji from the copy.',
+        });
+    }
+    if (structured.mechanics.contractions === 'avoid' && CONTRACTION_RE.test(text)) {
+        score -= 8;
+        issues.push({
+            id: 'contractions-avoid',
+            severity: 'warning',
+            message: 'Contractions are discouraged for this brand voice.',
+            suggestion: 'Expand contractions (e.g. "do not" instead of "don\'t").',
+        });
+    }
+    for (const pattern of structured.avoidPatterns) {
+        if (!pattern.trim())
+            continue;
+        const normalized = pattern.toLowerCase();
+        if (normalized.includes('hype stacking') && (text.match(SUPERLATIVE_RE) ?? []).length >= 2) {
+            score -= 10;
+            issues.push({
+                id: 'avoid-hype-stacking',
+                severity: 'warning',
+                message: 'Multiple hype words detected in one piece.',
+            });
+            continue;
+        }
+        if (normalized.includes("in today's") && lower.includes("in today's")) {
+            score -= 10;
+            issues.push({
+                id: 'avoid-filler-opener',
+                severity: 'warning',
+                message: 'Filler opener detected ("In today\'s…").',
+                suggestion: 'Start with the point or benefit instead.',
+            });
+            continue;
+        }
+        if (normalized.includes('vague claims') && SUPERLATIVE_RE.test(text) && !/\d/.test(text)) {
+            score -= 8;
+            issues.push({
+                id: 'avoid-vague-claim',
+                severity: 'warning',
+                message: 'Strong claim without a supporting number or proof point.',
+            });
+        }
+    }
+    const preferredHits = structured.preferredTerms.filter((term) => lower.includes(term.toLowerCase()));
+    const preferredScore = structured.preferredTerms.length > 0
+        ? clampScore((preferredHits.length / structured.preferredTerms.length) * 100)
+        : 100;
+    dimensions.push({
+        name: 'Preferred vocabulary',
+        score: preferredScore,
+        feedback: preferredHits.length > 0
+            ? `Uses ${preferredHits.length} preferred term(s).`
+            : structured.preferredTerms.length > 0
+                ? 'Consider using more preferred brand terms.'
+                : 'No preferred terms configured.',
+    });
+    if (structured.preferredTerms.length > 0 && preferredHits.length === 0) {
+        issues.push({
+            id: 'preferred-missing',
+            severity: 'info',
+            message: 'No preferred brand terms detected.',
+        });
+    }
+    const channel = channelId ? structured.channels.find((c) => c.id === channelId) : undefined;
+    if (channel) {
+        const len = text.length;
+        const limit = channel.maxChars ?? channel.maxDescriptionChars;
+        if (typeof limit === 'number' && len > limit) {
+            score -= 20;
+            issues.push({
+                id: `channel-length-${channel.id}`,
+                severity: 'error',
+                message: `${channel.label} exceeds ${limit} characters (${len}).`,
+                suggestion: `Trim to ${limit} characters or fewer.`,
+            });
+        }
+        dimensions.push({
+            name: `${channel.label} length`,
+            score: typeof limit === 'number' ? clampScore(100 - Math.max(0, len - limit) * 2) : 100,
+            feedback: typeof limit === 'number'
+                ? `${len}/${limit} characters`
+                : 'No length limit configured for this channel.',
+        });
+    }
+    const bannedScore = structured.bannedTerms.length > 0
+        ? clampScore(100 - issues.filter((i) => i.id.startsWith('banned-')).length * 25)
+        : 100;
+    dimensions.push({
+        name: 'Banned vocabulary',
+        score: bannedScore,
+        feedback: bannedScore >= 100 ? 'No banned terms detected.' : 'Off-brand terms found in the copy.',
+    });
+    dimensions.push({
+        name: 'Mechanics',
+        score: clampScore(100 -
+            issues.filter((i) => ['exclamation-forbid', 'emoji-forbid'].includes(i.id)).length * 20 -
+            issues.filter((i) => i.severity === 'warning' && i.id.startsWith('exclamation')).length * 8),
+        feedback: 'Style mechanics (punctuation, emoji, contractions).',
+    });
+    return {
+        score: clampScore(score),
+        channel: channel?.id,
+        issues,
+        dimensions,
+    };
+}
+export { MAX_BANNED_TERMS, MAX_PREFERRED_TERMS, MAX_AVOID_PATTERNS, MAX_WORKED_EXAMPLES };
+//# sourceMappingURL=brand-voice-structured.js.map