@prenta/core 0.118.0

package/dist/redirects/recovery.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Unified 404 redirect recovery — legitimacy gate + heuristic matching.
+ * Used by the Redirects tab generator and the SEO audit pipeline.
+ */
+import { type SuggestCandidate } from './suggest.js';
+import type { safeFetch } from '../security/safe-fetch.js';
+export interface BrokenLinkRef {
+    url: string;
+}
+export interface RecoveryPathSignals {
+    hasInternalLink: boolean;
+    hitCount: number;
+}
+export interface RecoveryPlan {
+    fromPath: string;
+    toPath: string;
+    confidence: number;
+    reason: string;
+    legitimacyScore: number;
+    legitimacyReasons: string[];
+    matchSource?: 'heuristic' | 'semantic';
+    autoApplied?: boolean;
+}
+export interface RecoveryPlanOptions {
+    candidates: SuggestCandidate[];
+    pathPrefixes?: string[];
+    /** Minimum match confidence (0–100). Default 30. */
+    minConfidence?: number;
+    siteUrl?: string;
+    enableAiRerank?: boolean;
+    autoApply?: boolean;
+    autoApplyMinConfidence?: number;
+    semanticRerank?: import('./rerank.js').SemanticRerankFn | null;
+    /** Test seam for live source-URL probes. */
+    fetchFn?: typeof safeFetch;
+}
+/** Merge 404 hit paths and audit broken-link hrefs into one deduped map. */
+export declare function collectRecoveryPaths(hits: Array<{
+    path: string;
+    hits?: number;
+}>, brokenLinks: BrokenLinkRef[], siteUrl?: string): Map<string, RecoveryPathSignals>;
+/** Plan a single recovery redirect, or null when illegitimate / no match. */
+export declare function planRecoveryRedirect(fromPath: string, signals: RecoveryPathSignals, options: RecoveryPlanOptions): Promise<RecoveryPlan | null>;
+/** Plan recovery redirects for all collected paths. */
+export declare function planRecoveryRedirects(pathMap: Map<string, RecoveryPathSignals>, options: RecoveryPlanOptions): Promise<RecoveryPlan[]>;
+type RecoveryHitRow = {
+    path: string;
+    hits?: number;
+};
+type RecoverySuggestionDb = {
+    redirect404Hit?: {
+        findMany: (args: unknown) => Promise<RecoveryHitRow[]>;
+        updateMany?: (args: unknown) => Promise<unknown>;
+    };
+    redirect?: {
+        upsert: (args: unknown) => Promise<unknown>;
+        findMany?: (args: unknown) => Promise<unknown[]>;
+    };
+    redirectSuggestion?: {
+        findFirst: (args: unknown) => Promise<{
+            id: string;
+        } | null>;
+        create: (args: unknown) => Promise<unknown>;
+    };
+};
+/** Create a 301 redirect from a recovery plan (shared by auto-apply and audit fixes). */
+export declare function createRecoveryRedirect(db: RecoverySuggestionDb, plan: Pick<RecoveryPlan, 'fromPath' | 'toPath'>, userId?: string, options?: {
+    siteUrl?: string;
+    fetchFn?: typeof safeFetch;
+}): Promise<void>;
+/** Persist open redirect suggestions; skips paths that already have one. */
+export declare function upsertRedirectSuggestions(db: RecoverySuggestionDb, plans: RecoveryPlan[]): Promise<number>;
+/** Full pipeline: collect paths, plan matches, persist suggestions. */
+export declare function generateRecoverySuggestions(db: RecoverySuggestionDb, options: {
+    candidates: SuggestCandidate[];
+    pathPrefixes?: string[];
+    brokenLinks?: BrokenLinkRef[];
+    include404Hits?: boolean;
+    siteUrl?: string;
+    enableAiRerank?: boolean;
+    autoApply?: boolean;
+    autoApplyMinConfidence?: number;
+    autoApplyUserId?: string;
+    semanticRerank?: import('./rerank.js').SemanticRerankFn | null;
+    fetchFn?: typeof safeFetch;
+}): Promise<{
+    created: number;
+    planned: number;
+    autoApplied: number;
+}>;
+export {};
+//# sourceMappingURL=recovery.d.ts.map

package/dist/redirects/recovery.d.ts.map

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

package/dist/redirects/recovery.js

@@ -0,0 +1,210 @@
+/**
+ * Unified 404 redirect recovery — legitimacy gate + heuristic matching.
+ * Used by the Redirects tab generator and the SEO audit pipeline.
+ */
+import { normalizeRedirectPath } from './graph.js';
+import { scorePathLegitimacy } from './legitimacy.js';
+import { resolveRedirectMatch } from './rerank.js';
+import { validateRedirectDestination } from './validate-destination.js';
+import { filterConfirmedDeadRecoveryPaths, probeSitePathStatus, } from '../seo/confirm-broken-links.js';
+import { isConfirmedDeadLinkStatus } from '../seo/link-probe.js';
+function normalizeBrokenHref(href, siteUrl) {
+    const trimmed = href.trim();
+    if (!trimmed ||
+        trimmed.startsWith('#') ||
+        trimmed.startsWith('mailto:') ||
+        trimmed.startsWith('tel:')) {
+        return null;
+    }
+    if (/^https?:\/\//i.test(trimmed)) {
+        const base = siteUrl.replace(/\/+$/, '').toLowerCase();
+        if (!base || !trimmed.toLowerCase().startsWith(base))
+            return null;
+        return normalizeRedirectPath(trimmed.slice(base.length) || '/');
+    }
+    return normalizeRedirectPath(trimmed);
+}
+/** Merge 404 hit paths and audit broken-link hrefs into one deduped map. */
+export function collectRecoveryPaths(hits, brokenLinks, siteUrl = '') {
+    const map = new Map();
+    for (const hit of hits) {
+        const path = normalizeRedirectPath(hit.path);
+        if (!path || path === '/')
+            continue;
+        const prev = map.get(path) ?? { hasInternalLink: false, hitCount: 0 };
+        prev.hitCount = Math.max(prev.hitCount, Number(hit.hits ?? 0));
+        map.set(path, prev);
+    }
+    for (const link of brokenLinks) {
+        const path = normalizeBrokenHref(link.url, siteUrl);
+        if (!path || path === '/')
+            continue;
+        const prev = map.get(path) ?? { hasInternalLink: false, hitCount: 0 };
+        prev.hasInternalLink = true;
+        map.set(path, prev);
+    }
+    return map;
+}
+/** Plan a single recovery redirect, or null when illegitimate / no match. */
+export async function planRecoveryRedirect(fromPath, signals, options) {
+    const path = normalizeRedirectPath(fromPath);
+    if (!path || path === '/')
+        return null;
+    const legitimacy = scorePathLegitimacy(path, {
+        hasInternalLink: signals.hasInternalLink,
+        hitCount: signals.hitCount,
+        pathPrefixes: options.pathPrefixes,
+    });
+    if (!legitimacy.legitimate)
+        return null;
+    const match = await resolveRedirectMatch(path, options.candidates, {
+        minConfidence: options.minConfidence ?? 30,
+        enableAiRerank: options.enableAiRerank,
+        semanticRerank: options.semanticRerank,
+    });
+    if (!match)
+        return null;
+    return {
+        fromPath: path,
+        toPath: match.toPath,
+        confidence: match.confidence,
+        reason: match.reason,
+        legitimacyScore: legitimacy.score,
+        legitimacyReasons: legitimacy.reasons,
+        matchSource: match.matchSource,
+    };
+}
+/** Plan recovery redirects for all collected paths. */
+export async function planRecoveryRedirects(pathMap, options) {
+    const plans = [];
+    for (const [path, signals] of pathMap) {
+        const plan = await planRecoveryRedirect(path, signals, options);
+        if (plan)
+            plans.push(plan);
+    }
+    return plans;
+}
+/** Create a 301 redirect from a recovery plan (shared by auto-apply and audit fixes). */
+export async function createRecoveryRedirect(db, plan, userId, options = {}) {
+    if (!db.redirect?.upsert)
+        return;
+    const destErr = validateRedirectDestination(plan.toPath, 301);
+    if (destErr) {
+        throw new Error(`Recovery redirect rejected: ${destErr}`);
+    }
+    // Hard guard: never write a recovery redirect for a source that is live.
+    const siteUrl = options.siteUrl?.replace(/\/+$/, '');
+    if (siteUrl) {
+        const status = await probeSitePathStatus(siteUrl, plan.fromPath, {
+            fetchFn: options.fetchFn,
+        });
+        if (!isConfirmedDeadLinkStatus(status)) {
+            throw new Error(`Recovery redirect rejected: source ${plan.fromPath} is not a confirmed dead URL (HTTP ${status || 'unreachable'})`);
+        }
+    }
+    await db.redirect.upsert({
+        where: { source: plan.fromPath },
+        create: {
+            source: plan.fromPath,
+            destination: plan.toPath,
+            statusCode: 301,
+            enabled: true,
+            source_kind: 'ai-404-recovery',
+            createdById: userId || undefined,
+        },
+        update: {
+            destination: plan.toPath,
+            statusCode: 301,
+            enabled: true,
+            source_kind: 'ai-404-recovery',
+        },
+    });
+    if (db.redirect404Hit?.updateMany) {
+        await db.redirect404Hit
+            .updateMany({
+            where: { path: plan.fromPath },
+            data: { resolvedAt: new Date() },
+        })
+            .catch(() => { });
+    }
+}
+/** Persist open redirect suggestions; skips paths that already have one. */
+export async function upsertRedirectSuggestions(db, plans) {
+    if (!db.redirectSuggestion?.create)
+        return 0;
+    let created = 0;
+    for (const plan of plans) {
+        const existing = await db.redirectSuggestion.findFirst({
+            where: { fromPath: plan.fromPath, status: 'open' },
+        });
+        if (existing)
+            continue;
+        await db.redirectSuggestion.create({
+            data: {
+                fromPath: plan.fromPath,
+                toPath: plan.toPath,
+                confidence: Math.round(plan.confidence),
+                reason: plan.reason,
+                status: 'open',
+                source: 'ai-404-recovery',
+                metadata: {
+                    legitimacyScore: plan.legitimacyScore,
+                    legitimacyReasons: plan.legitimacyReasons,
+                    ...(plan.matchSource ? { matchSource: plan.matchSource } : {}),
+                },
+            },
+        });
+        created++;
+    }
+    return created;
+}
+/** Full pipeline: collect paths, plan matches, persist suggestions. */
+export async function generateRecoverySuggestions(db, options) {
+    const hits = options.include404Hits !== false && db.redirect404Hit?.findMany
+        ? await db.redirect404Hit.findMany({ where: { resolvedAt: null }, take: 5000 })
+        : [];
+    const pathMap = collectRecoveryPaths(hits, options.brokenLinks ?? [], options.siteUrl ?? '');
+    // Drop sources that still return 2xx/3xx on the live site — never suggest or
+    // auto-apply a redirect that would take a working page offline (#706).
+    const siteUrl = options.siteUrl?.replace(/\/+$/, '');
+    if (siteUrl && pathMap.size > 0) {
+        const dead = await filterConfirmedDeadRecoveryPaths([...pathMap.keys()], siteUrl, {
+            fetchFn: options.fetchFn,
+        });
+        for (const path of [...pathMap.keys()]) {
+            if (!dead.has(path))
+                pathMap.delete(path);
+        }
+    }
+    const plans = await planRecoveryRedirects(pathMap, {
+        candidates: options.candidates,
+        pathPrefixes: options.pathPrefixes,
+        enableAiRerank: options.enableAiRerank,
+        semanticRerank: options.semanticRerank,
+        siteUrl,
+        fetchFn: options.fetchFn,
+    });
+    const autoMin = options.autoApplyMinConfidence ?? 85;
+    let created = 0;
+    let autoApplied = 0;
+    const pending = [];
+    for (const plan of plans) {
+        if (options.autoApply && plan.confidence >= autoMin) {
+            try {
+                await createRecoveryRedirect(db, plan, options.autoApplyUserId, {
+                    siteUrl,
+                    fetchFn: options.fetchFn,
+                });
+                autoApplied++;
+            }
+            catch {
+                // Live guard rejected (source became healthy) — fall through to suggestion skip.
+            }
+            continue;
+        }
+        pending.push(plan);
+    }
+    created = await upsertRedirectSuggestions(db, pending);
+    return { created, planned: plans.length, autoApplied };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/redirects/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/redirects/recovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA;AACvE,OAAO,EACL,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAqChE,SAAS,mBAAmB,CAAC,IAAY,EAAE,OAAe;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IACE,CAAC,OAAO;QACR,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QACvB,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;QAC7B,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAC1B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;QACtD,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QACjE,OAAO,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAA;AACvC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAClC,IAA4C,EAC5C,WAA4B,EAC5B,OAAO,GAAG,EAAE;IAEZ,MAAM,GAAG,GAAG,IAAI,GAAG,EAA+B,CAAA;IAElD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG;YAAE,SAAQ;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;QACrE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;QAC9D,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnD,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG;YAAE,SAAQ;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;QACrE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAA;QAC3B,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrB,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAgB,EAChB,OAA4B,EAC5B,OAA4B;IAE5B,MAAM,IAAI,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAC5C,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAEtC,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,EAAE;QAC3C,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAA;IACF,IAAI,CAAC,UAAU,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAEvC,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE;QACjE,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;QAC1C,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAA;IACF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IAEvB,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,eAAe,EAAE,UAAU,CAAC,KAAK;QACjC,iBAAiB,EAAE,UAAU,CAAC,OAAO;QACrC,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAA;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAyC,EACzC,OAA4B;IAE5B,MAAM,KAAK,GAAmB,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAC/D,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAkBD,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,EAAwB,EACxB,IAA+C,EAC/C,MAAe,EACf,UAA4D,EAAE;IAE9D,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM;QAAE,OAAM;IAChC,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,yEAAyE;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACpD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE;YAC/D,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;QACF,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,sCAAsC,IAAI,CAAC,QAAQ,sCAAsC,MAAM,IAAI,aAAa,GAAG,CACpH,CAAA;QACH,CAAC;IACH,CAAC;IACD,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QACvB,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE;QAChC,MAAM,EAAE;YACN,MAAM,EAAE,IAAI,CAAC,QAAQ;YACrB,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EAAE,MAAM,IAAI,SAAS;SACjC;QACD,MAAM,EAAE;YACN,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,iBAAiB;SAC/B;KACF,CAAC,CAAA;IACF,IAAI,EAAE,CAAC,cAAc,EAAE,UAAU,EAAE,CAAC;QAClC,MAAM,EAAE,CAAC,cAAc;aACpB,UAAU,CAAC;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;YAC9B,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE;SACjC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACpB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,EAAwB,EACxB,KAAqB;IAErB,IAAI,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM;QAAE,OAAO,CAAC,CAAA;IAC5C,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC;YACrD,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;SACnD,CAAC,CAAA;QACF,IAAI,QAAQ;YAAE,SAAQ;QACtB,MAAM,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC;YACjC,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;gBACvC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,iBAAiB;gBACzB,QAAQ,EAAE;oBACR,eAAe,EAAE,IAAI,CAAC,eAAe;oBACrC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;oBACzC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/D;aACF;SACF,CAAC,CAAA;QACF,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,EAAwB,EACxB,OAYC;IAED,MAAM,IAAI,GACR,OAAO,CAAC,cAAc,KAAK,KAAK,IAAI,EAAE,CAAC,cAAc,EAAE,QAAQ;QAC7D,CAAC,CAAC,MAAM,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/E,CAAC,CAAC,EAAE,CAAA;IAER,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;IAE5F,6EAA6E;IAC7E,uEAAuE;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACpD,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,gCAAgC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE;YAChF,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;QACF,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE;QACjD,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,sBAAsB,IAAI,EAAE,CAAA;IACpD,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,MAAM,OAAO,GAAmB,EAAE,CAAA;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,OAAO,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,sBAAsB,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE;oBAC9D,OAAO;oBACP,OAAO,EAAE,OAAO,CAAC,OAAO;iBACzB,CAAC,CAAA;gBACF,WAAW,EAAE,CAAA;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,iFAAiF;YACnF,CAAC;YACD,SAAQ;QACV,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IAED,OAAO,GAAG,MAAM,yBAAyB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACtD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,CAAA;AACxD,CAAC"}

package/dist/redirects/rerank.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AI semantic re-ranking for ambiguous redirect matches (40–84% heuristic).
+ * Constrained to published candidate URLs only — the model never invents paths.
+ */
+import { type RedirectSuggestionResult, type SuggestCandidate } from './suggest.js';
+export type RedirectMatchSource = 'heuristic' | 'semantic';
+export type RedirectMatchResult = RedirectSuggestionResult & {
+    matchSource: RedirectMatchSource;
+};
+export interface ResolveRedirectMatchOptions {
+    minConfidence?: number;
+    /** Run semantic re-rank for heuristic scores in [ambiguousLow, ambiguousHigh]. */
+    enableAiRerank?: boolean;
+    ambiguousLow?: number;
+    ambiguousHigh?: number;
+    /** Injected semantic ranker (for tests). When omitted, loads plugin-ai dynamically. */
+    semanticRerank?: SemanticRerankFn | null;
+}
+export type SemanticRerankFn = (fromPath: string, shortlist: SuggestCandidate[]) => Promise<RedirectSuggestionResult | null>;
+/**
+ * Resolve the best redirect target — heuristic first, semantic re-rank when ambiguous.
+ */
+export declare function resolveRedirectMatch(fromPath: string, candidates: SuggestCandidate[], options?: ResolveRedirectMatchOptions): Promise<RedirectMatchResult | null>;
+//# sourceMappingURL=rerank.d.ts.map

package/dist/redirects/rerank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerank.d.ts","sourceRoot":"","sources":["../../src/redirects/rerank.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAA;AAErB,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,CAAA;AAE1D,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,GAAG;IAC3D,WAAW,EAAE,mBAAmB,CAAA;CACjC,CAAA;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kFAAkF;IAClF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uFAAuF;IACvF,cAAc,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACzC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,EAAE,KAC1B,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAA;AA6D7C;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAuCrC"}

package/dist/redirects/rerank.js

@@ -0,0 +1,82 @@
+/**
+ * AI semantic re-ranking for ambiguous redirect matches (40–84% heuristic).
+ * Constrained to published candidate URLs only — the model never invents paths.
+ */
+import { rankRedirectCandidates, suggestRedirectTarget, } from './suggest.js';
+const CLEAR_MATCH = 85;
+async function loadSemanticRerank() {
+    try {
+        const mod = '@prenta/' + 'plugin-ai';
+        const ai = (await import(mod));
+        if (typeof ai.semanticSearch !== 'function')
+            return null;
+        return async (fromPath, shortlist) => {
+            if (shortlist.length === 0)
+                return null;
+            const query = `Best replacement page for broken URL path: ${fromPath}`;
+            const corpus = shortlist.map((c) => ({
+                id: c.url,
+                collectionSlug: 'content',
+                title: c.title ?? c.url,
+                content: `${c.title ?? ''} ${c.url}`.trim(),
+            }));
+            const results = await ai.semanticSearch(query, {
+                corpus,
+                limit: 3,
+                threshold: 0.42,
+            });
+            const top = results[0];
+            if (!top)
+                return null;
+            const matched = shortlist.find((c) => c.url === top.id);
+            if (!matched)
+                return null;
+            const confidence = Math.round(Math.min(1, Math.max(0, top.score)) * 100);
+            return {
+                toPath: matched.url,
+                confidence,
+                reason: `Semantic match to "${matched.title ?? matched.url}"`,
+            };
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function withSource(match, matchSource) {
+    return { ...match, matchSource };
+}
+/**
+ * Resolve the best redirect target — heuristic first, semantic re-rank when ambiguous.
+ */
+export async function resolveRedirectMatch(fromPath, candidates, options = {}) {
+    const minConfidence = options.minConfidence ?? 30;
+    const ambiguousLow = options.ambiguousLow ?? 40;
+    const ambiguousHigh = options.ambiguousHigh ?? 84;
+    const heuristic = suggestRedirectTarget(fromPath, candidates, minConfidence);
+    const needsRerank = options.enableAiRerank !== false &&
+        (!heuristic || (heuristic.confidence >= ambiguousLow && heuristic.confidence <= ambiguousHigh));
+    if (!needsRerank) {
+        return heuristic ? withSource(heuristic, 'heuristic') : null;
+    }
+    if (heuristic && heuristic.confidence >= CLEAR_MATCH) {
+        return withSource(heuristic, 'heuristic');
+    }
+    const rerank = options.semanticRerank ?? (await loadSemanticRerank());
+    if (!rerank) {
+        return heuristic ? withSource(heuristic, 'heuristic') : null;
+    }
+    const ranked = rankRedirectCandidates(fromPath, candidates, 8);
+    const shortlist = ranked.map((r) => {
+        const c = candidates.find((x) => x.url === r.toPath);
+        return { url: r.toPath, title: c?.title };
+    });
+    const semantic = await rerank(fromPath, shortlist).catch(() => null);
+    if (semantic && semantic.confidence >= minConfidence) {
+        if (!heuristic || semantic.confidence >= heuristic.confidence) {
+            return withSource(semantic, 'semantic');
+        }
+    }
+    return heuristic ? withSource(heuristic, 'heuristic') : null;
+}
+//# sourceMappingURL=rerank.js.map

package/dist/redirects/rerank.js.map

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

package/dist/redirects/suggest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 404 recovery suggestions — pure heuristic matching of a dead path to the
+ * best live URL using path-segment + title token similarity. Used as the
+ * always-available baseline; the API can layer AI ranking on top when a
+ * provider is configured.
+ */
+export interface SuggestCandidate {
+    url: string;
+    title?: string;
+}
+export interface RedirectSuggestionResult {
+    toPath: string;
+    confidence: number;
+    reason: string;
+}
+/**
+ * Suggest the best redirect target for a dead `fromPath`. Returns null when no
+ * candidate clears the minimum confidence threshold (default 30).
+ */
+export declare function suggestRedirectTarget(fromPath: string, candidates: SuggestCandidate[], minConfidence?: number): RedirectSuggestionResult | null;
+/** Rank all candidates by path/title similarity (for AI re-ranking shortlists). */
+export declare function rankRedirectCandidates(fromPath: string, candidates: SuggestCandidate[], limit?: number): RedirectSuggestionResult[];
+//# sourceMappingURL=suggest.d.ts.map

package/dist/redirects/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/redirects/suggest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACf;AAmBD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,aAAa,SAAK,GACjB,wBAAwB,GAAG,IAAI,CA0BjC;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,KAAK,SAAI,GACR,wBAAwB,EAAE,CAwB5B"}

package/dist/redirects/suggest.js

@@ -0,0 +1,80 @@
+/**
+ * 404 recovery suggestions — pure heuristic matching of a dead path to the
+ * best live URL using path-segment + title token similarity. Used as the
+ * always-available baseline; the API can layer AI ranking on top when a
+ * provider is configured.
+ */
+function tokens(input) {
+    return input
+        .toLowerCase()
+        .replace(/^https?:\/\/[^/]+/i, '')
+        .replace(/[^a-z0-9]+/g, ' ')
+        .split(/\s+/)
+        .filter((t) => t.length > 1);
+}
+function jaccard(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 0;
+    let inter = 0;
+    for (const x of a)
+        if (b.has(x))
+            inter++;
+    const union = a.size + b.size - inter;
+    return union === 0 ? 0 : inter / union;
+}
+/**
+ * Suggest the best redirect target for a dead `fromPath`. Returns null when no
+ * candidate clears the minimum confidence threshold (default 30).
+ */
+export function suggestRedirectTarget(fromPath, candidates, minConfidence = 30) {
+    const fromTokens = new Set(tokens(fromPath));
+    if (fromTokens.size === 0 || candidates.length === 0)
+        return null;
+    let best = null;
+    for (const c of candidates) {
+        const pathTokens = new Set(tokens(c.url));
+        const titleTokens = new Set(tokens(c.title ?? ''));
+        const pathSim = jaccard(fromTokens, pathTokens);
+        const titleSim = jaccard(fromTokens, titleTokens);
+        // Path match weighted higher than title match.
+        const score = Math.round((pathSim * 0.7 + titleSim * 0.3) * 100);
+        if (!best || score > best.confidence) {
+            best = {
+                toPath: c.url,
+                confidence: score,
+                reason: pathSim >= titleSim
+                    ? `URL path similarity to ${c.url}`
+                    : `Title similarity to "${c.title ?? c.url}"`,
+            };
+        }
+    }
+    if (!best || best.confidence < minConfidence)
+        return null;
+    return best;
+}
+/** Rank all candidates by path/title similarity (for AI re-ranking shortlists). */
+export function rankRedirectCandidates(fromPath, candidates, limit = 5) {
+    const fromTokens = new Set(tokens(fromPath));
+    if (fromTokens.size === 0 || candidates.length === 0)
+        return [];
+    const scored = [];
+    for (const c of candidates) {
+        const pathTokens = new Set(tokens(c.url));
+        const titleTokens = new Set(tokens(c.title ?? ''));
+        const pathSim = jaccard(fromTokens, pathTokens);
+        const titleSim = jaccard(fromTokens, titleTokens);
+        const confidence = Math.round((pathSim * 0.7 + titleSim * 0.3) * 100);
+        if (confidence <= 0)
+            continue;
+        scored.push({
+            toPath: c.url,
+            confidence,
+            reason: pathSim >= titleSim
+                ? `URL path similarity to ${c.url}`
+                : `Title similarity to "${c.title ?? c.url}"`,
+        });
+    }
+    scored.sort((a, b) => b.confidence - a.confidence);
+    return scored.slice(0, limit);
+}
+//# sourceMappingURL=suggest.js.map

package/dist/redirects/suggest.js.map

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

package/dist/redirects/typo.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Detect editor typos vs slug migrations — typos should fix the source link,
+ * migrations should get a redirect.
+ */
+/**
+ * True when paths differ by a small edit — likely a typo in content, not a
+ * retired URL that needs a site-wide 301.
+ */
+export declare function isLikelyEditorTypo(fromPath: string, toPath: string): boolean;
+//# sourceMappingURL=typo.d.ts.map

package/dist/redirects/typo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typo.d.ts","sourceRoot":"","sources":["../../src/redirects/typo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAmB5E"}

package/dist/redirects/typo.js

@@ -0,0 +1,51 @@
+/**
+ * Detect editor typos vs slug migrations — typos should fix the source link,
+ * migrations should get a redirect.
+ */
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const row = new Array(b.length + 1);
+    for (let j = 0; j <= b.length; j++)
+        row[j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        let prev = row[0];
+        row[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const tmp = row[j];
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + cost);
+            prev = tmp;
+        }
+    }
+    return row[b.length];
+}
+function segments(path) {
+    return path.split('/').filter(Boolean);
+}
+/**
+ * True when paths differ by a small edit — likely a typo in content, not a
+ * retired URL that needs a site-wide 301.
+ */
+export function isLikelyEditorTypo(fromPath, toPath) {
+    if (!fromPath || !toPath || fromPath === toPath)
+        return false;
+    const fromSegs = segments(fromPath);
+    const toSegs = segments(toPath);
+    if (fromSegs.length === toSegs.length && fromSegs.length > 0) {
+        const samePrefix = fromSegs.slice(0, -1).join('/') === toSegs.slice(0, -1).join('/') || fromSegs.length === 1;
+        if (samePrefix) {
+            const lastFrom = fromSegs.at(-1) ?? '';
+            const lastTo = toSegs.at(-1) ?? '';
+            const dist = levenshtein(lastFrom, lastTo);
+            return dist > 0 && dist <= 3;
+        }
+    }
+    const fullDist = levenshtein(fromPath.replace(/^\//, ''), toPath.replace(/^\//, ''));
+    return fullDist > 0 && fullDist <= 4;
+}
+//# sourceMappingURL=typo.js.map

package/dist/redirects/typo.js.map

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

package/dist/redirects/validate-destination.d.ts

@@ -0,0 +1,13 @@
+export interface RedirectDestinationValidationOptions {
+    /** When set, used instead of `NEXT_PUBLIC_SITE_URL` for allowlist checks. */
+    siteUrl?: string | null;
+}
+/**
+ * Open-redirect defence for redirect destinations.
+ *
+ * - Relative paths must start with `/` but NOT `//` (protocol-relative URLs).
+ * - Absolute URLs must use http/https and point at an allowlisted host.
+ * - 410 Gone responses skip destination validation (destination is informational).
+ */
+export declare function validateRedirectDestination(destination: string, statusCode: number, options?: RedirectDestinationValidationOptions): string | null;
+//# sourceMappingURL=validate-destination.d.ts.map

package/dist/redirects/validate-destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-destination.d.ts","sourceRoot":"","sources":["../../src/redirects/validate-destination.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oCAAoC;IACnD,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,oCAAoC,GAC7C,MAAM,GAAG,IAAI,CA4Cf"}