@electron-stagewright/plugin-budget 0.0.0-stage → 0.1.0

package/dist/run.js

@@ -0,0 +1,218 @@
+/**
+ * The run document: raw measurements of one build, and the flat summary `check` and `compare` read.
+ *
+ * @module
+ */
+import { readFile } from 'node:fs/promises';
+import { z } from 'zod';
+import { MEMORY_METRICS, PHASES, PROCESS_TYPES } from './budget.js';
+export const RUN_FORMAT = 'electron-stagewright-budget-run';
+export const RUN_SCHEMA_VERSION = 1;
+const stallSchema = z.object({
+    windowMs: z.number(),
+    blockedMs: z.number(),
+    blockedPercent: z.number(),
+    maxStallMs: z.number(),
+    stallsOver50Ms: z.number(),
+    stallsOver100Ms: z.number(),
+});
+const latencySchema = z.object({
+    count: z.number(),
+    p50: z.number(),
+    p95: z.number(),
+    p99: z.number(),
+    max: z.number(),
+});
+const processSchema = z.object({
+    pid: z.number(),
+    type: z.enum(PROCESS_TYPES),
+    name: z.string().optional(),
+    // In the run's `metric`; absent when the OS reader could not see this pid.
+    mb: z.number().optional(),
+    workingSetMb: z.number(),
+});
+const memorySchema = z.object({
+    metric: z.enum(MEMORY_METRICS),
+    processes: z.array(processSchema),
+});
+const measurementSchema = z.object({
+    startup: z.object({ firstWindowMs: z.number() }).optional(),
+    memory: memorySchema.optional(),
+    mainThread: stallSchema.optional(),
+    ipc: latencySchema.optional(),
+    // Why a requested metric is missing, keyed by `startup` / `memory` / `mainThread` / `ipc`.
+    unavailable: z.record(z.string(), z.string()).optional(),
+});
+const bundleEntrySchema = z.object({
+    id: z.string(),
+    path: z.string(),
+    gzip: z.boolean(),
+    files: z.number(),
+    bytes: z.number(),
+    unavailable: z.string().optional(),
+});
+export const runSchema = z.object({
+    format: z.literal(RUN_FORMAT),
+    schema_version: z.literal(RUN_SCHEMA_VERSION),
+    created_at: z.string(),
+    platform: z.string(),
+    arch: z.string(),
+    electron_version: z.string().optional(),
+    label: z.string().optional(),
+    rounds: z.array(z.object({ round: z.number(), phase: z.enum(PHASES), measurement: measurementSchema })),
+    bundle: z.object({ entries: z.array(bundleEntrySchema) }).optional(),
+});
+/** A run file that is missing or is not a run document. */
+export class RunFileError extends Error {
+    runPath;
+    constructor(message, runPath) {
+        super(message);
+        this.runPath = runPath;
+        this.name = 'RunFileError';
+    }
+}
+export async function loadRun(runPath) {
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(runPath, 'utf8'));
+    }
+    catch (error) {
+        throw new RunFileError(`Cannot read run file ${runPath}: ${error instanceof Error ? error.message : String(error)}`, runPath);
+    }
+    const parsed = runSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)
+            .join('; ');
+        throw new RunFileError(`${runPath} is not a ${RUN_FORMAT} document: ${issues}`, runPath);
+    }
+    return parsed.data;
+}
+export function createRun(fields) {
+    return {
+        format: RUN_FORMAT,
+        schema_version: RUN_SCHEMA_VERSION,
+        created_at: (fields.now ?? new Date()).toISOString(),
+        platform: process.platform,
+        arch: process.arch,
+        ...(fields.electronVersion === undefined ? {} : { electron_version: fields.electronVersion }),
+        ...(fields.label === undefined ? {} : { label: fields.label }),
+        rounds: fields.rounds,
+        ...(fields.bundle === undefined ? {} : { bundle: fields.bundle }),
+    };
+}
+const round1 = (value) => Math.round(value * 10) / 10;
+export function median(values) {
+    const sorted = [...values].sort((a, b) => a - b);
+    const middle = Math.floor(sorted.length / 2);
+    const upper = sorted[middle] ?? 0;
+    return sorted.length % 2 === 1 ? upper : ((sorted[middle - 1] ?? upper) + upper) / 2;
+}
+/** Nearest-rank percentiles; an empty set reports zeros with `count: 0`. */
+export function summarizeLatencies(samples) {
+    const sorted = samples.filter(Number.isFinite).sort((a, b) => a - b);
+    const at = (percentile) => round1(sorted[Math.min(sorted.length - 1, Math.ceil((percentile / 100) * sorted.length) - 1)] ?? 0);
+    return { count: sorted.length, p50: at(50), p95: at(95), p99: at(99), max: at(100) };
+}
+/**
+ * Megabytes per process type for one memory sample, in the sample's metric. A type with a pid the
+ * OS reader could not see is left out rather than undercounted.
+ */
+export function memoryByType(memory) {
+    const totals = {};
+    const partial = new Set();
+    for (const entry of memory.processes) {
+        const mb = memory.metric === 'workingSet' ? entry.workingSetMb : entry.mb;
+        if (mb === undefined)
+            partial.add(entry.type);
+        else
+            totals[entry.type] = (totals[entry.type] ?? 0) + mb;
+    }
+    for (const type of partial)
+        delete totals[type];
+    return totals;
+}
+/** Sum of every type the sample holds, or undefined when one of them is unmeasured or none exist. */
+function memoryTotal(memory, skipGpu) {
+    const types = new Set(memory.processes.map((entry) => entry.type));
+    if (skipGpu)
+        types.delete('gpu');
+    if (types.size === 0)
+        return undefined;
+    const totals = memoryByType(memory);
+    let sum = 0;
+    for (const type of types) {
+        const mb = totals[type];
+        if (mb === undefined)
+            return undefined;
+        sum += mb;
+    }
+    return sum;
+}
+/** Flatten a run into comparable rows (`memory.main`, `ipc.p99Ms`, `bundle.<id>`, ...). */
+export function summarizeRun(run) {
+    const rows = [];
+    for (const phase of PHASES) {
+        const measurements = run.rounds.filter((r) => r.phase === phase).map((r) => r.measurement);
+        const push = (id, unit, values, metric) => {
+            const present = values.filter((value) => value !== undefined);
+            if (present.length === 0)
+                return;
+            const exact = median(present);
+            rows.push({
+                id,
+                phase,
+                value: round1(exact),
+                exact,
+                unit,
+                ...(metric === undefined ? {} : { metric }),
+                samples: present.length,
+            });
+        };
+        push('startup.firstWindowMs', 'ms', measurements.map((m) => m.startup?.firstWindowMs));
+        const memories = measurements.flatMap((m) => (m.memory === undefined ? [] : [m.memory]));
+        // Rounds whose OS reader failed fall back to another metric; the majority one is summarised.
+        const counts = new Map();
+        for (const memory of memories)
+            counts.set(memory.metric, (counts.get(memory.metric) ?? 0) + 1);
+        let primary;
+        for (const { metric } of memories) {
+            if (primary === undefined || (counts.get(metric) ?? 0) > (counts.get(primary) ?? 0)) {
+                primary = metric;
+            }
+        }
+        // Working set is always recorded, so a budget may name it on any platform.
+        for (const metric of new Set([primary, 'workingSet'])) {
+            if (metric === undefined)
+                continue;
+            const sameMetric = memories
+                .filter((memory) => memory.metric === primary)
+                .map((memory) => ({ ...memory, metric }));
+            const byType = sameMetric.map(memoryByType);
+            for (const type of PROCESS_TYPES) {
+                push(`memory.${type}`, 'MB', byType.map((totals) => totals[type]), metric);
+            }
+            push('memory.totalWithoutGpu', 'MB', sameMetric.map((memory) => memoryTotal(memory, true)), metric);
+            push('memory.total', 'MB', sameMetric.map((memory) => memoryTotal(memory, false)), metric);
+        }
+        push('mainThread.blockedPercent', '%', measurements.map((m) => m.mainThread?.blockedPercent));
+        push('mainThread.maxStallMs', 'ms', measurements.map((m) => m.mainThread?.maxStallMs));
+        const ipc = measurements.flatMap((m) => (m.ipc !== undefined && m.ipc.count > 0 ? [m.ipc] : []));
+        push('ipc.p95Ms', 'ms', ipc.map((latency) => latency.p95));
+        push('ipc.p99Ms', 'ms', ipc.map((latency) => latency.p99));
+    }
+    for (const entry of run.bundle?.entries ?? []) {
+        if (entry.unavailable !== undefined)
+            continue;
+        rows.push({
+            id: `bundle.${entry.id}`,
+            value: round1(entry.bytes / 1024),
+            exact: entry.bytes / 1024,
+            unit: 'KB',
+            ...(entry.gzip ? { metric: 'gzip' } : {}),
+            samples: 1,
+        });
+    }
+    return rows;
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Measure one live app session through the transport's `evaluate` seam.
+ *
+ * @module
+ */
+import { type HostStartTimeReader, type OsMemoryReader } from './memory.js';
+import { type Measurement } from './run.js';
+/** The slice of a transport session the budget needs. */
+export interface EvaluatingSession {
+    evaluate<T = unknown>(target: 'main' | 'renderer', body: string, arg?: unknown): Promise<T>;
+}
+export interface IpcProbe {
+    readonly probe: string;
+    readonly intervalMs?: number;
+}
+export declare const MAIN_EVAL_OFF = "main eval is off; start the server with --allow-eval=main (or bare --allow-eval)";
+export declare const RENDERER_EVAL_OFF = "renderer eval is off; start the server with bare --allow-eval to measure it";
+/**
+ * Open a measurement window: arm the main-thread sampler and, when a probe is given and renderer
+ * eval is allowed, the IPC probe loop. Returns why the IPC probe did not start, if it did not.
+ */
+export declare function startWindow(session: EvaluatingSession, options: {
+    readonly ipc?: IpcProbe;
+    readonly allowRenderer: boolean;
+    /** Why the renderer is off, when it is not the eval grant. */
+    readonly rendererOff?: string;
+}): Promise<{
+    ipc: boolean;
+    ipcUnavailable?: string;
+}>;
+export interface MeasureOptions {
+    readonly allowRenderer: boolean;
+    readonly rendererOff?: string;
+    /** Set when {@link startWindow} already opened a window; otherwise one is run for `windowMs`. */
+    readonly open?: {
+        readonly ipc: boolean;
+        readonly ipcUnavailable?: string;
+    };
+    readonly windowMs: number;
+    readonly ipc?: IpcProbe;
+    readonly sleep?: (ms: number) => Promise<void>;
+    readonly memoryReader?: OsMemoryReader;
+    readonly hostStartTime?: HostStartTimeReader;
+    /** The renderer grant alone; defaults to `allowRenderer`. */
+    readonly allowStartup?: boolean;
+}
+export interface SessionMeasurement {
+    readonly measurement: Measurement;
+    readonly electronVersion?: string;
+    readonly platform: string;
+}
+/** Close the window (running one first when none is open) and sample memory and startup. */
+export declare function measureSession(session: EvaluatingSession, options: MeasureOptions): Promise<SessionMeasurement>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAA;AAWpB,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AAE/D,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC5F;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,eAAO,MAAM,aAAa,qFAC0D,CAAA;AACpF,eAAO,MAAM,iBAAiB,gFACiD,CAAA;AAI/E;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE;IACP,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B,GACA,OAAO,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBpD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,iGAAiG;IACjG,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,CAAA;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAA;IAC5C,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAChC;AA2BD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,4FAA4F;AAC5F,wBAAsB,cAAc,CAClC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAyG7B"}

package/dist/session.js

@@ -0,0 +1,167 @@
+/**
+ * Measure one live app session through the transport's `evaluate` seam.
+ *
+ * @module
+ */
+import { validateEvalContent } from '@electron-stagewright/core';
+import { measureMemory, osMemoryReader, hostStartTimeReader, } from './memory.js';
+import { DEFAULT_IPC_INTERVAL_MS, IPC_READ_BODY, MAIN_BODY, buildIpcStartBody, } from './probe.js';
+import { summarizeLatencies } from './run.js';
+export const MAIN_EVAL_OFF = 'main eval is off; start the server with --allow-eval=main (or bare --allow-eval)';
+export const RENDERER_EVAL_OFF = 'renderer eval is off; start the server with bare --allow-eval to measure it';
+const message = (error) => (error instanceof Error ? error.message : String(error));
+/**
+ * Open a measurement window: arm the main-thread sampler and, when a probe is given and renderer
+ * eval is allowed, the IPC probe loop. Returns why the IPC probe did not start, if it did not.
+ */
+export async function startWindow(session, options) {
+    await session.evaluate('main', MAIN_BODY, { op: 'start' });
+    if (options.ipc === undefined)
+        return { ipc: false };
+    if (!options.allowRenderer) {
+        return { ipc: false, ipcUnavailable: options.rendererOff ?? RENDERER_EVAL_OFF };
+    }
+    try {
+        // The probe is caller-supplied JavaScript: hold it to the same blocklist as the eval tools.
+        validateEvalContent(options.ipc.probe, { target: 'renderer' });
+    }
+    catch (error) {
+        return { ipc: false, ipcUnavailable: `the IPC probe was refused: ${message(error)}` };
+    }
+    try {
+        await session.evaluate('renderer', buildIpcStartBody(options.ipc.probe), {
+            intervalMs: options.ipc.intervalMs ?? DEFAULT_IPC_INTERVAL_MS,
+        });
+        return { ipc: true };
+    }
+    catch (error) {
+        return { ipc: false, ipcUnavailable: `the IPC probe did not start: ${message(error)}` };
+    }
+}
+/** `ps` start times have whole-second resolution. */
+const START_TIME_TOLERANCE_MS = 2_000;
+/**
+ * Pids come from the app, but the OS reader runs on this host. Refuse to read them when the
+ * host's process with the main pid did not start when the app's main process did.
+ */
+async function hostMismatch(facts, reader) {
+    if (!isPid(facts.pid))
+        return 'the app reported an invalid main pid';
+    if (facts.creationTime === null || reader === undefined)
+        return undefined;
+    const started = await reader(facts.pid);
+    if (started === undefined)
+        return undefined;
+    if (started !== 'missing' && Math.abs(started - facts.creationTime) <= START_TIME_TOLERANCE_MS) {
+        return undefined;
+    }
+    return `pid ${facts.pid} on this host is not the app's main process (another pid namespace?)`;
+}
+/** App-reported pids reach host commands and /proc paths, so only plain pids pass. */
+const isPid = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+/** Close the window (running one first when none is open) and sample memory and startup. */
+export async function measureSession(session, options) {
+    const unavailable = {};
+    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    let open = options.open;
+    if (open === undefined) {
+        open = await startWindow(session, {
+            allowRenderer: options.allowRenderer,
+            ...(options.rendererOff === undefined ? {} : { rendererOff: options.rendererOff }),
+            ...(options.ipc === undefined ? {} : { ipc: options.ipc }),
+        });
+        await sleep(options.windowMs);
+    }
+    const stall = await session.evaluate('main', MAIN_BODY, {
+        op: 'read',
+        stop: true,
+    });
+    // The app restarted its main process mid-window, or the window outlived MAX_WINDOW_MS.
+    if (stall === null)
+        unavailable['mainThread'] = 'the measurement window was lost or expired';
+    let ipc;
+    if (open.ipcUnavailable !== undefined)
+        unavailable['ipc'] = open.ipcUnavailable;
+    if (open.ipc) {
+        try {
+            const read = await session.evaluate('renderer', IPC_READ_BODY, {
+                stop: true,
+            });
+            if (read === null) {
+                unavailable['ipc'] = 'the IPC probe was lost; the window navigated during the measurement';
+            }
+            else if (read.samples.length === 0) {
+                unavailable['ipc'] =
+                    read.lastError === null
+                        ? 'the IPC probe completed no round trip'
+                        : `the IPC probe failed: ${read.lastError}`;
+            }
+            else {
+                ipc = summarizeLatencies(read.samples);
+            }
+        }
+        catch (error) {
+            unavailable['ipc'] = `could not read the IPC probe: ${message(error)}`;
+        }
+    }
+    const facts = await session.evaluate('main', MAIN_BODY, { op: 'facts' });
+    let reader = options.memoryReader ?? osMemoryReader(facts.platform);
+    const mismatch = reader === undefined
+        ? undefined
+        : await hostMismatch(facts, options.hostStartTime ?? hostStartTimeReader(facts.platform));
+    if (mismatch !== undefined) {
+        reader = () => Promise.reject(new Error(mismatch));
+    }
+    const { memory, error: memoryError } = await measureMemory(facts.processes.filter((entry) => isPid(entry.pid)), facts.platform, reader);
+    if (memoryError !== undefined)
+        unavailable['memory'] = memoryError;
+    let startup;
+    if (options.allowStartup === false) {
+        unavailable['startup'] = RENDERER_EVAL_OFF;
+    }
+    else if (options.allowStartup === undefined && !options.allowRenderer) {
+        unavailable['startup'] = options.rendererOff ?? RENDERER_EVAL_OFF;
+    }
+    else if (facts.creationTime === null) {
+        unavailable['startup'] = 'this Electron does not report the process creation time';
+    }
+    else {
+        try {
+            // Read from main so the first window counts, not whichever renderer is selected.
+            const timing = await session.evaluate('main', MAIN_BODY, {
+                op: 'startup',
+            });
+            if ('error' in timing)
+                throw new Error(timing.error);
+            const firstWindowMs = timing.timeOrigin + timing.loadEventEnd - facts.creationTime;
+            // A later document means the first one was left; pushState keeps the document.
+            const navigated = timing.firstUrl !== null ? timing.url !== timing.firstUrl : (timing.historyLength ?? 1) > 1;
+            if (timing.type !== 'navigate' || navigated) {
+                unavailable['startup'] = 'the first window was reloaded or navigated since launch';
+            }
+            else if (!(timing.loadEventEnd > 0) ||
+                !(firstWindowMs > 0) ||
+                !Number.isFinite(firstWindowMs)) {
+                unavailable['startup'] = 'the window has not finished loading';
+            }
+            else {
+                startup = { firstWindowMs: Math.round(firstWindowMs) };
+            }
+        }
+        catch (error) {
+            unavailable['startup'] = `could not read navigation timing: ${message(error)}`;
+        }
+    }
+    return {
+        measurement: {
+            ...(startup === undefined ? {} : { startup }),
+            memory,
+            ...(stall === null ? {} : { mainThread: stall }),
+            ...(ipc === undefined ? {} : { ipc }),
+            ...(Object.keys(unavailable).length === 0 ? {} : { unavailable }),
+        },
+        ...(facts.electron === null ? {} : { electronVersion: facts.electron }),
+        platform: facts.platform,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@electron-stagewright/plugin-budget",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Performance budget plugin for Electron Stagewright: measure startup, per-process memory, main-thread blocking, IPC latency, and bundle size, and gate them against a budget file from an agent or CI.",
+  "type": "module",
+  "license": "MIT",
+  "author": "johnny4young <johnny.iv.young@gmail.com>",
+  "homepage": "https://electron-stagewright.github.io/electron-stagewright/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/electron-stagewright/electron-stagewright.git",
+    "directory": "packages/plugin-budget"
+  },
+  "bugs": {
+    "url": "https://github.com/electron-stagewright/electron-stagewright/issues"
+  },
+  "keywords": [
+    "electron",
+    "mcp",
+    "stagewright",
+    "performance",
+    "performance-budget",
+    "memory",
+    "ai-agent"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "electron-stagewright-budget": "./dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@electron-stagewright/core": "0.9.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@electron-stagewright/testkit": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }