executable-stories-formatters 1.3.0 → 1.5.0

package/dist/index.d.cts

@@ -928,6 +928,69 @@ interface StoryReport {
 declare const STORY_REPORT_SCHEMA_VERSION: StoryReportSchemaVersion;
 declare const STORY_REPORT_SCHEMA_MAJOR: 1;
 
+/**
+ * Diff types — parsed unified patches and content-anchored annotation targets.
+ *
+ * These are contract types: they serialize into the review result JSON
+ * (`ReviewResult.codeDiffs`), so they live in the type layer like every other
+ * review contract. The parsing/anchoring implementation is `review/diff-anchor`.
+ */
+/** One line of a hunk body. */
+interface DiffLine {
+    kind: "add" | "del" | "context";
+    text: string;
+}
+/** One `@@` hunk. */
+interface DiffHunk {
+    oldStart: number;
+    newStart: number;
+    /** Trailing section heading from the `@@` line, if any. */
+    header: string;
+    lines: DiffLine[];
+}
+/** One file's diff. `oldPath`/`newPath` are undefined for /dev/null (add/delete). */
+interface FileDiff {
+    oldPath?: string;
+    newPath?: string;
+    hunks: DiffHunk[];
+}
+/**
+ * A content-anchored annotation target. Stores the actual lines (relocation
+ * needs them for fuzzy matching); `hash` is the derived stable identity.
+ */
+interface DiffAnchor {
+    /** sha256 over normalized changed + context lines — stable identity. */
+    hash: string;
+    /** Path hint (file the anchor was created in). Preferred during relocation, but anchors survive renames. */
+    file: string;
+    /** The anchored changed lines (add/del), in order. Never dropped during fuzz. */
+    changed: Array<{
+        kind: "add" | "del";
+        text: string;
+    }>;
+    /** Hunk lines preceding the changed run (outermost first). */
+    contextBefore: string[];
+    /** Hunk lines following the changed run (innermost first). */
+    contextAfter: string[];
+}
+type AnchorState = "anchored" | "ambiguous" | "orphaned";
+/** Where (and whether) an anchor relocated in a regenerated patch. */
+interface AnchorResolution {
+    state: AnchorState;
+    /** The remaining fields are set together when `state` is `anchored`: */
+    /** Index into the parsed files array — renderers index directly, no path search. */
+    fileIndex?: number;
+    /** Display path of the matched file. */
+    file?: string;
+    hunkIndex?: number;
+    /** Index within `hunk.lines` of the first changed line. */
+    lineIndex?: number;
+    /** Length of the anchored changed run (for highlighting). */
+    lineCount?: number;
+    /** How many outermost context lines (per side) were ignored to match. */
+    fuzz?: number;
+}
+
 /**
  * Review types — the model behind the Evidence-Driven Review report.
  *
@@ -979,6 +1042,75 @@ interface ReviewContext {
     baseRef?: string;
     /** Head ref/sha (informational). */
     headRef?: string;
+    /** Code Diff evidence groups (patch + annotation sidecar), supplied at the CLI/Action layer. */
+    codeDiffs?: CodeDiffInput[];
+}
+/** One annotation from the Code Diff sidecar, ordered by concept (not Git file order). */
+interface CodeDiffAnnotationInput {
+    /**
+     * Content anchor — never a bare line number (see `review/diff-anchor`).
+     * Absent when assembly could not produce one; `unresolved` then names the state.
+     */
+    anchor?: DiffAnchor;
+    /**
+     * Set instead of `anchor` when assembly failed: `orphaned` (no matching
+     * changed line) or `ambiguous` (the match was not unique). Rendered as that
+     * state directly, so authoring mistakes surface visibly.
+     */
+    unresolved?: "orphaned" | "ambiguous";
+    /** Explanatory prose (plain text — rendered verbatim, never as HTML or Markdown). */
+    text: string;
+    /** Short conceptual label (drives the outline ordering). */
+    label?: string;
+    /** StoryReport scenario IDs whose execution proves this hunk's effect. */
+    scenarioIds?: string[];
+}
+/** One Code Diff evidence group fed in at the CLI/Action layer — NEVER by adapters. */
+interface CodeDiffInput {
+    /** Human title for this evidence group. */
+    title: string;
+    /** Unified diff content, expected from `git diff --histogram`. */
+    patch: string;
+    /**
+     * Canonical HTTPS patch URL — audit provenance only, never a second render
+     * source. Only `https:` URLs render as links; anything else renders inert.
+     */
+    patchUrl?: string;
+    /** Human comparison labels; default from `baseRef`/`headRef`. */
+    baseLabel?: string;
+    headLabel?: string;
+    annotations: CodeDiffAnnotationInput[];
+}
+/** A scenario cited by an annotation, resolved against the current run. */
+interface CodeDiffScenarioRef {
+    id: string;
+    /** False = the cited scenario is not in this run — render as "unverified reference". */
+    resolved: boolean;
+    scenario?: string;
+    status?: TestStatus$1;
+}
+/** An annotation resolved against the parsed patch and the run. */
+interface CodeDiffAnnotation {
+    /** Stable identity of the content anchor. Absent when assembly never produced one. */
+    anchorHash?: string;
+    /** Plain-text prose, rendered verbatim. */
+    text: string;
+    label?: string;
+    /** anchored / ambiguous / orphaned — ambiguous and orphaned render visibly, never guessed. */
+    resolution: AnchorResolution;
+    scenarios: CodeDiffScenarioRef[];
+}
+/** Code Diff evidence on the review result, ready for formatters to render. */
+interface CodeDiffEvidence {
+    title: string;
+    /** The raw unified patch (audit fallback; renderers escape it as text). */
+    patch: string;
+    patchUrl?: string;
+    baseLabel?: string;
+    headLabel?: string;
+    /** Parsed files/hunks so renderers never re-parse. */
+    files: FileDiff[];
+    annotations: CodeDiffAnnotation[];
 }
 /** One reviewable claim = one story/test case, enriched for review. */
 interface ReviewClaim {
@@ -1038,6 +1170,8 @@ interface ReviewResult {
     claims: ReviewClaim[];
     /** Changed source files, sorted uncovered → weak → covered. */
     changedFiles: ChangedFileReview[];
+    /** Code Diff evidence groups (empty when the context supplied none). */
+    codeDiffs: CodeDiffEvidence[];
 }
 
 /**
@@ -2978,6 +3112,104 @@ declare function gradeEvidence(testCase: TestCaseResult, audience: ReviewAudienc
  * banded — the 🔴 uncovered band being the reviewer's first stop.
  */
 declare function buildReview(run: ReviewResult["run"], context?: ReviewContext): ReviewResult;
+/**
+ * Code Diff integrity diagnostics: orphaned/ambiguous anchors and unverified
+ * scenario references. The CLI prints these as warnings; `--strict-code-diff`
+ * turns them into review-gate failures so CI catches explainers that lost
+ * their grounding.
+ */
+declare function codeDiffDiagnostics(review: ReviewResult): string[];
+
+/**
+ * Code Diff sidecar assembly — the authoring seam for Code Diff evidence.
+ *
+ * Authors (normally the `explain-change` skill) never hand-write content
+ * anchors. The sidecar names a file and a unique substring of one changed
+ * line; assembly locates that line in the `git diff --histogram` patch and
+ * builds the real content anchor from it. A match that fails to locate still
+ * produces an annotation, explicitly marked `unresolved` (orphaned or
+ * ambiguous), so authoring mistakes surface visibly instead of disappearing.
+ */
+
+/** Hand-authored (or agent-authored) annotation entry in the sidecar file. */
+interface CodeDiffSidecarAnnotation {
+    /** Repo-relative path of the changed file. */
+    file: string;
+    /** Substring of exactly one changed line in the patch. */
+    match: string;
+    /** Explanatory prose (plain text — rendered verbatim). */
+    text: string;
+    label?: string;
+    scenarioIds?: string[];
+}
+/** The sidecar document (JSON). The patch itself is supplied separately. */
+interface CodeDiffSidecar {
+    title: string;
+    /** Canonical HTTPS patch URL — audit provenance only. */
+    patchUrl?: string;
+    baseLabel?: string;
+    headLabel?: string;
+    /** Ordered by concept, not Git file order. */
+    annotations: CodeDiffSidecarAnnotation[];
+}
+/**
+ * Assemble a {@link CodeDiffInput} from a sidecar and a unified patch.
+ * Returns authoring warnings alongside — a located match gets a real content
+ * anchor; a missed or non-unique match gets a bare anchor that resolves
+ * orphaned, plus a warning saying why.
+ */
+declare function assembleCodeDiff(args: {
+    sidecar: CodeDiffSidecar;
+    patch: string;
+}): {
+    input: CodeDiffInput;
+    warnings: string[];
+};
+
+/**
+ * Diff anchoring — content-anchored annotation targets for Code Diff evidence.
+ *
+ * An annotation must stay attached to the right hunk after the patch is
+ * regenerated (which, for AI-authored changes, happens constantly). Line
+ * numbers are the wrong key: they detach on rebase/force-push. This module
+ * anchors by content instead, the way `patch(1)` does — the anchor is the
+ * changed lines plus a bounded window of surrounding context, and relocation
+ * matches that content in the new patch with progressive fuzz (outermost
+ * context lines are dropped first; the changed lines are never dropped).
+ *
+ * Resolution states:
+ * - `anchored`  — exactly one match above the fuzz threshold.
+ * - `ambiguous` — multiple matches (e.g. duplicate identical lines); the
+ *                 annotation must render visibly un-located, never guessed.
+ * - `orphaned`  — no match; the annotation renders with a "could not locate
+ *                 in current patch" notice, never silently reattached.
+ *
+ * Pure functions, no I/O — patches are generated at the CLI/Action layer
+ * (with `git diff --histogram` for hunk stability), never by adapters.
+ */
+
+/**
+ * Parse a unified diff into files and hunks. Hunk bodies are consumed by
+ * line count from the `@@` header, so content lines that look like file
+ * headers (e.g. a context line starting with `--- `) parse correctly.
+ */
+declare function parseUnifiedDiff(patch: string): FileDiff[];
+/**
+ * Create an anchor for the contiguous run of changed lines starting at
+ * `lines[lineIndex]` in the given hunk (the authoring seam — used by the
+ * CLI/sidecar assembly helper, not by hand).
+ */
+declare function createAnchor(args: {
+    file: FileDiff;
+    hunkIndex: number;
+    lineIndex: number;
+}): DiffAnchor;
+/**
+ * Relocate an anchor in a (re)generated patch. The anchor's own file is
+ * searched first so a duplicate block elsewhere in the repo cannot make an
+ * exact in-file match ambiguous; other files are the rename fallback.
+ */
+declare function relocateAnchor(anchor: DiffAnchor, files: FileDiff[]): AnchorResolution;
 
 /**
  * Convention-based derivation for the review report.
@@ -3271,6 +3503,20 @@ declare class ReportGenerator {
      * @returns Map of output format to generated file paths
      */
     generate(run: TestRunResult): Promise<GenerateResult>;
+    /**
+     * Whether any output is colocated — the global mode, or any per-rule mode.
+     * A colocated rule under a global aggregated mode still writes per-file
+     * reports that need an index.
+     */
+    private hasColocatedOutput;
+    /**
+     * Write the entry-point page for a colocated HTML report tree. `htmlPaths` is
+     * every HTML report already written this run. Returns the path written, or
+     * undefined when there is nothing to index or the index would clobber a report
+     * already at `index.html` — a colocated source file that produces it, or, in
+     * mixed mode, the global aggregate (whose default output name is also index).
+     */
+    private writeColocatedIndex;
     /**
      * Generate reports for a single format.
      */
@@ -3321,4 +3567,4 @@ declare function normalizeVitestResults(testModules: Parameters<typeof adaptVite
  */
 declare function normalizePlaywrightResults(testResults: Parameters<typeof adaptPlaywrightRun>[0], adapterOptions?: Parameters<typeof adaptPlaywrightRun>[1], canonicalizeOptions?: CanonicalizeOptions): TestRunResult;
 
-export { type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, Attachment, type BehaviorDebuggerIssue, type BehaviorDiff, type BehaviorDiffEntry, type BehaviorManifest, BehaviorManifestJsonFormatter, type BehaviorManifestJsonOptions, type BehaviorSourceFile, type BehaviorTag, type BundleOptions, type BundleResult, CIProvider, type CanonicalizeOptions, type ChangeType, type ChangedFile, type ChangedFileReview, type CheckArgs, type CheckDeps, type CheckFailure, type CheckReport, type CheckStep, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, type DeploymentEntry, type DeploymentLedger, type DeploymentStatus, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, type EnvironmentDrift, type EvidenceStrength, type ExecutableStoriesConfig, type FetchFn, type FileChangeKind, type FlakinessLevel, type Formatter, type FormatterOptions, type GenerateArgs, type GenerateCompareResult, type GenerateDeps, type GenerateResult, type GenericWebhookNotifierOptions, type GoalArgs, type GoalDeps, type GoalReport, type GoalRequirementResult, type HistoryEntry, type HistoryStore, type HtmlDocOptions, type IJsonDataTable, type IJsonDocString, type IJsonEmbedding, type IJsonFeature, type IJsonScenario, type IJsonStep, type IJsonStepArgument, type IJsonStepResult, type IJsonTableRow, type IJsonTag, JUnitFormatter, type JUnitOptions, type JiraAuth, type JiraPublishMode, type ListScenariosArgs, type ListScenariosDeps, type Logger, MIN_FLAKINESS_SAMPLES, MIN_METRIC_SAMPLES, MIN_PERF_SAMPLES, MarkdownFormatter, type MarkdownFormatterOptions, type MarkdownOptions, type MarkdownRenderers, NormalizedTicket, type NotificationSummary, type NotifyCondition, OtelSpan, type OtelTraceContext, type OutputConfig, type OutputFormat, type OutputMode, type OutputRule, type PerformanceTrend, type PublishConfluenceArgs, type PublishConfluenceDeps, type PublishConfluenceResult, type PublishJiraArgs, type PublishJiraDeps, type PublishJiraResult, type RatchetViolation, RawAttachment, RawCIInfo, RawRun, RawStatus, type RecordDeploymentArgs, type RecordDeploymentResult, type ReleaseManifest, ReleaseManifestFormatter, type ReportAttachment, type ReportCIInfo, type ReportCoverageSummary, type ReportDocCode, type ReportDocCustom, type ReportDocEntry, type ReportDocKv, type ReportDocLink, type ReportDocMermaid, type ReportDocNote, type ReportDocScreenshot, type ReportDocSection, type ReportDocTable, type ReportDocTag, type ReportFeature, ReportGenerator, type ReportScenario, type ReportStep, type ReportSummary, type ReportTicket, type ResolvedFormatterOptions, type ReviewAudience, type ReviewBand, type ReviewClaim, type ReviewContext, ReviewHtmlFormatter, type ReviewHtmlOptions, ReviewMarkdownFormatter, type ReviewMarkdownOptions, type ReviewResult, type ReviewSummary, RunDiffChangelogFormatter, type RunDiffChangelogOptions, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type RunState, STORY_REPORT_SCHEMA_MAJOR, STORY_REPORT_SCHEMA_VERSION, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioIndex, type ScenarioIndexFilters, type ScenarioIndexItem, ScenarioIndexJsonFormatter, type ScenarioIndexJsonOptions, type ScenarioIndexStep, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, StepKeyword$1 as StepKeyword, StepResult, type StoryReport, StoryReportJsonFormatter, type StoryReportJsonOptions, type StoryReportSchemaVersion, StoryStep, TestCaseResult, type TestHistory, type TestMetrics, TestRunResult, TestStatus$1 as TestStatus, type TraceabilityMatrix, TraceabilityMatrixFormatter, type TraceabilityRequirement, type TriageArgs, type TriageDeps, type TriageItem, type TriageReport, CIInfo$1 as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, advanceState, assertValidRun, buildCheck, buildGoal, buildHtmlDocEntry, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, classifyStatusChange, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, initialRunState, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeFormats, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, regenerateRun, renderCheck, renderGoal, renderTriage, resolveAttachment, resolveAttachments, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toStoryReport, toTraceabilityMatrix, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };
+export { type AnchorResolution, type AnchorState, type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, Attachment, type BehaviorDebuggerIssue, type BehaviorDiff, type BehaviorDiffEntry, type BehaviorManifest, BehaviorManifestJsonFormatter, type BehaviorManifestJsonOptions, type BehaviorSourceFile, type BehaviorTag, type BundleOptions, type BundleResult, CIProvider, type CanonicalizeOptions, type ChangeType, type ChangedFile, type ChangedFileReview, type CheckArgs, type CheckDeps, type CheckFailure, type CheckReport, type CheckStep, type CodeDiffAnnotation, type CodeDiffAnnotationInput, type CodeDiffEvidence, type CodeDiffInput, type CodeDiffScenarioRef, type CodeDiffSidecar, type CodeDiffSidecarAnnotation, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, type DeploymentEntry, type DeploymentLedger, type DeploymentStatus, type DiffAnchor, type DiffHunk, type DiffLine, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, type EnvironmentDrift, type EvidenceStrength, type ExecutableStoriesConfig, type FetchFn, type FileChangeKind, type FileDiff, type FlakinessLevel, type Formatter, type FormatterOptions, type GenerateArgs, type GenerateCompareResult, type GenerateDeps, type GenerateResult, type GenericWebhookNotifierOptions, type GoalArgs, type GoalDeps, type GoalReport, type GoalRequirementResult, type HistoryEntry, type HistoryStore, type HtmlDocOptions, type IJsonDataTable, type IJsonDocString, type IJsonEmbedding, type IJsonFeature, type IJsonScenario, type IJsonStep, type IJsonStepArgument, type IJsonStepResult, type IJsonTableRow, type IJsonTag, JUnitFormatter, type JUnitOptions, type JiraAuth, type JiraPublishMode, type ListScenariosArgs, type ListScenariosDeps, type Logger, MIN_FLAKINESS_SAMPLES, MIN_METRIC_SAMPLES, MIN_PERF_SAMPLES, MarkdownFormatter, type MarkdownFormatterOptions, type MarkdownOptions, type MarkdownRenderers, NormalizedTicket, type NotificationSummary, type NotifyCondition, OtelSpan, type OtelTraceContext, type OutputConfig, type OutputFormat, type OutputMode, type OutputRule, type PerformanceTrend, type PublishConfluenceArgs, type PublishConfluenceDeps, type PublishConfluenceResult, type PublishJiraArgs, type PublishJiraDeps, type PublishJiraResult, type RatchetViolation, RawAttachment, RawCIInfo, RawRun, RawStatus, type RecordDeploymentArgs, type RecordDeploymentResult, type ReleaseManifest, ReleaseManifestFormatter, type ReportAttachment, type ReportCIInfo, type ReportCoverageSummary, type ReportDocCode, type ReportDocCustom, type ReportDocEntry, type ReportDocKv, type ReportDocLink, type ReportDocMermaid, type ReportDocNote, type ReportDocScreenshot, type ReportDocSection, type ReportDocTable, type ReportDocTag, type ReportFeature, ReportGenerator, type ReportScenario, type ReportStep, type ReportSummary, type ReportTicket, type ResolvedFormatterOptions, type ReviewAudience, type ReviewBand, type ReviewClaim, type ReviewContext, ReviewHtmlFormatter, type ReviewHtmlOptions, ReviewMarkdownFormatter, type ReviewMarkdownOptions, type ReviewResult, type ReviewSummary, RunDiffChangelogFormatter, type RunDiffChangelogOptions, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type RunState, STORY_REPORT_SCHEMA_MAJOR, STORY_REPORT_SCHEMA_VERSION, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioIndex, type ScenarioIndexFilters, type ScenarioIndexItem, ScenarioIndexJsonFormatter, type ScenarioIndexJsonOptions, type ScenarioIndexStep, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, StepKeyword$1 as StepKeyword, StepResult, type StoryReport, StoryReportJsonFormatter, type StoryReportJsonOptions, type StoryReportSchemaVersion, StoryStep, TestCaseResult, type TestHistory, type TestMetrics, TestRunResult, TestStatus$1 as TestStatus, type TraceabilityMatrix, TraceabilityMatrixFormatter, type TraceabilityRequirement, type TriageArgs, type TriageDeps, type TriageItem, type TriageReport, CIInfo$1 as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, advanceState, assembleCodeDiff, assertValidRun, buildCheck, buildGoal, buildHtmlDocEntry, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, classifyStatusChange, clearVersionCache, codeDiffDiagnostics, computeTestMetrics, copyMarkdownAssets, createAnchor, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, initialRunState, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeFormats, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, parseUnifiedDiff, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, regenerateRun, relocateAnchor, renderCheck, renderGoal, renderTriage, resolveAttachment, resolveAttachments, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toStoryReport, toTraceabilityMatrix, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };

package/dist/index.d.ts

@@ -928,6 +928,69 @@ interface StoryReport {
 declare const STORY_REPORT_SCHEMA_VERSION: StoryReportSchemaVersion;
 declare const STORY_REPORT_SCHEMA_MAJOR: 1;
 
+/**
+ * Diff types — parsed unified patches and content-anchored annotation targets.
+ *
+ * These are contract types: they serialize into the review result JSON
+ * (`ReviewResult.codeDiffs`), so they live in the type layer like every other
+ * review contract. The parsing/anchoring implementation is `review/diff-anchor`.
+ */
+/** One line of a hunk body. */
+interface DiffLine {
+    kind: "add" | "del" | "context";
+    text: string;
+}
+/** One `@@` hunk. */
+interface DiffHunk {
+    oldStart: number;
+    newStart: number;
+    /** Trailing section heading from the `@@` line, if any. */
+    header: string;
+    lines: DiffLine[];
+}
+/** One file's diff. `oldPath`/`newPath` are undefined for /dev/null (add/delete). */
+interface FileDiff {
+    oldPath?: string;
+    newPath?: string;
+    hunks: DiffHunk[];
+}
+/**
+ * A content-anchored annotation target. Stores the actual lines (relocation
+ * needs them for fuzzy matching); `hash` is the derived stable identity.
+ */
+interface DiffAnchor {
+    /** sha256 over normalized changed + context lines — stable identity. */
+    hash: string;
+    /** Path hint (file the anchor was created in). Preferred during relocation, but anchors survive renames. */
+    file: string;
+    /** The anchored changed lines (add/del), in order. Never dropped during fuzz. */
+    changed: Array<{
+        kind: "add" | "del";
+        text: string;
+    }>;
+    /** Hunk lines preceding the changed run (outermost first). */
+    contextBefore: string[];
+    /** Hunk lines following the changed run (innermost first). */
+    contextAfter: string[];
+}
+type AnchorState = "anchored" | "ambiguous" | "orphaned";
+/** Where (and whether) an anchor relocated in a regenerated patch. */
+interface AnchorResolution {
+    state: AnchorState;
+    /** The remaining fields are set together when `state` is `anchored`: */
+    /** Index into the parsed files array — renderers index directly, no path search. */
+    fileIndex?: number;
+    /** Display path of the matched file. */
+    file?: string;
+    hunkIndex?: number;
+    /** Index within `hunk.lines` of the first changed line. */
+    lineIndex?: number;
+    /** Length of the anchored changed run (for highlighting). */
+    lineCount?: number;
+    /** How many outermost context lines (per side) were ignored to match. */
+    fuzz?: number;
+}
+
 /**
  * Review types — the model behind the Evidence-Driven Review report.
  *
@@ -979,6 +1042,75 @@ interface ReviewContext {
     baseRef?: string;
     /** Head ref/sha (informational). */
     headRef?: string;
+    /** Code Diff evidence groups (patch + annotation sidecar), supplied at the CLI/Action layer. */
+    codeDiffs?: CodeDiffInput[];
+}
+/** One annotation from the Code Diff sidecar, ordered by concept (not Git file order). */
+interface CodeDiffAnnotationInput {
+    /**
+     * Content anchor — never a bare line number (see `review/diff-anchor`).
+     * Absent when assembly could not produce one; `unresolved` then names the state.
+     */
+    anchor?: DiffAnchor;
+    /**
+     * Set instead of `anchor` when assembly failed: `orphaned` (no matching
+     * changed line) or `ambiguous` (the match was not unique). Rendered as that
+     * state directly, so authoring mistakes surface visibly.
+     */
+    unresolved?: "orphaned" | "ambiguous";
+    /** Explanatory prose (plain text — rendered verbatim, never as HTML or Markdown). */
+    text: string;
+    /** Short conceptual label (drives the outline ordering). */
+    label?: string;
+    /** StoryReport scenario IDs whose execution proves this hunk's effect. */
+    scenarioIds?: string[];
+}
+/** One Code Diff evidence group fed in at the CLI/Action layer — NEVER by adapters. */
+interface CodeDiffInput {
+    /** Human title for this evidence group. */
+    title: string;
+    /** Unified diff content, expected from `git diff --histogram`. */
+    patch: string;
+    /**
+     * Canonical HTTPS patch URL — audit provenance only, never a second render
+     * source. Only `https:` URLs render as links; anything else renders inert.
+     */
+    patchUrl?: string;
+    /** Human comparison labels; default from `baseRef`/`headRef`. */
+    baseLabel?: string;
+    headLabel?: string;
+    annotations: CodeDiffAnnotationInput[];
+}
+/** A scenario cited by an annotation, resolved against the current run. */
+interface CodeDiffScenarioRef {
+    id: string;
+    /** False = the cited scenario is not in this run — render as "unverified reference". */
+    resolved: boolean;
+    scenario?: string;
+    status?: TestStatus$1;
+}
+/** An annotation resolved against the parsed patch and the run. */
+interface CodeDiffAnnotation {
+    /** Stable identity of the content anchor. Absent when assembly never produced one. */
+    anchorHash?: string;
+    /** Plain-text prose, rendered verbatim. */
+    text: string;
+    label?: string;
+    /** anchored / ambiguous / orphaned — ambiguous and orphaned render visibly, never guessed. */
+    resolution: AnchorResolution;
+    scenarios: CodeDiffScenarioRef[];
+}
+/** Code Diff evidence on the review result, ready for formatters to render. */
+interface CodeDiffEvidence {
+    title: string;
+    /** The raw unified patch (audit fallback; renderers escape it as text). */
+    patch: string;
+    patchUrl?: string;
+    baseLabel?: string;
+    headLabel?: string;
+    /** Parsed files/hunks so renderers never re-parse. */
+    files: FileDiff[];
+    annotations: CodeDiffAnnotation[];
 }
 /** One reviewable claim = one story/test case, enriched for review. */
 interface ReviewClaim {
@@ -1038,6 +1170,8 @@ interface ReviewResult {
     claims: ReviewClaim[];
     /** Changed source files, sorted uncovered → weak → covered. */
     changedFiles: ChangedFileReview[];
+    /** Code Diff evidence groups (empty when the context supplied none). */
+    codeDiffs: CodeDiffEvidence[];
 }
 
 /**
@@ -2978,6 +3112,104 @@ declare function gradeEvidence(testCase: TestCaseResult, audience: ReviewAudienc
  * banded — the 🔴 uncovered band being the reviewer's first stop.
  */
 declare function buildReview(run: ReviewResult["run"], context?: ReviewContext): ReviewResult;
+/**
+ * Code Diff integrity diagnostics: orphaned/ambiguous anchors and unverified
+ * scenario references. The CLI prints these as warnings; `--strict-code-diff`
+ * turns them into review-gate failures so CI catches explainers that lost
+ * their grounding.
+ */
+declare function codeDiffDiagnostics(review: ReviewResult): string[];
+
+/**
+ * Code Diff sidecar assembly — the authoring seam for Code Diff evidence.
+ *
+ * Authors (normally the `explain-change` skill) never hand-write content
+ * anchors. The sidecar names a file and a unique substring of one changed
+ * line; assembly locates that line in the `git diff --histogram` patch and
+ * builds the real content anchor from it. A match that fails to locate still
+ * produces an annotation, explicitly marked `unresolved` (orphaned or
+ * ambiguous), so authoring mistakes surface visibly instead of disappearing.
+ */
+
+/** Hand-authored (or agent-authored) annotation entry in the sidecar file. */
+interface CodeDiffSidecarAnnotation {
+    /** Repo-relative path of the changed file. */
+    file: string;
+    /** Substring of exactly one changed line in the patch. */
+    match: string;
+    /** Explanatory prose (plain text — rendered verbatim). */
+    text: string;
+    label?: string;
+    scenarioIds?: string[];
+}
+/** The sidecar document (JSON). The patch itself is supplied separately. */
+interface CodeDiffSidecar {
+    title: string;
+    /** Canonical HTTPS patch URL — audit provenance only. */
+    patchUrl?: string;
+    baseLabel?: string;
+    headLabel?: string;
+    /** Ordered by concept, not Git file order. */
+    annotations: CodeDiffSidecarAnnotation[];
+}
+/**
+ * Assemble a {@link CodeDiffInput} from a sidecar and a unified patch.
+ * Returns authoring warnings alongside — a located match gets a real content
+ * anchor; a missed or non-unique match gets a bare anchor that resolves
+ * orphaned, plus a warning saying why.
+ */
+declare function assembleCodeDiff(args: {
+    sidecar: CodeDiffSidecar;
+    patch: string;
+}): {
+    input: CodeDiffInput;
+    warnings: string[];
+};
+
+/**
+ * Diff anchoring — content-anchored annotation targets for Code Diff evidence.
+ *
+ * An annotation must stay attached to the right hunk after the patch is
+ * regenerated (which, for AI-authored changes, happens constantly). Line
+ * numbers are the wrong key: they detach on rebase/force-push. This module
+ * anchors by content instead, the way `patch(1)` does — the anchor is the
+ * changed lines plus a bounded window of surrounding context, and relocation
+ * matches that content in the new patch with progressive fuzz (outermost
+ * context lines are dropped first; the changed lines are never dropped).
+ *
+ * Resolution states:
+ * - `anchored`  — exactly one match above the fuzz threshold.
+ * - `ambiguous` — multiple matches (e.g. duplicate identical lines); the
+ *                 annotation must render visibly un-located, never guessed.
+ * - `orphaned`  — no match; the annotation renders with a "could not locate
+ *                 in current patch" notice, never silently reattached.
+ *
+ * Pure functions, no I/O — patches are generated at the CLI/Action layer
+ * (with `git diff --histogram` for hunk stability), never by adapters.
+ */
+
+/**
+ * Parse a unified diff into files and hunks. Hunk bodies are consumed by
+ * line count from the `@@` header, so content lines that look like file
+ * headers (e.g. a context line starting with `--- `) parse correctly.
+ */
+declare function parseUnifiedDiff(patch: string): FileDiff[];
+/**
+ * Create an anchor for the contiguous run of changed lines starting at
+ * `lines[lineIndex]` in the given hunk (the authoring seam — used by the
+ * CLI/sidecar assembly helper, not by hand).
+ */
+declare function createAnchor(args: {
+    file: FileDiff;
+    hunkIndex: number;
+    lineIndex: number;
+}): DiffAnchor;
+/**
+ * Relocate an anchor in a (re)generated patch. The anchor's own file is
+ * searched first so a duplicate block elsewhere in the repo cannot make an
+ * exact in-file match ambiguous; other files are the rename fallback.
+ */
+declare function relocateAnchor(anchor: DiffAnchor, files: FileDiff[]): AnchorResolution;
 
 /**
  * Convention-based derivation for the review report.
@@ -3271,6 +3503,20 @@ declare class ReportGenerator {
      * @returns Map of output format to generated file paths
      */
     generate(run: TestRunResult): Promise<GenerateResult>;
+    /**
+     * Whether any output is colocated — the global mode, or any per-rule mode.
+     * A colocated rule under a global aggregated mode still writes per-file
+     * reports that need an index.
+     */
+    private hasColocatedOutput;
+    /**
+     * Write the entry-point page for a colocated HTML report tree. `htmlPaths` is
+     * every HTML report already written this run. Returns the path written, or
+     * undefined when there is nothing to index or the index would clobber a report
+     * already at `index.html` — a colocated source file that produces it, or, in
+     * mixed mode, the global aggregate (whose default output name is also index).
+     */
+    private writeColocatedIndex;
     /**
      * Generate reports for a single format.
      */
@@ -3321,4 +3567,4 @@ declare function normalizeVitestResults(testModules: Parameters<typeof adaptVite
  */
 declare function normalizePlaywrightResults(testResults: Parameters<typeof adaptPlaywrightRun>[0], adapterOptions?: Parameters<typeof adaptPlaywrightRun>[1], canonicalizeOptions?: CanonicalizeOptions): TestRunResult;
 
-export { type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, Attachment, type BehaviorDebuggerIssue, type BehaviorDiff, type BehaviorDiffEntry, type BehaviorManifest, BehaviorManifestJsonFormatter, type BehaviorManifestJsonOptions, type BehaviorSourceFile, type BehaviorTag, type BundleOptions, type BundleResult, CIProvider, type CanonicalizeOptions, type ChangeType, type ChangedFile, type ChangedFileReview, type CheckArgs, type CheckDeps, type CheckFailure, type CheckReport, type CheckStep, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, type DeploymentEntry, type DeploymentLedger, type DeploymentStatus, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, type EnvironmentDrift, type EvidenceStrength, type ExecutableStoriesConfig, type FetchFn, type FileChangeKind, type FlakinessLevel, type Formatter, type FormatterOptions, type GenerateArgs, type GenerateCompareResult, type GenerateDeps, type GenerateResult, type GenericWebhookNotifierOptions, type GoalArgs, type GoalDeps, type GoalReport, type GoalRequirementResult, type HistoryEntry, type HistoryStore, type HtmlDocOptions, type IJsonDataTable, type IJsonDocString, type IJsonEmbedding, type IJsonFeature, type IJsonScenario, type IJsonStep, type IJsonStepArgument, type IJsonStepResult, type IJsonTableRow, type IJsonTag, JUnitFormatter, type JUnitOptions, type JiraAuth, type JiraPublishMode, type ListScenariosArgs, type ListScenariosDeps, type Logger, MIN_FLAKINESS_SAMPLES, MIN_METRIC_SAMPLES, MIN_PERF_SAMPLES, MarkdownFormatter, type MarkdownFormatterOptions, type MarkdownOptions, type MarkdownRenderers, NormalizedTicket, type NotificationSummary, type NotifyCondition, OtelSpan, type OtelTraceContext, type OutputConfig, type OutputFormat, type OutputMode, type OutputRule, type PerformanceTrend, type PublishConfluenceArgs, type PublishConfluenceDeps, type PublishConfluenceResult, type PublishJiraArgs, type PublishJiraDeps, type PublishJiraResult, type RatchetViolation, RawAttachment, RawCIInfo, RawRun, RawStatus, type RecordDeploymentArgs, type RecordDeploymentResult, type ReleaseManifest, ReleaseManifestFormatter, type ReportAttachment, type ReportCIInfo, type ReportCoverageSummary, type ReportDocCode, type ReportDocCustom, type ReportDocEntry, type ReportDocKv, type ReportDocLink, type ReportDocMermaid, type ReportDocNote, type ReportDocScreenshot, type ReportDocSection, type ReportDocTable, type ReportDocTag, type ReportFeature, ReportGenerator, type ReportScenario, type ReportStep, type ReportSummary, type ReportTicket, type ResolvedFormatterOptions, type ReviewAudience, type ReviewBand, type ReviewClaim, type ReviewContext, ReviewHtmlFormatter, type ReviewHtmlOptions, ReviewMarkdownFormatter, type ReviewMarkdownOptions, type ReviewResult, type ReviewSummary, RunDiffChangelogFormatter, type RunDiffChangelogOptions, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type RunState, STORY_REPORT_SCHEMA_MAJOR, STORY_REPORT_SCHEMA_VERSION, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioIndex, type ScenarioIndexFilters, type ScenarioIndexItem, ScenarioIndexJsonFormatter, type ScenarioIndexJsonOptions, type ScenarioIndexStep, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, StepKeyword$1 as StepKeyword, StepResult, type StoryReport, StoryReportJsonFormatter, type StoryReportJsonOptions, type StoryReportSchemaVersion, StoryStep, TestCaseResult, type TestHistory, type TestMetrics, TestRunResult, TestStatus$1 as TestStatus, type TraceabilityMatrix, TraceabilityMatrixFormatter, type TraceabilityRequirement, type TriageArgs, type TriageDeps, type TriageItem, type TriageReport, CIInfo$1 as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, advanceState, assertValidRun, buildCheck, buildGoal, buildHtmlDocEntry, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, classifyStatusChange, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, initialRunState, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeFormats, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, regenerateRun, renderCheck, renderGoal, renderTriage, resolveAttachment, resolveAttachments, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toStoryReport, toTraceabilityMatrix, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };
+export { type AnchorResolution, type AnchorState, type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, Attachment, type BehaviorDebuggerIssue, type BehaviorDiff, type BehaviorDiffEntry, type BehaviorManifest, BehaviorManifestJsonFormatter, type BehaviorManifestJsonOptions, type BehaviorSourceFile, type BehaviorTag, type BundleOptions, type BundleResult, CIProvider, type CanonicalizeOptions, type ChangeType, type ChangedFile, type ChangedFileReview, type CheckArgs, type CheckDeps, type CheckFailure, type CheckReport, type CheckStep, type CodeDiffAnnotation, type CodeDiffAnnotationInput, type CodeDiffEvidence, type CodeDiffInput, type CodeDiffScenarioRef, type CodeDiffSidecar, type CodeDiffSidecarAnnotation, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, type DeploymentEntry, type DeploymentLedger, type DeploymentStatus, type DiffAnchor, type DiffHunk, type DiffLine, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, type EnvironmentDrift, type EvidenceStrength, type ExecutableStoriesConfig, type FetchFn, type FileChangeKind, type FileDiff, type FlakinessLevel, type Formatter, type FormatterOptions, type GenerateArgs, type GenerateCompareResult, type GenerateDeps, type GenerateResult, type GenericWebhookNotifierOptions, type GoalArgs, type GoalDeps, type GoalReport, type GoalRequirementResult, type HistoryEntry, type HistoryStore, type HtmlDocOptions, type IJsonDataTable, type IJsonDocString, type IJsonEmbedding, type IJsonFeature, type IJsonScenario, type IJsonStep, type IJsonStepArgument, type IJsonStepResult, type IJsonTableRow, type IJsonTag, JUnitFormatter, type JUnitOptions, type JiraAuth, type JiraPublishMode, type ListScenariosArgs, type ListScenariosDeps, type Logger, MIN_FLAKINESS_SAMPLES, MIN_METRIC_SAMPLES, MIN_PERF_SAMPLES, MarkdownFormatter, type MarkdownFormatterOptions, type MarkdownOptions, type MarkdownRenderers, NormalizedTicket, type NotificationSummary, type NotifyCondition, OtelSpan, type OtelTraceContext, type OutputConfig, type OutputFormat, type OutputMode, type OutputRule, type PerformanceTrend, type PublishConfluenceArgs, type PublishConfluenceDeps, type PublishConfluenceResult, type PublishJiraArgs, type PublishJiraDeps, type PublishJiraResult, type RatchetViolation, RawAttachment, RawCIInfo, RawRun, RawStatus, type RecordDeploymentArgs, type RecordDeploymentResult, type ReleaseManifest, ReleaseManifestFormatter, type ReportAttachment, type ReportCIInfo, type ReportCoverageSummary, type ReportDocCode, type ReportDocCustom, type ReportDocEntry, type ReportDocKv, type ReportDocLink, type ReportDocMermaid, type ReportDocNote, type ReportDocScreenshot, type ReportDocSection, type ReportDocTable, type ReportDocTag, type ReportFeature, ReportGenerator, type ReportScenario, type ReportStep, type ReportSummary, type ReportTicket, type ResolvedFormatterOptions, type ReviewAudience, type ReviewBand, type ReviewClaim, type ReviewContext, ReviewHtmlFormatter, type ReviewHtmlOptions, ReviewMarkdownFormatter, type ReviewMarkdownOptions, type ReviewResult, type ReviewSummary, RunDiffChangelogFormatter, type RunDiffChangelogOptions, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type RunState, STORY_REPORT_SCHEMA_MAJOR, STORY_REPORT_SCHEMA_VERSION, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioIndex, type ScenarioIndexFilters, type ScenarioIndexItem, ScenarioIndexJsonFormatter, type ScenarioIndexJsonOptions, type ScenarioIndexStep, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, StepKeyword$1 as StepKeyword, StepResult, type StoryReport, StoryReportJsonFormatter, type StoryReportJsonOptions, type StoryReportSchemaVersion, StoryStep, TestCaseResult, type TestHistory, type TestMetrics, TestRunResult, TestStatus$1 as TestStatus, type TraceabilityMatrix, TraceabilityMatrixFormatter, type TraceabilityRequirement, type TriageArgs, type TriageDeps, type TriageItem, type TriageReport, CIInfo$1 as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, advanceState, assembleCodeDiff, assertValidRun, buildCheck, buildGoal, buildHtmlDocEntry, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, classifyStatusChange, clearVersionCache, codeDiffDiagnostics, computeTestMetrics, copyMarkdownAssets, createAnchor, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, initialRunState, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeFormats, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, parseUnifiedDiff, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, regenerateRun, relocateAnchor, renderCheck, renderGoal, renderTriage, resolveAttachment, resolveAttachments, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toStoryReport, toTraceabilityMatrix, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };