allure 3.15.0 → 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.
 
@@ -191,7 +199,7 @@ 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
 
@@ -214,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`.
 

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)",
@@ -39,12 +39,6 @@ export class Allure2Command 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 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)",
@@ -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)",
@@ -39,12 +39,6 @@ export class ClassicCommand 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 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

@@ -28,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;
@@ -43,6 +44,7 @@ export declare const executeAllureRun: (params: {
     ignoreLogs?: boolean;
     maxRerun?: number;
     logProcessExit?: boolean;
+    resultsPatterns?: readonly string[];
 }) => Promise<{
     globalExitCode: ExitCode;
     testProcessResult: TestProcessResult | null;

package/dist/commands/commons/run.js

@@ -14,6 +14,7 @@ import { red } from "yoctocolors";
 import { logTests, runProcess, terminationOf } from "../../utils/index.js";
 import { logError } from "../../utils/logs.js";
 import { stopProcessTree } from "../../utils/process.js";
+import { allureResultsDirectoriesGlobWatcher } from "./resultsDiscovery.js";
 export const executeNestedAllureCommand = async (params) => {
     const nestedProcess = runProcess({
         command: params.command,
@@ -24,8 +25,16 @@ export const executeNestedAllureCommand = async (params) => {
     });
     return await terminationOf(nestedProcess);
 };
+const attachResultsDirectoryWatchers = (params) => {
+    if (params.resultsPatterns.length > 0) {
+        return allureResultsDirectoriesGlobWatcher(params.cwd, params.resultsPatterns, params.onUpdate, {
+            indexDelay: 600,
+        });
+    }
+    return allureResultsDirectoriesWatcher(params.cwd, params.onUpdate, { indexDelay: 600 });
+};
 export const runTests = async (params) => {
-    const { allureReport, knownIssues, cwd, command, commandArgs, logs, environmentVariables, environment, withQualityGate, silent, logProcessExit = true, } = params;
+    const { allureReport, knownIssues, cwd, command, commandArgs, logs, environmentVariables, environment, withQualityGate, silent, logProcessExit = true, resultsPatterns = [], } = params;
     let testProcessStarted = false;
     const allureResultsWatchers = new Map();
     const processWatcher = delayedFileProcessingWatcher(async (path) => {
@@ -34,28 +43,32 @@ export const runTests = async (params) => {
         indexDelay: 200,
         minProcessingDelay: 1000,
     });
-    const allureResultsWatch = allureResultsDirectoriesWatcher(cwd, async (newAllureResults, deletedAllureResults) => {
-        for (const delAr of deletedAllureResults) {
-            const watcher = allureResultsWatchers.get(delAr);
-            if (watcher) {
-                await watcher.abort();
+    const allureResultsWatch = attachResultsDirectoryWatchers({
+        cwd,
+        resultsPatterns,
+        onUpdate: async (newAllureResults, deletedAllureResults) => {
+            for (const delAr of deletedAllureResults) {
+                const watcher = allureResultsWatchers.get(delAr);
+                if (watcher) {
+                    await watcher.abort();
+                }
+                allureResultsWatchers.delete(delAr);
             }
-            allureResultsWatchers.delete(delAr);
-        }
-        for (const newAr of newAllureResults) {
-            if (allureResultsWatchers.has(newAr)) {
-                continue;
+            for (const newAr of newAllureResults) {
+                if (allureResultsWatchers.has(newAr)) {
+                    continue;
+                }
+                const watcher = newFilesInDirectoryWatcher(newAr, async (path) => {
+                    await processWatcher.addFile(path);
+                }, {
+                    ignoreInitial: !testProcessStarted,
+                    indexDelay: 300,
+                });
+                allureResultsWatchers.set(newAr, watcher);
+                await watcher.initialScan();
             }
-            const watcher = newFilesInDirectoryWatcher(newAr, async (path) => {
-                await processWatcher.addFile(path);
-            }, {
-                ignoreInitial: !testProcessStarted,
-                indexDelay: 300,
-            });
-            allureResultsWatchers.set(newAr, watcher);
-            await watcher.initialScan();
-        }
-    }, { indexDelay: 600 });
+        },
+    });
     await allureResultsWatch.initialScan();
     testProcessStarted = true;
     const beforeProcess = Date.now();
@@ -148,7 +161,7 @@ export const runTests = async (params) => {
     };
 };
 export const executeAllureRun = async (params) => {
-    const { allureReport, knownIssues, cwd, command, commandArgs, environmentVariables = {}, environment, withQualityGate, silent, logs, ignoreLogs, maxRerun = 0, logProcessExit = true, } = params;
+    const { allureReport, knownIssues, cwd, command, commandArgs, environmentVariables = {}, environment, withQualityGate, silent, logs, ignoreLogs, maxRerun = 0, logProcessExit = true, resultsPatterns = [], } = params;
     await allureReport.start();
     const globalExitCode = {
         original: 0,
@@ -169,6 +182,7 @@ export const executeAllureRun = async (params) => {
             environmentVariables,
             withQualityGate,
             logProcessExit,
+            resultsPatterns,
         });
         const allFailuresAfterInitialRun = await allureReport.store.failedTestResults();
         const blockingFailuresAfterInitialRun = await allureReport.store.blockingFailedTestResults();
@@ -203,6 +217,7 @@ export const executeAllureRun = async (params) => {
                 },
                 withQualityGate,
                 logProcessExit,
+                resultsPatterns,
             });
             await rm(tmpDir, { recursive: true });
             logTests(await allureReport.store.allTestResults());

package/dist/commands/csv.js

@@ -6,15 +6,15 @@ import { AllureReport, readConfig } from "@allurereport/core";
 import CsvPlugin from "@allurereport/plugin-csv";
 import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
-import { findAllureResultDirectories } from "../utils/fileSystem.js";
+import { resolveAndFindResultsDirs } from "../utils/resultsPatterns.js";
 export class CsvCommand 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,12 +34,6 @@ export class CsvCommand 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 defaultCsvOptions = {
             separator: this.separator ?? ",",
@@ -49,6 +43,12 @@ export class CsvCommand extends Command {
         const config = await readConfig(cwd, this.config, {
             knownIssuesPath: this.knownIssues,
         });
+        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: "csv",

package/dist/commands/dashboard.js

@@ -5,15 +5,15 @@ import { AllureReport, readConfig } from "@allurereport/core";
 import DashboardPlugin from "@allurereport/plugin-dashboard";
 import { Command, Option } from "clipanion";
 import { red } from "yoctocolors";
-import { findAllureResultDirectories } from "../utils/fileSystem.js";
+import { resolveAndFindResultsDirs } from "../utils/resultsPatterns.js";
 export class DashboardCommand 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)",
@@ -39,12 +39,6 @@ export class DashboardCommand 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 defaultDashboardOptions = {
             singleFile: this.singleFile ?? false,
@@ -56,6 +50,12 @@ export class DashboardCommand extends Command {
             output: this.output,
             name: this.reportName,
         });
+        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: "dashboard",

package/dist/commands/generate.js

@@ -7,10 +7,10 @@ export class GenerateCommand 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.output = Option.String("--output,-o", {
             description: "The output directory name. Absolute paths are accepted as well (default: allure-report)",