{ "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-06T21:51:32Z", "providers": [ "Codex" ], "missingProviders": [ "Grok" ], "pass": 2, "cost": { "grok": { "usd": null, "turns": null, "seconds": 2.3, "error": "Error: Internal error: {\n \"message\": \"API error (status 402 Payment Required): Grok Build usage balance exhausted\",\n \"http_status\": 402\n}", "retried": true }, "codex": { "seconds": 56.4, "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: 01a078b3-adc1-7422-830f-95e5ad324c09\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: shoulder\nRegistry id: vr.tr.shoulder\nPlane / domain: PHY / PHY.LIV\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA Vercy" } }, "enrichment": { "pass": 3, "engine": "claude", "producedAt": "2026-10-06T11:00:00Z", "ingestedAt": "2026-10-06T08:11:13+00:00", "fields": [ "agent_conduct", "ethics", "failure_modes_and_hazards", "owners", "visual_identification" ] }, "gate": { "passed": true, "version": "1.0", "at": "2026-10-07T10:10:26+00:00", "evidence": [ "completeness 1.00", "sense: Wikidata description", "2 live sources", "review by codex: pass" ] } }, "metaModel": { "id": "THING-Q16363", "registryId": "vr.tr.shoulder", "name": "shoulder", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.LIV" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q16363/", "model": { "registry_id": "vr.tr.shoulder", "name": "shoulder", "purpose": "Enable an AI agent to recognise an anatomical shoulder, record its structure and functional state, and determine which assessments or activities are supported by available evidence and permissions.", "definition": "", "scope_statement": "This model owns one person's left or right shoulder region as the functional connection between trunk and upper limb, including the shoulder joint complex and locally relevant tissues; its anatomical boundaries must be recorded explicitly.", "in_scope": [ "Shoulder identity, laterality, anatomical boundaries and relationship to its person", "Glenohumeral, acromioclavicular and sternoclavicular articulations, and scapulothoracic movement", "Locally relevant bones, muscles, tendons, ligaments, capsule and other soft tissues", "Shoulder movement, stability, symptoms and task performance", "Shoulder-specific assessments, activity restrictions and responses to documented interventions" ], "out_of_scope": [ "Whole-person health, systemic disease and general treatment planning", "Cervical spine conditions and their independent assessment", "Elbow, forearm, wrist and hand structure or function", "Complete thoracic anatomy and respiratory function", "Road shoulders, garment shoulders and other non-anatomical meanings" ], "distinguishing_features": [ "The referent is a bodily region connecting the upper limb to the trunk, rather than a road edge or part of clothing.", "A shoulder instance has a specified person and side; a bilateral observation must distinguish the two shoulders.", "The referent includes coordinated upper-arm, scapular and clavicular relationships rather than only the glenohumeral joint.", "Its anatomical extent is identified through shoulder landmarks and declared boundaries rather than treating the entire upper arm or neck as shoulder.", "Pain described as being in the shoulder is recorded separately from evidence that its cause lies within the shoulder." ], "characteristics": [ { "name": "Person and laterality", "kind": "relation", "unit_or_values": "Person reference; left, right or unresolved", "why_it_matters": "Prevents observations and actions from being assigned to the wrong shoulder." }, { "name": "Anatomical extent", "kind": "category", "unit_or_values": "Whole shoulder region, specified articulation, specified tissue or unresolved extent", "why_it_matters": "Distinguishes a regional observation from a claim about an individual structure." }, { "name": "Structural configuration", "kind": "state", "unit_or_values": "Documented native, surgically altered, prosthetic, other specified or unknown configuration", "why_it_matters": "Changes how landmarks, movement and intervention constraints should be interpreted." }, { "name": "Movement range", "kind": "measurement", "unit_or_values": "Degrees, with movement, plane, active or passive mode, body position and method", "why_it_matters": "Makes shoulder mobility observations interpretable and comparable." }, { "name": "Scapulohumeral coordination", "kind": "state", "unit_or_values": "Task-specific description of scapular and upper-arm movement; unassessed permitted", "why_it_matters": "Distinguishes overall arm elevation from how the shoulder components contribute." }, { "name": "Force or torque capacity", "kind": "measurement", "unit_or_values": "Newtons or newton-metres, with movement, position, device and protocol", "why_it_matters": "Supports comparison of shoulder capacity under defined test conditions." }, { "name": "Symptom experience", "kind": "state", "unit_or_values": "Reported location, quality, intensity using a named scale, timing and provoking or easing conditions", "why_it_matters": "Connects symptoms to shoulder use without assuming a diagnosis." }, { "name": "Stability evidence", "kind": "state", "unit_or_values": "Reported slipping or giving way, observed findings, documented episodes or unassessed", "why_it_matters": "Preserves the distinction between perceived instability and established structural findings." }, { "name": "Task tolerance", "kind": "measurement", "unit_or_values": "Task-specific load in kilograms, duration in seconds or minutes, repetitions and reported response", "why_it_matters": "Relates shoulder function to actual reaching, lifting, carrying or support demands." }, { "name": "Applicable restrictions", "kind": "relation", "unit_or_values": "Linked instruction with issuer, affected movement or load, effective dates and review conditions", "why_it_matters": "Provides an explicit basis for deciding which proposed activities are permitted." } ], "affordances": [ "Identify and localise a shoulder observation to a side, articulation or tissue.", "Record shoulder movement and force measurements with their assessment conditions.", "Compare shoulder function across time or sides while retaining differences in measurement context.", "Relate reaching, lifting, carrying and weight-support tasks to observed shoulder tolerance.", "Check a proposed shoulder activity against documented restrictions and unresolved evidence.", "Track the shoulder's response to an authorised assessment, activity or intervention." ], "agent_conduct": { "may": [ "Record and report a shoulder's observations in the person's care record when authorized.", "Explain shoulder anatomy and general exercise guidance from clinical sources.", "Support a clinician by noting which side, left or right, a finding concerns." ], "must_not": [ "Diagnose a shoulder injury or prescribe treatment for a person.", "Move, manipulate or load a person's shoulder without consent and clinical direction.", "Share images or records of a person's shoulder without consent.", "Mix up left and right sides in records." ], "requires_human": [ "Any treatment, manipulation or surgery decision for the shoulder.", "Sharing the person's shoulder records with others." ] }, "ethics": { "considerations": [ "The shoulder belongs to a person; consent governs every touch and record.", "Wrong-side errors in care cause avoidable harm." ], "affected_parties": [ "The person", "Clinicians", "Carers" ] }, "owners": { "steward": "The person whose shoulder it is; clinicians hold the medical record.", "master_systems": [ "Medical records of the person's care providers" ] }, "visual_identification": [ "The rounded junction between the trunk and the upper arm, with the bony point of the acromion on top.", "Collarbone in front and shoulder blade behind." ], "failure_modes_and_hazards": [ "Dislocation, especially from falls or forced movement.", "Rotator cuff tears from overload or ageing.", "Nerve injury from improper positioning or lifting." ], "what_it_is_for": [ "The shoulder is used in reaching, lifting, carrying and positioning the hand during daily activities.", "Its structure and movement are examined in anatomy, rehabilitation, sports assessment and ergonomic design." ], "standards_and_regulation": [ "The International Classification of Diseases, issued by the World Health Organization, provides official categories for recording shoulder injuries and disorders." ] }, "sources": [ { "id": "wikidata", "title": "Wikidata item Q16363: shoulder", "url": "https://www.wikidata.org/wiki/Q16363", "url_status": "live", "what_it_supports": "identity and sense of the item", "checked_by": "wikidata-api" }, { "id": "wikipedia-en", "title": "Wikipedia: Shoulder", "url": "https://en.wikipedia.org/wiki/Shoulder", "url_status": "live", "what_it_supports": "general description of the item", "checked_by": "wikidata-api sitelink" } ], "structure": { "bundles": [ { "id": "shoulder-identity-and-extent", "name": "Shoulder identity and extent", "description": "Establishes which shoulder is represented and which anatomical structures a statement concerns.", "rationale": "Shoulder can denote a broad region or a single joint, and those meanings support different conclusions.", "layers": [ { "id": "person-side-and-boundaries", "name": "Person, side and boundaries", "description": "Anchors the shoulder instance to its person, laterality and declared regional extent.", "findings": [ { "id": "identified-shoulder-region", "name": "Identified shoulder region", "description": "Records the shoulder's identity and the landmarks or conventions used to delimit it.", "questions": [ { "text": "Whose shoulder is represented, and is it the left or right shoulder?", "kind": "definition", "id": "identified-shoulder-region-q01" }, { "text": "Which landmarks delimit this shoulder from the neck, thorax and upper arm for the current task?", "kind": "boundary", "id": "identified-shoulder-region-q02" } ] } ] }, { "id": "joint-complex-and-tissues", "name": "Joint complex and tissues", "description": "Locates observations within shoulder articulations, movement interfaces and associated tissues.", "findings": [ { "id": "structure-specific-localisation", "name": "Structure-specific localisation", "description": "Records whether evidence concerns the region, a particular articulation or a named tissue, including altered anatomy.", "questions": [ { "text": "Does this observation concern the whole shoulder, the glenohumeral, acromioclavicular or sternoclavicular articulation, the scapulothoracic interface, or a specified tissue?", "kind": "definition", "id": "structure-specific-localisation-q01" }, { "text": "What examination, imaging, operative record or other evidence establishes the named structure and any anatomical alteration?", "kind": "provenance", "id": "structure-specific-localisation-q02" } ] } ] } ] }, { "id": "shoulder-motion-and-capacity", "name": "Shoulder motion and capacity", "description": "Captures how the shoulder moves and produces force under specified conditions.", "rationale": "Arm position alone does not show joint contribution, compensatory movement or usable shoulder capacity.", "layers": [ { "id": "range-and-coordination", "name": "Range and coordination", "description": "Describes active and passive movement together with scapular and trunk contributions.", "findings": [ { "id": "contextualised-shoulder-movement", "name": "Contextualised shoulder movement", "description": "Records movement range and the observed coordination used to achieve it.", "questions": [ { "text": "What range was recorded for the specified shoulder movement, using which plane, body position, method and active or passive mode?", "kind": "measurement", "id": "contextualised-shoulder-movement-q01" }, { "text": "What scapular movement or trunk compensation accompanied the upper-arm movement, and how was it observed?", "kind": "measurement", "id": "contextualised-shoulder-movement-q02" } ] } ] }, { "id": "force-and-task-tolerance", "name": "Force and task tolerance", "description": "Connects measured shoulder capacity to defined upper-limb tasks.", "findings": [ { "id": "shoulder-demand-response", "name": "Shoulder demand response", "description": "Records performance and symptoms under a specified movement, load or sustained position.", "questions": [ { "text": "What force, torque, repetitions or duration did the shoulder achieve, under which test position and protocol?", "kind": "measurement", "id": "shoulder-demand-response-q01" }, { "text": "During which reaching, lifting, carrying or arm-support task did limitation occur, and what load, arm position and symptom response were recorded?", "kind": "measurement", "id": "shoulder-demand-response-q02" } ] } ] } ] }, { "id": "shoulder-symptoms-and-integrity", "name": "Shoulder symptoms and integrity", "description": "Separates experienced symptoms from evidence about local tissue condition and joint stability.", "rationale": "A shoulder complaint does not by itself identify the affected structure or establish that the cause is local.", "layers": [ { "id": "symptom-pattern-and-locality", "name": "Symptom pattern and locality", "description": "Captures the location, timing and activity dependence of shoulder complaints.", "findings": [ { "id": "located-shoulder-complaint", "name": "Located shoulder complaint", "description": "Preserves reported symptoms and the uncertainty surrounding their anatomical origin.", "questions": [ { "text": "Where are symptoms felt, when did they begin, and how do arm position, shoulder use, rest or sleep affect them?", "kind": "measurement", "id": "located-shoulder-complaint-q01" }, { "text": "What evidence supports a local shoulder origin, and what possible contribution from the neck or another region remains unresolved?", "kind": "boundary", "id": "located-shoulder-complaint-q02" } ] } ] }, { "id": "tissue-condition-and-stability", "name": "Tissue condition and stability", "description": "Records sourced structural findings and reported or observed instability.", "findings": [ { "id": "supported-integrity-assessment", "name": "Supported integrity assessment", "description": "Distinguishes symptoms, examination findings, imaging observations and clinician interpretations.", "questions": [ { "text": "Which shoulder tissue or articulation has a documented finding, who interpreted it, and what dated evidence supports that interpretation?", "kind": "provenance", "id": "supported-integrity-assessment-q01" }, { "text": "Are slipping, giving way, dislocation or subluxation reported or documented, and which side, circumstances and evidence apply to each episode?", "kind": "provenance", "id": "supported-integrity-assessment-q02" } ] } ] } ] }, { "id": "shoulder-action-and-reassessment", "name": "Shoulder action and reassessment", "description": "Connects proposed shoulder activities to existing instructions, evidence and follow-up observations.", "rationale": "Measured mobility or strength alone cannot establish permission for loading, testing or rehabilitation.", "layers": [ { "id": "movement-and-loading-permissions", "name": "Movement and loading permissions", "description": "Represents shoulder-specific constraints on movement, loading and assessment.", "findings": [ { "id": "applicable-shoulder-instructions", "name": "Applicable shoulder instructions", "description": "Records the source and applicability of restrictions, especially after injury or surgery.", "questions": [ { "text": "Which current instructions constrain this shoulder's elevation, rotation, lifting, weight bearing or passive movement, and who issued them?", "kind": "provenance", "id": "applicable-shoulder-instructions-q01" }, { "text": "Does the proposed shoulder activity meet those instructions, and what unresolved condition requires review before proceeding?", "kind": "action", "id": "applicable-shoulder-instructions-q02" } ] } ] }, { "id": "intervention-response-and-review", "name": "Intervention response and review", "description": "Tracks what was done to or with the shoulder and the evidence used to reconsider subsequent action.", "findings": [ { "id": "documented-shoulder-response", "name": "Documented shoulder response", "description": "Links an authorised activity or intervention to its dose, subsequent response and review conditions.", "questions": [ { "text": "What shoulder activity or intervention occurred, at what load, range, duration or frequency, and what immediate or delayed response followed?", "kind": "measurement", "id": "documented-shoulder-response-q01" }, { "text": "What documented criteria govern continuing, modifying or stopping the activity, or requesting reassessment of this shoulder?", "kind": "action", "id": "documented-shoulder-response-q02" } ] } ] } ] } ] }, "openQuestions": [ "Does the registry intend shoulder to cover human anatomy only, or should nonhuman shoulders share this model with species-specific extensions?", "Which anatomical boundary convention should govern inclusion of the axilla, proximal upper arm and surrounding neurovascular structures?", "Which neighbouring Vercy models already own shoulder articulations, individual tissues, injuries and procedures, and how should this regional model reference them?", "Which shoulder assessment protocols and interpretation references are suitable for the intended population and use context?", "Which sourced clinical instructions and role permissions should govern activity decisions when shoulder symptoms, postoperative restrictions or incomplete assessments are present?" ], "statistics": { "bundles": 4, "layers": 8, "findings": 8, "questions": 16 } }