@aqa-pulse/cli 0.1.0

package/dist/shared/test-history-helpers.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHistoryRowAnchor = buildHistoryRowAnchor;
+exports.formatRunsLabel = formatRunsLabel;
+exports.getRunWord = getRunWord;
+exports.formatTemplate = formatTemplate;
+exports.isStableHistoryItem = isStableHistoryItem;
+exports.isUnstableHistoryItem = isUnstableHistoryItem;
+exports.getUnstableHistoryItems = getUnstableHistoryItems;
+exports.getUnstableEventLabel = getUnstableEventLabel;
+exports.findLatestStableRecovery = findLatestStableRecovery;
+exports.findCurrentStabilityStreak = findCurrentStabilityStreak;
+exports.findUnstableStreakBeforeRecovery = findUnstableStreakBeforeRecovery;
+exports.formatCurrentStabilityDescription = formatCurrentStabilityDescription;
+exports.normalizeAnchorLookupValue = normalizeAnchorLookupValue;
+exports.buildStepAnchor = buildStepAnchor;
+exports.buildDiagnosticStepTree = buildDiagnosticStepTree;
+exports.findIncidentStepAnchor = findIncidentStepAnchor;
+exports.getAttachmentReference = getAttachmentReference;
+exports.buildAttachmentHref = buildAttachmentHref;
+exports.isImageAttachment = isImageAttachment;
+exports.isMarkdownAttachment = isMarkdownAttachment;
+exports.canInlineMarkdownPreview = canInlineMarkdownPreview;
+const dashboard_helpers_1 = require("./dashboard-helpers");
+const ru_1 = require("./i18n/ru");
+const HISTORY_TEXT = ru_1.ru.testHistory;
+function buildHistoryRowAnchor(runId) {
+    const normalizedId = runId
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return normalizedId.length > 0 ? `history-row-${normalizedId}` : 'history-row-run';
+}
+function formatRunsLabel(count) {
+    return `${count} ${getRunWord(count)}`;
+}
+function getRunWord(count) {
+    const remainder100 = count % 100;
+    const remainder10 = count % 10;
+    if (remainder100 >= 11 && remainder100 <= 14) {
+        return 'прогонов';
+    }
+    if (remainder10 === 1) {
+        return 'прогон';
+    }
+    if (remainder10 >= 2 && remainder10 <= 4) {
+        return 'прогона';
+    }
+    return 'прогонов';
+}
+function formatTemplate(template, values) {
+    return Object.entries(values).reduce((result, [key, value]) => result.replace(new RegExp(`\\{${key}\\}`, 'g'), value), template);
+}
+function isStableHistoryItem(item) {
+    return item.status === 'passed' && !item.flaky && !item.errorMessage;
+}
+function isUnstableHistoryItem(item) {
+    return Boolean(item.errorMessage)
+        || item.flaky
+        || item.status === 'failed'
+        || item.status === 'timedout'
+        || item.status === 'interrupted';
+}
+function getUnstableHistoryItems(history) {
+    return history.filter(isUnstableHistoryItem);
+}
+function getUnstableEventLabel(item) {
+    if (item.errorMessage) {
+        return HISTORY_TEXT.labels.error;
+    }
+    if (item.flaky) {
+        return HISTORY_TEXT.labels.flaky;
+    }
+    return (0, dashboard_helpers_1.formatStatusLabel)(item.status, false);
+}
+function findLatestStableRecovery(history) {
+    for (let index = 0; index < history.length - 1; index += 1) {
+        const currentItem = history[index];
+        const previousOlderItem = history[index + 1];
+        if (isStableHistoryItem(currentItem) && isUnstableHistoryItem(previousOlderItem)) {
+            return {
+                recovery: currentItem,
+                previousUnstable: previousOlderItem,
+            };
+        }
+    }
+    return null;
+}
+function findCurrentStabilityStreak(history) {
+    if (history.length === 0) {
+        return {
+            count: 0,
+            latestStable: null,
+            oldestStable: null,
+            previousUnstable: null,
+        };
+    }
+    let count = 0;
+    for (const item of history) {
+        if (!isStableHistoryItem(item)) {
+            break;
+        }
+        count += 1;
+    }
+    if (count === 0) {
+        return {
+            count: 0,
+            latestStable: null,
+            oldestStable: null,
+            previousUnstable: history[0] ?? null,
+        };
+    }
+    return {
+        count,
+        latestStable: history[0] ?? null,
+        oldestStable: history[count - 1] ?? null,
+        previousUnstable: history[count] ?? null,
+    };
+}
+function findUnstableStreakBeforeRecovery(history) {
+    const recoveryPair = findLatestStableRecovery(history);
+    if (!recoveryPair) {
+        return null;
+    }
+    const recoveryIndex = history.findIndex((item) => item.runId === recoveryPair.recovery.runId);
+    if (recoveryIndex < 0 || recoveryIndex === history.length - 1) {
+        return null;
+    }
+    const unstableItems = [];
+    for (let index = recoveryIndex + 1; index < history.length; index += 1) {
+        const currentItem = history[index];
+        if (!isUnstableHistoryItem(currentItem)) {
+            break;
+        }
+        unstableItems.push(currentItem);
+    }
+    if (unstableItems.length === 0) {
+        return null;
+    }
+    return {
+        count: unstableItems.length,
+        recovery: recoveryPair.recovery,
+        latestUnstable: unstableItems[0],
+        oldestUnstable: unstableItems[unstableItems.length - 1],
+    };
+}
+function formatCurrentStabilityDescription(streak) {
+    if (streak.count === 0) {
+        return HISTORY_TEXT.texts.streakNotStarted;
+    }
+    if (!streak.previousUnstable) {
+        return formatTemplate(HISTORY_TEXT.texts.streakWholeHistory, { count: String(streak.count) });
+    }
+    return formatTemplate(HISTORY_TEXT.texts.streakAfterEvent, {
+        count: String(streak.count),
+        event: getUnstableEventLabel(streak.previousUnstable),
+    });
+}
+function normalizeAnchorLookupValue(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const normalized = value.trim().replace(/\s+/g, ' ').toLowerCase();
+    return normalized.length > 0 ? normalized : null;
+}
+function buildStepAnchor(runId, attemptNumber, stepIndex) {
+    const runSlug = runId.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'run';
+    return `step-${runSlug}-a${attemptNumber}-s${stepIndex + 1}`;
+}
+function buildDiagnosticStepTree(steps) {
+    const roots = [];
+    const nodeStack = [];
+    steps.forEach((step, stepIndex) => {
+        const node = {
+            step,
+            stepIndex,
+            children: [],
+        };
+        while (nodeStack.length > 0 && nodeStack[nodeStack.length - 1].depth >= step.depth) {
+            nodeStack.pop();
+        }
+        const parentNode = nodeStack[nodeStack.length - 1]?.node ?? null;
+        if (parentNode) {
+            parentNode.children.push(node);
+        }
+        else {
+            roots.push(node);
+        }
+        nodeStack.push({ depth: step.depth, node });
+    });
+    return roots;
+}
+function findIncidentStepAnchor(history, input) {
+    const normalizedTarget = normalizeAnchorLookupValue(input.failureStepTitle);
+    if (!normalizedTarget) {
+        return null;
+    }
+    const latestRun = history[0];
+    const latestUnstable = getUnstableHistoryItems(history)[0];
+    const scopedCandidates = typeof input.failureStepRunId === 'string' && input.failureStepRunId.length > 0
+        ? history.filter((item) => item.runId === input.failureStepRunId)
+        : [];
+    const candidates = (scopedCandidates.length > 0 ? scopedCandidates : [latestRun, latestUnstable]).filter((item, index, collection) => Boolean(item) && collection.findIndex((candidate) => candidate?.runId === item?.runId) === index);
+    const normalizedCategory = normalizeAnchorLookupValue(input.failureStepCategory ?? null);
+    const normalizedErrorMessage = normalizeAnchorLookupValue(input.failureStepErrorMessage ?? null);
+    let bestMatch = null;
+    for (const item of candidates) {
+        for (const attempt of item.attemptDetails) {
+            if (typeof input.failureStepAttempt === 'number' && attempt.attempt !== input.failureStepAttempt) {
+                continue;
+            }
+            for (const [stepIndex, step] of attempt.steps.entries()) {
+                if (normalizeAnchorLookupValue(step.title) !== normalizedTarget) {
+                    continue;
+                }
+                let score = 1;
+                if (typeof input.failureStepOffsetMs === 'number' && step.offsetMs === input.failureStepOffsetMs) {
+                    score += 16;
+                }
+                if (normalizedCategory && normalizeAnchorLookupValue(step.category) === normalizedCategory) {
+                    score += 8;
+                }
+                if (normalizedErrorMessage && normalizeAnchorLookupValue(step.errorMessage) === normalizedErrorMessage) {
+                    score += 12;
+                }
+                if (typeof input.failureStepAttempt === 'number' && attempt.attempt === input.failureStepAttempt) {
+                    score += 10;
+                }
+                if (typeof input.failureStepRunId === 'string' && item.runId === input.failureStepRunId) {
+                    score += 10;
+                }
+                const anchor = buildStepAnchor(item.runId, attempt.attempt, stepIndex);
+                if (!bestMatch || score > bestMatch.score) {
+                    bestMatch = { anchor, score };
+                }
+            }
+        }
+    }
+    return bestMatch?.anchor ?? null;
+}
+function getAttachmentReference(attachment) {
+    return attachment.path ?? attachment.url ?? attachment.name;
+}
+function buildAttachmentHref(runId, attachment, artifactBasePath) {
+    if (attachment.url) {
+        return attachment.url;
+    }
+    if (!artifactBasePath || !attachment.path) {
+        return null;
+    }
+    const normalizedRunId = normalizeArtifactRunDirectory(runId);
+    const normalizedPath = attachment.path.replace(/\\/g, '/').replace(/^\/+/, '');
+    if (normalizedPath.includes('..') || /^(?:[a-z][a-z0-9+.-]*:|[a-z]:\/)/i.test(normalizedPath)) {
+        return null;
+    }
+    const resolvedArtifactPath = normalizedPath.startsWith(`${normalizedRunId}/`)
+        ? normalizedPath
+        : `${normalizedRunId}/${normalizedPath}`;
+    return `${artifactBasePath}/${encodeURIComponent(runId)}?path=${encodeURIComponent(resolvedArtifactPath)}`;
+}
+function isImageAttachment(attachment) {
+    const contentType = attachment.contentType?.toLowerCase() ?? '';
+    if (contentType.startsWith('image/')) {
+        return true;
+    }
+    return /\.(avif|bmp|gif|ico|jpe?g|png|svg|webp)$/i.test(getAttachmentReference(attachment));
+}
+function isMarkdownAttachment(attachment) {
+    const contentType = attachment.contentType?.toLowerCase() ?? '';
+    if (contentType.includes('markdown')) {
+        return true;
+    }
+    return /\.(md|markdown|mdx)$/i.test(getAttachmentReference(attachment));
+}
+function canInlineMarkdownPreview(href) {
+    if (!/^[a-z][a-z0-9+.-]*:/i.test(href)) {
+        return true;
+    }
+    if (typeof window === 'undefined') {
+        return false;
+    }
+    try {
+        return new URL(href, window.location.href).origin === window.location.origin;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeArtifactRunDirectory(runId) {
+    return runId
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'run';
+}

package/dist/shared/test-history-metric-info.d.ts

@@ -0,0 +1,17 @@
+export declare const TEST_HISTORY_METRIC_DESCRIPTIONS: {
+    readonly totalRuns: "Количество сохранённых прогонов, в которых найден именно этот тест с учётом текущих фильтров.";
+    readonly failedRuns: "Количество прогонов, в которых тест завершился неуспешно: failed, timedout или interrupted.";
+    readonly flakyRuns: "Количество прогонов, где тест был отмечен как flaky: падал на одной из попыток, но в итоге завершился успешно.";
+    readonly latestStatus: "Финальный статус теста в самом свежем найденном прогоне.";
+    readonly passRate: "Доля прогонов этого теста со статусом passed среди всех найденных запусков.";
+    readonly failRate: "Доля прогонов этого теста с неуспешным результатом: failed, timedout или interrupted.";
+    readonly flakyScore: "Сводная оценка нестабильности теста на шкале 0–100 с учётом fail rate, паттерна нестабильности и MTBF.";
+    readonly mtbf: "Среднее время между нестабильными прогонами теста. Чем больше значение, тем реже тест становится нестабильным.";
+    readonly timeline: "Хронологическая история прогонов теста с ключевыми метаданными, длительностью, повторами и ошибками.";
+    readonly archiveGaps: "Список run id, для которых запись есть в history.json, но архив исходного data.json уже недоступен.";
+    readonly latestEvent: "Самый свежий нестабильный эпизод для теста: последнее падение с текстом ошибки или последний flaky-прогон, если более свежей ошибки нет.";
+    readonly latestRecovery: "Самый свежий стабильный прогон после нестабильной серии. Показывается только если после падения или flaky был зафиксирован чистый passed-run без flakiness.";
+    readonly previousUnstableEvents: "Несколько предыдущих нестабильных эпизодов до самого свежего нестабильного прогона. Полезно для быстрого просмотра паттерна проблем без прокрутки всей таблицы.";
+    readonly currentStabilityStreak: "Текущая серия подряд идущих стабильных прогонов от самого свежего запуска назад. Стабильным считается только passed-run без flakiness и без текста ошибки.";
+    readonly unstableStreakBeforeRecovery: "Длина нестабильной серии непосредственно перед последним стабильным восстановлением. Помогает понять, какой по глубине был проблемный период до восстановления.";
+};

package/dist/shared/test-history-metric-info.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEST_HISTORY_METRIC_DESCRIPTIONS = void 0;
+exports.TEST_HISTORY_METRIC_DESCRIPTIONS = {
+    totalRuns: 'Количество сохранённых прогонов, в которых найден именно этот тест с учётом текущих фильтров.',
+    failedRuns: 'Количество прогонов, в которых тест завершился неуспешно: failed, timedout или interrupted.',
+    flakyRuns: 'Количество прогонов, где тест был отмечен как flaky: падал на одной из попыток, но в итоге завершился успешно.',
+    latestStatus: 'Финальный статус теста в самом свежем найденном прогоне.',
+    passRate: 'Доля прогонов этого теста со статусом passed среди всех найденных запусков.',
+    failRate: 'Доля прогонов этого теста с неуспешным результатом: failed, timedout или interrupted.',
+    flakyScore: 'Сводная оценка нестабильности теста на шкале 0–100 с учётом fail rate, паттерна нестабильности и MTBF.',
+    mtbf: 'Среднее время между нестабильными прогонами теста. Чем больше значение, тем реже тест становится нестабильным.',
+    timeline: 'Хронологическая история прогонов теста с ключевыми метаданными, длительностью, повторами и ошибками.',
+    archiveGaps: 'Список run id, для которых запись есть в history.json, но архив исходного data.json уже недоступен.',
+    latestEvent: 'Самый свежий нестабильный эпизод для теста: последнее падение с текстом ошибки или последний flaky-прогон, если более свежей ошибки нет.',
+    latestRecovery: 'Самый свежий стабильный прогон после нестабильной серии. Показывается только если после падения или flaky был зафиксирован чистый passed-run без flakiness.',
+    previousUnstableEvents: 'Несколько предыдущих нестабильных эпизодов до самого свежего нестабильного прогона. Полезно для быстрого просмотра паттерна проблем без прокрутки всей таблицы.',
+    currentStabilityStreak: 'Текущая серия подряд идущих стабильных прогонов от самого свежего запуска назад. Стабильным считается только passed-run без flakiness и без текста ошибки.',
+    unstableStreakBeforeRecovery: 'Длина нестабильной серии непосредственно перед последним стабильным восстановлением. Помогает понять, какой по глубине был проблемный период до восстановления.',
+};

package/dist/shared/text-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeHtml(value: unknown): string;
+export declare function normalizeOptionalText(value: string | null | undefined): string | null;

package/dist/shared/text-utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeHtml = escapeHtml;
+exports.normalizeOptionalText = normalizeOptionalText;
+function escapeHtml(value) {
+    return String(value ?? '')
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function normalizeOptionalText(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@aqa-pulse/cli",
+  "version": "0.1.0",
+  "description": "CLI для загрузки Playwright reports в AQA Pulse",
+  "license": "UNLICENSED",
+  "type": "commonjs",
+  "bin": {
+    "aqa-pulse": "bin/aqa-pulse.js"
+  },
+  "files": [
+    "bin/**/*",
+    "dist/**/*",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm --prefix ../../aqa-pulse run compile && node ./scripts/build.js",
+    "pack:check": "npm run build && npm pack --dry-run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    },
+    "playwright": {
+      "optional": true
+    },
+    "playwright-core": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}