plures 1.12.0 → 1.14.0

package/README.md

@@ -51,7 +51,7 @@ if (event.type === "task.completed" && event.data.result?.agreement === 1) {
 - `plures.maps.createKey(app, { label? })`, `.keys(app)`, `.revokeKey(app, id)`: map keys for CI, which can only read and upload that app's map. `.workflow(app, branch?)` returns the GitHub Action that maps on every push; `npx plures map workflow` writes it to `.github/workflows/plures-map.yml`. Or use **Map with GitHub** on the app's map page and Plures opens the pull request for you, then **Turn on mapping** merges it. `plures.maps.startRun(app)` and `.runs(app)`: in CI with no Claude key, `npx plures map` starts a run where Plures runs Claude (first map free, then Claude's cost plus 30%, at most $5).
 - In your terminal, `npx plures map` opens your map page so you can watch it build (`--no-open` to skip), keeps one live line of what it's reading, and ends by drawing the map's flows with the checks Plures suggests. On GitHub and other CI it prints a plain log.
 - `npx plures map` shows each file as Claude Code reads it and sends the file names (never their contents) to Plures, so the map page shows the reading live and the map builds itself when it lands. `plures.maps.progress(app, { session, phase, events })` is the call behind it.
-- `plures.github.repos()`, `.connect(app, "owner/repo")`, `.turnOn(app)`, `.status(app)`, `.disconnect(app)`: Map with GitHub from code. Plures sets the repo's map key secret and opens a pull request adding the workflow; `turnOn` merges it. Installing the Plures GitHub App needs a browser once (`install_url`). From a terminal: `npx plures map github connect`, then `npx plures map github on`.
+- `plures.github.repos()`, `.connect(app, "owner/repo")`, `.turnOn(app)`, `.run(app)` (map now), `.status(app)`, `.disconnect(app)`: Map with GitHub from code. Plures sets the repo's map key secret and opens a pull request adding the workflow; `turnOn` merges it. Installing the Plures GitHub App needs a browser once (`install_url`). From a terminal: `npx plures map github connect`, then `npx plures map github on`; `npx plures map github run` maps again now.
 - `plures.quality.sample({ rubric, output, input? })`: send every output; a share is graded by people against the rubric, with personal details taken out first. `plures.quality.rubrics.create({ name, question, options, sample_rate })`, `.retrieve(name)` (score by day, this week against the four before, drift), `.list()`, `.update()`, `.del()`. `plures.quality.compare({ release, input, a, b })` and `plures.quality.release(name)` for blind release checks. `plures.quality.export(rubric)` returns graded samples for evals or fine tuning.
 - `plures.testMix.set({ unanimous: 70, split: 20, tie: 5, expired: 5 })`, `.get()`, `.clear()`: with a test key, makes a share of test tasks split, tie or expire at random so you can test routing to your team without changing your agent. A task can override it with `metadata.test_mix`, and `metadata.test_outcome` beats both.
 - `plures.routing.get()`, `plures.routing.set({ groups, rules, team })`: named teams of your own people and rules by category, like `{ groups: [{ name: "Finance", emails: ["ap@acme.com"] }], rules: [{ category: "refunds", route: "team", group: "Finance" }] }`. What you send replaces what's there; the rest stays.

package/dist/{chunk-GDI4KDAH.js → chunk-7OMKME5Z.js}

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.12.0";
+var VERSION = "1.14.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -130,6 +130,8 @@ var Plures = class {
     /** Connects a repo ("owner/name"): sets its map key secret and opens the pull request. */
     connect: (app, repo) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/github`, { repo }),
     /** Turns mapping on by merging the pull request. The repo's own rules (reviews, checks) still apply. */
+    /** Map now: runs the app's map workflow on GitHub. { update: true } first updates an older workflow. Watch it on the map page. */
+    run: (app, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/github/run`, opts),
     turnOn: (app) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/github/merge`, {}),
     /** Revokes the repo's map key. Delete the workflow file in the repo to stop runs. */
     disconnect: (app) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(app)}/github`)

package/dist/cli.cjs

@@ -30,7 +30,7 @@ var import_node_path = require("path");
 var import_node_fs = require("fs");
 
 // src/index.ts
-var VERSION = "1.12.0";
+var VERSION = "1.14.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -161,6 +161,8 @@ var Plures = class {
     /** Connects a repo ("owner/name"): sets its map key secret and opens the pull request. */
     connect: (app2, repo) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app2)}/github`, { repo }),
     /** Turns mapping on by merging the pull request. The repo's own rules (reviews, checks) still apply. */
+    /** Map now: runs the app's map workflow on GitHub. { update: true } first updates an older workflow. Watch it on the map page. */
+    run: (app2, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app2)}/github/run`, opts),
     turnOn: (app2) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app2)}/github/merge`, {}),
     /** Revokes the repo's map key. Delete the workflow file in the repo to stop runs. */
     disconnect: (app2) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(app2)}/github`)
@@ -504,7 +506,8 @@ With plures-mcp connected, just ask: ${cyan("Map this app for Plures")}`);
 `);
   const prompt = `${guide}
 
-Write the map to ${FILE} in the current directory now. Read the code; don't run it or change anything else.`;
+Write the map to ${FILE} in the current directory now, as JSON, with the Write tool. Read the code; don't run it or change anything else. Don't write a script to generate the map: you can't run scripts or other commands here, so write the JSON itself.`;
+  const nudge = `${FILE} doesn't exist yet. Write it now with the Write tool: the complete map as JSON, directly. You can't run scripts or commands here, so don't write one. Use what you've already read.`;
   const live = key ? client() : null;
   const session = (0, import_node_crypto.randomBytes)(12).toString("base64url");
   const source = process.env.GITHUB_ACTIONS ? "github" : "cli";
@@ -530,8 +533,8 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
   let result = "";
   const ticker = fancy ? liveLine() : null;
   ticker?.start();
-  const code = await new Promise((resolve) => {
-    const p = (0, import_node_child_process.spawn)("claude", ["-p", prompt, "--output-format", "stream-json", "--verbose", "--allowedTools", "Read,Grep,Glob,Write,Bash(git rev-parse:*),Bash(git remote:*)"], { stdio: ["ignore", "pipe", "inherit"], env: childEnv });
+  const runClaude = (args) => new Promise((resolve) => {
+    const p = (0, import_node_child_process.spawn)("claude", [...args, "--output-format", "stream-json", "--verbose", "--allowedTools", "Read,Grep,Glob,Write,Bash(git rev-parse:*),Bash(git remote:*)"], { stdio: ["ignore", "pipe", "inherit"], env: childEnv });
     let buf = "";
     p.stdout.on("data", (chunk) => {
       buf += chunk.toString();
@@ -567,18 +570,21 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
     p.on("close", (n) => resolve(n ?? 1));
     p.on("error", () => resolve(1));
   });
+  const wrote = () => (0, import_node_fs.existsSync)(FILE) && (0, import_node_fs.statSync)(FILE).mtimeMs !== before;
+  let code = await runClaude(["-p", prompt]);
+  if (!wrote()) code = await runClaude(["-p", nudge, "--continue"]);
   clearInterval(tick);
   ticker?.stop();
   if (result && !fancy) console.log(`
 ${result.trim()}
 `);
   if (fancy) console.log(`  ${cyan("\u2713")} ${reads} ${reads === 1 ? "file" : "files"} read. ${dim("Sending the map to Plures. No source code is sent.")}`);
-  const ok = code === 0 && (0, import_node_fs.existsSync)(FILE) && (0, import_node_fs.statSync)(FILE).mtimeMs !== before;
+  const ok = code === 0 && wrote();
   if (!ok) {
     phase = "failed";
     await flush();
   } else await flush();
-  if (code !== 0 || !(0, import_node_fs.existsSync)(FILE) || (0, import_node_fs.statSync)(FILE).mtimeMs === before) die(`Claude Code didn't write ${FILE}. Ask it directly, then run npx plures map upload.`);
+  if (!ok) die(`Claude Code didn't write ${FILE}${process.env.CI ? ". This run costs nothing." : `. Ask it directly, then run npx plures map upload.`}`);
   await upload(FILE);
 }
 async function workflow() {
@@ -617,6 +623,20 @@ Turn it on: ${cyan("npx plures map github on")}${app !== "default" ? ` --app ${a
   };
   try {
     if (!action || action === "status") return show(await p.github.status(app));
+    if (action === "run") {
+      let r;
+      try {
+        r = await p.github.run(app);
+      } catch (e) {
+        if (!(e instanceof PluresError && e.type === "workflow_outdated")) throw e;
+        console.log(dim("This repo's map workflow is from before Map now. Updating it, which merges a small change to the workflow file."));
+        r = await p.github.run(app, { update: true });
+      }
+      const url = `${base}/dashboard/apps/${encodeURIComponent(app)}/map`;
+      console.log(`${bold("Mapping now on GitHub.")} Watch it build: ${cyan(url)}`);
+      if (fancy && !noOpen) await openBrowser(url);
+      return void r;
+    }
     if (action === "on") {
       const r = await p.github.turnOn(app);
       console.log(r.already_merged ? "Mapping was already on." : `${bold("Mapping is on.")} The first run is starting on GitHub.`);
@@ -638,7 +658,7 @@ Turn it on: ${cyan("npx plures map github on")}${app !== "default" ? ` --app ${a
 It adds one workflow file. Review it, then turn mapping on with ${cyan("npx plures map github on")}${app !== "default" ? ` --app ${app}` : ""}, or merge it on GitHub.`);
       return;
     }
-    die("npx plures map github [connect [owner/repo] | on | off]");
+    die("npx plures map github [connect [owner/repo] | on | run | off]");
   } catch (e) {
     if (e instanceof PluresError) die(e.message);
     throw e;
@@ -655,6 +675,7 @@ async function main() {
   npx plures map workflow              add a GitHub Action that maps on every push
   npx plures map github connect        let Plures add that Action by pull request
   npx plures map github on             merge it, which turns mapping on
+  npx plures map github run            map now on GitHub, and watch it build
 
 Docs: https://plures.si/docs`);
     return;

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   Plures,
   PluresError,
   VERSION
-} from "./chunk-GDI4KDAH.js";
+} from "./chunk-7OMKME5Z.js";
 
 // src/cli.ts
 import { spawnSync, spawn } from "child_process";
@@ -288,7 +288,8 @@ With plures-mcp connected, just ask: ${cyan("Map this app for Plures")}`);
 `);
   const prompt = `${guide}
 
-Write the map to ${FILE} in the current directory now. Read the code; don't run it or change anything else.`;
+Write the map to ${FILE} in the current directory now, as JSON, with the Write tool. Read the code; don't run it or change anything else. Don't write a script to generate the map: you can't run scripts or other commands here, so write the JSON itself.`;
+  const nudge = `${FILE} doesn't exist yet. Write it now with the Write tool: the complete map as JSON, directly. You can't run scripts or commands here, so don't write one. Use what you've already read.`;
   const live = key ? client() : null;
   const session = randomBytes(12).toString("base64url");
   const source = process.env.GITHUB_ACTIONS ? "github" : "cli";
@@ -314,8 +315,8 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
   let result = "";
   const ticker = fancy ? liveLine() : null;
   ticker?.start();
-  const code = await new Promise((resolve) => {
-    const p = spawn("claude", ["-p", prompt, "--output-format", "stream-json", "--verbose", "--allowedTools", "Read,Grep,Glob,Write,Bash(git rev-parse:*),Bash(git remote:*)"], { stdio: ["ignore", "pipe", "inherit"], env: childEnv });
+  const runClaude = (args) => new Promise((resolve) => {
+    const p = spawn("claude", [...args, "--output-format", "stream-json", "--verbose", "--allowedTools", "Read,Grep,Glob,Write,Bash(git rev-parse:*),Bash(git remote:*)"], { stdio: ["ignore", "pipe", "inherit"], env: childEnv });
     let buf = "";
     p.stdout.on("data", (chunk) => {
       buf += chunk.toString();
@@ -351,18 +352,21 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
     p.on("close", (n) => resolve(n ?? 1));
     p.on("error", () => resolve(1));
   });
+  const wrote = () => existsSync(FILE) && statSync(FILE).mtimeMs !== before;
+  let code = await runClaude(["-p", prompt]);
+  if (!wrote()) code = await runClaude(["-p", nudge, "--continue"]);
   clearInterval(tick);
   ticker?.stop();
   if (result && !fancy) console.log(`
 ${result.trim()}
 `);
   if (fancy) console.log(`  ${cyan("\u2713")} ${reads} ${reads === 1 ? "file" : "files"} read. ${dim("Sending the map to Plures. No source code is sent.")}`);
-  const ok = code === 0 && existsSync(FILE) && statSync(FILE).mtimeMs !== before;
+  const ok = code === 0 && wrote();
   if (!ok) {
     phase = "failed";
     await flush();
   } else await flush();
-  if (code !== 0 || !existsSync(FILE) || statSync(FILE).mtimeMs === before) die(`Claude Code didn't write ${FILE}. Ask it directly, then run npx plures map upload.`);
+  if (!ok) die(`Claude Code didn't write ${FILE}${process.env.CI ? ". This run costs nothing." : `. Ask it directly, then run npx plures map upload.`}`);
   await upload(FILE);
 }
 async function workflow() {
@@ -401,6 +405,20 @@ Turn it on: ${cyan("npx plures map github on")}${app !== "default" ? ` --app ${a
   };
   try {
     if (!action || action === "status") return show(await p.github.status(app));
+    if (action === "run") {
+      let r;
+      try {
+        r = await p.github.run(app);
+      } catch (e) {
+        if (!(e instanceof PluresError && e.type === "workflow_outdated")) throw e;
+        console.log(dim("This repo's map workflow is from before Map now. Updating it, which merges a small change to the workflow file."));
+        r = await p.github.run(app, { update: true });
+      }
+      const url = `${base}/dashboard/apps/${encodeURIComponent(app)}/map`;
+      console.log(`${bold("Mapping now on GitHub.")} Watch it build: ${cyan(url)}`);
+      if (fancy && !noOpen) await openBrowser(url);
+      return void r;
+    }
     if (action === "on") {
       const r = await p.github.turnOn(app);
       console.log(r.already_merged ? "Mapping was already on." : `${bold("Mapping is on.")} The first run is starting on GitHub.`);
@@ -422,7 +440,7 @@ Turn it on: ${cyan("npx plures map github on")}${app !== "default" ? ` --app ${a
 It adds one workflow file. Review it, then turn mapping on with ${cyan("npx plures map github on")}${app !== "default" ? ` --app ${app}` : ""}, or merge it on GitHub.`);
       return;
     }
-    die("npx plures map github [connect [owner/repo] | on | off]");
+    die("npx plures map github [connect [owner/repo] | on | run | off]");
   } catch (e) {
     if (e instanceof PluresError) die(e.message);
     throw e;
@@ -439,6 +457,7 @@ async function main() {
   npx plures map workflow              add a GitHub Action that maps on every push
   npx plures map github connect        let Plures add that Action by pull request
   npx plures map github on             merge it, which turns mapping on
+  npx plures map github run            map now on GitHub, and watch it build
 
 Docs: https://plures.si/docs`);
     return;

package/dist/index.cjs

@@ -26,7 +26,7 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "1.12.0";
+var VERSION = "1.14.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -157,6 +157,8 @@ var Plures = class {
     /** Connects a repo ("owner/name"): sets its map key secret and opens the pull request. */
     connect: (app, repo) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/github`, { repo }),
     /** Turns mapping on by merging the pull request. The repo's own rules (reviews, checks) still apply. */
+    /** Map now: runs the app's map workflow on GitHub. { update: true } first updates an older workflow. Watch it on the map page. */
+    run: (app, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/github/run`, opts),
     turnOn: (app) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/github/merge`, {}),
     /** Revokes the repo's map key. Delete the workflow file in the repo to stop runs. */
     disconnect: (app) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(app)}/github`)

package/dist/index.d.cts

@@ -350,7 +350,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.12.0";
+declare const VERSION = "1.14.0";
 type GitHubLink = {
     object: "github_link";
     app: string;
@@ -550,6 +550,15 @@ declare class Plures {
         /** Connects a repo ("owner/name"): sets its map key secret and opens the pull request. */
         connect: (app: string, repo: string) => Promise<GitHubLink>;
         /** Turns mapping on by merging the pull request. The repo's own rules (reviews, checks) still apply. */
+        /** Map now: runs the app's map workflow on GitHub. { update: true } first updates an older workflow. Watch it on the map page. */
+        run: (app: string, opts?: {
+            update?: boolean;
+        }) => Promise<{
+            object: "map_run_request";
+            app: string;
+            started: true;
+            updated_workflow: boolean;
+        }>;
         turnOn: (app: string) => Promise<{
             object: "github_merge";
             app: string;

package/dist/index.d.ts

@@ -350,7 +350,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.12.0";
+declare const VERSION = "1.14.0";
 type GitHubLink = {
     object: "github_link";
     app: string;
@@ -550,6 +550,15 @@ declare class Plures {
         /** Connects a repo ("owner/name"): sets its map key secret and opens the pull request. */
         connect: (app: string, repo: string) => Promise<GitHubLink>;
         /** Turns mapping on by merging the pull request. The repo's own rules (reviews, checks) still apply. */
+        /** Map now: runs the app's map workflow on GitHub. { update: true } first updates an older workflow. Watch it on the map page. */
+        run: (app: string, opts?: {
+            update?: boolean;
+        }) => Promise<{
+            object: "map_run_request";
+            app: string;
+            started: true;
+            updated_workflow: boolean;
+        }>;
         turnOn: (app: string) => Promise<{
             object: "github_merge";
             app: string;

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   PluresError,
   VERSION,
   index_default
-} from "./chunk-GDI4KDAH.js";
+} from "./chunk-7OMKME5Z.js";
 export {
   Plures,
   PluresError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plures",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "Human judgment as an API for AI agents. Send a decision to ID verified people and get their consensus back.",
   "keywords": [
     "human-in-the-loop",