Eve library

UX-008 Certification: Failure Recovery Journey

Guide

Revision 1

On this page

Date: 2026-02-22
Checklist Item: UX-008
Ticket: ISIS-0233

Journey Scope#

User state: authenticated job manager/operator
Journey: failed job detected -> clone config into submission studio -> generate support context bundle -> report issue draft -> retry failed job
Coverage target: all recovery interactions are available in the jobs UI and test-covered

Evidence Matrix#

Requirement Evidence Status
Retry action is available for recoverable failures apps/isis/web/src/pages/JobsPage.tsx exposes Retry action for retry-eligible statuses via canRetryJob(...), then executes retryJobWithFallback(...) through managed mutation handling. Pass
Clone config is available and pre-fills studio apps/isis/web/src/pages/JobsPage.tsx adds Clone Config action and buildStudioPrefillFromJob(...); apps/isis/web/src/pages/JobSubmissionStudio.tsx accepts prefillValues and hydrates form values via useEffect. Pass
Report issue produces support-ready context payload apps/isis/web/src/pages/JobsPage.tsx adds Report Issue and Support Bundle actions using buildSupportBundle(...), rendering a support JSON panel with clear/remove controls. Pass
Support bundle includes recovery-critical diagnostics buildSupportBundle(...) serializes job identity, status, progress, worker, queue metrics, timing fields, input, metadata, callback URL, and error payload with version marker isis-support-context-v1. Pass
End-to-end journey is regression tested apps/isis/web/src/pages/JobsPage.spec.tsx test supports failure recovery workflow with retry, clone config, report issue, and support bundle verifies clone prefill, report/bundle generation, and retry invocation. Pass
App-level surface remains stable pnpm --filter @isis/web exec vitest run src/App.e2e.spec.tsx passes after integration, confirming no route-level regressions from recovery journey additions. Pass

Reproduction Commands#

bash
pnpm --filter @isis/web exec vitest run src/pages/JobsPage.spec.tsx
pnpm --filter @isis/web exec vitest run src/App.e2e.spec.tsx