Open integration foundation

Open integration, pinned for inspection.

v3.3.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

Current release

synapse-cdm 3.3.0

Published 8 October 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 3.3.0 identifies the public Python package, not the proprietary SynapseCommand platform.

CDM schema: 3.0.0 Stable
Adapter API: 3.1.0 Stable
SC-OES: 0.1.0 Draft
Operational ontology: 0.1.0 Draft
Manifest schema: 2.1.0 Stable
Evidence schema: 2.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 21 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==3.3.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

Release 3.3.0 and the 3.0.0 schema

Schema major version

CDM schema moved from 2.1.0 to 3.0.0 in the 3.0.0 release as a major change: the published contract was narrowed, so 2.x readers and writers are not guaranteed to interchange with 3.0.0 objects. In the same arc the Adapter API moved to 3.0.0 and later 3.1.0, the manifest schema to 2.1.0 and the evidence schema to 2.0.0. Release 3.3.0 added the tacticalapi adapter and left SCHEMA_VERSION at 3.0.0.

Versioning record Migration record

Release 3.3.0 evidence

Fixture verdicts:: 596, 0 failed, across 21 adapters
Clean-wheel verdicts:: 1,192 across 2 schema modes, 0 failed
Per-check outcomes and semantic conformance:: not reported in the release notes

Publisher-reported in the release notes, not rerun here. The two populations are separate measurements and are not added together.

Historical release

Release 2.2.0, published 17 September 2026

Kept as published. Release 2.2.0 used CDM schema 2.1.0, Adapter API 2.1.0, manifest schema 1.2.0 and evidence schema 1.0.0, with fourteen adapters.

Parser depth controls

Declared input-depth bounds were added for six of the fourteen adapters then shipped. 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. No wire field, published schema or golden fixture moved in that release.

Evidence, 2.2.0

538 fixture verdicts and 1,076 clean-wheel verdicts over two schema modes, publisher-reported for 2.2.0 only.

2.2.0 migration record

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, kept as a historical example. 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.

Case study: ADS-B adapter evidence and acceptance limits.

Inspect v3.3.0 Read the capability brief