@unotest/viewer 0.24.0 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,183 @@
 # Changelog
 
+## [0.26.0] - 2026-08-30
+
+### Minor Changes
+
+- 3eede7c: The viewer can now be hosted: it shows which test bundle an environment
+  is running, and lets you switch it.
+
+  This is the other half of `bundle push`. Nothing changes for a local
+  viewer — everything here appears only when something is hosting it.
+
+  - **The artifact root and the project root are now genuinely separate.**
+    The viewer already took `UNOTEST_ARTIFACTS_ROOT` for the run queue;
+    run discovery, the run index, snapshots, log capture and the viewer's
+    own lock file now honour it too. Locally the two are the same directory
+    and nothing moves. Where they differ — sources in a disposable copy of a
+    bundle, history in the environment beside it — the history is no longer
+    read out of (or written into) the sources.
+  - **Bundle badge in the status bar.** `main@1a2b3c4`, or `wip` for a
+    bundle packed from an uncommitted tree, with the author, the pinned
+    `@unotest/web` and who switched the environment last. Clicking it lists
+    the bundles pushed to this environment and switches to one — that runs
+    as a maintenance ticket on the host, so it waits for the environment to
+    be free instead of pulling the code out from under a running suite.
+  - **Runs remember their bundle.** `manifest.json` and `GET /api/runs`
+    carry `bundleId` (from `UNOTEST_BUNDLE_ID`, set by the host); the runs
+    list marks the ones that ran on another bundle, so "was this red run
+    even the code I am looking at?" has an answer.
+  - **The contract is a file, not a mode.** `@unotest/protocol` gains
+    `WorkspaceFile` — the host writes `unotest/.workspace.json` beside the
+    artifacts and the viewer reads it, the same way the guard's session
+    header narrows the UI. No file, no bundle UI; the viewer never learns
+    what a box is. Values of environment variables and secrets never appear
+    in it — only their names.
+  - **Queue tickets can name a bundle.** `QueueTicket.source.bundleId` is
+    recorded when a run is queued, so a run executes the code it was
+    ordered with even if the environment moved on while it waited.
+
+- dbfa36f: Your CI can now ask a box to run the suite it just pushed, and a box can
+  report the result back to GitHub.
+
+  ```sh
+  npx @unotest/web bundle push --run --env test --collection smoke
+  ```
+
+  `--run` sends the second half of the CI recipe: upload the bundle, then
+  order a run of it. Two requests rather than one flag on the upload,
+  because a bundle is _content_ — pushing an identical tree twice is normal
+  and answers `exists` — while "run it" is an event. The same split is what
+  lets a deploy script run a bundle somebody pushed hours ago.
+
+  - **The box answers as soon as the runs are queued** (202) with their run
+    ids. A suite takes minutes to hours; an HTTP request held open for that
+    long is a timeout in somebody's proxy, not a result. The ids are real
+    from the moment you get them, so a CI log can print a link into the
+    viewer straight away.
+  - **`--env <name>` is required with `--run`.** Which environments a box
+    has is the operator's decision, and guessing one would be guessing
+    which system gets tested.
+  - **Without `--collection`, the box runs what that environment normally
+    runs** — the collections its `schedules` name. Naming them explicitly is
+    the deploy-check case; leaving it out is the "same as every night" case.
+  - **`--pr <number>` coalesces.** A newer push of the same pull request
+    withdraws its older runs that are still _waiting_; a run that already
+    started is never killed. Three pushes in five minutes cost one suite.
+    `--json` reports how many were withdrawn, so "my run vanished" has an
+    answer in the log of the run that replaced it.
+  - **Refusals are typed and say what to do**: no such environment, an
+    environment belonging to another project, a bundle the box no longer
+    holds, nothing to run.
+
+  On a hosted viewer, the queue panel now names the change each machine
+  ticket belongs to (`PR #412@1a2b3c4`) instead of a row of identical "ci"
+  entries, and the history gained a **this bundle only** filter for the
+  moment you are judging the bundle in front of you rather than the last
+  month of runs.
+
+  Nothing changes for a local `npx @unotest/web viewer`: there are no
+  bundles there, so neither the badge nor the filter appears.
+
+- c43aa00: Runs of one project now take turns instead of colliding.
+
+  Until now nothing coordinated them: the viewer refused a second run with
+  HTTP 409, and that was the whole defence — a `npx @unotest/web e2e` in a
+  terminal, an agent's `run_test` and a scheduled suite would all start on
+  top of each other, driving the same browser and the same seeded database
+  at the same time. The 409 protected the UI, not the machine.
+
+  - **A filesystem queue**, in `unotest/.queue<target>[.<env>]/` beside the
+    runs root it belongs to. A run writes a ticket, waits until it is at
+    the head, takes a slot, runs, and gives the slot back. There is no
+    daemon: whoever holds the slot executes the run itself, so nothing new
+    has to be installed, started or kept alive. Only `open("wx")`, rename,
+    unlink and mtime — no `flock`, which lies on network and container
+    filesystems. A crashed producer is reaped by whoever comes next.
+  - **Every producer is in it**: the CLI (`e2e`, `collection`, `author`),
+    the viewer's Run button, and the MCP `run_test` (which spawns the CLI).
+    A collection is ONE run — its `workers` still run in parallel inside
+    it, because a child process carries its parent's lease and skips the
+    queue.
+  - **The viewer shows the queue**: the Active panel lists what is waiting,
+    including tickets a terminal or an agent wrote, with a button to take
+    any of them back out. `GET /api/queue`, `DELETE /api/queue/:ticket`,
+    and a `queue:changed` websocket message.
+  - **Config**: `queue.concurrency` (default 1) and `queue.enabled`
+    (default true) in `unotest.config`. Both the CLI and the viewer read
+    the same file, so they cannot disagree about how many slots exist.
+  - **Escape hatches**: `UNOTEST_NO_QUEUE=1` runs without queueing;
+    Ctrl-C while waiting gives up your place in line and runs nothing.
+  - **For boxes**: `UNOTEST_QUEUE_GLOBAL_DIR` + `UNOTEST_QUEUE_GLOBAL_SLOTS`
+    add a host-wide budget several environments share (a collection weighs
+    its worker count), and `UNOTEST_ARTIFACTS_ROOT` puts `.runs` / `.queue`
+    somewhere other than the directory the tests live in — so the history
+    outlives a throwaway copy of the tests.
+
+  ### Migration notes
+
+  **`POST /api/run` no longer answers 409.** Ordering a run while another
+  one is active used to fail with `ActiveRunConflictError` (HTTP 409); it
+  now succeeds and the run waits. The response changed shape with it:
+
+  ```diff
+  - { runId, kind, ref, pid, startedAt }
+  + { runId, kind, ref, status: "queued" | "running", ticket, acceptedAt }
+  ```
+
+  `runId` is still final and immediately usable — open the tab on it as
+  before — but the run may not have started yet, and `pid` is not known at
+  that point. `POST /api/runs/:runId/abort` covers both states: it
+  withdraws a waiting ticket or SIGTERMs a running child.
+
+  Anything that treated 409 as "busy, try later" should now simply order
+  the run. Anything that relied on "only one run can exist" should read
+  `GET /api/queue`. To keep the old immediate-start behaviour (without the
+  protection), set `queue.enabled: false`.
+
+### Patch Changes
+
+- Updated dependencies [3eede7c]
+- Updated dependencies [6d1c612]
+- Updated dependencies [dbfa36f]
+- Updated dependencies [c43aa00]
+- Updated dependencies [8ec4177]
+  - @unotest/protocol@0.26.0
+  - @unotest/core@0.26.0
+  - @unotest/dsl@0.26.0
+
+## [0.25.0] - 2026-08-29
+
+### Minor Changes
+
+- adb9d72: Viewer: a pinned Home tab, a multi-row tab strip, and live tiles on the
+  overview field.
+
+  - **Home tab.** The project-health overview used to render only when no
+    tab was open, so it disappeared exactly while you were working. It is
+    now a pinned first tab: always present, never closable, and what
+    "Close All" leaves you on.
+  - **Multi-row tabs.** The strip wraps instead of scrolling sideways —
+    every open tab is visible at once, up to three rows, then it scrolls.
+    Tabs are pills now: the active one is filled like a selected tree row,
+    inactive ones are plain text until hovered. Middle-click closes a tab,
+    the `⋮` button opens the same actions as a right-click, and the strip
+    is a proper `tablist` for screen readers.
+  - **Live tiles.** A scenario that is running right now breathes on the
+    overview field — the tile fades in and out under a warm ring (a still
+    ring when paused, since nothing is moving). Status colour, tile order
+    and the counters/filters stay exactly as they were until the run
+    finishes.
+
+  `@unotest/protocol` gains the `overview` tab kind in the `TabKind` union.
+
+### Patch Changes
+
+- Updated dependencies [70f2e11]
+- Updated dependencies [adb9d72]
+  - @unotest/protocol@0.25.0
+  - @unotest/dsl@0.25.0
+
 ## [0.24.0] - 2026-08-26
 
 ### Patch Changes

package/dist/server/main.d.ts

@@ -1,5 +1,13 @@
 import { IRunnerAdapter, IDslLanguageService, IProcessLauncher } from '@unotest/protocol';
 
+interface ViewerQueueConfig {
+    /** With queueing off, the viewer starts every run immediately — and
+     *  so does every terminal. Nothing serialises them. */
+    readonly enabled: boolean;
+    /** Runs allowed in flight for one environment. */
+    readonly concurrency: number;
+}
+
 interface RunnerEntry {
     /** Short target id derived from the runner package name —
      *  `web`/`mobile`/`unity`. Drives the UI switcher and per-target tree
@@ -38,6 +46,14 @@ interface StartViewerOptions {
      *  injects its bundled `node` + runner bin so terminal commands resolve
      *  without a system install). */
     terminalPathPrefix?: readonly string[];
+    /** Run-queue policy, read from the project's `unotest.config` by the
+     *  launcher. Omitted (the standalone bin) = the shipped default: queue
+     *  on, one run at a time. Both the viewer and the CLI must see the SAME
+     *  numbers — they share one queue directory. */
+    queue?: ViewerQueueConfig;
+    /** Absolute artifact root when it is not the project root
+     *  (`UNOTEST_ARTIFACTS_ROOT`); see `ViewerConfig.artifactsRoot`. */
+    artifactsRoot?: string;
 }
 interface ViewerHandle {
     url: string;