Skip to content

About

Partial diagnostics for the 4D-ID 2.4 working draft: 15 schema checks implemented of 112 targets defined.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

@4d-id/conformance

Run partial 4D-ID 2.4 checks against a resolver endpoint. This is a diagnostic tool, not certification or an adoption badge: the manifest defines 112 targets, the data runner implements 15 schema checks, and functional work continues.

License: Apache-2.0

npx @4d-id/conformance https://resolver.example.org

What it does

It exercises a running resolver's access operations and checks the specification's semantics: that identifiers match the canonical grammar, that emitted records validate against the JSON Schemas, that the context envelope is bounded and carries no raw geometry, that snapshots and watch behave, and more. It prints a per-test report and a profile-level verdict.

4D-ID conformance 2.4  ·  https://resolver.example.org

  PASS /conf/query/operations       resolve returned a valid 4D-ID with a snapshot
  PASS /conf/core/uri-form          identifier matches the canonical grammar
  PASS /conf/core/state-fields      state validates against the schema
  PASS /conf/core/timestamps        source and publish times present
  PASS /conf/core/genesis-anchor    entity resolves; identifier is opaque and stable
  PASS /conf/query/context-envelope envelope validates, bounded, snapshot-tagged, no raw geometry
  PASS /conf/scale/snapshot         snapshot carries an id and zone generations
  PASS /conf/scale/list-then-watch  watch returns a change list

  P1 Core checks: all implemented core checks pass
  Overall: all executed tests passed
  Coverage: 9 of 112 manifest tests executed

Honest coverage

The endpoint CLI currently executes nine partial checks from the 112-target manifest against a running resolver and reports the rest as not run. Separately, the reference implementation's data runner implements 15 schema checks. Functional conformance work continues across writable lifecycle operations, registrations, bounded reconciliation, partition behavior, authority policy, propagation, and security. Neither result is certification or a claim of full specification conformance.

Options

4did-conformance <base-url> [--sample=registry:external_id] [--json]
  • --sample=registry:external_id — the external identifier to resolve for the run (default asset.register:TB-WH-01, the reference sample). Point it at an identifier your endpoint actually has.
  • --json — machine-readable report, for CI.

Exit code is non-zero if any executed test failed, so it drops into a pipeline.

In CI

- run: npx @4d-id/conformance https://staging.myresolver.example --json

License

Apache-2.0. The test manifest is defined by the candidate 4D-ID specification.

About

Partial diagnostics for the 4D-ID 2.4 working draft: 15 schema checks implemented of 112 targets defined.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages