Sustema

ENTITY developer reference

AssessmentClocksProjection

Candidate documentation for reading and synthetic examples. Account creation, live API access, SDKs, collections and MCP are not available here. A released service profile and matching integration instructions are required before use.

This is a documentation reading view of an unreleased candidate, not a downloadable replacement schema. Public wire names, types and constraints are retained except for the explicitly marked private-only subsets and route patterns. Private governance references are explained in public language. Use only a separately released, verified generation for clients. Read the explicit exclusions.

This is the public candidate schema reading view. Read it with the operation that uses it; a representable field does not establish enabled coverage or entitlement.

Each supporting source has its real dates. KnownTime preserves instant/date/unknown precision; unknown cannot satisfy a required clock. Date-only intervals use the qualified source timezone, never fabricated midnight. Qualification uses the oldest plausible age; a freshness/future boundary straddle is unqualified. Server validates policy-specific age/subject/rights/quality; HTTP success, access time or identifier change alone is insufficient. Check may precede this request if qualified newer held evidence satisfies scope. Assessment clocks are immutable at completion; served_at is a separate response projection. Summary dates do not replace per-source clocks or reset them. source_published/source_published_at is the source-original publication instant/date, or unknown; acquired/source_observed_at is Sustema acquisition/observation, not source publication; verified/source_checked_at is a documented validation check under the pinned freshness policy; processed is transformation time and assessment_completed_at is assessment completion, neither a source clock. A verified unchanged check can satisfy a policy explicitly permitting that basis, without moving the original publication time. For each summary clock take the oldest plausible lower-bound instant among the actual supporting source clocks; if any required corresponding source clock is unknown, the summary is unknown and cannot qualify a required clock. Preserve original per-source precision and qualified timezone; never invent midnight or turn served_at into verification. Projection variant: validation_receipt_id is null for customer-linked, unknown-provenance, expired or currently forbidden evidence. Only the independently typed assessment validation record UUID may appear; no Receipt lookup or new validation claim follows. Historical facts/basis/clocks remain unchanged.

Declared type: "object"

Declared fields

This list shows only properties declared directly in this schema. Required labels refer only to this schema’s own required array. Referenced, composed and conditional rules can add constraints; a field not listed as required here is not guaranteed to be optional.

source_published_at

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for source_published_at
{
  "$ref": "#/components/schemas/KnownTime"
}

source_observed_at

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for source_observed_at
{
  "$ref": "#/components/schemas/KnownTime"
}

source_checked_at

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for source_checked_at
{
  "$ref": "#/components/schemas/KnownTime"
}

assessment_completed_at

Listed in this schema’s required array.

Declared type
"string"
Declared format
"date-time"
Reading definition for assessment_completed_at
{
  "type": "string",
  "format": "date-time",
  "x-profile-maxLength": "string_characters_max"
}

freshness_policy

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for freshness_policy
{
  "$ref": "#/components/schemas/PolicyPin"
}

scope_digest

Listed in this schema’s required array.

Declared type
"string"
Reading definition for scope_digest
{
  "type": "string",
  "pattern": "^[a-f0-9]{64}$",
  "x-profile-maxLength": "string_characters_max"
}

evidence_digest

Listed in this schema’s required array.

Declared type
"string"
Reading definition for evidence_digest
{
  "type": "string",
  "pattern": "^[a-f0-9]{64}$",
  "x-profile-maxLength": "string_characters_max"
}

validation_receipt_id

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for validation_receipt_id
{
  "anyOf": [
    {
      "type": "string",
      "format": "uuid",
      "x-profile-maxLength": "string_characters_max"
    },
    {
      "type": "null"
    }
  ]
}

basis

Listed in this schema’s required array.

Declared type
"string"
Reading definition for basis
{
  "type": "string",
  "enum": [
    "new_source_evidence",
    "validated_unchanged_source",
    "newer_held_shareable_evidence"
  ],
  "x-profile-maxLength": "string_characters_max"
}

freshness_satisfied

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for freshness_satisfied
{
  "const": true
}

source_clocks

Listed in this schema’s required array.

Complete required evidence-clock set for this assessment; overflow of256 cannot be silently truncated. Reject the undeliverable assessment before settlement or use a separately specified existing evidence-page projection without changing this completeness claim.

Declared type
"array"
Reading definition for source_clocks
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/EvidenceClock"
  },
  "minItems": 1,
  "maxItems": 256,
  "x-profile-maxItems": "collection_items_max",
  "description": "Complete required evidence-clock set for this assessment; overflow of256 cannot be silently truncated. Reject the undeliverable assessment before settlement or use a separately specified existing evidence-page projection without changing this completeness claim."
}

Schema reading view

Read all retained constraints, including any allOf, oneOf, anyOf, conditional and additional-property constraints. The field list does not combine branches. Explicitly marked private-only omissions mean this view is not an executable substitute for the original schema or a released contract.

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "source_published_at": {
      "$ref": "#/components/schemas/KnownTime"
    },
    "source_observed_at": {
      "$ref": "#/components/schemas/KnownTime"
    },
    "source_checked_at": {
      "$ref": "#/components/schemas/KnownTime"
    },
    "assessment_completed_at": {
      "type": "string",
      "format": "date-time",
      "x-profile-maxLength": "string_characters_max"
    },
    "freshness_policy": {
      "$ref": "#/components/schemas/PolicyPin"
    },
    "scope_digest": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "x-profile-maxLength": "string_characters_max"
    },
    "evidence_digest": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "x-profile-maxLength": "string_characters_max"
    },
    "validation_receipt_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "x-profile-maxLength": "string_characters_max"
        },
        {
          "type": "null"
        }
      ]
    },
    "basis": {
      "type": "string",
      "enum": [
        "new_source_evidence",
        "validated_unchanged_source",
        "newer_held_shareable_evidence"
      ],
      "x-profile-maxLength": "string_characters_max"
    },
    "freshness_satisfied": {
      "const": true
    },
    "source_clocks": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/EvidenceClock"
      },
      "minItems": 1,
      "maxItems": 256,
      "x-profile-maxItems": "collection_items_max",
      "description": "Complete required evidence-clock set for this assessment; overflow of256 cannot be silently truncated. Reject the undeliverable assessment before settlement or use a separately specified existing evidence-page projection without changing this completeness claim."
    }
  },
  "required": [
    "source_published_at",
    "source_observed_at",
    "source_checked_at",
    "assessment_completed_at",
    "freshness_policy",
    "scope_digest",
    "evidence_digest",
    "validation_receipt_id",
    "basis",
    "freshness_satisfied",
    "source_clocks"
  ],
  "description": "Each supporting source has its real dates. KnownTime preserves instant/date/unknown precision; unknown cannot satisfy a required clock. Date-only intervals use the qualified source timezone, never fabricated midnight. Qualification uses the oldest plausible age; a freshness/future boundary straddle is unqualified. Server validates policy-specific age/subject/rights/quality; HTTP success, access time or identifier change alone is insufficient. Check may precede this request if qualified newer held evidence satisfies scope. Assessment clocks are immutable at completion; served_at is a separate response projection. Summary dates do not replace per-source clocks or reset them. source_published/source_published_at is the source-original publication instant/date, or unknown; acquired/source_observed_at is Sustema acquisition/observation, not source publication; verified/source_checked_at is a documented validation check under the pinned freshness policy; processed is transformation time and assessment_completed_at is assessment completion, neither a source clock. A verified unchanged check can satisfy a policy explicitly permitting that basis, without moving the original publication time. For each summary clock take the oldest plausible lower-bound instant among the actual supporting source clocks; if any required corresponding source clock is unknown, the summary is unknown and cannot qualify a required clock. Preserve original per-source precision and qualified timezone; never invent midnight or turn served_at into verification. Projection variant: validation_receipt_id is null for customer-linked, unknown-provenance, expired or currently forbidden evidence. Only the independently typed assessment validation record UUID may appear; no Receipt lookup or new validation claim follows. Historical facts/basis/clocks remain unchanged."
}

Related schemas

All API operations