@nsxbet/playwright-orchestrator 0.2.0

package/dist/core/timing-store.js

@@ -0,0 +1,280 @@
+import * as fs from 'node:fs';
+import { createEmptyTimingData, isTimingDataV1, isTimingDataV2, TIMING_DATA_VERSION, TIMING_DATA_VERSION_V1, } from './types.js';
+/**
+ * Default EMA smoothing factor (alpha)
+ * Higher values give more weight to recent measurements
+ */
+export const DEFAULT_EMA_ALPHA = 0.3;
+/**
+ * Default number of days after which to prune old entries
+ */
+export const DEFAULT_PRUNE_DAYS = 30;
+/**
+ * Load timing data from a JSON file
+ *
+ * Supports both v1 (file-level) and v2 (test-level) formats.
+ *
+ * @param filePath - Path to the timing data JSON file
+ * @returns Timing data, or empty data if file doesn't exist
+ */
+export function loadTimingData(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const data = JSON.parse(content);
+        // Handle v1 format
+        if (data.version === TIMING_DATA_VERSION_V1) {
+            // Return as-is for backwards compatibility
+            return data;
+        }
+        // Handle v2 format
+        if (data.version === TIMING_DATA_VERSION) {
+            return data;
+        }
+        // Unknown version - return empty v2 data
+        console.warn(`Timing data version mismatch: expected ${TIMING_DATA_VERSION}, got ${data.version}. Using empty data.`);
+        return createEmptyTimingData();
+    }
+    catch {
+        // File doesn't exist or is invalid - return empty data
+        return createEmptyTimingData();
+    }
+}
+/**
+ * Save timing data to a JSON file
+ */
+export function saveTimingData(filePath, data) {
+    const content = JSON.stringify(data, null, 2);
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+/**
+ * Calculate Exponential Moving Average for duration
+ *
+ * Formula: newDuration = α * measuredDuration + (1 - α) * oldDuration
+ *
+ * @param oldDuration - Previous duration value
+ * @param newDuration - New measured duration
+ * @param alpha - Smoothing factor (0-1), higher = more weight on new value
+ */
+export function calculateEMA(oldDuration, newDuration, alpha = DEFAULT_EMA_ALPHA) {
+    return Math.round(alpha * newDuration + (1 - alpha) * oldDuration);
+}
+/**
+ * Merge new timing measurements into existing timing data using EMA (v1 - file-level)
+ *
+ * @param existing - Existing timing data (v1)
+ * @param newMeasurements - New measurements from shard artifacts
+ * @param alpha - EMA smoothing factor
+ * @returns Updated timing data
+ */
+export function mergeTimingData(existing, newMeasurements, alpha = DEFAULT_EMA_ALPHA) {
+    const now = new Date().toISOString();
+    // Convert v2 to v1 if needed (lossy - just take file names)
+    const existingFiles = isTimingDataV1(existing)
+        ? existing.files
+        : aggregateTestsToFiles(existing);
+    const merged = {
+        version: TIMING_DATA_VERSION_V1,
+        updatedAt: now,
+        files: { ...existingFiles },
+    };
+    for (const artifact of newMeasurements) {
+        for (const [file, duration] of Object.entries(artifact.files)) {
+            const existingData = merged.files[file];
+            if (existingData) {
+                // Apply EMA to existing data
+                merged.files[file] = {
+                    duration: calculateEMA(existingData.duration, duration, alpha),
+                    runs: existingData.runs + 1,
+                    lastRun: now,
+                };
+            }
+            else {
+                // First measurement for this file
+                merged.files[file] = {
+                    duration,
+                    runs: 1,
+                    lastRun: now,
+                };
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Merge new timing measurements into existing timing data using EMA (v2 - test-level)
+ *
+ * @param existing - Existing timing data (v2)
+ * @param newMeasurements - New measurements from shard artifacts
+ * @param alpha - EMA smoothing factor
+ * @returns Updated timing data
+ */
+export function mergeTestTimingData(existing, newMeasurements, alpha = DEFAULT_EMA_ALPHA) {
+    const now = new Date().toISOString();
+    const merged = {
+        version: TIMING_DATA_VERSION,
+        updatedAt: now,
+        tests: existing ? { ...existing.tests } : {},
+    };
+    for (const artifact of newMeasurements) {
+        for (const [testId, duration] of Object.entries(artifact.tests)) {
+            const existingData = merged.tests[testId];
+            const file = extractFileFromTestId(testId);
+            if (existingData) {
+                // Apply EMA to existing data
+                merged.tests[testId] = {
+                    file: existingData.file,
+                    duration: calculateEMA(existingData.duration, duration, alpha),
+                    runs: existingData.runs + 1,
+                    lastRun: now,
+                };
+            }
+            else {
+                // First measurement for this test
+                merged.tests[testId] = {
+                    file,
+                    duration,
+                    runs: 1,
+                    lastRun: now,
+                };
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Extract file name from test ID
+ */
+function extractFileFromTestId(testId) {
+    const parts = testId.split('::');
+    return parts[0] ?? '';
+}
+/**
+ * Aggregate test-level timing to file-level (for backwards compatibility)
+ */
+function aggregateTestsToFiles(data) {
+    const fileMap = new Map();
+    for (const testData of Object.values(data.tests)) {
+        const existing = fileMap.get(testData.file);
+        if (existing) {
+            existing.totalDuration += testData.duration;
+            existing.count += 1;
+            if (testData.lastRun > existing.lastRun) {
+                existing.lastRun = testData.lastRun;
+            }
+        }
+        else {
+            fileMap.set(testData.file, {
+                totalDuration: testData.duration,
+                count: 1,
+                lastRun: testData.lastRun,
+            });
+        }
+    }
+    const result = {};
+    for (const [file, stats] of fileMap) {
+        result[file] = {
+            duration: stats.totalDuration,
+            runs: stats.count,
+            lastRun: stats.lastRun,
+        };
+    }
+    return result;
+}
+/**
+ * Prune old entries from timing data (v1 - file-level)
+ *
+ * Removes entries that:
+ * 1. Haven't been run in more than `days` days
+ * 2. No longer exist in the current test files (if provided)
+ *
+ * @param data - Timing data to prune
+ * @param days - Number of days after which to remove entries
+ * @param currentFiles - Optional list of current test files (to remove deleted tests)
+ * @returns Pruned timing data
+ */
+export function pruneTimingData(data, days = DEFAULT_PRUNE_DAYS, currentFiles) {
+    if (isTimingDataV2(data)) {
+        return pruneTestTimingData(data, days, currentFiles);
+    }
+    const now = new Date();
+    const cutoffDate = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const currentFileSet = currentFiles ? new Set(currentFiles) : null;
+    const prunedFiles = {};
+    for (const [file, timing] of Object.entries(data.files)) {
+        const lastRun = new Date(timing.lastRun);
+        // Skip if too old
+        if (lastRun < cutoffDate) {
+            continue;
+        }
+        // Skip if file no longer exists (when currentFiles is provided)
+        if (currentFileSet && !currentFileSet.has(file)) {
+            continue;
+        }
+        prunedFiles[file] = timing;
+    }
+    return {
+        ...data,
+        updatedAt: new Date().toISOString(),
+        files: prunedFiles,
+    };
+}
+/**
+ * Prune old entries from timing data (v2 - test-level)
+ *
+ * @param data - Timing data to prune
+ * @param days - Number of days after which to remove entries
+ * @param currentTestIds - Optional list of current test IDs (to remove deleted tests)
+ * @returns Pruned timing data
+ */
+export function pruneTestTimingData(data, days = DEFAULT_PRUNE_DAYS, currentTestIds) {
+    const now = new Date();
+    const cutoffDate = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const currentTestSet = currentTestIds ? new Set(currentTestIds) : null;
+    const prunedTests = {};
+    for (const [testId, timing] of Object.entries(data.tests)) {
+        const lastRun = new Date(timing.lastRun);
+        // Skip if too old
+        if (lastRun < cutoffDate) {
+            continue;
+        }
+        // Skip if test no longer exists (when currentTestIds is provided)
+        if (currentTestSet && !currentTestSet.has(testId)) {
+            continue;
+        }
+        prunedTests[testId] = timing;
+    }
+    return {
+        ...data,
+        updatedAt: new Date().toISOString(),
+        tests: prunedTests,
+    };
+}
+/**
+ * Get duration for a file from timing data (v1)
+ *
+ * @param data - Timing data
+ * @param file - File name
+ * @returns Duration in ms, or undefined if not found
+ */
+export function getFileDuration(data, file) {
+    if (isTimingDataV1(data)) {
+        return data.files[file]?.duration;
+    }
+    // For v2 data, aggregate tests in this file
+    const fileTests = Object.entries(data.tests).filter(([, t]) => t.file === file);
+    if (fileTests.length === 0) {
+        return undefined;
+    }
+    return fileTests.reduce((sum, [, t]) => sum + t.duration, 0);
+}
+/**
+ * Get duration for a test from timing data (v2)
+ *
+ * @param data - Timing data (v2)
+ * @param testId - Test ID
+ * @returns Duration in ms, or undefined if not found
+ */
+export function getTestDuration(data, testId) {
+    return data.tests[testId]?.duration;
+}
+//# sourceMappingURL=timing-store.js.map

package/dist/core/timing-store.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Timing data for a single test file (legacy v1 format)
+ */
+export interface FileTimingData {
+    /** Duration in milliseconds */
+    duration: number;
+    /** Number of times this file has been measured */
+    runs: number;
+    /** ISO timestamp of last measurement */
+    lastRun: string;
+}
+/**
+ * Timing data for a single test (v2 format - test-level)
+ */
+export interface TestTimingData {
+    /** Source file containing this test */
+    file: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Number of times this test has been measured */
+    runs: number;
+    /** ISO timestamp of last measurement */
+    lastRun: string;
+}
+/**
+ * Complete timing data structure stored in cache (v1 - file-level)
+ */
+export interface TimingDataV1 {
+    /** Schema version (1) */
+    version: 1;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Map of file names to their timing data */
+    files: Record<string, FileTimingData>;
+}
+/**
+ * Complete timing data structure stored in cache (v2 - test-level)
+ */
+export interface TimingDataV2 {
+    /** Schema version (2) */
+    version: 2;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Map of test IDs to their timing data */
+    tests: Record<string, TestTimingData>;
+}
+/**
+ * Union type for timing data (supports both versions)
+ */
+export type TimingData = TimingDataV1 | TimingDataV2;
+/**
+ * Input for the shard assignment algorithm (file-level)
+ */
+export interface FileWithDuration {
+    /** File path (relative to test directory) */
+    file: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Whether the duration was estimated (no historical data) */
+    estimated: boolean;
+}
+/**
+ * Input for the shard assignment algorithm (test-level)
+ */
+export interface TestWithDuration {
+    /** Test ID in format: file::describe::testTitle */
+    testId: string;
+    /** Source file */
+    file: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Whether the duration was estimated (no historical data) */
+    estimated: boolean;
+}
+/**
+ * Output of the shard assignment algorithm (file-level)
+ */
+export interface ShardAssignment {
+    /** Shard index (1-based) */
+    shardIndex: number;
+    /** List of test files assigned to this shard */
+    files: string[];
+    /** Expected total duration in milliseconds */
+    expectedDuration: number;
+}
+/**
+ * Output of the shard assignment algorithm (test-level)
+ */
+export interface TestShardAssignment {
+    /** Shard index (1-based) */
+    shardIndex: number;
+    /** List of test IDs assigned to this shard */
+    tests: string[];
+    /** Expected total duration in milliseconds */
+    expectedDuration: number;
+}
+/**
+ * Complete result from the assign command (file-level)
+ */
+export interface AssignResult {
+    /** Map of shard index to list of files */
+    shards: Record<number, string[]>;
+    /** Expected duration per shard */
+    expectedDurations: Record<number, number>;
+    /** Total number of files */
+    totalFiles: number;
+    /** Files that had no timing data (estimated) */
+    estimatedFiles: string[];
+}
+/**
+ * Complete result from the assign command (test-level)
+ */
+export interface TestAssignResult {
+    /** Map of shard index to list of test IDs */
+    shards: Record<number, string[]>;
+    /** Map of shard index to grep pattern */
+    grepPatterns: Record<number, string>;
+    /** Expected duration per shard */
+    expectedDurations: Record<number, number>;
+    /** Total number of tests */
+    totalTests: number;
+    /** Tests that had no timing data (estimated) */
+    estimatedTests: string[];
+    /** Whether CKK found optimal solution (false = fell back to LPT) */
+    isOptimal: boolean;
+}
+/**
+ * Per-shard timing artifact uploaded after test run (file-level, v1)
+ */
+export interface ShardTimingArtifact {
+    /** Shard index (1-based) */
+    shard: number;
+    /** Browser project name */
+    project: string;
+    /** Map of file names to duration in ms */
+    files: Record<string, number>;
+}
+/**
+ * Per-shard timing artifact uploaded after test run (test-level, v2)
+ */
+export interface TestShardTimingArtifact {
+    /** Shard index (1-based) */
+    shard: number;
+    /** Browser project name */
+    project: string;
+    /** Map of test IDs to duration in ms */
+    tests: Record<string, number>;
+}
+/**
+ * Information about a discovered test
+ */
+export interface DiscoveredTest {
+    /** Source file path */
+    file: string;
+    /** Test title */
+    title: string;
+    /** Full title path (describe blocks + test title) */
+    titlePath: string[];
+    /** Unique test ID: file::describe::testTitle */
+    testId: string;
+}
+/**
+ * Playwright JSON report structure (relevant fields only)
+ */
+export interface PlaywrightReport {
+    suites: PlaywrightSuite[];
+}
+export interface PlaywrightSuite {
+    title: string;
+    file: string;
+    suites?: PlaywrightSuite[];
+    specs?: PlaywrightSpec[];
+}
+export interface PlaywrightSpec {
+    title: string;
+    tests: PlaywrightTest[];
+}
+export interface PlaywrightTest {
+    results: PlaywrightTestResult[];
+}
+export interface PlaywrightTestResult {
+    duration: number;
+    status: string;
+}
+/**
+ * Playwright --list JSON output structure
+ */
+export interface PlaywrightListOutput {
+    config: {
+        projects: Array<{
+            name: string;
+            testDir: string;
+        }>;
+    };
+    suites: PlaywrightListSuite[];
+}
+export interface PlaywrightListSuite {
+    title: string;
+    file: string;
+    suites?: PlaywrightListSuite[];
+    specs?: PlaywrightListSpec[];
+}
+export interface PlaywrightListSpec {
+    title: string;
+    file: string;
+    line: number;
+    column: number;
+}
+/** Current schema version for timing data */
+export declare const TIMING_DATA_VERSION = 2;
+/** Legacy schema version */
+export declare const TIMING_DATA_VERSION_V1 = 1;
+/**
+ * Create an empty timing data structure (v2 - test-level)
+ */
+export declare function createEmptyTimingData(): TimingDataV2;
+/**
+ * Create an empty timing data structure (v1 - file-level, for backwards compatibility)
+ */
+export declare function createEmptyTimingDataV1(): TimingDataV1;
+/**
+ * Build a test ID from file and title path
+ * Format: file::describe1::describe2::testTitle
+ */
+export declare function buildTestId(file: string, titlePath: string[]): string;
+/**
+ * Parse a test ID back to file and title path
+ */
+export declare function parseTestId(testId: string): {
+    file: string;
+    titlePath: string[];
+};
+/**
+ * Check if timing data is v2 (test-level)
+ */
+export declare function isTimingDataV2(data: TimingData): data is TimingDataV2;
+/**
+ * Check if timing data is v1 (file-level)
+ */
+export declare function isTimingDataV1(data: TimingData): data is TimingDataV1;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,54 @@
+/** Current schema version for timing data */
+export const TIMING_DATA_VERSION = 2;
+/** Legacy schema version */
+export const TIMING_DATA_VERSION_V1 = 1;
+/**
+ * Create an empty timing data structure (v2 - test-level)
+ */
+export function createEmptyTimingData() {
+    return {
+        version: TIMING_DATA_VERSION,
+        updatedAt: new Date().toISOString(),
+        tests: {},
+    };
+}
+/**
+ * Create an empty timing data structure (v1 - file-level, for backwards compatibility)
+ */
+export function createEmptyTimingDataV1() {
+    return {
+        version: TIMING_DATA_VERSION_V1,
+        updatedAt: new Date().toISOString(),
+        files: {},
+    };
+}
+/**
+ * Build a test ID from file and title path
+ * Format: file::describe1::describe2::testTitle
+ */
+export function buildTestId(file, titlePath) {
+    return [file, ...titlePath].join('::');
+}
+/**
+ * Parse a test ID back to file and title path
+ */
+export function parseTestId(testId) {
+    const parts = testId.split('::');
+    return {
+        file: parts[0] ?? '',
+        titlePath: parts.slice(1),
+    };
+}
+/**
+ * Check if timing data is v2 (test-level)
+ */
+export function isTimingDataV2(data) {
+    return data.version === 2;
+}
+/**
+ * Check if timing data is v1 (file-level)
+ */
+export function isTimingDataV1(data) {
+    return data.version === 1;
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAsOA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,OAAO,EAAE,sBAAsB;QAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,SAAmB;IAC3D,OAAO,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IAIxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACpB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,OAAO,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,OAAO,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @nsxbet/playwright-orchestrator
+ *
+ * Intelligent Playwright test distribution across CI shards
+ * using historical timing data.
+ */
+export * from './core/index.js';
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @nsxbet/playwright-orchestrator
+ *
+ * Intelligent Playwright test distribution across CI shards
+ * using historical timing data.
+ */
+export * from './core/index.js';
+export const VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}