@heal-dev/heal-playwright-tracer 1.0.0

package/dist/infrastructure/playwright-test-context-adapter/heal-tag-prefix.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+/**
+ * Reserved Playwright tag prefix used to embed a Heal test case id on
+ * a test. The suffix is the raw test case id, e.g. `@heal-tc_abc123`.
+ *
+ * This tag is the sole source of truth for linking a Playwright run
+ * to a Heal test case — chosen over Playwright annotations because
+ * tags are filterable from the CLI (`npx playwright test -g
+ * "@heal-tc_abc|@heal-tc_def"`), which lets the backend trigger a
+ * specific set of test cases without resolving file paths or line
+ * numbers.
+ *
+ * Inheritance caveat: Playwright's `TestInfo.tags` merges tags from
+ * the enclosing `test.describe(...)` block with tags on the
+ * `test(...)` call itself, and provides no discriminator. Tagging a
+ * describe with `@heal-*` therefore propagates the same id to every
+ * test inside. We accept this at extraction time; the backend is
+ * responsible for rejecting runs where a single testCaseId resolves
+ * to multiple distinct testIds.
+ */
+export declare const HEAL_TAG_PREFIX = "@heal-";

package/dist/infrastructure/playwright-test-context-adapter/heal-tag-prefix.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEAL_TAG_PREFIX = void 0;
+/**
+ * Reserved Playwright tag prefix used to embed a Heal test case id on
+ * a test. The suffix is the raw test case id, e.g. `@heal-tc_abc123`.
+ *
+ * This tag is the sole source of truth for linking a Playwright run
+ * to a Heal test case — chosen over Playwright annotations because
+ * tags are filterable from the CLI (`npx playwright test -g
+ * "@heal-tc_abc|@heal-tc_def"`), which lets the backend trigger a
+ * specific set of test cases without resolving file paths or line
+ * numbers.
+ *
+ * Inheritance caveat: Playwright's `TestInfo.tags` merges tags from
+ * the enclosing `test.describe(...)` block with tags on the
+ * `test(...)` call itself, and provides no discriminator. Tagging a
+ * describe with `@heal-*` therefore propagates the same id to every
+ * test inside. We accept this at extraction time; the backend is
+ * responsible for rejecting runs where a single testCaseId resolves
+ * to multiple distinct testIds.
+ */
+exports.HEAL_TAG_PREFIX = '@heal-';

package/dist/infrastructure/playwright-test-context-adapter/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+export { PlaywrightTestContextAdapter } from './playwright-test-context-adapter';
+export type { CapturedContext, TestContextHooks } from './playwright-test-context-adapter';
+export { HEAL_TAG_PREFIX } from './heal-tag-prefix';

package/dist/infrastructure/playwright-test-context-adapter/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEAL_TAG_PREFIX = exports.PlaywrightTestContextAdapter = void 0;
+var playwright_test_context_adapter_1 = require("./playwright-test-context-adapter");
+Object.defineProperty(exports, "PlaywrightTestContextAdapter", { enumerable: true, get: function () { return playwright_test_context_adapter_1.PlaywrightTestContextAdapter; } });
+var heal_tag_prefix_1 = require("./heal-tag-prefix");
+Object.defineProperty(exports, "HEAL_TAG_PREFIX", { enumerable: true, get: function () { return heal_tag_prefix_1.HEAL_TAG_PREFIX; } });

package/dist/infrastructure/playwright-test-context-adapter/playwright-test-context-adapter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+import type { TestInfo } from '@playwright/test';
+export interface CapturedContext {
+    testId: string;
+    attempt: number;
+    testCaseId?: number;
+}
+export interface TestContextHooks {
+    setContext(ctx: Record<string, unknown> | null): void;
+}
+export declare class PlaywrightTestContextAdapter {
+    private readonly hooks;
+    constructor(hooks: TestContextHooks);
+    capture(testInfo: TestInfo): CapturedContext;
+}

package/dist/infrastructure/playwright-test-context-adapter/playwright-test-context-adapter.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaywrightTestContextAdapter = void 0;
+const heal_tag_prefix_1 = require("./heal-tag-prefix");
+class PlaywrightTestContextAdapter {
+    constructor(hooks) {
+        this.hooks = hooks;
+    }
+    capture(testInfo) {
+        const attempt = testInfo.retry + 1;
+        const rawTagSuffix = testInfo.tags.find((t) => t.startsWith(heal_tag_prefix_1.HEAL_TAG_PREFIX))?.slice(heal_tag_prefix_1.HEAL_TAG_PREFIX.length) ?? '';
+        // Only digits allowed — the backend schema stores testCaseId as
+        // bigint. Anything else (empty, letters, negative, leading zeros
+        // parsed to 0) is treated as "no id" so the run goes to the
+        // unlinked bucket instead of silently mis-linking.
+        const testCaseId = /^[1-9]\d*$/.test(rawTagSuffix)
+            ? Number.parseInt(rawTagSuffix, 10)
+            : undefined;
+        this.hooks.setContext({
+            workerIndex: testInfo.workerIndex,
+            parallelIndex: testInfo.parallelIndex,
+            testId: testInfo.testId,
+            testTitle: testInfo.title,
+            titlePath: testInfo.titlePath,
+            projectName: testInfo.project.name,
+            testFile: testInfo.file,
+            retry: testInfo.retry,
+            attempt,
+            ...(testCaseId ? { testCaseId } : {}),
+        });
+        return {
+            testId: testInfo.testId,
+            attempt,
+            ...(testCaseId ? { testCaseId } : {}),
+        };
+    }
+}
+exports.PlaywrightTestContextAdapter = PlaywrightTestContextAdapter;

package/dist/infrastructure/stdout-capture-adapter/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+export { StdoutCaptureSession } from './stdout-capture-session';
+export type { StdoutCaptureResult } from './stdout-capture-session';

package/dist/infrastructure/stdout-capture-adapter/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StdoutCaptureSession = void 0;
+var stdout_capture_session_1 = require("./stdout-capture-session");
+Object.defineProperty(exports, "StdoutCaptureSession", { enumerable: true, get: function () { return stdout_capture_session_1.StdoutCaptureSession; } });

package/dist/infrastructure/stdout-capture-adapter/stdout-capture-session.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+export interface StdoutCaptureResult {
+    stdout: string[];
+    stderr: string[];
+}
+export declare class StdoutCaptureSession {
+    private readonly stdoutBuf;
+    private readonly stderrBuf;
+    private readonly origStdout;
+    private readonly origStderr;
+    private stopped;
+    constructor();
+    stop(): StdoutCaptureResult;
+    private makePatched;
+    private static chunkToString;
+}

package/dist/infrastructure/stdout-capture-adapter/stdout-capture-session.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StdoutCaptureSession = void 0;
+class StdoutCaptureSession {
+    constructor() {
+        this.stdoutBuf = [];
+        this.stderrBuf = [];
+        this.stopped = false;
+        // Save the raw property value (not a bound wrapper) so stop() can
+        // put back exactly the function that was installed, not an identity
+        // copy of it. We restore `this` manually on the forward-call below.
+        this.origStdout = process.stdout.write;
+        this.origStderr = process.stderr.write;
+        process.stdout.write = this.makePatched(this.stdoutBuf, this.origStdout, process.stdout);
+        process.stderr.write = this.makePatched(this.stderrBuf, this.origStderr, process.stderr);
+    }
+    stop() {
+        if (this.stopped) {
+            return { stdout: this.stdoutBuf, stderr: this.stderrBuf };
+        }
+        this.stopped = true;
+        process.stdout.write = this.origStdout;
+        process.stderr.write = this.origStderr;
+        return { stdout: this.stdoutBuf, stderr: this.stderrBuf };
+    }
+    makePatched(buf, orig, target) {
+        return function patched(chunk, ...rest) {
+            buf.push(StdoutCaptureSession.chunkToString(chunk, rest[0]));
+            return orig.call(target, chunk, ...rest);
+        };
+    }
+    static chunkToString(chunk, encoding) {
+        if (typeof chunk === 'string')
+            return chunk;
+        if (chunk instanceof Uint8Array) {
+            const enc = typeof encoding === 'string' ? encoding : 'utf8';
+            return Buffer.from(chunk).toString(enc);
+        }
+        return String(chunk);
+    }
+}
+exports.StdoutCaptureSession = StdoutCaptureSession;

package/dist/infrastructure/system-info-adapter/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+export { SystemInfoAdapter } from './system-info-adapter';

package/dist/infrastructure/system-info-adapter/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemInfoAdapter = void 0;
+var system_info_adapter_1 = require("./system-info-adapter");
+Object.defineProperty(exports, "SystemInfoAdapter", { enumerable: true, get: function () { return system_info_adapter_1.SystemInfoAdapter; } });

package/dist/infrastructure/system-info-adapter/system-info-adapter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+import type { SystemInfo, SystemInfoProvider } from '../../domain/trace-event-recorder/port/system-info-provider';
+export declare class SystemInfoAdapter implements SystemInfoProvider {
+    private readonly info;
+    constructor();
+    getStaticContext(): SystemInfo;
+    private static readGitSha;
+}

package/dist/infrastructure/system-info-adapter/system-info-adapter.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Copyright: (c) Myia SAS 2026.
+ * This file and its contents are licensed under the AGPLv3 License.
+ * Please see the LICENSE file at the root of this repository
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemInfoAdapter = void 0;
+// SystemInfoAdapter — default SystemInfoProvider implementation.
+//
+// Reads per-process technical state once: Node version, platform,
+// arch, hostname, CI flag, cwd, pid, and the current git SHA
+// (best-effort; empty when not a git repo). All values are captured
+// eagerly at construction so repeated calls are free and the shell
+// out to `git rev-parse HEAD` happens at most once per process.
+//
+// Tests do NOT use this adapter — they pass a stub implementing
+// SystemInfoProvider with fixed values for deterministic assertions.
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+class SystemInfoAdapter {
+    constructor() {
+        this.info = {
+            pid: process.pid,
+            nodeVersion: process.versions.node,
+            platform: process.platform,
+            arch: process.arch,
+            hostname: os.hostname(),
+            isCI: !!process.env.CI,
+            cwd: process.cwd(),
+            gitSha: SystemInfoAdapter.readGitSha(),
+        };
+    }
+    getStaticContext() {
+        return this.info;
+    }
+    static readGitSha() {
+        try {
+            return (0, child_process_1.execSync)('git rev-parse HEAD', {
+                stdio: ['ignore', 'pipe', 'ignore'],
+            })
+                .toString()
+                .trim();
+        }
+        catch (_) {
+            return undefined;
+        }
+    }
+}
+exports.SystemInfoAdapter = SystemInfoAdapter;

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@heal-dev/heal-playwright-tracer",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/heal-dev/heal-playwright-tracer.git"
+  },
+  "version": "1.0.0",
+  "description": "Statement-level execution tracer for Playwright tests. Records every executed line with timing, variable values, call depth, errors, and Playwright API correlations.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./code-hook-injector": {
+      "types": "./dist/application/babel-playwright-tracer-plugin/index.d.ts",
+      "default": "./dist/application/babel-playwright-tracer-plugin/index.js"
+    },
+    "./trace-event-recorder": {
+      "types": "./dist/domain/trace-event-recorder/service/entrypoint.d.ts",
+      "default": "./dist/domain/trace-event-recorder/service/entrypoint.js"
+    },
+    "./statement-trace-schema": {
+      "types": "./dist/domain/trace-event-recorder/model/statement-trace-schema.d.ts",
+      "default": "./dist/domain/trace-event-recorder/model/statement-trace-schema.js"
+    },
+    "./heal-trace-exporter": {
+      "types": "./dist/domain/trace-event-recorder/port/heal-trace-exporter.d.ts",
+      "default": "./dist/domain/trace-event-recorder/port/heal-trace-exporter.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:coverage": "rm -rf coverage && vitest run --coverage",
+    "typecheck": "tsc -p tsconfig.lint.json",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check": "npm run typecheck && npm run lint && npm run format:check",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.{ts,js}": [
+      "prettier --write",
+      "eslint --fix"
+    ],
+    "*.{json,md}": [
+      "prettier --write"
+    ]
+  },
+  "keywords": [
+    "playwright",
+    "tracing",
+    "instrumentation",
+    "babel-plugin",
+    "test-runner",
+    "observability"
+  ],
+  "peerDependencies": {
+    "@playwright/test": ">=1.50.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.29.0",
+    "@babel/parser": "^7.29.2",
+    "@playwright/test": "1.58.1",
+    "@types/babel__core": "^7.20.5",
+    "@types/babel__traverse": "^7.28.0",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-istanbul": "^4.1.4",
+    "eslint": "^9.39.4",
+    "eslint-plugin-headers": "^1.3.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.5.2",
+    "prettier": "^3.8.3",
+    "typescript": "^5.4.0",
+    "typescript-eslint": "^8.58.2",
+    "vitest": "^4.1.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED"
+}