feat(server): unified scheduled-job registry and scheduler; module timers moved onto it

- modules/schedules: registerScheduledJob({key, defaults, run}) registry; defaults are
  synced into scheduled_job without overriding user-changed enabled/schedule
- scheduler runs only on the io worker, one instance via pg_try_advisory_lock held on a
  dedicated connection; due = enabled and next_run_at reached, or run requested;
  jobs run in parallel, never re-entrant; interval next = finish + period, cron next match;
  run-now does not move next_run_at and merges duplicate requests; skip advances one period;
  history trimmed to the last 50 runs; interrupted runs marked failed on takeover
- agent_check jobs: trigger condition checked first, goal template rendered, runAgent
  enqueued via startRun(trigger=schedule) with allowlist and budget, one run per time slot;
  allowRecover uses the autoInvestigate grant check; results harvested back into the run
  history and optionally reported as an info decision; 3 built-in checks, off by default
- sources-identity (feeds.poll, sites.snapshot, identity.review), acquisition-organize
  (downloads.sync, cache.threshold, downloads.orchestrate, slots.reevaluate,
  subscriptions.search, subscriptions.metadata, library.reconcile) and file-manager
  (trash.purge) register jobs instead of running their own setInterval; default
  intervals unchanged; backup registered as an unconfigured placeholder
- endpoints under /schedules (admin, console session only)

TODO: pi refreshPiTokens and auth-settings session cleanup still own their timers.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

apps/server/src/modules/sources-identity/index.ts

@@ -1,3 +1,4 @@
+import { registerScheduledJob } from "../schedules/registry.ts";
 import type { ServerContext, ServerModule } from "../types.ts";
 import { registerSourcesCapabilities } from "./capabilities.ts";
 import { decisionRoutes } from "./routes/decisions.ts";
@@ -5,7 +6,7 @@ import { identityRoutes } from "./routes/identity.ts";
 import { sourcesRoutes } from "./routes/sources.ts";
 import { workbenchRoutes } from "./routes/workbench.ts";
 import { type RuntimeOverrides, SourcesRuntime } from "./runtime.ts";
-import { schedulerTick } from "./scheduler.ts";
+import { readOnlyReconcile, tickFeeds, tickReviews, tickSnapshots } from "./scheduler.ts";
 import { registerSourcesTasks, sourcesOutboxRoutes } from "./tasks.ts";
 
 /**
@@ -25,8 +26,6 @@ export function createSourcesIdentityModule(overrides: RuntimeOverrides = {}): S
     }
     return rt;
   };
-  let timer: ReturnType<typeof setInterval> | null = null;
-  let ticking: Promise<unknown> | null = null;
 
   return {
     name: "sources-identity",
@@ -45,23 +44,22 @@ export function createSourcesIdentityModule(overrides: RuntimeOverrides = {}): S
     registerCapabilities(registry, ctx) {
       registerSourcesCapabilities(registry, () => runtime(ctx));
     },
+    /** 周期扫描登记到定时任务注册表(schedules 模块的调度器驱动);周期是总扫描频率 */
     start(ctx) {
       const rt = runtime(ctx);
-      const tick = () => {
-        if (ticking) return;
-        ticking = schedulerTick(rt)
-          .catch((err) => ctx.logger.warn({ err }, "sources-identity 调度失败"))
-          .finally(() => {
-            ticking = null;
-          });
-      };
-      timer = setInterval(tick, overrides.schedulerIntervalMs ?? 30_000);
-      tick();
-    },
-    async stop() {
-      if (timer) clearInterval(timer);
-      timer = null;
-      await ticking;
+      const everyMs = overrides.schedulerIntervalMs ?? 30_000;
+      const job = (key: string, name: string, description: string, fn: (rt: SourcesRuntime) => Promise<number>) =>
+        registerScheduledJob(ctx, {
+          key,
+          defaults: { name, description, group: "collect", schedule: { type: "interval", everyMs } },
+          run: async () => {
+            if (await readOnlyReconcile(rt)) return { status: "skipped", summary: "只读对账模式" };
+            return { summary: `${await fn(rt)} 项` };
+          },
+        });
+      job("feeds.poll", "Feed 轮询", "扫描到期的 Feed 并入队抓取(每个 Feed 仍按自己的轮询间隔)", tickFeeds);
+      job("sites.snapshot", "站点快照", "扫描到周期的站点并入队快照", tickSnapshots);
+      job("identity.review", "待识别复查", "到期的待识别条目重新识别", tickReviews);
     },
   };
 }