allure 3.13.2 → 3.14.1

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

@@ -5,6 +5,11 @@ export declare const formatAgentInspectCommand: (params: {
     resultsDir?: string[];
 }) => string;
 export declare const printAgentOutputLinks: (outputDir: string) => void;
+export declare const printAgentRunStart: (outputDir: string, commandString: string) => void;
+export declare const printAgentRunSummary: (outputDir: string, options?: {
+    durationMs?: number;
+    rerunCommand?: string;
+}) => Promise<void>;
 export declare const persistAgentRunState: (value: Parameters<typeof writeAgentRunState>[0]) => Promise<void>;
 export declare const cleanupManagedAgentOutputs: (params: {
     cwd: string;

package/dist/commands/agent-run.js

@@ -5,7 +5,7 @@ import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
 import process, { exit } from "node:process";
 import { AllureReport, isFileNotFoundError, readConfig } from "@allurereport/core";
-import { createAgentTestPlanContext, AgentUsageError, formatAgentOutputLinks, isPathInside, normalizeAgentRerunPreset, parseAgentLabelFilters, cleanupAgentRunState, cleanupStaleAgentRunStates, resolveAgentStateDir, writeAgentRunState, } from "@allurereport/plugin-agent";
+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";
@@ -24,6 +24,29 @@ export const printAgentOutputLinks = (outputDir) => {
         console.log(line);
     }
 };
+export const printAgentRunStart = (outputDir, commandString) => {
+    console.log(`agent output: ${outputDir}`);
+    console.log(commandString);
+    console.log("live: read manifest/test-events.jsonl (appended per test) in that directory to watch progress before the run finishes");
+};
+export const printAgentRunSummary = async (outputDir, options = {}) => {
+    try {
+        const bundle = await loadAgentOutput(outputDir);
+        const summary = formatAgentRunSummary({
+            outputDir,
+            run: bundle.run,
+            humanReport: bundle.humanReport,
+            durationMs: options.durationMs,
+            rerunCommand: options.rerunCommand,
+        });
+        for (const line of summary) {
+            console.log(line);
+        }
+    }
+    catch {
+        printAgentOutputLinks(outputDir);
+    }
+};
 export const persistAgentRunState = async (value) => {
     try {
         await writeAgentRunState(value);
@@ -89,6 +112,8 @@ export const executeAgentMode = async (params) => {
         ...createChildAllureCliEnvironment("agent"),
         ...(rerunContext ? { ALLURE_TESTPLAN_PATH: rerunContext.testPlanPath } : {}),
     };
+    let resolvedExitCode = -1;
+    let runCompleted = false;
     try {
         if (getActiveAllureCliCommand()) {
             console.log(commandString);
@@ -99,7 +124,8 @@ export const executeAgentMode = async (params) => {
                 ...(rerunContext ? { environmentVariables: { ALLURE_TESTPLAN_PATH: rerunContext.testPlanPath } } : {}),
                 silent,
             });
-            exit(exitCode ?? -1);
+            resolvedExitCode = exitCode ?? -1;
+            runCompleted = true;
             return;
         }
         const runId = randomUUID();
@@ -114,6 +140,9 @@ export const executeAgentMode = async (params) => {
         if (expectationsPath && isPathInside(outputDir, expectationsPath)) {
             throw new AgentUsageError(`--expectations path ${JSON.stringify(expectationsPath)} must not be inside the agent output directory ${JSON.stringify(outputDir)}`);
         }
+        if (!managedOutput) {
+            await assertExplicitAgentOutputDirIsSafe(outputDir);
+        }
         const humanReport = await createAgentHumanReportConfig({
             mode: reportMode,
             cwd,
@@ -155,14 +184,7 @@ export const executeAgentMode = async (params) => {
             status: "running",
             pid: process.pid,
         });
-        printAgentOutputLinks(outputDir);
-        if (expectationsPath) {
-            console.log(`agent expectations: ${expectationsPath}`);
-        }
-        else if (inlineExpectations) {
-            console.log("agent expectations: CLI options");
-        }
-        console.log(commandString);
+        printAgentRunStart(outputDir, commandString);
         const allureReport = new AllureReport({
             ...config,
             output: outputDir,
@@ -185,7 +207,7 @@ export const executeAgentMode = async (params) => {
             environment: resolvedEnvironment?.id,
             withQualityGate: false,
             logs: "pipe",
-            silent,
+            silent: true,
             ignoreLogs: false,
             logProcessExit: false,
         });
@@ -203,10 +225,15 @@ export const executeAgentMode = async (params) => {
             pid: process.pid,
         });
         await cleanupManagedAgentOutputs({ cwd, runId, managedOutput });
-        exit(globalExitCode.actual ?? globalExitCode.original);
+        await printAgentRunSummary(outputDir, { durationMs: Date.now() - startedAt, rerunCommand: commandString });
+        resolvedExitCode = globalExitCode.actual ?? globalExitCode.original;
+        runCompleted = true;
     }
     finally {
         await rerunContext?.cleanup();
+        if (runCompleted) {
+            exit(resolvedExitCode);
+        }
     }
 };
 export const executeAgentInspectMode = async (params) => {
@@ -238,6 +265,9 @@ export const executeAgentInspectMode = async (params) => {
     if (expectationsPath && isPathInside(outputDir, expectationsPath)) {
         throw new AgentUsageError(`--expectations path ${JSON.stringify(expectationsPath)} must not be inside the agent output directory ${JSON.stringify(outputDir)}`);
     }
+    if (!managedOutput) {
+        await assertExplicitAgentOutputDirIsSafe(outputDir);
+    }
     const historyLimitValue = historyLimit ? parseInt(historyLimit, 10) : undefined;
     const humanReport = await createAgentHumanReportConfig({
         mode: reportMode,
@@ -292,13 +322,6 @@ export const executeAgentInspectMode = async (params) => {
         status: "running",
         pid: process.pid,
     });
-    printAgentOutputLinks(outputDir);
-    if (expectationsPath) {
-        console.log(`agent expectations: ${expectationsPath}`);
-    }
-    else if (inlineExpectations) {
-        console.log("agent expectations: CLI options");
-    }
     console.log(commandString);
     const allureReport = new AllureReport({
         ...config,
@@ -331,5 +354,6 @@ export const executeAgentInspectMode = async (params) => {
         pid: process.pid,
     });
     await cleanupManagedAgentOutputs({ cwd, runId, managedOutput });
+    await printAgentRunSummary(outputDir, { durationMs: Date.now() - startedAt });
     exit(0);
 };

package/dist/commands/agent.js

@@ -4,7 +4,7 @@ import { mkdir, mkdtemp, realpath, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 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, 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 { 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";
 export { AGENT_TASK_MAP_HELP, createAgentCapabilities, isAgentTaskMapHelpRequest };
 const readOptionalString = (value) => (typeof value === "string" ? value : undefined);
@@ -208,6 +208,9 @@ export class AgentCommand extends Command {
             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));
+            }
             const inlineExpectations = buildInlineExpectationsFromOptions({
                 goal: this.goal,
                 taskId: this.taskId,
@@ -389,6 +392,9 @@ export class AgentInspectCommand extends Command {
             throw new UsageError("agent inspect does not run commands; pass result directories directly, e.g. allure agent inspect ./allure-results");
         }
         try {
+            if (output) {
+                await assertExplicitAgentOutputDirIsSafe(resolve(await realpath(configuredCwd ?? process.cwd()), output));
+            }
             const inlineExpectations = buildInlineExpectationsFromOptions({
                 goal: this.goal,
                 taskId: this.taskId,
@@ -502,12 +508,13 @@ export class AgentLatestCommand extends Command {
             latestState = await readLatestAgentState(cwd);
         }
         catch (error) {
-            console.error(`Could not read the latest agent output for ${cwd}: ${error.message}`);
+            console.error(`Could not read the latest Allure agent output for ${cwd}: ${error.message}. ` +
+                "Check the state directory printed by `allure agent state-dir`, or set ALLURE_AGENT_STATE_DIR to a writable path.");
             exit(1);
             return;
         }
         if (!latestState) {
-            console.error(`No latest agent output found for ${cwd}`);
+            console.error(`No recorded Allure agent output for ${cwd}. Run \`allure agent <command>\` first to create one.`);
             exit(1);
             return;
         }
@@ -678,7 +685,9 @@ export class AgentSelectCommand extends Command {
                 labelFilters: parseAgentLabelFilters(labels),
             });
             if (!selection.testPlan.tests.length) {
-                console.error(`No tests matched selection in ${selection.outputDir}`);
+                console.error(`No tests matched selection in ${selection.outputDir}. ` +
+                    "Adjust --preset (review|failed|unsuccessful|all), --label, or --environment, " +
+                    "or pick a different run with --from/--latest.");
                 exit(1);
                 return;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "allure",
-  "version": "3.13.2",
+  "version": "3.14.1",
   "description": "Allure Commandline Tool",
   "keywords": [
     "allure",
@@ -32,26 +32,26 @@
     "lint:fix": "oxlint --import-plugin --fix src test features stories"
   },
   "dependencies": {
-    "@allurereport/charts-api": "3.13.2",
-    "@allurereport/ci": "3.13.2",
-    "@allurereport/core": "3.13.2",
-    "@allurereport/core-api": "3.13.2",
-    "@allurereport/directory-watcher": "3.13.2",
-    "@allurereport/plugin-agent": "3.13.2",
-    "@allurereport/plugin-allure2": "3.13.2",
-    "@allurereport/plugin-api": "3.13.2",
-    "@allurereport/plugin-awesome": "3.13.2",
-    "@allurereport/plugin-classic": "3.13.2",
-    "@allurereport/plugin-csv": "3.13.2",
-    "@allurereport/plugin-dashboard": "3.13.2",
-    "@allurereport/plugin-jira": "3.13.2",
-    "@allurereport/plugin-log": "3.13.2",
-    "@allurereport/plugin-progress": "3.13.2",
-    "@allurereport/plugin-server-reload": "3.13.2",
-    "@allurereport/plugin-slack": "3.13.2",
-    "@allurereport/reader-api": "3.13.2",
-    "@allurereport/service": "3.13.2",
-    "@allurereport/static-server": "3.13.2",
+    "@allurereport/charts-api": "3.14.1",
+    "@allurereport/ci": "3.14.1",
+    "@allurereport/core": "3.14.1",
+    "@allurereport/core-api": "3.14.1",
+    "@allurereport/directory-watcher": "3.14.1",
+    "@allurereport/plugin-agent": "3.14.1",
+    "@allurereport/plugin-allure2": "3.14.1",
+    "@allurereport/plugin-api": "3.14.1",
+    "@allurereport/plugin-awesome": "3.14.1",
+    "@allurereport/plugin-classic": "3.14.1",
+    "@allurereport/plugin-csv": "3.14.1",
+    "@allurereport/plugin-dashboard": "3.14.1",
+    "@allurereport/plugin-jira": "3.14.1",
+    "@allurereport/plugin-log": "3.14.1",
+    "@allurereport/plugin-progress": "3.14.1",
+    "@allurereport/plugin-server-reload": "3.14.1",
+    "@allurereport/plugin-slack": "3.14.1",
+    "@allurereport/reader-api": "3.14.1",
+    "@allurereport/service": "3.14.1",
+    "@allurereport/static-server": "3.14.1",
     "adm-zip": "^0.5.16",
     "clipanion": "^4.0.0-rc.4",
     "glob": "^13.0.6",