executable-stories-formatters 0.9.0 → 0.10.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-it3Pkmqv.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-it3Pkmqv.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 adaptJestRun, j as adaptPlaywrightRun, k as adaptVitestRun } from './index-CbWFyoTx.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-CbWFyoTx.cjs';
 
 /**
  * Notification types for webhook integrations (Slack, Teams).
@@ -150,7 +150,7 @@ interface CanonicalizeOptions {
     };
 }
 /** Output format for report generation */
-type OutputFormat = "astro" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "story-report-json";
+type OutputFormat = "astro" | "behavior-manifest-json" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "scenario-index-json" | "story-report-json";
 /** Sort order for test cases in reports (deterministic for diff-friendly output) */
 type SortTestCasesMode = "id" | "source" | "none";
 /** Output mode for report routing */
@@ -221,6 +221,16 @@ interface FormatterOptions {
         /** Pretty-print JSON output. Default: true */
         pretty?: boolean;
     };
+    /** Scenario index JSON specific options */
+    scenarioIndexJson?: {
+        /** Pretty-print JSON output. Default: true */
+        pretty?: boolean;
+    };
+    /** Behavior manifest JSON specific options */
+    behaviorManifestJson?: {
+        /** Pretty-print JSON output. Default: true */
+        pretty?: boolean;
+    };
     /** HTML specific options */
     html?: {
         /** Report title. Default: "Test Results" */
@@ -387,6 +397,12 @@ interface ResolvedFormatterOptions {
     storyReportJson: {
         pretty: boolean;
     };
+    scenarioIndexJson: {
+        pretty: boolean;
+    };
+    behaviorManifestJson: {
+        pretty: boolean;
+    };
     cucumberMessages: {
         uriStrategy: "sourceFile" | "virtual";
         includeSynthetics: boolean;
@@ -779,6 +795,8 @@ interface ReportScenario {
     durationMs: number;
     tags: string[];
     tickets?: ReportTicket[];
+    /** Product-code paths/globs this scenario exercises (project-root-relative). */
+    covers?: string[];
     sourceLine?: number;
     errorMessage?: string;
     errorStack?: string;
@@ -1523,6 +1541,185 @@ declare class StoryReportJsonFormatter {
     format(run: TestRunResult): string;
 }
 
+interface ScenarioIndex {
+    schemaVersion: "1.0";
+    runId: string;
+    generatedAtMs: number;
+    summary: StoryReport["summary"];
+    scenarios: ScenarioIndexItem[];
+}
+interface ScenarioIndexItem {
+    id: string;
+    title: string;
+    status: TestStatus;
+    feature: string;
+    sourceFile: string;
+    sourceLine?: number;
+    tags: string[];
+    tickets: Array<{
+        id: string;
+        url?: string;
+    }>;
+    covers: string[];
+    durationMs: number;
+    steps: ScenarioIndexStep[];
+    docKinds: string[];
+    error?: {
+        message: string;
+        stack?: string;
+    };
+}
+interface ScenarioIndexStep {
+    id: string;
+    index: number;
+    keyword: ReportStep["keyword"];
+    text: string;
+    status: TestStatus;
+    durationMs: number;
+    errorMessage?: string;
+    docKinds: string[];
+}
+interface ScenarioIndexFilters {
+    statuses?: TestStatus[];
+    tags?: string[];
+    sourceFiles?: string[];
+}
+interface ScenarioIndexJsonOptions {
+    pretty?: boolean;
+    filters?: ScenarioIndexFilters;
+}
+declare class ScenarioIndexJsonFormatter {
+    private options;
+    constructor(options?: ScenarioIndexJsonOptions);
+    toIndex(run: TestRunResult): ScenarioIndex;
+    format(run: TestRunResult): string;
+}
+declare function toScenarioIndex(report: StoryReport, filters?: ScenarioIndexFilters): ScenarioIndex;
+
+interface BehaviorManifest {
+    schemaVersion: "1.0";
+    runId: string;
+    generatedAtMs: number;
+    summary: ScenarioIndex["summary"];
+    sourceFiles: BehaviorSourceFile[];
+    tags: BehaviorTag[];
+    docCoverage: {
+        scenariosWithDocs: number;
+        scenariosWithoutDocs: number;
+        docKinds: string[];
+    };
+    debugger: BehaviorDebuggerIssue[];
+}
+interface BehaviorSourceFile {
+    path: string;
+    scenarioCount: number;
+    failed: number;
+    tags: string[];
+}
+interface BehaviorTag {
+    name: string;
+    scenarioCount: number;
+}
+interface BehaviorDebuggerIssue {
+    severity: "warning";
+    code: "missing-docs" | "missing-tags" | "missing-covers" | "missing-source-line";
+    scenarioId: string;
+    title: string;
+    message: string;
+}
+interface BehaviorManifestJsonOptions {
+    pretty?: boolean;
+}
+declare class BehaviorManifestJsonFormatter {
+    private pretty;
+    constructor(options?: BehaviorManifestJsonOptions);
+    toManifest(run: TestRunResult): BehaviorManifest;
+    format(run: TestRunResult): string;
+}
+declare function toBehaviorManifest(report: StoryReport): BehaviorManifest;
+
+/**
+ * Return scenarios whose declared `covers` globs match any of the given paths.
+ * Accepts many paths so callers can pass a whole changed-file list (e.g. a git diff).
+ * Results are deduped (filter preserves index order, so each scenario appears once).
+ */
+declare function scenariosCoveringPaths(index: ScenarioIndex, paths: string[]): ScenarioIndexItem[];
+
+interface WatchOptions {
+    /** Path to the raw-run (or canonical) JSON the framework adapter writes. */
+    input: string;
+    outputDir: string;
+    outputName: string;
+    formats: OutputFormat[];
+    /** Input is "raw" (default) or already-canonical "canonical". */
+    inputType?: "raw" | "canonical";
+    /** Synthesize story metadata for plain tests (raw input only). Default true. */
+    synthesize?: boolean;
+    /** Coalesce rapid change events. Default 150ms. */
+    debounceMs?: number;
+}
+interface RegenerateDeps {
+    readFile?: (filePath: string) => string;
+}
+/**
+ * Read a raw-run (or canonical) file and regenerate the requested agent
+ * artifacts via the canonical {@link ReportGenerator}. Returns the written
+ * file paths. This is the unit of work the watcher repeats; it is also useful
+ * standalone for a one-shot regenerate.
+ */
+declare function regenerateArtifacts(options: WatchOptions, deps?: RegenerateDeps): Promise<string[]>;
+interface WatchDeps extends RegenerateDeps {
+    /** Watch a path, calling the listener on every change. Injectable for tests. */
+    watch?: (filePath: string, listener: () => void) => {
+        close: () => void;
+    };
+    /** Override the regenerate step (tests). */
+    regenerate?: (input: string) => Promise<string[]>;
+    log?: (message: string) => void;
+}
+interface WatchHandle {
+    close: () => void;
+}
+/**
+ * Keep the agent artifacts fresh: regenerate them whenever the framework
+ * rewrites its raw-run file. Language-agnostic — any adapter that emits a
+ * raw-run drives it. Pair with the host framework's own `--watch` to get a
+ * behavior index that tracks the code.
+ */
+declare function startWatch(options: WatchOptions, deps?: WatchDeps): WatchHandle;
+
+interface BehaviorDiffEntry {
+    id: string;
+    title: string;
+    sourceFile: string;
+    kind: ScenarioChangeKind;
+    baselineStatus?: TestStatus;
+    currentStatus?: TestStatus;
+}
+interface BehaviorDiff {
+    schemaVersion: "1.0";
+    summary: {
+        added: number;
+        removed: number;
+        regressed: number;
+        fixed: number;
+        changed: number;
+        unchanged: number;
+    };
+    scenarios: BehaviorDiffEntry[];
+}
+/**
+ * Classify a single scenario's status transition between two runs.
+ * Shares the `ScenarioChangeKind` vocabulary with the full compare engine.
+ */
+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
+ * the human-facing compare engine produces.
+ */
+declare function diffStoryReports(baseline: StoryReport, current: StoryReport): BehaviorDiff;
+
 /**
  * toStoryReport — convert a canonical TestRunResult into the public
  * StoryReport shape consumed by UI renderers.
@@ -2910,4 +3107,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 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, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, 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, 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 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 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 WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, buildReview, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, stripAnsi, 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 ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, 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, 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 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, 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, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, regenerateArtifacts, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toScenarioIndex, toStoryReport, 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-it3Pkmqv.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-it3Pkmqv.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 adaptJestRun, j as adaptPlaywrightRun, k as adaptVitestRun } from './index-CbWFyoTx.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-CbWFyoTx.js';
 
 /**
  * Notification types for webhook integrations (Slack, Teams).
@@ -150,7 +150,7 @@ interface CanonicalizeOptions {
     };
 }
 /** Output format for report generation */
-type OutputFormat = "astro" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "story-report-json";
+type OutputFormat = "astro" | "behavior-manifest-json" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "scenario-index-json" | "story-report-json";
 /** Sort order for test cases in reports (deterministic for diff-friendly output) */
 type SortTestCasesMode = "id" | "source" | "none";
 /** Output mode for report routing */
@@ -221,6 +221,16 @@ interface FormatterOptions {
         /** Pretty-print JSON output. Default: true */
         pretty?: boolean;
     };
+    /** Scenario index JSON specific options */
+    scenarioIndexJson?: {
+        /** Pretty-print JSON output. Default: true */
+        pretty?: boolean;
+    };
+    /** Behavior manifest JSON specific options */
+    behaviorManifestJson?: {
+        /** Pretty-print JSON output. Default: true */
+        pretty?: boolean;
+    };
     /** HTML specific options */
     html?: {
         /** Report title. Default: "Test Results" */
@@ -387,6 +397,12 @@ interface ResolvedFormatterOptions {
     storyReportJson: {
         pretty: boolean;
     };
+    scenarioIndexJson: {
+        pretty: boolean;
+    };
+    behaviorManifestJson: {
+        pretty: boolean;
+    };
     cucumberMessages: {
         uriStrategy: "sourceFile" | "virtual";
         includeSynthetics: boolean;
@@ -779,6 +795,8 @@ interface ReportScenario {
     durationMs: number;
     tags: string[];
     tickets?: ReportTicket[];
+    /** Product-code paths/globs this scenario exercises (project-root-relative). */
+    covers?: string[];
     sourceLine?: number;
     errorMessage?: string;
     errorStack?: string;
@@ -1523,6 +1541,185 @@ declare class StoryReportJsonFormatter {
     format(run: TestRunResult): string;
 }
 
+interface ScenarioIndex {
+    schemaVersion: "1.0";
+    runId: string;
+    generatedAtMs: number;
+    summary: StoryReport["summary"];
+    scenarios: ScenarioIndexItem[];
+}
+interface ScenarioIndexItem {
+    id: string;
+    title: string;
+    status: TestStatus;
+    feature: string;
+    sourceFile: string;
+    sourceLine?: number;
+    tags: string[];
+    tickets: Array<{
+        id: string;
+        url?: string;
+    }>;
+    covers: string[];
+    durationMs: number;
+    steps: ScenarioIndexStep[];
+    docKinds: string[];
+    error?: {
+        message: string;
+        stack?: string;
+    };
+}
+interface ScenarioIndexStep {
+    id: string;
+    index: number;
+    keyword: ReportStep["keyword"];
+    text: string;
+    status: TestStatus;
+    durationMs: number;
+    errorMessage?: string;
+    docKinds: string[];
+}
+interface ScenarioIndexFilters {
+    statuses?: TestStatus[];
+    tags?: string[];
+    sourceFiles?: string[];
+}
+interface ScenarioIndexJsonOptions {
+    pretty?: boolean;
+    filters?: ScenarioIndexFilters;
+}
+declare class ScenarioIndexJsonFormatter {
+    private options;
+    constructor(options?: ScenarioIndexJsonOptions);
+    toIndex(run: TestRunResult): ScenarioIndex;
+    format(run: TestRunResult): string;
+}
+declare function toScenarioIndex(report: StoryReport, filters?: ScenarioIndexFilters): ScenarioIndex;
+
+interface BehaviorManifest {
+    schemaVersion: "1.0";
+    runId: string;
+    generatedAtMs: number;
+    summary: ScenarioIndex["summary"];
+    sourceFiles: BehaviorSourceFile[];
+    tags: BehaviorTag[];
+    docCoverage: {
+        scenariosWithDocs: number;
+        scenariosWithoutDocs: number;
+        docKinds: string[];
+    };
+    debugger: BehaviorDebuggerIssue[];
+}
+interface BehaviorSourceFile {
+    path: string;
+    scenarioCount: number;
+    failed: number;
+    tags: string[];
+}
+interface BehaviorTag {
+    name: string;
+    scenarioCount: number;
+}
+interface BehaviorDebuggerIssue {
+    severity: "warning";
+    code: "missing-docs" | "missing-tags" | "missing-covers" | "missing-source-line";
+    scenarioId: string;
+    title: string;
+    message: string;
+}
+interface BehaviorManifestJsonOptions {
+    pretty?: boolean;
+}
+declare class BehaviorManifestJsonFormatter {
+    private pretty;
+    constructor(options?: BehaviorManifestJsonOptions);
+    toManifest(run: TestRunResult): BehaviorManifest;
+    format(run: TestRunResult): string;
+}
+declare function toBehaviorManifest(report: StoryReport): BehaviorManifest;
+
+/**
+ * Return scenarios whose declared `covers` globs match any of the given paths.
+ * Accepts many paths so callers can pass a whole changed-file list (e.g. a git diff).
+ * Results are deduped (filter preserves index order, so each scenario appears once).
+ */
+declare function scenariosCoveringPaths(index: ScenarioIndex, paths: string[]): ScenarioIndexItem[];
+
+interface WatchOptions {
+    /** Path to the raw-run (or canonical) JSON the framework adapter writes. */
+    input: string;
+    outputDir: string;
+    outputName: string;
+    formats: OutputFormat[];
+    /** Input is "raw" (default) or already-canonical "canonical". */
+    inputType?: "raw" | "canonical";
+    /** Synthesize story metadata for plain tests (raw input only). Default true. */
+    synthesize?: boolean;
+    /** Coalesce rapid change events. Default 150ms. */
+    debounceMs?: number;
+}
+interface RegenerateDeps {
+    readFile?: (filePath: string) => string;
+}
+/**
+ * Read a raw-run (or canonical) file and regenerate the requested agent
+ * artifacts via the canonical {@link ReportGenerator}. Returns the written
+ * file paths. This is the unit of work the watcher repeats; it is also useful
+ * standalone for a one-shot regenerate.
+ */
+declare function regenerateArtifacts(options: WatchOptions, deps?: RegenerateDeps): Promise<string[]>;
+interface WatchDeps extends RegenerateDeps {
+    /** Watch a path, calling the listener on every change. Injectable for tests. */
+    watch?: (filePath: string, listener: () => void) => {
+        close: () => void;
+    };
+    /** Override the regenerate step (tests). */
+    regenerate?: (input: string) => Promise<string[]>;
+    log?: (message: string) => void;
+}
+interface WatchHandle {
+    close: () => void;
+}
+/**
+ * Keep the agent artifacts fresh: regenerate them whenever the framework
+ * rewrites its raw-run file. Language-agnostic — any adapter that emits a
+ * raw-run drives it. Pair with the host framework's own `--watch` to get a
+ * behavior index that tracks the code.
+ */
+declare function startWatch(options: WatchOptions, deps?: WatchDeps): WatchHandle;
+
+interface BehaviorDiffEntry {
+    id: string;
+    title: string;
+    sourceFile: string;
+    kind: ScenarioChangeKind;
+    baselineStatus?: TestStatus;
+    currentStatus?: TestStatus;
+}
+interface BehaviorDiff {
+    schemaVersion: "1.0";
+    summary: {
+        added: number;
+        removed: number;
+        regressed: number;
+        fixed: number;
+        changed: number;
+        unchanged: number;
+    };
+    scenarios: BehaviorDiffEntry[];
+}
+/**
+ * Classify a single scenario's status transition between two runs.
+ * Shares the `ScenarioChangeKind` vocabulary with the full compare engine.
+ */
+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
+ * the human-facing compare engine produces.
+ */
+declare function diffStoryReports(baseline: StoryReport, current: StoryReport): BehaviorDiff;
+
 /**
  * toStoryReport — convert a canonical TestRunResult into the public
  * StoryReport shape consumed by UI renderers.
@@ -2910,4 +3107,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 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, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, 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, 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 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 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 WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, buildReview, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, stripAnsi, 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 ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, 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, 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 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, 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, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, regenerateArtifacts, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toScenarioIndex, toStoryReport, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };