@aplaytest/core 0.1.0

package/dist-cjs/history/ingest-playwright.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Ingest a Playwright JSON report into the history store.
+ *
+ * The I/O half of the adapter: read, parse, hand to `mapPlaywrightReport`,
+ * store. All of the mapping decisions — identity, timestamps, classification —
+ * live in `playwright-report.ts` and are unit-tested without a database.
+ *
+ * Like `ingestDirectory`, this NEVER throws. A bad report is reported through
+ * `IngestResult.skipped` so that one unreadable artifact among many cannot cost
+ * the others, and so a CI analyze job degrades to "nothing ingested" rather
+ * than to a red build.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ingestPlaywrightJson = ingestPlaywrightJson;
+const promises_1 = require("node:fs/promises");
+const playwright_report_js_1 = require("./playwright-report.js");
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * The same environment variables the reporter reads. Kept identical on purpose:
+ * a run ingested through the JSON path and one written by the reporter should
+ * be labelled by the same rules, or comparing them later means comparing the
+ * conventions of two different code paths.
+ */
+function identityFromEnv(overrides) {
+    const env = process.env;
+    return {
+        commit: overrides?.commit ?? env['GITHUB_SHA'] ?? null,
+        branch: overrides?.branch ?? env['GITHUB_REF_NAME'] ?? null,
+        appEnv: overrides?.appEnv ?? env['APP_ENV'] ?? null,
+        ci: overrides?.ci ?? (env['CI'] === 'true' || env['CI'] === '1'),
+    };
+}
+function failed(path, reason) {
+    return { filesRead: 1, runsIngested: 0, attemptsIngested: 0, skipped: [{ file: path, reason }] };
+}
+async function ingestPlaywrightJson(store, path, options = {}) {
+    const raw = await (0, promises_1.readFile)(path, 'utf8').catch(() => null);
+    if (raw === null) {
+        return { filesRead: 0, runsIngested: 0, attemptsIngested: 0, skipped: [{ file: path, reason: 'unreadable' }] };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return failed(path, 'not valid JSON');
+    }
+    if (!isRecord(parsed))
+        return failed(path, 'not a Playwright JSON report');
+    const { run, collapsed } = (0, playwright_report_js_1.mapPlaywrightReport)(parsed, {
+        identity: identityFromEnv(options.identity),
+        ...(options.now === undefined ? {} : { now: options.now }),
+    });
+    try {
+        await store.ingest(run);
+    }
+    catch (error) {
+        return failed(path, `could not be stored: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return {
+        filesRead: 1,
+        runsIngested: 1,
+        attemptsIngested: run.attempts.length,
+        // Surfaced through the channel the CLI already prints as warnings. A
+        // collapsed duplicate is a real loss of an attempt and has to be visible;
+        // it is not a reason to reject the other hundred-odd rows.
+        skipped: collapsed.map(what => ({
+            file: path,
+            reason: `duplicate attempt collapsed: ${what}`,
+        })),
+    };
+}
+//# sourceMappingURL=ingest-playwright.js.map

package/dist-cjs/history/ingest-playwright.js.map

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

package/dist-cjs/history/ingest.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Ingest run records written by the reporter into the history store.
+ *
+ * The reporter writes plain JSON; this is the seam where those files become
+ * queryable history. Keeping it separate means a CI job can download shard
+ * artifacts from anywhere and ingest them in one pass, and a developer can
+ * replay months of archived runs to seed history without waiting for it to
+ * accumulate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ingestDirectory = ingestDirectory;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const types_js_1 = require("./types.js");
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isRunRecord(value) {
+    if (!isRecord(value))
+        return false;
+    if (value['schemaVersion'] !== types_js_1.RUN_SCHEMA_VERSION)
+        return false;
+    if (typeof value['runId'] !== 'string' || value['runId'] === '')
+        return false;
+    return Array.isArray(value['attempts']);
+}
+function validate(parsed) {
+    if (!isRecord(parsed))
+        return 'not an object';
+    if (parsed['schemaVersion'] !== types_js_1.RUN_SCHEMA_VERSION) {
+        return `schemaVersion ${String(parsed['schemaVersion'])} — this build reads ${types_js_1.RUN_SCHEMA_VERSION}`;
+    }
+    if (typeof parsed['runId'] !== 'string' || parsed['runId'] === '')
+        return 'missing runId';
+    if (!Array.isArray(parsed['attempts']))
+        return 'missing attempts';
+    return isRunRecord(parsed) ? parsed : 'not an object';
+}
+/**
+ * Ingest every `*.json` in a directory.
+ *
+ * A malformed or version-mismatched file is SKIPPED and reported, never
+ * thrown: one bad artifact among fifty shards must not cost you the other
+ * forty-nine, and a partial history is far more useful than none.
+ */
+async function ingestDirectory(store, dir) {
+    const entries = await (0, promises_1.readdir)(dir).catch(() => []);
+    const files = entries.filter(name => name.endsWith('.json'));
+    const skipped = [];
+    let runsIngested = 0;
+    let attemptsIngested = 0;
+    for (const name of files) {
+        const path = (0, node_path_1.join)(dir, name);
+        let parsed;
+        try {
+            parsed = JSON.parse(await (0, promises_1.readFile)(path, 'utf8'));
+        }
+        catch (error) {
+            skipped.push({ file: name, reason: error instanceof Error ? error.message : 'unreadable' });
+            continue;
+        }
+        const validated = validate(parsed);
+        if (typeof validated === 'string') {
+            skipped.push({ file: name, reason: validated });
+            continue;
+        }
+        // The doc comment above promises a bad file is skipped, never thrown —
+        // but only the JSON parse and the shape check were guarded. A record that
+        // passes both and then fails at the database (an unbindable value, a
+        // constraint) threw straight out of here and rolled back the transaction,
+        // costing every other file in the batch. In CI that reads as history
+        // simply never accumulating.
+        try {
+            await store.ingest(validated);
+        }
+        catch (error) {
+            skipped.push({
+                file: name,
+                reason: `could not be stored: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            continue;
+        }
+        runsIngested += 1;
+        attemptsIngested += validated.attempts.length;
+    }
+    return { filesRead: files.length, runsIngested, attemptsIngested, skipped };
+}
+//# sourceMappingURL=ingest.js.map

package/dist-cjs/history/ingest.js.map

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

package/dist-cjs/history/memory-index.js

@@ -0,0 +1,242 @@
+"use strict";
+/**
+ * The query engine, with no storage under it.
+ *
+ * Every driver ends up answering the same four questions — attempts in a
+ * window, distinct test keys, run count, prune — and the SQL that answers them
+ * carries semantics that took real incidents to get right: shard-scoped
+ * replacement, earliest-shard `startedAt`, ordering before the limit. Writing
+ * those a second time in a blob driver would mean maintaining two definitions
+ * of "the same history" and discovering the drift months later, as a flake
+ * score that differs between local and CI.
+ *
+ * So the semantics live here, once, over plain objects. `SqliteHistoryStore`
+ * keeps its own SQL (it is the local/dev driver and the schema is its own
+ * documentation); the Azure driver is this index plus blob I/O, which is the
+ * only shape that makes sense when the durable form is an append-only log of
+ * run records rather than a queryable database.
+ *
+ * Pure and synchronous: no clock, no filesystem, no network. That is what
+ * makes the query semantics testable without a container or an emulator.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryHistoryStore = exports.HistoryIndex = void 0;
+exports.shardKeyOf = shardKeyOf;
+/**
+ * Identifies the unit that is replaced wholesale on re-ingest.
+ *
+ * NOT the run id. Under sharding every shard reports the same run id, so
+ * keying on it alone means ingesting shard 2 discards shard 1 — the bug that
+ * once turned three shard files carrying four attempts into zero. A shard is
+ * the smallest thing a re-run can replace, so it is the key.
+ */
+function shardKeyOf(shard) {
+    return shard === null || shard === undefined ? 'all' : `${shard.current}-of-${shard.total}`;
+}
+/**
+ * Composite-key separator. NUL rather than a space or a colon, because a run id
+ * is whatever `ATEST_RUN_ID` contained and both of those are legal in one — and
+ * `"a b" + sep + "c"` colliding with `"a" + sep + "b c"` would silently merge
+ * two runs into one.
+ */
+const KEY_SEP = '\u0000';
+function asStringArray(value) {
+    return Array.isArray(value) ? value.filter((v) => typeof v === 'string') : [];
+}
+/**
+ * Records reaching here have been shape-checked, not type-checked: `validate()`
+ * in ingest.ts asserts a schema version, a run id and an attempts array, and
+ * nothing else. A record written by a different atest version can be missing
+ * any optional field entirely, and `undefined` where the type says `T | null`
+ * propagates into scores as a silent NaN rather than an error.
+ */
+function normalizeAttempt(attempt, segment, runMeta) {
+    return {
+        runId: segment.runId,
+        testId: attempt.testId,
+        project: attempt.project,
+        retry: attempt.retry ?? 0,
+        title: attempt.title,
+        titlePath: asStringArray(attempt.titlePath),
+        file: attempt.file,
+        line: attempt.line ?? 0,
+        tags: asStringArray(attempt.tags),
+        outcome: attempt.outcome,
+        failureKind: (attempt.failureKind ?? null),
+        durationMs: attempt.durationMs ?? 0,
+        workerIndex: attempt.workerIndex ?? 0,
+        // An attempt executed during shard 1 of 3 belongs to shard 1 of 3.
+        // Falling back to the run's shard is what keeps the replacement key and
+        // the attempt's own record of itself in agreement.
+        shard: attempt.shard ?? segment.run.shard ?? null,
+        traceId: attempt.traceId ?? null,
+        evidenceId: (attempt.evidenceId ?? null),
+        coScheduled: asStringArray(attempt.coScheduled),
+        routes: asStringArray(attempt.routes),
+        startedAt: runMeta.startedAt,
+        commit: runMeta.commit,
+        branch: runMeta.branch,
+        ci: runMeta.ci,
+        workers: runMeta.workers,
+    };
+}
+/**
+ * In-memory history with SQLite's query semantics and none of its storage.
+ *
+ * Add segments in any order; the answers do not depend on it, except where
+ * SQLite's own answers would not either (last writer wins on mutable run
+ * metadata).
+ */
+class HistoryIndex {
+    /** Keyed `runId\x00shardKey` — the replacement unit. */
+    segments = new Map();
+    add(run) {
+        const shardKey = shardKeyOf(run.shard);
+        this.segments.set(`${run.runId}${KEY_SEP}${shardKey}`, { runId: run.runId, shardKey, run });
+    }
+    /** Drop everything, so a driver can reload from its backing store. */
+    clear() {
+        this.segments.clear();
+    }
+    has(runId, shardKey) {
+        return this.segments.has(`${runId}${KEY_SEP}${shardKey}`);
+    }
+    /**
+     * One metadata row per run id, merged across its shards.
+     *
+     * `startedAt` takes the EARLIEST value: a run spanning six shards started
+     * when its first shard did, and letting the last shard ingested stamp the
+     * time would move the run inside the recency window depending on artifact
+     * download order. Everything else is last-writer-wins, matching the UPSERT.
+     */
+    runMetadata() {
+        const meta = new Map();
+        for (const segment of this.segments.values()) {
+            const run = segment.run;
+            const existing = meta.get(run.runId);
+            if (existing === undefined) {
+                meta.set(run.runId, {
+                    startedAt: run.startedAt,
+                    commit: run.commit ?? null,
+                    branch: run.branch ?? null,
+                    ci: run.ci === true,
+                    workers: run.workers ?? 0,
+                });
+                continue;
+            }
+            if (run.startedAt < existing.startedAt)
+                existing.startedAt = run.startedAt;
+            existing.commit = run.commit ?? null;
+            existing.branch = run.branch ?? null;
+            existing.ci = run.ci === true;
+            existing.workers = run.workers ?? 0;
+        }
+        return meta;
+    }
+    attempts(query = {}) {
+        const meta = this.runMetadata();
+        const rows = [];
+        for (const segment of this.segments.values()) {
+            const runMeta = meta.get(segment.runId);
+            if (runMeta === undefined)
+                continue;
+            if (query.since !== undefined && runMeta.startedAt < query.since)
+                continue;
+            for (const attempt of segment.run.attempts ?? []) {
+                if (query.testId !== undefined && attempt.testId !== query.testId)
+                    continue;
+                if (query.project !== undefined && attempt.project !== query.project)
+                    continue;
+                rows.push(normalizeAttempt(attempt, segment, runMeta));
+            }
+        }
+        // `ORDER BY r.started_at DESC, a.retry ASC`, then LIMIT — the limit is a
+        // window over the newest attempts, so applying it before the sort would
+        // silently score an arbitrary subset. The extra tiebreakers are not in the
+        // SQL: SQLite leaves ties unordered, and an unstable order here would make
+        // a `--limit`ed score depend on Map iteration order.
+        rows.sort((a, b) => b.startedAt.localeCompare(a.startedAt) ||
+            a.retry - b.retry ||
+            a.runId.localeCompare(b.runId) ||
+            a.testId.localeCompare(b.testId) ||
+            a.project.localeCompare(b.project));
+        return query.limit === undefined ? rows : rows.slice(0, Math.max(0, query.limit));
+    }
+    testKeys() {
+        // Newest first, so the title and file a key reports are the ones the test
+        // has NOW. SQLite's bare-column GROUP BY picks an arbitrary row, which
+        // after a rename reports whichever the query planner happened to visit.
+        const keys = new Map();
+        for (const attempt of this.attempts()) {
+            const key = `${attempt.testId}${KEY_SEP}${attempt.project}`;
+            if (keys.has(key))
+                continue;
+            keys.set(key, {
+                testId: attempt.testId,
+                project: attempt.project,
+                title: attempt.title,
+                file: attempt.file,
+            });
+        }
+        return [...keys.values()].sort((a, b) => a.file.localeCompare(b.file) || a.title.localeCompare(b.title));
+    }
+    runCount() {
+        const ids = new Set();
+        for (const segment of this.segments.values())
+            ids.add(segment.runId);
+        return ids.size;
+    }
+    /**
+     * Remove runs that started before the cutoff. Returns the number of RUNS
+     * dropped, not segments — a six-shard run pruned is one run, which is what
+     * `runCount()` counted it as.
+     */
+    prune(olderThanIso) {
+        const meta = this.runMetadata();
+        const doomed = new Set();
+        for (const [runId, runMeta] of meta) {
+            if (runMeta.startedAt < olderThanIso)
+                doomed.add(runId);
+        }
+        const removedKeys = [];
+        for (const [key, segment] of this.segments) {
+            if (!doomed.has(segment.runId))
+                continue;
+            removedKeys.push(key);
+            this.segments.delete(key);
+        }
+        return { removedRuns: doomed.size, removedKeys };
+    }
+}
+exports.HistoryIndex = HistoryIndex;
+/**
+ * `HistoryStore` over a `HistoryIndex` and nothing else.
+ *
+ * This is what `--db :memory:` should always have meant. Reaching for
+ * `new SqliteHistoryStore(':memory:')` to get a throwaway store — as the MCP
+ * server and `aplaytest impact` both did — pulls in `node:sqlite`, a schema and a
+ * transaction to hold data that is discarded when the process exits.
+ */
+class MemoryHistoryStore {
+    index = new HistoryIndex();
+    async ingest(run) {
+        this.index.add(run);
+    }
+    async attempts(query = {}) {
+        return this.index.attempts(query);
+    }
+    async testKeys() {
+        return this.index.testKeys();
+    }
+    async runCount() {
+        return this.index.runCount();
+    }
+    async prune(olderThanIso) {
+        return this.index.prune(olderThanIso).removedRuns;
+    }
+    async close() {
+        this.index.clear();
+    }
+}
+exports.MemoryHistoryStore = MemoryHistoryStore;
+//# sourceMappingURL=memory-index.js.map

package/dist-cjs/history/memory-index.js.map

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