@prenta/core 5.5.0 → 5.7.0

package/dist/seo/proposals-bulk-apply.js

@@ -0,0 +1,183 @@
+import { assertBulkApplyAllowed as defaultAssertBulk } from '../ai/governance.js';
+import { acceptRedirectSuggestion as defaultAcceptRedirect } from '../redirects/suggestion-accept.js';
+import { applyIssueFix as defaultApplyIssue } from './issue-fix-apply.js';
+import { pendingFixFromMetadata } from './issue-fix-ai.js';
+import { PROPOSAL_BATCH_TIME_BUDGET_MS } from './proposals-generate.js';
+import { ISSUE_FIX_FEATURE_KEY, REDIRECT_FEATURE_KEY } from './proposals.js';
+export const PROPOSAL_BULK_APPLY_MAX = 50;
+const BULK_APPLY_CONCURRENCY = 3;
+const ADMIN_ROLES = new Set(['OWNER', 'ADMIN']);
+const REDIRECT_MODEL_MISSING_MESSAGE = 'The "RedirectSuggestion" model is not available in your Prisma schema.';
+function toDate(value) {
+    return value instanceof Date ? value : new Date(String(value));
+}
+const keyOf = (item) => `${item.kind}:${item.id}`;
+/**
+ * Same probe as `hasModel()` in `api/route-helpers.ts` (and the local copy in
+ * `redirects/suggestion-accept.ts`): `guardedDb()` hands back a throwing Proxy
+ * for models missing from the consumer schema, so a plain truthiness check
+ * would report them present. The accept ROUTE gates this; a direct service
+ * caller must gate it itself, and the seo layer must not depend on the API layer.
+ */
+function hasModel(db, model) {
+    try {
+        const delegate = db[model];
+        return Boolean(delegate) && typeof delegate?.findMany === 'function';
+    }
+    catch {
+        return false;
+    }
+}
+export async function bulkApplySeoProposals(db, input, deps = {}) {
+    const applyIssue = deps.applyIssue ?? defaultApplyIssue;
+    const acceptRedirect = deps.acceptRedirect ?? defaultAcceptRedirect;
+    const assertBulk = deps.assertBulk ?? defaultAssertBulk;
+    const now = deps.now ?? Date.now;
+    const budgetMs = deps.budgetMs ?? PROPOSAL_BATCH_TIME_BUDGET_MS;
+    const concurrency = Math.max(1, deps.concurrency ?? BULK_APPLY_CONCURRENCY);
+    const { actor } = input;
+    const startedAt = now();
+    // Dedupe by `kind:id`, keeping first-occurrence order. Results are keyed the
+    // same way, so a repeated item would run twice in one group — the second run
+    // finds the cache consumed and its `not-fixable`/`not-found` would overwrite
+    // the first run's real `applied`, and governance would count it as extra load.
+    const seen = new Set();
+    const items = input.items.filter((item) => {
+        const key = keyOf(item);
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    // A single item is the ordinary approve path; governance only weighs in on
+    // batches. Keys are always derived from the kinds actually present —
+    // `assertBulkApplyAllowed` passes an empty key list, so never send one.
+    if (items.length > 1) {
+        const keys = [];
+        if (items.some((i) => i.kind === 'issue-fix'))
+            keys.push(ISSUE_FIX_FEATURE_KEY);
+        if (items.some((i) => i.kind === 'redirect'))
+            keys.push(REDIRECT_FEATURE_KEY);
+        const decision = await assertBulk(db, keys, items.length);
+        if (!decision.ok)
+            return { blocked: true, reason: decision.reason };
+    }
+    const redirectModelAvailable = items.some((i) => i.kind === 'redirect')
+        ? hasModel(db, 'redirectSuggestion')
+        : true;
+    // Resolve which document each issue-fix item writes (insert-link fixes
+    // write the SOURCE document) and snapshot those documents' updatedAt.
+    const issueIds = items.filter((i) => i.kind === 'issue-fix').map((i) => i.id);
+    const writeTargetByIssue = new Map();
+    if (issueIds.length > 0) {
+        const rows = await db.seoIssue.findMany({ where: { id: { in: issueIds } } });
+        for (const row of rows) {
+            const cache = pendingFixFromMetadata(row.metadata);
+            const source = cache && typeof cache.patch.sourceEntityId === 'string' ? cache.patch.sourceEntityId : null;
+            const target = source ?? row.entityId ?? null;
+            if (target)
+                writeTargetByIssue.set(row.id, target);
+        }
+    }
+    const snapshotByDoc = new Map();
+    const docIds = [...new Set(writeTargetByIssue.values())];
+    if (docIds.length > 0) {
+        const docs = (await db.document.findMany({
+            where: { id: { in: docIds }, deletedAt: null },
+            select: { id: true, updatedAt: true },
+        }));
+        for (const doc of docs)
+            snapshotByDoc.set(doc.id, toDate(doc.updatedAt));
+    }
+    // Group: issue fixes by write-target document; every redirect is its own group.
+    const groups = new Map();
+    for (const item of items) {
+        const key = item.kind === 'redirect'
+            ? `redirect:${item.id}`
+            : `doc:${writeTargetByIssue.get(item.id) ?? `issue:${item.id}`}`;
+        const list = groups.get(key);
+        if (list)
+            list.push(item);
+        else
+            groups.set(key, [item]);
+    }
+    const resultByKey = new Map();
+    for (const item of items) {
+        resultByKey.set(keyOf(item), { kind: item.kind, id: item.id, status: 'pending' });
+    }
+    async function runItem(item) {
+        try {
+            if (item.kind === 'redirect') {
+                if (!ADMIN_ROLES.has(actor.role)) {
+                    return {
+                        kind: item.kind,
+                        id: item.id,
+                        status: 'not-allowed',
+                        reason: 'Accepting redirects requires an admin role.',
+                    };
+                }
+                if (!redirectModelAvailable) {
+                    return {
+                        kind: item.kind,
+                        id: item.id,
+                        status: 'error',
+                        reason: REDIRECT_MODEL_MISSING_MESSAGE,
+                    };
+                }
+                const r = await acceptRedirect(db, {
+                    suggestionId: item.id,
+                    actor: { userId: actor.userId },
+                });
+                if (r.status === 'accepted')
+                    return { kind: item.kind, id: item.id, status: 'applied' };
+                if (r.status === 'not-found')
+                    return { kind: item.kind, id: item.id, status: 'not-found' };
+                return { kind: item.kind, id: item.id, status: r.status, reason: r.reason };
+            }
+            const target = writeTargetByIssue.get(item.id);
+            const r = await applyIssue(db, {
+                issueId: item.id,
+                fingerprint: item.fingerprint,
+                actor,
+                staleAgainst: target ? snapshotByDoc.get(target) : undefined,
+            });
+            if (r.status === 'applied')
+                return { kind: item.kind, id: item.id, status: 'applied' };
+            if (r.status === 'plan-required') {
+                return { kind: item.kind, id: item.id, status: 'plan-required', reason: r.denial.message };
+            }
+            return { kind: item.kind, id: item.id, status: r.status, reason: r.reason };
+        }
+        catch (err) {
+            console.warn('[seo/proposals-bulk-apply] item apply failed', { kind: item.kind, id: item.id }, err);
+            return {
+                kind: item.kind,
+                id: item.id,
+                status: 'error',
+                reason: err instanceof Error ? err.message : 'Apply failed',
+            };
+        }
+    }
+    const groupList = [...groups.values()];
+    let cursor = 0;
+    async function worker() {
+        while (cursor < groupList.length) {
+            const group = groupList[cursor++];
+            for (const item of group) {
+                if (now() - startedAt >= budgetMs)
+                    return;
+                resultByKey.set(keyOf(item), await runItem(item));
+            }
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(concurrency, groupList.length) }, worker));
+    const results = items.map((item) => resultByKey.get(keyOf(item)));
+    return {
+        blocked: false,
+        results,
+        applied: results.filter((r) => r.status === 'applied').length,
+        pending: results.filter((r) => r.status === 'pending').length,
+        failed: results.filter((r) => r.status !== 'applied' && r.status !== 'pending').length,
+    };
+}
+//# sourceMappingURL=proposals-bulk-apply.js.map

package/dist/seo/proposals-bulk-apply.js.map

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

package/dist/seo/proposals-generate.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Batch "Generate proposals": run `suggestIssueFix` for eligible open issues
+ * and cache the results so the proposals inbox fills without opening issues
+ * one by one. Human-triggered only (route is confirm-gated, plan-gated,
+ * rate-limited). Bounded three ways — per-call cap, concurrency, wall clock —
+ * because it runs inside a 30 s function budget and spends AI tokens.
+ *
+ * AI failures are split by scope. Provider-level codes (`HALTING_AI_ERROR_CODES`)
+ * mean every further call this pass would fail too, so the batch halts and
+ * reports `haltedReason`. A per-issue `error` (bad model output for one
+ * document) is counted as failed AND stamped with `generateSkippedFingerprint`,
+ * so the same issue cannot pin the severity-sorted queue head on every pass —
+ * it is retried once the document changes, or when an editor explicitly runs
+ * `suggest-fix` (a new cache clears the marker).
+ */
+import type { PrentaDB } from '../db/client-types.js';
+import { loadIssueFixContext as defaultLoadIssueFixContext } from './issue-fix-apply.js';
+import { suggestIssueFix as defaultSuggestIssueFix } from './issue-fix.js';
+export declare const PROPOSAL_GENERATE_BATCH_MAX = 10;
+export declare const PROPOSAL_GENERATE_CONCURRENCY = 3;
+export declare const PROPOSAL_BATCH_TIME_BUDGET_MS = 20000;
+export interface GenerateProposalsResult {
+    generated: number;
+    skipped: number;
+    failed: number;
+    /** Eligible issues not processed this call (cap, budget, or early halt). */
+    remaining: number;
+    /** Set when a provider-level AI error (see `HALTING_AI_ERROR_CODES`) stopped the batch early. */
+    haltedReason: string | null;
+}
+export interface GenerateProposalsDeps {
+    /** Injected for tests; defaults call the real suggestIssueFix / loadIssueFixContext. */
+    suggest?: typeof defaultSuggestIssueFix;
+    loadContext?: typeof defaultLoadIssueFixContext;
+    now?: () => number;
+    max?: number;
+    concurrency?: number;
+    budgetMs?: number;
+    /** Autopilot: restrict generation to these issue types. Undefined = every fixable type. */
+    onlyTypes?: ReadonlySet<string>;
+}
+export declare function generateSeoProposals(db: PrentaDB, actor: {
+    userId: string;
+}, deps?: GenerateProposalsDeps): Promise<GenerateProposalsResult>;
+//# sourceMappingURL=proposals-generate.d.ts.map

package/dist/seo/proposals-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposals-generate.d.ts","sourceRoot":"","sources":["../../src/seo/proposals-generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErD,OAAO,EAAE,mBAAmB,IAAI,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAa1E,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAC7C,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAC9C,eAAO,MAAM,6BAA6B,QAAS,CAAA;AAcnD,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAA;IACjB,iGAAiG;IACjG,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,sBAAsB,CAAA;IACvC,WAAW,CAAC,EAAE,OAAO,0BAA0B,CAAA;IAC/C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAChC;AAUD,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACzB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CA2IlC"}

package/dist/seo/proposals-generate.js

@@ -0,0 +1,144 @@
+import { getAIConfig } from '../ai/config-store.js';
+import { loadIssueFixContext as defaultLoadIssueFixContext } from './issue-fix-apply.js';
+import { suggestIssueFix as defaultSuggestIssueFix } from './issue-fix.js';
+import { pendingFixFromMetadata, pendingFixToMetadata, scoreFixBrandAlignment, stickyFingerprintsFromMetadata, } from './issue-fix-ai.js';
+import { loadOpenFixableIssuesWithDocs, selectEligibleForGeneration, } from './proposals.js';
+export const PROPOSAL_GENERATE_BATCH_MAX = 10;
+export const PROPOSAL_GENERATE_CONCURRENCY = 3;
+export const PROPOSAL_BATCH_TIME_BUDGET_MS = 20_000;
+/**
+ * `aiError.code`s that describe the provider / governance state rather than
+ * one issue: every further `suggestIssueFix` call in this pass is guaranteed
+ * to fail the same way, so the batch stops instead of burning the queue.
+ */
+const HALTING_AI_ERROR_CODES = new Set([
+    'rate_limited',
+    'unavailable',
+    'feature_disabled',
+    'budget_exceeded',
+]);
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+export async function generateSeoProposals(db, actor, deps = {}) {
+    const suggest = deps.suggest ?? defaultSuggestIssueFix;
+    const loadContext = deps.loadContext ?? defaultLoadIssueFixContext;
+    const now = deps.now ?? Date.now;
+    const max = deps.max ?? PROPOSAL_GENERATE_BATCH_MAX;
+    const concurrency = Math.max(1, deps.concurrency ?? PROPOSAL_GENERATE_CONCURRENCY);
+    const budgetMs = deps.budgetMs ?? PROPOSAL_BATCH_TIME_BUDGET_MS;
+    const startedAt = now();
+    const { issues, docsById } = await loadOpenFixableIssuesWithDocs(db);
+    const allEligible = selectEligibleForGeneration(issues, docsById);
+    // Filter before the cap so `remaining` counts only issues this caller could
+    // ever generate (autopilot passes the policy's opted-in types).
+    const onlyTypes = deps.onlyTypes;
+    const eligible = onlyTypes
+        ? allEligible.filter((e) => onlyTypes.has(String(e.issue.type)))
+        : allEligible;
+    const queue = eligible.slice(0, max);
+    // Read once per pass, not once per issue. Fail open: an unreadable AI config
+    // leaves every proposal unscored (brandAlignment: null) rather than aborting.
+    const brandVoice = await getAIConfig(db)
+        .then((c) => c.settings.brandVoice)
+        .catch((err) => {
+        console.warn('[seo/proposals-generate] AI config unavailable for brand alignment', err);
+        return undefined;
+    });
+    const result = {
+        generated: 0,
+        skipped: 0,
+        failed: 0,
+        remaining: 0,
+        haltedReason: null,
+    };
+    let processed = 0;
+    let halted = false;
+    async function writeMetadata(issueId, patch) {
+        const fresh = await db.seoIssue.findUnique({ where: { id: issueId } });
+        await db.seoIssue.update({
+            where: { id: issueId },
+            data: { metadata: { ...asRecord(fresh?.metadata), ...patch } },
+        });
+    }
+    async function processOne(item) {
+        const { issue, liveFingerprint } = item;
+        // Double-click guard: since our eligibility scan another request may have
+        // cached this issue (never spend tokens twice on one document state) or
+        // the user may have dismissed it / a prior pass marked it non-cacheable.
+        // Writing a cache would clear those sticky markers, so honour them here.
+        const fresh = await db.seoIssue.findUnique({ where: { id: issue.id } });
+        const freshCache = pendingFixFromMetadata(fresh?.metadata);
+        if (freshCache && freshCache.fingerprint === liveFingerprint)
+            return 'skipped';
+        const sticky = stickyFingerprintsFromMetadata(fresh?.metadata);
+        if (sticky.dismissed === liveFingerprint || sticky.generateSkipped === liveFingerprint) {
+            return 'skipped';
+        }
+        const loaded = await loadContext(db, issue);
+        if (!loaded.ok) {
+            await writeMetadata(issue.id, { generateSkippedFingerprint: liveFingerprint });
+            return 'skipped';
+        }
+        const outcome = await suggest({
+            type: issue.type,
+            title: issue.title,
+            recommendation: issue.recommendation,
+            entityType: issue.entityType,
+            entityId: issue.entityId,
+        }, {
+            entity: loaded.ctx.entity,
+            siteSeo: loaded.ctx.siteSeo,
+            updatedAt: loaded.ctx.updatedAt,
+            metadata: asRecord(issue.metadata),
+        }, { db, userId: actor.userId, collection: loaded.ctx.collection });
+        if (outcome.aiError && HALTING_AI_ERROR_CODES.has(outcome.aiError.code)) {
+            result.haltedReason = outcome.aiError.message;
+            return 'halted';
+        }
+        if (outcome.aiError) {
+            // Per-issue failure: remember this document state so the next pass moves
+            // on instead of retrying the same head-of-queue issue forever.
+            await writeMetadata(issue.id, { generateSkippedFingerprint: liveFingerprint });
+            return 'failed';
+        }
+        if (outcome.cacheForApply) {
+            await writeMetadata(issue.id, pendingFixToMetadata(outcome.suggestion, {
+                brandAlignment: scoreFixBrandAlignment(outcome.suggestion.changes, brandVoice),
+            }));
+            return 'generated';
+        }
+        // Nothing cacheable for this document state (deterministic fix covers it,
+        // or the type never caches). Remember that so the next pass skips it.
+        await writeMetadata(issue.id, { generateSkippedFingerprint: liveFingerprint });
+        return 'skipped';
+    }
+    let cursor = 0;
+    async function worker() {
+        while (!halted && cursor < queue.length && now() - startedAt < budgetMs) {
+            const item = queue[cursor++];
+            let outcome;
+            try {
+                outcome = await processOne(item);
+            }
+            catch (err) {
+                console.warn('[seo/proposals-generate] proposal generation failed', { issueId: item.issue.id }, err);
+                outcome = 'failed';
+            }
+            processed++;
+            if (outcome === 'halted') {
+                halted = true;
+                result.failed++;
+            }
+            else {
+                result[outcome]++;
+            }
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(concurrency, queue.length) }, worker));
+    result.remaining = eligible.length - processed;
+    return result;
+}
+//# sourceMappingURL=proposals-generate.js.map

package/dist/seo/proposals-generate.js.map

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

package/dist/seo/proposals.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Unified AI proposal shape over two stores: cached issue fixes
+ * (`SeoIssue.metadata.pendingFix`) and open `RedirectSuggestion` rows.
+ * Read-only; the generate / bulk-apply services live beside this file.
+ */
+import type { PrentaDB } from '../db/client-types.js';
+import { type SeoFixFieldChange } from './issue-fix.js';
+import { type PendingFixCache } from './issue-fix-ai.js';
+export declare const ISSUE_FIX_FEATURE_KEY = "ai.features.seoMetaGeneration";
+export declare const REDIRECT_FEATURE_KEY = "ai.features.seo404Recovery";
+export type SeoProposalSeverity = 'critical' | 'warning' | 'info';
+export interface SeoProposal {
+    /** `issue:<issueId>` | `redirect:<suggestionId>` */
+    id: string;
+    kind: 'issue-fix' | 'redirect';
+    title: string;
+    entity: {
+        type: string | null;
+        id: string | null;
+        title: string | null;
+        url: string | null;
+    };
+    changes: SeoFixFieldChange[];
+    justification: string;
+    source: 'ai' | 'deterministic' | 'ai-404-recovery';
+    /** 0–1, redirects only. */
+    confidence: number | null;
+    /** 0–100, issue fixes only. */
+    brandAlignment: number | null;
+    generatedAt: string | null;
+    /** Issue fixes only; redirects are keyed by id. */
+    fingerprint: string | null;
+    /** Issue fixes: cached fingerprint ≠ live fingerprint. Redirects: always false. */
+    stale: boolean;
+    issueType: string | null;
+    severity: SeoProposalSeverity | null;
+    issueId: string | null;
+    suggestionId: string | null;
+}
+export interface SeoProposalsPayload {
+    proposals: SeoProposal[];
+    counts: {
+        /** Live (non-stale) issue-fix proposals. */
+        issueFixes: number;
+        redirects: number;
+        stale: number;
+        /** Open/recurring + fixable + no live proposal + not sticky-dismissed/skipped. */
+        eligibleForGeneration: number;
+    };
+    /** `allowBulkApply` per feature, so the UI can disable batch approve up front. */
+    governance: {
+        issueFixBulk: boolean;
+        redirectBulk: boolean;
+    };
+    /** Autopilot status strip for the proposals inbox. */
+    autopilot: {
+        enabled: boolean;
+        /** Set only while the engine is actually paused (`pausedAt` present). */
+        pausedReason: string | null;
+        lastRunAt: string | null;
+        /** Live autopilot changes (`status = applied`) from the last 7 days. */
+        appliedLast7d: number;
+    };
+}
+export interface ProposalDoc {
+    id: string;
+    updatedAt: Date;
+    title: string | null;
+    slug: string | null;
+    collection: string;
+}
+type IssueRow = Record<string, any>;
+/**
+ * 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 declare function loadOpenFixableIssuesWithDocs(db: PrentaDB): Promise<{
+    issues: IssueRow[];
+    docsById: Map<string, ProposalDoc>;
+}>;
+/**
+ * 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 declare function liveFingerprintFor(issue: IssueRow, cache: PendingFixCache | null, docsById: Map<string, ProposalDoc>): string | null;
+/**
+ * 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 declare function dismissalFingerprintFor(issue: IssueRow, cache: PendingFixCache, entityUpdatedAt: Date | string | null): string;
+export interface EligibleIssue {
+    issue: IssueRow;
+    liveFingerprint: string;
+}
+/**
+ * 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 declare function selectEligibleForGeneration(issues: IssueRow[], docsById: Map<string, ProposalDoc>): EligibleIssue[];
+export declare function listSeoProposals(db: PrentaDB): Promise<SeoProposalsPayload>;
+/**
+ * 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 declare function countPendingProposals(db: PrentaDB, openIssues: Array<{
+    metadata: unknown;
+}>): Promise<{
+    issueFixes: number;
+    redirects: number;
+}>;
+export {};
+//# sourceMappingURL=proposals.d.ts.map

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

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