TEST-UNIFY-2: helpers → tests/lib + import codemod (gate green, 0 collection errors)

tests/diagnostics/core-interactions.spec.ts

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

tests/diagnostics/explorer-tree.spec.ts

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

tests/diagnostics/graph-balance.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../helpers/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';
@@ -9,7 +9,7 @@ import * as path from 'node:path';
  *
  * Clips a screenshot to the graph canvas (`.graph-container`, which excludes the
  * nav rail, top bar, and the body-portaled minimap), then runs
- * tests/helpers/balance_metrics.py to compute OBJECTIVE numbers about how the
+ * tests/lib/metrics/balance_metrics.py to compute OBJECTIVE numbers about how the
  * graph is placed: centroid offset from centre, bbox coverage, content usage,
  * margin balance, quadrant mass distribution, and an informational balanceScore.
  *
@@ -27,7 +27,7 @@ import * as path from 'node:path';
 const MAX_OFF_MAG = 0.30; // centroid offset from frame centre (0 = dead centre)
 const MIN_BBOX_COVERAGE = 0.35; // graph bbox vs canvas (off-screen graph ~= 0.06)
 
-const PY = path.join(process.cwd(), 'tests/helpers/balance_metrics.py');
+const PY = path.join(process.cwd(), 'tests/lib/metrics/balance_metrics.py');
 const OUT = path.join(process.cwd(), 'test-artifacts/balance');
 mkdirSync(OUT, { recursive: true });
 

tests/diagnostics/graph-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 '../helpers/auth';
-import { sweepTestData, TEST_GRAPH_PREFIX } from '../helpers/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/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 '../helpers/auth';
+import { login, TEST_USERS } from '../lib/auth';
 
 /**
  * Altium-style "graphs of graphs" navigation: from the System Overview, a

tests/diagnostics/insecure-connection-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 '../helpers/auth';
+import { login, TEST_USERS } from '../lib/auth';
 
 /**
  * The insecure-connection (HTTP) warning must integrate cleanly: a slim strip

tests/diagnostics/interaction-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 '../helpers/auth';
-import { sweepTestData, TEST_GRAPH_PREFIX } from '../helpers/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/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 '../helpers/auth';
+import { login, TEST_USERS } from '../lib/auth';
 
 /**
  * BASELINE profiler for the Compute Core (1000-node) example graph the user

tests/diagnostics/minimap-zoom.spec.ts

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

tests/diagnostics/node-expand-legibility.spec.ts

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

tests/diagnostics/node-inspector.spec.ts

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

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 '../helpers/auth';
+import { login, TEST_USERS } from '../lib/auth';
 
 /**
  * Physics-lifecycle diagnostic — proves the one-shot model: a graph settles,

tests/e2e/a11y-focus.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../helpers/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

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

tests/e2e/api-health.spec.ts

@@ -1,9 +1,9 @@
 import { test, expect } from '@playwright/test';
-import { HEALTH_URL, gqlRequest, apiLogin } from '../helpers/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
-// authenticate the same way the UI does. See tests/helpers/api.ts.
+// authenticate the same way the UI does. See tests/lib/api.ts.
 test.describe('GraphQL API Health Tests', () => {
   let token: string;
 

tests/e2e/basic-workflow.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS } from '../helpers/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/camera.spec.ts

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

tests/e2e/copy-id.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../helpers/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/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 '../helpers/auth';
-import { auditLayout, auditContrast } from '../helpers/mobileAudit';
+import { getBaseURL } from '../lib/auth';
+import { auditLayout, auditContrast } from '../lib/mobileAudit';
 
 const SHOT_ROOT = path.resolve(process.cwd(), 'test-artifacts/matrix');
 

tests/e2e/form-validation.spec.ts

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

tests/e2e/living-graph.spec.ts

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

tests/e2e/login-focus.spec.ts

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

tests/e2e/matrix.setup.ts

@@ -1,5 +1,5 @@
 import { test as setup } from '@playwright/test';
-import { login, TEST_USERS } from '../helpers/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/mobile-audit.spec.ts

@@ -1,6 +1,6 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../helpers/auth';
-import { auditLayout, auditContrast } from '../helpers/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

@@ -1,6 +1,6 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../helpers/auth';
-import { auditDialog } from '../helpers/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

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS } from '../helpers/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

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../helpers/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/node-quick-edit.spec.ts

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

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

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

tests/e2e/overlay-dismissal.spec.ts

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

tests/e2e/relationship-flip.spec.ts

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

tests/e2e/responsive.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../helpers/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/showcase.spec.ts

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

tests/e2e/signup-fit.spec.ts

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

tests/e2e/user-smoke.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect } from '@playwright/test';
-import { login, TEST_USERS } from '../helpers/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/visual-vlm.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 '../helpers/auth';
-import { seedLargeGraph, deleteGraphDeep } from '../helpers/seedGraph';
-import { sweepTestData, TEST_GRAPH_PREFIX } from '../helpers/dbHealing';
-import '../helpers/testEnv';
-import { isVlmAvailable, evaluateBatch, PERSONAS, personaByKey } from '../helpers/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/z-order.spec.ts

@@ -1,7 +1,7 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS, getBaseURL } from '../helpers/auth';
-import { auditOnTop } from '../helpers/zorder';
-import { auditDialog } from '../helpers/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/helpers/testEnv.ts → tests/lib/testEnv.ts

@@ -8,7 +8,7 @@ import dotenv from 'dotenv';
  * this for its side effect at the top of any spec/generator that needs the VLM
  * endpoints or sweep config:
  *
- *   import '../helpers/testEnv';
+ *   import '../lib/testEnv';
  *
  * Safe to import everywhere — it's a no-op when the file is absent (e.g. CI),
  * so VLM-driven suites skip cleanly. Existing process.env values win, so you

tests/perf/graph-perf.spec.ts

@@ -1,5 +1,5 @@
 import { test, expect, Page } from '@playwright/test';
-import { login, TEST_USERS } from '../helpers/auth';
+import { login, TEST_USERS } from '../lib/auth';
 
 /**
  * Runtime performance budgets (ADAPT-8). Numbers come from the in-app

tests/perf/scale-sweep.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 '../helpers/auth';
-import { seedLargeGraph, deleteGraphDeep } from '../helpers/seedGraph';
-import { sweepTestData } from '../helpers/dbHealing';
-import '../helpers/testEnv';
-import { envIntList, envList } from '../helpers/testEnv';
+import { login, TEST_USERS } from '../lib/auth';
+import { seedLargeGraph, deleteGraphDeep } from '../lib/seedGraph';
+import { sweepTestData } from '../lib/dbHealing';
+import '../lib/testEnv';
+import { envIntList, envList } from '../lib/testEnv';
 
 /**
  * Large-scale graph creation + performance metric sweep. Seeds real graphs of