playwright-logbook 0.2.0

package/dist/schema.d.ts

@@ -0,0 +1,581 @@
+import { z } from 'zod';
+export declare const SCHEMA_VERSION: 1;
+export declare const statusSchema: z.ZodEnum<{
+    passed: "passed";
+    failed: "failed";
+    timedOut: "timedOut";
+    skipped: "skipped";
+    interrupted: "interrupted";
+}>;
+export declare const outcomeSchema: z.ZodEnum<{
+    skipped: "skipped";
+    expected: "expected";
+    unexpected: "unexpected";
+    flaky: "flaky";
+}>;
+export declare const runStatusSchema: z.ZodEnum<{
+    passed: "passed";
+    failed: "failed";
+    interrupted: "interrupted";
+    timedout: "timedout";
+}>;
+export declare const errorRecordSchema: z.ZodObject<{
+    message: z.ZodString;
+    stack: z.ZodNullable<z.ZodString>;
+    snippet: z.ZodNullable<z.ZodString>;
+    location: z.ZodNullable<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const stepRecordSchema: z.ZodObject<{
+    title: z.ZodString;
+    category: z.ZodString;
+    durationMs: z.ZodNumber;
+    depth: z.ZodNumber;
+    failed: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const attachmentRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    contentType: z.ZodString;
+    path: z.ZodNullable<z.ZodString>;
+    inline: z.ZodBoolean;
+    sizeBytes: z.ZodNullable<z.ZodNumber>;
+    dataUri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const attemptRecordSchema: z.ZodObject<{
+    retry: z.ZodNumber;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        timedOut: "timedOut";
+        skipped: "skipped";
+        interrupted: "interrupted";
+    }>;
+    durationMs: z.ZodNumber;
+    startedAt: z.ZodString;
+    workerIndex: z.ZodNumber;
+    errors: z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        stack: z.ZodNullable<z.ZodString>;
+        snippet: z.ZodNullable<z.ZodString>;
+        location: z.ZodNullable<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    attachments: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        contentType: z.ZodString;
+        path: z.ZodNullable<z.ZodString>;
+        inline: z.ZodBoolean;
+        sizeBytes: z.ZodNullable<z.ZodNumber>;
+        dataUri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        category: z.ZodString;
+        durationMs: z.ZodNumber;
+        depth: z.ZodNumber;
+        failed: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    stdout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stderr: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const annotationSchema: z.ZodObject<{
+    type: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const testRecordSchema: z.ZodObject<{
+    testId: z.ZodString;
+    title: z.ZodString;
+    titlePath: z.ZodArray<z.ZodString>;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    project: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    annotations: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    caseIds: z.ZodArray<z.ZodString>;
+    expectedStatus: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        timedOut: "timedOut";
+        skipped: "skipped";
+        interrupted: "interrupted";
+    }>;
+    outcome: z.ZodEnum<{
+        skipped: "skipped";
+        expected: "expected";
+        unexpected: "unexpected";
+        flaky: "flaky";
+    }>;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        timedOut: "timedOut";
+        skipped: "skipped";
+        interrupted: "interrupted";
+    }>;
+    durationMs: z.ZodNumber;
+    finalDurationMs: z.ZodNumber;
+    attemptCount: z.ZodNumber;
+    repeatEachIndex: z.ZodNumber;
+    firstError: z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        stack: z.ZodNullable<z.ZodString>;
+        snippet: z.ZodNullable<z.ZodString>;
+        location: z.ZodNullable<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    attempts: z.ZodArray<z.ZodObject<{
+        retry: z.ZodNumber;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            timedOut: "timedOut";
+            skipped: "skipped";
+            interrupted: "interrupted";
+        }>;
+        durationMs: z.ZodNumber;
+        startedAt: z.ZodString;
+        workerIndex: z.ZodNumber;
+        errors: z.ZodArray<z.ZodObject<{
+            message: z.ZodString;
+            stack: z.ZodNullable<z.ZodString>;
+            snippet: z.ZodNullable<z.ZodString>;
+            location: z.ZodNullable<z.ZodObject<{
+                file: z.ZodString;
+                line: z.ZodNumber;
+                column: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        attachments: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            contentType: z.ZodString;
+            path: z.ZodNullable<z.ZodString>;
+            inline: z.ZodBoolean;
+            sizeBytes: z.ZodNullable<z.ZodNumber>;
+            dataUri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            category: z.ZodString;
+            durationMs: z.ZodNumber;
+            depth: z.ZodNumber;
+            failed: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        stdout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        stderr: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const envInfoSchema: z.ZodObject<{
+    ci: z.ZodNullable<z.ZodObject<{
+        provider: z.ZodEnum<{
+            github: "github";
+            gitlab: "gitlab";
+            azure: "azure";
+            jenkins: "jenkins";
+            circleci: "circleci";
+            bitbucket: "bitbucket";
+            other: "other";
+        }>;
+        buildId: z.ZodNullable<z.ZodString>;
+        buildUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    git: z.ZodObject<{
+        commit: z.ZodNullable<z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        prNumber: z.ZodNullable<z.ZodNumber>;
+        repository: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    machine: z.ZodObject<{
+        os: z.ZodString;
+        arch: z.ZodString;
+        node: z.ZodString;
+        cpus: z.ZodNumber;
+    }, z.core.$strip>;
+    playwrightVersion: z.ZodString;
+    workers: z.ZodNumber;
+}, z.core.$strip>;
+export declare const projectInfoSchema: z.ZodObject<{
+    name: z.ZodNullable<z.ZodString>;
+    configFile: z.ZodNullable<z.ZodString>;
+    projects: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        testDir: z.ZodString;
+    }, z.core.$strip>>;
+    workers: z.ZodNumber;
+}, z.core.$strip>;
+export declare const summarySchema: z.ZodObject<{
+    total: z.ZodNumber;
+    passed: z.ZodNumber;
+    failed: z.ZodNumber;
+    flaky: z.ZodNumber;
+    skipped: z.ZodNumber;
+}, z.core.$strip>;
+export declare const shardFileSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"shard">;
+    runId: z.ZodString;
+    title: z.ZodNullable<z.ZodString>;
+    shard: z.ZodNullable<z.ZodObject<{
+        current: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodString;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        interrupted: "interrupted";
+        timedout: "timedout";
+    }>;
+    env: z.ZodObject<{
+        ci: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodEnum<{
+                github: "github";
+                gitlab: "gitlab";
+                azure: "azure";
+                jenkins: "jenkins";
+                circleci: "circleci";
+                bitbucket: "bitbucket";
+                other: "other";
+            }>;
+            buildId: z.ZodNullable<z.ZodString>;
+            buildUrl: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        git: z.ZodObject<{
+            commit: z.ZodNullable<z.ZodString>;
+            branch: z.ZodNullable<z.ZodString>;
+            prNumber: z.ZodNullable<z.ZodNumber>;
+            repository: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        machine: z.ZodObject<{
+            os: z.ZodString;
+            arch: z.ZodString;
+            node: z.ZodString;
+            cpus: z.ZodNumber;
+        }, z.core.$strip>;
+        playwrightVersion: z.ZodString;
+        workers: z.ZodNumber;
+    }, z.core.$strip>;
+    project: z.ZodObject<{
+        name: z.ZodNullable<z.ZodString>;
+        configFile: z.ZodNullable<z.ZodString>;
+        projects: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            testDir: z.ZodString;
+        }, z.core.$strip>>;
+        workers: z.ZodNumber;
+    }, z.core.$strip>;
+    tests: z.ZodArray<z.ZodObject<{
+        testId: z.ZodString;
+        title: z.ZodString;
+        titlePath: z.ZodArray<z.ZodString>;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        project: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        annotations: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        caseIds: z.ZodArray<z.ZodString>;
+        expectedStatus: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            timedOut: "timedOut";
+            skipped: "skipped";
+            interrupted: "interrupted";
+        }>;
+        outcome: z.ZodEnum<{
+            skipped: "skipped";
+            expected: "expected";
+            unexpected: "unexpected";
+            flaky: "flaky";
+        }>;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            timedOut: "timedOut";
+            skipped: "skipped";
+            interrupted: "interrupted";
+        }>;
+        durationMs: z.ZodNumber;
+        finalDurationMs: z.ZodNumber;
+        attemptCount: z.ZodNumber;
+        repeatEachIndex: z.ZodNumber;
+        firstError: z.ZodNullable<z.ZodObject<{
+            message: z.ZodString;
+            stack: z.ZodNullable<z.ZodString>;
+            snippet: z.ZodNullable<z.ZodString>;
+            location: z.ZodNullable<z.ZodObject<{
+                file: z.ZodString;
+                line: z.ZodNumber;
+                column: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        attempts: z.ZodArray<z.ZodObject<{
+            retry: z.ZodNumber;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                timedOut: "timedOut";
+                skipped: "skipped";
+                interrupted: "interrupted";
+            }>;
+            durationMs: z.ZodNumber;
+            startedAt: z.ZodString;
+            workerIndex: z.ZodNumber;
+            errors: z.ZodArray<z.ZodObject<{
+                message: z.ZodString;
+                stack: z.ZodNullable<z.ZodString>;
+                snippet: z.ZodNullable<z.ZodString>;
+                location: z.ZodNullable<z.ZodObject<{
+                    file: z.ZodString;
+                    line: z.ZodNumber;
+                    column: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            attachments: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                contentType: z.ZodString;
+                path: z.ZodNullable<z.ZodString>;
+                inline: z.ZodBoolean;
+                sizeBytes: z.ZodNullable<z.ZodNumber>;
+                dataUri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                category: z.ZodString;
+                durationMs: z.ZodNumber;
+                depth: z.ZodNumber;
+                failed: z.ZodBoolean;
+            }, z.core.$strip>>>;
+            stdout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            stderr: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    globalErrors: z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        stack: z.ZodNullable<z.ZodString>;
+        snippet: z.ZodNullable<z.ZodString>;
+        location: z.ZodNullable<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const runRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"run">;
+    runId: z.ZodString;
+    title: z.ZodNullable<z.ZodString>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodString;
+    durationMs: z.ZodNumber;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        interrupted: "interrupted";
+        timedout: "timedout";
+    }>;
+    complete: z.ZodBoolean;
+    expectedShards: z.ZodNullable<z.ZodNumber>;
+    receivedShards: z.ZodArray<z.ZodNumber>;
+    env: z.ZodObject<{
+        ci: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodEnum<{
+                github: "github";
+                gitlab: "gitlab";
+                azure: "azure";
+                jenkins: "jenkins";
+                circleci: "circleci";
+                bitbucket: "bitbucket";
+                other: "other";
+            }>;
+            buildId: z.ZodNullable<z.ZodString>;
+            buildUrl: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        git: z.ZodObject<{
+            commit: z.ZodNullable<z.ZodString>;
+            branch: z.ZodNullable<z.ZodString>;
+            prNumber: z.ZodNullable<z.ZodNumber>;
+            repository: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        machine: z.ZodObject<{
+            os: z.ZodString;
+            arch: z.ZodString;
+            node: z.ZodString;
+            cpus: z.ZodNumber;
+        }, z.core.$strip>;
+        playwrightVersion: z.ZodString;
+        workers: z.ZodNumber;
+    }, z.core.$strip>;
+    project: z.ZodObject<{
+        name: z.ZodNullable<z.ZodString>;
+        configFile: z.ZodNullable<z.ZodString>;
+        projects: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            testDir: z.ZodString;
+        }, z.core.$strip>>;
+        workers: z.ZodNumber;
+    }, z.core.$strip>;
+    paths: z.ZodObject<{
+        outputDir: z.ZodString;
+    }, z.core.$strip>;
+    summary: z.ZodObject<{
+        total: z.ZodNumber;
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        flaky: z.ZodNumber;
+        skipped: z.ZodNumber;
+    }, z.core.$strip>;
+    tests: z.ZodArray<z.ZodObject<{
+        testId: z.ZodString;
+        title: z.ZodString;
+        titlePath: z.ZodArray<z.ZodString>;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        project: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        annotations: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        caseIds: z.ZodArray<z.ZodString>;
+        expectedStatus: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            timedOut: "timedOut";
+            skipped: "skipped";
+            interrupted: "interrupted";
+        }>;
+        outcome: z.ZodEnum<{
+            skipped: "skipped";
+            expected: "expected";
+            unexpected: "unexpected";
+            flaky: "flaky";
+        }>;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            timedOut: "timedOut";
+            skipped: "skipped";
+            interrupted: "interrupted";
+        }>;
+        durationMs: z.ZodNumber;
+        finalDurationMs: z.ZodNumber;
+        attemptCount: z.ZodNumber;
+        repeatEachIndex: z.ZodNumber;
+        firstError: z.ZodNullable<z.ZodObject<{
+            message: z.ZodString;
+            stack: z.ZodNullable<z.ZodString>;
+            snippet: z.ZodNullable<z.ZodString>;
+            location: z.ZodNullable<z.ZodObject<{
+                file: z.ZodString;
+                line: z.ZodNumber;
+                column: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        attempts: z.ZodArray<z.ZodObject<{
+            retry: z.ZodNumber;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                timedOut: "timedOut";
+                skipped: "skipped";
+                interrupted: "interrupted";
+            }>;
+            durationMs: z.ZodNumber;
+            startedAt: z.ZodString;
+            workerIndex: z.ZodNumber;
+            errors: z.ZodArray<z.ZodObject<{
+                message: z.ZodString;
+                stack: z.ZodNullable<z.ZodString>;
+                snippet: z.ZodNullable<z.ZodString>;
+                location: z.ZodNullable<z.ZodObject<{
+                    file: z.ZodString;
+                    line: z.ZodNumber;
+                    column: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            attachments: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                contentType: z.ZodString;
+                path: z.ZodNullable<z.ZodString>;
+                inline: z.ZodBoolean;
+                sizeBytes: z.ZodNullable<z.ZodNumber>;
+                dataUri: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                category: z.ZodString;
+                durationMs: z.ZodNumber;
+                depth: z.ZodNumber;
+                failed: z.ZodBoolean;
+            }, z.core.$strip>>>;
+            stdout: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            stderr: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    globalErrors: z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        stack: z.ZodNullable<z.ZodString>;
+        snippet: z.ZodNullable<z.ZodString>;
+        location: z.ZodNullable<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const runSummaryRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    title: z.ZodNullable<z.ZodString>;
+    startedAt: z.ZodString;
+    durationMs: z.ZodNumber;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        interrupted: "interrupted";
+        timedout: "timedout";
+    }>;
+    complete: z.ZodBoolean;
+    summary: z.ZodObject<{
+        total: z.ZodNumber;
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        flaky: z.ZodNumber;
+        skipped: z.ZodNumber;
+    }, z.core.$strip>;
+    branch: z.ZodNullable<z.ZodString>;
+    commit: z.ZodNullable<z.ZodString>;
+    ciProvider: z.ZodNullable<z.ZodString>;
+    buildUrl: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ErrorRecord = z.infer<typeof errorRecordSchema>;
+export type StepRecord = z.infer<typeof stepRecordSchema>;
+export type TestRecord = z.infer<typeof testRecordSchema>;
+export type ShardFile = z.infer<typeof shardFileSchema>;
+export type RunRecord = z.infer<typeof runRecordSchema>;
+export type RunSummaryRecord = z.infer<typeof runSummaryRecordSchema>;
+/** Validate a shard and report its file path in the error. */
+export declare function readShard(value: unknown, filePath?: string): ShardFile;
+/** Validate a run record and report its file path in the error. */
+export declare function readRun(value: unknown, filePath?: string): RunRecord;
+export declare const parseShard: typeof readShard;
+export declare const parseRun: typeof readRun;

package/dist/schema.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { LogbookError } from './errors.js';
+export const SCHEMA_VERSION = 1;
+export const statusSchema = z.enum(['passed', 'failed', 'timedOut', 'skipped', 'interrupted']);
+export const outcomeSchema = z.enum(['expected', 'unexpected', 'flaky', 'skipped']);
+export const runStatusSchema = z.enum(['passed', 'failed', 'timedout', 'interrupted']);
+export const errorRecordSchema = z.object({ message: z.string(), stack: z.string().nullable(), snippet: z.string().nullable(), location: z.object({ file: z.string(), line: z.number(), column: z.number() }).nullable() });
+export const stepRecordSchema = z.object({ title: z.string(), category: z.string(), durationMs: z.number(), depth: z.number().int().min(0).max(2), failed: z.boolean() });
+export const attachmentRecordSchema = z.object({ name: z.string(), contentType: z.string(), path: z.string().nullable(), inline: z.boolean(), sizeBytes: z.number().nullable(), dataUri: z.string().nullable().optional() });
+export const attemptRecordSchema = z.object({ retry: z.number(), status: statusSchema, durationMs: z.number(), startedAt: z.string(), workerIndex: z.number(), errors: z.array(errorRecordSchema), attachments: z.array(attachmentRecordSchema), steps: z.array(stepRecordSchema).optional(), stdout: z.string().nullable().optional(), stderr: z.string().nullable().optional() });
+export const annotationSchema = z.object({ type: z.string(), description: z.string().nullable() });
+export const testRecordSchema = z.object({ testId: z.string(), title: z.string(), titlePath: z.array(z.string()), file: z.string(), line: z.number(), column: z.number(), project: z.string(), tags: z.array(z.string()), annotations: z.array(annotationSchema), caseIds: z.array(z.string()), expectedStatus: statusSchema, outcome: outcomeSchema, status: statusSchema, durationMs: z.number(), finalDurationMs: z.number(), attemptCount: z.number(), repeatEachIndex: z.number(), firstError: errorRecordSchema.nullable(), attempts: z.array(attemptRecordSchema) });
+export const envInfoSchema = z.object({ ci: z.object({ provider: z.enum(['github', 'gitlab', 'azure', 'jenkins', 'circleci', 'bitbucket', 'other']), buildId: z.string().nullable(), buildUrl: z.string().nullable() }).nullable(), git: z.object({ commit: z.string().nullable(), branch: z.string().nullable(), prNumber: z.number().nullable(), repository: z.string().nullable() }), machine: z.object({ os: z.string(), arch: z.string(), node: z.string(), cpus: z.number() }), playwrightVersion: z.string(), workers: z.number() });
+export const projectInfoSchema = z.object({ name: z.string().nullable(), configFile: z.string().nullable(), projects: z.array(z.object({ name: z.string(), testDir: z.string() })), workers: z.number() });
+export const summarySchema = z.object({ total: z.number(), passed: z.number(), failed: z.number(), flaky: z.number(), skipped: z.number() });
+export const shardFileSchema = z.object({ schemaVersion: z.literal(SCHEMA_VERSION), kind: z.literal('shard'), runId: z.string(), title: z.string().nullable(), shard: z.object({ current: z.number(), total: z.number() }).nullable(), startedAt: z.string(), endedAt: z.string(), status: runStatusSchema, env: envInfoSchema, project: projectInfoSchema, tests: z.array(testRecordSchema), globalErrors: z.array(errorRecordSchema) });
+export const runRecordSchema = z.object({ schemaVersion: z.literal(SCHEMA_VERSION), kind: z.literal('run'), runId: z.string(), title: z.string().nullable(), startedAt: z.string(), endedAt: z.string(), durationMs: z.number(), status: runStatusSchema, complete: z.boolean(), expectedShards: z.number().nullable(), receivedShards: z.array(z.number()), env: envInfoSchema, project: projectInfoSchema, paths: z.object({ outputDir: z.string() }), summary: summarySchema, tests: z.array(testRecordSchema), globalErrors: z.array(errorRecordSchema) });
+export const runSummaryRecordSchema = z.object({ schemaVersion: z.literal(SCHEMA_VERSION), runId: z.string(), title: z.string().nullable(), startedAt: z.string(), durationMs: z.number(), status: runStatusSchema, complete: z.boolean(), summary: summarySchema, branch: z.string().nullable(), commit: z.string().nullable(), ciProvider: z.string().nullable(), buildUrl: z.string().nullable() });
+function validate(schema, value, filePath, kind) {
+    const parsed = schema.safeParse(value);
+    if (!parsed.success)
+        throw new LogbookError('INVALID_DATA', `${filePath}: invalid ${kind} data`);
+    return parsed.data;
+}
+/** Validate a shard and report its file path in the error. */
+export function readShard(value, filePath = '<input>') { return validate(shardFileSchema, value, filePath, 'shard'); }
+/** Validate a run record and report its file path in the error. */
+export function readRun(value, filePath = '<input>') { return validate(runRecordSchema, value, filePath, 'run'); }
+export const parseShard = readShard;
+export const parseRun = readRun;
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;AAC/F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AACvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC5N,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1K,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC7N,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACpX,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACnG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,iBAAiB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAC5iB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5gB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3M,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC7I,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAC1a,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAC/hB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AASvY,SAAS,QAAQ,CAAI,MAAoB,EAAE,KAAc,EAAE,QAAgB,EAAE,IAAY;IACvF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,cAAc,EAAE,GAAG,QAAQ,aAAa,IAAI,OAAO,CAAC,CAAC;IACjG,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,QAAQ,GAAG,SAAS,IAAe,OAAO,QAAQ,CAAC,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1I,mEAAmE;AACnE,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,QAAQ,GAAG,SAAS,IAAe,OAAO,QAAQ,CAAC,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AACtI,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC"}

package/dist/signals.d.ts

@@ -0,0 +1,9 @@
+import type { DebugEvidence } from './debugpacket.js';
+export interface DebugSignal {
+    id: string;
+    label: string;
+    explanation: string;
+    evidenceIds: string[];
+}
+/** Conservative, evidence-linked clues. These are not root-cause diagnoses. */
+export declare function detectSignals(evidence: DebugEvidence[], outcome: string): DebugSignal[];

package/dist/signals.js

@@ -0,0 +1,37 @@
+/** Conservative, evidence-linked clues. These are not root-cause diagnoses. */
+export function detectSignals(evidence, outcome) {
+    const signals = [];
+    const errors = evidence.filter((item) => item.kind === 'error');
+    const steps = evidence.filter((item) => item.kind === 'step');
+    const attempts = evidence.filter((item) => item.kind === 'attempt');
+    const history = evidence.find((item) => item.kind === 'history');
+    const findPair = (errorPattern, stepPattern) => {
+        for (const error of errors) {
+            const retry = error.id.split(':')[1];
+            const step = steps.find((item) => item.id.startsWith(`step:retry-${retry}:`) && /; failed\b/.test(item.text) && stepPattern.test(item.text));
+            if (step && errorPattern.test(error.text))
+                return [error, step];
+        }
+        return null;
+    };
+    const locator = findPair(/(?:locator\.|Locator:[\s\S]*Timeout:|waiting for locator|Timeout .*exceeded)/i, /^(?:(?:pw:api|test\.step):.*(?:locator|click|fill|waitFor)|expect: Expect "toBeVisible")/i);
+    if (locator)
+        signals.push({ id: 'locator-timeout', label: 'Locator operation timed out', explanation: 'A failed locator-related step and timeout evidence are recorded on the same attempt. Check selector state and timing.', evidenceIds: locator.map((item) => item.id) });
+    const assertion = findPair(/(?:expect\(|expect\.|AssertionError|Expected:)/i, /^(?:expect|test\.step):/i);
+    if (assertion && (!locator || assertion[0].id !== locator[0].id))
+        signals.push({ id: 'assertion', label: 'Assertion failed', explanation: 'A failed assertion step and its error are recorded on the same attempt. Inspect the expected and actual values.', evidenceIds: assertion.map((item) => item.id) });
+    const navigation = findPair(/(?:page\.goto|net::ERR_|Navigation failed)/i, /^(?:pw:api|test\.step):.*(?:goto|navigate)/i);
+    if (navigation)
+        signals.push({ id: 'navigation', label: 'Navigation failed', explanation: 'A navigation step failed with a matching error. Inspect the URL and page availability.', evidenceIds: navigation.map((item) => item.id) });
+    const failedAttempt = attempts.find((item) => /: (?:failed|timedOut|interrupted);/.test(item.text));
+    const passedAttempt = attempts.find((item) => /: passed;/.test(item.text));
+    if (outcome === 'flaky' && failedAttempt && passedAttempt)
+        signals.push({ id: 'retry-changed-outcome', label: 'Passed after a failed attempt', explanation: 'The recorded attempts changed outcome. This is not evidence that the underlying issue is fixed.', evidenceIds: [failedAttempt.id, passedAttempt.id] });
+    if (outcome === 'unexpected' && history && /: [pfks-]*p$/.test(history.text)) {
+        const failure = errors[0] ?? failedAttempt;
+        if (failure)
+            signals.push({ id: 'new-failure', label: 'Failed after a prior pass', explanation: 'The previous recorded result passed; this run failed. Compare recent changes before assigning a cause.', evidenceIds: [history.id, failure.id] });
+    }
+    return signals.length ? signals : [{ id: 'unknown', label: 'No specific clue', explanation: 'Available evidence does not support a specific debugging clue. Inspect the error and trace manually.', evidenceIds: [] }];
+}
+//# sourceMappingURL=signals.js.map