✨ feat(updates): add recovered and recovery-failed operation phases

- Add recovered-cleanup-temp, recovered-rollback, recovered-active, recovery-failed, and recovery-missing-containers phases to the operation phase enum
- Mirror the phase list in the UI update-operation type so mappers and filters accept them
- List handler and container mapper preserve recovered phases from valid terminal operations

Author: s-b-e-n-s-o-n

app/api/container/handlers/list.test.ts

@@ -96,6 +96,30 @@ describe('attachInProgressUpdateOperation', () => {
     });
   });
 
+  test('keeps recovered rollback phases from valid terminal operations', () => {
+    const container = createContainer();
+    const context = createMockContext({
+      id: 'op-recovered',
+      status: 'rolled-back',
+      phase: 'recovered-rollback',
+      updatedAt: '2026-04-01T12:00:00.000Z',
+      fromVersion: '1.0.1',
+      toVersion: '1.0.0',
+    });
+
+    expect(attachInProgressUpdateOperation(context, container)).toEqual({
+      ...container,
+      updateOperation: {
+        id: 'op-recovered',
+        status: 'rolled-back',
+        phase: 'recovered-rollback',
+        updatedAt: '2026-04-01T12:00:00.000Z',
+        fromVersion: '1.0.1',
+        toVersion: '1.0.0',
+      },
+    });
+  });
+
   test('keeps valid batch queue metadata from active operations', () => {
     const container = createContainer();
     const context = createMockContext({

app/model/container-update-operation.test.ts

@@ -14,6 +14,7 @@ describe('container update operation guards', () => {
 
   test('accepts known phases and rejects non-phase values', () => {
     expect(isContainerUpdateOperationPhase('pulling')).toBe(true);
+    expect(isContainerUpdateOperationPhase('recovered-rollback')).toBe(true);
     expect(isContainerUpdateOperationPhase('rollback-deferred')).toBe(true);
     expect(isContainerUpdateOperationPhase('rollback-failed')).toBe(true);
     expect(isContainerUpdateOperationPhase('unknown')).toBe(false);

app/model/container-update-operation.ts

@@ -21,6 +21,11 @@ export const CONTAINER_UPDATE_OPERATION_PHASES = [
   'health-gate',
   'health-gate-passed',
   'succeeded',
+  'recovered-cleanup-temp',
+  'recovered-rollback',
+  'recovered-active',
+  'recovery-failed',
+  'recovery-missing-containers',
   'rollback-started',
   'rolled-back',
   'rollback-deferred',

ui/src/types/update-operation.ts

@@ -21,8 +21,14 @@ export const CONTAINER_UPDATE_OPERATION_PHASES = [
   'health-gate',
   'health-gate-passed',
   'succeeded',
+  'recovered-cleanup-temp',
+  'recovered-rollback',
+  'recovered-active',
+  'recovery-failed',
+  'recovery-missing-containers',
   'rollback-started',
   'rolled-back',
+  'rollback-deferred',
   'rollback-failed',
 ] as const;
 

ui/tests/utils/container-mapper.spec.ts

@@ -198,6 +198,30 @@ describe('container-mapper', () => {
         targetImage: 'nginx:1.1.0',
       });
     });
+
+    it('maps recovered rollback phases from valid terminal update-operation payloads', () => {
+      const c = mapApiContainer(
+        makeApiContainer({
+          updateOperation: {
+            id: 'op-recovered',
+            status: 'rolled-back',
+            phase: 'recovered-rollback',
+            updatedAt: '2026-04-01T12:00:00.000Z',
+            fromVersion: '1.0.1',
+            toVersion: '1.0.0',
+          },
+        }),
+      );
+
+      expect(c.updateOperation).toEqual({
+        id: 'op-recovered',
+        status: 'rolled-back',
+        phase: 'recovered-rollback',
+        updatedAt: '2026-04-01T12:00:00.000Z',
+        fromVersion: '1.0.1',
+        toVersion: '1.0.0',
+      });
+    });
   });
 
   describe('deriveRegistry', () => {