{
    "model": {
        "rank": 5679,
        "code": "thing-q23797",
        "model_id": "vr.tr.contact-lens",
        "name": "contact lens",
        "purpose": "Enable an AI agent to recognise a contact lens, assess its documented suitability and current condition, and identify which handling or use actions are supported by available evidence.",
        "family": "Thing Registry",
        "category": "Physical world and living systems",
        "status": "research-draft",
        "kind": "thing",
        "plane": "PHY",
        "domain": "PHY.OBJ",
        "industry": "",
        "version": "",
        "url": "/models/thing/q23797/",
        "tier": 2,
        "score": 65,
        "payload": {
            "layer": "wikidata",
            "aliases": [
                "Night-vision contact lens",
                "therapeutic contact lens",
                "bionic contact lens",
                "circle contact lens",
                "hydrophilic contact lenses",
                "scleral lens",
                "colored contact lens"
            ],
            "aliasCount": 7,
            "merged": 7,
            "knownIn": 65,
            "facets": null,
            "markers": [],
            "lexicalClass": "",
            "senseRank": null,
            "alsoRegisteredAs": null,
            "source": {
                "dataset": "wikidata",
                "item": "Q23797",
                "url": "https://www.wikidata.org/wiki/Q23797",
                "license": "CC0 1.0"
            }
        },
        "research": {
            "vercy": "1.0-draft",
            "publication": {
                "status": "research-draft",
                "adjudicationStatus": "unreviewed",
                "publishableCanonical": false,
                "generatedAt": "2026-09-07T09:00:02Z",
                "providers": [
                    "Codex"
                ],
                "missingProviders": [
                    "Grok"
                ],
                "pass": 2,
                "cost": {
                    "grok": {
                        "usd": null,
                        "turns": null,
                        "seconds": 6,
                        "error": "Error: Internal error: {\n  \"message\": \"API error (status 402 Payment Required): Grok Build usage balance exhausted\",\n  \"http_status\": 402\n}",
                        "retried": true
                    },
                    "codex": {
                        "seconds": 91.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: 01a07b17-2f43-7bc2-aa7f-c147d250d3ee\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: contact lens\nRegistry id: vr.tr.contact-lens\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n"
                    }
                }
            },
            "metaModel": {
                "id": "THING-Q23797",
                "registryId": "vr.tr.contact-lens",
                "name": "contact lens",
                "version": "0.1.0-research.1",
                "entryKind": "thing",
                "family": "Thing Registry",
                "domain": [
                    "PHY.OBJ"
                ],
                "status": "research-draft"
            },
            "canonicalUrl": "https://ver.cy/models/thing/q23797/",
            "model": {
                "registry_id": "vr.tr.contact-lens",
                "name": "contact lens",
                "purpose": "Enable an AI agent to recognise a contact lens, assess its documented suitability and current condition, and identify which handling or use actions are supported by available evidence.",
                "definition": "",
                "scope_statement": "This model owns an individual contact lens as a physical object worn on the eye, including its design, optical properties, fit relationships, provenance, condition and use constraints, while distinguishing product specifications from observations about that lens.",
                "in_scope": [
                    "Lens identity, material, geometry and intended function",
                    "Optical properties and orientation requirements",
                    "Relationship to a particular wearer, eye and documented fitting",
                    "Packaging, opening, wear, care and replacement history",
                    "Observed condition and evidence governing further handling or use"
                ],
                "out_of_scope": [
                    "The wearer's complete eye anatomy, diagnoses and medical history",
                    "Clinical examination, prescribing and treatment decisions",
                    "Spectacles, spectacle lenses and intraocular implants",
                    "Care solutions, storage cases and insertion tools as independent products",
                    "Retail orders, insurance coverage and appointment management"
                ],
                "distinguishing_features": [
                    "Designed to be worn directly on the eye, rather than supported in a spectacle frame in front of it.",
                    "An externally applied lens, rather than a surgically implanted intraocular lens.",
                    "Has a defined lens body with ocular fitting geometry, rather than being an eye drop, ointment or cleaning solution.",
                    "May have corrective, cosmetic or therapeutic intent; absence of corrective power does not by itself exclude a contact lens.",
                    "A prescription, package or product listing describes or contains a contact lens but is not itself the individual lens."
                ],
                "characteristics": [
                    {
                        "name": "Design family",
                        "kind": "category",
                        "unit_or_values": "Soft, rigid corneal, scleral, hybrid, other documented design, unknown",
                        "why_it_matters": "Determines which geometry, fitting and care information is relevant."
                    },
                    {
                        "name": "Intended function",
                        "kind": "category",
                        "unit_or_values": "Refractive correction, cosmetic appearance, therapeutic protection, corneal reshaping, other documented function; multiple values permitted",
                        "why_it_matters": "Prevents judging every lens solely by its corrective power."
                    },
                    {
                        "name": "Material designation",
                        "kind": "category",
                        "unit_or_values": "Documented material name and material family, or unknown",
                        "why_it_matters": "Connects the lens to applicable manufacturer specifications and care compatibility."
                    },
                    {
                        "name": "Optical prescription",
                        "kind": "measurement",
                        "unit_or_values": "Sphere, cylinder and addition in dioptres; axis in degrees; design-specific optical parameters where applicable",
                        "why_it_matters": "Supports comparison with the intended eye's documented optical requirements."
                    },
                    {
                        "name": "Fitting geometry",
                        "kind": "measurement",
                        "unit_or_values": "Diameter and labelled base curve in millimetres; sagittal depth and peripheral geometry with explicit units where applicable",
                        "why_it_matters": "Identifies fitting parameters without treating matching numbers as proof of equivalent fit."
                    },
                    {
                        "name": "Wearer and eye assignment",
                        "kind": "relation",
                        "unit_or_values": "Reference to wearer, right or left eye, applicable prescription and fitting record",
                        "why_it_matters": "Separates physical identity from suitability for a particular eye."
                    },
                    {
                        "name": "Product provenance",
                        "kind": "relation",
                        "unit_or_values": "Manufacturer, product designation, lot or serial identifier when available, and source package",
                        "why_it_matters": "Supports verification of specifications, expiry and product-specific restrictions."
                    },
                    {
                        "name": "Wear and replacement regimen",
                        "kind": "category",
                        "unit_or_values": "Documented permitted wear pattern, replacement interval, interval trigger and governing instruction",
                        "why_it_matters": "Distinguishes a wear session from the lens's total permitted service period."
                    },
                    {
                        "name": "Lifecycle position",
                        "kind": "state",
                        "unit_or_values": "Sealed, opened, stored, being worn, removed, withheld from use, discarded, unknown",
                        "why_it_matters": "Determines which history and checks matter before a proposed action."
                    },
                    {
                        "name": "Observed physical condition",
                        "kind": "state",
                        "unit_or_values": "Documented observations of integrity, deposits, discoloration, deformation and hydration where applicable; observation time and uncertainty",
                        "why_it_matters": "Keeps observed condition distinct from an unsupported conclusion that the lens is fit for use."
                    },
                    {
                        "name": "Care and exposure history",
                        "kind": "relation",
                        "unit_or_values": "References to cleaning, disinfection, storage and exposure events, including unknown periods",
                        "why_it_matters": "Makes handling history available when evaluating continued use."
                    }
                ],
                "affordances": [
                    "Identify the lens and associate it with its source package and product instructions.",
                    "Compare documented optical and fitting properties with the intended wearer and eye.",
                    "Inspect and record visible condition, orientation and unresolved identity questions.",
                    "Track opening, wear, removal, storage, care and replacement events.",
                    "Evaluate a proposed handling or wear action against documented instructions and fitting constraints.",
                    "Flag the lens for withheld use, professional review, replacement or disposal when the evidence supports that disposition."
                ]
            },
            "sources": [],
            "structure": {
                "bundles": [
                    {
                        "id": "lens-identity-and-design",
                        "name": "Lens identity and design",
                        "description": "Establishes what kind of contact lens this is and which product-level claims apply to it.",
                        "rationale": "Appearance alone may not reveal a lens's material, function or source product.",
                        "layers": [
                            {
                                "id": "design-and-purpose",
                                "name": "Design and purpose",
                                "description": "Distinguishes the lens's physical design from its intended optical, cosmetic or therapeutic role.",
                                "findings": [
                                    {
                                        "id": "documented-lens-type",
                                        "name": "Documented lens type",
                                        "description": "Record design family, material designation and intended functions with their evidence and any unresolved classification.",
                                        "questions": [
                                            {
                                                "text": "Which lens design, material and intended functions are explicitly documented?",
                                                "kind": "definition",
                                                "id": "documented-lens-type-q01"
                                            },
                                            {
                                                "text": "What evidence distinguishes this item from a spectacle lens, intraocular implant or non-lens ocular covering?",
                                                "kind": "boundary",
                                                "id": "documented-lens-type-q02"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "individual-to-product-link",
                                "name": "Individual-to-product link",
                                "description": "Connects a physical lens to its identifying package and specifications.",
                                "findings": [
                                    {
                                        "id": "traceable-product-identity",
                                        "name": "Traceable product identity",
                                        "description": "Record the product, manufacturer and available batch identifiers without assuming an unpackaged lens remains identifiable.",
                                        "questions": [
                                            {
                                                "text": "Which package, dispensing record or marking establishes this lens's product and lot identity?",
                                                "kind": "provenance",
                                                "id": "traceable-product-identity-q01"
                                            },
                                            {
                                                "text": "After removal from its package, what evidence preserves or weakens that identity link?",
                                                "kind": "provenance",
                                                "id": "traceable-product-identity-q02"
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "optical-and-appearance-function",
                        "name": "Optical and appearance function",
                        "description": "Records the lens's optical specification and any intentional appearance effects.",
                        "rationale": "Lenses with similar appearance may differ in power, optical zones, orientation requirements or cosmetic purpose.",
                        "layers": [
                            {
                                "id": "optical-specification",
                                "name": "Optical specification",
                                "description": "Captures the optical parameters relevant to the documented lens design.",
                                "findings": [
                                    {
                                        "id": "labelled-and-verified-optics",
                                        "name": "Labelled and verified optics",
                                        "description": "Keep labelled optical values separate from measured values and wearer-reported visual performance.",
                                        "questions": [
                                            {
                                                "text": "What sphere, cylinder, axis, addition or other design-specific optical values are documented, and which are inapplicable?",
                                                "kind": "measurement",
                                                "id": "labelled-and-verified-optics-q01"
                                            },
                                            {
                                                "text": "Do these values come from packaging, a prescription, a manufacturer specification or an actual measurement of this lens?",
                                                "kind": "provenance",
                                                "id": "labelled-and-verified-optics-q02"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "zones-tints-and-orientation",
                                "name": "Zones, tints and orientation",
                                "description": "Describes optical or cosmetic regions and their dependence on lens position.",
                                "findings": [
                                    {
                                        "id": "functional-regions-and-markings",
                                        "name": "Functional regions and markings",
                                        "description": "Record documented optical zones, pigmentation and orientation indicators, including uncertainty about their interpretation.",
                                        "questions": [
                                            {
                                                "text": "Which regions or markings serve optical, cosmetic, handling or orientation functions?",
                                                "kind": "definition",
                                                "id": "functional-regions-and-markings-q01"
                                            },
                                            {
                                                "text": "What orientation or centration checks are specified for this design before its performance can be judged?",
                                                "kind": "action",
                                                "id": "functional-regions-and-markings-q02"
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "eye-interface-and-fit",
                        "name": "Eye interface and fit",
                        "description": "Relates lens geometry and observed on-eye behaviour to a particular wearer and eye.",
                        "rationale": "Product specifications do not by themselves establish suitability for an individual eye.",
                        "layers": [
                            {
                                "id": "fitting-geometry",
                                "name": "Fitting geometry",
                                "description": "Records the design-specific dimensions and surfaces involved in fitting.",
                                "findings": [
                                    {
                                        "id": "geometry-with-design-context",
                                        "name": "Geometry with design context",
                                        "description": "Record dimensions with their definitions, units and source, preserving differences between design families.",
                                        "questions": [
                                            {
                                                "text": "Which diameter, base curve, sagittal depth or peripheral parameters describe this design, and what are their values and units?",
                                                "kind": "measurement",
                                                "id": "geometry-with-design-context-q01"
                                            },
                                            {
                                                "text": "Which parameters are insufficient to establish interchangeability with another lens product?",
                                                "kind": "boundary",
                                                "id": "geometry-with-design-context-q02"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "wearer-specific-fit-evidence",
                                "name": "Wearer-specific fit evidence",
                                "description": "Connects the lens to its assigned eye and documented fitting observations.",
                                "findings": [
                                    {
                                        "id": "assigned-eye-and-observed-fit",
                                        "name": "Assigned eye and observed fit",
                                        "description": "Reference the applicable fitting record and distinguish professional observations from wearer reports.",
                                        "questions": [
                                            {
                                                "text": "For which wearer and eye was this product and parameter combination prescribed or fitted, and when?",
                                                "kind": "provenance",
                                                "id": "assigned-eye-and-observed-fit-q01"
                                            },
                                            {
                                                "text": "What observations of centration, movement, rotation or clearance are available for this design, and who assessed them?",
                                                "kind": "measurement",
                                                "id": "assigned-eye-and-observed-fit-q02"
                                            },
                                            {
                                                "text": "Which proposed changes require a new fitting decision rather than reuse of an existing record?",
                                                "kind": "boundary",
                                                "id": "assigned-eye-and-observed-fit-q03"
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "wear-care-and-replacement",
                        "name": "Wear, care and replacement",
                        "description": "Tracks the instructions and events that govern the lens's service life.",
                        "rationale": "Wear duration, replacement timing and care requirements are separate constraints that depend on the identified lens.",
                        "layers": [
                            {
                                "id": "wear-and-replacement-clocks",
                                "name": "Wear and replacement clocks",
                                "description": "Separates package expiry, opening date, wear sessions and replacement triggers.",
                                "findings": [
                                    {
                                        "id": "applicable-use-intervals",
                                        "name": "Applicable use intervals",
                                        "description": "Record each documented interval together with its starting event, authority and available history.",
                                        "questions": [
                                            {
                                                "text": "What instructions establish permitted wear patterns, replacement intervals and package expiry?",
                                                "kind": "provenance",
                                                "id": "applicable-use-intervals-q01"
                                            },
                                            {
                                                "text": "Which opening dates, wear sessions and replacement-triggering events are known or missing?",
                                                "kind": "measurement",
                                                "id": "applicable-use-intervals-q02"
                                            },
                                            {
                                                "text": "Does the proposed wear session satisfy each applicable documented constraint?",
                                                "kind": "action",
                                                "id": "applicable-use-intervals-q03"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "lens-specific-care",
                                "name": "Lens-specific care",
                                "description": "Connects cleaning, disinfection and storage events to the instructions for this lens.",
                                "findings": [
                                    {
                                        "id": "care-compatibility-and-completion",
                                        "name": "Care compatibility and completion",
                                        "description": "Record whether reuse is permitted and, where applicable, which care process was used and completed.",
                                        "questions": [
                                            {
                                                "text": "Do the applicable instructions permit reuse, and which care products and processes do they specify?",
                                                "kind": "action",
                                                "id": "care-compatibility-and-completion-q01"
                                            },
                                            {
                                                "text": "What evidence records the last care cycle, storage conditions and any required completion or neutralisation step?",
                                                "kind": "provenance",
                                                "id": "care-compatibility-and-completion-q02"
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "condition-and-use-disposition",
                        "name": "Condition and use disposition",
                        "description": "Combines observations, exposure history and unresolved concerns to support a bounded next action.",
                        "rationale": "An intact-looking lens may still have unknown history, and symptoms during wear cannot be diagnosed from the object alone.",
                        "layers": [
                            {
                                "id": "integrity-and-exposure",
                                "name": "Integrity and exposure",
                                "description": "Records physical observations and events that may affect the lens's condition.",
                                "findings": [
                                    {
                                        "id": "observed-defects-and-history-gaps",
                                        "name": "Observed defects and history gaps",
                                        "description": "Record tears, chips, deposits, deformation, drying or relevant exposures without treating an absence of visible defects as verification of suitability.",
                                        "questions": [
                                            {
                                                "text": "What defects or changes were observed, by what method and at what time?",
                                                "kind": "measurement",
                                                "id": "observed-defects-and-history-gaps-q01"
                                            },
                                            {
                                                "text": "What contact with water, other substances, surfaces or unidentified storage conditions is documented or unresolved?",
                                                "kind": "provenance",
                                                "id": "observed-defects-and-history-gaps-q02"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "evidence-based-next-action",
                                "name": "Evidence-based next action",
                                "description": "Records a proposed disposition and the evidence or missing decision on which it depends.",
                                "findings": [
                                    {
                                        "id": "use-readiness-and-escalation",
                                        "name": "Use readiness and escalation",
                                        "description": "Distinguish documented support for an action from unresolved suitability, and link wearer concerns to appropriate clinical review without assigning a diagnosis.",
                                        "questions": [
                                            {
                                                "text": "Which evidence supports wearing, caring for, storing, withholding, replacing or discarding this lens?",
                                                "kind": "action",
                                                "id": "use-readiness-and-escalation-q01"
                                            },
                                            {
                                                "text": "Which missing records, condition concerns or wearer-reported problems prevent the proposed action from being supported?",
                                                "kind": "boundary",
                                                "id": "use-readiness-and-escalation-q02"
                                            },
                                            {
                                                "text": "What product instruction or professional decision is needed to resolve the outstanding concern?",
                                                "kind": "action",
                                                "id": "use-readiness-and-escalation-q03"
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    }
                ]
            },
            "openQuestions": [
                "Does the registry intend this entry to include specialist therapeutic and corneal-reshaping lenses, and are any already owned by another model?",
                "Which authoritative sources should define minimum geometry and fitting evidence for soft, rigid corneal, scleral and hybrid designs?",
                "How should conflicting manufacturer instructions, dispensing records and wearer-specific professional directions be represented and resolved?",
                "What evidence is sufficient to preserve individual lens identity after unpacking, especially when paired lenses look alike?",
                "Which condition or exposure observations support a defined disposition, and which must remain unresolved pending professional assessment?"
            ],
            "statistics": {
                "bundles": 5,
                "layers": 10,
                "findings": 10,
                "questions": 23
            }
        },
        "draft": {
            "generator": "vr.draft.v3",
            "status": "draft-generated",
            "researched": false,
            "archetype": "device, machine or tool",
            "method": "Written from the archetype playbook - what this kind of thing needs beyond identity and provenance - and from the structure that recurred across 6,333 models already researched by two engines. Applied to this entry by rule. No source was read for this thing and no claim here is researched. This entry carries no facets of its own, so they were inferred from its domain - a guess about a whole domain applied to one thing.",
            "facetsInferred": true,
            "nextPass": "A researcher replaces this draft with a sourced specification. Treat every sentence below as a proposal to argue with.",
            "purpose": "Give an agent a durable, checkable way to recognise a contact lens, record what state it is in, and decide what may be done with it.",
            "whatItIs": "Enable an AI agent to recognise a contact lens, assess its documented suitability and current condition, and identify which handling or use actions are supported by available evidence.",
            "characteristics": {
                "substance": "material",
                "origin": "manufactured",
                "agency": "inert",
                "mobility": "varies"
            },
            "whatYouCanDoWithIt": [
                "observed and measured"
            ],
            "distinguishingFeatures": [
                "Names folded into this entry, which a task may need to split apart again: Night-vision contact lens, therapeutic contact lens, bionic contact lens, circle contact lens, hydrophilic contact lenses, scleral lens, colored contact lens.",
                "7 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.",
                "Described in 65 Wikipedia languages, which is a measure of how widely the thing is known, not of how important it is."
            ],
            "openQuestionsForResearch": [
                "Which of the bundles below does a real task actually need, and which are ceremony?",
                "What does this thing have that the facets do not capture at all?",
                "Which neighbouring kind is most often confused with a contact lens, and on what evidence are they told apart?"
            ],
            "whatItIsMadeOf": "matter you can touch",
            "physicalCharacter": [
                "Mobility varies between examples.",
                "Does nothing on its own; everything it does, something else did to it.",
                "These come from the domain this entry sits in rather than from the entry itself, so treat them as a first guess about the whole domain applied to one thing."
            ],
            "whatCanBeDoneWithIt": [
                "observe it, measure it, record its state"
            ],
            "howItIsRecognised": [
                "Recognised by form, by the arrangement of its controls, and by markings - a plate, a model number, a certification mark. Form alone rarely separates two models that do very different things."
            ],
            "relatedModels": [
                {
                    "relation": "covers",
                    "note": "Finer kinds folded into this entry because telling them apart needs a task that asks for it. Each is a model waiting to be split out when one does.",
                    "targets": [
                        "Night-vision contact lens",
                        "therapeutic contact lens",
                        "bionic contact lens",
                        "circle contact lens",
                        "hydrophilic contact lenses",
                        "scleral lens",
                        "colored contact lens"
                    ]
                }
            ],
            "standing": "Described in 65 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 7 finer distinctions are held inside this entry as names rather than as separate models.",
            "structure": {
                "bundles": [
                    {
                        "id": "identity-and-classification",
                        "name": "Identity, naming and classification",
                        "description": "How an agent tells one contact lens from another, and a contact lens from things that resemble it.",
                        "rationale": "Recognition comes before every other claim. Without stable identity nothing else in the model can be trusted to be about the same thing twice.",
                        "layers": [
                            {
                                "id": "naming-and-identifiers",
                                "name": "Names and identifiers",
                                "description": "The names this thing goes by and the identifiers that survive translation and time.",
                                "findings": [
                                    {
                                        "id": "preferred-name-and-aliases",
                                        "name": "Preferred name, aliases and local names",
                                        "description": "Which name to use, which names mean the same thing, and which merely sound similar.",
                                        "questions": [
                                            {
                                                "id": "preferred-name-and-aliases-q01",
                                                "text": "What identifies and describes the name of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "preferred-name-and-aliases-q02",
                                                "text": "Who or what asserted this about the name of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "preferred-name-and-aliases-q03",
                                                "text": "What may an agent decide or do once the name of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    },
                                    {
                                        "id": "stable-identifiers",
                                        "name": "Stable identifiers and external keys",
                                        "description": "Identifiers that keep pointing at this kind of thing across systems and languages.",
                                        "questions": [
                                            {
                                                "id": "stable-identifiers-q01",
                                                "text": "What identifies and describes an identifier for a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "stable-identifiers-q02",
                                                "text": "Who or what asserted this about an identifier for a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "stable-identifiers-q03",
                                                "text": "What may an agent decide or do once an identifier for a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "classification-and-granularity",
                                "name": "Classification and granularity",
                                "description": "Where a contact lens sits among kinds, and how finely a task needs to cut it.",
                                "findings": [
                                    {
                                        "id": "kind-and-parents",
                                        "name": "Kind, parents and neighbouring kinds",
                                        "description": "The classes this thing belongs to and the ones it is next to.",
                                        "questions": [
                                            {
                                                "id": "kind-and-parents-q01",
                                                "text": "What identifies and describes the kind of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "kind-and-parents-q02",
                                                "text": "Who or what asserted this about the kind of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "kind-and-parents-q03",
                                                "text": "What may an agent decide or do once the kind of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    },
                                    {
                                        "id": "distinguishing-features",
                                        "name": "Distinguishing features",
                                        "description": "What separates a contact lens from the things most often confused with it.",
                                        "questions": [
                                            {
                                                "id": "distinguishing-features-q01",
                                                "text": "What identifies and describes what distinguishes a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "distinguishing-features-q02",
                                                "text": "Who or what asserted this about what distinguishes a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "distinguishing-features-q03",
                                                "text": "What may an agent decide or do once what distinguishes a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "form-and-composition",
                        "name": "Form, composition and condition",
                        "description": "What a contact lens is made of, what shape and size it takes, and what state it is in.",
                        "rationale": "A physical thing can be measured, and a model that cannot record its measurements cannot support any decision that depends on them.",
                        "layers": [
                            {
                                "id": "form-and-dimensions",
                                "name": "Form and dimensions",
                                "description": "Shape, size, mass and the ranges these take across examples.",
                                "findings": [
                                    {
                                        "id": "measurable-dimensions",
                                        "name": "Measurable dimensions and their units",
                                        "description": "The quantities worth recording and the units they are recorded in.",
                                        "questions": [
                                            {
                                                "id": "measurable-dimensions-q01",
                                                "text": "What identifies and describes the dimensions of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "measurable-dimensions-q02",
                                                "text": "Who or what asserted this about the dimensions of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "measurable-dimensions-q03",
                                                "text": "What may an agent decide or do once the dimensions of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "material-and-composition",
                                "name": "Material and composition",
                                "description": "Materials, parts and how they are put together.",
                                "findings": [
                                    {
                                        "id": "parts-and-materials",
                                        "name": "Parts and materials",
                                        "description": "What a contact lens is built from and which parts are replaceable.",
                                        "questions": [
                                            {
                                                "id": "parts-and-materials-q01",
                                                "text": "What identifies and describes the composition of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "parts-and-materials-q02",
                                                "text": "Who or what asserted this about the composition of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "parts-and-materials-q03",
                                                "text": "What may an agent decide or do once the composition of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "condition-and-integrity",
                                "name": "Condition and integrity",
                                "description": "Wear, damage, health and the difference between working and broken.",
                                "findings": [
                                    {
                                        "id": "condition-assessment",
                                        "name": "Condition, damage and health",
                                        "description": "How the condition of a contact lens is judged and by whom.",
                                        "questions": [
                                            {
                                                "id": "condition-assessment-q01",
                                                "text": "What identifies and describes the condition of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "condition-assessment-q02",
                                                "text": "Who or what asserted this about the condition of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "condition-assessment-q03",
                                                "text": "What may an agent decide or do once the condition of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "place-and-movement",
                        "name": "Place and movement",
                        "description": "Where a contact lens is, how it got there and where it may go (varies).",
                        "rationale": "A thing that can move needs its position recorded with a time, or every later claim about it is about a place it has left.",
                        "layers": [
                            {
                                "id": "location-and-placement",
                                "name": "Location and placement",
                                "description": "Position, containment and the reference frame the position is given in.",
                                "findings": [
                                    {
                                        "id": "position-and-frame",
                                        "name": "Position, container and reference frame",
                                        "description": "Where a contact lens is, and what that position is measured against.",
                                        "questions": [
                                            {
                                                "id": "position-and-frame-q01",
                                                "text": "What identifies and describes the location of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "position-and-frame-q02",
                                                "text": "Who or what asserted this about the location of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "position-and-frame-q03",
                                                "text": "What may an agent decide or do once the location of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "movement-and-transfer",
                                "name": "Movement and transfer",
                                "description": "How a contact lens is carried, installed or relocated.",
                                "findings": [
                                    {
                                        "id": "movement-events",
                                        "name": "Movement events and constraints",
                                        "description": "What counts as a movement, what records it and what limits it.",
                                        "questions": [
                                            {
                                                "id": "movement-events-q01",
                                                "text": "What identifies and describes the movement of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "movement-events-q02",
                                                "text": "Who or what asserted this about the movement of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "movement-events-q03",
                                                "text": "What may an agent decide or do once the movement of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "state-and-lifecycle",
                        "name": "State and lifecycle",
                        "description": "The states a contact lens passes through and the events that move it between them.",
                        "rationale": "Most decisions about a thing depend on what state it is in now, which is a claim with a time on it, not a property.",
                        "layers": [
                            {
                                "id": "lifecycle-stages",
                                "name": "Lifecycle stages",
                                "description": "From coming into existence to ceasing to be one of these.",
                                "findings": [
                                    {
                                        "id": "stages-and-transitions",
                                        "name": "Stages and transitions",
                                        "description": "The stages worth naming and what moves a contact lens between them.",
                                        "questions": [
                                            {
                                                "id": "stages-and-transitions-q01",
                                                "text": "What identifies and describes the lifecycle of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "stages-and-transitions-q02",
                                                "text": "Who or what asserted this about the lifecycle of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "stages-and-transitions-q03",
                                                "text": "What may an agent decide or do once the lifecycle of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "observations-and-status",
                                "name": "Observations and current status",
                                "description": "What is observed about a contact lens, how often and by whom.",
                                "findings": [
                                    {
                                        "id": "observation-record",
                                        "name": "Observation record",
                                        "description": "How an observation of a contact lens is recorded so that it can be superseded rather than overwritten.",
                                        "questions": [
                                            {
                                                "id": "observation-record-q01",
                                                "text": "What identifies and describes an observation of a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "observation-record-q02",
                                                "text": "Who or what asserted this about an observation of a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "observation-record-q03",
                                                "text": "What may an agent decide or do once an observation of a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "function-and-principle",
                        "name": "Function and operating principle",
                        "description": "What contact lens is for and how it achieves it.",
                        "rationale": "Two devices with the same name can work on different principles, and the principle is what predicts failure and constrains use.",
                        "layers": [
                            {
                                "id": "intended-function",
                                "name": "Intended function",
                                "description": "The job it does, and the jobs it is used for anyway.",
                                "findings": [
                                    {
                                        "id": "function-record",
                                        "name": "Function, principle and variants",
                                        "description": "What it does, how, and which variants do it differently.",
                                        "questions": [
                                            {
                                                "id": "function-record-q01",
                                                "text": "What function does contact lens perform, on what operating principle, and which variants differ in that principle?",
                                                "kind": "definition"
                                            },
                                            {
                                                "id": "function-record-q02",
                                                "text": "What use falls outside the intended function but happens in practice?",
                                                "kind": "boundary"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "capacity-and-rating",
                                "name": "Capacity and rating",
                                "description": "The numbers that say what it can do and where it stops.",
                                "findings": [
                                    {
                                        "id": "ratings",
                                        "name": "Ratings and their conditions",
                                        "description": "Rated capacity, power, throughput and the conditions each assumes.",
                                        "questions": [
                                            {
                                                "id": "ratings-q01",
                                                "text": "What ratings characterise contact lens, in what units, and under what stated conditions?",
                                                "kind": "measurement"
                                            },
                                            {
                                                "id": "ratings-q02",
                                                "text": "What happens beyond the rating - degradation, refusal, damage - and how is that detected?",
                                                "kind": "action"
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "operation-and-state",
                        "name": "Operation, controls and state",
                        "description": "How contact lens is operated and what state it is in right now.",
                        "rationale": "An agent acting on a device needs its current state and the controls that change it, not just its specification.",
                        "layers": [
                            {
                                "id": "controls-and-modes",
                                "name": "Controls and modes",
                                "description": "What can be set, what that changes, and what is interlocked.",
                                "findings": [
                                    {
                                        "id": "control-surface",
                                        "name": "Control surface and interlocks",
                                        "description": "The settings available and the conditions that block them.",
                                        "questions": [
                                            {
                                                "id": "control-surface-q01",
                                                "text": "What controls and modes does contact lens have, and what does each change?",
                                                "kind": "definition"
                                            },
                                            {
                                                "id": "control-surface-q02",
                                                "text": "Which actions are interlocked or forbidden in which state, and what must be true before acting?",
                                                "kind": "action"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "condition-and-maintenance",
                                "name": "Condition and maintenance",
                                "description": "Wear, service intervals, consumables and the line between working and broken.",
                                "findings": [
                                    {
                                        "id": "service-record",
                                        "name": "Condition, service and consumables",
                                        "description": "What is consumed, what is serviced, and how condition is judged.",
                                        "questions": [
                                            {
                                                "id": "service-record-q01",
                                                "text": "What consumables and service does contact lens need, at what interval, and on whose authority?",
                                                "kind": "measurement"
                                            },
                                            {
                                                "id": "service-record-q02",
                                                "text": "What evidence separates a unit that is working from one that is out of service?",
                                                "kind": "boundary"
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "kind-model-unit",
                        "name": "Kind, model and unit",
                        "description": "Whether a claim about contact lens is about the kind, a product line, or one physical unit.",
                        "rationale": "This is the boundary most often got wrong for made things, and getting it wrong mixes a catalogue entry with the machine in the yard.",
                        "layers": [
                            {
                                "id": "level-of-reference",
                                "name": "Level of reference",
                                "description": "The three levels and what belongs at each.",
                                "findings": [
                                    {
                                        "id": "level-rules",
                                        "name": "What belongs to kind, model and unit",
                                        "description": "Which properties are shared by all of them and which are not.",
                                        "questions": [
                                            {
                                                "id": "level-rules-q01",
                                                "text": "Which facts about contact lens hold for every one of them, which for a model, and which only for one unit?",
                                                "kind": "boundary"
                                            },
                                            {
                                                "id": "level-rules-q02",
                                                "text": "What identifies an individual unit, and what should an agent do when it has only the kind?",
                                                "kind": "action"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "standards-and-conformity",
                                "name": "Standards and conformity",
                                "description": "The standards a working example must meet and who attests it.",
                                "findings": [
                                    {
                                        "id": "conformity",
                                        "name": "Standards, marks and attestation",
                                        "description": "Which standard applies, who certifies, and what the mark means.",
                                        "questions": [
                                            {
                                                "id": "conformity-q01",
                                                "text": "Which standards govern contact lens, issued by whom, and what does conformity actually assert?",
                                                "kind": "provenance"
                                            },
                                            {
                                                "id": "conformity-q02",
                                                "text": "What may an agent conclude from a certification mark, and what may it not?",
                                                "kind": "boundary"
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "id": "provenance-and-evidence",
                        "name": "Provenance, evidence and time",
                        "description": "Where every claim about a contact lens came from and when it held.",
                        "rationale": "A claim without a source and a time cannot be superseded, only overwritten, and an agent that overwrites loses the ability to explain itself.",
                        "layers": [
                            {
                                "id": "source-and-authority",
                                "name": "Source and authority",
                                "description": "Who said it, on what evidence, and how strongly.",
                                "findings": [
                                    {
                                        "id": "claim-provenance",
                                        "name": "Claim provenance and confidence",
                                        "description": "The authority behind each claim about a contact lens and how confident it is.",
                                        "questions": [
                                            {
                                                "id": "claim-provenance-q01",
                                                "text": "What identifies and describes a claim about a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "claim-provenance-q02",
                                                "text": "Who or what asserted this about a claim about a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "claim-provenance-q03",
                                                "text": "What may an agent decide or do once a claim about a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": "time-and-versions",
                                "name": "Time, versions and supersession",
                                "description": "When a claim was true, when it was learnt, and what replaced it.",
                                "findings": [
                                    {
                                        "id": "validity-and-supersession",
                                        "name": "Validity period and supersession",
                                        "description": "How an old claim about a contact lens is retired without being erased.",
                                        "questions": [
                                            {
                                                "id": "validity-and-supersession-q01",
                                                "text": "What identifies and describes the validity of a claim about a contact lens, and in what units or vocabulary?",
                                                "kind": "definition",
                                                "answer_data": [
                                                    "identifiers",
                                                    "types and classes",
                                                    "values with units",
                                                    "explicit unknowns"
                                                ]
                                            },
                                            {
                                                "id": "validity-and-supersession-q02",
                                                "text": "Who or what asserted this about the validity of a claim about a contact lens, by which method, and when was it true?",
                                                "kind": "provenance",
                                                "answer_data": [
                                                    "authority",
                                                    "method",
                                                    "evidence",
                                                    "event time",
                                                    "knowledge time"
                                                ]
                                            },
                                            {
                                                "id": "validity-and-supersession-q03",
                                                "text": "What may an agent decide or do once the validity of a claim about a contact lens is known, and what must it refuse?",
                                                "kind": "action",
                                                "answer_data": [
                                                    "permitted actions",
                                                    "preconditions",
                                                    "refusals",
                                                    "escalation"
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            }
                        ]
                    }
                ]
            },
            "statistics": {
                "bundles": 8,
                "layers": 17,
                "findings": 19,
                "questions": 51
            }
        }
    }
}