perfgraph 0.1.0

package/dist/report/types.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Report types — Zod schemas and TypeScript types for Phase 5.
+ *
+ * The Report is the final output of PerfGraph: a self-contained JSON document
+ * designed for AI consumption. It combines the CausalGraph with remediations,
+ * severity scoring, and correlated FeatureSet data.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+export declare const ReportMetaSchema: z.ZodObject<{
+    url: z.ZodString;
+    analyzedAt: z.ZodString;
+    reportVersion: z.ZodString;
+    featureCount: z.ZodNumber;
+    graphNodeCount: z.ZodNumber;
+    graphEdgeCount: z.ZodNumber;
+    ruleCount: z.ZodNumber;
+}, z.core.$strip>;
+export type ReportMeta = z.infer<typeof ReportMetaSchema>;
+export declare const ReportScoreSchema: z.ZodEnum<{
+    moderate: "moderate";
+    good: "good";
+    poor: "poor";
+}>;
+export type ReportScore = z.infer<typeof ReportScoreSchema>;
+export declare const TopIssueSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    severity: z.ZodString;
+    confidence: z.ZodString;
+}, z.core.$strip>;
+export type TopIssue = z.infer<typeof TopIssueSchema>;
+export declare const ReportSummarySchema: z.ZodObject<{
+    score: z.ZodEnum<{
+        moderate: "moderate";
+        good: "good";
+        poor: "poor";
+    }>;
+    criticalIssues: z.ZodNumber;
+    warnings: z.ZodNumber;
+    infos: z.ZodNumber;
+    topIssues: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        severity: z.ZodString;
+        confidence: z.ZodString;
+    }, z.core.$strip>>;
+    lighthousePerformance: z.ZodOptional<z.ZodNumber>;
+    scoreExplanation: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ReportSummary = z.infer<typeof ReportSummarySchema>;
+export declare const ReportIssueSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodString;
+    severity: z.ZodString;
+    value: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    confidence: z.ZodString;
+    remediation: z.ZodString;
+    chainId: z.ZodString;
+    evidence: z.ZodOptional<z.ZodObject<{
+        urls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        selector: z.ZodOptional<z.ZodString>;
+        lighthouseAuditId: z.ZodOptional<z.ZodString>;
+        metric: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodNumber;
+            unit: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReportIssue = z.infer<typeof ReportIssueSchema>;
+export declare const ChainNodeSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodString;
+    severity: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChainNode = z.infer<typeof ChainNodeSchema>;
+export declare const CausalChainSchema: z.ZodObject<{
+    id: z.ZodString;
+    rootCause: z.ZodString;
+    impact: z.ZodString;
+    confidence: z.ZodString;
+    severity: z.ZodString;
+    path: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodString;
+        severity: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    length: z.ZodNumber;
+}, z.core.$strip>;
+export type CausalChain = z.infer<typeof CausalChainSchema>;
+export declare const RecommendationPrioritySchema: z.ZodEnum<{
+    high: "high";
+    low: "low";
+    medium: "medium";
+    critical: "critical";
+}>;
+export type RecommendationPriority = z.infer<typeof RecommendationPrioritySchema>;
+export declare const RecommendationSchema: z.ZodObject<{
+    priority: z.ZodEnum<{
+        high: "high";
+        low: "low";
+        medium: "medium";
+        critical: "critical";
+    }>;
+    category: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    action: z.ZodString;
+    expectedImpact: z.ZodString;
+    relatedIssues: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Recommendation = z.infer<typeof RecommendationSchema>;
+export declare const ReportSchema: z.ZodObject<{
+    meta: z.ZodObject<{
+        url: z.ZodString;
+        analyzedAt: z.ZodString;
+        reportVersion: z.ZodString;
+        featureCount: z.ZodNumber;
+        graphNodeCount: z.ZodNumber;
+        graphEdgeCount: z.ZodNumber;
+        ruleCount: z.ZodNumber;
+    }, z.core.$strip>;
+    summary: z.ZodObject<{
+        score: z.ZodEnum<{
+            moderate: "moderate";
+            good: "good";
+            poor: "poor";
+        }>;
+        criticalIssues: z.ZodNumber;
+        warnings: z.ZodNumber;
+        infos: z.ZodNumber;
+        topIssues: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            severity: z.ZodString;
+            confidence: z.ZodString;
+        }, z.core.$strip>>;
+        lighthousePerformance: z.ZodOptional<z.ZodNumber>;
+        scoreExplanation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    issues: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodString;
+        severity: z.ZodString;
+        value: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        threshold: z.ZodOptional<z.ZodNumber>;
+        confidence: z.ZodString;
+        remediation: z.ZodString;
+        chainId: z.ZodString;
+        evidence: z.ZodOptional<z.ZodObject<{
+            urls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            selector: z.ZodOptional<z.ZodString>;
+            lighthouseAuditId: z.ZodOptional<z.ZodString>;
+            metric: z.ZodOptional<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodNumber;
+                unit: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    chains: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        rootCause: z.ZodString;
+        impact: z.ZodString;
+        confidence: z.ZodString;
+        severity: z.ZodString;
+        path: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodString;
+            severity: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        length: z.ZodNumber;
+    }, z.core.$strip>>;
+    recommendations: z.ZodArray<z.ZodObject<{
+        priority: z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+            critical: "critical";
+        }>;
+        category: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        action: z.ZodString;
+        expectedImpact: z.ZodString;
+        relatedIssues: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    features: z.ZodUnknown;
+}, z.core.$strip>;
+export type Report = z.infer<typeof ReportSchema>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/report/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,gBAAgB;;;;;;;;iBAe3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM1D,eAAO,MAAM,iBAAiB;;;;EAAuC,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;;iBAKzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;iBAe9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;iBAuB5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,eAAe;;;;;iBAK1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAe5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,4BAA4B;;;;;EAKvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAe/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/report/types.js

@@ -0,0 +1,149 @@
+/**
+ * Report types — Zod schemas and TypeScript types for Phase 5.
+ *
+ * The Report is the final output of PerfGraph: a self-contained JSON document
+ * designed for AI consumption. It combines the CausalGraph with remediations,
+ * severity scoring, and correlated FeatureSet data.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+import { EvidenceSchema } from '../causal/types.js';
+// ---------------------------------------------------------------------------
+// ReportMeta
+// ---------------------------------------------------------------------------
+export const ReportMetaSchema = z.object({
+    /** Target URL that was analyzed */
+    url: z.string(),
+    /** ISO 8601 timestamp */
+    analyzedAt: z.string(),
+    /** Semantic version of the report format */
+    reportVersion: z.string(),
+    /** Number of features that were present in the input */
+    featureCount: z.number().nonnegative(),
+    /** Number of nodes in the causal graph */
+    graphNodeCount: z.number().nonnegative(),
+    /** Number of edges in the causal graph */
+    graphEdgeCount: z.number().nonnegative(),
+    /** Number of causal rules evaluated */
+    ruleCount: z.number().nonnegative(),
+});
+// ---------------------------------------------------------------------------
+// ReportSummary
+// ---------------------------------------------------------------------------
+export const ReportScoreSchema = z.enum(['good', 'moderate', 'poor']);
+export const TopIssueSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    severity: z.string(),
+    confidence: z.string(),
+});
+export const ReportSummarySchema = z.object({
+    /** Overall performance score */
+    score: ReportScoreSchema,
+    /** Count of critical-severity issues */
+    criticalIssues: z.number().nonnegative(),
+    /** Count of warning-severity issues */
+    warnings: z.number().nonnegative(),
+    /** Count of info-severity issues */
+    infos: z.number().nonnegative(),
+    /** Top 3-5 most important issues */
+    topIssues: z.array(TopIssueSchema),
+    /** Optional Lighthouse performance score (0–1) */
+    lighthousePerformance: z.number().optional(),
+    /** Optional explanation when Lighthouse data influenced the score */
+    scoreExplanation: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// ReportIssue — a single detected problem with remediation
+// ---------------------------------------------------------------------------
+export const ReportIssueSchema = z.object({
+    /** Unique issue identifier (matches CausalNode.id) */
+    id: z.string().min(1),
+    /** Human-readable label */
+    label: z.string().min(1),
+    /** Node type: metric, bottleneck, or impact */
+    type: z.string(),
+    /** Severity level */
+    severity: z.string(),
+    /** Raw metric value if applicable */
+    value: z.number().optional(),
+    /** Unit label if applicable */
+    unit: z.string().optional(),
+    /** Threshold that was exceeded if applicable */
+    threshold: z.number().optional(),
+    /** Confidence of the causal link leading to this issue */
+    confidence: z.string(),
+    /** Human-readable remediation recommendation */
+    remediation: z.string(),
+    /** ID of the causal chain this issue belongs to */
+    chainId: z.string(),
+    /** Evidence payload from the causal node */
+    evidence: EvidenceSchema.optional(),
+});
+// ---------------------------------------------------------------------------
+// CausalChain — a causal path from root cause to impact
+// ---------------------------------------------------------------------------
+export const ChainNodeSchema = z.object({
+    nodeId: z.string().min(1),
+    label: z.string().min(1),
+    type: z.string(),
+    severity: z.string().optional(),
+});
+export const CausalChainSchema = z.object({
+    /** Unique chain identifier (derived from ruleId) */
+    id: z.string().min(1),
+    /** Label of the root cause node */
+    rootCause: z.string(),
+    /** Label of the terminal impact node */
+    impact: z.string(),
+    /** Overall confidence of the chain */
+    confidence: z.string(),
+    /** Highest severity in the chain */
+    severity: z.string(),
+    /** Ordered path from root to impact */
+    path: z.array(ChainNodeSchema),
+    /** Number of nodes in the path */
+    length: z.number().positive(),
+});
+// ---------------------------------------------------------------------------
+// Recommendation — prioritized action item
+// ---------------------------------------------------------------------------
+export const RecommendationPrioritySchema = z.enum([
+    'critical',
+    'high',
+    'medium',
+    'low',
+]);
+export const RecommendationSchema = z.object({
+    /** Priority level */
+    priority: RecommendationPrioritySchema,
+    /** Category (e.g. "LCP", "JavaScript", "Network", "Layout") */
+    category: z.string(),
+    /** Short actionable title */
+    title: z.string().min(1),
+    /** Detailed description */
+    description: z.string(),
+    /** Concrete action steps */
+    action: z.string(),
+    /** Expected positive impact */
+    expectedImpact: z.string(),
+    /** IDs of related issues */
+    relatedIssues: z.array(z.string()),
+});
+// ---------------------------------------------------------------------------
+// Full Report
+// ---------------------------------------------------------------------------
+export const ReportSchema = z.object({
+    meta: ReportMetaSchema,
+    summary: ReportSummarySchema,
+    /** All detected issues, sorted by severity (critical first) */
+    issues: z.array(ReportIssueSchema),
+    /** Causal chains from root causes to impacts */
+    chains: z.array(CausalChainSchema),
+    /** Prioritized action recommendations */
+    recommendations: z.array(RecommendationSchema),
+    /** Raw FeatureSet for AI cross-referencing (passthrough) */
+    features: z.unknown(),
+});
+//# sourceMappingURL=types.js.map

package/dist/report/types.js.map

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

package/dist/shared/fs-utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared filesystem utilities for reading collection run data.
+ *
+ * Consolidates duplicated readJson / loadRunDir helpers into one module
+ * with consistent error handling (most descriptive variant from normalize.ts).
+ */
+import type { RawDataBundle } from '../collect/types.js';
+/** Read a JSON file, returning parsed content or undefined if missing. */
+export declare function readJson(dir: string, filename: string): unknown | undefined;
+/** Assemble a RawDataBundle from a run directory. */
+export declare function loadRunDir(runDir: string): RawDataBundle;
+//# sourceMappingURL=fs-utils.d.ts.map

package/dist/shared/fs-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../../src/shared/fs-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE1E,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAa3E;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAsBxD"}

package/dist/shared/fs-utils.js

@@ -0,0 +1,44 @@
+/**
+ * Shared filesystem utilities for reading collection run data.
+ *
+ * Consolidates duplicated readJson / loadRunDir helpers into one module
+ * with consistent error handling (most descriptive variant from normalize.ts).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/** Read a JSON file, returning parsed content or undefined if missing. */
+export function readJson(dir, filename) {
+    const filePath = join(dir, filename);
+    if (!existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Error: Failed to parse ${join(dir, filename)}: ${err.message}`);
+    }
+}
+/** Assemble a RawDataBundle from a run directory. */
+export function loadRunDir(runDir) {
+    const dir = resolve(runDir);
+    const warningsRaw = readJson(dir, 'warnings.json');
+    return {
+        trace: readJson(dir, 'trace.json'),
+        network: readJson(dir, 'network.json'),
+        performance: readJson(dir, 'performance.json'),
+        runtime: readJson(dir, 'runtime.json'),
+        consoleEntries: readJson(dir, 'console.json'),
+        dom: readJson(dir, 'dom.json'),
+        lighthouse: readJson(dir, 'lighthouse.json'),
+        coverage: readJson(dir, 'coverage.json'),
+        warnings: warningsRaw &&
+            typeof warningsRaw === 'object' &&
+            'warnings' in warningsRaw &&
+            Array.isArray(warningsRaw.warnings)
+            ? warningsRaw.warnings
+            : undefined,
+    };
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/shared/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../src/shared/fs-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,QAAgB;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAM,GAAa,CAAC,OAAO,EAAE,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5B,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;QAClC,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;QACtC,WAAW,EAAE,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;QAC9C,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;QACtC,cAAc,EAAE,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;QAC7C,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;QAC9B,UAAU,EAAE,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;QAC5C,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAgC;QACvE,QAAQ,EACN,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,UAAU,IAAI,WAAW;YACzB,KAAK,CAAC,OAAO,CAAE,WAAqC,CAAC,QAAQ,CAAC;YAC5D,CAAC,CAAE,WAAsC,CAAC,QAAQ;YAClD,CAAC,CAAC,SAAS;KAChB,CAAC;AACJ,CAAC"}

package/dist/shared/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shared types used across the perfgraph codebase.
+ */
+/** Output file paths for a single collection run */
+export interface OutputPaths {
+    /** Root output directory */
+    dir: string;
+    /** Path to trace.json */
+    trace: string;
+    /** Path to network.json */
+    network: string;
+    /** Path to metrics.json */
+    metrics: string;
+    /** Path to runtime.json */
+    runtime: string;
+    /** Path to coverage.json */
+    coverage: string;
+    /** Path to console.json */
+    console: string;
+    /** Path to dom.json */
+    dom: string;
+    /** Path to lighthouse.json */
+    lighthouse: string;
+    /** Path to warnings.json */
+    warnings: string;
+}
+/** Options for a collection run */
+export interface CollectorRunOptions {
+    /** Target URL to collect data from */
+    url: string;
+    /** Base output directory (default: ./perfgraph-output) */
+    output: string;
+    /** Number of runs (default: 1) */
+    runs: number;
+    /** Skip Lighthouse collection */
+    noLighthouse: boolean;
+    /** Skip Coverage collection */
+    noCoverage: boolean;
+    /** Skip Console collection */
+    noConsole: boolean;
+    /** Skip DOM snapshot collection */
+    noDom: boolean;
+    /** Skip Network collection */
+    noNetwork: boolean;
+    /** Skip Performance metrics collection */
+    noPerformance: boolean;
+    /** Skip Runtime collection */
+    noRuntime: boolean;
+    /** Device name for emulation (e.g. "iPhone 13", "Pixel 7"). Empty = desktop */
+    mobile?: string;
+}
+/** Result of a single collection run */
+export interface RunResult {
+    /** 1-based run index */
+    index: number;
+    /** Output directory for this run */
+    outputDir: string;
+    /** Number of warnings generated */
+    warningCount: number;
+    /** Files written during this run */
+    files: string[];
+    /** Whether the run succeeded */
+    success: boolean;
+    /** Error message if run failed */
+    error?: string;
+}
+/** Default values for CollectorRunOptions */
+export declare const DEFAULT_RUN_OPTIONS: CollectorRunOptions;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,EAAE,mBAYjC,CAAC"}

package/dist/shared/types.js

@@ -0,0 +1,18 @@
+/**
+ * Shared types used across the perfgraph codebase.
+ */
+/** Default values for CollectorRunOptions */
+export const DEFAULT_RUN_OPTIONS = {
+    url: '',
+    output: './perfgraph-output',
+    runs: 1,
+    noLighthouse: false,
+    noCoverage: false,
+    noConsole: false,
+    noDom: false,
+    noNetwork: false,
+    noPerformance: false,
+    noRuntime: false,
+    mobile: undefined,
+};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,oBAAoB;IAC5B,IAAI,EAAE,CAAC;IACP,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,KAAK;IAChB,aAAa,EAAE,KAAK;IACpB,SAAS,EAAE,KAAK;IAChB,MAAM,EAAE,SAAS;CAClB,CAAC"}

package/dist/shared/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared utility functions used across the perfgraph codebase.
+ */
+/** Severity ordering helper: critical > warning > info */
+export declare function severityOrder(severity: string): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/shared/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGtD"}

package/dist/shared/utils.js

@@ -0,0 +1,9 @@
+/**
+ * Shared utility functions used across the perfgraph codebase.
+ */
+/** Severity ordering helper: critical > warning > info */
+export function severityOrder(severity) {
+    const order = { critical: 3, warning: 2, info: 1 };
+    return order[severity] ?? 0;
+}
+//# sourceMappingURL=utils.js.map

package/dist/shared/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAA2B,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3E,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+	"name": "perfgraph",
+	"version": "0.1.0",
+	"type": "module",
+	"description": "CDP-powered perf CLI — causal degradation graphs, not just Lighthouse scores",
+	"license": "MIT",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist/",
+		"README.md",
+		"LICENSE"
+	],
+	"bin": {
+		"perfgraph": "dist/index.js"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Be1zebub/PerfGraph.git"
+	},
+	"bugs": {
+		"url": "https://github.com/Be1zebub/PerfGraph/issues"
+	},
+	"homepage": "https://github.com/Be1zebub/PerfGraph#readme",
+	"keywords": [
+		"web-performance",
+		"lighthouse",
+		"cdp",
+		"core-web-vitals",
+		"lcp",
+		"cls",
+		"mcp",
+		"performance",
+		"profiler",
+		"diagnostics"
+	],
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsx watch src/index.ts",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "npm run build"
+	},
+	"dependencies": {
+		"@dagrejs/graphlib": "^4.0.1",
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"@toon-format/toon": "^2.3.1",
+		"lighthouse": "^13.3.0",
+		"ow": "^3.1.0",
+		"playwright": "^1.58.0",
+		"zod": "^4.4.0"
+	},
+	"devDependencies": {
+		"@types/node": "^24.0.0",
+		"devtools-protocol": "^0.0.1638241",
+		"tsx": "^4.20.0",
+		"typescript": "^5.9.0",
+		"vitest": "^4.1.0"
+	},
+	"engines": {
+		"node": ">=22.0.0"
+	}
+}