Module
References
Addressable source resources, visual evidence, reference graph and conflict resolution.
Raw schema: /schema/1.0/modules/references.schema.json
source
type: object · required: id, kind
| Property | Type | Required | Constraints |
|---|---|---|---|
id | id | yes | — |
kind | taxonomy | yes | — |
uri | uri | no | — |
title | string | no | minLength 1 |
description | string | no | minLength 1 |
mediaType | string | no | minLength 1 |
checksum | string | no | minLength 1 |
version | string | no | minLength 1 |
license | string | no | minLength 1 |
provenance | provenance | no | — |
extensions | extensions | no | — |
locator
type: object
reference
Evidence may be located externally, but validators must never fetch or execute it implicitly.
type: object · required: id, kind, role
| Property | Type | Required | Constraints |
|---|---|---|---|
id | id | yes | — |
kind | taxonomy | yes | — |
role | "source-of-truth" | "preferred" | "supporting" | "inspiration" | "avoid" | yes | — |
uri | uri | no | — |
sourceRef | id | no | — |
text | string | no | minLength 1 |
locator | locator | no | — |
aspects | array<taxonomy> | no | minItems 1 |
weight | number | no | min 0 · max 1 |
priority | integer | no | min 0 |
confidence | number | no | min 0 · max 1 |
provenance | provenance | no | — |
description | string | no | minLength 1 |
referenceRefs | array<id> | no | — |
extensions | extensions | no | — |
matchMode | "exact" | "structural" | "perceptual" | "semantic" | "stylistic" | "inspirational" | no | — |
conformance | object | no | — |
tolerance | tolerance | no | — |
binding
type: object · required: referenceRef
| Property | Type | Required | Constraints |
|---|---|---|---|
referenceRef | id | yes | — |
aspects | array<taxonomy> | no | minItems 1 |
weight | number | no | min 0 · max 1 |
priority | integer | no | min 0 |
referenceSet
type: object · required: id, references, conflictPolicy
| Property | Type | Required | Constraints |
|---|---|---|---|
id | id | yes | — |
title | string | no | minLength 1 |
references | array<id | binding> | yes | minItems 1 |
conflictPolicy | "priority" | "first-wins" | "last-wins" | "weighted" | "most-specific" | "explicit-over-inferred" | "error" | yes | — |
aspectPriority | object | no | — |
description | string | no | minLength 1 |
extensions | extensions | no | — |
assertion
type: object · required: path, method
| Property | Type | Required | Constraints |
|---|---|---|---|
pathJSON Pointer into this document. | string | yes | minLength 1 |
source | string | no | minLength 1 |
sourceRef | id | no | — |
method | "direct" | "derived" | "inferred" | "manual" | "generated" | "validated" | "explicit" | "measured" | "extracted" | "vision-inference" | "reference-derived" | "defaulted" | "platform-derived" | yes | — |
confidence | number | no | min 0 · max 1 |