Skip to content

Document machine-readable responses and repair job scheduling - #1403

Merged
crimson-knight merged 1 commit into
amberframework:v2-devfrom
crimson-knight:agent/content-realtime-jobs-v2
Aug 11, 2026
Merged

Document machine-readable responses and repair job scheduling#1403
crimson-knight merged 1 commit into
amberframework:v2-devfrom
crimson-knight:agent/content-realtime-jobs-v2

Conversation

@crimson-knight

Copy link
Copy Markdown
Member

What changed

  • adds md / markdown response helpers and keeps the canonical emitted media type during negotiation
  • documents exact application file placement for response formats and background jobs
  • makes custom job retry backoff policies actually run after deserialization
  • connects idle-only job workers to Amber's live HTTP request count while excluding upgraded WebSockets
  • documents strict queue ordering, the unbounded process-local memory adapter, work-stealing limits, and channel broadcasts after jobs complete

Why

The public V2 guides need to describe behavior that the framework actually implements. The retry hook was documented but ignored, and work stealing had a request counter that the request pipeline never updated.

Developer impact

Applications can return Markdown through respond_with, custom retry schedules are honored, and idle-only workers now use a real request-activity signal. Existing queue and response behavior remains the default.

Validation

  • focused responder, worker, and pipeline specs: 46 examples, 0 failures
  • complete Amber V2 suite: 2,324 examples, 0 failures
  • Crystal 1.21.0

@crimson-knight
crimson-knight marked this pull request as ready for review August 11, 2026 20:30
@crimson-knight
crimson-knight merged commit 1be5b29 into amberframework:v2-dev Aug 11, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant