executable-stories-formatters 1.9.2 → 1.11.0

package/dist/index.d.ts

@@ -718,6 +718,503 @@ interface IJsonFeature {
     uri: string;
 }
 
+/**
+ * The test-management port.
+ *
+ * One interface, one engine, adapters per provider. Everything the engine does
+ * — matching, planning, drift detection, lockfile bookkeeping, reporting — is
+ * written once against these types. An adapter's only job is to translate
+ * between them and a vendor API.
+ *
+ * Adding a provider is one file in `adapters/` plus one line in
+ * `adapters/index.ts`, with no edits to `engine.ts`. If a new adapter forces an
+ * engine change, this port is wrong and gets fixed then, on evidence.
+ *
+ * Every method except `listCases` is optional. A read-only provider implements
+ * `listCases` alone and still produces a full coverage report; the engine
+ * reports the missing capabilities in the plan instead of failing.
+ */
+/** A test case as it exists in the provider, normalized. */
+interface RemoteCase {
+    /** Provider-native id, e.g. TestRail "1234" or Xray "PROJ-42". */
+    id: string;
+    /** Canonical URL a human can open. */
+    url: string;
+    title: string;
+    /** Suite, folder, or component — whatever the provider groups by. */
+    section?: string;
+    /**
+     * The content the provider currently holds, when it can supply it.
+     *
+     * Drift detection hashes this, not what we sent: providers normalize markup
+     * on write, so hashing the request would flag every case as human-edited on
+     * the very next run.
+     */
+    body?: CaseBody;
+}
+/** A story projected into provider-neutral case content. */
+interface CaseBody {
+    title: string;
+    steps: ReadonlyArray<{
+        keyword: string;
+        text: string;
+    }>;
+    /** Story docs rendered to plain text/markdown; adapters convert as needed. */
+    description: string;
+    links: ReadonlyArray<{
+        label: string;
+        url: string;
+    }>;
+}
+/** Evidence uploaded alongside a result. */
+interface ResultAttachment {
+    filename: string;
+    mediaType: string;
+    body: Uint8Array;
+    role?: "screenshot" | "video" | "trace" | "log";
+}
+/** One execution record to push. */
+interface CaseResult {
+    caseId: string;
+    status: "passed" | "failed" | "skipped";
+    durationMs: number;
+    message?: string;
+    /** Deep link into the generated HTML report for this scenario. */
+    url?: string;
+    attachments?: ResultAttachment[];
+}
+/** What a provider did with a batch of results. */
+interface RecordResultsSummary {
+    /** Provider-native run/execution id, when one was created. */
+    runId?: string;
+    /** URL of the created run/execution, when the provider exposes one. */
+    runUrl?: string;
+    recorded: number;
+    /** Results the provider declined (e.g. no status mapping configured). */
+    skipped: Array<{
+        caseId: string;
+        reason: string;
+    }>;
+    attachmentsUploaded: number;
+}
+/**
+ * A test-management system, reduced to what the engine needs.
+ *
+ * `createCase`/`updateCase` return the resulting {@link RemoteCase} rather than
+ * just an id so the engine can hash the provider's own normalized copy.
+ */
+interface SyncProvider {
+    /** Stable key used in config, CLI args, and the lockfile. */
+    name: string;
+    listCases(): Promise<RemoteCase[]>;
+    createCase?(body: CaseBody): Promise<RemoteCase>;
+    updateCase?(id: string, body: CaseBody): Promise<RemoteCase>;
+    recordResults?(results: CaseResult[]): Promise<RecordResultsSummary>;
+    /**
+     * Per-file limit. The engine skips oversized attachments and reports them in
+     * the plan, rather than letting an adapter die mid-upload with half a run
+     * already pushed.
+     */
+    maxAttachmentBytes?: number;
+    /** Human-readable target, shown in the plan header (e.g. "ACME / Regression"). */
+    describeTarget?(): string;
+}
+/** Injectable dependencies shared by every adapter. */
+interface AdapterDeps {
+    fetch: typeof globalThis.fetch;
+    logger: {
+        warn(msg: string): void;
+    };
+}
+
+/**
+ * The sync lockfile: the binding between a behaviour in the codebase and a case
+ * in someone else's system.
+ *
+ * Committed to the repo on purpose. When CI creates a case, the lockfile diff
+ * shows up in the pull request that caused it, so a reviewer sees the new case
+ * and its link before it lands anywhere else.
+ *
+ * Keyed on `behaviourFingerprint` (content-derived) rather than the canonical
+ * test-case id (`sha1(sourceFile::scenario)`), which changes the moment someone
+ * renames a test or moves a file. Keying on the volatile id would orphan every
+ * case on the first rename, which is exactly how these integrations lose trust.
+ */
+
+declare const DEFAULT_LOCKFILE_PATH = ".executable-stories/sync.lock.json";
+/** One behaviour-to-case binding. */
+interface LockEntry {
+    /** Provider-native case id. */
+    caseId: string;
+    url: string;
+    /**
+     * Hash of the provider's normalized copy as of our last write. A mismatch on
+     * the next run means a human edited the case in the provider's UI.
+     */
+    hash: string;
+    /** Last known title, so orphan reports are readable without a remote lookup. */
+    title: string;
+    /**
+     * True only for cases this tool created.
+     *
+     * A case reached through a `story.tickets` id was authored by a human, so we
+     * push executions against it and never touch its body. Without this flag the
+     * first sync would silently overwrite hand-written cases, which is the single
+     * fastest way to lose a QA team.
+     */
+    owned: boolean;
+}
+interface Lockfile {
+    version: number;
+    /** provider name -> behaviour fingerprint -> entry */
+    providers: Record<string, Record<string, LockEntry>>;
+}
+declare function emptyLockfile(): Lockfile;
+/**
+ * Hash provider-normalized case content.
+ *
+ * Deliberately excludes `links`: those embed report URLs that change with every
+ * CI run (build number, artifact host), and treating that churn as a human edit
+ * would make the drift guard fire constantly and get switched off.
+ */
+declare function hashCaseBody(body: CaseBody): string;
+/**
+ * Parse lockfile text. `label` names the source in errors, so the caller decides
+ * whether that is a path, a URL, or something else entirely.
+ *
+ * Split from {@link readLockfile} so the CLI can route every read and write
+ * through its injected file dependencies and still share these error messages.
+ */
+declare function parseLockfile(contents: string, label: string): Lockfile;
+/** Serialize with sorted keys so the diff a reviewer sees is minimal and stable. */
+declare function serializeLockfile(lock: Lockfile): string;
+declare function readLockfile(file: string): Lockfile;
+declare function writeLockfile(file: string, lock: Lockfile): void;
+
+/**
+ * Provider-agnostic sync engine.
+ *
+ * Everything that is not a vendor API call lives here: projecting stories into
+ * case bodies, binding them to remote cases, classifying what the provider
+ * holds, building the plan, and applying it. Adapters stay thin.
+ *
+ * Two phases, deliberately separate so `--dry-run` and a real run share one code
+ * path: {@link analyzeSync} reads and decides, {@link applySync} writes.
+ *
+ * fn(args, deps) throughout.
+ */
+
+/** Which executions get their evidence uploaded. */
+type AttachPolicy = "failed" | "all" | "none";
+interface SyncEngineConfig {
+    /**
+     * Ticket-id prefix that marks a `story.tickets` entry as this provider's case
+     * id (TestRail's "C1234"). Without it, only the lockfile binds.
+     */
+    ticketPrefix?: string;
+    /**
+     * Whether the prefix is decoration to strip ("C1234" -> "1234", TestRail) or
+     * part of the id itself ("PROJ-42" stays whole, Xray/Jira). Default true.
+     */
+    ticketPrefixStrip?: boolean;
+    /** Base URL of the published HTML report, used for links back from cases. */
+    reportUrl?: string;
+    /**
+     * Turns a scenario into the fragment appended to `reportUrl`, for a link that
+     * lands on the scenario rather than the top of the page.
+     *
+     * Caller-supplied for the same reason the markdown formatter's option is
+     * (`types/options.ts`): the correct slug depends on how the docs site routes,
+     * and guessing it produces links that 404. Without it, cases link to the
+     * report page itself.
+     */
+    scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
+    /** Default "failed": nobody watches a passing test's video, and quotas are real. */
+    attach?: AttachPolicy;
+    /** Similarity at or above which an unlinked case is flagged as a possible duplicate. */
+    duplicateThreshold?: number;
+}
+/** A story, ready to be a case. */
+interface LocalBehaviour {
+    fingerprint: string;
+    testCase: TestCaseResult;
+    body: CaseBody;
+}
+type CoverageClass = "automated" | "duplicated" | "possible-duplicate" | "manual-only";
+interface ClassifiedCase {
+    case: RemoteCase;
+    classification: CoverageClass;
+    /** Scenario title this case resembles or duplicates, when one was found. */
+    resembles?: string;
+    /** 0..1, present for "possible-duplicate". */
+    similarity?: number;
+}
+interface PlanCreate {
+    fingerprint: string;
+    scenario: string;
+    body: CaseBody;
+}
+interface PlanUpdate {
+    fingerprint: string;
+    caseId: string;
+    url: string;
+    scenario: string;
+    body: CaseBody;
+}
+interface PlanSkip {
+    fingerprint: string;
+    caseId: string;
+    url: string;
+    title: string;
+    reason: "remote-edited" | "case-missing";
+}
+interface PlanOrphan {
+    fingerprint: string;
+    caseId: string;
+    url: string;
+    title: string;
+}
+interface AttachmentSummary {
+    files: number;
+    bytes: number;
+    oversized: Array<{
+        filename: string;
+        bytes: number;
+        limit: number;
+    }>;
+    byRole: Record<string, number>;
+}
+interface SyncAnalysis {
+    provider: string;
+    target?: string;
+    local: LocalBehaviour[];
+    remote: ClassifiedCase[];
+    create: PlanCreate[];
+    update: PlanUpdate[];
+    unchanged: PlanUpdate[];
+    /** Human-authored cases bound via `story.tickets`. Executions only, body untouched. */
+    adopted: PlanUpdate[];
+    skipped: PlanSkip[];
+    orphaned: PlanOrphan[];
+    /** Results for behaviours already bound. Newly created cases add theirs at apply time. */
+    results: CaseResult[];
+    attachments: AttachmentSummary;
+    /** Capabilities this provider lacks that the plan would otherwise use. */
+    unsupported: string[];
+    /**
+     * Bound cases the provider would not hand back a body for, so a human edit to
+     * them cannot be detected. Reported rather than assumed safe.
+     */
+    driftUncheckable: number;
+    /** Set when the orphan count suggests the run was filtered rather than complete. */
+    partialRunWarning?: string;
+}
+interface SyncApplyResult {
+    created: Array<{
+        scenario: string;
+        caseId: string;
+        url: string;
+    }>;
+    updated: Array<{
+        scenario: string;
+        caseId: string;
+        url: string;
+    }>;
+    resultsRecorded: number;
+    resultsSkipped: Array<{
+        caseId: string;
+        reason: string;
+    }>;
+    attachmentsUploaded: number;
+    runUrl?: string;
+    errors: string[];
+}
+/** Project one canonical test case into provider-neutral case content. */
+declare function toCaseBody(tc: TestCaseResult, config: SyncEngineConfig): CaseBody;
+/**
+ * Project a run into fingerprinted behaviours.
+ *
+ * `behaviourFingerprint` returns "" for a scenario with no steps and no
+ * `covers`, and two scenarios with identical steps collide. Both fall back to
+ * the canonical test-case id, which is unique within a run — less
+ * rename-resilient, but a stable binding beats a shared one.
+ */
+declare function projectBehaviours(run: TestRunResult, config: SyncEngineConfig): LocalBehaviour[];
+/** Attachments for one test, filtered by policy and the provider's size limit. */
+declare function collectAttachments(args: {
+    testCase: TestCaseResult;
+    policy: AttachPolicy;
+    maxBytes?: number;
+}): {
+    attachments: ResultAttachment[];
+    oversized: Array<{
+        filename: string;
+        bytes: number;
+        limit: number;
+    }>;
+};
+interface AnalyzeSyncArgs {
+    run: TestRunResult;
+    provider: SyncProvider;
+    lockfile: Lockfile;
+    config: SyncEngineConfig;
+}
+declare function analyzeSync(args: AnalyzeSyncArgs): Promise<SyncAnalysis>;
+interface ApplySyncArgs {
+    analysis: SyncAnalysis;
+    provider: SyncProvider;
+    lockfile: Lockfile;
+    config: SyncEngineConfig;
+}
+interface ApplySyncDeps {
+    logger: {
+        warn(msg: string): void;
+    };
+}
+/**
+ * Execute the plan. Mutates the passed lockfile so the caller can persist it
+ * even when a later stage fails — a created case whose binding was lost would
+ * be re-created on the next run, which is the one duplicate we can actually
+ * cause.
+ */
+declare function applySync(args: ApplySyncArgs, deps: ApplySyncDeps): Promise<SyncApplyResult>;
+
+/**
+ * TestRail adapter.
+ *
+ * Translates between the sync port and TestRail's API v2. All decisions about
+ * what to write live in the engine; this file only knows how TestRail spells
+ * things.
+ *
+ * Case templates differ per instance, which is why the step and description
+ * field names are configurable. The defaults match TestRail's stock
+ * "Test Case (Steps)" template.
+ *
+ * Auth: basic, with an API key rather than a password. Generate one under
+ * My Settings -> API Keys.
+ */
+
+interface TestRailConfig {
+    /** Instance URL, e.g. https://acme.testrail.io */
+    url: string;
+    projectId: number | string;
+    /** Required on multi-suite projects. */
+    suiteId?: number | string;
+    /** Target section for created cases. Without it, creation is refused. */
+    sectionId?: number | string;
+    /** Reuse an existing run instead of creating one per sync. */
+    runId?: number | string;
+    /** Name for created runs. A UTC timestamp is appended. */
+    runName?: string;
+    /** Close the run after recording results. */
+    closeRun?: boolean;
+    /** Case template to create against, when the project uses a non-default one. */
+    templateId?: number;
+    /**
+     * Result status ids. TestRail ships 1=Passed and 5=Failed; there is no stock
+     * "skipped", so skipped results are dropped unless an id is configured.
+     */
+    statusIds?: {
+        passed?: number;
+        failed?: number;
+        skipped?: number;
+    };
+    /** Field names, for instances with customised case templates. */
+    fields?: {
+        steps?: string;
+        description?: string;
+    };
+    /**
+     * Per-file attachment limit. Conservative by default: instances have storage
+     * quotas, and a surprise 200 MB of video is a support ticket.
+     */
+    maxAttachmentBytes?: number;
+}
+interface TestRailAuth {
+    username: string;
+    apiKey: string;
+}
+declare function createTestRailProvider(config: TestRailConfig, auth: TestRailAuth, deps: AdapterDeps): SyncProvider;
+
+/**
+ * Xray (Jira Cloud) adapter.
+ *
+ * Xray splits its API in two and this adapter has to speak both: a GraphQL API
+ * for test definitions, and a REST endpoint for importing execution results.
+ * Evidence rides along with the results as base64, so screenshots and video
+ * land on the execution without a separate upload call.
+ *
+ * A case id here is a Jira issue key ("PROJ-42"), not a number, which is why
+ * `ticketPrefixStrip: false` is the right engine setting for this provider.
+ *
+ * Auth: an Xray API key pair (client id + secret) from Jira Settings -> Apps ->
+ * Xray -> API Keys. Updating an existing test's summary or description also
+ * needs Jira credentials, because those are Jira fields Xray does not own.
+ */
+
+interface XrayConfig {
+    /** Jira site URL, e.g. https://acme.atlassian.net */
+    jiraBaseUrl: string;
+    projectKey: string;
+    /** Xray Cloud API base. */
+    xrayBaseUrl?: string;
+    /** Selects the existing tests to reconcile against. */
+    jql?: string;
+    /** Xray test type for created tests. */
+    testType?: string;
+    /** Link created executions to this test plan. */
+    testPlanKey?: string;
+    /** Push results into an existing execution instead of creating one. */
+    testExecutionKey?: string;
+    /** Summary for created executions. A UTC timestamp is appended. */
+    executionSummary?: string;
+    statuses?: {
+        passed?: string;
+        failed?: string;
+        skipped?: string;
+    };
+    maxAttachmentBytes?: number;
+}
+interface XrayAuth {
+    clientId: string;
+    clientSecret: string;
+    /** Atlassian account email, needed only to update Jira summary/description. */
+    jiraEmail?: string;
+    /** Atlassian API token, needed only to update Jira summary/description. */
+    jiraToken?: string;
+}
+declare function createXrayProvider(config: XrayConfig, auth: XrayAuth, deps: AdapterDeps): SyncProvider;
+
+/**
+ * Provider registry.
+ *
+ * Adding a provider is one file next to this one plus one entry in the map
+ * below. No dynamic import: the CLI ships as a Bun single binary, which cannot
+ * see modules resolved at runtime, so adapters are in-tree by design.
+ *
+ * Credentials come from the environment only, never from the config file, so a
+ * config can be committed without leaking anything.
+ */
+
+type ProviderName = "testrail" | "xray";
+/** Per-provider config as it appears under `sync` in executable-stories.config.mjs. */
+interface SyncTargets {
+    testrail?: TestRailConfig & Partial<SyncEngineConfig>;
+    xray?: XrayConfig & Partial<SyncEngineConfig>;
+}
+interface BuiltProvider {
+    provider: SyncProvider;
+    /** Engine defaults this provider implies, overridable per target in config. */
+    engineDefaults: SyncEngineConfig;
+}
+declare const PROVIDER_NAMES: ProviderName[];
+declare function isProviderName(value: string): value is ProviderName;
+declare function buildProvider(args: {
+    name: ProviderName;
+    targets: SyncTargets;
+    env: Record<string, string | undefined>;
+}, deps: AdapterDeps): BuiltProvider;
+
 interface Formatter {
     name: string;
     fileExtension?: string;
@@ -725,7 +1222,72 @@ interface Formatter {
 }
 interface ExecutableStoriesConfig {
     formatters?: Record<string, Formatter>;
+    /**
+     * Test-management targets for `coverage` and `sync`. Shape only — credentials
+     * are read from the environment so this file stays committable.
+     */
+    sync?: SyncTargets;
+}
+
+/**
+ * Rendering for the two things a human reads: the coverage report and the plan.
+ *
+ * Coverage answers "what does my test-management system hold that my tests
+ * already cover?", which needs no write access and is the whole reason to try
+ * this. The plan borrows `terraform plan` deliberately: the idiom is already in
+ * everyone's head, and it is what makes pointing this at a company's TestRail
+ * feel safe.
+ *
+ * Pure functions of a {@link SyncAnalysis}. No IO here.
+ */
+
+interface CoverageSummary {
+    provider: string;
+    target?: string;
+    totalCases: number;
+    automated: number;
+    duplicated: number;
+    possibleDuplicate: number;
+    manualOnly: number;
+    /** Stories with no case in the provider. */
+    untracked: number;
+    /** Stories whose case was reached through a human-authored ticket id. */
+    adopted: number;
+}
+interface CoverageJson extends CoverageSummary {
+    schema: "executable-stories/sync-coverage/v1";
+    cases: Array<{
+        id: string;
+        url: string;
+        title: string;
+        section?: string;
+        classification: ClassifiedCase["classification"];
+        resembles?: string;
+        similarity?: number;
+    }>;
+    untrackedScenarios: string[];
+    orphaned: Array<{
+        caseId: string;
+        url: string;
+        title: string;
+    }>;
+    sections: Array<{
+        name: string;
+        total: number;
+        automated: number;
+    }>;
 }
+/** Human-readable coverage, the first thing anyone sees. */
+declare function renderCoverageText(analysis: SyncAnalysis): string;
+/** The same content as Markdown, so it can be pasted, published, or PR-commented. */
+declare function renderCoverageMarkdown(analysis: SyncAnalysis): string;
+declare function buildCoverageJson(analysis: SyncAnalysis): CoverageJson;
+/** terraform-plan-shaped output. Read before anything is written. */
+declare function renderPlan(analysis: SyncAnalysis, opts: {
+    dryRun: boolean;
+}): string;
+/** What actually happened, printed after a real run. */
+declare function renderApplyResult(result: SyncApplyResult): string;
 
 /**
  * Diff types — parsed unified patches and content-anchored annotation targets.
@@ -2793,4 +3355,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 { AgentTextFormatter, type AnchorResolution, type AnchorState, 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 CodeDiffAnnotation, type CodeDiffAnnotationInput, type CodeDiffEvidence, type CodeDiffInput, type CodeDiffScenarioRef, type CodeDiffSidecar, type CodeDiffSidecarAnnotation, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, type DeploymentEntry, type DeploymentLedger, type DeploymentStatus, type DiffAnchor, type DiffHunk, type DiffLine, type DiffRunsOptions, type EnvironmentDrift, type EvidenceStrength, type ExecutableStoriesConfig, type FetchFn, type FileChangeKind, type FileDiff, type FlakinessLevel, type Formatter, type FormatterOptions, type GenerateArgs, type GenerateCompareResult, type GenerateDeps, type GenerateResult, type GenericWebhookNotifierOptions, type GoalArgs, type GoalDeps, type GoalReport, type GoalRequirementResult, type HistoryEntry, type HistoryStore, type 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 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, RunDiffChangelogFormatter, type RunDiffChangelogOptions, 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, TraceabilityCsvFormatter, 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, assembleCodeDiff, buildCheck, buildGoal, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, classifyStatusChange, clearVersionCache, codeDiffDiagnostics, computeTestMetrics, copyMarkdownAssets, createAnchor, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, generateRunComparison, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, normalizeFormats, normalizeJestResults, normalizePlaywrightResults, normalizeVitestResults, parseUnifiedDiff, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, regenerateRun, relocateAnchor, renderCheck, renderGoal, renderTriage, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, startWatch, stripAnsi, toAgentText, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toTraceabilityMatrix, updateHistory };
+export { type AdapterDeps, AgentTextFormatter, type AnchorResolution, type AnchorState, type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, type AttachPolicy, type BehaviorDebuggerIssue, type BehaviorDiff, type BehaviorDiffEntry, type BehaviorManifest, BehaviorManifestJsonFormatter, type BehaviorManifestJsonOptions, type BehaviorSourceFile, type BehaviorTag, type BundleOptions, type BundleResult, type CaseBody, type CaseResult, type ChangeType, type ChangedFile, type ChangedFileReview, type CheckArgs, type CheckDeps, type CheckFailure, type CheckReport, type CheckStep, type CodeDiffAnnotation, type CodeDiffAnnotationInput, type CodeDiffEvidence, type CodeDiffInput, type CodeDiffScenarioRef, type CodeDiffSidecar, type CodeDiffSidecarAnnotation, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, type CoverageClass, type CoverageJson, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, DEFAULT_LOCKFILE_PATH, type DeploymentEntry, type DeploymentLedger, type DeploymentStatus, type DiffAnchor, type DiffHunk, type DiffLine, type DiffRunsOptions, type EnvironmentDrift, type EvidenceStrength, type ExecutableStoriesConfig, type FetchFn, type FileChangeKind, type FileDiff, type FlakinessLevel, type Formatter, type FormatterOptions, type GenerateArgs, type GenerateCompareResult, type GenerateDeps, type GenerateResult, type GenericWebhookNotifierOptions, type GoalArgs, type GoalDeps, type GoalReport, type GoalRequirementResult, type HistoryEntry, type HistoryStore, type 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 LockEntry, type Lockfile, type Logger, MIN_FLAKINESS_SAMPLES, MIN_METRIC_SAMPLES, MIN_PERF_SAMPLES, MarkdownFormatter, type MarkdownFormatterOptions, type MarkdownOptions, type MarkdownRenderers, type NotificationSummary, type NotifyCondition, type OutputConfig, type OutputFormat, type OutputMode, type OutputRule, PROVIDER_NAMES, type PerformanceTrend, type ProviderName, type PublishConfluenceArgs, type PublishConfluenceDeps, type PublishConfluenceResult, type PublishJiraArgs, type PublishJiraDeps, type PublishJiraResult, type RatchetViolation, type RecordDeploymentArgs, type RecordDeploymentResult, type RecordResultsSummary, type ReleaseManifest, ReleaseManifestFormatter, type RemoteCase, ReportGenerator, type ResolvedFormatterOptions, type ResultAttachment, 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 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 SyncAnalysis, type SyncApplyResult, type SyncEngineConfig, type SyncProvider, type SyncTargets, type TestHistory, type TestMetrics, type TestRailConfig, TraceabilityCsvFormatter, 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, type XrayConfig, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, analyzeSync, applySync, assembleCodeDiff, buildCheck, buildCoverageJson, buildGoal, buildProvider, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, classifyStatusChange, clearVersionCache, codeDiffDiagnostics, collectAttachments, computeTestMetrics, copyMarkdownAssets, createAnchor, createPrCommentSummary, createReportGenerator, createTestRailProvider, createXrayProvider, deriveAudience, deriveChangeType, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, emptyLockfile, findGitDir, generateRunComparison, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, hashCaseBody, isProviderName, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, normalizeFormats, normalizeJestResults, normalizePlaywrightResults, normalizeVitestResults, parseLockfile, parseUnifiedDiff, projectBehaviours, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readLockfile, readPackageVersion, recordDeployment, regenerateArtifacts, regenerateRun, relocateAnchor, renderApplyResult, renderCheck, renderCoverageMarkdown, renderCoverageText, renderGoal, renderPlan, renderTriage, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, serializeLockfile, signBody, startWatch, stripAnsi, toAgentText, toBehaviorManifest, toCaseBody, toReleaseManifest, toScenarioIndex, toTraceabilityMatrix, updateHistory, writeLockfile };