{ "model": { "rank": 1939, "code": "thing-q43436", "model_id": "vr.tr.pearl", "name": "pearl", "purpose": "Enable an AI agent to recognise a pearl, assess its identity and condition, and decide whether it can be handled, tested, treated, mounted or used for a stated purpose.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.MAT", "industry": "", "version": "", "url": "/models/thing/q43436/", "tier": 2, "score": 121, "payload": { "layer": "wikidata", "aliases": [ "pearl necklace", "cultured pearl", "freshwater pearl", "baroque pearl", "Keshi pearls", "Mabe pearl", "cultured freshwater pearl", "Tahitian pearl" ], "aliasCount": 8, "merged": 8, "knownIn": 121, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": "vr.tr.pearl", "source": { "dataset": "wikidata", "item": "Q43436", "url": "https://www.wikidata.org/wiki/Q43436", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T09:06:28Z", "providers": [ "Codex" ], "missingProviders": [ "Grok" ], "pass": 2, "cost": { "grok": { "usd": null, "turns": null, "seconds": 15, "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": 87.8, "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: 01a07b1d-208c-7c50-b37c-5c27652935ed\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: pearl\nRegistry id: vr.tr.pearl\nPlane / domain: PHY / PHY.MAT\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA Vercy model" } } }, "metaModel": { "id": "THING-Q43436", "registryId": "vr.tr.pearl", "name": "pearl", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.MAT" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q43436/", "model": { "registry_id": "vr.tr.pearl", "name": "pearl", "purpose": "Enable an AI agent to recognise a pearl, assess its identity and condition, and decide whether it can be handled, tested, treated, mounted or used for a stated purpose.", "definition": "", "scope_statement": "This model owns the individual pearl as a material body, including evidence of molluscan formation, natural or cultured origin, structure, appearance, treatments, modifications and condition; it preserves uncertain identifications without treating them as verified.", "in_scope": [ "Identification as a pearl and distinction from imitation or composite products", "Formation category and evidence supporting biological and production origin", "External form, internal structure and pearl-specific appearance", "Treatments, coatings, drilling and other modifications", "Condition, handling constraints and suitability for a proposed use" ], "out_of_scope": [ "The producing mollusc as a living organism, population or species model", "Pearl farms, cultivation operations and aquatic ecosystems", "Jewellery settings, stringing systems and complete jewellery pieces", "Ownership, transactions, insurance and market valuation", "Laboratory instruments, testing procedures and grading standards as independent models" ], "distinguishing_features": [ "Require identification evidence that separates mollusc-produced pearl material from a manufactured bead with a pearl-like surface; appearance alone leaves identity provisional.", "Distinguish natural from cultured origin using a recorded expert or laboratory interpretation of formation evidence rather than roundness, colour or lustre.", "Record whether the object is a whole pearl, a shell-attached formation, a cut portion or an assembled product before treating those objects as equivalent.", "Distinguish nacreous and non-nacreous material where supported by examination; absence of a familiar nacreous appearance should prompt identification rather than automatic rejection.", "Separate body colour and optical appearance from applied colour or coating wherever treatment evidence supports that distinction." ], "characteristics": [ { "name": "Identity determination", "kind": "state", "unit_or_values": "unexamined | provisional pearl | identified pearl | identified imitation | unresolved", "why_it_matters": "Prevents a pearl-like appearance or seller description from establishing material identity." }, { "name": "Formation category", "kind": "category", "unit_or_values": "natural | cultured | undetermined, with supporting evidence", "why_it_matters": "Separates formation claims that can materially change description and permitted representation." }, { "name": "Producing organism and environment", "kind": "relation", "unit_or_values": "linked organism identification and freshwater or saltwater attribution, each with evidence and confidence", "why_it_matters": "Supports origin-specific interpretation without inferring a species or environment from appearance alone." }, { "name": "Body construction", "kind": "category", "unit_or_values": "whole free pearl | shell-attached formation | cut portion | assembled product | undetermined; record observed components", "why_it_matters": "Establishes the physical boundary and avoids applying whole-pearl assumptions to partial or composite bodies." }, { "name": "Material structure", "kind": "category", "unit_or_values": "nacreous | non-nacreous | unresolved; separately record nucleus and growth-structure observations", "why_it_matters": "Guides identification, optical description and interpretation of internal examination." }, { "name": "Dimensions and mass", "kind": "measurement", "unit_or_values": "principal dimensions in mm; mass in g or ct; record mounting and measurement limitations", "why_it_matters": "Supports recognition, matching and physical compatibility with a proposed setting." }, { "name": "Shape and symmetry", "kind": "category", "unit_or_values": "named shape with reference vocabulary, axis orientation and departures from symmetry", "why_it_matters": "Describes the pearl's actual form and supports orientation and matching decisions." }, { "name": "Optical appearance", "kind": "category", "unit_or_values": "body colour, overtone, orient where observed, lustre and any distinctive optical pattern, with viewing conditions", "why_it_matters": "Makes appearance assessments comparable while keeping separate visual effects distinguishable." }, { "name": "Treatment and modification evidence", "kind": "state", "unit_or_values": "reported | detected | not detected within stated test limits | untested | unresolved, per treatment or modification", "why_it_matters": "Prevents an untested pearl from being described as untreated and informs further handling." }, { "name": "Surface and structural condition", "kind": "state", "unit_or_values": "mapped surface features, wear, cracks, chips, peeling, exposed underlying material and drill-hole damage, with severity and confidence", "why_it_matters": "Separates appearance features from damage and identifies constraints on use." } ], "affordances": [ "Describe and provisionally identify the pearl while retaining unresolved origin or treatment claims.", "Request targeted gemmological examination to resolve identity, formation or construction questions.", "Compare pearls for matching using shape, dimensions, colour and lustre under recorded viewing conditions.", "Assess a proposed mounting, stringing or drilling operation against the pearl's form and condition.", "Select handling, storage or cleaning actions supported by the identified material, treatments and current condition.", "Monitor changes in surface appearance, structural damage and drill-hole condition over time." ] }, "sources": [], "structure": { "bundles": [ { "id": "pearl-identity-and-boundary", "name": "Pearl identity and boundary", "description": "Establish what the examined object is and which parts constitute the pearl.", "rationale": "Pearl-like beads, attached formations and assembled products cannot safely inherit the same identity or use assumptions.", "layers": [ { "id": "material-identification", "name": "Material identification", "description": "Separate observed material evidence from visual resemblance and commercial naming.", "findings": [ { "id": "pearl-identification-evidence", "name": "Pearl identification evidence", "description": "Record the determination that the object is a pearl, an imitation or unresolved, with the evidence and limits of examination.", "questions": [ { "text": "What examination supports identification as mollusc-produced pearl material rather than a manufactured pearl-like bead?", "kind": "definition", "id": "pearl-identification-evidence-q01" }, { "text": "Who made the determination, using which observations or tests, and what remained inaccessible or inconclusive?", "kind": "provenance", "id": "pearl-identification-evidence-q02" } ] } ] }, { "id": "physical-body-boundary", "name": "Physical body boundary", "description": "Identify whole, attached, partial and assembled bodies and separate adjacent materials.", "findings": [ { "id": "construction-and-components", "name": "Construction and components", "description": "Record whether the examined item is a whole pearl and identify shell, backing, filler, adhesive, coating or mounting material where present.", "questions": [ { "text": "Is the examined body a whole free pearl, an attached formation, a cut portion or an assembly, and what supports that classification?", "kind": "boundary", "id": "construction-and-components-q01" }, { "text": "Which visible or detected components belong to the pearl body, and which belong to a backing, coating or jewellery setting?", "kind": "boundary", "id": "construction-and-components-q02" } ] } ] } ] }, { "id": "formation-and-origin-evidence", "name": "Formation and origin evidence", "description": "Represent how the pearl formed and how far its biological and production origin can be established.", "rationale": "Natural, cultured and organism-specific claims require evidence distinct from appearance or a trade name.", "layers": [ { "id": "growth-and-cultivation", "name": "Growth and cultivation", "description": "Connect formation classification to interpreted internal and external evidence.", "findings": [ { "id": "formation-determination", "name": "Formation determination", "description": "Record natural or cultured attribution and observations of nuclei or growth structures without turning a single observation into an unsupported conclusion.", "questions": [ { "text": "What evidence supports natural or cultured origin, and is that attribution conclusive, qualified or undetermined?", "kind": "provenance", "id": "formation-determination-q01" }, { "text": "Which internal structures were observed, by what method, and how did the examiner interpret them?", "kind": "measurement", "id": "formation-determination-q02" } ] } ] }, { "id": "biological-and-production-attribution", "name": "Biological and production attribution", "description": "Keep organism, environment and geographic claims distinct and independently qualified.", "findings": [ { "id": "origin-claim-support", "name": "Origin claim support", "description": "Record supported organism and freshwater or saltwater attribution separately from documented harvest or cultivation location.", "questions": [ { "text": "What supports the producing organism and freshwater or saltwater attribution, and at what level of specificity?", "kind": "provenance", "id": "origin-claim-support-q01" }, { "text": "Is a claimed geographic origin traceable to production records, inferred by an examiner or merely part of a trade description?", "kind": "provenance", "id": "origin-claim-support-q02" } ] } ] } ] }, { "id": "form-and-optical-character", "name": "Form and optical character", "description": "Describe the pearl's geometry and characteristic appearance in reproducible terms.", "rationale": "Pearl recognition and matching depend on several distinct shape and optical attributes that a single quality label obscures.", "layers": [ { "id": "geometry-and-orientation", "name": "Geometry and orientation", "description": "Record size, shape, symmetry and the orientation used for observation.", "findings": [ { "id": "pearl-form-description", "name": "Pearl form description", "description": "Describe the body using principal dimensions, shape vocabulary and identifiable features such as rings, flattened areas or asymmetry.", "questions": [ { "text": "What are the principal dimensions and measurable mass, and does a setting restrict or confound those measurements?", "kind": "measurement", "id": "pearl-form-description-q01" }, { "text": "Which shape, symmetry and surface-form features identify the pearl, and relative to which axes or viewing face?", "kind": "definition", "id": "pearl-form-description-q02" } ] } ] }, { "id": "optical-observation", "name": "Optical observation", "description": "Separate colour and reflective effects while retaining viewing conditions.", "findings": [ { "id": "colour-lustre-and-effects", "name": "Colour, lustre and optical effects", "description": "Record body colour, overtone, orient where present, lustre and other observed optical patterns without assuming they establish origin.", "questions": [ { "text": "Which body colour, overtone, orient or other optical patterns are observable under the recorded illumination and background?", "kind": "measurement", "id": "colour-lustre-and-effects-q01" }, { "text": "How was lustre assessed, against which reference or vocabulary, and how does it vary across the pearl?", "kind": "measurement", "id": "colour-lustre-and-effects-q02" } ] } ] } ] }, { "id": "treatments-and-condition", "name": "Treatments and condition", "description": "Track interventions and distinguish formation features from wear or damage.", "rationale": "A pearl's present surface may reflect growth, treatment and subsequent deterioration, each with different implications.", "layers": [ { "id": "treatment-and-working-history", "name": "Treatment and working history", "description": "Record disclosed or detected changes to colour, surface and body.", "findings": [ { "id": "intervention-evidence", "name": "Intervention evidence", "description": "Represent evidence for bleaching, colouring, coating or other treatment, alongside drilling, cutting and polishing history where known.", "questions": [ { "text": "Which treatments or modifications are reported or detected, and what evidence supports each entry?", "kind": "provenance", "id": "intervention-evidence-q01" }, { "text": "Which interventions have been investigated without detection, and which remain untested or cannot be excluded?", "kind": "boundary", "id": "intervention-evidence-q02" } ] } ] }, { "id": "surface-and-structural-integrity", "name": "Surface and structural integrity", "description": "Locate and interpret surface irregularities and structural defects.", "findings": [ { "id": "condition-feature-map", "name": "Condition feature map", "description": "Map pits, rings, abrasions, chips, cracks, peeling and exposed underlying material, qualifying whether each feature is a growth feature, modification or damage.", "questions": [ { "text": "Where are the observed irregularities or defects, how extensive are they, and what supports their interpretation?", "kind": "measurement", "id": "condition-feature-map-q01" }, { "text": "Do comparison records show new damage, propagation, loss of surface material or a change in appearance?", "kind": "measurement", "id": "condition-feature-map-q02" } ] } ] } ] }, { "id": "pearl-use-and-care-decisions", "name": "Pearl use and care decisions", "description": "Translate pearl-specific evidence into constraints on mounting, matching, handling and care.", "rationale": "Recognising a pearl is insufficient to decide whether its surface, structure and modifications can tolerate a proposed operation.", "layers": [ { "id": "mounting-and-matching-fit", "name": "Mounting and matching fit", "description": "Evaluate the pearl against a stated jewellery or display use.", "findings": [ { "id": "proposed-use-compatibility", "name": "Proposed use compatibility", "description": "Assess dimensional fit, appearance matching, orientation and the condition of existing or proposed attachment locations.", "questions": [ { "text": "Does the pearl meet the proposed use's requirements for dimensions, shape, visible face, colour and lustre?", "kind": "action", "id": "proposed-use-compatibility-q01" }, { "text": "What do drill-hole geometry, nearby defects and available structural evidence imply for stringing, mounting, drilling or reworking?", "kind": "action", "id": "proposed-use-compatibility-q02" } ] } ] }, { "id": "handling-and-care-constraints", "name": "Handling and care constraints", "description": "Determine appropriate care from material identification, treatment evidence and current condition.", "findings": [ { "id": "care-action-assessment", "name": "Care action assessment", "description": "Record justified handling, cleaning and storage decisions, including cases requiring specialist assessment.", "questions": [ { "text": "What pearl-specific evidence or qualified guidance supports the proposed cleaning method, exposure conditions and handling procedure?", "kind": "action", "id": "care-action-assessment-q01" }, { "text": "Do uncertain coatings, existing cracks, peeling or attachment materials require the action to be deferred or assessed by a specialist?", "kind": "action", "id": "care-action-assessment-q02" } ] } ] } ] } ] }, "openQuestions": [ "Does vr.tr.pearl include shell-attached formations, worked portions and assembled blister products, or should those be represented through neighbouring registry entries?", "Which authoritative identification references and evidence thresholds should govern natural versus cultured, nacreous versus non-nacreous, and organism-origin determinations?", "Which grading vocabularies can be used across pearl varieties, and which require variety-specific references to avoid misleading comparisons?", "Which treatments can be detected or excluded by available examination methods, and how should the limits of a negative result be expressed?", "What validated care and working guidance applies to each identified pearl type, treatment and condition, particularly for cleaning, drilling and remounting?" ], "statistics": { "bundles": 5, "layers": 10, "findings": 10, "questions": 20 } }, "draft": { "generator": "vr.draft.v3", "status": "draft-generated", "researched": false, "archetype": "chemical substance or material", "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 pearl, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an AI agent to recognise a pearl, assess its identity and condition, and decide whether it can be handled, tested, treated, mounted or used for a stated purpose.", "characteristics": { "substance": "material", "origin": "natural", "agency": "inert", "mobility": "varies" }, "whatYouCanDoWithIt": [ "observed and measured", "consumed or used up" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: pearl necklace, cultured pearl, freshwater pearl, baroque pearl, Keshi pearls, Mabe pearl, cultured freshwater pearl, Tahitian pearl.", "8 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 121 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 pearl, 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", "use it up, and then need more of it" ], "howItIsRecognised": [ "Not recognisable by sight in any reliable way. Appearance varies with grade, form and additives; identification is by label, by documentation, or by assay." ], "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": [ "pearl necklace", "cultured pearl", "freshwater pearl", "baroque pearl", "Keshi pearls", "Mabe pearl", "cultured freshwater pearl", "Tahitian pearl" ] } ], "standing": "Described in 121 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 8 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 pearl from another, and a pearl 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 pearl, 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 pearl, 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 pearl 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 pearl, 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 pearl, 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 pearl 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 pearl 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 pearl, 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 pearl, 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 pearl 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 pearl from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a pearl, 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 pearl, 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 pearl 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 pearl 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 pearl, 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 pearl, 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 pearl 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 pearl is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a pearl, 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 pearl, 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 pearl 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 pearl is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a pearl, 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 pearl, 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 pearl 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 pearl 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 pearl is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a pearl, 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 pearl, 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 pearl 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 pearl 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 pearl, 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 pearl, 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 pearl 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 pearl 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 pearl between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a pearl, 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 pearl, 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 pearl 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 pearl, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a pearl 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 pearl, 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 pearl, 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 pearl is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "use-and-operation", "name": "Use and operation", "description": "What can be done with a pearl and what it takes to do it.", "rationale": "An agent that can recognise a thing but not act on it has only half a model.", "layers": [ { "id": "intended-use", "name": "Intended use and function", "description": "What a pearl is for, and what it is used for anyway.", "findings": [ { "id": "function-and-purpose", "name": "Function, purpose and misuse", "description": "The function a pearl performs and the uses that fall outside it.", "questions": [ { "id": "function-and-purpose-q01", "text": "What identifies and describes the use of a pearl, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "function-and-purpose-q02", "text": "Who or what asserted this about the use of a pearl, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "function-and-purpose-q03", "text": "What may an agent decide or do once the use of a pearl is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "handling-and-procedure", "name": "Handling and procedure", "description": "The steps, skills and tools involved in using a pearl.", "findings": [ { "id": "procedures-and-skills", "name": "Procedures, skills and required tools", "description": "What an agent needs before it can act on a pearl at all.", "questions": [ { "id": "procedures-and-skills-q01", "text": "What identifies and describes handling a pearl, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "procedures-and-skills-q02", "text": "Who or what asserted this about handling a pearl, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "procedures-and-skills-q03", "text": "What may an agent decide or do once handling a pearl is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "supply-and-consumption", "name": "Supply and consumption", "description": "Quantities, rates and what running out means.", "findings": [ { "id": "consumption-and-stock", "name": "Consumption, stock and replenishment", "description": "How much of a pearl there is and how fast it goes.", "questions": [ { "id": "consumption-and-stock-q01", "text": "What identifies and describes the supply of a pearl, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "consumption-and-stock-q02", "text": "Who or what asserted this about the supply of a pearl, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "consumption-and-stock-q03", "text": "What may an agent decide or do once the supply of a pearl is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "composition-and-identity", "name": "Composition, grade and chemical identity", "description": "What pearl is made of and how pure the thing in hand is.", "rationale": "Grade decides what a substance may be used for, so a model that records only the name cannot support any decision about use.", "layers": [ { "id": "chemical-identity", "name": "Chemical identity", "description": "Formula, structure and the registry numbers that name it unambiguously.", "findings": [ { "id": "identity-record", "name": "Identity and registry numbers", "description": "What identifies this substance across suppliers and regulators.", "questions": [ { "id": "identity-record-q01", "text": "What formula, structure and registry identifiers name pearl unambiguously?", "kind": "definition" }, { "id": "identity-record-q02", "text": "Which related substances share a name in common use but not an identifier?", "kind": "boundary" } ] } ] }, { "id": "grade-and-impurities", "name": "Grade, purity and impurities", "description": "The specification a batch meets and what else is in it.", "findings": [ { "id": "specification", "name": "Specification and assay", "description": "How purity is stated and measured, and which impurities matter.", "questions": [ { "id": "specification-q01", "text": "What grades of pearl exist, how is purity assayed, and which impurities are limited?", "kind": "measurement" }, { "id": "specification-q02", "text": "Which use requires which grade, and what happens when a lower grade is substituted?", "kind": "action" } ] } ] } ] }, { "id": "properties-and-behaviour", "name": "Properties and behaviour", "description": "How pearl behaves under conditions an agent can measure or change.", "rationale": "Physical constants are the part of a substance model that transfers between contexts, and each needs its unit and its conditions.", "layers": [ { "id": "physical-constants", "name": "Physical constants", "description": "Values that hold for the pure substance, with their conditions.", "findings": [ { "id": "constants-record", "name": "Constants and conditions", "description": "The quantities worth recording and the state they apply in.", "questions": [ { "id": "constants-record-q01", "text": "What are the defining physical constants of pearl, in what units and under what conditions?", "kind": "measurement" }, { "id": "constants-record-q02", "text": "Which of these values change with grade or form rather than being fixed?", "kind": "boundary" } ] } ] }, { "id": "stability-and-reactivity", "name": "Stability and reactivity", "description": "What it reacts with, degrades into, and how it is stored.", "findings": [ { "id": "incompatibilities", "name": "Incompatibilities and degradation", "description": "What must not meet it, and what it becomes over time.", "questions": [ { "id": "incompatibilities-q01", "text": "What is pearl incompatible with, and what does it degrade into under storage?", "kind": "definition" }, { "id": "incompatibilities-q02", "text": "What storage and handling does that require, and who is competent to do it?", "kind": "action" } ] } ] } ] }, { "id": "hazard-and-regulation", "name": "Hazard classification and regulation", "description": "How pearl can harm, and what the law says about holding and moving it.", "rationale": "A substance model without its hazard class and its regulatory identity is unusable in exactly the situations that matter.", "layers": [ { "id": "hazard-class", "name": "Hazard classification", "description": "Classified hazards, exposure limits and protective measures.", "findings": [ { "id": "classified-hazards", "name": "Classified hazards and limits", "description": "The classification, the scheme it belongs to, and the limits set.", "questions": [ { "id": "classified-hazards-q01", "text": "How is pearl classified for hazard, under which scheme, and what exposure limits apply?", "kind": "definition" }, { "id": "classified-hazards-q02", "text": "What protection does handling require, and what must an agent refuse to do without it?", "kind": "action" } ] } ] }, { "id": "regulatory-identity", "name": "Regulatory identity and control", "description": "Registration, restriction and transport rules by jurisdiction.", "findings": [ { "id": "controls", "name": "Controls and jurisdiction", "description": "Where it is restricted and what the restriction attaches to.", "questions": [ { "id": "controls-q01", "text": "Which registrations, restrictions or transport rules cover pearl, and where?", "kind": "provenance" }, { "id": "controls-q02", "text": "Does the control attach to the substance, its concentration, or its intended use?", "kind": "boundary" } ] } ] } ] }, { "id": "provenance-and-evidence", "name": "Provenance, evidence and time", "description": "Where every claim about a pearl 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 pearl and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a pearl, 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 pearl, 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 pearl 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 pearl is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a pearl, 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 pearl, 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 pearl is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] } ] }, "statistics": { "bundles": 9, "layers": 20, "findings": 22, "questions": 60 } } } }