Open integration foundation

Open integration, pinned for inspection.

v2.2.0

Inspect the selected public Python package, its independently versioned data and semantic contracts, and the evidence boundaries around the open SOIF foundation.

View repository Install from PyPI See the PNTMAP example

Selected release

synapse-cdm 2.2.0

Published 17 September 2026. The Python distribution is synapse-cdm; the import package is synapse_cdm.

Pinned release source PyPI artefacts Development source (main)

Independent version axes

Package, schema, API and semantic contracts advance independently. Version 2.2.0 identifies the public Python package, not the proprietary SynapseCommand platform.

CDM schema: 2.1.0 Stable
Adapter API: 2.1.0 Stable
SC-OES: 0.1.0 Draft
Operational ontology: 0.1.0 Draft
Manifest schema: 1.2.0 Stable
Evidence schema: 1.0.0 Stable
Semantic profiles: 7 profiles Independently versioned

Public boundary

What the public release contains

The repository publishes the SOIF integration foundation. It does not publish the overall SynapseCommand specification or the private decision runtime built on that foundation.

Public package

Common Data Model and generated JSON schemas
Adapter SDK and 14 shipped adapter modules
Draft SC-OES event semantics and semantic profiles
Draft operational ontology and vocabulary registries
Synthetic fixtures, golden outputs and validation harness
Conformance and machine-readable evidence tooling
Published governance, versioning and migration material

Private platform boundary

SynapseCommand runtime and operational deployment
CommanderNL natural-language command services
Orchestration, fusion and scoring services
Planning and decision-support services

Licence boundary

SynapseCommand-authored public package material is released under Apache-2.0. That licence does not extend to third-party standards, names or trademarks referenced for interoperability.

Integrity fields

Hashes and integrity-shaped fields support reproducibility and comparison. They are not a signing system and do not claim cryptographic signature verification.

Quickstart

Run the packaged PNTMAP fixture

These macOS and Linux commands require Python 3.11 or newer. Installation needs access to the package artefacts; the packaged-fixture harness can then run locally without a hosted interpreter or upload service.

CDM tutorial and reference Generated schema reference SC-OES semantic documentation

macOS/Linux quickstart

python3 -m venv .venv
. .venv/bin/activate
python -m pip install synapse-cdm==2.2.0
python -m synapse_cdm.harness --list-adapters
python -m synapse_cdm.harness --adapter pntmap
python -m synapse_cdm.schemas --out ./schemas

Release and evidence

What changed in 2.2.0

Parser depth controls

Declared input-depth bounds were added for six of the fourteen shipped adapters. This is a bounded parser-safety change, not a security certification.

Round-trip tolerance

The Adapter API moved to 2.1.0 with explicit round-trip tolerance and transform declarations. The release record also documents repaired silent data-loss defects.

Validation evidence

Evidence availability metadata and reproducibility tooling changed. Evidence records are not bundled in the distribution, and no current-release total is inferred.

Upgrade notes

Pin the package and regenerate schemas with the documented command. CDM remains 2.1.0; no wire field, published schema or golden fixture moved in this release. Review Adapter API 2.1.0 if custom adapters depend on round-trip behaviour.

Pinned migration record

Evidence is release-bound

2.1.2 historical website assertion: 538 fixture verdicts, 0 reported failures, 1,076 clean-wheel verdicts and 2 schema modes. These publisher-reported figures are not an independent rerun.

2.2.0 source-bound record: fixture, clean-wheel and semantic-suite totals are 538. Missing reports are not zero failures, and distinct suites are not combined.

Reusable synthetic example

PNTMAP input to canonical CDM output

This is the complete synthetic input and checked-in golden output from the pinned 2.2.0 release. The golden is an expected result, not an execution performed in your browser. It preserves identifiers, timestamps, nulls, provenance, source.synthetic and the optional Event.oes block.

jamming_gulf_of_riga.json

{
  "alert_id": "PNTMAP-2026-04-29-0117",
  "alert_time": "2026-04-29T06:12:44Z",
  "valid_until": "2026-04-29T07:00:00Z",
  "severity": "critical",
  "interference": {
    "type": "jamming",
    "band": "L1",
    "signal_strength_dbm": -71.5,
    "confidence": 0.87,
    "affected_constellations": ["GPS", "GALILEO"]
  },
  "emitter": {
    "emitter_id": "EMT-4471",
    "lat": 57.512,
    "lon": 21.884,
    "geolocation_method": "tdoa",
    "accuracy_m": 2500,
    "attribution": "hostile"
  },
  "affected_area": {
    "type": "Polygon",
    "coordinates": [[[21.60, 57.30], [22.15, 57.30], [22.15, 57.72], [21.60, 57.72], [21.60, 57.30]]]
  },
  "receiver_count": 14,
  "reporting_node": "PNT-SENSOR-LIEPAJA-02"
}

SHA-256 998a72caaab19c92aa864770f6a9690f819f615f50f1040aab0b685cde07cf2b

Pinned input file

jamming_gulf_of_riga.cdm.json · expected

[
  {
    "affiliation": "HOSTILE",
    "attributes": {
      "entity_id_basis": "emitter.emitter_id",
      "interference_type": "jamming",
      "source_extras": {
        "emitter": {
          "attribution": "hostile",
          "geolocation_method": "tdoa"
        },
        "receiver_count": 14,
        "reporting_node": "PNT-SENSOR-LIEPAJA-02"
      },
      "symbol_basis": "derived from affiliation; the source states no SIDC"
    },
    "confidence": 0.87,
    "entity_id": "2bcbebf2-45ac-511c-a635-f115c0b9b7ac",
    "entity_type": "INTERFERENCE_SOURCE",
    "integrity": null,
    "kinematics": null,
    "object_kind": "entity",
    "ontology_types": [],
    "position": {
      "accuracy_m": 2500.0,
      "alt_m": null,
      "lat": 57.512,
      "lon": 21.884,
      "position_source": "ESTIMATED",
      "vertical": null
    },
    "quality": null,
    "residual": null,
    "schema_version": "2.1.0",
    "source": {
      "adapter": "pntmap",
      "adapter_version": "1.0.0",
      "format_name": "PNTMAP GNSS interference alert",
      "format_version": null,
      "observed_at": null,
      "original_id": null,
      "record_index": null,
      "source_hash": null,
      "synthetic": true,
      "system": "PNTMAP",
      "transformations": []
    },
    "source_ids": [
      {
        "external_id": "EMT-4471",
        "system": "PNTMAP"
      }
    ],
    "status": null,
    "symbol": "10260000000000000000",
    "valid_from": "2026-04-29T06:12:44.000Z",
    "valid_to": "2026-04-29T07:00:00.000Z"
  },
  {
    "event_id": "a24f7f97-3783-52af-96e3-7f465435341e",
    "event_type": "GNSS_INTERFERENCE",
    "geometry": {
      "coordinates": [
        [
          [
            21.6,
            57.3
          ],
          [
            22.15,
            57.3
          ],
          [
            22.15,
            57.72
          ],
          [
            21.6,
            57.72
          ],
          [
            21.6,
            57.3
          ]
        ]
      ],
      "type": "Polygon"
    },
    "integrity": null,
    "object_kind": "event",
    "observed_at": "2026-04-29T06:12:44.000Z",
    "oes": {
      "confidence": null,
      "effective_from": null,
      "effective_to": null,
      "entity_relations": [],
      "event_class": "OBSERVATION",
      "event_relations": [],
      "evidence": [],
      "extensions": {},
      "security": null,
      "spec_version": "0.1.0",
      "status": null,
      "type_id": "sc.pnt.gnss_interference.v1",
      "verification": null
    },
    "payload": {
      "frequency_band": "L1",
      "interference_type": "JAMMING",
      "signal_strength_dbm": -71.5,
      "source_extras": {
        "affected_constellations": [
          "GPS",
          "GALILEO"
        ]
      }
    },
    "quality": null,
    "received_at": "2026-04-29T06:15:00.000Z",
    "related_entities": [
      "2bcbebf2-45ac-511c-a635-f115c0b9b7ac"
    ],
    "residual": null,
    "schema_version": "2.1.0",
    "severity": "CRITICAL",
    "source": {
      "adapter": "pntmap",
      "adapter_version": "1.0.0",
      "format_name": "PNTMAP GNSS interference alert",
      "format_version": null,
      "observed_at": null,
      "original_id": null,
      "record_index": null,
      "source_hash": null,
      "synthetic": true,
      "system": "PNTMAP",
      "transformations": []
    },
    "source_ids": [
      {
        "external_id": "PNTMAP-2026-04-29-0117",
        "system": "PNTMAP"
      }
    ],
    "status": null
  }
]

SHA-256 309a65b3ca9b74ec72347e3e0d95b2b7195c123c5429e9f774372d975df06bb0

Pinned golden file

Continue the technical review

Evidence in context

Adapter coverageFormat-by-format scope, direction and limitations.Event semanticsThe draft semantic contract carried by Event.oes.Operational vocabularyExperimental ontology terms and their boundaries.Release evidenceArtefact provenance, integrity and supply-chain controls.

Inspect v2.2.0 Read the capability brief