From 33d238d70f0fa86d8cdd6f9ca8215ecbf487fb87 Mon Sep 17 00:00:00 2001
From: Matthew Valancy <matthew.valancy@gmail.com>
Date: Thu, 18 Jun 2026 11:31:40 -0700
Subject: [PATCH] TEST-UNIFY-0: unified dual-output test harness from reusable
 libs (Phase 0, non-destructive)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

One reproducible entry (npm run test:unified) runs a declarative profile of
sequences and emits BOTH a human-readable report.html (per-sequence pass/warn/fail
with embedded <img> screenshots + <video> .webm clips) AND a machine-parsable
report.json (schema graphdone.unified-report/1) + per-sequence JSON.

Reusable lib (tests/lib/):
- reporting/aggregate.mjs — pure rollup (rollupStatus/statusFromCounts/sumCounts/
  buildReport), node:test 10/10
- reporting/json.mjs, reporting/html.mjs — dual reporters (html embeds images+video)
- runner/runSequence.mjs — argv-array spawn, captures exit/stdout/duration
- adapters/playwright.mjs — parse PW JSON + harvest video/screenshot attachments
- adapters/vitest.mjs — parse vitest JSON into case counts
- sequences/unified.config.mjs — declarative sequences + profiles (smoke|pr|full|report)
- run-unified.mjs — entry; copies artifacts into assets/, writes both reports,
  exit code = rollup status (doubles as a gate)

Phase 0 is additive only — no specs moved/deleted; THE GATE unchanged. Verified:
smoke profile 212✓ (web unit 205 + gate 5 + auth e2e 2); showcase sequence harvests
5 .webm + 5 screenshots and embeds them (5 <video> + 5 <img>). Plan for phases 1-6
(clean-tree reorg) saved at docs/test-tree-refactor-plan.json.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/test-tree-refactor-plan.json      | 592 +++++++++++++++++++++++++
 package.json                           |   4 +
 tests/lib/adapters/playwright.mjs      |  57 +++
 tests/lib/adapters/vitest.mjs          |  34 ++
 tests/lib/reporting/aggregate.mjs      |  58 +++
 tests/lib/reporting/aggregate.test.mjs |  56 +++
 tests/lib/reporting/html.mjs           | 105 +++++
 tests/lib/reporting/json.mjs           |  20 +
 tests/lib/runner/runSequence.mjs       |  27 ++
 tests/run-unified.mjs                  |  95 ++++
 tests/sequences/unified.config.mjs     |  29 ++
 11 files changed, 1077 insertions(+)
 create mode 100644 docs/test-tree-refactor-plan.json
 create mode 100644 tests/lib/adapters/playwright.mjs
 create mode 100644 tests/lib/adapters/vitest.mjs
 create mode 100644 tests/lib/reporting/aggregate.mjs
 create mode 100644 tests/lib/reporting/aggregate.test.mjs
 create mode 100644 tests/lib/reporting/html.mjs
 create mode 100644 tests/lib/reporting/json.mjs
 create mode 100644 tests/lib/runner/runSequence.mjs
 create mode 100644 tests/run-unified.mjs
 create mode 100644 tests/sequences/unified.config.mjs

diff --git a/docs/test-tree-refactor-plan.json b/docs/test-tree-refactor-plan.json
new file mode 100644
index 00000000..b843ac3a
--- /dev/null
+++ b/docs/test-tree-refactor-plan.json
@@ -0,0 +1,592 @@
+{
+  "summary": "Inventory the sprawling test surface (both repos) and synthesize a clean target tree + migration plan + unified dual-output harness design",
+  "agentCount": 7,
+  "logs": [],
+  "result": {
+    "targetTree": "CANONICAL CONFIG STAYS AT REPO ROOT: /playwright.config.ts (the one config; tests/playwright.config.ts + tests/playwright.config.production.ts deleted). Playwright auto-discovers it from cwd; its projects point testDir at the folders below.\n\ntests/\n├── run-unified.mjs                      # SINGLE entry → npm run test:unified (report.html + report.json)\n├── sequences/\n│   └── unified.config.mjs               # declarative manifest of sequences + profiles (smoke|pr|full|report)\n├── e2e/                                 # default PW project testDir; grouped by domain\n│   ├── smoke/\n│   │   └── user-smoke.spec.ts           # THE GATE (@smoke) — kept runnable\n│   ├── auth/\n│   │   ├── form-validation.spec.ts\n│   │   ├── responsive-layout.spec.ts        (was signup-fit)\n│   │   └── passwordless-focus.spec.ts       (was login-focus)\n│   ├── graph/\n│   │   ├── camera.spec.ts\n│   │   ├── living-graph-effects.spec.ts     (was living-graph)\n│   │   ├── relationship-flip.spec.ts\n│   │   ├── node-quick-edit.spec.ts\n│   │   └── node-inspector-copyid.spec.ts    (was copy-id)\n│   ├── ui/\n│   │   ├── overlay-dismissal.spec.ts\n│   │   └── z-order.spec.ts\n│   ├── a11y/\n│   │   └── modal-focus.spec.ts              (was a11y-focus)\n│   ├── mobile/\n│   │   ├── experience.spec.ts\n│   │   ├── view-navigation.spec.ts          (was mobile-views)\n│   │   ├── accessibility-audit.spec.ts      (was mobile-audit)\n│   │   ├── dialog-positioning.spec.ts       (was mobile-dialogs)\n│   │   └── tls-compat.spec.ts               (ported from mobile-https-compatibility-test.js)\n│   ├── responsive/\n│   │   └── viewports.spec.ts                (was responsive)\n│   ├── api/\n│   │   └── health.spec.ts                   (was api-health)\n│   ├── admin/\n│   │   ├── database-tab.spec.ts             (was admin-database-tab)\n│   │   └── oauth-provider-config.spec.ts\n│   └── reports/                             # capture-heavy, own PW projects, report-only\n│       ├── showcase.spec.ts                 # records .webm + screenshots (video source)\n│       ├── feature-matrix.spec.ts\n│       ├── matrix.setup.ts\n│       ├── visual-regression.spec.ts        (was visual-regression-suite)\n│       └── vlm-evaluation.spec.ts           (was visual-vlm)\n├── perf/                                    # perf + perf-scale PW projects\n│   ├── graph-perf.spec.ts                   # budget gate (@perf)\n│   ├── scale-sweep.spec.ts\n│   └── check-bundle-size.mjs\n├── diagnostics/                             # geometry PW project (recursive testDir)\n│   ├── layout/\n│   │   ├── geometry.spec.ts                 (was graph-geometry)\n│   │   └── graph-balance.spec.ts\n│   ├── interactions/\n│   │   ├── core-matrix.spec.ts             (was core-interactions)\n│   │   └── relationship-audit.spec.ts      (was interaction-audit)\n│   ├── hierarchy/\n│   │   ├── explorer-tree.spec.ts\n│   │   └── navigation.spec.ts              (was hierarchy-navigation)\n│   ├── inspector/\n│   │   └── node-inspector.spec.ts\n│   ├── physics/\n│   │   └── settle.spec.ts                  (was physics-settle)\n│   ├── perf/\n│   │   └── large-graph-profile.spec.ts\n│   └── ui/\n│       ├── legibility-floor.spec.ts        (was node-expand-legibility)\n│       ├── minimap-zoom.spec.ts\n│       ├── captcha-layout.spec.ts\n│       └── tls-banner.spec.ts              (was insecure-connection-banner)\n├── integration/                            # non-app infra specs (excluded from default project)\n│   ├── tls-integration.spec.ts\n│   ├── tls-certificate-cross-browser.spec.ts  (ported from ssl-certificate-analysis.js)\n│   └── installation-validation.spec.ts\n├── fixtures/\n│   └── oauth-profiles.ts\n└── lib/                                    # REUSABLE harness + helpers (shared by Core AND Cloud)\n    ├── README.md\n    ├── auth.ts            (from helpers/)   # most-imported helper — battle-tested login\n    ├── api.ts             (from helpers/)\n    ├── seedGraph.ts       (from helpers/)\n    ├── dbHealing.ts       (from helpers/)\n    ├── testEnv.ts         (from helpers/)\n    ├── mobileAudit.ts     (from helpers/)\n    ├── zorder.ts          (from helpers/)\n    ├── vlm.ts             (from helpers/)\n    ├── mock-oauth-server.ts (from helpers/)\n    ├── metrics/\n    │   └── balance_metrics.py (from helpers/)  # subprocess; Cloud audit-kit BALANCE_PY cross-links here\n    ├── audit/                              # promoted from GraphDone-Cloud/scripts/lib (Cloud cross-links back)\n    │   ├── audit-kit.mjs\n    │   ├── schema-contract.mjs\n    │   └── schema-coverage.mjs\n    ├── reporting/\n    │   ├── aggregate.mjs   (from tests/_draft_unified/aggregate.mjs)  # pure rollup\n    │   ├── html.mjs        # unified HTML report: <img> screenshots + <video> .webm; absorbs Cloud report.mjs renderer\n    │   └── json.mjs        # report.json (schema graphdone.unified-report/1)\n    ├── adapters/                           # parse external result formats → sequence objects\n    │   ├── playwright.mjs  # PW JSON reporter + collect playwright-output/*.webm + *.png\n    │   ├── vitest.mjs      # vitest JSON\n    │   ├── perf.mjs        # folds generate-perf-report.mjs (scale-sweep + graph-perf metrics)\n    │   ├── vlm.mjs         # folds generate-vlm-report.mjs\n    │   ├── matrix.mjs      # folds generate-matrix-report.mjs\n    │   ├── showcase.mjs    # folds generate-showcase-report.mjs\n    │   └── cloud-audit.mjs # optional ingest of GraphDone-Cloud live-audit findings.json\n    └── runner/\n        └── runSequence.mjs # spawn a step, capture exit/stdout, resolve its JSON + artifact dir\n\nscripts/   (Core repo, non-tests)\n├── verify-camera-fix.mjs       (promoted from GraphDone-Cloud) → npm run verify:prod-build\n├── generate-audit-report.mjs   (promoted from GraphDone-Cloud) → npm run audit:report\n├── fresh-test.sh  github-actions-test.sh  test-installation-simple.sh  test-tls.sh  generate-clean-report.sh  generate-dev-certs.sh   (KEPT)\n\nCLOUD CROSS-LINKS (GraphDone-Cloud, which carries Core as the core/ submodule):\n  scripts/live-audit.mjs, scripts/verify-live.mjs  import from  core/tests/lib/audit/* and core/tests/lib/reporting/*\n  (audit-kit/schema-contract/schema-coverage/report renderer now live ONLY in Core; Cloud consumes via submodule).\n\nOutputs land in test-artifacts/unified/ (report.html, report.json, sequences/*.json) — see unifiedHarness.",
+    "migrations": [
+      {
+        "from": "tests/e2e/user-smoke.spec.ts",
+        "to": "tests/e2e/smoke/user-smoke.spec.ts",
+        "reason": "THE GATE; group under smoke/. test:smoke + CI must repoint to new path."
+      },
+      {
+        "from": "tests/e2e/basic-workflow.spec.ts",
+        "to": "MERGE->tests/e2e/smoke/user-smoke.spec.ts",
+        "reason": "Login→create graph→node-appears duplicates user-smoke grow flow; absorb any unique assertion then delete source."
+      },
+      {
+        "from": "tests/e2e/camera.spec.ts",
+        "to": "tests/e2e/graph/camera.spec.ts",
+        "reason": "Domain grouping (graph)."
+      },
+      {
+        "from": "tests/e2e/living-graph.spec.ts",
+        "to": "tests/e2e/graph/living-graph-effects.spec.ts",
+        "reason": "Domain grouping; CI line 192 references this path directly and must update."
+      },
+      {
+        "from": "tests/e2e/relationship-flip.spec.ts",
+        "to": "tests/e2e/graph/relationship-flip.spec.ts",
+        "reason": "Domain grouping (graph)."
+      },
+      {
+        "from": "tests/e2e/node-quick-edit.spec.ts",
+        "to": "tests/e2e/graph/node-quick-edit.spec.ts",
+        "reason": "Domain grouping (graph)."
+      },
+      {
+        "from": "tests/e2e/copy-id.spec.ts",
+        "to": "tests/e2e/graph/node-inspector-copyid.spec.ts",
+        "reason": "Domain grouping + descriptive name."
+      },
+      {
+        "from": "tests/e2e/form-validation.spec.ts",
+        "to": "tests/e2e/auth/form-validation.spec.ts",
+        "reason": "Domain grouping (auth)."
+      },
+      {
+        "from": "tests/e2e/signup-fit.spec.ts",
+        "to": "tests/e2e/auth/responsive-layout.spec.ts",
+        "reason": "Domain grouping + clearer name."
+      },
+      {
+        "from": "tests/e2e/login-focus.spec.ts",
+        "to": "tests/e2e/auth/passwordless-focus.spec.ts",
+        "reason": "Domain grouping + clearer name."
+      },
+      {
+        "from": "tests/e2e/a11y-focus.spec.ts",
+        "to": "tests/e2e/a11y/modal-focus.spec.ts",
+        "reason": "Domain grouping (a11y)."
+      },
+      {
+        "from": "tests/e2e/overlay-dismissal.spec.ts",
+        "to": "tests/e2e/ui/overlay-dismissal.spec.ts",
+        "reason": "Domain grouping (ui)."
+      },
+      {
+        "from": "tests/e2e/z-order.spec.ts",
+        "to": "tests/e2e/ui/z-order.spec.ts",
+        "reason": "Domain grouping (ui)."
+      },
+      {
+        "from": "tests/e2e/responsive.spec.ts",
+        "to": "tests/e2e/responsive/viewports.spec.ts",
+        "reason": "Domain grouping; @core tag preserved."
+      },
+      {
+        "from": "tests/e2e/api-health.spec.ts",
+        "to": "tests/e2e/api/health.spec.ts",
+        "reason": "Domain grouping; @core. Keeps importing lib/api.ts."
+      },
+      {
+        "from": "tests/e2e/mobile-experience.spec.ts",
+        "to": "tests/e2e/mobile/experience.spec.ts",
+        "reason": "Domain grouping (mobile)."
+      },
+      {
+        "from": "tests/e2e/mobile-views.spec.ts",
+        "to": "tests/e2e/mobile/view-navigation.spec.ts",
+        "reason": "Domain grouping (mobile)."
+      },
+      {
+        "from": "tests/e2e/mobile-audit.spec.ts",
+        "to": "tests/e2e/mobile/accessibility-audit.spec.ts",
+        "reason": "Domain grouping; @audit tag preserved."
+      },
+      {
+        "from": "tests/e2e/mobile-dialogs.spec.ts",
+        "to": "tests/e2e/mobile/dialog-positioning.spec.ts",
+        "reason": "Domain grouping; @audit tag preserved."
+      },
+      {
+        "from": "tests/e2e/admin-database-tab.spec.ts",
+        "to": "tests/e2e/admin/database-tab.spec.ts",
+        "reason": "Group stale-but-kept admin specs together."
+      },
+      {
+        "from": "tests/e2e/oauth-provider-config.spec.ts",
+        "to": "tests/e2e/admin/oauth-provider-config.spec.ts",
+        "reason": "Admin grouping; sole remaining consumer of mock-oauth-server.ts + oauth fixtures."
+      },
+      {
+        "from": "tests/e2e/showcase.spec.ts",
+        "to": "tests/e2e/reports/showcase.spec.ts",
+        "reason": "Report-only capture spec; PW showcase project testMatch by filename still resolves."
+      },
+      {
+        "from": "tests/e2e/feature-matrix.spec.ts",
+        "to": "tests/e2e/reports/feature-matrix.spec.ts",
+        "reason": "Report-only; matrix project testMatch by filename still resolves."
+      },
+      {
+        "from": "tests/e2e/matrix.setup.ts",
+        "to": "tests/e2e/reports/matrix.setup.ts",
+        "reason": "Co-locate with matrix spec; matrix-setup project testMatch by filename still resolves."
+      },
+      {
+        "from": "tests/e2e/visual-regression-suite.spec.ts",
+        "to": "tests/e2e/reports/visual-regression.spec.ts",
+        "reason": "Report-only; test:e2e:visual npm script path must update."
+      },
+      {
+        "from": "tests/e2e/visual-vlm.spec.ts",
+        "to": "tests/e2e/reports/vlm-evaluation.spec.ts",
+        "reason": "Report-only RENAME; vlm project testMatch + default project testIgnore must update to new filename."
+      },
+      {
+        "from": "tests/e2e/installation-validation.spec.ts",
+        "to": "tests/integration/installation-validation.spec.ts",
+        "reason": "CI/infra test, not app E2E; exclude from default project."
+      },
+      {
+        "from": "tests/e2e/tls-integration.spec.ts",
+        "to": "tests/integration/tls-integration.spec.ts",
+        "reason": "Infra test; exclude from default project."
+      },
+      {
+        "from": "tests/ssl-certificate-analysis.js",
+        "to": "tests/integration/tls-certificate-cross-browser.spec.ts",
+        "reason": "Port loose JS to a real PW spec; folds test:https TLS coverage into the suite."
+      },
+      {
+        "from": "tests/mobile-https-compatibility-test.js",
+        "to": "tests/e2e/mobile/tls-compat.spec.ts",
+        "reason": "Port loose JS to a real PW spec with @mobile tag."
+      },
+      {
+        "from": "tests/diagnostics/graph-geometry.spec.ts",
+        "to": "tests/diagnostics/layout/geometry.spec.ts",
+        "reason": "Diagnostics sub-grouping (layout)."
+      },
+      {
+        "from": "tests/diagnostics/graph-balance.spec.ts",
+        "to": "tests/diagnostics/layout/graph-balance.spec.ts",
+        "reason": "Diagnostics sub-grouping (layout); subprocess path to balance_metrics.py must update."
+      },
+      {
+        "from": "tests/diagnostics/core-interactions.spec.ts",
+        "to": "tests/diagnostics/interactions/core-matrix.spec.ts",
+        "reason": "Diagnostics sub-grouping (interactions)."
+      },
+      {
+        "from": "tests/diagnostics/interaction-audit.spec.ts",
+        "to": "tests/diagnostics/interactions/relationship-audit.spec.ts",
+        "reason": "Diagnostics sub-grouping (interactions)."
+      },
+      {
+        "from": "tests/diagnostics/explorer-tree.spec.ts",
+        "to": "tests/diagnostics/hierarchy/explorer-tree.spec.ts",
+        "reason": "Diagnostics sub-grouping (hierarchy)."
+      },
+      {
+        "from": "tests/diagnostics/hierarchy-navigation.spec.ts",
+        "to": "tests/diagnostics/hierarchy/navigation.spec.ts",
+        "reason": "Diagnostics sub-grouping (hierarchy)."
+      },
+      {
+        "from": "tests/diagnostics/node-inspector.spec.ts",
+        "to": "tests/diagnostics/inspector/node-inspector.spec.ts",
+        "reason": "Diagnostics sub-grouping (inspector)."
+      },
+      {
+        "from": "tests/diagnostics/physics-settle.spec.ts",
+        "to": "tests/diagnostics/physics/settle.spec.ts",
+        "reason": "Diagnostics sub-grouping (physics)."
+      },
+      {
+        "from": "tests/diagnostics/large-graph-profile.spec.ts",
+        "to": "tests/diagnostics/perf/large-graph-profile.spec.ts",
+        "reason": "Diagnostics sub-grouping (perf profiling); balance_metrics.py path may need update."
+      },
+      {
+        "from": "tests/diagnostics/node-expand-legibility.spec.ts",
+        "to": "tests/diagnostics/ui/legibility-floor.spec.ts",
+        "reason": "Diagnostics sub-grouping (ui)."
+      },
+      {
+        "from": "tests/diagnostics/minimap-zoom.spec.ts",
+        "to": "tests/diagnostics/ui/minimap-zoom.spec.ts",
+        "reason": "Diagnostics sub-grouping (ui)."
+      },
+      {
+        "from": "tests/diagnostics/captcha-layout.spec.ts",
+        "to": "tests/diagnostics/ui/captcha-layout.spec.ts",
+        "reason": "Diagnostics sub-grouping (ui)."
+      },
+      {
+        "from": "tests/diagnostics/insecure-connection-banner.spec.ts",
+        "to": "tests/diagnostics/ui/tls-banner.spec.ts",
+        "reason": "Diagnostics sub-grouping (ui) + clearer name."
+      },
+      {
+        "from": "tests/helpers/auth.ts",
+        "to": "tests/lib/auth.ts",
+        "reason": "Consolidate helpers into reusable lib/; ALL ~51 specs import this — codemod required."
+      },
+      {
+        "from": "tests/helpers/api.ts",
+        "to": "tests/lib/api.ts",
+        "reason": "Reusable lib; kept (api-health still uses it after database-connectivity deletion)."
+      },
+      {
+        "from": "tests/helpers/seedGraph.ts",
+        "to": "tests/lib/seedGraph.ts",
+        "reason": "Reusable graph-seeding lib for harness."
+      },
+      {
+        "from": "tests/helpers/dbHealing.ts",
+        "to": "tests/lib/dbHealing.ts",
+        "reason": "Reusable DB-isolation lib for heavy sequences."
+      },
+      {
+        "from": "tests/helpers/testEnv.ts",
+        "to": "tests/lib/testEnv.ts",
+        "reason": "Reusable config loader (.env.test.local)."
+      },
+      {
+        "from": "tests/helpers/mobileAudit.ts",
+        "to": "tests/lib/mobileAudit.ts",
+        "reason": "Reusable auditor module."
+      },
+      {
+        "from": "tests/helpers/zorder.ts",
+        "to": "tests/lib/zorder.ts",
+        "reason": "Reusable auditor module."
+      },
+      {
+        "from": "tests/helpers/vlm.ts",
+        "to": "tests/lib/vlm.ts",
+        "reason": "Reusable VLM client for visual-evaluation sequence."
+      },
+      {
+        "from": "tests/helpers/mock-oauth-server.ts",
+        "to": "tests/lib/mock-oauth-server.ts",
+        "reason": "Reusable OAuth mock; retained for admin/oauth-provider-config."
+      },
+      {
+        "from": "tests/helpers/README.md",
+        "to": "tests/lib/README.md",
+        "reason": "Docs move with helpers; rewrite for new lib layout + harness."
+      },
+      {
+        "from": "tests/helpers/balance_metrics.py",
+        "to": "tests/lib/metrics/balance_metrics.py",
+        "reason": "Reusable metrics tool; specs (graph-balance, large-graph-profile) AND Cloud audit-kit BALANCE_PY reference its path."
+      },
+      {
+        "from": "tests/fixtures/oauth-profiles.ts",
+        "to": "tests/fixtures/oauth-profiles.ts",
+        "reason": "Stays; retained for OAuth mock/admin spec."
+      },
+      {
+        "from": "tests/_draft_unified/aggregate.mjs",
+        "to": "tests/lib/reporting/aggregate.mjs",
+        "reason": "Pure rollup is the core of unified reporting; promote from draft. Then remove _draft_unified/."
+      },
+      {
+        "from": "tests/generate-showcase-report.mjs",
+        "to": "MERGE->tests/lib/adapters/showcase.mjs",
+        "reason": "Fold gallery logic (reads playwright-output/*.webm + showcase/*.png) into harness adapter feeding reporting/html.mjs."
+      },
+      {
+        "from": "tests/generate-matrix-report.mjs",
+        "to": "MERGE->tests/lib/adapters/matrix.mjs",
+        "reason": "Fold feature×resolution gallery into harness adapter."
+      },
+      {
+        "from": "tests/generate-perf-report.mjs",
+        "to": "MERGE->tests/lib/adapters/perf.mjs",
+        "reason": "Fold scale-sweep + graph-perf metric rendering into harness adapter."
+      },
+      {
+        "from": "tests/generate-vlm-report.mjs",
+        "to": "MERGE->tests/lib/adapters/vlm.mjs",
+        "reason": "Fold VLM verdict gallery into harness adapter."
+      },
+      {
+        "from": "tests/perf/check-bundle-size.mjs",
+        "to": "tests/perf/check-bundle-size.mjs",
+        "reason": "Stays; perf:bundle script unchanged."
+      },
+      {
+        "from": "tests/playwright.config.production.ts",
+        "to": "MERGE->playwright.config.ts",
+        "reason": "Fold prod timeouts/junit reporter into root config as env-conditional (CI/TEST_URL); then delete. Removes dead globalSetup binding."
+      },
+      {
+        "from": "GraphDone-Cloud/scripts/lib/audit-kit.mjs",
+        "to": "tests/lib/audit/audit-kit.mjs",
+        "reason": "Promote shared audit toolkit into Core; Cloud consumes via core/ submodule (cross-link)."
+      },
+      {
+        "from": "GraphDone-Cloud/scripts/lib/schema-contract.mjs",
+        "to": "tests/lib/audit/schema-contract.mjs",
+        "reason": "Promote generic SPA↔schema contract validator into Core; Core can validate local server too."
+      },
+      {
+        "from": "GraphDone-Cloud/scripts/lib/schema-coverage.mjs",
+        "to": "tests/lib/audit/schema-coverage.mjs",
+        "reason": "Promote generic mutation-discovery/coverage into Core lib/audit; Cloud cross-links."
+      },
+      {
+        "from": "GraphDone-Cloud/scripts/lib/report.mjs",
+        "to": "MERGE->tests/lib/reporting/html.mjs",
+        "reason": "Reuse renderHtml (dark-theme, embedded screenshots) as the unified html.mjs renderer; single report renderer for both repos."
+      },
+      {
+        "from": "GraphDone-Cloud/scripts/verify-camera-fix.mjs",
+        "to": "scripts/verify-camera-fix.mjs",
+        "reason": "Validates Core PROD build + camera framing; belongs in Core as npm run verify:prod-build."
+      },
+      {
+        "from": "GraphDone-Cloud/scripts/generate-audit-report.mjs",
+        "to": "scripts/generate-audit-report.mjs",
+        "reason": "Re-render report from findings.json; promote to Core as npm run audit:report (uses promoted reporting lib)."
+      },
+      {
+        "from": "GraphDone-Cloud/scripts/live-audit.mjs",
+        "to": "GraphDone-Cloud/scripts/live-audit.mjs",
+        "reason": "Stays in Cloud (prod-specific) but re-point imports to core/tests/lib/audit/* and core/tests/lib/reporting/*; harness ingests its findings.json via cloud-audit adapter."
+      },
+      {
+        "from": "GraphDone-Cloud/scripts/verify-live.mjs",
+        "to": "GraphDone-Cloud/scripts/verify-live.mjs",
+        "reason": "Stays in Cloud; re-point imports to promoted core/tests/lib/audit toolkit."
+      }
+    ],
+    "npmScripts": [
+      {
+        "name": "test:smoke",
+        "command": "playwright test tests/e2e/smoke/user-smoke.spec.ts --reporter=line",
+        "note": "THE GATE — path updated to smoke/ folder; behavior identical. CI smoke-gate + prod-smoke keep calling this name."
+      },
+      {
+        "name": "test:unified",
+        "command": "node tests/run-unified.mjs --profile full",
+        "note": "NEW single entry; runs the declarative sequence manifest, emits test-artifacts/unified/report.html (img+video) + report.json."
+      },
+      {
+        "name": "test:unified:smoke",
+        "command": "node tests/run-unified.mjs --profile smoke",
+        "note": "Fast blocking profile (unit + smoke + core e2e + perf budgets); no heavy report sequences."
+      },
+      {
+        "name": "test:comprehensive",
+        "command": "node tests/run-unified.mjs --profile full",
+        "note": "Repointed from deleted run-all-tests.js to the unified harness (kept as alias for ./start test + docs)."
+      },
+      {
+        "name": "test:pr",
+        "command": "node tests/run-unified.mjs --profile pr",
+        "note": "Repointed from deleted run-pr-tests.js; CI prod-smoke advisory step calls this name."
+      },
+      {
+        "name": "test",
+        "command": "turbo run test",
+        "note": "Unchanged — package unit/vitest suites."
+      },
+      {
+        "name": "test:e2e",
+        "command": "playwright test",
+        "note": "Unchanged; uses canonical root config."
+      },
+      {
+        "name": "test:e2e:core",
+        "command": "playwright test --grep=\"@core\"",
+        "note": "Unchanged."
+      },
+      {
+        "name": "test:e2e:visual",
+        "command": "playwright test tests/e2e/reports/visual-regression.spec.ts",
+        "note": "Path updated to reports/ folder."
+      },
+      {
+        "name": "test:mobile",
+        "command": "playwright test --grep \"@mobile|@audit\" --project=\"GraphDone-Core/dev-neo4j/chromium\" --reporter=line",
+        "note": "Unchanged; tag-driven so survives the folder moves."
+      },
+      {
+        "name": "test:perf",
+        "command": "playwright test --project=perf --reporter=line",
+        "note": "Unchanged (budget gate)."
+      },
+      {
+        "name": "test:perf:scale",
+        "command": "playwright test --project=perf-scale --reporter=line && node tests/run-unified.mjs --sequence perf-scale --report-only",
+        "note": "Generator folded into harness perf adapter."
+      },
+      {
+        "name": "test:geometry",
+        "command": "playwright test --project=geometry --reporter=line",
+        "note": "Unchanged; geometry testDir=./tests/diagnostics is recursive."
+      },
+      {
+        "name": "test:vlm",
+        "command": "playwright test --project=vlm --reporter=line && node tests/run-unified.mjs --sequence vlm --report-only",
+        "note": "Generator folded into harness vlm adapter; skips if no VLM endpoint."
+      },
+      {
+        "name": "report:showcase",
+        "command": "playwright test --project=showcase && node tests/run-unified.mjs --sequence showcase --report-only",
+        "note": "Generator folded into harness showcase adapter (video+screenshots)."
+      },
+      {
+        "name": "report:matrix",
+        "command": "playwright test --project=matrix --reporter=line && node tests/run-unified.mjs --sequence matrix --report-only",
+        "note": "Generator folded into harness matrix adapter."
+      },
+      {
+        "name": "test:https",
+        "command": "playwright test tests/integration/tls-certificate-cross-browser.spec.ts tests/e2e/mobile/tls-compat.spec.ts",
+        "note": "Loose JS ported to specs; runs via canonical config instead of standalone node."
+      },
+      {
+        "name": "perf:bundle",
+        "command": "node tests/perf/check-bundle-size.mjs",
+        "note": "Unchanged."
+      },
+      {
+        "name": "verify:prod-build",
+        "command": "node scripts/verify-camera-fix.mjs http://localhost:4500",
+        "note": "Promoted from Cloud; PROD-mode camera-framing check (needs local PROD build on :4500)."
+      },
+      {
+        "name": "audit:report",
+        "command": "node scripts/generate-audit-report.mjs",
+        "note": "Promoted from Cloud; re-render HTML report from a prior findings.json."
+      },
+      {
+        "name": "test:report",
+        "command": "node tests/run-unified.mjs --open",
+        "note": "Repointed from stale test-results/reports/index.html to test-artifacts/unified/report.html."
+      }
+    ],
+    "referencesToUpdate": [
+      "playwright.config.ts (root, canonical): rewrite projects to drive by directory where possible — default project testDir ./tests/e2e with testIgnore adding tests/e2e/reports/** and tests/integration/**; update vlm project testMatch visual-vlm.spec.ts → vlm-evaluation.spec.ts; update default-project testIgnore list to reference vlm-evaluation.spec.ts (not visual-vlm); confirm showcase/feature-matrix/matrix.setup testMatch still resolve (filenames unchanged); add integration dir exclusion so infra specs never run in the smoke gate; fold prod-config timeouts/junit reporter as env-conditional.",
+      "package.json scripts: test:smoke path, test:e2e:visual path, repoint test:comprehensive + test:pr to run-unified.mjs, rewrite test:https to ported specs, repoint test:report, fold report:perf/report:vlm into harness; add test:unified, test:unified:smoke, verify:prod-build, audit:report; delete test:e2e:error-handling (its target spec is deleted).",
+      ".github/workflows/ci.yml line 192: npx playwright test tests/e2e/living-graph.spec.ts → tests/e2e/graph/living-graph-effects.spec.ts (DIRECT path ref).",
+      ".github/workflows/ci.yml line 307: npm run test:pr now drives the unified harness (--profile pr); confirm advisory continue-on-error still holds.",
+      ".github/workflows/ci.yml smoke-gate (test:smoke, test:mobile, test:perf, report:showcase) — names unchanged, but re-run after each phase to confirm the moves did not break collection.",
+      "ALL keeper specs (~51): relative imports `../helpers/auth` etc. → `../../lib/auth` (depth changed by domain subfolders); also seedGraph/dbHealing/testEnv/mobileAudit/zorder/vlm imports. Apply as a single codemod.",
+      "Subprocess path to balance_metrics.py in diagnostics/layout/graph-balance.spec.ts and diagnostics/perf/large-graph-profile.spec.ts → tests/lib/metrics/balance_metrics.py.",
+      "tests/run-unified.mjs + adapters: artifact roots (test-artifacts/playwright-output for .webm, test-artifacts/{showcase,matrix,vlm,scale-sweep}); write unified outputs to test-artifacts/unified/.",
+      "GraphDone-Cloud/scripts/live-audit.mjs, verify-live.mjs: import paths → core/tests/lib/audit/{audit-kit,schema-contract,schema-coverage}.mjs and core/tests/lib/reporting/html.mjs; audit-kit BALANCE_PY → core/tests/lib/metrics/balance_metrics.py.",
+      "GraphDone-Cloud submodule pointer: bump core/ to the Core commit that contains tests/lib before Cloud imports resolve (cross-repo ordering).",
+      "CLAUDE.md Testing Strategy section: helper import path (tests/helpers/auth.ts → tests/lib/auth.ts), THE GATE path, ./start test + make test-report (legacy test-results/reports path → test-artifacts/unified/report.html).",
+      "./start script + Makefile (test-report target): repoint to test-artifacts/unified/report.html and to test:unified.",
+      "docs/TESTING_AND_REFINEMENT_PLAN.md: referenced by the CI test:pr warning string; update to reflect unified harness.",
+      "tests/lib/README.md: rewrite for new lib/ + harness layout.",
+      "turbo.json / .gitignore: confirm no pinned tests/helpers or test-results/reports paths; add test-artifacts/unified to ignore if needed."
+    ],
+    "unifiedHarness": {
+      "libModules": [
+        "tests/lib/reporting/aggregate.mjs — pure rollup (rollupStatus/statusFromCounts/sumCounts/buildReport), folded from _draft_unified; emits schema graphdone.unified-report/1",
+        "tests/lib/reporting/html.mjs — renders report.html with embedded <img> screenshots + <video> .webm clips and per-sequence sections; reuses Cloud report.mjs renderHtml + galleries",
+        "tests/lib/reporting/json.mjs — writes machine-parsable report.json (+ per-sequence raw JSON under sequences/)",
+        "tests/lib/runner/runSequence.mjs — spawns a step (playwright/vitest/node), captures exit code + stdout, resolves the step's JSON output and artifact directory",
+        "tests/lib/adapters/playwright.mjs — parses Playwright JSON reporter into cases; collects .webm from test-artifacts/playwright-output and screenshots",
+        "tests/lib/adapters/vitest.mjs — parses vitest JSON output from the four packages into case counts",
+        "tests/lib/adapters/perf.mjs — folds generate-perf-report.mjs; turns scale-sweep + graph-perf JSON into metric charts",
+        "tests/lib/adapters/vlm.mjs — folds generate-vlm-report.mjs; turns VLM results.json into persona verdict cards",
+        "tests/lib/adapters/matrix.mjs — folds generate-matrix-report.mjs; builds feature×resolution gallery",
+        "tests/lib/adapters/showcase.mjs — folds generate-showcase-report.mjs; builds video+screenshot gallery (the .webm source)",
+        "tests/lib/adapters/cloud-audit.mjs — optional ingest of GraphDone-Cloud live-audit findings.json into a sequence",
+        "tests/lib/audit/audit-kit.mjs — promoted Cloud toolkit (Playwright resolve, GraphQL client, browser probes, AuditRun)",
+        "tests/lib/audit/schema-contract.mjs — promoted SPA↔schema validator (generic over any GraphQL endpoint)",
+        "tests/lib/audit/schema-coverage.mjs — promoted mutation discovery/coverage",
+        "tests/lib/auth.ts — battle-tested login/navigateToWorkspace (consumed by every spec sequence)"
+      ],
+      "sequences": [
+        "smoke — playwright tests/e2e/smoke/user-smoke.spec.ts (THE GATE; blocking; in smoke+pr+full profiles)",
+        "unit — turbo run test → vitest JSON for core/server/web/mcp-server (blocking)",
+        "e2e-core — default project @core + auth/graph/ui/a11y/responsive/api domain specs (blocking)",
+        "mobile — --grep @mobile|@audit (blocking in pr/full)",
+        "perf-budgets — perf project graph-perf.spec.ts (ADAPT-8 budgets; blocking)",
+        "diagnostics — geometry project (report-only; full profile)",
+        "perf-scale — perf-scale project + perf adapter metrics (report-only; full)",
+        "showcase — showcase project (records .webm + screenshots) + showcase adapter (report-only; provides video for report.html)",
+        "matrix — matrix project (depends matrix-setup) + matrix adapter gallery (report-only)",
+        "vlm — vlm project + vlm adapter (report-only; auto-skips when no VLM_ENDPOINTS)",
+        "cloud-audit — optional: ingest GraphDone-Cloud findings.json via cloud-audit adapter (report-only; skipped if absent)"
+      ],
+      "entry": "tests/run-unified.mjs (npm run test:unified) — reads tests/sequences/unified.config.mjs, selects sequences by --profile {smoke|pr|full|report} or --sequence <name>, runs each via runner/runSequence.mjs, maps results through adapters, aggregates with reporting/aggregate.mjs, and writes both reports. Exit code = rollup status (failed→1) so it doubles as a gate.",
+      "outputs": [
+        "test-artifacts/unified/report.html — human-readable: per-sequence pass/warn/fail, embedded <img> screenshots, embedded <video> .webm clips (showcase), perf charts, VLM gallery",
+        "test-artifacts/unified/report.json — machine-parsable (schema graphdone.unified-report/1): rollup status, totals, per-sequence counts + artifact paths",
+        "test-artifacts/unified/sequences/<name>.json — raw per-sequence results for debugging/CI artifact upload",
+        "process exit code — 0 pass / 1 on any blocking failure, for CI gating"
+      ]
+    },
+    "deletions": [
+      "tests/e2e/auth-basic-test.spec.ts — redundant admin-login; covered by form-validation/mobile-audit",
+      "tests/e2e/auth-system-test.spec.ts — vague auth validation; form-validation is more specific",
+      "tests/e2e/add-node.spec.ts — overlaps user-smoke grow flow",
+      "tests/e2e/comprehensive-interaction.spec.ts — vague exploratory; overlaps diagnostics core-matrix",
+      "tests/e2e/comprehensive-graph-operations.spec.ts — vague; overlaps living-graph + real-time specs",
+      "tests/e2e/database-connectivity.spec.ts — Neo4j-only failure path obsolete under D1-first arch (api.ts retained for api-health)",
+      "tests/e2e/fix-left-click-refresh.spec.ts — one-off bug proof, untagged, not in scripts",
+      "tests/e2e/flash-detection.spec.ts — exploratory, untagged; overlaps showcase",
+      "tests/e2e/graph-error-handling.spec.ts — data-template not real test; doesn't match GraphQL schema (also removes test:e2e:error-handling)",
+      "tests/e2e/graph-real-time-updates.spec.ts — unclear purpose; overlaps living-graph",
+      "tests/e2e/manual-test.spec.ts — manual placeholder, no assertions",
+      "tests/e2e/neo4j-core-functionality.spec.ts — redundant with @core; untagged",
+      "tests/e2e/neo4j-working-demo.spec.ts — old demo proof; overlaps user-smoke",
+      "tests/e2e/oauth-linkedin.spec.ts — stale OAuth provider (magic-link now); mock-oauth-server + fixtures retained for admin/oauth-provider-config",
+      "tests/e2e/project-name-verification.spec.ts — exploratory naming check, untagged",
+      "tests/e2e/screenshot-current-graph.spec.ts — documentation artifact, not a test; overlaps showcase",
+      "tests/e2e/simple-error-test.spec.ts — template placeholder, no real assertions",
+      "tests/e2e/ui-basic-functionality.spec.ts — vague; overlaps responsive",
+      "tests/e2e/user-workflow.spec.ts — overlaps user-smoke/basic-workflow, untagged",
+      "tests/e2e/user-workflow-robust.spec.ts — overlaps user-smoke, untagged",
+      "tests/e2e/verify-improved-visualization.spec.ts — old visualization proof; overlaps user-smoke/showcase",
+      "tests/e2e/verify-ui-data.spec.ts — generic proof, no real assertions",
+      "tests/e2e/workspace-scrolling.spec.ts — old issue proof, no real assertions",
+      "tests/run-all-tests.js — replaced by tests/run-unified.mjs",
+      "tests/run-pr-tests.js — replaced by tests/run-unified.mjs --profile pr",
+      "tests/ci-basic-tests.js — mock-only fake results; CI runs real playwright now",
+      "tests/quick-auth-test.js — manual debug tool, hardcoded creds",
+      "tests/simple-login-test.js — manual debug tool, infinite wait",
+      "tests/manual-graph-operations-test.js — manual debug tool",
+      "tests/realtime-update-test.js — manual debug tool",
+      "tests/test-production-scrolling.js — manual debug tool, hardcoded :3128",
+      "tests/test-refresh-bugs.js — manual debug tool",
+      "tests/https-browser-compatibility-test.js — overlaps ported tls specs; not in scripts",
+      "tests/global-setup-production.js — dead binding (only the deleted production config referenced it)",
+      "tests/playwright.config.ts — duplicate config, referenced by nothing",
+      "tests/playwright.config.production.ts — settings folded into root config, then removed",
+      "tests/_draft_unified/ — emptied after aggregate.mjs promoted to lib/reporting",
+      "scripts/generate-final-report.sh — duplicate installation-report generator (keep generate-clean-report.sh)",
+      "scripts/generate-comprehensive-report.sh — duplicate installation-report generator (keep generate-clean-report.sh)",
+      "scripts/test-cert-security.sh — stale, not in CI; covered by test-tls.sh",
+      "scripts/test-installation-demo.sh — duplicate of test-installation-simple.sh",
+      "scripts/test-installation-full.sh — duplicate of test-installation-simple.sh",
+      "scripts/test-installation-functional.sh — duplicate of test-installation-simple.sh",
+      "scripts/test-installation-macos.sh — single-platform, not in CI",
+      "scripts/test-installation-multi-distro.sh — deprecated; Docker approach in test-installation-simple.sh"
+    ],
+    "risks": [
+      "The ~51-spec import codemod (helpers→lib + deeper folders) is the highest-risk change: one missed relative path throws at COLLECTION, which silently zeroes a whole project run — the exact failure class as the CI=true/webServer incident. Mitigate: codemod in one commit, then `playwright test --list` per project + run THE GATE before moving on.",
+      "Playwright projects use filename-regex testMatch; the visual-vlm→vlm-evaluation rename must be mirrored in BOTH the vlm project testMatch AND the default project testIgnore, or the heavy VLM spec leaks into the fast smoke project (or the vlm project matches nothing).",
+      "Report-only specs resolve artifact output by path; moving them into deeper subfolders can shift __dirname-relative writes (showcase per-viewport dirs, scale-sweep JSON). Verify all output roots resolve from repo root, not the spec's directory.",
+      "balance_metrics.py is referenced by string path from two specs AND by Cloud audit-kit (BALANCE_PY); moving it can break Cloud's layout metrics, and audit-kit's graceful-degrade may hide the breakage. Grep both repos for the old path.",
+      "Deleting oauth-linkedin.spec.ts removes the only importer of mock-oauth-server.ts + oauth fixtures; they are retained ONLY because admin/oauth-provider-config keeps using them — confirm that before deleting, else also delete the lib+fixture.",
+      "Deleting database-connectivity.spec.ts removes one of two api.ts consumers; api-health.spec.ts still needs api.ts — do not delete api.ts.",
+      "test:pr / test:comprehensive are public surface (CLAUDE.md, ./start test, CI prod-smoke). Repointing to the unified harness changes their output location and exit semantics; CI prod-smoke is advisory (continue-on-error) so a harness regression there is silent.",
+      "Cloud is a submodule pinned to a Core commit. Promoting libs into Core means Cloud imports break until its submodule pointer is bumped — cross-repo ordering hazard; sequence Core-first, then Cloud bump.",
+      "Heavy sequences (matrix ~100 cells, showcase 5 viewports, scale-sweep up to 2000 nodes, VLM GPU) must stay OUT of the blocking smoke/pr profiles or local + CI gate runs time out; keep them report-only/full-profile.",
+      "Legacy report path test-results/reports/index.html is referenced by ./start test, Makefile test-report, and CLAUDE.md; missing these leaves dead links after the harness moves output to test-artifacts/unified.",
+      "Folding Cloud report.mjs into reporting/html.mjs must preserve the embedded-base64-screenshot path so Cloud's portable single-file report still works; regression here breaks shareable audit reports."
+    ],
+    "phases": [
+      "Phase 0 — Scaffold the harness without moving anything. Create tests/lib/{reporting,adapters,runner}, promote _draft_unified/aggregate.mjs into lib/reporting, build run-unified.mjs + json.mjs + html.mjs + adapters against the CURRENT artifact paths, add tests/sequences/unified.config.mjs and the test:unified scripts. GATE UNCHANGED. Verify: TEST_URL=http://localhost:3127 npm run test:smoke green AND npm run test:unified emits report.html+report.json from the existing layout.",
+      "Phase 1 — Delete dead weight (no keepers touched). Remove the 23 dead/stale e2e specs, 11 loose tests/*.js, duplicate/stale configs (tests/playwright.config.ts, production config, global-setup-production.js), and redundant shell scripts. Drop/neutralize their npm scripts. Verify: gate green; `playwright test --list` shows only keepers.",
+      "Phase 2 — Consolidate helpers→tests/lib + codemod imports (NO folder reshuffle of specs yet). Move helpers/* + balance_metrics.py into lib/ (+ metrics/), run the import codemod across all keeper specs, fix the balance_metrics.py subprocess paths. Verify: `playwright test --list` per project (zero collection errors) + gate green.",
+      "Phase 3 — Reorganize specs into domain folders (e2e/<domain>, diagnostics/<concern>, integration/, reports/) with renames; rewrite root playwright.config.ts projects (testDir/testMatch/testIgnore incl. vlm-evaluation rename + integration exclusion); update test:smoke + test:e2e:visual paths and CI line 192 (living-graph). Verify: gate green via the renamed path; each PW project --list resolves; test:mobile (tag-driven) green.",
+      "Phase 4 — Fold the 4 report generators into adapters and port the loose-JS keepers to specs (tls-certificate-cross-browser, mobile/tls-compat). Wire report:showcase/report:matrix/test:vlm/test:perf:scale + test:pr/test:comprehensive through run-unified.mjs. Verify: each report sequence emits into test-artifacts/unified with embedded video+images; gate still green.",
+      "Phase 5 — Cross-repo: promote audit-kit/schema-contract/schema-coverage + report renderer into Core tests/lib/{audit,reporting}, move verify-camera-fix.mjs + generate-audit-report.mjs into Core scripts, add the cloud-audit adapter, add verify:prod-build + audit:report. Then bump GraphDone-Cloud's core/ submodule and re-point its live-audit/verify-live imports. Verify: Cloud verify-live still passes; Core audit:report renders from a sample findings.json.",
+      "Phase 6 — Docs + final cleanup. Update CLAUDE.md testing section, ./start test, Makefile test-report, tests/lib/README.md to the new layout/paths; delete tests/_draft_unified and any _archive. Final full run: npm run test:unified (full profile) + THE GATE green."
+    ]
+  }
+}
\ No newline at end of file
diff --git a/package.json b/package.json
index 94ca2d31..8669591c 100644
--- a/package.json
+++ b/package.json
@@ -24,6 +24,10 @@
     "test:all": "npm run test:unit && npm run test:e2e",
     "test:comprehensive": "node tests/run-all-tests.js",
     "test:pr": "node tests/run-pr-tests.js",
+    "test:unified": "node tests/run-unified.mjs --profile full",
+    "test:unified:smoke": "node tests/run-unified.mjs --profile smoke",
+    "test:unified:open": "node tests/run-unified.mjs --profile full --open",
+    "test:unified:lib": "node --test tests/lib/",
     "test:installation": "./scripts/test-installation-simple.sh",
     "test:https": "node tests/ssl-certificate-analysis.js && node tests/mobile-https-compatibility-test.js",
     "test:report": "open test-results/reports/index.html",
diff --git a/tests/lib/adapters/playwright.mjs b/tests/lib/adapters/playwright.mjs
new file mode 100644
index 00000000..1abf7926
--- /dev/null
+++ b/tests/lib/adapters/playwright.mjs
@@ -0,0 +1,57 @@
+import { mkdtempSync, readFileSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { runCommand } from '../runner/runSequence.mjs';
+
+/**
+ * Run a Playwright invocation and normalise its JSON report into a unified
+ * sequence object. Harvests per-test attachments (videos + screenshots) as
+ * { srcPath } for the entry to copy into the report's assets/ dir.
+ */
+export async function runPlaywrightSequence({ id, title, args = [], target, timeoutMs = 900000 }) {
+  const jsonOut = join(mkdtempSync(join(tmpdir(), 'pw-')), 'pw.json');
+  const env = {
+    TEST_URL: target || process.env.TEST_URL || 'http://localhost:3127',
+    PLAYWRIGHT_JSON_OUTPUT_NAME: jsonOut,
+    CI: 'true',
+  };
+  const res = await runCommand('npx', ['playwright', 'test', ...args, '--reporter=json'], { env, timeoutMs });
+
+  let parsed = null;
+  if (existsSync(jsonOut)) { try { parsed = JSON.parse(readFileSync(jsonOut, 'utf8')); } catch { /* fall through */ } }
+  if (!parsed) { try { parsed = JSON.parse(res.stdout); } catch { /* none */ } }
+
+  const counts = { passed: 0, failed: 0, warned: 0, skipped: 0 };
+  const cases = [];
+  const walk = (suites = []) => {
+    for (const s of suites) {
+      for (const spec of s.specs || []) {
+        for (const t of spec.tests || []) {
+          const last = (t.results || []).slice(-1)[0] || {};
+          let status = last.status === 'passed' ? 'passed' : last.status === 'skipped' ? 'skipped' : 'failed';
+          if (spec.ok === false) status = 'failed';
+          counts[status] = (counts[status] || 0) + 1;
+          const attachments = [];
+          for (const r of t.results || []) {
+            for (const a of r.attachments || []) {
+              if (!a.path) continue;
+              if ((a.contentType || '').startsWith('video')) attachments.push({ type: 'video', name: spec.title, srcPath: a.path });
+              else if ((a.contentType || '').startsWith('image')) attachments.push({ type: 'image', name: a.name || spec.title, srcPath: a.path });
+            }
+          }
+          cases.push({ title: spec.title, status, durationMs: last.duration, error: last.error && last.error.message, attachments });
+        }
+      }
+      if (s.suites) walk(s.suites);
+    }
+  };
+  if (parsed && parsed.suites) walk(parsed.suites);
+
+  if (!cases.length) {
+    const ok = res.code === 0 && !res.timedOut;
+    counts[ok ? 'passed' : 'failed']++;
+    cases.push({ title, status: ok ? 'passed' : 'failed', durationMs: res.durationMs, error: ok ? undefined : (res.timedOut ? 'sequence timed out' : (res.stderr || res.stdout || '').slice(-2000)), attachments: [] });
+  }
+  const status = counts.failed > 0 ? 'failed' : counts.passed > 0 ? 'passed' : 'skipped';
+  return { id, title, kind: 'e2e', command: `playwright test ${args.join(' ')}`, status, durationMs: res.durationMs, counts, cases };
+}
diff --git a/tests/lib/adapters/vitest.mjs b/tests/lib/adapters/vitest.mjs
new file mode 100644
index 00000000..b53b72da
--- /dev/null
+++ b/tests/lib/adapters/vitest.mjs
@@ -0,0 +1,34 @@
+import { runCommand } from '../runner/runSequence.mjs';
+
+/** Run a package's vitest suite and normalise its JSON into a unified sequence. */
+export async function runVitestSequence({ id, title, cwd, timeoutMs = 300000 }) {
+  const res = await runCommand('npx', ['vitest', 'run', '--reporter=json'], { cwd, timeoutMs });
+  let parsed = null;
+  try { parsed = JSON.parse(res.stdout); } catch {
+    const i = res.stdout.indexOf('{');
+    const j = res.stdout.lastIndexOf('}');
+    if (i >= 0 && j > i) { try { parsed = JSON.parse(res.stdout.slice(i, j + 1)); } catch { /* none */ } }
+  }
+  const counts = { passed: 0, failed: 0, warned: 0, skipped: 0 };
+  const cases = [];
+  if (parsed && parsed.testResults) {
+    for (const f of parsed.testResults) {
+      for (const a of f.assertionResults || []) {
+        const st = a.status === 'passed' ? 'passed' : (a.status === 'pending' || a.status === 'skipped' || a.status === 'todo') ? 'skipped' : 'failed';
+        counts[st]++;
+        if (st !== 'passed') cases.push({ title: [...(a.ancestorTitles || []), a.title].join(' › '), status: st, error: (a.failureMessages || []).join('\n').slice(-1500) });
+      }
+    }
+  } else if (parsed && parsed.numTotalTests != null) {
+    counts.passed = parsed.numPassedTests || 0;
+    counts.failed = parsed.numFailedTests || 0;
+    counts.skipped = parsed.numPendingTests || 0;
+  }
+  if (!parsed) {
+    const ok = res.code === 0 && !res.timedOut;
+    counts[ok ? 'passed' : 'failed']++;
+    if (!ok) cases.push({ title, status: 'failed', error: (res.timedOut ? 'timed out' : (res.stderr || res.stdout || '')).slice(-2000) });
+  }
+  const status = counts.failed > 0 ? 'failed' : counts.passed > 0 ? 'passed' : 'skipped';
+  return { id, title, kind: 'unit', command: `vitest run (${cwd})`, status, durationMs: res.durationMs, counts, cases };
+}
diff --git a/tests/lib/reporting/aggregate.mjs b/tests/lib/reporting/aggregate.mjs
new file mode 100644
index 00000000..0c434cc6
--- /dev/null
+++ b/tests/lib/reporting/aggregate.mjs
@@ -0,0 +1,58 @@
+/**
+ * Pure aggregation for the unified test harness — no I/O, fully unit-testable.
+ * Every sequence (unit run, e2e spec, live audit, …) reports counts + a status;
+ * these helpers roll the fleet up into one report object that both the HTML and
+ * JSON reporters render. Reusable across both repos.
+ */
+
+export const STATUS = Object.freeze({ PASSED: 'passed', FAILED: 'failed', WARN: 'warn', SKIPPED: 'skipped' });
+
+const RANK = { failed: 3, warn: 2, passed: 1, skipped: 0 };
+
+/** Worst-of rollup: any failure → failed; else any warn → warn; else any pass → passed; else skipped. */
+export function rollupStatus(statuses) {
+  let worst = 'skipped';
+  for (const s of statuses) {
+    if ((RANK[s] ?? 0) > RANK[worst]) worst = s;
+  }
+  return worst;
+}
+
+/** Derive a sequence's status from its case counts (a failure dominates; warns warn). */
+export function statusFromCounts({ passed = 0, failed = 0, warned = 0, skipped = 0 } = {}) {
+  if (failed > 0) return STATUS.FAILED;
+  if (warned > 0) return STATUS.WARN;
+  if (passed > 0) return STATUS.PASSED;
+  return STATUS.SKIPPED;
+}
+
+/** Sum per-sequence counts into a totals object (plus a sequence-status tally). */
+export function sumCounts(sequences) {
+  const totals = { passed: 0, failed: 0, warned: 0, skipped: 0, cases: 0, sequences: sequences.length };
+  const byStatus = { passed: 0, failed: 0, warned: 0, skipped: 0 };
+  for (const seq of sequences) {
+    const c = seq.counts || {};
+    totals.passed += c.passed || 0;
+    totals.failed += c.failed || 0;
+    totals.warned += c.warned || 0;
+    totals.skipped += c.skipped || 0;
+    totals.cases += (c.passed || 0) + (c.failed || 0) + (c.warned || 0) + (c.skipped || 0);
+    byStatus[seq.status] = (byStatus[seq.status] || 0) + 1;
+  }
+  return { totals, byStatus };
+}
+
+/** Build the full report object the reporters consume. Pure; timestamps passed in. */
+export function buildReport({ sequences = [], startedAt, finishedAt, target = '', env = {} } = {}) {
+  const { totals, byStatus } = sumCounts(sequences);
+  return {
+    schema: 'graphdone.unified-report/1',
+    startedAt,
+    finishedAt,
+    durationMs: startedAt != null && finishedAt != null ? finishedAt - startedAt : null,
+    target,
+    env,
+    rollup: { status: rollupStatus(sequences.map((s) => s.status)), totals, byStatus },
+    sequences,
+  };
+}
diff --git a/tests/lib/reporting/aggregate.test.mjs b/tests/lib/reporting/aggregate.test.mjs
new file mode 100644
index 00000000..8a3317a8
--- /dev/null
+++ b/tests/lib/reporting/aggregate.test.mjs
@@ -0,0 +1,56 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { rollupStatus, statusFromCounts, sumCounts, buildReport, STATUS } from './aggregate.mjs';
+
+test('rollupStatus: failure dominates', () => {
+  assert.equal(rollupStatus(['passed', 'failed', 'warn']), 'failed');
+});
+test('rollupStatus: warn over passed', () => {
+  assert.equal(rollupStatus(['passed', 'warn', 'passed']), 'warn');
+});
+test('rollupStatus: all skipped → skipped', () => {
+  assert.equal(rollupStatus(['skipped', 'skipped']), 'skipped');
+});
+test('rollupStatus: empty → skipped', () => {
+  assert.equal(rollupStatus([]), 'skipped');
+});
+
+test('statusFromCounts: any failure → failed', () => {
+  assert.equal(statusFromCounts({ passed: 5, failed: 1 }), STATUS.FAILED);
+});
+test('statusFromCounts: warns but no fails → warn', () => {
+  assert.equal(statusFromCounts({ passed: 5, warned: 2 }), STATUS.WARN);
+});
+test('statusFromCounts: only passes → passed', () => {
+  assert.equal(statusFromCounts({ passed: 3 }), STATUS.PASSED);
+});
+test('statusFromCounts: nothing → skipped', () => {
+  assert.equal(statusFromCounts({}), STATUS.SKIPPED);
+});
+
+test('sumCounts totals + status tally', () => {
+  const seqs = [
+    { status: 'passed', counts: { passed: 3, failed: 0, warned: 0, skipped: 1 } },
+    { status: 'failed', counts: { passed: 1, failed: 2, warned: 0, skipped: 0 } },
+  ];
+  const { totals, byStatus } = sumCounts(seqs);
+  assert.equal(totals.passed, 4);
+  assert.equal(totals.failed, 2);
+  assert.equal(totals.skipped, 1);
+  assert.equal(totals.cases, 7);
+  assert.equal(totals.sequences, 2);
+  assert.equal(byStatus.passed, 1);
+  assert.equal(byStatus.failed, 1);
+});
+
+test('buildReport rolls up status + duration', () => {
+  const r = buildReport({
+    sequences: [{ status: 'passed', counts: { passed: 2 } }, { status: 'warn', counts: { warned: 1 } }],
+    startedAt: 1000, finishedAt: 4000, target: 'http://x', env: { node: 'v20' },
+  });
+  assert.equal(r.schema, 'graphdone.unified-report/1');
+  assert.equal(r.durationMs, 3000);
+  assert.equal(r.rollup.status, 'warn');
+  assert.equal(r.rollup.totals.sequences, 2);
+  assert.equal(r.target, 'http://x');
+});
diff --git a/tests/lib/reporting/html.mjs b/tests/lib/reporting/html.mjs
new file mode 100644
index 00000000..ab440612
--- /dev/null
+++ b/tests/lib/reporting/html.mjs
@@ -0,0 +1,105 @@
+/**
+ * Pure HTML renderer for the unified report. Takes the aggregated report object
+ * (sequences may carry attachments {type:'image'|'video', name, href} whose href
+ * is already relative to the report dir) and returns a self-contained HTML string
+ * embedding <img> screenshots and <video> .webm clips. No I/O.
+ */
+const esc = (s) => String(s ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+const COLOR = { passed: '#34d399', failed: '#f87171', warn: '#fbbf24', skipped: '#94a3b8' };
+const ICON = { passed: '✅', failed: '❌', warn: '⚠️', skipped: '⏭️' };
+
+function attachmentHtml(a) {
+  if (!a || !a.href) return '';
+  if (a.type === 'video') {
+    return `<figure class="att"><video src="${esc(a.href)}" controls preload="metadata" playsinline></video><figcaption>${esc(a.name || '')}</figcaption></figure>`;
+  }
+  return `<figure class="att"><a href="${esc(a.href)}" target="_blank"><img src="${esc(a.href)}" loading="lazy" alt="${esc(a.name || '')}"></a><figcaption>${esc(a.name || '')}</figcaption></figure>`;
+}
+
+function caseHtml(c) {
+  const atts = (c.attachments || []).map(attachmentHtml).join('');
+  const err = c.error ? `<pre class="err">${esc(c.error)}</pre>` : '';
+  return `<div class="case ${esc(c.status)}">
+    <span class="dot" style="background:${COLOR[c.status] || '#888'}"></span>
+    <span class="ctitle">${esc(c.title)}</span>
+    ${c.durationMs != null ? `<span class="cdur">${(c.durationMs / 1000).toFixed(1)}s</span>` : ''}
+    ${err}${atts ? `<div class="atts">${atts}</div>` : ''}
+  </div>`;
+}
+
+function seqHtml(seq, i) {
+  const c = seq.counts || {};
+  const cases = (seq.cases || []);
+  // Show failed/warn cases expanded; collapse a long all-green list to just its attachments.
+  const notable = cases.filter((x) => x.status === 'failed' || x.status === 'warn');
+  const withAtts = cases.filter((x) => (x.attachments || []).length);
+  const shown = notable.length ? notable : withAtts.slice(0, 24);
+  return `<details class="seq ${esc(seq.status)}" ${seq.status === 'failed' ? 'open' : ''}>
+    <summary>
+      <span class="badge" style="background:${COLOR[seq.status] || '#888'}">${ICON[seq.status] || ''} ${esc(seq.status)}</span>
+      <span class="sname">${esc(seq.title || seq.id)}</span>
+      <span class="counts">${c.passed || 0}✓ ${c.failed || 0}✗ ${c.warned || 0}⚠ ${c.skipped || 0}⏭</span>
+      ${seq.durationMs != null ? `<span class="sdur">${(seq.durationMs / 1000).toFixed(1)}s</span>` : ''}
+    </summary>
+    ${seq.command ? `<code class="cmd">${esc(seq.command)}</code>` : ''}
+    ${seq.notes ? `<p class="notes">${esc(seq.notes)}</p>` : ''}
+    ${shown.map(caseHtml).join('') || '<p class="empty">no per-case detail</p>'}
+  </details>`;
+}
+
+export function renderHtml(report) {
+  const r = report.rollup || {};
+  const t = r.totals || {};
+  const when = report.finishedAt ? new Date(report.finishedAt).toISOString() : '';
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>GraphDone — Unified Test Report</title>
+<style>
+:root{color-scheme:dark}
+*{box-sizing:border-box}
+body{margin:0;background:#0b1220;color:#e2e8f0;font:14px/1.5 -apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif}
+.wrap{max-width:1100px;margin:0 auto;padding:28px 20px 80px}
+h1{font-size:22px;margin:0 0 4px;display:flex;align-items:center;gap:10px}
+.meta{color:#94a3b8;font-size:12px;margin-bottom:20px}
+.rollup{display:inline-block;padding:4px 12px;border-radius:999px;font-weight:700;color:#0b1220}
+.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:12px;margin:18px 0 26px}
+.card{background:#111a2e;border:1px solid #1e293b;border-radius:12px;padding:14px}
+.card .n{font-size:26px;font-weight:800}
+.card .l{color:#94a3b8;font-size:11px;text-transform:uppercase;letter-spacing:.06em}
+.seq{background:#0f1729;border:1px solid #1e293b;border-radius:12px;margin:10px 0;padding:6px 14px}
+.seq summary{display:flex;align-items:center;gap:12px;cursor:pointer;list-style:none;padding:8px 0}
+.seq summary::-webkit-details-marker{display:none}
+.badge{padding:2px 10px;border-radius:999px;font-size:11px;font-weight:700;color:#0b1220;text-transform:uppercase}
+.sname{font-weight:600;flex:1}
+.counts{font-variant-numeric:tabular-nums;color:#cbd5e1;font-size:12px}
+.sdur,.cdur{color:#64748b;font-size:12px}
+.cmd{display:block;background:#0b1220;border:1px solid #1e293b;border-radius:6px;padding:6px 8px;color:#7dd3fc;font-size:12px;margin:4px 0;overflow-x:auto}
+.notes{color:#94a3b8;margin:4px 0}
+.case{padding:8px 0;border-top:1px solid #16223a}
+.case .dot{display:inline-block;width:9px;height:9px;border-radius:50%;margin-right:8px;vertical-align:middle}
+.ctitle{vertical-align:middle}
+.cdur{margin-left:8px}
+.err{background:#1a1014;border:1px solid #5b2330;color:#fca5a5;border-radius:6px;padding:8px;white-space:pre-wrap;font-size:12px;margin:6px 0 0 17px}
+.atts{display:flex;flex-wrap:wrap;gap:12px;margin:10px 0 4px 17px}
+.att{margin:0;width:280px}
+.att img,.att video{width:280px;border-radius:8px;border:1px solid #1e293b;background:#000;display:block}
+.att figcaption{color:#64748b;font-size:11px;margin-top:4px;word-break:break-all}
+.empty{color:#64748b;font-size:12px;padding:6px 0 10px}
+footer{color:#475569;font-size:12px;margin-top:30px;text-align:center}
+</style></head><body><div class="wrap">
+<h1>GraphDone — Unified Test Report
+  <span class="rollup" style="background:${COLOR[r.status] || '#888'}">${ICON[r.status] || ''} ${esc(r.status || 'n/a')}</span>
+</h1>
+<div class="meta">${esc(when)} · target ${esc(report.target || 'n/a')} · ${esc((report.env && report.env.node) || '')} · ${report.durationMs != null ? (report.durationMs / 1000).toFixed(1) + 's' : ''}</div>
+<div class="cards">
+  <div class="card"><div class="n">${t.sequences || 0}</div><div class="l">Sequences</div></div>
+  <div class="card"><div class="n">${t.cases || 0}</div><div class="l">Cases</div></div>
+  <div class="card"><div class="n" style="color:${COLOR.passed}">${t.passed || 0}</div><div class="l">Passed</div></div>
+  <div class="card"><div class="n" style="color:${COLOR.failed}">${t.failed || 0}</div><div class="l">Failed</div></div>
+  <div class="card"><div class="n" style="color:${COLOR.warn}">${t.warned || 0}</div><div class="l">Warn</div></div>
+  <div class="card"><div class="n" style="color:${COLOR.skipped}">${t.skipped || 0}</div><div class="l">Skipped</div></div>
+</div>
+${(report.sequences || []).map(seqHtml).join('')}
+<footer>graphdone.unified-report/1 · machine-readable companion: report.json</footer>
+</div></body></html>`;
+}
diff --git a/tests/lib/reporting/json.mjs b/tests/lib/reporting/json.mjs
new file mode 100644
index 00000000..b6c6ad19
--- /dev/null
+++ b/tests/lib/reporting/json.mjs
@@ -0,0 +1,20 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/**
+ * Machine-parsable output: one report.json (schema graphdone.unified-report/1)
+ * plus per-sequence raw JSON under sequences/ for CI artifact upload / debugging.
+ * Returns the paths written.
+ */
+export function writeJsonReport(report, outDir) {
+  mkdirSync(join(outDir, 'sequences'), { recursive: true });
+  const mainPath = join(outDir, 'report.json');
+  writeFileSync(mainPath, JSON.stringify(report, null, 2));
+  const seqPaths = [];
+  for (const seq of report.sequences || []) {
+    const p = join(outDir, 'sequences', `${seq.id || 'sequence'}.json`);
+    writeFileSync(p, JSON.stringify(seq, null, 2));
+    seqPaths.push(p);
+  }
+  return { mainPath, seqPaths };
+}
diff --git a/tests/lib/runner/runSequence.mjs b/tests/lib/runner/runSequence.mjs
new file mode 100644
index 00000000..822e4fba
--- /dev/null
+++ b/tests/lib/runner/runSequence.mjs
@@ -0,0 +1,27 @@
+import { spawn } from 'node:child_process';
+
+/**
+ * Spawn a child process, capture stdout/stderr/exit/duration. No shell (argv
+ * array) so paths/args with spaces are safe. Resolves (never rejects) so the
+ * harness can record a failed sequence and continue.
+ */
+export function runCommand(cmd, args, { cwd, env, timeoutMs } = {}) {
+  return new Promise((resolve) => {
+    const start = Date.now();
+    const child = spawn(cmd, args, { cwd, env: { ...process.env, ...env } });
+    let stdout = '';
+    let stderr = '';
+    child.stdout.on('data', (d) => { stdout += d; });
+    child.stderr.on('data', (d) => { stderr += d; });
+    let timedOut = false;
+    const timer = timeoutMs ? setTimeout(() => { timedOut = true; child.kill('SIGKILL'); }, timeoutMs) : null;
+    child.on('close', (code) => {
+      if (timer) clearTimeout(timer);
+      resolve({ code, stdout, stderr, durationMs: Date.now() - start, timedOut });
+    });
+    child.on('error', (err) => {
+      if (timer) clearTimeout(timer);
+      resolve({ code: -1, stdout, stderr: stderr + String(err), durationMs: Date.now() - start, error: String(err) });
+    });
+  });
+}
diff --git a/tests/run-unified.mjs b/tests/run-unified.mjs
new file mode 100644
index 00000000..06938653
--- /dev/null
+++ b/tests/run-unified.mjs
@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * GraphDone unified test harness — ONE reproducible entry that runs a profile of
+ * sequences (unit + e2e + report captures) from the reusable tests/lib modules,
+ * then emits DUAL output: a human-readable report.html (embedded screenshots +
+ * .webm video clips) AND a machine-parsable report.json. Exit code = rollup
+ * status, so it doubles as a CI gate.
+ *
+ *   node tests/run-unified.mjs [--profile smoke|pr|full|report] [--sequence <id>] [--open]
+ */
+import { mkdirSync, copyFileSync, rmSync } from 'node:fs';
+import { join, extname, resolve } from 'node:path';
+import { runVitestSequence } from './lib/adapters/vitest.mjs';
+import { runPlaywrightSequence } from './lib/adapters/playwright.mjs';
+import { buildReport } from './lib/reporting/aggregate.mjs';
+import { writeJsonReport } from './lib/reporting/json.mjs';
+import { renderHtml } from './lib/reporting/html.mjs';
+import { writeFileSync } from 'node:fs';
+import { SEQUENCES, PROFILES } from './sequences/unified.config.mjs';
+
+const args = process.argv.slice(2);
+const flag = (name, def) => { const i = args.indexOf(name); return i >= 0 ? (args[i + 1] && !args[i + 1].startsWith('--') ? args[i + 1] : true) : def; };
+const profile = flag('--profile', 'smoke');
+const single = flag('--sequence', null);
+const open = !!flag('--open', false);
+const outDir = resolve(String(flag('--out', 'test-artifacts/unified')));
+const target = process.env.TEST_URL || 'http://localhost:3127';
+
+const ids = single ? [single] : (PROFILES[profile] || PROFILES.smoke);
+
+const ICON = { passed: '✅', failed: '❌', warn: '⚠️', skipped: '⏭️' };
+
+async function runOne(id) {
+  const def = SEQUENCES[id];
+  if (!def) return { id, title: id, kind: 'unknown', status: 'skipped', counts: { passed: 0, failed: 0, warned: 0, skipped: 1 }, cases: [], notes: 'unknown sequence id' };
+  process.stdout.write(`\n▶ ${id} — ${def.title}\n`);
+  if (def.adapter === 'vitest') return runVitestSequence({ id, title: def.title, cwd: def.cwd });
+  if (def.adapter === 'playwright') return runPlaywrightSequence({ id, title: def.title, args: def.args, target });
+  return { id, title: def.title, status: 'skipped', counts: { passed: 0, failed: 0, warned: 0, skipped: 1 }, cases: [] };
+}
+
+// Copy a sequence's harvested artifacts into outDir/assets/<id>/ and set href.
+function materializeArtifacts(seq) {
+  let n = 0;
+  for (const c of seq.cases || []) {
+    for (const a of c.attachments || []) {
+      if (!a.srcPath) continue;
+      try {
+        const ext = extname(a.srcPath) || (a.type === 'video' ? '.webm' : '.png');
+        const rel = join('assets', seq.id, `${n++}${ext}`);
+        const dest = join(outDir, rel);
+        mkdirSync(join(outDir, 'assets', seq.id), { recursive: true });
+        copyFileSync(a.srcPath, dest);
+        a.href = rel;
+        delete a.srcPath;
+      } catch { /* skip unreadable artifact */ }
+    }
+  }
+  return seq;
+}
+
+(async () => {
+  const startedAt = Date.now();
+  try { rmSync(outDir, { recursive: true, force: true }); } catch { /* fresh */ }
+  mkdirSync(outDir, { recursive: true });
+
+  const sequences = [];
+  for (const id of ids) {
+    const seq = await runOne(id);
+    materializeArtifacts(seq);
+    const c = seq.counts || {};
+    process.stdout.write(`   ${ICON[seq.status] || ''} ${seq.status} — ${c.passed || 0}✓ ${c.failed || 0}✗ ${c.warned || 0}⚠ ${c.skipped || 0}⏭ (${((seq.durationMs || 0) / 1000).toFixed(1)}s)\n`);
+    sequences.push(seq);
+  }
+
+  const report = buildReport({
+    sequences, startedAt, finishedAt: Date.now(), target,
+    env: { node: process.version, platform: process.platform, profile },
+  });
+
+  const { mainPath } = writeJsonReport(report, outDir);
+  const htmlPath = join(outDir, 'report.html');
+  writeFileSync(htmlPath, renderHtml(report));
+
+  const r = report.rollup;
+  process.stdout.write(`\n${'═'.repeat(48)}\n`);
+  process.stdout.write(`${ICON[r.status]} ${r.status.toUpperCase()} · ${r.totals.passed}✓ ${r.totals.failed}✗ ${r.totals.warned}⚠ ${r.totals.skipped}⏭ across ${r.totals.sequences} sequences\n`);
+  process.stdout.write(`HTML: ${htmlPath}\nJSON: ${mainPath}\n`);
+
+  if (open) {
+    const { spawn } = await import('node:child_process');
+    spawn(process.platform === 'darwin' ? 'open' : 'xdg-open', [htmlPath], { stdio: 'ignore', detached: true });
+  }
+  process.exit(r.status === 'failed' ? 1 : 0);
+})();
diff --git a/tests/sequences/unified.config.mjs b/tests/sequences/unified.config.mjs
new file mode 100644
index 00000000..56105de5
--- /dev/null
+++ b/tests/sequences/unified.config.mjs
@@ -0,0 +1,29 @@
+/**
+ * Declarative manifest for the unified test harness (tests/run-unified.mjs).
+ * Each sequence names an adapter + its inputs; PROFILES select which run.
+ * Paths reflect the CURRENT tree (Phase 0 of the test-tree refactor is
+ * non-destructive); they update as specs move into domain folders.
+ *
+ * Profiles:
+ *   smoke  — fast blocking signal (unit + THE GATE + a focused e2e)
+ *   pr     — broader blocking set for PRs (adds graph + mobile)
+ *   full   — everything incl. report-only capture sequences (video/screenshots)
+ *   report — only the capture-heavy report sequences
+ */
+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 },
+  '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 },
+};
+
+export const PROFILES = {
+  smoke: ['unit-web', 'smoke', 'e2e-auth'],
+  pr: ['unit-web', 'smoke', 'e2e-auth', 'e2e-graph', 'mobile'],
+  full: ['unit-web', 'smoke', 'e2e-auth', 'e2e-graph', 'mobile', 'showcase'],
+  report: ['showcase'],
+};