Hojun-Cho/ww
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: coordinator concurrency + tree walk are landed driver work

Browse Source
This commit is contained in:
Hojun-Cho
2026-08-08 13:53:15 +09:00
parent 7ad837ff9e
commit ddb44405ea
1 changed files with 7 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/test-system-v2.md
View File

@@ -193,7 +193,13 @@ Go's `./...` form) is recognized by both driver stages before path resolution
and walks the tree rooted at the prefix: every subdirectory whose name does not and walks the tree rooted at the prefix: every subdirectory whose name does not
begin with `.` or `_` is descended with the same lstat/no-symlink discipline, begin with `.` or `_` is descended with the same lstat/no-symlink discipline,
each test-bearing directory becomes one package run, and source-bearing each test-bearing directory becomes one package run, and source-bearing
directories without tests report the usual `?` line. With `-c`, it publishes each exact directories without tests report the usual `?` line. The coordinator's
`-j N` schedules up to N package groups concurrently (build-then-run
process chains supervised with `os.exec` start/poll, no threads);
emission stays strictly in group order, so the byte stream is identical
at every `-j` level, and `-j 1` — the default — matches the former
sequential loop exactly. Measured on the 31-package `lib/...` walk:
7.0s sequential, 2.4s at `-j 4`. With `-c`, it publishes each exact
`<package>.test` binary and adjacent `<package>.test.sepwork` tree in the `<package>.test` binary and adjacent `<package>.test.sepwork` tree in the
package directory; those become caller-owned artifacts. Without `-c`, it package directory; those become caller-owned artifacts. Without `-c`, it
removes the temporary binary and scratch with its workspace. The language removes the temporary binary and scratch with its workspace. The language
@@ -311,8 +317,6 @@ timeout policy in this architecture.
Carried over from the dissolved project plan; each is deliberate scope, not Carried over from the dissolved project plan; each is deliberate scope, not
drift: drift:
- Package-level concurrency for the coordinator's builds (it is
single-threaded by design today).
- A package-level `-o` contract (single-file `ww test -o` exists; directory - A package-level `-o` contract (single-file `ww test -o` exists; directory
packages publish fixed `<package>.test` stems under `-c`). packages publish fixed `<package>.test` stems under `-c`).
- The remaining invalid-`@test` attribute-shape diagnostics (exported - The remaining invalid-`@test` attribute-shape diagnostics (exported