playhead-cli 0.1.0 → 0.1.1

package/README.md

@@ -60,8 +60,7 @@ write a grounded spec, render it, and read the verdict — inside your own repo.
 
 Tools the agent gets: `playhead_explore` (grounded, validated locators for the current
 screen), `playhead_validate_spec` (schema + locator check, no render), `playhead_author`
-(auto-draft a spec toward a goal), and `playhead_render` (capture → compose → verify,
-returning the publish/no-publish verdict with reasons and artifact paths). The agent's loop
+(auto-draft a spec toward a goal), playhead_render` (capture → compose → verify, returning the verdict with reasons and artifact paths), and `playhead_jira` (attach the evidence + post a verdict comment to an existing issue). The agent's loop
 becomes: *explore → write spec → render → read verdict → fix → re-render.*
 
 Outputs land in `out/`:

package/dist/cli/index.js

@@ -6163,7 +6163,7 @@ function buildServer() {
   const server = new McpServer(
     { name: "playhead", version: PLAYHEAD_VERSION },
     {
-      instructions: "Playhead turns a spec + a live web app into a verified walkthrough video. To make a demo: (1) call playhead_explore on the running app to get validated locators, (2) write a spec (or call playhead_author), (3) call playhead_render and read the verdict \u2014 fix the spec if it is not publishable. Every locator you use MUST come from an explore catalog."
+      instructions: "Playhead turns a spec + a live web app into a verified walkthrough video. To make a demo: (1) call playhead_explore on the running app to get validated locators, (2) write a spec (or call playhead_author), (3) call playhead_render and read the verdict \u2014 fix the spec if it is not publishable. Every locator you use MUST come from an explore catalog. To attach the result to a ticket, call playhead_jira with the same outDir after rendering."
     }
   );
   const dims = z2.string().regex(/^\d+x\d+$/).default("1280x720");
@@ -6279,6 +6279,35 @@ ${formatValidateResult2(res)}` }],
       };
     }
   );
+  server.registerTool(
+    "playhead_jira",
+    {
+      title: "Post render evidence to Jira",
+      description: "Attach a render's evidence to an EXISTING Jira issue and post a verdict comment \u2014 the video (or failure clip), verdict.json, contact sheet, JUnit, and console log, plus a comment carrying the per-check table (or the failing step + error for a flow failure). Run this AFTER playhead_render, pointing outDir at the same directory. Reports to existing issues only (never creates them). Requires JIRA_BASE_URL, JIRA_EMAIL, and JIRA_API_TOKEN in the environment \u2014 Playhead never handles a password.",
+      inputSchema: {
+        issueKey: z2.string().describe("the existing Jira issue key, e.g. PROJ-123"),
+        outDir: z2.string().default("playhead-out").describe("the render output directory (same one passed to playhead_render)")
+      }
+    },
+    async ({ issueKey, outDir }) => {
+      try {
+        const { reportToJira: reportToJira2, collectEvidence: collectEvidence2 } = await Promise.resolve().then(() => (init_jira(), jira_exports));
+        const out = resolve(outDir);
+        await reportToJira2(issueKey, out);
+        const ev = await collectEvidence2(out);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Posted to ${issueKey}: attached ${ev.files.length} artifact(s) [${ev.files.map((f) => f.split("/").pop()).join(", ")}] and a ${ev.outcome} verdict comment.`
+            }
+          ]
+        };
+      } catch (e) {
+        return { content: [{ type: "text", text: `\u2717 Jira report failed: ${e.message}` }], isError: true };
+      }
+    }
+  );
   return server;
 }
 function renderVerdictReport(verdict, videoPath, manifestPath) {