playhead-cli 0.1.2 → 0.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,SAAS,CAoLvC;AAqBD,6DAA6D;AAC7D,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,SAAS,CAsNvC;AAqBD,6DAA6D;AAC7D,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpD"}

package/dist/shared/version.d.ts

@@ -1,4 +1,2 @@
-/** The ONE version source: package.json. Bundle manifests, the CLI, the MCP server, and
- *  verdict provenance all read this — they can never disagree with the installed package. */
 export declare const PLAYHEAD_VERSION: string;
 //# sourceMappingURL=version.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/shared/version.ts"],"names":[],"mappings":"AAEA;6FAC6F;AAC7F,eAAO,MAAM,gBAAgB,EAAE,MAEtB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/shared/version.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,gBAAgB,EAAE,MAAwC,CAAC"}

package/dist/spec/locators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locators.d.ts","sourceRoot":"","sources":["../../src/spec/locators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CA4DzD;AA0BD,kHAAkH;AAClH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAc7D"}
+{"version":3,"file":"locators.d.ts","sourceRoot":"","sources":["../../src/spec/locators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AA4B/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CA4DzD;AA0BD,kHAAkH;AAClH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAc7D"}

package/dist/spec/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/spec/parse.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAElE,qBAAa,SAAU,SAAQ,KAAK;aAGhB,MAAM,EAAE,MAAM,EAAE;IAFlC,YACE,OAAO,EAAE,MAAM,EACC,MAAM,GAAE,MAAM,EAAO,EAGtC;CACF;AA6BD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAa,GAAG,IAAI,CAYzE;AAED,4FAA4F;AAC5F,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1D"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/spec/parse.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAElE,qBAAa,SAAU,SAAQ,KAAK;aAGhB,MAAM,EAAE,MAAM,EAAE;IAFlC,YACE,OAAO,EAAE,MAAM,EACC,MAAM,GAAE,MAAM,EAAO,EAGtC;CACF;AA6BD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAa,GAAG,IAAI,CAYzE;AAED,4FAA4F;AAC5F,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB1D"}

package/dist/spec/schema.d.ts

@@ -8,6 +8,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cut: "cut";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
     action: z.ZodLiteral<"goto">;
     url: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
@@ -19,6 +20,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cut: "cut";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
     action: z.ZodEnum<{
         click: "click";
         dblclick: "dblclick";
@@ -34,10 +36,12 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cut: "cut";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
     action: z.ZodLiteral<"type">;
     target: z.ZodString;
     text: z.ZodString;
     mask: z.ZodDefault<z.ZodBoolean>;
+    clear: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>, z.ZodObject<{
     caption: z.ZodOptional<z.ZodString>;
     narration: z.ZodOptional<z.ZodString>;
@@ -47,6 +51,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cut: "cut";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
     action: z.ZodLiteral<"press">;
     keys: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
@@ -58,6 +63,45 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cut: "cut";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"rightclick">;
+    target: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    caption: z.ZodOptional<z.ZodString>;
+    narration: z.ZodOptional<z.ZodString>;
+    focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+    shot: z.ZodOptional<z.ZodEnum<{
+        continue: "continue";
+        cut: "cut";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"upload">;
+    target: z.ZodString;
+    file: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    caption: z.ZodOptional<z.ZodString>;
+    narration: z.ZodOptional<z.ZodString>;
+    focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+    shot: z.ZodOptional<z.ZodEnum<{
+        continue: "continue";
+        cut: "cut";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"drag">;
+    target: z.ZodString;
+    to: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    caption: z.ZodOptional<z.ZodString>;
+    narration: z.ZodOptional<z.ZodString>;
+    focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+    shot: z.ZodOptional<z.ZodEnum<{
+        continue: "continue";
+        cut: "cut";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
     action: z.ZodLiteral<"select">;
     target: z.ZodString;
     value: z.ZodString;
@@ -70,6 +114,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cut: "cut";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
     action: z.ZodLiteral<"scroll">;
     target: z.ZodOptional<z.ZodString>;
     by: z.ZodOptional<z.ZodObject<{
@@ -85,11 +130,16 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cut: "cut";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
     action: z.ZodLiteral<"expect">;
-    target: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
     visible: z.ZodOptional<z.ZodBoolean>;
     text: z.ZodOptional<z.ZodString>;
     count: z.ZodOptional<z.ZodNumber>;
+    url: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    checked: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>, z.ZodObject<{
     caption: z.ZodOptional<z.ZodString>;
     narration: z.ZodOptional<z.ZodString>;
@@ -99,6 +149,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         cut: "cut";
     }>>;
     timeout: z.ZodOptional<z.ZodNumber>;
+    optional: z.ZodOptional<z.ZodBoolean>;
     action: z.ZodLiteral<"wait">;
     ms: z.ZodOptional<z.ZodNumber>;
     for: z.ZodOptional<z.ZodString>;
@@ -213,6 +264,165 @@ export declare const specSchema: z.ZodObject<{
             solid: "solid";
         }>>;
     }, z.core.$strict>>>;
+    setup: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodTransform<unknown, Record<string, unknown>>>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"goto">;
+        url: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodEnum<{
+            click: "click";
+            dblclick: "dblclick";
+            hover: "hover";
+        }>;
+        target: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"type">;
+        target: z.ZodString;
+        text: z.ZodString;
+        mask: z.ZodDefault<z.ZodBoolean>;
+        clear: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"press">;
+        keys: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"rightclick">;
+        target: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"upload">;
+        target: z.ZodString;
+        file: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"drag">;
+        target: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"select">;
+        target: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"scroll">;
+        target: z.ZodOptional<z.ZodString>;
+        by: z.ZodOptional<z.ZodObject<{
+            x: z.ZodDefault<z.ZodNumber>;
+            y: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"expect">;
+        target: z.ZodOptional<z.ZodString>;
+        visible: z.ZodOptional<z.ZodBoolean>;
+        text: z.ZodOptional<z.ZodString>;
+        count: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        checked: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        caption: z.ZodOptional<z.ZodString>;
+        narration: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+        shot: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            cut: "cut";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"wait">;
+        ms: z.ZodOptional<z.ZodNumber>;
+        for: z.ZodOptional<z.ZodString>;
+        state: z.ZodDefault<z.ZodEnum<{
+            hidden: "hidden";
+            visible: "visible";
+        }>>;
+    }, z.core.$strict>], "action">>>>;
     scenes: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodOptional<z.ZodString>;
@@ -225,6 +435,7 @@ export declare const specSchema: z.ZodObject<{
                 cut: "cut";
             }>>;
             timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
             action: z.ZodLiteral<"goto">;
             url: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
@@ -236,6 +447,7 @@ export declare const specSchema: z.ZodObject<{
                 cut: "cut";
             }>>;
             timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
             action: z.ZodEnum<{
                 click: "click";
                 dblclick: "dblclick";
@@ -251,10 +463,12 @@ export declare const specSchema: z.ZodObject<{
                 cut: "cut";
             }>>;
             timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
             action: z.ZodLiteral<"type">;
             target: z.ZodString;
             text: z.ZodString;
             mask: z.ZodDefault<z.ZodBoolean>;
+            clear: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>, z.ZodObject<{
             caption: z.ZodOptional<z.ZodString>;
             narration: z.ZodOptional<z.ZodString>;
@@ -264,6 +478,7 @@ export declare const specSchema: z.ZodObject<{
                 cut: "cut";
             }>>;
             timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
             action: z.ZodLiteral<"press">;
             keys: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
@@ -275,6 +490,45 @@ export declare const specSchema: z.ZodObject<{
                 cut: "cut";
             }>>;
             timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"rightclick">;
+            target: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            caption: z.ZodOptional<z.ZodString>;
+            narration: z.ZodOptional<z.ZodString>;
+            focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+            shot: z.ZodOptional<z.ZodEnum<{
+                continue: "continue";
+                cut: "cut";
+            }>>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"upload">;
+            target: z.ZodString;
+            file: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            caption: z.ZodOptional<z.ZodString>;
+            narration: z.ZodOptional<z.ZodString>;
+            focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+            shot: z.ZodOptional<z.ZodEnum<{
+                continue: "continue";
+                cut: "cut";
+            }>>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"drag">;
+            target: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            caption: z.ZodOptional<z.ZodString>;
+            narration: z.ZodOptional<z.ZodString>;
+            focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"target">, z.ZodLiteral<"wide">, z.ZodString]>>;
+            shot: z.ZodOptional<z.ZodEnum<{
+                continue: "continue";
+                cut: "cut";
+            }>>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
             action: z.ZodLiteral<"select">;
             target: z.ZodString;
             value: z.ZodString;
@@ -287,6 +541,7 @@ export declare const specSchema: z.ZodObject<{
                 cut: "cut";
             }>>;
             timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
             action: z.ZodLiteral<"scroll">;
             target: z.ZodOptional<z.ZodString>;
             by: z.ZodOptional<z.ZodObject<{
@@ -302,11 +557,16 @@ export declare const specSchema: z.ZodObject<{
                 cut: "cut";
             }>>;
             timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
             action: z.ZodLiteral<"expect">;
-            target: z.ZodString;
+            target: z.ZodOptional<z.ZodString>;
             visible: z.ZodOptional<z.ZodBoolean>;
             text: z.ZodOptional<z.ZodString>;
             count: z.ZodOptional<z.ZodNumber>;
+            url: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            checked: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>, z.ZodObject<{
             caption: z.ZodOptional<z.ZodString>;
             narration: z.ZodOptional<z.ZodString>;
@@ -316,6 +576,7 @@ export declare const specSchema: z.ZodObject<{
                 cut: "cut";
             }>>;
             timeout: z.ZodOptional<z.ZodNumber>;
+            optional: z.ZodOptional<z.ZodBoolean>;
             action: z.ZodLiteral<"wait">;
             ms: z.ZodOptional<z.ZodNumber>;
             for: z.ZodOptional<z.ZodString>;

package/dist/spec/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/spec/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8GxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BASrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAmD9C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAazD;AA+BD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiKZ,CAAC;AAEZ,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3C,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAChD,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;AAE9C,iGAAiG;AACjG,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAIhH,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAEpE;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAEtE;AAED,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,EAAE,CAUxD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/spec/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0IxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAYrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAmD9C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAazD;AA+BD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsLZ,CAAC;AAEZ,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3C,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAChD,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;AAE9C,iGAAiG;AACjG,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAIhH,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAEpE;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAEtE;AAED,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,EAAE,CAUxD"}

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

@@ -1 +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"}
+{"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,CAyElF;AAED,qEAAqE;AACrE,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA2FhF;AAED,+EAA+E;AAC/E,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAgG/E;AAED,oFAAoF;AACpF,wBAAsB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAuD5E;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,CA+FzE;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,CAsFzE;AAkBD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAwDhF"}

package/dist/verify/report.d.ts

@@ -1,12 +1,39 @@
-import type { Verdict } from './types.js';
+import type { Verdict, VerdictSignature } 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.
+ * The canonical signable payload. Round-2 audit: the v1 payload signed only {id, status} per
+ * check — evidence text, the contact sheet, the compose manifest, and the failure reason were
+ * all rewritable after signing. v2 covers everything a consumer relies on. 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;
+/**
+ * Sign a verdict. Two schemes, resolved from the environment:
+ * - PLAYHEAD_SIGNING_KEY_FILE → Ed25519 (asymmetric): consumers verify against the public key
+ *   and PIN the key id — the producer cannot be impersonated by anyone who can merely verify.
+ *   Generate a key with `playhead keygen`.
+ * - PLAYHEAD_SIGNING_KEY → HMAC-SHA256 (symmetric, zero-config): tamper-evidence only; anyone
+ *   holding the key can also mint verdicts. Fine within one trust domain.
+ * Ed25519 wins when both are set. Returns null when neither is configured.
+ */
+export declare function signVerdict(v: Omit<Verdict, 'signature'>, env?: {
+    hmacKey?: string;
+    keyFile?: string;
+}): VerdictSignature | null;
+/** Verify a verdict's signature. For Ed25519 the embedded public key is used — this proves the
+ *  verdict is INTACT and was signed by the holder of keyId's private key; whether that key is
+ *  trusted is the consumer's pinning decision. For HS256 the shared key must be provided. */
+export declare function verifySignature(v: Verdict, opts?: {
+    hmacKey?: string;
+}): {
+    valid: boolean;
+    reason: string;
+};
+export declare function keyIdFor(material: Buffer): string;
 /** JUnit XML: one testsuite per verdict, one testcase per check — the shape every CI ingests. */
 export declare function toJUnit(v: Verdict, suiteName?: string): string;
+/** JUnit for a FLOW failure (the app broke; no verdict exists) — CI still gets a report. */
+export declare function flowFailureJUnit(failure: {
+    stepRef: string;
+    message: string;
+}, suiteName?: string): string;
 //# sourceMappingURL=report.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/verify/report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,MAAM,CA4BrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAC7B,GAAG,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAGxC,GACA,gBAAgB,GAAG,IAAI,CAqBzB;AAED;;6FAE6F;AAC7F,wBAAgB,eAAe,CAC7B,CAAC,EAAE,OAAO,EACV,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAwBpC;AAOD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,iGAAiG;AACjG,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,SAAa,GAAG,MAAM,CAqBlE;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,SAAa,GAAG,MAAM,CAQ9G"}

package/dist/verify/runner.d.ts

@@ -2,7 +2,7 @@ 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 declare const CHECK_SUITE_VERSION = "playhead/checks@3";
 export interface VerifyOptions {
     outDir: string;
     vision?: boolean;

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

@@ -1 +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"}
+{"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,CAuFlB;AAED,mFAAmF;AACnF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAMhF"}

package/dist/verify/types.d.ts

@@ -11,6 +11,13 @@ export interface CheckResult {
     status: CheckStatus;
     details: string;
     evidence?: CheckEvidence[];
+    /** For pixel-grounded checks: how many items were actually verified against pixels vs the
+     *  total in scope — feeds the verdict's coverage metric so "all skipped" can never read
+     *  identically to "fully verified". */
+    coverage?: {
+        verified: number;
+        total: number;
+    };
 }
 export interface VerifyContext {
     bundle: BundleData;
@@ -35,8 +42,19 @@ export interface VerdictProvenance {
         message: string;
     };
 }
+/** How the verdict is signed. Ed25519 (asymmetric, `playhead keygen` + PLAYHEAD_SIGNING_KEY_FILE)
+ *  lets consumers pin a key id; HS256 (PLAYHEAD_SIGNING_KEY) is zero-config tamper-evidence
+ *  within one trust domain. */
+export interface VerdictSignature {
+    alg: 'Ed25519' | 'HS256';
+    /** sha256 of the key material, first 16 hex — what consumers pin. */
+    keyId: string;
+    /** Ed25519 only: SPKI DER, base64 — the verdict is self-verifiable; trust is the pin. */
+    publicKey?: string;
+    value: string;
+}
 export interface Verdict {
-    schema: 'playhead/verdict@2';
+    schema: 'playhead/verdict@3';
     verdict: 'publishable' | 'not-publishable';
     video: {
         path: string;
@@ -46,6 +64,21 @@ export interface Verdict {
         events: string;
         framesIndex: string;
     };
+    /** sha256 of the compose manifest the checks consulted — the plan is part of the evidence. */
+    manifestHash: string;
+    /** sha256 of the contact-sheet PNG bytes. */
+    contactSheetSha256: string;
+    /** What was actually pixel-verified vs merely planned — a verdict with zero coverage is
+     *  visibly weaker than a fully verified one, even when both say "publishable". */
+    coverage: {
+        /** Effectful actions whose on-screen effect passed pixel verification. */
+        actionsVerified: number;
+        actionsTotal: number;
+        /** Output-frame regions that matched their planned source regions. */
+        outputSamplesVerified: number;
+        checksSkipped: number;
+        checksWarned: number;
+    };
     provenance: VerdictProvenance;
     checks: CheckResult[];
     contactSheet: string;
@@ -56,8 +89,7 @@ export interface Verdict {
             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;
+    /** Null when no signing key is configured — unsigned is explicit, never implied. */
+    signature: VerdictSignature | null;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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"}
+{"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;IAC3B;;2CAEuC;IACvC,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;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;;+BAE+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC;IACzB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;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,8FAA8F;IAC9F,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,kBAAkB,EAAE,MAAM,CAAC;IAC3B;sFACkF;IAClF,QAAQ,EAAE;QACR,0EAA0E;QAC1E,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,sEAAsE;QACtE,qBAAqB,EAAE,MAAM,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,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,oFAAoF;IACpF,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playhead-cli",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Product video as a build artifact: spec + live product → finished, verified video.",
   "license": "MIT",
   "type": "module",