@agentsean/scheduler 1.0.0

package/dist/backoff.js

@@ -0,0 +1,13 @@
+/** Exponential backoff: 1m, 5m, 25m, 2h05m, … capped at 6h. */
+export const BACKOFF_BASE_MS = 60_000;
+export const BACKOFF_FACTOR = 5;
+export const BACKOFF_CAP_MS = 6 * 60 * 60 * 1000;
+export const MAX_ATTEMPTS = 8;
+/** Crash recovery: a running job with a heartbeat older than this is requeued. */
+export const STALE_HEARTBEAT_MS = 5 * 60 * 1000;
+export function backoffMs(attempts) {
+    const exp = Math.max(0, attempts - 1);
+    const raw = BACKOFF_BASE_MS * BACKOFF_FACTOR ** exp;
+    return Math.min(BACKOFF_CAP_MS, raw);
+}
+//# sourceMappingURL=backoff.js.map

package/dist/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../src/backoff.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhD,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,eAAe,GAAG,cAAc,IAAI,GAAG,CAAC;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC"}

package/dist/cadence.d.ts

@@ -0,0 +1,16 @@
+import type { JobKind } from "./types.js";
+export declare const DAY_MS: number;
+export declare const WEEK_MS: number;
+/**
+ * Default cadences from PLAN Phase 4.
+ * Rank tracking is weekly: daily 200-keyword tracking is ~$3.60/mo (45% of $8).
+ */
+export declare const CADENCES: Record<JobKind, {
+    everyMs: number;
+    label: string;
+}>;
+export declare function isoWeek(now: Date): string;
+export declare function periodBucket(kind: JobKind, now: Date): string;
+export declare function idempotencyKey(siteId: string, kind: JobKind, now: Date): string;
+export declare function isJobKind(value: string): value is JobKind;
+//# sourceMappingURL=cadence.d.ts.map

package/dist/cadence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.d.ts","sourceRoot":"","sources":["../src/cadence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,MAAM,QAAsB,CAAC;AAC1C,eAAO,MAAM,OAAO,QAAa,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAUxE,CAAC;AAEF,wBAAgB,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CASzC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAI7D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAE/E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAEzD"}

package/dist/cadence.js

@@ -0,0 +1,40 @@
+import { JOB_KINDS } from "./types.js";
+export const DAY_MS = 24 * 60 * 60 * 1000;
+export const WEEK_MS = 7 * DAY_MS;
+/**
+ * Default cadences from PLAN Phase 4.
+ * Rank tracking is weekly: daily 200-keyword tracking is ~$3.60/mo (45% of $8).
+ */
+export const CADENCES = {
+    crawl: { everyMs: WEEK_MS, label: "weekly crawl" },
+    gsc_sync: { everyMs: DAY_MS, label: "daily GSC / GA4 sync" },
+    cwv: { everyMs: WEEK_MS, label: "weekly CrUX / PSI" },
+    rank_check: { everyMs: WEEK_MS, label: "weekly rank check" },
+    keywords: { everyMs: WEEK_MS, label: "weekly keyword clusters" },
+    content: { everyMs: DAY_MS, label: "daily content tasks (T2 cap)" },
+    measure: { everyMs: DAY_MS, label: "daily measurement / experiment analysis" },
+    surfaces: { everyMs: 30 * DAY_MS, label: "monthly AI visibility / local / mentions" },
+    plan_and_apply: { everyMs: DAY_MS, label: "plan and auto-apply T1/T2" },
+};
+export function isoWeek(now) {
+    const d = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
+    const day = d.getUTCDay() || 7;
+    d.setUTCDate(d.getUTCDate() + 4 - day);
+    const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    const week = Math.ceil(((d.getTime() - yearStart.getTime()) / DAY_MS + 1) / 7);
+    return `${d.getUTCFullYear()}-W${String(week).padStart(2, "0")}`;
+}
+export function periodBucket(kind, now) {
+    if (kind === "surfaces")
+        return now.toISOString().slice(0, 7);
+    if (CADENCES[kind].everyMs >= WEEK_MS)
+        return isoWeek(now);
+    return now.toISOString().slice(0, 10);
+}
+export function idempotencyKey(siteId, kind, now) {
+    return `${siteId}:${kind}:${periodBucket(kind, now)}`;
+}
+export function isJobKind(value) {
+    return JOB_KINDS.includes(value);
+}
+//# sourceMappingURL=cadence.js.map

package/dist/cadence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.js","sourceRoot":"","sources":["../src/cadence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAwD;IAC3E,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE;IAClD,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,EAAE;IAC5D,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACrD,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE;IAC5D,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,yBAAyB,EAAE;IAChE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,8BAA8B,EAAE;IACnE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,yCAAyC,EAAE;IAC9E,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,0CAA0C,EAAE;IACrF,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,EAAE;CACxE,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,GAAS;IAC/B,MAAM,CAAC,GAAG,IAAI,IAAI,CAChB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CACpE,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/E,OAAO,GAAG,CAAC,CAAC,cAAc,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,GAAS;IACnD,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,IAAa,EAAE,GAAS;IACrE,OAAO,GAAG,MAAM,IAAI,IAAI,IAAI,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAQ,SAA+B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/dist/handlers.d.ts

@@ -0,0 +1,17 @@
+import type { SqliteDatabase } from "@agentsean/db";
+import { type SiteAdapter } from "@agentsean/actions";
+import { crawlSite } from "@agentsean/crawler";
+import { syncGoogle } from "@agentsean/google";
+import type { CredentialStore } from "@agentsean/credentials";
+import type { JobHandler, JobKind } from "./types.js";
+export type HandlerDeps = {
+    db: SqliteDatabase;
+    store?: CredentialStore | undefined;
+    fetch?: typeof fetch | undefined;
+    approvalKey: Buffer;
+    crawlImpl?: typeof crawlSite | undefined;
+    syncImpl?: typeof syncGoogle | undefined;
+    adapterFor?: ((siteId: string) => SiteAdapter | null) | undefined;
+};
+export declare function createHandlers(deps: HandlerDeps): Record<JobKind, JobHandler>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,SAAS,EAIV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAmB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgB9D,OAAO,KAAK,EAAuB,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAS3E,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,SAAS,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,UAAU,GAAG,SAAS,CAAC;IACzC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CACnE,CAAC;AAiLF,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAoJ7E"}

package/dist/handlers.js

@@ -0,0 +1,337 @@
+import { eq } from "drizzle-orm";
+import { findings, gscConnections, pages, settings, sites } from "@agentsean/db";
+import { executeAction, loadGitConnection, planTitleActions, saveAction, } from "@agentsean/actions";
+import { createGitAdapter } from "@agentsean/adapter-git";
+import { adapterForSite } from "@agentsean/adapter-factory";
+import { buildReport, flattenForDb } from "@agentsean/analyzers";
+import { crawlSite, persistCrawl, persistFindings, } from "@agentsean/crawler";
+import { loadAuditExtras, syncGoogle } from "@agentsean/google";
+import { loadLlmConfig } from "@agentsean/llm";
+import { runContentJob } from "@agentsean/content";
+import { createBingClient, createProviderStack, loadProviderKeys, } from "@agentsean/providers";
+import { createHashEmbeddings, loadGscQueries, runKeywordsJob, runRankCheck, } from "@agentsean/keywords";
+import { runMeasureJob } from "@agentsean/measure";
+import { runSurfacesJob } from "@agentsean/surfaces";
+function settingNumber(db, key, fallback) {
+    const raw = db.select().from(settings).where(eq(settings.key, key)).get()?.value;
+    if (raw === undefined || raw === null)
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : fallback;
+}
+function originOf(job, db) {
+    const fromPayload = job.payload["origin"];
+    if (typeof fromPayload === "string")
+        return fromPayload;
+    if (!job.siteId)
+        return null;
+    return db.select().from(sites).where(eq(sites.id, job.siteId)).get()?.origin ?? null;
+}
+function defaultAdapterFor(deps) {
+    return (siteId) => {
+        if (deps.adapterFor)
+            return deps.adapterFor(siteId);
+        try {
+            return adapterForSite(deps.db, siteId, deps.fetch ? { fetch: deps.fetch } : undefined);
+        }
+        catch {
+            const cfg = loadGitConnection(deps.db, siteId) ?? {};
+            const repoPath = typeof cfg["repoPath"] === "string" ? cfg["repoPath"] : null;
+            if (!repoPath)
+                return null;
+            const token = typeof cfg["token"] === "string" ? cfg["token"] : undefined;
+            return createGitAdapter({
+                repoPath,
+                ...(token ? { token } : {}),
+                ...(deps.fetch ? { fetch: deps.fetch } : {}),
+            });
+        }
+    };
+}
+async function handleCrawl(deps, job, ctx) {
+    const origin = originOf(job, deps.db);
+    if (!origin)
+        throw new Error("crawl job missing origin");
+    const resumeRaw = job.payload["checkpoint"];
+    const resume = resumeRaw && typeof resumeRaw === "object"
+        ? resumeRaw
+        : undefined;
+    const maxPages = typeof job.payload["maxPages"] === "number" ? job.payload["maxPages"] : 5000;
+    const crawlId = typeof job.payload["crawlId"] === "string" ? job.payload["crawlId"] : undefined;
+    const crawl = deps.crawlImpl ?? crawlSite;
+    const result = await crawl({
+        startUrl: origin,
+        maxPages,
+        render: job.payload["render"] !== false,
+        ...(resume ? { resume } : {}),
+        onCheckpoint: (cp) => {
+            ctx.checkpoint({ checkpoint: cp });
+        },
+        checkpointEvery: 10,
+    });
+    const persisted = await persistCrawl(deps.db, result, undefined, {
+        ...(crawlId ? { crawlId } : {}),
+        status: result.aborted || result.truncated ? "running" : "complete",
+    });
+    ctx.checkpoint({ checkpoint: result.checkpoint, crawlId: persisted.crawlId });
+    if (result.aborted || result.truncated) {
+        throw new Error(result.aborted ? "crawl aborted; will resume" : "crawl truncated; will resume");
+    }
+    const extras = loadAuditExtras(deps.db, persisted.siteId);
+    const elapsedMs = Date.parse(result.finishedAt) - Date.parse(result.startedAt);
+    const report = buildReport(result, Number.isFinite(elapsedMs) ? elapsedMs : 0, extras);
+    persistFindings(deps.db, persisted.siteId, flattenForDb(persisted.siteId, report.findings));
+    const scoreKey = `score:${persisted.siteId}`;
+    const scoreJson = JSON.stringify({
+        value: report.score.value,
+        version: report.score.version,
+        band: report.score.band,
+    });
+    const existingScore = deps.db
+        .select()
+        .from(settings)
+        .where(eq(settings.key, scoreKey))
+        .get();
+    const ts = new Date().toISOString();
+    if (existingScore) {
+        deps.db
+            .update(settings)
+            .set({ value: scoreJson, updatedAt: ts })
+            .where(eq(settings.key, scoreKey))
+            .run();
+    }
+    else {
+        deps.db
+            .insert(settings)
+            .values({ key: scoreKey, value: scoreJson, updatedAt: ts })
+            .run();
+    }
+    if (!ctx.halted) {
+        await planAndMaybeApply(deps, persisted.siteId, origin, ctx.halted, ctx.now);
+    }
+    return {
+        siteId: persisted.siteId,
+        crawlId: persisted.crawlId,
+        pages: result.pagesSeen,
+        findings: report.findings.length,
+        score: report.score.value,
+    };
+}
+async function planAndMaybeApply(deps, siteId, origin, halted, now) {
+    const pageRows = deps.db.select().from(pages).where(eq(pages.siteId, siteId)).all();
+    const findingRows = deps.db
+        .select()
+        .from(findings)
+        .where(eq(findings.siteId, siteId))
+        .all();
+    const planned = planTitleActions({
+        siteId,
+        origin,
+        pages: pageRows.map((p) => ({
+            id: p.id,
+            url: p.url,
+            title: p.title,
+            metaDescription: p.metaDescription,
+            h1: p.h1,
+        })),
+        findings: findingRows.map((f) => ({
+            id: f.id,
+            siteId: f.siteId,
+            pageId: f.pageId,
+            ruleId: f.ruleId,
+            status: f.status,
+        })),
+    });
+    const adapter = defaultAdapterFor(deps)(siteId);
+    let applied = 0;
+    let queued = 0;
+    let rejected = 0;
+    let runApplied = 0;
+    for (const action of planned) {
+        if (!adapter) {
+            saveAction(deps.db, action, action.tier >= 3 ? "queued" : "proposed");
+            if (action.tier >= 3)
+                queued++;
+            continue;
+        }
+        const result = await executeAction({
+            db: deps.db,
+            action,
+            adapter,
+            approvalKey: deps.approvalKey,
+            halted,
+            now,
+            appliedThisRun: runApplied,
+        });
+        if (result.status === "applied") {
+            applied++;
+            runApplied++;
+        }
+        else if (result.status === "queued")
+            queued++;
+        else
+            rejected++;
+    }
+    return { planned: planned.length, applied, queued, rejected };
+}
+export function createHandlers(deps) {
+    return {
+        async crawl(job, ctx) {
+            ctx.heartbeat();
+            return handleCrawl(deps, job, ctx);
+        },
+        async gsc_sync(job, ctx) {
+            ctx.heartbeat();
+            if (!deps.store || !job.siteId)
+                return { skipped: true, reason: "no_google_store" };
+            const connected = deps.db
+                .select()
+                .from(gscConnections)
+                .where(eq(gscConnections.siteId, job.siteId))
+                .get();
+            if (!connected)
+                return { skipped: true, reason: "gsc_not_connected" };
+            const sync = deps.syncImpl ?? syncGoogle;
+            return sync({
+                db: deps.db,
+                store: deps.store,
+                siteId: job.siteId,
+                ...(deps.fetch ? { fetch: deps.fetch } : {}),
+            });
+        },
+        async cwv(job, ctx) {
+            ctx.heartbeat();
+            if (!deps.store || !job.siteId)
+                return { skipped: true, reason: "no_google_store" };
+            const sync = deps.syncImpl ?? syncGoogle;
+            return sync({
+                db: deps.db,
+                store: deps.store,
+                siteId: job.siteId,
+                runPsiAudit: true,
+                ...(deps.fetch ? { fetch: deps.fetch } : {}),
+            });
+        },
+        async rank_check(job, ctx) {
+            ctx.heartbeat();
+            if (!job.siteId)
+                return { skipped: true, reason: "no_site" };
+            const origin = originOf(job, deps.db);
+            if (!origin)
+                return { skipped: true, reason: "no_origin" };
+            const keys = await loadProviderKeys(deps.store);
+            const gsc = loadGscQueries(deps.db, job.siteId);
+            const stack = createProviderStack({
+                keys,
+                gsc: gsc.map((r) => ({
+                    query: r.query,
+                    source: "gsc",
+                    clicks: r.clicks,
+                    impressions: r.impressions,
+                    position: r.position,
+                })),
+                ...(deps.fetch ? { fetch: deps.fetch } : {}),
+            });
+            const queries = [...new Set(gsc.map((r) => r.query))].slice(0, 50);
+            return runRankCheck({
+                db: deps.db,
+                siteId: job.siteId,
+                origin,
+                queries,
+                stack,
+                now: ctx.now,
+                dailyBudgetUsd: settingNumber(deps.db, "budgetUsdDaily", 8),
+            });
+        },
+        async keywords(job, ctx) {
+            ctx.heartbeat();
+            if (!job.siteId)
+                return { skipped: true, reason: "no_site" };
+            const origin = originOf(job, deps.db);
+            if (!origin)
+                return { skipped: true, reason: "no_origin" };
+            const keys = await loadProviderKeys(deps.store);
+            const gsc = loadGscQueries(deps.db, job.siteId);
+            const stack = createProviderStack({
+                keys,
+                gsc: gsc.map((r) => ({
+                    query: r.query,
+                    source: "gsc",
+                    clicks: r.clicks,
+                    impressions: r.impressions,
+                    position: r.position,
+                })),
+                ...(deps.fetch ? { fetch: deps.fetch } : {}),
+            });
+            const bing = keys.bing
+                ? createBingClient({
+                    apiKey: keys.bing,
+                    ...(deps.fetch ? { fetch: deps.fetch } : {}),
+                })
+                : null;
+            return runKeywordsJob(deps.db, {
+                siteId: job.siteId,
+                origin,
+                now: ctx.now,
+                stack,
+                gsc,
+                embeddings: createHashEmbeddings(),
+                dailyBudgetUsd: settingNumber(deps.db, "budgetUsdDaily", 8),
+                ...(bing ? { expand: (seed) => bing.getRelatedKeywords(seed) } : {}),
+            });
+        },
+        async measure(job, ctx) {
+            ctx.heartbeat();
+            if (!job.siteId)
+                return { skipped: true, reason: "no_site" };
+            return runMeasureJob(deps.db, { siteId: job.siteId, now: ctx.now });
+        },
+        async surfaces(job, ctx) {
+            ctx.heartbeat();
+            if (!job.siteId)
+                return { skipped: true, reason: "no_site" };
+            const origin = originOf(job, deps.db);
+            if (!origin)
+                return { skipped: true, reason: "no_origin" };
+            const llm = await loadLlmConfig({
+                ...(deps.store ? { store: deps.store } : {}),
+                ...(deps.fetch ? { fetch: deps.fetch } : {}),
+            });
+            return runSurfacesJob(deps.db, {
+                siteId: job.siteId,
+                origin,
+                now: ctx.now,
+                ...(llm?.generate ? { generate: llm.generate } : {}),
+            });
+        },
+        async content(job, ctx) {
+            ctx.heartbeat();
+            if (!job.siteId)
+                return { skipped: true, reason: "no_site" };
+            const origin = originOf(job, deps.db);
+            if (!origin)
+                return { skipped: true, reason: "no_origin" };
+            const llm = await loadLlmConfig({
+                ...(deps.store ? { store: deps.store } : {}),
+                ...(deps.fetch ? { fetch: deps.fetch } : {}),
+            });
+            return runContentJob(deps.db, {
+                siteId: job.siteId,
+                origin,
+                now: ctx.now,
+                halted: ctx.halted,
+                llm,
+                adapter: defaultAdapterFor(deps)(job.siteId),
+                approvalKey: deps.approvalKey,
+            });
+        },
+        async plan_and_apply(job, ctx) {
+            ctx.heartbeat();
+            const origin = originOf(job, deps.db);
+            if (!origin || !job.siteId)
+                throw new Error("plan_and_apply missing site");
+            return planAndMaybeApply(deps, job.siteId, origin, ctx.halted, ctx.now);
+        },
+    };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { JOB_KINDS, JOB_STATUSES, type JobKind, type JobStatus, type Job, type JobPayload, type JobQueue, type EnqueueInput, type JobHandler, type HandlerContext, type Clock, } from "./types.js";
+export { CADENCES, DAY_MS, WEEK_MS, isoWeek, periodBucket, idempotencyKey, isJobKind, } from "./cadence.js";
+export { backoffMs, BACKOFF_BASE_MS, BACKOFF_FACTOR, BACKOFF_CAP_MS, MAX_ATTEMPTS, STALE_HEARTBEAT_MS, } from "./backoff.js";
+export { createSqliteQueue, parseJobKind, type SqliteQueueOptions, } from "./sqlite-queue.js";
+export { createPgBossQueue, assertJobKind, type PgBossLike } from "./pg-boss.js";
+export { tick, runDue, ensureCadences, startLoop, type TickResult } from "./runner.js";
+export { createHandlers, type HandlerDeps } from "./handlers.js";
+export { computeGscInsights, brandTermsFromOrigin, impressionsWindowContaminated, type GscInsights, type PageDaily, type QueryDaily, type DayTotal, } from "./insights.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,GAAG,EACR,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,KAAK,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,cAAc,EACd,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,EAC7B,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { JOB_KINDS, JOB_STATUSES, } from "./types.js";
+export { CADENCES, DAY_MS, WEEK_MS, isoWeek, periodBucket, idempotencyKey, isJobKind, } from "./cadence.js";
+export { backoffMs, BACKOFF_BASE_MS, BACKOFF_FACTOR, BACKOFF_CAP_MS, MAX_ATTEMPTS, STALE_HEARTBEAT_MS, } from "./backoff.js";
+export { createSqliteQueue, parseJobKind, } from "./sqlite-queue.js";
+export { createPgBossQueue, assertJobKind } from "./pg-boss.js";
+export { tick, runDue, ensureCadences, startLoop } from "./runner.js";
+export { createHandlers } from "./handlers.js";
+export { computeGscInsights, brandTermsFromOrigin, impressionsWindowContaminated, } from "./insights.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,GAUb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,cAAc,EACd,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,GAEb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,cAAc,EAAoB,MAAM,eAAe,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,GAK9B,MAAM,eAAe,CAAC"}

package/dist/insights.d.ts

@@ -0,0 +1,61 @@
+/** GSC insights for the Search performance screen. Default metric is clicks. */
+export type PageDaily = {
+    date: string;
+    page: string;
+    clicks: number;
+    impressions: number;
+    position: number | null;
+};
+export type QueryDaily = {
+    date: string;
+    query: string;
+    clicks: number;
+    impressions: number;
+    position: number | null;
+};
+export type DayTotal = {
+    date: string;
+    clicks: number;
+    impressions: number;
+};
+export type GscInsights = {
+    metric: "clicks";
+    impressionsContaminated: boolean;
+    strikingDistance: Array<{
+        page: string;
+        clicks: number;
+        position: number;
+    }>;
+    decay: {
+        previousClicks: number;
+        currentClicks: number;
+        delta: number;
+        deltaPct: number | null;
+    };
+    cannibalization: Array<{
+        query: string;
+        pages: string[];
+    }>;
+    cannibalizationNote: string;
+    ctrOutliers: Array<{
+        query: string;
+        clicks: number;
+        impressions: number;
+        ctr: number;
+    }>;
+    brand: {
+        brandClicks: number;
+        nonBrandClicks: number;
+        brandShare: number | null;
+    };
+};
+export declare function impressionsWindowContaminated(dates: string[]): boolean;
+export declare function computeGscInsights(opts: {
+    pages: PageDaily[];
+    queries: QueryDaily[];
+    days: DayTotal[];
+    brandTerms: string[];
+    now?: Date | undefined;
+}): GscInsights;
+export declare function brandTermsFromOrigin(origin: string): string[];
+//# sourceMappingURL=insights.d.ts.map

package/dist/insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../src/insights.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,uBAAuB,EAAE,OAAO,CAAC;IACjC,gBAAgB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,KAAK,EAAE;QACL,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,eAAe,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACnF,CAAC;AAKF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAEtE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACxB,GAAG,WAAW,CA4Fd;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7D"}