plures 1.21.0 → 1.22.0

package/README.md

@@ -56,6 +56,7 @@ if (event.type === "task.completed" && event.data.result?.agreement === 1) {
 - 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)`, `.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.suggestions(app)`: rubrics the Plures engine suggests for the app, from what graders found in its answers (with evidence) and from its agent map (with the step and file).
 - `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-Z3YGRA2U.js → chunk-3P2G67SF.js}

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.21.0";
+var VERSION = "1.22.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -148,6 +148,9 @@ var Plures = class {
    * early, and compare two versions blind before you ship. Personal details are taken out first.
    */
   quality = {
+    /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+     * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+    suggestions: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/rubric_suggestions`),
     /** Send every output; the rubric's sample rate decides which ones people grade. */
     sample: (p) => this.req("POST", "/api/v1/samples", p),
     /** A blind release check: a is the current version's output, b the new one's, for the same input. */

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.21.0";
+var VERSION = "1.22.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -179,6 +179,9 @@ var Plures = class {
    * early, and compare two versions blind before you ship. Personal details are taken out first.
    */
   quality = {
+    /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+     * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+    suggestions: (app2) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app2)}/rubric_suggestions`),
     /** Send every output; the rubric's sample rate decides which ones people grade. */
     sample: (p) => this.req("POST", "/api/v1/samples", p),
     /** A blind release check: a is the current version's output, b the new one's, for the same input. */

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   Plures,
   PluresError,
   VERSION
-} from "./chunk-Z3YGRA2U.js";
+} from "./chunk-3P2G67SF.js";
 
 // src/cli.ts
 import { spawnSync, spawn } from "child_process";

package/dist/index.cjs

@@ -26,7 +26,7 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "1.21.0";
+var VERSION = "1.22.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -175,6 +175,9 @@ var Plures = class {
    * early, and compare two versions blind before you ship. Personal details are taken out first.
    */
   quality = {
+    /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+     * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+    suggestions: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/rubric_suggestions`),
     /** Send every output; the rubric's sample rate decides which ones people grade. */
     sample: (p) => this.req("POST", "/api/v1/samples", p),
     /** A blind release check: a is the current version's output, b the new one's, for the same input. */

package/dist/index.d.cts

@@ -1,3 +1,22 @@
+type RubricSuggestion = {
+    object: "rubric_suggestion";
+    name: string;
+    question: string;
+    options: string[];
+    sample_rate: number;
+    why: string;
+    source: "map" | "grades";
+    evidence?: {
+        n: number;
+        examples: string[];
+    };
+    node: {
+        id: string;
+        label: string;
+        file: string | null;
+        line: number | null;
+    } | null;
+};
 type MapEstimate = {
     object: "map_estimate";
     app: string;
@@ -506,7 +525,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.21.0";
+declare const VERSION = "1.22.0";
 type GitHubLink = {
     object: "github_link";
     app: string;
@@ -759,6 +778,13 @@ declare class Plures {
      * early, and compare two versions blind before you ship. Personal details are taken out first.
      */
     quality: {
+        /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+         * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+        suggestions: (app: string) => Promise<{
+            object: "list";
+            app: string;
+            data: RubricSuggestion[];
+        }>;
         /** Send every output; the rubric's sample rate decides which ones people grade. */
         sample: (p: {
             rubric: string;
@@ -934,4 +960,4 @@ declare class Plures {
     static verifyWebhook(rawBody: string, signatureHeader: string | null, secret: string, toleranceSec?: number): Promise<WebhookEvent>;
 }
 
-export { type AgentMap, type App, type Balance, type CheckOverrides, type CheckResult, type Consensus, type CreateTask, type DriftCase, type DriftDiagnosis, type Escalation, type GitHubLink, type MapChanges, type MapCheckpoint, type MapDraft, type MapEstimate, type MapKey, type MapNode, type Mix, type Option, Plures, PluresError, type Release, type Result, type Route, type Routing, type RoutingRule, type RoutingUpdate, type Rubric, type RubricParams, type Sample, type StoredAgentMap, type Task, type TaskStatus, type TeamTally, type TeamVote, type TestMix, type TurnParams, VERSION, type WebhookEvent, Plures as default };
+export { type AgentMap, type App, type Balance, type CheckOverrides, type CheckResult, type Consensus, type CreateTask, type DriftCase, type DriftDiagnosis, type Escalation, type GitHubLink, type MapChanges, type MapCheckpoint, type MapDraft, type MapEstimate, type MapKey, type MapNode, type Mix, type Option, Plures, PluresError, type Release, type Result, type Route, type Routing, type RoutingRule, type RoutingUpdate, type Rubric, type RubricParams, type RubricSuggestion, type Sample, type StoredAgentMap, type Task, type TaskStatus, type TeamTally, type TeamVote, type TestMix, type TurnParams, VERSION, type WebhookEvent, Plures as default };

package/dist/index.d.ts

@@ -1,3 +1,22 @@
+type RubricSuggestion = {
+    object: "rubric_suggestion";
+    name: string;
+    question: string;
+    options: string[];
+    sample_rate: number;
+    why: string;
+    source: "map" | "grades";
+    evidence?: {
+        n: number;
+        examples: string[];
+    };
+    node: {
+        id: string;
+        label: string;
+        file: string | null;
+        line: number | null;
+    } | null;
+};
 type MapEstimate = {
     object: "map_estimate";
     app: string;
@@ -506,7 +525,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.21.0";
+declare const VERSION = "1.22.0";
 type GitHubLink = {
     object: "github_link";
     app: string;
@@ -759,6 +778,13 @@ declare class Plures {
      * early, and compare two versions blind before you ship. Personal details are taken out first.
      */
     quality: {
+        /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+         * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+        suggestions: (app: string) => Promise<{
+            object: "list";
+            app: string;
+            data: RubricSuggestion[];
+        }>;
         /** Send every output; the rubric's sample rate decides which ones people grade. */
         sample: (p: {
             rubric: string;
@@ -934,4 +960,4 @@ declare class Plures {
     static verifyWebhook(rawBody: string, signatureHeader: string | null, secret: string, toleranceSec?: number): Promise<WebhookEvent>;
 }
 
-export { type AgentMap, type App, type Balance, type CheckOverrides, type CheckResult, type Consensus, type CreateTask, type DriftCase, type DriftDiagnosis, type Escalation, type GitHubLink, type MapChanges, type MapCheckpoint, type MapDraft, type MapEstimate, type MapKey, type MapNode, type Mix, type Option, Plures, PluresError, type Release, type Result, type Route, type Routing, type RoutingRule, type RoutingUpdate, type Rubric, type RubricParams, type Sample, type StoredAgentMap, type Task, type TaskStatus, type TeamTally, type TeamVote, type TestMix, type TurnParams, VERSION, type WebhookEvent, Plures as default };
+export { type AgentMap, type App, type Balance, type CheckOverrides, type CheckResult, type Consensus, type CreateTask, type DriftCase, type DriftDiagnosis, type Escalation, type GitHubLink, type MapChanges, type MapCheckpoint, type MapDraft, type MapEstimate, type MapKey, type MapNode, type Mix, type Option, Plures, PluresError, type Release, type Result, type Route, type Routing, type RoutingRule, type RoutingUpdate, type Rubric, type RubricParams, type RubricSuggestion, type Sample, type StoredAgentMap, type Task, type TaskStatus, type TeamTally, type TeamVote, type TestMix, type TurnParams, VERSION, type WebhookEvent, Plures as default };

package/dist/index.js

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

package/package.json

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