{ "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-12T09:44:31Z", "providers": [ "Codex" ], "breadth": "recalled by Codex without web access - no source was read", "missingProviders": [], "pass": 2, "cost": { "grok": { "seconds": 30.5, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.4\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a094ff-f3fb-7883-8314-a89dafb622c2\n--------\nuser\nDescribe what is already known about one registered thing. Answer as JSON only, no prose around it.\n\nThing: flatfish\nSense to describe: any of several families of fishes having flattened bodies that swim along the sea floor on one side of the body with both ey", "usd": 0.0, "recall": true }, "codex": { "seconds": 74.2, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.4\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a094ff-f403-7952-a6ed-943f099fc46c\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: flatfish\nRegistry id: vr.tr.flatfish\nPlane / domain: PHY / PHY.LIV\nRegistry definition: any of several families of fishes having flattened bodies tha" } }, "enrichment": { "pass": 3, "engine": "claude", "producedAt": "2026-10-06T12:00:00Z", "ingestedAt": "2026-10-06T08:00:20+00:00", "fields": [ "agent_conduct", "ethics", "failure_modes_and_hazards", "owners", "visual_identification" ] }, "gate": { "passed": true, "version": "1.0", "at": "2026-10-07T12:16:27+00:00", "evidence": [ "completeness 1.00", "sense: WordNet gloss", "2 live sources", "review by codex: pass" ] } }, "metaModel": { "id": "THING-FLATFISH", "registryId": "vr.tr.flatfish", "name": "flatfish", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.LIV" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/flatfish/", "model": { "registry_id": "vr.tr.flatfish", "name": "flatfish", "purpose": "Enable an agent to recognise flatfish, assess an individual or population in its life-stage and habitat context, and determine appropriate observation, handling or management actions.", "definition": "Flatfish are ray-finned fishes traditionally grouped in the order Pleuronectiformes whose development typically produces a laterally compressed, asymmetrical body with both eyes on one side, allowing them to rest and swim with the opposite side facing the seabed.", "scope_statement": "This model owns flatfish as the registered biological grouping and the flatfish-specific evidence needed to distinguish its constituent taxa, populations and individuals, without treating the grouping as a single species.", "in_scope": [ "Identification within the flatfish grouping, with taxonomic authority and evidence", "Body asymmetry, eye placement, pigmentation and developmental stage", "Individual condition, growth, reproduction and handling needs", "Population-specific habitat use, distribution and environmental exposure", "Species- and population-specific conservation and permitted interventions" ], "out_of_scope": [ "Other bottom-associated fishes identified only by a flattened silhouette", "Flatfish meat, fillets and seafood products", "Fishing vessels, fishing gear and seafood supply chains", "Aquaculture facilities and their general operating systems", "Marine habitats and ecosystems beyond their relationship to flatfish" ], "distinguishing_features": [ "For a post-metamorphic candidate, establish that both eyes occupy the same anatomical side rather than merely appearing close together in a photograph.", "Determine whether the fish rests on one anatomical side; distinguish this from a dorsoventrally flattened fish resting on its belly.", "Check that the apparent upper and lower surfaces are the ocular and blind sides, using anatomy rather than colour alone.", "For larvae or transitional individuals, require developmental or taxonomic evidence rather than rejecting identification because adult asymmetry is absent or incomplete.", "Resolve identification below the common label using an appropriate identification key; eye side or bottom-dwelling behaviour alone does not establish species." ], "characteristics": [ { "name": "Biological subject level", "kind": "category", "unit_or_values": "registered grouping | taxon | population | individual", "why_it_matters": "Prevents species assessments, population trends and individual observations from being applied interchangeably." }, { "name": "Taxonomic identification", "kind": "relation", "unit_or_values": "accepted taxon, rank, authority and date, identification source, confidence, and verified external identifiers", "why_it_matters": "Flatfish is broader than one species, so range, development and management claims require a resolved taxonomic subject." }, { "name": "Developmental stage", "kind": "state", "unit_or_values": "egg | larva before metamorphosis | metamorphosing | juvenile | adult | unresolved", "why_it_matters": "Eye position, body orientation and habitat expectations depend on developmental stage." }, { "name": "Ocular side and eye migration", "kind": "category", "unit_or_values": "ocular side: left | right | unresolved; migration: absent | incomplete | complete | atypical", "why_it_matters": "Separates anatomical handedness from developmental progress and supports identification without assuming either is universal." }, { "name": "Resting orientation", "kind": "state", "unit_or_values": "left side down | right side down | other observed orientation | unobserved", "why_it_matters": "Tests the characteristic side-resting body arrangement and can help interpret condition." }, { "name": "Body length", "kind": "measurement", "unit_or_values": "mm, with total or standard length explicitly identified", "why_it_matters": "Supports growth and size assessment while avoiding comparisons between incompatible measurements." }, { "name": "Side-specific pigmentation and lesions", "kind": "state", "unit_or_values": "ocular-side and blind-side observations recorded separately, with lighting and image context", "why_it_matters": "Distinguishes normal side differences from injury or unusual development." }, { "name": "Habitat association", "kind": "relation", "unit_or_values": "location, date, substrate, waterbody type and life stage", "why_it_matters": "Makes habitat use attributable to a particular observation rather than to all flatfish." }, { "name": "Environmental exposure", "kind": "measurement", "unit_or_values": "depth in m, temperature in °C, dissolved oxygen in mg/L, and salinity with its measurement scale", "why_it_matters": "Supports interpretation of habitat suitability and stress using species- and stage-specific evidence." }, { "name": "Sex and reproductive maturity", "kind": "state", "unit_or_values": "sex and maturity classification, determination method, or unknown", "why_it_matters": "Supports reproductive assessment without assuming that size or external appearance reliably determines sex." }, { "name": "Assessment and protection applicability", "kind": "relation", "unit_or_values": "named taxon or population, assessment category, assessment year, geographic scope and applicable jurisdiction", "why_it_matters": "Prevents a conservation category or handling restriction from being assigned to flatfish as a whole." } ], "affordances": [ "Identify a candidate flatfish and record uncertainty at the narrowest defensible taxonomic rank.", "Document metamorphosis and side-specific anatomy through staged observations.", "Assess individual condition using behaviour, body measurements and ocular- and blind-side examinations.", "Relate observations to substrate, depth and life-stage-specific habitat use.", "Compare population observations when identification and sampling methods are compatible.", "Determine whether observation, capture, handling, release or retention is appropriate under verified local requirements." ], "agent_conduct": { "may": [ "Identify flatfish species from images, citing the features used and the uncertainty.", "Record catches and sightings for surveys the agent is authorized to support." ], "must_not": [ "Help land undersized fish or exceed catch limits.", "Mislabel one flatfish species as another in trade.", "Handle live fish in ways that cause avoidable suffering.", "Disturb protected seabed habitats in collecting fish." ], "requires_human": [ "Setting or changing fishing quotas or closures.", "Releasing or relocating live fish." ] }, "ethics": { "considerations": [ "Many flatfish stocks have been overfished, and trawling for them damages the seabed.", "Fish can suffer; their welfare in capture and slaughter matters." ], "affected_parties": [ "The fish themselves", "Fishing communities", "Consumers buying labelled fish" ] }, "owners": { "steward": "Nobody when wild; fisheries authorities manage the stocks.", "master_systems": [ "Fisheries catch and landing records", "Biodiversity species databases" ] }, "visual_identification": [ "A flattened body lying on one side on the seabed.", "Both eyes on the upper side and a pale underside." ], "failure_modes_and_hazards": [ "Overfishing and stock collapse.", "Bycatch of juveniles and other species.", "Species fraud in seafood labelling." ], "what_it_is_for": [ "Flatfish are encountered mainly in seabed habitats, with some species also occupying brackish or fresh water.", "They are observed in ecological surveys and managed in fisheries, aquaculture and conservation work.", "Their life stage matters because larvae generally lack the pronounced body asymmetry of adults." ], "standards_and_regulation": [ "The International Standard Statistical Classification of Aquatic Animals and Plants, maintained by the Food and Agriculture Organization of the United Nations, includes group 31 for flounders, halibuts and soles in fishery statistics." ] }, "sources": [ { "id": "oewn", "title": "Open English WordNet 2024, synset oewn-02659998-n", "url": "https://en-word.net/id/oewn-02659998-n", "what_it_supports": "sense and gloss of the concept", "url_status": "live", "checked_by": "http 200" }, { "id": "wiktionary-en", "title": "Wiktionary: flatfish", "url": "https://en.wiktionary.org/wiki/flatfish", "what_it_supports": "word senses and usage", "url_status": "live", "checked_by": "http 200" } ], "structure": { "bundles": [ { "id": "identity-and-biological-unit", "name": "Identity and biological unit", "description": "Establishes what the flatfish label denotes and which biological subject is being assessed.", "rationale": "A multi-species grouping cannot inherit one binomial, range, conservation status or individual condition.", "layers": [ { "id": "grouping-and-taxon", "name": "Grouping and taxon", "description": "Connects the registry concept to a defensible taxonomic identification.", "findings": [ { "id": "taxonomic-resolution", "name": "Taxonomic resolution", "description": "Record the supported rank, accepted name, authority and identification evidence without forcing species-level precision.", "questions": [ { "text": "Which taxonomic treatment defines membership in the flatfish grouping, and which accepted taxon does this record support?", "kind": "definition", "id": "taxonomic-resolution-q01" }, { "text": "Which examined key, specimen determination or molecular result supports the identification, authority and external taxonomy identifiers?", "kind": "provenance", "id": "taxonomic-resolution-q02" } ] } ] }, { "id": "individual-and-population", "name": "Individual and population", "description": "Separates observations of a fish from claims about a stock, population or taxon.", "findings": [ { "id": "claim-subject", "name": "Claim subject", "description": "Attach each condition, distribution or management claim to its actual biological and geographic subject.", "questions": [ { "text": "Does this statement concern an individual flatfish, a sampled population, a managed stock or an entire taxon?", "kind": "boundary", "id": "claim-subject-q01" }, { "text": "What evidence connects the observed fish to the named population or stock rather than merely to the same species?", "kind": "provenance", "id": "claim-subject-q02" } ] } ] } ] }, { "id": "asymmetry-and-development", "name": "Asymmetry and development", "description": "Represents eye migration, anatomical sidedness and their interpretation across life stages.", "rationale": "The registry's adult-oriented description is insufficient for recognising larvae and interpreting transitional anatomy.", "layers": [ { "id": "ocular-and-blind-sides", "name": "Ocular and blind sides", "description": "Records anatomical sides independently of camera orientation and colour.", "findings": [ { "id": "side-identification", "name": "Side identification", "description": "Determine ocular side, resting side and body compression from direct anatomical evidence.", "questions": [ { "text": "Which anatomical side carries the eyes, and which side contacts the substrate during observed resting?", "kind": "measurement", "id": "side-identification-q01" }, { "text": "What features distinguish this candidate from a dorsoventrally flattened ray or another bottom-associated fish?", "kind": "boundary", "id": "side-identification-q02" } ] } ] }, { "id": "metamorphic-transition", "name": "Metamorphic transition", "description": "Relates observed asymmetry to developmental progress.", "findings": [ { "id": "stage-dependent-recognition", "name": "Stage-dependent recognition", "description": "Record developmental evidence before interpreting incomplete eye migration or unusual orientation as abnormal.", "questions": [ { "text": "What observed eye position, body form and other stage markers support the assigned developmental stage?", "kind": "measurement", "id": "stage-dependent-recognition-q01" }, { "text": "Which species-specific developmental reference supports distinguishing normal transition from atypical development?", "kind": "provenance", "id": "stage-dependent-recognition-q02" } ] } ] } ] }, { "id": "habitat-and-population-space", "name": "Habitat and population space", "description": "Connects flatfish occurrence to substrate, water conditions, life stage and geographic evidence.", "rationale": "The sea-floor description must not substitute for evidence about the habitat or range of a particular flatfish taxon.", "layers": [ { "id": "substrate-and-water", "name": "Substrate and water", "description": "Characterises the immediate environment and observed use of the bottom.", "findings": [ { "id": "observed-habitat-use", "name": "Observed habitat use", "description": "Record bottom contact, burial or swimming together with substrate and environmental measurements.", "questions": [ { "text": "Was the fish resting, partially buried or swimming, and over what substrate and at what depth?", "kind": "measurement", "id": "observed-habitat-use-q01" }, { "text": "What measured water conditions and taxon-specific evidence support judging this habitat suitable for the observed stage?", "kind": "provenance", "id": "observed-habitat-use-q02" } ] } ] }, { "id": "range-and-stage-movement", "name": "Range and stage movement", "description": "Distinguishes occurrence records from established range and life-stage movement.", "findings": [ { "id": "distribution-evidence", "name": "Distribution evidence", "description": "Keep native-range claims, isolated observations and nursery or spawning habitat assignments distinct.", "questions": [ { "text": "Which dated, identified records support native occurrence in this area, and which indicate introduced or uncertain occurrence?", "kind": "provenance", "id": "distribution-evidence-q01" }, { "text": "What evidence identifies this location as a nursery, feeding or spawning area for the specified population?", "kind": "boundary", "id": "distribution-evidence-q02" } ] } ] } ] }, { "id": "condition-growth-and-reproduction", "name": "Condition, growth and reproduction", "description": "Supports assessment of individual health and reproductive state with attention to asymmetric anatomy.", "rationale": "Flatfish examination must distinguish ocular and blind sides and interpret size and behaviour in taxonomic and developmental context.", "layers": [ { "id": "side-specific-condition", "name": "Side-specific condition", "description": "Examines both sides and assesses functional behaviour.", "findings": [ { "id": "condition-evidence", "name": "Condition evidence", "description": "Record lesions, pigmentation, respiration and movement without treating resting or burial alone as evidence of illness.", "questions": [ { "text": "What lesions, pigmentation changes or external abnormalities occur on each side, and how were they documented?", "kind": "measurement", "id": "condition-evidence-q01" }, { "text": "Do observed respiration, swimming and substrate responses justify intervention under an appropriate species-specific handling protocol?", "kind": "action", "id": "condition-evidence-q02" } ] } ] }, { "id": "growth-and-maturity", "name": "Growth and maturity", "description": "Interprets body size, sex and maturity without unsupported age or sex assignments.", "findings": [ { "id": "size-and-reproductive-interpretation", "name": "Size and reproductive interpretation", "description": "Pair measurements and maturity determinations with methods and applicable reference populations.", "questions": [ { "text": "What length convention, mass measurement and age-estimation method were used for this fish?", "kind": "measurement", "id": "size-and-reproductive-interpretation-q01" }, { "text": "What evidence supports sex, maturity or sexual dimorphism for this taxon, and is external examination sufficient?", "kind": "provenance", "id": "size-and-reproductive-interpretation-q02" } ] } ] } ] }, { "id": "conservation-and-intervention", "name": "Conservation and intervention", "description": "Connects population evidence and applicable requirements to decisions involving flatfish.", "rationale": "Protection, harvest rules and handling decisions depend on species, stock, location, date and individual condition.", "layers": [ { "id": "population-assessment", "name": "Population assessment", "description": "Records the scope and limits of conservation and abundance evidence.", "findings": [ { "id": "assessment-applicability", "name": "Assessment applicability", "description": "Separate conservation assessments from fisheries stock assessments and attach each to its named subject.", "questions": [ { "text": "Which conservation or stock assessment applies, with what assessment year, taxonomic scope and geographic coverage?", "kind": "provenance", "id": "assessment-applicability-q01" }, { "text": "Do apparent abundance changes remain comparable after accounting for gear, effort, substrate and sampled life stages?", "kind": "measurement", "id": "assessment-applicability-q02" } ] } ] }, { "id": "capture-handling-and-disposition", "name": "Capture, handling and disposition", "description": "Determines justified actions for an encountered or captured flatfish.", "findings": [ { "id": "permitted-and-appropriate-action", "name": "Permitted and appropriate action", "description": "Combine identification confidence, condition and verified local requirements before choosing an intervention.", "questions": [ { "text": "Which current species, size, season, area and permit requirements govern capture, retention, transport or release here?", "kind": "action", "id": "permitted-and-appropriate-action-q01" }, { "text": "Given identification uncertainty, capture history and condition, what handling and disposition does the applicable protocol support?", "kind": "action", "id": "permitted-and-appropriate-action-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 is recalled knowledge, not source-checked research; verify current classification, taxonomic authorities and exact database identifiers.", "Eye-side orientation, adult size, reproductive biology and habitat vary by species; family common names do not guarantee eye-side orientation in every individual.", "There is no single native range or IUCN assessment for all flatfish; establish the species and, where relevant, population before supplying conservation status or assessment year." ], "questions": [ { "id": "evidence-confidence-notes-q01", "text": "Which of these check these first hold for the sense of flatfish 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": [ "Righteye flounders (Pleuronectidae)", "Lefteye flounders (Bothidae)", "Large-tooth flounders (Paralichthyidae)", "True soles (Soleidae)", "Tonguefishes (Cynoglossidae)", "Turbots and related flatfishes (Scophthalmidae)" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of flatfish 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": "Scientific taxonomic name", "value_or_pattern": "Pleuronectiformes", "note": "The traditional order-level name; flatfish denotes a group containing many species, not a species with one accepted binomial." }, { "scheme": "WoRMS AphiaID", "value_or_pattern": "Numeric taxon identifier", "note": "The World Register of Marine Species assigns identifiers to marine taxa; an exact identifier must be checked for the intended taxon." }, { "scheme": "FAO ASFIS three-letter species code", "value_or_pattern": "Three-letter alphabetic code", "note": "Used for fisheries reporting of species and some broader groups; there is no single species code applicable to every flatfish." } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of flatfish 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": [ "The International Commission on Zoological Nomenclature issues the International Code of Zoological Nomenclature, governing family-group, genus-group and species-group names.", "National fisheries authorities and regional fisheries management bodies impose species- and stock-specific measures such as catch limits, minimum sizes, gear restrictions and seasonal closures." ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of flatfish 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": [ "Commercial and recreational fisheries for food, including halibut, plaice, sole and flounder.", "Aquaculture of selected species, including turbot and Japanese flounder.", "Research on vertebrate asymmetry, metamorphosis, camouflage and adaptation to bottom habitats." ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of flatfish 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": [ "Overfishing can deplete individual stocks; risk cannot be assigned uniformly to all flatfish.", "Bottom-trawl fisheries can produce bycatch and disturb seabed habitats.", "Habitat degradation and low dissolved oxygen can reduce the suitability of coastal nursery grounds.", "Aquaculture can encounter abnormal pigmentation and incomplete or abnormal eye migration.", "Raw or inadequately cooked flatfish can transmit fish-borne parasites." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of flatfish 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": [ "Flatfish occur in tropical, temperate and polar seas; species composition and fisheries differ substantially among regions.", "Some species use estuaries or enter freshwater, although the group is predominantly marine.", "Common names such as sole, flounder and halibut vary geographically and do not map consistently to single taxonomic families." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of flatfish 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": "Rays and skates", "difference": "These are cartilaginous fishes flattened from back to belly; flatfish are bony fishes flattened from side to side and rest on one flank." }, { "name": "Halibut", "difference": "Halibut are particular members of the flatfish group; the broader term also includes soles, turbots and numerous flounders." }, { "name": "Flatfish larvae", "difference": "Early larvae typically have one eye on each side and a more symmetrical body; eye migration occurs during metamorphosis." }, { "name": "Flatfish stock", "difference": "A stock is a population or management unit within a species, whereas flatfish denotes a broad multispecies group." }, { "name": "Flatfish meat", "difference": "Meat is a harvested food product, whereas the biological term refers to the fishes themselves." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of flatfish this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Which authoritative taxonomic treatment should anchor the registry grouping, including its accepted name, authority, date and verified GBIF and NCBI mappings?", "Which identification characters reliably separate the constituent taxa, and where does eye-side variation limit their use?", "Which species-specific developmental references distinguish normal metamorphosis from atypical eye migration or pigmentation?", "How should the registry's sea-floor wording accommodate documented non-marine habitat use and life stages that do not occupy the bottom?", "Which regional assessments, sex and maturity references, and handling protocols provide sufficient evidence for decisions about the populations encountered?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 18, "questions": 28 } }