{ "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-12T08:43:23Z", "providers": [ "Codex" ], "breadth": "recalled by Codex without web access - no source was read", "missingProviders": [], "pass": 2, "cost": { "grok": { "seconds": 24.6, "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: 01a094c8-0166-7470-b4f0-b4c2c01ecb0a\n--------\nuser\nDescribe what is already known about one registered thing. Answer as JSON only, no prose around it.\n\nThing: clamshell grab\nSense to describe: (none recorded)\nDomain code: PHY.OBJ\nAlso known as: (none)\n\n\nContext for this batch of 1001 things:\n# Batch 043: 1001 ", "usd": 0.0, "recall": true }, "codex": { "seconds": 73.3, "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: 01a094c8-0157-7cd1-b5c3-fd3ef4df65e4\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: clamshell grab\nRegistry id: vr.tr.clamshell-grab\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: (none recorded)\nNames folded into this entry: (no" } }, "enrichment": { "pass": 3, "engine": "claude", "producedAt": "2026-10-06T12:00:00Z", "ingestedAt": "2026-10-06T08:53:14+00:00", "fields": [ "agent_conduct", "ethics", "failure_modes_and_hazards", "owners", "standards_and_regulation", "visual_identification" ] }, "gate": { "passed": true, "version": "1.0", "at": "2026-10-08T19:09:52+00:00", "evidence": [ "completeness 1.00", "sense: Wikidata description", "2 live sources", "review by codex: pass" ] } }, "metaModel": { "id": "THING-Q2896329", "registryId": "vr.tr.clamshell-grab", "name": "clamshell grab", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.OBJ" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q2896329/", "model": { "registry_id": "vr.tr.clamshell-grab", "name": "clamshell grab", "purpose": "Enable an AI agent to recognise a clamshell grab, assess its suitability and condition, and determine whether a proposed material-handling operation is supported by its configuration and evidence.", "definition": "A clamshell grab is a lifting or excavating attachment with two opposed, hinged bucket shells that close around loose material to contain it during lifting and open to discharge it.", "scope_statement": "This model owns the clamshell grab as a kind of attachment with two opposed closing shells, including its material-capture geometry, actuation, carrier interface, operating envelope and condition; product specifications and individual-unit observations supply evidence for those properties.", "in_scope": [ "Opposed shells, cutting edges, pivots and linkages that enclose and release material", "Rope-operated, hydraulic or other documented opening and closing arrangements", "Suspension or mounting interfaces and required carrier services", "Grab capacity, self-mass and material-dependent payload limits", "Capture, retention, discharge and observable operating states", "Grab-specific wear, inspection, maintenance and operating restrictions" ], "out_of_scope": [ "The complete crane, excavator or other carrier and its structural design", "Bulk-material classification and properties beyond their relevance to grab suitability", "Site-wide lifting plans, traffic management and exclusion-zone administration", "Hoppers, stockpiles, vessels and transport systems receiving the load", "Orange-peel grabs, grapples and conventional digging buckets as separate attachment kinds" ], "distinguishing_features": [ "Material is captured between two opposed shell-like halves that move toward one another to form a carrying cavity.", "The load-bearing enclosure is formed by shells rather than the multiple separated tines characteristic of an orange-peel grab.", "Material capture depends on the relative closing movement of the two shells, distinguishing it from a conventional single-body bucket.", "The working surfaces enclose loose material rather than relying primarily on narrow jaws gripping an individual object.", "The attachment has an identifiable opening and closing mechanism and carrier interface; neither the carrier nor a complete unloading installation is itself the grab." ], "characteristics": [ { "name": "Actuation arrangement", "kind": "category", "unit_or_values": "Rope-operated; externally supplied hydraulic; electrohydraulic; other documented arrangement", "why_it_matters": "Determines required carrier services, control behaviour and relevant failure states." }, { "name": "Shell configuration", "kind": "category", "unit_or_values": "Shell profile, edge or tooth arrangement, drainage openings and closure details", "why_it_matters": "Affects penetration, material retention, drainage and suitability for the intended load." }, { "name": "Nominal volumetric capacity", "kind": "measurement", "unit_or_values": "m³, with the manufacturer's capacity definition", "why_it_matters": "Supports payload estimation only when the capacity basis and expected filling behaviour are known." }, { "name": "Grab self-mass", "kind": "measurement", "unit_or_values": "kg, identifying the included equipment and configuration", "why_it_matters": "Consumes part of the carrier's available lifting capacity." }, { "name": "Permitted material payload", "kind": "measurement", "unit_or_values": "kg or t, with configuration and operating restrictions", "why_it_matters": "Bounds allowable contents independently of nominal volume." }, { "name": "Material compatibility", "kind": "relation", "unit_or_values": "Supported material classes linked to bulk density, particle size, cohesion and abrasiveness", "why_it_matters": "Explains why a grab suitable for one bulk material may perform poorly or be unsuitable for another." }, { "name": "Working geometry", "kind": "measurement", "unit_or_values": "Maximum opening, shell width, closed height and relevant clearances in mm or m", "why_it_matters": "Determines access to the material and clearance through holds, hoppers and confined spaces." }, { "name": "Carrier compatibility", "kind": "relation", "unit_or_values": "Documented compatible suspension or mounting interfaces, reeving arrangements and service requirements", "why_it_matters": "Prevents treating physical attachment alone as evidence of operational compatibility." }, { "name": "Service requirements", "kind": "measurement", "unit_or_values": "As applicable: hydraulic pressure in bar or MPa, flow in L/min, electrical supply in V and Hz, rope requirements in manufacturer-specified units", "why_it_matters": "Allows the agent to check that the carrier can operate the closing mechanism within its documented limits." }, { "name": "Shell and load state", "kind": "state", "unit_or_values": "Open; closing; closed; opening; obstructed; unknown, paired with empty; loaded; residual material; unknown", "why_it_matters": "Separates shell position from whether material is actually captured or released." }, { "name": "Mechanical condition", "kind": "state", "unit_or_values": "Observed condition of edges, shells, pivots, linkages and applicable ropes, sheaves or hydraulic components", "why_it_matters": "Supports inspection decisions without assuming an apparently closed grab is serviceable." } ], "affordances": [ "Identify the grab configuration from shell geometry, actuation and attachment evidence.", "Check compatibility with a proposed carrier and its available services.", "Estimate a candidate material payload and compare it with documented grab and carrier limits.", "Assess whether the shell geometry supports capture, retention and discharge of the intended material.", "Interpret operating observations to identify incomplete closure, obstruction, leakage or retained material.", "Determine which inspection, maintenance or operating restrictions apply before further use." ], "agent_conduct": { "may": [ "Operate a clamshell grab on cranes or excavators the agent is authorized to control.", "Inspect shells, hinges, ropes and hydraulics before work and report defects.", "Log loads and cycles for maintenance records." ], "must_not": [ "Swing or open a loaded grab over people.", "Exceed the crane's rated load including the grab's own weight.", "Use a grab to lift people or for loads it was not designed for.", "Dredge in protected waters without the required permits." ], "requires_human": [ "Lifting operations near people, power lines or in confined spaces." ] }, "ethics": { "considerations": [ "Falling material from an open grab can kill workers below.", "Dredging disturbs sediment and aquatic habitats." ], "affected_parties": [ "Workers on the site", "Dock and ship crews", "Aquatic ecosystems" ] }, "owners": { "steward": "The operator of the crane or dredging plant.", "master_systems": [] }, "visual_identification": [ "Two hinged scoop-shaped halves hanging from ropes or a hydraulic arm.", "Seen on cranes at docks, scrap yards and dredgers." ], "failure_modes_and_hazards": [ "Worn ropes or hinges can drop the load.", "Material can spill from a partly closed grab." ], "standards_and_regulation": [ "Directive 2006/42/EC on machinery, European Union." ], "what_it_is_for": [ "A clamshell grab is used with compatible lifting or excavating machinery to collect, move and discharge loose bulk material.", "It is encountered in ports, stockyards, dredging operations and construction sites handling materials such as sand, gravel or sediment.", "Its suitability depends on the material, operating environment and compatibility with the supporting machine." ] }, "sources": [ { "id": "wikidata", "title": "Wikidata item Q2896329: clamshell grab", "url": "https://www.wikidata.org/wiki/Q2896329", "url_status": "live", "what_it_supports": "identity and sense of the item", "checked_by": "wikidata-api" }, { "id": "wikipedia-de", "title": "Wikipedia (de): Zweischalengreifer", "url": "https://de.wikipedia.org/wiki/Zweischalengreifer", "url_status": "live", "checked_by": "wikidata-api sitelink", "what_it_supports": "general description of the item" } ], "structure": { "bundles": [ { "id": "shell-capture-and-retention", "name": "Shell capture and retention", "description": "The paired-shell geometry that admits, encloses, retains and releases material.", "rationale": "The shell cavity and closing edges define what makes this attachment a clamshell grab and which materials it can handle.", "layers": [ { "id": "paired-shell-identity", "name": "Paired-shell identity", "description": "Recognise the attachment through its enclosing surfaces and their relative movement.", "findings": [ { "id": "enclosing-shell-pair", "name": "Enclosing shell pair", "description": "Record evidence that two opposed shells form the carrying cavity, including features that distinguish them from tines or gripping jaws.", "questions": [ { "text": "Which two moving shell surfaces form the material-carrying cavity?", "kind": "definition", "id": "enclosing-shell-pair-q01" }, { "text": "What observed geometry distinguishes this attachment from an orange-peel grab, grapple or single-body bucket?", "kind": "boundary", "id": "enclosing-shell-pair-q02" } ] } ] }, { "id": "material-contact-geometry", "name": "Material-contact geometry", "description": "Describe the shell features governing entry into material and its subsequent retention.", "findings": [ { "id": "edges-gaps-and-drainage", "name": "Edges, gaps and drainage", "description": "Record cutting edges, teeth, closure gaps and deliberate openings against the intended material and retention requirement.", "questions": [ { "text": "What edge profile, teeth, drainage openings and closed-shell gaps does this configuration have?", "kind": "measurement", "id": "edges-gaps-and-drainage-q01" }, { "text": "For the intended particle size and moisture condition, what evidence supports acceptable retention or drainage?", "kind": "provenance", "id": "edges-gaps-and-drainage-q02" } ] } ] } ] }, { "id": "closing-drive-and-control", "name": "Closing drive and control", "description": "How power, ropes and linkages produce shell movement and how that movement is controlled.", "rationale": "Different clamshell actuation arrangements require different services and cannot share assumed control or load-retention behaviour.", "layers": [ { "id": "actuation-path", "name": "Actuation path", "description": "Trace the mechanism from its external input to shell movement.", "findings": [ { "id": "drive-and-transmission", "name": "Drive and transmission", "description": "Identify the actual drive arrangement and its ropes, cylinders, sheaves or linkages without presuming a universal mechanism.", "questions": [ { "text": "What mechanism opens and closes the shells, and which components transmit the closing effort?", "kind": "definition", "id": "drive-and-transmission-q01" }, { "text": "What documented rope arrangement, hydraulic supply or electrical supply is required?", "kind": "measurement", "id": "drive-and-transmission-q02" } ] } ] }, { "id": "command-and-failure-behaviour", "name": "Command and failure behaviour", "description": "Relate commands and loss of services to actual shell behaviour.", "findings": [ { "id": "closure-control-and-holding", "name": "Closure control and holding", "description": "Record how closure is commanded, how its completion is established and what maintains the loaded state.", "questions": [ { "text": "How can an operator or agent distinguish commanded closure from achieved closure or a material obstruction?", "kind": "measurement", "id": "closure-control-and-holding-q01" }, { "text": "What does the documentation require when power, hydraulic pressure, rope tension or a control signal is lost?", "kind": "action", "id": "closure-control-and-holding-q02" } ] } ] } ] }, { "id": "carrier-and-payload-envelope", "name": "Carrier and payload envelope", "description": "The attachment interfaces and combined limits governing a supported lift.", "rationale": "A clamshell grab must fit the carrier mechanically and operationally while leaving sufficient lifting capacity for its contents.", "layers": [ { "id": "attachment-and-services", "name": "Attachment and services", "description": "Establish compatibility between the grab configuration and the proposed carrier.", "findings": [ { "id": "verified-carrier-interface", "name": "Verified carrier interface", "description": "Record suspension or mounting details, applicable reeving and service connections with their supporting compatibility evidence.", "questions": [ { "text": "Which suspension or mounting interface and, where applicable, rope reeving arrangement does this grab require?", "kind": "definition", "id": "verified-carrier-interface-q01" }, { "text": "Which manufacturer documents support use with the proposed carrier and service configuration?", "kind": "provenance", "id": "verified-carrier-interface-q02" } ] } ] }, { "id": "volume-and-mass-limits", "name": "Volume and mass limits", "description": "Separate cavity volume, grab self-mass and allowable contents.", "findings": [ { "id": "material-dependent-load-check", "name": "Material-dependent load check", "description": "Evaluate expected contents using a stated volume basis, material bulk density and filling assumption, then check the applicable load limits.", "questions": [ { "text": "What are the documented capacity, self-mass and permitted material payload for this configuration?", "kind": "measurement", "id": "material-dependent-load-check-q01" }, { "text": "Given the material density, expected filling and carrier capacity at the planned operating position, is the proposed load within all applicable limits?", "kind": "action", "id": "material-dependent-load-check-q02" } ] } ] } ] }, { "id": "grabbing-and-discharge-cycle", "name": "Grabbing and discharge cycle", "description": "Observable states and material behaviour during filling, transfer and emptying.", "rationale": "A closed shell pair does not by itself establish a satisfactory load, and an open pair does not establish complete discharge.", "layers": [ { "id": "material-engagement", "name": "Material engagement", "description": "Assess whether the grab can reach and capture the intended material under the proposed conditions.", "findings": [ { "id": "capture-suitability", "name": "Capture suitability", "description": "Relate opening dimensions and shell features to material accessibility, particle size and resistance to closure.", "questions": [ { "text": "Do the opening dimensions and working clearances permit engagement with the material at the proposed location?", "kind": "measurement", "id": "capture-suitability-q01" }, { "text": "What evidence shows that this configuration can close effectively through the intended material without prohibited forcing or obstruction?", "kind": "provenance", "id": "capture-suitability-q02" } ] } ] }, { "id": "transfer-and-emptying", "name": "Transfer and emptying", "description": "Assess retention during movement and release into the receiving space.", "findings": [ { "id": "retained-and-released-material", "name": "Retained and released material", "description": "Record spillage, incomplete opening and residual material separately from the commanded operating state.", "questions": [ { "text": "What observations establish that the captured material remains contained during the proposed transfer?", "kind": "measurement", "id": "retained-and-released-material-q01" }, { "text": "If material bridges, adheres or remains after opening, what documented clearing procedure is permitted?", "kind": "action", "id": "retained-and-released-material-q02" } ] } ] } ] }, { "id": "integrity-and-use-restrictions", "name": "Integrity and use restrictions", "description": "Grab-specific deterioration, maintenance requirements and evidence governing continued use.", "rationale": "Shell wear, damaged load paths and closing-mechanism faults can undermine containment or control even when the grab still moves.", "layers": [ { "id": "wear-and-load-path-condition", "name": "Wear and load-path condition", "description": "Inspect the structures and moving components that support and retain the load.", "findings": [ { "id": "inspection-and-rejection-evidence", "name": "Inspection and rejection evidence", "description": "Associate observed shell, edge, pivot, linkage and drive-component condition with documented inspection and rejection criteria.", "questions": [ { "text": "What wear, cracking, distortion, excess clearance or leakage is present in the shell assembly and applicable closing components?", "kind": "measurement", "id": "inspection-and-rejection-evidence-q01" }, { "text": "Which documented limits determine whether the observed condition requires adjustment, repair or withdrawal from service?", "kind": "provenance", "id": "inspection-and-rejection-evidence-q02" } ] } ] }, { "id": "safe-intervention-and-applicability", "name": "Safe intervention and applicability", "description": "Establish supported maintenance actions and the requirements applicable to the particular configuration and use.", "findings": [ { "id": "isolation-and-operating-authority", "name": "Isolation and operating authority", "description": "Record shell-support and energy-isolation procedures together with applicable manufacturer restrictions and verified conformity requirements.", "questions": [ { "text": "How must the shells be supported and relevant rope loads, hydraulic pressure or electrical energy controlled before inspection or maintenance?", "kind": "action", "id": "isolation-and-operating-authority-q01" }, { "text": "Which standards, issuing bodies, inspection obligations and conformity records apply to this grab configuration, jurisdiction and intended service?", "kind": "provenance", "id": "isolation-and-operating-authority-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 describes the equipment kind, not a particular manufacturer's model or individual unit.", "The capacity range is an approximate recall-based indication, not a specification; permissible payload depends on material density, grab mass and supporting-machine capacity.", "Applicable standards and inspection requirements should be established for the jurisdiction, supporting machine and intended lifting or dredging service." ], "questions": [ { "id": "evidence-confidence-notes-q01", "text": "Which of these check these first hold for the sense of clamshell grab 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": [ "Single-rope mechanical grab", "Two-rope mechanical grab", "Four-rope mechanical grab", "Hydraulically operated grab", "Electrohydraulic grab" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of clamshell grab 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": [ "Loading and unloading bulk cargo such as grain, coal, ore and aggregates", "Dredging sediment from harbours and waterways", "Excavating pits, shafts and trenches", "Transferring loose material between stockpiles, hoppers and transport vehicles" ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of clamshell grab this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "quantity": "Nominal bucket volume", "typical_range": "Approximately 0.5-30 for many industrial designs; smaller and larger grabs also exist", "unit": "m³" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of clamshell grab 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": [ "Worn cutting edges or trapped material prevent complete closure and allow material to spill.", "Failure of ropes, chains, pins or lifting connections can drop the grab or its load.", "Hydraulic leakage or actuator failure can impair closure or load retention.", "Closing shells and operating linkages create crushing and pinch hazards.", "Excessive payload, snagging or swinging can overload or destabilise the supporting lifting machine." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of clamshell grab this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "British usage commonly favours 'clamshell grab', while North American usage often uses 'clamshell bucket'; these terms overlap." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of clamshell grab 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": "Orange-peel grab", "difference": "Uses several radial tines or petals rather than two opposed bucket shells, commonly to handle irregular material such as scrap." }, { "name": "Dragline bucket", "difference": "Fills by being dragged through material rather than by closing two shells around it." }, { "name": "Excavator digging bucket", "difference": "Typically has one rigid scoop that fills through movement of the excavator arm and bucket linkage." }, { "name": "Crane", "difference": "Provides lifting and positioning; the clamshell grab is the material-engaging attachment it may carry." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of clamshell grab this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does the registry intend this entry to include both suspended clamshell grabs and rigidly mounted clamshell attachments, and does an existing Vercy world model already cover that scope?", "Which manufacturer sources establish representative capacity, mass and dimensional ranges separately for bulk handling, excavation and dredging configurations?", "Which standards and conformity requirements apply to each actuation arrangement and jurisdiction, and which obligations belong to the carrier rather than the grab?", "What configuration-specific evidence establishes behaviour after loss of power, pressure or rope tension and the permitted response to incomplete closure?", "Which measured wear limits and material-retention criteria distinguish ordinary serviceable grabs from configurations intended for fine, wet or environmentally sensitive material?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 17, "questions": 27 } }