@aplaytest/core 0.1.0

package/dist-cjs/taxonomy/classify.js

@@ -0,0 +1,348 @@
+"use strict";
+/**
+ * Deterministic failure classification.
+ *
+ * No model. An ordered rule list, first match wins, most specific first.
+ * Every classification records WHICH rule fired and WHICH signals it saw, so a
+ * wrong verdict is debuggable rather than mysterious — the whole system routes
+ * on this decision, and an opaque router is an unfixable router.
+ *
+ * ORDERING IS LOAD-BEARING. Two ordering choices in particular:
+ *
+ *   1. `infra` is checked first. A crashed browser surfaces as a timeout or a
+ *      missing element; classifying it as `locator_not_found` would send a
+ *      dead environment to the healing engine.
+ *
+ *   2. `schema_violation` and `app_error` are checked BEFORE any locator rule.
+ *      If the app threw an uncaught exception and, as a consequence, an element
+ *      never rendered, the root cause is the exception. Healing the selector
+ *      would paper over a real bug — the exact outcome the NEVER_HEAL set
+ *      exists to prevent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classify = classify;
+exports.listRules = listRules;
+const parse_error_js_1 = require("./parse-error.js");
+const has = (haystack, needle) => haystack.toLowerCase().includes(needle.toLowerCase());
+const anyOf = (haystack, needles) => needles.filter(n => has(haystack, n));
+const matcherIs = (f, ...names) => f.matcher !== null && names.some(n => f.matcher?.toLowerCase().includes(n.toLowerCase()) === true);
+/** Signals that the application itself threw, rather than the test mis-looking. */
+const UNCAUGHT_PATTERNS = [
+    'Uncaught',
+    'Unhandled',
+    'Unhandled Promise Rejection',
+    'TypeError:',
+    'ReferenceError:',
+    'The above error occurred in',
+    'React will try to recreate',
+];
+const RULES = [
+    // ── 1. Infrastructure ────────────────────────────────────────────────────
+    // First, always. A dead browser must never reach the healing engine.
+    {
+        name: 'infra.browser-closed',
+        kind: 'infra',
+        confidence: 'high',
+        match: f => {
+            const hits = anyOf(f.message + f.stack, [
+                'Target page, context or browser has been closed',
+                'Browser has been closed',
+                'browserType.launch',
+                "Executable doesn't exist",
+                'Protocol error',
+                'Target crashed',
+                'SIGSEGV',
+                'out of memory',
+            ]);
+            return hits.length > 0 ? hits : null;
+        },
+    },
+    // ── 2. Contract violations — never healable ──────────────────────────────
+    {
+        name: 'contract.schema-violation',
+        kind: 'schema_violation',
+        confidence: 'high',
+        match: f => {
+            const hits = anyOf(f.message + f.stack, [
+                'ZodError',
+                'Validation error:',
+                'invalid_type',
+                'unrecognized_keys',
+                'invalid_union',
+                'Expected object, received',
+                'Required at ',
+            ]);
+            const fromNetwork = f.failedRequests
+                .filter(r => r.schemaError !== null)
+                .map(r => `schema error on ${r.method} ${r.url}`);
+            const all = [...hits, ...fromNetwork];
+            return all.length > 0 ? all : null;
+        },
+    },
+    {
+        name: 'contract.app-error',
+        kind: 'app_error',
+        confidence: 'medium',
+        match: f => {
+            // Deliberately requires an UNCAUGHT signal, not merely the presence of
+            // console output. A stray console.warn must not veto a legitimate heal.
+            const consoleHits = f.consoleErrors.filter(e => UNCAUGHT_PATTERNS.some(p => has(e, p)));
+            const messageHits = anyOf(f.message, ['pageerror', 'page.on(\'pageerror\')']);
+            const all = [
+                ...consoleHits.map(e => `uncaught in console: ${e.slice(0, 120)}`),
+                ...messageHits,
+            ];
+            return all.length > 0 ? all : null;
+        },
+    },
+    // ── 3. Transport ─────────────────────────────────────────────────────────
+    {
+        name: 'transport.network-error',
+        kind: 'network_error',
+        confidence: 'high',
+        match: f => {
+            const hits = anyOf(f.message + f.stack, [
+                'net::ERR_CONNECTION_REFUSED',
+                'net::ERR_CONNECTION_RESET',
+                'net::ERR_NAME_NOT_RESOLVED',
+                'net::ERR_INTERNET_DISCONNECTED',
+                'ECONNREFUSED',
+                'ETIMEDOUT',
+                'socket hang up',
+                'fetch failed',
+            ]);
+            const fromRequests = f.failedRequests
+                .filter(r => r.failureText !== null)
+                .map(r => `request failed: ${r.method} ${r.url}`);
+            const all = [...hits, ...fromRequests];
+            return all.length > 0 ? all : null;
+        },
+    },
+    {
+        name: 'transport.navigation-failure',
+        kind: 'navigation_failure',
+        confidence: 'high',
+        match: f => {
+            const hits = anyOf(f.message, [
+                'page.goto',
+                'Navigation timeout',
+                'navigation failed',
+                'net::ERR_ABORTED',
+            ]);
+            return hits.length > 0 ? hits : null;
+        },
+    },
+    {
+        name: 'transport.http-status',
+        kind: 'http_status',
+        confidence: 'high',
+        match: f => {
+            if (matcherIs(f, 'toBeOK'))
+                return ['matcher toBeOK failed'];
+            const hits = anyOf(f.message, [
+                'Unexpected status',
+                'expected status',
+                'toBeOK',
+                'Response status code',
+            ]);
+            return hits.length > 0 ? hits : null;
+        },
+    },
+    // ── 4. Snapshot comparisons ──────────────────────────────────────────────
+    {
+        name: 'snapshot.visual-diff',
+        kind: 'visual_diff',
+        confidence: 'high',
+        match: f => {
+            if (matcherIs(f, 'toHaveScreenshot'))
+                return ['matcher toHaveScreenshot'];
+            const hits = anyOf(f.message, [
+                'Screenshot comparison failed',
+                'toHaveScreenshot',
+                'pixels (ratio',
+                'A snapshot doesn\'t exist at',
+            ]);
+            return hits.length > 0 ? hits : null;
+        },
+    },
+    {
+        name: 'snapshot.aria-diff',
+        kind: 'aria_diff',
+        confidence: 'high',
+        match: f => {
+            if (matcherIs(f, 'toMatchAriaSnapshot'))
+                return ['matcher toMatchAriaSnapshot'];
+            const hits = anyOf(f.message, ['toMatchAriaSnapshot', 'aria snapshot']);
+            return hits.length > 0 ? hits : null;
+        },
+    },
+    // ── 5. Locator resolution ────────────────────────────────────────────────
+    {
+        name: 'locator.ambiguous',
+        kind: 'locator_ambiguous',
+        confidence: 'high',
+        match: f => {
+            const hits = anyOf(f.message, ['strict mode violation', 'resolved to 2 elements']);
+            if (hits.length > 0)
+                return hits;
+            // "resolved to N elements" for any N > 1
+            return /resolved to (\d+) elements/.test(f.message) &&
+                !/resolved to 0 elements/.test(f.message)
+                ? ['strict mode: multiple matches']
+                : null;
+        },
+    },
+    {
+        name: 'locator.not-actionable',
+        kind: 'locator_not_actionable',
+        confidence: 'high',
+        match: f => {
+            const hits = anyOf(f.message, [
+                'element is not visible',
+                'element is not enabled',
+                'element is not stable',
+                'element is not editable',
+                'intercepts pointer events',
+                'element is outside of the viewport',
+                'waiting for element to be visible, enabled and stable',
+            ]);
+            return hits.length > 0 ? hits : null;
+        },
+    },
+    {
+        name: 'locator.not-found',
+        kind: 'locator_not_found',
+        confidence: 'high',
+        match: f => {
+            const hits = anyOf(f.message, [
+                'resolved to 0 elements',
+                // Playwright renders a failed visibility assertion on a missing
+                // element as `Received: <element(s) not found>`. That is a LOCATOR
+                // problem (the address is gone), not a visibility problem — and the
+                // distinction decides whether healing is even applicable, so this
+                // rule must stay ahead of assertion.visibility.
+                'element(s) not found',
+                'locator resolved to hidden',
+                'no element matching',
+                'Element is not attached to the DOM',
+            ]);
+            // Playwright's call log says "waiting for getByTestId('…')" or
+            // "waiting for locator('…')" depending on the API used.
+            const waiting = /waiting for (locator|getBy|frameLocator)/i.test(f.message)
+                ? ['call log: waiting for an element that never appeared']
+                : [];
+            // An action that timed out while resolving a locator is a not-found,
+            // not a generic test timeout.
+            const actionTimeout = f.timedOut && /locator\.\w+:|frameLocator|\.click\(|\.fill\(/.test(f.message)
+                ? ['action timed out resolving its locator']
+                : [];
+            const all = [...hits, ...waiting, ...actionTimeout];
+            return all.length > 0 ? all : null;
+        },
+    },
+    // ── 6. Assertions ────────────────────────────────────────────────────────
+    {
+        name: 'assertion.visibility',
+        kind: 'assertion_visibility',
+        confidence: 'high',
+        match: f => {
+            if (matcherIs(f, 'toBeVisible', 'toBeHidden', 'toBeAttached', 'toHaveCount')) {
+                return [`matcher ${f.matcher ?? ''} timed out`];
+            }
+            const hits = anyOf(f.message, ['toBeVisible', 'toBeHidden', 'toBeAttached', 'toHaveCount']);
+            return hits.length > 0 ? hits : null;
+        },
+    },
+    {
+        name: 'assertion.value-mismatch',
+        kind: 'assertion_value_mismatch',
+        confidence: 'high',
+        match: f => {
+            if (matcherIs(f, 'toHaveText', 'toContainText', 'toHaveValue', 'toHaveAttribute', 'toMatchObject', 'toEqual', 'toBe', 'toHaveURL', 'toHaveTitle')) {
+                return [`matcher ${f.matcher ?? ''} value mismatch`];
+            }
+            const hasExpectedReceived = (has(f.message, 'Expected') && has(f.message, 'Received')) ||
+                has(f.message, 'Expected string') ||
+                has(f.message, 'Expected pattern');
+            return hasExpectedReceived ? ['expected/received mismatch in message'] : null;
+        },
+    },
+];
+/** Fallback used when a test timed out but nothing more specific matched. */
+const TEST_TIMEOUT_RULE = {
+    name: 'timeout.test-level',
+    kind: 'assertion_visibility',
+    confidence: 'low',
+    match: f => f.timedOut || f.budgetUsedRatio >= 0.95
+        ? [`test consumed ${(f.budgetUsedRatio * 100).toFixed(0)}% of its time budget`]
+        : null,
+};
+/**
+ * Every rule below matches against `message` and `stack`, so the code frame
+ * Playwright embeds in a message — the user's own source, quoted with context —
+ * is matched against too. Strip it here, at the single choke point, rather than
+ * at each call site: there are two of those today (the reporter and the
+ * Playwright-JSON adapter), a caller who forgets gets silently wrong verdicts,
+ * and "silently wrong" is the one failure mode a router must not have.
+ */
+function forMatching(failure) {
+    return {
+        ...failure,
+        message: (0, parse_error_js_1.stripCodeFrame)(failure.message),
+        stack: (0, parse_error_js_1.stripCodeFrame)(failure.stack),
+    };
+}
+/**
+ * Classify a Playwright failure into a {@link FailureKind}.
+ *
+ * First matching rule wins. The returned `rule` and `signals` are what make a
+ * wrong verdict debuggable — the rest of the system routes on this decision.
+ *
+ * @param input - Message, stack, matcher name, timeout flag, and optional
+ *   console/network evidence.
+ * @returns The kind, the rule that fired, a confidence, and the signals it saw.
+ *
+ * @example
+ * ```ts
+ * const verdict = classify({
+ *   message: "Error: locator('getByTestId('gym-card-name')') resolved to 0 elements",
+ *   stack: '',
+ *   timedOut: true,
+ * });
+ * // verdict.kind === 'locator_not_found'
+ * ```
+ */
+function classify(input) {
+    const failure = forMatching(input);
+    for (const rule of RULES) {
+        const signals = rule.match(failure);
+        if (signals !== null && signals.length > 0) {
+            return { kind: rule.kind, rule: rule.name, confidence: rule.confidence, signals };
+        }
+    }
+    const timeoutSignals = TEST_TIMEOUT_RULE.match(failure);
+    if (timeoutSignals !== null && timeoutSignals.length > 0) {
+        return {
+            kind: TEST_TIMEOUT_RULE.kind,
+            rule: TEST_TIMEOUT_RULE.name,
+            confidence: TEST_TIMEOUT_RULE.confidence,
+            signals: timeoutSignals,
+        };
+    }
+    return {
+        kind: 'unknown',
+        rule: 'none',
+        confidence: 'low',
+        signals: ['no rule matched — this is a taxonomy gap worth reporting'],
+    };
+}
+/** Exposed for the CLI's `aplaytest doctor --rules` and for prompt-corpus tooling. */
+/**
+ * The ordered rule list, for diagnostics and `aplaytest doctor`.
+ *
+ * @returns Rule name and kind, in evaluation order (first match wins).
+ */
+function listRules() {
+    return [...RULES, TEST_TIMEOUT_RULE].map(r => ({ name: r.name, kind: r.kind }));
+}
+//# sourceMappingURL=classify.js.map

package/dist-cjs/taxonomy/classify.js.map

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

package/dist-cjs/taxonomy/kinds.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * The failure taxonomy.
+ *
+ * Classification is deterministic — string and structure matching over the
+ * Playwright error plus features of the evidence bundle. No model is involved.
+ * The taxonomy exists to ROUTE a failure: to healing, to flaky analysis, or to
+ * "stop, this is a real bug".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROUTING = exports.NEVER_HEAL = exports.FAILURE_KINDS = void 0;
+exports.healEligibility = healEligibility;
+exports.isHealable = isHealable;
+exports.countsTowardFlakeStats = countsTowardFlakeStats;
+exports.FAILURE_KINDS = [
+    'locator_not_found', // strict mode: 0 matches
+    'locator_ambiguous', // strict mode violation: >1 match
+    'locator_not_actionable', // found, but intercepted / disabled / unstable
+    'assertion_value_mismatch', // toHaveText / toMatchObject / toHaveValue …
+    'assertion_visibility', // toBeVisible / toBeHidden timed out
+    'visual_diff', // toHaveScreenshot
+    'aria_diff', // toMatchAriaSnapshot
+    'navigation_failure',
+    'network_error', // request failed / connection refused
+    'http_status', // unexpected status in an API spec
+    'schema_violation', // Zod parse failed — the wire contract broke
+    'app_error', // console error / error boundary rendered
+    'infra', // browser crash, OOM, port-forward down
+    'unknown',
+];
+/**
+ * Kinds that must NEVER produce a heal proposal, at any aggressiveness level.
+ *
+ * This is the most important guard in the system and it is code, not policy.
+ * A suite's Zod schemas and console-error assertions exist so that drift fails
+ * LOUDLY; a framework that "helpfully" repaired a `schema_violation` would
+ * destroy the most valuable signal the suite produces.
+ */
+exports.NEVER_HEAL = new Set([
+    'schema_violation',
+    'app_error',
+    'http_status',
+    'network_error',
+    'navigation_failure',
+    'infra',
+]);
+exports.ROUTING = {
+    locator_not_found: {
+        heal: 'full',
+        flake: 'weak',
+        note: 'Element address is gone. The bread-and-butter heal.',
+    },
+    locator_ambiguous: {
+        heal: 'full',
+        flake: 'weak',
+        note: 'More than one match — often a genuine duplication in the app.',
+    },
+    locator_not_actionable: {
+        heal: 'propose-only',
+        flake: 'strong',
+        note: 'Found but not interactable. Usually timing or animation, not a wrong selector.',
+    },
+    assertion_value_mismatch: {
+        heal: 'propose-only',
+        flake: 'weak',
+        note: 'Changing an assertion changes what the test proves. Human decides.',
+    },
+    assertion_visibility: {
+        heal: 'propose-only',
+        flake: 'strong',
+        note: 'Most common genuine flake.',
+    },
+    visual_diff: {
+        heal: 'propose-only',
+        flake: 'weak',
+        note: 'Route to the snapshot workflow, not to selector healing.',
+    },
+    aria_diff: {
+        heal: 'propose-only',
+        flake: 'weak',
+        note: 'A semantic change — nearly always a real change.',
+    },
+    navigation_failure: {
+        heal: 'never',
+        flake: 'strong',
+        note: 'Environment or app. Not a selector problem.',
+    },
+    network_error: {
+        heal: 'never',
+        flake: 'strong',
+        note: 'Environment or app. Not a selector problem.',
+    },
+    http_status: {
+        heal: 'never',
+        flake: 'weak',
+        note: 'The API behaved differently. That is the finding.',
+    },
+    schema_violation: {
+        heal: 'never',
+        flake: 'excluded',
+        note: 'The wire contract broke. This IS the bug — never repair it.',
+    },
+    app_error: {
+        heal: 'never',
+        flake: 'weak',
+        note: 'The application errored. This IS the bug — never repair it.',
+    },
+    infra: {
+        heal: 'never',
+        flake: 'excluded',
+        note: 'Browser crash or environment failure. Not evidence about the test.',
+    },
+    unknown: {
+        heal: 'never',
+        flake: 'weak',
+        note: 'Unclassified. Every occurrence is a taxonomy gap worth reporting.',
+    },
+};
+/**
+ * How far a heal may go for this kind. `NEVER_HEAL` wins over `ROUTING`.
+ *
+ * @param kind - A classified failure kind.
+ * @returns `'never'`, `'propose-only'`, or `'full'`.
+ */
+function healEligibility(kind) {
+    if (exports.NEVER_HEAL.has(kind))
+        return 'never';
+    return exports.ROUTING[kind].heal;
+}
+/**
+ * @param kind - A classified failure kind.
+ * @returns `true` when a heal may be proposed (not necessarily auto-applied).
+ */
+function isHealable(kind) {
+    return healEligibility(kind) !== 'never';
+}
+/**
+ * @param kind - A classified failure kind.
+ * @returns `false` for infra, HTTP status, and schema violations — those are
+ *   not evidence of flakiness.
+ */
+function countsTowardFlakeStats(kind) {
+    return exports.ROUTING[kind].flake !== 'excluded';
+}
+//# sourceMappingURL=kinds.js.map

package/dist-cjs/taxonomy/kinds.js.map

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