perfgraph 0.1.0

package/dist/causal/types.js

@@ -0,0 +1,88 @@
+/**
+ * Causal Graph types — Zod schemas and TypeScript types.
+ *
+ * These define the output of Phase 4: a typed DAG where nodes represent
+ * performance signals (metrics, bottlenecks, impacts) and edges represent
+ * causal relationships with confidence scores.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Shared enums
+// ---------------------------------------------------------------------------
+/** Confidence level for a causal edge */
+export const ConfidenceSchema = z.enum(['strong', 'medium', 'weak']);
+/** Node severity (user-facing classification) */
+export const SeveritySchema = z.enum(['critical', 'warning', 'info']);
+/** Node role in the causal chain */
+export const NodeTypeSchema = z.enum(['metric', 'bottleneck', 'impact']);
+// ---------------------------------------------------------------------------
+// Evidence — optional payload attached to a causal node
+// ---------------------------------------------------------------------------
+/** Evidence payload attached to a causal node */
+export const EvidenceSchema = z.object({
+    /** Affected URLs (e.g. render-blocking resource URLs) */
+    urls: z.array(z.string()).optional(),
+    /** DOM selector for the LCP element or shift source */
+    selector: z.string().optional(),
+    /** Lighthouse audit ID for cross-referencing */
+    lighthouseAuditId: z.string().optional(),
+    /** Key metric (name, value, unit) */
+    metric: z
+        .object({
+        name: z.string(),
+        value: z.number(),
+        unit: z.string(),
+    })
+        .optional(),
+});
+// ---------------------------------------------------------------------------
+// CausalNode
+// ---------------------------------------------------------------------------
+export const CausalNodeSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    type: NodeTypeSchema,
+    severity: SeveritySchema.optional(),
+    /** Raw metric value (e.g. 3200 for TTFB in ms) */
+    value: z.number().optional(),
+    /** Unit label (e.g. "ms", "bytes", "score") */
+    unit: z.string().optional(),
+    /** Threshold that was exceeded */
+    threshold: z.number().optional(),
+    /** Evidence payload attached to this node */
+    evidence: EvidenceSchema.optional(),
+});
+// ---------------------------------------------------------------------------
+// CausalEdge
+// ---------------------------------------------------------------------------
+export const CausalEdgeSchema = z.object({
+    source: z.string().min(1),
+    target: z.string().min(1),
+    confidence: ConfidenceSchema,
+    /** Human-readable label for this causal relationship */
+    label: z.string().min(1),
+    /** ID of the rule that generated this edge */
+    ruleId: z.string().min(1),
+});
+// ---------------------------------------------------------------------------
+// CausalGraph — the full output of the builder
+// ---------------------------------------------------------------------------
+export const CausalGraphMetadataSchema = z.object({
+    /** How many features were present in the input */
+    featureCount: z.number().nonnegative(),
+    /** How many rules were evaluated (including non-applicable) */
+    ruleCount: z.number().nonnegative(),
+    totalNodes: z.number().nonnegative(),
+    totalEdges: z.number().nonnegative(),
+    hasCycle: z.boolean(),
+    /** Target URL that was analyzed */
+    targetUrl: z.string().optional(),
+});
+export const CausalGraphSchema = z.object({
+    nodes: z.array(CausalNodeSchema),
+    edges: z.array(CausalEdgeSchema),
+    metadata: CausalGraphMetadataSchema,
+});
+//# sourceMappingURL=types.js.map

package/dist/causal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/causal/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAGrE,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAGtE,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGzE,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,yDAAyD;IACzD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,uDAAuD;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,gDAAgD;IAChD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,qCAAqC;IACrC,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAGH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,kDAAkD;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,kCAAkC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,6CAA6C;IAC7C,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAGH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,UAAU,EAAE,gBAAgB;IAC5B,wDAAwD;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,8CAA8C;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CAAC;AAGH,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,kDAAkD;IAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACtC,+DAA+D;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,mCAAmC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAChC,QAAQ,EAAE,yBAAyB;CACpC,CAAC,CAAC"}

package/dist/cli/analyze.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `analyze` subcommand handler.
+ *
+ * Reads a FeatureSet JSON file (produced by `perfgraph extract`) and runs
+ * causal graph analysis, outputting a CausalGraph as JSON.
+ *
+ * Usage:
+ *   perfgraph analyze <features-file>
+ *   perfgraph analyze --input features.json --output graph.json --pretty
+ *
+ * @packageDocumentation
+ */
+/** Result of the analyze command execution */
+export interface AnalyzeResult {
+    /** Whether analysis succeeded */
+    success: boolean;
+    /** Path to the input FeatureSet file */
+    inputFile: string;
+}
+/**
+ * Run the analyze command from a FeatureSet file path.
+ *
+ * @param inputFile - Path to FeatureSet JSON file
+ * @param outputFile - Optional output file path (defaults to stdout)
+ * @param pretty - Pretty-print JSON (default: false)
+ * @returns AnalyzeResult
+ */
+export declare function runAnalyze(inputFile: string, outputFile?: string, pretty?: boolean): Promise<AnalyzeResult>;
+/**
+ * Parse CLI arguments for the analyze command and execute.
+ */
+export declare function runAnalyzeFromArgs(args: string[]): Promise<AnalyzeResult | null>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/cli/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/cli/analyze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuBH,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAiCD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,aAAa,CAAC,CAiBxB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA4D/B"}

package/dist/cli/analyze.js

@@ -0,0 +1,137 @@
+/**
+ * `analyze` subcommand handler.
+ *
+ * Reads a FeatureSet JSON file (produced by `perfgraph extract`) and runs
+ * causal graph analysis, outputting a CausalGraph as JSON.
+ *
+ * Usage:
+ *   perfgraph analyze <features-file>
+ *   perfgraph analyze --input features.json --output graph.json --pretty
+ *
+ * @packageDocumentation
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { buildCausalGraph } from '../causal/index.js';
+import { FeatureSetSchema } from '../extract/types.js';
+/** Help text shown by `perfgraph analyze --help` */
+const ANALYZE_HELP = `
+ANALYZE OPTIONS
+  <file>                Path to a FeatureSet JSON file (positional, required)
+  --input, -i <file>    Path to FeatureSet JSON file (alternative to positional)
+  --output, -o <file>   Write output to a file (default: stdout)
+  --pretty              Pretty-print JSON output
+  --help, -h            Show this help message
+
+EXAMPLES
+  perfgraph analyze ./features.json
+  perfgraph analyze ./features.json --output graph.json
+  perfgraph analyze ./features.json --pretty
+`;
+/**
+ * Load and validate a FeatureSet from a JSON file.
+ */
+function loadFeatureSet(filePath) {
+    const resolved = resolve(filePath);
+    if (!existsSync(resolved)) {
+        throw new Error(`Error: File not found: ${filePath}`);
+    }
+    let raw;
+    try {
+        const content = readFileSync(resolved, 'utf-8');
+        raw = JSON.parse(content);
+    }
+    catch (err) {
+        throw new Error(`Error: Failed to parse ${filePath}: ${err.message}`);
+    }
+    // Validate against FeatureSetSchema
+    const parsed = FeatureSetSchema.safeParse(raw);
+    if (!parsed.success) {
+        const firstIssue = parsed.error.issues[0];
+        throw new Error(`Error: Invalid FeatureSet format in ${filePath}: ${firstIssue?.path.join('.') ?? ''} ${firstIssue?.message ?? ''}`);
+    }
+    return parsed.data;
+}
+/**
+ * Run the analyze command from a FeatureSet file path.
+ *
+ * @param inputFile - Path to FeatureSet JSON file
+ * @param outputFile - Optional output file path (defaults to stdout)
+ * @param pretty - Pretty-print JSON (default: false)
+ * @returns AnalyzeResult
+ */
+export async function runAnalyze(inputFile, outputFile, pretty) {
+    const features = loadFeatureSet(inputFile);
+    const graph = buildCausalGraph(features);
+    const indent = pretty ? 2 : 0;
+    const json = JSON.stringify(graph, null, indent);
+    if (outputFile) {
+        const { writeFileSync } = await import('node:fs');
+        writeFileSync(outputFile, json, 'utf-8');
+    }
+    else {
+        console.log(json);
+    }
+    return {
+        success: true,
+        inputFile: resolve(inputFile),
+    };
+}
+/**
+ * Parse CLI arguments for the analyze command and execute.
+ */
+export async function runAnalyzeFromArgs(args) {
+    let inputFile;
+    let outputFile;
+    let pretty = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--input':
+            case '-i':
+                if (i + 1 >= args.length) {
+                    console.error('Error: --input requires a value');
+                    return null;
+                }
+                inputFile = args[++i];
+                break;
+            case '--output':
+            case '-o':
+                if (i + 1 >= args.length) {
+                    console.error('Error: --output requires a value');
+                    return null;
+                }
+                outputFile = args[++i];
+                break;
+            case '--pretty':
+                pretty = true;
+                break;
+            case '--help':
+            case '-h':
+                console.log(ANALYZE_HELP);
+                return null;
+            default:
+                if (arg.startsWith('--')) {
+                    console.error(`Error: Unknown flag "${arg}"`);
+                    return null;
+                }
+                // First positional arg is the input file
+                if (!inputFile) {
+                    inputFile = arg;
+                }
+                break;
+        }
+    }
+    if (!inputFile) {
+        console.error('Error: <file> is required (positional or --input)');
+        return null;
+    }
+    try {
+        return await runAnalyze(inputFile, outputFile, pretty);
+    }
+    catch (err) {
+        console.error(String(err));
+        return null;
+    }
+}
+//# sourceMappingURL=analyze.js.map

package/dist/cli/analyze.js.map

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

package/dist/cli/collect.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `collect` subcommand handler.
+ *
+ * Parses CLI flags and delegates to the orchestrator.
+ * All progress messages are written to stderr; only the final JSON summary
+ * (run results) is written to stdout for piping.
+ */
+/** Result of the collect command execution */
+export interface CollectResult {
+    /** Whether any runs succeeded */
+    success: boolean;
+    /** Total number of runs attempted */
+    runs: number;
+    /** Number of successful runs */
+    successfulRuns: number;
+    /** Output directories for each run */
+    outputDirs: string[];
+    /** Total warning count across all runs */
+    warnings: number;
+}
+/**
+ * Parse CLI arguments and execute collection.
+ *
+ * @param args - Array of CLI arguments (everything after "collect")
+ * @returns CollectResult or null if parsing failed
+ */
+export declare function runCollect(args: string[]): Promise<CollectResult | null>;
+//# sourceMappingURL=collect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/cli/collect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuB9E"}

package/dist/cli/collect.js

@@ -0,0 +1,125 @@
+/**
+ * `collect` subcommand handler.
+ *
+ * Parses CLI flags and delegates to the orchestrator.
+ * All progress messages are written to stderr; only the final JSON summary
+ * (run results) is written to stdout for piping.
+ */
+import { run } from '../collect/orchestrator.js';
+import { DEFAULT_RUN_OPTIONS } from '../shared/types.js';
+/**
+ * Parse CLI arguments and execute collection.
+ *
+ * @param args - Array of CLI arguments (everything after "collect")
+ * @returns CollectResult or null if parsing failed
+ */
+export async function runCollect(args) {
+    const options = parseArgs(args);
+    if (!options) {
+        return null;
+    }
+    const results = await run(options.url, options);
+    const successfulRuns = results.filter((r) => r.success);
+    const allOutputDirs = results.map((r) => r.outputDir).filter(Boolean);
+    const result = {
+        success: successfulRuns.length > 0,
+        runs: results.length,
+        successfulRuns: successfulRuns.length,
+        outputDirs: allOutputDirs,
+        warnings: results.reduce((sum, r) => sum + r.warningCount, 0),
+    };
+    // Write JSON summary to stdout (for piping)
+    console.log(JSON.stringify(result, null, 2));
+    return result;
+}
+/**
+ * Parse CLI flags into CollectorRunOptions.
+ *
+ * Accepts:
+ *   --url <url>        (required)
+ *   --output <dir>     (default: ./perfgraph-output)
+ *   --runs <n>         (default: 1)
+ *   --no-lighthouse    (flag)
+ *   --no-coverage      (flag)
+ *   --no-console       (flag)
+ *   --no-dom           (flag)
+ *   --no-network       (flag)
+ *   --no-performance   (flag)
+ *   --no-runtime       (flag)
+ *   --device <name>    (optional)
+ */
+function parseArgs(args) {
+    const options = { ...DEFAULT_RUN_OPTIONS };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--url':
+                if (i + 1 >= args.length) {
+                    console.error('Error: --url requires a value');
+                    return null;
+                }
+                options.url = args[++i];
+                break;
+            case '--output':
+                if (i + 1 >= args.length) {
+                    console.error('Error: --output requires a value');
+                    return null;
+                }
+                options.output = args[++i];
+                break;
+            case '--runs':
+                if (i + 1 >= args.length) {
+                    console.error('Error: --runs requires a value');
+                    return null;
+                }
+                options.runs = parseInt(args[++i], 10);
+                if (isNaN(options.runs) || options.runs < 1) {
+                    console.error('Error: --runs must be a positive integer');
+                    return null;
+                }
+                break;
+            case '--no-lighthouse':
+                options.noLighthouse = true;
+                break;
+            case '--no-coverage':
+                options.noCoverage = true;
+                break;
+            case '--no-console':
+                options.noConsole = true;
+                break;
+            case '--no-dom':
+                options.noDom = true;
+                break;
+            case '--no-network':
+                options.noNetwork = true;
+                break;
+            case '--no-performance':
+                options.noPerformance = true;
+                break;
+            case '--no-runtime':
+                options.noRuntime = true;
+                break;
+            case '--device':
+                if (i + 1 >= args.length) {
+                    console.error('Error: --device requires a value');
+                    return null;
+                }
+                options.mobile = args[++i];
+                break;
+            default:
+                if (arg.startsWith('--')) {
+                    console.error(`Error: Unknown flag "${arg}"`);
+                    return null;
+                }
+                // Ignore positional args for now
+                break;
+        }
+    }
+    if (!options.url) {
+        console.error('Error: --url is required');
+        console.error('Usage: perfgraph collect --url <url> [--output <dir>] [--runs <n>]');
+        return null;
+    }
+    return options;
+}
+//# sourceMappingURL=collect.js.map

package/dist/cli/collect.js.map

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

package/dist/cli/extract.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `extract` subcommand handler.
+ *
+ * Reads a normalised IRBundle JSON file (produced by `perfgraph normalize`)
+ * and runs feature extraction, outputting a FeatureSet as JSON.
+ *
+ * Usage:
+ *   perfgraph extract <ir-file>
+ *   perfgraph extract --input ir.json --output features.json --pretty
+ */
+/** Result of the extract command execution */
+export interface ExtractResult {
+    /** Whether extraction succeeded */
+    success: boolean;
+    /** Path to the input IR file */
+    inputFile: string;
+}
+/**
+ * Run the extract command from an IR file path.
+ *
+ * @param inputFile - Path to IR JSON file
+ * @param outputFile - Optional output file path (defaults to stdout)
+ * @param pretty - Pretty-print JSON (default: false)
+ * @returns ExtractResult
+ */
+export declare function runExtract(inputFile: string, outputFile?: string, pretty?: boolean): Promise<ExtractResult>;
+/**
+ * Parse CLI arguments for the extract command and execute.
+ */
+export declare function runExtractFromArgs(args: string[]): Promise<ExtractResult | null>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/cli/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/cli/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAiCD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,aAAa,CAAC,CAiBxB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA4D/B"}

package/dist/cli/extract.js

@@ -0,0 +1,135 @@
+/**
+ * `extract` subcommand handler.
+ *
+ * Reads a normalised IRBundle JSON file (produced by `perfgraph normalize`)
+ * and runs feature extraction, outputting a FeatureSet as JSON.
+ *
+ * Usage:
+ *   perfgraph extract <ir-file>
+ *   perfgraph extract --input ir.json --output features.json --pretty
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { extract } from '../extract/index.js';
+import { IRBundleSchema } from '../normalize/types.js';
+/** Help text shown by `perfgraph extract --help` */
+const EXTRACT_HELP = `
+EXTRACT OPTIONS
+  <file>                Path to a normalised IR JSON file (positional, required)
+  --input, -i <file>    Path to IR JSON file (alternative to positional)
+  --output, -o <file>   Write output to a file (default: stdout)
+  --pretty              Pretty-print JSON output
+  --help, -h            Show this help message
+
+EXAMPLES
+  perfgraph extract ./ir.json
+  perfgraph extract ./ir.json --output features.json
+  perfgraph extract ./ir.json --pretty
+`;
+/**
+ * Load and validate an IRBundle from a JSON file.
+ */
+function loadIRBundle(filePath) {
+    const resolved = resolve(filePath);
+    if (!existsSync(resolved)) {
+        throw new Error(`Error: File not found: ${filePath}`);
+    }
+    let raw;
+    try {
+        const content = readFileSync(resolved, 'utf-8');
+        raw = JSON.parse(content);
+    }
+    catch (err) {
+        throw new Error(`Error: Failed to parse ${filePath}: ${err.message}`);
+    }
+    // Validate against IRBundleSchema
+    const parsed = IRBundleSchema.safeParse(raw);
+    if (!parsed.success) {
+        const firstIssue = parsed.error.issues[0];
+        throw new Error(`Error: Invalid IRBundle format in ${filePath}: ${firstIssue?.path.join('.') ?? ''} ${firstIssue?.message ?? ''}`);
+    }
+    return parsed.data;
+}
+/**
+ * Run the extract command from an IR file path.
+ *
+ * @param inputFile - Path to IR JSON file
+ * @param outputFile - Optional output file path (defaults to stdout)
+ * @param pretty - Pretty-print JSON (default: false)
+ * @returns ExtractResult
+ */
+export async function runExtract(inputFile, outputFile, pretty) {
+    const bundle = loadIRBundle(inputFile);
+    const features = extract(bundle);
+    const indent = pretty ? 2 : 0;
+    const json = JSON.stringify(features, null, indent);
+    if (outputFile) {
+        const { writeFileSync } = await import('node:fs');
+        writeFileSync(outputFile, json, 'utf-8');
+    }
+    else {
+        console.log(json);
+    }
+    return {
+        success: true,
+        inputFile: resolve(inputFile),
+    };
+}
+/**
+ * Parse CLI arguments for the extract command and execute.
+ */
+export async function runExtractFromArgs(args) {
+    let inputFile;
+    let outputFile;
+    let pretty = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--input':
+            case '-i':
+                if (i + 1 >= args.length) {
+                    console.error('Error: --input requires a value');
+                    return null;
+                }
+                inputFile = args[++i];
+                break;
+            case '--output':
+            case '-o':
+                if (i + 1 >= args.length) {
+                    console.error('Error: --output requires a value');
+                    return null;
+                }
+                outputFile = args[++i];
+                break;
+            case '--pretty':
+                pretty = true;
+                break;
+            case '--help':
+            case '-h':
+                console.log(EXTRACT_HELP);
+                return null;
+            default:
+                if (arg.startsWith('--')) {
+                    console.error(`Error: Unknown flag "${arg}"`);
+                    return null;
+                }
+                // First positional arg is the input file
+                if (!inputFile) {
+                    inputFile = arg;
+                }
+                break;
+        }
+    }
+    if (!inputFile) {
+        console.error('Error: <file> is required (positional or --input)');
+        return null;
+    }
+    try {
+        return await runExtract(inputFile, outputFile, pretty);
+    }
+    catch (err) {
+        console.error(String(err));
+        return null;
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/cli/extract.js.map

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

package/dist/cli/mcp.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `mcp` subcommand handler.
+ *
+ * Starts a MCP (Model Context Protocol) stdio server so that AI agents
+ * (Claude, OpenCode, Cursor, etc.) can invoke perfgraph tools directly.
+ *
+ * Usage:
+ *   perfgraph mcp
+ */
+/**
+ * Parse CLI arguments for the mcp command and execute.
+ */
+export declare function runMcpFromArgs(args: string[]): Promise<boolean>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/cli/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/cli/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBrE"}