{ "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T14:23:01Z", "providers": [ "Codex", "Grok" ], "missingProviders": [], "pass": 2, "cost": { "grok": { "usd": 0.00639234, "turns": 1, "seconds": 50.8, "error": null }, "codex": { "seconds": 62.3, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.3\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a07c3f-538c-7b12-83bd-cfd76868aeee\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: pupil\nRegistry id: vr.tr.pupil\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA Vercy model" } }, "enrichment": { "pass": 3, "engine": "claude", "producedAt": "2026-10-06T11:00:00Z", "ingestedAt": "2026-10-06T08:12:31+00:00", "fields": [ "agent_conduct", "ethics", "failure_modes_and_hazards", "owners", "visual_identification" ] }, "gate": { "passed": true, "version": "1.0", "at": "2026-10-07T10:10:26+00:00", "evidence": [ "completeness 1.00", "sense: Wikidata description", "5 live sources", "review by codex: pass" ] } }, "metaModel": { "id": "THING-Q173318", "registryId": "vr.tr.pupil", "name": "pupil", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.OBJ" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q173318/", "model": { "registry_id": "vr.tr.pupil", "name": "pupil", "purpose": "Enable an AI agent to recognise an anatomical pupil, record its appearance and response under known conditions, and judge whether comparison, further observation or authorised assessment is warranted.", "definition": "The pupil is the central aperture of the iris that admits light to the retina, its diameter being set by the opposing action of the sphincter and dilator pupillae under autonomic and light-reflex control.", "scope_statement": "This model provisionally owns the pupil as the aperture bounded by the iris of an eye, including its geometry, observable changes and relationship to the fellow pupil; the anatomical interpretation requires confirmation because the registry supplies no definition.", "in_scope": [ "Identification of the pupil and its association with a particular eye", "Pupillary boundary, size, shape and position within the iris", "Changes in aperture under recorded illumination and viewing conditions", "Comparison with the fellow pupil and previous observations", "Observation quality and constraints on pupil measurement or testing" ], "out_of_scope": [ "A pupil meaning a learner or student", "The iris as tissue, including its pigmentation and structural condition", "Whole-eye anatomy, visual acuity and refractive performance", "Retinal, optic nerve and neurological conditions as independently modelled entities", "Medication administration, diagnosis and treatment planning", "Entrance and exit pupils of optical instruments" ], "distinguishing_features": [ "Identify an aperture bounded by the iris rather than labelling the entire coloured iris as the pupil.", "Distinguish the aperture boundary from reflections, shadows or dark regions elsewhere in an eye image.", "Distinguish the physical aperture from its apparent image through the eye's optics; record which representation was measured.", "Associate the structure with an anatomical eye; references to educational roles or instrument apertures require a different interpretation." ], "characteristics": [ { "name": "Eye association", "kind": "relation", "unit_or_values": "Containing eye reference; subject-relative left, right or unresolved", "why_it_matters": "Prevents observations from different eyes or subjects being combined." }, { "name": "Observed aperture size", "kind": "measurement", "unit_or_values": "Diameter or specified axis lengths in mm; pixels only when uncalibrated", "why_it_matters": "Supports comparison while preserving the distinction between physical estimates and image measurements." }, { "name": "Boundary shape", "kind": "category", "unit_or_values": "Round, oval, slit-like, irregular, other described or indeterminate", "why_it_matters": "Avoids assuming that every pupil is circular or adequately described by one diameter." }, { "name": "Aperture position", "kind": "measurement", "unit_or_values": "Centre offset in mm or normalised coordinates relative to a named iris landmark", "why_it_matters": "Allows position changes to be distinguished from changes in camera viewpoint or gaze." }, { "name": "Illumination context", "kind": "measurement", "unit_or_values": "Illuminance in lux where available, with measurement location; otherwise described lighting", "why_it_matters": "Makes size and response observations interpretable in their lighting context." }, { "name": "Observed response", "kind": "state", "unit_or_values": "Constriction observed, dilation observed, no change detected, indeterminate or not tested; stimulus and interval required", "why_it_matters": "Separates recorded behaviour from an unsupported conclusion about pupil function." }, { "name": "Response timing", "kind": "measurement", "unit_or_values": "Latency and observation duration in ms or s, with temporal resolution", "why_it_matters": "Shows whether the recording could resolve the response being described." }, { "name": "Inter-eye size difference", "kind": "measurement", "unit_or_values": "Signed difference in mm using a declared eye order and matched conditions", "why_it_matters": "Makes asymmetry explicit without assigning a cause or clinical significance." }, { "name": "Boundary visibility", "kind": "state", "unit_or_values": "Fully visible, partly obscured, not visible or uncertain; obstruction described", "why_it_matters": "Prevents poor visibility from being mistaken for an absent or unusually shaped pupil." } ], "affordances": [ "Locate and label the pupil in an eye observation while retaining uncertain boundaries.", "Measure aperture geometry using a stated calibration and method.", "Compare pupil observations across time or between eyes under matched conditions.", "Record responses during an authorised observation protocol, including which eye received the stimulus.", "Request a clearer or better controlled observation when visibility or context is inadequate.", "Flag a documented change for qualified assessment under an applicable protocol without inferring its cause." ], "agent_conduct": { "may": [ "Explain pupil anatomy and the light reflex.", "Share official guidance on when unequal or unresponsive pupils need emergency care." ], "must_not": [ "Diagnose a person from pupil size or reaction.", "Infer a person's emotions, interest or drug use from their pupils without consent.", "Recommend eye drops that change pupil size without a prescription.", "Shine strong lights into eyes." ], "requires_human": [ "Any clinical decision based on pupil findings." ] }, "ethics": { "considerations": [ "Pupil tracking can expose people's private reactions.", "Pupil changes can signal emergencies like head injury." ], "affected_parties": [ "Patients", "People subject to monitoring" ] }, "owners": { "steward": "Each person for their own body; clinicians hold records.", "master_systems": [] }, "visual_identification": [ "The black circular opening in the centre of the coloured iris.", "Constricts in bright light and widens in dim light." ], "failure_modes_and_hazards": [ "Unequal pupils can indicate a brain emergency.", "Eye-tracking technology can be misused to infer private states." ], "what_it_is_for": [ "The pupil is encountered in eye anatomy and in observations of how the eye admits light.", "Its size, symmetry and response are recorded during eye examinations and neurological assessments under known lighting conditions." ], "standards_and_regulation": [ "Terminologia Anatomica, issued by the Federative International Programme for Anatomical Terminology under the International Federation of Associations of Anatomists, standardizes the anatomical name pupilla for the pupil." ] }, "sources": [ { "id": "aao-pupils", "title": "The Pupil: Anatomy, Physiology, Abnormalities, and Clinical Testing", "url": "https://www.aao.org/education/image/pupil-anatomy-physiology-abnormalities-clinical-te", "what_it_supports": "Clinical anatomy, light-reflex testing, and named pathologic pupil types used in practice", "url_status": "live" }, { "id": "ncbi-anatomy", "title": "Anatomy, Head and Neck: Eye Pupil", "url": "https://www.ncbi.nlm.nih.gov/books/NBK551639/", "what_it_supports": "Anatomical definition, sphincter/dilator innervation, and typical adult diameter range", "url_status": "live" }, { "id": "wikidata-q10768", "title": "pupil (Q10768)", "url": "https://www.wikidata.org/wiki/Q10768", "what_it_supports": "Canonical identifier and distinction from the educational-enrolment sense of 'pupil'", "url_status": "live" }, { "id": "wikidata", "title": "Wikidata item Q173318: pupil", "url": "https://www.wikidata.org/wiki/Q173318", "url_status": "live", "what_it_supports": "identity and sense of the item", "checked_by": "wikidata-api" }, { "id": "wikipedia-en", "title": "Wikipedia: Pupil", "url": "https://en.wikipedia.org/wiki/Pupil", "url_status": "live", "what_it_supports": "general description of the item", "checked_by": "wikidata-api sitelink" } ], "structure": { "bundles": [ { "id": "pupil-identity-and-boundary", "name": "Pupil identity and boundary", "description": "Establishes which anatomical aperture is represented and where its boundary lies.", "rationale": "An agent must distinguish the pupil from surrounding tissue, imaging artefacts and other meanings of the name.", "layers": [ { "id": "anatomical-referent", "name": "Anatomical referent", "description": "Connects the pupil to its containing eye and the organism context.", "findings": [ { "id": "eye-linked-aperture", "name": "Eye-linked aperture", "description": "Record evidence that the target is an iris-bounded aperture, together with eye identity and unresolved classification.", "questions": [ { "text": "What observation establishes that this target is the pupil of an anatomical eye?", "kind": "definition", "id": "eye-linked-aperture-q01" }, { "text": "Which subject, species and subject-relative eye does the observation concern?", "kind": "provenance", "id": "eye-linked-aperture-q02" } ] } ] }, { "id": "aperture-delimitation", "name": "Aperture delimitation", "description": "Separates the pupil opening from iris tissue and the optical appearance used to observe it.", "findings": [ { "id": "supported-pupil-boundary", "name": "Supported pupil boundary", "description": "Record the visible iris edge, uncertain segments and whether the boundary is an image observation or a reconstructed physical estimate.", "questions": [ { "text": "Which portions of the proposed boundary are supported by a visible iris edge rather than shadow, reflection or occlusion?", "kind": "boundary", "id": "supported-pupil-boundary-q01" }, { "text": "Does this outline describe the apparent pupil in an image or an estimate of the physical aperture?", "kind": "definition", "id": "supported-pupil-boundary-q02" } ] } ] } ] }, { "id": "aperture-geometry", "name": "Aperture geometry", "description": "Records pupil size, shape and position using methods appropriate to the observed aperture.", "rationale": "A single diameter can conceal irregular shape, viewpoint distortion or uncertain scale.", "layers": [ { "id": "size-and-contour", "name": "Size and contour", "description": "Describes the opening without presuming circular geometry.", "findings": [ { "id": "calibrated-aperture-description", "name": "Calibrated aperture description", "description": "Record diameter, axes, area or contour as appropriate, preserving calibration and estimation uncertainty.", "questions": [ { "text": "Which dimensions or contour representation adequately describe this pupil's observed shape?", "kind": "measurement", "id": "calibrated-aperture-description-q01" }, { "text": "What scale calibration and uncertainty support the reported dimensions?", "kind": "measurement", "id": "calibrated-aperture-description-q02" } ] } ] }, { "id": "position-and-viewpoint", "name": "Position and viewpoint", "description": "Locates the aperture relative to the iris while accounting for observation angle.", "findings": [ { "id": "referenced-aperture-position", "name": "Referenced aperture position", "description": "Record pupil position against a named anatomical reference and retain gaze or camera-angle limitations.", "questions": [ { "text": "Relative to which iris landmark or coordinate system is the pupil centre located?", "kind": "measurement", "id": "referenced-aperture-position-q01" }, { "text": "Could gaze direction or camera angle explain the apparent offset or elongation?", "kind": "boundary", "id": "referenced-aperture-position-q02" } ] } ] } ] }, { "id": "pupillary-response", "name": "Pupillary response", "description": "Records aperture changes in relation to documented illumination or viewing events.", "rationale": "Pupil behaviour cannot be interpreted from size alone or from a stimulus whose timing and target are unknown.", "layers": [ { "id": "stimulus-and-baseline", "name": "Stimulus and baseline", "description": "Establishes the conditions before and during a response observation.", "findings": [ { "id": "documented-response-conditions", "name": "Documented response conditions", "description": "Record baseline lighting, adaptation interval, viewing target and the event against which change is assessed.", "questions": [ { "text": "What lighting, adaptation interval and viewing distance preceded the observation?", "kind": "provenance", "id": "documented-response-conditions-q01" }, { "text": "What stimulus or viewing change occurred, when did it occur and which eye received it?", "kind": "provenance", "id": "documented-response-conditions-q02" } ] } ] }, { "id": "response-course", "name": "Response course", "description": "Captures the direction, extent and timing of observed aperture change.", "findings": [ { "id": "observed-change-sequence", "name": "Observed change sequence", "description": "Record the measured response of the observed eye, distinguishing an undetected change from an inadequately observed response.", "questions": [ { "text": "How did pupil size change over the recorded interval, and what latency or amplitude can the measurement resolve?", "kind": "measurement", "id": "observed-change-sequence-q01" }, { "text": "Was the observed pupil in the stimulated eye or the fellow eye, and were both eyes recorded?", "kind": "provenance", "id": "observed-change-sequence-q02" }, { "text": "If no change was detected, were visibility, stimulus documentation and sampling sufficient to support that statement?", "kind": "boundary", "id": "observed-change-sequence-q03" } ] } ] } ] }, { "id": "comparison-and-observation-decisions", "name": "Comparison and observation decisions", "description": "Supports defensible comparisons and determines what further pupil observation is justified.", "rationale": "Apparent asymmetry or change must be separated from mismatched conditions before an agent acts on it.", "layers": [ { "id": "paired-and-longitudinal-comparison", "name": "Paired and longitudinal comparison", "description": "Compares pupils across eyes or time with explicit limits on comparability.", "findings": [ { "id": "condition-matched-difference", "name": "Condition-matched difference", "description": "Record the direction and magnitude of differences alongside timing, lighting and method compatibility.", "questions": [ { "text": "What size, shape or response difference is observed between the two eyes or against a previous observation?", "kind": "measurement", "id": "condition-matched-difference-q01" }, { "text": "Were lighting, viewing target, measurement method and observation timing sufficiently matched for this comparison?", "kind": "boundary", "id": "condition-matched-difference-q02" } ] } ] }, { "id": "observation-limits-and-next-actions", "name": "Observation limits and next actions", "description": "Links evidence quality and pupil-specific context to permitted follow-up.", "findings": [ { "id": "qualified-pupil-assessment", "name": "Qualified pupil assessment", "description": "Record visibility limits, relevant reported exposures or eye procedures, and the authority governing repeat observation or referral.", "questions": [ { "text": "Which occlusions, reflections, reported eye drops or prior eye procedures could limit interpretation of this observation?", "kind": "provenance", "id": "qualified-pupil-assessment-q01" }, { "text": "Does the evidence support comparison, require a repeat measurement or meet an applicable criterion for qualified assessment?", "kind": "action", "id": "qualified-pupil-assessment-q02" }, { "text": "What authorisation and protocol govern any further light-response testing or other intervention involving this eye?", "kind": "action", "id": "qualified-pupil-assessment-q03" } ] } ] } ] }, { "id": "evidence-and-external-alignment", "name": "Evidence and external alignment", "description": "What the world already says about this thing, gathered so the model can be checked against it.", "rationale": "A model that cannot be lined up against existing standards, identifiers and practice cannot be adopted by anyone who already uses them.", "layers": [ { "id": "reported-evidence", "name": "Reported evidence", "description": "Findings from the breadth pass, kept separate from the structural claims.", "findings": [ { "id": "evidence-kinds", "name": "Kinds and varieties", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "physiologic (light-responsive) pupil", "anisocoric pupil (unequal diameters)", "miotic pupil", "mydriatic pupil", "relative afferent pupillary defect (Marcus Gunn pupil)", "tonic (Adie) pupil", "Argyll Robertson pupil", "Horner (oculosympathetic) pupil" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of pupil this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "scheme": "Wikidata", "value_or_pattern": "Q10768", "note": "Anatomical pupil of the eye; not the student sense" }, { "scheme": "FMA", "value_or_pattern": "58252", "note": "Foundational Model of Anatomy: Pupil" }, { "scheme": "UBERON", "value_or_pattern": "UBERON:0001771", "note": "uberon pupil" }, { "scheme": "MeSH", "value_or_pattern": "D011680", "note": "Pupils" }, { "scheme": "SNOMED CT", "value_or_pattern": "392406005", "note": "Pupil structure (body structure)" } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of pupil this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "ISO 15004-2 (Ophthalmic instruments - Fundamental requirements and test methods - Light hazard protection), International Organization for Standardization - photic-safety calculations use a 7 mm dilated pupil as the conservative entrance-pupil diameter", "CIE / ISO 11664 series and related photometric practice - luminous quantities at the eye are referred to the entrance pupil", "Clinical documentation of pupil size and reactivity is governed by local medical-record and emergency-care protocols (e.g. GCS eye-opening and PERRLA charting), not by a single global product standard" ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of pupil this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Bedside and emergency neurological examination: size, symmetry, and light reactivity (PERRLA) as a window on midbrain and cranial-nerve function", "Ophthalmology and optometry: entrance pupil for refraction, intraocular-lens calculation, and imaging (fundus photography, OCT, perimetry)", "Pharmacology: miotics and mydriatics used to constrict or dilate the pupil for examination, surgery, or glaucoma therapy", "Optics and photography: the eye's entrance pupil sets retinal illuminance and depth of field; camera and VR/AR optical designs match or assume a human pupil diameter", "Forensic and occupational: pupil size under drugs, toxins, or workplace lighting as a clinical or safety sign" ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of pupil this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "quantity": "resting diameter in typical indoor light", "typical_range": "2-4", "unit": "mm" }, { "quantity": "diameter in darkness (maximal physiologic dilation)", "typical_range": "4-8 (rarely to ~9 in young adults)", "unit": "mm" }, { "quantity": "diameter under bright light (miosis)", "typical_range": "1-2", "unit": "mm" }, { "quantity": "anisocoria regarded as physiologic when isolated and stable", "typical_range": "≤0.4-0.5", "unit": "mm" }, { "quantity": "latency of the direct light reflex", "typical_range": "0.2-0.5", "unit": "s" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of pupil this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Fixed dilated pupil after trauma or herniation - neurosurgical emergency when new and unilateral with declining consciousness", "Pharmacologic mydriasis or miosis mimicking nerve palsy or intoxication", "Relative afferent pupillary defect indicating asymmetric optic-nerve or severe retinal disease", "Acute angle-closure glaucoma precipitated by mid-dilated pupil in anatomically predisposed eyes", "Phototoxicity and glare when a large pupil admits excess light (post-mydriasis, traumatic iris sphincter tear)", "Surgical or traumatic iris damage producing a permanently irregular or atonic pupil with glare and reduced acuity" ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of pupil this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "English 'pupil' is also the school-enrolment term (especially UK/Commonwealth); anatomical use is unambiguous in clinical contexts but collides in general registries", "Named eponyms (Argyll Robertson, Adie, Horner, Marcus Gunn) are used worldwide in neurology; some jurisdictions prefer descriptive terms (e.g. 'light-near dissociation', 'tonic pupil', 'oculosympathetic palsy')", "Pharmacologic mydriatic combinations and legal constraints on topical agents (e.g. atropine, tropicamide) vary by national formulary" ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of pupil this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "name": "iris", "difference": "The iris is the contractile pigmented diaphragm; the pupil is the aperture it forms, not a separate tissue" }, { "name": "entrance pupil (optics)", "difference": "The optical entrance pupil is the image of the anatomical pupil as seen through the cornea; it is slightly magnified and is the quantity used in photometry and instrument design" }, { "name": "pupil of a student / school pupil", "difference": "Homonym: a person enrolled in education (Wikidata Q1344284 and related), not an ocular aperture" }, { "name": "artificial / prosthetic pupil or pinhole", "difference": "An implanted or external aperture (iris prosthesis, pinhole occluder) that substitutes for the natural pupil rather than being it" }, { "name": "coloboma or iridectomy opening", "difference": "A structural defect or surgical gap in the iris that may enlarge or distort the true pupillary margin rather than being a physiologic pupil" } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of pupil this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does vr.tr.pupil denote the anatomical pupil, and is its intended coverage human-only or inclusive of other species?", "Does an existing Vercy eye or anatomical-aperture model already own this concept, requiring a link instead of a separate publication?", "Which measurement conventions should distinguish the physical aperture from its apparent optical image across supported devices?", "Which species-, age- and context-specific evidence should govern interpretation of pupil geometry, inter-eye differences and response measurements?", "Which sourced protocols define permitted observation methods and thresholds for repeat measurement or qualified assessment?" ], "statistics": { "bundles": 5, "layers": 9, "findings": 16, "questions": 26 } }