{ "model": { "rank": 2771, "code": "thing-q60168", "model_id": "vr.tr.heroin", "name": "heroin", "purpose": "Enable an AI agent to identify heroin as a substance, assess the evidence about a particular sample, and determine which handling, testing or disposition actions require authorization.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.OBJ", "industry": "", "version": "", "url": "/models/thing/q60168/", "tier": 2, "score": 97, "payload": { "layer": "wikidata", "aliases": [], "aliasCount": 0, "merged": 0, "knownIn": 97, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": "vr.tr.heroin", "source": { "dataset": "wikidata", "item": "Q60168", "url": "https://www.wikidata.org/wiki/Q60168", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T11:39:17Z", "providers": [ "Codex" ], "breadth": "recalled by Codex without web access - no source was read", "missingProviders": [], "pass": 2, "cost": { "grok": { "seconds": 31.5, "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: 01a07ba9-295a-7ef2-9c20-2bbc81a32c22\n--------\nuser\nDescribe what is already known about one registered thing. Answer as JSON only, no prose around it.\n\nThing: heroin\nSense to describe: (none recorded)\nDomain code: PHY.OBJ\nAlso known as: (none)\n\n\nContext for this batch of 711 things:\n# Batch 003: 1001 registere", "usd": 0, "recall": true }, "codex": { "seconds": 80, "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: 01a07ba9-2948-7092-b938-54289c9605c8\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: heroin\nRegistry id: vr.tr.heroin\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\n\nContext fo" } } }, "metaModel": { "id": "THING-Q60168", "registryId": "vr.tr.heroin", "name": "heroin", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.OBJ" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q60168/", "model": { "registry_id": "vr.tr.heroin", "name": "heroin", "purpose": "Enable an AI agent to identify heroin as a substance, assess the evidence about a particular sample, and determine which handling, testing or disposition actions require authorization.", "definition": "Heroin, also called diamorphine or diacetylmorphine, is a semisynthetic opioid formed by acetylating morphine's two hydroxyl groups, whose effects arise substantially through conversion to active metabolites including 6-monoacetylmorphine and morphine.", "scope_statement": "This model owns heroin in the chemical-substance sense of diamorphine, also called diacetylmorphine, and the identification, composition, condition and control attributes of materials represented as containing it; it distinguishes the substance from a pharmaceutical product, illicit-market label or individual exposure.", "in_scope": [ "Chemical identity of heroin and its distinction from related opioids", "Free-base and salt forms, with explicit reporting conventions", "Composition and analytical identification of heroin-containing materials", "Physical condition, packaging and evidence of contamination or degradation", "Sample-specific hazards and jurisdiction-dependent handling constraints" ], "out_of_scope": [ "Synthesis, illicit manufacture or methods for increasing potency", "Dosing, administration techniques and treatment protocols", "Opioid use disorder and individual patient or exposure records", "Complete pharmaceutical product specifications and prescribing workflows", "Trafficking networks, criminal investigations and drug-market economics" ], "distinguishing_features": [ "Chemical identification must establish diacetylmorphine rather than infer heroin from a generic opioid-positive result.", "Analytical evidence must distinguish heroin from morphine, monoacetylmorphine and other related compounds; detecting a related compound alone does not establish that heroin is present.", "A material marketed as heroin is distinguished from confirmed heroin by its analytical evidence, not its name, appearance or seller's claim.", "Free-base, salt and hydrated forms must be identified before comparing reported concentrations or substance masses.", "A regulated diamorphine medicine and an unverified material sold as heroin may refer to the same active substance while differing in formulation, traceability and quality evidence." ], "characteristics": [ { "name": "Identity evidence", "kind": "state", "unit_or_values": "claimed | presumptively indicated | analytically confirmed | inconclusive | not detected within stated method limits", "why_it_matters": "Prevents an allegation, screening result or negative result from being treated as definitive chemical identification." }, { "name": "Chemical form", "kind": "category", "unit_or_values": "free base | identified salt with hydration state | unresolved", "why_it_matters": "Chemical form affects how identity and quantitative results should be interpreted." }, { "name": "Heroin content", "kind": "measurement", "unit_or_values": "% mass fraction, mg/g or mg/mL, with analyte basis, uncertainty and method", "why_it_matters": "Separates measured heroin content from total material mass and makes comparisons interpretable." }, { "name": "Co-occurring substances", "kind": "relation", "unit_or_values": "identified substances linked to results, detection limits and tested analytical scope", "why_it_matters": "Records other opioids, adulterants, excipients and impurities without treating untested substances as absent." }, { "name": "Physical presentation", "kind": "category", "unit_or_values": "powder | solid mass | solution | other documented presentation", "why_it_matters": "Supports sampling and containment decisions without using appearance as proof of identity." }, { "name": "Material condition", "kind": "state", "unit_or_values": "documented observations of moisture, seal integrity, visible contamination and analytical change; unknown where unassessed", "why_it_matters": "Separates observed condition from unsupported claims of stability, sterility or fitness for use." }, { "name": "Sample representativeness", "kind": "state", "unit_or_values": "supported by sampling evidence | limited to tested portion | unknown", "why_it_matters": "Prevents one analytical result from being generalized to heterogeneous material." }, { "name": "Traceability", "kind": "relation", "unit_or_values": "links to source records, product or lot identifiers, sample identifiers and custody events", "why_it_matters": "Connects identity and composition claims to the material actually assessed." }, { "name": "Applicable control status", "kind": "relation", "unit_or_values": "jurisdiction, effective date, legal classification and activity-specific authorization", "why_it_matters": "Handling permissions depend on location, time, actor and proposed activity." } ], "affordances": [ "Compare declared identity with analytical evidence and flag unresolved discrepancies.", "Request qualified testing that distinguishes heroin from related compounds and assesses relevant co-occurring substances.", "Determine whether composition results apply only to a tested portion or support a broader material claim.", "Flag material for restricted handling when identity, composition, containment or authorization is unresolved.", "Route storage, transfer, testing and disposal decisions to authorized personnel using applicable documented requirements." ] }, "sources": [], "structure": { "bundles": [ { "id": "heroin-identity", "name": "Heroin identity", "description": "Establishes which chemical substance and form the entry represents.", "rationale": "Heroin, diamorphine, related metabolites and materials sold under the heroin label must not be conflated.", "layers": [ { "id": "chemical-boundary", "name": "Chemical boundary", "description": "Defines the chemical referent independently of market terminology.", "findings": [ { "id": "diacetylmorphine-referent", "name": "Diacetylmorphine referent", "description": "The identity record should resolve the heroin name to diacetylmorphine and explicitly distinguish related compounds.", "questions": [ { "text": "Which authoritative chemical record establishes the identifiers and synonym relationship for heroin, diamorphine and diacetylmorphine?", "kind": "definition", "id": "diacetylmorphine-referent-q01" }, { "text": "What evidence distinguishes the identified substance from morphine, monoacetylmorphine or another opioid?", "kind": "boundary", "id": "diacetylmorphine-referent-q02" } ] } ] }, { "id": "chemical-form-and-label", "name": "Chemical form and label", "description": "Separates chemical form from product and market descriptions.", "findings": [ { "id": "form-specific-identity", "name": "Form-specific identity", "description": "A salt designation, pharmaceutical label or illicit-market name carries different identity claims that require separate evidence.", "questions": [ { "text": "Is the material identified as heroin free base, a specified salt or an unresolved form?", "kind": "definition", "id": "form-specific-identity-q01" }, { "text": "Does the name describe an analytically identified substance, a documented medicine or merely a claim about the material?", "kind": "provenance", "id": "form-specific-identity-q02" } ] } ] } ] }, { "id": "composition-and-detection", "name": "Composition and detection", "description": "Captures what testing establishes about heroin content and other constituents.", "rationale": "The heroin label alone cannot establish content, homogeneity or the absence of additional substances.", "layers": [ { "id": "analytical-identification", "name": "Analytical identification", "description": "Records the specificity and limits of evidence used to identify heroin.", "findings": [ { "id": "method-bounded-confirmation", "name": "Method-bounded confirmation", "description": "Identification conclusions should retain the method, reference evidence and limitations that support them.", "questions": [ { "text": "Which analytical method and reference material support identifying heroin in this sample?", "kind": "provenance", "id": "method-bounded-confirmation-q01" }, { "text": "Can the method distinguish heroin from relevant related compounds, and what detection limits or interferences apply?", "kind": "measurement", "id": "method-bounded-confirmation-q02" } ] } ] }, { "id": "content-and-mixtures", "name": "Content and mixtures", "description": "Makes heroin quantity and accompanying substances interpretable.", "findings": [ { "id": "composition-with-explicit-basis", "name": "Composition with explicit basis", "description": "Quantitative results should specify their chemical basis and distinguish detected constituents from substances outside the test scope.", "questions": [ { "text": "What heroin content was measured, with which units, uncertainty and free-base or salt reporting basis?", "kind": "measurement", "id": "composition-with-explicit-basis-q01" }, { "text": "Which additional opioids, adulterants, excipients or impurities were tested for, detected or left unassessed?", "kind": "measurement", "id": "composition-with-explicit-basis-q02" } ] } ] } ] }, { "id": "material-condition-and-sampling", "name": "Material condition and sampling", "description": "Connects the assessed material's condition to the reach of analytical conclusions.", "rationale": "Changes in the material and differences between portions can invalidate assumptions about heroin content.", "layers": [ { "id": "condition-and-change", "name": "Condition and change", "description": "Tracks observations and evidence of chemical or physical change.", "findings": [ { "id": "condition-evidence", "name": "Condition evidence", "description": "Storage history and observations should be recorded separately from analytically established degradation or contamination.", "questions": [ { "text": "What packaging, storage history, moisture exposure and visible condition are documented for this material?", "kind": "provenance", "id": "condition-evidence-q01" }, { "text": "What analytical evidence supports degradation or contamination, and can it distinguish change over time from the original composition?", "kind": "measurement", "id": "condition-evidence-q02" } ] } ] }, { "id": "sampling-reach", "name": "Sampling reach", "description": "Defines which portion, package or lot an analytical result can describe.", "findings": [ { "id": "representative-heroin-content", "name": "Representative heroin content", "description": "A tested portion should not automatically establish the composition of every portion in a heroin-containing mixture.", "questions": [ { "text": "Which portion or package was sampled, and what sampling record connects it to the material under assessment?", "kind": "provenance", "id": "representative-heroin-content-q01" }, { "text": "What evidence supports extending its heroin and co-occurring-substance results to the remaining material?", "kind": "boundary", "id": "representative-heroin-content-q02" } ] } ] } ] }, { "id": "hazards-and-action-boundaries", "name": "Hazards and action boundaries", "description": "Organizes evidence needed for safe decisions about heroin-containing material.", "rationale": "Chemical identity, uncertain composition and material presentation require distinct assessments before handling decisions.", "layers": [ { "id": "hazard-evidence", "name": "Hazard evidence", "description": "Links hazard assessments to heroin, its form and confirmed or unresolved mixture constituents.", "findings": [ { "id": "substance-and-mixture-hazards", "name": "Substance and mixture hazards", "description": "Hazard records should cite applicable evidence and retain uncertainty about uncharacterized constituents.", "questions": [ { "text": "Which authoritative hazard references apply to the identified heroin form and detected co-occurring substances?", "kind": "provenance", "id": "substance-and-mixture-hazards-q01" }, { "text": "Which composition uncertainties prevent a sufficiently supported assessment of the proposed handling activity?", "kind": "boundary", "id": "substance-and-mixture-hazards-q02" } ] } ] }, { "id": "qualified-handling-decisions", "name": "Qualified handling decisions", "description": "Connects proposed activities to qualified procedures and escalation routes.", "findings": [ { "id": "handling-and-escalation", "name": "Handling and escalation", "description": "The model should support referral to applicable procedures without supplying dosing or administration instructions.", "questions": [ { "text": "Which approved procedure governs containment, laboratory examination or disposal of this heroin-containing material?", "kind": "action", "id": "handling-and-escalation-q01" }, { "text": "What evidence of compromised containment or suspected exposure requires stopping the activity and invoking the relevant emergency procedure?", "kind": "action", "id": "handling-and-escalation-q02" } ] } ] } ] }, { "id": "provenance-and-control", "name": "Provenance and control", "description": "Separates material traceability, regulated-product claims and legal permissions.", "rationale": "Heroin's chemical identity does not establish pharmaceutical quality or permission to possess, transfer or use it.", "layers": [ { "id": "origin-and-product-status", "name": "Origin and product status", "description": "Evaluates the evidence behind origin and pharmaceutical-product claims.", "findings": [ { "id": "traceable-diamorphine-material", "name": "Traceable diamorphine material", "description": "Product and custody records should establish which claims attach to the material and which remain unverified.", "questions": [ { "text": "Which supplier, manufacturer, lot and custody records connect the material to its claimed origin?", "kind": "provenance", "id": "traceable-diamorphine-material-q01" }, { "text": "If pharmaceutical status is claimed, which product authorization and quality records support that claim for this specific material?", "kind": "provenance", "id": "traceable-diamorphine-material-q02" } ] } ] }, { "id": "jurisdiction-and-permissions", "name": "Jurisdiction and permissions", "description": "Determines the current rules for the specific material and proposed activity.", "findings": [ { "id": "activity-specific-control", "name": "Activity-specific control", "description": "Legal classification and authorization should be tied to a jurisdiction, effective date, actor and activity.", "questions": [ { "text": "Which current legal source classifies heroin or diamorphine in the relevant jurisdiction, including applicable preparations or exceptions?", "kind": "provenance", "id": "activity-specific-control-q01" }, { "text": "What authorization and records are required for the proposed possession, testing, transfer or disposal?", "kind": "action", "id": "activity-specific-control-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 chemical substance and explicitly labelled preparations or illicit mixtures; it does not equate street products with pure diacetylmorphine.", "Regulatory classifications and permitted medical uses are recalled without source consultation and should be checked against current jurisdiction-specific rules.", "No typical illicit purity or dose range is supplied because composition, exposure and tolerance vary substantially." ], "questions": [ { "id": "evidence-confidence-notes-q01", "text": "Which of these check these first hold for the sense of heroin 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": [ "Heroin free base", "Diamorphine hydrochloride", "Pharmaceutical diamorphine preparations", "Illicit powder heroin, with variable composition", "Black tar heroin, an illicit mixture containing diacetylmorphine and related compounds" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of heroin this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "scheme": "CAS Registry Number", "value_or_pattern": "561-27-3", "note": "Identifies diacetylmorphine free base; salts and hydrates can have separate identifiers." }, { "scheme": "Molecular formula", "value_or_pattern": "C21H23NO5", "note": "Formula of the free base; this is a composition descriptor rather than a unique substance identifier." }, { "scheme": "International Nonproprietary Name", "value_or_pattern": "diamorphine", "note": "Medicinal name for the substance commonly called heroin." } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of heroin 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": [ "United Nations Single Convention on Narcotic Drugs, 1961: heroin is listed in Schedules I and IV.", "United States Controlled Substances Act, administered by the Drug Enforcement Administration: heroin is a Schedule I controlled substance.", "United Kingdom Misuse of Drugs Act 1971: diamorphine is a Class A controlled drug; the Misuse of Drugs Regulations 2001 place it in Schedule 2, permitting regulated medical use." ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of heroin 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": [ "Prescription analgesia in some jurisdictions, including treatment of severe pain and palliative care.", "Supervised diamorphine treatment for selected people with opioid dependence in some jurisdictions.", "Nonmedical consumption for opioid effects, including euphoria.", "Analytical reference material in forensic and toxicological laboratories." ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of heroin 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": "Molar mass of diacetylmorphine free base", "typical_range": "369.41", "unit": "g/mol" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of heroin 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": [ "Respiratory depression can cause fatal overdose, particularly with other respiratory depressants such as alcohol or benzodiazepines.", "Repeated exposure can produce tolerance, physical dependence and opioid use disorder; reduced tolerance after abstinence increases overdose risk.", "Uncertain potency and adulteration, including contamination with potent synthetic opioids, make illicit products unpredictable.", "Injection can cause tissue injury and bacterial infections; shared equipment can transmit blood-borne infections.", "Sedation, impaired consciousness, nausea and constipation are characteristic opioid adverse effects." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of heroin 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": [ "Diamorphine has regulated medical uses in some countries, whereas the United States does not recognize an accepted medical use for heroin under its federal scheduling system.", "Illicit products differ geographically in salt form, appearance, purity and adulterants; appearance does not reliably establish composition.", "Access to supervised diamorphine treatment varies substantially between jurisdictions." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of heroin 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": "Morphine", "difference": "Morphine has two unacetylated hydroxyl groups; heroin is its diacetyl derivative." }, { "name": "6-Monoacetylmorphine", "difference": "This active heroin metabolite retains one acetyl group rather than heroin's two." }, { "name": "Opium", "difference": "Opium is a poppy-derived mixture containing naturally occurring alkaloids; heroin is a chemically modified derivative of morphine." }, { "name": "Fentanyl", "difference": "Fentanyl is a structurally distinct synthetic opioid, not a morphine derivative or a variety of heroin." }, { "name": "Opioid use disorder", "difference": "This is a clinical condition involving problematic opioid use, not the chemical substance." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of heroin this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does an existing Vercy substance or world model already own diamorphine, requiring this registry entry to link to it?", "Which authoritative chemical references and analytical standards should govern identification of heroin, its salts and related compounds?", "Which sampling and testing evidence is sufficient to characterize heterogeneous materials represented as heroin?", "Which form-specific stability and contamination references support condition assessments without importing pharmaceutical assumptions into unverified mixtures?", "Which jurisdictions and authorized activities must the initial model support, and how will their legal sources be kept current?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 19, "questions": 29 } }, "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 heroin, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an AI agent to identify heroin as a substance, assess the evidence about a particular sample, and determine which handling, testing or disposition actions require authorization.", "characteristics": { "substance": "material", "origin": "manufactured", "agency": "inert", "mobility": "varies" }, "whatYouCanDoWithIt": [ "observed and measured" ], "distinguishingFeatures": [ "Described in 97 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 heroin, 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": [], "standing": "Described in 97 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is.", "structure": { "bundles": [ { "id": "identity-and-classification", "name": "Identity, naming and classification", "description": "How an agent tells one heroin from another, and a heroin 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 heroin, 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 heroin, 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 heroin 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 heroin, 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 heroin, 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 heroin 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 heroin 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 heroin, 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 heroin, 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 heroin 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 heroin from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a heroin, 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 heroin, 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 heroin 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 heroin 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 heroin, 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 heroin, 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 heroin 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 heroin is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a heroin, 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 heroin, 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 heroin 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 heroin is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a heroin, 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 heroin, 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 heroin 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 heroin 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 heroin is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a heroin, 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 heroin, 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 heroin 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 heroin 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 heroin, 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 heroin, 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 heroin 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 heroin 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 heroin between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a heroin, 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 heroin, 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 heroin 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 heroin, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a heroin 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 heroin, 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 heroin, 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 heroin 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 heroin 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 heroin 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 heroin, 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 heroin 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 heroin 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 heroin 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 heroin 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 heroin 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 heroin, 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 heroin 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 heroin and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a heroin, 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 heroin, 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 heroin 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 heroin is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a heroin, 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 heroin, 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 heroin 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 } } } }