perfgraph 0.1.0

package/dist/collect/types.d.ts

@@ -0,0 +1,317 @@
+/**
+ * Collector interfaces, result types, and raw data types.
+ *
+ * Each collector produces a CollectorResult that wraps its domain-specific
+ * raw data. RawDataBundle aggregates all collectors' output for a single run.
+ *
+ * All type definitions live here to avoid circular module dependencies
+ * between types.ts and the collector implementations.
+ */
+import type { CDPSession } from 'playwright';
+import type { CollectorRunOptions } from '../shared/types.js';
+/** Wrapped result from a collector's stop() method */
+export type CollectorResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+};
+/** Every collector implements this interface */
+export interface Collector {
+    /** Human-readable collector name (e.g. "trace", "network") */
+    readonly name: string;
+    /**
+     * Start collecting data.
+     * Called after the CDP session is established but before navigation.
+     */
+    start(session: CDPSession, options?: CollectorRunOptions): Promise<void>;
+    /**
+     * Stop collecting data and return the collected payload.
+     * Called after the page has finished loading.
+     */
+    stop(): Promise<CollectorResult<unknown>>;
+}
+/**
+ * Aggregated output from all collectors for a single run.
+ * Each field is optional — a collector may fail without blocking others.
+ */
+export interface RawDataBundle {
+    trace?: unknown;
+    network?: unknown;
+    performance?: unknown;
+    runtime?: unknown;
+    coverage?: CoverageRawData;
+    consoleEntries?: unknown;
+    dom?: unknown;
+    lighthouse?: unknown;
+    warnings?: string[];
+}
+/** A single trace event from the Tracing domain */
+export interface TraceEvent {
+    /** Event categories (comma-separated) */
+    cat: string;
+    /** Event name */
+    name: string;
+    /** Event phase (B/b=begin, E/e=end, I=instant, etc.) */
+    ph: string;
+    /** Timestamp in microseconds */
+    ts: number;
+    /** Process ID */
+    pid: number;
+    /** Thread ID */
+    tid: number;
+    /** Event arguments */
+    args: Record<string, unknown>;
+    /** Duration in microseconds (for complete events) */
+    dur?: number;
+    /** Thread duration */
+    tdur?: number;
+}
+/** Structured output from TraceCollector */
+export interface TraceRawData {
+    /** All collected trace events in chronological order */
+    events: TraceEvent[];
+    /** Collection metadata */
+    metadata: {
+        /** Categories that were requested for tracing */
+        categories: string[];
+        /** Total number of events collected */
+        totalEvents: number;
+        /** Number of dataCollected callbacks received */
+        dataCollectedCount: number;
+    };
+    /** Warnings generated during collection (buffer overflow, missing events, etc.) */
+    warnings: string[];
+}
+/** Sample from Tracing.bufferUsage event */
+export interface BufferUsageSample {
+    /** Buffer usage value (0.0 – 1.0) */
+    value: number;
+    /** Wall-clock timestamp when the sample was taken */
+    timestamp: number;
+}
+/** Resource timing breakdown from CDP (Network.Response.timing) */
+export interface NetworkTiming {
+    requestTime: number;
+    proxyStart: number;
+    proxyEnd: number;
+    dnsStart: number;
+    dnsEnd: number;
+    connectStart: number;
+    connectEnd: number;
+    sslStart: number;
+    sslEnd: number;
+    workerStart: number;
+    workerReady: number;
+    workerFetchStart: number;
+    workerRespondWithSettled: number;
+    sendStart: number;
+    sendEnd: number;
+    pushStart: number;
+    pushEnd: number;
+    receiveHeadersEnd: number;
+}
+/** Describes a captured network request and its response */
+export interface NetworkRequestEntry {
+    /** Unique request identifier from CDP */
+    requestId: string;
+    /** Request URL (final URL after redirects) */
+    url: string;
+    /** HTTP method (GET, POST, etc.) */
+    method: string;
+    /** Resource type (Document, Script, Image, XHR, Fetch, etc.) */
+    type?: string;
+    /** Request metadata */
+    request: {
+        headers: Record<string, string>;
+        postData?: string;
+        initialPriority?: string;
+        referrerPolicy?: string;
+    };
+    /** Response metadata (present if the request completed) */
+    response?: {
+        status: number;
+        statusText: string;
+        headers: Record<string, string>;
+        mimeType: string;
+        /** Resource timing breakdown */
+        timing?: NetworkTiming;
+        fromDiskCache?: boolean;
+        fromServiceWorker?: boolean;
+        encodedDataLength: number;
+        responseTime?: number;
+        protocol?: string;
+        remoteIPAddress?: string;
+        remotePort?: number;
+    };
+    /** Whether the request failed */
+    failed?: boolean;
+    /** Error description (present when failed) */
+    errorText?: string;
+    /** Whether the request was canceled */
+    canceled?: boolean;
+    /** Reason the request was blocked */
+    blockedReason?: string;
+    /** Initiator information */
+    initiator?: {
+        type: string;
+        url?: string;
+        lineNumber?: number;
+        stack?: {
+            callFrames: Array<{
+                functionName: string;
+                scriptId: string;
+                url: string;
+                lineNumber: number;
+                columnNumber: number;
+            }>;
+        };
+    };
+    /** CDP monotonic timestamp (seconds) */
+    timestamp: number;
+    /** UTC wall time (seconds since epoch) */
+    wallTime?: number;
+    /** Whether the request was served from cache */
+    fromCache?: boolean;
+    /** Redirect chain responses (if any redirects occurred) */
+    redirectChain?: Array<{
+        url: string;
+        status: number;
+        statusText: string;
+        headers: Record<string, string>;
+        timing?: NetworkTiming;
+        encodedDataLength: number;
+    }>;
+}
+/** Structured output from NetworkCollector */
+export interface NetworkRawData {
+    /** All captured network requests in chronological order */
+    requests: NetworkRequestEntry[];
+    /** Collection metadata */
+    metadata: {
+        totalRequests: number;
+        totalFailed: number;
+        totalBytes: number;
+        startTime: number;
+        endTime: number;
+    };
+    /** Warnings generated during collection */
+    warnings: string[];
+}
+/** A single performance metric entry */
+export interface PerformanceMetric {
+    name: string;
+    value: number;
+}
+/** Structured output from PerformanceCollector */
+export interface PerformanceRawData {
+    /** Final snapshot metrics from Performance.getMetrics */
+    metrics: PerformanceMetric[];
+    /** Timestamp when the metrics snapshot was taken */
+    timestamp: number;
+    /** Warnings generated during collection */
+    warnings: string[];
+}
+/** Information about a single JavaScript execution context */
+export interface RuntimeExecutionContext {
+    id: number;
+    origin: string;
+    name: string;
+}
+/** Runtime metrics evaluated in the page context */
+export interface RuntimeStats {
+    jsHeapSize: number;
+    domNodeCount: number;
+    documentUrl: string;
+}
+/** Structured output from RuntimeCollector */
+export interface RuntimeRawData {
+    contexts: RuntimeExecutionContext[];
+    stats?: RuntimeStats;
+    warnings: string[];
+}
+/** A single covered range within a script or stylesheet */
+export interface CoverageRange {
+    startOffset: number;
+    endOffset: number;
+    count: number;
+}
+/** Coverage data for a single function within a script */
+export interface ScriptFunctionCoverage {
+    functionName: string;
+    ranges: CoverageRange[];
+    isBlockCoverage: boolean;
+}
+/** Coverage data for a single script */
+export interface ScriptCoverage {
+    scriptId: string;
+    url: string;
+    functions: ScriptFunctionCoverage[];
+}
+/** Coverage data for a single stylesheet */
+export interface StyleCoverage {
+    styleSheetId: string;
+    url: string;
+    ranges: CoverageRange[];
+}
+/** Structured output from CoverageCollector */
+export interface CoverageRawData {
+    js: ScriptCoverage[];
+    css: StyleCoverage[];
+    warnings: string[];
+}
+/** Supported console message types */
+export type ConsoleEntryType = 'log' | 'warn' | 'error' | 'info' | 'debug' | 'assert' | 'dir' | 'dirxml' | 'table' | 'trace' | 'clear' | 'startGroup' | 'startGroupCollapsed' | 'endGroup' | 'count' | 'timeEnd' | 'profile' | 'profileEnd';
+/** A single stack frame from the call site */
+export interface ConsoleStackFrame {
+    url: string;
+    lineNumber: number;
+    columnNumber: number;
+    functionName?: string;
+}
+/** A single console API call entry */
+export interface ConsoleEntry {
+    timestamp: number;
+    type: ConsoleEntryType;
+    args: unknown[];
+    stackTrace?: ConsoleStackFrame[];
+}
+/** Severity counts for all captured console entries */
+export interface ConsoleCounts {
+    log: number;
+    warn: number;
+    error: number;
+    info: number;
+    debug: number;
+    other: number;
+}
+/** Structured output from ConsoleCollector */
+export interface ConsoleRawData {
+    entries: ConsoleEntry[];
+    counts: ConsoleCounts;
+    warnings: string[];
+}
+/** Aggregate DOM statistics */
+export interface DomStats {
+    totalNodes: number;
+    elementCount: number;
+    maxDepth: number;
+    textContentLength: number;
+}
+/** Structured output from DOMCollector */
+export interface DomRawData {
+    stats: DomStats;
+    elementDistribution: Record<string, number>;
+    warnings: string[];
+}
+/** Lighthouse category identifiers we audit by default */
+export type LighthouseCategory = 'performance' | 'accessibility' | 'best-practices' | 'seo';
+/** Structured output from LighthouseCollector */
+export interface LighthouseRawData {
+    /** Full Lighthouse Result object (LHR) */
+    lhr: Record<string, unknown>;
+    categories: LighthouseCategory[];
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/collect/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/collect/types.ts"],"names":[],"mappings":"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"}

package/dist/collect/types.js

@@ -0,0 +1,12 @@
+/**
+ * Collector interfaces, result types, and raw data types.
+ *
+ * Each collector produces a CollectorResult that wraps its domain-specific
+ * raw data. RawDataBundle aggregates all collectors' output for a single run.
+ *
+ * All type definitions live here to avoid circular module dependencies
+ * between types.ts and the collector implementations.
+ */
+export {};
+// (No remaining type stubs — all collector types are now defined above)
+//# sourceMappingURL=types.js.map

package/dist/collect/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/collect/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;AA0YH,wEAAwE"}

package/dist/distill/insights.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Agent-optimized summary layer that fuses Lighthouse insights,
+ * extracted features, and evidence data into a compact Insights structure.
+ *
+ * The result can be serialized to `insights.toon` (~5-15 KB for a typical SPA).
+ *
+ * @packageDocumentation
+ */
+import type { FeatureSet } from '../extract/types.js';
+export interface CriticalPathNode {
+    url: string;
+    durationMs?: number;
+    children?: CriticalPathNode[];
+}
+export interface Insights {
+    url: string;
+    analyzedAt: string;
+    lighthouse: {
+        performance?: number;
+        accessibility?: number;
+        bestPractices?: number;
+        seo?: number;
+        lcpMs?: number;
+        fcpMs?: number;
+        cls?: number;
+        tbtMs?: number;
+    };
+    lcpElement?: {
+        selector: string;
+        snippet?: string;
+        nodeLabel?: string;
+        renderDelayMs?: number;
+        resourceLoadDelayMs?: number;
+        resourceLoadTimeMs?: number;
+        ttfbMs?: number;
+    };
+    renderBlocking: Array<{
+        url: string;
+        bytes?: number;
+        wastedMs?: number;
+    }>;
+    criticalPath?: {
+        depth: number;
+        longestChainMs?: number;
+        tree?: CriticalPathNode;
+    };
+    warnings: string[];
+    topRecommendations: Array<{
+        priority: 'critical' | 'high' | 'medium';
+        title: string;
+        action: string;
+        evidence?: string[];
+    }>;
+}
+/**
+ * Build a compact Insights structure from extracted features and raw
+ * Lighthouse data.
+ *
+ * The result is designed to be serialized as `insights.toon` (~5-15 KB)
+ * and consumed by AI agents for quick performance diagnosis.
+ *
+ * @param features - Extracted feature set from `extract()`
+ * @param lighthouseJson - Raw Lighthouse JSON (LighthouseRawData or plain LHR)
+ * @returns A compact Insights structure
+ */
+export declare function buildInsights(features: FeatureSet, lighthouseJson: unknown): Insights;
+//# sourceMappingURL=insights.d.ts.map

package/dist/distill/insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../src/distill/insights.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAWtD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,cAAc,EAAE,KAAK,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,YAAY,CAAC,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,gBAAgB,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,EAAE,KAAK,CAAC;QACxB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;QACzC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;CACJ;AA8SD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,UAAU,EACpB,cAAc,EAAE,OAAO,GACtB,QAAQ,CAqFV"}