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

..

bash.md

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

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

core.md

simplify(llm): drop unconsumed adapter-change event and assembled call surfaces

2026-06-21 01:27:41 +08:00

llm-streaming.md

simplify(llm): drop unconsumed adapter-change event and assembled call surfaces

2026-06-21 01:27:41 +08:00

persistence.md

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

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

session.md

Fix doc cross-links for the hierarchy; add package-path + shape gates

2026-06-20 23:12:14 +08:00

tools.md

Fix doc cross-links for the hierarchy; add package-path + shape gates

2026-06-20 23:12:14 +08:00