executable-stories-formatters 0.7.8 → 0.7.10

package/dist/index.d.cts

@@ -172,6 +172,79 @@ interface WebhookPayload {
     summary: NotificationSummary;
 }
 
+/**
+ * Confluence (ADF) Formatter — Layer 3.
+ *
+ * Emits Atlassian Document Format JSON. Suitable for Confluence pages
+ * and Jira issue descriptions via the REST API. Built directly from
+ * TestRunResult so code blocks, tables, links, and mermaid all round-trip
+ * with higher fidelity than converting markdown → ADF.
+ */
+
+/** Options for ConfluenceFormatter */
+interface ConfluenceFormatterOptions {
+    /** Page title. Default: "User Stories" */
+    title?: string;
+    /** Include status icons (emoji) in scenario headings. Default: true */
+    includeStatusIcons?: boolean;
+    /** Include metadata table (date, version). Default: true */
+    includeMetadata?: boolean;
+    /** Include summary table (counts, duration). Default: true */
+    includeSummaryTable?: boolean;
+    /** Include error details for failed scenarios. Default: true */
+    includeErrors?: boolean;
+    /** Scenario heading level (1-6). Default: 3 */
+    scenarioHeadingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Group scenarios by. Default: "file" */
+    groupBy?: "file" | "suite" | "none";
+    /** Sort scenarios. Default: "source" */
+    sortScenarios?: "alpha" | "source" | "none";
+    /** Pretty-print JSON output. Default: true */
+    pretty?: boolean;
+    /** Base URL for source permalinks (Git). Rendered as link marks */
+    permalinkBaseUrl?: string;
+    /** URL template for ticket links. Use {ticket} as placeholder */
+    ticketUrlTemplate?: string;
+}
+interface AdfMark {
+    type: string;
+    attrs?: Record<string, unknown>;
+}
+interface AdfNode {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: AdfNode[];
+    marks?: AdfMark[];
+    text?: string;
+    /** Only on the root doc node */
+    version?: number;
+}
+/**
+ * Confluence / Atlassian Document Format formatter.
+ *
+ * Emits a top-level `{ version: 1, type: "doc", content: [...] }` tree that
+ * can be posted to the Confluence or Jira REST API.
+ */
+declare class ConfluenceFormatter {
+    private options;
+    constructor(options?: ConfluenceFormatterOptions);
+    /** Build the ADF document tree. Returns the JS object (not stringified). */
+    formatToAdf(run: TestRunResult): AdfNode;
+    /** Format a test run as an ADF JSON string. */
+    format(run: TestRunResult): string;
+    private renderMetadataTable;
+    private renderSummaryTable;
+    private renderByFile;
+    private renderBySuite;
+    private renderFlat;
+    private renderSuiteGroups;
+    private renderScenario;
+    private renderStepsList;
+    private renderDocEntry;
+    private sortCases;
+    private sortSuiteGroups;
+}
+
 /**
  * Configuration options for ACL and formatters.
  */
@@ -200,7 +273,7 @@ interface CanonicalizeOptions {
     };
 }
 /** Output format for report generation */
-type OutputFormat = "astro" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown";
+type OutputFormat = "astro" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown";
 /** Sort order for test cases in reports (deterministic for diff-friendly output) */
 type SortTestCasesMode = "id" | "source" | "none";
 /** Output mode for report routing */
@@ -320,6 +393,8 @@ interface FormatterOptions {
     markdown?: MarkdownFormatterOptions;
     /** Astro/Starlight specific options */
     astro?: AstroFormatterOptions$1;
+    /** Confluence/ADF specific options */
+    confluence?: ConfluenceFormatterOptions;
     /** History tracking options */
     history?: {
         /** Path to JSON history file (enables tracking) */
@@ -473,6 +548,19 @@ interface ResolvedFormatterOptions {
         includeSourceLinks: boolean;
         customRenderers?: MarkdownRenderers;
     };
+    confluence: {
+        title: string;
+        includeStatusIcons: boolean;
+        includeMetadata: boolean;
+        includeSummaryTable: boolean;
+        includeErrors: boolean;
+        scenarioHeadingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+        groupBy: "file" | "suite" | "none";
+        sortScenarios: "alpha" | "source" | "none";
+        pretty: boolean;
+        permalinkBaseUrl?: string;
+        ticketUrlTemplate?: string;
+    };
     astro: {
         assetsDir: string;
         assetsBaseUrl: string;
@@ -1438,10 +1526,11 @@ declare class MarkdownFormatter {
 }
 
 /**
- * Astro/Starlight Formatter - Layer 3.
+ * Astro Formatter - Layer 3.
  *
- * Wraps the MarkdownFormatter to produce Starlight-compatible .md files
- * with proper YAML frontmatter (title, description, sidebar.badge).
+ * Wraps the MarkdownFormatter to produce .md files with YAML frontmatter
+ * (title, description, sidebar.badge) for Starlight content collections.
+ * The scaffolded docs site uses themed CSS matching the HTML report design system.
  */
 
 interface StarlightBadge {
@@ -1461,6 +1550,114 @@ declare class AstroFormatter {
     static computeBadge(testCases: Pick<TestCaseResult, "status">[]): StarlightBadge;
 }
 
+/**
+ * Confluence publisher.
+ *
+ * Pushes an ADF JSON document to a Confluence Cloud page via the REST API v2.
+ * - If `pageId` is provided, the page is updated in place (title + body + version).
+ * - If `spaceId` is provided instead, a new page is created (optionally under `parentId`).
+ *
+ * Authentication: Basic auth with an Atlassian email + API token.
+ * Generate tokens at https://id.atlassian.com/manage-profile/security/api-tokens.
+ */
+/** HTTP fetch function (injectable for tests). Matches global fetch signature. */
+type FetchFn = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText: string;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+interface ConfluenceAuth {
+    /** Atlassian account email */
+    email: string;
+    /** Atlassian API token */
+    token: string;
+}
+interface PublishConfluenceArgs {
+    /** ADF document JSON string (the `{ version, type: "doc", content }` envelope) */
+    adf: string;
+    /** Page ID to update (mutually exclusive with spaceId for create) */
+    pageId?: string;
+    /** Space ID required when creating a new page */
+    spaceId?: string;
+    /** Parent page ID (optional, for new pages) */
+    parentId?: string;
+    /** Page title. Required for create; updates existing title if provided on update */
+    title?: string;
+    /** Base URL of the Confluence instance, e.g. https://acme.atlassian.net/wiki */
+    baseUrl: string;
+}
+interface PublishConfluenceDeps {
+    auth: ConfluenceAuth;
+    /** Defaults to globalThis.fetch */
+    fetch?: FetchFn;
+}
+interface PublishConfluenceResult {
+    id: string;
+    version: number;
+    title: string;
+    /** Canonical URL to view the page in Confluence */
+    url: string;
+    action: "created" | "updated";
+}
+/**
+ * Publish an ADF document to Confluence. Creates a new page if `pageId` is
+ * omitted, otherwise updates the existing page.
+ */
+declare function publishConfluencePage(args: PublishConfluenceArgs, deps: PublishConfluenceDeps): Promise<PublishConfluenceResult>;
+
+/**
+ * Jira publisher.
+ *
+ * Pushes an ADF JSON document to a Jira Cloud issue via the REST API v3.
+ * - mode "comment"     adds the ADF as a new comment (default, non-destructive)
+ * - mode "description" replaces the issue description field with the ADF
+ *
+ * Authentication: Basic auth with an Atlassian email + API token (same token
+ * system as Confluence — create one at id.atlassian.com).
+ *
+ * Note: unlike Confluence v2 (which expects the ADF as a stringified value),
+ * Jira v3 accepts ADF as a native JSON object in the request body.
+ */
+
+/** Reuses the same auth + fetch shape as the Confluence publisher */
+type JiraAuth = ConfluenceAuth;
+/** Update mode — default "comment" is non-destructive and append-only */
+type JiraPublishMode = "comment" | "description";
+interface PublishJiraArgs {
+    /** ADF document JSON string (the `{ version, type: "doc", content }` envelope) */
+    adf: string;
+    /** Issue key, e.g. "PROJ-123" */
+    issueKey: string;
+    /** Base URL of the Jira instance, e.g. https://acme.atlassian.net */
+    baseUrl: string;
+    /** Defaults to "comment" */
+    mode?: JiraPublishMode;
+}
+interface PublishJiraDeps {
+    auth: JiraAuth;
+    /** Defaults to globalThis.fetch */
+    fetch?: FetchFn;
+}
+interface PublishJiraResult {
+    issueKey: string;
+    action: "description-updated" | "comment-added";
+    /** Canonical URL to view the issue (and comment, if applicable) */
+    url: string;
+    /** Set only when mode = "comment" */
+    commentId?: string;
+}
+/**
+ * Publish an ADF document to a Jira issue. Defaults to adding a new comment.
+ * Use mode: "description" to replace the issue's description field.
+ */
+declare function publishJiraIssue(args: PublishJiraArgs, deps: PublishJiraDeps): Promise<PublishJiraResult>;
+
 interface AstroAssetResult {
     markdown: string;
     copiedCount: number;
@@ -2364,4 +2561,4 @@ declare function normalizeVitestResults(testModules: Parameters<typeof adaptVite
  */
 declare function normalizePlaywrightResults(testResults: Parameters<typeof adaptPlaywrightRun>[0], adapterOptions?: Parameters<typeof adaptPlaywrightRun>[1], canonicalizeOptions?: CanonicalizeOptions): TestRunResult;
 
-export { type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, type Attachment, type BundleOptions, type BundleResult, type CIInfo, CIProvider, type CanonicalizeOptions, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type CopyMarkdownAssetsOptions, type CoverageSummary, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, DocEntry, type ExecutableStoriesConfig, 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 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, RawAttachment, RawCIInfo, RawRun, RawStatus, ReportGenerator, type ResolvedFormatterOptions, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, type StepResult, StoryMeta, StoryStep, type TestCaseAttempt, type TestCaseResult, type TestHistory, type TestMetrics, type TestRunResult, type TestStatus, CIInfo$1 as TypedCIInfo, type ValidationResult, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, hasSufficientHistory, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, readBranchName, readGitSha, readPackageVersion, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, stripAnsi, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };
+export { type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, type Attachment, type BundleOptions, type BundleResult, type CIInfo, CIProvider, type CanonicalizeOptions, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, type CoverageSummary, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, DocEntry, type ExecutableStoriesConfig, type FetchFn, 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, ReportGenerator, type ResolvedFormatterOptions, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, type StepResult, StoryMeta, StoryStep, type TestCaseAttempt, type TestCaseResult, type TestHistory, type TestMetrics, type TestRunResult, type TestStatus, CIInfo$1 as TypedCIInfo, type ValidationResult, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, hasSufficientHistory, 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, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };

package/dist/index.d.ts

@@ -172,6 +172,79 @@ interface WebhookPayload {
     summary: NotificationSummary;
 }
 
+/**
+ * Confluence (ADF) Formatter — Layer 3.
+ *
+ * Emits Atlassian Document Format JSON. Suitable for Confluence pages
+ * and Jira issue descriptions via the REST API. Built directly from
+ * TestRunResult so code blocks, tables, links, and mermaid all round-trip
+ * with higher fidelity than converting markdown → ADF.
+ */
+
+/** Options for ConfluenceFormatter */
+interface ConfluenceFormatterOptions {
+    /** Page title. Default: "User Stories" */
+    title?: string;
+    /** Include status icons (emoji) in scenario headings. Default: true */
+    includeStatusIcons?: boolean;
+    /** Include metadata table (date, version). Default: true */
+    includeMetadata?: boolean;
+    /** Include summary table (counts, duration). Default: true */
+    includeSummaryTable?: boolean;
+    /** Include error details for failed scenarios. Default: true */
+    includeErrors?: boolean;
+    /** Scenario heading level (1-6). Default: 3 */
+    scenarioHeadingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Group scenarios by. Default: "file" */
+    groupBy?: "file" | "suite" | "none";
+    /** Sort scenarios. Default: "source" */
+    sortScenarios?: "alpha" | "source" | "none";
+    /** Pretty-print JSON output. Default: true */
+    pretty?: boolean;
+    /** Base URL for source permalinks (Git). Rendered as link marks */
+    permalinkBaseUrl?: string;
+    /** URL template for ticket links. Use {ticket} as placeholder */
+    ticketUrlTemplate?: string;
+}
+interface AdfMark {
+    type: string;
+    attrs?: Record<string, unknown>;
+}
+interface AdfNode {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: AdfNode[];
+    marks?: AdfMark[];
+    text?: string;
+    /** Only on the root doc node */
+    version?: number;
+}
+/**
+ * Confluence / Atlassian Document Format formatter.
+ *
+ * Emits a top-level `{ version: 1, type: "doc", content: [...] }` tree that
+ * can be posted to the Confluence or Jira REST API.
+ */
+declare class ConfluenceFormatter {
+    private options;
+    constructor(options?: ConfluenceFormatterOptions);
+    /** Build the ADF document tree. Returns the JS object (not stringified). */
+    formatToAdf(run: TestRunResult): AdfNode;
+    /** Format a test run as an ADF JSON string. */
+    format(run: TestRunResult): string;
+    private renderMetadataTable;
+    private renderSummaryTable;
+    private renderByFile;
+    private renderBySuite;
+    private renderFlat;
+    private renderSuiteGroups;
+    private renderScenario;
+    private renderStepsList;
+    private renderDocEntry;
+    private sortCases;
+    private sortSuiteGroups;
+}
+
 /**
  * Configuration options for ACL and formatters.
  */
@@ -200,7 +273,7 @@ interface CanonicalizeOptions {
     };
 }
 /** Output format for report generation */
-type OutputFormat = "astro" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown";
+type OutputFormat = "astro" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown";
 /** Sort order for test cases in reports (deterministic for diff-friendly output) */
 type SortTestCasesMode = "id" | "source" | "none";
 /** Output mode for report routing */
@@ -320,6 +393,8 @@ interface FormatterOptions {
     markdown?: MarkdownFormatterOptions;
     /** Astro/Starlight specific options */
     astro?: AstroFormatterOptions$1;
+    /** Confluence/ADF specific options */
+    confluence?: ConfluenceFormatterOptions;
     /** History tracking options */
     history?: {
         /** Path to JSON history file (enables tracking) */
@@ -473,6 +548,19 @@ interface ResolvedFormatterOptions {
         includeSourceLinks: boolean;
         customRenderers?: MarkdownRenderers;
     };
+    confluence: {
+        title: string;
+        includeStatusIcons: boolean;
+        includeMetadata: boolean;
+        includeSummaryTable: boolean;
+        includeErrors: boolean;
+        scenarioHeadingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+        groupBy: "file" | "suite" | "none";
+        sortScenarios: "alpha" | "source" | "none";
+        pretty: boolean;
+        permalinkBaseUrl?: string;
+        ticketUrlTemplate?: string;
+    };
     astro: {
         assetsDir: string;
         assetsBaseUrl: string;
@@ -1438,10 +1526,11 @@ declare class MarkdownFormatter {
 }
 
 /**
- * Astro/Starlight Formatter - Layer 3.
+ * Astro Formatter - Layer 3.
  *
- * Wraps the MarkdownFormatter to produce Starlight-compatible .md files
- * with proper YAML frontmatter (title, description, sidebar.badge).
+ * Wraps the MarkdownFormatter to produce .md files with YAML frontmatter
+ * (title, description, sidebar.badge) for Starlight content collections.
+ * The scaffolded docs site uses themed CSS matching the HTML report design system.
  */
 
 interface StarlightBadge {
@@ -1461,6 +1550,114 @@ declare class AstroFormatter {
     static computeBadge(testCases: Pick<TestCaseResult, "status">[]): StarlightBadge;
 }
 
+/**
+ * Confluence publisher.
+ *
+ * Pushes an ADF JSON document to a Confluence Cloud page via the REST API v2.
+ * - If `pageId` is provided, the page is updated in place (title + body + version).
+ * - If `spaceId` is provided instead, a new page is created (optionally under `parentId`).
+ *
+ * Authentication: Basic auth with an Atlassian email + API token.
+ * Generate tokens at https://id.atlassian.com/manage-profile/security/api-tokens.
+ */
+/** HTTP fetch function (injectable for tests). Matches global fetch signature. */
+type FetchFn = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText: string;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+interface ConfluenceAuth {
+    /** Atlassian account email */
+    email: string;
+    /** Atlassian API token */
+    token: string;
+}
+interface PublishConfluenceArgs {
+    /** ADF document JSON string (the `{ version, type: "doc", content }` envelope) */
+    adf: string;
+    /** Page ID to update (mutually exclusive with spaceId for create) */
+    pageId?: string;
+    /** Space ID required when creating a new page */
+    spaceId?: string;
+    /** Parent page ID (optional, for new pages) */
+    parentId?: string;
+    /** Page title. Required for create; updates existing title if provided on update */
+    title?: string;
+    /** Base URL of the Confluence instance, e.g. https://acme.atlassian.net/wiki */
+    baseUrl: string;
+}
+interface PublishConfluenceDeps {
+    auth: ConfluenceAuth;
+    /** Defaults to globalThis.fetch */
+    fetch?: FetchFn;
+}
+interface PublishConfluenceResult {
+    id: string;
+    version: number;
+    title: string;
+    /** Canonical URL to view the page in Confluence */
+    url: string;
+    action: "created" | "updated";
+}
+/**
+ * Publish an ADF document to Confluence. Creates a new page if `pageId` is
+ * omitted, otherwise updates the existing page.
+ */
+declare function publishConfluencePage(args: PublishConfluenceArgs, deps: PublishConfluenceDeps): Promise<PublishConfluenceResult>;
+
+/**
+ * Jira publisher.
+ *
+ * Pushes an ADF JSON document to a Jira Cloud issue via the REST API v3.
+ * - mode "comment"     adds the ADF as a new comment (default, non-destructive)
+ * - mode "description" replaces the issue description field with the ADF
+ *
+ * Authentication: Basic auth with an Atlassian email + API token (same token
+ * system as Confluence — create one at id.atlassian.com).
+ *
+ * Note: unlike Confluence v2 (which expects the ADF as a stringified value),
+ * Jira v3 accepts ADF as a native JSON object in the request body.
+ */
+
+/** Reuses the same auth + fetch shape as the Confluence publisher */
+type JiraAuth = ConfluenceAuth;
+/** Update mode — default "comment" is non-destructive and append-only */
+type JiraPublishMode = "comment" | "description";
+interface PublishJiraArgs {
+    /** ADF document JSON string (the `{ version, type: "doc", content }` envelope) */
+    adf: string;
+    /** Issue key, e.g. "PROJ-123" */
+    issueKey: string;
+    /** Base URL of the Jira instance, e.g. https://acme.atlassian.net */
+    baseUrl: string;
+    /** Defaults to "comment" */
+    mode?: JiraPublishMode;
+}
+interface PublishJiraDeps {
+    auth: JiraAuth;
+    /** Defaults to globalThis.fetch */
+    fetch?: FetchFn;
+}
+interface PublishJiraResult {
+    issueKey: string;
+    action: "description-updated" | "comment-added";
+    /** Canonical URL to view the issue (and comment, if applicable) */
+    url: string;
+    /** Set only when mode = "comment" */
+    commentId?: string;
+}
+/**
+ * Publish an ADF document to a Jira issue. Defaults to adding a new comment.
+ * Use mode: "description" to replace the issue's description field.
+ */
+declare function publishJiraIssue(args: PublishJiraArgs, deps: PublishJiraDeps): Promise<PublishJiraResult>;
+
 interface AstroAssetResult {
     markdown: string;
     copiedCount: number;
@@ -2364,4 +2561,4 @@ declare function normalizeVitestResults(testModules: Parameters<typeof adaptVite
  */
 declare function normalizePlaywrightResults(testResults: Parameters<typeof adaptPlaywrightRun>[0], adapterOptions?: Parameters<typeof adaptPlaywrightRun>[1], canonicalizeOptions?: CanonicalizeOptions): TestRunResult;
 
-export { type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, type Attachment, type BundleOptions, type BundleResult, type CIInfo, CIProvider, type CanonicalizeOptions, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type CopyMarkdownAssetsOptions, type CoverageSummary, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, DocEntry, type ExecutableStoriesConfig, 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 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, RawAttachment, RawCIInfo, RawRun, RawStatus, ReportGenerator, type ResolvedFormatterOptions, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, type StepResult, StoryMeta, StoryStep, type TestCaseAttempt, type TestCaseResult, type TestHistory, type TestMetrics, type TestRunResult, type TestStatus, CIInfo$1 as TypedCIInfo, type ValidationResult, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, hasSufficientHistory, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, readBranchName, readGitSha, readPackageVersion, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, stripAnsi, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };
+export { type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, type Attachment, type BundleOptions, type BundleResult, type CIInfo, CIProvider, type CanonicalizeOptions, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, type CoverageSummary, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, DocEntry, type ExecutableStoriesConfig, type FetchFn, 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, ReportGenerator, type ResolvedFormatterOptions, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, type StepResult, StoryMeta, StoryStep, type TestCaseAttempt, type TestCaseResult, type TestHistory, type TestMetrics, type TestRunResult, type TestStatus, CIInfo$1 as TypedCIInfo, type ValidationResult, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, hasSufficientHistory, 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, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };