@beryl-so/cli 0.45.0 → 0.46.0

package/README.md

@@ -175,6 +175,7 @@ Create and manage projects: a site Beryl explores, authors tests for, and runs.
 | `beryl projects get` | Show one project, including its current exploration state | `projects_get` |
 | `beryl projects create [url]` | Create a project. With a URL the agent starts exploring; with just --name an empty one | `projects_create` |
 | `beryl projects rename <name>` | Rename a project | `projects_rename` |
+| `beryl projects quarantine [state]` | Turn auto quarantine on or off and tune when it mutes and releases a test | `projects_quarantine` |
 | `beryl projects delete` | Delete a project and all its tests and runs | `projects_delete` |
 | `beryl projects re-explore` | Send the agent back in to run/heal existing tests and discover new flows | none |
 | `beryl projects report` | Aggregate quality report across recent runs (pass rates, flaky tests, trend) | `projects_report` |

package/dist/commands/projects.js

@@ -176,6 +176,53 @@ export const projectCommands = [
             };
         },
     },
+    {
+        name: "projects quarantine",
+        summary: "Turn auto quarantine on or off and tune when it mutes and releases a test",
+        description: "With auto quarantine on, the end of every run checks the tests that ran: a test that " +
+            "failed --failures times in the last --days days with a pass in between is " +
+            "quarantined (straight failures are a regression and never are), and a quarantined " +
+            "test, manual or auto, is released after --passes first-attempt passes in a row. " +
+            "Pass on|off and/or any of the numbers; `projects get` shows the current values.",
+        scope: "project",
+        args: [{ name: "state", description: "on | off; omit to only tune the numbers" }],
+        flags: [
+            { name: "failures", type: "number", description: "Failures in the window that quarantine a test (1-50, default 3)" },
+            { name: "days", type: "number", description: "Window in days (1-90, default 7)" },
+            { name: "passes", type: "number", description: "Passes in a row that release a test (1-50, default 5)" },
+        ],
+        examples: [
+            "beryl projects quarantine on",
+            "beryl projects quarantine on --failures 3 --days 7 --passes 5",
+            "beryl projects quarantine --passes 3",
+            "beryl projects quarantine off",
+        ],
+        async run(ctx, input) {
+            const { workspaceId, projectId } = await ctx.requireProject(input);
+            const body = {};
+            const state = input.args.state;
+            if (typeof state === "string" && state) {
+                const lower = state.toLowerCase();
+                if (lower !== "on" && lower !== "off") {
+                    throw new UsageError(`Expected "on" or "off", got "${state}"`);
+                }
+                body.auto_quarantine = lower === "on";
+            }
+            const failures = flagNum(input, "failures");
+            const days = flagNum(input, "days");
+            const passes = flagNum(input, "passes");
+            if (failures !== undefined)
+                body.quarantine_failures = failures;
+            if (days !== undefined)
+                body.quarantine_days = days;
+            if (passes !== undefined)
+                body.quarantine_release_passes = passes;
+            if (Object.keys(body).length === 0) {
+                throw new UsageError("Pass on|off or at least one of --failures, --days, --passes");
+            }
+            return { data: await ctx.client.patch(projectPath(workspaceId, projectId), body) };
+        },
+    },
     {
         name: "projects delete",
         summary: "Delete a project and all its tests and runs",

package/dist/commands/tests.js

@@ -587,9 +587,10 @@ export const testCommands = [
             "red lands in the run's quarantined_count and gates neither the run's verdict nor exit " +
             "codes, so it can't red-light a deploy. Use " +
             "it on a persistently flaky test instead of deleting it (which destroys the history) or " +
-            "asking support to deactivate it (which stops it running at all). After 5 consecutive " +
-            "clean passes the test reports rehab_ready (advisory only, nothing un-quarantines " +
-            "itself). `off` un-quarantines.",
+            "asking support to deactivate it (which stops it running at all). After the project's " +
+            "release threshold of consecutive clean passes (default 5) the test reports " +
+            "rehab_ready: a suggestion while auto quarantine is off, the actual release once " +
+            "`projects quarantine on` has turned it on. `off` un-quarantines.",
         scope: "project",
         args: [
             { name: "test-id", description: "Test id", required: true },

package/package.json

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