@prenta/core 5.5.0 → 5.7.0

package/dist/seo/proposals.js

@@ -0,0 +1,270 @@
+import { getFeatureGovernance } from '../ai/governance.js';
+import { buildFixFingerprint } from './issue-fix.js';
+import { pendingFixFromMetadata, stickyFingerprintsFromMetadata, } from './issue-fix-ai.js';
+import { INSERT_LINK_FIX_TYPES, buildInsertLinkFingerprint } from './issue-fix-link-insert.js';
+import { getSeoOverrides, resolveSeoModuleSettings } from './config-store.js';
+export const ISSUE_FIX_FEATURE_KEY = 'ai.features.seoMetaGeneration';
+export const REDIRECT_FEATURE_KEY = 'ai.features.seo404Recovery';
+const AUTOPILOT_APPLIED_WINDOW_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * Count the autopilot changes that are live right now and landed in the last
+ * 7 days. Only `applied` counts — `verify_failed` rows were undone at apply
+ * time and reverted rows are no longer live. Degrades to 0 when the ledger
+ * model is absent or the count fails: this is a status strip, not a ledger.
+ */
+async function countAutopilotAppliedLast7d(db) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- optional-model guard
+    const d = db;
+    if (typeof d?.seoAutoApply?.count !== 'function')
+        return 0;
+    try {
+        const status = 'applied';
+        const n = await d.seoAutoApply.count({
+            where: { status, appliedAt: { gte: new Date(Date.now() - AUTOPILOT_APPLIED_WINDOW_MS) } },
+        });
+        return typeof n === 'number' && Number.isFinite(n) ? n : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+const SEVERITY_RANK = { critical: 0, warning: 1, info: 2 };
+function severityOf(value) {
+    return value === 'critical' || value === 'warning' || value === 'info' ? value : null;
+}
+function toDate(value) {
+    return value instanceof Date ? value : new Date(String(value));
+}
+/**
+ * Open/recurring issues (any fixability) plus the documents they reference, in
+ * two queries. "Reference" covers the issue entity AND, for cached insert-link
+ * fixes, the SOURCE document named by `pendingFix.patch.sourceEntityId` — that
+ * is the document the fix writes to and the one its fingerprint is built from,
+ * so without it `liveFingerprintFor` could never detect a stale link proposal.
+ */
+export async function loadOpenFixableIssuesWithDocs(db) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- optional-model guard
+    const d = db;
+    const issues = d?.seoIssue?.findMany
+        ? await d.seoIssue.findMany({
+            where: { status: { in: ['open', 'recurring'] } },
+            orderBy: { lastDetectedAt: 'desc' },
+            take: 500,
+        })
+        : [];
+    const docIds = new Set();
+    for (const issue of issues) {
+        if (typeof issue.entityId === 'string' && issue.entityId.length > 0) {
+            docIds.add(issue.entityId);
+        }
+        const sourceId = pendingFixFromMetadata(issue.metadata)?.patch.sourceEntityId;
+        if (typeof sourceId === 'string' && sourceId.length > 0)
+            docIds.add(sourceId);
+    }
+    const docsById = new Map();
+    if (docIds.size > 0 && d?.document?.findMany) {
+        const docs = (await d.document.findMany({
+            where: { id: { in: [...docIds] }, deletedAt: null },
+            select: { id: true, updatedAt: true, title: true, slug: true, collection: true },
+        }));
+        for (const doc of docs) {
+            docsById.set(String(doc.id), {
+                id: String(doc.id),
+                updatedAt: toDate(doc.updatedAt),
+                title: typeof doc.title === 'string' ? doc.title : null,
+                slug: typeof doc.slug === 'string' ? doc.slug : null,
+                collection: String(doc.collection ?? ''),
+            });
+        }
+    }
+    return { issues, docsById };
+}
+/**
+ * The fingerprint a fresh suggestion for this issue would carry right now.
+ * Insert-link fixes are fingerprinted on the SOURCE document (the one that
+ * gets written), so their live value needs the cache to know the source.
+ * `loadOpenFixableIssuesWithDocs` loads sources alongside entities; if one is
+ * still missing (deleted since generation) we fall back to the cached value
+ * rather than guessing.
+ */
+export function liveFingerprintFor(issue, cache, docsById) {
+    const entityId = typeof issue.entityId === 'string' ? issue.entityId : null;
+    if (!entityId)
+        return null;
+    if (cache &&
+        (INSERT_LINK_FIX_TYPES.has(issue.type) || cache.patch.fixStrategy === 'insert-link')) {
+        const sourceId = typeof cache.patch.sourceEntityId === 'string' ? cache.patch.sourceEntityId : null;
+        const source = sourceId ? docsById.get(sourceId) : undefined;
+        if (!source)
+            return cache.fingerprint;
+        return buildInsertLinkFingerprint(sourceId, typeof cache.patch.targetEntityId === 'string' ? cache.patch.targetEntityId : entityId, typeof cache.patch.anchorText === 'string' ? cache.patch.anchorText : '', source.updatedAt);
+    }
+    const doc = docsById.get(entityId);
+    if (!doc)
+        return null;
+    return buildFixFingerprint(entityId, issue.type, doc.updatedAt);
+}
+/**
+ * The marker `dismiss-fix` stores. After a dismissal there is no cache, so
+ * `selectEligibleForGeneration` compares the marker against the ENTITY-based
+ * live fingerprint. Insert-link caches are fingerprinted on the source
+ * document instead, so for them we store the entity-based value the no-cache
+ * path will compute; for every other type the cached fingerprint already is
+ * that value.
+ */
+export function dismissalFingerprintFor(issue, cache, entityUpdatedAt) {
+    const isInsertLink = INSERT_LINK_FIX_TYPES.has(issue.type) || cache.patch.fixStrategy === 'insert-link';
+    if (!isInsertLink || !entityUpdatedAt || typeof issue.entityId !== 'string') {
+        return cache.fingerprint;
+    }
+    return buildFixFingerprint(issue.entityId, issue.type, entityUpdatedAt);
+}
+/**
+ * Issues batch generation should attempt: fixable, open, document present,
+ * no LIVE cache (a stale one counts as none), and neither sticky marker
+ * equals the live fingerprint. Ordered critical → warning → info.
+ */
+export function selectEligibleForGeneration(issues, docsById) {
+    const out = [];
+    for (const issue of issues) {
+        if (issue.fixable !== true)
+            continue;
+        if (issue.status !== 'open' && issue.status !== 'recurring')
+            continue;
+        const cache = pendingFixFromMetadata(issue.metadata);
+        const live = liveFingerprintFor(issue, cache, docsById);
+        if (!live)
+            continue;
+        if (cache && cache.fingerprint === live)
+            continue;
+        const sticky = stickyFingerprintsFromMetadata(issue.metadata);
+        if (sticky.dismissed === live || sticky.generateSkipped === live)
+            continue;
+        out.push({ issue, liveFingerprint: live });
+    }
+    out.sort((a, b) => (SEVERITY_RANK[String(a.issue.severity)] ?? 99) -
+        (SEVERITY_RANK[String(b.issue.severity)] ?? 99));
+    return out;
+}
+function issueFixProposal(issue, cache, docsById) {
+    const live = liveFingerprintFor(issue, cache, docsById);
+    const doc = typeof issue.entityId === 'string' ? docsById.get(issue.entityId) : undefined;
+    return {
+        id: `issue:${issue.id}`,
+        kind: 'issue-fix',
+        title: String(issue.title ?? issue.type),
+        entity: {
+            type: typeof issue.entityType === 'string' ? issue.entityType : null,
+            id: typeof issue.entityId === 'string' ? issue.entityId : null,
+            title: (typeof issue.entityTitle === 'string' ? issue.entityTitle : null) ?? doc?.title ?? null,
+            url: typeof issue.url === 'string' ? issue.url : null,
+        },
+        changes: cache.changes,
+        justification: cache.justification,
+        source: cache.source,
+        confidence: null,
+        brandAlignment: cache.brandAlignment,
+        generatedAt: cache.generatedAt,
+        fingerprint: cache.fingerprint,
+        stale: live !== null && live !== cache.fingerprint,
+        issueType: String(issue.type),
+        severity: severityOf(issue.severity),
+        issueId: String(issue.id),
+        suggestionId: null,
+    };
+}
+function redirectProposal(s) {
+    const fromPath = String(s.fromPath ?? '');
+    const toPath = String(s.toPath ?? '');
+    return {
+        id: `redirect:${String(s.id)}`,
+        kind: 'redirect',
+        title: `Redirect ${fromPath} → ${toPath}`,
+        entity: { type: null, id: null, title: null, url: fromPath },
+        changes: [{ field: 'redirect', label: 'Redirect', before: fromPath, after: toPath }],
+        justification: typeof s.reason === 'string' ? s.reason : '',
+        source: 'ai-404-recovery',
+        // Stored as a 0-100 Int; the UI contract is a 0-1 fraction.
+        confidence: Number(s.confidence ?? 0) / 100,
+        brandAlignment: null,
+        generatedAt: s.createdAt ? toDate(s.createdAt).toISOString() : null,
+        fingerprint: null,
+        stale: false,
+        issueType: null,
+        severity: null,
+        issueId: null,
+        suggestionId: String(s.id),
+    };
+}
+export async function listSeoProposals(db) {
+    const { issues, docsById } = await loadOpenFixableIssuesWithDocs(db);
+    const fixes = [];
+    for (const issue of issues) {
+        const cache = pendingFixFromMetadata(issue.metadata);
+        if (!cache)
+            continue;
+        fixes.push(issueFixProposal(issue, cache, docsById));
+    }
+    fixes.sort((a, b) => {
+        const band = (SEVERITY_RANK[String(a.severity)] ?? 99) - (SEVERITY_RANK[String(b.severity)] ?? 99);
+        if (band !== 0)
+            return band;
+        return Number(a.stale) - Number(b.stale);
+    });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- optional-model guard
+    const d = db;
+    const redirectRows = d?.redirectSuggestion?.findMany
+        ? await d.redirectSuggestion.findMany({
+            where: { status: 'open' },
+            orderBy: { confidence: 'desc' },
+        })
+        : [];
+    // Sort defensively: the DB already orders by confidence, but the shape of the
+    // payload should not depend on that (fakes in tests do not honor orderBy).
+    const redirects = redirectRows
+        .map(redirectProposal)
+        .sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0));
+    const [issueGov, redirectGov, overrides, appliedLast7d] = await Promise.all([
+        getFeatureGovernance(db, ISSUE_FIX_FEATURE_KEY),
+        getFeatureGovernance(db, REDIRECT_FEATURE_KEY),
+        // `getSeoOverrides` already returns null on any read failure.
+        getSeoOverrides(db),
+        countAutopilotAppliedLast7d(db),
+    ]);
+    const settings = resolveSeoModuleSettings(overrides);
+    const stale = fixes.filter((p) => p.stale).length;
+    return {
+        proposals: [...fixes, ...redirects],
+        counts: {
+            issueFixes: fixes.length - stale,
+            redirects: redirects.length,
+            stale,
+            eligibleForGeneration: selectEligibleForGeneration(issues, docsById).length,
+        },
+        governance: {
+            issueFixBulk: issueGov.allowBulkApply,
+            redirectBulk: redirectGov.allowBulkApply,
+        },
+        autopilot: {
+            enabled: settings.autopilot.enabled,
+            pausedReason: settings.autopilot.pausedAt ? settings.autopilot.pausedReason : null,
+            lastRunAt: settings.autopilotLastRunAt,
+            appliedLast7d,
+        },
+    };
+}
+/**
+ * Cheap counts for the overview badge: every cached fix (stale ones are still
+ * rows in the inbox) + open redirect suggestions. Callers pass the open issues
+ * they already loaded so this adds at most one `count` query.
+ */
+export async function countPendingProposals(db, openIssues) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- optional-model guard
+    const d = db;
+    const redirects = d?.redirectSuggestion?.count
+        ? ((await d.redirectSuggestion.count({ where: { status: 'open' } })) ?? 0)
+        : 0;
+    const issueFixes = openIssues.filter((i) => pendingFixFromMetadata(i.metadata) !== null).length;
+    return { issueFixes, redirects };
+}
+//# sourceMappingURL=proposals.js.map

package/dist/seo/proposals.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prenta/core",
-  "version": "5.5.0",
+  "version": "5.7.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/prisma/migrations/0017_seo_auto_applies/migration.sql

@@ -0,0 +1,35 @@
+-- SEO Autopilot ledger (spec: 2026-09-07-auto-apply-policy-engine-design.md §4).
+-- One row per unattended write. Additive; no backfill.
+
+CREATE TABLE "prenta_seo_auto_applies" (
+    "id" TEXT NOT NULL,
+    "kind" TEXT NOT NULL,
+    "issueId" TEXT,
+    "issueType" TEXT NOT NULL,
+    "entityId" TEXT,
+    "collection" TEXT,
+    "path" TEXT,
+    "redirectId" TEXT,
+    "before" JSONB,
+    "after" JSONB NOT NULL,
+    "gate" JSONB NOT NULL,
+    "status" TEXT NOT NULL,
+    "outcome" TEXT NOT NULL DEFAULT 'pending',
+    "outcomeMetrics" JSONB,
+    "outcomeCheckedAt" TIMESTAMP(3),
+    "versionId" TEXT,
+    "appliedById" TEXT NOT NULL,
+    "appliedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "revertedAt" TIMESTAMP(3),
+    "revertedById" TEXT,
+    "revertReason" TEXT,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "prenta_seo_auto_applies_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "prenta_seo_auto_applies_status_appliedAt_idx" ON "prenta_seo_auto_applies"("status", "appliedAt");
+CREATE INDEX "prenta_seo_auto_applies_entityId_idx" ON "prenta_seo_auto_applies"("entityId");
+CREATE INDEX "prenta_seo_auto_applies_outcome_appliedAt_idx" ON "prenta_seo_auto_applies"("outcome", "appliedAt");
+CREATE INDEX "prenta_seo_auto_applies_issueId_idx" ON "prenta_seo_auto_applies"("issueId");

package/prisma/schema.prisma

@@ -640,6 +640,49 @@ model RedirectSuggestion {
   @@map("prenta_redirect_suggestions")
 }
 
+/// One row per change SEO Autopilot wrote (spec 2026-09-07-auto-apply-policy-engine §4).
+/// `before`/`after` hold the field-level diff for issue fixes, or the created
+/// redirect (after) for redirects. `before` is null for redirects: autopilot
+/// never overwrites an existing redirect. Rows are never deleted; revert flips `status`.
+model SeoAutoApply {
+  id               String    @id @default(cuid())
+  // 'issue-fix' | 'redirect'
+  kind             String
+  issueId          String?
+  // AutopilotIssueType
+  issueType        String
+  entityId         String?
+  collection       String?
+  // Public path at apply time — outcome-watch key into prenta_search_perf_daily.
+  path             String?
+  redirectId       String?
+  before           Json?
+  after            Json
+  // { source, brandAlignment, confidence, checks }
+  gate             Json
+  // 'applied' | 'verify_failed' | 'reverted' | 'outcome_reverted'
+  status           String
+  // 'pending' | 'held' | 'regressed' | 'insufficient_data' | 'skipped'
+  outcome          String    @default("pending")
+  outcomeMetrics   Json?
+  outcomeCheckedAt DateTime?
+  versionId        String?
+  appliedById      String
+  appliedAt        DateTime  @default(now())
+  revertedAt       DateTime?
+  revertedById     String?
+  // 'verify_failed' | 'outcome_regression' | 'manual'
+  revertReason     String?
+  createdAt        DateTime  @default(now())
+  updatedAt        DateTime  @updatedAt
+
+  @@index([status, appliedAt])
+  @@index([entityId])
+  @@index([outcome, appliedAt])
+  @@index([issueId])
+  @@map("prenta_seo_auto_applies")
+}
+
 // A versioned snapshot of a form's field schema. Saving a form's schema in
 // the admin creates a new row here; submissions reference the version they
 // were captured against so historical entries always render with the fields