{
 "name": "vns-evidence",
 "title": "Vagus Research — VNS Evidence Database",
 "description": "A curated, structured database of research on vagus nerve stimulation (VNS / taVNS / tcVNS / iVNS) across human and preclinical studies. Each record carries bibliographic metadata, a one-sentence key finding, a normalised study type, and an evidence-strength score. Compiled and maintained by Vagus Research (vagusresearch.com).",
 "version": "2.0.0",
 "created": "2026-07-05",
 "homepage": "https://www.vagusresearch.com/evidence",
 "licenses": [
  {
   "name": "CC-BY-4.0",
   "title": "Creative Commons Attribution 4.0 International",
   "path": "https://creativecommons.org/licenses/by/4.0/"
  }
 ],
 "sources": [
  {
   "title": "PubMed / NCBI",
   "path": "https://pubmed.ncbi.nlm.nih.gov/"
  },
  {
   "title": "Crossref",
   "path": "https://www.crossref.org/"
  }
 ],
 "resources": [
  {
   "name": "vns-evidence-csv",
   "path": "vns-evidence.csv",
   "format": "csv",
   "mediatype": "text/csv",
   "encoding": "utf-8",
   "schema": {
    "primaryKey": "slug",
    "fields": [
     {
      "name": "slug",
      "type": "string",
      "description": "Stable, unique record identifier (author-year-keyword)."
     },
     {
      "name": "title",
      "type": "string",
      "description": "Study title."
     },
     {
      "name": "authors",
      "type": "string",
      "description": "Short author form (first author et al.)."
     },
     {
      "name": "authorsFull",
      "type": "string",
      "description": "Full author list (Family Given; …), enriched from Crossref/PubMed."
     },
     {
      "name": "journal",
      "type": "string",
      "description": "Journal name."
     },
     {
      "name": "year",
      "type": "integer",
      "description": "Publication year."
     },
     {
      "name": "doi",
      "type": "string",
      "description": "DOI URL, where available."
     },
     {
      "name": "sourceUrl",
      "type": "string",
      "description": "Primary source link (PubMed or DOI)."
     },
     {
      "name": "condition",
      "type": "string",
      "description": "Primary condition/topic."
     },
     {
      "name": "conditions",
      "type": "string",
      "description": "All associated conditions (semicolon-separated)."
     },
     {
      "name": "stimulationType",
      "type": "string",
      "description": "iVNS, taVNS, or tcVNS."
     },
     {
      "name": "studyType",
      "type": "string",
      "description": "Original study-type label."
     },
     {
      "name": "studyTypeNorm",
      "type": "string",
      "description": "Normalised study type (controlled vocabulary)."
     },
     {
      "name": "evidenceStrength",
      "type": "integer",
      "description": "Evidence-hierarchy score, 6 (systematic review / meta-analysis) down to 1 (preclinical). Narrative/scoping reviews and case reports score 2."
     },
     {
      "name": "subjects",
      "type": "integer",
      "description": "Human participant count where reported (often null)."
     },
     {
      "name": "keyFinding",
      "type": "string",
      "description": "Original one-sentence summary by Vagus Research (not a reproduced abstract)."
     },
     {
      "name": "recordType",
      "type": "string",
      "description": "study | protocol | commentary. Only \"study\" records count in headline totals."
     },
     {
      "name": "reviewed",
      "type": "boolean",
      "description": "True once a human has verified the condition and key finding against the abstract."
     },
     {
      "name": "reviewMethod",
      "type": "string",
      "description": "Provenance of the key-finding summary: auto-extracted | auto-remediated | llm-assisted | human."
     }
    ]
   }
  },
  {
   "name": "vns-evidence-json",
   "path": "vns-evidence.json",
   "format": "json",
   "mediatype": "application/json",
   "description": "Same records as the CSV, as a JSON object with a `data` array."
  }
 ]
}