@redocly/cli 2.51.2 → 2.52.1

package/README.md

@@ -3,7 +3,7 @@
 [@Redocly](https://redocly.com) CLI is your all-in-one API documentation utility.
 It builds, manages, improves, and quality-checks your API descriptions, all of which comes in handy for various phases of the API Lifecycle.
 Create your own rulesets to make API governance easy, publish beautiful API reference documentation, and more.
-Supports OpenAPI 3.2, 3.1, 3.0 and OpenAPI 2.0 (legacy Swagger), AsyncAPI 3.0 and 2.6, Arazzo 1.0.
+Supports OpenAPI 3.x and 2.0 (legacy Swagger), AsyncAPI 3.x and 2.6, Arazzo 1.x, and more.
 
 ![build and test](https://github.com/redocly/redocly-cli/actions/workflows/tests.yaml/badge.svg)
 ![npm (scoped)](https://img.shields.io/npm/v/@redocly/cli)
@@ -54,6 +54,19 @@ docker build -t redocly/cli .
 docker run --rm -v $PWD:/spec redocly/cli lint path-to-root-file.yaml
 ```
 
+### Use with AI assistants
+
+Redocly CLI ships [agent skills](./.claude/skills) that teach AI coding assistants how to work with the CLI.
+Install them into your project:
+
+```sh
+npx skills add https://redocly.com
+```
+
+- `redocly-cli` — day-to-day usage: lint, bundle, decorate, build docs, test, and generate a client.
+- `redocly-lint-rules` — turn a check written in plain language into a built-in rule, a configurable rule, or a custom plugin.
+  It also covers migrating rules from other linters, such as Spectral.
+
 ## Common tasks
 
 ### Generate API reference documentation

package/THIRD_PARTY_NOTICES

@@ -612,12 +612,15 @@ ISC
 
 Packages:
   cliui@7.0.4 — Copyright (c) 2015, Contributors
+  isexe@2.0.0 — Copyright (c) Isaac Z. Schlueter and Contributors
   minimatch@5.1.9 — Copyright (c) 2011-2023 Isaac Z. Schlueter and Contributors
   picocolors@1.1.1 — Copyright (c) 2021-2024 Oleksii Raspopov, Kostiantyn Denysov, Anton Verinov
   semver@7.8.5 — Copyright (c) Isaac Z. Schlueter and Contributors
+  which@2.0.2 — Copyright (c) Isaac Z. Schlueter and Contributors
   y18n@5.0.8 — Copyright (c) 2015, Contributors
   yaml@2.9.0 — Copyright Eemeli Aro <eemeli@gmail.com>
   yargs-parser@20.2.9 — Copyright (c) 2016, Contributors
+  zod-to-json-schema@3.25.2 — Copyright (c) 2020, Stefan Terdell
 
 License text:
 Copyright Eemeli Aro <eemeli@gmail.com>
@@ -644,13 +647,14 @@ Packages:
   @emotion/is-prop-valid@1.4.0 — Copyright (c) Emotion team and other contributors
   @emotion/memoize@0.9.0 — Copyright (c) Emotion team and other contributors
   @faker-js/faker@10.6.0 — Copyright (c) 2022-2025
+  @modelcontextprotocol/sdk@1.30.0 — Copyright (c) 2024 Anthropic, PBC
   @noble/hashes@1.8.0 — Copyright (c) 2022 Paul Miller (https://paulmillr.com)
   @redocly/ajv@8.11.2 — Copyright (c) 2015-2021 Evgeny Poberezkin
   @redocly/ajv@8.18.3 — Copyright (c) 2015-2021 Evgeny Poberezkin
   @redocly/cli-otel@0.3.5 — Copyright 2025 Redocly Inc, all rights reserved.
   @redocly/config@0.22.0 — Copyright 2024 Redocly Inc.
-  @redocly/config@0.55.0 — Copyright 2024 Redocly Inc.
-  @redocly/openapi-core@1.34.19
+  @redocly/config@0.56.0 — Copyright 2024 Redocly Inc.
+  @redocly/openapi-core@1.34.20
   agent-base@7.1.4 — Copyright (c) 2013 Nathan Rajlich <nathan@tootallnate.net>
   ajv-formats@3.0.1 — Copyright (c) 2020 Evgeny Poberezkin
   ajv@8.20.0 — Copyright (c) 2015-2021 Evgeny Poberezkin
@@ -665,10 +669,14 @@ Packages:
   color-name@1.1.4 — Copyright (c) 2015 Dmitry Ivanov
   colorette@1.4.0 — Copyright © Jorge Bucaran <<https://jorgebucaran.com>>
   colorette@2.0.20 — Copyright © Jorge Bucaran <<https://jorgebucaran.com>>
+  content-type@1.0.5 — Copyright (c) 2015 Douglas Christopher Wilson
   cookie@0.7.2 — Copyright (c) 2012-2014 Roman Shtylman <shtylman@gmail.com>
+  cross-spawn@7.0.6 — Copyright (c) 2018 Made With MOXY Lda <hello@moxy.studio>
   debug@4.4.3 — Copyright (c) 2014-2017 TJ Holowaychuk <tj@vision-media.ca>
   escalade@3.2.0
   eventemitter3@5.0.1 — Copyright (c) 2014 Arnout Kazemier
+  eventsource-parser@3.1.1 — Copyright (c) 2026 Espen Hovlandsdal <espen@hovlandsdal.com>
+  eventsource@3.0.7 — Copyright (c) EventSource GitHub organisation
   fast-deep-equal@3.1.3 — Copyright (c) 2017 Evgeny Poberezkin
   fast-safe-stringify@2.1.1 — Copyright (c) 2016 David Mark Clements
   foreach@2.0.6 — Copyright (c) 2013 Manuel Stofer
@@ -678,7 +686,7 @@ Packages:
   https-proxy-agent@7.0.6 — Copyright (c) 2013 Nathan Rajlich <nathan@tootallnate.net>
   js-levenshtein@1.1.6 — Copyright (c) 2017 Gustaf Andersson
   js-tokens@4.0.0 — Copyright (c) 2014, 2015, 2016, 2017, 2018 Simon Lydell
-  js-yaml@4.3.1 — Copyright (C) 2011-2015 by Vitaly Puzrin
+  js-yaml@4.3.2 — Copyright (C) 2011-2015 by Vitaly Puzrin
   js-yaml@5.2.2 — Copyright (C) 2011-2015 by Vitaly Puzrin
   json-pointer@0.6.2 — Copyright (c) 2016 Manuel Stofer
   json-schema-traverse@1.0.0 — Copyright (c) 2017 Evgeny Poberezkin
@@ -691,10 +699,12 @@ Packages:
   mobx@6.12.3 — Copyright (c) 2015 Michel Weststrate
   ms@2.1.3
   object-assign@4.1.1
-  openapi-sampler@1.7.4 — Copyright (c) 2017 Roman Hotsiy <gotsijroman@gmail.com>
+  openapi-sampler@1.7.5 — Copyright (c) 2017 Roman Hotsiy <gotsijroman@gmail.com>
   outdent@0.8.0 — Copyright (c) 2016 Andrew Bradley
+  path-key@3.1.1
   perfect-scrollbar@1.5.6 — Copyright (c) 2012-2019 Hyunje Jun, MDBootstrap.com and other contributors
   picomatch@4.0.4 — Copyright (c) 2017-present, Jon Schlinkert.
+  pkce-challenge@5.0.1 — Copyright (c) 2019
   pluralize@8.0.0 — Copyright (c) 2013 Blake Embrey (hello@blakeembrey.com)
   polished@4.3.1 — Copyright (c) 2016-Present Brian Hough and Maximilian Stoiber
   prismjs@1.30.0 — Copyright (c) 2012 Lea Verou
@@ -703,8 +713,10 @@ Packages:
   react-is@16.13.1 — Copyright (c) Facebook, Inc. and its affiliates.
   react-tabs@6.1.1 — Copyright (c) Matt Zabriskie and Daniel Tschinder
   react@19.2.7 — Copyright (c) Meta Platforms, Inc. and affiliates.
-  redoc@2.5.3 — Copyright (c) 2015-present, Rebilly, Inc.
+  redoc@2.5.4 — Copyright (c) 2015-present, Rebilly, Inc.
   set-cookie-parser@2.7.1 — Copyright (c) 2015 Nathan Friedly <nathan@nfriedly.com> (http://nfriedly.com/)
+  shebang-command@2.0.0
+  shebang-regex@3.0.0
   slugify@1.4.7 — Copyright (c) Simeon Velichkov <simeonvelichkov@gmail.com>
   styled-components@6.4.2 — Copyright (c) 2016-present Glen Maddern and Maximilian Stoiber
   stylis@4.3.6 — Copyright (c) 2016-present Sultan Tarimo
@@ -715,6 +727,7 @@ Packages:
   uri-js-replace@1.0.1
   use-sync-external-store@1.6.0 — Copyright (c) Meta Platforms, Inc. and affiliates.
   yargs@17.0.1 — Copyright 2010 James Halliday (mail@substack.net); Modified work Copyright 2014 Contributors (ben@npmjs.com)
+  zod@4.4.3 — Copyright (c) 2025 Colin McDonnell
 
 License text:
 Copyright (C) 2013 by Oliver Nightingale

package/lib/chunks/{QYUMGE2L.js → 43FMQGIC.js}

@@ -4,6 +4,6 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{a}from"./POEVQHCC.js";import{V as p}from"./ZMAMNQ5K.js";function g(t,r){let n=t.services.flatMap(e=>e.operations),s=n.filter(e=>e.sse!==void 0);s.length>0&&p.warn(`generate-client: ${r} skipped ${s.length} server-sent-events operation(s) \u2014 iterate the sdk's exported async generators directly: ${s.map(e=>e.name).join(", ")}.
+import{a}from"./WNOJ33NP.js";import{W as p}from"./MJSI4VHA.js";function g(t,r){let n=t.services.flatMap(e=>e.operations),s=n.filter(e=>e.sse!==void 0);s.length>0&&p.warn(`generate-client: ${r} skipped ${s.length} server-sent-events operation(s) \u2014 iterate the sdk's exported async generators directly: ${s.map(e=>e.name).join(", ")}.
 `);let i=new Set(t.schemas.map(e=>e.name)),o=n.filter(e=>e.sse===void 0&&m(e,i));return o.length>0&&p.warn(`generate-client: ${r} skipped ${o.length} operation(s) whose variables type name collides with a schema \u2014 rename the schema or the operation: ${o.map(e=>e.name).join(", ")}.
 `),n.filter(e=>e.sse===void 0&&!m(e,i))}function m(t,r){let n=a(t);return n.hasInputs&&r.has(n.variablesTypeName)}function x(t){return t.method==="get"||t.method==="head"}function u(t){return a(t).hasInputs}function f(t){return a(t).variablesTypeName}function $(t,r,n){let s=[];return a(t).hasInputs?s.push(r):n&&s.push("{}"),n&&s.push("{ ...init, envelope: undefined }"),`${t.name}(${s.join(", ")})`}function v(t,r,n){let s=t.map(e=>e.name).sort(),i=t.filter(u).map(f).sort();return n&&i.push("RequestOptions"),`import { ${[...s,...i.map(e=>`type ${e}`)].join(", ")} } from ${JSON.stringify(r)};`}export{g as a,x as b,u as c,f as d,$ as e,v as f};