@devries-cameron20 / composio-1 / commits / fa97ab430
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

build(deps): let TypeDoc 0.28.20 run on minimatch 11 (#5472)

## Summary The SDK reference drift check fails on every PR to `next` since #5469, including https://github.com/ComposioHQ/composio/pull/5471. #5469 overrides TypeDoc's minimatch to 11.0.3 for [GHSA-g3hv-75wg-m249](https://github.com/advisories/GHSA-g3hv-75wg-m249). TypeDoc 0.28.20, the latest release, declares `minimatch@^10.2.5` and calls `Minimatch#matchOne` when it expands entry points. minimatch 11 made that method private, so `generate:docs` exits with `TypeError: mini.matchOne is not a function`. ## Changes - Patch TypeDoc 0.28.20 so its glob walk uses the public `match(path, true)` partial match instead of `matchOne`, on a second matcher built with `flipNegate` so a negated pattern prunes the same directories as before. That is its only `matchOne` call. The minimatch 11 override and its advisory fix stay. - Run the drift workflow when `patches/**` changes, since a patch can change the generated reference. ## Type of change - [x] Bug fix - [ ] New feature - [x] Refactor/Chore - [ ] Documentation - [ ] Breaking change ## How Has This Been Tested? - On `next`, `pnpm --filter @composio/core generate:docs` reproduces the CI crash locally. - With the patch, it generates all 22 files, and `docs/content/reference/sdk-reference` has no changes. - For 10 patterns (literal paths, globstars, brace sets, relative and absolute globs, and their negations) and 16 directory paths, minimatch 11 `match(path, true)` with `flipNegate` returns the same result as minimatch 10.2.5 `set.some(row => matchOne(parts, row, true))` in all 160 cases. Without `flipNegate`, it differs in 80, every case with a negated pattern. - `pnpm install --frozen-lockfile` passes. ## Checklist - [ ] I have read the Code of Conduct and this PR adheres to it - [ ] I have read and understand every line of this diff, including any LLM-generated code - [x] Any third-party docs links or promotional content follow the [third-party links policy](https://github.com/ComposioHQ/composio/blob/next/CONTRIBUTING.md#third-party-links-in-docs) - [x] I ran linters/tests locally and they passed - [x] I updated documentation as needed - [x] I added tests or explain why not applicable (the drift workflow runs TypeDoc on this change) - [x] I added a changeset if this change affects published packages (dev dependency only, no changeset) ## Additional context Dropping the override would also fix CI, but it would bring back the minimatch advisory alert. Remove the patch once a TypeDoc release supports minimatch 11.

Alberto Schiabel committed Nov 19, 2026 at 16:03 UTC fa97ab430eb6cd1dd86d581f7528ae08c74b752b
4 files changed +35 -2
.github/workflows/docs-sdk-reference-drift.yml
+1
@@ -12,6 +12,7 @@ on:
12 - 'ts/packages/core/scripts/generate-docs.ts'
13 - 'ts/packages/core/package.json'
14 - 'pnpm-lock.yaml'
15 + - 'patches/**'
16 - 'python/composio/**'
17 - 'python/scripts/generate-docs.py'
18 - 'python/pyproject.toml'
patches/typedoc@0.28.20.patch new
+26
@@ -0,0 +1,26 @@
1 +diff --git a/dist/node-utils.js b/dist/node-utils.js
2 +index 96a483d44c9ca066a5128dc40abcffdb8a3aee4b..e7c5906264e4a073bcceafc359031f56b1a204b6 100644
3 +--- a/dist/node-utils.js
4 ++++ b/dist/node-utils.js
5 +@@ -316,6 +316,7 @@ function discoverFiles(rootDir, controller) {
6 + }
7 + function glob(pattern, root, options = {}) {
8 + const mini = new Minimatch2(pattern);
9 ++ const recurseMini = new Minimatch2(pattern, { flipNegate: true });
10 + const shouldIncludeNodeModules = pattern.includes("node_modules");
11 + const controller = {
12 + matches(path) {
13 +@@ -325,12 +326,7 @@ function glob(pattern, root, options = {}) {
14 + if (childPath[childPath.length - 1] === "node_modules" && !shouldIncludeNodeModules) {
15 + return false;
16 + }
17 +- return mini.set.some((row) => mini.matchOne(
18 +- childPath,
19 +- row,
20 +- /* partial */
21 +- true
22 +- ));
23 ++ return recurseMini.match(childPath.join("/"), /* partial */ true);
24 + },
25 + matchDirectories: options.includeDirectories,
26 + followSymlinks: options.followSymlinks
pnpm-lock.yaml
+3 -2
@@ -145,6 +145,7 @@ pnpmfileChecksum: sha256-X6eCJXmBNe7VV40iD0uZlsr4IMg+ZL/Qodvx5bNk4wI=
145
146 patchedDependencies:
147 '@mastra/schema-compat@1.3.4': 1d32e0a15ad79a9d35393cd910d52caaf920adb79cf3b1e3cd41d7fbb200f42b
148 + typedoc@0.28.20: 0b133078303fff45d93a4c1c4d4ccd84f8199851e8c1a0d774790e92f1fa1396
149
150 importers:
151
@@ -1523,7 +1524,7 @@ importers:
1524 version: 4.23.15
1525 typedoc:
1526 specifier: ^0.28.20
1526 - version: 0.28.20(@typescript/typescript6@6.0.2)
1527 + version: 0.28.20(patch_hash=0b133078303fff45d93a4c1c4d4ccd84f8199851e8c1a0d774790e92f1fa1396)(@typescript/typescript6@6.0.2)
1528 typescript:
1529 specifier: catalog:ts6
1530 version: '@typescript/typescript6@6.0.2'
@@ -11405,7 +11406,7 @@ snapshots:
11406
11407 typebox@1.4.6: {}
11408
11408 - typedoc@0.28.20(@typescript/typescript6@6.0.2):
11409 + typedoc@0.28.20(patch_hash=0b133078303fff45d93a4c1c4d4ccd84f8199851e8c1a0d774790e92f1fa1396)(@typescript/typescript6@6.0.2):
11410 dependencies:
11411 '@gerrit0/mini-shiki': 3.23.0
11412 lunr: 2.3.9
pnpm-workspace.yaml
+5
@@ -128,6 +128,11 @@ patchedDependencies:
128 # that allows no keys, and models that follow the schema execute tools with
129 # `{}`. Drop once @mastra/core can move to a release that keeps open maps.
130 '@mastra/schema-compat@1.3.4': patches/@mastra__schema-compat@1.3.4.patch
131 + # temporary: TypeDoc 0.28.20 calls Minimatch#matchOne, which minimatch 11 made
132 + # private, so the minimatch 11 override below crashes its glob walk. Use the
133 + # public partial match instead. Drop once a TypeDoc release supports
134 + # minimatch 11.
135 + 'typedoc@0.28.20': patches/typedoc@0.28.20.patch
136
137 overrides:
138 # temporary: @mastra/mcp 1.17.3 raised its @mastra/core peer floor to 1.64,