@semiont/react-ui 0.2.35-build.98 → 0.2.35

package/src/features/resource-viewer/__tests__/{ResolutionFlowIntegration.test.tsx → BindFlowIntegration.test.tsx}

@@ -1,16 +1,16 @@
 /**
  * Layer 3: Feature Integration Test - Resolution Flow (search modal & body update)
  *
- * Tests the UNCOVERED half of useResolutionFlow:
- * - resolve:link → emits resolve:search-requested
- * - resolve:search-requested → opens search modal with pendingReferenceId
+ * Tests the UNCOVERED half of useBindFlow:
+ * - bind:link → emits bind:search-requested
+ * - bind:search-requested → opens search modal with pendingReferenceId
  * - onCloseSearchModal → closes modal
- * - resolve:update-body → calls updateAnnotationBody API
- * - resolve:update-body → emits resolve:body-updated on success
- * - resolve:update-body → emits resolve:body-update-failed on error
+ * - bind:update-body → calls updateAnnotationBody API
+ * - bind:update-body → emits bind:body-updated on success
+ * - bind:update-body → emits bind:body-update-failed on error
  * - auth token passed to updateAnnotationBody
  *
- * The deletion half of useResolutionFlow is covered by AnnotationDeletionIntegration.test.tsx.
+ * The deletion half of useBindFlow is covered by AnnotationDeletionIntegration.test.tsx.
  *
  * Uses real providers (EventBus, ApiClient, AuthToken) with mocked API boundary.
  */
@@ -18,7 +18,7 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { render, waitFor } from '@testing-library/react';
 import { act } from 'react';
-import { useResolutionFlow } from '../../../hooks/useResolutionFlow';
+import { useBindFlow } from '../../../hooks/useBindFlow';
 import { EventBusProvider, useEventBus, resetEventBusForTesting } from '../../../contexts/EventBusContext';
 import { ApiClientProvider } from '../../../contexts/ApiClientContext';
 import { AuthTokenProvider } from '../../../contexts/AuthTokenContext';
@@ -55,13 +55,13 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
 
   // ─── Render helper ──────────────────────────────────────────────────────────
 
-  function renderResolutionFlow() {
+  function renderBindFlow() {
     let eventBusInstance: ReturnType<typeof useEventBus> | null = null;
-    let lastState: ReturnType<typeof useResolutionFlow> | null = null;
+    let lastState: ReturnType<typeof useBindFlow> | null = null;
 
     function TestComponent() {
       eventBusInstance = useEventBus();
-      lastState = useResolutionFlow(testUri);
+      lastState = useBindFlow(testUri);
       return null;
     }
 
@@ -84,19 +84,19 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
   // ─── Initial state ──────────────────────────────────────────────────────────
 
   it('starts with search modal closed and no pending reference', () => {
-    const { getState } = renderResolutionFlow();
+    const { getState } = renderBindFlow();
     expect(getState().searchModalOpen).toBe(false);
     expect(getState().pendingReferenceId).toBeNull();
   });
 
-  // ─── resolve:link ─────────────────────────────────────────────────────────
+  // ─── bind:link ─────────────────────────────────────────────────────────
 
-  it('resolve:link emits resolve:search-requested with referenceId and searchTerm', () => {
-    const { getEventBus } = renderResolutionFlow();
+  it('bind:link emits bind:search-requested with referenceId and searchTerm', () => {
+    const { getEventBus } = renderBindFlow();
     const searchRequestedSpy = vi.fn();
 
-    const subscription = getEventBus().get('resolve:search-requested').subscribe(searchRequestedSpy);
-    act(() => { getEventBus().get('resolve:link').next({ annotationUri: 'ann-uri-123', searchTerm: 'climate change' }); });
+    const subscription = getEventBus().get('bind:search-requested').subscribe(searchRequestedSpy);
+    act(() => { getEventBus().get('bind:link').next({ annotationUri: 'ann-uri-123', searchTerm: 'climate change' }); });
     subscription.unsubscribe();
 
     expect(searchRequestedSpy).toHaveBeenCalledTimes(1);
@@ -106,35 +106,35 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
     });
   });
 
-  // ─── resolve:search-requested ────────────────────────────────────────────
+  // ─── bind:search-requested ────────────────────────────────────────────
 
-  it('resolve:search-requested opens the search modal', async () => {
-    const { getState, getEventBus } = renderResolutionFlow();
+  it('bind:search-requested opens the search modal', async () => {
+    const { getState, getEventBus } = renderBindFlow();
 
     expect(getState().searchModalOpen).toBe(false);
 
-    act(() => { getEventBus().get('resolve:search-requested').next({ referenceId: 'ref-abc', searchTerm: 'oceans' }); });
+    act(() => { getEventBus().get('bind:search-requested').next({ referenceId: 'ref-abc', searchTerm: 'oceans' }); });
 
     await waitFor(() => {
       expect(getState().searchModalOpen).toBe(true);
     });
   });
 
-  it('resolve:search-requested sets pendingReferenceId', async () => {
-    const { getState, getEventBus } = renderResolutionFlow();
+  it('bind:search-requested sets pendingReferenceId', async () => {
+    const { getState, getEventBus } = renderBindFlow();
 
-    act(() => { getEventBus().get('resolve:search-requested').next({ referenceId: 'ref-xyz', searchTerm: 'forests' }); });
+    act(() => { getEventBus().get('bind:search-requested').next({ referenceId: 'ref-xyz', searchTerm: 'forests' }); });
 
     await waitFor(() => {
       expect(getState().pendingReferenceId).toBe('ref-xyz');
     });
   });
 
-  it('resolve:link → resolve:search-requested chain opens modal end-to-end', async () => {
-    const { getState, getEventBus } = renderResolutionFlow();
+  it('bind:link → bind:search-requested chain opens modal end-to-end', async () => {
+    const { getState, getEventBus } = renderBindFlow();
 
     // Simulate the full user journey: user clicks "Link Document" on a reference entry
-    act(() => { getEventBus().get('resolve:link').next({ annotationUri: 'ann-full-chain', searchTerm: 'biodiversity' }); });
+    act(() => { getEventBus().get('bind:link').next({ annotationUri: 'ann-full-chain', searchTerm: 'biodiversity' }); });
 
     await waitFor(() => {
       expect(getState().searchModalOpen).toBe(true);
@@ -145,9 +145,9 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
   // ─── onCloseSearchModal ──────────────────────────────────────────────────────
 
   it('onCloseSearchModal closes the search modal', async () => {
-    const { getState, getEventBus } = renderResolutionFlow();
+    const { getState, getEventBus } = renderBindFlow();
 
-    act(() => { getEventBus().get('resolve:search-requested').next({ referenceId: 'ref-close', searchTerm: 'test' }); });
+    act(() => { getEventBus().get('bind:search-requested').next({ referenceId: 'ref-close', searchTerm: 'test' }); });
 
     await waitFor(() => expect(getState().searchModalOpen).toBe(true));
 
@@ -159,9 +159,9 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
   });
 
   it('onCloseSearchModal does not clear pendingReferenceId (preserves for re-open)', async () => {
-    const { getState, getEventBus } = renderResolutionFlow();
+    const { getState, getEventBus } = renderBindFlow();
 
-    act(() => { getEventBus().get('resolve:search-requested').next({ referenceId: 'ref-persist', searchTerm: 'test' }); });
+    act(() => { getEventBus().get('bind:search-requested').next({ referenceId: 'ref-persist', searchTerm: 'test' }); });
     await waitFor(() => expect(getState().searchModalOpen).toBe(true));
 
     act(() => { getState().onCloseSearchModal(); });
@@ -171,12 +171,12 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
     expect(getState().pendingReferenceId).toBe('ref-persist');
   });
 
-  // ─── resolve:update-body ──────────────────────────────────────────────────
+  // ─── bind:update-body ──────────────────────────────────────────────────
 
-  it('resolve:update-body calls updateAnnotationBody API', async () => {
-    const { getEventBus } = renderResolutionFlow();
+  it('bind:update-body calls updateAnnotationBody API', async () => {
+    const { getEventBus } = renderBindFlow();
 
-    act(() => { getEventBus().get('resolve:update-body').next({
+    act(() => { getEventBus().get('bind:update-body').next({
       annotationUri: 'http://localhost:4000/resources/test-resource/annotations/ann-body-1',
       resourceId: 'linked-resource-id',
       operations: [{ op: 'add', item: { id: 'linked-resource-id' } }],
@@ -187,10 +187,10 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
     });
   });
 
-  it('resolve:update-body passes auth token to API call', async () => {
-    const { getEventBus } = renderResolutionFlow();
+  it('bind:update-body passes auth token to API call', async () => {
+    const { getEventBus } = renderBindFlow();
 
-    act(() => { getEventBus().get('resolve:update-body').next({
+    act(() => { getEventBus().get('bind:update-body').next({
       annotationUri: 'http://localhost:4000/resources/test-resource/annotations/ann-auth',
       resourceId: 'resource-id',
       operations: [{ op: 'replace', newItem: { id: 'resource-id' } }],
@@ -205,13 +205,13 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
     expect(callArgs[2].auth).toBe(accessToken(testToken));
   });
 
-  it('resolve:update-body emits resolve:body-updated on success', async () => {
-    const { getEventBus } = renderResolutionFlow();
+  it('bind:update-body emits bind:body-updated on success', async () => {
+    const { getEventBus } = renderBindFlow();
     const bodyUpdatedSpy = vi.fn();
 
-    const subscription = getEventBus().get('resolve:body-updated').subscribe(bodyUpdatedSpy);
+    const subscription = getEventBus().get('bind:body-updated').subscribe(bodyUpdatedSpy);
 
-    act(() => { getEventBus().get('resolve:update-body').next({
+    act(() => { getEventBus().get('bind:update-body').next({
       annotationUri: 'http://localhost:4000/resources/test-resource/annotations/ann-success',
       resourceId: 'resource-id',
       operations: [{ op: 'add', item: { id: 'resource-id' } }],
@@ -228,15 +228,15 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
     });
   });
 
-  it('resolve:update-body emits resolve:body-update-failed on API error', async () => {
+  it('bind:update-body emits bind:body-update-failed on API error', async () => {
     updateAnnotationBodySpy.mockRejectedValue(new Error('Update failed'));
 
-    const { getEventBus } = renderResolutionFlow();
+    const { getEventBus } = renderBindFlow();
     const bodyUpdateFailedSpy = vi.fn();
 
-    const subscription = getEventBus().get('resolve:body-update-failed').subscribe(bodyUpdateFailedSpy);
+    const subscription = getEventBus().get('bind:body-update-failed').subscribe(bodyUpdateFailedSpy);
 
-    act(() => { getEventBus().get('resolve:update-body').next({
+    act(() => { getEventBus().get('bind:update-body').next({
       annotationUri: 'http://localhost:4000/resources/test-resource/annotations/ann-fail',
       resourceId: 'resource-id',
       operations: [{ op: 'remove', item: { id: 'old-id' } }],
@@ -253,10 +253,10 @@ describe('Resolution Flow - Search Modal & Body Update Integration', () => {
     });
   });
 
-  it('resolve:update-body called ONCE — no duplicate subscriptions', async () => {
-    const { getEventBus } = renderResolutionFlow();
+  it('bind:update-body called ONCE — no duplicate subscriptions', async () => {
+    const { getEventBus } = renderBindFlow();
 
-    act(() => { getEventBus().get('resolve:update-body').next({
+    act(() => { getEventBus().get('bind:update-body').next({
       annotationUri: 'http://localhost:4000/resources/test-resource/annotations/ann-dedup',
       resourceId: 'resource-id',
       operations: [{ op: 'add', item: { id: 'resource-id' } }],

package/src/features/resource-viewer/__tests__/DetectionFlowBug.test.tsx

@@ -2,18 +2,18 @@
  * FAILING TEST: Reproduces the bug where detection events fire but state doesn't update
  *
  * Based on console logs from production:
- * ✅ annotate:assist-request emitted
+ * ✅ mark:assist-request emitted
  * ✅ annotate:assist-progress emitted
  * ❌ assistingMotivation remains null
  * ❌ progress remains null
  *
- * UPDATED: Now tests useAnnotationFlow hook instead of DetectionFlowContainer
+ * UPDATED: Now tests useMarkFlow hook instead of DetectionFlowContainer
  */
 
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { render, screen, waitFor } from '@testing-library/react';
 import { act } from 'react';
-import { useAnnotationFlow } from '../../../hooks/useAnnotationFlow';
+import { useMarkFlow } from '../../../hooks/useMarkFlow';
 import { EventBusProvider, useEventBus, resetEventBusForTesting } from '../../../contexts/EventBusContext';
 import { ApiClientProvider } from '../../../contexts/ApiClientContext';
 import { AuthTokenProvider } from '../../../contexts/AuthTokenContext';
@@ -45,17 +45,17 @@ describe('REPRODUCING BUG: Detection state not updating', () => {
     vi.restoreAllMocks();
   });
 
-  it('SHOULD update state when annotate:assist-request event is emitted', async () => {
+  it('SHOULD update state when mark:assist-request event is emitted', async () => {
     let eventBusInstance: any;
     let currentState: any;
 
     // Component to capture EventBus and hook state
     function TestComponent() {
       eventBusInstance = useEventBus();
-      const state = useAnnotationFlow('http://localhost:8080/resources/test' as any);
+      const state = useMarkFlow('http://localhost:8080/resources/test' as any);
       currentState = state;
 
-      console.log('[TEST] useAnnotationFlow state:', {
+      console.log('[TEST] useMarkFlow state:', {
         assistingMotivation: state.assistingMotivation,
         progress: state.progress,
       });
@@ -82,17 +82,17 @@ describe('REPRODUCING BUG: Detection state not updating', () => {
     expect(screen.getByTestId('detecting')).toHaveTextContent('null');
     expect(screen.getByTestId('progress')).toHaveTextContent('null');
 
-    console.log('[TEST] Emitting annotate:assist-request event...');
+    console.log('[TEST] Emitting mark:assist-request event...');
 
-    // Emit annotate:assist-request event (exactly like production)
+    // Emit mark:assist-request event (exactly like production)
     act(() => {
-      eventBusInstance.get('annotate:assist-request').next({
+      eventBusInstance.get('mark:assist-request').next({
         motivation: 'linking',
         options: { entityTypes: ['Location'] }
       });
     });
 
-    console.log('[TEST] After annotate:assist-request, checking state...');
+    console.log('[TEST] After mark:assist-request, checking state...');
 
     // THIS SHOULD PASS but currently FAILS
     await waitFor(() => {
@@ -109,7 +109,7 @@ describe('REPRODUCING BUG: Detection state not updating', () => {
 
     function TestComponent() {
       eventBusInstance = useEventBus();
-      const state = useAnnotationFlow('http://localhost:8080/resources/test' as any);
+      const state = useMarkFlow('http://localhost:8080/resources/test' as any);
       currentState = state;
 
       return (
@@ -134,7 +134,7 @@ describe('REPRODUCING BUG: Detection state not updating', () => {
 
     // Emit annotate:assist-progress event (exactly like production)
     act(() => {
-      eventBusInstance.get('annotate:progress').next({
+      eventBusInstance.get('mark:progress').next({
         status: 'started',
         resourceId: 'test',
         totalEntityTypes: 1,
@@ -162,7 +162,7 @@ describe('REPRODUCING BUG: Detection state not updating', () => {
 
     function TestComponent() {
       eventBusInstance = useEventBus();
-      const state = useAnnotationFlow('http://localhost:8080/resources/f45fd44f9cb0b0fe1b7980d3d034bc61' as any);
+      const state = useMarkFlow('http://localhost:8080/resources/f45fd44f9cb0b0fe1b7980d3d034bc61' as any);
 
       stateSnapshots.push({
         assistingMotivation: state.assistingMotivation,
@@ -192,18 +192,18 @@ describe('REPRODUCING BUG: Detection state not updating', () => {
 
     // Exactly like production logs
     act(() => {
-      console.log('[EventBus] emit: annotate:assist-request {motivation: "linking", options: {...}}');
-      eventBusInstance.get('annotate:assist-request').next({
+      console.log('[EventBus] emit: mark:assist-request {motivation: "linking", options: {...}}');
+      eventBusInstance.get('mark:assist-request').next({
         motivation: 'linking',
         options: { entityTypes: ['Location'] }
       });
     });
 
-    console.log('After annotate:assist-request:', stateSnapshots[stateSnapshots.length - 1]);
+    console.log('After mark:assist-request:', stateSnapshots[stateSnapshots.length - 1]);
 
     act(() => {
       console.log('[EventBus] emit: annotate:assist-progress {status: "started", ...}');
-      eventBusInstance.get('annotate:progress').next({
+      eventBusInstance.get('mark:progress').next({
         status: 'started',
         resourceId: 'f45fd44f9cb0b0fe1b7980d3d034bc61',
         totalEntityTypes: 1,
@@ -216,7 +216,7 @@ describe('REPRODUCING BUG: Detection state not updating', () => {
 
     act(() => {
       console.log('[EventBus] emit: annotate:assist-progress {status: "scanning", ...}');
-      eventBusInstance.get('annotate:progress').next({
+      eventBusInstance.get('mark:progress').next({
         status: 'scanning',
         resourceId: 'f45fd44f9cb0b0fe1b7980d3d034bc61',
         currentEntityType: 'Location',

package/src/features/resource-viewer/__tests__/DetectionFlowIntegration.test.tsx

@@ -4,8 +4,8 @@
  * Tests the COMPLETE detection flow with real component composition:
  * - EventBusProvider (REAL)
  * - ApiClientProvider (REAL, with MOCKED client)
- * - useAnnotationFlow (REAL)
- * - useResolutionFlow (REAL)
+ * - useMarkFlow (REAL)
+ * - useBindFlow (REAL)
  * - useEventSubscriptions (REAL)
  *
  * This test focuses on ARCHITECTURE and EVENT WIRING:
@@ -25,7 +25,7 @@ import React from 'react';
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { render, screen, waitFor } from '@testing-library/react';
 import { act } from 'react';
-import { useAnnotationFlow } from '../../../hooks/useAnnotationFlow';
+import { useMarkFlow } from '../../../hooks/useMarkFlow';
 import { EventBusProvider, useEventBus, resetEventBusForTesting } from '../../../contexts/EventBusContext';
 import { ApiClientProvider } from '../../../contexts/ApiClientContext';
 import { AuthTokenProvider } from '../../../contexts/AuthTokenContext';
@@ -91,7 +91,7 @@ describe('Detection Flow - Feature Integration', () => {
     });
 
     // CRITICAL ASSERTION: API called exactly once (not twice!)
-    // This would FAIL if useResolutionFlow was called in multiple places
+    // This would FAIL if useBindFlow was called in multiple places
     await waitFor(() => {
       expect(annotateReferencesSpy).toHaveBeenCalledTimes(1);
     });
@@ -107,7 +107,7 @@ describe('Detection Flow - Feature Integration', () => {
     );
   });
 
-  it('should propagate SSE progress events to useAnnotationFlow state', async () => {
+  it('should propagate SSE progress events to useMarkFlow state', async () => {
     const testUri = resourceUri('http://localhost:4000/resources/test-resource');
 
     // Render with state observer
@@ -127,7 +127,7 @@ describe('Detection Flow - Feature Integration', () => {
 
     // Simulate SSE progress event being emitted to EventBus (how SSE actually works now)
     act(() => {
-      getEventBus().get('annotate:progress').next({
+      getEventBus().get('mark:progress').next({
         status: 'scanning',
         message: 'Scanning for Person...',
         currentEntityType: 'Person',
@@ -161,7 +161,7 @@ describe('Detection Flow - Feature Integration', () => {
 
     // First progress update via EventBus
     act(() => {
-      getEventBus().get('annotate:progress').next({
+      getEventBus().get('mark:progress').next({
         status: 'started',
         message: 'Starting analysis...',
         percentage: 0,
@@ -174,7 +174,7 @@ describe('Detection Flow - Feature Integration', () => {
 
     // Second progress update via EventBus
     act(() => {
-      getEventBus().get('annotate:progress').next({
+      getEventBus().get('mark:progress').next({
         status: 'analyzing',
         message: 'Analyzing text...',
         percentage: 50,
@@ -187,7 +187,7 @@ describe('Detection Flow - Feature Integration', () => {
 
     // Final progress update via EventBus
     act(() => {
-      getEventBus().get('annotate:progress').next({
+      getEventBus().get('mark:progress').next({
         status: 'complete',
         message: 'Created 14 highlights',
         percentage: 100,
@@ -214,7 +214,7 @@ describe('Detection Flow - Feature Integration', () => {
 
     // Send final progress via EventBus
     act(() => {
-      getEventBus().get('annotate:progress').next({
+      getEventBus().get('mark:progress').next({
         status: 'complete',
         message: 'Created 14 highlights',
       });
@@ -226,7 +226,7 @@ describe('Detection Flow - Feature Integration', () => {
 
     // Emit completion event
     act(() => {
-      getEventBus().get('annotate:assist-finished').next({ motivation: 'highlighting' });
+      getEventBus().get('mark:assist-finished').next({ motivation: 'highlighting' });
     });
 
     // Verify: detecting flag cleared BUT progress still visible
@@ -247,7 +247,7 @@ describe('Detection Flow - Feature Integration', () => {
 
     // Add some progress via EventBus
     act(() => {
-      getEventBus().get('annotate:progress').next({
+      getEventBus().get('mark:progress').next({
         status: 'scanning',
         message: 'Scanning...',
       });
@@ -259,7 +259,7 @@ describe('Detection Flow - Feature Integration', () => {
 
     // Emit failure
     act(() => {
-      getEventBus().get('annotate:assist-failed').next({
+      getEventBus().get('mark:assist-failed').next({
         type: 'job.failed' as const,
         resourceId: 'test-resource' as any,
         userId: 'user' as any,
@@ -322,13 +322,13 @@ describe('Detection Flow - Feature Integration', () => {
   it('should only call API once even with multiple event listeners', async () => {
     const testUri = resourceUri('http://localhost:4000/resources/test-resource');
 
-    // This test specifically catches the duplicate useResolutionFlow bug
-    // If multiple components call useResolutionFlow, we'll see multiple API calls
+    // This test specifically catches the duplicate useBindFlow bug
+    // If multiple components call useBindFlow, we'll see multiple API calls
     const { emitDetectionStart, getEventBus } = renderDetectionFlow(testUri);
 
     // Add an additional event listener (simulating multiple subscribers)
     const additionalListener = vi.fn();
-    const subscription = getEventBus().get('annotate:assist-request').subscribe(additionalListener);
+    const subscription = getEventBus().get('mark:assist-request').subscribe(additionalListener);
 
     // Trigger detection
     act(() => {
@@ -351,7 +351,7 @@ describe('Detection Flow - Feature Integration', () => {
 });
 
 /**
- * Helper: Render useAnnotationFlow hook with real component composition
+ * Helper: Render useMarkFlow hook with real component composition
  * Returns methods to interact with the rendered component
  */
 function renderDetectionFlow(testUri: string) {
@@ -365,7 +365,7 @@ function renderDetectionFlow(testUri: string) {
 
   // Test harness component that uses the hook
   function DetectionFlowTestHarness() {
-    const { progress, assistingMotivation } = useAnnotationFlow(testUri as any);
+    const { progress, assistingMotivation } = useMarkFlow(testUri as any);
     return (
       <div>
         <div data-testid="detecting">{assistingMotivation || 'none'}</div>
@@ -389,7 +389,7 @@ function renderDetectionFlow(testUri: string) {
 
   return {
     emitDetectionStart: (motivation: Motivation, options: any) => {
-      eventBusInstance.get('annotate:assist-request').next({ motivation, options });
+      eventBusInstance.get('mark:assist-request').next({ motivation, options });
     },
     getEventBus: () => eventBusInstance,
   };

package/src/features/resource-viewer/__tests__/ResourceMutations.test.tsx

@@ -80,9 +80,9 @@ function ResourceMutationHarness({ onEventBus }: { onEventBus: (eventBus: EventB
   }, [generateCloneTokenMutation]);
 
   useEventSubscriptions({
-    'resource:archive': handleResourceArchive,
-    'resource:unarchive': handleResourceUnarchive,
-    'generate:clone': handleResourceClone,
+    'mark:archive': handleResourceArchive,
+    'mark:unarchive': handleResourceUnarchive,
+    'yield:clone': handleResourceClone,
   });
 
   return null;
@@ -153,11 +153,11 @@ describe('Resource mutations — hooks hoisted to top level', () => {
 
   // ── Clone ──────────────────────────────────────────────────────────────────
 
-  it('calls generateCloneToken API when generate:clone event fires', async () => {
+  it('calls generateCloneToken API when yield:clone event fires', async () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('generate:clone', undefined);
+      emit('yield:clone', undefined);
     });
 
     await waitFor(() => {
@@ -169,7 +169,7 @@ describe('Resource mutations — hooks hoisted to top level', () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('generate:clone', undefined);
+      emit('yield:clone', undefined);
     });
 
     await waitFor(() => {
@@ -184,7 +184,7 @@ describe('Resource mutations — hooks hoisted to top level', () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('generate:clone', undefined);
+      emit('yield:clone', undefined);
     });
 
     await waitFor(() => {
@@ -199,7 +199,7 @@ describe('Resource mutations — hooks hoisted to top level', () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('generate:clone', undefined);
+      emit('yield:clone', undefined);
     });
 
     await waitFor(() => {
@@ -211,11 +211,11 @@ describe('Resource mutations — hooks hoisted to top level', () => {
     expect(writtenUrl).toContain('/know/clone?token=');
   });
 
-  it('does NOT call updateResource when generate:clone fires', async () => {
+  it('does NOT call updateResource when yield:clone fires', async () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('generate:clone', undefined);
+      emit('yield:clone', undefined);
     });
 
     await waitFor(() => {
@@ -227,11 +227,11 @@ describe('Resource mutations — hooks hoisted to top level', () => {
 
   // ── Archive ────────────────────────────────────────────────────────────────
 
-  it('calls updateResource with archived:true when resource:archive fires', async () => {
+  it('calls updateResource with archived:true when mark:archive fires', async () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('resource:archive', undefined);
+      emit('mark:archive', undefined);
     });
 
     await waitFor(() => {
@@ -245,11 +245,11 @@ describe('Resource mutations — hooks hoisted to top level', () => {
     );
   });
 
-  it('does NOT call generateCloneToken when resource:archive fires', async () => {
+  it('does NOT call generateCloneToken when mark:archive fires', async () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('resource:archive', undefined);
+      emit('mark:archive', undefined);
     });
 
     await waitFor(() => {
@@ -261,11 +261,11 @@ describe('Resource mutations — hooks hoisted to top level', () => {
 
   // ── Unarchive ──────────────────────────────────────────────────────────────
 
-  it('calls updateResource with archived:false when resource:unarchive fires', async () => {
+  it('calls updateResource with archived:false when mark:unarchive fires', async () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('resource:unarchive', undefined);
+      emit('mark:unarchive', undefined);
     });
 
     await waitFor(() => {
@@ -281,15 +281,15 @@ describe('Resource mutations — hooks hoisted to top level', () => {
 
   // ── Isolation ─────────────────────────────────────────────────────────────
 
-  it('resource:archive and generate:clone events each call their own API exactly once', async () => {
+  it('mark:archive and yield:clone events each call their own API exactly once', async () => {
     const { emit } = renderHarness();
 
     await act(async () => {
-      emit('resource:archive', undefined);
+      emit('mark:archive', undefined);
     });
 
     await act(async () => {
-      emit('generate:clone', undefined);
+      emit('yield:clone', undefined);
     });
 
     await waitFor(() => {