feat: migrate examples to the jobs model

[0xgleb]

Motivation

The example crates still implemented the removed EventSourced::Services API. They need to compile against the jobs-shaped EventSourced trait without bundling the prose documentation migration into the same PR.

Solution

• Migrates examples/complex (order, inventory, reactors, main) to type Jobs = Nil, sync command handlers with JobQueue, and the updated builder/test harness calls.
• Migrates examples/simple by moving the clock value into commands, removing the service clock machinery, and updating callers/tests.
• Leaves README/SPEC/docs prose to the follow-up docs PR stacked above this one.

Closes RAI-945.

Summary by CodeRabbit

• Documentation

  • Updated code examples to show commands now including explicit timestamps

• Refactor

  • Command structure updated to require timestamp values in payloads

[coderabbitai]

Warning

Review limit reached

@0xgleb, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 59 minutes and 56 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 6f95df35-6948-4c54-8b44-e993e00268e1

📥 Commits

Reviewing files that changed from the base of the PR and between 48ee433 and 1f2408b.

📒 Files selected for processing (2)

• examples/simple/src/main.rs
• examples/simple/src/support_ticket.rs

Walkthrough

This PR updates the SupportTicket example to pass explicit timestamps through command payloads. The Open, AwaitCustomer, and Close command variants now include an at field carrying the command timestamp, replacing earlier internal now() calls. The aggregate's initialize and transition methods emit events using these command-provided timestamps. Main and test code are updated to provide concrete timestamps.

Changes

Command timestamping in SupportTicket aggregate

Layer / File(s)	Summary
Command contract and initialization examples/simple/src/support_ticket.rs	SupportTicketCommand variants Open, AwaitCustomer, and Close now include at: chrono::DateTime<Utc> fields. The EventSourced::initialize method uses the timestamp from the Open command to create the Opened event.
Aggregate state transitions examples/simple/src/support_ticket.rs	The EventSourced::transition method now emits AwaitingCustomer and Closed events using the command-provided at timestamp, while maintaining existing status-based error behavior for invalid state transitions.
Main example with timestamps examples/simple/src/main.rs	Updated module-level documentation describes that commands carry their own timestamps and the SQLite generated column supports filtered queries. The main flow now provides chrono::Utc::now() timestamps when constructing Open, AwaitCustomer, and Close commands.
Test suite alignment examples/simple/src/support_ticket.rs	All test cases constructing Open, AwaitCustomer, or Close commands are updated to include at: fixed_instant() in the command payloads, covering close behavior, store round-trips, projection filtering, and idempotency scenarios.

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Title check	⚠️ Warning	The PR title 'feat: migrate examples to the jobs model' does not accurately describe the actual changes made, which focus on adding explicit timestamps to commands rather than a jobs model migration.	Consider a more descriptive title like 'feat: add explicit timestamps to example commands' or similar that reflects the actual code modifications.
Docstring Coverage	⚠️ Warning	Docstring coverage is 75.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/jobs-examples-docs

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[0xgleb]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• adr: own the durable-job backend as an event-sourced apalis Backend #30
• adr: gradual consumer migration from services to jobs #19
• docs: migrate docs to the jobs model #20
• feat: migrate examples to the jobs model #16 👈 (View in Graphite)
• feat: replace EventSourced::Services with Jobs and wire atomic enqueue #15
• feat: add buffered JobQueue and apalis enqueue #14
• feat: add build_supervised_worker macro #13
• feat: job worker #12
• feat: add job module #11 : 1 other dependent PR (#31 )
• adr: jobs replace services #8
• master

---

How to use the Graphite Merge Queue

Add the label add-to-gt-merge-queue to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has required the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[findolor]

Approved.