{ "model": { "rank": 6298, "code": "thing-q2413314", "model_id": "vr.tr.jug", "name": "jug", "purpose": "Enable an agent to recognise a jug, assess its suitability and condition for a proposed use, and decide how it may be filled, carried, poured from, cleaned or withdrawn from use.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.OBJ", "industry": "", "version": "", "url": "/models/thing/q2413314/", "tier": 2, "score": 61, "payload": { "layer": "wikidata", "aliases": [ "creamer", "libation jug", "growler", "Trichterhalskrug", "TV pitcher", "Vasylkiv maiolica rooster", "biconical jug", "baluster jug", "barrel shaped jug", "conical jug", "cylindrical jug", "globular jug", "pear shaped jug", "rounded jug", "shouldered jug", "waisted jug", "knight jug", "tripod jug", "spouted pitcher", "bunghole jug", "whiskey jug", "mundi", "musical jug", "epichysis", "olpe", "Toby Jug", "water-dropper", "Susanna jug", "bummolo", "water jug", "face jug", "pinch bottle", "hydria", "Silver claret jug", "Bartmann jug", "Bembel", "bird-beaked jug", "monk’s-cap ewer", "bear jug", "Enghalskrug" ], "aliasCount": 42, "merged": 42, "knownIn": 61, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": "vr.tr.jug", "source": { "dataset": "wikidata", "item": "Q2413314", "url": "https://www.wikidata.org/wiki/Q2413314", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T13:42:52Z", "providers": [ "Codex", "Grok" ], "missingProviders": [], "pass": 2, "cost": { "grok": { "usd": 0.00886176, "turns": 1, "seconds": 153.7, "error": null }, "codex": { "seconds": 67.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: 01a07c17-248d-7743-ad51-566373498b11\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: jug\nRegistry id: vr.tr.jug\nPlane / domain: PHY / PHY.LIV\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA Vercy model say" } } }, "metaModel": { "id": "THING-Q2413314", "registryId": "vr.tr.jug", "name": "jug", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.LIV" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q2413314/", "model": { "registry_id": "vr.tr.jug", "name": "jug", "purpose": "Enable an agent to recognise a jug, assess its suitability and condition for a proposed use, and decide how it may be filled, carried, poured from, cleaned or withdrawn from use.", "definition": "A jug is a portable liquid vessel defined in material-culture, ceramics, and trade practice by a single handle set opposite a pouring lip or spout, used to hold, carry, and dispense liquids rather than to drink from the rim.", "scope_statement": "This model owns the jug as a physical vessel, including its containment and pouring features, material construction, condition, contents relationship and handling constraints; it provisionally includes serving pitchers and storage jugs pending clarification of registry boundaries.", "in_scope": [ "Vessel form and features supporting filling, containment, carrying and controlled pouring", "Capacity, opening dimensions, mass and stability in relevant fill states", "Body, handle, spout, lid and closure construction", "Integrity, cleanliness and suitability for specified contents and temperatures", "Current contents relationship, fill state and operational readiness" ], "out_of_scope": [ "Composition, quality and ownership of the liquid or other contents", "Recipes, beverage preparation and serving workflows", "Heating appliances and active heating systems", "Transport packaging and logistics systems surrounding the jug", "Manufacturing processes and material properties beyond their implications for this jug" ], "distinguishing_features": [ "Assess whether its opening, lip or spout and grip arrangement support transferring contents by tilting; distinguish this use from a vessel primarily intended for direct drinking.", "Compare its neck, closure and carrying arrangement with those of a bottle or carafe; record ambiguous cases rather than treating a handle or narrow neck as decisive.", "Check for a directed pouring edge and controllable grip that distinguish it from a bucket primarily arranged for carrying and broad discharge.", "Check whether it is a passive vessel or incorporates an active heating function that may place it within a kettle or appliance model.", "Treat graduations as evidence of a measuring function, not as sufficient evidence that a vessel is a jug." ], "characteristics": [ { "name": "Vessel subtype", "kind": "category", "unit_or_values": "serving pitcher | storage jug | measuring jug | other | unresolved", "why_it_matters": "Establishes which recognition tests and use constraints need investigation." }, { "name": "Capacity", "kind": "measurement", "unit_or_values": "mL or L, distinguishing nominal, brimful and usable capacity", "why_it_matters": "Determines whether a proposed quantity fits with sufficient headspace for carrying and pouring." }, { "name": "Empty and current mass", "kind": "measurement", "unit_or_values": "g or kg, with empty or filled state identified", "why_it_matters": "Supports lifting and grip decisions for the actual load." }, { "name": "Filling and cleaning access", "kind": "measurement", "unit_or_values": "opening dimensions and minimum internal access clearance in mm", "why_it_matters": "Determines whether filling equipment and cleaning tools can reach the interior." }, { "name": "Pouring outlet", "kind": "category", "unit_or_values": "formed lip | projecting spout | neck opening | other, with outlet dimensions", "why_it_matters": "Affects stream placement, flow control and dripping." }, { "name": "Grip arrangement", "kind": "category", "unit_or_values": "side handle | top handle | body grip | multiple grips | other", "why_it_matters": "Determines feasible lifting and tilting actions." }, { "name": "Contact materials", "kind": "category", "unit_or_values": "identified body, lining, glaze, seal and closure materials, or unknown", "why_it_matters": "Supports evidence-based compatibility and cleaning decisions." }, { "name": "Supported use limits", "kind": "relation", "unit_or_values": "links to markings, instructions or test evidence for contents, temperature and cleaning limits", "why_it_matters": "Prevents appearance or material assumptions from being mistaken for verified suitability." }, { "name": "Closure state", "kind": "state", "unit_or_values": "not fitted | open | seated | secured | damaged | unverified", "why_it_matters": "Affects contamination exposure, filling, venting and spill risk." }, { "name": "Integrity and cleanliness", "kind": "state", "unit_or_values": "location-specific observations of cracks, chips, leaks, looseness, residues and odours", "why_it_matters": "Determines whether the jug is ready for the proposed use or needs intervention." }, { "name": "Contents and fill state", "kind": "relation", "unit_or_values": "linked contents identity, estimated or measured quantity, temperature and observation time", "why_it_matters": "Connects the vessel's present load to compatibility, stability and handling decisions." } ], "affordances": [ "Fill through a suitable opening up to a justified working level.", "Lift and carry using a grip appropriate to the current mass and temperature.", "Tilt to dispense into a receiving vessel with controlled flow.", "Fit, open or remove a compatible lid or closure where provided.", "Empty, clean, inspect and dry accessible contact surfaces.", "Withdraw from a proposed use when damage, contamination or unsupported compatibility prevents a justified decision." ] }, "sources": [ { "id": "wikipedia-jug-container", "title": "Jug (container)", "url": "https://en.wikipedia.org/wiki/Jug_(container)", "what_it_supports": "Core vessel sense, overlap with pitcher, and the main domestic and collectible varieties (including Toby and puzzle jugs).", "url_status": "live" }, { "id": "oed-jug-n1", "title": "jug, n.1", "url": "", "what_it_supports": "Historical English senses of the pouring vessel and the British table-service usage that American English often names a pitcher." }, { "id": "getty-aat-jugs", "title": "jugs (vessels)", "url": "", "what_it_supports": "Museum object-type definition separating jugs from bottles, jars, ewers, and other vessel classes in the Art & Architecture Thesaurus." }, { "id": "fda-21cfr-177-1520", "title": "21 CFR 177.1520 Olefin polymers", "url": "https://www.ecfr.gov/current/title-21/chapter-I/subchapter-B/part-177/subpart-B/section-177.1520", "what_it_supports": "Food-contact polymer rules that govern common HDPE household milk and water jugs in the United States.", "url_status": "live" } ], "structure": { "bundles": [ { "id": "jug-recognition", "name": "Jug recognition", "description": "Evidence that the vessel belongs to the jug entry and identification of its functional variant.", "rationale": "Jug overlaps with pitcher, bottle, carafe, bucket and kettle, so identification must expose boundary evidence.", "layers": [ { "id": "containment-and-pouring-form", "name": "Containment and pouring form", "description": "The physical arrangement that enables holding and transferring contents.", "findings": [ { "id": "jug-form-evidence", "name": "Jug form evidence", "description": "Record the body, opening, pouring edge and grip arrangement without assuming every jug has a separate spout or handle.", "questions": [ { "text": "Which observed features support identifying this vessel as a jug?", "kind": "definition", "id": "jug-form-evidence-q01" }, { "text": "What distinguishes it from a bottle, carafe, cup or bucket in this case?", "kind": "boundary", "id": "jug-form-evidence-q02" } ] } ] }, { "id": "variant-and-designated-use", "name": "Variant and designated use", "description": "The jug's stated role and any functions that introduce neighbouring model boundaries.", "findings": [ { "id": "intended-jug-role", "name": "Intended jug role", "description": "Record evidence for serving, storing or measuring use and identify any integrated heating or treatment function.", "questions": [ { "text": "Which markings, instructions or other evidence identify the jug's intended use?", "kind": "provenance", "id": "intended-jug-role-q01" }, { "text": "Does an integrated function require a related appliance or treatment model?", "kind": "boundary", "id": "intended-jug-role-q02" } ] } ] } ] }, { "id": "capacity-and-access", "name": "Capacity and access", "description": "How much the jug can contain and how its interior can be accessed.", "rationale": "Nominal volume alone does not establish a safe working fill, measurement accuracy or cleaning access.", "layers": [ { "id": "fill-envelope", "name": "Fill envelope", "description": "Capacity and headspace under the intended filling and handling conditions.", "findings": [ { "id": "usable-fill-level", "name": "Usable fill level", "description": "Separate labelled capacity, measured brimful capacity and an appropriate working fill.", "questions": [ { "text": "What are the nominal and measured capacities, and how were they established?", "kind": "measurement", "id": "usable-fill-level-q01" }, { "text": "What fill level leaves sufficient headspace for the proposed carrying and pouring action?", "kind": "action", "id": "usable-fill-level-q02" } ] } ] }, { "id": "openings-and-graduations", "name": "Openings and graduations", "description": "Access for filling and cleaning, and any features used to estimate volume.", "findings": [ { "id": "interior-access-and-reading", "name": "Interior access and reading", "description": "Record opening restrictions, inaccessible recesses and the evidence supporting any volume scale.", "questions": [ { "text": "What opening dimensions and internal restrictions govern filling and cleaning access?", "kind": "measurement", "id": "interior-access-and-reading-q01" }, { "text": "If graduations exist, what evidence establishes their units, reading method and accuracy?", "kind": "provenance", "id": "interior-access-and-reading-q02" } ] } ] } ] }, { "id": "contents-compatibility", "name": "Contents compatibility", "description": "Whether this jug's contact surfaces and construction support the proposed contents and conditions.", "rationale": "A jug's appearance does not establish food-contact suitability, chemical compatibility or temperature limits.", "layers": [ { "id": "contact-surface-construction", "name": "Contact surface construction", "description": "Materials and finishes that contact contents or affect their containment.", "findings": [ { "id": "contact-material-evidence", "name": "Contact material evidence", "description": "Identify the body interior, coatings, seals and closure surfaces and retain uncertainty where identification is unsupported.", "questions": [ { "text": "Which materials and finishes contact the contents, including at the lid and outlet?", "kind": "definition", "id": "contact-material-evidence-q01" }, { "text": "What evidence supports their suitability for the proposed contents?", "kind": "provenance", "id": "contact-material-evidence-q02" } ] } ] }, { "id": "thermal-and-cleaning-limits", "name": "Thermal and cleaning limits", "description": "Supported temperature, temperature-change and cleaning conditions.", "findings": [ { "id": "supported-exposure", "name": "Supported exposure", "description": "Record documented limits relevant to hot filling, chilling and cleaning without inferring them solely from material names.", "questions": [ { "text": "What evidence establishes temperature and temperature-change limits for the complete jug?", "kind": "provenance", "id": "supported-exposure-q01" }, { "text": "Which cleaning methods are supported for its body, handle, coatings and seals?", "kind": "action", "id": "supported-exposure-q02" } ] } ] } ] }, { "id": "carrying-and-dispensing", "name": "Carrying and dispensing", "description": "The jug's behaviour while standing, being lifted and being tilted to pour.", "rationale": "Fill level, grip geometry, base support and outlet behaviour jointly determine whether an agent can handle a jug successfully.", "layers": [ { "id": "grip-and-standing-stability", "name": "Grip and standing stability", "description": "Load support through the handle or body and the base in relevant fill states.", "findings": [ { "id": "supported-handling", "name": "Supported handling", "description": "Record usable grip clearance, attachment condition, current mass and stability on the intended surface.", "questions": [ { "text": "What are the current mass, available grip clearances and base contact dimensions?", "kind": "measurement", "id": "supported-handling-q01" }, { "text": "Can the intended handler lift, carry and set down this filled jug with a secure grip?", "kind": "action", "id": "supported-handling-q02" } ] } ] }, { "id": "pour-path-and-closure", "name": "Pour path and closure", "description": "How contents leave the jug and how lids, closures and air entry affect the stream.", "findings": [ { "id": "controlled-discharge", "name": "Controlled discharge", "description": "Record stream placement, dripping, intermittent flow and lid retention for relevant fill levels.", "questions": [ { "text": "How does the stream behave at the intended fill level and pouring angle?", "kind": "measurement", "id": "controlled-discharge-q01" }, { "text": "What opening, venting or lid-securing action is needed before pouring?", "kind": "action", "id": "controlled-discharge-q02" } ] } ] } ] }, { "id": "condition-and-readiness", "name": "Condition and readiness", "description": "Whether the jug's present integrity, cleanliness and contents history permit the next use.", "rationale": "Cracked bodies, loose handles, damaged pouring edges and retained residues can defeat an otherwise suitable jug.", "layers": [ { "id": "containment-and-component-integrity", "name": "Containment and component integrity", "description": "Damage affecting liquid retention, load support and the pouring interface.", "findings": [ { "id": "jug-defect-assessment", "name": "Jug defect assessment", "description": "Locate cracks, chips, leaks, deformation and loose attachments, and relate them to the proposed use.", "questions": [ { "text": "What defects are observed at the body, base, handle attachments, pouring edge and closure?", "kind": "measurement", "id": "jug-defect-assessment-q01" }, { "text": "Do these observations require further inspection, restricted use or withdrawal?", "kind": "action", "id": "jug-defect-assessment-q02" } ] } ] }, { "id": "residue-and-current-load", "name": "Residue and current load", "description": "Present contents, prior-use evidence and cleanliness of the interior and outlet.", "findings": [ { "id": "next-fill-readiness", "name": "Next-fill readiness", "description": "Record remaining contents, residues, odours and cleaning history without equating visible cleanliness with verified suitability.", "questions": [ { "text": "What is known about current or previous contents and the most recent cleaning?", "kind": "provenance", "id": "next-fill-readiness-q01" }, { "text": "What emptying, cleaning, drying or verification is needed before the intended next fill?", "kind": "action", "id": "next-fill-readiness-q02" } ] } ] } ] }, { "id": "evidence-and-external-alignment", "name": "Evidence and external alignment", "description": "What the world already says about this thing, gathered so the model can be checked against it.", "rationale": "A model that cannot be lined up against existing standards, identifiers and practice cannot be adopted by anyone who already uses them.", "layers": [ { "id": "reported-evidence", "name": "Reported evidence", "description": "Findings from the breadth pass, kept separate from the structural claims.", "findings": [ { "id": "evidence-kinds", "name": "Kinds and varieties", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "table serving jug (open-mouthed ceramic, glass, or metal pitcher-form)", "cream or milk jug of a tea or coffee service (typically 100-300 ml)", "graduated kitchen measuring jug", "plastic storage jug (household milk, water, or detergent, often with a screw cap)", "pub or beer jug for serving ale", "character or Toby jug (figural collectible)", "stoneware spirit or moonshine jug with a narrow neck and stopper", "washstand or hot-water jug (bedroom/domestic washing set)" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of jug this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "scheme": "Wikidata", "value_or_pattern": "Q2417", "note": "Item for the container class 'jug', sitelinked from Wikipedia 'Jug (container)'; not the slang or anatomical senses." }, { "scheme": "Getty Art & Architecture Thesaurus", "value_or_pattern": "jugs (vessels)", "note": "Preferred AAT object type for the handled pouring vessel; confirm the numeric AAT ID against the live vocabulary." }, { "scheme": "Harmonized System", "value_or_pattern": "3923.30", "note": "Plastic carboys, bottles, flasks and similar articles, the heading under which many commercial plastic jugs are entered." }, { "scheme": "Harmonized System", "value_or_pattern": "6912", "note": "Ceramic tableware and kitchenware heading that includes ceramic serving jugs." } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of jug this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Regulation (EC) No 1935/2004 on materials and articles intended to come into contact with food - European Parliament and Council (food-contact ceramic, glass, and plastic jugs in the EU).", "Council Directive 84/500/EEC on ceramic articles intended to come into contact with foodstuffs - Council of the European Communities (lead and cadmium release limits for ceramic jugs).", "ISO 6486-1, Ceramic ware, glass-ceramic ware and glass dinnerware in contact with food - Release of lead and cadmium - International Organization for Standardization.", "21 CFR 177.1520 Olefin polymers - U.S. Food and Drug Administration (HDPE and related resins used for milk and water jugs).", "Weights and Measures Act 1985 and associated measuring-container rules - United Kingdom (capacity marking and use of graduated measuring jugs in trade)." ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of jug this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Poured at table for water, milk, juice, gravy, or beer.", "Held and dispensed in kitchens as a measuring vessel for cooking and baking.", "Sold as a one-gallon (or similar) retail package for milk, juice, water, or household chemicals.", "Collected as Toby and character jugs; displayed rather than used.", "Used historically as a bedroom washstand pair with a basin, and as a stoneware container for spirits.", "Blown as a bass instrument in jug bands, using the vessel's cavity rather than its pouring function." ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of jug this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "quantity": "nominal capacity", "typical_range": "0.1-5 for domestic table and kitchen forms; about 3.785 for a US gallon milk jug", "unit": "L" }, { "quantity": "empty mass", "typical_range": "0.05-0.15 for thin HDPE household jugs; 0.3-2 for ceramic or stoneware", "unit": "kg" }, { "quantity": "overall height", "typical_range": "80-400 for typical domestic jugs", "unit": "mm" }, { "quantity": "graduation tolerance (measuring jugs)", "typical_range": "about 1-5 of reading, depending on class and mark", "unit": "%" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of jug this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Handle snap or joint failure, especially at a ceramic handle join or a moulded plastic weld.", "Chip or crack at the pouring lip, ruining a clean pour.", "Thermal shock fracture when boiling liquid is poured into a cold ceramic or glass jug.", "Freeze-burst of a filled, tightly capped jug.", "Chemical migration from food-contact plastics, and lead or cadmium leaching from older or poorly formulated ceramic glazes.", "Bacterial biofilm in reusable water jugs that are not cleaned.", "Poisoning or contamination when a chemical jug is reused for drink.", "UV embrittlement and stress cracking of outdoor HDPE jugs." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of jug this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "In British, Irish, and much Commonwealth usage, 'jug' is the ordinary table-service name for what American English usually calls a pitcher.", "In American English, 'jug' more often names a large, often narrow-necked bottle with a small handle (milk jug, moonshine jug) rather than an open table pitcher.", "Toby and character jugs are a specifically English (especially Staffordshire) collecting tradition.", "Mediterranean and Near Eastern practice more often names a related spouted washing or serving form an ewer rather than a jug." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of jug this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "name": "pitcher", "difference": "Same or closely allied table-service form; separated mainly by dialect (US 'pitcher' vs UK 'jug'), though US retail 'pitcher' is typically wide-mouthed and US 'jug' often narrow-necked with a cap." }, { "name": "ewer", "difference": "Has a distinct tubular spout and is primarily a washing or ceremonial pouring vessel, not a pulled-lip table or storage jug." }, { "name": "bottle", "difference": "Narrow-necked, usually without a pouring handle or lip; liquid leaves through the neck rather than a formed pouring edge." }, { "name": "carafe", "difference": "Handleless table vessel for wine or water; the absence of a handle is the usual working test." }, { "name": "jar", "difference": "Wide-mouthed storage vessel whose orifice is for filling and scooping, not for directed pouring." }, { "name": "flagon", "difference": "Typically larger and often lidded, used for ale, cider, or ecclesiastical wine rather than open table pouring." }, { "name": "mug", "difference": "A drinking vessel whose rim is for the mouth; a jug is designed to pour, not to be drunk from." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of jug this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does the registry intend jug to include both serving pitchers and narrow-neck storage jugs, and where are its boundaries with bottle and carafe?", "Should measuring, filtering, insulated or electrically heated jugs use this model with linked functional models, or belong to separate registered entries?", "Which authoritative evidence and assessment methods should establish contents compatibility and thermal limits for each construction type?", "Which repeatable methods should establish usable capacity, standing stability and pouring performance across relevant fill states?", "What defect and cleaning criteria should determine readiness for different intended uses, especially when previous contents are unknown?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 18, "questions": 28 } }, "draft": { "generator": "vr.draft.v3", "status": "draft-generated", "researched": false, "archetype": "device, machine or tool", "method": "Written from the archetype playbook - what this kind of thing needs beyond identity and provenance - and from the structure that recurred across 6,333 models already researched by two engines. Applied to this entry by rule. No source was read for this thing and no claim here is researched. This entry carries no facets of its own, so they were inferred from its domain - a guess about a whole domain applied to one thing.", "facetsInferred": true, "nextPass": "A researcher replaces this draft with a sourced specification. Treat every sentence below as a proposal to argue with.", "purpose": "Give an agent a durable, checkable way to recognise a jug, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an agent to recognise a jug, assess its suitability and condition for a proposed use, and decide how it may be filled, carried, poured from, cleaned or withdrawn from use.", "characteristics": { "substance": "material", "origin": "manufactured", "agency": "inert", "mobility": "varies" }, "whatYouCanDoWithIt": [ "observed and measured" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: creamer, libation jug, growler, Trichterhalskrug, TV pitcher, Vasylkiv maiolica rooster, biconical jug, baluster jug, barrel shaped jug, conical jug, cylindrical jug, globular jug.", "42 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 61 Wikipedia languages, which is a measure of how widely the thing is known, not of how important it is." ], "openQuestionsForResearch": [ "Which of the bundles below does a real task actually need, and which are ceremony?", "What does this thing have that the facets do not capture at all?", "Which neighbouring kind is most often confused with a jug, and on what evidence are they told apart?" ], "whatItIsMadeOf": "matter you can touch", "physicalCharacter": [ "Mobility varies between examples.", "Does nothing on its own; everything it does, something else did to it.", "These come from the domain this entry sits in rather than from the entry itself, so treat them as a first guess about the whole domain applied to one thing." ], "whatCanBeDoneWithIt": [ "observe it, measure it, record its state" ], "howItIsRecognised": [ "Recognised by form, by the arrangement of its controls, and by markings - a plate, a model number, a certification mark. Form alone rarely separates two models that do very different things." ], "relatedModels": [ { "relation": "covers", "note": "Finer kinds folded into this entry because telling them apart needs a task that asks for it. Each is a model waiting to be split out when one does.", "targets": [ "creamer", "libation jug", "growler", "Trichterhalskrug", "TV pitcher", "Vasylkiv maiolica rooster", "biconical jug", "baluster jug", "barrel shaped jug", "conical jug", "cylindrical jug", "globular jug" ] } ], "standing": "Described in 61 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 42 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 jug from another, and a jug 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 jug, 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 jug, 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 jug 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 jug, 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 jug, 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 jug 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 jug 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 jug, 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 jug, 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 jug 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 jug from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a jug, 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 jug, 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 jug 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 jug is made of, what shape and size it takes, and what state it is in.", "rationale": "A physical thing can be measured, and a model that cannot record its measurements cannot support any decision that depends on them.", "layers": [ { "id": "form-and-dimensions", "name": "Form and dimensions", "description": "Shape, size, mass and the ranges these take across examples.", "findings": [ { "id": "measurable-dimensions", "name": "Measurable dimensions and their units", "description": "The quantities worth recording and the units they are recorded in.", "questions": [ { "id": "measurable-dimensions-q01", "text": "What identifies and describes the dimensions of a jug, 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 jug, 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 jug 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 jug is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a jug, 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 jug, 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 jug 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 jug is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a jug, 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 jug, 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 jug 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 jug is, how it got there and where it may go (varies).", "rationale": "A thing that can move needs its position recorded with a time, or every later claim about it is about a place it has left.", "layers": [ { "id": "location-and-placement", "name": "Location and placement", "description": "Position, containment and the reference frame the position is given in.", "findings": [ { "id": "position-and-frame", "name": "Position, container and reference frame", "description": "Where a jug is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a jug, 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 jug, 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 jug 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 jug 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 jug, 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 jug, 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 jug 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 jug 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 jug between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a jug, 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 jug, 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 jug 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 jug, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a jug 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 jug, 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 jug, 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 jug 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 jug 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 jug 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 jug, 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 jug 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 jug 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 jug 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 jug 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 jug 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 jug, 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 jug 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 jug and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a jug, 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 jug, 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 jug 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 jug is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a jug, 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 jug, 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 jug 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 } } } }