plures 1.11.0 → 1.13.0

package/README.md

@@ -49,8 +49,9 @@ if (event.type === "task.completed" && event.data.result?.agreement === 1) {
 - `new Plures(key, { app: "support-agent" })` or `PLURES_APP`: send everything to one of your apps. `plures.apps.list()`, `.create({ name, id? })`, `.retrieve(id)`, `.update(id, { name?, id?, default? })`, `.del(id)`. Each app keeps its own tasks, ledger view, map and quality.
 - `plures.maps.guide()`, `.retrieve(app)`, `.upload(app, map)`, `.setCheckpoint(app, id, status)`: the agent map, where your agent needs a person. Or run `npx plures map` in your repo: your own coding agent reads the code and only the map is sent.
 - `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-WPSUIAVZ.js → chunk-GIOZT6FB.js}

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.11.0";
+var VERSION = "1.13.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

@@ -1,5 +1,27 @@
 #!/usr/bin/env node
 "use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key2 of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key2) && key2 !== except)
+        __defProp(to, key2, { get: () => from[key2], enumerable: !(desc = __getOwnPropDesc(from, key2)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 
 // src/cli.ts
 var import_node_child_process = require("child_process");
@@ -8,7 +30,7 @@ var import_node_path = require("path");
 var import_node_fs = require("fs");
 
 // src/index.ts
-var VERSION = "1.11.0";
+var VERSION = "1.13.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -139,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`)
@@ -205,6 +229,178 @@ function timingSafeEqual(a, b) {
 }
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 
+// src/term.ts
+var out = process.stdout;
+var fancy = Boolean(out.isTTY && !process.env.NO_COLOR && !process.env.CI && process.env.TERM !== "dumb");
+var rgb = (r, g, b) => (s) => `\x1B[38;2;${r};${g};${b}m${s}\x1B[0m`;
+var LANES = [rgb(91, 75, 255), rgb(74, 107, 250), rgb(50, 144, 238), rgb(25, 198, 230)];
+var C = {
+  text: rgb(243, 244, 247),
+  dim: rgb(110, 116, 136),
+  mute: rgb(160, 166, 186),
+  coral: rgb(255, 142, 122),
+  violet: rgb(185, 180, 255),
+  cyan: rgb(127, 227, 244),
+  amber: rgb(245, 184, 74),
+  bold: (s) => `\x1B[1m${s}\x1B[22m`
+};
+var width = () => Math.max(40, Math.min(out.columns || 80, 110));
+var visible = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+var cut = (s, n) => s.length > n ? `${s.slice(0, Math.max(1, n - 1))}\u2026` : s;
+function banner(app2, where) {
+  const bar = LANES.map((c2, i) => c2("\u2501".repeat(8 - i))).join(" ");
+  out.write(`
+  ${bar}
+
+  ${C.bold(C.text("Plures"))} ${C.dim("map")}  ${C.mute(app2)}
+  ${C.dim(where)}
+
+`);
+}
+function liveLine() {
+  const frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+  let i = 0, count = 0, file = "", phase = "reading", timer = null;
+  const draw = () => {
+    const spin = LANES[Math.floor(i / 2) % 4](frames[i % frames.length]);
+    i++;
+    const left = phase === "drawing" ? `  ${spin} ${C.violet("Drawing the map")}  ${C.dim(`from ${count} ${count === 1 ? "file" : "files"}`)}` : `  ${spin} ${C.bold(C.text(String(count).padStart(3)))} ${C.dim(count === 1 ? "file read " : "files read")}  `;
+    const room = width() - visible(left).length - 2;
+    const f = phase === "reading" && file ? (() => {
+      const slash = file.lastIndexOf("/");
+      const s = cut(file, room);
+      return slash >= 0 && s === file ? `${C.dim(file.slice(0, slash + 1))}${C.text(file.slice(slash + 1))}` : C.text(s);
+    })() : "";
+    out.write(`\r\x1B[K${left}${f}`);
+  };
+  return {
+    start() {
+      out.write("\x1B[?25l");
+      draw();
+      timer = setInterval(draw, 80);
+    },
+    read(path) {
+      count++;
+      file = path;
+    },
+    drawing() {
+      phase = "drawing";
+    },
+    stop() {
+      if (timer) clearInterval(timer);
+      timer = null;
+      out.write("\r\x1B[K\x1B[?25h");
+    },
+    get count() {
+      return count;
+    }
+  };
+}
+if (fancy) for (const sig of ["SIGINT", "SIGTERM"]) process.once(sig, () => {
+  out.write("\x1B[?25h\n");
+  process.exit(130);
+});
+var ICON = { input: "\u25B8", model: "\u25CE", tool: "\u2315", decision: "\u25C7", action: "\u2197", data: "\u25A4", output: "\u21A6", human: "\u263A" };
+function drawMap(m, url) {
+  const nodes = new Map(m.nodes.map((n) => [n.id, n]));
+  const cps = new Map(m.checkpoints.filter((c2) => c2.status !== "dismissed").map((c2) => [c2.at, c2]));
+  const W = width();
+  const nb = new Map(m.nodes.map((n) => [n.id, []]));
+  for (const e of m.edges) {
+    nb.get(e.from)?.push(e.to);
+    nb.get(e.to)?.push(e.from);
+  }
+  const seen = /* @__PURE__ */ new Set(), flows = [];
+  for (const n of m.nodes) {
+    if (seen.has(n.id)) continue;
+    const part = [], st = [n.id];
+    seen.add(n.id);
+    while (st.length) {
+      const v = st.pop();
+      part.push(v);
+      for (const w of nb.get(v) ?? []) if (!seen.has(w)) {
+        seen.add(w);
+        st.push(w);
+      }
+    }
+    flows.push(m.nodes.map((x) => x.id).filter((id) => part.includes(id)));
+  }
+  const chip = (id) => {
+    const n = nodes.get(id), c2 = cps.get(id);
+    const label = cut(n.label, 34);
+    const tag = !c2 ? "" : c2.status === "added" ? `  ${C.cyan("\u2713 checked")}` : `  ${C.violet("\u25CC check suggested")}`;
+    if (n.kind === "action") {
+      if (c2?.status === "added") return `${C.cyan(ICON.action)} ${C.text(label)}${tag}`;
+      const risky = n.risk === "high" || n.risk === "medium";
+      return `${risky ? C.coral(ICON.action) : C.mute(ICON.action)} ${risky ? C.coral(label) : C.mute(label)}${tag}`;
+    }
+    return `${C.dim(ICON[n.kind] ?? "\xB7")} ${C.mute(label)}${tag}`;
+  };
+  out.write("\n");
+  for (const ids of flows.filter((f) => f.length > 1)) {
+    const set = new Set(ids);
+    const es = m.edges.filter((e) => set.has(e.from) && set.has(e.to));
+    const layer = new Map(ids.map((id) => [id, 0]));
+    const order = [], state = /* @__PURE__ */ new Map(), back = /* @__PURE__ */ new Set();
+    const visit = (v) => {
+      state.set(v, 1);
+      for (const e of es.filter((x) => x.from === v)) {
+        if (state.get(e.to) === 1) back.add(`${v}>${e.to}`);
+        else if (!state.get(e.to)) visit(e.to);
+      }
+      state.set(v, 2);
+      order.push(v);
+    };
+    for (const id of ids) if (!state.get(id)) visit(id);
+    for (const v of order.reverse()) for (const e of es) if (e.from === v && !back.has(`${v}>${e.to}`)) layer.set(e.to, Math.max(layer.get(e.to), layer.get(v) + 1));
+    const rows = [];
+    for (const id of ids) (rows[layer.get(id)] ??= []).push(id);
+    const root = rows[0]?.length === 1 ? rows[0][0] : null;
+    out.write(`  ${LANES[flows.indexOf(ids) % 4]("\u25CF")} ${C.bold(C.text(cut(root ? nodes.get(root).label : "Flow", W - 6)))}
+`);
+    rows.forEach((row, ri) => {
+      if (!row || ri === 0 && root) return;
+      const lines = [[]];
+      let used = 6;
+      for (const id of row) {
+        const w = visible(chip(id)).length + 4;
+        if (used + w > W && lines[lines.length - 1].length) {
+          lines.push([]);
+          used = 6;
+        }
+        lines[lines.length - 1].push(id);
+        used += w;
+      }
+      for (const ln of lines) out.write(`  ${C.dim("\u2502")}  ${ln.map((id) => chip(id)).join(C.dim("   \xB7   "))}
+`);
+    });
+    out.write("\n");
+  }
+  const actions = m.nodes.filter((n) => n.kind === "action");
+  const on = actions.filter((a) => cps.get(a.id)?.status === "added").length;
+  const sugg = m.checkpoints.filter((c2) => c2.status === "suggested").length;
+  out.write(`  ${LANES.map((c2) => c2("\u2501")).join("")} ${C.bold(C.text(sugg ? `Plures found ${sugg} ${sugg === 1 ? "place" : "places"} a person should check.` : "Your map is ready."))}
+`);
+  out.write(`       ${C.mute(`${on} of ${actions.length} ${actions.length === 1 ? "action" : "actions"} with consequences ${on === 1 ? "has" : "have"} a human check.`)}
+
+`);
+  out.write(`  ${C.text("See it build:")} ${C.cyan(url)}
+
+`);
+}
+async function openBrowser(url) {
+  const { spawn: spawn2 } = await import("child_process");
+  const [cmd, args] = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", ["/c", "start", "", url]] : ["xdg-open", [url]];
+  try {
+    const p = spawn2(cmd, args, { stdio: "ignore", detached: true });
+    p.on("error", () => {
+    });
+    p.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // src/cli.ts
 var argv = process.argv.slice(2);
 var flag = (name) => {
@@ -215,6 +411,7 @@ var flag = (name) => {
   return v;
 };
 var branch = flag("branch");
+var noOpen = argv.includes("--no-open") ? (argv.splice(argv.indexOf("--no-open"), 1), true) : false;
 var app = flag("app") ?? process.env.PLURES_APP ?? "default";
 var key = flag("key") ?? process.env.PLURES_API_KEY;
 var base = flag("base-url") ?? process.env.PLURES_BASE_URL ?? "https://plures.si";
@@ -242,14 +439,15 @@ async function upload(file) {
   } catch {
     die(`${file} isn't valid JSON.`);
   }
-  console.log(dim(`Sending the map to Plures. No source code is sent.`));
+  if (!fancy) console.log(dim(`Sending the map to Plures. No source code is sent.`));
   let m;
   try {
     m = await client().maps.upload(app, map2);
   } catch (e) {
     die(e instanceof PluresError ? `Plures said: ${e.message}` : String(e));
   }
-  report(m);
+  if (fancy) drawMap(m, m.url ?? `${base}/dashboard/apps/${m.app}/map`);
+  else report(m);
 }
 function report(m) {
   const nodes = new Map(m.nodes.map((n) => [n.id, n]));
@@ -299,7 +497,12 @@ With plures-mcp connected, just ask: ${cyan("Map this app for Plures")}`);
     childEnv.ANTHROPIC_API_KEY = run.token;
     console.log(dim(run.free ? "Plures is mapping this repo. Your first map is free." : `Plures is mapping this repo, at most $${(run.max_cents / 100).toFixed(2)} from your credit.`));
   }
-  console.log(`Reading this repo ${process.env.CI ? "on this runner" : "on your machine"} with Claude Code. ${dim("Only the map is sent to Plures.")}
+  const pageUrl = `${base}/dashboard/apps/${encodeURIComponent(app)}/map`;
+  if (fancy) {
+    banner(app, "Reading this repo on your machine with Claude Code. Only file names and the map go to Plures.");
+    if (key && !noOpen && await openBrowser(pageUrl)) console.log(`  ${dim("Watch it live in your browser:")} ${cyan(pageUrl)}
+`);
+  } else console.log(`Reading this repo ${process.env.CI ? "on this runner" : "on your machine"} with Claude Code. ${dim("Only the map is sent to Plures.")}
 `);
   const prompt = `${guide}
 
@@ -327,6 +530,8 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
     return r.startsWith("..") ? null : r.replace(/\\/g, "/");
   };
   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 });
     let buf = "";
@@ -350,10 +555,12 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
             if (!f) continue;
             reads++;
             queue.push({ path: f, tool: "Read" });
-            console.log(`  ${dim(String(reads).padStart(3))}  ${dim("reading")} ${f}`);
+            if (ticker) ticker.read(f);
+            else console.log(`  ${dim(String(reads).padStart(3))}  ${dim("reading")} ${f}`);
           } else if (b.name === "Write" && String(b.input?.file_path ?? "").endsWith(FILE)) {
             phase = "drawing";
-            console.log(`
+            if (ticker) ticker.drawing();
+            else console.log(`
   ${violet("drawing")}  the map`);
           }
         }
@@ -363,9 +570,11 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
     p.on("error", () => resolve(1));
   });
   clearInterval(tick);
-  if (result) console.log(`
+  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;
   if (!ok) {
     phase = "failed";
@@ -410,6 +619,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.`);
@@ -431,7 +654,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;
@@ -448,6 +671,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,13 +3,187 @@ import {
   Plures,
   PluresError,
   VERSION
-} from "./chunk-WPSUIAVZ.js";
+} from "./chunk-GIOZT6FB.js";
 
 // src/cli.ts
 import { spawnSync, spawn } from "child_process";
 import { randomBytes } from "crypto";
 import { relative, isAbsolute } from "path";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "fs";
+
+// src/term.ts
+var out = process.stdout;
+var fancy = Boolean(out.isTTY && !process.env.NO_COLOR && !process.env.CI && process.env.TERM !== "dumb");
+var rgb = (r, g, b) => (s) => `\x1B[38;2;${r};${g};${b}m${s}\x1B[0m`;
+var LANES = [rgb(91, 75, 255), rgb(74, 107, 250), rgb(50, 144, 238), rgb(25, 198, 230)];
+var C = {
+  text: rgb(243, 244, 247),
+  dim: rgb(110, 116, 136),
+  mute: rgb(160, 166, 186),
+  coral: rgb(255, 142, 122),
+  violet: rgb(185, 180, 255),
+  cyan: rgb(127, 227, 244),
+  amber: rgb(245, 184, 74),
+  bold: (s) => `\x1B[1m${s}\x1B[22m`
+};
+var width = () => Math.max(40, Math.min(out.columns || 80, 110));
+var visible = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+var cut = (s, n) => s.length > n ? `${s.slice(0, Math.max(1, n - 1))}\u2026` : s;
+function banner(app2, where) {
+  const bar = LANES.map((c2, i) => c2("\u2501".repeat(8 - i))).join(" ");
+  out.write(`
+  ${bar}
+
+  ${C.bold(C.text("Plures"))} ${C.dim("map")}  ${C.mute(app2)}
+  ${C.dim(where)}
+
+`);
+}
+function liveLine() {
+  const frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+  let i = 0, count = 0, file = "", phase = "reading", timer = null;
+  const draw = () => {
+    const spin = LANES[Math.floor(i / 2) % 4](frames[i % frames.length]);
+    i++;
+    const left = phase === "drawing" ? `  ${spin} ${C.violet("Drawing the map")}  ${C.dim(`from ${count} ${count === 1 ? "file" : "files"}`)}` : `  ${spin} ${C.bold(C.text(String(count).padStart(3)))} ${C.dim(count === 1 ? "file read " : "files read")}  `;
+    const room = width() - visible(left).length - 2;
+    const f = phase === "reading" && file ? (() => {
+      const slash = file.lastIndexOf("/");
+      const s = cut(file, room);
+      return slash >= 0 && s === file ? `${C.dim(file.slice(0, slash + 1))}${C.text(file.slice(slash + 1))}` : C.text(s);
+    })() : "";
+    out.write(`\r\x1B[K${left}${f}`);
+  };
+  return {
+    start() {
+      out.write("\x1B[?25l");
+      draw();
+      timer = setInterval(draw, 80);
+    },
+    read(path) {
+      count++;
+      file = path;
+    },
+    drawing() {
+      phase = "drawing";
+    },
+    stop() {
+      if (timer) clearInterval(timer);
+      timer = null;
+      out.write("\r\x1B[K\x1B[?25h");
+    },
+    get count() {
+      return count;
+    }
+  };
+}
+if (fancy) for (const sig of ["SIGINT", "SIGTERM"]) process.once(sig, () => {
+  out.write("\x1B[?25h\n");
+  process.exit(130);
+});
+var ICON = { input: "\u25B8", model: "\u25CE", tool: "\u2315", decision: "\u25C7", action: "\u2197", data: "\u25A4", output: "\u21A6", human: "\u263A" };
+function drawMap(m, url) {
+  const nodes = new Map(m.nodes.map((n) => [n.id, n]));
+  const cps = new Map(m.checkpoints.filter((c2) => c2.status !== "dismissed").map((c2) => [c2.at, c2]));
+  const W = width();
+  const nb = new Map(m.nodes.map((n) => [n.id, []]));
+  for (const e of m.edges) {
+    nb.get(e.from)?.push(e.to);
+    nb.get(e.to)?.push(e.from);
+  }
+  const seen = /* @__PURE__ */ new Set(), flows = [];
+  for (const n of m.nodes) {
+    if (seen.has(n.id)) continue;
+    const part = [], st = [n.id];
+    seen.add(n.id);
+    while (st.length) {
+      const v = st.pop();
+      part.push(v);
+      for (const w of nb.get(v) ?? []) if (!seen.has(w)) {
+        seen.add(w);
+        st.push(w);
+      }
+    }
+    flows.push(m.nodes.map((x) => x.id).filter((id) => part.includes(id)));
+  }
+  const chip = (id) => {
+    const n = nodes.get(id), c2 = cps.get(id);
+    const label = cut(n.label, 34);
+    const tag = !c2 ? "" : c2.status === "added" ? `  ${C.cyan("\u2713 checked")}` : `  ${C.violet("\u25CC check suggested")}`;
+    if (n.kind === "action") {
+      if (c2?.status === "added") return `${C.cyan(ICON.action)} ${C.text(label)}${tag}`;
+      const risky = n.risk === "high" || n.risk === "medium";
+      return `${risky ? C.coral(ICON.action) : C.mute(ICON.action)} ${risky ? C.coral(label) : C.mute(label)}${tag}`;
+    }
+    return `${C.dim(ICON[n.kind] ?? "\xB7")} ${C.mute(label)}${tag}`;
+  };
+  out.write("\n");
+  for (const ids of flows.filter((f) => f.length > 1)) {
+    const set = new Set(ids);
+    const es = m.edges.filter((e) => set.has(e.from) && set.has(e.to));
+    const layer = new Map(ids.map((id) => [id, 0]));
+    const order = [], state = /* @__PURE__ */ new Map(), back = /* @__PURE__ */ new Set();
+    const visit = (v) => {
+      state.set(v, 1);
+      for (const e of es.filter((x) => x.from === v)) {
+        if (state.get(e.to) === 1) back.add(`${v}>${e.to}`);
+        else if (!state.get(e.to)) visit(e.to);
+      }
+      state.set(v, 2);
+      order.push(v);
+    };
+    for (const id of ids) if (!state.get(id)) visit(id);
+    for (const v of order.reverse()) for (const e of es) if (e.from === v && !back.has(`${v}>${e.to}`)) layer.set(e.to, Math.max(layer.get(e.to), layer.get(v) + 1));
+    const rows = [];
+    for (const id of ids) (rows[layer.get(id)] ??= []).push(id);
+    const root = rows[0]?.length === 1 ? rows[0][0] : null;
+    out.write(`  ${LANES[flows.indexOf(ids) % 4]("\u25CF")} ${C.bold(C.text(cut(root ? nodes.get(root).label : "Flow", W - 6)))}
+`);
+    rows.forEach((row, ri) => {
+      if (!row || ri === 0 && root) return;
+      const lines = [[]];
+      let used = 6;
+      for (const id of row) {
+        const w = visible(chip(id)).length + 4;
+        if (used + w > W && lines[lines.length - 1].length) {
+          lines.push([]);
+          used = 6;
+        }
+        lines[lines.length - 1].push(id);
+        used += w;
+      }
+      for (const ln of lines) out.write(`  ${C.dim("\u2502")}  ${ln.map((id) => chip(id)).join(C.dim("   \xB7   "))}
+`);
+    });
+    out.write("\n");
+  }
+  const actions = m.nodes.filter((n) => n.kind === "action");
+  const on = actions.filter((a) => cps.get(a.id)?.status === "added").length;
+  const sugg = m.checkpoints.filter((c2) => c2.status === "suggested").length;
+  out.write(`  ${LANES.map((c2) => c2("\u2501")).join("")} ${C.bold(C.text(sugg ? `Plures found ${sugg} ${sugg === 1 ? "place" : "places"} a person should check.` : "Your map is ready."))}
+`);
+  out.write(`       ${C.mute(`${on} of ${actions.length} ${actions.length === 1 ? "action" : "actions"} with consequences ${on === 1 ? "has" : "have"} a human check.`)}
+
+`);
+  out.write(`  ${C.text("See it build:")} ${C.cyan(url)}
+
+`);
+}
+async function openBrowser(url) {
+  const { spawn: spawn2 } = await import("child_process");
+  const [cmd, args] = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", ["/c", "start", "", url]] : ["xdg-open", [url]];
+  try {
+    const p = spawn2(cmd, args, { stdio: "ignore", detached: true });
+    p.on("error", () => {
+    });
+    p.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/cli.ts
 var argv = process.argv.slice(2);
 var flag = (name) => {
   const i = argv.indexOf(`--${name}`);
@@ -19,6 +193,7 @@ var flag = (name) => {
   return v;
 };
 var branch = flag("branch");
+var noOpen = argv.includes("--no-open") ? (argv.splice(argv.indexOf("--no-open"), 1), true) : false;
 var app = flag("app") ?? process.env.PLURES_APP ?? "default";
 var key = flag("key") ?? process.env.PLURES_API_KEY;
 var base = flag("base-url") ?? process.env.PLURES_BASE_URL ?? "https://plures.si";
@@ -46,14 +221,15 @@ async function upload(file) {
   } catch {
     die(`${file} isn't valid JSON.`);
   }
-  console.log(dim(`Sending the map to Plures. No source code is sent.`));
+  if (!fancy) console.log(dim(`Sending the map to Plures. No source code is sent.`));
   let m;
   try {
     m = await client().maps.upload(app, map2);
   } catch (e) {
     die(e instanceof PluresError ? `Plures said: ${e.message}` : String(e));
   }
-  report(m);
+  if (fancy) drawMap(m, m.url ?? `${base}/dashboard/apps/${m.app}/map`);
+  else report(m);
 }
 function report(m) {
   const nodes = new Map(m.nodes.map((n) => [n.id, n]));
@@ -103,7 +279,12 @@ With plures-mcp connected, just ask: ${cyan("Map this app for Plures")}`);
     childEnv.ANTHROPIC_API_KEY = run.token;
     console.log(dim(run.free ? "Plures is mapping this repo. Your first map is free." : `Plures is mapping this repo, at most $${(run.max_cents / 100).toFixed(2)} from your credit.`));
   }
-  console.log(`Reading this repo ${process.env.CI ? "on this runner" : "on your machine"} with Claude Code. ${dim("Only the map is sent to Plures.")}
+  const pageUrl = `${base}/dashboard/apps/${encodeURIComponent(app)}/map`;
+  if (fancy) {
+    banner(app, "Reading this repo on your machine with Claude Code. Only file names and the map go to Plures.");
+    if (key && !noOpen && await openBrowser(pageUrl)) console.log(`  ${dim("Watch it live in your browser:")} ${cyan(pageUrl)}
+`);
+  } else console.log(`Reading this repo ${process.env.CI ? "on this runner" : "on your machine"} with Claude Code. ${dim("Only the map is sent to Plures.")}
 `);
   const prompt = `${guide}
 
@@ -131,6 +312,8 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
     return r.startsWith("..") ? null : r.replace(/\\/g, "/");
   };
   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 });
     let buf = "";
@@ -154,10 +337,12 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
             if (!f) continue;
             reads++;
             queue.push({ path: f, tool: "Read" });
-            console.log(`  ${dim(String(reads).padStart(3))}  ${dim("reading")} ${f}`);
+            if (ticker) ticker.read(f);
+            else console.log(`  ${dim(String(reads).padStart(3))}  ${dim("reading")} ${f}`);
           } else if (b.name === "Write" && String(b.input?.file_path ?? "").endsWith(FILE)) {
             phase = "drawing";
-            console.log(`
+            if (ticker) ticker.drawing();
+            else console.log(`
   ${violet("drawing")}  the map`);
           }
         }
@@ -167,9 +352,11 @@ Write the map to ${FILE} in the current directory now. Read the code; don't run
     p.on("error", () => resolve(1));
   });
   clearInterval(tick);
-  if (result) console.log(`
+  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;
   if (!ok) {
     phase = "failed";
@@ -214,6 +401,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.`);
@@ -235,7 +436,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;
@@ -252,6 +453,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.11.0";
+var VERSION = "1.13.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.11.0";
+declare const VERSION = "1.13.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.11.0";
+declare const VERSION = "1.13.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-WPSUIAVZ.js";
+} from "./chunk-GIOZT6FB.js";
 export {
   Plures,
   PluresError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plures",
-  "version": "1.11.0",
+  "version": "1.13.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",