{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.pearl","code":"thing-q43436","url":"https://ver.cy/models/thing/q43436/","name":"pearl","alternateNames":["pearl necklace","cultured pearl","freshwater pearl","baroque pearl","Keshi pearls","Mabe pearl","cultured freshwater pearl","Tahitian pearl"],"kind":"thing","status":"published","version":"0.1.0-research.1","language":"en","classifiers":{"family":"Thing Registry","category":"Physical world and living systems","entryKind":"thing","plane":"PHY","domain":["PHY.MAT"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"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.","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.","scope":{"in":["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":["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"],"boundaries":[]},"distinguishingFeatures":["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."],"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.","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?","id":"pearl-identification-evidence-q01","kind":"definition"},{"text":"Who made the determination, using which observations or tests, and what remained inaccessible or inconclusive?","id":"pearl-identification-evidence-q02","kind":"provenance"}]}]},{"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?","id":"construction-and-components-q01","kind":"boundary"},{"text":"Which visible or detected components belong to the pearl body, and which belong to a backing, coating or jewellery setting?","id":"construction-and-components-q02","kind":"boundary"}]}]}]},{"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.","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?","id":"formation-determination-q01","kind":"provenance"},{"text":"Which internal structures were observed, by what method, and how did the examiner interpret them?","id":"formation-determination-q02","kind":"measurement"}]}]},{"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?","id":"origin-claim-support-q01","kind":"provenance"},{"text":"Is a claimed geographic origin traceable to production records, inferred by an examiner or merely part of a trade description?","id":"origin-claim-support-q02","kind":"provenance"}]}]}]},{"id":"form-and-optical-character","name":"Form and optical character","description":"Describe the pearl's geometry and characteristic appearance in reproducible terms.","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?","id":"pearl-form-description-q01","kind":"measurement"},{"text":"Which shape, symmetry and surface-form features identify the pearl, and relative to which axes or viewing face?","id":"pearl-form-description-q02","kind":"definition"}]}]},{"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?","id":"colour-lustre-and-effects-q01","kind":"measurement"},{"text":"How was lustre assessed, against which reference or vocabulary, and how does it vary across the pearl?","id":"colour-lustre-and-effects-q02","kind":"measurement"}]}]}]},{"id":"treatments-and-condition","name":"Treatments and condition","description":"Track interventions and distinguish formation features from wear or damage.","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?","id":"intervention-evidence-q01","kind":"provenance"},{"text":"Which interventions have been investigated without detection, and which remain untested or cannot be excluded?","id":"intervention-evidence-q02","kind":"boundary"}]}]},{"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?","id":"condition-feature-map-q01","kind":"measurement"},{"text":"Do comparison records show new damage, propagation, loss of surface material or a change in appearance?","id":"condition-feature-map-q02","kind":"measurement"}]}]}]},{"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.","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?","id":"proposed-use-compatibility-q01","kind":"action"},{"text":"What do drill-hole geometry, nearby defects and available structural evidence imply for stringing, mounting, drilling or reworking?","id":"proposed-use-compatibility-q02","kind":"action"}]}]},{"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?","id":"care-action-assessment-q01","kind":"action"},{"text":"Do uncertain coatings, existing cracks, peeling or attachment materials require the action to be deferred or assessed by a specialist?","id":"care-action-assessment-q02","kind":"action"}]}]}]}]},"agentConduct":{"may":["Describe a pearl's appearance, size and condition from inspection or a laboratory report.","State whether a pearl is natural, cultured or imitation only as a laboratory has established it.","Disclose known treatments such as bleaching or dyeing."],"mustNot":["Sell or describe a cultured or imitation pearl as natural.","Hide treatments, fillings or repairs from a buyer.","Overstate value or rarity to pressure a sale.","Clean a pearl with acids or harsh chemicals that dissolve its surface."],"requiresHuman":["Commissioning destructive testing or drilling of a valuable pearl.","Buying or selling pearls of high value on someone's behalf."]},"ethics":{"considerations":["Fraud over origin and treatment cheats buyers in a high-value trade.","Pearl farming and wild harvesting affect molluscs, reefs and coastal workers."],"affectedParties":["Buyers and owners","Pearl divers and farm workers","Marine ecosystems"]},"owners":{"steward":"The person who owns it; gemmological laboratories issue reports, not ownership records.","roles":[],"masterSystems":[]},"relations":[{"target":"Q110688445","type":"parent","note":"registry parent class"},{"target":"Q112511193","type":"parent","note":"registry parent class"},{"target":"Q629103","type":"parent","note":"registry parent class"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.pearl","Wikidata: Q43436 (https://www.wikidata.org/wiki/Q43436)"]},"properties":{"applicability":"required","items":["Identity determination: unexamined | provisional pearl | identified pearl | identified imitation | unresolved","Formation category: natural | cultured | undetermined, with supporting evidence","Producing organism and environment: linked organism identification and freshwater or saltwater attribution, each with evidence and confidence","Body construction: whole free pearl | shell-attached formation | cut portion | assembled product | undetermined; record observed components","Material structure: nacreous | non-nacreous | unresolved; separately record nucleus and growth-structure observations","Dimensions and mass: principal dimensions in mm; mass in g or ct; record mounting and measurement limitations","Shape and symmetry: named shape with reference vocabulary, axis orientation and departures from symmetry","Optical appearance: body colour, overtone, orient where observed, lustre and any distinctive optical pattern, with viewing conditions","Treatment and modification evidence: reported | detected | not detected within stated test limits | untested | unresolved, per treatment or modification","Surface and structural condition: mapped surface features, wear, cracks, chips, peeling, exposed underlying material and drill-hole damage, with severity and confidence"]},"recognition":{"applicability":"required","items":["Lustrous, often iridescent surface from layered nacre.","A drill hole or mounting, and slight surface irregularities seen under magnification."]},"capabilities":{"applicability":"required","items":["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."]},"hazards":{"applicability":"required","items":["Nacre is soft and dissolves in acids, perspiration and cosmetics.","Misrepresented origin leads to large financial loss."]},"interfaces":{"applicability":"required","items":["The Pearl Book, CIBJO, the World Jewellery Confederation, which sets nomenclature for pearls."]},"context":{"applicability":"required","items":["Pearls occur inside certain molluscs and are encountered in pearl cultivation, jewellery, museum collections and gemological examination.","They are used as ornaments and studied to determine their biological origin, growth structure, treatments and condition."]}},"sources":[{"title":"Wikidata item Q43436: pearl","url":"https://www.wikidata.org/wiki/Q43436","note":"identity and sense of the item"},{"title":"Wikipedia: Pearl","url":"https://en.wikipedia.org/wiki/Pearl","note":"general description of the item"}],"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?"],"resources":{"spec":"/models/things/publications/thing-q43436/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q43436/spec.json"],"providers":["Codex"],"researchStatus":"unreviewed","generatedAt":"2026-09-07T09:06:28Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"filled","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T10:10:31+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass"},"score":1.0}}