executable-stories-formatters 1.0.1 → 1.1.0

package/dist/index.d.cts

@@ -1,27 +1,33 @@
-import { TestRunResult, TestCaseResult, TestStatus, Attachment } from 'executable-stories-core/types/test-result';
-export { Attachment, CIInfo, CoverageSummary, StepResult, TestCaseAttempt, TestCaseEvidence, TestCaseResult, TestRunResult, TestStatus } from 'executable-stories-core/types/test-result';
-import { StoryStep, DocEntry, NormalizedTicket, StepKeyword } from 'executable-stories-core/types/story';
-export { DocEntry, DocPhase, NormalizedTicket, STORY_META_KEY, StepKeyword, StepMode, StoryMeta, StoryStep } from 'executable-stories-core/types/story';
-import { CIInfo, CIProvider } from 'executable-stories-core/types/ci';
-export { CIProvider, CIInfo as TypedCIInfo, toCIInfo, toRawCIInfo } from 'executable-stories-core/types/ci';
-import { adaptJestRun, adaptPlaywrightRun, adaptVitestRun } from './adapters.cjs';
-export { JestAdapterOptions, JestAggregatedResult, JestFileResult, JestTestResult, PlaywrightAdapterOptions, PlaywrightAnnotation, PlaywrightAttachment, PlaywrightError, PlaywrightLocation, PlaywrightStatus, PlaywrightTestCase, PlaywrightTestResult, StoryFileReport, VitestAdapterOptions, VitestSerializedError, VitestState, VitestTestCase, VitestTestModule, VitestTestResult } from './adapters.cjs';
-export { OtelAttributeValue, OtelSpan } from 'executable-stories-core/types/otel';
-import { RawCIInfo } from 'executable-stories-core/types/raw';
-export { RawAttachment, RawCIInfo, RawRun, RawStatus, RawStepEvent, RawTestCase } from 'executable-stories-core/types/raw';
-import { StoryReport, TestStatus as TestStatus$1, ReportStep } from 'executable-stories-core/types/story-report';
-export { ReportAttachment, ReportCIInfo, ReportCoverageSummary, ReportDocCode, ReportDocCustom, ReportDocEntry, ReportDocKv, ReportDocLink, ReportDocMermaid, ReportDocNote, ReportDocScreenshot, ReportDocSection, ReportDocTable, ReportDocTag, ReportFeature, ReportScenario, ReportStep, ReportSummary, ReportTicket, STORY_REPORT_SCHEMA_MAJOR, STORY_REPORT_SCHEMA_VERSION, StoryReport, StoryReportSchemaVersion } from 'executable-stories-core/types/story-report';
-export { ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES } from 'executable-stories-core/theme/tokens';
-export { canonicalizeRun, deriveStepResults, generateRunId, generateTestCaseId, mergeStepResults, normalizeStatus, resolveAttachment, resolveAttachments, slugify } from 'executable-stories-core/converters/acl/index';
-export { ValidationResult, assertValidRun, validateCanonicalRun } from 'executable-stories-core/converters/acl/validate';
-export { RunState, advanceState, initialRunState } from 'executable-stories-core';
-export { toStoryReport } from 'executable-stories-core/converters/story-report';
-import { Envelope } from 'executable-stories-core/types/cucumber-messages';
-export { parseEnvelopes, parseNdjson } from 'executable-stories-core/converters/ndjson-parser';
-export { formatDuration, msToNanoseconds, nanosecondsToMs } from 'executable-stories-core/utils/duration';
-export { HtmlDocOptions, buildHtmlDocEntry } from 'executable-stories-core/utils/doc-builders';
-import { CanonicalizeOptions } from 'executable-stories-core/types/canonicalize';
-export { CanonicalizeOptions } from 'executable-stories-core/types/canonicalize';
+import { C as CIInfo$1, a as CIProvider, T as TestRunResult, b as TestCaseResult, S as StoryStep, D as DocEntry, c as TestStatus$1, N as NormalizedTicket, A as Attachment, d as DocPhase, O as OtelSpan, R as RawStatus, e as StepResult, f as RawAttachment, g as RawRun, h as RawCIInfo, i as StepKeyword$1, j as adaptJestRun, k as adaptPlaywrightRun, l as adaptVitestRun } from './index-Cfs2L3di.cjs';
+export { m as CIInfo, n as CoverageSummary, J as JestAdapterOptions, o as JestAggregatedResult, p as JestFileResult, q as JestTestResult, r as OtelAttributeValue, P as PlaywrightAdapterOptions, s as PlaywrightAnnotation, t as PlaywrightAttachment, u as PlaywrightError, v as PlaywrightLocation, w as PlaywrightStatus, x as PlaywrightTestCase, y as PlaywrightTestResult, z as RawStepEvent, B as RawTestCase, E as STORY_META_KEY, F as StepMode, G as StoryFileReport, H as StoryMeta, I as TestCaseAttempt, K as TestCaseEvidence, V as VitestAdapterOptions, L as VitestSerializedError, M as VitestState, Q as VitestTestCase, U as VitestTestModule, W as VitestTestResult, X as toCIInfo, Y as toRawCIInfo } from './index-Cfs2L3di.cjs';
+
+/**
+ * Configuration options for ACL and formatters.
+ */
+/** Options for canonicalizing raw run data */
+interface CanonicalizeOptions {
+    /** Attachment handling options */
+    attachments?: {
+        /** Max bytes before attachment becomes external link. Default: 512KB (524288) */
+        maxEmbedBytes?: number;
+        /** Directory for external attachments */
+        externalDir?: string;
+    };
+    /** Cucumber compatibility options */
+    cucumber?: {
+        /** Include trailing space in keywords (e.g., "Given "). Default: true */
+        keywordSpacing?: boolean;
+        /** Generate deterministic line numbers. Default: true */
+        deterministicLines?: boolean;
+    };
+    /** Default timestamps if not provided in raw data */
+    defaults?: {
+        /** Default start time (epoch ms). Default: Date.now() */
+        startedAtMs?: number;
+        /** Default finish time (epoch ms). Default: Date.now() */
+        finishedAtMs?: number;
+    };
+}
 
 /**
  * Notification types for webhook integrations (Slack, Teams).
@@ -39,7 +45,7 @@ interface NotificationSummary {
         name: string;
         error?: string;
     }>;
-    ci?: CIInfo;
+    ci?: CIInfo$1;
     reportUrl?: string;
 }
 /** When to send notifications. */
@@ -71,6 +77,51 @@ interface WebhookPayload {
     summary: NotificationSummary;
 }
 
+/**
+ * Types for history tracking and test metrics.
+ */
+
+interface HistoryEntry {
+    runId: string;
+    timestamp: number;
+    status: "passed" | "failed" | "skipped" | "pending";
+    durationMs: number;
+    ci?: {
+        provider?: CIProvider;
+        branch?: string;
+        commitSha?: string;
+    };
+}
+interface TestHistory {
+    testId: string;
+    testName: string;
+    sourceFile: string;
+    sourceLine?: number;
+    entries: HistoryEntry[];
+}
+interface HistoryStore {
+    version: 1;
+    maxRuns: number;
+    tests: Record<string, TestHistory>;
+    lastUpdated: number;
+}
+type StabilityGrade = "A" | "B" | "C" | "D" | "F";
+type FlakinessLevel = "stable" | "unstable" | "flaky";
+type PerformanceTrend = "improving" | "stable" | "regressing";
+interface TestMetrics {
+    testId: string;
+    flakinessLevel: FlakinessLevel;
+    flakinessScore: number;
+    failureRate: number;
+    stabilityGrade: StabilityGrade;
+    performanceTrend: PerformanceTrend;
+    avgDurationMs: number;
+    passRate: number;
+    longestPassStreak: number;
+    consecutiveFailures: number;
+    sampleSize: number;
+}
+
 /**
  * Confluence (ADF) Formatter — Layer 3.
  *
@@ -256,7 +307,16 @@ interface FormatterOptions {
         syntaxHighlighting?: boolean;
         /** Enable live Mermaid diagram rendering (via Mermaid.js CDN). Default: true */
         mermaidEnabled?: boolean;
+        /** Days before the report shows a stale warning. 0 disables. Default: 7 */
+        staleAfterDays?: number;
     };
+    /**
+     * Run history store (see loadHistory/updateHistory). When set, the HTML
+     * report embeds each scenario's recent run history so cards can show a
+     * run-over-run timeline. Update the store with the current run before
+     * passing it so the report includes this run as the latest entry.
+     */
+    historyStore?: HistoryStore;
     /** JUnit XML specific options */
     junit?: {
         /** Test suite name. Default: "Test Suite" */
@@ -419,7 +479,9 @@ interface ResolvedFormatterOptions {
         title: string;
         syntaxHighlighting: boolean;
         mermaidEnabled: boolean;
+        staleAfterDays: number;
     };
+    historyStore: HistoryStore | undefined;
     junit: {
         suiteName: string;
         includeOutput: boolean;
@@ -498,7 +560,7 @@ interface ScenarioSnapshot {
     scenario: string;
     sourceFile: string;
     sourceLine: number;
-    status: TestStatus;
+    status: TestStatus$1;
     durationMs: number;
     tags: string[];
     titlePath: string[];
@@ -546,7 +608,7 @@ interface RunDiffResult {
     summary: RunDiffSummary;
     scenarios: ScenarioDiff[];
 }
-type CompareFormat = "html" | "markdown";
+type CompareFormat = "html" | "markdown" | "changelog";
 interface CompareFormatterOptions {
     title?: string;
 }
@@ -665,6 +727,207 @@ interface ExecutableStoriesConfig {
     formatters?: Record<string, Formatter>;
 }
 
+/**
+ * StoryReport — public, frozen contract for UI renderers.
+ *
+ * Distinct from internal TestRunResult. Pre-grouped feature → scenario tree,
+ * with pre-computed summaries at every level. Adapter concerns (rawStatus,
+ * projectName, titlePath) are stripped at the toStoryReport boundary.
+ *
+ * Versioning: semver-style "<major>.<minor>". Additive-only within a major.
+ * Source of truth: schemas/story-report-v1.json. Types here must stay in sync.
+ */
+
+type StoryReportSchemaVersion = `1.${number}`;
+type TestStatus = "passed" | "failed" | "skipped" | "pending";
+type StepKeyword = "Given" | "When" | "Then" | "And" | "But";
+type StepMode = "normal" | "skip" | "only" | "todo" | "fails" | "concurrent";
+interface ReportSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    pending: number;
+    durationMs: number;
+}
+interface ReportTicket {
+    id: string;
+    url?: string;
+}
+interface ReportAttachment {
+    name: string;
+    mediaType: string;
+    body: string;
+    contentEncoding: "BASE64" | "IDENTITY";
+}
+interface ReportCIInfo {
+    name: string;
+    url?: string;
+    buildNumber?: string;
+    branch?: string;
+    commitSha?: string;
+    prNumber?: string;
+}
+interface ReportCoverageSummary {
+    linesPct?: number;
+    branchesPct?: number;
+    functionsPct?: number;
+    statementsPct?: number;
+}
+type ReportDocEntry = ReportDocNote | ReportDocTag | ReportDocKv | ReportDocCode | ReportDocTable | ReportDocLink | ReportDocSection | ReportDocMermaid | ReportDocScreenshot | ReportDocVideo | ReportDocHtml | ReportDocCustom;
+interface ReportDocNote {
+    kind: "note";
+    text: string;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocTag {
+    kind: "tag";
+    names: string[];
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocKv {
+    kind: "kv";
+    label: string;
+    value: unknown;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocCode {
+    kind: "code";
+    label: string;
+    content: string;
+    lang?: string;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocTable {
+    kind: "table";
+    label: string;
+    columns: string[];
+    rows: string[][];
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocLink {
+    kind: "link";
+    label: string;
+    url: string;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocSection {
+    kind: "section";
+    title: string;
+    markdown: string;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocMermaid {
+    kind: "mermaid";
+    code: string;
+    title?: string;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocScreenshot {
+    kind: "screenshot";
+    path: string;
+    alt?: string;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocVideo {
+    kind: "video";
+    path: string;
+    caption?: string;
+    poster?: string;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocHtml {
+    kind: "html";
+    /** Local HTML file path (exactly one of path/url/content) */
+    path?: string;
+    /** Remote URL rendered via iframe src (exactly one of path/url/content) */
+    url?: string;
+    /** Inline HTML content rendered via iframe srcdoc (exactly one of path/url/content) */
+    content?: string;
+    title?: string;
+    /** Iframe height: number → px, string passed through (e.g. "60vh"). Default 400px. */
+    height?: number | string;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportDocCustom {
+    kind: "custom";
+    type: string;
+    data: unknown;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
+interface ReportStep {
+    id: string;
+    index: number;
+    keyword: StepKeyword;
+    text: string;
+    status: TestStatus;
+    durationMs: number;
+    errorMessage?: string;
+    mode?: StepMode;
+    docEntries: ReportDocEntry[];
+}
+interface ReportScenario {
+    id: string;
+    title: string;
+    status: TestStatus;
+    /**
+     * True for scenarios authored with the framework's todo modifier
+     * (e.g. `it.todo`): specified behavior with no implementation yet.
+     * Canonical status stays "pending"; this flags why.
+     */
+    planned?: boolean;
+    durationMs: number;
+    tags: string[];
+    tickets?: ReportTicket[];
+    /** Product-code paths/globs this scenario exercises (project-root-relative). */
+    covers?: string[];
+    sourceLine?: number;
+    errorMessage?: string;
+    errorStack?: string;
+    retry: number;
+    retries: number;
+    docEntries: ReportDocEntry[];
+    steps: ReportStep[];
+    attachments: ReportAttachment[];
+    /** OTel spans for the trace waterfall (carried through from the run). */
+    otelSpans?: OtelSpan[];
+}
+interface ReportFeature {
+    id: string;
+    title: string;
+    sourceFile: string;
+    summary: ReportSummary;
+    scenarios: ReportScenario[];
+}
+interface StoryReport {
+    schemaVersion: StoryReportSchemaVersion;
+    runId: string;
+    startedAtMs: number;
+    finishedAtMs: number;
+    durationMs: number;
+    projectRoot: string;
+    packageVersion?: string;
+    gitSha?: string;
+    ci?: ReportCIInfo;
+    coverage?: ReportCoverageSummary;
+    summary: ReportSummary;
+    features: ReportFeature[];
+}
+declare const STORY_REPORT_SCHEMA_VERSION: StoryReportSchemaVersion;
+declare const STORY_REPORT_SCHEMA_MAJOR: 1;
+
 /**
  * Review types — the model behind the Evidence-Driven Review report.
  *
@@ -726,7 +989,7 @@ interface ReviewClaim {
     sourceFile: string;
     sourceLine: number;
     /** Test outcome. */
-    status: TestStatus;
+    status: TestStatus$1;
     /** Derived from file convention / `audience:` tag. */
     audience: ReviewAudience;
     /** Declared via `change:*` tag (defaults to `unknown`). */
@@ -777,6 +1040,239 @@ interface ReviewResult {
     changedFiles: ChangedFileReview[];
 }
 
+/**
+ * Canonical executable-stories theme tokens (--es-*).
+ *
+ * Source of truth for the `--es-color-*`, `--es-space-*`, `--es-font-*`,
+ * `--es-size-*`, `--es-radius`, `--es-line`, and `--es-measure` CSS custom
+ * properties consumed by:
+ *
+ * - executable-stories-react (styles.css)
+ * - executable-stories-formatters HTML report (CSS_STYLES, via this module)
+ *
+ * Consumer-side overrides on `:root` or any ancestor of the report cascade
+ * through both: setting `--es-color-failed: red` on body re-colors failures
+ * in both the standalone HTML report and the React component.
+ *
+ * The HTML formatter's pre-existing tokens (--success, --error, etc.)
+ * remain in place for backward compatibility; the --es-* tokens are emitted
+ * alongside them as the public override surface.
+ */
+declare const ES_THEME_TOKENS_CSS: string;
+/**
+ * JS-level mirror of the token values (for cases where TypeScript code needs
+ * to read them — e.g., dynamic style injection or theme generators).
+ */
+declare const ES_THEME_TOKEN_VALUES: {
+    readonly light: {
+        readonly "--es-color-bg": "#ffffff";
+        readonly "--es-color-fg": "#111827";
+        readonly "--es-color-muted": "#6b7280";
+        readonly "--es-color-border": "#e5e7eb";
+        readonly "--es-color-surface": "#f9fafb";
+        readonly "--es-color-link": "#2563eb";
+        readonly "--es-color-passed": "#16a34a";
+        readonly "--es-color-failed": "#dc2626";
+        readonly "--es-color-skipped": "#9ca3af";
+        readonly "--es-color-pending": "#d97706";
+    };
+    readonly dark: {
+        readonly "--es-color-bg": "#0b0f17";
+        readonly "--es-color-fg": "#e5e7eb";
+        readonly "--es-color-muted": "#9ca3af";
+        readonly "--es-color-border": "#1f2937";
+        readonly "--es-color-surface": "#111827";
+        readonly "--es-color-link": "#60a5fa";
+        readonly "--es-color-passed": "#4ade80";
+        readonly "--es-color-failed": "#f87171";
+        readonly "--es-color-skipped": "#6b7280";
+        readonly "--es-color-pending": "#fbbf24";
+    };
+};
+
+/**
+ * Status mapping from raw framework statuses to canonical TestStatus.
+ */
+
+/**
+ * Convert a raw status to canonical TestStatus.
+ *
+ * @param raw - The raw status from a framework
+ * @returns The canonical TestStatus
+ */
+declare function normalizeStatus(raw: RawStatus): TestStatus$1;
+
+/**
+ * ID generation and slug helpers for deterministic, Cucumber-compatible IDs.
+ */
+/**
+ * Generate a deterministic test case ID from source file and scenario name.
+ *
+ * @param sourceFile - The source file path
+ * @param scenario - The scenario name
+ * @returns A 12-character hex ID
+ */
+declare function generateTestCaseId(sourceFile: string, scenario: string): string;
+/**
+ * Generate a deterministic run ID from timestamp and project root.
+ *
+ * @param startedAtMs - Run start timestamp
+ * @param projectRoot - Project root directory
+ * @returns A 16-character hex ID
+ */
+declare function generateRunId(startedAtMs: number, projectRoot: string): string;
+/**
+ * Slugify a string for Cucumber JSON IDs.
+ *
+ * Converts to lowercase, replaces path separators/spaces with hyphens,
+ * removes other special chars, and trims leading/trailing hyphens.
+ *
+ * @param text - The text to slugify
+ * @returns A URL-safe slug
+ */
+declare function slugify(text: string): string;
+
+/**
+ * Step fallback rules for deriving step results from scenario status.
+ *
+ * When frameworks don't provide step-level results, we derive them
+ * from the overall scenario status using these rules.
+ */
+
+/**
+ * Derive step results from story steps and scenario status.
+ *
+ * Rules:
+ * - Passed: All steps are passed
+ * - Skipped/Pending: All steps are skipped/pending
+ * - Failed: Steps up to failure are passed, failing step is failed, rest are skipped
+ *   (Heuristic: last step is the failure, or use error info if available)
+ *
+ * @param steps - Story steps with keywords and text
+ * @param scenarioStatus - Overall scenario status
+ * @param error - Optional error information to help identify failing step
+ * @returns Array of step results
+ */
+declare function deriveStepResults(steps: StoryStep[], scenarioStatus: TestStatus$1, error?: {
+    message?: string;
+    stack?: string;
+}): StepResult[];
+/**
+ * Merge raw step events with derived step results.
+ *
+ * When we have partial step data from the framework, merge it with
+ * the derived results, preferring actual data over derived.
+ *
+ * @param derived - Derived step results from fallback rules
+ * @param events - Raw step events from framework (if any)
+ * @returns Merged step results
+ */
+declare function mergeStepResults(derived: StepResult[], events?: Array<{
+    index?: number;
+    stepId?: string;
+    status?: string;
+    durationMs?: number;
+    errorMessage?: string;
+}>): StepResult[];
+
+/**
+ * Attachment resolution: embed vs link decision.
+ *
+ * Attachments can either be embedded inline (base64) or linked to
+ * external files based on size thresholds.
+ */
+
+/** Options for attachment resolution */
+interface AttachmentOptions {
+    /** Max bytes before attachment becomes external link. Default: 512KB */
+    maxEmbedBytes?: number;
+    /** Directory for external attachments */
+    externalDir?: string;
+    /** Project root for relative paths */
+    projectRoot?: string;
+}
+/**
+ * Resolve a raw attachment to a canonical attachment.
+ *
+ * Decision logic:
+ * 1. If body is already provided, use it (check size for encoding decision)
+ * 2. If path is provided, read file and decide embed vs link
+ * 3. For large files, return a URL reference instead of embedding
+ *
+ * @param raw - Raw attachment from framework
+ * @param options - Resolution options
+ * @returns Resolved canonical attachment
+ */
+declare function resolveAttachment(raw: RawAttachment, options?: AttachmentOptions): Attachment;
+/**
+ * Resolve multiple attachments.
+ *
+ * @param attachments - Raw attachments array
+ * @param options - Resolution options
+ * @returns Resolved canonical attachments
+ */
+declare function resolveAttachments(attachments: RawAttachment[] | undefined, options?: AttachmentOptions): Attachment[];
+
+/**
+ * Anti-Corruption Layer (ACL) - Layer 2.
+ *
+ * Transforms permissive RawRun data from framework adapters into
+ * strict canonical TestRunResult for formatters.
+ */
+
+/**
+ * Canonicalize a raw run into a strict TestRunResult.
+ *
+ * This is the main entry point for the ACL. It:
+ * - Enforces required fields with defaults
+ * - Normalizes statuses to TestStatus enum
+ * - Applies step fallback rules
+ * - Resolves attachments (embed vs link)
+ * - Generates deterministic IDs
+ *
+ * @param raw - Raw run data from a framework adapter
+ * @param options - Canonicalization options
+ * @returns Strict canonical TestRunResult
+ */
+declare function canonicalizeRun(raw: RawRun, options?: CanonicalizeOptions): TestRunResult;
+
+/**
+ * Validation helpers for canonical TestRunResult.
+ *
+ * Used in tests to verify ACL output meets all invariants.
+ */
+
+/** Validation result */
+interface ValidationResult {
+    /** Whether the run is valid */
+    valid: boolean;
+    /** List of validation errors */
+    errors: string[];
+}
+/**
+ * Validate a canonical TestRunResult.
+ *
+ * Checks:
+ * - All required fields are present
+ * - stepResults length matches story.steps length
+ * - stepResults indexes are valid and unique
+ * - Durations are non-negative
+ * - Timestamps are valid
+ *
+ * @param run - The TestRunResult to validate
+ * @returns Validation result with errors if any
+ */
+declare function validateCanonicalRun(run: TestRunResult): ValidationResult;
+/**
+ * Assert that a run is valid, throwing if not.
+ *
+ * Useful in tests.
+ *
+ * @param run - The TestRunResult to validate
+ * @throws Error if validation fails
+ */
+declare function assertValidRun(run: TestRunResult): void;
+
 /**
  * Cucumber JSON Formatter - Layer 3.
  *
@@ -896,7 +1392,7 @@ interface ScenarioIndex {
 interface ScenarioIndexItem {
     id: string;
     title: string;
-    status: TestStatus$1;
+    status: TestStatus;
     feature: string;
     sourceFile: string;
     sourceLine?: number;
@@ -919,13 +1415,13 @@ interface ScenarioIndexStep {
     index: number;
     keyword: ReportStep["keyword"];
     text: string;
-    status: TestStatus$1;
+    status: TestStatus;
     durationMs: number;
     errorMessage?: string;
     docKinds: string[];
 }
 interface ScenarioIndexFilters {
-    statuses?: TestStatus$1[];
+    statuses?: TestStatus[];
     tags?: string[];
     sourceFiles?: string[];
 }
@@ -1039,13 +1535,367 @@ interface WatchHandle {
  */
 declare function startWatch(options: WatchOptions, deps?: WatchDeps): WatchHandle;
 
+/**
+ * Cucumber Messages types for NDJSON output.
+ *
+ * Minimal own types (no @cucumber/messages dependency) — consistent with
+ * the project's zero-external-deps-at-runtime approach.
+ *
+ * Based on the Cucumber Messages protocol:
+ * https://github.com/cucumber/messages
+ */
+/** Protobuf-style timestamp { seconds, nanos } */
+interface Timestamp {
+    seconds: number;
+    nanos: number;
+}
+/** Protobuf-style duration { seconds, nanos } */
+interface Duration {
+    seconds: number;
+    nanos: number;
+}
+/** Location in a source file */
+interface Location {
+    line: number;
+    column?: number;
+}
+interface Meta {
+    protocolVersion: string;
+    implementation: {
+        name: string;
+        version: string;
+    };
+    runtime: {
+        name: string;
+        version: string;
+    };
+    os: {
+        name: string;
+    };
+    cpu: {
+        name: string;
+    };
+}
+interface Source {
+    uri: string;
+    data: string;
+    mediaType: "text/x.cucumber.gherkin+plain";
+}
+interface Tag {
+    location: Location;
+    name: string;
+    id: string;
+}
+type KeywordType = "Unknown" | "Context" | "Action" | "Outcome" | "Conjunction";
+interface DocString {
+    location: Location;
+    mediaType?: string;
+    content: string;
+    delimiter: string;
+}
+interface TableCell {
+    location: Location;
+    value: string;
+}
+interface TableRow {
+    location: Location;
+    cells: TableCell[];
+    id: string;
+}
+interface DataTable {
+    location: Location;
+    rows: TableRow[];
+}
+interface Step {
+    location: Location;
+    keyword: string;
+    keywordType: KeywordType;
+    text: string;
+    id: string;
+    docString?: DocString;
+    dataTable?: DataTable;
+}
+interface Scenario {
+    location: Location;
+    tags: Tag[];
+    keyword: string;
+    name: string;
+    description: string;
+    steps: Step[];
+    id: string;
+}
+interface Background {
+    location: Location;
+    keyword: string;
+    name: string;
+    description: string;
+    steps: Step[];
+    id: string;
+}
+type FeatureChild = {
+    background: Background;
+    scenario?: undefined;
+} | {
+    scenario: Scenario;
+    background?: undefined;
+};
+interface Feature {
+    location: Location;
+    tags: Tag[];
+    language: string;
+    keyword: string;
+    name: string;
+    description: string;
+    children: FeatureChild[];
+}
+interface GherkinDocument {
+    uri: string;
+    feature: Feature;
+}
+type PickleStepType = "Unknown" | "Context" | "Action" | "Outcome";
+interface PickleDocString {
+    mediaType?: string;
+    content: string;
+}
+interface PickleTableCell {
+    value: string;
+}
+interface PickleTableRow {
+    cells: PickleTableCell[];
+}
+interface PickleTable {
+    rows: PickleTableRow[];
+}
+interface PickleStepArgument {
+    docString?: PickleDocString;
+    dataTable?: PickleTable;
+}
+interface PickleStep {
+    astNodeIds: string[];
+    id: string;
+    type: PickleStepType;
+    text: string;
+    argument?: PickleStepArgument;
+}
+interface PickleTag {
+    name: string;
+    astNodeId: string;
+}
+interface Pickle {
+    id: string;
+    uri: string;
+    name: string;
+    language: string;
+    steps: PickleStep[];
+    tags: PickleTag[];
+    astNodeIds: string[];
+}
+type TestStepResultStatus = "UNKNOWN" | "PASSED" | "SKIPPED" | "PENDING" | "UNDEFINED" | "AMBIGUOUS" | "FAILED";
+interface TestStepResult {
+    duration: Duration;
+    status: TestStepResultStatus;
+    message?: string;
+}
+interface TestStep {
+    id: string;
+    pickleStepId?: string;
+    stepDefinitionIds?: string[];
+}
+interface TestCase {
+    id: string;
+    pickleId: string;
+    testSteps: TestStep[];
+}
+interface TestRunStarted {
+    timestamp: Timestamp;
+}
+interface TestCaseStarted {
+    id: string;
+    testCaseId: string;
+    timestamp: Timestamp;
+    attempt: number;
+}
+interface TestStepStarted {
+    testCaseStartedId: string;
+    testStepId: string;
+    timestamp: Timestamp;
+}
+interface TestStepFinished {
+    testCaseStartedId: string;
+    testStepId: string;
+    testStepResult: TestStepResult;
+    timestamp: Timestamp;
+}
+interface TestCaseFinished {
+    testCaseStartedId: string;
+    timestamp: Timestamp;
+    willBeRetried: boolean;
+}
+interface TestRunFinished {
+    timestamp: Timestamp;
+    success: boolean;
+}
+type AttachmentContentEncoding = "IDENTITY" | "BASE64";
+interface CucumberAttachment {
+    testCaseStartedId: string;
+    testStepId?: string;
+    body: string;
+    mediaType: string;
+    contentEncoding: AttachmentContentEncoding;
+}
+/**
+ * Each NDJSON line is one Envelope with exactly one field set.
+ */
+type Envelope = {
+    meta: Meta;
+} | {
+    source: Source;
+} | {
+    gherkinDocument: GherkinDocument;
+} | {
+    pickle: Pickle;
+} | {
+    testRunStarted: TestRunStarted;
+} | {
+    testCase: TestCase;
+} | {
+    testCaseStarted: TestCaseStarted;
+} | {
+    testStepStarted: TestStepStarted;
+} | {
+    testStepFinished: TestStepFinished;
+} | {
+    testCaseFinished: TestCaseFinished;
+} | {
+    testRunFinished: TestRunFinished;
+} | {
+    attachment: CucumberAttachment;
+};
+
+/**
+ * Convert a canonical TestRunResult into a frozen-shape StoryReport for UI renderers.
+ */
+declare function toStoryReport(run: TestRunResult): StoryReport;
+
+/**
+ * NDJSON-to-TestRunResult parser.
+ *
+ * Parses Cucumber Messages NDJSON (one JSON envelope per line) back into
+ * a TestRunResult suitable for rendering by HtmlFormatter or other formatters.
+ *
+ * This is the NDJSON compat path: it produces a minimal but sufficient
+ * TestRunResult. Fields not present in the NDJSON stream are given
+ * sensible defaults.
+ */
+
+/**
+ * Parse an NDJSON string into a TestRunResult.
+ *
+ * @param ndjson - NDJSON string (one JSON envelope per line)
+ * @returns TestRunResult reconstructed from the envelopes
+ */
+declare function parseNdjson(ndjson: string): TestRunResult;
+/**
+ * Parse an array of Envelope objects into a TestRunResult.
+ *
+ * @param envelopes - Array of Cucumber Messages envelopes
+ * @returns TestRunResult reconstructed from the envelopes
+ */
+declare function parseEnvelopes(envelopes: Envelope[]): TestRunResult;
+
+/**
+ * Session trajectory primitive — the valuable part of the old `serve.ts`.
+ *
+ * Pins a session baseline (the first run observed) and folds each subsequent run
+ * forward, so a docs/agent loop can show "how this run compares to where the
+ * session started" rather than just the noise between adjacent runs. Pure (no
+ * I/O, no diff engine) so it lives in core and is consumable by the Astro
+ * integration and the CLI alike. Diffing the runs is layered on top by the
+ * consumer (the diff engine lives in the formatters package).
+ */
+
+/**
+ * The realtime state a live view renders. The session baseline is pinned to the
+ * first run observed after boot, so the headline tracks the whole loop's
+ * trajectory rather than the noise between any two adjacent iterations.
+ */
+interface RunState {
+    /** First run observed this session — the trajectory anchor. */
+    sessionBaseline: TestRunResult | null;
+    /** The run immediately before {@link RunState.current} — the per-iteration anchor. */
+    previous: TestRunResult | null;
+    /** Latest run. */
+    current: TestRunResult | null;
+    /** How many runs have been observed since boot. */
+    runCount: number;
+}
+/** The empty state before any run has been observed. */
+declare const initialRunState: RunState;
+/**
+ * Fold a freshly-read run into the prior state. The first run pins the session
+ * baseline; later runs shift `previous`/`current` forward. Pure.
+ */
+declare function advanceState(prev: RunState, run: TestRunResult): RunState;
+
+/**
+ * Canonical builders for doc entries whose construction carries a rule worth
+ * keeping in one place. Adapters import these instead of re-implementing the
+ * logic (the `html` exactly-one-of-source rule was previously copied verbatim
+ * across the Vitest, Jest, Cypress, and Playwright adapters).
+ */
+
+/** Source/presentation options for an `html` doc entry. */
+interface HtmlDocOptions {
+    /** Local HTML file path (inlined into the report by default). */
+    path?: string;
+    /** Remote URL rendered via iframe src. */
+    url?: string;
+    /** Inline HTML content rendered via iframe srcdoc. */
+    content?: string;
+    title?: string;
+    /** Iframe height: number → px, string passed through (e.g. '60vh'). Default 400px. */
+    height?: number | string;
+}
+/**
+ * Build an `html` DocEntry, enforcing that exactly one of path/url/content is
+ * set. Throws otherwise — this is the single source of that rule.
+ */
+declare function buildHtmlDocEntry(options: HtmlDocOptions): DocEntry;
+
+/**
+ * Duration formatting utilities.
+ */
+/**
+ * Format milliseconds as human-readable duration.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted string (e.g., "123 ms", "1.5 s", "2m 30s")
+ */
+declare function formatDuration(ms: number): string;
+/**
+ * Convert milliseconds to nanoseconds.
+ *
+ * Used for Cucumber JSON format which expects nanoseconds.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Duration in nanoseconds
+ */
+declare function msToNanoseconds(ms: number): number;
+/**
+ * Convert nanoseconds to milliseconds.
+ *
+ * @param ns - Duration in nanoseconds
+ * @returns Duration in milliseconds
+ */
+declare function nanosecondsToMs(ns: number): number;
+
 interface BehaviorDiffEntry {
     id: string;
     title: string;
     sourceFile: string;
     kind: ScenarioChangeKind;
-    baselineStatus?: TestStatus$1;
-    currentStatus?: TestStatus$1;
+    baselineStatus?: TestStatus;
+    currentStatus?: TestStatus;
 }
 interface BehaviorDiff {
     schemaVersion: "1.0";
@@ -1063,7 +1913,7 @@ interface BehaviorDiff {
  * Classify a single scenario's status transition between two runs.
  * Shares the `ScenarioChangeKind` vocabulary with the full compare engine.
  */
-declare function classifyStatusChange(baseline: TestStatus$1 | undefined, current: TestStatus$1 | undefined): ScenarioChangeKind;
+declare function classifyStatusChange(baseline: TestStatus | undefined, current: TestStatus | undefined): ScenarioChangeKind;
 /**
  * Scenario-level diff of two StoryReports, keyed by scenario id. Reports status
  * transitions (the agent triage signal), not the full field-by-field diff that
@@ -1529,6 +2379,22 @@ declare class RunDiffMarkdownFormatter {
     format(diff: RunDiffResult): string;
 }
 
+interface RunDiffChangelogOptions {
+    title?: string;
+}
+/**
+ * Behavior changelog between two runs: release-notes-style Markdown built
+ * from the same RunDiffResult as `compare`'s review outputs, but written for
+ * the reader of a release ("what can the product do now") rather than the
+ * reviewer of a diff. New behaviors include their Given/When/Then steps so
+ * the entry reads as a specification, not a test name.
+ */
+declare class RunDiffChangelogFormatter {
+    private readonly title;
+    constructor(options?: RunDiffChangelogOptions);
+    format(diff: RunDiffResult): string;
+}
+
 /**
  * Git information utilities.
  *
@@ -1653,7 +2519,7 @@ interface SendNotificationsDeps {
     logger: {
         warn(msg: string): void;
     };
-    toCIInfo: (raw?: RawCIInfo) => CIInfo | undefined;
+    toCIInfo: (raw?: RawCIInfo) => CIInfo$1 | undefined;
     env?: Record<string, string | undefined>;
 }
 /**
@@ -1799,51 +2665,6 @@ declare function signBody(args: {
 /** Strip ANSI escape sequences. Regex: \x1B\[[0-?]*[ -/]*[@-~] */
 declare function stripAnsi(text: string): string;
 
-/**
- * Types for history tracking and test metrics.
- */
-
-interface HistoryEntry {
-    runId: string;
-    timestamp: number;
-    status: "passed" | "failed" | "skipped" | "pending";
-    durationMs: number;
-    ci?: {
-        provider?: CIProvider;
-        branch?: string;
-        commitSha?: string;
-    };
-}
-interface TestHistory {
-    testId: string;
-    testName: string;
-    sourceFile: string;
-    sourceLine?: number;
-    entries: HistoryEntry[];
-}
-interface HistoryStore {
-    version: 1;
-    maxRuns: number;
-    tests: Record<string, TestHistory>;
-    lastUpdated: number;
-}
-type StabilityGrade = "A" | "B" | "C" | "D" | "F";
-type FlakinessLevel = "stable" | "unstable" | "flaky";
-type PerformanceTrend = "improving" | "stable" | "regressing";
-interface TestMetrics {
-    testId: string;
-    flakinessLevel: FlakinessLevel;
-    flakinessScore: number;
-    failureRate: number;
-    stabilityGrade: StabilityGrade;
-    performanceTrend: PerformanceTrend;
-    avgDurationMs: number;
-    passRate: number;
-    longestPassStreak: number;
-    consecutiveFailures: number;
-    sampleSize: number;
-}
-
 /**
  * History store: load, save, update (fn(args, deps) pattern).
  */
@@ -1966,13 +2787,13 @@ declare function listScenarios(args: ListScenariosArgs, _deps: ListScenariosDeps
 interface CheckArgs {
     testCases: TestCaseResult[];
     /** Baseline scenario statuses keyed by scenario id, for regressed/fixed deltas. */
-    baseline?: Map<string, TestStatus>;
+    baseline?: Map<string, TestStatus$1>;
     format: "text" | "json";
 }
 type CheckDeps = Record<string, never>;
 /** A single rendered step inside a failing scenario. */
 interface CheckStep {
-    keyword: StepKeyword;
+    keyword: StepKeyword$1;
     text: string;
     /** True when this step is the one that failed. */
     failed: boolean;
@@ -2090,7 +2911,7 @@ interface TriageItem {
     rank: number;
     id: string;
     scenario: string;
-    status: TestStatus;
+    status: TestStatus$1;
     /** `sourceFile:sourceLine` */
     location: string;
     /** Product-code paths to fix. Empty when the scenario declared no `covers`. */
@@ -2112,7 +2933,7 @@ interface TriageReport {
 interface TriageArgs {
     testCases: TestCaseResult[];
     /** Baseline statuses by scenario id, to flag regressions and rank them first. */
-    baseline?: Map<string, TestStatus>;
+    baseline?: Map<string, TestStatus$1>;
     format: "text" | "json";
 }
 type TriageDeps = Record<string, never>;
@@ -2342,7 +3163,7 @@ interface TraceabilityRequirement {
     scenarios: Array<{
         id: string;
         title: string;
-        status: TestStatus;
+        status: TestStatus$1;
         sourceFile: string;
         sourceLine: number;
         covers: string[];
@@ -2371,7 +3192,7 @@ interface TraceabilityMatrix {
     untraced: Array<{
         id: string;
         title: string;
-        status: TestStatus;
+        status: TestStatus$1;
         sourceFile: string;
         sourceLine: number;
     }>;
@@ -2469,7 +3290,7 @@ declare function createReportGenerator(options?: FormatterOptions, deps?: Partia
 declare function generateRunComparison(args: {
     baseline: TestRunResult;
     current: TestRunResult;
-    formats: Array<"html" | "markdown">;
+    formats: Array<"html" | "markdown" | "changelog">;
     outputDir?: string;
     outputName?: string;
     title?: string;
@@ -2494,4 +3315,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, type BehaviorDebuggerIssue, type BehaviorDiff, type BehaviorDiffEntry, type BehaviorManifest, BehaviorManifestJsonFormatter, type BehaviorManifestJsonOptions, type BehaviorSourceFile, type BehaviorTag, type BundleOptions, type BundleResult, 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, 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 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, type NotificationSummary, type NotifyCondition, 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, type RecordDeploymentArgs, type RecordDeploymentResult, type ReleaseManifest, ReleaseManifestFormatter, ReportGenerator, type ResolvedFormatterOptions, type ReviewAudience, type ReviewBand, type ReviewClaim, type ReviewContext, ReviewHtmlFormatter, type ReviewHtmlOptions, ReviewMarkdownFormatter, type ReviewMarkdownOptions, type ReviewResult, type ReviewSummary, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, 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, StoryReportJsonFormatter, type StoryReportJsonOptions, type TestHistory, type TestMetrics, type TraceabilityMatrix, TraceabilityMatrixFormatter, type TraceabilityRequirement, type TriageArgs, type TriageDeps, type TriageItem, type TriageReport, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, buildCheck, buildGoal, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, classifyStatusChange, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, generateRunComparison, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, normalizeFormats, normalizeJestResults, normalizePlaywrightResults, normalizeVitestResults, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, regenerateRun, renderCheck, renderGoal, renderTriage, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toTraceabilityMatrix, tryGetActiveOtelContext, updateHistory };
+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 };