@unotest/core 0.26.0 → 0.27.0

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # Changelog
 
+## [0.27.0] - 2026-08-31
+
+### Minor Changes
+
+- New `computeSchedulesFingerprint(entries)` — sha256 of
+  `canonicalScheduleSet` from `@unotest/protocol` (the canon lives
+  there, the crypto here). `BundleProvenance` gains optional
+  `schedulesFingerprint`, carried into the packed manifest: what lets a
+  box compare the schedule set it reads with the set the pusher saw.
+
+- c843d21: Schedules from the viewer — for collections and single tests.
+
+  Right-click a test or a collection in the viewer → **Schedule…**: a
+  human schedule builder (frequency select — every 5/15 min, hourly,
+  every 2/4/6/12 h, daily, weekly — plus toggle badges for minutes,
+  hours and weekdays; multi-select, so `04` + `16` × `00` + `30` runs
+  four times a day). Saved to `unotest/schedules.yaml`, versioned next
+  to the tests; a box applies it after commit & sync. The Home screen
+  gains a `last run | schedule` toggle: in schedule mode tiles are
+  tinted by how often a test runs (grey = not scheduled), with an
+  upcoming list and per-tile next-run times in your browser's clock.
+
+  Under the hood:
+
+  - `unotest/schedules.yaml` is a new schedule registry; `unotest-web
+schedules [--json]` prints it merged with the config's `schedules`
+    (the file wins on a duplicate target), so boxes pick both up
+    unchanged.
+  - A schedule entry may now target a single test: `scenario:
+<ref>` instead of `collection: <name>`.
+  - `unotest-web e2e <name> --scheduled[=index]` runs a test the way its
+    entry says (env + prepare, exit 94 when prepare fails) — the
+    per-test mirror of `collection --scheduled`.
+  - Viewer server: `GET/PUT /api/schedules` (validated by the same
+    parser the CLI reads the file with).
+
+### Patch Changes
+
+- Updated dependencies [c843d21]
+  - @unotest/protocol@0.27.0
+  - @unotest/dsl@0.27.0
+
+## [0.26.1] - 2026-08-30
+
+### Patch Changes
+
+- `packBundle` accepts `declaredVariables` — the external NAMES a suite
+  declares, carried in the manifest so a box can tell a pusher which of
+  them it has no value for. Names only; the files that hold the values
+  are excluded from every bundle as before.
+
+- Updated dependencies [9424f6b]
+  - @unotest/protocol@0.26.1
+  - @unotest/dsl@0.26.1
+
 ## [0.26.0] - 2026-08-30
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { RunArtifact, RunManifest, RunSources, RuntimeStateFile, RuntimeState, DbgCommand, PickerMode, DbgCommandRecord, DbgCommandProbe, IRunQueue, EnqueueRunInput, RunQueueTicketHandle, QueueSnapshot, QueueTicket, RunQueueLease, BundleGitInfo, BundleManifest } from '@unotest/protocol';
+import { RunArtifact, RunManifest, RunSources, RuntimeStateFile, RuntimeState, DbgCommand, PickerMode, DbgCommandRecord, DbgCommandProbe, IRunQueue, EnqueueRunInput, RunQueueTicketHandle, QueueSnapshot, QueueTicket, RunQueueLease, BundleGitInfo, BundleManifest, ScheduleEntry } from '@unotest/protocol';
 export { isRecord } from '@unotest/protocol';
 import { ExecutionEvent } from '@unotest/dsl/executor';
 
@@ -222,6 +222,13 @@ interface E2EFlags {
      *  Empty when --break wasn't passed — caller falls back to the
      *  `.debugger[-suffix].json` breakpoint store. */
     breakFlag: string[];
+    /** Scheduled run (`--scheduled[=index]`): honour the scenario's
+     *  schedules entry — its env and prepare. Mirrors the collection
+     *  command's flag. */
+    scheduled: boolean;
+    /** WHICH schedules entry (zero-based position in the merged list),
+     *  when the executor pins it. */
+    scheduleIndex?: number;
 }
 declare function parseE2EFlags(args: string[]): E2EFlags;
 
@@ -421,6 +428,14 @@ interface BundleProvenance {
     webVersion: string;
     author?: string;
     git?: BundleGitInfo;
+    /** Names of the externals the suite declares. The files that hold them
+     *  never travel (their values belong to an environment), so the names
+     *  ride in the manifest — that is what lets a box say at upload which
+     *  of them it cannot supply. */
+    declaredVariables?: readonly string[];
+    /** `computeSchedulesFingerprint` of the effective schedules at pack
+     *  time — see the manifest field's doc in `@unotest/protocol`. */
+    schedulesFingerprint?: string;
 }
 interface PackedBundle {
     bundleId: string;
@@ -441,6 +456,13 @@ interface UnpackOptions {
 }
 declare function unpackBundle(archive: Uint8Array, options?: UnpackOptions): UnpackedBundle;
 
+/** sha256 of the canonical effective schedule set — what `bundle push`
+ *  records in the manifest (`schedulesFingerprint`) and a box re-computes
+ *  after reading `schedules --json` in its own environment. Equal hashes
+ *  mean the box arms exactly the set the pusher saw; different hashes
+ *  mean the project's config computed schedules from its surroundings. */
+declare function computeSchedulesFingerprint(entries: readonly ScheduleEntry[]): string;
+
 /** The archive is not a readable bundle: broken gzip, a truncated tar, a
  *  header whose checksum does not add up, a member that is not a plain
  *  file. Everything a box refuses BEFORE writing anything to disk. */
@@ -476,4 +498,4 @@ declare class BundleIdMismatchError extends UnotestError {
     constructor(claimed: string, computed: string);
 }
 
-export { type ArtifactRedactor, type BundleFile, BundleFormatError, BundleIdMismatchError, BundlePathError, type BundleProvenance, BundleTooLargeError, type DebugCommandsWatcherDeps, type DebugControlTarget, type DebugWatcherLogger, type E2EFlags, FsRunQueue, type FsRunQueueOptions, type GitignoreUpdate, type GlobalPoolOptions, type IRunArtifactWriter, JsonlRunArtifactWriter, type JsonlRunArtifactWriterOptions, type PackedBundle, QueueTicketLostError, QueueUnavailableError, QueueWaitAbortedError, type RunHeartbeat, type RuntimeExecState, type RuntimeInspection, type RuntimeInspectionInput, type RuntimeStateExtra, type RuntimeStateWriter, type RuntimeStateWriterDeps, type TarEntry, UnotestError, type UnpackOptions, type UnpackedBundle, type WriteManifestInput, type WriteRunSourcesInput, appendUniqueLines, applyEnvLayers, assertSafeBundlePath, buildRuntimeInspection, computeBundleId, computeTreeSha256, createRunArtifactWriter, createRuntimeStateWriter, currentLocation, extractCallStack, globalPoolFromEnv, leaseEnv, levenshteinDistance, packBundle, parseE2EFlags, readDebuggerBreakpoints, readEnvFile, readEnvLayers, readTar, startDebugCommandsWatcher, startRunHeartbeat, suggestClosest, toProtocolRuntimeState, unpackBundle, writeRunManifest, writeRunSources, writeTar };
+export { type ArtifactRedactor, type BundleFile, BundleFormatError, BundleIdMismatchError, BundlePathError, type BundleProvenance, BundleTooLargeError, type DebugCommandsWatcherDeps, type DebugControlTarget, type DebugWatcherLogger, type E2EFlags, FsRunQueue, type FsRunQueueOptions, type GitignoreUpdate, type GlobalPoolOptions, type IRunArtifactWriter, JsonlRunArtifactWriter, type JsonlRunArtifactWriterOptions, type PackedBundle, QueueTicketLostError, QueueUnavailableError, QueueWaitAbortedError, type RunHeartbeat, type RuntimeExecState, type RuntimeInspection, type RuntimeInspectionInput, type RuntimeStateExtra, type RuntimeStateWriter, type RuntimeStateWriterDeps, type TarEntry, UnotestError, type UnpackOptions, type UnpackedBundle, type WriteManifestInput, type WriteRunSourcesInput, appendUniqueLines, applyEnvLayers, assertSafeBundlePath, buildRuntimeInspection, computeBundleId, computeSchedulesFingerprint, computeTreeSha256, createRunArtifactWriter, createRuntimeStateWriter, currentLocation, extractCallStack, globalPoolFromEnv, leaseEnv, levenshteinDistance, packBundle, parseE2EFlags, readDebuggerBreakpoints, readEnvFile, readEnvLayers, readTar, startDebugCommandsWatcher, startRunHeartbeat, suggestClosest, toProtocolRuntimeState, unpackBundle, writeRunManifest, writeRunSources, writeTar };

package/dist/index.js

@@ -423,11 +423,19 @@ __name(runCapability, "runCapability");
 function parseE2EFlags(args) {
   const positional = [];
   let debug = false;
+  let scheduled = false;
+  let scheduleIndex;
   const breakFlag = [];
   for (let i = 0; i < args.length; i++) {
     const a = args[i];
     if (a === "--debug") {
       debug = true;
+    } else if (a === "--scheduled") {
+      scheduled = true;
+    } else if (a.startsWith("--scheduled=")) {
+      scheduled = true;
+      const n = Number(a.slice("--scheduled=".length));
+      if (Number.isInteger(n) && n >= 0) scheduleIndex = n;
     } else if (a === "--break") {
       const next = args[i + 1];
       if (next === void 0 || next.startsWith("--")) {
@@ -441,7 +449,13 @@ function parseE2EFlags(args) {
       positional.push(a);
     }
   }
-  return { positional, debug, breakFlag };
+  return {
+    positional,
+    debug,
+    breakFlag,
+    scheduled,
+    ...scheduleIndex !== void 0 ? { scheduleIndex } : {}
+  };
 }
 __name(parseE2EFlags, "parseE2EFlags");
 function pushBreaks(value, out) {
@@ -1483,7 +1497,9 @@ function packBundle(files, provenance) {
     fileCount: files.length,
     byteSize: files.reduce((total, file) => total + file.content.byteLength, 0),
     ...provenance.author !== void 0 ? { author: provenance.author } : {},
-    ...provenance.git !== void 0 ? { git: provenance.git } : {}
+    ...provenance.git !== void 0 ? { git: provenance.git } : {},
+    ...provenance.declaredVariables && provenance.declaredVariables.length > 0 ? { declaredVariables: [...provenance.declaredVariables] } : {},
+    ...provenance.schedulesFingerprint !== void 0 ? { schedulesFingerprint: provenance.schedulesFingerprint } : {}
   };
   const archive = writeTar([
     ...files,
@@ -1548,6 +1564,14 @@ function gunzip(archive, maxBytes) {
   }
 }
 __name(gunzip, "gunzip");
+
+// src/bundle/schedules-fingerprint.ts
+import { canonicalScheduleSet } from "@unotest/protocol";
+import { createHash as createHash2 } from "crypto";
+function computeSchedulesFingerprint(entries) {
+  return createHash2("sha256").update(canonicalScheduleSet(entries)).digest("hex");
+}
+__name(computeSchedulesFingerprint, "computeSchedulesFingerprint");
 export {
   BundleFormatError,
   BundleIdMismatchError,
@@ -1564,6 +1588,7 @@ export {
   assertSafeBundlePath,
   buildRuntimeInspection,
   computeBundleId,
+  computeSchedulesFingerprint,
   computeTreeSha256,
   createRunArtifactWriter,
   createRuntimeStateWriter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unotest/core",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Shared runner-side utilities for the @unotest ecosystem: JSONL run-artifact writer (steps.jsonl + heartbeat), atomic run-manifest + run-sources writers, atomic runtime-state writer with a protocol-normalizing runtime-inspection helper, layered .env reader/applier (target + environment axes), idempotent .gitignore updater. Used by @unotest/web and @unotest/mobile; depends on @unotest/protocol plus a type-only import of @unotest/dsl/executor event types (M-20). Unlike protocol (pure data), this package owns the thin filesystem layer both runners need.",
   "license": "MIT",
   "publishConfig": {
@@ -29,8 +29,8 @@
   ],
   "dependencies": {
     "chokidar": "^4.0.3",
-    "@unotest/dsl": "^0.26.0",
-    "@unotest/protocol": "^0.26.0"
+    "@unotest/dsl": "^0.27.0",
+    "@unotest/protocol": "^0.27.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",