Skip to content

docs(issues): specify JoinSet evaluation for JobManager#2001

Merged
josecelano merged 2 commits into
torrust:developfrom
josecelano:1586-document-joinset-refactor
Jul 20, 2026
Merged

docs(issues): specify JoinSet evaluation for JobManager#2001
josecelano merged 2 commits into
torrust:developfrom
josecelano:1586-document-joinset-refactor

Conversation

@josecelano

Copy link
Copy Markdown
Member

Summary

Adds a local issue specification for evaluating tokio::task::JoinSet as the task-ownership mechanism for JobManager.

The specification:

  • documents the current sequential waiting and detached-task risks;
  • rejects wrapping existing JoinHandle values in newly spawned tasks;
  • requires direct task ownership while preserving server startup handshakes;
  • records the design decisions that remain deferred to the shutdown-overhaul review; and
  • defines implementation acceptance criteria and verification scenarios.

The spelling dictionary is updated with the intentional JoinSet and JobManager identifiers.

Scope

Documentation only. No production code or shutdown behaviour changes are included, and implementation remains intentionally deferred until the broader shutdown architecture is finalized.

Validation

  • Mandatory pre-commit hook
  • cargo machete --with-metadata
  • cargo deny check bans
  • linter all
  • Workspace documentation tests

Copilot AI review requested due to automatic review settings July 20, 2026 11:04
@josecelano
josecelano force-pushed the 1586-document-joinset-refactor branch from 433b20e to 72d7f4b Compare July 20, 2026 11:06
@josecelano josecelano self-assigned this Jul 20, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a new local issue specification documenting a proposed refactor to evaluate tokio::task::JoinSet as the task-ownership mechanism for JobManager, and updates the repository spelling dictionary to include the new identifiers used in the spec.

Changes:

  • Added a new issue spec (#1586) describing the current JobManager risks (sequential waiting + detached tasks) and the constraints/acceptance criteria for a future JoinSet-based design.
  • Updated project-words.txt to whitelist JobManager and JoinSet for spell-checking.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
project-words.txt Adds JobManager and JoinSet to the spelling dictionary.
docs/issues/open/1586-use-joinset-in-jobmanager.md New issue specification documenting the JoinSet evaluation and implementation acceptance criteria.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread project-words.txt
Comment on lines 193 to 197
jdbe
JobManager
Joakim
JoinSet
josecelano
@josecelano

Copy link
Copy Markdown
Member Author

ACK 6903bc8

@josecelano
josecelano merged commit b83c1db into torrust:develop Jul 20, 2026
1 check 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.

2 participants