{
  "vercy": "1.0-draft",
  "publication": {
    "status": "research-draft",
    "adjudicationStatus": "unreviewed",
    "publishableCanonical": false,
    "generatedAt": "2026-09-12T06:07:39Z",
    "providers": [
      "Claude"
    ],
    "breadth": "written by Claude from model knowledge without web access - no source was read, every claim is a lead to verify",
    "pass": 2,
    "wave": 2,
    "engine": "claude",
    "enrichment": {
      "pass": 3,
      "engine": "claude",
      "producedAt": "2026-10-05T23:50:00Z",
      "ingestedAt": "2026-10-05T20:57:34+00:00",
      "fields": [
        "agent_conduct",
        "ethics",
        "owners"
      ]
    },
    "gate": {
      "passed": true,
      "version": "1.0",
      "at": "2026-10-07T10:10:27+00:00",
      "evidence": [
        "completeness 1.00",
        "sense: Wikidata description",
        "2 live sources",
        "review by codex: pass"
      ]
    }
  },
  "metaModel": {
    "id": "THING-Q1797874",
    "registryId": "vr.tr.log-jam",
    "name": "log jam",
    "version": "0.2.0-wave.2",
    "entryKind": "thing",
    "family": "Thing Registry",
    "domain": [
      "PHY.FLW"
    ],
    "status": "research-draft"
  },
  "canonicalUrl": "https://ver.cy/models/thing/q1797874/",
  "model": {
    "registry_id": "vr.tr.log-jam",
    "name": "log jam",
    "purpose": "Let an agent explain log jams and how they form and behave, describe their ecological and hydrological roles, describe their history in timber transport, and support river management and safety questions.",
    "definition": "An accumulation of logs or woody debris that blocks or partly blocks a river or stream, formed naturally by fallen trees or historically by timber floated downstream during log drives, creating barriers that alter flow, trap sediment, form pools and habitat, and sometimes cause flooding or dangerous releases; log jams were a hazard and a feature of timber transport and are now valued in river restoration for their ecological role.",
    "what_it_is_for": "Accumulations of logs blocking rivers.",
    "affordances": [
      "explain formation and behaviour",
      "describe ecological roles",
      "describe history",
      "support management questions"
    ],
    "distinguishing_features": [
      "Woody accumulation",
      "Flow obstruction",
      "Habitat creation",
      "Historical hazard"
    ],
    "appearance": "Tangled masses of logs across a river.",
    "visual_identification": [
      "Logs or woody debris blocking a watercourse",
      "Natural jams and historical timber drive jams",
      "A beaver dam is built by animals; a debris flow is a moving mass; an ice jam is frozen"
    ],
    "physical_properties": [
      {
        "quantity": "Channel blockage fraction",
        "unit": "%",
        "typical_range": "",
        "note": "Estimate the proportion of the channel cross section obstructed by wood at a stated water level."
      },
      {
        "quantity": "Jam length",
        "unit": "m",
        "typical_range": "",
        "note": "Measure the upstream to downstream extent using a field survey or scaled imagery."
      },
      {
        "quantity": "Wood volume",
        "unit": "m3",
        "typical_range": "",
        "note": "Estimate the solid wood volume from surveyed log dimensions while distinguishing it from the jam's volume including voids."
      },
      {
        "quantity": "Water level difference",
        "unit": "m",
        "typical_range": "",
        "note": "Measure the difference between upstream and downstream water surface elevations under a stated flow condition."
      }
    ],
    "families_and_kinds": [
      "natural large wood jams",
      "historical log drive jams",
      "engineered log jams in restoration",
      "jams at bridges and culverts",
      "flood debris jams"
    ],
    "related_models": [
      {
        "relation": "is a kind of",
        "target": "natural barrier",
        "why": "category"
      },
      {
        "relation": "is a kind of",
        "target": "accumulation",
        "why": "category"
      },
      {
        "relation": "is related to",
        "target": "woody plant",
        "why": "the trees forming jams"
      },
      {
        "relation": "is related to",
        "target": "fish ladder",
        "why": "river structures affecting fish passage"
      }
    ],
    "identifiers": [],
    "standards_and_regulation": [
      "River management and flood risk rules",
      "Restoration guidelines for large wood",
      "Historical timber floating regulations"
    ],
    "failure_modes_and_hazards": [
      "Sudden release and flooding",
      "Danger to boaters and workers",
      "Removing ecologically valuable wood"
    ],
    "in_scope": [],
    "out_of_scope": [],
    "characteristics": [],
    "agent_conduct": {
      "may": [
        "Explain how log jams form and their ecological and hydrological roles.",
        "Describe their history in timber transport.",
        "Relay river safety warnings from authorities."
      ],
      "must_not": [
        "Advise people to walk on or clear a log jam themselves.",
        "Advise boaters to approach jams.",
        "Advise removing wood from rivers without permission.",
        "Understate flood risk from a sudden release."
      ],
      "requires_human": [
        "Removing or breaking up a log jam."
      ]
    },
    "ethics": {
      "considerations": [
        "Log jams can kill boaters and swimmers caught in them.",
        "Wood in rivers provides habitat; removal harms fish."
      ],
      "affected_parties": [
        "Boaters and swimmers",
        "People downstream",
        "River wildlife"
      ]
    },
    "owners": {
      "steward": "The riparian landowner; river and environmental authorities regulate works.",
      "master_systems": []
    }
  },
  "sources": [
    {
      "id": "wikidata",
      "title": "Wikidata item Q1797874: log jam",
      "url": "https://www.wikidata.org/wiki/Q1797874",
      "url_status": "live",
      "what_it_supports": "identity and sense of the item",
      "checked_by": "wikidata-api"
    },
    {
      "id": "wikipedia-en",
      "title": "Wikipedia: Log jam",
      "url": "https://en.wikipedia.org/wiki/Log_jam",
      "url_status": "live",
      "what_it_supports": "general description of the item",
      "checked_by": "wikidata-api sitelink"
    }
  ],
  "structure": {
    "bundles": [
      {
        "id": "understand",
        "name": "Understand",
        "description": "What a log jam is.",
        "rationale": "Rivers.",
        "layers": [
          {
            "id": "formation",
            "name": "Formation",
            "description": "Formation and behaviour.",
            "findings": [
              {
                "id": "formation-finding",
                "name": "Formation",
                "description": "Formation.",
                "questions": [
                  {
                    "text": "How do log jams form, and how do they alter flow, sediment and channel shape?",
                    "kind": "definition"
                  },
                  {
                    "text": "Is a natural, historical or engineered jam meant?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "ecology",
            "name": "Ecology",
            "description": "Ecology.",
            "findings": [
              {
                "id": "ecology-finding",
                "name": "Ecology",
                "description": "Ecology.",
                "questions": [
                  {
                    "text": "What habitat and ecological functions do log jams provide for fish and other life?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits river ecology?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "manage",
        "name": "Manage",
        "description": "Management and restoration.",
        "rationale": "Practice.",
        "layers": [
          {
            "id": "restoration",
            "name": "Restoration",
            "description": "Engineered log jams.",
            "findings": [
              {
                "id": "restoration-finding",
                "name": "Restoration",
                "description": "Restoration.",
                "questions": [
                  {
                    "text": "How are engineered log jams designed and used in river restoration?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits river restoration?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "risk",
            "name": "Risk",
            "description": "Flood risk and removal.",
            "findings": [
              {
                "id": "risk-finding",
                "name": "Risk",
                "description": "Risk.",
                "questions": [
                  {
                    "text": "When do log jams pose flood or safety risks, and how do authorities decide on removal?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is a dangerous jam present now that needs authorities?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "history",
        "name": "History",
        "description": "Timber history.",
        "rationale": "Scholarship.",
        "layers": [
          {
            "id": "drives",
            "name": "Drives",
            "description": "Log drives.",
            "findings": [
              {
                "id": "drives-finding",
                "name": "Drives",
                "description": "Drives.",
                "questions": [
                  {
                    "text": "How did log jams arise during timber drives, and how were they broken, according to historians?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits timber floating?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "culture",
            "name": "Culture",
            "description": "Culture and language.",
            "findings": [
              {
                "id": "culture-finding",
                "name": "Culture",
                "description": "Culture.",
                "questions": [
                  {
                    "text": "How do log jams appear in folklore, and how did the term become a metaphor?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which references are standard?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "learn",
        "name": "Learn",
        "description": "Teaching.",
        "rationale": "Education.",
        "layers": [
          {
            "id": "teach",
            "name": "Teach",
            "description": "Teaching.",
            "findings": [
              {
                "id": "teach-finding",
                "name": "Teach",
                "description": "Teaching.",
                "questions": [
                  {
                    "text": "How can log jams be used to teach river processes?",
                    "kind": "action"
                  },
                  {
                    "text": "Which misconceptions arise?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "research",
            "name": "Research",
            "description": "Research.",
            "findings": [
              {
                "id": "research-finding",
                "name": "Research",
                "description": "Research.",
                "questions": [
                  {
                    "text": "What research exists on large wood dynamics in rivers, with findings attributed?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which findings are contested?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "openQuestions": [
    "Should large wood in rivers be a separate entry?",
    "How should restoration guidance be linked?",
    "How should timber history be linked?"
  ],
  "statistics": {
    "bundles": 4,
    "layers": 8,
    "findings": 8,
    "questions": 16
  }
}
