@unotest/core 0.30.0 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.31.0] - 2026-09-04
+
+### Minor Changes
+
+- 100ab9d: `buildRuntimeInspection` keeps `stepTag` and `soft` on `lastFailure` and
+  passes the runtime's `softFailures` list through into `runtime.json`, so
+  `inspect_runtime` and `run_test` can report the case a data-driven step
+  was on and every soft step that failed.
+
+### Patch Changes
+
+- b8e105b: `capUtf8(text, maxBytes)` — cut a string to a UTF-8 byte budget without
+  splitting a code point — exported next to `JOURNAL_TEXT_CAP_BYTES`
+  (4 KB). The runtime-state var snapshot now caps by bytes through it (it
+  used to count UTF-16 units); the run journal's `note` / `log` payloads
+  use the same cap.
+- Updated dependencies [b8e105b]
+- Updated dependencies [9ae6d59]
+- Updated dependencies [56784b3]
+- Updated dependencies [e048334]
+- Updated dependencies [100ab9d]
+- Updated dependencies [100ab9d]
+- Updated dependencies [ad7c918]
+- Updated dependencies [ad7c918]
+- Updated dependencies [dcf4c9e]
+  - @unotest/protocol@0.31.0
+  - @unotest/dsl@0.31.0
+
 ## [0.30.0] - 2026-09-03
 
 ### Patch 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, ScheduleEntry } from '@unotest/protocol';
+import { RunArtifact, RunManifest, RunSources, RuntimeStateFile, SoftFailureRecord, 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';
 
@@ -91,7 +91,7 @@ type RuntimeExecState = "starting" | "running" | "paused-step" | "paused-failure
 /** Normalized, protocol-shaped runtime view assembled from a manager snapshot.
  *  Feeds straight into `RuntimeStateFile` (the writer adds runId / wsEndpoint /
  *  wheel / updatedAt) — hence a Pick, not a re-spelled mirror. */
-type RuntimeInspection = Pick<RuntimeStateFile, "scenario" | "testFn" | "state" | "current" | "vars" | "callStack" | "lastFailure">;
+type RuntimeInspection = Pick<RuntimeStateFile, "scenario" | "testFn" | "state" | "current" | "vars" | "callStack" | "lastFailure" | "softFailures">;
 /** Raw inputs from a `TestRuntimeManager.inspect()` snapshot, before
  *  protocol-normalization. `lastFailure` is the manager's richer record; only
  *  line/col/message survive into the protocol form. */
@@ -108,7 +108,13 @@ interface RuntimeInspectionInput {
             message: string;
             name?: string;
         };
+        /** Evaluated `{tag}` of the enclosing `step(...)`, when any. */
+        stepTag?: string;
+        /** The failure sat inside a `step.soft(...)` — the run went on. */
+        soft?: boolean;
     } | null;
+    /** Failed `step.soft(...)` blocks so far, in run order. */
+    softFailures?: readonly SoftFailureRecord[];
 }
 declare function buildRuntimeInspection(input: RuntimeInspectionInput, stringifyVar: (v: unknown) => string): RuntimeInspection;
 declare function toProtocolRuntimeState(state: RuntimeExecState, lastEvent: ExecutionEvent | null): RuntimeState;
@@ -121,6 +127,17 @@ declare function extractCallStack(ev: ExecutionEvent | null): {
     file: string;
     line: number;
 }[];
+/** Cut `s` to at most `maxBytes` of UTF-8 without splitting a code point.
+ *  Shared by the runtime-state var snapshot and the run journal's `note` /
+ *  `log` events, so "what fits in a line" means one thing everywhere. */
+declare function capUtf8(s: string, maxBytes: number): {
+    text: string;
+    truncated: boolean;
+};
+/** The journal's cap for one `note` / `log` payload — the same 4 KB the
+ *  var snapshot uses: a small object or a response body fits, an HTML
+ *  document does not. */
+declare const JOURNAL_TEXT_CAP_BYTES = 4096;
 
 /** Runner-specific extras merged into every snapshot. Evaluated on each write
  *  so live values (the current wheel owner) stay fresh. */
@@ -498,4 +515,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, computeSchedulesFingerprint, 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, JOURNAL_TEXT_CAP_BYTES, 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, capUtf8, 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

@@ -171,8 +171,11 @@ function buildRuntimeInspection(input, stringifyVar) {
     lastFailure: input.lastFailure ? {
       line: input.lastFailure.line,
       col: input.lastFailure.col,
-      error: { message: input.lastFailure.error.message }
-    } : null
+      error: { message: input.lastFailure.error.message },
+      ...input.lastFailure.stepTag !== void 0 ? { stepTag: input.lastFailure.stepTag } : {},
+      ...input.lastFailure.soft ? { soft: true } : {}
+    } : null,
+    ...input.softFailures && input.softFailures.length > 0 ? { softFailures: input.softFailures.map((f) => ({ ...f })) } : {}
   };
 }
 __name(buildRuntimeInspection, "buildRuntimeInspection");
@@ -227,10 +230,25 @@ function serializeVars(vars, stringifyVar) {
 }
 __name(serializeVars, "serializeVars");
 function truncate(s) {
-  if (s.length <= VAR_TRUNCATE_BYTES) return s;
-  return s.slice(0, VAR_TRUNCATE_BYTES) + "\u2026";
+  const capped = capUtf8(s, VAR_TRUNCATE_BYTES);
+  return capped.truncated ? `${capped.text}\u2026` : capped.text;
 }
 __name(truncate, "truncate");
+function capUtf8(s, maxBytes) {
+  const encoder = new TextEncoder();
+  if (encoder.encode(s).byteLength <= maxBytes) return { text: s, truncated: false };
+  let bytes = 0;
+  let end = 0;
+  for (const ch of s) {
+    const size = encoder.encode(ch).byteLength;
+    if (bytes + size > maxBytes) break;
+    bytes += size;
+    end += ch.length;
+  }
+  return { text: s.slice(0, end), truncated: true };
+}
+__name(capUtf8, "capUtf8");
+var JOURNAL_TEXT_CAP_BYTES = VAR_TRUNCATE_BYTES;
 
 // src/runtime-state-writer.ts
 import { RUNTIME_FILE } from "@unotest/protocol";
@@ -1578,6 +1596,7 @@ export {
   BundlePathError,
   BundleTooLargeError,
   FsRunQueue,
+  JOURNAL_TEXT_CAP_BYTES,
   JsonlRunArtifactWriter,
   QueueTicketLostError,
   QueueUnavailableError,
@@ -1587,6 +1606,7 @@ export {
   applyEnvLayers,
   assertSafeBundlePath,
   buildRuntimeInspection,
+  capUtf8,
   computeBundleId,
   computeSchedulesFingerprint,
   computeTreeSha256,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unotest/core",
-  "version": "0.30.0",
+  "version": "0.31.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.30.0",
-    "@unotest/protocol": "^0.30.0"
+    "@unotest/protocol": "^0.31.0",
+    "@unotest/dsl": "^0.31.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",