@allurereport/plugin-agent 3.18.0 → 3.19.1

package/README.md

@@ -23,7 +23,7 @@ When enabled, the plugin writes:
 
 - `index.md` with run summary, advisory findings, expected-scope overview, and links to every logical test
 - `manifest/test-events.jsonl` as the append-only live event stream while the run is active
-- one markdown file per logical test under `tests/<environment>/<historyId-or-trId>.md`
+- one markdown file per logical test under `tests/<environment>/<retryHash-or-trId>.md`
 - `manifest/run.json`, `manifest/tests.jsonl`, and `manifest/findings.jsonl` for machine-readable review
 - copied run logs and other artifacts under `artifacts/`
 - `AGENTS.md` with guidance for consuming the directory

package/dist/guidance.js

@@ -92,7 +92,7 @@ export const ENRICHMENT_ACTIONS_BY_CHECK_NAME = {
     "history-id-collision": {
         category: "repair-test-metadata",
         title: "Repair logical test identity",
-        guidance: "Use stable, unique history IDs so distinct logical tests do not collapse into one file.",
+        guidance: "Retry hashes are computed automatically. When retryHash is absent, the agent uses the test-result ID for the filename, not the legacy historyId; do not set hashes manually.",
     },
     "expected-step-containing-missing": {
         category: "add-meaningful-steps",
@@ -332,7 +332,7 @@ export const renderAgentsGuide = () => `# AGENTS Guide
 2. Tail \`manifest/test-events.jsonl\` for the newest structured updates while the run is active.
 3. Open \`index.md\` for run-level status, scope summary, and the highest-priority findings.
 4. If a human-readable report is needed, read \`manifest/human-report.json\`; when status is \`generated\`, open the recorded path such as \`awesome/index.html\`.
-5. Open the relevant file under \`tests/<environment>/<historyId-or-trId>.md\` for evidence review.
+5. Open the relevant file under \`tests/<environment>/<retryHash-or-trId>.md\` for evidence review.
 6. Follow links into \`.assets/\` for test-scoped artifacts and into \`artifacts/global/\` for command-named process logs such as stdout and stderr.
 
 ## Directory Contract

package/dist/harness.d.ts

@@ -200,7 +200,7 @@ export type AgentRunManifest = {
 };
 export type AgentTestManifestLine = {
     environment_id: string;
-    history_id: string | null;
+    retry_hash: string | null;
     test_result_id: string;
     full_name: string;
     package: string | null;

package/dist/harness.js

@@ -100,6 +100,14 @@ const readJsonl = async (path) => (await readFile(path, "utf-8"))
     .split("\n")
     .filter(Boolean)
     .map((line) => JSON.parse(line));
+const normalizeAgentTestManifestLine = (input) => {
+    const { history_id: legacyHistoryId, retry_hash: retryHash, ...test } = input;
+    const canonicalRetryHash = "retry_hash" in input ? (retryHash ?? null) : (legacyHistoryId ?? null);
+    return {
+        ...test,
+        retry_hash: canonicalRetryHash,
+    };
+};
 const countByActionCategory = (items) => items.reduce((counts, item) => {
     counts[item.category] += 1;
     return counts;
@@ -201,7 +209,7 @@ export const loadAgentOutput = async (outputDir) => {
     let tests;
     let findings;
     try {
-        tests = await readJsonl(join(absoluteOutputDir, "manifest", "tests.jsonl"));
+        tests = (await readJsonl(join(absoluteOutputDir, "manifest", "tests.jsonl"))).map(normalizeAgentTestManifestLine);
         findings = await readJsonl(join(absoluteOutputDir, "manifest", "findings.jsonl"));
     }
     catch {

package/dist/plugin.js

@@ -1253,7 +1253,7 @@ const renderTestFile = (params) => {
         `- Name: ${escapeInlineMarkdown(tr.name)}`,
         `- Full Name: ${escapeInlineMarkdown(tr.fullName ?? tr.name)}`,
         `- Environment: ${escapeInlineMarkdown(environmentId)}`,
-        `- History ID: ${escapeInlineMarkdown(tr.historyId ?? "n/a")}`,
+        `- Retry hash: ${escapeInlineMarkdown(tr.retryHash ?? "n/a")}`,
         `- Test Result ID: ${escapeInlineMarkdown(tr.id)}`,
         `- Status: ${statusLabel(tr.status)}`,
         `- Duration: ${formatDurationValue(tr.duration)}`,
@@ -2209,10 +2209,10 @@ const buildRunAndTestFindings = (params) => {
                 severity: "warning",
                 category: "metadata",
                 checkName: "history-id-collision",
-                message: "Multiple visible tests shared the same history ID in this environment.",
+                message: "Multiple visible tests shared the same retry hash in this environment.",
                 explanation: "The output had to suffix the markdown file name because the logical test key was not unique within the environment.",
                 evidencePaths: [entry.relativePath],
-                remediationHint: "Ensure the test metadata produces unique history IDs for distinct logical tests.",
+                remediationHint: "Ensure the test metadata produces unique retry hashes for distinct logical tests.",
                 confidence: 0.85,
             }));
         }
@@ -2342,7 +2342,7 @@ const listVisibleTestLayouts = async (params) => {
         const rawEnvironmentId = (await store.environmentIdByTrId(tr.id)) ?? "default";
         const environmentId = rawEnvironmentId;
         const environmentPath = sanitizePathSegment(rawEnvironmentId, "default");
-        const slugSeed = sanitizePathSegment(tr.historyId ?? tr.id, sanitizePathSegment(tr.id, "test"));
+        const slugSeed = sanitizePathSegment(tr.retryHash ?? tr.id, sanitizePathSegment(tr.id, "test"));
         const usedSlugs = slugsByEnvironment.get(environmentPath) ?? new Set();
         slugsByEnvironment.set(environmentPath, usedSlugs);
         const slugResult = createUniqueSlug(slugSeed, tr.id, usedSlugs);
@@ -2673,7 +2673,7 @@ const writeBootstrapFiles = async (runtime) => {
 };
 const toTestsManifestLine = (entry) => ({
     environment_id: entry.environmentId,
-    history_id: entry.tr.historyId ?? null,
+    retry_hash: entry.tr.retryHash ?? null,
     test_result_id: entry.tr.id,
     full_name: entry.tr.fullName ?? entry.tr.name,
     package: entry.packageName ?? null,

package/dist/query.js

@@ -55,7 +55,7 @@ export const normalizeAgentQueryLimit = (value) => {
 const matchesLabelFilters = (labels, filters) => filters.every((filter) => labels.some((label) => label.name === filter.name && label.value === filter.value));
 const matchesAgentTestIdentifier = (test, identifier) => test.full_name === identifier ||
     test.test_result_id === identifier ||
-    test.history_id === identifier ||
+    test.retry_hash === identifier ||
     test.markdown_path === identifier;
 const agentFindingSubjectRef = (finding) => {
     if (finding.subject_ref) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allurereport/plugin-agent",
-  "version": "3.18.0",
+  "version": "3.19.1",
   "description": "Allure Agent Plugin – AI-friendly markdown report generator",
   "keywords": [
     "agent",
@@ -31,12 +31,12 @@
     "lint:fix": "yarn run -T oxlint --import-plugin --fix src test features stories"
   },
   "dependencies": {
-    "@allurereport/core-api": "3.18.0",
-    "@allurereport/plugin-api": "3.18.0",
+    "@allurereport/core-api": "3.19.1",
+    "@allurereport/plugin-api": "3.19.1",
     "yaml": "^2.8.1"
   },
   "devDependencies": {
-    "@allurereport/reader-api": "3.18.0",
+    "@allurereport/reader-api": "3.19.1",
     "@types/node": "^20",
     "@vitest/runner": "^2",
     "allure-js-commons": "^3",