Lock in a passing test run as a regression baseline

regression.freeze_runChanges dataCreates, updates or deletes something in your workspace.

What it does

Freezes a test run as a regression baseline: a set of tests that must keep passing from now on. It protects against regressions, where a new change quietly breaks something that already worked, or where a test that used to run is dropped. After freezing, every pdlc.verify in this workspace checks every test case in every frozen run: if one is missing from the run being graded, or did not pass, the verdict becomes "fail" and the case is listed under frozenRegressions. So graded runs need to include the frozen cases, not just the feature you are working on. Waived cases (case.waive_ac) are exempt. Refuses a run with no recorded cases or with any failing case. Cases marked Not Executed are allowed but are still frozen, so they must pass in later runs. Returns testRunId, frozenAt, frozenBy, frozenCaseCount (passing cases), gitSha and branch; freezing an already frozen run is a no-op that returns alreadyFrozen: true. Undo with regression.unfreeze_run.

Ask your agent

You don’t call regression.freeze_run yourself. Say something like this to Claude Code, Cursor or another MCP-connected agent:

  • “Everything passes now, lock this in so we notice if it breaks later”
  • “Make the current test run the baseline that must stay green”
  • “Protect the login flow from regressions”

Inputs

NameTypeDescription
testRunId
required
stringId of the test run to freeze: the id from testrun.create or testrun.list. Must belong to the connected workspace and have no failing cases.
note
optional
stringOptional short note on what this baseline covers, up to 500 characters, e.g. "Checkout v1 launch". Saved on the run and shown by regression.list_frozen.

The MCP call

What the agent’s MCP client sends (placeholders in angle brackets):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "regression.freeze_run",
    "arguments": {
      "testRunId": "<testRunId>"
    }
  }
}

Connect your agent

npx -y @testmaze/mcp init tmt_xxx
claude mcp add tm --scope project -- npx -y @testmaze/mcp

Create the token in your Test Maze workspace under Settings → MCP. Setup for Cursor, Cline, Gemini CLI and Codex CLI is shown there too.