Skip to main content

Evidence Schema

The AI evidence endpoints use a consistent JSON schema structure. All fields are documented below.

Allowed Statuses

StatusMeaning
implementation_presentCode exists but no execution proof artifact
local_mock_provenProven in deterministic local/mock harness only
live_provenProven with live/sandbox evidence
plannedDesign documented, implementation not started
blockedCannot proceed due to known blocker
not_claimedExplicitly not claimed
maps_toAligns with a compliance framework control
supportsSupports a compliance framework control
inheritsInherited from underlying platform/component
not_applicableNot relevant to this capability

Forbidden Statuses

The following statuses must NOT appear in any AI evidence artifact unless legally and evidentially validated:

  • certified
  • authorized
  • compliant
  • satisfied
  • guaranteed

Manifest Entry Shape

{
"id": "cap-hmac-integrity",
"name": "HMAC payload integrity",
"proof_status": "local_mock_proven",
"evidence_refs": ["zen-platform:docs/80-EVIDENCE/security/hmac_trust_execution.json"],
"validator_refs": ["make hmac-trust-execution-check"],
"merkle": {
"enabled": true,
"purpose": "evidence_integrity",
"root_ref": "zen-platform Merkle validator"
},
"non_claims": ["not_pci_certification", "not_production_zero_trust"]
}

Compliance Mapping Entry Shape

{
"compliance_id": "cm-hmac-pci",
"framework": "PCI-DSS v4.0",
"control_id": "4.2.1",
"technical_feature": "Webhook payload HMAC signing",
"relationship": "supports",
"claim_status": "maps_to",
"evidence_refs": ["zen-platform:docs/80-EVIDENCE/security/hmac_trust_execution.json"],
"notes": "Supports cryptographic protection of transmitted data channels — not a PCI compliance certification."
}

Non-Claim Entry Shape

{
"id": "nc-pci-compliance",
"category": "compliance",
"claim": "PCI DSS compliant",
"scope": "No PCI DSS certification or validation has been performed",
"evidence_status": "not_claimed"
}

Schema Files

SchemaURL
Manifest/ai/evidence/v1/manifest.schema.json
Compliance Map/ai/evidence/v1/compliance-map.schema.json