How-to guide · local environment
Kill the workers and observe recovery
Run both acts with the deterministic fixture. The baseline loses its in-memory continuation, while the Temporal run resumes from recorded history.
Before you begin
Install Node.js 24 or later, npm, Docker, and Chromium for Playwright. The live
Codex path also requires the codex CLI and a local Codex login.
Start the application
-
Install the dependencies and Chromium:
package installationshellscript npm installnpx playwright install chromium -
Start Temporal:
local servicesshellscript npm run temporal:up -
Build and start the application:
demo servershellscript npm run buildnpm start -
Open the local demo. Temporal's development UI is available on port
8233.
For the Live Codex path, verify the Codex login and Temporal connection before you start the application:
npm run preflight
Reproduce process-owned failure
- Select Baseline and Fixture.
- Click Start run.
- After the investigators begin, click Kill workers, then confirm Stop workers.
- Click Restart workers.
The baseline creates a fresh workspace and starts a new in-memory run. Its progress returns to the beginning.
Recover the history-owned run
- Select Temporal and Fixture.
- Click Start run.
- After at least one branch completes, click Kill workers, then confirm Stop workers.
- Inspect the open Workflow in Temporal's development UI.
- In the demo, click Restart workers.
The replacement Worker replays Event History, reuses recorded results, and continues unfinished Activities. The final receipt shows four passing tests and the one-line retry fix. The completed Workflow remains recorded after its run-specific Worker exits.
The browser stores only the selected mode, runner, and run IDs. After a page refresh, it reloads each snapshot from the API supervisor. Restarting the API clears its in-memory run registry, so browser persistence does not extend across an API restart.
Verify the repository
Run the automated checks from the repository root:
npm testnpm run test:e2enpm run checknpm run buildnpm run docs:build
The Playwright suite drives both acts through the real kill and restart endpoints. The Temporal integration suite interrupts Activity execution and verifies that a completed Child Workflow runs once.
Stop local services
After the demonstration, stop the Temporal container:
npm run temporal:down