Skip to content

A command may be accepted before there is capacity for it: the wait is told as an event, bounded, and ends in an outcome - #114

Closed
riccardone wants to merge 1 commit into
mainfrom
spec-37-commands-that-wait
Closed

riccardone wants to merge 1 commit into
mainfrom
spec-37-commands-that-wait

Conversation

@riccardone

Copy link
Copy Markdown
Contributor

Entry 42, 42a and 49 (one need: a command that waits its turn) on #37 (#37), proven by best-peer.

Why

Command Results says "BEST defines no timeout protocol" and callers decide how long to wait. It says nothing of a command accepted now and run later because the service has no capacity yet, of bounds the caller sets on that wait and on the run, of ending such a command before it began, or of what bounds a wait the caller did not bound. best-peer, at a machine's door and at the cloud above it alike: an order that asks to wait is taken (201) and told as JobQueued, placed first come first served; queue_seconds bounds the wait (past it, JobFailed says it was never placed) and deadline_seconds the run (past it, JobStopped says why), both counted from the events' own times so a restart neither resets nor extends them; an order that names no queue_seconds waits a day at most, and that bound is written on JobQueued; stop-job ends a waiting order before it started. At a machine, an order that does not ask to wait is refused at once when there is no room, so a cloud distributing work is not held by one full machine.

What

A subsection of Command Results and Correlation, Commands That Wait, placed after the paragraph #100 changes so the two do not touch.

Nothing changes in the conformance list: the sentence is a clarification.

No version bump and no release notes here: the PRs from #37 do not collide that way, and the release that gathers them does both.

🤖 Generated with Claude Code

…s told as an event, bounded, and ends in an outcome

Entries 42, 42a and 49 of #37, one need: a command that waits its turn. The spec defines no timeout protocol and says nothing of a command accepted now and run later, of bounds on that wait and on the run, or of ending such a command before it began. best-peer queues an order that asks to wait, tells JobQueued, bounds the wait and the run from its own events' times, tells the bound it applies when the caller named none, and stops a waiting order with the same stop-job.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
riccardone added a commit that referenced this pull request Oct 22, 2026
…s told as an event, bounded, and ends in an outcome

Entry 42, 42a and 49 (one need: a command that waits its turn) on #37 (#37), proven by best-peer. Landed from #114.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@riccardone

Copy link
Copy Markdown
Contributor Author

Landed on main as 260bda4 under the repository's new process (SDLC.md: every change on main after the local gate and the review). The review of the whole batch is in the Review: commits after it, up to 5603cb1. Closing this pull request.

@riccardone riccardone closed this Oct 22, 2026
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