@cat-factory/node-server 0.92.7 → 0.92.8

package/dist/environments.d.ts

@@ -1,9 +1,9 @@
 import type { Clock } from '@cat-factory/kernel';
 import type { Logger, ServerContainer } from '@cat-factory/server';
 /**
- * Start the periodic environment TTL sweep. Runs once immediately then on a timer.
- * Best-effort: a failed sweep is logged and retried next tick, never thrown. Returns a
- * stop function that clears the timer.
+ * Start the periodic environment TTL sweep. Runs once immediately then on the interval,
+ * non-overlapping + best-effort (see {@link startSweeper}). Returns a stop function that
+ * clears the timer.
  */
 export declare function startEnvironmentSweeper(container: ServerContainer, clock: Clock, log: Logger): () => void;
 //# sourceMappingURL=environments.d.ts.map

package/dist/environments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAUlE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAkBZ"}
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAWlE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAaZ"}

package/dist/environments.js

@@ -1,3 +1,4 @@
+import { startSweeper } from './sweeper.js';
 // Periodic ephemeral-environment TTL teardown for the Node facade — the analogue of
 // the Worker's every-2-min cron call to `sweepExpiredEnvironments`. The Node service
 // has no cron, so a timer destroys environments whose expiry has elapsed. No-op when
@@ -5,27 +6,24 @@
 /** How often the Node service tears down expired environments. */
 const ENVIRONMENT_SWEEP_INTERVAL_MS = 2 * 60 * 1000;
 /**
- * Start the periodic environment TTL sweep. Runs once immediately then on a timer.
- * Best-effort: a failed sweep is logged and retried next tick, never thrown. Returns a
- * stop function that clears the timer.
+ * Start the periodic environment TTL sweep. Runs once immediately then on the interval,
+ * non-overlapping + best-effort (see {@link startSweeper}). Returns a stop function that
+ * clears the timer.
  */
 export function startEnvironmentSweeper(container, clock, log) {
     const environments = container.environments;
     if (!environments)
         return () => { };
-    const tick = async () => {
-        try {
+    return startSweeper({
+        name: 'environment-ttl',
+        intervalMs: ENVIRONMENT_SWEEP_INTERVAL_MS,
+        log,
+        failureMessage: 'environment TTL sweep failed',
+        tick: async () => {
             const torn = await environments.teardownService.sweepExpired(clock.now());
             if (torn > 0)
                 log.info({ torn }, 'tore down expired environments');
-        }
-        catch (error) {
-            log.error({ err: error instanceof Error ? error.message : String(error) }, 'environment TTL sweep failed');
-        }
-    };
-    void tick();
-    const timer = setInterval(() => void tick(), ENVIRONMENT_SWEEP_INTERVAL_MS);
-    timer.unref?.();
-    return () => clearInterval(timer);
+        },
+    });
 }
 //# sourceMappingURL=environments.js.map

package/dist/environments.js.map

@@ -1 +1 @@
-{"version":3,"file":"environments.js","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAGA,oFAAoF;AACpF,qFAAqF;AACrF,qFAAqF;AACrF,yFAAyF;AAEzF,kEAAkE;AAClE,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAEnD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAA0B,EAC1B,KAAY,EACZ,GAAW;IAEX,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAA;IAC3C,IAAI,CAAC,YAAY;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YACzE,IAAI,IAAI,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,gCAAgC,CAAC,CAAA;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CACP,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/D,8BAA8B,CAC/B,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IACD,KAAK,IAAI,EAAE,CAAA;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,6BAA6B,CAAC,CAAA;IAC3E,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IACf,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"environments.js","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,oFAAoF;AACpF,qFAAqF;AACrF,qFAAqF;AACrF,yFAAyF;AAEzF,kEAAkE;AAClE,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAEnD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAA0B,EAC1B,KAAY,EACZ,GAAW;IAEX,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAA;IAC3C,IAAI,CAAC,YAAY;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAClC,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,iBAAiB;QACvB,UAAU,EAAE,6BAA6B;QACzC,GAAG;QACH,cAAc,EAAE,8BAA8B;QAC9C,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YACzE,IAAI,IAAI,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,gCAAgC,CAAC,CAAA;QACpE,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/githubReconcile.d.ts

@@ -1,24 +1,9 @@
-import type { Clock, GitHubInstallationRepository, RepoProjectionRepository } from '@cat-factory/kernel';
-import type { Logger } from '@cat-factory/server';
-/** A projection not synced for this long is considered stale (matches the Worker). */
-export declare const GITHUB_RECONCILE_STALE_MS: number;
-/** The seams the reconcile pass drives (kept narrow so it is unit-testable with fakes). */
-export interface GitHubReconcileDeps {
-    repoProjectionRepository: Pick<RepoProjectionRepository, 'listStale'>;
-    installationRepository: Pick<GitHubInstallationRepository, 'softDelete'>;
-    /** The GitHub module's incremental per-repo resync (`GitHubSyncService.syncRepoById`). */
-    syncRepoById: (workspaceId: string, repoGithubId: number) => Promise<void>;
-}
-/**
- * One reconcile pass: re-sync every stale repo projection, tombstoning installations
- * that are gone. Best-effort per repo — one failure must not abort the rest. Returns
- * the number of repos successfully re-synced.
- */
-export declare function reconcileStaleRepos(deps: GitHubReconcileDeps, clock: Clock, staleMs: number, log: Logger): Promise<number>;
+import type { Clock } from '@cat-factory/kernel';
+import { type GitHubReconcileDeps, type Logger } from '@cat-factory/server';
 /**
  * Start the periodic reconcile sweep. Runs once immediately then on the two-minute
- * timer. Best-effort: a failed pass is logged and retried next tick, never thrown.
- * Returns a stop function that clears the timer.
+ * timer, non-overlapping + best-effort (see {@link startSweeper}). Returns a stop
+ * function that clears the timer.
  */
 export declare function startGitHubReconcileSweeper(deps: GitHubReconcileDeps, clock: Clock, log: Logger): () => void;
 //# sourceMappingURL=githubReconcile.d.ts.map

package/dist/githubReconcile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"githubReconcile.d.ts","sourceRoot":"","sources":["../src/githubReconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAcjD,sFAAsF;AACtF,eAAO,MAAM,yBAAyB,QAAiB,CAAA;AAEvD,2FAA2F;AAC3F,MAAM,WAAW,mBAAmB;IAClC,wBAAwB,EAAE,IAAI,CAAC,wBAAwB,EAAE,WAAW,CAAC,CAAA;IACrE,sBAAsB,EAAE,IAAI,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAA;IACxE,0FAA0F;IAC1F,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAuBZ"}
+{"version":3,"file":"githubReconcile.d.ts","sourceRoot":"","sources":["../src/githubReconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,MAAM,EAEZ,MAAM,qBAAqB,CAAA;AAc5B;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAWZ"}

package/dist/githubReconcile.js

@@ -1,115 +1,30 @@
+import { GITHUB_RECONCILE_STALE_MS, reconcileStaleRepos, } from '@cat-factory/server';
+import { startSweeper } from './sweeper.js';
 // Periodic GitHub reconciliation for the Node facade — the analogue of the Worker's
-// every-2-min `github-reconcile` cron (`infrastructure/github/sync-consumer.ts`'s
-// `reconcileStaleRepos`). Webhooks are the primary sync path but can be missed (a
-// delivery outage, a restart mid-delivery), so this backstop re-syncs every tracked
-// repo whose projection has gone stale — without it a dropped webhook leaves the
-// branch/PR/issue/check-run projections stale forever. It also tombstones an
-// installation whose uninstall webhook never arrived, so its repos stop being swept.
-// The Worker enqueues resyncs when a queue is bound; Node has no queue, so it uses
-// the Worker's direct-sync fallback path (`syncService.syncRepoById`) inline.
+// every-2-min `github-reconcile` cron. Webhooks are the primary sync path but can be
+// missed (a delivery outage, a restart mid-delivery), so this backstop re-syncs every
+// tracked repo whose projection has gone stale. The reconcile pass itself lives in the
+// shared `@cat-factory/server` `reconcileStaleRepos` (so it can't drift from the Worker);
+// this file supplies only the Node driver — a direct inline resync (Node has no queue).
+// The pass itself is unit-tested in `@cat-factory/server` (one test for one implementation).
 /** How often the reconcile pass runs (matches the Worker's frequent cron). */
 const GITHUB_RECONCILE_INTERVAL_MS = 2 * 60 * 1000;
-/** A projection not synced for this long is considered stale (matches the Worker). */
-export const GITHUB_RECONCILE_STALE_MS = 30 * 60 * 1000;
-/**
- * One reconcile pass: re-sync every stale repo projection, tombstoning installations
- * that are gone. Best-effort per repo — one failure must not abort the rest. Returns
- * the number of repos successfully re-synced.
- */
-export async function reconcileStaleRepos(deps, clock, staleMs, log) {
-    // `listStale` already excludes repos whose installation is tombstoned, so a dead
-    // installation stops being swept once it is known-gone; the handling below tombstones
-    // one the webhook never told us about (a missed uninstall), so it stops next pass.
-    const stale = await deps.repoProjectionRepository.listStale(clock.now() - staleMs);
-    let synced = 0;
-    for (const repo of stale) {
-        try {
-            await deps.syncRepoById(repo.workspaceId, repo.githubId);
-            synced += 1;
-        }
-        catch (error) {
-            // Best-effort pass (webhooks are the primary path): a gone/forbidden GitHub App
-            // installation (uninstalled or revoked → 401/404 when minting its token) is an
-            // expected operational state for a stale projection, so log it at warn; any
-            // other fault is a real error. Either way, continue with the next repo.
-            const gone = isInstallationGoneError(error);
-            // A token-mint 404/410 means the installation itself is gone — uninstalled or
-            // revoked without us receiving the webhook. Tombstone it so this and every future
-            // pass skip ALL its repos until it is reinstalled (the `unsuspend`/reinstall
-            // webhook clears the tombstone). Scoped to the mint error (not a repo-level 404,
-            // which means a single deleted repo) and to 404/410 (never 401, which can be a
-            // transient app-JWT fault hitting everything).
-            if (isInstallationTokenGoneError(error)) {
-                try {
-                    await deps.installationRepository.softDelete(repo.installationId, clock.now());
-                }
-                catch {
-                    // Best-effort: a failed tombstone just means we retry (and warn) next pass.
-                }
-            }
-            log[gone ? 'warn' : 'error']({
-                sweeper: 'github-reconcile',
-                workspaceId: repo.workspaceId,
-                repoGithubId: repo.githubId,
-                installationId: repo.installationId,
-                err: error instanceof Error ? error.message : String(error),
-            }, gone
-                ? 'skipping stale repo whose GitHub App installation is gone (uninstalled/revoked); reinstall the app to re-enable it'
-                : 'repo resync failed');
-        }
-    }
-    return synced;
-}
 /**
  * Start the periodic reconcile sweep. Runs once immediately then on the two-minute
- * timer. Best-effort: a failed pass is logged and retried next tick, never thrown.
- * Returns a stop function that clears the timer.
+ * timer, non-overlapping + best-effort (see {@link startSweeper}). Returns a stop
+ * function that clears the timer.
  */
 export function startGitHubReconcileSweeper(deps, clock, log) {
-    let running = false;
-    const tick = async () => {
-        // Skip if the previous pass is still in flight: a pass re-syncing many repos can
-        // outlast the interval, and setInterval would otherwise stack overlapping passes.
-        if (running)
-            return;
-        running = true;
-        try {
+    return startSweeper({
+        name: 'github-reconcile',
+        intervalMs: GITHUB_RECONCILE_INTERVAL_MS,
+        log,
+        failureMessage: 'github reconcile sweep failed',
+        tick: async () => {
             const synced = await reconcileStaleRepos(deps, clock, GITHUB_RECONCILE_STALE_MS, log);
             if (synced > 0)
                 log.info({ synced }, 'reconciled stale github repo projections');
-        }
-        catch (error) {
-            log.error({ err: error instanceof Error ? error.message : String(error) }, 'github reconcile sweep failed');
-        }
-        finally {
-            running = false;
-        }
-    };
-    void tick();
-    const timer = setInterval(() => void tick(), GITHUB_RECONCILE_INTERVAL_MS);
-    timer.unref?.();
-    return () => clearInterval(timer);
-}
-/**
- * Whether a sync error is a *gone/forbidden GitHub App installation* rather than a
- * transient fault: minting an installation token for an uninstalled or revoked
- * installation returns 401/404 (and a deleted repo 404/410). These are not worth
- * an error-level log or a retry storm — the connection needs human action.
- * (Mirrors the Worker's `sync-consumer.ts` classification.)
- */
-function isInstallationGoneError(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return /\(HTTP (401|404|410)\)/.test(message);
-}
-/**
- * Whether the error is specifically a *token mint* returning 404/410 — i.e. the
- * installation itself is gone (uninstalled/revoked), not merely a single repo
- * being inaccessible. Matches the App registry's mint-failure message. Excludes 401
- * (a transient app-JWT/clock fault would mint-fail for every installation, and must
- * not tombstone a healthy connection).
- */
-function isInstallationTokenGoneError(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return /Failed to mint installation token .*\(HTTP (404|410)\)/i.test(message);
+        },
+    });
 }
 //# sourceMappingURL=githubReconcile.js.map

package/dist/githubReconcile.js.map

@@ -1 +1 @@
-{"version":3,"file":"githubReconcile.js","sourceRoot":"","sources":["../src/githubReconcile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"githubReconcile.js","sourceRoot":"","sources":["../src/githubReconcile.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EAGzB,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,oFAAoF;AACpF,qFAAqF;AACrF,sFAAsF;AACtF,uFAAuF;AACvF,0FAA0F;AAC1F,wFAAwF;AACxF,6FAA6F;AAE7F,8EAA8E;AAC9E,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAElD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAyB,EACzB,KAAY,EACZ,GAAW;IAEX,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,4BAA4B;QACxC,GAAG;QACH,cAAc,EAAE,+BAA+B;QAC/C,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,yBAAyB,EAAE,GAAG,CAAC,CAAA;YACrF,IAAI,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,0CAA0C,CAAC,CAAA;QAClF,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/initiativeLoop.d.ts

@@ -15,8 +15,10 @@ import type { Logger, ServerContainer } from '@cat-factory/server';
 export declare function resolveSweepInterval(env?: NodeJS.ProcessEnv): number;
 /**
  * Start the periodic initiative-loop sweep. Runs once immediately then on the resolved interval
- * (default one minute; see {@link resolveSweepInterval}). Best-effort: a failed sweep is logged
- * and retried next tick, never thrown. Returns a stop function that clears the timer.
+ * (default one minute; see {@link resolveSweepInterval}), non-overlapping + best-effort (see
+ * {@link startSweeper}). The non-overlap guard matters most here: `runDue` reconciles spawned
+ * tasks and spawns the next wave, so two concurrent passes could both observe "no active run"
+ * and double-spawn. Returns a stop function that clears the timer.
  */
 export declare function startInitiativeLoopSweeper(container: ServerContainer, clock: Clock, log: Logger, intervalMs?: number): () => void;
 //# sourceMappingURL=initiativeLoop.d.ts.map

package/dist/initiativeLoop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initiativeLoop.d.ts","sourceRoot":"","sources":["../src/initiativeLoop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAWlE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIjF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAA+B,GAC1C,MAAM,IAAI,CAoBZ"}
+{"version":3,"file":"initiativeLoop.d.ts","sourceRoot":"","sources":["../src/initiativeLoop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAYlE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIjF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAA+B,GAC1C,MAAM,IAAI,CAeZ"}

package/dist/initiativeLoop.js

@@ -1,3 +1,4 @@
+import { startSweeper } from './sweeper.js';
 // Periodic initiative-execution-loop sweep for the Node facade — the analogue of the Worker's
 // every-2-min cron call to `initiatives.loop.runDue`. The Node service has no cron, so a timer
 // ticks every executing initiative (reconcile spawned tasks + spawn the next wave). Terminal
@@ -24,27 +25,26 @@ export function resolveSweepInterval(env = process.env) {
 }
 /**
  * Start the periodic initiative-loop sweep. Runs once immediately then on the resolved interval
- * (default one minute; see {@link resolveSweepInterval}). Best-effort: a failed sweep is logged
- * and retried next tick, never thrown. Returns a stop function that clears the timer.
+ * (default one minute; see {@link resolveSweepInterval}), non-overlapping + best-effort (see
+ * {@link startSweeper}). The non-overlap guard matters most here: `runDue` reconciles spawned
+ * tasks and spawns the next wave, so two concurrent passes could both observe "no active run"
+ * and double-spawn. Returns a stop function that clears the timer.
  */
 export function startInitiativeLoopSweeper(container, clock, log, intervalMs = resolveSweepInterval()) {
     const initiatives = container.initiatives;
     if (!initiatives)
         return () => { };
-    const tick = async () => {
-        try {
+    return startSweeper({
+        name: 'initiative-loop',
+        intervalMs,
+        log,
+        failureMessage: 'initiative-loop sweep failed',
+        tick: async () => {
             const { spawned, completed } = await initiatives.loop.runDue(clock.now());
             if (spawned > 0 || completed > 0) {
                 log.info({ spawned, completed }, 'ticked initiative loop');
             }
-        }
-        catch (error) {
-            log.error({ err: error instanceof Error ? error.message : String(error) }, 'initiative-loop sweep failed');
-        }
-    };
-    void tick();
-    const timer = setInterval(() => void tick(), intervalMs);
-    timer.unref?.();
-    return () => clearInterval(timer);
+        },
+    });
 }
 //# sourceMappingURL=initiativeLoop.js.map

package/dist/initiativeLoop.js.map

@@ -1 +1 @@
-{"version":3,"file":"initiativeLoop.js","sourceRoot":"","sources":["../src/initiativeLoop.ts"],"names":[],"mappings":"AAGA,8FAA8F;AAC9F,+FAA+F;AAC/F,6FAA6F;AAC7F,2FAA2F;AAC3F,kCAAkC;AAElC,4FAA4F;AAC5F,MAAM,iCAAiC,GAAG,EAAE,GAAG,IAAI,CAAA;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IACvE,MAAM,GAAG,GAAG,GAAG,CAAC,2BAA2B,CAAA;IAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iCAAiC,CAAA;AAC3F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAA0B,EAC1B,KAAY,EACZ,GAAW,EACX,UAAU,GAAW,oBAAoB,EAAE;IAE3C,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAA;IACzC,IAAI,CAAC,WAAW;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YACzE,IAAI,OAAO,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBACjC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,wBAAwB,CAAC,CAAA;YAC5D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CACP,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/D,8BAA8B,CAC/B,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IACD,KAAK,IAAI,EAAE,CAAA;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,UAAU,CAAC,CAAA;IACxD,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IACf,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"initiativeLoop.js","sourceRoot":"","sources":["../src/initiativeLoop.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,8FAA8F;AAC9F,+FAA+F;AAC/F,6FAA6F;AAC7F,2FAA2F;AAC3F,kCAAkC;AAElC,4FAA4F;AAC5F,MAAM,iCAAiC,GAAG,EAAE,GAAG,IAAI,CAAA;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IACvE,MAAM,GAAG,GAAG,GAAG,CAAC,2BAA2B,CAAA;IAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iCAAiC,CAAA;AAC3F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAA0B,EAC1B,KAAY,EACZ,GAAW,EACX,UAAU,GAAW,oBAAoB,EAAE;IAE3C,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAA;IACzC,IAAI,CAAC,WAAW;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjC,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,iBAAiB;QACvB,UAAU;QACV,GAAG;QACH,cAAc,EAAE,8BAA8B;QAC9C,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YACzE,IAAI,OAAO,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBACjC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,wBAAwB,CAAC,CAAA;YAC5D,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/kaizen.d.ts

@@ -1,9 +1,9 @@
 import type { Clock } from '@cat-factory/kernel';
 import type { Logger, ServerContainer } from '@cat-factory/server';
 /**
- * Start the periodic Kaizen grading sweep. Runs once immediately then on a one-minute
- * timer. Best-effort: a failed pass is logged and retried next tick, never thrown.
- * Returns a stop function that clears the timer.
+ * Start the periodic Kaizen grading sweep. Runs once immediately then on the interval,
+ * non-overlapping + best-effort (see {@link startSweeper}). Returns a stop function that
+ * clears the timer.
  */
 export declare function startKaizenSweeper(container: ServerContainer, clock: Clock, log: Logger): () => void;
 //# sourceMappingURL=kaizen.d.ts.map

package/dist/kaizen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kaizen.d.ts","sourceRoot":"","sources":["../src/kaizen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAclE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CA4BZ"}
+{"version":3,"file":"kaizen.d.ts","sourceRoot":"","sources":["../src/kaizen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAelE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAgBZ"}

package/dist/kaizen.js

@@ -1,3 +1,4 @@
+import { startSweeper } from './sweeper.js';
 // Periodic Kaizen grading sweep for the Node facade — the analogue of the Worker's
 // every-2-min cron call to `kaizen.service.runPending`. The engine only inserts
 // `scheduled` rows at run completion, so this timer does the actual LLM grading (and
@@ -9,36 +10,24 @@ const KAIZEN_STALE_MS = 10 * 60 * 1000;
 /** Max gradings to run per pass (each is an LLM call; keep the batch small). */
 const KAIZEN_SWEEP_BATCH = 5;
 /**
- * Start the periodic Kaizen grading sweep. Runs once immediately then on a one-minute
- * timer. Best-effort: a failed pass is logged and retried next tick, never thrown.
- * Returns a stop function that clears the timer.
+ * Start the periodic Kaizen grading sweep. Runs once immediately then on the interval,
+ * non-overlapping + best-effort (see {@link startSweeper}). Returns a stop function that
+ * clears the timer.
  */
 export function startKaizenSweeper(container, clock, log) {
     const kaizen = container.kaizen;
     if (!kaizen)
         return () => { };
-    let running = false;
-    const tick = async () => {
-        // Skip if the previous pass is still in flight: a batch of LLM gradings can outlast the
-        // interval, and setInterval would otherwise stack overlapping passes against the same rows.
-        if (running)
-            return;
-        running = true;
-        try {
+    return startSweeper({
+        name: 'kaizen',
+        intervalMs: KAIZEN_SWEEP_INTERVAL_MS,
+        log,
+        failureMessage: 'kaizen sweep failed',
+        tick: async () => {
             const processed = await kaizen.service.runPending(clock.now() - KAIZEN_STALE_MS, KAIZEN_SWEEP_BATCH);
             if (processed > 0)
                 log.info({ processed }, 'ran pending kaizen gradings');
-        }
-        catch (error) {
-            log.error({ err: error instanceof Error ? error.message : String(error) }, 'kaizen sweep failed');
-        }
-        finally {
-            running = false;
-        }
-    };
-    void tick();
-    const timer = setInterval(() => void tick(), KAIZEN_SWEEP_INTERVAL_MS);
-    timer.unref?.();
-    return () => clearInterval(timer);
+        },
+    });
 }
 //# sourceMappingURL=kaizen.js.map

package/dist/kaizen.js.map

@@ -1 +1 @@
-{"version":3,"file":"kaizen.js","sourceRoot":"","sources":["../src/kaizen.ts"],"names":[],"mappings":"AAGA,mFAAmF;AACnF,gFAAgF;AAChF,qFAAqF;AACrF,wFAAwF;AAExF,2FAA2F;AAC3F,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAC9C,uFAAuF;AACvF,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AACtC,gFAAgF;AAChF,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAE5B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA0B,EAC1B,KAAY,EACZ,GAAW;IAEX,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;IAC/B,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAC5B,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,wFAAwF;QACxF,4FAA4F;QAC5F,IAAI,OAAO;YAAE,OAAM;QACnB,OAAO,GAAG,IAAI,CAAA;QACd,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,CAC/C,KAAK,CAAC,GAAG,EAAE,GAAG,eAAe,EAC7B,kBAAkB,CACnB,CAAA;YACD,IAAI,SAAS,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,6BAA6B,CAAC,CAAA;QAC3E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CACP,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/D,qBAAqB,CACtB,CAAA;QACH,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,KAAK,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;IACD,KAAK,IAAI,EAAE,CAAA;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAA;IACtE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IACf,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"kaizen.js","sourceRoot":"","sources":["../src/kaizen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,mFAAmF;AACnF,gFAAgF;AAChF,qFAAqF;AACrF,wFAAwF;AAExF,2FAA2F;AAC3F,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAC9C,uFAAuF;AACvF,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AACtC,gFAAgF;AAChF,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAE5B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA0B,EAC1B,KAAY,EACZ,GAAW;IAEX,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;IAC/B,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAC5B,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,wBAAwB;QACpC,GAAG;QACH,cAAc,EAAE,qBAAqB;QACrC,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,CAC/C,KAAK,CAAC,GAAG,EAAE,GAAG,eAAe,EAC7B,kBAAkB,CACnB,CAAA;YACD,IAAI,SAAS,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,6BAA6B,CAAC,CAAA;QAC3E,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/notifications.d.ts

@@ -1,9 +1,9 @@
 import type { Clock } from '@cat-factory/kernel';
 import { type Logger, type ServerContainer } from '@cat-factory/server';
 /**
- * Start the periodic notification-escalation sweep. Runs once immediately then on a
- * one-minute timer. Best-effort: a failed sweep is logged and retried next tick, never
- * thrown. Returns a stop function that clears the timer.
+ * Start the periodic notification-escalation sweep. Runs once immediately then on the
+ * interval, non-overlapping + best-effort (see {@link startSweeper}). Returns a stop
+ * function that clears the timer.
  */
 export declare function startNotificationEscalationSweeper(container: ServerContainer, clock: Clock, log: Logger): () => void;
 //# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAA8B,KAAK,MAAM,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAWnG;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAiBZ"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAA8B,KAAK,MAAM,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAYnG;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAYZ"}

package/dist/notifications.js

@@ -1,4 +1,5 @@
 import { escalateStaleNotifications } from '@cat-factory/server';
+import { startSweeper } from './sweeper.js';
 // Periodic notification-escalation sweep for the Node facade — the analogue of the
 // Worker's every-2-min cron call to `escalateStaleNotifications`. Runs no longer time out
 // waiting for a human, so a notification that has waited past its workspace's
@@ -7,26 +8,23 @@ import { escalateStaleNotifications } from '@cat-factory/server';
 /** How often the Node service escalates long-waiting notifications. */
 const NOTIFICATION_ESCALATION_INTERVAL_MS = 60 * 1000;
 /**
- * Start the periodic notification-escalation sweep. Runs once immediately then on a
- * one-minute timer. Best-effort: a failed sweep is logged and retried next tick, never
- * thrown. Returns a stop function that clears the timer.
+ * Start the periodic notification-escalation sweep. Runs once immediately then on the
+ * interval, non-overlapping + best-effort (see {@link startSweeper}). Returns a stop
+ * function that clears the timer.
  */
 export function startNotificationEscalationSweeper(container, clock, log) {
     if (!container.notifications)
         return () => { };
-    const tick = async () => {
-        try {
+    return startSweeper({
+        name: 'notification-escalation',
+        intervalMs: NOTIFICATION_ESCALATION_INTERVAL_MS,
+        log,
+        failureMessage: 'notification escalation failed',
+        tick: async () => {
             const escalated = await escalateStaleNotifications(container, clock.now());
             if (escalated > 0)
                 log.info({ escalated }, 'escalated notifications');
-        }
-        catch (error) {
-            log.error({ err: error instanceof Error ? error.message : String(error) }, 'notification escalation failed');
-        }
-    };
-    void tick();
-    const timer = setInterval(() => void tick(), NOTIFICATION_ESCALATION_INTERVAL_MS);
-    timer.unref?.();
-    return () => clearInterval(timer);
+        },
+    });
 }
 //# sourceMappingURL=notifications.js.map

package/dist/notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAqC,MAAM,qBAAqB,CAAA;AAEnG,mFAAmF;AACnF,0FAA0F;AAC1F,8EAA8E;AAC9E,0FAA0F;AAC1F,kFAAkF;AAElF,uEAAuE;AACvE,MAAM,mCAAmC,GAAG,EAAE,GAAG,IAAI,CAAA;AAErD;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAChD,SAA0B,EAC1B,KAAY,EACZ,GAAW;IAEX,IAAI,CAAC,SAAS,CAAC,aAAa;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YAC1E,IAAI,SAAS,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,yBAAyB,CAAC,CAAA;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CACP,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/D,gCAAgC,CACjC,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IACD,KAAK,IAAI,EAAE,CAAA;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,mCAAmC,CAAC,CAAA;IACjF,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IACf,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAqC,MAAM,qBAAqB,CAAA;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,mFAAmF;AACnF,0FAA0F;AAC1F,8EAA8E;AAC9E,0FAA0F;AAC1F,kFAAkF;AAElF,uEAAuE;AACvE,MAAM,mCAAmC,GAAG,EAAE,GAAG,IAAI,CAAA;AAErD;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAChD,SAA0B,EAC1B,KAAY,EACZ,GAAW;IAEX,IAAI,CAAC,SAAS,CAAC,aAAa;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAC7C,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,yBAAyB;QAC/B,UAAU,EAAE,mCAAmC;QAC/C,GAAG;QACH,cAAc,EAAE,gCAAgC;QAChD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YAC1E,IAAI,SAAS,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,yBAAyB,CAAC,CAAA;QACvE,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/recurring.d.ts

@@ -1,9 +1,9 @@
 import type { Clock } from '@cat-factory/kernel';
 import type { Logger, ServerContainer } from '@cat-factory/server';
 /**
- * Start the periodic schedule sweep. Runs once immediately then on a one-minute
- * timer. Best-effort: a failed sweep is logged and retried next tick, never thrown.
- * Returns a stop function that clears the timer.
+ * Start the periodic schedule sweep. Runs once immediately then on the interval,
+ * non-overlapping + best-effort (see {@link startSweeper}). Returns a stop function that
+ * clears the timer.
  */
 export declare function startScheduleSweeper(container: ServerContainer, clock: Clock, log: Logger): () => void;
 //# sourceMappingURL=recurring.d.ts.map

package/dist/recurring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recurring.d.ts","sourceRoot":"","sources":["../src/recurring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAWlE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAoBZ"}
+{"version":3,"file":"recurring.d.ts","sourceRoot":"","sources":["../src/recurring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAYlE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAeZ"}

package/dist/recurring.js

@@ -1,3 +1,4 @@
+import { startSweeper } from './sweeper.js';
 // Periodic recurring-pipeline sweep for the Node facade — the analogue of the
 // Worker's every-2-min cron call to `runDue`. The Node service has no cron, so a
 // timer fires every due schedule (the actual cadence is hours; a frequent tick just
@@ -6,28 +7,25 @@
 /** How often the Node service checks for due schedules. */
 const SCHEDULE_SWEEP_INTERVAL_MS = 60 * 1000;
 /**
- * Start the periodic schedule sweep. Runs once immediately then on a one-minute
- * timer. Best-effort: a failed sweep is logged and retried next tick, never thrown.
- * Returns a stop function that clears the timer.
+ * Start the periodic schedule sweep. Runs once immediately then on the interval,
+ * non-overlapping + best-effort (see {@link startSweeper}). Returns a stop function that
+ * clears the timer.
  */
 export function startScheduleSweeper(container, clock, log) {
     const recurring = container.recurring;
     if (!recurring)
         return () => { };
-    const tick = async () => {
-        try {
+    return startSweeper({
+        name: 'recurring-pipelines',
+        intervalMs: SCHEDULE_SWEEP_INTERVAL_MS,
+        log,
+        failureMessage: 'recurring-pipeline sweep failed',
+        tick: async () => {
             const { fired, skipped } = await recurring.service.runDue(clock.now());
             if (fired > 0 || skipped > 0) {
                 log.info({ fired, skipped }, 'fired recurring pipelines');
             }
-        }
-        catch (error) {
-            log.error({ err: error instanceof Error ? error.message : String(error) }, 'recurring-pipeline sweep failed');
-        }
-    };
-    void tick();
-    const timer = setInterval(() => void tick(), SCHEDULE_SWEEP_INTERVAL_MS);
-    timer.unref?.();
-    return () => clearInterval(timer);
+        },
+    });
 }
 //# sourceMappingURL=recurring.js.map

package/dist/recurring.js.map

@@ -1 +1 @@
-{"version":3,"file":"recurring.js","sourceRoot":"","sources":["../src/recurring.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,iFAAiF;AACjF,oFAAoF;AACpF,mFAAmF;AACnF,eAAe;AAEf,2DAA2D;AAC3D,MAAM,0BAA0B,GAAG,EAAE,GAAG,IAAI,CAAA;AAE5C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAA0B,EAC1B,KAAY,EACZ,GAAW;IAEX,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;IACrC,IAAI,CAAC,SAAS;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YACtE,IAAI,KAAK,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,2BAA2B,CAAC,CAAA;YAC3D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CACP,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/D,iCAAiC,CAClC,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IACD,KAAK,IAAI,EAAE,CAAA;IACX,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,0BAA0B,CAAC,CAAA;IACxE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IACf,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}
+{"version":3,"file":"recurring.js","sourceRoot":"","sources":["../src/recurring.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,8EAA8E;AAC9E,iFAAiF;AACjF,oFAAoF;AACpF,mFAAmF;AACnF,eAAe;AAEf,2DAA2D;AAC3D,MAAM,0BAA0B,GAAG,EAAE,GAAG,IAAI,CAAA;AAE5C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAA0B,EAC1B,KAAY,EACZ,GAAW;IAEX,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;IACrC,IAAI,CAAC,SAAS;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IAC/B,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,qBAAqB;QAC3B,UAAU,EAAE,0BAA0B;QACtC,GAAG;QACH,cAAc,EAAE,iCAAiC;QACjD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YACtE,IAAI,KAAK,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,2BAA2B,CAAC,CAAA;YAC3D,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/retention.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../src/retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EAChC,gCAAgC,EAChC,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,qBAAqB,CAAA;AAG5B,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAuBlE,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAA;IACnE,uBAAuB,EAAE,IAAI,CAAC,uBAAuB,EAAE,iBAAiB,CAAC,CAAA;IAEzE,8BAA8B,EAAE,IAAI,CAAC,8BAA8B,EAAE,iBAAiB,CAAC,CAAA;IAEvF,0BAA0B,EAAE,IAAI,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAA;IAC/E,0BAA0B,EAAE,IAAI,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAA;IAG/E,gCAAgC,EAAE,IAAI,CAAC,gCAAgC,EAAE,eAAe,CAAC,CAAA;IAEzF,gCAAgC,EAAE,IAAI,CAAC,gCAAgC,EAAE,iBAAiB,CAAC,CAAA;IAE3F,yBAAyB,EAAE,IAAI,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAA;IAE7E,4BAA4B,EAAE,IAAI,CAAC,4BAA4B,EAAE,eAAe,CAAC,CAAA;IAKjF,gBAAgB,EAAE,IAAI,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAA;IAGrE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,CAAA;CAChF;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;CACtB;AAmBD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,eAAe,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAqC1B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAkBZ;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,0BAA0B,EACxC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,EAC7D,kBAAkB,EAAE,IAAI,CAAC,2BAA2B,EAAE,KAAK,CAAC,EAC5D,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CA4BZ"}
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../src/retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EAChC,gCAAgC,EAChC,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,qBAAqB,CAAA;AAG5B,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAwBlE,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAA;IACnE,uBAAuB,EAAE,IAAI,CAAC,uBAAuB,EAAE,iBAAiB,CAAC,CAAA;IAEzE,8BAA8B,EAAE,IAAI,CAAC,8BAA8B,EAAE,iBAAiB,CAAC,CAAA;IAEvF,0BAA0B,EAAE,IAAI,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAA;IAC/E,0BAA0B,EAAE,IAAI,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAA;IAG/E,gCAAgC,EAAE,IAAI,CAAC,gCAAgC,EAAE,eAAe,CAAC,CAAA;IAEzF,gCAAgC,EAAE,IAAI,CAAC,gCAAgC,EAAE,iBAAiB,CAAC,CAAA;IAE3F,yBAAyB,EAAE,IAAI,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAA;IAE7E,4BAA4B,EAAE,IAAI,CAAC,4BAA4B,EAAE,eAAe,CAAC,CAAA;IAKjF,gBAAgB,EAAE,IAAI,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAA;IAGrE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,CAAA;CAChF;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;CACtB;AAmBD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,eAAe,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAqC1B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAaZ;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,0BAA0B,EACxC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,EAC7D,kBAAkB,EAAE,IAAI,CAAC,2BAA2B,EAAE,KAAK,CAAC,EAC5D,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,IAAI,CAuBZ"}

package/dist/retention.js

@@ -1,5 +1,6 @@
 import { DEFAULT_WORKSPACE_SETTINGS } from '@cat-factory/kernel';
 import { sweepBinaryArtifactRetention } from '@cat-factory/orchestration';
+import { startSweeper } from './sweeper.js';
 /** Recurring-pipeline run history is kept ~1 week (the inspector's window). */
 const SCHEDULE_RUN_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
 /**
@@ -55,21 +56,18 @@ export async function sweepRetention(repos, retention, now) {
  * a stop function that clears the timer.
  */
 export function startRetentionSweeper(repos, retention, clock, log) {
-    const tick = async () => {
-        try {
+    return startSweeper({
+        name: 'retention',
+        intervalMs: RETENTION_SWEEP_INTERVAL_MS,
+        log,
+        failureMessage: 'retention sweep failed',
+        tick: async () => {
             const reclaimed = await sweepRetention(repos, retention, clock.now());
             if (Object.values(reclaimed).some((n) => n > 0)) {
                 log.info(reclaimed, 'retention sweep reclaimed rows');
             }
-        }
-        catch (error) {
-            log.error({ err: error instanceof Error ? error.message : String(error) }, 'retention sweep failed');
-        }
-    };
-    void tick();
-    const timer = setInterval(() => void tick(), RETENTION_SWEEP_INTERVAL_MS);
-    timer.unref?.(); // never keep the process alive on the sweep timer alone
-    return () => clearInterval(timer);
+        },
+    });
 }
 /**
  * Start the per-workspace binary-artifact retention sweep (the Node analogue of the Worker's
@@ -79,8 +77,12 @@ export function startRetentionSweeper(repos, retention, clock, log) {
  * once immediately then hourly; best-effort. Returns a stop function.
  */
 export function startArtifactRetentionSweeper(resolveStore, workspaceRepository, settingsRepository, clock, log) {
-    const tick = async () => {
-        try {
+    return startSweeper({
+        name: 'artifact-retention',
+        intervalMs: RETENTION_SWEEP_INTERVAL_MS,
+        log,
+        failureMessage: 'artifact retention sweep failed',
+        tick: async () => {
             const removed = await sweepBinaryArtifactRetention({
                 resolveStore,
                 listWorkspaceIds: () => workspaceRepository.listVisible(null).then((ws) => ws.map((w) => w.id)),
@@ -91,14 +93,7 @@ export function startArtifactRetentionSweeper(resolveStore, workspaceRepository,
             });
             if (removed > 0)
                 log.info({ binaryArtifacts: removed }, 'artifact retention sweep reclaimed rows');
-        }
-        catch (error) {
-            log.error({ err: error instanceof Error ? error.message : String(error) }, 'artifact retention sweep failed');
-        }
-    };
-    void tick();
-    const timer = setInterval(() => void tick(), RETENTION_SWEEP_INTERVAL_MS);
-    timer.unref?.();
-    return () => clearInterval(timer);
+        },
+    });
 }
 //# sourceMappingURL=retention.js.map

package/dist/retention.js.map

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

package/dist/sweeper.d.ts

@@ -0,0 +1,24 @@
+import type { Logger } from '@cat-factory/server';
+/** A best-effort periodic sweep started via {@link startSweeper}. */
+export interface SweeperOptions {
+    /** Short sweep name, used as the toad-scheduler task id (so a scheduler-surfaced error names its sweep). */
+    name: string;
+    /** How often to run the sweep. */
+    intervalMs: number;
+    /** Logger for the best-effort failure line. */
+    log: Logger;
+    /** The message logged (with the error) when a pass throws. */
+    failureMessage: string;
+    /** One sweep pass. Any success logging lives inside it; throws are caught + logged. */
+    tick: () => Promise<void>;
+}
+/**
+ * Start a periodic, non-overlapping, best-effort sweep. Runs `tick` once immediately then
+ * on the interval; skips a tick while the previous pass is still in flight
+ * (`preventOverrun`); logs (never throws) a failed pass; never keeps the process alive on
+ * the sweep timer alone (`unref`, matching the hand-rolled `setInterval(...).unref()`
+ * timers this replaced). Returns a stop function that halts the job — still call it on
+ * shutdown so a long pass in flight can't outlive the rest of the teardown.
+ */
+export declare function startSweeper(options: SweeperOptions): () => void;
+//# sourceMappingURL=sweeper.d.ts.map

package/dist/sweeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweeper.d.ts","sourceRoot":"","sources":["../src/sweeper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAiBjD,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,4GAA4G;IAC5G,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAA;IACtB,uFAAuF;IACvF,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAYhE"}

package/dist/sweeper.js

@@ -0,0 +1,23 @@
+import { AsyncTask, SimpleIntervalJob, ToadScheduler } from 'toad-scheduler';
+/**
+ * Start a periodic, non-overlapping, best-effort sweep. Runs `tick` once immediately then
+ * on the interval; skips a tick while the previous pass is still in flight
+ * (`preventOverrun`); logs (never throws) a failed pass; never keeps the process alive on
+ * the sweep timer alone (`unref`, matching the hand-rolled `setInterval(...).unref()`
+ * timers this replaced). Returns a stop function that halts the job — still call it on
+ * shutdown so a long pass in flight can't outlive the rest of the teardown.
+ */
+export function startSweeper(options) {
+    const { name, intervalMs, log, failureMessage, tick } = options;
+    const scheduler = new ToadScheduler();
+    const task = new AsyncTask(name, tick, (error) => {
+        log.error({ err: error instanceof Error ? error.message : String(error) }, failureMessage);
+    });
+    const job = new SimpleIntervalJob({ milliseconds: intervalMs, runImmediately: true }, task, {
+        preventOverrun: true,
+        unref: true,
+    });
+    scheduler.addSimpleIntervalJob(job);
+    return () => scheduler.stop();
+}
+//# sourceMappingURL=sweeper.js.map

package/dist/sweeper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweeper.js","sourceRoot":"","sources":["../src/sweeper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AA8B5E;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAAuB;IAClD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;IAC/D,MAAM,SAAS,GAAG,IAAI,aAAa,EAAE,CAAA;IACrC,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;QAC/C,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,cAAc,CAAC,CAAA;IAC5F,CAAC,CAAC,CAAA;IACF,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE;QAC1F,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;IACF,SAAS,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAA;IACnC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;AAC/B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/node-server",
-  "version": "0.92.7",
+  "version": "0.92.8",
   "description": "Node.js runtime facade for the Agent Architecture Board: serves the shared @cat-factory/server Hono app via @hono/node-server, wiring Node implementations of the runtime ports (persistence, gateways, model provisioning).",
   "repository": {
     "type": "git",
@@ -31,6 +31,7 @@
     "layered-loader": "^14.5.3",
     "pg": "^8.22.0",
     "pg-boss": "^12.25.1",
+    "toad-scheduler": "^4.1.0",
     "ws": "^8.21.0",
     "@cat-factory/agents": "0.53.6",
     "@cat-factory/caching": "0.6.34",
@@ -47,7 +48,7 @@
     "@cat-factory/provider-bedrock": "0.7.205",
     "@cat-factory/provider-cloudflare": "0.7.206",
     "@cat-factory/provider-s3": "0.2.139",
-    "@cat-factory/server": "0.110.5",
+    "@cat-factory/server": "0.111.0",
     "@cat-factory/spend": "0.12.15"
   },
   "devDependencies": {
@@ -57,7 +58,7 @@
     "drizzle-kit": "1.0.0-rc.4",
     "typescript": "7.0.1-rc",
     "vitest": "^4.1.9",
-    "@cat-factory/conformance": "0.10.97"
+    "@cat-factory/conformance": "0.10.98"
   },
   "optionalDependencies": {
     "ioredis": "^5.11.1"