@quenty/nevermore-cli 4.43.4 → 4.44.0

package/dist/utils/testing/parsers/batch-log-parser.d.ts

@@ -1,4 +1,6 @@
 import { type ParsedTestCounts } from '../test-log-parser.js';
+import { type StructuredTestResults } from '../structured-test-results.js';
+import { type LogFetchStats } from '../log-fetch-stats.js';
 export interface BatchPackageResult {
     slug: string;
     success: boolean;
@@ -14,13 +16,124 @@ export interface BatchPackageResult {
      * test — often after the test that scheduled it already passed.
      */
     tracebackCount: number;
+    /**
+     * Where `testCounts` came from. `returned` means the run handed them over as a
+     * value; `scraped` means they were read out of log text, which is the channel
+     * truncation destroys. Absent when there are no counts at all.
+     *
+     * Recorded because the two are otherwise indistinguishable in the output, and
+     * a structured channel that quietly stopped flowing looks exactly like one
+     * that never existed.
+     */
+    countsSource?: 'returned' | 'scraped';
+    /**
+     * True when this package's counts arrived but its log section did not.
+     *
+     * A narrower verdict than a package with a section gets: the counts say what
+     * happened, but with no text there is nothing to check for tracebacks, and
+     * nothing to read when something did go wrong. Reported so a pass that came
+     * back half-blind cannot be mistaken for an ordinary one.
+     */
+    logsLost?: boolean;
+    /**
+     * What this package's own run returned, recovered from the batch summary.
+     *
+     * One execution covers every package, so its return value belongs to none of
+     * them — the batch runner splits the per-package results into the summary
+     * instead, and this puts them back in the shape a single run's results have.
+     * Lossy by design: the summary carries counts, not failure text, which is
+     * per-package and already in that package's log section.
+     */
+    testResults?: StructuredTestResults;
+}
+export interface ParseBatchTestLogsOptions {
+    /**
+     * What the fetch that produced `rawLogs` had to do to collect them, when the
+     * caller knows. Not used to judge a package — it only tells a failure that
+     * has already happened how much of the run's output ever arrived.
+     */
+    logFetchStats?: LogFetchStats;
+    /**
+     * Where diagnostics go. When set, the parser reports through this instead of
+     * printing, so a caller that renders the run's output can hold them until
+     * after it: a remark about a log window reads as nonsense above the log it
+     * is describing.
+     */
+    onDiagnostic?: (level: BatchDiagnosticLevel, message: string) => void;
+    /**
+     * What the batch script returned, when the transport carries return values.
+     *
+     * The same summary the script also prints, taken from the one channel the
+     * engine's log buffer cannot truncate — an oversize return value fails the
+     * task outright rather than arriving short, so a summary that arrives here is
+     * whole. Preferred over the printed copy, which is only reached when this is
+     * absent (a local bridge run, or a task that ended without an output).
+     */
+    returnValues?: unknown[];
+}
+/**
+ * `group` and `endgroup` bracket a run of diagnostics that belong together, so
+ * a finding repeated across many packages can be collapsed into one block
+ * instead of one line each.
+ */
+export type BatchDiagnosticLevel = 'info' | 'warn' | 'verbose' | 'group' | 'endgroup';
+/**
+ * Print one diagnostic, honoring the grouping levels.
+ *
+ * `useGroups` is passed in rather than looked up, so the whole run agrees about
+ * whether it is emitting workflow commands. Asking `isCI()` separately here, in
+ * the renderer and in the reporter is three answers to one question.
+ */
+export declare function emitDiagnostic(level: BatchDiagnosticLevel, message: string, useGroups: boolean): void;
+/**
+ * Counts the batch runner folds in from what a package's test script returned.
+ *
+ * Present only for a package whose script returns its results. Carried in the
+ * summary rather than left to the logs because the summary prints last and
+ * survives a truncated log window, which is where scraped counts are lost.
+ */
+interface SummaryCounts {
+    passed: number;
+    failed: number;
+    skipped: number;
+    total: number;
+    suitesPassed: number;
+    suitesFailed: number;
+    suitesTotal: number;
 }
 interface SummaryEntry {
     slug: string;
     success: boolean;
     durationMs?: number;
     error?: string;
+    counts?: SummaryCounts;
+    /** False for a smoke test, so zero counts are not read as "no tests found". */
+    ranJest?: boolean;
+}
+interface BeginToken {
+    kind: 'begin';
+    slug: string;
+}
+interface EndToken {
+    kind: 'end';
+    slug: string;
+    durationMs?: number;
 }
+interface SummaryToken {
+    kind: 'summary';
+    /** Where the marker sat, so the JSON payload can be looked up around it. */
+    lineIndex: number;
+}
+interface SummaryPayloadToken {
+    kind: 'summaryPayload';
+}
+interface ContentToken {
+    kind: 'content';
+    /** The untrimmed line, since section logs are shown to a human verbatim. */
+    line: string;
+}
+/** One log line, classified. Every line becomes exactly one token. */
+export type BatchLogToken = BeginToken | EndToken | SummaryToken | SummaryPayloadToken | ContentToken;
 /**
  * Parse the single batch execution's logs into per-package results.
  *
@@ -35,7 +148,19 @@ interface SummaryEntry {
  * immune to log reordering. The BEGIN/END markers are used only for splitting logs
  * into per-package sections. Jest failure detection provides a secondary override.
  */
-export declare function parseBatchTestLogs(rawLogs: string, slugMap: Map<string, string>): Map<string, BatchPackageResult>;
+export declare function parseBatchTestLogs(rawLogs: string, slugMap: Map<string, string>, options?: ParseBatchTestLogsOptions): Map<string, BatchPackageResult>;
+/**
+ * Classify every log line, so section splitting reads tokens instead of text.
+ */
+export declare function tokenizeBatchLog(lines: string[]): BatchLogToken[];
+/**
+ * Find the summary array among a task's return values.
+ *
+ * The batch script returns the same array it prints. Recognized by shape rather
+ * than by position: a run is free to return other things, and an array of
+ * objects that all carry a string `slug` is the summary and nothing else.
+ */
+export declare function findReturnedSummaryEntries(returnValues: unknown[] | undefined): SummaryEntry[] | undefined;
 /**
  * Find the summary array in the lines following the summary marker.
  *

package/dist/utils/testing/parsers/batch-log-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batch-log-parser.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/batch-log-parser.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAgRjC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,GACjB,YAAY,EAAE,GAAG,SAAS,CA4B5B;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"batch-log-parser.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/batch-log-parser.ts"],"names":[],"mappings":"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"}