{ "model": { "rank": 4384, "code": "thing-surface", "model_id": "vr.tr.surface", "name": "surface", "purpose": "the outer boundary of an artifact or a material layer constituting or resembling such a boundary", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.OBJ", "industry": "", "version": "", "url": "/models/thing/surface/", "tier": 2, "score": 76, "payload": { "layer": "wordnet", "aliases": [ "afterdeck", "apron", "auction block", "block", "bandstand", "outdoor stage", "stand", "boat deck", "boxing ring", "prize ring", "bridge", "bridge deck", "catwalk", "clipboard", "conning tower", "countertop", "crow's nest", "curbside", "dais", "podium", "pulpit", "rostrum", "ambo", "stump", "soapbox", "deck", "dock", "loading dock", "flight deck", "landing deck", "fly gallery", "fly floor", "flying bridge", "flybridge", "fly bridge", "monkey bridge", "footboard", "footplate", "foredeck", "foretop" ], "aliasCount": 113, "merged": 76, "knownIn": 0, "facets": { "substance": "material", "origin": "manufactured", "agency": "inert", "mobility": "portable", "scale": "handheld", "affordances": [ "graspable" ] }, "markers": [ "artifact" ], "lexicalClass": "noun.artifact", "senseRank": 0, "alsoRegisteredAs": null, "source": { "dataset": "oewn:2024", "synset": "oewn-04369112-n", "ili": "i59827", "license": "CC BY 4.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-09T20:05:59Z", "providers": [ "Codex" ], "breadth": "recalled by Codex without web access - no source was read", "missingProviders": [], "pass": 2, "cost": { "grok": { "seconds": 25.9, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.4\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a087c6-0f63-7a10-a539-a4f57ac7474e\n--------\nuser\nDescribe what is already known about one registered thing. Answer as JSON only, no prose around it.\n\nThing: surface\nSense to describe: the outer boundary of an artifact or a material layer constituting or resembling such a boundary\nDomain code: PHY.OBJ\nAlso kn", "usd": 0, "recall": true }, "codex": { "seconds": 60.7, "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: 01a087c6-0f72-7031-995d-60936cd7ee0a\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: surface\nRegistry id: vr.tr.surface\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: the outer boundary of an artifact or a material layer constitut" } } }, "metaModel": { "id": "THING-SURFACE", "registryId": "vr.tr.surface", "name": "surface", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.OBJ" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/surface/", "model": { "registry_id": "vr.tr.surface", "name": "surface", "purpose": "Enable an agent to identify a physical surface, describe its boundary or material-layer character, assess its condition, and choose appropriate inspection or treatment actions.", "definition": "A surface is the outer boundary of an artifact or material body, or a material layer that constitutes or resembles that boundary and mediates contact with its surroundings.", "scope_statement": "This model owns the physical sense of surface in vr.tr.surface: an artifact's outer boundary or a material layer constituting or resembling that boundary, including its extent, geometry, composition, interactions and condition at a stated observation scale.", "in_scope": [ "Exposed and cavity-facing boundaries of artifacts", "Material layers constituting or resembling an outer boundary", "Surface patches identified relative to a supporting artifact or layer", "Surface geometry, texture and localized discontinuities", "Surface interactions and changes caused by exposure, contact or treatment" ], "out_of_scope": [ "Abstract mathematical surfaces independent of physical realization", "The complete artifact, including its internal components and overall function", "Bulk material properties except where needed to interpret surface behavior", "Interfaces buried between materials unless they qualify as a boundary-like material layer", "Graphical interface surfaces and metaphorical uses of surface" ], "distinguishing_features": [ "It can be located as an artifact boundary or as a material layer constituting or resembling one; an arbitrary volume within a body does not qualify.", "Its extent follows a boundary or boundary-like layer rather than encompassing the complete supporting artifact.", "A boundary surface has no assigned material thickness; a surface modeled as a material layer requires an explicit thickness convention.", "A geometric representation describes the physical surface at a stated scale but is not itself the registered physical thing.", "A change in coating, contamination or finish can alter the surface while leaving the supporting artifact identifiable as the same artifact." ], "characteristics": [ { "name": "Physical realization", "kind": "category", "unit_or_values": "artifact boundary | material surface layer | unresolved", "why_it_matters": "Determines whether thickness, composition and removal refer to an actual material layer or to material adjacent to a boundary." }, { "name": "Supporting artifact or substrate", "kind": "relation", "unit_or_values": "identified artifact, substrate or underlying layer", "why_it_matters": "Locates the surface and supplies context for permissible inspection and treatment." }, { "name": "Patch extent", "kind": "relation", "unit_or_values": "bounded region in a referenced drawing, image or coordinate system", "why_it_matters": "Makes observations and actions refer to the same portion of surface." }, { "name": "Surface area", "kind": "measurement", "unit_or_values": "m², with projected or developed area convention and observation scale", "why_it_matters": "Supports coverage and contact estimates without conflating different area definitions." }, { "name": "Local orientation and curvature", "kind": "measurement", "unit_or_values": "normal direction in a stated frame; curvature in m⁻¹ with convention", "why_it_matters": "Affects contact, drainage, visibility and access by inspection or treatment equipment." }, { "name": "Surface texture", "kind": "measurement", "unit_or_values": "named profile or areal parameter, unit, sampling interval and filtering settings", "why_it_matters": "Distinguishes measured texture from shape and prevents comparison of incompatible roughness results." }, { "name": "Surface-layer thickness", "kind": "measurement", "unit_or_values": "m or µm with method and spatial variation; not applicable to a boundary-only interpretation", "why_it_matters": "Constrains removal, wear allowance and interpretation of substrate influence." }, { "name": "Exposed composition", "kind": "category", "unit_or_values": "identified surface constituents with analytical depth and method; unknown where unmeasured", "why_it_matters": "Distinguishes the exposed material from the nominal bulk material." }, { "name": "Adjacent medium or contacting body", "kind": "relation", "unit_or_values": "identified gas, liquid, solid or vacuum environment, with exposure conditions", "why_it_matters": "Places wetting, friction, transfer and degradation observations in their actual context." }, { "name": "Condition distribution", "kind": "state", "unit_or_values": "mapped observations of deposits, wear, cracking, corrosion, peeling or other relevant changes", "why_it_matters": "Preserves localized defects that a single overall condition label could conceal." } ], "affordances": [ "Locate and mark a surface patch for repeat inspection or treatment.", "Measure shape, area and texture using a declared spatial scale and method.", "Inspect exposed composition, deposits and material-layer thickness where applicable.", "Assess suitability for a specified contact, coating, cleaning or bonding operation.", "Select and delimit cleaning, finishing, coating or repair actions using surface and substrate constraints.", "Compare observations over time to identify wear, deposition or other surface changes." ] }, "sources": [], "structure": { "bundles": [ { "id": "surface-identity-and-extent", "name": "Surface identity and extent", "description": "Establishes which physical boundary or boundary-like layer is being modeled and where it ends.", "rationale": "Surface can denote either a boundary or material at that boundary, and observations become ambiguous unless that distinction and the selected patch are explicit.", "layers": [ { "id": "physical-sense", "name": "Physical sense", "description": "Separates the registered physical surface from geometric and metaphorical senses.", "findings": [ { "id": "boundary-or-layer", "name": "Boundary or layer", "description": "Record whether the referent is an artifact boundary or a material layer and identify what supports that interpretation.", "questions": [ { "text": "Does this surface denote an outer boundary or a material layer constituting or resembling one?", "kind": "definition", "id": "boundary-or-layer-q01" }, { "text": "Which artifact or substrate carries it, and what establishes that relationship?", "kind": "boundary", "id": "boundary-or-layer-q02" } ] } ] }, { "id": "patch-delimitation", "name": "Patch delimitation", "description": "Defines the selected surface region and its continuity across edges, openings and changes in finish.", "findings": [ { "id": "surface-patch-boundaries", "name": "Surface patch boundaries", "description": "Anchor the patch to reproducible features and make inclusion of edges, cavities and openings explicit.", "questions": [ { "text": "Which coordinates or physical landmarks delimit the patch?", "kind": "boundary", "id": "surface-patch-boundaries-q01" }, { "text": "Do edges, openings, cavity walls or finish transitions terminate this patch or belong within it?", "kind": "boundary", "id": "surface-patch-boundaries-q02" } ] } ] } ] }, { "id": "surface-geometry-and-texture", "name": "Surface geometry and texture", "description": "Describes the shape and texture of the physical boundary at a declared resolution.", "rationale": "Area, roughness and apparent continuity depend on observation scale and on how the surface is represented.", "layers": [ { "id": "shape-and-area", "name": "Shape and area", "description": "Captures macroscopic form, orientation and the convention used to calculate area.", "findings": [ { "id": "geometric-reference", "name": "Geometric reference", "description": "Relate the observed surface to a coordinate frame and distinguish projected area from area following the measured shape.", "questions": [ { "text": "What reference frame and geometric representation locate the surface and define its outward direction?", "kind": "measurement", "id": "geometric-reference-q01" }, { "text": "Is the reported area projected or developed, and at what spatial resolution was it determined?", "kind": "measurement", "id": "geometric-reference-q02" } ] } ] }, { "id": "texture-and-discontinuities", "name": "Texture and discontinuities", "description": "Captures fine relief and features such as grooves, pores and pits without confusing them with overall form.", "findings": [ { "id": "scale-qualified-texture", "name": "Scale-qualified texture", "description": "Describe texture through named measurements and retain directional or localized features relevant to use.", "questions": [ { "text": "Which texture parameters, sampling direction, resolution and filters characterize this patch?", "kind": "measurement", "id": "scale-qualified-texture-q01" }, { "text": "Which grooves, pores, pits or sharp features require separate mapping rather than an averaged roughness value?", "kind": "measurement", "id": "scale-qualified-texture-q02" } ] } ] } ] }, { "id": "surface-material-and-layering", "name": "Surface material and layering", "description": "Distinguishes exposed constituents, intentional surface layers and incidental deposits from underlying material.", "rationale": "The material encountered at a surface may differ from the bulk, and treatment depends on identifying which material is present and how it is attached.", "layers": [ { "id": "exposed-material", "name": "Exposed material", "description": "Records what occupies the exposed region and how composition was established.", "findings": [ { "id": "composition-at-observation-depth", "name": "Composition at observation depth", "description": "Associate composition claims with their analytical depth and distinguish measured constituents from assumed substrate composition.", "questions": [ { "text": "Which constituents were identified at the exposed surface, by what method and over what analytical depth?", "kind": "measurement", "id": "composition-at-observation-depth-q01" }, { "text": "What evidence distinguishes substrate, intentional coating, reaction layer and deposited contamination?", "kind": "provenance", "id": "composition-at-observation-depth-q02" } ] } ] }, { "id": "layer-extent-and-attachment", "name": "Layer extent and attachment", "description": "Characterizes material thickness, coverage and attachment when the surface is realized as a layer.", "findings": [ { "id": "material-layer-boundary", "name": "Material-layer boundary", "description": "Define the layer's lower boundary and record coverage or attachment variations without assigning thickness to a purely geometric boundary.", "questions": [ { "text": "If this is a material layer, how is its lower boundary defined and how does thickness vary across the patch?", "kind": "measurement", "id": "material-layer-boundary-q01" }, { "text": "Where is coverage incomplete or attachment uncertain, and what observation supports that assessment?", "kind": "measurement", "id": "material-layer-boundary-q02" } ] } ] } ] }, { "id": "surface-contact-and-response", "name": "Surface contact and response", "description": "Relates the surface to its exposure environment and to specified contact or transfer tasks.", "rationale": "Surface suitability depends on what contacts it and under which conditions; friction, wetting and bonding cannot be judged from appearance alone.", "layers": [ { "id": "exposure-and-contact", "name": "Exposure and contact", "description": "Identifies the neighboring medium or body and the conditions of interaction.", "findings": [ { "id": "contact-context", "name": "Contact context", "description": "Record whether the patch is exposed, immersed or contacting another body and identify the relevant operating conditions.", "questions": [ { "text": "Which medium or body contacts this patch, and is contact continuous, intermittent or absent?", "kind": "boundary", "id": "contact-context-q01" }, { "text": "What temperature, contact load, relative motion or exposure duration applies to the intended assessment?", "kind": "measurement", "id": "contact-context-q02" } ] } ] }, { "id": "task-specific-response", "name": "Task-specific response", "description": "Connects measured surface behavior to a particular use.", "findings": [ { "id": "surface-suitability-evidence", "name": "Surface suitability evidence", "description": "Select evidence relevant to the intended interaction and retain the conditions under which that evidence was obtained.", "questions": [ { "text": "Which response matters for the intended task: wetting, friction, adhesion, optical response or transfer across the boundary?", "kind": "action", "id": "surface-suitability-evidence-q01" }, { "text": "Which measurement or test supports suitability, with what contacting material, conditions and acceptance criterion?", "kind": "measurement", "id": "surface-suitability-evidence-q02" } ] } ] } ] }, { "id": "surface-condition-and-treatment", "name": "Surface condition and treatment", "description": "Tracks localized surface change and constrains interventions that remove, add or alter exposed material.", "rationale": "A surface can change substantially while its supporting artifact persists, and treatment can erase evidence or damage a functional layer.", "layers": [ { "id": "condition-and-change", "name": "Condition and change", "description": "Maps observed departures from a reference state and separates observations from proposed causes.", "findings": [ { "id": "localized-surface-change", "name": "Localized surface change", "description": "Record the location and extent of deposits, loss, cracks or detachment against a dated baseline.", "questions": [ { "text": "Where are deposits, wear, pits, cracks or peeling observed, and what are their measured extents?", "kind": "measurement", "id": "localized-surface-change-q01" }, { "text": "Which earlier observation or specified finish provides the comparison baseline, and which causes remain unverified?", "kind": "provenance", "id": "localized-surface-change-q02" } ] } ] }, { "id": "treatment-and-verification", "name": "Treatment and verification", "description": "Defines allowable surface interventions and the evidence needed to assess their results.", "findings": [ { "id": "controlled-surface-intervention", "name": "Controlled surface intervention", "description": "Tie cleaning, abrasion, coating or repair to a delimited patch, material constraints and measurable completion criteria.", "questions": [ { "text": "Which treatment is permitted, over which patch, and what limits protect the substrate, surface layer and required texture?", "kind": "action", "id": "controlled-surface-intervention-q01" }, { "text": "Which post-treatment observations will verify the required cleanliness, coverage, geometry or contact behavior?", "kind": "measurement", "id": "controlled-surface-intervention-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 entry covers the physical boundary and boundary-layer sense, not the mathematical sense or a named product.", "Kinds overlap: a coated surface can also be polished, textured or porous.", "Standards are recalled without consultation; verify applicable editions and measurement definitions. No universal identifier or typical measurement range applies to surfaces generally." ], "questions": [ { "id": "evidence-confidence-notes-q01", "text": "Which of these check these first hold for the sense of surface 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": [ "Uncoated substrate surface", "Coated surface", "Polished surface", "Textured surface", "Porous surface", "Fracture surface" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of surface this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "ISO 21920 series, issued by the International Organization for Standardization: specification and assessment of surface texture using profile methods.", "ISO 25178 series, issued by the International Organization for Standardization: areal characterization of surface texture.", "ISO 8501-1, issued by the International Organization for Standardization: visual assessment of rust grades and preparation grades of steel substrates before application of paints and related products." ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of surface 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": [ "Providing contact faces for bearings, sliding components and seals.", "Receiving coatings, adhesives, printing or other finishing treatments.", "Controlling optical reflection, appearance and tactile feel.", "Providing barriers against environmental exposure and contamination.", "Supporting cleaning, wetting and heat exchange." ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of surface 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": "Surface roughness, such as profile Ra or areal Sa", "typical_range": "No universal typical range; depends on material, manufacturing process and function.", "unit": "µm" }, { "quantity": "Thickness of a surface coating or material layer", "typical_range": "Application-dependent; applicable to a material layer, not an ideal geometric boundary.", "unit": "µm" }, { "quantity": "Contact angle of a specified liquid", "typical_range": "0-180 is the conventional angular span, not a typical operating range.", "unit": "degree" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of surface 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": [ "Wear, scratching or erosion changes surface geometry and function.", "Corrosion or chemical attack degrades exposed material.", "Coatings can crack, blister or delaminate.", "Contamination can impair adhesion, sealing, optical performance or hygiene.", "Burrs, sharp edges and unsuitable friction can create cutting, snagging or slipping hazards." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of surface 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": [ "Engineering drawings may use ISO surface-texture conventions or the ASME B46.1 standard issued by the American Society of Mechanical Engineers; parameter definitions and drawing requirements should be checked.", "Surface roughness may be reported in micrometres or microinches, depending on industry and drawing practice." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of surface 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": "Mathematical surface", "difference": "A mathematical surface is an abstract two-dimensional object; this sense concerns a physical boundary or boundary-like material layer." }, { "name": "Interface", "difference": "An interface separates adjoining phases, materials or components and may lie inside an artifact; the specified surface sense concerns its outer boundary or a layer resembling one." }, { "name": "Coating", "difference": "A coating is an applied material layer; a surface can exist without any applied layer." }, { "name": "Surface finish", "difference": "Surface finish describes the condition or texture of a surface rather than the boundary or material layer itself." }, { "name": "Substrate", "difference": "The substrate is the underlying supporting material; its surface is its boundary, which may carry a separate coating." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of surface this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does the registry's other surface entry represent a mathematical sense, a duplicate physical sense or another concept, and is an existing world model authoritative for either?", "Where should this entry place the boundary between cavity-facing outer surfaces, accessible pore walls and buried interfaces?", "What operational criterion determines when a material layer merely resembles an outer boundary sufficiently to belong here?", "Which surface metrology standards and parameter conventions should be adopted for the intended material and application domains?", "Should replacement of a coating preserve the identity of the surface patch while creating a new material-layer identity, and how should that distinction be recorded?" ], "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.", "facetsInferred": false, "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 surface, record what state it is in, and decide what may be done with it.", "whatItIs": "the outer boundary of an artifact or a material layer constituting or resembling such a boundary", "characteristics": { "substance": "material", "origin": "manufactured", "agency": "inert", "mobility": "portable", "scale": "handheld" }, "whatYouCanDoWithIt": [ "picked up and handled" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: afterdeck, apron, auction block, block, bandstand, outdoor stage, stand, boat deck, boxing ring, prize ring, bridge, bridge deck.", "76 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it." ], "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 surface, and on what evidence are they told apart?" ], "whatItIsMadeOf": "matter you can touch", "physicalCharacter": [ "Fits in a hand and is carried without help.", "Moved by a person without machinery.", "Does nothing on its own; everything it does, something else did to it." ], "whatCanBeDoneWithIt": [ "pick it up, hold it, put it somewhere else" ], "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": [ "afterdeck", "apron", "auction block", "block", "bandstand", "outdoor stage", "stand", "boat deck", "boxing ring", "prize ring", "bridge", "bridge deck" ] } ], "standing": "76 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 surface from another, and a surface 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 surface, 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 surface, 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 surface 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 surface, 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 surface, 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 surface 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 surface 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 surface, 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 surface, 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 surface 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 surface from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a surface, 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 surface, 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 surface 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 surface 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 at handheld scale.", "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 surface, 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 surface, 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 surface 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 surface is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a surface, 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 surface, 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 surface 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 surface is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a surface, 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 surface, 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 surface 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 surface is, how it got there and where it may go (portable).", "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 surface is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a surface, 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 surface, 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 surface 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 surface 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 surface, 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 surface, 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 surface 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 surface 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 surface between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a surface, 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 surface, 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 surface 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 surface, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a surface 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 surface, 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 surface, 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 surface 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 surface 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 surface 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 surface, 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 surface 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 surface 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 surface 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 surface 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 surface 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 surface, 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 surface 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 surface and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a surface, 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 surface, 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 surface 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 surface is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a surface, 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 surface, 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 surface 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 } } } }