Summary
The root GET /version endpoint's actual response fields don't match the Version schema documented in openapi.yml.
Details
src/server.ts (server.get('/version', ...)) returns:
{
"buildDate": "...",
"commitDate": "...",
"commitId": "...",
"version": "...",
"environment": "...",
"name": "ahb-tabellen"
}
openapi.yml's Version schema documents:
Version:
type: object
properties:
version:
type: string
buildDate:
type: string
commitHash:
type: string
commitDate:
type: string
buildBranch:
type: string
Mismatches:
commitHash (documented) vs commitId (actual) — field name mismatch
buildBranch is documented but never returned by the code
environment and name are returned by the code but not documented
This predates the docs/openapi-health-endpoint branch — introduced in be876ba2 (PR #722, "feat: implement comparison logic").
Suggested fix
Either rename commitId → commitHash and add buildBranch in src/server.ts, or update the Version schema in openapi.yml to match the actual response (adding environment/name, dropping/renaming commitHash/buildBranch as appropriate) — whichever reflects the intended contract.
Summary
The root
GET /versionendpoint's actual response fields don't match theVersionschema documented inopenapi.yml.Details
src/server.ts(server.get('/version', ...)) returns:{ "buildDate": "...", "commitDate": "...", "commitId": "...", "version": "...", "environment": "...", "name": "ahb-tabellen" }openapi.yml'sVersionschema documents:Mismatches:
commitHash(documented) vscommitId(actual) — field name mismatchbuildBranchis documented but never returned by the codeenvironmentandnameare returned by the code but not documentedThis predates the
docs/openapi-health-endpointbranch — introduced inbe876ba2(PR #722, "feat: implement comparison logic").Suggested fix
Either rename
commitId→commitHashand addbuildBranchinsrc/server.ts, or update theVersionschema inopenapi.ymlto match the actual response (addingenvironment/name, dropping/renamingcommitHash/buildBranchas appropriate) — whichever reflects the intended contract.