docs-util: fix workflows not picked for some routes + generate OAS (#13342)

* generated oas

* fixes and improvements

www/utils/yarn.lock

@@ -2646,6 +2646,7 @@ __metadata:
     commander: ^11.1.0
     dotenv: ^16.3.1
     eslint: 8.56.0
+    fdir: ^6.5.0
     glob: ^11.0.2
     minimatch: ^9.0.3
     openai: ^4.29.1
@@ -3279,6 +3280,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"fdir@npm:^6.5.0":
+  version: 6.5.0
+  resolution: "fdir@npm:6.5.0"
+  peerDependencies:
+    picomatch: ^3 || ^4
+  peerDependenciesMeta:
+    picomatch:
+      optional: true
+  checksum: e345083c4306b3aed6cb8ec551e26c36bab5c511e99ea4576a16750ddc8d3240e63826cc624f5ae17ad4dc82e68a253213b60d556c11bfad064b7607847ed07f
+  languageName: node
+  linkType: hard
+
 "file-entry-cache@npm:^6.0.1":
   version: 6.0.1
   resolution: "file-entry-cache@npm:6.0.1"