add pagination / filtering / sorting for the plural endpoints

[Many0nne]

No description provided.

[Copilot]

Pull request overview

Adds a shared query-processing layer so plural (array) endpoints can support pagination, filtering, and sorting, and updates API docs/tests accordingly.

Changes:

• Introduces src/core/queryProcessor.ts to parse/validate query params and apply filtering/sorting/pagination with { data, meta } responses.
• Updates the dynamic router to generate a fixed-size mock pool and return paginated envelopes for array routes.
• Extends Swagger + README to document the new query parameters and response shape; adds Jest coverage for the query processor.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/core/queryProcessor.test.ts	Adds unit tests for query parsing, sort validation, filtering, sorting, and pagination behavior.
src/core/queryProcessor.ts	New core implementation for parsing query params and applying filters/sort/pagination to mock pools.
src/core/router.ts	Hooks query processing into array routes and switches plural responses to the {data, meta} envelope.
src/core/swagger.ts	Documents list query parameters and paginated list response schema in generated OpenAPI spec.
README.md	Documents pagination/filtering/sorting usage and shows the new envelope response format for plural routes.
CLAUDE.md	Adds repository workflow/architecture guidance (tooling + project structure notes).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.