@aplaytest/core 0.1.0

package/dist-cjs/taxonomy/parse-error.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Parse Playwright's error prose into structured signals.
+ *
+ * Playwright reports failures as formatted human text, not structured data —
+ * `TestError` carries `message` and `stack`, but not the matcher name, the
+ * locator, or the expected/received pair. Everything downstream (the
+ * classifier, candidate generation, the heal ledger) needs those as fields, so
+ * exactly one module does the string work and is tested against real output.
+ *
+ * When a field cannot be found the answer is `null`, never a guess. A wrong
+ * locator here would send the healing engine after the wrong element.
+ *
+ * ── Why this lives in core, next to the classifier ──────────────────────────
+ * It parses Playwright's OUTPUT TEXT; it imports nothing from Playwright, the
+ * same way `classify` matches on message strings without depending on the
+ * runner. Two consumers need it and only one of them can see the runner: the
+ * reporter (inside the test process, with a live `TestResult`) and the
+ * Playwright-JSON history adapter (in CI, with only a merged report on disk).
+ * Leaving it in `@aplaytest/runner-playwright` would have forced core to depend on
+ * the runner — inverting the dependency — or forced the adapter to reimplement
+ * the regexes, which is how two parsers drift into disagreeing about the same
+ * error. `@aplaytest/runner-playwright` re-exports it, so its public API is
+ * unchanged.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripAnsi = stripAnsi;
+exports.joinErrors = joinErrors;
+exports.parsePlaywrightError = parsePlaywrightError;
+exports.stripCodeFrame = stripCodeFrame;
+exports.splitCallLog = splitCallLog;
+const MATCHER_PATTERNS = [
+    // expect(locator).toBeVisible() failed
+    /expect\((?:locator|page|received|apiResponse)\)\.(?:not\.)?(\w+)\(/,
+    // Timed out 5000ms waiting for expect(locator).toHaveText(expected)
+    /waiting for expect\([^)]*\)\.(?:not\.)?(\w+)\(/,
+];
+const LOCATOR_PATTERNS = [
+    // "Locator: getByTestId('gym-card-name')"
+    /^\s*Locator:\s*(.+?)\s*$/m,
+    // "  - waiting for getByTestId('search-clear-button')"
+    /waiting for (getBy\w+\([^\n]*?\)|locator\([^\n]*?\)|frameLocator\([^\n]*?\))/,
+    // "strict mode violation: getByTestId('gyms-list-item') resolved to 12 elements"
+    /strict mode violation:\s*(.+?)\s+resolved to/,
+    // "locator.click: ..." with a call-log resolution line
+    /locator resolved to\s+(<[^\n]+>)/,
+];
+const EXPECTED_PATTERN = /^\s*Expected(?:\s+(?:string|pattern|value|array|object))?:\s*(.+?)\s*$/m;
+const RECEIVED_PATTERN = /^\s*Received(?:\s+(?:string|value|array|object))?:\s*(.+?)\s*$/m;
+const TIMEOUT_PATTERNS = [
+    /Timeout:\s*(\d+)ms/,
+    /Timeout\s+(\d+)ms exceeded/,
+    /Test timeout of\s+(\d+)ms exceeded/,
+    /Timed out\s+(\d+)ms waiting/,
+];
+/**
+ * Playwright colourises `error.message` with ANSI escapes, even when stdout is
+ * not a TTY. Left in place they defeat every pattern here (the matcher name is
+ * split by escapes mid-word) and they are pure waste in a token budget when a
+ * bundle reaches a model. Strip once, at the boundary.
+ */
+// eslint-disable-next-line no-control-regex
+const ANSI_PATTERN = /\u001B\[[0-9;]*m/g;
+function stripAnsi(input) {
+    return input.replace(ANSI_PATTERN, '');
+}
+/**
+ * Flatten an attempt's errors into the single message/stack pair the parser and
+ * the classifier read.
+ *
+ * Shared rather than duplicated: the reporter and the Playwright-JSON adapter
+ * both start from an array of errors, and two copies of "join, then strip
+ * ANSI" is two chances to strip in only one of them — which shows up much
+ * later as a classifier that mysteriously fails to match on one code path.
+ */
+function joinErrors(errors) {
+    const join = (pick) => stripAnsi((errors ?? [])
+        .map(error => pick(error) ?? '')
+        .filter(text => text !== '')
+        .join('\n\n'));
+    return { message: join(e => e.message), stack: join(e => e.stack) };
+}
+function firstCapture(text, patterns) {
+    for (const re of patterns) {
+        const captured = re.exec(text)?.[1];
+        if (captured !== undefined && captured.trim() !== '')
+            return captured.trim();
+    }
+    return null;
+}
+/**
+ * Modern Playwright reports the received side as a trailing `Error: <reason>`
+ * line rather than `Received: …`:
+ *
+ *   Error: expect(locator).toBeVisible() failed
+ *   Locator: getByTestId('gym-card-name')
+ *   Expected: visible
+ *   Timeout: 1000ms
+ *   Error: element(s) not found        ← this is the "received"
+ *
+ * The FIRST `Error:` line is always the header, whatever it says — so the
+ * reason is a subsequent one. A message with a single `Error:` line has no
+ * separate received value and must return null rather than echoing its own
+ * header back as if it were the observed result.
+ */
+function reasonLine(message) {
+    const errorLines = message
+        .split('\n')
+        .map(line => /^\s*Error:\s*(.+?)\s*$/.exec(line)?.[1])
+        .filter((value) => value !== undefined && value !== '');
+    return errorLines.slice(1).find(line => !line.includes('expect(')) ?? null;
+}
+function parsePlaywrightError(rawMessage, rawStack = '') {
+    const message = stripAnsi(rawMessage);
+    const stack = stripAnsi(rawStack);
+    const text = `${message}\n${stack}`;
+    const timeoutRaw = firstCapture(text, TIMEOUT_PATTERNS);
+    const timeoutMs = timeoutRaw === null ? null : Number.parseInt(timeoutRaw, 10);
+    // A `Timeout: Nms` line is an OUTCOME, not configuration: Playwright emits
+    // it only when the assertion actually consumed its budget. A failure that
+    // resolves immediately — a strict-mode violation, say — carries no such
+    // line. Verified against real 1.62 output.
+    const exhaustedBudget = /^\s*Timeout:\s*\d+ms\s*$/m.test(message);
+    return {
+        matcher: firstCapture(message, MATCHER_PATTERNS),
+        expected: firstCapture(message, [EXPECTED_PATTERN]),
+        actual: firstCapture(message, [RECEIVED_PATTERN]) ?? reasonLine(message),
+        locator: firstCapture(text, LOCATOR_PATTERNS),
+        timedOut: exhaustedBudget || /exceeded|Timed out/i.test(text),
+        timeoutMs: Number.isNaN(timeoutMs) ? null : timeoutMs,
+    };
+}
+// A Playwright code frame, as embedded in `error.message`:
+//
+//     13 |       await page.goto('/about');
+//     14 |
+//   > 15 |       await page.getByTestId(mobileToggle).click();
+//        |                                            ^
+//       at /repo/tests/layout/mobile-nav.ui.acceptance.spec.ts:15:44
+//
+const CODE_FRAME_LINE = /^\s*>?\s*\d+\s*\|/;
+const CODE_FRAME_CARET = /^\s*\|\s*\^+\s*$/;
+const CODE_FRAME_LOCATION = /^\s*at\s+\S+:\d+:\d+\s*$/;
+/**
+ * Remove the source snippet Playwright embeds in an error message.
+ *
+ * This is not cosmetic. The frame is the USER'S OWN SOURCE, quoted with a few
+ * lines of context either side, and anything matching against the message will
+ * happily match against it. A real case from a live run: a `locator.click`
+ * timeout was classified `navigation_failure` because two lines above the
+ * failing call the spec happened to read `await page.goto('/about')`. The
+ * verdict routed on a line that had already succeeded.
+ *
+ * That is not a rare shape. In the acceptance run this was measured against,
+ * every failing attempt carried a frame — so in a UI suite, where nearly every
+ * test navigates somewhere, the contamination is the norm rather than the
+ * exception. And the cost is asymmetric: `navigation_failure` is `heal: never`,
+ * so a false match silently withdraws a genuinely healable failure from the
+ * healing engine and gives no indication it did so.
+ *
+ * Only classification input is stripped. Evidence bundles keep the full
+ * message, because the frame is exactly what a human wants to see first.
+ */
+function stripCodeFrame(message) {
+    const kept = message
+        .split('\n')
+        .filter(line => !CODE_FRAME_LINE.test(line) &&
+        !CODE_FRAME_CARET.test(line) &&
+        !CODE_FRAME_LOCATION.test(line));
+    // Removing interior lines leaves runs of blanks where the frame used to be.
+    return kept.join('\n').replace(/\n{3,}/g, '\n\n').trim();
+}
+/**
+ * Playwright prints a trailing "Call log:" block that is invaluable for a
+ * human and pure noise for a token budget. Split it so the caller decides.
+ */
+function splitCallLog(message) {
+    const index = message.indexOf('Call log:');
+    if (index === -1)
+        return { summary: message.trim(), callLog: null };
+    return {
+        summary: message.slice(0, index).trim(),
+        callLog: message.slice(index).trim(),
+    };
+}
+//# sourceMappingURL=parse-error.js.map

package/dist-cjs/taxonomy/parse-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error.js","sourceRoot":"","sources":["../../src/taxonomy/parse-error.ts"],"names":[],"mappings":"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"}

package/dist-cjs/version.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ATEST_VERSION = void 0;
+/**
+ * Library version written into evidence bundles, run records, and MCP
+ * handshake metadata.
+ *
+ * Must match `packages/core/package.json` — the unit test in `config.test.ts`
+ * enforces that, because a drift here is how a consumer's `aplaytest doctor`
+ * reports a version nobody published.
+ */
+exports.ATEST_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist-cjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACU,QAAA,aAAa,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@aplaytest/core",
+  "version": "0.1.0",
+  "description": "Core types, failure taxonomy, and configuration for atest. No Playwright, no network, no LLM.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist-cjs/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist-cjs/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "dist-cjs"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ianoflynnautomation/aplaytest.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/ianoflynnautomation/aplaytest#readme",
+  "bugs": {
+    "url": "https://github.com/ianoflynnautomation/aplaytest/issues"
+  }
+}