playhead-cli 0.1.0

package/dist/verify/checks.d.ts

@@ -0,0 +1,27 @@
+import type { VerifyContext, CheckResult } from './types.js';
+/** 1. Every target legibly in frame around its action beat. */
+export declare function checkTargetInFrame(ctx: VerifyContext): Promise<CheckResult>;
+/** 2. Rendered cursor sits on the target at each click beat. */
+export declare function checkCursorOnTarget(ctx: VerifyContext): Promise<CheckResult>;
+/** 3. Every action visibly changed the UI (dead-click detection). */
+export declare function checkActionEffect(ctx: VerifyContext): Promise<CheckResult>;
+/** 4. No unplanned frozen footage, no blank frames, in the delivered video. */
+export declare function checkFrozenBlank(ctx: VerifyContext): Promise<CheckResult>;
+/** 5. Captions legible: no truncation, font floor respected, inside safe bounds. */
+export declare function checkCaptions(ctx: VerifyContext): Promise<CheckResult>;
+/** 6. Pacing sanity: steps get readable screen time; total duration sane. */
+export declare function checkPacing(ctx: VerifyContext): Promise<CheckResult>;
+/** 7. The MP4 itself is intact and matches the manifest. */
+/** 9. Narration audio: when the video was narrated, the track must exist, be audible, and span the video. */
+export declare function checkAudio(ctx: VerifyContext): Promise<CheckResult>;
+export declare function checkEncode(ctx: VerifyContext): Promise<CheckResult>;
+/** 8. Masking held: masked regions are covered in footage, secrets absent from the log. */
+export declare function checkMasks(ctx: VerifyContext): Promise<CheckResult>;
+/**
+ * 10. The DELIVERED pixels match the plan: for sampled steps, the region of the output MP4
+ * where the subject should be must correlate with the same region of the source bundle frame.
+ * Every geometry check above re-runs the planner's math — this one closes the plan-vs-pixels
+ * hole: a renderer drawing the wrong frame or the wrong crop fails HERE.
+ */
+export declare function checkOutputPixels(ctx: VerifyContext): Promise<CheckResult>;
+//# sourceMappingURL=checks.d.ts.map

package/dist/verify/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../src/verify/checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAmC5E,+DAA+D;AAC/D,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA4DjF;AAED,gEAAgE;AAChE,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA4BlF;AAED,qEAAqE;AACrE,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAuFhF;AAED,+EAA+E;AAC/E,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAwE/E;AAED,oFAAoF;AACpF,wBAAsB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB5E;AAED,6EAA6E;AAC7E,wBAAsB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAc1E;AAED,4DAA4D;AAC5D,6GAA6G;AAC7G,wBAAsB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA8EzE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB1E;AAED,2FAA2F;AAC3F,wBAAsB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAgDzE;AAkBD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAwDhF"}

package/dist/verify/contact-sheet.d.ts

@@ -0,0 +1,7 @@
+import type { ComposeManifest } from '../compose/types.js';
+/**
+ * Contact sheet: one tile per step at its action beat (decoded from the OUTPUT video —
+ * what viewers actually see) plus first and last frames, annotated with captions.
+ */
+export declare function renderContactSheet(manifest: ComposeManifest, videoPath: string, outPath: string): Promise<string>;
+//# sourceMappingURL=contact-sheet.d.ts.map

package/dist/verify/contact-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-sheet.d.ts","sourceRoot":"","sources":["../../src/verify/contact-sheet.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAU3D;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAiEjB"}

package/dist/verify/media.d.ts

@@ -0,0 +1,42 @@
+import type { BundleData } from '../bundle/types.js';
+/** Extract grayscale frames from the output video at a fixed rate. */
+export declare function extractGrayFrames(videoPath: string, fps: number, w: number, h: number): Promise<{
+    frames: Buffer[];
+    intervalMs: number;
+}>;
+/** Extract one PNG frame from the output video at a timestamp (ms). */
+export declare function extractFrameAt(videoPath: string, tMs: number): Promise<Buffer>;
+export interface ProbeInfo {
+    codec: string;
+    width: number;
+    height: number;
+    durationSec: number;
+    fps: number;
+}
+export declare function probeVideo(videoPath: string): Promise<ProbeInfo>;
+export declare function meanAbsDiff(a: Buffer, b: Buffer): number;
+export declare function variance(a: Buffer): number;
+/** Decode a capture-bundle source frame to grayscale at reduced width. */
+export declare function sourceFrameGray(bundle: BundleData, tMs: number, width: number): Promise<{
+    data: Buffer;
+    w: number;
+    h: number;
+    frameT: number;
+}>;
+/** Decode a region of a source frame (frame px) to grayscale raw. */
+export declare function sourceRegionGray(bundle: BundleData, tMs: number, region: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}, preferAfter?: boolean, color?: boolean): Promise<Buffer | null>;
+/** Crop a region from PNG bytes (or an image file), grayscale, resize to 48x48 raw. */
+export declare function regionGray48(input: Buffer | string, rect: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}): Promise<Buffer | null>;
+/** Normalized cross-correlation of two equal-length gray buffers, in [-1, 1]. */
+export declare function normalizedCorrelation(a: Buffer, b: Buffer): number;
+//# sourceMappingURL=media.d.ts.map

package/dist/verify/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/verify/media.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,sEAAsE;AACtE,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBnD;AAED,uEAAuE;AACvE,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcpF;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAuBtE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO1C;AAED,0EAA0E;AAC1E,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAQjE;AAED,qEAAqE;AACrE,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACtD,WAAW,UAAQ,EACnB,KAAK,UAAQ,GACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBxB;AAED,uFAAuF;AACvF,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAevI;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBlE"}

package/dist/verify/report.d.ts

@@ -0,0 +1,12 @@
+import type { Verdict } from './types.js';
+/**
+ * The canonical signable payload: everything that makes the verdict a CLAIM (result, artifact
+ * hashes, provenance, per-check outcomes), in a fixed key order. Paths are excluded — moving
+ * files doesn't change what was proven.
+ */
+export declare function signablePayload(v: Omit<Verdict, 'signature'>): string;
+/** HMAC-SHA256 signature over the canonical payload; null when no key is configured. */
+export declare function signVerdict(v: Omit<Verdict, 'signature'>, key?: string | undefined): string | null;
+/** JUnit XML: one testsuite per verdict, one testcase per check — the shape every CI ingests. */
+export declare function toJUnit(v: Verdict, suiteName?: string): string;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/verify/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,MAAM,CAkBrE;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,GAAG,qBAAmC,GAAG,MAAM,GAAG,IAAI,CAGhH;AAED,iGAAiG;AACjG,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,SAAa,GAAG,MAAM,CAuBlE"}

package/dist/verify/runner.d.ts

@@ -0,0 +1,13 @@
+import type { BundleData } from '../bundle/types.js';
+import type { ComposeManifest } from '../compose/types.js';
+import type { Verdict } from './types.js';
+/** Bumped whenever a check is added or its semantics change — part of provenance. */
+export declare const CHECK_SUITE_VERSION = "playhead/checks@2";
+export interface VerifyOptions {
+    outDir: string;
+    vision?: boolean;
+}
+export declare function verify(bundle: BundleData, manifest: ComposeManifest, videoPath: string, opts: VerifyOptions): Promise<Verdict>;
+/** Re-load a compose manifest from disk (for `playhead verify <bundle> <mp4>`). */
+export declare function loadComposeManifest(path: string): Promise<ComposeManifest>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/verify/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/verify/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAe,OAAO,EAAiB,MAAM,YAAY,CAAC;AAsBtE,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,MAAM,CAC1B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,OAAO,CAAC,CAiElB;AAED,mFAAmF;AACnF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAMhF"}

package/dist/verify/types.d.ts

@@ -0,0 +1,63 @@
+import type { BundleData } from '../bundle/types.js';
+import type { ComposeManifest } from '../compose/types.js';
+export type CheckStatus = 'pass' | 'fail' | 'warn' | 'skip';
+export interface CheckEvidence {
+    stepRef?: string;
+    t?: number;
+    note: string;
+}
+export interface CheckResult {
+    id: string;
+    status: CheckStatus;
+    details: string;
+    evidence?: CheckEvidence[];
+}
+export interface VerifyContext {
+    bundle: BundleData;
+    manifest: ComposeManifest;
+    videoPath: string;
+    outDir: string;
+}
+/** Who/what/when produced this verdict — the difference between a claim and evidence. */
+export interface VerdictProvenance {
+    playheadVersion: string;
+    /** Hash of the spec as executed (from the bundle). */
+    specHash: string;
+    appUrl: string;
+    capturedAt: string;
+    verifiedAt: string;
+    checkSuiteVersion: string;
+    host: string;
+    /** Present when this verdict covers a FAILED capture's partial bundle / failure clip. */
+    partial?: boolean;
+    failure?: {
+        stepRef: string;
+        message: string;
+    };
+}
+export interface Verdict {
+    schema: 'playhead/verdict@2';
+    verdict: 'publishable' | 'not-publishable';
+    video: {
+        path: string;
+        sha256: string;
+    };
+    bundleHashes: {
+        events: string;
+        framesIndex: string;
+    };
+    provenance: VerdictProvenance;
+    checks: CheckResult[];
+    contactSheet: string;
+    vision: {
+        model: string;
+        findings: {
+            severity: string;
+            note: string;
+        }[];
+    } | null;
+    /** HMAC-SHA256 over the canonical signable payload, keyed by PLAYHEAD_SIGNING_KEY.
+     *  Null when no key is configured — an unsigned verdict is explicit, never implied. */
+    signature: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/verify/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAC3C,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACjF;2FACuF;IACvF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/verify/vision.d.ts

@@ -0,0 +1,19 @@
+import type { CheckResult } from './types.js';
+import type { ComposeManifest } from '../compose/types.js';
+export interface VisionReview {
+    model: string;
+    findings: {
+        severity: string;
+        note: string;
+    }[];
+}
+/**
+ * Optional AI review: sends the contact sheet to Claude for a judgment call the
+ * deterministic checks can't make ("does this read as a coherent, professional
+ * walkthrough?"). Advisory only — findings become warn-level check entries.
+ */
+export declare function visionReview(contactSheetPath: string, manifest: ComposeManifest): Promise<{
+    check: CheckResult;
+    review: VisionReview | null;
+}>;
+//# sourceMappingURL=vision.d.ts.map

package/dist/verify/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../src/verify/vision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,CAAC,CA0E9D"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "playhead-cli",
+  "version": "0.1.0",
+  "description": "Product video as a build artifact: spec + live product → finished, verified video.",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "video",
+    "demo",
+    "walkthrough",
+    "playwright",
+    "screen-recording",
+    "verified",
+    "ci",
+    "documentation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cypher-aman/playhead.git"
+  },
+  "homepage": "https://playheadhq.com",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "playhead": "./dist/cli/index.js",
+    "playhead-mcp": "./dist/mcp/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "action.yml",
+    "Dockerfile",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "demo": "node demo/server.mjs",
+    "playhead": "tsx src/cli/index.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.123.0",
+    "@expo-google-fonts/inter": "^0.4.2",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@napi-rs/canvas": "^1.0.8",
+    "commander": "^15.0.0",
+    "ffmpeg-static": "^5.3.0",
+    "ffprobe-static": "^3.1.0",
+    "picocolors": "^1.1.1",
+    "playwright": "^1.62.1",
+    "sharp": "^0.35.4",
+    "yaml": "^2.9.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "tsup": "^8.5.1",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2",
+    "vitest": "^3.2.7"
+  }
+}