Task/task UI/labels/three column layout with instance browser

DEMO_SETUP.md

@@ -226,6 +226,42 @@ The test suite creates temporary test data. You can reference `tests/conftest.py
    - Read-only: checked (recommended for demo)
 3. Click **"Create Mount"**
 
+### API Endpoints (for Links Integration)
+
+1. Navigate to **Settings** > **Links** section
+2. Scroll to "API Endpoint Mappings"
+3. Configure a new endpoint:
+   - **Name**: Descriptive name (e.g., "Users API")
+   - **URL**: Full API endpoint URL (e.g., `https://api.example.com/users`)
+   - **Auth Method**: Select authentication type:
+     - `None`: No authentication
+     - `Bearer Token`: OAuth/JWT bearer token
+     - `API Key`: API key in X-API-Key header
+   - **Auth Value**: Enter token/key if authentication is required
+   - **JSONPath** (optional): Extract specific data (e.g., `$.data[*]`)
+   - **Maps to Label** (optional): Target Label for imported data
+4. Click **"Test Connection"** to verify the endpoint
+5. Click **"Save Endpoint"** to register it
+
+**Using API Endpoints in Links:**
+- Registered endpoints appear in the Links wizard
+- Select an endpoint as a data source when creating links
+- Field mappings automatically populate from endpoint configuration
+
+**Security Notes:**
+- Auth tokens are encrypted at rest in the settings database
+- For production, set `SCIDK_API_ENCRYPTION_KEY` environment variable
+- Without this variable, an ephemeral key is generated (not persistent across restarts)
+
+**Example: JSONPlaceholder Test API**
+```
+Name: JSONPlaceholder Users
+URL: https://jsonplaceholder.typicode.com/users
+Auth Method: None
+JSONPath: $[*]
+Maps to Label: User
+```
+
 ## Troubleshooting
 
 ### Application Won't Start

e2e/chat.spec.ts

@@ -18,7 +18,7 @@ test('chat page loads and displays beta badge', async ({ page, baseURL }) => {
   await page.waitForLoadState('networkidle');
 
   // Verify page loads
-  await expect(page).toHaveTitle(/SciDK - Chats/i, { timeout: 10_000 });
+  await expect(page).toHaveTitle(/-SciDK-> Chats/i, { timeout: 10_000 });
 
   // Check for Beta badge
   const betaBadge = page.locator('.badge');
@@ -57,7 +57,7 @@ test('chat navigation link is visible in header', async ({ page, baseURL }) => {
   // Click it and verify we navigate to chat page
   await chatsLink.click();
   await page.waitForLoadState('networkidle');
-  await expect(page).toHaveTitle(/SciDK - Chats/i);
+  await expect(page).toHaveTitle(/-SciDK-> Chats/i);
 });
 
 test('chat form can accept input', async ({ page, baseURL }) => {

e2e/core-flows.spec.ts

@@ -136,7 +136,7 @@ test('navigation covers all 7 pages', async ({ page, baseURL }) => {
     { testId: 'nav-maps', url: '/map', titlePattern: /Map/i },
     { testId: 'nav-chats', url: '/chat', titlePattern: /Chat/i },
     { testId: 'nav-labels', url: '/labels', titlePattern: /Labels/i },
-    { testId: 'nav-links', url: '/links', titlePattern: /Links/i },
+    { testId: 'nav-integrate', url: '/integrate', titlePattern: /-SciDK-> Integrations/i },
     { testId: 'nav-settings', url: '/settings', titlePattern: /Settings/i },
   ];
 

e2e/global-setup.ts

@@ -48,6 +48,16 @@ export default async function globalSetup(config: FullConfig) {
   (process as any).env.BASE_URL = baseUrl;
 
   await waitForReady(baseUrl);
+
+  // Clean up any leftover test data from previous runs
+  try {
+    await fetch(`${baseUrl}/api/admin/cleanup-test-scans`, { method: 'POST' });
+    await fetch(`${baseUrl}/api/admin/cleanup-test-labels`, { method: 'POST' });
+    await fetch(`${baseUrl}/api/admin/cleanup-test-endpoints`, { method: 'POST' });
+    console.log('[setup] Test data cleaned up');
+  } catch (error) {
+    console.error('[setup] Failed to cleanup test data:', error);
+  }
 }
 
 export async function teardown() {

e2e/global-teardown.ts

@@ -28,6 +28,17 @@ export default async function globalTeardown(config: FullConfig) {
     } catch (error) {
       console.error('[cleanup] Failed to cleanup test labels:', error);
     }
+
+    // Clean up test API endpoints
+    try {
+      const response = await fetch(`${baseUrl}/api/admin/cleanup-test-endpoints`, {
+        method: 'POST',
+      });
+      const result = await response.json();
+      console.log('[cleanup] Test API endpoints cleaned up:', result);
+    } catch (error) {
+      console.error('[cleanup] Failed to cleanup test API endpoints:', error);
+    }
   }
 
   // Kill the server process

e2e/links-advanced.spec.ts → e2e/integrations-advanced.spec.ts

@@ -7,14 +7,14 @@ import { test, expect } from '@playwright/test';
 
 test('links page api source inputs are functional', async ({ page, baseURL }) => {
   const base = baseURL || process.env.BASE_URL || 'http://127.0.0.1:5000';
-  await page.goto(`${base}/links`);
+  await page.goto(`${base}/integrate`);
   await page.waitForLoadState('networkidle');
 
   // Wait for labels to load (Links page needs labels for dropdowns)
   await page.waitForTimeout(2000);
 
   // Create new link
-  await page.getByTestId('new-link-btn').click();
+  await page.getByTestId('new-integration-btn').click();
 
   // Switch to API source type
   const apiSourceButton = page.locator('button').filter({ hasText: /^API$/i });
@@ -38,14 +38,14 @@ test('links page api source inputs are functional', async ({ page, baseURL }) =>
 
 test('links page target graph label input is functional', async ({ page, baseURL }) => {
   const base = baseURL || process.env.BASE_URL || 'http://127.0.0.1:5000';
-  await page.goto(`${base}/links`);
+  await page.goto(`${base}/integrate`);
   await page.waitForLoadState('networkidle');
 
   // Wait for labels to load (Links page needs labels for dropdowns)
   await page.waitForTimeout(2000);
 
   // Create new link
-  await page.getByTestId('new-link-btn').click();
+  await page.getByTestId('new-integration-btn').click();
 
   // Navigate to target step (wizard has: source -> target -> matching -> relationship)
   const nextButton = page.locator('#btn-next');
@@ -78,14 +78,14 @@ test('links page target graph label input is functional', async ({ page, baseURL
 
 test('links page cypher matching query input is functional', async ({ page, baseURL }) => {
   const base = baseURL || process.env.BASE_URL || 'http://127.0.0.1:5000';
-  await page.goto(`${base}/links`);
+  await page.goto(`${base}/integrate`);
   await page.waitForLoadState('networkidle');
 
   // Wait for labels to load (Links page needs labels for dropdowns)
   await page.waitForTimeout(2000);
 
   // Create new link
-  await page.getByTestId('new-link-btn').click();
+  await page.getByTestId('new-integration-btn').click();
 
   // Navigate through wizard to matching step (4 steps to reach matching)
   const nextButton = page.locator('#btn-next');
@@ -118,14 +118,14 @@ test('links page cypher matching query input is functional', async ({ page, base
 
 test('links page preview button is present', async ({ page, baseURL }) => {
   const base = baseURL || process.env.BASE_URL || 'http://127.0.0.1:5000';
-  await page.goto(`${base}/links`);
+  await page.goto(`${base}/integrate`);
   await page.waitForLoadState('networkidle');
 
   // Wait for labels to load (Links page needs labels for dropdowns)
   await page.waitForTimeout(2000);
 
   // Create new link
-  await page.getByTestId('new-link-btn').click();
+  await page.getByTestId('new-integration-btn').click();
 
   // Navigate through wizard
   const nextButton = page.locator('#btn-next');
@@ -155,7 +155,7 @@ test('links page preview button is present', async ({ page, baseURL }) => {
 
 test('links page execute button is present and functional', async ({ page, baseURL }) => {
   const base = baseURL || process.env.BASE_URL || 'http://127.0.0.1:5000';
-  await page.goto(`${base}/links`);
+  await page.goto(`${base}/integrate`);
   await page.waitForLoadState('networkidle');
 
   // Wait for labels to load (Links page needs labels for dropdowns)
@@ -174,7 +174,7 @@ test('links page execute button is present and functional', async ({ page, baseU
       await expect(executeButton).toBeVisible();
 
       // Mock API to prevent actual execution
-      await page.route('**/api/links/*/execute', async (route) => {
+      await page.route('**/api/integrate/*/execute', async (route) => {
         await route.fulfill({
           status: 200,
           contentType: 'application/json',
@@ -191,10 +191,10 @@ test('links page execute button is present and functional', async ({ page, baseU
     }
   } else {
     // Create a new link and save it first
-    await page.getByTestId('new-link-btn').click();
+    await page.getByTestId('new-integration-btn').click();
 
     // Fill in minimal link data
-    await page.locator('#link-name').fill('Test Execute Link');
+    await page.locator('#integration-name').fill('Test Execute Link');
 
     // Fill CSV data
     const csvData = page.locator('#csv-data');