{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.heron","code":"thing-q18789","url":"https://ver.cy/models/thing/q18789/","name":"heron","alternateNames":[],"kind":"thing","status":"published","version":"0.1.0-research.1","language":"en","classifiers":{"family":"Thing Registry","category":"Physical world and living systems","entryKind":"thing","plane":"PHY","domain":["PHY.LIV"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"This model owns an individual bird registered as a heron, including identification uncertainty, life stage, bodily condition, behaviour, habitat use and constraints on interaction; the intended boundary between herons, egrets and bitterns remains to be established.","purpose":"Enable an AI agent to recognise a heron, assess its condition and ecological situation, and choose observation or intervention appropriate to the evidence.","scope":{"in":["Individual identification, species hypotheses and evidence supporting them","Life stage, plumage, posture, mobility and visible condition","Feeding behaviour, prey handling and use of feeding sites","Movement, roosting, nesting and interactions with other birds","Exposure to disturbance, entanglement and other immediate hazards","Observation and intervention decisions tied to the individual"],"out":["Wetland hydrology and ecosystem condition beyond the individual's use of the site","Population abundance, regional trends and conservation assessments","Colony management and nesting-site infrastructure as independent entities","Prey species biology and fishery stock management","Veterinary diagnosis, treatment protocols and rehabilitation facility operations","Legal instruments and protected-area rules as independent records"],"boundaries":[]},"distinguishingFeatures":["Assess bill shape together with neck, leg and body proportions: a long, pointed bill and an elongated neck support a heron hypothesis, while a broad spoon-shaped bill or strongly downcurved bill suggests alternatives.","Record neck carriage in sustained flight: a retracted neck supports identification as a typical heron rather than a crane or stork, but a single posture is insufficient.","Use a combination of plumage pattern, bill and leg colours, size, life stage and location to distinguish plausible species; white plumage alone does not establish an egret identification.","Record standing, stalking and rapid bill-strike feeding as supporting behavioural evidence, without treating these behaviours as unique to herons.","Do not automatically exclude birds called egrets or bitterns: establish the registry's intended naming and taxonomic boundary before applying that distinction."],"structure":{"bundles":[{"id":"heron-identity","name":"Heron identity","description":"Evidence that the observed bird belongs under this registry entry and, where possible, a particular species.","layers":[{"id":"registry-boundary","name":"Registry boundary","description":"The relationship between the registry label and biological or common-name groupings.","findings":[{"id":"heron-name-coverage","name":"Heron name coverage","description":"Record the interpretation used for heron and flag unresolved treatment of egrets and bitterns.","questions":[{"text":"Does this entry cover all Ardeidae or a narrower set of birds commonly called herons?","id":"heron-name-coverage-q01","kind":"boundary"},{"text":"Which registry decision or taxonomic reference supports the interpretation applied to this bird?","id":"heron-name-coverage-q02","kind":"provenance"}]}]},{"id":"field-identification","name":"Field identification","description":"Observable features that support or challenge candidate identities.","findings":[{"id":"species-evidence","name":"Species evidence","description":"Record bill shape, proportions, plumage, bare-part colours and flight posture alongside candidate species.","questions":[{"text":"Which visible features separate this bird from plausible local herons, cranes, storks, ibises or spoonbills?","id":"species-evidence-q01","kind":"definition"},{"text":"Which photographs or observations support the identification, and which necessary features were obscured?","id":"species-evidence-q02","kind":"provenance"}]}]}]},{"id":"body-and-development","name":"Body and development","description":"Life-stage interpretation and observable bodily function.","layers":[{"id":"age-and-plumage","name":"Age and plumage","description":"Developmental context for appearance and independence.","findings":[{"id":"developmental-evidence","name":"Developmental evidence","description":"Record evidence for life stage without inferring age or sex from a single ambiguous colour or ornament.","questions":[{"text":"Which plumage, feather-development or dependency observations support the proposed life stage?","id":"developmental-evidence-q01","kind":"definition"},{"text":"Could the observed appearance reflect seasonal plumage, moult or viewing conditions rather than age?","id":"developmental-evidence-q02","kind":"boundary"}]}]},{"id":"functional-condition","name":"Functional condition","description":"Ability to support the body, move and use the wings and bill.","findings":[{"id":"impairment-evidence","name":"Impairment evidence","description":"Separate witnessed limitations and visible hazards from behaviours whose significance remains uncertain.","questions":[{"text":"Has the bird been observed bearing weight, walking, taking off or flying, and with what asymmetry or limitation?","id":"impairment-evidence-q01","kind":"measurement"},{"text":"Is there direct evidence of a wound, trapped limb, fishing line or bill obstruction that warrants qualified assessment?","id":"impairment-evidence-q02","kind":"action"}]}]}]},{"id":"feeding-and-site-use","name":"Feeding and site use","description":"How the bird uses a feeding patch and acquires or handles prey.","layers":[{"id":"feeding-patch","name":"Feeding patch","description":"The immediate physical setting in which feeding is observed.","findings":[{"id":"foraging-position","name":"Foraging position","description":"Record whether the bird feeds from water, shore, vegetation, a perch or terrestrial ground without assuming every heron is currently using a wetland.","questions":[{"text":"Where is the bird positioned, and what substrate, cover or water conditions can actually be observed?","id":"foraging-position-q01","kind":"measurement"},{"text":"What behaviour establishes that this location is a feeding patch rather than a resting or transit location?","id":"foraging-position-q02","kind":"boundary"}]}]},{"id":"prey-acquisition","name":"Prey acquisition","description":"Observed hunting sequence and its outcome.","findings":[{"id":"capture-and-handling","name":"Capture and handling","description":"Record waiting, stalking, strikes, captures and swallowing, keeping unidentified prey and hidden outcomes explicit.","questions":[{"text":"How many strikes and confirmed captures occurred during the recorded observation period?","id":"capture-and-handling-q01","kind":"measurement"},{"text":"Was prey swallowed, dropped or still being handled, and how confidently could the prey be identified?","id":"capture-and-handling-q02","kind":"measurement"}]}]}]},{"id":"movement-and-breeding","name":"Movement and breeding","description":"Flight, repeated site use and evidence of reproductive dependence.","layers":[{"id":"movement-and-return","name":"Movement and return","description":"Observed movements and the strength of evidence for repeated use by the same individual.","findings":[{"id":"individual-site-continuity","name":"Individual site continuity","description":"Separate repeated heron sightings from demonstrated returns by an identifiable individual.","questions":[{"text":"What markings, readable bands or continuous observations support treating successive sightings as the same bird?","id":"individual-site-continuity-q01","kind":"provenance"},{"text":"Does the evidence establish a feeding site, roost or transit route, or only a single presence?","id":"individual-site-continuity-q02","kind":"boundary"}]}]},{"id":"nest-and-dependent-young","name":"Nest and dependent young","description":"The individual's observed relationship to a nest, eggs or young.","findings":[{"id":"breeding-role-evidence","name":"Breeding role evidence","description":"Record nest construction, attendance and provisioning without equating proximity to a nest with ownership or active breeding.","questions":[{"text":"Which observed actions connect this bird to a particular nest or dependent young?","id":"breeding-role-evidence-q01","kind":"provenance"},{"text":"Could closer observation or removal interrupt nest attendance or provisioning, and what less intrusive action is available?","id":"breeding-role-evidence-q02","kind":"action"}]}]}]},{"id":"disturbance-and-response","name":"Disturbance and response","description":"Immediate hazards, responses to people and evidence needed to choose an action.","layers":[{"id":"disturbance-response","name":"Disturbance response","description":"Behavioural changes associated with an observer, pet, vehicle or other nearby activity.","findings":[{"id":"approach-effects","name":"Approach effects","description":"Record vigilance, interrupted feeding, retreat or flushing without deliberately provoking a response.","questions":[{"text":"What changed in the bird's behaviour as nearby activity changed, and at what estimated distance?","id":"approach-effects-q01","kind":"measurement"},{"text":"Should the observer retreat, stop recording or change route to allow feeding or nest attendance to resume?","id":"approach-effects-q02","kind":"action"}]}]},{"id":"hazard-and-intervention","name":"Hazard and intervention","description":"Specific threats and the grounds for contacting an appropriate responder.","findings":[{"id":"response-justification","name":"Response justification","description":"Tie any proposed intervention to observed urgency, applicable local constraints and responder competence.","questions":[{"text":"What direct evidence indicates entanglement, collision injury, confinement or another immediate threat?","id":"response-justification-q01","kind":"provenance"},{"text":"Which qualified local responder can assess the situation, including pointed-bill handling risk and possible breeding dependence?","id":"response-justification-q02","kind":"action"},{"text":"Which locally applicable rules govern approaching, capturing, transporting or disturbing this bird or its nest?","id":"response-justification-q03","kind":"boundary"}]}]}]}]},"agentConduct":{"may":["Record and report heron sightings to recognised monitoring schemes.","Describe heron species, behaviour and habitat from ornithological sources."],"mustNot":["Disturb nesting colonies or approach birds closely.","Help kill, trap or harm herons, including to protect fish ponds, outside the law.","Encourage feeding wild herons.","Misidentify species where protection status depends on it."],"requiresHuman":["Any lethal or non-lethal control of herons at fisheries.","Handling an injured heron."]},"ethics":{"considerations":["Herons are often persecuted at fish farms and garden ponds.","Wetland loss threatens heron habitat."],"affectedParties":["Herons themselves","Fish farmers","Wetland ecosystems"]},"owners":{"steward":"Nobody: wild and protected by law in many countries.","roles":[],"masterSystems":["Biodiversity occurrence databases"]},"relations":[{"target":"Q1420208","type":"parent","note":"registry parent class"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.heron","Wikidata: Q18789 (https://www.wikidata.org/wiki/Q18789)"]},"properties":{"applicability":"required","items":["Identification hypothesis: Candidate taxon or common-name group; unresolved; supporting and conflicting evidence","Life stage: Nestling; fledgling; immature; adult; uncertain","Observed plumage and bare-part colours: Regional plumage patterns and bill, eye and leg colours, with lighting and visibility limitations","Body length estimate: cm; method, uncertainty and posture recorded; unknown where no credible scale exists","Locomotor function: Standing, walking, taking off and flying: observed functional; visibly impaired; not assessed","Visible physical concerns: Observed wound, wing asymmetry, fouling, entanglement or other concern; none visible; view inadequate","Feeding activity: Waiting; stalking; striking; handling prey; swallowing; not feeding; uncertain","Observed feeding success: Confirmed captures and observed strikes per observation period in minutes","Site use: Individual linked to a feeding patch, transit route, roost or nest; role confirmed or suspected","Breeding involvement: Nest building; incubation-like attendance; feeding young; dependent young present; no evidence observed; uncertain","Response to disturbance: No visible response; increased vigilance; interrupted feeding; withdrawal; flushing; uncertain"]},"recognition":{"applicability":"required","items":["Long legs, long neck and dagger-like bill.","Standing still at water's edge or wading to hunt.","Flying with neck folded back and legs trailing."]},"capabilities":{"applicability":"required","items":["Observe and document identifying features from a distance that avoids disrupting feeding or nesting.","Compare species hypotheses using photographs, behaviour, location and life-stage evidence.","Track feeding, movement and visible condition across explicitly bounded observation periods.","Associate the bird with feeding, roosting or nesting locations while preserving uncertainty about site use.","Reduce avoidable disturbance by retreating or changing an observation route when the bird responds.","Document an immediate hazard and seek qualified wildlife assistance when evidence supports intervention."]},"hazards":{"applicability":"required","items":["Injury from the sharp bill when handled.","Colony abandonment after disturbance."]},"interfaces":{"applicability":"required","items":["Directive 2009/147/EC on the conservation of wild birds, issued by the European Parliament and the Council of the European Union, applies to naturally occurring wild herons within its territorial scope."]},"context":{"applicability":"required","items":["Herons occur around wetlands, rivers, coasts and other feeding habitats, where they hunt aquatic and terrestrial prey.","They are observed in ecological surveys, wildlife monitoring and conservation work, with species and seasonal behavior informing assessments of habitat use."]}},"sources":[{"title":"Wikidata item Q18789: heron","url":"https://www.wikidata.org/wiki/Q18789","note":"identity and sense of the item"},{"title":"Wikipedia: Heron","url":"https://en.wikipedia.org/wiki/Heron","note":"general description of the item"}],"openQuestions":["Does vr.tr.heron mean the family Ardeidae or a narrower common-name grouping, and where should egrets and bitterns be linked?","Which authoritative identification resources should govern species, life-stage and seasonal-plumage interpretation in the intended regions?","Which species-specific observations reliably distinguish normal prolonged stillness or juvenile flight limitations from impairment?","What evidence is sufficient to establish individual continuity, active nesting and dependence of nearby young without intrusive observation?","Which local wildlife rules, disturbance guidance and qualified response contacts should an agent consult before proposing intervention?"],"resources":{"spec":"/models/things/publications/thing-q18789/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q18789/spec.json"],"providers":["Codex"],"researchStatus":"unreviewed","generatedAt":"2026-09-06T21:59:22Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"filled","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T10:10:27+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass"},"score":1.0}}