executable-stories-formatters 0.15.0 → 0.16.0

package/dist/index.d.cts

@@ -502,7 +502,7 @@ interface ResolvedFormatterOptions {
     allowMissingAssets: boolean;
 }
 
-type ScenarioChangeKind = "added" | "removed" | "regressed" | "fixed" | "changed" | "unchanged";
+type ScenarioChangeKind = "added" | "removed" | "renamed" | "moved" | "regressed" | "fixed" | "changed" | "unchanged";
 interface ScenarioChangeFlags {
     status: boolean;
     steps: boolean;
@@ -541,12 +541,22 @@ interface ScenarioDiff {
     flags: ScenarioChangeFlags;
     changedFields: string[];
     durationDeltaMs?: number;
+    /** For `renamed`/`moved`: the baseline test-case id this behaviour was matched from. */
+    previousId?: string;
+    /** For `renamed`/`moved`: match confidence in 0..1 (1 = exact content fingerprint). */
+    matchConfidence?: number;
+    /** For `renamed`/`moved`: how the baseline/current pair was re-identified. */
+    matchedBy?: "fingerprint" | "similarity";
 }
 interface RunDiffSummary {
     totalBaseline: number;
     totalCurrent: number;
     added: number;
     removed: number;
+    /** Behaviours re-identified across a title change (content preserved). */
+    renamed: number;
+    /** Behaviours re-identified across a file move (content preserved). */
+    moved: number;
     changed: number;
     regressed: number;
     fixed: number;

package/dist/index.d.ts

@@ -502,7 +502,7 @@ interface ResolvedFormatterOptions {
     allowMissingAssets: boolean;
 }
 
-type ScenarioChangeKind = "added" | "removed" | "regressed" | "fixed" | "changed" | "unchanged";
+type ScenarioChangeKind = "added" | "removed" | "renamed" | "moved" | "regressed" | "fixed" | "changed" | "unchanged";
 interface ScenarioChangeFlags {
     status: boolean;
     steps: boolean;
@@ -541,12 +541,22 @@ interface ScenarioDiff {
     flags: ScenarioChangeFlags;
     changedFields: string[];
     durationDeltaMs?: number;
+    /** For `renamed`/`moved`: the baseline test-case id this behaviour was matched from. */
+    previousId?: string;
+    /** For `renamed`/`moved`: match confidence in 0..1 (1 = exact content fingerprint). */
+    matchConfidence?: number;
+    /** For `renamed`/`moved`: how the baseline/current pair was re-identified. */
+    matchedBy?: "fingerprint" | "similarity";
 }
 interface RunDiffSummary {
     totalBaseline: number;
     totalCurrent: number;
     added: number;
     removed: number;
+    /** Behaviours re-identified across a title change (content preserved). */
+    renamed: number;
+    /** Behaviours re-identified across a file move (content preserved). */
+    moved: number;
     changed: number;
     regressed: number;
     fixed: number;

package/dist/index.js

@@ -42,6 +42,41 @@ function generateFeatureId(uri) {
 function generateScenarioId(featureId, scenarioName) {
   return `${featureId};${slugify(scenarioName)}`;
 }
+function normalizeText(text2) {
+  return text2.toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, " ").replace(/\s+/g, " ").trim();
+}
+function tokenize(text2) {
+  const normalized = normalizeText(text2);
+  return normalized.length === 0 ? [] : normalized.split(" ");
+}
+function behaviourFingerprint(input) {
+  const steps = input.steps.map((step) => `${step.keyword.toLowerCase()}:${normalizeText(step.text)}`).join("\n");
+  const covers = [...input.covers ?? []].map((path12) => path12.trim()).filter(Boolean).sort().join(",");
+  if (steps.length === 0 && covers.length === 0) return "";
+  return createHash("sha1").update(`${steps}\0${covers}`).digest("hex").slice(0, 16);
+}
+function jaccard(a, b) {
+  if (a.size === 0 && b.size === 0) return 1;
+  if (a.size === 0 || b.size === 0) return 0;
+  let intersection = 0;
+  for (const value of a) if (b.has(value)) intersection += 1;
+  return intersection / (a.size + b.size - intersection);
+}
+function stepTokens(steps) {
+  const tokens = /* @__PURE__ */ new Set();
+  for (const step of steps) {
+    for (const token of tokenize(step.text)) tokens.add(token);
+  }
+  return tokens;
+}
+function behaviourSimilarity(a, b) {
+  const aSteps = stepTokens(a.steps);
+  const bSteps = stepTokens(b.steps);
+  if (aSteps.size === 0 || bSteps.size === 0) return 0;
+  const stepScore = jaccard(aSteps, bSteps);
+  const titleScore = jaccard(new Set(tokenize(a.scenario)), new Set(tokenize(b.scenario)));
+  return stepScore * 0.7 + titleScore * 0.3;
+}
 
 // src/converters/acl/steps.ts
 function deriveStepResults(steps, scenarioStatus, error) {
@@ -16663,6 +16698,10 @@ function titleFor(kind) {
       return "Added";
     case "removed":
       return "Removed";
+    case "renamed":
+      return "Renamed";
+    case "moved":
+      return "Moved";
     case "changed":
       return "Changed";
     default:
@@ -16711,6 +16750,8 @@ function createPrCommentSummary(diff, maxScenarios = 10) {
   addSection(lines, diff, "fixed", maxScenarios);
   addSection(lines, diff, "added", maxScenarios);
   addSection(lines, diff, "removed", maxScenarios);
+  addSection(lines, diff, "renamed", maxScenarios);
+  addSection(lines, diff, "moved", maxScenarios);
   addSection(lines, diff, "changed", maxScenarios);
   return lines.join("\n").trimEnd();
 }
@@ -16757,8 +16798,10 @@ function sortDiffs(scenarios) {
     fixed: 1,
     added: 2,
     removed: 3,
-    changed: 4,
-    unchanged: 5
+    renamed: 4,
+    moved: 5,
+    changed: 6,
+    unchanged: 7
   };
   return [...scenarios].sort((a, b) => {
     if (rank[a.kind] !== rank[b.kind]) {
@@ -16773,69 +16816,108 @@ function sortDiffs(scenarios) {
     return a.scenario.localeCompare(b.scenario);
   });
 }
+var SIMILARITY_THRESHOLD = 0.75;
+function identityInput(tc) {
+  return {
+    scenario: tc.story.scenario,
+    sourceFile: tc.sourceFile,
+    steps: tc.story.steps,
+    covers: tc.story.covers
+  };
+}
+function changedFieldsOf(flags) {
+  return Object.entries(flags).filter(([, changed]) => changed).map(([field]) => field);
+}
+function allChangedFlags(errorMessage) {
+  return {
+    status: true,
+    steps: true,
+    docs: true,
+    tags: true,
+    tickets: true,
+    source: true,
+    duration: true,
+    attachments: true,
+    error: Boolean(errorMessage),
+    titlePath: true
+  };
+}
+function matchIdentities(removed, added) {
+  const pairs = [];
+  const remainingRemoved = new Set(removed);
+  const remainingAdded = new Set(added);
+  const removedByFp = /* @__PURE__ */ new Map();
+  const addedByFp = /* @__PURE__ */ new Map();
+  for (const tc of remainingRemoved) {
+    const fp = behaviourFingerprint(identityInput(tc));
+    if (fp === "") continue;
+    (removedByFp.get(fp) ?? removedByFp.set(fp, []).get(fp)).push(tc);
+  }
+  for (const tc of remainingAdded) {
+    const fp = behaviourFingerprint(identityInput(tc));
+    if (fp === "") continue;
+    (addedByFp.get(fp) ?? addedByFp.set(fp, []).get(fp)).push(tc);
+  }
+  for (const [fp, removedGroup] of removedByFp) {
+    const addedGroup = addedByFp.get(fp);
+    if (removedGroup.length === 1 && addedGroup && addedGroup.length === 1) {
+      pairs.push({ before: removedGroup[0], after: addedGroup[0], confidence: 1, matchedBy: "fingerprint" });
+      remainingRemoved.delete(removedGroup[0]);
+      remainingAdded.delete(addedGroup[0]);
+    }
+  }
+  for (const before of [...remainingRemoved]) {
+    let best;
+    let bestScore = 0;
+    let tied = false;
+    for (const after of remainingAdded) {
+      const score = behaviourSimilarity(identityInput(before), identityInput(after));
+      if (score > bestScore) {
+        bestScore = score;
+        best = after;
+        tied = false;
+      } else if (score === bestScore) {
+        tied = true;
+      }
+    }
+    if (best && !tied && bestScore >= SIMILARITY_THRESHOLD) {
+      pairs.push({ before, after: best, confidence: Math.round(bestScore * 100) / 100, matchedBy: "similarity" });
+      remainingRemoved.delete(before);
+      remainingAdded.delete(best);
+    }
+  }
+  return {
+    pairs,
+    unmatchedRemoved: [...remainingRemoved],
+    unmatchedAdded: [...remainingAdded]
+  };
+}
+function identityKind(before, after) {
+  const titleChanged = before.story.scenario !== after.story.scenario;
+  const fileChanged = before.sourceFile !== after.sourceFile;
+  return fileChanged && !titleChanged ? "moved" : "renamed";
+}
 function diffRuns(baseline, current) {
   const baselineById = new Map(baseline.testCases.map((tc) => [tc.id, tc]));
   const currentById = new Map(current.testCases.map((tc) => [tc.id, tc]));
   const ids = /* @__PURE__ */ new Set([...baselineById.keys(), ...currentById.keys()]);
   const scenarios = [];
+  const removedCases = [];
+  const addedCases = [];
   for (const id of ids) {
     const before = baselineById.get(id);
     const after = currentById.get(id);
     if (!before && after) {
-      const flags2 = {
-        status: true,
-        steps: true,
-        docs: true,
-        tags: true,
-        tickets: true,
-        source: true,
-        duration: true,
-        attachments: true,
-        error: Boolean(after.errorMessage),
-        titlePath: true
-      };
-      scenarios.push({
-        kind: "added",
-        id,
-        scenario: after.story.scenario,
-        sourceFile: after.sourceFile,
-        sourceLine: after.sourceLine,
-        current: toScenarioSnapshot(after),
-        flags: flags2,
-        changedFields: Object.entries(flags2).filter(([, changed]) => changed).map(([field]) => field)
-      });
+      addedCases.push(after);
       continue;
     }
     if (before && !after) {
-      const flags2 = {
-        status: true,
-        steps: true,
-        docs: true,
-        tags: true,
-        tickets: true,
-        source: true,
-        duration: true,
-        attachments: true,
-        error: Boolean(before.errorMessage),
-        titlePath: true
-      };
-      scenarios.push({
-        kind: "removed",
-        id,
-        scenario: before.story.scenario,
-        sourceFile: before.sourceFile,
-        sourceLine: before.sourceLine,
-        baseline: toScenarioSnapshot(before),
-        flags: flags2,
-        changedFields: Object.entries(flags2).filter(([, changed]) => changed).map(([field]) => field)
-      });
-      continue;
-    }
-    if (!before || !after) {
+      removedCases.push(before);
       continue;
     }
+    if (!before || !after) continue;
     const flags = buildFlags(before, after);
-    const changedFields = Object.entries(flags).filter(([, changed]) => changed).map(([field]) => field);
+    const changedFields = changedFieldsOf(flags);
     const kind = getPrimaryKind(before, after, changedFields.length > 0);
     scenarios.push({
       kind,
@@ -16850,12 +16932,59 @@ function diffRuns(baseline, current) {
       durationDeltaMs: after.durationMs - before.durationMs
     });
   }
+  const { pairs, unmatchedRemoved, unmatchedAdded } = matchIdentities(removedCases, addedCases);
+  for (const { before, after, confidence, matchedBy } of pairs) {
+    const flags = buildFlags(before, after);
+    scenarios.push({
+      kind: identityKind(before, after),
+      id: after.id,
+      previousId: before.id,
+      scenario: after.story.scenario,
+      sourceFile: after.sourceFile,
+      sourceLine: after.sourceLine,
+      baseline: toScenarioSnapshot(before),
+      current: toScenarioSnapshot(after),
+      flags,
+      changedFields: changedFieldsOf(flags),
+      durationDeltaMs: after.durationMs - before.durationMs,
+      matchConfidence: confidence,
+      matchedBy
+    });
+  }
+  for (const after of unmatchedAdded) {
+    const flags = allChangedFlags(after.errorMessage);
+    scenarios.push({
+      kind: "added",
+      id: after.id,
+      scenario: after.story.scenario,
+      sourceFile: after.sourceFile,
+      sourceLine: after.sourceLine,
+      current: toScenarioSnapshot(after),
+      flags,
+      changedFields: changedFieldsOf(flags)
+    });
+  }
+  for (const before of unmatchedRemoved) {
+    const flags = allChangedFlags(before.errorMessage);
+    scenarios.push({
+      kind: "removed",
+      id: before.id,
+      scenario: before.story.scenario,
+      sourceFile: before.sourceFile,
+      sourceLine: before.sourceLine,
+      baseline: toScenarioSnapshot(before),
+      flags,
+      changedFields: changedFieldsOf(flags)
+    });
+  }
   const sorted = sortDiffs(scenarios);
   const summary = {
     totalBaseline: baseline.testCases.length,
     totalCurrent: current.testCases.length,
     added: sorted.filter((s) => s.kind === "added").length,
     removed: sorted.filter((s) => s.kind === "removed").length,
+    renamed: sorted.filter((s) => s.kind === "renamed").length,
+    moved: sorted.filter((s) => s.kind === "moved").length,
     changed: sorted.filter((s) => s.kind === "changed").length,
     regressed: sorted.filter((s) => s.kind === "regressed").length,
     fixed: sorted.filter((s) => s.kind === "fixed").length,
@@ -16883,6 +17012,10 @@ function statusLabel(kind) {
       return "Added";
     case "removed":
       return "Removed";
+    case "renamed":
+      return "Renamed";
+    case "moved":
+      return "Moved";
     case "changed":
       return "Changed";
     default:
@@ -17208,6 +17341,8 @@ window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', fun
         <div class="summary-card"><strong>${diff.summary.fixed}</strong><span>Fixed</span></div>
         <div class="summary-card"><strong>${diff.summary.added}</strong><span>Added</span></div>
         <div class="summary-card"><strong>${diff.summary.removed}</strong><span>Removed</span></div>
+        <div class="summary-card"><strong>${diff.summary.renamed}</strong><span>Renamed</span></div>
+        <div class="summary-card"><strong>${diff.summary.moved}</strong><span>Moved</span></div>
         <div class="summary-card"><strong>${diff.summary.changed}</strong><span>Changed</span></div>
         <div class="summary-card"><strong>${diff.summary.unchanged}</strong><span>Unchanged</span></div>
       </section>
@@ -17268,6 +17403,10 @@ function formatStatus(kind) {
       return "Added";
     case "removed":
       return "Removed";
+    case "renamed":
+      return "Renamed";
+    case "moved":
+      return "Moved";
     case "changed":
       return "Changed";
     default:
@@ -17420,13 +17559,13 @@ var RunDiffMarkdownFormatter = class {
       lines.push("No regressions or fixes detected. Remaining changes are neutral.");
     }
     lines.push("");
-    lines.push("| Added | Removed | Regressed | Fixed | Changed | Unchanged |");
-    lines.push("| ---: | ---: | ---: | ---: | ---: | ---: |");
+    lines.push("| Added | Removed | Renamed | Moved | Regressed | Fixed | Changed | Unchanged |");
+    lines.push("| ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |");
     lines.push(
-      `| ${diff.summary.added} | ${diff.summary.removed} | ${diff.summary.regressed} | ${diff.summary.fixed} | ${diff.summary.changed} | ${diff.summary.unchanged} |`
+      `| ${diff.summary.added} | ${diff.summary.removed} | ${diff.summary.renamed} | ${diff.summary.moved} | ${diff.summary.regressed} | ${diff.summary.fixed} | ${diff.summary.changed} | ${diff.summary.unchanged} |`
     );
     lines.push("");
-    for (const kind of ["regressed", "fixed", "added", "removed", "changed"]) {
+    for (const kind of ["regressed", "fixed", "added", "removed", "renamed", "moved", "changed"]) {
       const scenarios = diff.scenarios.filter((scenario) => scenario.kind === kind);
       if (scenarios.length === 0) continue;
       lines.push(`## ${formatStatus(kind)} (${scenarios.length})`);
@@ -18858,7 +18997,10 @@ function diffStoryReports(baseline, current) {
     };
   });
   const summary = { added: 0, removed: 0, regressed: 0, fixed: 0, changed: 0, unchanged: 0 };
-  for (const s of scenarios) summary[s.kind] += 1;
+  for (const s of scenarios) {
+    if (s.kind === "renamed" || s.kind === "moved") continue;
+    summary[s.kind] += 1;
+  }
   return { schemaVersion: "1.0", summary, scenarios };
 }