search and ai stabilization work, localization stablized.

src/Web/StellaOps.Web/playwright.e2e.config.ts

@@ -1,28 +1,52 @@
 import { defineConfig, devices } from '@playwright/test';
 
 /**
- * Playwright config targeting the Docker compose stack.
+ * Playwright config for running E2E tests against the Docker compose stack.
+ * The stack must be running before executing these tests.
+ *
  * Usage: npx playwright test --config playwright.e2e.config.ts
  */
 export default defineConfig({
-  testDir: 'e2e',
+  testDir: './e2e',
   timeout: 60_000,
   expect: { timeout: 10_000 },
-  fullyParallel: true,
-  forbidOnly: !!process.env.CI,
-  retries: process.env.CI ? 2 : 0,
-  workers: process.env.CI ? 1 : undefined,
-  reporter: [
-    ['html', { open: 'never' }],
-    ['json', { outputFile: 'e2e-results.json' }],
-  ],
-  use: {
-    baseURL: process.env.PLAYWRIGHT_BASE_URL ?? 'https://stella-ops.local',
-    ignoreHTTPSErrors: true,
-    trace: 'retain-on-failure',
-    screenshot: 'only-on-failure',
-    video: 'retain-on-failure',
-  },
+  fullyParallel: false,
+  retries: 1,
+  workers: 1,
+  reporter: [['list'], ['html', { open: 'never' }]],
+
+  // Default targets Docker stack, but allow local source-served runs for debugging/unblock.
+  // Example:
+  //   PLAYWRIGHT_LOCAL_SOURCE=1 PLAYWRIGHT_BASE_URL=https://127.0.0.1:4400
+  //   npx playwright test --config playwright.e2e.config.ts ...
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  ...(function (): any {
+    const baseURL = process.env.PLAYWRIGHT_BASE_URL ?? 'https://127.1.0.1';
+    const localSource = process.env.PLAYWRIGHT_LOCAL_SOURCE === '1';
+    return {
+      ...(localSource
+        ? {
+            webServer: {
+              command: 'npm run serve:test',
+              reuseExistingServer: !process.env.CI,
+              url: baseURL,
+              ignoreHTTPSErrors: true,
+              timeout: 120_000,
+              stdout: 'ignore',
+              stderr: 'ignore',
+            },
+          }
+        : {}),
+      use: {
+        baseURL,
+        ignoreHTTPSErrors: true,
+        trace: 'on-first-retry',
+        screenshot: 'only-on-failure',
+        video: 'retain-on-failure',
+      },
+    };
+  })(),
+
   projects: [
     {
       name: 'setup',