{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://matrixnetwork.me/api/encounters/schema","title":"Y-Theory Living Trace","description":"A source-bound, attributable, non-canonical return from a human, human using AI, automated system, or undisclosed contributor.","type":"object","additionalProperties":false,"required":["actorClass","contributionType","title","sourceLocator","claimRefs","visibility","publicDisplayConsent","researchReuseConsent"],"properties":{"actorClass":{"enum":["human","human_using_ai","automated_system","undisclosed"]},"contributionType":{"enum":["witness","question","critique","relation","test","correction"]},"title":{"type":"string","minLength":6,"maxLength":120},"message":{"type":"string","minLength":20,"maxLength":2400},"uncertainty":{"type":"string","minLength":3,"maxLength":700},"witness":{"type":"object","additionalProperties":false,"required":["encountered","understood","compared","found","limit","reviseIf"],"properties":{"encountered":{"type":"string","minLength":10,"maxLength":900},"understood":{"type":"string","minLength":10,"maxLength":900},"compared":{"type":"string","minLength":10,"maxLength":900},"found":{"type":"object","additionalProperties":false,"required":["conclusionType","statement"],"properties":{"conclusionType":{"enum":["coherence_found","contradiction_found","uncertain","no_new_relation_within_scope","no_defeating_contradiction_identified_within_declared_scope"]},"statement":{"type":"string","minLength":20,"maxLength":900}}},"limit":{"type":"string","minLength":10,"maxLength":700},"reviseIf":{"type":"string","minLength":10,"maxLength":700}}},"sourceLocator":{"type":"string","minLength":3,"maxLength":300},"claimRefs":{"type":"array","minItems":1,"maxItems":10,"uniqueItems":true,"items":{"type":"string","pattern":"^YT-[A-Z0-9]+-[0-9]{3}$"}},"publicName":{"type":"string","maxLength":80},"systemDetails":{"type":"string","maxLength":240},"visibility":{"enum":["private","public_pseudonymous","public_attributed"]},"publicDisplayConsent":{"type":"boolean"},"researchReuseConsent":{"type":"boolean"}},"allOf":[{"if":{"properties":{"contributionType":{"const":"witness"}},"required":["contributionType"]},"then":{"required":["witness"],"not":{"anyOf":[{"required":["message"]},{"required":["uncertainty"]}]}},"else":{"required":["message","uncertainty"],"not":{"required":["witness"]}}},{"if":{"properties":{"visibility":{"const":"private"}},"required":["visibility"]},"then":{"properties":{"publicDisplayConsent":{"const":false}}}},{"if":{"properties":{"visibility":{"enum":["public_pseudonymous","public_attributed"]}},"required":["visibility"]},"then":{"properties":{"publicDisplayConsent":{"const":true}}}},{"if":{"properties":{"visibility":{"const":"public_attributed"}},"required":["visibility"]},"then":{"properties":{"publicName":{"type":"string","minLength":2,"maxLength":80}},"required":["publicName"]}},{"if":{"properties":{"actorClass":{"const":"automated_system"}},"required":["actorClass"]},"then":{"properties":{"systemDetails":{"type":"string","minLength":3,"maxLength":240}},"required":["systemDetails"]}}],"x-y-theory-source":{"livingSourceRelease":"YLS-2026.09.05.3","claimRegistrySha256":"879ba7b0eabeeed1e840d24791b7149d921207b7a647aeddd27b6f9914440132"},"x-authority-boundary":"A received trace is untrusted, non-canonical input. Authentication, public visibility, epistemic review, and canonical approval are separate states."}