Skip to content

docs(spec): JobHandler docblock states degraded consumption is wired#10434

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
qq9340100 merged 1 commit into from
Aug 21, 2026
+10 −2
Merged

docs(spec): JobHandler docblock states degraded consumption is wired #10434

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 10 additions & 2 deletions packages/spec/src/contracts/job-service.ts
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -106,8 +106,16 @@ export interface JobRunOutcome {
*
* The reporting channel is deliberately opt-in on **both** ends. Consuming it
* — mapping `degraded` onto a `sys_job_run.status` distinct from `success` —
* is #5548's half and is **not yet wired**: the shipped adapters currently
* discard the resolved value, which is precisely why doing so is safe.
* is #5548's half, and it is wired: all three shipped adapters
* (`cron-job-adapter.ts`, `interval-job-adapter.ts`, `db-job-adapter.ts`) map
* a resolved `{ outcome: 'degraded' }` onto a run status distinct from
* `success`, the `reason` lands in `error` / `last_error`, and
* `failure_count` stays flat — never a retry, never an alert. Both
* `sys_job_run.status` and `sys_job.last_status` carry `degraded` in their
* ObjectQL-enforced select vocabularies (#7072), which must stay in step with
* {@link JobExecutionStatus} in `system/job.zod.ts` — see that type's TSDoc
* for the full mapping and the cost of routing `reason` through an "Error"
* column.
*/
export type JobHandler = (context: { jobId: string; data?: unknown }) => Promise<void | JobRunOutcome>;

Expand Down
Loading