common-qa-mcp 0.12.0 → 0.13.0

package/dist/adapters/simplifyqa/executionFailures.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Whole-execution failure analysis for SimplifyQA (`failure_analysis`). Reads exactly ONE
+ * execution — the named one, or the latest standalone (TC) / parent (SU, PL) execution of a code —
+ * analyses every FAILED run (= iteration), groups iterations by cause, and builds the FLOW for each
+ * cause's representative. The pure rules live in stepRules.ts / flow.ts / failureCategory.ts; this
+ * module is the I/O around them. It does not assert a root cause.
+ */
+import type { QaHttp } from '../http.js';
+import type { ExecutionFailureContext, ExecutionFailureInput } from './failureTypes.js';
+/** Log lines kept per failed step by default — the tail nearest the failure (ai-assistant FAILURE_LOG_TAIL). */
+export declare const FAILURE_LOG_TAIL = 30;
+/** What the analysis needs from the adapter. */
+export type ExecutionFailureDeps = {
+    http: QaHttp;
+    projectId: number;
+    /** SQA base URL, no trailing slash. */
+    baseUrl: string;
+    fetchExecDoc: (executionId: number, projectId: number) => Promise<any>;
+    /** The latest standalone (TC) / parent (SUITE, EXECUTIONPLAN) execution id of an entity. */
+    latestExecutionOf: (kind: 'TC' | 'SUITE' | 'EXECUTIONPLAN', id: string) => Promise<string | null>;
+};
+/**
+ * A failure screenshot as base64, for returning inline. Only artifacts on the connected SQA host
+ * are fetched (with the SQA bearer token); anything else, anything over `maxBytes`, or anything
+ * that is not a PNG/JPEG/GIF/WEBP returns null so the caller falls back to the link.
+ */
+export declare function fetchFailureImage(http: QaHttp, baseUrl: string, absoluteUrl: string, maxBytes: number): Promise<{
+    data: string;
+    mimeType: string;
+} | null>;
+export declare class ExecutionFailureAnalysis {
+    private readonly deps;
+    constructor(deps: ExecutionFailureDeps);
+    /** Its runs are the parent's current copies (a child execution's runs are history), one per run
+     *  key; every FAILED run (= iteration) gets its steps read and a failure focus; iterations are
+     *  then grouped by cause, and only each group's representative keeps full logs. */
+    analyse(input: ExecutionFailureInput): Promise<ExecutionFailureContext>;
+    /**
+     * One run's whole-test-case context (flow.ts): its FLOW around the failure, the written steps it
+     * never reached, how this function call compares with the run's other calls of it, and how the
+     * same test case's other iterations did at this step — failed ones from the analysis, and ONE
+     * passed iteration read for comparison (its status and data at the same written step).
+     */
+    private runFlow;
+    /** Test case names and version names for the failure table — one search each, best-effort (a
+     *  failed lookup leaves the column empty, never the analysis). */
+    private nameEntries;
+    /** One failed run → its failure focus. A run whose steps cannot be read is still returned (with
+     *  `readError`) so it is counted and grouped by its run-level exception, never dropped. */
+    private analyseFailedIteration;
+    /** Execution doc by numeric id, or by its EX code. */
+    private fetchExecDocByRef;
+    /** Every step-result row of one run, in report order — control-flow and marker rows included
+     *  (the FLOW needs them; failure detection uses `keepStepRows`). */
+    private fetchStepRows;
+    /** The test case's written steps for one version (what it was going to do), or [] when unreadable. */
+    private fetchWrittenSteps;
+}
+//# sourceMappingURL=executionFailures.d.ts.map

package/dist/adapters/simplifyqa/executionFailures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionFailures.d.ts","sourceRoot":"","sources":["../../../src/adapters/simplifyqa/executionFailures.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AASzC,OAAO,KAAK,EACV,uBAAuB,EAAE,qBAAqB,EAE/C,MAAM,mBAAmB,CAAC;AAE3B,gHAAgH;AAChH,eAAO,MAAM,gBAAgB,KAAK,CAAC;AA6LnC,gDAAgD;AAChD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACvE,4FAA4F;IAC5F,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,eAAe,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACnG,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAUpD;AAED,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,oBAAoB;IAEvD;;uFAEmF;IAC7E,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAkN7E;;;;;OAKG;YACW,OAAO;IA6DrB;sEACkE;YACpD,WAAW;IA0BzB;+FAC2F;YAC7E,sBAAsB;IAkDpC,sDAAsD;YACxC,iBAAiB;IAe/B;wEACoE;YACtD,aAAa;IAO3B,sGAAsG;YACxF,iBAAiB;CAUhC"}