[afoote-mitre]

Summary

• Preserve the requested resultsPerPage value in the pageSize response field.
• Add resultsReturned to report the actual number of CVE records returned.
• Update the OpenAPI schema, README, controller and route assertions, and generated Postman collection.

Why This Change Was Needed

The response previously set pageSize from the returned hit-array length. Partial, empty, and out-of-range pages therefore lost the page capacity requested by the caller. Separating requested page size from actual result count makes the pagination metadata unambiguous.

Primary Files

Change	Files
Response metadata	controllers/searchController.js
Controller and route coverage	controllers/searchController.test.js, routes/search.integration.test.js
OpenAPI contract	routes/swagger.js, api-docs/openapi.json, api-docs/openapi.test.js
Public documentation	README.md
Manual Postman assertions	test/postman/buildCollection.js, test/postman/CVE-Search-API.postman_collection.json