executable-stories-formatters 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CIInfo, T as TestRunResult, a as TestCaseResult, S as StoryStep, D as DocEntry, b as TestStatus$1, N as NormalizedTicket, A as Attachment, c as DocPhase, O as OtelSpan, d as StepResult, e as CIProvider, R as RawStatus, f as RawAttachment, g as RawRun, h as RawCIInfo, i as adaptJestRun, j as adaptPlaywrightRun, k as adaptVitestRun } from './index-mrT6-JSt.cjs';
-export { l as CIInfo, m as CoverageSummary, J as JestAdapterOptions, n as JestAggregatedResult, o as JestFileResult, p as JestTestResult, q as OtelAttributeValue, P as PlaywrightAdapterOptions, r as PlaywrightAnnotation, s as PlaywrightAttachment, t as PlaywrightError, u as PlaywrightLocation, v as PlaywrightStatus, w as PlaywrightTestCase, x as PlaywrightTestResult, y as RawStepEvent, z as RawTestCase, B as STORY_META_KEY, E as StepKeyword, 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-mrT6-JSt.cjs';
+import { C as CIInfo, T as TestRunResult, a as TestCaseResult, S as StoryStep, D as DocEntry, b as TestStatus$1, N as NormalizedTicket, A as Attachment, c as DocPhase, O as OtelSpan, d as StepResult, e as CIProvider, R as RawStatus, f as RawAttachment, g as RawRun, h as RawCIInfo, i as StepKeyword$1, j as adaptJestRun, k as adaptPlaywrightRun, l as adaptVitestRun } from './index-CXrzCk9p.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-CXrzCk9p.cjs';
 
 /**
  * Notification types for webhook integrations (Slack, Teams).
@@ -150,7 +150,7 @@ interface CanonicalizeOptions {
     };
 }
 /** Output format for report generation */
-type OutputFormat = "astro" | "behavior-manifest-json" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "release-manifest" | "scenario-index-json" | "story-report-json";
+type OutputFormat = "astro" | "behavior-manifest-json" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "release-manifest" | "scenario-index-json" | "story-report-json" | "traceability-matrix";
 /** Sort order for test cases in reports (deterministic for diff-friendly output) */
 type SortTestCasesMode = "id" | "source" | "none";
 /** Output mode for report routing */
@@ -360,6 +360,10 @@ interface MarkdownFormatterOptions {
     includeSourceLinks?: boolean;
     /** Custom renderers for doc entries */
     customRenderers?: MarkdownRenderers;
+    /** Emit a stable per-scenario anchor for deep-linking. Returns the id, or undefined to skip. */
+    scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
+    /** Render a badge line under a scenario heading (e.g. a what's-changed marker). Undefined to skip. */
+    scenarioBadge?: (tc: TestCaseResult) => string | undefined;
 }
 
 /** Astro/Starlight formatter options */
@@ -487,6 +491,8 @@ interface ResolvedFormatterOptions {
             ticketUrlTemplate?: string;
             traceUrlTemplate?: string;
             customRenderers?: MarkdownRenderers;
+            scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
+            scenarioBadge?: (tc: TestCaseResult) => string | undefined;
         };
     };
     assetMode: "none" | "copy";
@@ -1924,6 +1930,19 @@ interface MarkdownOptions {
     includeSourceLinks?: boolean;
     /** Custom renderers for doc entries */
     customRenderers?: MarkdownRenderers;
+    /**
+     * Emit a stable in-page anchor before each scenario heading, so external tools
+     * can deep-link to a scenario by fragment. Given a test case, return the anchor
+     * id (without `#`), or undefined to skip. Off by default — only the living-docs
+     * site opts in, so plain markdown output is unchanged.
+     */
+    scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
+    /**
+     * Render a short badge line directly under a scenario heading (e.g. a
+     * what's-changed marker like "🆕 New" / "⚠️ Regressed"). Return the markdown
+     * line, or undefined to skip. Off by default — only the living-docs site opts in.
+     */
+    scenarioBadge?: (tc: TestCaseResult) => string | undefined;
 }
 /**
  * Markdown Formatter.
@@ -2959,6 +2978,176 @@ interface ListScenariosArgs {
 type ListScenariosDeps = Record<string, never>;
 declare function listScenarios(args: ListScenariosArgs, _deps: ListScenariosDeps): string;
 
+/**
+ * `check` — context-efficient backpressure for coding agents.
+ *
+ * The principle (from "Stop Babysitting Your Coding Agent. Give It Backpressure."):
+ * compress success, expand failure. Passing scenarios collapse to a single count
+ * line. Each failing scenario expands to its Given/When/Then narrative, the step
+ * that broke, the error, and the product code it `covers` — so the agent gets an
+ * actionable, intent-carrying signal instead of a wall of green.
+ *
+ * When a baseline run is supplied, the report also folds in what *regressed* and
+ * what got *fixed* since the last run — the "retained" property of effective
+ * feedback. Reuses the same status-transition vocabulary as {@link classifyStatusChange}.
+ */
+
+interface CheckArgs {
+    testCases: TestCaseResult[];
+    /** Baseline scenario statuses keyed by scenario id, for regressed/fixed deltas. */
+    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$1;
+    text: string;
+    /** True when this step is the one that failed. */
+    failed: boolean;
+}
+/** Expanded detail for one failing scenario — the actionable payload. */
+interface CheckFailure {
+    id: string;
+    scenario: string;
+    /** `sourceFile:sourceLine` */
+    location: string;
+    steps: CheckStep[];
+    /** Failing step's error if isolated, else the scenario-level error. */
+    errorMessage?: string;
+    /** Product-code paths/globs this scenario exercises (what to fix). */
+    covers: string[];
+    tickets: string[];
+    /** True when this scenario was passing in the baseline run. */
+    regressed: boolean;
+}
+interface CheckReport {
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        pending: number;
+    };
+    failures: CheckFailure[];
+    /** Count of scenarios that went passed → failed vs. the baseline. */
+    regressed: number;
+    /** Count of scenarios that went failed → passed vs. the baseline. */
+    fixed: number;
+    /** Whether a baseline was supplied (so callers know if deltas are meaningful). */
+    comparedToBaseline: boolean;
+}
+/**
+ * Build a structured check report from canonical test cases.
+ * Pure: no IO. Callers render it as text or JSON and decide the exit code.
+ */
+declare function buildCheck(args: CheckArgs, _deps?: CheckDeps): CheckReport;
+/**
+ * Render the check report. Text is the default agent/human surface
+ * (compressed success, expanded failure); JSON is the machine contract.
+ */
+declare function renderCheck(report: CheckReport, format: "text" | "json"): string;
+
+/**
+ * `goal` — a behavioral definition-of-done for autonomous agent loops.
+ *
+ * A `/goal`-style loop keeps working until a verifiable condition holds. This
+ * expresses that condition in behavior, not "tests green and lint clean": the
+ * required scenarios pass, nothing regressed, and nobody weakened a scenario to
+ * fake done (the ratchet). It returns a clear met / not-met verdict and what is
+ * left, so the loop and the human reading after it can both trust "done".
+ */
+
+/** Result of one required selector (a tag, ticket, or scenario that must pass). */
+interface GoalRequirementResult {
+    /** Human-readable selector, e.g. "tag:US-101", "ticket:CART-9", "all scenarios". */
+    selector: string;
+    matched: number;
+    passed: number;
+    /** Titles of matched scenarios that did not pass. */
+    failing: string[];
+    /** matched > 0 and every matched scenario passed. */
+    met: boolean;
+}
+/** A scenario that was removed or weakened versus the baseline (anti-fake-done). */
+interface RatchetViolation {
+    id: string;
+    title: string;
+    kind: "removed" | "disabled" | "weakened";
+    detail: string;
+}
+interface GoalReport {
+    /** True only when every requirement is met and no enforced guard fired. */
+    met: boolean;
+    requirements: GoalRequirementResult[];
+    /** Scenarios that went passed -> failed versus baseline (when --no-regressions). */
+    regressions: Array<{
+        id: string;
+        title: string;
+    }>;
+    regressionsEnforced: boolean;
+    ratchet: {
+        enforced: boolean;
+        violations: RatchetViolation[];
+    };
+}
+interface GoalArgs {
+    run: TestRunResult;
+    baseline?: TestRunResult;
+    requireTags: string[];
+    requireTickets: string[];
+    requireScenarios: string[];
+    enforceNoRegressions: boolean;
+    enforceRatchet: boolean;
+    format: "text" | "json";
+}
+type GoalDeps = Record<string, never>;
+declare function buildGoal(args: GoalArgs, _deps?: GoalDeps): GoalReport;
+declare function renderGoal(report: GoalReport, format: "text" | "json"): string;
+
+/**
+ * `triage` — the discovery-phase worklist for an agent loop.
+ *
+ * The automation that runs on a schedule needs a ranked queue of what to work
+ * on, not a full report. This emits failing scenarios, regressions first, each
+ * carrying the product code it `covers` (where to send the fixer), the error,
+ * and its tickets. Failures with no `covers` are flagged: the loop can't route
+ * them to code, so a human or a covers annotation is needed first.
+ */
+
+interface TriageItem {
+    rank: number;
+    id: string;
+    scenario: string;
+    status: TestStatus$1;
+    /** `sourceFile:sourceLine` */
+    location: string;
+    /** Product-code paths to fix. Empty when the scenario declared no `covers`. */
+    covers: string[];
+    tickets: string[];
+    errorMessage?: string;
+    /** Passed in the baseline, failing now. Ranked first. */
+    regressed: boolean;
+    reason: "regression" | "failing";
+}
+interface TriageReport {
+    total: number;
+    failing: number;
+    regressions: number;
+    /** Failing scenarios with no `covers` — the loop can't route them to code. */
+    needsCovers: number;
+    items: TriageItem[];
+}
+interface TriageArgs {
+    testCases: TestCaseResult[];
+    /** Baseline statuses by scenario id, to flag regressions and rank them first. */
+    baseline?: Map<string, TestStatus$1>;
+    format: "text" | "json";
+}
+type TriageDeps = Record<string, never>;
+declare function buildTriage(args: TriageArgs, _deps?: TriageDeps): TriageReport;
+declare function renderTriage(report: TriageReport, format: "text" | "json"): string;
+
 declare function createPrCommentSummary(diff: RunDiffResult, maxScenarios?: number): string;
 
 declare function diffRuns(baseline: TestRunResult, current: TestRunResult): RunDiffResult;
@@ -3165,6 +3354,65 @@ declare class ReleaseManifestFormatter {
 }
 declare function toReleaseManifest(run: TestRunResult): ReleaseManifest;
 
+/**
+ * Requirement-first view of a run. Groups scenarios under the ticket/user-story
+ * they verify, rolls up the code each requirement covers and whether it passed,
+ * and surfaces two gaps a scenario-keyed index hides: requirements with a failing
+ * scenario, and scenarios linked to no requirement at all (untraced behavior).
+ *
+ * The set of requirements is derived from the tickets found on scenarios — the
+ * tests are the source of truth, so a requirement only appears once a scenario
+ * claims it.
+ */
+interface TraceabilityRequirement {
+    /** Ticket / user-story id (e.g. "US-101", "JIRA-42"). */
+    ticket: string;
+    /** Direct URL when a scenario supplied one. */
+    url?: string;
+    /** "verified" = every scenario passed; "failing" = at least one failed; "incomplete" = only skipped/pending. */
+    status: "verified" | "failing" | "incomplete";
+    scenarios: Array<{
+        id: string;
+        title: string;
+        status: TestStatus$1;
+        sourceFile: string;
+        sourceLine: number;
+        covers: string[];
+    }>;
+    /** Union of every covered path across this requirement's scenarios. */
+    covers: string[];
+}
+interface TraceabilityMatrix {
+    schemaVersion: "1.0";
+    generatedAt: string;
+    run: {
+        startedAt: string;
+        finishedAt: string;
+        gitSha?: string;
+        branch?: string;
+    };
+    summary: {
+        requirements: number;
+        requirementsVerified: number;
+        requirementsFailing: number;
+        scenarios: number;
+        untracedScenarios: number;
+    };
+    requirements: TraceabilityRequirement[];
+    /** Scenarios with no ticket — behavior verified but not linked to a requirement. */
+    untraced: Array<{
+        id: string;
+        title: string;
+        status: TestStatus$1;
+        sourceFile: string;
+        sourceLine: number;
+    }>;
+}
+declare class TraceabilityMatrixFormatter {
+    format(run: TestRunResult): string;
+}
+declare function toTraceabilityMatrix(run: TestRunResult): TraceabilityMatrix;
+
 /**
  * @executable-stories/formatters
  *
@@ -3274,4 +3522,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 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 HistoryEntry, type HistoryStore, type HtmlDocOptions, HtmlFormatter, type HtmlOptions, type HtmlTheme, type HtmlThemeName, 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, 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, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, 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, StepResult, type StoryReport, StoryReportJsonFormatter, type StoryReportJsonOptions, type StoryReportSchemaVersion, StoryStep, TestCaseResult, type TestHistory, type TestMetrics, TestRunResult, TestStatus$1 as TestStatus, CIInfo as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, buildHtmlDocEntry, buildReview, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, classifyStatusChange, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toStoryReport, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };
+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, HtmlFormatter, type HtmlOptions, type HtmlTheme, type HtmlThemeName, 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, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, 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 as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, 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, getAvailableThemes, getCssOnlyThemes, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, renderCheck, renderGoal, renderTriage, resolveAttachment, resolveAttachments, resolveTheme, 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

@@ -1,5 +1,5 @@
-import { C as CIInfo, T as TestRunResult, a as TestCaseResult, S as StoryStep, D as DocEntry, b as TestStatus$1, N as NormalizedTicket, A as Attachment, c as DocPhase, O as OtelSpan, d as StepResult, e as CIProvider, R as RawStatus, f as RawAttachment, g as RawRun, h as RawCIInfo, i as adaptJestRun, j as adaptPlaywrightRun, k as adaptVitestRun } from './index-mrT6-JSt.js';
-export { l as CIInfo, m as CoverageSummary, J as JestAdapterOptions, n as JestAggregatedResult, o as JestFileResult, p as JestTestResult, q as OtelAttributeValue, P as PlaywrightAdapterOptions, r as PlaywrightAnnotation, s as PlaywrightAttachment, t as PlaywrightError, u as PlaywrightLocation, v as PlaywrightStatus, w as PlaywrightTestCase, x as PlaywrightTestResult, y as RawStepEvent, z as RawTestCase, B as STORY_META_KEY, E as StepKeyword, 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-mrT6-JSt.js';
+import { C as CIInfo, T as TestRunResult, a as TestCaseResult, S as StoryStep, D as DocEntry, b as TestStatus$1, N as NormalizedTicket, A as Attachment, c as DocPhase, O as OtelSpan, d as StepResult, e as CIProvider, R as RawStatus, f as RawAttachment, g as RawRun, h as RawCIInfo, i as StepKeyword$1, j as adaptJestRun, k as adaptPlaywrightRun, l as adaptVitestRun } from './index-CXrzCk9p.js';
+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-CXrzCk9p.js';
 
 /**
  * Notification types for webhook integrations (Slack, Teams).
@@ -150,7 +150,7 @@ interface CanonicalizeOptions {
     };
 }
 /** Output format for report generation */
-type OutputFormat = "astro" | "behavior-manifest-json" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "release-manifest" | "scenario-index-json" | "story-report-json";
+type OutputFormat = "astro" | "behavior-manifest-json" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "release-manifest" | "scenario-index-json" | "story-report-json" | "traceability-matrix";
 /** Sort order for test cases in reports (deterministic for diff-friendly output) */
 type SortTestCasesMode = "id" | "source" | "none";
 /** Output mode for report routing */
@@ -360,6 +360,10 @@ interface MarkdownFormatterOptions {
     includeSourceLinks?: boolean;
     /** Custom renderers for doc entries */
     customRenderers?: MarkdownRenderers;
+    /** Emit a stable per-scenario anchor for deep-linking. Returns the id, or undefined to skip. */
+    scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
+    /** Render a badge line under a scenario heading (e.g. a what's-changed marker). Undefined to skip. */
+    scenarioBadge?: (tc: TestCaseResult) => string | undefined;
 }
 
 /** Astro/Starlight formatter options */
@@ -487,6 +491,8 @@ interface ResolvedFormatterOptions {
             ticketUrlTemplate?: string;
             traceUrlTemplate?: string;
             customRenderers?: MarkdownRenderers;
+            scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
+            scenarioBadge?: (tc: TestCaseResult) => string | undefined;
         };
     };
     assetMode: "none" | "copy";
@@ -1924,6 +1930,19 @@ interface MarkdownOptions {
     includeSourceLinks?: boolean;
     /** Custom renderers for doc entries */
     customRenderers?: MarkdownRenderers;
+    /**
+     * Emit a stable in-page anchor before each scenario heading, so external tools
+     * can deep-link to a scenario by fragment. Given a test case, return the anchor
+     * id (without `#`), or undefined to skip. Off by default — only the living-docs
+     * site opts in, so plain markdown output is unchanged.
+     */
+    scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
+    /**
+     * Render a short badge line directly under a scenario heading (e.g. a
+     * what's-changed marker like "🆕 New" / "⚠️ Regressed"). Return the markdown
+     * line, or undefined to skip. Off by default — only the living-docs site opts in.
+     */
+    scenarioBadge?: (tc: TestCaseResult) => string | undefined;
 }
 /**
  * Markdown Formatter.
@@ -2959,6 +2978,176 @@ interface ListScenariosArgs {
 type ListScenariosDeps = Record<string, never>;
 declare function listScenarios(args: ListScenariosArgs, _deps: ListScenariosDeps): string;
 
+/**
+ * `check` — context-efficient backpressure for coding agents.
+ *
+ * The principle (from "Stop Babysitting Your Coding Agent. Give It Backpressure."):
+ * compress success, expand failure. Passing scenarios collapse to a single count
+ * line. Each failing scenario expands to its Given/When/Then narrative, the step
+ * that broke, the error, and the product code it `covers` — so the agent gets an
+ * actionable, intent-carrying signal instead of a wall of green.
+ *
+ * When a baseline run is supplied, the report also folds in what *regressed* and
+ * what got *fixed* since the last run — the "retained" property of effective
+ * feedback. Reuses the same status-transition vocabulary as {@link classifyStatusChange}.
+ */
+
+interface CheckArgs {
+    testCases: TestCaseResult[];
+    /** Baseline scenario statuses keyed by scenario id, for regressed/fixed deltas. */
+    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$1;
+    text: string;
+    /** True when this step is the one that failed. */
+    failed: boolean;
+}
+/** Expanded detail for one failing scenario — the actionable payload. */
+interface CheckFailure {
+    id: string;
+    scenario: string;
+    /** `sourceFile:sourceLine` */
+    location: string;
+    steps: CheckStep[];
+    /** Failing step's error if isolated, else the scenario-level error. */
+    errorMessage?: string;
+    /** Product-code paths/globs this scenario exercises (what to fix). */
+    covers: string[];
+    tickets: string[];
+    /** True when this scenario was passing in the baseline run. */
+    regressed: boolean;
+}
+interface CheckReport {
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        pending: number;
+    };
+    failures: CheckFailure[];
+    /** Count of scenarios that went passed → failed vs. the baseline. */
+    regressed: number;
+    /** Count of scenarios that went failed → passed vs. the baseline. */
+    fixed: number;
+    /** Whether a baseline was supplied (so callers know if deltas are meaningful). */
+    comparedToBaseline: boolean;
+}
+/**
+ * Build a structured check report from canonical test cases.
+ * Pure: no IO. Callers render it as text or JSON and decide the exit code.
+ */
+declare function buildCheck(args: CheckArgs, _deps?: CheckDeps): CheckReport;
+/**
+ * Render the check report. Text is the default agent/human surface
+ * (compressed success, expanded failure); JSON is the machine contract.
+ */
+declare function renderCheck(report: CheckReport, format: "text" | "json"): string;
+
+/**
+ * `goal` — a behavioral definition-of-done for autonomous agent loops.
+ *
+ * A `/goal`-style loop keeps working until a verifiable condition holds. This
+ * expresses that condition in behavior, not "tests green and lint clean": the
+ * required scenarios pass, nothing regressed, and nobody weakened a scenario to
+ * fake done (the ratchet). It returns a clear met / not-met verdict and what is
+ * left, so the loop and the human reading after it can both trust "done".
+ */
+
+/** Result of one required selector (a tag, ticket, or scenario that must pass). */
+interface GoalRequirementResult {
+    /** Human-readable selector, e.g. "tag:US-101", "ticket:CART-9", "all scenarios". */
+    selector: string;
+    matched: number;
+    passed: number;
+    /** Titles of matched scenarios that did not pass. */
+    failing: string[];
+    /** matched > 0 and every matched scenario passed. */
+    met: boolean;
+}
+/** A scenario that was removed or weakened versus the baseline (anti-fake-done). */
+interface RatchetViolation {
+    id: string;
+    title: string;
+    kind: "removed" | "disabled" | "weakened";
+    detail: string;
+}
+interface GoalReport {
+    /** True only when every requirement is met and no enforced guard fired. */
+    met: boolean;
+    requirements: GoalRequirementResult[];
+    /** Scenarios that went passed -> failed versus baseline (when --no-regressions). */
+    regressions: Array<{
+        id: string;
+        title: string;
+    }>;
+    regressionsEnforced: boolean;
+    ratchet: {
+        enforced: boolean;
+        violations: RatchetViolation[];
+    };
+}
+interface GoalArgs {
+    run: TestRunResult;
+    baseline?: TestRunResult;
+    requireTags: string[];
+    requireTickets: string[];
+    requireScenarios: string[];
+    enforceNoRegressions: boolean;
+    enforceRatchet: boolean;
+    format: "text" | "json";
+}
+type GoalDeps = Record<string, never>;
+declare function buildGoal(args: GoalArgs, _deps?: GoalDeps): GoalReport;
+declare function renderGoal(report: GoalReport, format: "text" | "json"): string;
+
+/**
+ * `triage` — the discovery-phase worklist for an agent loop.
+ *
+ * The automation that runs on a schedule needs a ranked queue of what to work
+ * on, not a full report. This emits failing scenarios, regressions first, each
+ * carrying the product code it `covers` (where to send the fixer), the error,
+ * and its tickets. Failures with no `covers` are flagged: the loop can't route
+ * them to code, so a human or a covers annotation is needed first.
+ */
+
+interface TriageItem {
+    rank: number;
+    id: string;
+    scenario: string;
+    status: TestStatus$1;
+    /** `sourceFile:sourceLine` */
+    location: string;
+    /** Product-code paths to fix. Empty when the scenario declared no `covers`. */
+    covers: string[];
+    tickets: string[];
+    errorMessage?: string;
+    /** Passed in the baseline, failing now. Ranked first. */
+    regressed: boolean;
+    reason: "regression" | "failing";
+}
+interface TriageReport {
+    total: number;
+    failing: number;
+    regressions: number;
+    /** Failing scenarios with no `covers` — the loop can't route them to code. */
+    needsCovers: number;
+    items: TriageItem[];
+}
+interface TriageArgs {
+    testCases: TestCaseResult[];
+    /** Baseline statuses by scenario id, to flag regressions and rank them first. */
+    baseline?: Map<string, TestStatus$1>;
+    format: "text" | "json";
+}
+type TriageDeps = Record<string, never>;
+declare function buildTriage(args: TriageArgs, _deps?: TriageDeps): TriageReport;
+declare function renderTriage(report: TriageReport, format: "text" | "json"): string;
+
 declare function createPrCommentSummary(diff: RunDiffResult, maxScenarios?: number): string;
 
 declare function diffRuns(baseline: TestRunResult, current: TestRunResult): RunDiffResult;
@@ -3165,6 +3354,65 @@ declare class ReleaseManifestFormatter {
 }
 declare function toReleaseManifest(run: TestRunResult): ReleaseManifest;
 
+/**
+ * Requirement-first view of a run. Groups scenarios under the ticket/user-story
+ * they verify, rolls up the code each requirement covers and whether it passed,
+ * and surfaces two gaps a scenario-keyed index hides: requirements with a failing
+ * scenario, and scenarios linked to no requirement at all (untraced behavior).
+ *
+ * The set of requirements is derived from the tickets found on scenarios — the
+ * tests are the source of truth, so a requirement only appears once a scenario
+ * claims it.
+ */
+interface TraceabilityRequirement {
+    /** Ticket / user-story id (e.g. "US-101", "JIRA-42"). */
+    ticket: string;
+    /** Direct URL when a scenario supplied one. */
+    url?: string;
+    /** "verified" = every scenario passed; "failing" = at least one failed; "incomplete" = only skipped/pending. */
+    status: "verified" | "failing" | "incomplete";
+    scenarios: Array<{
+        id: string;
+        title: string;
+        status: TestStatus$1;
+        sourceFile: string;
+        sourceLine: number;
+        covers: string[];
+    }>;
+    /** Union of every covered path across this requirement's scenarios. */
+    covers: string[];
+}
+interface TraceabilityMatrix {
+    schemaVersion: "1.0";
+    generatedAt: string;
+    run: {
+        startedAt: string;
+        finishedAt: string;
+        gitSha?: string;
+        branch?: string;
+    };
+    summary: {
+        requirements: number;
+        requirementsVerified: number;
+        requirementsFailing: number;
+        scenarios: number;
+        untracedScenarios: number;
+    };
+    requirements: TraceabilityRequirement[];
+    /** Scenarios with no ticket — behavior verified but not linked to a requirement. */
+    untraced: Array<{
+        id: string;
+        title: string;
+        status: TestStatus$1;
+        sourceFile: string;
+        sourceLine: number;
+    }>;
+}
+declare class TraceabilityMatrixFormatter {
+    format(run: TestRunResult): string;
+}
+declare function toTraceabilityMatrix(run: TestRunResult): TraceabilityMatrix;
+
 /**
  * @executable-stories/formatters
  *
@@ -3274,4 +3522,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 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 HistoryEntry, type HistoryStore, type HtmlDocOptions, HtmlFormatter, type HtmlOptions, type HtmlTheme, type HtmlThemeName, 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, 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, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, 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, StepResult, type StoryReport, StoryReportJsonFormatter, type StoryReportJsonOptions, type StoryReportSchemaVersion, StoryStep, TestCaseResult, type TestHistory, type TestMetrics, TestRunResult, TestStatus$1 as TestStatus, CIInfo as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, buildHtmlDocEntry, buildReview, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, classifyStatusChange, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toStoryReport, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };
+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, HtmlFormatter, type HtmlOptions, type HtmlTheme, type HtmlThemeName, 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, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, 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 as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, 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, getAvailableThemes, getCssOnlyThemes, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, renderCheck, renderGoal, renderTriage, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toStoryReport, toTraceabilityMatrix, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };