@prenta/core 5.5.0 → 5.7.0

package/dist/seo/autopilot-gate.js

@@ -0,0 +1,272 @@
+import { META_DESC_MAX, META_TITLE_MAX } from './issue-fix.js';
+import { AUTOPILOT_DESC_MIN, } from './autopilot-policy.js';
+import { ISSUE_FIX_FEATURE_KEY, REDIRECT_FEATURE_KEY } from './proposals.js';
+export function featureKeyFor(kind) {
+    switch (kind) {
+        case 'issue-fix':
+            return ISSUE_FIX_FEATURE_KEY;
+        case 'redirect':
+            return REDIRECT_FEATURE_KEY;
+        default: {
+            const _exhaustive = kind;
+            return _exhaustive;
+        }
+    }
+}
+export function normalizeDuplicateValue(value) {
+    if (typeof value !== 'string')
+        return null;
+    const v = value.trim().replace(/\s+/g, ' ').toLowerCase();
+    return v.length > 0 ? v : null;
+}
+/**
+ * Build the duplicate index from one row per entity.
+ *
+ * `rows[].metaTitle` MUST be the RENDERED meta title — the same form the AI title fixer puts in
+ * `changes[].after` (raw title through the site title template). The orchestrator renders each
+ * document's stored title with the site template before indexing. `rows[].metaDescription` is
+ * used as stored (no template applies).
+ */
+export function buildDuplicateIndex(rows) {
+    const titles = new Map();
+    const descriptions = new Map();
+    const add = (map, raw, id) => {
+        const key = normalizeDuplicateValue(raw);
+        if (!key)
+            return;
+        const set = map.get(key) ?? new Set();
+        set.add(id);
+        map.set(key, set);
+    };
+    for (const r of rows) {
+        add(titles, r.metaTitle, r.entityId);
+        add(descriptions, r.metaDescription, r.entityId);
+    }
+    return { titles, descriptions };
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Word-boundary, case-insensitive — the fixer's matcher, not the scorer's substring one.
+ *
+ * Boundaries are Unicode-aware lookarounds rather than `\b`: `\b` only exists between a `\w`
+ * and a non-`\w` character, so a term with a non-word edge (`#1`, `100%`, `24/7`) would never
+ * match at string start / after a space (fail-open), and ASCII `\w` treats `é` as a boundary so
+ * `café` would hit inside `cafés` (false block).
+ */
+export function bannedTermHits(text, terms) {
+    const hits = [];
+    for (const banned of terms) {
+        const term = banned.term.trim();
+        if (!term)
+            continue;
+        const re = new RegExp(String.raw `(?<![\p{L}\p{N}_])${escapeRegExp(term)}(?![\p{L}\p{N}_])`, 'iu');
+        if (re.test(text))
+            hits.push(term);
+    }
+    return hits;
+}
+const CHANNEL_SCORABLE_FIELDS = new Set(['metaDescription', 'ogDescription']);
+const TITLE_FIELDS = new Set(['metaTitle']);
+const DESC_FIELDS = new Set(['metaDescription', 'ogDescription']);
+const CANONICAL_FIELDS = new Set(['canonicalUrl', 'canonical']);
+const STRUCTURED_FIELDS = new Set(['structuredData']);
+function validatorFailure(field, after) {
+    if (TITLE_FIELDS.has(field)) {
+        // `after` is the RENDERED title (see DuplicateIndex.titles), so this validates the rendered
+        // length — what actually appears in the SERP — not the raw stored title.
+        const len = typeof after === 'string' ? after.trim().length : 0;
+        if (len < 1 || len > META_TITLE_MAX)
+            return `${field} length ${len} not in 1..${META_TITLE_MAX}`;
+        return null;
+    }
+    if (DESC_FIELDS.has(field)) {
+        const len = typeof after === 'string' ? after.trim().length : 0;
+        if (len < AUTOPILOT_DESC_MIN || len > META_DESC_MAX) {
+            return `${field} length ${len} not in ${AUTOPILOT_DESC_MIN}..${META_DESC_MAX}`;
+        }
+        return null;
+    }
+    if (CANONICAL_FIELDS.has(field)) {
+        if (typeof after !== 'string')
+            return `${field} is not an absolute http(s) URL`;
+        try {
+            const u = new URL(after);
+            if (u.protocol !== 'http:' && u.protocol !== 'https:')
+                return `${field} is not an absolute http(s) URL`;
+        }
+        catch {
+            return `${field} is not an absolute http(s) URL`;
+        }
+        return null;
+    }
+    if (STRUCTURED_FIELDS.has(field)) {
+        let parsed = after;
+        if (typeof after === 'string') {
+            try {
+                parsed = JSON.parse(after);
+            }
+            catch {
+                return `${field} is not valid JSON`;
+            }
+        }
+        const rec = parsed && typeof parsed === 'object' ? parsed : null;
+        if (!rec || typeof rec['@type'] !== 'string')
+            return `${field} has no @type`;
+        return null;
+    }
+    return null;
+}
+function passesPolicy(c, ctx) {
+    const p = ctx.policy;
+    if (!p.enabled)
+        return { pass: false, reason: 'policy_disabled' };
+    if (p.pausedAt)
+        return { pass: false, reason: 'policy_paused' };
+    if (p.types[c.issueTypeKey] !== true)
+        return { pass: false, reason: 'type_not_enabled' };
+    const pausedDetail = p.pausedTypes[c.issueTypeKey];
+    if (typeof pausedDetail === 'string')
+        return { pass: false, reason: 'type_paused', detail: pausedDetail };
+    return null;
+}
+function passesGovernance(c, ctx) {
+    const gov = ctx.governance[c.featureKey] ?? {
+        approvalRequired: true,
+        allowBulkApply: false,
+        maxRequestsPerDay: undefined,
+    };
+    if (gov.approvalRequired)
+        return { pass: false, reason: 'governance_approval_required' };
+    const applied = ctx.featureApplied[c.featureKey] ?? 0;
+    // Quota for a non-bulk feature is 1 per run: the first passes, the rest fail. Deliberately
+    // NOT conditioned on `featureCandidates` — a missing/mis-keyed count must not disable the quota.
+    if (!gov.allowBulkApply && applied >= 1) {
+        return { pass: false, reason: 'governance_bulk_not_allowed' };
+    }
+    return null;
+}
+export function evaluateAutopilotGate(c, ctx) {
+    const policyFail = passesPolicy(c, ctx);
+    if (policyFail)
+        return policyFail;
+    const govFail = passesGovernance(c, ctx);
+    if (govFail)
+        return govFail;
+    if (ctx.appliedThisRun >= ctx.policy.maxPerRun)
+        return { pass: false, reason: 'cap_per_run' };
+    if (ctx.appliedToday >= ctx.policy.maxPerDay)
+        return { pass: false, reason: 'cap_per_day' };
+    if (c.stale)
+        return { pass: false, reason: 'stale' };
+    // An editor rejected this proposal for the current document state: it waits in the inbox
+    // (or stays dismissed); autopilot never re-applies it until the document changes.
+    if (c.dismissedFingerprint && c.fingerprint && c.dismissedFingerprint === c.fingerprint) {
+        return { pass: false, reason: 'dismissed' };
+    }
+    if (c.issueId && ctx.cooldownIssueIds.has(c.issueId))
+        return { pass: false, reason: 'cooldown' };
+    if (c.entity.id && ctx.cooldownEntityKeys.has(`${c.entity.id}:${c.issueTypeKey}`)) {
+        return { pass: false, reason: 'cooldown' };
+    }
+    if (ctx.planDenied)
+        return { pass: false, reason: 'plan_denied' };
+    switch (c.kind) {
+        case 'redirect': {
+            const source = c.entity.url ?? '';
+            const target = c.changes[0]?.after;
+            if (source.trim() === '' || !source.startsWith('/')) {
+                return {
+                    pass: false,
+                    reason: 'validator_failed',
+                    detail: 'redirect source must be a /-prefixed path',
+                };
+            }
+            if (typeof target !== 'string' || target.trim() === '') {
+                return {
+                    pass: false,
+                    reason: 'validator_failed',
+                    detail: 'redirect target must be a non-empty string',
+                };
+            }
+            if (target.trim() === source.trim()) {
+                return { pass: false, reason: 'validator_failed', detail: 'redirect target equals source' };
+            }
+            const min = ctx.policy.redirectMinConfidence / 100;
+            const conf = c.confidence ?? 0;
+            // Negated `>=` so NaN fails closed (`NaN < min` is false and would pass).
+            if (!(conf >= min)) {
+                return { pass: false, reason: 'redirect_low_confidence', detail: `${conf} < ${min}` };
+            }
+            if (ctx.existingRedirectSources.has(source)) {
+                return { pass: false, reason: 'redirect_manual_exists' };
+            }
+            return { pass: true, checks: { confidence: true, noExisting: true } };
+        }
+        case 'issue-fix': {
+            const checks = {};
+            const afterStrings = c.changes.filter((ch) => typeof ch.after === 'string');
+            if (c.source === 'ai' || c.source === 'ai-404-recovery') {
+                if (ctx.brandProfile) {
+                    const touchesScorable = c.changes.some((ch) => CHANNEL_SCORABLE_FIELDS.has(ch.field));
+                    if (c.brandAlignment === null) {
+                        if (touchesScorable)
+                            return { pass: false, reason: 'brand_unscored' };
+                    }
+                    else if (!(c.brandAlignment >= ctx.policy.minBrandAlignment)) {
+                        // Negated `>=` so a NaN score fails closed.
+                        return {
+                            pass: false,
+                            reason: 'brand_below_threshold',
+                            detail: `${c.brandAlignment} < ${ctx.policy.minBrandAlignment}`,
+                        };
+                    }
+                    checks.brand = true;
+                    for (const ch of afterStrings) {
+                        const hits = bannedTermHits(ch.after, ctx.brandProfile.bannedTerms);
+                        if (hits.length > 0)
+                            return { pass: false, reason: 'banned_term', detail: hits[0] };
+                    }
+                    checks.bannedTerms = true;
+                }
+                else {
+                    checks.brand = true;
+                    checks.bannedTerms = true;
+                }
+            }
+            for (const ch of c.changes) {
+                const failure = validatorFailure(ch.field, ch.after);
+                if (failure)
+                    return { pass: false, reason: 'validator_failed', detail: failure };
+            }
+            checks.validators = true;
+            if (c.source === 'ai' || c.source === 'ai-404-recovery') {
+                for (const ch of afterStrings) {
+                    // `ogDescription` is intentionally excluded: no autopilot type targets OG duplication.
+                    const map = TITLE_FIELDS.has(ch.field)
+                        ? ctx.duplicates.titles
+                        : ch.field === 'metaDescription'
+                            ? ctx.duplicates.descriptions
+                            : null;
+                    if (!map)
+                        continue;
+                    const key = normalizeDuplicateValue(ch.after);
+                    if (!key)
+                        continue;
+                    const owners = map.get(key);
+                    if (owners && [...owners].some((id) => id !== c.entity.id)) {
+                        return { pass: false, reason: 'duplicate_value', detail: ch.field };
+                    }
+                }
+                checks.duplicates = true;
+            }
+            return { pass: true, checks };
+        }
+        default: {
+            const _exhaustive = c.kind;
+            return _exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=autopilot-gate.js.map

package/dist/seo/autopilot-gate.js.map

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

package/dist/seo/autopilot-ledger.d.ts

@@ -0,0 +1,74 @@
+/**
+ * SeoAutoApply ledger helpers (spec §4). Rows are append-only; revert flips
+ * `status` in place. All queries tolerate a consumer schema without the
+ * model via the `hasModel`-style probe the callers perform.
+ *
+ * `status`, `outcome`, and `kind` are plain `String` columns in Prisma; the
+ * unions below are the TS narrowing every writer must go through.
+ */
+import type { PrentaDB } from '../db/client-types.js';
+import type { SeoAutoApply } from '../db/model-types.js';
+export type SeoAutoApplyKind = 'issue-fix' | 'redirect';
+export type SeoAutoApplyStatus = 'applied' | 'verify_failed' | 'reverted' | 'outcome_reverted';
+export type SeoAutoApplyOutcome = 'pending' | 'held' | 'regressed' | 'insufficient_data' | 'skipped';
+export type SeoAutoApplyRevertReason = 'verify_failed' | 'outcome_regression' | 'manual';
+export interface AutoApplyGateSnapshot {
+    source: string;
+    brandAlignment: number | null;
+    confidence: number | null;
+    checks: Record<string, boolean>;
+}
+export interface RecordAutoApplyInput {
+    kind: SeoAutoApplyKind;
+    issueId: string | null;
+    issueType: string;
+    entityId: string | null;
+    collection: string | null;
+    path: string | null;
+    redirectId: string | null;
+    /** Prior field values for issue fixes; `null` for redirects (no prior state). */
+    before: Record<string, unknown> | null;
+    after: Record<string, unknown>;
+    gate: AutoApplyGateSnapshot;
+    status: SeoAutoApplyStatus;
+    appliedById: string;
+    versionId?: string | null;
+    revertReason?: SeoAutoApplyRevertReason | null;
+    revertedAt?: Date | null;
+    revertedById?: string | null;
+    outcome?: SeoAutoApplyOutcome;
+}
+export type SeoAutoApplyRow = SeoAutoApply & {
+    entityTitle: string | null;
+    entityUrl: string | null;
+};
+export declare function startOfDayUTC(d: Date): Date;
+export declare function recordAutoApply(db: PrentaDB, input: RecordAutoApplyInput): Promise<SeoAutoApply>;
+export declare function countAutoAppliesToday(db: PrentaDB, now: Date): Promise<number>;
+/** Per-branch row cap for `loadCooldownKeys` (newest first, so the cap drops the oldest). */
+export declare const COOLDOWN_QUERY_MAX = 1000;
+/**
+ * Issues / entities autopilot must leave alone for `AUTOPILOT_COOLDOWN_DAYS`:
+ * anything reverted in the window (on `revertedAt`) plus anything that failed
+ * verification in the window (on `appliedAt`). Verify-failed applies are
+ * cooled down so a deterministically failing fix does not trip the breaker
+ * every run. The two branches are queried separately so each is ordered by
+ * its own timestamp — a capped, unordered `OR` could drop the newest rows.
+ */
+export declare function loadCooldownKeys(db: PrentaDB, now: Date): Promise<{
+    issueIds: Set<string>;
+    entityKeys: Set<string>;
+}>;
+export interface ListSeoAutoAppliesInput {
+    status?: SeoAutoApplyStatus;
+    outcome?: SeoAutoApplyOutcome;
+    page: number;
+    pageSize: number;
+}
+export declare function listSeoAutoApplies(db: PrentaDB, input: ListSeoAutoAppliesInput): Promise<{
+    docs: SeoAutoApplyRow[];
+    total: number;
+    page: number;
+    pageSize: number;
+}>;
+//# sourceMappingURL=autopilot-ledger.d.ts.map

package/dist/seo/autopilot-ledger.d.ts.map

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

package/dist/seo/autopilot-ledger.js

@@ -0,0 +1,118 @@
+import { documentPublicPath } from './document-path.js';
+import { AUTOPILOT_COOLDOWN_DAYS } from './autopilot-policy.js';
+const DAY_MS = 24 * 60 * 60 * 1000;
+/** Statuses that count against the daily auto-apply budget. */
+const COUNTED_STATUSES = ['applied', 'verify_failed'];
+/** Statuses whose rows put an issue/entity into cooldown on `revertedAt` (see `loadCooldownKeys`). */
+const REVERTED_STATUSES = ['reverted', 'outcome_reverted'];
+export function startOfDayUTC(d) {
+    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
+}
+export async function recordAutoApply(db, input) {
+    // Redirects have no path metric to watch; issue fixes with no path can't be judged either.
+    const outcome = input.outcome ?? (input.kind === 'redirect' || !input.path ? 'skipped' : 'pending');
+    return db.seoAutoApply.create({
+        data: {
+            kind: input.kind,
+            issueId: input.issueId,
+            issueType: input.issueType,
+            entityId: input.entityId,
+            collection: input.collection,
+            path: input.path,
+            redirectId: input.redirectId,
+            // `before` is a nullable Json column: a JS `null` maps to SQL NULL.
+            before: input.before ?? null,
+            after: input.after,
+            gate: input.gate,
+            status: input.status,
+            outcome,
+            versionId: input.versionId ?? null,
+            appliedById: input.appliedById,
+            revertReason: input.revertReason ?? null,
+            revertedAt: input.revertedAt ?? null,
+            revertedById: input.revertedById ?? null,
+        },
+    });
+}
+export async function countAutoAppliesToday(db, now) {
+    return db.seoAutoApply.count({
+        where: { status: { in: [...COUNTED_STATUSES] }, appliedAt: { gte: startOfDayUTC(now) } },
+    });
+}
+/** Per-branch row cap for `loadCooldownKeys` (newest first, so the cap drops the oldest). */
+export const COOLDOWN_QUERY_MAX = 1000;
+/**
+ * Issues / entities autopilot must leave alone for `AUTOPILOT_COOLDOWN_DAYS`:
+ * anything reverted in the window (on `revertedAt`) plus anything that failed
+ * verification in the window (on `appliedAt`). Verify-failed applies are
+ * cooled down so a deterministically failing fix does not trip the breaker
+ * every run. The two branches are queried separately so each is ordered by
+ * its own timestamp — a capped, unordered `OR` could drop the newest rows.
+ */
+export async function loadCooldownKeys(db, now) {
+    const since = new Date(now.getTime() - AUTOPILOT_COOLDOWN_DAYS * DAY_MS);
+    const [reverted, verifyFailed] = await Promise.all([
+        db.seoAutoApply.findMany({
+            where: { status: { in: [...REVERTED_STATUSES] }, revertedAt: { gte: since } },
+            orderBy: { revertedAt: 'desc' },
+            take: COOLDOWN_QUERY_MAX,
+        }),
+        db.seoAutoApply.findMany({
+            where: { status: 'verify_failed', appliedAt: { gte: since } },
+            orderBy: { appliedAt: 'desc' },
+            take: COOLDOWN_QUERY_MAX,
+        }),
+    ]);
+    const issueIds = new Set();
+    const entityKeys = new Set();
+    for (const r of [...reverted, ...verifyFailed]) {
+        if (r.issueId)
+            issueIds.add(r.issueId);
+        if (r.entityId)
+            entityKeys.add(`${r.entityId}:${r.issueType}`);
+    }
+    return { issueIds, entityKeys };
+}
+export async function listSeoAutoApplies(db, input) {
+    const where = {};
+    if (input.status)
+        where.status = input.status;
+    if (input.outcome)
+        where.outcome = input.outcome;
+    const [rows, total] = await Promise.all([
+        db.seoAutoApply.findMany({
+            where,
+            orderBy: { appliedAt: 'desc' },
+            skip: (input.page - 1) * input.pageSize,
+            take: input.pageSize,
+        }),
+        db.seoAutoApply.count({ where }),
+    ]);
+    const ids = [...new Set(rows.map((r) => r.entityId).filter((v) => Boolean(v)))];
+    const docs = ids.length
+        ? await db.document.findMany({
+            where: { id: { in: ids }, deletedAt: null },
+            select: { id: true, title: true, slug: true, collection: true, data: true },
+        })
+        : [];
+    const byId = new Map(docs.map((d) => [
+        d.id,
+        {
+            title: typeof d.title === 'string' ? d.title : null,
+            url: documentPublicPath({
+                slug: d.slug,
+                data: (d.data ?? null),
+            }),
+        },
+    ]));
+    return {
+        docs: rows.map((r) => {
+            const meta = r.entityId ? byId.get(r.entityId) : undefined;
+            return { ...r, entityTitle: meta?.title ?? null, entityUrl: meta?.url ?? r.path };
+        }),
+        total,
+        page: input.page,
+        pageSize: input.pageSize,
+    };
+}
+//# sourceMappingURL=autopilot-ledger.js.map

package/dist/seo/autopilot-ledger.js.map

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

package/dist/seo/autopilot-outcome.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Outcome watch (spec §5): N days after an autopilot change, compare the
+ * page's Search Console clicks before vs after. A ≥ dropRatio fall reverts the
+ * change and pauses that issue type until a human resumes it.
+ *
+ * Windows are whole UTC calendar days anchored on `startOfDayUTC(appliedAt)`,
+ * matching how the GSC sync stores `SearchPerfDaily.date` (`@db.Date`, UTC
+ * midnight). GSC reports property-local days, so an apply near local midnight
+ * in a non-UTC property can land one calendar day off — accepted for v1.
+ *
+ * Due-ness is anchored on the newest synced GSC date, not the wall clock: a row
+ * is judged only once data exists through the end of its after window, so a
+ * stalled or disconnected sync leaves rows `pending` instead of reading an
+ * empty after window as a regression.
+ */
+import type { PrentaDB } from '../db/client-types.js';
+import { type AutopilotIssueType, type AutopilotOutcomeWatch, type SeoAutopilotPolicy } from './autopilot-policy.js';
+import { type SeoAutoApplyOutcome } from './autopilot-ledger.js';
+import { revertSeoAutoApply } from './autopilot-revert.js';
+/** Upper bound on ledger rows judged per cron tick. */
+export declare const OUTCOME_MAX_PER_TICK = 50;
+/** A regression whose revert keeps throwing is requeued at most this many times. */
+export declare const OUTCOME_MAX_REVERT_ATTEMPTS = 3;
+export type OutcomeJudgement = Extract<SeoAutoApplyOutcome, 'insufficient_data' | 'regressed' | 'held'>;
+/**
+ * Pure judgement. A zero `prior` (no ratio to take) or one below the floor is
+ * not enough signal; otherwise a fall to or below `prior × (1 − dropRatio)` is
+ * a regression.
+ */
+export declare function evaluateOutcome(prior: number, after: number, watch: AutopilotOutcomeWatch): OutcomeJudgement;
+export interface OutcomeWatchResult {
+    evaluated: number;
+    held: number;
+    regressed: number;
+    reverted: number;
+    insufficient: number;
+    conflicts: number;
+    /** Regressions whose revert threw (row requeued as `pending` until `OUTCOME_MAX_REVERT_ATTEMPTS`). */
+    revertErrors: number;
+    /** Due rows left `pending` because GSC data has not yet synced through their after window. */
+    notReady: number;
+    /** `true` when `deadline` was reached before every due row was judged (the rest stay `pending`). */
+    deadlineHit: boolean;
+    /** Issue types to pause, keyed to the human-readable reason to store on the policy. */
+    pausedTypes: Partial<Record<AutopilotIssueType, string>>;
+}
+export interface OutcomeWatchOptions {
+    /** Wall clock stamped on judged rows and in pause reasons. */
+    now: Date;
+    actor: {
+        userId: string;
+        role: string;
+    };
+    /** Injectable for tests; defaults to `revertSeoAutoApply`. */
+    revert?: typeof revertSeoAutoApply;
+    /**
+     * Epoch-ms deadline (compared against `clock()`): checked before each row is
+     * judged; once reached the loop stops and the remaining rows stay `pending`
+     * for the next tick. Absent = judge every due row (bounded by
+     * `OUTCOME_MAX_PER_TICK`).
+     */
+    deadline?: number;
+    /** Monotonic-ish clock for `deadline`; defaults to `Date.now`. */
+    clock?: () => number;
+    /**
+     * Invoked the moment a regression is decided — before the revert is
+     * attempted — so the caller can persist the type pause immediately rather
+     * than after the whole watch returns. A throw is logged and does not stop
+     * the tick; the pause is still reported in `pausedTypes`.
+     */
+    onPause?: (type: AutopilotIssueType, reason: string) => Promise<void> | void;
+}
+/**
+ * Judge every due, still-pending issue fix (oldest first, capped per tick).
+ * Due = applied at least `days + AUTOPILOT_OUTCOME_LAG_DAYS` ago *and* GSC data
+ * synced through the end of the after window. Prior window: `days` days ending
+ * the day before apply. After window: `days` days starting the day after apply.
+ *
+ * A regression reverts the row with reason `outcome_regression` (never
+ * forced — a human edit since is a conflict) and requests a pause of that
+ * issue type via `pausedTypes`; the caller persists the pause on the policy.
+ * A revert that throws is logged, counted in `revertErrors`, and the row is
+ * put back to `pending` (with `outcomeMetrics.revertAttempts`) so the next
+ * tick retries — up to `OUTCOME_MAX_REVERT_ATTEMPTS`, after which it stays
+ * `regressed` for a manual revert. The tick continues with the next row.
+ *
+ * The pause is decided (and `onPause` fired) before the revert is attempted,
+ * so a revert that throws — or a process killed mid-revert — never loses the
+ * breaker. `opts.deadline` bounds the wall clock: rows not reached stay
+ * `pending` and are judged next tick.
+ */
+export declare function runOutcomeWatch(db: PrentaDB, policy: SeoAutopilotPolicy, opts: OutcomeWatchOptions): Promise<OutcomeWatchResult>;
+//# sourceMappingURL=autopilot-outcome.d.ts.map

package/dist/seo/autopilot-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autopilot-outcome.d.ts","sourceRoot":"","sources":["../../src/seo/autopilot-outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE1D,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAK5C,MAAM,MAAM,gBAAgB,GAAG,OAAO,CACpC,mBAAmB,EACnB,mBAAmB,GAAG,WAAW,GAAG,MAAM,CAC3C,CAAA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,qBAAqB,GAC3B,gBAAgB,CAIlB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,sGAAsG;IACtG,YAAY,EAAE,MAAM,CAAA;IACpB,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,CAAA;IAChB,oGAAoG;IACpG,WAAW,EAAE,OAAO,CAAA;IACpB,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAA;CACzD;AAED,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,GAAG,EAAE,IAAI,CAAA;IACT,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,kBAAkB,CAAA;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC7E;AAuBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA8I7B"}