@ultimat3/jobs 30.4.0 → 30.5.0

package/CLAUDE.md

@@ -212,8 +212,8 @@ Long form: [`docs/history/jobs.md`](../../docs/history/jobs.md), "Moved 2026-10-
 | `consumer.ts` / `consumer-loop.ts` / `consumer-types.ts` | `consumer()` — a job + `.supervisor` task; one run's turns; the shapes |
 | `consumer-registry.ts` / `consumer-guard.ts` / `consumer-errors.ts` | the `origin` stamp + `registeredConsumers`; the self-enqueue refusal; `X_CONSUMER_*` |
 | `register.ts` | `registerJobs`/`registerTasks` over a module namespace + the registrar announcements; an `action-job` projection is `X_ACTION_JOB_UNBRIDGED` |
-| `describe.ts` | the JSON projection one handle emits; `describeJobs()` is a map over it |
-| `steps.ts` / `-core.ts` / `-wait.ts` / `-unwind.ts` | replay runner; shared core; `waitForEvent`; compensation |
+| `describe.ts` | one handle's JSON projection; `describeJobs()` maps it |
+| `steps.ts` / `-core.ts` / `-wait.ts` / `-unwind.ts` / `step-scope.ts` | replay runner; core; `waitForEvent`; compensation; `currentStep()` |
 | `steps-timeout.ts` / `steps-suspension.ts` | a step's ceiling; `StepSuspension`, `UnwindReached`, timeout marker |
 | `steps-api.ts` / `steps-store.ts` / `steps-output.ts` | `StepApi`, `EventLookup`; `StepRecord`, `StepFence`, `StepStore`; what a step answers, `StepOutput` and `jsonForm` |
 | `type-pins.ts` | compile-time pins for `StepOutput` and `waitForEvent` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/jobs",
-  "version": "30.4.0",
+  "version": "30.5.0",
   "description": "Durable background work: steps, transactional outbox, cron tasks, one driver interface",
   "keywords": [
     "ultimate",
@@ -44,11 +44,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "30.4.0",
-    "@ultimat3/db": "30.4.0",
-    "@ultimat3/entity": "30.4.0",
-    "@ultimat3/http": "30.4.0",
-    "@ultimat3/schema": "30.4.0",
-    "@ultimat3/time": "30.4.0"
+    "@ultimat3/core": "30.5.0",
+    "@ultimat3/db": "30.5.0",
+    "@ultimat3/entity": "30.5.0",
+    "@ultimat3/http": "30.5.0",
+    "@ultimat3/schema": "30.5.0",
+    "@ultimat3/time": "30.5.0"
   }
 }

package/src/index.ts

@@ -430,6 +430,7 @@ export type { ScheduledFire, SchedulerState } from './scheduler-state';
 export { fireThroughDriver, memorySchedulerState } from './scheduler-state';
 export type { JobCompleted, JobFailed, JobSettled } from './settled';
 export { ON_SETTLED_ATTEMPTS, ON_SETTLED_TIMEOUT_MS } from './settled';
+export { currentStep } from './step-scope';
 export type {
   CompensateContext,
   EventLookup,

package/src/step-scope.ts

@@ -0,0 +1,13 @@
+// Which durable step's body is running, ambient across its awaits. Read by an observer that must
+// tell an effect made INSIDE a step (rerun when the step did not complete) from one made between
+// steps (rerun on every replay): `@ultimat3/testing`'s crash proof names the step it ran in.
+
+import { asyncContext } from '@ultimat3/core';
+
+const scope = asyncContext<string>('a durable step body');
+
+/** Run one step body with its name in flight. `steps.ts` is the one caller. */
+export const inStep = <T>(name: string, body: () => T): T => scope.run(name, body);
+
+/** The name of the step whose body is running here, or `undefined` outside every step body. */
+export const currentStep = (): string | undefined => scope.get();

package/src/steps.ts

@@ -21,6 +21,7 @@ import {
   UNWINDING_STEP,
 } from './errors-saga';
 import { createRunSignal } from './run-signal';
+import { inStep } from './step-scope';
 import type { EventLookup, StepApi, StepRunOptions } from './steps-api';
 import { DEFAULT_EVENT_POLL_MS, WAKING_EVENT_POLL_MS } from './steps-api';
 import type { RunnerCore } from './steps-core';
@@ -297,7 +298,7 @@ export function stepRunner(options: StepRunnerOptions): StepRunner {
     const signal = composed?.signal ?? runSignal;
     try {
       const output = await withStepTimeout(
-        fn(signal),
+        inStep(name, () => fn(signal)),
         stepTimeoutMs,
         deadline,
         () =>