executable-stories-formatters 0.8.0 → 0.10.0

package/dist/{index-BiAYcEiz.d.cts → index-CbWFyoTx.d.cts}

@@ -8,7 +8,7 @@
  */
 
 type CIProvider = "github" | "gitlab" | "circleci" | "jenkins" | "azure" | "buildkite" | "travis" | "unknown";
-interface CIInfo {
+interface CIInfo$1 {
     provider: CIProvider;
     displayName: string;
     url?: string;
@@ -18,9 +18,9 @@ interface CIInfo {
     prNumber?: string;
 }
 /** Convert RawCIInfo (legacy transport) to canonical CIInfo. */
-declare function toCIInfo(raw?: RawCIInfo): CIInfo | undefined;
+declare function toCIInfo(raw?: RawCIInfo): CIInfo$1 | undefined;
 /** Convert canonical CIInfo back to RawCIInfo (for serialization). */
-declare function toRawCIInfo(ci?: CIInfo): RawCIInfo | undefined;
+declare function toRawCIInfo(ci?: CIInfo$1): RawCIInfo | undefined;
 
 /**
  * OTel span types for trace waterfall rendering.
@@ -159,6 +159,8 @@ interface StoryMeta {
     tags?: string[];
     /** Ticket/issue references (normalized to array) */
     tickets?: NormalizedTicket[];
+    /** Product-code paths/globs this scenario exercises (project-root-relative). */
+    covers?: string[];
     /** User-defined metadata */
     meta?: Record<string, unknown>;
     /** Parent describe/suite names for hierarchical grouping */
@@ -234,6 +236,12 @@ interface RawTestCase {
     attachments?: RawAttachment[];
     /** Framework-specific metadata (kept for debugging) */
     meta?: Record<string, unknown>;
+    /**
+     * Evidence ingested from external tools (mutation/coverage/failing-first).
+     * Not produced by framework adapters — injected at ingestion time and passed
+     * through to the canonical {@link TestCaseResult.evidence}.
+     */
+    evidence?: TestCaseEvidence;
     /** Retry attempt number (0-based) */
     retry?: number;
     /** Total retry count configured */
@@ -273,6 +281,155 @@ interface RawRun {
     ci?: RawCIInfo;
 }
 
+/** Canonical test status (Cucumber-compatible) */
+type TestStatus = "passed" | "failed" | "skipped" | "pending";
+/** Step result with status and timing */
+interface StepResult {
+    /** Step index (0-based) */
+    index: number;
+    /** Stable step ID when available */
+    stepId?: string;
+    /** Step status */
+    status: TestStatus;
+    /** Duration in milliseconds (default 0) */
+    durationMs: number;
+    /** Error message if step failed */
+    errorMessage?: string;
+}
+/** Resolved attachment (always has body) */
+interface Attachment {
+    /** Attachment name */
+    name: string;
+    /** MIME type */
+    mediaType: string;
+    /** Content (base64-encoded or URL) */
+    body: string;
+    /** Content encoding */
+    contentEncoding: "BASE64" | "IDENTITY";
+}
+/** Single test attempt for retry tracking */
+interface TestCaseAttempt {
+    /** Attempt number (0-based) */
+    attempt: number;
+    /** Status of this attempt */
+    status: TestStatus;
+    /** Duration of this attempt in milliseconds */
+    durationMs: number;
+    /** Error message if this attempt failed */
+    errorMessage?: string;
+    /** Error stack trace if this attempt failed */
+    errorStack?: string;
+}
+/** Canonical test case result */
+interface TestCaseResult {
+    /** Unique deterministic ID */
+    id: string;
+    /** Story metadata (required) */
+    story: StoryMeta;
+    /** Source file path (required) */
+    sourceFile: string;
+    /** Source line number (required, default 1) */
+    sourceLine: number;
+    /** Test status (required) */
+    status: TestStatus;
+    /** Original adapter/framework status (preserved for diagnostics). */
+    rawStatus?: RawStatus;
+    /** Duration in milliseconds (required, default 0) */
+    durationMs: number;
+    /** Error message if failed */
+    errorMessage?: string;
+    /** Error stack trace if failed */
+    errorStack?: string;
+    /** Attachments (required, empty array if none) */
+    attachments: Attachment[];
+    /** Step results (required, always populated via fallback rules) */
+    stepResults: StepResult[];
+    /** Full title path from suite/describe blocks (required, empty array if none) */
+    titlePath: string[];
+    /** Playwright project name (optional) */
+    projectName?: string;
+    /** Retry attempt number (required, default 0) */
+    retry: number;
+    /** Total retries configured (required, default 0) */
+    retries: number;
+    /** Normalized tags from story (required, empty array if none) */
+    tags: string[];
+    /** All retry attempts (optional, includes details per attempt) */
+    attempts?: TestCaseAttempt[];
+    /**
+     * Ingested evidence (mutation/coverage/failing-first) used by the review
+     * formatter to grade proof strength. Populated at the ACL/ingestion layer,
+     * never by adapters. Optional and additive.
+     */
+    evidence?: TestCaseEvidence;
+}
+/**
+ * Evidence ingested from external tools to harden the "the test passes" claim.
+ *
+ * Populated at the ACL/ingestion layer from the host project's own tooling
+ * (Stryker/PITest mutation runs, coverage reports, base-ref re-verification).
+ * The packages never RUN these tools — same ingestion shape as {@link StoryMeta.otelSpans}.
+ * Consumed by the review formatter to grade how credible a claim's proof is.
+ */
+interface TestCaseEvidence {
+    /** Mutation score (0-100) attributed to this test/file, from Stryker/PITest/etc. */
+    mutationScorePct?: number;
+    /** Mutants killed by this test's covered code (when the tool reports it). */
+    mutantsKilled?: number;
+    /** Total mutants in this test's covered code (when the tool reports it). */
+    mutantsTotal?: number;
+    /**
+     * True when the test was verified red on the base ref and green on head
+     * (the failing-first regression lock for bugfixes).
+     */
+    failingFirstVerified?: boolean;
+    /** Coverage of the changed lines this test exercises (0-100), when computable. */
+    changedLineCoveragePct?: number;
+}
+/** CI environment info */
+interface CIInfo {
+    name: string;
+    url?: string;
+    buildNumber?: string;
+    branch?: string;
+    commitSha?: string;
+    prNumber?: string;
+}
+/** Coverage summary for the test run */
+interface CoverageSummary {
+    /** Line coverage percentage (0-100) */
+    linesPct?: number;
+    /** Branch coverage percentage (0-100) */
+    branchesPct?: number;
+    /** Function coverage percentage (0-100) */
+    functionsPct?: number;
+    /** Statement coverage percentage (0-100) */
+    statementsPct?: number;
+}
+/** Canonical test run result */
+interface TestRunResult {
+    /** All test case results */
+    testCases: TestCaseResult[];
+    /** Run start time (epoch ms, required) */
+    startedAtMs: number;
+    /** Run finish time (epoch ms, required) */
+    finishedAtMs: number;
+    /** Total duration in milliseconds (required) */
+    durationMs: number;
+    /** Project root directory (required) */
+    projectRoot: string;
+    /** Unique run ID (required, generated) */
+    runId: string;
+    /** Package version */
+    packageVersion?: string;
+    /** Git commit SHA */
+    gitSha?: string;
+    /** CI environment info */
+    ci?: CIInfo;
+    /** Coverage summary for the run */
+    coverage?: CoverageSummary;
+}
+
 /**
  * Jest Adapter - Layer 1.
  *
@@ -452,4 +609,4 @@ interface PlaywrightAdapterOptions {
  */
 declare function adaptPlaywrightRun(testResults: Array<[PlaywrightTestCase, PlaywrightTestResult]>, options?: PlaywrightAdapterOptions): RawRun;
 
-export { type VitestSerializedError as A, type VitestState as B, type CIInfo as C, type DocEntry as D, type VitestTestCase as E, type VitestTestModule as F, type VitestTestResult as G, toCIInfo as H, toRawCIInfo as I, type JestAdapterOptions as J, type NormalizedTicket as N, type OtelSpan as O, type PlaywrightAdapterOptions as P, type RawStatus as R, type StoryMeta as S, type VitestAdapterOptions as V, type StoryStep as a, type DocPhase as b, type CIProvider as c, type RawAttachment as d, type RawRun as e, type RawCIInfo as f, adaptJestRun as g, adaptPlaywrightRun as h, adaptVitestRun as i, type JestAggregatedResult as j, type JestFileResult as k, type JestTestResult as l, type OtelAttributeValue as m, type PlaywrightAnnotation as n, type PlaywrightAttachment as o, type PlaywrightError as p, type PlaywrightLocation as q, type PlaywrightStatus as r, type PlaywrightTestCase as s, type PlaywrightTestResult as t, type RawStepEvent as u, type RawTestCase as v, STORY_META_KEY as w, type StepKeyword as x, type StepMode as y, type StoryFileReport as z };
+export { type Attachment as A, STORY_META_KEY as B, type CIInfo$1 as C, type DocEntry as D, type StepKeyword as E, type StepMode as F, type StoryFileReport as G, type StoryMeta as H, type TestCaseAttempt as I, type JestAdapterOptions as J, type TestCaseEvidence as K, type VitestSerializedError as L, type VitestState as M, type NormalizedTicket as N, type OtelSpan as O, type PlaywrightAdapterOptions as P, type VitestTestCase as Q, type RawStatus as R, type StoryStep as S, type TestRunResult as T, type VitestTestModule as U, type VitestAdapterOptions as V, type VitestTestResult as W, toCIInfo as X, toRawCIInfo as Y, type TestCaseResult as a, type TestStatus as b, type DocPhase as c, type StepResult as d, type CIProvider as e, type RawAttachment as f, type RawRun as g, type RawCIInfo as h, adaptJestRun as i, adaptPlaywrightRun as j, adaptVitestRun as k, type CIInfo as l, type CoverageSummary as m, type JestAggregatedResult as n, type JestFileResult as o, type JestTestResult as p, type OtelAttributeValue as q, type PlaywrightAnnotation as r, type PlaywrightAttachment as s, type PlaywrightError as t, type PlaywrightLocation as u, type PlaywrightStatus as v, type PlaywrightTestCase as w, type PlaywrightTestResult as x, type RawStepEvent as y, type RawTestCase as z };

package/dist/{index-BiAYcEiz.d.ts → index-CbWFyoTx.d.ts}

@@ -8,7 +8,7 @@
  */
 
 type CIProvider = "github" | "gitlab" | "circleci" | "jenkins" | "azure" | "buildkite" | "travis" | "unknown";
-interface CIInfo {
+interface CIInfo$1 {
     provider: CIProvider;
     displayName: string;
     url?: string;
@@ -18,9 +18,9 @@ interface CIInfo {
     prNumber?: string;
 }
 /** Convert RawCIInfo (legacy transport) to canonical CIInfo. */
-declare function toCIInfo(raw?: RawCIInfo): CIInfo | undefined;
+declare function toCIInfo(raw?: RawCIInfo): CIInfo$1 | undefined;
 /** Convert canonical CIInfo back to RawCIInfo (for serialization). */
-declare function toRawCIInfo(ci?: CIInfo): RawCIInfo | undefined;
+declare function toRawCIInfo(ci?: CIInfo$1): RawCIInfo | undefined;
 
 /**
  * OTel span types for trace waterfall rendering.
@@ -159,6 +159,8 @@ interface StoryMeta {
     tags?: string[];
     /** Ticket/issue references (normalized to array) */
     tickets?: NormalizedTicket[];
+    /** Product-code paths/globs this scenario exercises (project-root-relative). */
+    covers?: string[];
     /** User-defined metadata */
     meta?: Record<string, unknown>;
     /** Parent describe/suite names for hierarchical grouping */
@@ -234,6 +236,12 @@ interface RawTestCase {
     attachments?: RawAttachment[];
     /** Framework-specific metadata (kept for debugging) */
     meta?: Record<string, unknown>;
+    /**
+     * Evidence ingested from external tools (mutation/coverage/failing-first).
+     * Not produced by framework adapters — injected at ingestion time and passed
+     * through to the canonical {@link TestCaseResult.evidence}.
+     */
+    evidence?: TestCaseEvidence;
     /** Retry attempt number (0-based) */
     retry?: number;
     /** Total retry count configured */
@@ -273,6 +281,155 @@ interface RawRun {
     ci?: RawCIInfo;
 }
 
+/** Canonical test status (Cucumber-compatible) */
+type TestStatus = "passed" | "failed" | "skipped" | "pending";
+/** Step result with status and timing */
+interface StepResult {
+    /** Step index (0-based) */
+    index: number;
+    /** Stable step ID when available */
+    stepId?: string;
+    /** Step status */
+    status: TestStatus;
+    /** Duration in milliseconds (default 0) */
+    durationMs: number;
+    /** Error message if step failed */
+    errorMessage?: string;
+}
+/** Resolved attachment (always has body) */
+interface Attachment {
+    /** Attachment name */
+    name: string;
+    /** MIME type */
+    mediaType: string;
+    /** Content (base64-encoded or URL) */
+    body: string;
+    /** Content encoding */
+    contentEncoding: "BASE64" | "IDENTITY";
+}
+/** Single test attempt for retry tracking */
+interface TestCaseAttempt {
+    /** Attempt number (0-based) */
+    attempt: number;
+    /** Status of this attempt */
+    status: TestStatus;
+    /** Duration of this attempt in milliseconds */
+    durationMs: number;
+    /** Error message if this attempt failed */
+    errorMessage?: string;
+    /** Error stack trace if this attempt failed */
+    errorStack?: string;
+}
+/** Canonical test case result */
+interface TestCaseResult {
+    /** Unique deterministic ID */
+    id: string;
+    /** Story metadata (required) */
+    story: StoryMeta;
+    /** Source file path (required) */
+    sourceFile: string;
+    /** Source line number (required, default 1) */
+    sourceLine: number;
+    /** Test status (required) */
+    status: TestStatus;
+    /** Original adapter/framework status (preserved for diagnostics). */
+    rawStatus?: RawStatus;
+    /** Duration in milliseconds (required, default 0) */
+    durationMs: number;
+    /** Error message if failed */
+    errorMessage?: string;
+    /** Error stack trace if failed */
+    errorStack?: string;
+    /** Attachments (required, empty array if none) */
+    attachments: Attachment[];
+    /** Step results (required, always populated via fallback rules) */
+    stepResults: StepResult[];
+    /** Full title path from suite/describe blocks (required, empty array if none) */
+    titlePath: string[];
+    /** Playwright project name (optional) */
+    projectName?: string;
+    /** Retry attempt number (required, default 0) */
+    retry: number;
+    /** Total retries configured (required, default 0) */
+    retries: number;
+    /** Normalized tags from story (required, empty array if none) */
+    tags: string[];
+    /** All retry attempts (optional, includes details per attempt) */
+    attempts?: TestCaseAttempt[];
+    /**
+     * Ingested evidence (mutation/coverage/failing-first) used by the review
+     * formatter to grade proof strength. Populated at the ACL/ingestion layer,
+     * never by adapters. Optional and additive.
+     */
+    evidence?: TestCaseEvidence;
+}
+/**
+ * Evidence ingested from external tools to harden the "the test passes" claim.
+ *
+ * Populated at the ACL/ingestion layer from the host project's own tooling
+ * (Stryker/PITest mutation runs, coverage reports, base-ref re-verification).
+ * The packages never RUN these tools — same ingestion shape as {@link StoryMeta.otelSpans}.
+ * Consumed by the review formatter to grade how credible a claim's proof is.
+ */
+interface TestCaseEvidence {
+    /** Mutation score (0-100) attributed to this test/file, from Stryker/PITest/etc. */
+    mutationScorePct?: number;
+    /** Mutants killed by this test's covered code (when the tool reports it). */
+    mutantsKilled?: number;
+    /** Total mutants in this test's covered code (when the tool reports it). */
+    mutantsTotal?: number;
+    /**
+     * True when the test was verified red on the base ref and green on head
+     * (the failing-first regression lock for bugfixes).
+     */
+    failingFirstVerified?: boolean;
+    /** Coverage of the changed lines this test exercises (0-100), when computable. */
+    changedLineCoveragePct?: number;
+}
+/** CI environment info */
+interface CIInfo {
+    name: string;
+    url?: string;
+    buildNumber?: string;
+    branch?: string;
+    commitSha?: string;
+    prNumber?: string;
+}
+/** Coverage summary for the test run */
+interface CoverageSummary {
+    /** Line coverage percentage (0-100) */
+    linesPct?: number;
+    /** Branch coverage percentage (0-100) */
+    branchesPct?: number;
+    /** Function coverage percentage (0-100) */
+    functionsPct?: number;
+    /** Statement coverage percentage (0-100) */
+    statementsPct?: number;
+}
+/** Canonical test run result */
+interface TestRunResult {
+    /** All test case results */
+    testCases: TestCaseResult[];
+    /** Run start time (epoch ms, required) */
+    startedAtMs: number;
+    /** Run finish time (epoch ms, required) */
+    finishedAtMs: number;
+    /** Total duration in milliseconds (required) */
+    durationMs: number;
+    /** Project root directory (required) */
+    projectRoot: string;
+    /** Unique run ID (required, generated) */
+    runId: string;
+    /** Package version */
+    packageVersion?: string;
+    /** Git commit SHA */
+    gitSha?: string;
+    /** CI environment info */
+    ci?: CIInfo;
+    /** Coverage summary for the run */
+    coverage?: CoverageSummary;
+}
+
 /**
  * Jest Adapter - Layer 1.
  *
@@ -452,4 +609,4 @@ interface PlaywrightAdapterOptions {
  */
 declare function adaptPlaywrightRun(testResults: Array<[PlaywrightTestCase, PlaywrightTestResult]>, options?: PlaywrightAdapterOptions): RawRun;
 
-export { type VitestSerializedError as A, type VitestState as B, type CIInfo as C, type DocEntry as D, type VitestTestCase as E, type VitestTestModule as F, type VitestTestResult as G, toCIInfo as H, toRawCIInfo as I, type JestAdapterOptions as J, type NormalizedTicket as N, type OtelSpan as O, type PlaywrightAdapterOptions as P, type RawStatus as R, type StoryMeta as S, type VitestAdapterOptions as V, type StoryStep as a, type DocPhase as b, type CIProvider as c, type RawAttachment as d, type RawRun as e, type RawCIInfo as f, adaptJestRun as g, adaptPlaywrightRun as h, adaptVitestRun as i, type JestAggregatedResult as j, type JestFileResult as k, type JestTestResult as l, type OtelAttributeValue as m, type PlaywrightAnnotation as n, type PlaywrightAttachment as o, type PlaywrightError as p, type PlaywrightLocation as q, type PlaywrightStatus as r, type PlaywrightTestCase as s, type PlaywrightTestResult as t, type RawStepEvent as u, type RawTestCase as v, STORY_META_KEY as w, type StepKeyword as x, type StepMode as y, type StoryFileReport as z };
+export { type Attachment as A, STORY_META_KEY as B, type CIInfo$1 as C, type DocEntry as D, type StepKeyword as E, type StepMode as F, type StoryFileReport as G, type StoryMeta as H, type TestCaseAttempt as I, type JestAdapterOptions as J, type TestCaseEvidence as K, type VitestSerializedError as L, type VitestState as M, type NormalizedTicket as N, type OtelSpan as O, type PlaywrightAdapterOptions as P, type VitestTestCase as Q, type RawStatus as R, type StoryStep as S, type TestRunResult as T, type VitestTestModule as U, type VitestAdapterOptions as V, type VitestTestResult as W, toCIInfo as X, toRawCIInfo as Y, type TestCaseResult as a, type TestStatus as b, type DocPhase as c, type StepResult as d, type CIProvider as e, type RawAttachment as f, type RawRun as g, type RawCIInfo as h, adaptJestRun as i, adaptPlaywrightRun as j, adaptVitestRun as k, type CIInfo as l, type CoverageSummary as m, type JestAggregatedResult as n, type JestFileResult as o, type JestTestResult as p, type OtelAttributeValue as q, type PlaywrightAnnotation as r, type PlaywrightAttachment as s, type PlaywrightError as t, type PlaywrightLocation as u, type PlaywrightStatus as v, type PlaywrightTestCase as w, type PlaywrightTestResult as x, type RawStepEvent as y, type RawTestCase as z };