allure 3.14.3 → 3.16.0

package/README.md

@@ -56,7 +56,15 @@ To hide specific labels use `--hide-labels` option:
 npx allure run --hide-labels=owner --hide-labels=tag -- npm test
 ```
 
-To successfully generate a report, ensure that your test setup outputs results into an `allure-results` directory, which is automatically detected by Allure 3. This directory can be placed at any nested level within your project (e.g., `out/tests/allure-results`), provided it retains the correct name.
+To successfully generate a report, ensure that your test setup outputs results into an `allure-results` directory. With `allure run` / `allure agent` / empty `allure watch`, directories named `allure-results` are discovered dynamically (name-based watcher). With one-shot commands such as `allure generate`, an empty CLI and unset `config.resultsDir` default to the `./**/allure-results` glob. Quote globs in the shell so they are not expanded early.
+
+You can also set `resultsDir` in the Allure config (`string | string[]`) or pass `--results-dir` on `run` / `agent`:
+
+```bash
+npx allure run --open --results-dir './artifacts/**/allure-results' -- npm test
+```
+
+Repeat `--results-dir` for multiple patterns. CLI overrides `config.resultsDir`.
 
 After the tests complete, the report is generated automatically. Existing results from previous runs are ignored, as Allure 3 focuses solely on new data to ensure accurate and up-to-date reporting.
 
@@ -165,7 +173,7 @@ npx allure --version
 
 ## Configuration
 
-Allure 3 uses an `allurerc.mjs` or `allurerc.js` configuration file to manage report settings, including the report name, output directory, and plugin options.
+Allure 3 uses an `allurerc.ts`, `allurerc.mts`, `allurerc.cts`, `allurerc.mjs`, or `allurerc.js` configuration file to manage report settings, including the report name, output directory, and plugin options.
 
 > [!TIP]
 > We recommend using the **Awesome** plugin for the best experience.  
@@ -191,7 +199,22 @@ export default defineConfig({
 });
 ```
 
-In this example, the generated report is named *Allure Report Example* and saved to the `./out/allure-report` directory. The **Awesome** plugin is enabled with options to produce a single-file HTML report in English.
+In this example, the generated report is named _Allure Report Example_ and saved to the `./out/allure-report` directory. The **Awesome** plugin is enabled with options to produce a single-file HTML report in English.
+
+### TypeScript Configuration File
+
+TypeScript configuration files are loaded directly by the Allure CLI, so you don't need to precompile them or install `tsx` or `ts-node`.
+
+```ts
+import type { AllureConfig } from "allure";
+
+export default {
+  name: "Allure Report Example",
+  output: "./out/allure-report",
+} satisfies AllureConfig;
+```
+
+For editor type checking, make sure the `allure` package is available to your project, for example as a local dev dependency. If you run Allure only as a global CLI, you can still use a TypeScript config without importing from `allure`.
 
 ### Configuration Options
 
@@ -199,17 +222,18 @@ The configuration file allows you to fine-tune report generation. Key options in
 
 - **`name`**: Specifies the report’s display name.
 - **`output`**: Defines the directory where the report will be saved.
-- **`hideLabels`** *(`(string | RegExp)[]`)*: Hides matching labels by name in report data. Currently, only Allure Awesome report respects the option. Labels with names starting with `_` are hidden by default.
+- **`resultsDir`** _(`string | string[]`)_: Glob patterns or paths used when reading Allure results directories. For one-shot commands, CLI positionals override this value. For `allure run` / `allure agent`, use repeated `--results-dir` (same override priority). When both CLI and `resultsDir` are empty, one-shot commands (`generate`, etc.) use `./**/allure-results`, while live commands (`run`, `agent`, empty `watch`) use name-based discovery of directories named `allure-results`. Quote globs in the shell.
+- **`hideLabels`** _(`(string | RegExp)[]`)_: Hides matching labels by name in report data. Currently, only Allure Awesome report respects the option. Labels with names starting with `_` are hidden by default.
 - **`plugins`**: Enables and configures plugins, with each supporting various options.
 
 ### Awesome Plugin Options
 
 The **Awesome** plugin offers several customizable options:
 
-- **`singleFile`** *(boolean)*: If set to `true`, generates the report as a single standalone HTML file.
-- **`reportName`** *(string)*: Overrides the default report name.
-- **`open`** *(boolean)*: Automatically opens the report after generation if enabled.
-- **`reportLanguage`** *(string)*: Sets the UI language of the report. Supported languages include:
+- **`singleFile`** _(boolean)_: If set to `true`, generates the report as a single standalone HTML file.
+- **`reportName`** _(string)_: Overrides the default report name.
+- **`open`** _(boolean)_: Automatically opens the report after generation if enabled.
+- **`reportLanguage`** _(string)_: Sets the UI language of the report. Supported languages include:
 
   `az`, `br`, `de`, `en`, `es`, `fr`, `he`, `ja`, `kr`, `nl`, `pl`, `ru`, `sv`, `tr`, `zh`.
 
@@ -217,11 +241,11 @@ For example, setting `"reportLanguage": "fr"` will render the report interface i
 
 ### Declarative configuration format
 
-You can also use `allurerc.json` or `allurerc.yaml` files as a declarative way to configure Allure 3.
+You can also use `allurerc.json`, `allurerc.yaml`, or `allurerc.yml` files as a declarative way to configure Allure 3.
 
 > [!WARNING]  
 > Declarative formats don't support advanced features such as tests filtering or environments.
-> If you need these features, please consider using the `allurerc.mjs` or `allurerc.js` files.
+> If you need these features, please consider using the `allurerc.ts`, `allurerc.mts`, `allurerc.cts`, `allurerc.mjs`, or `allurerc.js` files.
 
 ## Official CI/CD Integrations
 

package/dist/commands/agent-run.d.ts

@@ -32,6 +32,7 @@ export type ExecuteAgentModeParams = {
     rerunLabels?: string[];
     reportMode: AgentHumanReportMode;
     args: string[];
+    resultsPatterns?: readonly string[];
 };
 export declare const executeAgentMode: (params: ExecuteAgentModeParams) => Promise<void>;
 export type ExecuteAgentInspectModeParams = {

package/dist/commands/agent-run.js

@@ -8,7 +8,8 @@ import { AllureReport, isFileNotFoundError, readConfig } from "@allurereport/cor
 import { createAgentTestPlanContext, AgentUsageError, assertExplicitAgentOutputDirIsSafe, formatAgentOutputLinks, formatAgentRunSummary, isPathInside, loadAgentOutput, normalizeAgentRerunPreset, parseAgentLabelFilters, cleanupAgentRunState, cleanupStaleAgentRunStates, resolveAgentStateDir, writeAgentRunState, } from "@allurereport/plugin-agent";
 import { normalizeCommandEnvironmentOptions, resolveCommandEnvironment } from "../utils/environment.js";
 import { createChildAllureCliEnvironment, getActiveAllureCliCommand } from "../utils/execution-context.js";
-import { findAllureResultDirectories, findFilesByGlobs } from "../utils/fileSystem.js";
+import { findFilesByGlobs } from "../utils/fileSystem.js";
+import { resolveAndFindResultsDirs, resolveResultsPatterns } from "../utils/resultsPatterns.js";
 import { createAgentHumanReportConfig } from "./agent-human-report.js";
 import { executeAllureRun, executeNestedAllureCommand } from "./commons/run.js";
 export const formatAgentCommand = (args) => args.join(" ");
@@ -90,7 +91,7 @@ export const cleanupManagedAgentOutputs = async (params) => {
     }
 };
 export const executeAgentMode = async (params) => {
-    const { configPath, cwd: configuredCwd, output, expectations, inlineExpectations, environment, environmentName, silent, rerunFrom, rerunLatest, rerunPreset, rerunEnvironments, rerunLabels, reportMode, args, } = params;
+    const { configPath, cwd: configuredCwd, output, expectations, inlineExpectations, environment, environmentName, silent, rerunFrom, rerunLatest, rerunPreset, rerunEnvironments, rerunLabels, reportMode, args, resultsPatterns: cliResultsPatterns = [], } = params;
     const command = args[0];
     const commandArgs = args.slice(1);
     const cwd = await realpath(configuredCwd ?? process.cwd());
@@ -197,6 +198,7 @@ export const executeAgentMode = async (params) => {
             plugins: [...humanReport.plugins, ...(config.plugins ?? [])],
         });
         const knownIssues = await allureReport.store.allKnownIssues();
+        const resultsPatterns = resolveResultsPatterns(cliResultsPatterns, config.resultsDir);
         const { globalExitCode } = await executeAllureRun({
             allureReport,
             knownIssues,
@@ -210,6 +212,7 @@ export const executeAgentMode = async (params) => {
             silent: true,
             ignoreLogs: false,
             logProcessExit: false,
+            resultsPatterns,
         });
         await persistAgentRunState({
             runId,
@@ -240,13 +243,15 @@ export const executeAgentInspectMode = async (params) => {
     const { configPath, cwd: configuredCwd, output, expectations, inlineExpectations, environment, environmentName, reportName, open, port, historyLimit, hideLabels, dumps = [], reportMode, resultsDir, } = params;
     const cwd = await realpath(configuredCwd ?? process.cwd());
     const dumpFiles = dumps.length ? await findFilesByGlobs(cwd, dumps) : [];
-    const shouldReadResults = resultsDir.length > 0 || dumps.length === 0;
-    const { resultDirectories = [], patterns = resultsDir } = shouldReadResults
-        ? await findAllureResultDirectories(cwd, resultsDir)
-        : {};
     if (dumps.length > 0 && dumpFiles.length === 0) {
         throw new AgentUsageError(`No dump files found matching pattern: ${dumps.join(", ")}`);
     }
+    const resultsConfig = await readConfig(cwd, configPath);
+    const resolvedPatterns = resolveResultsPatterns(resultsDir, resultsConfig.resultsDir);
+    const shouldReadResults = resolvedPatterns.length > 0 || dumpFiles.length === 0;
+    const { resultDirectories = [], patterns = resolvedPatterns } = shouldReadResults
+        ? await resolveAndFindResultsDirs(cwd, resultsDir, resultsConfig.resultsDir)
+        : {};
     if (resultDirectories.length === 0 && dumpFiles.length === 0) {
         const inspectedPatterns = [...(patterns ?? []), ...dumps];
         throw new AgentUsageError(`No test results directories or dump files found matching pattern: ${inspectedPatterns}`);

package/dist/commands/agent.d.ts

@@ -35,6 +35,7 @@ export declare class AgentCommand extends Command {
     rerunPreset: string | undefined;
     rerunEnvironments: string[] | undefined;
     rerunLabels: string[] | undefined;
+    resultsDir: string[] | undefined;
     commandToRun: string[];
     execute(): Promise<void>;
 }

package/dist/commands/agent.js

@@ -6,6 +6,7 @@ import { dirname, join, resolve } from "node:path";
 import process, { exit } from "node:process";
 import { AGENT_FINDING_CATEGORIES, AGENT_FINDING_SEVERITIES, AGENT_TASK_MAP_HELP, AGENT_TEST_STATUSES, AgentExpectationUsageError, assertExplicitAgentOutputDirIsSafe, buildAgentInlineExpectations, buildAgentQueryPayload, cleanupAgentRunState, cleanupStaleAgentRunStates, createAgentCapabilities, formatAgentOutputLinks, isAgentExpectationUsageError, isAgentTaskMapHelpRequest, isAgentUsageError, loadAgentOutput, normalizeAgentQueryLimit, normalizeAgentQueryView, normalizeAgentRerunPreset, normalizeRepeatedEnumValues, normalizeRepeatedStringValues, parseAgentLabelFilters, readLatestAgentState, resolveAgentSelectionOutputDir, resolveAgentStateDir, selectAgentTestPlan, validateAgentExpectationsFile, writeAgentRunState, writeInvalidAgentExpectationOutput, } from "@allurereport/plugin-agent";
 import { Command, Option, UsageError } from "clipanion";
+import { parseRunCommand } from "../utils/resultsPatterns.js";
 export { AGENT_TASK_MAP_HELP, createAgentCapabilities, isAgentTaskMapHelpRequest };
 const readOptionalString = (value) => (typeof value === "string" ? value : undefined);
 const readOptionalBoolean = (value) => value === true;
@@ -125,7 +126,7 @@ export class AgentCommand extends Command {
     constructor() {
         super(...arguments);
         this.config = Option.String("--config,-c", {
-            description: "The path Allure config file",
+            description: "The path to Allure config file",
         });
         this.cwd = Option.String("--cwd", {
             description: "The working directory for the command to run (default: current working directory)",
@@ -195,18 +196,22 @@ export class AgentCommand extends Command {
         this.rerunLabels = Option.Array("--rerun-label", {
             description: "Filter rerun selection by exact label name=value. Repeat the option for multiple filters",
         });
+        this.resultsDir = Option.Array("--results-dir", {
+            description: "Glob pattern or path for Allure results directories (repeatable). Overrides config.resultsDir. Quote globs in the shell",
+        });
         this.commandToRun = Option.Rest();
     }
     async execute() {
-        const args = this.commandToRun.filter((arg) => arg !== "--");
+        const { command, commandArgs } = parseRunCommand(this.commandToRun);
+        if (!command) {
+            throw new UsageError("expecting command to be specified after --, e.g. allure agent -- npm run test");
+        }
+        const args = [command, ...commandArgs];
         const configPath = readOptionalString(this.config);
         const configuredCwd = readOptionalString(this.cwd);
         const output = readOptionalString(this.output);
         const reportMode = normalizeAgentHumanReportMode(readOptionalString(this.report));
         const expectations = readOptionalString(this.expectations);
-        if (!args.length) {
-            throw new UsageError("expecting command to be specified after --, e.g. allure agent -- npm run test");
-        }
         try {
             if (output) {
                 await assertExplicitAgentOutputDirIsSafe(resolve(await realpath(configuredCwd ?? process.cwd()), output));
@@ -250,6 +255,7 @@ export class AgentCommand extends Command {
                 rerunLabels: readOptionalStringArray(this.rerunLabels),
                 reportMode,
                 args,
+                resultsPatterns: this.resultsDir ?? [],
             });
         }
         catch (error) {
@@ -291,7 +297,8 @@ export class AgentCommand extends Command {
 AgentCommand.paths = [["agent"]];
 AgentCommand.usage = Command.Usage({
     description: "Run specified command in Allure agent mode",
-    details: "This command runs the specified command with an agent-mode Allure profile and optional human-readable report output. With the default --report auto mode, runs with 1000 or fewer stored visible logical results also write a single-file Awesome report at <output>/awesome/index.html and record its status in <output>/manifest/human-report.json. If a user asks for the report after a run, use `allure agent latest` to recover the output directory and check the human-report manifest before regenerating anything.",
+    details: "This command runs the specified command with an agent-mode Allure profile and optional human-readable report output. With the default --report auto mode, runs with 1000 or fewer stored visible logical results also write a single-file Awesome report at <output>/awesome/index.html and record its status in <output>/manifest/human-report.json. If a user asks for the report after a run, use `allure agent latest` to recover the output directory and check the human-report manifest before regenerating anything. " +
+        "Override results discovery with repeated `--results-dir` (CLI overrides `config.resultsDir`). Quote globs in the shell. When neither is set, directories named `allure-results` are discovered dynamically.",
     examples: [
         ["agent -- npm test", "Run npm test and capture agent-mode output with the default human report policy"],
         ["agent --report off -- npm test", "Run npm test and capture only the agent-mode artifacts"],
@@ -299,16 +306,20 @@ AgentCommand.usage = Command.Usage({
             "agent --expectations ./expected.yaml -- npm test",
             "Run npm test with agent-mode expectations loaded from ./expected.yaml",
         ],
+        [
+            "agent --results-dir './artifacts/**/allure-results' -- npm test",
+            "Override results discovery with a quoted glob",
+        ],
     ],
 });
 export class AgentInspectCommand extends Command {
     constructor() {
         super(...arguments);
         this.resultsDir = Option.Rest({
-            name: "Patterns to match test results directories in the current working directory (default: ./**/allure-results)",
+            name: "Patterns to match test results directories. Overrides config.resultsDir. Defaults to ./**/allure-results when neither is set.",
         });
         this.config = Option.String("--config,-c", {
-            description: "The path Allure config file",
+            description: "The path to Allure config file",
         });
         this.cwd = Option.String("--cwd", {
             description: "The working directory for resolving results and dumps (default: current working directory)",

package/dist/commands/allure2.js

@@ -5,15 +5,15 @@ import { AllureReport, readConfig } from "@allurereport/core";
 import Allure2Plugin from "@allurereport/plugin-allure2";
 import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
-import { findAllureResultDirectories } from "../utils/fileSystem.js";
+import { resolveAndFindResultsDirs } from "../utils/resultsPatterns.js";
 export class Allure2Command extends Command {
     constructor() {
         super(...arguments);
         this.resultsDir = Option.Rest({
-            name: "Patterns to match test results directories in the current working directory (default: ./**/allure-results)",
+            name: "Patterns to match test results directories. Overrides config.resultsDir. Defaults to ./**/allure-results when neither is set.",
         });
         this.config = Option.String("--config,-c", {
-            description: "The path Allure config file",
+            description: "The path to Allure config file",
         });
         this.cwd = Option.String("--cwd", {
             description: "The working directory for the command to run (default: current working directory)",
@@ -34,17 +34,11 @@ export class Allure2Command extends Command {
             description: "The path to history file",
         });
         this.knownIssues = Option.String("--known-issues", {
-            description: "Path to the known issues file. Updates the file and quarantines failed tests when specified",
+            description: "Path to known issues file",
         });
     }
     async execute() {
         const cwd = await realpath(this.cwd ?? process.cwd());
-        const { resultDirectories, patterns } = await findAllureResultDirectories(cwd, this.resultsDir);
-        if (!resultDirectories.length) {
-            console.error(red(`No test results directories found matching pattern: ${patterns}`));
-            exit(1);
-            return;
-        }
         const before = new Date().getTime();
         const defaultAllure2Options = {
             singleFile: this.singleFile ?? false,
@@ -56,6 +50,12 @@ export class Allure2Command extends Command {
             knownIssuesPath: this.knownIssues,
             historyPath: this.historyPath,
         });
+        const { resultDirectories, patterns } = await resolveAndFindResultsDirs(cwd, this.resultsDir, config.resultsDir);
+        if (!resultDirectories.length) {
+            console.error(red(`No test results directories found matching pattern: ${patterns}`));
+            exit(1);
+            return;
+        }
         config.plugins = [
             {
                 id: "allure2",

package/dist/commands/awesome.js

@@ -5,15 +5,15 @@ import { AllureReport, readConfig } from "@allurereport/core";
 import { default as AwesomePlugin } from "@allurereport/plugin-awesome";
 import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
-import { findAllureResultDirectories } from "../utils/fileSystem.js";
+import { resolveAndFindResultsDirs } from "../utils/resultsPatterns.js";
 export class AwesomeCommand extends Command {
     constructor() {
         super(...arguments);
         this.resultsDir = Option.Rest({
-            name: "Patterns to match test results directories in the current working directory (default: ./**/allure-results)",
+            name: "Patterns to match test results directories. Overrides config.resultsDir. Defaults to ./**/allure-results when neither is set.",
         });
         this.config = Option.String("--config,-c", {
-            description: "The path Allure config file",
+            description: "The path to Allure config file",
         });
         this.cwd = Option.String("--cwd", {
             description: "The working directory for the command to run (default: current working directory)",
@@ -40,7 +40,7 @@ export class AwesomeCommand extends Command {
             description: "The path to history file",
         });
         this.knownIssues = Option.String("--known-issues", {
-            description: "Path to the known issues file. Updates the file and quarantines failed tests when specified",
+            description: "Path to known issues file",
         });
         this.groupBy = Option.String("--group-by,-g", {
             description: "Group test results by labels. The labels should be separated by commas",
@@ -51,12 +51,6 @@ export class AwesomeCommand extends Command {
     }
     async execute() {
         const cwd = await realpath(this.cwd ?? process.cwd());
-        const { resultDirectories, patterns } = await findAllureResultDirectories(cwd, this.resultsDir);
-        if (!resultDirectories.length) {
-            console.error(red(`No test results directories found matching pattern: ${patterns}`));
-            exit(1);
-            return;
-        }
         const before = new Date().getTime();
         const hideLabels = this.hideLabels?.length ? this.hideLabels : undefined;
         const config = await readConfig(cwd, this.config, {
@@ -66,6 +60,12 @@ export class AwesomeCommand extends Command {
             historyPath: this.historyPath,
             hideLabels,
         });
+        const { resultDirectories, patterns } = await resolveAndFindResultsDirs(cwd, this.resultsDir, config.resultsDir);
+        if (!resultDirectories.length) {
+            console.error(red(`No test results directories found matching pattern: ${patterns}`));
+            exit(1);
+            return;
+        }
         const defaultAwesomeOptions = {
             singleFile: this.singleFile ?? false,
             logo: this.logo,

package/dist/commands/check.js

@@ -95,7 +95,7 @@ export class CheckCommand extends Command {
             description: "Add a tag to the check result. Repeat the option for multiple tags",
         });
         this.config = Option.String("--config,-c", {
-            description: "The path Allure config file",
+            description: "The path to Allure config file",
         });
         this.cwd = Option.String("--cwd", {
             description: "The working directory for the command to run (default: current working directory)",

package/dist/commands/classic.js

@@ -5,15 +5,15 @@ import { AllureReport, readConfig } from "@allurereport/core";
 import ClassicPlugin from "@allurereport/plugin-classic";
 import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
-import { findAllureResultDirectories } from "../utils/fileSystem.js";
+import { resolveAndFindResultsDirs } from "../utils/resultsPatterns.js";
 export class ClassicCommand extends Command {
     constructor() {
         super(...arguments);
         this.resultsDir = Option.Rest({
-            name: "Patterns to match test results directories in the current working directory (default: ./**/allure-results)",
+            name: "Patterns to match test results directories. Overrides config.resultsDir. Defaults to ./**/allure-results when neither is set.",
         });
         this.config = Option.String("--config,-c", {
-            description: "The path Allure config file",
+            description: "The path to Allure config file",
         });
         this.cwd = Option.String("--cwd", {
             description: "The working directory for the command to run (default: current working directory)",
@@ -34,17 +34,11 @@ export class ClassicCommand extends Command {
             description: "The path to history file",
         });
         this.knownIssues = Option.String("--known-issues", {
-            description: "Path to the known issues file. Updates the file and quarantines failed tests when specified",
+            description: "Path to known issues file",
         });
     }
     async execute() {
         const cwd = await realpath(this.cwd ?? process.cwd());
-        const { resultDirectories, patterns } = await findAllureResultDirectories(cwd, this.resultsDir);
-        if (!resultDirectories.length) {
-            console.error(red(`No test results directories found matching pattern: ${patterns}`));
-            exit(1);
-            return;
-        }
         const before = new Date().getTime();
         const defaultClassicOptions = {
             singleFile: this.singleFile ?? false,
@@ -56,6 +50,12 @@ export class ClassicCommand extends Command {
             knownIssuesPath: this.knownIssues,
             historyPath: this.historyPath,
         });
+        const { resultDirectories, patterns } = await resolveAndFindResultsDirs(cwd, this.resultsDir, config.resultsDir);
+        if (!resultDirectories.length) {
+            console.error(red(`No test results directories found matching pattern: ${patterns}`));
+            exit(1);
+            return;
+        }
         config.plugins = [
             {
                 id: "classic",

package/dist/commands/commons/generate.d.ts

@@ -2,6 +2,6 @@ import type { FullConfig } from "@allurereport/core";
 export declare const generate: (params: {
     cwd: string;
     config: FullConfig;
-    resultsDir: string[];
+    resultsDir?: string[];
     dump?: string[];
 }) => Promise<void>;

package/dist/commands/commons/generate.js

@@ -2,12 +2,16 @@ import { exit } from "node:process";
 import { AllureReport } from "@allurereport/core";
 import { KnownError } from "@allurereport/service";
 import { red } from "yoctocolors";
-import { findAllureResultDirectories, findFilesByGlobs } from "../../utils/fileSystem.js";
+import { findFilesByGlobs } from "../../utils/fileSystem.js";
 import { logError } from "../../utils/logs.js";
+import { resolveAndFindResultsDirs, resolveResultsPatterns } from "../../utils/resultsPatterns.js";
 export const generate = async (params) => {
     const dumpFiles = params?.dump?.length ? await findFilesByGlobs(params.cwd, params.dump) : [];
-    const { resultDirectories = [], patterns = params.resultsDir } = !!params?.resultsDir || dumpFiles.length === 0
-        ? await findAllureResultDirectories(params.cwd, params.resultsDir)
+    const cliPatterns = params.resultsDir ?? [];
+    const resolvedPatterns = resolveResultsPatterns(cliPatterns, params.config.resultsDir);
+    const shouldReadResults = resolvedPatterns.length > 0 || dumpFiles.length === 0;
+    const { resultDirectories = [], patterns = resolvedPatterns } = shouldReadResults
+        ? await resolveAndFindResultsDirs(params.cwd, cliPatterns, params.config.resultsDir)
         : {};
     if (resultDirectories.length === 0 && dumpFiles.length === 0) {
         console.error(red(`No test results directories found matching pattern: ${patterns}`));

package/dist/commands/commons/resultsDiscovery.d.ts

@@ -0,0 +1,5 @@
+import type { Watcher } from "@allurereport/directory-watcher";
+export declare const allureResultsDirectoriesGlobWatcher: (cwd: string, patterns: readonly string[], update: (newAllureResults: Set<string>, deletedAllureResults: Set<string>) => Promise<void>, options?: {
+    indexDelay?: number;
+    abortController?: AbortController;
+}) => Watcher;

package/dist/commands/commons/resultsDiscovery.js

@@ -0,0 +1,17 @@
+import { difference, watch } from "@allurereport/directory-watcher";
+import { findDirectoriesByGlobs } from "../../utils/fileSystem.js";
+export const allureResultsDirectoriesGlobWatcher = (cwd, patterns, update, options = {}) => {
+    const { abortController = new AbortController(), indexDelay = 600 } = options;
+    let previousAllureResults = new Set();
+    const callback = async () => {
+        if (abortController.signal.aborted) {
+            return;
+        }
+        const matched = await findDirectoriesByGlobs(cwd, patterns);
+        const currentAllureResults = new Set(matched);
+        const [added, deleted] = difference(previousAllureResults, currentAllureResults);
+        await update(added, deleted);
+        previousAllureResults = currentAllureResults;
+    };
+    return watch(callback, callback, callback, { indexDelay, abortController });
+};

package/dist/commands/commons/run.d.ts

@@ -6,6 +6,7 @@ export type TestProcessResult = {
     stdout: string;
     stderr: string;
     qualityGateResults: QualityGateValidationResult[];
+    fastFailed: boolean;
 };
 export type RunLogsMode = "pipe" | "inherit" | "ignore";
 export declare const executeNestedAllureCommand: (params: {
@@ -27,6 +28,7 @@ export declare const runTests: (params: {
     silent?: boolean;
     logs?: RunLogsMode;
     logProcessExit?: boolean;
+    resultsPatterns?: readonly string[];
 }) => Promise<TestProcessResult | null>;
 export declare const executeAllureRun: (params: {
     allureReport: AllureReport;
@@ -42,6 +44,7 @@ export declare const executeAllureRun: (params: {
     ignoreLogs?: boolean;
     maxRerun?: number;
     logProcessExit?: boolean;
+    resultsPatterns?: readonly string[];
 }) => Promise<{
     globalExitCode: ExitCode;
     testProcessResult: TestProcessResult | null;