TEST-UNIFY-3: specs into domain folders + playwright config rewrite (0 collection errors, gate green)

.github/workflows/ci.yml

@@ -189,7 +189,7 @@ jobs:
           TEST_URL: http://localhost:3127
           CI: true
       - name: Living-graph effects render (LIVE-*)
-        run: npx playwright test tests/e2e/living-graph.spec.ts --project="GraphDone-Core/dev-neo4j/chromium" --reporter=line
+        run: npx playwright test tests/e2e/graph/living-graph-effects.spec.ts --project="GraphDone-Core/dev-neo4j/chromium" --reporter=line
         env:
           TEST_URL: http://localhost:3127
           CI: true

package.json

@@ -17,7 +17,7 @@
     "test:coverage": "turbo run test:coverage",
     "test:e2e": "playwright test",
     "test:e2e:core": "playwright test --grep=\"@core\"",
-    "test:e2e:visual": "playwright test tests/e2e/visual-regression-suite.spec.ts",
+    "test:e2e:visual": "playwright test tests/e2e/reports/visual-regression.spec.ts",
     "test:e2e:ui": "playwright test --ui",
     "test:e2e:debug": "playwright test --debug",
     "test:all": "npm run test:unit && npm run test:e2e",
@@ -37,7 +37,7 @@
     "db:seed": "cd packages/server && npm run db:seed",
     "docker:dev": "docker compose -f deployment/docker-compose.dev.yml up",
     "docker:prod": "docker compose -f deployment/docker-compose.yml up",
-    "test:smoke": "playwright test tests/e2e/user-smoke.spec.ts --reporter=line",
+    "test:smoke": "playwright test tests/e2e/smoke/user-smoke.spec.ts --reporter=line",
     "test:mobile": "playwright test --grep \"@mobile|@audit\" --project=\"GraphDone-Core/dev-neo4j/chromium\" --reporter=line",
     "report:showcase": "playwright test --project=showcase && node tests/generate-showcase-report.mjs",
     "report:matrix": "playwright test --project=matrix --reporter=line,html && node tests/generate-matrix-report.mjs",

playwright.config.ts

@@ -38,10 +38,10 @@ export default defineConfig({
   projects: [
     {
       name: 'GraphDone-Core/dev-neo4j/chromium',
-      // The showcase tour and the local-VLM visual eval run in their own
-      // capture-heavy projects below; keep them out of the default (fast)
+      // Capture-heavy, report-only specs live under tests/e2e/reports/ and run in
+      // their own projects below; keep that whole folder out of the default (fast)
       // project so the smoke gate stays quick.
-      testIgnore: [/showcase\.spec\.ts/, /visual-vlm\.spec\.ts/, /feature-matrix\.spec\.ts/, /matrix\.setup\.ts/],
+      testIgnore: '**/reports/**',
       use: { ...devices['Desktop Chrome'] },
     },
 
@@ -103,7 +103,7 @@ export default defineConfig({
     {
       name: 'vlm',
       testDir: './tests/e2e',
-      testMatch: /visual-vlm\.spec\.ts/,
+      testMatch: /vlm-evaluation\.spec\.ts/,
       use: { ...devices['Desktop Chrome'], screenshot: 'on' },
     },
 

tests/diagnostics/explorer-tree.spec.ts → tests/diagnostics/hierarchy/explorer-tree.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * Project-explorer hierarchy: the graph selector expands a parent graph

tests/diagnostics/hierarchy-navigation.spec.ts → tests/diagnostics/hierarchy/navigation.spec.ts

@@ -1,7 +1,7 @@
 import { test, expect, Page } from '@playwright/test';
 import * as fs from 'fs';
 import * as path from 'path';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * Altium-style "graphs of graphs" navigation: from the System Overview, a

tests/diagnostics/node-inspector.spec.ts → tests/diagnostics/inspector/node-inspector.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * Docked inspector: selecting a node opens it; Contents renders its description

tests/diagnostics/core-interactions.spec.ts → tests/diagnostics/interactions/core-matrix.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * CORE INTERACTION MATRIX — the "basic user checks" every build must pass.

tests/diagnostics/interaction-audit.spec.ts → tests/diagnostics/interactions/relationship-audit.spec.ts

@@ -1,8 +1,8 @@
 import { test, expect, Page } from '@playwright/test';
 import * as fs from 'fs';
 import * as path from 'path';
-import { login, TEST_USERS } from '../lib/auth';
-import { sweepTestData, TEST_GRAPH_PREFIX } from '../lib/dbHealing';
+import { login, TEST_USERS } from '../../lib/auth';
+import { sweepTestData, TEST_GRAPH_PREFIX } from '../../lib/dbHealing';
 
 /**
  * Basic-interaction audit — walks the everyday graph interactions a user does

tests/diagnostics/graph-geometry.spec.ts → tests/diagnostics/layout/geometry.spec.ts

@@ -1,8 +1,8 @@
 import { test, expect, Page } from '@playwright/test';
 import * as fs from 'fs';
 import * as path from 'path';
-import { login, TEST_USERS } from '../lib/auth';
-import { sweepTestData, TEST_GRAPH_PREFIX } from '../lib/dbHealing';
+import { login, TEST_USERS } from '../../lib/auth';
+import { sweepTestData, TEST_GRAPH_PREFIX } from '../../lib/dbHealing';
 
 /**
  * Graph-geometry diagnostic — measures node/edge/label geometry from the REAL

tests/diagnostics/graph-balance.spec.ts → tests/diagnostics/layout/graph-balance.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 import { execFileSync } from 'node:child_process';
 import { mkdirSync } from 'node:fs';
 import * as path from 'node:path';

tests/diagnostics/large-graph-profile.spec.ts → tests/diagnostics/perf/large-graph-profile.spec.ts

@@ -1,7 +1,7 @@
 import { test, expect, Page } from '@playwright/test';
 import * as fs from 'fs';
 import * as path from 'path';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * BASELINE profiler for the Compute Core (1000-node) example graph the user

tests/diagnostics/physics-settle.spec.ts → tests/diagnostics/physics/settle.spec.ts

@@ -1,7 +1,7 @@
 import { test, expect, Page } from '@playwright/test';
 import * as fs from 'fs';
 import * as path from 'path';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * Physics-lifecycle diagnostic — proves the one-shot model: a graph settles,

tests/diagnostics/node-expand-legibility.spec.ts → tests/diagnostics/ui/legibility-floor.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * PR-3 (expand-in-place) + PR-4 (zoom-decoupled legibility floor).

tests/diagnostics/minimap-zoom.spec.ts → tests/diagnostics/ui/minimap-zoom.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * Minimap wheel/pinch zoom: a wheel over the minimap zooms the MAIN view

tests/diagnostics/insecure-connection-banner.spec.ts → tests/diagnostics/ui/tls-banner.spec.ts

@@ -1,7 +1,7 @@
 import { test, expect, Page } from '@playwright/test';
 import * as fs from 'fs';
 import * as path from 'path';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * The insecure-connection (HTTP) warning must integrate cleanly: a slim strip

tests/e2e/a11y-focus.spec.ts → tests/e2e/a11y/modal-focus.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 
 /**
  * Modal accessibility / keyboard-focus gate (@a11y). Asserts the contract added

tests/e2e/admin-database-tab.spec.ts → tests/e2e/admin/database-tab.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 
 test.describe('Admin Database Tab', () => {
   test.beforeEach(async ({ page }) => {

tests/e2e/oauth-provider-config.spec.ts → tests/e2e/admin/oauth-provider-config.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 
 test.describe('OAuth Provider Configuration (Admin Panel)', () => {
   test.beforeEach(async ({ page }) => {

tests/e2e/api-health.spec.ts → tests/e2e/api/health.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { HEALTH_URL, gqlRequest, apiLogin } from '../lib/api';
+import { HEALTH_URL, gqlRequest, apiLogin } from '../../lib/api';
 
 // API health checks, deployment-agnostic: every URL derives from TEST_URL
 // (nginx route layout in production, Vite proxy in dev) and data queries

tests/e2e/form-validation.spec.ts → tests/e2e/auth/form-validation.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 
 /**
  * Form-validation gate (@validation). Exercises the client-side validation

tests/e2e/login-focus.spec.ts → tests/e2e/auth/passwordless-focus.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { getBaseURL } from '../lib/auth';
+import { getBaseURL } from '../../lib/auth';
 
 /**
  * Passwordless sign-in focus order (@loginfocus). When the user switches to the

tests/e2e/signup-fit.spec.ts → tests/e2e/auth/responsive-layout.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { getBaseURL } from '../lib/auth';
+import { getBaseURL } from '../../lib/auth';
 
 /**
  * Responsive "fit the window" religion (@signup-fit): on a large screen the

tests/e2e/camera.spec.ts → tests/e2e/graph/camera.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 
 /**
  * Camera framing + persistence (@camera).

tests/e2e/living-graph.spec.ts → tests/e2e/graph/living-graph-effects.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * The living graph is the product's differentiator (breathing, glow, energy

tests/e2e/copy-id.spec.ts → tests/e2e/graph/node-inspector-copyid.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 
 /**
  * Click-to-copy node id (@copyid, #23): the node inspector shows a short id chip;

tests/e2e/node-quick-edit.spec.ts → tests/e2e/graph/node-quick-edit.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 
 /**
  * In-context node quick-edit (@quickedit, #87): double-clicking a node opens a

tests/e2e/relationship-flip.spec.ts → tests/e2e/graph/relationship-flip.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, navigateToWorkspace } from '../lib/auth';
+import { login, TEST_USERS, navigateToWorkspace } from '../../lib/auth';
 
 test.describe('Relationship Flip Functionality', () => {
   test.beforeEach(async ({ page }) => {

tests/e2e/mobile-audit.spec.ts → tests/e2e/mobile/accessibility-audit.spec.ts

@@ -1,6 +1,6 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
-import { auditLayout, auditContrast } from '../lib/mobileAudit';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
+import { auditLayout, auditContrast } from '../../lib/mobileAudit';
 
 /**
  * Automated mobile sweep — runs the layout + contrast auditors against EVERY

tests/e2e/mobile-dialogs.spec.ts → tests/e2e/mobile/dialog-positioning.spec.ts

@@ -1,6 +1,6 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
-import { auditDialog } from '../lib/mobileAudit';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
+import { auditDialog } from '../../lib/mobileAudit';
 
 /**
  * Automated dialog sweep — opens the modals a phone user actually hits and

tests/e2e/mobile-experience.spec.ts → tests/e2e/mobile/experience.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * Mobile experience contract. A phone-sized screen should land on a readable

tests/e2e/mobile-views.spec.ts → tests/e2e/mobile/view-navigation.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * Mobile usability of the non-graph views. On a phone a user should be able to

tests/e2e/feature-matrix.spec.ts → tests/e2e/reports/feature-matrix.spec.ts

@@ -1,8 +1,8 @@
 import { test, expect, Page, TestInfo } from '@playwright/test';
 import * as fs from 'fs';
 import * as path from 'path';
-import { getBaseURL } from '../lib/auth';
-import { auditLayout, auditContrast } from '../lib/mobileAudit';
+import { getBaseURL } from '../../lib/auth';
+import { auditLayout, auditContrast } from '../../lib/mobileAudit';
 
 const SHOT_ROOT = path.resolve(process.cwd(), 'test-artifacts/matrix');
 

tests/e2e/matrix.setup.ts → tests/e2e/reports/matrix.setup.ts

@@ -1,5 +1,5 @@
 import { test as setup } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 // One real login for the whole matrix run; every feature-matrix test reuses this
 // storage state so the ~100-cell resolution×feature sweep doesn't re-login each

tests/e2e/showcase.spec.ts → tests/e2e/reports/showcase.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 import * as fs from 'fs';
 import * as path from 'path';
 

tests/e2e/visual-vlm.spec.ts → tests/e2e/reports/vlm-evaluation.spec.ts

@@ -1,11 +1,11 @@
 import { test, expect, Page } from '@playwright/test';
 import * as fs from 'fs';
 import * as path from 'path';
-import { login, TEST_USERS } from '../lib/auth';
-import { seedLargeGraph, deleteGraphDeep } from '../lib/seedGraph';
-import { sweepTestData, TEST_GRAPH_PREFIX } from '../lib/dbHealing';
-import '../lib/testEnv';
-import { isVlmAvailable, evaluateBatch, PERSONAS, personaByKey } from '../lib/vlm';
+import { login, TEST_USERS } from '../../lib/auth';
+import { seedLargeGraph, deleteGraphDeep } from '../../lib/seedGraph';
+import { sweepTestData, TEST_GRAPH_PREFIX } from '../../lib/dbHealing';
+import '../../lib/testEnv';
+import { isVlmAvailable, evaluateBatch, PERSONAS, personaByKey } from '../../lib/vlm';
 
 /**
  * Local-VLM visual evaluation. Captures key user-facing states, then asks a

tests/e2e/responsive.spec.ts → tests/e2e/responsive/viewports.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 // RESP-5 (docs/USER_STORIES.md): the core flow must work on phone, tablet and
 // desktop viewports, with no horizontal scroll and visible primary navigation.

tests/e2e/basic-workflow.spec.ts → tests/e2e/smoke/basic-workflow.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 test.describe('Basic User Workflow', () => {
   test('should complete full user journey: login → select/create graph → create node → verify node appears without refresh', async ({ page }) => {

tests/e2e/user-smoke.spec.ts → tests/e2e/smoke/user-smoke.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS } from '../lib/auth';
+import { login, TEST_USERS } from '../../lib/auth';
 
 /**
  * THE GATE. This spec sees the app exactly as a user does — if it fails,

tests/e2e/overlay-dismissal.spec.ts → tests/e2e/ui/overlay-dismissal.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
 
 /**
  * Overlay dismissal gate (@dismissal). Verifies the dialog-manager "friction

tests/e2e/z-order.spec.ts → tests/e2e/ui/z-order.spec.ts

@@ -1,7 +1,7 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../lib/auth';
-import { auditOnTop } from '../lib/zorder';
-import { auditDialog } from '../lib/mobileAudit';
+import { login, TEST_USERS, getBaseURL } from '../../lib/auth';
+import { auditOnTop } from '../../lib/zorder';
+import { auditDialog } from '../../lib/mobileAudit';
 
 /**
  * Z-order / stacking gate. Opens every floating overlay in the app (dropdowns,

tests/sequences/unified.config.mjs

@@ -14,9 +14,9 @@ const PW = 'GraphDone-Core/dev-neo4j/chromium';
 
 export const SEQUENCES = {
   'unit-web': { adapter: 'vitest', title: 'Web unit tests', cwd: 'packages/web', blocking: true },
-  'smoke': { adapter: 'playwright', title: 'Smoke gate (THE GATE)', args: ['tests/e2e/user-smoke.spec.ts', `--project=${PW}`], blocking: true },
-  'e2e-auth': { adapter: 'playwright', title: 'Auth e2e — passwordless focus', args: ['tests/e2e/login-focus.spec.ts', `--project=${PW}`], blocking: true },
-  'e2e-graph': { adapter: 'playwright', title: 'Graph e2e — camera', args: ['tests/e2e/camera.spec.ts', `--project=${PW}`], blocking: true },
+  'smoke': { adapter: 'playwright', title: 'Smoke gate (THE GATE)', args: ['tests/e2e/smoke/user-smoke.spec.ts', `--project=${PW}`], blocking: true },
+  'e2e-auth': { adapter: 'playwright', title: 'Auth e2e — passwordless focus', args: ['tests/e2e/auth/passwordless-focus.spec.ts', `--project=${PW}`], blocking: true },
+  'e2e-graph': { adapter: 'playwright', title: 'Graph e2e — camera', args: ['tests/e2e/graph/camera.spec.ts', `--project=${PW}`], blocking: true },
   'mobile': { adapter: 'playwright', title: 'Mobile audit', args: ['--grep', '@mobile|@audit', `--project=${PW}`], blocking: false },
   'showcase': { adapter: 'playwright', title: 'Showcase — video + screenshots', args: ['--project=showcase'], blocking: false },
 };