ci: add OpenAPI spec export to CI pipeline

[snowrugar-beep]

Problem Statement

Swagger is configured at runtime (accessible via /api/docs) but no CI step exports the OpenAPI JSON spec as an artifact.

Evidence

• Backend/src/main.ts — SwaggerModule.createDocument generates the spec
• No CI step to export and upload openapi.json

Impact

API consumers must run the application to get the OpenAPI spec. No spec available in CI artifacts for documentation generation.

Proposed Solution

1. Add CI step that starts the application and fetches Swagger JSON
2. Export the spec as openapi.json artifact
3. Add to API docs generation pipeline

Technical Requirements

• Must use the same Swagger config as the application
• Must export both JSON and YAML formats

Acceptance Criteria

1. CI step generates openapi.json
2. Artifact is available for download
3. Spec matches the runtime Swagger documentation

File Inventory

• infrastructure/ci/docker-build-pipeline.yml
• infrastructure/ci/docs-generation.yml

Dependencies

Issue #23 (API versioning) — spec should match final routes.

Testing Strategy

• Compare CI-generated spec with runtime spec

Security Considerations

OpenAPI spec should not expose internal endpoint details that could aid attackers.

Definition of Done

• CI exports OpenAPI spec
• Artifact available
• Spec matches runtime

[temisan0x]

hey team, i’d like to take on this issue
I’ve been able to go through it
I can start on it now if it’s okay

[grantfox-oss]

🦊 GrantFox — @temisan0x has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #40)
2. Your PR will be reviewed by the VertexChainLabs maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign campaign!

@temisan0x's PR #82 was approved and merged by @snowrugar-beep.

🏆 @temisan0x: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (786 total points). Track your full progress on GrantFox.

👏 Great work, @temisan0x! Keep contributing to VertexChainLabs.