[shuchenliu]

NodeNorm ES still publishes a copied OpenAPI document with stale service metadata, irrelevant TRAPI schemas, and endpoint contracts that do not match the Elasticsearch implementation. This updates the document for SmartAPI registration, corrects the affected endpoint responses and input handling, and exposes the document at /openapi.json.

Continues #42 with Gaurav Vaidya’s original commits for compatibility with the current main branches:

• preserves multi-Babel release selection and X-Babel-Version headers, and
• retains the current /status contract.
• The API version advances to 1.2.0.

The OpenAPI sync tests now resolve shared parameter references, recognize Tornado query readers, and check each HTTP method and its helpers separately. Offline response-schema checks cover both Babel releases and the current status response.

Validation: 290 tests passed, plus 12 subtests. Four integration tests requiring the su10 Elasticsearch host were excluded. OpenAPI file/served-document validation and diff whitespace checks pass.

Closes #35. Closes #36. Closes #47. Supports the SmartAPI registration work in #34; registration follows production deployment.

[Copilot]

🟡 Changes recommended

The equivalent-identifier schema rejects null types returned when individual_types=true and a clique’s source type is missing, leaving the response contract inconsistent with handler behavior.

1 open issue

• Allow null types in individual identifier responses · New

What changed in this PR

Updates the Elasticsearch-backed NodeNorm API for SmartAPI registration while preserving multi-Babel release selection, response headers, and the existing status contract.

Changes:

• Replaces stale OpenAPI metadata and unused TRAPI schemas with endpoint contracts for API version 1.2.0.
• Corrects response serialization, semantic-type casing, input handling, and route matching; exposes /openapi.json.
• Adds offline schema validation and regression coverage, including multi-Babel responses.

File	Description
tests/​test_set_identifiers.py	Aligns POST requests and expectations with the batch contract.
tests/​test_openapi.py	Adds document, handler-contract, and offline response validation.
tests/​test_babel_endpoints.py	Updates semantic-type expectations across releases.
tests/​test_application.py	Updates the exact status-route expectation.
src/​nodenorm/​webapp/​openapi.json	Refreshes metadata, schemas, and endpoint contracts for version 1.2.0.
src/​nodenorm/​handlers/​set_identifiers.py	Validates body structure and serializes early returns as dictionaries.
src/​nodenorm/​handlers/​semantic_types.py	Preserves Biolink class casing.
src/​nodenorm/​handlers/​normalized_nodes.py	Validates JSON body structure and parses boolean flags strictly.
src/​nodenorm/​handlers/​curie_prefix.py	Removes the unused, unregistered handler.
src/​nodenorm/​handlers/​conflations.py	Returns an object-wrapped conflation list and supports HEAD.
src/​nodenorm/​handlers/​base.py	Adds shared JSON parsing with HTTP 400 errors.
src/​nodenorm/​handlers/​__init__.py	Fixes route patterns and adds the OpenAPI redirect.
src/​nodenorm/​config/​config.default.json	Excludes the OpenAPI redirect from tracing.
README.md	Documents version 1.2.0 and OpenAPI maintenance checks.
pyproject.toml	Adds OpenAPI and JSON Schema test dependencies.
docker/​configuration/​config.json	Applies the tracing exclusion to Docker deployments.

_{Review effort: Balanced}