{ "model": { "rank": 2533, "code": "thing-q64386", "model_id": "vr.tr.gallbladder", "name": "gallbladder", "purpose": "Enable an AI agent to recognise a gallbladder, record evidence about its anatomy and condition, and distinguish supported next actions from decisions requiring clinical assessment.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.OBJ", "industry": "", "version": "", "url": "/models/thing/q64386/", "tier": 2, "score": 103, "payload": { "layer": "wikidata", "aliases": [ "snake gallbladder", "human gallbladder" ], "aliasCount": 2, "merged": 2, "knownIn": 103, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": null, "source": { "dataset": "wikidata", "item": "Q64386", "url": "https://www.wikidata.org/wiki/Q64386", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T09:51:47Z", "providers": [ "Codex", "Grok" ], "missingProviders": [], "pass": 2, "cost": { "grok": { "usd": 0.0114597, "turns": 1, "seconds": 122, "error": null }, "codex": { "seconds": 81.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: 01a07b45-a790-7b32-ac46-81b8729ce4b4\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: gallbladder\nRegistry id: vr.tr.gallbladder\nPlane / domain: PHY / PHY.LIV\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA" } } }, "metaModel": { "id": "THING-Q64386", "registryId": "vr.tr.gallbladder", "name": "gallbladder", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.LIV" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q64386/", "model": { "registry_id": "vr.tr.gallbladder", "name": "gallbladder", "purpose": "Enable an AI agent to recognise a gallbladder, record evidence about its anatomy and condition, and distinguish supported next actions from decisions requiring clinical assessment.", "definition": "A hollow, pear-shaped, muscular extrahepatic viscus seated in the gallbladder fossa of the liver that stores and concentrates hepatic bile and ejects it through the cystic duct into the common bile duct under cholecystokinin-mediated contraction.", "scope_statement": "This model owns the gallbladder as an individual organ, including its wall, lumen, contents, storage and emptying function, anatomical connections, and changes caused by disease or intervention, with observations tied to their time and evidence.", "in_scope": [ "Organ identity, presence, location, morphology and anatomical variation", "Gallbladder wall, lumen and contents", "Bile storage and emptying observations", "Organ-local abnormalities and their evidential status", "Gallbladder-specific procedural changes, remnants and follow-up observations" ], "out_of_scope": [ "Hepatic bile production and overall liver function", "The biliary duct tree as a separate anatomical system", "Pancreatic anatomy and pancreatic disease", "Whole-person symptoms, comorbidities and treatment eligibility", "Medication, device and procedure specifications" ], "distinguishing_features": [ "Assess whether the structure is a sac with a fundus, body and neck, rather than a tubular segment of the biliary ducts.", "Seek anatomical continuity from its neck into the cystic duct; record whether this connection is demonstrated or merely inferred.", "Assess its relationship to the liver's gallbladder fossa, allowing for anatomical variants rather than making typical location mandatory.", "Distinguish the organ wall and lumen from an adjacent cyst or fluid collection using anatomical continuity and imaging evidence.", "When no gallbladder is visualised, distinguish nonvisualisation from documented removal or confirmed congenital absence." ], "characteristics": [ { "name": "Presence and identification confidence", "kind": "state", "unit_or_values": "present; remnant present; documented removed; congenital absence confirmed; not visualised; uncertain", "why_it_matters": "Prevents an unsuccessful observation from being treated as proof that the organ is absent." }, { "name": "Location and orientation", "kind": "relation", "unit_or_values": "Position relative to liver, gallbladder fossa and adjacent structures, with modality and confidence", "why_it_matters": "Supports identification and recognition of anatomical variation." }, { "name": "Cystic duct connection", "kind": "relation", "unit_or_values": "Demonstrated connection; suspected connection; surgically altered; unresolved", "why_it_matters": "Defines the organ's interface with the biliary system." }, { "name": "Dimensions and lumen volume", "kind": "measurement", "unit_or_values": "Dimensions in mm; volume in mL; acquisition method, time and preparation state", "why_it_matters": "Allows size and distension to be compared without ignoring differences in examination conditions." }, { "name": "Wall thickness", "kind": "measurement", "unit_or_values": "mm, with measurement site, distension state and imaging method", "why_it_matters": "Records a wall observation without treating thickness alone as a diagnosis." }, { "name": "Luminal contents", "kind": "category", "unit_or_values": "Bile-compatible fluid; sludge; calculi; blood suspected; gas; other material; indeterminate", "why_it_matters": "Separates different types of contents and preserves uncertainty about their identity." }, { "name": "Focal wall or luminal lesion", "kind": "state", "unit_or_values": "Absent on examination; present; indeterminate, with site, size, attachment and imaging features", "why_it_matters": "Supports comparison of lesions while separating observed appearance from pathological classification." }, { "name": "Emptying measurement", "kind": "measurement", "unit_or_values": "Ejection fraction in %, when measured, with test method, stimulus, timing and protocol-specific reference", "why_it_matters": "Makes functional measurements interpretable within the protocol that produced them." }, { "name": "Wall integrity", "kind": "state", "unit_or_values": "No defect detected; suspected defect; demonstrated defect; not assessable", "why_it_matters": "Distinguishes evidence of structural disruption from an examination that cannot assess it." }, { "name": "Intervention status", "kind": "state", "unit_or_values": "No documented intervention; drainage; partial removal; complete removal; other alteration; unknown", "why_it_matters": "Explains altered anatomy and determines whether subsequent records concern an intact organ or a remnant." } ], "affordances": [ "Associate imaging, operative and pathology observations with the correct gallbladder or remnant.", "Compare dimensions, wall findings and contents across examinations with their acquisition conditions preserved.", "Record storage and emptying evidence without inferring function from appearance alone.", "Flag unresolved organ-local findings for qualified clinical review.", "Record clinician-directed surveillance, drainage or removal and the resulting anatomical state." ] }, "sources": [ { "id": "gray", "title": "Gray's Anatomy: The Anatomical Basis of Clinical Practice", "url": "", "what_it_supports": "Position in the gallbladder fossa, extrahepatic biliary connections, wall layers, and adult size of the viscus." }, { "id": "ta", "title": "Terminologia Anatomica", "url": "", "what_it_supports": "Official anatomical name vesica biliaris / vesica fellea and code A05.8.02.001 (FIPAT/IFAA)." }, { "id": "niddk", "title": "Gallstones", "url": "https://www.niddk.nih.gov/health-information/digestive-diseases/gallstones", "what_it_supports": "Clinical encounter as the organ that forms and harbours gallstones, and the usual indication for cholecystectomy.", "url_status": "live" }, { "id": "wiki", "title": "Gallbladder", "url": "https://en.wikipedia.org/wiki/Gallbladder", "what_it_supports": "Cross-check of identifiers, anatomical variants, wall-thickness threshold on ultrasound, and neighbouring structures.", "url_status": "live" }, { "id": "tokyo", "title": "Tokyo Guidelines 2018: diagnostic criteria and severity grading of acute cholecystitis (J Hepatobiliary Pancreat Sci)", "url": "", "what_it_supports": "Practice standard for diagnosing and grading gallbladder inflammation as a failure mode of the organ." } ], "structure": { "bundles": [ { "id": "organ-identity-and-boundaries", "name": "Organ identity and boundaries", "description": "Establishes which structure is the gallbladder and where its ownership ends.", "rationale": "Nonvisualisation, anatomical variation and surgical alteration can otherwise produce incorrect organ identities.", "layers": [ { "id": "presence-and-localisation", "name": "Presence and localisation", "description": "Records identification evidence and position.", "findings": [ { "id": "identified-gallbladder", "name": "Identified gallbladder", "description": "Captures whether a gallbladder is demonstrated and how its identity was established.", "questions": [ { "text": "Which observations identify this structure as the gallbladder, and where is it relative to the liver?", "kind": "definition", "id": "identified-gallbladder-q01" }, { "text": "If it is not visualised, what evidence distinguishes examination limitations, contraction, removal and congenital absence?", "kind": "provenance", "id": "identified-gallbladder-q02" } ] } ] }, { "id": "neck-and-duct-interface", "name": "Neck and duct interface", "description": "Defines the organ's connection to neighbouring biliary anatomy.", "findings": [ { "id": "cystic-duct-boundary", "name": "Cystic duct boundary", "description": "Records the observed neck-to-duct transition and any uncertainty or alteration.", "questions": [ { "text": "Where does the gallbladder neck transition into the cystic duct in this individual?", "kind": "boundary", "id": "cystic-duct-boundary-q01" }, { "text": "Which imaging or operative evidence establishes that connection and any anatomical variant?", "kind": "provenance", "id": "cystic-duct-boundary-q02" } ] } ] } ] }, { "id": "wall-lumen-and-contents", "name": "Wall, lumen and contents", "description": "Describes the gallbladder's physical form and material within its lumen.", "rationale": "Organ size, wall changes and intraluminal material require distinct observations to avoid conflating anatomy with disease.", "layers": [ { "id": "shape-and-wall", "name": "Shape and wall", "description": "Records morphology, distension and wall measurements.", "findings": [ { "id": "measured-organ-form", "name": "Measured organ form", "description": "Captures organ dimensions and wall appearance under stated examination conditions.", "questions": [ { "text": "What are the gallbladder dimensions and measured wall thickness, including the sites and methods used?", "kind": "measurement", "id": "measured-organ-form-q01" }, { "text": "What fasting, meal, distension and technical conditions accompanied these measurements?", "kind": "provenance", "id": "measured-organ-form-q02" } ] } ] }, { "id": "contents-and-focal-lesions", "name": "Contents and focal lesions", "description": "Separates mobile contents from attached or wall-based abnormalities.", "findings": [ { "id": "material-and-attachment", "name": "Material and attachment", "description": "Records the features used to distinguish calculi, sludge and focal lesions.", "questions": [ { "text": "What material or focal lesion is observed, with what size, number, location and mobility?", "kind": "measurement", "id": "material-and-attachment-q01" }, { "text": "What evidence of attachment, acoustic shadowing or vascularity supports the proposed classification, and what remains indeterminate?", "kind": "provenance", "id": "material-and-attachment-q02" } ] } ] } ] }, { "id": "bile-storage-and-emptying", "name": "Bile storage and emptying", "description": "Records filling and emptying observations within their physiological and test context.", "rationale": "A static image cannot by itself establish gallbladder emptying performance or explain an abnormal functional test.", "layers": [ { "id": "filling-and-distension", "name": "Filling and distension", "description": "Captures the observed storage state and evidence of filling.", "findings": [ { "id": "observed-filling-state", "name": "Observed filling state", "description": "Distinguishes anatomical distension from demonstrated filling during a functional examination.", "questions": [ { "text": "Is the gallbladder contracted or distended, and is there serial or tracer evidence of filling?", "kind": "measurement", "id": "observed-filling-state-q01" }, { "text": "What preparation, timing and technical limitations affect interpretation of apparent filling or nonfilling?", "kind": "provenance", "id": "observed-filling-state-q02" } ] } ] }, { "id": "stimulated-emptying", "name": "Stimulated emptying", "description": "Records measured response to a specified emptying stimulus.", "findings": [ { "id": "protocol-bound-emptying-result", "name": "Protocol-bound emptying result", "description": "Preserves the functional result together with the conditions required to interpret it.", "questions": [ { "text": "What emptying response or ejection fraction was measured, over what interval and using which stimulus?", "kind": "measurement", "id": "protocol-bound-emptying-result-q01" }, { "text": "Which protocol-specific reference and documented confounders were used when interpreting the result?", "kind": "provenance", "id": "protocol-bound-emptying-result-q02" } ] } ] } ] }, { "id": "local-abnormalities-and-integrity", "name": "Local abnormalities and integrity", "description": "Organises evidence of gallbladder disease and structural complications.", "rationale": "An agent must distinguish observed abnormalities, suspected explanations and established diagnoses without attributing every biliary symptom to this organ.", "layers": [ { "id": "inflammatory-and-obstructive-evidence", "name": "Inflammatory and obstructive evidence", "description": "Links local observations to explicitly qualified interpretations.", "findings": [ { "id": "qualified-local-disease-assessment", "name": "Qualified local disease assessment", "description": "Records evidence supporting or opposing inflammation or impaired outflow at the gallbladder interface.", "questions": [ { "text": "Which local observations support or oppose inflammation or impaired gallbladder outflow?", "kind": "provenance", "id": "qualified-local-disease-assessment-q01" }, { "text": "Which conclusions concern the gallbladder itself, and which require linked duct, liver or whole-person assessments?", "kind": "boundary", "id": "qualified-local-disease-assessment-q02" } ] } ] }, { "id": "structural-disruption-and-lesion-status", "name": "Structural disruption and lesion status", "description": "Records suspected wall disruption and the evidential classification of focal lesions.", "findings": [ { "id": "integrity-and-pathology-evidence", "name": "Integrity and pathology evidence", "description": "Separates imaging suspicion from operative or pathological confirmation.", "questions": [ { "text": "Is wall disruption or a focal lesion suspected or demonstrated, and by which examination or specimen?", "kind": "provenance", "id": "integrity-and-pathology-evidence-q01" }, { "text": "What qualified clinical review or follow-up has been requested for this unresolved finding?", "kind": "action", "id": "integrity-and-pathology-evidence-q02" } ] } ] } ] }, { "id": "interventions-and-organ-continuity", "name": "Interventions and organ continuity", "description": "Tracks actions that alter the gallbladder and preserves identity across those changes.", "rationale": "Drainage and partial or complete removal change what can subsequently be observed, measured or acted upon.", "layers": [ { "id": "planned-and-performed-actions", "name": "Planned and performed actions", "description": "Records gallbladder-directed actions and the clinical decisions authorising them.", "findings": [ { "id": "gallbladder-action-record", "name": "Gallbladder action record", "description": "Distinguishes proposed, authorised and completed organ-directed actions.", "questions": [ { "text": "What gallbladder-directed action is proposed, authorised or completed, and what clinical decision supports it?", "kind": "action", "id": "gallbladder-action-record-q01" }, { "text": "What organ-specific anatomy or uncertainty must be resolved before the responsible clinician proceeds?", "kind": "boundary", "id": "gallbladder-action-record-q02" } ] } ] }, { "id": "residual-anatomy-and-specimens", "name": "Residual anatomy and specimens", "description": "Links postoperative anatomy and removed tissue to the original organ.", "findings": [ { "id": "postintervention-organ-state", "name": "Postintervention organ state", "description": "Records what remains and how subsequent observations relate to the preintervention gallbladder.", "questions": [ { "text": "Does the intervention record establish an intact gallbladder, a residual gallbladder remnant or complete removal?", "kind": "provenance", "id": "postintervention-organ-state-q01" }, { "text": "How are any removed specimen, residual gallbladder tissue and cystic duct stump distinguished and linked to the original organ?", "kind": "boundary", "id": "postintervention-organ-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-kinds", "name": "Kinds and varieties", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Typical extrahepatic pear-shaped gallbladder", "Phrygian-cap gallbladder (folded fundus)", "Septate or multiseptate gallbladder", "Duplicated gallbladder", "Intrahepatic gallbladder", "Left-sided gallbladder", "Congenital agenesis of the gallbladder", "Floating (wandering) gallbladder on a long mesentery" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of gallbladder this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "scheme": "Wikidata", "value_or_pattern": "Q64386", "note": "Human gallbladder as an anatomical structure" }, { "scheme": "FMA", "value_or_pattern": "7202", "note": "Foundational Model of Anatomy class Gallbladder" }, { "scheme": "Terminologia Anatomica", "value_or_pattern": "A05.8.02.001", "note": "vesica biliaris / vesica fellea" }, { "scheme": "UBERON", "value_or_pattern": "UBERON:0002110", "note": "Multi-species gallbladder class" }, { "scheme": "MeSH", "value_or_pattern": "D005705", "note": "Heading Gallbladder" }, { "scheme": "SNOMED CT", "value_or_pattern": "28231008", "note": "Gallbladder structure" }, { "scheme": "ICD-O topography", "value_or_pattern": "C23.9", "note": "Primary site code for gallbladder neoplasms" } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of gallbladder this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Terminologia Anatomica - FIPAT / IFAA (anatomical nomenclature of vesica biliaris)", "ICD-10 / ICD-11 - WHO (K80-K82 and successor codes for diseases of the gallbladder)", "SNOMED CT - SNOMED International (structure and disorder concepts)", "Tokyo Guidelines 2018 - Tokyo Guidelines Revision Committee / Japanese Society of Hepato-Biliary-Pancreatic Surgery (diagnosis and severity of acute cholecystitis)", "AJCC / UICC TNM - American Joint Committee on Cancer and Union for International Cancer Control (staging of gallbladder carcinoma)", "SAGES guidelines for laparoscopic cholecystectomy - Society of American Gastrointestinal and Endoscopic Surgeons" ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of gallbladder this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Right-upper-quadrant ultrasound landmark when a patient presents with biliary colic or suspected cholecystitis", "Surgical target of laparoscopic or open cholecystectomy for symptomatic stones or inflammation", "Functional target of hepatobiliary iminodiacetic acid (HIDA) scintigraphy to measure ejection fraction", "Access point for intraoperative cholangiography via the cystic duct", "Resection specimen and staging site in gallbladder carcinoma", "Pathology specimen after cholecystectomy; the organ is not used as a standalone transplant graft" ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of gallbladder this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "quantity": "Adult length", "typical_range": "7-10", "unit": "cm" }, { "quantity": "Maximum transverse diameter", "typical_range": "2.5-4", "unit": "cm" }, { "quantity": "Fasting luminal volume", "typical_range": "30-50", "unit": "mL" }, { "quantity": "Fasting wall thickness on ultrasound", "typical_range": "≤3", "unit": "mm" }, { "quantity": "CCK-stimulated gallbladder ejection fraction (HIDA)", "typical_range": "≥38-40 (protocol-dependent lower limit of normal)", "unit": "%" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of gallbladder this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Cholesterol or pigment cholelithiasis with cystic-duct obstruction and biliary colic", "Acute calculous or acalculous cholecystitis, including gangrene, empyema, and perforation", "Chronic cholecystitis and porcelain (wall-calcified) gallbladder", "Gallbladder adenocarcinoma", "Mirizzi syndrome and gallstone ileus from migrated stones", "Iatrogenic bile-duct injury or bile leak at cholecystectomy" ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of gallbladder this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "British English historically writes 'gall bladder' as two words; Terminologia Anatomica uses both vesica fellea and vesica biliaris", "Cholesterol stones predominate in Western and high-calorie diets; pigment stones are relatively more common in East and South Asia and in chronic hemolysis", "Laparoscopic cholecystectomy is the default in high-resource systems; open cholecystectomy remains more frequent where laparoscopy is unavailable", "East Asian traditional medicine treats 'gallbladder' (dan) as a functional organ-meridian, not identical to the anatomical viscus" ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of gallbladder this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "name": "Common bile duct", "difference": "Tubular conduit continuous with the hepatic ducts, not a blind pear-shaped reservoir; separated on ultrasound or MRCP by shape and luminal continuity." }, { "name": "Cystic duct", "difference": "Narrow connecting channel with spiral valves of Heister, not the bile reservoir itself; distinguished by caliber and lack of a fundus." }, { "name": "Liver (gallbladder fossa)", "difference": "Solid vascular parenchyma versus a fluid-filled viscus with a measurable wall." }, { "name": "Duodenal bulb", "difference": "Gastrointestinal mucosa continuous with the stomach, not a bile-filled lumen." }, { "name": "Hepatic flexure of colon", "difference": "Haustrated, gas- or feces-filled lumen rather than anechoic bile." }, { "name": "Right kidney", "difference": "Retroperitoneal organ with a collecting system, lying posterior to the liver rather than in the gallbladder fossa." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of gallbladder this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does the registry intend this entry to cover human gallbladders only, or multiple species requiring different anatomical and functional references?", "Which examination protocols and population-specific references should govern interpretation of dimensions, wall thickness and emptying measurements?", "What minimum evidence should distinguish nonvisualisation, congenital absence, complete removal and a residual gallbladder remnant?", "Where should ownership of the cystic duct and postoperative stump sit within neighbouring Vercy models?", "Which authoritative clinical sources should define review triggers for gallbladder lesions and suspected complications, and how should their versions be maintained?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 18, "questions": 28 } }, "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 gallbladder, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an AI agent to recognise a gallbladder, record evidence about its anatomy and condition, and distinguish supported next actions from decisions requiring clinical assessment.", "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: snake gallbladder, human gallbladder.", "2 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 103 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 gallbladder, 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": [ "snake gallbladder", "human gallbladder" ] } ], "standing": "Described in 103 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 2 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 gallbladder from another, and a gallbladder 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 gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder 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 gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder 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 gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder 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 gallbladder is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder 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 gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder 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 gallbladder between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a gallbladder 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 gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder 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 gallbladder 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 gallbladder, 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 gallbladder 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 gallbladder 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 gallbladder 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 gallbladder 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 gallbladder 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 gallbladder, 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 gallbladder 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 gallbladder and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a gallbladder, 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 gallbladder, 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 gallbladder 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 gallbladder is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a gallbladder, 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 gallbladder, 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 gallbladder 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 } } } }