Concept reference

Background Jobs

The maintenance catalog that keeps rollouts compact, viz pools fresh, OAuth tokens current, and usage rolled up.

1 min read

One substrate for schedules

Date-driven work runs on the Workflow SDK seam (packages/workflows). Named maintenance workflows extend the scheduler instead of introducing a second queued-jobs system.

Current maintenance catalog

  • cleanup-stale-rollouts — drops rollout segments past their hot window.
  • compact-cold-rollouts — folds cold segments into replay-safe summaries.
  • recycle-viz-pool — releases stale viz leases without losing tenant scope.
  • renew-mcp-oauth — refreshes MCP integration tokens before expiry.
  • digest-notifications — batches per-user digest emails.
  • usage-rollup — aggregates metering events for billing and admin dashboards.

Operate them

Each job has a runbook entry. Failures emit typed ops incidents through the observability stack and page on-call by trust boundary.

Was this page helpful?

Edit this page on GitHub

Search docs

Find pages across the SimPilot docs.