Major corrections and improvements

Author: bitfl0wer

.github/workflows/deploy-openapi-spec.yml

@@ -31,7 +31,7 @@ jobs:
           - name: Commit OpenAPI specification to repository
             run: |
               tree -L 2
-              mv ./api/src/core/tsp-output/@typespec/openapi3/openapi.v1.0.yaml ./api/build/core-openapi3.yaml
+              mv ./api/src/core/tsp-output/@typespec/openapi3/openapi.v1.0-alpha.1.yaml ./api/build/core-openapi3.yaml
               git add ./api/build/*
               git commit -m "[bot]update openapi3 schema" || true
               git push || true