From 615b954c044be138d8fb5c8e1b56375c55def1da Mon Sep 17 00:00:00 2001
From: Ruben van der Linde <rubenvdlinde@gmail.com>
Date: Wed, 13 May 2026 07:27:50 +0200
Subject: [PATCH] feat: add data-testid to Cn* components for journeydoc
 capture specs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds stable data-testid selectors to the high-traffic Cn* shell
components so the journeydoc capture spec (ADR-030) on every Tier-4
Conduction app can target them without per-app instrumentation.

The decidesk journeydoc pilot (ConductionNL/decidesk#195) found that
most app chrome is rendered by @conduction/nextcloud-vue components,
so doing this once in the lib helps every app at once.

Purely additive — zero behaviour or styling impact, per the
journeydoc-instrument convention. Testids follow the
"cn-<scope>-<element>" naming convention from the journeydoc-instrument
SKILL.md guide.

Components instrumented (by surface):
- Shell:   CnAppRoot, CnAppNav, CnAppLoading, CnDependencyMissing
- Pages:   CnPageRenderer, CnPageHeader, CnIndexPage, CnDetailPage,
           CnDashboardPage, CnSettingsPage, CnSettingsSection,
           CnFormPage, CnLogsPage, CnFilesPage, CnMapPage,
           CnWikiPage, CnChatPage
- Lists:   CnDataTable (table + rows + empty)
- Sidebar: CnObjectSidebar (root + each built-in tab + registry tabs +
           consumer tabs)
- Modals:  CnFormDialog, CnDeleteDialog, CnCopyDialog,
           CnAdvancedFormDialog, CnTabbedFormDialog,
           CnMassDelete/Copy/Export/Import, CnSuggestFeatureModal,
           CnAiHistoryDialog
- Actions: CnActionsBar (+ primary CTA + overflow menu),
           CnContextMenu, CnRowActions (per-item testid slugged from
           label), CnUserActionMenu
- Filter:  CnFilterBar, CnPagination
- AI:      CnAiCompanion, CnAiChatPanel, CnAiFloatingButton, CnAiInput,
           CnAiMessageList
- Banners: CnLockedBanner
---
 src/components/CnActionsBar/CnActionsBar.vue  |  6 +++--
 .../CnAdvancedFormDialog.vue                  | 12 ++++++++--
 .../CnAiCompanion/CnAiChatPanel.vue           |  4 +++-
 .../CnAiCompanion/CnAiCompanion.vue           |  2 +-
 .../CnAiCompanion/CnAiFloatingButton.vue      |  1 +
 src/components/CnAiCompanion/CnAiInput.vue    |  4 +++-
 .../CnAiCompanion/CnAiMessageList.vue         |  2 +-
 src/components/CnAppLoading/CnAppLoading.vue  |  2 +-
 src/components/CnAppNav/CnAppNav.vue          |  7 ++++--
 src/components/CnAppRoot/CnAppRoot.vue        |  4 ++--
 src/components/CnChatPage/CnChatPage.vue      |  2 +-
 .../CnContextMenu/CnContextMenu.vue           | 18 +++++++++++++++
 src/components/CnCopyDialog/CnCopyDialog.vue  | 12 ++++++++--
 .../CnDashboardPage/CnDashboardPage.vue       |  4 ++--
 src/components/CnDataTable/CnDataTable.vue    | 10 +++++----
 .../CnDeleteDialog/CnDeleteDialog.vue         | 12 ++++++++--
 .../CnDependencyMissing.vue                   |  2 +-
 src/components/CnDetailPage/CnDetailPage.vue  |  4 ++--
 src/components/CnFilesPage/CnFilesPage.vue    |  2 +-
 src/components/CnFilterBar/CnFilterBar.vue    |  4 ++--
 src/components/CnFormDialog/CnFormDialog.vue  | 12 ++++++++--
 src/components/CnFormPage/CnFormPage.vue      |  2 +-
 src/components/CnIndexPage/CnIndexPage.vue    |  2 +-
 .../CnLockedBanner/CnLockedBanner.vue         |  3 ++-
 src/components/CnLogsPage/CnLogsPage.vue      |  2 +-
 src/components/CnMapPage/CnMapPage.vue        |  2 +-
 .../CnMassCopyDialog/CnMassCopyDialog.vue     | 12 ++++++++--
 .../CnMassDeleteDialog/CnMassDeleteDialog.vue | 12 ++++++++--
 .../CnMassExportDialog/CnMassExportDialog.vue | 12 ++++++++--
 .../CnMassImportDialog/CnMassImportDialog.vue | 12 ++++++++--
 .../CnObjectSidebar/CnObjectSidebar.vue       | 22 +++++++++++++------
 src/components/CnPageHeader/CnPageHeader.vue  |  6 ++---
 .../CnPageRenderer/CnPageRenderer.vue         |  2 ++
 src/components/CnPagination/CnPagination.vue  |  2 +-
 src/components/CnRowActions/CnRowActions.vue  | 20 ++++++++++++++++-
 .../CnSettingsPage/CnSettingsPage.vue         |  6 +++--
 .../CnSettingsSection/CnSettingsSection.vue   |  1 +
 .../CnSuggestFeatureModal.vue                 |  2 +-
 .../CnTabbedFormDialog/CnTabbedFormDialog.vue | 12 ++++++++--
 .../CnUserActionMenu/CnUserActionMenu.vue     |  2 +-
 src/components/CnWikiPage/CnWikiPage.vue      |  2 +-
 src/dialogs/CnAiHistoryDialog.vue             | 12 ++++++++--
 42 files changed, 208 insertions(+), 66 deletions(-)

diff --git a/src/components/CnActionsBar/CnActionsBar.vue b/src/components/CnActionsBar/CnActionsBar.vue
index 8e4c23b4c..158ee5c0e 100644
--- a/src/components/CnActionsBar/CnActionsBar.vue
+++ b/src/components/CnActionsBar/CnActionsBar.vue
@@ -1,5 +1,5 @@
 <template>
-	<div class="cn-actions-bar">
+	<div class="cn-actions-bar" data-testid="cn-actions-bar">
 		<div class="cn-actions-bar__info">
 			<span v-if="pagination && pagination.total > 0" class="cn-actions-bar__count">
 				{{ countText }}
@@ -34,6 +34,7 @@
 			<NcButton v-if="showAdd"
 				type="primary"
 				:disabled="addDisabled"
+				data-testid="cn-cta-primary"
 				@click="$emit('add')">
 				<template #icon>
 					<CnIcon v-if="addIcon" :name="addIcon" :size="20" />
@@ -48,7 +49,8 @@
 			<NcActions
 				:force-name="true"
 				:inline="inlineActionCount"
-				menu-name="Actions">
+				menu-name="Actions"
+				data-testid="cn-actions">
 				<NcActionButton :disabled="refreshing || refreshDisabled" @click="$emit('refresh')">
 					<template #icon>
 						<NcLoadingIcon v-if="refreshing" :size="20" />
diff --git a/src/components/CnAdvancedFormDialog/CnAdvancedFormDialog.vue b/src/components/CnAdvancedFormDialog/CnAdvancedFormDialog.vue
index 3e7af5dfd..33efec248 100644
--- a/src/components/CnAdvancedFormDialog/CnAdvancedFormDialog.vue
+++ b/src/components/CnAdvancedFormDialog/CnAdvancedFormDialog.vue
@@ -5,7 +5,11 @@
 		:can-close="!loading"
 		@closing="$emit('close')">
 		<!-- Result phase -->
-		<div v-if="result !== null" class="cn-advanced-form-dialog__result">
+		<div v-if="result !== null"
+			class="cn-advanced-form-dialog__result"
+			data-testid="cn-modal"
+			data-testid-modal="cn-advanced-form-dialog"
+			data-testid-phase="result">
 			<NcNoteCard v-if="result.success" type="success">
 				{{ resolvedSuccessText }}
 			</NcNoteCard>
@@ -15,7 +19,11 @@
 		</div>
 
 		<!-- Form phase -->
-		<div v-else class="cn-advanced-form-dialog__form">
+		<div v-else
+			class="cn-advanced-form-dialog__form"
+			data-testid="cn-modal"
+			data-testid-modal="cn-advanced-form-dialog"
+			data-testid-phase="form">
 			<!-- Full form override slot -->
 			<slot
 				v-if="$scopedSlots.form"
diff --git a/src/components/CnAiCompanion/CnAiChatPanel.vue b/src/components/CnAiCompanion/CnAiChatPanel.vue
index 781b187af..ef390fcfd 100644
--- a/src/components/CnAiCompanion/CnAiChatPanel.vue
+++ b/src/components/CnAiCompanion/CnAiChatPanel.vue
@@ -20,6 +20,7 @@
 		:title="agentName"
 		:active="activeTab"
 		:force-menu="true"
+		data-testid="cn-ai-panel"
 		@close="onClose"
 		@update:active="activeTab = $event">
 		<template #description>
@@ -50,7 +51,8 @@
 		<NcAppSidebarTab
 			id="chat"
 			:name="cnTranslate('Chat')"
-			:order="1">
+			:order="1"
+			data-testid="cn-ai-panel-tab-chat">
 			<template #icon>
 				<Creation :size="20" />
 			</template>
diff --git a/src/components/CnAiCompanion/CnAiCompanion.vue b/src/components/CnAiCompanion/CnAiCompanion.vue
index ebfa64e2d..ac8811764 100644
--- a/src/components/CnAiCompanion/CnAiCompanion.vue
+++ b/src/components/CnAiCompanion/CnAiCompanion.vue
@@ -14,7 +14,7 @@
   FAB and panel both hidden when cnAiContext.pageKind === 'chat'.
 -->
 <template>
-	<div v-if="probeSucceeded && !isChatPage" class="cn-ai-companion">
+	<div v-if="probeSucceeded && !isChatPage" class="cn-ai-companion" data-testid="cn-ai-companion">
 		<CnAiFloatingButton
 			:visible="!isPanelOpen"
 			:position="position"
diff --git a/src/components/CnAiCompanion/CnAiFloatingButton.vue b/src/components/CnAiCompanion/CnAiFloatingButton.vue
index 9a9949e0c..d794a9634 100644
--- a/src/components/CnAiCompanion/CnAiFloatingButton.vue
+++ b/src/components/CnAiCompanion/CnAiFloatingButton.vue
@@ -16,6 +16,7 @@
 		]"
 		:aria-label="cnTranslate('Open AI chat')"
 		type="button"
+		data-testid="cn-ai-fab"
 		@click="$emit('click')">
 		<span class="cn-ai-floating-button__hex">
 			<Creation :size="26" class="cn-ai-floating-button__icon" />
diff --git a/src/components/CnAiCompanion/CnAiInput.vue b/src/components/CnAiCompanion/CnAiInput.vue
index 7f36db0d5..bf6060e78 100644
--- a/src/components/CnAiCompanion/CnAiInput.vue
+++ b/src/components/CnAiCompanion/CnAiInput.vue
@@ -7,7 +7,7 @@
   - Send button disabled when textarea is empty or whitespace-only.
 -->
 <template>
-	<div class="cn-ai-input">
+	<div class="cn-ai-input" data-testid="cn-ai-input">
 		<textarea
 			ref="textarea"
 			v-model="inputText"
@@ -16,6 +16,7 @@
 			:disabled="disabled"
 			:placeholder="cnTranslate('Message input')"
 			rows="1"
+			data-testid="cn-ai-input-textarea"
 			@keydown.enter.exact.prevent="handleEnter"
 			@keydown.shift.enter.exact="handleShiftEnter"
 			@input="autoGrow" />
@@ -24,6 +25,7 @@
 			type="button"
 			:aria-label="cnTranslate('Send message')"
 			:disabled="disabled || isTextEmpty"
+			data-testid="cn-ai-input-send"
 			@click="handleSend">
 			<NcLoadingIcon
 				v-if="disabled"
diff --git a/src/components/CnAiCompanion/CnAiMessageList.vue b/src/components/CnAiCompanion/CnAiMessageList.vue
index 995ee558e..2125bef6f 100644
--- a/src/components/CnAiCompanion/CnAiMessageList.vue
+++ b/src/components/CnAiCompanion/CnAiMessageList.vue
@@ -8,7 +8,7 @@
   The assistant message container has aria-live="polite" for screen-reader streaming.
 -->
 <template>
-	<div class="cn-ai-message-list">
+	<div class="cn-ai-message-list" data-testid="cn-ai-message-list">
 		<!-- Empty state -->
 		<div v-if="messages.length === 0" class="cn-ai-message-list__empty">
 			<slot name="empty" />
diff --git a/src/components/CnAppLoading/CnAppLoading.vue b/src/components/CnAppLoading/CnAppLoading.vue
index afb566d13..543f1728d 100644
--- a/src/components/CnAppLoading/CnAppLoading.vue
+++ b/src/components/CnAppLoading/CnAppLoading.vue
@@ -9,7 +9,7 @@
   See REQ-JMR-010 of the json-manifest-renderer specification.
 -->
 <template>
-	<div class="cn-app-loading">
+	<div class="cn-app-loading" data-testid="cn-app-loading">
 		<div class="cn-app-loading__inner">
 			<slot name="logo">
 				<img
diff --git a/src/components/CnAppNav/CnAppNav.vue b/src/components/CnAppNav/CnAppNav.vue
index 7ca3c4ab5..a48c617f2 100644
--- a/src/components/CnAppNav/CnAppNav.vue
+++ b/src/components/CnAppNav/CnAppNav.vue
@@ -29,7 +29,7 @@
   See REQ-JMR-004 of the json-manifest-renderer specification.
 -->
 <template>
-	<NcAppNavigation>
+	<NcAppNavigation data-testid="cn-nav">
 		<template #list>
 			<NcAppNavigationItem
 				v-for="item in mainItems"
@@ -39,6 +39,7 @@
 				:exact="isExact(item)"
 				:icon="item.icon"
 				:active="isActive(item)"
+				:data-testid="`cn-nav-entry-${item.id}`"
 				@click="onItemClick(item, $event)">
 				<NcAppNavigationItem
 					v-for="child in visibleChildren(item)"
@@ -48,11 +49,12 @@
 					:exact="isExact(child)"
 					:icon="child.icon"
 					:active="isActive(child)"
+					:data-testid="`cn-nav-entry-${child.id}`"
 					@click="onItemClick(child, $event)" />
 			</NcAppNavigationItem>
 		</template>
 		<template v-if="settingsItems.length" #footer>
-			<ul class="cn-app-nav__footer-list">
+			<ul class="cn-app-nav__footer-list" data-testid="cn-nav-footer">
 				<NcAppNavigationItem
 					v-for="item in settingsItems"
 					:key="item.id"
@@ -61,6 +63,7 @@
 					:exact="isExact(item)"
 					:icon="item.icon"
 					:active="isActive(item)"
+					:data-testid="`cn-nav-entry-${item.id}`"
 					@click="onItemClick(item, $event)" />
 			</ul>
 		</template>
diff --git a/src/components/CnAppRoot/CnAppRoot.vue b/src/components/CnAppRoot/CnAppRoot.vue
index 440a06493..df0b5bcd7 100644
--- a/src/components/CnAppRoot/CnAppRoot.vue
+++ b/src/components/CnAppRoot/CnAppRoot.vue
@@ -40,10 +40,10 @@
   and REQ-OR-1..REQ-OR-7 of the cnapproot-app-availability-guard spec.
 -->
 <template>
-	<NcContent :app-name="appId">
+	<NcContent :app-name="appId" data-testid="cn-app-root">
 		<!-- Phase 0a: capabilities check in flight -->
 		<template v-if="capabilitiesLoading">
-			<div class="cn-app-root__capabilities-loading">
+			<div class="cn-app-root__capabilities-loading" data-testid="cn-app-root-capabilities-loading">
 				<NcLoadingIcon :size="32" />
 			</div>
 		</template>
diff --git a/src/components/CnChatPage/CnChatPage.vue b/src/components/CnChatPage/CnChatPage.vue
index 5e7d16a82..625e737f4 100644
--- a/src/components/CnChatPage/CnChatPage.vue
+++ b/src/components/CnChatPage/CnChatPage.vue
@@ -12,7 +12,7 @@
   thread renderers and consumer-built chat UIs).
 -->
 <template>
-	<div class="cn-chat-page">
+	<div class="cn-chat-page" data-testid="cn-chat-page">
 		<!-- Header — overridable via #header slot -->
 		<slot
 			name="header"
diff --git a/src/components/CnContextMenu/CnContextMenu.vue b/src/components/CnContextMenu/CnContextMenu.vue
index 887251c15..89585f57a 100644
--- a/src/components/CnContextMenu/CnContextMenu.vue
+++ b/src/components/CnContextMenu/CnContextMenu.vue
@@ -5,6 +5,7 @@
 		:force-menu="true"
 		class="cn-context-menu"
 		container="body"
+		data-testid="cn-context-menu"
 		@close="onClose">
 		<!-- Dynamic actions from array prop -->
 		<NcActionButton
@@ -13,6 +14,7 @@
 			:title="resolveTitle(action)"
 			:disabled="resolveDisabled(action)"
 			:class="{ 'cn-row-action--destructive': action.destructive }"
+			:data-testid="`cn-action-item-${slugifyLabel(action.label)}`"
 			close-after-click
 			@click="onAction(action)">
 			<template v-if="action.icon" #icon>
@@ -160,6 +162,22 @@ export default {
 			return action.title || undefined
 		},
 
+		/**
+		 * Slugify an action label for use in stable `data-testid` selectors.
+		 * Lowercase, kebab-case, strip non-alphanumeric. Used solely by the
+		 * `:data-testid` binding on NcActionButton — does not affect runtime
+		 * behaviour or rendered text.
+		 *
+		 * @param {string} label The action's display label.
+		 * @return {string} kebab-case slug suitable for a testid suffix.
+		 */
+		slugifyLabel(label) {
+			return String(label || '')
+				.toLowerCase()
+				.replace(/[^a-z0-9]+/g, '-')
+				.replace(/^-+|-+$/g, '')
+		},
+
 		onAction(action) {
 			if (action.handler && typeof action.handler === 'function') {
 				action.handler(this.targetItem)
diff --git a/src/components/CnCopyDialog/CnCopyDialog.vue b/src/components/CnCopyDialog/CnCopyDialog.vue
index 856f156cf..1da11661e 100644
--- a/src/components/CnCopyDialog/CnCopyDialog.vue
+++ b/src/components/CnCopyDialog/CnCopyDialog.vue
@@ -5,7 +5,11 @@
 		:can-close="!loading"
 		@closing="$emit('close')">
 		<!-- Result phase -->
-		<div v-if="result !== null" class="cn-copy__result">
+		<div v-if="result !== null"
+			class="cn-copy__result"
+			data-testid="cn-modal"
+			data-testid-modal="cn-copy-dialog"
+			data-testid-phase="result">
 			<NcNoteCard v-if="result.success" type="success">
 				{{ successText }}
 			</NcNoteCard>
@@ -15,7 +19,11 @@
 		</div>
 
 		<!-- Form phase -->
-		<div v-else class="cn-copy__form">
+		<div v-else
+			class="cn-copy__form"
+			data-testid="cn-modal"
+			data-testid-modal="cn-copy-dialog"
+			data-testid-phase="form">
 			<div class="cn-copy__pattern">
 				<label for="cn-copy-pattern">{{ patternLabel }}</label>
 				<NcSelect
diff --git a/src/components/CnDashboardPage/CnDashboardPage.vue b/src/components/CnDashboardPage/CnDashboardPage.vue
index 3e44c6099..92cbd23a3 100644
--- a/src/components/CnDashboardPage/CnDashboardPage.vue
+++ b/src/components/CnDashboardPage/CnDashboardPage.vue
@@ -10,9 +10,9 @@
   - Header with title, actions, and edit toggle
 -->
 <template>
-	<div class="cn-dashboard-page">
+	<div class="cn-dashboard-page" data-testid="cn-dashboard-page">
 		<!-- Header -->
-		<div class="cn-dashboard-page__header">
+		<div class="cn-dashboard-page__header" data-testid="cn-dashboard-page-header">
 			<div class="cn-dashboard-page__header-left">
 				<h2 v-if="title" class="cn-dashboard-page__title">
 					{{ title }}
diff --git a/src/components/CnDataTable/CnDataTable.vue b/src/components/CnDataTable/CnDataTable.vue
index 2d59030ad..6196bfbca 100644
--- a/src/components/CnDataTable/CnDataTable.vue
+++ b/src/components/CnDataTable/CnDataTable.vue
@@ -1,13 +1,13 @@
 <template>
-	<div class="cn-table-container" :class="{ 'cn-table-container--scrollable': scrollable }">
+	<div class="cn-table-container" data-testid="cn-object-list" :class="{ 'cn-table-container--scrollable': scrollable }">
 		<!-- Loading State -->
-		<div v-if="loading" class="cn-table-loading">
+		<div v-if="loading" class="cn-table-loading" data-testid="cn-object-list-loading">
 			<NcLoadingIcon :size="32" />
 			<p>{{ loadingText }}</p>
 		</div>
 
 		<!-- Table -->
-		<table v-else class="cn-data-table">
+		<table v-else class="cn-data-table" data-testid="cn-object-list-table">
 			<thead>
 				<tr>
 					<!-- Checkbox column -->
@@ -45,7 +45,7 @@
 
 			<tbody>
 				<!-- Empty state -->
-				<tr v-if="rows.length === 0" class="cn-table-empty">
+				<tr v-if="rows.length === 0" class="cn-table-empty" data-testid="cn-object-list-empty">
 					<td :colspan="totalColumns">
 						<slot name="empty">
 							{{ emptyText }}
@@ -59,6 +59,8 @@
 					v-else
 					:key="row[rowKey]"
 					class="cn-table-row"
+					data-testid="cn-object-row"
+					:data-testid-row-id="row[rowKey]"
 					:class="[
 						isSelected(row) ? 'cn-table-row--selected' : '',
 						rowClass ? rowClass(row) : '',
diff --git a/src/components/CnDeleteDialog/CnDeleteDialog.vue b/src/components/CnDeleteDialog/CnDeleteDialog.vue
index 689ac0c38..ece705ab3 100644
--- a/src/components/CnDeleteDialog/CnDeleteDialog.vue
+++ b/src/components/CnDeleteDialog/CnDeleteDialog.vue
@@ -5,7 +5,11 @@
 		:can-close="!loading"
 		@closing="$emit('close')">
 		<!-- Result phase -->
-		<div v-if="result !== null" class="cn-delete__result">
+		<div v-if="result !== null"
+			class="cn-delete__result"
+			data-testid="cn-modal"
+			data-testid-modal="cn-delete-dialog"
+			data-testid-phase="result">
 			<NcNoteCard v-if="result.success" type="success">
 				{{ successText }}
 			</NcNoteCard>
@@ -15,7 +19,11 @@
 		</div>
 
 		<!-- Confirm phase -->
-		<div v-else class="cn-delete__confirm">
+		<div v-else
+			class="cn-delete__confirm"
+			data-testid="cn-modal"
+			data-testid-modal="cn-delete-dialog"
+			data-testid-phase="confirm">
 			<NcNoteCard type="warning">
 				{{ resolvedWarningText }}
 			</NcNoteCard>
diff --git a/src/components/CnDependencyMissing/CnDependencyMissing.vue b/src/components/CnDependencyMissing/CnDependencyMissing.vue
index be6af6606..5361f78bb 100644
--- a/src/components/CnDependencyMissing/CnDependencyMissing.vue
+++ b/src/components/CnDependencyMissing/CnDependencyMissing.vue
@@ -9,7 +9,7 @@
   See REQ-JMR-011 of the json-manifest-renderer specification.
 -->
 <template>
-	<div class="cn-dependency-missing">
+	<div class="cn-dependency-missing" data-testid="cn-dependency-missing">
 		<div class="cn-dependency-missing__inner">
 			<h1 class="cn-dependency-missing__heading">
 				{{ heading }}
diff --git a/src/components/CnDetailPage/CnDetailPage.vue b/src/components/CnDetailPage/CnDetailPage.vue
index ca38e0fef..31708079e 100644
--- a/src/components/CnDetailPage/CnDetailPage.vue
+++ b/src/components/CnDetailPage/CnDetailPage.vue
@@ -21,9 +21,9 @@
   - Content sections via slots
 -->
 <template>
-	<div class="cn-detail-page" :style="{ maxWidth: maxWidth }">
+	<div class="cn-detail-page" data-testid="cn-detail-page" :style="{ maxWidth: maxWidth }">
 		<!-- Header -->
-		<div class="cn-detail-page__header">
+		<div class="cn-detail-page__header" data-testid="cn-detail-page-header">
 			<!-- Header (left block) — overridable via #header slot. Default
 			     renders the icon + title + description. The right-hand
 			     #actions slot remains separate so headerComponent and
diff --git a/src/components/CnFilesPage/CnFilesPage.vue b/src/components/CnFilesPage/CnFilesPage.vue
index 1efef460a..a4bc3ee04 100644
--- a/src/components/CnFilesPage/CnFilesPage.vue
+++ b/src/components/CnFilesPage/CnFilesPage.vue
@@ -16,7 +16,7 @@
   WebDAV-backed listing).
 -->
 <template>
-	<div class="cn-files-page">
+	<div class="cn-files-page" data-testid="cn-files-page">
 		<!-- Header — overridable via #header slot -->
 		<slot
 			name="header"
diff --git a/src/components/CnFilterBar/CnFilterBar.vue b/src/components/CnFilterBar/CnFilterBar.vue
index 13f086e03..a869550d3 100644
--- a/src/components/CnFilterBar/CnFilterBar.vue
+++ b/src/components/CnFilterBar/CnFilterBar.vue
@@ -1,7 +1,7 @@
 <template>
-	<div class="cn-filter-bar">
+	<div class="cn-filter-bar" data-testid="cn-filter-bar">
 		<!-- Search input -->
-		<div class="cn-filter-bar__search">
+		<div class="cn-filter-bar__search" data-testid="cn-filter-bar-search">
 			<NcTextField
 				:value="searchValue"
 				:placeholder="searchPlaceholder"
diff --git a/src/components/CnFormDialog/CnFormDialog.vue b/src/components/CnFormDialog/CnFormDialog.vue
index 1ee0d3e9b..140d319fc 100644
--- a/src/components/CnFormDialog/CnFormDialog.vue
+++ b/src/components/CnFormDialog/CnFormDialog.vue
@@ -5,7 +5,11 @@
 		:can-close="!loading"
 		@closing="$emit('close')">
 		<!-- Result phase -->
-		<div v-if="result !== null" class="cn-form-dialog__result">
+		<div v-if="result !== null"
+			class="cn-form-dialog__result"
+			data-testid="cn-modal"
+			data-testid-modal="cn-form-dialog"
+			data-testid-phase="result">
 			<NcNoteCard v-if="result.success" type="success">
 				{{ resolvedSuccessText }}
 			</NcNoteCard>
@@ -15,7 +19,11 @@
 		</div>
 
 		<!-- Form phase -->
-		<div v-else class="cn-form-dialog__form">
+		<div v-else
+			class="cn-form-dialog__form"
+			data-testid="cn-modal"
+			data-testid-modal="cn-form-dialog"
+			data-testid-phase="form">
 			<!-- Full form override slot -->
 			<slot
 				v-if="$scopedSlots.form"
diff --git a/src/components/CnFormPage/CnFormPage.vue b/src/components/CnFormPage/CnFormPage.vue
index 93f0dc0f2..55cbb3c40 100644
--- a/src/components/CnFormPage/CnFormPage.vue
+++ b/src/components/CnFormPage/CnFormPage.vue
@@ -37,7 +37,7 @@
   Spec: REQ-MFPT-* (manifest-form-page-type).
 -->
 <template>
-	<div class="cn-form-page" :data-mode="mode">
+	<div class="cn-form-page" :data-mode="mode" data-testid="cn-form-page">
 		<!--
 			@slot header
 			@description Replaces the default `CnPageHeader`. Receives `{ title, description }` as scoped props
diff --git a/src/components/CnIndexPage/CnIndexPage.vue b/src/components/CnIndexPage/CnIndexPage.vue
index f7894ff98..129b8c337 100644
--- a/src/components/CnIndexPage/CnIndexPage.vue
+++ b/src/components/CnIndexPage/CnIndexPage.vue
@@ -1,5 +1,5 @@
 <template>
-	<div class="cn-index-page">
+	<div class="cn-index-page" data-testid="cn-index-page">
 		<!-- Header — overridable via #header slot. Default renders CnPageHeader
 		     when showTitle is true (existing behaviour, hidden by default). -->
 		<slot
diff --git a/src/components/CnLockedBanner/CnLockedBanner.vue b/src/components/CnLockedBanner/CnLockedBanner.vue
index cab743689..f3313b8a4 100644
--- a/src/components/CnLockedBanner/CnLockedBanner.vue
+++ b/src/components/CnLockedBanner/CnLockedBanner.vue
@@ -12,7 +12,8 @@
 	<div
 		class="cn-locked-banner"
 		role="status"
-		aria-live="polite">
+		aria-live="polite"
+		data-testid="cn-locked-banner">
 		<LockOutline :size="20" class="cn-locked-banner__icon" />
 		<div class="cn-locked-banner__body">
 			<p class="cn-locked-banner__message">
diff --git a/src/components/CnLogsPage/CnLogsPage.vue b/src/components/CnLogsPage/CnLogsPage.vue
index a55fd18ab..e76be7648 100644
--- a/src/components/CnLogsPage/CnLogsPage.vue
+++ b/src/components/CnLogsPage/CnLogsPage.vue
@@ -18,7 +18,7 @@
   breaking the app shell.
 -->
 <template>
-	<div class="cn-logs-page">
+	<div class="cn-logs-page" data-testid="cn-logs-page">
 		<!-- Header — overridable via #header slot (renderer fills via headerComponent or slots.header) -->
 		<slot
 			name="header"
diff --git a/src/components/CnMapPage/CnMapPage.vue b/src/components/CnMapPage/CnMapPage.vue
index 810632344..50a4a5cdd 100644
--- a/src/components/CnMapPage/CnMapPage.vue
+++ b/src/components/CnMapPage/CnMapPage.vue
@@ -27,7 +27,7 @@
   Spec: REQ-MMW-* (manifest-map-widget).
 -->
 <template>
-	<div class="cn-map-page">
+	<div class="cn-map-page" data-testid="cn-map-page">
 		<!--
 			@slot header
 			@description Replaces the default `CnPageHeader`. Receives `{ title, description }`.
diff --git a/src/components/CnMassCopyDialog/CnMassCopyDialog.vue b/src/components/CnMassCopyDialog/CnMassCopyDialog.vue
index 6dfff0fca..77c543894 100644
--- a/src/components/CnMassCopyDialog/CnMassCopyDialog.vue
+++ b/src/components/CnMassCopyDialog/CnMassCopyDialog.vue
@@ -5,7 +5,11 @@
 		:can-close="!loading"
 		@closing="$emit('close')">
 		<!-- Review phase -->
-		<div v-if="result === null" class="cn-mass-copy__review">
+		<div v-if="result === null"
+			class="cn-mass-copy__review"
+			data-testid="cn-modal"
+			data-testid-modal="cn-mass-copy-dialog"
+			data-testid-phase="review">
 			<div class="cn-mass-copy__pattern">
 				<label for="cn-mass-copy-pattern">{{ patternLabel }}</label>
 				<NcSelect
@@ -43,7 +47,11 @@
 		</div>
 
 		<!-- Result phase -->
-		<div v-else class="cn-mass-copy__result">
+		<div v-else
+			class="cn-mass-copy__result"
+			data-testid="cn-modal"
+			data-testid-modal="cn-mass-copy-dialog"
+			data-testid-phase="result">
 			<NcNoteCard v-if="result.success" type="success">
 				{{ successText }}
 			</NcNoteCard>
diff --git a/src/components/CnMassDeleteDialog/CnMassDeleteDialog.vue b/src/components/CnMassDeleteDialog/CnMassDeleteDialog.vue
index 947a78594..b25d0aa5e 100644
--- a/src/components/CnMassDeleteDialog/CnMassDeleteDialog.vue
+++ b/src/components/CnMassDeleteDialog/CnMassDeleteDialog.vue
@@ -5,7 +5,11 @@
 		:can-close="!loading"
 		@closing="$emit('close')">
 		<!-- Review phase -->
-		<div v-if="result === null" class="cn-mass-delete__review">
+		<div v-if="result === null"
+			class="cn-mass-delete__review"
+			data-testid="cn-modal"
+			data-testid-modal="cn-mass-delete-dialog"
+			data-testid-phase="review">
 			<NcNoteCard type="warning">
 				{{ warningText }}
 			</NcNoteCard>
@@ -35,7 +39,11 @@
 		</div>
 
 		<!-- Result phase -->
-		<div v-else class="cn-mass-delete__result">
+		<div v-else
+			class="cn-mass-delete__result"
+			data-testid="cn-modal"
+			data-testid-modal="cn-mass-delete-dialog"
+			data-testid-phase="result">
 			<NcNoteCard v-if="result.success" type="success">
 				{{ successText }}
 			</NcNoteCard>
diff --git a/src/components/CnMassExportDialog/CnMassExportDialog.vue b/src/components/CnMassExportDialog/CnMassExportDialog.vue
index 9b5a3e698..110c57bba 100644
--- a/src/components/CnMassExportDialog/CnMassExportDialog.vue
+++ b/src/components/CnMassExportDialog/CnMassExportDialog.vue
@@ -5,7 +5,11 @@
 		:can-close="!loading"
 		@closing="$emit('close')">
 		<!-- Result phase -->
-		<div v-if="result !== null" class="cn-mass-export__result">
+		<div v-if="result !== null"
+			class="cn-mass-export__result"
+			data-testid="cn-modal"
+			data-testid-modal="cn-mass-export-dialog"
+			data-testid-phase="result">
 			<NcNoteCard v-if="result.success" type="success">
 				{{ successText }}
 			</NcNoteCard>
@@ -15,7 +19,11 @@
 		</div>
 
 		<!-- Form phase -->
-		<div v-else class="cn-mass-export__form">
+		<div v-else
+			class="cn-mass-export__form"
+			data-testid="cn-modal"
+			data-testid-modal="cn-mass-export-dialog"
+			data-testid-phase="form">
 			<p v-if="description" class="cn-mass-export__description">
 				{{ description }}
 			</p>
diff --git a/src/components/CnMassImportDialog/CnMassImportDialog.vue b/src/components/CnMassImportDialog/CnMassImportDialog.vue
index 6887d6479..204c96b64 100644
--- a/src/components/CnMassImportDialog/CnMassImportDialog.vue
+++ b/src/components/CnMassImportDialog/CnMassImportDialog.vue
@@ -16,7 +16,11 @@
 		</NcNoteCard>
 
 		<!-- Results summary table -->
-		<div v-if="result && result.summary" class="cn-mass-import__results">
+		<div v-if="result && result.summary"
+			class="cn-mass-import__results"
+			data-testid="cn-modal"
+			data-testid-modal="cn-mass-import-dialog"
+			data-testid-phase="result">
 			<h3>{{ summaryTitle }}</h3>
 			<table class="cn-mass-import__summary-table">
 				<thead>
@@ -88,7 +92,11 @@
 		</div>
 
 		<!-- Upload form -->
-		<div v-if="!result" class="cn-mass-import__form">
+		<div v-if="!result"
+			class="cn-mass-import__form"
+			data-testid="cn-modal"
+			data-testid-modal="cn-mass-import-dialog"
+			data-testid-phase="form">
 			<input
 				ref="fileInput"
 				type="file"
diff --git a/src/components/CnObjectSidebar/CnObjectSidebar.vue b/src/components/CnObjectSidebar/CnObjectSidebar.vue
index 515c0e891..2e0133a25 100644
--- a/src/components/CnObjectSidebar/CnObjectSidebar.vue
+++ b/src/components/CnObjectSidebar/CnObjectSidebar.vue
@@ -11,6 +11,7 @@
 		:title="sidebarTitle"
 		:subtitle="sidebarSubtitle"
 		:active.sync="activeTab"
+		data-testid="cn-object-sidebar"
 		@update:open="$emit('update:open', $event)"
 		@close="$emit('update:open', false)">
 		<!-- REGISTRY BRANCH: pluggable integration registry-driven.
@@ -28,7 +29,8 @@
 				:id="provider.id"
 				:key="provider.id"
 				:name="provider.label"
-				:order="provider.order != null ? provider.order : idx + 1">
+				:order="provider.order != null ? provider.order : idx + 1"
+				:data-testid="`cn-object-sidebar-tab-${provider.id}`">
 				<template #icon>
 					<CnIcon v-if="provider.icon" :name="provider.icon" :size="20" />
 				</template>
@@ -50,7 +52,8 @@
 				v-if="!isTabHidden('files')"
 				id="files"
 				:name="filesLabel"
-				:order="1">
+				:order="1"
+				data-testid="cn-object-sidebar-tab-files">
 				<template #icon>
 					<Paperclip :size="20" />
 				</template>
@@ -68,7 +71,8 @@
 				v-if="!isTabHidden('notes')"
 				id="notes"
 				:name="notesLabel"
-				:order="2">
+				:order="2"
+				data-testid="cn-object-sidebar-tab-notes">
 				<template #icon>
 					<CommentTextOutline :size="20" />
 				</template>
@@ -86,7 +90,8 @@
 				v-if="!isTabHidden('tags')"
 				id="tags"
 				:name="tagsLabel"
-				:order="3">
+				:order="3"
+				data-testid="cn-object-sidebar-tab-tags">
 				<template #icon>
 					<TagOutline :size="20" />
 				</template>
@@ -104,7 +109,8 @@
 				v-if="!isTabHidden('tasks')"
 				id="tasks"
 				:name="tasksLabel"
-				:order="4">
+				:order="4"
+				data-testid="cn-object-sidebar-tab-tasks">
 				<template #icon>
 					<CheckboxMarkedOutline :size="20" />
 				</template>
@@ -122,7 +128,8 @@
 				v-if="!isTabHidden('auditTrail')"
 				id="auditTrail"
 				:name="auditTrailLabel"
-				:order="5">
+				:order="5"
+				data-testid="cn-object-sidebar-tab-audit-trail">
 				<template #icon>
 					<History :size="20" />
 				</template>
@@ -151,7 +158,8 @@
 				:id="tab.id"
 				:key="tab.id"
 				:name="tab.label"
-				:order="tab.order != null ? tab.order : idx + 1">
+				:order="tab.order != null ? tab.order : idx + 1"
+				:data-testid="`cn-object-sidebar-tab-${tab.id}`">
 				<template v-if="tab.icon" #icon>
 					<CnIcon :name="tab.icon" :size="20" />
 				</template>
diff --git a/src/components/CnPageHeader/CnPageHeader.vue b/src/components/CnPageHeader/CnPageHeader.vue
index a60b319d9..18c2d4947 100644
--- a/src/components/CnPageHeader/CnPageHeader.vue
+++ b/src/components/CnPageHeader/CnPageHeader.vue
@@ -1,15 +1,15 @@
 <template>
-	<div class="cn-page-header">
+	<div class="cn-page-header" data-testid="cn-page-header">
 		<div v-if="icon || $slots.icon" class="cn-page-header__icon">
 			<slot name="icon">
 				<CnIcon :name="icon" :size="iconSize" />
 			</slot>
 		</div>
 		<div class="cn-page-header__text">
-			<h1 class="cn-page-header__title">
+			<h1 class="cn-page-header__title" data-testid="cn-page-title">
 				{{ title }}
 			</h1>
-			<p v-if="description" class="cn-page-header__description">
+			<p v-if="description" class="cn-page-header__description" data-testid="cn-page-description">
 				{{ description }}
 			</p>
 		</div>
diff --git a/src/components/CnPageRenderer/CnPageRenderer.vue b/src/components/CnPageRenderer/CnPageRenderer.vue
index a1a4d9133..9dc24be03 100644
--- a/src/components/CnPageRenderer/CnPageRenderer.vue
+++ b/src/components/CnPageRenderer/CnPageRenderer.vue
@@ -28,6 +28,8 @@
 	<div
 		v-if="currentPage"
 		:data-page-id="currentPage.id"
+		data-testid="cn-page"
+		:data-testid-page-id="currentPage.id"
 		:class="['cn-page-renderer', { 'cn-page-renderer--no-sidebar': !pageSidebarVisibleValue }]">
 		<component
 			:is="resolvedComponent"
diff --git a/src/components/CnPagination/CnPagination.vue b/src/components/CnPagination/CnPagination.vue
index 815b2e672..a7386d5dc 100644
--- a/src/components/CnPagination/CnPagination.vue
+++ b/src/components/CnPagination/CnPagination.vue
@@ -1,5 +1,5 @@
 <template>
-	<div v-if="totalPages > 1 || totalItems > minItemsToShow" class="cn-pagination">
+	<div v-if="totalPages > 1 || totalItems > minItemsToShow" class="cn-pagination" data-testid="cn-pagination">
 		<!-- Page info -->
 		<div class="cn-pagination__info">
 			<span class="cn-pagination__page-info">
diff --git a/src/components/CnRowActions/CnRowActions.vue b/src/components/CnRowActions/CnRowActions.vue
index 64023e094..4dfa7d70c 100644
--- a/src/components/CnRowActions/CnRowActions.vue
+++ b/src/components/CnRowActions/CnRowActions.vue
@@ -1,11 +1,15 @@
 <template>
-	<NcActions :force-menu="visibleActions.length > 3" :primary="primary" :menu-name="menuName">
+	<NcActions :force-menu="visibleActions.length > 3"
+		:primary="primary"
+		:menu-name="menuName"
+		data-testid="cn-row-actions">
 		<NcActionButton
 			v-for="action in visibleActions"
 			:key="action.label"
 			:title="getTitle(action)"
 			:disabled="isDisabled(action)"
 			:class="{ 'cn-row-action--destructive': action.destructive }"
+			:data-testid="`cn-action-item-${slugifyLabel(action.label)}`"
 			close-after-click
 			@click="onAction(action)">
 			<template v-if="action.icon" #icon>
@@ -125,6 +129,20 @@ export default {
 			}
 			this.$emit('action', { action: action.label, row: this.row })
 		},
+		/**
+		 * Slugify an action label for use in stable `data-testid` selectors.
+		 * Lowercase, kebab-case, strip non-alphanumeric. Used solely by the
+		 * `:data-testid` binding on NcActionButton — does not affect runtime
+		 * behaviour or rendered text.
+		 * @param {string} label - The action's display label
+		 * @return {string} kebab-case slug suitable for a testid suffix.
+		 */
+		slugifyLabel(label) {
+			return String(label || '')
+				.toLowerCase()
+				.replace(/[^a-z0-9]+/g, '-')
+				.replace(/^-+|-+$/g, '')
+		},
 	},
 }
 </script>
diff --git a/src/components/CnSettingsPage/CnSettingsPage.vue b/src/components/CnSettingsPage/CnSettingsPage.vue
index 76950a262..67a702d5a 100644
--- a/src/components/CnSettingsPage/CnSettingsPage.vue
+++ b/src/components/CnSettingsPage/CnSettingsPage.vue
@@ -31,7 +31,7 @@
   `slots[]` slots exposed here.
 -->
 <template>
-	<div class="cn-settings-page">
+	<div class="cn-settings-page" data-testid="cn-settings-page">
 		<!-- Header — overridable via #header slot -->
 		<slot
 			name="header"
@@ -57,7 +57,8 @@
 		<div
 			v-if="hasTabs"
 			class="cn-settings-page__tabs"
-			role="tablist">
+			role="tablist"
+			data-testid="cn-settings-page-tabs">
 			<button
 				v-for="(tab, tabIndex) in tabs"
 				:key="`tab-${tab.id}`"
@@ -67,6 +68,7 @@
 				:class="{ 'cn-settings-page__tab--active': activeTabId === tab.id }"
 				:aria-selected="activeTabId === tab.id ? 'true' : 'false'"
 				:aria-controls="`cn-settings-tab-panel-${tab.id}`"
+				:data-testid="`cn-settings-page-tab-${tab.id}`"
 				@click="onTabClick(tab, tabIndex)">
 				{{ resolveLabel(tab.label) }}
 			</button>
diff --git a/src/components/CnSettingsSection/CnSettingsSection.vue b/src/components/CnSettingsSection/CnSettingsSection.vue
index 89d1dcaa1..ad5d5a6aa 100644
--- a/src/components/CnSettingsSection/CnSettingsSection.vue
+++ b/src/components/CnSettingsSection/CnSettingsSection.vue
@@ -3,6 +3,7 @@
 		:name="name"
 		:description="description"
 		:doc-url="docUrl"
+		data-testid="cn-settings-section"
 		v-bind="$attrs">
 		<!-- Action buttons positioned top-right -->
 		<div v-if="$slots.actions" class="cn-settings-section__actions">
diff --git a/src/components/CnSuggestFeatureModal/CnSuggestFeatureModal.vue b/src/components/CnSuggestFeatureModal/CnSuggestFeatureModal.vue
index d4f4be199..306100d9d 100644
--- a/src/components/CnSuggestFeatureModal/CnSuggestFeatureModal.vue
+++ b/src/components/CnSuggestFeatureModal/CnSuggestFeatureModal.vue
@@ -4,7 +4,7 @@
 		size="normal"
 		:can-close="!submitting"
 		@closing="$emit('close')">
-		<div class="cn-suggest-feature-modal">
+		<div class="cn-suggest-feature-modal" data-testid="cn-modal" data-testid-modal="cn-suggest-feature-modal">
 			<NcTextField
 				v-model="form.title"
 				:label="titleLabel"
diff --git a/src/components/CnTabbedFormDialog/CnTabbedFormDialog.vue b/src/components/CnTabbedFormDialog/CnTabbedFormDialog.vue
index deea12d12..9f474da02 100644
--- a/src/components/CnTabbedFormDialog/CnTabbedFormDialog.vue
+++ b/src/components/CnTabbedFormDialog/CnTabbedFormDialog.vue
@@ -5,7 +5,11 @@
 		:can-close="!loading"
 		@closing="$emit('close')">
 		<!-- Result phase (standard mode, not create-another) -->
-		<div v-if="result !== null && !createAnother" class="cn-tabbed-form-dialog__result">
+		<div v-if="result !== null && !createAnother"
+			class="cn-tabbed-form-dialog__result"
+			data-testid="cn-modal"
+			data-testid-modal="cn-tabbed-form-dialog"
+			data-testid-phase="result">
 			<NcNoteCard v-if="result.success" type="success">
 				{{ resolvedSuccessText }}
 			</NcNoteCard>
@@ -15,7 +19,11 @@
 		</div>
 
 		<!-- Form phase (or create-another mode where form stays visible) -->
-		<div v-if="createAnother || result === null" class="cn-tabbed-form-dialog__form">
+		<div v-if="createAnother || result === null"
+			class="cn-tabbed-form-dialog__form"
+			data-testid="cn-modal"
+			data-testid-modal="cn-tabbed-form-dialog"
+			data-testid-phase="form">
 			<!-- Inline notifications for create-another mode -->
 			<NcNoteCard v-if="createAnother && result && result.success" type="success">
 				{{ resolvedSuccessText }}
diff --git a/src/components/CnUserActionMenu/CnUserActionMenu.vue b/src/components/CnUserActionMenu/CnUserActionMenu.vue
index 06e92781f..b8258aa1e 100644
--- a/src/components/CnUserActionMenu/CnUserActionMenu.vue
+++ b/src/components/CnUserActionMenu/CnUserActionMenu.vue
@@ -5,7 +5,7 @@
   based on which Nextcloud apps are installed (Talk, Mail, Calendar).
 -->
 <template>
-	<span class="cn-user-action-menu">
+	<span class="cn-user-action-menu" data-testid="cn-user-action-menu">
 		<span
 			ref="trigger"
 			class="cn-user-action-menu__trigger"
diff --git a/src/components/CnWikiPage/CnWikiPage.vue b/src/components/CnWikiPage/CnWikiPage.vue
index e6104f547..9ff9abb33 100644
--- a/src/components/CnWikiPage/CnWikiPage.vue
+++ b/src/components/CnWikiPage/CnWikiPage.vue
@@ -32,7 +32,7 @@
   Spec: REQ-MWPT-* (manifest-wiki-page-type).
 -->
 <template>
-	<div class="cn-wiki-page" :class="{ 'cn-wiki-page--has-sidebar': hasSidebar }">
+	<div class="cn-wiki-page" data-testid="cn-wiki-page" :class="{ 'cn-wiki-page--has-sidebar': hasSidebar }">
 		<!--
 			@slot sidebar
 			@description Replaces the default sidebar tree. Scoped props `{ tree, onClick }` —
diff --git a/src/dialogs/CnAiHistoryDialog.vue b/src/dialogs/CnAiHistoryDialog.vue
index 6cc8bb29a..10976ad16 100644
--- a/src/dialogs/CnAiHistoryDialog.vue
+++ b/src/dialogs/CnAiHistoryDialog.vue
@@ -20,7 +20,11 @@
 		@update:open="$emit('update:open', $event)">
 		<template #default>
 			<!-- Loading state -->
-			<div v-if="loading" class="cn-ai-history-dialog__loading">
+			<div v-if="loading"
+				class="cn-ai-history-dialog__loading"
+				data-testid="cn-modal"
+				data-testid-modal="cn-ai-history-dialog"
+				data-testid-phase="loading">
 				<NcLoadingIcon :size="32" />
 				<span>{{ cnTranslate('Loading conversations...') }}</span>
 			</div>
@@ -44,7 +48,11 @@
 			</NcEmptyContent>
 
 			<!-- Conversation list -->
-			<ul v-else class="cn-ai-history-dialog__list">
+			<ul v-else
+				class="cn-ai-history-dialog__list"
+				data-testid="cn-modal"
+				data-testid-modal="cn-ai-history-dialog"
+				data-testid-phase="list">
 				<li
 					v-for="conv in conversations"
 					:key="conv.uuid"