{ "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T13:42:25Z", "providers": [ "Codex", "Grok" ], "missingProviders": [], "pass": 2, "cost": { "grok": { "usd": 0.00166464, "turns": 1, "seconds": 10.0, "error": null }, "codex": { "seconds": 83.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: 01a07c19-d569-74e3-b818-c7953ef89c6b\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: harmonica\nRegistry id: vr.tr.harmonica\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA Ver" } }, "enrichment": { "pass": 3, "engine": "claude", "producedAt": "2026-10-06T12:00:00Z", "ingestedAt": "2026-10-06T08:09:07+00:00", "fields": [ "agent_conduct", "ethics", "failure_modes_and_hazards", "owners", "visual_identification" ] }, "gate": { "passed": true, "version": "1.0", "at": "2026-10-07T10:10:31+00:00", "evidence": [ "completeness 1.00", "sense: Wikidata description", "2 live sources", "review by codex: pass" ] } }, "metaModel": { "id": "THING-Q51290", "registryId": "vr.tr.harmonica", "name": "harmonica", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.OBJ" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q51290/", "model": { "registry_id": "vr.tr.harmonica", "name": "harmonica", "purpose": "Enable an AI agent to recognise a harmonica, assess its playing condition and suitability, and decide whether it can be played, cleaned, adjusted or repaired.", "definition": "A small free-reed wind instrument played by blowing and drawing air through a row of holes in a mouthpiece, each hole sounding one or two reeds fixed to plates inside a comb; made in diatonic, chromatic, tremolo, octave, bass and chord forms.", "scope_statement": "This model owns an individual harmonica as a mouth-played free-reed instrument, including its air passages, reed arrangement, pitch layout, controls, playing response, condition and instrument-specific care constraints.", "in_scope": [ "Harmonica type, identifying marks and fitted configuration", "Mouthpiece, comb, chambers, reed plates, covers and any slide mechanism", "Hole-to-note mapping across blowing, drawing and available control positions", "Air sealing, reed response, pitch stability and unintended sounds", "Mouth-contact cleanliness, material condition and permitted maintenance" ], "out_of_scope": [ "The player's physiology, health and general musical skill", "Compositions, arrangements and performance events", "Microphones, amplifiers and effects equipment", "Cases, racks and holders as independently managed accessories", "Retail offers, ownership transactions and market valuation" ], "distinguishing_features": [ "Sound is produced by airflow exciting reeds rather than by a vibrating string, lip buzz or an edge-tone whistle.", "The player selects air passages through a mouthpiece or exposed row of holes, rather than selecting notes primarily through a keyboard.", "Its note layout can be described by mouth position and breath direction, with any slide or other control recorded as an additional selector.", "A complete playable assembly combines air chambers and reeds with a mouth-contact interface; a loose reed plate or comb is a component rather than a complete harmonica.", "A slide button alone does not establish that it is a chromatic harmonica; the actual pitch layout and routing must support that classification." ], "characteristics": [ { "name": "Instrument family", "kind": "category", "unit_or_values": "diatonic; slide chromatic; tremolo; octave; bass; chord; other; unresolved", "why_it_matters": "Determines which layout, response and control expectations are appropriate." }, { "name": "Mouthpiece hole arrangement", "kind": "category", "unit_or_values": "Hole count, row count and physical grouping", "why_it_matters": "Establishes how playable positions are identified without assuming one hole equals one note." }, { "name": "Installed pitch layout", "kind": "relation", "unit_or_values": "Mouthpiece position × breath direction × control position → sounding pitch or pitches", "why_it_matters": "Supports recognition of tuning variants, missing notes and suitable musical uses." }, { "name": "Marked key and tuning designation", "kind": "category", "unit_or_values": "Observed inscription or documented designation; absent; unresolved", "why_it_matters": "Provides an identification clue that must be checked against the installed layout." }, { "name": "Pitch deviation", "kind": "measurement", "unit_or_values": "Cents from a stated target under recorded playing conditions", "why_it_matters": "Separates measured tuning behaviour from an unsupported judgement that the instrument is out of tune." }, { "name": "Reed response", "kind": "state", "unit_or_values": "Responsive; delayed; intermittent; silent; rattling; untested, by playable position", "why_it_matters": "Localises faults and establishes whether intended notes can be produced reliably." }, { "name": "Air-path sealing", "kind": "state", "unit_or_values": "No problematic leakage observed; leakage suspected; leakage localised; untested", "why_it_matters": "Helps distinguish air loss from reed or technique problems." }, { "name": "Wetted and mouth-contact materials", "kind": "category", "unit_or_values": "Observed or documented materials and coatings by component; unknown", "why_it_matters": "Constrains cleaning, soaking, drying and mouth-contact suitability." }, { "name": "Service-part compatibility", "kind": "relation", "unit_or_values": "Instrument configuration → verified compatible reed plates, reeds, valves, slides and fasteners", "why_it_matters": "Prevents repairs based only on similar appearance or a shared brand name." } ], "affordances": [ "Select a harmonica for a required pitch layout, range and playing technique.", "Inspect and test individual blow, draw and control-dependent responses.", "Identify positions supporting bends or other pitch alterations when demonstrated.", "Clean and dry accessible parts using a method compatible with the fitted materials.", "Adjust, repair or replace serviceable parts where the procedure and compatibility are established.", "Withhold playing or servicing when mouth-contact condition, loose parts or unresolved damage prevents a supported action." ], "agent_conduct": { "may": [ "Describe a harmonica's type, key and tuning.", "Clean and adjust a harmonica the user owns, on the user's request.", "Teach playing techniques and transcribe tunes the user has the right to use." ], "must_not": [ "Share a harmonica between players without cleaning it, given that it is played with the mouth.", "Give a harmonica with loose small parts to a young child.", "Misrepresent a harmonica's make or materials, such as hidden lead or nickel content.", "Play or test loudly next to people in a way that harms their hearing." ], "requires_human": [ "Lending or reselling a used harmonica to another player." ] }, "ethics": { "considerations": [ "An instrument played with the mouth raises hygiene and health questions when it is shared.", "Cheap instruments for children must be safe as toys as well as instruments." ], "affected_parties": [ "Players, especially children", "People sharing instruments", "Buyers" ] }, "owners": { "steward": "The person who owns and plays it.", "master_systems": [] }, "visual_identification": [ "Small rectangular instrument held across the lips.", "A row of square holes along one edge of the mouthpiece.", "Metal cover plates over a comb of wood, plastic or metal; chromatic models have a side slide button." ], "failure_modes_and_hazards": [ "Spread of infection through shared use.", "Choking risk from small parts for young children.", "Skin reactions to nickel or other metals in plates and covers." ], "what_it_is_for": [ "A harmonica is used for melody, accompaniment and expressive effects in solo and ensemble music.", "It is encountered in music education, informal playing, recording and live performance across several musical traditions.", "Instrument type, key and tuning influence its suitability for a particular piece or playing technique." ], "standards_and_regulation": [ "ISO 16, issued by the International Organization for Standardization, specifies a standard musical tuning frequency that can serve as a reference when tuning or checking a harmonica." ] }, "sources": [ { "id": "wikidata", "title": "Wikidata item Q51290: harmonica", "url": "https://www.wikidata.org/wiki/Q51290", "url_status": "live", "what_it_supports": "identity and sense of the item", "checked_by": "wikidata-api" }, { "id": "wikipedia-en", "title": "Wikipedia: Harmonica", "url": "https://en.wikipedia.org/wiki/Harmonica", "url_status": "live", "what_it_supports": "general description of the item", "checked_by": "wikidata-api sitelink" } ], "structure": { "bundles": [ { "id": "identity-and-configuration", "name": "Identity and configuration", "description": "Establishes what kind of harmonica is present and whether its current assembly matches its apparent identity.", "rationale": "Family labels and cover markings do not establish the tuning or components currently installed.", "layers": [ { "id": "family-recognition", "name": "Family recognition", "description": "Classifies the instrument from its air interface, reed arrangement and controls.", "findings": [ { "id": "supported-harmonica-type", "name": "Supported harmonica type", "description": "Record the observed features supporting a family classification and any conflicting evidence.", "questions": [ { "text": "Which mouthpiece, reed-pairing and control features support the proposed harmonica family?", "kind": "definition", "id": "supported-harmonica-type-q01" }, { "text": "Does this object form a playable harmonica, or is it a component or a neighbouring free-reed instrument?", "kind": "boundary", "id": "supported-harmonica-type-q02" } ] } ] }, { "id": "assembly-identity", "name": "Assembly identity", "description": "Connects identifying marks to the actual fitted comb, reed plates and covers.", "findings": [ { "id": "marked-versus-fitted-configuration", "name": "Marked versus fitted configuration", "description": "Record inscriptions, documented model identity and evidence of replacement or customisation.", "questions": [ { "text": "What maker, model, key or tuning marks are present, and what evidence links them to this assembly?", "kind": "provenance", "id": "marked-versus-fitted-configuration-q01" }, { "text": "Have reed plates, covers, comb or tuning been changed so that external markings no longer describe the instrument?", "kind": "provenance", "id": "marked-versus-fitted-configuration-q02" } ] } ] } ] }, { "id": "note-layout-and-selection", "name": "Note layout and selection", "description": "Describes which pitches the harmonica offers and how the player selects them.", "rationale": "Key and hole count alone cannot determine playable notes, chords or control behaviour.", "layers": [ { "id": "breath-position-map", "name": "Breath and position map", "description": "Maps physical playing positions to their intended blow and draw outputs.", "findings": [ { "id": "installed-note-map", "name": "Installed note map", "description": "Record pitches and octaves by mouthpiece position, including simultaneous reeds and intentional gaps.", "questions": [ { "text": "Which intended pitches and octaves correspond to each position when blowing and drawing?", "kind": "definition", "id": "installed-note-map-q01" }, { "text": "Where does one playing position sound multiple reeds, and are their intended relationships unison, tremolo, octave or chordal?", "kind": "definition", "id": "installed-note-map-q02" } ] } ] }, { "id": "selectors-and-range", "name": "Selectors and range", "description": "Describes how slides or other fitted selectors change available notes.", "findings": [ { "id": "control-dependent-pitches", "name": "Control-dependent pitches", "description": "Record selector states, their pitch-routing effects and the resulting available range.", "questions": [ { "text": "For each fitted selector position, which blow and draw pitches become available?", "kind": "measurement", "id": "control-dependent-pitches-q01" }, { "text": "Which requested notes or chords can this layout supply without relying on an unverified pitch-altering technique?", "kind": "action", "id": "control-dependent-pitches-q02" } ] } ] } ] }, { "id": "playing-response-and-tuning", "name": "Playing response and tuning", "description": "Assesses how the fitted reeds respond and how their sounding pitches relate to intended tuning.", "rationale": "A nominally correct layout can still be difficult to sound, unstable or unsuitable for the intended musical use.", "layers": [ { "id": "reed-speaking-behaviour", "name": "Reed speaking behaviour", "description": "Examines note onset and sustained sound under recorded test conditions.", "findings": [ { "id": "position-specific-response", "name": "Position-specific response", "description": "Record silent, delayed, intermittent or noisy responses by position and breath direction.", "questions": [ { "text": "Which positions speak reliably under the documented test method, and which produce silence, delay, choking or unintended noise?", "kind": "measurement", "id": "position-specific-response-q01" }, { "text": "What repeat test or inspection can distinguish a reed fault from leakage, moisture or the player's technique?", "kind": "action", "id": "position-specific-response-q02" } ] } ] }, { "id": "pitch-and-expression", "name": "Pitch and expression", "description": "Separates intended tuning, measured deviation and deliberate pitch alteration.", "findings": [ { "id": "tuning-and-altered-note-evidence", "name": "Tuning and altered-note evidence", "description": "Record tuning targets and measured behaviour without treating every deviation from equal temperament as a defect.", "questions": [ { "text": "How far do measured pitches deviate from the stated tuning targets, and under what breath and measurement conditions?", "kind": "measurement", "id": "tuning-and-altered-note-evidence-q01" }, { "text": "Which bends, overblows or overdraws have been demonstrated on this instrument, at which positions and by what test?", "kind": "measurement", "id": "tuning-and-altered-note-evidence-q02" }, { "text": "Are observed pitch offsets intentional features of its temperament or paired-reed tuning, or unresolved deviations?", "kind": "boundary", "id": "tuning-and-altered-note-evidence-q03" } ] } ] } ] }, { "id": "air-path-and-mechanical-condition", "name": "Air path and mechanical condition", "description": "Assesses the physical structures that route air and allow reeds and controls to move.", "rationale": "Leakage, obstruction and mechanical interference can produce similar playing symptoms but require different interventions.", "layers": [ { "id": "chambers-and-seals", "name": "Chambers and seals", "description": "Examines comb chambers, mating surfaces and fitted valves for air-routing problems.", "findings": [ { "id": "air-routing-integrity", "name": "Air-routing integrity", "description": "Record cracks, distortion, debris, suspected leakage and valve behaviour where valves are fitted.", "questions": [ { "text": "Where is air escaping or becoming obstructed, and what observation localises the problem?", "kind": "measurement", "id": "air-routing-integrity-q01" }, { "text": "Are comb surfaces, reed-plate joints and any fitted valves intact and functioning under the test conditions?", "kind": "measurement", "id": "air-routing-integrity-q02" } ] } ] }, { "id": "moving-parts-and-clearance", "name": "Moving parts and clearance", "description": "Examines reed clearance, cover interference, fasteners and any slide mechanism.", "findings": [ { "id": "mechanical-interference", "name": "Mechanical interference", "description": "Record loose, obstructed or damaged parts and whether they affect playing or require inspection before use.", "questions": [ { "text": "Do reeds move without observed contact, and do covers or loose fasteners create interference or rattling?", "kind": "measurement", "id": "mechanical-interference-q01" }, { "text": "If a slide is fitted, does it travel and return reliably while selecting the expected air passages?", "kind": "measurement", "id": "mechanical-interference-q02" }, { "text": "Which observed defects require withholding play until loose parts, sharp edges or mechanical damage are addressed?", "kind": "action", "id": "mechanical-interference-q03" } ] } ] } ] }, { "id": "mouth-contact-care-and-service", "name": "Mouth-contact care and service", "description": "Determines appropriate cleaning, drying and repair actions for this harmonica's construction and condition.", "rationale": "Internal moisture exposure and delicate reeds make care decisions dependent on materials, access and fitted components.", "layers": [ { "id": "cleanliness-and-material-limits", "name": "Cleanliness and material limits", "description": "Records mouth-contact condition and the evidence supporting a cleaning method.", "findings": [ { "id": "supported-cleaning-method", "name": "Supported cleaning method", "description": "Connect observed residue, corrosion and moisture to material-compatible cleaning and drying instructions.", "questions": [ { "text": "What residue, retained moisture, corrosion or coating damage is visible at the mouthpiece and accessible internal surfaces?", "kind": "measurement", "id": "supported-cleaning-method-q01" }, { "text": "Which documented cleaning and drying methods apply to the fitted comb, reeds, valves, coatings and adhesives?", "kind": "provenance", "id": "supported-cleaning-method-q02" }, { "text": "What cleaning action is supported by that evidence, and what unresolved material information prevents a method from being selected?", "kind": "action", "id": "supported-cleaning-method-q03" } ] } ] }, { "id": "repair-and-return-to-play", "name": "Repair and return to play", "description": "Defines feasible servicing and the checks required after intervention.", "findings": [ { "id": "verified-service-path", "name": "Verified service path", "description": "Record the supported repair, compatible parts and evidence that the repaired instrument performs as intended.", "questions": [ { "text": "Which adjustment or replacement is supported for the diagnosed fault, and what confirms part and procedure compatibility?", "kind": "action", "id": "verified-service-path-q01" }, { "text": "After servicing, which affected notes, seals, controls and mouth-contact surfaces must be checked before returning the harmonica to play?", "kind": "action", "id": "verified-service-path-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": [ "diatonic harmonica", "chromatic harmonica", "tremolo harmonica", "octave harmonica" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of harmonica this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Should ensemble bass and chord harmonicas, double-sided instruments and unusual selector designs remain variants within this model, and which require additional layers?", "What repeatable playing test can separate instrument faults from player-dependent response without imposing unsupported universal breath-pressure thresholds?", "Which authoritative tuning references cover temperament, pitch reference and intentional paired-reed offsets across the included harmonica families?", "Which manufacturer-supported care procedures apply to different comb materials, coatings, valves and adhesives, especially when the construction is undocumented?", "What evidence is sufficient to recommend reed adjustment or replacement rather than specialist assessment for a particular construction?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 11, "questions": 24 } }