Tianyi Cui 5f9d10c587 fix review findings: stale seam docs + race-free doneFor test helper ...

Codex review of the PR2 diff caught doc/comment sites doc-sync does not gate
(core-data-structures prose) and a latent test-helper race:
- docs/core-data-structures/persistence.md + bash.md, sqlite README, and two
  source comments (coordinator.ts, jsonl.spec.ts) still listed the removed
  has/delete/get/list methods — updated to the surviving four-method
  persistence surface and the get/list-free bash seam.
- doneFor(ctx, id) attached its onTaskDone listener lazily, after the task
  could already have closed (e.g. `true`), so it could miss the completion and
  hang. Replaced with trackCompletions(ctx): one eagerly-installed listener
  (mounted in setup() before any task starts) records every completion, and
  doneFor resolves immediately for an already-finished task or on completion
  otherwise. Race-free, and there is no get-by-id seam left to poll instead.

2026-06-21 02:45:21 +08:00

..

integration.spec.ts

simplify(seams): prune dead methods from the persistence and bash seams

2026-06-21 02:17:27 +08:00

tools.spec.ts

fix review findings: stale seam docs + race-free doneFor test helper

2026-06-21 02:45:21 +08:00