---
id: TST-PFM-OPS-002
title: Job state machine
kind: unit
product_area: platform
module: operations
revision: 1
status: draft
source_sha:
  macroservice-libraries: 54536a441935c6e09fdb7f96f0bec71c52ba4e03
repository: macroservice-libraries
files:
  - packages/jobs/src/aws/job-state-machine.spec.ts
implements: []
environment: local
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 1
estimate_basis: Scheduling estimate only; no duration is measured during this documentation pass.
isolation: 'Process-local inputs, registries and test adapters.'
evidence:
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts at
    54536a441935c6e09fdb7f96f0bec71c52ba4e03: existing suite body, setup, assertions and cleanup.
binding_note: This existing engineering suite is registered without claiming a complete specification scenario.
assertion_sources:
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts#retains the state machine by
    default, so moving it never stops its executions
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts#retains its log group by
    default as well
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts#applies a removal policy given
    to the state machine as well as to the log group
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts#names the four errors Lambda
    answers when the task function never ran
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts#retries throttling first on
    every task, the failure task included, with jittered bounded backoff
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts#keeps each task's own retry
    after it, so States.ALL stays last
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts#retries throttling with the
    task's own throttle retry where it names one, and the default where it does not
  - >-
    macroservice-libraries:packages/jobs/src/aws/job-state-machine.spec.ts#runs a repeating task again
    through a Wait state of its seconds, so the waiting holds no Lambda
---

# Job state machine

## Verification Boundary

This suite exercises background work through its declared function or structural boundary. Its implementation is present at the pinned source revision, and this register records no execution result.

## What This Suite Proves

The checks exercise job state machine within the file’s declared setup and assertion boundary. The structured assertion anchors distinguish these checks from the surrounding feature flows. No complete specification scenario is attributed to this suite yet.

## What It Does Not Prove

Local execution does not establish deployed infrastructure, live commercial-provider configuration or authorization-cache completion. Registration and an implemented suite do not establish a passing result.

## Real Dependencies and Test Doubles

The production logic under assertion is real. Infrastructure assertions inspect synthesized templates without deployment.

## Must Not Be Doubled

The production function, registry or builder under assertion remains real.