{
  "vercy": "1.0-draft",
  "publication": {
    "status": "research-draft",
    "adjudicationStatus": "unreviewed",
    "publishableCanonical": false,
    "generatedAt": "2026-09-12T03:14:16Z",
    "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:55:00Z",
      "ingestedAt": "2026-10-05T20:55:57+00:00",
      "fields": [
        "agent_conduct",
        "ethics",
        "owners"
      ]
    },
    "gate": {
      "passed": true,
      "version": "1.0",
      "at": "2026-10-06T19:51:55+00:00",
      "evidence": [
        "completeness 1.00",
        "sense: Wikidata description",
        "2 live sources",
        "review by codex: pass"
      ]
    }
  },
  "metaModel": {
    "id": "THING-Q1869874",
    "registryId": "vr.tr.insomnia",
    "name": "insomnia",
    "version": "0.2.0-wave.2",
    "entryKind": "thing",
    "family": "Thing Registry",
    "domain": [
      "XCT.STA"
    ],
    "status": "research-draft"
  },
  "canonicalUrl": "https://ver.cy/models/thing/q1869874/",
  "model": {
    "registry_id": "vr.tr.insomnia",
    "name": "insomnia",
    "purpose": "Let an agent explain insomnia and its types and causes, relay sleep hygiene and treatment guidance from health bodies, describe assessment in general terms, and route personal medical questions to clinicians.",
    "definition": "A sleep disorder characterised by difficulty falling asleep, staying asleep or waking too early despite adequate opportunity, causing daytime impairment, classified as transient or short-term and persistent or chronic, as primary or associated with conditions such as sleep apnoea, and assessed by history and sleep diaries; insomnia is common, is treated with cognitive behavioural therapy as the recommended first-line approach and sometimes medication, and is addressed through sleep hygiene guidance from health bodies.",
    "what_it_is_for": "Difficulty sleeping with daytime impairment.",
    "affordances": [
      "explain types and causes",
      "relay guidance",
      "describe assessment",
      "route personal questions"
    ],
    "distinguishing_features": [
      "Sleep difficulty",
      "Daytime impairment",
      "Duration classes",
      "Behavioural treatment"
    ],
    "appearance": "Not physical; reported sleep difficulty.",
    "visual_identification": [
      "Difficulty initiating or maintaining sleep",
      "Transient or chronic",
      "Sleep apnoea is a breathing disorder; short sleep by choice is not insomnia"
    ],
    "physical_properties": [],
    "families_and_kinds": [
      "transient and short-term insomnia",
      "chronic insomnia",
      "primary insomnia",
      "insomnia with sleep apnoea or other conditions",
      "hyposomnia and related patterns"
    ],
    "related_models": [
      {
        "relation": "is a kind of",
        "target": "sleep disturbance",
        "why": "category"
      },
      {
        "relation": "is related to",
        "target": "stress",
        "why": "a common contributing factor"
      },
      {
        "relation": "is related to",
        "target": "headache",
        "why": "a related symptom"
      },
      {
        "relation": "is related to",
        "target": "drug",
        "why": "medications used in treatment"
      }
    ],
    "identifiers": [],
    "standards_and_regulation": [
      "Clinical guidelines for insomnia",
      "Medicines regulation for hypnotics",
      "Sleep medicine professional standards"
    ],
    "failure_modes_and_hazards": [
      "Agents giving personal medical advice",
      "Overreliance on medication",
      "Missing underlying conditions"
    ],
    "in_scope": [],
    "out_of_scope": [],
    "characteristics": [],
    "agent_conduct": {
      "may": [
        "Explain insomnia and sleep hygiene from health sources.",
        "Suggest seeing a clinician when sleep problems persist."
      ],
      "must_not": [
        "Diagnose insomnia or recommend sleeping medication for a person.",
        "Promote unproven sleep products or supplements.",
        "Track a person's sleep without consent.",
        "Ignore signs of depression or crisis behind sleep complaints."
      ],
      "requires_human": [
        "Any treatment decision for a person's sleep disorder."
      ]
    },
    "ethics": {
      "considerations": [
        "Insomnia harms health and work, and sleep aids carry risks.",
        "Sleep data is health data."
      ],
      "affected_parties": [
        "People with insomnia",
        "Shift workers",
        "Families"
      ]
    },
    "owners": {
      "steward": "Each person over their own health; clinicians answer for treatment.",
      "master_systems": []
    }
  },
  "sources": [
    {
      "id": "wikidata",
      "title": "Wikidata item Q1869874: insomnia",
      "url": "https://www.wikidata.org/wiki/Q1869874",
      "url_status": "live",
      "what_it_supports": "identity and sense of the item",
      "checked_by": "wikidata-api"
    },
    {
      "id": "wikipedia-en",
      "title": "Wikipedia: Insomnia",
      "url": "https://en.wikipedia.org/wiki/Insomnia",
      "url_status": "live",
      "what_it_supports": "general description of the item",
      "checked_by": "wikidata-api sitelink"
    }
  ],
  "structure": {
    "bundles": [
      {
        "id": "understand",
        "name": "Understand",
        "description": "What insomnia is.",
        "rationale": "General information.",
        "layers": [
          {
            "id": "types",
            "name": "Types",
            "description": "Types and causes.",
            "findings": [
              {
                "id": "types-finding",
                "name": "Types",
                "description": "Types.",
                "questions": [
                  {
                    "text": "What are the types of insomnia, and what causes and perpetuates them?",
                    "kind": "definition"
                  },
                  {
                    "text": "Is the user asking about their own sleep, which needs a clinician for persistent problems?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "assessment",
            "name": "Assessment",
            "description": "Assessment.",
            "findings": [
              {
                "id": "assessment-finding",
                "name": "Assessment",
                "description": "Assessment.",
                "questions": [
                  {
                    "text": "How is insomnia assessed with history, sleep diaries and, when needed, sleep studies, according to guidelines?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits sleep medicine?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "manage",
        "name": "Manage",
        "description": "Management.",
        "rationale": "Guidance.",
        "layers": [
          {
            "id": "hygiene",
            "name": "Hygiene",
            "description": "Sleep hygiene.",
            "findings": [
              {
                "id": "hygiene-finding",
                "name": "Hygiene",
                "description": "Hygiene.",
                "questions": [
                  {
                    "text": "What sleep hygiene measures do health bodies recommend?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits sleep hygiene?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "treatment",
            "name": "Treatment",
            "description": "Treatment.",
            "findings": [
              {
                "id": "treatment-finding",
                "name": "Treatment",
                "description": "Treatment.",
                "questions": [
                  {
                    "text": "What do guidelines say about cognitive behavioural therapy for insomnia and about medication?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is urgent care needed, for example with severe distress?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "context",
        "name": "Context",
        "description": "Related conditions and effects.",
        "rationale": "Health.",
        "layers": [
          {
            "id": "conditions",
            "name": "Conditions",
            "description": "Related conditions.",
            "findings": [
              {
                "id": "conditions-finding",
                "name": "Conditions",
                "description": "Conditions.",
                "questions": [
                  {
                    "text": "How does insomnia relate to sleep apnoea, depression, anxiety and pain?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits a specific condition?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "effects",
            "name": "Effects",
            "description": "Effects.",
            "findings": [
              {
                "id": "effects-finding",
                "name": "Effects",
                "description": "Effects.",
                "questions": [
                  {
                    "text": "What are the effects of insomnia on health, safety and work, according to research?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which findings are uncertain?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "learn",
        "name": "Learn",
        "description": "Epidemiology and history.",
        "rationale": "Education.",
        "layers": [
          {
            "id": "epidemiology",
            "name": "Epidemiology",
            "description": "Epidemiology.",
            "findings": [
              {
                "id": "epidemiology-finding",
                "name": "Epidemiology",
                "description": "Epidemiology.",
                "questions": [
                  {
                    "text": "How common is insomnia, and how does it vary by age and group?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which references are standard?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "history",
            "name": "History",
            "description": "History.",
            "findings": [
              {
                "id": "history-finding",
                "name": "History",
                "description": "History.",
                "questions": [
                  {
                    "text": "How has understanding and treatment of insomnia developed?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which misconceptions arise?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "openQuestions": [
    "Should chronic insomnia be a separate entry?",
    "How should guidelines be linked?",
    "How should sleep services be linked?"
  ],
  "statistics": {
    "bundles": 4,
    "layers": 8,
    "findings": 8,
    "questions": 16
  }
}