---
id: TST-PFM-INT-621
title: Contract package compatibility
kind: unit
product_area: platform
module: integrations
revision: 1
status: draft
source_sha:
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
  macroservice-libraries: 54536a441935c6e09fdb7f96f0bec71c52ba4e03
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
repository: macroservice-libraries
files:
  - packages/integration-contracts/src/compatibility.spec.ts
implements: []
environment: mock
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 1
isolation: 'The test process owns its inputs, fake clocks and any replaced runtime ports.'
test_cases:
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/compatibility.spec.ts#keeps the copy of
      the ${version} documents it compares against
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/compatibility.spec.ts#still holds every
      ${version} document, under the same $id
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/compatibility.spec.ts#validates every
      ${version} example against the ${version} schemas and against the current ones
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/compatibility.spec.ts#removes nothing
      ${version} defined (property, enum member, feature or type), requires nothing new, closes nothing
      and tightens no bound
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/compatibility.spec.ts#keeps every
      ${version} capability in the registry with its features and a binding policy
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/compatibility.spec.ts#finds what the
      check is for: a removed property, enum member or feature, a new requirement, a closed object, a
      lower bound
evidence:
  - 'macroservice-libraries:packages/integration-contracts/src/compatibility.spec.ts'
---
# Contract package compatibility

## Verification Boundary

This unit suite exercises contract package compatibility within the shared package. It records engineering coverage at the pinned revision without claiming a deployed run.

## What This Suite Proves

The source assertions cover the package behavior under controlled inputs. No detailed capability or feature scenario binding is verified in this registration.

## What It Does Not Prove

The suite does not establish deployed authorization, database behavior, provider effects or a complete customer workflow.

## Real Dependencies and Test Doubles

Imported package functions execute against the source-defined fixtures. Runtime ports, clocks and external transport responses remain controlled wherever the suite replaces them.

## Must Not Be Doubled

The shared function under test and its result assertions must execute. Returning an expected answer from a substitute does not prove the package behavior.