1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
//! Typed jobs — the runtime contract for the A12 job DX layer.
//!
//! Jobs are typed application data: `#[derive(Job)] pub struct
//! SendVerificationEmail { pub user_id: Uuid }`. The application enqueues a
//! job explicitly via `jobs.enqueue(&JobRequest::new(&model, &payload)?)`
//! — there is **no hidden dispatch** (PROGRAM.md: "job dispatch" is forbidden
//! hidden behavior in macros). The `#[job_handler]` macro annotates a
//! function that the worker calls when the job is dequeued, but does NOT
//! register or enqueue anything at compile time.
//!
//! This module owns only the DX trait. The real queue, registry, worker,
//! and lifecycle live in `arcature-jobs`; this layer is the compile-time
//! DX glue that the macros generate against. The metadata binding
//! ([`JobBinding`]) lives in [`crate::dx::graph`] alongside the other
//! module-graph bindings.
//!
//! # Type erasure
//!
//! The `arcature-jobs` `Registry` type-erases handlers behind
//! `serde_json::Value`, exactly like the A11 `Dispatcher`. There is no
//! `TypeId`/`Any` container (AGENTS.md §17). The `Job` trait is a plain
//! marker that ties a typed job struct to its static `NAME` — the metadata
//! the `JobRequest` constructor needs.
use crateDxComponent;
/// The marker trait for typed Arcature jobs (A12).
///
/// A job is a plain data struct that carries the arguments for a unit of
/// background work. The `#[derive(Job)]` macro generates `impl DxComponent`
/// (with the static `NAME`), `impl Job` (empty — it is a marker), and a
/// `pub const JOB_MODEL: ::arcature::jobs::JobModel<Self>` for enqueue.
///
/// The trait extends `DxComponent` so the job has a static `NAME` used for
/// handler registration lookup and `arc check` inspection.
///
/// # Example
///
/// ```ignore
/// #[derive(Job, serde::Serialize, serde::Deserialize)]
/// #[job(attempts = 5)]
/// pub struct SendVerificationEmail {
/// pub user_id: Uuid,
/// }
/// ```
///
/// The struct should also derive `Serialize` and `Deserialize` (the
/// `arcature-jobs` registry type-erases payloads via `serde_json::Value`).
/// `#[derive(Job)]` does NOT add serde derives — the application brings
/// its own `serde` derives so the job struct stays a plain data type.