@igstack/app-catalog-frontend-core 0.16.0 → 0.17.1-alpha-20260821043201

package/src/__tests__/integration/appCatalog.integration.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest'
-import { fireEvent, waitFor } from '@testing-library/react'
+import { fireEvent, screen, waitFor } from '@testing-library/react'
 import '@testing-library/jest-dom/vitest'
 
 import { given } from './harness/given'
@@ -18,7 +18,7 @@ describe('App Catalog Integration', () => {
   it('navigate screenshots then escape back to list view', async () => {
     const { ui } = await given(magazine.full())
 
-    await ui.catalog.openApp('Jira')
+    await ui.catalog.openApp('TaskFlow')
     await ui.app.screenshots.open()
 
     await waitFor(() => {
@@ -45,7 +45,7 @@ describe('App Catalog Integration', () => {
         const approvalMethod = backendCfg.withApprovalMethod({
           type: 'service',
           displayName: 'Help Desk',
-          config: { url: 'https://helpdesk.example.com' },
+          config: { url: 'https://support.example.com' },
         })
         backendCfg.withApp({
           displayName: 'My Custom App',
@@ -148,6 +148,36 @@ describe('App Catalog Integration', () => {
     expect(ui.catalog.isDetailPanelOpen()).toBe(false)
   })
 
+  // Detail card UX (#45): the detail panel shows a prominent primary "Open" button
+  // with the destination URL visible alongside it.
+  it('shows a prominent primary Open button with URL in the app detail card', async () => {
+    const { ui } = await given(
+      magazine.custom(({ backendCfg }) => {
+        backendCfg.withApp({
+          displayName: 'Website App',
+          description: 'Has a website',
+          appUrl: 'https://tools.example.com/launch',
+        })
+        backendCfg.withApp({
+          displayName: 'No URL App',
+          description: 'No url',
+        })
+      }),
+    )
+
+    await ui.catalog.openApp('Website App')
+    const btn = ui.app.getOpenButton()
+    expect(btn).not.toBeNull()
+    expect(btn!.getAttribute('href')).toBe('https://tools.example.com/launch')
+    expect(btn!.getAttribute('target')).toBe('_blank')
+    // The URL is shown in the button (stripped of protocol).
+    expect(btn!.textContent).toContain('tools.example.com/launch')
+
+    // An app without appUrl shows no Open button.
+    await ui.catalog.openApp('No URL App')
+    expect(ui.app.getOpenButton()).toBeNull()
+  })
+
   // Test 5: Returning user — cached data + no onboarding + backend down
   it('returning user sees cached apps even when backend is unavailable', async () => {
     suppressConsole([/TRPC Error/, /Failed to fetch/])
@@ -164,8 +194,8 @@ describe('App Catalog Integration', () => {
 
     const tableData = ui.catalog.getTableData()
     expect(tableData.length).toBe(5)
-    expect(tableData.map((r) => r.name)).toContain('Jira')
-    expect(tableData.map((r) => r.name)).toContain('Slack')
+    expect(tableData.map((r) => r.name)).toContain('TaskFlow')
+    expect(tableData.map((r) => r.name)).toContain('TeamChat')
   })
 
   // Test 3: Network Error — Connection Reset
@@ -298,4 +328,233 @@ describe('App Catalog Integration', () => {
       /(?<![\d])0(?![\d]).*clear filters/i,
     )
   })
+
+  it('highlights matched query text in search result app names (#57)', async () => {
+    const { ui } = await given(
+      magazine.custom(({ backendCfg }) => {
+        backendCfg.withApp({ displayName: 'Kubernetes Platform' })
+        backendCfg.withApp({ displayName: 'Other Tool' })
+      }),
+    )
+
+    await ui.catalog.search('kube')
+
+    await waitFor(() => {
+      const marks = document.querySelectorAll('mark')
+      const markTexts = [...marks].map((m) => String(m.textContent))
+      expect(markTexts.some((t) => t.toLowerCase().includes('kube'))).toBe(true)
+    })
+  })
+
+  it('clear (×) button appears when search has text and clears on click (#54)', async () => {
+    const { ui } = await given(magazine.full())
+
+    // Before typing: no clear button
+    expect(
+      document.querySelector('[aria-label="Clear search"]'),
+    ).not.toBeInTheDocument()
+
+    // After typing: clear button appears
+    await ui.catalog.search('taskflow')
+    await waitFor(() => {
+      expect(
+        document.querySelector('[aria-label="Clear search"]'),
+      ).toBeInTheDocument()
+    })
+
+    // Click × — input clears, button disappears
+    fireEvent.click(document.querySelector('[aria-label="Clear search"]')!)
+    await waitFor(() => {
+      expect(ui.catalog.getSearchInput().value).toBe('')
+      expect(
+        document.querySelector('[aria-label="Clear search"]'),
+      ).not.toBeInTheDocument()
+    })
+  })
+
+  it('shows expandable subresource rows under parent in search results', async () => {
+    const { ui } = await given(
+      magazine.custom(({ backendCfg }) => {
+        const app = backendCfg.withApp({
+          slug: 'aws-console',
+          displayName: 'AWS Console',
+          description: 'Cloud management console',
+        })
+        for (let i = 1; i <= 7; i++) {
+          backendCfg.withSubResource({
+            appSlug: app.slug,
+            slug: `acct-data-${i}`,
+            displayName: `Data Account ${i}`,
+          })
+        }
+      }),
+    )
+    await ui.catalog.search('Data Account')
+    await waitFor(() => {
+      const subRows = ui.catalog.getSubResourceRows()
+      expect(subRows).not.toBeNull()
+      expect(subRows!.visible).toBe(5)
+      expect(subRows!.total).toBe(7)
+      expect(subRows!.hasExpandRow).toBe(true)
+    })
+  })
+
+  it('expand "...N more" row reveals all subresources', async () => {
+    const { ui } = await given(
+      magazine.custom(({ backendCfg }) => {
+        const app = backendCfg.withApp({
+          slug: 'aws-console',
+          displayName: 'AWS Console',
+        })
+        for (let i = 1; i <= 7; i++) {
+          backendCfg.withSubResource({
+            appSlug: app.slug,
+            slug: `acct-data-${i}`,
+            displayName: `Data Account ${i}`,
+          })
+        }
+      }),
+    )
+    await ui.catalog.search('Data Account')
+    await waitFor(() => {
+      expect(ui.catalog.getSubResourceRows()).not.toBeNull()
+    })
+    await ui.catalog.expandSubResources()
+    const subRows = ui.catalog.getSubResourceRows()
+    expect(subRows!.visible).toBe(7)
+    expect(subRows!.hasExpandRow).toBe(false)
+  })
+
+  it('clicking subresource row shows its detail with two-step access', async () => {
+    const { ui } = await given(
+      magazine.custom(({ backendCfg }) => {
+        const parentMethod = backendCfg.withApprovalMethod({
+          type: 'service',
+          displayName: 'Support Portal',
+          config: { url: 'https://support.example.com' },
+        })
+        const subMethod = backendCfg.withApprovalMethod({
+          type: 'custom',
+          displayName: 'Account Owner',
+        })
+        const app = backendCfg.withApp({
+          slug: 'aws-console',
+          displayName: 'AWS Console',
+          accessRequest: {
+            approvalMethodSlug: parentMethod.slug,
+            comments: 'Submit a support ticket to request access',
+          },
+        })
+        backendCfg.withSubResource({
+          appSlug: app.slug,
+          slug: 'acct-data-prod',
+          displayName: 'Data Account Prod',
+          accessRequest: {
+            approvalMethodSlug: subMethod.slug,
+            comments: 'Contact account owner for account-level permissions',
+          },
+        })
+      }),
+    )
+    await ui.catalog.search('Data Account')
+    await waitFor(() => {
+      expect(ui.catalog.getSubResourceRows()).not.toBeNull()
+    })
+    await ui.catalog.clickSubResource('Data Account Prod')
+    await waitFor(() => {
+      expect(ui.app.getSubResourceDetail()).not.toBeNull()
+    })
+    const detail = ui.app.getSubResourceDetail()
+    expect(detail).not.toBeNull()
+    expect(detail!.subResourceName).toBe('Data Account Prod')
+    expect(detail!.hasStep1).toBe(true)
+    expect(detail!.hasStep2).toBe(true)
+    expect(detail!.backButtonLabel).toBe('Back to AWS Console')
+  })
+
+  it('back button from subresource detail returns to parent view', async () => {
+    const { ui } = await given(
+      magazine.custom(({ backendCfg }) => {
+        const method = backendCfg.withApprovalMethod({
+          type: 'service',
+          displayName: 'Support Portal',
+          config: { url: 'https://support.example.com' },
+        })
+        const app = backendCfg.withApp({
+          slug: 'aws-console',
+          displayName: 'AWS Console',
+          accessRequest: { approvalMethodSlug: method.slug },
+        })
+        backendCfg.withSubResource({
+          appSlug: app.slug,
+          slug: 'acct-data-prod',
+          displayName: 'Data Account Prod',
+        })
+      }),
+    )
+    await ui.catalog.search('Data Account')
+    await waitFor(() => {
+      expect(ui.catalog.getSubResourceRows()).not.toBeNull()
+    })
+    await ui.catalog.clickSubResource('Data Account Prod')
+    await waitFor(() => {
+      expect(ui.app.getSubResourceDetail()).not.toBeNull()
+    })
+    await ui.app.clickBackToParent()
+    // After going back, the sub detail should be gone and parent detail shown
+    expect(ui.app.getSubResourceDetail()).toBeNull()
+    expect(ui.catalog.isDetailPanelOpen()).toBe(true)
+  })
+
+  it('shows Step 1 / Step 2 badges for two-step access apps (#56)', async () => {
+    const { ui } = await given(
+      magazine.custom(({ backendCfg }) => {
+        const method = backendCfg.withApprovalMethod({
+          type: 'service',
+          displayName: 'Natero Bot',
+          config: { url: 'https://natero.example.com' },
+        })
+        backendCfg.withApp({
+          displayName: 'Two-Step App',
+          accessRequest: {
+            approvalMethodSlug: method.slug,
+            requestPrompt: 'Give me access to Two-Step App',
+            postApprovalInstructions: 'Contact the owner to complete setup.',
+          },
+        })
+        backendCfg.withApp({ displayName: 'Other App' })
+      }),
+    )
+    await ui.catalog.openApp('Two-Step App')
+    await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(true))
+    expect(screen.getByText('Step 1')).toBeInTheDocument()
+    expect(screen.getByText('Step 2')).toBeInTheDocument()
+    expect(
+      screen.getByText('Contact the owner to complete setup.'),
+    ).toBeInTheDocument()
+  })
+
+  it('hides Step labels for single-step apps (#56)', async () => {
+    const { ui } = await given(
+      magazine.custom(({ backendCfg }) => {
+        const method = backendCfg.withApprovalMethod({
+          type: 'service',
+          displayName: 'Natero Bot',
+          config: { url: 'https://natero.example.com' },
+        })
+        backendCfg.withApp({
+          displayName: 'Single-Step App',
+          accessRequest: {
+            approvalMethodSlug: method.slug,
+            requestPrompt: 'Give me access',
+          },
+        })
+        backendCfg.withApp({ displayName: 'Other App' })
+      }),
+    )
+    await ui.catalog.openApp('Single-Step App')
+    await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(true))
+    expect(screen.queryByText('Step 1')).not.toBeInTheDocument()
+    expect(screen.queryByText('Step 2')).not.toBeInTheDocument()
+  })
 })

package/src/__tests__/integration/appDeepLink.integration.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest'
-import { fireEvent, waitFor } from '@testing-library/react'
+import { fireEvent, screen, waitFor } from '@testing-library/react'
 import '@testing-library/jest-dom/vitest'
 
 import { given } from './harness/given'
@@ -7,7 +7,9 @@ import { magazine } from './mock-backend/magazines'
 
 describe('App deep-link routing', () => {
   it('opens the app detail when navigating directly to /app/<slug>', async () => {
-    const { ui } = await given(magazine.full(), { initialRoute: '/app/jira' })
+    const { ui } = await given(magazine.full(), {
+      initialRoute: '/app/taskflow',
+    })
     await waitFor(() => {
       expect(ui.catalog.isDetailPanelOpen()).toBe(true)
     })
@@ -16,9 +18,9 @@ describe('App deep-link routing', () => {
 
   it('navigates to /app/<slug> when selecting an app, and pushes history', async () => {
     const { ui, router } = await given(magazine.full(), { initialRoute: '/' })
-    await ui.catalog.openApp('Jira')
+    await ui.catalog.openApp('TaskFlow')
     await waitFor(() => {
-      expect(router.state.location.pathname).toBe('/app/jira')
+      expect(router.state.location.pathname).toBe('/app/taskflow')
     })
     // push (not replace): catalog '/' is still in history, Back returns to it
     expect(router.history.canGoBack()).toBe(true)
@@ -36,9 +38,32 @@ describe('App deep-link routing', () => {
 
   it('returns to / when the detail panel is closed', async () => {
     const { ui, router } = await given(magazine.full(), { initialRoute: '/' })
-    await ui.catalog.openApp('Jira')
+    await ui.catalog.openApp('TaskFlow')
+    await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(true))
+    fireEvent.keyDown(document, { key: 'Escape', code: 'Escape' })
+    await waitFor(() => {
+      expect(ui.catalog.isDetailPanelOpen()).toBe(false)
+    })
+    expect(router.state.location.pathname).toBe('/')
+  })
+
+  it('Esc closes card opened by mouse click (#53 bug 1)', async () => {
+    const { ui, router } = await given(magazine.full(), { initialRoute: '/' })
+    // Open via click (mouse, not keyboard nav)
+    await ui.catalog.openApp('TaskFlow')
     await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(true))
+    // Esc should close — no "dead click" needed
     fireEvent.keyDown(document, { key: 'Escape', code: 'Escape' })
+    await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(false))
+    expect(router.state.location.pathname).toBe('/')
+  })
+
+  it('closes the detail panel when the × close button is clicked (#59)', async () => {
+    const { ui, router } = await given(magazine.full(), { initialRoute: '/' })
+    await ui.catalog.openApp('TaskFlow')
+    await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(true))
+    const closeBtn = screen.getByRole('button', { name: /^Close$/i })
+    fireEvent.click(closeBtn)
     await waitFor(() => {
       expect(ui.catalog.isDetailPanelOpen()).toBe(false)
     })
@@ -46,7 +71,9 @@ describe('App deep-link routing', () => {
   })
 
   it('ignores legacy ?app= query param (no detail opens)', async () => {
-    const { ui } = await given(magazine.full(), { initialRoute: '/?app=jira' })
+    const { ui } = await given(magazine.full(), {
+      initialRoute: '/?app=taskflow',
+    })
     await waitFor(() => {
       expect(ui.catalog.getTableData().length).toBeGreaterThan(0)
     })
@@ -64,7 +91,7 @@ describe('App deep-link routing', () => {
     // jsdom userEvent.type + useDeferredValue drops characters, orthogonal here.
     const { ui, router } = await given(magazine.full(), {
       initialRoute: '/',
-      seedSearch: 'jira',
+      seedSearch: 'taskflow',
     })
 
     // Stays on the launcher home — NO auto-navigation to the detail route.
@@ -72,33 +99,33 @@ describe('App deep-link routing', () => {
       expect(ui.catalog.getTableData().length).toBeGreaterThan(0)
     })
     expect(router.state.location.pathname).toBe('/')
-    expect(ui.catalog.getTableData().map((r) => r.name)).toContain('Jira')
+    expect(ui.catalog.getTableData().map((r) => r.name)).toContain('TaskFlow')
     // Search text preserved (sessionStorage-backed), no ?q leak.
-    expect(ui.catalog.getSearchInput().value).toBe('jira')
+    expect(ui.catalog.getSearchInput().value).toBe('taskflow')
     expect((router.state.location.search as { q?: string }).q).toBeUndefined()
 
     // Opting in (click) opens the detail.
-    await ui.catalog.openApp('Jira')
+    await ui.catalog.openApp('TaskFlow')
     await waitFor(() => {
-      expect(router.state.location.pathname).toBe('/app/jira')
+      expect(router.state.location.pathname).toBe('/app/taskflow')
     })
   })
 
   it('strips a legacy ?q= from the URL on the app detail route (#27)', async () => {
-    // Old shared links may still carry `?q=` (e.g. /app/jira?q=jira). `q` is
+    // Old shared links may still carry `?q=` (e.g. /app/taskflow?q=taskflow). `q` is
     // still declared in the route search schema (so it validates), but the
     // route's `stripSearchParams(['q'])` middleware rewrites the URL to a clean
-    // /app/jira on load. We no longer read `q` from the URL, so a bare deep-link
+    // /app/taskflow on load. We no longer read `q` from the URL, so a bare deep-link
     // doesn't repopulate the input from the query string.
     const { ui, router } = await given(magazine.full(), {
-      initialRoute: '/app/jira?q=jira',
+      initialRoute: '/app/taskflow?q=taskflow',
     })
 
     await waitFor(() => {
       expect(ui.catalog.isDetailPanelOpen()).toBe(true)
     })
-    expect(router.state.location.pathname).toBe('/app/jira')
-    expect(router.state.location.href).toBe('/app/jira')
+    expect(router.state.location.pathname).toBe('/app/taskflow')
+    expect(router.state.location.href).toBe('/app/taskflow')
     expect((router.state.location.search as { q?: string }).q).toBeUndefined()
   })
 
@@ -131,14 +158,14 @@ describe('App deep-link routing', () => {
     // store as a returning user would have (typed a search, then navigated), and
     // assert the detail route restores it with no `q` in the URL.
     const { ui, router } = await given(magazine.full(), {
-      initialRoute: '/app/jira',
-      seedSearch: 'jira',
+      initialRoute: '/app/taskflow',
+      seedSearch: 'taskflow',
     })
 
     await waitFor(() => {
       expect(ui.catalog.isDetailPanelOpen()).toBe(true)
     })
-    expect(ui.catalog.getSearchInput().value).toBe('jira')
+    expect(ui.catalog.getSearchInput().value).toBe('taskflow')
     expect((router.state.location.search as { q?: string }).q).toBeUndefined()
   })
 })

package/src/__tests__/integration/appFreshness.integration.test.ts

@@ -5,8 +5,9 @@ import '@testing-library/jest-dom/vitest'
 import { given } from './harness/given'
 import { magazine } from './mock-backend/magazines'
 
-// The backend owns the freshness semantic and serves { lastCheckedAt, isStale }.
-// These tests only assert the frontend renders that semantic — no date math here.
+// The backend owns the freshness semantic and serves
+// { lastCheckedAt, lastContentChangeAt, isStale }. These tests only assert the
+// frontend renders that semantic — no date math here.
 const DAY = 24 * 60 * 60 * 1000
 const iso = (msAgo: number) => new Date(Date.now() - msAgo).toISOString()
 
@@ -17,7 +18,11 @@ describe('App freshness line', () => {
         backendCfg.withApp({
           slug: 'fresh-app',
           displayName: 'Fresh App',
-          freshness: { lastCheckedAt: iso(2 * DAY), isStale: false },
+          freshness: {
+            lastCheckedAt: iso(2 * DAY),
+            lastContentChangeAt: null,
+            isStale: false,
+          },
         })
       }),
       { initialRoute: '/app/fresh-app' },
@@ -35,7 +40,11 @@ describe('App freshness line', () => {
         backendCfg.withApp({
           slug: 'stale-app',
           displayName: 'Stale App',
-          freshness: { lastCheckedAt: iso(30 * DAY), isStale: true },
+          freshness: {
+            lastCheckedAt: iso(30 * DAY),
+            lastContentChangeAt: null,
+            isStale: true,
+          },
         })
       }),
       { initialRoute: '/app/stale-app' },
@@ -45,6 +54,67 @@ describe('App freshness line', () => {
     expect(screen.getByText(/may be out of date/i)).toBeInTheDocument()
   })
 
+  it('shows "Added" date before Sources when createdAt is present (#55)', async () => {
+    const { ui } = await given(
+      magazine.full(({ backendCfg }) => {
+        backendCfg.withApp({
+          slug: 'dated-app',
+          displayName: 'Dated App',
+          createdAt: iso(30 * DAY),
+        })
+      }),
+      { initialRoute: '/app/dated-app' },
+    )
+    await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(true))
+    expect(screen.getByText(/Added/i)).toBeInTheDocument()
+  })
+
+  it('shows the last CONTENT change, not the last check', async () => {
+    // The reported symptom: an app read 22h ago showed "Updated 22 hours ago"
+    // while its data had not changed in months. "Updated" must mean changed.
+    const { ui } = await given(
+      magazine.full(({ backendCfg }) => {
+        backendCfg.withApp({
+          slug: 'checked-often-app',
+          displayName: 'Checked Often App',
+          freshness: {
+            lastCheckedAt: iso(DAY / 24), // read an hour ago
+            lastContentChangeAt: iso(120 * DAY), // unchanged for months
+            isStale: false,
+          },
+        })
+      }),
+      { initialRoute: '/app/checked-often-app' },
+    )
+
+    await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(true))
+    const line = screen.getByText(/Updated/i)
+    expect(line).toHaveTextContent(/months ago/i)
+    expect(line).not.toHaveTextContent(/hour/i)
+  })
+
+  it('falls back to the last check for entries with no recorded change', async () => {
+    // Rows scanned before lastContentChangeAt existed: better to show the check
+    // date than to drop the line entirely.
+    const { ui } = await given(
+      magazine.full(({ backendCfg }) => {
+        backendCfg.withApp({
+          slug: 'unchanged-app',
+          displayName: 'Unchanged App',
+          freshness: {
+            lastCheckedAt: iso(3 * DAY),
+            lastContentChangeAt: null,
+            isStale: false,
+          },
+        })
+      }),
+      { initialRoute: '/app/unchanged-app' },
+    )
+
+    await waitFor(() => expect(ui.catalog.isDetailPanelOpen()).toBe(true))
+    expect(screen.getByText(/Updated/i)).toHaveTextContent(/3 days ago/i)
+  })
+
   it('shows no freshness line when the app was never scanned', async () => {
     const { ui } = await given(
       magazine.full(({ backendCfg }) => {

package/src/__tests__/integration/crossRefLink.integration.test.ts

@@ -16,7 +16,7 @@ describe('Cross-reference links between app entries (#25)', () => {
       slug: 'portals-hub',
       displayName: 'Portals Hub',
       description:
-        'See the [Jira](/app/jira) entry and the external [docs](https://example.com/docs). Also [Ghost](/app/no-such-app) which does not exist.',
+        'See the [TaskFlow](/app/taskflow) entry and the external [docs](https://example.com/docs). Also [Ghost](/app/no-such-app) which does not exist.',
     })
   })
 
@@ -28,22 +28,22 @@ describe('Cross-reference links between app entries (#25)', () => {
       expect(ui.catalog.isDetailPanelOpen()).toBe(true)
     })
 
-    const jiraLink = screen.getByRole('link', { name: 'Jira' })
+    const taskflowLink = screen.getByRole('link', { name: 'TaskFlow' })
     // Internal link must NOT open a new tab.
-    expect(jiraLink).not.toHaveAttribute('target', '_blank')
+    expect(taskflowLink).not.toHaveAttribute('target', '_blank')
     // It points at the router path (rendered as an href).
-    expect(jiraLink).toHaveAttribute('href', '/app/jira')
+    expect(taskflowLink).toHaveAttribute('href', '/app/taskflow')
 
     const user = userEvent.setup()
-    await user.click(jiraLink)
+    await user.click(taskflowLink)
 
-    // In-app navigation: the router path changes and Jira's detail opens,
+    // In-app navigation: the router path changes and TaskFlow's detail opens,
     // without a full page reload / new tab.
     await waitFor(() => {
-      expect(router.state.location.pathname).toBe('/app/jira')
+      expect(router.state.location.pathname).toBe('/app/taskflow')
     })
     await waitFor(() => {
-      expect(ui.app.getOpenTitle()).toContain('Jira')
+      expect(ui.app.getOpenTitle()).toContain('TaskFlow')
     })
   })
 

package/src/__tests__/integration/crossRefLinkListView.integration.test.ts

@@ -5,7 +5,7 @@ import { given } from './harness/given'
 import { magazine } from './mock-backend/magazines'
 
 // #25 regression: descriptions now carry markdown cross-reference links like
-// `[Signatera Portal](/app/signatera-portal)`. The detail panel renders them
+// `[GenomicsApp](/app/genomics-app)`. The detail panel renders them
 // as real links, but the COMPACT surfaces (grid list preview / table row) show
 // `description` as plain text, so the raw markdown syntax leaked to users.
 // In clamped previews we render the visible text only — no bracket/paren
@@ -13,10 +13,10 @@ import { magazine } from './mock-backend/magazines'
 describe('Cross-reference links do not leak raw markdown in the list view (#25)', () => {
   const withCrossRefApp = magazine.full(({ backendCfg }) => {
     backendCfg.withApp({
-      slug: 'natera-portals-ish',
+      slug: 'internal-portals',
       displayName: 'Portals Hub',
       description:
-        'See [Signatera Portal](/app/signatera-portal) and [Prospera Portal](/app/prospera-portal).',
+        'See [GenomicsApp](/app/genomics-app) and [DataApp](/app/data-app).',
     })
   })
 
@@ -30,20 +30,20 @@ describe('Cross-reference links do not leak raw markdown in the list view (#25)'
     expect(row).toBeDefined()
 
     // The clamped preview shows the visible text…
-    expect(row!.description).toContain('Signatera Portal')
-    expect(row!.description).toContain('Prospera Portal')
+    expect(row!.description).toContain('GenomicsApp')
+    expect(row!.description).toContain('DataApp')
     // …and NEVER leaks the raw markdown link syntax.
     expect(row!.description).not.toContain('](/app/')
-    expect(row!.description).not.toContain('[Signatera Portal]')
+    expect(row!.description).not.toContain('[GenomicsApp]')
   })
 
   it('does not render an interactive link inside the clamped list preview', async () => {
     await given(withCrossRefApp)
     await waitFor(() => {
-      expect(screen.getByText(/See Signatera Portal and/)).toBeInTheDocument()
+      expect(screen.getByText(/See GenomicsApp and/)).toBeInTheDocument()
     })
     // A clamped preview must not carry a navigational link that could break the
     // clamp/layout — the interactive cross-links live in the detail panel.
-    expect(screen.queryByRole('link', { name: 'Signatera Portal' })).toBeNull()
+    expect(screen.queryByRole('link', { name: 'GenomicsApp' })).toBeNull()
   })
 })

package/src/__tests__/integration/mock-backend/MockBackendConfigurer.ts

@@ -79,6 +79,8 @@ export class MockBackendConfigurer {
       parentSlug: appSlug,
       tier: overrides.tier,
       ownerPersonSlug: overrides.ownerPersonSlug,
+      accessRequest: overrides.accessRequest,
+      description: overrides.description,
     }
     this.db.upsertResource(resource)
     return resource