@unotest/protocol 0.17.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,107 @@
 # Changelog
 
+## [0.19.0] - 2026-08-23
+
+### Minor Changes
+
+- dfb3991: Per-collection parallelism via a `workers:` field in the collection YAML.
+
+  - `workers: N` (integer ≥ 1) in `unotest/e2e/_collections/*.yaml` sets how
+    many scenarios of that collection run concurrently; omitted = serial.
+  - Precedence: CLI `--workers=N` flag > manifest `workers:` > 1.
+  - Viewer: the collection header shows an editable `workers` value; the
+    setting is stored in the YAML, so CLI and CI runs pick it up too.
+  - `CollectionMeta` (protocol) gains a `workers: number | null` field.
+
+- Run history scales: runs are filed under daily shards and the viewer stops
+  polling history it is not showing.
+
+  - New on-disk layout `unotest/.runs/<YYYY>/<MM>/<DD>/<runId>/` (UTC date the
+    run started). The shard is a pure function of the `runId`, which already
+    carries the timestamp — a direct link to a run keeps working even with the
+    index deleted. Existing flat `.runs/<runId>/` history is migrated
+    automatically (see the `runs migrate` entry).
+  - The viewer's watcher polls only LIVE runs; finished history never touches
+    it. Discovery watches the current day's directory with native `fs.watch`
+    and re-attaches at UTC midnight.
+  - A JSONL index per day and per scenario backs the history list. It is fully
+    rebuildable — rebuilt on start, non-blocking — so a corrupted or missing
+    index degrades the listing, never the runs themselves.
+  - `@unotest/protocol`: new `run-shard` and `run-index` modules (shard path
+    derivation, index record shapes) exported from the root entry.
+
+- Step screenshots are stored once and shared, and old runs expire on their
+  own — a long history stops growing without bound.
+
+  - Identical frames are content-addressed in `unotest/.runs/_blobs/` and
+    hardlinked into each run. `du` and ordinary copies see whole files;
+    `cp -a` / `rsync -H` preserve the sharing. On one dogfood suite: 45
+    frames, 2.04 MB by apparent size, 0.96 MB on disk.
+  - Reference counting is the filesystem's (`st_nlink`), so nothing to keep in
+    sync. Blob generations keep the dedup honest past ext4's 65 000-link
+    ceiling, and a fresh blob is untouchable for an hour so the window between
+    writing it and linking it is never mistaken for garbage.
+  - Retention: `UNOTEST_RUNS_RETENTION_DAYS` (whole days, default 180) sweeps
+    runs older than the window at the end of a collection run. It never
+    changes the exit code — a failed sweep is reported, not fatal.
+  - `@unotest/protocol`: new `run-blobs` module exported from the root entry.
+
+- `ScenarioLatestEntry` (`GET /api/runs/latest`) gains `lastDurationMs` and
+  `recent` — a window of the last 12 outcomes, oldest first. Both are folded by
+  the same `foldScenarioRun` the live path and `rebuild()` already share, so
+  the index stays fully derived from the run manifests. Feeds the viewer's
+  overview dashboard without a request per scenario.
+
+  `RUN_INDEX_SCHEMA_VERSION` → 2: an index file from the previous version is
+  discarded and rebuilt on start, as before. Nothing to do on upgrade.
+
+## [0.18.0] - 2026-08-23
+
+### Minor Changes
+
+- 44f5d6c: Editor typings for scenarios — `.js` files stop looking like broken
+  JavaScript in VS Code / WebStorm: autocomplete, hover docs, signature
+  help and locator-chain resolution, without turning on a second
+  type-checker (`checkJs` stays off; diagnostics remain the DSL
+  validator's job).
+
+  - New shipped file `types/unotest-dsl.d.ts` — ambient declarations for
+    every DSL function, generated from the same contracts the validator
+    uses (`buildDslVocab()`), so it can never drift from the installed
+    version.
+  - New CLI command `unotest-web types` — creates `unotest/jsconfig.json`
+    if missing and regenerates the `.unotest/types/env.d.ts` cache
+    (variable NAMES from `unotest/.env` / `.secrets`; values never leave
+    those files).
+  - `init` scaffolds the jsconfig + env cache; `scaffoldWorkspace()` now
+    includes the jsconfig too.
+  - Upgrade path is automatic: `lint` and `e2e` create a missing
+    `unotest/jsconfig.json` on the fly (one announcement line) and
+    silently refresh the env cache. Skipped under CI. No action needed
+    after upgrading — run any test or `unotest-web lint` once and the
+    editor comes alive. If you keep a custom `unotest/jsconfig.json`, it
+    is never overwritten (re-run `init --force` to reset it).
+  - `@unotest/protocol`: additive optional fields on the DSL vocab —
+    `DslVocabArg.enumValues` (literal members behind `kind: "enum"`) and
+    `DslVocabEntry.variadic`.
+
+- 9726552: Go-to-definition for project helpers in the viewer's editor: Ctrl/⌘-click
+  (or F12) on a `flow_*` call opens the `_helpers/` file in its tab with
+  the declaration line highlighted and scrolled into view. Ctrl-hover shows
+  a preview of the helper body. Platform functions (`click`, `goto`) have
+  no jump target and produce no console errors. `@unotest/protocol`:
+  additive optional `DslVocabEntry.source` (project-relative path + 1-based
+  line/column of the declaration).
+
+### Patch Changes
+
+- 5ab7bd5: `screenshot()` appears in the DSL vocab (completion, hover, signature
+  help, generated editor typings). It always had a validator contract, but
+  its diagnostics contract group was missing from the vocab builder, so
+  every vocab consumer silently lacked it. A parity test now pins the vocab
+  to the contract registry, so a future contract group cannot be forgotten
+  again. `@unotest/protocol`: new `DslVocabCategory` value `"diagnostic"`.
+
 ## [0.17.0] - 2026-08-20
 
 ### Patch Changes