@beryl-so/cli 0.42.0 → 0.43.0

package/dist/commands/runs.js

@@ -552,8 +552,13 @@ export const runCommands = [
         description: "Over MCP the failure screenshots come back as viewable image content, so an agent can " +
             "look at the page that broke instead of guessing from the error string. Set screenshots " +
             "to false to skip fetching them. Ignored outside MCP (the terminal cannot show an image). " +
-            "Returns the run row with its per-test results. `runs report` returns the generated " +
-            "report document, `runs explain` an AI explanation of one failed result.",
+            "Returns the run row with every per-test result unless --page is given; pass --page to " +
+            "read a large run a slice at a time, optionally narrowed by --status, --group or --q, " +
+            "which keeps the output readable rather than saving a round trip. With --page the " +
+            "match total and page counts come back under results_page. Paged results are the run's " +
+            "settled tests only: anything still running, healing or queued is left out. " +
+            "`runs report` returns the generated report document, `runs explain` an AI explanation " +
+            "of one failed result.",
         scope: "project",
         args: [{ name: "run-id", description: "Run id", required: true }],
         flags: [
@@ -563,10 +568,62 @@ export const runCommands = [
                 default: true,
                 description: "Attach failure screenshots as image content (MCP only; default true)",
             },
+            {
+                name: "page",
+                type: "number",
+                description: "Return only this 1-indexed page of results instead of every result",
+            },
+            {
+                name: "page-size",
+                type: "number",
+                description: "Results per page when --page is given (default 20, max 100)",
+            },
+            {
+                name: "status",
+                type: "string",
+                description: "With --page, show only this bucket: passed, failed, errored, cancelled, or " +
+                    "quarantined",
+            },
+            {
+                name: "group",
+                type: "string",
+                description: "With --page, show only results whose test is in this group (by name; see " +
+                    "`beryl groups list`)",
+            },
+            {
+                name: "ungrouped",
+                type: "boolean",
+                description: "With --page, show only results whose test carries no group",
+            },
+            {
+                name: "q",
+                type: "string",
+                description: "With --page, show only results whose test title contains this text " +
+                    "(case-insensitive)",
+            },
         ],
         async run(ctx, input) {
             const { workspaceId, projectId } = await ctx.requireProject(input);
-            const data = (await ctx.client.get(`${projectPath(workspaceId, projectId)}/runs/${arg(input, "run-id")}`));
+            const runPath = `${projectPath(workspaceId, projectId)}/runs/${arg(input, "run-id")}`;
+            const page = flagNum(input, "page");
+            // The run row (header, counters) only exists on the unpaged route, so --page still
+            // fetches it and then swaps test_results for the requested slice. This trims what
+            // the caller has to read, not what the api has to send.
+            const data = (await ctx.client.get(runPath));
+            if (page !== undefined) {
+                const { items, ...meta } = (await ctx.client.get(`${runPath}/results/page`, {
+                    page,
+                    page_size: flagNum(input, "page-size"),
+                    status: flagStr(input, "status"),
+                    group: flagBool(input, "ungrouped") ? "__ungrouped__" : flagStr(input, "group"),
+                    q: flagStr(input, "q"),
+                }));
+                const paged = data;
+                paged.test_results = items;
+                // total / page / page_size / status_totals / group_counts ride along: without
+                // them a caller cannot tell whether another page exists short of asking for it.
+                paged.results_page = meta;
+            }
             // Only the MCP adapter renders images; fetching bytes for a plain CLI run
             // would be wasted network.
             if (!ctx.mcp || input.flags.screenshots === false)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beryl-so/cli",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "Beryl on the command line — projects, runs, the exploring agent, and an MCP server over the same commands.",
   "license": "MIT",
   "type": "module",