{ "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-12T11:46:42Z", "providers": [ "Codex" ], "breadth": "recalled by Codex without web access - no source was read", "missingProviders": [], "pass": 2, "cost": { "grok": { "seconds": 20.9, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.4\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: 01a0956f-b1d0-7762-bc5a-d734727613cb\n--------\nuser\nDescribe what is already known about one registered thing. Answer as JSON only, no prose around it.\n\nThing: oral mucocele\nSense to describe: (none recorded)\nDomain code: ACT.ACT\nAlso known as: (none)\n\n\nContext for this batch of 1001 things:\n# Batch 044: 1001 r", "usd": 0.0, "recall": true }, "codex": { "seconds": 82.0, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.4\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: 01a0956f-b1c3-70c0-99c2-e0fb88023eba\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: oral mucocele\nRegistry id: vr.tr.oral-mucocele\nPlane / domain: ACT / ACT.ACT\nRegistry definition: (none recorded)\nNames folded into this entry: (none" } }, "enrichment": { "pass": 3, "engine": "claude", "producedAt": "2026-10-06T12:00:00Z", "ingestedAt": "2026-10-06T08:43:40+00:00", "fields": [ "agent_conduct", "ethics", "owners" ] }, "gate": { "passed": true, "version": "1.0", "at": "2026-10-07T10:10:30+00:00", "evidence": [ "completeness 1.00", "sense: Wikidata description", "2 live sources", "review by codex: pass" ] } }, "metaModel": { "id": "THING-Q378895", "registryId": "vr.tr.oral-mucocele", "name": "oral mucocele", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "ACT.ACT" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q378895/", "model": { "registry_id": "vr.tr.oral-mucocele", "name": "oral mucocele", "purpose": "Enable an AI agent to recognise a suspected oral mucocele, record diagnostic uncertainty and lesion evolution, and support clinician-directed assessment, management and follow-up.", "definition": "An oral mucocele is a localized accumulation of salivary mucus in the oral soft tissues, usually caused by leakage from a damaged minor salivary gland duct and less often by mucus retention within an obstructed duct.", "scope_statement": "This model owns the lesion-level representation of oral mucocele under vr.tr.oral-mucocele: an oral salivary mucus accumulation arising through extravasation or retention, with explicit handling of terminology and the ranula boundary; it preserves the supplied ACT / ACT.ACT classification pending registry review.", "in_scope": [ "Individual oral lesions suspected or confirmed to be mucoceles", "Salivary mucus extravasation versus ductal retention, including unknown mechanism", "Oral site, appearance, dimensions, symptoms and rupture-refilling history", "Diagnostic evidence, competing explanations and reasons for specialist assessment", "Clinician-selected management, resolution, recurrence and treatment complications", "Identification of a possible ranula and linkage to a more specific model if one exists" ], "out_of_scope": [ "General salivary gland anatomy and physiology", "Independent models of salivary stones, duct obstruction or systemic salivary disease", "Full models of vascular lesions, abscesses and salivary neoplasms", "Detailed operative protocols and procedural competency requirements", "Extraoral mucoceles, including paranasal sinus and appendiceal mucoceles", "Detailed management of plunging ranula and cervical extension" ], "distinguishing_features": [ "A fluctuant, translucent or bluish lower-lip swelling supports mucocele recognition; site and appearance alone do not establish the diagnosis. [AAPD oral pathology guidance](https://www.aapd.org/globalassets/media/policies_guidelines/bp_oralpathology.pdf)", "On histology, extravasation involves mucus outside the duct without an epithelial cyst lining, whereas retention involves an epithelial-lined dilated duct; record the reported tissue evidence rather than inferring subtype from appearance. [Clinical and histopathological study](https://pmc.ncbi.nlm.nih.gov/articles/PMC4211243/)", "A floor-of-mouth lesion with major salivary gland involvement raises the ranula classification; neck extension requires a further boundary assessment. [Mucocele and Ranula](https://www.ncbi.nlm.nih.gov/books/NBK560855/)", "A mucocele-like lesion at an atypical site requires consideration of a salivary neoplasm; a benign-looking surface cannot settle that distinction. [AAPD clinical discussion](https://www.aapd.org/globalassets/media/publications/archives/flaitz-22-04.pdf)" ], "characteristics": [ { "name": "Diagnostic status", "kind": "state", "unit_or_values": "suspected | clinically diagnosed | histologically confirmed | diagnosis revised | unresolved", "why_it_matters": "Separates a working label from an established diagnosis." }, { "name": "Mucus accumulation mechanism", "kind": "category", "unit_or_values": "extravasation | retention | indeterminate; record supporting evidence", "why_it_matters": "Prevents all lesions called cysts from being treated as the same pathological entity." }, { "name": "Oral site", "kind": "category", "unit_or_values": "lower labial mucosa | upper labial mucosa | buccal mucosa | ventral tongue | floor of mouth | palate | other specified site; include laterality", "why_it_matters": "Supports lesion identification, differential diagnosis and ranula boundary decisions." }, { "name": "Associated gland or duct", "kind": "relation", "unit_or_values": "link to identified or suspected gland or duct; unknown permitted", "why_it_matters": "Connects the mucus collection to its possible origin without assuming anatomical certainty." }, { "name": "Lesion dimensions", "kind": "measurement", "unit_or_values": "millimetres; length, width and depth where measurable, with date and method", "why_it_matters": "Makes enlargement, collapse and recurrence comparable over time." }, { "name": "Surface and palpation findings", "kind": "category", "unit_or_values": "colour, translucency, surface integrity, fluctuation, firmness, mobility and tenderness; unexamined permitted", "why_it_matters": "Preserves the observations underlying recognition and diagnostic doubt." }, { "name": "Episode duration", "kind": "measurement", "unit_or_values": "days since first noticed; estimated onset and uncertainty allowed", "why_it_matters": "Distinguishes recent onset from persistence without inventing a universal treatment deadline." }, { "name": "Rupture and refilling course", "kind": "state", "unit_or_values": "intact | spontaneously ruptured | collapsed | refilled | apparently resolved | recurrent | unknown", "why_it_matters": "Prevents temporary flattening from automatically being recorded as durable resolution." }, { "name": "Local trauma association", "kind": "relation", "unit_or_values": "link to biting, dental irritation, injury or procedure; reported | observed | suspected | absent history | unknown", "why_it_matters": "Distinguishes a plausible precipitant from a demonstrated cause." }, { "name": "Functional impact", "kind": "category", "unit_or_values": "none reported | lip biting interference | eating difficulty | speech difficulty | swallowing difficulty | breathing difficulty; severity and onset", "why_it_matters": "Connects lesion burden to assessment priority and management goals." }, { "name": "Management and outcome", "kind": "state", "unit_or_values": "observation | referred | intervention planned | treated | healing | resolved | persistent | recurrent | diagnosis revised", "why_it_matters": "Keeps the care decision and subsequent lesion outcome traceable." } ], "affordances": [ "Assemble a dated lesion profile for dental or oral medicine assessment.", "Compare serial measurements and photographs to identify collapse, refilling or sustained disappearance.", "Flag missing evidence or conflicting findings before treating a suspected mucocele as confirmed.", "Link possible trauma or duct obstruction to the lesion while preserving causal uncertainty.", "Support clinician selection and documentation of observation, investigation, referral or treatment.", "Track pathology results, recurrence and adverse effects against the original lesion episode." ], "agent_conduct": { "may": [ "Explain oral mucoceles and their usual causes, citing medical sources.", "Advise a person with a persistent mouth swelling to see a dentist or doctor." ], "must_not": [ "Advise puncturing or cutting a swelling at home.", "Diagnose a swelling as harmless from a description or photo.", "Recommend treatments a clinician has not given.", "Share a person's oral health images without consent." ], "requires_human": [ "Any decision on removal or treatment." ] }, "ethics": { "considerations": [ "Most are harmless, but other lesions can look similar.", "Health images are personal data." ], "affected_parties": [ "Patients", "Children", "Dental clinicians" ] }, "owners": { "steward": "Nobody owns the condition; clinicians answer for each patient's care.", "master_systems": [] }, "what_it_is_for": [ "An oral mucocele is encountered during dental or medical assessment of a localized swelling inside the mouth.", "Recording its location, duration and changes helps clinicians assess a suspected salivary lesion and distinguish it from other causes of oral swelling." ], "standards_and_regulation": [ "ICD-10 category K11.6, issued by the World Health Organization, classifies mucoceles of salivary glands." ], "visual_identification": [ "A superficial lesion may appear as a smooth, rounded swelling with a translucent or bluish surface.", "Deeper lesions may retain the normal color of the surrounding oral mucosa.", "The inner lower lip is a common location, but appearance and location alone cannot establish the diagnosis." ], "failure_modes_and_hazards": [ "Mistaking another oral lesion for a mucocele can delay appropriate assessment.", "Repeated trauma or attempted self-treatment can cause bleeding, infection or further tissue injury.", "Persistent or recurrent swelling can interfere with eating, speech or comfort." ] }, "sources": [ { "id": "wikidata", "title": "Wikidata item Q378895: oral mucocele", "url": "https://www.wikidata.org/wiki/Q378895", "url_status": "live", "what_it_supports": "identity and sense of the item", "checked_by": "wikidata-api" }, { "id": "wikipedia-en", "title": "Wikipedia: Oral mucocele", "url": "https://en.wikipedia.org/wiki/Oral_mucocele", "url_status": "live", "what_it_supports": "general description of the item", "checked_by": "wikidata-api sitelink" } ], "structure": { "bundles": [ { "id": "lesion-identity-and-mechanism", "name": "Lesion identity and mechanism", "description": "Establish what the mucocele label means for this lesion and which anatomical process it represents.", "rationale": "A shared clinical name can conceal different mechanisms and a more specific ranula classification.", "layers": [ { "id": "extravasation-and-retention", "name": "Extravasation and retention", "description": "Separate the diagnostic label from evidence about mucus leakage or ductal retention.", "findings": [ { "id": "mechanism-evidence", "name": "Mechanism evidence", "description": "Record the mechanism as a supported interpretation, retaining indeterminate status when the available evidence cannot distinguish it.", "questions": [ { "text": "Does the clinician use oral mucocele for extravasation alone or for both extravasation and retention?", "kind": "definition", "id": "mechanism-evidence-q01" }, { "text": "Which examination or pathology report supports the assigned mechanism?", "kind": "provenance", "id": "mechanism-evidence-q02" } ] } ] }, { "id": "gland-origin-and-ranula-boundary", "name": "Gland origin and ranula boundary", "description": "Locate the lesion relative to minor salivary glands, the floor of mouth and any cervical component.", "findings": [ { "id": "anatomical-classification", "name": "Anatomical classification", "description": "Represent suspected gland origin separately from surface location and link a narrower ranula model when appropriate.", "questions": [ { "text": "What evidence identifies the associated gland or duct rather than merely the visible swelling site?", "kind": "provenance", "id": "anatomical-classification-q01" }, { "text": "Does floor-of-mouth or neck involvement require classification as oral or plunging ranula and linkage to another model?", "kind": "boundary", "id": "anatomical-classification-q02" } ] } ] } ] }, { "id": "oral-phenotype-and-course", "name": "Oral phenotype and course", "description": "Describe the visible lesion and its behaviour across observations.", "rationale": "A mucocele may change substantially between visits, making a single appearance an incomplete representation.", "layers": [ { "id": "site-and-morphology", "name": "Site and morphology", "description": "Capture reproducible oral examination findings.", "findings": [ { "id": "dated-lesion-profile", "name": "Dated lesion profile", "description": "Combine precise location, dimensions and examination findings with the method and observer.", "questions": [ { "text": "What are the exact oral site, laterality, number of lesions and dimensions in millimetres?", "kind": "measurement", "id": "dated-lesion-profile-q01" }, { "text": "Which colour, surface, consistency and tenderness findings were examined directly, and which came from a photograph or patient report?", "kind": "provenance", "id": "dated-lesion-profile-q02" } ] } ] }, { "id": "rupture-refilling-and-persistence", "name": "Rupture, refilling and persistence", "description": "Track the sequence of swelling, collapse and reappearance.", "findings": [ { "id": "lesion-episode-continuity", "name": "Lesion episode continuity", "description": "Preserve enough chronology to distinguish persistent swelling, refilling of the same lesion and a separate lesion.", "questions": [ { "text": "When was the swelling first noticed, and when did rupture, collapse or refilling occur?", "kind": "measurement", "id": "lesion-episode-continuity-q01" }, { "text": "What evidence establishes that a later swelling occupies the same site and belongs to the same episode?", "kind": "boundary", "id": "lesion-episode-continuity-q02" } ] } ] } ] }, { "id": "causal-context-and-diagnostic-confidence", "name": "Causal context and diagnostic confidence", "description": "Connect local exposures and diagnostic evidence without turning plausible explanations into established facts.", "rationale": "A history of lip biting can support interpretation but must not obscure an alternative diagnosis.", "layers": [ { "id": "local-trauma-and-obstruction", "name": "Local trauma and obstruction", "description": "Assess temporal and anatomical links to possible duct injury or obstruction.", "findings": [ { "id": "precipitant-assessment", "name": "Precipitant assessment", "description": "Record the proposed precipitant, its timing and whether it remains present.", "questions": [ { "text": "Did biting, an appliance, a sharp tooth, injury or an oral procedure precede swelling at this site?", "kind": "provenance", "id": "precipitant-assessment-q01" }, { "text": "What supports duct obstruction or continuing irritation, and what clinician-directed action could address it?", "kind": "action", "id": "precipitant-assessment-q02" } ] } ] }, { "id": "mimics-and-confirmation", "name": "Mimics and confirmation", "description": "Make alternative diagnoses and unresolved contradictions explicit.", "findings": [ { "id": "diagnostic-evidence-gap", "name": "Diagnostic evidence gap", "description": "Record why the working diagnosis remains credible and what further evidence would change it.", "questions": [ { "text": "Which findings leave a vascular lesion, fibroma, infection or salivary neoplasm unresolved?", "kind": "boundary", "id": "diagnostic-evidence-gap-q01" }, { "text": "What clinical question would specialist examination, imaging or histopathology answer before treatment is selected?", "kind": "action", "id": "diagnostic-evidence-gap-q02" } ] } ] } ] }, { "id": "symptom-burden-and-care-decision", "name": "Symptom burden and care decision", "description": "Relate oral function and diagnostic confidence to a documented care plan.", "rationale": "Management depends on lesion behaviour, burden and diagnostic certainty rather than the label alone.", "layers": [ { "id": "oral-function-and-assessment-priority", "name": "Oral function and assessment priority", "description": "Record interference with daily oral activities and symptoms that alter urgency.", "findings": [ { "id": "functional-impact-assessment", "name": "Functional impact assessment", "description": "Swallowing or breathing interference can require prompt assessment, particularly with floor-of-mouth lesions. [Mucocele and Ranula](https://www.ncbi.nlm.nih.gov/books/NBK560855/)", "questions": [ { "text": "Does the lesion interfere with eating, speech, swallowing or breathing, and how has this changed?", "kind": "measurement", "id": "functional-impact-assessment-q01" }, { "text": "Do the current symptoms require urgent assessment rather than the existing follow-up plan?", "kind": "action", "id": "functional-impact-assessment-q02" } ] } ] }, { "id": "observation-or-intervention", "name": "Observation or intervention", "description": "Capture the clinician's chosen approach and reasons.", "findings": [ { "id": "management-rationale", "name": "Management rationale", "description": "Spontaneous resolution is possible; persistent, recurrent or symptomatic lesions may warrant treatment. Record the individual decision and review plan. [Mucocele and Ranula](https://www.ncbi.nlm.nih.gov/books/NBK560855/)", "questions": [ { "text": "What supports observation, referral or a specific intervention for this lesion?", "kind": "action", "id": "management-rationale-q01" }, { "text": "What review date and changes in swelling, symptoms or appearance should trigger reassessment?", "kind": "action", "id": "management-rationale-q02" } ] } ] } ] }, { "id": "treatment-result-and-recurrence", "name": "Treatment result and recurrence", "description": "Connect any intervention to diagnostic results, healing and subsequent swelling.", "rationale": "Temporary disappearance, confirmed resolution and recurrence must remain distinguishable.", "layers": [ { "id": "intervention-and-pathology", "name": "Intervention and pathology", "description": "Preserve what was treated and what tissue examination established.", "findings": [ { "id": "procedure-diagnosis-reconciliation", "name": "Procedure-diagnosis reconciliation", "description": "Link the procedure record and any specimen report to the original lesion, revising the diagnosis when necessary.", "questions": [ { "text": "What procedure was performed, at which site, and was associated gland tissue treated or sampled?", "kind": "provenance", "id": "procedure-diagnosis-reconciliation-q01" }, { "text": "If tissue was examined, did the report confirm a mucocele, establish its mechanism or identify another diagnosis?", "kind": "boundary", "id": "procedure-diagnosis-reconciliation-q02" } ] } ] }, { "id": "healing-and-return-of-swelling", "name": "Healing and return of swelling", "description": "Assess sustained disappearance, functional recovery and possible recurrence.", "findings": [ { "id": "verified-follow-up-state", "name": "Verified follow-up state", "description": "Record the latest verified outcome and elapsed observation time without assuming that absence of follow-up means cure.", "questions": [ { "text": "How long has the site remained free of swelling, and are pain, altered sensation, scarring or functional problems present?", "kind": "measurement", "id": "verified-follow-up-state-q01" }, { "text": "If swelling returns, what reassessment will distinguish recurrence from healing changes or an alternative diagnosis?", "kind": "action", "id": "verified-follow-up-state-q02" } ] } ] } ] }, { "id": "evidence-and-external-alignment", "name": "Evidence and external alignment", "description": "What the world already says about this thing, gathered so the model can be checked against it.", "rationale": "A model that cannot be lined up against existing standards, identifiers and practice cannot be adopted by anyone who already uses them.", "layers": [ { "id": "reported-evidence", "name": "Reported evidence", "description": "Findings from the breadth pass, kept separate from the structural claims.", "findings": [ { "id": "evidence-confidence-notes", "name": "Check these first", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "This is recalled knowledge, without source consultation.", "Usage varies: some specialists reserve 'mucocele' for extravasation lesions and distinguish salivary duct retention cysts separately.", "The supplied domain code ACT.ACT should be reviewed: the ordinary sense of oral mucocele is a pathological condition." ], "questions": [ { "id": "evidence-confidence-notes-q01", "text": "Which of these check these first hold for the sense of oral mucocele this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-kinds", "name": "Kinds and varieties", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Mucus extravasation phenomenon: mucus in connective tissue without an epithelial cyst lining", "Mucus retention cyst: mucus within an epithelial-lined dilated duct", "Superficial mucocele: a small, shallow mucus collection beneath the oral epithelium", "Ranula: a floor-of-mouth mucocele usually associated with the sublingual gland" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of oral mucocele this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "scheme": "ICD-10", "value_or_pattern": "K11.6", "note": "Mucocele of salivary gland; national modifications and coding conventions should be checked." } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of oral mucocele this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "A diagnostic category in dentistry, oral medicine, and oral pathology for localized mucus-containing swellings.", "Histopathologic distinction between mucus extravasation and an epithelial-lined retention cyst.", "Assessment of associated local trauma, including lip biting, particularly for lower-lip lesions." ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of oral mucocele this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Lesions may rupture and refill or recur when the associated salivary leakage or obstruction persists.", "Larger lesions can interfere with eating, speech, or comfort.", "Other oral swellings, including salivary gland tumors and vascular lesions, can be mistaken for a mucocele.", "A plunging ranula can extend through or around the mylohyoid muscle into the neck." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of oral mucocele this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "name": "Ranula", "difference": "A location-defined subtype in the floor of the mouth, usually arising from the sublingual gland." }, { "name": "Salivary duct cyst", "difference": "Has an epithelial lining; the common extravasation mucocele lacks one. Some terminology includes salivary duct cysts under retention mucoceles." }, { "name": "Irritation fibroma", "difference": "A reactive fibrous tissue nodule rather than a collection of salivary mucus." }, { "name": "Venous malformation", "difference": "Consists of abnormal venous channels rather than extravasated or retained saliva; a bluish appearance alone does not distinguish them." }, { "name": "Mucoepidermoid carcinoma", "difference": "A malignant salivary epithelial tumor that can resemble a mucus-containing swelling; tissue examination distinguishes it." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of oral mucocele this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does an existing Vercy world model already own oral mucocele, and does the registry separately represent ranula or salivary duct retention cyst?", "Should the registered term include both extravasation and retention lesions, and how should differing clinical and pathological terminology be reconciled?", "Is the supplied ACT / ACT.ACT placement intentional for this condition, or does registry governance require a classification review?", "Which evidence-supported persistence, atypical-site and examination criteria should trigger biopsy or specialist referral for each age group?", "What comparative evidence supports treatment selection and the follow-up duration needed to assess recurrence across lesion sites, sizes and mechanisms?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 16, "questions": 26 } }