@actuate-media/cms-core 0.77.3 → 0.79.0

package/dist/seo/fix-brief-export.js

@@ -0,0 +1,224 @@
+/**
+ * Markdown export for SEO issues that require human / dev-team follow-up
+ * (headings, thin content, broken links, etc.) — Phase A handoff artifact.
+ */
+import { AI_FIX_TYPES } from './issue-fix-ai.js';
+import { DETERMINISTIC_FIX_TYPES } from './issue-fix.js';
+import { renderContentBriefMarkdown } from './issue-content-brief.js';
+import { renderContentResearchMarkdown } from './issue-content-research.js';
+/** Issue types handled by inline Approve fix (deterministic + AI). */
+export const INLINE_FIX_ISSUE_TYPES = new Set([...DETERMINISTIC_FIX_TYPES, ...AI_FIX_TYPES]);
+const METADATA_FIX_ACTIONS = new Set([
+    'edit-metadata',
+    'edit-canonical',
+    'edit-og',
+    'edit-og-image',
+    'edit-schema',
+]);
+/**
+ * True when an issue should be handed off via export rather than inline approve.
+ */
+export function isManualHandoffIssue(issue) {
+    if (INLINE_FIX_ISSUE_TYPES.has(issue.type))
+        return false;
+    if (issue.fixActionType === 'edit-content')
+        return true;
+    if (!issue.fixable)
+        return true;
+    if (issue.fixActionType && !METADATA_FIX_ACTIONS.has(issue.fixActionType))
+        return true;
+    return false;
+}
+export function filterFixBriefIssues(issues, manualOnly = true) {
+    if (!manualOnly)
+        return issues;
+    return issues.filter(isManualHandoffIssue);
+}
+function formatAuditDate(value) {
+    if (!value)
+        return 'Unknown';
+    const d = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(d.getTime()))
+        return 'Unknown';
+    return d.toLocaleString('en-US', { dateStyle: 'medium', timeStyle: 'short' });
+}
+function sanitizeFilenamePart(value) {
+    return value.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'site';
+}
+export function fixBriefFilename(siteName, auditDate) {
+    const site = sanitizeFilenamePart(siteName ?? 'seo');
+    const d = auditDate instanceof Date ? auditDate : auditDate ? new Date(auditDate) : new Date();
+    const stamp = Number.isNaN(d.getTime()) ? 'undated' : d.toISOString().slice(0, 10);
+    return `${site}-seo-fix-brief-${stamp}.md`;
+}
+/** Relative admin path for opening the page/editor (consumer resolves basePath). */
+export function adminPathForIssue(issue) {
+    const id = issue.entityId;
+    if (!id) {
+        if (issue.fixActionType === 'fix-link' || issue.fixActionType === 'create-redirect') {
+            return '/seo?tab=redirects';
+        }
+        if (issue.fixActionType === 'improve-speed')
+            return '/seo?tab=technical';
+        if (issue.fixActionType === 'optimize-media')
+            return '/media';
+        return null;
+    }
+    switch (issue.fixActionType) {
+        case 'edit-metadata':
+        case 'edit-canonical':
+        case 'edit-og':
+        case 'edit-og-image':
+        case 'edit-schema':
+            if (issue.entityType) {
+                return `/seo?tab=content&entityType=${issue.entityType}&entityId=${encodeURIComponent(id)}`;
+            }
+            break;
+        case 'edit-content':
+            if (issue.entityType === 'page')
+                return `/pages/${id}`;
+            if (issue.entityType === 'post') {
+                return `/seo?tab=content&entityType=post&entityId=${encodeURIComponent(id)}`;
+            }
+            break;
+        case 'fix-link':
+        case 'create-redirect':
+            return '/seo?tab=redirects';
+        case 'optimize-media':
+            return '/media';
+        case 'improve-speed':
+            return '/seo?tab=technical';
+        default:
+            if (issue.entityType === 'page')
+                return `/pages/${id}`;
+            if (issue.entityType) {
+                return `/seo?tab=content&entityType=${issue.entityType}&entityId=${encodeURIComponent(id)}`;
+            }
+    }
+    return null;
+}
+function groupKey(issue) {
+    if (issue.entityType && issue.entityId)
+        return `${issue.entityType}:${issue.entityId}`;
+    return `site:${issue.url ?? issue.id}`;
+}
+function severityRank(severity) {
+    switch (severity) {
+        case 'critical':
+            return 0;
+        case 'warning':
+            return 1;
+        default:
+            return 2;
+    }
+}
+function sortIssues(issues) {
+    return [...issues].sort((a, b) => {
+        const sr = severityRank(a.severity) - severityRank(b.severity);
+        if (sr !== 0)
+            return sr;
+        return a.title.localeCompare(b.title);
+    });
+}
+function renderIssueBlock(issue, index) {
+    const lines = [];
+    lines.push(`### ${index}. ${issue.title}`);
+    lines.push('');
+    lines.push(`- **Severity:** ${issue.severity} | **Category:** ${issue.category} | **Status:** ${issue.status}`);
+    lines.push(`- **Issue ID:** \`${issue.id}\` _(use to mark resolved in Admin → SEO → Audit)_`);
+    if (issue.impact)
+        lines.push(`- **Impact:** ${issue.impact}`);
+    if (issue.description)
+        lines.push(`- **Why:** ${issue.description}`);
+    if (issue.recommendation)
+        lines.push(`- **Fix:** ${issue.recommendation}`);
+    const adminPath = adminPathForIssue(issue);
+    if (adminPath)
+        lines.push(`- **Admin:** \`${adminPath}\``);
+    if (issue.contentResearch) {
+        lines.push('');
+        lines.push(renderContentResearchMarkdown(issue.contentResearch).trimEnd());
+    }
+    if (issue.contentBrief) {
+        lines.push('');
+        lines.push(renderContentBriefMarkdown(issue.contentBrief).trimEnd());
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Build a developer handoff markdown document from open audit issues.
+ */
+export function buildSeoFixBriefMarkdown(input) {
+    const manualOnly = input.manualOnly !== false;
+    const filtered = filterFixBriefIssues(input.issues, manualOnly);
+    const siteLabel = input.siteName?.trim() || input.siteUrl?.trim() || 'Site';
+    const auditLabel = formatAuditDate(input.auditDate);
+    const scopeLabel = manualOnly ? 'manual fixes' : 'all listed issues';
+    const header = [
+        '# SEO Content Fix Brief',
+        '',
+        `**Site:** ${siteLabel}${input.siteUrl ? ` (${input.siteUrl})` : ''}`,
+        `**Audit date:** ${auditLabel}${input.auditRunId ? ` | **Run ID:** \`${input.auditRunId}\`` : ''}`,
+        `**${scopeLabel.charAt(0).toUpperCase() + scopeLabel.slice(1)} in this export:** ${filtered.length}`,
+        '',
+        '## How to use this document',
+        '',
+        '1. Work through each page section below in the CMS or codebase.',
+        '2. Re-run **SEO → Run audit** to verify fixes.',
+        '3. Mark issues resolved in **Admin → SEO → Audit** (use the Issue ID on each item).',
+        '',
+    ];
+    if (filtered.length === 0) {
+        return [
+            ...header,
+            '_No issues match this export filter. Try turning off “manual only” or adjust audit filters._',
+            '',
+        ].join('\n');
+    }
+    const groups = new Map();
+    for (const issue of filtered) {
+        const key = groupKey(issue);
+        const arr = groups.get(key) ?? [];
+        arr.push(issue);
+        groups.set(key, arr);
+    }
+    const sections = [];
+    let sectionNum = 0;
+    const sortedGroups = [...groups.entries()].sort(([, aIssues], [, bIssues]) => {
+        const aMin = Math.min(...aIssues.map((i) => severityRank(i.severity)));
+        const bMin = Math.min(...bIssues.map((i) => severityRank(i.severity)));
+        if (aMin !== bMin)
+            return aMin - bMin;
+        const aTitle = aIssues[0]?.entityTitle ?? aIssues[0]?.url ?? '';
+        const bTitle = bIssues[0]?.entityTitle ?? bIssues[0]?.url ?? '';
+        return aTitle.localeCompare(bTitle);
+    });
+    for (const [, groupIssues] of sortedGroups) {
+        sectionNum += 1;
+        const sorted = sortIssues(groupIssues);
+        const first = sorted[0];
+        const pageTitle = first.entityTitle?.trim() || first.url?.trim() || 'Site-wide issue';
+        const pageUrl = first.url?.trim();
+        sections.push(`## ${sectionNum}. ${pageTitle}`);
+        sections.push('');
+        if (pageUrl)
+            sections.push(`- **URL:** ${pageUrl}`);
+        if (first.entityType && first.entityId) {
+            sections.push(`- **Entity:** ${first.entityType} \`${first.entityId}\``);
+        }
+        const pageAdmin = first.entityId && first.entityType === 'page'
+            ? `/pages/${first.entityId}`
+            : adminPathForIssue(first);
+        if (pageAdmin)
+            sections.push(`- **Open in admin:** \`${pageAdmin}\``);
+        sections.push('');
+        let issueIndex = 0;
+        for (const issue of sorted) {
+            issueIndex += 1;
+            sections.push(renderIssueBlock(issue, issueIndex));
+        }
+    }
+    return [...header, ...sections].join('\n');
+}
+//# sourceMappingURL=fix-brief-export.js.map

package/dist/seo/fix-brief-export.js.map

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

package/dist/seo/index.d.ts

@@ -13,7 +13,8 @@ export { selectLlmsDocs, toLlmsPage, readLlmsInclude, isLlmsNoindex } from './ll
 export { matchPathToCollection } from './resolve-path.js';
 export type { PathMatch } from './resolve-path.js';
 export type { LlmsTxtConfig, LlmsTxtPage } from './llms-txt.js';
-export { composePageMeta, detectSchemaType, resolveContentDates, resolveEffectiveCanonicalUrl, } from './page-meta.js';
+export { composePageMeta, detectSchemaType, resolveContentDates, resolveEffectiveCanonicalUrl, resolveEffectiveMeta, } from './page-meta.js';
+export type { EffectiveMeta, ResolveEffectiveMetaParams } from './page-meta.js';
 export { applyStructuredDataFieldsToData, composeStructuredDataForPublish, isPublicContentCollection, prepareContentStructuredData, resolveEffectiveSchemaType, syncSchemaTypeFields, } from './schema-sync.js';
 export type { ContentStructuredDataPrep } from './schema-sync.js';
 export type { ComposePageMetaInput, ComposedPageMeta, ComposeDocumentInput } from './page-meta.js';
@@ -36,7 +37,22 @@ export type { AuditEntityInput, AuditExtraSignals, DetectedIssue, AuditPageRecor
 export { runAndPersistAudit, gatherAuditEntities, documentToAuditEntity, frontEndContentCollectionTypes, isInternalCollection, } from './audit-runner.js';
 export { migrateStructuredDataFields } from './migrate-schema.js';
 export type { MigrateStructuredDataOptions, MigrateStructuredDataResult } from './migrate-schema.js';
+export { migrateMetaFields } from './migrate-meta.js';
+export type { MigrateMetaOptions, MigrateMetaResult } from './migrate-meta.js';
+export { gatherAuditSignals, gatherRedirectSignals, detectBrokenInternalLinks, } from './audit-signals.js';
 export type { ContentCollectionTypes } from './audit-runner.js';
 export { computeSiteIndexStatus, getSiteIndexStatus, robotsTxtBlocksEntireSite, } from './index-status.js';
 export type { SiteIndexStatus, IndexStatusLevel, IndexStatusSeverity, IndexCheck, IndexCheckStatus, IndexAction, IndexStatusInputs, } from './index-status.js';
+export { suggestDeterministicFix, suggestIssueFix, truncateAtWordBoundary, excerptForMetaDescription, buildFixFingerprint, DETERMINISTIC_FIX_TYPES, META_TITLE_MAX, META_TITLE_MIN, META_DESC_MAX, META_DESC_MIN, } from './issue-fix.js';
+export type { SeoFixFieldChange, SeoIssueFixSuggestion, SeoIssueFixInput, SeoIssueFixContext, SuggestIssueFixResult, } from './issue-fix.js';
+export { suggestAiFix, AI_FIX_TYPES, pendingFixFromMetadata, pendingFixToMetadata, } from './issue-fix-ai.js';
+export type { AiFixDeps, AiFixResult, PendingFixCache } from './issue-fix-ai.js';
+export { buildSeoFixBriefMarkdown, filterFixBriefIssues, fixBriefFilename, isManualHandoffIssue, adminPathForIssue, INLINE_FIX_ISSUE_TYPES, } from './fix-brief-export.js';
+export type { FixBriefIssue, FixBriefExportInput } from './fix-brief-export.js';
+export { generateContentBrief, supportsContentBrief, contentBriefFromMetadata, contentBriefToMetadata, renderContentBriefMarkdown, CONTENT_BRIEF_ISSUE_TYPES, } from './issue-content-brief.js';
+export type { SeoContentBrief, SeoContentBriefSection, ContentBriefIssueInput, ContentBriefContext, ContentBriefResult, } from './issue-content-brief.js';
+export { generateContentResearch, supportsContentResearch, contentResearchFromMetadata, contentResearchToMetadata, renderContentResearchMarkdown, RESEARCH_ISSUE_TYPES, MAX_COMPETITOR_URLS, } from './issue-content-research.js';
+export type { SeoContentResearch, SeoContentResearchCompetitor, ContentResearchIssueInput, ContentResearchContext, ContentResearchResult, } from './issue-content-research.js';
+export { batchGenerateContentBriefs, BATCH_BRIEF_MAX_ISSUES, BATCH_BRIEF_CONCURRENCY, } from './issue-batch-briefs.js';
+export type { BatchBriefIssueRow, BatchBriefEntityContext, BatchBriefOptions, BatchBriefItemResult, BatchBriefResult, } from './issue-batch-briefs.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/seo/index.d.ts.map

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

package/dist/seo/index.js

@@ -6,7 +6,7 @@ export { generateLlmsTxt, sanitizeLlmsText } from './llms-txt.js';
 export { documentToMarkdown, htmlToMarkdown } from './content-markdown.js';
 export { selectLlmsDocs, toLlmsPage, readLlmsInclude, isLlmsNoindex } from './llms-select.js';
 export { matchPathToCollection } from './resolve-path.js';
-export { composePageMeta, detectSchemaType, resolveContentDates, resolveEffectiveCanonicalUrl, } from './page-meta.js';
+export { composePageMeta, detectSchemaType, resolveContentDates, resolveEffectiveCanonicalUrl, resolveEffectiveMeta, } from './page-meta.js';
 export { applyStructuredDataFieldsToData, composeStructuredDataForPublish, isPublicContentCollection, prepareContentStructuredData, resolveEffectiveSchemaType, syncSchemaTypeFields, } from './schema-sync.js';
 export { analyzeImageAlts, countMissingAltImages, isDecorativeImgTag } from './alt-text.js';
 export { buildRssFeed, buildJsonFeed } from './feeds.js';
@@ -18,5 +18,13 @@ export { calculatePageSeoScore, calculateSiteSeoScore, gradeForSeoScore, countH1
 export { runSeoAuditAnalysis, buildQuickWins, issueKeyFor } from './audit-engine.js';
 export { runAndPersistAudit, gatherAuditEntities, documentToAuditEntity, frontEndContentCollectionTypes, isInternalCollection, } from './audit-runner.js';
 export { migrateStructuredDataFields } from './migrate-schema.js';
+export { migrateMetaFields } from './migrate-meta.js';
+export { gatherAuditSignals, gatherRedirectSignals, detectBrokenInternalLinks, } from './audit-signals.js';
 export { computeSiteIndexStatus, getSiteIndexStatus, robotsTxtBlocksEntireSite, } from './index-status.js';
+export { suggestDeterministicFix, suggestIssueFix, truncateAtWordBoundary, excerptForMetaDescription, buildFixFingerprint, DETERMINISTIC_FIX_TYPES, META_TITLE_MAX, META_TITLE_MIN, META_DESC_MAX, META_DESC_MIN, } from './issue-fix.js';
+export { suggestAiFix, AI_FIX_TYPES, pendingFixFromMetadata, pendingFixToMetadata, } from './issue-fix-ai.js';
+export { buildSeoFixBriefMarkdown, filterFixBriefIssues, fixBriefFilename, isManualHandoffIssue, adminPathForIssue, INLINE_FIX_ISSUE_TYPES, } from './fix-brief-export.js';
+export { generateContentBrief, supportsContentBrief, contentBriefFromMetadata, contentBriefToMetadata, renderContentBriefMarkdown, CONTENT_BRIEF_ISSUE_TYPES, } from './issue-content-brief.js';
+export { generateContentResearch, supportsContentResearch, contentResearchFromMetadata, contentResearchToMetadata, renderContentResearchMarkdown, RESEARCH_ISSUE_TYPES, MAX_COMPETITOR_URLS, } from './issue-content-research.js';
+export { batchGenerateContentBriefs, BATCH_BRIEF_MAX_ISSUES, BATCH_BRIEF_CONCURRENCY, } from './issue-batch-briefs.js';
 //# sourceMappingURL=index.js.map

package/dist/seo/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAA;AAItB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AAIvB,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAI5E,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAA;AAS7B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE1E,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAKzD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAI3F,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAIxD,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAIrB,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAIpF,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAA;AAS5B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAanB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAWpF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAIjE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"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"}

package/dist/seo/issue-batch-briefs.d.ts

@@ -0,0 +1,37 @@
+import type { AiFixDeps } from './issue-fix-ai.js';
+import type { AuditEntityInput } from './audit-engine.js';
+export declare const BATCH_BRIEF_MAX_ISSUES = 15;
+export declare const BATCH_BRIEF_CONCURRENCY = 2;
+export interface BatchBriefIssueRow {
+    id: string;
+    type: string;
+    title: string;
+    description?: string | null;
+    recommendation?: string | null;
+    entityId?: string | null;
+    entityType?: string | null;
+    metadata?: unknown;
+}
+export interface BatchBriefEntityContext {
+    entity: AuditEntityInput;
+    updatedAt: Date;
+    collection: string;
+}
+export interface BatchBriefOptions {
+    skipExisting?: boolean;
+    includeResearch?: boolean;
+    competitorUrls?: string[];
+}
+export interface BatchBriefItemResult {
+    issueId: string;
+    status: 'generated' | 'skipped' | 'failed';
+    error?: string;
+}
+export interface BatchBriefResult {
+    generated: number;
+    skipped: number;
+    failed: number;
+    results: BatchBriefItemResult[];
+}
+export declare function batchGenerateContentBriefs(issues: BatchBriefIssueRow[], contexts: Map<string, BatchBriefEntityContext>, deps: AiFixDeps, options?: BatchBriefOptions): Promise<BatchBriefResult>;
+//# sourceMappingURL=issue-batch-briefs.d.ts.map

package/dist/seo/issue-batch-briefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-batch-briefs.d.ts","sourceRoot":"","sources":["../../src/seo/issue-batch-briefs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAelD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,eAAO,MAAM,sBAAsB,KAAK,CAAA;AACxC,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAA;IACxB,SAAS,EAAE,IAAI,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,oBAAoB,EAAE,CAAA;CAChC;AA2BD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,kBAAkB,EAAE,EAC5B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAC9C,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAwF3B"}

package/dist/seo/issue-batch-briefs.js

@@ -0,0 +1,85 @@
+import { contentBriefFromMetadata, contentBriefToMetadata, generateContentBrief, supportsContentBrief, } from './issue-content-brief.js';
+import { contentResearchFromMetadata, contentResearchToMetadata, generateContentResearch, supportsContentResearch, } from './issue-content-research.js';
+export const BATCH_BRIEF_MAX_ISSUES = 15;
+export const BATCH_BRIEF_CONCURRENCY = 2;
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    return value;
+}
+async function mapWithConcurrency(items, concurrency, fn) {
+    const results = new Array(items.length);
+    let index = 0;
+    async function worker() {
+        while (index < items.length) {
+            const i = index++;
+            results[i] = await fn(items[i]);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+export async function batchGenerateContentBriefs(issues, contexts, deps, options = {}) {
+    const skipExisting = options.skipExisting !== false;
+    const includeResearch = options.includeResearch === true;
+    const capped = issues.filter((i) => supportsContentBrief(i.type)).slice(0, BATCH_BRIEF_MAX_ISSUES);
+    const results = await mapWithConcurrency(capped, BATCH_BRIEF_CONCURRENCY, async (issue) => {
+        if (!issue.entityId) {
+            return { issueId: issue.id, status: 'failed', error: 'Not linked to content.' };
+        }
+        const ctx = contexts.get(issue.entityId);
+        if (!ctx) {
+            return { issueId: issue.id, status: 'failed', error: 'Content not found.' };
+        }
+        if (skipExisting) {
+            const existing = contentBriefFromMetadata(issue.metadata, issue.type, issue.entityId, ctx.updatedAt);
+            if (existing) {
+                return { issueId: issue.id, status: 'skipped' };
+            }
+        }
+        let research = null;
+        if (includeResearch && supportsContentResearch(issue.type)) {
+            const cachedResearch = contentResearchFromMetadata(issue.metadata, issue.type, issue.entityId, ctx.updatedAt);
+            if (cachedResearch) {
+                research = cachedResearch;
+            }
+            else {
+                const researchResult = await generateContentResearch(issue, { entity: ctx.entity, updatedAt: ctx.updatedAt }, { ...deps, collection: ctx.collection }, { competitorUrls: options.competitorUrls });
+                if (!researchResult.ok) {
+                    return { issueId: issue.id, status: 'failed', error: researchResult.message };
+                }
+                research = researchResult.research;
+            }
+        }
+        const briefResult = await generateContentBrief(issue, { entity: ctx.entity, updatedAt: ctx.updatedAt }, { ...deps, collection: ctx.collection }, research ? { research } : undefined);
+        if (!briefResult.ok) {
+            return { issueId: issue.id, status: 'failed', error: briefResult.message };
+        }
+        const metaPatch = {
+            ...asRecord(issue.metadata),
+            ...contentBriefToMetadata(briefResult.brief),
+        };
+        if (research) {
+            Object.assign(metaPatch, contentResearchToMetadata(research));
+        }
+        await deps.db.seoIssue.update({
+            where: { id: issue.id },
+            data: { metadata: metaPatch },
+        });
+        return { issueId: issue.id, status: 'generated' };
+    });
+    let generated = 0;
+    let skipped = 0;
+    let failed = 0;
+    for (const r of results) {
+        if (r.status === 'generated')
+            generated++;
+        else if (r.status === 'skipped')
+            skipped++;
+        else
+            failed++;
+    }
+    return { generated, skipped, failed, results };
+}
+//# sourceMappingURL=issue-batch-briefs.js.map

package/dist/seo/issue-batch-briefs.js.map

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

package/dist/seo/issue-content-brief.d.ts

@@ -0,0 +1,51 @@
+import type { AuditEntityInput } from './audit-engine.js';
+import type { AiFixDeps } from './issue-fix-ai.js';
+import type { SeoContentResearch } from './issue-content-research.js';
+export declare const CONTENT_BRIEF_ISSUE_TYPES: Set<string>;
+export interface SeoContentBriefSection {
+    heading: string;
+    bullets: string[];
+}
+export interface SeoContentBrief {
+    issueType: string;
+    entityId: string;
+    fingerprint: string;
+    generatedAt: string;
+    summary: string;
+    suggestedH1: string | null;
+    targetWordCount: number | null;
+    topics: string[];
+    sections: SeoContentBriefSection[];
+    keyTakeawayDraft: string | null;
+    geoNote: string | null;
+    aiUnavailable?: boolean;
+}
+export interface ContentBriefIssueInput {
+    id: string;
+    type: string;
+    title: string;
+    description?: string | null;
+    recommendation?: string | null;
+    entityId?: string | null;
+}
+export interface ContentBriefContext {
+    entity: AuditEntityInput;
+    updatedAt: string | Date;
+}
+export type ContentBriefResult = {
+    ok: true;
+    brief: SeoContentBrief;
+} | {
+    ok: false;
+    code: 'unsupported' | 'unavailable' | 'rate_limited' | 'feature_disabled' | 'error';
+    message: string;
+};
+export declare function supportsContentBrief(issueType: string): boolean;
+export declare function contentBriefFromMetadata(metadata: unknown, issueType: string, entityId: string, updatedAt: string | Date): SeoContentBrief | null;
+export declare function contentBriefToMetadata(brief: SeoContentBrief): Record<string, unknown>;
+export declare function generateContentBrief(issue: ContentBriefIssueInput, ctx: ContentBriefContext, deps: AiFixDeps, options?: {
+    research?: SeoContentResearch | null;
+}): Promise<ContentBriefResult>;
+/** Render a content brief as markdown for export handoff docs. */
+export declare function renderContentBriefMarkdown(brief: SeoContentBrief): string;
+//# sourceMappingURL=issue-content-brief.d.ts.map

package/dist/seo/issue-content-brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-content-brief.d.ts","sourceRoot":"","sources":["../../src/seo/issue-content-brief.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAErE,eAAO,MAAM,yBAAyB,aAKpC,CAAA;AAKF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,sBAAsB,EAAE,CAAA;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAA;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACpC;IACE,EAAE,EAAE,KAAK,CAAA;IACT,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,cAAc,GAAG,kBAAkB,GAAG,OAAO,CAAA;IACnF,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAiFL,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,eAAe,GAAG,IAAI,CAqBxB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtF;AA6BD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAAE,GACjD,OAAO,CAAC,kBAAkB,CAAC,CAoG7B;AAED,kEAAkE;AAClE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAkBzE"}