@prenta/core 6.0.0 → 7.0.0

package/dist/ai/tasks/document-generation.js

@@ -0,0 +1,321 @@
+/**
+ * Provider-free prompt + coercion for whole-document generation. Moved from
+ * `@prenta/plugin-ai` (`writing/content-generator.ts`) in Spec B; the model
+ * call runs through `generateJsonForFeature` under the
+ * `ai.features.documentGeneration` feature (toggle, daily cap, budget, brand
+ * voice, usage metering), so this module never touches a provider.
+ *
+ * Given a prompt + a minimal collection schema (slug, labels, fields) it
+ * builds the system/user prompts that ask the model for JSON matching the
+ * field names and types, and coerces the validated reply into field data
+ * ready for `createDocument`.
+ *
+ * Intentionally pragmatic — it does *not* invent a page `data.sections`
+ * list. Author pages with `add_page_section` or `createDocument` using
+ * `data.sections`. This is for non-page collections (blog posts, case
+ * studies, services, locations, team members, …) with structured field data.
+ */
+import { z } from 'zod';
+import { clampAiContent, fenceUntrusted } from '../prompt-safety.js';
+export const DOCUMENT_GENERATION_FEATURE = 'ai.features.documentGeneration';
+/** Default output cap — enough for ~2000-word posts. */
+export const DOCUMENT_GENERATION_MAX_TOKENS = 3000;
+/** Reference material is clamped before fencing so it cannot dominate the prompt. */
+const EXISTING_CONTENT_MAX_CHARS = 2000;
+/** Caller-supplied modifiers land in the *system* prompt: clamp and keep to one line. */
+const MODIFIER_MAX_CHARS = 200;
+/**
+ * Sanitize a free-form modifier (`tone`, `targetAudience`) before it becomes a
+ * system-prompt rule: clamp, collapse every line break / whitespace run to one
+ * space so the caller cannot inject additional `- Rule` lines, and trim.
+ * Returns `undefined` for blank input so the rule line is omitted.
+ */
+function systemPromptModifier(value) {
+    if (!value)
+        return undefined;
+    const flat = clampAiContent(value, MODIFIER_MAX_CHARS).replace(/\s+/g, ' ').trim();
+    return flat || undefined;
+}
+/** Any JSON object; field-level coercion happens in {@link coerceDocument}. */
+export const DocumentDraftSchema = z
+    .record(z.string(), z.unknown())
+    .refine((v) => v !== null && typeof v === 'object' && !Array.isArray(v), {
+    message: 'expected a JSON object',
+});
+// ─── Core type adapters ───────────────────────────────────────────────────
+/**
+ * Project a core `FieldDefinition` onto {@link FieldShape}. Only the
+ * prompt-relevant, serializable subset is carried (no validators, hooks,
+ * access functions, or admin conditions), so the shape stays safe to log and
+ * cheap to describe to the model.
+ */
+export function toFieldShape(field) {
+    const shape = { type: field.type };
+    if (field.label)
+        shape.label = field.label;
+    if (field.required)
+        shape.required = true;
+    if (field.admin?.description)
+        shape.admin = { description: field.admin.description };
+    switch (field.type) {
+        case 'text':
+            if (typeof field.maxLength === 'number')
+                shape.maxLength = field.maxLength;
+            break;
+        case 'number':
+            if (typeof field.min === 'number')
+                shape.min = field.min;
+            if (typeof field.max === 'number')
+                shape.max = field.max;
+            if (typeof field.step === 'number')
+                shape.step = field.step;
+            break;
+        case 'select':
+            shape.options = field.options.map((o) => ({ label: o.label, value: o.value }));
+            break;
+        case 'richText':
+            if (field.features)
+                shape.features = [...field.features];
+            break;
+        case 'array':
+            shape.fields = Object.fromEntries(Object.entries(field.fields).map(([name, sub]) => [name, toFieldShape(sub)]));
+            break;
+        case 'boolean':
+        case 'date':
+        case 'slug':
+        case 'relationship':
+        case 'media':
+        case 'json':
+        case 'nav':
+        case 'color':
+        case 'url':
+        case 'email':
+        case 'blocks':
+        case 'componentBlock':
+            break;
+        default: {
+            const _exhaustive = field;
+            return _exhaustive;
+        }
+    }
+    return shape;
+}
+/** Project a core `CollectionDefinition` onto {@link CollectionShape}. */
+export function toCollectionShape(collection) {
+    const shape = {
+        slug: collection.slug,
+        labels: collection.labels,
+        fields: Object.fromEntries(Object.entries(collection.fields).map(([name, f]) => [name, toFieldShape(f)])),
+    };
+    if (collection.type)
+        shape.type = collection.type;
+    if (collection.seo?.defaultSchemaType) {
+        shape.seo = { defaultSchemaType: collection.seo.defaultSchemaType };
+    }
+    return shape;
+}
+// ─── Prompt construction ──────────────────────────────────────────────────
+function describeField(name, field) {
+    const parts = [`  "${name}"`];
+    parts.push(`(${field.type}${field.required ? ', required' : ''})`);
+    if (field.label && field.label !== name)
+        parts.push(`label: ${field.label}`);
+    if (field.maxLength)
+        parts.push(`max ${field.maxLength} chars`);
+    if (typeof field.min === 'number' || typeof field.max === 'number') {
+        parts.push(`range ${field.min ?? '∞'}…${field.max ?? '∞'}`);
+    }
+    if (field.options && field.options.length) {
+        parts.push(`one of: ${field.options.map((o) => o.value).join(', ')}`);
+    }
+    if (field.type === 'array' && field.fields) {
+        const subFields = Object.entries(field.fields)
+            .map(([n, f]) => `${n}:${f.type}`)
+            .join(', ');
+        parts.push(`array of { ${subFields} }`);
+    }
+    if (field.admin?.description) {
+        parts.push(`— ${field.admin.description}`);
+    }
+    return parts.join(' ');
+}
+function buildSystemPrompt(collection, tone, targetAudience) {
+    const lines = [
+        `You are an expert content writer creating a "${collection.labels.singular}" document for a CMS.`,
+        'You generate valid JSON matching the requested field schema. NEVER include markdown, code fences, or commentary.',
+        '',
+        'Rules:',
+        '- Output a single JSON object whose top-level keys exactly match the field names below.',
+        '- Match field types: text/richText/email/url are strings; number is a number; boolean is a boolean; date is an ISO-8601 string; array is a JSON array of objects; select must use one of the listed option values; media fields should be left as null (a human will upload the asset).',
+        '- Respect maxLength constraints. Quality over quantity — never pad.',
+        '- For slug fields, generate a URL-safe lowercase string with words joined by hyphens.',
+        '- For richText fields, return well-structured prose with paragraph breaks, but no HTML tags.',
+        '- For seo fields (metaTitle, metaDescription) compose SEO-optimised copy distinct from the page title.',
+        "- Never invent facts. If you don't know something the prompt didn't supply, leave the field blank or null.",
+    ];
+    if (collection.seo?.defaultSchemaType) {
+        lines.push(`- This collection maps to Schema.org "${collection.seo.defaultSchemaType}".`);
+    }
+    if (tone)
+        lines.push(`- Tone: ${tone}.`);
+    if (targetAudience)
+        lines.push(`- Audience: ${targetAudience}.`);
+    return lines.join('\n');
+}
+function buildUserPrompt(input) {
+    const { collection, prompt, existingContent } = input;
+    const fieldDescriptions = Object.entries(collection.fields)
+        // Media is supplied by the human reviewer.
+        // Relations are excluded because the LLM has no view of existing
+        // document IDs — guessing would create dangling references that the
+        // validator would then reject. Humans / orchestration code wire those
+        // in after creation.
+        .filter(([, f]) => f.type !== 'media' && f.type !== 'relationship')
+        .map(([name, field]) => describeField(name, field))
+        .join('\n');
+    const lines = [
+        `Create a ${collection.labels.singular} matching this brief:`,
+        '',
+        prompt.trim(),
+        '',
+        'Field schema:',
+        fieldDescriptions,
+        '',
+        'Output ONLY a JSON object with the field values. No prose. No markdown fences.',
+    ];
+    if (existingContent) {
+        lines.push('', 'Existing related content for voice / fact reference:');
+        // Untrusted reference content — fence it so an injected instruction inside
+        // a referenced document can't redirect the generation.
+        lines.push(fenceUntrusted(existingContent, EXISTING_CONTENT_MAX_CHARS));
+    }
+    return lines.join('\n');
+}
+export function buildDocumentPrompt(input) {
+    return {
+        system: buildSystemPrompt(input.collection, systemPromptModifier(input.tone), systemPromptModifier(input.targetAudience)),
+        prompt: buildUserPrompt(input),
+    };
+}
+// ─── Output coercion ──────────────────────────────────────────────────────
+function slugify(title) {
+    return (title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 80) || 'untitled');
+}
+/**
+ * Coerce the LLM output into shapes that match each field's declared type.
+ * The LLM occasionally returns numbers as strings, booleans as "true"/"false",
+ * etc. We don't try to recover unrecoverable values — we leave bad fields
+ * `undefined` so the downstream field validator surfaces the error to the
+ * caller instead of silently persisting garbage.
+ */
+function coerceFieldValue(value, field) {
+    if (value === null || value === undefined)
+        return value;
+    switch (field.type) {
+        case 'text':
+        case 'richText':
+        case 'email':
+        case 'url':
+        case 'slug':
+        case 'color':
+            return typeof value === 'string' ? value : String(value);
+        case 'number':
+            if (typeof value === 'number')
+                return value;
+            if (typeof value === 'string') {
+                const n = Number(value);
+                return Number.isFinite(n) ? n : undefined;
+            }
+            return undefined;
+        case 'boolean':
+            if (typeof value === 'boolean')
+                return value;
+            if (value === 'true')
+                return true;
+            if (value === 'false')
+                return false;
+            return undefined;
+        case 'date':
+            if (value instanceof Date)
+                return value.toISOString();
+            if (typeof value === 'string') {
+                const d = new Date(value);
+                return isNaN(d.getTime()) ? undefined : d.toISOString();
+            }
+            return undefined;
+        case 'select':
+            if (typeof value === 'string' && field.options?.some((o) => o.value === value))
+                return value;
+            return undefined;
+        case 'array':
+            if (!Array.isArray(value))
+                return [];
+            if (!field.fields)
+                return value;
+            return value.map((item) => {
+                if (item === null || typeof item !== 'object')
+                    return item;
+                const obj = item;
+                const coerced = {};
+                for (const [name, sub] of Object.entries(field.fields)) {
+                    if (obj[name] !== undefined)
+                        coerced[name] = coerceFieldValue(obj[name], sub);
+                }
+                return coerced;
+            });
+        case 'json':
+            return value;
+        case 'media':
+            // The LLM doesn't have asset IDs. Leave for a human to fill.
+            return null;
+        case 'relationship':
+            // Same rationale as media — IDs are out-of-band knowledge. If the
+            // model did emit something (e.g. echoed an ID from the prompt) we
+            // accept strings and string arrays verbatim; otherwise drop.
+            if (typeof value === 'string')
+                return value;
+            if (Array.isArray(value))
+                return value.filter((v) => typeof v === 'string');
+            return undefined;
+        default:
+            return value;
+    }
+}
+/**
+ * Coerce a schema-validated model reply into persisted field data plus the
+ * derived title / slug / SEO bundle. Unknown keys (anything the collection
+ * doesn't declare) are dropped to keep persisted data clean.
+ */
+export function coerceDocument(parsed, collection) {
+    const data = {};
+    for (const [name, field] of Object.entries(collection.fields)) {
+        const raw = parsed[name];
+        if (raw === undefined)
+            continue;
+        const coerced = coerceFieldValue(raw, field);
+        if (coerced !== undefined)
+            data[name] = coerced;
+    }
+    // Derive title + slug.
+    const title = (typeof data.title === 'string' && data.title) ||
+        (typeof data.question === 'string' && data.question) ||
+        (typeof data.name === 'string' && data.name) ||
+        'Untitled';
+    const slug = (typeof data.slug === 'string' && data.slug.trim()) || slugify(title);
+    data.slug = slug;
+    const seo = {
+        metaTitle: (typeof data.metaTitle === 'string' && data.metaTitle) ||
+            (typeof parsed.metaTitle === 'string' && parsed.metaTitle) ||
+            title,
+        metaDescription: (typeof data.metaDescription === 'string' && data.metaDescription) ||
+            (typeof parsed.metaDescription === 'string' && parsed.metaDescription) ||
+            undefined,
+        schemaType: collection.seo?.defaultSchemaType,
+    };
+    return { data, title, slug, seo };
+}
+//# sourceMappingURL=document-generation.js.map

package/dist/ai/tasks/document-generation.js.map

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

package/dist/ai/tasks/link-embeddings.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Embedding-ranked internal-link candidates. The query and the corpus are
+ * embedded through governed `embedForFeature` calls in batches of
+ * {@link EMBED_BATCH_SIZE} inputs (plugin-ai's `semanticSearch` made N+1
+ * ungoverned calls; a single request for a 5000-page site blew the provider's
+ * per-request input limit). Returns `null` when the runtime refuses so callers
+ * fall back to {@link phraseMatchLinks}.
+ */
+export declare const LINK_SUGGEST_FEATURE = "ai.features.seoInternalLinks";
+export declare const LINK_SIMILARITY_THRESHOLD = 0.35;
+/** Per-item content cap before embedding — enough context, bounded token cost. */
+export declare const CONTENT_MAX_CHARS = 2000;
+/** Max inputs per embeddings request (the first request also carries the query). */
+export declare const EMBED_BATCH_SIZE = 256;
+/** Largest corpus we embed; bigger ones are pre-trimmed by {@link trimCorpusForEmbedding}. */
+export declare const MAX_CORPUS_ITEMS = 1000;
+export interface LinkCorpusItem {
+    id: string;
+    title: string;
+    content: string;
+    /** Recency tie-breaker for the pre-trim; optional for callers without it. */
+    updatedAt?: string | Date;
+}
+export interface RankedLink {
+    id: string;
+    title: string;
+    score: number;
+    excerpt: string;
+}
+/**
+ * Deterministic pre-trim for corpora above the embedding cap: items whose
+ * title/content share the most query tokens come first (a `phraseMatchLinks`-
+ * style overlap), then the most recently updated. Stable for ties so the
+ * result is reproducible. Returns the input untouched when it already fits.
+ */
+export declare function trimCorpusForEmbedding(query: string, corpus: LinkCorpusItem[], max?: number): LinkCorpusItem[];
+/**
+ * Rank `corpus` against `query` by embedding cosine similarity. Everything
+ * (toggle, budget, daily cap, key resolution, metering) is enforced inside
+ * `embedForFeature`; any refusal or provider failure yields `null`. Corpora
+ * above {@link MAX_CORPUS_ITEMS} are pre-trimmed deterministically, every item
+ * is clamped to {@link CONTENT_MAX_CHARS}, and requests are chunked.
+ */
+export declare function rankByEmbedding(db: unknown, query: string, corpus: LinkCorpusItem[], opts?: {
+    limit?: number;
+    userId?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<RankedLink[] | null>;
+/**
+ * Deterministic fallback: a source qualifies when its content contains the
+ * target title or one of its keywords. Score 0.6 for a title hit, 0.4 for a
+ * keyword-only hit (both clear the 40% wrappable floor in link-suggest).
+ */
+export declare function phraseMatchLinks(targetTitle: string, keywords: string[], corpus: LinkCorpusItem[], limit: number): RankedLink[];
+//# sourceMappingURL=link-embeddings.d.ts.map

package/dist/ai/tasks/link-embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-embeddings.d.ts","sourceRoot":"","sources":["../../../src/ai/tasks/link-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,eAAO,MAAM,oBAAoB,iCAAiC,CAAA;AAClE,eAAO,MAAM,yBAAyB,OAAO,CAAA;AAC7C,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,OAAO,CAAA;AACrC,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAMpC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAwBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EAAE,EACxB,GAAG,SAAmB,GACrB,cAAc,EAAE,CAkBlB;AA+BD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,OAAO,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EAAE,EACxB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACvE,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CA2B9B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,MAAM,GACZ,UAAU,EAAE,CAmBd"}

package/dist/ai/tasks/link-embeddings.js

@@ -0,0 +1,160 @@
+/**
+ * Embedding-ranked internal-link candidates. The query and the corpus are
+ * embedded through governed `embedForFeature` calls in batches of
+ * {@link EMBED_BATCH_SIZE} inputs (plugin-ai's `semanticSearch` made N+1
+ * ungoverned calls; a single request for a 5000-page site blew the provider's
+ * per-request input limit). Returns `null` when the runtime refuses so callers
+ * fall back to {@link phraseMatchLinks}.
+ */
+import { embedForFeature } from '../runtime.js';
+import { cosineSimilarity } from '../vector.js';
+export const LINK_SUGGEST_FEATURE = 'ai.features.seoInternalLinks';
+export const LINK_SIMILARITY_THRESHOLD = 0.35;
+/** Per-item content cap before embedding — enough context, bounded token cost. */
+export const CONTENT_MAX_CHARS = 2000;
+/** Max inputs per embeddings request (the first request also carries the query). */
+export const EMBED_BATCH_SIZE = 256;
+/** Largest corpus we embed; bigger ones are pre-trimmed by {@link trimCorpusForEmbedding}. */
+export const MAX_CORPUS_ITEMS = 1000;
+const EXCERPT_CHARS = 200;
+const DEFAULT_LIMIT = 10;
+/** Query tokens shorter than this carry no signal for the pre-trim. */
+const MIN_TOKEN_CHARS = 3;
+function excerptAround(content, terms) {
+    const lower = content.toLowerCase();
+    let start = 0;
+    for (const term of terms) {
+        const idx = lower.indexOf(term);
+        if (idx >= 0) {
+            start = Math.max(0, idx - 50);
+            break;
+        }
+    }
+    return content.slice(start, start + EXCERPT_CHARS);
+}
+function updatedAtMs(item) {
+    if (item.updatedAt instanceof Date)
+        return item.updatedAt.getTime();
+    if (typeof item.updatedAt === 'string') {
+        const t = Date.parse(item.updatedAt);
+        return Number.isNaN(t) ? 0 : t;
+    }
+    return 0;
+}
+/**
+ * Deterministic pre-trim for corpora above the embedding cap: items whose
+ * title/content share the most query tokens come first (a `phraseMatchLinks`-
+ * style overlap), then the most recently updated. Stable for ties so the
+ * result is reproducible. Returns the input untouched when it already fits.
+ */
+export function trimCorpusForEmbedding(query, corpus, max = MAX_CORPUS_ITEMS) {
+    if (corpus.length <= max)
+        return corpus;
+    const tokens = [
+        ...new Set(query
+            .toLowerCase()
+            .split(/[^\p{L}\p{N}]+/u)
+            .filter((t) => t.length >= MIN_TOKEN_CHARS)),
+    ];
+    const scored = corpus.map((item, index) => {
+        const hay = `${item.title} ${item.content}`.toLowerCase();
+        let overlap = 0;
+        for (const t of tokens)
+            if (hay.includes(t))
+                overlap++;
+        return { item, index, overlap, recency: updatedAtMs(item) };
+    });
+    scored.sort((a, b) => b.overlap - a.overlap || b.recency - a.recency || a.index - b.index);
+    return scored.slice(0, max).map((s) => s.item);
+}
+/**
+ * Embed `texts` in sequential batches of {@link EMBED_BATCH_SIZE}. The first
+ * batch also carries the query (so it has one extra input). Stops at the first
+ * refusal and returns `null` — a partially embedded corpus is not rankable.
+ */
+async function embedInBatches(db, query, contents, opts) {
+    let queryVec;
+    const vecs = [];
+    for (let start = 0; start < contents.length; start += EMBED_BATCH_SIZE) {
+        const chunk = contents.slice(start, start + EMBED_BATCH_SIZE);
+        const texts = start === 0 ? [query, ...chunk] : chunk;
+        const res = await embedForFeature(db, LINK_SUGGEST_FEATURE, texts, {
+            userId: opts.userId,
+            fetchImpl: opts.fetchImpl,
+        });
+        if (!res.ok)
+            return null;
+        const out = start === 0 ? res.vectors.slice(1) : res.vectors;
+        if (start === 0)
+            queryVec = res.vectors[0];
+        vecs.push(...out);
+    }
+    if (!queryVec)
+        return null;
+    return { queryVec, vecs };
+}
+/**
+ * Rank `corpus` against `query` by embedding cosine similarity. Everything
+ * (toggle, budget, daily cap, key resolution, metering) is enforced inside
+ * `embedForFeature`; any refusal or provider failure yields `null`. Corpora
+ * above {@link MAX_CORPUS_ITEMS} are pre-trimmed deterministically, every item
+ * is clamped to {@link CONTENT_MAX_CHARS}, and requests are chunked.
+ */
+export async function rankByEmbedding(db, query, corpus, opts = {}) {
+    if (corpus.length === 0)
+        return [];
+    const trimmed = trimCorpusForEmbedding(query, corpus);
+    const contents = trimmed.map((c) => c.content.slice(0, CONTENT_MAX_CHARS));
+    const embedded = await embedInBatches(db, query.slice(0, CONTENT_MAX_CHARS), contents, {
+        userId: opts.userId,
+        fetchImpl: opts.fetchImpl,
+    });
+    if (!embedded)
+        return null;
+    const { queryVec, vecs } = embedded;
+    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    const ranked = [];
+    trimmed.forEach((item, i) => {
+        const vec = vecs[i];
+        if (!vec)
+            return;
+        const score = cosineSimilarity(queryVec, vec);
+        if (score >= LINK_SIMILARITY_THRESHOLD) {
+            ranked.push({
+                id: item.id,
+                title: item.title,
+                score,
+                excerpt: excerptAround(item.content, terms),
+            });
+        }
+    });
+    ranked.sort((a, b) => b.score - a.score);
+    return ranked.slice(0, opts.limit ?? DEFAULT_LIMIT);
+}
+/**
+ * Deterministic fallback: a source qualifies when its content contains the
+ * target title or one of its keywords. Score 0.6 for a title hit, 0.4 for a
+ * keyword-only hit (both clear the 40% wrappable floor in link-suggest).
+ */
+export function phraseMatchLinks(targetTitle, keywords, corpus, limit) {
+    const title = targetTitle.trim().toLowerCase();
+    const kws = keywords.map((k) => k.trim().toLowerCase()).filter(Boolean);
+    const out = [];
+    for (const item of corpus) {
+        const lower = item.content.toLowerCase();
+        const titleHit = title.length > 0 && lower.includes(title);
+        const kwHit = kws.find((k) => lower.includes(k));
+        if (!titleHit && !kwHit)
+            continue;
+        const term = titleHit ? title : kwHit;
+        out.push({
+            id: item.id,
+            title: item.title,
+            score: titleHit ? 0.6 : 0.4,
+            excerpt: excerptAround(item.content, term ? [term] : []),
+        });
+    }
+    out.sort((a, b) => b.score - a.score);
+    return out.slice(0, limit);
+}
+//# sourceMappingURL=link-embeddings.js.map

package/dist/ai/tasks/link-embeddings.js.map

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

package/dist/ai/types.d.ts

@@ -1,11 +1,10 @@
 /**
- * Shared types for the Settings > AI governance layer.
- *
- * Phases 1-2 cover provider connections (encrypted keys) and a dynamic,
- * normalized model catalog. Feature config, budget, and data-policy shapes are
- * declared here for forward-compatibility (enforcement + metering land in later
- * phases) but only `features[].enabled` and `budget.monthlyTokenLimit` are
- * wired into the UI for now.
+ * Shared types for the Settings > AI governance layer: provider connections
+ * (encrypted or env-managed keys), the normalized model catalog, per-feature
+ * toggles / routing / approval / daily caps, the monthly token budget, and the
+ * brand voice profile. Everything declared here is read by the governed
+ * runtime (`runtime.ts`) or the admin UI — fields that were once reserved for
+ * future phases were removed in Spec B rather than left as silent no-ops.
  */
 /** Provider keys are stable code identifiers. `openai` covers OpenAI/ChatGPT. */
 export type AIProviderKey = 'openai' | 'anthropic' | 'xai' | 'custom';
@@ -82,7 +81,7 @@ export type AIProviderConnectionPublic = Omit<AIProviderConnection, 'apiKeyEncry
     keyManagedExternally: boolean;
     hasKey: boolean;
 };
-export type AIFeatureCategory = 'seo' | 'media' | 'content' | 'forms' | 'security' | 'developer' | 'search';
+type AIFeatureCategory = 'seo' | 'media' | 'content' | 'forms' | 'security' | 'developer' | 'search';
 export interface AIFeatureConfig {
     key: string;
     label: string;
@@ -95,19 +94,11 @@ export interface AIFeatureConfig {
     fallbackModelIds?: string[];
     approvalRequired: boolean;
     allowBulkApply: boolean;
-    maxMonthlyTokens?: number;
     maxRequestsPerDay?: number;
-    rolesAllowed: string[];
-    permissionsRequired: string[];
-    dataPolicyKey?: string;
 }
 export interface AIBudgetSettings {
     monthlyTokenLimit?: number;
-    monthlyCostLimit?: number;
-    alertAtPercentages: number[];
     disableWhenExceeded: boolean;
-    perFeatureLimits?: Record<string, number>;
-    perUserLimits?: Record<string, number>;
 }
 /**
  * Brand voice profile. A reusable description of how generated copy should
@@ -145,11 +136,9 @@ export interface AISettings {
     defaultTextModelId?: string;
     defaultReasoningModelId?: string;
     defaultVisionModelId?: string;
-    defaultEmbeddingModelId?: string;
     defaultImageGenerationModelId?: string;
     features: AIFeatureConfig[];
     budget: AIBudgetSettings;
-    logsRetentionDays: number;
     /** Active brand voice. Absent until an admin configures it. */
     brandVoice?: BrandVoiceProfile;
 }
@@ -171,7 +160,13 @@ export interface AIConfigDocument {
     updatedAt?: string;
     updatedBy?: string;
 }
-/** Monthly usage summary for the budget meter (real counts; 0 until Phase 4). */
+/**
+ * Monthly usage summary for the budget meter. Sums the token fields the
+ * governed runtime writes to `prenta_audit_logs` (`ai_usage` rows:
+ * `promptTokens` / `completionTokens` / `totalTokens`) plus legacy
+ * `tokensUsed` / `totalTokensUsed` rows from older handlers. Real counts —
+ * 0 when nothing has run in the period, never a fabricated number.
+ */
 export interface AIUsageSummary {
     totalTokens: number;
     promptTokens: number;
@@ -190,4 +185,5 @@ export interface AIConnectionTestResult {
     message: string;
     testedAt: string;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map