Skip to content

Add provider-side seam schema validation CI using rerum_openapi workflow #269

@cubap

Description

@cubap

Implement provider-side contract schema validation in rerum_server_nodejs so CI verifies runtime behavior against seam baselines in cubap/rerum_openapi.

Context

Provider Implementation Plan

  1. Add a provider CI workflow in this repo that calls:
    uses: cubap/rerum_openapi/.github/workflows/seam-runtime-validation.yml@main
  2. Pin inputs for this provider:
    • contract_repo_ref: main (or pinned tag/commit)
    • seam_manifest_path: seams/tinynode-to-rerum/manifest.yaml (and/or deer-to-rerum, tpen-services-to-rerum, etc. as phased jobs)
    • target_base_url: deployed provider URL for CI environment
    • compare_paths: true
    • compare_operations: true
  3. Add a provider fixture file in this repo for representative interactions and pass it with fixture_file.
  4. Run this gate on pull_request and push to main; block merge on failure.

Suggested Acceptance Criteria

  • CI fails if provider health/readiness/spec endpoints fail for the seam test endpoints.
  • CI fails if provider OpenAPI misses expected paths, operations, or response codes from seam baseline.
  • CI fails if provider fixture request/response bodies violate baseline schemas.
  • CI passes with deterministic fixture data and stable environment config.

Notes

  • This adds local deterministic contract gates without introducing a hosted validation service dependency.
  • Follow-up optimization can pin contract_repo_ref to release tags instead of main.

Metadata

Metadata

Assignees

Labels

copilotFiled by Copilot scan

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions