Skip to content

🤖 refactor: move the stop latch into TaskStopLatch - #7675

Merged
ThomasK33 merged 1 commit into
refactor/task-split-stop-attempt-methodsfrom
refactor/task-stop-latch
Oct 27, 2026
Merged

ThomasK33 merged 1 commit into
refactor/task-split-stop-attempt-methodsfrom
refactor/task-stop-latch

Conversation

@ThomasK33

Copy link
Copy Markdown
Member

Summary

Moves the stop latch out of TaskService into a new plain class, TaskStopLatch (src/node/services/taskStopLatch.ts). The move is move-only: no behaviour change, no Effect tag. taskService.ts drops from 21,830 to 21,470 lines. PR 7 of the TaskService split, on top of #7674.

Background

TaskService is ~21,000 lines. Stack 1 (#7665 to #7669) moved five state groups into owner classes. This stack moves the stop and attempt state: PR 7 the stop latch, PRs 8 and 9 the attempt ledger, PR 10 the stream-end decisions.

Implementation

  • Fields that moved: workspaceStopEpochs, workspaceStopsInProgress, queueRechecksOwedByStopLatch and workspaceStopRecords. workspaceUserStopEpochs stays on TaskService, because it counts user Stops for sendTreeMessage and is not latch state.
  • Methods that moved: the stop cascade (beginWorkspaceStop, runWorkspaceStopCleanup, markWorkspaceStopPersisted), the release (recheckWorkspaceStopRelease and the four steps 🤖 refactor: split the five longest stop and attempt methods in TaskService #7674 split out of it), the latch and epoch queries, deferLaunchWhileStopInProgress, releaseRetainedStopLatches and waitForWorkspaceStopsToRelease.
  • Facades: TaskService keeps one-line facades for every seam method (bumpWorkspaceStopEpoch, getWorkspaceStopEpoch, latchWorkspaceStopsInProgress, isWorkspaceStopInProgress, releaseRetainedStopLatches) and for the two methods tests spy on (runWorkspaceStopCleanup, waitForWorkspaceStopsToRelease).
  • Coordinators stay: recordWorkspaceTurnSettled and recordWorkspaceTurnSuperseded stay on TaskService. They write three owners in order (admitted sends, stream-end decisions, stop records). Their stop-record tails are now releaseCapturedTurn / rebindCapturedTurn calls.
  • Deps: the latch reaches attempt state through call-time TaskService closures (TaskStopLatchDeps), so test spies and patches on TaskService still see every call. Stop records and admitted sends move by reference.
  • Exported types: OwnedTaskAttempt, AdmittedSend, StreamEndDecision and WorkspaceStopRecord are now exported from taskService.ts for import type. The new SettlementReceiptDecision alias names the existing return type of decideSettlementReceipt.

Validation

  • I checked the moved blocks against the originals with a whitespace-insensitive comparison, after the this.x -> this.deps.x() swaps. They match. Statement order is the same, and no await was added.
  • The new file taskStopLatch.test.ts has 23 tests on fake deps. They cover latch refcounting, deferred-launch rechecks, capture by reference, the release hold conditions, the receipt write before release, and the wait's listener cleanup and deadline.
  • Tests changed only their cast targets.
  • CRAP: beginWorkspaceStop and runWorkspaceStopCleanup are CC 13 and count as new functions. With coverage they score CRAP 13.0 and 13.5, under the CI limit of 15.

Risks

Medium-low. The stop latch gates reawakens, peer sends and queued launches. A wiring mistake would leave a stuck latch or release one early. The stop, reawakening, settlement-receipt and attempt-admission suites cover those paths and pass unchanged.


Generated with xum • Model: anthropic:claude-opus-5-5 • Thinking: high • Cost: $68.74

Move the stop epochs, the stop-in-progress latches, the queue rechecks a
held latch owes and the stop records (Phase A capture, Phase B cleanup,
Phase C release) from TaskService into a plain TaskStopLatch class in
taskStopLatch.ts. TaskService builds it with call-time closures; attempt,
send and stream-end state stays on TaskService and is reached through them.

Seam methods (bump/getWorkspaceStopEpoch, latchWorkspaceStopsInProgress,
isWorkspaceStopInProgress, releaseRetainedStopLatches) and the spied
runWorkspaceStopCleanup and waitForWorkspaceStopsToRelease stay on
TaskService as one-line facades. recordWorkspaceTurnSettled/Superseded and
workspaceUserStopEpochs stay on TaskService. Tests that cast a moved field
change only the cast target.

No behavior change: moved code is verbatim, statement order is kept and no
await is added.

Signed-off-by: Thomas Kosiewski <tk@coder.com>
@ThomasK33
ThomasK33 added this pull request to stack #7676 October 27, 2026 10:38
@ThomasK33

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-27T10:41:59.993295Z 0e3c0ed Manual request
🔒 Security Review ✅ Completed 2026-10-27T10:41:22.663681Z 0e3c0ed Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

🛡️ Codex Security Review · Automatically triggered

Security review completed. No security issues were found in this pull request.

Reviewed commit: 0e3c0ed129

View security finding report

Only the user who started this review can view the report in Codex.

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Hooray!

Reviewed commit: 0e3c0ed129

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@github-actions

Copy link
Copy Markdown
Contributor

🟢 e2e stories (Haiku): 14 passed

22 agent steps · 7 replayed from cache · 15 model calls · 46.2k tokens (24% cached)
Spend: $0.09 of the $1.00 cap (proxy ledger)

All 14 tests in 9 files
Test Agent Time
🟢 chatRestart.e2e.ts · 1 passed 1 step · 1 call 5.5s
🟢 a chat survives a restart of the server 1 step · 1 call 5.5s
🟢 compaction.e2e.ts · 1 passed 1 step · 1 call 4.4s
🟢 /compact replaces the old chat with a summary 1 step · 1 call 4.4s
🟢 pluginTrustRestart.e2e.ts · 1 passed 4 steps · 2 calls 9.3s
🟢 a trusted plugin hook stays trusted after the server restarts 4 steps · 2 calls 9.3s
🟢 settingsRoundTrip.e2e.ts · 1 passed 2 steps · 1 call 8.7s
🟢 a chat survives trips through Settings 2 steps · 1 call 8.7s
🟢 sidebarPerWorkspace.e2e.ts · 1 passed 4 steps · 1 call 4.0s
🟢 a new workspace starts with its right sidebar collapsed while another keeps it open 4 steps · 1 call 4.0s
🟢 smoke.e2e.ts · 1 passed 2 steps · 1 call 2.4s
🟢 the agent opens the playground workspace 2 steps · 1 call 2.4s
🟢 streamErrors.e2e.ts · 1 passed 1 step · 1 call 6.7s
🟢 stream errors show in the chat, and the chat recovers 1 step · 1 call 6.7s
🟢 todoNudge.e2e.ts · 1 passed 1 step · 1 call 2.6s
🟢 the agent finishes open TODO items after the turn-end nudge 1 step · 1 call 2.6s
🟢 touchAlignment.e2e.ts · 6 passed 6 steps · 6 calls 20.7s
🟢 the Settings close button is level with the title on a touch screen 390px wide 1 step · 1 call 4.0s
🟢 the Settings close button is level with the title on a touch screen 768px wide 1 step · 1 call 3.3s
🟢 Backup settings checkboxes are small and level with their labels on a touch phone 1 step · 1 call 4.3s
🟢 the heartbeat checkbox is small and level with its label on a touch phone 1 step · 1 call 3.3s
🟢 a reply's model and time stay on one line on a touch phone 1 step · 1 call 3.0s
🟢 the workspace actions menu stays on the title row on a touch phone 1 step · 1 call 2.9s

e2e 0.20.0 · 1m 7s · web · run artifacts

🟢 e2e Electron stories (Haiku): 3 passed

3 agent steps · 3 model calls · 8.0k tokens (22% cached)
Spend: $0.02 of the $1.00 cap (proxy ledger)

All 3 tests in 3 files
Test Agent Time
🟢 electron/deepLink.e2e.ts · 1 passed 1 step · 1 call 5.7s
🟢 a deep link of a second launch starts a chat in the running app 1 step · 1 call 5.7s
🟢 electron/menuBar.e2e.ts · 1 passed 1 step · 1 call 5.4s
🟢 the workspace menu bar is the desktop title bar 1 step · 1 call 5.4s
🟢 electron/smoke.e2e.ts · 1 passed 1 step · 1 call 4.9s
🟢 Xum Electron opens the playground workspace 1 step · 1 call 4.9s

e2e 0.20.0 · 18.2s · electron · run artifacts

🟢 e2e agent repros (Haiku): no tests selected

Spend: $0.00 of the $1.00 cap (proxy ledger)

e2e 0.20.0 · 5.3s · 2 targets (web, phone) · run artifacts

@ThomasK33
ThomasK33 added this pull request to the merge queue Oct 27, 2026
Merged via the queue into main with commit 9bae432 Oct 27, 2026
33 of 34 checks passed
@ThomasK33
ThomasK33 deleted the refactor/task-stop-latch branch October 27, 2026 15:32
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