Adds a script to list out duplicate schema definitions in OpenAPI spec files

[cbnsndwch]

Tool: List duplicate OpenAPI schema definitions across files

📋 Description

This PR adds a TypeScript script that scans the repository for duplicate OpenAPI/Swagger schema definitions across all .json files. The script helps identify schemas with the same name defined in multiple files, making it easier for the team to extract and centralize shared definitions. This improves maintainability and reduces duplication in our API documentation.

• Bug fix
• New documentation
• Update to existing docs
• Other (please describe):
  Adds a developer tool for codebase maintenance

🧪 Related Issues

• #14 - [Documentation Errors Bug] Duplicate OpenAPI Schema Definitions

📝 Checklist

• I’ve tested my changes locally (if applicable).
• I’ve added sufficient documentation.
• I’ve reviewed existing open PRs for potential conflicts.
• I’ve followed the repository's contribution guidelines.

💬 Additional Comments

The script is intended for developer use and can be executed from the root of the repo by running the following command:

npx tsx ./.tools/src/find-duplicate-schemas.ts

It will print a map of duplicate schema definition names and the files containing them. Please see the log attached to the linked issue for an output example

[orca-security-us]

Orca Security Scan Summary

Status	Check	Issues by priority
Warning	Infrastructure as Code	31   21   6219   2461	View in Orca
Passed	SAST	0   3   0   0	View in Orca
Passed	Secrets	0   0   0   0	View in Orca
Passed	Vulnerabilities	0   0   0   0	View in Orca

🛡️ The following IaC misconfigurations have been detected

	NAME	FILE
	Response Code Missing (v3)	...ns/associations.json	View in code
	Response Code Missing (v3)	...ndars/calendars.json	View in code
	Response Code Missing (v3)	...ndars/calendars.json	View in code
	Response Code Missing (v3)	...ndars/calendars.json	View in code
	Response Code Missing (v3)	...ndars/calendars.json	View in code
	Response Code Missing (v3)	...s/custom-fields.json	View in code
	Response Code Missing (v3)	...us/custom-menus.json	View in code
	Response Code Missing (v3)	...l-isv/email-isv.json	View in code
	Response Code Missing (v3)	emails/emails.json	View in code
	Response Code Missing (v3)	...voices/invoices.json	View in code
	Response Code Missing (v3)	...voices/invoices.json	View in code
	Response Code Missing (v3)	...voices/invoices.json	View in code
	Response Code Missing (v3)	...voices/invoices.json	View in code
	Response Code Missing (v3)	...voices/invoices.json	View in code
	Response Code Missing (v3)	links/links.json	View in code
	Response Code Missing (v3)	...tions/locations.json	View in code
	Response Code Missing (v3)	...tions/locations.json	View in code
	Response Code Missing (v3)	...ace/marketplace.json	View in code
	Response Code Missing (v3)	...ace/marketplace.json	View in code
	Response Code Missing (v3)	...s/opportunities.json	View in code
	Response Code Missing (v3)	...s/opportunities.json	View in code
	Response Code Missing (v3)	...yments/payments.json	View in code
	Response Code Missing (v3)	...yments/payments.json	View in code
	Response Code Missing (v3)	...l-media-posting.json	View in code
	Response Code Missing (v3)	surveys/surveys.json	View in code
...	...	...	...

🛡️ The following SAST misconfigurations have been detected

	NAME	FILE
	Dynamic File Path Construction from User Input Can Lead to Path Traversal Attacks	...duplicate-schemas.ts	View in code
	Dynamic File Path Construction from User Input Can Lead to Path Traversal Attacks	...duplicate-schemas.ts	View in code
	Dynamic File Path Construction from User Input Can Lead to Path Traversal Attacks	...duplicate-schemas.ts	View in code

Note: The scan should have failed if no policies were configured in warn-only mode.