executable-stories-formatters 1.14.0 → 1.16.1

package/dist/index.d.cts

@@ -308,6 +308,10 @@ interface FormatterOptions {
         mermaidEnabled?: boolean;
         /** Days before the report shows a stale warning. 0 disables. Default: 7 */
         staleAfterDays?: number;
+        /** Show the Share button in the interactive report header. Default: false. */
+        share?: boolean;
+        /** Command the share dialog shows. Default: `npx executable-stories share <output-dir>`. */
+        shareCommand?: string;
     };
     /**
      * Run history store (see loadHistory/updateHistory). When set, the HTML
@@ -479,6 +483,8 @@ interface ResolvedFormatterOptions {
         syntaxHighlighting: boolean;
         mermaidEnabled: boolean;
         staleAfterDays: number;
+        share: boolean;
+        shareCommand: string | undefined;
     };
     historyStore: HistoryStore | undefined;
     junit: {
@@ -2801,6 +2807,8 @@ interface CheckArgs {
     testCases: TestCaseResult[];
     /** Baseline scenario statuses keyed by scenario id, for regressed/fixed deltas. */
     baseline?: Map<string, TestStatus>;
+    /** Per-scenario time budget. Scenarios above it are named (see {@link CheckSlow}). */
+    maxDurationMs?: number;
     format: "text" | "json";
 }
 type CheckDeps = Record<string, never>;
@@ -2839,6 +2847,17 @@ interface CheckTurnedOff {
     status: "skipped" | "pending";
     tickets: string[];
 }
+/**
+ * A scenario that took longer than the budget. A slow suite is usually two or
+ * three scenarios, and nobody knows which until something names them.
+ */
+interface CheckSlow {
+    id: string;
+    scenario: string;
+    /** `sourceFile:sourceLine` */
+    location: string;
+    durationMs: number;
+}
 interface CheckReport {
     summary: {
         total: number;
@@ -2850,6 +2869,10 @@ interface CheckReport {
     failures: CheckFailure[];
     /** Scenarios switched off — named, not just counted (see {@link CheckTurnedOff}). */
     turnedOff: CheckTurnedOff[];
+    /** Scenarios over `--max-duration`, longest first. Empty without a budget. */
+    overBudget: CheckSlow[];
+    /** The budget those scenarios broke, for the message that names it. */
+    maxDurationMs?: number;
     /** Count of scenarios that went passed → failed vs. the baseline. */
     regressed: number;
     /** Count of scenarios that went failed → passed vs. the baseline. */
@@ -2925,6 +2948,22 @@ type GoalDeps = Record<string, never>;
 declare function buildGoal(args: GoalArgs, _deps?: GoalDeps): GoalReport;
 declare function renderGoal(report: GoalReport, format: "text" | "json"): string;
 
+/**
+ * CODEOWNERS parsing, so a failing scenario can name the team that fixes it.
+ *
+ * A red run that belongs to everyone belongs to nobody until someone
+ * volunteers. `triage --by-owner` groups the worklist the way the repo already
+ * divides responsibility, using the file every GitHub repo already has.
+ *
+ * Supports the common CODEOWNERS subset — leading `/`, trailing `/`,
+ * `*`, `**`, and bare extension globs. Character classes, `?`, and negation are
+ * not implemented; swap in a gitignore-grade matcher if a repo needs them.
+ */
+interface CodeownersRule {
+    pattern: string;
+    owners: string[];
+}
+
 /**
  * `triage` — the discovery-phase worklist for an agent loop.
  *
@@ -2945,6 +2984,8 @@ interface TriageItem {
     /** Product-code paths to fix. Empty when the scenario declared no `covers`. */
     covers: string[];
     tickets: string[];
+    /** CODEOWNERS entries for the code this scenario covers. Empty = unclaimed. */
+    owners: string[];
     errorMessage?: string;
     /** Passed in the baseline, failing now. Ranked first. */
     regressed: boolean;
@@ -2963,10 +3004,16 @@ interface TriageArgs {
     /** Baseline statuses by scenario id, to flag regressions and rank them first. */
     baseline?: Map<string, TestStatus>;
     format: "text" | "json";
+    /** Parsed CODEOWNERS. Without it every item is unowned. */
+    codeowners?: readonly CodeownersRule[];
 }
 type TriageDeps = Record<string, never>;
 declare function buildTriage(args: TriageArgs, _deps?: TriageDeps): TriageReport;
-declare function renderTriage(report: TriageReport, format: "text" | "json"): string;
+interface RenderTriageOptions {
+    /** Group the text worklist under each CODEOWNERS owner. */
+    byOwner?: boolean;
+}
+declare function renderTriage(report: TriageReport, format: "text" | "json", options?: RenderTriageOptions): string;
 
 /**
  * ReportGenerator — turns a canonical TestRunResult into report files.

package/dist/index.d.ts

@@ -308,6 +308,10 @@ interface FormatterOptions {
         mermaidEnabled?: boolean;
         /** Days before the report shows a stale warning. 0 disables. Default: 7 */
         staleAfterDays?: number;
+        /** Show the Share button in the interactive report header. Default: false. */
+        share?: boolean;
+        /** Command the share dialog shows. Default: `npx executable-stories share <output-dir>`. */
+        shareCommand?: string;
     };
     /**
      * Run history store (see loadHistory/updateHistory). When set, the HTML
@@ -479,6 +483,8 @@ interface ResolvedFormatterOptions {
         syntaxHighlighting: boolean;
         mermaidEnabled: boolean;
         staleAfterDays: number;
+        share: boolean;
+        shareCommand: string | undefined;
     };
     historyStore: HistoryStore | undefined;
     junit: {
@@ -2801,6 +2807,8 @@ interface CheckArgs {
     testCases: TestCaseResult[];
     /** Baseline scenario statuses keyed by scenario id, for regressed/fixed deltas. */
     baseline?: Map<string, TestStatus>;
+    /** Per-scenario time budget. Scenarios above it are named (see {@link CheckSlow}). */
+    maxDurationMs?: number;
     format: "text" | "json";
 }
 type CheckDeps = Record<string, never>;
@@ -2839,6 +2847,17 @@ interface CheckTurnedOff {
     status: "skipped" | "pending";
     tickets: string[];
 }
+/**
+ * A scenario that took longer than the budget. A slow suite is usually two or
+ * three scenarios, and nobody knows which until something names them.
+ */
+interface CheckSlow {
+    id: string;
+    scenario: string;
+    /** `sourceFile:sourceLine` */
+    location: string;
+    durationMs: number;
+}
 interface CheckReport {
     summary: {
         total: number;
@@ -2850,6 +2869,10 @@ interface CheckReport {
     failures: CheckFailure[];
     /** Scenarios switched off — named, not just counted (see {@link CheckTurnedOff}). */
     turnedOff: CheckTurnedOff[];
+    /** Scenarios over `--max-duration`, longest first. Empty without a budget. */
+    overBudget: CheckSlow[];
+    /** The budget those scenarios broke, for the message that names it. */
+    maxDurationMs?: number;
     /** Count of scenarios that went passed → failed vs. the baseline. */
     regressed: number;
     /** Count of scenarios that went failed → passed vs. the baseline. */
@@ -2925,6 +2948,22 @@ type GoalDeps = Record<string, never>;
 declare function buildGoal(args: GoalArgs, _deps?: GoalDeps): GoalReport;
 declare function renderGoal(report: GoalReport, format: "text" | "json"): string;
 
+/**
+ * CODEOWNERS parsing, so a failing scenario can name the team that fixes it.
+ *
+ * A red run that belongs to everyone belongs to nobody until someone
+ * volunteers. `triage --by-owner` groups the worklist the way the repo already
+ * divides responsibility, using the file every GitHub repo already has.
+ *
+ * Supports the common CODEOWNERS subset — leading `/`, trailing `/`,
+ * `*`, `**`, and bare extension globs. Character classes, `?`, and negation are
+ * not implemented; swap in a gitignore-grade matcher if a repo needs them.
+ */
+interface CodeownersRule {
+    pattern: string;
+    owners: string[];
+}
+
 /**
  * `triage` — the discovery-phase worklist for an agent loop.
  *
@@ -2945,6 +2984,8 @@ interface TriageItem {
     /** Product-code paths to fix. Empty when the scenario declared no `covers`. */
     covers: string[];
     tickets: string[];
+    /** CODEOWNERS entries for the code this scenario covers. Empty = unclaimed. */
+    owners: string[];
     errorMessage?: string;
     /** Passed in the baseline, failing now. Ranked first. */
     regressed: boolean;
@@ -2963,10 +3004,16 @@ interface TriageArgs {
     /** Baseline statuses by scenario id, to flag regressions and rank them first. */
     baseline?: Map<string, TestStatus>;
     format: "text" | "json";
+    /** Parsed CODEOWNERS. Without it every item is unowned. */
+    codeowners?: readonly CodeownersRule[];
 }
 type TriageDeps = Record<string, never>;
 declare function buildTriage(args: TriageArgs, _deps?: TriageDeps): TriageReport;
-declare function renderTriage(report: TriageReport, format: "text" | "json"): string;
+interface RenderTriageOptions {
+    /** Group the text worklist under each CODEOWNERS owner. */
+    byOwner?: boolean;
+}
+declare function renderTriage(report: TriageReport, format: "text" | "json", options?: RenderTriageOptions): string;
 
 /**
  * ReportGenerator — turns a canonical TestRunResult into report files.