Minor Changes
-
Added the
--extendsoption to the experimentaldiffcommand.
The option replaces theextendslist of the configuration file for one run, so--extends=diff-recommendedturns on the diff rules without a change to the file. -
Added support for MCP servers of protocol version
2026-07-28to the experimentalintrospect-mcpcommand.Note: A server that supports both
2026-07-28and an earlier protocol version is now recorded withprotocolVersion: 2026-07-28.
If--checkreports the description as out of date, run the command without--checkand commit the file. -
Added recommendations to the experimental
scorecommand.
It ranks the edits that raise the Agent Readiness score by their simulated impact and displays the score that all safe edits reach together.
The JSON output also lists the design findings that no documentation edit fixes. -
Added support for Git revisions to the experimental
diffcommand.
An argument in the<revision>:<path>form, such asorigin/main:openapi.yaml, reads the API description and the files it references from that revision.
Patch Changes
- Fixed an issue where
respectcounted and listed a request twice in the JSON output when the execution timeout ended the retries of a step. - Fixed an issue where
respectwaited for a retry or ran a sub-workflow step after the execution timeout, and reportedglobalTimeoutError: falsein the JSON output when the timeout ended a retry. - Fixed an issue where Respect counted a step that calls a workflow as a request in
totalRequestsof the JSON output when the step reported a failed check of its own. - Fixed an issue where Respect skipped the
successCriteriaof a step that calls a workflow withworkflowId.
Respect checks them against the outputs of the called workflow, read as$outputs.
A failed criterion fails the step and runs itsonFailureactions.
The criteria and the parameters of the step'sonSuccessandonFailureactions read$outputsthe same way. - Fixed an issue where Respect ran the
onSuccessactions and the next steps after a step that calls a workflow failed to resolve one of itsoutputs.
The step runs itsonFailureactions, and the workflow ends when it has none. - Added a link to the
scorecommand documentation at the end of its output. - Changed the
scorecommand to count error responses only toward error clarity, so the schemas and examples of error responses no longer change the example, documentation, constraint, schema, and dependency metrics of an operation. - Fixed an issue where the
scorecommand lowered the example coverage of operations without a response body and reported missing response examples for them. - Fixed an issue where the
scorecommand counted a shared response or request body only for the first operation that referenced it. - Fixed an issue where the
skillscommand failed when theskillspath of an agent, such as.claude/skills, was a file or a broken symbolic link.
The command skips that path with a warning and installs the skills into the other folders. - Updated @redocly/respect-core to v2.79.0.